squirrels 0.5.0b2__tar.gz → 0.5.0b4__tar.gz

{squirrels-0.5.0b2 → squirrels-0.5.0b4}/.gitignore

@@ -1,7 +1,8 @@
 sandbox*
 playground*
 site/
-.venv/ 
+.venv/
+TODOS.md
 
 # pyenv files
 .python-version

{squirrels-0.5.0b2 → squirrels-0.5.0b4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: squirrels
-Version: 0.5.0b2
+Version: 0.5.0b4
 Summary: Squirrels - API Framework for Data Analytics
 Project-URL: Homepage, https://squirrels-analytics.github.io
 Project-URL: Repository, https://github.com/squirrels-analytics/squirrels
@@ -13,15 +13,18 @@ Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
 Requires-Python: ~=3.10
+Requires-Dist: authlib<2,>=1.5.2
 Requires-Dist: bcrypt<5,>=4.0.1
 Requires-Dist: cachetools<6,>=5.3.2
 Requires-Dist: duckdb<2,>=1.1.3
 Requires-Dist: fastapi<1,>=0.112.1
 Requires-Dist: gitpython<4,>=3.1.41
 Requires-Dist: inquirer<4,>=3.2.1
+Requires-Dist: itsdangerous<3,>=2.2.0
 Requires-Dist: jinja2<4,>=3.1.3
 Requires-Dist: libpass<2,>=1.9.0
 Requires-Dist: matplotlib<4,>=3.8.3
+Requires-Dist: mcp>=1.9.2
 Requires-Dist: networkx<4,>=3.2.1
 Requires-Dist: pandas<3,>=2.1.4
 Requires-Dist: polars<2,>=1.14.0

squirrels-0.5.0b4/dateutils/__init__.py

@@ -0,0 +1,6 @@
+from ._enums import DayOfWeekEnum, MonthEnum
+from ._implementation import (
+    DayIdxOfMonthsCycle, DayIdxOfYear, DayIdxOfQuarter, DayIdxOfMonth, DayIdxOfWeek,
+    OffsetYears, OffsetMonths, OffsetWeeks, OffsetDays,
+    DateModPipeline, DateStringModifier, TimestampModifier
+)

squirrels-0.5.0b4/dateutils/_enums.py

@@ -0,0 +1,25 @@
+from enum import Enum
+
+
+class DayOfWeekEnum(Enum):
+    Sunday = 0
+    Monday = 1
+    Tuesday = 2
+    Wednesday = 3
+    Thursday = 4
+    Friday = 5
+    Saturday = 6
+
+class MonthEnum(Enum):
+    January = 1
+    February = 2
+    March = 3
+    April = 4
+    May = 5
+    June = 6
+    July = 7
+    August = 8
+    September = 9
+    October = 10
+    November = 11
+    December = 12

squirrels-0.5.0b2/dateutils/__init__.py → squirrels-0.5.0b4/dateutils/_implementation.py

@@ -3,31 +3,8 @@ from dataclasses import dataclass
 from datetime import date as Date, datetime
 from dateutil.relativedelta import relativedelta
 from abc import ABCMeta, abstractmethod
-from enum import Enum
-
-
-class DayOfWeek(Enum):
-    Sunday = 0
-    Monday = 1
-    Tuesday = 2
-    Wednesday = 3
-    Thursday = 4
-    Friday = 5
-    Saturday = 6
-
-class Month(Enum):
-    January = 1
-    February = 2
-    March = 3
-    April = 4
-    May = 5
-    June = 6
-    July = 7
-    August = 8
-    September = 9
-    October = 10
-    November = 11
-    December = 12
+
+from ._enums import DayOfWeekEnum, MonthEnum
 
 
 class DateModifier(metaclass=ABCMeta):
@@ -52,20 +29,21 @@ class DateModifier(metaclass=ABCMeta):
         return datetype(year, month, day)
 
 
-class _DayIdxOfCalendarUnit(DateModifier):
+@dataclass
+class DayIdxOfCalendarUnit(DateModifier):
     """
     Interface for adjusting a date to some day of calendar unit
     """
-    def __init__(self, idx: int) -> None:
-        super().__init__()
-        self.idx = idx
+    idx: int
+
+    def __post_init__(self) -> None:
         if self.idx == 0:
             raise ValueError(f"For constructors of class names that start with DayIdxOf_, idx cannot be zero")
         self.incr = self.idx - 1 if self.idx > 0 else self.idx
 
 
 @dataclass
-class DayIdxOfMonthsCycle(_DayIdxOfCalendarUnit):
+class DayIdxOfMonthsCycle(DayIdxOfCalendarUnit):
     """
     DateModifier class to get the idx-th day of a cycle of months for an input date
 
@@ -74,23 +52,21 @@ class DayIdxOfMonthsCycle(_DayIdxOfCalendarUnit):
         num_months_in_cycle: 2 for one 6th of year, 3 for Quarter, 4 for one 3rd of year, 6 for half year, 12 for full year. Must fit evenly in 12
         first_month_of_cycle: The first month of months cycle of year. Default is January
     """
-    _num_months_in_cycle: int
-    _first_month_of_cycle: Month
+    num_months_in_cycle: int
+    first_month_of_cycle: MonthEnum = MonthEnum.January
 
-    def __init__(self, idx: int, num_months_in_cycle: int, first_month_of_cycle: Month = Month.January) -> None:
-        super().__init__(idx)
-        self._num_months_in_cycle = num_months_in_cycle
-        self._first_month_of_cycle = first_month_of_cycle
-        if 12 % self._num_months_in_cycle != 0:
-            raise ValueError(f"Value X must fit evenly in 12")
-        self.first_month_of_first_cycle = (self._first_month_of_cycle.value - 1) % self._num_months_in_cycle + 1
+    def __post_init__(self) -> None:
+        super().__post_init__()
+        if 12 % self.num_months_in_cycle != 0:
+            raise ValueError(f"Argument 'num_months_in_cycle' must fit evenly in 12")
+        self.first_month_of_first_cycle = (self.first_month_of_cycle.value - 1) % self.num_months_in_cycle + 1
 
     def modify(self, date: Date) -> Date:
-        current_cycle = (date.month - self.first_month_of_first_cycle) % 12 // self._num_months_in_cycle
-        first_month_of_curr_cycle = current_cycle * self._num_months_in_cycle + self.first_month_of_first_cycle
+        current_cycle = (date.month - self.first_month_of_first_cycle) % 12 // self.num_months_in_cycle
+        first_month_of_curr_cycle = current_cycle * self.num_months_in_cycle + self.first_month_of_first_cycle
         year = date.year if date.month >= first_month_of_curr_cycle else date.year - 1
         first_day = self._get_date(type(date), year, first_month_of_curr_cycle, 1)
-        ref_date = first_day if self.idx > 0 else first_day + relativedelta(months=self._num_months_in_cycle)
+        ref_date = first_day if self.idx > 0 else first_day + relativedelta(months=self.num_months_in_cycle)
         return ref_date + relativedelta(days=self.incr)
 
 
@@ -104,7 +80,7 @@ class DayIdxOfYear(DayIdxOfMonthsCycle):
         first_month_of_year: The first month of year. Default is January
     """
 
-    def __init__(self, idx: int, first_month_of_year: Month = Month.January):
+    def __init__(self, idx: int, first_month_of_year: MonthEnum = MonthEnum.January):
         super().__init__(idx, num_months_in_cycle=12, first_month_of_cycle=first_month_of_year)
 
 
@@ -118,12 +94,12 @@ class DayIdxOfQuarter(DayIdxOfMonthsCycle):
         first_month_of_quarter: The first month of first quarter. Default is January
     """
 
-    def __init__(self, idx: int, first_month_of_quarter: Month = Month.January):
+    def __init__(self, idx: int, first_month_of_quarter: MonthEnum = MonthEnum.January):
         super().__init__(idx, num_months_in_cycle=3, first_month_of_cycle=first_month_of_quarter)
 
 
 @dataclass
-class DayIdxOfMonth(_DayIdxOfCalendarUnit):
+class DayIdxOfMonth(DayIdxOfCalendarUnit):
     """
     DateModifier class to get the idx-th day of month of an input date
 
@@ -131,9 +107,6 @@ class DayIdxOfMonth(_DayIdxOfCalendarUnit):
         idx: 1 for first, 2 for second, etc. Or, -1 for last, -2 for second last, etc. Must not be 0
     """
 
-    def __init__(self, idx: int) -> None:
-        super().__init__(idx)
-
     def modify(self, date: Date) -> Date:
         first_day = self._get_date(type(date), date.year, date.month, 1)
         ref_date = first_day if self.idx > 0 else first_day + relativedelta(months=1)
@@ -141,7 +114,7 @@ class DayIdxOfMonth(_DayIdxOfCalendarUnit):
 
 
 @dataclass
-class DayIdxOfWeek(_DayIdxOfCalendarUnit):
+class DayIdxOfWeek(DayIdxOfCalendarUnit):
     """
     DateModifier class to get the idx-th day of week of an input date
 
@@ -149,12 +122,11 @@ class DayIdxOfWeek(_DayIdxOfCalendarUnit):
         idx: 1 for first, 2 for second, etc. Or, -1 for last, -2 for second last, etc. Must not be 0
         first_day_of_week: The day of week identified as the "first". Default is Monday
     """
-    _first_day_of_week: DayOfWeek
+    first_day_of_week: DayOfWeekEnum = DayOfWeekEnum.Monday
 
-    def __init__(self, idx: int, first_day_of_week: DayOfWeek = DayOfWeek.Monday) -> None:
-        super().__init__(idx)
-        self._first_day_of_week = first_day_of_week
-        self.first_dow_num = self._first_day_of_week.value
+    def __post_init__(self) -> None:
+        super().__post_init__()
+        self.first_dow_num = self.first_day_of_week.value
     
     def modify(self, date: Date) -> Date:
         distance_from_first_day = (1 + date.weekday() - self.first_dow_num) % 7
@@ -162,17 +134,16 @@ class DayIdxOfWeek(_DayIdxOfCalendarUnit):
         return date + relativedelta(days=total_incr)
 
 
-class _OffsetUnits(DateModifier):
+@dataclass
+class OffsetUnits(DateModifier):
     """
     Abstract DateModifier class to offset an input date by some number of some calendar unit
     """
-    def __init__(self, offset: int) -> None:
-        super().__init__()
-        self.offset = offset
+    offset: int
 
 
 @dataclass
-class OffsetYears(_OffsetUnits):
+class OffsetYears(OffsetUnits):
     """
     DateModifier class to offset an input date by some number of years
 
@@ -180,15 +151,12 @@ class OffsetYears(_OffsetUnits):
         offset: The number of years to offset the input date.
     """
 
-    def __init__(self, offset: int) -> None:
-        super().__init__(offset)
-
     def modify(self, date: Date) -> Date:
         return date + relativedelta(years=self.offset)
     
 
 @dataclass
-class OffsetMonths(_OffsetUnits):
+class OffsetMonths(OffsetUnits):
     """
     DateModifier class to offset an input date by some number of months
 
@@ -196,15 +164,12 @@ class OffsetMonths(_OffsetUnits):
         offset: The number of months to offset the input date.
     """
 
-    def __init__(self, offset: int) -> None:
-        super().__init__(offset)
-
     def modify(self, date: Date) -> Date:
         return date + relativedelta(months=self.offset)
 
 
 @dataclass
-class OffsetWeeks(_OffsetUnits):
+class OffsetWeeks(OffsetUnits):
     """
     DateModifier class to offset an input date by some number of weeks
 
@@ -212,15 +177,12 @@ class OffsetWeeks(_OffsetUnits):
         offset: The number of weeks to offset the input date.
     """
 
-    def __init__(self, offset: int) -> None:
-        super().__init__(offset)
-
     def modify(self, date: Date) -> Date:
         return date + relativedelta(weeks=self.offset)
 
 
 @dataclass
-class OffsetDays(_OffsetUnits):
+class OffsetDays(OffsetUnits):
     """
     DateModifier class to offset an input date by some number of days
 
@@ -228,9 +190,6 @@ class OffsetDays(_OffsetUnits):
         offset: The number of days to offset the input date.
     """
 
-    def __init__(self, offset: int) -> None:
-        super().__init__(offset)
-
     def modify(self, date: Date) -> Date:
         return date + relativedelta(days=self.offset)
 
@@ -243,14 +202,10 @@ class DateModPipeline(DateModifier):
     Attributes:
         modifiers: The list of DateModifier's to apply in sequence.
     """
-    _date_modifiers: Sequence[DateModifier]
+    date_modifiers: Sequence[DateModifier]
 
-    def __init__(self, date_modifiers: Sequence[DateModifier]) -> None:
-        super().__init__()
-        self._date_modifiers = tuple(date_modifiers)
-    
     def modify(self, date: Date) -> Date:
-        for modifier in self._date_modifiers:
+        for modifier in self.date_modifiers:
             date = modifier.modify(date)
         return date
     
@@ -265,7 +220,7 @@ class DateModPipeline(DateModifier):
         Returns:
             A new sequence of DateModifier
         """
-        joined_modifiers = tuple(self._date_modifiers) + tuple(date_modifiers)
+        joined_modifiers = tuple(self.date_modifiers) + tuple(date_modifiers)
         return joined_modifiers
 
     def with_more_modifiers(self, date_modifiers: Sequence[DateModifier]):
@@ -298,7 +253,7 @@ class DateModPipeline(DateModifier):
         Returns:
             A list of datetime objects
         """
-        assert isinstance(step, _OffsetUnits)
+        assert isinstance(step, OffsetUnits)
         if step.offset == 0:
             raise ValueError(f"The length of 'step' must not be zero")
         
@@ -313,12 +268,15 @@ class DateModPipeline(DateModifier):
         return output
 
 
-class _DateRepresentationModifier(metaclass=ABCMeta):
+@dataclass
+class DateRepresentationModifier(metaclass=ABCMeta):
     """
     Abstract class for modifying other representations of dates (such as string or unix timestemp)
     """
-    def __init__(self, date_modifiers: Sequence[DateModifier]):
-        self.date_modifier = DateModPipeline(date_modifiers)
+    date_modifiers: Sequence[DateModifier]
+
+    def __post_init__(self) -> None:
+        self.date_mod_pipeline = DateModPipeline(self.date_modifiers)
 
     @abstractmethod
     def with_more_modifiers(self, date_modifiers: Sequence[DateModifier]):
@@ -326,7 +284,7 @@ class _DateRepresentationModifier(metaclass=ABCMeta):
 
 
 @dataclass
-class DateStringModifier(_DateRepresentationModifier):
+class DateStringModifier(DateRepresentationModifier):
     """
     Class to modify a string representation of a date given a DateModifier
 
@@ -334,12 +292,7 @@ class DateStringModifier(_DateRepresentationModifier):
         date_modifier: The DateModifier to apply on datetime objects
         date_format: Format of the output date string. Default is '%Y-%m-%d'
     """
-    _date_modifiers: Sequence[DateModifier]
-    _date_format: str
-
-    def __init__(self, date_modifiers: Sequence[DateModifier], date_format: str = '%Y-%m-%d'):
-        super().__init__(date_modifiers)
-        self._date_format = date_format
+    date_format: str = '%Y-%m-%d'
 
     def with_more_modifiers(self, date_modifiers: Sequence[DateModifier]):
         """
@@ -351,11 +304,11 @@ class DateStringModifier(_DateRepresentationModifier):
         Returns:
             A new DateStringModifier
         """
-        joined_modifiers = self.date_modifier.get_joined_modifiers(date_modifiers)
-        return DateStringModifier(joined_modifiers, self._date_format)
+        joined_modifiers = self.date_mod_pipeline.get_joined_modifiers(date_modifiers)
+        return DateStringModifier(joined_modifiers, self.date_format)
     
     def _get_input_date_obj(self, date_str: str, input_format: str | None = None) -> Date:
-        input_format = self._date_format if input_format is None else input_format
+        input_format = self.date_format if input_format is None else input_format
         return datetime.strptime(date_str, input_format).date()
 
     def modify(self, date_str: str, input_format: str | None = None) -> str:
@@ -370,7 +323,7 @@ class DateStringModifier(_DateRepresentationModifier):
             The resulting date string
         """
         date_obj = self._get_input_date_obj(date_str, input_format)
-        return self.date_modifier.modify(date_obj).strftime(self._date_format)
+        return self.date_mod_pipeline.modify(date_obj).strftime(self.date_format)
     
     def get_date_list(self, start_date_str: str, step: DateModifier, input_format: str | None = None) -> Sequence[str]:
         """
@@ -390,14 +343,14 @@ class DateStringModifier(_DateRepresentationModifier):
         Returns:
             A list of date strings
         """
-        assert isinstance(step, _OffsetUnits)
+        assert isinstance(step, OffsetUnits)
         curr_date = self._get_input_date_obj(start_date_str, input_format)
-        output = self.date_modifier.get_date_list(curr_date, step)
-        return [x.strftime(self._date_format) for x in output]
+        output = self.date_mod_pipeline.get_date_list(curr_date, step)
+        return [x.strftime(self.date_format) for x in output]
 
 
 @dataclass
-class TimestampModifier(_DateRepresentationModifier):
+class TimestampModifier(DateRepresentationModifier):
     """
     Class to modify a numeric representation of a date (as Unix/Epoch/POSIX timestamp) given a DateModifier
 
@@ -405,10 +358,6 @@ class TimestampModifier(_DateRepresentationModifier):
         date_modifier: The DateModifier to apply on datetime objects
         date_format: Format of the date string. Default is '%Y-%m-%d'
     """
-    _date_modifiers: Sequence[DateModifier]
-
-    def __init__(self, date_modifiers: Sequence[DateModifier]):
-        super().__init__(date_modifiers)
 
     def with_more_modifiers(self, date_modifiers: Sequence[DateModifier]):
         """
@@ -420,7 +369,7 @@ class TimestampModifier(_DateRepresentationModifier):
         Returns:
             A new TimestampModifier
         """
-        joined_modifiers = self.date_modifier.get_joined_modifiers(date_modifiers)
+        joined_modifiers = self.date_mod_pipeline.get_joined_modifiers(date_modifiers)
         return TimestampModifier(joined_modifiers)
 
     def modify(self, timestamp: float) -> float:
@@ -434,7 +383,7 @@ class TimestampModifier(_DateRepresentationModifier):
             The resulting timestamp
         """
         date_obj = datetime.fromtimestamp(timestamp).date()
-        modified_date = self.date_modifier.modify(date_obj)
+        modified_date = self.date_mod_pipeline.modify(date_obj)
         modified_datetime = datetime.combine(modified_date, datetime.min.time())
         return modified_datetime.timestamp()
     
@@ -456,5 +405,5 @@ class TimestampModifier(_DateRepresentationModifier):
             A list of timestamp as floats
         """
         curr_date = datetime.fromtimestamp(start_timestamp).date()
-        output = self.date_modifier.get_date_list(curr_date, step)
+        output = self.date_mod_pipeline.get_date_list(curr_date, step)
         return [datetime.combine(x, datetime.min.time()).timestamp() for x in output]

squirrels-0.5.0b4/dateutils/types.py

@@ -0,0 +1,6 @@
+from ._implementation import (
+    DateModifier,
+    DayIdxOfCalendarUnit,
+    OffsetUnits,
+    DateRepresentationModifier
+)

{squirrels-0.5.0b2 → squirrels-0.5.0b4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "squirrels"
-version = "0.5.0b2"
+version = "0.5.0b4"
 description = "Squirrels - API Framework for Data Analytics"
 authors = [{ name = "Tim Huang", email = "tim.yuting@hotmail.com" }]
 requires-python = "~=3.10"
@@ -34,6 +34,9 @@ dependencies = [
     "bcrypt>=4.0.1,<5",
     "python-dotenv>=1.0.1,<2",
     "libpass>=1.9.0,<2",
+    "authlib>=1.5.2,<2",
+    "itsdangerous>=2.2.0,<3",
+    "mcp>=1.9.2",
 ]
 
 [project.urls]

squirrels-0.5.0b4/squirrels/__init__.py

@@ -0,0 +1,19 @@
+from ._version import __version__
+
+from .arguments import *
+
+from .auth import *
+
+from .connections import *
+
+from .parameter_options import *
+
+from .parameters import *
+
+from .data_sources import *
+
+from .dashboards import *
+
+from .types import *
+
+from ._project import SquirrelsProject

squirrels-0.5.0b4/squirrels/_api_routes/__init__.py

@@ -0,0 +1,5 @@
+"""
+API Routes Package
+
+This package contains modular route definitions for the Squirrels API server.
+"""