willbe 0.35.0

Utility to publish multi-crate and multi-workspace environments and maintain their consistency.
Documentation
#![ allow( clippy ::std_instead_of_alloc, clippy ::std_instead_of_core ) ]



use crate :: *;

use entity ::
{
  PathError,
  ManifestFile,
};
use core ::
{
  fmt,
  ops ::
  {
  Deref,
  DerefMut,
 },
};
use std ::
{
  path :: { Path, PathBuf },
  io,
};
// use error ::
// {
//   Result,
// };
use pth :: { AbsolutePath };
use camino :: { Utf8Path, Utf8PathBuf };

/// Path to crate directory
#[ derive( Clone, Ord, PartialOrd, Eq, PartialEq, Hash ) ]
pub struct CrateDir( AbsolutePath );

impl CrateDir
{

  /// Returns inner type which is an absolute path.
  #[ inline( always ) ]
  #[ must_use ]
  pub fn absolute_path( self ) -> AbsolutePath
  {
  self.0
 }

  /// Returns path to manifest aka cargo file.
  #[ inline( always ) ]
  #[ must_use ]
  pub fn manifest_file( self ) -> ManifestFile
  {
  self.into()
 }

}

impl fmt ::Display for CrateDir
{
  fn fmt( &self, f: &mut fmt ::Formatter< '_ > ) -> fmt ::Result
  {
  write!( f, "{}", self.0.display() )
 }
}

impl fmt ::Debug for CrateDir
{
  fn fmt( &self, f: &mut fmt ::Formatter< '_ > ) -> fmt ::Result
  {
  write!( f, "crate dir :: {}", self.0.display() )
 }
}

impl From< ManifestFile > for CrateDir
{
  fn from( src: ManifestFile ) -> Self
  {
  Self ( src.inner().parent().unwrap() )
 }
}

impl From< CrateDir > for AbsolutePath
{
  fn from( src: CrateDir ) -> Self
  {
  src.absolute_path()
 }
}

impl From< CrateDir > for PathBuf
{
  fn from( src: CrateDir ) -> Self
  {
  src.absolute_path().inner()
 }
}

impl< 'a > TryFrom< &'a CrateDir > for &'a str
{
  type Error = std ::io ::Error;
  fn try_from( src: &'a CrateDir ) -> Result< &'a str, Self ::Error >
  {
  ( &src.0 ).try_into()
 }
}

impl TryFrom< &CrateDir > for String
{
  type Error = std ::io ::Error;
  fn try_from( src: &CrateDir ) -> Result< String, Self ::Error >
  {
  let src2: &str = src.try_into()?;
  Result ::Ok( src2.into() )
 }
}

// impl< IntoPath: TryInto< PathBuf > > TryFrom< ( IntoPath, ) >
// for CrateDir
// where
//   PathError: From< < IntoPath as TryInto< PathBuf > > ::Error >,
// {
//   type Error = PathError;
//
//   #[ inline( always ) ]
//   fn try_from( ( crate_dir_path, ) : ( IntoPath, ) ) -> Result< Self, Self ::Error >
//   {
//     Self ::try_from( AbsolutePath ::try_from( crate_dir_path.try_into()? )? )
// }
// }

impl TryFrom< &AbsolutePath > for CrateDir
{
  type Error = PathError;

  #[ inline( always ) ]
  fn try_from( crate_dir_path: &AbsolutePath ) -> Result< Self, Self ::Error >
  {
  crate_dir_path.clone().try_into()
 }
}

impl TryFrom< AbsolutePath > for CrateDir
{
  type Error = PathError;

  #[ inline( always ) ]
  fn try_from( crate_dir_path: AbsolutePath ) -> Result< Self, Self ::Error >
  {
  if !crate_dir_path.as_ref().join( "Cargo.toml" ).is_file()
  {
   let err =  io ::Error ::new( io ::ErrorKind ::InvalidData, format!( "Cannot find crate dir at {}", crate_dir_path.display() ) );
   return Err( PathError ::Io( err ) );
 }
  Result ::Ok( Self( crate_dir_path ) )
 }
}

impl TryFrom< &PathBuf > for CrateDir
{
  type Error = PathError;

  #[ inline( always ) ]
  fn try_from( crate_dir_path: &PathBuf ) -> Result< Self, Self ::Error >
  {
  Self ::try_from( AbsolutePath ::try_from( crate_dir_path )? )
 }
}

impl TryFrom< PathBuf > for CrateDir
{
  type Error = PathError;

  #[ inline( always ) ]
  fn try_from( crate_dir_path: PathBuf ) -> Result< Self, Self ::Error >
  {
  Self ::try_from( AbsolutePath ::try_from( crate_dir_path )? )
 }
}

impl TryFrom< &Path > for CrateDir
{
  type Error = PathError;

  #[ inline( always ) ]
  fn try_from( crate_dir_path: &Path ) -> Result< Self, Self ::Error >
  {
  Self ::try_from( AbsolutePath ::try_from( crate_dir_path )? )
 }
}

impl TryFrom< &str > for CrateDir
{
  type Error = PathError;

  #[ inline( always ) ]
  fn try_from( crate_dir_path: &str ) -> Result< Self, Self ::Error >
  {
  Self ::try_from( AbsolutePath ::try_from( crate_dir_path )? )
 }
}

impl TryFrom< Utf8PathBuf > for CrateDir
{
  type Error = PathError;

  #[ inline( always ) ]
  fn try_from( crate_dir_path: Utf8PathBuf ) -> Result< Self, Self ::Error >
  {
  Self ::try_from( AbsolutePath ::try_from( crate_dir_path )? )
 }
}

impl TryFrom< &Utf8PathBuf > for CrateDir
{
  type Error = PathError;

  #[ inline( always ) ]
  fn try_from( crate_dir_path: &Utf8PathBuf ) -> Result< Self, Self ::Error >
  {
  Self ::try_from( AbsolutePath ::try_from( crate_dir_path )? )
 }
}

impl TryFrom< &Utf8Path > for CrateDir
{
  type Error = PathError;

  #[ inline( always ) ]
  fn try_from( crate_dir_path: &Utf8Path ) -> Result< Self, Self ::Error >
  {
  Self ::try_from( AbsolutePath ::try_from( crate_dir_path )? )
 }
}

impl AsRef< Path > for CrateDir
{
  fn as_ref( &self ) -> &Path
  {
  self.0.as_ref()
 }
}

impl AsMut< Path > for CrateDir
{
  fn as_mut( &mut self ) -> &mut Path
  {
  self.0.as_mut()
 }
}

impl Deref for CrateDir
{
  type Target = AbsolutePath;
  fn deref( &self ) -> &Self ::Target
  {
  &self.0
 }
}

impl DerefMut for CrateDir
{
  fn deref_mut( &mut self ) -> &mut Self ::Target
  {
  &mut self.0
 }
}