austin-python 2.1.2__tar.gz → 2.3.0__tar.gz

{austin_python-2.1.2 → austin_python-2.3.0}/.flake8

@@ -1,12 +1,11 @@
 [flake8]
 select = ANN,B,B9,C,D,E,F,W,I
-ignore = ANN101,ANN102,ANN401,B950,D100,D102,D103,D104,D107,E203,E501,I001,I005,W503,W606
+ignore = ANN101,ANN102,ANN401,B905,B950,D100,D102,D103,D104,D107,E203,E501,I001,I005,W503,W606
 exclude =
   austin/format/pprof/profile_pb2.py
   test/data/column.py
 max-line-length = 88
 docstring-convention = google
-import-order-style = pep8
 application-import-names = austin
 per-file-ignores =
   test/*:ANN,D

{austin_python-2.1.2 → austin_python-2.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: austin-python
-Version: 2.1.2
+Version: 2.3.0
 Summary: Python wrapper for Austin, the CPython frame stack sampler.
 Project-URL: homepage, https://github.com/P403n1x87/austin-python
 Project-URL: documentation, https://austin-python.readthedocs.io
@@ -15,12 +15,12 @@ Keywords: development,performance,profiling,testing
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
-Requires-Python: >=3.9
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.10
 Requires-Dist: protobuf~=3.12
 Requires-Dist: psutil>=5.7.0
 Requires-Dist: toml~=0.10
@@ -187,7 +187,7 @@ raw samples by aggregation.
 # Compatibility
 
 The latest `austin-python` package is tested on Linux, macOS and Windows with
-Python 3.9-3.13.
+Python 3.9-3.14.
 
 
 # Documentation

{austin_python-2.1.2 → austin_python-2.3.0}/README.md

@@ -159,7 +159,7 @@ raw samples by aggregation.
 # Compatibility
 
 The latest `austin-python` package is tested on Linux, macOS and Windows with
-Python 3.9-3.13.
+Python 3.9-3.14.
 
 
 # Documentation

{austin_python-2.1.2 → austin_python-2.3.0}/austin/base.py

@@ -43,7 +43,6 @@ from austin.errors import AustinError
 from austin.events import AustinMetadata
 from austin.events import AustinSample
 
-
 SemVer = Tuple[int, int, int]
 
 

{austin_python-2.1.2 → austin_python-2.3.0}/austin/events.py

@@ -1,7 +1,6 @@
 import typing as t
 from dataclasses import dataclass
 
-
 ProcessId = int
 ThreadName = str
 InterpreterId = int
@@ -44,6 +43,35 @@ class AustinMetadata(AustinEvent):
     value: str
 
 
+@dataclass(frozen=True)
+class AustinTask:
+    """A node in an asyncio task tree (3.14+ only).
+
+    ``frames`` is this task's own last-known suspended coroutine-chain
+    snapshot -- empty if it was never captured suspended (e.g. it was only
+    ever seen actively running rather than awaiting something). ``awaiting``
+    are the tasks this task is itself awaiting, i.e. the tasks for which this
+    task is the direct waiter.
+
+    ``elapsed`` does NOT describe ``frames``. Austin only re-samples a task's
+    chain (and reports a new node) when its identity has actually changed
+    since the last scan, so the two are always one step apart: ``frames`` is
+    the task's brand new position (just captured because it changed), while
+    ``elapsed`` is how long the task dwelled at its *previous*, now-replaced
+    position -- the earliest point at which that duration could be known at
+    all. None on a task's first-ever sighting, when there is no previous
+    position to report a duration for. Always a wall/CPU time value, or None
+    if Austin was run in pure memory mode (no per-task memory delta exists to
+    report -- see austin's own py_proc.c, _py_proc__maybe_discover_asyncio).
+    """
+
+    task_id: int
+    name: t.Optional[str]
+    frames: t.Tuple[AustinFrame, ...] = ()
+    elapsed: t.Optional[MicroSeconds] = None
+    awaiting: t.Tuple["AustinTask", ...] = ()
+
+
 @dataclass(frozen=True)
 class AustinSample(AustinEvent):
     """Austin sample."""
@@ -64,6 +92,7 @@ class AustinSample(AustinEvent):
     frames: t.Optional[t.Tuple[AustinFrame, ...]] = None
     gc: t.Optional[bool] = None
     idle: t.Optional[bool] = None
+    tasks: t.Tuple[AustinTask, ...] = ()
 
     def key(
         self,

{austin_python-2.1.2 → austin_python-2.3.0}/austin/format/collapsed_stack.py

@@ -1,6 +1,6 @@
+import typing as t
 from functools import singledispatchmethod
 from pathlib import Path
-import typing as t
 
 from austin.events import AustinEvent
 from austin.events import AustinEventIterator
@@ -10,7 +10,6 @@ from austin.events import AustinMetrics
 from austin.events import AustinSample
 from austin.format.mojo import MojoStreamReader
 
-
 __version__ = "0.1.0"
 
 
@@ -66,17 +65,17 @@ def parse_collapsed_stack(sample: str) -> AustinSample:
         raise InvalidSample(sample)
 
     if sample[0] != "P":
-        raise InvalidSample(f"No process ID in sample '{sample}'")
+        raise InvalidSample(f"No process ID in sample {sample!r}")
 
     head, _, metrics = sample.rpartition(" ")
     process, _, rest = head.partition(";")
     try:
         pid = int(process[1:])
     except ValueError:
-        raise InvalidSample(f"Invalid process ID in sample '{sample}'") from None
+        raise InvalidSample(f"Invalid process ID in sample {sample!r}") from None
 
     if rest[0] != "T":
-        raise InvalidSample(f"No thread ID in sample '{sample}'")
+        raise InvalidSample(f"No thread ID in sample {sample!r}")
 
     thread, _, frames_data = rest.partition(";")
     thread = thread[1:]

{austin_python-2.1.2 → austin_python-2.3.0}/austin/format/compress.py

@@ -62,9 +62,11 @@ def compress(source: AustinFileReader, dest: TextIO, counts: bool = False) -> No
         formatter.format(
             AustinSample.from_key_and_metrics(
                 key,
-                AustinMetrics(memory=metrics)
-                if is_memory
-                else AustinMetrics(time=metrics),
+                (
+                    AustinMetrics(memory=metrics)
+                    if is_memory
+                    else AustinMetrics(time=metrics)
+                ),
             )
         )
         + "\n"
@@ -108,10 +110,10 @@ def main() -> None:
 
     try:
         with (
-            AustinFileReader(args.input) as fin,
+            open(args.input) as _fin,
             open(args.output or args.input, "w") as fout,
         ):
-            compress(fin, fout, args.counts)
+            compress(AustinFileReader(_fin), fout, args.counts)
     except FileNotFoundError:
         print(f"No such input file: {args.input}")
         exit(1)