foxesscloud 2.8.8__tar.gz → 2.8.9__tar.gz

{foxesscloud-2.8.8/src/foxesscloud.egg-info → foxesscloud-2.8.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: foxesscloud
-Version: 2.8.8
+Version: 2.8.9
 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
@@ -390,7 +390,7 @@ Given the data available, the modelling works as follows:
 
 The following parameters and default values are used to configure charge_needed and may be updated if required using name=value:
 ```
-contingency: [20,10,5,10]      # % of consumption. Single or [winter, spring, summer, autumn] values
+contingency: [25,15,10,20]     # % of consumption. Single or [winter, spring, summer, autumn] values
 capacity: None                 # Battery capacity in kWh (over-rides generated value if set)
 charge_current: None           # max battery charge current setting in A. None uses a value derrived from the inverter model
 discharge_current: None        # max battery discharge current setting in A. None uses a value derrived from the inverter model
@@ -419,7 +419,7 @@ solar_adjust:  100             # % adjustment to make to Solar forecast
 forecast_selection: 1          # 1 = only update charge times if forecast is available, 0 = use best available data. Default is 1.
 annual_consumption: None       # optional annual consumption in kWh. If set, this replaces consumption history
 timed_mode: 0                  # 0 = None, 1 = use timed work mode, 2 = strategy mode
-special_contingency: 30        # contingency for special days when consumption might be higher
+special_contingency: 35        # contingency for special days when consumption might be higher
 special_days: ['12-25', '12-26', '01-01']
 full_charge: None              # day of month (1-28) to do full charge or 'daily' or day of week: 'Mon', 'Tue' etc
 force: 1                       # 1 = disable strategy periods when setting charge. 0 = fail if strategy period has been set.
@@ -820,6 +820,8 @@ This setting can be:
 
 
 # Version Info
+2.8.9 - 2025/10/12<br>
+Change default contingency for charge_needed() to [25,15,10,20] and special contingency to 35.
 
 2.8.8<br>
 Fix problem where Open API returns conflicting variable names when reporting stats by year.

{foxesscloud-2.8.8 → foxesscloud-2.8.9}/README.md

@@ -376,7 +376,7 @@ Given the data available, the modelling works as follows:
 
 The following parameters and default values are used to configure charge_needed and may be updated if required using name=value:
 ```
-contingency: [20,10,5,10]      # % of consumption. Single or [winter, spring, summer, autumn] values
+contingency: [25,15,10,20]     # % of consumption. Single or [winter, spring, summer, autumn] values
 capacity: None                 # Battery capacity in kWh (over-rides generated value if set)
 charge_current: None           # max battery charge current setting in A. None uses a value derrived from the inverter model
 discharge_current: None        # max battery discharge current setting in A. None uses a value derrived from the inverter model
@@ -405,7 +405,7 @@ solar_adjust:  100             # % adjustment to make to Solar forecast
 forecast_selection: 1          # 1 = only update charge times if forecast is available, 0 = use best available data. Default is 1.
 annual_consumption: None       # optional annual consumption in kWh. If set, this replaces consumption history
 timed_mode: 0                  # 0 = None, 1 = use timed work mode, 2 = strategy mode
-special_contingency: 30        # contingency for special days when consumption might be higher
+special_contingency: 35        # contingency for special days when consumption might be higher
 special_days: ['12-25', '12-26', '01-01']
 full_charge: None              # day of month (1-28) to do full charge or 'daily' or day of week: 'Mon', 'Tue' etc
 force: 1                       # 1 = disable strategy periods when setting charge. 0 = fail if strategy period has been set.
@@ -806,6 +806,8 @@ This setting can be:
 
 
 # Version Info
+2.8.9 - 2025/10/12<br>
+Change default contingency for charge_needed() to [25,15,10,20] and special contingency to 35.
 
 2.8.8<br>
 Fix problem where Open API returns conflicting variable names when reporting stats by year.

{foxesscloud-2.8.8 → foxesscloud-2.8.9}/pyproject.toml

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

{foxesscloud-2.8.8 → foxesscloud-2.8.9}/src/foxesscloud/foxesscloud.py

@@ -1,7 +1,7 @@
 ##################################################################################################
 """
 Module:   Fox ESS Cloud
-Updated:  2 October 2025
+Updated:  12 October 2025
 By:       Tony Matthews
 """
 ##################################################################################################
@@ -10,7 +10,7 @@ By:       Tony Matthews
 # ALL RIGHTS ARE RESERVED © Tony Matthews 2023
 ##################################################################################################
 
-version = "1.9.8"
+version = "1.9.9"
 print(f"FoxESS-Cloud version {version}")
 
 debug_setting = 1
@@ -2945,7 +2945,7 @@ base_time = None
 
 # charge_needed settings
 charge_config = {
-    'contingency': [15,10,5,10],      # % of consumption. Single value or [winter, spring, summer, autumn]
+    'contingency': [25,15,10,20],     # % of consumption. Single value or [winter, spring, summer, autumn]
     'capacity': None,                 # Battery capacity (over-ride)
     'min_soc': None,                  # Minimum Soc. Default 10%
     'max_soc': None,                  # Maximum Soc. Default 100%
@@ -2974,7 +2974,7 @@ charge_config = {
     'forecast_selection': 1,          # 0 = use available forecast / generation, 1 only update settings with forecast
     'annual_consumption': None,       # optional annual consumption in kWh
     'timed_mode': 0,                  # 0 = None, 1 = timed mode, 2 = strategy mode
-    'special_contingency': 33,        # contingency for special days when consumption might be higher
+    'special_contingency': 35,        # contingency for special days when consumption might be higher
     'special_days': ['12-25', '12-26', '01-01'],
     'full_charge': None,              # day of month (1-28) to do full charge, or 'daily' or 'Mon', 'Tue' etc
     'data_wrap': 6,                   # data items to show per line

{foxesscloud-2.8.8 → foxesscloud-2.8.9}/src/foxesscloud/openapi.py

@@ -1,7 +1,7 @@
 ##################################################################################################
 """
 Module:   Fox ESS Cloud using Open API
-Updated:  2 October 2025
+Updated:  12 October 2025
 By:       Tony Matthews
 """
 ##################################################################################################
@@ -10,7 +10,7 @@ By:       Tony Matthews
 # ALL RIGHTS ARE RESERVED © Tony Matthews 2024
 ##################################################################################################
 
-version = "2.8.8"
+version = "2.8.9"
 print(f"FoxESS-Cloud Open API version {version}")
 
 debug_setting = 1
@@ -2642,7 +2642,7 @@ base_time = None
 
 # charge_needed settings
 charge_config = {
-    'contingency': [15,10,5,10],      # % of consumption. Single value or [winter, spring, summer, autumn]
+    'contingency': [25,15,10,20],     # % of consumption. Single value or [winter, spring, summer, autumn]
     'capacity': None,                 # Battery capacity (over-ride)
     'min_soc': None,                  # Minimum Soc. Default 10%
     'max_soc': None,                  # Maximum Soc. Default 100%
@@ -2671,7 +2671,7 @@ charge_config = {
     'forecast_selection': 1,          # 0 = use available forecast / generation, 1 only update settings with forecast
     'annual_consumption': None,       # optional annual consumption in kWh
     'timed_mode': 0,                  # 0 = None, 1 = timed mode, 2 = strategy mode
-    'special_contingency': 33,        # contingency for special days when consumption might be higher
+    'special_contingency': 35,        # contingency for special days when consumption might be higher
     'special_days': ['12-25', '12-26', '01-01'],
     'full_charge': None,              # day of month (1-28) to do full charge, or 'daily' or 'Mon', 'Tue' etc
     'data_wrap': 6,                   # data items to show per line

{foxesscloud-2.8.8 → foxesscloud-2.8.9/src/foxesscloud.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: foxesscloud
-Version: 2.8.8
+Version: 2.8.9
 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
@@ -390,7 +390,7 @@ Given the data available, the modelling works as follows:
 
 The following parameters and default values are used to configure charge_needed and may be updated if required using name=value:
 ```
-contingency: [20,10,5,10]      # % of consumption. Single or [winter, spring, summer, autumn] values
+contingency: [25,15,10,20]     # % of consumption. Single or [winter, spring, summer, autumn] values
 capacity: None                 # Battery capacity in kWh (over-rides generated value if set)
 charge_current: None           # max battery charge current setting in A. None uses a value derrived from the inverter model
 discharge_current: None        # max battery discharge current setting in A. None uses a value derrived from the inverter model
@@ -419,7 +419,7 @@ solar_adjust:  100             # % adjustment to make to Solar forecast
 forecast_selection: 1          # 1 = only update charge times if forecast is available, 0 = use best available data. Default is 1.
 annual_consumption: None       # optional annual consumption in kWh. If set, this replaces consumption history
 timed_mode: 0                  # 0 = None, 1 = use timed work mode, 2 = strategy mode
-special_contingency: 30        # contingency for special days when consumption might be higher
+special_contingency: 35        # contingency for special days when consumption might be higher
 special_days: ['12-25', '12-26', '01-01']
 full_charge: None              # day of month (1-28) to do full charge or 'daily' or day of week: 'Mon', 'Tue' etc
 force: 1                       # 1 = disable strategy periods when setting charge. 0 = fail if strategy period has been set.
@@ -820,6 +820,8 @@ This setting can be:
 
 
 # Version Info
+2.8.9 - 2025/10/12<br>
+Change default contingency for charge_needed() to [25,15,10,20] and special contingency to 35.
 
 2.8.8<br>
 Fix problem where Open API returns conflicting variable names when reporting stats by year.