1
- # MODERNIZATION OF UI RENEWAL is in PROGRESS https://github.com/rakutentech/laravel-request-docs/pull/103
2
- We request to have code freeze on new pull requests, and request to please submit issues with regards to the UI that we can cover in the new UI renewal.
3
-
4
1
<p align =" center " >
5
2
<a href =" https://github.com/rakutentech/laravel-request-docs " >
6
- <img alt="Laravel Request Docs" src="https://imgur.com/9eDTUaI .png" width="360 ">
3
+ <img alt="Laravel Request Docs" src="https://imgur.com/2NvLKn2 .png">
7
4
</a >
8
5
</p >
9
6
@@ -23,13 +20,18 @@ We request to have code freeze on new pull requests, and request to please submi
23
20
24
21
## Features
25
22
23
+ - Light and Dark mode
24
+ - Automatic rules fetching from injected Request and by regexp
26
25
- Automatic routes fetching from Laravel Routes
27
- - Automatic rules fetching from injected Request
26
+ - Support for Laravel logs
27
+ - Support for SQL query and query time
28
+ - Support for HTTP response time and memory consumption
28
29
- Support for Authorization Headers
29
- - Support for SQL query, response time and memory consumption by request on Laravel
30
- - Intelligent auto request builder using `` faker.js ``
31
30
- Display extra documentation using markdown
31
+ - Uses localstorage to save history of previous requests
32
+ - Added filters to sort, group and filter routes by methods, controllers, middlewares, routes (also see Roadmap 2.x)
32
33
- Export laravel API, routes, rules and documentation to Postman and OpenAPI 3.0.0
34
+
33
35
# Read on Medium
34
36
35
37
Automatically generate api documentation for Laravel without writing annotations.
@@ -64,18 +66,6 @@ php artisan vendor:publish --tag=request-docs-config
64
66
65
67
View in the browser on `` /request-docs/ ``
66
68
67
- Generate a static HTML and open api specification
68
-
69
- ``` php
70
- php artisan lrd:generate
71
- ```
72
-
73
- Docs HTML is generated inside `` docs/ `` .
74
-
75
- ## Just want Open API
76
-
77
- View in the browser on `` /request-docs/?openapi=true ``
78
-
79
69
# Design pattern
80
70
81
71
In order for this plugin to work, you need to follow the design pattern by injecting the request class inside the controller.
@@ -85,25 +75,31 @@ For extra documentation you can use markdown inside your controller method as we
85
75
86
76
# Screenshots
87
77
88
- ** Generated API documentation**
78
+ ** Light and Dark Modes**
79
+
80
+ Light mode
81
+ ![ Preview] ( https://imgur.com/2s1SrKm.png )
89
82
90
- ![ Preview] ( https://imgur.com/8DvBBhs.png )
83
+ Dark mode
84
+ ![ Preview] ( https://imgur.com/76sk7Lq.png )
91
85
92
86
** Try API**
93
87
94
- ![ Preview] ( https://imgur.com/kcKVSzm.png )
88
+ Uses localstorage to save history of previous requests and request headers
89
+
90
+ ![ Preview] ( https://imgur.com/q3d7pw2.png )
95
91
96
92
** SQL query profile**
97
93
98
- ![ Preview] ( https://imgur.com/y8jT3jj .png )
94
+ ![ Preview] ( https://imgur.com/8PLLlHv .png )
99
95
100
96
** Response profile**
101
97
102
- ![ Preview] ( https://imgur.com/U0Je956 .png )
98
+ ![ Preview] ( https://imgur.com/fd09jw1 .png )
103
99
104
- ** Customize Headers **
100
+ ** Settings to sort, group and filter **
105
101
106
- ![ Preview] ( https://imgur.com/5ydtRd8 .png )
102
+ ![ Preview] ( https://imgur.com/qHq1pjr .png )
107
103
108
104
109
105
# Extra
@@ -114,29 +110,22 @@ Example of using it in controller
114
110
``` php
115
111
/**
116
112
* @lrd:start
117
- * # Hello markdown
118
- * ## Documentation for /my route
113
+ * Hello markdown
114
+ * ## Free text to write documentation in markdown
119
115
* @lrd:end
120
116
*/
121
117
public function index(MyIndexRequest $request): Resource
122
118
{
123
119
```
124
120
125
- # Custom Params
126
-
127
- You write extra params with rules with @QAparam comment line
121
+ # Params not in rules
128
122
129
- ``` php
130
- /**
131
- * @QAparam search string
132
- */
133
- public function index(MyIndexRequest $request): Resource
134
- {
135
- ```
123
+ You write extra params with rules with @LRDparam in comment line as one line
136
124
137
125
``` php
138
126
/**
139
- * @QAparam search string nullable max:32
127
+ * @LRDparam username string|max:32
128
+ * @LRDparam nickaname string|nullable|max:32
140
129
*/
141
130
public function index(MyIndexRequest $request): Resource
142
131
{
@@ -161,6 +150,12 @@ Fixing lints
161
150
./vendor/bin/php-cs-fixer fix config/
162
151
```
163
152
153
+ # Roadmap for v2.x
154
+
155
+ - [ DONE] UI renewal
156
+ - [ WIP] Introduce groupby controller names, routes, middlewares
157
+ - [ WIP] Introduce fetch rules from PHP doc annotations
158
+
164
159
# Changelog
165
160
166
161
- Initial Release
@@ -179,5 +174,5 @@ Fixing lints
179
174
- v1.22 Boolean|File|Image support
180
175
- v1.23 Bug fix for lrd doc block #76
181
176
- v1.27 A few fixes on width and added request_methods
182
- - v1.30 Minor search box filter added
177
+ - v2.0 UI Renewal to React static
183
178
0 commit comments