hnhdigital-os/fs-tasker

A Tasker

1.2.0 2021-03-29 00:30 UTC

Requires

• php: ^7.3|^8.0
• composer/semver: ^3.0
• laminas/laminas-text: ^2.7
• matthiasmullie/minify: ^1.3
• scssphp/scssphp: ^1.0
• symfony/yaml: ^5.0

Requires (Dev)

• laravel-zero/framework: ^8.0
• mockery/mockery: ^1.0
• phpunit/phpunit: ^9.3

MIT

• Rocco Howard

• framework
• cli
• console
• laravel
• tasker
• webpack
• Laravel Zero
• bundler

README

Provides a sequential task runner. Tasks and configuration is provided through a simple yaml config file.

Provides task plugins for:

• Combine
• Copy
• Create
• Empty
• Exec
• Replace Text
• Revision
• SASS

This package has been developed by H&H|Digital, an Australian botique developer. Visit us at hnh.digital.

Requirements

• PHP 7.3.0 (min)

Installation

Via commmand line:

curl -o fs-tasker-installer.sh -sL https://hnhdigital-os.github.io/fs-tasker/builds/install

sudo bash fs-tasker-installer.sh && unlink fs-tasker-installer.sh

OR, Download the latest build:

curl -o ./fs-tasker -LsS https://github.com/hnhdigital-os/fs-tasker/raw/master/builds/fs-tasker

chmod a+x ./fs-tasker

Move it local bin:

sudo mv ./fs-tasker /usr/local/bin/fs-tasker

Updating

This tool provides a self-update mechanism. Simply run the self-update command.

fs-tasker self-update

How to use

fs-tasker <command> [options] [arguments]

Config (.tasker.config.yml)

An example of the tasker configuration using YAML.

tasker:
  version: 1.2.0

environments:
  - dev
  - staging
  - prod

options:

aliases:
  SASS: resources/assets/sass
  NODE: node_modules
  ASSETS: public/assets
  BUILD: public/build
  VENDOR: vendor
  RESOURCES: resources
  VIEWS: resources/views
  IMAGES: resources/assets/images
  VENDOR_ASSETS: resources/assets/vendor

tasks:

  -
    name: Yarn Install
    plugin: exec
    environments:
      - staging
      - prod
    executable: yarn
    arguments: install

  -
    name: Tailwind CSS
    plugin: exec
    executable: npx
    arguments: tailwind build $RESOURCES + /css/styles.css -o $ASSETS + /output.css

  -
    name: Create folders
    plugin: create
    paths:
      - $ASSETS?ignore
      - $BUILD?ignore

  -
    name: Empty folders
    plugin: empty
    paths:
      - $ASSETS?ignore
      - $BUILD?ignore

  - 
    name: Copy assets
    plugin: copy
    paths:
      $NODE + /jquery/dist/jquery.js: $ASSETS + /vendor/jquery.js
      $NODE + /components-jqueryui/jquery-ui.js: $ASSETS + /vendor/jquery-ui.js
      $NODE + /components-jqueryui/themes/smoothness/**: $ASSETS + /vendor/jquery-ui/themes/smoothness/
      $NODE + /font-awesome/css/all.css: $ASSETS + /vendor/fontawesome.css
      $NODE + /font-awesome/webfonts/**: $ASSETS + /webfonts/
      $RESOURCES + /js/test.js: $ASSETS + /js/test.js
      $IMAGES+/**?extensions=png,gif: $ASSETS+/images/
      $VIEWS + /**?extensions=css,js: $ASSETS?remove_extension_folder

  -
    name: Replace text
    plugin: replace_text
    src: $ASSETS + /js/test.js
    find: This is some text to replace
    replace: Text has been replaced
    extensions:
      - js

  -
    name: Create autoinit
    plugin: combine
    output: $ASSETS + /vendor/autoinit.js
    paths:
      - $VENDOR + /hnhdigital-os/laravel-frontend-asset-loader/js/**
      - $VENDOR + /hnhdigital-os/laravel-frontend-assets/js/**

  -
    name: Process sass
    plugin: sass
    src: $RESOURCES + /sass/app.scss
    dest: $ASSETS + /app.css
    import-paths:
      - $NODE
    source-map: 
      path: $ASSETS + /app.map

  - 
    name: Revision assets
    plugin: revision
    cache: true
    minify: true
    src: $ASSETS
    dest: $BUILD
    manifest:
      formats:
        json: $BUILD + /rev-manifest.json
        php: config/rev-manifest.php

Contributing

Please see CONTRIBUTING for details.

Credits

• Rocco Howard
• All Contributors

License

The MIT License (MIT). Please see License File for more information.