Improve packages docs references and links

Fixes mozilla#1376

Author: Alexandre Lissy

VERSION

@@ -1 +1 @@
-0.2.0-alpha.3
+0.2.0-alpha.4

native_client/Makefile

@@ -31,7 +31,7 @@ bindings-clean:
 	rm -f python/model_wrap.cpp python/utils_wrap.cpp python/model.py python/utils.py
 
 bindings-build:
-	pip install --quiet $(PYTHON_PACKAGES) wheel
+	pip install --quiet $(PYTHON_PACKAGES) wheel==0.31.0 setuptools==39.1.0
 	AS=$(AS) CC=$(CC) CXX=$(CXX) LD=$(LD) CFLAGS="$(CFLAGS)" LDFLAGS="$(LDFLAGS_NEEDED) $(RPATH_PYTHON)" MODEL_LDFLAGS="$(LDFLAGS_DIRS)" UTILS_LDFLAGS="-L${TFDIR}/bazel-bin/native_client" MODEL_LIBS="$(LIBS)" $(PYTHON_PATH) $(NUMPY_INCLUDE) python ./setup.py build_ext $(PYTHON_PLATFORM_NAME)
 
 MANIFEST.in: bindings-build

native_client/javascript/Makefile

@@ -9,7 +9,7 @@ include ../definitions.mk
 default: build
 
 clean:
-	rm -f deepspeech_wrap.cxx package.json
+	rm -f deepspeech_wrap.cxx package.json README.md
 	rm -rf ./build/
 
 clean-npm-pack:
@@ -19,6 +19,9 @@ clean-npm-pack:
 really-clean: clean clean-npm-pack
 	rm -fr ./lib/
 
+README.md:
+	cp ../../README.md README.md
+
 package.json: package.json.in
 	sed \
 		-e 's/$$(PROJECT_NAME)/$(PROJECT_NAME)/' \
@@ -37,7 +40,7 @@ copy-deps: build
 node-wrapper: copy-deps build
 	$(NODE_BUILD_TOOL) $(NODE_PLATFORM_TARGET) $(NODE_ABI_TARGET) package $(NODE_BUILD_VERBOSE)
 
-npm-pack: clean package.json
+npm-pack: clean package.json README.md
 	npm install [email protected]
 	npm pack $(NODE_BUILD_VERBOSE)
 

native_client/javascript/package.json.in

@@ -7,6 +7,17 @@
        "deepspeech": "./client.js"
     },
     "author" : "Mozilla",
+    "license": "MPL-2.0",
+    "homepage": "https://github.com/mozilla/DeepSpeech/tree/$(PROJECT_VERSION)#project-deepspeech",
+    "files": [
+       "README.md",
+       "client.js",
+       "index.js",
+       "lib/*"
+    ],
+    "bugs": {
+       "url": "https://github.com/mozilla/DeepSpeech/issues"
+    },
     "repository"   :  {
        "type" : "git",
        "url"  : "git://github.com/mozilla/DeepSpeech.git"

native_client/setup.py

@@ -17,6 +17,9 @@
     numpy_include = ''
     assert 'NUMPY_INCLUDE' in os.environ
 
+def read(fname):
+    return open(os.path.join(os.path.dirname(__file__), fname)).read()
+
 numpy_include = os.getenv('NUMPY_INCLUDE', numpy_include)
 
 project_name = 'deepspeech'
@@ -49,13 +52,22 @@ class BuildExtFirst(build):
 
 setup(name = project_name,
       description = 'A library for running inference on a DeepSpeech model',
+      long_description = read('../README.md'),
+      long_description_content_type = 'text/markdown; charset=UTF-8',
       author = 'Mozilla',
       version = project_version,
       package_dir = {'deepspeech': 'python'},
       packages = ['deepspeech'],
       cmdclass = {'build': BuildExtFirst},
       license = 'MPL-2.0',
       url = 'https://github.com/mozilla/DeepSpeech',
+      project_urls = {
+        'Documentation': 'https://github.com/mozilla/DeepSpeech/tree/{}#project-deepspeech'.format(project_version),
+        'Tracker': 'https://github.com/mozilla/DeepSpeech/issues',
+        'Repository': 'https://github.com/mozilla/DeepSpeech/tree/{}'.format(project_version),
+        'Home': 'https://github.com/mozilla/DeepSpeech',
+        'Discussions': 'https://discourse.mozilla.org/c/deep-speech',
+      },
       ext_modules = [model, utils],
       entry_points={'console_scripts':['deepspeech = deepspeech.client:main']},
       install_requires = ['numpy', 'scipy'],