crates/shirabe/src/plugin/plugin_interface.rs


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

//! ref: composer/src/Composer/Plugin/PluginInterface.php

use crate::composer::ComposerHandle;
use crate::io::IOInterface;
use crate::plugin::Capable;

pub const PLUGIN_API_VERSION: &str = "2.9.0";

pub trait PluginInterface: std::fmt::Debug {
    fn activate(
        &mut self,
        composer: &ComposerHandle,
        io: std::rc::Rc<std::cell::RefCell<dyn IOInterface>>,
    );

    fn deactivate(
        &mut self,
        composer: &ComposerHandle,
        io: std::rc::Rc<std::cell::RefCell<dyn IOInterface>>,
    );

    fn uninstall(
        &mut self,
        composer: &ComposerHandle,
        io: std::rc::Rc<std::cell::RefCell<dyn IOInterface>>,
    );

    // TODO(plugin): PHP-side `instanceof` checks for EventSubscriberInterface / Capable.
    // EventSubscriberInterface is not dyn-compatible (its only method is associated, not
    // a `&self` method), so we expose a boolean predicate instead.
    fn is_event_subscriber_interface(&self) -> bool {
        false
    }

    fn as_capable(&self) -> Option<&dyn Capable> {
        None
    }
}