From 7fb666fc63814d2079647ac34b430f2972cb5535 Mon Sep 17 00:00:00 2001 From: Kwpolska Date: Tue, 20 Sep 2011 17:00:43 +0200 Subject: [PATCH] After 21 days, version 2.1.0 has been released! -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 After 21 days, version 2.1.0 has been released! * a lot of updates, bugfixes * -Syu (system upgrade) * usable as a module * own AUR class, no need to use python3-aur * new fields in --info * pblog() is now more useful, can be used for real logging * now an AUR and PyPI package[1]_ * nicely documented with Sphinx * over 650 lines I hope it would be useful. The docs are uploaded[1]_ to PyPI. If you will find some bugs, go here: Have fun! .. [1] Everything will be uploaded right after this commit. The AUR package upload can take a while. Please be patient. -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.11 (GNU/Linux) iQEcBAEBAgAGBQJOdjowAAoJEHECPb1equoWUagH/As1BmJO1XGN31A+oqw9f6Sa YXBY/LhK3on29UqLIJcNqrTjbKHPe+gkF+f8KFxYV3SUpxF/yv+O3miTrvYRfh78 KTw13XiiSXAnyesBdJY9l5dpMyGE67oWNLyFdYRFaqYwt22xKqx+mR86Fh7RX46f uiw7vt9w74WJqYuCfxm/BSNMaM8AbCN31IETA5WcGzI7n3vkPrUWQgCvBna9yCsA YNw5PYVyAhB9blvvW0gsGqclgVNuzDk2b5R4eOrAoF2CiLMYnOb1CVmk7zw1p92n IL+ts40IAho2nbAJ+cMus1QPjYA0a15ve+KNgBlSYnerC3ZWF0UoAp4d7lFgBdk= =oXp1 -----END PGP SIGNATURE----- Signed-off-by: Kwpolska --- .gitignore | 4 +- INSTALL.py | 76 +++ LICENSE | 700 +----------------------- MANIFEST | 45 ++ MANIFEST.in | 6 + PKGBUILD | 20 + README | 1 + README.md | 42 -- README.rst | 61 +++ TODO.rst | 15 + dist/pkgbuilder-2.1.0.tar.gz | Bin 0 -> 94987 bytes docs/Makefile | 130 +++++ docs/README.rst | 61 +++ docs/_build/doctrees/README.doctree | Bin 0 -> 12410 bytes docs/_build/doctrees/environment.pickle | Bin 0 -> 11010 bytes docs/_build/doctrees/errorcodes.doctree | Bin 0 -> 30706 bytes docs/_build/doctrees/index.doctree | Bin 0 -> 4284 bytes docs/_build/doctrees/pkgbuilder.doctree | Bin 0 -> 23160 bytes docs/conf.py | 256 +++++++++ docs/errorcodes.rst | 100 ++++ docs/html/.buildinfo | 4 + docs/html/README.html | 179 ++++++ docs/html/_sources/README.txt | 61 +++ docs/html/_sources/errorcodes.txt | 100 ++++ docs/html/_sources/index.txt | 23 + docs/html/_sources/pkgbuilder.txt | 101 ++++ docs/html/_static/basic.css | 528 ++++++++++++++++++ docs/html/_static/default.css | 256 +++++++++ docs/html/_static/doctools.js | 247 +++++++++ docs/html/_static/file.png | Bin 0 -> 392 bytes docs/html/_static/jquery.js | 154 ++++++ docs/html/_static/minus.png | Bin 0 -> 199 bytes docs/html/_static/plus.png | Bin 0 -> 199 bytes docs/html/_static/pygments.css | 62 +++ docs/html/_static/searchtools.js | 518 ++++++++++++++++++ docs/html/_static/sidebar.js | 148 +++++ docs/html/_static/underscore.js | 16 + docs/html/errorcodes.html | 290 ++++++++++ docs/html/genindex.html | 91 +++ docs/html/index.html | 107 ++++ docs/html/objects.inv | Bin 0 -> 206 bytes docs/html/pkgbuilder.html | 220 ++++++++ docs/html/search.html | 91 +++ docs/html/searchindex.js | 1 + docs/index.rst | 23 + docs/pkgbuilder.8.gz | Bin 0 -> 1517 bytes docs/pkgbuilder.rst | 101 ++++ pkgbuilder.py | 453 ++++++++++----- scripts/pkgbuilder | 4 + setup.py | 31 ++ 50 files changed, 4470 insertions(+), 856 deletions(-) create mode 100755 INSTALL.py create mode 100644 MANIFEST create mode 100644 MANIFEST.in create mode 100644 PKGBUILD create mode 120000 README delete mode 100644 README.md create mode 100644 README.rst create mode 100644 TODO.rst create mode 100644 dist/pkgbuilder-2.1.0.tar.gz create mode 100644 docs/Makefile create mode 100644 docs/README.rst create mode 100644 docs/_build/doctrees/README.doctree create mode 100644 docs/_build/doctrees/environment.pickle create mode 100644 docs/_build/doctrees/errorcodes.doctree create mode 100644 docs/_build/doctrees/index.doctree create mode 100644 docs/_build/doctrees/pkgbuilder.doctree create mode 100644 docs/conf.py create mode 100644 docs/errorcodes.rst create mode 100644 docs/html/.buildinfo create mode 100644 docs/html/README.html create mode 100644 docs/html/_sources/README.txt create mode 100644 docs/html/_sources/errorcodes.txt create mode 100644 docs/html/_sources/index.txt create mode 100644 docs/html/_sources/pkgbuilder.txt create mode 100644 docs/html/_static/basic.css create mode 100644 docs/html/_static/default.css create mode 100644 docs/html/_static/doctools.js create mode 100644 docs/html/_static/file.png create mode 100644 docs/html/_static/jquery.js create mode 100644 docs/html/_static/minus.png create mode 100644 docs/html/_static/plus.png create mode 100644 docs/html/_static/pygments.css create mode 100644 docs/html/_static/searchtools.js create mode 100644 docs/html/_static/sidebar.js create mode 100644 docs/html/_static/underscore.js create mode 100644 docs/html/errorcodes.html create mode 100644 docs/html/genindex.html create mode 100644 docs/html/index.html create mode 100644 docs/html/objects.inv create mode 100644 docs/html/pkgbuilder.html create mode 100644 docs/html/search.html create mode 100644 docs/html/searchindex.js create mode 100644 docs/index.rst create mode 100644 docs/pkgbuilder.8.gz create mode 100644 docs/pkgbuilder.rst create mode 100755 scripts/pkgbuilder create mode 100755 setup.py diff --git a/.gitignore b/.gitignore index f24cd99..fc589ac 100644 --- a/.gitignore +++ b/.gitignore @@ -1,9 +1,11 @@ *.py[co] +__pycache__/ +__pycache__ # Packages *.egg *.egg-info -dist +#dist build eggs parts diff --git a/INSTALL.py b/INSTALL.py new file mode 100755 index 0000000..494d2ca --- /dev/null +++ b/INSTALL.py @@ -0,0 +1,76 @@ +#!/usr/bin/python3 +# pkgbuilder installer +# Copyright Kwpolska 2011. + +# There are no install instructions. If you want to install +# the script, run this script with python. + +"""pkgbuilder AUR installer +experimental and useless""" + +import subprocess +import os +import json +import urllib.request +import tarfile +import random + + +print("""Hello! + +PKGBUILDer is now available as an AUR package. It is the suggested +way of installing PKGBUILDer. This script will download the AUR +package and install it. If you will have problems, please download +and compile the package manually. + +""") + +WHOCARES = input('Hit Enter/Return to continue. ') +print('') + +UID = os.geteuid() +PATH = '/tmp/pkgbuilderinstall-{0}'.format(random.randint(1, 100)) +if os.path.exists(PATH) == False: + os.mkdir(PATH) +os.chdir(PATH) + + +PKGDATA = json.loads(urllib.request.urlopen('http://aur.archlinux.org\ +/rpc.php?type=info&arg=pkgbuilder').read().decode()) +RHANDLE = urllib.request.urlopen('http://aur.archlinux.org'+ +PKGDATA['results']['URLPath']) +open('pkgbuilder.tar.gz', 'wb').write(RHANDLE.read()) +THANDLE = tarfile.open('pkgbuilder.tar.gz', 'r:gz') +THANDLE.extractall() +os.chdir('./pkgbuilder/') + +ASROOT = '' +if os.geteuid() == 0: + ASROOT = ' --asroot' +MPKG = subprocess.call('/usr/bin/makepkg -si'+ASROOT, shell=True) + +if MPKG == 1: + print(""" + +Something went wrong. Please read makepkg's output and try again. +You can also try to debug the work of this script yourself. +All the files this script was working on are placed in + {0} +(the number is random). + +If I am wrong, though, congratulations! +""".format(PATH)) + +print(""" + +Read the above output. If the script had any problems, run it +again. You can also try to debug the work of this script yourself. +All the files this script was working on are placed in + {0} +(the number is random). + +If everything went fine, though, congratulations! You can now use +PKGBUILDer. For standalone usage, type `pkgbuilder` into the prompt +(zsh users: hash -r, other shells may need another command). For +python module usage, type `import pkgbuilder` into the python prompt. +""".format(PATH)) diff --git a/LICENSE b/LICENSE index 94a9ed0..3c216eb 100644 --- a/LICENSE +++ b/LICENSE @@ -1,674 +1,26 @@ - GNU GENERAL PUBLIC LICENSE - Version 3, 29 June 2007 - - Copyright (C) 2007 Free Software Foundation, Inc. - Everyone is permitted to copy and distribute verbatim copies - of this license document, but changing it is not allowed. - - Preamble - - The GNU General Public License is a free, copyleft license for -software and other kinds of works. - - The licenses for most software and other practical works are designed -to take away your freedom to share and change the works. By contrast, -the GNU General Public License is intended to guarantee your freedom to -share and change all versions of a program--to make sure it remains free -software for all its users. We, the Free Software Foundation, use the -GNU General Public License for most of our software; it applies also to -any other work released this way by its authors. You can apply it to -your programs, too. - - When we speak of free software, we are referring to freedom, not -price. Our General Public Licenses are designed to make sure that you -have the freedom to distribute copies of free software (and charge for -them if you wish), that you receive source code or can get it if you -want it, that you can change the software or use pieces of it in new -free programs, and that you know you can do these things. - - To protect your rights, we need to prevent others from denying you -these rights or asking you to surrender the rights. Therefore, you have -certain responsibilities if you distribute copies of the software, or if -you modify it: responsibilities to respect the freedom of others. - - For example, if you distribute copies of such a program, whether -gratis or for a fee, you must pass on to the recipients the same -freedoms that you received. You must make sure that they, too, receive -or can get the source code. And you must show them these terms so they -know their rights. - - Developers that use the GNU GPL protect your rights with two steps: -(1) assert copyright on the software, and (2) offer you this License -giving you legal permission to copy, distribute and/or modify it. - - For the developers' and authors' protection, the GPL clearly explains -that there is no warranty for this free software. For both users' and -authors' sake, the GPL requires that modified versions be marked as -changed, so that their problems will not be attributed erroneously to -authors of previous versions. - - Some devices are designed to deny users access to install or run -modified versions of the software inside them, although the manufacturer -can do so. This is fundamentally incompatible with the aim of -protecting users' freedom to change the software. The systematic -pattern of such abuse occurs in the area of products for individuals to -use, which is precisely where it is most unacceptable. Therefore, we -have designed this version of the GPL to prohibit the practice for those -products. If such problems arise substantially in other domains, we -stand ready to extend this provision to those domains in future versions -of the GPL, as needed to protect the freedom of users. - - Finally, every program is threatened constantly by software patents. -States should not allow patents to restrict development and use of -software on general-purpose computers, but in those that do, we wish to -avoid the special danger that patents applied to a free program could -make it effectively proprietary. To prevent this, the GPL assures that -patents cannot be used to render the program non-free. - - The precise terms and conditions for copying, distribution and -modification follow. - - TERMS AND CONDITIONS - - 0. Definitions. - - "This License" refers to version 3 of the GNU General Public License. - - "Copyright" also means copyright-like laws that apply to other kinds of -works, such as semiconductor masks. - - "The Program" refers to any copyrightable work licensed under this -License. Each licensee is addressed as "you". "Licensees" and -"recipients" may be individuals or organizations. - - To "modify" a work means to copy from or adapt all or part of the work -in a fashion requiring copyright permission, other than the making of an -exact copy. The resulting work is called a "modified version" of the -earlier work or a work "based on" the earlier work. - - A "covered work" means either the unmodified Program or a work based -on the Program. - - To "propagate" a work means to do anything with it that, without -permission, would make you directly or secondarily liable for -infringement under applicable copyright law, except executing it on a -computer or modifying a private copy. Propagation includes copying, -distribution (with or without modification), making available to the -public, and in some countries other activities as well. - - To "convey" a work means any kind of propagation that enables other -parties to make or receive copies. Mere interaction with a user through -a computer network, with no transfer of a copy, is not conveying. - - An interactive user interface displays "Appropriate Legal Notices" -to the extent that it includes a convenient and prominently visible -feature that (1) displays an appropriate copyright notice, and (2) -tells the user that there is no warranty for the work (except to the -extent that warranties are provided), that licensees may convey the -work under this License, and how to view a copy of this License. If -the interface presents a list of user commands or options, such as a -menu, a prominent item in the list meets this criterion. - - 1. Source Code. - - The "source code" for a work means the preferred form of the work -for making modifications to it. "Object code" means any non-source -form of a work. - - A "Standard Interface" means an interface that either is an official -standard defined by a recognized standards body, or, in the case of -interfaces specified for a particular programming language, one that -is widely used among developers working in that language. - - The "System Libraries" of an executable work include anything, other -than the work as a whole, that (a) is included in the normal form of -packaging a Major Component, but which is not part of that Major -Component, and (b) serves only to enable use of the work with that -Major Component, or to implement a Standard Interface for which an -implementation is available to the public in source code form. A -"Major Component", in this context, means a major essential component -(kernel, window system, and so on) of the specific operating system -(if any) on which the executable work runs, or a compiler used to -produce the work, or an object code interpreter used to run it. - - The "Corresponding Source" for a work in object code form means all -the source code needed to generate, install, and (for an executable -work) run the object code and to modify the work, including scripts to -control those activities. However, it does not include the work's -System Libraries, or general-purpose tools or generally available free -programs which are used unmodified in performing those activities but -which are not part of the work. For example, Corresponding Source -includes interface definition files associated with source files for -the work, and the source code for shared libraries and dynamically -linked subprograms that the work is specifically designed to require, -such as by intimate data communication or control flow between those -subprograms and other parts of the work. - - The Corresponding Source need not include anything that users -can regenerate automatically from other parts of the Corresponding -Source. - - The Corresponding Source for a work in source code form is that -same work. - - 2. Basic Permissions. - - All rights granted under this License are granted for the term of -copyright on the Program, and are irrevocable provided the stated -conditions are met. This License explicitly affirms your unlimited -permission to run the unmodified Program. The output from running a -covered work is covered by this License only if the output, given its -content, constitutes a covered work. This License acknowledges your -rights of fair use or other equivalent, as provided by copyright law. - - You may make, run and propagate covered works that you do not -convey, without conditions so long as your license otherwise remains -in force. You may convey covered works to others for the sole purpose -of having them make modifications exclusively for you, or provide you -with facilities for running those works, provided that you comply with -the terms of this License in conveying all material for which you do -not control copyright. Those thus making or running the covered works -for you must do so exclusively on your behalf, under your direction -and control, on terms that prohibit them from making any copies of -your copyrighted material outside their relationship with you. - - Conveying under any other circumstances is permitted solely under -the conditions stated below. Sublicensing is not allowed; section 10 -makes it unnecessary. - - 3. Protecting Users' Legal Rights From Anti-Circumvention Law. - - No covered work shall be deemed part of an effective technological -measure under any applicable law fulfilling obligations under article -11 of the WIPO copyright treaty adopted on 20 December 1996, or -similar laws prohibiting or restricting circumvention of such -measures. - - When you convey a covered work, you waive any legal power to forbid -circumvention of technological measures to the extent such circumvention -is effected by exercising rights under this License with respect to -the covered work, and you disclaim any intention to limit operation or -modification of the work as a means of enforcing, against the work's -users, your or third parties' legal rights to forbid circumvention of -technological measures. - - 4. Conveying Verbatim Copies. - - You may convey verbatim copies of the Program's source code as you -receive it, in any medium, provided that you conspicuously and -appropriately publish on each copy an appropriate copyright notice; -keep intact all notices stating that this License and any -non-permissive terms added in accord with section 7 apply to the code; -keep intact all notices of the absence of any warranty; and give all -recipients a copy of this License along with the Program. - - You may charge any price or no price for each copy that you convey, -and you may offer support or warranty protection for a fee. - - 5. Conveying Modified Source Versions. - - You may convey a work based on the Program, or the modifications to -produce it from the Program, in the form of source code under the -terms of section 4, provided that you also meet all of these conditions: - - a) The work must carry prominent notices stating that you modified - it, and giving a relevant date. - - b) The work must carry prominent notices stating that it is - released under this License and any conditions added under section - 7. This requirement modifies the requirement in section 4 to - "keep intact all notices". - - c) You must license the entire work, as a whole, under this - License to anyone who comes into possession of a copy. This - License will therefore apply, along with any applicable section 7 - additional terms, to the whole of the work, and all its parts, - regardless of how they are packaged. This License gives no - permission to license the work in any other way, but it does not - invalidate such permission if you have separately received it. - - d) If the work has interactive user interfaces, each must display - Appropriate Legal Notices; however, if the Program has interactive - interfaces that do not display Appropriate Legal Notices, your - work need not make them do so. - - A compilation of a covered work with other separate and independent -works, which are not by their nature extensions of the covered work, -and which are not combined with it such as to form a larger program, -in or on a volume of a storage or distribution medium, is called an -"aggregate" if the compilation and its resulting copyright are not -used to limit the access or legal rights of the compilation's users -beyond what the individual works permit. Inclusion of a covered work -in an aggregate does not cause this License to apply to the other -parts of the aggregate. - - 6. Conveying Non-Source Forms. - - You may convey a covered work in object code form under the terms -of sections 4 and 5, provided that you also convey the -machine-readable Corresponding Source under the terms of this License, -in one of these ways: - - a) Convey the object code in, or embodied in, a physical product - (including a physical distribution medium), accompanied by the - Corresponding Source fixed on a durable physical medium - customarily used for software interchange. - - b) Convey the object code in, or embodied in, a physical product - (including a physical distribution medium), accompanied by a - written offer, valid for at least three years and valid for as - long as you offer spare parts or customer support for that product - model, to give anyone who possesses the object code either (1) a - copy of the Corresponding Source for all the software in the - product that is covered by this License, on a durable physical - medium customarily used for software interchange, for a price no - more than your reasonable cost of physically performing this - conveying of source, or (2) access to copy the - Corresponding Source from a network server at no charge. - - c) Convey individual copies of the object code with a copy of the - written offer to provide the Corresponding Source. This - alternative is allowed only occasionally and noncommercially, and - only if you received the object code with such an offer, in accord - with subsection 6b. - - d) Convey the object code by offering access from a designated - place (gratis or for a charge), and offer equivalent access to the - Corresponding Source in the same way through the same place at no - further charge. You need not require recipients to copy the - Corresponding Source along with the object code. If the place to - copy the object code is a network server, the Corresponding Source - may be on a different server (operated by you or a third party) - that supports equivalent copying facilities, provided you maintain - clear directions next to the object code saying where to find the - Corresponding Source. Regardless of what server hosts the - Corresponding Source, you remain obligated to ensure that it is - available for as long as needed to satisfy these requirements. - - e) Convey the object code using peer-to-peer transmission, provided - you inform other peers where the object code and Corresponding - Source of the work are being offered to the general public at no - charge under subsection 6d. - - A separable portion of the object code, whose source code is excluded -from the Corresponding Source as a System Library, need not be -included in conveying the object code work. - - A "User Product" is either (1) a "consumer product", which means any -tangible personal property which is normally used for personal, family, -or household purposes, or (2) anything designed or sold for incorporation -into a dwelling. In determining whether a product is a consumer product, -doubtful cases shall be resolved in favor of coverage. For a particular -product received by a particular user, "normally used" refers to a -typical or common use of that class of product, regardless of the status -of the particular user or of the way in which the particular user -actually uses, or expects or is expected to use, the product. A product -is a consumer product regardless of whether the product has substantial -commercial, industrial or non-consumer uses, unless such uses represent -the only significant mode of use of the product. - - "Installation Information" for a User Product means any methods, -procedures, authorization keys, or other information required to install -and execute modified versions of a covered work in that User Product from -a modified version of its Corresponding Source. The information must -suffice to ensure that the continued functioning of the modified object -code is in no case prevented or interfered with solely because -modification has been made. - - If you convey an object code work under this section in, or with, or -specifically for use in, a User Product, and the conveying occurs as -part of a transaction in which the right of possession and use of the -User Product is transferred to the recipient in perpetuity or for a -fixed term (regardless of how the transaction is characterized), the -Corresponding Source conveyed under this section must be accompanied -by the Installation Information. But this requirement does not apply -if neither you nor any third party retains the ability to install -modified object code on the User Product (for example, the work has -been installed in ROM). - - The requirement to provide Installation Information does not include a -requirement to continue to provide support service, warranty, or updates -for a work that has been modified or installed by the recipient, or for -the User Product in which it has been modified or installed. Access to a -network may be denied when the modification itself materially and -adversely affects the operation of the network or violates the rules and -protocols for communication across the network. - - Corresponding Source conveyed, and Installation Information provided, -in accord with this section must be in a format that is publicly -documented (and with an implementation available to the public in -source code form), and must require no special password or key for -unpacking, reading or copying. - - 7. Additional Terms. - - "Additional permissions" are terms that supplement the terms of this -License by making exceptions from one or more of its conditions. -Additional permissions that are applicable to the entire Program shall -be treated as though they were included in this License, to the extent -that they are valid under applicable law. If additional permissions -apply only to part of the Program, that part may be used separately -under those permissions, but the entire Program remains governed by -this License without regard to the additional permissions. - - When you convey a copy of a covered work, you may at your option -remove any additional permissions from that copy, or from any part of -it. (Additional permissions may be written to require their own -removal in certain cases when you modify the work.) You may place -additional permissions on material, added by you to a covered work, -for which you have or can give appropriate copyright permission. - - Notwithstanding any other provision of this License, for material you -add to a covered work, you may (if authorized by the copyright holders of -that material) supplement the terms of this License with terms: - - a) Disclaiming warranty or limiting liability differently from the - terms of sections 15 and 16 of this License; or - - b) Requiring preservation of specified reasonable legal notices or - author attributions in that material or in the Appropriate Legal - Notices displayed by works containing it; or - - c) Prohibiting misrepresentation of the origin of that material, or - requiring that modified versions of such material be marked in - reasonable ways as different from the original version; or - - d) Limiting the use for publicity purposes of names of licensors or - authors of the material; or - - e) Declining to grant rights under trademark law for use of some - trade names, trademarks, or service marks; or - - f) Requiring indemnification of licensors and authors of that - material by anyone who conveys the material (or modified versions of - it) with contractual assumptions of liability to the recipient, for - any liability that these contractual assumptions directly impose on - those licensors and authors. - - All other non-permissive additional terms are considered "further -restrictions" within the meaning of section 10. If the Program as you -received it, or any part of it, contains a notice stating that it is -governed by this License along with a term that is a further -restriction, you may remove that term. If a license document contains -a further restriction but permits relicensing or conveying under this -License, you may add to a covered work material governed by the terms -of that license document, provided that the further restriction does -not survive such relicensing or conveying. - - If you add terms to a covered work in accord with this section, you -must place, in the relevant source files, a statement of the -additional terms that apply to those files, or a notice indicating -where to find the applicable terms. - - Additional terms, permissive or non-permissive, may be stated in the -form of a separately written license, or stated as exceptions; -the above requirements apply either way. - - 8. Termination. - - You may not propagate or modify a covered work except as expressly -provided under this License. Any attempt otherwise to propagate or -modify it is void, and will automatically terminate your rights under -this License (including any patent licenses granted under the third -paragraph of section 11). - - However, if you cease all violation of this License, then your -license from a particular copyright holder is reinstated (a) -provisionally, unless and until the copyright holder explicitly and -finally terminates your license, and (b) permanently, if the copyright -holder fails to notify you of the violation by some reasonable means -prior to 60 days after the cessation. - - Moreover, your license from a particular copyright holder is -reinstated permanently if the copyright holder notifies you of the -violation by some reasonable means, this is the first time you have -received notice of violation of this License (for any work) from that -copyright holder, and you cure the violation prior to 30 days after -your receipt of the notice. - - Termination of your rights under this section does not terminate the -licenses of parties who have received copies or rights from you under -this License. If your rights have been terminated and not permanently -reinstated, you do not qualify to receive new licenses for the same -material under section 10. - - 9. Acceptance Not Required for Having Copies. - - You are not required to accept this License in order to receive or -run a copy of the Program. Ancillary propagation of a covered work -occurring solely as a consequence of using peer-to-peer transmission -to receive a copy likewise does not require acceptance. However, -nothing other than this License grants you permission to propagate or -modify any covered work. These actions infringe copyright if you do -not accept this License. Therefore, by modifying or propagating a -covered work, you indicate your acceptance of this License to do so. - - 10. Automatic Licensing of Downstream Recipients. - - Each time you convey a covered work, the recipient automatically -receives a license from the original licensors, to run, modify and -propagate that work, subject to this License. You are not responsible -for enforcing compliance by third parties with this License. - - An "entity transaction" is a transaction transferring control of an -organization, or substantially all assets of one, or subdividing an -organization, or merging organizations. If propagation of a covered -work results from an entity transaction, each party to that -transaction who receives a copy of the work also receives whatever -licenses to the work the party's predecessor in interest had or could -give under the previous paragraph, plus a right to possession of the -Corresponding Source of the work from the predecessor in interest, if -the predecessor has it or can get it with reasonable efforts. - - You may not impose any further restrictions on the exercise of the -rights granted or affirmed under this License. For example, you may -not impose a license fee, royalty, or other charge for exercise of -rights granted under this License, and you may not initiate litigation -(including a cross-claim or counterclaim in a lawsuit) alleging that -any patent claim is infringed by making, using, selling, offering for -sale, or importing the Program or any portion of it. - - 11. Patents. - - A "contributor" is a copyright holder who authorizes use under this -License of the Program or a work on which the Program is based. The -work thus licensed is called the contributor's "contributor version". - - A contributor's "essential patent claims" are all patent claims -owned or controlled by the contributor, whether already acquired or -hereafter acquired, that would be infringed by some manner, permitted -by this License, of making, using, or selling its contributor version, -but do not include claims that would be infringed only as a -consequence of further modification of the contributor version. For -purposes of this definition, "control" includes the right to grant -patent sublicenses in a manner consistent with the requirements of -this License. - - Each contributor grants you a non-exclusive, worldwide, royalty-free -patent license under the contributor's essential patent claims, to -make, use, sell, offer for sale, import and otherwise run, modify and -propagate the contents of its contributor version. - - In the following three paragraphs, a "patent license" is any express -agreement or commitment, however denominated, not to enforce a patent -(such as an express permission to practice a patent or covenant not to -sue for patent infringement). To "grant" such a patent license to a -party means to make such an agreement or commitment not to enforce a -patent against the party. - - If you convey a covered work, knowingly relying on a patent license, -and the Corresponding Source of the work is not available for anyone -to copy, free of charge and under the terms of this License, through a -publicly available network server or other readily accessible means, -then you must either (1) cause the Corresponding Source to be so -available, or (2) arrange to deprive yourself of the benefit of the -patent license for this particular work, or (3) arrange, in a manner -consistent with the requirements of this License, to extend the patent -license to downstream recipients. "Knowingly relying" means you have -actual knowledge that, but for the patent license, your conveying the -covered work in a country, or your recipient's use of the covered work -in a country, would infringe one or more identifiable patents in that -country that you have reason to believe are valid. - - If, pursuant to or in connection with a single transaction or -arrangement, you convey, or propagate by procuring conveyance of, a -covered work, and grant a patent license to some of the parties -receiving the covered work authorizing them to use, propagate, modify -or convey a specific copy of the covered work, then the patent license -you grant is automatically extended to all recipients of the covered -work and works based on it. - - A patent license is "discriminatory" if it does not include within -the scope of its coverage, prohibits the exercise of, or is -conditioned on the non-exercise of one or more of the rights that are -specifically granted under this License. You may not convey a covered -work if you are a party to an arrangement with a third party that is -in the business of distributing software, under which you make payment -to the third party based on the extent of your activity of conveying -the work, and under which the third party grants, to any of the -parties who would receive the covered work from you, a discriminatory -patent license (a) in connection with copies of the covered work -conveyed by you (or copies made from those copies), or (b) primarily -for and in connection with specific products or compilations that -contain the covered work, unless you entered into that arrangement, -or that patent license was granted, prior to 28 March 2007. - - Nothing in this License shall be construed as excluding or limiting -any implied license or other defenses to infringement that may -otherwise be available to you under applicable patent law. - - 12. No Surrender of Others' Freedom. - - If conditions are imposed on you (whether by court order, agreement or -otherwise) that contradict the conditions of this License, they do not -excuse you from the conditions of this License. If you cannot convey a -covered work so as to satisfy simultaneously your obligations under this -License and any other pertinent obligations, then as a consequence you may -not convey it at all. For example, if you agree to terms that obligate you -to collect a royalty for further conveying from those to whom you convey -the Program, the only way you could satisfy both those terms and this -License would be to refrain entirely from conveying the Program. - - 13. Use with the GNU Affero General Public License. - - Notwithstanding any other provision of this License, you have -permission to link or combine any covered work with a work licensed -under version 3 of the GNU Affero General Public License into a single -combined work, and to convey the resulting work. The terms of this -License will continue to apply to the part which is the covered work, -but the special requirements of the GNU Affero General Public License, -section 13, concerning interaction through a network will apply to the -combination as such. - - 14. Revised Versions of this License. - - The Free Software Foundation may publish revised and/or new versions of -the GNU General Public License from time to time. Such new versions will -be similar in spirit to the present version, but may differ in detail to -address new problems or concerns. - - Each version is given a distinguishing version number. If the -Program specifies that a certain numbered version of the GNU General -Public License "or any later version" applies to it, you have the -option of following the terms and conditions either of that numbered -version or of any later version published by the Free Software -Foundation. If the Program does not specify a version number of the -GNU General Public License, you may choose any version ever published -by the Free Software Foundation. - - If the Program specifies that a proxy can decide which future -versions of the GNU General Public License can be used, that proxy's -public statement of acceptance of a version permanently authorizes you -to choose that version for the Program. - - Later license versions may give you additional or different -permissions. However, no additional obligations are imposed on any -author or copyright holder as a result of your choosing to follow a -later version. - - 15. Disclaimer of Warranty. - - THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY -APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT -HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY -OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, -THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR -PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM -IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF -ALL NECESSARY SERVICING, REPAIR OR CORRECTION. - - 16. Limitation of Liability. - - IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING -WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS -THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY -GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE -USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF -DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD -PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), -EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF -SUCH DAMAGES. - - 17. Interpretation of Sections 15 and 16. - - If the disclaimer of warranty and limitation of liability provided -above cannot be given local legal effect according to their terms, -reviewing courts shall apply local law that most closely approximates -an absolute waiver of all civil liability in connection with the -Program, unless a warranty or assumption of liability accompanies a -copy of the Program in return for a fee. - - END OF TERMS AND CONDITIONS - - How to Apply These Terms to Your New Programs - - If you develop a new program, and you want it to be of the greatest -possible use to the public, the best way to achieve this is to make it -free software which everyone can redistribute and change under these terms. - - To do so, attach the following notices to the program. It is safest -to attach them to the start of each source file to most effectively -state the exclusion of warranty; and each file should have at least -the "copyright" line and a pointer to where the full notice is found. - - - Copyright (C) - - 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, either version 3 of the License, or - (at your option) any later version. - - 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, see . - -Also add information on how to contact you by electronic and paper mail. - - If the program does terminal interaction, make it output a short -notice like this when it starts in an interactive mode: - - Copyright (C) - This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. - This is free software, and you are welcome to redistribute it - under certain conditions; type `show c' for details. - -The hypothetical commands `show w' and `show c' should show the appropriate -parts of the General Public License. Of course, your program's commands -might be different; for a GUI interface, you would use an "about box". - - You should also get your employer (if you work as a programmer) or school, -if any, to sign a "copyright disclaimer" for the program, if necessary. -For more information on this, and how to apply and follow the GNU GPL, see -. - - The GNU General Public License does not permit incorporating your program -into proprietary programs. If your program is a subroutine library, you -may consider it more useful to permit linking proprietary applications with -the library. If this is what you want to do, use the GNU Lesser General -Public License instead of this License. But first, please read -. +Copyright (C) 2011, Kwpolska +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: + + * Redistributions of source code must retain the above copyright notice, + this list of conditions, and the following disclaimer. + * Redistributions in binary form must reproduce the above copyright notice, + this list of conditions, and the following disclaimer in the + documentation and/or other materials provided with the distribution. + * Neither the name of the author of this software nor the name of + contributors to this software may be used to endorse or promote products + derived from this software without specific prior written consent. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE +LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +POSSIBILITY OF SUCH DAMAGE. diff --git a/MANIFEST b/MANIFEST new file mode 100644 index 0000000..d1a20f2 --- /dev/null +++ b/MANIFEST @@ -0,0 +1,45 @@ +# file GENERATED by distutils, do NOT edit +INSTALL.py +LICENSE +README +README.rst +TODO.rst +pkgbuilder.py +setup.py +docs/Makefile +docs/README.rst +docs/conf.py +docs/errorcodes.rst +docs/index.rst +docs/pkgbuilder.8.gz +docs/pkgbuilder.rst +docs/_build/doctrees/README.doctree +docs/_build/doctrees/environment.pickle +docs/_build/doctrees/errorcodes.doctree +docs/_build/doctrees/index.doctree +docs/_build/doctrees/pkgbuilder.doctree +docs/html/.buildinfo +docs/html/README.html +docs/html/errorcodes.html +docs/html/genindex.html +docs/html/index.html +docs/html/objects.inv +docs/html/pkgbuilder.html +docs/html/search.html +docs/html/searchindex.js +docs/html/_sources/README.txt +docs/html/_sources/errorcodes.txt +docs/html/_sources/index.txt +docs/html/_sources/pkgbuilder.txt +docs/html/_static/basic.css +docs/html/_static/default.css +docs/html/_static/doctools.js +docs/html/_static/file.png +docs/html/_static/jquery.js +docs/html/_static/minus.png +docs/html/_static/plus.png +docs/html/_static/pygments.css +docs/html/_static/searchtools.js +docs/html/_static/sidebar.js +docs/html/_static/underscore.js +scripts/pkgbuilder diff --git a/MANIFEST.in b/MANIFEST.in new file mode 100644 index 0000000..d6cde0d --- /dev/null +++ b/MANIFEST.in @@ -0,0 +1,6 @@ +include INSTALL.py +include LICENSE +include README.rst +include TODO.rst +recursive-include docs * +recursive-include scripts * diff --git a/PKGBUILD b/PKGBUILD new file mode 100644 index 0000000..8a6abd3 --- /dev/null +++ b/PKGBUILD @@ -0,0 +1,20 @@ +# Maintainer: Kwpolska +pkgname=pkgbuilder +pkgver=2.1.0 +pkgrel=1 +pkgdesc="A basic Python AUR helper/library." +arch=('any') +url="https://github.com/Kwpolska/pkgbuilder" +license=('BSD') +depends=('python' 'pyalpm' 'python-pyparsing') +options=(!emptydirs) +source=('http://pypi.python.org/packages/source/p/pkgbuilder/pkgbuilder-2.1.0.tar.gz') +md5sums=('d6f495345dde0cb3774dc9f3f3eafaaa') + +package() { + cd "${srcdir}/${pkgname}-${pkgver}" + python setup.py install --root="${pkgdir}/" --optimize=1 + install -D -m644 LICENSE "${pkgdir}/usr/share/licenses/${pkgname}/LICENSE" +} + +# vim:set ts=2 sw=2 et: diff --git a/README b/README new file mode 120000 index 0000000..92cacd2 --- /dev/null +++ b/README @@ -0,0 +1 @@ +README.rst \ No newline at end of file diff --git a/README.md b/README.md deleted file mode 100644 index 24c8ed1..0000000 --- a/README.md +++ /dev/null @@ -1,42 +0,0 @@ -PKGBUILDer. Easy AUR helper-like script. -============== - -PURPOSE -------- -This tool is a basic AUR helper written in Py3K. - -INSTALLATION ------------- -Copy pkgbuilder.py to /usr/bin or ~/bin. You need to install -pyalpm from [extra] and python3-aur from the AUR. - -NOTES ------ -This is Version 2 of PKGBUILDer. The original Perl version is included, -but it shall not be used. - -Version 2 works in two ways: - - * regular: search outputs category/package, building in current - working directory; - * pacman wrapper-friendly: search outputs 'aur' instead of categories, - building in /tmp/pkgbuilder-UID - -Notice: this script is not finished yet. Please be careful. - -COPYRIGHT ---------- -Copyright (C) 2011 Kwpolska. - -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, either version 3 of the License, or -(at your option) any later version. - -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, see . diff --git a/README.rst b/README.rst new file mode 100644 index 0000000..4ea48f2 --- /dev/null +++ b/README.rst @@ -0,0 +1,61 @@ +===================== +README for PKGBUILDer +===================== +:Info: This is the README file for PKGBUILDer. +:Author: Kwpolska +:Date: 2011-09-20 +:Version: 2.1.0 + +PKGBUILDer. A Python AUR helper/library. +========================================= + +PURPOSE +------- +Building and installing AUR packages. + +INSTALLATION +------------ +Copy pkgbuilder.py to /usr/bin or ~/bin. You need to install +pyalpm from [extra] and python3-aur from the AUR. + +NOTES +----- +This is Version 2 of PKGBUILDer. The original Perl version is included, +but it shall not be used. + +Version 2.1 is a big leap forward. It introduces many new features. +It is now stable. It is now available as an AUR and PyPI package. + +The -S (DS.pacman) parameter adds pacman wrapper compatibility. + +For more info, refer to the pkgbuilder(8) man page or HTML docs in +docs/html. + +COPYRIGHT +--------- +Copyright (C) 2011, Kwpolska +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: + + * Redistributions of source code must retain the above copyright notice, + this list of conditions, and the following disclaimer. + * Redistributions in binary form must reproduce the above copyright notice, + this list of conditions, and the following disclaimer in the + documentation and/or other materials provided with the distribution. + * Neither the name of the author of this software nor the name of + contributors to this software may be used to endorse or promote products + derived from this software without specific prior written consent. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE +LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +POSSIBILITY OF SUCH DAMAGE. diff --git a/TODO.rst b/TODO.rst new file mode 100644 index 0000000..92a6549 --- /dev/null +++ b/TODO.rst @@ -0,0 +1,15 @@ +=================== +TODO for PKGBUILDer +=================== +:Info: This is a TODO list for PKGBUILDer. +:Author: Kwpolska +:Date: 2011-09-20 +:Version: 2.1.0 + +I have a few cool (and impossible) ideas for PKGBUILDer. This file +would list them. If you know Python, you can write them and send +me a patch. + + * pacmanization: + extra/gnutls 3.0.3-1 [1.33 MB] [installed: 3.0.2-1] + diff --git a/dist/pkgbuilder-2.1.0.tar.gz b/dist/pkgbuilder-2.1.0.tar.gz new file mode 100644 index 0000000000000000000000000000000000000000..e1c341128a52a719ff78423168f7d87bd94976d4 GIT binary patch literal 94987 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

