(no commit message)
[ikiwiki] / doc / bugs / Error_with_external_plugins.mdwn
1 Hello,
2 I stumbled upon this bug when writing a Python plugin. I think this is a ikiwiki bug, since I do not think my plugin does anything wrong.
3
4 # Example
5
6 I set up an example wiki, containing the setup file and the plugin, [[on github|https://github.com/paternal/ikiwiki-rpcbug]].
7
8 1. Clone the repository
9
10         git clone https://github.com/paternal/ikiwiki-rpcbug.git
11
12 2. Change to the right directory
13
14         cd ikiwiki-rpcbug
15
16 2. Add the right ikiwiki directory to PYTHONPATH
17
18         export PYTHONPATH="$PYTHONPATH:$(dirname $(dpkg -L ikiwiki | grep proxy))"
19
20 3. Build the wiki
21
22         ikiwiki --setup wiki.setup --rebuild
23
24 4. The problem is in page [[http://localhost/~USERNAME/ikiwiki_bug_rpc/foo/]] (for instance, [[http://localhost/~USERNAME/ikiwiki_bug_rpc]] is fine.
25
26 # Problem
27
28 Page `foo` contains the directive ``[[!rpcbug]]`` (`rpcbug` being the name of the plugin). Calling [[``proxy.rpc("srcfile", "bar")``|https://github.com/paternal/ikiwiki-rpcbug/blob/master/plugins/rpcbug#L15]] in the preprocess function seems to mess up the RPC communication between ikiwiki and the plugin, and the result is that the generate `foo/index.html` page is a text file containing the return value of the `preprocess` call.
29
30 What I do not understand is that disabling the `format` function (by commenting [[line 46 of the plugin|https://github.com/paternal/ikiwiki-rpcbug/blob/master/plugins/rpcbug#L46]]) solves the problem. Half of an explaination is that I think that when the the ``proxy.rpc`` function is called, the RPC communication is messed up in such a way that the `format` function is not called, and the return value of `preprocess` is considered to be the whole html code of the resulting page.
31
32 > I understood that: as the first rpc call messes up the communication, more rpc calls are messed up, but if there is only one rpc call, not that much is broken. -- [[Louis|spalax]]
33
34 I hope someone will understand the problem better than I do, because I have no idea about how to solve this.
35
36 Regards,    
37 -- [[Louis|spalax]]
38
39 > I used the debug feature provided with `proxy.py` and rebuilt the wiki. I ran this with [this version](https://github.com/paternal/ikiwiki-rpcbug/tree/b4ba34a8edd1b97989965af69eddac050bc0a8ba) of my minimal bug example.
40
41 > * The bug happens in function [preprocess](https://github.com/paternal/ikiwiki-rpcbug/blob/b4ba34a8edd1b97989965af69eddac050bc0a8ba/plugins/rpcbug#L12-17) (in call to [srcfile](https://github.com/paternal/ikiwiki-rpcbug/blob/b4ba34a8edd1b97989965af69eddac050bc0a8ba/plugins/rpcbug#L15), to be more precise).
42 > * The directive causing the bug is called on page [foo](https://github.com/paternal/ikiwiki-rpcbug/blob/b4ba34a8edd1b97989965af69eddac050bc0a8ba/foo.mdwn).
43 > * Communication between Ikiwiki and the plugin is [[here|debug]].
44 > * The resulting HTML (for page `foo`) looks like:
45
46 > > \[[!rpcbug Erreur: internal error: foo cannot be found in /home/louis/projets/ikiwiki/rpcbug or underlay]]
47 > >
48 > >
49 > > Calling srcfile(foo): page    
50 > > Calling srcfile(README.md): /home/louis/projets/ikiwiki/rpcbug/README.md
51
52 > My analysis:
53
54 > * The call to `srcfile(foo)` fails (because Ikiwiki thinks that page `foo` does not exist).
55 > * Ikiwiki thinks that processing of the directive is finished, whereas the plugin still waits for the answer of Ikiwiki.
56 > * Ikiwiki asks the plugin to render a new directive, but the plugin interprets the request as the return value for its previous request. Thus, the plugin thinks that `srcfile(foo)` is `page` (this `page` being a misinterpretation of the Ikiwiki request).
57
58 > So, I think that this might be an error in the
59 > [`rpc_call`](https://github.com/joeyh/ikiwiki/blob/9476e2ac7ad2f53643fa2fca6ba35fcc55ab058e/IkiWiki/Plugin/external.pm#L46-147)
60 > function of the `external` plugin: when the called method fails, it should
61 > return something (or raise an exception, if this is possible in RPC) to notify
62 > the plugin that something went wrong.
63
64 > -- [[Louis|spalax]]
65
66 >> Update: This can actually be a [proxy](https://github.com/joeyh/ikiwiki/blob/9c910a76e70111c50ba8cbb518277f809fc1d09d/plugins/proxy.py) error. Indeed:
67 >> 
68 >> - Ikiwiki sends a `methodCall` message to the plugin (which is a call to the
69 >>   `preprocess` function);
70 >> - the plugin sends a `methodCall` message to ikiwiki (which is a call to the
71 >>   `srcfile` function);
72 >> - Ikiwiki answers with a `methodCall` message:
73 >>   - Ikiwiki answers this because the function call failed, and it is already
74 >>     processing the next directive;
75 >>   - the plugin thinks that it is its request answer, and misinterprets it.
76 >> 
77 >> Thus, I think that the bug is in the `proxy.py` python file. On receiving a
78 >> `methodCall` (instead of a `methodResponse`) as an answer to a `methodCall`
79 >> request, `proxy.py` should notice the type of request, and call the requested function.
80 >> 
81 >> I know Python better than I know Perl, so I can try to fix this.
82 >> 
83 >> -- [[Louis|spalax]]
84
85 >>> [[!template id=gitbranch author="[[Louis|spalax]]" branch=spalax/paternal/rpcbug
86 >>>   browse=https://github.com/paternal/ikiwiki/tree/paternal/rpcbug]]
87 >>> [I fixed this bug](https://github.com/paternal/ikiwiki/commit/32da347566a7559ca1ef145880efe961dbcc012f) in a branch on my Ikiwiki clone.
88 >>> Please review :)
89 >>> 
90 >>> -- [[Louis|spalax]]