Skip to content
This repository has been archived by the owner on Sep 16, 2023. It is now read-only.

Commit

Permalink
chore: update repo-metadata and regenerate README from templates (#53)
Browse files Browse the repository at this point in the history
  • Loading branch information
chingor13 authored Feb 4, 2020
1 parent aa27b64 commit 4f3b0d7
Show file tree
Hide file tree
Showing 4 changed files with 123 additions and 82 deletions.
6 changes: 4 additions & 2 deletions .repo-metadata.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,12 +2,14 @@
"name": "websecurityscanner",
"name_pretty": "Cloud Security Scanner",
"product_documentation": "https://cloud.google.com/security-scanner/docs/",
"client_documentation": "https://googleapis.dev/java/java-websecurityscanner/latest/",
"client_documentation": "https://googleapis.dev/java/google-cloud-websecurityscanner/latest/",
"issue_tracker": "https://issuetracker.google.com/savedsearches/559748",
"release_level": "beta",
"language": "java",
"repo": "googleapis/java-websecurityscanner",
"repo_short": "java-websecurityscanner",
"distribution_name": "com.google.cloud:google-cloud-websecurityscanner",
"api_id": "websecurityscanner.googleapis.com"
"api_id": "websecurityscanner.googleapis.com",
"transport": "grpc",
"api_description": "identifies security vulnerabilities in your App Engine, Compute Engine, and Google Kubernetes Engine web applications. It crawls your application, following all links within the scope of your starting URLs, and attempts to exercise as many user inputs and event handlers as possible."
}
173 changes: 108 additions & 65 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,48 +1,52 @@
Google Cloud Java Client for Cloud Security Scanner
===================================================
# Google Cloud Security Scanner Client for Java

Java idiomatic client for [Cloud Security Scanner][cloud-websecurityscanner].
Java idiomatic client for [Cloud Security Scanner][product-docs].

