Data Analysis » Octopus

Octopus is a tool to get information, which is publicly available on interntet,
about free software projects. Such information is mainly source code repositories,
mailing lists archives, release packages and bug tracking systems. This data could
be used by other tools to analyze the project from different points of views.
The goal is to get, in an automatic way, the input of other tools like cvsanaly, mlstats,
sloccount and so on.

Get the code
------------

git clone git://git.libresoft.es/git/octopus

Dependencies
------------

• Python >= 2.4
• Python Storm (optional, required only for database output)

Database Output Device
----------------------

Database output device uses storm, which is an object-relational mapper (ORM) for Python,
so it has to be installed in order to be able to use this output device. Depending on the
database driver to be used, the following specific libraries will be needed too:

• MySQL support depends on the MySQLdb module for Python
• PostgreSQL support depends on the psycopg2 module for Python
• SQLite support depends on the pysqlite2 module for Python

At the moment these are the only database drivers supported by Octopus, since they are
indeed what storm supports.

For further information about the specific command line options provided by the
database output device just type octopus --help.

Contact
-------

• Mailing list

  http://lists.morfeo-project.org/pipermail/libresoft-tools-devel/

• Bug tracking system

  https://bugzilla.libresoft.es/

Examples
--------

• Getting information about project galeon hosted in
  SourceForge

$ echo "galeon" | octopus -q -t sf http://sourceforge.net

• Getting information about a list of projects stored in a
  file (one line per project) hosted in SourceForge

$ octopus -q -t sf --projects-file /path/to/file http://sourceforge.net

• Getting information about libresoft-tools hosted in Morfeo project
  forge (based on GForge) in XML format

$ echo "libresoft-tools" | octopus -t gforge -o xml https://forge.morfeo-project.org

• Getting information about libresoft-tools hosted in Morfeo project
  forge (based on GForge) in a sqlite database

$ echo "libresoft-tools" | octopus -t gforge -o db -d /tmp/octopus.db https://forge.morfeo-project.org