Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add NL quickstart sample. Fix some other quickstarts. #438

Merged
merged 1 commit into from
Dec 8, 2016
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -69,4 +69,3 @@ public void testQuickstart() throws Exception {
assertThat(got).contains("Saved sampletask1: Buy milk");
}
}
// [END datastore_quickstart]
30 changes: 30 additions & 0 deletions language/cloud-client/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
# Getting Started with Google Cloud Natural Language API and the Google Cloud Client libraries

[Google Cloud Natural Language API][language] provides natural language
understanding technologies to developers, including sentiment analysis, entity
recognition, and syntax analysis. This API is part of the larger collection of
Cloud Machine Learning APIs.

These sample Java applications demonstrate how to access the Cloud Natural
Language API using the [Google Cloud Client Library for Java][google-cloud-java].

[language]: https://cloud.google.com/natural-language/docs/
[google-cloud-java]: https://github.com/GoogleCloudPlatform/google-cloud-java

## Quickstart

Install [Maven](http://maven.apache.org/).

Build your project with:

mvn clean package -DskipTests

You can then run a given `ClassName` via:

mvn exec:java -Dexec.mainClass=com.example.language.ClassName \
-DpropertyName=propertyValue \
-Dexec.args="arg1 'arg 2' arg3"

### Analyze a string for sentiment (using the quickstart sample)

mvn exec:java -Dexec.mainClass=com.example.language.QuickstartSample
57 changes: 57 additions & 0 deletions language/cloud-client/pom.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,57 @@
<!--
Copyright 2016 Google Inc. All Rights Reserved.

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.
-->
<project>
<modelVersion>4.0.0</modelVersion>
<groupId>com.example.language</groupId>
<artifactId>language-google-cloud-samples</artifactId>
<packaging>jar</packaging>

<!-- Parent defines config for testing & linting. -->
<parent>
<artifactId>doc-samples</artifactId>
<groupId>com.google.cloud</groupId>
<version>1.0.0</version>
<relativePath>../..</relativePath>
</parent>

<properties>
<maven.compiler.target>1.8</maven.compiler.target>
<maven.compiler.source>1.8</maven.compiler.source>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>

<dependencies>
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>google-cloud-language</artifactId>
<version>0.7.0</version>
</dependency>

<!-- Test dependencies -->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>com.google.truth</groupId>
<artifactId>truth</artifactId>
<version>0.30</version>
<scope>test</scope>
</dependency>
</dependencies>
</project>
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
/*
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.
*/

package com.example.language;

// [START language_quickstart]
// Imports the Google Cloud client library
import com.google.cloud.language.spi.v1.LanguageServiceClient;
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do you know why this is in a different package than the rest?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.


import com.google.cloud.language.v1.Document;
import com.google.cloud.language.v1.Document.Type;
import com.google.cloud.language.v1.Sentiment;

public class QuickstartSample {
public static void main(String... args) throws Exception {
// Instantiates a client
LanguageServiceClient language = LanguageServiceClient.create();

// The text to analyze
String text = "Hello, world!";
Document doc = Document.newBuilder()
.setContent(text).setType(Type.PLAIN_TEXT).build();

// Detects the sentiment of the text
Sentiment sentiment = language.analyzeSentiment(doc).getDocumentSentiment();

System.out.printf("Text: %s%n", text);
System.out.printf("Sentiment: %s, %s%n", sentiment.getScore(), sentiment.getMagnitude());
}
}
// [END language_quickstart]
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
/*
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.
*/

package com.example.language;

import static com.google.common.truth.Truth.assertThat;

import org.junit.After;
import org.junit.Before;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.junit.runners.JUnit4;

import java.io.ByteArrayOutputStream;
import java.io.PrintStream;

/**
* Tests for quickstart sample.
*/
@RunWith(JUnit4.class)
@SuppressWarnings("checkstyle:abbreviationaswordinname")
public class QuickstartSampleIT {
private ByteArrayOutputStream bout;
private PrintStream out;

@Before
public void setUp() {
bout = new ByteArrayOutputStream();
out = new PrintStream(bout);
System.setOut(out);
}

@After
public void tearDown() {
System.setOut(null);
}

@Test
public void testQuickstart() throws Exception {
// Act
QuickstartSample.main();

// Assert
String got = bout.toString();
assertThat(got).contains("Text: Hello, world!");
assertThat(got).contains("Sentiment: ");
}
}
Original file line number Diff line number Diff line change
Expand Up @@ -66,4 +66,3 @@ public void testQuickstart() throws Exception {
assertThat(got).contains("Topic my-new-topic created.");
}
}
// [END datastore_quickstart]
Original file line number Diff line number Diff line change
Expand Up @@ -67,4 +67,3 @@ public void testQuickstart() throws Exception {
assertThat(got).contains(String.format("Bucket %s created.", bucketName));
}
}
// [END datastore_quickstart]
5 changes: 2 additions & 3 deletions translate/cloud-client/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

[Google Translate API][translate] provides a simple programmatic interface for translating an
arbitrary string into any supported language.
These sample Java applications demonstrate how to access the Cloud Storage API using
These sample Java applications demonstrate how to access the Google Translate API using
the [Google Cloud Client Library for Java][google-cloud-java].

[translate]: https://cloud.google.com/translate/
Expand All @@ -24,5 +24,4 @@ You can then run a given `ClassName` via:

### Translate a string (using the quickstart sample)

mvn exec:java -Dexec.mainClass=com.example.translate.QuickstartSample \
-Dexec.args="YOUR_API_KEY"
mvn exec:java -Dexec.mainClass=com.example.translate.QuickstartSample
Original file line number Diff line number Diff line change
Expand Up @@ -59,4 +59,3 @@ public void testQuickstart() throws Exception {
assertThat(got).contains("Translation: ");
}
}
// [END datastore_quickstart]