Add hints for most of the advanced challenge. (#75)

Author: piglei

challenges/advanced-buffer/hints.md

@@ -0,0 +1 @@
+Check out [Buffer](https://docs.python.org/3/library/collections.abc.html#collections.abc.Buffer).

challenges/advanced-callable-protocol/hints.md

@@ -0,0 +1 @@
+Check out [Protocol](https://docs.python.org/3/library/typing.html#typing.Protocol), you may need to use a dunder method to define a "callable" type.

challenges/advanced-callable-protocol/question.py

@@ -2,8 +2,6 @@
 TODO:
 
 Define a callable type that accepts a string parameter called `name` and returns None.
-
-HINT: Use Protocol
 """
 
 

challenges/advanced-callable-protocol/solution.py

@@ -2,8 +2,6 @@
 TODO:
 
 Define a callable type that accepts a string parameter called `name` and returns None.
-
-HINT: Use Protocol
 """
 from typing import Protocol
 

challenges/advanced-decorator/hints.md

@@ -0,0 +1 @@
+The key is to make `decorator()` return a [Callable](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable) annotated with a generic type.

challenges/advanced-decorator/solution.py

@@ -4,14 +4,14 @@
 Define a decorator that wraps a function and returns a function with the same signature.
 The decorator takes an argument `message` of type string
 """
-from typing import TypeVar
 from collections.abc import Callable
+from typing import TypeVar
 
 # Python < 3.12
 #
 # T = TypeVar("T", bound=Callable)
 #
-# def decorator(func: T) -> T:
+# def decorator(message: str) -> Callable[[T], T]:
 #     return func
 
 

challenges/advanced-descriptor/hints.md

@@ -0,0 +1,2 @@
+- A descriptor's `__get__` method is called in 2 different ways: "owned by class" or "owned by instance", you have to annotate the method for both cases.
+- Don't panic, [@overload](https://docs.python.org/3/library/typing.html#typing.overload) can help you with that.

challenges/advanced-descriptor/question.py

@@ -2,8 +2,6 @@
 TODO:
 
 Create a descriptor and annotate the __get__ method.
-
-HINT: use typing.overload
 """
 
 

challenges/advanced-descriptor/solution.py

@@ -2,11 +2,9 @@
 TODO:
 
 Create a descriptor and annotate the __get__ method.
-
-HINT: use typing.overload
 """
 
-from typing import overload, Self, Any
+from typing import Any, Self, overload
 
 
 class Descriptor:

challenges/advanced-forward/hints.md

@@ -0,0 +1,2 @@
+- How about changing that troublesome symbol to a "STRING"?
+- Something in the ["\_\_future__"](https://peps.python.org/pep-0563/) may also help you.