Metadata-Version: 2.4
Name: sdbtool
Version: 0.3.2
Summary: Dump SDB file to xml using apphelp.dll
Project-URL: Homepage, https://pypi.org/project/sdbtool/
Project-URL: Changelog, https://github.com/learn-more/sdbtool/releases
Project-URL: Issues, https://github.com/learn-more/sdbtool/issues
Project-URL: CI, https://github.com/learn-more/sdbtool/actions
Project-URL: Repository, https://github.com/learn-more/sdbtool
Author-email: Mark Jansen <mark.jansen@reactos.org>
License-Expression: MIT
License-File: LICENSE.txt
Keywords: appcompat,apphelp,sdb,sdb2xml,sdbtool,shim,shimeng
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Requires-Dist: click>=8.2.1
Description-Content-Type: text/markdown

# sdbtool

A tool for converting Microsoft Application Compatibility Database (SDB) files to XML format.

## Table of Contents

1. [Features](#features)
1. [Getting Started](#getting-started)
1. [Contributing](#contributing)
1. [License](#license)

## Features<a id="features"></a>

- Parses SDB files used by Windows for application compatibility.
- Converts SDB data into readable XML.
- Useful for analysis, migration, or documentation.


## Getting Started<a id="getting-started"></a>

### Installation

Sdbtool is available as [`sdbtool`](https://pypi.org/project/sdbtool/) on PyPI.

Invoke sdbtool directly with [`uvx`](https://docs.astral.sh/uv/):

```shell
uvx sdbtool your.sdb                    # Convert the file 'your.sdb' to xml, and print it to the console
uvx sdbtool your.sdb --output your.xml  # Convert the file 'your.sdb' to xml, and write it to 'your.xml'
```

Or install sdbtool with `uv` (recommended), `pip`, or `pipx`:

```shell
# With uv.
uv tool install sdbtool@latest  # Install sdbtool globally.

# With pip.
pip install sdbtool

# With pipx.
pipx install sdbtool
```

## Contributing<a id="contributing"></a>

Contributions are welcome! Please open issues or submit pull requests.

## License<a id="license"></a>

This project is licensed under the MIT License.
