t\.W˿w:]. ''??? Fc1Uh4OuXf; @ {8 IINg|HDDDDDDDti """""""@!"""""""J"""""""@!"""""""J"""""""@!"""""""J"""""""@!"""""""J"""""""@!"""""""J"""""""@!"""""""J"""""""@!"""""""J"""""""5#EQEkkkk`0
dXT@j a䠇*bX,JJHHIINNIn}, CDDDDDDD@'%%`0p8 @$^Ǘ'"""""""::<" eeŻwZN6p ` >?l""Ǘg @Giݻv:~ݍn4,w8D E""""""":8",).sxfv |>x< @Uuw#>ZVOmQg; JeeyyY |"p:ZVyyyyN')99v#/GDDDDDDDY8ND 'Ɖ^ @^^aaQQ l6t:V ܹm֭ _[ۖ
QGP l3Jx<>_]"""""""aUx32R@UECVIIIMMIg*? &` >YY9999aDDDDDDD:,nw8 іo$HImx Oc" 瓿,1=9}"""""""IIII@."!"')g9/2NpRt@yyiiqqW dFp8
@ ܼ'""""""":{II.h4
P(
Essss8!""""""Ïft\*z= ']^o0 !DDDDDDDt9 /6%`_YYQQ^oTUTL&l2223f۹; JEEyyy9t^SR\[@fP_TT]ѳ'w | PGdxD"Hd+(JkZV ٣G ÇNDDa @QU xhju U;:6@eΝ^[X
L""":| ݻw $=xk9ta`3?m dWt x> ,()D>2; X N{ ƎMJ:"hI wӧϜ '|>qbV( ͵?ƍK g95"ŋ˃֭5aGv
-\̛W[۽;ߟw@^^VV^)\xFo#yb{ Pee?- ^*\v7?8˗z%`ہk}+ O~+"ӦxcӪ/< 3gr_ k7./o: 홏bvW?@$%"""e՚ ,X ^ug g$p8 x< O0= HOmh`Ҥm6az1KQb6fft)' 9\yRu${AҒ `Ut:
ȰXoMO?22.{[n9aÀnݲ32N8O
#W_}?vMi(nOJJM
:T ƏOMl)+>6_*[wٶm 55f?pU<0{6P[l|Ovp (xYDЩ=
̘W]%ƿK/~k{ ]tƎ4 0-Uv|ob1ny:]^z馛 ;K x=e9:q9:-Z {7]t _S};`"eQ222wҢ5k]Q`PM`)f ?Ҥ[n{d~Ѣw^xaڴiӀg `1c
]
FwF`5k
DOu5 =z Sc8 HT@`o
x{MKo'^}O>57=j qc{#`2O<pZm|=TfÆ} d2&Fh4ƫ i __g`Ǵ"uy_%լX홚%%[b@矟-Ӵ$ljj :`L}Σݻ?{R>wO t&~ X.(( ?tXa&`+ssD~uԨ
X[7 +Kmۖ/҆
p:c`Æ-[ `{:<9;[Q``HMڶ?t`6ZG mַ/?}n7PS(ɝ^[+WX!m:hШQ._p!k~;PXxSZl> k״il.} uE@m57KaС /[zݻVF۹SeD@(hhzE=Hue>%oО=LoNRӒo] ~ƍ
-VFUw/LM;"ш:NZXPh9sK#aÀK.< --))3:3'NJJ-vlF#~ y@Uk PP wl_KUDH|R`G`=m6qn zb2M8UU@ T` V"u1+ kkEVɃ&u_,^\Y tRbC^&.
ݵnMO\{E kW ąnoK#?ퟏtl_~"a2Lfs y"#O^2@<"3VUA9TV~' xcѣoOGϷi
6 X#8cNJT[o%K((w1BXFśPH<7jjŋ?k`Ȑn|z pᅅz=xڵ?}:0}c}3W\1Mt ߥ˧_ p!y:bpb .ϩVW_
vy;QhDLԁp vuµzulz[wn}Z"3Pl6n,bg2!!2#EYvnNr(VΝ6
x˻wnG/7qk۶&SdeulAӀh#o =zs sXQ[ ĉiio|t:dJJr +9YSRq9gD,7Ot JtPӥ#F ߥ ~=`s @N H <曁:?X|6g &N|sc\oviӀ[ {_ݺ" =}f n݀`p_~jj߽֯P8;_y%>} --gy9lō@n\лj;|v>8RSn>] (.ش 9, "AN: ٳhhh-./Ӂ3~SO 0@t'Y}y&0nFO;̛#G 45Pݧ%+W
Ԕ ;vTVXX8~<0t.\gH\uuCP]]\ l.yK M&hTՆ`Β;z>֭/%"" Xi"3LPTPm"Se՞td?N0(;b`૯B`@MFD"@$FVWoffVJ,VS`nw}=PYso3g?3f %%Vkɾ7\۔N1q"mۇ ӧ/[fƍ C&SۣѺ-[͛nY`YYyyשH$@硣Z,6н}^~U4ƻj՜9 %>Ϟ ^//G{b9jr`]nөϧlJ:/ruf
~=_rt$RrsC! Z|k5 G\{V1O>B ~qH`xlYNwo?^g>[ng /|A>_?.x7ߜ> o t~9w
_X
Q= _ѣ_|qʔZ [2!04hРAhiI;r(2ׯ_~}<" *X}֭֭
@is|3wO"v ' >Kл|;w6g8EJK͛7lؼHJP~N`>3`4QPZ뮋/C4$ uwK/r˕۷/pthj 3g> ̝+v +wQ뮻. c#FoiRR
N;w^y88.]F_ZZ>͛g M{ŋgVr|WvskVcolr_Xj^^^QTWWTpn!@ >c <jk/_/*: o_+
v쳏?U4<>b1 EWxCsPZzY>
~qǹ\_zw&M4iҤx՛Ehf̘1c ꫯ+ XLdkO=̙@rqxw:&c NX{`ɓ}w]of÷vhʡ _~|eyyRгg\=𗿌 с/+`ժU~
o뽫ȶORRRRD xѦlDFh} 0xL&C< }._L< ͛cbddFGGK_*\[8|p^(B&''y!J)ƈb377իWIRcHӬM8gY֥=kC100PvEz{{ By9x oߦV֜?
[ P G Ν;ekW\
cسgccc߿wގ֚nΜ9W 7ٳ:u
c Xh4J[[b1fff8w ׯ_cB=gd2/imm%HN-ZLI)ijj"
1??RjÙ֖ 244D2IJ,\q AJI 2Kuu5BۈFʘ}Bl Bd2TJm8 RayxC**c`)%UdBJI$ !x15EM]3m۶3Uo,"
?zq-(ζmY"Q
^
˲, kr\ s[oT hF18Y@GK M fn3h/ĀmeK)y]
+1Ek]Erid2 5>" hzZi|@/1mۥoO)oPk J}PJ3??_^ ! */2 B+Lk
Tsݻw訴X5`YVY͋^ҌzѣGRd2\u]~U:bg97o̦EGJ'sx k^)xPjzzػwoɓ'ihh8miXMyJ!9ov$[xeEr4pAk.۷,+noNruӀ-<{ )>y +6SZ;ǟ&<=C[x.ڻrD @"G˹w'-ш%B(
KE _\I Xq/ /9 G+ qD\J=_J}{w `O*K|:$fVd|:${^ iAUn. t/]CcQ !Fy { M
5o/߸qi9ɤ
Monitor and limit the download speed
Severin Heiniger
severinheiniger@gmail.com
2010
Grupo de desenvolvimento LottaNZB
Creative Commons Attribution-Share Alike 3.0
Download Speed
The speed at which files are downloaded from the Usenet is shown in the
bottom-right corner of the main window, inside of the
Infobar .
Limiting the Download Speed
By default, LottaNZB will download as fast as your Internet
connection and news server allows to. In order to prevent the downloads from
interfering with your other Internet activities, you can limit the
download speed. There are two different ways of doing that:
-
In the Infobar , click on the icon next to the
download speed. This opens a menu, allowing you to select one of the
predefined download speeds or removing the current limit.
-
If you want to specifiy a custom download speed, select
Edit Preferences Limit download speed
and enter the desired download speed in KiB/s right to it.
In both cases, the changes will take effect immediately.
lottanzb-0.6/help/mallard/pt_BR/introduction.page 0000644 0001750 0001750 00000002464 11525760436 022032 0 ustar lantash lantash
1
A brief introduction to LottaNZB
Severin Heiniger
severinheiniger@gmail.com
2010
Grupo de desenvolvimento LottaNZB
Creative Commons Attribution-Share Alike 3.0
Introdução
LottaNZB is an application that enables you to download files
from the Usenet.
The Usenet is a world-wide distributed Internet discussion system
that has been around long before the first websites showed up. Beside normal
text messages, users may also post files like pictures and videos,
which are commonly split into multiple messages.
To simplify the download of such files, the NZB file format was
invented. Such NZB files are created by Usenet search engines and provide
LottaNZB with information about what files are to be downloaded from
the Usenet.
lottanzb-0.6/help/mallard/pt_BR/index.page 0000644 0001750 0001750 00000002252 11525760436 020413 0 ustar lantash lantash
<app>LottaNZB</app> Usenet Downloader
<app>LottaNZB</app> Usenet Downloader
Severin Heiniger
severinheiniger@gmail.com
2010
Grupo de desenvolvimento LottaNZB
Creative Commons Attribution-Share Alike 3.0
<media type="image" mime="image/png" src="figures/lottanzb-logo.png">
<app>LottaNZB</app> Logo</media> <app>LottaNZB</app> Usenet Downloader
lottanzb-0.6/help/mallard/pt_BR/setting-up.page 0000644 0001750 0001750 00000005560 11525760436 021410 0 ustar lantash lantash
Acompanhe os passos requeridos para iniciar o download
Severin Heiniger
severinheiniger@gmail.com
2010
Grupo de desenvolvimento LottaNZB
Creative Commons Attribution-Share Alike 3.0
Setting Up <app>LottaNZB</app>
Pré-requisitos
O que você precisa pra iniciar LottaNZB é:
-
A news server account , giving you access to the Usenet.
There are numerous news server at different prices and with a different
retention . A retention of 500 days means that a file will be
deleted from that server 500 days after it has been uploaded.
-
A Usenet search engine that allows you to search
for files on the Usenet and download the corresponding NZB files.
Primeira Inicialização
When starting the application for the first time, you asked whether you
want to download to your computer or
-
For downloading files from the Usenet, LottaNZB depends on a
application called SABnzbd . If this software cannot be found on
your computer, you are asked to install it. Please follow the provided
instructions on how to do so.
-
Próximo, você precisa colocar os detalhes do seu nova conta de servidor.
Usually, the website of the news server contains the address and port
number to be entered. Depending on the news server, it may be possible to
encrypt the data downloaded to your computer using SSL.
Activate the corresponding check-box if this is the case.
In most cases, a username and a password needs to be entered.
Some free news servers allow anonymous access and don't require a username
and a password.
Clicking OK will bring up the main window,
where you can
LottaNZB Main Window
lottanzb-0.6/help/mallard/pt_BR/observed-nzb-folder.page 0000644 0001750 0001750 00000002357 11525760436 023163 0 ustar lantash lantash
Adicionar automaticamente arquivos NZB encontrados na pasta.
Severin Heiniger
severinheiniger@gmail.com
2010
Grupo de desenvolvimento LottaNZB
Creative Commons Attribution-Share Alike 3.0
Observed Folder
LottaNZB pode automaticamente
You can choose this folder after selecting
Edit Preferences and
activating the check-box Automatically add
NZB files from in the tab General .
By default, the folder that web browsers download files to will be
selected.
lottanzb-0.6/help/mallard/pt_BR/prefs-general-tab.page 0000644 0001750 0001750 00000001764 11525760436 022611 0 ustar lantash lantash
Configure o processo de download
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB Equipe de Desenvolvimento
Creative Commons Attribution-Share Alike 3.0
Preferências Gerais
The General tab lets you control how files are
downloaded from the Usenet and what should happen to them after they have been
downloaded.
lottanzb-0.6/help/mallard/pt_BR/post-processing.page 0000644 0001750 0001750 00000005667 11525760436 022460 0 ustar lantash lantash
Actions performed after all files have been downloaded
Severin Heiniger
severinheiniger@gmail.com
2010
Grupo de desenvolvimento LottaNZB
Creative Commons Attribution-Share Alike 3.0
Post-Processing
After the files belonging to a NZB file have been downloaded,
LottaNZB will perform some other steps, which is called
post-processing .
Post-processing typically includes the repair and extraction of
downloaded files. It allows you to access the downloaded content without
doing any additional work.
During post-processing, the progress bar will stay at 100%.
However, below the download name, LottaNZB both indicates what
operation is taking place as well as its progress,
e.g. "Repairing... (42%)" .
Post-processing requires the computer to do hard work, which may cause it
to take a bit longer to respond to your input. LottaNZB
tries to minimize these effects.
Customize Post-Processing
After selecting
Edit Preferences ,
use the drop-down menu below After Downloading
to choose which of the following actions will be performed during
post-processing. It's only possible to perform an action if all actions above
it have been performed.
-
Reparar
Check the downloaded files for errors and if there are any, try to
correct them. In order for such a repair to work, the download must
include PAR recovery files , which will be downloaded if needed.
This is the case for many NZB files found on Usenet search engines.
-
Extração
Extract the content of compressed downloads. Large files on the Usenet
are usually compressed and split into multiple RAR archives in
order to save space.
-
Exclusão
Delete the downloaded archives after their content has been extracted.
If the extraction has been successful, there's usually no need for the
RAR archives anymore.
By default, all of the above actions are performed. It's even possible to
prevent any of the actions from taking place by selecting
Do nothing
lottanzb-0.6/help/mallard/pt_BR/prefs.page 0000644 0001750 0001750 00000002516 11525760436 020426 0 ustar lantash lantash
Configurar o comportamento das aplicações.
Severin Heiniger
severinheiniger@gmail.com
2010
Grupo de desenvolvimento LottaNZB
Creative Commons Attribution-Share Alike 3.0
<app>LottaNZB</app> Preferencias
After LottaNZB has been set up, i.e. to manage the downloads
of Preferences dialog. You can open it by selecting
Edit Preferences
SABnzbd , the application upon which LottaNZB is built,
offers many advanced options. You can review and change them by
Config tab.
lottanzb-0.6/help/mallard/pt_BR/remote-access.page 0000644 0001750 0001750 00000006065 11525760436 022044 0 ustar lantash lantash
Gerenciador de downloads de outro computador
Severin Heiniger
severinheiniger@gmail.com
2010
Grupo de desenvolvimento LottaNZB
Creative Commons Attribution-Share Alike 3.0
Acesso Remoto
É possível gerenciar os downloads de outro computador assim como transferi-los para o mesmo computador. Em algumas situações onde isso é útil.
-
O computador em casa está fazendo um download e você quer gerenciar os downloads usando o seu laptop enquanto você está distante.
-
Você quer tornar possível para outra pessoa em sua rede para
-
The other computer is actually a device without a screen, such as a
Network-Attached Storage (NAS) .
Por padrão, não é possível para outra pessoa gerencia os downloads do seu computador por causa da sua privacidade.
Primeiros Passos
Para seguir os passos corretamente inicie usando o acesso remoto.
-
On the computer where downloads are taking place, allow remote access
by selecting
Edit Preferences
, navigating to the
Remote Access tab and activating the check-box
Allow access from other computers .
It's recommended to protect the remote access by activating
Require authentication and entering
a username and a password.
Confirme suas mudanças para fechar a janela.
-
On the computer using which you want to manage the downloads:
-
If LottaNZB is started for the first time, select
Manage the downloads of another computer
in the Start Downloading dialog.
-
If you've already been using LottaNZB , select
File Monitor another
Computer... .
Enter the name or IP address of the computer whose downloads you would
like to manage. When asked, also enter the username and password
you provided. Click OK to start managing the
downloads.
lottanzb-0.6/help/mallard/pt_BR/news-servers.page 0000644 0001750 0001750 00000003573 11525760436 021756 0 ustar lantash lantash
Adicionar, editar e deletar novos servidores
Severin Heiniger
severinheiniger@gmail.com
2010
Grupo de desenvolvimento LottaNZB
Creative Commons Attribution-Share Alike 3.0
Novos Servidores
In order to add, edit or delete news servers, select
Edit Preferences and
navigate to the Servers tab.
Adicionar e Editar Servidores
You can edit the information about a server by selecting it and clicking
Edit . In order to add a new server, click
Add instead. In both cases, a dialog is opened
that allows you to specify the information about the server. The changes
will not take effect until you click OK .
Usually, the website of the news server contains the address and port
number to be entered. Depending on the news server, it may be possible to
encrypt the data downloaded to your computer using SSL.
Activate the corresponding check-box if this is the case.
In most cases, a username and a password needs to be entered.
Some free news servers allow anonymous access and don't require a username
and a password.
Deletando Servidores
You can delete a server by selecting it and clicking
Delete . Note that this cannot be undone.
lottanzb-0.6/help/mallard/pt_BR/incomplete-downloads.page 0000644 0001750 0001750 00000005574 11525760436 023445 0 ustar lantash lantash
Downloads that are still waiting to be completed
Severin Heiniger
severinheiniger@gmail.com
2010
Grupo de desenvolvimento LottaNZB
Creative Commons Attribution-Share Alike 3.0
Incomplete Downloads
In the case of the currently active download, the estimated
remaining time is displayed below the download name.
Pausing Downloads
Activating Pause All in the toolbar or
File Pause All
will prevent any further downloading from taking place, until it's deactivated
again.
However, it's also possible to prevent an individual download from
taking place by right-clicking on it and activating the check-box
Pause . In the download list, such downloads are
displayed in gray. You can later resume such a download by deactivating
Pause again.
Renaming Downloads
When a NZB file is
Properties and changing the
field right to Name . The changes take effect
immediately.
A download cannot be renamed anymore using LottaNZB after all
of its files have been downloaded and
Removing Downloads
Any download can be canceled by clicking Remove
in the toolbar or pressing Delete .
This cannot be undone and any progress will be lost.
Reordering the Download List
Downloads are performed one after the other, whereas the download at the
bottom of the download list will be performed last.
You can reorder the list of incomplete downloads by selecting a download and
dragging it to the desired place. Alternatively, a selected download can be
moved using the arrow buttons in the Reordering Pane
on the left. Clicking the topmost button will immediately start the
download.
lottanzb-0.6/help/mallard/pt_BR/web-interface.page 0000644 0001750 0001750 00000004764 11525760436 022031 0 ustar lantash lantash
Manage the downloads using a web browser
Severin Heiniger
severinheiniger@gmail.com
2010
Grupo de desenvolvimento LottaNZB
Creative Commons Attribution-Share Alike 3.0
Interface Web
Você poderia gerencia seus downloads usando um navegador em vez de LottaNZB . Este recurso é fornecido por SABnzbd , a aplicação da LottaNZB , foi construída em cima. A interface web é útil em situações como a seguir:
-
You want to use an advanced feature offered by the web interface that
is not yet available in LottaNZB . In addition, this lets
you customize the downloading process in more detail.
-
Você quer gerenciar os downloads remotamente usando uma ferramenta que não roda LottaNZB , como um computador executando um sistema operacional deferente de Linux ou um smartphone
As informações de como usar a interface web podem ser encontradas em
Abrindo a Interface Web
You can open the web interface by selecting
File Open Web Interface
.
Alternatively, you may also directly enter the URL of the web interface
into your browser. When downloading to the same computer, that URL is
localhost with the name or IP address of that computer.
The web interface of another computer can only be opened if it
If you provided a username and a password when allowing the remote access,
you will be asked to enter them.
When using the web interface frequently, you may want to create
a bookmark in your web browser, giving you quick access to it.
lottanzb-0.6/help/mallard/pt_BR/searching-download-list.page 0000644 0001750 0001750 00000002365 11525760436 024032 0 ustar lantash lantash
Find downloads within the download list
Severin Heiniger
severinheiniger@gmail.com
2010
Grupo de desenvolvimento LottaNZB
Creative Commons Attribution-Share Alike 3.0
Procurando a Lista de Download
When the download list contains many
You can search the download list by just starting to type a part
of the name of the download you're interested in. The first download containing
your input is immediately selected.
When the list of completed downloads gets long, you can also
lottanzb-0.6/help/mallard/pt_BR/license.page 0000644 0001750 0001750 00000002601 11525760436 020724 0 ustar lantash lantash
Informação legal
Licença
Esse trabalho é distribuído sobre a Creative Commons Attribution-Share Alike 3.0 Unported license.
Você é livre:
-
<em>To share</em>
Para copiar, distribuir e transmitir o trabalho.
-
<em>To remix</em>
Para adaptar o trabalho
Sob as seguintes condições:
-
<em>Atribuição</em>
You must attribute the work in the manner specified by the author or
licensor (but not in any way that suggests that they endorse you or
your use of the work).
-
<em>Share Alike</em>
Se você alterar, transformar, ou construir sobre esse trabalho, você distribuirá o resultado do trabalho só sobre a mesma, similar ou licença compatível.
For the full text of the license, see the
lottanzb-0.6/help/mallard/pt_BR/completed-downloads.page 0000644 0001750 0001750 00000002712 11525760436 023251 0 ustar lantash lantash
Downloads that don't need any further steps
Severin Heiniger
severinheiniger@gmail.com
2010
Grupo de desenvolvimento LottaNZB
Creative Commons Attribution-Share Alike 3.0
Completed Downloads
The files of a successfully completed downloads can be found inside of the
In the case of an unsuccessful download, a message will be displayed below
its name indicating what went wrong.
Clearing Completed Downloads
Over time, the list of completed download may get long. Clicking
Clear Completed or selecting
File Clear Completed
will remove all completed downloads from the list of downloads,
while the downloaded files will not be affected.
lottanzb-0.6/help/mallard/pt_BR/reporting-problems.page 0000644 0001750 0001750 00000001677 11525760436 023150 0 ustar lantash lantash
Get in touch with the developers when problems occur
Severin Heiniger
severinheiniger@gmail.com
2010
Grupo de desenvolvimento LottaNZB
Creative Commons Attribution-Share Alike 3.0
Reportar Problema
LottaNZB is by no means perfect. If you encounter problems of any
kind in either the application or this documentation,
the LottaNZB development team would highly appreciate it if you
lottanzb-0.6/help/mallard/pt_BR/adding-downloads.page 0000644 0001750 0001750 00000005434 11525760436 022527 0 ustar lantash lantash
1
Add new downloads to the download list
Severin Heiniger
severinheiniger@gmail.com
2010
Grupo de desenvolvimento LottaNZB
Creative Commons Attribution-Share Alike 3.0
Adding Downloads
You can add a download to LottaNZB by getting a NZB file
(typically from a Usenet search engine) and opening it using
LottaNZB , which will then download all files from the Usenet that are
listed in the NZB file.
There are many ways to add a NZB file.
-
Manual Selection
Choose one or more NZB files located on the hard drive after clicking on
the Add toolbar button or selecting
File Add File...
.
-
Arrastar e Soltar
Arrastar um ou mais arquivos NZB e solta-los na janela padrão LottaNZB 's.
-
Associação de arquivos
Click on a NZB file in your file manager. NZB files are opened using
LottaNZB .
-
Download de URL
Enter the URL of a NZB file in the dialog opened by selecting
File Add URL...
, which will cause LottaNZB to download that NZB file.
-
<link xref="observed-nzb-folder">Automatically from Observed
Folder</link>
New NZB files found in this folder will be added automatically.
Usenet search engines usually indicate how many days ago the files
listed in a NZB file have been uploaded to the Usenet. Please make sure that
the retention time of your news server is longer, otherwise
LottaNZB won't be able to complete the download because the
files will have already been deleted from your news server.
Newly added downloads appear at the bottom of the download list after a
few seconds, which means that any previously added download will be completed
first until the new download will take place. Learn how to
LottaNZB .
lottanzb-0.6/help/mallard/de/ 0000755 0001750 0001750 00000000000 11525760442 016024 5 ustar lantash lantash lottanzb-0.6/help/mallard/de/customizing-interface.page 0000644 0001750 0001750 00000003510 11525760436 023175 0 ustar lantash lantash
Die Benutzeroberfläche gemäss Ihren Vorstellungen anpassen
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB-Entwicklungsteam
Creative Commons Namensnennung-Weitergabe unter gleichen Bedingungen 3.0
Die Oberfläche anpassen
Abgesehen von der Download-Liste enthält das Hauptfenster die folgenden Elemente, von denen keines von essentieller Bedeutung für das
-
Werkzeugleiste
Bietet Zugriff auf häufig genutzte Funktionen. Es ist möglich, stattdessen das Datei -Menü oder
-
Infoleiste
Enthält statistische Informationen wie die Download-Geschwindigkeit und die noch verbleibende Zeit.
-
Umordnungs-Bereich
Ermöglicht das
Sie können jedes einzeln verstecken, in dem Sie das entsprechende Kreuz im Menü Ansicht entfernen. So wird der Download-Liste mehr Platz gegeben.
lottanzb-0.6/help/mallard/de/multiple-news-servers.page 0000644 0001750 0001750 00000004533 11525760436 023166 0 ustar lantash lantash
Gleichzeitig mehr als einen News-Server verwenden
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB-Entwicklungsteam
Creative Commons Namensnennung-Weitergabe unter gleichen Bedingungen 3.0
Mehrere News-Server
Nur ein News-Server-Konto wird benötigt, um mit dem Herunterladen aus dem Usenet zu beginnen, aber es gibt Gründe, mehr als einen Server zu verwenden. TODO
-
Sie verwenden bereits einen kostenlosen, aber unzuverlässigen News-Server. Da einige Dateien, insbesondere alte Datieen, nicht auf diesem News-Server gefunden werden können, entscheiden Sie sich dafür, ein Konto bei einem News-Server anzulegen, bei dem nach der heruntergeladenen Datenmenge abgerechnet wird. Um Geld zu sparen, möchten Sie nur dann von diesem News-Server herunterladen, wenn eine Datei nicht auf dem kostenlosen News-Server gefunden werden kann.
Die folgenden Funktionen sind verfügbar, wenn mehr als ein News-Server definiert worden ist.
Server aktivieren und deaktivieren
Sie können einen Server deaktivieren, indem Sie das Kreuz auf der linken Seite des Server-Eintrages entfernen. Daraufhin wird LottaNZB nicht mehr von diesem Server herunterladen. Sie können einen News-Server später wieder aktivieren, indem Sie das Feld erneut ankreuzen.
Backup-Server
Ein Backup-Server ist ein News-Server, der nur zum Herunterladen von solchen Dateien verwendet wird, die von keinem anderen News-Server heruntergeladen werden konnten. Ein Server kann als Backup-Server gekennzeichnet werden, wenn er Erweiterte Einstellungen aus und kreuzen SIe das Feld Als Backup-Server verwenden an.
lottanzb-0.6/help/mallard/de/managing-downloads.page 0000644 0001750 0001750 00000003041 11525760436 022434 0 ustar lantash lantash
2
Die Download-Liste verstehen und manipulieren
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB-Entwicklungsteam
Creative Commons Namensnennung-Weitergabe unter gleichen Bedingungen 3.0
Downloads verwalten
Das Hauptfenster enthält die Liste der Downloads. Jeder Download wird durch seinen Namen, seine Grösse sowie den Fortschritt in Form einer Fortschrittsleiste repräsentiert. Abhängig vom Status des Downloads werden noch zusätzliche Informationen eingeblendet.
Durch Anklicken von Alle anhalten oder Auswählen von Datei Alle anhalten
In der Download-Liste befinden sich die
lottanzb-0.6/help/mallard/de/keyboard-shortcuts.page 0000644 0001750 0001750 00000003100 11525760436 022513 0 ustar lantash lantash
Die Anwendung mit der Tastatur steuern
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB-Entwicklungsteam
Creative Commons Namensnennung-Weitergabe unter gleichen Bedingungen 3.0
Tastenkürzel
Auf viele Funktionen von LottaNZB kann mittels Tastenkürzeln zugegriffen werden. Durch Drücken der Taste Alt wird jeweils ein Buchstabe bei den meisten Menü-Einträgen unterstrichen. Durch Drücken der der entsprechenden Tasten wird der Menü-Eintrag ausgewählt. Weitere Tastenkürzel für häufig verwendete Funktionen umfassen:
-
<keyseq><key>Ctrl</key><key>D</key></keyseq>
Eine NZB.-Datei zur Liste der Downloads
-
<keyseq><key>Ctrl</key><key>P</key></keyseq>
Alle aktiven Downloads anhalten bzw. damit weiterfahren.
-
<keyseq><key>Ctrl</key><key>Q</key></keyseq>
Die Anwendung beenden.
-
<key>F1</key>
Die Dokumentation öffnen.
lottanzb-0.6/help/mallard/de/download-folder.page 0000644 0001750 0001750 00000005030 11525760436 021743 0 ustar lantash lantash
Auswählen, wo abgeschlossene Dateien abgelegt werden sollen
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB-Entwicklungsteam
Creative Commons Namensnennung-Weitergabe unter gleichen Bedingungen 3.0
Download-Ordner
Alle erfolgreich abgeschlossenen Downloads werden in den Download-Ordner verschoben. Sofern Sie nicht die Downloads in der Werkzeugleiste oder durch Wählen von File Download-Ordner öffnen
Standardmässig verwendet LottaNZB den Ordner, der auch andere Anwendungen wie Web-Browser für ihre Downloads verwendet. Normalerweise trägt er den Namen Downloads und befindet sich in Ihrem persönlichen Ordner.
Verbleibenden freien Speicherplatz im Download-Ordner prüfen
In der unteren rechten Ecke des Hauptfensters zeigt LottaNZB innerhalb der Infoleiste den verbleibenden Speicherplatz des Download-Ordners an. Der Wert wird rot dargestellt, wenn nicht genug Platz für alle
Stellen Sie sicher, dass immer genügend freier Speicher zur bereit steht. Wenn der freie Speicherplatz zur Neige geht, hält LottaNZB alle Downloads an, bis Sie etwas Speicher freigeben.
Lage des Download-Ordners ändern
Wenn Sie in einen anderen Ordner herunterladen möchten, klicken Sie auf Bearbeiten Einstellungen Download-Ordner aus. Die Änderung tritt sofort in Kraft, aber bereits abgeschlossene Downloads werden nicht in den neuen Download-Ordner verschoben.
lottanzb-0.6/help/mallard/de/figures/ 0000755 0001750 0001750 00000000000 11525760442 017470 5 ustar lantash lantash lottanzb-0.6/help/mallard/de/figures/lottanzb-main-window.png 0000644 0001750 0001750 00000077657 11525760436 024313 0 ustar lantash lantash PNG
IHDR ( bKGD X pHYs ~ OIDATxw|T?N)AP^WW VTT!X( "1nMB> ͞=;<3BtҸqGG """"""":B̟R[&L81cbbZcxHt:0
QӨT2PBP(i-@8
.:ZViiii)) Es Fyyyye%psGvIIIIIIL&hlz~? *+++b]z%IDDDDDDt4t:^ % [oL8,2" 2Pz]Idנ⒒.,Fh4S EJJDJ$h4jFh4Zmk|Npp]`DjNdԈLAdy<> E"j5`4ZF#Ӊ!!xXj x b q FN"5^ju
%"'R :eHO_
9ʓ fy4 ====-~ %D JQڦ,éڻ7ˢE;wɤնƔي~F |RYz5h^/`0t3ZHil}B`%K6oNN _G? nw
~yr(9yP3ۛr.[VW{} fV[{D㩩)+o߸qV$TH!"""""j@Q1T~ `0f٬}+jEƄ DO_~\x9X-l6Lb{ }˳sΝw7?թSNyyv._oY[6UHD'0˽ CĘ0zZ-֣ј̀a6tQ%
[dxhv{DƈɤV'ƾRL `jEfd ~yժR D jj*9T91 L&QHxPHlh*+= @Q
HMMJ=pyFQZa""""""
{=D@@Lc\Pmێ @]t{loZPmЩS~~^^,P5z{iȀH<2rl@g(Ѩ W4KcGC:`Ϟ͛7l 6l() ףw8t(p ;֮_,\qcS[`r iذ#Νz1#ׯ^e P^.Fjl5Ԟ=Arrjk~۵@c)J]ݶmʕ+VБ_MJJ^C: T\ _J^M OQfͪU;w^/`2yy#Gc[ͦF)>S` m> ^inm6KΝEdv ++33= (..))-N c]gZ݄n^yZ\ ~(y0(II@߾Æ dgvWW*UBBBӯߠA@4-]
_0 WW ^/ "r> ("$
< P)) ݻ
? vrB@uu4 $%ѧWYn(j5
%9ӧ,hmVڼF@
3GL4{M&bTU塐Jh4:<>&!jjul@JfgOa!x!9IK˳};w6;ijy:Rz((?_.V''"pڵjh"ҧp dg%$ [lV`EŶm2B228n:F;v\r%m:t@GdeY,vhnw-
֬ > KWmSD& B@(R%%=z ޫЩSRe*c8\[c۶u w\ι@N
1JحЯ_f3ޱXjvKtD \[ {^b:80##/;+XxϞ`PdB!"""""|`0 Dr
8HO"\.wc뗃Ѷ< ĠYƂK 6
bX
Ɍ 7e͉f3Vad5E *^W@*J}{ Y\0K^^Ϟ@IIz=tn߾v-lي6ݛ* Nm;v!1(t&2U 4ھ}͚ ; SbQl_ : ZՊ鹈homTd2:#ܹSXW If@J.(Z-2 4o3W_nO:\yb2
Lf_߽-HH &Lx?^}d7ӁN=0{a[nۀ3gNgQ""""qmuQzb1ꀅ ~>(+395K`Ĉ/xx[o}E`fnIr\n@fTϱXL&W4
}>zZL; 29B!qGeh4jFX6tZV |557}6kՀh2fZ,yjHH\.` O> c!CsϽ x߹O>)/Q= d"#FCOJuBPU%JVfl2FXaZQIKk'C> &|aX,f3:ݡ Cѣa hN;
8/|KSf̴U jfӦƿxv{tc&h4yWY x4iCMIzLL,/~ 6m*)Y
gFą8@UΝV_~Ӧ |\wݿթ@4ĝ㏿W^E_Ϟ
Lz5Cfs \{w{Oc0ӧD"a w p ӧX履 }s&ÆY,~.0V1 S~g֖]MBQ`P_㩭ׯ_x *+ = I _h7xBjuNp>8}:'_}'"S)SN=555v鲲 ~c7|!5HD4Z cۜ?Fӹ3pO=5s&ggʝwwoϡ [# jkN=X~嗁3 ƍ;n F B)q3 }_Eن
E" ~>t(pO?k{NKO;Pl0_sלqpFcNp5DZ1{e*UKDDDDD7Ѷ,<M$RV&X;~A@b ~5PQV{@A>4p-ov>_Jw1yUW ̘QS# l<܍7>( T|k⋁ |)ছ~:ہoOn~zE"p(${7(/6 3;Zmr2pO?_~' |;< sNb_ |0w݀'2{Z-? 55tVU55wC*`ݺU
ڊ
`>K`ܸV@kض 55bκB`o]Сo_ #C?4-5z ? 2XXhpX
~X^88 = eh4};#@|> XL- mkkEfZc߆OF6~ x뭏>ZؽjjJJS̺S^/PVgOYP[[[[RXw x <9tNrԩ3jw}kҭ[kwđ^LMjZݞ!p4
6Ry@ h
%&'8iw_|] Zm(B*Nڵpas>Wۓfx≏? 9r V Bp8 ~qڴ>` Z%5/'rnel`Ζm'
N FNI118DZ ENb0 A䯁@(d4Æ~z߾@$O> ^]^r^Jj0
j5p >p `0]b Gc۩R>S}vyW<W\Y>;kpӹNg&˵v-PS#;l$
E <oh8rO矗?"ᰢX,A7t]رSo8 >dܤͺȔv9F 4Ӂs9L?VjjDn 6쪫_oǀ=D`ɓx8Q|J%Sjju4>OJшBΚ |ҤW_vj+);4L&9Hv uu55ι (Juue%s /X Lx ' t;v4 ;cb
L@nlR NںП?GPl 8>}zjUcUXFj4J(}Ϳkog UU[Ν=}wwy]_[W[ 6[V`(J F"ZmSc/r6<1
COdy<@yyEEYtBp`w5hK7DDDDD6£RT
`4lv;Ri4?t(p_d2C^":xflTZv xD+55--#HN9c9Ftj OVW^zj`&3ёFP[-_r8|8 EQHDyZ/ ]Qj -----M|O# ))999@ u:^4F?^s}PW SoԩSNu֯߰Akk~ׯo>}xM IQpDD֘HDZڊaрjjOQ|>|r@jwjBPrNKt1bN
pnԩsg73@ p0O>曛 Y_ ֢E-Zo _ >)(
yxٙ3
ذ&,c.`oh֬yz+1{ ?{ { ?@;E5YҼZ{MzWfxF~ ƍjc@߹?VhP(x<^/=oE[4hZtExm~ v Ǐ0lnJfѺ2@0X^~=to |(wx g #eB>߳7oUA&CN[~8{Q ~ +˞}DZƮ_&X2{'z
8T^G ί6
+Js rxwfH$=*hj^tZ^ߔ<ܸxo90+ϯj-oriӀ'8唤$@w8uF:$Ets&JsΚ5o t҃3g Tb28꼼ѣO?l23Eرgy@RRZ hL?O! <i^WZoﳢTT <4H$=wx] R-@8r pMME
UW~b6]ju(TP ̚u>,XPUUufz 6lxϱcm6p }j.<>8= 4t:ZT; a
M\<_~SJ&*ԋƖS>'?cw : lMKF 5[7 1lVXCZDG) /1ǜvژ1 ˪ڴilkǻg>}Sir)*'vj*[ Ǝ J6``L&I.]ֿ`0 ;wږdhF>$`РYՀ F\i<\8-&$ ]铜,Q_ gvS[$ ~
秥FT q8@9RɌw;VB͛cXf8α@&h($ύFc˿
D`'ţÁ (^!*
w8ѣ'O~)+tQ
_~Y onǯ2Dh߯6B> 0iҙgyfߧ(?%.x㛾3ꫯG>ʕNgaS>80aպu+;?
UUHt ;鍊8唼< -{ફ^xa˖fv6pӧ0fXX\y /vЯ8&߿{70{7>0{Ϟ::uصkw(~Ѿ[`xbw^y~?JܽI'>йN ]? ̚ ,^{ LG\rM_ .Rio
.******
R p" z\';v,Xh s5 W^v:ou֕Wv ̀hכ`A?[VW՚;b0q_~9p]"exᅕ+kjD, ?ܸnK RR,h~ػ7c 9˖l@ޗ^ sI'%%dաЎ Oܹ֕^o4j0 =z\yԩc&$ YO6%c͛7mt:1plb %6miMU*z^L_
jŠ:vYpXtᚚ`ժ+ׯv
.!S'`#rr0WW/]-eenjԡCO;
8t0 +*ŋ?dΜ''q9q%%?~ƍ@N駟z*й^/^ruUU"0%>lNM5j̘ ]G믿. ՚
7r@
+Z`ժ/|=`*Y}i)gmy̘\믟~ogXJ4*^s%TL[,C*%o G"rҌh4FPFE|TwE_mZ&t↳^o0h4@ZZ wff* wu[_}5aЯE zrVXo c
gyU\}v
fOtii< Fc${7w@IW"p-zusϝ:6mzkQ딦nĉ={ZFӼdF̶mܹ+ҧ^R fszzf8*Ы,]0gOS+N:I,8cp))n7v O̜+ >ة #G %W_
&NFLKuԽ3rr.:uSzU*Zҵk[mG =ԬY_=0e
X_}<)۷N
9sN}}h̘^zSSm}^xŋ^CӵA|bCdX,xKIi 5kٺO ;^yeW/D عWzz$R]
lذy3 3gg(߯ӥ ߿n 0{]O6U]Y[kuuuum-PYYYYU b٤Ąa0 #PuWޯPEf͒%k.W' uָq P]z? K._s'6n^/PQQY ]xĉ@Ϟ 8oh))ȑ' D"{O s WUk.^jP^1b0aqu .ƍ?su5 T[][~Vu73ݭP(-]_e˖//( N>G 6|Sごˁݻh߇JΈ P= ^c9FIÀǁ Qݟhz7lX O`|Z{;3O`}wY|k HHHIIJ c8u`= qj4՚.>_dt2z4pyy PTTZ"Dd
L zEE %%D =@=[ KLLIIH f51HN6E=}tԓTWWWWT :cܹsyy@Ba!$<)))--/˫'m9 F4} ~GG }_~|yuaN0;= 05HO֭sgl۳D W0DƍFwVKh[:\.- {ry[ytVUSyh竨(+kZGܘZč2EG.
23O;ˁ3HHظ
|>n}`;jkȴwOZ __P \h0ZUX8 K[k d{Zr] hj \z9
dd퉉@^^9[㺂ڇhU*-^V:| {쭷?"˖MC LeVhFc4 @˕+Y| 0M
XW ҺZPH06[>@rN'Rۿ.WUr7]ٮ7[@bv A *nԵMUkq>(L߯m9a 2#
5uu
xc{(bp"XFy뎸~c犲߁HDF~"]Q9!0* v++uz߾áQZ hXHGÆ hΛXQXrʕ%%@ǎguـF嗿r6i4@>7ޘhhqq t{{]UU@ ` ljN5b̘LBmCMڬ b?gٜ_*JC\ڵ}\s
0mZK"jN}F^ULthZnZ p:E33lII͖0v,p]3fL6eC#iltCS \Nf5uC}k-k:`AQ jٲWlPSz|`Zk0e8,kt%%N' X&XK[o[+Θ .ϓ'x#wWb =8C r ˖C= z}뱣lt:kjbG8
ӂGNhY,l6L"v L{ "Ӊ.&5x : &S' 8 \M;ΚZ-DljCV 1
"!ť &SKks|}O{ϼR ~k7c۩VAo'2#-"NXKﱸ1+Gn",rY(cAd>_ ^iW
_~b8p %EQqXLr55vtflB55= `LJMLF_O_xJl.(ـa9g@`/ /^rr8 ,h^1>j=fs+t:=%EtYܳsZz]1f̔)~x Mڥ O X,b >ʌ >Yְ;}MҶpxox?22s=~ PHTбbIL,.曕+ݻjk*ҭh
U~u뀊
ؽ{ӦZ}z}n1%o|ҥ-EEee@yyQQAeuu@0زh{kz 78W#U=67m\fB`i0[O91cƌ3b/4mu}j[ Yt"RzEv(,tHdh{)Tذa ؼ {N1ceX3^zEÆ-n6`={jj ;T@w CXڳ ;R|>nBBbbRR,.ۧ(2B6vG}kl6O?7a
cDv+WYkPQQ[tN~UUy 7) 92!Xwkh /`8w]l{{];Ｓhm[ee] P]]YYY ZthY Q%KVNh4 w ά(?ز~\W"*/^d PV ~M_ zlY7G_xNκؾ}{
%W3 bC5R%Fk3|O?DD̤$Srrb=z W\1y:cƫ_{*
tz9L|ٙ"K@=T*Blզ]j
YO۷= СCB0V !C6w իڑ#hcl3f̞
_G|ol)i~?swMv۬Y"$!GSn[]ya.8˟ >u8 cZ:K uy̙?t)P^.VuN>N;
}Ͷǎz2)2$99))5Ue2O7* M;*3d
+/_ 7oy@JJ߾'xb>Csnt@~?}|u4 ӹ*^ s̨Q=zDuVY ^p $Xd[什EbؖC]lXj8l-$:yX}~.=5n11pfĦ7 ^]x|Vj4:O=uMŲKFлa'Cz)@nV:.^ߥ p{k/w9w : }w^=0b": p,\[7jFdd̚UV ߵ+`0 \Je6uʱNJl(gs+ΝK/kf͚1c nN X:v 9Amܔ
:dD5cO^|^ye{{SO?7xƗL,Wھ 2墋orV+W1{($qUSLN(/ȂAQjZ@hҲV+ާ|ޔ "soFʷouݼG N'%r۶͟ԩ˖
<];-M$>O/} 6 jy?7])[cKEEyyYݱcn.A̙2s&0v1' YM[,f,\O? Lt&zc0 Fc{ Qb:ZqeTCÿqF6{XFFGlß}v4qql}匑w - e}ܻo|lY;]5^/ YRU%'$8 ,xiq4: W\[k*`5 ^4?xhqsׯVG"%%?ΜnrjH:w>8ࢋn䓁4J~)JS>/qhl *
3@*^om=-M($."?Tm'y~5as Z3u[%{[jD;]u=){UU"n DŽ1#S鬫L&EG6pclҒ!CSGSс`z@Mm/Z__Y)b_#GvlrЃۮOvhsKk[i.{jq*x2#kPD?P yҰkuczSseсY{ 7]Mٞ^Wĺ4+#m> O*h]x$_TpP6495Nwc͚{7lh 4 麛 yVy6gȑ3- A;].KQ#.lSRbΟv\}Oh;ΩXh4 @߾' ul81ZþcE[BL..2 @| O,3e]|bXɏGm6 |)AN XQ@IUUUUT,Njc)c:HᒏGXg yǤwpZz4ʹNMMIIOKJb\N^w\N)-NKݰQX'nv@ y Ѱ0̀vJyw x2E\~2({gGO]@.ѡ]Z Oc@@;
y
IThP*Ձ& 8N%`}|./|TTw囒zV%:ȔĔ *+6fuuˎ,
)>bv ĝhb
l2Bt73^#2Tٳc(} E:Dߵ@D#"jޅ'>֛?Y-jM&`͚]3N /𗚚֡C ׯӟzF
V1N -2UL)3`eC66lHb:d ^_}L*@[n*@x@`ǎ揁VD7@5tDui ! Dfz4L5HQ^xaF? 9Fo,| "jUW]~UW}Kt4jxuh2LAg}>1-|mm]]]]zD vnw8bc
^z((;/쯿~M p,wJg Gt(_Jk2P" ӹdžӱ6~9O*/#/d
$مWvilֲǦdHտ ޛnvx< 1 ]7~-ba&*@iYxiG"""@# TQcdDZ]x42n>Z$"""""""^k.H!""""""C(eeb p8 EFe^/t萑gffg^ʮ=6aODDDDDDDZmhT<% =!ሽ.Gh4
#JDDDDDDDtZJFFfff& 0Êdeu옓8 HLLH rrrrp8F`0 c'"""""""jobX6еk =z|=6p 55wс1BDDDDDDD(DDDDDDDDq0BDDDDDDD(DDDDDDDDq0BDDDDDDD(DDDDDDDDq0BDDDDDDD(DDDDDDDDq0BDDDDDDD(DDDDDDDDq0BDDDDDDD(DDDDDDDDq0BDDDDDDD(DDDDDDDDq0BDDDDDDD>HQEQ*|>h4L& 11999Pj5:DDDDDDDtiPE$D"@qqa=y($%%&&%Ş=!""""""GPdIiiQQa!tZ-`l6
B`NjVGq=wjF j~ vǞ[,""g V @GQݻvX6
^8uuN._D E"""""""::",ٳgΝ;cjZx r VtҥkuqcWj*~BDDDDDDD(ee%%ŀJD+'n誣V
ٱcǎF#)YY9999V#/? t #Vш9.WlV逎 c+._LyDDDDDDDD(fnv.rj0>M [^_OfX,vGDDDDDDDG{+ʊuh4Z ے@ wܥ8bEv#""""""sJR #!!! @ QkQs (DDDDDDDDq0BDDDDDDD(DDDDDDDDq0BDDDDDDD(DDDDDDDDq0BDDDDDDD(DDDDDDDDq0BDDDDDDD(DDDDDDDDq0BDDDDDDD(DDDDDDDDq0BDDDDDDD(DDDDDDDDq0BDDDDDDD(DDDDDDDDq0BDDDDDDDAPh4< |>m#"""""""j/ڃ]AUUeeE
VT*P[[SS]
t萑 j EQEJJE^ %%55-Agx"3h4Fnw8bB D"#_#"""""""j/ @1D`#օGdX6
hZF2L$\.7L&APRS;tHOT*Z\.劍]bXV+Vk4
PT{@(
@a]v^uGDDDDDDD(MFFVVvtՀ- ^vb FV;wnVP8cV EFvvNNNN,2L&3NdddgwXDDDDDDDD?nOH* @ D G^ d; ,u].+6]Vt< DDDDDDDt9 +6)//--+%~_VVZZRWQG0 HKHOfj$""""""wҒ&&&%%$^)NgmmM
PZZ\\\ tԵknW~NkF=-[>{ɩS?昇 3y %%ҥ?k?iP] @fСpu\s)@fJ7p
>d 6^]oz6o_}+
끴O? 뮓M.FAdٲO>~~XQl:tkh'MkvA8\X|ݬYq<رJ(F#`mkp
f{~jNlC=ݲrEx<[X(J(Vk#F *V yŭ-**~?AW+ 0ڷ@_O@AAޓ&SroL
L[;0~!"":"! KOvvvvvvˍ#_]yzn< 7#EnW_o}[WU : sޥ(nΝ>_>e={M:kK 7۷|3[PqǕWwU{֭L4&"#|k͒%K,Yӷo߾}2Ml6
p\.+Ht:.an x 4weh4II#F W\u0dH^^j*ڹ}X,@m555^b b F KV`.5
HMhvK{rrRRvdD)bL&qM~`>'u@Zڿ7x晃;gf} 7a ' roŻk~UHP woKca7ᇻwPӯz}8k,]
$%uԡ1rh2EΝ/p
@$:Gk_}#G$$w 8dɑW]P(.+ {t'M]_kѶމRY};P[k>"PҺtRRk]jka` EۂRD"7Kg] G6'%ؾx9O<0W3mzn ySu:JEIL_D_8v4lXVvƍ@UU$ҹ3V{e˖# vؽ[Ət4W^y 3@`zq>(/?n L9 pxoO "":y> lYf͚5@Ϟ={ 0z>Ff I G,[քN/]tYjܖ- UnDN9'3Stil7}TV x1ͻw>;KyUܻ% ?>hKKJX9c;t mߎ oe
D"/g=`4IIiiݞY{yڤ$wAu22Ӂ^&LB`ہ^2Ӓڴ3y[g%&$%IIyyazq@rre@ql vW?c. <199-
7?p|~zKΖ# eD>VUUUUU@MMMMM
PTTTTTCE>.=2#EvᑁG$RSX/ KjW\1bDbb Ѩ۽q#w+VhQڣGKjsr{7 ^z `ĈM쳝;s? >V$%L/{$RWl/ YUմAS.h*JdR>nuœ'8 ~mZۺub 9_!C Ydl\v۷?W/[۲eb|ٲkHD/h#NF.nvq(TRnwݺY,欯Z { 78P I4
x<7/\lh sNv
ƩRÑ7rx1pMs,_ yy@n#j$_8,E0$-*+F ki5
n\_϶.J7o6
ؾ}ʔIe6nRS= HJw@QVw`{ x<63PQv] ptttS>HR] |oNX~}rs7u}cNJvjƚNҩvo
{(pT@(T^e PYfd Mm*j4`'$ !11) 8ǎ]d"1T$t֡ xiKm Cz+
YDD#?S_ْ 5!o晫w_l@^~
Otҹ;O<̘ ݻ?ĉ@VVýѤ C ݡ _l L#Fq%'ii9[kp=w=5biJkK˻ mUgըVk z]TTW{; ёOfX,
L&eCBdF$,+PYV{ P /\٥ puʀJbbbbb"{csٵ2yr=rC ɞ=W\qy@~"
P( - 6lض-23KOo|Hrמ~ׁŋ++Eרڍ%K~}X\wlݺh |i` 0dH J%2j3((x ^~yի;4%%%%@mmNAji=wPM&1/b?Z^OFdFxpau|\ߑi|ee+WKv ݳպoO]n6;8[n^~ A 1wn;4MH!Z].`)SngFc=z \}w@Ϟ
st q&L 9=ZjHfs u9ݻO=5k7Эy?0yg
\roꫳf"vRY@.'}7pWNn2o 0c̙˖rlm:!kW`ܸK/09Z4x00aB =v,p :ԏ\Tfss˙wA os {[{3+kPs+OHq)J i m/ 쳓&fy[Z>m[
[7 ˁٳ_y W_Z
X,#F iiFDDD d1L ߿,cDZӰ|
6lذ!@]H ((N`I篽C
;NIN>еxx'\ww"mCwHɓOi{GJH?X[YU3PPa!?y2%%v;Э۩^s
p-Æ1pBDDDt}_|z|7|]t'IIIIϽDy"@ p8" n/%% qc plG"V99ݔiBDDDDK/+uX,96 DΦ#3Te eGv&r @q:N D _~yL "":#8 :tP3<3'"a n뮋= 8Q
Q
Q /X~ BDDDDDDD_:d IENDB` lottanzb-0.6/help/mallard/de/figures/lottanzb-logo.png 0000644 0001750 0001750 00000003404 11525760436 022775 0 ustar lantash lantash PNG
IHDR szz sBIT|d pHYs
B(x tEXtSoftware www.inkscape.org< tEXtTitle Contact NewdK? tEXtAuthor Lapo Calamandreiߑ* AIDATX]h\sܻ+v%b+I-JRj Oxྸ 6)!mi J1
~0zKM Y4&$Vr*KV+םi7Ziar`̜9?sG|&PR?g<3߶)L"K )%aP6WZF1UÑ#Gv ;v c Ǐ ĉ>} 0xL&C< }._L< ͛cbddFGGK_*\[8|p^(B&''y!J)ƈb377իWIRcHӬM8gY֥=kC100PvEz{{ By9x oߦV֜?
[ P G Ν;ekW\
cسgccc߿wގ֚nΜ9W 7ٳ:u
c Xh4J[[b1fff8w ׯ_cB=gd2/imm%HN-ZLI)ijj"
1??RjÙ֖ 244D2IJ,\q AJI 2Kuu5BۈFʘ}Bl Bd2TJm8 RayxC**c`)%UdBJI$ !x15EM]3m۶3Uo,"
?zq-(ζmY"Q
^
˲, kr\ s[oT hF18Y@GK M fn3h/ĀmeK)y]
+1Ek]Erid2 5>" hzZi|@/1mۥoO)oPk J}PJ3??_^ ! */2 B+Lk
Tsݻw訴X5`YVY͋^ҌzѣGRd2\u]~U:bg97o̦EGJ'sx k^)xPjzzػwoɓ'ihh8miXMyJ!9ov$[xeEr4pAk.۷,+noNruӀ-<{ )>y +6SZ;ǟ&<=C[x.ڻrD @"G˹w'-ш%B(
KE _\I Xq/ /9 G+ qD\J=_J}{w `O*K|:$fVd|:${^ iAUn. t/]CcQ !Fy { M
5o/߸qi9ɤ
Die Download-Geschwindigkeit überwachen und beschränken
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB-Entwicklungsteam
Creative Commons Namensnennung-Weitergabe unter gleichen Bedingungen 3.0
Download-Geschwindigkeit
Die Geschwindigkeit, mit der Dateien aus dem Usenet heruntergeladen werden, wird in der unteren rechten Ecke des Hauptfensters innerhalb der Infoleiste angezegit.
Die Download-Geschwindigkeit begrenzen
In der Standardeinstellung lädt LottaNZB Daten so schnell herunter, wie es Ihre Internetverbindung und der News-Server erlauben. Damit Downloads andere Internet-Aktivitäten nicht beeinträchtigen, können Sie die Download-Geschwindigkeit einschränken. Dafür stehen Ihnen zwei Wege offen:
-
Wenn Sie in der Infoleiste auf das Symbol neben der Download-Geschwindigkeit klicken, öffnet sich ein Menü, in dem Sie eine der vordefinierten Geschwindigkeiten wählen oder das aktuelle Limit deaktivieren können.
-
Wenn Sie eine benutzerdefinierte Download-Geschwindigkeit einstellen wollen, wählen Sie Bearbeiten Einstellungen/gui>seq>, aktivieren das Ankreuzfeld Download-Geschwindigkeit beschr und geben die gew
In beiden Fällen werden die Änderungen sofort angewendet.
lottanzb-0.6/help/mallard/de/introduction.page 0000644 0001750 0001750 00000002575 11525760436 021417 0 ustar lantash lantash
1
Eine kurze Einführung in LottaNZB
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB-Entwicklungsteam
Creative Commons Namensnennung-Weitergabe unter gleichen Bedingungen 3.0
Einführung
LottaNZB ist eine Anwendung, mit der Sie Dateien aus dem Usenet herunterladen können.
Das Usenet ist ein weltweites, verteiltes Internet-Diskussionssystem, das es schon lange vor den ersten Webseiten gab. Neben normalen Textnachrichten können Benutzer auch Dateien wie Bilder oder Videos versenden, die meistens in verschiedene Nachrichten aufgeteilt werden.
Um das Herunterladen solcher Dateien zu vereinfachen, wurde das NZB-Dateiformat entwickelt. Solche NZB-Dateien werden von Usenet-Suchmaschinen erstellt und informieren LottaNZB darüber, welche Dateien aus dem Usenet heruntergeladen werden sollen.
lottanzb-0.6/help/mallard/de/index.page 0000644 0001750 0001750 00000002272 11525760436 017777 0 ustar lantash lantash
<app>LottaNZB</app> Usenet-Downloader
<app>LottaNZB</app> Usenet-Downloader
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB-Entwicklungsteam
Creative Commons Namensnennung-Weitergabe unter gleichen Bedingungen 3.0
<media type="image" mime="image/png" src="figures/lottanzb-logo.png"><app>LottaNZB</app> Logo</media> <app>LottaNZB</app> Usenet-Downloader
lottanzb-0.6/help/mallard/de/setting-up.page 0000644 0001750 0001750 00000005764 11525760436 021000 0 ustar lantash lantash
Mit dem Herunterladen zu beginnen
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB-Entwicklungsteam
Creative Commons Namensnennung-Weitergabe unter gleichen Bedingungen 3.0
<app>LottaNZB</app> einrichten
Voraussetzungen
Um mit LottaNZB loslegen zu können, benötigen Sie:
-
Ein News-Server-Konto , das den Zugang zum Usenet ermöglicht. Es gibt zahlreiche News-Server zu verschiedenen Preisen und unterschiedlichen Rückhaltezeiten . Eine Rückhaltezeit von 500 Tagen bedeutet, dass eine Datei 500 Tage nachdem Sie hochgeladen wurde, gelöscht wird.
-
Eine Usenet-Suchmaschine mit der SIe nach Dateien im Usenet suchen und die entsprechenden NZB-Dateien herunterladen können.
Erster Start
Wenn die Anwendung zum ersten Mal gestartet wird, werden Sie gefragt, ob Sie auf Ihren Rechner herunterladen, oder stattdessen
-
Für das Herunterladen von Dateien aus dem Usenet benötigt LottaNZB eine Anwendung namens SABnzbd . Wenn diese Software nicht auf Ihrem Rechner gefunden werden kann, werden Sie aufgefordert, diese zu installieren. Folgen Sie dazu den bereitgestellten Anweisungen.
-
Als nächstes geben Sie die Informationen zu Ihrem News-Server-Konto ein.
Normalerweise enthält die Webseite des News-Servers die Adresse und den Port, die eingegeben werden müssen. Je nach News-Server ist es möglich, die auf Ihren Rechner heruntergeladenen Daten mittels SSL zu verschlüsseln. Kreuzen Sie das entsprechende Feld an, wenn dies der Fall ist.
In dem meisten Fällen muss ein Benutzername und ein Passwort eingegeben werden. Einige kostenlose News-Server erlauben den Anonymen Zugang und benötigen kein Benutzername und Passwort.
Ein Klick auf OK bringt das Hauptfenster zum Vorschein, wo Sie Ihren
LottaNZB -Hauptfenster
lottanzb-0.6/help/mallard/de/observed-nzb-folder.page 0000644 0001750 0001750 00000002530 11525760436 022536 0 ustar lantash lantash
In einem Ordner gefundene NZB-Dateien automatisch hinzufügen
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB-Entwicklungsteam
Creative Commons Namensnennung-Weitergabe unter gleichen Bedingungen 3.0
Überwachter Ordner
LottaNZB kann automatisch NZB-Dateien zur Download-Liste
Sie können diesen Ordner auswählen, indem Sie Bearbeiten Einstellungen NZB-Dateien autpmatisch hinzufügen von im Reiter Allgemein ankreuzen.
Standardmässig wird derjenige Ordner ausgewählt, der auch von Web-Browsern für heruntergeladene Dateien verwendet wird.
lottanzb-0.6/help/mallard/de/prefs-general-tab.page 0000644 0001750 0001750 00000002071 11525760436 022163 0 ustar lantash lantash
Den Download-Vorgang anpassen
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB -Entwicklungsteam
Creative Commons Namensnennung-Weitergabe unter gleichen Bedingungen 3.0
Allgemeine Einstellungen
Im Reiter Allgemein können Sie einstellen, wie Dateien aus dem Usenet heruntergeladen werden sollen und was mit ihnen geschehen soll, nachdem sie heruntergeladen worden sind.
lottanzb-0.6/help/mallard/de/post-processing.page 0000644 0001750 0001750 00000006337 11525760436 022035 0 ustar lantash lantash
Aktionen, die durchgeführt werden, nachdem alle Dateien heruntergeladen worden sind
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB-Entwicklungsteam
Creative Commons Namensnennung-Weitergabe unter gleichen Bedingungen 3.0
Nachbearbeitung
Nachdem alle zu einer NZB-Datei gehörenden Dateien heruntergeladen worden sind, wird LottaNZB einige weitere Schritte durchführen, die Nachbearbeitung genannt werden. Die Nachbearbeitung umfasst üblicherweise die Reparatur und das Entpacken der heruntergeladenen Dateien. Sie ermöglicht es Ihnen, auf die heruntergeladenen Inhalte zuzugreifen, ohne irgendwelche weitere Schritte tätigen zu müssen.
Während der Nachbearbeitung bleibt die Fortschrittsleiste bei 100%. Jedoch zeigt LottaNZB unter dem Download-Namen an, welche Operation gerade durchgeführt wird, sowie deren Fortschritt, z. B. "Reparieren... (42%)" .
Während der Nachbearbeitung verrichtet der Rechner schwere Arbeit. Es kann daher etwas länger dauern, bis er auf Ihre Eingaben reagiert. LottaNZB versucht, diese Effekte zu minimieren.
Nachbearbeitung anpassen
Nach dem Auswählen von Bearbeiten Einstellungen Nach dem Herunterladen , um auszuwähen, welche der folgenden Aktionen während der Nachbearbeitung durchgeführt werden sollen. Eine Aktion kann nur durchgeführt werden, wenn alle Aktionen oberhalb davon ausgeführt wurden.
-
Reparatur
Überprüfe die heruntergeladenen Dateien auf Fehler und wenn welche gefunden werden, versuche diese zu korrigieren. Damit die Reparatur funktioniert, muss der Download PAR-Wiederherstellungsdateien enthalten, die nach Bedarf heruntergeladen werden. Dies trifft auf viele NZB-Dateien zu, die auf Usenet-Suchmaschinen gefunden werden.
-
Entpacken
Entpacke den Inhalt der komprimierten Downloads. Im Usenet werden grosse Dateien oft komprimiert und in mehrere RAR-Archive aufgeteilt, um Platz zu sparen.
-
Löschen
Lösche die heruntergeladenen Archive, nach dem deren Inhalt entpackt worden ist. Wenn das Entpacken erfolgreich war, werden die RAR-Dateien üblicherweise nicht mehr benötigt.
Standardmässig werden alle diese Aktionen durchgeführt. Es ist sogar möglich, die Ausführung all dieser Aktionen zu verhindern, indem Nichts tun
lottanzb-0.6/help/mallard/de/prefs.page 0000644 0001750 0001750 00000002652 11525760436 020011 0 ustar lantash lantash
Verhalten der Anwendung anpassen
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB-Entwicklungsteam
Creative Commons Namensnennung-Weitergabe unter gleichen Bedingungen 3.0
<app>LottaNZB</app>-Einstellungen
Nachdem LottaNZB eingerichtet worden ist, d.h. zum Verwalten der Downloads Einstellungen möglich, festzulegen, wie sich die Anwendung in verschiedener Hinsicht verhalten soll. Sie können ihn durch Auswählen von Bearbeiten Einstellungen
SABnzbd , die Anwendung, auf welcher LottaNZB aufbaut, bietet viele zusätzliche Optionen. SIe können diese durchshenen und ändern, indem Sie die Einstellungen auswählen.
lottanzb-0.6/help/mallard/de/remote-access.page 0000644 0001750 0001750 00000006327 11525760436 021427 0 ustar lantash lantash
Downloads eines anderen Rechner verwalten
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB-Entwicklungsteam
Creative Commons Namensnennung-Weitergabe unter gleichen Bedingungen 3.0
Fernzugriff
Es ist möglich, die Downloads eines anderen Rechner in gleicher Weise zu verwalten wie Downloads auf den selben Rechner. Dies ist in vielen Situationen nützlich:
-
Der Rechner zu Hause lädt herunter und Sie möchten dessen Downloads mit Ihrem Laptop verwalten, während Sie weg sind.
-
Sie möchten es anderen Personen im lokalen Netzwerk ermöglichen,
-
Der andere Rechner ist in Wirklichkeit ein Gerät ohne Bildschirm, zum Beispiel ein Network-Attached Storage (NAS) .
Zum Schutz Ihrer Privatsphäre ist es standardmässig nicht möglich, von einem anderen Rechner aus die Downloads Ihres Rechners zu verwalten.
Erste Schritte
Gehen Sie wie folgt vor, um einen sicheren Fernzugriff einzurichten.
-
Beim Rechner, auf dem die Downloads stattfinden, können Sie den Fernzugriff erlauben, in dem Sie Bearbeiten Einstellungen Fernzugriff auswählen und das Feld Zugriff von anderen Rechnern zulassen ankreuzen. Es wird empfohlen, den Fernzugriff abzusichern, indem Authentifizierung verlangen ausgewählt wird und ein Benutzername und ein Passwort eingegeben werden.
Bestätigen Sie Ihre Änderungen durch Schliessen des Fensters.
-
Auf dem Rechner, von dem aus Sie die Downloads verwalten möchten:
-
Wenn LottaNZB zum ersten Mal gestartet wird, wählen Sie Downloads eines anderen Rechners verwalten im Dialog Mit dem Herunterladen beginnen .
-
Wenn Sie LottaNZB bereits verwendet haben, wählen Sie Datei Anderen Rechner überwachen...
Geben Sie den Namen oder die IP-Addresse des Rechners ein, dessen Downloads Sie verwalten möchten. Wenn Sie danach gefragt werden, geben Sie auch den Benutzernamen und das Passwort ein, dass Sie zuvor gewählt haben. Klicken Sie auf OK , um mit dem Verwalten der Downloads zu beginnen.
lottanzb-0.6/help/mallard/de/news-servers.page 0000644 0001750 0001750 00000004112 11525760436 021326 0 ustar lantash lantash
News-Server hinzufügen, bearbeiten und löschen
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB-Entwicklungsteam
Creative Commons Namensnennung-Weitergabe unter gleichen Bedingungen 3.0
News-Server
Um News-Server hinzuzufügen, zu bearbeiten oder zu löschen, wählen Sie Bearbeiten Einstellungen Server .
Server hinzufügen und bearbeiten
Sie können die Informationen eines Servers bearbeiten, indem Sie ihn auswählen und auf Bearbeiten klicken. Klicken Sie auf Hinzufügen , um einen neuen Server hinzuzufügen. In beiden Fällen wird ein Dialog geöffnet, mit dem Sie die Informationen eines Servers angeben können. Die Änderungen werden erst wirksam, wenn Sie auf OK klicken.
Normalerweise enthält die Webseite des News-Servers die Adresse und den Port, die eingegeben werden müssen. Je nach News-Server ist es möglich, die auf Ihren Rechner heruntergeladenen Daten mittels SSL zu verschlüsseln. Kreuzen Sie das entsprechende Feld an, wenn dies der Fall ist.
In dem meisten Fällen muss ein Benutzername und ein Passwort eingegeben werden. Einige kostenlose News-Server erlauben den Anonymen Zugang und benötigen kein Benutzername und Passwort.
Server löschen
Sie können einen Server löschen, indem Sie ihn auswählen und auf Löschen klicken. Beachten Sie, dass dies nicht rückgängig gemacht werden kann.
lottanzb-0.6/help/mallard/de/incomplete-downloads.page 0000644 0001750 0001750 00000006242 11525760436 023020 0 ustar lantash lantash
Downloads, die noch auf deren Fertigstellung warten
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB-Entwicklungsteam
Creative Commons Namensnennung-Weitergabe unter gleichen Bedingungen 3.0
Noch nicht fertige Downloads
Im Fall des gerade aktiven Downloads wird die geschätzte verbleibende Zeit unterhalb des Download-Namens angezeigt.
Downloads anhalten
Durch Anklicken von Alle anhalten oder Auswählen von Datei Alle anhalten
Es ist auch möglich, einzelne Downloads anzuhalten, indem mit der rechten Maustaste darauf geklickt wird und das Feld Anhalten angekreuzt wird. In der Download-Liste werden solche Downloads grau angezeigt. Sie können einen solchen Download später wieder aufnehmen, indem Sie das Kreuz beim Feld Anhalten wieder entfernen.
Downloads umbenennen
Wenn eine NZB-Datei zur Download-Liste Eigenschaften . Die am Feld rechts von Name angebrachten Änderungen zeigen sofort Wirkung.
Ein Download kann nicht mehr mit LottaNZB umbenannt werden, nachdem alle seine Dateien heruntergeladen worden Sie und die
Downloads entfernen
Jeder Download kann abgebrochen werden durch einen Klick auf Löschen in der Werkzeugleiste oder durch Drücken der Taste Löschen . Dies kann nicht rückgängig gemacht werden und jeglicher Fortschritt geht verloren.
Die Download-Liste umordnen
Es wird jeweils ein Download nach dem anderen durchgeführt, wobei der Download ganz unten in der Download-Liste als letzter durchgeführt wird. Sie können die Liste der noch nicht fertigen Downloads umordnen, indem Sie einen Download auswählen und ihn an den gewünschten Platz ziehen. Des weiteren kann ein ausgewählter Download auch mit den Pfeil-Knöpfen im Umordnungs-Bereich links der Downloads verschoben werden. Ein Klick auf den obersten Knopf sorgt dafür, dass der Download umgehen gestartet wird.
lottanzb-0.6/help/mallard/de/web-interface.page 0000644 0001750 0001750 00000005242 11525760436 021403 0 ustar lantash lantash
Die Downloads mit einem Web-Browser verwalten
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB-Entwicklungsteam
Creative Commons Namensnennung-Weitergabe unter gleichen Bedingungen 3.0
Web-Oberfläche
Ihre Downloads können Sie anstelle von LottaNZB auch mit einem Web-Browser verwalten. Diese Funktion wird von der Software SABnzbd bereitgestellt, auf der LottaNZB basiert. Diese Web-Oberfläche ist in folgenden Situationen nützlich:
-
Sie möchten eine erweiterten Funktion der Web-Oberfläche nutzen, die noch nicht in LottaNZB verfügbar sind. Zusätzlich können Sie damit den Download-Vorgang besser Ihren Bedürfnissen anpassen.
-
Sie möchten aus der Ferne die Downloads mit einem Gerät verwalten, auf dem LottaNZB nicht läuft. Dabei kann es sich um einen Computer handelt, auf dem ein anderes Betriebssystem als Linux läuft, oder ein Mobiltelefon.
Im
Die Web-Oberfläche öffnen
Sie können die Weboberfläche öffnen, indem Sie Datei Weboberfläche öffnen
Man kann die URL der Web-Oberfläche auch direkt im den Browser eingeben. Wenn auf den selben Rechner heruntergeladen wird, ist diese URL localhost durch den Namen oder die IP-Addresse jenes Rechners.
Die Web-Oberfläche eines anderen Rechners kann nur geöffnet werden, wenn es den
Wenn Sie beim Erlauben des Fernzugriffes einen Benutzernamen und ein Password angegeben haben, werden Sie danach gefragt werden.
Wenn die Web-Oberfläche häufig verwendet wird, ist es für den schnellen Zugriff darauf ratsam, ein Lesezeichen im Web-Browser zu setzen.
lottanzb-0.6/help/mallard/de/searching-download-list.page 0000644 0001750 0001750 00000002515 11525760436 023411 0 ustar lantash lantash
Downloads in der Download-Liste finden
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB-Entwicklungsteam
Creative Commons Namensnennung-Weitergabe unter gleichen Bedingungen 3.0
Durchsuchen der Download-Liste
Wenn die Download-Liste viele
Sie können die Download-Liste durchsuchen, indem Sie einfach einen Teil des Namens des Downloads eintippen, für den Sie sich interessieren. Der erste Download, dessen Name ihre Eingabe enthält, wird sogleich ausgewählt.
Wenn die Liste der fertigen Downloads lang wird, können Sie diese auch
lottanzb-0.6/help/mallard/de/license.page 0000644 0001750 0001750 00000003227 11525760436 020313 0 ustar lantash lantash
Rechtliche Informationen
Lizenz
Dieses Werk wird unter der Lizenz Creative Commons Namensnennung-Weitergabe unter gleichen Bedingungen 3.0 Unported veröffentlicht.
Sie dürfen
-
<em>Teilen</em>
Das Werk bzw. den Inhalt vervielfältigen, verbreiten und öffentlich zugänglich machen
-
<em>Remixen</em>
Abwandlungen und Bearbeitungen des Werkes bzw. Inhaltes anfertigen
Zu den folgenden Bedingungen:
-
<em>Namensnennung</em>
Sie müssen den Namen des Autors/Rechteinhabers in der von ihm festgelegten Weise nennen.
-
<em>Weitergabe unter gleichen Bedingungen</em>
Wenn Sie das lizenzierte Werk bzw. den lizenzierten Inhalt bearbeiten oder in anderer Weise erkennbar als Grundlage für eigenes Schaffen verwenden, dürfen Sie die daraufhin neu entstandenen Werke bzw. Inhalte nur unter Verwendung von Lizenzbedingungen weitergeben, die mit denen dieses Lizenzvertrages identisch oder vergleichbar sind.
Den vollständigen Wortlaut der Lizenz finden Sie auf der
lottanzb-0.6/help/mallard/de/completed-downloads.page 0000644 0001750 0001750 00000003072 11525760436 022633 0 ustar lantash lantash
Downloads, die keine weiteren Schritte benötigen
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB-Entwicklungsteam
Creative Commons Namensnennung-Weitergabe unter gleichen Bedingungen 3.0
Abgeschlossene Downloads
Die Dateien eines erfolgreich abgeschlossenen Downloads können im
Im Fall eines fehlgeschlagenen Downloads wird eine Meldung unterhalb seines Namens angezeigt, die angibt, was schief gegangen ist.
Fertige Downloads entfernen
Mit der Zeit kann die Liste der fertigen Downloads lang werden. Mit einem Klick auf Fertige entfernen oder durch Auswählen von Datei Fertige entfernen
lottanzb-0.6/help/mallard/de/reporting-problems.page 0000644 0001750 0001750 00000001765 11525760436 022530 0 ustar lantash lantash
Kontakt mit den Entwicklern aufnehmen, wenn Probleme auftreten
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB-Entwicklungsteam
Creative Commons Namensnennung-Weitergabe unter gleichen Bedingungen 3.0
Probleme melden
LottaNZB ist weit davon entfernt, perfekt zu sein. Wenn Sie ein Problem jeglicher Art in der Anwendung oder dieser Dokumentation feststellen, würde es das LottaNZB -Entwicklungsteam sehr schätzen, wenn Sie es
lottanzb-0.6/help/mallard/de/adding-downloads.page 0000644 0001750 0001750 00000005764 11525760436 022117 0 ustar lantash lantash
1
Neue Downloads zur Download-Liste hinzufügen
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB-Entwicklungsteam
Creative Commons Namensnennung-Weitergabe unter gleichen Bedingungen 3.0
Downloads hinzufügen
Sie können einen Download zu LottaNZB hinzufügen, indem Sie eine NZB-Datei herunterladen (normalerweise von einer Usenet-Suchmaschine) und diese mit LottaNZB öffnen. Darauf werden alle Dateien aus dem Usenet heruntergeladen, die in der NZB-Datei aufgelistet sind.
Eine neue NZB-Datei kann auf verschiedene Arten hinzugefügt werden.
-
Manuelle Auswahl
Wählen SIe eine oder mehrere NZB-Dateien von Ihrer Festplatte aus, nachdem Sie in der Werkzeugleiste auf Hinzufügen geklickt, oder Datei Datei hinzufügen...
-
Ziehen und Ablegen
Ziehen Sie eine oder mehrere NZB-Dateien und legen Sie sie über dem LottaNZB -Hauptfenster ab.
-
Datei-Assoziation
Klicken Sie auf eine NZB-Datei. NZB-Dateien werden mit LottaNZB geöffnet.
-
Von URL herunterladen
Geben Sie die URL einer NZB-Datei in den Dialog ein, der durch Auswählen von Datei URL hinzufügen... LottaNZB wird diese NZB-Datei dann herunterladen.
-
<link xref="observed-nzb-folder">Automatisch von überwachtem Ordner</link>
Neue, in diesem Ordner gefundene NZB-Dateien werden automatisch hinzugefügt.
Usenet-Suchmaschinen geben oft an, vor wie vielen Tagen die in einer NZB-Datei aufgelisteten Dateien ins Usenet hochgeladen wurden. Stellen Sie bitte sicher, dass die Rückhaltezeit Ihres News-Servers grösser ist, andernfalls kann LottaNZB den Download nicht abschliessen, da die Dateien bereits gelöscht worden sind.
Neu hinzugefügte Downloads erscheinen nach wenigen Sekunden am unteren Ende der Download-Liste, was bedeutet, dass alle vorher hinzugefügten Downloads zuerst durchgeführt werden, bevor der neue Download durchgeführt wird. Erfahren Sie, wie die LottaNZB hinzugefügt worden sind.
lottanzb-0.6/help/mallard/es/ 0000755 0001750 0001750 00000000000 11525760442 016043 5 ustar lantash lantash lottanzb-0.6/help/mallard/es/customizing-interface.page 0000644 0001750 0001750 00000003453 11525760436 023222 0 ustar lantash lantash
Adaptar la interfaz de usuario a su gusto
Severin Heiniger
severinheiniger@gmail.com
2010
Equipo de desarrollo LottaNZB
Creative Commons Attribution-Share Alike 3.0
Personalizando la interfaz
Al lado de la lista de descarga, la ventana principal también contiene los siguientes elementos, ninguno de los cuales son esenciales para
-
Barra de herramientas
Proporciona acceso a las funciones más utilizadas. Es posible utilizar el Archivo menú o
-
Barra de información
Contiene información estadística, como la velocidad de la descarga y la cantidad de tiempo restante.
-
Panel de Reordenamiento
Permite
Usted puede optar por ocultar cada uno de ellos individualmente desactivando la casilla correspondiente en el menú Ver , dando más espacio a la lista de descargas.
lottanzb-0.6/help/mallard/es/multiple-news-servers.page 0000644 0001750 0001750 00000004460 11525760436 023204 0 ustar lantash lantash
Use más de un servidor de noticias a la vez
Severin Heiniger
severinheiniger@gmail.com
2010
Equipo de desarrollo LottaNZB
Creative Commons Attribution-Share Alike 3.0
Servidores multiples de noticias
Sólo una cuenta del servidor de noticias es necesario para iniciar la descarga del Usenet, pero hay razones para utilizar más de un servidor. Considere la siguiente situación:
-
Usted ya usa servidor de noticias gratuito, pero poco fiable. Debido a que algunos archivos no pueden ser encontrados en este servidor de noticias, especialmente noticias viejas, decide crear una cuenta en un servidor de noticias que cobra por la cantidad de datos descargados. Con el fin de ahorrar dinero, le gustaría descargar desde el servidor de noticias sólo si un archivo no se encuentra en el servidor de noticias gratuito.
Las siguientes funciones están disponibles cuando más de un servidor de noticias se ha definido.
Activación y desactivación de servidores
Puede desactivar un servidor de noticias mediante la desactivación de la casilla a la izquierda de la entrada del servidor. Esto hace que LottaNZB detenga la descarga de ese servidor. Más tarde, puede habilitar el servidor de noticias otra vez al activar la casilla.
Servidores de respaldo
Un servidor de respaldo es un servidor de noticias que sólo se utiliza para descargar archivos que no se puede descargar desde otro servidor de noticias. Un servidor puede ser marcado como un servidor de respaldo cuando lo Configuración avanzada y active la casilla user como servidor de respaldo .
lottanzb-0.6/help/mallard/es/managing-downloads.page 0000644 0001750 0001750 00000003012 11525760436 022451 0 ustar lantash lantash
2
Entender y manipular la lista de descargas
Severin Heiniger
severinheiniger@gmail.com
2010
Equipo de desarrollo LottaNZB
Creative Commons Attribution-Share Alike 3.0
Manejo de descargas
La ventana principal contiene la lista de descargas. Cada descarga está representada por su nombre, su tamaño, así como el progreso de la descarga en forma de una barra de progreso. Según el estado de la descarga, se incluye información adicional.
Activando Pusar todos en la barra de herramientas o Archivo Pausar todos
En la lista de descargas,
lottanzb-0.6/help/mallard/es/keyboard-shortcuts.page 0000644 0001750 0001750 00000002774 11525760436 022552 0 ustar lantash lantash
Controle la aplicación usando el teclado
Severin Heiniger
severinheiniger@gmail.com
2010
Equipo de desarrollo LottaNZB
Creative Commons Attribution-Share Alike 3.0
Atajos de teclado
Gran parte de la funcionalidad de LottaNZB puede acceder mediante atajos de teclado. Al pulsar Alt , un carácter es subrayado en la mayoría de los artículos del menú y apretandolo causa ese artículo del menú sea seleccionado. Los atajos adicionales de teclado con uso-frecuente incluyen:
-
<keyseq><key>Ctrl</key><key>D</key></keyseq>
-
<keyseq><key>Ctrl</key><key>P</key></keyseq>
Pausar o reanudar todas las descargas activas.
-
<keyseq><key>Ctrl</key><key>Q</key></keyseq>
Salga de la aplicación.
-
<key>F1</key>
Abra la documentación.
lottanzb-0.6/help/mallard/es/download-folder.page 0000644 0001750 0001750 00000004772 11525760436 021776 0 ustar lantash lantash
Escoja donde poner descargas completadas
Severin Heiniger
severinheiniger@gmail.com
2010
Equipo de desarrollo LottaNZB
Creative Commons Attribution-Share Alike 3.0
Carpeta de descarga
Todas las descargas con éxito se van a la carpeta de descarga . A menos que este Descargas en la barra de herramientas o seleccionando Archivo Abrir carpeta de descarga
De forma predeterminada, LottaNZB utiliza la misma carpeta que otras aplicaciones como los navegadores web usan para las descargas. Es usualmente llamado Descargas y se encuentra dentro de su carpeta de inicio.
Comprueba el remanente de espacio libre en el disco de la carpeta de descarga.
En la esquina inferior derecha de la ventana principal, dentro de la barra de información , LottaNZB muestra la cantidad de espacio libre en el disco de la carpeta de descarga. Este valor se torna rojo cuando no queda espacio libre para todas las
Por favor, asegúrese de que siempre hay suficiente espacio libre en disco duro. Cuando falte espacio en disco duro, LottaNZB hará una pausa en la descarga hasta que libere algo de espacio.
Cambiando la ubicación de la carpeta de descargas
Si quiere descargar en una carpeta diferente, seleccione Editar Preferencias Carpeta de Descarga . El cambio entrará en efecto inmediatamente, pero las descargas ya finalizadas no se moverá a la nueva carpeta de descarga.
lottanzb-0.6/help/mallard/es/figures/ 0000755 0001750 0001750 00000000000 11525760442 017507 5 ustar lantash lantash lottanzb-0.6/help/mallard/es/figures/lottanzb-main-window.png 0000644 0001750 0001750 00000100754 11525760436 024313 0 ustar lantash lantash PNG
IHDR ( bKGD X pHYs ~ IDATxw|u?M!AP`=,g/X8WlzVl+RDzo:=^g~|~sM e3=B {9g) """"""":N̙3w
*UZ y$+++++ EEEEEET8X.H""""""":q4444 H?jpщr H E| Ipg$ Aӕ$ ͆T*eYn\yENߛ~j1ekstK,Xm Fh@Ln^o0D7@*%h4LΛp:].SPBƁ]ZZy@Db WWmwtzNĈ"Z>GDDDDDDt"~_J89'Jp8$$w Z@Jf2N [_rV|SXXV@$@ dP>2222ӁD ....6jjjjR`Ϟ={mHbg4~|*G]qqqqfZ"]vڵK).?jkZnە@Z@
Q[/EiQ@rݑ^<܈={6^ȲɲxUč5 ɓ-d6ȑ#Fp8,IWIPH̅V+ʨՑz_-Zz= '"!(_F` N?8HIIIIN,OuuuuM
xK Fh"""""" PQ Dcx BbB99V ʨQ=z &,$^oǯV&T: O0x``yfbX,g}1FժT@0JsiɏY4 C!YΝ;wHyLQ'NwDߴOk
̙3gܹ|^/>7Ll%˒
F1;rz8 N:
YM
ב[X #5I:paXl6h \.l[|cc5ihpoTFӉb1 QՈ"$Q E?L j#G )) OO1-Wn#+JAEW%0f̘1g%)fs5Y6 t:N7N'?pajܔiԨ9EfHG̏jZ-߸dYA n ֭ { ~ f) s=w߸q@jMLNn1;裻2Xwܶ́X裻v^8e- CFS= p >xLߪ RJBD(i
D:
&,n7 64FtA
NJL4 oaam X:Fi|jed?6lQ'3333#Cd|"CDq`B 5/ڼXlZ"Jd2f #CLD x|iiii*2b ,\pE@(
Bm_JH\dפ,gT˷ +@ VքZ
&* &SJ
bS$`WW j4b
W[
@L |"(#oFl0 :~đ#{8q {^zi
A[ e ۱XnV 0OU* HN#/HJKJ KXT%p"IM֕ޥ зoAM7=V q{iutџZ-J/F(K#
xI
>,/fMYpｧtRBԩUV>`@Fj25 2#-`OM;Tnj3fԨp
4ZLQVZn|0qy%IM$)1Ӂ n/F˳ YnhؽXϦO>pٲHD
3 z13_vz=?-M_\tQ11"CGk_O+}n x㍇ 2>|ܸn݀/Oܴo7x睝;E1WQ&?Ȑ
ժՀNV20{ԩ<|Z:ҽ;pm/|}aii99@|Zf
v7N֭G Va!pS \y孷 ̙sVlG0 B Я߄ 7 qX.|[̙vؾh
=iHx )I~jkEa""""""9r
p:^Q!rCҍٶm _u C|5[99={@Ϟv{K h*23^QB1|_49ru\L%CDSL5J]62ߍ?nOK* ( rsua ]~᭷fvVX~@(t%vWT ;vtF>5bcEYYf(2P ՒꕒDn\f y} ={B%%@0XZZ^[II}sPUcO}})j4F#paUUKJJ 1"M]T*ыZVKxwOQ2=jZV TVVVVV \͏Xbm_P($"-3$%L4eJϞE{6mժ]N8cNҥhv,~uΜ;dx{ 4hG x`^jhX>|n 0wádt@RR^^Ϟ@߾ߞDQh_^F ̜Z va2 @($u*ᆆ ?_)j0gM&`ZS-r:ESHcZ !!111Q#фM Jdl("cAEBָVd֊e~h
o$Ӹid4DxDZ-v̚7 6ХK~vg ۷۽y3;O=ǀ$^x=/es^_?ӷmzNׯOիSOv۷O фf.ht̉>g͜G_gg_}50n\>Ç\Ы` ߱ xN idzq̙ tS9@BB^^JJ]Ҙ>EauҀ}
R&аƍܹ~gW_ z=5;svڵkN d4 e~z^rs|Gmi~ @ b{ݑ(ju;g
En*VF6RVV!$@,]1tboeY4aEȷzzam8 aQTU5q"և`[,gQnD(B "0TP0!60dM
D9^cb30Pz`Z7.xDl9pxU7hm vJYYYYyMq"G(c2L&ShF(/....)Nhf x E<01h^t#F
@~Nr6FNg8l0 vV+hcV6[MƁ sIl6fVbFQe8t݀t:"ឦLt$jXD7ĢYȧ'vHZEd95'"""""" Js-5|&^ ik$*i-$ZJWOKixU_7a hDuzMyUDF"KB;??o),VҸmz X8дFћ)DDDDDDDt䩹"""""""(ׄ`MȚ&"DDDDDDDDi#?Bp8CDDDDDDD'.Vh"."""""""攸ZfDDDDDDDD-Q&j@$I$ f%."nDDDDD6Jov> v˲Fh{~55uupz
E@狾|eYe9r#Jgމϫӛ(7UUյ#Cl <>00bD||[Fp\ܨQ/~ً/Kj, |@UUUUMMWtWMOLy)SsINhZ_n bWTI/GPV'c>mDDDDDMx|@n.嗿
駗_>yQ`Px3zw}"c!(...nBP(\.㉼Wj
0
#^/шZ,V 뭫۶
5kZ 'I "㯫kh̏fY([,&G7P
54 W_7 *^`hčx<X-/_d2:9Y[~ l+{ N Nخߥh
`Z, tZmekhhhp8Z/kjjk+INnfd ɰE2pޕ۫M }ք'4[G ,e~x͍v`'J\y)̜w_}̙~
} ;N}]` ~5 O?28Ԧ!>;W^3য়_"I,+MA_5.$33> :g >[vjq$n?c}쳁dNN륗OL֬ޚ<8＼<
$Ip
GCC׆dY7XfzQC G~W_\pVD{yMחУ0yΚɀyѣ
f\ 0|Cvd! 7,/'NHcu9 Cv_~ 0cmuh4"`
sU̚5eʠA@BBFyo< xtٗ]_< з~u{mDDDDDt&<~F\p!
n?_,_>om8tq@Zm
:]b"ЧOAJ̟w vw>k|)˙
7<؍7={}&=̙ڵ.W&&PU`> p wc/{n.p&s VSYN>W/ &FAd` z2$5Z\曧L[?x ^h.'M4&
$n@ _'>Zv?y@jկ]wM d X_[n݀ ϫtYI ^ye>}3`Plr8J%ݻ-ۿ ZO9E4m`a ((/.(-]f~;nM{W""""":V4G a09f 0p ax0.Zl٢ [P (ߌjj*+kkᨩjkj: >dZx3s8ڲRqFD< /-V%K>}4b0vo߾r%PR|i@A
&yyfƍAvȑ V ~8kֆ
@II]]u5PX8~[WwI9e MC=>T9thaF=|8p*ʕM@YY}}m-gƍ7~{EFR lPUt J~=0o T}w^k nwbbܼW s[I U hTr_ Zӹu+`AY_ yI paUՐ!I'+WSVU2왜 @]]
`~n92%f; S>80kVyyZ 8 "S@D`p)1 GOUW
+'2AJc$ ~Nw
gv :ݙgëV/o_8 @LZP <̙w l6e:6K Cޭ[ ~ؾˁ/ :49={˖|s`֬=L`lPi{%"""":(qmG5 MsU~/8C1QDPP$iW/ir`uN*^o] Ĥfs8'ZmI$Ix -04&͋F +WKEpc XQѻ7.^@y,qDwb~-1b~PdEˆn 0TVb[t*/3Z%a۷uTb$FT*oɐR"&fnnw^|qҤg~劉 xg.ϱCt߯\)w:]߾ϷhѓOEEvG]/ O?}m tfs2 h?6on]8t6}M7tӹ#F|+VL
TVR|>NX MY D3}{W핈DMxlO>,GwJ 'vӧ6B=z gݷȸh8ujuYٲeʕizCzFh11 @BZZ-%Iñaïwv~,Z|yu5
a5ŋ%KA S]7N7k /-G;G@t:n*UW @)+[X 4n1HN6DBv{L `6m+h2JO=L@cbdU2#zQ *hT6:D/|Co㎁ ~B4먼|R`*3 .t@ >^*(j1- qݻ͓s&N<,IVtPظ.= ?
ZiPq{%"""":QtxSN3&/_ǀv:[j0Rm̜l<Ę1˪U H?حF#~ԩ\{M7M _TO<(־ӹݛ7~e LlΛZUWIvbO?ƛo67?buo}Vj^ȒenF?_ 5> LYxn૯N#@ƫ^|??DN8 \/]
TWÍOׇB{ _|۷<2q V֭3fLp ߈p(quGCDDDDDDDt^x7JD&h4FK\@jZ./""":(qZ ?ʊ
33++;~;} L.`0 7xu7%p44ŀNn ˲ TWWU))ii\nDDDtQ&ڣ݄+Z3u:x.[PΤ8n}oWnS^}ڴ_?r%C
BIl,Ò$2P^@
LVKa ;w 4ǣh4
rџ1ӄ NbD@h2?O<1copE I$I x^}xd2x** jZ# Ng]]] `DnSR܈'.r O 3Mx$ˡPև EN`nh 16X4.j/e /Q4<>F8NP86Cd:77//? GPp\.@FD:(I|9&<8'%%%%%E^ŋ/^|` sBP09P& ?Ӣe ز~xtosҏ?^8J /O Fo $p<Qk$I\)Dm h=* I: h4FDuGkOJ:G}}}}] ՊX/
rE&Jb<${N`ѢHK3sX8. GюG~I b
vyy?v,V ,+-Fjkկ E-2qxt#t;v|X²,> q7g"8ք' hdY t(^o rEVVN]*$UUOr=])GIIjuK'B:lz<xOH y?U?27t:[7`ذ1c$ Ȉg,r"?vv$T'Fw'mkj {
wO)Skjl@^
\|_:jУ1ɺ %Kq^yeN+.!~Q {bY&Pn@ 48Pe%bŏ?^
gy@v$@NN
`L?1ѽ1=PÀYTu+a֭wee S
66#gO`A
]nx'^s]t9@Fp$z;T(Z
:rEmu*sY r}+ÉEjexq BNg]
UU`mme%Y,Vk_џU5yY.TErl4j8" sn0(2Pl6g+OGe{ JJ~ǽ{œpxl_JJ<Je4v
\uwD.Ho駇 #El`.ˋ`4 O/YSxק \z wvpVr] |+<(kWՉ
}M=\}@BV+ˀϷ{9oYʕ> `ϧVz)YƎ.] A~? ?3s&t} `6gg \sͤI] ҴvW'L
W_vw 3L& hΌO?ݞJuhGrx!qh-`_/ -ڻ .馛o.gOPj ?cx@aaaNtxDx\Hأy ̞};uy tVWV7ʕ] !>>7OL={ #ؼ30 + 0Ef̦M\ Y]1Jk]DFbkk ;uVػ!t<O 6v~regv;Я a044 EE˖-X ,_^Rm` u;T`ذ~uKPزeJj=qaN:n7656V~Qohؽ[ f z<=1M/^譿hB;۶ZZKΜ'&$ r%]@Qђ%?|8c""!6(hj4b9J4Dt+)@8QZ~*I@0Ѵ5pwta~UV(-HV+Ы>0yg'$ TRoG _ p l\sSO= pHJ嶞ccI*-]3`;|m1!G1cz+ vjkjs?#ImY.?|} X:PH4婫s[Uаn]ۇX'3@
~Z2 N9N=:\ 1㭷~ ؾo_qRk}: 0v)o!pn7y̙> L; ?Ըq@ZNg}'0mmMIܹ?ܜ~z~fem|ԩ3g#FLңfgm}kTS* nݾ]ѣ {l4 32$ zZu4,ExLfr 8(QE^U`ذ#Ӂo
+22[O>y>JKG<x KJv1ǁ^{%KNz䑑#H<{w;_'3ΈQ.Ajqcǟrhǝ`p۶C^[ZmG8rs }ui&/xYYñdɻS[o/x}[RNg p7m)@mmmm] FAbcAv4Q4]<ں:/((Xn`~``ȱc@`~`ٲ_~Y,``jGG%o_X|Ѣ+
M3Z?ѤwƥK7o #.:l]矁e˖/߷HI=:? 0sr: |q&> PTtI'99VBF#گߙg^8tTGa!o?z5ysvNj5 β2<N>9'fNVˑ@ƍ@]]vƍ i~=Vxzy#F YYKOom;`P/C^x1@v :\B!S;1V'ȤRbXNnM4#Mu$IBB$P"^%I oLH$y"^}>bT%H\X,6͘|َ } =p|<Aԩ ~?q"WP X ⸠Ѵ ҥ-o.ض
矟> زE x{ ZKK2v īsG[XW'7 ZuH-w^8K2ٺu|`z_?`Ȝ ZO:3=C
yCyR|Q lqqСǏ$&VVn ,FKjjj*k4ر P\\^'S['˃\z*{)@Z^߾ ]hbcbƣYzQj4x 쵭%1C%fKJ2$IlڷoB``S: pc EE+W{uiF;s민rP +nXؤ8`hzim[.DG7Ѷv8\JwEgst8͛w@\Az ͦV7}Rp5CFn
Imh'G{>N4ioʑj}QYrl6dds:]? |.my<g{=GuYE8rUW~֧`ksVlN%KD E?N ̴H}\\\\BBw699))!Atcr55v{<"W*tbV#JKqӉ_)I[e;Pz .N4(.vDQԖd9>*_b߾ O1 be-.֯_HO : ^>TR2֬Ԉi4bl0Z hZI^e <|&I~Bz}Z`2"J q$vQ{].Qâv_rrǮ ڷ:WF㟒!zqqH%s_G^E(f +o;8J%߁pXX0&/{nԑ#+֫N?媪|C(Mvq1 v8Dq^woQ:i1ir5*3P:!JܤӚ( r<:5Er: 7o˖@ p%駁nZ_U6ov:
F{7M}Vj\W>ޭpoS@~.믏=z,jô6ndȑ]4dtT0(oaPUviy-Y"9OqڵHz wϝ۶ |iiKJ8
UTvYYJσj[[$|@CW ۱D@@
s)&RG6z= ы 7n"֛@F
"bRv͢'{$qqzE[īxݖ펝+,-nwڴ ؾ㉏SSŭS6667Vi~p:+*ʚ& uu۷ח }|rJ(,)5r 93E֫ze.) 8dQ4f իw \.psޒ
E).֮ݴp8Dӎʝ;7nmS V^C[Vk6ZtՉt $5)tx뭣((n};vDPMhJPS#j44 ),AIjq8äq kӀ;Okc:@wmہ@zzVVR.Ru0`Zb}|9gOM82h+!'gpwoIZ1lE7EEd4=o~ں\Nkc4&0kҥ6D ^S5`{Z(3g¶_+V6-Xg` 9e
Я_JJl8p6>011
\x3f ׂ6 gzn 4km^^~;KŒ w
\s?9a{'cM .jj: `8$QUnR~B dM[ux[ ̟&K(՚5hGF NEE z551 @nc^|10p`.'\Rbd[X(nyKt14j}pu͛5k
k*Mrz &&-{w`Р\_3 XfŊ+9smœ WÇ Vݝ$h=
`e֬/۷D'1Xpժ~^z )_1cQu0 8eouشl^A4yM+64cD{%q`q7P"+Mx u@j* 5w.민lPU%Z 8眛n? ̴Zcbnxk}wڴӁ 7O433s?/w{?I2n{? x7|;g
599> z.]93j5m MJD⋲|^{G~F zO=8~+)i}xd Ynn箺j/`0^ąz8QH^
BV h4BI'*sX8
AQLyb^c-cTLVL?/on2Vmzbny[k1(ˣkϏʊ
33++;E6moOu#GnwzAXDoE ,\ĉ2qb珷5jZq ~OُTJD]x4eWnlo7u{ǯh4Mok %3V<"ǷHE NHQwuuuuE8,/e>nIOzj|>hZ1?ˁn:tҸP BNWFt߬l_jU* Jdzg/}u+5~ر@Aժo)N'#χ^>jZCZa ~=emVMҖ82֯OWy 6ZZnGzEqPb~ںId)4y2z ~]zo2dȐ!C- ?ٶBt4| Nh; O[)@@4 dYTyVk>{ ඊ()m G[E
L@i *-Dh9傽kIhKN4GG;p:ΦdTWWWWV1111v;K 4բi S &("i-˲,nhEk+^[PWnأWZn͇ovl sqoI{籲">:j 0@4 jqG,hWK(g(?X %$r;;?D;pY/Ӧ= 0k֎ NX
`\yw}6"'!:uz/< G& i۶&<
O 5єi |t@@ܸ5 Kt5E./,))99%?زe_q;R%:4?l6"crΦ݄*P_y0)Ĕgy~%:q۷'G^=I7`U2َ^<X,DWH£P.啈:O{!j7"""""""X,g """""""(@!""""""""""""""(@!""""""""""""""(@!"""""""ⰻ1^@ Ye@
>>1110L&+:aP** V f?hP( J ++;;'+:aPdY>L&l4FeIe 1m!"""""""(II@eeEEyy$S%
t:N$%rёs%$;;77//p8 rfbϰȈDszq].(*ڻw x< ~^r:N""""""":tz·t: @UUEEE բV`0 PYY{V%"""""""ht: PYY^^^ʼn$I$E(𥥑 m @ƁH; QK$@\TTFGDDDDDDDttX EiS]]YYQq`'nl11ʫRdViS]-zqBDDDDDDDGGP** nY4qūgd ))iiii^ǣdH`UT"""""""#Ëz --##3^eYb"Ib ?Y"""""""2PL@ PH@22tֿ|ѥK.`($0\aDDDDDDDtuXbZ@n> -&&&&JDDDDDDDt"""""""(@!""""""""""""""(@!""""""""""""""(@!""""""""""""""(@!""""""""""""""(@!""""""""""""""(@!""""""""""""""(@!""""""""""""""(GjB$ITW~h4qq ZV!""""""cH*$IapMHHHW>W'""""""":VtZ E8)++)))t:NVfB@ jZ62}"""""""(Jࣴ($bZm6z= r\{% |"""""""::,""QRRT?hM$0J pn+y E2>eDDDDDDDDGaP&ݻgOb^Nڵ{w@h)WGDDDDDDDt v PT* ZVxnpNKB4 ##+K8t%(QWOEEYYi)W 9 @Qj([W^)Vgeb:]KW,DDDDDDDDGaP%J`t8 @V'-Nyffvvvv+#""""""":R;HSZd jC w*'N' If\qDDDDDDDt v EIbbbccc;~qBDDDDDDDG@!""""""""""""""(@!""""""""""""""(@!""""""""""""""(@!""""""""""""""(@!""""""""""""""(@!""""""""""""""(@!""""""""""""""(@!""""""""""""""(;"˲,ˀv\z< 7+#""""""":R;* ~@RjHMMOOO=YeIKKKKT߽^ vr\h4L@LLlZ
$Ixϕ+3Fp(
%y<^/`Z6h4
PVVRR Ey_VV\\T^2>rd2∈9 JrrJJj*Rj5t:hjvjjd}D@ (.j8QWORRrrJ
W 9 @QZ'.t Hh4ػw] Vo 8QVTM ) P]dgFB\H/:j 11v y| |?#K.]8!""""""CJS윜HMi E{sexN M(\@tHP_/ݑϕ8!""""""cE(@H.9999Ɏx^}| kGjBJM, =
""""""c s=` (
P` (
P` (
P` (
P` (
P` (
P` (
P` (
mGx< Pjfj> v@$Id2f8""""""":r:, zXV(//++-Nheeeejl`4 i @e)dT II@U4( YeYBP( H&O{vv8 ٳ|9Ӧ.0uԥ {nnwJe2< .>oo ܺPz嗏?23o`0۲
P\{t:] HR nm+W\r^G
ʖ/֮
ov:0̜ӦsnZQx<=z\wݳ?Ҥ''owqmqyy& /_,^\]\z de*regӳ.X z<o |=BeeO?= w \Vp ju||Ap9^;q"p
SuII< w
Jԗ_> _y%K^۶;r| xs < 덼W֬^zբVɀ&JJ6fL^EFJGP4!Cn
ݻ/o_}=""
г
7LO<̚yemh1.f {0i-,f͛/9;;XJ
.תUOy7 =SOcl*`0 `tڷgۈ>ZXXZ*E 7͇ Zm iƍKYY^P L٧
TV\v@vĉ/ h4fsĹ = ؿڴI %1l =x]()Ylɒ7 <vm[#b|KۑHM
;v20jC2pyii|:]Bx۷ |⋟
~>`b"{__o֢E@^>zYaÌ٫p]S@AV[_TWqqF$ݺ'C#Jp* ^y妛v@.+g~> b~={逳~8Dغ_|xwg:| -[`r.jMƧ .9kW 11 w`PHPтF#Х˘1w u2dH.77`@VFt;vl\_yfNH|w6O:k= Y""zaÀ-[@(
|~? zhMO]*Vk2@ zthqq@^w%$zsΕWc-.`5b]_jn]uu(Ȳdzw/vmEEb"p={4= l LDDD%DP2MW%p @]]]]] PRRRRRPQ^&=JFi h8p] z{*oɗ^
pÐ!qqC<+.<89 |^[Vd $y;a_^oa%@e7^
dd\u 2u^0XVjbխ0bD=밣đޘAFEݾ x晛nZa 3$l{袏>>aÀ+kFh[/Y >wY/߽Djh1|x[ƧV11(G7W h4 *zP"ˡ+Rzd$ iiv; ,[&H qq}gݭ' |bEy9pYVY^ "
z 5*+hd xҼҋ^X x< GƣHPHȲ l?_͛]oGk}nV TT^btvz@ KN[wYGzclxj 1ޗ^0#0&8Ͽvg9oVgxw E l$
Ul@}ʕ|-w' v?s}7iͼNb+-ze9 ;j&5͍=Sm0XW֊eh Je ߷/?>tiE zw
JRcH炂 VA!"":^|"aX, `2Lɭ(W J DHQ(%äVj|t:Ύ
J7 ^}u͚]n{.N:藇jT`zkj Ͻu>}n ׯN?}ԨĎiZV&SLL\ 'B9qqa\pYO?-Yo C))GJ}pZ<˻iӀ;z[kw`HJgPhvf|7zIۻvv<#?~um{UVhhM {hȮZݖu_xa GzCsrF ˁ?5kj`:ؽ[tP(,,-u8 _- --++1QqrpdJJR`
jjKJ{+*^@ēLB@A lm *5u`ذݻ3z|v`/X 5
֭S__U%RYkk5kzt` W/{#OfsAy#FT|
0x7NTht]mMp#""?O8n&JTȫˎr4LOO@wf͚5.l"4@07nrhBKwߝ:w%KDjZ_vma!PRR]][ TVݻz53gnHR~~߾@jU*W/L`{7iqW]
TV@{,~p Q_TT۷q.3(.6ss\7Z _ `߾bSE{P6dX] ~7Pd*+ݵ 6lXIJJK,| |_߉{w] ,_^_ ٳv~u#^2{ˀygtࡇf)F*
tz< <֥7|fW^ zh e@\\f;xCju8s{n$_5HK+(84` 2gσ'TfsA0~V+ko5cpiO=u-}PtfQf{رGn(+[n )IΪōrf) ݺ=onצ:C306mz.' Nٚ/!Iζ?vլY_|'kԩ^pO;thg9#""">Ï>ƌ3f̘HӛhΝ;w\ & vNMuuϛ
v@.'> X,謫? G ֯ ?G 9㌸Ws9sf>
(tG4~a IDAT ~۲{q&L k`NHo;`Æ
6n~ &:JbRD
BP$EyUr\.x)+c -HnOG^X jj֯,7Wcf1뮻pX4X,9 RDMGPQ4Q4eGG 8 [oM@DDM1)zꩧ??Ԉ$:s1BDDDDDŽo?n-JDDt,a """""""(@!""""""""""""""(@!""""""""""""""(@!"""""""ϟ?g\ DDDDDDDD?! ^ IENDB` lottanzb-0.6/help/mallard/es/figures/lottanzb-logo.png 0000644 0001750 0001750 00000003404 11525760436 023014 0 ustar lantash lantash PNG
IHDR szz sBIT|d pHYs
B(x tEXtSoftware www.inkscape.org< tEXtTitle Contact NewdK? tEXtAuthor Lapo Calamandreiߑ* AIDATX]h\sܻ+v%b+I-JRj Oxྸ 6)!mi J1
~0zKM Y4&$Vr*KV+םi7Ziar`̜9?sG|&PR?g<3߶)L"K )%aP6WZF1UÑ#Gv ;v c Ǐ ĉ>} 0xL&C< }._L< ͛cbddFGGK_*\[8|p^(B&''y!J)ƈb377իWIRcHӬM8gY֥=kC100PvEz{{ By9x oߦV֜?
[ P G Ν;ekW\
cسgccc߿wގ֚nΜ9W 7ٳ:u
c Xh4J[[b1fff8w ׯ_cB=gd2/imm%HN-ZLI)ijj"
1??RjÙ֖ 244D2IJ,\q AJI 2Kuu5BۈFʘ}Bl Bd2TJm8 RayxC**c`)%UdBJI$ !x15EM]3m۶3Uo,"
?zq-(ζmY"Q
^
˲, kr\ s[oT hF18Y@GK M fn3h/ĀmeK)y]
+1Ek]Erid2 5>" hzZi|@/1mۥoO)oPk J}PJ3??_^ ! */2 B+Lk
Tsݻw訴X5`YVY͋^ҌzѣGRd2\u]~U:bg97o̦EGJ'sx k^)xPjzzػwoɓ'ihh8miXMyJ!9ov$[xeEr4pAk.۷,+noNruӀ-<{ )>y +6SZ;ǟ&<=C[x.ڻrD @"G˹w'-ш%B(
KE _\I Xq/ /9 G+ qD\J=_J}{w `O*K|:$fVd|:${^ iAUn. t/]CcQ !Fy { M
5o/߸qi9ɤ
Controlar y limitar la velocidad de la descarga
Severin Heiniger
severinheiniger@gmail.com
2010
Equipo de desarrollo LottaNZB
Creative Commons Attribution-Share Alike 3.0
Velocidad de la descarga
La velocidad a la que se descargan los archivos del Usenet se muestra en la esquina inferior derecha de la ventana principal, en el interior de la barra de información .
Limitando la velocidad de la descarga
Por defecto, LottaNZB descargará tan rápido como su conexión a Internet y el servidor de noticias lo permitan. Para prevenir que las descargas interfieran con otras actividades en Internet, puede limitar la velocidad de descarga. Existen dos maneras de hacerlo:
-
En la barra de información , presione sobre el icono cercano a la velocidad de descarga. Esto abrirá el menú habilitándole seleccionar una de las velocidades de descarga predefinidas o eliminando el limite actual.
-
Si desea una velocidad de descarga personalizada, seleccione editar preferencias limitar velocidad de descarga y especifique la velocidad deseada en KiB/s.
En ambos casos, los cambios tomarán efecto inmediatamente.
lottanzb-0.6/help/mallard/es/introduction.page 0000644 0001750 0001750 00000002565 11525760436 021435 0 ustar lantash lantash
1
Una breve introducción a LottaNZB
Severin Heiniger
severinheiniger@gmail.com
2010
Equipo de desarrollo LottaNZB
Creative Commons Attribution-Share Alike 3.0
Introducción
LottaNZB es una aplicación que le permite descargar archivos del Usenet.
El Usenet es un sistema mundial de distribución de debate en Internet que ha existido mucho antes de que los sitios web aparecieran por primera vez. Al lado de mensajes de texto normales, los usuarios también pueden publicar archivos como fotos y videos, que comúnmente se divide en varios mensajes.
Para simplificar la descarga de dichos archivos, el formato del archivo NZB fue inventado. Estos archivos NZB son creadas por los motores de búsqueda y proporcionar LottaNZB con información sobre qué ficheros van a ser descargados del Usenet.
lottanzb-0.6/help/mallard/es/index.page 0000644 0001750 0001750 00000002262 11525760436 020015 0 ustar lantash lantash
<app>LottaNZB</app> Usenet Downloader
<app>LottaNZB</app> Usenet Downloader
Severin Heiniger
severinheiniger@gmail.com
2010
Equipo de desarrollo LottaNZB
Creative Commons Attribution-Share Alike 3.0
<media type="image" mime="image/png" src="figures/lottanzb-logo.png">
<app>LottaNZB</app> Logo</media> <app>LottaNZB</app> Usenet Downloader
lottanzb-0.6/help/mallard/es/setting-up.page 0000644 0001750 0001750 00000005702 11525760436 021007 0 ustar lantash lantash
Tome los pasos requeridos para comenzar a descargar
Severin Heiniger
severinheiniger@gmail.com
2010
Equipo de desarrollo LottaNZB
Creative Commons Attribution-Share Alike 3.0
Configurando <app>LottaNZB</app>
Prerequisitos
Lo que usted necesita para empezar usar LottaNZB es:
-
Una cuenda de servidor de noticias , que le de acceso al Usenet. Hay numerosos servidores de noticias con diferentes precios y con una retención diferente. Una retención de 500 días significa que un archivo se borrará de ese servidor después de 500 días que se ha cargado.
-
Un Motor de búsqueda de Usenet que le permite buscar archivos en el Usenet y descargar los archivos NZB correspondientes.
Primer comienzo
Al iniciar la aplicación por primera vez, le preguntará si desea descargar a su computadora o
-
Para descargar los archivos de Usenet, LottaNZB depende de una aplicación llamada SABnzbd . Si este software no se encontrar en la computadora, se le pedirá que lo instale. Por favor, siga las instrucciones para saber como hacerlo.
-
Después, usted necesita entrar los detalles de su cuenta de servidor de noticias.
Por lo general, la página web del servidor de noticias contiene la dirección y número de puerto que se entrará. Dependido en el servidor de noticias, puede ser posible cifrar los datos descargados a su computadora usando SSL. Active la casilla correspondiente si este es el caso.
En la mayoría de los casos, un nombre de usuario y una contraseña debe ser ingresado. Algunos servidores de noticias gratuitos permiten el acceso anónimo y no requiere un nombre de usuario y una contraseña.
Al hacer clic en Aceptar aparecerá la ventana principal, donde usted puede añadir su
Ventana principal de LottaNZB
lottanzb-0.6/help/mallard/es/observed-nzb-folder.page 0000644 0001750 0001750 00000002504 11525760436 022556 0 ustar lantash lantash
Añadir automáticamente los archivos NZB encuentrados en una carpeta
Severin Heiniger
severinheiniger@gmail.com
2010
Equipo de desarrollo LottaNZB
Creative Commons Attribution-Share Alike 3.0
Carpeta observada
LottaNZB puede
Usted puede elegir esta carpeta después de seleccionar Editar Preferencias Añadir automáticamente los archivos NZB de en la ficha General .
De forma predeterminada, la carpeta que los navegadores web usan para descargar los archivos serán seleccionados.
lottanzb-0.6/help/mallard/es/prefs-general-tab.page 0000644 0001750 0001750 00000002014 11525760436 022177 0 ustar lantash lantash
Personalizar el proceso de descarga
Severin Heiniger
severinheiniger@gmail.com
2010
Cliente LottaNZB Equipo de desarrollo
Creative Commons Attribution-Share Alike 3.0
Preferencias generales
La etiqueta General le permite controlar como se descarguen los archivos del Usenet y lo que pasará con ellos después que han sido descargados.
lottanzb-0.6/help/mallard/es/post-processing.page 0000644 0001750 0001750 00000006142 11525760436 022046 0 ustar lantash lantash
Las acciones realizadas después que todos los archivos han sido descargados
Severin Heiniger
severinheiniger@gmail.com
2010
Equipo de desarrollo LottaNZB
Creative Commons Attribution-Share Alike 3.0
Post-proceso
Después que los archivos que pertenecen a un archivo NZB han sido descargados, LottaNZB llevará a cabo otros pasos, que se llama post-procesamiento . Post-procesamiento típicamente incluye la reparación y extracción de los archivos descargados. Le permite acceder al contenido descargado sin hacer ningún trabajo adicional.
Durante el post-procesamiento, la barra de progreso se quedará en 100%. Sin embargo, debajo del nombre de la descarga, LottaNZB indica qué operación se lleva a cabo, así como su progreso, por ejemplo, "Reparando... (42%)" .
El post-proceso requiere que la computadora haga trabajo duro, lo que puede hacer que se tome un poco más de tiempo para responder a su entrada. LottaNZB trata de minimizar estos efectos.
Personalizar el post-proceso
Después de seleccionar Editar Preferencias Después de Descargar para a elegir cuál de las siguientes acciones se llevarán a cabo durante el post-proceso. Sólo es posible realizar una acción si todas las acciones se han realizado.
-
Reparar
Revisar los archivos descargados por errores y si los hay, tratar de corregirlos. Para que dicha reparación a funcione, la descarga debe incluir la recuperación de archivos PAR , que se descargará si es necesario. Este es el caso de muchos archivos NZB encontrados en los motores de búsqueda Usenet.
-
Extracción
Extraer el contenido de las descargas comprimidas. Los archivos de gran tamaño en el Usenet suelen ser comprimido y dividido en múltiples archivos RAR con el fin de ahorrar espacio.
-
Cancelación
Elimine los archivos descargados después que su contenido ha sido extraído. Si la extracción ha tenido éxito, por lo general no hay ninguna necesidad de tener los archivos RAR.
Por defecto, todas las acciones antes mencionadas se llevan a cabo. Incluso es posible evitar cualquiera de las acciones que tengan lugar mediante la selección de no hacer nada
lottanzb-0.6/help/mallard/es/prefs.page 0000644 0001750 0001750 00000002541 11525760436 020025 0 ustar lantash lantash
Configure el comportamiento de la aplicación
Severin Heiniger
severinheiniger@gmail.com
2010
Equipo de desarrollo LottaNZB
Creative Commons Attribution-Share Alike 3.0
Preferencias de <app>LottaNZB</app>
Después que LottaNZB se ha configurado, es decir, para administrar las descargas de Preferencias . Usted puede abrirlo seleccionando Editar Preferencias
SABnzbd , la aplicación sobre la cual se construye LottaNZB , ofrece muchas opciones avanzadas. Usted puede revisar y cambiarlos Config .
lottanzb-0.6/help/mallard/es/remote-access.page 0000644 0001750 0001750 00000006034 11525760436 021441 0 ustar lantash lantash
Maneje las descargas de otra computadora
Severin Heiniger
severinheiniger@gmail.com
2010
Equipo de desarrollo LottaNZB
Creative Commons Attribution-Share Alike 3.0
Acceso remoto
Es posible gestionar las descargas de otra computador en la misma forma que las descargas de la misma computadora. Hay muchas situaciones donde esto es útil:
-
La computadora de la casa esta descargando y desea manejar la descarga con su computadora portátil mientras está ausente.
-
Usted quiere permitir que otra gente en la red local
-
La otra computadora es realmente un dispositivo sin pantalla, como un Network-Attached Storage (NAS) .
De forma predeterminada, no es posible administrar las descargas de su equipo desde otra computadora por su privacidad.
Empezando
Siga los siguientes pasos para iniciar de forma segura el acceso remoto.
-
En la computadora donde las descargas tenienen lugar, permita el acceso remoto mediante la selección de Editar Preferencias acceso remoto y activar la casilla de verificación Permitir el acceso desde otras computadoras . Se recomienda proteger el acceso remoto mediante la activación de Requerir autenticación e introduzca un nombre de usuario y una contraseña.
Confirme los cambios al cerrar la ventana.
-
En la computadora que quiere manejar las descargas:
-
Si LottaNZB se inicia por primera vez, seleccione Administrar las descargas de otra computadora en el diálogo empieze a descargar .
-
Si ya ha estado usando LottaNZB , seleccione Archivo Manejar otra computadora...
Introduzca el nombre o la dirección IP de la computadora cuya descargas desea administrar. Cuando se le pregune, también entre el nombre de usuario y contraseña que usted proporcionó. Haga clic en Aceptar para empezar a manejar las descargas.
lottanzb-0.6/help/mallard/es/news-servers.page 0000644 0001750 0001750 00000003775 11525760436 021363 0 ustar lantash lantash
Añadir, editar y borrar servidores de noticias
Severin Heiniger
severinheiniger@gmail.com
2010
Equipo de desarrollo LottaNZB
Creative Commons Attribution-Share Alike 3.0
Servidores de noticias
Con el fin de agregar, editar o eliminar servidores de noticias, seleccione Editar Preferencias Servidores .
Agregando y corrigiendo servidores
Puede editar la información del servidor seleccionándolo y haciendo clic en Editar . Con el fin de añadir un nuevo servidor, haga clic en Añadir . En ambos casos, un cuadro de diálogo se abrira que le permite especificar la información sobre el servidor. Los cambios no tendrán efecto hasta que haga clic en
Por lo general, la página web del servidor de noticias contiene la dirección y número de puerto que se entrará. Dependido en el servidor de noticias, puede ser posible cifrar los datos descargados a su computadora usando SSL. Active la casilla correspondiente si este es el caso.
En la mayoría de los casos, un nombre de usuario y una contraseña debe ser ingresado. Algunos servidores de noticias gratuitos permiten el acceso anónimo y no requiere un nombre de usuario y una contraseña.
Borrando servidores
Puede eliminar un servidor seleccionando y haciendo clic en Eliminar . Tenga en cuenta que esto no se puede deshacer.
lottanzb-0.6/help/mallard/es/incomplete-downloads.page 0000644 0001750 0001750 00000005757 11525760436 023051 0 ustar lantash lantash
Descargas que aún están en espera de ser completado
Severin Heiniger
severinheiniger@gmail.com
2010
Equipo de desarrollo LottaNZB
Creative Commons Attribution-Share Alike 3.0
Descargas incompletas
En el caso de la descarga activa, el tiempo restante se muestra debajo del nombre de la descarga.
Pausando Descargas
Activando Pusar todos en la barra de herramientas o Archivo Pausar todos
Sin embargo, también es posible para evitar una descarga individual se llevara a cabo haciendo clic derecho sobre él y activar la casilla de verificación Pausa . En la lista de descargas, descargas en pausa se muestran en gris. Más tarde, puede reanudar una descarga desactivando Pausa otra vez.
Cambiar el nombre de las descargas
Cuando un archivo NZB es Propiedades y cambiar el derecho de campo a Nombre . Los cambios toman efecto inmediatamente.
Ya no se puede cambiar el nombre utilizando LottaNZB después de que todos sus archivos se han descargado y el
Eliminando descargas
Cualquier descarga se puede ser cancelada haciendo clic en Eliminar en la barra de herramientas o presionando Delete . Esto no se puede deshacer y cualquier avance se perderá.
Reordenando la lista de descargas
Las descargas se realiza una tras otra, mientras que la descarga en la parte inferior de la lista de descarga se realizará al final. Puede re-ordenar la lista de descargas incompletas mediante la selección de una descarga y arrastrándolo hasta el lugar deseado. Por otra parte, una descarga seleccionada puede ser movida con las teclas de flecha en el panel de re-ordenamiento de la izquierda. Al hacer clic en el botón superior inmediatamente se iniciará la descarga.
lottanzb-0.6/help/mallard/es/web-interface.page 0000644 0001750 0001750 00000005110 11525760436 021414 0 ustar lantash lantash
Maneje las descargas utilizando un navegador de Internet
Severin Heiniger
severinheiniger@gmail.com
2010
Equipo de desarrollo LottaNZB
Creative Commons Attribution-Share Alike 3.0
Interfaz Web
Usted puede administrar sus descargas utilizando un navegador en lugar de LottaNZB . Esta característica la provee SABnzbd , la aplicación con la cual LottaNZB está construido. Esta interfaz Web es potencialmente útil en situaciones como:
-
Si desea utilizar una función avanzada que ofrece la interfaz web que todavía no está disponible en LottaNZB . Además, esto le permite personalizar el proceso de la descarga con mayores detalles.
-
Si usted desea administrar las descargas de forma remota usando un dispositivo que no ejecuta LottaNZB , como una computadora que corra otro sistema operativo que no sea Linux o un smartphone.
La información sobre cómo utilizar la interfaz web se puede encontrar en el
Abriendo la Interfaz Web
Usted puede abrir la interfaz web seleccionando Archivo Abrir Interfaz Web
Alternativamente, también puede introducir directamente la dirección URL de la interfaz web en su navegador. Al descargar en la misma computadora, esa URL es localhost con el nombre o la dirección IP de esa computadora.
La interfaz web de otra computadora sólo se puede abrir si
Si proporcionó un nombre de usuario y una contraseña al permitir el acceso remoto, se le pedirá entrarlos.
Al utilizar la interfaz web con frecuencia, es posible que desee crear un marcador en el navegador web, dándole un acceso rápido a ella.
lottanzb-0.6/help/mallard/es/searching-download-list.page 0000644 0001750 0001750 00000002231 11525760436 023423 0 ustar lantash lantash
Busque descargas dentro de la lista de descargas
Severin Heiniger
severinheiniger@gmail.com
2010
Equipo de desarrollo LottaNZB
Creative Commons Attribution-Share Alike 3.0
Buscando en la lista de descargas
Cuando la lista de descarga contiene muchas descargas
Usted puede buscar la lista de descargas con sólo comenzar a teclear una parte del nombre de la descarga que ha usted le interese. La primera descarga que contiene su entrada es seleccionada inmediatamente.
Cuando la lista de descargas se alarga, también puede
lottanzb-0.6/help/mallard/es/license.page 0000644 0001750 0001750 00000002711 11525760436 020327 0 ustar lantash lantash
Información legal
Licencia
Esta obra se distribuye bajo una Creative Commons Reconocimiento-Compartir bajo la misma licencia 3.0 Unported.
Usted es libre de:
-
<em>Compartir</em>
Para copiar, distribuir y transmitir la obra.
-
<em>Para remezclar</em>
Para adaptar el trabajo.
Bajo las siguientes condiciones:
-
<em>Atribución</em>
Debe reconocer los créditos de la obra de la manera especificada por el autor o el licenciador (pero no de una manera que sugiera que tiene su apoyo o apoyan el uso que hace de su obra).
-
<em>Compartir Igual</em>
Si transforma o modifica esta obra para crear una obra derivada, sólo puede distribuir la obra resultante bajo la misma licencia, una de similar o una de compatible.
Para el texto completo de la licencia, consulte la
lottanzb-0.6/help/mallard/es/completed-downloads.page 0000644 0001750 0001750 00000002741 11525760436 022654 0 ustar lantash lantash
Descargas que no requieren mas pasos
Severin Heiniger
severinheiniger@gmail.com
2010
Equipo de desarrollo LottaNZB
Creative Commons Attribution-Share Alike 3.0
Descargas completadas
Los archivos descargos con éxito se encontran dentro de la
En el caso de una descarga sin éxito, un mensaje aparecerá debajo de su nombre indica lo que salió mal.
Borrando descargas completadas
Con el tiempo, la lista de descarga completadas puede alargarse mucho. Al hacer clic en Limpiar Completado o seleccionar Archivo Limpiar Completado
lottanzb-0.6/help/mallard/es/reporting-problems.page 0000644 0001750 0001750 00000001676 11525760436 022550 0 ustar lantash lantash
Póngase en contacto con los desarrolladores cuando se producen problemas
Severin Heiniger
severinheiniger@gmail.com
2010
Equipo de desarrollo LottaNZB
Creative Commons Attribution-Share Alike 3.0
Informe de los Problemas
LottaNZB no es perfecto. Si encuentra problemas de ningún tipo en la aplicación o en esta documentación, el equipo de desarrollo LottaNZB lo agradecería si
lottanzb-0.6/help/mallard/es/adding-downloads.page 0000644 0001750 0001750 00000006026 11525760436 022126 0 ustar lantash lantash
1
Añadir nuevas descargas a la lista de descargas
Severin Heiniger
severinheiniger@gmail.com
2010
Equipo de desarrollo LottaNZB
Creative Commons Attribution-Share Alike 3.0
Añadiendo descargas
Usted puede agregar una descarga a LottaNZB consiguiendo un archivo NZB (por lo general de un motor de búsqueda de Usenet) y abrirlo con LottaNZB , que descargará todos los archivos de Usenet que se encuentran en el archivo NZB.
Hay muchas maneras de agregar un archivo NZB.
-
Selección manual
Elija uno o más archivos NZB localizados en el disco duro después de hacer clic en Añadir en la barra de herramientas o seleccionando Archivo Añadir archivo...
-
Arrastrar y soltar
Arrastre uno o más archivos NZB y suéltelos en la ventana principal de LottaNZB .
-
Asociación de archivos
Haga clic en un archivo NZB en su gestor de archivos. Los archivos NZB se abren con LottaNZB .
-
Descargue desde un localizador uniforme de recursos (URL)
Introduzca la dirección URL de un archivo NZB en el diálogo abierto por la selección de Archivo Añadir URL... LottaNZB descargue el archivo NZB.
-
<link xref="observed-nzb-folder">Automáticamente desde la carpeta observada</link>
Los nuevos archivos NZB encontrados en esta carpeta se añadirá automáticamente.
Motores de búsqueda Usenet suelen indicar hace cuántos días los archivos que aparecen en un archivo de NZB se han incorporado al Usenet. Por favor, asegúrese de que el tiempo de retención de su servidor de noticias es más largo, de lo contrario LottaNZB no será capaz de completar la descarga porque los archivos ya ha sido borrado de su servidor de noticias.
Descargas recién añadidas apareceran en la parte inferior de la lista de descargas después de unos segundos, lo que significa que cualquier descarga agregado previamente se completará hasta que la primera nueva descarga se llevará a cabo. Aprenda a LottaNZB .
lottanzb-0.6/help/mallard/C/ 0000755 0001750 0001750 00000000000 11525760442 015616 5 ustar lantash lantash lottanzb-0.6/help/mallard/C/customizing-interface.page 0000644 0001750 0001750 00000003273 11525760436 022775 0 ustar lantash lantash
Adapt the user interface to your liking
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB Development Team
Creative Commons Attribution-Share Alike 3.0
Customizing the Interface
Beside the download list, the main window also contains
the following elements, none of which are essential for
-
Toolbar
Provides access to frequently used features. It's possible
to use the File menu or
-
Infobar
Contains statistical information such as the download speed and the
amount of time left.
-
Reordering Pane
Makes it possible to
You may choose to hide each one of them indidually by deactivating the
corresponding check-box in the View menu, giving the
download list more room.
lottanzb-0.6/help/mallard/C/multiple-news-servers.page 0000644 0001750 0001750 00000004100 11525760436 022746 0 ustar lantash lantash
Use more than one news server at a time
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB Development Team
Creative Commons Attribution-Share Alike 3.0
Multiple News Servers
Only one news server account is required to start downloading from the
Usenet, but there are reasons to use more than one server.
Consider the following situation:
-
You already use a free, but unreliable news server.
Because some files cannot be found on that news
server, especially old ones, you choose to create an account at a news
server that charges by the amount of downloaded data.
In order to save money, you would like to download from that news server
only if a file cannot be found on the free news server.
The following features are available when more than one news server has been
defined.
Enabling and Disabling Servers
You can disable a news server by deactivating the check-box on the
left of the server entry. This causes LottaNZB to stop
downloading from that server. You can later enable the news server again
by activating the check-box.
Backup Servers
A backup server is a news server that is only used to download
files that could not be downloaded from any other news server.
A server can be marked as a backup server when
Advanced Settings and activate the check-box
Use as backup server .
lottanzb-0.6/help/mallard/C/managing-downloads.page 0000644 0001750 0001750 00000002704 11525760436 022233 0 ustar lantash lantash
2
Understand and manipulate the download list
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB Development Team
Creative Commons Attribution-Share Alike 3.0
Managing Downloads
The main window contains the list of downloads. Each download is represented
by its name, its size as well as the download progress in the form of a progress
bar. Depending on the status of the download, additional information is
included.
Activating Pause All in the toolbar or
File Pause All will
prevent any further downloading from taking place, until it's deactivated
again.
In the download list,
lottanzb-0.6/help/mallard/C/keyboard-shortcuts.page 0000644 0001750 0001750 00000002657 11525760436 022325 0 ustar lantash lantash
Control the application using the keyboard
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB Development Team
Creative Commons Attribution-Share Alike 3.0
Keyboard Shortcuts
Much of LottaNZB 's functionality can be accessed using keyboard
shortcuts. When pressing Alt , one character is
underlined in most menu items and pressing it causes that menu item to be
selected. Additional keybord shortcuts for frequently-used features include:
-
<keyseq><key>Ctrl</key><key>D</key></keyseq>
-
<keyseq><key>Ctrl</key><key>P</key></keyseq>
Pause or resume all active downloads.
-
<keyseq><key>Ctrl</key><key>Q</key></keyseq>
Quit the application.
-
<key>F1</key>
Open the documentation.
lottanzb-0.6/help/mallard/C/download-folder.page 0000644 0001750 0001750 00000004514 11525760436 021543 0 ustar lantash lantash
Choose where to put completed downloads
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB Development Team
Creative Commons Attribution-Share Alike 3.0
Download Folder
All successfully completed downloads are moved to the download
folder . Unless you're
Downloads in the toolbar or selecting
File Open Download Folder
.
By default, LottaNZB uses same folder that other applications
like web browsers use for downloads. It's usually called
Downloads and is located within your home folder.
Checking the Remaining Free Disk Space in the Download Folder
In the bottom-right corner of the main window, inside of the
Infobar , LottaNZB displays the amount of
free disk space that is left in the download folder. The value turns red if
there is not enough free disk space for all
Please make sure that there's always enough free disk space.
When running out of disk space, LottaNZB will pause the downloads
until you free up some space.
Changing the Location of the Download Folder
If you want to download to a different folder, select
Edit Preferences
and choose the desired folder using the button to the right of
Download folder . The change will take effect
immediately, but already completed downloads will not be moved to the new
download folder.
lottanzb-0.6/help/mallard/C/figures/ 0000755 0001750 0001750 00000000000 11525760442 017262 5 ustar lantash lantash lottanzb-0.6/help/mallard/C/figures/lottanzb-main-window.png 0000644 0001750 0001750 00000075032 11525760436 024066 0 ustar lantash lantash PNG
IHDR ( bKGD X pHYs ~ yIDATxw?~A.XcK$|Fl15]bRTIH/\{=;;@y= \vvfvvvgA;u֙g """""""5ky4xӵ9A$?????~=۷o߾ Ĥ$nH""""""":q45559) v{B7< )(D"p8 NgS%(
i4"QUUmNQ[>~ZdfۖrEUwtz=h&h27@Yyb6LK-H nv %?h {-/$e "v}WmWmw F $$"V=GDDDDDDt" A _J49'28q\.y*pE=zdgC&'IIv;pX,@uN,_^^|mbJV99@jjjjZ4666:@}}}}] P^^^^Q{wiAײS\nݺu+.nEI8NgSsΝ;wNpʀP( pHLLLAV =W"~tx< c㏏ ݻ7p GLV_逊
;L?f
bZ1G
$%h4([EQHD^/hۆ~<@2yl6M&N;m 3333##ڻ>uuuu
.Z|b}t:N (DDDDDDDFH DP1~"Bd~ܸ=EUa@QB! k4?@Y l6
83Θ0zCpX6ANkM~de'DgϞ=gN,hY)r}dp"h4 '>H8(Yf͞
@ qb̦[(Vk6 [#v@4j0@rݮ5?jt F 11)bX(r O46[r͑7)I|&|Ftl60;P(FQ(Bg**%@ d ӦSXdft"8 }#_Ng6l@EE0 7ܰ`3U&Lp"HZm>X`0:^͛2wc 2#G)vw.UUpxA |n wkj5 mF x,`Ԩ ~I
**{`Ѣ^xn**j{ ߿s'p> PUmʕ_ """"""ID4E4
9R]G^{nNdd MM
kjpaO4nvŚDdel))9Z7TT4l듗+*>fQ!"k L eg-;mٗ >,jrst痝" y͟D"H$ADr֧bۭ&eS/U5
_ P4* 0-05:,LkL
b]cc8Ӊ6]CC$b4 "H |@ DQ$V mƌn[vng.T
U"ہի7m
I>@FFϞ]by`yye%h46%E֯_FtJJz5
{I~ؽ[,+~iZѕ0GF]"/G0Hs:EDBՁ pCAA^ k*}ϧ(!"""""~J H|
X"뗑o7j_}5>pEEw{<3bпV(S_ NhVU5V
BQl}քQtFcNfl6ImkMpX_,P(
2ik}ZoZOGP\5h$ {
M^M7WFP^eVۭ[tӝwZ[{/~&`ɒ-[\.//AU U5^
ذamۀh4-wo`РQo֮}+enltupY6:ro 0FUB!IFRRj/y赬kIK<kIOĮ]a
kĻGbW% N@iNUD@ 845UU={:
ү ;_\q}jm-8D`6;#O $F?O˖ k >|C JL&9āۧyӟmu{4iʔY9'1bĻ&M:sf)Sέ^""""""7۷\B4c۶9 3?&~yegk4vY
<ܦM^/iScc p|d0s
ا X穲E6y@D[Mp:Φy:p}"HD$% F`0b?zkj$3+ 0D'fsnnq1. _T
f3F4]:mkP( jsι* zNH JK׀ zӁ+5={>omޥQ&N 9HL_̙]*/D^9" ؾ=j$%NgU QLUȀ`º:Ebj$%{G"@8\QQU wyСT[}|: ̛W[Z jkE#KF#FqjZE7 ]e' oz^jjjjjj.GVzK.]?DD!*PZOX:Cz<л7.Qf^~ys%K<>}#Ə'tٷu Yv \:oȐRijZ x?ܵӭ^
̞rɊHOڵwoDۓ&G wfxˁ#s@4̑ G_vpޫץN <&30}766$;{Hb v8rr~zS8ڵHD4]291py st: /O (3(-"Y65ŲSTI~($XUn?M)b)*
@jjZZZ`h>xNt(5PDłBk *]De\ y1o}"tcJJbN=VV4DDV+ʚں7 ХKqqc[Hݰx ~}@Q(Doݺ3?ܶm`z߇Sv횙nzNNnmΡ8 _QNawOLJJ I$45ݻn 0{_?'F#593 ;VU= Ƞ!+K
ɩ O)#-Z^o6.vʔ 㾴U"`0+CZ
"8Q|ܹs DV6 >Fh4]vZT$';6ok#5oĂ @4صk]b}ǵ_=@,7sCjz0XbESKt_UE`P4=KOF(*Mg0 @4*:UFq"1d4-_f\D$ F"b 0L& breeeeDVKcYBDDDDDDt;22htѣ֦&`x C ;5;a ?KL/ +2Z. |\Q p8 l DN';xnpn;6],ٿ/+]:u9p}n0bYɧ'
B!xXRl;?N """""" ֚ io`oyrr9mUī@iy7 rim ֆ_y'DDDDDDD'^#
Dwy-vшYj[H9Ҽ#]揷=;mmDDDDDDD><@9^4#حOkA
}Zn"""""""cBDDDDDDDb""""""""v`NdVba'DDDDDDDD-c?D"h4
CDDDDDDD'.^bhn"""""""dnj9<.Qkdnh
UUUU"HyS"`)(Jl;tS"""""'scք' A`Z32CU9:âU( %y+_x~NDMx@ jkkkzVȑO?O?
YY
h S<- '$6nxWU-N x୷ x 8̌ FǍ;p;z^44\> :HۯW?uuuu
ǨQM>pp8 D
W'41w 1lnkݻW__Kl>tڴ5kbQŰK
~?P[Z;%55%%)maNjQڲػ?@O_Uu~n1wvpijjjrBRSSRbq:N 0M&HLLHp8b>>驩/\P(>_ DbXtz^Vb3"""""M£(@0r9@Sam?g&#`AN$*
gd qsϽ_ ?- C: `XjvTUq*
sK/~}ɳ^uЫWˊd2>5k>~GUۼy"`6e@`Ԩ?`HओKK#@U[z ӧM=z :\`ķz=o )JFƹ<"U$]㯼|W_}Il~ |쳓'g ѨhbDDDDDDtFQH$uVQP@@U
+tYgɓ~ǎ[ncpx2vZmq1p deX1u*pS LJ n\"pi`p6&N*ꫯ ^XLF߿y37[Z,!c:B!cNի ؽ[4#11qҕ+++O5Dhf()̴ہ~ V&S^^@ZZuʕ~V( =
C!`cd`Ҥo?W_ݸ1'c$`@x蛇-Fh:6@p>> [ W_}1GwUR3H[s-, 7>h\x㍏?^غtV`O>=?Td:; >Ӈ > F,[L_TV:
֭[TT|( UU1n BZmퟫј$$z>:ci>!{9Vo Ķ\. }g2y<6 N6o{`뀱cty]`vaX䓣ˁgٳG^ lK 66nZ~:0dHN44 '}D_%%EE٬[@ gqe,X}{0/d""""":~uZ韣sht./s;_X|7 >੧>n&[я[c۶3 yxѯ" cKt9nqOWZ:mڟ <
v|_O tٻwb.m #ݻ>[' _zMOG<;buE̙eeg
\};s&dIc*OZ^.ܾH EQ Vģ>ƍK CFgwɾYe [4.XpmK Fc6ݺ]p)o|sB agz^~5R#""""_hk/\Uwڹsng±|~^_?ࡇ^y Ko{ ,n """""E] Mx藯e/U'CD'*MU7n 6nc D /dne """""""D/aAqNde[y)SMrc"""""""5ƘMxZ&}$tR"""i#)F"WQڞ.A˯BfsR`t_kXv.`4>xQ F"_wQQrmjx .!!%0Z~gMUH$
UM
3d"Yg9y'ǧZp
z(;q9q7
O$ñj[h4:]0ac'з>8py; IQ /?ЬYQ<#z}k 7.)t:^/D zE%JZڱmo
\s
s<0~<՞H_*N( cY916rc5߯px`ڴo`?w6[VлС\z饗X=GB`Pt.A1<*>dp(ǦM{:m]iӮ]@e%WZ$%
RRb2Z 2W/ 1Qmʯv?0{}@^^x@n.p4FskmRZ(͗Ç :%v \{m
ro̟?cƴi?yݻv?'$3ADt&<@8r)8%3&Lh_~/^S0Ν`?]L̘1g^}q1`6Ǟ@ kYkʧ˖UT͖DV {;ERvصT O@#V Z =0l60ąRT4t(p%_;v;PT4~
7 v啃ii.ܹ]wqҥ jO?nˁ믟:ۀ}U;^x.@߾W_)g
D}Ϙ,^gXc W]5y5 Fefwԉ5|> ضm۶[`00 b -6l
, f3`'% ``smlܱXzŊJKa`HN8N;d@6DRU (+[ %K~y0O99r lFz/^b}{u
B^ |رݺ}^F#0 voFQ,z>唡C^RS֯_pr`κ:O3 ɔRT@Yݕ @RR#F XHM߲e uu~? .]}
<-9=塿ooŋgcMM 6⋁
z ۺ/|߾ XbM2+F#!A
pFjEUE!~k u:>EٿDe}D"SiU
*Wy(B@8ӵ7 jXbdz!C?;sr o2x/<,+E|fU~xW^#`R0N>8nӟ.W֯ɓ_ȸ>gKlD>o{QzĩSɓU9gK|wn}~ǎz[h <In8좢xuz.wo TX?q>5UrϡPYYqtKDG_<^ƍ 7ڦի?}rv$M m˖Ewq)nO?ӧ[^v٤I@I"1~M>@Mѓ'{bZmK@i8
l̙5kn 1HM5.߁_d@+/=x≇ i
|s{O{bzӁgo z6N.MI@`fz?**ƍ2x#= عs N}E>}o - ϯr97 TUQT8fd4))II$FӐM;*@FJ*INN:^ Ż%q!n6 .Wq1q44^wO?-Yg9~d ;m6@qm,+
. 2nvSU/ ')IVk:T^ 떯o
N;
81c`pˁ .\ѣ|E F3.fz ;,{`ݺ^1c:kP 11ڻ_
ظk|`P= =Ə?|gO- jkn] Xde 79ikO8-vѩקÇ_p @A$?q~(@E`Ev? |]vp%'R[i`%GܲTUєFbZq+bMuE!<4[E$*Om .kp>ydf#G |?] ]zia!lߏ?{Ν:y2wޙ\O?@FOvpI
xsl\RP LnΝƍ55n7vsm-
铕(ʾ}7
&SS7{ Yg=K/g6̘c/? 'C n=s ɉ@II7ݔu록? q~3":DJ";R/Q*ynz U|M֬ ƌ),X Oc#k9s6o@$wժ:t(pU) @QQI@vDpw%Xߞhd %-ݶ3۶H;
/Jk&Mz`pxH4iX %E`lYYYY@Rl4ݺuVAA8 UU^ Ft>_Y{wU ٜde={- O9OWj*0hO ۷lPZ
H~-jkEʼnV II߃$
"2333sr:c4
ѩd$՚̀* Q4ظko훕%Fy1=ڷp:EGZ-`0v; .1!!? #))nq0pI'*!!###HH Gq$0+V s :nQY n{rzGyrYS#JUU@$PY 4HO?|@ (О=KB\{% $%}{瞛y3w6ޣǠA@ZZM͚5@ii0 =k
))@ iӎ ǣ8zuY0p`>i2ĔdHN?ѣr6l *+#} hz|(tχr'"#%;{moҲSU ذaΜ;"IzƎSQSt.f v{áKK}DcEQDc^#Zrt0|_z; ͖$N l;y /^s'tF"hU
1cZv>(>[+n ~x f3қnJ`pu=͛ ŋ[gq1vBb Ⱦucccc]]2?999955g6錌T1748|9J{J lzEih HDӨj($.Z?hϞ֧BKv\RTZ[_/ DshHH(.c_;u+J0ј
X,cgш 6YURGAk4Ng0@B dB`{<+F#,>ee 5#83 hTlo9eDq,-UɊp8Q1lcw DV>;AKVTΦQYk#γd_)⾢w 5:fDUS j&'؋Q DyhExȐ`@u `}n )iJ / [@/JK"`ǎ-[t:_I ^U+*Z+L&0UUt}ᾞh4lloqpϟ{ 7./p _tZ Ycp+P4{F`Μ WQ yᆥKo/9|js 6C Æ%$}z ^x;Vb'@ǶD@jj-55+ HKKIj \:*X;lؽ;p/II 7i7l0N'^GDbz:＿xꩳϾR`w?矟:u\[kII q)S^|[[DSHM9gԨ_f Dep"ɁATp8vf,xw:z-3S4ڵ عs>}h4шNqF3
ێTpo_
X&-
5J4ɱXa`ٳ_`˖c5ITMM/Xh4 D\a2lϚ[N4h;J>O1*-j=z QD_ bb$ud[Eʽc9oYy"ԅBBTT q|?*OJYd JD+I][qMGNsc ,)'E2Qpطt] 璓a [p
jݱ N=%KXhʥKPO krsE@憎xO_|+VZ:?8?n㏟{/JD 4 dҥbC\Cr_mfС_s/ /RW~Nn~: O? 6h\ x.9@Ch i4 .Fd:v?F -G3w{JGϷ}XO^pĚnam^W\zlj-( IN fU{z8;w[x<秧C0 MaqAx10mG m[EEUP]]Q};uMM@(R#Ql9ee c}>1$%%%4+Al/Ă9veV1C!= 8$yj}? XcGu5|tee/F3ڤ" /سXb{: pjb($7_l{~xݡPJJ@.:]Yjee%fرn eK 葕%">W^v\ غKIz7@ZMu{/8> z}r_>@l+W hlC!wY zE 7ZVx{l kB
D")MSS}胧ITȦ ]w͝+?7f3ڧo~#Jw=x'VL&%y
7{.g'$ ^{=]+:p_}%N4 瞋.Zk4t?N7v f]0qF#Ҁy/[૯Th 0;wשּׁC?ӥ})˖Y|_ &SRRa!`GƖ)X:yH/֤-+FTUܗ%̓: Mx F}ɓE99@߾CgaJ^}݁kx_{
2ohbYY]4e- Æ//Qv ? l8b@JzCIɈ@vv8\ULЭ`2 Y%Fcye_4^P~ ~m9DK/ӪzW_}GE>l (( @ %75KW\1gNǯd2ͱࡐ载-F(Nā^^ȾAz^?:K{XIОw ؆y/ [ƚm=~tTWyy@0(:l/k/ 7v1۾Ql61Z?̛-x-t|ۢt:
p8ܼNG<HDO :|<1s@N%-ⷬĉ_s]Zn#EhPHp[WWWW]-*Nc| 28[ySWb;TVVUUU]vڽ8־"R'$w#}4"G+-[̓ǕhTǒ -W /u:1lRJ wF,GQ|ݻMs=,W/<6?ͿGq[l}/6??Sg? `ذaÆ
hʔ/x֬@
~ž7- Tl#S 1ZfXXf ~{[[Ǔq*V<)8<4oR*~|\ wz~pXO{_ { aDtzwߝ6
wV_lhj l9]g; ai[b%: m-# 7@iy ʼng{+@j- --J H/P8ZۣslNeSWWWWS$$$$$&Q~@Z5 Ņ0ɱj'P/@
h&7PW |u [__UUUEzַ \ ;~^: :Z
M3 V'ޯxGxJە(k#+O}w>xP'xǙ~zw>Z}={?g#D>>
OK-Ѩ,K_tm#@Ӊ:r |tPH\7 ҉M x D l#/|/ #ҋx< P9= $yy cnF"bl\"p>Z%@zV*SZk fbk~"FDDQxQ&Vâ7X
shT(*PvR}}}}]]$`Ey-oeBk aj/^w|&ge5555"(b&=-KeВ!#H\ l& zO,mUPjY(E4 QOV }.c~J+RmH<Tm,`P a+j4b/?@q\.[Yb4[),jt:NTUEQU
C!m!""""""" *V)Қǡ `0 YYYY|㈈9 EVuh4Fx fD^KdDDDDDDDt9jx
WZ{7|>_Z
x< ANw"qK.]bA^>_Oοo =G ȾLd VV 8L_XXT$:5Z X#Pd%2p]. jepRPZpr
bϗ#""""""":ZG:XSVT n!nDpv">q8sF#z'IHHJJJd kZn"""""""cBDDDDDDD"""""""8 ((DDDDDDDDq0@!"""""""
Q P`BDDDDDDD"""""""8 ((DDDDDDDDq0@!"""""""
Q P8 EUUUUx :nΠC`h4p:QUUUB 55==#o u#@z= 0fHHHJJLZN** EQEi{>q9|l6̀#GDDDDDDDt q"
>vt:NTVeeŦϗz= X,o =G dddffeVnr6^/`v;ՊݳG4 2q_^>_O?==##3o =G `#''77//v):Nv ~D>_ht#""""""":Z:,F^^.DAEfm6 !!1111v_>.ҥK'DDDDDDDttx$!4zRFhݗN&d_XXTt0qNq=.gpBDDDDDDDNjN(dҥKaaahp ~ >38!""""""h-Hi |Z"""""""8 ((DDDDDDDDq0@!"""""""
Q P`BDDDDDDD"""""""8 ((DDDDDDDDq0@!"""""""
Q P`BDDDDDDDf|> PWW[[ShZV $' Vfǟz<@cc}}}=((@ZZFFf&`XV+8""""""":z:
0Fv njJnw8 d2M PTUTȊF=55--= H Eޗ
D"H4?aMxd2xjɍ Fjj*+E 7h4~&=> 7@Mnrsssx Wi"Ԕqh4DD`>$776"""""""G 33''77VA"EF%Vq"ǂq+/GDDDDDDDt;k ee21M& `P4|DDDDDDDDNJ2HAJ0(hT* Nx?Z Ajlئ&HHHLz^?78}udeI{TUUUşdM~22cA Qg; HLLJJL;DQD&+/vGDDDDDDD:$PUnjjjt:NUUUU%""""""":z8@?HkS Fdg#""""""nہ={%""""""_ -71@!"""""""
Q P`BDDDDDDD"""""""8 ((DDDDDDDDq0@!"""""""
Q P`BDDDDDDD"""""""8 ((DDDDDDDDq0@!"""""""
Q P`BDDDDDDD"""""""8 ((DDDDDDDDq0@!"""""""
Q P`BDDDDDDD"""""""8 ((DDDDDDDDq0@!"""""""
Q P`BDDDDDDD"""""""8 ((DDDDDDDDq0@!"""""""
Q P`BDDDDDDD"""""""8 ((DDDDDDDDq0@!"""""""
Q },^`?pG """"""I'
0hw """""""jܹf͜&5!C~[[&NGz
X| y(@}? IӦ}4FAw mt`K~ {}>
df=z4p啷?: ᧟ yy7PhvwG9s*+#45#S/ +5
7~^ھ^g]DB!ٺu@5ffS;qxo(}Á `9lFwdYxʕЧ
7tڞ龜Ձ}`ǎ>}nx`z)ykWgnu@n?_XHgwǓpر >{w --1yv֞Xۅ2d!Śȿ˦;qwٔGx< z+Rdps)-n
n((D~zj4-) { rs^UU+W~%7s&iSCC8 dd zB^o$ }=^sMnhhZ0/~6m>_K.F <8/Z`-[끔U4kW`K.uw<\. ƌ뮇 . v^裗_~
'-.]첢8P{IgњM h4} /xjM&=^0eeou着`0BB nٲluwkܢ>HPe%U`^g?h qUUK E
gg L?m9G">I嗋+4ᇁWlhE rOp? @2LQǷpSO^
xd6oyi})ڛ*={60uwO鮿^{
?y)g?\{. Jq0:]PhFzM~mW_ {_ᇢo"""|~lZxŋǚ߿Jx n)Fh4PtaÀ뮻 /.(HOӋ
Əf={NeJ$45|@]7c2 Ŧp0 dWnAo%߿m0cƇ n dfw
Lt99@vvQQg=f PX(Y ?Yvi4dlݞ
tRRr?ztj*tnVQDw
;w3f_:+u>8wnMxow4\-^ t*N00-UJKNV \# ߳g?9N? HJ**\k-~㮏C!bɒ+W#nDI{Q 45EE@N`
HKF7nJKH8d-^ t2a_u@CÒ%W^y}iӁ?ܱo_oԇ zN.MN5WUC[ぴ49)? 3HO uu7.,x$"">` ֯_~zw{5&2Mod HdS I0VZj|,DժmۢQk.'yhҳE]uг'W.SQ g>`
䓇j5 *+W~/( .x5%:ӹmx5.:hP^ `6LZ|9y
w==7يCj*Ӊw9PۏnZXXR֮Yz5@jjIС\O=/|@a᭷> ՚6( KlII&S~ K 6lX,EE' qG] ˗|@ϞW\ѽ;`j4
x<_G
H$U5-@+X-Qb
~8ܞ >9䓻wSS}<ˁJNǟx oѣsr`:|Uii)BZNt:qՊ<*-`px`K;_? --!!+ 8s=t 5l
`._t:jt: سtL 779h< p֧h4i{u4Y ";h9V' hhhhhh X *V6)2ithX⭷^xX #K6,99~pq$t: ;{/C32H_; N駆+aZ(>_c#II@JGMMfM}}#` Fk+ { 9qrrtu{5 HIIOON32 ];:ol99W^y@4j0tTW/Yao߾hzIV(ٵ' ڳع&NS 6߿mۢE@Mҥ6 ѨXP ^qŽ:T u} WV._,]t ݣ& ?uˋzd4P"~UD~Q2d4pd >!NL~:\RqF7KVUޫ=v'\*,- vE٭[G %KZkWZZ.{I/9қn*`ܸ|Aϡ jQt}9 B|>NG$-Y k"
ӧ_k;lp;~<Ï@jj#G&/z9LWL'r@~~뽡hKR`6G"vMMKg.)i0`xkuz=UUƍgOLC | dg?W=z nCs߇ځh6]?~@Uҥ7^?l(+W._l:e- 8z7mGvÆ={ ![7k[o}~4^ _ ^TWXt)vwv%@Ϟw~>ԎI b 1Ql
_UBQBہ:.+ (*JJ:CF8 >ii6i4[Roϝ ,^\]y3`4 99"Hh4ǖ;v9 ))ݞ4z4p<3q"гg/OλVG</G ^ziٳ^ . rs۷U}(}ۅ"Ȱl6
X, Uޗ BdE$YayvnǞ'F^^xan݀o~?w))YY> ݍyy֬N;mܸCoXd$' #G~hтC E w0xǂV+~;_~رo [j #f#1p8
@` M%1[7[)S^|16_;^ }=4h|ҥMMcϞuնg~\A
FLK۵ 1Vں;-ᒒq;$a>`>6
58~cYU,}OW JKƺ}]mr7Dmmp`PUm6 ;;??-
Ah`K7Θn@;ig ;%""Cc,4&V*@nnnnnnV#KeӞ|:`pO?t>.jDb4P8 T$RWx1O>ED_ZYjնm@yy]]CPSSZb3f[(JqqI uJef. /ر㭷 }xo]V 55UU
kSU z].rNzϞuĬY@YZT%& D2pwitvｯD"KQPSjΝ@(vy@BBzzvr~'
^ _Ujdٵ+0fLǁ-6;]$/8ɓzW_LPHN ɓ=3 II@QQ^^0|#_GSN~;z`ذKƼ<`*( fCQrs?4X{ <ěo{/0iZ@ {}W]i>mp=3gnuEw>g/tFIIݻ&\sYgyy 4W/sGہS_}utS{[m}
OK^^#"""jd>LdӚXň$iK˦;V26mڴiS,@ %ihؾ ر (/I~j9>r$p/p@^W(^oy9m;v ^YݻXOyXp^[\X@n\ ~ןr
.h~OgtF 99/O\%' Od (H$*[x<⥲
`o{- o~ǑH}5E] ӷoRұ NZUU/5\suѨhjclVkl ٧ MGVȿ&9NQv=2@q\.;ګ2""~(DDDDk0x)r
7|@}}}Wsyw ?
Wn-= ((DDDDDDDDq0@!"""""""
Q P0sΚ5s&7QK ڳ0< IENDB` lottanzb-0.6/help/mallard/C/figures/lottanzb-logo.png 0000644 0001750 0001750 00000003404 11525760436 022567 0 ustar lantash lantash PNG
IHDR szz sBIT|d pHYs
B(x tEXtSoftware www.inkscape.org< tEXtTitle Contact NewdK? tEXtAuthor Lapo Calamandreiߑ* AIDATX]h\sܻ+v%b+I-JRj Oxྸ 6)!mi J1
~0zKM Y4&$Vr*KV+םi7Ziar`̜9?sG|&PR?g<3߶)L"K )%aP6WZF1UÑ#Gv ;v c Ǐ ĉ>} 0xL&C< }._L< ͛cbddFGGK_*\[8|p^(B&''y!J)ƈb377իWIRcHӬM8gY֥=kC100PvEz{{ By9x oߦV֜?
[ P G Ν;ekW\
cسgccc߿wގ֚nΜ9W 7ٳ:u
c Xh4J[[b1fff8w ׯ_cB=gd2/imm%HN-ZLI)ijj"
1??RjÙ֖ 244D2IJ,\q AJI 2Kuu5BۈFʘ}Bl Bd2TJm8 RayxC**c`)%UdBJI$ !x15EM]3m۶3Uo,"
?zq-(ζmY"Q
^
˲, kr\ s[oT hF18Y@GK M fn3h/ĀmeK)y]
+1Ek]Erid2 5>" hzZi|@/1mۥoO)oPk J}PJ3??_^ ! */2 B+Lk
Tsݻw訴X5`YVY͋^ҌzѣGRd2\u]~U:bg97o̦EGJ'sx k^)xPjzzػwoɓ'ihh8miXMyJ!9ov$[xeEr4pAk.۷,+noNruӀ-<{ )>y +6SZ;ǟ&<=C[x.ڻrD @"G˹w'-ш%B(
KE _\I Xq/ /9 G+ qD\J=_J}{w `O*K|:$fVd|:${^ iAUn. t/]CcQ !Fy { M
5o/߸qi9ɤ
Monitor and limit the download speed
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB Development Team
Creative Commons Attribution-Share Alike 3.0
Download Speed
The speed at which files are downloaded from the Usenet is shown in the
bottom-right corner of the main window, inside of the
Infobar .
Limiting the Download Speed
By default, LottaNZB will download as fast as your Internet
connection and news server allows to. In order to prevent the downloads from
interfering with your other Internet activities, you can limit the
download speed. There are two different ways of doing that:
-
In the Infobar , click on the icon next to the
download speed. This opens a menu, allowing you to select one of the
predefined download speeds or removing the current limit.
-
If you want to specifiy a custom download speed, select
Edit Preferences Limit download speed
and enter the desired download speed in KiB/s right to it.
In both cases, the changes will take effect immediately.
lottanzb-0.6/help/mallard/C/introduction.page 0000644 0001750 0001750 00000002421 11525760436 021177 0 ustar lantash lantash
1
A brief introduction to LottaNZB
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB Development Team
Creative Commons Attribution-Share Alike 3.0
Introduction
LottaNZB is an application that enables you to download files
from the Usenet.
The Usenet is a world-wide distributed Internet discussion system
that has been around long before the first websites showed up. Beside normal
text messages, users may also post files like pictures and videos,
which are commonly split into multiple messages.
To simplify the download of such files, the NZB file format was
invented. Such NZB files are created by Usenet search engines and provide
LottaNZB with information about what files are to be downloaded from
the Usenet.
lottanzb-0.6/help/mallard/C/index.page 0000644 0001750 0001750 00000002215 11525760436 017566 0 ustar lantash lantash
<app>LottaNZB</app> Usenet Downloader
<app>LottaNZB</app> Usenet Downloader
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB Development Team
Creative Commons Attribution-Share Alike 3.0
<media type="image" mime="image/png" src="figures/lottanzb-logo.png">
<app>LottaNZB</app> Logo</media> <app>LottaNZB</app> Usenet Downloader
lottanzb-0.6/help/mallard/C/setting-up.page 0000644 0001750 0001750 00000005454 11525760436 020566 0 ustar lantash lantash
Take the steps required to start downloading
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB Development Team
Creative Commons Attribution-Share Alike 3.0
Setting Up <app>LottaNZB</app>
Prerequisites
What you need to get started with LottaNZB is:
-
A news server account , giving you access to the Usenet.
There are numerous news server at different prices and with a different
retention . A retention of 500 days means that a file will be
deleted from that server 500 days after it has been uploaded.
-
A Usenet search engine that allows you to search
for files on the Usenet and download the corresponding NZB files.
First Start
When starting the application for the first time, you asked whether you
want to download to your computer or
-
For downloading files from the Usenet, LottaNZB depends on a
application called SABnzbd . If this software cannot be found on
your computer, you are asked to install it. Please follow the provided
instructions on how to do so.
-
Next, you need to enter the details of your news server account.
Usually, the website of the news server contains the address and port
number to be entered. Depending on the news server, it may be possible to
encrypt the data downloaded to your computer using SSL.
Activate the corresponding check-box if this is the case.
In most cases, a username and a password needs to be entered.
Some free news servers allow anonymous access and don't require a username
and a password.
Clicking OK will bring up the main window,
where you can
LottaNZB Main Window
lottanzb-0.6/help/mallard/C/observed-nzb-folder.page 0000644 0001750 0001750 00000002271 11525760436 022332 0 ustar lantash lantash
Automatically add NZB files found in a folder
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB Development Team
Creative Commons Attribution-Share Alike 3.0
Observed Folder
LottaNZB can automatically
You can choose this folder after selecting
Edit Preferences and
activating the check-box Automatically add
NZB files from in the tab General .
By default, the folder that web browsers download files to will be
selected.
lottanzb-0.6/help/mallard/C/prefs-general-tab.page 0000644 0001750 0001750 00000001732 11525760436 021760 0 ustar lantash lantash
Customize the downloading process
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB Development Team
Creative Commons Attribution-Share Alike 3.0
General Preferences
The General tab lets you control how files are
downloaded from the Usenet and what should happen to them after they have been
downloaded.
lottanzb-0.6/help/mallard/C/post-processing.page 0000644 0001750 0001750 00000005622 11525760436 021623 0 ustar lantash lantash
Actions performed after all files have been downloaded
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB Development Team
Creative Commons Attribution-Share Alike 3.0
Post-Processing
After the files belonging to a NZB file have been downloaded,
LottaNZB will perform some other steps, which is called
post-processing .
Post-processing typically includes the repair and extraction of
downloaded files. It allows you to access the downloaded content without
doing any additional work.
During post-processing, the progress bar will stay at 100%.
However, below the download name, LottaNZB both indicates what
operation is taking place as well as its progress,
e.g. "Repairing... (42%)" .
Post-processing requires the computer to do hard work, which may cause it
to take a bit longer to respond to your input. LottaNZB
tries to minimize these effects.
Customize Post-Processing
After selecting
Edit Preferences ,
use the drop-down menu below After Downloading
to choose which of the following actions will be performed during
post-processing. It's only possible to perform an action if all actions above
it have been performed.
-
Repair
Check the downloaded files for errors and if there are any, try to
correct them. In order for such a repair to work, the download must
include PAR recovery files , which will be downloaded if needed.
This is the case for many NZB files found on Usenet search engines.
-
Extraction
Extract the content of compressed downloads. Large files on the Usenet
are usually compressed and split into multiple RAR archives in
order to save space.
-
Deletion
Delete the downloaded archives after their content has been extracted.
If the extraction has been successful, there's usually no need for the
RAR archives anymore.
By default, all of the above actions are performed. It's even possible to
prevent any of the actions from taking place by selecting
Do nothing
lottanzb-0.6/help/mallard/C/prefs.page 0000644 0001750 0001750 00000002451 11525760436 017600 0 ustar lantash lantash
Configure the application's behaviour
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB Development Team
Creative Commons Attribution-Share Alike 3.0
<app>LottaNZB</app> Preferences
After LottaNZB has been set up, i.e. to manage the downloads
of Preferences dialog. You can open it by selecting
Edit Preferences
SABnzbd , the application upon which LottaNZB is built,
offers many advanced options. You can review and change them by
Config tab.
lottanzb-0.6/help/mallard/C/remote-access.page 0000644 0001750 0001750 00000006003 11525760436 021210 0 ustar lantash lantash
Manage the downloads of another computer
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB Development Team
Creative Commons Attribution-Share Alike 3.0
Remote Access
It's possible to manage the downloads of another computer in the same way as
downloads to the same computer.
There are many situation where this is useful:
-
The computer at home is downloading and you want manage the downloads
using your laptop while you're away.
-
You want to make it possible for other people in the local network
to
-
The other computer is actually a device without a screen, such as a
Network-Attached Storage (NAS) .
By default, it's not possible for any other computer to manage the
downloads of your computer for the sake of your privacy.
Getting Started
Take the following steps to securely start using remote access.
-
On the computer where downloads are taking place, allow remote access
by selecting
Edit Preferences
, navigating to the
Remote Access tab and activating the check-box
Allow access from other computers .
It's recommended to protect the remote access by activating
Require authentication and entering
a username and a password.
Confirm your changes by closing the window.
-
On the computer using which you want to manage the downloads:
-
If LottaNZB is started for the first time, select
Manage the downloads of another computer
in the Start Downloading dialog.
-
If you've already been using LottaNZB , select
File Monitor another
Computer... .
Enter the name or IP address of the computer whose downloads you would
like to manage. When asked, also enter the username and password
you provided. Click OK to start managing the
downloads.
lottanzb-0.6/help/mallard/C/news-servers.page 0000644 0001750 0001750 00000003502 11525760436 021122 0 ustar lantash lantash
Add, edit and delete news servers
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB Development Team
Creative Commons Attribution-Share Alike 3.0
News Servers
In order to add, edit or delete news servers, select
Edit Preferences and
navigate to the Servers tab.
Adding and Editing Servers
You can edit the information about a server by selecting it and clicking
Edit . In order to add a new server, click
Add instead. In both cases, a dialog is opened
that allows you to specify the information about the server. The changes
will not take effect until you click OK .
Usually, the website of the news server contains the address and port
number to be entered. Depending on the news server, it may be possible to
encrypt the data downloaded to your computer using SSL.
Activate the corresponding check-box if this is the case.
In most cases, a username and a password needs to be entered.
Some free news servers allow anonymous access and don't require a username
and a password.
Deleting Servers
You can delete a server by selecting it and clicking
Delete . Note that this cannot be undone.
lottanzb-0.6/help/mallard/C/incomplete-downloads.page 0000644 0001750 0001750 00000005531 11525760436 022612 0 ustar lantash lantash
Downloads that are still waiting to be completed
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB Development Team
Creative Commons Attribution-Share Alike 3.0
Incomplete Downloads
In the case of the currently active download, the estimated
remaining time is displayed below the download name.
Pausing Downloads
Activating Pause All in the toolbar or
File Pause All
will prevent any further downloading from taking place, until it's deactivated
again.
However, it's also possible to prevent an individual download from
taking place by right-clicking on it and activating the check-box
Pause . In the download list, such downloads are
displayed in gray. You can later resume such a download by deactivating
Pause again.
Renaming Downloads
When a NZB file is
Properties and changing the
field right to Name . The changes take effect
immediately.
A download cannot be renamed anymore using LottaNZB after all
of its files have been downloaded and
Removing Downloads
Any download can be canceled by clicking Remove
in the toolbar or pressing Delete .
This cannot be undone and any progress will be lost.
Reordering the Download List
Downloads are performed one after the other, whereas the download at the
bottom of the download list will be performed last.
You can reorder the list of incomplete downloads by selecting a download and
dragging it to the desired place. Alternatively, a selected download can be
moved using the arrow buttons in the Reordering Pane
on the left. Clicking the topmost button will immediately start the
download.
lottanzb-0.6/help/mallard/C/web-interface.page 0000644 0001750 0001750 00000004665 11525760436 021205 0 ustar lantash lantash
Manage the downloads using a web browser
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB Development Team
Creative Commons Attribution-Share Alike 3.0
Web Interface
You can manage your downloads using a web browser instead of
LottaNZB . This feature is provided by SABnzbd , the
application that LottaNZB is built upon. This web interface is useful
in situations like the following:
-
You want to use an advanced feature offered by the web interface that
is not yet available in LottaNZB . In addition, this lets
you customize the downloading process in more detail.
-
You want to remotely manage downloads using a device that does not run
LottaNZB , such as a computer running an operating system other
than Linux or a smartphone.
Information on how to use the web interface can be found in
Opening the Web Interface
You can open the web interface by selecting
File Open Web Interface
.
Alternatively, you may also directly enter the URL of the web interface
into your browser. When downloading to the same computer, that URL is
localhost with the name or IP address of that computer.
The web interface of another computer can only be opened if it
If you provided a username and a password when allowing the remote access,
you will be asked to enter them.
When using the web interface frequently, you may want to create
a bookmark in your web browser, giving you quick access to it.
lottanzb-0.6/help/mallard/C/searching-download-list.page 0000644 0001750 0001750 00000002317 11525760436 023203 0 ustar lantash lantash
Find downloads within the download list
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB Development Team
Creative Commons Attribution-Share Alike 3.0
Searching the Download List
When the download list contains many
You can search the download list by just starting to type a part
of the name of the download you're interested in. The first download containing
your input is immediately selected.
When the list of completed downloads gets long, you can also
lottanzb-0.6/help/mallard/C/license.page 0000644 0001750 0001750 00000003172 11525760436 020104 0 ustar lantash lantash
Legal information
License
This work is distributed under a Creative Commons Attribution-Share Alike
3.0 Unported license.
You are free:
-
<em>To share</em>
To copy, distribute and transmit the work.
-
<em>To remix</em>
To adapt the work.
Under the following conditions:
-
<em>Attribution</em>
You must attribute the work in the manner specified by the author or
licensor (but not in any way that suggests that they endorse you or
your use of the work).
-
<em>Share Alike</em>
If you alter, transform, or build upon this work, you may distribute the
resulting work only under the same, similar or a compatible license.
For the full text of the license, see the
lottanzb-0.6/help/mallard/C/completed-downloads.page 0000644 0001750 0001750 00000002647 11525760436 022434 0 ustar lantash lantash
Downloads that don't need any further steps
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB Development Team
Creative Commons Attribution-Share Alike 3.0
Completed Downloads
The files of a successfully completed downloads can be found inside of the
In the case of an unsuccessful download, a message will be displayed below
its name indicating what went wrong.
Clearing Completed Downloads
Over time, the list of completed download may get long. Clicking
Clear Completed or selecting
File Clear Completed
will remove all completed downloads from the list of downloads,
while the downloaded files will not be affected.
lottanzb-0.6/help/mallard/C/reporting-problems.page 0000644 0001750 0001750 00000001635 11525760436 022316 0 ustar lantash lantash
Get in touch with the developers when problems occur
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB Development Team
Creative Commons Attribution-Share Alike 3.0
Reporting Problems
LottaNZB is by no means perfect. If you encounter problems of any
kind in either the application or this documentation,
the LottaNZB development team would highly appreciate it if you
lottanzb-0.6/help/mallard/C/adding-downloads.page 0000644 0001750 0001750 00000005354 11525760436 021704 0 ustar lantash lantash
1
Add new downloads to the download list
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB Development Team
Creative Commons Attribution-Share Alike 3.0
Adding Downloads
You can add a download to LottaNZB by getting a NZB file
(typically from a Usenet search engine) and opening it using
LottaNZB , which will then download all files from the Usenet that are
listed in the NZB file.
There are many ways to add a NZB file.
-
Manual Selection
Choose one or more NZB files located on the hard drive after clicking on
the Add toolbar button or selecting
File Add File...
.
-
Drag and Drop
Drag one or more NZB files and drop them on LottaNZB 's
main window.
-
File Association
Click on a NZB file in your file manager. NZB files are opened using
LottaNZB .
-
Download from URL
Enter the URL of a NZB file in the dialog opened by selecting
File Add URL...
, which will cause LottaNZB to download that NZB file.
-
<link xref="observed-nzb-folder">Automatically from Observed
Folder</link>
New NZB files found in this folder will be added automatically.
Usenet search engines usually indicate how many days ago the files
listed in a NZB file have been uploaded to the Usenet. Please make sure that
the retention time of your news server is longer, otherwise
LottaNZB won't be able to complete the download because the
files will have already been deleted from your news server.
Newly added downloads appear at the bottom of the download list after a
few seconds, which means that any previously added download will be completed
first until the new download will take place. Learn how to
LottaNZB .
lottanzb-0.6/help/mallard/uk/ 0000755 0001750 0001750 00000000000 11525760442 016053 5 ustar lantash lantash lottanzb-0.6/help/mallard/uk/customizing-interface.page 0000644 0001750 0001750 00000004576 11525760436 023241 0 ustar lantash lantash
Адаптація інтерфейсу користувача за власним смаком
Severin Heiniger
severinheiniger@gmail.com
2010
Команда розробників LottaNZB
Creative Commons Attribution-Share Alike 3.0
Налаштування інтерфейсу
В головному вікні, поруч зі списком завантаження також розташовані інші елементи, кожний з яких необхідний для
-
Панель інструментів
Надає доступ до часто вживаних функцій. Замість неї можете використовувати меню Файл або
-
Панель даних
Містить такі статистичні дані, як швидкість завантаження та час, що залишився.
-
Панель перевпорядкування
Використовується для
Кожну з панелей можна приховати шляхом деактивації відповідної позначки в меню Перегляд , таким чином, залишаючи більше місця для списку завантаження.
lottanzb-0.6/help/mallard/uk/multiple-news-servers.page 0000644 0001750 0001750 00000006024 11525760436 023212 0 ustar lantash lantash
Одночасне використання кількох серверів новин
Severin Heiniger
severinheiniger@gmail.com
2010
Команда розробників LottaNZB
Creative Commons Attribution-Share Alike 3.0
Кілька серверів новин
Щоб розпочати завантаження з Usenet, потрібний лише один обліковий запис на сервері новин, але є кілька причин, щоб використовувати більше. Зверніть увагу на такі ситуації:
-
Ви вже користуєтесь безкоштовним сервером, але ненадійним тому, що деякі файли на ньому не вдається знайти. У такому випадку, варто створити обліковий запис на сервері, що бере плату за кількість завантажених даних. Для економії грошей, завантажуйте з нього лише файли, які не вдалось знайти на безкоштовному сервері.
Наступні функції доступні лише, якщо визначено кілька серверів.
Вмикання та вимикання серверів
Ви можете вимкнути сервер деактивувавши незалежну кнопку, яка розташована ліворуч входу на сервер, що примусить LottaNZB зупинити завантаження з нього. Пізніше, його можна знову увімкнути активувавши ту ж кнопку.
Резервні сервери
Резервний сервер — це сервер новин, що використовується лише для завантаження файлів, які неможливо завантажити з інших серверів. Сервер може бути позначений як резервний під час Додаткових налаштуваннях активуйте незалежну кнопку Використовувати як резервний сервер .
lottanzb-0.6/help/mallard/uk/managing-downloads.page 0000644 0001750 0001750 00000003724 11525760436 022473 0 ustar lantash lantash
2
Розуміння та маніпуляції зі списком завантажень
Severin Heiniger
severinheiniger@gmail.com
2010
Команда розробників LottaNZB
Creative Commons Attribution-Share Alike 3.0
Керування завантаженнями
Головне вікно містить список завантажень. Кожне завантаження показане за назвою, розміром та поступом завантаження у вигляді смужки поступу. Залежно від стану завантаження, може додаватись інша інформація.
Активування кнопки Зупинити все на панелі інструментів або в меню Файл Зупинити все
В списку завантажень,
lottanzb-0.6/help/mallard/uk/keyboard-shortcuts.page 0000644 0001750 0001750 00000003525 11525760436 022555 0 ustar lantash lantash
Керування програмою з клавіатури
Severin Heiniger
severinheiniger@gmail.com
2010
Команда розробників LottaNZB
Creative Commons Attribution-Share Alike 3.0
Комбінації клавіш
Доступ до більшої частини функційних можливостей LottaNZB можна отримати через комбінації клавіш. Під час натискання клавіші Alt та одного з підкреслених символів в більшості пунктів меню відкриває цей пункт. Додаткові комбінації клавіш для часто вживаних функцій:
-
<keyseq><key>Ctrl</key><key>D</key></keyseq>
-
<keyseq><key>Ctrl</key><key>P</key></keyseq>
Призупинити або відновити всі активні завантаження.
-
<keyseq><key>Ctrl</key><key>Q</key></keyseq>
Вийти з програми.
-
<key>F1</key>
Відкрити документацію.
lottanzb-0.6/help/mallard/uk/download-folder.page 0000644 0001750 0001750 00000006107 11525760436 022000 0 ustar lantash lantash
Вибір місця для завершених завантажень
Severin Heiniger
severinheiniger@gmail.com
2010
Команда розробників LottaNZB
Creative Commons Attribution-Share Alike 3.0
Тека завантаження
Всі успішно завершені завантаження переміщаються до теки завантаження . Хіба що ви Завантаження на панелі інструментів або в меню Файл Відкрити теку завантаження
Типово, LottaNZB використовує ту саму теку, що і програми на зразок веб-браузерів. Зазвичай вона розташовується у вашій домашній теці і називається Завантаження .
Checking the Remaining Free Disk Space in the Download Folder
In the bottom-right corner of the main window, inside of the
Infobar , LottaNZB displays the amount of
free disk space that is left in the download folder. The value turns red if
there is not enough free disk space for all
Переконайтесь, щоб в ній завжди було достатньо вільного місця. Якщо вільне місце закінчиться, LottaNZB призупинить завантаження доки ви не звільните достатньо місця.
Зміна розташування теки завантаження
Якщо хочете завантажувати в іншу теку, відкрийте Правка Параметри Тека завантаження . Зміни набудуть сили негайно, але вже завершені завантаження не будуть переміщені до нової теки.
lottanzb-0.6/help/mallard/uk/figures/ 0000755 0001750 0001750 00000000000 11525760442 017517 5 ustar lantash lantash lottanzb-0.6/help/mallard/uk/figures/lottanzb-main-window.png 0000644 0001750 0001750 00000103634 11525760436 024323 0 ustar lantash lantash PNG
IHDR ( bKGD X pHYs ~ IDATxwx6{{/7BM". {"bC, `｠(E =$6 I@?ׅfggN=sΑF 5jpDDDDDDDD?Ͽ*E <3FL h%""""""t8"aɒ_~94r NrH"""""""o
I8 GO\!"""""""dp8HQ6@Pھ `0
BL&a BP[2X\.K˗EY~~<' \]hZ@P(IDDDDDDDWx< Gtr~yH0F!RBP*E&O ~8 n T|T"3a""""""d~0z3
[@MtߕJR#eeee@ ͟V M|||||"""""ZPH#wZ}r^41L&J}{("cBD4iy
E+jnyz^G9< 8p`\9999YYv.EoQ6 A@ J%Qr1 B,^
> p l6rwE7R>R)D&F("EKKf/߰ Hi{@YYe d@X N?t:NI8reeN'
i4&
u r9p,_};tdJ%0
֟Oc+1gNrssr"ߓnwg^ '';;++@iVyH4RH1'Pas\:%ٳ\ =bQD`߹s6`۶bщFSw>juzAgl
,[}{S駵kv 'gC cbj1#[nڴkPV&zjw+ ݺgd wBڽ{#݁
XđTT_^LTwNNga!6 8 \Ndet'={F#`2)0`pl""""""GQ꺙"
fv옝-%))II@QQqqII$pbX,kP7Ӣ-tZ<@}P(6kn݀4: @&ZV #wp^غa8㩪|> p8\. Dn %~t%%@( :X,@>=zTV? T/_STUV+۵kϞ@VVEŖ-<'
={铚
h"w
;w(aNtңN'2Pf 9Y M`eea!PVdBRIۇI"""""v(J\ 鼴1R %%EN /( RSSS4$A۷o߁e4_yM[RNLf2%' i:T*" _~z`^tFPbb>} HM5f(+ ﯪmjo!CnzJMol/
!W݁T^ ={6ovDLd| Q?p$
V t).*qk""""""A !5)).'))@qqIIiihM^ݏ_ꌶi-M-/:-m4ǣT!'% :p`m47Y[{ˁD Y': $$HHᆦE"F.ـ]l))LJ?"\hii] 99RH=6k~CJaضm'CJ
ЫW~f3
F#k0)^8ڵmukMM($-۶vڡ`&$Nj&46PDn]ov6urrSS DC!kjh[F&ኊ={ ;;t z6z}oj4* *zǎbKjHHHJ&"n ٹؽn y(DDDDDDu<3F 1:I[Qj
HKKKKM4)ii"uBz"PДXrHfZm ZO+W%%^ZGDDDDZ B@gq}9cj4 Ο<ʕ]L~Y̞EE@]4aO=L2e' Niz BMLh4jZ
NݢɎrUVǻΘ{_ i~jbL~ޘkop P[ ,_>cC|RVV
>> t\ OERT*^tU@ 6};|>/P@(
X3 > )IjtZ-`0l@0(ʣP(b8)/Z)\Vn~G |r 0.[nx{> p8DWa2JX/c2͢ :NMG_0T.W0X7W(rrgμVଳtyA`0}v=w
|yEű=U*Z- {<UUIOMM(TN@ =&fP;O*`Ȝ z裗_~e`P56
X`;TV< GQtv~eѷÑPetYYCfg:](p {|wq-p#|=
quWm!pW{% 99:
e2Q"k/8qto+*&W*VSlG v`zq`͛SRq }ۀ~4P*r9A.Dx[n? ?x~IF bcí@ h=ǏƯfzm C&xfh_` GʰـSO8b˷n-(71k x< z5Lx5"C}8t]w]yeRzSOML0a¤II }d :$'@sK8,T^ ?.tg֬q8ffr9Z,: 55wo: [&&N:uھׁ)S'XL.xڴo
j;~{nێG""""&r\&k L&塐x~x2zdHi`PG.) PZw67@zoDb9z] G ˖ C0T@ p`PBCB!./jk?䭷v8z9gOXܠd;À+2/JJ @@4ɔ0d: {%><@߾7/˗\.44\ǎRw.^ | 7o# v(5o8 B8lWjPA(//+JK+**+E9r+Ri4F\v xLgg[_^^Z*#MCI18$z:`ѢO>ٴ (*./v[73V7eOkHDDDD|RD)фG&ܵ (,T;0C رc D;>
^]XTWȑ&x#0va@LR~[pQ(G&O 9XǶntyѣ*j
XrTVm1:J& kj}X"w`4n߯RMv60yo p
JT2l;v n R:18ѣc 5F#p11-)W{ jjK{ᇁ>++h `HH rsG 7֧0x;Xعj~RUT,[?)nҊMxE.
Ͼo IH <IBV+0xqw\yeL ~bEm-
|uM7g0wmM \yΝ"ПfCNp9lr wJ*{ :TPHH@ ߯Vb nw~`ɓ'L &N0A z o}D_3
Nt2zW w/ow{\ z@yyE*Z
(h-*n+yf# <M+r:^/2d2@=wس22={|~״QZ{=|EIu ߿kWrL&nlT[z㏁[nNM;}U&q]wCSY/ =7o^. /p={sϢE 8p n`v3_{
=Z"ہ[^}?v }M۟JP~?mZ{ll! tZPŕ\7 K/3gdC-\|}c%}G kfn6fO0qbzY'{`ʔ%K>g{jo曁W_ 3` |
/=?p8DX.oGHJjzߵs<
)n"8q
IP\ou:e= ՆÜJCgL@N ~; R fxÁ3n=(#F< / }.Zt{ _0
i4@ǎ'Ϝ tSӦ-YtԱp'Mz avJDDDDUJ%5'cl@ZMxa 7Dۆcf +8rB8GM~lMKB_Ѭwy"DDDDD)n"7. k={[(DDDDDDDD#etܹsnn+CDDDDDDDoHqykCDDDDDDDo!Mr\1DDDDDDDD^x&J-ҥK WdڴSMx%M؉,Q#,1&""""""":: QlCDDDDDDD7Q2ѿp8 @iiiiq1x Bˁt &&&F|X;n\><WLT
ES+ܐDdzP(
vOtz/&h2ERnkjlZd2f7: \oDrRN8D@qEwӦM6mM
5Q鸞 O8 @M۽vmY,Z!܀DP( '@ӧ?V%P(
ښ* 11111Q'A 66...|>PU*Zܠh\DrGr8P,rCd:;rrrrrr-[nݶM'5-\zEM I(@0(N@ E NKD\vf9M$pR7*t99 ;rѓ(@ zg~{#"GkŊ+V84CDMw܍#YN< A 4-yӵ| ኊKӧN] GO.0%\2OJB ~n}t:]. 6666>>2
{BN@R駟y&Э^ߔՖ#RBz[w)bcsߕ!^v3@E.= 5kёY ?@ jNC>@ #nчJ4J\V*RV7w;vpӧ] 46HF/ ̘1z
(َ)Q ?8d`H 6P|۷/p3f W7m Νo7G 2DOJҹ3pɣGB@ZZl4|?!(5xD H!u^ }>O
Lbb :Mf;xpV`Ӧm JJv|` 23w7;˙!G:r&.Y&,=zg8,'x PQ"@U4 E% Ñu.M'>eKӋ@ P]]^UUeec0p|r`ٳ?XAM\+
b>sǏ08Nz{z~i&D&ILLLLLLdv|> ݱcNm s߾~yHMJM5(.v끥K5 wz= T3(DMfMx< &M:kB!@4cǞ~7}s~W_wB҉Fbbf 0@ 0֣,_ּy ~$%wuppݺt2U(OOH ?g y!ॗ֯e0Q 瞫֬6;.(8ͽ_xbہ >l0?/G : G ye;vlmH f4/ =)hF0ery8l4:]Qro w|~ڽ*f4ff
u( ϟ>ڼk|r>m
dN>&MӬV`۶gv7Mf 7.3Pō\q> yy2y̜9a퍯 ={}뭇 ֮mԍG 4πgzI`pP(Tׯorr zᇁ7cw>˽mۀW_}~nN_A| dd{g ;.PQvwk#Ggշ B7K r' ƆB^oKx9|> z9o t{NJՖ!2PaϮNX
ad3J>R IpOppXdI{(HPHD`[FFh11qq^TWVF q\p)=rW w 3 ̟?mNW? pm'`0 ^?̟?o +W nBv`0o@92Y(T[ ݛVg/ yf|/gz صI3ﾻ[7`pv@.OH5B=l55L^UUUUSTTTTTVD666&j41 /HO[+ ̒@ 6'#`y"pR*Tܸ`XccEyW\qo_vv:#ye%eʕ6C g9lXb"V^/ V+ןsΕWݻN's?|-yEg0xG.Lf4=z{UWݻBi|OOM9cGl6T*-(X _ (+KO 9HI5 9o# .:` d2m._.]ز%+ A@ p:= 4 8Imۖ.-[ =3:ut:U6o O=U jӦV^ 1qԨ sjyԨt1|>|εkիuZ`8\qhN w%oz9^nL}H
ES0| N\6rD D_E%57)$8dWG2Yݮ[? F7Ϝ9j 7rySG>n%#% .y[VHJj~
rMԭ۹3vΝ̙@nӦW
+*_n 0ہ' PX8b cK/͛r%нCz*Ծp W_䓲2ओM{
ࢋv5>n`={\1sIq\ I kMPDJٱzq4Z@OL Pˁk}A .l` %jz8 1cہKms:#J8l
i٬ш"2ݰ
`4&%%%VV+ qFV9"cHDEI~J/u+*T;|>, ~=+Ka㏇_"O>Qs#65-vd2Zcc%66= 8+&ଳƿ,ٺLzrj*8GzF(Z *BLݻz*USf
qceO=<`ݺxuM"t#]:qIO||XM|($ZT((a peU ' &\yI'VƦV?r@Oj;v1+ Z-_jC (+++}
NR
tJ8~=NJo9ݽ{ ??&W/ ;`{L{yy@Z0p`~YY, Zk4/{"PSrI瑶^NǜRi4&YbS(J& -(F. :w n}^H)ZJx",>kj
4_ = VjΝ;v|&ɔJ hjlz 8E.)v,-=> ?"Mj? "2B!1
t@0({B![J; jjDx4h/x^z%`Μ'^+tٵ x㍧5~D]f9M=Tͭ 4\6l$`n֯^z7-0߶9瞫jE=78x}Ww^Ϟbqqw@||Aڵ>߱9D@0zbL"CxKG(euOط6L
l=;v@|ɀRyHw8** d XPH.74% V(+sD%` ᪪v 8t)Wk֔Gj[Fc.C媭۴?-[ ;R(D,, )`"TU ~_/ҍbb"Hj.2I^ X_8:=u(ɴZ &FEUPpxLֺϢC-(ϯz}`FiMD( |հ O/e|`"aF87䡐++캯Fxčx i#R_)}(T"')7@FYL&%6o ? ظ~X``Ԓ4WDrZ
w xuꭷ}w`w{@G 7jkmێ =lWcS|Şa6 qqL&SNy1࣏
%Kzy 1gK.IM5;o_`Ѣ7`ժm HNV(ZgmyCNI.NN;Mp:5kʔ <^F
\9O?
qF||8 ۶>3f̛Y3h'h4 *^Xx?fUWGRD;,y8,'}& 2t:Qt8čk[>aˍƔCj^` =='G=4 %%=
ХբƁW ֮k18'(ÕWAƍ;v
EϞGiiH;*: Px6vi^h\yenR 55v˗ڵO
a.`h 5U},K`ǎKP*ccN}t$|6/k F))N'2:v?C#}71{z64-
і_4N=5E核A]bɒݻya扔UWWV M~ST$ ^"pXz/[fHJ,RSA)P"\:m*=6M9B6^dh59_Mۼeii)e? ~7 N9{&O_{I>{Ys33z
O&Sl,`2Y+Lt&Ho#iҼ"ЬׇB `2t҃sqG@Mͧ}70eh8~h&<^/`0M}2V{mr4gkgڧVk5555 Ym-t'Cx"a{Vge R[,ZGm?7v ݳ$:;xX8{w@VH':q V[Y lv0n'ʼncQ/Uj&X֭ V
{ JkϷ-De%mۦM{ eeΝ?{VT #F?r68 <`˖={
n-TVFr!d2@uSe ,W2SD] -?oT^o ;6j<O.~tT|e2@ 18P._X 8p**xvN''VkLB[@PH쏢C'xz^nXmwQ*^ILjj֯_ XvRZrKJD_VkϞ@߾))Z]Z->p_uUWW]u_ |p (*;v#!<&&;HKu6nSIn@@[WLu4XN8 55`9 v;p8bT'pp:E.ҐuD>= [u葚i+b{yy'i6VV:A UT 8**ݼر劍rrD 3όdPJnFecW j: ZbNJNGTht iB <(j)Mmme% "CEj#2K< ѷIH 'u3LRHHsmK㏗-ۼؿ(-õӢElۦV Zܒ\f9-W4rݻv | }T\rqz \DSn뮓N,x%য়JJ Z,XWvee{@m- zlzid2m&E.F^ ZdR ڬ V+RY?tժMOR)
ptQk7T?NwN4wN < =x晋.Ə6m7^zi< .n8${!/KJ|gΜ8Ɩ{}O=Ν;q"pek><0gmc$^듓OZʣjG83dxz¯Ptu3ÕB
|6MS|ے 8w=u"j8o`0kyGӏ31
Kos˖2
(11@#F\s
p%LG<%=so]dP`dimw獆0eʏ?γ4ଳ z詧kiM>OTu)$..66!Aeպ|JF*R꼴r22g[6+kP3ہ?ܼyjয়6l9AJ $$de
ݯ_nXjQw~? 4~#k@ǎuR2R?bD~k֬[ݢ meԨ3OL~Ҝr o֭^o `IG\ ; Rjܯ лw~+W~ݑ&2Je6ZR>
X{X.+bc23u:ǃ p} ֭]v-dɶmRN{99gOQdTUw߭['+.!N<0!e*Ԉ3 | O>icTSLH8 z{ /v"_N^E`a8
s4OpXaIdx Js ϑ@@|GѦ:u20aڴ}~T <~ yŦ4'z}ssD&p ~o ˗[,_̜yY"SнCˀn;fx~6ӀN*Q xuZ䘈N;u NFZ^Ot }ڕ:f puII9Zk˷^y{. ;vkmL{g ٧
),l|zIKM~aÆ}3)VGwxKcƼʣC҆CJ=h ژI)IҰ^tnT!JOr\QEt۰SEP6jމR JQJl}{)//++-33Wt}sN1SE ) z ,[/˗&xIm?H/R< lW g9'1QTL'=:lq&ǑnWl+x^/\w' >k^8s&p]b8/C :T:CE@nUW]|1pl7&P/ĞTI *6I$p`Pj $
G/']GI>HoˉǚW{]oJj8tTzh0(P}l H1UZߓ
ׇ{ -IXN~{Ѣe[5iN5C?bi$1>W&ɎT)}GEZљNPÍ/_.mȌFEJh(wJRc)ZÀE ƞdD;@^@5,EWeH 7mƎFRf=R8˃B ~>+*2.]ƌO8bں-ZMs[{^ty|(P|-뼳יh맭I')l2Y,WUK
a:h#0I7״9~ࡵuWV > (Y=v m瓆lZ CXͷO<'t J?JWix&iGixZn+\\\\\||'=EJQbD)c}3
to/͍ia)jC@{ձ|jz ~2D:D2S'' QkhQxT^J)3"DJ}[G{a$%Jt*%JkShnC4 m ț Q{iZyokRfw|dt NHOJʊ7M`tRnl61lqbb\.:q8NC4Z#>a u7jL@_`2PD+y~PfH^ 7 f@iפ40zE @z$z^* ƇzEj~fFQūFY^05 Qۑ7V%#=x0L& MvzїQHoFJ!@nX7LC' QS i/gR߿~Jc}H(u )PhbDDM9ZZ Ocf6|3~\.jR;//ڈuT
Fs-"/IHHLС۷nm5_"j
F ER4Mv)sU.ښHg
4l\tij D\R\eeeee%RmٲaR9uu@i+RWJ^o2q5E&"j[}ӻwN}8 j `0 f@iQx$
Ŗ^@SH
*=Hqޓx>ڻ ?E&Mq\.7 u3WZKpv;w v\.PP K o@ ԧ\Ì""""""":VZ-RZ*0X,a)ppW HJJNNM:tHNNNRR"KJM{L&l̟Z'x'n
$'fjD>އp8 G ;|>_ @(gd j6}%&jRS3222@ /"'"""""""job0&ЩS]|>&lD^59Wё1BDDDDDDD(DDDDDDDDQ0BDDDDDDD(DDDDDDDDQ0BDDDDDDD(DDDDDDDDQ0BDDDDDDD(DDDDDDDDQ0BDDDDDDD(DDDDDDDDQ0BDDDDDDD(DDDDDDDDQ0BDDDDDDD(DDDDDDDDQ0BDDDDDDD
BP]]YYY x<^
hNr\.gX#m `(**(~ 66&&66 7 ?,"e *JTFd2~EޫTJR^>ѱ)QT +
`0&n7t: G )H!""""""c(R<@d2r:fM&H_X@
[G @,?pH`0Fv:Nnv@Muss;uL/}r9Gr\.E>R u ɀp8pDMur\ RRBRRS3222"KK7E iQPN9P(
hcG8Q*J
HOΎJW^\^4?)SEZ Q{9 `2̀a; n\.2L23DD~IGߗ'e f
GDDDDDDDGy3HNNMMM4Q(
\t ے@H17Wfl6I(
GDDDDDDD(2L&j~[!"""""""j-r"""""""#c (
P` (
P` (
P` (
P` (
P` (
P` (
P` (
P8 J8 Àp8 r\W@i~Π }>e2 :tHNNIr\ބpM(
B@iiqqQn'$$&rQ; KdhZV `0 6> sizK#"""""""j/G @hD`#҄Gd&(JBD2L${sizk4:N
GDDDDDDD( :$%2\P vfG.1F
(, ////4}i~;t#""""""sMrrjjZt! .p `0
B!ݻgO$D\^~7/"""""""j)(q8"8 o'Ngdz8!""""""cCrhj)+a; ZVfϥ~_"""""""cr: l@TTHf>ODDDDDDDtyHӞ̬,@7L&q={s6!""""""㍲PH}JDDDDDDDt|cQ E
Q E
Q E
Q E
Q E
Q E
Q E
Q El.TTr\.Vkll\ `0Fc8TUUVP( N pDDDDDDD~Z-P5
0L&(++..*vfkee%%EEh2LFѨb`DDDDDDDZ-á L=66>>> (/yll\\||d~`0DKDDDDDDDZ O||BBb"PRRXXX"!5dHM~vL< NSSSSZh2@RRJJji +Dq8Z>6V| .)}V h4fC"n))P0(2N"\.q"}_ ѱl 0 GFQ5@ ^pnHNNKKO}"""""""cK 0Va z^WdB@JJZZZ'DDDDDDDtQׂfjzѩaንJJ!""""""QP\.ѷIYYIIi,xҒ}?Fh@bbrrR F#7 5&&6jmJ}l55@IIQQQөS܀DDDDDDDZ mZ@P(/R7+= u CPr ;- TjZ
$'qQ9 `4@nn]pѿ@!""""""""""""""(@!""""""""""""""(@!""""""""""""""(@!""""""""""""""(@!""""""""""""""(@!""""""""""""""(@!""""""""""""""(@!""""""""""""""(@!""""""""""""""(@!""""""""""""""(@!""""""""""""""(@!""""""""""""""(@!""""""""""""""(@!""""""""""""""(@!""""""""""""""(@!""""""""""""""(@!""""""""""""""(@!""""""""""""""(@!""""""""""""""(@!""""""""""""""(@!""""""""""""""(@!""""""""""""""(@!""""""""""""""(@!""""""""""""""(@!""""""""""""""(jo-[
ݷq?~&зo߾}F&bX,@mmmmm-`0X|>pz شiӦM d2^o"xrd@i5oh4r={VBў` `ί= n3{oɒ
+ nRBU^xm)/֬y3 wxZ>`짟 )SO?-(ue|>( JRTL< 77777#%ҫjZ@K\\\\\\d~ҫJR)z\ǛJ=!w}JS|@^ޏ?~{FӾ 3P /U~?۳y&M|@&\ `g]` .GF5:rW/`Ĉ_^ }P:w>\[4ɔ xȑ f$"z= ')ZVF RIyyyyy9PVVVVVdffffffl6 Q n
jFbrZK8t|OϚ '<8c$%EW\ ^t @UU0))]tp7pY@ǎzLx<۷*0yOZ\S'[^}ᇁN28 xv_jݺ j 1Osn曥zOӞ<> P\f' \@8,@ݻ ;i5Vv-2e `ɒ7F2^t:t\sÆZm[<)g}mÁ8 ;w; TZ-`0t4h-[p(8w[B~]
dJZ} ާ /,~?}>{ktc 0Blj@ 9s/c$`;0Z`,`Μ ;vfϞ&=iiiiii&7ߥ;ߥ<| N<4#E
=(()ϯ/^-[*+}>CN8ܷB!`NgOk `pVf͚? x x .HIΝx77Nrx<= }4}:˥Ç; Gkd*U|<е{_uUr2`0ݻv>kܹ[o-_~O !9si| Kox-+ٹj
@&j_x|>n7SO}Ӂ+ ùsxxY&#xToY j[_|"`6@.ʥK~HK8g \/z].`h>
|^/tرv-tw<ާ /,\X0cǦmEz?믁~O>oT138K/fkO;--
hj`ժ!`
jjp0N8k<.^ vO +V8
b4Ç? / 7ޘ_~_2kc#FwgQ(bc&N馆
~zϞ | ̞}`uXFJ
T*jX u%%|F#pӧ|2P@nn>ݻ@8 .WIh"P @RRbN'gGv |o$&^~̙{nr2SOL8 >Ӱa2ISZ h6Հاg Ç#vnw8,(8\-[ZRio}BSіryfիO23
֮] 8pॗ&O23'M3P(z. <+ z=0xQu@aZ%() )~?PT.W.ܓݷ&'+[!jR7hpso,XY\l l"f/L@Ϟ] /y/?Ygr }kW'",R* .x~͇ Fmڊz>W !r4w{<;w3urOϙ3kp=~;{WWW
dzg>h{wǎcO<1g/sLv!ﯨط1E[k2+Qss@˫9Rۺ@f+-`0 4 =x챗_~'Ǝvx^ >|?nu33ѣO^n\{W<0,˛;Pq:nU>/W V&}{Ϟ*+u%S}J P\ Ynt2|xn.Y澵(2Nffx^ 9m)"RAfSQ23}>"'pN_zF\.R> k32.8HKhn9@`ܸK.4HHHJz؍7\3~رر
\pkӺ' -ԱcNA_̀۽{ʕ@\\zN=
7 ^oII^ oSO]8 ]V֬ټUL -ꫧN=ϕO9v)~q k: :Çw\֣Ӫ1p]j `sw1 !aiӀ.]D( z
_~YׁO>YZDA
P* 0=}ذ;`(vWU6[(d2CsR:bEWNҫ}KVh
5{ bb^ʔJHMX `ժ2xr߳Zz TҀ+|' 9'>nnӧyfoy.23# Rh s i' n
U*@v (
Tv8'@\"dֺݢfAlYcy u~?J%еq;ѻ""[24F#eHKr| I i"ͱΓO7dpӦ )$ Ν;-o7 .8-:jb:$ફjJ}wZןu:QozE=a.H0XQYTTXCux) 0|ɏ<\vYVR GI eϟ̟ $'?@Ѻ
nKZ}aI
yĉF" 32 '@}djV dfzs͜9iPRf@Brz
Bs_r ߧOn~ s۶ˁ͛įrrnu֬gOi
??֮K/t mݷ V 夓M~w~X`い+||ڵoڱ#p
s,\ųg]۰7pp(/X:uRR' JT
>G@>+ o_nd4_u@Th @r8k| L&:Gt9N mOVc~p]~Yٮ]@ER dfZGJT*tbR骫'PZZU Cb /K&N=[w-^{mڴ3 ?7>aЈA@2Ct:NoP!IIIIIIWh4`0H&y zX导7?eݻ7֬ٻhz 0 HNn݊{݀T0x'TII} :yy6TVF dhfZcbbc݁a?ӀہݻE_ѵ^ZnuUd ~Xt gs<5 ;^~Z^w+ NTTeo z|!sr#}jq ֭YS[ t8|xvʫT(ֻΝyy@mnw:= u8JS\ 6wkj6o>w7m!C WY 3|8pէ ߴDAyQHuS\Aі߭depJ~=x [WT [~v ٳ h٧
/p ^
_QQSTV 8 J۱ X>_u5{'PYi6ggqq>Rx"p)qq{ |%%;w?V~>#G; +[,=z Æef|
+aܻ>N 0IDATt`~yek_EYj.Ki`~t""o2Baa U
| Wi Դ"?ǎ#;|o߉/ `u?<\@ ضm^HI;)RU7x7VہUc.(.{
>``w`KOY'y~&R1 uqш(P9v;`l@iG -Y99@v:Pk_>Xi;d*`0@t ƚ͇vz&t;uꫯmLF|M~E|e"KKߗOל<(+[ X&'>[7оV4߷ Vkv߿t{rH<:
>v,pŝ:i՚uߺu w,]iPII!&,_sg+W?fLzzsX· 7nh -M:Fx;} ; :# '~}j M9BJ_Ze2Kફo8୷{M,q:}]7tY&z Əﾫ,x So]YVSS3Θ2ǁM& --1{8x=i- Mt@FFc22-
3;ƍJJ^xa<bbz;w#
Y r
@~/.Z< w,X fsNgLt"YWX_Z,*U_z >h,,.ぅ RY,' {V+{A!"")!a"ӧO>}D I4lpm۶m۶-@ +`u==55@aY'V5h<_|]~Upf0 =B!صk] YTC!`>SWJKEY.X O9kN4sP1c x xww_Ly iՀ՚ֽ;p11GE"n~qo/>W(F 9k/uV_vY*ԗEnH[6kix!F#ЩO,X =m
7 6l$$ Rii:Mkb㽩N)-swB@yTWgg>нt5*ͻo:34P]o? 6z4q< (Cd l{VI 7S>q>,0m'[G#kk?~ʝȶy8!W7/⋯6mڴ鯿o曯>IllllllOic@ "-ҫwC4.,,,,.f ZO
dgsόW VTl :fd gݣGSqoo
b1#5jԨQNc>Mt$R&WdGj#}.#Pl6nbc>C~7>-'(DDDD1
4hw}w@J[;1cƌ'"&Pc&O喛oQtb(
P` (
P` (
P0?~BDDDDDDD~ce IENDB` lottanzb-0.6/help/mallard/uk/figures/lottanzb-logo.png 0000644 0001750 0001750 00000003404 11525760436 023024 0 ustar lantash lantash PNG
IHDR szz sBIT|d pHYs
B(x tEXtSoftware www.inkscape.org< tEXtTitle Contact NewdK? tEXtAuthor Lapo Calamandreiߑ* AIDATX]h\sܻ+v%b+I-JRj Oxྸ 6)!mi J1
~0zKM Y4&$Vr*KV+םi7Ziar`̜9?sG|&PR?g<3߶)L"K )%aP6WZF1UÑ#Gv ;v c Ǐ ĉ>} 0xL&C< }._L< ͛cbddFGGK_*\[8|p^(B&''y!J)ƈb377իWIRcHӬM8gY֥=kC100PvEz{{ By9x oߦV֜?
[ P G Ν;ekW\
cسgccc߿wގ֚nΜ9W 7ٳ:u
c Xh4J[[b1fff8w ׯ_cB=gd2/imm%HN-ZLI)ijj"
1??RjÙ֖ 244D2IJ,\q AJI 2Kuu5BۈFʘ}Bl Bd2TJm8 RayxC**c`)%UdBJI$ !x15EM]3m۶3Uo,"
?zq-(ζmY"Q
^
˲, kr\ s[oT hF18Y@GK M fn3h/ĀmeK)y]
+1Ek]Erid2 5>" hzZi|@/1mۥoO)oPk J}PJ3??_^ ! */2 B+Lk
Tsݻw訴X5`YVY͋^ҌzѣGRd2\u]~U:bg97o̦EGJ'sx k^)xPjzzػwoɓ'ihh8miXMyJ!9ov$[xeEr4pAk.۷,+noNruӀ-<{ )>y +6SZ;ǟ&<=C[x.ڻrD @"G˹w'-ш%B(
KE _\I Xq/ /9 G+ qD\J=_J}{w `O*K|:$fVd|:${^ iAUn. t/]CcQ !Fy { M
5o/߸qi9ɤ
Стеження та обмеження швидкості завантаження
Severin Heiniger
severinheiniger@gmail.com
2010
Команда розробників LottaNZB
Creative Commons Attribution-Share Alike 3.0
Швидкість завантаження
Швидкість, з якою файли завантажуються з Usenet показана в правому нижньому куті головного вікна, всередині Панелі даних .
Обмеження швидкості завантаження
By default, LottaNZB will download as fast as your Internet
connection and news server allows to. In order to prevent the downloads from
interfering with your other Internet activities, you can limit the
download speed. There are two different ways of doing that:
-
In the Infobar , click on the icon next to the
download speed. This opens a menu, allowing you to select one of the
predefined download speeds or removing the current limit.
-
If you want to specifiy a custom download speed, select
Edit Preferences Limit download speed
and enter the desired download speed in KiB/s right to it.
In both cases, the changes will take effect immediately.
lottanzb-0.6/help/mallard/uk/introduction.page 0000644 0001750 0001750 00000003367 11525760436 021446 0 ustar lantash lantash
1
Стислий вступ до LottaNZB
Severin Heiniger
severinheiniger@gmail.com
2010
Команда розробників LottaNZB
Creative Commons Attribution-Share Alike 3.0
Вступ
LottaNZB — програма, яка дає вам змогу завантажувати файли з Usenet.
Usenet — це всесвітньо розповсюджена система обговорення в Інтернеті, що виникла задовго до створення перших веб-сайтів. Поряд зі звичайними текстовими повідомленнями, користувачі також можуть публікувати файли зображень та відео, які спільно розподіляються на численні повідомлення.
Щоб спростити завантаження таких файлів, був винайдений формат файлів NZB . Такі NZB-файли створюються пошуковими рушіями Usenet та надають LottaNZB інформацію про файли, які будуть завантажуватись з Usenet.
lottanzb-0.6/help/mallard/uk/index.page 0000644 0001750 0001750 00000002362 11525760436 020026 0 ustar lantash lantash
<app>LottaNZB</app> Usenet Downloader
<app>LottaNZB</app> Usenet Downloader
Severin Heiniger
severinheiniger@gmail.com
2010
Команда розробників LottaNZB
Creative Commons Attribution-Share Alike 3.0
<media type="image" mime="image/png" src="figures/lottanzb-logo.png">
<app>LottaNZB</app> Logo</media> <app>LottaNZB</app> Usenet Downloader
lottanzb-0.6/help/mallard/uk/setting-up.page 0000644 0001750 0001750 00000007432 11525760436 021021 0 ustar lantash lantash
Необхідні кроки перед початком завантаження
Severin Heiniger
severinheiniger@gmail.com
2010
Команда розробників LottaNZB
Creative Commons Attribution-Share Alike 3.0
Налаштування <app>LottaNZB</app>
Передумови
Щоб розпочати роботу з LottaNZB потрібно:
-
Обліковий запис сервера новин , що надає доступ до Usenet. Існує велика кількість таких серверів за різною ціною та з різним терміном утримування . Термін утримування 500 днів означає, що файл буде вилучений через 500 днів після його відвантаження на сервер.
-
Пошуковий рушій Usenet , який дає змогу шукати файли в Usenet та завантажувати відповідні NZB-файли.
Перший запуск
Під час першого запуску програми, отримаєте запит, чи хочете ви завантажувати до свого комп’ютера, чи
-
Для завантаження файлів з Usenet, LottaNZB потребує програми SABnzbd . Якщо її не вдасться знайти в комп’ютері, отримаєте запит на її встановлення. Будь ласка, виконайте надані вказівки, щоб зробити це.
-
Потім, потрібно ввести дані зі свого облікового запису сервера новин.
Зазвичай, веб-сайт сервера новин містить для введення, адресу та номер порту. Залежно від сервера, можливе шифрування завантажуваних даних за допомогою SSL. У цьому випадку, активуйте відповідну незалежну кнопку.
В багатьох випадках, потрібно ввести ім’я користувача та пароль. Хоча деякі безкоштовні сервери, надають анонімний доступ і не вимагають імені та пароля.
Натискання кнопки Гаразд відкриє головне вікно, де ви зможете
Основне вікно LottaNZB
lottanzb-0.6/help/mallard/uk/observed-nzb-folder.page 0000644 0001750 0001750 00000002766 11525760436 022600 0 ustar lantash lantash
Автоматично додавати NZB-файли, знайдені в теці
Severin Heiniger
severinheiniger@gmail.com
2010
Команда розробників LottaNZB
Creative Commons Attribution-Share Alike 3.0
Тека для спостереження
LottaNZB може автоматично
Щоб вибрати цю теку, відкрийте в меню Правка Параметри Автоматично додавати NZB-файли з на вкладці Загальне .
Типово, буде вибрана тека, в яку завантажують файли веб-браузери.
lottanzb-0.6/help/mallard/uk/prefs-general-tab.page 0000644 0001750 0001750 00000002241 11525760436 022211 0 ustar lantash lantash
Налаштування процесу завантаження
Severin Heiniger
severinheiniger@gmail.com
2010
LottaNZB Команда розробників
Creative Commons Attribution-Share Alike 3.0
Загальні параметри
Вкладка Загальне дає вам змогу контролювати, як завантажуються файли з Usenet та, що з ними станеться після завантаження.
lottanzb-0.6/help/mallard/uk/post-processing.page 0000644 0001750 0001750 00000010103 11525760436 022046 0 ustar lantash lantash
Дії, що виконуються після завантаження всіх файлів
Severin Heiniger
severinheiniger@gmail.com
2010
Команда розробників LottaNZB
Creative Commons Attribution-Share Alike 3.0
Післяобробка
Після завантаження файлів, що належать до NZB-файла, LottaNZB виконає кілька дій під назвою після-обробка . Типово, після-обробка включає виправлення та розпакування завантажених файлів, що надає вам доступ до вмісту завантаженого без виконання додаткової роботи.
Протягом після-обробки, смужка поступу показуватиме 100%. Проте, під назвою завантаження, LottaNZB показуватиме, яка операція виконується та її поступ, наприклад: «Виправлення... (42%)» .
Після-обробка споживає багато ресурсів комп'ютера, що може спричинити затримку відповіді на ваші дії. LottaNZB намагається звести до мінімуму ці негативні наслідки.
Налаштування після-обробки
В меню Правка Параметри Після завантаження , щоб вибрати, які наступні дії будуть виконуватись протягом після-обробки. Ці дії виконуватимуться лише після виконання всіх дій, зазначених вище.
-
Виправлення
Перевіряє завантажені файли на помилки і якщо такі є, намагається виправити їх. Щоб таке виправлення працювало, завантаження має містити файли виправлення PAR , які будуть завантажені в разі необхідності. Це характерно для багатьох NZB-файлів, знайдених в пошукових рушіях Usenet.
-
Розпакування
Розпакування вмісту стиснутих завантажень. Для економії місця, великі файли в Usenet, зазвичай стискаються та розбиваються на кілька RAR-архівів .
-
Вилучення
Вилучення завантажених архівів після їх розпакування. Якщо розпакування виконано успішно, зазвичай, більше немає потреби в RAR-архівах.
Типово, виконуються всі дії, вказані вище. Щоб запобігти виконанню будь-якої з цих дій, виберіть Нічого не робити
lottanzb-0.6/help/mallard/uk/prefs.page 0000644 0001750 0001750 00000003244 11525760436 020036 0 ustar lantash lantash
Налаштування поведінки програми
Severin Heiniger
severinheiniger@gmail.com
2010
Команда розробників LottaNZB
Creative Commons Attribution-Share Alike 3.0
Параметри <app>LottaNZB</app>
Після налаштування LottaNZB , тобто, керування завантаженнями Параметри . Його можна відкрити через меню Правка Параметри
Програма SABnzbd , яка базується на LottaNZB , пропонує багато додаткових функцій. Щоб оглянути та змінити їх, потрібно Конфігурація .
lottanzb-0.6/help/mallard/uk/remote-access.page 0000644 0001750 0001750 00000010251 11525760436 021445 0 ustar lantash lantash
Керування завантаженнями іншого комп’ютера
Severin Heiniger
severinheiniger@gmail.com
2010
Команда розробників LottaNZB
Creative Commons Attribution-Share Alike 3.0
Віддалений доступ
Можливість керування завантаженнями іншого комп’ютера так само, як і завантаженнями до основного. Виникає багато ситуацій, коли це корисно:
-
Комп’ютер у вас вдома, завантажує файли і ви хочете керувати цими завантаженнями на відстані, з портативного комп’ютера.
-
Ви хочете дати змогу іншим людям в локальній мережі
-
Інший комп’ютер — фактично пристрій без екрана, наприклад Мережева система зберігання даних (NAS) .
Як правило, неможливо керувати завантаження вашого комп'ютера з будь-якого іншого, заради зберігання вашої приватності.
Вступ
Щоб безпечно використовувати віддалений доступ, виконайте наступні дії.
-
Увімкніть віддалений доступ в комп’ютері, що виконує завантаження вибравши в меню Правка Параметри Віддалений доступ та активуйте позначку Дозволити доступ з інших комп'ютерів . Щоб захистити віддалений доступ, рекомендується активувати позначку Вимагати автентифікацію та ввести ім’я та пароль.
Підтвердіть зміни закривши це вікно.
-
В комп’ютері, з якого ви хочете керувати завантаженнями:
-
Якщо LottaNZB запускається вперше, виберіть Керувати завантаженнями іншого комп’ютера в діалоговому вікні Почати завантаження .
-
Якщо ви вже користувались LottaNZB , виберіть Файл Контролювати інший комп’ютер...
Введіть назву або IP-адресу комп’ютера, завантаженнями якого хочете керувати. На запит, також введіть ім’я користувача та пароль. Натисніть кнопку Гаразд , щоб розпочати керування завантаженнями.
lottanzb-0.6/help/mallard/uk/news-servers.page 0000644 0001750 0001750 00000005056 11525760436 021365 0 ustar lantash lantash
Додати, змінити або вилучити сервери новин
Severin Heiniger
severinheiniger@gmail.com
2010
Команда розробників LottaNZB
Creative Commons Attribution-Share Alike 3.0
Сервери новин
Щоб додати, змінити або вилучити сервери новин, виберіть Правка Параметри Сервери .
Додавання та зміна серверів
Щоб змінити дані сервера, виберіть його та натисніть кнопку Змінити . Щоб додати новий сервер, натисніть Додати . В обох випадках, відкриється діалог, який дасть вам змогу вказати дані сервера. Зміни набудуть сили лише після натискання кнопки Гаразд .
Зазвичай, веб-сайт сервера новин містить для введення, адресу та номер порту. Залежно від сервера, можливе шифрування завантажуваних даних за допомогою SSL. У цьому випадку, активуйте відповідну незалежну кнопку.
В багатьох випадках, потрібно ввести ім’я користувача та пароль. Хоча деякі безкоштовні сервери, надають анонімний доступ і не вимагають імені та пароля.
Вилучення серверів
Щоб вилучити сервер, виберіть його та натисніть Вилучити . Звертаємо вашу увагу — ця дія незворотна.
lottanzb-0.6/help/mallard/uk/incomplete-downloads.page 0000644 0001750 0001750 00000010365 11525760436 023050 0 ustar lantash lantash
Завантаження, що все ще очікують завершення
Severin Heiniger
severinheiniger@gmail.com
2010
Команда розробників LottaNZB
Creative Commons Attribution-Share Alike 3.0
Незавершені завантаження
Якщо завантаження активне, час, що залишився, показується під назвою завантаження.
Призупинка завантажень
Активування кнопки Зупинити все на панелі інструментів або в меню Файл Зупинити все
Проте, щоб призупинити окреме завантаження, можна натиснути праву кнопку миші з вказівником на ньому і активувати позначку Пауза . В списку завантаження, воно буде показане сірим кольором. Пізніше, ви можете відновити таке завантаження, деактивувавши позначку Пауза знову.
Перейменування завантажень
Коли NZB-файл Властивості і змініть назву в полі Назва . Зміни набудуть сили негайно.
Завантаження не можна буде перейменувати в LottaNZB після завантаження всіх його файлів та початку
Вилучення завантажень
Будь-яке завантаження може бути скасоване шляхом натискання на панелі інструментів кнопки Вилучити або клавіші Delete . Ця дія незворотна і весь поступ завантаження буде втрачений.
Перевпорядкування списку завантажень
Завантаження виконуються одне за одним, тобто, завантаження розташовані внизу списку виконуються останніми. Ви можете перевпорядковувати список, перетягуючи завантаження на бажане місце. Як альтернатива, можна переміщати вибрані завантаження за допомогою кнопок зі стрілками на Панелі перевпорядкування ліворуч. Натискання найвище розташованої кнопки негайно розпочне завантаження.
lottanzb-0.6/help/mallard/uk/web-interface.page 0000644 0001750 0001750 00000006721 11525760436 021435 0 ustar lantash lantash
Керування завантаженнями через веб-браузер
Severin Heiniger
severinheiniger@gmail.com
2010
Команда розробників LottaNZB
Creative Commons Attribution-Share Alike 3.0
Веб-інтерфейс
Ви можете керувати завантаженнями через веб-браузер замість LottaNZB . Ця можливість надається програмою SABnzbd , що базується на LottaNZB . Цей веб-інтерфейс корисний в таких ситуаціях:
-
Ви хочете використовувати додаткову функцію, що пропонується веб-інтерфейсом і яка ще недоступна в LottaNZB . Крім того, це дає змогу детальніше налаштувати процес завантаження.
-
Ви хочете дистанційно керувати завантаженнями через пристрій, що не підтримує LottaNZB , наприклад: комп’ютер, що працює під іншою операційною системою або смартфон.
Інформацію про використання веб-інтерфейсу можна знайти на сторінці
Відкривання веб-інтерфейсу
Ви можете відкрити веб-інтерфейс через меню Файл Відкрити веб-інтерфейс
Як альтернатива, можете ввести адресу веб-інтерфейсу прямо в браузері. Під час завантаження до цього ж комп’ютера, ця адреса буде: localhost на назву або IP-адресу того комп’ютера.
Веб-інтерфейс на іншому комп’ютері можна відкрити лише, якщо увімкнутий
Якщо ви встановили ім’я та пароль для віддаленого доступу, отримаєте запрошення ввести їх.
Якщо ви часто використовуєте цей веб-інтерфейс, можете створити закладку в браузері, щоб отримати швидкий доступ до нього.
lottanzb-0.6/help/mallard/uk/searching-download-list.page 0000644 0001750 0001750 00000003171 11525760436 023437 0 ustar lantash lantash
Пошук завантажень в межах списку завантажень
Severin Heiniger
severinheiniger@gmail.com
2010
Команда розробників LottaNZB
Creative Commons Attribution-Share Alike 3.0
Пошук в списку завантаження
Якщо список завантаження містить багато
Ви можете вести пошук в списку завантаження просто розпочавши вводити назву завантаження, яке вас цікавить. Перше завантаження, що містить введене, негайно буде вибране.
Якщо список завершених завантажень стає задовгим, ви можете
lottanzb-0.6/help/mallard/uk/license.page 0000644 0001750 0001750 00000003772 11525760436 020347 0 ustar lantash lantash
Правова інформація
Ліцензія
Ця робота розповсюджується за умовами ліцензії Creative Commons Attribution-Share Alike 3.0.
Ви маєте право:
-
<em>Спільно використовувати</em>
Копіювати, розповсюджувати та передавати цю роботу.
-
<em>Створювати ремікси</em>
Адаптувати цю роботу.
За такими умовами:
-
<em>Із зазначенням авторства</em>
Ви повинні зазначати авторство в порядку, передбаченому автором або ліцензіатом (але не іншим способом, який припускає, що вони підтримують вас або ваше використання цієї роботи).
-
<em>Зі збереженням умов</em>
Якщо ви змінюєте, трансформуєте, або компонуєте свою роботу опираючись на цю, можете розповсюджувати похідну роботу лише за тією ж, аналогічною або сумісною ліцензією.
Повний текст цієї ліцензії дивіться на
lottanzb-0.6/help/mallard/uk/completed-downloads.page 0000644 0001750 0001750 00000003673 11525760436 022671 0 ustar lantash lantash
Завантаження, що не потребують подальших дій
Severin Heiniger
severinheiniger@gmail.com
2010
Команда розробників LottaNZB
Creative Commons Attribution-Share Alike 3.0
Завершені завантаження
Файли успішно завершених завантажень, можна знайти в
У випадку невдалого завантаження, під його назвою буде показане повідомлення з вказаною причиною помилки.
Очищення від завершених завантажень
З часом, список завантаження може стати задовгим. Натисніть кнопку Очистити завершені або виберіть в меню Файл Очистити завершені
lottanzb-0.6/help/mallard/uk/reporting-problems.page 0000644 0001750 0001750 00000002233 11525760436 022546 0 ustar lantash lantash
Якщо виникли проблеми, зв’яжіться з розробниками
Severin Heiniger
severinheiniger@gmail.com
2010
Команда розробників LottaNZB
Creative Commons Attribution-Share Alike 3.0
Звіт про проблеми
LottaNZB аж ніяк не досконала програма. Якщо ви зустрінетесь з будь-якими проблемами в програмі або в цій документації, команда розробників LottaNZB були б дуже вдячні вам, якби ви
lottanzb-0.6/help/mallard/uk/adding-downloads.page 0000644 0001750 0001750 00000007505 11525760436 022141 0 ustar lantash lantash
1
Додавання нових завантажень до списку
Severin Heiniger
severinheiniger@gmail.com
2010
Команда розробників LottaNZB
Creative Commons Attribution-Share Alike 3.0
Додавання завантажень
Ви можете додавати завантаження до LottaNZB отримуючи NZB-файл (зазвичай, з пошукових рушіїв Usenet) та відкривши його в LottaNZB , яка завантажить всі файли з Usenet, що перелічені в NZB-файлі.
Можна додавати NZB-файли кількома способами.
-
Вибір вручну
Виберіть один або кілька NZB-файлів розташованих на жорсткому диску натиснувши кнопку Додати на панелі інструментів або виберіть в меню Файл Додати файл...
-
Перетягування
Перетягніть один або кілька NZB-файлів до головного вікна LottaNZB .
-
Прив’язка файла
Клацніть на NZB-файлі у файловому менеджері. NZB-файли відкриваються за допомогою LottaNZB .
-
Завантажити з адреси
Введіть адресу NZB-файла в діалозі, що відкривається з меню Файл Додати адресу... LottaNZB завантажить цей NZB-файл.
-
<link xref="observed-nzb-folder">Автоматично, з теки для спостереження</link>
Нові NZB-файли, знайдені в цій теці, завантажаться автоматично.
Пошукові рушії Usenet, зазвичай вказують, скільки днів тому файли, перелічені в NZB-файлі були завантажені до Usenet. Будь ласка, переконайтеся, що час утримування вашого сервера не збіг, в іншому випадку LottaNZB не зможе завершити завантаження, тому що файли можуть бути вже вилучені з сервера.
Щойно додані завантаження, з’являються внизу списку завантаження за кілька секунд, це означає, що спочатку будуть завершені всі раніше додані завантаження, а лише потім розпочнеться щойно додане. Читайте тут, як LottaNZB .
lottanzb-0.6/lottanzb/ 0000755 0001750 0001750 00000000000 11525760442 014725 5 ustar lantash lantash lottanzb-0.6/lottanzb/util/ 0000755 0001750 0001750 00000000000 11525760442 015702 5 ustar lantash lantash lottanzb-0.6/lottanzb/util/regex.py 0000644 0001750 0001750 00000004451 11525760436 017375 0 ustar lantash lantash # Copyright (C) 2010-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import re
__all__ = ("IPv4_ADDRESS_PATTERN", "IPv6_ADDRESS_PATTERN", "HOST_NAME_PATTERN")
IPv4_ADDRESS_PATTERN = re.compile(r"""^
(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\.){3}
([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$""", re.VERBOSE)
# From http://forums.dartware.com/viewtopic.php?t=452
IPv6_ADDRESS_PATTERN = re.compile(r"""^(
(([0-9A-Fa-f]{1,4}:){7}([0-9A-Fa-f]{1,4}|:))|
(([0-9A-Fa-f]{1,4}:){6}(:[0-9A-Fa-f]{1,4}|((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3})|:))|
(([0-9A-Fa-f]{1,4}:){5}(((:[0-9A-Fa-f]{1,4}){1,2})|:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3})|:))|
(([0-9A-Fa-f]{1,4}:){4}(((:[0-9A-Fa-f]{1,4}){1,3})|((:[0-9A-Fa-f]{1,4})?:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|
(([0-9A-Fa-f]{1,4}:){3}(((:[0-9A-Fa-f]{1,4}){1,4})|((:[0-9A-Fa-f]{1,4}){0,2}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|
(([0-9A-Fa-f]{1,4}:){2}(((:[0-9A-Fa-f]{1,4}){1,5})|((:[0-9A-Fa-f]{1,4}){0,3}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|
(([0-9A-Fa-f]{1,4}:){1}(((:[0-9A-Fa-f]{1,4}){1,6})|((:[0-9A-Fa-f]{1,4}){0,4}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|
(:(((:[0-9A-Fa-f]{1,4}){1,7})|((:[0-9A-Fa-f]{1,4}){0,5}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:)))(%.+)?$""", re.VERBOSE)
HOST_NAME_PATTERN = re.compile(r"""^
(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*
([A-Za-z]|[A-Za-z][A-Za-z0-9\-]*[A-Za-z0-9])$""", re.VERBOSE)
lottanzb-0.6/lottanzb/util/gobject_extras.py 0000644 0001750 0001750 00000014616 11525760436 021272 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import gobject
import sys
from copy import deepcopy
from gobject import GObject as OriginalGObject, GObjectMeta # @UnusedImport
from gobject import property as gproperty # @UnusedImport
from gobject import list_properties
# Initializes the use of Python threading in the gobject module
gobject.threads_init()
__all__ = ["GObject", "GObjectMeta", "gproperty", "gsignal"]
def gsignal(name, *args, **kwargs):
"""
Add a GObject signal to the current object.
It current supports the types: str, int, float, long and object
@param name: name of the signal
@type name: string
@param args: types for signal parameters,
if the first one is a string "override", the signal will be
overridden and must therefor exists in the parent GObject.
@note: flags: A combination of;
- gobject.SIGNAL_RUN_FIRST
- gobject.SIGNAL_RUN_LAST
- gobject.SIGNAL_RUN_CLEANUP
- gobject.SIGNAL_NO_RECURSE
- gobject.SIGNAL_DETAILED
- gobject.SIGNAL_ACTION
- gobject.SIGNAL_NO_HOOKS
@note: retval: return value in signal callback
"""
frame = sys._getframe(1)
try:
locals = frame.f_locals
finally:
del frame
dict = locals.setdefault("__gsignals__", {})
if args and args[0] == "override":
dict[name] = "override"
else:
retval = kwargs.get("retval", None)
if retval is None:
default_flags = gobject.SIGNAL_RUN_FIRST
else:
default_flags = gobject.SIGNAL_RUN_LAST
flags = kwargs.get("flags", default_flags)
if retval is not None and flags != gobject.SIGNAL_RUN_LAST:
raise TypeError(
"You cannot use a return value without setting flags to "
"gobject.SIGNAL_RUN_LAST.")
dict[name] = (flags, retval, args)
class GObject(OriginalGObject):
"""GObject class which is better at converting values than the original.
When setting the value of a property, this class tries to convert the value
if necessary to prevent GObject from raising a TypeError. For example,
"True" is converted to True if the property should be a boolean.
Returns True if the new value differs from the old one, False otherwise.
"""
def set_property(self, key, value):
"""The class documentation says it all"""
value_type = self.get_property_type(key)
if not isinstance(value, value_type):
if value_type is int:
if value is None:
value = 0
else:
value = int(value)
elif value_type is bool:
if value in ("False", "0"):
value = False
elif value in ("True", "1"):
value = True
else:
value = bool(value)
elif value_type is float:
if value is None:
value = 0
else:
value = float(value)
elif value_type is str:
if value is None:
value = ""
else:
value = str(value)
old_value = self.get_property(key)
if old_value == value:
return False
else:
OriginalGObject.set_property(self, key, value)
return True
def __getitem__(self, key):
"""So that we can use brackets to access the properties"""
return self.get_property(key)
def __setitem__(self, key, value):
"""So that we can use brackets to access the properties"""
self.set_property(key, value)
def __iter__(self):
"""Does the same as the one of dictionaries"""
for key in self.keys():
yield key
def keys(self):
return [prop.name.replace("-", "_") for prop in list_properties(self)]
def values(self):
for key in self.keys():
yield self[key]
def items(self):
for key in self.keys():
yield key, self[key]
def update(self, properties):
for key in properties:
self[key] = properties[key]
def deep_copy(self):
return deepcopy(self)
def __deepcopy__(self, memo):
args = deepcopy(getattr(self, "__getinitargs__", lambda: [])(), memo)
result = self.__class__(*args)
for key in self.__dict__:
result.__dict__[key] = deepcopy(self.__dict__[key], memo)
for key in self.keys():
result.set_property(key, deepcopy(self.get_property(key), memo))
return result
def connect_async(self, event, handler, *args):
def new_handler(*new_args):
gobject.idle_add(handler, *new_args)
return self.connect(event, new_handler, *args)
@classmethod
def get_property_type(cls, key):
"""Returns the Python type of a certain object property"""
option_type = getattr(cls, key).type
if option_type in (gobject.TYPE_INT, gobject.TYPE_UINT,
gobject.TYPE_INT64, gobject.TYPE_UINT64):
return int
elif option_type is gobject.TYPE_BOOLEAN:
return bool
elif option_type in (gobject.TYPE_DOUBLE, gobject.TYPE_FLOAT):
return float
elif option_type is gobject.TYPE_STRING:
return str
else:
return object
@classmethod
def get_property_default_value(cls, key):
"""Returns the default value of a certain object property"""
return getattr(cls, key).default
lottanzb-0.6/lottanzb/util/timer.py 0000644 0001750 0001750 00000006365 11525760436 017411 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
from gobject import timeout_add
from lottanzb.util.gobject_extras import GObject, gproperty, gsignal
import collections
__all__ = ["Timer"]
class _TimerBase(GObject):
"""
Helper class for Timer.
"""
stopped = gproperty(type=bool, default=True)
timeout = gproperty(type=int, default=1000)
gsignal("tick")
def __init__(self, timeout):
GObject.__init__(self)
self.timeout = timeout
def stop(self):
"""
Stop the emission of the 'tick' signal.
"""
if not self.stopped:
self.stopped = True
def start(self):
"""
Start the regular emission of the 'tick' signal.
The Times class ensures thanks to the _TimerSequence helper class,
that it will exactly take the specific amount of time after this
method is invoked until the 'tick' signal is emitted.
"""
if self.stopped:
self.stopped = False
class _TimerSequence(_TimerBase):
"""
Helper class for Timer.
"""
def start(self):
"""
This is where the gobject.timeout_add is actually called.
"""
_TimerBase.start(self)
timeout_add(self.timeout, self.on_gobject_timeout)
def on_gobject_timeout(self):
if self.stopped:
return False
self.emit("tick")
return True
class Timer(_TimerBase):
"""
Wrapper for `gobject.timeout_add`, which is more object-oriented and
which provides the two convenient methods `start` and `stop`.
The timeout is the number of milliseconds between two emissions of the
'tick' signal. Optionally, it's possible to directly specify a handler
like using `gobject.timeout_add`.
"""
def __init__(self, timeout, handler=None, *args):
self.current_sequence = None
_TimerBase.__init__(self, timeout)
if isinstance(handler, collections.Callable):
self.connect("tick", handler, *args)
self.connect("notify", self.on_state_changed)
def on_state_changed(self, *args):
if self.current_sequence:
self.current_sequence.stop()
if self.stopped:
self.current_sequence = None
else:
self.current_sequence = _TimerSequence(self.timeout)
self.current_sequence.connect("tick", self.on_sequence_tick)
self.current_sequence.start()
def on_sequence_tick(self, *args):
self.emit("tick")
lottanzb-0.6/lottanzb/util/misc.py 0000644 0001750 0001750 00000005120 11525760436 017210 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import os
import sys
try:
import gnomevfs
except ImportError:
gnomevfs = None
__all__ = ["upper_ascii", "html_escape", "open_folder", "get_class_name",
"unique"]
ASCII_LOWERCASE = "abcdefghijklmnopqrstuvwxyz"
ASCII_UPPERCASE = "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
def upper_ascii(value):
"""
Returns a copy of value, but with lower case letters converted to
upper case.
Compared to the built-in string method `upper`, this function
is locale-independent and only turns ASCII letters to upper case.
"""
result = ""
for letter in value:
try:
result += ASCII_UPPERCASE[ASCII_LOWERCASE.index(letter)]
except ValueError:
result += letter
return result
def html_escape(string):
"""
Return a string with escaped HTML characters.
"""
string = string.replace('&', '&')
string = string.replace('"', '"')
string = string.replace("'", ''')
string = string.replace(">", '>')
string = string.replace("<", '<')
return string
def open_folder(path):
"""Open the given path with the file manager."""
if os.path.isfile(path):
path = os.path.dirname(path)
try:
gnomevfs.url_show("file://" + path)
except:
pass
def get_class_name(frame=None):
if frame is None:
frame = sys._getframe(1)
try:
class_name = frame.f_locals["self"].__class__.__name__
except KeyError:
class_name = None
return class_name
def unique(sequence):
"""Return copy of `sequence' with all duplicate items removed.
The order of the sequence is preserved. Only the first occurrence of every
item is kept.
"""
seen = {}
result = []
for item in sequence:
if item in seen:
continue
seen[item] = True
result.append(item)
return result
lottanzb-0.6/lottanzb/util/__init__.py 0000644 0001750 0001750 00000001267 11525760436 020024 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
lottanzb-0.6/lottanzb/util/threading_extras.py 0000644 0001750 0001750 00000005477 11525760436 021627 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import threading
from threading import Event, Thread as _Thread
from lottanzb.core.component import Component
from lottanzb.util.gobject_extras import GObject, gsignal
__all__ = ["Thread", "ThreadingComponent"]
class Thread(_Thread, GObject):
"""
Cancellable thread which uses gobject signals to return information to
the GUI.
"""
gsignal("completed")
gsignal("success")
gsignal("failure", object)
gsignal("progress", float)
def __init__(self):
_Thread.__init__(self)
GObject.__init__(self)
# As we can't handle exceptions directly within the thread, they are
# stored in this property.
self.error = None
self.thread_stopped = Event()
self.connect("completed", self.on_thread_completed)
def on_thread_completed(self, thread):
if thread.error:
self.emit("failure", thread.error)
else:
self.emit("success")
def stop(self):
"""
Threads in Python are not cancellable, so we implement our own
cancellation logic.
"""
self.thread_stopped.set()
def run(self):
"""
Method representing the thread's activity. Must be defined by
subclasses.
Example code:
while not self.thread_stopped.isSet():
...
self.emit("progress", x)
self.emit("completed")
"""
raise NotImplementedError
class ThreadingComponent(Component):
@property
def active_threads(self):
return threading.enumerate()
def stop_all_threads(self, block=False):
for thread in self.active_threads:
try:
thread.stop()
except:
pass
if block:
self.wait_for_all_threads()
def wait_for_all_threads(self):
for thread in self.active_threads:
try:
if thread is not threading.currentThread():
thread.join()
except:
pass
def unload(self):
self.stop_all_threads(True)
lottanzb-0.6/lottanzb/util/gtk_extras.py 0000644 0001750 0001750 00000010710 11525760436 020431 0 ustar lantash lantash # Copyright (C) 2010-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
"""Facilities making the use of GDK global lock more robust.
GTK+ is "thread aware" but not thread safe - it provides a global lock
controlled by gtk.gdk.threads_enter() and gtk.gdk.threads_leave() which
protects all use of GTK+. That is, only one thread can use GTK+ at any
given time.
However, this lock is not reentrant, meaning that when a thread tries to
acquire the lock twice, it will result in a deadlock. It needs to be taken
into consideration that GTK signal handlers are always executed with the lock
already acquired.
This module helps to ensure that the GDK global lock is acquired whenever
necessary, but no deadlocks occur.
`gtk_lock'
All code that makes use of the GTK API and may be run from something other
than a GTK signal handler (e.g. another thread or even a `gobject.idle_add'
handler in the main thread) must be run in this environment.
`gtk_lock.locked'
When registering a handler for a GTK signal, whereas the handler may also
be invoked without the signal being emitted, the handler should be wrapped
with this method, ensuring that `gtk_lock' is aware that the lock has
already been acquired.
Example:
>>> def some_signal_handler(*args):
... with gtk_lock:
... # Run some GTK code.
>>> my_widget.connect("some-signal", gtk_lock.locked(some_signal_handler))
>>> # ... and in some thread:
>>> some_signal_handler()
The code is based on the PyGTK FAQ entry provided by
Anton Fedorov :
http://faq.pygtk.org/index.py?file=faq20.015.htp&req=show
"""
import gtk
from inspect import stack
from threading import RLock, current_thread
from functools import wraps
from logging import getLogger
from lottanzb.util.misc import get_class_name
LOG = getLogger(__name__)
__all__ = ["gtk_lock"]
class GtkLock:
# If set, a debug message is emitted whenever the lock is acquired or
# released. Because this introduces a fairly heavy amount of debugging
# messages, it should not be enabled in production.
DEBUG = False
def __init__(self):
self._lock = RLock()
self._locked = 0
def __enter__(self):
self._lock.acquire(True)
self._locked += 1
if self._locked == 1:
gtk.gdk.threads_enter()
if self.DEBUG:
LOG.debug("Acquired GTK lock for thread %s in %s." % (
self._get_thread_identifier(current_thread()),
self._get_code_location(stack()[1])))
def __exit__(self, exc_type, exc_value, traceback):
if self._locked == 1:
gtk.gdk.threads_leave()
if self.DEBUG:
LOG.debug("Released GTK lock for thread %s in %s." % (
self._get_thread_identifier(current_thread()),
self._get_code_location(stack()[1])))
self._locked -= 1
self._lock.release()
@classmethod
def _get_code_location(cls, stack_element):
class_name = get_class_name(stack_element[0]) or ""
return "%s.%s:%i" % (class_name, stack_element[3], stack_element[2])
@classmethod
def _get_thread_identifier(cls, thread):
class_name = current_thread().__class__.__name__.strip("_")
try:
return "%s-%s" % (class_name, current_thread().name.split("-")[1])
except IndexError:
return class_name
def locked(self, f):
@wraps(f)
def wrapper(*args, **kwargs):
self._lock.acquire(True)
self._locked += 1
try:
return_value = f(*args, **kwargs)
finally:
self._locked -= 1
self._lock.release()
return return_value
return wrapper
gtk_lock = GtkLock()
lottanzb-0.6/lottanzb/util/signalmanager.py 0000644 0001750 0001750 00000014534 11525760436 021076 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
from threading import Lock
from lottanzb.util.gobject_extras import GObject
__all__ = ["SignalManager", "SwitchableSignalManager",
"SignalSynchronicityProvider"]
class SignalManager(dict):
"""
Manages the signal handlers used in GObject's signal system.
It makes it easier to disconnect one or several handlers without because
it's not necessary anymore to remember signal IDs, since `SignalManager`
takes care of this.
The object that wants to observe other objects should create a
`SignalManager` and use it to connect to a signal of another object
instead of directly invoking the other object's `connect` method.
"""
def __init__(self):
"""
Doesn't accept any arguments and hides the fact that `SignalManager` is
actually a dictionary.
"""
dict.__init__(self)
def connect(self, an_object, signal, handler, *args):
"""
Use this method to observe other objects instead of directly invoking
the other object's `connect` method.
"""
handlers = self.setdefault(an_object, {}).setdefault(signal, {})
if handlers.get(handler, None) is None:
handlers[handler] = an_object.connect(signal, handler, *args)
def disconnect_all(self):
"""Disconnects all handlers from their corresponding signal."""
for an_object in self.keys():
self.disconnect(an_object)
def disconnect(self, an_object, signal=""):
"""
Disconnects a handlers associated with a certain object.
It's also possible to limit the disconnection of handlers to a certain
signal of that particular object.
"""
signals = self.setdefault(an_object, {})
if signal:
signals = {
signal: signals.get(signal, {})
}
for handlers in signals.values():
for handler, handler_id in handlers.items():
if handler_id is not None:
an_object.disconnect(handler_id)
# Don't remove any namespaces (this is on purpose).
handlers[handler] = None
class SwitchableSignalManager(SignalManager):
"""
Disconnect and reconnect all events at once.
All handlers managed by this signal managers will only be connected to
their corresponding objects if the `enable` method has been called. You
can disconnect all handlers by invoking the `disable` method. Calling
the `connect` method will store the handler, but only connect it if the
the signal manager is `enabled`.
"""
enabled = False
def enable(self):
"""
Connect all registered handlers to their corresponding signals.
"""
if not self.enabled:
self.enabled = True
self.reconnect_all()
def disable(self):
"""
Disconnect all registered handlers from their corresponding signals.
All handlers will be remembered.
"""
if self.enabled:
self.enabled = False
self.disconnect_all()
def connect(self, an_object, signal, handler, *args):
"""
Stores the handler in the signal manager but only connects it to the
corresponding signal if the manager is enabled.
"""
handler_id = self.setdefault(an_object, {}).setdefault(signal,
{}).setdefault(handler, None)
if handler_id is None and self.enabled:
SignalManager.connect(self, an_object, signal, handler, *args)
def reconnect_all(self):
"""
Reconnect all handlers that have been previously registered and
possibly disconnected.
"""
for an_object, signals in self.items():
for signal, handlers in signals.items():
for handler, handler_id in handlers.items():
if handler_id is None:
handler_id = an_object.connect(signal, handler)
handlers[handler] = handler_id
class SignalSynchronicityProvider(GObject):
"""
Ensure that execution of signal handlers of all objects obeys the
temporal order of the signal registration. All signal handlers that are not
in temporal order are simply dropped.
Suppose you have a number of similar queries:
1, 2, 3, 4, 5, 6, 7, 8, 9, 10.
Suppose the queries are completed in the following order:
3, 1, 2, 4, 5, 8, 7, 6, 9, 10
This means that `SignalSynchronicityProvider` won't call the signal handlers
of queries 1, 2, 6, 7, but only the signal handlers of the following
queries, in this exact order:
3, 4, 5, 8, 9, 10.
"""
def __init__(self, signal_name, callback, *args):
self.signal_name = signal_name
self.callback = callback
self.args = args
self._counter = 0
self._lock = Lock()
self._obj_queue = []
self._signal_ids = {}
def connect(self, obj):
with self._lock:
signal_id = obj.connect(self.signal_name, self.on_signal, *self.args)
self._signal_ids[obj] = signal_id
self._obj_queue.append(obj)
def on_signal(self, obj, *args):
with self._lock:
try:
index = self._obj_queue.index(obj)
except ValueError:
return
else:
obj.disconnect(self._signal_ids.pop(obj))
self._obj_queue = self._obj_queue[index+1:]
self.callback(obj, *args)
lottanzb-0.6/lottanzb/config/ 0000755 0001750 0001750 00000000000 11525760442 016172 5 ustar lantash lantash lottanzb-0.6/lottanzb/config/hellanzb/ 0000755 0001750 0001750 00000000000 11525760442 017771 5 ustar lantash lantash lottanzb-0.6/lottanzb/config/hellanzb/servers.py 0000644 0001750 0001750 00000005202 11525760436 022036 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
# This import statement is necessary so that loading default HellaNZB
# configuration files doesn't raise an unwanted exception.
import logging
log = logging.getLogger(__name__)
from lottanzb.util.gobject_extras import gproperty
from lottanzb.config.section import ListConfigSection, ConfigSection
__all__ = ["Config", "ServerConfig"]
class Config(ListConfigSection):
def set_unknown_property(self, index, server):
# The default configuration file bundled with HellaNZB has a
# dummy server entry which is completely useless. That's why
# it's removed here.
if server.id == "changeme" and server.username == "changeme":
log.debug("Dummy server entry removed from HellaNZB configuration "
"file.")
else:
ListConfigSection.set_unknown_property(self, index, server)
def find_section_class(self, section):
return ServerConfig
class ServerConfig(ConfigSection):
id = gproperty(type=str)
username = gproperty(type=str)
password = gproperty(type=str)
address = gproperty(type=str)
port = gproperty(type=int)
antiIdle = gproperty(type=int, default=270, minimum=0)
idleTimeout = gproperty(type=int, default=30)
connections = gproperty(type=int, default=8, minimum=1)
ssl = gproperty(type=bool, default=False)
fillserver = gproperty(type=int, default=0, minimum=0)
enabled = gproperty(type=bool, default=True)
skipGroupCmd = gproperty(type=bool, default=False)
bindTo = gproperty(type=str)
def _get_hosts(self):
return ["{0.address}:{0.port}".format(self)]
def _set_hosts(self, hosts):
if hosts:
self.address, self.port = hosts[0].split(":")
else:
self.address = ""
self.port = 119
hosts = gproperty(type=object, getter=_get_hosts, setter=_set_hosts)
@property
def needs_authentication(self):
return bool(self.username and self.password)
lottanzb-0.6/lottanzb/config/hellanzb/music_types.py 0000644 0001750 0001750 00000002604 11525760436 022714 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
# This import statement is necessary so that loading default HellaNZB
# configuration files doesn't raise an unwanted exception.
from lottanzb.util.gobject_extras import gproperty
from lottanzb.config.section import ListConfigSection, ConfigSection
__all__ = ["Config", "MusicTypeConfig"]
class Config(ListConfigSection):
def find_section_class(self, section):
return MusicTypeConfig
class MusicTypeConfig(ConfigSection):
"""
Defines a music file type and whether or not HellaNZB should attempt to
decompress the music if it comes across this type of file.
"""
extension = gproperty(type=str)
decompressor = gproperty(type=str)
decompressToType = gproperty(type=str)
lottanzb-0.6/lottanzb/config/hellanzb/__init__.py 0000644 0001750 0001750 00000046614 11525760436 022120 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
"""
Contains classes that can be used to load, change and save HellaNZB
configuration files. It also contains default values, descriptions and
validation routines for all supported options.
"""
# This import statement is necessary so that loading default HellaNZB
# configuration files doesn't raise an unwanted exception.
import os
import logging
log = logging.getLogger(__name__)
from os.path import join, expanduser
from lottanzb.core.environ import _
from lottanzb.util.gobject_extras import gproperty
from lottanzb.util.misc import upper_ascii
from lottanzb.resources.xdg import DATA_HOME, USER_DIRS
from lottanzb.config.roots import LocalConfigRoot
from lottanzb.config.errors import InexistentOptionError
__all__ = ["HellaConfig"]
# The default HellaNZB data directory has been changed in order to adhere to
# the corresponding freedesktop.org standard. Existing users won't be affected.
_PREFIX_DIR = join(DATA_HOME, "hellanzb")
class Config(LocalConfigRoot):
"""
Makes it possible to load, change and save HellaNZB configuration files.
"""
_list_options = [
"keep_file_types",
"other_nzb_file_types",
"not_required_file_types"
]
prefix_dir = gproperty(
type = str,
default = _PREFIX_DIR,
nick = "Directory prefix",
blurb = "This property doesn't have any effect in stand-alone mode.")
queue_dir = gproperty(
type = str,
default = join(_PREFIX_DIR, "nzb", "daemon.queue"),
nick = "Queue directory",
blurb = "Queued NZB files are stored here.")
dest_dir = gproperty(
type = str,
default = USER_DIRS.get("XDG_DOWNLOAD_DIR", expanduser("~/Downloads")),
nick = "Download directory",
blurb = "Completed downloads go here. Depending on your "
"configuration, they will already be validated and "
"extracted.")
current_dir = gproperty(
type = str,
default = join(_PREFIX_DIR, "nzb", "daemon.current"),
nick = "Current download directory",
blurb = "The NZB file currently being downloaded is stored here.")
working_dir = gproperty(
type = str,
default = join(_PREFIX_DIR, "nzb", "daemon.working"),
nick = "Working directory",
blurb = "The archive currently being downloaded is stored here.")
postponed_dir = gproperty(
type = str,
default = join(_PREFIX_DIR, "nzb", "daemon.postponed"),
nick = "Directory containing postponed downloads",
blurb = "Archives interrupted in the middle of downloading are "
"stored here temporarily.")
processing_dir = gproperty(
type = str,
default = join(_PREFIX_DIR, "nzb", "daemon.processing"),
nick = "Processing directory",
blurb = "Archives currently being processed are stored here. It "
"may contain archive directories or symbolic links to "
"archive directories.")
processed_subdir = gproperty(
type = str,
default = "processed",
nick = "Directory containing processed files",
blurb = "Sub-directory within the NZB archive directory to move "
"processed files to.")
temp_dir = gproperty(
type = str,
default = join(_PREFIX_DIR, "nzb", "daemon.temp"),
nick = "Temporary storage directory")
max_rate = gproperty(
type = int,
nick = "Maximum download speed",
blurb = "Limit all server connections to the specified KB/s.")
state_xml_file = gproperty(
type = str,
default = join(_PREFIX_DIR, "nzb", "hellanzbState.xml"),
nick = "Location of HellaNZB's state file",
blurb = "This file is used to store HellaNZB's state when HellaNZB "
"isn't running. The state is intermittently written out as "
"XML to this file. It includes the order of the queue and "
"SmartPAR recovery information.")
debug_mode = gproperty(
type = str,
nick = "Debug log file",
blurb = "Log debug messages to the specified file.")
log_file = gproperty(
type = str,
default = join(_PREFIX_DIR, "log"),
nick = "Log file",
blurb = "Log output to the specified file. Set to None for no "
"logging.")
log_file_max_bytes = gproperty(
type = long,
nick = "Maximum log file size",
blurb = "Automatically roll over both log files when they reach "
"LOG_FILE_MAX_BYTES size.")
log_file_backup_count = gproperty(
type = int,
nick = "Number of log files to be backed up")
delete_processed = gproperty(
type = bool,
default = True,
nick = "Remove the PROCESSED_SUBDIR if the archive was "
"successfully post-processed",
blurb = "Warning: The normal LOG_FILE should be enabled with "
"this option - for a record of what HellaNZB deletes.")
cache_limit = gproperty(
type = str,
default = "0",
nick = "Maximum amount of memory used to cache encoded article "
"data segments",
blurb = "HellaNZB will write article data to disk when this cache "
"is exceeded."
"Available settings: -1 for unlimited size, "
"0 to disable cache (only cache to disk), "
"> 0 to limit cache to this size, in bytes, KB, MB, "
"e.g. 1024 '1024KB' '100MB' '1GB'.")
smart_par = gproperty(
type = bool,
default = True,
nick = "Download PAR files only if necessary",
blurb = "Damaged downloads can be repaired using recovery files. "
"Downloading them only if necessary can significantly "
"decrease the data to transfer.")
# Starting with LottaNZB 0.6, this module is only used to migrate existing
# HellaNZB configurations to SABnzbd configurations. This is why it doesn't
# matter what default values we chose for the following three options.
# No costly calls to distutils.spawn.find_executable are actually needed.
# SABnzbd even looks for 'unrar' and 'par2' exectables on its own.
skip_unrar = gproperty(
type = bool,
default = False,
nick = "Don't automatically extract downloads",
blurb = "Downloads regularly consists of compressed RAR archives. "
"HellaNZB can overtake the task of extracting the desired "
"files.")
unrar_cmd = gproperty(
type = str,
default = "",
nick = "Path to unrar command",
blurb = "The unrar application is used for automatic extraction of "
"downloaded files and is usually located in /usr/bin.")
par2_cmd = gproperty(
type = str,
default = "",
nick = "Path to the par2 command",
blurb = "The par2 application is used to check whether the "
"downloaded files are damaged or not and is usually located "
"in /usr/bin.")
umask = gproperty(
type = int,
nick = "Force umask",
blurb = "HellaNZB inherits the umask from the current user's "
"environment (unless it's running in daemon mode).")
max_decompression_threads = gproperty(
type = int,
default = 2,
nick = "Maximum number of files to decompress at the same time",
blurb = "Please note that extracting downloaded files is a "
"ressource-demanding task and your system might become "
"unresponsive if many of these processes are running at "
"the same time.")
xmlrpc_server = gproperty(
type = str,
default = "localhost",
nick = "XML RPC hostname",
blurb = "Hostname for the XML RPC client to connect to. Defaults "
"to 'localhost'.")
xmlrpc_password = gproperty(
type = str,
default = "changeme",
nick = "XML RPC password",
blurb = "You might probably never use this, but the command line "
"XML RPC calls do - it should definitely be changed from "
"its default value. The XML RPC username is hardcoded as "
"'hellanzb'.")
xmlrpc_port = gproperty(
type = int,
default = 8760,
minimum = 0,
maximum = 2 ** 16 - 1,
nick = "XML RPC port number",
blurb = "Port number the XML RPC server will listen on and the "
"client will connect to. None for no XML RPC server.")
xmlrpc_server_bind = gproperty(
type = str,
default = "127.0.0.1",
nick = "Bind XML RPC server to IP address",
blurb = "IP address on which the XML RPC server will be bound "
"to. '0.0.0.0' for any interfaces, '127.0.0.1' will "
"disable remote access.")
newzbin_username = gproperty(
type = str,
nick = "Newzbin.com username",
blurb = "Newzbin.com username for automatic NZB downloading")
newzbin_password = gproperty(
type = str,
nick = "Newzbin.com password",
blurb = "Newzbin.com password for automatic NZB downloading")
categorize_dest = gproperty(
type = bool,
default = True,
nick = "Categorize Newzbin.com downloads",
blurb = "Save archives into a sub-directory of DEST_DIR named after "
"their Newzbin.com category e.g. Apps, Movies, Music")
macbinconv_cmd = gproperty(
type = str,
nick = "Path to the optional macbinconv command",
blurb = "This command is used to convert MacBinary files.")
growl_notify = gproperty(
type = bool,
default = False,
nick = "Enable Mac OS X Growl notifications")
growl_server = gproperty(
type = str,
default = "IP",
nick = "Growl notification server")
growl_password = gproperty(
type = str,
default = "password",
nick = "Growl password")
libnotify_notify = gproperty(
type = bool,
default = False,
nick = "Enable libnotify daemon notifications")
disable_colors = gproperty(
type = bool,
default = False,
nick = "Disable ANSI color codes in the main screen",
blurb = "Preserves the in-place scroller.")
disable_ansi = gproperty(
type = bool,
default = False,
nick = "Disable ALL ANSI color codes in the main screen",
blurb = "For terminals that don't support ANY ANSI codes.")
nzb_zips = gproperty(
type = str,
default = ".nzb.zip",
nick = "Support extracting NZBs from ZIP files with this suffix "
"in QUEUE_DIR",
blurb = "Defaults to '.nzb.zip'. Set to False to disable. Case "
"insensitive.")
nzb_gzips = gproperty(
type = str,
default = ".nzb.gz",
nick = "Support extracting NZBs from GZIP files with this suffix "
"in QUEUE_DIR",
blurb = "Defaults to '.nzb.gz'. Set to False to disable. Case "
"insensitive.")
external_handler_script = gproperty(
type = str,
nick = "Optional external handler script",
blurb = "HellaNZB will run this script after having post-processed "
"a download.")
nzbqueue_mdelay = gproperty(
type = float,
default = 10.0,
nick = "NZB queue delay",
blurb = "Delay enqueueing new, recently modified NZB files added to "
"the QUEUE_DIR until this many seconds have passed since "
"the NZB's last modification time. Defaults to 10 seconds.")
keep_file_types = gproperty(
type = object,
nick = "File types to keep",
blurb = "Don't get rid of these file types when finished "
"post-processing. Move them to PROCESSED_SUBDIR instead. "
"Case insensitive.")
other_nzb_file_types = gproperty(
type = object,
nick = "Alternative NZB file extensions",
blurb = "List of alternative file extensions matched as NZB files "
"in the QUEUE_DIR. The 'nzb' file extension is always "
"matched.")
not_required_file_types = gproperty(
type = object,
nick = "Not required file types",
blurb = "If any of the following file types are missing from the "
"archive and cannot be repaired, continue processing "
"because they are unimportant. Case insensitive.")
servers = gproperty(type=object)
music_types = gproperty(type=object)
def __init__(self, config_file):
LocalConfigRoot.__init__(self, config_file, "lottanzb.config.hellanzb")
def __getattr__(self, key):
"""
Makes is possible to access the options using their uppercase
representation.
"""
if key.islower():
raise InexistentOptionError(self, key)
else:
return getattr(self, key.lower())
def __setattr__(self, key, value):
"""
Makes is possible to access the options using their uppercase
representation.
"""
if self.has_known_property(key.lower()):
self.set_property(key.lower(), value)
else:
self.__dict__[key] = value
def reset_object_options(self):
"""
Assigns meaningful initial values to properties of type 'object'.
GObject properties of type 'object' can't have default values.
"""
self.keep_file_types = ["nfo", "txt"]
self.other_nzb_file_types = []
self.not_required_file_types = [
"log", "m3u", "nfo", "nzb", "sfv", "txt"
]
def get_property(self, key):
"""
There are some HellaNZB configuration values which can be either
integer or string for example. This method ensures that those
properties are correctly saved.
"""
value = LocalConfigRoot.get_property(self, key)
none_keys = ["newzbin_username", "newzbin_password", "macbinconv_cmd"]
if key in none_keys and not value:
return None
elif key in ["nzb_zips", "nzb_gzips"] and value == "False":
return False
elif key == "cache_limit":
try:
return int(value)
except ValueError:
pass
return value
def _read(self, file_object):
"""
Loads the configuration data from the file object passed as an argument.
"""
self.servers.reset()
self.music_types.reset()
def defineServer(**kwargs):
self.servers.append(kwargs)
def defineMusicType(extension, decompressor, decompressType):
self.music_types.append({
"extension": extension,
"decompressor": decompressor,
"decompressType": decompressType
})
# Syntax sugar. *g*
Hellanzb = self # @UnusedVariable
# Unfortunately, `execfile` doesn't support file objects.
execfile(file_object.name)
# LottaNZB 0.5.2 used to fix various common problems in the
# configuration here such as the `skip_unrar` option as well as the
# SSL flags. Starting with LottaNZB 0.6, this module is only used to
# migrate existing HellaNZB configurations to SABnzbd configurations.
# This is why we leave it up to the SABnzbd configuration code
# to ensure the correctness.
def _write(self, file_object):
"""
Writes the configuration data to the file object passed as an argument.
"""
file_object.write("# -*- coding: utf-8 -*-\n")
file_object.write("# HellaNZB configuration file - Managed by "
"LottaNZB\n\n")
# Write the `defineServer` methods.
for server in self.servers.values():
options = dict(server)
del options["address"]
del options["port"]
if not options["username"]:
options["username"] = None
if not options["password"]:
options["password"] = None
args = ["%s=%s" % (key, repr(options[key])) for key in options]
file_object.write("defineServer(%s)\n" % ", ".join(args))
# Write the `defineMusicType` methods.
for music_type in self.music_types.values():
file_object.write("defineMusicType(%s, %s, %s)\n" % (
repr(music_type.extension),
repr(music_type.decompressor or None),
repr(music_type.decompressToType or None)))
# These preferences should be commented out 'if not value:'
deactivable = [
"external_handler_script",
"macbinconv_cmd",
"umask",
"unrar_cmd",
"debug_mode"
]
for key, value in self.get_options().items():
nick = getattr(self.__class__, key).nick
blurb = getattr(self.__class__, key).blurb
file_object.write("\n# " + nick + "\n")
if blurb:
file_object.write("# " + blurb + "\n")
if key in deactivable and not value:
file_object.write("# ")
# Don't use the locale dependent `upper` method of the key string.
# Fixes bug #318328.
file_object.write("Hellanzb.%s = %s\n" % \
(upper_ascii(key), repr(value)))
@property
def newzbin_support(self):
"""
Returns True if the configuration contains Newzbin credentials.
Please note that this doesn't mean that the credentials are valid.
"""
return bool(self.newzbin_username and self.newzbin_password)
@property
def remote_access(self):
"""
Returns True if the HellaNZB daemon can be accessed from other computers
on the network.
"""
return not self.xmlrpc_server_bind in ("127.0.0.1", "localhost")
lottanzb-0.6/lottanzb/config/section.py 0000644 0001750 0001750 00000065526 11525760436 020231 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import logging
LOG = logging.getLogger(__name__)
from threading import RLock
from lottanzb.util.gobject_extras import GObject, gsignal
from lottanzb.config.errors import (
InvalidOptionError,
InexistentOptionError,
OptionError
)
__all__ = ["ConfigSection", "ListConfigSection"]
class ConfigSection(GObject):
"""
Represents a configuration section and makes it possible to easily
validate its data.
Options can be stored as GObject properties, which means that they have
a certain type and a default value. You can also override the
set_property and get_property methods and add other custom methods.
Make a subclass called "Config" in the module where the configuration data
will be used, if the section name and the module name match, the config
module will be able to automatically apply it.
Subsections should be defined using "property(type=object)".
Lists should be defined identically, but should be listed in the
`_list_options` property or by using the name suffix "_list".
"""
# The `property-changed` signal is emitted whenever an option or subsection
# has been changed. Unlike the built-in `notify` event, it also covers
# options and subsections that have not been specified using the `gproperty`
# method.
# Please note that this signal propagates to all parents until the root of
# the configuration is reached.
# Arguments:
# object: The very `ConfigSection` that holds the changed property.
# object: The key of the changed property, most likely a string.
# object: The value of the changed property.
gsignal("property-changed", object, object, object)
# Emitted when an unknown property is removed from the configuration
# section. Has the same arguments as the `property-changed` signal.
gsignal("property-deleted", object, object, object)
# A list of the names of all object options that should be treated as
# lists. Since GObject doesn't allow custom types, it's not possible to
# use something like gproperty(type=list). Use gproperty(type=object) in
# combination with this list instead.
_list_options = []
# Is set to True as soon as the constructor has been completely executed.
# This means that all options passed to the constructor have been merged
# into the configuration section.
_initialized = False
def __init__(self, name, parent=None, options=None):
self._name = name
self._parent = parent
# Contains options and subsections that are not among the GObject
# properties in this configuration class.
self._unknown = {}
# All functions in this list are called before the value of an option
# is changed. The first argument is the option name and the second one
# the new value. They may be used for validation and can raise an
# InvalidOptionError. Otherwise a function must return the new value
# for the option.
# There are some predefined validation/conversion functions. But the
# this list can be extended by subclasses or from elsewhere using the
# `add_validation_function` method.
self._validation_functions = [
self._validate_dict,
self._validate_section_parent
]
# Contains a lock for each property.
# The thread-safety is far from guaranteed though.
self._locks = {}
GObject.__init__(self)
self.reset_object_options()
if options:
self.merge(options)
# FIXME: Deserves to be more elegant. ^^ Unfortunately GObject doesn't
# allow custom types such as ConfigSection or list, only object.
for key, value in self.get_options().items():
if not value and self.get_option_type(key) is object:
if key.endswith("_list") or key in self._list_options:
# Make sure that list options are never None.
self[key] = []
else:
# Seems to be a subsection.
self[key] = {}
self._initialized = True
def __eq__(self, other):
"""
Overrides Python's built-in mechanism used to test for equality of two
configuration sections. The section's parents may be different from
each other, but the section names and all options and subsections must
match.
"""
try:
return self is other or (\
self.get_name() == other.get_name() and \
self.get_sections() == other.get_sections() and \
self.get_options() == other.get_options()
)
except AttributeError:
return False
def __ne__(self, other):
"""
Checks if there are any differences between two configuration sections.
"""
return not self.__eq__(other)
def __contains__(self, key):
"""
Checks if there's an option or subsection with a certain name.
"""
return key in self.keys()
def __getinitargs__(self):
return [self._name]
def __repr__(self):
return "<%s %s>" % (self.__class__.__name__, self.get_full_name())
def __str__(self):
return str(self.to_dict())
def __getattr__(self, key):
"""
Called when accessing an option that hasn't been declared using
util.gproperty. Check if the option is among the unknown options and
return it.
"""
return self.get_unknown_property(key)
def __delitem__(self, key):
"""
Makes is possible to remove an option or section that hasn't been
declared using util.gproperty.
"""
self.delete_unknown_property(key)
def _get_lock(self, key):
if not key in self._locks:
self._locks[key] = RLock()
return self._locks[key]
def get_name(self):
"""Return the name of the section."""
return self._name
def get_parent(self):
"""Return the parent section."""
return self._parent
def keys(self):
"""
Returns a list of all option and subsection names in this configuration
section.
"""
return GObject.keys(self) + self.get_unknown_keys()
def get_option_type(self, key):
"""
Returns the type of a certain option.
If an option hasn't been declared using util.gproperty, it will
simply return the type of the actual value.
"""
try:
return self.get_property_type(key)
except AttributeError:
return type(self[key])
def add_validation_function(self, function):
"""
Registers a function that is called before the value of an option or
section is changed.
Refer to the `_validation_functions` property for more information.
"""
self._validation_functions.append(function)
def remove_validation_function(self, function):
"""
Does the opposite of the `add_validation_function` method.
Refer to the `_validation_functions` property for more information.
"""
self._validation_functions.remove(function)
def get_property(self, key):
"""
Get a certain option or subsection.
Raises a InexistentOptionError instead of a plain TypeError if the
option or subsection cannot be found.
"""
with self._get_lock(key):
try:
return GObject.get_property(self, key)
except TypeError:
# The option hasn't been declared using util.gproperty.
return self.get_unknown_property(key)
def set_property(self, key, value):
"""
Set the value of a certain option or a subsection.
Returns True if the new value differs from the old one, False otherwise.
"""
# Loop through all validation/conversion functions.
for validation_function in self._validation_functions:
value = validation_function(key, value)
changed = False
with self._get_lock(key):
try:
changed = GObject.set_property(self, key, value)
except ValueError:
raise InvalidOptionError(self, key)
except (TypeError, AttributeError):
changed = self.set_unknown_property(key, value)
if changed:
self.report_changed_property(key, value)
return changed
def has_known_property(self, key):
"""
Returns True if the option specified by `key` has been declared using
the `gproperty` method.
"""
try:
# We may not use `self.get_property` here because this would also
# work for unknown properties stored in `self._unknown`.
GObject.get_property(self, key)
except TypeError:
return False
else:
return True
def get_unknown_keys(self):
"""
Returns a list of keys of all options in this section that have not been
declared using the `gproperty` method.
"""
return self._unknown.keys()
def get_unknown_property(self, key):
"""
Return the value of an option specified by `key` that has not been
declared using the `gproperty` method.
Raises an `InexistentOptionError` if the option can not be found.
Do not call this method directly. It will be called by the
`get_property` method and can be overridden by subclasses.
"""
try:
return self._unknown[key]
except KeyError:
raise InexistentOptionError(self, key)
def set_unknown_property(self, key, value):
"""
Sets value of an option specified by `key` that has not been declared
using the `gproperty` method.
Do not call this method directly. It will be called by the
`set_property` method and can be overridden by subclasses.
Returns True if the new value differs from the old one, False otherwise.
"""
if self._unknown.get(key, object()) == value:
return False
else:
self._unknown[key] = value
return True
def delete_unknown_property(self, key):
"""
Deletes an option specified by `key` that has not been declared
using the `gproperty` method.
"""
try:
value = self[key]
del self._unknown[key]
except KeyError:
raise InexistentOptionError(self, key)
else:
self.report_deleted_property(key, value)
def move_unknown_property(self, source, dest):
"""
Moves an option or subsection that has not been declared using the
`gproperty` method to a new place.
This method may be used to rename options or subsection and/or move
them to other configuration sections. Please note that that they will
be removed from the old section.
The option or subsection to be moved can be specified using the first
argument. This may either be a string representing the name of an
option or subsection in the current section or a relative path.
The destination may either be a string, a relative path or another
configuration section.
"""
if isinstance(source, basestring):
source_parent = self
source_key = source
elif isinstance(source, list):
source_parent = self.get_by_path(source[:-1])
source_key = source[-1]
else:
raise ValueError("Invalid option source: %s", source)
value = source_parent.get_unknown_property(source_key)
if isinstance(dest, basestring):
self[source_key] = value
elif isinstance(dest, list):
self.set_by_path(dest, value)
elif isinstance(dest, ConfigSection):
dest[source_key] = value
else:
raise ValueError("Invalid option destination: %s", dest)
del source_parent[source_key]
def _report_property(self, signal_name, key, value):
section = self
while section is not None:
section.emit(signal_name, self, key, value)
section = section._parent
def report_deleted_property(self, key, value):
"""
Emits the signal `property-deleted` for a certain `key` on this section
and all of its parents.
"""
self._report_property("property-deleted", key, value)
def report_changed_property(self, key, value):
"""
Emits the signal `property-changed` for a certain `key` on this section
and all of its parents.
"""
self._report_property("property-changed", key, value)
def _validate_dict(self, key, value):
"""
Ensures that plain dictionaries are properly converted to objects of
ConfigSection or a subclass of it, given that it can be found.
"""
if isinstance(value, dict):
cls = self.find_section_class(key) or ConfigSection
value = cls(key, parent=self, options=value)
return value
# pylint: disable-msg=W0613
def _validate_section_parent(self, key, value):
"""
Ensures that subsections have the right parent reference.
"""
if isinstance(value, ConfigSection):
value._parent = self
return value
def merge(self, options):
"""
Merge the content of a dictionary-like object into the object.
Please note that this method tries to preserve existing ConfigSection
objects, so that references to them don't break.
"""
for key, value in options.items():
try:
assert isinstance(self[key], ConfigSection)
except (AssertionError, OptionError):
self[key] = value
else:
self[key].merge(value)
def get_sections(self):
"""Returns a dictionary containing all subsections of this section"""
sections = {}
for key in self:
value = self[key]
if isinstance(value, ConfigSection):
sections[key] = value
return sections
def get_options(self):
"""Returns a dictionary containing all options in this section"""
options = {}
for key in self:
value = self[key]
if not isinstance(value, ConfigSection):
options[key] = value
return options
def add_section(self, section):
"""
Adds an already created ConfigSection object to this configuration
section.
The `parent` property of `section` will be correctly set.
"""
self[section._name] = section
def apply_section_class(self, name, cls):
"""
Manually apply a custom ConfigSection class to this section.
This method is only meant to be used if this module's mechanism of
looking up custom ConfigSection classes won't be able to find it
automatically.
"""
if name in self.get_sections():
if self[name].__class__ is cls:
# The subsection is already an instance of this class.
# We've got nothing to do.
return
section = cls(name, parent=self, options=self[name])
else:
section = cls(name, parent=self)
self[name] = section
def get_by_path(self, path):
"""
Returns the value of a nested option based on its path.
The following two lines of code return the same:
config.get_by_path(["modes", "active"])
config.modes.active
Please note that calling `get_by_path([])` on a `ConfigSection` will
return the section itself.
"""
if path:
if len(path) == 1:
return self[path[0]]
else:
return self[path[0]].get_by_path(path[1:])
else:
return self
def set_by_path(self, path, value):
"""
Sets the value of a nested option based on its path.
The following two lines of code do the same:
config.set_by_path(["modes", "active"], "standalone")
config.modes.active = "standalone"
"""
self.merge(self.path_to_dict(path, value))
def create_path(self, path):
"""
Ensure that the passed path exists where the latest name in the path
will be an empty subsection.
"""
self.set_by_path(path, {})
def __deepcopy__(self, memo):
"""
Creates a deep copy of this section.
Please note that the section passed to `deepcopy` won't have a parent,
even if the original does. The parent is not copied.
The `_parent` property of all subsections will be set properly.
"""
memo.setdefault(id(self._locks), {})
memo.setdefault(id(self._parent), None)
# Work around Python bug #1515: deepcopy doesn't copy instance methods
# See http://bugs.python.org/issue1515 for more information
# Using Python <= 2.6, the process of deepcopying fails when trying to
# copy the `_validation_functions` list property.
# That's why the list content is excluded here.
for function in self._validation_functions:
memo[id(function)] = function
return GObject.__deepcopy__(self, memo)
def reset(self):
"""
Changes all options back to their default values and removes any unknown
options.
"""
self._unknown = {}
for option in self.get_options():
self[option] = self.get_property_default_value(option)
for section in self.get_sections():
self[section].reset()
self.reset_object_options()
def reset_object_options(self):
"""
Changes all object options (only lists at this point of time) to their
default values.
Subclasses are meant to override this method.
"""
pass
def get_path(self):
"""Returns a list of the names of all parent sections."""
sections = [self._name]
section = self
while section._parent is not None:
section = section._parent
sections.append(section._name)
sections.reverse()
return sections
def get_full_name(self):
"""Returns the complete section name"""
return self.path_to_name(self.get_path())
def get_depth(self):
"""Returns the number of parent sections"""
section = self
depth = 0
while section._parent is not None:
section = section._parent
depth += 1
return depth
def to_dict(self):
"""Returns a simple dictionary version of the config section."""
result = self.get_options()
for key, value in self.get_sections().items():
result[key] = value.to_dict()
return result
@staticmethod
def path_to_dict(path, value):
"""
Turns a path into a nested dictionary.
Example:
Config.path_to_dict(["modes", "active"], "standalone")
=> { 'modes' : { 'active' : 'standalone' } }
"""
path = path[:]
option = { path.pop(): value }
path.reverse()
for section in path:
option = { section: option }
return option
@staticmethod
def path_to_name(path):
"""Build a full section name out of a list of section names"""
return ".".join(map(str, path))
@staticmethod
def name_to_path(name):
"""Build a path out of a full section name."""
return name.split(".")
def find_section_class(self, section):
"""
Checks for a custom ConfigSection class based on the section's name.
If the section name is "modes.local_frontend" for example, it tries to
import the module with the same name and checks if it contains a
ConfigSection subclass called "Config".
Returns None if no matching class could be found.
"""
name = self.path_to_name(self.get_path() + [section])
try:
module = __import__(name, globals(), locals(), ["Config"], -1)
config_cls = module.Config
assert issubclass(config_cls, ConfigSection)
except (ImportError, AttributeError, AssertionError):
LOG.debug("Could not find configuration class '%s'.", name)
else:
return config_cls
class ListConfigSection(ConfigSection):
"""
Exposes the methods of a common `list` object and mimics its behaviour.
The most important difference is that clients of this class cannot iterate
over the list elements using
for element in list_config_section
The desired effect can be achieved using
for element in list_config_section.values()
Besides that it's possible to do anything that can be done with a regular
list: Access by index using `list_config_section[i]` etc.
"""
def __init__(self, name, parent=None, options=None):
self._list_items = []
ConfigSection.__init__(self, name, parent, options)
def get_unknown_keys(self):
"""
Returns a list of all keys of unknown properties and all indices used in
this section.
"""
indices = range(0, len(self._list_items))
return ConfigSection.get_unknown_keys(self) + indices
def get_unknown_property(self, key):
"""
Makes sure that the list elements can be accessed using their index, no
matter if it's a string or an integer.
"""
try:
return self._list_items[int(key)]
except ValueError:
return ConfigSection.get_unknown_property(self, key)
except IndexError:
raise InexistentOptionError(self, key)
def set_unknown_property(self, key, value):
"""
Makes sure that the list elements can be accessed using their index, no
matter if it's a string or an integer.
Returns True if the new value differs from the old one, False otherwise.
"""
try:
index = int(key)
# Make sure the name is an integer
value._name = index
if (len(self._list_items) == index):
self._list_items.append(value)
else:
self._list_items[index] = value
return True
except ValueError:
return ConfigSection.set_unknown_property(self, value, key)
except IndexError:
raise InvalidOptionError(self, key)
def delete_unknown_property(self, key):
try:
self.remove(self.get_unknown_property(key))
except ValueError:
ConfigSection.delete_unknown_property(self, key)
def __len__(self):
"""Returns the number of elements in the list."""
return len(self._list_items)
def reset(self):
"""Removes all elements from the list."""
self._list_items = []
ConfigSection.reset(self)
def append(self, value):
"""Add a new subsection to the end of the list."""
self[len(self._list_items)] = value
def extend(self, values):
"""Add an array of subsections to the end of the list."""
for value in values:
self.append(value)
def insert(self, index, value):
"""Insert a subsection at a certain index of the list."""
if index >= len(self._list_items):
self.append(value)
else:
tmp_value = self[index]
self._list_items.insert(index + 1, tmp_value)
self._update_subsection_names(index + 1)
self[index] = value
def remove(self, value):
"""Removes a certain subsection from the list."""
self._list_items.remove(value)
self._update_subsection_names()
self.report_deleted_property(value._name, value)
def pop(self, index=0):
"""
Removes the subsection with a certain index (defaults to 0) from the
list and returns it.
"""
value = self._list_items.pop(index)
self._update_subsection_names()
self.report_deleted_property(index, value)
return value
def index(self, value):
"""Returns the index of a certain subsection."""
return self._list_items.index(value)
def to_list(self):
"""Returns all items as a simple `list`."""
return self._list_items[:]
def _update_subsection_names(self, start_index=0):
"""
Internal method that is used to update the names of the subsection
instances when their index in the list has changed.
This is a little hackish an inefficient but it's hard to remove the
`_name` property from the `ConfigSection` class.
"""
for index in range(start_index, len(self._list_items)):
self[index]._name = index
lottanzb-0.6/lottanzb/config/roots.py 0000644 0001750 0001750 00000041131 11525760436 017715 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import re
import errno
import logging
LOG = logging.getLogger(__name__)
from os import makedirs
from os.path import dirname, isdir
from copy import deepcopy
from configobj import ConfigObj as _ConfigObj, ConfigObjError
# The `current_thread` property is only available in Python >= 2.6.
from threading import RLock, current_thread
from lottanzb.core.environ import _
from lottanzb.util.gobject_extras import gsignal
from lottanzb.config.section import ConfigSection
from lottanzb.config.errors import (
OptionError,
InexistentOptionError,
ConfigNotFoundError,
LoadingError,
SavingError,
ParsingError
)
__all__ = [
"ConfigRoot",
"RemoteConfigRoot",
"LocalConfigRoot",
"IniConfigRoot",
"IniPathConfigRoot",
"ConfigObjRoot"
]
class ConfigRoot(ConfigSection):
def __init__(self, target, name="", options=None):
ConfigSection.__init__(self, name, options=options)
self.target = target
def __getinitargs__(self):
return [self.target] + ConfigSection.__getinitargs__(self)
class RemoteConfigRoot(ConfigRoot):
def __init__(self, host, name="", options=None):
self.host = host
self._clean_config = None
self._merge_thread = None
self._merge_lock = RLock()
ConfigRoot.__init__(self, self.host, name, options=options)
def _get_clean_section(self, section):
return self._clean_config.get_by_path(section.get_path())
def do_property_changed(self, section, key, value):
"""
Carefully check if it's necessary to write the change in the
configuration back to the configuration host. If so,
`write_back_change` will be called.
A change only needs to be written back if it actually originates
from the user and not if originates from the configuration host
(as part of a merge operation). This is used to avoid useless queries.
"""
if self._initialized:
if self._merge_thread:
if self._merge_thread is not current_thread():
try:
clean_section = self._get_clean_section(section)
clean_section[key] = deepcopy(value)
except InexistentOptionError:
pass
self.write_back_change(section, key, value)
else:
self.write_back_change(section, key, value)
def do_property_deleted(self, section, key, value):
"""
Carefully check if it's necessary to write the deletion in the
configuration back to the configuration host. If so,
`write_back_deletion` will be called.
A deletion only needs to be written back if it actually originates
from the user and not if originates from the configuration host
(as part of a merge operation). This is used to avoid useless queries.
"""
if self._initialized:
if self._merge_thread:
if self._merge_thread is not current_thread():
try:
clean_section = self._get_clean_section(section)
clean_section.delete_unknown_property(key)
except InexistentOptionError:
pass
self.write_back_deletion(section, key, value)
else:
self.write_back_deletion(section, key, value)
def load(self):
raise NotImplementedError
def merge(self, config):
if isinstance(config, RemoteConfigRoot) and self.host == config.host:
self._merge_lock.acquire()
self._merge_thread = current_thread()
self._clean_config = config
try:
ConfigRoot.merge(self, config)
finally:
self._clean_config = None
self._merge_thread = None
self._merge_lock.release()
else:
ConfigRoot.merge(self, config)
def write_back_change(self, section, key, value):
"""
Write a change in the configuration back to the configuration host.
This method needs to be implemented by subclasses.
"""
raise NotImplementedError
def write_back_deletion(self, section, key, value):
"""
Write a deletion in the configuration back to the configuration host.
This method needs to be implemented by subclasses.
"""
raise NotImplementedError
def __deepcopy__(self, memo):
"""
Don't start deepcopying the configuration until a merge operation is
complete. Also, it's not possible to make a deepcopy of `Lock` objects.
This is taken care of by this method.
"""
with self._merge_lock:
memo[id(self._merge_lock)] = RLock()
return ConfigRoot.__deepcopy__(self, memo)
class LocalConfigRoot(ConfigRoot):
"""
Represents a configuration file and its data. This class provides various
abstract methods that need to be implemented by subclasses.
It takes care of raising standardized exceptions when something bad happens
while loading or saving the configuration data.
This class supports the usage of a configuration managers, as described
in the config.manager module.
"""
gsignal("save")
gsignal("load", str)
def __init__(self, config_file, name=""):
ConfigRoot.__init__(self, config_file, name)
self.config_file = config_file
# Set to True if the configuration has been changed but not saved yet.
# It's also set to True before the configuration has been loaded the
# first time.
self.is_dirty = True
self.connect("property-changed", self.on_config_changed)
self.connect("property-deleted", self.on_config_changed)
def load(self, custom_config_file=""):
"""
Loads the configuration data from the file specified in the
`config_file` property. Alternatively, it's possible to override it.
Subclasses are required to implement the `_read` method, which is
called by this method.
Emits the signal "load" and temporarily sets the `loading` property to
True.
Please note that this method does not reset any options or sections to
their default values. Users of this class may want to do that by
invoking the `reset` method on this section or selected subsections.
"""
config_file = custom_config_file or self.config_file
try:
file_object = open(config_file, "r")
except IOError as error:
if error.errno == errno.ENOENT:
raise ConfigNotFoundError(self)
else:
raise LoadingError(self, error.strerror)
else:
self.handler_block_by_func(self.on_config_changed)
self._read(file_object)
self.handler_unblock_by_func(self.on_config_changed)
self.is_dirty = False
self.emit("load", config_file)
def _read(self, file_object):
"""
Loads the configuration data from the file object passed as an argument.
Subclasses need to implement this method.
"""
raise NotImplementedError
def save(self):
"""
Saves the configuration to the file specified in the `config_file`
property.
Subclasses are required to implement the `_write` method, which is
called by this method.
Emits the signal "save".
"""
try:
# Make sure that the destination directory exists.
# Other wise, calling the `open` method will fail.
if not isdir(self.config_dir):
makedirs(self.config_dir)
LOG.info(_("Configuration directory %s created."),
self.config_dir)
file_object = open(self.config_file, "w")
except IOError as error:
raise SavingError(self, error.strerror)
self._write(file_object)
file_object.close()
LOG.info(_("Configuration file %s saved."), self.config_file)
self.emit("save")
def _write(self, file_object):
"""
Writes the configuration data to the file object passed as an argument.
Subclasses need to implement this method.
"""
raise NotImplementedError
def on_config_changed(self, *args):
"""Sets the `is_dirty' property."""
self.is_dirty = True
@property
def config_dir(self):
"""Return the directory in which the configuration file is located."""
return dirname(self.config_file)
class IniConfigRoot(LocalConfigRoot):
"""Abstract root configuration section that loads and saves INI-style
configuration files.
"""
def __init__(self, config_file, base_module=None):
name = base_module
if base_module is None:
name = self.path_to_name(self.__module__.split(".")[:-1])
elif isinstance(base_module, list):
name = self.path_to_name(base_module)
LocalConfigRoot.__init__(self, config_file, name)
class IniPathConfigRoot(IniConfigRoot):
"""Root configuration section that loads and saves INI-style
configuration files.
Section nesting is achieved using paths, as seen in the following example.
[gui]
[gui.main]
"""
OPTION_PATTERN = re.compile(
r"(?P[^:=\s][^:=]*?)" # Very permissive!
r"\s*(?P[:=])\s*" # Any number of space/tab, followed by a
# separator (either : or =), followed by
# any space/tab
r"(?P.*)$") # Everything up to the end of the line
def get_sections_flat(self, section=None):
"""Return a list of all sections of any depth.
The configuration root section is not included in the list.
"""
if section is None:
section = self
result = []
else:
result = [section]
for sub_section in section.get_sections().values():
result.extend(self.get_sections_flat(sub_section))
return result
def _write(self, file_object):
options = self.get_options()
for section in self.get_sections_flat():
relative_path = section.get_path()[1:]
options[self.path_to_name(relative_path)] = section.get_options()
config = ConfigObj()
config.merge(options)
for section in config.sections:
config.comments[section] = [""]
config.write(file_object)
def _read(self, file_object):
lines = self._to_config_obj_format(file_object.readlines())
try:
config = ConfigObj(lines)
config.filename = file_object.name
except ConfigObjError as error:
error = error.errors[0]
raise ParsingError(self, error.line_number, error.message)
for option_name in config.scalars:
try:
self[option_name] = config[option_name]
except OptionError as option_error:
LOG.warning(str(option_error))
for section_name in config.sections:
path = self.name_to_path(section_name)
options = config[section_name].dict()
try:
self.set_by_path(path, options)
except OptionError as option_error:
LOG.warning(str(option_error))
@classmethod
def _to_config_obj_format(cls, lines):
"""Transform the lines of a configuration file to the ConfigObj syntax.
Previous versions of this class used multi-line options to store list
values, such as:
categories =
Foo
Bar
Not being valid ConfigObj syntax, this option needs to be transformed to
categories = Foo, Bar
"""
result = []
index = 0
while index < len(lines):
line = lines[index]
match = cls.OPTION_PATTERN.match(line)
index += 1
if match and match.group("value") == "":
option = match.group("option")
items = []
while index < len(lines) and lines[index].startswith("\t"):
items.append(lines[index][1:-1])
index += 1
# TODO: ',' is not escaped by putting '"' around such an item.
result.append("%s = %s\n" % (option, ", ".join(items)))
else:
result.append(line)
return result
class ConfigObjRoot(IniConfigRoot):
"""Root configuration section that loads and saves INI-style
configuration files according to the ConfigObj format.
Section nesting is achieved using multiple opening and closing square
brackets, as seen in the following example.
[gui]
[[main]]
"""
# The `ConfigObj' object stored between a reading and writing operation,
# helping to preserve the appearance of existing configuration files.
_config_obj = None
def _read(self, file_object):
try:
self._config_obj = ConfigObj(file_object)
except ConfigObjError as error:
error = error.errors[0]
raise ParsingError(self, error.line_number, error.message)
self.merge(self._config_obj.dict())
def _write(self, file_object):
if not self._config_obj:
self._config_obj = ConfigObj()
# ConfigObj represents boolean values as 'True' and 'False' in the
# configuration file. This format is however not recognized when loading
# such a configuration file using SABnzbd. All boolean values will
# default to False. SABnzbd seems to expect 0 for False and 1 for True.
# This is why the configuration is transformed before being saved.
def transform_config_dict(section_dict):
for key, value in section_dict.items():
if isinstance(value, dict):
transform_config_dict(value)
elif isinstance(value, bool):
section_dict[key] = int(value)
config_dict = self.to_dict()
transform_config_dict(config_dict)
self._config_obj.merge(config_dict)
self._config_obj.write(file_object)
class ConfigObj(_ConfigObj):
"""Version of `configobj.ConfigObj' with minor modifications.
The method `merge' will cause new scalars and sections to be added
in alphabetical order, rather than randomly. The order of existing items
is not affected.
"""
def merge(self, options):
self._merge_helper(self, options)
def _merge_helper(self, section, options):
for option in sorted(options.keys()):
if isinstance(options[option], dict):
section[option] = {}
# `sub_section' will be of type `configobj.Section'.
sub_section = section[option]
self._merge_helper(sub_section, options[option])
else:
section[option] = options[option]
def __deepcopy__(self, memo):
result = memo.setdefault(id(self), ConfigObj())
for key in self.__dict__:
result.__dict__[key] = deepcopy(self.__dict__[key], memo)
return result
lottanzb-0.6/lottanzb/config/errors.py 0000644 0001750 0001750 00000006464 11525760436 020075 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
"""
Common errors for the `config` module.
"""
from lottanzb.core.environ import _
__all__ = [
"OptionError",
"InexistentOptionError",
"InvalidOptionError",
"ConfigError",
"LoadingError",
"ConfigNotFoundError",
"ParsingError",
"SavingError"
]
class OptionError(Exception):
"""Raised if there is a problem accessing or changing an option"""
def __init__(self, section, option):
self.section = section
self.option = option
Exception.__init__(self)
class InexistentOptionError(OptionError, AttributeError, IndexError, KeyError):
"""Raised when trying to access an option that doesn't exist"""
def __init__(self, section, option):
OptionError.__init__(self, section, option)
AttributeError.__init__(self)
IndexError.__init__(self)
KeyError.__init__(self)
def __str__(self):
return _("Invalid option '%s' in section '%s'.") % \
(self.option, self.section.get_full_name())
class InvalidOptionError(OptionError, ValueError):
"""Raised when trying to assign an invalid value to an option"""
def __init__(self, section, option):
OptionError.__init__(self, section, option)
ValueError.__init__(self)
def __str__(self):
return _("Invalid value for option '%s' in section '%s'.") % \
(self.option, self.section.get_full_name())
class ConfigError(Exception):
"""Raised when a configuration file cannot be loaded or saved."""
def __init__(self, config_root, message=""):
self.config_root = config_root
if message:
self.message = message
Exception.__init__(self)
class LoadingError(ConfigError):
"""Raised when a configuration file cannot be loaded."""
def __str__(self):
return _("Unable to load the configuration file %s: %s") % \
(self.config_root.config_file, self.message)
class ConfigNotFoundError(LoadingError):
"""Raised when a configuration file cannot be found."""
message = _("File not found.")
class ParsingError(LoadingError):
"""Raised when a configuration file does not follow legal syntax."""
def __init__(self, config_root, line_no, message):
message = _("Syntax error on line %i: %s") % (line_no, message)
LoadingError.__init__(self, config_root, message)
class SavingError(ConfigError):
"""Raised when a configuration file cannot be saved."""
def __str__(self):
return _("Unable to save the configuration file %s: %s") % \
(self.config_root.config_file, self.message)
lottanzb-0.6/lottanzb/config/sabnzbd/ 0000755 0001750 0001750 00000000000 11525760442 017615 5 ustar lantash lantash lottanzb-0.6/lottanzb/config/sabnzbd/newzbin.py 0000644 0001750 0001750 00000002172 11525760436 021650 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
from lottanzb.config import ConfigSection
from lottanzb.util.gobject_extras import gproperty
class Config(ConfigSection):
username = gproperty(type=str)
bookmark_rate = gproperty(type=int, default=60, minimum=60)
bookmarks = gproperty(type=bool, default=False)
password = gproperty(type=str)
unbookmark = gproperty(type=bool, default=True)
# Available in SABnzbd >= 0.5.4.
https = gproperty(type=bool, default=True)
lottanzb-0.6/lottanzb/config/sabnzbd/categories.py 0000644 0001750 0001750 00000004237 11525760436 022325 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
from lottanzb.core.environ import _
from lottanzb.util.gobject_extras import gproperty
from lottanzb.core.constants import Priority
from lottanzb.config.sabnzbd import ListConfigSection, ListElementConfigSection
class Config(ListConfigSection):
def reset_object_options(self):
categories = {
"misc": _("Miscellaneous"),
"tv": _("TV"),
"unknown": _("Unknown"),
"resources": _("Resources"),
"apps": _("Apps"),
"movies": _("Movies"),
"consoles": _("Consoles"),
"books": _("Books"),
"games": _("Games"),
"anime": _("Anime"),
"music": _("Music"),
"pda": _("PDA"),
"emulation": _("Emulation")
}
for key, value in categories.items():
self.append({
"name": key,
"newzbin": key.capitalize(),
"dir": value
})
def find_section_class(self, section):
return CategoryConfig
class CategoryConfig(ListElementConfigSection):
name = gproperty(type=str)
newzbin = gproperty(type=str)
priority = gproperty(type=int, default=Priority.NORMAL)
pp = gproperty(type=str)
dir = gproperty(type=str)
script = gproperty(type=str, default="Default")
def get_identifier(self):
return self.name
def set_identifier(self, identifier):
self.name = identifier
lottanzb-0.6/lottanzb/config/sabnzbd/rss.py 0000644 0001750 0001750 00000001410 11525760436 020775 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
from lottanzb.config import ConfigSection
class Config(ConfigSection):
pass lottanzb-0.6/lottanzb/config/sabnzbd/logging.py 0000644 0001750 0001750 00000002404 11525760436 021620 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
from lottanzb.config import ConfigSection
from lottanzb.util.gobject_extras import gproperty
class Config(ConfigSection):
# TODO: Should this configuration option ever be used by the rest of the
# application, an integer like 5*2**20 would be more suitable for storing
# the value.
max_log_size = gproperty(type=str, default="5M")
log_level = gproperty(type=int, default=0)
log_backups = gproperty(type=int, default=5, minimum=1, maximum=2 ** 10)
log_new = gproperty(type=bool, default=False)
enable_cherrypy_logging = gproperty(type=bool, default=False)
lottanzb-0.6/lottanzb/config/sabnzbd/servers.py 0000644 0001750 0001750 00000004057 11525760436 021671 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
from lottanzb.util.gobject_extras import gproperty
from lottanzb.config.sabnzbd import ListConfigSection, ListElementConfigSection
class Config(ListConfigSection):
def find_section_class(self, section):
return ServerConfig
class ServerConfig(ListElementConfigSection):
username = gproperty(type=str)
password = gproperty(type=str)
host = gproperty(type=str)
port = gproperty(type=int, default=119, minimum=0, maximum=2 ** 16 - 1)
enable = gproperty(type=bool, default=True)
fillserver = gproperty(type=bool, default=False)
connections = gproperty(type=int, default=6, minimum=0, maximum=100)
ssl = gproperty(type=bool, default=False)
timeout = gproperty(type=int, default=120, minimum=30, maximum=240)
optional = gproperty(type=bool, default=False)
def set_identifier(self, identifier):
# Don't use `str.split' as IPv6 host addresses contain ':'.
host, separator, port = identifier.rpartition(":") # @UnusedVariable
if port:
self.host = host
self.port = port
else:
raise ValueError("Expected an identifier of type 'host:port', "
"got %r" % identifier)
def get_identifier(self):
return "%s:%s" % (self.host, self.port)
@property
def needs_authentication(self):
return bool(self.username and self.password)
lottanzb-0.6/lottanzb/config/sabnzbd/nzbmatrix.py 0000644 0001750 0001750 00000001734 11525760436 022215 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
from lottanzb.config import ConfigSection
from lottanzb.util.gobject_extras import gproperty
class Config(ConfigSection):
username = gproperty(type=str)
apikey = gproperty(type=str)
# Available in SABnzbd 0.6 and newer.
del_bookmark = gproperty(type=bool, default=True)
lottanzb-0.6/lottanzb/config/sabnzbd/misc.py 0000644 0001750 0001750 00000023017 11525760436 021130 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import locale
from os.path import expanduser, join
from lottanzb.core.constants import DefaultPortNumber, Priority, PostProcessing
from lottanzb.core.environ import _
from lottanzb.config import ConfigSection
from lottanzb.util.gobject_extras import gproperty
from lottanzb.resources.xdg import DATA_HOME, USER_DIRS
# The default SABnzbd data directory has been changed in order to adhere to
# the corresponding freedesktop.org standard. Existing users won't be affected.
_PREFIX_DIR = join(DATA_HOME, "sabnzbd")
_DOWNLOAD_DIR = USER_DIRS.get("XDG_DOWNLOAD_DIR", \
expanduser(join("~", _("Downloads"))))
_INCOMPLETE_DIR = join(_DOWNLOAD_DIR, _("Incomplete"))
# Hard-coded list of languages supported by SABnzbd as they're not exposed
# through the API and locating them on the local machine will not work in many
# cases and might be a costly operation anyway.
# Therefore, this list needs to be updated by hand.
# TODO: Ask the SABnzbd developers to expose the list of supported languages
# through the API.
_AVAILABLE_LANGS = ["us-en", "de-de", "fr-fr", "sv-se", "nl-du"]
def get_default_lang():
"""
Maps the current locale to a supported SABnzbd language.
If it's not possible to do so, it will fall back to English ("us-en").
"""
current_lang = locale.getlocale()[0].lower().replace("_", "-")
if current_lang == "c":
return "us-en"
else:
if current_lang in _AVAILABLE_LANGS:
# A perfect match. Hooray!
return current_lang
elif "-" in current_lang:
current_lang = current_lang.split("-")[0]
for sabnzb_lang in _AVAILABLE_LANGS:
if sabnzb_lang.startswith(current_lang):
return sabnzb_lang
return "us-en"
class Config(ConfigSection):
_list_options = ["movie_categories", "date_categories", "schedlines"]
quick_check = gproperty(type=bool, default=True)
fail_on_crc = gproperty(type=bool, default=False)
send_group = gproperty(type=bool, default=False)
sfv_check = gproperty(type=bool, default=True)
email_server = gproperty(type=str)
email_to = gproperty(type=str)
email_from = gproperty(type=str)
email_account = gproperty(type=str)
email_pwd = gproperty(type=str)
email_endjob = gproperty(type=bool, default=False)
email_full = gproperty(type=bool, default=False)
email_dir = gproperty(type=str)
dirscan_opts = gproperty(type=int, default=PostProcessing.DELETE)
dirscan_script = gproperty(type=str, default="None")
dirscan_priority = gproperty(type=int, default=Priority.NORMAL)
dirscan_speed = gproperty(type=int, default=5)
auto_browser = gproperty(type=bool, default=False)
check_new_rel = gproperty(type=bool, default=True)
enable_unrar = gproperty(type=bool, default=True)
enable_unzip = gproperty(type=bool, default=True)
enable_filejoin = gproperty(type=bool, default=True)
enable_tsjoin = gproperty(type=bool, default=True)
enable_par_cleanup = gproperty(type=bool, default=True)
# When True, only perform QuickCheck and par2-verify, but never par2-repair.
# For low-performance systems that have trouble running repairs.
# Available in SABnzbd 0.6 and newer.
never_repair = gproperty(type=bool, default=False)
par_option = gproperty(type=str)
# The most conservative values possible that will cause post-processing
# to have the lowest possible impact on the system's performance.
# One might consider adjusting these values in the future.
nice = gproperty(type=str, default="-n 19")
ionice = gproperty(type=str, default="-c3")
ignore_wrong_unrar = gproperty(type=bool, default=False)
par2_multicore = gproperty(type=bool, default=True)
# Available in SABnzbd 0.5.4 and newer.
# Only affects 64-bit Windows installations.
allow_64bit_tools = gproperty(type=bool, default=True)
# Let jobs without a post-processing operation directly move to the history,
# preserving the temporary folder. Afterwards the user can decide to
# post-process or delete the job.
# Available in SAbnzbd 0.6 and newer.
allow_streaming = gproperty(type=bool, default=False)
top_only = gproperty(type=bool, default=True)
auto_disconnect = gproperty(type=bool, default=True)
queue_complete = gproperty(type=str)
# Available in SABnzbd 0.5.4 and newer.
queue_complete_pers = gproperty(type=bool, default=True)
replace_illegal = gproperty(type=bool, default=True)
replace_spaces = gproperty(type=bool, default=False)
replace_dots = gproperty(type=bool, default=False)
no_dupes = gproperty(type=bool, default=True)
ignore_samples = gproperty(type=bool, default=False)
create_group_folders = gproperty(type=bool, default=False)
auto_sort = gproperty(type=bool, default=False)
folder_rename = gproperty(type=bool, default=True)
folder_max_length = gproperty(type=int, default=2 ** 8, minimum=20,
maximum=2 ** 16)
safe_postproc = gproperty(type=bool, default=False)
pause_on_post_processing = gproperty(type=bool, default=False)
schedlines = gproperty(type=object)
enable_tv_sorting = gproperty(type=bool, default=False)
tv_sort_string = gproperty(type=str)
tv_sort_countries = gproperty(type=bool, default=True)
enable_movie_sorting = gproperty(type=bool, default=False)
movie_sort_string = gproperty(type=str)
movie_sort_extra = gproperty(type=str, default="-cd%1")
movie_extra_folder = gproperty(type=bool, default=False)
movie_categories = gproperty(type=object)
enable_date_sorting = gproperty(type=bool, default=False)
date_sort_string = gproperty(type=str)
date_categories = gproperty(type=object)
config_lock = gproperty(type=bool, default=False)
permissions = gproperty(type=str)
download_dir = gproperty(type=str, default=_INCOMPLETE_DIR)
download_free = gproperty(type=str)
complete_dir = gproperty(type=str, default=_DOWNLOAD_DIR)
cache_dir = gproperty(type=str, default="cache")
admin_dir = gproperty(type=str, default="admin")
log_dir = gproperty(type=str, default="logs")
nzb_backup_dir = gproperty(type=str)
script_dir = gproperty(type=str)
dirscan_dir = gproperty(type=str)
host = gproperty(type=str, default="localhost")
port = gproperty(type=int, default=DefaultPortNumber.HTTP, minimum=1,
maximum=2 ** 16 - 1)
username = gproperty(type=str)
password = gproperty(type=str)
# Available in SABnzbd 0.5.5 and newer.
login_realm = gproperty(type=str, default="SABnzbd")
bandwidth_limit = gproperty(type=int)
refresh_rate = gproperty(type=int)
rss_rate = gproperty(type=int, default=60, minimum=15, maximum=24 * 60)
cache_limit = gproperty(type=str)
web_dir = gproperty(type=str, default="Default")
web_dir2 = gproperty(type=str)
web_color = gproperty(type=str)
web_color2 = gproperty(type=str)
cleanup_list = gproperty(type=object)
enable_https = gproperty(type=bool, default=False)
https_port = gproperty(type=int, default=DefaultPortNumber.HTTPS,
minimum=1, maximum=2 ** 16 - 1)
https_key = gproperty(type=str, default="server.key")
https_cert = gproperty(type=str, default="server.cert")
ssl_type = gproperty(type=str, default="v23")
language = gproperty(type=str, default=get_default_lang())
unpack_check = gproperty(type=bool, default=True)
no_penalties = gproperty(type=bool, default=False)
api_key = gproperty(type=str)
disable_api_key = gproperty(type=bool, default=False)
# Available in SABnzbd 0.5.4 and newer.
api_warnings = gproperty(type=bool, default=True)
def __init__(self, name, parent=None, options=None):
ConfigSection.__init__(self, name, parent, options)
self.add_validation_function(self._validate_passwords)
def reset_object_options(self):
self.cleanup_list = [".nfo", ".sfv"]
self.movie_categories = ["movies"]
self.date_categories = ["tv"]
def _validate_passwords(self, key, value):
"""
Ensure that a clear-text password isn't overwritten by a masked password
(e. g. *******) received by SABnzbd.
SABnzbd never transmits clear-text passwords over the network when
requested by a `GetConfigQuery`.
However, if we don't know the actual password, it's safe to store the
masked password, because we need to know that there *is* a password.
TODO: Move this to a more general location because we'll also need this
in other parts of the SABnzbd configuration.
"""
if key == "password" and "*"*len(value) == value and \
len(self.password) == len(value):
return self.password
else:
return value
lottanzb-0.6/lottanzb/config/sabnzbd/__init__.py 0000644 0001750 0001750 00000024372 11525760436 021741 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import time
import random
from hashlib import md5
from os.path import expanduser
from lottanzb.core.constants import PostProcessing
from lottanzb.util.gobject_extras import gproperty
from lottanzb.config.errors import *
from lottanzb.config import (
ConfigObjRoot,
RemoteConfigRoot,
ListConfigSection as _ListConfigSection,
ConfigSection
)
__all__ = [
"ConfigMixin",
"LocalConfig",
"AbstractRemoteConfig",
"ListConfigSection",
"ListElementConfigSection",
"create_api_key"
]
DEFAULT_CONFIG_FILE = expanduser("~/.sabnzbd/sabnzbd.ini")
class ConfigMixin(object):
def import_hellanzb_config(self, hella_config):
"""
Copies all options part of the intersection of the HellaNZB and SABnzbd
configuration data and overwrites the current values in the SABnzbd
configuration.
"""
uses_default_password = hella_config.xmlrpc_password == \
hella_config.get_property_default_value("xmlrpc_password")
if hella_config.remote_access and not uses_default_password:
self.misc.username = hella_config.xmlrpc_username
self.misc.password = hella_config.xmlrpc_password
self.misc.host = hella_config.xmlrpc_server_bind
self.misc.bandwidth_limit = hella_config.max_rate
self.misc.complete_dir = hella_config.dest_dir
if hella_config.skip_unrar:
self.misc.enable_unrar = False
self.misc.enable_unzip = False
self.misc.dirscan_opts = PostProcessing.REPAIR
if hella_config.log_file_max_bytes:
self.logging.max_log_size = hella_config.log_file_max_bytes
self.logging.log_backups = hella_config.log_file_backup_count
if hella_config.newzbin_support:
self.newzbin.username = hella_config.newzbin_username
self.newzbin.password = hella_config.newzbin_password
for server in hella_config.servers.values():
self.servers.append({
"username": server.username,
"password": server.password,
"enable": server.enabled,
"fillserver": server.fillserver,
"connections": server.connections,
"ssl": server.ssl,
"timeout": server.idleTimeout,
"host": server.address,
"port": server.port
})
class LocalConfig(ConfigMixin, ConfigObjRoot):
"""
Root `ConfigSection` that loads and saves SABnzbd configuration files.
"""
# All subsections
misc = gproperty(type=object)
logging = gproperty(type=object)
newzbin = gproperty(type=object)
nzbmatrix = gproperty(type=object)
categories = gproperty(type=object)
servers = gproperty(type=object)
def __init__(self, config_file=DEFAULT_CONFIG_FILE):
ConfigObjRoot.__init__(self, config_file, "lottanzb.config.sabnzbd")
def __getinitargs__(self):
return [self.config_file]
def _get_section_identifier(self, section):
"""
Generates the string that will actually be used to identify a
particular section in the configuration file.
"""
brackets = section.get_depth() - 1
try:
identifier = section.get_identifier()
except AttributeError:
identifier = section._name
if brackets >= 0:
return "%s%s%s" % ("[" * brackets, identifier, "]" * brackets)
else:
return ""
def generate_api_key(self):
self.misc.api_key = create_api_key()
class AbstractRemoteConfig(ConfigMixin, RemoteConfigRoot):
"""
Root `ConfigSection` used to hold the configuration data received using
SABNzbd's API.
"""
# All subsections
misc = gproperty(type=object)
logging = gproperty(type=object)
newzbin = gproperty(type=object)
nzbmatrix = gproperty(type=object)
categories = gproperty(type=object)
servers = gproperty(type=object)
def __init__(self, host, options=None):
RemoteConfigRoot.__init__(self, host, name="lottanzb.config.sabnzbd",
options=options)
def __getinitargs__(self):
return [self.host]
def _get_clean_section(self, section):
if isinstance(section._parent, ListConfigSection):
clean_parent_section = RemoteConfigRoot._get_clean_section(self,
section._parent)
return clean_parent_section[section.get_remote_identifier()]
else:
return RemoteConfigRoot._get_clean_section(self, section)
class ListConfigSection(_ListConfigSection):
def __init__(self, name, parent=None, options=None):
self._by_identifier = {}
_ListConfigSection.__init__(self, name, parent, options)
def get_unknown_property(self, identifier):
key = self._get_key_by_identifier(identifier)
return _ListConfigSection.get_unknown_property(self, key)
def set_unknown_property(self, identifier, value):
key = self._get_key_by_identifier(identifier)
if isinstance(key, basestring):
self._by_identifier[key] = value
value.set_identifier(key)
key = len(self._list_items)
return _ListConfigSection.set_unknown_property(self, key, value)
def forget_identifier(self, identifier):
try:
del self._by_identifier[identifier]
except KeyError:
pass
def sync_remote_identifier(self, value):
identifier = value.get_identifier()
old_remote_identifier = value.get_remote_identifier()
value.sync_remote_identifier()
if old_remote_identifier and identifier != old_remote_identifier:
self.forget_identifier(old_remote_identifier)
def sync_all_remote_identifiers(self):
for value in self.values():
self.sync_remote_identifier(value)
def do_property_changed(self, section, key, value):
if section is not self:
value = section
self._by_identifier[value.get_identifier()] = value
if value.get_remote_identifier() is not None:
self._by_identifier[value.get_remote_identifier()] = value
def do_property_deleted(self, section, key, value):
if section is self:
self.forget_identifier(value.get_identifier())
self.forget_identifier(value.get_remote_identifier())
def _get_key_by_identifier(self, key):
try:
return int(key)
except ValueError:
try:
return self._by_identifier[key].get_name()
except KeyError:
return key
def merge(self, options):
if isinstance(options, list):
for index, option in enumerate(options):
self[index] = option
elif isinstance(options, ListConfigSection):
unknown_merge_values = []
unknown_local_values = []
for key, value in options.items():
if isinstance(value, ListElementConfigSection):
key = value.get_identifier()
try:
self[key].merge(value)
except InexistentOptionError:
unknown_merge_values.append(value)
for key, value in self.items():
if not value.get_remote_identifier() in options._by_identifier:
unknown_local_values.append(value)
if len(unknown_local_values) == len(unknown_merge_values):
for index, merge_value in enumerate(unknown_merge_values):
unknown_local_values[index].merge(merge_value)
else:
for local_value in unknown_local_values:
self.remove(local_value)
for merge_value in unknown_merge_values:
self.append(merge_value)
self.sync_all_remote_identifiers()
else:
_ListConfigSection.merge(self, options)
def to_dict(self):
"""Returns a simple dictionary version of the config section.
Instead of numerical keys for items of the list sections, their
identifiers will be used.
"""
result = self.get_options()
for value in self.get_sections().values():
result[value.get_identifier()] = value.to_dict()
return result
class ListElementConfigSection(ConfigSection):
def __init__(self, name, parent=None, options=None):
self._remote_identifier = ""
ConfigSection.__init__(self, name, parent, options)
def get_identifier(self):
raise NotImplementedError
def set_identifier(self, identifier):
raise NotImplementedError
def get_remote_identifier(self):
return self._remote_identifier
def set_remote_identifier(self, identifier):
self._remote_identifier = identifier
def sync_remote_identifier(self):
self._remote_identifier = self.get_identifier()
def create_api_key():
"""Returns a random 32-byte hex digest.
The return value can serve as the API key used to authenticate clients
of SABnzbd.
"""
# Create some values to seed md5
t = str(time.time())
r = str(random.random())
m = md5(t)
m.update(r)
# Return a hex digest of the md5, e.g. 49f68a5c8493ec2c0bf489821c21fc3b
return m.hexdigest()
lottanzb-0.6/lottanzb/config/lotta.py 0000644 0001750 0001750 00000017744 11525760436 017707 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import logging
import collections
# pylint: disable-msg=C0103
LOG = logging.getLogger(__name__)
from lottanzb import resources
from lottanzb.core.environ import _
from lottanzb.core.component import Component, depends_on
from lottanzb.util.gobject_extras import gproperty
from lottanzb.config.section import ConfigSection
from lottanzb.config.roots import IniPathConfigRoot
from lottanzb.config.errors import (
LoadingError,
ConfigNotFoundError,
OptionError,
InexistentOptionError
)
__all__ = ["LottaConfig", "ConfigComponent", "ConfigurableComponent"]
class Config(IniPathConfigRoot):
"""
Root ConfigSection that loads and saves the LottaNZB configuration file.
"""
backend = gproperty(type=object)
gui = gproperty(type=object)
plugins = gproperty(type=object)
revision = gproperty(type=int, default=5, minimum=1)
def __init__(self, config_file):
IniPathConfigRoot.__init__(self, config_file, "lottanzb")
def __getinitargs__(self):
return [self.config_file]
def load(self, custom_config_file=""):
IniPathConfigRoot.load(self, custom_config_file)
self.upgrade()
def upgrade(self):
"""
Upgrades out-of-date configuration data based on the revision stored in
the `revision` option.
"""
# The configuration revision of a configuration file was previously
# stored in the section `core` as `config_revision`. Now that it's
# possible for the root section to have options, it has been moved.
try:
self.revision = self.core.config_revision
except InexistentOptionError:
pass
else:
self.delete_unknown_property("core")
current_revision = self.revision
newest_revision = self.get_property_default_value("revision")
for revision in range(current_revision, newest_revision):
method_name = "upgrade_%i_to_%i" % (revision, revision + 1)
upgrade_method = getattr(self, method_name, None)
if isinstance(upgrade_method, collections.Callable):
upgrade_method()
self.revision = newest_revision
if current_revision != newest_revision:
self.save()
if newest_revision > current_revision:
LOG.info(_("Configuration upgraded to revision %i."),
newest_revision)
def try_to_get_property(self, path, default=None):
"""
Invokes the `get_by_path` method and ignores any `OptionError`s that
might be raised.
The second argument `default` may be used to specify a default value
that is returned if an `OptionError` occurs.
"""
try:
return self.get_by_path(path)
except OptionError as error:
LOG.debug(str(error))
return default
def try_to_set_property(self, path, value):
"""
Invokes the `set_by_path` method and ignores any `OptionError`s that
might be raised.
`ValueError`s will not be catched because they need to be fixed by the
developer.
"""
try:
self.set_by_path(path, value)
except OptionError as error:
LOG.debug(str(error))
def try_to_move_property(self, src_path, dest_path):
"""
Invokes the `move_unknown_property` method and ignores any
`OptionError`s that might be raised.
`ValueError`s will not be catched because they need to be fixed by the
developer.
"""
try:
self.move_unknown_property(src_path, dest_path)
except OptionError as error:
LOG.debug(str(error))
def try_to_delete_property(self, path):
"""
Invokes the `delete_unknown_property` method and ignores any
`OptionError`s that might be raised.
`ValueError`s will not be catched because they need to be fixed by the
developer.
"""
try:
section = self.get_by_path(path[:-1])
section.delete_unknown_property(path[-1])
except OptionError as error:
LOG.debug(str(error))
def upgrade_1_to_2(self):
"""
Separating the GUI code from LottaNZB's core and and the creation of
the "start_minimized" plug-in made it necessary to move options.
"""
for key in ["height", "width", "x_pos", "y_pos", "maximized"]:
self.try_to_move_property(
["gui", "window_%s" % key],
["gui", "main", key])
self.try_to_move_property(
["gui", "start_minimized"],
["plugins", "start_minimized", "enabled"])
def upgrade_2_to_3(self):
"""The "notification_area" plug-in has been renamed to "panel_menu"."""
self.try_to_move_property(
["plugins", "notification_area"],
["plugins", "panel_menu"])
def upgrade_3_to_4(self):
"""The 'newzbin' plug-in has been removed."""
self.try_to_delete_property(["plugins", "newzbin"])
def upgrade_4_to_5(self):
session_type_map = {
"standalone": "local",
"local_frontend": "local",
"remote_frontend": "remote"
}
active_mode = self.try_to_get_property(["modes", "active"], "")
self.try_to_set_property(
["backend", "sessions", "active"],
session_type_map.get(active_mode, ""))
self.try_to_move_property(
["modes", "remote_frontend", "address"],
["backend", "sessions", "remote", "host"])
self.try_to_delete_property(["modes"])
self.try_to_delete_property(["backend", "update_interval"])
self.try_to_delete_property(
["plugins", "categories", "categories_list"])
self.try_to_delete_property(
["plugins", "categories", "separator"])
class ConfigComponent(Component):
def __init__(self, component_manager):
Component.__init__(self, component_manager)
self.root = Config(resources.get_config("lottanzb.conf"))
try:
self.root.load()
except ConfigNotFoundError:
# Don't log an error message if the configuration doesn't exist yet
# This is the case during the first launch of LottaNZB.
pass
except LoadingError as error:
LOG.error(str(error))
def on_unload(self):
self.root.save()
class ConfigurableComponent(Component):
depends_on(ConfigComponent)
_config = None
@property
def config(self):
if self._config is None:
self._config = self.get_config_section(self._component_manager)
return self._config
@classmethod
def get_config_path(cls):
return ConfigSection.name_to_path(cls.__module__)[1:]
@classmethod
def get_config_section(cls, component_manager):
path = cls.get_config_path()
config_root = component_manager.load(ConfigComponent).root
config_root.create_path(path)
return config_root.get_by_path(path)
lottanzb-0.6/lottanzb/config/__init__.py 0000644 0001750 0001750 00000004170 11525760436 020310 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
"""
Distributed configuration system with validation support, nested sections...
This module aims to simplify the handling of configuration data in an
application. It doesn't contain any information about the actual configuration
used by the application such as its structure, default values, validation
routines etc.
Configuration files are parsed and generated using Python's ConfigParser class,
so their fully standard-compliant. Subsections, which aren't covered by the
standard are implemented using the dot character, e. g. [section.subsection].
Each section and all of its content is stored as an instance of ConfigSection.
ConfigSection lets you enforce certain option value types and specify
validation routines, but this is not obligatory.
If this module needs to create a `ConfigSection` instance, it will look for a
class named `Config` in the application module that matches the section's name.
(e. g. the class `Config` in the modes module for the section called [modes]).
If it doesn't find such a customized class, it falls back to `ConfigSection`.
The class `Config` in this module loads and saves the configuration file.
Both options and subsections can be accessed either as attributes or using
brackets. E. g.:
print App().config.modes.active
App().config["plugins"].categories["enabled"] = False
App().config.save()
"""
from lottanzb.config.errors import *
from lottanzb.config.section import *
from lottanzb.config.roots import *
lottanzb-0.6/lottanzb/resources/ 0000755 0001750 0001750 00000000000 11525760442 016737 5 ustar lantash lantash lottanzb-0.6/lottanzb/resources/xdg.py 0000644 0001750 0001750 00000005542 11525760436 020104 0 ustar lantash lantash # Copyright (C) 2009-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
"""
This module is based on the BaseDirectory module provided by pyxdg:
http://www.freedesktop.org/wiki/Software/pyxdg
The freedesktop.org Base Directory specification provides a way for
applications to locate shared data and configuration:
http://standards.freedesktop.org/basedir-spec/
This module is also capable of reading the user-dirs.dirs file.
"""
import re
import logging
LOG = logging.getLogger(__name__)
from os import environ
from os.path import join, expandvars, expanduser
__all__ = ["CONFIG_HOME", "CACHE_HOME", "DATA_HOME", "DATA_DIRS",
"CONFIG_DIRS", "USER_DIRS"]
CONFIG_HOME = environ.get("XDG_CONFIG_HOME", expanduser("~/.config"))
CACHE_HOME = environ.get("XDG_CACHE_HOME", expanduser("~/.cache"))
DATA_HOME = environ.get("XDG_DATA_HOME", expanduser("~/.local/share"))
DATA_DIRS = [DATA_HOME] + \
environ.get("XDG_DATA_DIRS", "/usr/local/share:/usr/share").split(":")
CONFIG_DIRS = [CONFIG_HOME] + \
environ.get("XDG_CONFIG_DIRS", "/etc/xdg").split(":")
# Remove empty entries.
DATA_DIRS = [data_dir for data_dir in DATA_DIRS if data_dir]
CONFIG_DIRS = [config_dir for config_dir in CONFIG_DIRS if config_dir]
# The user-dirs.dirs file in CONFIG_HOME can be used to specify the location of
# common user directories used for downloads, pictures, music, etc. The following
# keys can be defined in this particular file (and overridden using environment
# variables):
#
# XDG_DESKTOP_DIR
# XDG_DOWNLOAD_DIR
# XDG_TEMPLATES_DIR
# XDG_PUBLICSHARE_DIR
# XDG_DOCUMENTS_DIR
# XDG_MUSIC_DIR
# XDG_PICTURES_DIR
# XDG_VIDEOS_DIR
#
# Refer to http://www.freedesktop.org/wiki/Software/xdg-user-dirs for more
# information.
USER_DIRS = {}
try:
with open(join(CONFIG_HOME, "user-dirs.dirs")) as user_dirs_file:
pattern = re.compile("^(?P[A-Z_]+)=\s*\"(?P.+)\"\s*$")
for line in user_dirs_file.readlines():
match = pattern.match(line)
if match:
USER_DIRS[match.group("key")] = expandvars(match.group("value"))
for key in USER_DIRS:
USER_DIRS[key] = environ.get(key, USER_DIRS[key])
except IOError:
LOG.debug("Could not load the user-dirs.dirs file.")
lottanzb-0.6/lottanzb/resources/platform.py 0000644 0001750 0001750 00000001516 11525760436 021143 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
__all__ = ["INSTALLED", "DATA_DIR", "HELP_DIR", "LOCALE_DIR"]
INSTALLED = False
DATA_DIR = "data"
HELP_DIR = "help/mallard"
LOCALE_DIR = "build/mo"
lottanzb-0.6/lottanzb/resources/platform.py.in 0000644 0001750 0001750 00000001525 11525760436 021550 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
__all__ = ["INSTALLED", "DATA_DIR", "HELP_DIR", "LOCALE_DIR"]
INSTALLED = True
DATA_DIR = "{DATA_DIR}"
HELP_DIR = "{HELP_DIR}"
LOCALE_DIR = "{LOCALE_DIR}"
lottanzb-0.6/lottanzb/resources/__init__.py 0000644 0001750 0001750 00000003610 11525760436 021053 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
from os import makedirs
from os.path import join, isdir
from lottanzb.resources import xdg
from lottanzb.resources.platform import (
INSTALLED,
DATA_DIR,
HELP_DIR,
LOCALE_DIR
)
UI_DIR = join(DATA_DIR, "ui")
# Starting with LottaNZB 0.5, its configuration data is no longer saved in
# ~/.lottanzb but in ~/.config/lottanzb in order to adhere to the corresponding
# freedesktop.org standard.
CONFIG_DIR = join(xdg.CONFIG_HOME, "lottanzb")
USER_DATA_DIR = join(xdg.DATA_HOME, "lottanzb")
def is_installed():
return INSTALLED
def get_data(*subpaths):
return join(DATA_DIR, *subpaths)
def get_help(*subpaths):
return join(HELP_DIR, *subpaths)
def get_locale(*subpaths):
return join(LOCALE_DIR, *subpaths)
def get_ui(*subpaths):
return join(UI_DIR, *subpaths)
def get_config(*subpaths):
return join(CONFIG_DIR, *subpaths)
def get_user_data(*subpaths):
return join(USER_DATA_DIR, *subpaths)
def create_user_dirs():
for directory in [CONFIG_DIR, USER_DATA_DIR]:
if not isdir(directory):
# ~/.local or ~/.local/share may not exist on fresh installations.
# Therefore use the recursive version of the `mkdir` function.
makedirs(directory)
lottanzb-0.6/lottanzb/core/ 0000755 0001750 0001750 00000000000 11525760442 015655 5 ustar lantash lantash lottanzb-0.6/lottanzb/core/constants.py 0000644 0001750 0001750 00000002665 11525760436 020257 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
from lottanzb.core.environ import _
__all__ = ["DefaultPortNumber", "Priority", "PostProcessing"]
class DefaultPortNumber:
HTTP = 8080
HTTPS = 9090
class Priority:
TOP = 2
HIGH = 1
NORMAL = 0
LOW = -1
@classmethod
def to_pretty_string(cls, priority):
"""Return a printable string given a numerical download priority."""
MAP = {
cls.TOP: _("Force"),
cls.HIGH: _("High"),
cls.NORMAL: _("Normal"),
cls.LOW: _("Low")
}
try:
return MAP[priority]
except KeyError:
raise ValueError("Unknown priority: %r", priority)
class PostProcessing:
NOTHING = 0
REPAIR = 1
UNPACK = 2
DELETE = 3
lottanzb-0.6/lottanzb/core/ipc.py 0000644 0001750 0001750 00000007730 11525760436 017014 0 ustar lantash lantash
# Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import dbus.service
import dbus.mainloop.glib
import logging
LOG = logging.getLogger(__name__)
from threading import Lock
from lottanzb.core.environ import _
from lottanzb.backend.hubs.general import GeneralHub
from lottanzb.gui.main import MainWindow
class AlreadyRunningException(Exception):
def __str__(self):
return _("LottaNZB is already running on this computer.")
class DBusService(dbus.service.Object):
PATH = "/org/lottanzb"
NAMESPACE = "org.lottanzb"
def __init__(self, component_manager):
dbus.mainloop.glib.DBusGMainLoop(set_as_default=True)
# Check if LottaNZB is already running.
bus = dbus.SessionBus()
obj = bus.get_object("org.freedesktop.DBus", "/org/freedesktop/DBus")
interface = dbus.Interface(obj, "org.freedesktop.DBus")
if interface.NameHasOwner(self.NAMESPACE):
raise AlreadyRunningException()
LOG.debug("Setting up D-Bus interface...")
bus_name = dbus.service.BusName(self.NAMESPACE, bus=dbus.SessionBus())
dbus.service.Object.__init__(self, bus_name, self.PATH)
# Queue that stores the name of all NZB files that couldn't be enqueued
# so far, probably because LottaNZB isn't connected to an instance of
# SABnzbd yet.
self._nzb_queue = []
# Make the access to the above queue mutually exclusive.
self._nzb_lock = Lock()
# Wait for the `backend.hubs.general.GeneralHub` to be loaded so that
# the NZB files in `_nzb_queue` can be encoded.
def on_loaded(*args):
self._try_to_add_files()
self._component_manager = component_manager
self._component_manager.connect_async("component-loaded", on_loaded)
@dbus.service.method(dbus_interface=NAMESPACE)
def present(self):
"""Bring the main window to the front."""
main_window = self._component_manager.get(MainWindow)
if main_window:
main_window.show()
@dbus.service.method(dbus_interface=NAMESPACE, in_signature="as")
def add_files(self, files):
"""Enqueue an array of NZB files."""
self._try_to_add_files(files)
def _try_to_add_files(self, files=None):
"""
Try to enqueue the files passed as an argument and those in `nzb_queue`.
If the `backend.hubs.general.GeneralHub` is ready, enqueue all files.
Add the files passed as an argument to the `nzb_queue` otherwise.
"""
general_hub = self._component_manager.get(GeneralHub)
with self._nzb_lock:
if files:
self._nzb_queue.extend(files)
if general_hub:
for a_file in self._nzb_queue:
general_hub.add_file(a_file)
self._nzb_queue = []
@classmethod
def get_remote_interface(cls):
"""
Get the interface that can be used to call D-Bus methods of an already
running instance of LottaNZB.
"""
bus = dbus.SessionBus()
proxy = bus.get_object(cls.NAMESPACE, cls.PATH)
interface = dbus.Interface(proxy, cls.NAMESPACE)
return interface
lottanzb-0.6/lottanzb/core/component.py 0000644 0001750 0001750 00000037644 11525760436 020252 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
"""
Component management system inspired by the one used by Trac.
The following description originates from
http://trac.edgewall.org/wiki/TracDev/ComponentArchitecture
For our purposes, a component is an object that provides a certain type of
service within the context of the application. There is at most one instance of
any component: components are singletons. That implies that a component
does not map to an entity of the application's object model; instead,
components represent functional subsystems.
Components can declare "extension points" that other components can plug in to.
This allows one component to enhance the functionality of the component it
extends, without the extended component even knowing that the extending
component exists.
A component can extend any number of other components and still offer its own
extension points. This allows a plug-in to itself offer a plug-in API (i.e.
extension point). This feature is the basis for a plug-in-based architecture.
The actual functionality and APIs are defined by individual components.
The component kernel provides the "magic glue" to hook the different subsystems
together - without them necessarily knowing about each other.
"""
import sys
from logging import getLogger
LOG = getLogger(__name__)
from threading import Lock, Thread
from lottanzb.util.gobject_extras import GObject, GObjectMeta, gsignal
__all__ = ["ComponentError", "UnknownComponentError",
"ComponentInstantiationError", "Interface", "ExtensionPoint", "Component",
"implements", "depends_on", "ComponentManager", "ComponentError"]
class ComponentError(Exception):
"""
Abstract base class for component-related exceptions.
@param component: A `Component` subclass or instance.
@param message: An optional message of what exactly went wrong.
"""
message = ""
def __init__(self, component, message=""):
self.component = component
self.message = message or self.message
Exception.__init__(self)
class ComponentNotRegisteredError(ComponentError):
def __str__(self):
return "Component '%s' is not registered." % \
self.component.get_full_name()
class Interface(object):
"""
Marker base class for extension point interfaces.
Every extension point specifies the contract that extensions must conform to
via an `Interface` subclass.
"""
class ExtensionPoint(property):
"""
Declare an extension point on a component that other components can plug
into.
"""
def __init__(self, interface):
"""
Create the extension point.
@param interface: The `Interface` subclass that defines the protocol
for the extension point.
"""
property.__init__(self, self.extensions)
self.interface = interface
self.__doc__ = "List of component classes that implement `%s`" % \
self.interface.__name__
def extensions(self, component):
"""
Return a list of component classes that declare to implement the
extension point interface.
The reason why not the actual loaded components are returned is so that
clients can choose on their own whether to load an extending component
or not. Loading a component can be done by passing the component class
to the `load` method of the component manager.
"""
return ComponentMeta.get_extensions(self.interface)
def __repr__(self):
"""Return a textual representation of the extension point."""
return "" % self.interface.__name__
class ComponentMeta(GObjectMeta):
"""
Meta class for components.
Takes care of component, extension point and dependency registration.
"""
_components = []
_registry = {}
_component_dependencies = {}
_component_dependents = {}
def __new__(cls, name, bases, d):
"""Create the component class."""
new_class = GObjectMeta.__new__(cls, name, bases, d)
if name == "Component":
# Don't put the `Component` base class in the registry
return new_class
if d.get("abstract"):
# Don't put abstract component classes in the registry
return new_class
ComponentMeta._components.append(new_class)
registry = ComponentMeta._registry
for interface in d.get("_implements", []):
registry.setdefault(interface, []).append(new_class)
for base in bases:
for interface in getattr(base, "_implements", []):
registry.setdefault(interface, []).append(new_class)
dependencies = ComponentMeta._component_dependencies
dependents = ComponentMeta._component_dependents
for dependency_cls in d.get("_depends_on", []):
dependents.setdefault(dependency_cls, []).append(new_class)
dependencies.setdefault(new_class, []).append(dependency_cls)
return new_class
@classmethod
def get_components(cls):
"""Return a list of all component classes known to the system."""
return cls._components[:]
@classmethod
def get_component_dependencies(cls, component_class):
"""
Return a list of all component classes that this particular component
class depends on.
"""
return cls._component_dependencies.get(component_class, [])[:]
@classmethod
def get_component_dependents(cls, component_class):
"""
Return a list of all components that depend on that particular
component.
"""
return cls._component_dependents.get(component_class, [])[:]
@classmethod
def get_extensions(cls, interface):
"""
Return a list of component classes that declare to implement the
extension point interface.
"""
return cls._registry.get(interface, [])[:]
class Component(GObject):
"""
Abstract base class for components.
Every component can declare what extension points it provides, as well as
what extension points of other components it extends.
"""
__metaclass__ = ComponentMeta
gsignal("updated")
def __init__(self, component_manager):
GObject.__init__(self)
self._component_manager = component_manager
def on_unload(self):
"""
Can be overridden by subclasses in order to perform certain actions
when the component is removed from the component manager.
"""
@staticmethod
def implements(*interfaces):
"""
Can be used in the class definition of `Component` subclasses to declare
the extension points that are extended.
"""
frame = sys._getframe(1)
locals_ = frame.f_locals
# Some sanity checks
assert locals_ is not frame.f_globals and "__module__" in locals_, \
"implements() can only be used in a class definition"
locals_.setdefault("_implements", []).extend(interfaces)
@staticmethod
def depends_on(*component_classes):
"""
Can be used in the class definition of `Component` subclasses to declare
the components that need to be loaded whenever this component is loaded.
"""
frame = sys._getframe(1)
locals_ = frame.f_locals
# Some sanity checks
assert locals_ is not frame.f_globals and "__module__" in locals_, \
"depends_on() can only be used in a class definition"
locals_.setdefault("_depends_on", []).extend(component_classes)
@classmethod
def get_full_name(cls):
"""Return both the module name and the component class name."""
return cls.__module__ + "." + cls.__name__
@classmethod
def get_known_exceptions(cls):
"""The list of classes of exceptions that may be raised when loading the
component and are to be handled by clients of the component.
"""
return ()
implements = Component.implements
depends_on = Component.depends_on
class ComponentManager(GObject):
"""
Manage component life cycle, instantiating registered components on demand.
"""
# Emitted when an known and enabled component is being loaded.
# The only additional argument is the component class.
gsignal("component-loading", object)
# Emitted when a known and enabled component cannot be loaded because of
# an unhandled exception.
# The first additional argument is the component class and the second one
# is the unhandled exception.
gsignal("component-loading-failure", object, object)
# Emitted when a previously unloaded component has been successfully loaded.
# The only additional argument is the newly created component.
gsignal("component-loaded", object)
# Emitted when a previously loaded component has been successfully unloaded.
# The first additional argument is the component class.
# Optionally, the second object can be an `Exception` if the component has
# been unloaded because of a problem. A component can have been unloaded
# by itself.
gsignal("component-unloaded", object, object)
def __init__(self):
"""Initialize the component manager."""
GObject.__init__(self)
self._components = {}
# Makes sure that for a component manager, a component can only be
# created once, even if the application uses threads.
# The initialization methods of some components may take some time to
# execute.
self._locks = {}
def __contains__(self, component_class):
"""
Return whether the given class is in the list of active components.
"""
return component_class in self._components
def get(self, component_class):
if component_class not in ComponentMeta.get_components():
raise ComponentNotRegisteredError(component_class)
with self._locks.setdefault(component_class, Lock()):
return self._components.get(component_class)
def load(self, component_class):
"""
Activate the component instance for the given class, or return the
existing instance if the component has already been loaded.
"""
if not self.is_component_enabled(component_class):
return
if component_class not in ComponentMeta.get_components():
raise ComponentNotRegisteredError(component_class)
self.emit("component-loading", component_class)
component_already_loaded = False
try:
with self._locks.setdefault(component_class, Lock()):
component = self._components.get(component_class)
if component:
component_already_loaded = True
else:
# Load all components that this component depends on.
for cls in ComponentMeta.get_component_dependencies(
component_class):
if not self.is_loading(cls):
self.load(cls)
component = component_class(self)
self._components[component_class] = component
LOG.debug("Component '%s' loaded.",
component.get_full_name())
except Exception as error:
# Emit signals after releasing the component lock, just in case.
# NOTE: If an exception is raised in one of the handlers of the
# 'component-loading-failure' signals, `error' will for some reason
# be displayed twice in the log, while the actual error raised
# in the signal handler will be invisible.
# One solution for clients is to connect to the component manager
# using `connect_async'.
self.emit("component-loading-failure", component_class, error)
raise
if not component_already_loaded:
self.emit("component-loaded", component)
return component
def load_async(self, component_class):
"""Load a component in a separate thread."""
thread = ComponentLoadingThread(self, component_class)
thread.start()
def is_loading(self, component_class):
"""
Is a certain component being loaded (based on a component class)?
"""
try:
return self._locks[component_class].locked()
except KeyError:
return False
def unload(self, component_class, error=None):
"""
Force a component to be unloaded.
The argument `component_class` can be a `Component` subclass or an
instance of it.
The optional `error` argument can be an `Exception`. It can be passed if
the component has been unloaded because of a problem.
"""
if not isinstance(component_class, type):
component_class = component_class.__class__
already_unloaded = False
with self._locks.setdefault(component_class, Lock()):
component = self._components.pop(component_class, None)
if component is not None:
# Unload all components that depend on this component.
for cls in ComponentMeta.get_component_dependents(
component_class):
self.unload(cls)
component.on_unload()
LOG.debug("Component '%s' unloaded.", component.get_full_name())
else:
already_unloaded = True
if not already_unloaded:
self.emit("component-unloaded", component_class, error)
def unload_all(self):
"""Unload all components in no particular order."""
for component in dict(self._components):
self.unload(component)
def is_component_enabled(self, component_class):
"""
Can be overridden by sub-classes to veto the activation of a component.
If this method returns False, the component with the given class will
not be available.
"""
return True
class ComponentLoadingThread(Thread):
"""Asynchronously loads a component.
What is special about it is that it catches exceptions of those types listed
in the tuple returned by the `get_known_exceptions' method of the component.
Instead of letting the default exception hook process the exception,
it only logs the exception as an error.
"""
def __init__(self, component_manager, component_class):
self._component_manager = component_manager
self._component_class = component_class
Thread.__init__(self)
def run(self):
try:
self._component_manager.load(self._component_class)
except self._component_class.get_known_exceptions() as error:
LOG.error(error)
lottanzb-0.6/lottanzb/core/__init__.py 0000644 0001750 0001750 00000006347 11525760436 020003 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import gtk
import sys
import atexit
import logging
LOG = logging.getLogger(__name__)
from optparse import OptionParser
from os.path import abspath
from lottanzb import __version__
from lottanzb.core.component import ComponentManager
from lottanzb.core import environ
from lottanzb.core.environ import _
class App(ComponentManager):
dbus_service = None
def run(self):
try:
self.quit(self.main())
except KeyboardInterrupt:
raise SystemExit
def main(self):
parser = OptionParser(
usage="%prog [FILES...]",
version="LottaNZB %s" % __version__
)
parser.add_option("-d", "--debug", action="store_true", dest="debug",
help="show debug messages", default=False)
options, nzb_files = parser.parse_args()
nzb_files = [abspath(nzb_file) for nzb_file in nzb_files]
environ.setup_translation()
environ.setup_resources()
environ.setup_thread_excepthook()
# Lazy import
from lottanzb.core.ipc import DBusService, AlreadyRunningException
# Check if another instance of LottaNZB is already running.
try:
self.dbus_service = DBusService(self)
except AlreadyRunningException:
# Connect to the already running instance of LottaNZB.
# Present the main window and enqueue NZB files passed as command
# line parameters.
interface = DBusService.get_remote_interface()
if nzb_files:
interface.add_files(nzb_files)
interface.present()
# This instance of LottaNZB is not required anymore.
return 0
else:
# Enqueue NZB files passed as command line parameters.
if nzb_files:
self.dbus_service.add_files(nzb_files)
atexit.register(self.on_quit)
# Lazy import
from lottanzb.core.log import LoggingComponent
from lottanzb.gui import GUIComponent
logging_component = self.load(LoggingComponent)
if options.debug:
logging_component.set_console_level(logging.DEBUG)
LOG.info(_("Starting LottaNZB %s...") % __version__)
self.load(GUIComponent)
gtk.main()
return 0
def quit(self, code=0):
sys.exit(code)
def on_quit(self):
self.unload_all()
LOG.info(_("Exiting..."))
lottanzb-0.6/lottanzb/core/environ.py 0000644 0001750 0001750 00000005461 11525760436 017720 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import locale
import gettext
import threading
import sys
import logging
LOG = logging.getLogger(__name__)
from shutil import move
from os.path import isdir, expanduser
from lottanzb import resources
__all__ = ["DOMAIN", "_", "setup_resources", "setup_translation",
"setup_thread_excepthook"]
DOMAIN = "lottanzb"
_ = lambda message: gettext.dgettext(DOMAIN, message)
def setup_resources():
old_config_dir = expanduser("~/.lottanzb")
new_config_dir = resources.get_config()
if isdir(old_config_dir) and not isdir(new_config_dir):
LOG.info(_("Moving configuration directory from %s to %s..."),
old_config_dir, new_config_dir)
move(old_config_dir, new_config_dir)
resources.create_user_dirs()
def setup_translation():
# Python's 'locale' module doesn't provide all methods on some operating
# systems like FreeBSD.
# The exceptions blocks will prevent the application from crashing in this
# case. However, some menu entries will not be translated.
try:
# TODO: Is this necessary at all?
locale.setlocale(locale.LC_ALL, "")
except AttributeError:
pass
for module in (gettext, locale):
try:
module.bindtextdomain(DOMAIN, resources.get_locale())
module.bind_textdomain_codeset(DOMAIN, "UTF-8")
module.textdomain(DOMAIN)
except AttributeError:
pass
def setup_thread_excepthook():
"""Work-around for `sys.excepthook' thread bug
http://bugs.python.org/issue1230540.
Based on:
http://spyced.blogspot.com/2007/06/workaround-for-sysexcepthook-bug.html
"""
init_old = threading.Thread.__init__
def init(self, *args, **kwargs):
init_old(self, *args, **kwargs)
run_old = self.run
def run_with_except_hook(*args, **kw):
try:
run_old(*args, **kw)
except (KeyboardInterrupt, SystemExit):
raise
except:
sys.excepthook(*sys.exc_info())
self.run = run_with_except_hook
threading.Thread.__init__ = init
lottanzb-0.6/lottanzb/core/log.py 0000644 0001750 0001750 00000010722 11525760436 017015 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import sys
import logging
LOG = logging.getLogger(__name__)
from traceback import format_exc
from lottanzb import resources
from lottanzb.core.environ import _
from lottanzb.core.component import Component
from lottanzb.util.gobject_extras import gsignal
__all__ = ["LoggingComponent"]
class LoggingComponent(Component):
"""Store and handle all LottaNZB log messages.
All log messages are displayed on the console and written to a log file.
"""
LOG_FILE = resources.get_config("log")
# Emitted when a new message is logged. The only parameter is the
# `logging.LogRecord` object.
gsignal("record-added", object)
def __init__(self, component_manager):
Component.__init__(self, component_manager)
# Holds all `LogRecord`s created since the component was loaded.
self._records = []
# Setup console logging
self._console_handler = logging.StreamHandler()
self._console_handler.setLevel(logging.INFO)
self._console_handler.setFormatter(logging.Formatter(
"%(asctime)s %(name)-25s %(message)s",
datefmt="%T"))
# Setup file logging
self._file_handler = logging.FileHandler(self.LOG_FILE, "w")
self._file_handler.setFormatter(logging.Formatter(
"%(asctime)s %(name)-25s %(levelname)-8s %(message)s",
datefmt="%F %T"))
self._simple_handler = SimpleLoggingHandler(self.on_log_record_emitted)
root = logging.getLogger()
root.addHandler(self._console_handler)
root.addHandler(self._file_handler)
root.addHandler(self._simple_handler)
root.setLevel(logging.DEBUG)
# Install a custom exception hook so that unhandled thread exceptions
# produce a proper log entry.
sys.excepthook = self.custom_except_hook
def set_console_level(self, level):
"""Set the minimum importance level for log records in the console."""
self._console_handler.setLevel(level)
def get_console_level(self):
"""Get the minimum importance level for log records in the console."""
return self._console_handler.level
console_level = property(get_console_level, set_console_level)
@property
def records(self):
"""Returns a shallow copy of the array holding all `LogRecord`s."""
return self._records[:]
def on_log_record_emitted(self, value):
"""Append the `logging.LogRecord' `value' to `_records' and emit
the 'record-added' signal.
"""
self._records.append(value)
self.emit("record-added", value)
@staticmethod
def custom_except_hook(type, value, tb):
"""Logs an unhandled exception with the highest importance.
Besides an introductory text, a traceback is included in the message.
"""
exception = format_exc()
# When the exception is raised in the main thread, `format_exc' doesn't
# produce the expected output. As the application will crash anyway in
# such a case, it's fine to simply let the default exception hook take
# care of printing the exception to the console.
if exception.strip() != "None":
LOG.error(_("An unhandled exception occurred:") + "\n" + exception)
else:
sys.__excepthook__(type, value, tb)
class SimpleLoggingHandler(logging.Handler):
"""Passes any received `logging.LogRecord' as an argument to a callback
function specified upon construction.
"""
def __init__(self, callback):
self._callback = callback
logging.Handler.__init__(self)
def emit(self, log_record):
self._callback(log_record)
lottanzb-0.6/lottanzb/gui/ 0000755 0001750 0001750 00000000000 11525760442 015511 5 ustar lantash lantash lottanzb-0.6/lottanzb/gui/sessions/ 0000755 0001750 0001750 00000000000 11525760442 017357 5 ustar lantash lantash lottanzb-0.6/lottanzb/gui/sessions/local/ 0000755 0001750 0001750 00000000000 11525760442 020451 5 ustar lantash lantash lottanzb-0.6/lottanzb/gui/sessions/local/sabnzbd_pane.py 0000644 0001750 0001750 00000056611 11525760436 023465 0 ustar lantash lantash # Copyright (C) 2010-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
"""
UI and application logic aiming to help the user get a supported version of
SABnzbd in place.
"""
import gtk
import webbrowser
try:
import apt
except ImportError:
apt = None
from os.path import isfile
from distutils.version import LooseVersion
from distutils.spawn import find_executable
from subprocess import Popen, PIPE
from lottanzb.core.environ import _
from lottanzb.util.timer import Timer
from lottanzb.util.threading_extras import Thread
from lottanzb.gui.framework import SlaveDelegate
from lottanzb.gui.framework.proxy import (FileChooserButtonEndPoint,
GObjectEndPoint, ValidatableConduit, ValidationInvalidError)
from lottanzb.backend.interface import Interface
from lottanzb.backend.interface.errors import QueryUnsupportedAPIVersionError
from lottanzb.backend.sessions.local import LocalSession
from lottanzb.backend.sessions.errors import (SessionConnectionError,
SessionNoExecutableError, SessionPermissionError, SessionImportError)
# TODO: It would theoretically be possible to pass parameters to the help page
# indicating whether what distribution is in use and what version of SABnzbd
# is installed, if any.
HELP_URL = "http://www.lottanzb.org/help/installing-and-upgrading-sabnzbd/"
class FileConduit(ValidatableConduit):
"""Validatable conduit for handling file names.
The conduit is marked as valid only if the file exists. It's possible for
the model endpoint to refer to a file that does not exist. However, the
conduit will regularly check whether the file has been created.
"""
def __init__(self, model_endpoint, *endpoints):
ValidatableConduit.__init__(self, model_endpoint, *endpoints)
self._timer = Timer(250, self.on_timer_tick)
self._timer.start()
def validate_endpoint_value(self, endpoint, value):
ValidatableConduit.validate_endpoint_value(self, endpoint, value)
if not isfile(value):
raise ValidationInvalidError(self, endpoint, value)
def on_timer_tick(self, timer):
if not self.is_valid:
self.publish_model_endpoint()
def destroy(self):
self._timer.stop()
ValidatableConduit.destroy(self)
class APTPackageVersionThread(Thread):
"""Determines status of a package on a dpkg-based distribution.
After the execution of the thread, the properties `installed_version'
and `candidate_version' will be set or None if the package isn't known.
- `installed_version' holds the version of the installed package
or None if it's not installed.
- `candidate_version' holds the version of the package that can be
installed, which might be greater than `installed_version' if an update
is available that has not yet been installed by the user.
Please note that the thread will only produce a result if the Python module
`apt' is available.
"""
def __init__(self, package):
if not isinstance(package, str) or not package:
raise ValueError("%r is not a valid package name" % package)
self.installed_version = None
self.candidate_version = None
self.package = package
Thread.__init__(self)
def run(self):
try:
package = apt.Cache()[self.package]
except (AttributeError, KeyError):
pass
else:
installed_version = None
candidate_version = None
# The attribute `installedVersion' was renamed to
# `installed.version' starting with python-apt 0.7.10.
try:
if package.installed:
installed_version = package.installed.version
except AttributeError:
installed_version = package.installedVersion
# The attribute `candidateVersion' was renamed to
# `candidate.version' starting with python-apt 0.7.10.
try:
if package.candidate:
candidate_version = package.candidate.version
except AttributeError:
candidate_version = package.candidateVersion
if installed_version:
self.installed_version = LooseVersion(installed_version)
if candidate_version:
self.candidate_version = LooseVersion(candidate_version)
self.emit("completed")
class QuickInstallThread(Thread):
"""Provides a graphical way of installing one or more packages on a
dpkg-based distribution.
The packages to be installed can be passed to the constructor.
The thread invokes the application 'apturl' if available.
After the execution of the thread, the 'completed' signal will be emitted
and the property `result' will hold a value of the enumeration
`QuickInstallResult'.
"""
def __init__(self, *packages):
self.packages = packages
self.result = None
Thread.__init__(self)
def run(self):
try:
args = ("nohup", "apturl", "apt:" + ",".join(self.packages))
process = Popen(args, stdout=PIPE, stderr=PIPE)
process.communicate()
except OSError:
# 'apturl' most probably could not be found.
self.result = QuickInstallResult.ERROR
else:
self.result = int(process.returncode)
self.emit("completed")
class QuickInstallResult:
"""Enumeration of various results of the execution of a `QuickInstallThread'
- `INSTALLED': All requested packages have been succesfully installed or
were already installed.
- `ABORTED': The user aborted the installation of one or more packages.
- `ERROR': There was error while installing the packages, or the utility
'apturl' could not be found.
- `INVALID_ARGUMENTS': The arguments passed to 'apturl' were invalid.
"""
INSTALLED, ABORTED, ERROR, INVALID_ARGUMENTS = range(0, 4)
class QuickUpgradeThread(Thread):
"""Runs the application 'update-manager', if available.
It will wait for 'update-manager' to be completed, but doesn't give any
information on whether some updates were actually installed or not.
"""
COMMAND = "update-manager"
def run(self):
try:
args = ("nohup", self.COMMAND)
process = Popen(args)
process.communicate()
except OSError:
pass
self.emit("completed")
class State(SlaveDelegate):
"""Abstract class representing a view to be displayed within `SABnzbdPane'.
It may contain information about certain actions to be performed by the user
or itself provide actions to the user in the form of links or buttons.
Subclasses can override the methods `can_handle_session_error' and
`allows_manual_input' to indicate the properties and capabilities of the
view.
The class also provides some helper methods such as `create_label' and
`run_apt_version_thread'.
"""
def __init__(self, sabnzbd_pane):
self.sabnzbd_pane = sabnzbd_pane
SlaveDelegate.__init__(self)
@staticmethod
def create_label(markup=""):
"""Creates a new object of type `gtk.Label'.
Some of its properties are set to sane default values and it's also
possible to pass a markup as a method argument.
The label is returned and not automatically added to the view.
"""
label = gtk.Label()
label.set_alignment(0.0, 0.5)
label.set_line_wrap(True)
label.set_use_underline(True)
if markup:
label.set_markup(markup)
label.show()
return label
@staticmethod
def can_handle_session_error(error):
"""Whether the state is capable of handling `error` of type
`SessionError', i.e. presenting the user with helpful information
for dealing with this particular error.
Can be overridden by subclasses and returns False by default.
"""
return False
def allows_manual_input(self):
"""Whether the `FileChooserButton' for manually selecting the SABnzbd
executable should be visible or not.
Can be overridden by subclasses and returns False by default.
"""
return False
def run_apt_version_thread(self, callback):
"""Runs a new `APTPackageVersionThread' for the package 'sabnzbdplus'.
`callback' will be invoked when the thread is complete.
"""
thread = APTPackageVersionThread("sabnzbdplus")
thread.connect_async("completed", callback)
thread.start()
class SearchingState(State):
"""Determines the status of the 'sabnzbdplus' package on the user's machine.
Depending on this status, the user is routed to a certain other state.
This view is activated if a `SessionNoExecutableError' or
`QueryUnsupportedAPIVersionError' was raised.
"""
builder_file = "session_selection_local_sabnzbd_pane_searching"
def create_ui(self):
# GTK >= 2.20 supports `gtk.Spinner'.
if hasattr(gtk, "Spinner"):
self.spinner = gtk.Spinner()
self.spinner.start()
self.spinner_container.add(self.spinner)
self.spinner_container.show_all()
def handle_attached(self, sabnzbd_pane):
"""Run the `APTPackageVersionThread' as soon as the view is visible."""
self.run_apt_version_thread(self.on_apt_version_thread_completed)
def on_apt_version_thread_completed(self, thread):
"""React to the result of the `APTPackageVersionThread'."""
installed_version = thread.installed_version
candidate_version = thread.candidate_version
minimum_version = Interface.MINIMUM_VERSION
if candidate_version and candidate_version >= minimum_version:
if installed_version:
if installed_version < minimum_version:
self.sabnzbd_pane.set_state(QuickUpgradeState)
else:
# In this situation, the SABnzbd package was found to
# be installed, but the executable itself could not be
# found. There might be a problem with the installation or
# a unofficial package is being used. In either case, it's
# certainly better to display a 'Not found' message rather
# than leaving the `gtk.Spinner' spinning.
self.sabnzbd_pane.set_state(NotFoundState)
else:
self.sabnzbd_pane.set_state(QuickInstallState)
elif self.sabnzbd_pane.command_conduit.is_valid:
self.sabnzbd_pane.set_state(UpgradeState)
else:
self.sabnzbd_pane.set_state(NotFoundState)
@staticmethod
def can_handle_session_error(error):
"""Returns True if `error' is of type `SessionNoExecutableError' or
`SessionConnectionError' with an embedded `ConnectionError' of type
`QueryUnsupportedAPIVersionError'.
"""
if isinstance(error, SessionNoExecutableError):
return True
if isinstance(error, SessionConnectionError):
connection_error = error.connection_error
if isinstance(connection_error, QueryUnsupportedAPIVersionError):
return True
return False
class QuickInstallState(State):
builder_file = "session_selection_local_sabnzbd_pane_quick_install"
def handle_attached(self, sabnzbd_pane):
"""Set the SABnzbd executable in advance to '/usr/bin/sabnzbdplus'.
Thus the user is also allowed to manually install SABnzbd, causing the
'OK' button to be made sensitive.
TODO: The 'OK' button is made sensitive way to early, before all
files that are part of the 'sabnzbdplus' package are installed.
Let's hope that the user is wise enough not to hit 'OK' too early.
"""
self.sabnzbd_pane.config.command = "/usr/bin/sabnzbdplus"
def on_install_button__clicked(self, button):
"""Initiate the installation of the 'sabnzbdplus' package.
Until `QuickInstallThread' is completed, the `install_button' will be
made insensitive, preventing the user from clicking it twice.
"""
self.install_button.set_label(_("Installing..."))
self.install_button.set_property("sensitive", False)
thread = QuickInstallThread("sabnzbdplus")
thread.connect_async("completed",
self.on_quick_install_thread_completed)
thread.start()
def on_quick_install_thread_completed(self, thread):
"""React to the result of `QuickInstallThread'."""
if thread.result == QuickInstallResult.INSTALLED:
self.install_button.set_label(_("Installed"))
elif thread.result == QuickInstallResult.ABORTED:
self.install_button.set_label(_("_Install..."))
self.install_button.set_property("sensitive", True)
else:
# TODO: It should probably say 'could not be installed'.
self.sabnzbd_pane.set_state(NotFoundState)
class QuickUpgradeState(State):
"""
If the package 'sabnzbdplus' is installed, but it's version is too low
and a supported version of the package is available, ask the user to
install the updates available for the system.
"""
builder_file = "session_selection_local_sabnzbd_pane_quick_upgrade"
_timer = None
def create_ui(self):
"""Only show the 'Upgrade' button if `QuickUpgradeThread.COMMAND'
is available. Provide additional instructions otherwise.
"""
if find_executable(QuickUpgradeThread.COMMAND):
self.upgrade_button_container.show()
else:
self.upgrade_label.set_text(self.upgrade_label.get_text() + " " + \
_("Install the updates available for your system."))
def handle_attached(self, sabnzbd_pane):
"""Regularly check whether the updates have been installed."""
self._timer = Timer(1000, self.on_timer_tick)
self._timer.start()
def handle_detached(self, sabnzbd_pane):
"""Stop checking whether the updates have been installed."""
self._timer.stop()
def on_upgrade_button__clicked(self, button):
"""Initiate the installation of the update.
Until `QuickUpgradeState' is completed, the `upgrade_button' will be
made insensitive, preventing the user from clicking it twice.
"""
self.upgrade_button.set_label(_("Updating..."))
self.upgrade_button.set_property("sensitive", False)
thread = QuickUpgradeThread()
thread.start()
def on_timer_tick(self, timer):
"""Run an `APTPackageVersionThread' to check whether the updates have
been installed."""
self.run_apt_version_thread(self.on_apt_version_thread_completed)
def on_apt_version_thread_completed(self, thread):
"""Update the view if the updates have been installed."""
installed_version = thread.installed_version
if installed_version and installed_version >= Interface.MINIMUM_VERSION:
self._timer.stop()
self.upgrade_button.set_label(_("Updated"))
class UpgradeState(State):
"""View that asks the user to manually update SABnzbd.
This is the case when the the installed version of SABnzbd is out-of-date,
but no up-to-date package is available through the package manager.
"""
def create_ui(self):
markup = _("The program required for downloading is out-of-date.")
self.label = self.create_label()
self.get_toplevel().add(self.label)
# The signal 'activate-link' is available in GTK >= 2.18.
try:
self.label.connect("activate-link", self.on_activate_upgrade_link)
except TypeError:
pass
else:
markup += " " + _("Learn how to upgrade it.")
self.label.set_markup(markup)
def allows_manual_input(self):
return True
def on_activate_upgrade_link(self, label, uri):
webbrowser.open(HELP_URL)
class NotFoundState(State):
"""View that is displayed when the SABnzbd executbale could not be found.
It regularly checks again so that after the installation of SABnzbd, the
user is not required to manually navigate to '/usr/bin'.
"""
_timer = None
def create_ui(self):
format = ("", "")
markup = _("The program required for downloading could not be found. "
"{0}Install it{1} and specify where it is.")
self.label = self.create_label()
self.get_toplevel().add(self.label)
# The signal 'activate-link' is available in GTK >= 2.18.
try:
self.label.connect("activate-link", self.on_activate_install_link)
except TypeError:
pass
else:
format = ("", " ")
self.label.set_markup(markup.format(*format))
def handle_attached(self, sabnzbd_pane):
self._timer = Timer(1000, self.on_timer_tick)
self._timer.start()
def handle_detached(self, sabnzbd_pane):
self._timer.stop()
def on_timer_tick(self, timer):
if not self.sabnzbd_pane.config.command:
command = LocalSession.get_sabnzbd_command()
self.sabnzbd_pane.config.command = command
self._timer.stop()
def on_activate_install_link(self, label, uri):
"""Open the associated help content in a webbrowser."""
webbrowser.open(HELP_URL)
def allows_manual_input(self):
return True
class PermissionState(State):
"""View that asks the user to make the SABnzbd program file executable.
This state is activated when a `SessionPermissionError' is raised.
"""
def create_ui(self):
self.label = self.create_label(_("The program required for downloading "
"cannot be started. Make sure that it is executable."))
self.get_toplevel().add(self.label)
def allows_manual_input(self):
return True
@staticmethod
def can_handle_session_error(error):
return isinstance(error, SessionPermissionError)
class ImportState(State):
"""View that informs the user that SABnzbd could not be started because
a Python module is missing.
This state is activated when a `SessionPermissionError' is raised.
There is some extra logic for the Python module 'cherrypy' as SABnzbd ships
with it and the 'cherrypy.zip' file in the SABnzbd source tarball needs to
be extracted before it can be used. Of course, this doesn't apply to
installations using package managers.
"""
def create_ui(self):
self.label = self.create_label()
self.get_toplevel().add(self.label)
def handle_attached(self, sabnzbd_pane):
markup = _("The program required for downloading could not be started.")
if isinstance(sabnzbd_pane.session_error, SessionImportError):
if sabnzbd_pane.session_error.module == "cherrypy":
markup += " " + _("Ensure that cherrypy.zip is extracted.")
else:
markup += " " + sabnzbd_pane.session_error.message
self.label.set_markup(markup)
def allows_manual_input(self):
return True
@staticmethod
def can_handle_session_error(error):
return isinstance(error, SessionImportError)
class SABnzbdPane(SlaveDelegate):
"""Takes care of managing all possible states related to the selection
of the SABnzbd executable.
If no command has yet been specified, it automatically initiates the state
`SearchingState'.
It provides a conduit `command_conduit' for the SABnzbd executable.
It also takes care of changing to the right state given a `SessionError',
that can be handled according to `can_handle_session_error'.
"""
builder_file = "session_selection_local_sabnzbd_pane"
STATE_CLASSES = (
SearchingState,
QuickInstallState,
QuickUpgradeState,
UpgradeState,
NotFoundState,
PermissionState,
ImportState)
def __init__(self, config):
SlaveDelegate.__init__(self)
self.config = config
self.states = {}
self.state = None
self.session_error = None
self.command_conduit = FileConduit(
GObjectEndPoint(self.config, "command"),
FileChooserButtonEndPoint(self.executable))
self.command_conduit.mandatory = True
if not self.config.command:
self.set_state(SearchingState)
def can_handle_session_error(self, error):
"""Return True if any of the states is capable of handing the
`SessionError' `error'.
"""
return bool(self.get_session_error_handling_state(error))
def handle_session_error(self, error):
self.session_error = error
self.set_state(self.get_session_error_handling_state(error))
def get_session_error_handling_state(self, error):
"""Given a `SessionError' `error', determine the state (class) that can
handle the error based on the return value of the corresponding
`can_handle_session_error' method.
Returns None if no state can handle the error.
"""
for state_class in self.STATE_CLASSES:
if state_class.can_handle_session_error(error):
return state_class
def set_state(self, state_class):
"""Changes the state to the state of class `state_class'.
If the `allows_manual_input' method provided by the state returns True
the `FileChooserButton' for selecting the SABnzbd executable is
made visible or invisible otherwise."""
if not state_class is self.state:
# Don't instantate the `State's in advance for the reason of
# efficiency.
if not state_class in self.states:
self.states[state_class] = state_class(self)
state = self.states[state_class]
self.detach_slave(self.state_parent)
self.attach_slave(self.state_parent, state)
self.executable_container.set_property("visible",
state.allows_manual_input())
self.state = state_class
lottanzb-0.6/lottanzb/gui/sessions/local/__init__.py 0000644 0001750 0001750 00000007540 11525760436 022573 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
from lottanzb.core.environ import _
from lottanzb.backend.sessions.local import LocalSession
from lottanzb.backend.sessions.errors import SessionNoServerError
from lottanzb.config.sabnzbd.servers import ServerConfig
from lottanzb.gui.prefs.servers import ServerEditorPane
from lottanzb.gui.sessions.base import View
from lottanzb.gui.sessions.local.sabnzbd_pane import SABnzbdPane
from lottanzb.gui.framework.proxy import (
Conduit, GObjectEndPoint, EntryEndPoint, ToggleEndPoint, HostConduit,
ValidatableConduitCollection, ValidatableConduit, SpinButtonEndPoint)
class LocalView(View):
abstract = False
builder_file = "session_selection_local"
session_error_required = True
def __init__(self, component_manager):
View.__init__(self, component_manager)
self._sabnzbd_config_copy = self._session.sabnzbd_config.deep_copy()
self._conduits = ValidatableConduitCollection()
self.sabnzbd_pane = SABnzbdPane(self._session.config)
self.attach_slave(self.sabnzbd_pane_parent, self.sabnzbd_pane)
if self._session.config.command:
# For now, we assume that the specified command is valid.
# `SessionError's might be passed to the view later on.
self.sabnzbd_pane.hide()
server_section = self._session.sabnzbd_config.servers
if len(self._session.sabnzbd_config.servers):
# TODO: The first server in the list may not be the wisest choice.
server = server_section[0]
else:
server = ServerConfig(None)
server_section.append(server)
self.editor_pane = ServerEditorPane(server_section, server)
self.attach_slave(self.server_editor_pane_parent, self.editor_pane)
if not self.editor_pane.conduits.is_valid:
self.server_settings.show()
self._conduits.add(self.sabnzbd_pane.command_conduit)
self._conduits.connect("notify::is-valid", self.on_validation_changed)
self.editor_pane.conduits.connect("notify::is-valid",
self.on_validation_changed)
self.on_validation_changed()
def on_validation_changed(self, *args):
self.is_valid = self._conduits.is_valid and \
self.editor_pane.conduits.is_valid
def get_session_type(self):
return LocalSession
def get_radio_button_text(self):
return _("_Download to this computer")
def set_session_error(self, error):
if self.sabnzbd_pane.can_handle_session_error(error):
self.sabnzbd_pane.show()
self.sabnzbd_pane.handle_session_error(error)
elif not isinstance(error, SessionNoServerError):
View.set_session_error(self, error)
def restore(self):
"""Revert all changes made by the user while the view was displayed.
Besides restoring the LottaNZB configuration, also the SABnzbd
configuration file is restored to its initial state, prior to
launching the session.
"""
View.restore(self)
self._sabnzbd_config_copy.save()
self._session.sabnzbd_config.load()
lottanzb-0.6/lottanzb/gui/sessions/base.py 0000644 0001750 0001750 00000005560 11525760436 020654 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
from lottanzb.gui.framework import SlaveDelegate
from lottanzb.core.component import implements, Component
from lottanzb.util.gobject_extras import gproperty
from lottanzb.backend.sessions.errors import SessionConnectionError
class IView:
# True if the view is only capable of asking for input from the user if
# a previous attempt to launch the session resulted in a `SessionError'.
session_error_required = False
# Help topic to be opened when clicking 'Help'.
help_topic = ""
def get_session_type(self):
pass
def get_radio_button_text(self):
pass
def set_session_error(self, error):
pass
def restore(self):
"""Revert all changes made by the user while the view was displayed."""
pass
class View(SlaveDelegate, Component):
implements(IView)
abstract = True
session_error_required = False
help_topic = "setting-up"
error_message = gproperty(type=str)
is_valid = gproperty(type=bool, default=True)
def __init__(self, component_manager):
Component.__init__(self, component_manager)
SlaveDelegate.__init__(self)
self._session = self._component_manager.load(self.get_session_type())
self._session_config_copy = self._session.config.deep_copy()
def get_session_type(self):
raise NotImplementedError
def get_radio_button_text(self):
raise NotImplementedError
def set_session_error(self, error):
if isinstance(error, SessionConnectionError):
self.set_connection_error(error.connection_error)
elif error.message:
self.error_message = error.message
else:
self.error_message = str(error)
def set_connection_error(self, error):
if error.message:
self.error_message = error.message
else:
self.error_message = str(error)
def restore(self):
"""Revert all changes made by the user while the view was displayed.
By default, the configuration of the individual session is restored.
"""
self._session.config.merge(self._session_config_copy)
lottanzb-0.6/lottanzb/gui/sessions/remote.py 0000644 0001750 0001750 00000015205 11525760436 021232 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import logging
LOG = logging.getLogger(__name__)
from lottanzb.core.environ import _
from lottanzb.core.constants import DefaultPortNumber
from lottanzb.util.signalmanager import SignalSynchronicityProvider
from lottanzb.util.gtk_extras import gtk_lock
from lottanzb.gui.sessions.base import View
from lottanzb.backend.sessions.remote import RemoteSession
from lottanzb.gui.framework.proxy import (
EntryEndPoint, ValidatableConduit, GObjectEndPoint, SpinButtonEndPoint,
ValidatableConduitCollection, HostConduit)
from lottanzb.backend.interface.queries import (AuthenticationType,
AuthenticationTypeQuery)
from lottanzb.backend.interface.errors import QueryConnectionRefusedError
class RemoteView(View):
abstract = False
builder_file = "session_selection_remote"
help_topic = "remote-access"
def __init__(self, component_manager):
View.__init__(self, component_manager)
self._query_synchronicity = SignalSynchronicityProvider("completed",
self.on_authentication_type_query)
self._conduits = ValidatableConduitCollection()
self._conduits_by_key = {
"host": HostConduit(
GObjectEndPoint(self._session.config, "host"),
EntryEndPoint(self.host)),
"port": ValidatableConduit(
GObjectEndPoint(self._session.config, "port"),
SpinButtonEndPoint(self.port))
}
for key in ("api_key", "username", "password"):
self._conduits_by_key[key] = ValidatableConduit(
GObjectEndPoint(self._session.config, key),
EntryEndPoint(getattr(self, key)))
self._conduits_by_auth_type = {
self._conduits_by_key["api_key"]: \
AuthenticationType.API_KEY,
self._conduits_by_key["username"]: \
AuthenticationType.USERNAME_PASSWORD,
self._conduits_by_key["password"]: \
AuthenticationType.USERNAME_PASSWORD
}
for key in ("host", "port"):
self._conduits_by_key[key].mandatory = True
for conduit in self._conduits_by_key.values():
self._conduits.add(conduit)
self._session.config.connect("property-changed",
self.on_session_config_changed)
self.refresh_authentication_type()
self._conduits.connect("notify::is-valid", self.on_validation_changed)
self.on_validation_changed()
def on_validation_changed(self, *args):
self.is_valid = self._conduits.is_valid
def on_session_config_changed(self, section, parent, key, value):
"""Perform actions when some of the configuration values are changed.
If the port is changed to the default HTTPS port, HTTPS is automatically
enabled. If the port is changed from the default HTTPS port to something
else, HTTPS is automatically disabled.
TODO: In the future, it might be possible to manually specify this using
LottaNZB's UI.
If either the port or the host is changed, the SABnzbd listening at it
(if any) is asked what types of authentication it requries.
"""
if key == "port":
connection_info = self._session.get_connection_info()
https = value == DefaultPortNumber.HTTPS
changed = self._session.config.set_property("https", https)
if changed:
if https:
message = _("HTTPS is automatically enabled for the "
"connection to '%s'.")
else:
message = _("HTTPS is automatically disabled for the "
"connection to '%s'.")
LOG.info(message % connection_info.complete_host_string)
if key in ("host", "port"):
self.refresh_authentication_type()
def refresh_authentication_type(self):
if self._session.config.host and self._session.config.port:
query = AuthenticationTypeQuery()
self._query_synchronicity.connect(query)
interface = self._session.get_interface()
interface.run_query(query)
else:
self.error_message = ""
self.set_authentication_type(AuthenticationType.NOTHING)
def on_authentication_type_query(self, query):
if query.error:
self.set_connection_error(query.error)
self.set_authentication_type(AuthenticationType.NOTHING)
else:
self.set_authentication_type(query.response)
def set_authentication_type(self, authentication_type):
with gtk_lock:
self.api_key_container.set_visible(
authentication_type == AuthenticationType.API_KEY)
self.username_password_container.set_visible(
authentication_type == AuthenticationType.USERNAME_PASSWORD)
for conduit, value in self._conduits_by_auth_type.items():
conduit.mandatory = value == authentication_type
def set_connection_error(self, error):
if isinstance(error, QueryConnectionRefusedError):
connection_info = error.query.connection_info
# When connecting to 'localhost', SABnzbd doesn't need to allow
# access from other computers.
if connection_info.is_local:
info = _("Ensure that SABnzbd is running.")
else:
info = _("Ensure that SABnzbd is running on '%s' and allows "
"access from other computers.") % connection_info.host
self.error_message = error.message + " " + info
else:
View.set_connection_error(self, error)
def get_session_type(self):
return RemoteSession
def get_radio_button_text(self):
return _("_Manage the downloads of another computer")
lottanzb-0.6/lottanzb/gui/sessions/__init__.py 0000644 0001750 0001750 00000021203 11525760436 021471 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import sys
import gtk
import logging
LOG = logging.getLogger(__name__)
from lottanzb.core.component import ExtensionPoint
from lottanzb.util.gtk_extras import gtk_lock
from lottanzb.config.lotta import ConfigComponent
from lottanzb.backend import Backend
from lottanzb.backend.sessions.errors import (
SessionError, SessionNotSpecifiedError, SessionUnknownError)
from lottanzb.gui.framework import MainDelegateComponent
from lottanzb.gui.help import open_help
from lottanzb.gui.sessions.base import IView
from lottanzb.gui.sessions.local import LocalView
from lottanzb.gui.sessions.remote import RemoteView
class SelectionDialog(MainDelegateComponent):
builder_file = "session_selection_dialog"
views = ExtensionPoint(IView)
def __init__(self, component_manager):
config = component_manager.load(ConfigComponent).root
self.sessions_config = config.backend.sessions
# Holds the value of the configuration option 'backend.sessions.active'.
# When the user decides to quit the selection dialog, the option will
# be restored to this value.
self.original_active_session = self.sessions_config.active
# Holds a `SessionError' if the session selection dialog was launched
# because it occurred. Further failed attempts to start a new session
# won't cause the property to be changed and launching the session
# selection dialog even though no `SessionError' caused the backend to
# be unloaded, the property will remain None.
self.original_session_error = None
self.view = None
MainDelegateComponent.__init__(self, component_manager)
self._component_manager.connect("component-loaded",
self.on_component_loaded)
def create_ui(self):
first_radio_button = None
for view_cls in self.views:
view = self._component_manager.load(view_cls)
view.connect("notify::is-valid", self.on_view_validation_changed)
view.connect("notify::error-message", self.on_view_error_message)
radio_button = gtk.RadioButton()
if first_radio_button is None:
first_radio_button = radio_button
else:
radio_button.set_group(first_radio_button)
radio_button.set_use_underline(True)
radio_button.set_label(view.get_radio_button_text())
radio_button.connect("toggled",
gtk_lock.locked(self.on_radio_button_toggled), view)
radio_button.show()
view.set_data("radio-button", radio_button)
self.radio_buttons.pack_start(radio_button, expand=False)
self.get_toplevel().set_default_response(gtk.RESPONSE_OK)
def on_radio_button_toggled(self, widget, view):
if widget.get_active():
self.set_view(view)
def on_view_validation_changed(self, view, *args):
if self.view is view:
self.update_save_button_sensitivity()
def on_view_error_message(self, view, *args):
if self.view is view:
self.set_error_message(view.error_message)
def preselect_session_type(self, session_type, parent_window=None):
"""Automatically select `session_type' as the new active session.
The radio buttons will not be displayed and if no user input is required
for the user to change to the new session, the session selection dialog
will not be shown at all. Otherwise, its `show' method is called
with the argument `parent_window'.
"""
for view_cls in self.views:
view = self._component_manager.get(view_cls)
if session_type is view.get_session_type():
with gtk_lock:
self.set_view(view)
self.radio_buttons.set_property("visible", False)
if view.session_error_required:
self.get_toplevel().response(gtk.RESPONSE_OK)
else:
self.show(parent_window)
return
raise ValueError("Unknown session type %r." % session_type)
def set_view(self, view):
if not self.get_slave(self.view_container) is view:
with gtk_lock:
self.detach_slave(self.view_container)
self.view = view
if view:
self.attach_slave(self.view_container, view)
self.view_container.show()
active = view.get_session_type().get_name()
else:
self.view_container.hide()
active = ""
self.sessions_config.active = active
view.get_data("radio-button").set_active(True)
self.set_error_message(view.error_message)
self.update_save_button_sensitivity()
def set_error_message(self, error_message):
with gtk_lock:
self.error_container.set_property("visible", bool(error_message))
self.error.set_label(error_message)
def get_view_for_session(self, session):
for view_cls in self.views:
view = self._component_manager.get(view_cls)
if isinstance(session, view.get_session_type()):
return view
def set_session_error(self, error):
if not isinstance(error, SessionError):
raise ValueError("gui.sessions.SelectionDialog.set_session_error "
"expects an error of type "
"backend.sessions.error.SessionError.")
if self.view is None:
self.original_session_error = error
if isinstance(error, (SessionNotSpecifiedError, SessionUnknownError)):
self.set_view(self._component_manager.get(LocalView))
return
view = self.get_view_for_session(error.session)
if view:
view.set_session_error(error)
self.set_view(view)
def update_save_button_sensitivity(self):
sensitive = self.view and self.view.is_valid
with gtk_lock:
self.save.set_property("sensitive", sensitive)
def restore(self):
"""Restore the value of the configuration option
'backend.sessions.active' to its original value.
"""
self.sessions_config.active = self.original_active_session
def on_unload(self):
for view_cls in self.views:
self._component_manager.unload(view_cls)
MainDelegateComponent.on_unload(self)
def on_component_loaded(self, component_manager, component):
if isinstance(component, Backend):
self._component_manager.unload(self)
def on_widget__response(self, dialog, response):
if response in (gtk.RESPONSE_CANCEL, gtk.RESPONSE_DELETE_EVENT):
# Revert all changes made by the user.
self.restore()
for view_cls in self.views:
view = self._component_manager.get(view_cls)
view.restore()
# If the session selection dialog was opened because of a
# `SessionError', the application it shut down. Otherwise, the
# previous session is restarted again with its original
# configuration.
if self.original_session_error:
sys.exit()
else:
self._component_manager.load_async(Backend)
self.hide()
elif response == gtk.RESPONSE_OK:
self._component_manager.load_async(Backend)
self.hide()
elif response == gtk.RESPONSE_HELP and self.view:
open_help(self.view.help_topic)
dialog.stop_emission("response")
lottanzb-0.6/lottanzb/gui/main/ 0000755 0001750 0001750 00000000000 11525760442 016435 5 ustar lantash lantash lottanzb-0.6/lottanzb/gui/main/info_bar.py 0000644 0001750 0001750 00000011736 11525760436 020601 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import gtk
from lottanzb.core.component import depends_on
from lottanzb.core.environ import _
from lottanzb.util.gtk_extras import gtk_lock
from lottanzb.gui.framework import SlaveDelegateComponent
from lottanzb.backend.hubs.general import GeneralHub
from lottanzb.backend.hubs.statistics import StatisticsHub
from lottanzb.gui.main.speed_limit_menu import SpeedLimitMenuComponent
from lottanzb.gui.framework.widgets import MenuButton
__all__ = ["InfoBar"]
class InfoBar(SlaveDelegateComponent):
builder_file = "info_bar"
depends_on(GeneralHub)
depends_on(StatisticsHub)
def create_ui(self):
speed_icon = gtk.image_new_from_stock(gtk.STOCK_GO_DOWN,
gtk.ICON_SIZE_MENU)
self.speed_button = MenuButton()
self.speed_button.set_image(speed_icon)
self.speed_button.set_relief(gtk.RELIEF_NONE)
self.speed_button.set_tooltip_text(_("Limit the download speed"))
self.speed_button.show()
self.speed_container.pack_start(self.speed_button)
general_hub = self._component_manager.get(GeneralHub)
with gtk_lock:
general_hub.connect("notify::speed",
gtk_lock.locked(self.on_speed_changed))
general_hub.connect("notify::size-left",
gtk_lock.locked(self.on_remaining_changed))
general_hub.connect("notify::time-left",
gtk_lock.locked(self.on_remaining_changed))
self.on_speed_changed(general_hub)
self.on_remaining_changed(general_hub)
statistics_hub = self._component_manager.get(StatisticsHub)
with gtk_lock:
for folder_type in ("download", "temp"):
statistics_hub.connect("notify::free-%s-folder-space" % \
folder_type, gtk_lock.locked(self.on_free_space_changed),
general_hub)
self.on_free_space_changed(statistics_hub, None, general_hub)
def on_speed_changed(self, general_hub, *args):
new_label = str(general_hub.speed)
with gtk_lock:
if self.speed.get_label() != new_label:
self.speed.set_label(new_label)
def on_remaining_changed(self, general_hub, *args):
if general_hub.time_left:
text = _("{0.size_left} left ({0.time_left.short})")
else:
text = _("{0.size_left} left")
new_label = text.format(general_hub)
with gtk_lock:
if self.total_remaining.get_label() != new_label:
self.total_remaining.set_label(new_label)
def on_free_space_changed(self, statistics_hub, param, general_hub):
# NOTE: Don't get the general hub from the component manager within
# the method mody. It might have been unloaded since the signal was
# emitted. Thus, prevent this race condition by using the reference
# obtained in the constructor.
free_download_space = statistics_hub.free_download_folder_space
free_temp_space = statistics_hub.free_temp_folder_space
if free_download_space is None or free_temp_space is None:
return
new_label = _("{0} free").format(free_download_space)
size_left = general_hub.size_left
# Use red color to indicate that the size of the queue exceeds the
# available space in the download folder.
if size_left is not None and free_download_space < size_left:
new_label = "{0} ".format(new_label)
# Only show the free space in the temporary folder if it is on a
# different partition.
# TODO: Could also use red color to indicate potential problems.
if free_download_space != free_temp_space:
new_label += "\n" + _("{0} free (temp)").format(free_temp_space)
new_label = "{0} ".format(new_label)
with gtk_lock:
self.free_space_container.show()
if self.free_space.get_label() != new_label:
self.free_space.set_markup(new_label)
def on_speed_button__show_menu(self, button):
menu_component = self._component_manager.load(SpeedLimitMenuComponent)
button.menu = menu_component.get_menu()
lottanzb-0.6/lottanzb/gui/main/download_list.py 0000644 0001750 0001750 00000041374 11525760436 021665 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import urllib
import gtk
import pango
from gettext import ngettext
from lottanzb.core.environ import _
from lottanzb.core.component import depends_on
from lottanzb.util.gobject_extras import gsignal
from lottanzb.util.misc import html_escape, open_folder
from lottanzb.backend import Backend
from lottanzb.backend.hubs.general import GeneralHub
from lottanzb.backend.hubs.general.download import Status, StatusGroup
from lottanzb.backend.hubs.general.download_list import DownloadListStore
from lottanzb.gui import download_properties
from lottanzb.gui.framework import SlaveDelegateComponent
from lottanzb.gui.framework.proxy import (GObjectEndPoint, Conduit,
ToggleActionEndPoint)
from lottanzb.gui.framework.messages import warning
class DownloadList(SlaveDelegateComponent):
depends_on(Backend)
depends_on(GeneralHub)
gsignal("selection-changed", object)
builder_file = "download_list"
# The download statuses that will represented by a higher row in the
# download list, having a second line with additional status information.
EXPANDED_STATUSES = StatusGroup.PROCESSING | Status.FAILED | \
Status.DOWNLOADING | Status.GRABBING | Status.DOWNLOADING_RECOVERY_DATA
def __init__(self, component_manager):
SlaveDelegateComponent.__init__(self, component_manager)
# Maps all actions to a download status or status group.
# When a download is selected, an action must be sensitive if and only
# if the download has such a status.
self.action_status_sensitivity = {
self.show_properties_dialog: StatusGroup.ANY_STATUS,
self.open_folder: StatusGroup.COMPLETE
}
for action in (self.remove, self.move_up, self.move_up_to_top,
self.move_down, self.move_down_to_bottom, self.pause):
self.action_status_sensitivity[action] = \
StatusGroup.MOVABLE
self._general_hub = self._component_manager.get(GeneralHub)
self._general_hub.downloads.connect("rows-reordered",
self.update_action_sensitivity)
backend = self._component_manager.get(Backend)
self.open_folder.set_visible(backend.interface.connection_info.is_local)
# When a download is selected, the `_pause_action_end_point' is
# connected to a dedicated `DownloadPauseHubEndPoint' using
# `_pause_conduit' such that the 'Pause' toggle action is kept in sync
# with the status of the download.
self._pause_action_end_point = ToggleActionEndPoint(self.pause)
self._pause_conduit = None
self.treeview.append_column(DownloadPrimaryColumn(self))
self.treeview.append_column(DownloadSizeColumn())
self.treeview.append_column(DownloadProgressColumn())
self.treeview.set_search_equal_func(self.search_equal_function)
self.treeview.get_selection().set_mode(gtk.SELECTION_BROWSE)
self.treeview.get_selection().connect("changed",
self.on_selection_changed)
drag_targets = [("DOWNLOAD_ROW", gtk.TARGET_SAME_WIDGET, 0)]
drop_targets = drag_targets + [("text/plain", 0, 1)]
self.treeview.enable_model_drag_source(gtk.gdk.BUTTON1_MASK,
drag_targets, gtk.gdk.ACTION_MOVE)
self.treeview.enable_model_drag_dest(drop_targets, gtk.gdk.ACTION_MOVE)
self.treeview.set_model(self._general_hub.downloads)
def search_equal_function(self, model, column, key, iter):
"""
`False' if the name of the download specified by `iter' contains `key',
`True' otherwise.
"""
download = model[iter][DownloadListStore.COLUMN]
return key.lower() not in download.name.lower()
def get_selected(self):
selection = self.treeview.get_selection()
if selection:
model, treeiter = selection.get_selected()
if treeiter:
return model[treeiter][DownloadListStore.COLUMN]
def on_selection_changed(self, selection):
download = self.get_selected()
if self._pause_conduit:
self._pause_conduit.destroy()
if download:
self._pause_conduit = Conduit(
DownloadPauseHubEndPoint(download, self._general_hub),
self._pause_action_end_point)
self.update_action_sensitivity(self)
self.emit("selection-changed", download)
def update_action_sensitivity(self, *args):
download = self.get_selected()
action_sensitivity = {}
for action, status in self.action_status_sensitivity.items():
action_sensitivity[action] = bool(download) and \
download.has_status(status)
if download:
queue = self._general_hub.downloads.get_filter_movable()
if len(queue):
if queue[0][DownloadListStore.COLUMN] is download:
action_sensitivity[self.move_up] = False
action_sensitivity[self.move_up_to_top] = False
if queue[-1][DownloadListStore.COLUMN] is download:
action_sensitivity[self.move_down] = False
action_sensitivity[self.move_down_to_bottom] = False
for action, state in action_sensitivity.items():
action.set_property("sensitive", state)
def remove_download(self, download):
# Lazy import
from lottanzb.gui.main import MainWindow
main_window = self._component_manager.load(MainWindow).get_toplevel()
if download and download.has_status(StatusGroup.MOVABLE):
title = _("Cancel download?")
message = _("This cannot be undone.")
response = warning(title, message=message, parent=main_window,
buttons=gtk.BUTTONS_OK_CANCEL)
if response == gtk.RESPONSE_OK:
self._general_hub.delete_downloads(download)
def on_treeview__key_press_event(self, treeview, event):
download = self.get_selected()
if download and event.keyval == gtk.keysyms.Delete:
self.remove_download(download)
def on_treeview__button_press_event(self, treeview, event):
if event.type == gtk.gdk.BUTTON_PRESS and event.button == 3:
self.context_menu.popup(None, None, None, event.button, event.time)
def on_treeview__drag_data_get(self, treeview, context, selection, info,
timestamp):
download = self.get_selected()
if download.has_status(StatusGroup.MOVABLE):
selection.set("DOWNLOAD_ROW", 8, download.id)
def on_treeview__drag_data_received(self, treeview, context, x, y,
selection, info, timestamp):
drop_info = treeview.get_dest_row_at_pos(x, y)
if not selection.data:
return
if info == 0:
self.handle_download_move(selection.data, drop_info)
elif info == 1:
for a_file in selection.data.replace("file://", "").split():
if a_file.lower().endswith(".nzb"):
self._general_hub.add_file(urllib.unquote(a_file).strip())
def handle_download_move(self, download_id, drop_info):
# TODO: Is this the right place for this piece of code?
downloads = self.treeview.get_model()
download = downloads._by_id[download_id]
filter_movable = downloads.get_filter_movable()
source_index = 0
for row in filter_movable:
if row[DownloadListStore.COLUMN].id == download_id:
source_index = row.path[0]
not_movable_count = len(downloads.get_filter_processing())
not_movable_count += len(downloads.get_filter_complete())
target_index = None
if drop_info:
path, position = drop_info
target_index = path[0] - not_movable_count
if target_index - source_index == 1 and \
position == gtk.TREE_VIEW_DROP_BEFORE:
target_index += -1
elif source_index - target_index == 1 and \
position == gtk.TREE_VIEW_DROP_AFTER:
target_index += 1
elif source_index < target_index and \
position == gtk.TREE_VIEW_DROP_BEFORE:
target_index += -1
elif source_index > target_index and \
position == gtk.TREE_VIEW_DROP_AFTER:
target_index += 1
else:
# Move the download to the bottom of the queue.
target_index = len(filter_movable) - 1
# When a download is dropped on the list of completed downloads or
# downloads being processed, move it to the top of the queue.
if target_index < 0:
target_index = 0
self._general_hub.move_download(download, target_index)
def show_properties(self, *args):
# Lazy import
from lottanzb.gui.main import MainWindow
download = self.get_selected()
main_window = self._component_manager.load(MainWindow)
dialog = self._component_manager.load(download_properties.Dialog)
dialog.set_download(download)
dialog.show(main_window.get_toplevel())
def on_move_up_to_top__activate(self, widget):
download = self.get_selected()
if download:
self._general_hub.force_download(download)
def on_move_up__activate(self, widget):
download = self.get_selected()
if download:
self._general_hub.move_download_up(download)
def on_move_down__activate(self, widget):
download = self.get_selected()
if download:
self._general_hub.move_download_down(download)
def on_move_down_to_bottom__activate(self, widget):
download = self.get_selected()
if download:
self._general_hub.move_download_down_to_bottom(download)
def on_treeview__row_activated(self, treeview, path, column):
"""Directly open the folder containing the downloaded files for the
selected download if and only if:
- the download has been completed successfully
- LottaNZB is connected to a local instance of SABnzbd
- the download folder actually exists
Otherwise, open the download properties dialog.
TODO: Not sure if it's such a good idea to behave differently depending
on the context.
"""
self.show_properties()
def on_show_properties_dialog__activate(self, widget):
self.show_properties()
def on_open_folder__activate(self, widget):
download = self.get_selected()
if download:
open_folder(download.storage_path)
def on_remove__activate(self, *args):
self.remove_download(self.get_selected())
class DownloadPauseHubEndPoint(GObjectEndPoint):
"""Pauses or resumes `download' using `general_hub' given a boolean value
received through the conduit.
"""
PROPERTY = "status"
def __init__(self, download, general_hub):
self._general_hub = general_hub
GObjectEndPoint.__init__(self, download)
def get_value(self):
return self._object.status == Status.PAUSED
def set_value(self, paused):
# The actual download status will be set in `backend.hubs.general'
# in response to the newly started query.
# It's not done twice in order to avoid race conditions with queue
# queries.
if paused:
self._general_hub.pause_downloads(self._object)
else:
self._general_hub.resume_downloads(self._object)
class DownloadPrimaryColumn(gtk.TreeViewColumn):
def __init__(self, download_list):
gtk.TreeViewColumn.__init__(self, "")
# TODO: Access to the download list is required because for certain
# rows, it needs to know whether it represents the download currently
# being selected.
self.download_list = download_list
self.renderer_text = gtk.CellRendererText()
self.renderer_text.set_property("ellipsize", pango.ELLIPSIZE_MIDDLE)
self.pack_start(self.renderer_text)
self.set_cell_data_func(self.renderer_text, self.renderer_text_func)
self.set_expand(True)
def renderer_text_func(self, column, renderer, tree_model, rowref):
download = tree_model.get_value(rowref, DownloadListStore.COLUMN)
content = "%s " % html_escape(download.name)
if download.has_status(DownloadList.EXPANDED_STATUSES):
content += "\n"
if download.status == Status.DOWNLOADING_RECOVERY_DATA:
content += ngettext(
"Downloading {0.recovery_block_count} recovery block...",
"Downloading {0.recovery_block_count} recovery blocks...",
download.recovery_block_count)
elif download.status == Status.VERIFYING:
content += _("Verifying... ({0.verification_percentage}%)")
elif download.status == Status.REPAIRING:
content += _("Repairing... ({0.repair_percentage}%)")
elif download.status == Status.EXTRACTING:
content += _("Extracting... ({0.unpack_percentage}%)")
elif download.status == Status.JOINING:
content += _("Joining...")
elif download.status == Status.MOVING:
content += _("Moving to download folder...")
elif download.status == Status.SCRIPT:
content += _("Executing user script...")
elif download.status == Status.FAILED:
text = html_escape(download.error_message)
if not self.download_list.get_selected() is download:
text = "" + text + " "
content += text
elif download.status == Status.DOWNLOADING:
# `Download.time_left' may be None if its not known.
if download.time_left is not None:
content += _("Downloading - {0.time_left.short} left")
else:
content += _("Downloading - Remaining time unknown")
elif download.status == Status.GRABBING:
content += _("Downloading NZB file...")
renderer.set_property("markup", content.format(download))
renderer.set_property("sensitive", download.status != Status.PAUSED)
class DownloadSizeColumn(gtk.TreeViewColumn):
def __init__(self):
gtk.TreeViewColumn.__init__(self)
self.renderer = gtk.CellRendererText()
self.renderer.set_property("xalign", 1.0)
self.pack_start(self.renderer)
self.set_cell_data_func(self.renderer, self.renderer_func)
def renderer_func(self, column, renderer, tree_model, rowref):
download = tree_model[rowref][DownloadListStore.COLUMN]
if download.size:
size = str(download.size)
else:
size = ""
renderer.set_property("text", size)
renderer.set_property("sensitive", download.status != Status.PAUSED)
class DownloadProgressColumn(gtk.TreeViewColumn):
def __init__(self):
gtk.TreeViewColumn.__init__(self)
self.renderer = gtk.CellRendererProgress()
self.pack_start(self.renderer)
self.set_cell_data_func(self.renderer, self.renderer_func)
self.set_min_width(150)
def renderer_func(self, column, renderer, tree_model, rowref):
download = tree_model[rowref][DownloadListStore.COLUMN]
if download.has_status(DownloadList.EXPANDED_STATUSES):
renderer.set_property("ypad", 8)
else:
renderer.set_property("ypad", 0)
renderer.set_property("value", download.percentage)
renderer.set_property("sensitive", download.status != Status.PAUSED)
lottanzb-0.6/lottanzb/gui/main/speed_limit_menu.py 0000644 0001750 0001750 00000011654 11525760436 022343 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import gtk
from lottanzb.core.component import depends_on, Component
from lottanzb.core.environ import _
from lottanzb.util.gobject_extras import gsignal
from lottanzb.backend.hubs import DataSpeed
from lottanzb.backend.hubs.general import GeneralHub
from lottanzb.backend.hubs.config import ConfigHub
__all__ = ["SpeedLimitMenuComponent"]
class SpeedLimit(DataSpeed):
"""A download speed limit given in kilobytes per second, where as a
a value of 0 indicates unlimited download speed.
"""
def __init__(self, speed_limit):
DataSpeed.__init__(self, kibibytes=speed_limit)
def __str__(self):
"""Overrides the string representation defined by `DataSpeed' such that
unlimited download speed is indicated by a localized 'Unlimited'.
"""
if self._data == 0:
return _("Unlimited")
else:
return DataSpeed.__str__(self)
class SpeedLimitMenuComponent(Component):
"""Allows clients to display a menu that makes it possible to review and set
the download speed limit.
It's possible to spawn as many instances of the menu using the method
`popup'. However, existing instances won't be updated when the configuration
changes in any way.
Changes to the download speed limit are instantaneously applied using the
`ConfigHub'.
At the top of the menu, the user is presented with a way of removing any
download speed limit, followed by a list of predefined possible download
speed limits.
"""
depends_on(ConfigHub)
depends_on(GeneralHub)
# A predefined list of download speed limits in decreasing order.
#
# TODO: One might consider measuring the maximum download speed when no
# limit is set and use that information to compute a reasonable set of
# predefined speed limits. However, this would need to be constantly updated
# as the user might access different networks.
DEFAULT_SPEED_LIMITS = map(SpeedLimit, [2000, 1000, 500, 250, 100, 50])
def __init__(self, component_manager):
Component.__init__(self, component_manager)
self._config_hub = self._component_manager.get(ConfigHub)
def get_menu(self):
"""Build a new menu for setting the download speed limit"""
speed_limit = self._get_speed_limit()
menu = SpeedLimitMenu(speed_limit)
menu.add_speed_limit(SpeedLimit(0))
if speed_limit and speed_limit not in self.DEFAULT_SPEED_LIMITS:
menu.add_speed_limit(speed_limit)
menu.add_separator()
for default_speed_limit in self.DEFAULT_SPEED_LIMITS:
menu.add_speed_limit(default_speed_limit)
def on_speed_limit_changed(menu, speed_limit):
self._set_speed_limit(speed_limit)
menu.connect("speed-limit-changed", on_speed_limit_changed)
return menu
def _get_speed_limit(self):
return SpeedLimit(self._config_hub.get_bandwidth_limit())
def _set_speed_limit(self, speed_limit):
self._config_hub.set_bandwidth_limit(speed_limit.kibibytes_per_second)
class SpeedLimitMenu(gtk.Menu):
gsignal("speed-limit-changed", object)
def __init__(self, active_speed_limit):
self.active_speed_limit = active_speed_limit
gtk.Menu.__init__(self)
def add_speed_limit(self, speed_limit):
try:
radio_group = self.get_children()[0]
except IndexError:
radio_group = None
index = len(self)
menu_item = gtk.RadioMenuItem(radio_group, str(speed_limit))
if self.active_speed_limit == speed_limit:
menu_item.set_active(True)
menu_item.connect("toggled", self.on_menu_item_toggled, speed_limit)
menu_item.show()
self.attach(menu_item, 0, 1, index, index + 1)
def add_separator(self):
index = len(self)
menu_item = gtk.SeparatorMenuItem()
menu_item.show()
self.attach(menu_item, 0, 1, index, index + 1)
def on_menu_item_toggled(self, radio_menu_item, speed_limit):
if radio_menu_item.get_active():
self.emit("speed-limit-changed", speed_limit)
lottanzb-0.6/lottanzb/gui/main/__init__.py 0000644 0001750 0001750 00000033553 11525760436 020562 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import sys
import gtk
import webbrowser
import logging
LOG = logging.getLogger(__name__)
from threading import Thread
from lottanzb.core.environ import _
from lottanzb.backend import Backend
from lottanzb.backend.sessions.local import LocalSession
from lottanzb.backend.sessions.remote import RemoteSession
from lottanzb.backend.hubs.config import ConfigHub
from lottanzb.backend.hubs.general import GeneralHub
from lottanzb.config.errors import OptionError
from lottanzb.config.section import ConfigSection
from lottanzb.config.lotta import ConfigComponent
from lottanzb.util.gobject_extras import gproperty
from lottanzb.util.gtk_extras import gtk_lock
from lottanzb.util.signalmanager import SignalManager
from lottanzb.util.misc import open_folder
from lottanzb.gui import add_file, add_url, about, log, prefs, sessions
from lottanzb.gui.help import open_help
from lottanzb.gui.messaging import MessagingManager
from lottanzb.gui.main.download_list import DownloadList
from lottanzb.gui.main.info_bar import InfoBar
from lottanzb.gui.framework import MainDelegateComponent
from lottanzb.gui.framework.proxy import (
ConduitCollection, Conduit, GObjectEndPoint, ToggleActionEndPoint)
class Config(ConfigSection):
# Holds a configuration section of type `ViewConfig'.
view = gproperty(type=object)
width = gproperty(type=int, default=700)
height = gproperty(type=int, default=350)
x_pos = gproperty(type=int, default=100)
y_pos = gproperty(type=int, default=100)
maximized = gproperty(type=bool, default=False)
def find_section_class(self, section):
if section == "view":
return ViewConfig
return ConfigSection.find_section_class(self, section)
class ViewConfig(ConfigSection):
"""Holds information about what elements are visible in the main window.
The boolean options have been moved to a separate configuration section
because they are closely related and the functionality might one day be
moved to a separate submodule called `view'.
"""
toolbar = gproperty(type=bool, default=True)
infobar = gproperty(type=bool, default=True)
reordering_pane = gproperty(type=bool, default=True)
class WidgetVisibilityEndPoint(GObjectEndPoint):
"""An endpoint for a widget that modifies the widget's visibility given
boolean values sent through the conduit.
"""
PROPERTY = "visible"
class MainWindow(MainDelegateComponent):
builder_file = "main_window"
general_hub = gproperty(type=object)
# If True, the application is entirely shut down when the window is closed.
# If False, the application is only hidden when the window is closed.
quit_on_delete = True
def __init__(self, component_manager):
MainDelegateComponent.__init__(self, component_manager)
self.session_signals = SignalManager()
self.session_conduits = ConduitCollection()
# The list of actions that may only be used if connected to an instance
# of SABnzbd.
self.backend_actions = [self.add, self.add_url, self.clear, self.paused,
self.open_download_folder, self.edit_preferences,
self.select_local_session, self.select_remote_session,
self.open_web_interface]
def on_general_hub_changed(self, *args):
self.on_general_hub_updated(None)
self.connect("notify::general-hub", on_general_hub_changed)
self.notify("general-hub")
def create_ui(self):
self.enable_rgba_support()
self.restore_window_geometry()
# Make the 'View -> Toolbar' `gtk.CheckMenuItem' functional.
self.view_toolbar_conduit = Conduit(
GObjectEndPoint(self.config.view, "toolbar"),
ToggleActionEndPoint(self.view_toolbar),
WidgetVisibilityEndPoint(self.toolbar))
# Make the 'View -> Infobar' `gtk.CheckMenuItem' functional.
self.view_infobar_conduit = Conduit(
GObjectEndPoint(self.config.view, "infobar"),
ToggleActionEndPoint(self.view_infobar),
WidgetVisibilityEndPoint(self.infobar))
# Make the 'View -> Reordering Pane' `gtk.CheckMenuItem' functional.
# Because the actual reordering pane is dynamically added to the window
# when LottaNZB is connected to SABnzbd, the corresponding end point
# will also be added and removed dynamically.
# This is required so that the check menu items is still functional
# even if LottaNZB is not connected to SABnzbd.
self.view_reordering_pane_conduit = Conduit(
GObjectEndPoint(self.config.view, "reordering_pane"),
ToggleActionEndPoint(self.view_reordering_pane))
self.view_reordering_pane_endpoint = None
self.select_local_session.set_property("visible", False)
# Show the panel menu unless the user has explicitly disabled it in
# the configuration file, either using a previous version of LottaNZB
# or by hand.
# Right now, it's not possible to disable or enable it using the UI,
# as the plug-in infrastructure has not been ported yet.
config = self._component_manager.get(ConfigComponent).root
panel_menu_enabled = True
try:
if config["plugins"]["panel_menu"]["enabled"] == "False":
panel_menu_enabled = False
except OptionError:
pass
if panel_menu_enabled:
# Lazy import.
from lottanzb.gui.panel_menu import PanelMenuComponent
self._component_manager.load_async(PanelMenuComponent)
def attach_to_backend(self, backend):
self.general_hub = self._component_manager.load(GeneralHub)
self.session_signals.connect(self.general_hub, "updated",
self.on_general_hub_updated)
self.session_conduits.add(Conduit(
GObjectEndPoint(self.general_hub, "paused"),
ToggleActionEndPoint(self.paused)))
# Lazy import.
from lottanzb.gui.messaging import (download_import,
postprocessing_priority, servers)
infobar = self._component_manager.load(InfoBar)
download_list = self._component_manager.load(DownloadList)
manager = self._component_manager.load(MessagingManager)
with gtk_lock:
self.open_download_folder.set_property("visible",
backend.interface.connection_info.is_local)
self.attach_slave(self.infobar, infobar)
self.attach_slave(self.download_list, download_list)
self.attach_slave(self.message, manager)
self.view_reordering_pane_endpoint = WidgetVisibilityEndPoint(
download_list.reordering_pane)
self.view_reordering_pane_conduit.add_endpoint(
self.view_reordering_pane_endpoint)
self.toolbar_remove.set_related_action(download_list.remove)
self.select_local_session.set_property("visible",
not isinstance(backend.session, LocalSession))
def detach_from_backend(self):
self.detach_all_slaves()
self.session_signals.disconnect_all()
self.session_conduits.remove_all()
if self.view_reordering_pane_endpoint:
self.view_reordering_pane_conduit.remove_endpoint(
self.view_reordering_pane_endpoint)
self._component_manager.unload(DownloadList)
self._component_manager.unload(MessagingManager)
with gtk_lock:
self.open_download_folder.set_property("visible", False)
self.general_hub = None
def enable_rgba_support(self):
"""Try to enable RGBA support"""
try:
gtk_screen = self.get_toplevel().get_screen()
rgba_colormap = gtk_screen.get_rgba_colormap()
if rgba_colormap:
gtk.widget_set_default_colormap(rgba_colormap)
except AttributeError:
LOG.debug("RGBA support not available.")
else:
LOG.debug("RGBA support enabled.")
def restore_window_geometry(self):
"""
Restore the size and position, as well as the maximization state of the
window according to the values in the configuration.
"""
if self.config.maximized:
self.get_toplevel().maximize()
else:
self.get_toplevel().resize(self.config.width, self.config.height)
self.get_toplevel().move(self.config.x_pos, self.config.y_pos)
def on_general_hub_updated(self, hub):
"""When the general hub is not available, all actions depending on it
are made insensitive.
The 'Clear completed' action is only made sensitive if there are
completed downloads.
"""
action_visibility = {}
for action in self.backend_actions:
action_visibility[action] = bool(hub)
if self.general_hub:
history = self.general_hub.downloads.get_filter_complete()
action_visibility[self.clear] = bool(len(history))
else:
with gtk_lock:
# FIXME: While `DownloadList' is not loaded, this toolbar button
# is not connected to an action and thus sensitive by default.
self.toolbar_remove.set_property("sensitive", False)
with gtk_lock:
for action, visibility in action_visibility.items():
action.set_property("sensitive", visibility)
def on_widget__configure_event(self, widget, event):
"""
Store the window size and position in the configuration if it's
not maximized.
"""
if not self.config.maximized:
position = widget.get_position()
self.config.width = event.width
self.config.height = event.height
self.config.x_pos = position[0]
self.config.y_pos = position[1]
def on_widget__window_state_event(self, widget, event):
"""
Store the window state in the configuration if it has been maximized.
"""
if event.changed_mask & gtk.gdk.WINDOW_STATE_MAXIMIZED:
maximized = event.new_window_state & gtk.gdk.WINDOW_STATE_MAXIMIZED
self.config.maximized = maximized
return False
def on_widget__delete_event(self, widget, event):
"""Quits the application if necessary."""
if self.quit_on_delete:
Thread(target=sys.exit).run()
else:
self.hide()
return True
def show_session_selection_dialog(self, session_type):
self._component_manager.unload(Backend)
dialog = self._component_manager.load(sessions.SelectionDialog)
dialog.preselect_session_type(session_type)
def on_select_local_session__activate(self, widget):
self.show_session_selection_dialog(LocalSession)
def on_select_remote_session__activate(self, widget):
self.show_session_selection_dialog(RemoteSession)
def on_open_web_interface__activate(self, widget):
"""Open the SABnzbd web interface in a browser tab."""
backend = self._component_manager.get(Backend)
url = backend.interface.connection_info.url
webbrowser.open_new_tab(url)
def on_edit_preferences__activate(self, widget):
"""Open the preferences dialog."""
window = self._component_manager.load(prefs.Window)
window.show(self.get_toplevel())
def on_report_bug__activate(self, widget):
webbrowser.open_new_tab("https://bugs.launchpad.net/lottanzb/+filebug")
def on_translate_application__activate(self, widget):
webbrowser.open_new_tab("https://translations.launchpad.net/lottanzb")
def on_show_message_log__activate(self, widget):
window = self._component_manager.load(log.Window)
window.show(self.get_toplevel())
def on_show_help_content__activate(self, widget):
open_help()
def on_show_about_dialog__activate(self, widget):
dialog = self._component_manager.load(about.Dialog)
dialog.show(self.get_toplevel())
def on_add__activate(self, *args):
"""Display a dialog using which a user can add one ore more NZB files
to the download queue.
"""
dialog = self._component_manager.load(add_file.Dialog)
dialog.show(self.get_toplevel())
def on_add_url__activate(self, *args):
dialog = self._component_manager.load(add_url.Dialog)
dialog.show(self.get_toplevel())
def on_quit__activate(self, *args):
Thread(target=sys.exit).run()
def on_clear__activate(self, widget):
if self.general_hub:
self.general_hub.delete_all_history()
def on_open_download_folder__activate(self, widget):
config_hub = self._component_manager.get(ConfigHub)
if config_hub:
download_folder = config_hub.config.misc.complete_dir
open_folder(download_folder)
lottanzb-0.6/lottanzb/gui/prefs/ 0000755 0001750 0001750 00000000000 11525760442 016630 5 ustar lantash lantash lottanzb-0.6/lottanzb/gui/prefs/general.py 0000644 0001750 0001750 00000024645 11525760436 020635 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import gtk
from os.path import isfile, isdir
from lottanzb.core.environ import _
from lottanzb.core.constants import PostProcessing
from lottanzb.core.component import depends_on
from lottanzb.resources.xdg import USER_DIRS
from lottanzb.backend import Backend
from lottanzb.backend.hubs.capabilities import CapabilitiesHub
from lottanzb.gui.prefs.widgets import (AdditionalSoftwareNotice,
AdditionalSoftwareDialog)
from lottanzb.gui.prefs.base import Tab
from lottanzb.gui.framework.proxy import (
GObjectEndPoint, ToggleEndPoint, DelayedEntryEndPoint, SpinButtonEndPoint,
FileChooserFolderEndPoint, Conduit, ConduitCollection)
class GeneralTab(Tab):
depends_on(CapabilitiesHub)
abstract = False
builder_file = "prefs_tab_general"
label = _("General")
help_topic = "prefs-general-tab"
def __init__(self, component_manager):
self._software_warning = None
self._conduit_collection = ConduitCollection()
Tab.__init__(self, component_manager)
self._capabilities_hub = self._component_manager.load(CapabilitiesHub)
self._capabilities_hub.connect("updated", self.on_capabilities_updated)
def create_ui(self):
cell = gtk.CellRendererText()
self.post_processing.set_model(PostProcessingComboBoxModel())
self.post_processing.pack_start(cell, True)
self.post_processing.add_attribute(cell, "markup",
PostProcessingComboBoxModel.Column.DESCRIPTION)
self._software_warning = AdditionalSoftwareNotice.build_for_widget(
self.post_processing)
self._software_warning.connect("activated", self.show_software_dialog)
def set_config(self, lottanzb_config, sabnzbd_config):
self._conduit_collection.remove_all()
interface = self._component_manager.load(Backend).interface
is_local = interface.connection_info.is_local
# If no folder has yet been chosen to be watched for new NZB files,
# use the default download folder rather than the working directory.
self._conduit_collection.add(TogglableFolderConduit(
GObjectEndPoint(sabnzbd_config.misc, "dirscan_dir"), self.dirscan,
self.observed_folder_button, self.observed_folder_entry, is_local,
USER_DIRS.get("XDG_DOWNLOAD_DIR", "")))
self._conduit_collection.add(FolderConduit(
GObjectEndPoint(sabnzbd_config.misc, "complete_dir"),
self.download_folder_button, self.download_folder_entry, is_local))
self._conduit_collection.add(Conduit(
GObjectEndPoint(sabnzbd_config.misc, "dirscan_opts"),
ProcessingComboBoxEndPoint(self.post_processing)))
self._conduit_collection.add(ToggableConduit(
GObjectEndPoint(sabnzbd_config.misc, "bandwidth_limit"),
self.enforce_max_rate, 1000, 0, SpinButtonEndPoint(self.max_rate)))
self.enforce_max_rate.emit("toggled")
self._capabilities_hub.refresh()
def on_capabilities_updated(self, capabilities_hub):
self.update_software_warning_visibility()
def on_post_processing__changed(self, widget):
self.update_software_warning_visibility()
def show_software_dialog(self, *args):
from lottanzb.gui.prefs import Window
prefs_window = self._component_manager.get(Window)
dialog = self._component_manager.load(PostProcessingSoftwareDialog)
dialog.show(prefs_window.get_toplevel())
def update_software_warning_visibility(self):
constant = self.get_selected_post_processing_constant()
supported = self._capabilities_hub.supports_post_processing(constant)
self._software_warning.set_property("visible", not supported)
if supported:
self._component_manager.unload(PostProcessingSoftwareDialog)
def get_selected_post_processing_constant(self):
index = self.post_processing.get_active()
column = PostProcessingComboBoxModel.Column.ID
return self.post_processing.get_model()[index][column]
def on_enforce_max_rate__toggled(self, widget):
active = self.enforce_max_rate.get_active()
self.max_rate.set_sensitive(active)
self.max_rate_scale.set_sensitive(active)
class ComplexToggleEndPoint(ToggleEndPoint):
def __init__(self, widget, default_active_value, inactive_value):
self._old_active_value = default_active_value
self._inactive_value = inactive_value
ToggleEndPoint.__init__(self, widget)
def get_value(self):
if ToggleEndPoint.get_value(self):
return self._old_active_value
else:
return self._inactive_value
def set_value(self, value):
ToggleEndPoint.set_value(self, value)
if value:
self._old_active_value = value
class ToggableConduit(Conduit):
def __init__(self, model_endpoint, checkbox, default_active_value,
inactive_value, *ui_endpoints):
if model_endpoint.get_value() != inactive_value:
default_active_value = model_endpoint.get_value()
self._inactive_value = inactive_value
self._ui_endpoints = ui_endpoints
Conduit.__init__(self, model_endpoint, ComplexToggleEndPoint(checkbox,
default_active_value, inactive_value))
if model_endpoint.get_value() == inactive_value:
for ui_endpoint in self._ui_endpoints:
ui_endpoint.set_value(default_active_value)
def _propagate_change(self, changed_endpoint, value):
if changed_endpoint not in self._ui_endpoints:
active = value != self._inactive_value
for endpoint in self._ui_endpoints:
if active and endpoint not in self._endpoints:
self.add_endpoint(endpoint)
elif not active and endpoint in self._endpoints:
self.remove_endpoint(endpoint)
endpoint._object.set_sensitive(active)
Conduit._propagate_change(self, changed_endpoint, value)
class FolderConduitMixin:
def get_ui_endpoints(self, file_chooser, entry, is_local=True):
endpoints = [DelayedEntryEndPoint(entry)]
if is_local:
endpoints.append(FileChooserFolderEndPoint(file_chooser))
file_chooser.set_property("visible", is_local)
entry.set_property("visible", not is_local)
return endpoints
class FolderConduit(Conduit, FolderConduitMixin):
def __init__(self, model_endpoint, file_chooser, entry, is_local=True):
ui_endpoints = self.get_ui_endpoints(file_chooser, entry, is_local)
Conduit.__init__(self, model_endpoint, *ui_endpoints)
class TogglableFolderConduit(ToggableConduit, FolderConduitMixin):
def __init__(self, model_endpoint, checkbox, file_chooser, entry,
is_local=True, default_folder=""):
ui_endpoints = self.get_ui_endpoints(file_chooser, entry, is_local)
ToggableConduit.__init__(self, model_endpoint, checkbox, default_folder,
"", *ui_endpoints)
class PostProcessingComboBoxModel(gtk.ListStore):
class Column:
ID, DESCRIPTION = range(0, 2)
def __init__(self):
gtk.ListStore.__init__(self, int, str)
self.append([PostProcessing.NOTHING,
_("Do nothing ")])
self.append([PostProcessing.REPAIR,
_("Repair downloaded archives if necessary")])
self.append([PostProcessing.UNPACK,
_("Repair and extract downloaded archives")])
self.append([PostProcessing.DELETE,
_("Repair, extract and delete downloaded archives")])
def post_processing_constant_to_index(self, constant):
return [row[self.Column.ID] for row in self].index(constant)
class ProcessingComboBoxEndPoint(GObjectEndPoint):
SIGNAL = "changed"
def get_value(self):
model = self._object.get_model()
iter = self._object.get_active_iter()
return model.get_value(iter, PostProcessingComboBoxModel.Column.ID)
def set_value(self, value):
model = self._object.get_model()
index = model.post_processing_constant_to_index(value)
self._object.set_active(index)
class PostProcessingSoftwareDialog(AdditionalSoftwareDialog):
depends_on(CapabilitiesHub)
def create_ui(self):
AdditionalSoftwareDialog.create_ui(self)
capabilities_hub = self._component_manager.load(CapabilitiesHub)
interface = self._component_manager.load(Backend).interface
descriptions = {
"par": _("%s for verifying and reparing downloads"),
"rar": _("%s for extracting downloaded archives"),
"zip": _("%s for extracting downloaded archives")
}
names = {
"par": _("par2 or par2cmdline "),
"rar": "unrar ",
"zip": "unzip "
}
if interface.connection_info.is_local:
if isfile("/etc/fedora-release"):
names["par"] = "par2cmdline "
else:
try:
with open("/etc/lsb-release") as release_file:
content = release_file.read()
if "Ubuntu" in content or "Debian" in content:
names["par"] = "par2 "
except IOError:
pass
for software in names.keys():
if not capabilities_hub.supports_software(software):
self.add_software(descriptions[software] % names[software])
lottanzb-0.6/lottanzb/gui/prefs/base.py 0000644 0001750 0001750 00000002624 11525760436 020123 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
from lottanzb.gui.framework import SlaveDelegateComponent
from lottanzb.core.component import implements
class ITab:
label = ""
# Help topic to be opened when clicking 'Help'.
help_topic = ""
def set_config(self, lottanzb_config, sabnzbd_config):
pass
def needs_restart(self, lottanzb_config, old_lottanzb_config,
sabnzbd_config, old_sabnzbd_config):
pass
class Tab(SlaveDelegateComponent):
implements(ITab)
help_topic = ""
abstract = True
def set_config(self, lottanzb_config, sabnzbd_config):
pass
def needs_restart(self, lottanzb_config, old_lottanzb_config,
sabnzbd_config, old_sabnzbd_config):
return False lottanzb-0.6/lottanzb/gui/prefs/servers.py 0000644 0001750 0001750 00000036452 11525760436 020710 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import gtk
from distutils.version import LooseVersion
from lottanzb.core.environ import _
from lottanzb.config.sabnzbd.servers import ServerConfig
from lottanzb.backend import Backend
from lottanzb.backend.interface.queries import VersionQuery
from lottanzb.gui.prefs.base import Tab
from lottanzb.gui.prefs.widgets import WarningNotice
from lottanzb.gui.help import open_help
from lottanzb.gui.framework import MainDelegate, SlaveDelegate
from lottanzb.gui.framework.models import ListConfigSectionTreeModel
from lottanzb.gui.framework.proxy import (
GObjectEndPoint, ToggleEndPoint, SpinButtonEndPoint, EntryEndPoint,
PasswordEntryEndPoint, Conduit, ValidatableConduit, HostConduit,
ValidatableConduitCollection)
__all__ = ["ServerTab", "ServerEditorPane", "AddServerDialog",
"EditServerDialog"]
class ServerTab(Tab):
abstract = False
builder_file = "prefs_tab_servers"
label = _("Servers")
help_topic = "news-servers"
def __init__(self, component_manager):
Tab.__init__(self, component_manager)
self._servers = None
self._model = None
self._server_toggle_column = ServerToggleColumn()
self._server_toggle_column.renderer_toggle.connect("toggled",
self.on_renderer_toggled)
self._server_info_column = ServerInfoColumn()
self._server_ssl_column = ServerSSLColumn()
self.tree_view.append_column(self._server_toggle_column)
self.tree_view.append_column(self._server_info_column)
self.tree_view.append_column(self._server_ssl_column)
self._selection = self.tree_view.get_selection()
self._selection.set_mode(gtk.SELECTION_BROWSE)
self._selection.connect("changed", self.on_selection_changed)
interface = self._component_manager.get(Backend).interface
# Make the whole tab insensitive if LottaNZB is connected to SABnzbd 0.6
# or newer, because this version of LottaNZB is not compatible with the
# new server configuration API.
if interface.version == VersionQuery.SpecialVersion.TRUNK or \
interface.version >= LooseVersion("0.6"):
text = _("SABnzbd {version} is not supported yet.\n"
"Use the web interface instead.").format(
version=interface.version,
url=interface.connection_info.url + "config/server")
notice = WarningNotice.build_for_widget(self.container, text)
notice.show()
self.container.set_sensitive(False)
def set_config(self, lottanzb_config, sabnzbd_config):
self._servers = sabnzbd_config.servers
self._model = ListConfigSectionTreeModel(self._servers)
for signal in ("row-inserted", "row-deleted", "row-changed"):
self._model.connect(signal,
self.update_server_column_visibility)
self.update_server_column_visibility()
self.tree_view.set_model(self._model)
if len(self._servers):
self.select_server(self._servers[0])
def update_server_column_visibility(self, *args):
"""Adjust the visibility of the tree view columns.
Only display the check-boxes to enable or disable servers if
- the list consists of more than one server
- the only server in the list is disabled
Only display the SSL column if at least one of the server has SSL
enabled.
"""
self._server_toggle_column.set_visible(len(self._model) > 1 or \
(len(self._model) == 1 and not self._model[0][0].enable))
self._server_ssl_column.set_visible(
any([server.ssl for server in self._servers.values()]))
def remove_selected_server(self):
server = self.get_selected_server()
if server:
from lottanzb.gui.prefs import Window
prefs_window = self._component_manager.get(Window)
dialog = gtk.MessageDialog(parent=None, flags=0,
type=gtk.MESSAGE_WARNING, buttons=gtk.BUTTONS_OK_CANCEL)
dialog.set_property("text", _("Delete server?"))
dialog.format_secondary_text(_("This cannot be undone."))
def on_response(dialog, response):
if response == gtk.RESPONSE_OK:
self._servers.remove(server)
dialog.destroy()
dialog.connect("response", on_response)
dialog.set_transient_for(prefs_window.get_toplevel())
dialog.show()
def edit_selected_server(self):
from lottanzb.gui.prefs import Window
server = self.get_selected_server()
if server:
dialog = EditServerDialog(self._servers, server)
dialog.show(self._component_manager.get(Window).get_toplevel())
def get_selected_server(self):
treeiter = self._selection.get_selected()[1]
if treeiter:
return self._model.get_value(treeiter, 0)
def select_server(self, server):
self._selection.select_path(self._model.get_index(server))
def on_selection_changed(self, selection):
server = self.get_selected_server()
self.edit.set_sensitive(bool(server))
self.remove.set_sensitive(bool(server))
def on_add__clicked(self, widget):
from lottanzb.gui.prefs import Window
dialog = AddServerDialog(self._servers)
dialog.show(self._component_manager.get(Window).get_toplevel())
def on_edit__clicked(self, widget, *args):
self.edit_selected_server()
def on_tree_view__key_press_event(self, widget, event):
if event.keyval == gtk.keysyms.Delete:
self.remove_selected_server()
def on_remove__clicked(self, widget):
self.remove_selected_server()
def on_tree_view__row_activated(self, treeview, path, column):
self.edit_selected_server()
def on_renderer_toggled(self, renderer, path):
server = self._model.get_value(self._model.get_iter(path), 0)
server.enable = not server.enable
class ServerToggleColumn(gtk.TreeViewColumn):
def __init__(self):
gtk.TreeViewColumn.__init__(self, "")
self.renderer_toggle = gtk.CellRendererToggle()
self.renderer_toggle.set_property("activatable", True)
self.pack_start(self.renderer_toggle)
self.set_cell_data_func(self.renderer_toggle, self.renderer_toggle_func)
self.set_expand(False)
def renderer_toggle_func(self, column, renderer, tree_model, rowref):
server = tree_model.get_value(rowref, 0)
if not server: return
renderer.set_active(server.enable)
class ServerInfoColumn(gtk.TreeViewColumn):
def __init__(self):
gtk.TreeViewColumn.__init__(self, "")
self.renderer_text = gtk.CellRendererText()
self.pack_start(self.renderer_text)
self.set_cell_data_func(self.renderer_text, self.renderer_text_func)
self.set_expand(True)
def renderer_text_func(self, column, renderer, tree_model, rowref):
server = tree_model.get_value(rowref, 0)
if not server: return
if server.needs_authentication:
username = server.username
else:
username = "%s " % _("No authentication required")
if server.fillserver:
# LottaNZB users are much more likely to be used to the term
# 'Backup server' compared to 'Fillserver'.
first_line = _("%s (Backup server)") % server.host
else:
first_line = server.host
text = "%s \n%s " % \
(first_line, username)
renderer.set_property("markup", text)
renderer.set_property("sensitive", server.enable)
class ServerSSLColumn(gtk.TreeViewColumn):
def __init__(self):
gtk.TreeViewColumn.__init__(self, "")
self.renderer_ssl = gtk.CellRendererPixbuf()
self.renderer_ssl.set_property("stock-size", gtk.ICON_SIZE_SMALL_TOOLBAR)
self.pack_start(self.renderer_ssl)
self.set_cell_data_func(self.renderer_ssl, self.renderer_ssl_func)
self.set_expand(False)
def renderer_ssl_func(self, column, renderer, tree_model, rowref):
server = tree_model.get_value(rowref, 0)
icon_name = ""
if not server:
return
if server.ssl:
icon_name = "stock_lock"
renderer.set_property("icon-name", icon_name)
renderer.set_property("sensitive", server.enable)
class ServerEditorPane(SlaveDelegate):
"""Slave delegate allowing the user to edit a server (object of type
`config.sabnzbd.servers.ServerConfig').
Any changes are instantaneously applied to the object.
"""
builder_file = "server_editor_pane"
def __init__(self, server_section, server):
"""Specify the server to be edited.
The list of servers (an object of type `config.sabnzbd.servers.Config'.
that the server is or will be part of needs to be passed to the
constructor as well.
It will be required to decide whether to display the 'Use as backup
server' checkbox or not.
"""
SlaveDelegate.__init__(self)
self.server_section = server_section
self.server = server
# The collection of conduits used in the editor pane.
# Can be used by clients to react to changes of its 'is-valid' property,
# e.g. to make a button sensitive or insensitive.
self.conduits = ValidatableConduitCollection()
self.host_conduit = HostConduit(
GObjectEndPoint(self.server, "host"),
EntryEndPoint(self.host))
self.host_conduit.mandatory = True
self.conduits.add(self.host_conduit)
self.conduits.add(ValidatableConduit(
GObjectEndPoint(self.server, "username"),
EntryEndPoint(self.username)))
self.conduits.add(ValidatableConduit(
GObjectEndPoint(self.server, "password"),
PasswordEntryEndPoint(self.password)))
self.conduits.add(Conduit(
GObjectEndPoint(self.server, "port"),
SpinButtonEndPoint(self.port)))
self.conduits.add(Conduit(
GObjectEndPoint(self.server, "ssl"),
ToggleEndPoint(self.ssl)))
self.conduits.add(Conduit(
GObjectEndPoint(self.server, "fillserver"),
ToggleEndPoint(self.fillserver)))
self.conduits.add(Conduit(
GObjectEndPoint(self.server, "connections"),
SpinButtonEndPoint(self.connections)))
unknown_server = True
known_server_count = len(self.server_section)
# For comparing servers, their properties are compared, instead of their
# object IDs. The server object may have been copied in order to
# implement a 'Save' button.
for a_server in self.server_section.values():
if a_server == server:
unknown_server = False
# Don't display the 'Use as backup server' checkbox in the list of
# servers is empty or if the only server in it is the server currently
# being edited.
# However, always display the 'Use as backup server' checkbox if it
# has already been activated by the user.
self.fillserver.set_property("visible", any([
known_server_count >= 2,
known_server_count and unknown_server,
server.fillserver]))
# Automatically expand the 'Advanced Settings' expander if the server is
# used as backup.
self.advanced_settings.set_expanded(server.fillserver)
def on_ssl__toggled(self, widget):
"""Automatically adjust the port number when SSL is enabled or disabled.
When SSL is enabled and the port is still set to 119, the port will most
likely need to be changed to 563.
When SSL is disabled and the port is still set to 563, the port will
most likely need to be changed to 119.
"""
enabled = widget.get_active()
if enabled and self.server.port == 119:
self.server.port = 563
if not enabled and self.server.port == 563:
self.server.port = 119
class ServerDialog(MainDelegate):
builder_file = "server_dialog"
def __init__(self, server_section, server):
MainDelegate.__init__(self)
self.server = server
self.server_section = server_section
self.editor_pane = ServerEditorPane(server_section, server)
self.attach_slave(self.editor_pane_parent, self.editor_pane)
self.editor_pane.conduits.connect("notify::is-valid",
self.on_validity_changed)
self.on_validity_changed(self.editor_pane.conduits)
def on_validity_changed(self, conduits, *args):
self.save.set_property("sensitive", conduits.is_valid)
def on_server_dialog__response(self, dialog, response):
if response == gtk.RESPONSE_HELP:
open_help("news-servers")
dialog.stop_emission("response")
else:
dialog.hide()
class AddServerDialog(ServerDialog):
def __init__(self, server_section):
ServerDialog.__init__(self, server_section, ServerConfig(-1))
self.get_toplevel().set_title(_("Add Server"))
def on_server_dialog__response(self, dialog, response):
"""Add the newly created server to the list of servers in SABnzbd's
configuration and hide the dialog.
"""
if response == gtk.RESPONSE_OK:
self.server_section.append(self.server)
ServerDialog.on_server_dialog__response(self, dialog, response)
class EditServerDialog(ServerDialog):
def __init__(self, server_section, server):
self.original_server = server
ServerDialog.__init__(self, server_section, server.deep_copy())
self.get_toplevel().set_title(_("Edit Server"))
def on_server_dialog__response(self, dialog, response):
"""Apply all changes made to the server to the server in SABnzbd's
configuration and hide the dialog.
"""
if response == gtk.RESPONSE_OK:
self.original_server.merge(self.server)
ServerDialog.on_server_dialog__response(self, dialog, response)
lottanzb-0.6/lottanzb/gui/prefs/remote_access.py 0000644 0001750 0001750 00000007356 11525760436 022034 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
from lottanzb.core.environ import _
from lottanzb.backend import Backend
from lottanzb.config.sabnzbd import create_api_key
from lottanzb.gui.prefs.base import Tab
from lottanzb.gui.framework.proxy import (
GObjectEndPoint, ToggleEndPoint, SpinButtonEndPoint, DelayedEntryEndPoint,
LabelEndPoint, Conduit, ConduitCollection, DelayedPasswordEntryEndPoint)
class RemoteAccessTab(Tab):
abstract = False
builder_file = "prefs_tab_remote_access"
label = _("Remote Access")
help_topic = "remote-access"
def __init__(self, component_manager):
Tab.__init__(self, component_manager)
self.conduits = ConduitCollection()
def set_config(self, lottanzb_config, sabnzbd_config):
self.conduits.remove_all()
self.conduits.add(Conduit(
GObjectEndPoint(sabnzbd_config.misc, "host"),
RemoteConnnectionEndPoint(self.allow_remote_connections)))
self.conduits.add(Conduit(
GObjectEndPoint(sabnzbd_config.misc, "port"),
SpinButtonEndPoint(self.port)))
self.conduits.add(Conduit(
GObjectEndPoint(sabnzbd_config.misc, "username"),
DelayedEntryEndPoint(self.username)))
self.conduits.add(Conduit(
GObjectEndPoint(sabnzbd_config.misc, "password"),
DelayedPasswordEntryEndPoint(self.password)))
self.conduits.add(Conduit(
GObjectEndPoint(sabnzbd_config.misc, "api_key"),
LabelEndPoint(self.api_key)))
info = self._component_manager.get(Backend).interface.connection_info
self.allow_remote_connections.set_sensitive(info.is_local)
if sabnzbd_config.misc.username or sabnzbd_config.misc.password:
self.authenticate.set_active(True)
else:
self.authenticate.set_active(False)
self.authenticate.emit("toggled")
def on_authenticate__toggled(self, widget):
active = widget.get_active()
self.username.set_sensitive(active)
self.username_label.set_sensitive(active)
self.password.set_sensitive(active)
self.password_label.set_sensitive(active)
if not active:
self.username.set_text("")
self.password.set_text("")
def on_generate_api_key__clicked(self, widget):
self.api_key.set_text(create_api_key())
def needs_restart(self, lottanzb_config, old_lottanzb_config,
sabnzbd_config, old_sabnzbd_config):
old = [old_sabnzbd_config.misc.host, old_sabnzbd_config.misc.port]
new = [sabnzbd_config.misc.host, sabnzbd_config.misc.port]
return old != new
class RemoteConnnectionEndPoint(ToggleEndPoint):
def get_value(self):
if self._object.get_active():
return "0.0.0.0"
else:
return "localhost"
def set_value(self, value):
if value in ("localhost", "127.0.0.1"):
self._object.set_active(False)
else:
self._object.set_active(True)
lottanzb-0.6/lottanzb/gui/prefs/widgets.py 0000644 0001750 0001750 00000010241 11525760436 020651 0 ustar lantash lantash # Copyright (C) 2010-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import re
import gtk
from lottanzb.core.component import depends_on
from lottanzb.core.environ import _
from lottanzb.util.gobject_extras import gsignal
from lottanzb.backend import Backend
from lottanzb.backend.interface.queries import RestartQuery
from lottanzb.gui.framework import MainDelegateComponent
__all__ = ["WarningNotice", "AdditionalSoftwareNotice",
"AdditionalSoftwareDialog"]
class WarningNotice(gtk.Alignment):
"""Simple widget that contains a warning icon and a text right to it."""
def __init__(self, text):
gtk.Alignment.__init__(self)
self._icon = gtk.image_new_from_stock(gtk.STOCK_DIALOG_WARNING,
gtk.ICON_SIZE_MENU)
self._label = gtk.Label()
self._hbox = gtk.HBox(spacing=6)
self._hbox.pack_start(self._icon, expand=False)
self._hbox.pack_start(self._label)
self._hbox.show_all()
self.add(self._hbox)
self._label.set_markup(text)
@classmethod
def build_for_widget(cls, widget, *args):
"""Create a new warning notice and add it below a given widget.
This requires the parent of the widget to be of type `gtk.Bin'.
"""
notice = cls(*args)
bin = widget.parent
if not isinstance(bin, gtk.Bin):
raise ValueError("Parent of `widget' needs to be of type "
"`gtk.Bin', not %r." % type(bin))
bin.remove(widget)
vbox = gtk.VBox()
vbox.pack_start(widget, expand=True)
vbox.pack_start(notice, expand=False)
vbox.set_property("visible", True)
notice.set_property("top-padding", 3)
bin.add(vbox)
return notice
class AdditionalSoftwareNotice(WarningNotice):
gsignal("activated")
def __init__(self):
text = _("Additional software is required.")
text = text.replace("", " ")
WarningNotice.__init__(self, text)
def on_activate_link(widget, *args):
self.emit("activated")
self._label.connect("activate-link", on_activate_link)
class AdditionalSoftwareDialog(MainDelegateComponent):
depends_on(Backend)
builder_file = "additional_software_dialog"
def create_ui(self):
interface = self._component_manager.load(Backend).interface
if interface.connection_info.is_remote:
software_text = _("To make full use of LottaNZB, please install "
"the following software on '%s' and restart SABnzbd using the "
"button below.") % interface.connection_info.host
else:
software_text = _("To make full use of LottaNZB, please install "
"the following software and restart SABnzbd using the button "
"below.")
self.get_toplevel().format_secondary_markup(software_text + "\n\n")
self.get_toplevel().set_default_response(gtk.RESPONSE_CLOSE)
self.get_toplevel().set_focus(self.close)
def add_software(self, software):
text = self.get_toplevel().get_property("secondary-text")
text += " - " + software + "\n"
self.get_toplevel().format_secondary_markup(text)
def on_additional_software_dialog__response(self, widget, response):
if response == gtk.RESPONSE_OK:
backend = self._component_manager.get(Backend)
backend.interface.run_query(RestartQuery())
lottanzb-0.6/lottanzb/gui/prefs/__init__.py 0000644 0001750 0001750 00000010303 11525760436 020741 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import gtk
from lottanzb.config.lotta import ConfigComponent
from lottanzb.core.component import ExtensionPoint, depends_on
from lottanzb.core.environ import _
from lottanzb.util.gobject_extras import gproperty
from lottanzb.gui.help import open_help
from lottanzb.gui.prefs import base, general, servers, remote_access
from lottanzb.gui.framework import MainDelegateComponent
from lottanzb.backend import Backend
from lottanzb.backend.hubs.config import ConfigHub
from lottanzb.backend.interface.queries import RestartQuery
class Window(MainDelegateComponent):
depends_on(ConfigComponent)
depends_on(ConfigHub)
builder_file = "prefs_window"
tabs = ExtensionPoint(base.ITab)
def __init__(self, component_manager):
MainDelegateComponent.__init__(self, component_manager)
# Get both LottaNZB's configuration as well as the configuration of
# SABnzbd instance LottaNZB is connected to.
lotta_config_component = self._component_manager.get(ConfigComponent)
sabnzbd_config_hub = self._component_manager.get(ConfigHub)
self.lottanzb_config = lotta_config_component.root
self.sabnzbd_config = sabnzbd_config_hub.config
# Make a backup of the configurations that will be used to check
# if the user has changed anything.
self.old_lottanzb_config = self.lottanzb_config.deep_copy()
self.old_sabnzbd_config = self.sabnzbd_config.silent_deep_copy()
# Add all available tabs to the dialog.
# TODO: Tab order?
for tab_class in self.tabs:
tab = self._component_manager.load(tab_class)
tab.set_config(self.lottanzb_config, self.sabnzbd_config)
self._add_tab(tab)
def _add_tab(self, tab):
"""Add a tab to the preferences window."""
position = len(self.tabs)
eventbox = gtk.EventBox()
eventbox.show()
self.notebook.insert_page(eventbox, gtk.Label(tab.label), position)
self.attach_slave(eventbox, tab)
def on_unload(self):
"""
Save LottaNZB's configuration, unload all tabs and restart SABnzbd
if the user has made changes to the configuration that require so.
"""
# Only save the configuration if it has changed.
if self.old_lottanzb_config != self.lottanzb_config:
self.lottanzb_config.save()
needs_restart = False
for tab_class in self.tabs:
tab = self._component_manager.get(tab_class)
if tab and tab.needs_restart(
self.lottanzb_config, self.old_lottanzb_config,
self.sabnzbd_config, self.old_sabnzbd_config):
needs_restart = True
for tab_class in self.tabs:
self._component_manager.unload(tab_class)
if needs_restart:
backend = self._component_manager.get(Backend)
backend.interface.run_query(RestartQuery())
MainDelegateComponent.on_unload(self)
@property
def current_tab(self):
"""The tab currently being displayed."""
current_page = self.notebook.get_current_page()
eventbox = self.notebook.get_nth_page(current_page)
return self.get_slave(eventbox)
def on_prefs_window__response(self, window, response):
if response == gtk.RESPONSE_HELP:
open_help(self.current_tab.help_topic)
window.stop_emission("response")
lottanzb-0.6/lottanzb/gui/download_properties.py 0000644 0001750 0001750 00000030524 11525760436 022155 0 ustar lantash lantash # Copyright (C) 2008-2009 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import re
import gtk
from lottanzb.core.constants import Priority
from lottanzb.core.environ import _
from lottanzb.core.component import depends_on
from lottanzb.util.misc import open_folder
from lottanzb.util.signalmanager import SignalManager
from lottanzb.backend import Backend
from lottanzb.backend.hubs.general import GeneralHub
from lottanzb.backend.hubs.general.download import Status, StatusGroup
from lottanzb.gui.framework import MainDelegateComponent
class Dialog(MainDelegateComponent):
depends_on(GeneralHub)
depends_on(Backend)
builder_file = "properties_dialog"
PRIORITIES = [Priority.TOP, Priority.HIGH, Priority.NORMAL, Priority.LOW]
def __init__(self, component_manager):
self.download = None
self._signal_manager = SignalManager()
# Holds the objects of type `ActivityField' bound to a certain download
# set using `set_download'.
self._activity_fields = []
MainDelegateComponent.__init__(self, component_manager)
def create_ui(self):
for priority in self.PRIORITIES:
self.priority_store.append((Priority.to_pretty_string(priority), ))
def set_download(self, download):
self.download = download
self._signal_manager.disconnect_all()
# Remove all existing activity fields.
for activity_field in self._activity_fields:
self.activity_table.remove(activity_field.label)
self.activity_table.remove(activity_field.content)
self.label_size_group.remove_widget(activity_field.label)
activity_field.destroy()
# Instantiate new activity fields, bound to `download'.
self._activity_fields = [
StatusField(download),
FormattedActivityField(download, _("Downloaded"),
"{0.size_downloaded} / {0.size} ({0.percentage}%)",
StatusGroup.NOT_FULLY_LOADED),
FormattedActivityField(download, _("Size"),
"{0.size}", StatusGroup.FULLY_LOADED),
FormattedActivityField(download, _("Time left"),
"{0.time_left.short}", Status.DOWNLOADING),
FormattedActivityField(download, _("ETA"),
"{0.eta.full}", Status.DOWNLOADING),
FormattedActivityField(download, _("Age"),
"{0.average_age.short}", StatusGroup.NOT_FULLY_LOADED),
FormattedActivityField(download, _("Download time"),
"{0.download_time.short}", StatusGroup.FULLY_LOADED),
FormattedActivityField(download, _("Post-processing"),
"{0.postprocessing_time.short}", StatusGroup.COMPLETE),
FormattedActivityField(download, _("Completed"),
"{0.completed.full}", StatusGroup.COMPLETE),
ErrorMessageField(download)]
self.activity_table.resize(len(self._activity_fields), 2)
# Add all activity fields to the activity table
for index, activity_field in enumerate(self._activity_fields):
self.activity_table.attach(activity_field.label, 0, 1, index,
index + 1, xoptions=gtk.FILL, ypadding=3)
self.activity_table.attach(activity_field.content, 1, 2, index,
index + 1, ypadding=3)
self.label_size_group.add_widget(activity_field.label)
self._signal_manager.connect(self.download, "notify::status",
self.on_download_status_changed)
self.on_download_status_changed(self.download)
# Change download name seamlessly
self.name.set_text(self.download.name)
self._signal_manager.connect(self.name, "changed", self.update_name)
# Change download priority seamlessly
self.priority.set_active(self.PRIORITIES.index(self.download.priority))
self._signal_manager.connect(self.priority, "changed",
self.update_priority)
def update_name(self, *args):
if self.name.get_text() != "":
new_name = self.name.get_text()
general_hub = self._component_manager.get(GeneralHub)
general_hub.rename_download(self.download, new_name)
def update_priority(self, *args):
new_priority = self.PRIORITIES[self.priority.get_active()]
general_hub = self._component_manager.get(GeneralHub)
general_hub.set_priority(new_priority, self.download)
def on_download_status_changed(self, download, *args):
backend = self._component_manager.get(Backend)
is_local = backend.interface.connection_info.is_local
fully_loaded = download.has_status(StatusGroup.FULLY_LOADED)
self.open_button.set_property("visible", is_local and fully_loaded)
self.name.set_sensitive(not fully_loaded)
self.priority.set_sensitive(not fully_loaded)
def on_unload(self):
self._signal_manager.disconnect_all()
MainDelegateComponent.on_unload(self)
def on_open_download_dir__activate(self, widget):
open_folder(self.download.storage_path)
class ActivityField:
"""A certain entry in the 'Activity' section of the dialog.
It's bound to a certain download and only exists as long as that particular
download is being displayed in the dialog. The activity field will take care
of updating its information when the download information changes.
It will be visible iff the download has the status passed as the
`visibility' argument.
"""
def __init__(self, download, label, visibility=StatusGroup.ANY_STATUS):
self._label = gtk.Label(label + ":")
self._label.set_alignment(0.0, 0.0)
self.download = download
self.visibility = visibility
self.download.connect("notify::status", self.on_download_status_changed)
self.download.notify("status")
def on_download_status_changed(self, download, prop):
"""Update the visibility of the activity field."""
visible = download.has_status(self.visibility)
self.label.set_property("visible", visible)
self.content.set_property("visible", visible)
@property
def label(self):
"""The `gtk.Label' to be displayed on the left of the activity field."""
return self._label
@property
def content(self):
"""The `gtk.Widget' to be displayed on the right of the activity field.
To be implemented by subclasses.
"""
raise NotImplementedError
def destroy(self):
"""Called when the activity field is no longer in use."""
pass
class SimpleActivityField(ActivityField):
"""Abstract activity field whose content is a simple `gtk.Label'.
It features a facility for automatically observing certain properties of
the download for changes. After such a change `update' is called, which
is meant to be implemented by subclasses.
"""
def __init__(self, download, label, visibility=StatusGroup.ANY_STATUS):
self._create_content()
self._signal_manager = SignalManager()
ActivityField.__init__(self, download, label, visibility)
# Observe the download for changes to the properties specified in
# `required_download_properties'.
for prop in self.required_download_properties:
self._signal_manager.connect(download, "notify::" + \
prop.replace("_", "-"), self.on_download_changed)
# Initialize the content.
self.update()
def _create_content(self):
"""Creates the `gtk.Label' that serves as the content."""
self._content = gtk.Label()
self._content.set_alignment(0.0, 0.0)
self._content.set_line_wrap(True)
@property
def content(self):
"""The widget to be displayed on the right of the activity field."""
return self._content
@property
def required_download_properties(self):
"""The names of the properties of the download to be observed for
changes. When such a property is changed, `update' will be called.
To be implemented by subclasses. Simply returns an empty list.
"""
return []
def update(self):
"""Fill `content' with information provided by the download.
To be implemented by subclasses.
"""
raise NotImplementedError
def destroy(self):
"""Called when the activity field is no longer in use."""
self._signal_manager.disconnect_all()
ActivityField.destroy(self)
def on_download_changed(self, download, prop):
self.update()
class FormattedActivityField(SimpleActivityField):
"""Activity field whose content is generated using a format string on
which the download is applied. The download will thereby be the first
and only formatting argument.
Example: "{0.error_message} "
All properties referenced in the content will automatically be observed
for changes.
"""
PROPERTY_PATTERN = re.compile("{0\.([a-zA-Z0-9_]*)")
def __init__(self, download, label, format_string,
visibility=StatusGroup.ANY_STATUS):
self.format_string = format_string
SimpleActivityField.__init__(self, download, label, visibility)
def update(self):
"""The text of `content' is generated by formatting `self.format_string'
using `self.download'.
If a referenced property doesn't exist, the whole string will be
replaced with "Unknown".
"""
try:
text = self.format_string.format(self.download)
except AttributeError:
text = _("Unknown")
self.content.set_text(text)
@property
def required_download_properties(self):
return self.PROPERTY_PATTERN.findall(self.format_string)
class StatusField(SimpleActivityField):
"""The 'Status' activity field."""
def __init__(self, download):
SimpleActivityField.__init__(self, download, _("Status"))
def update(self):
mapping = {
Status.VERIFYING: self.download.verification_percentage,
Status.REPAIRING: self.download.repair_percentage,
Status.EXTRACTING: self.download.unpack_percentage
}
text = Status.to_pretty_string(self.download.status)
if self.download.status in mapping:
percentage = mapping[self.download.status]
text += " ({0}%)".format(percentage)
self.content.set_text(text)
@property
def required_download_properties(self):
return ["status", "verification_percentage", "repair_percentage",
"unpack_percentage"]
class ErrorMessageField(SimpleActivityField):
"""The "Error" activity field."""
def __init__(self, download):
SimpleActivityField.__init__(self, download, _("Error"), Status.FAILED)
def _create_content(self):
text_view = gtk.TextView()
text_view.set_wrap_mode(gtk.WRAP_WORD)
text_view.set_editable(False)
self._content = gtk.ScrolledWindow()
self._content.add(text_view)
self._content.show_all()
self._content.set_policy(gtk.POLICY_NEVER, gtk.POLICY_NEVER)
self._content.set_shadow_type(gtk.SHADOW_ETCHED_IN)
self._buffer = text_view.get_buffer()
def update(self):
message = self.download.error_message
self._buffer.set_text(message)
@property
def required_download_properties(self):
return ["error-message"]
lottanzb-0.6/lottanzb/gui/add_file.py 0000644 0001750 0001750 00000004706 11525760436 017624 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import gtk
import logging
LOG = logging.getLogger(__name__)
from os.path import isfile
from lottanzb.core.environ import _
from lottanzb.core.component import depends_on
from lottanzb.util.gobject_extras import gproperty
from lottanzb.config import ConfigSection
from lottanzb.gui.help import open_help
from lottanzb.gui.framework import MainDelegateComponent
from lottanzb.gui.framework.proxy import (
Conduit, GObjectEndPoint, FileChooserFolderEndPoint)
from lottanzb.backend.hubs.general import GeneralHub
class Config(ConfigSection):
last_location = gproperty(type=str)
class Dialog(MainDelegateComponent):
depends_on(GeneralHub)
builder_file = "add_file_dialog"
def create_ui(self):
file_filter = self.get_toplevel().get_filter()
file_filter.set_name(_("NZB files and archives"))
lowercase_patterns = ["*.nzb", "*.zip", "*.rar", "*.gz"]
uppercase_patterns = [pattern.upper() for pattern in lowercase_patterns]
for pattern in lowercase_patterns + uppercase_patterns:
file_filter.add_pattern(pattern)
Conduit(
GObjectEndPoint(self.config, "last_location"),
FileChooserFolderEndPoint(self.get_toplevel()))
def enqueue_selection(self):
files = self.get_toplevel().get_filenames()
for a_file in [a_file for a_file in files if isfile(a_file)]:
general_hub = self._component_manager.get(GeneralHub)
general_hub.add_file(a_file)
def on_add_file_dialog__response(self, dialog, response):
if response == gtk.RESPONSE_OK:
self.enqueue_selection()
elif response == gtk.RESPONSE_HELP:
open_help("adding-downloads")
dialog.stop_emission("response")
lottanzb-0.6/lottanzb/gui/add_url.py 0000644 0001750 0001750 00000004416 11525760436 017505 0 ustar lantash lantash # Copyright (C) 2010-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import gtk
import re
from lottanzb.core.component import depends_on
from lottanzb.core.environ import _
from lottanzb.gui.help import open_help
from lottanzb.gui.framework import MainDelegateComponent
from lottanzb.gui.framework.proxy import (ValidatableConduit, EntryEndPoint,
ValidationInvalidError)
from lottanzb.backend.hubs.general import GeneralHub
class Dialog(MainDelegateComponent):
depends_on(GeneralHub)
builder_file = "add_url_dialog"
def create_ui(self):
self.conduit = URLConduit(EntryEndPoint(self.url))
self.conduit.mandatory = True
self.conduit.connect("notify::is-valid", self.on_change_validity)
self.on_change_validity()
def on_change_validity(self, *args):
self.add.set_sensitive(self.conduit.is_valid)
def on_add_url_dialog__response(self, dialog, response):
general_hub = self._component_manager.get(GeneralHub)
if response == gtk.RESPONSE_OK and general_hub:
general_hub.add_url(self.url.get_text())
elif response == gtk.RESPONSE_HELP:
open_help("adding-downloads")
dialog.stop_emission("response")
class URLConduit(ValidatableConduit):
URL_REGEX = re.compile(r"""
https?:((//)|(\\\\))+[\w\d:#@%/;$()~_?\+-=\\\.&]*
""", re.VERBOSE)
def validate_endpoint_value(self, endpoint, value):
ValidatableConduit.validate_endpoint_value(self, endpoint, value)
if not self.URL_REGEX.match(value):
raise ValidationInvalidError(self, endpoint, value, \
_("Invalid URL"))
lottanzb-0.6/lottanzb/gui/help.py 0000644 0001750 0001750 00000003747 11525760436 017031 0 ustar lantash lantash # Copyright (C) 2010-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import gtk
import webbrowser
import locale
from os.path import isdir
from subprocess import Popen
from lottanzb.resources import is_installed, get_help
__all__ = ["open_help"]
def open_help(topic=""):
"""Display the application help content.
'yelp' is used for displaying it if its installed. Otherwise, the function
falls back to the LottaNZB website.
The optional `topic' argument can be used to specify a topic ID of the
Mallard-based documentation. Omitting it will cause the help overview to
be displayed.
"""
try:
if not is_installed():
locales = ["C"]
current_locale = locale.getlocale()[0]
if isinstance(current_locale, str) and current_locale != "C":
locales = [current_locale] + locales
for help_dir in [get_help(l) for l in locales]:
if isdir(help_dir):
Popen(["yelp", ".#" + topic], cwd=help_dir)
return
else:
default_screen = gtk.gdk.screen_get_default()
event_time = gtk.get_current_event_time()
gtk.show_uri(default_screen, "ghelp:lottanzb#" + topic, event_time)
except:
webbrowser.open_new_tab("http://www.lottanzb.org/help/%s" % topic)
lottanzb-0.6/lottanzb/gui/messaging/ 0000755 0001750 0001750 00000000000 11525760442 017466 5 ustar lantash lantash lottanzb-0.6/lottanzb/gui/messaging/postprocessing_priority.py 0000644 0001750 0001750 00000013546 11525760436 025077 0 ustar lantash lantash # Copyright (C) 2010-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
"""Allows the user to set the parameters used by SABnzbd for 'nice' and 'ionice'
to more conservatives values (the default values used by LottaNZB) such that
post-processing has the least influence on the user's system. By default,
SABnzbd doesn't adjust the post-processing priority using (io)nice.
It's meant for users who migrate to LottaNZB after having already set up
SABnzbd on their local machine. Changing the (io)nice configuration options for
a remote instance doesn't make sense.
The question asked to the user aims to avoid technical terms. It is only shown
if LottaNZB is connected to a local instance of SABnzb.
"""
import gtk
from lottanzb.core.environ import _
from lottanzb.core.component import depends_on
from lottanzb.core.constants import PostProcessing
from lottanzb.config.section import ConfigSection
from lottanzb.util.gobject_extras import GObject, gproperty, gsignal
from lottanzb.gui.messaging import base
from lottanzb.backend import Backend
from lottanzb.backend.hubs.config import ConfigHub
__all__ = ["MessageProvider", "Message"]
OPTIONS = ("nice", "ionice")
class Action:
"""Enumerations of actions that can be performed by the user.
- `NONE': The user hasn't taken any action.
- `CANCELED': The user has canceled a proposed configuration change.
- `CHANGED': The user has performed a proposed configuration change.
"""
NONE, CANCELED, CHANGED = range(0, 3)
class Config(ConfigSection):
"""Store information used by this module across sessions."""
last_action = gproperty(
nick="The last action performed by the user",
type=int,
default=Action.NONE)
class MessageProvider(base.MessageProvider):
"""When loading the component, an instance of `Message' is published only if
- LottaNZB is connected to a local instance of SABnzbd.
- The configuration options for (io)nice is set to to non-default values.
- The user hasn't discarded such a message in the past.
- SABnzbd is actually set up to perform post-processing.
"""
depends_on(Backend)
depends_on(ConfigHub)
abstract = False
def __init__(self, component_manager):
base.MessageProvider.__init__(self, component_manager)
if self.config.last_action == Action.CANCELED:
# A previously proposed configuration change was canceled.
return
backend = self._component_manager.get(Backend)
is_local = backend.interface.connection_info.is_local
if not is_local:
# LottaNZB is not connected to a local instance of SABnzbd.
return
misc_section = self._component_manager.get(ConfigHub).config.misc
if misc_section.dirscan_opts == PostProcessing.NOTHING:
# SABnzbd doesn't perform any post-processing.
return
uses_default_values = True
for option in OPTIONS:
default = misc_section.get_property_default_value(option)
actual = misc_section.get_property(option)
if default != actual:
uses_default_values = False
if uses_default_values:
return
message = Message(misc_section)
message.connect("action", self.on_message_action)
self.publish_message(message)
def on_message_action(self, message, action):
"""Remember the action performed by the user."""
self.config.last_action = action
class Message(base.Message, GObject):
"""The message letting the user change the (io)nice configuration options.
The 'action' signal is emitted when the user has clicked one of the two
buttons 'Cancel' or 'Decrease Priority'. Its only argument is a constant of
`Action'.
"""
gsignal("action", int)
def __init__(self, misc_section):
self._misc_section = misc_section
base.Message.__init__(self, gtk.MESSAGE_QUESTION)
GObject.__init__(self)
def create_ui(self):
icon = self.create_stock_icon(gtk.STOCK_DIALOG_QUESTION)
label = self.create_multiline_label(
_("Post-processing may slow down system"),
_("It's recommended to decrease the priority of download "
"post-processing. Post-processing may take a bit longer "
"afterwards."))
self._content_area.pack_start(icon, expand=False)
self._content_area.pack_start(label)
self._change_button = self.add_button(_("_Decrease Priority"),
gtk.RESPONSE_OK)
self._cancel_button = self.add_button(_("_Cancel"),
gtk.RESPONSE_CANCEL)
def on_widget__response(self, widget, response):
if response == gtk.RESPONSE_OK:
self._cancel_button.set_property("sensitive", False)
for option in OPTIONS:
default = self._misc_section.get_property_default_value(option)
self._misc_section[option] = default
self.emit("action", Action.CHANGED)
elif response == gtk.RESPONSE_CANCEL:
self.emit("action", Action.CANCELED)
self.hide()
lottanzb-0.6/lottanzb/gui/messaging/base.py 0000644 0001750 0001750 00000011741 11525760436 020761 0 ustar lantash lantash # Copyright (C) 2010-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
"""Base classes to be used for implementing message providers.
Message providers are recommended to inherit from `MessageProvider', while
messages are recommended to be objects of a type inheriting from `Message'.
"""
import gtk
from lottanzb.core.component import Interface, implements
from lottanzb.util.gobject_extras import gsignal
from lottanzb.config.lotta import ConfigurableComponent
from lottanzb.gui.framework import SlaveDelegate
__all__ = ["IMessageProvider", "MessageProvider", "Message"]
class IMessageProvider(Interface):
"""Besides the `messages' property, components implementing
`IMessageProvider' must also provide a signal called 'message-added' with a
single argument providing the message in question.
"""
messages = []
class MessageProvider(ConfigurableComponent):
"""Abstract configurabe component implementing `IMessageProvider'."""
implements(IMessageProvider)
gsignal("message-added", object)
abstract = True
def __init__(self, component_manager):
ConfigurableComponent.__init__(self, component_manager)
self._messages = []
def publish_message(self, message):
"""Append `message' to `_messages' and emit the 'message-added' signal.
"""
self._messages.append(message)
self.emit("message-added", message)
@property
def messages(self):
"""A copy of the internal list of messages."""
return self._messages[:]
class Message(SlaveDelegate):
"""`SlaveDelegate' whose toplevel widget is a `gtk.InfoBar'.
The message type to be used by be specified by passing an appropriate
`gtk.MESSAGE_*' constant to the constructor. It defaults to
`gtk.MESSAGE_INFO'.
"""
def __init__(self, message_type=gtk.MESSAGE_INFO):
if not hasattr(gtk, "InfoBar"):
raise EnvironmentError("The class 'gtk.InfoBar' is not available.")
self.message_type = message_type
SlaveDelegate.__init__(self)
@property
def _content_area(self):
"""The content area of the info bar."""
return self.get_toplevel().get_content_area()
@property
def _action_area(self):
"""The action area of the info bar."""
return self.get_toplevel().get_action_area()
def add_button(self, button_text, response_id):
"""Add a button with the given text and set things up so that clicking
the button will emit the 'response' signal with thegiven `response_id'.
"""
return self.get_toplevel().add_button(button_text, response_id)
def create_default_toplevel(self):
info_bar = gtk.InfoBar()
info_bar.set_message_type(self.message_type)
# Center the buttons in the action area.
info_bar.get_action_area().set_property("layout-style",
gtk.BUTTONBOX_EDGE)
return info_bar
@classmethod
def create_label(cls, markup=""):
"""Create an object of type `gtk.Label' whose markup is set to `markup'.
"""
label = gtk.Label()
label.set_line_wrap(True)
label.set_selectable(True)
label.set_markup(markup)
label.set_alignment(0.0, 0.5)
label.show()
return label
@classmethod
def create_multiline_label(cls, primary_markup, secondary_markup=""):
"""Create an object of type `gtk.VBox' that contains two labels, where
the one above has the bold-faced markup `primary_markup' and the one
below has the small-sized markup `secondary_markup'.
"""
vbox = gtk.VBox(spacing=6)
vbox.show()
primary_label = cls.create_label(
"{0} ".format(primary_markup))
vbox.pack_start(primary_label, expand=False)
if secondary_markup:
secondary_label = cls.create_label(
"{0} ".format(secondary_markup))
vbox.pack_start(secondary_label, expand=False)
return vbox
@classmethod
def create_stock_icon(cls, stock_id):
"""Create a visible stock icon given `stock_id'."""
image = gtk.Image()
image.set_from_stock(stock_id, gtk.ICON_SIZE_DIALOG)
image.show()
return image
lottanzb-0.6/lottanzb/gui/messaging/servers.py 0000644 0001750 0001750 00000005037 11525760436 021541 0 ustar lantash lantash # Copyright (C) 2010-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import gtk
from lottanzb.core.environ import _
from lottanzb.core.component import depends_on
from lottanzb.gui.messaging import base
from lottanzb.backend.hubs.config import ConfigHub
from lottanzb.config.sabnzbd.servers import ServerConfig
from lottanzb.gui.prefs.servers import AddServerDialog
class MessageProvider(base.MessageProvider):
depends_on(ConfigHub)
abstract = False
def __init__(self, component_manager):
base.MessageProvider.__init__(self, component_manager)
config_hub = self._component_manager.get(ConfigHub)
server_section = config_hub.config.servers
if not len(server_section):
message = NoServerMessage(server_section)
self.publish_message(message)
class NoServerMessage(base.Message):
def __init__(self, server_section):
self._server_section = server_section
base.Message.__init__(self, gtk.MESSAGE_WARNING)
server_section.connect("property-changed",
self.on_server_section_changed)
def create_ui(self):
icon = self.create_stock_icon(gtk.STOCK_DIALOG_WARNING)
label = self.create_multiline_label(
_("No news server has been specified."),
_("At least one server is required for downloading."))
self._content_area.pack_start(icon, expand=False)
self._content_area.pack_start(label)
self.add_button(_("_Add Server"), gtk.RESPONSE_OK)
def on_server_section_changed(self, server_section, section, key, value):
if server_section is section:
if isinstance(value, ServerConfig):
self.hide()
def on_widget__response(self, wigdet, response):
if response == gtk.RESPONSE_OK:
dialog = AddServerDialog(self._server_section)
dialog.show()
lottanzb-0.6/lottanzb/gui/messaging/download_import.py 0000644 0001750 0001750 00000021457 11525760436 023255 0 ustar lantash lantash # Copyright (C) 2010-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import gtk
from glob import glob
from os.path import join
from gettext import ngettext
from lottanzb.core.component import depends_on
from lottanzb.core.environ import _
from lottanzb.util.gobject_extras import GObject, gproperty, gsignal
from lottanzb.util.threading_extras import Thread
from lottanzb.config import hellanzb
from lottanzb.config.section import ConfigSection
from lottanzb.config.errors import LoadingError
from lottanzb.gui.messaging import base
from lottanzb.backend.sessions.local import HELLANZB_CONFIG_FILE
from lottanzb.backend.hubs.general import GeneralHub
"""Facilities for importing the NZB files of unfinished HellaNZB downloads.
The module will only consider the HellaNZB directories listed in the HellaNZB
configuration file managed by previous versions of LottaNZB. Both NZBs of
queued and active downloads will be proposed for import using a message
in the main window.
The original NZB files will not be deleted when successfully imported, but
the module remembers that an import has occurred and won't ask once more.
Note that the module depends on GTK 2.18 because its usage of `gtk.InfoBar'.
If an older version of GTK is being used, no message will be displayed.
"""
__all__ = ["MessageProvider", "Message"]
class Action:
"""Enumerations of actions that can be performed by the user.
- `NONE': The user hasn't taken any action.
- `CANCELED': The user has canceled a proposed import.
- `IMPORTED': The user has performed a proposed import.
"""
NONE, CANCELED, IMPORTED = range(0, 3)
class Config(ConfigSection):
"""Store information used by this module across sessions."""
last_action = gproperty(
nick="The last action performed by the user",
type=int,
default=Action.NONE)
class MessageProvider(base.MessageProvider):
"""When loading the component, an instance of `Message' is published only if
NZB files could be found and no other import has previously been performed
or canceled by the user.
"""
depends_on(GeneralHub)
abstract = False
def __init__(self, component_manager):
base.MessageProvider.__init__(self, component_manager)
if self.config.last_action == Action.CANCELED:
# A previously proposed import has been completed.
return
if self.config.last_action == Action.IMPORTED:
# A previously proposed import has been performed.
return
nzb_files = self.get_hellanzb_nzb_files()
if not nzb_files:
# No importable NZB files found.
return
general_hub = self._component_manager.get(GeneralHub)
message = Message(nzb_files, general_hub)
message.connect("action", self.on_message_action)
self.publish_message(message)
def on_message_action(self, message, action):
"""Remember the action performed by the user."""
self.config.last_action = action
@staticmethod
def get_hellanzb_nzb_files():
"""Return a list of all NZB files corresponding to unfinished HellaNZB
downloads.
Both the directories `current_dir' and `queue_dir' specified in
HellaNZB's configuration are searched.
"""
config = hellanzb.Config(HELLANZB_CONFIG_FILE)
result = []
try:
config.load()
except LoadingError:
return
for nzb_directory in [config.current_dir, config.queue_dir]:
if isinstance(nzb_directory, str):
result += glob(join(nzb_directory, "*.nzb"))
return result
class Message(base.Message, GObject):
"""The message letting the user interact with the import functionality.
The 'action' signal is emitted when the user has clicked one of the two
buttons 'Cancel' or 'Import'. Its only argument is a constant of `Action'.
"""
gsignal("action", int)
def __init__(self, nzb_files, general_hub):
self._nzb_files = nzb_files
self._batch_thread = BatchNZBAdditionThread(general_hub, nzb_files[:])
self._batch_thread.connect_async("progress",
self.on_batch_thread_progress)
self._batch_thread.connect_async("completed",
self.on_batch_thread_completed)
base.Message.__init__(self, gtk.MESSAGE_QUESTION)
GObject.__init__(self)
def create_ui(self):
"""Create all parts of the UI and connect to the appropriate signals."""
icon = self.create_stock_icon(gtk.STOCK_DIALOG_QUESTION)
self._intro_view = self.create_multiline_label(
ngettext(
"Import %i incomplete download?",
"Import %i incomplete downloads?",
len(self._nzb_files)) % len(self._nzb_files),
ngettext(
"It was started using a previous version of the program.",
"They were started using a previous versions of the program.",
len(self._nzb_files)) + " " + \
_("Any progress will be lost."))
self._progress_view = self.create_multiline_label(
ngettext(
"Importing %i download...",
"Importing %i downloads...",
len(self._nzb_files)) % len(self._nzb_files))
self._progress_view.hide()
self._progress_bar = gtk.ProgressBar()
self._progress_bar.show()
self._progress_view.pack_start(self._progress_bar, expand=False)
self._content_area.pack_start(icon, expand=False)
self._content_area.pack_start(self._intro_view)
self._content_area.pack_start(self._progress_view)
self._import_button = self.add_button(_("_Import"), gtk.RESPONSE_OK)
self._cancel_button = self.add_button(_("_Cancel"), gtk.RESPONSE_CANCEL)
def on_widget__response(self, widget, response):
"""Perform the appropriate action when one of the buttons is clicked.
If the 'Cancel' button is clicked, stop any active import and hide
the message.
If the 'Import' button is clicked, instantiate `batch_thread' with a
`BatchNZBAdditionThread' given the general hub and the list of NZB
files. The 'Import' button is made insensitive, so that the user cannot
initiate more than one import at once.
"""
if response == gtk.RESPONSE_OK:
self._import_button.set_property("sensitive", False)
self._intro_view.hide()
self._progress_view.show_all()
self._batch_thread.start()
elif response == gtk.RESPONSE_CANCEL:
if self._batch_thread.is_alive():
self._batch_thread.stop()
self._batch_thread.join()
self.emit("action", Action.CANCELED)
self.hide()
def on_batch_thread_completed(self, thread):
"""Hide the message upon completion of the import and remember it."""
self.emit("action", Action.IMPORTED)
self.hide()
def on_batch_thread_progress(self, thread, progress):
"""Update the progress bar after another NZB file has been imported."""
self._progress_bar.set_fraction(progress)
class BatchNZBAdditionThread(Thread):
"""Adds all NZB files in a list to the SABnzbd instance associated with a
given general hub.
It's possible to stop the import by calling the method `stop'.
"""
def __init__(self, general_hub, nzb_files):
self.general_hub = general_hub
self.nzb_files = nzb_files
Thread.__init__(self)
def run(self):
for index, nzb_file in enumerate(self.nzb_files):
if self.thread_stopped.isSet():
return
# TODO: Ugly as the returned thread can either be a `Query' or a
# `QueryWaitingThread'.
thread = self.general_hub.add_file(nzb_file)
thread.join()
self.emit("progress", float(index + 1) / len(self.nzb_files))
self.emit("completed")
lottanzb-0.6/lottanzb/gui/messaging/__init__.py 0000644 0001750 0001750 00000013576 11525760436 021616 0 ustar lantash lantash # Copyright (C) 2010-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
"""Facility making it possible to display non-critical messages to the user in a
non-obstrusive way.
Messages may be provided only by components implementing `IMessageProvider'.
Messages must be objects of type `SlaveDelegate' and must be hidden (emit the
'hide' signal) after the user has interacted with them.
"""
import gtk
from time import time
from gobject import timeout_add
from threading import Lock
from lottanzb.gui.framework import SlaveDelegateComponent
from lottanzb.gui.messaging.base import IMessageProvider, MessageProvider
from lottanzb.core.component import ExtensionPoint
__all__ = ["MessagingManager"]
# The minimal number of seconds between a message being hidden for an arbitrary
# reason and the following message being displayed.
MESSAGE_DELAY = 1.0
class MessagingManager(SlaveDelegateComponent):
"""The area where messages are being displayed.
All message providers are loaded asynchronously.
Decide what messages to display and when and make sure that the messages are
displayed in-order and that only one message is visible at any given
point of time.
If no message is being showed at a given point of time, the messaging area
is hidden.
The component only performs and work if `gtk.InfoBar' is available.
"""
message_providers = ExtensionPoint(IMessageProvider)
def __init__(self, component_manager):
SlaveDelegateComponent.__init__(self, component_manager)
# Access to the the following properties should be mutually exclusive.
self._lock = Lock()
# The point of time when the last message was hidden.
self._last_message_hidden = -1
# The message currently being displayed.
self._current_message = None
# The list of messages to be displayed, where the first message in the
# list will be displayed next.
self._message_queue = []
# TODO: Could be solved more elegantly, because `gtk.InfoBar' is
# actually a requirement of `Message' not `MessagingManager'.
if not hasattr(gtk, "InfoBar"):
# The class `gtk.InfoBar' is not available.
return
self._component_manager.connect_async("component-loaded",
self.on_component_loaded)
# Load all message providers asynchronously.
for message_provider_cls in self.message_providers:
self._component_manager.load_async(message_provider_cls)
def create_default_toplevel(self):
return gtk.EventBox()
def maybe_present_message(self):
"""Display the next message, if it's possible to do so.
For this method to display a new message, there must not be a message
currently being displayed, `_message_queue' must be non-empty and the
the amount of time since the last message was hidden must exceed
`MESSAGE_DELAY'.
"""
with self._lock:
if self._current_message or not self._message_queue:
return
if time() - self._last_message_hidden < MESSAGE_DELAY:
return
self._current_message = self._message_queue.pop()
self._current_message.get_toplevel().connect("hide",
self.on_message_hidden, self._current_message)
self.attach_slave(self.get_toplevel(), self._current_message)
self.show()
def on_component_loaded(self, component_manager, component):
"""If a new message provider has been loaded, get its list of messages
and monitor any new messages published by it.
"""
if isinstance(component, MessageProvider):
with self._lock:
self._message_queue.extend(component.messages)
component.connect("message-added", self.on_message_added)
self.maybe_present_message()
def on_message_added(self, component, message):
"""Add a newly published message to `_message_queue'."""
with self._lock:
if message not in self._message_queue:
self._message_queue.append(message)
self.maybe_present_message()
def on_message_hidden(self, message_toplevel, message):
"""Handle a message that has been hidden for an arbitrary reason.
After `MESSAGE_DELAY' the class will try to display the next message.
"""
if self._current_message is message:
with self._lock:
self.detach_slave(self.get_toplevel())
self.hide()
self._current_message = None
self._last_message_hidden = time()
timeout_add(int(MESSAGE_DELAY * 1000),
self.on_message_hidden_timeout)
def on_message_hidden_timeout(self):
self.maybe_present_message()
return False
def on_unload(self):
"""Unload all message providers."""
for message_provider_cls in self.message_providers:
self._component_manager.unload(message_provider_cls)
SlaveDelegateComponent.on_unload(self)
lottanzb-0.6/lottanzb/gui/about.py 0000644 0001750 0001750 00000001655 11525760436 017207 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
from lottanzb import __version__
from lottanzb.gui.framework import MainDelegateComponent
class Dialog(MainDelegateComponent):
builder_file = "about_dialog"
def create_ui(self):
self.get_toplevel().set_version(__version__)
lottanzb-0.6/lottanzb/gui/restart.py 0000644 0001750 0001750 00000002347 11525760436 017560 0 ustar lantash lantash # Copyright (C) 2010-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import gobject
from lottanzb.util.gtk_extras import gtk_lock
from lottanzb.gui.framework import MainDelegateComponent
class Dialog(MainDelegateComponent):
builder_file = "restart_dialog"
unloaded = False
def create_ui(self):
gobject.timeout_add(40, self.on_progress_timeout)
def on_progress_timeout(self):
with gtk_lock:
self.progress.pulse()
return not self.unloaded
def on_unload(self):
self.unloaded = True
MainDelegateComponent.on_unload(self)
lottanzb-0.6/lottanzb/gui/framework/ 0000755 0001750 0001750 00000000000 11525760442 017506 5 ustar lantash lantash lottanzb-0.6/lottanzb/gui/framework/messages.py 0000644 0001750 0001750 00000006043 11525760436 021675 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
"""
Various functions that run simple message dialogs based on `gtk.MessageDialog`.
Code partially coped from Kiwi: Copyright (C) 2005-2007 Async Open Source
"""
import gtk
__all__ = ["error", "info", "warning", "yesno"]
_BUTTONS = (gtk.BUTTONS_NONE, gtk.BUTTONS_OK, gtk.BUTTONS_CLOSE,
gtk.BUTTONS_CANCEL, gtk.BUTTONS_YES_NO, gtk.BUTTONS_OK_CANCEL)
def _messagedialog(dialog_type, title, message=None, parent=None,
buttons=gtk.BUTTONS_OK, default=gtk.RESPONSE_NONE):
if buttons not in _BUTTONS:
buttons = gtk.BUTTONS_NONE
if parent and not isinstance(parent, gtk.Window):
raise TypeError("parent must be a gtk.Window subclass")
dialog = gtk.MessageDialog(flags=gtk.DIALOG_MODAL, type=dialog_type,
buttons=buttons)
dialog.set_property("text", title)
if message:
if isinstance(message, basestring):
dialog.format_secondary_text(message)
else:
raise TypeError("message must be a string, not %r" % message)
if default != gtk.RESPONSE_NONE:
dialog.set_default_response(default)
if parent:
dialog.set_transient_for(parent)
dialog.set_modal(True)
response = dialog.run()
dialog.destroy()
return response
def _simple(message_type, title, message=None, parent=None, buttons=gtk.BUTTONS_OK,
default=gtk.RESPONSE_NONE):
if buttons == gtk.BUTTONS_OK:
default = gtk.RESPONSE_OK
return _messagedialog(message_type, title, message, parent=parent,
buttons=buttons, default=default)
def error(title, message=None, parent=None, buttons=gtk.BUTTONS_OK,
default=gtk.RESPONSE_NONE):
return _simple(gtk.MESSAGE_ERROR, title, message, parent=parent,
buttons=buttons, default=default)
def info(title, message=None, parent=None, buttons=gtk.BUTTONS_OK,
default=gtk.RESPONSE_NONE):
return _simple(gtk.MESSAGE_INFO, title, message, parent=parent,
buttons=buttons, default=default)
def warning(title, message=None, parent=None, buttons=gtk.BUTTONS_OK,
default=gtk.RESPONSE_NONE):
return _simple(gtk.MESSAGE_WARNING, title, message, parent=parent,
buttons=buttons, default=default)
def yesno(text, parent=None, default=gtk.RESPONSE_YES,
buttons=gtk.BUTTONS_YES_NO):
return _messagedialog(gtk.MESSAGE_WARNING, text, None, parent,
buttons=buttons, default=default)
lottanzb-0.6/lottanzb/gui/framework/widgets.py 0000644 0001750 0001750 00000007577 11525760436 021551 0 ustar lantash lantash # Copyright (C) 2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import gtk
from lottanzb.util.gobject_extras import gproperty, gsignal
__all__ = ["MenuButton"]
class MenuButton(gtk.ToggleButton):
gsignal("show-menu")
_menu_deactivate_id = -1
_menu = None
def set_menu(self, menu):
if not menu and not isinstance(menu, gtk.Menu):
raise ValueError("expected gtk.Menu, got %s", type(menu))
if self._menu is not menu:
if self._menu and self._menu.get_visible():
self._menu.deactivate()
if self._menu:
self._menu.disconnect(self._menu_deactivate_id)
self._menu.detach()
self._menu = menu
if self._menu:
self.set_sensitive(True)
self._menu.attach_to_widget(self, self._menu_detach_func)
self._menu_deactivate_id = self._menu.connect("deactivate",
self._on_menu_deactivate)
else:
self.set_sensitive(False)
self.notify("menu")
def get_menu(self):
return self._menu
menu = gproperty(type=object, getter=get_menu, setter=set_menu)
def __init__(self, label=None, use_underline=True):
gtk.ToggleButton.__init__(self, label, use_underline)
self.connect("state-changed", self._on_state_changed)
self.connect("toggled", self._on_toggled)
self.connect("button-press-event", self._on_button_press_event)
# TODO/heseveri: Need to disconnect signal handlers and detach menu when
# the widget is destroyed?
def _popup_menu_under_button(self, event=None):
self.emit("show-menu")
if not self._menu:
return
if event is None:
button = 0
time = gtk.get_current_event_time()
else:
button = event.button
time = event.time
self._menu.popup(None, None, self._menu_position_func, button, time)
def _menu_position_func(self, button):
direction = self.get_direction()
menu_req_width, menu_req_height = self._menu.size_request()
x, y = self.window.get_origin()
x += self.allocation.x
y += self.allocation.y + self.allocation.height
return x, y, True
def _menu_detach_func(self, menu, widget):
self._menu = None
def _on_state_changed(self, widget, state):
if not self.is_sensitive() and self._menu:
self._menu.deactivate()
def _on_toggled(self, widget):
if not self._menu:
return
if self.get_active() and not self._menu.get_visible():
# We get here only when a menu is activated by a key press, so that
# we can select the first menu item
self._popup_menu_under_button()
self._menu.select_first(False)
def _on_button_press_event(self, widget, event):
if event.button == 1:
self._popup_menu_under_button()
self.set_active(True)
return True
else:
return False
def _on_menu_deactivate(self, menu):
self.set_active(False)
lottanzb-0.6/lottanzb/gui/framework/models.py 0000644 0001750 0001750 00000007013 11525760436 021347 0 ustar lantash lantash # Copyright (C) 2010-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import gtk
from lottanzb.config.errors import InexistentOptionError
class ListConfigSectionTreeModel(gtk.GenericTreeModel):
def __init__(self, section):
self._section = section
self._section.connect("property-deleted", self.on_property_deleted)
self._section.connect("property-changed", self.on_property_changed)
self._items_by_id = {}
for item in section.values():
self._items_by_id[id(item)] = item
gtk.GenericTreeModel.__init__(self)
def on_property_deleted(self, section, source_section, key, value):
if source_section is section:
path = self.get_index(value)
self.emit("row-deleted", path)
del self._items_by_id[id(value)]
def on_property_changed(self, section, source_section, key, value):
if source_section is section:
item = value
else:
item = source_section
while not item.get_parent() is section:
item = item.get_parent()
path = self.get_index(item)
if id(item) in self._items_by_id:
self.emit("row-changed", path, self.get_iter(path))
else:
self._items_by_id[id(item)] = item
self.emit("row-inserted", path, self.get_iter(path))
def on_get_flags(self):
return gtk.TREE_MODEL_ITERS_PERSIST | gtk.TREE_MODEL_LIST_ONLY
def on_get_n_columns(self):
return 1
def on_get_column_type(self, index):
return object
def on_get_iter(self, path):
# Will be called at least once with argument `(0,)', no matter whether
# there are any items in the list.
try:
return id(self._section[path[0]])
except InexistentOptionError:
return None
def on_get_path(self, rowref):
return self.get_index(self._items_by_id[rowref])
def on_get_value(self, rowref, column):
return self._items_by_id[rowref]
def on_iter_next(self, rowref):
try:
return id(self._section[self.on_get_path(rowref) + 1])
except InexistentOptionError:
return None
def on_iter_children(self, parent):
if parent:
return None
return self._section[0]
def on_iter_has_child(self, rowref):
return False
def on_iter_n_children(self, rowref):
if rowref:
return 0
return len(self._section)
def on_iter_nth_child(self, parent, n):
if parent:
return None
try:
return self._section[n]
except InexistentOptionError:
return None
def on_iter_parent(self, child):
return None
def get_index(self, item):
return int(item.get_name())
lottanzb-0.6/lottanzb/gui/framework/proxy.py 0000644 0001750 0001750 00000035202 11525760436 021246 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import gtk
from logging import getLogger
LOG = getLogger(__name__)
from gobject import idle_add
from threading import Lock
from os.path import isdir, isfile
from lottanzb.core.environ import _
from lottanzb.util.gobject_extras import GObject, gproperty, gsignal
from lottanzb.util.gtk_extras import gtk_lock
from lottanzb.util.regex import (
IPv4_ADDRESS_PATTERN,
IPv6_ADDRESS_PATTERN,
HOST_NAME_PATTERN
)
class EndPoint(object):
validation_error = None
def attach_to_conduit(self, change_callback):
raise NotImplementedError
def detach_from_conduit(self):
raise NotImplementedError
def get_value(self):
raise NotImplementedError
def set_value(self, value):
raise NotImplementedError
def set_valid(self):
self.validation_error = None
def set_invalid(self, error):
self.validation_error = error
class GObjectEndPoint(EndPoint):
PROPERTY = ""
SIGNAL = ""
def __init__(self, _object, prop="", signal=""):
EndPoint.__init__(self)
self._object = _object
self._property = prop or self.PROPERTY
if signal or self.SIGNAL:
self._signal = signal or self.SIGNAL
elif self._property:
# That was one nasty bug:
# The 'notify::' signal will only be emitted properly when the
# property name contains '-' characters instead of '_'.
self._signal = "notify::%s" % self._property.replace("_", "-")
else:
raise ValueError("%r requires a property or signal name." % self)
self._signal_id = -1
self._change_callback = None
def attach_to_conduit(self, change_callback):
self._change_callback = change_callback
if isinstance(self._object, gtk.Widget):
handler = gtk_lock.locked(self._on_changed)
else:
handler = self._on_changed
self._signal_id = self._object.connect(self._signal, handler)
def _on_changed(self, *args):
self._change_callback(self)
def detach_from_conduit(self):
if self._signal_id == -1:
raise ValueError("%r is not attached to a conduit" % self)
else:
self._object.disconnect(self._signal_id)
self._signal_id = -1
self._change_callback = None
def get_value(self):
if not self._property:
raise ValueError("%r needs to override `get_value` or specify a "
"property." % self)
return self._object.get_property(self._property)
def set_value(self, value):
if not self._property:
raise ValueError("%r needs to override `set_value` or specify a "
"property." % self)
return self._object.set_property(self._property, value)
class ToggleEndPoint(GObjectEndPoint):
SIGNAL = "toggled"
PROPERTY = "active"
class LabelEndPoint(GObjectEndPoint):
PROPERTY = "label"
class EntryEndPoint(GObjectEndPoint):
PROPERTY = "text"
def set_valid(self):
GObjectEndPoint.set_valid(self)
self._object.set_property("secondary-icon-stock", None)
self._object.set_property("secondary-icon-tooltip-markup", None)
def set_invalid(self, error):
GObjectEndPoint.set_invalid(self, error)
if isinstance(error, ValidationEmptyError):
stock_id = "gtk-edit"
else:
stock_id = "gtk-dialog-error"
self._object.set_property("secondary-icon-stock", stock_id)
self._object.set_property("secondary-icon-tooltip-text", error.message)
class DelayedEntryEndPoint(EntryEndPoint):
def __init__(self, widget):
EntryEndPoint.__init__(self, widget)
self._changed = False
self._focus_out_signal_id = -1
def attach_to_conduit(self, change_callback):
EntryEndPoint.attach_to_conduit(self, change_callback)
self._focus_out_signal_id = self._object.connect("focus-out-event",
self._on_focus_out_event)
def detach_from_conduit(self):
EntryEndPoint.detach_from_conduit(self)
self._object.disconnect(self._focus_out_signal_id)
def _on_changed(self, *args):
if self._object.get_property("has-focus"):
self._changed = True
else:
EntryEndPoint._on_changed(self, *args)
def _on_focus_out_event(self, widget, event):
if self._changed:
self._on_changed()
self._changed = False
def set_value(self, value):
if self._object.get_property("has-focus"):
return
EntryEndPoint.set_value(self, value)
class PasswordEntryEndPoint(EntryEndPoint):
def __init__(self, widget):
self._old_value = None
EntryEndPoint.__init__(self, widget)
def _on_changed(self, *args):
# Only clear a masked password (e.g. '****') as soon as the user makes
# the first change to it, rather than when the entry is focused.
# This prevents the user from accidentally clearing the password by
# clicking on the entry.
if self._old_value is None:
self._old_value = self.get_value()
elif self._old_value and "*" * len(self._old_value) == self._old_value:
self._old_value = ""
# This method is called by a handler of the 'notify::text' signal.
# Since, `set_text' will also cause this signal to be emitted,
# we defer the call to `set_text' so that the first signal be
# fully emitted.
idle_add(self._object.set_text, "")
return
EntryEndPoint._on_changed(self, *args)
class DelayedPasswordEntryEndPoint(DelayedEntryEndPoint):
def __init__(self, widget):
DelayedEntryEndPoint.__init__(self, widget)
self._object.connect("focus-in-event", self.on_focus_in_event)
def on_focus_in_event(self, widget, event):
value = widget.get_text()
if "*" * len(value) == value:
widget.set_text("")
class FileChooserFolderEndPoint(GObjectEndPoint):
SIGNAL = "current-folder-changed"
def get_value(self):
return self._object.get_current_folder()
def set_value(self, value):
if isdir(value):
self._object.set_current_folder(value)
class ToggleActionEndPoint(GObjectEndPoint):
SIGNAL = "toggled"
def get_value(self):
return self._object.get_active()
def set_value(self, value):
self._object.set_active(value)
class FileChooserButtonEndPoint(GObjectEndPoint):
SIGNAL = "file-set"
def get_value(self):
return self._object.get_filename()
def set_value(self, value):
if isfile(value):
self._object.set_filename(value)
class SpinButtonEndPoint(GObjectEndPoint):
SIGNAL = "value-changed"
PROPERTY = "value"
class Conduit(GObject):
gsignal("changed", object, object)
def __init__(self, model_endpoint, *endpoints):
GObject.__init__(self)
self._endpoints = []
self._lock = Lock()
self.add_endpoint(model_endpoint)
for endpoint in endpoints:
self.add_endpoint(endpoint)
def get_model_endpoint(self):
if self._endpoints:
return self._endpoints[0]
def is_model_endpoint(self, endpoint):
return endpoint is self._endpoints[0]
def publish_model_endpoint(self):
model_endpoint = self.get_model_endpoint()
if model_endpoint:
self.on_endpoint_changed(model_endpoint)
def add_endpoint(self, endpoint):
endpoint.attach_to_conduit(self.on_endpoint_changed)
self._endpoints.append(endpoint)
# If new endpoints are added to the conduit, they must be updated
# based on the model endpoint.
# every endpoint except for the model endpoint, which is inefficient
# in the case of three or more endpoints.
self.publish_model_endpoint()
def remove_endpoint(self, endpoint):
self._endpoints.remove(endpoint)
endpoint.detach_from_conduit()
def on_endpoint_changed(self, changed_endpoint):
if self._lock.acquire(False):
try:
value = changed_endpoint.get_value()
self._propagate_change(changed_endpoint, value)
finally:
self._lock.release()
def _propagate_change(self, changed_endpoint, value):
for endpoint in self._endpoints:
if not endpoint is changed_endpoint:
endpoint.set_value(value)
self.emit("changed", changed_endpoint, value)
def destroy(self):
for endpoint in self._endpoints:
self.remove_endpoint(endpoint)
class ValidationError(Exception):
def __init__(self, conduit, end_point, value, message=""):
self.conduit = conduit
self.end_point = end_point
self.value = value
self.message = message or _("Invalid value")
def __str__(self):
return "Invalid value %r for end point %r in conduit %r." % (
self.value, self.end_point, self.conduit)
class ValidationEmptyError(ValidationError):
def __init__(self, conduit, end_point, value, message=""):
message = message or _("This field is mandatory")
ValidationError.__init__(self, conduit, end_point, value, message)
def __str__(self):
return "Missing value for end point %r in mandatory conduit %r." % (
self.end_point, self.conduit)
class ValidationInvalidError(ValidationError):
pass
class ValidatableConduit(Conduit):
enable_validation = gproperty(type=bool, default=True)
mandatory = gproperty(type=bool, default=False)
is_valid = gproperty(type=bool, default=True)
def _propagate_change(self, changed_endpoint, value):
validation_error = None
if self.enable_validation:
try:
self.validate_endpoint_value(changed_endpoint, value)
except ValidationError as error:
LOG.debug(str(error))
validation_error = error
Conduit._propagate_change(self, changed_endpoint, value)
if validation_error:
self.is_valid = False
for endpoint in self._endpoints:
endpoint.set_invalid(validation_error)
elif not self.is_valid:
self.is_valid = True
for endpoint in self._endpoints:
endpoint.set_valid()
def validate(self):
is_valid = True
if self.enable_validation:
for endpoint in self._endpoints:
try:
self.validate_endpoint_value(endpoint, endpoint.get_value())
except ValidationError as error:
is_valid = False
if endpoint is self.get_model_endpoint():
for endpoint in self._endpoints:
endpoint.set_invalid(error)
else:
endpoint.set_invalid(error)
else:
endpoint.set_valid()
self.is_valid = is_valid
def validate_endpoint_value(self, endpoint, value):
if self.mandatory and not value:
raise ValidationEmptyError(self, endpoint, value)
def set_property(self, key, value):
changed = Conduit.set_property(self, key, value)
if changed and key in ("mandatory", "enable_validation"):
self.validate()
class HostConduit(ValidatableConduit):
PATTERNS = (IPv4_ADDRESS_PATTERN, IPv6_ADDRESS_PATTERN, HOST_NAME_PATTERN)
def validate_endpoint_value(self, endpoint, value):
ValidatableConduit.validate_endpoint_value(self, endpoint, value)
for pattern in self.PATTERNS:
if pattern.match(value):
return
raise ValidationInvalidError(self, endpoint, value,
_("Invalid IP address or host name"))
class ConduitCollection(GObject):
def __init__(self, *conduits):
GObject.__init__(self)
self._conduits = []
for conduit in conduits:
self.add(conduit)
def add(self, conduit):
self._conduits.append(conduit)
def remove(self, conduit):
self._conduits.remove(conduit)
conduit.destroy()
def remove_all(self):
for conduit in self._conduits:
self.remove(conduit)
class ValidatableConduitCollection(ConduitCollection):
is_valid = gproperty(type=bool, default=True)
def __init__(self, *conduits):
self._signal_ids = {}
ConduitCollection.__init__(self, *conduits)
def add(self, conduit):
ConduitCollection.add(self, conduit)
if isinstance(conduit, ValidatableConduit):
self._signal_ids[conduit] = conduit.connect("notify::is-valid",
self.on_validation_changed)
if self.is_valid and not conduit.is_valid:
self.is_valid = False
def remove(self, conduit):
ConduitCollection.remove(self, conduit)
if isinstance(conduit, ValidatableConduit):
conduit.disconnect(self._signal_ids.pop(conduit))
self.on_validation_changed()
def validate(self):
for conduit in self._conduits:
if isinstance(conduit, ValidatableConduit):
conduit.validate()
def on_validation_changed(self, *args):
is_valid = True
for conduit in self._conduits:
if isinstance(conduit, ValidatableConduit) and not conduit.is_valid:
is_valid = False
self.is_valid = is_valid
lottanzb-0.6/lottanzb/gui/framework/__init__.py 0000644 0001750 0001750 00000027413 11525760436 021631 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import gobject
import gtk
import re
from lottanzb import resources
from lottanzb.core import environ
from lottanzb.config.lotta import ConfigurableComponent
from lottanzb.util.signalmanager import SignalManager
from lottanzb.util.gtk_extras import gtk_lock
__all__ = ["BaseDelegate", "SlaveDelegate", "MainDelegate",
"SlaveDelegateComponent", "MainDelegateComponent"]
class BaseDelegate:
"""
Abstract base delegate functionality.
It uses hand-created and GTKBuilder-created UIs, and combinations of the
two, and is responsible for automatically loading UI files from resources,
and connecting signals.
The abstract elements of this class are:
1. The way it gets a top-level widget from a UI file
2. How it creates a default top-level widget if one was not found in the
UI file, or no UI file is specified.
"""
builder_file = None
toplevel_name = "main"
def __init__(self):
self._toplevel = None
self._slaves = {}
self._signal_manager = SignalManager()
self._load_builder()
if self._toplevel is None:
self._toplevel = self.create_default_toplevel()
self.widget = self._toplevel
self.create_ui()
self._connect_signals()
# Public API
def get_builder_toplevel(self, builder):
"""Get the top-level widget from a GTKBuilder file."""
raise NotImplementedError
def create_default_toplevel(self):
raise NotImplementedError
def _load_builder(self):
if not self.builder_file:
return
builder_file = self.builder_file
if not builder_file.endswith(".ui"):
builder_file += ".ui"
builder = gtk.Builder()
builder.set_translation_domain(environ.DOMAIN)
builder.add_from_file(resources.get_ui(builder_file))
self._toplevel = self.get_builder_toplevel(builder)
for obj in builder.get_objects():
name = ""
try:
# Ugly fix for bug #507739.
# Starting with GTK 2.19, the `gtk.Widget` method `get_name`
# doesn't work anymore. The problem is that the "name" property
# is only meant to be used w.r.t. themes and doesn't need to be
# unique. The GtkBuilder ID however needs to be unique and was
# bound to the "name" property before GTK 2.18.
# Right now, there is no clean way to get the GtkBuilder ID
# through the PyGTK API.
# For those objects, that don't implement `gtk.Buildable`, it's
# still necesssary to use the `name` property.
if isinstance(obj, gtk.Buildable):
name = gtk.Buildable.get_name(obj)
else:
name = obj.get_property("name")
except TypeError:
pass
else:
if name:
setattr(self, name, obj)
def _connect_signals(self):
HANDLER_PATTERN = re.compile("""
(?P(on|after))_
(?P\w+)__
(?P\w+)
""", re.VERBOSE)
for name in dir(self):
match = HANDLER_PATTERN.match(name)
if match:
method = getattr(self, name)
signal_type = match.groupdict()["signal_type"]
widget_name = match.groupdict()["widget_name"]
signal_name = match.groupdict()["signal_name"]
widget = getattr(self, widget_name, None)
if widget is None:
raise LookupError("Widget named '%s' is not available." % \
widget_name)
if signal_type == "on":
widget.connect(signal_name, gtk_lock.locked(method))
elif signal_type == "after":
widget.connect_after(signal_name, gtk_lock.locked(method))
@staticmethod
def _get_first_builder_window(builder):
"""
Get the first top-level widget in a gtk.Builder hierarchy.
This is mostly used for guessing purposes, and an explicit naming is
always going to be a better situation.
"""
for obj in builder.get_objects():
if isinstance(obj, gtk.Window):
return obj
def show(self, parent=None):
"""Shows the top-level widget"""
if hasattr(self._toplevel, "present"):
self._toplevel.present()
else:
self._toplevel.show()
if parent is not None:
self._toplevel.set_transient_for(parent)
def hide(self):
"""Hide the top-level widget"""
self._toplevel.hide()
def get_slave(self, parent):
return self._slaves.get(parent, None)
def attach_slave(self, parent, slave, sync_visibility=True):
"""Add `slave' to the `parent' widget and make the slave visible.
No other slave must already be attached to that parent.
When `sync_visibility' is set to True, the parent's visibility
is synchronized with the slave's visibiity. Thus, if the slave is
hidden, the parent will be, too. This is useful if the parent is a
simple `gtk.EventBox' in a `gtk.HBox' or `gtk.VBox'. If the box
has a spacing, setting `sync_visibility' to True will prevent
unnecessary spacings when the slave is hidden.
"""
if not isinstance(slave, SlaveDelegate):
raise ValueError("Slave %r is not a SlaveDelegate." % slave);
if parent in self._slaves:
raise ValueError("A slave is already attached to %r." % parent);
self._slaves[parent] = slave
parent.add(slave._toplevel)
slave.handle_attached(self)
if sync_visibility:
self._signal_manager.connect(slave.get_toplevel(),
"notify::visible", self.on_slave_visibility_changed, parent)
slave.show()
def detach_slave(self, parent):
if parent in self._slaves:
slave = self._slaves[parent]
parent.remove(slave.get_toplevel())
slave.handle_detached(self)
# Does not care whether `sync_visibility' was set or not.
self._signal_manager.disconnect(slave)
del self._slaves[parent]
def detach_all_slaves(self):
for parent in dict(self._slaves):
self.detach_slave(parent)
def get_toplevel(self):
return self._toplevel
def create_ui(self):
"""
Create any UI by hand.
Override to create additional UI here.
This can contain any instance initialization, so for example mutation of
the gtk.Builder generated UI, or creating the UI in its entirety.
"""
def on_slave_visibility_changed(self, slave, prop, parent):
"""Apply the visibility of `slave' to `parent'."""
parent.set_property("visible", slave.get_property("visible"))
class SlaveDelegate(BaseDelegate):
def get_builder_toplevel(self, builder):
"""
Get the top-level widget from a gtk.Builder file.
The slave view implementation first searches for the widget named as
self.top-level_name (which defaults to "main". If this is missing, the
first top-level widget is discovered in the Builder file, and it's
immediate child is used as the top-level widget for the delegate.
"""
toplevel = builder.get_object(self.toplevel_name)
if toplevel is None:
toplevel = self._get_first_builder_window(builder).child
if toplevel is not None:
toplevel.unparent()
return toplevel
def create_default_toplevel(self):
return gtk.VBox()
def handle_attached(self, parent_delegate):
"""Called when the slave is attached to a `BaseDelegate'.
The `BaseDelegate' is passed as the only argument.
Can be overridden by subclasses and doesn't do anything by default.
"""
pass
def handle_detached(self, parent_delegate):
"""Called when the slave is detached from a `BaseDelegate'.
The `BaseDelegate' is passed as the only argument.
Can be overridden by subclasses and doesn't do anything by default.
"""
pass
class MainDelegate(BaseDelegate):
def get_builder_toplevel(self, builder):
"""
Get the top-level widget from a gtk.Builder file.
The main view implementation first searches for the widget named as
self.top-level_name (which defaults to "main". If this is missing, or not
a gtk.Window, the first top-level window found in the gtk.Builder is
used.
"""
toplevel = builder.get_object(self.toplevel_name)
if not gobject.type_is_a(toplevel, gtk.Window):
toplevel = None
if toplevel is None:
toplevel = self._get_first_builder_window(builder)
return toplevel
def create_default_toplevel(self):
return gtk.Window()
class SlaveDelegateComponent(ConfigurableComponent, SlaveDelegate):
def __init__(self, component_manager):
ConfigurableComponent.__init__(self, component_manager)
SlaveDelegate.__init__(self)
def unload_component(widget, *args):
self._component_manager.unload(self)
self.get_toplevel().connect_after("delete-event", unload_component)
def on_unload(self):
"""Destroy the top-level widget when the component is unloaded."""
self.detach_all_slaves()
self.get_toplevel().destroy()
class MainDelegateComponent(ConfigurableComponent, MainDelegate):
def __init__(self, component_manager):
ConfigurableComponent.__init__(self, component_manager)
MainDelegate.__init__(self)
# Has the descruction of the top-level widget begun are already ended?
self._destroyed = False
# Has the `on_unload' methode been called?
self._on_unload_called = False
if isinstance(self.get_toplevel(), gtk.Dialog):
self.get_toplevel().connect_after("response", self.on_response)
self.get_toplevel().connect_after("destroy", self.on_destroy)
def on_unload(self):
"""Destroy the top-level widget when the component is unloaded."""
self._on_unload_called = True
if not self._destroyed:
self.detach_all_slaves()
self.get_toplevel().destroy()
def on_response(self, widget, response):
self._component_manager.unload(self)
def on_destroy(self, widget):
self._destroyed = True
if not self._on_unload_called:
self._component_manager.unload(self)
lottanzb-0.6/lottanzb/gui/panel_menu.py 0000644 0001750 0001750 00000022536 11525760436 020221 0 ustar lantash lantash # Copyright (C) 2009-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
"""Display a menu in the panel (accessible through an icon) that provides
shortcuts for frequently-used features of the application.
The module both supports the old-fashioned `gtk.StatusIcon' as well as the
concept of application indicators introduced in Ubuntu 10.04. If the module
`appindicator' can be imported, the latter will automatically be used.
"""
import gtk
from lottanzb.core.environ import _
from lottanzb.core.component import (Component, depends_on, implements,
ExtensionPoint, Interface)
from lottanzb.util.gtk_extras import gtk_lock
from lottanzb.gui.main import MainWindow
from lottanzb.gui.framework.proxy import Conduit, EndPoint, ToggleEndPoint
try:
import appindicator
except ImportError:
appindicator = None
class IMenuContainer(Interface):
"""Interface for classes that can set up a menu in the panel."""
def set_menu(self, menu):
pass
def set_visible(self, visible):
pass
class PanelMenuComponent(Component):
"""Build the panel menu and instantiate a suitable `IMenuContainer'.
The menu items are associated with `gtk.Actions' provided by `MainWindow'
and are thus automatically kept in sync in terms of appearance.
A menu item 'Close' is added to the 'File' menu of the main window, allowing
the user to close the window without quitting the application. Additionally,
closing the main window using the window button only hides it.
"""
depends_on(MainWindow)
menu_containers = ExtensionPoint(IMenuContainer)
# The `gtk.Menu' used as the panel menu.
menu = None
# Contains a `MenuContainer` object that represents the actual icon in
# the panel.
menu_container = None
def __init__(self, component_manager):
Component.__init__(self, component_manager)
main_window = self._component_manager.get(MainWindow)
main_window.quit_on_delete = False
with gtk_lock:
self.close_menu_item = gtk.ImageMenuItem(gtk.STOCK_CLOSE)
self.close_menu_item.connect("activate",
gtk_lock.locked(self.on_close_activate))
self.close_menu_item.show()
accel_group = gtk.AccelGroup()
main_window.get_toplevel().add_accel_group(accel_group)
key, mod = gtk.accelerator_parse("W")
self.close_menu_item.add_accelerator("activate", accel_group, key,
mod, gtk.ACCEL_VISIBLE)
file_menu = main_window.file_menu
quit_index = file_menu.get_children().index(main_window.menu_quit)
file_menu.insert(self.close_menu_item, quit_index)
self.visibility_menu_item = gtk.CheckMenuItem(_("Show LottaNZB"))
self.visibility_conduit = Conduit(
MainWindowVisibilityEndPoint(main_window.get_toplevel()),
ToggleEndPoint(self.visibility_menu_item))
self.menu = gtk.Menu()
self.menu.append(self.visibility_menu_item)
self.menu.append(gtk.SeparatorMenuItem())
self.menu.append(main_window.add.create_menu_item())
self.menu.append(main_window.add_url.create_menu_item())
self.menu.append(gtk.SeparatorMenuItem())
self.menu.append(main_window.paused.create_menu_item())
self.menu.append(main_window.edit_preferences.create_menu_item())
self.menu.append(gtk.SeparatorMenuItem())
self.menu.append(main_window.quit.create_menu_item())
self.menu.show_all()
# Choose the right `MenuContainer'.
for cls in self.menu_containers:
try:
self.menu_container = self._component_manager.load(cls)
except:
pass
else:
self.menu_container.set_menu(self.menu)
self.menu_container.set_visible(True)
break
def on_close_activate(self, menu_item):
"""Hide the main window when the 'Close' menu item is activated."""
main_window = self._component_manager.get(MainWindow)
main_window.hide()
class MainWindowVisibilityEndPoint(EndPoint):
"""Keep the visibility of the main window in sync with the boolean
visibility value of a `Conduit'.
Send False to the conduit if the window is hidden or minimized.
If True is received from the conduit, unminimize the window if it was
previously minimized and present the window if it was previously hidden.
"""
def __init__(self, main_window):
EndPoint.__init__(self)
# Simple property that indicates whether the main window is minimized
# to the window list.
# It's the cached value from the previous 'window-state-event' signal
# emitted by the main window as it cannot be accessed directly.
self._minimized = False
self._change_callback = None
self._main_window = main_window
with gtk_lock:
self._main_window.connect("notify::visible",
gtk_lock.locked(self.on_visibility_changed))
self._main_window.connect("window-state-event",
gtk_lock.locked(self.on_state_event))
def attach_to_conduit(self, change_callback):
self._change_callback = change_callback
def detach_from_conduit(self):
self._change_callback = None
def get_value(self):
with gtk_lock:
return self._main_window.get_property("visible") and \
not self._minimized
def set_value(self, value):
with gtk_lock:
if value:
if self._minimized:
self._main_window.deiconify()
else:
self._main_window.present()
else:
self._main_window.hide()
def on_visibility_changed(self, main_window, prop):
if callable(self._change_callback):
self._change_callback(self)
def on_state_event(self, main_window, event):
iconified_state = gtk.gdk.WINDOW_STATE_ICONIFIED
run_callback = False
with gtk_lock:
if event.changed_mask & iconified_state:
self._minimized = bool(event.new_window_state & \
iconified_state)
run_callback = True
if run_callback and callable(self._change_callback):
self._change_callback(self)
class MenuContainer(Component):
APPLICATION = "lottanzb"
abstract = True
implements(IMenuContainer)
def set_menu(self, menu):
raise NotImplementedError
def set_visible(self, visible):
raise NotImplementedError
def on_unload(self):
self.set_visible(False)
class IndicatorMenuContainer(MenuContainer):
abstract = False
def __init__(self, component_manager):
MenuContainer.__init__(self, component_manager)
self._indicator = appindicator.Indicator(self.APPLICATION,
self.APPLICATION, appindicator.CATEGORY_APPLICATION_STATUS)
self.set_visible(False)
def set_menu(self, menu):
self._indicator.set_menu(menu)
def set_visible(self, visible):
if visible:
status = appindicator.STATUS_ACTIVE
else:
status = appindicator.STATUS_PASSIVE
self._indicator.set_status(status)
class StatusIconMenuContainer(MenuContainer):
abstract = False
def __init__(self, component_manager):
MenuContainer.__init__(self, component_manager)
self._menu = None
with gtk_lock:
self._icon = gtk.StatusIcon()
self._icon.set_from_icon_name(self.APPLICATION)
self._icon.connect("popup-menu",
gtk_lock.locked(self.on_icon_popup_menu))
self._icon.connect("activate",
gtk_lock.locked(self.on_icon_activate))
self.set_visible(False)
def set_menu(self, menu):
self._menu = menu
def set_visible(self, visible):
with gtk_lock:
self._icon.set_visible(visible)
def on_icon_popup_menu(self, icon, button, activate_time):
"""Display the status icon menu."""
if self._menu:
with gtk_lock:
self._menu.popup(None, None, gtk.status_icon_position_menu,
button, activate_time, icon)
def on_icon_activate(self, icon):
if self._menu:
with gtk_lock:
menu_item = self._menu.get_children()[0]
menu_item.set_active(not menu_item.get_active())
lottanzb-0.6/lottanzb/gui/__init__.py 0000644 0001750 0001750 00000010127 11525760436 017626 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import logging
LOG = logging.getLogger(__name__)
import warnings
import gtk
from lottanzb.config import ConfigSection
from lottanzb.config.lotta import ConfigurableComponent
from lottanzb.core.environ import _
from lottanzb.util.gobject_extras import GObject, gproperty
from lottanzb.gui import main, sessions, restart
from lottanzb.backend import Backend
from lottanzb.backend.interface.queries import RestartQuery
# Ignore GTK warnings
warnings.simplefilter("ignore", gtk.Warning)
__all__ = ["GUIComponent"]
class Config(ConfigSection):
main = gproperty(type=object)
add_file = gproperty(type=object)
class GUIComponent(ConfigurableComponent):
def __init__(self, component_manager):
ConfigurableComponent.__init__(self, component_manager)
self._component_manager.connect_async("component-loading-failure",
self.on_component_loading_failure)
self._component_manager.connect_async("component-loaded",
self.on_component_loaded)
self._component_manager.connect_async("component-unloaded",
self.on_component_unloaded)
LOG.debug("Launching GUI...")
gtk.window_set_default_icon_name("lottanzb")
self.main_window = self._component_manager.load(main.MainWindow)
self.main_window.show()
self._component_manager.load_async(Backend)
def on_component_loading_failure(self, component_manager, component_class,
error):
if issubclass(component_class, Backend):
self.show_session_selection_dialog(error)
def on_component_loaded(self, component_manager, component):
if isinstance(component, Backend):
interface = component.interface
self.main_window.attach_to_backend(component)
interface.connect_query_started(RestartQuery, \
self.on_restart_query_started)
interface.connect_query_completed(RestartQuery, \
self.on_restart_query_completed)
# A `RestartQuery' might already have been started even before this
# signal handler is run. Therefore, check the list of active
# queries.
# FIXME: Possible race condition as the access to `active_queries'
# is not synchronized.
for query in interface.active_queries:
if isinstance(query, RestartQuery):
self.on_restart_query_started(interface, query)
def on_component_unloaded(self, component_manager, component_class, error):
if component_class is Backend:
self.main_window.detach_from_backend()
if error:
self.show_session_selection_dialog(error)
def show_session_selection_dialog(self, error):
main_window = self._component_manager.get(main.MainWindow)
dialog = self._component_manager.load(sessions.SelectionDialog)
dialog.set_session_error(error)
dialog.show(main_window.get_toplevel())
def on_restart_query_started(self, interface, query):
restart_dialog = self._component_manager.load(restart.Dialog)
if self.main_window:
restart_dialog.show(self.main_window.get_toplevel())
else:
restart_dialog.show()
def on_restart_query_completed(self, interface, query):
self._component_manager.unload(restart.Dialog)
lottanzb-0.6/lottanzb/gui/log.py 0000644 0001750 0001750 00000027662 11525760436 016664 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import gtk
import logging
from logging import getLogger
LOG = getLogger(__name__)
from time import strftime, localtime
from lottanzb.core.environ import _
from lottanzb.core.component import depends_on
from lottanzb.core.log import LoggingComponent
from lottanzb.util.gobject_extras import GObject, gsignal
from lottanzb.util.signalmanager import SignalManager
from lottanzb.backend.hubs.log import LoggingHub
from lottanzb.gui.framework import MainDelegateComponent
__all__ = ["Window"]
# The rows that will be added to the `Window.level_store' `ListStore'.
LEVELS = [
(logging.DEBUG, _("Debugging")),
(logging.INFO, _("Default")),
(logging.WARNING, _("Warnings")),
(logging.ERROR, _("Errors"))
]
class LevelColumn:
"""Indices of the columns in the `Window.level_store' `ListStore'."""
CONSTANT = 0
NAME = 1
class Window(MainDelegateComponent):
"""
A window displaying log messages by both LottaNZB and SABnzbd.
The source of a message is not displayed anymore and it's not possible to
filter the messages by source as the user shouldn't need to care about it
and as LottaNZB only displays SABnzbd warnings anyway, which hopefully is
rarely the case.
The messages are fetched from the `core.log.LoggingComponent` as well as the
`backend.hubs.log.LoggingHub', which are wrapped by the classes
`LottaNZBLogRecordSource' and `SABnzbdLogRecordSource', which share the same
ancestor `LogRecordSource' such that the access is uniform.
"""
depends_on(LoggingComponent)
builder_file = "log_window"
textbuffer = None
adjust = None
end_mark = None
# The newest record that is currently being displayed.
last_record = None
# A list of objects of type `LogRecordSource', whose records are meant to
# be displayed.
sources = None
def create_ui(self):
self.textbuffer = self.content.get_buffer()
self.textbuffer.get_tag_table().add(self.error_tag)
self.textbuffer.get_tag_table().add(self.debug_tag)
self.adjust = self.scrolled_window.get_vadjustment()
self.end_mark = self.textbuffer.create_mark("end",
self.textbuffer.get_end_iter(), False)
logging_component = self._component_manager.get(LoggingComponent)
# Populate the 'Level' combobox.
for row in LEVELS:
row_iter = self.level_store.append(row)
# Only show debug messages by default if LottaNZB is actually
# executed using the --debug argument.
if logging_component.console_level == row[LevelColumn.CONSTANT]:
self.level.set_active_iter(row_iter)
# Setup all sources and connect to their signals.
self.sources = []
for source_class in (LottaNZBLogRecordSource, SABnzbdLogRecordSource):
source = source_class(self._component_manager)
source.connect("records-added", self.on_records_added)
source.connect("records-cleared", self.on_records_cleared)
self.sources.append(source)
# The default behaviour. The user is always free to scroll upwards,
# which will cause the log window to stay there even if new records are
# added.
self.scroll_to_bottom()
# Fill the content pane.
self.refresh()
def display_record(self, record):
"""Append `record' to the bottom of the `textbuffer'.
The record doesn't need to be of time `logging.LogRecord', but should at
least have a similar interface, including the properties
`levelno', `created' and `getMessage().
Records with a level that is lower than the one returned by `get_level()
will be discarded.
"""
if record.levelno < self.get_level():
return
line = "{time}\t{message}\n".format(
time=strftime("%H:%M:%S", localtime(record.created)),
message=record.getMessage())
if record.levelno >= logging.WARNING:
tag = "error_tag"
elif record.levelno == logging.DEBUG:
tag = "debug_tag"
else:
tag = ""
end_iter = self.textbuffer.get_end_iter()
if tag:
self.textbuffer.insert_with_tags_by_name(end_iter, line, tag)
else:
self.textbuffer.insert(end_iter, line)
# Auto-scroll the log message `TextView` if the user has manually moved
# the scrollbar to the bottom.
if self.adjust.value + self.adjust.page_size == self.adjust.upper:
self.scroll_to_bottom()
self.last_record = record
def get_level(self):
"""The current level constant selected by the user."""
active_iter = self.level.get_active_iter()
return self.level_store[active_iter][LevelColumn.CONSTANT]
def refresh(self):
"""Clear `textbuffer' and display all records provided by `sources'."""
self.textbuffer.set_text("")
self.adjust.set_value(0)
self.last_record = None
# Holds source with records that have not been displayed yet
active_sources = [source for source in self.sources if source.records]
# Mapping from sources to indices that indicate the next record to
# be displaced for that particular source
indices = dict()
# Start with the first record for each source
for source in active_sources:
indices[source] = 0
while active_sources:
# Determine the source whose next record is the oldest
next_source = active_sources[0]
next_record = next_source.records[indices[next_source]]
for source in active_sources:
if source.records[indices[source]].created < next_record.created:
next_source = source
next_record = source.records[indices[source]]
self.display_record(next_record)
indices[next_source] += 1
# Remove the source from `active_sources' if all of its records
# have been displayed
if len(next_source.records) == indices[next_source]:
active_sources.remove(next_source)
del indices[next_source]
def scroll_to_bottom(self):
self.content.scroll_to_mark(self.end_mark, 0.05, True, 0.0, 1.0)
def on_records_added(self, record_source, records):
"""Display all `records'.
It might be necessary to refresh the whole `textbuffer' if the records
are out-of-order.
"""
if not records:
return
# Check if the records are out-of-order, meaning that the newest
# displayed record is older than the oldest record to be displayed.
if self.last_record and records[0].created < self.last_record.created:
self.refresh()
return
for record in records:
self.display_record(record)
def on_records_cleared(self, record_source):
"""Refresh the whole content pane."""
self.refresh()
def on_save__clicked(self, widget):
"""Let the user save the log messages to a file."""
def handle_response(dialog, response):
if response == gtk.RESPONSE_OK:
filename = dialog.get_filename()
start_iter = self.textbuffer.get_start_iter()
end_iter = self.textbuffer.get_end_iter()
content = self.textbuffer.get_text(start_iter, end_iter)
try:
logfile = open(filename, "w")
logfile.write(content)
logfile.close()
except IOError as error:
LOG.error(_("Could not write message log to %s: %s") %
(filename, error.strerror))
else:
LOG.info(_("Message log saved to %s.") % (filename))
dialog.destroy()
dialog = gtk.FileChooserDialog(_("Save Message Log"),
self.get_toplevel(), gtk.FILE_CHOOSER_ACTION_SAVE,
(gtk.STOCK_CANCEL, gtk.RESPONSE_CANCEL, gtk.STOCK_SAVE,
gtk.RESPONSE_OK))
dialog.connect("response", handle_response)
dialog.set_default_response(gtk.RESPONSE_OK)
dialog.show()
def on_clear__clicked(self, widget):
"""Clear all `sources'."""
for source in self.sources:
source.clear()
def on_level__changed(self, widget):
"""Refresh the whole content pane."""
self.refresh()
class LogRecordSource(GObject):
gsignal("records-added", object)
gsignal("records-cleared")
def __init__(self, component_manager):
self._component_manager = component_manager
self.records = []
GObject.__init__(self)
def clear(self):
self.records = []
self.emit("records-cleared")
class LottaNZBLogRecordSource(LogRecordSource):
def __init__(self, component_manager):
LogRecordSource.__init__(self, component_manager)
logging_component = self._component_manager.load(LoggingComponent)
logging_component.connect("record-added", self.on_log_record_added)
self.records = logging_component.records
def on_log_record_added(self, logging_component, log_record):
self.records.append(log_record)
self.emit("records-added", [log_record])
class SABnzbdLogRecordSource(LogRecordSource):
def __init__(self, component_manager):
LogRecordSource.__init__(self, component_manager)
self._signal_manager = SignalManager()
self._component_manager.connect_async("component-loaded", \
self.on_component_loaded)
self._component_manager.connect_async("component-unloaded", \
self.on_component_unloaded)
logging_hub = self._component_manager.get(LoggingHub)
if logging_hub:
self.on_component_loaded(component_manager, logging_hub)
def on_component_loaded(self, component_manager, component):
if isinstance(component, LoggingHub):
self._signal_manager.connect(component, "records-added", \
self.on_log_records_added)
self._signal_manager.connect(component, "records-cleared", \
self.on_records_cleared)
self.on_log_records_added(component, component.records)
def on_component_unloaded(self, component_manager, component_class, error):
if component_class is LoggingHub:
self._signal_manager.disconnect_all()
self.clear()
def on_log_records_added(self, logging_hub, log_records):
self.records.extend(log_records)
self.emit("records-added", log_records)
def on_records_cleared(self, logging_hub):
self.records = []
self.emit("records-cleared")
def clear(self):
logging_hub = self._component_manager.get(LoggingHub)
if logging_hub:
logging_hub.clear()
else:
LogRecordSource.clear(self)
lottanzb-0.6/lottanzb/__init__.py 0000644 0001750 0001750 00000001437 11525760436 017046 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
from distutils.version import StrictVersion
version = StrictVersion("0.6")
__version__ = str(version)
lottanzb-0.6/lottanzb/backend/ 0000755 0001750 0001750 00000000000 11525760442 016314 5 ustar lantash lantash lottanzb-0.6/lottanzb/backend/sessions/ 0000755 0001750 0001750 00000000000 11525760442 020162 5 ustar lantash lantash lottanzb-0.6/lottanzb/backend/sessions/local.py 0000644 0001750 0001750 00000021655 11525760436 021642 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import re
import errno
import logging
LOG = logging.getLogger(__name__)
from time import time, sleep
from subprocess import Popen, PIPE
from distutils.spawn import find_executable
from os.path import isfile
from lottanzb import resources
from lottanzb.core.environ import _
from lottanzb.util.gobject_extras import gproperty
from lottanzb.config import hellanzb, sabnzbd
from lottanzb.config.section import ConfigSection
from lottanzb.config.errors import ConfigNotFoundError, LoadingError
from lottanzb.backend.sessions.base import BaseSession
from lottanzb.backend.sessions.errors import SessionNoServerError
from lottanzb.backend.interface import ConnectionInformation
from lottanzb.backend.interface.queries import ShutdownQuery, RestartQuery
from lottanzb.backend.interface.errors import (
QueryError,
QueryConnectionRefusedError,
QueryUnsupportedAPIVersionError
)
from lottanzb.backend.sessions.errors import (
SessionStartError,
SessionNoExecutableError,
SessionPermissionError,
SessionImportError
)
__all__ = ["HELLANZB_CONFIG_FILE", "LocalSession"]
# Path to the HellaNZB configuration managed by LottaNZB <= 0.5.x.
HELLANZB_CONFIG_FILE = resources.get_config("hellanzb.conf")
class Config(ConfigSection):
command = gproperty(type=str)
class SmartLocalConfig(sabnzbd.LocalConfig):
def load(self, custom_config_file=""):
try:
sabnzbd.LocalConfig.load(self, custom_config_file)
except ConfigNotFoundError:
hella_config = hellanzb.Config(HELLANZB_CONFIG_FILE)
try:
hella_config.load()
except LoadingError:
pass
else:
self.import_hellanzb_config(hella_config)
LOG.info(_("HellaNZB configuration file %s imported."),
hella_config.config_file)
self.generate_api_key()
self.save()
class LocalSession(BaseSession):
abstract = False
IMPORT_ERROR_PATTERN = re.compile("ImportError: No module named (.+)$")
def __init__(self, component_manager):
BaseSession.__init__(self, component_manager)
self.sabnzbd_config = SmartLocalConfig()
self.sabnzbd_config.load()
self.interface = None
if not self.config.command:
self.config.command = self.get_sabnzbd_command()
def get_connection_info(self):
info = ConnectionInformation()
info.update({
"host": "localhost",
"port": self.sabnzbd_config.misc.port,
"username": self.sabnzbd_config.misc.username,
"password": self.sabnzbd_config.misc.password,
"api_key": self.sabnzbd_config.misc.api_key
})
return info
def get_interface(self):
"""
Get the SABnzbd daemon up and running, if this is not already the case
and return the `Interface`.
If something goes wrong, a `SessionError` will be raised.
If the SABnzbd configuration stored in the `sabnzbd_config' property
has been changed before the session is started (e.g. to add a server),
the configuration is saved before attempting to launch SABnzbd.
If SABnzbd was already running in such a case, it will be restarted
automatically.
"""
if not self.config.command or not isfile(self.config.command):
raise SessionNoExecutableError(self)
# Don't allow the local session to be loaded if no news server has been
# specified. This might be the case if the user has launched SABnzbd
# once but did not complete its setup wizard.
# Even though one could later on provide the user with a warning message
# indicating that no server is available, it's probably less disruptive
# to just ask for the server information directly.
if not len(self.sabnzbd_config.servers):
raise SessionNoServerError(self)
self.interface = BaseSession.get_interface(self)
try:
self.interface.handshake()
except QueryConnectionRefusedError:
if self.sabnzbd_config.is_dirty:
self.sabnzbd_config.save()
LOG.info(_("Launching SABnzbd (%s)..."), self.config.command)
connection_established = False
version_error = None
args = (
self.config.command,
"--daemon",
"--config-file=%s" % self.sabnzbd_config.config_file
)
try:
process = Popen(args, stdout=PIPE, stderr=PIPE)
except OSError as error:
if error.errno == errno.ENOENT:
raise SessionNoExecutableError(self)
elif error.errno == errno.EACCES:
raise SessionPermissionError(self, self.config.command)
else:
raise SessionStartError(self, str(error))
start_time = time()
timeout = self.interface.START_TIMEOUT
# Use `process.poll()` instead of `process.returncode`. Otherwise,
# we might end up with a zombie SABnzbd process and an infinite
# loop in LottaNZB.
# Stop trying to connect to SABnzbd, when
# - the SABnzbd version is not supported by LottaNZB
# - a certain time has passed
# - the process that forks the daemon terminates with a return code
# other than 0.
while not process.poll() and not connection_established and \
not version_error and time() - start_time < timeout:
sleep(self.interface.HANDSHAKE_ATTEMPT_INTERVAL)
try:
self.interface.handshake()
except QueryConnectionRefusedError:
# SABnzbd is not fully started yet.
pass
except QueryUnsupportedAPIVersionError as error:
version_error = error
else:
connection_established = True
if version_error:
# The connection could be established, but the version is
# not supported. Shut SABnzbd down again.
self.stop_sabnzbd()
raise version_error
elif time() - start_time >= timeout:
raise SessionStartError(self,
_("Could not start SABnzbd in %d seconds.") % timeout)
elif process.returncode:
output = process.stderr.read() or process.stdout.read()
match = self.IMPORT_ERROR_PATTERN.search(output)
if match:
raise SessionImportError(self, match.group(1))
else:
raise SessionStartError(self, output)
LOG.info(_("SABnzbd has been successfully launched."))
else:
if self.sabnzbd_config.is_dirty:
self.sabnzbd_config.save()
# It would not be necessary to restart SABnzbd if it has already
# been configured once. If SABnzbd is however in its
# wizard-state, simply adding the server using the configuration
# API won't cause the first-start wizard to be completed.
self.interface.run_query(RestartQuery())
return self.interface
def on_unload(self):
self.stop_sabnzbd()
def stop_sabnzbd(self):
"""Shut down SABnzbd by sending a `ShutdownQuery'.
Note that for this method to work, `interface' must have been set.
"""
if self.interface:
LOG.info(_("Shutting down SABnzbd..."))
try:
self.interface.run_query(ShutdownQuery())
except QueryError:
pass
@staticmethod
def get_sabnzbd_command():
names = ["sabnzbdplus", "sabnzbd", "SABnzbd", "SABnzbd.py"]
for name in names:
command = find_executable(name)
if command:
return command
lottanzb-0.6/lottanzb/backend/sessions/errors.py 0000644 0001750 0001750 00000006327 11525760436 022063 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
from lottanzb.core.environ import _
__all__ = [
"SessionError",
"SessionStartError",
"SessionNotSpecifiedError",
"SessionUnknownError",
"SessionConnectionError",
"SessionNoExecutableError",
"SessionNoServerError",
"SessionPermissionError",
"SessionImportError"
]
class SessionError(Exception):
message = ""
def __init__(self, session=None, message=""):
self.session = session
if message:
self.message = message
Exception.__init__(self)
def __str__(self):
if self.message:
return self.message
elif self.session:
return _("Unknown error in session '%s'.") % self.session.get_name()
else:
return _("Unknown error in session.")
class SessionStartError(SessionError):
def __str__(self):
prefix = _("Could not start session")
if self.session:
prefix = _("Could not start session '%s'") % self.session.get_name()
if self.message:
return "%s: %s" % (prefix, self.message)
else:
return prefix
class SessionNotSpecifiedError(SessionStartError):
message = _("No session has been selected.")
class SessionUnknownError(SessionStartError):
message = _("Unknown session type.")
class SessionConnectionError(SessionStartError):
def __init__(self, session, connection_error, previous_success=False):
self.connection_error = connection_error
self.previous_success = previous_success
SessionStartError.__init__(self, session,
str(self.connection_error))
class SessionNoExecutableError(SessionStartError):
message = _("Could not find the SABnzbd executable.")
class SessionNoServerError(SessionStartError):
message = _("No news server has been specified.")
class SessionPermissionError(SessionStartError):
message = _("Not allowed to launch SABnzbd.")
def __init__(self, session=None, executable=None):
SessionStartError.__init__(self, session)
self.executable = executable
if self.executable:
extra_info = _("%s is probably not executable.") % self.executable
self.message = "%s %s" % (self.message, extra_info)
class SessionImportError(SessionStartError):
def __init__(self, session=None, module=""):
SessionStartError.__init__(self, session)
self.module = module
self.message= _("Could not find the Python module '%s'.") % self.module
lottanzb-0.6/lottanzb/backend/sessions/base.py 0000644 0001750 0001750 00000003014 11525760436 021447 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
from lottanzb.config.lotta import ConfigurableComponent
from lottanzb.core.component import implements, Interface
from lottanzb.backend.interface import Interface as BackendInterface
__all__ = ["ISession", "BaseSession"]
class ISession(Interface):
def get_interface(self):
"""The `backend.interface.Interface' to be used by the backend."""
pass
@classmethod
def get_name(cls):
pass
class BaseSession(ConfigurableComponent):
implements(ISession)
abstract = True
def get_connection_info(self):
raise NotImplementedError
def get_interface(self):
"""The `backend.interface.Interface' to be used by the backend."""
return BackendInterface(self.get_connection_info())
@classmethod
def get_name(cls):
return cls.__module__.split(".")[-1]
lottanzb-0.6/lottanzb/backend/sessions/remote.py 0000644 0001750 0001750 00000004614 11525760436 022037 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
from lottanzb.util.gobject_extras import gproperty
from lottanzb.core.constants import DefaultPortNumber
from lottanzb.config.section import ConfigSection
from lottanzb.backend.sessions.base import BaseSession
from lottanzb.backend.interface import ConnectionInformation
__all___ = ["RemoteSession"]
class Config(ConfigSection):
host = gproperty(type=str)
port = gproperty(type=int, default=DefaultPortNumber.HTTP, minimum=1,
maximum=2 ** 16 - 1)
username = gproperty(type=str)
password = gproperty(type=str)
api_key = gproperty(type=str)
https = gproperty(type=bool, default=False)
class RemoteSession(BaseSession):
abstract = False
def get_connection_info(self):
info = ConnectionInformation()
for key in ("host", "port", "username", "password", "api_key", "https"):
info.set_property(key, self.config[key])
# TODO: The method might also be called by other clients rather than
# the `Interface'. For all other clients, it's important not to mess
# with the connection information values unless explicitly desired.
info.connect("notify", self.on_connection_info_changed)
return info
def on_connection_info_changed(self, info, *args):
"""
The connection information may be altered after the session has been
started, mostly probably using the preferences UI.
This method makes sure that these changes are written back to the
configuration.
"""
self.config.update({
"port": info.port,
"username": info.username,
"password": info.password,
"api_key": info.api_key
})
lottanzb-0.6/lottanzb/backend/sessions/__init__.py 0000644 0001750 0001750 00000003352 11525760436 022301 0 ustar lantash lantash # Copyright (C) 2008-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
from lottanzb.config.section import ConfigSection
from lottanzb.util.gobject_extras import gproperty
from lottanzb.backend.sessions.base import ISession
from lottanzb.backend.sessions.local import LocalSession
from lottanzb.backend.sessions.remote import RemoteSession
__all__ = ["ISession", "LocalSession", "RemoteSession"]
class Config(ConfigSection):
"""Represents the configuration section 'backend.sessions'."""
# The string representation of the currently active session, as defined
# by each Session's `get_name` class method.
active = gproperty(type=str)
def set_property(self, key, value):
"""Ensures that the 'active' option never holds an invalid value."""
if key == "active" and value:
# Makes it possible to directly assign a class implementing
# `ISession` or an instance of it to the `active` option.
try:
value = value.get_name()
except AttributeError:
pass
ConfigSection.set_property(self, key, value)
lottanzb-0.6/lottanzb/backend/interface/ 0000755 0001750 0001750 00000000000 11525760442 020254 5 ustar lantash lantash lottanzb-0.6/lottanzb/backend/interface/errors.py 0000644 0001750 0001750 00000010323 11525760436 022144 0 ustar lantash lantash # Copyright (C) 2007-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
from lottanzb.core.environ import _
__all__ = [
"QueryError",
"QueryConnectionError",
"QueryUnknownHostError",
"QueryConnectionRefusedError",
"QueryHTTPError",
"QueryUnsupportedAPIVersionError",
"QueryResponseError",
"QueryAuthenticationError",
"QueryAPIKeyError",
"QueryUsernamePasswordError",
"QueryConnectionTimeout",
"QueryRestartTimeout",
"QueryArgumentsError",
"QueryNotImplementedError"
]
class QueryError(Exception):
def __init__(self, query, message=""):
self.query = query
self.message = message or _("Unknown error.")
def __str__(self):
return _("Query '%s' to %s failed: %s") % (
self.query.arguments.get("mode", ""),
self.query.connection_info.complete_host_string,
self.message)
class QueryConnectionError(QueryError):
def __init__(self, query, message=""):
QueryError.__init__(self, query, message or _("IO error."))
class QueryUnknownHostError(QueryConnectionError):
def __init__(self, query, message=""):
QueryConnectionError.__init__(self, query,
message or _("Unknown host."))
class QueryConnectionRefusedError(QueryConnectionError):
def __init__(self, query, message=""):
QueryConnectionError.__init__(self, query,
message or _("Connection refused."))
class QueryHTTPError(QueryConnectionError):
def __init__(self, query, code):
self.code = code
QueryConnectionError.__init__(self, query,
_("HTTP error code %i.") % code)
class QueryUnsupportedAPIVersionError(QueryConnectionError):
def __init__(self, query, version, required_version):
host = query.connection_info.host
if query.connection_info.is_local:
message = _("SABnzbd version %s is installed, but %s is "
"required." % (version, required_version))
else:
message = _("Host '%s' runs SABnzbd version %s, but %s is "
"required.") % (host, version, required_version)
QueryConnectionError.__init__(self, query, message)
class QueryResponseError(QueryConnectionError):
def __init__(self, query, message=""):
QueryConnectionError.__init__(self, query,
message or _("Invalid response."))
class QueryAuthenticationError(QueryConnectionError):
pass
class QueryAPIKeyError(QueryAuthenticationError):
def __init__(self, query, message=""):
QueryAuthenticationError.__init__(self, query,
message or _("Invalid API key."))
class QueryUsernamePasswordError(QueryAuthenticationError):
def __init__(self, query, message=""):
QueryAuthenticationError.__init__(self, query,
message or _("Invalid username or password."))
class QueryConnectionTimeout(QueryConnectionError):
def __init__(self, query, message=""):
QueryConnectionError.__init__(self, query,
message or _("Query took too long to execute."))
class QueryRestartTimeout(QueryConnectionError):
def __init__(self, query, timeout, message=""):
QueryConnectionError.__init__(self, query,
message or _("Restart didn't finish in %d seconds.") % timeout)
class QueryArgumentsError(QueryError):
def __init__(self, query, message=""):
QueryError.__init__(self, query, message or _("Invalid arguments."))
class QueryNotImplementedError(QueryArgumentsError):
def __init__(self, query, message=""):
QueryArgumentsError.__init__(self, query,
message or _("Not implemented."))
lottanzb-0.6/lottanzb/backend/interface/queries.py 0000644 0001750 0001750 00000065712 11525760436 022321 0 ustar lantash lantash # Copyright (C) 2007-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
from logging import getLogger
LOG = getLogger(__name__)
import errno
import socket
from urllib2 import build_opener, Request, URLError, HTTPError
from json import loads as read_json
from time import sleep, time
from distutils.version import LooseVersion
from lottanzb import __version__
from lottanzb.core.environ import _
from lottanzb.util.threading_extras import Thread
from lottanzb.backend.interface.errors import (
QueryError,
QueryConnectionError,
QueryUnknownHostError,
QueryConnectionRefusedError,
QueryHTTPError,
QueryResponseError,
QueryAPIKeyError,
QueryUsernamePasswordError,
QueryConnectionTimeout,
QueryRestartTimeout,
QueryArgumentsError,
QueryNotImplementedError
)
from lottanzb.backend.interface.multipart_post_handler import (
MultipartPostHandler
)
__all__ = [
"Query",
"SimpleSetConfigQuery",
"ComplexSetConfigQuery",
"GetConfigQuery",
"DeleteConfigQuery",
"StatusQuery",
"CapabilitiesQuery",
"QueueQuery",
"SortQueueQuery",
"DeleteDownloadsQuery",
"DeleteAllDownloadsQuery",
"DeleteFileQuery",
"RenameDownloadQuery",
"ChangeCompleteActionQuery",
"PurgeQuery",
"PauseDownloadsQuery",
"ResumeDownloadsQuery",
"PriorityQuery",
"AddFileQuery",
"AddRemoteFileQuery",
"AddLocalFileQuery",
"RetryQuery",
"SwitchDownloadQuery",
"ChangeCategoryQuery",
"ChangeScriptQuery",
"ChangePostProcessingQuery",
"HistoryQuery",
"AbstractDeleteHistoryQuery",
"DeleteHistoryQuery",
"DeleteAllHistoryQuery",
"FilesQuery",
"AddURLQuery",
"AddIDQuery",
"PauseQuery",
"ResumeQuery",
"ExclusiveQuery",
"ShutdownQuery",
"RestartQuery",
"RestartRepairQuery",
"DisconnectQuery",
"RescanQuery",
"WarningsQuery",
"ClearWarningsQuery",
"CategoriesQuery",
"ScriptsQuery",
"VersionQuery",
"GetSpeedLimitQuery",
"SetSpeedLimitQuery",
"GetNewzbinBookmarksQuery",
"AuthenticationQuery",
"AuthenticationType",
"AuthenticationTypeQuery"
]
class Query(Thread):
OUTPUT_FORMAT = "json"
# A shortcut for subclasses which sets the "mode" arguments so that they
# don't need to override the constructor.
METHOD = ""
ARGUMENT_ERRORS = {
"expect integer value": _("Wrong number of arguments."),
"expect two parameters": _("Wrong number of arguments."),
"expect integer value": _("No integer value."),
"no file given": _("No regular file."),
"file does not exist": _("File does not exist."),
"Format not supported": _("Format not supported."),
"Config item does not exist": _("Configuration option does not exist."),
"Incorrect server settings": _("Invalid server settings.")
}
# The default amount of time after a query has been started until LottaNZB
# gives up and raises a `QueryConnectionTimeout'.
DEFAULT_TIMEOUT = 10
def __init__(self, **arguments):
Thread.__init__(self)
self.connection_info = None
self.arguments = arguments
self.response = {}
self.raw_response = ""
self.url = ""
self.timeout = self.DEFAULT_TIMEOUT
arguments["output"] = self.OUTPUT_FORMAT
if not "mode" in self.arguments and self.METHOD:
self.arguments["mode"] = self.METHOD
for key, value in self.arguments.items():
# Convert all arguments of type 'bool' to 'int'.
if isinstance(value, bool):
self.arguments[key] = int(value)
# Remove all arguments with the value `None` as they will be encoded
# as 'None', which I cannot imagine to be desired in any case.
if value is None:
del self.arguments[key]
@property
def required_version(self):
pass
def affects_query(self, query):
"""Whether this query has an effect on the response of `query'.
Before this query is started, any queries that are being executed and
are affected by this query need to be completed. After this query is
started, no query that is affected by this query must be started until
this query is complete.
By default, a query doesn't affect any other query.
"""
return False
def start(self, connection_info):
self.connection_info = connection_info
if self.connection_info.needs_authentication:
self.arguments.update({
"ma_username": self.connection_info.username,
"ma_password": self.connection_info.password
})
if self.connection_info.api_key:
self.arguments["apikey"] = self.connection_info.api_key
Thread.start(self)
def run(self):
try:
self._run()
except QueryError as error:
# `QueryError's should not cause a traceback to be displayed in the
# log as they are known to occur and will be handled appropriately
# by clients of the class.
self.error = error
except Exception as error:
# Exceptions of other types however reveal a bug in the code that
# needs to be fixed.
self.error = error
raise
finally:
self.emit("completed")
def _run(self):
self.url = self.connection_info.api_url
try:
request = Request(self.url)
# The user agent defaults to 'Python-urllib/2.6' (on Python 2.6).
# Because the user agent also appears in SABnzbd log messages,
# it's changed to something more specific.
request.add_header("User-agent", "LottaNZB/%s" % __version__)
opener = build_opener(MultipartPostHandler)
open_file = opener.open(request, self.arguments, self.timeout)
raw_response = open_file.read()
opener.close()
except HTTPError as error:
raise QueryHTTPError(self, error.code)
except URLError as error:
if error.args:
embedded_error = error.args[0]
if isinstance(embedded_error, socket.timeout):
raise QueryConnectionTimeout(self)
elif isinstance(embedded_error, (socket.error,
socket.gaierror)):
error_number = embedded_error[0]
if error_number == errno.ECONNREFUSED:
raise QueryConnectionRefusedError(self)
elif error_number == socket.EAI_NONAME:
raise QueryUnknownHostError(self)
raise QueryConnectionError(self, error.reason)
else:
self.raw_response = raw_response
try:
self.response = self._parse_json_response(
read_json(self.raw_response))
except ValueError:
raise QueryResponseError(self)
def _parse_json_response(self, response):
status = response.pop("status", True)
error = response.pop("error", "").lower()
if status:
if len(response) == 1:
response = response.popitem()[1]
else:
if error == "missing authentication":
raise QueryUsernamePasswordError(self)
elif error in ("api key required", "api key incorrect"):
raise QueryAPIKeyError(self)
elif error == "not implemented":
raise QueryNotImplementedError(self)
else:
# No `QueryResponseError' should be raised if the error is known
# to have been caused by invalid arguments, but not by a
# connection issue or a problem within SABnzbd.
for known_error, message in self.ARGUMENT_ERRORS.items():
if known_error == error:
raise QueryArgumentsError(self, message)
raise QueryResponseError(self, error)
# It's easier to check if the query was successful or not if a boolean
# variable is returned instead of an empty dict.
if response == {}:
return status
else:
return response
class AbstractSetConfigQuery(Query):
METHOD = "set_config"
def __init__(self, section, key, **kwargs):
self.section = section
self.key = key
Query.__init__(self, section=section, keyword=key, **kwargs)
def affects_query(self, query):
# Make the query exclusive if we're changing the connection
# information. This prevents other queries from accidentally
# triggering a "Invalid username or password" error.
if self.changes_connection_info_option():
return True
if isinstance(query, GetConfigQuery):
return True
if isinstance(query, AbstractSetConfigQuery) and \
self.section == query.section and \
self.key == query.key:
return True
return False
def changes_connection_info_option(self, immediate_only=True):
"""Whether the configuration information changed using this query is
required to connect to a running instance of SABnzbd.
By default, the "port" option will not be detected as changes to it
are not applied immediately, but only after a restart. This can be
overridden by setting the `immediate_only` parameter to False.
"""
keys = ["username", "password", "api_key"]
if not immediate_only:
keys.append("port")
return self.section == "misc" and self.key in keys
class SimpleSetConfigQuery(AbstractSetConfigQuery):
def __init__(self, section, key, value):
self.value = value
AbstractSetConfigQuery.__init__(self, section, key, value=value)
class ComplexSetConfigQuery(AbstractSetConfigQuery):
def __init__(self, section, key, values):
self.values = values
AbstractSetConfigQuery.__init__(self, section, key, **values)
class GetConfigQuery(Query):
METHOD = "get_config"
def __init__(self, section="", keyword=""):
Query.__init__(self, section=section, keyword=keyword)
class DeleteConfigQuery(Query):
METHOD = "del_config"
def __init__(self, section="", keyword=""):
Query.__init__(self, section=section, keyword=keyword)
def affects_query(self, query):
return isinstance(query, GetConfigQuery)
class StatusQuery(Query):
METHOD = "qstatus"
class CapabilitiesQuery(Query):
"""
Get a dictionary containing information about the availability of certain
software components used to perform and post-process downloads.
"yenc" is True if the Python yenc module is available that makes decoding
downloads faster.
"ssl" is True if the OpenSSL bindings for Python are available.
The keys "par2", "par2c", "rar", "zip", "nice", "ionice" contain paths to
the corresponding program while empty string indicate that the program is
not available.
"""
METHOD = "options"
class AbstractQueueQuery(Query):
METHOD = "queue"
class QueueQuery(AbstractQueueQuery):
def __init__(self, start=None, limit=None, history=True):
AbstractQueueQuery.__init__(self, start=start, limit=limit,
history=history)
def affects_query(self, query):
return isinstance(query, QueueQuery)
class AbstractQueueModificationQuery(AbstractQueueQuery):
def affects_query(self, query):
return isinstance(query, QueueQuery)
class SortQueueQuery(AbstractQueueModificationQuery):
class Field:
INDEX = "index"
NAME = "name"
SIZE = "size"
AGE = "avg_age"
class Direction:
DESCENDING = "desc"
ASCENDING = "asc"
def __init__(self, field, direction=None):
if direction is None:
direction = self.Direction.ASCENDING
AbstractQueueModificationQuery.__init__(self, name="sort", sort=field,
dir=direction)
class DeleteDownloadsQuery(AbstractQueueModificationQuery):
def __init__(self, *download_ids):
self.download_ids = download_ids
AbstractQueueModificationQuery.__init__(self, name="delete",
value=",".join(self.download_ids))
class DeleteAllDownloadsQuery(DeleteDownloadsQuery):
def __init__(self):
DeleteDownloadsQuery.__init__(self, "all")
class DeleteFileQuery(AbstractQueueQuery):
def __init__(self, download_id, file_id):
AbstractQueueQuery.__init__(self, name="delete_nzf",
value=download_id, value2=file_id)
class RenameDownloadQuery(AbstractQueueModificationQuery):
def __init__(self, download_id, new_name):
self.download_id = download_id
self.new_name = new_name
AbstractQueueModificationQuery.__init__(self, name="rename",
value=self.download_id, value2=self.new_name)
class ChangeCompleteActionQuery(AbstractQueueModificationQuery):
class Action:
SHUTDOWN_PC = "shutdown_pc"
HIBERNATE_PC = "hibernate_pc"
STANDBY_PC = "standby_pc"
SHUTDOWN_PROGRAM = "shutdown_program"
SCRIPT = "script_%s"
def __init__(self, action):
AbstractQueueModificationQuery.__init__(self,
name="change_complete_action", value=action)
class PurgeQuery(AbstractQueueModificationQuery):
def __init__(self):
AbstractQueueModificationQuery.__init__(self, name="purge")
class PauseDownloadsQuery(AbstractQueueModificationQuery):
def __init__(self, *download_ids):
self.download_ids = download_ids
AbstractQueueModificationQuery.__init__(self, name="pause",
value=",".join(self.download_ids))
class ResumeDownloadsQuery(AbstractQueueModificationQuery):
def __init__(self, *download_ids):
self.download_ids = download_ids
AbstractQueueModificationQuery.__init__(self, name="resume",
value=",".join(self.download_ids))
class PriorityQuery(AbstractQueueModificationQuery):
def __init__(self, priority, *download_ids):
self.download_ids = download_ids
self.priority = priority
AbstractQueueModificationQuery.__init__(self, name="priority",
value=",".join(self.download_ids), value2=priority)
class AddFileQuery(Query):
file_name = ""
def __init__(self, file_name, send_file=False, **arguments):
self.file_name = file_name
Query.__init__(self, **arguments)
if send_file:
self.arguments["nzbfile"] = open(self.file_name, "r")
class AddRemoteFileQuery(AddFileQuery):
METHOD = "addfile"
def __init__(self, file_name, post_processor=None, script=None,
category=None, priority=None, name=None):
AddFileQuery.__init__(self, file_name, send_file=True,
pp=post_processor, script=script, cat=category, priority=priority,
nzbname=name)
class AddLocalFileQuery(AddFileQuery):
METHOD = "addlocalfile"
def __init__(self, file_name, post_processor=None, script=None,
category=None, priority=None, name=None):
AddFileQuery.__init__(self, file_name, pp=post_processor, script=script,
cat=category, priority=priority, name=file_name, nzbname=name)
class RetryQuery(AddFileQuery):
METHOD = "retry"
def __init__(self, file_name, download_id):
AddFileQuery.__ini__(self, file_name, send_file=True, value=download_id)
@property
def required_version(self):
return LooseVersion("0.6")
class SwitchDownloadQuery(Query):
METHOD = "switch"
def __init__(self, download_id, other_download_id):
self.download_id = download_id
self.other_download_id = other_download_id
Query.__init__(self, value=download_id, value2=other_download_id)
def affects_query(self, query):
return isinstance(query, (QueueQuery, SwitchDownloadQuery))
class ChangeCategoryQuery(Query):
METHOD = "change_cat"
def __init__(self, category, *download_ids):
self.category = category
self.download_ids = download_ids
Query.__init__(self, value=",".join(self.download_ids), value2=category)
@property
def required_version(self):
if len(self.download_ids) > 1:
return LooseVersion("0.6")
def affects_query(self, query):
return isinstance(query, QueueQuery)
class ChangeScriptQuery(Query):
METHOD = "change_script"
def __init__(self, script, *download_ids):
self.script = script
self.download_ids = download_ids
Query.__init__(self, value=",".join(self.download_ids), value2=script)
@property
def required_version(self):
if len(self.download_ids) > 1:
return LooseVersion("0.6")
def affects_query(self, query):
return isinstance(query, QueueQuery)
class ChangePostProcessingQuery(Query):
METHOD = "change_opts"
def __init__(self, post_processing, *download_ids):
self.post_processing = post_processing
self.download_ids = download_ids
Query.__init__(self, value=",".join(self.download_ids),
value2=post_processing)
@property
def required_version(self):
if len(self.download_ids) > 1:
return LooseVersion("0.6")
def affects_query(self, query):
return isinstance(query, QueueQuery)
class AbstractHistoryQuery(Query):
METHOD = "history"
def affects_query(self, query):
return isinstance(query, AbstractHistoryQuery)
class HistoryQuery(AbstractHistoryQuery):
def __init__(self, start=None, limit=None):
arguments = {}
if start:
arguments["start"] = start
if limit:
arguments["limit"] = limit
AbstractHistoryQuery.__init__(self, **arguments)
class AbstractDeleteHistoryQuery(AbstractHistoryQuery):
def __init__(self, value):
AbstractHistoryQuery.__init__(self, name="delete", value=value)
class DeleteHistoryQuery(AbstractDeleteHistoryQuery):
def __init__(self, *download_ids):
self.download_ids = download_ids
AbstractDeleteHistoryQuery.__init__(self,
value=",".join(self.download_ids))
class DeleteAllHistoryQuery(AbstractDeleteHistoryQuery):
def __init__(self):
AbstractDeleteHistoryQuery.__init__(self, "all")
class FilesQuery(Query):
METHOD = "get_files"
def __init__(self, download_id):
Query.__init__(self, value=download_id)
class AddURLQuery(Query):
METHOD = "addurl"
def __init__(self, url, post_processor=None, script=None,
category=None, priority=None):
self.url = url
Query.__init__(self, pp=post_processor, script=script,
cat=category, priority=priority, name=url)
class AddIDQuery(Query):
METHOD = "addid"
def __init__(self, id, post_processor=None, script=None,
category=None, priority=None):
self.id = id
Query.__init__(self, pp=post_processor, script=script,
cat=category, priority=priority, name=id)
class PauseQuery(Query):
METHOD = "pause"
def affects_query(self, query):
return isinstance(query, (QueueQuery, ResumeQuery))
class ResumeQuery(Query):
METHOD = "resume"
def affects_query(self, query):
return isinstance(query, (QueueQuery, PauseQuery))
class ExclusiveQuery(Query):
def affects_query(self, query):
return True
class ShutdownQuery(ExclusiveQuery):
METHOD = "shutdown"
class RestartQuery(ExclusiveQuery):
"""
Restart the SABnzbd daemon.
In most cases, this query will be used to cause certain configuration
changes to take effect.
"""
METHOD = "restart"
def __init__(self, blocking=True, timeout=None, new_connection_info=None):
"""
If `blocking` is set to True, the query will not be complete until a
connection to the restarted daemon has been established. `blocking`
defaults to True.
A default timeout is used to ensure that the query does not run forever
for certain reasons. It's possible to override the default value by
specifying the `timeout` parameter.
Since the restart query can also be used to cause connection information
changes to take effect (mostly port changes), it's possible to
pass a `ConnectionInformation` to the constructor of the query that
will be used when trying to establish a connection.
"""
ExclusiveQuery.__init__(self)
self.blocking = blocking
self.timeout = timeout
self.new_connection_info = new_connection_info
self.start_time = None
def start(self, connection_info):
LOG.info(_("Restarting SABnzbd..."))
if self.new_connection_info is None:
self.new_connection_info = connection_info
# It might take a while until `_parse_json_response` is actually called.
# We want to take that time into account as well.
self.start_time = time()
ExclusiveQuery.start(self, connection_info)
def _run(self):
"""
Sometimes, the restart query times out for no apparent reason, even
though the SABnzbd daemon has already been restarted successfully.
That's why this method sets up a temporary short timeout that will make
sure that LottaNZB won't wait for a response, but start checking if the
connection can be established again.
"""
try:
ExclusiveQuery._run(self)
except QueryConnectionTimeout:
self._check_connection()
def _parse_json_response(self, response):
if self.blocking:
return self._check_connection()
return True
def _check_connection(self):
# Avoid circular imports.
from lottanzb.backend.interface import Interface
interface = Interface(self.new_connection_info)
connection_established = False
timeout = self.timeout or interface.START_TIMEOUT
while not connection_established and time() - self.start_time < timeout:
sleep(interface.HANDSHAKE_ATTEMPT_INTERVAL)
try:
interface.handshake()
except QueryConnectionRefusedError:
pass
else:
connection_established = True
if not connection_established:
raise QueryRestartTimeout(self, timeout)
LOG.info(_("SABnzbd has been successfully restarted."))
return True
class RestartRepairQuery(Query):
"""Only available in SABnzbd 0.6 or newer."""
METHOD = "restart-repair"
@property
def required_version(self):
return LooseVersion("0.6")
class DisconnectQuery(Query):
METHOD = "disconnect"
class RescanQuery(Query):
"""Only available in SABnzbd 0.6 or newer."""
METHOD = "rescan"
@property
def required_version(self):
return LooseVersion("0.6")
class WarningsQuery(Query):
METHOD = "warnings"
class ClearWarningsQuery(Query):
METHOD = "warnings"
def __init__(self):
Query.__init__(self, name="clear")
def affects_query(self, query):
return isinstance(query, WarningsQuery)
class CategoriesQuery(Query):
METHOD = "get_cats"
class ScriptsQuery(Query):
METHOD = "get_scripts"
class VersionQuery(Query):
METHOD = "version"
class SpecialVersion:
TRUNK = LooseVersion("trunk")
def _parse_json_response(self, response):
return LooseVersion(Query._parse_json_response(self, response))
class GetSpeedLimitQuery(Query):
METHOD = "config"
def __init__(self):
Query.__init__(self, name="get_speedlimit")
class SetSpeedLimitQuery(Query):
METHOD = "config"
def __init__(self, limit=0):
Query.__init__(self, name="set_speedlimit", value=limit)
class GetNewzbinBookmarksQuery(Query):
METHOD = "newzbin"
def __init__(self):
Query.__init__(self, name="get_bookmarks")
class AuthenticationQuery(Query):
"""
The `VersionQuery` will be successfully executed even if the username,
password or API key is invalid. This query however will not perform and
actions either and doesn't have any output but simply checks whether
the connection information are valid and raises the proper exceptions.
"""
# Choose a method name that will always yield a `QueryNotImplementedError`.
METHOD = "will_never_be_implemented"
def _parse_json_response(self, response):
try:
Query._parse_json_response(self, response)
except QueryNotImplementedError:
pass
return True
class AuthenticationType:
"""
Enumeration of different authentication types.
Meaning of the three constants:
- NOTHING: No authentication required.
- USERNAME_PASSWORD: A username and a password is required, but no API key.
- API_KEY: The API key is required, but no username and password.
"""
NOTHING, USERNAME_PASSWORD, API_KEY = range(0, 3)
class AuthenticationTypeQuery(Query):
"""
Determines the authentication type for a certain SABnzbd instance.
It doesn't matter what username, password and API key is specified using the
`ConnectionInformation`.
The response is one of the constants in `AuthenticationType`.
"""
METHOD = "auth"
def _parse_json_response(self, response):
auth_type = Query._parse_json_response(self, response)
auth_type_map = {
"None": AuthenticationType.NOTHING,
"login": AuthenticationType.USERNAME_PASSWORD,
"apikey": AuthenticationType.API_KEY
}
try:
return auth_type_map[auth_type]
except KeyError:
raise QueryResponseError("Invalid authentication type '%s'." %
auth_type)
lottanzb-0.6/lottanzb/backend/interface/multipart_post_handler.py 0000644 0001750 0001750 00000006542 11525760436 025423 0 ustar lantash lantash # Copyright (C) 2006 Will Holcomb
# Copyright (C) 2007 Brian Schneide
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
# Lesser General Public License for more details.
"""Enables the use of multipart/form-data for posting forms
Inspirations:
Upload files in python:
http://aspn.activestate.com/ASPN/Cookbook/Python/Recipe/146306
urllib2_file:
Fabien Seisen:
Example:
>>> from multi_partpost_handler import MultipartPostHandler
>>> from urllib2 import build_opener
>>> opener = build_opener(MultipartPostHandler)
>>> params = { "file" : open("path/to/file", "rb") }
>>> opener.open("http://wwww.example.com/", params)
"""
import mimetools
import mimetypes
from urllib import urlencode
from urllib2 import BaseHandler, HTTPHandler
from cStringIO import StringIO
__all__ = ("MultipartPostHandler")
class MultipartPostHandler(BaseHandler):
handler_order = HTTPHandler.handler_order - 10 # Needs to run first
def http_request(self, request):
data = request.get_data()
if data is not None and not isinstance(data, str):
files = []
variables = []
for key, value in data.items():
if isinstance(value, file):
files.append((key, value))
else:
variables.append((key, value))
if not files:
data = urlencode(variables, 1)
else:
boundary, data = self.multipart_encode(variables, files)
content_type = "multipart/form-data; boundary=%s" % boundary
request.add_unredirected_header("Content-Type", content_type)
request.add_data(data)
return request
@staticmethod
def multipart_encode(variables, files, boundary=None, buf=None):
if boundary is None:
boundary = mimetools.choose_boundary()
if buf is None:
buf = StringIO()
for key, value in variables:
buf.write("--%s\r\n" % boundary)
buf.write("Content-Disposition: form-data; name=\"%s\"" % key)
buf.write("\r\n\r\n" + value + "\r\n")
for key, fd in files:
# Currently not used:
# file_size = os.fstat(fd.fileno())[stat.ST_SIZE]
filename = fd.name.split("/")[-1]
content_type = mimetypes.guess_type(filename)[0] or "application/octet-stream"
fd.seek(0)
buf.write("--%s\r\n" % boundary)
buf.write("Content-Disposition: form-data; name=\"%s\"; filename=\"%s\"\r\n" % (key, filename))
buf.write("Content-Type: %s\r\n" % content_type)
buf.write("\r\n" + fd.read() + "\r\n")
buf.write("--" + boundary + "--\r\n\r\n")
buf = buf.getvalue()
return boundary, buf
https_request = http_request
lottanzb-0.6/lottanzb/backend/interface/__init__.py 0000644 0001750 0001750 00000030140 11525760436 022366 0 ustar lantash lantash # Copyright (C) 2007-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import re
from threading import Semaphore, Condition, current_thread, Thread
from distutils.version import LooseVersion
from lottanzb.util.gobject_extras import GObject, gproperty, gsignal
from lottanzb.util.regex import IPv6_ADDRESS_PATTERN
from lottanzb.core.constants import DefaultPortNumber
from lottanzb.backend.interface.errors import QueryUnsupportedAPIVersionError
from lottanzb.backend.interface.queries import (
Query,
VersionQuery,
AuthenticationQuery
)
__all__ = ["Interface", "ConnectionInformaton"]
class Interface(GObject):
MINIMUM_VERSION = LooseVersion("0.5.2")
# The time to wait between two attempts to establish a connection while
# starting the SABnzbd daemon.
HANDSHAKE_ATTEMPT_INTERVAL = 0.25
# The time to wait until to give up the attempt of starting the SABnzbd
# daemon. The default is an arbitrary choice of 15 seconds.
# TODO: Probably not the best place to put this constant.
START_TIMEOUT = 15
gsignal("query-started", object)
gsignal("query-completed", object)
gsignal("query-success", object)
gsignal("query-failure", object)
def __init__(self, connection_info):
GObject.__init__(self)
self.version = None
self.connection_info = connection_info
# Used to synchronize the overridden methods.
self._lock = Condition()
# Holds all `Query' objects that are currently being run.
self._active_queries = []
# Holds all `Query' objects that are waiting to be run.
self._waiting_queries = []
# For each query in `_waiting_queries', this property provides the
# corresponding `QueryWaitingThread'.
# A mapping is removed as soon as a query is completed.
self._waiting_threads = {}
def run_query(self, query):
"""
Run `query' asynchronously and emit the 'query-started' signal.
If the query requires a newer version than `version', a
`QueryUnsupportedAPIVersionError' will be raised.
If it's not possible to start the query right away, an additional
`QueryWaitingThread' is created so that the method doesn't block if
the query needs to wait for other queries to be completed before it
can even be started.
Returns a thread, which is either `query' or the corresponding
`QueryWaitingThread'. Either way, joining the thread will cause the
caller to wait until the whole query has been completed.
"""
if query.required_version and self.version < query.required_version:
raise QueryUnsupportedAPIVersionError(query, self.version,
query.required_version)
with self._lock:
self._lock.notify_all()
if self.is_query_allowed_to_run(query):
self._active_queries.append(query)
self._run_query_immediately(query)
return query
else:
self._waiting_queries.append(query)
self._waiting_threads[query] = QueryWaitingThread(query, \
Interface._wait_in_queue, (self, query))
self._waiting_threads[query].start()
return self._waiting_threads[query]
def _wait_in_queue(self, query):
"""Run `query' as soon as its allowed to according to
`is_query_allowed_to_run'.
"""
with self._lock:
while True:
self._lock.wait()
if self.is_query_allowed_to_run(query):
self._waiting_queries.remove(query)
break
# Let the next thread in the waiting queue proceed.
self._lock.notify_all()
self._active_queries.append(query)
self._run_query_immediately(query)
def _run_query_immediately(self, query):
"""Asynchronously runs `query'.
It also connects to the signals of interest and emits 'query-started'.
"""
query.connect("completed", self.on_query_completed)
query.connect("success", self.on_query_success)
query.connect("failure", self.on_query_failure)
query.start(self.connection_info)
self.emit("query-started", query)
def get_response(self, query, *args, **kwargs):
thread = self.run_query(query, *args, **kwargs)
thread.join()
if query.error:
raise query.error
return query.response
def is_query_allowed_to_run(self, query):
"""Whether `query' is allowed to be run.
This is not the case if:
- `query' and all queries before `query' in the waiting queue don't
affect each other.
- `query' and all active queries don't affect each other.
"""
# It's much more likely that the queries in `_waiting_queries' are
# blocked because of an active query like `RestartQuery'. Thus, check
# the active queries first.
for active_query in self._active_queries:
if active_query.affects_query(query) or \
query.affects_query(active_query):
return False
for waiting_query in self._waiting_queries:
if waiting_query is query:
break
if waiting_query.affects_query(query) or \
query.affects_query(waiting_query):
return False
return True
def handshake(self):
"""
Perform two initial queries to the SABnzbd instance in order to check
if the connection can be established.
Also check if version of the SABnzbd instance the interface is
connected to is a supported one and if the username and password as
well as the API key is valid.
May raise `QueryConnectionError`s of various types.
"""
query = VersionQuery()
self.version = self.get_response(query)
if self.version != VersionQuery.SpecialVersion.TRUNK:
if self.MINIMUM_VERSION > self.version:
raise QueryUnsupportedAPIVersionError(query, self.version,
self.MINIMUM_VERSION)
self.get_response(AuthenticationQuery())
@property
def waiting_queries(self):
"""The list of queries that have not been started yet."""
return self._waiting_queries[:]
@property
def active_queries(self):
"""The list of queries that are currently being run."""
return self._active_queries[:]
def connect_filtered(self, query_class, signal_name, handler, *args):
def internal_handler(interface, query, *args):
if isinstance(query, query_class):
handler(interface, query, *args)
return self.connect(signal_name, internal_handler, *args)
def connect_query_started(self, query_class, handler, *args):
return self.connect_filtered(query_class, "query-started", handler,
*args)
def connect_query_completed(self, query_class, handler, *args):
return self.connect_filtered(query_class, "query-completed", handler,
*args)
def connect_query_success(self, query_class, handler, *args):
return self.connect_filtered(query_class, "query-success", handler,
*args)
def connect_query_failure(self, query_class, handler, *args):
return self.connect_filtered(query_class, "query-failure", handler,
*args)
def on_query_completed(self, query):
self.emit("query-completed", query)
with self._lock:
self._active_queries.remove(query)
self._lock.notify_all()
def on_query_success(self, query):
self.emit("query-success", query)
def on_query_failure(self, query, error):
self.emit("query-failure", query)
class QueryWaitingThread(Thread):
def __init__(self, query, waiting_target, args=()):
self.query = query
Thread.__init__(self, target=waiting_target, args=args)
def join(self):
Thread.join(self)
self.query.join()
class QueryCache:
"""
Cache query responses and allow clients to check if the response to a
query differs from the one received before that.
How to use this class:
1. Create a new `QueryCache` object using
my_cache = QueryCache()
2. Add this snippet of code to the top of the method that handles successful
queries:
if my_chache.has_changed(query):
return
"""
def __init__(self):
self.last_raw_response = ""
def has_changed(self, query):
"""
Check if the query passed to the method has the same response as the
previous query.
"""
if query.raw_response == self.last_raw_response:
return False
else:
self.last_raw_response = query.raw_response
return True
class ConnectionInformation(GObject):
API_KEY_PATTERN = re.compile(r"^(|[a-z0-9]{32}$)")
host = gproperty(type=str, default="localhost")
port = gproperty(type=int, default=DefaultPortNumber.HTTP, minimum=1,
maximum=2 ** 16 - 1)
username = gproperty(type=str)
password = gproperty(type=str)
api_key = gproperty(type=str)
https = gproperty(type=bool, default=False)
# Indicates whether `host' is an IPv6 address or not.
_host_is_ipv6_address = False
def set_property(self, key, value):
if key == "api_key" and not self.API_KEY_PATTERN.match(value):
raise ValueError("The API key must consist of 32 alphanumeric "
"characters.")
if key == "host":
self._host_is_ipv6_address = bool(IPv6_ADDRESS_PATTERN.match(value))
GObject.set_property(self, key, value)
@property
def needs_authentication(self):
return bool(self.username and self.password)
@property
def complete_host_string(self):
"""The host and the port, separated by ":"."""
return "{0.host}:{0.port}".format(self)
@property
def protocol(self):
"""The protocol to be used. Will be "http" or "https" depending on the
`https' property.
"""
if self.https:
return "https"
else:
return "http"
@property
def url(self):
"""The URL of the SABnzbd web interface.
Note that IPv6 addresses are enclosed in square brackets because
some browsers won't accept the URL otherwise.
"""
host_format = "{0.host}"
if self._host_is_ipv6_address:
host_format = "[%s]" % host_format
return ("{0.protocol}://" + host_format + ":{0.port}/").format(self)
@property
def api_url(self):
"""The URL of the SABnzbd API."""
return self.url + "api"
@property
def is_local(self):
# The IPv6 loopback address '::1' could be written in many other forms,
# but this should be enough for most cases.
return self.host in ("localhost", "127.0.0.1", "::1")
@property
def is_remote(self):
return not self.is_local
lottanzb-0.6/lottanzb/backend/__init__.py 0000644 0001750 0001750 00000014023 11525760436 020430 0 ustar lantash lantash # Copyright (C) 2007-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
"""
This module is used to communicate and interact with a SABnzbd instance
running on the local or a remote machine. The `sessions' submodule handles
the distinction betweenlocal and remote instances, while the rest of the backend
is indepent from the location of the SABnzbd instance.
Each query is represented by a class in the `interface.queries' submodule and
is a thread that is meant to be started and managed by the `interface' module.
The last important concept are hubs, which are registered with the backend.
Each hubs takes care of synchronizing and storing certain information and
exposing it and API query wrapper methods to the rest of the application.
The default hubs are:
- general: Keeping the list of downloads
- config: Synchronizing the configuration
- log: Providing SABnzbd warnings
- polling: Allowing other hubs to run certain queries regularly.
Plug-ins may add new hubs.
"""
from logging import getLogger
LOG = getLogger(__name__)
from lottanzb.core.environ import _
from lottanzb.core.component import Component, ExtensionPoint
from lottanzb.config.section import ConfigSection
from lottanzb.config.lotta import ConfigurableComponent
from lottanzb.util.gobject_extras import gproperty, gsignal
from lottanzb.backend.hubs import IHub, import_core_hubs
from lottanzb.backend.interface.errors import QueryConnectionError
from lottanzb.backend.sessions.base import ISession
from lottanzb.backend.sessions.errors import (
SessionError,
SessionNotSpecifiedError,
SessionUnknownError,
SessionConnectionError
)
__all__ = ["Backend"]
class Config(ConfigSection):
"""Represents the configuration section 'backend'."""
sessions = gproperty(
type = object,
nick = "The active session and options for the various session",
blurb = "A subsection that contains information about what session "
"is currently being used and all information necessary for "
"each session type such as connection information.")
delete_enqueued_nzb_files = gproperty(
type = bool,
default = False,
nick = "Delete NZB files successfully added to the download queue",
blurb = "Setting this value to True doesn't mean that the NZB "
"file is completely removed from the system, but that it "
"can only be found in the hidden SABnzbd directories."
"Because it's very uncommon for files to disappear as"
"soon as a user clicks on them, this option is set to "
"False by default.")
class Backend(ConfigurableComponent):
"""
Set up the right session and establish the connection to the corresponding
SABnzbd instance. Also manage the hubs and the created session.
Only lives as long as the session is active.
If a query cannot be executed successfully because of a connection error,
the backend will unload itself and provide observers of the
`ComponentManager's "component-unloaded" signal with a
`SessionConnectionError`.
"""
hubs = ExtensionPoint(IHub)
sessions = ExtensionPoint(ISession)
def __init__(self, component_manager):
ConfigurableComponent.__init__(self, component_manager)
self.session = None
if not self.config.sessions.active:
raise SessionNotSpecifiedError()
for session_cls in self.sessions:
if session_cls.get_name() == self.config.sessions.active:
self.session = self._component_manager.load(session_cls)
break
if not self.session:
raise SessionUnknownError()
try:
self.interface = self.session.get_interface()
self.interface.handshake()
except QueryConnectionError as error:
raise SessionConnectionError(self.session, error)
# Only listen for failed queries if the initial handshake queries have
# been successful. Clients will handle failed handshake queries and
# create proper log messages.
self.interface.connect("query-failure", self._on_query_failure)
LOG.info(_("Connection to '%s' established."),
self.interface.connection_info.complete_host_string)
# FIXME: Lazy import.
# We don't know if all hubs have been imported yet by other parts of the
# application. Note: The polling hub will be imported anyway.
import_core_hubs()
for hub_cls in self.hubs:
self._component_manager.load_async(hub_cls)
def _on_query_failure(self, interface, query):
"""
If a query fails due to a `QueryConnectionError`, unload the whole
`Backend` and pass along a proper `SessionConnectionError`.
"""
LOG.warning(str(query.error))
LOG.debug("Raw Response: " + query.raw_response)
if isinstance(query.error, QueryConnectionError):
self._component_manager.unload(self, SessionConnectionError(
self.session, query.error, previous_success=True))
@classmethod
def get_known_exceptions(cls):
"""Loading the `Backend' may fail due to various reasons. In this case
a `SessionError' is raised that is meant to be handled by clients.
"""
return (SessionError,)
lottanzb-0.6/lottanzb/backend/hubs/ 0000755 0001750 0001750 00000000000 11525760442 017255 5 ustar lantash lantash lottanzb-0.6/lottanzb/backend/hubs/config.py 0000644 0001750 0001750 00000024534 11525760436 021107 0 ustar lantash lantash # Copyright (C) 2007-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import copy
from threading import Timer
from copy import deepcopy
from lottanzb.util.gobject_extras import gsignal
from lottanzb.config.section import ConfigSection
from lottanzb.config.sabnzbd import AbstractRemoteConfig, ListConfigSection
from lottanzb.core.component import Component, implements, depends_on
from lottanzb.backend import Backend
from lottanzb.backend.hubs import IHub
from lottanzb.backend.hubs.polling import PollingHub
from lottanzb.backend.interface import QueryCache
from lottanzb.backend.interface.queries import (GetConfigQuery,
SimpleSetConfigQuery, ComplexSetConfigQuery, DeleteConfigQuery,
RestartQuery)
__all__ = ["ConfigHub"]
class SilentRemoteConfig(AbstractRemoteConfig):
"""
Configuration that is not synchronized with a remote host.
Useful for temporary copies of a synchronized configuration.
"""
def load(self):
pass
def write_back(self, section, key):
pass
class GroupedSectionChange(set):
WRITEBACK_DELAY = 0.1
def __init__(self, section, write_back_method):
delay = self.WRITEBACK_DELAY
self.section = section
self.timer = Timer(delay, write_back_method, [self.section])
self.timer.start()
set.__init__(self)
class RemoteConfig(AbstractRemoteConfig):
"""
Holds the configuration of a SABnzbd instance.
This class offers the possibility to seamlessly merge an updated version of
the configuration received by a `GetConfigQuery' into this configuration.
Also, any changes that aren't the result of such a merge operation
are detected and prepared to be written back to the SABnzbd instance using
`SimpleSetConfigQuery', `ComplexSetConfigQuery' and `DeleteConfigQuery'.
Any communication is not initiated directly by this class (as it doesn't
know anything about an `Interface', but requested using the two signals
'request-write-back' and 'request-load'.
"""
# Emitted when a certain change in the configuration needs to be written
# back to the configuration host. The only argument is a
# `SimpleSetConfigQuery', `ComplexSetConfigQuery' or a `DeleteConfigQuery'.
gsignal("request-write-back", object)
# Emitted when the `load` method is called. The observer is meant to
# initiate a `GetConfigQuery` and pass its response to
# `process_config_query`.
# If the only argument is True, the `GetConfigQuery' should be invoked
# synchronously, asynchronously otherwise.
gsignal("request-load", bool)
def __init__(self, host):
self._grouped_changes = {}
AbstractRemoteConfig.__init__(self, host)
def load(self, synchronous=True):
self.emit("request-load", synchronous)
def process_config_query(self, query):
config = deepcopy(query.response)
# In a configuration file created by an instance of SABnzbd that has
# not been configured yet, the 'servers' and 'categories' configuration
# sections may be missing.
servers = config.get("servers", [])
categories = config.get("categories", [])
config["servers"] = {}
config["categories"] = {}
for server in servers:
config["servers"][server.pop("name")] = server
for category in categories:
config["categories"][category["name"]] = category
self.merge(SilentRemoteConfig(self.host, options=config))
def write_back_change(self, section, key, value):
if isinstance(value, ConfigSection):
if value.get_depth() != 2:
raise ValueError("%r does not have a depth of 2" % value)
if not isinstance(section, ListConfigSection):
raise ValueError(("%r is not an instance of type "
"`ListConfigSection'") % value)
keyword = value.get_remote_identifier()
values = value.to_dict()
query = ComplexSetConfigQuery(section._name, keyword, values)
self.emit("request-write-back", query)
else:
depth = section.get_depth()
if depth == 1:
query = SimpleSetConfigQuery(section._name, key, section[key])
self.emit("request-write-back", query)
elif depth == 2:
if section in self._grouped_changes:
grouped_change = self._grouped_changes[section]
else:
grouped_change = GroupedSectionChange(section,
self.write_back_group_change)
self._grouped_changes[section] = grouped_change
grouped_change.add(key)
else:
raise ValueError(("Could not write back key '%s' in section "
"'%s'") % (key, section.get_full_name()))
def write_back_group_change(self, section):
values = {}
for key in self._grouped_changes[section]:
values[key] = section[key]
section_name = section._parent._name
keyword = section.get_remote_identifier()
query = ComplexSetConfigQuery(section_name, keyword, values)
section._parent.sync_remote_identifier(section)
del self._grouped_changes[section]
self.emit("request-write-back", query)
def write_back_deletion(self, section, key, value):
# We cannot use the `key` because in the case of a `ListConfigSection`
# this will simply be an integer.
keyword = value.get_remote_identifier()
query = DeleteConfigQuery(section._name, keyword)
self.emit("request-write-back", query)
def __deepcopy__(self, memo):
"""
Objects of type `RemoteConfig` are not meant to be copied deeply.
Any changes would still be written back to the remote host, which is
most probably not desired.
Create a `SilentRemoteConfig` using `silent_deep_copy` instead.
"""
raise copy.Error("un(deep)copyable object of type %r" % type(self))
def silent_deep_copy(self):
"""
Create a deep copy of the configuration that won't be synchronized
with the remote host in any way.
It's an instance of `SilentRemoteConfig`.
"""
options = {}
for key, value in self.items():
options[key] = deepcopy(value)
return SilentRemoteConfig(self.host, options)
class ConfigHub(Component):
implements(IHub)
depends_on(Backend)
def __init__(self, component_manager):
Component.__init__(self, component_manager)
self.interface = self._component_manager.load(Backend).interface
# Cache the query responses.
self.config_cache = QueryCache()
self.config = RemoteConfig(
self.interface.connection_info.complete_host_string)
self.config.connect("request-load", self.on_request_load)
self.config.connect("request-write-back",
self.on_request_write_back)
self.config.load()
polling_hub = self._component_manager.load(PollingHub)
polling_hub.schedule_minutely(GetConfigQuery, self.on_get_config_query)
self.interface.connect_query_success(SimpleSetConfigQuery,
self.on_simple_set_config_query)
self.interface.connect_query_success(RestartQuery,
self.on_restart_query)
def on_request_load(self, config, synchronous):
query = GetConfigQuery()
query.connect("success", self.on_get_config_query)
if synchronous:
self.interface.get_response(query)
else:
self.interface.run_query(query)
def on_request_write_back(self, config, query):
self.interface.run_query(query)
def on_get_config_query(self, query):
"""Pass response of a `GetConfigQuery' to `config' for merging.
Only responses containing the whole configuration are considered.
"""
if not query.arguments["section"] and not query.arguments["keyword"]:
# Avoid unnecessary work.
if not self.config_cache.has_changed(query):
return
self.config.process_config_query(query)
def on_simple_set_config_query(self, interface, query):
"""
Update the connection information after the user has updated the
configuration using a `SimpleSetConfigQuery` (most probably using the
preferences UI).
This method ensures that queries will work properly even after the
username, password, or the API key have changed.
The port doesn't need to be updated because this change doesn't take
effect immediately.
"""
if query.changes_connection_info_option():
self.interface.connection_info.set_property(query.key, query.value)
def on_restart_query(self, interface, query):
"""
Using a `RestartQuery`, a change to the port SABnzbd listens on can be
applied. This method ensures that the connection information is updated
after the `RestartQuery` has been completed.
"""
self.interface.connection_info.port = self.config.misc.port
def set_bandwidth_limit(self, limit=0):
self.config.misc.bandwidth_limit = limit
def remove_bandwidth_limit(self):
self.set_bandwidth_limit(0)
def get_bandwidth_limit(self):
return self.config.misc.bandwidth_limit
lottanzb-0.6/lottanzb/backend/hubs/general/ 0000755 0001750 0001750 00000000000 11525760442 020672 5 ustar lantash lantash lottanzb-0.6/lottanzb/backend/hubs/general/download_list.py 0000644 0001750 0001750 00000005423 11525760436 024115 0 ustar lantash lantash # Copyright (C) 2007-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import gtk
from lottanzb.backend.hubs.general.download import StatusGroup
class DownloadListStore(gtk.ListStore):
COLUMN = 0
def __init__(self):
self._model_filters = {};
self._by_id = {};
gtk.ListStore.__init__(self, object)
self.connect("row-changed", self.on_row_changed)
def get_filter_by_status(self, status):
if status in self._model_filters:
return self._model_filters[status]
def func(model, listiter):
download = model[listiter][self.COLUMN]
return download and download.has_status(status)
self._model_filters[status] = self.filter_new()
self._model_filters[status].set_visible_func(func)
return self._model_filters[status]
def get_filter_complete(self):
return self.get_filter_by_status(StatusGroup.COMPLETE)
def get_filter_incomplete(self):
return self.get_filter_by_status(StatusGroup.INCOMPLETE)
def get_filter_processing(self):
return self.get_filter_by_status(StatusGroup.PROCESSING)
def get_filter_not_fully_loaded(self):
return self.get_filter_by_status(StatusGroup.NOT_FULLY_LOADED)
def get_filter_movable(self):
return self.get_filter_by_status(StatusGroup.MOVABLE)
def remove(self, iter):
"""Remove download specified by `iter' and also drop it from `_by_id'"""
download = self[iter][self.COLUMN]
if download.id in self._by_id:
del self._by_id[download.id]
gtk.ListStore.remove(self, iter)
def on_row_changed(self, model, path, iter):
"""Add download at `path' to `_by_id'"""
download = self[iter][self.COLUMN]
if download:
self._by_id[download.id] = download
def download_changed(self, download):
"""Call `row_changed' for a given `download'."""
for row in self:
if row and row[self.COLUMN] is download:
self.row_changed(row.path, row.iter)
lottanzb-0.6/lottanzb/backend/hubs/general/updater.py 0000644 0001750 0001750 00000020455 11525760436 022721 0 ustar lantash lantash # Copyright (C) 2007-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
from lottanzb.util.gtk_extras import gtk_lock
from lottanzb.util.misc import unique
from lottanzb.backend.hubs import TimeDelta
from lottanzb.backend.hubs.general.download import Download, Status, StatusGroup
from lottanzb.backend.hubs.general.download_list import DownloadListStore
__all__ = ["DownloadListUpdater", "DownloadListQueueUpdater"]
class DownloadListUpdater(object):
STATUS_ORDER = (
StatusGroup.COMPLETE,
StatusGroup.PROCESSING,
StatusGroup.NOT_FULLY_LOADED)
def __init__(self, model, status):
self.paused = False
for some_status in self.STATUS_ORDER:
if not (some_status & status == some_status or \
some_status & status == 0):
raise ValueError("'status' must be one or a combination of "
"`StatusGroup.COMPLETE', `StatusGroup.PROCESSING' and "
"`StatusGroup.NOT_FULLY_LOADED'.")
self.model = model
self.status = status
with gtk_lock:
self.model_filter = self.model.get_filter_by_status(self.status)
# Mapping of download IDs to the last corresponding slot processed by
# `apply_slots'.
self._cache = {}
def apply_slots(self, slots, paused=False):
self.paused = paused
# Determine downloads that are not part of the slots anymore.
# When downloading recovery data, the download appears twice in the list
# of slots included in the response to the `QueueQuery'. Thus, filter
# duplicate IDs in order to prevent a `KeyError' from being raised when
# calling `old_positions.pop' below.
new_ids = unique([slot["nzo_id"] for slot in slots])
# List of iters found in `model_filter' for all downloads that are not
# part of `slots' anymore.
# Such downloads may have changed their status or may have been deleted
# by the user.
disappeared_iters = []
with gtk_lock:
for row in self.model_filter:
download = row[DownloadListStore.COLUMN]
if not download.id in new_ids:
# Defer calling `handle_disappearance' in order to avoid
# messing up the traversal of `model_filter'.
iter = self.model_filter.convert_iter_to_child_iter(
row.iter)
disappeared_iters.append(iter)
# Update download information
updated_downloads = set()
for iter in disappeared_iters:
download = self.model[iter][DownloadListStore.COLUMN]
updated_downloads.add(download)
self.handle_disappearance(iter, download)
for slot in slots:
download_id = slot["nzo_id"]
# Only update the download if no corresponding slot is in the
# cache or if the new slot is different from the one in the
# cache.
if download_id not in self._cache or \
self._cache[download_id] != slot:
if download_id in self.model._by_id:
download = self.model._by_id[download_id]
download.update(slot, paused)
else:
download = Download(download_id)
download.update(slot, paused)
self.model.append((download,))
self._cache[download_id] = slot
updated_downloads.add(download)
# Emit 'row-changed' for all updated downloads
for row in self.model:
if row[DownloadListStore.COLUMN] in updated_downloads:
self.model.row_changed(row.path, row.iter)
# Update order of downloads
new_order = []
for status in self.STATUS_ORDER:
# Determine the new order of downloads with status `status'.
model_filter = self.model.get_filter_by_status(status)
if self.status & status == status:
# The new order needs to be determined using `slots'.
# Maps downloads IDs of downloads with `status' to their
# absolute position in the download list.
old_positions = {}
# The new order of downloads that don't appear in `slots'.
# They have disappeared from `slots', but are expected to
# reappear soon in the output of another API method
# (i.e. the history query).
disappeared_order = []
received_order = []
for row in model_filter:
download = row[DownloadListStore.COLUMN]
path = model_filter.convert_path_to_child_path(
row.path)
old_positions[download.id] = path[0]
for new_id in new_ids:
download = self.model._by_id[new_id]
if bool(download.status & status):
received_order.append(old_positions.pop(new_id))
disappeared_order = old_positions.values()
disappeared_order.sort()
new_order.extend(disappeared_order)
new_order.extend(received_order)
else:
for row in model_filter:
path = model_filter.convert_path_to_child_path(
row.path)
new_order.append(path[0])
self.model.reorder(new_order)
def handle_disappearance(self, iter, download):
"""Remove `download' from the model."""
with gtk_lock:
self.model.remove(iter)
if download.id in self._cache:
del self._cache[download.id]
class DownloadListQueueUpdater(DownloadListUpdater):
def handle_disappearance(self, iter, download):
"""
Remove `download' from the model only if the download is likely to have
been deleted by the user through the SABnzbd web interface.
Otherwise, such a download might just have been completed and will thus
show up in the next 'history' query.
Also, downloads with the status `Status.GRABBING' will be replaced by
another one as soon as SABnzbd is done downloading the NZB file.
Thus, in this case, the temporary download entry should always be
removed from LottaNZB's download list.
"""
deleted = False
if download.has_status(StatusGroup.NOT_FULLY_LOADED):
deleted = \
download.status == Status.GRABBING or \
self.download_is_paused(download) or \
self.download_not_nearly_finished(download)
if deleted:
DownloadListUpdater.handle_disappearance(self, iter, download)
def download_is_paused(self, download):
return self.paused or download.has_status(Status.PAUSED)
def download_not_nearly_finished(self, download):
return download.time_left and download.time_left > TimeDelta(seconds=5)
lottanzb-0.6/lottanzb/backend/hubs/general/download.py 0000644 0001750 0001750 00000026503 11525760436 023064 0 ustar lantash lantash # Copyright (C) 2007-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import re
from os.path import basename
from lottanzb.core.environ import _
from lottanzb.util.gobject_extras import GObject, gproperty
from lottanzb.core.constants import Priority, PostProcessing
from lottanzb.backend.hubs import DataSize, TimeDelta, DateTime
__all__ = ["Status", "Download"]
class Status:
GRABBING, QUEUED, DOWNLOADING, PAUSED, QUICKCHECK, \
DOWNLOADING_RECOVERY_DATA, VERIFYING, REPAIRING, EXTRACTING, JOINING, \
MOVING, SCRIPT, PROCESSING, FAILED, SUCCEEDED = [2 ** i for i in range(15)]
@classmethod
def to_pretty_string(cls, status):
"""Return a printable string given a numerical download status."""
MAP = {
cls.GRABBING: _("Downloading NZB file"),
cls.QUEUED: _("Queued"),
cls.DOWNLOADING: _("Downloading"),
cls.PAUSED: _("Paused"),
cls.QUICKCHECK: _("Quick check"),
cls.DOWNLOADING_RECOVERY_DATA: _("Downloading recovery data"),
cls.VERIFYING: _("Verifying"),
cls.REPAIRING: _("Repairing"),
cls.EXTRACTING: _("Extracting"),
cls.JOINING: _("Joining"),
cls.MOVING: _("Moving to download directory"),
cls.SCRIPT: _("Executing script"),
cls.FAILED: _("Failed"),
cls.SUCCEEDED: _("Completed")
}
try:
return MAP[status]
except KeyError:
raise ValueError("Unknown status: %r", status)
class StatusGroup:
NOT_FULLY_LOADED = \
Status.GRABBING | \
Status.QUEUED | \
Status.DOWNLOADING | \
Status.PAUSED | \
Status.DOWNLOADING_RECOVERY_DATA
PROCESSING = \
Status.QUICKCHECK | \
Status.VERIFYING | \
Status.REPAIRING | \
Status.EXTRACTING | \
Status.JOINING | \
Status.MOVING | \
Status.SCRIPT
MOVABLE = \
Status.QUEUED | \
Status.DOWNLOADING | \
Status.PAUSED
INCOMPLETE = NOT_FULLY_LOADED | PROCESSING
COMPLETE = Status.SUCCEEDED | Status.FAILED
FULLY_LOADED = PROCESSING | COMPLETE
ANY_STATUS = NOT_FULLY_LOADED | FULLY_LOADED
class Download(GObject):
PERCENTAGE_PATTERN = re.compile(r"(\d{1,2})%")
PIECES_PROGRESS_PATTERN = re.compile(r"(\d+)/(\d+)")
RECOVERY_BLOCKS_PATTERN = re.compile(r"(\d+)")
URL_PATTERN = re.compile(r"https?\://[a-zA-Z0-9\-\.]+\.[a-zA-Z]{2,3}"
"(:[a-zA-Z0-9]*)?/?([a-zA-Z0-9\-\._\?\,\'/\\\+&%\$#\=~])*")
HTML_LINK_PATTERN = re.compile(r".* ")
status = gproperty(type=int, default=Status.QUEUED)
priority = gproperty(type=int, default=Priority.NORMAL)
id = gproperty(type=str)
file_name = gproperty(type=str)
name = gproperty(type=str)
average_age = gproperty(type=object)
time_left = gproperty(type=object)
size = gproperty(type=object)
size_left = gproperty(type=object)
eta = gproperty(type=object)
percentage = gproperty(type=int, minimum=0, maximum=100)
script = gproperty(type=str)
category = gproperty(type=str)
postprocessing = gproperty(type=int, default=PostProcessing.DELETE)
message_id = gproperty(type=int)
postprocessing_time = gproperty(type=object)
download_time = gproperty(type=object)
completed = gproperty(type=object)
storage_path = gproperty(type=str)
error_message = gproperty(type=str)
verification_percentage = gproperty(type=int, minimum=0, maximum=100)
repair_percentage = gproperty(type=int, minimum=0, maximum=100)
unpack_percentage = gproperty(type=int, minimum=0, maximum=100)
recovery_block_count = gproperty(type=int, minimum=0)
def __init__(self, download_id):
GObject.__init__(self)
self.id = download_id
@property
def size_downloaded(self):
if self.size is not None:
if self.size_left is None:
return DataSize(bytes=self.size.bytes)
else:
return DataSize(bytes=self.size.bytes - self.size_left.bytes)
def has_status(self, status):
return bool(self.status & status)
def update(self, data, paused):
if "avg_age" in data:
self.average_age = TimeDelta.from_string(data["avg_age"])
# data["filename"] is returned by `QueueQuery` and data["nzb_name"]
# is returned by `HistoryQuery`.
if "nzb_name" in data:
self.file_name = data["nzb_name"]
if not self.name:
self.name = self.get_clean_name(self.file_name)
elif "filename" in data:
self.file_name = data["filename"]
self.name = data["filename"]
if "name" in data:
self.name = data["name"]
# If a download is active, but the download speed is 0 Bytes/s
# (e.g. because the internet connection is not available), 'timeleft'
# will be '0:00:00', which is of course not correct.
if paused or data.get("eta", None) == "unknown":
self.time_left = None
self.eta = None
elif "timeleft" in data:
self.time_left = TimeDelta.from_string(data["timeleft"])
self.eta = DateTime.from_datetime(DateTime.now() + self.time_left)
if "mbleft" in data:
self.size_left = DataSize(mebibytes=float(data["mbleft"]))
if "mb" in data:
self.size = DataSize(mebibytes=float(data["mb"]))
elif "bytes" in data:
self.size = DataSize(bytes=int(data["bytes"]))
if "script" in data:
self.script = data["script"]
if "msgid" in data and data["msgid"]:
self.message_id = int(data["msgid"])
if "cat" in data:
self.category = data["cat"]
if "unpackopts" in data:
try:
self.postprocessing = int(data["unpackopts"])
except ValueError:
pass
if "priority" in data:
self.priority = {
"Force": Priority.TOP,
"High": Priority.HIGH,
"Low": Priority.LOW,
"Normal": Priority.NORMAL
}[data["priority"]]
if "status" in data:
# TODO: Not sure whether downloads in the post-processing queue in
# general have the status 'Queued' or whether only downloads
# requiring further transmissions are affected.
if data["status"] == "Queued" and data.get("loaded", False):
self.status = Status.DOWNLOADING_RECOVERY_DATA
else:
self.status = {
"Grabbing": Status.GRABBING,
"Queued": Status.QUEUED,
"Downloading": Status.DOWNLOADING,
"Paused": Status.PAUSED,
"QuickCheck": Status.QUICKCHECK,
"Fetching": Status.DOWNLOADING_RECOVERY_DATA,
"Verifying": Status.VERIFYING,
"Repairing": Status.REPAIRING,
"Extracting": Status.EXTRACTING,
"Moving": Status.MOVING,
"Running": Status.SCRIPT,
"Failed": Status.FAILED,
"Completed": Status.SUCCEEDED
}[data["status"]]
# Check whether this download represents the download of an NZB file
# given an URL.
# Unfortunately, SABnzbd doesn't seem to assign such downloads a
# separate status, so LottaNZB needs to make an educated guess.
# Also, the name and file name of the download is replaced by the
# where the NZB file is being downloaded from.
if self.status == Status.DOWNLOADING and not self.size \
and not self.size_left and not self.percentage:
match = self.URL_PATTERN.search(self.name)
if match:
self.status = Status.GRABBING
self.name = match.group()
self.file_name = match.group()
if self.status == Status.DOWNLOADING and paused:
self.status = Status.QUEUED
if "percentage" in data:
self.percentage = data["percentage"]
elif self.has_status(StatusGroup.FULLY_LOADED):
self.percentage = 100
if "postproc_time" in data:
self.postprocessing_time = TimeDelta(seconds=data["postproc_time"])
if "download_time" in data:
self.download_time = TimeDelta(seconds=data["download_time"])
if "completed" in data:
self.completed = DateTime.fromtimestamp(data["completed"])
if "storage" in data:
self.storage_path = data["storage"]
if "fail_message" in data:
# Some error messages contain a HTML link allowing the user to retry
# the download.
self.error_message = self.HTML_LINK_PATTERN.sub("",
data["fail_message"]).strip(" ,")
if self.has_status(Status.VERIFYING) and "action_line" in data:
match = self.PIECES_PROGRESS_PATTERN.search(data["action_line"])
if match:
verified_pieces = float(match.group(1))
total_pieces = float(match.group(2))
self.verification_percentage = verified_pieces / \
total_pieces * 100
if self.has_status(Status.REPAIRING) and "action_line" in data:
match = self.PERCENTAGE_PATTERN.search(data["action_line"])
if match:
self.repair_percentage = float(match.group(1))
if self.has_status(Status.EXTRACTING) and "action_line" in data:
match = self.PIECES_PROGRESS_PATTERN.search(data["action_line"])
if match:
extracted_pieces = float(match.group(1))
total_pieces = float(match.group(2))
self.unpack_percentage = extracted_pieces / total_pieces * 100
if self.has_status(Status.DOWNLOADING_RECOVERY_DATA) and \
"action_line" in data:
match = self.RECOVERY_BLOCKS_PATTERN.search(data["action_line"])
if match:
self.recovery_block_count = int(match.group(1))
@staticmethod
def get_clean_name(file_name):
"""
Remove the file extensions, as well as symbols like "." or "_" from
an NZB file name.
"""
name = basename(file_name)
name = re.compile(r"\.nzb", re.I).sub("", name)
name = re.compile(r"[\._]").sub(" ", name)
return name
lottanzb-0.6/lottanzb/backend/hubs/general/__init__.py 0000644 0001750 0001750 00000045636 11525760436 023024 0 ustar lantash lantash # Copyright (C) 2007-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import re
from threading import Thread, current_thread
from os.path import basename
from lottanzb.core.component import Component, implements, depends_on
from lottanzb.util.gobject_extras import gproperty
from lottanzb.util.gtk_extras import gtk_lock
from lottanzb.backend import Backend
from lottanzb.backend.interface import QueryCache, Interface
from lottanzb.backend.interface.queries import *
from lottanzb.backend.hubs import IHub, DataSize, DataSpeed, TimeDelta, DateTime
from lottanzb.backend.hubs.polling import PollingHub
from lottanzb.backend.hubs.general.download import Download, Status, StatusGroup
from lottanzb.backend.hubs.general.download_list import DownloadListStore
from lottanzb.backend.hubs.general.updater import (DownloadListUpdater,
DownloadListQueueUpdater)
__all__ = ["GeneralHub"]
class GeneralHub(Component):
implements(IHub)
depends_on(Backend)
depends_on(PollingHub)
paused = gproperty(type=bool, default=False)
speed = gproperty(type=object)
time_left = gproperty(type=object)
size_left = gproperty(type=object)
eta = gproperty(type=object)
def __init__(self, component_manager):
Component.__init__(self, component_manager)
with gtk_lock:
self.downloads = DownloadListStore()
self.time_left = TimeDelta()
self.size_left = DataSize()
self.speed = DataSpeed()
# Cache the polling queries so that `downloads' is only updated if
# there are new values.
# In the future, we could add a more sophisticated caching mechanism
# that also works on a per-download basis.
self.queue_cache = QueryCache()
self.history_cache = QueryCache()
# The thread that is currently executing `on_queue_query', which
# updates the `paused' property.
# None if `on_queue_thread' is currently not being executed.
self._thread_updating_queue = None
self.interface = self._component_manager.load(Backend).interface
self._queue_updater = DownloadListQueueUpdater(self.downloads,
StatusGroup.INCOMPLETE)
self._history_updater = DownloadListUpdater(self.downloads,
StatusGroup.COMPLETE | StatusGroup.PROCESSING)
polling_hub = self._component_manager.load(PollingHub)
polling_hub.schedule_fast(QueueQuery, self.on_queue_query)
# TODO: 15 seconds is too long for status reports during
# post-processing. However, if no post-processing is taking place and
# the history is large, frequent polling would be grossly inefficient.
# Thus, polling needs to be much more fine-grained. For example,
# it's possible to provide SABnzbd with a 'start' and 'limit' parameter
# and to get the status of an individual download.
polling_hub.schedule(15 * 1000, HistoryQuery, self.on_history_query)
event_map = {
DeleteDownloadsQuery: self.on_delete_downloads_query,
DeleteHistoryQuery: self.on_delete_downloads_query,
DeleteAllHistoryQuery: self.on_delete_all_history_query,
RenameDownloadQuery: self.on_rename_query,
PauseDownloadsQuery: self.on_pause_downloads_query,
ResumeDownloadsQuery: self.on_resume_downloads_query,
PriorityQuery: self.on_priority_query,
SwitchDownloadQuery: self.on_switch_download_query
}
for query_cls, handler in event_map.items():
self.interface.connect_query_started(query_cls, handler)
def on_queue_query(self, query):
# Avoid unnecessary work.
if not self.queue_cache.has_changed(query):
return
self._thread_updating_queue = current_thread()
response = query.response
self.paused = response["paused"]
self.size_left = DataSize(mebibytes=float(response["mbleft"]))
slots = response.get("slots", [])[:]
self._queue_updater.apply_slots(slots, self.paused)
active_filter = self.downloads.get_filter_by_status(
Status.DOWNLOADING | Status.DOWNLOADING_RECOVERY_DATA)
# It looks like SABnzbd somehow smoothes the values of 'speed'
# and 'time_left', which results in stranges values after having
# paused SABnzbd or after the last download is finished.
if len(active_filter) and not self.paused:
self.speed = DataSpeed(kibibytes=float(response["kbpersec"]))
self.time_left = TimeDelta.from_string(response["timeleft"])
else:
self.speed = DataSpeed()
self.time_left = None
self._thread_updating_queue = None
self.emit("updated")
def on_history_query(self, query):
# Avoid unnecessary work.
if not self.history_cache.has_changed(query):
return
slots = query.response["slots"][:]
slots.reverse()
self._history_updater.apply_slots(slots)
self.emit("updated")
def on_delete_downloads_query(self, interface, query):
with gtk_lock:
for row in self.downloads:
download = row[DownloadListStore.COLUMN]
if download.id in query.download_ids:
self.downloads.remove(row.iter)
self.emit("updated")
def on_delete_all_history_query(self, interface, query):
with gtk_lock:
for row in self.downloads:
download = row[DownloadListStore.COLUMN]
if download.has_status(StatusGroup.COMPLETE):
self.downloads.remove(row.iter)
self.emit("updated")
def on_rename_query(self, interface, query):
with gtk_lock:
if query.download_id in self.downloads._by_id:
download = self.downloads._by_id[query.download_id]
download.name = query.new_name
self.downloads.download_changed(download)
self.emit("updated")
def on_pause_downloads_query(self, interface, query):
"""Properly update the status of each download affected by the `query'
of type `PauseDownloadsQuery'.
"""
self._apply_status_to_downloads(query.download_ids, Status.PAUSED)
def on_resume_downloads_query(self, interface, query):
"""Properly update the status of each download affected by the `query'
of type `ResumeDownloadsQuery'.
"""
self._apply_status_to_downloads(query.download_ids, Status.QUEUED)
def _apply_status_to_downloads(self, download_ids, status):
"""Properly set the status of each download with an ID in
`download_ids' to `status'.
"""
with gtk_lock:
queue = self.downloads.get_filter_not_fully_loaded()
for row in queue:
download = row[DownloadListStore.COLUMN]
child_iter = queue.convert_iter_to_child_iter(row.iter)
child_path = queue.convert_path_to_child_path(row.path)
if download.id in download_ids:
download.status = status
self.downloads.row_changed(child_path, child_iter)
self._update_active_download()
def _update_active_download(self):
"""Unless the application is paused, choose the first queued (but not
paused) download in the queue to be the new (and only) active download.
"""
if self.paused:
return
with gtk_lock:
queue = self.downloads.get_filter_not_fully_loaded()
has_active_download = False
for row in queue:
download = row[DownloadListStore.COLUMN]
child_iter = queue.convert_iter_to_child_iter(row.iter)
child_path = queue.convert_path_to_child_path(row.path)
if has_active_download:
if download.status == Status.DOWNLOADING:
download.status = Status.QUEUED
self.downloads.row_changed(child_path, child_iter)
else:
if download.status == Status.QUEUED:
download.status = Status.DOWNLOADING
self.downloads.row_changed(child_path, child_iter)
if download.status == Status.DOWNLOADING:
has_active_download = True
def on_priority_query(self, interface, query):
with gtk_lock:
for download_id in query.download_ids:
download = self.downloads._by_id[download_id]
download.priority = query.priority
self.downloads.download_changed(download)
self.emit("updated")
def on_switch_download_query(self, interface, query):
if query.download_id == query.other_download_id:
return
source_iter = None
target_iter = None
with gtk_lock:
for row in self.downloads:
download = row[DownloadListStore.COLUMN]
if download.id == query.download_id:
source_iter = row.iter
source_position = row.path[0]
elif download.id == query.other_download_id:
target_iter = row.iter
target_position = row.path[0]
if source_iter is not None and target_iter is not None:
break
if target_position < source_position:
self.downloads.move_before(source_iter, target_iter)
else:
self.downloads.move_after(source_iter, target_iter)
self._update_active_download()
def set_property(self, key, value):
changed = Component.set_property(self, key, value)
# Only start a `PauseQuery' or `ResumeQuery' if the change of the
# `paused' property actually originates from the LottaNZB application
# and is not due to a `QueueQuery' response.
if key == "paused" and changed and \
self._thread_updating_queue is not current_thread():
if value:
query = PauseQuery()
else:
query = ResumeQuery()
self.interface.run_query(query)
if value:
self.speed = DataSpeed()
self.time_left = None
self.eta = None
with gtk_lock:
for row in self.downloads:
download = row[DownloadListStore.COLUMN]
if download.has_status(Status.DOWNLOADING):
download.status = Status.QUEUED
self.downloads.row_changed(row.path, row.iter)
self.emit("updated")
if key == "time_left":
if isinstance(value, TimeDelta):
self.eta = DateTime.from_datetime(DateTime.now() + value)
else:
self.eta = None
return changed
def move_download(self, download, index):
"""Move `download' to a specific `index' in the queue.
The operation will only succeed if the download can be moved and if the
index is valid.
"""
if not download.has_status(StatusGroup.MOVABLE):
raise ValueError(
"Download '{0}' with status '{1}' cannot be moved.".format(
download.id, Status.to_pretty_string(download.status)))
with gtk_lock:
queued_filter = self.downloads.get_filter_not_fully_loaded()
target_download = queued_filter[index][DownloadListStore.COLUMN]
if download is target_download:
# The download is already at the correct index.
return
query = SwitchDownloadQuery(download.id, target_download.id)
self.interface.run_query(query)
def move_download_relative(self, download, shift):
"""Move `download' to an index relative to the current one as specified
by `shift'.
The download will be moved to the index in the queue that is computed by
adding `shift' to its current index.
Thus, a positive value of `shift' causes the download to be moved
down the queue while a negative value of `shift' causes the download to
be moved to a higher place in the queue.
The operation will only succeed if the download can be moved and if the
target index is valid.
"""
if not shift:
# The download is already at the correct index.
return
with gtk_lock:
queued_downloads = self.downloads.get_filter_not_fully_loaded()
index = 0
for row in queued_downloads:
if row[DownloadListStore.COLUMN] is download:
index = row.path[0]
break
self.move_download(download, index + shift)
def move_download_up(self, download, shift=1):
"""Move `download' to a higher place in the queue.
By default, the download changes exchanges its place with the
download above it. In general, the `shift' argument can be used to
specify the number of downloads above `download' that should
be below it after the operation has taken place.
The operation will only succeed if the download can be moved and if the
target index is valid.
A `ValueError' is raised if `shift' is smaller than 1.
"""
if shift < 1:
raise ValueError("The argument 'shift' of 'move_download_up' must "
"be greater than zero, not %r." % shift)
self.move_download_relative(download, -shift)
def force_download(self, download):
"""Move `download' to the top of the queue and resume it if necessary,
causing it to become active immediately.
The operation will only succeed if the download can be moved.
"""
self.move_download(download, 0)
if download.status == Status.PAUSED:
self.resume_downloads(download)
def move_download_down(self, download, shift=1):
"""Move `download' to a lower place in the queue.
By default, the download changes exchanges its place with the
download below it. In general, the `shift' argument can be used to
specify the number of number of downloads below `download' that should
be above it after the operation has taken place.
The operation will only succeed if the download can be moved and if the
target index is valid.
A `ValueError' is raised if `shift' is smaller than 1.
"""
if shift < 1:
raise ValueError("The argument 'shift' of 'move_download_down' "
"must be greater than zero, not %r." % shift)
self.move_download_relative(download, shift)
def move_download_down_to_bottom(self, download):
"""Move `download' to the bottom of the queue.
The operation will only succeed if the download can be moved.
"""
with gtk_lock:
queued_downloads = self.downloads.get_filter_not_fully_loaded()
self.move_download(download, len(queued_downloads) - 1)
def delete_all_downloads(self):
return self.interface.run_query(DeleteAllDownloadsQuery())
def delete_downloads(self, *downloads):
ids = [download.id for download in downloads]
return self.interface.run_query(DeleteDownloadsQuery(*ids))
def pause_downloads(self, *downloads):
ids = [download.id for download in downloads]
return self.interface.run_query(PauseDownloadsQuery(*ids))
def resume_downloads(self, *downloads):
ids = [download.id for download in downloads]
return self.interface.run_query(ResumeDownloadsQuery(*ids))
def set_priority(self, priority, *downloads):
ids = [download.id for download in downloads]
return self.interface.run_query(PriorityQuery(priority, *ids))
def rename_download(self, download, new_name):
return self.interface.run_query(
RenameDownloadQuery(download.id, new_name))
def add_file(self, file_name, post_processor=None, script=None,
category=None, priority=None, name=None):
# If no pretty `name' has been specified, use the built-in method to
# clean it.
if name is None:
name = Download.get_clean_name(basename(file_name))
if self.interface.connection_info.is_local:
query_class = AddLocalFileQuery
else:
query_class = AddRemoteFileQuery
return self.interface.run_query(query_class(file_name, post_processor,
script, category, priority, name))
def add_url(self, url, post_processor=None, script=None, category=None,
priority=None):
query = AddURLQuery(url, post_processor, script, category, priority)
return self.interface.run_query(query)
def add_id(self, id, post_processor=None, script=None, category=None,
priority=None):
query = AddURLQuery(id, post_processor, script, category, priority)
return self.interface.run_query(query)
def pause(self):
self.paused = True
def resume(self):
self.paused = False
def shutdown(self):
return self.interface.run_query(ShutdownQuery())
def restart(self):
return self.interface.run_query(RestartQuery())
def delete_all_history(self):
return self.interface.run_query(DeleteAllHistoryQuery())
def delete_history(self, *downloads):
ids = [download.id for download in downloads]
return self.interface.run_query(DeleteHistoryQuery(*ids))
lottanzb-0.6/lottanzb/backend/hubs/capabilities.py 0000644 0001750 0001750 00000007565 11525760436 022300 0 ustar lantash lantash # Copyright (C) 2010-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
from threading import Lock
from lottanzb.util.gobject_extras import gproperty
from lottanzb.core.constants import PostProcessing
from lottanzb.backend import Backend
from lottanzb.core.component import Component, implements, depends_on
from lottanzb.backend.interface.queries import (
CapabilitiesQuery, RestartQuery, QueueQuery)
from lottanzb.backend.hubs import IHub
class CapabilitiesHub(Component):
implements(IHub)
depends_on(Backend)
supports_yenc = gproperty(type=bool, default=False)
supports_ssl = gproperty(type=bool, default=False)
par_path = gproperty(type=str)
rar_path = gproperty(type=str)
zip_path = gproperty(type=str)
nice_path = gproperty(type=str)
ionice_path = gproperty(type=str)
power_management_support = gproperty(type=bool, default=False,
nick="SABnzbd host supports power management",
blurb="Indicates whether SABnzbd has the possibility of shutting down, "
"suspending or hibernating the machine it's running on when all "
"downloads are complete.")
def __init__(self, component_manager):
Component.__init__(self, component_manager)
self._refresh_lock = Lock()
self.interface = self._component_manager.load(Backend).interface
self.interface.connect_query_success(RestartQuery,
self.on_restart_query)
self.interface.connect_query_success(QueueQuery,
self.on_queue_query)
def on_restart_query(self, interface, query):
self.refresh()
def on_queue_query(self, interface, query):
self.power_management_support = query.response["power_options"]
def on_capabilities_query(self, query):
response = query.response
self.yenc_support = response.get("yenc", False)
self.ssl_support = response.get("ssl", False)
self.par_path = response.get("par2c", "") or response.get("par2", "")
self.rar_path = response.get("rar", "")
self.zip_path = response.get("zip", "")
self.nice_path = response.get("nice", "")
self.ionice_path = response.get("ionice", "")
self.emit("updated")
self._refresh_lock.release()
def refresh(self):
if self._refresh_lock.acquire(False):
query = CapabilitiesQuery()
query.connect("success", self.on_capabilities_query)
self.interface.run_query(query)
def supports_software(self, software):
return bool(getattr(self, software + "_path", None))
def supports_post_processing(self, post_processing):
"""
If the query has been successful, check if a certain post-processing
level in `lottanzb.core.constants.PostProcessing` is supported by
SABnzbd.
"""
if post_processing == PostProcessing.REPAIR:
return self.supports_software("par")
elif post_processing in (PostProcessing.UNPACK, PostProcessing.DELETE):
return self.supports_software("rar") \
and self.supports_software("zip") \
and self.supports_post_processing(PostProcessing.REPAIR)
return True
lottanzb-0.6/lottanzb/backend/hubs/polling.py 0000644 0001750 0001750 00000005317 11525760436 021304 0 ustar lantash lantash # Copyright (C) 2007-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
from lottanzb.core.component import Component, implements, depends_on
from lottanzb.util.timer import Timer
from lottanzb.backend import Backend
from lottanzb.backend.hubs import IHub
class PollingHub(Component):
implements(IHub)
depends_on(Backend)
# The minimal amount of time in milliseconds between two polling queries.
# Will be used when calling `schedule_fast'.
MIN_POLLING_INTERVAL = 1000
def __init__(self, component_manager):
Component.__init__(self, component_manager)
self._timers = {}
self._interface = self._component_manager.load(Backend).interface
def schedule(self, interval, query_class, handler, run_now=True):
if interval < self.MIN_POLLING_INTERVAL:
interval = self.MIN_POLLING_INTERVAL
if query_class in self._timers:
timer = self._timers[query_class]
if interval < timer.timeout:
timer.timeout = interval
else:
timer = Timer(interval)
timer.connect("tick", self._on_tick, query_class)
timer.start()
self._on_tick(timer, query_class)
self._timers[query_class] = timer
def internal_handler(interface, query):
handler(query)
self._interface.connect_filtered(query_class, "query-success",
internal_handler)
def schedule_hourly(self, query_class, handler, run_now=True):
self.schedule(1000 * 60 * 60, query_class, handler, run_now)
def schedule_minutely(self, query_class, handler, run_now=True):
self.schedule(1000 * 60, query_class, handler, run_now)
def schedule_fast(self, query_class, handler, run_now=True):
self.schedule(self.MIN_POLLING_INTERVAL, query_class, handler, run_now)
def on_unload(self):
for timer in self._timers.values():
timer.stop()
def _on_tick(self, timer, query_class):
self._interface.run_query(query_class())
lottanzb-0.6/lottanzb/backend/hubs/statistics.py 0000644 0001750 0001750 00000006132 11525760436 022026 0 ustar lantash lantash # Copyright (C) 2010-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
from lottanzb.core.component import Component, implements, depends_on
from lottanzb.util.gobject_extras import gproperty
from lottanzb.backend import Backend
from lottanzb.backend.hubs import IHub, DataSize
from lottanzb.backend.hubs.polling import PollingHub
from lottanzb.backend.interface.queries import QueueQuery, HistoryQuery
__all__ = ["StatisticsHub"]
class StatisticsHub(Component):
implements(IHub)
depends_on(Backend)
depends_on(PollingHub)
# These statistical values are only available using SABnzbd 0.6 or newer.
# Otherwise, they default to 0 Bytes.
history_total_size = gproperty(type=object)
history_month_size = gproperty(type=object)
history_week_size = gproperty(type=object)
total_download_folder_space = gproperty(type=object)
total_temp_folder_space = gproperty(type=object)
free_download_folder_space = gproperty(type=object)
free_temp_folder_space = gproperty(type=object)
def __init__(self, component_manager):
Component.__init__(self, component_manager)
self.history_total_size = DataSize()
self.history_month_size = DataSize()
self.history_week_size = DataSize()
polling_hub = self._component_manager.load(PollingHub)
polling_hub.schedule(15 * 1000, QueueQuery, self.on_queue_query)
polling_hub.schedule(60 * 1000, HistoryQuery, self.on_history_query)
def on_queue_query(self, query):
response = query.response
self.total_download_folder_space = DataSize(
gibibytes=float(response["diskspacetotal2"]))
self.total_temp_folder_space = DataSize(
gibibytes=float(response["diskspacetotal1"]))
self.free_download_folder_space = DataSize(
gibibytes=float(response["diskspace2"]))
self.free_temp_folder_space = DataSize(
gibibytes=float(response["diskspace1"]))
def on_history_query(self, query):
# These statistical values are only available using SABnzbd 0.6 or
# newer. Otherwise, they default to 0 Bytes.
for time_frame in ("total", "month", "week"):
response_key = "%s_size" % time_frame
if response_key in query.response:
attribute = "history_%s_size" % time_frame
value = DataSize.from_string(query.response[response_key])
setattr(self, attribute, value)
lottanzb-0.6/lottanzb/backend/hubs/__init__.py 0000644 0001750 0001750 00000030710 11525760436 021372 0 ustar lantash lantash # Copyright (C) 2007-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import re
import locale
from datetime import datetime, timedelta
from gettext import ngettext
from lottanzb.core.environ import _
from lottanzb.core.component import Interface
from lottanzb.util.gobject_extras import gsignal
__all__ = ["DataSize", "DataSpeed", "TimeDelta", "DateTime", "IHub",
"import_core_hubs"]
class DataSize(object):
UNITS = ["bytes", "KiB", "MiB", "GiB", "TiB", "PiB"]
PATTERN = re.compile(r"""
^
(?P-?[0-9]+(\.[0-9]+)?)\s*(?P(B|KB|MB|GB|TB|PB)?)
$""", re.VERBOSE)
def __init__(self, bytes=0, kibibytes=0, mebibytes=0, gibibytes=0,
tebibytes=0, pebibytes=0):
self._data = sum([
bytes,
kibibytes * 2 ** 10,
mebibytes * 2 ** 20,
gibibytes * 2 ** 30,
tebibytes * 2 ** 40,
pebibytes * 2 ** 50,
])
@property
def bytes(self):
return self._data
@property
def kibibytes(self):
return self._data / float(2 ** 10)
@property
def mebibytes(self):
return self._data / float(2 ** 20)
@property
def gibibytes(self):
return self._data / float(2 ** 30)
def __str__(self):
value = self._data
n = 0
# Use 1000 as the lower boundary for switching the the next-higher
# scale. 1024 would be more accurate, but may cause the returned number
# to consist of 5 numbers instead of 4.
# Thus, even though this change introduces a slight mathematical
# inaccuracy ('1.0 MiB/s' is returned instead of '1023.9 KiB/s'),
# it will save a few pixels here and there and is also more readable.
while value >= 1000.0 and n < len(self.UNITS) - 1:
value = value / float(2 ** 10)
n = n + 1
info = { "data_size": value, "data_size_unit": self.UNITS[n]}
if n == 0:
info["data_size_unit"] = ngettext("byte", "bytes", value)
# Don't show any decimal places when displaying a number of bytes.
return _("%(data_size).0f %(data_size_unit)s") % info
else:
return _("%(data_size).1f %(data_size_unit)s") % info
def __nonzero__(self):
return self._data != 0
def __eq__(self, other):
if isinstance(other, DataSize):
return self._data == other._data
else:
return id(self) == id(other)
def __neq__(self, other):
if isinstance(other, DataSize):
return self._data != other._data
else:
return id(self) != id(other)
def __cmp__(self, other):
return cmp(self._data, other._data)
@classmethod
def from_string(cls, value):
match = cls.PATTERN.match(value)
if match:
unit_map = {
"": "bytes",
"B": "bytes",
"KB": "kibibytes",
"MB": "mebibytes",
"GB": "gibibytes",
"TB": "tebibytes",
"PB": "pedibytes"
}
try:
value = float(match.group("value"))
unit = unit_map[match.group("unit")]
except (KeyError, ValueError):
pass
else:
return DataSize(**{ unit: value })
elif not value:
return DataSize(0)
raise ValueError("Invalid data size.")
class DataSpeed(DataSize):
@property
def bytes_per_second(self):
return self.bytes
@property
def kibibytes_per_second(self):
return self.kibibytes
@property
def mebibytes_per_second(self):
return self.mebibytes
@property
def gibibytes_per_second(self):
return self.gibibytes
def __str__(self):
return _("%s/s") % DataSize.__str__(self)
class TimeDelta(timedelta):
PATTERN = re.compile(r"""
^
(?P\d+) :
(?P\d{2}) :
(?P\d{2})
$""", re.VERBOSE)
PATTERN_2 = re.compile(r"""
^
(?P\d+)
(?P[mhd])
$""", re.VERBOSE)
SCALES = ["days", "hours", "minutes", "seconds"]
@classmethod
def from_string(cls, value):
match = cls.PATTERN.search(value)
match_2 = cls.PATTERN_2.search(value)
if match:
return cls(
hours=int(match.group("hours")),
minutes=int(match.group("minutes")),
seconds=int(match.group("seconds")))
elif match_2:
value = int(match_2.group("value"))
unit = {
"m": "minutes",
"h": "hours",
"d": "days"
}.get(match_2.group("unit"))
return cls(**{ unit: value })
else:
raise ValueError("Invalid time format.")
@property
def short(self):
"""
Return a pretty, localized string representation of the `TimeDelta` like
'12 hours' or '1 second'.
Because a string like '1 hour' is not precise enough, it must also
include information about the value of the next smaller time scale, in
this case minutes.
Because such values will often be imprecise (especially if they're
estimations), the value of the next smaller time scale will be rounded
down.
This means that instead of '1 hour and 43 minutes', the returned string
will be '1 hour and 40 minutes'. For estimations that are likely to
change over time, this causes the return values to be changed less
frequently.
Consider the following example return values:
>>> TimeDelta(seconds=46).short
'46 seconds'
>>> TimeDelta(minutes=2, seconds=3).short
'2 minutes'
>>> TimeDelta(minutes=2, seconds=33).short
'2 minutes'.
>>> TimeDelta(hours=2, minutes=3).short
'2 hours'
>>> TimeDelta(hours=2, minutes=33).short
'2 hours and 30 minutes'.
>>> TimeDelta(days=2, minutes=57)
'2 days'
>>> TimeDelta(days=1, hours=18)
'1 day and 18 hours'
"""
# Use 'seconds' as the default major time scale so that if the
# `TimeDelta` is actually 0 seconds, the method doesn't return '0 days'.
major_scale = self.SCALES[-1]
minor_scale = None
for index, scale in enumerate(self.SCALES):
value = self._get_partitioned_value(scale)
if value >= 1:
major_scale = scale
if value < 10 and index != len(self.SCALES) - 1:
minor_scale = self.SCALES[index + 1]
break
if minor_scale is None or major_scale in ("seconds", "minutes"):
return self._get_simple_string(major_scale)
else:
minor_scale_value = self._get_partitioned_value(minor_scale)
if minor_scale in ("minutes", "seconds"):
# Only round minutes and seconds.
minor_scale_value = minor_scale_value / 10 * 10
if not minor_scale_value:
# Don't return something like '1 minute and 0 seconds', but
# simply '1 minute'.
return self._get_simple_string(major_scale)
rounded_time_delta = TimeDelta(**{
major_scale: self._get_partitioned_value(major_scale),
minor_scale: minor_scale_value
})
return _("%(major_time_scale)s and %(minor_time_scale)s") % {
"major_time_scale":
rounded_time_delta._get_simple_string(major_scale),
"minor_time_scale":
rounded_time_delta._get_simple_string(minor_scale)
}
def _get_partitioned_value(self, scale):
"""
Extract the integer number of seconds, minutes, hours or days calculated
using modulo 24 or 60, respectively.
As an example, if `TimeDelta` represents a duration of 2 hours,
32 minutes and 10 seconds, this method will do the following:
>>> _get_partitioned_value("days")
0
>>> _get_partitioned_value("hours")
2
>>> _get_partitioned_value("minutes")
32
>>> _get_partitioned_value("seconds")
10
"""
if not scale in self.SCALES:
raise ValueError("Unknown time scale.")
if scale == "days":
return self.days
elif scale == "hours":
return int(self.seconds / 3600) % 24
elif scale == "minutes":
return int(self.seconds / 60) % 60
elif scale == "seconds":
return self.seconds % 60
def _get_simple_string(self, scale):
"""
Return a string representation of the `TimeDelta` for a certain time
scale.
As an example, if `TimeDelta` represents a duration of 2 hours,
32 minutes and 10 seconds, this method will do the following:
>>> _get_simple_string("days")
'0 days'
>>> _get_simple_string("hours")
'2 hours'
>>> _get_simple_string("minutes")
'32 minutes'
>>> _get_simple_string("seconds")
'10 seconds'
"""
if not scale in self.SCALES:
raise ValueError("Unknown time scale.")
value = int(self._get_partitioned_value(scale))
if scale == "days":
return ngettext("%i day", "%i days", value) % value
elif scale == "hours":
return ngettext("%i hour", "%i hours", value) % value
elif scale == "minutes":
return ngettext("%i minute", "%i minutes", value) % value
elif scale == "seconds":
return ngettext("%i second", "%i seconds", value) % value
class DateTime(datetime):
PATTERN = re.compile(r"""
^
(?P\d{4})-
(?P\d{2})-
(?P\d{2}).*?
(?P\d{2}):
(?P\d{2}):
(?P\d{2}),
.*?
$""", re.VERBOSE)
@classmethod
def from_string(cls, value):
match = cls.PATTERN.search(value)
if match:
info = {
"year": int(match.group("year")),
"month": int(match.group("month")),
"day": int(match.group("day")),
"hour": int(match.group("hour")),
"minute": int(match.group("minute")),
"second": int(match.group("second"))
}
return cls(**info)
raise ValueError("Invalid date format.")
@classmethod
def from_datetime(cls, value):
"""Return the equivalent `DateTime' object given a `datetime' object"""
return cls.combine(value.date(), value.time())
@property
def full(self):
"""Localized string containing both the date and time"""
return self.strftime(locale.nl_langinfo(locale.D_T_FMT))
@property
def short_time(self):
"""Localized string containing only the time"""
return self.strftime(locale.nl_langinfo(locale.T_FMT))
@property
def short_date(self):
"""Localized string containing only the date"""
return self.strftime(locale.nl_langinfo(locale.D_FMT))
class IHub(Interface):
pass
def import_core_hubs():
from lottanzb.backend.hubs.config import ConfigHub
from lottanzb.backend.hubs.capabilities import CapabilitiesHub
from lottanzb.backend.hubs.general import GeneralHub
from lottanzb.backend.hubs.log import LoggingHub
from lottanzb.backend.hubs.polling import PollingHub
from lottanzb.backend.hubs.statistics import StatisticsHub
lottanzb-0.6/lottanzb/backend/hubs/log.py 0000644 0001750 0001750 00000011632 11525760436 020416 0 ustar lantash lantash # Copyright (C) 2007-2011 LottaNZB Development Team
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
import re
import hashlib
import os
import logging
import time
from os.path import isfile
from threading import Lock
LOG = logging.getLogger(__name__)
from lottanzb import resources
from lottanzb.core.component import Component, implements, depends_on
from lottanzb.util.gobject_extras import gsignal
from lottanzb.backend import Backend
from lottanzb.backend.hubs.polling import PollingHub
from lottanzb.backend.hubs import IHub, DateTime
from lottanzb.backend.interface.queries import WarningsQuery, ClearWarningsQuery
class LoggingHub(Component):
implements(IHub)
depends_on(Backend)
depends_on(PollingHub)
gsignal("records-added", object)
gsignal("records-cleared")
LOG_FILE = resources.get_config("sabnzbd_log")
LOG_FILE_LOCK = Lock()
SECONDS_BETWEEN_REQUESTS = 10
MESSAGE_PATTERN = re.compile("""
^
(?P.*?)\\n
(?P.*?)\\n
(?P.*?)
$""", re.VERBOSE | re.MULTILINE)
def __init__(self, component_manager):
Component.__init__(self, component_manager)
self.maybe_delete_log_file()
self._message_hashes = []
self._records = []
self._interface = self._component_manager.get(Backend).interface
self._interface.connect_query_started(ClearWarningsQuery,
self.on_clear_warnings_query)
polling_hub = self._component_manager.get(PollingHub)
polling_hub.schedule(1000 * self.SECONDS_BETWEEN_REQUESTS,
WarningsQuery, self.on_warnings_query)
def clear(self):
return self._interface.run_query(ClearWarningsQuery())
def maybe_delete_log_file(self):
if isfile(self.LOG_FILE):
os.unlink(self.LOG_FILE)
def on_clear_warnings_query(self, interface, query):
with self.LOG_FILE_LOCK:
self.maybe_delete_log_file()
self._records = []
self.emit("records-cleared")
def on_warnings_query(self, query):
if not query.response:
if self._records:
self._records = []
self.emit("records-cleared")
return
new_log_records = []
for raw_message in query.response:
message_hash = self.get_message_hash(raw_message)
if message_hash in self._message_hashes:
continue
match = self.MESSAGE_PATTERN.match(raw_message)
if match:
self._message_hashes.append(message_hash)
message = match.group("message")
level = {
"WARNING": logging.WARNING,
"ERROR": logging.ERROR
}.get(match.group("level"))
datetime = DateTime.from_string(match.group("created"))
created = time.mktime(datetime.timetuple())
new_log_records.append(
SABnzbdLogRecord(message, level, created))
self._records.extend(new_log_records)
self.emit("records-added", new_log_records)
with self.LOG_FILE_LOCK:
with open(self.LOG_FILE, "a") as log_file:
for log_record in new_log_records:
log_file.write("{created} {level:8} {message}\n".format(
created=log_record.created,
level=logging.getLevelName(log_record.levelno),
message=log_record.getMessage()))
@property
def records(self):
"""Returns a shallow copy of the array holding all `SABnzbdLogRecord`s.
"""
return self._records[:]
@staticmethod
def get_message_hash(message):
m = hashlib.sha224()
m.update(message)
return m.hexdigest()
class SABnzbdLogRecord(object):
"""Stores a SABnzbd log message.
This class has an interface that is similar to `logging.LogRecord's.
"""
def __init__(self, message, level, created):
self.msg = message
self.levelno = level
self.created = created
self.name = "sabnzbd"
self.args = []
def getMessage(self):
return self.msg
lottanzb-0.6/README 0000644 0001750 0001750 00000004753 11525760436 013764 0 ustar lantash lantash ============================
LottaNZB - Usenet Downloader
============================
LottaNZB aims to simplify and automate the download of files from the Usenet.
You can tell LottaNZB what to download using NZB files, which are created by
many Usenet search engines.
LottaNZB integrates nicely with GNOME desktops, but is not limited to them
and uses the mature SABnzbd software as its foundation. It is Free Software
and licensed under the terms of the General Public License 3.
Homepage: http://www.lottanzb.org
We are always grateful to receive feedback in the form of bug reports and
feature requests.
Installation instructions
=========================
Required packages
-----------------
First, make sure you have the following packages installed. You don't need
SABnzbd if you only want to control the downloads of another computer.
- sabnzbdplus >= 0.5.2
- python >= 2.6
- python-gtk2 >= 2.16
- python-dbus
- python-configobj
Recommended packages
--------------------
There are several packages we highly recommend to install if you want to make
full use of LottaNZB's capabilities.
For building LottaNZB (not running it):
- intltool
For displaying the help content:
- yelp (>= 2.30)
For checking and repairing downloads:
- par2 (>= 0.4)
For automatic extraction of RAR archives:
- unrar (>= 3.6.6) (non-free)
For automatic extraction of ZIP archives:
- unzip (>= 5.52)
For RSS support:
- python-feedparser (>= 4.1)
For SSL encryption and HTTPS remote access support:
- python-openssl (>= 0.6)
For a significantly faster decoding of downloads:
- python-yenc (>= 0.3)
For opening the download directory from within LottaNZB:
- python-gnome2 (the gnomevfs module)
For assistance with the installation of SABnzbd on Debian-based distributions:
- python-apt (>= 0.6.13)
- apturl
The package names may vary depending on your distribution.
Build LottaNZB
--------------
``python setup.py build``
Install/Upgrade LottaNZB
------------------------
Run as root or by using sudo on Ubuntu systems:
``python setup.py install``
Launch LottaNZB
---------------
In a terminal:
``lottanzb``
Via the GNOME menu:
Applications -> Internet -> LottaNZB Usenet Downloader
Have fun with LottaNZB!
Uninstallation instructions
===========================
When installing LottaNZB according to the steps described above, a file called
INSTALLED_FILES is created in the source directory. This file is required to
run the following command with root privileges:
``python setup.py uninstall``
lottanzb-0.6/PKG-INFO 0000644 0001750 0001750 00000002117 11525760443 014167 0 ustar lantash lantash Metadata-Version: 1.1
Name: lottanzb
Version: 0.6
Summary: LottaNZB - Usenet Downloader
Home-page: http://www.lottanzb.org/
Author: LottaNZB Development Team
Author-email: avirulence@lottanzb.org
License: GPL
Description: LottaNZB aims to simplify and automate the download of binary news from the Usenet. You can tell LottaNZB what to download using NZB files, which are created by many Usenet search engines. LottaNZB integrates nicely with GNOME desktops, but is not limited to them and uses the mature SABnzbd software as its foundation.
Keywords: usenet,nzb,download,sabnzbd,frontend,gtk
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: X11 Applications :: Gnome
Classifier: Environment :: X11 Applications :: GTK
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Topic :: Communications :: Usenet News
Requires: configobj
Requires: dbus
Requires: gtk
Provides: lottanzb
lottanzb-0.6/distutilsextra/ 0000755 0001750 0001750 00000000000 11525760442 016160 5 ustar lantash lantash lottanzb-0.6/distutilsextra/command/ 0000755 0001750 0001750 00000000000 11525760442 017576 5 ustar lantash lantash lottanzb-0.6/distutilsextra/command/build_i18n.py 0000644 0001750 0001750 00000014075 11525760436 022120 0 ustar lantash lantash """distutils_extra.command.build_i18n
Implements the Distutils 'build_i18n' command."""
import distutils
import glob
import os
import os.path
import re
import sys
import distutils.command.build
class build_i18n(distutils.cmd.Command):
description = "integrate the gettext framework"
user_options = [('desktop-files=', None, '.desktop.in files that '
'should be merged'),
('xml-files=', None, '.xml.in files that should be '
'merged'),
('schemas-files=', None, '.schemas.in files that '
'should be merged'),
('ba-files=', None, 'bonobo-activation files that '
'should be merged'),
('rfc822deb-files=', None, 'RFC822 files that should '
'be merged'),
('key-files=', None, '.key.in files that should be '
'merged'),
('domain=', 'd', 'gettext domain'),
('merge-po', 'm', 'merge po files against template'),
('po-dir=', 'p', 'directory that holds the i18n files'),
('bug-contact=', None, 'contact address for msgid bugs')]
boolean_options = ['merge-po']
def initialize_options(self):
self.desktop_files = []
self.xml_files = []
self.key_files = []
self.schemas_files = []
self.ba_files = []
self.rfc822deb_files = []
self.domain = None
self.merge_po = False
self.bug_contact = None
self.po_dir = None
def finalize_options(self):
if self.domain is None:
self.domain = self.distribution.metadata.name
if self.po_dir is None:
self.po_dir = "po"
def run(self):
"""
Update the language files, generate mo files and add them
to the to be installed files
"""
if not os.path.isdir(self.po_dir):
return
data_files = self.distribution.data_files
if data_files is None:
# in case not data_files are defined in setup.py
self.distribution.data_files = data_files = []
if self.bug_contact is not None:
os.environ["XGETTEXT_ARGS"] = "--msgid-bugs-address=%s " % \
self.bug_contact
# Print a warning if there is a Makefile that would overwrite our
# values
if os.path.exists("%s/Makefile" % self.po_dir):
self.announce("""
WARNING: Intltool will use the values specified from the
existing po/Makefile in favor of the vaules
from setup.cfg.
Remove the Makefile to avoid problems.""")
# If there is a po/LINGUAS file, or the LINGUAS environment variable
# is set, only compile the languages listed there.
selected_languages = None
linguas_file = os.path.join(self.po_dir, "LINGUAS")
if os.path.isfile(linguas_file):
selected_languages = open(linguas_file).read().split()
if "LINGUAS" in os.environ:
selected_languages = os.environ["LINGUAS"].split()
# Update po(t) files and print a report
# We have to change the working dir to the po dir for intltool
cmd = ["intltool-update", (self.merge_po and "-r" or "-p"), "-g", self.domain]
wd = os.getcwd()
os.chdir(self.po_dir)
self.spawn(cmd)
os.chdir(wd)
max_po_mtime = 0
for po_file in glob.glob("%s/*.po" % self.po_dir):
lang = os.path.basename(po_file[:-3])
if selected_languages and not lang in selected_languages:
continue
mo_dir = os.path.join("build", "mo", lang, "LC_MESSAGES")
mo_file = os.path.join(mo_dir, "%s.mo" % self.domain)
if not os.path.exists(mo_dir):
os.makedirs(mo_dir)
cmd = ["msgfmt", po_file, "-o", mo_file]
po_mtime = os.path.getmtime(po_file)
mo_mtime = os.path.exists(mo_file) and os.path.getmtime(mo_file) or 0
if po_mtime > max_po_mtime:
max_po_mtime = po_mtime
if po_mtime > mo_mtime:
self.spawn(cmd)
targetpath = os.path.join("share/locale", lang, "LC_MESSAGES")
data_files.append((targetpath, (mo_file,)))
# merge .in with translation
for (option, switch) in ((self.xml_files, "-x"),
(self.desktop_files, "-d"),
(self.schemas_files, "-s"),
(self.rfc822deb_files, "-r"),
(self.ba_files, "-b"),
(self.key_files, "-k"),):
try:
file_set = eval(option)
except:
continue
for (target, files) in file_set:
build_target = os.path.join("build", target)
if not os.path.exists(build_target):
os.makedirs(build_target)
files_merged = []
for file in files:
if file.endswith(".in"):
file_merged = os.path.basename(file[:-3])
else:
file_merged = os.path.basename(file)
file_merged = os.path.join(build_target, file_merged)
cmd = ["intltool-merge", switch, self.po_dir, file,
file_merged]
mtime_merged = os.path.exists(file_merged) and \
os.path.getmtime(file_merged) or 0
mtime_file = os.path.getmtime(file)
if mtime_merged < max_po_mtime or mtime_merged < mtime_file:
# Only build if output is older than input (.po,.in)
self.spawn(cmd)
files_merged.append(file_merged)
data_files.append((target, files_merged))
# class build
lottanzb-0.6/distutilsextra/command/clean_i18n.py 0000644 0001750 0001750 00000002545 11525760436 022102 0 ustar lantash lantash """distutils_extra.command.clean_i18n
Implements the Distutils 'clean_i18n' command."""
import os.path, os
from distutils.dir_util import remove_tree
import distutils.command.clean
class clean_i18n(distutils.command.clean.clean):
description = "clean up files generated by build_i18n"
def run(self):
# clean build/mo
mo_dir = os.path.join("build", "mo")
if os.path.isdir(mo_dir):
remove_tree('build/mo')
# clean built i18n files
for setname in ('xml_files', 'desktop_files', 'schemas_files',
'rfc822deb_files', 'ba_files', 'key_files'):
file_set = eval(self.distribution.get_option_dict('build_i18n').get(setname, (None, '[]'))[1])
for (target, files) in file_set:
build_target = os.path.join("build", target)
for file in files:
if file.endswith(".in"):
file_merged = os.path.basename(file[:-3])
else:
file_merged = os.path.basename(file)
file_merged = os.path.join(build_target, file_merged)
if os.path.exists(file_merged):
os.unlink(file_merged)
if os.path.exists(build_target):
os.removedirs(build_target)
distutils.command.clean.clean.run(self)
lottanzb-0.6/distutilsextra/command/build_help.py 0000644 0001750 0001750 00000002501 11525760436 022260 0 ustar lantash lantash '''Implement the Distutils "build_help" command.'''
from glob import glob
import os.path
import distutils.cmd
class build_help(distutils.cmd.Command):
description = 'install docbook XML based documentation'
user_options= [('help-dir', None, 'help directory in the source tree')]
def initialize_options(self):
self.help_dir = None
def finalize_options(self):
if self.help_dir is None:
self.help_dir = 'help'
def get_data_files(self):
data_files = []
name = self.distribution.metadata.name
omf_pattern = os.path.join(self.help_dir, '*', '*.omf')
for path in glob(os.path.join(self.help_dir, '*')):
lang = os.path.basename(path)
path_xml = os.path.join('share/gnome/help', name, lang)
path_figures = os.path.join('share/gnome/help', name, lang, 'figures')
data_files.append((path_xml, glob('%s/*.page' % path)))
data_files.append((path_figures, glob('%s/figures/*.png' % path)))
data_files.append((os.path.join('share', 'omf', name), glob(omf_pattern)))
return data_files
def run(self):
self.announce('Setting up help files...')
data_files = self.distribution.data_files
data_files.extend(self.get_data_files())
lottanzb-0.6/distutilsextra/command/pylint.py 0000644 0001750 0001750 00000006005 11525760436 021473 0 ustar lantash lantash # distutilsextra.command.pylint - DistUtilsExtra command to call pylint
#
# Author: Rodney Dawes
# Copyright 2009 Canonical Ltd.
"""distutilsextra.command.pylint
Implements the distutilsextra 'pylint' command.
"""
import os
import subprocess
from distutils.core import Command
class pylint (Command):
"""Command to run pylint and tests on a module."""
description = "integrate pylint checks"
user_options = [("config-file=", None,
"pylint config file to use"),
("exclude-files=", None,
"list of files to exclude from lint checks"),
("lint-files=", None,
"list of modules or packages to run lint checks on")
]
def initialize_options (self):
self.config_file = None
self.exclude_files = None
self.lint_files = None
def finalize_options (self):
if self.config_file is None:
self.config_file = ""
if self.exclude_files is None:
self.exclude_files = "[]"
if self.lint_files is None:
self.lint_files = "[" + self.__find_files() + "]"
def run (self):
pylint_args = ["--output-format=parseable",
"--include-ids=yes"]
if self.config_file:
pylint_args.append("--rcfile=" + self.config_file)
for file in eval(self.lint_files):
pylint_args.append(file)
p = subprocess.Popen(["pylint"] + pylint_args,
bufsize=4096, stdout=subprocess.PIPE)
notices = p.stdout
output = "".join(notices.readlines())
if output != "":
print "== Pylint notices =="
print self.__group_lines_by_file(output)
def __group_lines_by_file(self, input):
"""Format file:line:message output as lines grouped by file."""
outputs = []
filename = ""
excludes = eval(self.exclude_files)
for line in input.splitlines():
current = line.split(":", 3)
if line.startswith(" "):
outputs.append(" " + current[0] + "")
elif line.startswith("build/") or current[0] in excludes or \
len(current) < 3:
pass
elif filename == current[0]:
outputs.append(" " + current[1] + ": " + current[2])
elif filename != current[0]:
filename = current[0]
outputs.append("")
outputs.append(filename + ":")
outputs.append(" " + current[1] + ": " + current[2])
return "\n".join(outputs)
def __find_files(self):
"""Find all Python files under the current tree."""
pyfiles = []
for root, dirs, files in os.walk(os.getcwd(), topdown=False):
for file in files:
if file.endswith(".py"):
pyfiles.append("'" + os.path.join(root, file) + "'")
pyfiles.sort()
return ",".join(pyfiles)
lottanzb-0.6/distutilsextra/command/build_icons.py 0000644 0001750 0001750 00000002310 11525760436 022441 0 ustar lantash lantash """distutils_extra.command.build_icons
Implement DistutilsExtra's 'build_icons' command.
"""
# Created by Sebastian Heinlein
__revision__ = "$Id$"
import distutils
import glob
import os
import os.path
import re
import sys
import distutils.command.build
class build_icons(distutils.cmd.Command):
description = "select all icons for installation"
user_options= [('icon-dir=', 'i', 'icon directory of the source tree')]
def initialize_options(self):
self.icon_dir = None
def finalize_options(self):
if self.icon_dir is None:
self.icon_dir = os.path.join("data","icons")
def run(self):
data_files = self.distribution.data_files
for size in glob.glob(os.path.join(self.icon_dir, "*")):
for category in glob.glob(os.path.join(size, "*")):
icons = []
for icon in glob.glob(os.path.join(category,"*")):
icons.append(icon)
data_files.append(("share/icons/hicolor/%s/%s" % \
(os.path.basename(size), \
os.path.basename(category)), \
icons))
# class build
lottanzb-0.6/distutilsextra/command/build_extra.py 0000644 0001750 0001750 00000005277 11525760436 022470 0 ustar lantash lantash import distutils
import glob
import os
import os.path
import re
import sys
import distutils.command.build
class build_extra(distutils.command.build.build):
"""Adds the extra commands to the build target. This class should be used
with the core distutils"""
def __init__(self, dist):
distutils.command.build.build.__init__(self, dist)
self.user_options.extend([("i18n", None, "use the localisation"),
("icons", None, "use icons"),
("kdeui", None, "use kdeui"),
("help", None, "use help system")])
def initialize_options(self):
distutils.command.build.build.initialize_options(self)
self.i18n = False
self.icons = False
self.help = False
self.kdeui = False
def finalize_options(self):
def has_help(command):
return self.help == "True" or \
("build_help" in self.distribution.cmdclass and not \
self.help == "False")
def has_icons(command):
return self.icons == "True" or \
("build_icons" in self.distribution.cmdclass and not \
self.help == "False")
def has_i18n(command):
return self.i18n == "True" or \
("build_i18n" in self.distribution.cmdclass and not \
self.i18n == "False")
def has_kdeui(command):
return self.kdeui == "True" or \
("build_kdeui" in self.distribution.cmdclass and not \
self.kdeui == "False")
distutils.command.build.build.finalize_options(self)
self.sub_commands.append(("build_i18n", has_i18n))
self.sub_commands.append(("build_icons", has_icons))
self.sub_commands.append(("build_help", has_help))
self.sub_commands.insert(0, ("build_kdeui", has_kdeui)) # need to run before build_py
class build(build_extra):
"""Adds the extra commands to the build target. This class should be
used with setuptools."""
def finalize_options(self):
def has_help(command):
return self.help == "True"
def has_icons(command):
return self.icons == "True"
def has_i18n(command):
return self.i18n == "True"
def has_kdeui(command):
return self.kdeui == "True"
distutils.command.build.build.finalize_options(self)
self.sub_commands.append(("build_i18n", has_i18n))
self.sub_commands.append(("build_icons", has_icons))
self.sub_commands.append(("build_help", has_help))
self.sub_commands.insert(0, ("build_kdeui", has_kdeui)) # need to run before build_py
lottanzb-0.6/distutilsextra/command/__init__.py 0000644 0001750 0001750 00000000241 11525760436 021707 0 ustar lantash lantash __all__ = ["build_extra",
"build_i18n",
"build_icons",
"build_help",
"clean_i18n",
"pylint",
]
lottanzb-0.6/distutilsextra/auto.py 0000644 0001750 0001750 00000054055 11525760436 017516 0 ustar lantash lantash '''distutilsextra.auto
This provides a setup() method for distutils and distutilsextra which infers as
many setup() arguments as possible. The idea is that your setup.py only needs
to have the metadata and some tweaks for unusual files/paths, in a "convention
over configuration" paradigm.
This currently supports:
* Python modules (./*.py, only in root directory)
* Python packages (all directories with __init__.py)
* Docbook-XML GNOME help files (help//{*.xml,*.omf,figures})
* GtkBuilder and Qt4 user interfaces (*.ui) [installed into
prefix/share//]
* D-Bus (*.conf and *.service)
* PolicyKit (*.policy.in)
* Desktop files (*.desktop.in) [into prefix/share/applications, or
prefix/share/autostart if they have "autostart" anywhere in the path]
* KDE4 notifications (*.notifyrc.in)
* Apport hooks (apport/*) [installed into /usr/share/apport/package-hooks]
* scripts (all in bin/, and ./
* Auxiliary data files (in data/*) [into prefix/share//]
* automatic po/POTFILES.in (with all source files which contain _())
* automatic MANIFEST (everything except swap and backup files, *.pyc, and
revision control)
* manpages (*.[0-9])
* icons (data/icons///*.{svg,png})
* files which should go into /etc (./etc/*, copied verbatim)
* determining "requires" from import statements in source code
* determining "provides" from shipped packages and modules
If you follow above conventions, then you don't need any po/POTFILES.in,
./setup.cfg, or ./MANIFEST.in, and just need the project metadata (name,
author, license, etc.) in ./setup.py.
'''
# (c) 2009 Canonical Ltd.
# Author: Martin Pitt
import os, os.path, fnmatch, stat, sys, subprocess
import ast
import distutils.core
from distutilsextra import __version__ as __pkgversion
from distutilsextra.command import *
import distutils.dir_util
import distutils.command.clean
import distutils.command.sdist
import distutils.command.install
import distutils.filelist
__version__ = __pkgversion
# FIXME: global variable, to share with build_i18n_auto
src = {}
src_all = {}
def setup(**attrs):
'''Auto-inferring extension of standard distutils.core.setup()'''
global src
global src_all
src_all = src_find(attrs)
src = src_all.copy()
# src_find() removes explicit scripts, but we need them for automatic
# POTFILE.in building and requires
src_all.update(set(attrs.get('scripts', [])))
src_mark(src, 'setup.py')
src_markglob(src, 'setup.cfg')
# mark files in etc/*, handled by install_auto
# don't install distutilsextra if bundled with a source tarball
# ignore packaging
ignore_dirs = ['etc', 'distutilsextra', 'debian']
for f in src.copy():
for d in ignore_dirs:
if f.startswith(d + os.path.sep):
src.remove(f)
__cmdclass(attrs)
__modules(attrs, src)
__packages(attrs, src)
__provides(attrs, src)
__dbus(attrs, src)
__apport_hooks(attrs, src)
__data(attrs, src)
__scripts(attrs, src)
__stdfiles(attrs, src)
__ui(attrs, src)
__manpages(attrs, src)
if 'clean' not in sys.argv:
__requires(attrs, src_all)
distutils.core.setup(**attrs)
if src and "-v" in sys.argv:
print 'WARNING: the following files are not recognized by distutilsextra.auto:'
for f in sorted(src):
print ' ', f
#
# parts of setup()
#
class clean_build_tree(distutils.command.clean.clean):
description = 'clean up build/ directory'
def run(self):
# clean build/mo
if os.path.isdir('build'):
distutils.dir_util.remove_tree('build')
distutils.command.clean.clean.run(self)
def __cmdclass(attrs):
'''Default cmdclass for distutilsextra'''
v = attrs.setdefault('cmdclass', {})
v.setdefault('build', build_extra.build_extra)
v.setdefault('build_help', build_help_auto)
v.setdefault('build_i18n', build_i18n_auto)
v.setdefault('build_icons', build_icons.build_icons)
v.setdefault('install', install_auto)
v.setdefault('clean', clean_build_tree)
v.setdefault('sdist', sdist_auto)
v.setdefault('pylint', pylint.pylint)
def __modules(attrs, src):
'''Default modules'''
if 'py_modules' in attrs:
for mod in attrs['py_modules']:
print mod
src_markglob(src, os.path.join(mod, '*.py'))
return
mods = attrs.setdefault('py_modules', [])
for f in src_fileglob(src, '*.py'):
if os.path.sep not in f:
mods.append(os.path.splitext(f)[0])
src_markglob(src, f)
def __packages(attrs, src):
'''Default packages'''
if 'packages' in attrs:
for pkg in attrs['packages']:
src_markglob(src, os.path.join(pkg, '*.py'))
return
packages = attrs.setdefault('packages', [])
for f in src_fileglob(src, '__init__.py'):
if f.startswith('data' + os.path.sep):
continue
pkg = os.path.dirname(f)
packages.append(pkg)
src_markglob(src, os.path.join(pkg, '*.py'))
def __dbus(attrs, src):
'''D-Bus configuration and services'''
v = attrs.setdefault('data_files', [])
# /etc/dbus-1/system.d/*.conf
dbus_conf = []
for f in src_fileglob(src, '*.conf'):
if '-//freedesktop//DTD D-BUS Bus Configuration' in open(f).read():
src_mark(src, f)
dbus_conf.append(f)
if dbus_conf:
v.append(('/etc/dbus-1/system.d/', dbus_conf))
session_service = []
system_service = []
# dbus services
for f in src_fileglob(src, '*.service'):
lines = [l.strip() for l in open(f).readlines()]
if '[D-BUS Service]' not in lines:
continue
for l in lines:
if l.startswith('User='):
src_mark(src, f)
system_service.append(f)
break
else:
src_mark(src, f)
session_service.append(f)
if system_service:
v.append(('share/dbus-1/system-services', system_service))
if session_service:
v.append(('share/dbus-1/services', session_service))
def __apport_hooks(attrs, src):
'''Apport hooks'''
v = attrs.setdefault('data_files', [])
# files will be copied to /usr/share/apport/package-hooks/
hooks = []
assert 'name' in attrs, 'You need to set the "name" property in setup.py'
for f in src_fileglob(src, '*.py'):
if f.startswith('apport/'):
hooks.append(f)
src_mark(src, f)
if hooks:
v.append(('share/apport/package-hooks/', hooks))
def __data(attrs, src):
'''Install auxiliary data files.
This installs everything from data/ except data/icons/ and *.in files (which
are handled differently) into prefix/share//.
'''
v = attrs.setdefault('data_files', [])
assert 'name' in attrs, 'You need to set the "name" property in setup.py'
data_files = []
for f in src.copy():
if f.startswith('data/') and not f.startswith('data/icons/') and \
not f.endswith('.desktop.in') and not f.endswith('.notifyrc.in'):
if not os.path.islink(f):
# symlinks are handled in install_auto
v.append((os.path.join('share', attrs['name'], os.path.dirname(f[5:])), [f]))
src_mark(src, f)
def __scripts(attrs, src):
'''Install scripts.
This picks executable scripts in bin/*, and an executable ./.
Other scripts have to be added manually; this is to avoid automatically
installing test suites, build scripts, etc.
'''
assert 'name' in attrs, 'You need to set the "name" property in setup.py'
scripts = []
for f in src.copy():
if f.startswith('bin/') or f == attrs['name']:
st = os.lstat(f)
if stat.S_ISREG(st.st_mode) and st.st_mode & stat.S_IEXEC:
scripts.append(f)
src_mark(src, f)
elif stat.S_ISLNK(st.st_mode):
# symlinks are handled in install_auto
src_mark(src, f)
if scripts:
v = attrs.setdefault('scripts', [])
v += scripts
def __stdfiles(attrs, src):
'''Install/mark standard files.
This covers COPYING, AUTHORS, README, etc.
'''
src_markglob(src, 'COPYING*')
src_markglob(src, 'LICENSE*')
src_markglob(src, 'AUTHORS')
src_markglob(src, 'MANIFEST.in')
src_markglob(src, 'MANIFEST')
src_markglob(src, 'TODO')
# install all README* from the root directory
readme = []
for f in src_fileglob(src, 'README*').union(src_fileglob(src, 'NEWS')):
if os.path.sep not in f:
readme.append(f)
src_mark(src, f)
if readme:
assert 'name' in attrs, 'You need to set the "name" property in setup.py'
attrs.setdefault('data_files', []).append((os.path.join('share', 'doc',
attrs['name']), readme))
def __ui(attrs, src):
'''Install GtkBuilder/Qt *.ui files'''
ui = []
for f in src_fileglob(src, '*.ui'):
fd = open(f)
firstlines = fd.readline()
firstlines += '\n' + fd.readline()
fd.close()
if '> sys.stderr, 'ERROR: Python module %s not found' % module
return False
except AttributeError: # builtin modules
return False
return 'dist-packages' in path or 'site-packages' in path or \
not path.startswith(os.path.dirname(os.__file__))
def __add_imports(imports, file, attrs):
'''Add all imported modules from file to imports set.
This filters out modules which are shipped with Python itself.
'''
try:
tree = ast.parse(open(file).read(), file)
for node in ast.walk(tree):
if isinstance(node, ast.Import):
for alias in node.names:
if __external_mod(alias.name, attrs):
imports.add(alias.name)
if isinstance(node, ast.ImportFrom):
if __external_mod(node.module, attrs):
imports.add(node.module)
except SyntaxError, e:
print >> sys.stderr, 'WARNING: syntax errors in', file, ':', e
def _module_parents(mod):
'''Iterate over all parents of a module'''
hierarchy = mod.split('.')
hierarchy.pop()
while hierarchy:
yield '.'.join(hierarchy)
hierarchy.pop()
def __filter_namespace(modules):
'''Filter out modules which are already covered by a parent module
E. g. this transforms ['os.path', 'os', 'foo.bar.baz', 'foo.bar'] to
['os', 'foo.bar'].
'''
result = set()
for m in modules:
for p in _module_parents(m):
if p in modules:
break
else:
result.add(m)
return sorted(result)
def __requires(attrs, src_all):
'''Determine requires (if not set explicitly)'''
if 'requires' in attrs:
return
imports = set()
# iterate over all *.py and scripts which are Python
for s in src_all:
if s == 'setup.py':
continue
if s.startswith('data' + os.path.sep):
continue
ext = os.path.splitext(s)[1]
if ext == '':
f = open(s)
line = f.readline()
if not line.startswith('#!') or 'python' not in line:
continue
elif ext != '.py':
continue
__add_imports(imports, s, attrs)
attrs['requires'] = __filter_namespace(imports)
def __provides(attrs, src_all):
'''Determine provides (if not set explicitly)'''
if 'provides' in attrs:
return
provides = list(attrs.get('py_modules', [])) # we need a copy here
for p in attrs.get('packages', []):
provides.append(p.replace(os.path.sep, '.'))
attrs['provides'] = __filter_namespace(provides)
#
# helper functions
#
def src_find(attrs):
'''Find source files.
This ignores all source files which are explicitly specified as setup()
arguments.
'''
src = set()
# files explicitly covered in setup() call
explicit = set(attrs.get('scripts', []))
for (destdir, files) in attrs.get('data_files', []):
explicit.update(files)
for (root, dirs, files) in os.walk('.'):
if root.startswith('./'):
root = root[2:]
if root == '.':
root = ''
if root.startswith('.') or \
root.split(os.path.sep, 1)[0] in ('build', 'test', 'tests'):
continue
# data/icons is handled by build_icons
if root.startswith(os.path.join('data', 'icons')):
continue
for f in files:
ext = os.path.splitext(f)[1]
if f.startswith('.') or ext in ('.pyc', '~', '.mo'):
continue
# po/*.po is taken care of by build_i18n
if root == 'po' and (ext == '.po' or f == 'POTFILES.in'):
continue
path = os.path.join(root, f)
if path not in explicit:
src.add(path)
return src
def src_fileglob(src, fnameglob):
'''Return set of files which match fnameglob.'''
result = set()
for f in src:
if fnmatch.fnmatch(os.path.basename(f), fnameglob):
result.add(f)
return result
def src_mark(src, path):
'''Remove path from src.'''
src.remove(path)
def src_markglob(src, pathglob):
'''Remove all paths from src which match pathglob.'''
for f in src.copy():
if fnmatch.fnmatch(f, pathglob):
src.remove(f)
#
# Automatic setup.cfg
#
class build_help_auto(build_help.build_help):
def finalize_options(self):
build_help.build_help.finalize_options(self)
global src
for data_set in self.get_data_files():
for filepath in data_set[1]:
src.remove(filepath)
class build_i18n_auto(build_i18n.build_i18n):
def finalize_options(self):
build_i18n.build_i18n.finalize_options(self)
global src
global src_all
# add PolicyKit files
policy_files = []
for f in src_fileglob(src, '*.policy.in'):
src_mark(src, f)
policy_files.append(f)
if policy_files:
# check if we have PolicyKit 1 API
if subprocess.call(['grep', '-q', 'org\.freedesktop\.PolicyKit1'] +
list(src_fileglob(src_all, '*.py')),
stderr=subprocess.PIPE) == 0:
destdir = os.path.join('share', 'polkit-1', 'actions')
else:
destdir = os.path.join('share', 'PolicyKit', 'policy')
try:
xf = eval(self.xml_files)
except TypeError:
xf = []
xf.append((destdir, policy_files))
self.xml_files = repr(xf)
# add desktop files
desktop_files = []
autostart_files = []
notify_files = []
for f in src_fileglob(src, '*.desktop.in'):
src_mark(src, f)
if 'autostart' in f:
autostart_files.append(f)
else:
desktop_files.append(f)
for f in src_fileglob(src, '*.notifyrc.in'):
src_mark(src, f)
notify_files.append(f)
try:
df = eval(self.desktop_files)
except TypeError:
df = []
if desktop_files:
df.append(('share/applications', desktop_files))
if autostart_files:
df.append(('share/autostart', autostart_files))
if notify_files:
df.append(('share/kde4/apps/' + self.distribution.get_name(), notify_files))
self.desktop_files = repr(df)
# mark PO template as known to handle
try:
src_mark(src, os.path.join(self.po_dir, self.distribution.get_name() + '.pot'))
except KeyError:
pass
def run(self):
'''Build a default POTFILES.in'''
auto_potfiles_in = False
exe_symlinks = []
global src_all
try:
if not os.path.exists(os.path.join('po', 'POTFILES.in')):
files = src_fileglob(src_all, '*.py')
files.update(src_fileglob(src_all, '*.desktop.in'))
files.update(src_fileglob(src_all, '*.notifyrc.in'))
files.update(src_fileglob(src_all, '*.policy.in'))
for f in src_fileglob(src_all, '*.ui'):
contents = open(f).read()
if ('