Not possible to pass multiple files per commit per GitHub API?

Question

I already use the GitHub API to make automated commits.
For this I'm using a Java Library from Kohsuke
It works with this API command:

Create a file
This method creates a new file in a repository
PUT /repos/:owner/:repo/contents/:path

But is it possible to include multiple files in 1 Commit per GitHub API?

Answer 1

The following code snippit will allow you to prepare a commit with multiple files, then associate a new branch to it, using the Java library from Kohsuke

// start with a Repository ref
GHRepository repo = ...

// get a sha to represent the root branch to start your commit from.  
// this can come from any number of classes:
//   GHBranch, GHCommit, GHTree, etc...

// for this example, we'll start from the master branch
GHBranch masterBranch = repo.getBranch("master");

// get a tree builder object to build up into the commit. 
// the base of the tree will be the master branch
GHTreeBuilder treeBuilder = repo.createTree().baseTree(masterBranch.getSHA1());

// add entries to the tree in various ways.  
// the nice thing about GHTreeBuilder.textEntry() is that it is an "upsert" (create new or update existing)
treeBuilder = treeBuilder.textEntry(pathToFile, contentOfFile, executable);

// repeat calls of treeBuider.textEntry() or .shaEntry() or .entry() ....

// perform the commit
GHCommit commit = repo.createCommit()
  // base the commit on the tree we built
  .tree(treeBuilder.create().getSha())
  // set the parent of the commit as the master branch
  .parent(masterBranch.getSHA1()).message("multi-file commit").create();

// create a new branch from that commit
String newBranchName = "myNewBranchName";
GHRef newRef = repo.createRef("/refs/heads/" + newBranchName, commit.getSHA1();
GHBranch newBranch = repo.getBranch(newBranchName);