Allow passing function refs to `Portal.run()`

This resolves and completes #69 allowing all RPC invocation APIs to pass
function references directly instead of explicit `str` names for the
target namespace and function (this is still done implicitly
underneath).  This brings us closer to `trio`'s task running API as well
as acknowledges that any inter-host RPC system (and API) will likely
need to be implemented on top of local RPC primitives anyway. Even if
this ends up **not** being true we can always go to "function stubs" as
part of our IAC protocol or, add a new method to do explicit namespace
calls: `.run_from_module()` or whatever everyone votes on.

Resolves #69

Further, this commit drops `Actor.statespace` from the entire system
since a user can easily get this same functionality using module
level variables. Fix docs to match all these changes (luckily mostly
already done due to example scripts referencing).

docs/index.rst

@@ -385,37 +385,61 @@ as ``multiprocessing`` calls it) which is running ``main()``.
 .. _remote function execution: https://codespeak.net/execnet/example/test_info.html#remote-exec-a-function-avoiding-inlined-source-part-i
 
 
-Actor local variables
+Actor local (aka *process global*) variables
-*********************
+********************************************
-Although ``tractor`` uses a *shared-nothing* architecture between processes
+Although ``tractor`` uses a *shared-nothing* architecture between
-you can of course share state between tasks running *within* an actor.
+processes you can of course share state between tasks running *within*
-``trio`` tasks spawned via multiple RPC calls to an actor can access global
+an actor (since a `trio.run()` runtime is single threaded). ``trio``
-state using the per actor ``statespace`` dictionary:
+tasks spawned via multiple RPC calls to an actor can modify
+*process-global-state* defined using Python module attributes:
 
 .. code:: python
 
 
-        statespace = {'doggy': 10}
+        # a per process cache
+        _actor_cache: Dict[str, bool] = {}
 
 
-        def check_statespace():
+        def ping_endpoints(endpoints: List[str]):
-            # Remember this runs in a new process so no changes
+            """Start a polling process which runs completely separate
-            # will propagate back to the parent actor
+            from our root actor/process.
-            assert tractor.current_actor().statespace == statespace
+
+            """
+
+            # This runs in a new process so no changes # will propagate
+            # back to the parent actor
+            while True:
+
+                for ep in endpoints:
+                    status = await check_endpoint_is_up(ep)
+                    _actor_cache[ep] = status
+
+                await trio.sleep(0.5)
+
+
+        async def get_alive_endpoints():
+
+            nonlocal _actor_cache
+
+            return {key for key, value in _actor_cache.items() if value}
 
 
         async def main():
+
             async with tractor.open_nursery() as n:
-                await n.run_in_actor(
+
-                    'checker',
+                portal = await n.run_in_actor(ping_endpoints)
-                    check_statespace,
+
-                    statespace=statespace
+                # print the alive endpoints after 3 seconds
-                )
+                await trio.sleep(3)
+
+                # this is submitted to be run in our "ping_endpoints" actor
+                print(await portal.run(get_alive_endpoints))
 
 
-Of course you don't have to use the ``statespace`` variable (it's mostly
+You can pass any kind of (`msgpack`) serializable data between actors using
-a convenience for passing simple data to newly spawned actors); building
+function call semantics but building out a state sharing system per-actor
-out a state sharing system per-actor is totally up to you.
+is totally up to you.
 
 
 Service Discovery

examples/a_trynamic_first_scene.py

@@ -13,7 +13,7 @@ async def hi():
 
 async def say_hello(other_actor):
     async with tractor.wait_for_actor(other_actor) as portal:
-        return await portal.run(_this_module, 'hi')
+        return await portal.run(hi)
 
 
 async def main():
@@ -24,14 +24,14 @@ async def main():
         print("Alright... Action!")
 
         donny = await n.run_in_actor(
-            'donny',
             say_hello,
+            name='donny',
             # arguments are always named
             other_actor='gretchen',
         )
         gretchen = await n.run_in_actor(
-            'gretchen',
             say_hello,
+            name='gretchen',
             other_actor='donny',
         )
         print(await gretchen.result())

examples/actor_spawning_and_causality.py

@@ -2,7 +2,8 @@ import tractor
 
 
 def cellar_door():
-   return "Dang that's beautiful"
+    assert not tractor.is_root_process()
+    return "Dang that's beautiful"
 
 
 async def main():
