from fast_ebook import epub
import fast_ebook

book = epub.read_epub('book.epub')

# Metadata
print(book.get_metadata('DC', 'title'))
print(book.get_metadata('DC', 'creator'))

# Iterate items
for item in book.get_items():
    print(item.get_id(), item.get_name(), item.get_type())

# Filter by type
for img in book.get_items_of_type(fast_ebook.ITEM_IMAGE):
    print(img.get_name(), len(img.get_content()), 'bytes')

# Lookup by ID or href
item = book.get_item_with_id('chapter1')
item = book.get_item_with_href('text/chapter1.xhtml')

# Table of contents
for entry in book.toc:
    print(entry.title, entry.href)

from fast_ebook import epub

book = epub.EpubBook()
book.set_identifier('id123')
book.set_title('My Book')
book.set_language('en')
book.add_author('Author Name')

c1 = epub.EpubHtml(title='Intro', file_name='chap_01.xhtml', lang='en')
c1.content = '<h1>Hello</h1><p>World</p>'

book.add_item(c1)
book.add_item(epub.EpubNcx())
book.add_item(epub.EpubNav())

book.toc = [epub.Link('chap_01.xhtml', 'Introduction', 'intro')]
book.spine = ['nav', c1]

epub.write_epub('output.epub', book)

import io
from fast_ebook import epub

# Read from bytes
with open('book.epub', 'rb') as f:
    book = epub.read_epub(f)

# Write to BytesIO
buf = io.BytesIO()
epub.write_epub(buf, book)
epub_bytes = buf.getvalue()

# Read from raw bytes
book = epub.read_epub(epub_bytes)

from fast_ebook import epub

with epub.open('book.epub') as book:
    print(book.get_metadata('DC', 'title'))

from pathlib import Path
from fast_ebook import epub

paths = list(Path('library/').glob('*.epub'))
books = epub.read_epubs(paths, workers=4)

for book in books:
    title = book.get_metadata('DC', 'title')[0][0]
    print(title)

from fast_ebook import epub

book = epub.read_epub('book.epub')
issues = book.validate()
if issues:
    for issue in issues:
        print(f"  - {issue}")
else:
    print("Valid EPUB")

from fast_ebook import epub

book = epub.read_epub('book.epub')
md = book.to_markdown()

# Write to file
with open('book.md', 'w') as f:
    f.write(md)

from fast_ebook import epub

# Skip NCX parsing (EPUB2 table of contents)
book = epub.read_epub('book.epub', options={'ignore_ncx': True})

# Skip Nav document parsing (EPUB3 table of contents)
book = epub.read_epub('book.epub', options={'ignore_nav': True})

# Before (ebooklib)
from ebooklib import epub
import ebooklib
book = epub.read_epub('book.epub')
for img in book.get_items_of_type(ebooklib.ITEM_IMAGE):
    ...

# After (fast-ebook)
from fast_ebook import epub
import fast_ebook
book = epub.read_epub('book.epub')
for img in book.get_items_of_type(fast_ebook.ITEM_IMAGE):
    ...

# Minimal change
import fast_ebook.compat as ebooklib
from fast_ebook.compat import epub
# ... rest of your code works unchanged