typegun 0.1.0__tar.gz → 0.2.0__tar.gz

{typegun-0.1.0 → typegun-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: typegun
-Version: 0.1.0
+Version: 0.2.0
 Summary: Run a bunch of python typecheckers on a project, to see if there are any problems.
 Author-email: wyattscarpenter <wyattscarpenter@gmail.com>
 License-Expression: CC0-1.0
@@ -23,11 +23,29 @@ Typegun is a small command-line utility for python to run a bunch of python type
 
 This only includes typecheckers that have a reasonable shot at typing near-current-version python projects mostly-correctly, in my (non-scientific) opinion, a list which may vary over time. If you'd like to add more or bicker about the configurations these typecheckers should have, I'm happy to hear it. The versions of these typecheckers are completely unpinned, all the better to get the most recent versions of them probably. It also includes [ruff](https://docs.astral.sh/ruff/), which is not a typechecker, but is very useful for code quality nonetheless.
 
-Typegun is strategic about the order in which it runs its typecheckers, and this ordering is determined by the speed and utility of the typechecker. Ruff runs first because it runs very fast and never false-positives a type error at all, while still alerting you to other problems that may cause a type error, which the other typecheckers will detect more slowly later. Pyright runs second because it's fast and very correct to the python typing spec. Mypy runs after this because it's slower (TODO: daemon?) and has a couple typing problems. pytype runs last because it is slow and doesn't fully support Python 3.12 yet.
+Typegun is strategic about the order in which it runs its typecheckers, and this ordering is determined by the speed and utility of the typechecker. Ruff runs first because it runs very fast and never false-positives a type error at all, while still alerting you to other problems that may cause a type error, which the other typecheckers will detect more slowly later. Pyright runs second because it's fast and very correct to the python typing spec. Mypy runs after this because it's slower and has a couple typing problems. pytype runs last because it is slow and doesn't fully support Python 3.12 yet.
 
+(will experiment with these as my job allows (using the typechecking script from there as a model)){
 TODO: allow for custom behavior thru a typegun_special file or something.
 
-TODO: example usage using pipx or w/e
+TODO: allow for flexibility in what arguments/files the typecheckers are called on?
+
+TODO: mypy daemon, faster storage with orjson?
+}
+
+## Example usage
+
+In your project directory, do one of the following, depending on what you have installed already:
+
+```typegun```
+
+```uvx typegun```
+
+```pipx run typegun```
+
+```pip install typegun --break-system-packages && typegun```
+
+etc etc
 
 ## Illustrative diagram
 

{typegun-0.1.0 → typegun-0.2.0}/README.md

@@ -9,11 +9,29 @@ Typegun is a small command-line utility for python to run a bunch of python type
 
 This only includes typecheckers that have a reasonable shot at typing near-current-version python projects mostly-correctly, in my (non-scientific) opinion, a list which may vary over time. If you'd like to add more or bicker about the configurations these typecheckers should have, I'm happy to hear it. The versions of these typecheckers are completely unpinned, all the better to get the most recent versions of them probably. It also includes [ruff](https://docs.astral.sh/ruff/), which is not a typechecker, but is very useful for code quality nonetheless.
 
-Typegun is strategic about the order in which it runs its typecheckers, and this ordering is determined by the speed and utility of the typechecker. Ruff runs first because it runs very fast and never false-positives a type error at all, while still alerting you to other problems that may cause a type error, which the other typecheckers will detect more slowly later. Pyright runs second because it's fast and very correct to the python typing spec. Mypy runs after this because it's slower (TODO: daemon?) and has a couple typing problems. pytype runs last because it is slow and doesn't fully support Python 3.12 yet.
+Typegun is strategic about the order in which it runs its typecheckers, and this ordering is determined by the speed and utility of the typechecker. Ruff runs first because it runs very fast and never false-positives a type error at all, while still alerting you to other problems that may cause a type error, which the other typecheckers will detect more slowly later. Pyright runs second because it's fast and very correct to the python typing spec. Mypy runs after this because it's slower and has a couple typing problems. pytype runs last because it is slow and doesn't fully support Python 3.12 yet.
 
+(will experiment with these as my job allows (using the typechecking script from there as a model)){
 TODO: allow for custom behavior thru a typegun_special file or something.
 
-TODO: example usage using pipx or w/e
+TODO: allow for flexibility in what arguments/files the typecheckers are called on?
+
+TODO: mypy daemon, faster storage with orjson?
+}
+
+## Example usage
+
+In your project directory, do one of the following, depending on what you have installed already:
+
+```typegun```
+
+```uvx typegun```
+
+```pipx run typegun```
+
+```pip install typegun --break-system-packages && typegun```
+
+etc etc
 
 ## Illustrative diagram
 

{typegun-0.1.0 → typegun-0.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "typegun"
-version = "0.1.0"
+version = "0.2.0"
 description = "Run a bunch of python typecheckers on a project, to see if there are any problems."
 readme = "README.md"
 license = "CC0-1.0"