npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

generate-gitattributes

v0.1.2

Published

Generate a .gitattributes file from the command line when Generate's CLI is installed globally, or use as a plugin or sub-generator in your own generator to make it a continuous part of the build workflow when scaffolding out a new project.

Downloads

14

Readme

Generate a .gitattributes file from the command line when Generate's CLI is installed globally, or use as a plugin or sub-generator in your own generator to make it a continuous part of the build workflow when scaffolding out a new project.

generate-gitattributes

NPM version NPM downloads Build Status

generate-gitattributes demo

Example

Templates are customizable and can be overridden.

generate-gitattributes demo

What is "Generate"?

Generate is a command line tool and developer framework for scaffolding out new GitHub projects using generators and tasks.

Answers to prompts and the user's environment can be used to determine the templates, directories, files and contents to build. Support for gulp, base and assemble plugins, and much more.

For more information:

Command line usage

Install globally

Installing the CLI

To run the gitattributes generator from the command line, you'll need to install Generate globally first. You can do that now with the following command:

$ npm install --global generate

This adds the gen command to your system path, allowing it to be run from any directory.

Install generate-gitattributes

Install this module with the following command:

$ npm install --global generate-gitattributes

Running generate-gitattributes

You should now be able to run generate-gitattributes with the following command:

$ gen gitattributes

What will happen?

Running $ gen gitattributes will run the generator's default task, which writes a .gitattributes file to the current working directory, or the specified directory.

What you should see in the terminal

If completed successfully, you should see both starting and finished events in the terminal, like the following:

[00:44:21] starting ...
...
[00:44:22] finished ✔

If you do not see one or both of those events, please let us know about it.

Help

To see a general help menu and available commands for Generate's CLI, run:

$ gen help

Running multiple generators

generate supports running multiple generators at once. Here is an example of a generator that works well with generate-gitattributes.

generate-dest

Run generate-dest before this generator to prompt for the destination directory to use for generated files.

Example

generate-gitattributes generate-dest example

API usage

Use generate-gitattributes as a plugin in your own generator.

Install locally

Install with npm:

$ npm install --save generate-gitattributes

Register as a plugin

Inside your own generator:

module.exports = function(app) {
  // register generate-gitattributes as a plugin to add the gitattributes
  // task to your own generator
  app.use(require('generate-gitattributes'));
};

Run tasks

Programmatically run tasks from generate-gitattributes.

module.exports = function(app) {
  // adds the `gitattributes` task to your generator
  app.use(require('generate-gitattributes'));

  // run the `gitattributes` task
  app.task('default', 'gitattributes');
};

Visit the generator docs to learn more about creating, installing, using and publishing generators.

Customization

The following instructions can be used to override settings in generate-gitattributes. Visit the Generate documentation to learn about other ways to override defaults.

Destination directory

To customize the destination directory, install generate-dest globally, then in the command line prefix dest before any other generator names.

For example, the following will prompt you for the destination path to use, then pass the result to generate-gitattributes:

$ gen dest gitattributes

Overriding templates

You can override a template by adding a template of the same name to the templates directory in user home. For example, to override the .gitattributes template, add a template at the following path ~/generate/generate-gitattributes/templates/.gitattributes, where ~/ is the user-home directory that os.homedir() resolves to on your system.

What is "Generate"?

Generate is a command line tool and developer framework for scaffolding out new GitHub projects using generators and tasks.

Answers to prompts and the user's environment can be used to determine the templates, directories, files and contents to build. Support for gulp, base and assemble plugins, and much more.

For more information:

Getting started

Install

Installing the CLI

To run the gitattributes generator from the command line, you'll need to install Generate globally first. You can do that now with the following command:

$ npm install --global generate

This adds the gen command to your system path, allowing it to be run from any directory.

Install generate-gitattributes

Install this module with the following command:

$ npm install --global generate-gitattributes

Usage

Run this generator's default task with the following command:

$ gen gitattributes

What you should see in the terminal

If completed successfully, you should see both starting and finished events in the terminal, like the following:

[00:44:21] starting ...
...
[00:44:22] finished ✔

If you do not see one or both of those events, please let us know about it.

Help

To see a general help menu and available commands for Generate's CLI, run:

$ gen help

Tasks

All available tasks.

gitattributes

Generates a .gitattributes file to the current working directory. The built-in template can be overridden.

Example

$ gen gitattributes

Visit Generate's documentation for tasks.

About

Community

Are you using Generate in your project? Have you published a generator and want to share your project with the world?

Here are some suggestions!

  • If you get like Generate and want to tweet about it, please feel free to mention @generatejs or use the #generatejs hashtag
  • Show your love by starring Generate and generate-gitattributes
  • Get implementation help on StackOverflow (please use the generatejs tag in questions)
  • Gitter Discuss Generate with us on Gitter
  • If you publish an generator, thank you! To make your project as discoverable as possible, please add the keyword generategenerator to package.json.

Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.

Running tests

Install dev dependencies:

$ npm install -d && npm test

Author

Jon Schlinkert

License

Copyright © 2016, Jon Schlinkert. Released under the MIT license.


This file was generated by verb-generate-readme, v0.1.30, on August 17, 2016.