)]}'
{"install-guide/source/conf.py":[{"author":{"_account_id":4608,"name":"Kota Tsuyuzaki","email":"bloodeagle40234@gmail.com","username":"tsuyuzaki-kota"},"change_message_id":"5d8903a6ae3d0356962b93078720a5590837577e","unresolved":false,"context_lines":[{"line_number":22,"context_line":""},{"line_number":23,"context_line":"import os"},{"line_number":24,"context_line":"# import sys"},{"line_number":25,"context_line":"from swift import __version__"},{"line_number":26,"context_line":""},{"line_number":27,"context_line":""},{"line_number":28,"context_line":"import openstackdocstheme"}],"source_content_type":"text/x-python","patch_set":1,"id":"fa7ab95a_37bf9cfd","line":25,"updated":"2016-09-01 04:47:42.000000000","message":"I got this error, I was trying to build this doc *BEFORE INSTALL*\n\n ubuntu@\u003chostname\u003e:~/swift/install-guide$ sphinx-build source out\n\n Making output directory...\n Running Sphinx v1.2.3\n\n Exception occurred:\n   File \"conf.py\", line 25, in \u003cmodule\u003e\n ImportError: No module named swift\n\n\nYes, to import the __version__ string from swift, we have to install swift at first.\n\nHowever, is this \"Install Guild\", right? So that we can not build Installation Guide before INSTALL! That seems weird to me. Hopefully this might be built somewhere and it may be available at online for everyone to refer. I cannot point out how to get the current version w/o import (I was looking for how current swift sets it to PKG-INFO, but I am missing something because I didn\u0027t find the way)\n\nAnyway, hopefully I\u0027d bet to remove importing here with finding another way to get the version information...","commit_id":"0c22bc22573626dae0f81b976b56e82b265f77a2"},{"author":{"_account_id":6968,"name":"Christian Schwede","email":"cschwede@nvidia.com","username":"cschwede"},"change_message_id":"6c40f59c53fd5b8361c12ee39a7562ae482cc02e","unresolved":false,"context_lines":[{"line_number":22,"context_line":""},{"line_number":23,"context_line":"import os"},{"line_number":24,"context_line":"# import sys"},{"line_number":25,"context_line":"from swift import __version__"},{"line_number":26,"context_line":""},{"line_number":27,"context_line":""},{"line_number":28,"context_line":"import openstackdocstheme"}],"source_content_type":"text/x-python","patch_set":1,"id":"fa7ab95a_4f964495","line":25,"in_reply_to":"fa7ab95a_37bf9cfd","updated":"2016-09-01 06:07:46.000000000","message":"Kota, we do the same in docs and api-ref (see doc/source/conf.py and api-ref/conf.py) - it\u0027s basically the same, and we already did it for a few months. This change shouldn\u0027t be a problem therefore? It\u0027s a tox job, so the environment should be safe before sphinx is called.","commit_id":"0c22bc22573626dae0f81b976b56e82b265f77a2"},{"author":{"_account_id":4608,"name":"Kota Tsuyuzaki","email":"bloodeagle40234@gmail.com","username":"tsuyuzaki-kota"},"change_message_id":"5d8903a6ae3d0356962b93078720a5590837577e","unresolved":false,"context_lines":[{"line_number":65,"context_line":"# built documents."},{"line_number":66,"context_line":"#"},{"line_number":67,"context_line":"# The short X.Y version."},{"line_number":68,"context_line":"version \u003d __version__.rsplit(\u0027.\u0027, 1)[0]"},{"line_number":69,"context_line":"# The full version, including alpha/beta/rc tags."},{"line_number":70,"context_line":"release \u003d __version__"},{"line_number":71,"context_line":""}],"source_content_type":"text/x-python","patch_set":1,"id":"fa7ab95a_dc43f76a","line":68,"updated":"2016-09-01 04:47:42.000000000","message":"Are you expecting to include rev (i.e. \"major.minor.rev\" format) for this? Or just \"major.minor\" format is what you want to fit the line at L67?\n\nAnyways, this rsplit will result freaky version format between stable release and the version under development.\n\nstable release will be just \"major.minor.rev\" like \"2.9.0\" but under development version will be \"major.minor.rev.\u003cdev suffix\u003e\" like \"2.9.1.dev181\". Hence, __version__.rsplit(\u0027.\u0027, 1)[0] will be either \"2.9\" or \"2.9.1\" depends on the swift statement. I guess that is worse.\n\nI think\n\n version \u003d \u0027.\u0027join(__version__.split(\u0027.\u0027)[:2])\n\nworks well to set same format for both cases. (set :3 for list index if you thought to add rev in the version string)","commit_id":"0c22bc22573626dae0f81b976b56e82b265f77a2"},{"author":{"_account_id":6968,"name":"Christian Schwede","email":"cschwede@nvidia.com","username":"cschwede"},"change_message_id":"6c40f59c53fd5b8361c12ee39a7562ae482cc02e","unresolved":false,"context_lines":[{"line_number":65,"context_line":"# built documents."},{"line_number":66,"context_line":"#"},{"line_number":67,"context_line":"# The short X.Y version."},{"line_number":68,"context_line":"version \u003d __version__.rsplit(\u0027.\u0027, 1)[0]"},{"line_number":69,"context_line":"# The full version, including alpha/beta/rc tags."},{"line_number":70,"context_line":"release \u003d __version__"},{"line_number":71,"context_line":""}],"source_content_type":"text/x-python","patch_set":1,"id":"fa7ab95a_af50b0d5","line":68,"in_reply_to":"fa7ab95a_dc43f76a","updated":"2016-09-01 06:07:46.000000000","message":"The existing one (also used in docs and api-ref) should be fine; this version string will only show up when reporting a bug in the docs, ie clicking the bug link. AFAICT the version is not shown in the docs itself?","commit_id":"0c22bc22573626dae0f81b976b56e82b265f77a2"}]}