Skip to content

Commit

Permalink
Making language subpackage into a proper package.
Browse files Browse the repository at this point in the history
- Adding README, setup.py, MANIFEST.in, .coveragerc and tox.ini
- Adding google-cloud-language as a dependency to the umbrella
  package
- Adding the language subdirectory into the list of packages
  for verifying the docs
- Incorporating the language subdirectory into the umbrella
  coverage report
- Adding the language only tox tests to the Travis config
- Adding {toxinidir}/../core as a dependency for the language
  tox config
  • Loading branch information
dhermes committed Sep 26, 2016
1 parent 7a98509 commit 73a964f
Show file tree
Hide file tree
Showing 5 changed files with 161 additions and 0 deletions.
11 changes: 11 additions & 0 deletions packages/google-cloud-language/.coveragerc
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
[run]
branch = True

[report]
fail_under = 100
show_missing = True
exclude_lines =
# Re-enable the standard pragma
pragma: NO COVER
# Ignore debug-only repr
def __repr__
4 changes: 4 additions & 0 deletions packages/google-cloud-language/MANIFEST.in
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
include README.rst
graft google
graft unit_tests
global-exclude *.pyc
48 changes: 48 additions & 0 deletions packages/google-cloud-language/README.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
Python Client for Google Cloud Natural Language
===============================================

Python idiomatic client for `Google Cloud Natural Language`_

.. _Google Cloud Natural Language: https://cloud.google.com/natural-language/

- `Homepage`_
- `API Documentation`_

.. _Homepage: https://googlecloudplatform.github.io/google-cloud-python/
.. _API Documentation: http://googlecloudplatform.github.io/google-cloud-python/

Quick Start
-----------

::

$ pip install --upgrade google-cloud-language
$ # OR
$ pip install --upgrade google-cloud-natural-language

Authentication
--------------

With ``google-cloud-python`` we try to make authentication as painless as
possible. Check out the `Authentication section`_ in our documentation to
learn more. You may also find the `authentication document`_ shared by all
the ``google-cloud-*`` libraries to be helpful.

.. _Authentication section: http://google-cloud-python.readthedocs.io/en/latest/google-cloud-auth.html
.. _authentication document: https://github.com/GoogleCloudPlatform/gcloud-common/tree/master/authentication

Using the API
-------------

The Google Cloud `Natural Language`_ API (`Natural Language API docs`_)
provides natural language understanding technologies to developers,
including sentiment analysis, entity recognition, and syntax analysis.
This API is part of the larger Cloud Machine Learning API.

.. _Natural Language: https://cloud.google.com/natural-language/
.. _Natural Language API docs: https://cloud.google.com/natural-language/reference/rest/

See the ``google-cloud-python`` API `Natural Language documentation`_ to learn
how to analyze text with this API.

.. _Natural Language documentation: https://google-cloud-python.readthedocs.io/en/stable/language-usage.html
68 changes: 68 additions & 0 deletions packages/google-cloud-language/setup.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
# Copyright 2016 Google Inc.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

import os

from setuptools import find_packages
from setuptools import setup


PACKAGE_ROOT = os.path.abspath(os.path.dirname(__file__))

with open(os.path.join(PACKAGE_ROOT, 'README.rst')) as file_obj:
README = file_obj.read()

# NOTE: This is duplicated throughout and we should try to
# consolidate.
SETUP_BASE = {
'author': 'Google Cloud Platform',
'author_email': 'jjg+google-cloud-python@google.com',
'scripts': [],
'url': 'https://github.com/GoogleCloudPlatform/google-cloud-python',
'license': 'Apache 2.0',
'platforms': 'Posix; MacOS X; Windows',
'include_package_data': True,
'zip_safe': False,
'classifiers': [
'Development Status :: 4 - Beta',
'Intended Audience :: Developers',
'License :: OSI Approved :: Apache Software License',
'Operating System :: OS Independent',
'Programming Language :: Python :: 2',
'Programming Language :: Python :: 2.7',
'Programming Language :: Python :: 3',
'Programming Language :: Python :: 3.4',
'Programming Language :: Python :: 3.5',
'Topic :: Internet',
],
}


REQUIREMENTS = [
'google-cloud-core',
]

setup(
name='google-cloud-language',
version='0.20.0dev',
description='Python Client for Google Cloud Natural Language',
long_description=README,
namespace_packages=[
'google',
'google.cloud',
],
packages=find_packages(),
install_requires=REQUIREMENTS,
**SETUP_BASE
)
30 changes: 30 additions & 0 deletions packages/google-cloud-language/tox.ini
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
[tox]
envlist =
py27,py34,py35,cover

[testing]
deps =
{toxinidir}/../core
pytest
covercmd =
py.test --quiet \
--cov=google.cloud.language \
--cov=unit_tests \
--cov-config {toxinidir}/.coveragerc \
unit_tests

[testenv]
commands =
py.test --quiet {posargs} unit_tests
deps =
{[testing]deps}

[testenv:cover]
basepython =
python2.7
commands =
{[testing]covercmd}
deps =
{[testenv]deps}
coverage
pytest-cov

0 comments on commit 73a964f

Please sign in to comment.