willbe 0.34.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

mod private
{

  use crate :: *;

  use std ::fs;
  use std ::path ::PathBuf;
  use wca ::VerifiedCommand;

  // use error ::Result;
  // qqq: group dependencies
  // use pth ::AbsolutePath;

  #[ derive( former ::Former ) ]
  struct PublishDiffProperties
  {
  keep_archive: Option< PathBuf >,
 }

  /// Command to display the differences between a local and remote package versions.
  ///
  /// # Arguments
  ///
  /// * `args` - Command line arguments.
  ///
  /// # Returns
  ///
  /// Returns a `Result` indicating success or failure.
  ///
  /// # Errors
  ///
  /// Returns an error if there is an issue with the command.
  ///
  /// # Panics
  /// qqq: doc
  pub fn publish_diff( o: VerifiedCommand ) -> error ::untyped ::Result< () > // qqq: use typed error
  {
  let path: PathBuf = o.args.get_owned( 0 ).unwrap_or( std ::env ::current_dir()? );
  let PublishDiffProperties { keep_archive } = o.props.try_into()?;

  let mut o = action ::PublishDiffOptions ::former()
  .path( path );
  if let Some( k ) = keep_archive.clone() { o = o.keep_archive( k ); }
  let o = o.form();

  println!( "{}", action ::publish_diff( o )? );
  if let Some( keep ) = keep_archive
  {
   // qqq: dont use canonicalizefunction. path does not have exist
   let keep = AbsolutePath ::try_from( fs ::canonicalize( keep )? ).unwrap();
   println!( "Remote version of the package was saved at `{}`", keep.as_ref().display() );
 }

  Ok( () )
 }

  impl TryFrom< wca ::executor ::Props > for PublishDiffProperties
  {
  type Error = error ::untyped ::Error;
  fn try_from( value: wca ::executor ::Props ) -> Result< Self, Self ::Error >
  {
   let mut this = Self ::former();

   this = if let Some( v ) = value
   .get_owned( "keep_archive" )
   { this.keep_archive :: < PathBuf >( v ) }
   else
   { this };

   Ok( this.form() )
 }
 }
}

//

crate ::mod_interface!
{
  /// Publishes the difference between the local and published versions of a package.
  orphan use publish_diff;
}