Skip to content

Commit

Permalink
Making resource-manager 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-resource-manager as a dependency to the umbrella
  package
- Adding the resource_manager subdirectory into the list of packages
  for verifying the docs
- Incorporating the resource_manager subdirectory into the umbrella
  coverage report
- Adding the resource-manager only tox tests to the Travis config
- Adding {toxinidir}/../core as a dependency for the resource-manager
  tox config
  • Loading branch information
dhermes committed Sep 26, 2016
1 parent 230267c commit 7cb86b4
Show file tree
Hide file tree
Showing 9 changed files with 170 additions and 0 deletions.
3 changes: 3 additions & 0 deletions .travis.yml
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@ script:
- (cd dns && tox -e py27)
- (cd language && tox -e py27)
- (cd error_reporting && tox -e py27)
- (cd resource_manager && tox -e py27)
- tox -e py34
- (cd core && tox -e py34)
- (cd bigtable && tox -e py34)
Expand All @@ -27,6 +28,7 @@ script:
- (cd dns && tox -e py34)
- (cd language && tox -e py34)
- (cd error_reporting && tox -e py34)
- (cd resource_manager && tox -e py34)
- tox -e lint
- tox -e cover
- (cd core && tox -e cover)
Expand All @@ -39,6 +41,7 @@ script:
- (cd dns && tox -e cover)
- (cd language && tox -e cover)
- (cd error_reporting && tox -e cover)
- (cd resource_manager && tox -e cover)
- tox -e system-tests
- tox -e system-tests3
- scripts/update_docs.sh
Expand Down
11 changes: 11 additions & 0 deletions resource_manager/.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 resource_manager/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
45 changes: 45 additions & 0 deletions resource_manager/README.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
Python Client for Google Cloud Resource Manager
===============================================

Python idiomatic client for `Google Cloud Resource Manager`_

.. _Google Cloud Resource Manager: https://cloud.google.com/resource-manager/

- `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-resource-manager

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

This comment has been minimized.

Copy link
@yegle

yegle Jun 26, 2017

This link is broken @dhermes

This comment has been minimized.

Copy link
@dhermes

dhermes Jun 26, 2017

Author Contributor

Indeed. Thanks for the heads up.

This comment has been minimized.

Copy link
@dhermes

dhermes Jun 26, 2017

Author Contributor

I filed #3531 for tracking

.. _authentication document: https://github.com/GoogleCloudPlatform/gcloud-common/tree/master/authentication

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

The Cloud `Resource Manager`_ API (`Resource Manager API docs`_) provides
methods that you can use to programmatically manage your projects in the
Google Cloud Platform.

.. _Resource Manager: https://cloud.google.com/resource-manager/
.. _Resource Manager API docs: https://cloud.google.com/resource-manager/reference/rest/

See the ``google-cloud-python`` API `Resource Manager documentation`_ to learn
how to manage projects using this Client Library.

.. _Resource Manager documentation: https://googlecloudplatform.github.io/google-cloud-python/stable/resource-manager-api.html
68 changes: 68 additions & 0 deletions resource_manager/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-resource-manager',
version='0.20.0dev',
description='Python Client for Google Cloud Resource Manager',
long_description=README,
namespace_packages=[
'google',
'google.cloud',
],
packages=find_packages(),
install_requires=REQUIREMENTS,
**SETUP_BASE
)
30 changes: 30 additions & 0 deletions resource_manager/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.resource-manager \
--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
1 change: 1 addition & 0 deletions scripts/verify_included_modules.py
Original file line number Diff line number Diff line change
Expand Up @@ -68,6 +68,7 @@
'language',
'logging',
'pubsub',
'resource_manager',
'storage',
)

Expand Down
1 change: 1 addition & 0 deletions setup.py
Original file line number Diff line number Diff line change
Expand Up @@ -59,6 +59,7 @@
'google-cloud-language',
'google-cloud-logging',
'google-cloud-pubsub',
'google-cloud-resource-manager',
'google-cloud-storage',
]

Expand Down
7 changes: 7 additions & 0 deletions tox.ini
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ deps =
{toxinidir}/dns
{toxinidir}/language
{toxinidir}/error_reporting
{toxinidir}/resource_manager
pytest
covercmd =
py.test --quiet \
Expand Down Expand Up @@ -81,6 +82,12 @@ covercmd =
--cov-append \
--cov-config {toxinidir}/.coveragerc \
error_reporting/unit_tests
py.test --quiet \
--cov=google.cloud \
--cov=unit_tests \
--cov-append \
--cov-config {toxinidir}/.coveragerc \
resource_manager/unit_tests
coverage report --show-missing --fail-under=100

[testenv]
Expand Down

0 comments on commit 7cb86b4

Please sign in to comment.