Metadata-Version: 2.1
Name: sphinx-bazel
Version: 0.1.5
Summary: Sphinx bazel extension to include content from bazel files.
Home-page: http://github.com/useblocks/sphinx-bazel
Author: team useblocks
Author-email: info@useblocks.com
License: Apache 2.0
Download-URL: http://pypi.python.org/pypi/sphinx-bazel
Platform: any
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Documentation
Classifier: Topic :: Utilities
Requires-Dist: Sphinx

**Complete, rendered documentation**: http://sphinx-bazel.readthedocs.io/en/latest/

Sphinx-Bazel
============

Sphinx extension to provide information from bazel files to sphinx based documentations.


Installation
------------
.. code-block:: bash

   pip install sphinx-bazel


Usage
-----

Add ``sphinxcontrib.sphinx_bazel`` to the extension list of ``conf.py``::

   extensions = [
       'sphinx.ext.autodoc',
       'sphinx.ext.todo',
       'sphinx.ext.viewcode',
       'sphinxcontrib.sphinx_bazel',  # <-- That's our extension
   ]

Now you can start to use ``Sphinx-Bazel`` inside your project.

For instance open ``index.rst`` file and add::

   .. autobazel-workspace:: <path_to_bazel_workspace>
      :packages:

Where ``<path_to_bazel_workspace>`` must be an absolute path or a relative path to the location of the ``conf.py`` file
of your documentation project.

Fore more examples and a complete documentation, please visit http://sphinx-bazel.readthedocs.io/en/latest/

