foxesscloud 2.9.4__tar.gz → 2.9.5__tar.gz

{foxesscloud-2.9.4/src/foxesscloud.egg-info → foxesscloud-2.9.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: foxesscloud
-Version: 2.9.4
+Version: 2.9.5
 Summary: library for accessing Fox ESS cloud data using Open API
 Author-email: Tony Matthews <tony@quasair.co.uk>
 Project-URL: Homepage, https://github.com/TonyM1958/FoxESS-Cloud
@@ -139,6 +139,7 @@ get_settings() will return the battery settings and is equivalent to get_charge(
 get_peakshaving() will return the current peak shaving settings for inverters that support this work mode.
 
 get_flag() returns the current scheduler enable / support / maxsoc flags. By default support for Max Soc is set to False.
++ f.max_periods / schedule['maxGroupCount'] gives the maximum number of time periods that are supported.
 
 get_schedule() returns the current work mode / soc schedule settings. The result is stored in f.schedule.
 + if the schedule returned contains any values for 'maxSoc', the f.schedule['maxsoc'] is set to True to indicate that the current inverter supports setting Max Soc in schedules and Max Soc values are set by set_schedule().
@@ -496,7 +497,7 @@ This is an example of the output from battery_info():
 ## Date Ranges
 
 ```
-f.date_list(s, e, limit, span, today)
+f.date_list(s, e, limit, span, today, step)
 ```
 
 Returns a list of dates in the format 'YYYY-MM-DD'. This function will not return dates in the future. The last date will be yesterday or today (if today is True). All parameters are optional:
@@ -506,6 +507,7 @@ Returns a list of dates in the format 'YYYY-MM-DD'. This function will not retur
 + limit: maximum number of days. The default is 200
 + span: the range of dates. One of 'day', 'week', 'month' or 'year', '2days' or 'weekday'
 + today: 1 allows today to be included, 2 allows future dates to be included. Default is 0, date list will stop at yesterday
++ step: optional days to add (default is 1)
 
 You can use 'span' as follows:
 + 'day' provides a single day
@@ -830,6 +832,10 @@ This setting can be:
 
 # Version Info
 
+2.9.5 - 2026/02/27<br>
+Add step parameter to date_list().
+Get maxGroupCount from v3 scheduler and update f.max_periods with maximum number of time periods supported.
+
 2.9.4 - 2026/01/22<br>
 Rename get_battery_heating(), set_battery_heating() to get_heating() and set_heating().
 Update get_heating() to return a dictionary to simplify parameter access.

{foxesscloud-2.9.4 → foxesscloud-2.9.5}/README.md

@@ -125,6 +125,7 @@ get_settings() will return the battery settings and is equivalent to get_charge(
 get_peakshaving() will return the current peak shaving settings for inverters that support this work mode.
 
 get_flag() returns the current scheduler enable / support / maxsoc flags. By default support for Max Soc is set to False.
++ f.max_periods / schedule['maxGroupCount'] gives the maximum number of time periods that are supported.
 
 get_schedule() returns the current work mode / soc schedule settings. The result is stored in f.schedule.
 + if the schedule returned contains any values for 'maxSoc', the f.schedule['maxsoc'] is set to True to indicate that the current inverter supports setting Max Soc in schedules and Max Soc values are set by set_schedule().
@@ -482,7 +483,7 @@ This is an example of the output from battery_info():
 ## Date Ranges
 
 ```
-f.date_list(s, e, limit, span, today)
+f.date_list(s, e, limit, span, today, step)
 ```
 
 Returns a list of dates in the format 'YYYY-MM-DD'. This function will not return dates in the future. The last date will be yesterday or today (if today is True). All parameters are optional:
@@ -492,6 +493,7 @@ Returns a list of dates in the format 'YYYY-MM-DD'. This function will not retur
 + limit: maximum number of days. The default is 200
 + span: the range of dates. One of 'day', 'week', 'month' or 'year', '2days' or 'weekday'
 + today: 1 allows today to be included, 2 allows future dates to be included. Default is 0, date list will stop at yesterday
++ step: optional days to add (default is 1)
 
 You can use 'span' as follows:
 + 'day' provides a single day
@@ -816,6 +818,10 @@ This setting can be:
 
 # Version Info
 
+2.9.5 - 2026/02/27<br>
+Add step parameter to date_list().
+Get maxGroupCount from v3 scheduler and update f.max_periods with maximum number of time periods supported.
+
 2.9.4 - 2026/01/22<br>
 Rename get_battery_heating(), set_battery_heating() to get_heating() and set_heating().
 Update get_heating() to return a dictionary to simplify parameter access.

{foxesscloud-2.9.4 → foxesscloud-2.9.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "foxesscloud"
-version = "2.9.4"
+version = "2.9.5"
 authors = [
   {name="Tony Matthews", email="tony@quasair.co.uk"},
 ]

{foxesscloud-2.9.4 → foxesscloud-2.9.5}/src/foxesscloud/foxesscloud.py

@@ -1,7 +1,7 @@
 ##################################################################################################
 """
 Module:   Fox ESS Cloud
-Updated:  18 January 2026
+Updated:  11 February 2026
 By:       Tony Matthews
 """
 ##################################################################################################
@@ -10,7 +10,7 @@ By:       Tony Matthews
 # ALL RIGHTS ARE RESERVED © Tony Matthews 2023
 ##################################################################################################
 
-version = "1.11.0"
+version = "1.11.1"
 print(f"FoxESS-Cloud version {version}")
 
 debug_setting = 1
@@ -3821,7 +3821,7 @@ def battery_monitor(interval=30, run=48, log=1, count=None, save=None, overwrite
 # span: 'week', 'month' or 'year' generated dates that span a week, month or year
 # quiet: do not print results if True
 
-def date_list(s = None, e = None, limit = None, span = None, today = 0, quiet = True):
+def date_list(s = None, e = None, limit = None, span = None, today = 0, quiet = True, step=1):
     global debug_setting
     latest_date = datetime.date(datetime.now())
     today = 0 if today == False else 1 if today == True else today
@@ -3830,7 +3830,6 @@ def date_list(s = None, e = None, limit = None, span = None, today = 0, quiet =
     first = datetime.date(datetime.strptime(s, '%Y-%m-%d')) if type(s) is str else s.date() if s is not None else None
     last = datetime.date(datetime.strptime(e, '%Y-%m-%d')) if type(e) is str else e.date() if e is not None else None
     last = latest_date if last is not None and last > latest_date and today != 2 else last
-    step = 1
     if first is None and last is None:
         last = latest_date
     if span is not None:

{foxesscloud-2.9.4 → foxesscloud-2.9.5}/src/foxesscloud/openapi.py

@@ -1,7 +1,7 @@
 ##################################################################################################
 """
 Module:   Fox ESS Cloud using Open API
-Updated:  19 January 2025
+Updated:  27 February 2026
 By:       Tony Matthews
 """
 ##################################################################################################
@@ -10,7 +10,7 @@ By:       Tony Matthews
 # ALL RIGHTS ARE RESERVED © Tony Matthews 2024
 ##################################################################################################
 
-version = "2.9.4"
+version = "2.9.5"
 print(f"FoxESS-Cloud Open API version {version}")
 
 debug_setting = 1
@@ -1151,7 +1151,7 @@ max_periods = 8
 
 # get the current switch status
 def get_flag():
-    global device_sn, schedule, debug_setting
+    global device_sn, schedule, debug_setting, max_periods
     if get_device() is None:
         return None
     output(f"getting flag", 2)
@@ -1169,6 +1169,17 @@ def get_flag():
     schedule['support'] = result.get('support')
     if device.get('function') is not None and device['function'].get('scheduler') is not None:
         device['function']['scheduler'] = schedule['support']
+    if schedule.get('maxGroupCount') is None:
+        output(f"getting maxGroupCount", 2)
+        body = {'deviceSN': device_sn}
+        response = signed_post(path="/op/v3/device/scheduler/get", body=body)
+        if response.status_code != 200:
+            output(f"** get_flag() got response code getting maxGroupCount {response.status_code}: {response.reason}")
+            return None
+        result = response.json().get('result')
+        if result is not None:
+            schedule['maxGroupCount'] = result.get('maxGroupCount')
+            max_periods = schedule['maxGroupCount']
     return schedule
 
 ##################################################################################################
@@ -3620,7 +3631,7 @@ def battery_monitor(interval=30, run=48, log=1, count=None, save=None, overwrite
 # span: 'week', 'month' or 'year' generated dates that span a week, month or year
 # quiet: do not print results if True
 
-def date_list(s = None, e = None, limit = None, span = None, today = 0, quiet = True):
+def date_list(s = None, e = None, limit = None, span = None, today = 0, quiet = True, step=1):
     global debug_setting
     latest_date = datetime.date(datetime.now())
     today = 0 if today == False else 1 if today == True else today
@@ -3629,7 +3640,6 @@ def date_list(s = None, e = None, limit = None, span = None, today = 0, quiet =
     first = datetime.date(datetime.strptime(s, '%Y-%m-%d')) if type(s) is str else s.date() if s is not None else None
     last = datetime.date(datetime.strptime(e, '%Y-%m-%d')) if type(e) is str else e.date() if e is not None else None
     last = latest_date if last is not None and last > latest_date and today != 2 else last
-    step = 1
     if first is None and last is None:
         last = latest_date
     if span is not None:

{foxesscloud-2.9.4 → foxesscloud-2.9.5/src/foxesscloud.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: foxesscloud
-Version: 2.9.4
+Version: 2.9.5
 Summary: library for accessing Fox ESS cloud data using Open API
 Author-email: Tony Matthews <tony@quasair.co.uk>
 Project-URL: Homepage, https://github.com/TonyM1958/FoxESS-Cloud
@@ -139,6 +139,7 @@ get_settings() will return the battery settings and is equivalent to get_charge(
 get_peakshaving() will return the current peak shaving settings for inverters that support this work mode.
 
 get_flag() returns the current scheduler enable / support / maxsoc flags. By default support for Max Soc is set to False.
++ f.max_periods / schedule['maxGroupCount'] gives the maximum number of time periods that are supported.
 
 get_schedule() returns the current work mode / soc schedule settings. The result is stored in f.schedule.
 + if the schedule returned contains any values for 'maxSoc', the f.schedule['maxsoc'] is set to True to indicate that the current inverter supports setting Max Soc in schedules and Max Soc values are set by set_schedule().
@@ -496,7 +497,7 @@ This is an example of the output from battery_info():
 ## Date Ranges
 
 ```
-f.date_list(s, e, limit, span, today)
+f.date_list(s, e, limit, span, today, step)
 ```
 
 Returns a list of dates in the format 'YYYY-MM-DD'. This function will not return dates in the future. The last date will be yesterday or today (if today is True). All parameters are optional:
@@ -506,6 +507,7 @@ Returns a list of dates in the format 'YYYY-MM-DD'. This function will not retur
 + limit: maximum number of days. The default is 200
 + span: the range of dates. One of 'day', 'week', 'month' or 'year', '2days' or 'weekday'
 + today: 1 allows today to be included, 2 allows future dates to be included. Default is 0, date list will stop at yesterday
++ step: optional days to add (default is 1)
 
 You can use 'span' as follows:
 + 'day' provides a single day
@@ -830,6 +832,10 @@ This setting can be:
 
 # Version Info
 
+2.9.5 - 2026/02/27<br>
+Add step parameter to date_list().
+Get maxGroupCount from v3 scheduler and update f.max_periods with maximum number of time periods supported.
+
 2.9.4 - 2026/01/22<br>
 Rename get_battery_heating(), set_battery_heating() to get_heating() and set_heating().
 Update get_heating() to return a dictionary to simplify parameter access.