Registry /
devops / esp-idf-nvs-partition-gen
Python tool to generate NVS (Non-Volatile Storage) binary partition images for ESP-IDF projects. Extracts configuration from CSV files and produces binary blobs for flash. Current version 0.2.0, maintenance mode on PyPI, released when ESP-IDF requires updates.
Install & Compatibility
Where this runs
No compatibility data collected yet for this library.
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
import esp_idf_nvs_partition_gen
Generate a binary NVS partition from a CSV. Adjust flash_size and page_size to match your ESP-IDF configuration.
from esp_idf_nvs_partition_gen import NVSGenerator
import csv
import io
# Create a sample CSV in memory
csv_data = """key,type,encoding,value
my_string,namespace,,app
my_key,data,string,hello"""
csv_file = io.StringIO(csv_data)
reader = csv.DictReader(csv_file)
# Generate the NVS partition binary
output_path = "partition.bin"
generator = NVSGenerator(flash_size=0x400000, page_size=0x1000)
generator.add_csv_reader(reader)
generator.generate(output_path)
print(f"Generated NVS partition at {output_path}")
esp-idf-nvs-partition-gen --version
Upgrade
Version history
Breaking-change detection hasn't run for this library yet.
Audit
Security & dependencies
CVE tracking and dependency tree are planned for a later release.