DOC: Add simple automodule

doc/source/conf.py

@@ -28,6 +28,9 @@
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.napoleon",
+    "sphinx_tabs.tabs",
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -44,7 +47,7 @@
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 #
-html_theme = 'alabaster'
+html_theme = 'sphinx_rtd_theme'
 
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,

doc/source/index.rst

@@ -6,9 +6,12 @@
 Welcome to tabslash's documentation!
 ====================================
 
+.. automodule:: tabslash.tabslash
+    :members:
+
 .. toctree::
-   :maxdepth: 2
-   :caption: Contents:
+    :maxdepth: 2
+    :caption: Contents:
 
 
 

src/tabslash/__init__.py

@@ -1,2 +1,2 @@
 from tabslash.tabslash import foo
-from version import __version__
+from tabslash.version import __version__

src/tabslash/tabslash.py

@@ -4,3 +4,11 @@ def foo(a, b, /):
     """Calculate a thing on two arguments, currently the sum."""
     return a + b
 
+def bar(a, /, b, *, c=1):
+    """Calculate c * (a ** b), with c defaulting to one.
+
+    `a` is positional-only, `b` is general,
+    `c` is keyword-only.
+
+    """
+    return c * (a ** b)