Struct PermissionSetEncoder 

pub struct PermissionSetEncoder { /* private fields */ }

Encoder for permission sets.

The PermissionSetEncoder provides stateful encoding of permission sets from structured Permission data to binary or XML formats as defined in ECMA-335. It handles the complete encoding process including format markers, compression, and proper serialization of named arguments.

Design

The encoder converts permission structures to their binary representation with:

• Format Markers: Proper format identification bytes (0x2E for binary)
• Compression: Uses compressed integers for counts and lengths
• Type Encoding: Handles all supported argument types (Boolean, Int32, String)
• Assembly Resolution: Maps permission classes to appropriate assemblies

Usage Pattern

use dotscope::metadata::security::{PermissionSetEncoder, Permission, PermissionSetFormat};

let permissions = vec![/* ... */];
let mut encoder = PermissionSetEncoder::new();
let bytes = encoder.encode_permission_set(&permissions, PermissionSetFormat::BinaryLegacy)?;

Binary Format Structure

The binary format follows this structure:

1. Format marker: '.' (0x2E)
2. Permission count (compressed integer)
3. For each permission:
   - Class name length (compressed integer)
   - Class name (UTF-8 bytes)
   - Blob length (compressed integer)
   - Property count (compressed integer)
   - For each property:
     - Field/Property marker (0x54)
     - Type byte (0x02=Boolean, 0x04=Int32, 0x0E=String)
     - Property name length + UTF-8 name
     - Property value (format depends on type)

Implementations

impl PermissionSetEncoder

pub fn new() -> Self

Creates a new encoder.

Initializes a fresh encoder state with an empty buffer.

Returns

A new PermissionSetEncoder ready to encode permission sets.

pub fn encode_permission_set( &mut self, permissions: &[Permission], format: PermissionSetFormat, ) -> Result<Vec<u8>>

Encodes a permission set to the specified format.

Arguments

• permissions - The permissions to encode
• format - The target format for encoding

Errors

Returns an error if the permissions cannot be encoded or contain invalid data.

Trait Implementations

impl Default for PermissionSetEncoder

fn default() -> Self

Returns the “default value” for a type.