shad-go/coverme/README.md

85 lines
2.8 KiB
Markdown
Raw Normal View History

2020-03-19 21:57:07 +00:00
## coverme
В этой задаче нужно покрыть простой todo-app http сервис unit тестами.
2020-03-19 22:30:21 +00:00
Необходимо покрыть все sub-package'и.
2020-03-19 21:57:07 +00:00
Package main можно не тестировать.
2020-03-19 22:30:21 +00:00
Существующие файлы менять не нужно.
Нужно создавать новые файлы с тестами.
Тестирующая система будет проверять code coverage.
2020-03-19 21:57:07 +00:00
Порог задан в [coverage_test.go](./app/coverage_test.go)
2020-03-19 22:38:59 +00:00
Важно понимать, что coverage 100% - не решение всех проблем.
В коде по-прежнему могут быть ошибки.
Coverage 100% говорит ровно о том, что все строки кода выполнялись.
Хорошие тесты в первую очередь тестируют функциональность.
2020-03-19 21:57:07 +00:00
Как посмотреть coverage:
```
go test -v -cover ./coverme/...
```
2020-03-19 22:30:21 +00:00
Coverage можно выводить в html (см. ссылки), и эта функциональность поддерживается в Goland.
2020-03-19 21:57:07 +00:00
## Ссылки
1. cover: https://blog.golang.org/cover
2. [gomock](https://github.com/golang/mock) для создания мока базы данных при тестировании серевера
3. [httptest.ResponseRecorder](https://golang.org/pkg/net/http/httptest/#ResponseRecorder) для тестирования handler'ов сервера
4. [httptest.Server](https://golang.org/pkg/net/http/httptest/#Server) для тестирования клинета
2020-03-19 22:30:21 +00:00
5. Если вы ждёте, когда же выложат лекцию: https://www.youtube.com/watch?v=ndmB0bj7eyw
2020-03-19 21:57:07 +00:00
## O сервисе
Todo-app с минимальной функциональностью + client.
Запуск:
```
✗ go run ./coverme/main.go -port 6029
```
Health check:
```
✗ curl -i -X GET localhost:6029/
HTTP/1.1 200 OK
Content-Type: application/json
Date: Thu, 19 Mar 2020 21:46:02 GMT
Content-Length: 24
"API is up and working!"
```
Создать новое todo:
```
✗ curl -i localhost:6029/todo/create -d '{"title":"A","content":"a"}'
HTTP/1.1 201 Created
Content-Type: application/json
Date: Thu, 19 Mar 2020 21:41:31 GMT
Content-Length: 51
{"id":0,"title":"A","content":"a","finished":false}
```
Получить todo по id:
```
✗ curl -i localhost:6029/todo/0
HTTP/1.1 200 OK
Content-Type: application/json
Date: Thu, 19 Mar 2020 21:44:17 GMT
Content-Length: 51
{"id":0,"title":"A","content":"a","finished":false}
```
Получить все todo:
```
✗ curl -i -X GET localhost:6029/todo
HTTP/1.1 200 OK
Content-Type: application/json
Date: Thu, 19 Mar 2020 21:44:37 GMT
Content-Length: 53
[{"id":0,"title":"A","content":"a","finished":false}]
```