Update PostgreSQLEnhanced to v1.7.3

[glamberson]

Update PostgreSQLEnhanced to v1.7.3

Summary

Major update to PostgreSQLEnhanced addon with dual backend registration, ConfigManager integration, and Gramps 6.0.6 API compatibility.

Key Changes

Dual Backend Registration

• PostgreSQL Enhanced (Monolithic) - All trees in shared database with table prefixes (recommended)
• PostgreSQL Enhanced (Separate) - Individual database per tree (advanced users)

Mode selection now integrated into backend choice - users select the appropriate backend when creating a tree.

ConfigManager Integration

• Per-tree settings.ini files following standard Gramps pattern
• Inherits host/port from Edit → Preferences → Database
• Password handled securely (prompted, not stored)
• Backward compatible with connection_info.txt

Gramps 6.0.6 API Compatibility

• Implemented json_extract_expression() method (required by DBAPI changes from Aug 2025)
• Added person_name_composite index for improved performance
• Compatible with Gramps commit ce25f3c01

Bug Fixes

• Import guard prevents registration when psycopg unavailable
• Fixed config file being ignored due to environment variable logic
• Fixed database auto-creation in separate mode
• Proper initialization of force_mode attribute

Migration for Existing Users

Two migration scripts provided in scripts/ directory:

1. migrate_to_dual_backends.py - Updates backend IDs in database.txt
2. migrate_to_settings_ini.py - Migrates connection_info.txt to settings.ini

Users upgrading from v1.5.2 should run both scripts.

Testing

• Tested on Gramps 6.0.1 and 6.0.6
• Both modes (Monolithic and Separate) verified working
• Migration scripts tested on existing databases
• ConfigManager integration validated

Documentation

• Updated README.md with dual backend explanation
• Added Windows AIO installation instructions
• Added Flatpak installation instructions
• Comprehensive troubleshooting section
• CHANGELOG.md with complete version history

Breaking Changes

• Backend IDs changed from postgresqlenhanced to postgresqlenhanced-monolithic and postgresqlenhanced-separate
• Configuration migrated from connection_info.txt to per-tree settings.ini
• Migration scripts handle transition automatically

Compatibility

• Python 3.9+
• Gramps 6.0+
• PostgreSQL 15+
• psycopg 3.1+

Related

• Fixes PostgreSQL Enhanced plugin not working on Ubuntu 24.04 with Gramps Flatpak install. glamberson/gramps-postgresql-enhanced#1
• Fixes No creation of a new tree possible glamberson/gramps-postgresql-enhanced#2
• Addresses Discourse discussion: https://gramps.discourse.group/t/trying-to-test-postgresql-enhanced/8959

[glamberson]

Hi, Could someone review this please? Thanks!

[GaryGriffin]

Are you satisfied with the review such that this is ready for merge?

[glamberson]

Yes, I'm sorry. I was engrossed in other projects. Please merge.

[GaryGriffin]

Tried to publish but failed. Something wrong with the GPR file. The publish step:

make.py gramps60 listing all

generates the json listing files, but does not include the 2 for this addon.

If I take out the pre-register code in the latest GPR (as below), it will publish. Note: I added the requires_mod and audience fields from the previous version.

"""
PostgreSQL Enhanced Database Backend Registration
"""

# Register Monolithic mode - all trees share one database
register(
    DATABASE,
    id="postgresqlenhanced-monolithic",
    name=_("PostgreSQL Enhanced (Monolithic)"),
    name_accell=_("PostgreSQL Enhanced (_Monolithic)"),
    description=_(
        "PostgreSQL backend with all trees in shared database. "
        "Recommended for most users. Uses table prefixes for multi-tree support. "
        "Requires PostgreSQL 15+ and psycopg 3+."
    ),
    version = '1.7.4',
    gramps_target_version="6.0",
    status=STABLE,
    audience=EXPERT,
    fname="postgresqlenhanced.py",
    databaseclass="PostgreSQLEnhancedMonolithic",
    authors=["Greg Lamberson"],
    authors_email=["[email protected]"],
    maintainers=["Greg Lamberson"],
    maintainers_email=["[email protected]"],
    requires_mod=['psycopg'],
    help_url="https://github.com/glamberson/gramps-postgresql-enhanced",
)

# Register Separate mode - one database per tree
register(
    DATABASE,
    id="postgresqlenhanced-separate",
    name=_("PostgreSQL Enhanced (Separate)"),
    name_accell=_("PostgreSQL Enhanced (_Separate)"),
    description=_(
        "PostgreSQL backend with individual database per tree. "
        "For advanced users requiring complete tree isolation. "
        "Requires PostgreSQL 15+ with CREATEDB privilege and psycopg 3+."
    ),
    version = '1.7.4',
    gramps_target_version="6.0",
    status=STABLE,
    audience=EXPERT,
    fname="postgresqlenhanced.py",
    databaseclass="PostgreSQLEnhancedSeparate",
    authors=["Greg Lamberson"],
    authors_email=["[email protected]"],
    maintainers=["Greg Lamberson"],
    maintainers_email=["[email protected]"],
    requires_mod=['psycopg'],
    help_url="https://github.com/glamberson/gramps-postgresql-enhanced",
)

Please fix the GPR file as needed so that it will publish.