/ 
App-PS1-0.08
River stage zero No dependents
/ README
App-PS1 Coverage Status

App-PS1

Sick of the boring BASH shell command prompt, want more information displayedi App-PS1 does this.

It provides a nice way of addind a line sepperator for your prompt which you can fill with various peices of information like the directory, status of the last command and more.

The app-ps1 command displays the elements put into either $APP_PS1 environment variable or passed with --ps1 parameter. The elements are all calculated and if one more more has no content (eg branch, perl, node or ruby) it is removed and all the rest are show. If there is too much to display on the line (requires Term::Size::Any or $PS1_COLS environment variable to be set) the elements from the right are dropped until the line would fit.

Examples

# in your ~/.bashrc file
export APP_PS1='face;branch;date;direcory;perl;node;ruby;uptime'
export PS1="\[\`app-ps1 -e\$?\`\]\n\u@\h \\\$ "

Basic:

After running $ perlbrew use perl-bleed

After running $ nvm use v0.12.4

INSTALLATION

To install this module, run the following commands:

perl Build.PL
./Build
./Build test
./Build install

CONFIGURATION AND ENVIRONMENT

Lots of environment variables are used to configure the command prompt

$APP_PS1

Sets the elements to be displayed (overridden by --ps1)

Default 'face;branch;date;directory;uptime',

$APP_PS1_THEME

Sets the colour theme for the prompt

  • default

  • green

  • blue

Default 'default',

$PS1_COLS

If Term::Size::Any is not installed you can configure the width of your screen by setting this parameter.

Default 90,

$UNICODE_UNSAFE

If set to a true value this will allow UTF8 characters to be used displaying the prompt

Default not set

$APP_PS1_BACKGROUND

Set the line's background colour

Default 52

SUPPORT AND DOCUMENTATION

After installing, you can find documentation for this module with the perldoc command.

perldoc App::PS1

You can also look for information at:

RT, CPAN's request tracker
    http://rt.cpan.org/NoAuth/Bugs.html?Dist=App-PS1

AnnoCPAN, Annotated CPAN documentation
    http://annocpan.org/dist/App-PS1

CPAN Ratings
    http://cpanratings.perl.org/d/App-PS1

Search CPAN
    http://search.cpan.org/dist/App-PS1/

Source Code
    git://github.com/ivanwills/App-PS1.git

COPYRIGHT AND LICENCE

Copyright (C) 2010-2014 Ivan Wills

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.