aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/docs/source/usage.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/source/usage.md')
-rw-r--r--docs/source/usage.md58
1 files changed, 58 insertions, 0 deletions
diff --git a/docs/source/usage.md b/docs/source/usage.md
new file mode 100644
index 0000000..33481ca
--- /dev/null
+++ b/docs/source/usage.md
@@ -0,0 +1,58 @@
+# Usage Instructions for TRPG Log Processor
+
+## Overview
+
+The TRPG Log Processor is a Python SDK designed for structured processing of tabletop role-playing game (TRPG) logs. It provides functionalities for parsing logs, extracting rules, and rendering outputs in multiple formats.
+
+## Installation
+
+To install the TRPG Log Processor, you can use pip:
+
+```bash
+pip install conventionalrp
+```
+
+## Basic Usage
+
+Here is a simple example of how to use the TRPG Log Processor:
+
+```python
+from conventionalrp.core.parser import Parser
+from conventionalrp.core.processor import Processor
+from conventionalrp.extractors.rule_extractor import RuleExtractor
+from conventionalrp.renderers.html_renderer import HTMLRenderer
+
+# Step 1: Load rules
+rule_extractor = RuleExtractor()
+rules = rule_extractor.load_rules('path/to/rules.json')
+
+# Step 2: Parse the log
+parser = Parser(rules)
+parsed_log = parser.parse_log('path/to/log.txt')
+
+# Step 3: Process the parsed tokens
+processor = Processor()
+output = processor.process_tokens(parsed_log)
+
+# Step 4: Render the output
+renderer = HTMLRenderer()
+html_output = renderer.render(output)
+
+# Save or display the output
+with open('output.html', 'w') as f:
+ f.write(html_output)
+```
+
+## Features
+
+- **Rule Extraction**: Easily extract rules from JSON configuration files using the `RuleExtractor`.
+- **Multi-format Rendering**: Render outputs in various formats such as HTML, Markdown, and JSON using the respective renderer classes.
+- **Extensibility**: Create custom plugins to extend the functionality of the SDK.
+
+## Custom Plugins
+
+To create a custom plugin, you can follow the example provided in `examples/custom_plugin.py`. This allows you to add additional processing or rendering capabilities tailored to your needs.
+
+## Documentation
+
+For more detailed information on the API and available classes, please refer to the [API documentation](api.md).