Tastytrade

What's Changed
* [BREAKING] Update instruments.py by Quenos in https://github.com/tastyware/tastytrade/pull/192
This PR changes the signature of the `NestedOptionChain.get_chain` (and `NestedOptionChain.a_get_chain`) functions. Certain symbols, like VIX and SPX, may have more than one root symbol (eg SPX and SPXW), which are parsed as different chains in the API. Previously, some of that data was being thrown away, but now these functions return `list[NestedOptionChain]` instead of a single `NestedOptionChain`.

* add serialization for sessions by Graeme22 in https://github.com/tastyware/tastytrade/pull/197
This PR adds new functions to the `tastytrade.Session` class, `serialize` and `deserialize`, which allow for safely and easily storing sessions for later use. Example usage:
python
session = Session('username', 'password')
...
data = session.serialize()
redis.set("session", data)
...
session = Session.deserialize(redis.get("session"))


**Full Changelog**: https://github.com/tastyware/tastytrade/compare/v9.6...v9.7

What's Changed
Tiny release to make sure the `Account` class keeps working for everybody!

* Fix the wrong usage in the example by steven5538 in https://github.com/tastyware/tastytrade/pull/189
* Gives the field `Account.is_test_drive` a default value of `False` as it may not always be present

New Contributors
* steven5538 made their first contribution in https://github.com/tastyware/tastytrade/pull/189

**Full Changelog**: https://github.com/tastyware/tastytrade/compare/v9.5...v9.6

What's Changed
Small release with mostly internal changes.

* add advanced order instructions, handle CancelledError in streamer tasks by Graeme22 in https://github.com/tastyware/tastytrade/pull/187

Adds advanced order instructions, which can be used to control how the API handles orders in some edge cases. This is discussed in detail in 178.

* Handles streamer closure better by catching `asyncio.CancelledError` in cancelled heartbeat/main loop tasks for both `AlertStreamer` and `DXLinkStreamer`.
* Uses a `pydantic.WrapValidator` for candle OHLC instead of a bunch of `computed_field`s as in v9.4



**Full Changelog**: https://github.com/tastyware/tastytrade/compare/v9.4...v9.5

What's Changed
* fix datetime bug by Graeme22 in https://github.com/tastyware/tastytrade/pull/184

The datetime-related utilities in `tastytrade.utils` suffered from a hard-to-detect bug related to variable Python default arguments. These utilities will work correctly now, whereas previously something like this:
python
from tastytrade.utils import is_market_open_on
print(is_market_open_on())
5 hours later...
print(is_market_open_on())

could potentially yield incorrect results in long-running programs. This now behaves as expected, and no code changes are required.

* candles default to 0, add event flags by Graeme22 in https://github.com/tastyware/tastytrade/pull/185

This partially reverts the changes in v9.3 which excluded all `Candle` events without OHLC fields. JBlohm brought to attention that these "empty" candles can still contain important information in the `event_flags` field. This was solved by re-allowing the empty candles (while still ensuring `None` values provided will be set to 0, which allows for filtering them out without messing with the types), and as a bonus a new class, `tastytrade.dxfeed.IndexedEvent`, was added which allows for easily parsing the `event_flags` field, which otherwise required some bitwise math. So upgrading will look something like this:
python
candles = []
async for candle in streamer.listen(Candle):
if not Decimal.is_zero(candle.open): filter out invalid candles
candles.append(candle)
else:
print(candle.snapshot_end) handle event flags


* update websockets, add autoreconnect by Graeme22 in https://github.com/tastyware/tastytrade/pull/180

This updates the `websockets` dependency to `>=14.1` and uses the new async websockets features to implement auto-reconnect functionality upon certain connection errors. This takes effect automatically and doesn't require any code changes. However, the reconnection algorithm's behavior can be modified through environment variables, documented [here](https://websockets.readthedocs.io/en/14.1/reference/variables.html).

* add streamer reconnection callbacks by Graeme22 in https://github.com/tastyware/tastytrade/pull/186

Building on the auto-reconnection functionality, this PR introduces callback functions that can be ran upon reconnection to handle common tasks, for example, re-subscribing to alerts or events. Here's how this looks:
python
async def callback(streamer: DXLinkStreamer, arg1, arg2):
await streamer.subscribe(Trade, ["SPX"])
print(arg1 + arg2)

async with DXLinkStreamer(session, reconnect_args=(arg1, arg2), reconnect_fn=callback) as streamer:
pass

The first argument for the callback will always be the streamer itself; after that, the number and type of arguments is determined by your use case.
Additionally, a small change was made to the existing `AlertStreamer.create` and `DXLinkStreamer.create` functions. They have been switched to a simpler syntax that allows you to `await` the constructor directly. So this code:
python
streamer = await AlertStreamer.create(session)

becomes:
python
streamer = await AlertStreamer(session)


**Full Changelog**: https://github.com/tastyware/tastytrade/compare/v9.3...v9.4

What's Changed
- All event fields from `tastytrade.dxfeed` changed to Pythonic snake_case instead of their previous names, which came directly from the Java documentation and therefore used camelCase.
So this code:
python
print(quote.eventSymbol)

Becomes:
python
print(quote.event_symbol)

- `Candle`, `Quote`, and `Trade` events from `tastytrade.dxfeed` have less `Optional` fields.
Previously, the streamer would return a lot of "garbage" events that would have to be handled in some way. For example, listening to `Quote` events might have looked like this:
python
from tastytrade.dxfeed import Quote
...
async for quote in streamer.listen(Quote):
if quote.bidPrice is not None and quote.askPrice is not None:
quotes.append(quote)

To make things even worse, using the `Quote` objects returned down the road led to lots of ` type: ignore`s littering the code as type checkers are unable to determine that quotes without crucial properties have already been filtered out:
python
type checker will complain as these may be `None`!
mid = quote.bidPrice + quote.askPrice type: ignore

This mini-release solves these problems by making these fields non-optional, and not returning the events at all if they're missing crucial fields. (For example, `Quote`s are pretty much useless without the bid/ask, or `Candle`s without OHLC.)
So the above code can be changed to:
python
from tastytrade.dxfeed import Quote
...
async for quote in streamer.listen(Quote):
quotes.append(quote)

and
python
mid = quote.bid_price + quote.ask_price


**Full Changelog**: https://github.com/tastyware/tastytrade/compare/v9.2...v9.3

What's Changed
- Removes support for Python 3.8, which has now reached [end of life](https://devguide.python.org/versions/)
- Uses Python 3.9's simpler typing, removing the need to import `typing.List` and `typing.Dict`
- Slightly improves streamer typing using bounded generic `TypeVar`s
- Switches to the standard library's `ZoneInfo` instead of using `pytz`
- Fixes a bug in `Equity.get_active_equities` where some results may not contain the `listed_market` field

**Full Changelog**: https://github.com/tastyware/tastytrade/compare/v9.1...v9.2