|
| 1 | +<!-- |
| 2 | + Licensed to the Apache Software Foundation (ASF) under one |
| 3 | + or more contributor license agreements. See the NOTICE file |
| 4 | + distributed with this work for additional information |
| 5 | + regarding copyright ownership. The ASF licenses this file |
| 6 | + to you under the Apache License, Version 2.0 (the |
| 7 | + "License"); you may not use this file except in compliance |
| 8 | + with the License. You may obtain a copy of the License at |
| 9 | +
|
| 10 | + http://www.apache.org/licenses/LICENSE-2.0 |
| 11 | +
|
| 12 | + Unless required by applicable law or agreed to in writing, |
| 13 | + software distributed under the License is distributed on an |
| 14 | + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| 15 | + KIND, either express or implied. See the License for the |
| 16 | + specific language governing permissions and limitations |
| 17 | + under the License. |
| 18 | +--> |
| 19 | + |
| 20 | +# Playground |
| 21 | + |
| 22 | +The Beam Playground is a web application to run Beam code snippets in a modern |
| 23 | +browser. This directory holds code to build, test, and deploy the frontend |
| 24 | +and backend services. |
| 25 | + |
| 26 | +# Requirements |
| 27 | + |
| 28 | +The following requirements are needed for development, testing, and deploying. |
| 29 | + |
| 30 | +- [go 1.16+](https://golang.org) |
| 31 | +- [flutter](https://flutter.dev/) |
| 32 | +- Go protobuf dependencies (See [Go gRPC Quickstart](https://grpc.io/docs/languages/go/quickstart/)) |
| 33 | +- Dart protobuf dependencies (See [Dart gRPC Quickstart](https://grpc.io/docs/languages/dart/)) |
| 34 | +- [buf](https://docs.buf.build/installation) |
| 35 | + |
| 36 | +# Available Gradle Tasks |
| 37 | + |
| 38 | +## Perform overall pre-commit checks |
| 39 | + |
| 40 | +``` |
| 41 | +cd beam |
| 42 | +./gradlew playgroundPrecommit |
| 43 | +``` |
| 44 | + |
| 45 | +## To see available gradle tasks for playground: |
| 46 | + |
| 47 | +``` |
| 48 | +cd beam |
| 49 | +./gradlew playground:tasks |
| 50 | +``` |
| 51 | + |
| 52 | +## Re-generate protobuf |
| 53 | + |
| 54 | +``` |
| 55 | +cd beam |
| 56 | +./gradlew playground:generateProto |
| 57 | +``` |
0 commit comments