What is motutools ?

motutools is a package providing lots of small scripts useful to MOTUs and other people interested in improving the universe's quality. Currently, it particularly targets scripts dealing with lists of packages (all software written in ruby, all science-related software), allowing the user to get a global view of the packages it cares about. But the scope of motutools might be larger in the future.

The motutools package provides /usr/bin/mts (mts as in MotuToolS). This executable is a wrapper for a lot of other small scripts which reside in /usr/share/motutools. Those scripts can be run directly, but it is easier to run them through mts.

More info

Scripts in /usr/share/motutools should do only one thing, but do it well. Scripts longer than 50 lines should really be exceptions.

Scripts in /usr/share/motutools can be written in whatever language one want. However, limiting ourselves to a small set of languages and tools might be a good idea. The packages needed to run those scripts is listed as Recommends, because the user might not want to run all the scripts.

Scripts are coded in a smart way, allowing chaining. They should read their input from stdin as much as possible, and use stdout and stderr' for output.

Currently, motutools depends on ruby, because /usr/bin/mts is written in this language. However, /usr/bin/mts is less than 100 lines, so you can rewrite it in python if this dependancy bothers you too much.

TODO / DONE list

• Packages and Sources file management

  • download Packages and Sources files for a distribution (Debian, Ubuntu) and a section (main, contrib, non-free, universe, multiverse) in a local folder (~/.motutools/ ?) done

  • Output those packages files for a distribution (Debian, Ubuntu) and a section (all of them, main, contrib, non-free, universe, multiverse)
  • Get a list of binary/source packages matching something from those Packages or Sources files:

    • Recursive dependancies of something (using Depends, Recommends or Suggests) done: depends (but still need more love to select distribution and dependancy type)

    • Recursive reverse dependancies of something (using Depends, Recommends or Suggests) done: depends

    • Section
    • any grep-dctrl predicate

• Filter a file containing data with a list of packages done: filter

• Build a list of binary packages from a list of source packages

• Build a list of source packages from a list of binary packages done: src2bin

• [http://en.wikipedia.org/wiki/Naive_set_theory Set theory] on package lists : union, intersection, difference, substraction, etc. So one can build exactly the list one want. done: list_*

• Get a list of bugs in the Debian BTS, in the Ubuntu Bugzilla, or in Malone, for a list of packages
• Compare versions of packages in Debian and Ubuntu
• Get the popcon results for a list of binary packages. Also for a list of source packages, using the most installed binary package as reference.
• Generate HTML reports for the list of bugs or the versions of packages
• Any other cool stuff that you are going to add to this list now

Real life example

# because we will generate some temporary files
cd /tmp

# get all packages recursively depending on libruby1.8
mts depends --reverse libruby1.8 > binpkg

# get the sources packages for those binary packages
mts bin2src < binpkg > srcpkg

# Update our package lists (Packages and Sources files)
if [ ! -d $HOME/.motutools/sid ]; then
        mts dist-create sid http://ftp.debian.org/debian unstable main contrib non-free
fi
if [ ! -d $HOME/.motutools/dapper ]; then
        mts dist-create dapper http://archive.ubuntu.com/ubuntu dapper main restricted universe multiverse
fi

mts dist-apt-get sid update
mts dist-apt-get dapper update

# Lists versions in Debian and Ubuntu
mts compare-versions sid dapper > versionslist

# Filter this versions list with the list of ruby-related sources packages
mts filter srcpkg < versionslist > rubyversionslist

# Generate an HTML report from rubyversionslist
mts versions2html < rubyversionslist > rubyversionslist.html