Koha-clms/debian
Tomas Cohen Arazi 80de9fa97c Bug 18964: Add --debugger option to koha-plack
CAVEAT: This patch is only about allowing koha-plack to start a debugging
session on a remote target. Configuring all the needed pieces to make it
work is out of the scope of the bug. Testing should be focused (mainly) on
making sure this introduces NO REGRESSIONS on regular use (i.e. not debugging).

This patch adds the following option switches to koha-plack:

--debugger
----------
Toggle debugging

--debugger-key
--------------
Some IDEs require a key, this needs to match because they are picky about it

--debugger-location
-------------------
This option switch is used to specify the host:port your IDE is listening at.
Inside kohadevbox (using Vdebug with Vim) this would be localhost:9000. Outside
kohadevbox it would be 192.168.50.1:9000

--debugger-path
---------------
This is the path in which you installed the Komodo Remote Debugger library [1]. In kohadevbox
you could put the contents of the downloaded .tar.gz in /home/vagrant/dbgp/perllib. That
perllib seems to be required for things to work [2].

You can test with a simple CLI script things work:

PERL5LIB=/home/vagrant/dbgp/perllib:$PERL5LIB \
PERLDB="BEGIN { require q(/home/vagrant/dbgp/perllib/perl5db.pl) }" \
PERLDB_OPTS="RemotePort=192.168.50.1:9000" perl -d t/Prices.t

If you see action on your IDE, you are on the right track on the IDE side.

To test:
- Apply this patch
- Enable remote debugging on your IDE, on port 9000 (or adjust the command
  below to match your IDE's listening port).
- Download the Komodo Remote Debugger package, and place the package's contents
  in /home/vagrant/dbgp/perllib (you should see perl5db.pl in there).
- Run:
  $ sudo koha-plack --stop kohadev
  $ sudo kohaclone/debian/koha-plack --start \
                                     --debugger \
                                     --debugger-path /home/vagrant/dbgp/perllib \
                                     --debugger-location 192.168.50.1:9000 \
                                     kohadev
=> SUCCESS: You IDE/tool gets a connection from the Plack process.
- Sign off :-D

The explanation on how to use it assumes you are running kohadevbox.

WARNING: The main difficulty I found was setting the right dir/file mappings.

[1] http://code.activestate.com/komodo/remotedebugging/
[2] https://github.com/Komodo/KomodoEdit/issues/644#issuecomment-236268012

Signed-off-by: Jonathan Druart <jonathan.druart@bugs.koha-community.org>

Signed-off-by: Jonathan Druart <jonathan.druart@bugs.koha-community.org>
2018-01-23 16:05:54 -03:00
..
docs Bug 17951: Make koha-create set template_cache_dir correctly 2017-12-22 13:15:39 -03:00
scripts Bug 18964: Add --debugger option to koha-plack 2018-01-23 16:05:54 -03:00
source Bug 18696: Change debian/source/format to quilt 2018-01-19 15:14:05 -03:00
templates Bug 17951: Make koha-create set template_cache_dir correctly 2017-12-22 13:15:39 -03:00
README.build
…
bd-to-depends Bug 4847: Remove the python dependency for package builds 2015-03-25 11:22:49 -03:00
build-git-snapshot Bug 17013 - build-git-snapshot: add basetgz parameter and update master version number 2016-08-08 13:13:24 +00:00
changelog Bug 17019 - debian/changelog update 2016-08-08 14:30:55 +00:00
compat
…
control Bug 18993: Allow Test::More version 1.302073 2017-12-07 10:09:51 -03:00
control.in Bug 18993: Allow Test::More version 1.302073 2017-12-07 10:09:51 -03:00
copyright
…
koha-common.README.Debian
…
koha-common.bash-completion Bug 17467: Add tab-completion for koha-zebra 2017-10-27 14:10:30 -03:00
koha-common.config Bug 11404: (follow-up) only ask user if there are instances needing upgrading 2014-05-19 21:51:33 +00:00
koha-common.cron.d Bug 16823 - Comment out koha-rebuild-zebra in koha-common.cron.d 2016-07-08 13:26:55 +00:00
koha-common.cron.daily Bug 17669: Add new switch to crontab example and debian daily cron file 2017-04-21 13:55:25 -04:00
koha-common.cron.hourly
…
koha-common.cron.monthly Bug 13585: Add a cronjob which send UsageStats monthly. 2015-09-07 10:47:06 -03:00
koha-common.default Bug 16830: Remove -x usage on koha-indexer 2016-08-04 19:41:41 +00:00
koha-common.dirs Bug 17951: Make koha-create set template_cache_dir correctly 2017-12-22 13:15:39 -03:00
koha-common.docs Bug 10802: make Debian package install history.txt 2013-09-16 15:27:16 +00:00
koha-common.init Bug 16822: Make koha-common call koha-plack without --quiet 2016-09-09 09:27:45 +00:00
koha-common.install Bug 19462: Add a koha-elasticsearch command 2017-10-27 14:10:31 -03:00
koha-common.logrotate Bug 16138: Restart plack when rotating logfiles 2016-04-01 18:47:01 +00:00
koha-common.postinst Bug 14106: (QA followup) avoid failures if no instances created 2015-05-22 12:28:14 -03:00
koha-common.preinst Bug 14068: fix preinst for fresh package installs 2015-04-29 15:14:10 -03:00
koha-common.templates Bug 11404: Make the install process aware of the changes 2014-05-19 21:50:54 +00:00
koha-post-install-setup
…
koha.README.Debian
…
koha.apache-ports
…
koha.config
…
koha.dirs
…
koha.install
…
koha.postinst
…
koha.postrm
…
koha.prerm
…
list-deps Bug 18907: Build has deprecating message 2017-12-07 10:09:52 -03:00
rules Bug 14167: remove the log4perl.conf file from /etc for packages 2015-07-24 12:54:23 -03:00
unavailable.html
…
update-control
…

README.build

In order to build .deb packages, following debian packages need to be present
(installed): 
devscripts
pbuilder
dh-make
fakeroot

As root (or sudo) execute:
pbuilder create

Executing build-git-snapshot without any arguments will leave package and the
rest in some pbuilder dir, eg. /var/cache/pbuilder/result It is highly
recommended that --buildresult option is used.