codesummary 1.0.1 → 1.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +92 -46
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -31,11 +31,13 @@ npm install -g codesummary
|
|
|
31
31
|
## 🎯 Quick Start
|
|
32
32
|
|
|
33
33
|
1. **First-time setup** (interactive wizard):
|
|
34
|
+
|
|
34
35
|
```bash
|
|
35
36
|
codesummary
|
|
36
37
|
```
|
|
37
38
|
|
|
38
39
|
2. **Generate PDF for current project**:
|
|
40
|
+
|
|
39
41
|
```bash
|
|
40
42
|
cd /path/to/your/project
|
|
41
43
|
codesummary
|
|
@@ -140,39 +142,76 @@ CodeSummary stores global configuration in:
|
|
|
140
142
|
|
|
141
143
|
```json
|
|
142
144
|
{
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
145
|
+
"output": {
|
|
146
|
+
"mode": "fixed",
|
|
147
|
+
"fixedPath": "~/Desktop/CodeSummaries"
|
|
146
148
|
},
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
149
|
+
"allowedExtensions": [
|
|
150
|
+
".json",
|
|
151
|
+
".ts",
|
|
152
|
+
".js",
|
|
153
|
+
".jsx",
|
|
154
|
+
".tsx",
|
|
155
|
+
".xml",
|
|
156
|
+
".html",
|
|
157
|
+
".css",
|
|
158
|
+
".scss",
|
|
159
|
+
".md",
|
|
160
|
+
".txt",
|
|
161
|
+
".py",
|
|
162
|
+
".java",
|
|
163
|
+
".cs",
|
|
164
|
+
".cpp",
|
|
165
|
+
".c",
|
|
166
|
+
".h",
|
|
167
|
+
".yaml",
|
|
168
|
+
".yml",
|
|
169
|
+
".sh",
|
|
170
|
+
".bat",
|
|
171
|
+
".ps1",
|
|
172
|
+
".php",
|
|
173
|
+
".rb",
|
|
174
|
+
".go",
|
|
175
|
+
".rs",
|
|
176
|
+
".swift",
|
|
177
|
+
".kt",
|
|
178
|
+
".scala",
|
|
179
|
+
".vue",
|
|
180
|
+
".svelte",
|
|
181
|
+
".dockerfile",
|
|
182
|
+
".sql",
|
|
183
|
+
".graphql"
|
|
153
184
|
],
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
185
|
+
"excludeDirs": [
|
|
186
|
+
"node_modules",
|
|
187
|
+
".git",
|
|
188
|
+
".vscode",
|
|
189
|
+
"dist",
|
|
190
|
+
"build",
|
|
191
|
+
"coverage",
|
|
192
|
+
"out",
|
|
193
|
+
"__pycache__",
|
|
194
|
+
".next",
|
|
195
|
+
".nuxt"
|
|
157
196
|
],
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
197
|
+
"styles": {
|
|
198
|
+
"colors": {
|
|
199
|
+
"title": "#333353",
|
|
200
|
+
"section": "#00FFB9",
|
|
201
|
+
"text": "#333333",
|
|
202
|
+
"error": "#FF4D4D",
|
|
203
|
+
"footer": "#666666"
|
|
165
204
|
},
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
205
|
+
"layout": {
|
|
206
|
+
"marginLeft": 40,
|
|
207
|
+
"marginTop": 40,
|
|
208
|
+
"marginRight": 40,
|
|
209
|
+
"footerHeight": 20
|
|
171
210
|
}
|
|
172
211
|
},
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
212
|
+
"settings": {
|
|
213
|
+
"documentTitle": "Project Code Summary",
|
|
214
|
+
"maxFilesBeforePrompt": 500
|
|
176
215
|
}
|
|
177
216
|
}
|
|
178
217
|
```
|
|
@@ -182,16 +221,19 @@ CodeSummary stores global configuration in:
|
|
|
182
221
|
Generated PDFs use **A4 format** with optimized margins and contain three main sections:
|
|
183
222
|
|
|
184
223
|
### 1. Project Overview
|
|
224
|
+
|
|
185
225
|
- Document title and project name
|
|
186
226
|
- Generation timestamp
|
|
187
227
|
- List of included file types with descriptions
|
|
188
228
|
|
|
189
229
|
### 2. File Structure
|
|
230
|
+
|
|
190
231
|
- Complete hierarchical listing of all included files
|
|
191
232
|
- Organized by relative paths from project root
|
|
192
233
|
- Sorted alphabetically for easy navigation
|
|
193
234
|
|
|
194
235
|
### 3. File Content
|
|
236
|
+
|
|
195
237
|
- **Complete source code** for each file (no truncation)
|
|
196
238
|
- Proper formatting with monospace fonts for code
|
|
197
239
|
- Intelligent text wrapping without overlap
|
|
@@ -229,24 +271,24 @@ MYPROJECT_code_20250729_141602.pdf
|
|
|
229
271
|
|
|
230
272
|
CodeSummary supports an extensive range of text-based file formats:
|
|
231
273
|
|
|
232
|
-
| Extension | Language/Type | Extension | Language/Type
|
|
233
|
-
| --------- | -------------- | ------------ |
|
|
234
|
-
| `.js` | JavaScript | `.py` | Python
|
|
235
|
-
| `.ts` | TypeScript | `.java` | Java
|
|
236
|
-
| `.jsx` | React JSX | `.cs` | C#
|
|
237
|
-
| `.tsx` | TypeScript JSX | `.cpp` | C++
|
|
238
|
-
| `.json` | JSON | `.c` | C
|
|
239
|
-
| `.xml` | XML | `.h` | Header
|
|
240
|
-
| `.html` | HTML | `.yaml/.yml` | YAML
|
|
241
|
-
| `.css` | CSS | `.sh` | Shell Script
|
|
242
|
-
| `.scss` | SCSS | `.bat` | Batch File
|
|
243
|
-
| `.md` | Markdown | `.ps1` | PowerShell
|
|
244
|
-
| `.txt` | Plain Text | `.php` | PHP
|
|
245
|
-
| `.go` | Go | `.rb` | Ruby
|
|
246
|
-
| `.rs` | Rust | `.swift` | Swift
|
|
247
|
-
| `.kt` | Kotlin | `.scala` | Scala
|
|
248
|
-
| `.vue` | Vue.js | `.svelte` | Svelte
|
|
249
|
-
| `.sql` | SQL | `.graphql` | GraphQL
|
|
274
|
+
| Extension | Language/Type | Extension | Language/Type |
|
|
275
|
+
| --------- | -------------- | ------------ | ------------- |
|
|
276
|
+
| `.js` | JavaScript | `.py` | Python |
|
|
277
|
+
| `.ts` | TypeScript | `.java` | Java |
|
|
278
|
+
| `.jsx` | React JSX | `.cs` | C# |
|
|
279
|
+
| `.tsx` | TypeScript JSX | `.cpp` | C++ |
|
|
280
|
+
| `.json` | JSON | `.c` | C |
|
|
281
|
+
| `.xml` | XML | `.h` | Header |
|
|
282
|
+
| `.html` | HTML | `.yaml/.yml` | YAML |
|
|
283
|
+
| `.css` | CSS | `.sh` | Shell Script |
|
|
284
|
+
| `.scss` | SCSS | `.bat` | Batch File |
|
|
285
|
+
| `.md` | Markdown | `.ps1` | PowerShell |
|
|
286
|
+
| `.txt` | Plain Text | `.php` | PHP |
|
|
287
|
+
| `.go` | Go | `.rb` | Ruby |
|
|
288
|
+
| `.rs` | Rust | `.swift` | Swift |
|
|
289
|
+
| `.kt` | Kotlin | `.scala` | Scala |
|
|
290
|
+
| `.vue` | Vue.js | `.svelte` | Svelte |
|
|
291
|
+
| `.sql` | SQL | `.graphql` | GraphQL |
|
|
250
292
|
|
|
251
293
|
## 🛠️ Development
|
|
252
294
|
|
|
@@ -289,20 +331,24 @@ node bin/codesummary.js
|
|
|
289
331
|
### Common Issues
|
|
290
332
|
|
|
291
333
|
**Configuration not found**
|
|
334
|
+
|
|
292
335
|
- Run `codesummary` to trigger first-time setup
|
|
293
336
|
- Check file permissions in config directory
|
|
294
337
|
|
|
295
338
|
**PDF generation fails**
|
|
339
|
+
|
|
296
340
|
- Verify output directory permissions
|
|
297
341
|
- Ensure Node.js version ≥18.0.0
|
|
298
342
|
- Close any open PDF viewers on the target file
|
|
299
343
|
|
|
300
344
|
**Files not showing up**
|
|
345
|
+
|
|
301
346
|
- Check that file extensions are in `allowedExtensions`
|
|
302
347
|
- Verify directories aren't in `excludeDirs` list
|
|
303
348
|
- Ensure files are text-based (not binary)
|
|
304
349
|
|
|
305
350
|
**Large project performance**
|
|
351
|
+
|
|
306
352
|
- Adjust `maxFilesBeforePrompt` in configuration
|
|
307
353
|
- Use extension filtering to reduce file count
|
|
308
354
|
- CodeSummary handles large files efficiently with streaming
|
|
@@ -367,4 +413,4 @@ This project is licensed under the GNU General Public License v3.0 - see the [LI
|
|
|
367
413
|
|
|
368
414
|
---
|
|
369
415
|
|
|
370
|
-
**Made with ❤️ for developers worldwide**
|
|
416
|
+
**Made with ❤️ for developers worldwide**
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "codesummary",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.2",
|
|
4
4
|
"description": "Cross-platform CLI tool that automatically generates comprehensive PDF documentation from project source code with complete content processing and smart conflict handling",
|
|
5
5
|
"main": "src/index.js",
|
|
6
6
|
"type": "module",
|