1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

use super::{
  Footnote, GroupAbbreviation, GroupAbbreviationDisplay, GroupBarline, GroupName, GroupNameDisplay, GroupSymbol,
  GroupTime, Level,
};
use crate::datatypes::{StartStop, Token};
use musicxml_internal::*;
use musicxml_macros::*;

/// Attributes pertaining to the [PartGroup] element.
#[derive(Debug, PartialEq, Eq, AttributeDeserialize, AttributeSerialize)]
pub struct PartGroupAttributes {
  /// Indicates the start or stop of the [PartGroup].
  pub r#type: StartStop,
  /// Distinguishes overlapping and nested [PartGroup] elements, not a sequence of
  /// [PartGroup] elements. The default value is 1.
  pub number: Option<Token>,
}

/// Contents of the [PartGroup] element.
#[derive(Debug, Default, PartialEq, Eq, ContentDeserialize, ContentSerialize)]
pub struct PartGroupContents {
  /// The [GroupName] element specifies the name of the group.
  pub group_name: Option<GroupName>,
  /// The [GroupNameDisplay] element specifies how the group name should be displayed.
  pub group_name_display: Option<GroupNameDisplay>,
  /// The [GroupAbbreviation] element specifies the abbreviation of the group name.
  pub group_abbreviation: Option<GroupAbbreviation>,
  /// The [GroupAbbreviationDisplay] element specifies how the group abbreviation should be displayed.
  pub group_abbreviation_display: Option<GroupAbbreviationDisplay>,
  /// The [GroupSymbol] element specifies the symbol of the group.
  pub group_symbol: Option<GroupSymbol>,
  /// The [GroupBarline] element specifies the barline of the group.
  pub group_barline: Option<GroupBarline>,
  /// The [GroupTime] element specifies the time signature of the group.
  pub group_time: Option<GroupTime>,
  /// The [Footnote] element specifies a footnote or endnote.
  pub footnote: Option<Footnote>,
  /// The [Level] element specifies the level of the group.
  pub level: Option<Level>,
}

/// The [PartGroup] element indicates groupings of parts in the score, usually indicated by braces and brackets.
///
/// Braces that are used for multi-staff parts should be defined in the [Attributes][super::Attributes] element for that part. The [PartGroup] start element appears before
/// the first [ScorePart][super::ScorePart] in the group. The [PartGroup] stop element appears after the last [ScorePart][super::ScorePart] in the group.
///
/// As with [Parts][super::Part], a [PartGroup] can have a name and abbreviation. Values for the child elements are ignored at the stop of a [PartGroup].
///
/// A [PartGroup] element is not needed for a single multi-staff part. By default, multi-staff parts include a brace symbol and
/// (if appropriate given the [BarStyle][super::BarStyle]) common barlines. The symbol formatting for a multi-staff part can be more fully specified
/// using the [PartSymbol][super::PartSymbol] element.
#[derive(Debug, PartialEq, Eq, ElementDeserialize, ElementSerialize)]
#[rename("part-group")]
pub struct PartGroup {
  /// Element-specific attributes
  pub attributes: PartGroupAttributes,
  #[flatten]
  /// Element-specific content
  pub content: PartGroupContents,
}