Spgci

Added the LNG Market Fundamentals endpoints:

https://developer.spglobal.com/commodityinsights/servicecatalog/documentation#/LNGGlobalAnalytics/v1/LNG%20Market%20Fundamentals%20API

> [!IMPORTANT]
This release removes the ApiKey usage. You can still pass it in, for backwards compatibility, but it is ignored.

EU Gas Analytics:

We've added hub balances

python
df = egp.get_overview_hub_balance(
gas_day_gte="2024-10-01",
gas_day_lte="2024-10-31",
average_type="Daily value",
hub="PEG",
uom="MCM",
)
df.pivot_table(
index=["hubFlowType", "hubSubFlowType"],
columns="dayMonthOrdinal",
values="quantity",
)

(example from readme)

A few things to note on these endpoints:
- it's recommended to specify a `uom`, otherwise you will get duplicate records
- Also, to specify a `direction` where supported.
- we introduced a custom sort function for the `dayMonthOrdinal` field, so that the above pivot table columns are sorted sensibly.

This release is a breaking change. The previous `get_outages` within LNGGlobalAnalytics was removed by the API, so therefore stopped working. In this change we have replaced it. The function name is the same, but the parameters and output are slightly different. The same applies for the `get_ref_data` function. This was removed and now there are individual functions for `get_liquefaction_projects` and `get_liquefaction_trains`

In addition, the [LNG Assets and Contracts endpoints](https://developer.spglobal.com/commodityinsights/servicecatalog#/LNGGlobalAnalytics/v1/LNG%20Assets%20and%20Contracts) are now supported.

This includes 18 different functions. all prepended with `get_asset_contracts_` - `get_assets_contracts_feedstock` or `get_assets_contracts_monthly_estimated_buildout_liquefaction_capacity` so they should be easy to find in intellisense.

Added more functions to the `LNGGlobalAnalytics` class:

Supply and Demand:
- `get_supply_forecast_current` - Latest supply forecast (project by project) per month.
- `get_supply_forecast_history` - Historical supply forecasts (project by project) per month.
- `get_demand_forecast_current` - Latest demand forecast (market by market) per month.
- `get_demand_forecast_history` - Historical demand forecast (market by market) per month.

Cargos:
`get_cargo_historical_bilateral_trade_flows` - Historical monthly aggregated volume data showing country to country flows.
`get_cargo_trips` - Completed commercial journeys of (LNG) vessel from point A to point B.
`get_cargo_events_partial_load` - Occurrences involving the loading of a portion of LNG cargo during a Transportation process.
`get_cargo_events_partial_unload` - Incidents related to the partial unloading of LNG cargo during transportation.
`get_cargo_events_partial_reexport` - Instances where a fraction of the initially imported LNG is re-exported during the transportation process.
`get_cargo_waterborne_trade` - LNG cargos by load and arrival date as well as numerous volumetric, geographic, and commercial attributes

- Removed dependency on urllib so it will now use whatever version you have installed (assuming it meets other package requirements)
- Fixed a bug in `MarketData` where it would sometimes return an error if there was no data.

- Added short-term (monthly) and long-term (annual) price forecast endpoints to the SDK. By default these will also set `isActive=True`, which can be overriden.
- Added outages.


Examples taken from readme:
python
chem.get_short_term_prices(commodity="Acetone", delivery_region="US Gulf Coast")
DataFrame of short-term (monthly) price forecasts for Acetone delivered to the US Gulf Coast.

chem.get_outages(
start_date_gte="2023-01-01",
capacity_gte=500,
alert_status=['Confirmed']
)
DataFrame of chemical plant outages since Jan 1, 2023 where the capacity impacted is >= 500 and the status is `Confirmed`.