pub struct AiCache { /* private fields */ }Expand description
Content-addressed cache backed by .bock/ai-cache/.
Implementations§
Source§impl AiCache
impl AiCache
Sourcepub fn new(project_root: &Path) -> Self
pub fn new(project_root: &Path) -> Self
Creates a cache rooted at <project_root>/.bock/ai-cache/.
Does not create the directory; it is materialised on first
put.
Sourcepub fn get<R: Serialize, S: DeserializeOwned>(&self, request: &R) -> Option<S>
pub fn get<R: Serialize, S: DeserializeOwned>(&self, request: &R) -> Option<S>
Returns the cached response for request, or None on miss.
On a serialization or I/O error the entry is treated as a miss
— the cache is best-effort and never blocks a fresh provider
call. To inspect the underlying error explicitly use
get_strict.
Sourcepub fn get_strict<R: Serialize, S: DeserializeOwned>(
&self,
request: &R,
) -> Result<Option<S>, CacheError>
pub fn get_strict<R: Serialize, S: DeserializeOwned>( &self, request: &R, ) -> Result<Option<S>, CacheError>
Like get but surfaces serialization or I/O errors
instead of silently treating them as misses.
§Errors
Returns CacheError when request hashing, file I/O, or
response deserialization fails.
Sourcepub fn put<R: Serialize, S: Serialize>(
&self,
request: &R,
response: &S,
) -> Result<(), CacheError>
pub fn put<R: Serialize, S: Serialize>( &self, request: &R, response: &S, ) -> Result<(), CacheError>
Stores response keyed by the canonical hash of request.
Creates intermediate shard directories on demand. Existing entries with the same key are overwritten — the cache is content-addressed, so the new write would only differ from the old if the response itself changed for the same request.
§Errors
Returns CacheError on serialization or I/O failure.
Sourcepub fn contains<R: Serialize>(&self, request: &R) -> bool
pub fn contains<R: Serialize>(&self, request: &R) -> bool
Returns true if a cached entry exists for request.
Sourcepub fn clear(&self) -> Result<()>
pub fn clear(&self) -> Result<()>
Removes every cached entry by deleting the cache root.
§Errors
Returns an I/O error if the directory exists but cannot be removed.
Sourcepub fn stats(&self) -> Result<CacheStats>
pub fn stats(&self) -> Result<CacheStats>
Walks the cache directory and counts entries + bytes.
§Errors
Returns an I/O error if directory traversal fails.
Trait Implementations§
Auto Trait Implementations§
impl Freeze for AiCache
impl RefUnwindSafe for AiCache
impl Send for AiCache
impl Sync for AiCache
impl Unpin for AiCache
impl UnsafeUnpin for AiCache
impl UnwindSafe for AiCache
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
Source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> Paint for Twhere
T: ?Sized,
impl<T> Paint for Twhere
T: ?Sized,
Source§fn fg(&self, value: Color) -> Painted<&T>
fn fg(&self, value: Color) -> Painted<&T>
Returns a styled value derived from self with the foreground set to
value.
This method should be used rarely. Instead, prefer to use color-specific
builder methods like red() and
green(), which have the same functionality but are
pithier.
§Example
Set foreground color to white using fg():
use yansi::{Paint, Color};
painted.fg(Color::White);Set foreground color to white using white().
use yansi::Paint;
painted.white();Source§fn bright_black(&self) -> Painted<&T>
fn bright_black(&self) -> Painted<&T>
Source§fn bright_red(&self) -> Painted<&T>
fn bright_red(&self) -> Painted<&T>
Source§fn bright_green(&self) -> Painted<&T>
fn bright_green(&self) -> Painted<&T>
Source§fn bright_yellow(&self) -> Painted<&T>
fn bright_yellow(&self) -> Painted<&T>
Source§fn bright_blue(&self) -> Painted<&T>
fn bright_blue(&self) -> Painted<&T>
Source§fn bright_magenta(&self) -> Painted<&T>
fn bright_magenta(&self) -> Painted<&T>
Source§fn bright_cyan(&self) -> Painted<&T>
fn bright_cyan(&self) -> Painted<&T>
Source§fn bright_white(&self) -> Painted<&T>
fn bright_white(&self) -> Painted<&T>
Source§fn bg(&self, value: Color) -> Painted<&T>
fn bg(&self, value: Color) -> Painted<&T>
Returns a styled value derived from self with the background set to
value.
This method should be used rarely. Instead, prefer to use color-specific
builder methods like on_red() and
on_green(), which have the same functionality but
are pithier.
§Example
Set background color to red using fg():
use yansi::{Paint, Color};
painted.bg(Color::Red);Set background color to red using on_red().
use yansi::Paint;
painted.on_red();Source§fn on_primary(&self) -> Painted<&T>
fn on_primary(&self) -> Painted<&T>
Source§fn on_magenta(&self) -> Painted<&T>
fn on_magenta(&self) -> Painted<&T>
Source§fn on_bright_black(&self) -> Painted<&T>
fn on_bright_black(&self) -> Painted<&T>
Source§fn on_bright_red(&self) -> Painted<&T>
fn on_bright_red(&self) -> Painted<&T>
Source§fn on_bright_green(&self) -> Painted<&T>
fn on_bright_green(&self) -> Painted<&T>
Source§fn on_bright_yellow(&self) -> Painted<&T>
fn on_bright_yellow(&self) -> Painted<&T>
Source§fn on_bright_blue(&self) -> Painted<&T>
fn on_bright_blue(&self) -> Painted<&T>
Source§fn on_bright_magenta(&self) -> Painted<&T>
fn on_bright_magenta(&self) -> Painted<&T>
Source§fn on_bright_cyan(&self) -> Painted<&T>
fn on_bright_cyan(&self) -> Painted<&T>
Source§fn on_bright_white(&self) -> Painted<&T>
fn on_bright_white(&self) -> Painted<&T>
Source§fn attr(&self, value: Attribute) -> Painted<&T>
fn attr(&self, value: Attribute) -> Painted<&T>
Enables the styling Attribute value.
This method should be used rarely. Instead, prefer to use
attribute-specific builder methods like bold() and
underline(), which have the same functionality
but are pithier.
§Example
Make text bold using attr():
use yansi::{Paint, Attribute};
painted.attr(Attribute::Bold);Make text bold using using bold().
use yansi::Paint;
painted.bold();Source§fn rapid_blink(&self) -> Painted<&T>
fn rapid_blink(&self) -> Painted<&T>
Source§fn quirk(&self, value: Quirk) -> Painted<&T>
fn quirk(&self, value: Quirk) -> Painted<&T>
Enables the yansi Quirk value.
This method should be used rarely. Instead, prefer to use quirk-specific
builder methods like mask() and
wrap(), which have the same functionality but are
pithier.
§Example
Enable wrapping using .quirk():
use yansi::{Paint, Quirk};
painted.quirk(Quirk::Wrap);Enable wrapping using wrap().
use yansi::Paint;
painted.wrap();Source§fn clear(&self) -> Painted<&T>
👎Deprecated since 1.0.1: renamed to resetting() due to conflicts with Vec::clear().
The clear() method will be removed in a future release.
fn clear(&self) -> Painted<&T>
renamed to resetting() due to conflicts with Vec::clear().
The clear() method will be removed in a future release.
Source§fn whenever(&self, value: Condition) -> Painted<&T>
fn whenever(&self, value: Condition) -> Painted<&T>
Conditionally enable styling based on whether the Condition value
applies. Replaces any previous condition.
See the crate level docs for more details.
§Example
Enable styling painted only when both stdout and stderr are TTYs:
use yansi::{Paint, Condition};
painted.red().on_yellow().whenever(Condition::STDOUTERR_ARE_TTY);