souprune 0.5.1

A game framework designed specifically for Deltarune / Undertale fangames.
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
112
113
114
115
116
117
118

//! # multi_source.rs
//!
//! # multi_source.rs 文件
//!
//! ## Module Overview
//!
//! ## 模块概述
//!
//! This module provides a custom asset reader that supports multiple source directories.
//!
//! 该模块提供了一个支持多个源目录的自定义资产读取器。
//!
//! ## Source File Overview
//!
//! ## 源文件概述
//!
//! It implements `MultiSourceAssetReader` to allow cascading lookups for assets.
//!
//! 它实现了 `MultiSourceAssetReader` 以允许对资产进行级联查找。

use bevy::asset::io::file::FileAssetReader;
use bevy::asset::io::{AssetReader, AssetReaderError, PathStream, Reader};
use bevy::prelude::*;
use bevy::tasks::ConditionalSendFuture;
use std::path::Path;

/// A composite asset reader that tries to read from multiple sources in order.
///
/// 一个复合资产读取器，按顺序尝试从多个源读取。
pub struct MultiSourceAssetReader {
    readers: Vec<FileAssetReader>,
}

impl MultiSourceAssetReader {
    pub fn new(readers: Vec<FileAssetReader>) -> Self {
        Self { readers }
    }
}

impl AssetReader for MultiSourceAssetReader {
    fn read<'a>(
        &'a self,
        path: &'a Path,
    ) -> impl ConditionalSendFuture<Output = Result<Box<dyn Reader + 'a>, AssetReaderError>> + 'a
    {
        Box::pin(async move {
            for reader in &self.readers {
                match reader.read(path).await {
                    Ok(result) => return Ok(Box::new(result) as Box<dyn Reader + 'a>),
                    Err(e) => {
                        if matches!(e, AssetReaderError::NotFound(_)) {
                            continue;
                        }
                        continue;
                    }
                }
            }
            Err(AssetReaderError::NotFound(path.to_path_buf()))
        })
    }

    fn read_meta<'a>(
        &'a self,
        path: &'a Path,
    ) -> impl ConditionalSendFuture<Output = Result<Box<dyn Reader + 'a>, AssetReaderError>> + 'a
    {
        Box::pin(async move {
            for reader in &self.readers {
                match reader.read_meta(path).await {
                    Ok(result) => return Ok(Box::new(result) as Box<dyn Reader + 'a>),
                    Err(e) => {
                        if matches!(e, AssetReaderError::NotFound(_)) {
                            continue;
                        }
                        continue;
                    }
                }
            }
            Err(AssetReaderError::NotFound(path.to_path_buf()))
        })
    }

    fn read_directory<'a>(
        &'a self,
        path: &'a Path,
    ) -> impl ConditionalSendFuture<Output = Result<Box<PathStream>, AssetReaderError>> {
        Box::pin(async move {
            for reader in &self.readers {
                match reader.read_directory(path).await {
                    Ok(result) => return Ok(result),
                    Err(e) => {
                        if matches!(e, AssetReaderError::NotFound(_)) {
                            continue;
                        }
                        continue;
                    }
                }
            }
            Err(AssetReaderError::NotFound(path.to_path_buf()))
        })
    }

    fn is_directory<'a>(
        &'a self,
        path: &'a Path,
    ) -> impl ConditionalSendFuture<Output = Result<bool, AssetReaderError>> {
        Box::pin(async move {
            for reader in &self.readers {
                match reader.is_directory(path).await {
                    Ok(true) => return Ok(true),
                    Ok(false) => continue,
                    Err(_) => continue,
                }
            }
            Ok(false)
        })
    }
}