repare changelog and begin warnings crackdown

Author: RonnyPfannschmidt

CHANGELOG.rst

@@ -2,6 +2,8 @@ v3.1.0
 =======
 
 * fix #297 - correct the invocation in version_from_scm and deprecate it as its exposed by accident
+* fix #298 - handle git file listing on empty repositories
+* fix #268 - deprecate ScmVersion.extra
 
 v3.0.6
 ======

src/setuptools_scm/__init__.py

@@ -41,7 +41,8 @@ def _call_entrypoint_fn(config, fn):
         warnings.warn(
             "parse functions are required to provide a named argument"
             " 'config' in the future.",
-            PendingDeprecationWarning,
+            category=PendingDeprecationWarning,
+            stacklevel=2,
         )
         return fn(config.absolute_root)
 

src/setuptools_scm/version.py

@@ -141,11 +141,20 @@ def __init__(
         self.distance = distance
         self.node = node
         self.time = datetime.datetime.now()
-        self.extra = kw
+        self._extra = kw
         self.dirty = dirty
         self.preformatted = preformatted
         self.branch = branch
 
+    @property
+    def extra(self):
+        warnings.warn(
+            "ScmVersion.extra is deprecated and will be removed in future",
+            category=DeprecationWarning,
+            stacklevel=2,
+        )
+        return self._extra
+
     @property
     def exact(self):
         return self.distance is None

tox.ini

@@ -1,6 +1,9 @@
 [tox]
 envlist=py{27,34,35,36,37}-test,flake8,check_readme,py{27,36}-selfcheck
 
+[pytest]
+filterwarnings=error
+
 [flake8]
 max-complexity = 10
 max-line-length = 88