acacha/llum

Llum (light in catalan language) illuminates your Laravel projects.

Maintainers

Details

github.com/acacha/llum

Source

Issues

Installs: 25 435

Dependents: 1

Suggesters: 0

Stars: 105

Watchers: 5

Forks: 12

Open Issues: 18

2.0.1 2018-05-29 10:58 UTC

README

Speed up you Github/Laravel development workflow illuminating packages with llum:

asciicast

Total Downloads Latest Stable Version Scrutinizer Code Quality Build Status StyleCI Build Status

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 git@github.com: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 git@github.com: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