pub struct ReleaseFile<'a> { /* private fields */ }Expand description
A Debian repository Release file.
Release files contain metadata and list the index files for a repository. They are effectively the entrypoint for defining a Debian repository and its content.
Instances are wrappers around a ControlParagraph. Deref and DerefMut are implemented to allow obtaining the inner ControlParagraph. From and Into are implemented to allow cheap type coercions. Note that converting from ReleaseFile to ControlParagraph may discard PGP cleartext signature data.
Implementations§
Source§impl<'a> ReleaseFile<'a>
impl<'a> ReleaseFile<'a>
Sourcepub fn from_reader<R: BufRead>(reader: R) -> Result<Self>
pub fn from_reader<R: BufRead>(reader: R) -> Result<Self>
Construct an instance by reading data from a reader.
The source must be a Debian control file with exactly 1 paragraph.
The source must not be PGP armored. i.e. do not feed it raw InRelease
files that begin with -----BEGIN PGP SIGNED MESSAGE-----.
Sourcepub fn from_armored_reader<R: BufRead>(reader: R) -> Result<Self>
pub fn from_armored_reader<R: BufRead>(reader: R) -> Result<Self>
Construct an instance by reading data from a reader containing a PGP cleartext signature.
This can be used to parse content from an InRelease file, which begins
with -----BEGIN PGP SIGNED MESSAGE-----.
An error occurs if the PGP cleartext file is not well-formed or if a PGP parsing error occurs.
The PGP signature is NOT validated. The file will be parsed despite lack of signature verification. This is conceptually insecure. But since Rust has memory safety, some risk is prevented.
Sourcepub fn signatures(&self) -> Option<&CleartextSignatures>
pub fn signatures(&self) -> Option<&CleartextSignatures>
Obtain PGP signatures from this InRelease file.
Sourcepub fn description(&self) -> Option<&str>
pub fn description(&self) -> Option<&str>
Description of this repository.
Sourcepub fn version(&self) -> Option<&str>
pub fn version(&self) -> Option<&str>
Version of this repository.
Typically a sequence of . delimited integers.
Sourcepub fn suite(&self) -> Option<&str>
pub fn suite(&self) -> Option<&str>
Suite of this repository.
e.g. stable, unstable, experimental.
Sourcepub fn components(&self) -> Option<Box<dyn Iterator<Item = &str> + '_>>
pub fn components(&self) -> Option<Box<dyn Iterator<Item = &str> + '_>>
Names of components within this repository.
These are areas within the repository. Values may contain path characters.
e.g. main, updates/main.
Sourcepub fn architectures(&self) -> Option<Box<dyn Iterator<Item = &str> + '_>>
pub fn architectures(&self) -> Option<Box<dyn Iterator<Item = &str> + '_>>
Debian machine architectures supported by this repository.
e.g. all, amd64, arm64.
Sourcepub fn date_str(&self) -> Option<&str>
pub fn date_str(&self) -> Option<&str>
Time the release file was created, as its raw string value.
Sourcepub fn date(&self) -> Option<Result<DateTime<Utc>>>
pub fn date(&self) -> Option<Result<DateTime<Utc>>>
Time the release file was created, as a DateTime.
The timezone from the original file is always normalized to UTC.
Sourcepub fn valid_until_str(&self) -> Option<&str>
pub fn valid_until_str(&self) -> Option<&str>
Time the release file should be considered expired by the client, as its raw string value.
Sourcepub fn valid_until(&self) -> Option<Result<DateTime<Utc>>>
pub fn valid_until(&self) -> Option<Result<DateTime<Utc>>>
Time the release file should be considered expired by the client.
Sourcepub fn not_automatic(&self) -> Option<bool>
pub fn not_automatic(&self) -> Option<bool>
Evaluated value for NotAutomatic field.
true is returned iff the value is yes. no and other values result in false.
Sourcepub fn but_automatic_upgrades(&self) -> Option<bool>
pub fn but_automatic_upgrades(&self) -> Option<bool>
Evaluated value for ButAutomaticUpgrades field.
true is returned iff the value is yes. no and other values result in false.
Sourcepub fn acquire_by_hash(&self) -> Option<bool>
pub fn acquire_by_hash(&self) -> Option<bool>
Whether to acquire files by hash.
Sourcepub fn iter_index_files(
&self,
checksum: ChecksumType,
) -> Option<Box<dyn Iterator<Item = Result<ReleaseFileEntry<'_>>> + '_>>
pub fn iter_index_files( &self, checksum: ChecksumType, ) -> Option<Box<dyn Iterator<Item = Result<ReleaseFileEntry<'_>>> + '_>>
Obtain indexed files in this repository.
Files are grouped by their checksum variant.
If the specified checksum variant is present, Some is returned.
The returned iterator emits ReleaseFileEntry instances. Entries are lazily parsed as they are consumed from the iterator. Parse errors result in an Err.
Sourcepub fn iter_classified_index_files(
&self,
checksum: ChecksumType,
) -> Option<Box<dyn Iterator<Item = Result<ClassifiedReleaseFileEntry<'_>>> + '_>>
pub fn iter_classified_index_files( &self, checksum: ChecksumType, ) -> Option<Box<dyn Iterator<Item = Result<ClassifiedReleaseFileEntry<'_>>> + '_>>
Obtain indexed files in this repository classified to their type.
This is like Self::iter_index_files() except it attempts classify each ReleaseFileEntry into a well-defined file type, returning a ClassifiedReleaseFileEntry.
If an entry doesn’t map to a more well-defined type, ClassifiedReleaseFileEntry::Other will be emitted. If an error occurs when coercing an entry to its stronger type, Err will be emitted instead of ClassifiedReleaseFileEntry::Other.
Sourcepub fn iter_contents_indices(
&self,
checksum: ChecksumType,
) -> Option<Box<dyn Iterator<Item = Result<ContentsFileEntry<'_>>> + '_>>
pub fn iter_contents_indices( &self, checksum: ChecksumType, ) -> Option<Box<dyn Iterator<Item = Result<ContentsFileEntry<'_>>> + '_>>
Obtain Contents indices entries given a checksum flavor.
This essentially looks for Contents* files in the file lists.
The emitted entries have component and architecture values derived by the file paths. These values are not checked against the list of components and architectures defined by this file.
Sourcepub fn iter_packages_indices(
&self,
checksum: ChecksumType,
) -> Option<Box<dyn Iterator<Item = Result<PackagesFileEntry<'_>>> + '_>>
pub fn iter_packages_indices( &self, checksum: ChecksumType, ) -> Option<Box<dyn Iterator<Item = Result<PackagesFileEntry<'_>>> + '_>>
Obtain Packages indices entries given a checksum flavor.
This essentially looks for Packages* files in the file lists.
The emitted entries have component and architecture values derived by the file paths. These values are not checked against the list of components and architectures defined by this file.
Sourcepub fn find_packages_indices(
&self,
checksum: ChecksumType,
compression: Compression,
component: &str,
arch: &str,
is_installer: bool,
) -> Option<PackagesFileEntry<'_>>
pub fn find_packages_indices( &self, checksum: ChecksumType, compression: Compression, component: &str, arch: &str, is_installer: bool, ) -> Option<PackagesFileEntry<'_>>
Find a PackagesFileEntry given search constraints.
Sourcepub fn iter_sources_indices(
&self,
checksum: ChecksumType,
) -> Option<Box<dyn Iterator<Item = Result<SourcesFileEntry<'_>>> + '_>>
pub fn iter_sources_indices( &self, checksum: ChecksumType, ) -> Option<Box<dyn Iterator<Item = Result<SourcesFileEntry<'_>>> + '_>>
Obtain Sources indices entries given a checksum flavor.
This essentially looks for Sources* files in the file lists.
Sourcepub fn find_sources_indices(
&self,
checksum: ChecksumType,
compression: Compression,
component: &str,
) -> Option<SourcesFileEntry<'_>>
pub fn find_sources_indices( &self, checksum: ChecksumType, compression: Compression, component: &str, ) -> Option<SourcesFileEntry<'_>>
Find a SourcesFileEntry given search constraints.
Methods from Deref<Target = ControlParagraph<'a>>§
Sourcepub fn is_empty(&self) -> bool
pub fn is_empty(&self) -> bool
Whether the paragraph is empty.
Empty is defined by the lack of any fields.
Sourcepub fn set_field(&mut self, field: ControlField<'a>)
pub fn set_field(&mut self, field: ControlField<'a>)
Set the value of a field via a ControlField.
If a field with the same name (case insensitive compare) already exists, the old value will be replaced by the incoming value.
Sourcepub fn set_field_from_string(&mut self, name: Cow<'a, str>, value: Cow<'a, str>)
pub fn set_field_from_string(&mut self, name: Cow<'a, str>, value: Cow<'a, str>)
Set the value of a field defined via strings.
If a field with the same name (case insensitive compare) already exists, the old value will be replaced by the incoming value.
Sourcepub fn has_field(&self, name: &str) -> bool
pub fn has_field(&self, name: &str) -> bool
Whether a named field is present in this paragraph.
Sourcepub fn iter_fields(&self) -> impl Iterator<Item = &ControlField<'a>>
pub fn iter_fields(&self) -> impl Iterator<Item = &ControlField<'a>>
Iterate over fields in this paragraph.
Iteration order is insertion order.
Sourcepub fn field(&self, name: &str) -> Option<&ControlField<'a>>
pub fn field(&self, name: &str) -> Option<&ControlField<'a>>
Obtain the field with a given name in this paragraph.
Sourcepub fn field_mut(&mut self, name: &str) -> Option<&'a mut ControlField<'_>>
pub fn field_mut(&mut self, name: &str) -> Option<&'a mut ControlField<'_>>
Obtain a mutable reference to the field with a given name.
Sourcepub fn required_field(&self, name: &str) -> Result<&ControlField<'a>>
pub fn required_field(&self, name: &str) -> Result<&ControlField<'a>>
Obtain the named field and error if it isn’t defined.
Sourcepub fn field_str(&self, name: &str) -> Option<&str>
pub fn field_str(&self, name: &str) -> Option<&str>
Obtain the raw string value of the named field.
Sourcepub fn required_field_str(&self, name: &str) -> Result<&str>
pub fn required_field_str(&self, name: &str) -> Result<&str>
Obtain the raw string value of the named field, erroring if the field is not present.
Sourcepub fn field_bool(&self, name: &str) -> Option<bool>
pub fn field_bool(&self, name: &str) -> Option<bool>
Obtain the value of a field, evaluated as a boolean.
The field is true iff its string value is yes.
Sourcepub fn field_u64(&self, name: &str) -> Option<Result<u64>>
pub fn field_u64(&self, name: &str) -> Option<Result<u64>>
Obtain the value of a field, evaluated as a u64.
Sourcepub fn field_dependency_list(
&self,
name: &str,
) -> Option<Result<DependencyList>>
pub fn field_dependency_list( &self, name: &str, ) -> Option<Result<DependencyList>>
Obtain the value of a field, parsed as a DependencyList.
Sourcepub fn field_datetime_rfc5322(
&self,
name: &str,
) -> Option<Result<DateTime<Utc>>>
pub fn field_datetime_rfc5322( &self, name: &str, ) -> Option<Result<DateTime<Utc>>>
Obtain the value of a field parsed as an RFC 5322 date string.
This will parse values like Sat, 09 Oct 2021 09:34:56 UTC.
The timezone is always normalized to UTC even if it is expressed differently in the source string.
Sourcepub fn field_simple(&self, name: &str) -> Option<Result<ControlFieldValue<'a>>>
pub fn field_simple(&self, name: &str) -> Option<Result<ControlFieldValue<'a>>>
Obtain the field with the given name as a ControlFieldValue::Simple, if possible.
Sourcepub fn field_folded(&self, name: &str) -> Option<ControlFieldValue<'a>>
pub fn field_folded(&self, name: &str) -> Option<ControlFieldValue<'a>>
Obtain the field with the given name as a ControlFieldValue::Folded.
Sourcepub fn field_multiline(&self, name: &str) -> Option<ControlFieldValue<'a>>
pub fn field_multiline(&self, name: &str) -> Option<ControlFieldValue<'a>>
Obtain the field with the given name as a ControlFieldValue::Multiline.
Sourcepub fn iter_field_words(
&self,
name: &str,
) -> Option<Box<dyn Iterator<Item = &str> + '_>>
pub fn iter_field_words( &self, name: &str, ) -> Option<Box<dyn Iterator<Item = &str> + '_>>
Obtain an iterator of words in the named field.
Sourcepub fn iter_field_lines(
&self,
name: &str,
) -> Option<Box<dyn Iterator<Item = &str> + '_>>
pub fn iter_field_lines( &self, name: &str, ) -> Option<Box<dyn Iterator<Item = &str> + '_>>
Obtain an iterator of lines in the named field.
Sourcepub fn iter_field_comma_delimited(
&self,
name: &str,
) -> Option<Box<dyn Iterator<Item = &str> + '_>>
pub fn iter_field_comma_delimited( &self, name: &str, ) -> Option<Box<dyn Iterator<Item = &str> + '_>>
Obtain an iterator of comma-delimited values in the named field.
Sourcepub fn as_str_hash_map(&self) -> HashMap<&str, &str>
pub fn as_str_hash_map(&self) -> HashMap<&str, &str>
Convert this paragraph to a HashMap.
Values will be the string normalization of the field value, including newlines and leading whitespace.
If a field occurs multiple times, its last value will be recorded in the returned map.
Sourcepub fn write<W: Write>(&self, writer: &mut W) -> Result<()>
pub fn write<W: Write>(&self, writer: &mut W) -> Result<()>
Serialize the paragraph to a writer.
A trailing newline is written as part of the final field. However, an extra newline is not present. So if serializing multiple paragraphs, an additional line break must be written to effectively terminate this paragraph if the writer is not at EOF.