Padre provides automatic project management for "standard" Perl projects. A project is a directory structure. The root of the directory tree is where Padre finds on of the project indicators:

  • Makefile.PL
  • Build.PL
  • dist.ini
  • or if none of those exist creating an empty padre.yml file will tell padre what is the root.

The project browser is a window on the left hand side of Padre that allows the user to see the directory structure of the project and the files in the project. It also allows opening files and other files-system related operations.


Ticket Resolution Summary Owner Reporter
#1391 duplicate Hit unfixed bug in directory browser, disabling it adamk bowtie
#1338 duplicate Opening a File not in Project kills Padre bowtie
#1249 fixed Directory Browser needs a refresh button for directories Sewi
#1248 fixed Directory Browser Crash on deleted item Sewi
#1208 duplicate Directory/Project browser: File deletion does not trigger rescan Sewi
#1166 duplicate Project/Directory Browser doesn't recognize new top level directories Sewi
#1141 Project browser does not default to the default directory in the configuration claudio claudio
#1120 project browser should update itself via polling zenogantner
#1048 file/directory browser zenogantner
#1037 fixed calling the project view "Directory Tree" is confusing zenogantner
#1018 fixed Cannot open file from Directory Tree (Project) side panel ryg
#880 allow the Project (directory tree) window to be linked with the editor adamk karl.forner
#879 Search in directory via contextual-menu on a folder karl.forner
#851 not relevant can't go to parent directory in directory view mateu
#825 fixed Directroy Tree Search locks up Padre when no documents are opened waxhead
#694 Directory browser changes unpredictably perlpilot
#489 fixed dist-zilla projects not taken into account jquelin
#391 fixed Allow renaming a file szabgab
#370 fixed Directory Tree state is destroyed on refresh adamk
#358 fixed Directory Tree Browse behaviour waxhead
#95 fixed Add directory and filesystem browser szabgab


  1. Launch Padre
  2. Close all files using File -> Close -> Close all files
  3. Open the project browser using View -> Show Project Browser/Tree?
  4. A window should open on the left hand side of Padre
  5. It should be empty (TBD. I am not sure this is a good behavior)
  6. Open the Makefile.PL of the Padre project using Ctrl+O
  7. The project browser window should be filled with the directory tree of Padre
  8. close Makefile.PL
  9. The project browser window should become empty (TBD. should it become empty?)
  10. Now open the share/styles/default.yml in the Padre project
  11. The project browser should show the directory of the Padre project again
  12. browse the directories of the Padre project
  13. open a file from the project by double-clicking on its name in the project browser
  14. save it under another name using F12
  15. check if the file appears in the Project Browser window
  16. delete the newly created file (using the tools of your operating system, outside of Padre)
  17. observe that the listing of the file has disappeared from the Project browser
  18. load file using "Search" -> "Open Resource ..."


  • describe what padre.yml is for
  • projects for non perl 5 projects
  • Integrate with VCS
Last modified 4 years ago Last modified on Mar 31, 2011, 10:15:02 AM