Add get_long_weekends() function to find holiday-based long weekends

[Anupam11421]

Feature description

I'd like to suggest a new feature: a utility function named get_long_weekends().

This function will help users easily find long weekends in a specific year and country by:

• Checking for holidays that fall on a Friday or a Monday.
• Combining them with adjacent weekends to return a list of long weekends.
• Optionally, it can also suggest "potential" long weekends (e.g. if a holiday falls on Thursday or Tuesday and a user can take an extra day off).

Use case

This can be useful for users who want to plan vacations or breaks in advance. Especially helpful for travel planning, HR teams, and people managing calendars based on public holidays.

Additional context

I'm currently going through the codebase and would love to implement this as part of my GSoC 2025 journey. I've already contributed once and would love to take this up with proper testing and documentation.

Let me know if it sounds good — I can create a PR once it's approved.

Thanks!

— Anupam Tiwari

[KJhellico]

@Anupam11421, try it. I really hope you know what to do...

[Anupam11421]

Thanks a lot @KJhellico for assigning this to me! 🙏
I've already explored the project structure and gone through how holiday rules are applied across different countries.

I'll start working on the get_long_weekends() function by analyzing existing holiday datasets and creating a clean, efficient function that identifies holiday-based long weekends.

I'll make sure the code is well-documented and tested.
If I face any blockers, I’ll ask here and ensure I follow the project’s standards.

Excited to contribute and give my best 🚀

[AryaPhansalkar]

Can you please assign this issue to me