lazy_api_doc 0.1.6 → 0.2.2
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/Gemfile.lock +1 -1
- data/README.md +22 -3
- data/docs/example/api.yml +1355 -0
- data/docs/example/index.html +24 -0
- data/docs/example/layout.yml +14 -0
- data/lib/generators/lazy_api_doc/install_generator.rb +42 -14
- data/lib/lazy_api_doc/generator.rb +22 -15
- data/lib/lazy_api_doc/route_parser.rb +6 -6
- data/lib/lazy_api_doc/variants_parser.rb +2 -2
- data/lib/lazy_api_doc/version.rb +1 -1
- data/lib/lazy_api_doc.rb +92 -51
- data/screenshot.png +0 -0
- metadata +6 -2
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 0f0e518996dd248ab2ae4db3fff35867c58ef74810786fa49f7de71218cb45bf
|
|
4
|
+
data.tar.gz: 3885d2a3adbc40da030de0647ab19f5afb0b8d5268f7076988e65f300b2b75a6
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: dc95af1ff9d2fa9f593e8198d6b7909e1ae6d9ab364ceee1e33cad60687eac8b4543a9385e700bd3ba5858236f087f94830b863c6d0e9999ffd8065ae510296d
|
|
7
|
+
data.tar.gz: 442a7d980e4b867eaa7f880452058ff9f95754a76c42e3704b59e75d07fd06bf68bf2809c7ed879704ad87120391c24d8d0dd766af0584601e8fb0615737c724
|
data/Gemfile.lock
CHANGED
data/README.md
CHANGED
|
@@ -1,10 +1,13 @@
|
|
|
1
1
|
# LazyApiDoc
|
|
2
2
|
|
|
3
|
-
A library to generate OpenAPI V3 documentation from tests.
|
|
3
|
+
A library to generate OpenAPI V3 documentation from tests. Try out the results
|
|
4
|
+
[here](https://bguban.github.io/lazy_api_doc/example).
|
|
4
5
|
|
|
5
6
|
LazyApiDoc collects requests and responses from your controller and request specs, retrieves data types, optional
|
|
6
7
|
attributes, endpoint description and then generates OpenAPI documentation.
|
|
7
8
|
|
|
9
|
+
|
|
10
|
+
|
|
8
11
|
## Installation
|
|
9
12
|
|
|
10
13
|
Add this line to your application's Gemfile:
|
|
@@ -25,6 +28,22 @@ Then run install task
|
|
|
25
28
|
|
|
26
29
|
$ rails g lazy_api_doc:install
|
|
27
30
|
|
|
31
|
+
## Configuration
|
|
32
|
+
|
|
33
|
+
You can customize LazyApiDoc behavior using config file or environment variables.
|
|
34
|
+
|
|
35
|
+
```yaml
|
|
36
|
+
# config/lazy_api_doc.yml
|
|
37
|
+
|
|
38
|
+
# base directory for storing layout files and generated documentation
|
|
39
|
+
path: 'doc/lazy_api_doc' # ENV['LAZY_API_DOC_PATH'] default: 'public/lazy_api_doc'
|
|
40
|
+
|
|
41
|
+
# TTL for files generated by running tests in different processes (ParallelTest). Each process generates a file.
|
|
42
|
+
# After all the processes are done one of them collects all example files and generates the documentation. In case
|
|
43
|
+
# when the example files were not deleted before running the tests, old files will be ignored.
|
|
44
|
+
example_file_ttl: 1800 # ENV['LAZY_API_DOC_EXAMPLE_FILE_TTL'] default: 1800 (30 minutes)
|
|
45
|
+
```
|
|
46
|
+
|
|
28
47
|
## Usage
|
|
29
48
|
|
|
30
49
|
Update files `public/lazy_api_doc/index.html` and `public/lazy_api_doc/layout.yml`. These files will be
|
|
@@ -33,11 +52,11 @@ so on.
|
|
|
33
52
|
|
|
34
53
|
And just run your tests with `DOC=true` environment variable:
|
|
35
54
|
|
|
36
|
-
$
|
|
55
|
+
$ LAZY_API_DOC=true rspec
|
|
37
56
|
|
|
38
57
|
or
|
|
39
58
|
|
|
40
|
-
#
|
|
59
|
+
# LAZY_API_DOC=true rake test
|
|
41
60
|
|
|
42
61
|
The documentation will be placed `public/lazy_api_doc/api.yml`. To see it just run server
|
|
43
62
|
|