Branch latest SHA and `differs_from` keyword argument

[kamilturek]

Hello 👋

1. I've noticed that the latest_sha method from the branch class is not documented. Is it intentional? Should this method be avoided? Or can it be added to the documentation?
2. What is the purpose of the differs_from keyword argument? Not sure if I understand it well. Does it work correctly?

Many thanks!

[sigmavirus24]

It's supported and intended to be documented (as there's a docstring):

github3.py/src/github3/repos/branch.py

Line 37 in e06c519

def latest_sha(self, differs_from=""):

differs_from is for a very specific use-case. Let's say that you have a (very very very) long running process and you've retrieved that Branch object already way in the past. You can call b.differs_from(b.commit.sha) to determine if the branch on GitHub has new commits or has been changed.