servo-devtools 0.4.0

A component of the servo web-engine.
Documentation 
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
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107

/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at https://mozilla.org/MPL/2.0/. */

use std::sync::Arc;

use malloc_size_of_derive::MallocSizeOf;
use serde::Serialize;
use serde_json::{Map, Value};

use crate::StreamId;
use crate::actor::{Actor, ActorError, ActorRegistry, new_actor_name};
use crate::protocol::{ActorDescription, ClientRequest, Method};

#[derive(Serialize)]
struct GetDescriptionReply {
    from: String,
    value: SystemInfo,
}

// This is only a minimal subset of the properties exposed/expected by Firefox
// (see https://searchfox.org/mozilla-central/source/devtools/shared/system.js#45)
#[derive(Serialize)]
#[serde(rename_all = "camelCase")]
struct SystemInfo {
    apptype: String,
    // Display version
    version: String,
    // Build ID (timestamp with format YYYYMMDDhhmmss), used for compatibility checks
    // (see https://searchfox.org/mozilla-central/source/devtools/client/shared/remote-debugging/version-checker.js#82)
    appbuildid: String,
    // Firefox major.minor version number, use for compatibility checks
    platformversion: String,
    // Display name
    brand_name: String,
}

include!(concat!(env!("OUT_DIR"), "/build_id.rs"));

#[derive(MallocSizeOf)]
pub(crate) struct DeviceActor {
    name: String,
}

impl Actor for DeviceActor {
    fn name(&self) -> &str {
        &self.name
    }
    fn handle_message(
        &self,
        request: ClientRequest,
        _registry: &ActorRegistry,
        msg_type: &str,
        _msg: &Map<String, Value>,
        _id: StreamId,
    ) -> Result<(), ActorError> {
        match msg_type {
            "getDescription" => {
                let msg = GetDescriptionReply {
                    from: self.name().into(),
                    value: SystemInfo {
                        apptype: "servo".to_string(),
                        version: env!("CARGO_PKG_VERSION").to_string(),
                        appbuildid: BUILD_ID.to_string(),
                        platformversion: "146.0".to_string(),
                        brand_name: "Servo".to_string(),
                    },
                };
                request.reply_final(&msg)?
            },

            _ => return Err(ActorError::UnrecognizedPacketType),
        };
        Ok(())
    }
}

impl DeviceActor {
    pub fn register(registry: &ActorRegistry) -> Arc<Self> {
        let name = new_actor_name::<Self>();
        let actor = DeviceActor { name };
        registry.register::<Self>(actor)
    }

    pub fn description() -> ActorDescription {
        ActorDescription {
            category: "actor",
            type_name: "device",
            methods: vec![Method {
                name: "getDescription",
                request: Value::Null,
                response: Value::Object(
                    vec![(
                        "value".to_owned(),
                        Value::Object(
                            vec![("_retval".to_owned(), Value::String("json".to_owned()))]
                                .into_iter()
                                .collect(),
                        ),
                    )]
                    .into_iter()
                    .collect(),
                ),
            }],
        }
    }
}