twbs / grunt-css-flip

UNMAINTAINED Grunt plugin for Twitter's css-flip.

grunt-css-flip [UNMAINTAINED/ABANDONED]

Grunt plugin for Twitter's css-flip

This package is no longer maintained!

If you are interested in taking ownership of it, please contact @cvrebert or another member of the @twbs team.

Getting Started

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-css-flip --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

grunt.loadNpmTasks('grunt-css-flip');

Alternatively, you could instead use load-grunt-tasks to load this and other Grunt tasks.

The "cssflip" task

Overview

In your project's Gruntfile, add a section named cssflip to the data object passed into grunt.initConfig().

grunt.initConfig({
  cssflip: {
    your_target: {
      // Target-specific file lists and/or options go here.
      options: {
        ...
      },
      files: ...
    }
  }
});

Options

All options are passed directly to css-flip's flip() function. None of the options are required.

options.compress

• Type: Boolean
• Default: false

Whether to slightly compress output. Some newlines and indentation are removed. Comments stay intact.

options.indent

• Type: String
• Default: ' ' (two spaces)

String value to use for 1 level of indentation in the output.

Usage Examples

Default Options

In this example, two CSS files are flipped using css-flip's default settings.

grunt.initConfig({
  cssflip: {
    my_target: {
      options: {},
      files: {
        'flipped-one.css': 'original-one.css',
        'flipped-two.css': 'original-two.css'
      }
    }
  }
});

Custom Options

In this example, the resulting flipped CSS files will also be slightly compressed using css-flip's compress option.

grunt.initConfig({
  cssflip: {
    my_target: {
      options: {
        compress: true
      },
      files: {
        'flipped-one.min.css': 'original-one.css',
        'flipped-two.min.css': 'original-two.css'
      }
    }
  }
});

Contributing

The project's coding style is laid out in the ESLint configuration. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.

License and copyright

Released under the MIT License. Copyright Chris Rebert 2014-2016.

Release History

• v0.9.9 (2016-03-07) [FINAL VERSION]
  • Deprecate the package and mark it as unmaintained/abandoned!
  • Bump grunt peerDependency to >=0.4.5
• v0.4.0 (2014-07-16)
  • Bump css-flip to ~0.5.0
  • Bump grunt to ~0.4.5
  • Upgrade from grunt-jscs-checker ~0.4.4 to grunt-jscs ~0.6.1
  • Bump load-grunt-tasks to ~0.6.0
• v0.3.0 (2014-05-23)
  • Bump css-flip to ~0.4.0.
  • Bump devDependencies.
  • Fix examples in README.
• v0.2.2 (2014-05-03)
  • Add missing spaces before parameter lists in function expressions.
  • Simplify license field in package.json.
  • Bump grunt-contrib-jshint to ~0.10.0.
  • Bump grunt-jscs-checker to ~0.4.2.
  • Remove obsolete JSHint options in favor of JSCS.
• v0.2.1 (2014-03-13)
  • Fix required Grunt version mentioned in README.
  • Update dependencies and sort them by name.
  • Remove extra commas from JS & docs examples; (mostly due to grunt-init gruntplugin)
  • Enforce Unix-style newlines via .gitattributes.
  • Use the shields.io theme for the dependency badges.
• v0.2.0 (2014-03-12): Fix/address all outstanding issues. Backwards-incompatible.
  • Changed name of task from css_flip to cssflip.
  • Bumped Grunt dependency to v0.4.3.
  • Bumped & tightened-up devDependencies.
• v0.1.0 (2014-03-06): Initial public release.

grunt-css-flip's Issues

Upgrade to Grunt 0.4.3

http://gruntjs.com/blog/2014-03-07-grunt-0.4.3-released

Use PNG Travis badge maybe?

Dependency and Travis badges are not looking similar anymore.

Add load tasks tip in readme

We should add tip in readme for grunt-load-tasks because it helps with cleaning up gruntfile.

*Tip: the [load-grunt-tasks](https://github.com/sindresorhus/load-grunt-tasks) module makes it easier to load multiple grunt tasks.*

The example code in the readme does not work

I had to copy the code from bootstrap for it to work.

    cssflip: {
      rtl: {
        files: {
          'dist/css/<%= pkg.name %>-rtl.css': 'dist/css/<%= pkg.name %>.css'
        }
      }
    },

No option to prevent some css rules from being flipped

This was a feature of css-flip: https://github.com/twitter/css-flip#noflip.

Any chance it could be built into this plugin?

need to bump (dev)dependencies to latest versions

Give the README a once-over

Add JSCS configuration & integration

git.io link in banner

git.io links are easier for remembering and you don't need to write the whole URL.

My idea is to change the banner to something like:

/*
 * grunt-css-flip
 * http://git.io/grunt-css-flip
 *
 * Copyright (c) 2014 Chris Rebert
 * Licensed under the MIT License.
 */

Link is ready (http://git.io/grunt-css-flip redirects to this repository). What do you think?

Perhaps change name to camelCase or alloneword?

e.g. css_flip => cssFlip or cssflip

Add Travis support

THIS PACKAGE IS NO LONGER MAINTAINED!

THIS PACKAGE IS CURRENTLY UNMAINTAINED!

Your issue WILL BE IGNORED unless it's regarding taking over ownership of this package.