Class: SafeDb::Diff

Inherits:
Controller show all
Defined in:
lib/controller/book/diff.rb

Overview

The diff use case spells out the key differences between the safe book on the master line the one on the current working branch. There are two types of diff - a refresh diff or a commit diff.

a refresh diff

A refresh is effectively an incoming merge of the master’s data structure into the working branch. With refreshs nothing ever gets deleted.

No delete is self-evident in this list of only 4 prophetic outcomes

  • this chapter will be added

  • this verse will be added

  • this line will be added

  • this branch’s line value will be overwritten with the value from master

a commit diff

A refresh merges whilst a commit is effectively a hard copy that destroys whatever is on the master making it exactly reflect the branch’s current state.

The three addition state changes prophesized by a refresh can also occur on commits. However commits can also prophesize that

  • this master’s line value will be overwritten with the branch’s value

  • this chapter will be removed

  • this verse will be removed

  • this line will be removed

Instance Method Summary collapse

Methods inherited from Controller

#check_post_conditions, #check_pre_conditions, #flow, #initialize, #open_remote_backend_location, #post_validation, #pre_validation, #read_verse, #set_verse, #update_verse

Constructor Details

This class inherits a constructor from SafeDb::Controller

Instance Method Details

#execute ⇒ Object

The diff use case compares the database state of the branch with that of the master and displays the results without masking sensitive credentials.



41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
 
# File 'lib/controller/book/diff.rb', line 41

def execute

  master_data = @book.to_master_data()
  branch_data = @book.to_branch_data()

  puts ""
  puts "   master has #{master_data.length()} chapters, and #{@book.get_master_verse_count()} verses.\n"
  puts "   branch has #{branch_data.length()} chapters, and #{@book.get_branch_verse_count()} verses.\n"
  puts ""
  puts "  You can commit to (or refresh from) the master branch." if @book.can_commit?()
  puts "  List of commit differences" if @book.can_commit?()
  puts "  You must refresh from the master branch." unless @book.can_commit?()
  puts "  List of refresh differences" unless @book.can_commit?()
  puts ""

  StateInspect.refresh_prophecies( master_data, branch_data ) unless @book.can_commit?()
  StateInspect.commit_prophecies( master_data, branch_data ) if @book.can_commit?()

  puts ""

end