adding azw3 annotation support to kindle driver

[rszasz]

The azw3's annotation sidecar seems fairly straight forward to deal with, so I'm going to make an attempt to extend the kindle driver's annotation fetching support.

The .han file is just a plaintext JSON container so I'll post the contents of one below. Hopefully the location numbers can just be used with the existing code and don't need conversion.


{"payload":{"key":"c848d0d0-af95-4ffb-8dfd-c505c468ab0b","type":"EBOK","records":[{"endPosition":"42844","startPosition":"42616","la stModificationTime":"2017-07-31 06:21:29.413","type":"kindle.highlight"},{"text":" test","endPosition":"42948","startPosition":"42942 ","lastModificationTime":"2017-07-31 06:21:29.413","type":"kindle.note"},{"lastModifica tionTime":"2017-07-31 06:21:29.413","type":"kindle.lpr","location":"4246 1"}],"guid":"Around_the_World_in_Eighty_Days:34B1AEF9" ,"acr":"Around_the_World_in_Eighty_Days:34B1AEF9"} ,"md5":"7c6c54fd763a1581def4750bc85bf2d3"}

[kovidgoyal]

IIRC the kindle driver just has two or three simple functions that deal with annotations. Should be easy to modify. Look in kindle/driver.py

[rszasz]

Thanks

The driver portion was fairly simple just needed to add the han format to a few places. I'm not totally clear what DELETE_EXTS is for, but I assume its files not to transfer, so I added .han to that as well.

bookmark.py is where I'm currently stalled as I don't know how the location/position number is generated or how to calculate the percentage complete using it.

I can get location numbers on the kindle itself, and then the data stored on in the .han file. Calculating and testing the Magic Constant should be fairly straightforward, I just need to figure out how to find the length of the azw3 in either kindle display location or the .han location formats

[kovidgoyal]

DELETE_EXTS is a list of additional extensions to try to delete when deleting a book from the device.