willbe 0.35.0

Utility to publish multi-crate and multi-workspace environments and maintain their consistency.
Documentation 
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
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126

#[ allow( clippy ::std_instead_of_alloc, clippy ::std_instead_of_core ) ]
mod private
{

  use crate :: *;
  // use action;
  // use error :: { err };
  use std ::fmt :: { Display, Formatter };
  // Explicit import for Result and its variants for pattern matching
  use std ::result ::Result :: { Ok, Err };

  #[ derive( Debug, Default ) ]
  struct ReadmeHeadersRenewReport
  {
  main_header_renew_report: action ::MainHeaderRenewReport,
  main_header_renew_error: Option< action ::MainHeaderRenewError >, // aaa: for Petro: typed error // aaa: done
  modules_headers_renew_report: action ::ModulesHeadersRenewReport,
  modules_headers_renew_error: Option< action ::ModulesHeadersRenewError >, // aaa: for Petro: typed error // aaa: done
 }

  impl Display for ReadmeHeadersRenewReport
  {
  fn fmt( &self, f: &mut Formatter< '_ > ) -> std ::fmt ::Result
  {
   match ( &self.main_header_renew_error, &self.modules_headers_renew_error )
   {
  ( Some( main ), Some( modules ) ) =>
  {
   writeln!
   (
  f,
  "Main header renew report: \
{}\nError: \n{:?}\nModules headers renew report: \n{}\nError: \n{:?}",
  self.main_header_renew_report, main, self.modules_headers_renew_report, modules
 )?;
 }
  ( Some( main ), None ) =>
  {
   writeln!
   (
  f,
  "Main header renew report: \
{}\nError: \n{:?}\nModules headers renew report: \n{}",
  self.main_header_renew_report, main, self.modules_headers_renew_report
 )?;
 }
  ( None, Some( modules) ) =>
  {
   writeln!
   (
  f,
  "Main header renew report: \
{}\nModules headers renew report: \n{}\nError: \n{:?}\n",
  self.main_header_renew_report, self.modules_headers_renew_report, modules
 )?;
 }
  ( None, None ) =>
  {
   writeln!
   (
  f,
  "Main header renew report: \n{}\n\nModules headers renew report: \n{}",
  self.main_header_renew_report, self.modules_headers_renew_report
 )?;
 }
 }
   Ok( () )
 }
 }

  /// Aggregates two commands: `generate_modules_headers` & `generate_main_header`
  /// # Errors
  /// qqq: doc
  pub fn readme_headers_renew() -> error ::untyped ::Result< () > // qqq: use typed error
  {
  let mut report = ReadmeHeadersRenewReport ::default();
  // let absolute_path = AbsolutePath ::try_from( std ::env ::current_dir()? )?;
  let abs_path = AbsolutePath ::try_from( std ::env ::current_dir()? )?;
  let crate_dir = CrateDir ::try_from( abs_path )?;
  let mut fail = false;

  match crate ::action ::main_header ::action( crate_dir.clone() )
  {
   Ok( r ) =>
   {
  report.main_header_renew_report = r;
 }
   Err( ( r, error ) ) =>
   {
  fail = true;
  report.main_header_renew_report = r;
  report.main_header_renew_error = Some( error );
 }
 }
  match action ::readme_modules_headers_renew( crate_dir )
  {
   Ok( r ) =>
   {
  report.modules_headers_renew_report = r;
 }
   Err( ( r, error ) ) =>
   {
  fail = true;
  report.modules_headers_renew_report = r;
  report.modules_headers_renew_error = Some( error );
 }
 }

  if fail
  {
   eprintln!( "{report}" );
   Err( error ::untyped ::format_err!( "Something went wrong" ) )
 }
  else
  {
   println!( "{report}" );
   Ok( () )
 }
 }
}

crate ::mod_interface!
{
  /// Generate header's.
  orphan use readme_headers_renew;
}