Providing URL credentials only once using the host OS keyring.

[thutt]

A new feature that will be present soon is the use of the Python
'keyring' module to store URL credentials in an OS keyring. This
makes it so URL credentials only need to be entered once.

This is enabled on all supported OSes, but there was a snag with Linux
initially. Here are the steps to diagnose and get the keyring
working, if it doesn't work out-of-the-box.

Additionally, if you don't want to use the keyring, you can provide
'--no-keyring' as an argument to vrt.

o MacOS

Worked out of the box.

o Windows cmd.exe

Worked out of the box.

o WSL2

Gnome-Keyring is not installed by default.

On Ubuntu:

sudo apt install gnome-keyring

Once installed, the system worked.

o Linux

If gnome-keyring is installed and running, it should work. I

If it does not, use these instructions to help understand what might
be wrong:

Summary: Diagnosing and Fixing Keyring Issues on Linux

1. Initial Problem:

   App prompted to create new keychain on every run Credentials
   weren't persisting between sessions.

2. Installation:

   pip install keyring

3. Diagnosis Steps:

   Check which keyring backend is active:

   python3 -c "import keyring; print(keyring.get_keyring())"

   Result: ChainerBackend (tries multiple backends)

   Check available backends:

   python3 -c "import keyring.backend; print('\n'.join(str(k) for k in keyring.backend.get_all_keyring()))"

   Result: Had libsecret and SecretService available

 Check if keyring daemon is running:

   ps aux | grep -E 'gnome-keyring|kwallet'

   Result: Daemon was running but corrupted

 Test keyring operations:

    python3 << 'EOF'
    import keyring
    try:
        keyring.set_password("test-service", "test-user", "test-pass")
        print("SUCCESS")
    except Exception as e:
        print(f"ERROR: {e}")
    EOF

    Result: InitError: Failed to create the collection: Prompt
            dismissed - revealed the daemon was in bad state

4. Solution:

   Kill stale daemon

   killall gnome-keyring-daemon

   Start fresh

   eval $(gnome-keyring-daemon --start --components=secrets)

   Verify working

   python3 -c "import keyring; keyring.set_password('test','user','pass'); print('OK')"

   5. Persistence: Add to ~/.profile:
      bash

   killall -q gnome-keyring-daemon 2>/dev/null
   eval $(gnome-keyring-daemon --start --components=secrets 2>/dev/null)