Skip to content

Commit

Permalink
Updating docs for 0.18.2
Browse files Browse the repository at this point in the history
  • Loading branch information
travis-ci committed Sep 22, 2016
1 parent 7ab9f56 commit 78152d9
Show file tree
Hide file tree
Showing 311 changed files with 21,435 additions and 201 deletions.
130 changes: 130 additions & 0 deletions home.html
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,130 @@
<section class="hero-banner">
<div class="container clearfix">
<div class="quote-box">
<h1>gcloud-python</h1>
<p>Google Cloud Client Library for Python
- an idiomatic, intuitive, and natural way for Python developers to
integrate with Google Cloud Platform services, like Cloud Datastore
and Cloud Storage.</p>
</div>

<div class="quote-box--supplementary">
<pre class="skip-highlight"><code class="subtle--blue">$</code> pip install <code class="subtle--blue">--upgrade</code> <strong>gcloud</strong></pre>
<h4 class="latest-release subtle" ng-if="home.latestRelease">
Latest Release <a ng-href="{{home.latestRelease.link}}" class="latest-release--link white">{{home.latestRelease.name}}</a>
{{home.latestRelease.date|date}}
</h4>
</div>
</div><!-- end of .container -->
</section><!-- end of .hero-banner -->

<section class="block featuring">
<div class="container">
<ul class="featuring-links">
<li>
<a href="#/docs/{{home.latestRelease.name}}/gcloud" title="gcloud-python docs" class="btn btn-docs">
<img src="src/images/icon-lang-python-gray.svg" alt="Python icon" />
Read the Docs
</a>
</li>
<li>
<a href="https://github.com/GoogleCloudPlatform/gcloud-python" title="gcloud-python on GitHub" class="ext-link">
<img src="src/images/icon-link-github.svg" alt="GitHub icon" />
GitHub
</a>
</li>
<li>
<a href="https://github.com/GoogleCloudPlatform/gcloud-python/issues" title="gcloud-python issues on Github" class="ext-link">
<img src="src/images/icon-link-github.svg" alt="GitHub icon" />
Issues
</a>
</li>
<li>
<a href="http://stackoverflow.com/questions/tagged/gcloud-python" title="gcloud-python on StackOverflow" class="ext-link">
<img src="src/images/icon-link-stackoverflow.svg" alt="StackOverflow icon" />
StackOverflow
</a>
</li>
<li>
<a href="https://pypi.python.org/pypi/gcloud" title="gcloud-python on pypi" class="ext-link">
<img src="src/images/icon-link-package-manager.svg" alt="pypi icon" />
PyPI
</a>
</li>
</ul>
</div><!-- end of .container -->
</section><!-- end of .featuring -->

<section class="block about">
<div class="container clearfix">
<div class="quote-box">
<h3 class="block-title">What is it?</h3>

<p><code>gcloud-python</code> is a client library for accessing Google
Cloud Platform services that significantly reduces the boilerplate
code you have to write. The library provides high-level API
abstractions so they're easier to understand. It embraces
idioms of Python, works well with the standard library, and
integrates better with your codebase.
All this means you spend more time creating code that matters
to you.</p>

<p><code>gcloud-python</code> is configured to access Google Cloud Platform
services and authorize (OAuth 2.0) automatically on your behalf.
With a one-line install and a private key, you are up and ready
to go. Better yet, if you are running on a Google Compute Engine
instance, the one-line install is enough!</p>

</div>

<div class="quote-box--supplementary">
<h4>Retrieve Datastore Entities</h4>

<div hljs hlsj-language="python">
from gcloud import datastore

client = datastore.Client()
product_key = client.key('Product', 123)
print(client.get(product_key))
</div>
</div>
</div><!-- end of .container -->
</section><!-- end of .featuring -->

<section class="block examples">
<div class="container clearfix">
<h3 class="block-title">Examples</h3>

<ul>
<li>
<a href="https://github.com/GoogleCloudPlatform/gcloud-python-expenses-demo"><code>gcloud-python-expenses-demo</code></a> - Use gcloud-python with the Datastore and Cloud Storage to manage expenses
</li>
</ul>
</div>
</section>

<section class="block">
<div class="container clearfix">
<h3 class="block-title">FAQ</h3>

<h4>What is the relationship between the <code>gcloud-python</code> package
and the <code>gcloud</code> command-line tool?</h4>
<p>Both the <code>gcloud</code> command-line tool and
<code>gcloud-python</code> package are a part of the Google Cloud SDK: a collection
of tools and libraries that enable you to easily create and manage
resources on the Google Cloud Platform. The <code>gcloud</code> command-line
tool can be used to manage both your development workflow and your
Google Cloud Platform resources while the <code>gcloud-python</code> package is the
Google Cloud Client Library for Python.</p>

