This file is indexed.

/usr/lib/python2.7/dist-packages/rgain/albumid.py is in python-rgain 1.3.4-1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
# -*- coding: utf-8 -*-
#
# Copyright (c) 2009-2015 Felix Krull <f_krull@gmx.de>
#
# 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, 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., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

from mutagen.id3 import ID3FileType


def _get_simple_tag(tags, mp3_keys, default_key):
    """Retrieve a tag value, using either one of a few MP3 tags or a generic
    one for other formats."""
    if isinstance(tags, ID3FileType):
        for k in mp3_keys:
            frame = tags.get(k, None)
            if frame:
                return frame.text[0]
    else:
        vs = tags.get(default_key, None)
        if vs:
            return vs[0]

    # default fall-through
    return None

get_musicbrainz_album_id = lambda tags: _get_simple_tag(
    tags,
    ["TXXX:MusicBrainz Album Id", "TXXX:MUSICBRAINZ_ALBUMID"],
    "musicbrainz_albumid")

get_musicbrainz_albumartist_id = lambda tags: _get_simple_tag(
    tags,
    ["TXXX:MusicBrainz Album Artist Id", "TXXX:MUSICBRAINZ_ALBUMARTISTID"],
    "musicbrainz_albumartistid")

get_musicbrainz_artist_id = lambda tags: _get_simple_tag(
    tags,
    ["TXXX:MusicBrainz Artist Id", "TXXX:MUSICBRAINZ_ARTISTID"],
    "musicbrainz_artistid")

get_album = lambda tags: _get_simple_tag(
    tags,
    ["TALB"],
    "album")

get_artist = lambda tags: _get_simple_tag(
    tags,
    ["TPE1"],
    "artist")

# XXX: We're not doing case-insensitive checking anymore. Let's hope that
# doesn't regress anything...
# For MP3, in that order:
#  - a generic "TXXX:albumartist"
#  - QL's "TXXX:QuodLibet::albumartist"
#  - fb2k's legacy "TXXX:ALBUM ARTIST"
#  - finally, "TPE2" as used by at least fb2k and Picard. According to
#    the ID3 standard, this is performer, but fb2k uses it for album
#    artist since 1.1.6, citing "compatibility with other players"; see
#    http://wiki.hydrogenaudio.org/index.php?title=Foobar2000:ID3_Tag_Mapping
get_albumartist = lambda tags: _get_simple_tag(
    tags,
    ["TXXX:albumartist", "TXXX:QuodLibet::albumartist", "TXXX:ALBUM ARTIST",
     "TPE2"],
    "albumartist")


def _take_first_tag(tags, default, functions):
    """Return the first tag value that isn't None."""
    for f in functions:
        value = f(tags)
        if value is not None:
            return value
    return default


def get_album_id(tags):
    """Try to determine an album id based on the given tags.

    The basic logic is as follows:
    - If a MusicBrainz album ID exists, use that.
    - If an album tag exists, combine that with:
      - a MusicBrainz album artist ID if it exists,
      - otherwise an album artist tag if it exists,
      - otherwise an artist tag if it exists,
      - otherwise, nothing
      and use the result.
    - Otherwise, assume non-album track.
    """
    mb_album_id = get_musicbrainz_album_id(tags)
    if mb_album_id is not None:
        return mb_album_id
    album = get_album(tags)
    if album is not None:
        artist_part = _take_first_tag(tags, None, [
            get_musicbrainz_albumartist_id,
            get_albumartist,
            get_artist])
        if artist_part is None:
            return album
        else:
            return u"%s - %s" % (artist_part, album)
    else:
        return None