ikiwiki/doc/bugs/Error_with_external_plugins...

91 lines
5.2 KiB
Plaintext
Raw Normal View History

2015-06-15 04:00:55 +02:00
Hello,
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.
# Example
I set up an example wiki, containing the setup file and the plugin, [[on github|https://github.com/paternal/ikiwiki-rpcbug]].
1. Clone the repository
git clone https://github.com/paternal/ikiwiki-rpcbug.git
2. Change to the right directory
cd ikiwiki-rpcbug
2. Add the right ikiwiki directory to PYTHONPATH
export PYTHONPATH="$PYTHONPATH:$(dirname $(dpkg -L ikiwiki | grep proxy))"
3. Build the wiki
ikiwiki --setup wiki.setup --rebuild
4. The problem is in page [[http://localhost/~USERNAME/ikiwiki_bug_rpc/foo/]] (for instance, [[http://localhost/~USERNAME/ikiwiki_bug_rpc]] is fine.
# Problem
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.
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.
2015-06-19 21:48:53 +02:00
> 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]]
2015-06-15 04:00:55 +02:00
I hope someone will understand the problem better than I do, because I have no idea about how to solve this.
Regards,
2015-06-19 21:48:53 +02:00
-- [[Louis|spalax]]
> 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.
>
> * 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).
> * The directive causing the bug is called on page [foo](https://github.com/paternal/ikiwiki-rpcbug/blob/b4ba34a8edd1b97989965af69eddac050bc0a8ba/foo.mdwn).
> * Communication between Ikiwiki and the plugin is [[here|debug]].
> * The resulting HTML (for page `foo`) looks like:
>
> > \[[!rpcbug Erreur: internal error: foo cannot be found in /home/louis/projets/ikiwiki/rpcbug or underlay]]
> >
> >
> > Calling srcfile(foo): page
> > Calling srcfile(README.md): /home/louis/projets/ikiwiki/rpcbug/README.md
>
> My analysis:
>
> * The call to `srcfile(foo)` fails (because Ikiwiki thinks that page `foo` does not exist).
> * Ikiwiki thinks that processing of the directive is finished, whereas the plugin still waits for the answer of Ikiwiki.
> * 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).
>
> So, I think that this might be an error in the
> [`rpc_call`](https://github.com/joeyh/ikiwiki/blob/9476e2ac7ad2f53643fa2fca6ba35fcc55ab058e/IkiWiki/Plugin/external.pm#L46-147)
> function of the `external` plugin: when the called method fails, it should
> return something (or raise an exception, if this is possible in RPC) to notify
> the plugin that something went wrong.
>
> -- [[Louis|spalax]]
2015-06-29 09:32:42 +02:00
>> Update: This can actually be a [proxy](https://github.com/joeyh/ikiwiki/blob/9c910a76e70111c50ba8cbb518277f809fc1d09d/plugins/proxy.py) error. Indeed:
>>
>> - Ikiwiki sends a `methodCall` message to the plugin (which is a call to the
>> `preprocess` function);
>> - the plugin sends a `methodCall` message to ikiwiki (which is a call to the
>> `srcfile` function);
>> - Ikiwiki answers with a `methodCall` message:
>> - Ikiwiki answers this because the function call failed, and it is already
>> processing the next directive;
>> - the plugin thinks that it is its request answer, and misinterprets it.
>>
>> Thus, I think that the bug is in the `proxy.py` python file. On receiving a
>> `methodCall` (instead of a `methodResponse`) as an answer to a `methodCall`
2015-06-29 09:33:24 +02:00
>> request, `proxy.py` should notice the type of request, and call the requested function.
2015-06-29 09:32:42 +02:00
>>
>> I know Python better than I know Perl, so I can try to fix this.
>>
>> -- [[Louis|spalax]]
2015-07-04 23:35:33 +02:00
>>> [[!template id=gitbranch author="[[Louis|spalax]]" branch=spalax/paternal/rpcbug
>>> browse=https://github.com/paternal/ikiwiki/tree/paternal/rpcbug]]
>>> [I fixed this bug](https://github.com/paternal/ikiwiki/commit/32da347566a7559ca1ef145880efe961dbcc012f) in a branch on my Ikiwiki clone.
>>> Please review :)
>>>
>>> -- [[Louis|spalax]]