o _j"@sdZddlmZddlmZGdddeZGdddeZGdd d eZGd d d eZ Gd d d eZ GdddeZ GdddeZ GdddeZ GdddeZgdZdS)uindiaopt exception hierarchy. Every public exception traces back to :class:`IndiaOptError` so callers can catch either the specific subclass or the base class, depending on how much granularity they need. Hierarchy:: IndiaOptError ├── FetchError │ ├── NetworkError │ ├── RateLimitError │ └── ParseError ├── CircuitOpenError ├── FetchTimeoutError ├── ConfigurationError └── ValidationError ) annotations)Anycs8eZdZdZddddfd d Zdfdd ZZS) IndiaOptErroramBase exception for all indiaopt errors. All exceptions raised by this library are subclasses of :class:`IndiaOptError`, so you can use a single broad ``except`` clause when desired:: try: result = await client.fetch_option_chain("NIFTY") except IndiaOptError as exc: logger.error("indiaopt error: %s", exc) Ncontextrecoverymessagestrrdict[str, Any] | Noner str | NonereturnNonecs t||p i|_||_dS)N)super__init__rr)selfrrr __class__N/home/dinkstrade/pdmp/venv/lib/python3.10/site-packages/indiaopt/exceptions.pyr&s   zIndiaOptError.__init__cs^tg}|jr|d|j|jr*ddd|jD}|d|d|S)Nu ➜ Recovery: z, css"|] \}}|d|VqdS)=Nr).0kvrrr 6s z(IndiaOptError.__str__..u ➜ Context:  )r__str__rappendrjoinitems)rpartsctxrrrr1s  zIndiaOptError.__str__)rr rr rr r r )r r )__name__ __module__ __qualname____doc__rr __classcell__rrrrrs  rcs0eZdZdZdddddddfddZZS) FetchErroraRRaised when a data fetch operation fails after all retry attempts. Attributes: symbol: The trading symbol that failed. exchange: The exchange name (``"NSE"`` or ``"BSE"``). status_code: HTTP status code of the last response (if any). attempts: Number of attempts made before giving up. NSENr)exchange status_codeattemptsrrrr symbolr(r) int | Noner*intrr rr r r c sV|||d|dur d|ini|pi}tj|||d||_||_||_||_dS)N)r+r(r*r)r)rrr+r(r)r*) rrr+r(r)r*rrr rrrrHs  zFetchError.__init__)rr r+r r(r r)r,r*r-rr rr r r r!r"r#r$rr%rrrrr&>sr&c@eZdZdZdS) NetworkErrorzRaised when a low-level network error occurs (connection refused, DNS, etc.). Example:: except NetworkError as exc: print(f"Network problem for {exc.symbol}: {exc}") Nr!r"r#r$rrrrr0ar0cs2eZdZdZddddddddfddZZS)RateLimitErrorzRaised when the exchange rate-limits the client (HTTP 429 / 403). Includes a ``retry_after`` hint when the exchange provides a ``Retry-After`` header. Attributes: retry_after: Suggested wait time in seconds, if known. r'Nr)r(r)r* retry_afterrrrr r+r(r)r,r*r-r4 float | Nonerr rr r r c s>tj|||||||p|durd|ddndd||_dS)NWait .0fzs before retrying.z!Back off and retry after a delay.)r+r(r)r*rr)rrr4) rrr+r(r)r*r4rrrrrrus  zRateLimitError.__init__)rr r+r r(r r)r,r*r-r4r5rr rr r r r.rrrrr3ksr3cs.eZdZdZddddddfddZZS) ParseErroraRaised when the exchange response cannot be parsed. Typically caused by the exchange returning a redirect, CAPTCHA page, or a malformed JSON payload. Attributes: raw_preview: First 200 chars of the raw response body for debugging. r'rN)r(r* raw_previewrrr r+r(r*r-r:rr r r cs"tj|||||dd||_dS)NzPCheck if the exchange is returning HTML instead of JSON (CAPTCHA / maintenance).)r+r(r*rr)rrr:)rrr+r(r*r:rrrrrs  zParseError.__init__)rr r+r r(r r*r-r:r rr r r r.rrrrr8sr8c(eZdZdZdddfd dZZS)CircuitOpenErroraRaised when the circuit breaker is open for a symbol. The circuit opens after :attr:`~indiaopt.config.settings.Settings.circuit_failure_threshold` consecutive failures and remains open for :attr:`~indiaopt.config.settings.Settings.circuit_backoff_seconds`. Attributes: symbol: The trading symbol whose circuit is open. open_until: Monotonic timestamp when the circuit will close. failures: Number of consecutive failures that opened the circuit. r'r(r+r open_untilfloatfailuresr-r(r r c s|ddl}td||}tjd|d|d|d|dd |||t|d d |dd d ||_||_||_||_ dS) NrgzCircuit breaker OPEN for /z (z$ consecutive failures). Retrying in r7zs.)r+r(r@retry_in_secondsr6zAs or reset the circuit manually via client.reset_circuit(symbol).r) timemax monotonicrrroundr+r>r@r()rr+r>r@r(rC remainingrrrrs&   zCircuitOpenError.__init__) r+r r>r?r@r-r(r r r r.rrrrr<sr<cs(eZdZdZddd fd d ZZS)FetchTimeoutErrorzRaised when a fetch operation exceeds the configured timeout. Attributes: symbol: The trading symbol that timed out. timeout_s: The timeout threshold in seconds. r'r=r+r timeout_sr?r(r r csFtjd|dd|d|d|||ddd||_||_||_dS) NzFetch timed out after z.1fzs for rA.)r+r(rIz>Increase Settings.fetch_timeout or check network connectivity.r)rrr+rIr()rr+rIr(rrrrs  zFetchTimeoutError.__init__)r+r rIr?r(r r r r.rrrrrHsrHc@r/)ConfigurationErrorzRaised when the library is configured incorrectly. Example:: except ConfigurationError as exc: print(f"Fix your config: {exc}") Nr1rrrrrKr2rKcr;)ValidationErrorzRaised when caller-supplied input fails validation. Attributes: field: The name of the invalid field. value: The value that failed validation. N)rrr fieldvalueobjectrr r r cs(tj|||d|d||_||_dS)N)rMrNr)rrrMrN)rrrMrNrrrrrs zValidationError.__init__) rr rMr rNrOrr r r r.rrrrrLs rL) r<rKr&rHrr0r8r3rLN)r$ __future__rtypingr Exceptionrr&r0r3r8r<rHrKrL__all__rrrrs  %# &",