pub enum DbFilesSchema {
V1(SchemaVersion),
}Expand description
A schema for the alpm-db-files format.
Variants§
V1(SchemaVersion)
Version 1 of the alpm-db-files specification.
Trait Implementations§
Source§impl AsRef<SchemaVersion> for DbFilesSchema
impl AsRef<SchemaVersion> for DbFilesSchema
Source§fn as_ref(&self) -> &SchemaVersion
fn as_ref(&self) -> &SchemaVersion
Returns a reference to the targeted SchemaVersion.
Source§impl Clone for DbFilesSchema
impl Clone for DbFilesSchema
Source§impl Debug for DbFilesSchema
impl Debug for DbFilesSchema
Source§impl Default for DbFilesSchema
impl Default for DbFilesSchema
Source§fn default() -> Self
fn default() -> Self
Returns the default schema variant (DbFilesSchema::V1).
impl Eq for DbFilesSchema
Source§impl FileFormatSchema for DbFilesSchema
impl FileFormatSchema for DbFilesSchema
Source§fn derive_from_file(file: impl AsRef<Path>) -> Result<Self, Self::Err>where
Self: Sized,
fn derive_from_file(file: impl AsRef<Path>) -> Result<Self, Self::Err>where
Self: Sized,
Creates a new DbFilesSchema from a file Path.
§Note
Delegates to Self::derive_from_reader after opening file for reading.
§Errors
Returns an error if
filecannot be opened for reading,- or
Self::derive_from_readerfails.
§Examples
use std::io::Write;
use alpm_common::FileFormatSchema;
use alpm_db::files::DbFilesSchema;
use tempfile::NamedTempFile;
let data = r#"%FILES%
usr/
usr/bin/
usr/bin/foo
"#;
let mut temp_file = NamedTempFile::new()?;
write!(temp_file, "{data}");
let schema = DbFilesSchema::derive_from_file(temp_file.path())?;
matches!(schema, DbFilesSchema::V1(_));
// Empty inputs may also be considered as a schema
let mut temp_file = NamedTempFile::new()?;
let schema = DbFilesSchema::derive_from_file(temp_file.path())?;
matches!(schema, DbFilesSchema::V1(_));Source§fn derive_from_reader(reader: impl Read) -> Result<Self, Self::Err>where
Self: Sized,
fn derive_from_reader(reader: impl Read) -> Result<Self, Self::Err>where
Self: Sized,
Creates a new DbFilesSchema from a Read implementation.
§Note
Delegates to Self::derive_from_str after reading the reader to string.
§Errors
Returns an error if
readercannot be read to string,- or
Self::derive_from_strfails.
§Examples
use std::io::{Seek, SeekFrom, Write};
use alpm_common::FileFormatSchema;
use alpm_db::files::DbFilesSchema;
use tempfile::tempfile;
let data = r#"%FILES%
usr/
usr/bin/
usr/bin/foo
"#;
let mut temp_file = tempfile()?;
write!(temp_file, "{data}");
temp_file.seek(SeekFrom::Start(0))?;
let schema = DbFilesSchema::derive_from_reader(temp_file)?;
matches!(schema, DbFilesSchema::V1(_));
// Empty inputs may also be considered as a schema
let mut temp_file = tempfile()?;
let schema = DbFilesSchema::derive_from_reader(temp_file)?;
matches!(schema, DbFilesSchema::V1(_));Source§fn derive_from_str(s: &str) -> Result<Self, Self::Err>where
Self: Sized,
fn derive_from_str(s: &str) -> Result<Self, Self::Err>where
Self: Sized,
Creates a new DbFilesSchema from a string slice.
§Errors
Returns an error if
- a
DbFilesSchemacannot be derived froms, - or a
DbFilesV1cannot be created froms.
§Examples
use alpm_common::FileFormatSchema;
use alpm_db::files::DbFilesSchema;
let data = r#"%FILES%
usr/
usr/bin/
usr/bin/foo
"#;
let schema = DbFilesSchema::derive_from_str(data)?;
matches!(schema, DbFilesSchema::V1(_));
// Empty inputs may also be considered as a schema
let data = "";
let schema = DbFilesSchema::derive_from_str(data)?;
matches!(schema, DbFilesSchema::V1(_));Source§impl MetadataFile<DbFilesSchema> for DbFiles
impl MetadataFile<DbFilesSchema> for DbFiles
Source§fn from_file_with_schema(
file: impl AsRef<Path>,
schema: Option<DbFilesSchema>,
) -> Result<Self, Self::Err>where
Self: Sized,
fn from_file_with_schema(
file: impl AsRef<Path>,
schema: Option<DbFilesSchema>,
) -> Result<Self, Self::Err>where
Self: Sized,
Creates a new DbFiles from a file Path and an optional DbFilesSchema.
§Note
Delegates to Self::from_reader_with_schema after opening file for reading.
§Errors
Returns an error if
- the
filecannot be opened for reading, - or
Self::from_reader_with_schemafails.
§Examples
use std::io::Write;
use alpm_common::MetadataFile;
use alpm_db::files::{DbFiles, DbFilesSchema};
use alpm_types::{SchemaVersion, semver_version::Version};
use tempfile::NamedTempFile;
let data = r#"%FILES%
usr/
usr/bin/
usr/bin/foo
"#;
let mut temp_file = NamedTempFile::new()?;
write!(temp_file, "{data}")?;
let files = DbFiles::from_file_with_schema(
temp_file.path(),
Some(DbFilesSchema::V1(SchemaVersion::new(Version::new(1, 0, 0)))),
)?;
matches!(files, DbFiles::V1(_));
assert_eq!(files.as_ref().len(), 3);Source§fn from_reader_with_schema(
reader: impl Read,
schema: Option<DbFilesSchema>,
) -> Result<Self, Self::Err>where
Self: Sized,
fn from_reader_with_schema(
reader: impl Read,
schema: Option<DbFilesSchema>,
) -> Result<Self, Self::Err>where
Self: Sized,
Creates a new DbFiles from a Read implementation and an optional DbFilesSchema.
§Note
Delegates to Self::from_str_with_schema after reading reader to string.
§Errors
Returns an error if
- the
readercannot be read to string, - or
Self::from_str_with_schemafails.
§Examples
use std::io::{Seek, SeekFrom, Write};
use alpm_common::MetadataFile;
use alpm_db::files::{DbFiles, DbFilesSchema};
use alpm_types::{SchemaVersion, semver_version::Version};
use tempfile::tempfile;
let data = r#"%FILES%
usr/
usr/bin/
usr/bin/foo
"#;
let mut temp_file = tempfile()?;
write!(temp_file, "{data}")?;
temp_file.seek(SeekFrom::Start(0))?;
let files = DbFiles::from_reader_with_schema(
temp_file,
Some(DbFilesSchema::V1(SchemaVersion::new(Version::new(1, 0, 0)))),
)?;
matches!(files, DbFiles::V1(_));
assert_eq!(files.as_ref().len(), 3);Source§fn from_str_with_schema(
s: &str,
schema: Option<DbFilesSchema>,
) -> Result<Self, Self::Err>where
Self: Sized,
fn from_str_with_schema(
s: &str,
schema: Option<DbFilesSchema>,
) -> Result<Self, Self::Err>where
Self: Sized,
Creates a new DbFiles from a string slice and an optional DbFilesSchema.
§Errors
Returns an error if
schemaisNoneand aDbFilesSchemacannot be derived froms,- or a
DbFilesV1cannot be created froms.
§Examples
use alpm_common::MetadataFile;
use alpm_db::files::{DbFiles, DbFilesSchema};
use alpm_types::{SchemaVersion, semver_version::Version};
let data = r#"%FILES%
usr/
usr/bin/
usr/bin/foo
"#;
let files = DbFiles::from_str_with_schema(
data,
Some(DbFilesSchema::V1(SchemaVersion::new(Version::new(1, 0, 0)))),
)?;
matches!(files, DbFiles::V1(_));
assert_eq!(files.as_ref().len(), 3);