Lightweight static analysis for many languages. Find bug variants with patterns that look like source code.
Project description
Code scanning at ludicrous speed.
Find bugs and reachable dependency vulnerabilities in code.
Enforce your code standards on every commit.
Semgrep is a fast, open-source, static analysis engine for finding bugs, detecting vulnerabilities in third-party dependencies, and enforcing code standards. Get started →.
Semgrep analyzes code locally on your computer or in your build environment: code is never uploaded.
Its rules look like the code you already write; no abstract syntax trees, regex wrestling, or painful DSLs. Here's a quick rule for finding Python print() statements. Run it online in Semgrep’s Playground by clicking the image:
The Semgrep ecosystem includes:
- Semgrep - The open-source command line tool at the heart of everything (this project).
- Semgrep Supply Chain - high-signal dependency scanner that detects reachable vulnerabilities in third-party libraries and functions across the SDLC.
- Semgrep App - Deploy, manage, and monitor Semgrep and Semgrep Supply Chain at scale with free and paid tiers. Integrates with CI providers such as GitHub, GitLab, CircleCI, and more.
and:
- Semgrep Playground - An online interactive tool for writing and sharing rules.
- Semgrep Registry - 2,000+ community-driven rules covering security, correctness, and dependency vulnerabilities.
Join hundreds of thousands of other developers and security engineers already using Semgrep at companies like GitLab, Dropbox, Slack, Figma, Shopify, HashiCorp, Snowflake, and Trail of Bits.
Semgrep is developed and commercially supported by r2c, a software security company.
Language support
General availability
C# · Go · Java · JavaScript · JSX · JSON · PHP · Python · Ruby · Scala · TypeScript · TSX
Beta & experimental
See 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 semgrep
Once installed, Semgrep can run with single rules or entire rulesets. Visit Docs > 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
# Fetch rules automatically by setting the `--config auto` flag.
# This will fetch rules relevant to your project from Semgrep Registry.
# Your source code is not uploaded.
$ semgrep --config auto
To run Semgrep Supply Chain, contact the Semgrep team. Visit the full documentation to learn more.
Rule examples
Visit Docs > 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 |
| Tainted data flowing into sinks | ExpressJS dataflow into sandbox.run |
| 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 |
Extensions
Visit Docs > Extensions to learn about using Semgrep in your editor or pre-commit. When integrated into CI and configured to scan pull requests, Semgrep will only report issues introduced by that pull request; this lets you start using Semgrep without fixing or ignoring pre-existing issues!
Documentation
Browse the full Semgrep documentation on the website. If you’re new to Semgrep, check out Docs > Getting started or the interactive tutorial.
Metrics
Using remote configuration from the Registry (like --config=p/ci) reports pseudonymous rule metrics to semgrep.dev.
Using configs from local files (like --config=xyz.yml) does not enable metrics.
To disable Registry rule metrics, use --metrics=off.
The Semgrep privacy policy describes the principles that guide data-collection decisions and the breakdown of the data that are and are not collected when the metrics are enabled.
More
- Frequently asked questions (FAQs)
- Contributing
- Build instructions for developers
- Ask questions in the r2c Community Slack
- CLI reference and exit codes
- Semgrep YouTube channel
- License (LGPL-2.1)
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-1.8.0.tar.gz.
File metadata
- Download URL: semgrep-1.8.0.tar.gz
- Upload date:
- Size: 223.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.9.16
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 2fdb9f4e585313d0ef9b7e18f0117c6fafe3f5b932d460ed434dabf71f2fdec3 |
|
| MD5 | 0d920166551953129f1d8db3e7d8b005 |
|
| BLAKE2b-256 | e80119545ddda759ac5490b06824be79cc94ba77a16ead929171b99d0a246bad |
File details
Details for the file semgrep-1.8.0-cp37.cp38.cp39.py37.py38.py39-none-macosx_11_0_arm64.whl.
File metadata
- Download URL: semgrep-1.8.0-cp37.cp38.cp39.py37.py38.py39-none-macosx_11_0_arm64.whl
- Upload date:
- Size: 27.0 MB
- Tags: CPython 3.7, CPython 3.8, CPython 3.9, Python 3.7, Python 3.8, Python 3.9, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.9.16
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | ccdd43491c19d9f40ddfafa9a69d6e02f4ec763f0f99e0de88c9355acbec2727 |
|
| MD5 | d6e8ca3d838f7420c502707987429f9a |
|
| BLAKE2b-256 | 64481ffa75020e3ceafadb72e015ed495e862825f56b67d4972fe19cb8030918 |
File details
Details for the file semgrep-1.8.0-cp37.cp38.cp39.py37.py38.py39-none-macosx_10_14_x86_64.whl.
File metadata
- Download URL: semgrep-1.8.0-cp37.cp38.cp39.py37.py38.py39-none-macosx_10_14_x86_64.whl
- Upload date:
- Size: 23.5 MB
- Tags: CPython 3.7, CPython 3.8, CPython 3.9, Python 3.7, Python 3.8, Python 3.9, macOS 10.14+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.9.16
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | e9144026caac1b23d509a5da7ccb0ee4945b88a725f885eb0ac38c158a773b6f |
|
| MD5 | 5a67948f3ad472c20af946dfdaf065b3 |
|
| BLAKE2b-256 | 4f15b6e2e9262e15f991b334aa134398a2983ed0f891309ab76d760e7ece2ec4 |
File details
Details for the file semgrep-1.8.0-cp37.cp38.cp39.py37.py38.py39-none-any.whl.
File metadata
- Download URL: semgrep-1.8.0-cp37.cp38.cp39.py37.py38.py39-none-any.whl
- Upload date:
- Size: 26.8 MB
- Tags: CPython 3.7, CPython 3.8, CPython 3.9, Python 3.7, Python 3.8, Python 3.9
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.9.16
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 85c8dd8ba82eb218ee19253a84d0b23e73138c918e2c7256e803bf3f63e969f5 |
|
| MD5 | 6235989636d127d1cabb39489c1943b8 |
|
| BLAKE2b-256 | 607d556f325667dc1b61b7b71039d1e76ea4210dccb4127ac204a537e606de06 |
