Class: Fastlane::Actions::GitCommitAction

Inherits:
Fastlane::Action show all
Defined in:
fastlane/lib/fastlane/actions/git_commit.rb

Constant Summary

Constants inherited from Fastlane::Action

Fastlane::Action::AVAILABLE_CATEGORIES, Fastlane::Action::RETURN_TYPES

Documentation collapse

Class Method Summary collapse

Methods inherited from Fastlane::Action

action_name, author, deprecated_notes, details, lane_context, method_missing, other_action, return_type, sample_return_value, shell_out_should_use_bundle_exec?, step_text

Class Method Details

.authors ⇒ Object 



58
59
60
 
# File 'fastlane/lib/fastlane/actions/git_commit.rb', line 58

def self.authors
  ["KrauseFx"]
end

.available_options ⇒ Object 



31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
 
# File 'fastlane/lib/fastlane/actions/git_commit.rb', line 31

def self.available_options
  [
    FastlaneCore::ConfigItem.new(key: :path,
                                 description: "The file(s) or directory(ies) you want to commit. You can pass an array of multiple file-paths or fileglobs \"*.txt\" to commit all matching files. The files already staged but not specified and untracked files won't be committed",
                                 type: Array),
    FastlaneCore::ConfigItem.new(key: :message,
                                 description: "The commit message that should be used"),
    FastlaneCore::ConfigItem.new(key: :skip_git_hooks,
                                 description: "Set to true to pass `--no-verify` to git",
                                 default_value: false,
                                 type: Boolean,
                                 optional: true),
    FastlaneCore::ConfigItem.new(key: :allow_nothing_to_commit,
                                 description: "Set to true to allow commit without any git changes in the files you want to commit",
                                 default_value: false,
                                 type: Boolean,
                                 optional: true)
  ]
end

.category ⇒ Object 



75
76
77
 
# File 'fastlane/lib/fastlane/actions/git_commit.rb', line 75

def self.category
  :source_control
end

.description ⇒ Object 



27
28
29
 
# File 'fastlane/lib/fastlane/actions/git_commit.rb', line 27

def self.description
  "Directly commit the given file with the given message"
end

.example_code ⇒ Object 



66
67
68
69
70
71
72
73
 
# File 'fastlane/lib/fastlane/actions/git_commit.rb', line 66

def self.example_code
  [
    'git_commit(path: "./version.txt", message: "Version Bump")',
    'git_commit(path: ["./version.txt", "./changelog.txt"], message: "Version Bump")',
    'git_commit(path: ["./*.txt", "./*.md"], message: "Update documentation")',
    'git_commit(path: ["./*.txt", "./*.md"], message: "Update documentation", skip_git_hooks: true)'
  ]
end

.is_supported?(platform) ⇒ Boolean

Returns:



62
63
64
 
# File 'fastlane/lib/fastlane/actions/git_commit.rb', line 62

def self.is_supported?(platform)
  true
end

.output ⇒ Object 



51
52
 
# File 'fastlane/lib/fastlane/actions/git_commit.rb', line 51

def self.output
end

.return_value ⇒ Object 



54
55
56
 
# File 'fastlane/lib/fastlane/actions/git_commit.rb', line 54

def self.return_value
  nil
end

.run(params) ⇒ Object 



4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
 
# File 'fastlane/lib/fastlane/actions/git_commit.rb', line 4

def self.run(params)
  paths = params[:path]
  skip_git_hooks = params[:skip_git_hooks] ? ['--no-verify'] : []

  if params[:allow_nothing_to_commit]
    # Here we check if the path passed in parameter contains any modification
    # and we skip the `git commit` command if there is none.
    # That means you can have other files modified that are not in the path parameter
    # and still make use of allow_nothing_to_commit.
    repo_clean = Actions.sh('git', 'status', *paths, '--porcelain').empty?
    UI.success("Nothing to commit, working tree clean ✅.") if repo_clean
    return if repo_clean
  end

  result = Actions.sh('git', 'commit', '-m', params[:message], *paths, *skip_git_hooks)
  UI.success("Successfully committed \"#{params[:path]}\" 💾.")
  return result
end