From 2731cb45f28b102cd4298615ed079aade6941d37 Mon Sep 17 00:00:00 2001 From: Tim Rid <6593626+timrid@users.noreply.github.com> Date: Sun, 13 Dec 2020 16:01:24 +0100 Subject: [PATCH] further extended README.md --- README.md | 15 +++++++-------- 1 file changed, 7 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index 25efdae..d78d773 100644 --- a/README.md +++ b/README.md @@ -12,7 +12,12 @@ You just have to type: pip install construct-typing ``` -## Stubs +## Usage +I'm mostly working with VSCode and Pylance (which works really great) ??? But i have also tested the stubs with mypy. ???? + + +## Explanation +### Stubs The **construct-stubs** is used for creating type hints for the orignial `construct` package. In particular the `build` and `parse` methods get type hints. So the core of the stubs are the `TypeVar`s `ParsedType` and `BuildTypes`: - The `build` method of a `Construct` converts an object of one of the types defined by `BuildTypes` to a `bytes` object. - The `parse` method of a `Construct` converts a `bytes` object to an object of type `ParsedType`. @@ -30,7 +35,7 @@ Currently only the very unspecific type `Any` can be used as type hint (maybe in The biggest disadvantage is that autocompletion for the named subcons is not available. -## Typed +### Typed To further enhance the type hints and include and autocompletion for these complex constructs the **construct_typed** package is used. It implements the following new types: @@ -40,12 +45,6 @@ It implements the following new types: - TypedUnion -## Usage -I'm mostly working with VSCode and Pylance (which works really great) ??? But i have also tested the stubs with mypy. ???? - - -## Examples - An example of the added `TypedStruct` class: ```python