Struct GenericPlugin 

pub struct GenericPlugin;

Archive any tree as opaque blobs. Extracts no metadata, claims no extension, contributes no Arrow column.

The type_id matters even though nothing is extracted: it is what stops a generic archive from being indistinguishable from a cargo one, and what makes znippy decompress --type generic mean something.

Implementations

impl GenericPlugin

pub fn new() -> Self

Trait Implementations

impl ArchiveTypePlugin for GenericPlugin

fn type_id(&self) -> i8

26 — the first free discriminant above the skeletons (4-24) and media (25), and below the out-of-crate handlers (40-42). Asserted against the whole register by znippy-cli’s handlers tests rather than restated here.

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

Permanently false, which is the whole point: PluginRegistry::extract gates on this, so extract_metadata is never reached and the compress path pays nothing per file.

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

Unreachable through the registry (see matches_path), and None if a caller invokes it directly: there is no metadata to claim.

fn name(&self) -> &str

Human-readable name

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 run_command(&self, cmd: &str, _args: &[String]) -> Result<()>

Dispatch a handler-specific subcommand (one of HandlerMeta::commands). Default: the handler exposes no extra subcommands.

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 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 GenericPlugin

fn default() -> Self

Returns the “default value” for a type.