Modular Community Submission Guide

Historical submission notes from an earlier release cycle. For current operational steps, use docs/SUBMITTING_TO_MODULAR_COMMUNITY.md and docs/PRE_SUBMISSION_VALIDATION.md.

This document outlines the steps to submit mojo-toml to the modular-community channel and announce it on the forum.

📦 Step 1: Submit to modular-community

1.1 Fork the Repository

  1. Go to https://github.com/modular/modular-community
  2. Click “Fork” to create your own copy

1.2 Create Package Recipe

  1. Clone your fork:

    git clone https://github.com/YOUR_USERNAME/modular-community.git
cd modular-community

  2. Create the package directory:

    mkdir -p recipes/mojo-toml

  3. Copy files from mojo-toml repo:

    cp /path/to/mojo-toml/packaging/recipe.yaml recipes/mojo-toml/
cp /path/to/mojo-toml/packaging/test_package.mojo recipes/mojo-toml/

  4. Commit and push:

    git add recipes/mojo-toml/
git commit -m "Add mojo-toml v0.9.1 - Native TOML parser for Mojo"
git push origin main

1.3 Create Pull Request

  1. Go to your fork on GitHub

  2. Click “Contribute” → “Open pull request”

  3. Title: Add mojo-toml v0.9.1 - Native TOML parser

  4. Description:

    ## Package: mojo-toml v0.9.1

A native TOML 1.0 parser for Mojo with zero Python dependencies.

### Features
- Complete TOML 1.0 syntax support
- 168 comprehensive tests
- Performance: 26μs for simple parses, 2ms for real files
- Nested tables, dotted keys, duplicate detection
- Clear error messages with line/column context

### Repository
- GitHub: https://github.com/DataBooth/mojo-toml
- Release: https://github.com/DataBooth/mojo-toml/releases/tag/v0.9.1
- License: MIT

### Testing
Package includes test_package.mojo which validates:
- Simple key-value parsing
- Integer and array parsing
- Nested table structures
- Dotted key functionality

All 168 tests pass in the source repository.

  5. Submit the PR and wait for review

📢 Step 2: Post on Modular Forum

2.2 Create Forum Post

Use FORUM_ANNOUNCEMENT.md as a historical template, then update version, test-count, and roadmap content for the current release:

Title: 🔥 Announcing mojo-toml v0.9.1 - Native TOML Parser for Mojo

Category: Community Showcase

Tags: mojo, toml, parser, library, configuration

Content: Start from FORUM_ANNOUNCEMENT.md, but edit all release-specific values before posting.

2.3 Engage with Community

  • Respond to questions and feedback
  • Share updates on the PR status
  • Consider creating a follow-up post when package is available via pixi

📝 Files Created

The following files have been created in your mojo-toml repository:

  1. packaging/recipe.yaml - Rattler-build recipe for conda packaging
    • Defines package metadata, dependencies, build steps
    • Includes comprehensive description and links
  2. packaging/test_package.mojo - Installation verification tests
    • Tests basic parsing functionality
    • Validates arrays, tables, and dotted keys
    • Ensures package is properly installed
  3. FORUM_ANNOUNCEMENT.md - Forum post content
    • Comprehensive announcement with examples
    • Feature highlights and performance metrics
    • Installation instructions and roadmap
  4. MODULAR_COMMUNITY_SUBMISSION.md - This guide

✅ Checklist

Before Submission

During Submission

After Submission

💡 Tips

  1. Respond quickly to PR feedback - the Modular team is responsive
  2. Be active on the forum - engage with people trying your package
  3. Update the recipe when you release new versions
  4. Document usage examples in your README
  5. Consider writing a blog post or tutorial once accepted

🎯 Expected Timeline

  • PR review: 1-5 business days
  • Package availability: Shortly after PR merge
  • Community feedback: Immediate on forum

Good luck with the submission! 🚀