General

Reports by version and tester

• 0.82: zenog

Sample reporting for each feature:

Who	SVN revision	Padre version	system	status
szabgab	r13895	v0.84	Ubuntu 10.10	fail #1107
szabgab	r15835	v0.86	Ubuntu 10.10	success
szabgab	r15835	v0.86	Strawberry Perl 5.12	success

In case of failure please include the following information in the bug report:

• OS:
• Perl:
• Wx:
• wxWidgets:
• Wx::Perl::ProcessStream?:
• PPI:

Prepare for the testing

• check whether you are running the to-be-released Padre version by opening the "About" box

If you'd like to test the current development version of Padre then please check it out as

svn co http://svn.perlide.org/padre/trunk/Padre

and then run it from there.

If you'd like to test the release branch then please check out the release branch:

svn co http://svn.perlide.org/padre/branches/Padre-0.84/

Do the regular things:

perl Makefile.PL
make
make test

and then launch padre using

perl -Ilib script/padre

Other possibility is to actually install the release candidate using

make install

and then launch by just typing

padre

What to report

• for each single item
  • OK or
    • crashes
    • inconsistent behaviour
    • actions that do not work as expected
• for each section
  • How much time did it take you to perform the tests?

Test Cases

Perl 5 scripts

1. open a Perl script (using Ctrl-o or File/Open?)
2. run it by hitting F5
3. change to the other output variant (external window or internal pane) (Tools/Preferences/Run? Parameters/Use? external window for execution)
4. run it by hitting Shift-F5
5. enable syntax checks (View/Show? Syntax Check)
6. introduce a syntax error and inspect resulting output
7. click on the syntax error to jump to the position of the error
8. enable autocomplete at "Tools"->"Preferences"->"Autocomplete"
9. start typing a word which is already in the file (maybe "warn" from "warnings")
10. hit Ctrl-Space, select a suggestion and confirm it
11. enable bracket autocomplete at "Tools"->"Preferences"->"Behavior"
12. type ( [ { " ' - each of them should get its closing part automatically

Perl 5 modules

1. open a large Perl module from the Padre source
2. enable "View"->"Show Functions"
3. double-click on a function name to jump to its location in the file
   • the text cursor should be at the corresponding function in the file
4. enable "View"->"Show Outline"
5. double-click on a method name to jump to its location in the file
   • the text cursor should be at the corresponding location in the file

Project Browser

Features/ProjectBrowser

Open Resource

Features/OpenResource

Text files

1. "File" -> "New"
2. save it as file.txt
3. save it as file
4. load a text file from disk
5. use "Edit" -> "Go To ..." to jump to a given line
6. use "Edit" -> "Go To ..." to jump to a given character position

Saving perl file without extension needs to remember its mime-type

See #1107, #849

1. "File" -> "New"
2. type in

   #!/usr/bin/perl
   use strict;
   use warnings;
   

3. save it as file
4. Check if the mime-type (3rd box on the status bar) says "Perl 5"
5. Close the file
6. Open The file using "File" -> "Open"
7. Check if the mime-type (3rd box on the status bar) says "Perl 5"
8. Open The file using "File" -> "Save As"
9. save it as file2
10. Check if the mime-type (3rd box on the status bar) says "Perl 5"

1. Repeat the above but this time the content of the file should be

   #!/usr/bin/env perl
   
   print 42;
   

1. A third time in which case the content should be

   #!/usr/local/bin/perl
   
   print "ok";
   

Perl distributions and templates and running

1. create a new Perl 5 distribution: "File" -> "New" -> "Perl Distribution ..."
2. create an additional "hello, world" style Perl 5 module in the same namespace: "File" -> "New" -> "Perl 5 Module"
3. use "File" -> "Save Intuition" to save the module
4. create a test for the module: "File" -> "New" -> "Perl 5 Test"
5. run the test: "Run" -> "Run Tests"
6. run the test: "Run" -> "Run and Build Tests"
7. create a new Perl 5 script that uses the module: "File" -> "New" -> "Perl 5 Script"
8. run it: "Run" -> "Run Script"
9. run it: "Run" -> "Run Script (Debug Info)"
10. add an infinite loop the the script
11. run the script and abort it using F6

Sessions

TODO: For further description see ​http://mail.perlide.org/pipermail/padre-dev/2011-February/002433.html and expand this test-case

1. cycle through the files using the keyboard: Ctrl-PageUp? and Ctrl-PageDown?
2. save the session
3. close one tab
4. go to "File" -> "Recent Files" and re-open the file ( #1143, #1148 )
5. close all tabs
6. load the session that you saved before

Padre server

1. start Padre
2. "Tools" -> "Preferences": enable "Open Files in existing Padre"
3. restart Padre
4. type padre SOME_FILE in the command line (should open in the same instance of Padre)
5. "Tools" -> "Preferences": disable "Open Files in existing Padre"
6. restart Padre
7. type padre SOME_FILE in the command line (should start a new instance of Padre)

Code Folding

View -> Show Code Folding. by enabling code folding padre will put ':' at the end of every statement(unless you already put it). (statement example;

my $x=5; print (" x is now $x");

)

Whites paces

View -> Show Whitespaces by enabling white spaces pare will put a dot each time you click on the "Space" button. also white spaces will show you an arrow each time you click on the "Tab" button.

Word Wrap

View -> Word-Wrap. by enabling word wrap, padre wont let you expand the code block horizontally, if you'll try it will go to the next line.

Indentation Guide

View -> Show Indentation Guide. by enabling it you will see a vertical lines that will show you where a block starts and ends.

Right Margin

1. Start padre.
2. Write a script or open perl module.
3. Enable Right Margin View -> Show Right Margin.
4. Go to the Advanced Preferences editor via 'Tools/Preferences/Advanced?'.
5. In the 'Filter' type "right_margin_column" and click on the item 'editor_right_margin_column'
6. At the bottom of the screen you will see the details of this option
7. The default is "80" change the value to "150" than press "Set" and than press "Save". you will see that the right margin mark has moved to the right.
8. Now go back to the Advanced Preferences Editor select the editor_right_margin_column again and press "Reset" and than press "Save".
9. Now it should go back to default (value = 80), middle of the screen.

Current Line

First Option

1. Start padre.
2. Write a script or open perl module.
3. Enable Current Line View -> Show Current Line.
4. Go to Tools -> Preferences.
5. On the left side you'll have a list of options, go to "Appearance".
6. There you'll have "Editor Current Line Background Colour" and on the right you can pick the new colour you want, pick a colour(yellow is the default) than Press the "Ok" button and than Press the "Save" button.

Second Option

See #1150

1. Start padre.
2. Write a script or open perl module.
3. Enable Right Margin View -> Show Current Line.
4. Go to Tools -> Preferences.
5. There are 3 buttons at the bottom "Save", "Advanced" and "Cancel". Press the "Advanced" button.
6. Write down on the filter's search box "editor_currentline_colour" and press it.
7. than you can change the value(= colour of the "Current Line) to "#FF0000" (Red).
8. than Press the button "Set" and after that Press the Button "Save" on the bottom.

Syntax highlighting

Features/SyntaxHighlighting

Setting the title bar

Padre allows the configuration of the window title and provides placeholders for various values. The actual template can be set in Tools/Preferences/Apperance/Window? title The available placeholders are:

• %p - Project name
• %v - Padre version
• %f - Current filename
• %d - Current file's dirname
• %b - Current file's basename
• %F - Current filename relative to project

strings that look like placeholder but are not supported yet will appear verbatim.

See #1153, #1138, and #1104

1. In Tools/Preferences/Apperance? Set the Window title to
   • %b - %f - %p - %d - %F - %v - %x - %%
2. Open a file in the Padre project (e.g. lib/Padre.pm)
3. Check if the title displays the correct information
   • Padre.pm - path/to/lib/Padre.pm - ??? - lib - lib/Padre.pm - ??? - %x - %%
4. Create a new file (File/New?)
5. Check if the title displays the correct information

TBD

Searching and Replacing

Features/SearchAndReplace

Debugging a Perl 5 script

TBD by szabgab

Related #928, #929, #930, #931, #1005, #1036, #1083, #1085, #1086

Installing CPAN modules

TBD by szabgab

Related #501, #1031, #1044, #1045

Fresh Padre Installation

TODO: we should add some tests to check if a fresh Padre installation (or an upgrade) works

The Command Line Window

Features/CommandLineWindow

TODO List

TODO List

Refactoring

Features/RefactoringPerl5

Regex Editor

Features/RegexEditor

Perl Tidy

Features/PerlTidy

Perl Critic

Features/PerlCritic