Register Guidelines E-Books Search Today's Posts Mark Forums Read

Go Back   MobileRead Forums > E-Book Software > Calibre > Development

Notices

Reply
 
Thread Tools Search this Thread
Old 07-03-2011, 06:34 AM   #1
chaley
"chaley", not "charley"
chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.
 
Posts: 5,258
Karma: 821512
Join Date: Jan 2010
Location: France
Device: Many android devices
Some API changes in the current release (0.8.8) and the next one

API changes in 0.8.8
  • The API for gui2.tag_browser changed in 0.8.8. The file gui2.tag_browser.py no longer exists, having been split into 4 files found in gui2.tag_browser.*.py. Functions like searching and boxing tag items are in ui.py. Other functions have moved around to model.py or view.py.
  • The API for starting EditAuthorsDialog changed in 0.8.8. It requires an additional argument "select_link", which if true will cause the new author_link column to be selected for the id also passed in. This new argument has been added to gui2.tag_browser.ui.do_author_sort_edit(), defaulting to false.
Not API changes but worth noting:
  • the authors table now contains a column for storing a URL associated with that author. This link is set/modified using Manage Authors. The URL is used in book details. If an author has no URL, then the URL template set in preferences -> book details is used. A new template function, swap_around_comma(), has been provided to facilitate turning LN, FN names into FN LN for use in this (and other) templates. This function would be used when the library is LN, FN but the resulting URL must use FN LN order. Swap_around_comma is a convenience function, equivalent to calling re('^(.*?),(.*$)', '\2 \1').
  • Composite columns now have a "show as HTML in book details" check box. The intent is to indicate that the composite column should be rendered as HTML in situations where it is appropriate, such as book details or in the content server.
API change in 0.8.9:
  • database2.format_metadata() now caches during a given calibre session the data returned by os.stat(). If a format is changed outside of calibre, then the cache will be incorrect, containing stale data. For example, calibre won't know the file has changed if you use open_with and sigil to change it, so format_metadata can return stale data.

    The cache is not persistent. It is rebuilt every time calibre starts, which limits the lifetime of the stale data. Also, you can force format_metadata() to refresh the cache for a book by using a new additional argument "allow_cache".
  • New template functions: The metadata for formats will be available in templates via two new template functions, formats_modtimes() and formats_sizes(). You can use these to create composite columns showing the information, or in coloring rules, or what-have-you. In addition, two template functions are provided for formatting numeric information: human_readable() and format_number(). Finally, a new function has_cover() returns whether or not a book has a cover associated with it.
chaley is offline   Reply With Quote
Old 07-04-2011, 11:21 AM   #2
jackie_w
Wizard
jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.
 
Posts: 2,733
Karma: 3973167
Join Date: Sep 2009
Location: UK
Device: Sony PRS-350, PB360, Kobo Glo/AuraHD/Aura6"
Re: the API change in 0.8.9,

I hope this is not too dumb a question... I use various utilities in the 'Open With' plugin to tweak an epub's non-metadata items, e.g. toc.ncx, .xpgt, .css, <manifest> section of opf. Will I still be OK to continue as now?
jackie_w is online now   Reply With Quote
Old 07-04-2011, 12:02 PM   #3
chaley
"chaley", not "charley"
chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.
 
Posts: 5,258
Karma: 821512
Join Date: Jan 2010
Location: France
Device: Many android devices
The cached modification time and size will not be updated unless you call format_metadata with 'allow_cache=False'. Open_with can't do this because the plugin doesn't know when the user has finished. If you do, then fine. If you don't or if you do nothng, then the worst that will happen is that the cached values are wrong until the next time calibre is restarted.