kEC#tzg3fW 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 I@&pI^4^CGQNB{r; literal 0 HcmV?d00001 diff --git a/docs/Makefile b/docs/Makefile new file mode 100644 index 0000000..7d56a82 --- /dev/null +++ b/docs/Makefile @@ -0,0 +1,130 @@ +# Makefile for Sphinx documentation +# + +# You can set these variables from the command line. +SPHINXOPTS = +SPHINXBUILD = sphinx-build +PAPER = +BUILDDIR = _build + +# Internal variables. +PAPEROPT_a4 = -D latex_paper_size=a4 +PAPEROPT_letter = -D latex_paper_size=letter +ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) . + +.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest + +help: + @echo "Please use \`make ' where is one of" + @echo " html to make standalone HTML files" + @echo " dirhtml to make HTML files named index.html in directories" + @echo " singlehtml to make a single large HTML file" + @echo " pickle to make pickle files" + @echo " json to make JSON files" + @echo " htmlhelp to make HTML files and a HTML help project" + @echo " qthelp to make HTML files and a qthelp project" + @echo " devhelp to make HTML files and a Devhelp project" + @echo " epub to make an epub" + @echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter" + @echo " latexpdf to make LaTeX files and run them through pdflatex" + @echo " text to make text files" + @echo " man to make manual pages" + @echo " changes to make an overview of all changed/added/deprecated items" + @echo " linkcheck to check all external links for integrity" + @echo " doctest to run all doctests embedded in the documentation (if enabled)" + +clean: + -rm -rf $(BUILDDIR)/* + +html: + $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) ./html + @echo + @echo "Build finished. The HTML pages are in ./html." + +dirhtml: + $(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml + @echo + @echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml." + +singlehtml: + $(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml + @echo + @echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml." + +pickle: + $(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle + @echo + @echo "Build finished; now you can process the pickle files." + +json: + $(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json + @echo + @echo "Build finished; now you can process the JSON files." + +htmlhelp: + $(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp + @echo + @echo "Build finished; now you can run HTML Help Workshop with the" \ + ".hhp project file in $(BUILDDIR)/htmlhelp." + +qthelp: + $(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp + @echo + @echo "Build finished; now you can run "qcollectiongenerator" with the" \ + ".qhcp project file in $(BUILDDIR)/qthelp, like this:" + @echo "# qcollectiongenerator $(BUILDDIR)/qthelp/PKGBUILDer.qhcp" + @echo "To view the help file:" + @echo "# assistant -collectionFile $(BUILDDIR)/qthelp/PKGBUILDer.qhc" + +devhelp: + $(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp + @echo + @echo "Build finished." + @echo "To view the help file:" + @echo "# mkdir -p $$HOME/.local/share/devhelp/PKGBUILDer" + @echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/PKGBUILDer" + @echo "# devhelp" + +epub: + $(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub + @echo + @echo "Build finished. The epub file is in $(BUILDDIR)/epub." + +latex: + $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex + @echo + @echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex." + @echo "Run \`make' in that directory to run these through (pdf)latex" \ + "(use \`make latexpdf' here to do that automatically)." + +latexpdf: + $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex + @echo "Running LaTeX files through pdflatex..." + make -C $(BUILDDIR)/latex all-pdf + @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex." + +text: + $(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text + @echo + @echo "Build finished. The text files are in $(BUILDDIR)/text." + +man: + $(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man + @echo + @echo "Build finished. The manual pages are in $(BUILDDIR)/man." + +changes: + $(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes + @echo + @echo "The overview file is in $(BUILDDIR)/changes." + +linkcheck: + $(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck + @echo + @echo "Link check complete; look for any errors in the above output " \ + "or in $(BUILDDIR)/linkcheck/output.txt." + +doctest: + $(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest + @echo "Testing of doctests in the sources finished, look at the " \ + "results in $(BUILDDIR)/doctest/output.txt." diff --git a/docs/README.rst b/docs/README.rst new file mode 100644 index 0000000..4ea48f2 --- /dev/null +++ b/docs/README.rst @@ -0,0 +1,61 @@ +===================== +README for PKGBUILDer +===================== +:Info: This is the README file for PKGBUILDer. +:Author: Kwpolska +:Date: 2011-09-20 +:Version: 2.1.0 + +PKGBUILDer. A Python AUR helper/library. +========================================= + +PURPOSE +------- +Building and installing AUR packages. + +INSTALLATION +------------ +Copy pkgbuilder.py to /usr/bin or ~/bin. You need to install +pyalpm from [extra] and python3-aur from the AUR. + +NOTES +----- +This is Version 2 of PKGBUILDer. The original Perl version is included, +but it shall not be used. + +Version 2.1 is a big leap forward. It introduces many new features. +It is now stable. It is now available as an AUR and PyPI package. + +The -S (DS.pacman) parameter adds pacman wrapper compatibility. + +For more info, refer to the pkgbuilder(8) man page or HTML docs in +docs/html. + +COPYRIGHT +--------- +Copyright (C) 2011, Kwpolska +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: + + * Redistributions of source code must retain the above copyright notice, + this list of conditions, and the following disclaimer. + * Redistributions in binary form must reproduce the above copyright notice, + this list of conditions, and the following disclaimer in the + documentation and/or other materials provided with the distribution. + * Neither the name of the author of this software nor the name of + contributors to this software may be used to endorse or promote products + derived from this software without specific prior written consent. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE +LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +POSSIBILITY OF SUCH DAMAGE. diff --git a/docs/_build/doctrees/README.doctree b/docs/_build/doctrees/README.doctree new file mode 100644 index 0000000000000000000000000000000000000000..15757adcf8630e1475779db4a3fbb1fb2c2bbad5 GIT binary patch literal 12410 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 literal 0 HcmV?d00001 diff --git a/docs/_build/doctrees/errorcodes.doctree b/docs/_build/doctrees/errorcodes.doctree new file mode 100644 index 0000000000000000000000000000000000000000..69cca43b5e5fa8a47541c0aeb74419fc5aec8e1f GIT binary patch literal 30706 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 literal 0 HcmV?d00001 diff --git a/docs/_build/doctrees/index.doctree b/docs/_build/doctrees/index.doctree new file mode 100644 index 0000000000000000000000000000000000000000..762778ef0746cfd4259bec3e76d5bb1f5d906d7e GIT binary patch literal 4284 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 PyYx5Q1oSknm}~wIJLSt^ literal 0 HcmV?d00001 diff --git a/docs/conf.py b/docs/conf.py new file mode 100644 index 0000000..3865dab --- /dev/null +++ b/docs/conf.py @@ -0,0 +1,256 @@ +# -*- coding: utf-8 -*- +# +# PKGBUILDer documentation build configuration file, created by +# sphinx-quickstart on Sun Sep 18 14:35:50 2011. +# +# This file is execfile()d with the current directory set to its containing dir. +# +# Note that not all possible configuration values are present in this +# autogenerated file. +# +# All configuration values have a default; values that are commented out +# serve to show the default. + +import sys, os + +# If extensions (or modules to document with autodoc) are in another directory, +# add these directories to sys.path here. If the directory is relative to the +# documentation root, use os.path.abspath to make it absolute, like shown here. +#sys.path.insert(0, os.path.abspath('.')) + +# -- General configuration ----------------------------------------------------- + +# If your documentation needs a minimal Sphinx version, state it here. +#needs_sphinx = '1.0' + +# Add any Sphinx extension module names here, as strings. They can be extensions +# coming with Sphinx (named 'sphinx.ext.*') or your custom ones. +extensions = ['sphinx.ext.autodoc', 'sphinx.ext.doctest', 'sphinx.ext.todo', 'sphinx.ext.coverage', 'sphinx.ext.ifconfig'] #, 'sphinx.ext.viewcode'] + +# Add any paths that contain templates here, relative to this directory. +templates_path = ['_templates'] + +# The suffix of source filenames. +source_suffix = '.rst' + +# The encoding of source files. +#source_encoding = 'utf-8-sig' + +# The master toctree document. +master_doc = 'index' + +# General information about the project. +project = u'PKGBUILDer' +copyright = u'2011, Kwpolska' + +# The version info for the project you're documenting, acts as replacement for +# |version| and |release|, also used in various other places throughout the +# built documents. +# +# The short X.Y version. +version = '2.1' +# The full version, including alpha/beta/rc tags. +release = '2.1.0' + +# The language for content autogenerated by Sphinx. Refer to documentation +# for a list of supported languages. +#language = None + +# There are two options for replacing |today|: either, you set today to some +# non-false value, then it is used: +#today = '' +# Else, today_fmt is used as the format for a strftime call. +today_fmt = '%Y-%m-%dT%H:%m:%SZ' + +# List of patterns, relative to source directory, that match files and +# directories to ignore when looking for source files. +exclude_patterns = ['_build'] + +# The reST default role (used for this markup: `text`) to use for all documents. +#default_role = None + +# If true, '()' will be appended to :func: etc. cross-reference text. +#add_function_parentheses = True + +# If true, the current module name will be prepended to all description +# unit titles (such as .. function::). +#add_module_names = True + +# If true, sectionauthor and moduleauthor directives will be shown in the +# output. They are ignored by default. +show_authors = True + +# The name of the Pygments (syntax highlighting) style to use. +pygments_style = 'friendly' #'sphinx' + +# A list of ignored prefixes for module index sorting. +#modindex_common_prefix = [] + + +# -- Options for HTML output --------------------------------------------------- + +# The theme to use for HTML and HTML Help pages. See the documentation for +# a list of builtin themes. +html_theme = 'default' + +# Theme options are theme-specific and customize the look and feel of a theme +# further. For a list of options available for each theme, see the +# documentation. +#html_theme_options = {} + +# Add any paths that contain custom themes here, relative to this directory. +#html_theme_path = [] + +# The name for this set of Sphinx documents. If None, it defaults to +# " v documentation". +#html_title = None + +# A shorter title for the navigation bar. Default is the same as html_title. +#html_short_title = None + +# The name of an image file (relative to this directory) to place at the top +# of the sidebar. +#html_logo = None + +# The name of an image file (within the static path) to use as favicon of the +# docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32 +# pixels large. +#html_favicon = None + +# Add any paths that contain custom static files (such as style sheets) here, +# relative to this directory. They are copied after the builtin static files, +# so a file named "default.css" will overwrite the builtin "default.css". +#html_static_path = ['_static'] + +# If not '', a 'Last updated on:' timestamp is inserted at every page bottom, +# using the given strftime format. +html_last_updated_fmt = '%Y-%m-%dT%H:%m:%SZ' + +# If true, SmartyPants will be used to convert quotes and dashes to +# typographically correct entities. +html_use_smartypants = True + +# Custom sidebar templates, maps document names to template names. +#html_sidebars = {} + +# Additional templates that should be rendered to pages, maps page names to +# template names. +#html_additional_pages = {} + +# If false, no module index is generated. +#html_domain_indices = True + +# If false, no index is generated. +html_use_index = False + +# If true, the index is split into individual pages for each letter. +#html_split_index = False + +# If true, links to the reST sources are added to the pages. +html_show_sourcelink = False + +# If true, "Created using Sphinx" is shown in the HTML footer. Default is True. +#html_show_sphinx = True + +# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True. +#html_show_copyright = True + +# If true, an OpenSearch description file will be output, and all pages will +# contain a tag referring to it. The value of this option must be the +# base URL from which the finished HTML is served. +#html_use_opensearch = '' + +# This is the file name suffix for HTML files (e.g. ".xhtml"). +#html_file_suffix = None + +# Output file base name for HTML help builder. +htmlhelp_basename = 'pkgbuilderdoc' + + +# -- Options for LaTeX output -------------------------------------------------- + +# The paper size ('letter' or 'a4'). +#latex_paper_size = 'letter' + +# The font size ('10pt', '11pt' or '12pt'). +#latex_font_size = '10pt' + +# Grouping the document tree into LaTeX files. List of tuples +# (source start file, target name, title, author, documentclass [howto/manual]). +latex_documents = [ + ('index', 'PKGBUILDer.tex', u'PKGBUILDer Documentation', + u'Kwpolska', 'manual'), +] + +# The name of an image file (relative to this directory) to place at the top of +# the title page. +#latex_logo = None + +# For "manual" documents, if this is true, then toplevel headings are parts, +# not chapters. +#latex_use_parts = False + +# If true, show page references after internal links. +#latex_show_pagerefs = False + +# If true, show URL addresses after external links. +#latex_show_urls = False + +# Additional stuff for the LaTeX preamble. +#latex_preamble = '' + +# Documents to append as an appendix to all manuals. +#latex_appendices = [] + +# If false, no module index is generated. +#latex_domain_indices = True + + +# -- Options for manual page output -------------------------------------------- + +# One entry per manual page. List of tuples +# (source start file, name, description, authors, manual section). +man_pages = [ + ('index', 'pkgbuilder', u'PKGBUILDer Documentation', + [u'Kwpolska'], 8) +] + + +# -- Options for Epub output --------------------------------------------------- + +# Bibliographic Dublin Core info. +epub_title = u'PKGBUILDer' +epub_author = u'Kwpolska' +epub_publisher = u'Kwpolska' +epub_copyright = u'2011, Kwpolska' + +# The language of the text. It defaults to the language option +# or en if the language is not set. +#epub_language = '' + +# The scheme of the identifier. Typical schemes are ISBN or URL. +#epub_scheme = '' + +# The unique identifier of the text. This can be a ISBN number +# or the project homepage. +#epub_identifier = '' + +# A unique identification for the text. +#epub_uid = '' + +# HTML files that should be inserted before the pages created by sphinx. +# The format is a list of tuples containing the path and title. +#epub_pre_files = [] + +# HTML files shat should be inserted after the pages created by sphinx. +# The format is a list of tuples containing the path and title. +#epub_post_files = [] + +# A list of files that should not be packed into the epub file. +#epub_exclude_files = [] + +# The depth of the table of contents in toc.ncx. +#epub_tocdepth = 3 + +# Allow duplicate toc entries. +#epub_tocdup = True diff --git a/docs/errorcodes.rst b/docs/errorcodes.rst new file mode 100644 index 0000000..1315b7d --- /dev/null +++ b/docs/errorcodes.rst @@ -0,0 +1,100 @@ +========================================== +Appendix B. PKGBUILDer error messages list +========================================== +:Info: This is an appendix to the PKGBUILDer documentation. +:Author: Kwpolska +:Date: 2011-09-20 +:Version: 2.1.0 + +In order to help debugging, error messages are numbered. +Each error message number has four digits: the first one is the +category and the other three are error identifiers. + +Categories +========== + +1. AUR class +2. Utils class +3. Build class + 1. download, extract + 2. depcheck, predepcheck + 3. makepkg + 4. auto_build, validation +4. Update class +5. non-module errors + +Usage instructions +------------------ + +In order to get the category identifier, you need to: + + * multiply the desired list element by 1000 + * multiply the desired subelement by 100 + * add the results together + +In order to get the first possible number of this (sub)category, add 1 to +the result of the above calculations. + +Errors +====== + + +======== =============== ========================================= +ERR# Component Message +======== =============== ========================================= +[3101]_ download 0 bytes downloaded +[3151]_ extract 0 files extracted +[3201]_ depcheck cannot find the requested dependency +[3202]_ depcheck UnicodeDecodeError while reading file +[3301]_ makepkg returned 1 +[3401]_ auto_build AUR dependency required +[3451]_ validation not installed +[3452]_ validation outdated +[5002]_ search search string too short +======== =============== ========================================= + +Explainations: + +.. [3101] occurs, when PKGBUILDer downloaded 0 bytes. It usually + means that something bad happened during the download. + +.. [3151] occurs, when PKGBUILDer extracted 0 files from the + downloaded tarball. It means that the tarball is broken. Please + tell the maintainer about this problem. + +.. [3201] occurs, when the $depends or $makedepends array of the + PKGBUILD requests a package, that does not exist in the system, + repositories, nor the AUR. + +.. [3202] occurs, when Python cannot decode UTF-8 the PKGBUILD. If + the PKGBUILD cannot be read, dependency checks cannot be performed. + Possible reasons include incorrectly encoded characters in the + Maintainer/Submitter field. Please inform the package maintainer + through the comments. Include the output of `iconv PKGBUILD`. Example + output: `# Maintainer: Juan Piconv: illegal input sequence at position + 20` The PKGBUILDer's error message is also valid and will help the + maintainer. + +.. [3301] occurs, when makepkg exits with the return code 1. It means + that something bad happened. Refer to makepkg's output for more info. + +.. [3401] occurs, when the $depends or $makedepends array of the + PKGBUILD request a package, which exists in the AUR. It is plain + informational. Right after displaying this message, the script will + automatically build the required packages. + +.. [3451] occurs, when PKGBUILDer finds out that the package is not + installed on your system. It means that the package that was bulit + before this message was issued wasn't installed properly (eg. root + password wasn't provided at the right time, 'n' was hit when pacman was + asking for proceeding). + +.. [3452] occurs, when PKGBUILDer finds out that the package is + installed, but outdated. It means that the package that was bulit before + this message was issued wasn't installed properly (eg. root password + wasn't provided at the right time, 'n' was hit when pacman was asking for + proceeding). + +.. [5002] occurs, when your search string is shorter than 3 letters. + The AUR API ignores these requests. However, the script searches for + an exact match. If one is found, it is being shown. diff --git a/docs/html/.buildinfo b/docs/html/.buildinfo new file mode 100644 index 0000000..5990c2c --- /dev/null +++ b/docs/html/.buildinfo @@ -0,0 +1,4 @@ +# Sphinx build info version 1 +# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. +config: 49b727a30472ad9de95e044f2c998716 +tags: fbb0d17656682115ca4d033fb2f83ba1 diff --git a/docs/html/README.html b/docs/html/README.html new file mode 100644 index 0000000..cda8c7d --- /dev/null +++ b/docs/html/README.html @@ -0,0 +1,179 @@ + + + + + + + + + README for PKGBUILDer — PKGBUILDer v2.1.0 documentation + + + + + + + + + + + +

