OpenOffice.org Ninja

Practical applications of Jungletest include:

• Quantifying the stability of OOo. For example, perhaps you could say that OOo can import 99.9999% of Microsoft Word documents without crashing.
• Detecting regressions of fixed issues in the Issue Tracker.
• Generally improving the stability of OOo.

You must have the following software installed:

• “System Python” (Python installed outside OOo)
• “OpenOffice.org Python” (Python typically included with OOo)
• file, a tool for identifying file types (common on UNIX systems)
• wget (common on UNIX systems)
• unzip (Windows)
• A list of words (usually /usr/share/dict/words)
• OpenOffice.org (of course)

Jungletest should work on Windows, but only Linux has been tested so far.

What's new in Jungletest? Read the change log.

The jungletest application:

• jungletest-20080412.tar.bz2 April 12, 2008
• jungletest-20060731.tar.bz2 July 31, 2006

Below is a list of 110,000 URLs to feed into jungletest, so jungletest can download the URLs for testing. The list contains doc, ppt, xls, rtf, pps, dot, docx, pptx, and xlsx.

• Microsoft Office document URLs (2.3M; April 12, 2008)

To install Jungletest, follow these instructions.

1. Download Jungletest
2. tar xjvf jungletest-2005000.tar.bz2
3. cd jungletest-20050000
4. Edit config.py

Jungletest operation is split into three, discrete operations:

1. Gathering URLs of documents
2. Downloading documents
3. Conducting the tests

Use any combination of the following methods to populate the database with document URLs.

If you want to harvest document URLs from Yahoo, run:

python jungletest.py --yahoo

NOTE: This process currently runs until you receive your daily limit of Yahoo queries, but when you have enough URLs, killing the process is safe.

If you want to harvest document URLs from the OOo Issue Tracker, run:

python jungletest.py --harvest-urls-issuetracker=QUERY_URL

Here are some sample query URLs:

• Closed defects with summary including crash
• Unconfirmed defects with summary including crash, hang, or freeze
• Non-closed defects with summary contains {crash, freeze, hang, stack} and has an attachment
• Closed, fixed defects with keyword crash and any attachment (good for OOo regression testing)
• (Summary contains crash, freeze or hang) OR (keywords include crash) AND has attachment AND summary does not include change

If you want to import a list of URLs from a text file (such as the large file available from the downloads section), run:

python jungletest.py --import-urls=FILE

The text file simply has one URL per line.

Now that the database has a list of URLs, this step downloads the files for later testing. Each download is checked to verify it is probably a legitimate file. For example, HTML downloads are rejected.

python jungletest.py --harvest-files

NOTE: This process currently runs until the list of URLs is exhausted, but when you have enough test documents, killing the process is safe.

Now that a cache of documents is available, use this command to conduct the test:

python jungletest.py --conduct-test

NOTE: This process currently runs forever, but when you have enough tests, killing the process is safe.

Opening random, complex binary documents can be dangerous because of buffer overflows. Therefore, you should take precautions. For example, run Jungletest from its own system account.

Once you have tested the basic system, you may want to switch to Xvfb for two benefits:

• It's convenient for operating a separate user account just for Jungletest.
• It's convenient because windows don't pop up to mess up your work.

See Can I run OpenOffice.org without having an X server installed,for example, to use only its UNO API? and Mandriva KB.

OpenOffice.org 2.3+ has support for running headless without Xvfb.

• Fix internal bugs
• Expand tests
  • Identify buffer overflows
  • Identify memory leaks
  • Look into Mudflap and libc's MALLOC_CHECK_
  • Test export filters
  • Investigate other operations that likely cause a crash
• Improve basic reporting
  • Identify regressions in test results
• Develop a system for sharing (import/export) test results between systems
• Investigate automating reporting
• Investigate supporting AbiWord, Gnumeric, and KOffice (DCOP)

Run

grep -i "\(todo\|fixme\)" *

for more plans.

• Word lists from packet storm

The following bugs were found using Jungletest.

• Bug 58353 XViewCursor::goDown() gets stuck in certain situation
• Bug 58904 WW8: loop on formatting frames and redlines in RTL context FIXED
• Bug 59026 crash on desktop terminate() through PyUNO
• Bug 67571 RTF: crash opening file having many footnotes and graphics FIXED
• Bug 67711 crash exporting to old MS Word formats
• Bug 67907 WW8: opening .doc containing loads of redlines consumes memory / loops FIXED
• Bug 71487 WordPrefect .wpd instantly crashes on import (and Fridrich Strba's related blog post) FIXED

• Load a smart tag component (#82346)