@@ -10,7 +11,10 @@ async def main():
     """
     async with tractor.open_nursery() as n:
 
-        portal = await n.run_in_actor('some_linguist', cellar_door)
+        portal = await n.run_in_actor(
+            cellar_door,
+            name='some_linguist',
+        )
 
     # The ``async with`` will unblock here since the 'some_linguist'
     # actor has completed its main task ``cellar_door``.

examples/actor_spawning_and_causality_with_daemon.py

@@ -19,9 +19,9 @@ async def main():
             rpc_module_paths=[__name__],
         )
 
-        print(await portal.run(__name__, 'movie_theatre_question'))
+        print(await portal.run(movie_theatre_question))
         # call the subactor a 2nd time
-        print(await portal.run(__name__, 'movie_theatre_question'))
+        print(await portal.run(movie_theatre_question))
 
         # the async with will block here indefinitely waiting
         # for our actor "frank" to complete, but since it's an

examples/asynchronous_generators.py

@@ -24,7 +24,7 @@ async def main():
 
             # this async for loop streams values from the above
             # async generator running in a separate process
-            async for letter in await portal.run(__name__, 'stream_forever'):
+            async for letter in await portal.run(stream_forever):
                 print(letter)
 
     # we support trio's cancellation system
@@ -33,4 +33,4 @@ async def main():
 
 
 if __name__ == '__main__':
-    tractor.run(main, start_method='forkserver')
+    tractor.run(main)

examples/debugging/multi_daemon_subactors.py

@@ -23,8 +23,8 @@ async def main():
         p1 = await n.start_actor('name_error', rpc_module_paths=[__name__])
 
         # retreive results
-        stream = await p0.run(__name__, 'breakpoint_forever')
+        stream = await p0.run(breakpoint_forever)
-        await p1.run(__name__, 'name_error')
+        await p1.run(name_error)
 
 
 if __name__ == '__main__':

examples/debugging/multi_nested_subactors_error_up_through_nurseries.py

@@ -18,10 +18,17 @@ async def spawn_until(depth=0):
     async with tractor.open_nursery() as n:
         if depth < 1:
             # await n.run_in_actor('breakpoint_forever', breakpoint_forever)
-            await n.run_in_actor('name_error', name_error)
+            await n.run_in_actor(
+                name_error,
+                name='name_error'
+            )
         else:
             depth -= 1
-            await n.run_in_actor(f'spawn_until_{depth}', spawn_until, depth=depth)
+            await n.run_in_actor(
+                spawn_until,
+                depth=depth,
+                name=f'spawn_until_{depth}',
+            )
 
 
 async def main():
@@ -46,12 +53,20 @@ async def main():
     async with tractor.open_nursery() as n:
 
         # spawn both actors
-        portal = await n.run_in_actor('spawner0', spawn_until, depth=3)
+        portal = await n.run_in_actor(
-        portal1 = await n.run_in_actor('spawner1', spawn_until, depth=4)
+            spawn_until,
+            depth=3,
+            name='spawner0',
+        )
+        portal1 = await n.run_in_actor(
+            spawn_until,
+            depth=4,
+            name='spawner1',
+        )
 
         # gah still an issue here.
-        # await portal.result()
+        await portal.result()
-        # await portal1.result()
+        await portal1.result()
 
 
 if __name__ == '__main__':

examples/debugging/multi_subactor_root_errors.py

@@ -10,7 +10,10 @@ async def spawn_error():
     """"A nested nursery that triggers another ``NameError``.
     """
     async with tractor.open_nursery() as n:
-        portal = await n.run_in_actor('name_error_1', name_error)
+        portal = await n.run_in_actor(
+            name_error,
+            name='name_error_1',
+            )
         return await portal.result()
 
 
@@ -27,8 +30,14 @@ async def main():
     async with tractor.open_nursery() as n:
 
         # spawn both actors
-        portal = await n.run_in_actor('name_error', name_error)
+        portal = await n.run_in_actor(
-        portal1 = await n.run_in_actor('spawn_error', spawn_error)
+            name_error,
+            name='name_error',
+        )
+        portal1 = await n.run_in_actor(
+            spawn_error,
+            name='spawn_error',
+        )
 
         # trigger a root actor error
         assert 0

examples/debugging/multi_subactors.py

@@ -18,7 +18,10 @@ async def spawn_error():
     """"A nested nursery that triggers another ``NameError``.
     """
     async with tractor.open_nursery() as n:
-        portal = await n.run_in_actor('name_error_1', name_error)
+        portal = await n.run_in_actor(
+            name_error,
+            name='name_error_1',
+        )
         return await portal.result()
 
 
@@ -38,9 +41,9 @@ async def main():
         # Spawn both actors, don't bother with collecting results
         # (would result in a different debugger outcome due to parent's
         # cancellation).
-        await n.run_in_actor('bp_forever', breakpoint_forever)
+        await n.run_in_actor(breakpoint_forever)
-        await n.run_in_actor('name_error', name_error)
+        await n.run_in_actor(name_error)
-        await n.run_in_actor('spawn_error', spawn_error)
+        await n.run_in_actor(spawn_error)
 
 
 if __name__ == '__main__':

examples/debugging/root_cancelled_but_child_is_in_tty_lock.py

@@ -12,10 +12,14 @@ async def spawn_until(depth=0):
     async with tractor.open_nursery() as n:
         if depth < 1:
             # await n.run_in_actor('breakpoint_forever', breakpoint_forever)
-            await n.run_in_actor('name_error', name_error)
+            await n.run_in_actor(name_error)
         else:
             depth -= 1
-            await n.run_in_actor(f'spawn_until_{depth}', spawn_until, depth=depth)
+            await n.run_in_actor(
+                spawn_until,
+                depth=depth,
+                name=f'spawn_until_{depth}',
+            )
 
 
 async def main():
@@ -36,8 +40,16 @@ async def main():
     async with tractor.open_nursery() as n:
 
         # spawn both actors
-        portal = await n.run_in_actor('spawner0', spawn_until, depth=0)
+        portal = await n.run_in_actor(
-        portal1 = await n.run_in_actor('spawner1', spawn_until, depth=1)
+            spawn_until,
+            depth=0,
+            name='spawner0',
+        )
+        portal1 = await n.run_in_actor(
+            spawn_until,
+            depth=1,
+            name='spawner1',
+        )
 
         # nursery cancellation should be triggered due to propagated
         # error from child.

examples/debugging/subactor_breakpoint.py

@@ -15,7 +15,6 @@ async def main():
     async with tractor.open_nursery() as n:
 
         portal = await n.run_in_actor(
-            'breakpoint_forever',
             breakpoint_forever,
         )
         await portal.result()

examples/debugging/subactor_error.py

@@ -8,7 +8,7 @@ async def name_error():
 async def main():
     async with tractor.open_nursery() as n:
 
-        portal = await n.run_in_actor('name_error', name_error)
+        portal = await n.run_in_actor(name_error)
         await portal.result()
 
 

examples/full_fledged_streaming_service.py

@@ -30,9 +30,7 @@ async def aggregate(seed):
 
         async def push_to_chan(portal, send_chan):
             async with send_chan:
-                async for value in await portal.run(
+                async for value in await portal.run(stream_data, seed=seed):
-                    __name__, 'stream_data', seed=seed
-                ):
                     # leverage trio's built-in backpressure
                     await send_chan.send(value)
 
@@ -74,8 +72,8 @@ async def main():
         pre_start = time.time()
 
         portal = await nursery.run_in_actor(
-            'aggregator',
             aggregate,
+            name='aggregator',
             seed=seed,
         )
 

examples/remote_error_propagation.py

@@ -15,7 +15,7 @@ async def main():
             ))
 
         # start one actor that will fail immediately
-        await n.run_in_actor('extra', assert_err)
+        await n.run_in_actor(assert_err)
 
     # should error here with a ``RemoteActorError`` containing
     # an ``AssertionError`` and all the other actors have been cancelled

tests/test_cancellation.py

@@ -49,7 +49,7 @@ def test_remote_error(arb_addr, args_err):
     async def main():
         async with tractor.open_nursery() as nursery:
 
-            portal = await nursery.run_in_actor('errorer', assert_err, **args)
+            portal = await nursery.run_in_actor(assert_err, name='errorer', **args)
 
             # get result(s) from main task
             try:
@@ -73,8 +73,8 @@ def test_multierror(arb_addr):
     async def main():
         async with tractor.open_nursery() as nursery:
 
-            await nursery.run_in_actor('errorer1', assert_err)
+            await nursery.run_in_actor(assert_err, name='errorer1')
-            portal2 = await nursery.run_in_actor('errorer2', assert_err)
+            portal2 = await nursery.run_in_actor(assert_err, name='errorer2')
 
             # get result(s) from main task
             try:
@@ -104,7 +104,10 @@ def test_multierror_fast_nursery(arb_addr, start_method, num_subactors, delay):
         async with tractor.open_nursery() as nursery:
             for i in range(num_subactors):
                 await nursery.run_in_actor(
-                    f'errorer{i}', assert_err, delay=delay)
+                    assert_err,
+                    name=f'errorer{i}',
+                    delay=delay
+                )
 
     with pytest.raises(trio.MultiError) as exc_info:
         tractor.run(main, arbiter_addr=arb_addr)
@@ -231,7 +234,12 @@ async def test_some_cancels_all(num_actors_and_errs, start_method, loglevel):
             for i in range(num_actors):
                 # start actor(s) that will fail immediately
                 riactor_portals.append(
-                    await n.run_in_actor(f'actor_{i}', func, **kwargs))
+                    await n.run_in_actor(
+                        func,
+                        name=f'actor_{i}',
+                        **kwargs
+                    )
+                )
 
             if da_func:
                 func, kwargs, expect_error = da_func
@@ -276,21 +284,24 @@ async def spawn_and_error(breadth, depth) -> None:
     name = tractor.current_actor().name
     async with tractor.open_nursery() as nursery:
         for i in range(breadth):
+
             if depth > 0:
+
                 args = (
-                    f'spawner_{i}_depth_{depth}',
                     spawn_and_error,
                 )
                 kwargs = {
+                    'name': f'spawner_{i}_depth_{depth}',
                     'breadth': breadth,
                     'depth': depth - 1,
                 }
             else:
                 args = (
-                    f'{name}_errorer_{i}',
                     assert_err,
                 )
-                kwargs = {}
+                kwargs = {
+                    'name': f'{name}_errorer_{i}',
+                }
             await nursery.run_in_actor(*args, **kwargs)
 
 
@@ -318,8 +329,8 @@ async def test_nested_multierrors(loglevel, start_method):
             async with tractor.open_nursery() as nursery:
                 for i in range(subactor_breadth):
                     await nursery.run_in_actor(
-                        f'spawner_{i}',
                         spawn_and_error,
+                        name=f'spawner_{i}',
                         breadth=subactor_breadth,
                         depth=depth,
                     )
@@ -398,7 +409,10 @@ def test_cancel_via_SIGINT_other_task(
     async def spawn_and_sleep_forever(task_status=trio.TASK_STATUS_IGNORED):
         async with tractor.open_nursery() as tn:
             for i in range(3):
-                await tn.run_in_actor('sucka', sleep_forever)
+                await tn.run_in_actor(
+                    sleep_forever,
+                    name='namesucka',
+                )
             task_status.started()
             await trio.sleep_forever()
 
@@ -423,7 +437,10 @@ async def spin_for(period=3):
 
 async def spawn():
     async with tractor.open_nursery() as tn:
-        portal = await tn.run_in_actor('sleeper', spin_for)
+        portal = await tn.run_in_actor(
+            spin_for,
+            name='sleeper',
+        )
 
 
 @no_windows
@@ -442,7 +459,10 @@ def test_cancel_while_childs_child_in_sync_sleep(
     async def main():
         with trio.fail_after(2):
             async with tractor.open_nursery() as tn:
-                portal = await tn.run_in_actor('spawn', spawn)
+                portal = await tn.run_in_actor(
+                    spawn,
+                    name='spawn',
+                )
                 await trio.sleep(1)
                 assert 0
 

tests/test_debugger.py

@@ -237,7 +237,7 @@ def test_multi_subactors(spawn):
     child.expect(r"\(Pdb\+\+\)")
 
     before = str(child.before.decode())
-    assert "Attaching pdb to actor: ('bp_forever'" in before
+    assert "Attaching pdb to actor: ('breakpoint_forever'" in before
 
     # do some "next" commands to demonstrate recurrent breakpoint
     # entries
@@ -265,7 +265,7 @@ def test_multi_subactors(spawn):
     child.sendline('c')
     child.expect(r"\(Pdb\+\+\)")
     before = str(child.before.decode())
-    assert "Attaching pdb to actor: ('bp_forever'" in before
+    assert "Attaching pdb to actor: ('breakpoint_forever'" in before
 
     # now run some "continues" to show re-entries
     for _ in range(5):
@@ -277,7 +277,7 @@ def test_multi_subactors(spawn):
     child.expect(r"\(Pdb\+\+\)")
     before = str(child.before.decode())
     assert "Attaching to pdb in crashed actor: ('arbiter'" in before
-    assert "RemoteActorError: ('bp_forever'" in before
+    assert "RemoteActorError: ('breakpoint_forever'" in before
     assert 'bdb.BdbQuit' in before
 
     # process should exit
@@ -285,7 +285,7 @@ def test_multi_subactors(spawn):
     child.expect(pexpect.EOF)
 
     before = str(child.before.decode())
-    assert "RemoteActorError: ('bp_forever'" in before
+    assert "RemoteActorError: ('breakpoint_forever'" in before
     assert 'bdb.BdbQuit' in before
 
 
@@ -391,8 +391,9 @@ def test_multi_nested_subactors_error_through_nurseries(spawn):
 
     child.expect(pexpect.EOF)
 
-    before = str(child.before.decode())
+    if not timed_out_early:
-    assert "NameError" in before
+        before = str(child.before.decode())
+        assert "NameError" in before
 
 
 def test_root_nursery_cancels_before_child_releases_tty_lock(spawn, start_method):

tests/test_discovery.py

@@ -74,14 +74,14 @@ async def test_trynamic_trio(func, start_method):
         print("Alright... Action!")
 
         donny = await n.run_in_actor(
-            'donny',
             func,
             other_actor='gretchen',
+            name='donny',
         )
         gretchen = await n.run_in_actor(
-            'gretchen',
             func,
             other_actor='donny',
+            name='gretchen',
         )
         print(await gretchen.result())
         print(await donny.result())
@@ -147,7 +147,7 @@ async def spawn_and_check_registry(
                     portals = {}
                     for i in range(3):
                         name = f'a{i}'
-                        portals[name] = await n.run_in_actor(name, to_run)
+                        portals[name] = await n.run_in_actor(to_run, name=name)
 
                     # wait on last actor to come up
                     async with tractor.wait_for_actor(name):
@@ -257,7 +257,10 @@ async def close_chans_before_nursery(
             get_reg = partial(aportal.run, 'self', 'get_registry')
 
             async with tractor.open_nursery() as tn:
-                portal1 = await tn.run_in_actor('consumer1', stream_forever)
+                portal1 = await tn.run_in_actor(
+                    stream_forever,
+                    name='consumer1',
+                )
                 agen1 = await portal1.result()
 
                 portal2 = await tn.start_actor('consumer2', rpc_module_paths=[__name__])

tests/test_pubsub.py

@@ -126,7 +126,10 @@ async def test_required_args(callwith_expecterror):
         async with tractor.open_nursery() as n:
             # await func(**kwargs)
             portal = await n.run_in_actor(
-                'pubber', multilock_pubber, **kwargs)
+                multilock_pubber,
+                name='pubber',
+                **kwargs
+            )
 
             async with tractor.wait_for_actor('pubber'):
                 pass
@@ -163,9 +166,17 @@ def test_multi_actor_subs_arbiter_pub(
                 )
 
             even_portal = await n.run_in_actor(
-                'evens', subs, which=['even'], pub_actor_name=name)
+                subs,
+                which=['even'],
+                name='evens',
+                pub_actor_name=name
+            )
             odd_portal = await n.run_in_actor(
-                'odds', subs, which=['odd'], pub_actor_name=name)
+                subs,
+                which=['odd'],
+                name='odds',
+                pub_actor_name=name
+            )
 
             async with tractor.wait_for_actor('evens'):
                 # block until 2nd actor is initialized

tests/test_rpc.py

@@ -80,9 +80,11 @@ def test_rpc_errors(arb_addr, to_call, testdir):
         # spawn a subactor which calls us back
         async with tractor.open_nursery() as n:
             await n.run_in_actor(
-                'subactor',
                 sleep_back_actor,
                 actor_name=subactor_requests_to,
+
+                name='subactor',
+
                 # function from the local exposed module space
                 # the subactor will invoke when it RPCs back to this actor
                 func_name=funcname,

tests/test_spawning.py

@@ -1,31 +1,33 @@
 """
 Spawning basics
 """
+from functools import partial
+
 import pytest
 import trio
 import tractor
 
 from conftest import tractor_test
 
-statespace = {'doggy': 10, 'kitty': 4}
+data_to_pass_down = {'doggy': 10, 'kitty': 4}
 
 
-async def spawn(is_arbiter):
+async def spawn(is_arbiter, data):
     namespaces = [__name__]
 
     await trio.sleep(0.1)
     actor = tractor.current_actor()
     assert actor.is_arbiter == is_arbiter
-    assert actor.statespace == statespace
+    data == data_to_pass_down
 
     if actor.is_arbiter:
         async with tractor.open_nursery() as nursery:
             # forks here
             portal = await nursery.run_in_actor(
-                'sub-actor',
                 spawn,
                 is_arbiter=False,
-                statespace=statespace,
+                name='sub-actor',
+                data=data,
                 rpc_module_paths=namespaces,
             )
 
@@ -41,10 +43,9 @@ async def spawn(is_arbiter):
 
 def test_local_arbiter_subactor_global_state(arb_addr):
     result = tractor.run(
-        spawn,
+        partial(spawn, data=data_to_pass_down),
         True,
         name='arbiter',
-        statespace=statespace,
         arbiter_addr=arb_addr,
     )
     assert result == 10
@@ -89,7 +90,10 @@ async def test_most_beautiful_word(start_method):
     """
     async with tractor.open_nursery() as n:
 
