Struct Group 

pub struct Group { /* private fields */ }

A named group of nested questionnaire items.

The id is the stable machine identity rendered as the line-terminal tag (<id:command.inputs>); the prompt is human wording and may be edited freely. Every child’s ID must extend the group’s ID with a . segment (command.inputs → command.inputs.name), which keeps submitted occurrence paths derivable from definition IDs.

A plain group (Group::new) renders and is answered exactly once — it structures related questions under one heading. A repeatable group (Group::repeatable) is answered once per submitted occurrence: rendering emits exactly the declared minimum number of blank blocks, and a person adds items by copying a complete block (its heading line and its questions). The number of submitted items is inferred from occurrences of the stable group header, never from display numbers or wording.

Implementations

impl Group

pub fn new( id: impl Into<String>, prompt: impl Into<String>, children: impl IntoIterator<Item = impl Into<Item>>, ) -> Self

Create a non-repeatable group with a stable id, human prompt wording, and nested children.

The id, the child-ID prefix rule, and all nested declarations are validated when the group is passed to Questionnaire::new, not here.

pub fn repeatable(self, min: usize) -> Self

Make this group repeatable with at least min occurrences (min >= 1; rendering emits exactly min blank blocks).

Repeat bounds are semantic: they change the fingerprint.

pub fn max_occurrences(self, max: usize) -> Self

Bound a repeatable group to at most max occurrences.

Only meaningful after repeatable; Questionnaire::new rejects a maximum on a non-repeatable group or a maximum below the minimum. Semantic: changes the fingerprint.

pub fn id(&self) -> &str

The stable group ID.

pub fn prompt(&self) -> &str

The human wording (cosmetic).

pub fn children(&self) -> &[Item]

The nested items, in presentation order.

pub fn repeat(&self) -> Option<Repeat>

The repeat bounds, or None for a group answered exactly once.

Trait Implementations

impl Clone for Group

fn clone(&self) -> Group

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Group

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

Formats the value using the given formatter.

impl Eq for Group

impl From<Group> for Item

fn from(group: Group) -> Self

Converts to this type from the input type.

impl PartialEq for Group

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Group