gemini-rs 1.4.0

A library to interact with the Google Gemini API
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
108
109
110
111

use std::marker::PhantomData;

use crate::{
    Client, Result,
    types::{self, Response},
};

/// Simplest way to use gemini-rs, and covers 80% of use cases
pub struct Chat<T> {
    model: Box<str>,
    client: Client,
    system_instruction: Option<Box<str>>,
    safety_settings: Vec<types::SafetySettings>,
    history: Vec<types::Content>,
    config: Option<types::GenerationConfig>,
    phantom: PhantomData<T>,
}

impl<T> Chat<T> {
    pub fn new(client: &Client, model: &str) -> Self {
        Self {
            model: model.into(),
            client: client.clone(),
            system_instruction: None,
            safety_settings: Vec::new(),
            history: Vec::new(),
            config: None,
            phantom: PhantomData,
        }
    }

    pub fn config(&mut self) -> &types::GenerationConfig {
        self.config.get_or_insert_default()
    }

    pub fn to_json(mut self) -> Chat<Json> {
        self.config_mut().response_mime_type = Some("application/json".into());
        Chat {
            model: self.model,
            client: self.client,
            system_instruction: self.system_instruction,
            safety_settings: self.safety_settings,
            history: self.history,
            config: self.config,
            phantom: PhantomData,
        }
    }

    pub fn config_mut(&mut self) -> &mut types::GenerationConfig {
        self.config.get_or_insert_default()
    }

    pub fn history(&self) -> &[types::Content] {
        &self.history
    }

    pub fn history_mut(&mut self) -> &mut Vec<types::Content> {
        &mut self.history
    }

    pub fn safety_settings(&mut self, safety_settings: Vec<types::SafetySettings>) {
        self.safety_settings = safety_settings;
    }

    pub fn system_instruction(mut self, instruction: &str) -> Self {
        self.system_instruction = Some(Box::from(instruction));
        self
    }

    pub async fn generate_content(&mut self) -> Result<Response> {
        let mut generate_content = self.client.generate_content(&self.model);

        if let Some(system_instruction) = &self.system_instruction {
            generate_content.system_instruction(system_instruction);
        }

        if let Some(config) = &self.config {
            generate_content.config(config.clone());
        }

        generate_content.contents(self.history.clone());
        generate_content.safety_settings(self.safety_settings.clone());
        generate_content.await
    }

    pub async fn send_message(&mut self, message: &str) -> Result<Response> {
        self.history.push(types::Content {
            role: types::Role::User,
            parts: vec![types::Part::text(message)],
        });

        self.generate_content().await
    }
}

impl Chat<Json> {
    pub fn response_schema(mut self, schema: types::Schema) -> Self {
        self.config_mut().response_schema = Some(schema);
        self
    }

    pub async fn json<T: serde::de::DeserializeOwned>(&mut self, message: &str) -> Result<T> {
        let response = self.send_message(message).await?;
        let json = format!("{response}");
        serde_json::from_str(&json).map_err(Into::into)
    }
}

pub struct Text {}

pub struct Json {}