Method create_view

atomic-repository/src/repository/views.rs:85–137

Create a new view. # Arguments `name` - The name of the view to create # Errors Returns an error if: - The view already exists - The database operation fails

(&mut self, name: &str)

    /// - The view already exists
    /// - The database operation fails
    pub fn create_view(&mut self, name: &str) -> Result<(), RepositoryError> {
        // Create the workspace directory for this view.
        ensure_workspace_dir(&self.dot_dir, name)?;

        // Create a **Draft** view parented on the nearest Shared
        // ancestor of the current view.  The change log starts EMPTY —
        // no changes are inherited automatically.
        //
        // The parent link gives the view read-access to the shared
        // graph content (via the overlay chain) so that `record` can
        // compute diffs against the existing state.  But no files are
        // *materialised* on disk until changes are explicitly inserted
        // into this view (which copies them into the view's change log).
        //
        // This means:
        //   `view new feature`              → empty workspace, no files
        //   `insert from-view dev feature`  → inherits dev's files
        //
        // Using the nearest Shared ancestor (instead of the current
        // view directly) prevents sibling Draft views from seeing
        // each other's edges through the overlay chain.
        let parent_name = self.nearest_shared_ancestor(&self.current_view.clone())?;

        let mut txn = self
            .pristine
            .write_txn()
            .map_err(|e| RepositoryError::Database(e.to_string()))?;

        if txn
            .get_view(name)
            .map_err(|e| RepositoryError::Database(e.to_string()))?
            .is_some()
        {
            return Err(RepositoryError::ViewAlreadyExists {
                name: name.to_string(),
            });
        }

        let parent_view = txn
            .get_view(&parent_name)
            .map_err(|e| RepositoryError::Database(e.to_string()))?
            .ok_or_else(|| RepositoryError::ViewNotFound {
                name: parent_name.clone(),
            })?;

        txn.create_view(name, ViewScope::Draft, Some(parent_view.id))
            .map_err(|e| RepositoryError::Database(e.to_string()))?;

        txn.commit()
            .map_err(|e| RepositoryError::Database(e.to_string()))?;

        Ok(())
    }

    /// Create a new Shared view with no parent.
    ///