Struct NativeGitPlugin 

pub struct NativeGitPlugin;

Native git-object handler.

Implementations

impl NativeGitPlugin

pub fn new() -> Self

Trait Implementations

impl ArchiveTypePlugin for NativeGitPlugin

fn run_command(&self, cmd: &str, args: &[String]) -> Result<()>

CLI-only string dispatch (§13.3). A server never comes through here: it holds a GitStore and calls GitOps directly, typed.

refs is what that delegation looks like — open the store, call the trait method, print what it returned, and carry no logic of its own. The three commands beside it are older and are archive inspection, not store operations: they read a sealed archive’s sections, which is a different thing from a live store and is deliberately not modelled as a GitOps call. They are left as they are rather than bent through a trait that does not describe them.

fn matches_path(&self, path: &str) -> bool

A git archive’s entries are either oids — the whole relative_path is 40 or 64 lowercase hex characters — or the packs of a repository’s cold tier, pack-<id>.pack / pack-<id>.idx.

Both are the same ecosystem and so belong to one handler (P-1). Which of the two an archive holds is not a variant of the format: it is what the writer had. gunnar’s repack() produces a consolidated pack and seals that, because a pack preserves the pushing client’s own deflate and its delta chains, and an inflated per-oid tier destroys both permanently.

fn name(&self) -> &str

Human-readable name

fn type_id(&self) -> i8

DenseUnion type_id this plugin writes to

fn meta(&self) -> HandlerMeta

Discovery metadata — name, aliases, type_id, claimed extensions and the per-handler subcommand “API”. Used by the registry to list and select handlers at runtime. The default derives a minimal record from Self::name / Self::type_id; native handlers override it with a richer record (aliases, ecosystem, extensions, commands).

fn schema_fields(&self) -> Vec<Field>

The Arrow columns this module contributes to the index. The writer composes the on-disk schema as base columns + pkg_type + these fields. Each Field’s name must match the key the plugin uses in ExtensionRow::fields. Default: no columns.

fn extract_metadata(&self, path: &str, data: &[u8]) -> Option<ExtensionRow>

Per-file extraction. Return None to skip.

fn supports_batch(&self) -> bool

Whether this plugin benefits from batched processing.

fn batch_threshold(&self) -> usize

Byte threshold to trigger batch flush (default 200MB).

fn extract_batch(&self, items: &[BatchItem<'_>]) -> Vec<Option<ExtensionRow>>

Batch extraction — process many files at once (zero-copy borrows). Returns one Option per input item, in same order.

impl Default for NativeGitPlugin

fn default() -> Self

Returns the “default value” for a type.