squirrels 0.4.0__py3-none-any.whl → 0.5.0b1__py3-none-any.whl

squirrels/parameters.py

@@ -6,7 +6,7 @@ from decimal import Decimal
 from abc import ABCMeta, abstractmethod
 
 from . import _parameter_configs as _pc, _parameter_sets as ps, parameter_options as _po, data_sources as d
-from . import _api_response_models as arm, _utils as _u
+from . import _api_response_models as arm, _utils as u
 
 IntOrFloat = TypeVar("IntOrFloat", int, float)
 
@@ -112,13 +112,13 @@ class Parameter(metaclass=ABCMeta):
         
         try:
             return curr_option._validate_date(input_date)
-        except _u.ConfigurationError as e:
+        except u.ConfigurationError as e:
             raise self._config._invalid_input_error(str(input_date), str(e))
     
     def _validate_number(self, input_number: _po.Number, curr_option: _po._NumericParameterOption) -> Decimal:
         try:
             return curr_option._validate_value(input_number)
-        except _u.ConfigurationError as e:
+        except u.ConfigurationError as e:
             raise self._config._invalid_input_error(str(input_number), str(e))
     
     @abstractmethod
@@ -127,7 +127,7 @@ class Parameter(metaclass=ABCMeta):
         Helper method to convert the derived Parameter class into a JSON dictionary
         """
         output = {
-            "widget_type": self._config.widget_type, "name": self._config.name, 
+            "widget_type": self._config.widget_type(), "name": self._config.name, 
             "label": self._config.label, "description": self._config.description
         }
         if not self.is_enabled():
@@ -234,7 +234,7 @@ class SingleSelectParameter(_SelectionParameter):
             if field is not None:
                 selected = selected.get_custom_field(field, default_field=default_field, default=default)
             return selected
-        return _u.process_if_not_none(self._selected_id, get_selected_from_id)
+        return u.process_if_not_none(self._selected_id, get_selected_from_id)
     
     def get_selected_quoted(self, field: str, *, default_field: str | None = None, default: str | None = None, **kwargs) -> str | None:
         """
@@ -254,12 +254,12 @@ class SingleSelectParameter(_SelectionParameter):
         
         def _enquote(x: Any) -> str:
             if not isinstance(selected_value, str):
