[Piuparts-commits] rev 74 - in trunk: . debian

[Ana Beatriz Guerrero López]

Author: ana
Date: 2007-08-28 11:47:15 +0000 (Tue, 28 Aug 2007)
New Revision: 74

Added:
   trunk/custom-scripts.txt
Modified:
   trunk/debian/rules
Log:
Documentation about custom scripts.


Added: trunk/custom-scripts.txt
===================================================================
--- trunk/custom-scripts.txt	                        (rev 0)
+++ trunk/custom-scripts.txt	2007-08-28 11:47:15 UTC (rev 74)
@@ -0,0 +1,47 @@
+Custom scripts with piuparts
+------------------------------
+
+You can specify several custom scripts to be run inside piuparts.
+You have to store them in a directory and give it as argument to
+piuparts: --scriptsdir=/dir/with/the/scripts
+
+The scripts can be run:
+
+    Before *install* your package. The name of the script must
+    start with:
+    pre_install_
+
+    After *install* your package and its deps. In the case of the 
+    upgrade test, it is after install and upgrade. The name of the 
+    script must start with:
+    post_install_
+
+    After *remove* your package, The name of the script must start with:
+    post_remove_
+
+    After *purge* your package, The name of the script must start with:
+    post_purge_
+
+    Before *upgrade* your package, after install current version in 
+    the archive (this is done in the second test, "Installation, upgrade 
+    and purging test"). The name of the script must start with:
+    pre_upgrade_
+
+
+You can run several scripts in every step, they are run in alphabetical 
+order.
+
+The scripts are run *inside* the piuparts chroot and only can be shell 
+scripts, if you want to run Python or Perl scripts, you have to install 
+Python or Perl. The chroot where piuparts is run is minized and does not 
+include
+Perl.
+
+
+It would be interesting to declare some piuparts variables like the name
+of the current testing packages, and be able to use this variable in the 
+custom scripts. But this option is not available yet.
+
+
+
+

Modified: trunk/debian/rules
===================================================================
--- trunk/debian/rules	2007-08-28 10:54:52 UTC (rev 73)
+++ trunk/debian/rules	2007-08-28 11:47:15 UTC (rev 74)
@@ -20,6 +20,7 @@
 	install -m 0644 ChangeLog debian/tmp/usr/share/doc/$P/changelog
 	install -m 0644 README debian/tmp/usr/share/doc/$P
 	install -m 0644 how-to-use-piuparts.txt debian/tmp/usr/share/doc/$P
+	install -m 0644 custom-scripts.txt debian/tmp/usr/share/doc/$P
 	gzip -9 debian/tmp/usr/share/doc/$P/*
 	install -m 0644 debian/copyright debian/tmp/usr/share/doc/$P
 	dpkg-gencontrol -isp