Do remember, though, that when the new DB implementation hits (http://www.mobileread.com/forums/sho...d.php?t=140056), it is possible that there won't be any formats stored locally. Either your plugin(s) will stop working, or you must use the API to get a copy, let the user do whatever, then put it back.
chaley is offline   Reply With Quote
Old 07-04-2011, 05:09 PM   #4
jackie_w
Wizard
jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.
 
Posts: 2,733
Karma: 3973167
Join Date: Sep 2009
Location: UK
Device: Sony PRS-350, PB360, Kobo Glo/AuraHD/Aura6"
Quote:
Originally Posted by chaley View Post
Do remember, though, that when the new DB implementation hits, it is possible that there won't be any formats stored locally. Either your plugin(s) will stop working, or you must use the API to get a copy, let the user do whatever, then put it back.
If the formats aren't local, where will they be?

Currently, I don't necessarily need Calibre to make my utilities work ('Open With' is a convenience) but I do need a physical epub to edit.

Edit: I should add, these are personal utilities not released to the Calibre community.

Last edited by jackie_w; 07-04-2011 at 05:18 PM.
jackie_w is online now   Reply With Quote
Old 07-04-2011, 05:13 PM   #5
chaley
"chaley", not "charley"
chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.
 
Posts: 5,258
Karma: 821512
Join Date: Jan 2010
Location: France
Device: Many android devices
Flying with the seagulls in the clouds.

One major goal of Kovid's work (perhaps *the* major goal) is to permit calibre's database not to be on a disc on the LAN. If he is successful (and it appears he will be), then there is no guarantee that *any* files in the library are available locally. No cover, no formats, no folders for authors/tities, no metadata.db, etc.

Of course, most people will have their library on local storage. Problem is that you can't count on that.
chaley is offline   Reply With Quote
Old 07-04-2011, 05:51 PM   #6
jackie_w
Wizard
jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.jackie_w ought to be getting tired of karma fortunes by now.
 
Posts: 2,733
Karma: 3973167
Join Date: Sep 2009
Location: UK
Device: Sony PRS-350, PB360, Kobo Glo/AuraHD/Aura6"
Quote:
Originally Posted by chaley View Post
Of course, most people will have their library on local storage. Problem is that you can't count on that.
But for personal needs I can count on local storage for as long as I want it, yes?
jackie_w is online now   Reply With Quote
Old 07-04-2011, 05:54 PM   #7
chaley
"chaley", not "charley"
chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.
 
Posts: 5,258
Karma: 821512
Join Date: Jan 2010
Location: France
Device: Many android devices
Quote:
Originally Posted by jackie_w View Post
But for personal needs I can count on local storage for as long as I want it, yes?
Yes. There is no way that Kovid would make it impossible to store a library on a local disk.
chaley is offline   Reply With Quote
Old 07-04-2011, 06:41 PM   #8
kovidgoyal
creator of calibre
kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.
 
kovidgoyal's Avatar
 
Posts: 25,782
Karma: 4998511
Join Date: Oct 2006
Location: Mumbai, India
Device: Various
Quote:
Originally Posted by chaley View Post
Yes. There is no way that Kovid would make it impossible to store a library on a local disk.
Absolutely, a networked backend (I am not yet reconciled to the term cloud) will be an additional feature, not a replacement.

In fact the development will proceed in two stages. The first will be to write a much better designed (and faster) replacement for the current calibre database backend, that will be a drop in replacement (i.e. calibre should continue to work exactly as it does now, only faster). This new backend will be modularised in a way that will hopefully make it easy to add support for networked storage.
kovidgoyal is offline   Reply With Quote
Old 07-04-2011, 09:59 PM   #9
Dopedangel
Wizard
Dopedangel ought to be getting tired of karma fortunes by now.Dopedangel ought to be getting tired of karma fortunes by now.Dopedangel ought to be getting tired of karma fortunes by now.Dopedangel ought to be getting tired of karma fortunes by now.Dopedangel ought to be getting tired of karma fortunes by now.Dopedangel ought to be getting tired of karma fortunes by now.Dopedangel ought to be getting tired of karma fortunes by now.Dopedangel ought to be getting tired of karma fortunes by now.Dopedangel ought to be getting tired of karma fortunes by now.Dopedangel ought to be getting tired of karma fortunes by now.Dopedangel ought to be getting tired of karma fortunes by now.
 
Dopedangel's Avatar
 
Posts: 1,090
Karma: 8499999
Join Date: Dec 2006
Location: Singapore
Device: Coolreader(Nexus 5)\Coolreader(Nook Touch)
Are these changes going to allow multiple instances of calibre using the database at the same time.
Dopedangel is offline   Reply With Quote
Old 07-04-2011, 10:30 PM   #10
kovidgoyal
creator of calibre
kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.
 
kovidgoyal's Avatar
 
Posts: 25,782
Karma: 4998511
Join Date: Oct 2006
Location: Mumbai, India
Device: Various
yes .
kovidgoyal is offline   Reply With Quote
Old 07-05-2011, 12:02 PM   #11
Starson17
Wizard
Starson17 can program the VCR without an owner's manual.Starson17 can program the VCR without an owner's manual.Starson17 can program the VCR without an owner's manual.Starson17 can program the VCR without an owner's manual.Starson17 can program the VCR without an owner's manual.Starson17 can program the VCR without an owner's manual.Starson17 can program the VCR without an owner's manual.Starson17 can program the VCR without an owner's manual.Starson17 can program the VCR without an owner's manual.Starson17 can program the VCR without an owner's manual.Starson17 can program the VCR without an owner's manual.
 
Posts: 4,004
Karma: 177841
Join Date: Dec 2009
Device: WinMo: IPAQ; Android: HTC HD2, Archos 7o; Java:Gravity T
Quote:
Originally Posted by kovidgoyal View Post
yes .
Am I correct in thinking we'll also get (or be able to add) the option to change metadata from the content server interface? Perhaps also even permit running a format conversion from the CS? (I hate it when I'm remote, connected to the CS and realize I need another format, then have to log in with VNC to run Calibre, then return to the CS to get the newly converted book.)
Starson17 is offline   Reply With Quote
Old 07-05-2011, 01:04 PM   #12
kovidgoyal
creator of calibre
kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.
 
