Skip to content

Commit 0d4a5a7

Browse files
authored
Merge pull request #220 from carlosms/rename-web-ui
Rename playground to web in the UI and docs
2 parents a90330a + b157895 commit 0d4a5a7

File tree

8 files changed

+30
-30
lines changed

8 files changed

+30
-30
lines changed

.github/screenshot.png

353 KB
Loading

README.md

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,17 @@
1-
[![Build Status](https://travis-ci.org/src-d/gitbase-playground.svg)](https://travis-ci.org/src-d/gitbase-playground)
2-
[![codecov.io](https://codecov.io/github/src-d/gitbase-playground/coverage.svg)](https://codecov.io/github/src-d/gitbase-playground)
1+
[![Build Status](https://travis-ci.org/src-d/gitbase-web.svg)](https://travis-ci.org/src-d/gitbase-web)
2+
[![codecov.io](https://codecov.io/github/src-d/gitbase-web/coverage.svg)](https://codecov.io/github/src-d/gitbase-web)
33

4-
# Gitbase Playground
4+
# Gitbase Web
55

6-
Web application to query Git repositories using SQL. Powered by [gitbase](https://github.com/src-d/gitbase), it allows to perform SQL queries on the Git history and the [Universal AST](https://doc.bblf.sh/) of the code itself.
6+
Application to query Git repositories using SQL. Powered by [gitbase](https://github.com/src-d/gitbase), it allows to perform SQL queries on the Git history and the [Universal AST](https://doc.bblf.sh/) of the code itself.
77

88
![Screenshot](.github/screenshot.png?raw=true)
99

1010
# Usage
1111

1212
## With Docker Compose
1313

14-
The easiest way to run Gitbase Playground and its dependencies is using [Docker Compose](https://docs.docker.com/compose/install/).
14+
The easiest way to run Gitbase Web and its dependencies is using [Docker Compose](https://docs.docker.com/compose/install/).
1515

1616
The first step is to populate a directory with some Git repositories to be served by gitbase before running it. For example:
1717

@@ -20,13 +20,13 @@ $ mkdir $HOME/repos
2020
$ cd $HOME/repos
2121
$ git clone [email protected]:src-d/gitbase.git
2222
$ git clone [email protected]:bblfsh/bblfshd.git
23-
$ git clone [email protected]:src-d/gitbase-playground.git
23+
$ git clone [email protected]:src-d/gitbase-web.git
2424
```
2525

26-
Next you will need to download the `docker-compose.yml` file from this repository and run `docker-compose`. This tool will run three different containers: the playground frontend itself, gitbase, and bblfshd. To kill the running containers use `Ctrl+C`.
26+
Next you will need to download the `docker-compose.yml` file from this repository and run `docker-compose`. This tool will run three different containers: the gitbase-web frontend itself, gitbase, and bblfshd. To kill the running containers use `Ctrl+C`.
2727

2828
```bash
29-
$ wget https://raw.githubusercontent.com/src-d/gitbase-playground/master/docker-compose.yml
29+
$ wget https://raw.githubusercontent.com/src-d/gitbase-web/master/docker-compose.yml
3030
$ docker-compose pull
3131
$ GITBASEPG_REPOS_FOLDER=$HOME/repos docker-compose up --force-recreate
3232
```
@@ -41,29 +41,29 @@ for cleanup.
4141

4242
## Without Docker Compose
4343

44-
The playground will run the queries against a [gitbase](https://docs.sourced.tech/gitbase) server, and will request UASTs to a [bblfsh](https://doc.bblf.sh/) server. Make sure both are properly configured.
44+
The application will run the queries against a [gitbase](https://docs.sourced.tech/gitbase) server, and will request UASTs to a [bblfsh](https://doc.bblf.sh/) server. Make sure both are properly configured.
4545

46-
Then you can choose to run the Gitbase Playground either as a docker container, or as a binary.
46+
Then you can choose to run the web client either as a docker container, or as a binary.
4747

4848
### As a Docker
4949

5050
```bash
51-
$ docker pull srcd/gitbase-playground:latest
51+
$ docker pull srcd/gitbase-web:latest
5252
$ docker run -d \
5353
--publish 8080:8080 \
5454
--env GITBASEPG_DB_CONNECTION="root@tcp(<gitbase-ip>:3306)/none" \
5555
--env GITBASEPG_BBLFSH_SERVER_URL="<bblfshd-ip>:9432" \
56-
srcd/gitbase-playground:latest
56+
srcd/gitbase-web:latest
5757
```
5858

5959
### As a Binary
6060

61-
Download the binary from our [releases section](https://github.com/src-d/gitbase-playground/releases), and run it:
61+
Download the binary from our [releases section](https://github.com/src-d/gitbase-web/releases), and run it:
6262

6363
```bash
6464
$ export GITBASEPG_DB_CONNECTION="root@tcp(<gitbase-ip>:3306)/none"
6565
$ export GITBASEPG_BBLFSH_SERVER_URL="<bblfshd-ip>:9432"
66-
$ ./gitbase-playground
66+
$ ./gitbase-web
6767
```
6868

6969
# Configuration
@@ -83,7 +83,7 @@ Any of the previous execution methods accept configuration through the following
8383

8484
# Contribute
8585

86-
[Contributions](https://github.com/src-d/gitbase-playground/issues) are more than welcome, if you are interested please take a look to our [Contributing Guidelines](docs/CONTRIBUTING.md). There you will also find information on how to build and run the project from sources.
86+
[Contributions](https://github.com/src-d/gitbase-web/issues) are more than welcome, if you are interested please take a look to our [Contributing Guidelines](docs/CONTRIBUTING.md). There you will also find information on how to build and run the project from sources.
8787

8888
# Code of Conduct
8989

docs/CONTRIBUTING.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Gitbase Playground Contribution Guidelines
1+
# Gitbase Web Contribution Guidelines
22

33
As all source{d} projects, this project follows the
44
[source{d} Contributing Guidelines](https://github.com/src-d/guide/blob/master/engineering/documents/CONTRIBUTING.md).
@@ -11,7 +11,7 @@ Refer to the main [README](../README.md) for the common requirements and configu
1111

1212
Make sure you also satisfy these requirements:
1313
- [Install Go](https://golang.org/doc/install) and [configure the $GOPATH](https://github.com/golang/go/wiki/SettingGOPATH).
14-
- This project should be cloned in `$GOPATH/github.com/src-d/gitbase-playground`.
14+
- This project should be cloned in `$GOPATH/github.com/src-d/gitbase-web`.
1515
- Install [Node.js](https://nodejs.org) and [Yarn](https://yarnpkg.com/en/docs/install).
1616

1717
## Run bblfsh and gitbase Dependencies
@@ -37,7 +37,7 @@ $ mkdir $HOME/repos
3737
$ cd $HOME/repos
3838
$ git clone [email protected]:src-d/gitbase.git
3939
$ git clone [email protected]:bblfsh/bblfshd.git
40-
$ git clone [email protected]:src-d/gitbase-playground.git
40+
$ git clone [email protected]:src-d/gitbase-web.git
4141
```
4242

4343
Launch gitbase:
@@ -69,8 +69,8 @@ Each one of the following sections describes an alternative method to run the pr
6969
They all require the project is cloned into your `$GOPATH`.
7070

7171
```bash
72-
$ go get -d -u github.com/src-d/gitbase-playground/...
73-
$ cd $GOPATH/github.com/src-d/gitbase-playground
72+
$ go get -d -u github.com/src-d/gitbase-web/...
73+
$ cd $GOPATH/github.com/src-d/gitbase-web
7474
```
7575

7676
## Run from Sources
@@ -90,7 +90,7 @@ Instead of rebuilding the frontend and restarting the backend every time you do
9090
In one terminal run the Go backend:
9191

9292
```bash
93-
$ GITBASEPG_ENV=dev go run cmd/gitbase-playground/main.go
93+
$ GITBASEPG_ENV=dev go run cmd/gitbase-web/main.go
9494
```
9595

9696
In another terminal, run the frontend:
@@ -101,7 +101,7 @@ $ yarn --cwd frontend start
101101

102102
## Run with Docker Compose from Sources
103103

104-
The file `docker-compose.build.yml` overrides the default compose file. Using it a new docker image, `gitbase-playground-dev`, will be created from the current sources.
104+
The file `docker-compose.build.yml` overrides the default compose file. Using it a new docker image, `gitbase-web-dev`, will be created from the current sources.
105105

106106
```bash
107107
$ make dependencies
@@ -151,7 +151,7 @@ Use the `GITBASEPG_INTEGRATION_TESTS=true` environment variable with the same `m
151151

152152
The integration tests require that `gitbase` and `bblfshd` are running and reachable. See the [Requirements section](#requirements) above for more details.
153153

154-
It is also required to configure the running `gitbase` to serve a copy of the `https://github.com/src-d/gitbase-playground` repository.
154+
It is also required to configure the running `gitbase` to serve a copy of the `https://github.com/src-d/gitbase-web` repository.
155155

156156
```bash
157157
$ GITBASEPG_INTEGRATION_TESTS=true make test

docs/rest-api.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -151,7 +151,7 @@ curl -X POST \
151151
"status": 200,
152152
"data": [
153153
{
154-
"content": "package server\n\nimport (\n\t\"net/http\"\n\n\t\"github.com/src-d/gitbase-playground/server/handler\"\n\n\t\"github.com/go-chi/chi\"\n\t\"github.com/go-chi/chi/middleware\"\n\t\"github.com/pressly/lg\"\n\t\"github.com/rs/cors\"\n\t\"github.com/sirupsen/logrus\"\n)\n\n// Router returns a Handler to serve the backend\nfunc Router(\n\tlogger *logrus.Logger,\n\tstatic *handler.Static,\n\tversion string,\n) http.Handler {\n\n\t// cors options\n\tcorsOptions := cors.Options{\n\t\tAllowedOrigins: []string{\"*\"},\n\t\tAllowedMethods: []string{\"GET\", \"POST\", \"PUT\", \"OPTIONS\"},\n\t\tAllowedHeaders: []string{\"Location\", \"Authorization\", \"Content-Type\"},\n\t\tAllowCredentials: true,\n\t}\n\n\tr := chi.NewRouter()\n\n\tr.Use(middleware.Recoverer)\n\tr.Use(cors.New(corsOptions).Handler)\n\tr.Use(lg.RequestLogger(logger))\n\n\tr.Get(\"/version\", handler.APIHandlerFunc(handler.Version(version)))\n\n\tr.Get(\"/static/*\", static.ServeHTTP)\n\tr.Get(\"/*\", static.ServeHTTP)\n\n\treturn r\n}\n",
154+
"content": "package server\n\nimport (\n\t\"net/http\"\n\n\t\"github.com/src-d/gitbase-web/server/handler\"\n\n\t\"github.com/go-chi/chi\"\n\t\"github.com/go-chi/chi/middleware\"\n\t\"github.com/pressly/lg\"\n\t\"github.com/rs/cors\"\n\t\"github.com/sirupsen/logrus\"\n)\n\n// Router returns a Handler to serve the backend\nfunc Router(\n\tlogger *logrus.Logger,\n\tstatic *handler.Static,\n\tversion string,\n) http.Handler {\n\n\t// cors options\n\tcorsOptions := cors.Options{\n\t\tAllowedOrigins: []string{\"*\"},\n\t\tAllowedMethods: []string{\"GET\", \"POST\", \"PUT\", \"OPTIONS\"},\n\t\tAllowedHeaders: []string{\"Location\", \"Authorization\", \"Content-Type\"},\n\t\tAllowCredentials: true,\n\t}\n\n\tr := chi.NewRouter()\n\n\tr.Use(middleware.Recoverer)\n\tr.Use(cors.New(corsOptions).Handler)\n\tr.Use(lg.RequestLogger(logger))\n\n\tr.Get(\"/version\", handler.APIHandlerFunc(handler.Version(version)))\n\n\tr.Get(\"/static/*\", static.ServeHTTP)\n\tr.Get(\"/*\", static.ServeHTTP)\n\n\treturn r\n}\n",
155155
"hash": "fd30cea52792da5ece9156eea4022bdd87565633",
156156
"uast(blobs.content, \"go\")": [
157157
{
@@ -259,7 +259,7 @@ curl -X GET http://localhost:8080/export?query=select+*+from+repositories
259259

260260
```json
261261
id
262-
/opt/repos/gitbase-playground
262+
/opt/repos/gitbase-web
263263
/opt/repos/go-git-fixtures
264264
```
265265

frontend/public/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@
1919
work correctly both with client-side routing and a non-root public URL.
2020
Learn how to configure a non-root public URL by running `npm run build`.
2121
-->
22-
<title>Gitbase Playground</title>
22+
<title>Gitbase Web</title>
2323
</head>
2424
<body>
2525
<noscript>

frontend/public/manifest.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
2-
"short_name": "Gitbase Playground",
3-
"name": "Gitbase Playground",
2+
"short_name": "Gitbase Web",
3+
"name": "Gitbase Web",
44
"icons": [
55
{
66
"src": "favicon.ico",

frontend/src/App.js

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -408,7 +408,7 @@ AND refs.ref_name = 'HEAD'`
408408
return (
409409
<div className="app">
410410
<Helmet>
411-
<title>Gitbase Playground</title>
411+
<title>Gitbase Web</title>
412412
</Helmet>
413413
<Grid className="full-height app-grid" fluid={true}>
414414
<Row className="main-row full-height">

frontend/src/components/Sidebar.js

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ class Sidebar extends Component {
3838
return (
3939
<div className={`sidebar ${collapsed ? 'collapsed' : ''}`}>
4040
<div className="header">
41-
<h3>gitbase playgroun{'{d}'}</h3>
41+
<h3>gitbase web</h3>
4242
<CollapseIcon className="big-icon" onClick={this.handleToggle} />
4343
</div>
4444
<div className="main">

0 commit comments

Comments
 (0)