Wip 0.4.3

[dpieski]

Description

Implements get_IFW (#100) — a new method that retrieves the full Image File Wrapper
and bulk-downloads all prosecution history documents (PDF preferred, DOCX fallback) into
either a ZIP archive or a flat directory. Returns a new IFWResult dataclass with the
PatentFileWrapper, the output path, and a downloaded_documents mapping of
document_identifier → filename so each downloaded file can be linked back to its
Document in the bag.

Also includes several related improvements made during development:

• get_IFW_metadata now auto-populates document_bag on the returned wrapper ([FEAT] get_IFW_metadata should also populate the Doc list #99)
• classification_q values containing spaces or slashes are now auto-quoted for the
  Lucene query, fixing searches for CPC codes like H10D 64/667 ([Bug]: classification_q requires manual quoting for CPC codes containing a slash #101)
• Example showing how to search by CPC code and iterate cpc_classification_bag ([DOCS] Example how to search CPC codes #102)

Type of Change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update
• Code refactoring

Testing

• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes
• I have tested this manually (if applicable)

Checklist

• My code follows the project's style guidelines
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• Any dependent changes have been merged and published

Related Issues

Closes #100
Closes #99
Closes #101
Closes #102

Additional Notes

get_IFW supports two output modes controlled by as_zip: bool = True:

• as_zip=True (default): all documents packaged into {app_no}_ifw.zip
• as_zip=False: documents downloaded into {app_no}_ifw/ directory

Documents with no PDF/DOCX download URL (e.g. NPL references) are silently skipped.
A warning is issued only if a document has a URL but the download itself fails.