{"id":23138,"library":"ozi","title":"OZI - Package Python projects with Meson","description":"OZI is a build system helper that wraps Meson to simplify packaging Python projects. It provides project scaffolding, dependency management, and automated builds for C extensions. Current version 2.1.31, requires Python 3.10-3.13. Active development with monthly releases.","status":"active","version":"2.1.31","language":"python","source_language":"en","source_url":"https://gitlab.com/ozi/ozi","tags":["build","meson","packaging","c-extension","scaffolding"],"install":[{"cmd":"pip install ozi","lang":"bash","label":"Latest stable"}],"dependencies":[{"reason":"Core build system","package":"meson","optional":false},{"reason":"Build backend for Meson","package":"ninja","optional":false}],"imports":[{"note":"OZI is a class; direct import of module not useful.","wrong":"import ozi","symbol":"OZI","correct":"from ozi import OZI"},{"note":"Common entry point for project operations.","symbol":"Project","correct":"from ozi.project import Project"}],"quickstart":{"code":"from ozi import OZI\nimport os\n\n# Initialize OZI with a project path\nproj_path = os.path.expanduser('~/my_project')\nozi = OZI(proj_path)\n\n# Create a new project scaffold\nos.environ['OZI_PROJECT_NAME'] = 'example'\nozi.create_project()\n\nprint('Project created at', proj_path)","lang":"python","description":"Initialize OZI and create a new project scaffold. Requires OZI_PROJECT_NAME environment variable."},"warnings":[{"fix":"Migrate manually or use `ozi scaffold` to generate a new template.","message":"OZI v2 removes the `meson.build` template auto-generation; you must provide your own Meson configuration.","severity":"breaking","affected_versions":"<2.0 -> >=2.0"},{"fix":"Replace `ozi.dist(...)` with `Project(proj_path).build(...)`.","message":"The `OZI.dist()` method is deprecated since v2.1. Use `Project.build()` instead.","severity":"deprecated","affected_versions":"2.0 - 2.1.x"},{"fix":"Use Python 3.10-.13 for now.","message":"OZI does not support Python 3.14 yet despite declaring `<3.14`. The version constraint actually limits to 3.13 max.","severity":"gotcha","affected_versions":">=2.1"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run `pip install ozi` in your active environment.","cause":"OZI not installed or installed in wrong environment.","error":"ModuleNotFoundError: No module named 'ozi'"},{"fix":"Use `from ozi import OZI`.","cause":"Importing module instead of class.","error":"AttributeError: module 'ozi' has no attribute 'OZI'"},{"fix":"Create a meson.build file or use `ozi scaffold` to generate one.","cause":"OZI v2 requires a pre-existing meson.build file.","error":"OSError: [Errno 2] No such file or directory: '.../meson.build'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}