Merge remote-tracking branch 'origin/docs-master'

* origin/docs-master:
  Import debug helper macros.
  Add extra/ to .gitignore.
  Import include processing bench
  docs: Get rid of a ton of blocking resources from theme.
  docs: update stats
  docs: update download link.
  docs: Google site verification
  Update README link
  docs: move confusing install step to noteworthy difference

.gitignore

@@ -13,3 +13,4 @@ docs/_build/
 htmlcov/
 *.egg-info
 __pycache__/
+extra

README.md

@@ -2,7 +2,7 @@
 # Mitogen
 
 <!-- [![Build Status](https://travis-ci.org/dw/mitogen.png?branch=master)](https://travis-ci.org/dw/mitogen}) -->
-<a href="https://mitogen.readthedocs.io/">Please see the documentation</a>.
+<a href="https://mitogen.networkgenomics.com/">Please see the documentation</a>.
 
 ![](https://i.imgur.com/eBM6LhJ.gif)
 

docs/_templates/layout.html

@@ -1,19 +1,35 @@
 {% extends "!layout.html" %}
 {% set css_files = css_files + ['_static/style.css'] %}
 
+{# We don't support Sphinx search, so don't let its JS either. #}
+{% block scripts %}
+{% endblock %}
+
+{# Alabaster ships a completely useless custom.css, suppress it. #}
+{%- block extrahead %}
+    <meta name="google-site-verification" content="oq5hNxRYo25tcfjfs3l6pPxfNgY3JzDYSpskc9q4TYI" />
+    <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
+{% endblock %}
+
 {% block footer %}
     {{ super() }}
 
     <script>
       (function() {
         {% include "piwik-config.js" %}
-        var u="https://k1.botanicus.net/tr/";
+        var u="https://networkgenomics.com/p/tr/";
         _paq.push(['setTrackerUrl', u+'ep']);
         var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0]; g.type='text/javascript';
         g.defer=true; g.async=true; g.src=u+'js'; s.parentNode.insertBefore(g,s);
       })();
     </script>
-    <noscript><p><img src="https://k1.botanicus.net/tr/ep?idsite=6" style="border:0" alt=""></p></noscript>
+
+    <noscript>
+        <p>
+        {% set fulltitle = (title|striptags|e) + titlesuffix -%}
+        <img src="https://networkgenomics.com/p/tr/ep?idsite=6&action_name={{fulltitle}}" style="border:0" alt="">
+        </p>
+    </noscript>
 
     <script async defer src="https://buttons.github.io/buttons.js"></script>
 {% endblock %}

docs/ansible_detailed.rst

@@ -75,13 +75,7 @@ Installation
    ``mitogen_host_pinned`` strategies exists to mimic the ``free`` and
    ``host_pinned`` strategies.
 
-4. If targets have a restrictive ``sudoers`` file, add a rule like:
+4.
-
-   ::
-
-       deploy = (ALL) NOPASSWD:/usr/bin/python -c*
-
-5.
 
    .. raw:: html
 
@@ -103,7 +97,6 @@ Installation
     </form>
 
 
-
 Demo
 ~~~~
 
@@ -172,6 +165,14 @@ Noteworthy Differences
 * The ``doas``, ``su`` and ``sudo`` become methods are available. File bugs to
   register interest in more.
 
+* The ``sudo`` comands executed differ slightly compared to Ansible. In some
+  cases where the target has a ``sudo`` configuration that restricts the exact
+  commands allowed to run, it may be necessary to add a ``sudoers`` rule like:
+
+  ::
+
+       your_ssh_username = (ALL) NOPASSWD:/usr/bin/python -c*
+
 * The `docker <https://docs.ansible.com/ansible/2.6/plugins/connection/docker.html>`_,
   `jail <https://docs.ansible.com/ansible/2.6/plugins/connection/jail.html>`_,
   `kubectl <https://docs.ansible.com/ansible/2.6/plugins/connection/kubectl.html>`_,

docs/conf.py

@@ -5,8 +5,8 @@ sys.path.append('..')
 import mitogen
 VERSION = '%s.%s.%s' % mitogen.__version__
 
-author = u'David Wilson'
+author = u'Network Genomics'
-copyright = u'2019, David Wilson'
+copyright = u'2019, Network Genomics'
 exclude_patterns = ['_build']
 extensions = ['sphinx.ext.autodoc', 'sphinx.ext.intersphinx', 'sphinxcontrib.programoutput']
 html_show_sourcelink = False
@@ -39,6 +39,6 @@ rst_epilog = """
 
 .. |mitogen_version| replace:: %(VERSION)s
 
-.. |mitogen_url| replace:: `mitogen-%(VERSION)s.tar.gz <https://files.pythonhosted.org/packages/source/m/mitogen/mitogen-%(VERSION)s.tar.gz>`__
+.. |mitogen_url| replace:: `mitogen-%(VERSION)s.tar.gz <https://networkgenomics.com/try/mitogen-%(VERSION)s.tar.gz>`__
 
 """ % locals()

scripts/debug-helpers.sh

@@ -0,0 +1,39 @@
+#
+# Bash helpers for debugging.
+#
+
+# Tell Ansible to write PID files for the mux and top-level process to CWD.
+export MITOGEN_SAVE_PIDS=1
+
+
+# strace -ff -p $(muxpid)
+muxpid() {
+    cat .ansible-mux.pid
+}
+
+# gdb -p $(anspid)
+anspid() {
+    cat .ansible-controller.pid
+}
+
+# perf top -git $(muxtids)
+# perf top -git $(muxtids)
+muxtids() {
+    ls /proc/$(muxpid)/task | tr \\n ,
+}
+
+# perf top -git $(anstids)
+anstids() {
+    ls /proc/$(anspid)/task | tr \\n ,
+}
+
+# ttrace $(muxpid) [.. options ..]
+#   strace only threads of PID, not children
+ttrace() {
+    local pid=$1; shift;
+    local s=""
+    for i in $(ls /proc/$pid/task) ; do
+        s="-p $i $s"
+    done
+    strace $s "$@"
+}

tests/ansible/bench/_includes.yml

@@ -0,0 +1 @@
+- meta: end_play

tests/ansible/bench/includes.yml

@@ -0,0 +1,4 @@
+- hosts: test-targets
+  tasks:
+  - include_tasks: _includes.yml
+    with_sequence: start=1 end=1000