1-iH 6dZddlZddlmZddlmZmZmZddlmZm Z  ddl m Z m Z n#e $r ddl m Z m Z YnwxYweejdz d z Zd Zd eefd Zdd edededed eef dZ d?ded ededed ef dZde!d7e!d8e(d9d*e!d:e(d;d.dSdSdS)Ba British Gas Tariff API Provides functions to read cached British Gas tariff data for use in the main bill analyser application. Usage: from scraper.british_gas_api import get_british_gas_tariffs, find_best_tariff # Get all tariffs for a region tariffs = get_british_gas_tariffs(postcode="HP20 1HP") # Find best matching tariff best = find_best_tariff( postcode="HP20 1HP", annual_electricity_kwh=2900, annual_gas_kwh=12000 ) N)Path)OptionalListDict)datetime timedelta)get_dno_for_postcodefind_matching_regionoutputzbritish-gas-tariffs.jsonreturnctsdS ttd5}tj|}dddn #1swxYwY|d}|r_t j|dd}t j |j |z }|ttkrdS|S#t$rYdSwxYw)z Load cached British Gas tariff data. Returns: Dictionary with tariff data, or None if not available/stale Nr scraped_atZ+00:00hours) TARIFF_FILEexistsopenjsonloadgetr fromisoformatreplacenowtzinforCACHE_MAX_AGE_HOURS Exception)fdatar scraped_timeages 9/home/mac944/apps/billy-energy/scraper/british_gas_api.pyget_cached_datar'&s&     t +s # # q9Q<z+get_british_gas_tariffs..c3 V V VQQUU9EUEU Vx V V Vr'rr r lower) r(r)r#r+rdno_info target_regionavailable_regionsmatched_regionr_regions r&get_british_gas_tariffsr>As   D  hhy"%%G F $ $AuuY $AEE)$4$4 $|###  0'11 X..  0 V V' V V V 1((I(I55B/////, , ,A55## uuXr**0022H||~~))X-G-GuuY+++++.H   55   i 0 0 Y<    Ir5ct|}|d}t}g}d}d}|r|dg}|D]]}|drF|d|kr-|dg}|d}n^|s^|D][}|drD|dr/|dg}|d}d}n\||d|d |d|d d |t||||rd ndd S)z Get British Gas tariffs with detailed region matching info. Args: postcode: UK postcode Returns: Dictionary with tariffs and region matching details r)FNr+r,r-Tdno_codedno_namepostcode_prefix)codenamer)rBz+Using national tariffs from fallback region)r(dnor- tariff_countusing_fallback actual_regionnote)r rr'len) r(r9r:r#r-rGrHr+rs r&get_tariffs_with_region_inforK|s$H--HLL**M   DGNM ((9b))  AuuY AEE(OO}$D$D%% 2.. !h    55##i(8(8eeIr22G$%EE(OOM%)NELL,,LL,,ll8,,'||,=>>   G (&AOY==UY   r5tariffannual_electricity_kwhannual_gas_kwhc|di}|di}|ddpd}|ddpd}||zdz d|zdz z}d}|dkrA|ddpd} |ddpd} || zdz d| zdz z}t||zdS) a3 Calculate annual cost for a tariff based on usage. Args: tariff: Tariff dictionary with rates annual_electricity_kwh: Annual electricity usage in kWh annual_gas_kwh: Annual gas usage in kWh (0 for electricity only) Returns: Estimated annual cost in pounds electricitygasunit_rate_pencerstanding_charge_pencedmrround) rLrMrNelecrQelec_unit_rate elec_standing elec_costgas_cost gas_unit_rate gas_standings r&calculate_annual_costr`s ::mR ( (D **UB  CXX/338qNHH4a88=AM'.83>3CVY\C\]IH 1155: ww6::?a "]2S8S<=ORU=UV X%q ) ))r5T . tariff_typect|}|sdSrfd|D}|sdSd}td}|D]'}t|||}||kr|}i||||dd}(|S)a Find the best (cheapest) British Gas tariff for given usage. Args: postcode: Postcode to find regional tariffs annual_electricity_kwh: Annual electricity usage (default: UK average) annual_gas_kwh: Annual gas usage (default: UK average, 0 for elec only) tariff_type: Filter by type ("Fixed", "Variable", etc.) Returns: Best tariff with calculated cost, or None if no tariffs available r(Ncg|]B}|ddk@|CS)typer6)rr8)r2trcs r&r3z$find_best_tariff..sIZZZvr):):)@)@)B)BkFWFWFYFY)Y)Y1)Y)Y)Yr5inf)electricity_kwhgas_kwh)calculated_annual_costusage)r>floatr`) r(rMrNrcr-best best_costrLcosts ` r&find_best_tariffrrs$&x888G t[ZZZZgZZZ t De I  $V-C^TT )  I*.'=-D Kr5current_annual_costc t|}|sdddSg}|D]}t|||}||z }||d|d|t |d|dk|d |d d |d |r|dnd} d|| || r| dr| dnddS)aa Compare current tariff cost against British Gas options. Args: current_annual_cost: Current annual energy cost in pounds postcode: Postcode for regional tariffs annual_electricity_kwh: Annual electricity usage annual_gas_kwh: Annual gas usage Returns: Comparison results with potential savings reFzABritish Gas tariff data not available. Run the scraper to update. availablemessagerDrgrVrrPrQ)rDrg annual_costsaving is_cheaperrPrQc|dS)Nrx)xs r&z!compare_tariffs..1s 1]#3r5)keyNTrzry)rv current_cost best_tariff all_tariffspotential_saving)r>r`appendrrXsort) rsr(rMrNr- comparisonsrLrqryros r&compare_tariffsrsC$&x888G  Z   K   $V-C^TT$t+JJv&&JJv&&FA&& 1*!::m44::e$$      33444( 2;q>>dD+".2PtL7IPDNNq   r5ct}|sdS|dg}|rt|}|d}|rfd|D}t||}|D]G}|dr0|d|kr|dcSH|r|D]}|ds|dd} || vs| |vr|dcS|D]6}|dr|dr |dcS7dS)a Get British Gas EV Power tariff for a region. The EV tariff has time-of-use pricing: - Peak rate: Standard daytime electricity rate - Off-peak rate: Cheaper overnight rate (12am-5am) Args: postcode: UK postcode to find regional EV tariff region: Region name (alternative to postcode) Returns: EV tariff dictionary with peak/off-peak rates, or None if not available Nr+r)cbg|],}|d|d-Sr/r0r1s r&r3z!get_ev_tariff..Yr4r5r, ev_tariffr6r7) r(r)r#r+r9r:r;r<rr=s r& get_ev_tariffr>s   D thhy"%%G .'11 X..  . V V' V V V 1((I(I55-----* * *A55## uuXr**0022H||~~))X-G-Guu[))))).H"" 55   "k 2 2 "[> ! ! ! 4r5?roff_peak_percentagec |di}|di}||z}|d|z z}|ddpd}|ddpd} |ddpd} ||zdz } || zdz } d | zdz } | | z| z}d}|dkrA|d dpd}|ddpd}||zdz d |zdz z}||z}t|d t|dt| d t|dt| d t| d t|d d |t|d d |t||zdz || zdz z d dS)a Calculate annual cost for an EV tariff with peak/off-peak split. Args: ev_tariff: EV tariff dictionary with peak/off-peak rates annual_electricity_kwh: Total annual electricity usage in kWh annual_gas_kwh: Annual gas usage in kWh (0 for electricity only) off_peak_percentage: Fraction of electricity used during off-peak (0.0-1.0) Default 0.5 assumes 50% overnight charging Returns: Dictionary with cost breakdown rPrQr peak_unit_rate_penceroff_peak_unit_rate_pencerSrTrUrRrV)peak_kwh peak_cost off_peak_kwh off_peak_coststanding_charge_costtotal)kwhr)rxrPrQrsavings_from_off_peakrW)rrMrNrrYrQrr peak_rate off_peak_rater[rrelec_standing_costtotal_elec_costr]r^r_ total_costs r&calculate_ev_annual_costrqs& == + +D --r " "C*,??L%-@)@AH/338qIHH7;;@qMHH4a88=AM9$s*I =036M},s2-/2DDOH 1155: ww6::?a "]2S8S<=ORU=UV 8+JZ++h**y!,,!,22"=!44$)*">?P"Q"Q&/mmE2&>&>&B&BCZ&[&[ -  '-qjjFFa09LMM'  r5ryc|dkrdt|dS|dkrdt|dS|dkrdSd t| d S) z6Generate a plain English recommendation for EV tariff.rTuThis could save you £z0/year. Great for EV owners who charge overnight.ruSmall saving of £z>/year. Consider if you can shift more usage to off-peak hours.izaSimilar cost to your current tariff. Only worth switching if you can increase overnight charging.u Would cost £zC/year more. Not recommended unless you can charge mostly overnight.)rX)ryrs r&rrsj ||gf gggg !qE&MMqqqq #rrrufW~~rrrrr5c tsdddS ttd5}tj|}dddn #1swxYwY|d}|rt j|dd}t j |j |z }d |t| d z d |tt kt|d gdSdS#t $r}dd|dcYd}~Sd}~wwxYw)zi Check how fresh the cached data is. Returns: Dictionary with freshness information Fz8No cached data. Run: python british_gas_scraper.py --allrurNrrrTir rr+)rvr age_hoursis_fresh regions_countzError reading cache: )rrrrrrrrrrrrX total_secondsrr rJr!)r"r#rr$r%es r&get_data_freshnessrs      Q    +s # # q9Q<rKrnr`rrrrrrrr__name__print freshnessr-rJrhrro comparisonr|r5r&rsM( ''''''''''((((((((FFFFFFFFFFFFFEEEEEEEEEEF d8nn#h.1KK $688c8#8d8888v33343333r * *  *! * * * * * *H$(! ///!// / d^ ////h$(! 4444"4 4  4444n00C00x~0000l!$ >>>!>> >  >>>>F$(!!$ <<<<"< <  <  <<<<~ s5 su s s s s s! D! ! ! ! J z E "### E(OOO#"$$I E *y * *+++&%''G E 0##g,, 0 0111 HH FQvYFFAEE-$?$?FFFGGGG  4 N N ND L ABBB J4<JJT*B%CJJJKKK! #J ~~k""N 8999 <M26:<<=== Lz2D'ELLLMMMMM=6NNs ) 99