Skip to content
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
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@
*.dylib
.DS_Store
*.swp
*.orig

# Test binary, build with `go test -c`
*.test
Expand Down
31 changes: 31 additions & 0 deletions DEVELOPMENT.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
# Development

This is a REST portal server created using [go-swagger](https://github.com/go-swagger/go-swagger)

The API handlers are created using a YAML definition located in `swagger.YAML`.

To add new api, the YAML file needs to be updated with all the desired apis using the [Swagger Basic Structure](https://swagger.io/docs/specification/2-0/basic-structure/), this includes paths, parameters, definitions, tags, etc.

## Generate server from YAML
Once the YAML file is ready we can autogenerate the code needed for the new api by just running:

Validate it:
```
swagger validate ./swagger.yml
```
Update server code:
```
make swagger-gen
```

This will update all the necessary code.

`./restapi/configure_mcs.go` is a file that contains the handlers to be used by the application, here is the only place where we need to update our code to support the new apis. This file is not affected when running the swagger generator and it is safe to edit.

## Unit Tests
`./restapi/handlers_test.go` needs to be updated with the proper tests for the new api.

To run tests:
```
go test ./restapi
```
32 changes: 2 additions & 30 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# MCS Minio Console Service
# Minio Console Server

A graphical user interface for [MinIO](https://github.com/minio/minio)

Expand Down Expand Up @@ -64,32 +64,4 @@ You can verify that the apis work by doing the request on `localhost:9090/api/v1

# Development

This is a REST portal server created using [go-swagger](https://github.com/go-swagger/go-swagger)

The API handlers are created using a YAML definition located in `swagger.YAML`.

To add new api, the YAML file needs to be updated with all the desired apis using the [Swagger Basic Structure](https://swagger.io/docs/specification/2-0/basic-structure/), this includes paths, parameters, definitions, tags, etc.

## Generate server from YAML
Once the YAML file is ready we can autogenerate the code needed for the new api by just running:

Validate it:
```
swagger validate ./swagger.yml
```
Update server code:
```
make swagger-gen
```

This will update all the necessary code.

`./restapi/configure_mcs.go` is a file that contains the handlers to be used by the application, here is the only place where we need to update our code to support the new apis. This file is not affected when running the swagger generator and it is safe to edit.

## Unit Tests
`./restapi/handlers_test.go` needs to be updated with the proper tests for the new api.

To run tests:
```
go test ./restapi
```
For development on this project please refer to our [DEVELOPMENT.md](DEVELOPMENT.md)