Add Makefile and distribute docs in sdist

[benjaoming]

Change affecting 0.15 release

Docs are included in the sdist and built automatically by running make sdist.

PR for #4348 (partly) and #4375

Change affecting build process

The PyPi and .deb for 0.15 will be released by using a new Makefile. Yay!
#4459

Makefile does this:

➜  ka-lite git:(dist-docs) make help
clean - remove all build, test, coverage and Python artifacts
clean-build - remove build artifacts
clean-pyc - remove Python file artifacts
clean-test - remove test and coverage artifacts
lint - check style with pep8
test - run tests quickly with the default Python
test-all - run tests on every Python version with tox DISABLED
assets - build all JS/CSS assets
coverage - check code coverage quickly with the default Python
docs - generate Sphinx HTML documentation, including API docs
release - package and upload a release
dist - package locally
install - install the package to the active Python's site-packages

[MCGallaspy]

I think the takeaway is that we can probably get this working with a little effort on Windows using MinGW.

[MCGallaspy]

BTW, who is assigned to this? What part of #4348 does it address? Is this a release-blocker? I thought I was just supposed to give this a sanity check, but if you really wish to include it in 0.15.x, then I would also like to make sure the makefile is usable on Windows by testing it out.

[aronasorman]

@rtibbles and I can sign off on this.

[MCGallaspy]

Are one of you going to make sure it's usable on Windows? Or do you want me to do that?

[aronasorman]

You'll be the best one for that @MCGallaspy. I can test this on the Mac as well.

But getting parity across all platforms isn't important for me at the moment, since this will only be used by the deb installer for 0.15. So I wouldn't be too strict at this point.

[benjaoming]

@aronasorman correct, the Makefile is not part of the release as pointed out in the description of the PR.

However, the setup.py changes are... but theyre not very risky.

[benjaoming]

I'm having issues with a constant pkg_resources.DistributionNotFound: ka-lite==0.15.0 running kalite commands on Circle.

Logging in with SSH, I can reissue pip install -e . and it works. I don't get why it doesn't initially work. I've tried rebuilding without a cache.

@aronasorman any clues here?

[aronasorman]

@benjaoming I've seen that error during 0.14, what I did was to install it first in my virtualenv. Maybe try adding that line in circle.yml?

[MCGallaspy]

Re: my earlier comment, I'll sign off on this.

[benjaoming]

@MCGallaspy that's cool, once it's merged we can go into more details about Win compat

@aronasorman I'm not sure what line? The circle.yml is identical to the functional one in 0.15.x, and it has enabled the virtualenv at the point of issuing pip install -e ..

I'm gonna create a new PR in case Circle has a messed up cache. Then I can also clean up commit history.