archive.hpp File Reference

Bounded, deterministic capsule archive access. More...

#include <pulp/authoring_capsule/limits.hpp>
#include <pulp/authoring_capsule/status.hpp>
#include <pulp/runtime/result.hpp>
#include <cstdint>
#include <filesystem>
#include <memory>
#include <optional>
#include <span>
#include <string>
#include <string_view>
#include <vector>

Go to the source code of this file.

Classes
struct	pulp::authoring_capsule::MemberInfo
class	pulp::authoring_capsule::CapsuleArchive
	A reader over an admitted archive. More...
struct	pulp::authoring_capsule::WriteMember
	One member to write. path must already be normalized. More...

Namespaces
namespace	pulp
namespace	pulp::authoring_capsule

Functions
runtime::Result< CapsuleArchive, CapsuleError >	pulp::authoring_capsule::open_archive (const std::filesystem::path &path, const CapsuleLimits &limits=kCapsuleLimitsV1)
runtime::Result< std::uint64_t, CapsuleError >	pulp::authoring_capsule::write_archive_no_replace (const std::vector< WriteMember > &members, const std::filesystem::path &destination, const CapsuleLimits &limits=kCapsuleLimitsV1)
	Write deterministically to a path that must not already exist.

Detailed Description

Bounded, deterministic capsule archive access.

Reading is memory-bounded: the reader charges every allocation against a budget and refuses rather than growing. Writing is deterministic: the same inventory produces byte-identical output, with no timestamps, no host paths, and a fixed member order.