+

Navigation

+ +
+ +
+
+
+
+ +
+

README for PKGBUILDer

+ +++ + + + + + + + + + +
Info:This is the README file for PKGBUILDer.
Author:Kwpolska <kwpolska@kwpolska.tk>
Date:2011-09-20
Version:2.1.0
+
+

PKGBUILDer. A Python AUR helper/library.

+
+

PURPOSE

+

Building and installing AUR packages.

+
+
+

INSTALLATION

+

Copy pkgbuilder.py to /usr/bin or ~/bin. You need to install +pyalpm from [extra] and python3-aur from the AUR.

+
+
+

NOTES

+

This is Version 2 of PKGBUILDer. The original Perl version is included, +but it shall not be used.

+

Version 2.1 is a big leap forward. It introduces many new features. +It is now stable. It is now available as an AUR and PyPI package.

+

The -S (DS.pacman) parameter adds pacman wrapper compatibility.

+

For more info, refer to the pkgbuilder(8) man page or HTML docs in +docs/html.

+
+ +
+
+ + +
+
+
+
+
+

Table Of Contents

+ + +

Previous topic

+

PKGBUILDer

+

Next topic

+

Appendix B. PKGBUILDer error messages list

+ + +
+
+
+
+
+

Navigation

+ +
+
+ © Copyright 2011, Kwpolska. + Last updated on 2011-09-19T20:09:01Z. + Created using Sphinx 1.0.7. +
+ + \ No newline at end of file diff --git a/docs/html/_sources/README.txt b/docs/html/_sources/README.txt new file mode 100644 index 0000000..4ea48f2 --- /dev/null +++ b/docs/html/_sources/README.txt @@ -0,0 +1,61 @@ +===================== +README for PKGBUILDer +===================== +:Info: This is the README file for PKGBUILDer. +:Author: Kwpolska +:Date: 2011-09-20 +:Version: 2.1.0 + +PKGBUILDer. A Python AUR helper/library. +========================================= + +PURPOSE +------- +Building and installing AUR packages. + +INSTALLATION +------------ +Copy pkgbuilder.py to /usr/bin or ~/bin. You need to install +pyalpm from [extra] and python3-aur from the AUR. + +NOTES +----- +This is Version 2 of PKGBUILDer. The original Perl version is included, +but it shall not be used. + +Version 2.1 is a big leap forward. It introduces many new features. +It is now stable. It is now available as an AUR and PyPI package. + +The -S (DS.pacman) parameter adds pacman wrapper compatibility. + +For more info, refer to the pkgbuilder(8) man page or HTML docs in +docs/html. + +COPYRIGHT +--------- +Copyright (C) 2011, Kwpolska +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: + + * Redistributions of source code must retain the above copyright notice, + this list of conditions, and the following disclaimer. + * Redistributions in binary form must reproduce the above copyright notice, + this list of conditions, and the following disclaimer in the + documentation and/or other materials provided with the distribution. + * Neither the name of the author of this software nor the name of + contributors to this software may be used to endorse or promote products + derived from this software without specific prior written consent. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE +LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +POSSIBILITY OF SUCH DAMAGE. diff --git a/docs/html/_sources/errorcodes.txt b/docs/html/_sources/errorcodes.txt new file mode 100644 index 0000000..1315b7d --- /dev/null +++ b/docs/html/_sources/errorcodes.txt @@ -0,0 +1,100 @@ +========================================== +Appendix B. PKGBUILDer error messages list +========================================== +:Info: This is an appendix to the PKGBUILDer documentation. +:Author: Kwpolska +:Date: 2011-09-20 +:Version: 2.1.0 + +In order to help debugging, error messages are numbered. +Each error message number has four digits: the first one is the +category and the other three are error identifiers. + +Categories +========== + +1. AUR class +2. Utils class +3. Build class + 1. download, extract + 2. depcheck, predepcheck + 3. makepkg + 4. auto_build, validation +4. Update class +5. non-module errors + +Usage instructions +------------------ + +In order to get the category identifier, you need to: + + * multiply the desired list element by 1000 + * multiply the desired subelement by 100 + * add the results together + +In order to get the first possible number of this (sub)category, add 1 to +the result of the above calculations. + +Errors +====== + + +======== =============== ========================================= +ERR# Component Message +======== =============== ========================================= +[3101]_ download 0 bytes downloaded +[3151]_ extract 0 files extracted +[3201]_ depcheck cannot find the requested dependency +[3202]_ depcheck UnicodeDecodeError while reading file +[3301]_ makepkg returned 1 +[3401]_ auto_build AUR dependency required +[3451]_ validation not installed +[3452]_ validation outdated +[5002]_ search search string too short +======== =============== ========================================= + +Explainations: + +.. [3101] occurs, when PKGBUILDer downloaded 0 bytes. It usually + means that something bad happened during the download. + +.. [3151] occurs, when PKGBUILDer extracted 0 files from the + downloaded tarball. It means that the tarball is broken. Please + tell the maintainer about this problem. + +.. [3201] occurs, when the $depends or $makedepends array of the + PKGBUILD requests a package, that does not exist in the system, + repositories, nor the AUR. + +.. [3202] occurs, when Python cannot decode UTF-8 the PKGBUILD. If + the PKGBUILD cannot be read, dependency checks cannot be performed. + Possible reasons include incorrectly encoded characters in the + Maintainer/Submitter field. Please inform the package maintainer + through the comments. Include the output of `iconv PKGBUILD`. Example + output: `# Maintainer: Juan Piconv: illegal input sequence at position + 20` The PKGBUILDer's error message is also valid and will help the + maintainer. + +.. [3301] occurs, when makepkg exits with the return code 1. It means + that something bad happened. Refer to makepkg's output for more info. + +.. [3401] occurs, when the $depends or $makedepends array of the + PKGBUILD request a package, which exists in the AUR. It is plain + informational. Right after displaying this message, the script will + automatically build the required packages. + +.. [3451] occurs, when PKGBUILDer finds out that the package is not + installed on your system. It means that the package that was bulit + before this message was issued wasn't installed properly (eg. root + password wasn't provided at the right time, 'n' was hit when pacman was + asking for proceeding). + +.. [3452] occurs, when PKGBUILDer finds out that the package is + installed, but outdated. It means that the package that was bulit before + this message was issued wasn't installed properly (eg. root password + wasn't provided at the right time, 'n' was hit when pacman was asking for + proceeding). + +.. [5002] occurs, when your search string is shorter than 3 letters. + The AUR API ignores these requests. However, the script searches for + an exact match. If one is found, it is being shown. diff --git a/docs/html/_sources/index.txt b/docs/html/_sources/index.txt new file mode 100644 index 0000000..27e10d0 --- /dev/null +++ b/docs/html/_sources/index.txt @@ -0,0 +1,23 @@ +.. PKGBUILDer documentation master file, created by + sphinx-quickstart on Sun Sep 18 14:35:50 2011. + You can adapt this file completely to your liking, but it should at least + contain the root `toctree` directive. + +PKGBUILDer 2.1.0 documentation +============================== + +Contents: + +.. toctree:: + :maxdepth: 2 + + pkgbuilder + README + errorcodes + +.. Indices and tables +.. ================== +.. +.. * :ref:`genindex` +.. * :ref:`modindex` +.. * :ref:`search` diff --git a/docs/html/_sources/pkgbuilder.txt b/docs/html/_sources/pkgbuilder.txt new file mode 100644 index 0000000..ea003e7 --- /dev/null +++ b/docs/html/_sources/pkgbuilder.txt @@ -0,0 +1,101 @@ +========== +PKGBUILDer +========== + +----------------------------------- +a Python AUR helper/library +----------------------------------- + +:Author: Kwpolska +:Date: 2011-09-20 +:Copyright: This document has been placed in the public domain. +:Version: 2.1.0 +:Manual section: 8 +:Manual group: PKGBUILDer manual + +SYNOPSIS +======== + +*pkgbuilder* [options] [targets] + +DESCRIPTION +=========== + +PKGBUILDer is an AUR helper, i.e. an application which builds AUR +packages. It can be used in conjunction with pacman (with a special +script). It uses various techniques to automatize the process as +much as possible. + +Since version 2.1.0, PKGBUILDer provides modules that can be used in +other scripts. + +OPERATIONS +========== + +**-i, --info** + Displays info about *targets*. The format is as follows: + + | Category : AUR category + | Name : package name + | Version : current version + | URL : package URL + | Licenses : package licenses + | Votes : AUR votes + | Out of Date : yes or no + | Maintainer : package owner + | Last Updated : ISO date (1970-01-01T00:00:00Z) + | First Submitted: ISO date + | Description : the package description + +**-s, --search** + Searches the AUR for packages with **targets** as the query. + +**-u, --sysupgrade** + Checks for package updates in the AUR. If updates are found, + they will be installed if the user says so. + +Additionally, parameters **-S**, **--sync**, **-y** and **-refresh** +are accepted for pacman syntax compatibility. **-S**/**--sync** +makes the script build its packages in /tmp instead of the current +working directory (CWD). + +OPTIONS +======= + +**-C, --nocolor** + Forces the script to ignore the ANSI color codes. + +**-V, --novalidation** + Skips package installation validation phase (checking + if the package is installed). + +**-S, --sync** + Originally for pacman syntax compatibility, now makes the script more + wrapper-friendly: builds packages in */tmp* and uses *aur* instead of + the category in search. + +EXAMPLES +======== + +pkgbuilder dropbox + Installs the package "dropbox" from the AUR. It is being built in + the CWD. + +pkgbuilder -S dropbox + Installs "dropbox", but builds thhe package in /tmp-pkgbuilder-UID. + +pkgbuilder -Syu + Checks for updates and offers installing them. + +SEE ALSO +======== +**pacman(8)**, **makepkg(8)** + +You can visit the git repo at +for more info. + +BUGS +==== +Bugs shall be reported at the GitHub page +(). You can also +send mail to . diff --git a/docs/html/_static/basic.css b/docs/html/_static/basic.css new file mode 100644 index 0000000..32630d5 --- /dev/null +++ b/docs/html/_static/basic.css @@ -0,0 +1,528 @@ +/* + * basic.css + * ~~~~~~~~~ + * + * Sphinx stylesheet -- basic theme. + * + * :copyright: Copyright 2007-2011 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +/* -- main layout ----------------------------------------------------------- */ + +div.clearer { + clear: both; +} + +/* -- relbar ---------------------------------------------------------------- */ + +div.related { + width: 100%; + font-size: 90%; +} + +div.related h3 { + display: none; +} + +div.related ul { + margin: 0; + padding: 0 0 0 10px; + list-style: none; +} + +div.related li { + display: inline; +} + +div.related li.right { + float: right; + margin-right: 5px; +} + +/* -- sidebar --------------------------------------------------------------- */ + +div.sphinxsidebarwrapper { + padding: 10px 5px 0 10px; +} + +div.sphinxsidebar { + float: left; + width: 230px; + margin-left: -100%; + font-size: 90%; +} + +div.sphinxsidebar ul { + list-style: none; +} + +div.sphinxsidebar ul ul, +div.sphinxsidebar ul.want-points { + margin-left: 20px; + list-style: square; +} + +div.sphinxsidebar ul ul { + margin-top: 0; + margin-bottom: 0; +} + +div.sphinxsidebar form { + margin-top: 10px; +} + +div.sphinxsidebar input { + border: 1px solid #98dbcc; + font-family: sans-serif; + font-size: 1em; +} + +img { + border: 0; +} + +/* -- search page ----------------------------------------------------------- */ + +ul.search { + margin: 10px 0 0 20px; + padding: 0; +} + +ul.search li { + padding: 5px 0 5px 20px; + background-image: url(file.png); + background-repeat: no-repeat; + background-position: 0 7px; +} + +ul.search li a { + font-weight: bold; +} + +ul.search li div.context { + color: #888; + margin: 2px 0 0 30px; + text-align: left; +} + +ul.keywordmatches li.goodmatch a { + font-weight: bold; +} + +/* -- index page ------------------------------------------------------------ */ + +table.contentstable { + width: 90%; +} + +table.contentstable p.biglink { + line-height: 150%; +} + +a.biglink { + font-size: 1.3em; +} + +span.linkdescr { + font-style: italic; + padding-top: 5px; + font-size: 90%; +} + +/* -- general index --------------------------------------------------------- */ + +table.indextable { + width: 100%; +} + +table.indextable td { + text-align: left; + vertical-align: top; +} + +table.indextable dl, table.indextable dd { + margin-top: 0; + margin-bottom: 0; +} + +table.indextable tr.pcap { + height: 10px; +} + +table.indextable tr.cap { + margin-top: 10px; + background-color: #f2f2f2; +} + +img.toggler { + margin-right: 3px; + margin-top: 3px; + cursor: pointer; +} + +div.modindex-jumpbox { + border-top: 1px solid #ddd; + border-bottom: 1px solid #ddd; + margin: 1em 0 1em 0; + padding: 0.4em; +} + +div.genindex-jumpbox { + border-top: 1px solid #ddd; + border-bottom: 1px solid #ddd; + margin: 1em 0 1em 0; + padding: 0.4em; +} + +/* -- general body styles --------------------------------------------------- */ + +a.headerlink { + visibility: hidden; +} + +h1:hover > a.headerlink, +h2:hover > a.headerlink, +h3:hover > a.headerlink, +h4:hover > a.headerlink, +h5:hover > a.headerlink, +h6:hover > a.headerlink, +dt:hover > a.headerlink { + visibility: visible; +} + +div.body p.caption { + text-align: inherit; +} + +div.body td { + text-align: left; +} + +.field-list ul { + padding-left: 1em; +} + +.first { + margin-top: 0 !important; +} + +p.rubric { + margin-top: 30px; + font-weight: bold; +} + +img.align-left, .figure.align-left, object.align-left { + clear: left; + float: left; + margin-right: 1em; +} + +img.align-right, .figure.align-right, object.align-right { + clear: right; + float: right; + margin-left: 1em; +} + +img.align-center, .figure.align-center, object.align-center { + display: block; + margin-left: auto; + margin-right: auto; +} + +.align-left { + text-align: left; +} + +.align-center { + clear: both; + text-align: center; +} + +.align-right { + text-align: right; +} + +/* -- sidebars -------------------------------------------------------------- */ + +div.sidebar { + margin: 0 0 0.5em 1em; + border: 1px solid #ddb; + padding: 7px 7px 0 7px; + background-color: #ffe; + width: 40%; + float: right; +} + +p.sidebar-title { + font-weight: bold; +} + +/* -- topics ---------------------------------------------------------------- */ + +div.topic { + border: 1px solid #ccc; + padding: 7px 7px 0 7px; + margin: 10px 0 10px 0; +} + +p.topic-title { + font-size: 1.1em; + font-weight: bold; + margin-top: 10px; +} + +/* -- admonitions ----------------------------------------------------------- */ + +div.admonition { + margin-top: 10px; + margin-bottom: 10px; + padding: 7px; +} + +div.admonition dt { + font-weight: bold; +} + +div.admonition dl { + margin-bottom: 0; +} + +p.admonition-title { + margin: 0px 10px 5px 0px; + font-weight: bold; +} + +div.body p.centered { + text-align: center; + margin-top: 25px; +} + +/* -- tables ---------------------------------------------------------------- */ + +table.docutils { + border: 0; + border-collapse: collapse; +} + +table.docutils td, table.docutils th { + padding: 1px 8px 1px 5px; + border-top: 0; + border-left: 0; + border-right: 0; + border-bottom: 1px solid #aaa; +} + +table.field-list td, table.field-list th { + border: 0 !important; +} + +table.footnote td, table.footnote th { + border: 0 !important; +} + +th { + text-align: left; + padding-right: 5px; +} + +table.citation { + border-left: solid 1px gray; + margin-left: 1px; +} + +table.citation td { + border-bottom: none; +} + +/* -- other body styles ----------------------------------------------------- */ + +ol.arabic { + list-style: decimal; +} + +ol.loweralpha { + list-style: lower-alpha; +} + +ol.upperalpha { + list-style: upper-alpha; +} + +ol.lowerroman { + list-style: lower-roman; +} + +ol.upperroman { + list-style: upper-roman; +} + +dl { + margin-bottom: 15px; +} + +dd p { + margin-top: 0px; +} + +dd ul, dd table { + margin-bottom: 10px; +} + +dd { + margin-top: 3px; + margin-bottom: 10px; + margin-left: 30px; +} + +dt:target, .highlighted { + background-color: #fbe54e; +} + +dl.glossary dt { + font-weight: bold; + font-size: 1.1em; +} + +.field-list ul { + margin: 0; + padding-left: 1em; +} + +.field-list p { + margin: 0; +} + +.refcount { + color: #060; +} + +.optional { + font-size: 1.3em; +} + +.versionmodified { + font-style: italic; +} + +.system-message { + background-color: #fda; + padding: 5px; + border: 3px solid red; +} + +.footnote:target { + background-color: #ffa; +} + +.line-block { + display: block; + margin-top: 1em; + margin-bottom: 1em; +} + +.line-block .line-block { + margin-top: 0; + margin-bottom: 0; + margin-left: 1.5em; +} + +.guilabel, .menuselection { + font-family: sans-serif; +} + +.accelerator { + text-decoration: underline; +} + +.classifier { + font-style: oblique; +} + +/* -- code displays --------------------------------------------------------- */ + +pre { + overflow: auto; + overflow-y: hidden; /* fixes display issues on Chrome browsers */ +} + +td.linenos pre { + padding: 5px 0px; + border: 0; + background-color: transparent; + color: #aaa; +} + +table.highlighttable { + margin-left: 0.5em; +} + +table.highlighttable td { + padding: 0 0.5em 0 0.5em; +} + +tt.descname { + background-color: transparent; + font-weight: bold; + font-size: 1.2em; +} + +tt.descclassname { + background-color: transparent; +} + +tt.xref, a tt { + background-color: transparent; + font-weight: bold; +} + +h1 tt, h2 tt, h3 tt, h4 tt, h5 tt, h6 tt { + background-color: transparent; +} + +.viewcode-link { + float: right; +} + +.viewcode-back { + float: right; + font-family: sans-serif; +} + +div.viewcode-block:target { + margin: -1px -10px; + padding: 0 10px; +} + +/* -- math display ---------------------------------------------------------- */ + +img.math { + vertical-align: middle; +} + +div.body div.math p { + text-align: center; +} + +span.eqno { + float: right; +} + +/* -- printout stylesheet --------------------------------------------------- */ + +@media print { + div.document, + div.documentwrapper, + div.bodywrapper { + margin: 0 !important; + width: 100%; + } + + div.sphinxsidebar, + div.related, + div.footer, + #top-link { + display: none; + } +} diff --git a/docs/html/_static/default.css b/docs/html/_static/default.css new file mode 100644 index 0000000..21f3f50 --- /dev/null +++ b/docs/html/_static/default.css @@ -0,0 +1,256 @@ +/* + * default.css_t + * ~~~~~~~~~~~~~ + * + * Sphinx stylesheet -- default theme. + * + * :copyright: Copyright 2007-2011 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +@import url("basic.css"); + +/* -- page layout ----------------------------------------------------------- */ + +body { + font-family: sans-serif; + font-size: 100%; + background-color: #11303d; + color: #000; + margin: 0; + padding: 0; +} + +div.document { + background-color: #1c4e63; +} + +div.documentwrapper { + float: left; + width: 100%; +} + +div.bodywrapper { + margin: 0 0 0 230px; +} + +div.body { + background-color: #ffffff; + color: #000000; + padding: 0 20px 30px 20px; +} + +div.footer { + color: #ffffff; + width: 100%; + padding: 9px 0 9px 0; + text-align: center; + font-size: 75%; +} + +div.footer a { + color: #ffffff; + text-decoration: underline; +} + +div.related { + background-color: #133f52; + line-height: 30px; + color: #ffffff; +} + +div.related a { + color: #ffffff; +} + +div.sphinxsidebar { +} + +div.sphinxsidebar h3 { + font-family: 'Trebuchet MS', sans-serif; + color: #ffffff; + font-size: 1.4em; + font-weight: normal; + margin: 0; + padding: 0; +} + +div.sphinxsidebar h3 a { + color: #ffffff; +} + +div.sphinxsidebar h4 { + font-family: 'Trebuchet MS', sans-serif; + color: #ffffff; + font-size: 1.3em; + font-weight: normal; + margin: 5px 0 0 0; + padding: 0; +} + +div.sphinxsidebar p { + color: #ffffff; +} + +div.sphinxsidebar p.topless { + margin: 5px 10px 10px 10px; +} + +div.sphinxsidebar ul { + margin: 10px; + padding: 0; + color: #ffffff; +} + +div.sphinxsidebar a { + color: #98dbcc; +} + +div.sphinxsidebar input { + border: 1px solid #98dbcc; + font-family: sans-serif; + font-size: 1em; +} + + + +/* -- hyperlink styles ------------------------------------------------------ */ + +a { + color: #355f7c; + text-decoration: none; +} + +a:visited { + color: #355f7c; + text-decoration: none; +} + +a:hover { + text-decoration: underline; +} + + + +/* -- body styles ----------------------------------------------------------- */ + +div.body h1, +div.body h2, +div.body h3, +div.body h4, +div.body h5, +div.body h6 { + font-family: 'Trebuchet MS', sans-serif; + background-color: #f2f2f2; + font-weight: normal; + color: #20435c; + border-bottom: 1px solid #ccc; + margin: 20px -20px 10px -20px; + padding: 3px 0 3px 10px; +} + +div.body h1 { margin-top: 0; font-size: 200%; } +div.body h2 { font-size: 160%; } +div.body h3 { font-size: 140%; } +div.body h4 { font-size: 120%; } +div.body h5 { font-size: 110%; } +div.body h6 { font-size: 100%; } + +a.headerlink { + color: #c60f0f; + font-size: 0.8em; + padding: 0 4px 0 4px; + text-decoration: none; +} + +a.headerlink:hover { + background-color: #c60f0f; + color: white; +} + +div.body p, div.body dd, div.body li { + text-align: justify; + line-height: 130%; +} + +div.admonition p.admonition-title + p { + display: inline; +} + +div.admonition p { + margin-bottom: 5px; +} + +div.admonition pre { + margin-bottom: 5px; +} + +div.admonition ul, div.admonition ol { + margin-bottom: 5px; +} + +div.note { + background-color: #eee; + border: 1px solid #ccc; +} + +div.seealso { + background-color: #ffc; + border: 1px solid #ff6; +} + +div.topic { + background-color: #eee; +} + +div.warning { + background-color: #ffe4e4; + border: 1px solid #f66; +} + +p.admonition-title { + display: inline; +} + +p.admonition-title:after { + content: ":"; +} + +pre { + padding: 5px; + background-color: #eeffcc; + color: #333333; + line-height: 120%; + border: 1px solid #ac9; + border-left: none; + border-right: none; +} + +tt { + background-color: #ecf0f3; + padding: 0 1px 0 1px; + font-size: 0.95em; +} + +th { + background-color: #ede; +} + +.warning tt { + background: #efc2c2; +} + +.note tt { + background: #d6d6d6; +} + +.viewcode-back { + font-family: sans-serif; +} + +div.viewcode-block:target { + background-color: #f4debf; + border-top: 1px solid #ac9; + border-bottom: 1px solid #ac9; +} \ No newline at end of file diff --git a/docs/html/_static/doctools.js b/docs/html/_static/doctools.js new file mode 100644 index 0000000..8b9bd2c --- /dev/null +++ b/docs/html/_static/doctools.js @@ -0,0 +1,247 @@ +/* + * doctools.js + * ~~~~~~~~~~~ + * + * Sphinx JavaScript utilties for all documentation. + * + * :copyright: Copyright 2007-2011 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +/** + * select a different prefix for underscore + */ +$u = _.noConflict(); + +/** + * make the code below compatible with browsers without + * an installed firebug like debugger +if (!window.console || !console.firebug) { + var names = ["log", "debug", "info", "warn", "error", "assert", "dir", + "dirxml", "group", "groupEnd", "time", "timeEnd", "count", "trace", + "profile", "profileEnd"]; + window.console = {}; + for (var i = 0; i < names.length; ++i) + window.console[names[i]] = function() {}; +} + */ + +/** + * small helper function to urldecode strings + */ +jQuery.urldecode = function(x) { + return decodeURIComponent(x).replace(/\+/g, ' '); +} + +/** + * small helper function to urlencode strings + */ +jQuery.urlencode = encodeURIComponent; + +/** + * This function returns the parsed url parameters of the + * current request. Multiple values per key are supported, + * it will always return arrays of strings for the value parts. + */ +jQuery.getQueryParameters = function(s) { + if (typeof s == 'undefined') + s = document.location.search; + var parts = s.substr(s.indexOf('?') + 1).split('&'); + var result = {}; + for (var i = 0; i < parts.length; i++) { + var tmp = parts[i].split('=', 2); + var key = jQuery.urldecode(tmp[0]); + var value = jQuery.urldecode(tmp[1]); + if (key in result) + result[key].push(value); + else + result[key] = [value]; + } + return result; +}; + +/** + * small function to check if an array contains + * a given item. + */ +jQuery.contains = function(arr, item) { + for (var i = 0; i < arr.length; i++) { + if (arr[i] == item) + return true; + } + return false; +}; + +/** + * highlight a given string on a jquery object by wrapping it in + * span elements with the given class name. + */ +jQuery.fn.highlightText = function(text, className) { + function highlight(node) { + if (node.nodeType == 3) { + var val = node.nodeValue; + var pos = val.toLowerCase().indexOf(text); + if (pos >= 0 && !jQuery(node.parentNode).hasClass(className)) { + var span = document.createElement("span"); + span.className = className; + span.appendChild(document.createTextNode(val.substr(pos, text.length))); + node.parentNode.insertBefore(span, node.parentNode.insertBefore( + document.createTextNode(val.substr(pos + text.length)), + node.nextSibling)); + node.nodeValue = val.substr(0, pos); + } + } + else if (!jQuery(node).is("button, select, textarea")) { + jQuery.each(node.childNodes, function() { + highlight(this); + }); + } + } + return this.each(function() { + highlight(this); + }); +}; + +/** + * Small JavaScript module for the documentation. + */ +var Documentation = { + + init : function() { + this.fixFirefoxAnchorBug(); + this.highlightSearchWords(); + this.initIndexTable(); + }, + + /** + * i18n support + */ + TRANSLATIONS : {}, + PLURAL_EXPR : function(n) { return n == 1 ? 0 : 1; }, + LOCALE : 'unknown', + + // gettext and ngettext don't access this so that the functions + // can safely bound to a different name (_ = Documentation.gettext) + gettext : function(string) { + var translated = Documentation.TRANSLATIONS[string]; + if (typeof translated == 'undefined') + return string; + return (typeof translated == 'string') ? translated : translated[0]; + }, + + ngettext : function(singular, plural, n) { + var translated = Documentation.TRANSLATIONS[singular]; + if (typeof translated == 'undefined') + return (n == 1) ? singular : plural; + return translated[Documentation.PLURALEXPR(n)]; + }, + + addTranslations : function(catalog) { + for (var key in catalog.messages) + this.TRANSLATIONS[key] = catalog.messages[key]; + this.PLURAL_EXPR = new Function('n', 'return +(' + catalog.plural_expr + ')'); + this.LOCALE = catalog.locale; + }, + + /** + * add context elements like header anchor links + */ + addContextElements : function() { + $('div[id] > :header:first').each(function() { + $('\u00B6'). + attr('href', '#' + this.id). + attr('title', _('Permalink to this headline')). + appendTo(this); + }); + $('dt[id]').each(function() { + $('\u00B6'). + attr('href', '#' + this.id). + attr('title', _('Permalink to this definition')). + appendTo(this); + }); + }, + + /** + * workaround a firefox stupidity + */ + fixFirefoxAnchorBug : function() { + if (document.location.hash && $.browser.mozilla) + window.setTimeout(function() { + document.location.href += ''; + }, 10); + }, + + /** + * highlight the search words provided in the url in the text + */ + highlightSearchWords : function() { + var params = $.getQueryParameters(); + var terms = (params.highlight) ? params.highlight[0].split(/\s+/) : []; + if (terms.length) { + var body = $('div.body'); + window.setTimeout(function() { + $.each(terms, function() { + body.highlightText(this.toLowerCase(), 'highlighted'); + }); + }, 10); + $('
  • ' + _('Hide Search Matches') + '
    • ') + .appendTo($('.sidebar .this-page-menu')); + } + }, + + /** + * init the domain index toggle buttons + */ + initIndexTable : function() { + var togglers = $('img.toggler').click(function() { + var src = $(this).attr('src'); + var idnum = $(this).attr('id').substr(7); + $('tr.cg-' + idnum).toggle(); + if (src.substr(-9) == 'minus.png') + $(this).attr('src', src.substr(0, src.length-9) + 'plus.png'); + else + $(this).attr('src', src.substr(0, src.length-8) + 'minus.png'); + }).css('display', ''); + if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) { + togglers.click(); + } + }, + + /** + * helper function to hide the search marks again + */ + hideSearchWords : function() { + $('.sidebar .this-page-menu li.highlight-link').fadeOut(300); + $('span.highlighted').removeClass('highlighted'); + }, + + /** + * make the url absolute + */ + makeURL : function(relativeURL) { + return DOCUMENTATION_OPTIONS.URL_ROOT + '/' + relativeURL; + }, + + /** + * get the current relative url + */ + getCurrentURL : function() { + var path = document.location.pathname; + var parts = path.split(/\//); + $.each(DOCUMENTATION_OPTIONS.URL_ROOT.split(/\//), function() { + if (this == '..') + parts.pop(); + }); + var url = parts.join('/'); + return path.substring(url.lastIndexOf('/') + 1, path.length - 1); + } +}; + +// quick alias for translations +_ = Documentation.gettext; + +$(document).ready(function() { + Documentation.init(); +}); diff --git a/docs/html/_static/file.png b/docs/html/_static/file.png new file mode 100644 index 0000000000000000000000000000000000000000..d18082e397e7e54f20721af768c4c2983258f1b4 GIT binary patch literal 392 zcmeAS@N?(olHy`uVBq!ia0vp^0wB!61|;P_|4#%`Y)RhkE)4%caKYZ?lYt_f1s;*b z3=G`DAk4@xYmNj^kiEpy*OmP$HyOL$D9)yc9|lc|nKf<9@eUiWd>3GuTC!a5vdfWYEazjncPj5ZQX%+1 zt8B*4=d)!cdDz4wr^#OMYfqGz$1LDFF>|#>*O?AGil(WEs?wLLy{Gj2J_@opDm%`dlax3yA*@*N$G&*ukFv>P8+2CBWO(qz zD0k1@kN>hhb1_6`&wrCswzINE(evt-5C1B^STi2@PmdKI;Vst0PQB6!2kdN literal 0 HcmV?d00001 diff --git a/docs/html/_static/jquery.js b/docs/html/_static/jquery.js new file mode 100644 index 0000000..7c24308 --- /dev/null +++ b/docs/html/_static/jquery.js @@ -0,0 +1,154 @@ +/*! + * jQuery JavaScript Library v1.4.2 + * http://jquery.com/ + * + * Copyright 2010, John Resig + * Dual licensed under the MIT or GPL Version 2 licenses. + * http://jquery.org/license + * + * Includes Sizzle.js + * http://sizzlejs.com/ + * Copyright 2010, The Dojo Foundation + * Released under the MIT, BSD, and GPL Licenses. + * + * Date: Sat Feb 13 22:33:48 2010 -0500 + */ +(function(A,w){function ma(){if(!c.isReady){try{s.documentElement.doScroll("left")}catch(a){setTimeout(ma,1);return}c.ready()}}function Qa(a,b){b.src?c.ajax({url:b.src,async:false,dataType:"script"}):c.globalEval(b.text||b.textContent||b.innerHTML||"");b.parentNode&&b.parentNode.removeChild(b)}function X(a,b,d,f,e,j){var i=a.length;if(typeof b==="object"){for(var o in b)X(a,o,b[o],f,e,d);return a}if(d!==w){f=!j&&f&&c.isFunction(d);for(o=0;o)[^>]*$|^#([\w-]+)$/,Ua=/^.[^:#\[\.,]*$/,Va=/\S/, +Wa=/^(\s|\u00A0)+|(\s|\u00A0)+$/g,Xa=/^<(\w+)\s*\/?>(?:<\/\1>)?$/,P=navigator.userAgent,xa=false,Q=[],L,$=Object.prototype.toString,aa=Object.prototype.hasOwnProperty,ba=Array.prototype.push,R=Array.prototype.slice,ya=Array.prototype.indexOf;c.fn=c.prototype={init:function(a,b){var d,f;if(!a)return this;if(a.nodeType){this.context=this[0]=a;this.length=1;return this}if(a==="body"&&!b){this.context=s;this[0]=s.body;this.selector="body";this.length=1;return this}if(typeof a==="string")if((d=Ta.exec(a))&& +(d[1]||!b))if(d[1]){f=b?b.ownerDocument||b:s;if(a=Xa.exec(a))if(c.isPlainObject(b)){a=[s.createElement(a[1])];c.fn.attr.call(a,b,true)}else a=[f.createElement(a[1])];else{a=sa([d[1]],[f]);a=(a.cacheable?a.fragment.cloneNode(true):a.fragment).childNodes}return c.merge(this,a)}else{if(b=s.getElementById(d[2])){if(b.id!==d[2])return T.find(a);this.length=1;this[0]=b}this.context=s;this.selector=a;return this}else if(!b&&/^\w+$/.test(a)){this.selector=a;this.context=s;a=s.getElementsByTagName(a);return c.merge(this, +a)}else return!b||b.jquery?(b||T).find(a):c(b).find(a);else if(c.isFunction(a))return T.ready(a);if(a.selector!==w){this.selector=a.selector;this.context=a.context}return c.makeArray(a,this)},selector:"",jquery:"1.4.2",length:0,size:function(){return this.length},toArray:function(){return R.call(this,0)},get:function(a){return a==null?this.toArray():a<0?this.slice(a)[0]:this[a]},pushStack:function(a,b,d){var f=c();c.isArray(a)?ba.apply(f,a):c.merge(f,a);f.prevObject=this;f.context=this.context;if(b=== +"find")f.selector=this.selector+(this.selector?" ":"")+d;else if(b)f.selector=this.selector+"."+b+"("+d+")";return f},each:function(a,b){return c.each(this,a,b)},ready:function(a){c.bindReady();if(c.isReady)a.call(s,c);else Q&&Q.push(a);return this},eq:function(a){return a===-1?this.slice(a):this.slice(a,+a+1)},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},slice:function(){return this.pushStack(R.apply(this,arguments),"slice",R.call(arguments).join(","))},map:function(a){return this.pushStack(c.map(this, +function(b,d){return a.call(b,d,b)}))},end:function(){return this.prevObject||c(null)},push:ba,sort:[].sort,splice:[].splice};c.fn.init.prototype=c.fn;c.extend=c.fn.extend=function(){var a=arguments[0]||{},b=1,d=arguments.length,f=false,e,j,i,o;if(typeof a==="boolean"){f=a;a=arguments[1]||{};b=2}if(typeof a!=="object"&&!c.isFunction(a))a={};if(d===b){a=this;--b}for(;b
    a"; +var e=d.getElementsByTagName("*"),j=d.getElementsByTagName("a")[0];if(!(!e||!e.length||!j)){c.support={leadingWhitespace:d.firstChild.nodeType===3,tbody:!d.getElementsByTagName("tbody").length,htmlSerialize:!!d.getElementsByTagName("link").length,style:/red/.test(j.getAttribute("style")),hrefNormalized:j.getAttribute("href")==="/a",opacity:/^0.55$/.test(j.style.opacity),cssFloat:!!j.style.cssFloat,checkOn:d.getElementsByTagName("input")[0].value==="on",optSelected:s.createElement("select").appendChild(s.createElement("option")).selected, +parentNode:d.removeChild(d.appendChild(s.createElement("div"))).parentNode===null,deleteExpando:true,checkClone:false,scriptEval:false,noCloneEvent:true,boxModel:null};b.type="text/javascript";try{b.appendChild(s.createTextNode("window."+f+"=1;"))}catch(i){}a.insertBefore(b,a.firstChild);if(A[f]){c.support.scriptEval=true;delete A[f]}try{delete b.test}catch(o){c.support.deleteExpando=false}a.removeChild(b);if(d.attachEvent&&d.fireEvent){d.attachEvent("onclick",function k(){c.support.noCloneEvent= +false;d.detachEvent("onclick",k)});d.cloneNode(true).fireEvent("onclick")}d=s.createElement("div");d.innerHTML="";a=s.createDocumentFragment();a.appendChild(d.firstChild);c.support.checkClone=a.cloneNode(true).cloneNode(true).lastChild.checked;c(function(){var k=s.createElement("div");k.style.width=k.style.paddingLeft="1px";s.body.appendChild(k);c.boxModel=c.support.boxModel=k.offsetWidth===2;s.body.removeChild(k).style.display="none"});a=function(k){var n= +s.createElement("div");k="on"+k;var r=k in n;if(!r){n.setAttribute(k,"return;");r=typeof n[k]==="function"}return r};c.support.submitBubbles=a("submit");c.support.changeBubbles=a("change");a=b=d=e=j=null}})();c.props={"for":"htmlFor","class":"className",readonly:"readOnly",maxlength:"maxLength",cellspacing:"cellSpacing",rowspan:"rowSpan",colspan:"colSpan",tabindex:"tabIndex",usemap:"useMap",frameborder:"frameBorder"};var G="jQuery"+J(),Ya=0,za={};c.extend({cache:{},expando:G,noData:{embed:true,object:true, +applet:true},data:function(a,b,d){if(!(a.nodeName&&c.noData[a.nodeName.toLowerCase()])){a=a==A?za:a;var f=a[G],e=c.cache;if(!f&&typeof b==="string"&&d===w)return null;f||(f=++Ya);if(typeof b==="object"){a[G]=f;e[f]=c.extend(true,{},b)}else if(!e[f]){a[G]=f;e[f]={}}a=e[f];if(d!==w)a[b]=d;return typeof b==="string"?a[b]:a}},removeData:function(a,b){if(!(a.nodeName&&c.noData[a.nodeName.toLowerCase()])){a=a==A?za:a;var d=a[G],f=c.cache,e=f[d];if(b){if(e){delete e[b];c.isEmptyObject(e)&&c.removeData(a)}}else{if(c.support.deleteExpando)delete a[c.expando]; +else a.removeAttribute&&a.removeAttribute(c.expando);delete f[d]}}}});c.fn.extend({data:function(a,b){if(typeof a==="undefined"&&this.length)return c.data(this[0]);else if(typeof a==="object")return this.each(function(){c.data(this,a)});var d=a.split(".");d[1]=d[1]?"."+d[1]:"";if(b===w){var f=this.triggerHandler("getData"+d[1]+"!",[d[0]]);if(f===w&&this.length)f=c.data(this[0],a);return f===w&&d[1]?this.data(d[0]):f}else return this.trigger("setData"+d[1]+"!",[d[0],b]).each(function(){c.data(this, +a,b)})},removeData:function(a){return this.each(function(){c.removeData(this,a)})}});c.extend({queue:function(a,b,d){if(a){b=(b||"fx")+"queue";var f=c.data(a,b);if(!d)return f||[];if(!f||c.isArray(d))f=c.data(a,b,c.makeArray(d));else f.push(d);return f}},dequeue:function(a,b){b=b||"fx";var d=c.queue(a,b),f=d.shift();if(f==="inprogress")f=d.shift();if(f){b==="fx"&&d.unshift("inprogress");f.call(a,function(){c.dequeue(a,b)})}}});c.fn.extend({queue:function(a,b){if(typeof a!=="string"){b=a;a="fx"}if(b=== +w)return c.queue(this[0],a);return this.each(function(){var d=c.queue(this,a,b);a==="fx"&&d[0]!=="inprogress"&&c.dequeue(this,a)})},dequeue:function(a){return this.each(function(){c.dequeue(this,a)})},delay:function(a,b){a=c.fx?c.fx.speeds[a]||a:a;b=b||"fx";return this.queue(b,function(){var d=this;setTimeout(function(){c.dequeue(d,b)},a)})},clearQueue:function(a){return this.queue(a||"fx",[])}});var Aa=/[\n\t]/g,ca=/\s+/,Za=/\r/g,$a=/href|src|style/,ab=/(button|input)/i,bb=/(button|input|object|select|textarea)/i, +cb=/^(a|area)$/i,Ba=/radio|checkbox/;c.fn.extend({attr:function(a,b){return X(this,a,b,true,c.attr)},removeAttr:function(a){return this.each(function(){c.attr(this,a,"");this.nodeType===1&&this.removeAttribute(a)})},addClass:function(a){if(c.isFunction(a))return this.each(function(n){var r=c(this);r.addClass(a.call(this,n,r.attr("class")))});if(a&&typeof a==="string")for(var b=(a||"").split(ca),d=0,f=this.length;d-1)return true;return false},val:function(a){if(a===w){var b=this[0];if(b){if(c.nodeName(b,"option"))return(b.attributes.value||{}).specified?b.value:b.text;if(c.nodeName(b,"select")){var d=b.selectedIndex,f=[],e=b.options;b=b.type==="select-one";if(d<0)return null;var j=b?d:0;for(d=b?d+1:e.length;j=0;else if(c.nodeName(this,"select")){var u=c.makeArray(r);c("option",this).each(function(){this.selected= +c.inArray(c(this).val(),u)>=0});if(!u.length)this.selectedIndex=-1}else this.value=r}})}});c.extend({attrFn:{val:true,css:true,html:true,text:true,data:true,width:true,height:true,offset:true},attr:function(a,b,d,f){if(!a||a.nodeType===3||a.nodeType===8)return w;if(f&&b in c.attrFn)return c(a)[b](d);f=a.nodeType!==1||!c.isXMLDoc(a);var e=d!==w;b=f&&c.props[b]||b;if(a.nodeType===1){var j=$a.test(b);if(b in a&&f&&!j){if(e){b==="type"&&ab.test(a.nodeName)&&a.parentNode&&c.error("type property can't be changed"); +a[b]=d}if(c.nodeName(a,"form")&&a.getAttributeNode(b))return a.getAttributeNode(b).nodeValue;if(b==="tabIndex")return(b=a.getAttributeNode("tabIndex"))&&b.specified?b.value:bb.test(a.nodeName)||cb.test(a.nodeName)&&a.href?0:w;return a[b]}if(!c.support.style&&f&&b==="style"){if(e)a.style.cssText=""+d;return a.style.cssText}e&&a.setAttribute(b,""+d);a=!c.support.hrefNormalized&&f&&j?a.getAttribute(b,2):a.getAttribute(b);return a===null?w:a}return c.style(a,b,d)}});var O=/\.(.*)$/,db=function(a){return a.replace(/[^\w\s\.\|`]/g, +function(b){return"\\"+b})};c.event={add:function(a,b,d,f){if(!(a.nodeType===3||a.nodeType===8)){if(a.setInterval&&a!==A&&!a.frameElement)a=A;var e,j;if(d.handler){e=d;d=e.handler}if(!d.guid)d.guid=c.guid++;if(j=c.data(a)){var i=j.events=j.events||{},o=j.handle;if(!o)j.handle=o=function(){return typeof c!=="undefined"&&!c.event.triggered?c.event.handle.apply(o.elem,arguments):w};o.elem=a;b=b.split(" ");for(var k,n=0,r;k=b[n++];){j=e?c.extend({},e):{handler:d,data:f};if(k.indexOf(".")>-1){r=k.split("."); +k=r.shift();j.namespace=r.slice(0).sort().join(".")}else{r=[];j.namespace=""}j.type=k;j.guid=d.guid;var u=i[k],z=c.event.special[k]||{};if(!u){u=i[k]=[];if(!z.setup||z.setup.call(a,f,r,o)===false)if(a.addEventListener)a.addEventListener(k,o,false);else a.attachEvent&&a.attachEvent("on"+k,o)}if(z.add){z.add.call(a,j);if(!j.handler.guid)j.handler.guid=d.guid}u.push(j);c.event.global[k]=true}a=null}}},global:{},remove:function(a,b,d,f){if(!(a.nodeType===3||a.nodeType===8)){var e,j=0,i,o,k,n,r,u,z=c.data(a), +C=z&&z.events;if(z&&C){if(b&&b.type){d=b.handler;b=b.type}if(!b||typeof b==="string"&&b.charAt(0)==="."){b=b||"";for(e in C)c.event.remove(a,e+b)}else{for(b=b.split(" ");e=b[j++];){n=e;i=e.indexOf(".")<0;o=[];if(!i){o=e.split(".");e=o.shift();k=new RegExp("(^|\\.)"+c.map(o.slice(0).sort(),db).join("\\.(?:.*\\.)?")+"(\\.|$)")}if(r=C[e])if(d){n=c.event.special[e]||{};for(B=f||0;B=0){a.type= +e=e.slice(0,-1);a.exclusive=true}if(!d){a.stopPropagation();c.event.global[e]&&c.each(c.cache,function(){this.events&&this.events[e]&&c.event.trigger(a,b,this.handle.elem)})}if(!d||d.nodeType===3||d.nodeType===8)return w;a.result=w;a.target=d;b=c.makeArray(b);b.unshift(a)}a.currentTarget=d;(f=c.data(d,"handle"))&&f.apply(d,b);f=d.parentNode||d.ownerDocument;try{if(!(d&&d.nodeName&&c.noData[d.nodeName.toLowerCase()]))if(d["on"+e]&&d["on"+e].apply(d,b)===false)a.result=false}catch(j){}if(!a.isPropagationStopped()&& +f)c.event.trigger(a,b,f,true);else if(!a.isDefaultPrevented()){f=a.target;var i,o=c.nodeName(f,"a")&&e==="click",k=c.event.special[e]||{};if((!k._default||k._default.call(d,a)===false)&&!o&&!(f&&f.nodeName&&c.noData[f.nodeName.toLowerCase()])){try{if(f[e]){if(i=f["on"+e])f["on"+e]=null;c.event.triggered=true;f[e]()}}catch(n){}if(i)f["on"+e]=i;c.event.triggered=false}}},handle:function(a){var b,d,f,e;a=arguments[0]=c.event.fix(a||A.event);a.currentTarget=this;b=a.type.indexOf(".")<0&&!a.exclusive; +if(!b){d=a.type.split(".");a.type=d.shift();f=new RegExp("(^|\\.)"+d.slice(0).sort().join("\\.(?:.*\\.)?")+"(\\.|$)")}e=c.data(this,"events");d=e[a.type];if(e&&d){d=d.slice(0);e=0;for(var j=d.length;e-1?c.map(a.options,function(f){return f.selected}).join("-"):"";else if(a.nodeName.toLowerCase()==="select")d=a.selectedIndex;return d},fa=function(a,b){var d=a.target,f,e;if(!(!da.test(d.nodeName)||d.readOnly)){f=c.data(d,"_change_data");e=Fa(d);if(a.type!=="focusout"||d.type!=="radio")c.data(d,"_change_data", +e);if(!(f===w||e===f))if(f!=null||e){a.type="change";return c.event.trigger(a,b,d)}}};c.event.special.change={filters:{focusout:fa,click:function(a){var b=a.target,d=b.type;if(d==="radio"||d==="checkbox"||b.nodeName.toLowerCase()==="select")return fa.call(this,a)},keydown:function(a){var b=a.target,d=b.type;if(a.keyCode===13&&b.nodeName.toLowerCase()!=="textarea"||a.keyCode===32&&(d==="checkbox"||d==="radio")||d==="select-multiple")return fa.call(this,a)},beforeactivate:function(a){a=a.target;c.data(a, +"_change_data",Fa(a))}},setup:function(){if(this.type==="file")return false;for(var a in ea)c.event.add(this,a+".specialChange",ea[a]);return da.test(this.nodeName)},teardown:function(){c.event.remove(this,".specialChange");return da.test(this.nodeName)}};ea=c.event.special.change.filters}s.addEventListener&&c.each({focus:"focusin",blur:"focusout"},function(a,b){function d(f){f=c.event.fix(f);f.type=b;return c.event.handle.call(this,f)}c.event.special[b]={setup:function(){this.addEventListener(a, +d,true)},teardown:function(){this.removeEventListener(a,d,true)}}});c.each(["bind","one"],function(a,b){c.fn[b]=function(d,f,e){if(typeof d==="object"){for(var j in d)this[b](j,f,d[j],e);return this}if(c.isFunction(f)){e=f;f=w}var i=b==="one"?c.proxy(e,function(k){c(this).unbind(k,i);return e.apply(this,arguments)}):e;if(d==="unload"&&b!=="one")this.one(d,f,e);else{j=0;for(var o=this.length;j0){y=t;break}}t=t[g]}m[q]=y}}}var f=/((?:\((?:\([^()]+\)|[^()]+)+\)|\[(?:\[[^[\]]*\]|['"][^'"]*['"]|[^[\]'"]+)+\]|\\.|[^ >+~,(\[\\]+)+|[>+~])(\s*,\s*)?((?:.|\r|\n)*)/g, +e=0,j=Object.prototype.toString,i=false,o=true;[0,0].sort(function(){o=false;return 0});var k=function(g,h,l,m){l=l||[];var q=h=h||s;if(h.nodeType!==1&&h.nodeType!==9)return[];if(!g||typeof g!=="string")return l;for(var p=[],v,t,y,S,H=true,M=x(h),I=g;(f.exec(""),v=f.exec(I))!==null;){I=v[3];p.push(v[1]);if(v[2]){S=v[3];break}}if(p.length>1&&r.exec(g))if(p.length===2&&n.relative[p[0]])t=ga(p[0]+p[1],h);else for(t=n.relative[p[0]]?[h]:k(p.shift(),h);p.length;){g=p.shift();if(n.relative[g])g+=p.shift(); +t=ga(g,t)}else{if(!m&&p.length>1&&h.nodeType===9&&!M&&n.match.ID.test(p[0])&&!n.match.ID.test(p[p.length-1])){v=k.find(p.shift(),h,M);h=v.expr?k.filter(v.expr,v.set)[0]:v.set[0]}if(h){v=m?{expr:p.pop(),set:z(m)}:k.find(p.pop(),p.length===1&&(p[0]==="~"||p[0]==="+")&&h.parentNode?h.parentNode:h,M);t=v.expr?k.filter(v.expr,v.set):v.set;if(p.length>0)y=z(t);else H=false;for(;p.length;){var D=p.pop();v=D;if(n.relative[D])v=p.pop();else D="";if(v==null)v=h;n.relative[D](y,v,M)}}else y=[]}y||(y=t);y||k.error(D|| +g);if(j.call(y)==="[object Array]")if(H)if(h&&h.nodeType===1)for(g=0;y[g]!=null;g++){if(y[g]&&(y[g]===true||y[g].nodeType===1&&E(h,y[g])))l.push(t[g])}else for(g=0;y[g]!=null;g++)y[g]&&y[g].nodeType===1&&l.push(t[g]);else l.push.apply(l,y);else z(y,l);if(S){k(S,q,l,m);k.uniqueSort(l)}return l};k.uniqueSort=function(g){if(B){i=o;g.sort(B);if(i)for(var h=1;h":function(g,h){var l=typeof h==="string";if(l&&!/\W/.test(h)){h=h.toLowerCase();for(var m=0,q=g.length;m=0))l||m.push(v);else if(l)h[p]=false;return false},ID:function(g){return g[1].replace(/\\/g,"")},TAG:function(g){return g[1].toLowerCase()}, +CHILD:function(g){if(g[1]==="nth"){var h=/(-?)(\d*)n((?:\+|-)?\d*)/.exec(g[2]==="even"&&"2n"||g[2]==="odd"&&"2n+1"||!/\D/.test(g[2])&&"0n+"+g[2]||g[2]);g[2]=h[1]+(h[2]||1)-0;g[3]=h[3]-0}g[0]=e++;return g},ATTR:function(g,h,l,m,q,p){h=g[1].replace(/\\/g,"");if(!p&&n.attrMap[h])g[1]=n.attrMap[h];if(g[2]==="~=")g[4]=" "+g[4]+" ";return g},PSEUDO:function(g,h,l,m,q){if(g[1]==="not")if((f.exec(g[3])||"").length>1||/^\w/.test(g[3]))g[3]=k(g[3],null,null,h);else{g=k.filter(g[3],h,l,true^q);l||m.push.apply(m, +g);return false}else if(n.match.POS.test(g[0])||n.match.CHILD.test(g[0]))return true;return g},POS:function(g){g.unshift(true);return g}},filters:{enabled:function(g){return g.disabled===false&&g.type!=="hidden"},disabled:function(g){return g.disabled===true},checked:function(g){return g.checked===true},selected:function(g){return g.selected===true},parent:function(g){return!!g.firstChild},empty:function(g){return!g.firstChild},has:function(g,h,l){return!!k(l[3],g).length},header:function(g){return/h\d/i.test(g.nodeName)}, +text:function(g){return"text"===g.type},radio:function(g){return"radio"===g.type},checkbox:function(g){return"checkbox"===g.type},file:function(g){return"file"===g.type},password:function(g){return"password"===g.type},submit:function(g){return"submit"===g.type},image:function(g){return"image"===g.type},reset:function(g){return"reset"===g.type},button:function(g){return"button"===g.type||g.nodeName.toLowerCase()==="button"},input:function(g){return/input|select|textarea|button/i.test(g.nodeName)}}, +setFilters:{first:function(g,h){return h===0},last:function(g,h,l,m){return h===m.length-1},even:function(g,h){return h%2===0},odd:function(g,h){return h%2===1},lt:function(g,h,l){return hl[3]-0},nth:function(g,h,l){return l[3]-0===h},eq:function(g,h,l){return l[3]-0===h}},filter:{PSEUDO:function(g,h,l,m){var q=h[1],p=n.filters[q];if(p)return p(g,l,h,m);else if(q==="contains")return(g.textContent||g.innerText||a([g])||"").indexOf(h[3])>=0;else if(q==="not"){h= +h[3];l=0;for(m=h.length;l=0}},ID:function(g,h){return g.nodeType===1&&g.getAttribute("id")===h},TAG:function(g,h){return h==="*"&&g.nodeType===1||g.nodeName.toLowerCase()===h},CLASS:function(g,h){return(" "+(g.className||g.getAttribute("class"))+" ").indexOf(h)>-1},ATTR:function(g,h){var l=h[1];g=n.attrHandle[l]?n.attrHandle[l](g):g[l]!=null?g[l]:g.getAttribute(l);l=g+"";var m=h[2];h=h[4];return g==null?m==="!=":m=== +"="?l===h:m==="*="?l.indexOf(h)>=0:m==="~="?(" "+l+" ").indexOf(h)>=0:!h?l&&g!==false:m==="!="?l!==h:m==="^="?l.indexOf(h)===0:m==="$="?l.substr(l.length-h.length)===h:m==="|="?l===h||l.substr(0,h.length+1)===h+"-":false},POS:function(g,h,l,m){var q=n.setFilters[h[2]];if(q)return q(g,l,h,m)}}},r=n.match.POS;for(var u in n.match){n.match[u]=new RegExp(n.match[u].source+/(?![^\[]*\])(?![^\(]*\))/.source);n.leftMatch[u]=new RegExp(/(^(?:.|\r|\n)*?)/.source+n.match[u].source.replace(/\\(\d+)/g,function(g, +h){return"\\"+(h-0+1)}))}var z=function(g,h){g=Array.prototype.slice.call(g,0);if(h){h.push.apply(h,g);return h}return g};try{Array.prototype.slice.call(s.documentElement.childNodes,0)}catch(C){z=function(g,h){h=h||[];if(j.call(g)==="[object Array]")Array.prototype.push.apply(h,g);else if(typeof g.length==="number")for(var l=0,m=g.length;l";var l=s.documentElement;l.insertBefore(g,l.firstChild);if(s.getElementById(h)){n.find.ID=function(m,q,p){if(typeof q.getElementById!=="undefined"&&!p)return(q=q.getElementById(m[1]))?q.id===m[1]||typeof q.getAttributeNode!=="undefined"&& +q.getAttributeNode("id").nodeValue===m[1]?[q]:w:[]};n.filter.ID=function(m,q){var p=typeof m.getAttributeNode!=="undefined"&&m.getAttributeNode("id");return m.nodeType===1&&p&&p.nodeValue===q}}l.removeChild(g);l=g=null})();(function(){var g=s.createElement("div");g.appendChild(s.createComment(""));if(g.getElementsByTagName("*").length>0)n.find.TAG=function(h,l){l=l.getElementsByTagName(h[1]);if(h[1]==="*"){h=[];for(var m=0;l[m];m++)l[m].nodeType===1&&h.push(l[m]);l=h}return l};g.innerHTML=""; +if(g.firstChild&&typeof g.firstChild.getAttribute!=="undefined"&&g.firstChild.getAttribute("href")!=="#")n.attrHandle.href=function(h){return h.getAttribute("href",2)};g=null})();s.querySelectorAll&&function(){var g=k,h=s.createElement("div");h.innerHTML="

    ";if(!(h.querySelectorAll&&h.querySelectorAll(".TEST").length===0)){k=function(m,q,p,v){q=q||s;if(!v&&q.nodeType===9&&!x(q))try{return z(q.querySelectorAll(m),p)}catch(t){}return g(m,q,p,v)};for(var l in g)k[l]=g[l];h=null}}(); +(function(){var g=s.createElement("div");g.innerHTML="
    ";if(!(!g.getElementsByClassName||g.getElementsByClassName("e").length===0)){g.lastChild.className="e";if(g.getElementsByClassName("e").length!==1){n.order.splice(1,0,"CLASS");n.find.CLASS=function(h,l,m){if(typeof l.getElementsByClassName!=="undefined"&&!m)return l.getElementsByClassName(h[1])};g=null}}})();var E=s.compareDocumentPosition?function(g,h){return!!(g.compareDocumentPosition(h)&16)}: +function(g,h){return g!==h&&(g.contains?g.contains(h):true)},x=function(g){return(g=(g?g.ownerDocument||g:0).documentElement)?g.nodeName!=="HTML":false},ga=function(g,h){var l=[],m="",q;for(h=h.nodeType?[h]:h;q=n.match.PSEUDO.exec(g);){m+=q[0];g=g.replace(n.match.PSEUDO,"")}g=n.relative[g]?g+"*":g;q=0;for(var p=h.length;q=0===d})};c.fn.extend({find:function(a){for(var b=this.pushStack("","find",a),d=0,f=0,e=this.length;f0)for(var j=d;j0},closest:function(a,b){if(c.isArray(a)){var d=[],f=this[0],e,j= +{},i;if(f&&a.length){e=0;for(var o=a.length;e-1:c(f).is(e)){d.push({selector:i,elem:f});delete j[i]}}f=f.parentNode}}return d}var k=c.expr.match.POS.test(a)?c(a,b||this.context):null;return this.map(function(n,r){for(;r&&r.ownerDocument&&r!==b;){if(k?k.index(r)>-1:c(r).is(a))return r;r=r.parentNode}return null})},index:function(a){if(!a||typeof a=== +"string")return c.inArray(this[0],a?c(a):this.parent().children());return c.inArray(a.jquery?a[0]:a,this)},add:function(a,b){a=typeof a==="string"?c(a,b||this.context):c.makeArray(a);b=c.merge(this.get(),a);return this.pushStack(qa(a[0])||qa(b[0])?b:c.unique(b))},andSelf:function(){return this.add(this.prevObject)}});c.each({parent:function(a){return(a=a.parentNode)&&a.nodeType!==11?a:null},parents:function(a){return c.dir(a,"parentNode")},parentsUntil:function(a,b,d){return c.dir(a,"parentNode", +d)},next:function(a){return c.nth(a,2,"nextSibling")},prev:function(a){return c.nth(a,2,"previousSibling")},nextAll:function(a){return c.dir(a,"nextSibling")},prevAll:function(a){return c.dir(a,"previousSibling")},nextUntil:function(a,b,d){return c.dir(a,"nextSibling",d)},prevUntil:function(a,b,d){return c.dir(a,"previousSibling",d)},siblings:function(a){return c.sibling(a.parentNode.firstChild,a)},children:function(a){return c.sibling(a.firstChild)},contents:function(a){return c.nodeName(a,"iframe")? +a.contentDocument||a.contentWindow.document:c.makeArray(a.childNodes)}},function(a,b){c.fn[a]=function(d,f){var e=c.map(this,b,d);eb.test(a)||(f=d);if(f&&typeof f==="string")e=c.filter(f,e);e=this.length>1?c.unique(e):e;if((this.length>1||gb.test(f))&&fb.test(a))e=e.reverse();return this.pushStack(e,a,R.call(arguments).join(","))}});c.extend({filter:function(a,b,d){if(d)a=":not("+a+")";return c.find.matches(a,b)},dir:function(a,b,d){var f=[];for(a=a[b];a&&a.nodeType!==9&&(d===w||a.nodeType!==1||!c(a).is(d));){a.nodeType=== +1&&f.push(a);a=a[b]}return f},nth:function(a,b,d){b=b||1;for(var f=0;a;a=a[d])if(a.nodeType===1&&++f===b)break;return a},sibling:function(a,b){for(var d=[];a;a=a.nextSibling)a.nodeType===1&&a!==b&&d.push(a);return d}});var Ja=/ jQuery\d+="(?:\d+|null)"/g,V=/^\s+/,Ka=/(<([\w:]+)[^>]*?)\/>/g,hb=/^(?:area|br|col|embed|hr|img|input|link|meta|param)$/i,La=/<([\w:]+)/,ib=/"},F={option:[1,""],legend:[1,"
    ","
    "],thead:[1,"","
    "],tr:[2,"","
    "],td:[3,"","
    "],col:[2,"","
    "],area:[1,"",""],_default:[0,"",""]};F.optgroup=F.option;F.tbody=F.tfoot=F.colgroup=F.caption=F.thead;F.th=F.td;if(!c.support.htmlSerialize)F._default=[1,"div
    ","
    "];c.fn.extend({text:function(a){if(c.isFunction(a))return this.each(function(b){var d= +c(this);d.text(a.call(this,b,d.text()))});if(typeof a!=="object"&&a!==w)return this.empty().append((this[0]&&this[0].ownerDocument||s).createTextNode(a));return c.text(this)},wrapAll:function(a){if(c.isFunction(a))return this.each(function(d){c(this).wrapAll(a.call(this,d))});if(this[0]){var b=c(a,this[0].ownerDocument).eq(0).clone(true);this[0].parentNode&&b.insertBefore(this[0]);b.map(function(){for(var d=this;d.firstChild&&d.firstChild.nodeType===1;)d=d.firstChild;return d}).append(this)}return this}, +wrapInner:function(a){if(c.isFunction(a))return this.each(function(b){c(this).wrapInner(a.call(this,b))});return this.each(function(){var b=c(this),d=b.contents();d.length?d.wrapAll(a):b.append(a)})},wrap:function(a){return this.each(function(){c(this).wrapAll(a)})},unwrap:function(){return this.parent().each(function(){c.nodeName(this,"body")||c(this).replaceWith(this.childNodes)}).end()},append:function(){return this.domManip(arguments,true,function(a){this.nodeType===1&&this.appendChild(a)})}, +prepend:function(){return this.domManip(arguments,true,function(a){this.nodeType===1&&this.insertBefore(a,this.firstChild)})},before:function(){if(this[0]&&this[0].parentNode)return this.domManip(arguments,false,function(b){this.parentNode.insertBefore(b,this)});else if(arguments.length){var a=c(arguments[0]);a.push.apply(a,this.toArray());return this.pushStack(a,"before",arguments)}},after:function(){if(this[0]&&this[0].parentNode)return this.domManip(arguments,false,function(b){this.parentNode.insertBefore(b, +this.nextSibling)});else if(arguments.length){var a=this.pushStack(this,"after",arguments);a.push.apply(a,c(arguments[0]).toArray());return a}},remove:function(a,b){for(var d=0,f;(f=this[d])!=null;d++)if(!a||c.filter(a,[f]).length){if(!b&&f.nodeType===1){c.cleanData(f.getElementsByTagName("*"));c.cleanData([f])}f.parentNode&&f.parentNode.removeChild(f)}return this},empty:function(){for(var a=0,b;(b=this[a])!=null;a++)for(b.nodeType===1&&c.cleanData(b.getElementsByTagName("*"));b.firstChild;)b.removeChild(b.firstChild); +return this},clone:function(a){var b=this.map(function(){if(!c.support.noCloneEvent&&!c.isXMLDoc(this)){var d=this.outerHTML,f=this.ownerDocument;if(!d){d=f.createElement("div");d.appendChild(this.cloneNode(true));d=d.innerHTML}return c.clean([d.replace(Ja,"").replace(/=([^="'>\s]+\/)>/g,'="$1">').replace(V,"")],f)[0]}else return this.cloneNode(true)});if(a===true){ra(this,b);ra(this.find("*"),b.find("*"))}return b},html:function(a){if(a===w)return this[0]&&this[0].nodeType===1?this[0].innerHTML.replace(Ja, +""):null;else if(typeof a==="string"&&!ta.test(a)&&(c.support.leadingWhitespace||!V.test(a))&&!F[(La.exec(a)||["",""])[1].toLowerCase()]){a=a.replace(Ka,Ma);try{for(var b=0,d=this.length;b0||e.cacheable||this.length>1?k.cloneNode(true):k)}o.length&&c.each(o,Qa)}return this}});c.fragments={};c.each({appendTo:"append",prependTo:"prepend",insertBefore:"before",insertAfter:"after",replaceAll:"replaceWith"},function(a,b){c.fn[a]=function(d){var f=[];d=c(d);var e=this.length===1&&this[0].parentNode;if(e&&e.nodeType===11&&e.childNodes.length===1&&d.length===1){d[b](this[0]); +return this}else{e=0;for(var j=d.length;e0?this.clone(true):this).get();c.fn[b].apply(c(d[e]),i);f=f.concat(i)}return this.pushStack(f,a,d.selector)}}});c.extend({clean:function(a,b,d,f){b=b||s;if(typeof b.createElement==="undefined")b=b.ownerDocument||b[0]&&b[0].ownerDocument||s;for(var e=[],j=0,i;(i=a[j])!=null;j++){if(typeof i==="number")i+="";if(i){if(typeof i==="string"&&!jb.test(i))i=b.createTextNode(i);else if(typeof i==="string"){i=i.replace(Ka,Ma);var o=(La.exec(i)||["", +""])[1].toLowerCase(),k=F[o]||F._default,n=k[0],r=b.createElement("div");for(r.innerHTML=k[1]+i+k[2];n--;)r=r.lastChild;if(!c.support.tbody){n=ib.test(i);o=o==="table"&&!n?r.firstChild&&r.firstChild.childNodes:k[1]===""&&!n?r.childNodes:[];for(k=o.length-1;k>=0;--k)c.nodeName(o[k],"tbody")&&!o[k].childNodes.length&&o[k].parentNode.removeChild(o[k])}!c.support.leadingWhitespace&&V.test(i)&&r.insertBefore(b.createTextNode(V.exec(i)[0]),r.firstChild);i=r.childNodes}if(i.nodeType)e.push(i);else e= +c.merge(e,i)}}if(d)for(j=0;e[j];j++)if(f&&c.nodeName(e[j],"script")&&(!e[j].type||e[j].type.toLowerCase()==="text/javascript"))f.push(e[j].parentNode?e[j].parentNode.removeChild(e[j]):e[j]);else{e[j].nodeType===1&&e.splice.apply(e,[j+1,0].concat(c.makeArray(e[j].getElementsByTagName("script"))));d.appendChild(e[j])}return e},cleanData:function(a){for(var b,d,f=c.cache,e=c.event.special,j=c.support.deleteExpando,i=0,o;(o=a[i])!=null;i++)if(d=o[c.expando]){b=f[d];if(b.events)for(var k in b.events)e[k]? +c.event.remove(o,k):Ca(o,k,b.handle);if(j)delete o[c.expando];else o.removeAttribute&&o.removeAttribute(c.expando);delete f[d]}}});var kb=/z-?index|font-?weight|opacity|zoom|line-?height/i,Na=/alpha\([^)]*\)/,Oa=/opacity=([^)]*)/,ha=/float/i,ia=/-([a-z])/ig,lb=/([A-Z])/g,mb=/^-?\d+(?:px)?$/i,nb=/^-?\d/,ob={position:"absolute",visibility:"hidden",display:"block"},pb=["Left","Right"],qb=["Top","Bottom"],rb=s.defaultView&&s.defaultView.getComputedStyle,Pa=c.support.cssFloat?"cssFloat":"styleFloat",ja= +function(a,b){return b.toUpperCase()};c.fn.css=function(a,b){return X(this,a,b,true,function(d,f,e){if(e===w)return c.curCSS(d,f);if(typeof e==="number"&&!kb.test(f))e+="px";c.style(d,f,e)})};c.extend({style:function(a,b,d){if(!a||a.nodeType===3||a.nodeType===8)return w;if((b==="width"||b==="height")&&parseFloat(d)<0)d=w;var f=a.style||a,e=d!==w;if(!c.support.opacity&&b==="opacity"){if(e){f.zoom=1;b=parseInt(d,10)+""==="NaN"?"":"alpha(opacity="+d*100+")";a=f.filter||c.curCSS(a,"filter")||"";f.filter= +Na.test(a)?a.replace(Na,b):b}return f.filter&&f.filter.indexOf("opacity=")>=0?parseFloat(Oa.exec(f.filter)[1])/100+"":""}if(ha.test(b))b=Pa;b=b.replace(ia,ja);if(e)f[b]=d;return f[b]},css:function(a,b,d,f){if(b==="width"||b==="height"){var e,j=b==="width"?pb:qb;function i(){e=b==="width"?a.offsetWidth:a.offsetHeight;f!=="border"&&c.each(j,function(){f||(e-=parseFloat(c.curCSS(a,"padding"+this,true))||0);if(f==="margin")e+=parseFloat(c.curCSS(a,"margin"+this,true))||0;else e-=parseFloat(c.curCSS(a, +"border"+this+"Width",true))||0})}a.offsetWidth!==0?i():c.swap(a,ob,i);return Math.max(0,Math.round(e))}return c.curCSS(a,b,d)},curCSS:function(a,b,d){var f,e=a.style;if(!c.support.opacity&&b==="opacity"&&a.currentStyle){f=Oa.test(a.currentStyle.filter||"")?parseFloat(RegExp.$1)/100+"":"";return f===""?"1":f}if(ha.test(b))b=Pa;if(!d&&e&&e[b])f=e[b];else if(rb){if(ha.test(b))b="float";b=b.replace(lb,"-$1").toLowerCase();e=a.ownerDocument.defaultView;if(!e)return null;if(a=e.getComputedStyle(a,null))f= +a.getPropertyValue(b);if(b==="opacity"&&f==="")f="1"}else if(a.currentStyle){d=b.replace(ia,ja);f=a.currentStyle[b]||a.currentStyle[d];if(!mb.test(f)&&nb.test(f)){b=e.left;var j=a.runtimeStyle.left;a.runtimeStyle.left=a.currentStyle.left;e.left=d==="fontSize"?"1em":f||0;f=e.pixelLeft+"px";e.left=b;a.runtimeStyle.left=j}}return f},swap:function(a,b,d){var f={};for(var e in b){f[e]=a.style[e];a.style[e]=b[e]}d.call(a);for(e in b)a.style[e]=f[e]}});if(c.expr&&c.expr.filters){c.expr.filters.hidden=function(a){var b= +a.offsetWidth,d=a.offsetHeight,f=a.nodeName.toLowerCase()==="tr";return b===0&&d===0&&!f?true:b>0&&d>0&&!f?false:c.curCSS(a,"display")==="none"};c.expr.filters.visible=function(a){return!c.expr.filters.hidden(a)}}var sb=J(),tb=//gi,ub=/select|textarea/i,vb=/color|date|datetime|email|hidden|month|number|password|range|search|tel|text|time|url|week/i,N=/=\?(&|$)/,ka=/\?/,wb=/(\?|&)_=.*?(&|$)/,xb=/^(\w+:)?\/\/([^\/?#]+)/,yb=/%20/g,zb=c.fn.load;c.fn.extend({load:function(a,b,d){if(typeof a!== +"string")return zb.call(this,a);else if(!this.length)return this;var f=a.indexOf(" ");if(f>=0){var e=a.slice(f,a.length);a=a.slice(0,f)}f="GET";if(b)if(c.isFunction(b)){d=b;b=null}else if(typeof b==="object"){b=c.param(b,c.ajaxSettings.traditional);f="POST"}var j=this;c.ajax({url:a,type:f,dataType:"html",data:b,complete:function(i,o){if(o==="success"||o==="notmodified")j.html(e?c("
    ").append(i.responseText.replace(tb,"")).find(e):i.responseText);d&&j.each(d,[i.responseText,o,i])}});return this}, +serialize:function(){return c.param(this.serializeArray())},serializeArray:function(){return this.map(function(){return this.elements?c.makeArray(this.elements):this}).filter(function(){return this.name&&!this.disabled&&(this.checked||ub.test(this.nodeName)||vb.test(this.type))}).map(function(a,b){a=c(this).val();return a==null?null:c.isArray(a)?c.map(a,function(d){return{name:b.name,value:d}}):{name:b.name,value:a}}).get()}});c.each("ajaxStart ajaxStop ajaxComplete ajaxError ajaxSuccess ajaxSend".split(" "), +function(a,b){c.fn[b]=function(d){return this.bind(b,d)}});c.extend({get:function(a,b,d,f){if(c.isFunction(b)){f=f||d;d=b;b=null}return c.ajax({type:"GET",url:a,data:b,success:d,dataType:f})},getScript:function(a,b){return c.get(a,null,b,"script")},getJSON:function(a,b,d){return c.get(a,b,d,"json")},post:function(a,b,d,f){if(c.isFunction(b)){f=f||d;d=b;b={}}return c.ajax({type:"POST",url:a,data:b,success:d,dataType:f})},ajaxSetup:function(a){c.extend(c.ajaxSettings,a)},ajaxSettings:{url:location.href, +global:true,type:"GET",contentType:"application/x-www-form-urlencoded",processData:true,async:true,xhr:A.XMLHttpRequest&&(A.location.protocol!=="file:"||!A.ActiveXObject)?function(){return new A.XMLHttpRequest}:function(){try{return new A.ActiveXObject("Microsoft.XMLHTTP")}catch(a){}},accepts:{xml:"application/xml, text/xml",html:"text/html",script:"text/javascript, application/javascript",json:"application/json, text/javascript",text:"text/plain",_default:"*/*"}},lastModified:{},etag:{},ajax:function(a){function b(){e.success&& +e.success.call(k,o,i,x);e.global&&f("ajaxSuccess",[x,e])}function d(){e.complete&&e.complete.call(k,x,i);e.global&&f("ajaxComplete",[x,e]);e.global&&!--c.active&&c.event.trigger("ajaxStop")}function f(q,p){(e.context?c(e.context):c.event).trigger(q,p)}var e=c.extend(true,{},c.ajaxSettings,a),j,i,o,k=a&&a.context||e,n=e.type.toUpperCase();if(e.data&&e.processData&&typeof e.data!=="string")e.data=c.param(e.data,e.traditional);if(e.dataType==="jsonp"){if(n==="GET")N.test(e.url)||(e.url+=(ka.test(e.url)? +"&":"?")+(e.jsonp||"callback")+"=?");else if(!e.data||!N.test(e.data))e.data=(e.data?e.data+"&":"")+(e.jsonp||"callback")+"=?";e.dataType="json"}if(e.dataType==="json"&&(e.data&&N.test(e.data)||N.test(e.url))){j=e.jsonpCallback||"jsonp"+sb++;if(e.data)e.data=(e.data+"").replace(N,"="+j+"$1");e.url=e.url.replace(N,"="+j+"$1");e.dataType="script";A[j]=A[j]||function(q){o=q;b();d();A[j]=w;try{delete A[j]}catch(p){}z&&z.removeChild(C)}}if(e.dataType==="script"&&e.cache===null)e.cache=false;if(e.cache=== +false&&n==="GET"){var r=J(),u=e.url.replace(wb,"$1_="+r+"$2");e.url=u+(u===e.url?(ka.test(e.url)?"&":"?")+"_="+r:"")}if(e.data&&n==="GET")e.url+=(ka.test(e.url)?"&":"?")+e.data;e.global&&!c.active++&&c.event.trigger("ajaxStart");r=(r=xb.exec(e.url))&&(r[1]&&r[1]!==location.protocol||r[2]!==location.host);if(e.dataType==="script"&&n==="GET"&&r){var z=s.getElementsByTagName("head")[0]||s.documentElement,C=s.createElement("script");C.src=e.url;if(e.scriptCharset)C.charset=e.scriptCharset;if(!j){var B= +false;C.onload=C.onreadystatechange=function(){if(!B&&(!this.readyState||this.readyState==="loaded"||this.readyState==="complete")){B=true;b();d();C.onload=C.onreadystatechange=null;z&&C.parentNode&&z.removeChild(C)}}}z.insertBefore(C,z.firstChild);return w}var E=false,x=e.xhr();if(x){e.username?x.open(n,e.url,e.async,e.username,e.password):x.open(n,e.url,e.async);try{if(e.data||a&&a.contentType)x.setRequestHeader("Content-Type",e.contentType);if(e.ifModified){c.lastModified[e.url]&&x.setRequestHeader("If-Modified-Since", +c.lastModified[e.url]);c.etag[e.url]&&x.setRequestHeader("If-None-Match",c.etag[e.url])}r||x.setRequestHeader("X-Requested-With","XMLHttpRequest");x.setRequestHeader("Accept",e.dataType&&e.accepts[e.dataType]?e.accepts[e.dataType]+", */*":e.accepts._default)}catch(ga){}if(e.beforeSend&&e.beforeSend.call(k,x,e)===false){e.global&&!--c.active&&c.event.trigger("ajaxStop");x.abort();return false}e.global&&f("ajaxSend",[x,e]);var g=x.onreadystatechange=function(q){if(!x||x.readyState===0||q==="abort"){E|| +d();E=true;if(x)x.onreadystatechange=c.noop}else if(!E&&x&&(x.readyState===4||q==="timeout")){E=true;x.onreadystatechange=c.noop;i=q==="timeout"?"timeout":!c.httpSuccess(x)?"error":e.ifModified&&c.httpNotModified(x,e.url)?"notmodified":"success";var p;if(i==="success")try{o=c.httpData(x,e.dataType,e)}catch(v){i="parsererror";p=v}if(i==="success"||i==="notmodified")j||b();else c.handleError(e,x,i,p);d();q==="timeout"&&x.abort();if(e.async)x=null}};try{var h=x.abort;x.abort=function(){x&&h.call(x); +g("abort")}}catch(l){}e.async&&e.timeout>0&&setTimeout(function(){x&&!E&&g("timeout")},e.timeout);try{x.send(n==="POST"||n==="PUT"||n==="DELETE"?e.data:null)}catch(m){c.handleError(e,x,null,m);d()}e.async||g();return x}},handleError:function(a,b,d,f){if(a.error)a.error.call(a.context||a,b,d,f);if(a.global)(a.context?c(a.context):c.event).trigger("ajaxError",[b,a,f])},active:0,httpSuccess:function(a){try{return!a.status&&location.protocol==="file:"||a.status>=200&&a.status<300||a.status===304||a.status=== +1223||a.status===0}catch(b){}return false},httpNotModified:function(a,b){var d=a.getResponseHeader("Last-Modified"),f=a.getResponseHeader("Etag");if(d)c.lastModified[b]=d;if(f)c.etag[b]=f;return a.status===304||a.status===0},httpData:function(a,b,d){var f=a.getResponseHeader("content-type")||"",e=b==="xml"||!b&&f.indexOf("xml")>=0;a=e?a.responseXML:a.responseText;e&&a.documentElement.nodeName==="parsererror"&&c.error("parsererror");if(d&&d.dataFilter)a=d.dataFilter(a,b);if(typeof a==="string")if(b=== +"json"||!b&&f.indexOf("json")>=0)a=c.parseJSON(a);else if(b==="script"||!b&&f.indexOf("javascript")>=0)c.globalEval(a);return a},param:function(a,b){function d(i,o){if(c.isArray(o))c.each(o,function(k,n){b||/\[\]$/.test(i)?f(i,n):d(i+"["+(typeof n==="object"||c.isArray(n)?k:"")+"]",n)});else!b&&o!=null&&typeof o==="object"?c.each(o,function(k,n){d(i+"["+k+"]",n)}):f(i,o)}function f(i,o){o=c.isFunction(o)?o():o;e[e.length]=encodeURIComponent(i)+"="+encodeURIComponent(o)}var e=[];if(b===w)b=c.ajaxSettings.traditional; +if(c.isArray(a)||a.jquery)c.each(a,function(){f(this.name,this.value)});else for(var j in a)d(j,a[j]);return e.join("&").replace(yb,"+")}});var la={},Ab=/toggle|show|hide/,Bb=/^([+-]=)?([\d+-.]+)(.*)$/,W,va=[["height","marginTop","marginBottom","paddingTop","paddingBottom"],["width","marginLeft","marginRight","paddingLeft","paddingRight"],["opacity"]];c.fn.extend({show:function(a,b){if(a||a===0)return this.animate(K("show",3),a,b);else{a=0;for(b=this.length;a").appendTo("body");f=e.css("display");if(f==="none")f="block";e.remove();la[d]=f}c.data(this[a],"olddisplay",f)}}a=0;for(b=this.length;a=0;f--)if(d[f].elem===this){b&&d[f](true);d.splice(f,1)}});b||this.dequeue();return this}});c.each({slideDown:K("show",1),slideUp:K("hide",1),slideToggle:K("toggle",1),fadeIn:{opacity:"show"},fadeOut:{opacity:"hide"}},function(a,b){c.fn[a]=function(d,f){return this.animate(b,d,f)}});c.extend({speed:function(a,b,d){var f=a&&typeof a==="object"?a:{complete:d||!d&&b||c.isFunction(a)&&a,duration:a,easing:d&&b||b&&!c.isFunction(b)&&b};f.duration=c.fx.off?0:typeof f.duration=== +"number"?f.duration:c.fx.speeds[f.duration]||c.fx.speeds._default;f.old=f.complete;f.complete=function(){f.queue!==false&&c(this).dequeue();c.isFunction(f.old)&&f.old.call(this)};return f},easing:{linear:function(a,b,d,f){return d+f*a},swing:function(a,b,d,f){return(-Math.cos(a*Math.PI)/2+0.5)*f+d}},timers:[],fx:function(a,b,d){this.options=b;this.elem=a;this.prop=d;if(!b.orig)b.orig={}}});c.fx.prototype={update:function(){this.options.step&&this.options.step.call(this.elem,this.now,this);(c.fx.step[this.prop]|| +c.fx.step._default)(this);if((this.prop==="height"||this.prop==="width")&&this.elem.style)this.elem.style.display="block"},cur:function(a){if(this.elem[this.prop]!=null&&(!this.elem.style||this.elem.style[this.prop]==null))return this.elem[this.prop];return(a=parseFloat(c.css(this.elem,this.prop,a)))&&a>-10000?a:parseFloat(c.curCSS(this.elem,this.prop))||0},custom:function(a,b,d){function f(j){return e.step(j)}this.startTime=J();this.start=a;this.end=b;this.unit=d||this.unit||"px";this.now=this.start; +this.pos=this.state=0;var e=this;f.elem=this.elem;if(f()&&c.timers.push(f)&&!W)W=setInterval(c.fx.tick,13)},show:function(){this.options.orig[this.prop]=c.style(this.elem,this.prop);this.options.show=true;this.custom(this.prop==="width"||this.prop==="height"?1:0,this.cur());c(this.elem).show()},hide:function(){this.options.orig[this.prop]=c.style(this.elem,this.prop);this.options.hide=true;this.custom(this.cur(),0)},step:function(a){var b=J(),d=true;if(a||b>=this.options.duration+this.startTime){this.now= +this.end;this.pos=this.state=1;this.update();this.options.curAnim[this.prop]=true;for(var f in this.options.curAnim)if(this.options.curAnim[f]!==true)d=false;if(d){if(this.options.display!=null){this.elem.style.overflow=this.options.overflow;a=c.data(this.elem,"olddisplay");this.elem.style.display=a?a:this.options.display;if(c.css(this.elem,"display")==="none")this.elem.style.display="block"}this.options.hide&&c(this.elem).hide();if(this.options.hide||this.options.show)for(var e in this.options.curAnim)c.style(this.elem, +e,this.options.orig[e]);this.options.complete.call(this.elem)}return false}else{e=b-this.startTime;this.state=e/this.options.duration;a=this.options.easing||(c.easing.swing?"swing":"linear");this.pos=c.easing[this.options.specialEasing&&this.options.specialEasing[this.prop]||a](this.state,e,0,1,this.options.duration);this.now=this.start+(this.end-this.start)*this.pos;this.update()}return true}};c.extend(c.fx,{tick:function(){for(var a=c.timers,b=0;b
    "; +a.insertBefore(b,a.firstChild);d=b.firstChild;f=d.firstChild;e=d.nextSibling.firstChild.firstChild;this.doesNotAddBorder=f.offsetTop!==5;this.doesAddBorderForTableAndCells=e.offsetTop===5;f.style.position="fixed";f.style.top="20px";this.supportsFixedPosition=f.offsetTop===20||f.offsetTop===15;f.style.position=f.style.top="";d.style.overflow="hidden";d.style.position="relative";this.subtractsBorderForOverflowNotVisible=f.offsetTop===-5;this.doesNotIncludeMarginInBodyOffset=a.offsetTop!==j;a.removeChild(b); +c.offset.initialize=c.noop},bodyOffset:function(a){var b=a.offsetTop,d=a.offsetLeft;c.offset.initialize();if(c.offset.doesNotIncludeMarginInBodyOffset){b+=parseFloat(c.curCSS(a,"marginTop",true))||0;d+=parseFloat(c.curCSS(a,"marginLeft",true))||0}return{top:b,left:d}},setOffset:function(a,b,d){if(/static/.test(c.curCSS(a,"position")))a.style.position="relative";var f=c(a),e=f.offset(),j=parseInt(c.curCSS(a,"top",true),10)||0,i=parseInt(c.curCSS(a,"left",true),10)||0;if(c.isFunction(b))b=b.call(a, +d,e);d={top:b.top-e.top+j,left:b.left-e.left+i};"using"in b?b.using.call(a,d):f.css(d)}};c.fn.extend({position:function(){if(!this[0])return null;var a=this[0],b=this.offsetParent(),d=this.offset(),f=/^body|html$/i.test(b[0].nodeName)?{top:0,left:0}:b.offset();d.top-=parseFloat(c.curCSS(a,"marginTop",true))||0;d.left-=parseFloat(c.curCSS(a,"marginLeft",true))||0;f.top+=parseFloat(c.curCSS(b[0],"borderTopWidth",true))||0;f.left+=parseFloat(c.curCSS(b[0],"borderLeftWidth",true))||0;return{top:d.top- +f.top,left:d.left-f.left}},offsetParent:function(){return this.map(function(){for(var a=this.offsetParent||s.body;a&&!/^body|html$/i.test(a.nodeName)&&c.css(a,"position")==="static";)a=a.offsetParent;return a})}});c.each(["Left","Top"],function(a,b){var d="scroll"+b;c.fn[d]=function(f){var e=this[0],j;if(!e)return null;if(f!==w)return this.each(function(){if(j=wa(this))j.scrollTo(!a?f:c(j).scrollLeft(),a?f:c(j).scrollTop());else this[d]=f});else return(j=wa(e))?"pageXOffset"in j?j[a?"pageYOffset": +"pageXOffset"]:c.support.boxModel&&j.document.documentElement[d]||j.document.body[d]:e[d]}});c.each(["Height","Width"],function(a,b){var d=b.toLowerCase();c.fn["inner"+b]=function(){return this[0]?c.css(this[0],d,false,"padding"):null};c.fn["outer"+b]=function(f){return this[0]?c.css(this[0],d,false,f?"margin":"border"):null};c.fn[d]=function(f){var e=this[0];if(!e)return f==null?null:this;if(c.isFunction(f))return this.each(function(j){var i=c(this);i[d](f.call(this,j,i[d]()))});return"scrollTo"in +e&&e.document?e.document.compatMode==="CSS1Compat"&&e.document.documentElement["client"+b]||e.document.body["client"+b]:e.nodeType===9?Math.max(e.documentElement["client"+b],e.body["scroll"+b],e.documentElement["scroll"+b],e.body["offset"+b],e.documentElement["offset"+b]):f===w?c.css(e,d):this.css(d,typeof f==="string"?f:f+"px")}});A.jQuery=A.$=c})(window); diff --git a/docs/html/_static/minus.png b/docs/html/_static/minus.png new file mode 100644 index 0000000000000000000000000000000000000000..da1c5620d10c047525a467a425abe9ff5269cfc2 GIT binary patch literal 199 zcmeAS@N?(olHy`uVBq!ia0vp^+#t-s1SHkYJtzcHoCO|{#XvD(5N2eUHAey{$X?>< z>&kweokM_|(Po{+Q=kw>iEBiObAE1aYF-J$w=>iB1I2R$WLpMkF=>bh=@O1TaS?83{1OVknK< z>&kweokM`jkU7Va11Q8%;u=xnoS&PUnpeW`?aZ|OK(QcC7sn8Z%gHvy&v=;Q4jejg zV8NnAO`-4Z@2~&zopr02WF_WB>pF literal 0 HcmV?d00001 diff --git a/docs/html/_static/pygments.css b/docs/html/_static/pygments.css new file mode 100644 index 0000000..f07b654 --- /dev/null +++ b/docs/html/_static/pygments.css @@ -0,0 +1,62 @@ +.highlight .hll { background-color: #ffffcc } +.highlight { background: #f0f0f0; } +.highlight .c { color: #60a0b0; font-style: italic } /* Comment */ +.highlight .err { border: 1px solid #FF0000 } /* Error */ +.highlight .k { color: #007020; font-weight: bold } /* Keyword */ +.highlight .o { color: #666666 } /* Operator */ +.highlight .cm { color: #60a0b0; font-style: italic } /* Comment.Multiline */ +.highlight .cp { color: #007020 } /* Comment.Preproc */ +.highlight .c1 { color: #60a0b0; font-style: italic } /* Comment.Single */ +.highlight .cs { color: #60a0b0; background-color: #fff0f0 } /* Comment.Special */ +.highlight .gd { color: #A00000 } /* Generic.Deleted */ +.highlight .ge { font-style: italic } /* Generic.Emph */ +.highlight .gr { color: #FF0000 } /* Generic.Error */ +.highlight .gh { color: #000080; font-weight: bold } /* Generic.Heading */ +.highlight .gi { color: #00A000 } /* Generic.Inserted */ +.highlight .go { color: #808080 } /* Generic.Output */ +.highlight .gp { color: #c65d09; font-weight: bold } /* Generic.Prompt */ +.highlight .gs { font-weight: bold } /* Generic.Strong */ +.highlight .gu { color: #800080; font-weight: bold } /* Generic.Subheading */ +.highlight .gt { color: #0040D0 } /* Generic.Traceback */ +.highlight .kc { color: #007020; font-weight: bold } /* Keyword.Constant */ +.highlight .kd { color: #007020; font-weight: bold } /* Keyword.Declaration */ +.highlight .kn { color: #007020; font-weight: bold } /* Keyword.Namespace */ +.highlight .kp { color: #007020 } /* Keyword.Pseudo */ +.highlight .kr { color: #007020; font-weight: bold } /* Keyword.Reserved */ +.highlight .kt { color: #902000 } /* Keyword.Type */ +.highlight .m { color: #40a070 } /* Literal.Number */ +.highlight .s { color: #4070a0 } /* Literal.String */ +.highlight .na { color: #4070a0 } /* Name.Attribute */ +.highlight .nb { color: #007020 } /* Name.Builtin */ +.highlight .nc { color: #0e84b5; font-weight: bold } /* Name.Class */ +.highlight .no { color: #60add5 } /* Name.Constant */ +.highlight .nd { color: #555555; font-weight: bold } /* Name.Decorator */ +.highlight .ni { color: #d55537; font-weight: bold } /* Name.Entity */ +.highlight .ne { color: #007020 } /* Name.Exception */ +.highlight .nf { color: #06287e } /* Name.Function */ +.highlight .nl { color: #002070; font-weight: bold } /* Name.Label */ +.highlight .nn { color: #0e84b5; font-weight: bold } /* Name.Namespace */ +.highlight .nt { color: #062873; font-weight: bold } /* Name.Tag */ +.highlight .nv { color: #bb60d5 } /* Name.Variable */ +.highlight .ow { color: #007020; font-weight: bold } /* Operator.Word */ +.highlight .w { color: #bbbbbb } /* Text.Whitespace */ +.highlight .mf { color: #40a070 } /* Literal.Number.Float */ +.highlight .mh { color: #40a070 } /* Literal.Number.Hex */ +.highlight .mi { color: #40a070 } /* Literal.Number.Integer */ +.highlight .mo { color: #40a070 } /* Literal.Number.Oct */ +.highlight .sb { color: #4070a0 } /* Literal.String.Backtick */ +.highlight .sc { color: #4070a0 } /* Literal.String.Char */ +.highlight .sd { color: #4070a0; font-style: italic } /* Literal.String.Doc */ +.highlight .s2 { color: #4070a0 } /* Literal.String.Double */ +.highlight .se { color: #4070a0; font-weight: bold } /* Literal.String.Escape */ +.highlight .sh { color: #4070a0 } /* Literal.String.Heredoc */ +.highlight .si { color: #70a0d0; font-style: italic } /* Literal.String.Interpol */ +.highlight .sx { color: #c65d09 } /* Literal.String.Other */ +.highlight .sr { color: #235388 } /* Literal.String.Regex */ +.highlight .s1 { color: #4070a0 } /* Literal.String.Single */ +.highlight .ss { color: #517918 } /* Literal.String.Symbol */ +.highlight .bp { color: #007020 } /* Name.Builtin.Pseudo */ +.highlight .vc { color: #bb60d5 } /* Name.Variable.Class */ +.highlight .vg { color: #bb60d5 } /* Name.Variable.Global */ +.highlight .vi { color: #bb60d5 } /* Name.Variable.Instance */ +.highlight .il { color: #40a070 } /* Literal.Number.Integer.Long */ \ No newline at end of file diff --git a/docs/html/_static/searchtools.js b/docs/html/_static/searchtools.js new file mode 100644 index 0000000..dae92b5 --- /dev/null +++ b/docs/html/_static/searchtools.js @@ -0,0 +1,518 @@ +/* + * searchtools.js + * ~~~~~~~~~~~~~~ + * + * Sphinx JavaScript utilties for the full-text search. + * + * :copyright: Copyright 2007-2011 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +/** + * helper function to return a node containing the + * search summary for a given text. keywords is a list + * of stemmed words, hlwords is the list of normal, unstemmed + * words. the first one is used to find the occurance, the + * latter for highlighting it. + */ + +jQuery.makeSearchSummary = function(text, keywords, hlwords) { + var textLower = text.toLowerCase(); + var start = 0; + $.each(keywords, function() { + var i = textLower.indexOf(this.toLowerCase()); + if (i > -1) + start = i; + }); + start = Math.max(start - 120, 0); + var excerpt = ((start > 0) ? '...' : '') + + $.trim(text.substr(start, 240)) + + ((start + 240 - text.length) ? '...' : ''); + var rv = $('
    ').text(excerpt); + $.each(hlwords, function() { + rv = rv.highlightText(this, 'highlighted'); + }); + return rv; +} + +/** + * Porter Stemmer + */ +var PorterStemmer = function() { + + var step2list = { + ational: 'ate', + tional: 'tion', + enci: 'ence', + anci: 'ance', + izer: 'ize', + bli: 'ble', + alli: 'al', + entli: 'ent', + eli: 'e', + ousli: 'ous', + ization: 'ize', + ation: 'ate', + ator: 'ate', + alism: 'al', + iveness: 'ive', + fulness: 'ful', + ousness: 'ous', + aliti: 'al', + iviti: 'ive', + biliti: 'ble', + logi: 'log' + }; + + var step3list = { + icate: 'ic', + ative: '', + alize: 'al', + iciti: 'ic', + ical: 'ic', + ful: '', + ness: '' + }; + + var c = "[^aeiou]"; // consonant + var v = "[aeiouy]"; // vowel + var C = c + "[^aeiouy]*"; // consonant sequence + var V = v + "[aeiou]*"; // vowel sequence + + var mgr0 = "^(" + C + ")?" + V + C; // [C]VC... is m>0 + var meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$"; // [C]VC[V] is m=1 + var mgr1 = "^(" + C + ")?" + V + C + V + C; // [C]VCVC... is m>1 + var s_v = "^(" + C + ")?" + v; // vowel in stem + + this.stemWord = function (w) { + var stem; + var suffix; + var firstch; + var origword = w; + + if (w.length < 3) + return w; + + var re; + var re2; + var re3; + var re4; + + firstch = w.substr(0,1); + if (firstch == "y") + w = firstch.toUpperCase() + w.substr(1); + + // Step 1a + re = /^(.+?)(ss|i)es$/; + re2 = /^(.+?)([^s])s$/; + + if (re.test(w)) + w = w.replace(re,"$1$2"); + else if (re2.test(w)) + w = w.replace(re2,"$1$2"); + + // Step 1b + re = /^(.+?)eed$/; + re2 = /^(.+?)(ed|ing)$/; + if (re.test(w)) { + var fp = re.exec(w); + re = new RegExp(mgr0); + if (re.test(fp[1])) { + re = /.$/; + w = w.replace(re,""); + } + } + else if (re2.test(w)) { + var fp = re2.exec(w); + stem = fp[1]; + re2 = new RegExp(s_v); + if (re2.test(stem)) { + w = stem; + re2 = /(at|bl|iz)$/; + re3 = new RegExp("([^aeiouylsz])\\1$"); + re4 = new RegExp("^" + C + v + "[^aeiouwxy]$"); + if (re2.test(w)) + w = w + "e"; + else if (re3.test(w)) { + re = /.$/; + w = w.replace(re,""); + } + else if (re4.test(w)) + w = w + "e"; + } + } + + // Step 1c + re = /^(.+?)y$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + re = new RegExp(s_v); + if (re.test(stem)) + w = stem + "i"; + } + + // Step 2 + re = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + suffix = fp[2]; + re = new RegExp(mgr0); + if (re.test(stem)) + w = stem + step2list[suffix]; + } + + // Step 3 + re = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + suffix = fp[2]; + re = new RegExp(mgr0); + if (re.test(stem)) + w = stem + step3list[suffix]; + } + + // Step 4 + re = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/; + re2 = /^(.+?)(s|t)(ion)$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + re = new RegExp(mgr1); + if (re.test(stem)) + w = stem; + } + else if (re2.test(w)) { + var fp = re2.exec(w); + stem = fp[1] + fp[2]; + re2 = new RegExp(mgr1); + if (re2.test(stem)) + w = stem; + } + + // Step 5 + re = /^(.+?)e$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + re = new RegExp(mgr1); + re2 = new RegExp(meq1); + re3 = new RegExp("^" + C + v + "[^aeiouwxy]$"); + if (re.test(stem) || (re2.test(stem) && !(re3.test(stem)))) + w = stem; + } + re = /ll$/; + re2 = new RegExp(mgr1); + if (re.test(w) && re2.test(w)) { + re = /.$/; + w = w.replace(re,""); + } + + // and turn initial Y back to y + if (firstch == "y") + w = firstch.toLowerCase() + w.substr(1); + return w; + } +} + + +/** + * Search Module + */ +var Search = { + + _index : null, + _queued_query : null, + _pulse_status : -1, + + init : function() { + var params = $.getQueryParameters(); + if (params.q) { + var query = params.q[0]; + $('input[name="q"]')[0].value = query; + this.performSearch(query); + } + }, + + loadIndex : function(url) { + $.ajax({type: "GET", url: url, data: null, success: null, + dataType: "script", cache: true}); + }, + + setIndex : function(index) { + var q; + this._index = index; + if ((q = this._queued_query) !== null) { + this._queued_query = null; + Search.query(q); + } + }, + + hasIndex : function() { + return this._index !== null; + }, + + deferQuery : function(query) { + this._queued_query = query; + }, + + stopPulse : function() { + this._pulse_status = 0; + }, + + startPulse : function() { + if (this._pulse_status >= 0) + return; + function pulse() { + Search._pulse_status = (Search._pulse_status + 1) % 4; + var dotString = ''; + for (var i = 0; i < Search._pulse_status; i++) + dotString += '.'; + Search.dots.text(dotString); + if (Search._pulse_status > -1) + window.setTimeout(pulse, 500); + }; + pulse(); + }, + + /** + * perform a search for something + */ + performSearch : function(query) { + // create the required interface elements + this.out = $('#search-results'); + this.title = $('

    ' + _('Searching') + '

    ').appendTo(this.out); + this.dots = $('').appendTo(this.title); + this.status = $('

    ').appendTo(this.out); + this.output = $('
      ').appendTo(this.out); + + $('#search-progress').text(_('Preparing search...')); + this.startPulse(); + + // index already loaded, the browser was quick! + if (this.hasIndex()) + this.query(query); + else + this.deferQuery(query); + }, + + query : function(query) { + var stopwords = ['and', 'then', 'into', 'it', 'as', 'are', 'in', + 'if', 'for', 'no', 'there', 'their', 'was', 'is', + 'be', 'to', 'that', 'but', 'they', 'not', 'such', + 'with', 'by', 'a', 'on', 'these', 'of', 'will', + 'this', 'near', 'the', 'or', 'at']; + + // stem the searchterms and add them to the correct list + var stemmer = new PorterStemmer(); + var searchterms = []; + var excluded = []; + var hlterms = []; + var tmp = query.split(/\s+/); + var object = (tmp.length == 1) ? tmp[0].toLowerCase() : null; + for (var i = 0; i < tmp.length; i++) { + if ($u.indexOf(stopwords, tmp[i]) != -1 || tmp[i].match(/^\d+$/) || + tmp[i] == "") { + // skip this "word" + continue; + } + // stem the word + var word = stemmer.stemWord(tmp[i]).toLowerCase(); + // select the correct list + if (word[0] == '-') { + var toAppend = excluded; + word = word.substr(1); + } + else { + var toAppend = searchterms; + hlterms.push(tmp[i].toLowerCase()); + } + // only add if not already in the list + if (!$.contains(toAppend, word)) + toAppend.push(word); + }; + var highlightstring = '?highlight=' + $.urlencode(hlterms.join(" ")); + + // console.debug('SEARCH: searching for:'); + // console.info('required: ', searchterms); + // console.info('excluded: ', excluded); + + // prepare search + var filenames = this._index.filenames; + var titles = this._index.titles; + var terms = this._index.terms; + var objects = this._index.objects; + var objtypes = this._index.objtypes; + var objnames = this._index.objnames; + var fileMap = {}; + var files = null; + // different result priorities + var importantResults = []; + var objectResults = []; + var regularResults = []; + var unimportantResults = []; + $('#search-progress').empty(); + + // lookup as object + if (object != null) { + for (var prefix in objects) { + for (var name in objects[prefix]) { + var fullname = (prefix ? prefix + '.' : '') + name; + if (fullname.toLowerCase().indexOf(object) > -1) { + match = objects[prefix][name]; + descr = objnames[match[1]] + _(', in ') + titles[match[0]]; + // XXX the generated anchors are not generally correct + // XXX there may be custom prefixes + result = [filenames[match[0]], fullname, '#'+fullname, descr]; + switch (match[2]) { + case 1: objectResults.push(result); break; + case 0: importantResults.push(result); break; + case 2: unimportantResults.push(result); break; + } + } + } + } + } + + // sort results descending + objectResults.sort(function(a, b) { + return (a[1] > b[1]) ? -1 : ((a[1] < b[1]) ? 1 : 0); + }); + + importantResults.sort(function(a, b) { + return (a[1] > b[1]) ? -1 : ((a[1] < b[1]) ? 1 : 0); + }); + + unimportantResults.sort(function(a, b) { + return (a[1] > b[1]) ? -1 : ((a[1] < b[1]) ? 1 : 0); + }); + + + // perform the search on the required terms + for (var i = 0; i < searchterms.length; i++) { + var word = searchterms[i]; + // no match but word was a required one + if ((files = terms[word]) == null) + break; + if (files.length == undefined) { + files = [files]; + } + // create the mapping + for (var j = 0; j < files.length; j++) { + var file = files[j]; + if (file in fileMap) + fileMap[file].push(word); + else + fileMap[file] = [word]; + } + } + + // now check if the files don't contain excluded terms + for (var file in fileMap) { + var valid = true; + + // check if all requirements are matched + if (fileMap[file].length != searchterms.length) + continue; + + // ensure that none of the excluded terms is in the + // search result. + for (var i = 0; i < excluded.length; i++) { + if (terms[excluded[i]] == file || + $.contains(terms[excluded[i]] || [], file)) { + valid = false; + break; + } + } + + // if we have still a valid result we can add it + // to the result list + if (valid) + regularResults.push([filenames[file], titles[file], '', null]); + } + + // delete unused variables in order to not waste + // memory until list is retrieved completely + delete filenames, titles, terms; + + // now sort the regular results descending by title + regularResults.sort(function(a, b) { + var left = a[1].toLowerCase(); + var right = b[1].toLowerCase(); + return (left > right) ? -1 : ((left < right) ? 1 : 0); + }); + + // combine all results + var results = unimportantResults.concat(regularResults) + .concat(objectResults).concat(importantResults); + + // print the results + var resultCount = results.length; + function displayNextItem() { + // results left, load the summary and display it + if (results.length) { + var item = results.pop(); + var listItem = $('
    • '); + if (DOCUMENTATION_OPTIONS.FILE_SUFFIX == '') { + // dirhtml builder + var dirname = item[0] + '/'; + if (dirname.match(/\/index\/$/)) { + dirname = dirname.substring(0, dirname.length-6); + } else if (dirname == 'index/') { + dirname = ''; + } + listItem.append($('').attr('href', + DOCUMENTATION_OPTIONS.URL_ROOT + dirname + + highlightstring + item[2]).html(item[1])); + } else { + // normal html builders + listItem.append($('').attr('href', + item[0] + DOCUMENTATION_OPTIONS.FILE_SUFFIX + + highlightstring + item[2]).html(item[1])); + } + if (item[3]) { + listItem.append($(' (' + item[3] + ')')); + Search.output.append(listItem); + listItem.slideDown(5, function() { + displayNextItem(); + }); + } else if (DOCUMENTATION_OPTIONS.HAS_SOURCE) { + $.get(DOCUMENTATION_OPTIONS.URL_ROOT + '_sources/' + + item[0] + '.txt', function(data) { + if (data != '') { + listItem.append($.makeSearchSummary(data, searchterms, hlterms)); + Search.output.append(listItem); + } + listItem.slideDown(5, function() { + displayNextItem(); + }); + }); + } else { + // no source available, just display title + Search.output.append(listItem); + listItem.slideDown(5, function() { + displayNextItem(); + }); + } + } + // search finished, update title and status message + else { + Search.stopPulse(); + Search.title.text(_('Search Results')); + if (!resultCount) + Search.status.text(_('Your search did not match any documents. Please make sure that all words are spelled correctly and that you\'ve selected enough categories.')); + else + Search.status.text(_('Search finished, found %s page(s) matching the search query.').replace('%s', resultCount)); + Search.status.fadeIn(500); + } + } + displayNextItem(); + } +} + +$(document).ready(function() { + Search.init(); +}); diff --git a/docs/html/_static/sidebar.js b/docs/html/_static/sidebar.js new file mode 100644 index 0000000..e9ef491 --- /dev/null +++ b/docs/html/_static/sidebar.js @@ -0,0 +1,148 @@ +/* + * sidebar.js + * ~~~~~~~~~~ + * + * This script makes the Sphinx sidebar collapsible. + * + * .sphinxsidebar contains .sphinxsidebarwrapper. This script adds + * in .sphixsidebar, after .sphinxsidebarwrapper, the #sidebarbutton + * used to collapse and expand the sidebar. + * + * When the sidebar is collapsed the .sphinxsidebarwrapper is hidden + * and the width of the sidebar and the margin-left of the document + * are decreased. When the sidebar is expanded the opposite happens. + * This script saves a per-browser/per-session cookie used to + * remember the position of the sidebar among the pages. + * Once the browser is closed the cookie is deleted and the position + * reset to the default (expanded). + * + * :copyright: Copyright 2007-2011 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +$(function() { + // global elements used by the functions. + // the 'sidebarbutton' element is defined as global after its + // creation, in the add_sidebar_button function + var bodywrapper = $('.bodywrapper'); + var sidebar = $('.sphinxsidebar'); + var sidebarwrapper = $('.sphinxsidebarwrapper'); + + // original margin-left of the bodywrapper and width of the sidebar + // with the sidebar expanded + var bw_margin_expanded = bodywrapper.css('margin-left'); + var ssb_width_expanded = sidebar.width(); + + // margin-left of the bodywrapper and width of the sidebar + // with the sidebar collapsed + var bw_margin_collapsed = '.8em'; + var ssb_width_collapsed = '.8em'; + + // colors used by the current theme + var dark_color = $('.related').css('background-color'); + var light_color = $('.document').css('background-color'); + + function sidebar_is_collapsed() { + return sidebarwrapper.is(':not(:visible)'); + } + + function toggle_sidebar() { + if (sidebar_is_collapsed()) + expand_sidebar(); + else + collapse_sidebar(); + } + + function collapse_sidebar() { + sidebarwrapper.hide(); + sidebar.css('width', ssb_width_collapsed); + bodywrapper.css('margin-left', bw_margin_collapsed); + sidebarbutton.css({ + 'margin-left': '0', + 'height': bodywrapper.height() + }); + sidebarbutton.find('span').text('»'); + sidebarbutton.attr('title', _('Expand sidebar')); + document.cookie = 'sidebar=collapsed'; + } + + function expand_sidebar() { + bodywrapper.css('margin-left', bw_margin_expanded); + sidebar.css('width', ssb_width_expanded); + sidebarwrapper.show(); + sidebarbutton.css({ + 'margin-left': ssb_width_expanded-12, + 'height': bodywrapper.height() + }); + sidebarbutton.find('span').text('«'); + sidebarbutton.attr('title', _('Collapse sidebar')); + document.cookie = 'sidebar=expanded'; + } + + function add_sidebar_button() { + sidebarwrapper.css({ + 'float': 'left', + 'margin-right': '0', + 'width': ssb_width_expanded - 28 + }); + // create the button + sidebar.append( + '
      «
      ' + ); + var sidebarbutton = $('#sidebarbutton'); + light_color = sidebarbutton.css('background-color'); + // find the height of the viewport to center the '<<' in the page + var viewport_height; + if (window.innerHeight) + viewport_height = window.innerHeight; + else + viewport_height = $(window).height(); + sidebarbutton.find('span').css({ + 'display': 'block', + 'margin-top': (viewport_height - sidebar.position().top - 20) / 2 + }); + + sidebarbutton.click(toggle_sidebar); + sidebarbutton.attr('title', _('Collapse sidebar')); + sidebarbutton.css({ + 'color': '#FFFFFF', + 'border-left': '1px solid ' + dark_color, + 'font-size': '1.2em', + 'cursor': 'pointer', + 'height': bodywrapper.height(), + 'padding-top': '1px', + 'margin-left': ssb_width_expanded - 12 + }); + + sidebarbutton.hover( + function () { + $(this).css('background-color', dark_color); + }, + function () { + $(this).css('background-color', light_color); + } + ); + } + + function set_position_from_cookie() { + if (!document.cookie) + return; + var items = document.cookie.split(';'); + for(var k=0; k=e.computed&&(e={value:f,computed:g})});return e.value};b.min=function(a,c,d){if(!c&&b.isArray(a))return Math.min.apply(Math,a);var e={computed:Infinity};b.each(a,function(f,g,h){g=c?c.call(d,f,g,h):f;gf?1:0}),"value")};b.sortedIndex=function(a,c,d){d=d||b.identity;for(var e=0,f=a.length;e>1;d(a[g])=0})})};b.zip=function(){for(var a=b.toArray(arguments),c=b.max(b.pluck(a,"length")),d=new Array(c),e=0;e0?f-c:c-f)>=0)return e;e[g++]=f}};b.bind=function(a,c){var d=b.rest(arguments,2);return function(){return a.apply(c||j,d.concat(b.toArray(arguments)))}};b.bindAll=function(a){var c=b.rest(arguments);if(c.length==0)c=b.functions(a);b.each(c,function(d){a[d]=b.bind(a[d],a)}); +return a};b.delay=function(a,c){var d=b.rest(arguments,2);return setTimeout(function(){return a.apply(a,d)},c)};b.defer=function(a){return b.delay.apply(b,[a,1].concat(b.rest(arguments)))};b.wrap=function(a,c){return function(){var d=[a].concat(b.toArray(arguments));return c.apply(c,d)}};b.compose=function(){var a=b.toArray(arguments);return function(){for(var c=b.toArray(arguments),d=a.length-1;d>=0;d--)c=[a[d].apply(this,c)];return c[0]}};b.keys=function(a){if(b.isArray(a))return b.range(0,a.length); +var c=[];for(var d in a)q.call(a,d)&&c.push(d);return c};b.values=function(a){return b.map(a,b.identity)};b.functions=function(a){return b.select(b.keys(a),function(c){return b.isFunction(a[c])}).sort()};b.extend=function(a,c){for(var d in c)a[d]=c[d];return a};b.clone=function(a){if(b.isArray(a))return a.slice(0);return b.extend({},a)};b.tap=function(a,c){c(a);return a};b.isEqual=function(a,c){if(a===c)return true;var d=typeof a;if(d!=typeof c)return false;if(a==c)return true;if(!a&&c||a&&!c)return false; +if(a.isEqual)return a.isEqual(c);if(b.isDate(a)&&b.isDate(c))return a.getTime()===c.getTime();if(b.isNaN(a)&&b.isNaN(c))return true;if(b.isRegExp(a)&&b.isRegExp(c))return a.source===c.source&&a.global===c.global&&a.ignoreCase===c.ignoreCase&&a.multiline===c.multiline;if(d!=="object")return false;if(a.length&&a.length!==c.length)return false;d=b.keys(a);var e=b.keys(c);if(d.length!=e.length)return false;for(var f in a)if(!b.isEqual(a[f],c[f]))return false;return true};b.isEmpty=function(a){return b.keys(a).length== +0};b.isElement=function(a){return!!(a&&a.nodeType==1)};b.isArray=function(a){return!!(a&&a.concat&&a.unshift)};b.isArguments=function(a){return a&&b.isNumber(a.length)&&!b.isArray(a)&&!r.call(a,"length")};b.isFunction=function(a){return!!(a&&a.constructor&&a.call&&a.apply)};b.isString=function(a){return!!(a===""||a&&a.charCodeAt&&a.substr)};b.isNumber=function(a){return p.call(a)==="[object Number]"};b.isDate=function(a){return!!(a&&a.getTimezoneOffset&&a.setUTCFullYear)};b.isRegExp=function(a){return!!(a&& +a.test&&a.exec&&(a.ignoreCase||a.ignoreCase===false))};b.isNaN=function(a){return b.isNumber(a)&&isNaN(a)};b.isNull=function(a){return a===null};b.isUndefined=function(a){return typeof a=="undefined"};b.noConflict=function(){j._=n;return this};b.identity=function(a){return a};b.breakLoop=function(){throw m;};var s=0;b.uniqueId=function(a){var c=s++;return a?a+c:c};b.template=function(a,c){a=new Function("obj","var p=[],print=function(){p.push.apply(p,arguments);};with(obj){p.push('"+a.replace(/[\r\t\n]/g, +" ").replace(/'(?=[^%]*%>)/g,"\t").split("'").join("\\'").split("\t").join("'").replace(/<%=(.+?)%>/g,"',$1,'").split("<%").join("');").split("%>").join("p.push('")+"');}return p.join('');");return c?a(c):a};b.forEach=b.each;b.foldl=b.inject=b.reduce;b.foldr=b.reduceRight;b.filter=b.select;b.every=b.all;b.some=b.any;b.head=b.first;b.tail=b.rest;b.methods=b.functions;var l=function(a,c){return c?b(a).chain():a};b.each(b.functions(b),function(a){var c=b[a];i.prototype[a]=function(){var d=b.toArray(arguments); +o.call(d,this._wrapped);return l(c.apply(b,d),this._chain)}});b.each(["pop","push","reverse","shift","sort","splice","unshift"],function(a){var c=Array.prototype[a];i.prototype[a]=function(){c.apply(this._wrapped,arguments);return l(this._wrapped,this._chain)}});b.each(["concat","join","slice"],function(a){var c=Array.prototype[a];i.prototype[a]=function(){return l(c.apply(this._wrapped,arguments),this._chain)}});i.prototype.chain=function(){this._chain=true;return this};i.prototype.value=function(){return this._wrapped}})(); diff --git a/docs/html/errorcodes.html b/docs/html/errorcodes.html new file mode 100644 index 0000000..abdbae5 --- /dev/null +++ b/docs/html/errorcodes.html @@ -0,0 +1,290 @@ + + + + + + + + + Appendix B. PKGBUILDer error messages list — PKGBUILDer v2.1.0 documentation + + + + + + + + + + +
      +

      Navigation

      +       +
      + +
      +
      +
      +
      + +
      +

      Appendix B. PKGBUILDer error messages list

      + +++ + + + + + + + + + +
      Info:This is an appendix to the PKGBUILDer documentation.
      Author:Kwpolska <kwpolska@kwpolska.tk>
      Date:2011-09-20
      Version:2.1.0
      +

      In order to help debugging, error messages are numbered. +Each error message number has four digits: the first one is the +category and the other three are error identifiers.

      +
      +

      Categories

      +
        +

      1. AUR class

        +
        2. +

      2. Utils class

        +
        3. +
      3. +
        Build class
        +
          +
        1. download, extract
          2. +
        2. depcheck, predepcheck
          3. +
        3. makepkg
          4. +
        4. auto_build, validation
          5. +
        +
        +
        +
        4. +

      4. Update class

        +
        5. +

      5. non-module errors

        +
        6. +
      +
      +

      Usage instructions

      +

      In order to get the category identifier, you need to:

      +
      +
        +
      • multiply the desired list element by 1000
        • +
      • multiply the desired subelement by 100
        • +
      • add the results together
        • +
      +
      +

      In order to get the first possible number of this (sub)category, add 1 to +the result of the above calculations.

      +
      +
      +
      +

      Errors

      + +++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      ERR#ComponentMessage
      [3101]download0 bytes downloaded
      [3151]extract0 files extracted
      [3201]depcheckcannot find the requested dependency
      [3202]depcheckUnicodeDecodeError while reading file
      [3301]makepkgreturned 1
      [3401]auto_buildAUR dependency required
      [3451]validationnot installed
      [3452]validationoutdated
      [5002]searchsearch string too short
      +

      Explainations:

      + + + + + +
      [3101]occurs, when PKGBUILDer downloaded 0 bytes. It usually +means that something bad happened during the download.
      + + + + + +
      [3151]occurs, when PKGBUILDer extracted 0 files from the +downloaded tarball. It means that the tarball is broken. Please +tell the maintainer about this problem.
      + + + + + +
      [3201]occurs, when the $depends or $makedepends array of the +PKGBUILD requests a package, that does not exist in the system, +repositories, nor the AUR.
      + + + + + +
      [3202]occurs, when Python cannot decode UTF-8 the PKGBUILD. If +the PKGBUILD cannot be read, dependency checks cannot be performed. +Possible reasons include incorrectly encoded characters in the +Maintainer/Submitter field. Please inform the package maintainer +through the comments. Include the output of iconv PKGBUILD. Example +output: # Maintainer: Juan Piconv: illegal input sequence at position +20 The PKGBUILDer’s error message is also valid and will help the +maintainer.
      + + + + + +
      [3301]occurs, when makepkg exits with the return code 1. It means +that something bad happened. Refer to makepkg’s output for more info.
      + + + + + +
      [3401]occurs, when the $depends or $makedepends array of the +PKGBUILD request a package, which exists in the AUR. It is plain +informational. Right after displaying this message, the script will +automatically build the required packages.
      + + + + + +
      [3451]occurs, when PKGBUILDer finds out that the package is not +installed on your system. It means that the package that was bulit +before this message was issued wasn’t installed properly (eg. root +password wasn’t provided at the right time, ‘n’ was hit when pacman was +asking for proceeding).
      + + + + + +
      [3452]occurs, when PKGBUILDer finds out that the package is +installed, but outdated. It means that the package that was bulit before +this message was issued wasn’t installed properly (eg. root password +wasn’t provided at the right time, ‘n’ was hit when pacman was asking for +proceeding).
      + + + + + +
      [5002]occurs, when your search string is shorter than 3 letters. +The AUR API ignores these requests. However, the script searches for +an exact match. If one is found, it is being shown.
      +
      +
      + + +
      +
      +
      +
      +
      +

      Table Of Contents

      + + +

      Previous topic

      +

      Appendix A. README

      + + +
      +
      +
      +
      +
      +

      Navigation

      + +
      +
      + © Copyright 2011, Kwpolska. + Last updated on 2011-09-19T20:09:09Z. + Created using Sphinx 1.0.7. +
      + + \ No newline at end of file diff --git a/docs/html/genindex.html b/docs/html/genindex.html new file mode 100644 index 0000000..7931989 --- /dev/null +++ b/docs/html/genindex.html @@ -0,0 +1,91 @@ + + + + + + + + + Index — PKGBUILDer v2.1.0 documentation + + + + + + + + + +
      +

      Navigation

      + +
      + +
      +
      +
      +
      + + +

      Index

      + +
      + +
      + + +
      +
      +
      +
      +
      + + + + + +
      +
      +
      +
      +
      +

      Navigation

      + +
      +
      + © Copyright 2011, Kwpolska. + Last updated on 2011-09-19T20:09:41Z. + Created using Sphinx 1.0.7. +
      + + \ No newline at end of file diff --git a/docs/html/index.html b/docs/html/index.html new file mode 100644 index 0000000..909d61c --- /dev/null +++ b/docs/html/index.html @@ -0,0 +1,107 @@ + + + + + + + + + PKGBUILDer 2.1.0 documentation — PKGBUILDer v2.1.0 documentation + + + + + + + + + + +
      +

      Navigation

      + +
      + +
      +
      +
      +
      + + + + +
      +
      +
      +
      +
      +

      Next topic

      +

      PKGBUILDer

      + + +
      +
      +
      +
      +
      +

      Navigation

      + +
      +
      + © Copyright 2011, Kwpolska. + Last updated on 2011-09-19T20:09:01Z. + Created using Sphinx 1.0.7. +
      + + \ No newline at end of file diff --git a/docs/html/objects.inv b/docs/html/objects.inv new file mode 100644 index 0000000000000000000000000000000000000000..6f3429272fa85e6482d709bc9718be67e925db04 GIT binary patch literal 206 zcmY#Z2rkIT%&Sny%qvUHE6FdaR47X=D$dN$Q!wIERtPA{&q_@$u~G=|c6SQ(^l?co z0*Zz~R9Gn(=@|mKAsML(MX9-onRzLxMGE<83MCnt#R_SeIjIUjIypbLpeVJtI5kC~ zv^X;_U7;!`Gf9uD;@0W2{wL3Pd#(-8(DU4Q%G1Z|Y~Tgc5RDaA&bE5JNS*TJnTGa{ zXUnHNTcTCb)UxAJ@aGK~O`T4q4pYRItBI+mFVJe~aGc8OEW)C)Y + + + + + + PKGBUILDer — PKGBUILDer v2.1.0 documentation + + + + + + + + + + + +
      +

      Navigation

      + +
      + +
      +
      +
      +
      + +
      +

      PKGBUILDer

      +
      +

      a Python AUR helper/library

      + +++ + + + + + + + + + + + + + +
      Author:Kwpolska <kwpolska@kwpolska.tk>
      Date:2011-09-20
      Copyright:This document has been placed in the public domain.
      Version:2.1.0
      Manual section:8
      Manual group:PKGBUILDer manual
      +
      +

      SYNOPSIS

      +

      pkgbuilder <operation> [options] [targets]

      +
      +
      +

      DESCRIPTION

      +

      PKGBUILDer is an AUR helper, i.e. an application which builds AUR +packages. It can be used in conjunction with pacman (with a special +script). It uses various techniques to automatize the process as +much as possible.

      +

      Since version 2.1.0, PKGBUILDer provides modules that can be used in +other scripts.

      +
      +
      +

      OPERATIONS

      +
      +
      -i, –info
      +

      Displays info about targets. The format is as follows:

      +
      +
      +
      Category : AUR category
      +
      Name : package name
      +
      Version : current version
      +
      URL : package URL
      +
      Licenses : package licenses
      +
      Votes : AUR votes
      +
      Out of Date : yes or no
      +
      Maintainer : package owner
      +
      Last Updated : ISO date (1970-01-01T00:00:00Z)
      +
      First Submitted: ISO date
      +
      Description : the package description
      +
      +
      +
      +
      -s, –search
      +
      Searches the AUR for packages with targets as the query.
      +
      -u, –sysupgrade
      +
      Checks for package updates in the AUR. If updates are found, +they will be installed if the user says so.
      +
      +

      Additionally, parameters -S, –sync, -y and -refresh +are accepted for pacman syntax compatibility. -S/–sync +makes the script build its packages in /tmp instead of the current +working directory (CWD).

      +
      +
      +

      OPTIONS

      +
      +
      -C, –nocolor
      +
      Forces the script to ignore the ANSI color codes.
      +
      -V, –novalidation
      +
      Skips package installation validation phase (checking +if the package is installed).
      +
      -S, –sync
      +
      Originally for pacman syntax compatibility, now makes the script more +wrapper-friendly: builds packages in /tmp and uses aur instead of +the category in search.
      +
      +
      +
      +

      EXAMPLES

      +
      +
      pkgbuilder dropbox
      +
      Installs the package “dropbox” from the AUR. It is being built in +the CWD.
      +
      pkgbuilder -S dropbox
      +
      Installs “dropbox”, but builds thhe package in /tmp-pkgbuilder-UID.
      +
      pkgbuilder -Syu
      +
      Checks for updates and offers installing them.
      +
      +
      +
      +

      SEE ALSO

      +

      pacman(8), makepkg(8)

      +

      You can visit the git repo at <https://github.com/Kwpolska/pkgbuilder> +for more info.

      +
      +
      +

      BUGS

      +

      Bugs shall be reported at the GitHub page +(<https://github.com/Kwpolska/pkgbuilder/issues>). You can also +send mail to <kwpolska@kwpolska.tk>.

      +
      +
      +
      + + +
      +
      +
      +
      +
      +

      Table Of Contents

      + + +

      Previous topic

      +

      PKGBUILDer 2.1.0 documentation

      +

      Next topic

      +

      Appendix A. README

      + + +
      +
      +
      +
      +
      +

      Navigation

      + +
      +
      + © Copyright 2011, Kwpolska. + Last updated on 2011-09-19T20:09:32Z. + Created using Sphinx 1.0.7. +
      + + \ No newline at end of file diff --git a/docs/html/search.html b/docs/html/search.html new file mode 100644 index 0000000..bc10916 --- /dev/null +++ b/docs/html/search.html @@ -0,0 +1,91 @@ + + + + + + + + + Search — PKGBUILDer v2.1.0 documentation + + + + + + + + + + + + + +
      +

      Navigation

      + +
      + +
      +
      +
      +
      + +

      Search

      +
      + +

      + Please activate JavaScript to enable the search + functionality. +

      +
      +

      + From here you can search these documents. Enter your search + words into the box below and click "search". Note that the search + function will automatically search for all of the words. Pages + containing fewer words won't appear in the result list. +

      +
      + + + +
      + +
      + +
      + +
      +
      +
      +
      +
      +
      +
      +
      +
      +
      +

      Navigation

      + +
      +
      + © Copyright 2011, Kwpolska. + Last updated on 2011-09-19T20:09:01Z. + Created using Sphinx 1.0.7. +
      + + \ No newline at end of file diff --git a/docs/html/searchindex.js b/docs/html/searchindex.js new file mode 100644 index 0000000..aeb25f6 --- /dev/null +++ b/docs/html/searchindex.js @@ -0,0 +1 @@ +Search.setIndex({objects:{},terms:{all:0,code:[0,2,3],queri:3,four:2,follow:[0,3],content:1,iconv:2,procur:0,depend:2,friendli:3,send:3,aur:[0,1,2,3],skip:3,aris:0,neglig:0,introduc:0,merchant:0,digit:2,sourc:0,string:2,util:2,exact:2,err:2,list:[0,1,2],pleas:2,impli:0,direct:0,maintain:[2,3],download:2,compat:[0,3],index:[],sub:2,section:3,calcul:2,current:3,version:[0,2,3],"new":0,order:2,"public":3,deriv:0,disclaim:0,met:0,modif:0,sinc:3,search:[2,3],prior:0,permit:0,extra:0,modul:[2,3],api:2,instal:[0,2,3],from:[0,2,3],proceed:2,visit:3,perl:0,usr:0,tell:2,more:[0,2,3],desir:2,notic:0,appendix:[1,2],indic:[],particular:0,must:0,pkgbuild:2,pyalpm:0,work:3,subel:2,can:3,purpos:0,root:2,process:3,accept:3,"00z":3,tarbal:2,occur:2,instead:3,updat:[2,3],product:0,after:2,befor:2,date:[0,2,3],data:0,man:0,"short":2,author:[0,2,3],element:2,caus:0,inform:2,bulit:2,juan:2,oper:3,help:2,softwar:0,consent:0,through:2,paramet:[0,3],conjunct:3,group:3,fit:0,makepkg:[2,3],tort:0,mail:3,non:2,good:0,"return":2,thei:3,python:[0,1,2,3],interrupt:0,now:[0,3],nor:[0,2],name:[0,3],auto_build:2,refresh:3,each:2,debug:2,found:[2,3],mean:2,domain:3,vote:3,redistribut:0,happen:2,extract:2,event:0,special:[0,3],out:[0,2,3],shown:2,profit:0,categori:[1,2,3],cwd:3,reason:2,theori:0,ask:2,"byte":2,place:3,retain:0,first:[2,3],origin:[0,3],endors:0,arrai:2,number:2,predepcheck:2,mai:0,instruct:2,wrapper:[0,3],wasn:2,owner:[0,3],stabl:0,script:[2,3],licens:3,system:2,messag:[1,2],too:2,illeg:2,option:3,copi:0,sync:3,github:3,holder:0,than:2,target:3,provid:[0,2,3],charact:2,posit:2,sai:3,ani:0,packag:[0,2,3],substitut:0,need:[0,2],issu:[2,3],built:3,note:0,also:[2,3],without:0,build:[0,2,3],advis:0,even:0,distribut:0,shall:[0,3],multipli:2,letter:2,phase:3,"class":2,url:3,doc:0,request:2,doe:2,syntax:3,find:2,copyright:[0,3],explain:2,busi:0,hit:2,variou:3,get:2,express:0,pypi:0,repo:3,cannot:2,report:3,liabl:0,requir:2,bad:2,see:3,result:2,reserv:0,someth:2,written:0,pkgbuilder:[0,1,2,3],neither:0,incident:0,last:3,howev:[0,2],contract:0,mani:0,com:3,comment:2,kwpolska:[0,2,3],color:3,exemplari:0,damag:0,liabil:0,addition:3,three:2,been:3,compon:2,much:3,basic:[],consequenti:0,piconv:2,togeth:2,plain:2,servic:0,"while":2,abov:[0,2],error:[1,2],helper:[0,1,3],tabl:[],readm:[0,1],them:3,synopsi:3,incorrectli:2,perform:2,make:3,shorter:2,binari:0,html:0,decod:2,document:[0,1,2,3],http:3,depcheck:2,user:3,syu:3,techniqu:3,exampl:[2,3],thi:[0,2,3],usual:2,identifi:2,"01t00":3,add:[0,2],valid:[2,3],input:2,match:2,bin:0,applic:3,which:[2,3],format:3,read:2,big:0,password:2,python3:0,loss:0,specif:0,makedepend:2,manual:3,nocolor:3,output:2,page:[0,3],right:[0,2],indirect:0,librari:[0,1,3],tmp:3,leap:0,exit:2,iso:3,condit:0,reproduc:0,thhe:3,refer:[0,2],usag:2,broken:2,promot:0,repositori:2,about:[2,3],materi:0,submitt:2,encod:2,automat:[2,3],warranti:0,contributor:0,your:2,git:3,wai:0,submit:3,avail:0,strict:0,includ:[0,2],forward:0,properli:2,form:0,offer:3,forc:3,bug:3,info:[0,2,3],utf:2,possibl:[0,2,3],whether:0,pacman:[0,2,3],displai:[2,3],limit:0,otherwis:0,problem:2,featur:0,uid:3,dure:2,exist:2,file:[0,2],check:[2,3],when:2,field:2,other:[0,2,3],sysupgrad:3,you:[0,2,3],novalid:3,sequenc:2,ansi:3,dropbox:3,outdat:2,directori:3,descript:3,ignor:[2,3],time:2,unicodedecodeerror:2},objtypes:{},titles:["README for PKGBUILDer","PKGBUILDer 2.1.0 documentation","Appendix B. PKGBUILDer error messages list","PKGBUILDer"],objnames:{},filenames:["README","index","errorcodes","pkgbuilder"]}) \ No newline at end of file diff --git a/docs/index.rst b/docs/index.rst new file mode 100644 index 0000000..27e10d0 --- /dev/null +++ b/docs/index.rst @@ -0,0 +1,23 @@ +.. PKGBUILDer documentation master file, created by + sphinx-quickstart on Sun Sep 18 14:35:50 2011. + You can adapt this file completely to your liking, but it should at least + contain the root `toctree` directive. + +PKGBUILDer 2.1.0 documentation +============================== + +Contents: + +.. toctree:: + :maxdepth: 2 + + pkgbuilder + README + errorcodes + +.. Indices and tables +.. ================== +.. +.. * :ref:`genindex` +.. * :ref:`modindex` +.. * :ref:`search` diff --git a/docs/pkgbuilder.8.gz b/docs/pkgbuilder.8.gz new file mode 100644 index 0000000000000000000000000000000000000000..561551e7837288ad6aacf43afcd87e1b6f82da38 GIT binary patch literal 1517 zcmV~3A1541#CoF!5tDZAdU-;tF3k~kZZHnGIxy*|$!>0ogI4^%)wR}5B6 zFhvcEAyG01#X_UX$S}p?8T(-Zg8ycBF!^$OJs;lp2UBsmudaD=x@l@lyvD3-KK_a<}wIyoy~sXRDU`-Q6?$UetUf zP4ZmWemt|-Ik))ckpxv9!%=@QnvnqU2%h8wg<@S2z%&G#9X>s)%8L;`EyWq#s-nMi zUT`k8=~iLFd{oB?(}COXZ9H>>5}C!XEar=7H+^h^ZC`5<6L^h6=@LbzhTlfxNjMBi zpbN4{hQ)fdEO{0)wMZuLQ5LpQxD=n@yDaR3euVD^vu8#>It%?lcrzVNX2bEw89Aao z*FcX6-vA!4z^>7v$av%|!#3qn3eKyxn@K^VHMXe^0EPx4+`eQ`YHU}`GLqu2Qbb;p zn-n`b!u;UUy-?5vi#W}QjubD6sx2`zUuG4jWG3^q(@8-bex4LHgf4QzOfwsRSmne~ymZD(MKYo}gTqf3 zD!f3TfPAegvzJDtQnqudl9BoJ9?q(xfZX$l2@BR!VO9yqS84X*eQX=MNXA$InLr-{ z^`af_lnR6-50ndozgYECyK;+bsxL51|02ezt0*Ym3K7axQqNVua^aF{lSrz708$6Yh3qSPWEx+lji z=JH2~YY*CY1u7nhV1c(=k@IR7oY*ca+dEwrD@9{w?cbyTZ^4tt-EoffEW=notwd4avZV@QVT~*to=cg5LqYq`r%Ct;gxQrQ%EfcLmMSrrDYR$z8Vy;+ZY;#@S{NBH+oBzK% z|Hh*vWF#|bCo}mhRdgB>&N99dQu#U78-+t~yYVlQ?iBT}wY?3^c|RYDK)*V58`fm=RUIpiho}Yn|Db7L4{zZa3OQy=wh9ju zJg%CF;!MQZu3Mia$I#$lwCL14aR&mf(bAoB2h51Wte$_U=)3NOsR-EMkKV)NesC7C z!x0LxlEqT~AVXgeeNw24N_ydMp+{}yhV_zJx>!rb9vN1QgbB`g!NNZGw71?s8>TLa zNsp28j9oO34*lkQ_>zxZc{~{QjW2B365FK}>^5wSHh)^Pa4>-0eK@YJ8rL50%lB7x zA6tCUrC)KozRA)Zog1#XaTQwOr^0I+;EDDT0bKl?8dKfPRQb5}0iw+C|h8ow>BHQqF= zdwUnD6QY@xL?d01)I77j>y54}3%}J5fmvH!A8c4s literal 0 HcmV?d00001 diff --git a/docs/pkgbuilder.rst b/docs/pkgbuilder.rst new file mode 100644 index 0000000..ea003e7 --- /dev/null +++ b/docs/pkgbuilder.rst @@ -0,0 +1,101 @@ +========== +PKGBUILDer +========== + +----------------------------------- +a Python AUR helper/library +----------------------------------- + +:Author: Kwpolska +:Date: 2011-09-20 +:Copyright: This document has been placed in the public domain. +:Version: 2.1.0 +:Manual section: 8 +:Manual group: PKGBUILDer manual + +SYNOPSIS +======== + +*pkgbuilder* [options] [targets] + +DESCRIPTION +=========== + +PKGBUILDer is an AUR helper, i.e. an application which builds AUR +packages. It can be used in conjunction with pacman (with a special +script). It uses various techniques to automatize the process as +much as possible. + +Since version 2.1.0, PKGBUILDer provides modules that can be used in +other scripts. + +OPERATIONS +========== + +**-i, --info** + Displays info about *targets*. The format is as follows: + + | Category : AUR category + | Name : package name + | Version : current version + | URL : package URL + | Licenses : package licenses + | Votes : AUR votes + | Out of Date : yes or no + | Maintainer : package owner + | Last Updated : ISO date (1970-01-01T00:00:00Z) + | First Submitted: ISO date + | Description : the package description + +**-s, --search** + Searches the AUR for packages with **targets** as the query. + +**-u, --sysupgrade** + Checks for package updates in the AUR. If updates are found, + they will be installed if the user says so. + +Additionally, parameters **-S**, **--sync**, **-y** and **-refresh** +are accepted for pacman syntax compatibility. **-S**/**--sync** +makes the script build its packages in /tmp instead of the current +working directory (CWD). + +OPTIONS +======= + +**-C, --nocolor** + Forces the script to ignore the ANSI color codes. + +**-V, --novalidation** + Skips package installation validation phase (checking + if the package is installed). + +**-S, --sync** + Originally for pacman syntax compatibility, now makes the script more + wrapper-friendly: builds packages in */tmp* and uses *aur* instead of + the category in search. + +EXAMPLES +======== + +pkgbuilder dropbox + Installs the package "dropbox" from the AUR. It is being built in + the CWD. + +pkgbuilder -S dropbox + Installs "dropbox", but builds thhe package in /tmp-pkgbuilder-UID. + +pkgbuilder -Syu + Checks for updates and offers installing them. + +SEE ALSO +======== +**pacman(8)**, **makepkg(8)** + +You can visit the git repo at +for more info. + +BUGS +==== +Bugs shall be reported at the GitHub page +(). You can also +send mail to . diff --git a/pkgbuilder.py b/pkgbuilder.py index 787fae1..b274130 100755 --- a/pkgbuilder.py +++ b/pkgbuilder.py @@ -1,6 +1,6 @@ #!/usr/bin/python3 -# PKGBUILDer Version 2.1.0-prerelease -# A python3 AUR helper (sort of.) Wrapper friendly (pacman-like output.) +# PKGBUILDer Version 2.1.0 +# A Python AUR helper/library. # Copyright Kwpolska 2011. Licensed under GPLv3. # USAGE: ./build.py pkg1 [pkg2] [pkg3] (and more) """PKGBUILDer. An AUR helper (sort of.)""" @@ -18,73 +18,129 @@ import subprocess import datetime -# This is a prerelease version. Some features planned aren't implemented -# yet. Planned features include AUR package upgrade (based on paconky.py) -# and unit tests. Full release will occur after passing 500 lines and -# implementing these features. +VERSION = '2.1.0' -### n/a top-level base utils ### +### PBDS PB global data storage ### +class PBDS: + """PKGBUILDer Data Storage""" + def __init__(self): + """PBDS init""" + # Fancy-schmancy messages stolen from makepkg. + + self.all_off = "\x1b[1;0m" + self.colors = { + 'all_off': "\x1b[1;0m", + 'bold': "\x1b[1;1m", + 'blue': "\x1b[1;1m\x1b[1;34m", + 'green': "\x1b[1;1m\x1b[1;32m", + 'red': "\x1b[1;1m\x1b[1;31m", + 'yellow': "\x1b[1;1m\x1b[1;33m" + } + self.pacman = False + self.validate = True + self.categories = ['E', 'E', 'daemons', 'devel', 'editors', + 'emulators', 'games', 'gnome', 'i18n', 'kde', + 'kernels', 'lib', 'modules', 'multimedia', + 'network', 'office', 'science', 'system', 'x11', + 'xfce'] + def colorson(self): + """colors on""" + self.colors = { + 'all_off': "\x1b[1;0m", + 'bold': "\x1b[1;1m", + 'blue': "\x1b[1;1m\x1b[1;34m", + 'green': "\x1b[1;1m\x1b[1;32m", + 'red': "\x1b[1;1m\x1b[1;31m", + 'yellow': "\x1b[1;1m\x1b[1;33m" + } + + self.all_off = "\x1b[1;0m" + + + def colorsoff(self): + """colors off""" + self.colors = { + 'all_off': "", + 'bold': "", + 'blue': "", + 'green': "", + 'red': "", + 'yellow': "" + } -# Fancy-schmancy messages stolen from makepkg. -ALL_OFF = "\x1b[1;0m" -BOLD = "\x1b[1;1m" -BLUE = BOLD+"\x1b[1;34m" -GREEN = BOLD+"\x1b[1;32m" -RED = BOLD+"\x1b[1;31m" -YELLOW = BOLD+"\x1b[1;33m" +# Useless since python3-aur was replaced, but we'd make use of it. +def pblog(msg, tofile = False, tostderr = False): + """A log function. Executed when requested and by fancy_*.""" + if tofile == True: + open('pkgbuilder.log', 'a').write(msg) + + if tostderr == True: + sys.stderr.write(msg) + +DS = PBDS() def fancy_msg(text): """makepkg's msg(). Use for main messages.""" - sys.stderr.write(GREEN+'==>'+ALL_OFF+BOLD+' '+text+ALL_OFF+"\n") + sys.stderr.write(DS.colors['green']+'==>'+DS.colors['all_off']+ + DS.colors['bold']+' '+text+DS.colors['all_off']+"\n") pblog('(auto fancy_msg ) '+text) def fancy_msg2(text): """makepkg's msg2(). Use for sub-messages.""" - sys.stderr.write(BLUE+' ->'+ALL_OFF+BOLD+' '+text+ALL_OFF+"\n") + sys.stderr.write(DS.colors['blue']+' ->'+DS.colors['all_off']+ + DS.colors['bold']+' '+text+DS.colors['all_off']+"\n") pblog('(auto fancy_msg2 ) '+text) def fancy_warning(text): """makepkg's warning(). Use when you have problems.""" - sys.stderr.write(YELLOW+'==> WARNING:'+ALL_OFF+BOLD+' '+text+ALL_OFF+ - "\n") + sys.stderr.write(DS.colors['yellow']+'==> WARNING:'+ + DS.colors['all_off']+DS.colors['bold']+' '+text+ + DS.colors['all_off']+"\n") pblog('(auto fancy_warning) '+text) def fancy_error(text): """makepkg's error(). Use for errors. Exitting is suggested.""" - sys.stderr.write(RED+'==> ERROR:'+ALL_OFF+BOLD+' '+text+ALL_OFF+"\n") + sys.stderr.write(DS.colors['red']+'==> ERROR:'+DS.colors['all_off']+ + DS.colors['bold']+' '+text+DS.colors['all_off']+"\n") pblog('(auto fancy_error ) '+text) -CATEGORIES = ['ERR0R', 'ERR1R', 'daemons', 'devel', 'editors', 'emulators', - 'games', 'gnome', 'i18n', 'kde', 'kernels', 'lib', 'modules', - 'multimedia', 'network', 'office', 'science', 'system', - 'x11', 'xfce'] -# If you can see ERR0R or ERR1R in the output, something bad has happened. - -# Useless since python3-aur was replaced, but we'd make use of it. -def pblog(msg, tofile = False, tostderr = False): - """A log function. Executed when requested and by fancy_*.""" - if tofile == True: - open('pkgbuilder.log', 'a').write(msg) - - if tostderr == True: - sys.stderr.write(msg) +def fancy_error2(text): + """like fancy_error, but looks like a sub-message (fancy_msg2).""" + sys.stderr.write(DS.colors['red']+' ->'+DS.colors['all_off']+ + DS.colors['bold']+' '+text+DS.colors['all_off']+"\n") + pblog('(auto fancy_error2 ) '+text) ### PBError errors raised here ### class PBError(Exception): """Exceptions raised by the PKGBUILDer.""" - def __init__(self, msg, error=None): + def __init__(self, msg): """Initialization is mandatory.""" self.msg = msg - self.error = error -#### AUR AUR RPC calls ### + def __str__(self): + """You want to see error messages, don't you?""" + return self.msg + +### AUR AUR RPC calls ### class AUR: """A class for calling the AUR API. Basics only.""" def __init__(self): - """Stores the RPC URL.""" + """Stores the RPC URLs.""" self.rpc = '{0}://aur.archlinux.org/rpc.php?type={1}&arg={2}' + self.mrpc = '{0}://aur.archlinux.org/rpc.php?type=multiinfo{1}' + + def jsonreq(self, rtype, arg, prot = 'http'): + """Makes a request, but returns plain JSON data.""" + rhandle = urllib.request.urlopen(self.rpc.format(prot, rtype, arg)) + return rhandle.read().decode() + + def jsonmultiinfo(self, pyargs, prot = 'http'): + """Makes a multiinfo request, but returns plain JSON data.""" + urlargs = '&arg[]='+'&arg[]='.join(pyargs) + rhandle = urllib.request.urlopen(self.mrpc.format(prot, urlargs)) + return rhandle.read().decode() def request(self, rtype, arg, prot = 'http'): """Makes a request. @@ -92,14 +148,11 @@ def request(self, rtype, arg, prot = 'http'): where TYPE is the request type from aur.archlinux.org/rpc.php, ARGUMENT is the request argument, e.g. search query, PROTOCOL is the protocol used, http or https.""" - rhandle = urllib.request.urlopen(self.rpc.format(prot, rtype, arg)) - jsondata = rhandle.read() - return json.loads(jsondata.decode()) + return json.loads(self.jsonreq(rtype, arg, prot)) - def jsonreq(self, rtype, arg, prot = 'http'): - """Makes a request, but returns plain JSON data.""" - rhandle = urllib.request.urlopen(self.rpc.format(prot, rtype, arg)) - return rhandle.read().decode() + def multiinfo(self, pyargs, prot = 'http'): + """Makes a multiinfo request. Simillar to AUR.request().""" + return json.loads(self.jsonmultiinfo(pyargs, prot)) ### Utils common global utilities ### class Utils: @@ -136,7 +189,7 @@ def search(self, pkgname): else: return aur_pkgs['results'] - def print_package(self, pkg, use_categories = True): + def print_package(self, pkg, use_categories = True, prefix=''): """ Outputs info about package. @@ -147,23 +200,27 @@ def print_package(self, pkg, use_categories = True): 2.0 Name: showInfo """ pycman.config.init_with_config('/etc/pacman.conf') - db = pyalpm.get_localdb() - lpkg = db.get_pkg(pkg['Name']) + localdb = pyalpm.get_localdb() + lpkg = localdb.get_pkg(pkg['Name']) category = '' installed = '' if lpkg != None: installed = ' [installed]' if pkg['OutOfDate'] == 1: - installed = installed + ' '+RED+'[out of date]'+ALL_OFF + installed = (installed + ' '+DS.colors['red']+'[out of date]'+ + DS.colors['all_off']) if use_categories == True: - category = CATEGORIES[int(pkg['CategoryID'])] + category = DS.categories[int(pkg['CategoryID'])] else: category = 'aur' + if prefix == '': + base = prefix+"{0}/{1} {2} ({4} votes){5}\n"+prefix+" {3}" + else: + base = prefix+" {0}/{1} {2} ({4} votes){5}\n"+prefix+" {3}" - print("{0}/{1} {2} ({4} votes){5}\n {3}".format(category, - pkg['Name'], pkg['Version'], pkg['Description'], - pkg['NumVotes'], installed)) + print(base.format(category, pkg['Name'], pkg['Version'], + pkg['Description'], pkg['NumVotes'], installed)) pyalpm.release() @@ -179,6 +236,7 @@ def __init__(self): Class init. """ self.utils = Utils() + self.aururl = '{0}://aur.archlinux.org{1}' def auto_build(self, package, validate): """ @@ -197,32 +255,33 @@ def auto_build(self, package, validate): if validate == True: # check if installed pycman.config.init_with_config('/etc/pacman.conf') - db = pyalpm.get_localdb() - pkg = db.get_pkg(package) + localdb = pyalpm.get_localdb() + pkg = localdb.get_pkg(package) aurversion = self.utils.info(package)['Version'] if pkg is None: - fancy_error("validation: NOT installed") + fancy_error2("[ERR3451] validation: NOT installed") pyalpm.release() else: - if aurversion != pkg.version: - fancy_error("validation: outdated "+ + if pyalpm.vercmp(aurversion, pkg.version) > 0: + fancy_error2("[ERR3452] validation: outdated "+ pkg.version) else: - fancy_msg2("validation: installed "+ + fancy_msg2(" validation: installed "+ pkg.version) pyalpm.release() elif build_result == 1: os.chdir('../') - raise Exception("The build function returned 1 (error).") + raise PBError("[ERR3301] makepkg returned 1.") # I think that only makepkg can do that. Others would # raise an exception. else: os.chdir('../') - fancy_warning("Building more AUR packages is required.") + fancy_warning("[ERR3401] Building more AUR packages is \ +required.") for package2 in build_result: self.auto_build(package2, True) self.auto_build(package, True) - except Exception as inst: + except PBError as inst: fancy_error(str(inst)) def download(self, urlpath, filename, prot = 'http'): @@ -233,8 +292,7 @@ def download(self, urlpath, filename, prot = 'http'): Possible exceptions: PBError, IOError, urllib.error.URLError, urllib.error.HTTPError """ - rhandle = urllib.request.urlopen(prot+ - '://aur.archlinux.org'+urlpath) + rhandle = urllib.request.urlopen(self.aururl.format(prot, urlpath)) headers = rhandle.info() fhandle = open(filename, 'wb') fhandle.write(rhandle.read()) @@ -242,7 +300,7 @@ def download(self, urlpath, filename, prot = 'http'): if headers['Content-Length'] != 0: return headers['Content-Length'] else: - raise PBError('download: 0 bytes downloaded') + raise PBError('[ERR3101] download: 0 bytes downloaded') def extract(self, filename): """ @@ -257,7 +315,7 @@ def extract(self, filename): if names != []: return len(names) else: - raise PBError('extract: no files extracted') + raise PBError('[ERR3151] extract: no files extracted') def prepare_deps(self, pkgbuild): """ @@ -309,14 +367,14 @@ def depcheck(self, bothdepends): else: parseddeps = {} pycman.config.init_with_config('/etc/pacman.conf') - db = pyalpm.get_localdb() + localdb = pyalpm.get_localdb() for dep in bothdepends: if re.search('[<=>]', dep): vpat = '>=<|><=|=><|=<>|<>=|<=>|>=|=>|><|<>|=<|\ <=|>|=|<' ver_base = re.split(vpat, dep) dep = ver_base[0] - pkg = db.get_pkg(dep) + pkg = localdb.get_pkg(dep) repos = dict((db.name, db) for db in pyalpm.get_syncdbs()) if pkg != None: parseddeps[dep] = 0 @@ -325,7 +383,7 @@ def depcheck(self, bothdepends): elif self.utils.info(dep): parseddeps[dep] = 2 else: - raise PBError("depcheck: cannot find {0} \ + raise PBError("[ERR3201] depcheck: cannot find {0} \ anywhere".format(dep)) pyalpm.release() return parseddeps @@ -341,36 +399,48 @@ def build_runner(self, package): try: # exists pkginfo = self.utils.info(package) + if pkginfo == False: + raise PBError('Package {0} not found.'.format(package)) pkgname = pkginfo['Name'] fancy_msg('Compiling package {0}...'.format(pkgname)) - self.utils.print_package(pkginfo) + self.utils.print_package(pkginfo, + prefix=DS.colors['blue']+' ->'+ + DS.colors['all_off']+ + DS.colors['bold']) filename = pkgname+'.tar.gz' # Okay, this package exists, great then. Thanks, user. fancy_msg('Downloading the tarball...') downloadbytes = self.download(pkginfo['URLPath'], filename) kbytes = int(downloadbytes) / 1000 #`K' means thousand. - fancy_msg2('{0}K bytes downloaded'.format(kbytes)) + fancy_msg2('{0} kB downloaded'.format(kbytes)) fancy_msg('Extracting...') - extractfiles = self.extract(filename) - fancy_msg2('{0} files extracted'.format(extractfiles)) + fancy_msg2('{0} files extracted'.format(self.extract( + filename))) os.chdir('./'+pkgname+'/') fancy_msg('Checking dependencies...') - bothdepends = self.prepare_deps(open('./PKGBUILD', 'r').read()) - deps = self.depcheck(bothdepends) - pkgtypes = ['system', 'repos', 'the AUR'] - aurbuild = [] - if deps == {}: - fancy_msg2('none found') - - for pkg, pkgtype in deps.items(): - fancy_msg2("{0}: found in {1}".format(pkg, pkgtypes[pkgtype])) - if pkgtype == 2: - aurbuild.append(pkg) - if aurbuild != []: - return aurbuild + try: + bothdepends = self.prepare_deps(open('./PKGBUILD', + 'r').read()) + deps = self.depcheck(bothdepends) + pkgtypes = ['system', 'repos', 'the AUR'] + aurbuild = [] + if deps == {}: + fancy_msg2('none found') + + for pkg, pkgtype in deps.items(): + fancy_msg2("{0}: found in {1}".format(pkg, + pkgtypes[pkgtype])) + if pkgtype == 2: + aurbuild.append(pkg) + if aurbuild != []: + return aurbuild + except UnicodeDecodeError as inst: + fancy_error2('[ERR3202] depcheck: UnicodeDecodeError. \ + The PKGBUILD cannot be read. There are invalid UTF-8 characters (eg. \ +in the Maintainer field.) Error message: '+str(inst)) asroot = '' if os.geteuid() == 0: @@ -388,60 +458,152 @@ def build_runner(self, package): fancy_error(str(inst)) except IOError as inst: fancy_error(str(inst)) - except KeyboardInterrupt as inst: - fancy_error('KeyboardInterrupt (^C) caught.') + except KeyboardInterrupt: + fancy_error('ERR5001: KeyboardInterrupt (^C) caught.') exit(0) + +### Upgrade upgrade AUR packages ### +class Upgrade: + """Tools for performing an upgrade.""" + def __init__(self): + """ + Class init. + """ + self.aur = AUR() + self.build = Build() + pycman.config.init_with_config('/etc/pacman.conf') + self.localdb = pyalpm.get_localdb() + + def __del__(self): + try: + pyalpm.release() + except pyalpm.error: + pass + + def gather_foreign_pkgs(self): + """Gathers a list of all foreign packages.""" + + # Based on paconky.py. + installed = set(p for p in self.localdb.pkgcache) + + syncdbs = pyalpm.get_syncdbs() + for sdb in syncdbs: + for pkg in list(installed): + if sdb.get_pkg(pkg.name): + installed.remove(pkg) + + foreign = dict([(p.name, p) for p in installed]) + + return foreign + + def list_upgradeable(self, pkglist): + """Compares package versions. + Input: a list of packages to be compared. + suggestion: self.gather_foreign_pkgs().keys() + Returns: a list of packages with newer versions in the AUR.""" + + aurlist = self.aur.multiinfo(pkglist)['results'] # It's THAT easy. + # Oh, and by the way: it is much, MUCH faster than others. + # It makes ONE multiinfo request rather than $installed_packages + # info requests. + upgradeable = [] + + for i in aurlist: + pkg = self.localdb.get_pkg(i['Name']) + if pyalpm.vercmp(i['Version'], pkg.version) > 0: + upgradeable.append(i['Name']) + return upgradeable + + def auto_upgrade(self): + """Upgrades packages. Simillar to Build.auto_build(). + Notice: things break here A LOT. Perform twice if you can.""" + pblog('Ran auto_upgrade.') + fancy_msg('Gathering data about packages...') + + foreign = self.gather_foreign_pkgs() + upgradeable = self.list_upgradeable(foreign.keys()) + upglen = len(upgradeable) + + fancy_msg('{0} upgradeable packages found:'.format(upglen)) + if upglen == 0: + fancy_msg2('there is nothing to do') + return 0 + fancy_msg2(' '.join(upgradeable)) + query = (DS.colors['green']+'==>'+DS.colors['all_off']+ + DS.colors['bold']+' '+'Proceed with installation? [Y/n] '+ + DS.colors['all_off']) + yesno = input(query) + yesno = yesno + ' ' # cheating... + if yesno[0] == 'n' or yesno[0] == 'N': + return 0 + else: + pyalpm.release() + for package in upgradeable: + pblog('Building '+package) + self.build.auto_build(package, DS.validate) + pblog('Initialized.') -if __name__ == '__main__': + +def main_routine(): + """Main routine. Usage: main_routine(sys.argv)""" pblog('Running argparse.') parser = argparse.ArgumentParser(description="A python3 AUR helper \ (sort of.) Wrapper-friendly (pacman-like output.)", epilog="You can use \ pacman syntax if you want to.") - parser.add_argument('-C', '--nocolor', action='store_false', - default=True, dest='color', help="don't use colors") - parser.add_argument('-V', '--novalidation', action='store_false', + + parser.add_argument('-v', '--version', action='version', + version='PKGBUILDer '+VERSION) + parser.add_argument('pkgs', metavar="PACKAGE", action='store', + nargs='*', help="packages to build") + + argopt = parser.add_argument_group('options') + argopr = parser.add_argument_group('operations') + argopt.add_argument('-C', '--nocolor', action='store_false', + default=True, dest='color', help="don't use \ + colors in output") + argopt.add_argument('-S', '--sync', action='store_true', default=False, + dest='pac', help="pacman syntax compatiblity") + argopt.add_argument('-V', '--novalidation', action='store_false', default=True, dest='valid', help="don't check if \ packages were installed after build") + argopt.add_argument('-y', '--refresh', action='store_true', + default=False, dest='pacupd', help="pacman \ + syntax compatiblity") - parser.add_argument('-i', '--info', action='store_true', default=False, + argopr.add_argument('-i', '--info', action='store_true', default=False, dest='info', help="show package info") - parser.add_argument('-s', '--search', action='store_true', + argopr.add_argument('-s', '--search', action='store_true', default=False, dest='search', help="search for a \ package") - parser.add_argument('-u', '--sysupgrade', action='store_true', + argopr.add_argument('-u', '--sysupgrade', action='store_true', default=False, dest='upgrade', - help="[NOT IMPLEMENTED] upgrade installed AUR \ -packages") + help="upgrade installed AUR packages") - parser.add_argument('-S', '--sync', action='store_true', default=False, - dest='pac', help="pacman syntax compatiblity") - parser.add_argument('-y', '--refresh', action='store_true', - default=False, dest='pacupd', help="pacman \ -syntax compatiblity") - parser.add_argument('pkgs', metavar="PACKAGE", action='store', - nargs='*', help="packages to build") args = parser.parse_args() - + DS.validate = args.valid + DS.pacman = args.pac try: utils = Utils() build = Build() pblog('Arguments parsed.') if args.upgrade == True: - fancy_error("Sorry, but this feature is not implemented yet.") + # We finally made it! + upgrade = Upgrade() + upgrade.auto_upgrade() + del(upgrade) if args.color == False: - # That's awesome in variables AND this version. - ALL_OFF = '' - BOLD = '' - BLUE = '' - GREEN = '' - RED = '' - YELLOW = '' + # That's awesome in variables AND 2.x series. + # ...and it was moved to PBDS. + DS.colorsoff() if args.info == True: - for package in args.pkgs: - pkg = utils.info(package) + for ipackage in args.pkgs: + ipkg = utils.info(ipackage) + if ipkg == False: + raise PBError('Package {0} not found.'.format(ipackage)) + print("""Category : {0} Name : {1} Version : {2} @@ -453,52 +615,65 @@ def build_runner(self, package): Last Updated : {8} First Submitted: {9} Description : {10} -""".format(CATEGORIES[int(pkg['CategoryID'])], pkg['Name'], pkg['Version'], - pkg['URL'], pkg['License'], pkg['NumVotes'], - RED+'yes'+ALL_OFF if pkg['OutOfDate'] == '1' else 'no', - pkg['Maintainer'], datetime.datetime.utcfromtimestamp(float( - pkg['LastModified'])).strftime('%Y-%m-%dT%H:%m:%SZ'), - datetime.datetime.utcfromtimestamp(float(pkg['FirstSubmitted'] - )).strftime('%Y-%m-%dT%H:%m:%SZ'), pkg['Description'])) - # I tried to be simillar to pacman. - exit(0) +""".format(DS.categories[int(ipkg['CategoryID'])], ipkg['Name'], + ipkg['Version'], ipkg['URL'], ipkg['License'], ipkg['NumVotes'], + DS.colors['red']+'yes'+DS.colors['all_off'] if (ipkg['OutOfDate'] + == '1') else 'no', ipkg['Maintainer'], + datetime.datetime.utcfromtimestamp(float( + ipkg['LastModified'])).strftime('%Y-%m-%dT%H:%m:%SZ'), + datetime.datetime.utcfromtimestamp(float( + ipkg['FirstSubmitted'])).strftime('%Y-%m-%dT%H:%m:%SZ'), + ipkg['Description'])) + exit(0) if args.search == True: searchstring = '+'.join(args.pkgs) if len(searchstring) < 3: - fancy_error('search string too short, API limitation') - exit(1) - pkgsearch = utils.search(searchstring) # pacman behavior - for package in pkgsearch: + # this would be too many entries. The API is really + # having this limitation, though. + fancy_error('ERR5002: search string too short, API \ +limitation') + fancy_msg('Searching for exact match...') + pkgsearch = [utils.info(searchstring)] # workaround + if pkgsearch == [False]: + fancy_msg2('not found') + exit(0) + else: + fancy_msg2('found') + else: + pkgsearch = utils.search(searchstring) # pacman behavior + for spackage in pkgsearch: if args.pac != True: - utils.print_package(package, True) + utils.print_package(spackage, True) else: - utils.print_package(package, False) + utils.print_package(spackage, False) exit(0) if args.pac == True: + # -S assumes being a wrapper and/or wanting to build in /tmp. uid = os.geteuid() path = '/tmp/pkgbuilder-{0}'.format(str(uid)) if os.path.exists(path) == False: os.mkdir(path) os.chdir(path) - except KeyboardInterrupt as inst: - fancy_error('KeyboardInterrupt (^C) caught.') + except PBError as inst: + fancy_error(str(inst)) + except KeyboardInterrupt: + fancy_error('ERR0001: KeyboardInterrupt (^C) caught.') exit(0) # If we didn't exit, we shall build the packages. pblog('Ran through all the addon features, building...') - - for package in args.pkgs: - pblog('Building '+package) - build.auto_build(package, args.valid) + for bpackage in args.pkgs: + pblog('Building '+bpackage) + build.auto_build(bpackage, args.valid) pblog('Quitting.') -# Over 500 lines! Compare this to build.pl's 56 (including ~8 useless...) -# New features will be included when they will be added to the AUR RPC -# and python3-aur. (note to Xyne: hardcoding stuff is evil.) + +# Over 650 lines! Compare this to build.pl's 56 (including ~8 useless...) +# New features will be included when they will be added to the AUR RPC. # RPC: (search info msearch multiinfo) # If something new will appear there, tell me through GH Issues or mail. # They would be implemented later. -# Some other features might show up, too. (hint hint: line #430) +# Some other features might show up, too. diff --git a/scripts/pkgbuilder b/scripts/pkgbuilder new file mode 100755 index 0000000..1ec5e49 --- /dev/null +++ b/scripts/pkgbuilder @@ -0,0 +1,4 @@ +#!/usr/bin/python3.2 +"""Run PKGBUILDer.""" +import pkgbuilder +pkgbuilder.main_routine() diff --git a/setup.py b/setup.py new file mode 100755 index 0000000..2136e65 --- /dev/null +++ b/setup.py @@ -0,0 +1,31 @@ +#!/usr/bin/env python3 +from distutils.core import setup + +setup(name='pkgbuilder', + version='2.1.0', + description='An AUR helper (and library) in python3', + author='Kwpolska', + author_email='kwpolska@kwpolska.tk', + url='https://github.com/Kwpolska/pkgbuilder', + download_url='https://github.com/Kwpolska/pkgbuilder/tarball/master', + license='3-clause BSD', + platforms='Arch Linux', + classifiers=['Development Status :: 5 - Production/Stable', + 'Environment :: Console', + 'Intended Audience :: End Users/Desktop', + 'Intended Audience :: System Administrators', + 'License :: OSI Approved :: BSD License', + 'Natural Language :: English', + 'Operating System :: POSIX :: Linux', + 'Programming Language :: Python', + 'Programming Language :: Python :: 3', + 'Topic :: System', + 'Topic :: System :: Archiving :: Packaging', + 'Topic :: Utilities' + ], + py_modules=['pkgbuilder'], + scripts=['scripts/pkgbuilder'], + data_files=[#('bin', ['bin/pkgbuilder']), + ('share/man/man8', ['docs/pkgbuilder.8.gz']) + ] + )