@@ -957,13 +957,15 @@ def active_branch(self) -> Head:
957
957
# reveal_type(self.head.reference) # => Reference
958
958
return self .head .reference
959
959
960
- def blame_incremental (self ,rev :str | HEAD ,file :str ,** kwargs :Any )-> Iterator ["BlameEntry" ]:
960
+ def blame_incremental (self ,rev :str | HEAD | None ,file :str ,** kwargs :Any )-> Iterator ["BlameEntry" ]:
961
961
"""Iterator for blame information for the given file at the given revision.
962
962
963
963
Unlike :meth:`blame`, this does not return the actual file's contents, only a
964
964
stream of :class:`BlameEntry` tuples.
965
965
966
- :param rev: Revision specifier, see git-rev-parse for viable options.
966
+ :param rev: Revision specifier. If `None`, the blame will include all the latest
967
+ uncommitted changes. Otherwise, anything succesfully parsed by git-rev-parse
968
+ is a valid option.
967
969
968
970
:return: Lazy iterator of :class:`BlameEntry` tuples, where the commit indicates
969
971
the commit to blame for the line, and range indicates a span of line numbers
@@ -1045,15 +1047,17 @@ def blame_incremental(self, rev: str | HEAD, file: str, **kwargs: Any) -> Iterat
1045
1047
1046
1048
def blame (
1047
1049
self ,
1048
- rev :Union [str ,HEAD ],
1050
+ rev :Union [str ,HEAD , None ],
1049
1051
file :str ,
1050
1052
incremental :bool = False ,
1051
1053
rev_opts :Optional [List [str ]]= None ,
1052
1054
** kwargs :Any ,
1053
1055
)-> List [List [Commit | List [str | bytes ]| None ]]| Iterator [BlameEntry ]| None :
1054
1056
"""The blame information for the given file at the given revision.
1055
1057
1056
- :param rev: Revision specifier, see git-rev-parse for viable options.
1058
+ :param rev: Revision specifier. If `None`, the blame will include all the latest
1059
+ uncommitted changes. Otherwise, anything succesfully parsed by git-rev-parse
1060
+ is a valid option.
1057
1061
1058
1062
:return:
1059
1063
list: [git.Commit, list: [<line>]]