Implement python -m filprofiler.

.changelog/82.feature

@@ -0,0 +1 @@
+It's now possible to run Fil by doing `python -m filprofiler` in addition to running it as `fil-profile`.

.venv

@@ -0,0 +1 @@
+venv

README.md

@@ -89,6 +89,12 @@ $ fil-profile run yourscript.py --input-file=yourfile
 
 And it will generate a report.
 
+As of version 0.11, you can also run it like this:
+
+```
+$ python -m filprofiler run yourscript.py --input-file=yourfile
+```
+
 ### <a name="oom">Debugging out-of-memory crashes</a>
 
 First, run `free` to figure out how much memory is available—in this case about 6.3GB—and then set a corresponding limit on virtual memory with `ulimit`:

filprofiler/__main__.py

@@ -0,0 +1,9 @@
+"""
+Allow run the CLI as `python -m filprofiler`.
+"""
+
+
+if __name__ == "__main__":
+    from ._script import stage_1
+
+    stage_1()

filprofiler/_script.py

@@ -52,7 +52,12 @@
 
   $ fil-profile run -m yourpackage --your-arg=2
 
-For more info visit https://pythonspeed.com/products/filmemoryprofiler/
+You can also run the profiler this way:
+
+  $ python -m filprofiler run yourprogram.py
+
+For more info, including documentation on Jupyter usage,
+visit https://pythonspeed.com/products/filmemoryprofiler/
 """
 
 

tests/test_endtoend.py

@@ -170,6 +170,38 @@ def test_minus_m():
     )
 
 
+def test_minus_m_minus_m():
+    """
+    `python -m filprofiler -m package` runs the package.
+    """
+    dir = Path("python-benchmarks")
+    script = (dir / "malloc.py").absolute()
+    output_dir = Path(mkdtemp())
+    check_call(
+        [
+            sys.executable,
+            "-m",
+            "filprofiler",
+            "-o",
+            str(output_dir),
+            "run",
+            "-m",
+            "malloc",
+            "--size",
+            "50",
+        ],
+        cwd=dir,
+    )
+    allocations = get_allocations(output_dir)
+    stripped_allocations = {k[3:]: v for (k, v) in allocations.items()}
+    script = str(script)
+    path = ((script, "<module>", 32), (script, "main", 28))
+
+    assert match(stripped_allocations, {path: big}, as_mb) == pytest.approx(
+        50 + 10, 0.1
+    )
+
+
 def test_ld_preload_disabled_for_subprocesses():
     """
     LD_PRELOAD is reset so subprocesses don't get the malloc() preload.
@@ -254,9 +286,14 @@ def test_no_args():
     """
     no_args = run(["fil-profile"], stdout=PIPE, stderr=PIPE)
     with_help = run(["fil-profile", "--help"], stdout=PIPE, stderr=PIPE)
+    no_args_minus_m = run(
+        [sys.executable, "-m", "filprofiler"], stdout=PIPE, stderr=PIPE
+    )
     assert no_args.returncode == with_help.returncode
     assert no_args.stdout == with_help.stdout
     assert no_args.stderr == with_help.stderr
+    assert no_args_minus_m.stdout == with_help.stdout
+    assert no_args_minus_m.stderr == with_help.stderr
 
 
 def test_fortran():