|
Size: 4310
Comment: converted to 1.6 markup
|
Size: 1912
Comment: rendered readme restored
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 3: | Line 3: |
| <<TableOfContents(2)>> = General info = |
=== What is piuparts? === |
| Line 8: | Line 6: |
| Description: .deb package installation, upgrading, and removal testing tool | Description: .deb package installation, upgrading, and removal testing tool |
| Line 15: | Line 13: |
| . | . |
| Line 18: | Line 16: |
| Homepage: https://piuparts.debian.org | |
| Line 20: | Line 19: |
| piuparts runs on piuparts.cs.helsinki.fi aka piatti.debian.org and just like lintian should be run on every developer machine before uploading :) | === piuparts.debian.org === |
| Line 22: | Line 21: |
| piuparts logs are available at [[http://piuparts.debian.org|http://piuparts.debian.org]] | piuparts is being run constantly on all suites of the main Debian archive, the results are made public on [[https://piuparts.debian.org|piuparts.debian.org]]. The [[piuparts/piuparts.debian.org|piuparts.debian.org setup]] is documented and maintained in GIT, plus there is also an [[piuparts/FAQ|FAQ]] available. |
| Line 24: | Line 24: |
| #debian-qa is the irc-channel to coordinate work on irc, piuparts-devel is the project name on alioth. | === Documentation === |
| Line 26: | Line 26: |
| == Machine info == | piuparts itself has a [[https://piuparts.debian.org/doc/README.html|README]] and a [[https://manpages.debian.org/testing/piuparts/piuparts.1.en.html|manpage]] - read those before reading the [[piuparts/HowTos]]. |
| Line 28: | Line 28: |
| * piuparts.cs.helsinki.fi aka [[http://db.debian.org/machines.cgi?host=piatti|piatti.debian.org]] * hosted at [[http://cs.helsinki.fi/index.en.html|Department of Computer Science, University of Helsinki]] * donated by [[http://hp.com/go/debian/|HP]] * dual AMD Opteron(tm) Processor 275, 2.2 Ghz * 8GB RAM * 300 GB physical volume for data |
=== Contributing === |
| Line 35: | Line 30: |
| == How to run piuparts on piatti == | If you are interested in contributing, that's great! Here's a list to hopefully get you started: * join [[piuparts/Development|development]] efforts. Every little pull request helps. Check the BTS for plenty of wishlist bugs to tackle. * [[https://piuparts.debian.org/bug_howto.html|file bugs]] based on piuparts.d.o runs! * improve the documentation, both these wiki pages and what's in GIT has been growing over the years and it's showing. |
| Line 37: | Line 35: |
| the piuparts stuff is partly in the piupartsm account (master end), and partly in the piuartss account (the slave, which actually runs piuparts) run piuparts-slave.py as piupartss and watch it run via screen. the slave starts the master when it needs it, you don't need to start it manually for more information see http://svn.debian.org/viewsvn/piuparts/piatti/README.txt If you want to help, please join #debian-qa and say so there. == Troubleshouting / maintainance == Sometimes the chroot tarballs in /home/piupartss/ need to be removed, currently there are sid.tar.gz and lenny.tar.gz /!\ we should just recreate them every week... = Developing piuparts = * alioth project * source code: [[http://svn.debian.org/viewsvn/piuparts/|svn.debian.org/piuparts]] * mailing list: [[http://lists.alioth.debian.org/mailman/listinfo/piuparts-devel|piuparts-devel@l.a.d.o]] * commit diff list: [[http://lists.alioth.debian.org/mailman/listinfo/piuparts-commits|piuparts-commits@l.a.d.o]] * there was a [[SummerOfCode2007/PiupartsImprovements]] = Todo = == piuparts.debian.org related == see http://svn.debian.org/viewsvn/piuparts/piatti/README.txt == Codebase related == see http://svn.debian.org/viewsvn/piuparts/trunk/TODO == Piuparts and PTS integration suggestion == In order for the PTS to be able to display piuparts testing status for a package, and link to its log file, Piuparts could generate a set of static files that will be visible via http: {{{ %s = source package name %v = source package version %p = piuparts version /source/%s -> index page /source/%s/%v -> a particular log /source/%s/latest -> log for latest version /source/%s/piuparts-%p/%v -> a particular log from a version of piuparts similar for /binary-$ARCH/ /%s -> /source/%s For PTS integration: one file with results for all source packages: /results-per-source.txt %s pass $MATCHINGLOG %s fail $MATCHINGLOG }}} /!\ Problem: PTS is source package centered, piuparts binary package. {{{ For Ubuntu development weather report (similar to PTS): a file with the following: Pass: %d Fail: %d }}} (See https://blueprints.launchpad.net/ubuntu/+spec/developer-weather-report for the Ubuntu developer weather report.) == Documentation == split this wiki page into subpages, so that the piuparts documentation can be mainained in the wiki, by exporting as docbook. update: use asciidoc suggested structure: * /piuparts - index page, just a table of contents * /piuparts/about - what is piuparts * /piuparts/devel - information how to participate in piuparts development * /piuparts/doc/software - piuparts documentation * /piuparts/doc/piatti - documenation about piuparts.cs.helsinki.fi * /piuparts/todo - todo list |
---- ## This page is referenced from http://piuparts.debian.org CategoryPermalink CategoryPackaging |
What is piuparts?
Description: .deb package installation, upgrading, and removal testing tool piuparts tests that .deb packages (as used by Debian) handle installation, upgrading, and removal correctly. It does this by creating a minimal Debian installation in a chroot, and installing, upgrading, and removing packages in that environment, and comparing the state of the directory tree before and after. piuparts reports any files that have been added, removed, or modified during this process. . piuparts is meant as a quality assurance tool for people who create .deb packages to test them before they upload them to the Debian package archive. Homepage: https://piuparts.debian.org
piuparts.debian.org
piuparts is being run constantly on all suites of the main Debian archive, the results are made public on piuparts.debian.org. The piuparts.debian.org setup is documented and maintained in GIT, plus there is also an FAQ available.
Documentation
piuparts itself has a README and a manpage - read those before reading the piuparts/HowTos.
Contributing
If you are interested in contributing, that's great! Here's a list to hopefully get you started:
join development efforts. Every little pull request helps. Check the BTS for plenty of wishlist bugs to tackle.
file bugs based on piuparts.d.o runs!
- improve the documentation, both these wiki pages and what's in GIT has been growing over the years and it's showing.