nexus-workshops/weevil
1
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases 7 Wiki Activity

7 Releases 8 Tags

RSS Feed
  • v1.1.0-rc1 9af6015aa3
    Compare

    v1.1.0-rc1 Pre-Release

    eric released this 2026-02-03 16:52:08 +00:00 | 0 commits to master since this release

    Weevil v1.1.0-rc1 Release Notes

    Release Candidate 1 - February 3, 2026

    What's New in v1.1.0

    Template System 🎯

    Transform Weevil from "empty project generator" to "start with professional code."

    Three templates available:

    1. basic (default) - Minimal FTC project

      • Clean starting point (~10 files)
      • Perfect for teams starting from scratch

    2. testing - Professional testing showcase

      • 45 comprehensive tests (all passing in < 2 seconds)
      • 3 complete subsystems with hardware abstraction
      • Learn from working, tested code
      • ~30 files, professional documentation

    3. localization - Grid-based robot positioning (NEW!)

      • 12x12 field grid system (12-inch cells)
      • Multi-sensor fusion (encoders + IMU + vision)
      • Fault-tolerant positioning with graceful degradation
      • Kalman-filter-style sensor combination
      • ~21 files, 3 passing tests

    Usage:

    weevil new my-robot                      # Uses basic template
weevil new my-robot --template testing   # Uses testing template
weevil new my-robot --template localization  # Uses localization template
weevil new --list-templates              # Show all templates

    Core Improvements

    • Android Studio Integration - One-click build/deploy from IDE
    • Proxy Support - Works in corporate/school environments
    • System Diagnostics - weevil doctor command for troubleshooting
    • Dependency Cleanup - weevil uninstall command

    Bug Fixes

    • Fixed Android Studio run configurations on Windows (cmd.exe path issue)
    • Fixed template test count assertion for 3 templates

    Installation

    # Download from GitHub releases
