"""Example module

This is a description
"""

import asyncio
import collections.abc
import typing
from typing import ClassVar, Dict, Iterable, Generic, List, TypeVar, Union, overload

from example2 import B

T = TypeVar("T")
U = TypeVar("U")

software = "sphin'x"
more_software = 'sphinx"autoapi'
interesting_string = "interesting\"fun'\\'string"

code_snippet = """The following is some code:

# -*- coding: utf-8 -*-
from __future__ import absolute_import, division, print_function, unicode_literals
# from future.builtins.disabled import *
# from builtins import *

print("chunky o'block")
"""

max_rating: int = 10

is_valid: bool
if max_rating > 100:
    is_valid = False
else:
    is_valid = True

ratings: List[int] = [0, 1, 2, 3, 4, 5]

rating_names: Dict[int, str] = {0: "zero", 1: "one"}


def f(start: int, end: int) -> Iterable[int]:
    "This is f"
    i = start
    while i < end:
        yield i
        i += 1


mixed_list: List[Union[str, int]] = [1, "two", 3]
"This is mixed"


def f2(not_yet_a: "A") -> int: ...


def f3(imported: B) -> B: ...


class MyGeneric(Generic[T, U]): ...


@overload
def overloaded_func(a: float) -> float: ...


@typing.overload
def overloaded_func(a: str) -> str: ...


def overloaded_func(a: Union[float, str]) -> Union[float, str]:
    """Overloaded function"""
    return a * 2


@overload
def undoc_overloaded_func(a: str) -> str: ...


def undoc_overloaded_func(a: str) -> str:
    return a * 2


class A:
    """class A"""

    is_an_a: ClassVar[bool] = True
    not_assigned_to: ClassVar[str]

    def __init__(self):
        self.instance_var: bool = True
        """This is an instance_var."""

        self.subobject: object = object()
        self.subobject.subobject_variable = 1

        local_variable_typed: int = 0
        local_variable_untyped = 2

    async def async_method(self, wait: bool) -> int:
        if wait:
            await asyncio.sleep(1)
        return 5

    @property
    def my_prop(self) -> str:
        """My property."""
        return "prop"

    def my_method(self) -> str:
        """My method."""
        return "method"

    @overload
    def overloaded_method(self, a: float) -> float: ...

    @typing.overload
    def overloaded_method(self, a: str) -> str: ...

    def overloaded_method(self, a: Union[float, str]) -> Union[float, str]:
        """Overloaded method"""
        return a * 2

    @overload
    def undoc_overloaded_method(self, a: float) -> float: ...

    def undoc_overloaded_method(self, a: float) -> float:
        return a * 2

    @typing.overload
    @classmethod
    def overloaded_class_method(cls, a: float) -> float: ...

    @overload
    @classmethod
    def overloaded_class_method(cls, a: str) -> str: ...

    @classmethod
    def overloaded_class_method(cls, a: Union[float, str]) -> Union[float, str]:
        """Overloaded class method"""
        return a * 2


class C:
    @overload
    def __init__(self, a: int) -> None: ...

    @typing.overload
    def __init__(self, a: float) -> None: ...

    def __init__(self, a: str): ...


class D(C):
    class Da: ...

    class DB(Da): ...

    ...


async def async_function(wait: bool) -> int:
    """Blah.

    Args:
        wait: Blah
    """
    if wait:
        await asyncio.sleep(1)

    return 5


global_a: A = A()


class SomeMetaclass(type): ...


class MyException(Exception):
    pass


class My123(collections.abc.Sequence):
    def __getitem__(self, i):
        if i < len(self):
            return i

        raise IndexError(i)

    def __len__(self):
        return 3


class InheritBaseError(Exception):
    """The base exception."""

    def __init__(self):
        self.my_message = "one"
        """My message."""
        super().__init__(self.my_message)


class InheritError(InheritBaseError):
    """The middle exception."""

    def __init__(self):
        self.my_other_message = "two"
        """My other message."""
        super().__init__()


class SubInheritError(InheritError):
    """The last exception."""


class DuplicateInheritError(InheritBaseError):
    """Not the base exception."""

    def __init__(self):
        self.my_message = "three"
        super().__init__()