Stone is an interface description language (IDL) and a suite of tools for defining APIs and generating client/server code in various languages. It is primarily used by Dropbox for its API development. The current version is 3.3.9, and it maintains an active release cadence with frequent patch updates and occasional minor feature additions.
pip install stoneVerified import paths — ran on the pinned version, not inferred.
This quickstart demonstrates how to programmatically parse a simple Stone IDL specification using the `stone` library, accessing its Intermediate Representation (IR). It creates a temporary '.stone' file, parses it, and prints details about the defined namespace, structs, and routes. It does not perform actual code generation to keep the example concise and runnable without side effects.
Understand Stone's role as a code generation tool. Use the generated client code for API interactions, not the `stone` library itself.
Review generated code diffs after updating Stone. Ensure your build systems are resilient to potential reordering of generated elements. If relying on stable output, use Stone v3.3.9 or newer and ensure generated files are committed or cached appropriately.
Ensure your environment uses Python 3.10 or older if you need `distutils`. For `stone` v3.3.7+, any custom build logic interacting with Stone's setup should adapt to use `setuptools` based mechanisms or avoid direct interaction with internal build components.
No dependency data recorded yet.