~necoro/portato/0.8.6.2

« back to all changes in this revision

Viewing changes to doc/Hooks

  • Committer: Necoro
  • Date: 2008-03-24 22:05:07 UTC
  • Revision ID: svn-v3-trunk0:707e4503-1661-43cb-8fc9-483266be2d6d:tags%2F0.8.6.2:686
Moved versions back to tags

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
List of hooks currently being supported by Portato
 
2
==================================================
 
3
 
 
4
emerge:
 
5
-------
 
6
Called: When emerge or every other command given by e.g. the synccmd preference is being called.
 
7
Parameters:
 
8
        - string[] packages: Packages to emerge (includes "world", "system").
 
9
        - string[] command: The exact command to execute.
 
10
        - portato.gui.wrapper.Console console: The console the output will be written to.
 
11
        - function(string) -> None title_update: Function which updates the console title in the GUIs.
 
12
 
 
13
Return if override: Nothing
 
14
 
 
15
 
 
16
after_emerge:
 
17
-------------
 
18
Called: When the emerge process (or other - see emerge hook) is finished. 
 
19
Parameters:
 
20
        - string[] packages: The list of cpv's (plus "world", "system") which have been emerged. (Or not if it failed.)
 
21
        - int retcode: The return code of the command.
 
22
 
 
23
Return if override: Nothing
 
24
Comment: This uses an extra hook as emerge is started in an extra thread and thus all plugins being wanting to come "after" will be called while emerge is still running.
 
25
 
 
26
open_ebuild:
 
27
------------
 
28
Called: When an ebuild window is opened.
 
29
Parameters:
 
30
        - portato.backend.Package package: The current package whose is going to be displayed.
 
31
        - Window parent: The parent window. Exact type depends on the frontend.
 
32
 
 
33
Return if override: Window-object which can be called by the frontends. Please see the explicit code to see what is expected.
 
34
Comment: If you want to override - do this only for ONE specific frontend.