[![Kokoro CI](http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/master.svg)](http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/master.html)
[![Maven](https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-websecurityscanner.svg)](https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-websecurityscanner.svg)
[![Codacy Badge](https://api.codacy.com/project/badge/grade/9da006ad7c3a4fe1abd142e77c003917)](https://www.codacy.com/app/mziccard/google-cloud-java)
[![Maven][maven-version-image]][maven-version-link]
![Stability][stability-image]

- [Product Documentation][websecurityscanner-product-docs]
- [Client Library Documentation][websecurityscanner-client-lib-docs]
- [Product Documentation][product-docs]
- [Client Library Documentation][javadocs]

> Note: This client is a work-in-progress, and may occasionally
> make backwards-incompatible changes.
Quickstart
----------
If you are using Maven with Bom, Add this to your pom.xml file.
## Quickstart

If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file
```xml
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>libraries-bom</artifactId>
<version>2.8.0</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
<dependencies>
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>libraries-bom</artifactId>
<version>3.5.0</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>

<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>google-cloud-websecurityscanner</artifactId>
</dependency>
<dependencies>
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>google-cloud-websecurityscanner</artifactId>
</dependency>
</dependencies>
```

[//]: # ({x-version-update-start:google-cloud-websecurityscanner:released})
If you are using Maven without Bom, Add this to your dependencies.

If you are using Maven without BOM, add this to your dependencies:

```xml
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>google-cloud-websecurityscanner</artifactId>
<version>0.116.1</version>
</dependency>
```

If you are using Gradle, add this to your dependencies
```Groovy
compile 'com.google.cloud:google-cloud-websecurityscanner:0.116.1'
Expand All @@ -53,66 +57,105 @@ libraryDependencies += "com.google.cloud" % "google-cloud-websecurityscanner" %
```
[//]: # ({x-version-update-end})

Authentication
--------------
## Authentication

See the [Authentication](https://github.com/googleapis/google-cloud-java#authentication) section in the base directory's README.
See the [Authentication][authentication] section in the base directory's README.

About Cloud Security Scanner
----------------------------
## Getting Started

[Cloud Security Scanner][cloud-websecurityscanner] is a web security scanner for common vulnerabilities in Google App Engine applications.
### Prerequisites

See the [Cloud Security Scanner client library docs][websecurityscanner-client-lib-docs] to learn how to use this Cloud Security Scanner Client Library.
You will need a [Google Cloud Platform Console][developer-console] project with the Cloud Security Scanner [API enabled][enable-api].

Getting Started
---------------
#### Prerequisites
You will need a [Google Developers Console](https://console.developers.google.com/) project with the Cloud Security Scanner API enabled. [Follow these instructions](https://cloud.google.com/resource-manager/docs/creating-managing-projects) to get your project set up. You will also need to set up the local development environment by [installing the Google Cloud SDK](https://cloud.google.com/sdk/) and running the following commands in command line: `gcloud auth login` and `gcloud config set project [YOUR PROJECT ID]`.
[Follow these instructions][create-project] to get your project set up. You will also need to set up the local development environment by
[installing the Google Cloud SDK][cloud-sdk] and running the following commands in command line:
`gcloud auth login` and `gcloud config set project [YOUR PROJECT ID]`.

#### Installation and setup
You'll need to obtain the `google-cloud-websecurityscanner` library. See the [Quickstart](#quickstart) section to add `google-cloud-websecurityscanner` as a dependency in your code.
### Installation and setup

Troubleshooting
---------------
You'll need to obtain the `google-cloud-websecurityscanner` library. See the [Quickstart](#quickstart) section
to add `google-cloud-websecurityscanner` as a dependency in your code.

To get help, follow the instructions in the [shared Troubleshooting document](https://github.com/googleapis/google-cloud-common/blob/master/troubleshooting/readme.md#troubleshooting).
## About Cloud Security Scanner


[Cloud Security Scanner][product-docs] identifies security vulnerabilities in your App Engine, Compute Engine, and Google Kubernetes Engine web applications. It crawls your application, following all links within the scope of your starting URLs, and attempts to exercise as many user inputs and event handlers as possible.

See the [Cloud Security Scanner client library docs][javadocs] to learn how to
use this Cloud Security Scanner Client Library.




## Troubleshooting

To get help, follow the instructions in the [shared Troubleshooting document][troubleshooting].

## Transport

Transport
---------
Cloud Security Scanner uses gRPC for the transport layer.

Java Versions
-------------
## Java Versions

Java 7 or above is required for using this client.

Versioning
----------
## Versioning

This library follows [Semantic Versioning](http://semver.org/).

It is currently in major version zero (``0.y.z``), which means that anything may change at any time and the public API should not be considered stable.

Contributing
------------

Contributions to this library are always welcome and highly encouraged.

See `google-cloud`'s [CONTRIBUTING] documentation and the [shared documentation](https://github.com/googleapis/google-cloud-common/blob/master/contributing/readme.md#how-to-contribute-to-gcloud) for more information on how to get started.
It is currently in major version zero (``0.y.z``), which means that anything may change at any time
and the public API should not be considered stable.

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms. See [Code of Conduct][code-of-conduct] for more information.

License
-------
## Contributing

Apache 2.0 - See [LICENSE] for more information.

Contributions to this library are always welcome and highly encouraged.

[CONTRIBUTING]:https://github.com/googleapis/google-cloud-java/blob/master/CONTRIBUTING.md
[code-of-conduct]:https://github.com/googleapis/google-cloud-java/blob/master/CODE_OF_CONDUCT.md#contributor-code-of-conduct
[LICENSE]: https://github.com/googleapis/google-cloud-java/blob/master/LICENSE
[cloud-platform]: https://cloud.google.com/
[cloud-websecurityscanner]: https://cloud.google.com/security-scanner
[websecurityscanner-product-docs]: https://cloud.google.com/security-scanner/docs
[websecurityscanner-client-lib-docs]: https://googleapis.dev/java/google-cloud-clients/latest/index.html?com/google/cloud/websecurityscanner/v1alpha/package-summary.html
See [CONTRIBUTING][contributing] for more information how to get started.

Please note that this project is released with a Contributor Code of Conduct. By participating in
this project you agree to abide by its terms. See [Code of Conduct][code-of-conduct] for more
information.

## License

Apache 2.0 - See [LICENSE][license] for more information.

## CI Status

Java Version | Status
------------ | ------
Java 7 | [![Kokoro CI][kokoro-badge-image-1]][kokoro-badge-link-1]
Java 8 | [![Kokoro CI][kokoro-badge-image-2]][kokoro-badge-link-2]
Java 8 OSX | [![Kokoro CI][kokoro-badge-image-3]][kokoro-badge-link-3]
Java 8 Windows | [![Kokoro CI][kokoro-badge-image-4]][kokoro-badge-link-4]
Java 11 | [![Kokoro CI][kokoro-badge-image-5]][kokoro-badge-link-5]

[product-docs]: https://cloud.google.com/security-scanner/docs/
[javadocs]: https://googleapis.dev/java/google-cloud-websecurityscanner/latest/
[kokoro-badge-image-1]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-websecurityscanner/java7.svg
[kokoro-badge-link-1]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-websecurityscanner/java7.html
[kokoro-badge-image-2]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-websecurityscanner/java8.svg
[kokoro-badge-link-2]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-websecurityscanner/java8.html
[kokoro-badge-image-3]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-websecurityscanner/java8-osx.svg
[kokoro-badge-link-3]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-websecurityscanner/java8-osx.html
[kokoro-badge-image-4]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-websecurityscanner/java8-win.svg
[kokoro-badge-link-4]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-websecurityscanner/java8-win.html
[kokoro-badge-image-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-websecurityscanner/java11.svg
[kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-websecurityscanner/java11.html
[stability-image]: https://img.shields.io/badge/stability-beta-yellow
[maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-websecurityscanner.svg
[maven-version-link]: https://search.maven.org/search?q=g:com.google.cloud%20AND%20a:google-cloud-websecurityscanner&core=gav
[authentication]: https://github.com/googleapis/google-cloud-java#authentication
[developer-console]: https://console.developers.google.com/
[create-project]: https://cloud.google.com/resource-manager/docs/creating-managing-projects
[cloud-sdk]: https://cloud.google.com/sdk/
[troubleshooting]: https://github.com/googleapis/google-cloud-common/blob/master/troubleshooting/readme.md#troubleshooting
[contributing]: https://github.com/googleapis/java-websecurityscanner/blob/master/CONTRIBUTING.md
[code-of-conduct]: https://github.com/googleapis/java-websecurityscanner/blob/master/CODE_OF_CONDUCT.md#contributor-code-of-conduct
[license]: https://github.com/googleapis/java-websecurityscanner/blob/master/LICENSE

[enable-api]: https://console.cloud.google.com/flows/enableapi?apiid=websecurityscanner.googleapis.com
[libraries-bom]: https://github.com/GoogleCloudPlatform/cloud-opensource-java/wiki/The-Google-Cloud-Platform-Libraries-BOM
8 changes: 4 additions & 4 deletions synth.metadata
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"updateTime": "2020-02-01T09:12:58.101159Z",
"updateTime": "2020-02-03T23:47:44.573170Z",
"sources": [
{
"generator": {
Expand All @@ -12,9 +12,9 @@
"git": {
"name": "googleapis",
"remote": "https://github.com/googleapis/googleapis.git",
"sha": "b5cbe4a4ba64ab19e6627573ff52057a1657773d",
"internalRef": "292647187",
"log": "b5cbe4a4ba64ab19e6627573ff52057a1657773d\nSecurityCenter v1p1beta1: move file-level option on top to workaround protobuf.js bug.\n\nPiperOrigin-RevId: 292647187\n\nb224b317bf20c6a4fbc5030b4a969c3147f27ad3\nAdds API definitions for bigqueryreservation v1beta1.\n\nPiperOrigin-RevId: 292634722\n\nc1468702f9b17e20dd59007c0804a089b83197d2\nSynchronize new proto/yaml changes.\n\nPiperOrigin-RevId: 292626173\n\nffdfa4f55ab2f0afc11d0eb68f125ccbd5e404bd\nvision: v1p3beta1 publish annotations and retry config\n\nPiperOrigin-RevId: 292605599\n\n78f61482cd028fc1d9892aa5d89d768666a954cd\nvision: v1p1beta1 publish annotations and retry config\n\nPiperOrigin-RevId: 292605125\n\n60bb5a294a604fd1778c7ec87b265d13a7106171\nvision: v1p2beta1 publish annotations and retry config\n\nPiperOrigin-RevId: 292604980\n\n3bcf7aa79d45eb9ec29ab9036e9359ea325a7fc3\nvision: v1p4beta1 publish annotations and retry config\n\nPiperOrigin-RevId: 292604656\n\n2717b8a1c762b26911b45ecc2e4ee01d98401b28\nFix dataproc artman client library generation.\n\nPiperOrigin-RevId: 292555664\n\n"
"sha": "29d40b78e3dc1579b0b209463fbcb76e5767f72a",
"internalRef": "292979741",
"log": "29d40b78e3dc1579b0b209463fbcb76e5767f72a\nExpose managedidentities/v1beta1/ API for client library usage.\n\nPiperOrigin-RevId: 292979741\n\na22129a1fb6e18056d576dfb7717aef74b63734a\nExpose managedidentities/v1/ API for client library usage.\n\nPiperOrigin-RevId: 292968186\n\n"
}
},
{
Expand Down
18 changes: 7 additions & 11 deletions synth.py
Original file line number Diff line number Diff line change
Expand Up @@ -25,15 +25,11 @@
config_pattern = '/google/cloud/websecurityscanner/artman_websecurityscanner_{version}.yaml'

for version in versions:
java.gapic_library(
service=service,
version=version,
config_pattern=config_pattern,
gapic=gapic,
)
java.gapic_library(
service=service,
version=version,
config_pattern=config_pattern,
gapic=gapic,
)

common_templates = gcp.CommonTemplates()
templates = common_templates.java_library()
s.copy(templates, excludes=[
'README.md',
])
java.common_templates()

0 comments on commit 4f3b0d7

Please sign in to comment.