# Extract and add to PATH
weevil --version  # Should show v1.1.0-rc1

    Testing Status

    • ✅ All 62 tests passing
    • ✅ Cross-platform (Windows, Linux, macOS)
    • ✅ Zero compiler warnings
    • ✅ Template system fully functional
    • ✅ Android Studio integration verified

    Known Issues

    None - ready for production use!

    What's Next (v1.2.0)

    • Template metadata system with rich display
    • Package ecosystem (weevil add command)
    • Additional templates (autonomous patterns)

    Feedback

    Report issues or suggestions on GitHub or contact Nexus Workshops LLC.

    Nexus Workshops LLC
    FTC Software Engineering Excellence

    Downloads
  • v1.1.0-beta.2 e605b1cd3e
    Compare

    v1.1.0-beta.2 Pre-Release

    eric released this 2026-02-02 03:36:20 +00:00 | 11 commits to master since this release

    Second beta of v1.1.0 — adds Android Studio integration to the proxy support from beta.1. Feature-complete pending Windows testing.

    What's new since beta.1

    • Android Studio integration: Projects now include .idea/ run configurations for one-click build and deployment directly from the IDE. Students open the project, select a configuration from the Run dropdown (Build, Deploy (auto), Deploy (USB), Deploy (WiFi), Test), and hit the green play button. No manual setup required beyond installing the Shell Script plugin.
    • Cross-platform run configs: Both Unix (.sh) and Windows (.bat) variants are generated. Android Studio automatically shows only the platform-appropriate configurations.
    • Clean file tree: workspace.xml hides internal directories (build/, .gradle/, gradle/) from the IDE view so students see only their code and deployment scripts.

    What's new in v1.1.0 overall

    • Proxy support: --proxy <url> and --no-proxy flags control HTTP/HTTPS proxy usage for all network operations. Auto-detects from HTTPS_PROXY/HTTP_PROXY environment variables. Enables air-gapped/offline installations.
    • System diagnostics: weevil doctor checks development environment health (Java, FTC SDK, Android SDK, ADB, Gradle) and provides clear next steps.
    • Environment setup: weevil setup installs SDKs and dependencies automatically. Supports custom installation paths.
    • Selective uninstall: weevil uninstall with --dry-run and --only <N> modes for removing specific components without nuking everything.
    • Integration test suite: 62 comprehensive tests covering proxy, environment setup, project lifecycle, and all CLI commands.

    Android Studio setup (first-time users)

    1. Open project in Android Studio
    2. Install Shell Script plugin: File → Settings → Plugins → Marketplace → search "Shell Script" → Install (by JetBrains) → Restart
    3. Run configurations appear in dropdown automatically

    Known limitations

    • Windows deploy.bat doesn't support --usb or --wifi flags yet (all deploy variants use auto-detect on Windows)
    • Requires Shell Script plugin installation in Android Studio

    Testing status

    • ✅ Linux: fully tested, all features working
    • ⚠️ Windows: pending verification (hence beta.2)

    Breaking changes

    None. Projects from beta.1 upgrade cleanly via weevil upgrade <project>.

    Downloads
  • v1.1.0-beta.1 58f7962a2a
    Compare

    v1.1.0-beta.1 Pre-Release

    eric released this 2026-02-01 16:21:11 +00:00 | 14 commits to master since this release

    First beta of proxy support. Weevil can now route SDK and Gradle downloads
    through an HTTP proxy — either via --proxy on the command line or by picking
    up HTTPS_PROXY / HTTP_PROXY from the environment. --no-proxy forces a direct
    connection regardless of what's set in the environment.

    What's new

    • --proxy flag to specify a forward proxy
    • --no-proxy flag to bypass any ambient proxy
    • Automatic HTTPS_PROXY / HTTP_PROXY environment variable detection
    • GitProxyGuard: RAII guard that temporarily sets proxy env vars for libgit2
      during git clone/fetch, then restores the previous values on drop
    • Full integration test suite: 9 proxy-specific tests against a real
      hyper forward proxy and mockito origin, all green (62 total tests)

    Known limitations

    • HTTPS_PROXY is used for both HTTP and HTTPS targets (matches standard
      proxy tooling behavior but worth noting)
    • No SOCKS proxy support
    Downloads
  • v1.0.0 6b6ba058b7
    Compare

    v1.0.0 - First Stable Release 🎉 Stable

    eric released this 2026-01-27 01:39:34 +00:00 | 22 commits to master since this release

    Weevil has reached 1.0.0! This is the first production-ready stable release.

    After extensive testing on Windows, Linux, and macOS, Weevil is ready for FTC teams to use in production. This release provides a robust, cross-platform project generator that separates team code from the FTC SDK, enables local testing, and simplifies the build/deployment workflow.

    What is Weevil?

    Weevil generates standalone FTC robot projects that:

    • Keep your code separate from the SDK
    • Support local unit testing (no robot needed!)
    • Work with multiple SDK versions simultaneously
    • Generate all build/deploy scripts automatically
    • Enable proper version control workflows

    In short: Students focus on building robots, not navigating SDK internals.

    Highlights of 1.0.0

    ✅ Complete Windows Support

    • Fully tested Windows deployment pipeline
    • Robust batch file path parsing
    • Correct APK discovery and installation
    • Proper ADB integration with error reporting

    ✅ Cross-Platform Build System

    • Single command builds on Windows, Linux, and macOS
    • Automatic Gradle wrapper configuration
    • Smart SDK path resolution
    • Platform-specific scripts generated automatically

    ✅ Project Management

    • Per-project SDK configuration via .weevil.toml
    • weevil upgrade command to update infrastructure
    • Config migration for legacy projects
    • SDK version tracking

    ✅ Developer Experience

    • Local unit testing with JUnit 5
    • Git initialization with proper .gitignore
    • Clean project structure following industry standards
    • Comprehensive error messages and diagnostics

    Quick Start

    # Create a new robot project
weevil new my-robot

# Test locally (no robot needed!)
cd my-robot
./gradlew test

# Build and deploy
./build.sh    # or build.bat on Windows
./deploy.sh   # or deploy.bat on Windows

    Installation

    Download the appropriate binary for your platform from the assets below, or build from source:

    git clone https://www.nxgit.dev/nexus-workshops/weevil.git
