Metadata-Version: 2.1
Name: pannb
Version: 0.1.0
Summary: pannb—pandoc filter for ipynb
Home-page: https://github.com/ickc/pannb
License: BSD-3-Clause
Keywords: pandoc,filter,ipynb
Author: Kolen Cheung
Author-email: christian.kolen@gmail.com
Requires-Python: >=3.8
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX
Classifier: Operating System :: Unix
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Utilities
Provides-Extra: docs
Provides-Extra: extras
Provides-Extra: tests
Requires-Dist: coloredlogs (>=14,<16); extra == "extras"
Requires-Dist: coverage; extra == "tests"
Requires-Dist: coveralls; extra == "tests"
Requires-Dist: ipykernel; extra == "docs"
Requires-Dist: nbsphinx (>=0.8); extra == "docs"
Requires-Dist: pandas; extra == "docs"
Requires-Dist: panflute (>=2.1,<3.0)
Requires-Dist: pantable (>=0.14,<0.15); extra == "docs"
Requires-Dist: pytest-cov; extra == "tests"
Requires-Dist: pytest; extra == "tests"
Requires-Dist: sphinx (>=3.3,<4.0); extra == "docs"
Requires-Dist: sphinx-bootstrap-theme; extra == "docs"
Requires-Dist: sphinxcontrib-apidoc; extra == "docs"
Project-URL: Documentation, https://ickc.github.io/pannb
Project-URL: Repository, https://github.com/ickc/pannb
Description-Content-Type: text/x-rst

.. This is auto-generated from `docs/README.md`. Do not edit this file directly.

=============================
pannb—pandoc filter for ipynb
=============================

:Date:   September 2, 2021

.. contents::
   :depth: 3
..

+-------------+----------------------------------------------------------------------------------+
| docs        | |Documentation Status| |image2|                                                  |
+=============+==================================================================================+
| tests       | |GitHub Actions| |Coverage Status|                                               |
|             |                                                                                  |
|             | |Codacy Code Quality Status| |Scrutinizer Status| |CodeClimate Quality Status|   |
+-------------+----------------------------------------------------------------------------------+
| package     | |Supported versions| |Supported implementations| |PyPI Wheel|                    |
|             |                                                                                  |
|             | |PyPI Package latest release| |GitHub Releases| |Development Status| |Downloads| |
|             |                                                                                  |
|             | |Commits since latest release| |License|                                         |
+-------------+----------------------------------------------------------------------------------+
| conda-forge | |Conda Recipe| |Conda Downloads| |Conda Version| |Conda Platforms|               |
+-------------+----------------------------------------------------------------------------------+

Introduction
============

Pandoc supports ipynb format. What this does is add support of

1. jupytext style yaml metadata block
2. filter out the Python code block
3. convert raw block to native pandoc AST, e.g.

   -  if a cell outputs HTML, then it is an HTML raw block by default, meaning only HTML-like output formats contains these output cells. This filter convert them using pandoc itself to native pandoc AST so that any output formats will contains the same output.

These 3 filters are implemented as 3 individual functions, so that you can cherry-pick your own combinations (See `API doc <../api/pannb/>`__). The command line program ``pannb`` have all 3 included.

Example
=======

See ``docs/example.ipynb`` for the input notebook and its `output without the filter <../example/>`__ and `output with the filter <../example-output/>`__. Note that the output will be correct only if you set ``--ipynb-output=html`` after `this patch is merged <https://github.com/jgm/pandoc/pull/7538>`__.

.. |Documentation Status| image:: https://readthedocs.org/projects/pannb/badge/?version=latest
   :target: https://pannb.readthedocs.io/en/latest/?badge=latest&style=plastic
.. |image1| image:: https://github.com/ickc/pannb/workflows/GitHub%20Pages/badge.svg
   :target: https://ickc.github.io/pannb
.. |GitHub Actions| image:: https://github.com/ickc/pannb/workflows/Python%20package/badge.svg
.. |Coverage Status| image:: https://codecov.io/gh/ickc/pannb/branch/master/graphs/badge.svg?branch=master
   :target: https://codecov.io/github/ickc/pannb
.. |Codacy Code Quality Status| image:: https://img.shields.io/codacy/grade/078ebc537c5747f68c1d4ad3d3594bbf.svg
   :target: https://www.codacy.com/app/ickc/pannb
.. |Scrutinizer Status| image:: https://img.shields.io/scrutinizer/quality/g/ickc/pannb/master.svg
   :target: https://scrutinizer-ci.com/g/ickc/pannb/
.. |CodeClimate Quality Status| image:: https://codeclimate.com/github/ickc/pannb/badges/gpa.svg
   :target: https://codeclimate.com/github/ickc/pannb
.. |Supported versions| image:: https://img.shields.io/pypi/pyversions/pannb.svg
   :target: https://pypi.org/project/pannb
.. |Supported implementations| image:: https://img.shields.io/pypi/implementation/pannb.svg
   :target: https://pypi.org/project/pannb
.. |PyPI Wheel| image:: https://img.shields.io/pypi/wheel/pannb.svg
   :target: https://pypi.org/project/pannb
.. |PyPI Package latest release| image:: https://img.shields.io/pypi/v/pannb.svg
   :target: https://pypi.org/project/pannb
.. |GitHub Releases| image:: https://img.shields.io/github/tag/ickc/pannb.svg?label=github+release
   :target: https://github.com/ickc/pannb/releases
.. |Development Status| image:: https://img.shields.io/pypi/status/pannb.svg
   :target: https://pypi.python.org/pypi/pannb/
.. |Downloads| image:: https://img.shields.io/pypi/dm/pannb.svg
   :target: https://pypi.python.org/pypi/pannb/
.. |Commits since latest release| image:: https://img.shields.io/github/commits-since/ickc/pannb/v0.1.0.svg
   :target: https://github.com/ickc/pannb/compare/v0.1.0...master
.. |License| image:: https://img.shields.io/pypi/l/pannb.svg
.. |Conda Recipe| image:: https://img.shields.io/badge/recipe-pannb-green.svg
   :target: https://anaconda.org/conda-forge/pannb
.. |Conda Downloads| image:: https://img.shields.io/conda/dn/conda-forge/pannb.svg
   :target: https://anaconda.org/conda-forge/pannb
.. |Conda Version| image:: https://img.shields.io/conda/vn/conda-forge/pannb.svg
   :target: https://anaconda.org/conda-forge/pannb
.. |Conda Platforms| image:: https://img.shields.io/conda/pn/conda-forge/pannb.svg
   :target: https://anaconda.org/conda-forge/pannb
.. |image2| image:: https://github.com/ickc/pannb/workflows/GitHub%20Pages/badge.svg
   :target: https://ickc.github.io/pannb