-                raise _u.ConfigurationError(
+                raise u.ConfigurationError(
                     f"Method 'get_selected_quoted' can only be used on fields with only string values"
                 )
             return self._enquote(x)
         
-        return _u.process_if_not_none(selected_value, _enquote)
+        return u.process_if_not_none(selected_value, _enquote)
     
     def get_selected_id(self, **kwargs) -> str | None:
         """
@@ -270,7 +270,7 @@ class SingleSelectParameter(_SelectionParameter):
         """
         def get_id(x: _po.SelectParameterOption): 
             return x._identifier
-        return _u.process_if_not_none(self.get_selected(), get_id)
+        return u.process_if_not_none(self.get_selected(), get_id)
     
     def get_selected_id_quoted(self, **kwargs) -> str | None:
         """
@@ -279,7 +279,7 @@ class SingleSelectParameter(_SelectionParameter):
         Returns:
             A string or None if there are no selectable options
         """
-        return _u.process_if_not_none(self.get_selected_id(), self._enquote)
+        return u.process_if_not_none(self.get_selected_id(), self._enquote)
     
     def get_selected_label(self, **kwargs) -> str | None:
         """
@@ -289,7 +289,7 @@ class SingleSelectParameter(_SelectionParameter):
             A string or None if there are no selectable options
         """
         def get_label(x: _po.SelectParameterOption): return x._label
-        return _u.process_if_not_none(self.get_selected(), get_label)
+        return u.process_if_not_none(self.get_selected(), get_label)
     
     def get_selected_label_quoted(self, **kwargs) -> str | None:
         """
@@ -298,7 +298,7 @@ class SingleSelectParameter(_SelectionParameter):
         Returns:
             A string or None if there are no selectable options
         """
-        return _u.process_if_not_none(self.get_selected_label(), self._enquote)
+        return u.process_if_not_none(self.get_selected_label(), self._enquote)
 
     def _get_selected_ids_as_list(self) -> Sequence[str]:
         selected_id = self.get_selected_id()
@@ -480,7 +480,7 @@ class MultiSelectParameter(_SelectionParameter):
         list_of_strings: list[str] = []
         for selected in selected_list:
             if not isinstance(selected, str):
-                raise _u.ConfigurationError(
+                raise u.ConfigurationError(
                     f"Method '{method}' can only be used on fields with only string values"
                 )
             list_of_strings.append(selected)
@@ -1041,7 +1041,7 @@ class TextValue:
     _value_do_not_touch: str
 
     def __repr__(self):
-        raise _u.ConfigurationError(
+        raise u.ConfigurationError(
             "Cannot convert TextValue directly to string (to avoid SQL injection). Try using it through placeholders instead"
         )
 
@@ -1059,7 +1059,7 @@ class TextValue:
         """
         new_value = str_to_str_function(self._value_do_not_touch)
         if not isinstance(new_value, str):
-            raise _u.ConfigurationError("Function provided must return string")
+            raise u.ConfigurationError("Function provided must return string")
         return TextValue(new_value)
     
     def apply_percent_wrap(self) -> TextValue:
@@ -1083,7 +1083,7 @@ class TextValue:
         """
         new_value = str_to_bool_function(self._value_do_not_touch)
         if not isinstance(new_value, bool):
-            raise _u.ConfigurationError("Function provided must return bool")
+            raise u.ConfigurationError("Function provided must return bool")
         return new_value
     
     def apply_as_number(self, str_to_num_function: Callable[[str], IntOrFloat]) ->  IntOrFloat:
@@ -1098,7 +1098,7 @@ class TextValue:
         """
         new_value = str_to_num_function(self._value_do_not_touch)
         if not isinstance(new_value, (int, float)):
-            raise _u.ConfigurationError("Function provided must return a number")
+            raise u.ConfigurationError("Function provided must return a number")
         return new_value
     
     def apply_as_datetime(self, str_to_datetime_function: Callable[[str], datetime]) -> datetime:
@@ -1113,7 +1113,7 @@ class TextValue:
         """
         new_value = str_to_datetime_function(self._value_do_not_touch)
         if not isinstance(new_value, datetime):
-            raise _u.ConfigurationError("Function provided must return datetime")
+            raise u.ConfigurationError("Function provided must return datetime")
         return new_value
 
 
@@ -1130,7 +1130,7 @@ class TextParameter(Parameter):
         if self.is_enabled() and isinstance(self._entered_text, str):
             try:
                 self._entered_text = self._config.validate_entered_text(self._entered_text)
-            except _u.ConfigurationError as e:
+            except u.ConfigurationError as e:
                 raise self._config._invalid_input_error(self._entered_text, str(e))
     
     def is_enabled(self) -> bool:
@@ -1231,7 +1231,7 @@ class TextParameter(Parameter):
         Returns: int
         """
         if self._config.input_type != "number":
-            raise _u.ConfigurationError("Method 'get_entered_int' requires TextParameter to have input type 'number'")
+            raise u.ConfigurationError("Method 'get_entered_int' requires TextParameter to have input type 'number'")
         text = self.get_entered_text()
         return text.apply_as_number(int)
     
@@ -1243,7 +1243,7 @@ class TextParameter(Parameter):
         """
         applicable_input_types = ["date", "datetime-local", "month", "time"]
         if self._config.input_type not in applicable_input_types:
-            raise _u.ConfigurationError(f"Method 'get_entered_datetime' requires TextParameter to have one of these input types: {applicable_input_types}")
+            raise u.ConfigurationError(f"Method 'get_entered_datetime' requires TextParameter to have one of these input types: {applicable_input_types}")
         text = self.get_entered_text()
 
         date_formats = { "date": "%Y-%m-%d", "datetime-local": "%Y-%m-%dT%H:%M", "month": "%Y-%m", "time": "%H:%M" }

{squirrels-0.4.0.dist-info → squirrels-0.5.0b1.dist-info}/METADATA

@@ -1,39 +1,39 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: squirrels
-Version: 0.4.0
+Version: 0.5.0b1
 Summary: Squirrels - API Framework for Data Analytics
-Home-page: https://squirrels-analytics.github.io
-License: Apache-2.0
-Author: Tim Huang
-Author-email: tim.yuting@hotmail.com
-Requires-Python: >=3.10,<4.0
+Project-URL: Homepage, https://squirrels-analytics.github.io
+Project-URL: Repository, https://github.com/squirrels-analytics/squirrels
+Project-URL: Documentation, https://squirrels-analytics.github.io
+Author-email: Tim Huang <tim.yuting@hotmail.com>
+License-Expression: Apache-2.0
+License-File: LICENSE
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
-Provides-Extra: duckdb
-Requires-Dist: cachetools (>=5.3.2,<6.0.0)
-Requires-Dist: duckdb-engine (>=0.13.0,<1.0.0) ; extra == "duckdb"
-Requires-Dist: fastapi (>=0.112.1,<0.113.0)
-Requires-Dist: gitpython (>=3.1.41,<4.0.0)
-Requires-Dist: inquirer (>=3.2.1,<4.0.0)
-Requires-Dist: jinja2 (>=3.1.3,<4.0.0)
-Requires-Dist: matplotlib (>=3.8.3,<4.0.0)
-Requires-Dist: networkx (>=3.2.1,<4.0.0)
-Requires-Dist: pandas (>=2.1.4,<3.0.0)
-Requires-Dist: pydantic (>=2.8.2,<3.0.0)
-Requires-Dist: pyjwt (>=2.8.0,<3.0.0)
-Requires-Dist: python-multipart (>=0.0.9,<0.0.10)
-Requires-Dist: pyyaml (>=6.0.1,<7.0.0)
-Requires-Dist: sqlalchemy (>=2.0.25,<3.0.0)
-Requires-Dist: uvicorn (>=0.30.6,<0.31.0)
-Project-URL: Documentation, https://squirrels-analytics.github.io
-Project-URL: Repository, https://github.com/squirrels-analytics/squirrels
+Requires-Python: ~=3.10
+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: jinja2<4,>=3.1.3
+Requires-Dist: libpass<2,>=1.9.0
+Requires-Dist: matplotlib<4,>=3.8.3
+Requires-Dist: networkx<4,>=3.2.1
+Requires-Dist: pandas<3,>=2.1.4
+Requires-Dist: polars<2,>=1.14.0
+Requires-Dist: pyarrow>=19.0.1
+Requires-Dist: pydantic<3,>=2.8.2
+Requires-Dist: pyjwt<3,>=2.8.0
+Requires-Dist: python-dotenv<2,>=1.0.1
+Requires-Dist: python-multipart<1,>=0.0.9
+Requires-Dist: pyyaml<7,>=6.0.1
+Requires-Dist: sqlalchemy<3,>=2.0.25
+Requires-Dist: sqlglot>=26.12.1
+Requires-Dist: uvicorn<1,>=0.30.6
 Description-Content-Type: text/markdown
 
 # Squirrels
@@ -60,7 +60,7 @@ Here are a few of the things that squirrels can do:
 - Connect to any database by specifying its SQLAlchemy url (in `squirrels.yml`) or by using its native connector library in python (in `connections.py`).
 - Configure API routes for datasets (in `squirrels.yml`) without writing code.
 - Configure parameter widgets (types include single-select, multi-select, date, number, etc.) for your datasets (in `parameters.py`).
-- Use Jinja SQL templates (just like dbt!) or python functions (that return a pandas dataframe) to define dynamic query logic based on parameter selections.
+- Use Jinja SQL templates (just like dbt!) or python functions (that return a Python dataframe such as polars or pandas) to define dynamic query logic based on parameter selections.
 - Query multiple databases and join the results together in a final view in one API endpoint/dataset!
 - Test your API endpoints with an interactive UI or by a command line that generates rendered sql queries and results (for a given set of parameter selections).
 - Define authentication logic (in `auth.py`) and authorize privacy scope per dataset (in `squirrels.yml`). The user's attributes can even be used in your query logic!
@@ -114,4 +114,3 @@ The library version is maintained in both the `pyproject.toml` and the `squirrel
 When a user initializes a squirrels project using `sqrl init`, the files are copied from the `squirrels/package_data/base_project` folder. The contents in the `database` subfolder were constructed from the scripts in the `database_elt` folder.
 
 For the Squirrels UI activated by `sqrl run`, the HTML, CSS, and Javascript files can be found in the `static` and `templates` subfolders of `squirrels/package_data`. The CSS and Javascript files are minified and built from the source files in this project: https://github.com/squirrels-analytics/squirrels-testing-ui.
-

squirrels-0.5.0b1.dist-info/RECORD

@@ -0,0 +1,70 @@
+squirrels/__init__.py,sha256=Y62ldkfs81jsKcetWLDw_1a98gwALx9Ww1b_rLsBpbs,1010
+squirrels/_api_response_models.py,sha256=fQWjEBGAyy8KbkaY4jjOKvxhEcvQPU1bF2dJRTVTRc4,13601
+squirrels/_api_server.py,sha256=1jhUr7GwwwD0O5dqQOX11uuU3Ea-zKXheeeQM0cLrDE,51181
+squirrels/_auth.py,sha256=XCC9i-Z7PaU74u-fqR6_d_eoc9qVh-5nC0CdYp4Svvg,19254
+squirrels/_command_line.py,sha256=urMyS7xIyNCWoiBWDLr6lDz0M_3NvaoPfMIo0vvn5cQ,10663
+squirrels/_connection_set.py,sha256=ZxnNAj9Cu_5ba0uwi6v_ItH6nurFnONrPgB47_GE-3I,3987
+squirrels/_constants.py,sha256=RDoUo4HtiVIQXatVdLoMXaGs1pkNER-Kgnmgs4FUx_Y,3126
+squirrels/_dashboards_io.py,sha256=PPZGB6TpPYxaWJ2pJMj0cZNT9Vo14QV9w-1idLb_eaE,2993
+squirrels/_exceptions.py,sha256=OOywX0UhX-KnvC8MScl2E6KYq3bzLq-PSqOpF7NbUvc,2481
+squirrels/_initializer.py,sha256=fwB_sSJqiBQqYseLshiItEyZCAWMc9bA_qqAW3l0ZIY,13265
+squirrels/_manifest.py,sha256=SrnGj_dd6L1O5Ygfr_B4rvxv_zx9iZap8bSfHTjhx4o,10208
+squirrels/_model_builder.py,sha256=_rUfGgmvvsyFhmXLvDzuP3gDPT_TLXgrZSusqjhhtRo,4921
+squirrels/_model_configs.py,sha256=03gzjFwoMiPtEPMg3U4Ekm7vJtQ2NU3Ks2Aj6gY-2vs,3300
+squirrels/_model_queries.py,sha256=xzfkPvHMq-5m22pnb-Zd045gRTdWe7UP6RmS9AZ-LRk,1086
+squirrels/_models.py,sha256=JmkUSx02ccRRGzGqQNh_Hxxqk4KCATNcxTVekUWOExU,48680
+squirrels/_package_loader.py,sha256=xcIur5Z38OWd-OVjsueFstVV567zlkK9UBnLS4NawJY,1158
+squirrels/_parameter_configs.py,sha256=sWQEJ7Hr6s1TE91H6qZsUO7uUAZqlS0z2Af3ZNoqc7I,23981
+squirrels/_parameter_sets.py,sha256=aE6IDELpLgytjt_G7eI9oTEMgDCgkb71dxATBsrnC38,9837
+squirrels/_project.py,sha256=3Ve6waHnRh92tu-KJSy5GJ5imaIf4LqBQcq_dlokAJs,28314
+squirrels/_py_module.py,sha256=LgILTjMx3jyb92o8Y35ezpntuk6u6ezYVGAICKhUSUM,2622
+squirrels/_seeds.py,sha256=yyIYp4bn9Sg6lhgvsOYIJQHIpPbvLNsyGHVfswEyVd8,2225
+squirrels/_sources.py,sha256=j5mY_EtA5cxoHwtk8RwTVHO74hleik2lS7mF9gVnG_A,4840
+squirrels/_utils.py,sha256=gzcPAQCJna674YomsxTgVe4DZucGJTVotxMWawoudzw,12043
+squirrels/_version.py,sha256=M8aFbJ4vlAi3Sk9b7leRuEfkNBjkkX5S_F9lA4h8GK4,105
+squirrels/dashboards.py,sha256=pekv_ERwoHHpBLYjIXSJ7Z8X7suWmjyex_whpCpZY60,1974
+squirrels/data_sources.py,sha256=W3wzXyC7wGVnz49JkWYZQxBqNuViC_QhulM90KEuLCY,26088
+squirrels/dataset_result.py,sha256=wZvvRs4U1Hva_iyoFosAAu76S1yfv1Cd5SX3UMIw2PA,2838
+squirrels/dateutils.py,sha256=kH2JNvQz0xjfYSh4xNTEAvm73f2EVXNpbXAB9zM2694,16730
+squirrels/parameter_options.py,sha256=cWYKNoBUopHq6VfaeBu-nN2V0_IY3OgYpmYhKODNCew,16956
+squirrels/parameters.py,sha256=kcMQ5-GEQ5lA9Zs_-R21n2Hq5_gULCygQy-Rf1FJK-4,56001
+squirrels/arguments/init_time_args.py,sha256=wl9PrVr3iHsMuZQEfrUj_gyzjdSqMTdQbpYUPjWQEsc,3477
+squirrels/arguments/run_time_args.py,sha256=3L8lQvICJPdH75J1rAqqeupM8raUIw6VedEHJL8nT0c,5705
+squirrels/package_data/base_project/.env,sha256=3Tuk3SJl7RNMebm8P0jocqB-Ox91aW09Zreq8QjyUJ4,1026
+squirrels/package_data/base_project/.env.example,sha256=dS5ZO_kyMT3GdZbj6nfiK9PzkvwGfse9-UiYkvrh7ys,1078
+squirrels/package_data/base_project/.gitignore,sha256=B9OEkQ_j9fZGA2IAyVUvXeylxpya-AUwzLzqzMN4Bfc,155
+squirrels/package_data/base_project/connections.yml,sha256=qZxh7OuI2xqf2cFKwpMo5TONrJXGVzQ7YfcWh4Go7Oo,1011
+squirrels/package_data/base_project/duckdb_init.sql,sha256=iwKDoHbKhOEMe-Pu_sX5a9OauCgqxfZLD70S7RduBrE,196
+squirrels/package_data/base_project/parameters.yml,sha256=McvLXWWI3DoYqTUPGBFo9ArsGJOCseh9mdzO9TxiJ8I,6755
+squirrels/package_data/base_project/squirrels.yml.j2,sha256=j3X3w-rQNP25rSo9Nye8roOUJV98etlpqfsD_zHwxTo,2673
+squirrels/package_data/base_project/assets/expenses.db,sha256=aO0QdApW9ad8LRc73MW1o3eimryzmOAH5vz9Vc3dWK0,77824
+squirrels/package_data/base_project/assets/weather.db,sha256=dsHPO36gQdZ4ULAA726Hg3jp8a1dCdig1DhrGg8wTeg,86016
+squirrels/package_data/base_project/dashboards/dashboard_example.py,sha256=8hg5MIrmeD5OpiKb7x2TCRkAsc4Rg36lf6I4KpJg7Os,1621
+squirrels/package_data/base_project/dashboards/dashboard_example.yml,sha256=mxC1Zmt33TpjpSCEFPAkK7nOcVbSJBhbWh7wMGeHav0,410
+squirrels/package_data/base_project/docker/.dockerignore,sha256=IN0ZmxwLdmYlw6I2ziTdzXkTbZWCUyV4kfUI9_lDz-A,201
+squirrels/package_data/base_project/docker/Dockerfile,sha256=DBOfPajd7ikNr1Qg08TcQmQmWDYamlxoDv7u6FSWElE,470
+squirrels/package_data/base_project/docker/compose.yml,sha256=xMAjfJeNVv49ypMGxR8bG27P5JSbPTNMR7UeGTHGyeA,105
+squirrels/package_data/base_project/macros/macros_example.sql,sha256=oxC6TZmoqgTiXEjosQbiKwUV2-mAGbINmNoV36V1-PI,510
+squirrels/package_data/base_project/models/sources.yml,sha256=Miujhj5QRnbN1Q6BkQyeyX8FZAROPDPLWzVgdsdZy9o,1890
+squirrels/package_data/base_project/models/builds/build_example.py,sha256=SUfWN7E8lZJYl-Zi2c-KoLADha4S5sw4T6cVhhozLaY,1014
+squirrels/package_data/base_project/models/builds/build_example.sql,sha256=UNpgvybUV7sVK-KN2h-ULDyDb4uwN3nYNGZUcBLBtrU,506
+squirrels/package_data/base_project/models/builds/build_example.yml,sha256=bwA_r6j8CIgrzuRnxpVmR350nGvy_USDy6p7TOy4lBI,1284
+squirrels/package_data/base_project/models/dbviews/dbview_example.sql,sha256=hGj7rNJZzgEKGxqzwjmkCAdL-0hOh4U7pIJCyz2SYHk,266
+squirrels/package_data/base_project/models/dbviews/dbview_example.yml,sha256=BFTGdBe7OcyNWKjBh7IhWgmfFgG3nT4toCR3XG5ZgLI,947
+squirrels/package_data/base_project/models/federates/federate_example.py,sha256=g30cVukwI9UIypZR6KOU1z0KWLwx2kGIkRHhrdmeZq8,1774
+squirrels/package_data/base_project/models/federates/federate_example.sql,sha256=A_-ts4Qw5eO-btnrmGbagv3MWJ0TUj_hBS5P7jaCNP4,574
+squirrels/package_data/base_project/models/federates/federate_example.yml,sha256=xhNmc4nT5zyc7J6tr_xSq_lQl3RP6pg4zUuxTPpaEXE,2254
+squirrels/package_data/base_project/pyconfigs/connections.py,sha256=zueK24yEuWt1x_xcR0Q-ikXGe2dXsS4wwh3qlzKG39Q,600
+squirrels/package_data/base_project/pyconfigs/context.py,sha256=9QuvSc7_oAipsIaaeT06bMnjGtUlpKdxmu5xnofE__Y,3717
+squirrels/package_data/base_project/pyconfigs/parameters.py,sha256=VS6fC5H0JSY_bubnDb4iawOI5niEGESF3YFDQ9gv1co,5053
+squirrels/package_data/base_project/pyconfigs/user.py,sha256=L-dj3skPFM2B46g1NgXhX7fgCB7MzLLhWcwMAan98xE,851
+squirrels/package_data/base_project/seeds/seed_categories.csv,sha256=jppjf1nOIxy7-bi5lJn5CVqmnLfJHHq0ABgp6UqbXnw,104
+squirrels/package_data/base_project/seeds/seed_categories.yml,sha256=NZ4BVvYYCEq6OnjRLrE_WOMhYsW0BQhRPWOgUchzdp4,435
+squirrels/package_data/base_project/seeds/seed_subcategories.csv,sha256=Tta1oIgnc2nukNMDlUkIErRKNH_8YT5EPp1A2kQKcow,327
+squirrels/package_data/base_project/seeds/seed_subcategories.yml,sha256=QTgw8Eld-p6Kntf53FyXyn7-7vKYI7IOJVu-Lr-FHCY,583
+squirrels/package_data/base_project/tmp/.gitignore,sha256=XImoqcWvJY0C0L_TWCx1ljvqU7qh9fUTJmK4ACCmNFI,13
+squirrels-0.5.0b1.dist-info/METADATA,sha256=eZ83IOAOLOTs9zsox-IS8Xd_CTCEiAu7qGtLdhvFoGI,5053
+squirrels-0.5.0b1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+squirrels-0.5.0b1.dist-info/entry_points.txt,sha256=i6vgjhJ3o_cdSFYofFcNY9DFMPr4MIcuwnkskSTXfJc,95
+squirrels-0.5.0b1.dist-info/licenses/LICENSE,sha256=qqERuumQtQVsMrEXvJHuecJvV2sLxbleEubd_Zk8dY8,11338
+squirrels-0.5.0b1.dist-info/RECORD,,

{squirrels-0.4.0.dist-info → squirrels-0.5.0b1.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 1.9.0
+Generator: hatchling 1.27.0
 Root-Is-Purelib: true
 Tag: py3-none-any

squirrels-0.5.0b1.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+sqrl = squirrels._command_line:main
+squirrels = squirrels._command_line:main

{squirrels-0.4.0.dist-info → squirrels-0.5.0b1.dist-info/licenses}/LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2024 Tim Huang
+   Copyright 2025 Tim Huang
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

squirrels/_authenticator.py

@@ -1,85 +0,0 @@
-from typing import Type, Optional
-from datetime import datetime, timedelta, timezone
-from jwt.exceptions import InvalidTokenError
-import secrets, jwt
-
-from . import _utils as u, _constants as c
-from .arguments.run_time_args import AuthArgs
-from ._py_module import PyModule
-from .user_base import User, WrongPassword
-from ._environcfg import EnvironConfig
-from ._manifest import DatasetScope
-from ._connection_set import ConnectionsArgs, ConnectionSet
-
-
-class Authenticator:
-
-    def __init__(self, base_path: str, env_cfg: EnvironConfig, conn_args: ConnectionsArgs, conn_set: ConnectionSet, token_expiry_minutes: int, *, auth_helper = None) -> None:
-        self.env_cfg = env_cfg
-        self.conn_args = conn_args
-        self.conn_set = conn_set
-        self.token_expiry_minutes = token_expiry_minutes
-        self.auth_helper = self._get_auth_helper(base_path, default_auth_helper=auth_helper)
-        self.user_cls: Type[User] = self.auth_helper.get_func_or_class("User", default_attr=User)
-        self.secret_key = self._get_secret_key()
-        self.algorithm = "HS256"
-    
-    def _get_auth_helper(self, base_path: str, *, default_auth_helper = None):
-        auth_module_path = u.Path(base_path, c.PYCONFIGS_FOLDER, c.AUTH_FILE)
-        return PyModule(auth_module_path, default_class=default_auth_helper)
-
-    def _get_secret_key(self) -> str:
-        secret_key = self.env_cfg.get_secret(c.JWT_SECRET_KEY, default_factory=lambda: secrets.token_hex(32))
-        return str(secret_key)
-    
-    def _get_auth_args(self, username: str, password: str):
-        connections = self.conn_set.get_engines_as_dict()
-        return AuthArgs(self.conn_args.proj_vars, self.conn_args.env_vars, self.conn_args._get_credential, connections, username, password)
-
-    def authenticate_user(self, username: str, password: str) -> Optional[User]:
-        get_user = self.auth_helper.get_func_or_class(c.GET_USER_FUNC, is_required=False)
-        try:
-            real_user = get_user(self._get_auth_args(username, password)) if get_user is not None else None
-        except Exception as e:
-            raise u.FileExecutionError(f'Failed to run "{c.GET_USER_FUNC}" in {c.AUTH_FILE}', e) from e
-        
-        if isinstance(real_user, User):
-            return real_user
-        
-        if not isinstance(real_user, WrongPassword):
-            fake_users = self.env_cfg.get_users()
-            if username in fake_users and secrets.compare_digest(fake_users[username].password, password):
-                fake_user = fake_users[username].model_dump()
-                fake_user.pop("username", "")
-                is_internal = fake_user.pop("is_internal", False)
-                try:
-                    return self.user_cls.Create(username, is_internal=is_internal, **fake_user)
-                except Exception as e:
-                    raise u.FileExecutionError(f'Failed to create user from User model in {c.AUTH_FILE}', e) from e
-        
-        return None
-    
-    def create_access_token(self, user: User) -> tuple[str, datetime]:
-        expire = datetime.now(timezone.utc) + timedelta(minutes=self.token_expiry_minutes)
-        to_encode = {**vars(user), "exp": expire}
-        encoded_jwt = jwt.encode(to_encode, self.secret_key, algorithm=self.algorithm)
-        return encoded_jwt, expire
-    
-    def get_user_from_token(self, token: Optional[str]) -> Optional[User]:
-        if token is not None:
-            try:
-                payload: dict = jwt.decode(token, self.secret_key, algorithms=[self.algorithm])
-                payload.pop("exp")
-                return self.user_cls._FromDict(payload)
-            except InvalidTokenError:
-                return None
-
-    def can_user_access_scope(self, user: Optional[User], scope: DatasetScope) -> bool:
-        if user is None:
-            user_level = DatasetScope.PUBLIC
-        elif not user.is_internal:
-            user_level = DatasetScope.PROTECTED
-        else:
-            user_level = DatasetScope.PRIVATE
-        
-        return user_level.value >= scope.value

squirrels/_environcfg.py

@@ -1,84 +0,0 @@
-from pathlib import Path
-from typing import Any, Callable
-from pydantic import BaseModel, Field, field_validator, ValidationError
-import os, yaml, time
-
-from . import _constants as c, _utils as u
-
-_GLOBAL_SQUIRRELS_CFG_FILE = u.Path(os.path.expanduser('~'), '.squirrels', c.ENV_CONFIG_FILE)
-
-
-class _UserConfig(BaseModel, extra="allow"):
-    username: str
-    password: str
-    is_internal: bool = False
-
-
-class _CredentialsConfig(BaseModel):
-    username: str
-    password: str
-
-
-class EnvironConfig(BaseModel):
-    users: dict[str, _UserConfig] = Field(default_factory=dict)
-    env_vars: dict[str, str] = Field(default_factory=dict)
-    credentials: dict[str, _CredentialsConfig] = Field(default_factory=dict)
-    secrets: dict[str, Any | None] = Field(default_factory=dict)
-
-    @field_validator("users", mode="before")
-    @classmethod
-    def inject_username(cls, users: dict[str, dict[str, Any]]) -> dict[str, dict[str, Any]]:
-        processed_users = {}
-        for username, user in users.items():
-            processed_users[username] = {"username": username, **user}
-        return processed_users
-    
-    def get_users(self) -> dict[str, _UserConfig]:
-        return self.users.copy()
-    
-    def get_all_env_vars(self) -> dict[str, str]:
-        return self.env_vars.copy()
-    
-    def get_credential(self, key: str | None) -> tuple[str, str]:
-        if not key:
-            return "", ""
-
-        try:
-            credential = self.credentials[key]
-        except KeyError as e:
-            raise u.ConfigurationError(f'No credentials configured for "{key}"') from e
-    
-        return credential.username, credential.password
-    
-    def get_secret(self, key: str, default_factory: Callable[[], Any]) -> Any:
-        if self.secrets.get(key) is None:
-            self.secrets[key] = default_factory()
-        return self.secrets[key]
-
-
-class EnvironConfigIO:
-    
-    @classmethod
-    def load_from_file(cls, logger: u.Logger, base_path: str) -> EnvironConfig:
-        start = time.time()
-        def load_yaml(filename: str | Path) -> dict[str, dict]:
-            try:
-                with open(filename, 'r') as f:
-                    return yaml.safe_load(f)
-            except FileNotFoundError:
-                return {}
-        
-        master_env_config = load_yaml(_GLOBAL_SQUIRRELS_CFG_FILE)
-        proj_env_config = load_yaml(Path(base_path, c.ENV_CONFIG_FILE))
-
-        for key in proj_env_config:
-            master_env_config.setdefault(key, {})
-            master_env_config[key].update(proj_env_config[key])
-        
-        try:
-            env_cfg = EnvironConfig(**master_env_config)
-        except ValidationError as e:
-            raise u.ConfigurationError(f"Failed to process {c.ENV_CONFIG_FILE} file. " + str(e)) from e
-        
-        logger.log_activity_time(f"loading {c.ENV_CONFIG_FILE} file", start)
-        return env_cfg

squirrels/package_data/assets/index.css

@@ -1 +0,0 @@
-.padded{padding:8px 20px}.widget{width:100%;box-sizing:border-box;border:1px solid #ccc;border-radius:4px}.widget-label{position:relative;padding-bottom:10px}.widget-container{display:flex;flex-direction:column;gap:20px}input[type=submit]{padding:12px 20px;cursor:pointer}button{cursor:pointer;border-radius:5px;padding:10px}.white-button{background-color:#fff;color:#00f}.white-button:hover{background-color:#d4dae1}.blue-button{background-color:#4285f4;color:#fff;border:none}.blue-button:hover{background-color:#3076c5}.horizontal-container{display:flex}.auth-container{display:flex;align-items:center;gap:10px}#main-container{height:97vh;width:99vw}#left-container{width:250px;min-width:250px;margin-right:20px;padding:10px;overflow-y:auto}#right-container{height:97vh;width:calc(99vw - 300px)}#header-container{background-color:#d4dae1;color:#000;display:flex;align-items:center;justify-content:space-between;padding:10px}#table-container{padding:10px 20px;height:calc(97vh - 70px);overflow-x:auto;overflow-y:auto}.modal-background{position:fixed;z-index:1;left:0;top:0;width:100%;height:100%;overflow:auto;background-color:#0006;padding-top:60px}.modal-content{background-color:#fefefe;padding:30px;margin:5px auto auto;border:2px solid black}#loading-indicator{justify-content:center;align-items:center;text-align:center;font-weight:700;position:absolute;top:0;left:0;width:100%;height:100%;background-color:#ffffff80}.spinner{margin:20px auto;width:40px;height:40px;position:relative;border-radius:50%;border:3px solid transparent;border-top-color:#3498db;animation:spin 1s linear infinite}@keyframes spin{0%{transform:rotate(0)}to{transform:rotate(360deg)}}table{border-collapse:collapse;width:100%}th,td{text-align:left;padding:8px;min-width:50px}th{background-color:#4285f4;color:#fff}tr:nth-child(2n){background-color:#f2f2f2}#result-table{margin:5px 0}.react-daterange-picker{display:inline-flex;position:relative}.react-daterange-picker,.react-daterange-picker *,.react-daterange-picker *:before,.react-daterange-picker *:after{-moz-box-sizing:border-box;-webkit-box-sizing:border-box;box-sizing:border-box}.react-daterange-picker--disabled{background-color:#f0f0f0;color:#6d6d6d}.react-daterange-picker__wrapper{display:flex;flex-grow:1;flex-shrink:0;align-items:center;border:thin solid gray}.react-daterange-picker__inputGroup{min-width:calc((4px * 3) + .54em * 8 + .217em * 2);height:100%;flex-grow:1;padding:0 2px;box-sizing:content-box}.react-daterange-picker__inputGroup__divider{padding:1px 0;white-space:pre}.react-daterange-picker__inputGroup__divider,.react-daterange-picker__inputGroup__leadingZero{display:inline-block}.react-daterange-picker__inputGroup__input{min-width:.54em;height:100%;position:relative;padding:0 1px;border:0;background:none;color:currentColor;font:inherit;box-sizing:content-box;-webkit-appearance:textfield;-moz-appearance:textfield;appearance:textfield}.react-daterange-picker__inputGroup__input::-webkit-outer-spin-button,.react-daterange-picker__inputGroup__input::-webkit-inner-spin-button{-webkit-appearance:none;-moz-appearance:none;appearance:none;margin:0}.react-daterange-picker__inputGroup__input:invalid{background:#ff00001a}.react-daterange-picker__inputGroup__input--hasLeadingZero{margin-left:-.54em;padding-left:calc(1px + .54em)}.react-daterange-picker__button{border:0;background:transparent;padding:4px 6px}.react-daterange-picker__button:enabled{cursor:pointer}.react-daterange-picker__button:enabled:hover .react-daterange-picker__button__icon,.react-daterange-picker__button:enabled:focus .react-daterange-picker__button__icon{stroke:#0078d7}.react-daterange-picker__button:disabled .react-daterange-picker__button__icon{stroke:#6d6d6d}.react-daterange-picker__button svg{display:inherit}.react-daterange-picker__calendar{width:350px;max-width:100vw;z-index:1}.react-daterange-picker__calendar--closed{display:none}.react-daterange-picker__calendar .react-calendar{border-width:thin}.react-calendar{width:350px;max-width:100%;background:#fff;border:1px solid #a0a096;font-family:Arial,Helvetica,sans-serif;line-height:1.125em}.react-calendar--doubleView{width:700px}.react-calendar--doubleView .react-calendar__viewContainer{display:flex;margin:-.5em}.react-calendar--doubleView .react-calendar__viewContainer>*{width:50%;margin:.5em}.react-calendar,.react-calendar *,.react-calendar *:before,.react-calendar *:after{-moz-box-sizing:border-box;-webkit-box-sizing:border-box;box-sizing:border-box}.react-calendar button{margin:0;border:0;outline:none}.react-calendar button:enabled:hover{cursor:pointer}.react-calendar__navigation{display:flex;height:44px;margin-bottom:1em}.react-calendar__navigation button{min-width:44px;background:none}.react-calendar__navigation button:disabled{background-color:#f0f0f0}.react-calendar__navigation button:enabled:hover,.react-calendar__navigation button:enabled:focus{background-color:#e6e6e6}.react-calendar__month-view__weekdays{text-align:center;text-transform:uppercase;font:inherit;font-size:.75em;font-weight:700}.react-calendar__month-view__weekdays__weekday{padding:.5em}.react-calendar__month-view__weekNumbers .react-calendar__tile{display:flex;align-items:center;justify-content:center;font:inherit;font-size:.75em;font-weight:700}.react-calendar__month-view__days__day--weekend{color:#d10000}.react-calendar__month-view__days__day--neighboringMonth,.react-calendar__decade-view__years__year--neighboringDecade,.react-calendar__century-view__decades__decade--neighboringCentury{color:#757575}.react-calendar__year-view .react-calendar__tile,.react-calendar__decade-view .react-calendar__tile,.react-calendar__century-view .react-calendar__tile{padding:2em .5em}.react-calendar__tile{max-width:100%;padding:10px 6.6667px;background:none;text-align:center;line-height:16px;font:inherit;font-size:.833em}.react-calendar__tile:disabled{background-color:#f0f0f0;color:#ababab}.react-calendar__month-view__days__day--neighboringMonth:disabled,.react-calendar__decade-view__years__year--neighboringDecade:disabled,.react-calendar__century-view__decades__decade--neighboringCentury:disabled{color:#cdcdcd}.react-calendar__tile:enabled:hover,.react-calendar__tile:enabled:focus{background-color:#e6e6e6}.react-calendar__tile--now{background:#ffff76}.react-calendar__tile--now:enabled:hover,.react-calendar__tile--now:enabled:focus{background:#ffffa9}.react-calendar__tile--hasActive{background:#76baff}.react-calendar__tile--hasActive:enabled:hover,.react-calendar__tile--hasActive:enabled:focus{background:#a9d4ff}.react-calendar__tile--active{background:#006edc;color:#fff}.react-calendar__tile--active:enabled:hover,.react-calendar__tile--active:enabled:focus{background:#1087ff}.react-calendar--selectRange .react-calendar__tile--hover{background-color:#e6e6e6}.rc-slider{position:relative;width:100%;height:14px;padding:5px 0;border-radius:6px;touch-action:none;box-sizing:border-box;-webkit-tap-highlight-color:rgba(0,0,0,0)}.rc-slider *{box-sizing:border-box;-webkit-tap-highlight-color:rgba(0,0,0,0)}.rc-slider-rail{position:absolute;width:100%;height:4px;background-color:#e9e9e9;border-radius:6px}.rc-slider-track,.rc-slider-tracks{position:absolute;height:4px;background-color:#abe2fb;border-radius:6px}.rc-slider-track-draggable{z-index:1;box-sizing:content-box;background-clip:content-box;border-top:5px solid rgba(0,0,0,0);border-bottom:5px solid rgba(0,0,0,0);transform:translateY(-5px)}.rc-slider-handle{position:absolute;z-index:1;width:14px;height:14px;margin-top:-5px;background-color:#fff;border:solid 2px #96dbfa;border-radius:50%;cursor:pointer;cursor:-webkit-grab;cursor:grab;opacity:.8;touch-action:pan-x}.rc-slider-handle-dragging.rc-slider-handle-dragging.rc-slider-handle-dragging{border-color:#57c5f7;box-shadow:0 0 0 5px #96dbfa}.rc-slider-handle:focus{outline:none;box-shadow:none}.rc-slider-handle:focus-visible{border-color:#2db7f5;box-shadow:0 0 0 3px #96dbfa}.rc-slider-handle-click-focused:focus{border-color:#96dbfa;box-shadow:unset}.rc-slider-handle:hover{border-color:#57c5f7}.rc-slider-handle:active{border-color:#57c5f7;box-shadow:0 0 5px #57c5f7;cursor:-webkit-grabbing;cursor:grabbing}.rc-slider-mark{position:absolute;top:18px;left:0;width:100%;font-size:12px}.rc-slider-mark-text{position:absolute;display:inline-block;color:#999;text-align:center;vertical-align:middle;cursor:pointer}.rc-slider-mark-text-active{color:#666}.rc-slider-step{position:absolute;width:100%;height:4px;background:transparent}.rc-slider-dot{position:absolute;bottom:-2px;width:8px;height:8px;vertical-align:middle;background-color:#fff;border:2px solid #e9e9e9;border-radius:50%;cursor:pointer}.rc-slider-dot-active{border-color:#96dbfa}.rc-slider-dot-reverse{margin-right:-4px}.rc-slider-disabled{background-color:#e9e9e9}.rc-slider-disabled .rc-slider-track{background-color:#ccc}.rc-slider-disabled .rc-slider-handle,.rc-slider-disabled .rc-slider-dot{background-color:#fff;border-color:#ccc;box-shadow:none;cursor:not-allowed}.rc-slider-disabled .rc-slider-mark-text,.rc-slider-disabled .rc-slider-dot{cursor:not-allowed!important}.rc-slider-vertical{width:14px;height:100%;padding:0 5px}.rc-slider-vertical .rc-slider-rail{width:4px;height:100%}.rc-slider-vertical .rc-slider-track{bottom:0;left:5px;width:4px}.rc-slider-vertical .rc-slider-track-draggable{border-top:0;border-bottom:0;border-right:5px solid rgba(0,0,0,0);border-left:5px solid rgba(0,0,0,0);transform:translate(-5px)}.rc-slider-vertical .rc-slider-handle{position:absolute;z-index:1;margin-top:0;margin-left:-5px;touch-action:pan-y}.rc-slider-vertical .rc-slider-mark{top:0;left:18px;height:100%}.rc-slider-vertical .rc-slider-step{width:4px;height:100%}.rc-slider-vertical .rc-slider-dot{margin-left:-2px}.rc-slider-tooltip-zoom-down-enter,.rc-slider-tooltip-zoom-down-appear,.rc-slider-tooltip-zoom-down-leave{display:block!important;animation-duration:.3s;animation-fill-mode:both;animation-play-state:paused}.rc-slider-tooltip-zoom-down-enter.rc-slider-tooltip-zoom-down-enter-active,.rc-slider-tooltip-zoom-down-appear.rc-slider-tooltip-zoom-down-appear-active{animation-name:rcSliderTooltipZoomDownIn;animation-play-state:running}.rc-slider-tooltip-zoom-down-leave.rc-slider-tooltip-zoom-down-leave-active{animation-name:rcSliderTooltipZoomDownOut;animation-play-state:running}.rc-slider-tooltip-zoom-down-enter,.rc-slider-tooltip-zoom-down-appear{transform:scale(0);animation-timing-function:cubic-bezier(.23,1,.32,1)}.rc-slider-tooltip-zoom-down-leave{animation-timing-function:cubic-bezier(.755,.05,.855,.06)}@keyframes rcSliderTooltipZoomDownIn{0%{transform:scale(0);transform-origin:50% 100%;opacity:0}to{transform:scale(1);transform-origin:50% 100%}}@keyframes rcSliderTooltipZoomDownOut{0%{transform:scale(1);transform-origin:50% 100%}to{transform:scale(0);transform-origin:50% 100%;opacity:0}}.rc-slider-tooltip{position:absolute;top:-9999px;left:-9999px;visibility:visible;box-sizing:border-box;-webkit-tap-highlight-color:rgba(0,0,0,0)}.rc-slider-tooltip *{box-sizing:border-box;-webkit-tap-highlight-color:rgba(0,0,0,0)}.rc-slider-tooltip-hidden{display:none}.rc-slider-tooltip-placement-top{padding:4px 0 8px}.rc-slider-tooltip-inner{min-width:24px;height:24px;padding:6px 2px;color:#fff;font-size:12px;line-height:1;text-align:center;text-decoration:none;background-color:#6c6c6c;border-radius:6px;box-shadow:0 0 4px #d9d9d9}.rc-slider-tooltip-arrow{position:absolute;width:0;height:0;border-color:transparent;border-style:solid}.rc-slider-tooltip-placement-top .rc-slider-tooltip-arrow{bottom:4px;left:50%;margin-left:-4px;border-width:4px 4px 0;border-top-color:#6c6c6c}.hover-text{position:absolute;z-index:1;background-color:#f9f9f9;border:1px solid #ccc;border-radius:4px}input[type=range]{width:80%;padding:12px 0;border:0px}.slider-info{display:flex;font-size:13px;justify-content:space-between}.react-daterange-picker{height:40px;font-size:14px}.react-daterange-picker__wrapper{width:200px;border:0}.react-daterange-picker__inputGroup{min-width:0px;text-align:center}.slider-wrapper{display:flex;flex-direction:column;align-items:center}.rc-slider{width:95%;margin:10px 0}.rc-slider-handle{z-index:0;opacity:1;width:20px;height:20px;margin:-7px 0}