Skip to content

Add documentation for script analysis - #3139

Open
saniyafatima07 wants to merge 4 commits into
mandiant:feature/script-analysisfrom
saniyafatima07:script-docs
Open

Add documentation for script analysis#3139
saniyafatima07 wants to merge 4 commits into
mandiant:feature/script-analysisfrom
saniyafatima07:script-docs

Conversation

@saniyafatima07

@saniyafatima07 saniyafatima07 commented Aug 7, 2026

Copy link
Copy Markdown
Collaborator

Closes: #3148
References: #3102 #3121

Checklist

  • No CHANGELOG update needed
  • No new tests needed
  • Documentation added.
  • No, this submission does not include AI-generated code.

@saniyafatima07
saniyafatima07 marked this pull request as draft August 7, 2026 19:56
@saniyafatima07
saniyafatima07 changed the base branch from master to feature/script-analysis August 11, 2026 19:23
@saniyafatima07
saniyafatima07 marked this pull request as ready for review August 11, 2026 19:24
Comment thread doc/script-analysis.md
Comment on lines +9 to +14
| Language | File Extension(s) | Description |
|------------- |-------------------- |--------------------------------------------|
| Python | `.py` | Python scripts |
| C# | `.cs` | C# source files |
| HTML / ASPX | `.html`, `.aspx` | HTML templates with embedded server-side code |
| Bash | `.sh` | Bash shell scripts |

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is less about documentation and more about implementation. Does capa also accept the defanged variants of these extensions (e.g. .py_). If not, it should, we don't want to force users to use valid file extensions just for capa, especially for malware samples that they don't want to execute. This is low priority right now, so if this needs to be added, please create a new issue to track it.

@saniyafatima07 saniyafatima07 Aug 13, 2026

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@mike-hunhoff Could you suggest a few things that I should add to the documentation?
Also, yes, capa accepts the defanged variants of these extensions.

mike-hunhoff and others added 3 commits August 14, 2026 15:37
Adds static analysis for script files (C#, Python, ASPX, HTML embedded scripts)
using Tree-Sitter feature extractors.

Revives and completes work originally introduced in mandiant#1080.

Co-authored-by: Edoardo Allegrini <allegrini.1969146@studenti.uniroma1.it>
Co-authored-by: Adam Storek <adamstorek@users.noreply.github.com>
@mike-hunhoff
mike-hunhoff force-pushed the feature/script-analysis branch from 091b508 to 3a94b33 Compare August 14, 2026 15:38
@mike-hunhoff
mike-hunhoff force-pushed the feature/script-analysis branch 2 times, most recently from 10165af to bffd0f3 Compare August 18, 2026 14:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants