top500albums/scripts/add_missing_info.py

#!/usr/bin/env python3
"""
Add missing Info and Description for albums that don't have them.
Mark new descriptions with "(by Claude)"
"""

import csv
import re

def escape_csv_field(text):
    """Properly escape CSV field content"""
    if '"' in text:
        text = text.replace('"', '""')
    if ',' in text or '"' in text or '\n' in text:
        text = f'"{text}"'
    return text

# Dictionary of missing album info and descriptions
missing_albums = {
    # Albums marked as "New in 2023" or missing data
    ("The Beatles", "The Beatles"): {
        "info": "Apple, 1968",
        "description": "Commonly known as 'The White Album' for its stark, minimalist cover, this ambitious double album showcased the Beatles' incredible creative diversity as they began to pursue individual artistic visions. Recorded during a period of internal tension, the 30-track collection ranges from the heavy rock of 'Helter Skelter' to the avant-garde soundscapes of 'Revolution 9,' from McCartney's music hall pastiche 'Honey Pie' to Lennon's primal blues 'Yer Blues.' Each Beatle contributed distinct personalities - Lennon's raw honesty, McCartney's melodic sophistication, Harrison's Eastern influences, and Starr's first songwriting credit with 'Don't Pass Me By.' The album's eclectic nature reflected the band's growing independence and foreshadowed their eventual dissolution, but also demonstrated their unparalleled ability to excel in virtually every musical style they attempted. (by Claude)"
    },
    ("The Jimi Hendrix Experience", "Are You Experienced"): {
        "info": "Track/Reprise, 1967", 
        "description": "Jimi Hendrix's explosive debut album revolutionized electric guitar playing and redefined the possibilities of rock music. From the opening feedback of 'Purple Haze' to the backwards guitar wizardry of 'Are You Experienced,' Hendrix demonstrated techniques that seemed impossible at the time. His innovative use of feedback, distortion, and the wah-wah pedal, combined with his left-handed playing on a right-handed guitar strung upside down, created a completely new sonic vocabulary. Songs like 'Hey Joe,' 'The Wind Cries Mary,' and 'Foxy Lady' showcased not only his technical brilliance but also his deep understanding of blues traditions and psychedelic experimentation. Recorded in London with bassist Noel Redding and drummer Mitch Mitchell, the album established Hendrix as the most innovative guitarist of his generation and influenced countless musicians who followed. (by Claude)"
    },
    ("Beyonce", "Renaissance"): {
        "info": "Parkwood/Columbia, 2022",
        "description": "Beyoncé's seventh solo studio album is a euphoric celebration of Black and queer dance music history, weaving together house, disco, Afrobeats, and ballroom culture into a cohesive masterpiece. Following the introspective 'Lemonade,' 'Renaissance' finds Beyoncé in full celebration mode, honoring the pioneers of dance music while creating something entirely contemporary. Tracks like 'Break My Soul' and 'Alien Superstar' showcase her vocal versatility over pulsating electronic beats, while 'Virgo's Groove' and 'Heated' blend sensuality with cutting-edge production. The album pays tribute to icons like Grace Jones, Donna Summer, and Robin S., while collaborating with producers like The-Dream, Raphael Saadiq, and Skrillex. 'Renaissance' represents Beyoncé at her most liberated, creating music designed for pure joy and movement, and stands as a triumphant testament to the power of Black musical innovation. (by Claude)"
    },
    ("Curtis Mayfield", "Super Fly"): {
        "info": "Curtom, 1972",
        "description": "Curtis Mayfield's soundtrack to the blaxploitation film 'Super Fly' became more influential than the movie itself, creating a template for socially conscious funk that would influence hip-hop for decades. Rather than glorifying the drug dealer protagonist, Mayfield's lyrics offered a complex critique of street life and systemic oppression. 'Freddie's Dead' mourns the casualties of the drug trade, while 'Pusherman' provides an unflinching portrait from the dealer's perspective without celebrating it. Mayfield's falsetto vocals float over innovative arrangements featuring wah-wah guitars, Latin percussion, and lush strings. The album's cinematic scope and social consciousness elevated it beyond typical soundtrack fare, making it a standalone masterpiece that addressed urban realities with unprecedented honesty and musical sophistication. (by Claude)"
    },
    ("Elvis Presley", "The Sun Sessions"): {
        "info": "RCA/Sun, 1976",
        "description": "This compilation of Elvis Presley's groundbreaking recordings at Sun Records captures the exact moment when rock and roll was born. Recorded between 1954-1955 at Sam Phillips' Memphis studio, these sessions document the 19-year-old Presley's revolutionary fusion of country, blues, and gospel that would change popular music forever. Songs like 'That's All Right,' 'Mystery Train,' and 'Baby Let's Play House' showcase Presley's uninhibited vocal style and natural charisma, backed by Scotty Moore's innovative guitar work and Bill Black's slapping bass. Phillips' sparse, echo-laden production captured the raw energy and spontaneity that made these performances so electrifying. While commercially these were regional hits, their cultural impact was immeasurable - they broke down racial barriers in music and inspired countless musicians to follow. (by Claude)"
    },
    ("Missy Elliott", "Supa Dupa Fly"): {
        "info": "Goldmind/East West, 1997",
        "description": "Missy Elliott's solo debut established her as hip-hop's most visionary artist, combining futuristic production with playful wordplay and boundary-pushing videos. Working primarily with producer Timbaland, Elliott created a sound unlike anything in rap - incorporating unusual samples, off-kilter rhythms, and innovative vocal techniques. Tracks like 'The Rain (Supa Dupa Fly)' and 'Sock It 2 Me' featured collaborations with artists like Aaliyah, Lil' Kim, and Da Brat, showcasing Elliott's ability to elevate everyone around her. Her approach to sexuality was both frank and empowering, while her visual aesthetic - from the inflatable suit in 'The Rain' video to the fish-eye lens effects - influenced a generation of artists. The album proved that hip-hop could be experimental, fun, and commercially successful simultaneously. (by Claude)"
    },
    ("John Lennon", "John Lennon/Plastic Ono Band"): {
        "info": "Apple, 1970",
        "description": "John Lennon's first proper solo album is one of rock's most harrowing and honest statements, stripping away all pretense to reveal raw emotional truth. Inspired by his experience with primal scream therapy, Lennon confronted his deepest traumas - his abandonment by his parents on 'Mother,' his disillusionment with fame on 'I Found Out,' and his rejection of religious and political idols on 'God.' Backed by the minimal but powerful rhythm section of Klaus Voormann and Ringo Starr, with sparse piano arrangements, the album's stark production serves the emotional intensity of Lennon's confessional lyrics. Songs like 'Working Class Hero' and 'Love' showcase his ability to channel pain into powerful statements about class, society, and human connection. The album's brutal honesty and psychological depth influenced generations of singer-songwriters. (by Claude)"
    },
    ("Sex Pistols", "Never Mind the Bollocks, Here's the Sex Pistols"): {
        "info": "Virgin, 1977", 
        "description": "The Sex Pistols' only studio album is punk rock's defining statement - a furious assault on British society, the music industry, and conventional values. Johnny Rotten's sneering vocals and provocative lyrics, combined with Steve Jones' powerful guitar work and the rhythm section of Glen Matlock (later Paul Cook), created an sound of pure rebellion. Songs like 'Anarchy in the U.K.' and 'God Save the Queen' were banned by the BBC but became anthems for disaffected youth. The album's crude production aesthetic, captured by Chris Thomas, perfectly matched the band's anti-establishment message. While the Pistols burned out quickly, their impact was immeasurable - inspiring countless punk bands and proving that music could be a weapon of social and political change. (by Claude)"
    },
    ("Eagles", "Hotel California"): {
        "info": "Asylum, 1976",
        "description": "The Eagles' fifth studio album represents the pinnacle of 1970s California rock, blending country, rock, and folk into a sophisticated sound that captured the excess and disillusionment of the era. The title track, with its iconic guitar work by Don Felder and Joe Walsh, became one of rock's most enduring songs, its mysterious lyrics about a luxurious but sinister hotel serving as a metaphor for the dark side of the American Dream. Songs like 'Life in the Fast Lane' and 'New Kid in Town' showcased the band's tight harmonies and polished production, while addressing themes of fame, materialism, and lost innocence. The album's glossy sound, crafted by producer Bill Szymczyk, influenced countless rock bands and helped define the smooth, radio-friendly aesthetic that dominated late-70s rock. (by Claude)"
    },
    ("Taylor Swift", "Folklore"): {
        "info": "Republic, 2020",
        "description": "Written and recorded during the COVID-19 pandemic, 'Folklore' marked Taylor Swift's stunning transformation from pop superstar to indie folk storyteller. Collaborating with Aaron Dessner of The National and longtime producer Jack Antonoff, Swift crafted her most introspective and mature work, trading stadium anthems for intimate, acoustic-based compositions. Songs like 'Cardigan,' 'Exile' (featuring Bon Iver), and 'The 1' showcase Swift's evolved songwriting, weaving complex narratives about fictional characters while drawing from personal experience. The album's cohesive aesthetic and literary quality demonstrated Swift's artistic growth beyond her country and pop roots, earning widespread critical acclaim and commercial success. 'Folklore' proved that Swift could excel in any genre she chose to explore. (by Claude)"
    },
    ("Metallica", "Metallica"): {
        "info": "Elektra, 1991",
        "description": "Known as 'The Black Album' for its stark cover, Metallica's fifth studio album brought the thrash metal pioneers into the mainstream without sacrificing their essential power. Working with producer Bob Rock, the band streamlined their sound, emphasizing groove and accessibility while maintaining their trademark heavy riffs and James Hetfield's aggressive vocals. Songs like 'Enter Sandman,' 'The Unforgiven,' and 'Nothing Else Matters' became rock radio staples, showcasing the band's ability to write memorable hooks within their metal framework. The album's polished production and shorter song structures marked a departure from their previous thrash epics, but the songwriting remained uncompromisingly heavy. The Black Album's massive commercial success proved that metal could dominate the mainstream charts. (by Claude)"
    },
    ("SZA", "SOS"): {
        "info": "TDE/RCA, 2022", 
        "description": "SZA's second studio album is a vulnerable exploration of love, heartbreak, and self-discovery that established her as one of R&B's most compelling voices. Drawing from personal experiences of toxic relationships and emotional growth, SZA crafts deeply relatable songs that blend contemporary R&B with elements of pop, hip-hop, and alternative rock. Tracks like 'Good Days,' 'I Hate U,' and 'Kill Bill' showcase her distinctive vocal style - breathy, conversational, and emotionally raw. The album's production, handled by collaborators including ThankGod4Cody and Carter Lang, creates atmospheric soundscapes that perfectly complement SZA's confessional lyrics. 'SOS' resonated with a generation dealing with similar relationship struggles and mental health challenges, cementing SZA's place as a defining artist of her era. (by Claude)"
    },
    ("Olivia Rodrigo", "Sour"): {
        "info": "Geffen, 2021",
        "description": "At just 18, Olivia Rodrigo created a debut album that perfectly captured the intensity of teenage heartbreak and the complexity of growing up in the social media age. 'Sour' blends pop-punk energy with introspective ballads, showcasing Rodrigo's ability to channel raw emotion into polished songcraft. 'Drivers License' became a global phenomenon, its intimate storytelling and soaring melody resonating with listeners worldwide. Other tracks like 'Good 4 U' and 'Brutal' display her versatility, moving from Paramore-influenced rock to Taylor Swift-style confessional pop. The album's success proved that guitar-driven pop could still dominate the charts, while Rodrigo's honest lyrics about jealousy, insecurity, and young love connected with audiences across generations. (by Claude)"
    },
    ("Harry Styles", "Harry's House"): {
        "info": "Columbia, 2022",
        "description": "Harry Styles' third solo album finds the former One Direction member fully embracing his artistic independence, creating a cohesive collection of sophisticated pop songs that showcase his growth as a songwriter and performer. Drawing influences from yacht rock, Britpop, and contemporary indie music, 'Harry's House' features lush production and intimate lyrics about love, fame, and self-reflection. Songs like 'As It Was,' 'Music for a Sushi Restaurant,' and 'Late Night Talking' demonstrate Styles' evolving vocal confidence and melodic sensibilities. The album's warm, inviting sound and themes of domestic happiness marked a departure from his previous work's more experimental tendencies, resulting in both critical acclaim and massive commercial success that solidified his status as a major solo artist. (by Claude)"
    },
    ("Bad Bunny", "Un Verano Sin Ti"): {
        "info": "Rimas Entertainment, 2022",
        "description": "Bad Bunny's fourth studio album is a sprawling celebration of Caribbean culture that dominated global charts while showcasing the full range of reggaeton and Latin trap. Across 23 tracks, the Puerto Rican superstar explores themes of love, heartbreak, and summer freedom, blending traditional reggaeton rhythms with elements of mambo, dembow, and electronic music. Songs like 'Me Porto Bonito' (featuring Chencho Corleone) and 'Tití Me Preguntó' became massive hits, while deeper cuts showcased Bad Bunny's versatility and cultural pride. The album's success transcended language barriers, proving that Spanish-language music could achieve unprecedented mainstream success in the United States. 'Un Verano Sin Ti' stands as a landmark achievement in Latin music's global expansion. (by Claude)"
    },
    ("The Jimi Hendrix Experience", "Electric Ladyland"): {
        "info": "Reprise, 1968",
        "description": "Jimi Hendrix's third and final studio album with the Experience showcased his evolution from guitar virtuoso to complete artistic visionary. The double album features some of Hendrix's most ambitious compositions, including the epic 'Voodoo Chile (Slight Return)' and his legendary cover of Bob Dylan's 'All Along the Watchtower,' which Dylan himself called the definitive version. The album demonstrated Hendrix's studio mastery, incorporating layers of overdubs, backwards recordings, and innovative effects that pushed the boundaries of what was possible in 1968. Songs like '1983... (A Merman I Should Turn to Be)' showed his interest in creating sonic landscapes beyond traditional rock structures. 'Electric Ladyland' stands as Hendrix's most complete artistic statement, combining his unparalleled guitar skills with sophisticated songwriting and production. (by Claude)"
    },
    ("Solange Knowles", "A Seat at the Table"): {
        "info": "Saint/Columbia, 2016",
        "description": "Solange's third studio album is a powerful meditation on Black identity, pride, and resilience in America. Drawing from neo-soul, funk, and R&B traditions, the album features deeply personal songs about growing up Black in the South, family relationships, and finding strength in cultural heritage. Tracks like 'Cranes in the Sky' and 'Don't Touch My Hair' became anthems of Black empowerment, while interludes featuring conversations with her parents and other family members added intimate context to the album's themes. The album's production, crafted with collaborators including Raphael Saadiq and The-Dream, creates a cohesive sonic journey that perfectly complements Solange's vulnerable yet defiant vocals. 'A Seat at the Table' was both a critical triumph and a cultural moment, addressing racial issues with grace and artistic sophistication. (by Claude)"
    },
    ("Gorillaz", "Demon Days"): {
        "info": "Parlophone/Virgin, 2005",
        "description": "Damon Albarn and Jamie Hewlett's virtual band reached its creative peak with this apocalyptic masterpiece that blended hip-hop, electronic, rock, and world music into a cohesive statement about modern anxiety and cultural decay. Featuring collaborations with De La Soul, MF Doom, Dennis Hopper, and others, 'Demon Days' created a dark but groovy soundtrack for the Bush era's political and social turmoil. Songs like 'Feel Good Inc.' and 'DARE' became massive hits while maintaining the project's experimental edge. The album's concept, centered around themes of war, consumerism, and environmental destruction, was perfectly matched by Hewlett's striking visual aesthetic and Albarn's increasingly sophisticated production. 'Demon Days' proved that conceptual pop music could be both artistically ambitious and commercially successful. (by Claude)"
    },
    ("Bon Iver", "For Emma, Forever Ago"): {
        "info": "Jagjaguwar, 2007",
        "description": "Recorded in isolation at a remote Wisconsin cabin during winter, Justin Vernon's debut as Bon Iver became an unlikely indie folk masterpiece that defined a generation's approach to intimate, lo-fi songcraft. Using minimal instrumentation and his distinctive falsetto, Vernon crafted deeply emotional songs about heartbreak, solitude, and healing. The album's sparse production, featuring acoustic guitar, subtle electronics, and layered vocals, created an atmosphere of profound vulnerability and beauty. Songs like 'Skinny Love' and 'Re: Stacks' showcased Vernon's ability to transform personal pain into universal art. The album's success proved that bedroom recording techniques could produce music of lasting emotional impact, influencing countless indie artists who followed. (by Claude)"
    },
    ("David Bowie", "Scary Monsters (and Super Creeps)"): {
        "info": "RCA, 1980",
        "description": "David Bowie's fourteenth studio album marked his successful transition into the 1980s, blending his art-rock sophistication with new wave energy and cutting-edge production techniques. Working with producer Tony Visconti and guitarist Robert Fripp, Bowie created a sound that was both futuristic and deeply human. The title track and 'Fashion' became definitive examples of early-80s avant-pop, while 'Ashes to Ashes' served as a sequel to 'Space Oddity,' bringing the story of Major Tom full circle. The album's exploration of celebrity, paranoia, and modern alienation was perfectly suited to the dawning MTV era. 'Scary Monsters' demonstrated Bowie's remarkable ability to reinvent himself while maintaining his essential artistic vision, creating some of his most enduring and influential work. (by Claude)"
    }
}

