3 1-iH@s~dZddlZddlmZddlmZmZmZddlmZm Z yddl m Z m Z Wn$e k rtddl m Z m Z YnXeejdd Zd Zeed d d ZdFeeeedddZeedddZdGeeeedddZdHeeeeeedddZdIeeeeedddZdJeeeeddd ZdKeeeeed"d#d$ZdLeeeeeed%d&d'Zeeed(d)d*Zed d+d,Ze d-krze!d.e!d/d0eZ"e!d1e"eZ#e!d2e$e#x0e#D](Z%e!d3e%d4d5e%j&d6d7d8qWed9dd:Z'e'r.e!d;e!dd9dd?Z(e(j&d@rze!dAe!dBe(dCd4e!dDe(dEd8dS)Ma 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.json)returncCstjs dSyfttd}tj|}WdQRX|jd}|rptj|jdd}tj |j |}|t t dkrpdS|St k rdSXdS)z Load cached British Gas tariff data. Returns: Dictionary with tariff data, or None if not available/stale Nr scraped_atZz+00:00)hours) TARIFF_FILEexistsopenjsonloadgetr fromisoformatreplacenowtzinforCACHE_MAX_AGE_HOURS Exception)fdatar scraped_timeager"9/home/mac944/apps/billy-energy/scraper/british_gas_api.pyget_cached_data&s  r$)postcoderegionr c Cs@t}|sgS|jdg}| rT| rTx(|D] }|jdr,|jdr,|dSq,WgS|rt|}|jd}|rdd|D}t||}x0|D](}|jdr|jd|kr|jdgSqW|r xL|D]D}|jdsq|jddj} |j| kp| |jkr|jdgSqWx.|D]&}|jdr|jdr|dSqWgS)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&cSs g|]}|jdr|jdqS)r(r&)r).0rr"r"r# csz+get_british_gas_tariffs..)r$rr r lower) r%r&rr'rdno_info target_regionavailable_regionsmatched_regionr_regionr"r"r#get_british_gas_tariffsAs:          r3)r%r c Cst|}|jd}t}g}d}d}|r|jdg}x<|D]4}|jdr:|jd|kr:|jdg}|jd}Pq:W|sx<|D]4}|jdr||jdr||jdg}|jd}d}Pq|W||jd|jd |jd|jd 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)TZdno_codeZdno_namepostcode_prefix)codenamer&r4z+Using national tariffs from fallback region)r%Zdnor)Z tariff_countusing_fallback actual_regionZnote)r rr$len) r%r.r/rr)r7r8r'rr"r"r#get_tariffs_with_region_info|s<          r:)tariffannual_electricity_kwhannual_gas_kwhr c Cs|jdi}|jdi}|jddp&d}|jddp6d}||dd|d}d}|dkr|jddpjd} |jddpzd} || dd| d}t||dS) 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_pencedim)rround) r;r<r=elecr?Zelec_unit_rate elec_standingZ elec_costgas_cost gas_unit_rate gas_standingr"r"r#calculate_annual_costs  rJT .)r%r<r= tariff_typer c szt|d}|sdSr(fdd|D}|s0dSd}td}x8|D]0}t|||}||krB|}||||dd}qBW|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%Ncs(g|] }|jddjjkr|qS)typer,)rr-)r*t)rMr"r#r+sz$find_best_tariff..inf)Zelectricity_kwhZgas_kwh)calculated_annual_costusage)r3floatrJ) r%r<r=rMr)bestZ best_costr;costr")rMr#find_best_tariffs$   rV)current_annual_costr%r<r=r c Cst|d}|sdddSg}x\|D]T}t|||}||}|j|jd|jd|t|d|dk|jd |jd d q"W|jd 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 )r%FzABritish Gas tariff data not available. Run the scraper to update.) availablemessager6rNrCrr>r?)r6rN annual_costsaving is_cheaperr>r?cSs|dS)NrZr")xr"r"r#1sz!compare_tariffs..)keyNTr\r[)rX current_cost best_tariffZ all_tariffspotential_saving)r3rJappendrrDsort) rWr%r<r=r)Z comparisonsr;rUr[rTr"r"r#compare_tariffss.   rec Cst}|sdS|jdg}|r|t|}|jd}|r|dd|D}t||}x.|D]&}|jdrR|jd|krR|jdSqRW|rxJ|D]B}|jdsq|jddj} |j| ks| |jkr|jdSqWx(|D] }|jdr|jdr|dSqWdS) 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&cSs g|]}|jdr|jdqS)r(r&)r)r*rr"r"r#r+Ysz!get_ev_tariff..r( ev_tariffr,)r$rr r r-) r%r&rr'r.r/r0r1rr2r"r"r# get_ev_tariff>s0        rg?)rfr<r=off_peak_percentager c CsF|jdi}|jdi}||}|d|}|jddp:d}|jddpJd} |jddpZd} ||d} || d} d | d} | | | }d}|dkr|jd dpd}|jddpd}||dd |d}||}t|d t|dt| d t|dt| d t| d t|d d |t|d d |t||d|| dd 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 r>r?rpeak_unit_rate_penceroff_peak_unit_rate_pencerArBimr@rC)peak_kwh peak_cost off_peak_kwh off_peak_costZstanding_charge_costtotal)Zkwhrp)rZr>r?riZsavings_from_off_peak)rrD)rfr<r=rirEr?rnrlZ peak_rateZ off_peak_raterFrmroZelec_standing_costZtotal_elec_costrGrHrIZ total_costr"r"r#calculate_ev_annual_costqs8         rq)rWr%r<r=rir c Cst|d}|sdddSt||||}|d}||}d||jddd |t|d |d k|jd ijd |jd ijd|jd ijd|jdijd|jdijdd|d|d kr|nd t||dS)a  Compare current tariff cost against British Gas EV Power tariff. Useful for EV owners to see if switching to time-of-use pricing saves money. 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 off_peak_percentage: Fraction of electricity used during off-peak hours Returns: Comparison results with potential savings )r%FzDBritish Gas EV tariff data not available. Run the scraper to update.)rXrYrZTr6zEV Power TariffZEVrCrr>rjrkrAr?r@)Zelectricity_peak_penceZelectricity_off_peak_penceZelectricity_standing_penceZgas_unit_penceZgas_standing_pence)r6rNrZr[r\Zratescost_breakdown)rXr`rfrbZrecommendation)rgrqrrD_get_ev_recommendation) rWr%r<r=rirfrrZev_costr[r"r"r#compare_ev_tariffs4  rt)r[rir cCsR|dkrdt|dS|dkr0dt|dS|d kr/year. Consider if you can shift more usage to off-peak hours.2zaSimilar 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.Ni)rD)r[rir"r"r#rssrscCstjsdddSyttd}tj|}WdQRX|jd}|rtj|jdd}tj |j |}d |t |j d d |t td kt|jd gdSWn,tk r}zdd|dSd}~XnXdS)zi Check how fresh the cached data is. Returns: Dictionary with freshness information Fz8No cached data. Run: python british_gas_scraper.py --all)rXrYrNrrz+00:00Tir)rr')rXrZ age_hoursZis_freshZ regions_countzError reading cache: )rrrrrrrrrrrrD total_secondsrrr9r)rrrr r!er"r"r#get_data_freshnesss$   rx__main__zBritish Gas Tariff API=ruz Data freshness: z Available tariffs: z - r6u: £rZzN/Az/yeari )r<r=z/ Best tariff for 3000 kWh elec + 12000 kWh gas:z rQi)rWr<r=rXu& Compared to £1800/year current cost:z Best: rau Potential saving: £rb)NN)r)NrKrLN)NrKrL)NN)rrh)NrKrLrh))__doc__rpathlibrZtypingrrrrrZ dno_lookupr r ImportError__file__parentrrdictr$strr3r:rSrJrVrergrqrtrsrx__name__print freshnessr)r9rOrrTZ comparisonr"r"r"r#sp ;9  / 26 > 9 %   (