-        portal = await n.run_in_actor('some_linguist', cellar_door)
+        portal = await n.run_in_actor(
+            cellar_door,
+            name='some_linguist',
+        )
 
     # The ``async with`` will unblock here since the 'some_linguist'
     # actor has completed its main task ``cellar_door``.
@@ -119,7 +123,6 @@ def test_loglevel_propagated_to_subactor(
     async def main():
         async with tractor.open_nursery() as tn:
             await tn.run_in_actor(
-                'log_checker',
                 check_loglevel,
                 level=level,
             )

tests/test_streaming.py

@@ -62,7 +62,6 @@ async def stream_from_single_subactor(stream_func_name):
                 portal = await nursery.start_actor(
                     'streamerd',
                     rpc_module_paths=[__name__],
-                    statespace={'global_dict': {}},
                 )
 
                 seq = range(10)
@@ -186,9 +185,9 @@ async def a_quadruple_example():
         pre_start = time.time()
 
         portal = await nursery.run_in_actor(
-            'aggregator',
             aggregate,
             seed=seed,
+            name='aggregator',
         )
 
         start = time.time()
@@ -275,9 +274,9 @@ async def test_respawn_consumer_task(
     async with tractor.open_nursery() as n:
 
         stream = await(await n.run_in_actor(
-            'streamer',
             stream_data,
             seed=11,
+            name='streamer',
         )).result()
 
         expect = set(range(11))

tractor/__init__.py

@@ -16,7 +16,7 @@ from ._streaming import Context, stream
 from ._discovery import get_arbiter, find_actor, wait_for_actor
 from ._actor import Actor, _start_actor, Arbiter
 from ._trionics import open_nursery
-from ._state import current_actor
+from ._state import current_actor, is_root_process
 from . import _state
 from ._exceptions import RemoteActorError, ModuleNotExposed
 from ._debug import breakpoint, post_mortem

tractor/_actor.py

@@ -126,10 +126,17 @@ async def _invoke(
                     with cancel_scope as cs:
                         task_status.started(cs)
                         await chan.send({'return': await coro, 'cid': cid})
+
     except (Exception, trio.MultiError) as err:
-        # NOTE: don't enter debug mode recursively after quitting pdb
+
-        log.exception("Actor crashed:")
+        if not isinstance(err, trio.ClosedResourceError):
-        await _debug._maybe_enter_pm(err)
+            log.exception("Actor crashed:")
+            # XXX: is there any case where we'll want to debug IPC
+            # disconnects? I can't think of a reason that inspecting
+            # this type of failure will be useful for respawns or
+            # recovery logic - the only case is some kind of strange bug
+            # in `trio` itself?
+            await _debug._maybe_enter_pm(err)
 
         # always ship errors back to caller
         err_msg = pack_error(err)

tractor/_debug.py

@@ -305,6 +305,10 @@ post_mortem = partial(
 async def _maybe_enter_pm(err):
     if (
         _state.debug_mode()
+
+        # NOTE: don't enter debug mode recursively after quitting pdb
+        # Iow, don't re-enter the repl if the `quit` command was issued
+        # by the user.
         and not isinstance(err, bdb.BdbQuit)
 
         # XXX: if the error is the likely result of runtime-wide

tractor/_portal.py

@@ -8,6 +8,7 @@ from typing import Tuple, Any, Dict, Optional, Set, Iterator
 from functools import partial
 from dataclasses import dataclass
 from contextlib import contextmanager
+import warnings
 
 import trio
 from async_generator import asynccontextmanager
@@ -197,15 +198,34 @@ class Portal:
                 "A pending main result has already been submitted"
         self._expect_result = await self._submit(ns, func, kwargs)
 
-    async def run(self, ns: str, func: str, **kwargs) -> Any:
+    async def run(
+        self,
+        func_or_ns: str,
+        fn_name: Optional[str] = None,
+        **kwargs
+    ) -> Any:
         """Submit a remote function to be scheduled and run by actor,
         wrap and return its (stream of) result(s).
 
         This is a blocking call and returns either a value from the
         remote rpc task or a local async generator instance.
         """
+        if isinstance(func_or_ns, str):
+            warnings.warn(
+                "`Portal.run(namespace: str, funcname: str)` is now deprecated, "
+                "pass a function reference directly instead",
+                DeprecationWarning
+            )
+            fn_mod_path = func_or_ns
+            assert isinstance(fn_name, str)
+
+        else:  # function reference was passed directly
+            fn = func_or_ns
+            fn_mod_path = fn.__module__
+            fn_name = fn.__name__
+
         return await self._return_from_resptype(
-            *(await self._submit(ns, func, kwargs))
+            *(await self._submit(fn_mod_path, fn_name, kwargs))
         )
 
     async def _return_from_resptype(
@@ -274,7 +294,14 @@ class Portal:
             log.warning(
                 f"Cancelling all streams with {self.channel.uid}")
             for stream in self._streams.copy():
-                await stream.aclose()
+                try:
+                    await stream.aclose()
+                except trio.ClosedResourceError:
+                    # don't error the stream having already been closed
+                    # (unless of course at some point down the road we
+                    # won't expect this to always be the case or need to
+                    # detect it for respawning purposes?)
+                    log.debug(f"{stream} was already closed.")
 
     async def aclose(self):
         log.debug(f"Closing {self}")

tractor/_trionics.py

@@ -52,7 +52,7 @@ class ActorNursery:
         name: str,
         *,
         bind_addr: Tuple[str, int] = _default_bind_addr,
-        statespace: Optional[Dict[str, Any]] = None,
+        # statespace: Optional[Dict[str, Any]] = None,
         rpc_module_paths: List[str] = None,
         loglevel: str = None,  # set log level per subactor
         nursery: trio.Nursery = None,
@@ -67,7 +67,7 @@ class ActorNursery:
             name,
             # modules allowed to invoked funcs from
             rpc_module_paths=rpc_module_paths or [],
-            statespace=statespace,  # global proc state vars
+            # statespace=statespace,  # global proc state vars
             loglevel=loglevel,
             arbiter_addr=current_actor()._arb_addr,
         )
@@ -94,12 +94,12 @@ class ActorNursery:
 
     async def run_in_actor(
         self,
-        name: str,
         fn: typing.Callable,
         *,
+        name: Optional[str] = None,
         bind_addr: Tuple[str, int] = _default_bind_addr,
         rpc_module_paths: Optional[List[str]] = None,
-        statespace: Dict[str, Any] = None,
+        # statespace: Dict[str, Any] = None,
         loglevel: str = None,  # set log level per subactor
         **kwargs,  # explicit args to ``fn``
     ) -> Portal:
@@ -111,11 +111,16 @@ class ActorNursery:
         the actor is terminated.
         """
         mod_path = fn.__module__
+
+        if name is None:
+            # use the explicit function name if not provided
+            name = fn.__name__
+
         portal = await self.start_actor(
             name,
             rpc_module_paths=[mod_path] + (rpc_module_paths or []),
             bind_addr=bind_addr,
-            statespace=statespace,
+            # statespace=statespace,
             loglevel=loglevel,
             # use the run_in_actor nursery
             nursery=self._ria_nursery,