{"id":30068537,"url":"https://github.com/waadmawlood/truffle","last_synced_at":"2026-01-20T16:30:35.951Z","repository":{"id":308429451,"uuid":"1032817735","full_name":"waadmawlood/truffle","owner":"waadmawlood","description":"Laravel package for in-memory driver database Eloquent model connections","archived":false,"fork":false,"pushed_at":"2025-08-05T22:18:39.000Z","size":467,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-05T23:15:20.381Z","etag":null,"topics":["driver","eloquent","laravel","memory","missing-driver","model","static-data"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/waadmawlood.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-05T21:54:25.000Z","updated_at":"2025-08-05T22:28:48.000Z","dependencies_parsed_at":"2025-08-05T23:15:22.851Z","dependency_job_id":"f3836b25-f328-4c1c-8804-ef547b66f5aa","html_url":"https://github.com/waadmawlood/truffle","commit_stats":null,"previous_names":["waadmawlood/truffle"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/waadmawlood/truffle","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waadmawlood%2Ftruffle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waadmawlood%2Ftruffle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waadmawlood%2Ftruffle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waadmawlood%2Ftruffle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/waadmawlood","download_url":"https://codeload.github.com/waadmawlood/truffle/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waadmawlood%2Ftruffle/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28607170,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-20T16:10:39.856Z","status":"ssl_error","status_checked_at":"2026-01-20T16:10:39.493Z","response_time":117,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["driver","eloquent","laravel","memory","missing-driver","model","static-data"],"created_at":"2025-08-08T10:16:12.309Z","updated_at":"2026-01-20T16:30:35.926Z","avatar_url":"https://github.com/waadmawlood.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Laravel Truffle](truffle.jpg)\n\n# Waad/Truffle 🍄\n\n[![Latest Version on Packagist](https://img.shields.io/packagist/v/waad/truffle.svg?style=flat-square)](https://packagist.org/packages/waad/truffle)\n[![GitHub Tests Action Status](https://img.shields.io/github/workflow/status/waad/truffle/run-tests?label=tests)](https://github.com/waad/truffle/actions?query=workflow%3Arun-tests+branch%3Amain)\n[![Total Downloads](https://img.shields.io/packagist/dt/waad/truffle.svg?style=flat-square)](https://packagist.org/packages/waad/truffle)\n\nA Laravel package for creating in-memory models using SQLite. Perfect for static data, test fixtures, and high-performance read operations.\n\n**Features**: Zero configuration • Full Eloquent support • Type safety • Performance optimized\n\n## Installation\n\n```bash\ncomposer require waad/truffle\n```\n\n## Quick Start\n\n```php\n\u003c?php\n\nuse Illuminate\\Database\\Eloquent\\Model;\nuse Waad\\Truffle\\Truffle;\n\nclass Product extends Model\n{\n    use Truffle;\n\n    protected $fillable = ['name', 'price', 'category'];\n    \n    protected $casts = [\n        'price' =\u003e 'float',\n    ];\n\n    // Define your in-memory data records\n    protected $records = [\n        ['id' =\u003e 1, 'name' =\u003e 'Laptop', 'price' =\u003e 999.99, 'category' =\u003e 'Electronics'],\n        ['id' =\u003e 2, 'name' =\u003e 'Coffee Mug', 'price' =\u003e 12.50, 'category' =\u003e 'Kitchen'],\n    ];\n}\n\n// Use standard Eloquent queries\n$products = Product::all();\n$laptop = Product::where('name', 'Laptop')-\u003efirst();\n$avgPrice = Product::avg('price');\n```\n\n## Data Types\n\n### Static Data\n```php\nprotected $records = [\n    ['id' =\u003e 1, 'name' =\u003e 'John', 'email' =\u003e 'john@example.com'],\n];\n```\n\n### Dynamic Data\n```php\npublic function getRecords()\n{\n    return collect(range(1, 100))-\u003emap(fn($i) =\u003e [\n        'id' =\u003e $i,\n        'name' =\u003e \"User {$i}\",\n        'email' =\u003e \"user{$i}@example.com\",\n    ])-\u003etoArray();\n}\n```\n\n### Schema Definition\n```php\nuse Waad\\Truffle\\Enums\\DataType;\n\nprotected $schema = [\n    'id' =\u003e DataType::Id,\n    'name' =\u003e DataType::String,\n    'email' =\u003e DataType::String,\n    'age' =\u003e DataType::Integer,\n    'is_active' =\u003e DataType::Boolean,\n    'salary' =\u003e DataType::Decimal,\n    'metadata' =\u003e DataType::Json,\n    'created_at' =\u003e DataType::Timestamp\n];\n```\n\n## DataType Reference\n\n| DataType | Description | DB Type |\n|----------|-------------|---------|\n| `DataType::Id` | Auto-increment primary key | INTEGER (PK) |\n| `DataType::String` | Short string (up to 255 chars) | VARCHAR(255) |\n| `DataType::Text` | Long text | TEXT |\n| `DataType::Integer` | Integer number | INTEGER |\n| `DataType::BigInteger` | Large integer | BIGINT |\n| `DataType::Float` | Floating point number | FLOAT |\n| `DataType::Decimal` | Decimal number | DECIMAL |\n| `DataType::Boolean` | Boolean (true/false) | BOOLEAN |\n| `DataType::Json` | JSON-encoded data | TEXT |\n| `DataType::DateTime` | Date and time | DATETIME |\n| `DataType::Date` | Date only | DATE |\n| `DataType::Time` | Time only | TIME |\n| `DataType::Timestamp` | Timestamp | TIMESTAMP |\n| `DataType::Uuid` | UUID string | CHAR(36) |\n| `DataType::Ulid` | ULID string | CHAR(26) |\n\n## Advanced Usage\n\n### Complete Model Configuration\n```php\nclass User extends Model\n{\n    use Truffle;\n\n    protected $fillable = ['name', 'email', 'age', 'department'];\n    \n    protected $casts = [\n        'age' =\u003e 'integer',\n        'is_active' =\u003e 'boolean',\n    ];\n\n    protected $records = [\n        ['id' =\u003e 1, 'name' =\u003e 'Alice', 'email' =\u003e 'alice@company.com', 'age' =\u003e 30, 'is_active' =\u003e true],\n    ];\n\n    protected $schema = [\n        'id' =\u003e DataType::Id,\n        'name' =\u003e DataType::String,\n        'email' =\u003e DataType::String,\n        'age' =\u003e DataType::Integer,\n        'is_active' =\u003e DataType::Boolean,\n    ];\n\n    // Scopes\n    public function scopeActive($query)\n    {\n        return $query-\u003ewhere('is_active', true);\n    }\n}\n```\n\n### Performance Configuration\n```php\nprotected $insertChunkRecords = 500; // Batch size for large datasets\nprotected $foreignKeyConstraints = true; // Enable foreign key constraints\nprotected $prefixDatabaseName = 'my_prefix_'; // Database name prefix\n\n// Migration hook for custom indexes\nprotected function thenMigration(Blueprint $table)\n{\n    $table-\u003eindex('name');\n}\n```\n\n## Use Cases\n\n### Static Reference Data\n```php\nclass Country extends Model\n{\n    use Truffle;\n\n    public $incrementing = false;\n    protected $keyType = 'string';\n    protected $primaryKey = 'code';\n\n    protected $records = [\n        ['code' =\u003e 'US', 'name' =\u003e 'United States'],\n        ['code' =\u003e 'CA', 'name' =\u003e 'Canada'],\n    ];\n}\n```\n\n### Configuration Settings\n```php\nclass AppSetting extends Model\n{\n    use Truffle;\n\n    public $incrementing = false;\n    protected $keyType = 'string'; \n    protected $primaryKey = 'key';\n\n    protected $records = [\n        ['key' =\u003e 'app_name', 'value' =\u003e 'My Application'],\n        ['key' =\u003e 'maintenance_mode', 'value' =\u003e 'false'],\n    ];\n\n    public static function getValue(string $key, $default = null)\n    {\n        $setting = static::where('key', $key)-\u003efirst();\n        return $setting ? $setting-\u003evalue : $default;\n    }\n}\n```\n\n## API Reference\n\n### Core Methods\n```php\nModel::clearConnections()           // Clear all connections\n$model-\u003egetRecords()                // Get all data records\n$model-\u003egetSchema()                 // Get schema definition\nModel::resolveConnection()          // Get the SQLite connection\n```\n\n## Testing\n\n```bash\ncomposer test\n```\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch: `git checkout -b feature/amazing-feature`\n3. Add tests and make your changes\n4. Run tests: `composer test`\n5. Submit a Pull Request\n\n## Roadmap\n\n- [x] Eloquent integration\n- [x] SQLite in-memory support\n- [ ] SQLite file support\n- [ ] Caching support\n- [ ] Support for CSV/JSON/XML files\n- [ ] Multi-tenancy support\n\n## Credits\n\nBuilt with ❤️ for the Laravel community by [Waad Mawlood](https://github.com/waadmawlood)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwaadmawlood%2Ftruffle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwaadmawlood%2Ftruffle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwaadmawlood%2Ftruffle/lists"}