naturtag.storage.setup module

Setup functions for creating and updating the SQLite database

naturtag.storage.setup.setup(db_path=PosixPath('/home/docs/.local/share/Naturtag/naturtag.db'), overwrite=False, download=False)

Run any first-time setup steps, if needed: * Create database tables * Extract packaged taxonomy data and load into SQLite

Note: taxonomy data is included with PyInstaller packages and platform-specific installers, but not with plain python package on PyPI (to keep package size small). Use download=True to fetch the missing data.

Parameters:
  • db_path (Path) – SQLite database path

  • overwrite (bool) – Overwrite an existing taxon database, if it already exists

  • download (bool) – Download taxon data (full text search + basic taxon details)

Return type:

AppState