cd weevil
cargo build --release

    See the README for detailed installation instructions and prerequisites.

    What's Next?

    See ROADMAP.md for planned post-1.0.0 features including:

    • Custom project templates
    • FTC library package management
    • IDE integration
    • Multi-robot workspace support
    • CI/CD pipeline generation

    Stability Commitment

    As a 1.0.0 release, Weevil commits to:

    • Semantic versioning for all future releases
    • Backward compatibility for project configs
    • Migration paths for breaking changes
    • Stable CLI interface

    Known Issues

    None at this time. Please report any issues on our issue tracker.

    Acknowledgments

    Thanks to all the FTC teams and mentors who provided feedback during the RC phase. Your testing and patience made this release possible.

    Built with ❤️ for FIRST Tech Challenge teams everywhere.

    Full Changelog: v1.0.0-rc2...v1.0.0

    📧 Questions? eric@nxlearn.net
    🐛 Issues? Open an issue

    Building better tools so you can build better robots. 🤖

    Downloads
  • v1.0.0-rc2 8add733514
    Compare

    v1.0.0-rc2 - Windows Deployment Fix Pre-Release

    eric released this 2026-01-27 01:18:26 +00:00 | 23 commits to master since this release

    v1.0.0-rc2 - Windows Deployment Fix

    Second release candidate with critical Windows deployment fixes.

    What's Fixed

    Windows Deployment Pipeline

    • APK Discovery: Fixed APK search to correctly locate TeamCode-debug.apk
    • Path Parsing: Robust quote stripping in batch files (handles both single and double quotes)
    • ADB Integration: Properly resolves adb.exe from Android SDK platform-tools
    • Error Reporting: Deployment failures now correctly reported (checks errorlevel after adb install)

    Configuration Management

    • Android SDK Path: Added android_sdk_path to .weevil.toml project configuration
    • Migration Support: Old projects automatically upgraded with missing android_sdk_path
    • Upgrade Command: weevil upgrade now properly migrates legacy configs

    Testing

    • All integration tests updated and passing on Windows
    • Fixed test suite to use new ProjectConfig::new() signature

    Installation

    Download the appropriate binary for your platform and follow the Quick Start guide.

    What's Next

    See ROADMAP.md for planned features in v1.0.0 stable release.

    Known Issues

    None at this time. Please report any issues on our issue tracker.

    Full Changelog: v1.0.0-rc1...v1.0.0-rc2

    Downloads
  • v1.0.0-rc1 b0b2482774
    Compare

    v1.0.0-rc1 - Windows Support & Feature Freeze Pre-Release

    eric released this 2026-01-26 00:35:24 +00:00 | 27 commits to master since this release

    Weevil v1.0.0-rc1 🪲

    Release Candidate 1 - Feature freeze in effect. This RC stabilizes cross-platform support and establishes the foundation for the 1.0.0 release.

    What's New

    Windows Support ✨

    • Full Windows compatibility - Tested on Windows 11 with Eclipse Adoptium JDK 21
    • ANSI color support for beautiful terminal output on Windows
    • Proper batch file handling for Gradle and SDK tools
    • Path handling fixes for Windows backslashes in Kotlin strings

    SDK Installation Improvements

    • Android SDK auto-installation now works reliably on Windows
      • Fixed sdkmanager.bat execution with proper cmd.exe wrapping
      • Automatic license acceptance without hangs
      • Correct cmdline-tools directory structure
    • FTC SDK configuration automatically generates local.properties
      • Works for both new projects and upgrades
      • Ensures Android SDK path is properly configured

    Enhanced Reliability

    • Comprehensive debug logging throughout SDK operations
    • Better error messages for troubleshooting
    • Upgrade command now ensures SDK configuration is complete

    Breaking Changes

    None - this is a drop-in replacement for beta2.

    Feature Freeze 🔒

    This release establishes feature freeze for 1.0.0. Only bug fixes will be accepted before the final release. New features are deferred to v1.1.0.

    Installation

    Download the binary for your platform and add it to your PATH:

    • weevil-windows.exe - Windows 10/11
    • weevil-linux - Linux x86_64

    Testing

    Please test this RC and report any issues! Key areas to verify:

    • weevil sdk install - SDK installation
    • weevil new my-robot - Project creation
    • ./gradlew test - Local testing
    • ./build.bat (Windows) or ./build.sh (Linux) - Building
    • weevil upgrade - Upgrading existing projects

    Next Steps

    If no critical issues are found, v1.0.0 will be released within the week.

    Downloads
  • v1.0.0-beta2 90ed42b3c5
    Compare

    Weevil v1.0.0-beta2 Pre-Release

    eric released this 2026-01-25 07:17:47 +00:00 | 28 commits to master since this release

    Weevil - FTC Project Generator

    Cross-platform tool for generating clean, testable FTC robot projects without editing the SDK installation.

    Changes in v1.0.0-beta2

    • Fixed unused variable warning (zero warnings in release builds)
    • Added automated release build script (build-release.sh)
    • Cross-compilation support for Linux and Windows binaries

    Download

    Download the appropriate binary for your platform:

    • Linux: weevil-v1.0.0-beta2-linux-x86_64.tar.gz
    • Windows: weevil-v1.0.0-beta2-windows-x86_64.zip

    Extract and run - no installation required!

    Quick Start

    # Linux/Mac
tar -xzf weevil-v1.0.0-beta2-linux-x86_64.tar.gz
./weevil new my-robot

# Windows
# Extract weevil-v1.0.0-beta2-windows-x86_64.zip
weevil.exe new my-robot

    What's Included

    • Standalone project generation
    • Per-project SDK configuration
    • Local unit testing support
    • Cross-platform build/deploy scripts
    • Project upgrade system
    • Configuration management
    • Comprehensive test suite

    See README.md for full documentation.

    Checksums

    See SHA256SUMS file for verification.

    Downloads