Project Structure

Recommended layout

your-project/
  src/
    main.aja
    service/
      user.aja
  libs/
  tests/
  aja.toml
  requirements.txt
  requirements.lock

What each part is for

• src/: your application modules

• libs/: local reusable modules before publishing

• tests/: test programs and fixtures

• requirements.txt: dependency declarations

• requirements.lock: pinned versions + hashes

Naming and import style

• Use lowercase module filenames.

• Keep module names stable; treat them as public API once reused.

• Prefer selective import when you only need a few symbols.

import (
    {parse_user validate_user} from "service/user"
)

Venv and site-packages

Use a virtual environment for isolated dependencies:

./ajasendiri venv .venv
. .venv/bin/activate
ajasendiri mmk install

With active venv, modules resolve from $AJA_VENV/site-packages first.