Struct PayloadConfig 

pub struct PayloadConfig {
    pub max_per_category: usize,
    pub deduplicate: bool,
    pub marker_prefix: String,
    pub exclude_categories: Vec<String>,
    pub include_categories: Vec<String>,
    pub target_runtime: Option<Vec<String>>,
    pub marker_position: MarkerPosition,
    pub max_payload_length: usize,
}

Configuration for payload generation behavior.

Thread Safety

PayloadConfig is Send and Sync.

Fields

max_per_category: usize

Maximum payloads per category before truncation (0 = unlimited).

deduplicate: bool

Whether to deduplicate identical payloads within a category.

marker_prefix: String

Default marker prefix for taint tracking (e.g. “SLN”).

exclude_categories: Vec<String>

Categories to exclude from generation (e.g. for compliance).

include_categories: Vec<String>

Categories to include exclusively (empty = all).

target_runtime: Option<Vec<String>>

Restrict loaded grammars to one or more runtimes (empty = all).

marker_position: MarkerPosition

Where to place the taint marker in generated marker payloads.

max_payload_length: usize

Maximum length of a single payload in bytes (0 = unlimited).

Implementations

impl PayloadConfig

pub fn builder() -> PayloadConfigBuilder

Create a builder for PayloadConfig.

Example:

use attackstr::PayloadConfig;

let config = PayloadConfig::builder().marker_prefix("TRACE").build();
assert_eq!(config.marker_prefix, "TRACE");

pub fn load<P: AsRef<Path>>(path: P) -> Result<Self, PayloadError>

Load a PayloadConfig from a TOML file.

Example:

use attackstr::PayloadConfig;

let dir = tempfile::tempdir().unwrap();
let path = dir.path().join("payloads.toml");
std::fs::write(&path, "marker_prefix = \"TRACE\"\n").unwrap();

let config = PayloadConfig::load(&path).unwrap();
assert_eq!(config.marker_prefix, "TRACE");

Errors

Returns a PayloadError if reading or parsing the file fails.

pub fn from_toml( toml_str: &str, source: impl Into<String>, ) -> Result<Self, PayloadError>

Parse a PayloadConfig directly from TOML text.

Example:

use attackstr::{MarkerPosition, PayloadConfig};

let config = PayloadConfig::from_toml("marker_position = \"suffix\"", "<inline>").unwrap();
assert_eq!(config.marker_position, MarkerPosition::Suffix);

Errors

Returns a PayloadError if parsing the TOML fails.

Trait Implementations

impl Clone for PayloadConfig

fn clone(&self) -> PayloadConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PayloadConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for PayloadConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for PayloadConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for PayloadConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for PayloadConfig

impl Hash for PayloadConfig

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for PayloadConfig

fn eq(&self, other: &PayloadConfig) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for PayloadConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for PayloadConfig