Trait ot_certs::asn1::builder::Builder

source · 
pub trait Builder {

Show 13 methods    // Required methods
    fn push_byte(&mut self, val: u8) -> Result<()>;
    fn push_boolean(&mut self, tag: &Tag, val: &Value<bool>) -> Result<()>;
    fn push_integer(
        &mut self,
        name_hint: Option<String>,
        tag: &Tag,
        val: &Value<BigUint>
    ) -> Result<()>;
    fn push_integer_pad(
        &mut self,
        name_hint: Option<String>,
        val: &Value<BigUint>,
        size: usize
    ) -> Result<()>;
    fn push_byte_array(
        &mut self,
        name_hint: Option<String>,
        val: &Value<Vec<u8>>
    ) -> Result<()>;
    fn push_string(
        &mut self,
        name_hint: Option<String>,
        str_type: &Tag,
        val: &Value<String>
    ) -> Result<()>;
    fn push_oid(&mut self, oid: &Oid) -> Result<()>;
    fn push_tag(
        &mut self,
        name_hint: Option<String>,
        tag: &Tag,
        gen: impl FnOnce(&mut Self) -> Result<()>
    ) -> Result<()>;
    fn push_bitstring(
        &mut self,
        name_hint: Option<String>,
        tag: &Tag,
        bits: &[Value<bool>]
    ) -> Result<()>;

    // Provided methods
    fn push_octet_string(
        &mut self,
        name_hint: Option<String>,
        gen: impl FnOnce(&mut Self) -> Result<()>
    ) -> Result<()> { ... }
    fn push_seq(
        &mut self,
        name_hint: Option<String>,
        gen: impl FnOnce(&mut Self) -> Result<()>
    ) -> Result<()> { ... }
    fn push_set(
        &mut self,
        name_hint: Option<String>,
        gen: impl FnOnce(&mut Self) -> Result<()>
    ) -> Result<()> { ... }
    fn push_as_bit_string(
        &mut self,
        name_hint: Option<String>,
        tag: &Tag,
        unused_bits: usize,
        gen: impl FnOnce(&mut Self) -> Result<()>
    ) -> Result<()> { ... }

}
Expand description

Trait for an abstract ASN1 builder.

This builder does not specify what the output is, but only provides basic functions to build an ASN1 document. A possible implementation would be to output bytes to produce an actual DER encoding for example. This can also be used to generate C code that calls into a C library to produce a certificate. For this reason, this builder does not provide any way to access the result, as this is implementation specific.

Required Methods§

source

fn push_byte(&mut self, val: u8) -> Result<()>

Push a byte into the ASN1 output.

source

fn push_boolean(&mut self, tag: &Tag, val: &Value<bool>) -> Result<()>

Push a tagged boolean into the ASN1 output.

source

fn push_integer( &mut self, name_hint: Option<String>, tag: &Tag, val: &Value<BigUint> ) -> Result<()>

Push a tagged integer into the ASN1 output. The name hint can be used by the implementation for documentation purpose, or completely ignored.

source

fn push_integer_pad( &mut self, name_hint: Option<String>, val: &Value<BigUint>, size: usize ) -> Result<()>

Push a byte array into the ASN1 output, representing an integer. If the provided buffer is smaller than the provided size, it will be padded with zeroes. Note that this function does not add a tag to the ASN1 output.

source

fn push_byte_array( &mut self, name_hint: Option<String>, val: &Value<Vec<u8>> ) -> Result<()>

Push a byte array of fixed length into the ASN1 output. Note that this function does not add a tag to the ASN1 output.

source

fn push_string( &mut self, name_hint: Option<String>, str_type: &Tag, val: &Value<String> ) -> Result<()>

Push a tagged string into the ASN1 output.

source

fn push_oid(&mut self, oid: &Oid) -> Result<()>

Push a tagged object identifier into the ASN1 output.

source

fn push_tag( &mut self, name_hint: Option<String>, tag: &Tag, gen: impl FnOnce(&mut Self) -> Result<()> ) -> Result<()>

Push tagged content into the ASN1 output. The closure can use any available function of the builder and produces the content of the tagged data.

source

fn push_bitstring( &mut self, name_hint: Option<String>, tag: &Tag, bits: &[Value<bool>] ) -> Result<()>

Provided Methods§

source

fn push_octet_string( &mut self, name_hint: Option<String>, gen: impl FnOnce(&mut Self) -> Result<()> ) -> Result<()>

Push a tagged octet string into the ASN1 output. The closure can use any available function of the builder and produces the content of the octet string.

source

fn push_seq( &mut self, name_hint: Option<String>, gen: impl FnOnce(&mut Self) -> Result<()> ) -> Result<()>

Push a sequence into the ASN1 output. The closure can use any available function of the builder and produces the content of the sequence.

source

fn push_set( &mut self, name_hint: Option<String>, gen: impl FnOnce(&mut Self) -> Result<()> ) -> Result<()>

Push a sequence into the ASN1 output. The closure can use any available function of the builder and produces the content of the set.

source

fn push_as_bit_string( &mut self, name_hint: Option<String>, tag: &Tag, unused_bits: usize, gen: impl FnOnce(&mut Self) -> Result<()> ) -> Result<()>

Push tagged content into the ASN1 output as a bitstring. The closure can use any available function of the builder and the resulting content will be stored as a BITSTRING using the provided tag and unused number of bits.

Implementors§