Skip to content

DEVELOPERS.md

Latest commit

 

History

History
180 lines (130 loc) · 3.43 KB

DEVELOPERS.md

File metadata and controls

180 lines (130 loc) · 3.43 KB

Io Developer Quick Start

Welcome to Io development! This guide gets you up and running in minutes.

🚀 One-Line Setup

./setup.sh

This script will check requirements, build Io, run tests, and set up your development environment.

📦 Manual Setup

If you prefer manual setup:

# 1. Clone with submodules
git clone --recursive https://github.com/IoLanguage/io.git
cd io

# 2. Build
make build    # or: make debug for debug build

# 3. Test
make test

# 4. Start coding!
make repl

🛠️ Development Workflow

Common Tasks

make help      # Show all available commands
make dev       # Quick incremental build
make test      # Run test suite
make format    # Format C code
make check     # Static analysis

Quick Commands

  • make b - Build
  • make t - Test
  • make r - REPL
  • make c - Clean

Testing Your Changes

# Run all tests
make test

# Run specific test
./build/_build/binaries/io libs/iovm/tests/correctness/ListTest.io

# Test samples
make test-all

Before Committing

  1. Run tests: make test
  2. Check formatting: make format
  3. Run static analysis: make check

The pre-commit hook will automatically run quick checks.

🏗️ Project Structure

io/
├── libs/
│   ├── basekit/        # Foundation utilities
│   ├── coroutine/      # Coroutine implementation
│   ├── garbagecollector/ # Memory management
│   └── iovm/           # Virtual machine core
│       ├── source/     # C implementation
│       └── io/         # Io standard library
├── samples/            # Example programs
├── docs/              # Documentation
└── build/             # Build output (generated)

🐛 Debugging

Debug Build

make debug

With GDB

gdb ./build/_build/binaries/io
(gdb) run script.io

With Valgrind

valgrind --leak-check=full ./build/_build/binaries/io script.io

Print Debugging in Io

obj println          # Print object
obj slotNames        # Show slots
obj proto            # Show prototype
thisContext          # Current context
System backtrace     # Stack trace

🔍 Finding Things

Search for C functions

grep -r "IoObject_" libs/iovm/source/

Search for Io methods

grep -r "method(" libs/iovm/io/

Find test examples

ls libs/iovm/tests/correctness/*Test.io

📝 Code Style

C Code

  • Use tabs for indentation
  • Pattern: IoObjectName_methodName
  • Keep functions focused

Io Code

  • Use tabs for indentation
  • camelCase for methods
  • PascalCase for objects

🚢 Submitting Changes

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Run tests
  5. Submit a pull request

See CONTRIBUTING.md for detailed guidelines.

💡 Tips

  • Start with small changes to understand the codebase
  • Read existing tests for API examples
  • The samples/ directory has many examples
  • Join discussions on GitHub Issues
  • Ask questions! The community is helpful

📚 Resources

🆘 Getting Help

  • GitHub Issues for bugs/features
  • GitHub Discussions for questions
  • IRC: #io on irc.freenode.net
  • Mailing list: iolanguage@googlegroups.com

Happy hacking! 🎉