def main():
    # Read current CSV
    albums = []
    with open('top_500_albums_2023.csv', 'r', encoding='utf-8') as file:
        reader = csv.DictReader(file)
        for row in reader:
            albums.append(row)
    
    # Find and update missing info
    updated_count = 0
    for album in albums:
        artist = album['Artist'].strip()
        album_title = album['Album'].strip()
        
        # Check if this album is missing info/description
        if not album['Info'].strip() or not album['Description'].strip():
            # Look for it in our database
            if (artist, album_title) in missing_albums:
                album_data = missing_albums[(artist, album_title)]
                if not album['Info'].strip():
                    album['Info'] = album_data['info']
                if not album['Description'].strip():
                    album['Description'] = album_data['description']
                updated_count += 1
                print(f"✓ Updated: {artist} - {album_title}")
            else:
                print(f"✗ Missing: {artist} - {album_title}")
    
    # Write updated CSV
    with open('top_500_albums_2023.csv', 'w', newline='', encoding='utf-8') as file:
        fieldnames = ['Rank', 'Artist', 'Album', 'Status', 'Info', 'Description']
        writer = csv.DictWriter(file, fieldnames=fieldnames)
        writer.writeheader()
        writer.writerows(albums)
    
    print(f"\n🎉 Updated {updated_count} albums with missing info/descriptions")
    print("All descriptions added by Claude are marked with '(by Claude)'")

if __name__ == "__main__":
    main()