metabaiji-pod 1.1.1

版本缓存

版本缓存提供对文件存储库的访问。对这些文件的变化进行跟踪，并使用类似于semver的版本号进行标识。

要使用版本化缓存，您需要一个清单文件的副本，其中列出了所有版本化路径以及每个路径的最新版本。当您从缓存请求文件时，它会查询此清单文件以确定正确的版本。版本化缓存将加载委托给底层的资产缓存。

版本化缓存是为计算资源设计的：在代码中使用的代码块数据。当清单与代码一起检查时，它会固定每个资源的版本。如果资源随后被更新，则该代码的修订版将继续获取它期望的版本。

包含版本化资源的存储桶旨在不可变。那里不应该有任何更改或删除的操作。只能添加新版本。

清单如下所示

{
    "/foo/bar.csv": "1.2.5",
    "/foo/bar.json": "0.1.6"
}

要加载版本化资源

import json
from baiji.pod import AssetCache
from baiji.pod import Config
from baiji.pod import VersionedCache

config = Config()
# Improve performance by assuming the bucket is immutable.
config.IMMUTABLE_BUCKETS = ['my-versioned-assets']

vc = VersionedCache(
    cache=AssetCache(config),
    manifest_path='versioned_assets.json',
    bucket='my-versioned-assets')

with open(vc('/foo/bar.json'), 'r') as f:
    data = json.load(f)

或者，使用 `baiji-serialization <https://github.com/bodylabs/baiji-serialization>`__

from baiji.serialization import json
data = json.load(vc('s3://example-bucket/example.json'))

要添加新的版本化路径或更新现有的路径，请使用 vc 命令行工具

vc add /foo/bar.csv ~/Desktop/bar.csv
vc update --major /foo/bar.csv ~/Desktop/new_bar.csv
vc update --minor /foo/bar.csv ~/Desktop/new_bar.csv
vc update --patch /foo/bar.csv ~/Desktop/new_bar.csv

VersionedCache 对象特定于一个清单文件和一个存储桶。

尽管版本号使用类似 semver 的语义，但缓存忽略版本语义。清单固定一个确切的版本号。

资产缓存

资产缓存在较低层次上工作。它持有任意 S3 资产的本地区份。通过带有 S3 路径的 cache() 函数调用确保文件本地可用，然后返回一个有效的本地路径。

在缓存未命中时，文件将下载到缓存中，然后返回其本地路径。后续调用将返回相同的本地路径。在默认为一天的超时后，通过比较本地 MD5 哈希与远程 etag 来检查本地文件的有效性。这个检查每天重复一次。

为了提高性能，您可以配置不可变存储桶，其内容在下载后永远不会重新验证。版本化缓存使用此功能。

import json
from baiji.pod import AssetCache

cache = AssetCache.create_default()

with open(cache('s3://example-bucket/example.json'), 'r') as f:
    data = json.load(f)

或者，使用 `baiji-serialization <https://github.com/bodylabs/baiji-serialization>`__

from baiji.serialization import json
data = json.load(cache('s3://example-bucket/example.json'))

可以安全地多次调用 cache：cache(cache('path')) 将按预期执行。