I'll upgrade to v1.11 and pull this PR to replace my own partition code and see if it works. I'll post the results here in a few days...

AttributeError: 'Partition' object has no attribute 'metadata'

part.info() is working!

>>> part.info()
(0, 16, 65536, 2621440, 'test', False)

0?
Searching... Found it:
`#define PART_TYPE_APP 0x00
#define PART_SUBTYPE_FACTORY 0x00
#define PART_SUBTYPE_OTA_FLAG 0x10
#define PART_SUBTYPE_OTA_MASK 0x0f
#define PART_SUBTYPE_TEST 0x20

#define PART_TYPE_DATA 0x01
#define PART_SUBTYPE_DATA_OTA 0x00
#define PART_SUBTYPE_DATA_RF 0x01
#define PART_SUBTYPE_DATA_WIFI 0x02
#define PART_SUBTYPE_DATA_NVS_KEYS 0x04
#define PART_SUBTYPE_DATA_EFUSE_EM 0x05

#define PART_TYPE_END 0xff
#define PART_SUBTYPE_END 0xff
`
16 is the subtype, in decimal, so it's 0x10 in hex meaning it has an OTA_FLAG which is correct!

65535 is the offset, correct. 2621440 is the size of the partition, correct again.

So far, it's working.

But how to get a list of all partitions?

AttributeError: 'Partition' object has no attribute 'metadata'

part.info() is working!

Yes, sorry, I updated the API without updating the comment (which is now updated).

But how to get a list of all partitions?

I'm don't think #3576 had a way to list all partitions, so that's which I didn't implement it. I thought that the user would anyway know all partitions (eg by name) so could use Partition(FIRST, ...) to retrieve them all.

But if listing all partitions is necessary there's an API in the IDF which could be exposed, eg to get an iterator which iterates over the partitions, like:

for part in Partition.ifind(type=..., subtype=..., label=...):
    print(part)

ifind() would be a static method of Partition and would replace the Partition(FIRST, ...) constructor.

I just pushed a commit to add Partition.find(...) which returns a list of all partitions of the given type/subtype/label. (Making it an iterator was not easy because there would be a memory leak, not releasing the IDF internal iterator.)

To use:

app_parts = Partition.find(Partition.TYPE_APP)
data_parts = Partition.find(Partition.TYPE_DATA)
nvs_parts = Partition.find(Partition.TYPE_DATA, label='nvs')

@dpgeorge: I have also reworked the flashdbev.py file so that it's using the newly created Partition class and the flashdrive is mounted on a named Partition that can be put anywhere:

**
import esp
from esp32 import Partition

class FlashBdev:

SEC_SIZE = 4096

def __init__(self, blocks, offset=None):
    self.blocks = blocks
    if not offset:
        self.START_SEC = esp.flash_user_start() // self.SEC_SIZE
    else:
        self.START_SEC = offset // self.SEC_SIZE

def readblocks(self, n, buf):
    #print("readblocks(%s, %x(%d))" % (n, id(buf), len(buf)))
    esp.flash_read((n + self.START_SEC) * self.SEC_SIZE, buf)

def writeblocks(self, n, buf):
    #print("writeblocks(%s, %x(%d))" % (n, id(buf), len(buf)))
    #assert len(buf) <= self.SEC_SIZE, len(buf)
    esp.flash_erase(n + self.START_SEC)
    esp.flash_write((n + self.START_SEC) * self.SEC_SIZE, buf)

def ioctl(self, op, arg):
    #print("ioctl(%d, %r)" % (op, arg))
    if op == 4:  # BP_IOCTL_SEC_COUNT
        return self.blocks
    if op == 5:  # BP_IOCTL_SEC_SIZE
        return self.SEC_SIZE

size = esp.flash_size()
vfspart = Partition(Partition.FIRST, type=Partition.TYPE_DATA, label='fatvfs').info()
if size < 1024*1024:
# flash too small for a filesystem
bdev = None
elif vfspart:
# if we have a partition for the filesystem, use it
bdev = FlashBdev(vfspart[3] // FlashBdev.SEC_SIZE, vfspart[2])
#print("FAT filesystem found on partition '{}'".format(vfspart[4].strip()))
else:
# for now we use a fixed size for the filesystem
bdev = FlashBdev(2048 * 1024 // FlashBdev.SEC_SIZE)
**

Using this, PR #4987 isn't really necessary anymore.

Thanks @Lisa999 for testing. I agree it'd be good to replace the existing flashbdev code to use this new Partition class.

I've just pushed some small changes to the Partition constructor to simplify it now that the Partition.find(...) static method exists. To construct a Partition you now either pass in a label, or a constant, like so:

from esp32 import Partition
bootpart = Partition(Partition.BOOT)
runningpart = Partition(Partition.RUNNING)
fatfs = Partition('fatfs')

For any more complex Partition lookup use Partition.find(type, subtype, label)

I'm happy to merge this PR as it is now, then proceed to update flashbdev.py and partitions.csv in a separate PR.

Ok, this was merged in 05eb897, with docs added, and also writeblocks modified to erase before write, so the Partition class acts like a proper block device.

See #5027 for follow up.

How were the OTA-related methods tested, e.g. esp32_partition_set_boot? As far as I know they require an ota_boot partition and none of the provided partition tables includes one, so I wonder...

How were the OTA-related methods tested,

I did not test set_boot() or get_next_update() methods.

How were the OTA-related methods tested,

I did not test set_boot() or get_next_update() methods.

I did test 'set_boot()' and it's working just fine in my project...

For me it is not working: #5471

Partition table and partitions look good but calling set_boot() gives me the error ESP_ERR_INVALID_ARG.

EDIT: Working now =) I used ota_1 as first ota partition slot instead of ota_0 =/