R-iH dZddlZddlmZddlmZmZmZddlmZm Z  ddl m Z m Z eejdz d z Zd Zd eefd Zd:d eded eefdZd ed efdZ d;dededed efdZ ddedededed ef dZ d?ded edededed ef dZdeded efd Zd efd!Ze d"k(re!d#e!d$eZ"e!d%e"eZ#e!d&e$e#e#D]$Z%e!d'e%d(d)e%jMd*d+d,&ed-d.Z'e're!d/e!d0e'd(d)e'd1d,ed2d-d3Z(e(jMd4r)e!d5e!d6e(d7d(e!d8e(d9d,yyy#e $r ddl m Z m Z YwxYw)@a 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.jsonreturnctjsy ttd5}tj|}dddj d}|r[t j|jdd}t j|j|z }|ttkDry|S#1swYyxYw#t$rYywxYw)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 C:\Users\anton\Downloads\bill-analyser-claude-british-gas-frontend-01RLVAGZMevUtuaq9YdNNJYA(3)\bill-analyser-claude-british-gas-frontend-01RLVAGZMevUtuaq9YdNNJYA\scraper\british_gas_api.pyget_cached_datar'&s     +s # q99Q:C C  C postcoderegionc@t}|sgS|jdg}|s5|s3|D],}|jds|jds'|dcSgS|rt|}|jd}|r}|Dcgc]%}|jds|jd'}}t||}|D]<}|jds|jd|k(s*|jdgcS|rq|D]l}|jds|jddj } |j | vs| |j vsZ|jdgcS|D],}|jds|jds'|dcSgScc}w)a Get British Gas tariffs, optionally filtered by postcode or region. Uses DNO lookup to accurately match postcodes to their electricity distribution region, ensuring users see correct regional pricing. Args: postcode: UK postcode to find regional tariffs region: Region name (alternative to postcode) Returns: List of tariff dictionaries for the matched region regionssuccesstariffsr)r'rr r lower) r(r)r#r+rdno_info target_regionavailable_regionsmatched_regionr_regions r&get_british_gas_tariffsr6As  D  hhy"%G F $AuuYAEE)$4|# $ '1 X. :A VQQUU9EUx V  V1((I55B// 0  ,A55#uuXr*002H||~)X-GuuY++  ,  55 i 0Y<   I-!Ws <FFct|}|jd}t}g}d}d}|r|jdg}|D]M}|jds|jd|k(s*|jdg}|jd}n|sQ|D]L}|jds|jds'|jdg}|jd}d}n||jd|jd |jd|jd d |t||||rd d Sdd 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)r:z+Using national tariffs from fallback region)r(dnor- tariff_countusing_fallback actual_regionnote)r rr'len) r(r1r2r#r-r?r@r+rs r&get_tariffs_with_region_inforC|sR$H-HLL*M  DGNM ((9b) AuuYAEE(O}$D%% 2. !h    55#i(8eeIr2G$%EE(OM%)N  LL,LL,ll8,'||,=>  G (&AO=  VZ  tariffannual_electricity_kwhannual_gas_kwhcj|jdi}|jdi}|jddxsd}|jddxsd}||zdz d|zdz z}d}|dkDr=|jddxsd} |jddxsd} || 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) rErFrGelecrJelec_unit_rate elec_standing elec_costgas_cost gas_unit_rate gas_standings r&calculate_annual_costrYs ::mR (D **UB CXX/38qNHH4a8=AM'.83>3CVY\C\]IH 115: ww6:?a "]2S8S<=ORU=UV X%q ))rD. tariff_typec$t|}|sy|rA|Dcgc]6}|jddj|jk(s5|8}}|syd}td}|D]#}t |||} | |ks| }i|| ||dd}%|Scc}w)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(Ntyper.inf)electricity_kwhgas_kwh)calculated_annual_costusage)r6rr0floatrY) r(rFrGr[r-tbest best_costrEcosts r&find_best_tariffris$&x8G %Zvr):)@)@)BkFWFWFY)Y1ZZ  De I $V-C^T ) I*.'=-D  K-[s 6B  B current_annual_costc t|}|sdddSg}|D]v}t|||}||z }|j|jd|jd|t |d|dkD|jd |jd d x|j d |r|dnd} d|| || r | dr| ddSddS)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 r]FzABritish Gas tariff data not available. Run the scraper to update. availablemessager<r^rOrrIrJ)r<r^ annual_costsaving is_cheaperrIrJc |dS)Nro)xs r&z!compare_tariffs..1s 1]#3rD)keyNTrqrp)rm current_cost best_tariff all_tariffspotential_saving)r6rYappendrrQsort) rjr(rFrGr- comparisonsrErhrprfs r&compare_tariffsr~s$&x8G Z  K  $V-C^T$t+JJv&JJv&FA& 1*!::m4::e$   34(;q>dD+".2tL7IDN   PQ  rDct}|sy|jdg}|rt|}|jd}|r||Dcgc]%}|jds|jd'}}t||}|D];}|jds|jd|k(s*|jdcS|rp|D]k}|jds|jddj } |j | vs| |j vsZ|jdcS|D],}|jds|jds'|dcSycc}w)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)r, ev_tariffr.r/) r(r)r#r+r1r2rr3r4r5s r& get_ev_tariffr>sR  D hhy"%G'1 X. :A VQQUU9EUx V  V1((I55-- .  *A55#uuXr*002H||~)X-Guu[))  *" 55 k 2[> !" +!Ws E E roff_peak_percentagec |jdi}|jdi}||z}|d|z z}|jddxsd}|jddxsd} |jddxsd} ||zdz } || zdz } d | zdz } | | z| z}d}|dkDr=|jd dxsd}|jddxsd}||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 rIrJr peak_unit_rate_penceroff_peak_unit_rate_pencerLrMrNrKrO)peak_kwh peak_cost off_peak_kwh off_peak_coststanding_charge_costtotal)kwhr)rorIrJrsavings_from_off_peakrP)rrFrGrrRrJrr peak_rate off_peak_raterTrrelec_standing_costtotal_elec_costrVrWrX total_costs r&calculate_ev_annual_costrqs& == +D --r "C*,??L%-@)@AH/38qIHH7;@qMHH4a8=AM9$s*I =036M},s2-/2DDOH 115: ww6:?a "]2S8S<=ORU=UV 8+JZ+h*y!,!,2"=!4$)*">?P"Q&/mmE2&>&B&BCZ&[ - '-qjFa09LM' rDrpc~|dkDrdt|dS|dkDrdt|dS|dkDryd t| d S) z6Generate a plain English recommendation for EV tariff.rMuThis 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.)rQ)rprs r&rrsY |'f 6fgg !#E&M?2pqq #rufW~..qrrrDc 6tjsdddS ttd5}tj|}dddj d}|rt j|jdd}t j|j|z }d |t|jd z d |tt kt|j d gdSy#1swYxYw#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 --allrlrNrrrTir rr+)rmr age_hoursis_fresh regions_countzError reading cache: )rrrrrrrrrrrrQ total_secondsrr rBr!)r"r#rr$r%es r&get_data_freshnessrs    Q   +s # q99QrsX( ''(FF 8n##h.1KK $68c8#8d8v33343r *  *! * * *H$(! //!// / d^ /h$(! 444"4 4  4n0C00x~0l!$ >>!>> >  >F$(!!$ <<<"< <  <  <~ s5 su s s! D! J z "# (O#$I yk *+&'G !#g, 01 H QvYKtAEE-$?#@FGH 4 ND  @B 4<.T*B%C$DEJK! #J ~~k" 79 M26:;<= &z2D'E&FeLM#7KFEEFsF33 GG