feat: implement configuration system

Author: donjne

Cargo.toml

@@ -15,7 +15,7 @@ thiserror = "2.0.12"
 serde = { version = "1.0", features = ["derive"] }
 serde_yaml = "0.9.34-deprecated"
 dirs = "4.0" # For easily getting the home directory
-
+toml = "0.9.1"
 sbpf-assembler = { workspace = true }
 
 [workspace]
@@ -32,3 +32,4 @@ anyhow = "1.0.86"
 codespan-reporting = "0.12.0"
 
 sbpf-assembler = { path = "crates/assembler" }
+ 

README.md

@@ -1,13 +1,14 @@
 ## Table of Contents
 
--   [sbpf](#sbpf)
--   [Dependencies](#dependencies)
--   [Installation](#installation)
--   [Usage](#usage)
--   [Command Details](#command-details)
--   [Examples](#examples)
--   [Advanced Usage](#advanced-usage)
--   [Contributing](#contributing)
+- [sbpf](#sbpf)
+- [Dependencies](#dependencies)
+- [Installation](#installation)
+- [Usage](#usage)
+- [Configuration-System](#configuration-system)
+- [Command Details](#command-details)
+- [Examples](#examples)
+- [Advanced Usage](#advanced-usage)
+- [Contributing](#contributing)
 
 # sbpf
 
@@ -27,29 +28,83 @@ cargo install --git https://github.com/blueshift-gg/sbpf.git
 
 To view all the commands you can run, type `sbpf help`. Here are the available commands:
 
--   `init`: Create a new project scaffold.
--   `build`: Compile into a Solana program executable.
--   `deploy`: Build and deploy the program.
--   `test`: Test the deployed program.
--   `e2e`: Build, deploy, and test a program.
--   `clean`: Clean up build and deploy artifacts.
--   `help`: Print this message or the help of the given subcommand(s).
+- `init`: Create a new project scaffold.
+- `build`: Compile into a Solana program executable.
+- `deploy`: Build and deploy the program.
+- `test`: Test the deployed program.
+- `e2e`: Build, deploy, and test a program.
+- `clean`: Clean up build and deploy artifacts.
+- `config`: Manage project configuration files.
+- `help`: Print this message or the help of the given subcommand(s).
 
+Options:
+
+- `-h`, --help     Print help
+- `-V`, --version  Print version
+
+Usage: sbpf `<COMMAND>`
+
+### Configuration System
+
+sbpf now supports project-aware configuration through `sbpf.toml` files. This eliminates the need to repeatedly specify build settings, deployment targets, and other options.
+
+#### Quick Start with Configuration
+
+```bash
+# Create a new project (automatically includes sbpf.toml)
+sbpf init my-solana-program
+
+# Or add configuration to an existing project
+sbpf config init
+
+# View current configuration
+sbpf config show
+
+# Modify settings
+sbpf config set deploy.cluster mainnet
+sbpf config set scripts.test "cargo test --verbose"
 ```
-Usage: sbpf <COMMAND>
 
-Commands:
-  init    Create a new project scaffold
-  build   Compile into a Solana program executable
-  deploy  Build and deploy the program
-  test    Test deployed program
-  e2e     Build, deploy and test a program
-  clean   Clean up build and deploy artifacts
-  help    Print this message or the help of the given subcommand(s)
+#### Configuration File Format
 
-Options:
-  -h, --help     Print help
-  -V, --version  Print version
+The `sbpf.toml` file supports the following sections:
+
+```toml
+[project]
+name = "sbpf"
+version = "0.1.0"
+
+[scripts]
+test = "cargo test"
+
+[deploy]
+cluster = "localhost"
+wallet = "~/.config/solana/id.json"
+```
+
+#### Scripts System
+
+Define custom commands in your configuration that can be run with `sbpf script <name>`:
+
+```toml
+[scripts]
+# Override built-in commands
+test = "cargo test --verbose"
+build = "echo 'Custom build' && sbpf build"
+
+# Custom scripts
+lint = "cargo clippy -- -D warnings"
+format = "cargo fmt"
+deploy-staging = "sbpf deploy --cluster devnet"
+audit = "cargo audit"
+```
+
+**Usage:**
+
+```bash
+sbpf script lint           # Run custom lint script
+sbpf script deploy-staging # Run staging deployment
+sbpf script audit          # Run security audit
 ```
 
 ### Command Details
@@ -73,27 +128,83 @@ Options:
   -V, --version   Print version information
 ```
 
-##### Examples
+#### Configuration Management
 
-###### Create a new project with Rust tests (default)
+Manage project configuration without manually editing TOML files:
+
+```sh
+sbpf config --help
+Initialize or manage configuration
+
+Usage: sbpf config <COMMAND>
+
+Commands:
+  show  Show current configuration
+  init  Initialize default configuration
+  set   Set a configuration value
+  help  Print this message or the help of the given subcommand(s)
+```
+
+### Examples
+
+**Create a new project with Rust tests (includes sbpf.toml):**
 
 ```sh
 sbpf init my-project
 ```
 
-###### Create a new project with TypeScript tests
+**Create a new project with TypeScript tests:**
 
 ```sh
 sbpf init my-project --ts-tests
 ```
 
-After initializing the project, you can navigate into the project directory and use other commands to build, deploy, and test your program.
+**Add configuration to existing project:**
+
+```sh
+sbpf config init
+```
+
+**View current settings:**
+
+```sh
+sbpf config show
+```
+
+**Modify settings:**
+
+```sh
+sbpf config set deploy.cluster mainnet
+```
+
+**Build with configuration:**
+
+```sh
+# Uses settings from sbpf.toml automatically
+sbpf build
+sbpf deploy
+sbpf test
+```
+
+**Custom build pipeline:**
+
+```bash
+# Configure custom scripts
+sbpf config set scripts.build "echo 'Building...' && sbpf build"
+sbpf config set scripts.test "cargo test --verbose"
+sbpf config set scripts.deploy-all "sbpf build && sbpf deploy"
+
+# Use custom pipeline
+sbpf script build
+sbpf script test
+sbpf script deploy-all
+```
 
 ### Advanced Usage
 
 You can override the default linker with a [custom linker file](https://github.com/deanmlittle/sbpf-asm-noop/blob/master/src/noop/noop.ld) by including it in the src directory with the same name as your program. For example:
 
-```
+```bash
 src/example/example.s
 src/example/example.ld
 ```

src/commands/build.rs

@@ -80,4 +80,4 @@ pub fn build() -> Result<()> {
     }
 
     Ok(())
-}
+}

src/commands/deploy.rs

@@ -3,23 +3,33 @@ use std::path::Path;
 use std::process::Command;
 
 use anyhow::{Error, Result};
+use crate::config::SbpfConfig;  
+
+fn deploy_program(program_name: &str, url: &str, config: &SbpfConfig) -> Result<(), Error> {
+    
+    let program_id_file = if let Some(custom_id) = &config.deploy.program_id {
+        format!("./deploy/{}-keypair.json", custom_id)
+    } else {
+        format!("./deploy/{}-keypair.json", program_name)
+    };
 
-fn deploy_program(program_name: &str, url: &str) -> Result<(), Error> {
-    let program_id_file = format!("./deploy/{}-keypair.json", program_name);
     let program_file = format!("./deploy/{}.so", program_name);
 
     if Path::new(&program_file).exists() {
-        println!("🔄 Deploying \"{}\"", program_name);
+        println!("🔄 Deploying \"{}\" to {}", program_name, url);
+
+        let mut cmd = Command::new("solana");
+        cmd.arg("program")
+           .arg("deploy")
+           .arg(&program_file)
+           .arg("--program-id")
+           .arg(&program_id_file)
+            .arg("--keypair")
+           .arg(&config.deploy.wallet)
+           .arg("-u")
+           .arg(url);
 
-        let status = Command::new("solana")
-            .arg("program")
-            .arg("deploy")
-            .arg(&program_file)
-            .arg("--program-id")
-            .arg(&program_id_file)
-            .arg("-u")
-            .arg(url)
-            .status()?;
+        let status = cmd.status()?;
 
         if !status.success() {
             eprintln!("Failed to deploy program for {}", program_name);
@@ -41,15 +51,15 @@ fn deploy_program(program_name: &str, url: &str) -> Result<(), Error> {
     Ok(())
 }
 
-fn deploy_all_programs(url: &str) -> Result<(), Error> {
+fn deploy_all_programs(url: &str, config: &SbpfConfig) -> Result<(), Error> {
     let deploy_path = Path::new("deploy");
 
     for entry in deploy_path.read_dir()? {
         let entry = entry?;
         let path = entry.path();
         if path.is_file() && path.extension().and_then(|ext| ext.to_str()) == Some("so") {
             if let Some(filename) = path.file_stem().and_then(|name| name.to_str()) {
-                deploy_program(filename, url)?;
+                deploy_program(filename, url, config)?;
             }
         }
     }
@@ -58,11 +68,46 @@ fn deploy_all_programs(url: &str) -> Result<(), Error> {
 }
 
 pub fn deploy(name: Option<String>, url: Option<String>) -> Result<(), Error> {
-    let url = url.unwrap_or_else(|| "localhost".to_string());
+    
+    let config = match SbpfConfig::load() {
+        Ok(config) => {
+            if url.is_none() { 
+                println!("📋 Using deployment configuration from sbpf.toml");
+            }
+            config
+        }
+        Err(_) => {
+            
+            let current_dir = std::env::current_dir()?;
+            let project_name = current_dir
+                .file_name()
+                .and_then(|name| name.to_str())
+                .unwrap_or("sbpf-project");
+            
+            println!("📋 No sbpf.toml found, using default deployment settings");
+            println!("   💡 Run 'sbpf config init' to create a configuration file");
+            SbpfConfig::default_for_project(project_name)
+        }
+    };
+
+    
+    let deployment_url = match url {
+        Some(override_url) => {
+            println!("🌐 Detected command-line cluster: {} (Now overriding config: {})", override_url, config.deploy.cluster);
+            override_url
+        }
+        None => {
+            let resolved_url = config.resolve_cluster_url();
+            println!("🌐 Using cluster '{}' → {}", config.deploy.cluster, resolved_url);
+            resolved_url
+        }
+    };
 
     if let Some(program_name) = name {
-        deploy_program(&program_name, &url)
+        
+        deploy_program(&program_name, &deployment_url, &config)
     } else {
-        deploy_all_programs(&url)
+        
+        deploy_all_programs(&deployment_url, &config)
     }
-}
+}