github-dependents-info 3.0.0__tar.gz → 3.2.0__tar.gz

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.
Files changed (7) hide show
  1. {github_dependents_info-3.0.0 → github_dependents_info-3.2.0}/PKG-INFO +46 -41
  2. {github_dependents_info-3.0.0 → github_dependents_info-3.2.0}/README.md +41 -34
  3. {github_dependents_info-3.0.0 → github_dependents_info-3.2.0}/pyproject.toml +22 -12
  4. {github_dependents_info-3.0.0 → github_dependents_info-3.2.0}/LICENSE +0 -0
  5. {github_dependents_info-3.0.0 → github_dependents_info-3.2.0}/github_dependents_info/__init__.py +0 -0
  6. {github_dependents_info-3.0.0 → github_dependents_info-3.2.0}/github_dependents_info/__main__.py +0 -0
  7. {github_dependents_info-3.0.0 → github_dependents_info-3.2.0}/github_dependents_info/gh_dependents_info.py +0 -0
{github_dependents_info-3.0.0 → github_dependents_info-3.2.0}/PKG-INFO RENAMED
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: github-dependents-info
3
- Version: 3.0.0
3
+ Version: 3.2.0
4
4
  Summary: Collect information about dependencies between a github repo and other repositories. Results available in JSON, markdown and badges.
5
5
  License-Expression: MIT
6
6
  License-File: LICENSE
@@ -15,14 +15,12 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
15
15
  Classifier: Programming Language :: Python :: 3
16
16
  Classifier: Programming Language :: Python :: 3.9
17
17
  Requires-Dist: beautifulsoup4 (==4.14.3)
18
- Requires-Dist: click (>=8.3.1,<8.4)
18
+ Requires-Dist: click (>=8.3.3,<8.4)
19
19
  Requires-Dist: httpx (>=0.28.1,<0.29.0)
20
- Requires-Dist: idna (>=3.11)
21
- Requires-Dist: litellm (>=1.60.0,<2.0)
20
+ Requires-Dist: idna (>=3.14)
22
21
  Requires-Dist: pandas (>=2.3.3,<3.0)
23
- Requires-Dist: rich (>=14.2,<14.3)
24
- Requires-Dist: typer-slim (>=0.19,<0.20)
25
- Requires-Dist: typer[standard] (>=0.19,<0.20)
22
+ Requires-Dist: rich (>=15,<15.1)
23
+ Requires-Dist: typer (>=0.25.1,<0.26)
26
24
  Project-URL: Homepage, https://github.com/nvuillam/github-dependents-info
27
25
  Project-URL: Repository, https://github.com/nvuillam/github-dependents-info
28
26
  Description-Content-Type: text/markdown