<h4>What is the relationship between <code>gcloud-python</code>
and the Google APIs Python Client?</h4>
<p>The <a href="https://github.com/google/google-api-python-client">
Google APIs Python Client</a> is a client library for
using the broad set of Google APIs.
<code>gcloud-python</code> is built specifically for the Google Cloud Platform
and is the recommended way to integrate Google Cloud APIs into your
Python applications. If your application requires both Google Cloud Platform and
other Google APIs, the 2 libraries may be used by your application.</p>
</div>
</section> <!-- end of FAQ -->
221 changes: 20 additions & 201 deletions index.html
View file
Original file line number Diff line number Diff line change
@@ -1,201 +1,20 @@
<!doctype html>
<!--[if lt IE 7]> <html class="no-js lt-ie9 lt-ie8 lt-ie7"> <![endif]-->
<!--[if IE 7]> <html class="no-js lt-ie9 lt-ie8"> <![endif]-->
<!--[if IE 8]> <html class="no-js lt-ie9"> <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js"> <!--<![endif]-->
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>google-cloud</title>
<meta name="description" content="Node idiomatic client for Google Cloud services.">
<meta name="viewport" content="width=device-width, initial-scale=1">
<link rel="shortcut icon" href="https://cloud.google.com/images/gcp-favicon.ico">
<link rel="stylesheet" href="_landing-page-static/css/normalize.css">
<link rel="stylesheet" href="_landing-page-static/css/main.css">
<link rel="stylesheet" href="_landing-page-static/pygments.css">
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Droid+Sans+Mono|Roboto:300,400,700,700italic,400italic|Open+Sans:300">
<link rel="stylesheet" href="https://yandex.st/highlightjs/8.0/styles/github.min.css">
</head>
<body>
<header class="page-header" role="banner">
<h1 class="logo"><img src="_landing-page-static/images/logo-full.svg" alt="Google Cloud Platform" /></h1>
<!-- start of language-switcher -->
<nav class="main-nav">
<div class="nav-current">Python</div>
<ul class="menu">
<li>
<a href="http://googlecloudplatform.github.io/google-cloud-dotnet" title="google-cloud-dotnet">
<img src="_landing-page-static/images/icon-lang-dotnet.svg" alt=".NET icon" class="menu-icon" />
.NET
</a>
</li>
<li>
<a href="https://googlecloudplatform.github.io/google-cloud-java/" title="google-cloud-java">
<img src="_landing-page-static/images/icon-lang-java-duke.svg" alt="Duke icon" class="menu-icon">
Java
</a>
</li>
<li>
<a href="https://googlecloudplatform.github.io/google-cloud-node/" title="google-cloud-node">
<img src="_landing-page-static/images/icon-lang-nodejs.svg" alt="Node.js icon" class="menu-icon">
Node.js
</a>
</li>
<li>
<a href="https://googlecloudplatform.github.io/google-cloud-php/" title="google-cloud-php">
<img src="_landing-page-static/images/icon-lang-php.svg" alt="PHP icon" class="menu-icon">
PHP
</a>
</li>
<li>
<a href="#" title="google-cloud-python">
<img src="_landing-page-static/images/icon-lang-python-white.svg" alt="Python icon" class="menu-icon">
Python
</a>
</li>
<li>
<a href="https://googlecloudplatform.github.io/google-cloud-ruby/" title="google-cloud-ruby">
<img src="_landing-page-static/images/icon-lang-ruby.svg" alt="Ruby icon" class="menu-icon" width="24">
Ruby
</a>
</li>
</ul>
</nav>
<!-- end of language-switcher -->
</header><!-- end of .page-header -->

<article class="main" role="main">
<section class="hero-banner">
<div class="container clearfix">
<div class="col col-left">
<h1>google-cloud</h1>
<p>Google Cloud Client Library for Python
- an idiomatic, intuitive, and natural way for Python developers to
integrate with Google Cloud Platform services, like Cloud Datastore
and Cloud Storage.</p>
</div><!-- end of .col.col-left -->

<div class="col col-right">
<h2>One-line install</h2>
<pre>$ pip install --upgrade google-cloud</pre>
</div>
</div><!-- end of .container -->
</section><!-- end of .hero-banner -->

<section class="block featuring">
<div class="container">
<ul class="featuring-links">
<li>
<a href="stable/" title="google-cloud-python docs" class="btn btn-docs">
<img src="_landing-page-static/images/icon-lang-python.svg" alt="Python icon" />
Read the Docs
</a>
</li>
<li>
<a href="https://github.com/GoogleCloudPlatform/google-cloud-python" title="google-cloud-python on GitHub" class="ext-link">
<img src="_landing-page-static/images/icon-link-github.svg" alt="GitHub icon" />
GitHub
</a>
</li>
<li>
<a href="https://github.com/GoogleCloudPlatform/google-cloud-python/issues" title="google-cloud-python issues on Github" class="ext-link">
<img src="_landing-page-static/images/icon-link-github.svg" alt="GitHub icon" />
Issues
</a>
</li>
<li>
<a href="http://stackoverflow.com/questions/tagged/google-cloud-python" title="google-cloud-python on StackOverflow" class="ext-link">
<img src="_landing-page-static/images/icon-link-stackoverflow.svg" alt="StackOverflow icon" />
StackOverflow
</a>
</li>
<li>
<a href="https://pypi.python.org/pypi/google-cloud" title="google-cloud-python on PyPI" class="ext-link">
<img src="_landing-page-static/images/icon-link-package-manager.svg" alt="PyPI icon" />
PyPI
</a>
</li>
</ul>
</div><!-- end of .container -->
</section><!-- end of .featuring -->

