rename issue to new methods

Author: dr-orlovsky

cli/src/cmd.rs

@@ -121,7 +121,7 @@ fn process(articles_path: PathBuf, dir: Option<PathBuf>) -> anyhow::Result<()> {
     let path = dir
         .or_else(|| Some(articles_path.parent()?.to_path_buf()))
         .ok_or(anyhow::anyhow!("invalid path for creating the contract"))?;
-    LedgerDir::issue(articles, path)?;
+    LedgerDir::new(articles, path)?;
 
     Ok(())
 }

src/ledger.rs

@@ -46,8 +46,8 @@ pub const LEDGER_VERSION: [u8; 2] = [0x00, 0x01];
 pub struct Ledger<S: Stock>(pub(crate) S);
 
 impl<S: Stock> Ledger<S> {
-    /// Issues a new contract from the provided articles, creating its persistence using given
-    /// implementation-specific configuration.
+    /// Instantiates a new contract from the provided articles, creating its persistence with the
+    /// provided configuration.
     ///
     /// # Panics
     ///
@@ -56,8 +56,8 @@ impl<S: Stock> Ledger<S> {
     /// # Blocking I/O
     ///
     /// This call MAY perform any I/O operations.
-    pub fn issue(articles: Articles, conf: S::Conf) -> Result<Self, IssueError<S::Error>> {
-        S::issue(articles, conf).map(Self)
+    pub fn new(articles: Articles, conf: S::Conf) -> Result<Self, IssueError<S::Error>> {
+        S::new(articles, conf).map(Self)
     }
 
     /// Loads a contract using the provided configuration for persistence.

src/persistance/fs.rs

@@ -58,7 +58,7 @@ impl Stock for StockFs {
     type Conf = PathBuf;
     type Error = io::Error;
 
-    fn issue(articles: Articles, path: PathBuf) -> Result<Self, IssueError<io::Error>> {
+    fn new(articles: Articles, path: PathBuf) -> Result<Self, IssueError<io::Error>> {
         let state = EffectiveState::from_genesis(&articles)
             .map_err(|e| IssueError::Genesis(articles.issue.meta.name.clone(), e))?;
 

src/stock.rs

@@ -51,7 +51,7 @@ pub trait Stock {
     /// construction.
     type Error: StdError;
 
-    /// Issues a new contract from the provided articles, creating its persistence using given
+    /// Creates a new contract from the provided articles, creating its persistence using a given
     /// implementation-specific configuration.
     ///
     /// # Panics
@@ -61,7 +61,7 @@ pub trait Stock {
     /// # Blocking I/O
     ///
     /// This call MAY perform any I/O operations.
-    fn issue(articles: Articles, conf: Self::Conf) -> Result<Self, IssueError<Self::Error>>
+    fn new(articles: Articles, conf: Self::Conf) -> Result<Self, IssueError<Self::Error>>
     where Self: Sized;
 
     /// Loads a contract from a persistence using the provided configuration.