How obilet/cosmocalendar works
Project type and purpose
• This is an Android UI component library (CosmoCalendar) plus a sample Android app demonstrating its usage.
• Purpose: Provide a highly customizable calendar view with various selection modes, holiday pins, and styling options.
File structure
• Top-level Gradle projects:
• cosmocalendar/ (library module)
• sample/ (demo application module)
• Key packages in the library:
• adapter & viewholder – RecyclerView adapters for month/day cells
• view – Custom views (CalendarView, MonthView, DayView)
• model – Data models (Day, Month, DayOfWeek)
• selection – Selection logic (Single, Multiple, Range, None)
• settings – Appearance and behavior settings
• utils – Date utilities, ID generators, snap helpers
• There is an AsyncTask (FetchMonthsAsyncTask) that internally generates the Month/Day data.
• Resources under res/ provide layouts, drawables, styles, and attributes.
README for additional insights
• Selection types & listeners (Observer pattern).
• Dialog wrapper around CalendarView (CalendarDialog).
• The sample app shows integration points and API usage.
a. Main components
• Sample App Module
• CosmoCalendar Library Module
– CalendarView (entry point)
– CalendarDialog
– Adapters & ViewHolders
– SelectionManagers (Single, Multiple, Range, None)
– SettingsManager & Appearance/Date/List/Selection Models
– DataGenerator (FetchMonthsAsyncTask)
– Utility classes
– Android Resources (layouts, drawables, attrs)
• Android Framework (RecyclerView, View system, Attributes)
b. Relationships & interactions
– Sample App → depends on → Library Module (Gradle dependency)
– CalendarView → uses → MonthAdapter → binds → MonthHolder/DayHolder → displays Day model
– CalendarView → triggers → FetchMonthsAsyncTask → produces → Month/Day data
– CalendarView → delegates selection events → SelectionManager → updates SelectionState → notifies → DateSelectedListener / OnDaysSelectionListener
– SettingsManager → supplies appearance/configuration to CalendarView & Adapters
– CalendarDialog → wraps CalendarView + exposes OnDaysSelectionListener
– Utility classes → support date calculations & snap behavior for RecyclerView
c. Architectural patterns & design principles
– Adapter pattern (RecyclerView Adapters & ViewHolders)
– Strategy pattern (SelectionManager implementations for SINGLE, MULTIPLE, RANGE, NONE)
– Observer/listener pattern (date‐selected, month‐change listeners)
– Separation of concerns:
• UI layer (views, adapters)
• Business logic (selection, settings)
• Data layer (models, AsyncTask)
• Utilities (shared helpers)
d. Key technologies & libraries
– Java, Android SDK
– AndroidX RecyclerView
– AsyncTask (for data generation)
– Custom attributes in attrs.xml
– Gradle build system
Detailed capture of essential architectural elements
• How SettingsManager configures both CalendarView & SelectionManagers
• Adapter/viewholder chain for rendering each month/day
• Demonstrate where resources (layouts, drawables, attrs) fit into view inflation