@@ -39,7 +37,7 @@ Description-Content-Type: text/markdown
39
37
  [![Dependencies Status](https://img.shields.io/badge/dependencies-up%20to%20date-brightgreen.svg)](https://github.com/nvuillam/github-dependents-info/pulls?utf8=%E2%9C%93&q=is%3Apr%20author%3Aapp%2Fdependabot)
40
38
 
41
39
  [![GitHub contributors](https://img.shields.io/github/contributors/nvuillam/github-dependents-info.svg)](https://github.com/nvuillam/github-dependents-info/graphs/contributors/)<!-- gh-dependents-info-used-by-start -->
42
- [![Generated by github-dependents-info](https://img.shields.io/static/v1?label=Used%20by&message=44&color=informational&logo=slickpic)](https://github.com/nvuillam/github-dependents-info/blob/main/docs/github-dependents-info.md)<!-- gh-dependents-info-used-by-end -->
40
+ [![Generated by github-dependents-info](https://img.shields.io/static/v1?label=Used%20by&message=48&color=informational&logo=slickpic)](https://github.com/nvuillam/github-dependents-info/blob/main/docs/github-dependents-info.md)<!-- gh-dependents-info-used-by-end -->
43
41
  [![GitHub Sponsors](https://img.shields.io/github/sponsors/nvuillam)](https://github.com/sponsors/nvuillam)
44
42
  [![MegaLinter](https://github.com/nvuillam/github-dependents-info/actions/workflows/mega-linter.yml/badge.svg)](https://github.com/nvuillam/github-dependents-info/actions/workflows/mega-linter.yml)
45
43
  [![License](https://img.shields.io/github/license/nvuillam/github-dependents-info)](https://github.com/nvuillam/github-dependents-info/blob/master/LICENSE)
@@ -65,31 +63,12 @@ This package uses GitHub HTML to collect dependents information and can:
65
63
  - Optionally add an AI-generated usage summary (via `litellm`) when an LLM API key is present
66
64
  - Update existing markdown by inserting **Used by** badge within tags
67
65
  - `<!-- gh-dependents-info-used-by-start -->
68
- [![Generated by github-dependents-info](https://img.shields.io/static/v1?label=Used%20by&message=22&color=informational&logo=slickpic)](https://github.com/nvuillam/github-dependents-info/blob/main/docs/github-dependents-info.md)<!-- gh-dependents-info-used-by-end -->`
66
+ [![Generated by github-dependents-info](https://img.shields.io/static/v1?label=Used%20by&message=48&color=informational&logo=slickpic)](https://github.com/nvuillam/github-dependents-info/blob/main/docs/github-dependents-info.md)<!-- gh-dependents-info-used-by-end -->`
69
67
  - Handle multiple repositories packages
70
68
  - Filter results using minimum stars or by repository owner
71
69
  - Keep huge ecosystems manageable with pagination controls (`--max-scraped-pages`, `--pagination/--no-pagination`, `--page-size`)
72
70
  - Fetch dependents faster thanks to asynchronous `httpx` requests and parallelized page scraping
73
71
 
74
- ### AI usage summary (optional)
75
-
76
- If an LLM API key is detected in the environment (for example `OPENAI_API_KEY`), the tool will call a lightweight model (via `litellm`) to generate a short **usage summary** and include it in the generated markdown.
77
-
78
- - Supported provider env vars (most common):
79
- - OpenAI: `OPENAI_API_KEY`
80
- - Azure OpenAI: `AZURE_OPENAI_API_KEY`
81
- - Anthropic: `ANTHROPIC_API_KEY`
82
- - Google Gemini: `GEMINI_API_KEY` (or `GOOGLE_API_KEY`)
83
- - Mistral: `MISTRAL_API_KEY`
84
- - Cohere: `COHERE_API_KEY`
85
- - Groq: `GROQ_API_KEY`
86
-
87
- - Disable with `--no-llm-summary` (or env var `GITHUB_DEPENDENTS_INFO_LLM_SUMMARY=false`)
88
- - Override model with `--llm-model` (or env var `GITHUB_DEPENDENTS_INFO_LLM_MODEL` / `LITELLM_MODEL`)
89
- - Adjust max summary length with `--llm-max-words` (or env var `GITHUB_DEPENDENTS_INFO_LLM_MAX_WORDS`)
90
- - The summary is cached in `--csvdirectory` (file `llm_summary_<repo>.json`) and reused on subsequent runs
91
-
92
-
93
72
  Badges example
94
73
 
95
74
  [![](https://img.shields.io/static/v1?label=Used%20by&message=15&color=informational&logo=slickpic)](https://github.com/nvuillam/npm-groovy-lint/network/dependents)
@@ -286,10 +265,11 @@ _________________
286
265
  github-dependents-info [OPTIONS]
287
266
  ```
288
267
 
289
- | Parameter | Type | Description |
290
- |-------------------------------------|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
291
- | --repo | String | Repository. Example: `oxsecurity/megalinter` |
292
- | -b<br/> --badgemarkdownfile | String | _(optional)_ Path to markdown file where to insert/update **Used by** badge <br/> (must contain tags `<!-- gh-dependents-info-used-by-start -->` … `<!-- gh-dependents-info-used-by-end -->`) |
268
+ | Parameter | Type | Description |
269
+ |-----------|--------|----------------------------------------------|
270
+ | --repo | String | Repository. Example: `oxsecurity/megalinter` |
271
+ | -b<br/> --badgemarkdownfile | String | _(optional)_ Path to markdown file where to insert/update **Used by** badge <br/> (must contain tags `<!-- gh-dependents-info-used-by-start -->
272
+ [![Generated by github-dependents-info](https://img.shields.io/static/v1?label=Used%20by&message=48&color=informational&logo=slickpic)](https://github.com/nvuillam/github-dependents-info/blob/main/docs/github-dependents-info.md)<!-- gh-dependents-info-used-by-end -->`) |
293
273
  | -s<br/> --sort | String | _(optional)_ Sort order: name (default) or stars |
294
274
  | -x<br/> --minstars | String | _(optional)_ If set, filters repositories to keep only those with more than X stars |
295
275
  | -m<br/> --markdownfile | String | _(optional)_ Output markdown file file |
@@ -312,8 +292,7 @@ Badge tags example (the tool replaces everything between the markers):
312
292
 
313
293
  ```markdown
314
294
  <!-- gh-dependents-info-used-by-start -->
315
- [![Generated by github-dependents-info](https://img.shields.io/static/v1?label=Used%20by&message=22&color=informational&logo=slickpic)](https://github.com/nvuillam/github-dependents-info/blob/main/docs/github-dependents-info.md)
316
- <!-- gh-dependents-info-used-by-end -->
295
+ [![Generated by github-dependents-info](https://img.shields.io/static/v1?label=Used%20by&message=48&color=informational&logo=slickpic)](https://github.com/nvuillam/github-dependents-info/blob/main/docs/github-dependents-info.md)<!-- gh-dependents-info-used-by-end -->
317
296
  ```
318
297
 
319
298
  _________________
@@ -328,7 +307,7 @@ _________________
328
307
  github-dependents-info --repo nvuillam/npm-groovy-lint --json
329
308
 
330
309
  - Insert/Update **Used by** markdown badge within an existing markdown file containing tags `<!-- gh-dependents-info-used-by-start -->
331
- [![Generated by github-dependents-info](https://img.shields.io/static/v1?label=Used%20by&message=22&color=informational&logo=slickpic)](https://github.com/nvuillam/github-dependents-info/blob/main/docs/github-dependents-info.md)<!-- gh-dependents-info-used-by-end -->`
310
+ [![Generated by github-dependents-info](https://img.shields.io/static/v1?label=Used%20by&message=48&color=informational&logo=slickpic)](https://github.com/nvuillam/github-dependents-info/blob/main/docs/github-dependents-info.md)<!-- gh-dependents-info-used-by-end -->`
332
311
 
333
312
  github-dependents-info --repo nvuillam/npm-groovy-lint --badgemarkdownfile ./README.md
334
313
 
@@ -368,6 +347,28 @@ _________________
368
347
 
369
348
  GEMINI_API_KEY=YOUR_KEY github-dependents-info --repo nvuillam/npm-groovy-lint --markdownfile ./docs/package-usage.md --llm-model gemini-3-flash-preview
370
349
 
350
+
351
+ ## AI usage summary (optional)
352
+
353
+ If an LLM API key is detected in the environment (for example `OPENAI_API_KEY`), the tool will call a lightweight model (via `litellm`) to generate a short **usage summary** and include it in the generated markdown.
354
+
355
+ ![](docs/ai-summary.png)
356
+
357
+ - Supported provider env vars (most common):
358
+ - OpenAI: `OPENAI_API_KEY`
359
+ - Azure OpenAI: `AZURE_OPENAI_API_KEY`
360
+ - Anthropic: `ANTHROPIC_API_KEY`
361
+ - Google Gemini: `GEMINI_API_KEY` (or `GOOGLE_API_KEY`)
362
+ - Mistral: `MISTRAL_API_KEY`
363
+ - Cohere: `COHERE_API_KEY`
364
+ - Groq: `GROQ_API_KEY`
365
+
366
+ - Disable with `--no-llm-summary` (or env var `GITHUB_DEPENDENTS_INFO_LLM_SUMMARY=false`)
367
+ - Override model with `--llm-model` (or env var `GITHUB_DEPENDENTS_INFO_LLM_MODEL` / `LITELLM_MODEL`)
368
+ - Adjust max summary length with `--llm-max-words` (or env var `GITHUB_DEPENDENTS_INFO_LLM_MAX_WORDS`)
369
+ - The summary is cached in `--csvdirectory` (file `llm_summary_<repo>.json`) and reused on subsequent runs
370
+
371
+
371
372
  ## Use as GitHub Action
372
373
 
373
374
  Allow GitHub Actions to create Pull Requests in **Settings > Actions > General**
@@ -379,7 +380,7 @@ Create a file **.github/workflows/github-dependents-info.yml** in your repositor
379
380
  If will generate a new Pull Request (or replace the pending one) every time the usage stats will have changed :)
380
381
 
381
382
  Don't forget to add tags `<!-- gh-dependents-info-used-by-start -->
382
- [![Generated by github-dependents-info](https://img.shields.io/static/v1?label=Used%20by&message=22&color=informational&logo=slickpic)](https://github.com/nvuillam/github-dependents-info/blob/main/docs/github-dependents-info.md)<!-- gh-dependents-info-used-by-end -->` in your **README.md**, at the end of another badge line if you want github-dependents-info to replace its content automatically.
383
+ [![Generated by github-dependents-info](https://img.shields.io/static/v1?label=Used%20by&message=48&color=informational&logo=slickpic)](https://github.com/nvuillam/github-dependents-info/blob/main/docs/github-dependents-info.md)<!-- gh-dependents-info-used-by-end -->` in your **README.md**, at the end of another badge line if you want github-dependents-info to replace its content automatically.
383
384
 
384
385
  ```yaml
385
386
  # GitHub Dependents Info workflow
@@ -413,14 +414,15 @@ jobs:
413
414
  steps:
414
415
  # Git Checkout
415
416
  - name: Checkout Code
416
- uses: actions/checkout@v6
417
+ uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
417
418
  with:
418
419
  token: ${{ secrets.PAT || secrets.GITHUB_TOKEN }}
419
420
  fetch-depth: 0
421
+ persist-credentials: false
420
422
 
421
423
  # Collect data & generate markdown
422
424
  - name: GitHub Dependents Info
423
- uses: nvuillam/github-dependents-info@v1.6.3 # If you want to always have the latest version, you can use nvuillam/github-dependents-info@main :)
425
+ uses: nvuillam/github-dependents-info@fa4a7bc373174a9060ad9935ee32557eef05ea89 # v1.6.3
424
426
  # See documentation for variables details: https://github.com/nvuillam/github-dependents-info?tab=readme-ov-file#%EF%B8%8F-usage
425
427
  with:
426
428
  repo: ${{ github.repository }}
@@ -447,7 +449,7 @@ jobs:
447
449
  # Create pull request
448
450
  - name: Create Pull Request
449
451
  id: cpr
450
- uses: peter-evans/create-pull-request@v8
452
+ uses: peter-evans/create-pull-request@5f6978faf089d4d20b00c7766989d076bb2fc7f1 # v8
451
453
  with:
452
454
  token: ${{ secrets.PAT || secrets.GITHUB_TOKEN }}
453
455
  branch: github-dependents-info-auto-update
@@ -458,8 +460,11 @@ jobs:
458
460
  labels: documentation
459
461
  - name: Create PR output
460
462
  run: |
461
- echo "Pull Request Number - ${{ steps.cpr.outputs.pull-request-number }}"
462
- echo "Pull Request URL - ${{ steps.cpr.outputs.pull-request-url }}"
463
+ echo "Pull Request Number - ${STEPS_CPR_OUTPUTS_PULL_REQUEST_NUMBER}"
464
+ echo "Pull Request URL - ${STEPS_CPR_OUTPUTS_PULL_REQUEST_URL}"
465
+ env:
466
+ STEPS_CPR_OUTPUTS_PULL_REQUEST_NUMBER: ${{ steps.cpr.outputs.pull-request-number }}
467
+ STEPS_CPR_OUTPUTS_PULL_REQUEST_URL: ${{ steps.cpr.outputs.pull-request-url }}
463
468
  ```
464
469
 
465
470
  _________________
{github_dependents_info-3.0.0 → github_dependents_info-3.2.0}/README.md RENAMED
@@ -10,7 +10,7 @@
10
10
  [![Dependencies Status](https://img.shields.io/badge/dependencies-up%20to%20date-brightgreen.svg)](https://github.com/nvuillam/github-dependents-info/pulls?utf8=%E2%9C%93&q=is%3Apr%20author%3Aapp%2Fdependabot)
11
11
 
12
12
  [![GitHub contributors](https://img.shields.io/github/contributors/nvuillam/github-dependents-info.svg)](https://github.com/nvuillam/github-dependents-info/graphs/contributors/)<!-- gh-dependents-info-used-by-start -->
13
- [![Generated by github-dependents-info](https://img.shields.io/static/v1?label=Used%20by&message=44&color=informational&logo=slickpic)](https://github.com/nvuillam/github-dependents-info/blob/main/docs/github-dependents-info.md)<!-- gh-dependents-info-used-by-end -->
13
+ [![Generated by github-dependents-info](https://img.shields.io/static/v1?label=Used%20by&message=48&color=informational&logo=slickpic)](https://github.com/nvuillam/github-dependents-info/blob/main/docs/github-dependents-info.md)<!-- gh-dependents-info-used-by-end -->
14
14
  [![GitHub Sponsors](https://img.shields.io/github/sponsors/nvuillam)](https://github.com/sponsors/nvuillam)
15
15
  [![MegaLinter](https://github.com/nvuillam/github-dependents-info/actions/workflows/mega-linter.yml/badge.svg)](https://github.com/nvuillam/github-dependents-info/actions/workflows/mega-linter.yml)
16
16
  [![License](https://img.shields.io/github/license/nvuillam/github-dependents-info)](https://github.com/nvuillam/github-dependents-info/blob/master/LICENSE)
@@ -36,31 +36,12 @@ This package uses GitHub HTML to collect dependents information and can:
36
36
  - Optionally add an AI-generated usage summary (via `litellm`) when an LLM API key is present
37
37
  - Update existing markdown by inserting **Used by** badge within tags
38
38
  - `<!-- gh-dependents-info-used-by-start -->
39
- [![Generated by github-dependents-info](https://img.shields.io/static/v1?label=Used%20by&message=22&color=informational&logo=slickpic)](https://github.com/nvuillam/github-dependents-info/blob/main/docs/github-dependents-info.md)<!-- gh-dependents-info-used-by-end -->`
39
+ [![Generated by github-dependents-info](https://img.shields.io/static/v1?label=Used%20by&message=48&color=informational&logo=slickpic)](https://github.com/nvuillam/github-dependents-info/blob/main/docs/github-dependents-info.md)<!-- gh-dependents-info-used-by-end -->`
40
40
  - Handle multiple repositories packages
41
41
  - Filter results using minimum stars or by repository owner
42
42
  - Keep huge ecosystems manageable with pagination controls (`--max-scraped-pages`, `--pagination/--no-pagination`, `--page-size`)
43
43
  - Fetch dependents faster thanks to asynchronous `httpx` requests and parallelized page scraping
44
44
 
45
- ### AI usage summary (optional)
46
-
47
- If an LLM API key is detected in the environment (for example `OPENAI_API_KEY`), the tool will call a lightweight model (via `litellm`) to generate a short **usage summary** and include it in the generated markdown.
48
-
49
- - Supported provider env vars (most common):
50
- - OpenAI: `OPENAI_API_KEY`
51
- - Azure OpenAI: `AZURE_OPENAI_API_KEY`
52
- - Anthropic: `ANTHROPIC_API_KEY`
53
- - Google Gemini: `GEMINI_API_KEY` (or `GOOGLE_API_KEY`)
54
- - Mistral: `MISTRAL_API_KEY`
55
- - Cohere: `COHERE_API_KEY`
56
- - Groq: `GROQ_API_KEY`
57
-
58
- - Disable with `--no-llm-summary` (or env var `GITHUB_DEPENDENTS_INFO_LLM_SUMMARY=false`)
59
- - Override model with `--llm-model` (or env var `GITHUB_DEPENDENTS_INFO_LLM_MODEL` / `LITELLM_MODEL`)
60
- - Adjust max summary length with `--llm-max-words` (or env var `GITHUB_DEPENDENTS_INFO_LLM_MAX_WORDS`)
61
- - The summary is cached in `--csvdirectory` (file `llm_summary_<repo>.json`) and reused on subsequent runs
62
-
63
-
64
45
  Badges example
65
46
 
66
47
  [![](https://img.shields.io/static/v1?label=Used%20by&message=15&color=informational&logo=slickpic)](https://github.com/nvuillam/npm-groovy-lint/network/dependents)
@@ -257,10 +238,11 @@ _________________
257
238
  github-dependents-info [OPTIONS]
258
239
  ```
259
240
 
260
- | Parameter | Type | Description |
261
- |-------------------------------------|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
262
- | --repo | String | Repository. Example: `oxsecurity/megalinter` |
263
- | -b<br/> --badgemarkdownfile | String | _(optional)_ Path to markdown file where to insert/update **Used by** badge <br/> (must contain tags `<!-- gh-dependents-info-used-by-start -->` … `<!-- gh-dependents-info-used-by-end -->`) |
241
+ | Parameter | Type | Description |
242
+ |-----------|--------|----------------------------------------------|
243
+ | --repo | String | Repository. Example: `oxsecurity/megalinter` |
244
+ | -b<br/> --badgemarkdownfile | String | _(optional)_ Path to markdown file where to insert/update **Used by** badge <br/> (must contain tags `<!-- gh-dependents-info-used-by-start -->
245
+ [![Generated by github-dependents-info](https://img.shields.io/static/v1?label=Used%20by&message=48&color=informational&logo=slickpic)](https://github.com/nvuillam/github-dependents-info/blob/main/docs/github-dependents-info.md)<!-- gh-dependents-info-used-by-end -->`) |
264
246
  | -s<br/> --sort | String | _(optional)_ Sort order: name (default) or stars |
265
247
  | -x<br/> --minstars | String | _(optional)_ If set, filters repositories to keep only those with more than X stars |
266
248
  | -m<br/> --markdownfile | String | _(optional)_ Output markdown file file |
@@ -283,8 +265,7 @@ Badge tags example (the tool replaces everything between the markers):
283
265
 
284
266
  ```markdown
285
267
  <!-- gh-dependents-info-used-by-start -->
286
- [![Generated by github-dependents-info](https://img.shields.io/static/v1?label=Used%20by&message=22&color=informational&logo=slickpic)](https://github.com/nvuillam/github-dependents-info/blob/main/docs/github-dependents-info.md)
287
- <!-- gh-dependents-info-used-by-end -->
268
+ [![Generated by github-dependents-info](https://img.shields.io/static/v1?label=Used%20by&message=48&color=informational&logo=slickpic)](https://github.com/nvuillam/github-dependents-info/blob/main/docs/github-dependents-info.md)<!-- gh-dependents-info-used-by-end -->
288
269
  ```
289
270
 
290
271
  _________________
@@ -299,7 +280,7 @@ _________________
299
280
  github-dependents-info --repo nvuillam/npm-groovy-lint --json
300
281
 
301
282
  - Insert/Update **Used by** markdown badge within an existing markdown file containing tags `<!-- gh-dependents-info-used-by-start -->
302
- [![Generated by github-dependents-info](https://img.shields.io/static/v1?label=Used%20by&message=22&color=informational&logo=slickpic)](https://github.com/nvuillam/github-dependents-info/blob/main/docs/github-dependents-info.md)<!-- gh-dependents-info-used-by-end -->`
283
+ [![Generated by github-dependents-info](https://img.shields.io/static/v1?label=Used%20by&message=48&color=informational&logo=slickpic)](https://github.com/nvuillam/github-dependents-info/blob/main/docs/github-dependents-info.md)<!-- gh-dependents-info-used-by-end -->`
303
284
 
304
285
  github-dependents-info --repo nvuillam/npm-groovy-lint --badgemarkdownfile ./README.md
305
286
 
@@ -339,6 +320,28 @@ _________________
339
320
 
340
321
  GEMINI_API_KEY=YOUR_KEY github-dependents-info --repo nvuillam/npm-groovy-lint --markdownfile ./docs/package-usage.md --llm-model gemini-3-flash-preview
341
322
 
323
+
324
+ ## AI usage summary (optional)
325
+
326
+ If an LLM API key is detected in the environment (for example `OPENAI_API_KEY`), the tool will call a lightweight model (via `litellm`) to generate a short **usage summary** and include it in the generated markdown.
327
+
328
+ ![](docs/ai-summary.png)
329
+
330
+ - Supported provider env vars (most common):
331
+ - OpenAI: `OPENAI_API_KEY`
332
+ - Azure OpenAI: `AZURE_OPENAI_API_KEY`
333
+ - Anthropic: `ANTHROPIC_API_KEY`
334
+ - Google Gemini: `GEMINI_API_KEY` (or `GOOGLE_API_KEY`)
335
+ - Mistral: `MISTRAL_API_KEY`
336
+ - Cohere: `COHERE_API_KEY`
337
+ - Groq: `GROQ_API_KEY`
338
+
339
+ - Disable with `--no-llm-summary` (or env var `GITHUB_DEPENDENTS_INFO_LLM_SUMMARY=false`)
340
+ - Override model with `--llm-model` (or env var `GITHUB_DEPENDENTS_INFO_LLM_MODEL` / `LITELLM_MODEL`)
341
+ - Adjust max summary length with `--llm-max-words` (or env var `GITHUB_DEPENDENTS_INFO_LLM_MAX_WORDS`)
342
+ - The summary is cached in `--csvdirectory` (file `llm_summary_<repo>.json`) and reused on subsequent runs
343
+
344
+
342
345
  ## Use as GitHub Action
343
346
 
344
347
  Allow GitHub Actions to create Pull Requests in **Settings > Actions > General**
@@ -350,7 +353,7 @@ Create a file **.github/workflows/github-dependents-info.yml** in your repositor
350
353
  If will generate a new Pull Request (or replace the pending one) every time the usage stats will have changed :)
351
354
 
352
355
  Don't forget to add tags `<!-- gh-dependents-info-used-by-start -->
353
- [![Generated by github-dependents-info](https://img.shields.io/static/v1?label=Used%20by&message=22&color=informational&logo=slickpic)](https://github.com/nvuillam/github-dependents-info/blob/main/docs/github-dependents-info.md)<!-- gh-dependents-info-used-by-end -->` in your **README.md**, at the end of another badge line if you want github-dependents-info to replace its content automatically.
356
+ [![Generated by github-dependents-info](https://img.shields.io/static/v1?label=Used%20by&message=48&color=informational&logo=slickpic)](https://github.com/nvuillam/github-dependents-info/blob/main/docs/github-dependents-info.md)<!-- gh-dependents-info-used-by-end -->` in your **README.md**, at the end of another badge line if you want github-dependents-info to replace its content automatically.
354
357
 
355
358
  ```yaml
356
359
  # GitHub Dependents Info workflow
@@ -384,14 +387,15 @@ jobs:
384
387
  steps:
385
388
  # Git Checkout
386
389
  - name: Checkout Code
387
- uses: actions/checkout@v6
390
+ uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
388
391
  with:
389
392
  token: ${{ secrets.PAT || secrets.GITHUB_TOKEN }}
390
393
  fetch-depth: 0
394
+ persist-credentials: false
391
395
 
392
396
  # Collect data & generate markdown
393
397
  - name: GitHub Dependents Info
394
- uses: nvuillam/github-dependents-info@v1.6.3 # If you want to always have the latest version, you can use nvuillam/github-dependents-info@main :)
398
+ uses: nvuillam/github-dependents-info@fa4a7bc373174a9060ad9935ee32557eef05ea89 # v1.6.3
395
399
  # See documentation for variables details: https://github.com/nvuillam/github-dependents-info?tab=readme-ov-file#%EF%B8%8F-usage
396
400
  with:
397
401
  repo: ${{ github.repository }}
@@ -418,7 +422,7 @@ jobs:
418
422
  # Create pull request
419
423
  - name: Create Pull Request
420
424
  id: cpr
421
- uses: peter-evans/create-pull-request@v8
425
+ uses: peter-evans/create-pull-request@5f6978faf089d4d20b00c7766989d076bb2fc7f1 # v8
422
426
  with:
423
427
  token: ${{ secrets.PAT || secrets.GITHUB_TOKEN }}
424
428
  branch: github-dependents-info-auto-update
@@ -429,8 +433,11 @@ jobs:
429
433
  labels: documentation
430
434
  - name: Create PR output
431
435
  run: |
432
- echo "Pull Request Number - ${{ steps.cpr.outputs.pull-request-number }}"
433
- echo "Pull Request URL - ${{ steps.cpr.outputs.pull-request-url }}"
436
+ echo "Pull Request Number - ${STEPS_CPR_OUTPUTS_PULL_REQUEST_NUMBER}"
437
+ echo "Pull Request URL - ${STEPS_CPR_OUTPUTS_PULL_REQUEST_URL}"
438
+ env:
439
+ STEPS_CPR_OUTPUTS_PULL_REQUEST_NUMBER: ${{ steps.cpr.outputs.pull-request-number }}
440
+ STEPS_CPR_OUTPUTS_PULL_REQUEST_URL: ${{ steps.cpr.outputs.pull-request-url }}
434
441
  ```
435
442
 
436
443
  _________________
{github_dependents_info-3.0.0 → github_dependents_info-3.2.0}/pyproject.toml RENAMED
@@ -5,7 +5,7 @@ build-backend = "poetry.core.masonry.api"
5
5
 
6
6
  [project]
7
7
  name = "github-dependents-info"
8
- version = "3.0.0"
8
+ version = "3.2.0"
9
9
  description = "Collect information about dependencies between a github repo and other repositories. Results available in JSON, markdown and badges."
10
10
  readme = "README.md"
11
11
  license = "MIT"
@@ -39,22 +39,20 @@ Repository = "https://github.com/nvuillam/github-dependents-info"
39
39
  [tool.poetry.dependencies]
40
40
  python = ">=3.10,<4.0"
41
41
 
42
- click = ">=8.3.1,<8.4"
43
- typer = {extras = ["standard"], version = ">=0.19,<0.20"}
44
- typer-slim = ">=0.19,<0.20"
45
- rich = ">=14.2,<14.3"
42
+ click = ">=8.3.3,<8.4"
43
+ typer = ">=0.25.1,<0.26"
44
+ rich = ">=15,<15.1"
46
45
  beautifulsoup4 = "4.14.3"
47
46
  pandas = ">=2.3.3,<3.0"
48
47
  httpx = "^0.28.1"
49
- idna = ">=3.11"
50
- litellm = ">=1.60.0,<2.0"
48
+ idna = ">=3.14"
51
49
 
52
50
  [tool.poetry.group.dev.dependencies]
53
51
  bandit = "^1.7.5"
54
- black = "^25.0.0"
52
+ black = ">=26.3.1"
55
53
  darglint = "^1.8.1"
56
- isort = {extras = ["colors"], version = "^7.0.0"}
57
- mypy = "^1.8"
54
+ isort = {extras = ["colors"], version = "^8.0.0"}
55
+ mypy = "^2.0"
58
56
  mypy-extensions = "^1.0.0"
59
57
  pre-commit = "^4.0.0"
60
58
  pydocstyle = "^6.3.0"
@@ -64,10 +62,22 @@ pyupgrade = "^3.4.0"
64
62
  safety = "^3.7.0"
65
63
  coverage = "^7.3.4"
66
64
  coverage-badge = "^1.1.0"
67
- cryptography = ">=44.0.1"
65
+ cryptography = ">=48.0.0"
68
66
  pytest-html = "^4.1.1"
69
67
  pytest-cov = "^7.0.0"
70
- marshmallow = ">=4.1,<4.2"
68
+ marshmallow = ">=4.3,<4.4"
69
+ authlib = ">=1.7.0"
70
+ requests = ">=2.34.2"
71
+ urllib3 = ">=2.6.3"
72
+ filelock = ">=3.20.4"
73
+ virtualenv = ">=21.3.0"
74
+ nltk = ">=3.9.4"
75
+
76
+
77
+ [[tool.poetry.source]]
78
+ name = "safety"
79
+ url = "https://pkgs.safetycli.com/repository/opensource/project/github-dependents-info/pypi/simple/"
80
+ priority = "primary"
71
81
 
72
82
  [tool.black]
73
83
  # https://github.com/psf/black