Lightweight static analysis for many languages. Find bug variants with patterns that look like source code.
Project description
Lightweight static analysis for many languages.
Find bugs and enforce code standards.
Semgrep is a fast, open-source, static analysis tool that excels at expressing code standards — without complicated queries — and surfacing bugs early at editor, commit, and CI time. Precise rules look like the code you’re searching; no more traversing abstract syntax trees or wrestling with regexes.
The Semgrep Registry has 900+ rules written by the Semgrep community covering security, correctness, and performance bugs. No need to DIY unless you want to.
Semgrep runs offline, on uncompiled code.
Language support
General availability
Go · Java · JavaScript · JSON · Python
Beta
Ruby · TypeScript · JSX · TSX
Visit Supported languages for the complete list.
Getting started
To install Semgrep use Homebrew or pip, or run without installation via Docker:
# For macOS
$ brew install semgrep
# For Ubuntu/WSL/Linux/macOS
$ python3 -m pip install semgrep
# To try Semgrep without installation run via Docker
$ docker run --rm -v "${PWD}:/src" returntocorp/semgrep --help
Once installed, Semgrep can run with single rules or entire rulesets. Visit Running rules to learn more or try the following:
# Check for Python == where the left and right hand sides are the same (often a bug)
$ semgrep -e '$X == $X' --lang=py path/to/src
# Run the r2c-ci ruleset (with rules for many languages) on your own code!
$ semgrep --config=p/r2c-ci path/to/src
Visit Getting started to learn more.
Rule examples
Visit Rule examples for use cases and ideas.
| Use case | Semgrep rule |
|---|---|
| Ban dangerous APIs | Prevent use of exec |
| Search routes and authentication | Extract Spring routes |
| Enforce the use secure defaults | Securely set Flask cookies |
| Enforce project best-practices | Use assertEqual for == checks, Always check subprocess calls |
| Codify project-specific knowledge | Verify transactions before making them |
| Audit security hotspots | Finding XSS in Apache Airflow, Hardcoded credentials |
| Audit configuration files | Find S3 ARN uses |
| Migrate from deprecated APIs | DES is deprecated, Deprecated Flask APIs, Deprecated Bokeh APIs |
| Apply automatic fixes | Use listenAndServeTLS |
Integrations
Visit Integrations to learn about Semgrep editor, commit, and CI integrations.
FAQ
Visit FAQ to learn more. Semgrep is supported by r2c.
Contributing
Visit Contributing or join the r2c Community Slack to learn more. Semgrep is LGPL-2.1 licensed.
Usage
Visit CLI Usage for usage and exit code documentation.
Upgrading
To upgrade, run the command below associated with how you installed Semgrep:
# Using Homebrew
$ brew upgrade semgrep
# Using pip
$ python3 -m pip install --upgrade semgrep
# Using Docker
$ docker pull returntocorp/semgrep:latest
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
File details
Details for the file semgrep-0.30.0.tar.gz.
File metadata
- Download URL: semgrep-0.30.0.tar.gz
- Upload date:
- Size: 68.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.24.0 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.8.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | e6921a41b9a08c1c7c66622c5893dd3865ac1fdc05ed4e60b0b5c58d9aa6b8e9 |
|
| MD5 | 12a2a8d00e4eeb3ed82cc58c348a91a4 |
|
| BLAKE2b-256 | 163048a6edb229c1e23e96844a2b74e4266e36c69aa095ddc7ab63eea4d73da4 |
File details
Details for the file semgrep-0.30.0-cp36.cp37.cp38.py36.py37.py38-none-macosx_10_14_x86_64.whl.
File metadata
- Download URL: semgrep-0.30.0-cp36.cp37.cp38.py36.py37.py38-none-macosx_10_14_x86_64.whl
- Upload date:
- Size: 46.9 MB
- Tags: CPython 3.6, CPython 3.7, CPython 3.8, Python 3.6, Python 3.7, Python 3.8, macOS 10.14+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.24.0 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.8.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 35ec1a2485c3a9d470ee6e7e71e97c121125283dd14a38163d27da69def09307 |
|
| MD5 | e33bf96a824ee01dc76d05d22e4d02a5 |
|
| BLAKE2b-256 | e8f89ab651c937f78ded4b372e917db46d2d78aac33e4941d0fe22bb530da88b |
File details
Details for the file semgrep-0.30.0-cp36.cp37.cp38.py36.py37.py38-none-any.whl.
File metadata
- Download URL: semgrep-0.30.0-cp36.cp37.cp38.py36.py37.py38-none-any.whl
- Upload date:
- Size: 95.1 MB
- Tags: CPython 3.6, CPython 3.7, CPython 3.8, Python 3.6, Python 3.7, Python 3.8
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.24.0 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.8.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | c3af3debb735d002933153d03265370422cd6676bb6d85f660d8625096550b55 |
|
| MD5 | 3ea90b7cf4ffa75f00539657732717fc |
|
| BLAKE2b-256 | 3e9c9e95ea56651d7f1df493201c7312c19caaf7883c493393ab36412aa56bd0 |
