Metadata-Version: 2.4
Name: foxlift
Version: 0.1.0
Summary: Visual FoxPro decompiler — compiled binary in, buildable project out
Author: Timo Bejan
License-Expression: AGPL-3.0-only
Project-URL: Homepage, https://foxlift.dev
Project-URL: Documentation, https://foxlift.dev
Project-URL: Repository, https://github.com/foxlift/foxlift
Project-URL: Issues, https://github.com/foxlift/foxlift/issues
Project-URL: Changelog, https://github.com/foxlift/foxlift/releases
Project-URL: Commercial licensing, https://github.com/foxlift/foxlift/blob/main/COMMERCIAL-LICENSE.md
Keywords: visual-foxpro,vfp,decompiler,reverse-engineering
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Disassemblers
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: COPYRIGHT
Provides-Extra: test
Requires-Dist: pytest>=8.3; extra == "test"
Dynamic: license-file

# FoxLift

[![CI](https://github.com/foxlift/foxlift/actions/workflows/ci.yml/badge.svg)](https://github.com/foxlift/foxlift/actions/workflows/ci.yml)
[![PyPI](https://img.shields.io/pypi/v/foxlift.svg)](https://pypi.org/project/foxlift/)
[![Python](https://img.shields.io/pypi/pyversions/foxlift.svg)](https://pypi.org/project/foxlift/)
[![License: AGPL v3](https://img.shields.io/badge/license-AGPL--3.0-blue.svg)](https://github.com/foxlift/foxlift/blob/main/LICENSE)

FoxLift is an open-source Visual FoxPro 9 decompiler. It reads compiled VFP files and produces a source tree that can be inspected, versioned, and rebuilt where the input is fully supported.

FoxLift is under active development. Treat output as unverified unless the command reports `"verified": true`.

## Install

Install the command with [pipx](https://pipx.pypa.io/) or [uv](https://docs.astral.sh/uv/):

```console
pipx install foxlift
# or
uv tool install foxlift
```

To install into the current Python environment instead:

```console
python -m pip install foxlift
```

## Use

Inspect a compiled file without writing output:

```console
foxlift inspect app.exe --json
```

Decompile it to a directory:

```console
foxlift decompile app.exe -o recovered
```

`decompile` exits with `0` only when every discovered section was lifted inside the supported slice. Exit code `2` means partial output was written but could not be fully verified. Invalid or unsupported input exits with `1`.

FoxLift works offline and does not require Visual FoxPro at runtime.

A worked example ships in [demo/](demo/): authored source, compiled on a real VFP9, decompiled with this CLI, recompiled byte-identical — with every exit code, hash, and per-section verdict recorded in its receipts.

## Website

The FoxLift landing page is an Astro static site deployed through Cloudflare Workers.

```bash
npm install
npm run dev
npm run check
npm run build
```

`npm run deploy` builds the site and publishes the `dist/` assets with Wrangler.

## Scope

FoxLift targets unprotected Visual FoxPro 9 artifacts, including `.fxp`, `.app`, `.exe`, `.scx`, `.vcx`, `.frx`, and `.mnx` files. Coverage varies by format and language feature while development continues.

Decompiler output is functionally equivalent source, not the original source. Comments are not present in compiled bytecode, and some expressions lose their original spelling during compilation. Protected or encrypted applications are not supported.

Only decompile software you own or are authorized to inspect.

## Contributing

See [CONTRIBUTING.md](https://github.com/foxlift/foxlift/blob/main/CONTRIBUTING.md) for setup and contribution rules. Do not submit proprietary binaries, confidential data, or output derived from ReFox.

FoxLift is licensed under the [GNU Affero General Public License v3.0](https://github.com/foxlift/foxlift/blob/main/LICENSE). [Separate commercial terms](https://github.com/foxlift/foxlift/blob/main/COMMERCIAL-LICENSE.md) may be available for proprietary integrations that cannot comply with the AGPL. The FoxLift name and logo are covered by the [trademark policy](https://github.com/foxlift/foxlift/blob/main/TRADEMARKS.md). Project updates are published at [foxlift.dev](https://foxlift.dev).