<section class="block about">
<div class="container clearfix">
<div class="col col-left">
<h3 class="block-title">What is it?</h3>

<p><code>google-cloud</code> is a client library for accessing Google
Cloud Platform services that significantly reduces the boilerplate
code you have to write. The library provides high-level API
abstractions so they're easier to understand. It embraces
idioms of Python, works well with the standard library, and
integrates better with your codebase.
All this means you spend more time creating code that matters
to you.</p>

<p><code>google-cloud</code> is configured to access Google Cloud Platform
services and authorize (OAuth 2.0) automatically on your behalf.
With a one-line install and a private key, you are up and ready
to go. Better yet, if you are running on a Google Compute Engine
instance, the one-line install is enough!</p>

</div><!-- end of .col.col-left -->

<div class="col col-right">
<h4>Retrieve Datastore Entities</h4>

<div class="highlight-python"><div class="highlight"><pre><span class="kn">from</span> <span class="nn">google.cloud</span> <span class="kn">import</span> <span class="n">datastore</span>

<span class="n">client</span> <span class="o">=</span> <span class="n">datastore</span><span class="o">.</span><span class="n">Client</span><span class="p">()</span>
<span class="n">product_key</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="n">key</span><span class="p">(</span><span class="s">'Product'</span><span class="p">,</span> <span class="mi">123</span><span class="p">)</span>
<span class="k">print</span><span class="p">(</span><span class="n">client</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">product_key</span><span class="p">))</span>
</pre></div>
</div>

</div><!-- end of .col.col-right -->
</div><!-- end of .container -->
</section><!-- end of .featuring -->

<section class="block examples">
<div class="container clearfix">
<h3 class="block-title">Examples</h3>

<ul>
<li>
<a href="https://github.com/GoogleCloudPlatform/gcloud-python-expenses-demo"><code>gcloud-python-expenses-demo</code></a> - Use google-cloud-python with the Datastore and Cloud Storage to manage expenses
</li>
</ul>
</div>
</section>

<section class="block">
<div class="container clearfix">
<h3 class="block-title">FAQ</h3>

<h4>What is the relationship between the <code>google-cloud</code> package
and the <code>gcloud</code> command-line tool?</h4>
<p>Both the <code>gcloud</code> command-line tool and
<code>google-cloud</code> package are a part of the Google Cloud SDK: a collection
of tools and libraries that enable you to easily create and manage
resources on the Google Cloud Platform. The <code>gcloud</code> command-line
tool can be used to manage both your development workflow and your
Google Cloud Platform resources while the <code>google-cloud</code> package is the
Google Cloud Client Library for Python.</p>

<h4>What is the relationship between <code>google-cloud</code>
and the Google APIs Python Client?</h4>
<p>The <a href="https://github.com/google/google-api-python-client">
Google APIs Python Client</a> is a client library for
using the broad set of Google APIs.
<code>google-cloud</code> is built specifically for the Google Cloud Platform
and is the recommended way to integrate Google Cloud APIs into your
Python applications. If your application requires both Google Cloud Platform and
other Google APIs, the 2 libraries may be used by your application.</p>
</div>
</section> <!-- end of FAQ -->

<script src="//ajax.googleapis.com/ajax/libs/jquery/1.10.2/jquery.min.js"></script>
<script>window.jQuery || document.write('<script src="_landing-page-static/js/vendor/jquery-1.10.2.min.js"><\/script>')</script>
<script src="_landing-page-static/js/main.js"></script>
</article><!-- end of .main -->
</body>
<!doctype html><html><head><meta charset="utf-8"><title>gcloud-python</title><meta name="description" content="Google Cloud Platform's client library documentation"><meta name="viewport" content="width=device-width, initial-scale=1"><link rel="shortcut icon" href="https://cloud.google.com/images/gcp-favicon.ico"><link rel="stylesheet" href="src/vendor-d362a4bbd8.css"><link rel="stylesheet" href="src/app-a103c713b2.css"></head><body><!--[if lt IE 10]>
<p class="browsehappy">You are using an <strong>outdated</strong> browser. Please <a href="http://browsehappy.com/">upgrade your browser</a> to improve your experience.</p>
<![endif]--><main ui-view="" autoscroll="true"></main><script src="src/vendor-7173ada14e.js"></script><script src="src/app-4918b7fab6.js"></script><script>
(function() {
var $injector = angular.injector(['ng']);
var $http = $injector.get('$http');

$http.get('manifest.json')
.then(function(response) {
angular
.module('gcloud.manifest', [])
.constant('manifest', response.data);

angular.element(document)
.ready(function() {
angular.bootstrap(document, ['gcloud']);
});
});
}());
</script></body></html>
Loading

0 comments on commit 78152d9

Please sign in to comment.