# harsh1t-josh1/shn-sqlmap architecture

> Architecture diagram of the GitHub repository harsh1t-josh1/shn-sqlmap, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/harsh1t-josh1/shn-sqlmap
- Repository: https://github.com/harsh1t-josh1/shn-sqlmap

## Overview

sqlmap is a command-line penetration-testing tool that probes web targets for SQL injection, then supports database fingerprinting, data retrieval, filesystem access, and operating-system command execution. The principal workflow runs from user options through target checks and request/injection handling to database-specific enumeration or takeover capabilities. The graph preserves these documented branches, plus core state and API entry points. Edges are limited to README statements and relationships visible in the supplied excerpts or source index; unsampled implementation details are not inferred.

Main entry points: [`lib/controller/controller.py`](https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/lib/controller/controller.py) (Scan controller), [`sqlmap.py`](https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/sqlmap.py) (CLI entry), [`lib/request/inject.py`](https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/lib/request/inject.py) (Injection engine), [`lib/techniques/blind/inference.py`](https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/lib/techniques/blind/inference.py) (Blind inference)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and control"]
  node_cli["CLI entry<br/>[sqlmap.py]"]
  node_options["Option parsing<br/>[cmdline.py]"]
  node_controller["Scan controller<br/>[controller.py]"]
  node_checks["Target checks<br/>[checks.py]"]
  node_actions["Scan actions<br/>[action.py]"]
  node_api["HTTP API<br/>[sqlmapapi.py]"]
end

subgraph group_probe["Target probing"]
  node_http["HTTP transport<br/>[connect.py]"]
  node_injection["Injection engine<br/>[inject.py]"]
  node_payloads["SQL payloads<br/>[agent.py]"]
  node_blind["Blind inference<br/>[inference.py]"]
  node_graphql["GraphQL scanning<br/>[inject.py]"]
  node_nosql["NoSQL scanning<br/>[inject.py]"]
end

subgraph group_database["Database operations"]
  node_dbhandler["DBMS dispatch<br/>[handler.py]"]
  node_dbplugins["DBMS plugins"]
  node_enumeration["Database enumeration<br/>[enumeration.py]"]
  node_database_data["Database retrieval<br/>[databases.py]"]
  node_takeover["Server takeover"]
end

subgraph group_runtime["Runtime support"]
  node_state[("Shared state<br/>[data.py]")]
  node_session["Session persistence<br/>[session.py]"]
end

node_user(("Operator"))

node_user -->|"runs"| node_cli
node_cli -->|"parses options"| node_options
node_cli -->|"starts scan"| node_controller
node_controller -->|"runs checks"| node_checks
node_controller -->|"dispatches actions"| node_actions
node_controller -->|"dispatches scan"| node_graphql
node_controller -->|"dispatches scan"| node_nosql
node_injection -->|"uses payload logic"| node_payloads
node_blind -->|"sends probes"| node_http
node_database_data -->|"queries through"| node_injection
node_dbhandler -->|"loads plugins"| node_dbplugins

click node_cli "https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/sqlmap.py"
click node_options "https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/lib/parse/cmdline.py"
click node_controller "https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/lib/controller/controller.py"
click node_checks "https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/lib/controller/checks.py"
click node_actions "https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/lib/controller/action.py"
click node_http "https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/lib/request/connect.py"
click node_injection "https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/lib/request/inject.py"
click node_payloads "https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/lib/core/agent.py"
click node_blind "https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/lib/techniques/blind/inference.py"
click node_graphql "https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/lib/techniques/graphql/inject.py"
click node_nosql "https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/lib/techniques/nosql/inject.py"
click node_dbhandler "https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/lib/controller/handler.py"
click node_dbplugins "https://github.com/harsh1t-josh1/shn-sqlmap/tree/master/plugins/dbms"
click node_enumeration "https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/plugins/generic/enumeration.py"
click node_database_data "https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/plugins/generic/databases.py"
click node_takeover "https://github.com/harsh1t-josh1/shn-sqlmap/tree/master/lib/takeover"
click node_state "https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/lib/core/data.py"
click node_session "https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/lib/core/session.py"
click node_api "https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/sqlmapapi.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_options,node_controller,node_checks,node_actions,node_api toneBlue
class node_http,node_injection,node_payloads,node_blind,node_graphql,node_nosql toneAmber
class node_dbhandler,node_dbplugins,node_enumeration,node_database_data,node_takeover toneMint
class node_state,node_session toneRose
class node_user toneIndigo
```

## Components

### Entry and control

- [CLI entry](https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/sqlmap.py): `sqlmap.py`
- [Option parsing](https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/lib/parse/cmdline.py): `lib/parse/cmdline.py`
- [Scan controller](https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/lib/controller/controller.py): `lib/controller/controller.py`
- [Target checks](https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/lib/controller/checks.py): `lib/controller/checks.py`
- [Scan actions](https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/lib/controller/action.py): `lib/controller/action.py`
- [HTTP API](https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/sqlmapapi.py): `sqlmapapi.py`

### Target probing

- [HTTP transport](https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/lib/request/connect.py): `lib/request/connect.py`
- [Injection engine](https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/lib/request/inject.py): `lib/request/inject.py`
- [SQL payloads](https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/lib/core/agent.py): `lib/core/agent.py`
- [Blind inference](https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/lib/techniques/blind/inference.py): `lib/techniques/blind/inference.py`
- [GraphQL scanning](https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/lib/techniques/graphql/inject.py): `lib/techniques/graphql/inject.py`
- [NoSQL scanning](https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/lib/techniques/nosql/inject.py): `lib/techniques/nosql/inject.py`

### Database operations

- [DBMS dispatch](https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/lib/controller/handler.py): `lib/controller/handler.py`
- [DBMS plugins](https://github.com/harsh1t-josh1/shn-sqlmap/tree/master/plugins/dbms): `plugins/dbms`
- [Database enumeration](https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/plugins/generic/enumeration.py): `plugins/generic/enumeration.py`
- [Database retrieval](https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/plugins/generic/databases.py): `plugins/generic/databases.py`
- [Server takeover](https://github.com/harsh1t-josh1/shn-sqlmap/tree/master/lib/takeover): `lib/takeover`

### Runtime support

- [Shared state](https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/lib/core/data.py): `lib/core/data.py`
- [Session persistence](https://github.com/harsh1t-josh1/shn-sqlmap/blob/master/lib/core/session.py): `lib/core/session.py`

### Other components

- **Operator**

## Connections

- Operator → CLI entry: runs
- CLI entry → Option parsing: parses options (evidence: `sqlmap.py`)
- CLI entry → Scan controller: starts scan (evidence: `sqlmap.py`)
- Scan controller → Target checks: runs checks (evidence: `lib/controller/controller.py`)
- Scan controller → Scan actions: dispatches actions (evidence: `lib/controller/controller.py`)
- Scan controller → GraphQL scanning: dispatches scan (evidence: `lib/controller/controller.py`)
- Scan controller → NoSQL scanning: dispatches scan (evidence: `lib/controller/controller.py`)
- Injection engine → SQL payloads: uses payload logic (evidence: `lib/request/inject.py`)
- Blind inference → HTTP transport: sends probes (evidence: `lib/techniques/blind/inference.py`)
- Database retrieval → Injection engine: queries through (evidence: `plugins/generic/databases.py`)
- DBMS dispatch → DBMS plugins: loads plugins (evidence: `lib/controller/handler.py`)
