Add version api

[Yancey0623]

Fixed #2924
We can use the version API as:

>>> print paddle.version.version 0.10.0 >>> print paddle.version.git_commit e1ac448c3320d8a11051fad63cc17f3803862236

[wangkuiyi]

I have a serious concern about our current versioning approach, which takes all Git commits between 0.9.0 and 0.10.0 as 0.9.0. This is not realistic.

Consider that when errors occur with an experiment, users should report and upload the log so could we help. The printed log should contain the real version/commit id, so could we reproduce the error and locate the bug.

The correct logic should be

if paddle.version.tagged: print paddle.version # 0.10.0, 0.10.0rc1 or something print paddle.version.major # 0 print paddle.version.minor # 10 print paddle.version.release # 0 print paddle.version.rc # 1, or 0 if not a release candidate else: print paddle.version # 1232131abdd3  print paddle.version.commit # 1232131abdd3

What do you think?

[Yancey0623]

Thanks for @wangkuiyi , to distinguish taged or nor is a good idea, I only have some small doubt:

1. paddle.version is a Python module, so we can use paddle.version.full_version?
2. Following Semantic Versioning 2.0.0, the version number is made up by MAJOR.MINOR.PATCH
3. If not a taged version, maybe we do not need to print the repeated information, only print the commit id?

So how about the following logic?

if paddle.version.tagged: print paddle.version.full_version # 0.10.0, 0.10.0rc1 or something print paddle.version.major # 0 print paddle.version.minor # 10 print paddle.version.patch # 0 print paddle.version.rc # 1, or 0 if not a release candidate else: print paddle.version.commit # 1232131abdd3

[wangkuiyi]

@Yancey1989 Completely agree! Thanks!

[Yancey0623]

Done with @wangkuiyi 's comments.

[typhoonzero]

@Yancey1989 Can you please update this PR and merge the latest changes, so we can merge this.

[Yancey0623]

With markdownlint MD025, there is only one top-level header.

[typhoonzero]

Seem CI failed at:

File "setup.py", line 46, in write_version_py with open(filename, 'w') as f: IOError: [Errno 2] No such file or directory: '$/paddle/python/paddle/version.py' 

[Yancey0623]

@typhoonzero , I'm debugging with this failed and will update this PR later.

[typhoonzero]

LGTM! This is a awesome feature.