llum
Speed up you Github/Laravel development workflow illuminating packages with llum:
Now supports Laravel 5.4.
See also:
Install notes
composer global require "acacha/llum=~1.0"
Requirements
Some commands use bash commands like GNU sed and touch.On Windows you can use CygWin or see StackOverflow
On MAC OS use GNU sed instead of default installed BSD sed
brew install gnu-sed --with-default-names
Commands
init
Execute:
llum init
Please enter your github username (sergi) ?
Do you want to use our assistant to obtain token via Github API (Y/n)?Y
Github password?
To 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:
~ cat .llumrc
; Llum configuration file
[github]
username = acacha
token = token_here
token_name = your token name here
You can avoid providing password creating manually this file an putting your personal Github acces token (https://github.com/settings/tokens) on ~/.llumrc file.
Github
IMPORTANT: Requires previous execution of llum init command to work.
github:init
IMPORTANT: Requires previous execution of llum init command to work.
This commands initializes a Github repo, create a first commit, create a Github repo and syncs local content with Github repo. The commands executed are:
git init
git add .
git commit -a -m "Initial version"
llum github:repo
git pull origin master
git push origin master
Example:
$ cd myproject
$ llum github:init
Running command git init...
S'ha inicialitzat un buit dipòsit de Git a /home/sergi/myproject/.git/
Running command git add ....
Running command git commit -a -m "Initial version"...
[master (comissió d'arrel) 563473d] Initial version
1 file changed, 0 insertions(+), 0 deletions(-)
...
Running command llum github:repo...
Repository myproject created
Running command git remote add origin [email protected]:acacha/myproject.git...
Running command git pull origin master...
fatal: Couldn't find remote ref master
Running command git push origin master...
Comptant els objectes: 3, fet.
Escrivint els objectes: 100% (3/3), 216 bytes | 0 bytes/s, fet.
Total 3 (delta 0), reused 0 (delta 0)
To [email protected]:acacha/myproject.git
* [new branch] master -> master
github:repo
IMPORTANT: Requires previous execution of llum init command to work.
Create a new Github repo:
mkdir && cd newrepo
llum github:repo
This create a new Github repo called {yourgithubusername}/newrepo (the current folder name is used) . You can provide a name for the repo with:
llum github:repo reponame
boot
Execute commands:
- devtools
- sqlite
- migrate
- serve
And your are ready to go!
devtools
Install and configure amazing debug tools Laravel Debugbar and Laravel-ide-helper
llum devtools
debugbar
You can install only Laravel Debugbar devtool with:
llum debugbar
idehelper
You can install only Laravel-ide-helper devtool with:
llum idehelper
sqlite
Once you've installed a new laravel project use sqlite command to active sqlite
laravel new larapp
cd larapp
llum sqlite
File database/database.sqlite created successfully
.env file updated successfully
And sqlite is ready to go:
php artisan migrate
Migration table created successfully.
Migrated: 2014_10_12_000000_create_users_table
Migrated: 2014_10_12_100000_create_password_resets_table
provider
Add a provider to config/app.php file:
llum provider Acacha\AdminLTETemplateLaravel\Providers\AdminLTETemplateServiceProvider::class
alias
Add an alias/Facade to config/app.php file:
llum alias Socialite Laravel\Socialite\Facades\Socialite::class
serve
Similar to php artisan serve but some enhacements:
- 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)
- If sensible-browser command is available then starts browser
llum serve
Running php artisan serve --port=8002
Opening http://localhost:8002 with default browser
migrate
Runs php artisan migrate
llum migrate
Packagist
https://packagist.org/packages/acacha/admin
Troubleshooting
GNU sed on MAC OS
Acacha llum need GNU sed to work so replace BSD sed with GNU sed using:
brew install gnu-sed --with-default-names
Check you version of sed with:
man sed
sed GNU version path is:
$ which sed
/usr/local/bin/sed
Instead of default path of BSD sed (installed by default on MAC OS):
/usr/bin/sed
More info at https://github.com/acacha/adminlte-laravel/issues/58
Working notes
Update value in .env file with sed:
sed -i '/^MAIL_DRIVER=/s/=.*/=log/' .env
Comment database entries:
sed -i 's/^DB_/#DB_/g' .env
Add sqlite before database entries:
sed 's/.*DB_HOST.*/DB_CONNECTION=sqlite\n&/' .env
Artisan serve always working:
$continue = true;
$port = 8000;
do {
echo "Testing with port: ". $port;
if (check_port($port)) {
passthru('php artisan serve --port=' . $port);
$continue=false;
}
$port++;
} while ($continue);
echo "END";
function check_port($port,$host = '127.0.0.1') {
$fp = @fsockopen($host, $port,$errno, $errstr, 5);
if (!$fp) {
return true;
} else {
// port is open and available
return false;
fclose($fp);
}
}
Solution with php preg_replace function:
file_put_contents(base_path('.env'), preg_replace("/(MAIL_DRIVER)=(.*)/", "$1=log", file_get_contents(base_path('.env'))));
Insert provider in config/app.php file:
sed '/.*#llum_providers.*/a \\tBarryvdh\\LaravelIdeHelper\\IdeHelperServiceProvider::class,\n' config/app.php
22 Oct 28, 2022
268 Dec 27, 2022
3 Jul 21, 2022
327 Dec 29, 2022
268 Dec 11, 2022
842 Dec 29, 2022
18 Dec 21, 2022
1 Oct 22, 2022
2.4k Jan 3, 2023
17 Oct 24, 2022
43 Dec 15, 2022
5 May 30, 2022
199 Dec 25, 2022
1 Aug 23, 2022
6 Jun 7, 2023
3 Jan 16, 2022
27 Oct 4, 2022
3 Dec 1, 2022
456 Dec 21, 2022