{"id":13669151,"url":"https://github.com/acacha/llum","last_synced_at":"2025-04-09T18:21:24.450Z","repository":{"id":56939813,"uuid":"51069439","full_name":"acacha/llum","owner":"acacha","description":"Llum (light in catalan language) illuminates your Laravel projects speeding up your Github/Laravel development workflow","archived":false,"fork":false,"pushed_at":"2018-05-29T10:59:10.000Z","size":181,"stargazers_count":108,"open_issues_count":20,"forks_count":13,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-04-02T12:16:11.698Z","etag":null,"topics":["devtools","github","github-api","laravel","laravel-5-package","llum","php"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/acacha.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-02-04T10:46:14.000Z","updated_at":"2024-07-31T05:31:23.000Z","dependencies_parsed_at":"2022-08-21T01:40:29.197Z","dependency_job_id":null,"html_url":"https://github.com/acacha/llum","commit_stats":null,"previous_names":[],"tags_count":37,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/acacha%2Fllum","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/acacha%2Fllum/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/acacha%2Fllum/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/acacha%2Fllum/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/acacha","download_url":"https://codeload.github.com/acacha/llum/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248085498,"owners_count":21045169,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["devtools","github","github-api","laravel","laravel-5-package","llum","php"],"created_at":"2024-08-02T08:01:04.238Z","updated_at":"2025-04-09T18:21:24.424Z","avatar_url":"https://github.com/acacha.png","language":"PHP","funding_links":[],"categories":["PHP","Packages"],"sub_categories":["Development Tools"],"readme":"# llum\n\nSpeed up you Github/Laravel development workflow illuminating packages with llum:\n\n[![asciicast](https://asciinema.org/a/bym5od3j6qtqh5liv8uwx1qy4.png)](https://asciinema.org/a/bym5od3j6qtqh5liv8uwx1qy4?speed=2\u0026theme=solarized-dark\u0026loop=1\u0026autoplay=1\u0026size=medium)\n\n[![Total Downloads](https://poser.pugx.org/acacha/llum/downloads.png)](https://packagist.org/packages/acacha/llum)\n[![Latest Stable Version](https://poser.pugx.org/acacha/llum/v/stable.png)](https://packagist.org/packages/acacha/llum)\n[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/acacha/llum/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/acacha/llum/?branch=master)\n[![Build Status](https://scrutinizer-ci.com/g/acacha/llum/badges/build.png?b=master)](https://scrutinizer-ci.com/g/acacha/llum/build-status/master)\n[![StyleCI](https://styleci.io/repos/51069439/shield?branch=master)](https://styleci.io/repos/51069439)\n[![Build Status](https://travis-ci.org/acacha/llum.svg?branch=master)](https://travis-ci.org/acacha/llum)\n\nNow supports Laravel 5.4.\n\nSee also:\n\n- https://medium.com/@sergiturbadenas/developer-workflow-automation-with-laravel-and-github-using-acacha-llum-part-1-a5b3e89dedd9\n\n# Install notes\n\n```bash\ncomposer global require \"acacha/llum=~1.0\"\n```\n\n# Requirements\n\nSome commands use bash commands like [GNU sed](https://www.gnu.org/software/sed/) and touch.On Windows you can use [CygWin](https://www.cygwin.com/)  or see [StackOverflow](http://stackoverflow.com/questions/127318/is-there-any-sed-like-utility-for-cmd-exe)\n\nOn MAC OS use GNU sed instead of default installed BSD sed\n\n```bash\nbrew install gnu-sed --with-default-names\n```\n\n# Commands\n\n# init\n\nExecute:\n\n```bash\nllum init\nPlease enter your github username (sergi) ? \nDo you want to use our assistant to obtain token via Github API (Y/n)?Y\nGithub password?\n```\nTo configure your Bithub user and obtain a token to interact with github using llum commands (see github command section below). This command creates file `~/.llumrc` , an example:\n\n```bash\n~ cat .llumrc \n; Llum configuration file\n\n[github]\nusername = acacha\ntoken = token_here\ntoken_name = your token name here\n```\n\nYou can avoid providing password creating manually this file an putting your personal Github acces token (https://github.com/settings/tokens) on `~/.llumrc` file.\n\n## Github\n\n**IMPORTANT**: Requires previous execution of `llum init` command to work.\n\n### github:init\n\n**IMPORTANT**: Requires previous execution of `llum init` command to work.\n\nThis commands initializes a Github repo, create a first commit, create a Github repo and syncs local content with Github repo. The commands executed are:\n\n```bash\ngit init\ngit add .\ngit commit -a -m \"Initial version\"\nllum github:repo\ngit pull origin master\ngit push origin master\n```\n\nExample:\n\n```bash\n$ cd myproject\n$ llum github:init\nRunning command git init...\nS'ha inicialitzat un buit dipòsit de Git a /home/sergi/myproject/.git/\nRunning command git add ....\nRunning command git commit -a -m \"Initial version\"...\n[master (comissió d'arrel) 563473d] Initial version\n 1 file changed, 0 insertions(+), 0 deletions(-)\n ...\nRunning command llum github:repo...\nRepository myproject created\nRunning command git remote add origin git@github.com:acacha/myproject.git...\nRunning command git pull origin master...\nfatal: Couldn't find remote ref master\nRunning command git push origin master...\nComptant els objectes: 3, fet.\nEscrivint els objectes: 100% (3/3), 216 bytes | 0 bytes/s, fet.\nTotal 3 (delta 0), reused 0 (delta 0)\nTo git@github.com:acacha/myproject.git\n * [new branch]      master -\u003e master\n```\n \n### github:repo\n\n**IMPORTANT**: Requires previous execution of `llum init` command to work.\n\nCreate a new Github repo:\n\n```bash\nmkdir \u0026\u0026 cd newrepo\nllum github:repo\n```\n\nThis create a new Github repo called `{yourgithubusername}/newrepo` (the current folder name is used) . You can provide a name for the repo with:\n\n```bash\nllum github:repo reponame\n```\n\n## boot\n\nExecute commands:\n\n- devtools\n- sqlite\n- migrate\n- serve\n\nAnd your are ready to go!\n\n## devtools\n\nInstall and configure amazing debug tools [Laravel Debugbar](https://github.com/barryvdh/laravel-debugbar) and [Laravel-ide-helper](https://github.com/barryvdh/laravel-ide-helper)\n\n```bash\nllum devtools\n```\n\n# debugbar\n\nYou can install only [Laravel Debugbar](https://github.com/barryvdh/laravel-debugbar) devtool with:\n\n```bash\nllum debugbar\n```\n\n# idehelper\n\nYou can install only [Laravel-ide-helper](https://github.com/barryvdh/laravel-ide-helper) devtool with:\n\n```bash\nllum idehelper\n```\n\n## sqlite\n\nOnce you've installed a new laravel project use sqlite command to active sqlite\n\n```bash\nlaravel new larapp\ncd larapp\nllum sqlite\nFile database/database.sqlite created successfully\n.env file updated successfully\n```\nAnd sqlite is ready to go:\n \n```bash\nphp artisan migrate \nMigration table created successfully.\nMigrated: 2014_10_12_000000_create_users_table\nMigrated: 2014_10_12_100000_create_password_resets_table\n```\n\n## provider\n\nAdd a provider to config/app.php file:\n\n```bash\nllum provider Acacha\\AdminLTETemplateLaravel\\Providers\\AdminLTETemplateServiceProvider::class\n```\n\n## alias\n\nAdd an alias/Facade to config/app.php file:\n\n```bash\nllum alias Socialite Laravel\\Socialite\\Facades\\Socialite::class\n```\n\n## serve\n\nSimilar to php artisan serve but some enhacements:\n\n- First tyry to use port 8000 but if is already in use (in mi case so many times this occurs because Laravel homestead is up) then tries with following port numbers (8001, 8002, 8003)\n- If sensible-browser command is available then starts browser\n\n```bash\nllum serve\nRunning php artisan serve --port=8002\nOpening http://localhost:8002 with default browser\n ```\n \n## migrate\n\nRuns php artisan migrate\n\n```bash\nllum migrate\n```\n\n# Packagist\n\nhttps://packagist.org/packages/acacha/admin\n\n## Troubleshooting\n\n### GNU sed on MAC OS\n\nAcacha llum need GNU sed to work so replace BSD sed with GNU sed using:\n\n```bash\nbrew install gnu-sed --with-default-names\n```\n\nCheck you version of sed with:\n\n```bash\nman sed\n```\n\nsed GNU version path is:\n\n```bash\n$ which sed\n/usr/local/bin/sed\n```\n\nInstead of default path of BSD sed (installed by default on MAC OS):\n\n```bash\n/usr/bin/sed\n```\n\nMore info at https://github.com/acacha/adminlte-laravel/issues/58\n\n# Working notes\n\nUpdate value in .env file with sed:\n\n```bash\nsed -i '/^MAIL_DRIVER=/s/=.*/=log/' .env\n```\n\nComment database entries:\n\n```bash\nsed -i 's/^DB_/#DB_/g' .env\n```\n\nAdd sqlite before database entries:\n\n```bash\nsed 's/.*DB_HOST.*/DB_CONNECTION=sqlite\\n\u0026/' .env\n```\n\nArtisan serve always working:\n\n\u003cpre\u003e\n$continue = true;\n$port = 8000;\ndo {\n    echo \"Testing with port: \". $port;\n    if (check_port($port)) {\n        passthru('php artisan serve --port=' . $port);\n        $continue=false;\n    }\n    $port++;\n} while ($continue);\n\necho \"END\";\nfunction check_port($port,$host = '127.0.0.1') {\n    $fp = @fsockopen($host, $port,$errno, $errstr, 5);\n    if (!$fp) {\n        return true;\n    } else {\n        // port is open and available\n        return false;\n        fclose($fp);\n    }\n}\n\u003c/pre\u003e\n\nSolution with php preg_replace function:\n\n```php\nfile_put_contents(base_path('.env'), preg_replace(\"/(MAIL_DRIVER)=(.*)/\", \"$1=log\", file_get_contents(base_path('.env'))));\n```\nInsert provider in config/app.php file:\n```bash\nsed '/.*#llum_providers.*/a \\\\tBarryvdh\\\\LaravelIdeHelper\\\\IdeHelperServiceProvider::class,\\n' config/app.php\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Facacha%2Fllum","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Facacha%2Fllum","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Facacha%2Fllum/lists"}