# -*- coding: utf-8 -*-
#
# Picard, the next-generation MusicBrainz tagger
#
# Copyright (C) 2025 Laurent Monin
#
# This program is free software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License
# as published by the Free Software Foundation; either version 2
# of the License, or (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

"""Git reference utilities for robust reference type detection."""


def find_git_ref(repo, ref_name):
    """Find a GitRef object by shortname or full name.

    Args:
        repo: Git repository object
        ref_name: Reference name to find (shortname or full name)

    Returns:
        GitRef object if found, None otherwise
    """
    if not ref_name:
        return None

    try:
        references = repo.list_references()

        # Check shortname first (most common case)
        for git_ref in references:
            if git_ref.shortname == ref_name:
                return git_ref

        # Check full name
        for git_ref in references:
            if git_ref.name == ref_name:
                return git_ref

    except Exception:
        pass

    return None
