Metadata-Version: 2.1
Name: arguebuf
Version: 2.0.0b8
Summary: A library for loading argument graphs in various formats (e.g., AIF).
Home-page: https://recap.uni-trier.de
License: MIT
Author: Mirko Lenz
Author-email: info@mirko-lenz.de
Requires-Python: >=3.9,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Provides-Extra: cli
Provides-Extra: docs
Provides-Extra: graphviz
Requires-Dist: arg-services (>=1.0.4,<2.0.0)
Requires-Dist: autodocsumm (>=0.2.9,<0.3.0) ; extra == "docs"
Requires-Dist: deepl (>=1.12.0,<2.0.0) ; extra == "cli"
Requires-Dist: furo (>=2022.12.7,<2023.0.0) ; extra == "docs"
Requires-Dist: graphviz (>=0.20.1,<0.21.0)
Requires-Dist: lxml (>=4.9.2,<5.0.0)
Requires-Dist: multimethod (>=1.9.1,<2.0.0) ; extra == "cli"
Requires-Dist: myst-parser (>=0.18.1,<0.19.0) ; extra == "docs"
Requires-Dist: networkx (>=2.8.8,<4.0)
Requires-Dist: pendulum (>=2.1.2,<3.0.0)
Requires-Dist: pygraphviz (>=1.10,<2.0) ; extra == "graphviz"
Requires-Dist: sphinx (>=5.0.0,<6.0.0) ; extra == "docs"
Requires-Dist: sphinx-autoapi (>=2.0.0,<3.0.0) ; extra == "docs"
Requires-Dist: typer[all] (>=0.7.0,<0.8.0) ; extra == "cli"
Project-URL: Documentation, https://arguebuf.readthedocs.io/en/latest
Project-URL: Repository, https://github.com/recap-utr/arguebuf-python
Description-Content-Type: text/markdown

# Arguebuf

Arguebuf is a format for serializing argument graphs and specified using Protobuf.
The complete specification and documentation is available at the [Buf Schema Registry](https://buf.build/recap/arg-services/docs/main:arg_services.graph.v1).
While Protobuf automatically generates native code for all major programming languages (including Python), we created a custom implementation that provides some additional benefits, including:

- The ability to import existing formats like [AIF](http://www.argumentinterchange.org), [SADFace](https://github.com/Open-Argumentation/SADFace), and a few others.
- Export of Arguebuf graphs to AIF, [NetworkX](https://networkx.org), and [Graphviz](https://graphviz.org).
- Integration with the popular NLP library [spaCy](http://spacy.io).
- Various helper methods to programmatically manipulate/create argument graphs.
- More pythonic interfaces than the regular code generated by `protoc`.

You can easily install the library from [PyPI](https://pypi.org/project/arguebuf/) using pip. The documentation is hosted on [ReadTheDocs](https://arguebuf.readthedocs.io/en/latest/)

## Command Line Interface (CLI)

We also offer some tools to simplify dealing with structured argument graphs.
Among others, it is possible to convert graphs between different formats, translate them, and render images using graphviz.
To use it, install the `cli` extras when installing the package.
When using `pip`, this can be accomplished with

`pip install arguebuf[cli]`

Afterwards, you can execute it by calling `arguebuf`, for example:

`arguebuf --help`

