Add bumpver configuration (#9029)

* Add bumpver configuration

This is directly called from ops/deploy, so usage of this tool is
abstracted and not super important.

It's easy to use however, and has a string input method, instead of
incrementing each part individually, a la bump2version.

```
% bumpver update --dry --set-version "8.0.0"
INFO    - fetching tags from remote (to turn off use: -n / --no-fetch)
INFO    - Old Version: 7.4.2
INFO    - New Version: 8.0.0
--- docs/conf.py
+++ docs/conf.py
@@ -67,7 +67,7 @@
 copyright = '2010-{}, Read the Docs, Inc & contributors'.format(
     timezone.now().year
 )
-version = "7.4.2"
+version = "8.0.0"
 release = version
 exclude_patterns = ['_build']
 default_role = 'obj'
--- package.json
+++ package.json
@@ -1,6 +1,6 @@
 {
   "name": "readthedocs",
-  "version": "7.4.2",
+  "version": "8.0.0",
   "description": "Read the Docs build dependencies",
   "author": "Read the Docs, Inc <[email protected]>",
   "scripts": {
--- readthedocs/__init__.py
+++ readthedocs/__init__.py
@@ -2,5 +2,5 @@

 import os.path

-__version__ = "7.4.2"
+__version__ = "8.0.0"

--- setup.cfg
+++ setup.cfg
@@ -29,7 +29,7 @@
 github_repo = readthedocs.org

 [bumpver]
-current_version = "7.4.2"
+current_version = "8.0.0"
 version_pattern = "MAJOR.MINOR.PATCH[TAGNUM]"
 commit_message = "Bump version {old_version} -> {new_version}"
 commit = False
```

* Make lint happy?

* Nope. Make lint happy?

* Better isort hack

Author: agjohnson

.gitignore

@@ -54,6 +54,7 @@ private_*
 readthedocs/htmlcov
 tags
 .python-version
+.tool-versions
 *.pyo
 .pytest_cache/
 scripts/travis/elasticsearch*
@@ -66,6 +67,8 @@ venv/
 ENV/
 env.bak/
 venv.bak/
+.direnv/
+.envrc
 
 dev.db-journal
 /readthedocs/settings/build_docker.py

docs/conf.py

@@ -13,19 +13,18 @@
 
 import os
 import sys
-from configparser import RawConfigParser
 
 import sphinx_rtd_theme
 
 sys.path.insert(0, os.path.abspath('..'))
 sys.path.append(os.path.dirname(__file__))
 os.environ.setdefault("DJANGO_SETTINGS_MODULE", "readthedocs.settings.dev")
 
-from django.utils import timezone
-
+# Load Django after sys.path and configuration setup
+# isort: split
 import django
-django.setup()
 
+django.setup()
 
 # Set here the variables you want for each docset.
 docsets = {
@@ -45,13 +44,6 @@
     locals()[k] = v
 
 
-def get_version():
-    """Return package version from setup.cfg."""
-    config = RawConfigParser()
-    config.read(os.path.join('..', 'setup.cfg'))
-    return config.get('metadata', 'version')
-
-
 sys.path.append(os.path.abspath('_ext'))
 extensions = [
     'sphinx.ext.autosectionlabel',
@@ -71,11 +63,9 @@ def get_version():
 
 templates_path = ['_templates']
 
-master_doc = 'index'
-copyright = '2010-{}, Read the Docs, Inc & contributors'.format(
-    timezone.now().year
-)
-version = get_version()
+master_doc = "index"
+copyright = "2010, Read the Docs, Inc & contributors"
+version = "7.4.2"
 release = version
 exclude_patterns = ['_build']
 default_role = 'obj'
@@ -103,12 +93,12 @@ def get_version():
     "deflist",
 ]
 hoverxref_intersphinx = [
-   "sphinx",
-   "pip",
-   "nbsphinx",
-   "myst-nb",
-   "ipywidgets",
-   "jupytext",
+    "sphinx",
+    "pip",
+    "nbsphinx",
+    "myst-nb",
+    "ipywidgets",
+    "jupytext",
 ]
 htmlhelp_basename = 'ReadTheDocsdoc'
 latex_documents = [

package.json

@@ -1,8 +1,8 @@
 {
   "name": "readthedocs",
-  "version": "7.4.1",
+  "version": "7.4.2",
   "description": "Read the Docs build dependencies",
-  "author": "Anthony Johnson <anthony@readthedocs.com>",
+  "author": "Read the Docs, Inc <support@readthedocs.com>",
   "scripts": {
     "build": "gulp build",
     "dev": "gulp dev",

readthedocs/__init__.py

@@ -1,19 +1,4 @@
 """Read the Docs."""
 
-import os.path
 
-from configparser import RawConfigParser
-
-
-def get_version(setupcfg_path):
-    """Return package version from setup.cfg."""
-    config = RawConfigParser()
-    config.read(setupcfg_path)
-    return config.get('metadata', 'version')
-
-
-__version__ = get_version(
-    os.path.abspath(
-        os.path.join(os.path.dirname(__file__), '..', 'setup.cfg'),
-    ),
-)
+__version__ = "7.4.2"

setup.cfg

@@ -6,7 +6,7 @@ description = Read the Docs builds and hosts documentation
 author = Read the Docs, Inc
 author_email = [email protected]
 url = http://readthedocs.org
-classifiers = 
+classifiers =
 	Development Status :: 5 - Production/Stable
 	Environment :: Web Environment
 	Intended Audience :: Developers
@@ -28,3 +28,20 @@ zip_safe = False
 github_owner = readthedocs
 github_repo = readthedocs.org
 
+[bumpver]
+current_version = "7.4.2"
+version_pattern = "MAJOR.MINOR.PATCH[TAGNUM]"
+commit_message = "Bump version {old_version} -> {new_version}"
+commit = False
+tag = False
+push = False
+
+[bumpver:file_patterns]
+setup.cfg =
+    version = "{version}"
+package.json =
+    "version": "{version}",
+docs/conf.py =
+    version = "{version}"
+readthedocs/__init__.py =
+    __version__ = "{version}"