kovidgoyal's Avatar
 
Posts: 25,782
Karma: 4998511
Join Date: Oct 2006
Location: Mumbai, India
Device: Various
Eventually, yes.
kovidgoyal is offline   Reply With Quote
Old 07-05-2011, 01:27 PM   #13
Starson17
Wizard
Starson17 can program the VCR without an owner's manual.Starson17 can program the VCR without an owner's manual.Starson17 can program the VCR without an owner's manual.Starson17 can program the VCR without an owner's manual.Starson17 can program the VCR without an owner's manual.Starson17 can program the VCR without an owner's manual.Starson17 can program the VCR without an owner's manual.Starson17 can program the VCR without an owner's manual.Starson17 can program the VCR without an owner's manual.Starson17 can program the VCR without an owner's manual.Starson17 can program the VCR without an owner's manual.
 
Posts: 4,004
Karma: 177841
Join Date: Dec 2009
Device: WinMo: IPAQ; Android: HTC HD2, Archos 7o; Java:Gravity T
Quote:
Originally Posted by kovidgoyal View Post
Eventually, yes.
I understand why the "Eventually" is there.

Still, it's nice to know it's on the roadmap.
Starson17 is offline   Reply With Quote
Reply

Thread Tools Search this Thread
Search this Thread:

Advanced Search

Forum Jump

Similar Threads
Thread Thread Starter Forum Replies Last Post
calibre's new plugin API kovidgoyal Plugins 26 05-07-2011 02:43 PM
New metadata API in 0.8 questions kiwidude Development 38 04-18-2011 10:42 AM
Goodreads has published an API EricLandes Calibre 6 01-12-2011 04:39 PM
Lead time for Kindle book release ahead of print release date - experiences? Buran Amazon Kindle 6 05-04-2009 02:29 PM
Ubook plugin api Dopedangel Reading and Management 0 08-25-2007 06:54 AM


All times are GMT -4. The time now is 10:34 AM.


MobileRead.com is a privately owned, operated and funded community.