floopy-sdk 0.3.0

Official Floopy AI Gateway SDK for Rust. Drop-in wrapper around the async-openai crate with cache, audit, experiments, and security on top.
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

use serde::Deserialize;

/// A file stored on the upstream provider. v1 targets the `batch` purpose
/// (JSONL input + output files). Mirrors the OpenAI file shape; the gateway
/// forwards file traffic verbatim.
#[derive(Debug, Clone, Deserialize)]
pub struct FileObject {
    /// Provider-issued file id.
    pub id: String,
    /// Object type (usually `"file"`).
    #[serde(default)]
    pub object: Option<String>,
    /// File size in bytes.
    #[serde(default)]
    pub bytes: Option<i64>,
    /// Unix creation timestamp.
    #[serde(default)]
    pub created_at: Option<i64>,
    /// Original filename.
    #[serde(default)]
    pub filename: Option<String>,
    /// Upload purpose (e.g. `"batch"`).
    #[serde(default)]
    pub purpose: Option<String>,
    /// Processing status.
    #[serde(default)]
    pub status: Option<String>,
    /// Present (and `true`) on a delete response.
    #[serde(default)]
    pub deleted: Option<bool>,
}

/// Response of [`crate::resources::Files::list`].
#[derive(Debug, Clone, Deserialize)]
pub struct FileList {
    /// Object type (usually `"list"`).
    #[serde(default)]
    pub object: Option<String>,
    /// The files.
    #[serde(default)]
    pub data: Vec<FileObject>,
}

/// Arguments for [`crate::resources::Files::upload`].
#[derive(Debug, Clone)]
pub struct FileUploadParams {
    /// Raw file content (forwarded verbatim as a multipart part).
    pub file: Vec<u8>,
    /// Filename used in the multipart part. Defaults to `"file"`.
    pub filename: Option<String>,
    /// Upload purpose. Use `"batch"` for batch input files.
    pub purpose: String,
}

/// Filters for [`crate::resources::Files::list`].
#[derive(Debug, Clone, Default)]
pub struct FileListParams {
    /// Restrict to a single purpose.
    pub purpose: Option<String>,
    /// Page size.
    pub limit: Option<u32>,
    /// Cursor: return files after this id.
    pub after: Option<String>,
}

impl FileListParams {
    pub(crate) fn query(&self) -> Vec<(String, String)> {
        let mut q = Vec::new();
        if let Some(p) = &self.purpose {
            q.push(("purpose".to_owned(), p.clone()));
        }
        if let Some(l) = self.limit {
            q.push(("limit".to_owned(), l.to_string()));
        }
        if let Some(a) = &self.after {
            q.push(("after".to_owned(), a.clone()));
        }
        q
    }
}