diff --git a/tools/data/find_events_data.json b/tools/data/find_events_data.json index 21de846..c21efa1 100644 --- a/tools/data/find_events_data.json +++ b/tools/data/find_events_data.json @@ -41,6 +41,222 @@ "dateFrom": "2025-03-19", "dateTo": "2025-03-29", "description": "A celebration of Victoria's culinary scene, featuring food and wine events, masterclasses, and dining experiences." + }, + { + "eventName": "Australian Open", + "dateFrom": "2026-01-12", + "dateTo": "2026-02-01", + "description": "A two-week Grand Slam tennis tournament featuring the world's top players at Melbourne Park, with entertainment options and family-friendly activities." + }, + { + "eventName": "Moomba Festival", + "dateFrom": "2026-03-05", + "dateTo": "2026-03-09", + "description": "Australia's largest free community festival along the Yarra River, featuring a parade, live music, fireworks, the Birdman Rally, and carnival rides." + }, + { + "eventName": "Formula 1 Australian Grand Prix", + "dateFrom": "2026-03-05", + "dateTo": "2026-03-08", + "description": "The opening race of the 2026 F1 season at Albert Park Circuit, featuring high-speed racing action and the debut of Cadillac and Audi on the F1 grid." + }, + { + "eventName": "Melbourne Food and Wine Festival", + "dateFrom": "2026-03-20", + "dateTo": "2026-03-29", + "description": "A celebration of Victoria's culinary scene, featuring food and wine events, masterclasses, and dining experiences across Melbourne." + }, + { + "eventName": "Melbourne International Comedy Festival", + "dateFrom": "2026-03-25", + "dateTo": "2026-04-19", + "description": "Celebrating its 40th anniversary, one of the world's largest comedy festivals with stand-up, cabaret, theatre, and street performances across numerous venues." + }, + { + "eventName": "Rising Festival", + "dateFrom": "2026-06-03", + "dateTo": "2026-06-14", + "description": "A major arts and culture festival featuring the Australian Dance Biennial, immersive performances, and cutting-edge contemporary art across Melbourne." + }, + { + "eventName": "Firelight Festival", + "dateFrom": "2026-06-18", + "dateTo": "2026-06-20", + "description": "A spectacular winter festival at Malthouse Theatre featuring fire installations, laser shows, live music, and fire twirlers." + }, + { + "eventName": "Melbourne International Film Festival (MIFF)", + "dateFrom": "2026-08-06", + "dateTo": "2026-08-23", + "description": "The 74th annual MIFF presents a diverse selection of Australian and international films, including Academy Award-qualifying shorts." + }, + { + "eventName": "Now or Never Festival", + "dateFrom": "2026-08-14", + "dateTo": "2026-08-23", + "description": "A multi-sensory festival featuring immersive experiences across art, sound, and technology in various Melbourne venues." + }, + { + "eventName": "White Night Melbourne", + "dateFrom": "2026-08-21", + "dateTo": "2026-08-23", + "description": "A dusk-to-dawn arts and cultural festival transforming the city with light installations, projections, music, and performances." + }, + { + "eventName": "Melbourne Fringe Festival", + "dateFrom": "2026-09-29", + "dateTo": "2026-10-18", + "description": "Celebrating 44 years, Melbourne Fringe features three weeks of comedy, cabaret, theatre, music, and digital art across various venues." + }, + { + "eventName": "Melbourne Cup Carnival", + "dateFrom": "2026-10-31", + "dateTo": "2026-11-07", + "description": "The Spring Racing Carnival at Flemington Racecourse featuring Derby Day, Melbourne Cup, Oaks Day, and Stakes Day." + }, + { + "eventName": "Tomorrowland CORE Festival", + "dateFrom": "2026-11-28", + "dateTo": "2026-11-28", + "description": "A major electronic music festival bringing the iconic Tomorrowland experience to Melbourne." + }, + { + "eventName": "Australian Open", + "dateFrom": "2027-01-11", + "dateTo": "2027-01-31", + "description": "A two-week Grand Slam tennis tournament featuring the world's top players at Melbourne Park, with entertainment options and family-friendly activities." + }, + { + "eventName": "Moomba Festival", + "dateFrom": "2027-03-04", + "dateTo": "2027-03-08", + "description": "Australia's largest free community festival along the Yarra River, featuring a parade, live music, fireworks, the Birdman Rally, and carnival rides." + }, + { + "eventName": "Formula 1 Australian Grand Prix", + "dateFrom": "2027-03-04", + "dateTo": "2027-03-07", + "description": "The Formula 1 Australian Grand Prix at Albert Park Circuit, featuring high-speed racing action with top teams and drivers." + }, + { + "eventName": "Melbourne Food and Wine Festival", + "dateFrom": "2027-03-19", + "dateTo": "2027-03-28", + "description": "A celebration of Victoria's culinary scene, featuring food and wine events, masterclasses, and dining experiences across Melbourne." + }, + { + "eventName": "Melbourne International Comedy Festival", + "dateFrom": "2027-03-24", + "dateTo": "2027-04-18", + "description": "One of the world's largest comedy festivals with stand-up, cabaret, theatre, and street performances across numerous venues." + }, + { + "eventName": "Rising Festival", + "dateFrom": "2027-06-02", + "dateTo": "2027-06-13", + "description": "A major arts and culture festival featuring immersive performances and cutting-edge contemporary art across Melbourne." + }, + { + "eventName": "Firelight Festival", + "dateFrom": "2027-06-17", + "dateTo": "2027-06-19", + "description": "A spectacular winter festival at Malthouse Theatre featuring fire installations, laser shows, live music, and fire twirlers." + }, + { + "eventName": "Melbourne International Film Festival (MIFF)", + "dateFrom": "2027-08-05", + "dateTo": "2027-08-22", + "description": "The 75th annual MIFF presents a diverse selection of Australian and international films, including Academy Award-qualifying shorts." + }, + { + "eventName": "Now or Never Festival", + "dateFrom": "2027-08-13", + "dateTo": "2027-08-22", + "description": "A multi-sensory festival featuring immersive experiences across art, sound, and technology in various Melbourne venues." + }, + { + "eventName": "White Night Melbourne", + "dateFrom": "2027-08-20", + "dateTo": "2027-08-22", + "description": "A dusk-to-dawn arts and cultural festival transforming the city with light installations, projections, music, and performances." + }, + { + "eventName": "Melbourne Fringe Festival", + "dateFrom": "2027-09-28", + "dateTo": "2027-10-17", + "description": "Melbourne Fringe features three weeks of comedy, cabaret, theatre, music, and digital art across various venues." + }, + { + "eventName": "Melbourne Cup Carnival", + "dateFrom": "2027-10-30", + "dateTo": "2027-11-06", + "description": "The Spring Racing Carnival at Flemington Racecourse featuring Derby Day, Melbourne Cup, Oaks Day, and Stakes Day." + }, + { + "eventName": "British and Irish Lions Rugby", + "dateFrom": "2026-07-22", + "dateTo": "2026-07-26", + "description": "The British and Irish Lions tour matches in Melbourne, featuring games against the Melbourne Rebels and the Wallabies at the MCG." + }, + { + "eventName": "Boxing Day Test", + "dateFrom": "2026-12-26", + "dateTo": "2026-12-30", + "description": "The iconic Boxing Day Test match at the MCG, part of the NRMA Insurance Ashes series featuring Australia vs England." + }, + { + "eventName": "Melbourne Royal Show", + "dateFrom": "2026-09-19", + "dateTo": "2026-09-29", + "description": "Victoria's largest annual community event featuring agricultural displays, carnival rides, showbags, and entertainment at Melbourne Showgrounds." + }, + { + "eventName": "British and Irish Lions Rugby", + "dateFrom": "2027-07-21", + "dateTo": "2027-07-25", + "description": "The British and Irish Lions tour matches in Melbourne, featuring games against local teams and the Wallabies." + }, + { + "eventName": "Boxing Day Test", + "dateFrom": "2027-12-26", + "dateTo": "2027-12-30", + "description": "The iconic Boxing Day Test match at the MCG featuring international cricket action." + }, + { + "eventName": "Melbourne Royal Show", + "dateFrom": "2027-09-18", + "dateTo": "2027-09-28", + "description": "Victoria's largest annual community event featuring agricultural displays, carnival rides, showbags, and entertainment at Melbourne Showgrounds." + }, + { + "eventName": "Melbourne Knowledge Week", + "dateFrom": "2026-05-04", + "dateTo": "2026-05-10", + "description": "A week of innovation, ideas, and inspiration featuring talks, workshops, and events exploring technology, science, and creativity." + }, + { + "eventName": "Melbourne Knowledge Week", + "dateFrom": "2027-05-03", + "dateTo": "2027-05-09", + "description": "A week of innovation, ideas, and inspiration featuring talks, workshops, and events exploring technology, science, and creativity." + }, + { + "eventName": "Melbourne Design Week", + "dateFrom": "2026-05-15", + "dateTo": "2026-05-24", + "description": "Australia's leading annual design event featuring exhibitions, talks, workshops, and open studios across Melbourne." + }, + { + "eventName": "Melbourne Design Week", + "dateFrom": "2027-05-14", + "dateTo": "2027-05-23", + "description": "Australia's leading annual design event featuring exhibitions, talks, workshops, and open studios across Melbourne." + }, + { + "eventName": "Melbourne Fashion Week", + "dateFrom": "2027-02-28", + "dateTo": "2027-03-06", + "description": "A celebration of Melbourne's fashion industry with runway shows, designer showcases, and style events across the city." } ], "Sydney": [ @@ -79,6 +295,150 @@ "dateFrom": "2025-06-04", "dateTo": "2025-06-15", "description": "One of the longest-running film festivals in the world, showcasing a diverse selection of local and international films." + }, + { + "eventName": "Sydney Festival", + "dateFrom": "2026-01-08", + "dateTo": "2026-01-25", + "description": "The 50th edition of Sydney Festival, a citywide celebration of culture with theatre, dance, music, and visual arts across the city." + }, + { + "eventName": "Sydney Gay and Lesbian Mardi Gras", + "dateFrom": "2026-02-13", + "dateTo": "2026-03-01", + "description": "The 48th Mardi Gras Festival with theme 'Ecstatica', featuring the iconic parade with 200 floats and 12,000 marchers, Fair Day, film festival, and parties." + }, + { + "eventName": "Mardi Gras Film Festival", + "dateFrom": "2026-02-12", + "dateTo": "2026-02-26", + "description": "Queer Screen's 33rd Mardi Gras Film Festival showcasing LGBTQ+ cinema across multiple Sydney venues." + }, + { + "eventName": "Sydney Royal Easter Show", + "dateFrom": "2026-04-02", + "dateTo": "2026-04-13", + "description": "Australia's largest annual ticketed event at Sydney Olympic Park, featuring agricultural shows, carnival rides, showbags, and entertainment." + }, + { + "eventName": "Sydney Writers' Festival", + "dateFrom": "2026-05-18", + "dateTo": "2026-05-24", + "description": "A major literary festival at Carriageworks and Sydney Town Hall featuring talks, panel discussions, and workshops with acclaimed authors." + }, + { + "eventName": "Vivid Sydney", + "dateFrom": "2026-05-22", + "dateTo": "2026-06-13", + "description": "The 16th Vivid Sydney transforms the Harbour City for 23 nights with light installations, music, ideas, and food experiences." + }, + { + "eventName": "Sydney Film Festival", + "dateFrom": "2026-06-03", + "dateTo": "2026-06-14", + "description": "The 73rd Sydney Film Festival with a record $200,000 prize pool, showcasing local and international premieres and special events." + }, + { + "eventName": "Sculpture by the Sea, Bondi", + "dateFrom": "2026-10-16", + "dateTo": "2026-11-02", + "description": "The world's largest free outdoor sculpture exhibition along the Bondi to Tamarama coastal walk, featuring 100 sculptures by artists from around the world." + }, + { + "eventName": "Field Day Festival", + "dateFrom": "2026-01-01", + "dateTo": "2026-01-01", + "description": "New Year's Day music festival featuring top electronic and dance artists including Bag Raiders, The Presets, and Carl Cox." + }, + { + "eventName": "Sydney Festival", + "dateFrom": "2027-01-07", + "dateTo": "2027-01-24", + "description": "A major arts festival presenting a diverse program of theatre, dance, music, and visual arts across the city." + }, + { + "eventName": "Sydney Gay and Lesbian Mardi Gras", + "dateFrom": "2027-02-12", + "dateTo": "2027-02-28", + "description": "One of the largest LGBTQ+ festivals globally, featuring a vibrant parade, parties, film festival, and cultural events celebrating diversity." + }, + { + "eventName": "Sydney Royal Easter Show", + "dateFrom": "2027-03-25", + "dateTo": "2027-04-05", + "description": "Australia's largest annual ticketed event at Sydney Olympic Park, featuring agricultural shows, carnival rides, showbags, and entertainment." + }, + { + "eventName": "Sydney Writers' Festival", + "dateFrom": "2027-05-17", + "dateTo": "2027-05-23", + "description": "A major literary festival at Carriageworks and Sydney Town Hall featuring talks, panel discussions, and workshops with acclaimed authors." + }, + { + "eventName": "Vivid Sydney", + "dateFrom": "2027-05-21", + "dateTo": "2027-06-12", + "description": "Vivid Sydney transforms the Harbour City for 23 nights with light installations, music, ideas, and food experiences." + }, + { + "eventName": "Sydney Film Festival", + "dateFrom": "2027-06-02", + "dateTo": "2027-06-13", + "description": "The 74th Sydney Film Festival showcasing local and international premieres, talks, and special events." + }, + { + "eventName": "Sculpture by the Sea, Bondi", + "dateFrom": "2027-10-15", + "dateTo": "2027-11-01", + "description": "The world's largest free outdoor sculpture exhibition along the Bondi to Tamarama coastal walk, featuring sculptures by artists from around the world." + }, + { + "eventName": "SMASH! Sydney Manga and Anime Show", + "dateFrom": "2026-07-18", + "dateTo": "2026-07-19", + "description": "Australia's premier Japanese pop culture convention at ICC Sydney Darling Harbour, featuring anime, manga, cosplay, and Japanese entertainment." + }, + { + "eventName": "Sydney Science Festival", + "dateFrom": "2026-08-08", + "dateTo": "2026-08-18", + "description": "A ten-day celebration of Australian science coinciding with National Science Week, featuring exhibitions, talks, and hands-on activities." + }, + { + "eventName": "Sydney Fringe Festival", + "dateFrom": "2026-09-01", + "dateTo": "2026-09-30", + "description": "A month-long celebration of independent arts with over 400 events across Sydney featuring comedy, theatre, music, and visual arts." + }, + { + "eventName": "Sydney New Year's Eve", + "dateFrom": "2026-12-31", + "dateTo": "2026-12-31", + "description": "The world-famous Sydney Harbour New Year's Eve fireworks spectacular, featuring two shows and celebrations across the city." + }, + { + "eventName": "SMASH! Sydney Manga and Anime Show", + "dateFrom": "2027-07-17", + "dateTo": "2027-07-18", + "description": "Australia's premier Japanese pop culture convention at ICC Sydney Darling Harbour, featuring anime, manga, cosplay, and Japanese entertainment." + }, + { + "eventName": "Sydney Science Festival", + "dateFrom": "2027-08-07", + "dateTo": "2027-08-17", + "description": "A ten-day celebration of Australian science coinciding with National Science Week, featuring exhibitions, talks, and hands-on activities." + }, + { + "eventName": "Sydney Fringe Festival", + "dateFrom": "2027-09-01", + "dateTo": "2027-09-30", + "description": "A month-long celebration of independent arts with over 400 events across Sydney featuring comedy, theatre, music, and visual arts." + }, + { + "eventName": "Sydney New Year's Eve", + "dateFrom": "2027-12-31", + "dateTo": "2027-12-31", + "description": "The world-famous Sydney Harbour New Year's Eve fireworks spectacular, featuring two shows and celebrations across the city." } ], "Auckland": [ @@ -105,6 +465,186 @@ "dateFrom": "2025-10-26", "dateTo": "2025-10-27", "description": "A vibrant celebration of Indian culture and the Hindu festival of Diwali, featuring performances, food stalls, and traditional activities." + }, + { + "eventName": "Auckland Arts Festival", + "dateFrom": "2026-03-05", + "dateTo": "2026-03-22", + "description": "Te Ahurei Toi o Tamaki Auckland Arts Festival featuring local and international talent across theatre, music, dance, and circus with the Festival Garden and free events." + }, + { + "eventName": "Pasifika Festival", + "dateFrom": "2026-03-14", + "dateTo": "2026-03-15", + "description": "The world's largest Pacific Islands cultural festival at Western Springs Park, celebrating 11 Pacific Island nations with performances, food, and arts." + }, + { + "eventName": "Pasifika Vibes Festival", + "dateFrom": "2026-05-04", + "dateTo": "2026-05-04", + "description": "A celebration of Maori and Pacific Island cultures featuring food, craft, and entertainment on Labour Day." + }, + { + "eventName": "Auckland Writers Festival", + "dateFrom": "2026-05-12", + "dateTo": "2026-05-17", + "description": "One of the Southern Hemisphere's best-attended book festivals at Aotea Centre, featuring international and local writers across six days." + }, + { + "eventName": "New Zealand International Film Festival - Auckland", + "dateFrom": "2026-07-30", + "dateTo": "2026-08-12", + "description": "A major film festival showcasing the best of international and local cinema with premieres and special events." + }, + { + "eventName": "Auckland Diwali Festival", + "dateFrom": "2026-10-24", + "dateTo": "2026-10-25", + "description": "A vibrant celebration of Indian culture and the Hindu festival of Diwali, featuring performances, food stalls, and traditional activities." + }, + { + "eventName": "Auckland Lantern Festival", + "dateFrom": "2026-02-19", + "dateTo": "2026-02-22", + "description": "A spectacular Lunar New Year celebration with traditional Chinese lanterns, performances, and food celebrating the Year of the Horse." + }, + { + "eventName": "Auckland Arts Festival", + "dateFrom": "2027-03-04", + "dateTo": "2027-03-21", + "description": "Te Ahurei Toi o Tamaki Auckland Arts Festival featuring local and international talent across theatre, music, dance, and circus." + }, + { + "eventName": "Pasifika Festival", + "dateFrom": "2027-03-13", + "dateTo": "2027-03-14", + "description": "The world's largest Pacific Islands cultural festival at Western Springs Park, celebrating 11 Pacific Island nations with performances, food, and arts." + }, + { + "eventName": "Auckland Writers Festival", + "dateFrom": "2027-05-11", + "dateTo": "2027-05-16", + "description": "One of the Southern Hemisphere's best-attended book festivals at Aotea Centre, featuring international and local writers across six days." + }, + { + "eventName": "New Zealand International Film Festival - Auckland", + "dateFrom": "2027-07-29", + "dateTo": "2027-08-11", + "description": "A major film festival showcasing the best of international and local cinema with premieres and special events." + }, + { + "eventName": "Auckland Diwali Festival", + "dateFrom": "2027-10-23", + "dateTo": "2027-10-24", + "description": "A vibrant celebration of Indian culture and the Hindu festival of Diwali, featuring performances, food stalls, and traditional activities." + }, + { + "eventName": "ASB Classic Tennis", + "dateFrom": "2026-01-05", + "dateTo": "2026-01-17", + "description": "Auckland's premier tennis tournament at Manuka Doctor Arena featuring top ATP and WTA players in the lead-up to the Australian Open." + }, + { + "eventName": "Auckland Anniversary Day Regatta", + "dateFrom": "2026-01-26", + "dateTo": "2026-01-26", + "description": "The world's largest one-day regatta celebrating Auckland's birthday on the water with hundreds of boats and spectacular harbour racing." + }, + { + "eventName": "St Jerome's Laneway Festival", + "dateFrom": "2026-02-05", + "dateTo": "2026-02-05", + "description": "A major music festival at Western Springs Stadium featuring top international and local indie and alternative artists." + }, + { + "eventName": "Auckland Comedy Festival", + "dateFrom": "2026-04-28", + "dateTo": "2026-05-17", + "description": "Three weeks of comedy across Auckland venues featuring local and international comedians in stand-up, sketch, and improv." + }, + { + "eventName": "Matariki Festival", + "dateFrom": "2026-06-19", + "dateTo": "2026-06-28", + "description": "Celebrations marking Māori New Year with cultural events, performances, and community gatherings across Auckland." + }, + { + "eventName": "Auckland Marathon", + "dateFrom": "2026-11-01", + "dateTo": "2026-11-01", + "description": "New Zealand's largest marathon event featuring a scenic course across the Auckland Harbour Bridge with multiple distance options." + }, + { + "eventName": "Auckland Santa Parade", + "dateFrom": "2026-11-29", + "dateTo": "2026-11-29", + "description": "Auckland's beloved Christmas parade featuring floats, performances, and Santa Claus through the city centre." + }, + { + "eventName": "Synthony Festival", + "dateFrom": "2026-12-05", + "dateTo": "2026-12-05", + "description": "New Zealand's biggest one-day music festival at Auckland Domain featuring electronic dance music with a live orchestra." + }, + { + "eventName": "ASB Classic Tennis", + "dateFrom": "2027-01-04", + "dateTo": "2027-01-16", + "description": "Auckland's premier tennis tournament at Manuka Doctor Arena featuring top ATP and WTA players in the lead-up to the Australian Open." + }, + { + "eventName": "Auckland Anniversary Day Regatta", + "dateFrom": "2027-01-25", + "dateTo": "2027-01-25", + "description": "The world's largest one-day regatta celebrating Auckland's birthday on the water with hundreds of boats and spectacular harbour racing." + }, + { + "eventName": "Auckland Comedy Festival", + "dateFrom": "2027-04-27", + "dateTo": "2027-05-16", + "description": "Three weeks of comedy across Auckland venues featuring local and international comedians in stand-up, sketch, and improv." + }, + { + "eventName": "Matariki Festival", + "dateFrom": "2027-06-25", + "dateTo": "2027-07-04", + "description": "Celebrations marking Māori New Year with cultural events, performances, and community gatherings across Auckland." + }, + { + "eventName": "Auckland Marathon", + "dateFrom": "2027-10-31", + "dateTo": "2027-10-31", + "description": "New Zealand's largest marathon event featuring a scenic course across the Auckland Harbour Bridge with multiple distance options." + }, + { + "eventName": "Auckland Santa Parade", + "dateFrom": "2027-11-28", + "dateTo": "2027-11-28", + "description": "Auckland's beloved Christmas parade featuring floats, performances, and Santa Claus through the city centre." + }, + { + "eventName": "Synthony Festival", + "dateFrom": "2027-12-04", + "dateTo": "2027-12-04", + "description": "New Zealand's biggest one-day music festival at Auckland Domain featuring electronic dance music with a live orchestra." + }, + { + "eventName": "Auckland Heritage Festival", + "dateFrom": "2026-09-26", + "dateTo": "2026-10-11", + "description": "A celebration of Auckland's heritage with walks, talks, open days, and exhibitions exploring the city's history and architecture." + }, + { + "eventName": "Auckland Heritage Festival", + "dateFrom": "2027-09-25", + "dateTo": "2027-10-10", + "description": "A celebration of Auckland's heritage with walks, talks, open days, and exhibitions exploring the city's history and architecture." + }, + { + "eventName": "Splore Festival", + "dateFrom": "2027-02-19", + "dateTo": "2027-02-21", + "description": "A boutique music and arts festival at Tāpapakanga Regional Park featuring local and international artists, art installations, and workshops." } ], "Brisbane": [ @@ -143,6 +683,162 @@ "dateFrom": "2025-11-29", "dateTo": "2025-12-08", "description": "Showcasing the best cinema from the Asia Pacific region, including features, documentaries, and short films." + }, + { + "eventName": "Brisbane Comedy Festival", + "dateFrom": "2026-02-21", + "dateTo": "2026-03-23", + "description": "Five weeks of comedy across 4 venues with over 130 artists performing stand-up, sketch, and improv." + }, + { + "eventName": "World Science Festival Brisbane", + "dateFrom": "2026-03-20", + "dateTo": "2026-03-29", + "description": "The 11th World Science Festival Brisbane exploring life and the universe with talks, performances, and the Australian premiere of Bat Night Market from Taiwan." + }, + { + "eventName": "NRL Magic Round", + "dateFrom": "2026-05-14", + "dateTo": "2026-05-17", + "description": "A four-day festival of footy at Suncorp Stadium featuring all 8 NRL Round 11 matches and Women's State of Origin." + }, + { + "eventName": "Brisbane Festival", + "dateFrom": "2026-09-05", + "dateTo": "2026-09-26", + "description": "A major international arts festival featuring theatre, music, dance, and visual arts, launching with the spectacular Riverfire fireworks display." + }, + { + "eventName": "Brisbane Writers Festival", + "dateFrom": "2026-09-04", + "dateTo": "2026-09-07", + "description": "An annual literary festival celebrating books, writing, and ideas with author talks, panel discussions, and workshops." + }, + { + "eventName": "Brisbane International Film Festival", + "dateFrom": "2026-10-01", + "dateTo": "2026-10-11", + "description": "Showcasing a curated selection of films from around the world, including premieres and special events." + }, + { + "eventName": "Brisbane Asia Pacific Film Festival", + "dateFrom": "2026-11-28", + "dateTo": "2026-12-07", + "description": "Showcasing the best cinema from the Asia Pacific region, including features, documentaries, and short films." + }, + { + "eventName": "Riverfire", + "dateFrom": "2026-09-05", + "dateTo": "2026-09-05", + "description": "Brisbane's most iconic night as Foti Fireworks light up the skyline for a dazzling display launching Brisbane Festival." + }, + { + "eventName": "Brisbane Comedy Festival", + "dateFrom": "2027-02-20", + "dateTo": "2027-03-22", + "description": "Five weeks of comedy across 4 venues with over 130 artists performing stand-up, sketch, and improv." + }, + { + "eventName": "World Science Festival Brisbane", + "dateFrom": "2027-03-19", + "dateTo": "2027-03-28", + "description": "World Science Festival Brisbane exploring science, discovery, and wonder with talks, performances, and interactive experiences." + }, + { + "eventName": "NRL Magic Round", + "dateFrom": "2027-05-13", + "dateTo": "2027-05-16", + "description": "A four-day festival of footy at Suncorp Stadium featuring all NRL matches for the round." + }, + { + "eventName": "Brisbane Festival", + "dateFrom": "2027-09-04", + "dateTo": "2027-09-25", + "description": "A major international arts festival featuring theatre, music, dance, and visual arts, launching with the spectacular Riverfire fireworks display." + }, + { + "eventName": "Brisbane Writers Festival", + "dateFrom": "2027-09-03", + "dateTo": "2027-09-06", + "description": "An annual literary festival celebrating books, writing, and ideas with author talks, panel discussions, and workshops." + }, + { + "eventName": "Brisbane International Film Festival", + "dateFrom": "2027-09-30", + "dateTo": "2027-10-10", + "description": "Showcasing a curated selection of films from around the world, including premieres and special events." + }, + { + "eventName": "Brisbane Asia Pacific Film Festival", + "dateFrom": "2027-11-27", + "dateTo": "2027-12-06", + "description": "Showcasing the best cinema from the Asia Pacific region, including features, documentaries, and short films." + }, + { + "eventName": "Brisbane International Tennis", + "dateFrom": "2026-01-04", + "dateTo": "2026-01-11", + "description": "A premier ATP and WTA tennis tournament at Queensland Tennis Centre featuring world-class players in the lead-up to the Australian Open." + }, + { + "eventName": "Tour de Brisbane", + "dateFrom": "2026-04-19", + "dateTo": "2026-04-19", + "description": "A major cycling festival with various rides and races through Brisbane's streets, parks, and scenic routes." + }, + { + "eventName": "Brisbane Marathon Festival", + "dateFrom": "2026-06-07", + "dateTo": "2026-06-07", + "description": "A premier running event from Margaret Street to City Botanic Gardens, featuring distances from 2km to the full marathon." + }, + { + "eventName": "Abbey Medieval Festival", + "dateFrom": "2026-07-10", + "dateTo": "2026-07-12", + "description": "The 35th annual medieval festival at The Abbey Place, Caboolture, featuring jousting tournaments, reenactments, and medieval entertainment." + }, + { + "eventName": "Ekka - Royal Queensland Show", + "dateFrom": "2026-08-08", + "dateTo": "2026-08-16", + "description": "Queensland's largest annual event at Brisbane Showgrounds featuring agricultural displays, rides, showbags, food, and entertainment." + }, + { + "eventName": "Paniyiri Greek Festival", + "dateFrom": "2026-05-23", + "dateTo": "2026-05-24", + "description": "Australia's longest-running Greek Festival celebrating its 50th anniversary at Musgrave Park with food, music, and cultural performances." + }, + { + "eventName": "Brisbane International Tennis", + "dateFrom": "2027-01-03", + "dateTo": "2027-01-10", + "description": "A premier ATP and WTA tennis tournament at Queensland Tennis Centre featuring world-class players in the lead-up to the Australian Open." + }, + { + "eventName": "Tour de Brisbane", + "dateFrom": "2027-04-18", + "dateTo": "2027-04-18", + "description": "A major cycling festival with various rides and races through Brisbane's streets, parks, and scenic routes." + }, + { + "eventName": "Brisbane Marathon Festival", + "dateFrom": "2027-06-06", + "dateTo": "2027-06-06", + "description": "A premier running event from Margaret Street to City Botanic Gardens, featuring distances from 2km to the full marathon." + }, + { + "eventName": "Abbey Medieval Festival", + "dateFrom": "2027-07-09", + "dateTo": "2027-07-11", + "description": "The annual medieval festival at The Abbey Place, Caboolture, featuring jousting tournaments, reenactments, and medieval entertainment." + }, + { + "eventName": "Ekka - Royal Queensland Show", + "dateFrom": "2027-08-07", + "dateTo": "2027-08-15", + "description": "Queensland's largest annual event at Brisbane Showgrounds featuring agricultural displays, rides, showbags, food, and entertainment." } ], "Perth": [ @@ -159,7 +855,7 @@ "description": "One of the largest fringe festivals globally, featuring a vast array of performances including comedy, cabaret, theatre, and street arts." }, { - "eventName": "Sculpture by the Sea", + "eventName": "Sculpture by the Sea, Cottesloe", "dateFrom": "2025-03-06", "dateTo": "2025-03-23", "description": "An annual outdoor sculpture exhibition along Cottesloe Beach, showcasing works from Australian and international artists." @@ -175,6 +871,132 @@ "dateFrom": "2025-04-22", "dateTo": "2025-05-19", "description": "A month-long comedy festival featuring local and international comedians in stand-up, sketch, and improv performances." + }, + { + "eventName": "Fringe World Festival", + "dateFrom": "2026-01-21", + "dateTo": "2026-02-15", + "description": "The world's third-largest Fringe festival featuring comedy, cabaret, circus, music, theatre, and street arts across Perth venues including Fringe Town." + }, + { + "eventName": "Perth Festival", + "dateFrom": "2026-02-06", + "dateTo": "2026-03-01", + "description": "Australia's longest-running international arts festival showcasing Aboriginal culture, international premieres, and diverse arts programming." + }, + { + "eventName": "Sculpture by the Sea, Cottesloe", + "dateFrom": "2026-03-06", + "dateTo": "2026-03-23", + "description": "The 21st annual outdoor sculpture exhibition at Cottesloe Beach, featuring 70+ sculptures from Australian and international artists attracting 230,000 visitors." + }, + { + "eventName": "Perth Comedy Festival", + "dateFrom": "2026-04-21", + "dateTo": "2026-05-18", + "description": "A month-long comedy festival at the Astor Theatre and Mount Lawley venues featuring local and international comedians." + }, + { + "eventName": "Revelation Perth International Film Festival", + "dateFrom": "2026-07-02", + "dateTo": "2026-07-12", + "description": "A showcase of independent cinema, featuring a diverse selection of films, documentaries, and short films." + }, + { + "eventName": "Perth Royal Show", + "dateFrom": "2026-09-26", + "dateTo": "2026-10-03", + "description": "Western Australia's largest annual community event featuring agricultural displays, entertainment, carnival rides, and showbags." + }, + { + "eventName": "Fringe World Festival", + "dateFrom": "2027-01-20", + "dateTo": "2027-02-14", + "description": "The world's third-largest Fringe festival featuring comedy, cabaret, circus, music, theatre, and street arts across Perth venues." + }, + { + "eventName": "Perth Festival", + "dateFrom": "2027-02-05", + "dateTo": "2027-02-28", + "description": "Australia's longest-running international arts festival showcasing Aboriginal culture, international premieres, and diverse arts programming." + }, + { + "eventName": "Sculpture by the Sea, Cottesloe", + "dateFrom": "2027-03-05", + "dateTo": "2027-03-22", + "description": "The 22nd annual outdoor sculpture exhibition at Cottesloe Beach, featuring sculptures from Australian and international artists." + }, + { + "eventName": "Perth Comedy Festival", + "dateFrom": "2027-04-20", + "dateTo": "2027-05-17", + "description": "A month-long comedy festival at the Astor Theatre and Mount Lawley venues featuring local and international comedians." + }, + { + "eventName": "Revelation Perth International Film Festival", + "dateFrom": "2027-07-01", + "dateTo": "2027-07-11", + "description": "A showcase of independent cinema, featuring a diverse selection of films, documentaries, and short films." + }, + { + "eventName": "Perth Royal Show", + "dateFrom": "2027-09-25", + "dateTo": "2027-10-02", + "description": "Western Australia's largest annual community event featuring agricultural displays, entertainment, carnival rides, and showbags." + }, + { + "eventName": "Manjimup Truffle Festival", + "dateFrom": "2026-06-27", + "dateTo": "2026-06-28", + "description": "Celebrating Western Australia's prized black truffle at Fonty's Pool with truffle hunting, cooking demonstrations, and gourmet feasts." + }, + { + "eventName": "CinefestOZ Film Festival", + "dateFrom": "2026-08-26", + "dateTo": "2026-08-30", + "description": "Australia's premier destination film festival across Busselton, Margaret River, and Bunbury with premieres, Q&As, and Australia's richest film prize." + }, + { + "eventName": "Perth Craft Beer Festival", + "dateFrom": "2026-11-20", + "dateTo": "2026-11-21", + "description": "Western Australia's largest craft beer celebration featuring local and national breweries, food, and live entertainment." + }, + { + "eventName": "Perth Cup Day", + "dateFrom": "2027-01-01", + "dateTo": "2027-01-01", + "description": "New Year's Day racing at Ascot Racecourse featuring the Group 2 Perth Cup, La Trice Classic, and Summer Scorcher." + }, + { + "eventName": "Manjimup Truffle Festival", + "dateFrom": "2027-06-26", + "dateTo": "2027-06-27", + "description": "Celebrating Western Australia's prized black truffle at Fonty's Pool with truffle hunting, cooking demonstrations, and gourmet feasts." + }, + { + "eventName": "CinefestOZ Film Festival", + "dateFrom": "2027-08-25", + "dateTo": "2027-08-29", + "description": "Australia's premier destination film festival across Busselton, Margaret River, and Bunbury with premieres, Q&As, and Australia's richest film prize." + }, + { + "eventName": "Perth Craft Beer Festival", + "dateFrom": "2027-11-19", + "dateTo": "2027-11-20", + "description": "Western Australia's largest craft beer celebration featuring local and national breweries, food, and live entertainment." + }, + { + "eventName": "Christmas Pageant Perth", + "dateFrom": "2026-12-05", + "dateTo": "2026-12-05", + "description": "Perth's annual Christmas parade through the city centre with floats, performers, and Santa Claus." + }, + { + "eventName": "Christmas Pageant Perth", + "dateFrom": "2027-12-04", + "dateTo": "2027-12-04", + "description": "Perth's annual Christmas parade through the city centre with floats, performers, and Santa Claus." } ], "Adelaide": [ @@ -213,6 +1035,180 @@ "dateFrom": "2025-03-01", "dateTo": "2025-03-06", "description": "An annual literary festival featuring talks, panel discussions, and readings by acclaimed authors and thinkers." + }, + { + "eventName": "Adelaide Fringe", + "dateFrom": "2026-02-20", + "dateTo": "2026-03-22", + "description": "Australia's biggest arts festival and the world's second-largest Fringe, featuring 7,000+ artists and 1,300+ events across 31 days and nights." + }, + { + "eventName": "Adelaide Festival", + "dateFrom": "2026-02-28", + "dateTo": "2026-03-15", + "description": "A premier arts festival with the Adelaide Biennial of Australian Art, offering theatre, music, dance, and visual arts from renowned artists." + }, + { + "eventName": "Adelaide Writers' Week", + "dateFrom": "2026-02-28", + "dateTo": "2026-03-05", + "description": "An annual literary festival featuring talks, panel discussions, and readings by acclaimed authors and thinkers." + }, + { + "eventName": "WOMADelaide", + "dateFrom": "2026-03-06", + "dateTo": "2026-03-09", + "description": "A world music and dance festival in Botanic Park featuring international artists, workshops, and cultural experiences." + }, + { + "eventName": "SALA Festival", + "dateFrom": "2026-08-01", + "dateTo": "2026-08-31", + "description": "South Australia's largest visual arts festival, showcasing the work of local artists in exhibitions, workshops, and events." + }, + { + "eventName": "OzAsia Festival", + "dateFrom": "2026-09-24", + "dateTo": "2026-10-10", + "description": "A celebration of Asian arts and culture, featuring performances, exhibitions, and events from across the region." + }, + { + "eventName": "Adelaide Film Festival", + "dateFrom": "2026-10-15", + "dateTo": "2026-10-25", + "description": "Showcasing a diverse selection of Australian and international films, including features, documentaries, and shorts." + }, + { + "eventName": "Adelaide Cabaret Festival", + "dateFrom": "2026-06-05", + "dateTo": "2026-06-20", + "description": "The world's premier cabaret festival featuring international and local artists in intimate performances." + }, + { + "eventName": "Adelaide Fringe", + "dateFrom": "2027-02-19", + "dateTo": "2027-03-21", + "description": "Australia's biggest arts festival and the world's second-largest Fringe, featuring thousands of performances across various genres." + }, + { + "eventName": "Adelaide Festival", + "dateFrom": "2027-02-27", + "dateTo": "2027-03-14", + "description": "A premier arts festival offering theatre, music, dance, and visual arts from renowned international and local artists." + }, + { + "eventName": "Adelaide Writers' Week", + "dateFrom": "2027-02-27", + "dateTo": "2027-03-04", + "description": "An annual literary festival featuring talks, panel discussions, and readings by acclaimed authors and thinkers." + }, + { + "eventName": "WOMADelaide", + "dateFrom": "2027-03-05", + "dateTo": "2027-03-08", + "description": "A world music and dance festival in Botanic Park featuring international artists, workshops, and cultural experiences." + }, + { + "eventName": "SALA Festival", + "dateFrom": "2027-08-01", + "dateTo": "2027-08-31", + "description": "South Australia's largest visual arts festival, showcasing the work of local artists in exhibitions, workshops, and events." + }, + { + "eventName": "OzAsia Festival", + "dateFrom": "2027-09-23", + "dateTo": "2027-10-09", + "description": "A celebration of Asian arts and culture, featuring performances, exhibitions, and events from across the region." + }, + { + "eventName": "Adelaide Film Festival", + "dateFrom": "2027-10-14", + "dateTo": "2027-10-24", + "description": "Showcasing a diverse selection of Australian and international films, including features, documentaries, and shorts." + }, + { + "eventName": "Adelaide Cabaret Festival", + "dateFrom": "2027-06-04", + "dateTo": "2027-06-19", + "description": "The world's premier cabaret festival featuring international and local artists in intimate performances." + }, + { + "eventName": "Santos Tour Down Under", + "dateFrom": "2026-01-16", + "dateTo": "2026-01-25", + "description": "The UCI WorldTour season opener featuring the world's best cycling teams and the Festival of Cycling with street parties and live music." + }, + { + "eventName": "Laneway Festival Adelaide", + "dateFrom": "2026-02-06", + "dateTo": "2026-02-06", + "description": "A major music festival featuring top international and local indie artists including Chappell Roan, PinkPantheress, and more." + }, + { + "eventName": "Tasting Australia", + "dateFrom": "2026-04-24", + "dateTo": "2026-05-03", + "description": "A celebration of South Australian food and wine with masterclasses, dinners, and culinary experiences across the state." + }, + { + "eventName": "Adelaide Guitar Festival", + "dateFrom": "2026-05-07", + "dateTo": "2026-05-17", + "description": "The most significant celebration of the guitar in the southern hemisphere, featuring everything from country to classical." + }, + { + "eventName": "Feast Festival", + "dateFrom": "2026-11-01", + "dateTo": "2026-11-30", + "description": "Adelaide's LGBTQIA+ queer arts and cultural festival during Pridevember, celebrating diversity and inclusivity." + }, + { + "eventName": "Adelaide Christmas Pageant", + "dateFrom": "2026-11-14", + "dateTo": "2026-11-14", + "description": "Australia's largest Christmas pageant featuring elaborate floats, performers, and Father Christmas through Adelaide streets." + }, + { + "eventName": "Carols by Candlelight Adelaide", + "dateFrom": "2026-12-13", + "dateTo": "2026-12-13", + "description": "A festive community event at Elder Park featuring Christmas carols, performances, and fireworks." + }, + { + "eventName": "Santos Tour Down Under", + "dateFrom": "2027-01-15", + "dateTo": "2027-01-24", + "description": "The UCI WorldTour season opener featuring the world's best cycling teams and the Festival of Cycling with street parties and live music." + }, + { + "eventName": "Tasting Australia", + "dateFrom": "2027-04-23", + "dateTo": "2027-05-02", + "description": "A celebration of South Australian food and wine with masterclasses, dinners, and culinary experiences across the state." + }, + { + "eventName": "Adelaide Guitar Festival", + "dateFrom": "2027-05-06", + "dateTo": "2027-05-16", + "description": "The most significant celebration of the guitar in the southern hemisphere, featuring everything from country to classical." + }, + { + "eventName": "Feast Festival", + "dateFrom": "2027-11-01", + "dateTo": "2027-11-30", + "description": "Adelaide's LGBTQIA+ queer arts and cultural festival during Pridevember, celebrating diversity and inclusivity." + }, + { + "eventName": "Adelaide Christmas Pageant", + "dateFrom": "2027-11-13", + "dateTo": "2027-11-13", + "description": "Australia's largest Christmas pageant featuring elaborate floats, performers, and Father Christmas through Adelaide streets." + }, + { + "eventName": "Carols by Candlelight Adelaide", + "dateFrom": "2027-12-12", + "dateTo": "2027-12-12", + "description": "A festive community event at Elder Park featuring Christmas carols, performances, and fireworks." } ], "Wellington": [ @@ -220,15 +1216,13 @@ "eventName": "New Zealand Festival of the Arts", "dateFrom": "2025-02-21", "dateTo": "2025-03-15", - "description": "The nation's largest celebration of contemporary arts and culture, featuring a diverse range of performances and exhibitions across various venues in Wellington.", - "url": "https://www.festival.nz/" + "description": "The nation's largest celebration of contemporary arts and culture, featuring a diverse range of performances and exhibitions across various venues in Wellington." }, { "eventName": "Wellington Jazz Festival", "dateFrom": "2025-06-05", "dateTo": "2025-06-09", - "description": "A five-day festival showcasing local and international jazz musicians in concerts, workshops, and community events.", - "url": "https://www.jazzfestival.co.nz/" + "description": "A five-day festival showcasing local and international jazz musicians in concerts, workshops, and community events." }, { "eventName": "Wellington on a Plate", @@ -247,6 +1241,138 @@ "dateFrom": "2025-01-18", "dateTo": "2025-01-19", "description": "A celebration of Pacific Island culture with traditional performances, food stalls, and arts and crafts." + }, + { + "eventName": "Wellington Pasifika Festival", + "dateFrom": "2026-01-17", + "dateTo": "2026-01-18", + "description": "A celebration of Pacific Island culture with traditional performances, food stalls, and arts and crafts." + }, + { + "eventName": "New Zealand Festival of the Arts", + "dateFrom": "2026-02-24", + "dateTo": "2026-03-15", + "description": "Aotearoa New Zealand's largest celebration of contemporary arts and culture featuring diverse performances and exhibitions across Wellington." + }, + { + "eventName": "CubaDupa", + "dateFrom": "2026-03-28", + "dateTo": "2026-03-29", + "description": "New Zealand's largest free outdoor arts and music festival on Cuba Street, featuring local and international artists including the first international act from Melbourne." + }, + { + "eventName": "Wellington Jazz Festival", + "dateFrom": "2026-06-04", + "dateTo": "2026-06-08", + "description": "Over 100 gigs featuring soul, funk, jazz, fusion, and rhythm and blues from international and local talents." + }, + { + "eventName": "New Zealand International Film Festival - Wellington", + "dateFrom": "2026-08-13", + "dateTo": "2026-08-26", + "description": "A major film festival at the Embassy Theatre showcasing the best of international and local cinema." + }, + { + "eventName": "Wellington on a Plate", + "dateFrom": "2026-08-01", + "dateTo": "2026-08-16", + "description": "A culinary festival celebrating Wellington's food and beverage industry with special menus, events, and Beervana." + }, + { + "eventName": "World of Wearable Art Awards", + "dateFrom": "2026-09-24", + "dateTo": "2026-10-11", + "description": "A spectacular show celebrating wearable art with theatrical performances and cutting-edge designs from around the world." + }, + { + "eventName": "Wellington Pasifika Festival", + "dateFrom": "2027-01-16", + "dateTo": "2027-01-17", + "description": "A celebration of Pacific Island culture with traditional performances, food stalls, and arts and crafts." + }, + { + "eventName": "New Zealand Festival of the Arts", + "dateFrom": "2027-02-23", + "dateTo": "2027-03-14", + "description": "Aotearoa New Zealand's largest celebration of contemporary arts and culture featuring diverse performances and exhibitions across Wellington." + }, + { + "eventName": "CubaDupa", + "dateFrom": "2027-03-27", + "dateTo": "2027-03-28", + "description": "New Zealand's largest free outdoor arts and music festival on Cuba Street, featuring local and international artists." + }, + { + "eventName": "Wellington Jazz Festival", + "dateFrom": "2027-06-03", + "dateTo": "2027-06-07", + "description": "Over 100 gigs featuring soul, funk, jazz, fusion, and rhythm and blues from international and local talents." + }, + { + "eventName": "New Zealand International Film Festival - Wellington", + "dateFrom": "2027-08-12", + "dateTo": "2027-08-25", + "description": "A major film festival at the Embassy Theatre showcasing the best of international and local cinema." + }, + { + "eventName": "Wellington on a Plate", + "dateFrom": "2027-08-01", + "dateTo": "2027-08-15", + "description": "A culinary festival celebrating Wellington's food and beverage industry with special menus, events, and Beervana." + }, + { + "eventName": "World of Wearable Art Awards", + "dateFrom": "2027-09-23", + "dateTo": "2027-10-10", + "description": "A spectacular show celebrating wearable art with theatrical performances and cutting-edge designs from around the world." + }, + { + "eventName": "NZ International Comedy Festival - Wellington", + "dateFrom": "2026-04-27", + "dateTo": "2026-05-17", + "description": "Three weeks of comedy across Wellington venues featuring local and international comedians in stand-up, sketch, and improv." + }, + { + "eventName": "Wellington Wine and Food Festival", + "dateFrom": "2026-05-08", + "dateTo": "2026-05-10", + "description": "A celebration of Wellington's renowned food and wine scene with tastings, masterclasses, and culinary events." + }, + { + "eventName": "Wellington Christmas in the Quarters", + "dateFrom": "2026-11-28", + "dateTo": "2026-12-20", + "description": "Four weekends of Christmas magic across Wellington's quarters featuring markets, performances, and festive activities." + }, + { + "eventName": "Wellington New Year's Eve", + "dateFrom": "2026-12-31", + "dateTo": "2026-12-31", + "description": "Wellington's waterfront New Year's Eve celebrations with live music, entertainment, and fireworks at midnight." + }, + { + "eventName": "NZ International Comedy Festival - Wellington", + "dateFrom": "2027-04-26", + "dateTo": "2027-05-16", + "description": "Three weeks of comedy across Wellington venues featuring local and international comedians in stand-up, sketch, and improv." + }, + { + "eventName": "Wellington Wine and Food Festival", + "dateFrom": "2027-05-07", + "dateTo": "2027-05-09", + "description": "A celebration of Wellington's renowned food and wine scene with tastings, masterclasses, and culinary events." + }, + { + "eventName": "Wellington Christmas in the Quarters", + "dateFrom": "2027-11-27", + "dateTo": "2027-12-19", + "description": "Four weekends of Christmas magic across Wellington's quarters featuring markets, performances, and festive activities." + }, + { + "eventName": "Wellington New Year's Eve", + "dateFrom": "2027-12-31", + "dateTo": "2027-12-31", + "description": "Wellington's waterfront New Year's Eve celebrations with live music, entertainment, and fireworks at midnight." } ] - } \ No newline at end of file + } diff --git a/tools/find_events.py b/tools/find_events.py index 8aa579b..a0a3142 100644 --- a/tools/find_events.py +++ b/tools/find_events.py @@ -1,9 +1,21 @@ +import calendar import json from datetime import datetime from pathlib import Path +from typing import Any -def find_events(args: dict) -> dict: +def find_events(args: dict[str, Any]) -> dict[str, Any]: + """Find events that overlap with a given month in a specified city. + + Args: + args: Dictionary containing: + - city: City name to search for events (e.g., 'Melbourne') + - month: Month name to search (e.g., 'April') + + Returns: + Dictionary with 'events' list and 'note' with search context. + """ search_city = args.get("city", "").lower() search_month = args.get("month", "").capitalize() @@ -16,36 +28,33 @@ def find_events(args: dict) -> dict: except ValueError: return {"error": "Invalid month provided."} - # Helper to wrap months into [1..12] - def get_adjacent_months(m): - prev_m = 12 if m == 1 else (m - 1) - next_m = 1 if m == 12 else (m + 1) - return [prev_m, m, next_m] + # Determine the target year: use next upcoming occurrence of the month + today = datetime.now() + if month_number >= today.month: + target_year = today.year + else: + target_year = today.year + 1 - valid_months = get_adjacent_months(month_number) + # Build the search month date range + month_start = datetime(target_year, month_number, 1) + last_day = calendar.monthrange(target_year, month_number)[1] + month_end = datetime(target_year, month_number, last_day) matching_events = [] - for city_name, events in json.load(open(file_path)).items(): + with open(file_path) as f: + data = json.load(f) + + for city_name, events in data.items(): if search_city and search_city not in city_name.lower(): continue for event in events: - date_from = datetime.strptime(event["dateFrom"], "%Y-%m-%d") - date_to = datetime.strptime(event["dateTo"], "%Y-%m-%d") - - # If the event's start or end month is in our valid months - if date_from.month in valid_months or date_to.month in valid_months: - # Add metadata explaining how it matches - if date_from.month == month_number or date_to.month == month_number: - month_context = "requested month" - elif ( - date_from.month == valid_months[0] - or date_to.month == valid_months[0] - ): - month_context = "previous month" - else: - month_context = "next month" + event_start = datetime.strptime(event["dateFrom"], "%Y-%m-%d") + event_end = datetime.strptime(event["dateTo"], "%Y-%m-%d") + # Check if the event overlaps with the search month + # Two date ranges overlap if: start1 <= end2 AND start2 <= end1 + if month_start <= event_end and event_start <= month_end: matching_events.append( { "city": city_name, @@ -53,12 +62,10 @@ def find_events(args: dict) -> dict: "dateFrom": event["dateFrom"], "dateTo": event["dateTo"], "description": event["description"], - "month": month_context, } ) - # Add top-level metadata if you wish return { - "note": f"Returning events from {search_month} plus one month either side (i.e., {', '.join(datetime(2025, m, 1).strftime('%B') for m in valid_months)}).", + "note": f"Returning events that overlap with {search_month} {target_year}.", "events": matching_events, } diff --git a/tools/tool_registry.py b/tools/tool_registry.py index 478c431..c81d695 100644 --- a/tools/tool_registry.py +++ b/tools/tool_registry.py @@ -180,10 +180,9 @@ search_fixtures_tool = ToolDefinition( find_events_tool = ToolDefinition( name="FindEvents", - description="Find upcoming events to travel to a given city (e.g., 'Melbourne') and a date or month. " + description="Find upcoming events to travel to a given city (e.g., 'Melbourne') and a month. " "It knows about events in Oceania only (e.g. major Australian and New Zealand cities). " - "It will search 1 month either side of the month provided. " - "Returns a list of events. ", + "Returns events that overlap with the specified month. ", arguments=[ ToolArgument( name="city", @@ -193,7 +192,7 @@ find_events_tool = ToolDefinition( ToolArgument( name="month", type="string", - description="The month to search for events (will search 1 month either side of the month provided)", + description="The month to search for events (e.g., 'April')", ), ], )