Skip to content

Examples

LoSkroefie edited this page Jan 21, 2025 · 1 revision

FlexonCLI Examples 📚

This guide provides comprehensive examples of using FlexonCLI across different scenarios and programming languages.

Basic Usage Examples

Data Serialization

# Simple JSON serialization
flexon-cli serialize -i config.json -o config.flexon

# Multiple file packaging
flexon-cli serialize -i data.json -i image.png -o package.flexon

# Encrypted storage
flexon-cli serialize -i sensitive.json -o secure.flexon -e myKey

Data Deserialization

# Simple JSON deserialization
flexon-cli deserialize -i config.flexon -o config.json

# Extract package contents
flexon-cli deserialize -i package.flexon -o ./output_dir

# Decrypt and extract
flexon-cli deserialize -i secure.flexon -o data.json -e myKey

Language Examples

Python Implementation

Basic Usage

import flexon

# Serialize data
data = {"name": "John", "age": 30}
flexon.save(data, "output.flexon")

# Deserialize data
loaded = flexon.load("output.flexon")

Game State

import flexon
from PIL import Image

# Save game state
state = {
    "player": {"health": 100, "position": [0, 0, 0]},
    "inventory": ["sword", "shield"]
}

# Capture screenshot
screenshot = Image.open("screen.png")

# Save complete state
flexon.save({
    "state": state,
    "screenshot": screenshot.tobytes()
}, "save.flexon")

Ruby Implementation

Basic Usage

require 'flexon'

# Serialize data
data = { name: "John", age: 30 }
Flexon.save(data, "output.flexon")

# Deserialize data
loaded = Flexon.load("output.flexon")

AI Data

require 'flexon'
require 'matrix'

# Create embeddings
embeddings = Matrix.build(1000, 768) { rand }

# Save AI data
Flexon.save({
    embeddings: embeddings,
    metadata: { model: "bert-base" }
}, "ai_data.flexon")

PHP Implementation

Basic Usage

use Flexon\Flexon;

// Serialize data
$data = ["name" => "John", "age" => 30];
Flexon::save($data, "output.flexon");

// Deserialize data
$loaded = Flexon::load("output.flexon");

Image Processing

use Flexon\Flexon;
use Intervention\Image\ImageManager;

// Process image
$manager = new ImageManager();
$image = $manager->make('input.png');
$image->resize(800, 600);

// Save processed image
Flexon::save([
    'image' => $image->encode('png')->encoded,
    'metadata' => ['processed' => true]
], 'processed.flexon');

Java Implementation

Basic Usage

import com.flexon.Flexon;

// Serialize data
Map<String, Object> data = new HashMap<>();
data.put("name", "John");
data.put("age", 30);
Flexon.save(data, "output.flexon");

// Deserialize data
Map<String, Object> loaded = Flexon.load("output.flexon");

Game State

import com.flexon.Flexon;
import java.awt.image.BufferedImage;

// Create game state
GameState state = new GameState();
state.setPlayerHealth(100);
state.setPosition(new Vector3(0, 0, 0));

// Capture screenshot
BufferedImage screenshot = robot.createScreenCapture(rect);

// Save complete state
Flexon.save(Map.of(
    "state", state,
    "screenshot", screenshot
), "save.flexon");

Advanced Examples

AI Data Management

Training Data

import flexon
import numpy as np

# Prepare training data
training_data = {
    "inputs": np.random.rand(1000, 768),
    "labels": np.random.randint(0, 10, 1000),
    "metadata": {
        "model": "classifier-v1",
        "date": "2025-01-21"
    }
}

# Save with compression
flexon.save(training_data, "training.flexon", compress=True)

Prompt Management

import flexon

# Define prompt template
prompt = {
    "text": "Generate a story about {topic}",
    "parameters": {
        "temperature": 0.7,
        "max_tokens": 1000
    },
    "metadata": {
        "version": "1.0.0",
        "model": "gpt-4"
    }
}

# Save with validation
flexon.save(prompt, "prompt.flexon", schema="prompt_schema.json")

Security Examples

Encrypted Configuration

import flexon

# Sensitive configuration
config = {
    "api_key": "secret_key",
    "database": {
        "password": "db_password"
    }
}

# Save with encryption
flexon.save(config, "config.flexon", 
           encrypt=True, 
           key="master_key",
           algorithm="ChaCha20")

Audit Trail

import flexon

# Create audit record
audit = {
    "action": "data_access",
    "timestamp": "2025-01-21T02:02:13+02:00",
    "user": "system"
}

# Save with fingerprint
flexon.save(audit, "audit.flexon", fingerprint=True)

Performance Examples

Benchmarking

import flexon
import time

# Prepare large dataset
data = [{"id": i, "data": "x" * 1000} for i in range(10000)]

# Benchmark serialization
start = time.time()
flexon.save(data, "bench.flexon")
end = time.time()
print(f"Serialization time: {end - start}s")

Streaming

import flexon

# Stream large file
with flexon.stream("large.flexon") as f:
    for chunk in f:
        process_chunk(chunk)

Integration Examples

Web API

from flask import Flask, request
import flexon

app = Flask(__name__)

@app.route("/save", methods=["POST"])
def save_data():
    data = request.get_json()
    flexon.save(data, "api_data.flexon")
    return {"status": "success"}

Database

import flexon
import sqlite3

# Save database backup
conn = sqlite3.connect("app.db")
data = conn.execute("SELECT * FROM users").fetchall()
flexon.save({"users": data}, "backup.flexon")

Additional Resources

Documentation

Tools

  • Example generators
  • Test data creators
  • Benchmark tools

Examples

  • More code samples
  • Use cases
  • Integration patterns

Clone this wiki locally