Shell Example

Description

Wiki Formatter for command line shell examples.

This plugin has only been tested on Trac 0.12, but may work with earlier versions.

Example

Additional examples are available here.

{{{
#!ShellExample
(full example showing how to use openssl to connect to a pops mail server)
$ openssl s_client -connect mail.foo.com:995
CONNECTED(00000003)
depth=0 /C=US/ST=Nowhere/O=Foo/OU=bar/CN=mail.foo.com
$$---
---
+OK Dovecot ready. <1c32.1a611.4c4859c2.BEuUvAEtnt0du+msvFig0w==@mail.foo.com>
$$ user {username}
+OK
$$ pass {password}
+OK Logged in.
$$ stat
+OK 509 15659197
$$ quit
+OK Logging out.
closed
}}}

Produces output like this:

More Details

This is a WikiProcessor so it is used with the standard #! notation. This processor injects css code into Trac, so you should get formatted output by default. Any tagged code is inside a span element, and the following classes are used:

• se-input
• se-input-userreplacement
• se-input-string
• se-input-continuation
• se-input-option
• se-input-delayed
• se-prompt
• se-prompt-start
• se-prompt-user
• se-prompt-userhostseparator
• se-prompt-host
• se-prompt-path
• se-prompt-end
• se-root
• se-unprivileged
• se-note
• se-output
• se-output-snipped

{{{
#!ShellExample
{user@foo ~/path/to}$ foo --user {username}
}}}

results in something like the following (expanded for easier reading):

<div class="code">
  <pre>
    <span class="se-prompt">
        <span class="se-prompt-start">{</span>
        <span class="se-prompt-user">user</span>
        <span class="se-prompt-userhostseparator">@</span>
        <span class="se-prompt-host">foo</span> 
        <span class="se-prompt-path">~/path/to</span>
        <span class="se-prompt-end">}</span>
    </span>
    <span class="se-unprivileged">$ </span>
    <span class="se-input">foo <span class="se-input-option">--user</span> <span class="se-input-userreplacement">{username}</span></span>
  </pre>
</div>

Bugs/Feature Requests

Existing bugs and feature requests for ShellExampleMacro are here.

If you have any issues, create a new ticket.

Download

Download the current source (0.12.2) from here.

Source

You can check out ShellExampleMacro from here using Subversion, or browse the source with Trac.

Recent Changes

[11485] by rjollos on 04/14/12 02:37:00

Fixes #9900: get_templates_dirs needs to return an empty list, but it was returning None. This should fix a reported instance of the AnnouncerPlugin throwing an error.

[11484] by rjollos on 04/14/12 02:26:50

Removed empty directory.

[10269] by nmadura on 06/08/11 21:48:59

tagged 0.12.2 release

[10268] by nmadura on 06/08/11 21:34:25

addressed potential Ticket #8858 by removing ternary expression

Author/Contributors

This plugin was originally developed by mOo. Nathaniel Madura significantly updated this plugin, and took over maintenance of it.

Author: nmadura
Maintainer: nmadura
Contributors: