/idea-gitignore

.ignore support plugin for IntelliJ IDEA

Primary LanguageJavaMIT LicenseMIT

.ignore 3.2.3

Build Status

Version Downloads Downloads last month

Introduction

.ignore is a plugin for:

  • .gitignore (Git)
  • .hgignore (Mercurial)
  • .npmignore (NPM)
  • .dockerignore (Docker)
  • .chefignore (Chef)
  • .cvsignore (CVS)
  • .bzrignore (Bazaar)
  • .boringignore (Darcs)
  • .mtn-ignore (Monotone)
  • ignore-glob (Fossil)
  • .jshintignore (JSHint)
  • .tfignore (Team Foundation)
  • .p4ignore (Perforce)
  • .flooignore (Floobits)
  • .eslintignore (ESLint)
  • .cfignore (Cloud Foundry)
  • .jpmignore (Jetpack)
  • .stylelintignore (StyleLint)
  • .stylintignore (Stylint)
  • .swagger-codegen-ignore (Swagger Codegen)
  • .helmignore (Kubernetes Helm)
  • .upignore (Up)
  • .prettierignore (Prettier)
  • .ebignore (ElasticBeanstalk)
  • .gcloudignore (Google Cloud)

files in your project. It supports following JetBrains IDEs:

  • Android Studio
  • AppCode
  • CLion
  • IntelliJ IDEA
  • PhpStorm
  • PyCharm
  • RubyMine
  • WebStorm
  • DataGrip

Features

  • Files syntax highlight
  • Gitignore templates filtering and selecting in rules generator by name and content
  • User custom templates
  • Show ignored files by specified Gitignore file (right click on .gitignore file)
  • Create file in currently selected directory
  • Generate Gitignore rules basing on GitHub's templates collection
  • Add selected file/directory to Gitignore rules from popup menu
  • Suggesting .gitignore file creation for new project
  • Entries inspection (duplicated, covered, unused, incorrect syntax, relative entries) with fix actions
  • Comments and brackets support
  • Navigation to entries in Project view
  • Renaming entries from ignore file
  • Close opened ignored files action
  • Custom user templates with import/export features

Supported IDEs

Since v3.0.0, .ignore plugin updates will be delivered to the IDE in version of 181+ - so latest build from 2018 and further.

But hey, no worries! It means .ignore for all IDE version from before - 139-173 - will be freezed at v3.0.0.

Installation

  • Using IDE built-in plugin system:
    • Preferences > Plugins > Browse repositories... > Search for ".ignore" > Install Plugin
  • Manually:
    • Download the latest release and install it manually using Preferences > Plugins > Install plugin from disk...

Restart IDE.

Usage

  1. Generate new file and templates usage

    To generate new ignore file, just click on File > New or use Alt + Insert shortcut and select .ignore file element.

    Generate new file

  2. Support for typing new rules, linking rules with matched files

    Support for typing new rules

  3. Code inspections

    Code inspections covers few cases:

    • duplicated entries (checks if entry is defined more than once)
    • covered entries - entry is covered by more general one
    • unused entries
    • incorrect syntax (regexp rules)
    • relative entries

    Code inspections

Changelog

v3.2.3 (2019-11-28)

Full Changelog

  • Compatibility with 2019.3
  • Incorrect parsing of {} symbols #585
  • Fixed deprecated warnings

v3.2.2 (2019-09-02)

Full Changelog

Compatibility with 2019.2

IntelliJ release 2019.2 brings out of the box support for .gitignore and .hgignore files, so some functionality has moved from the plugin to the platform. The following features are now provided by the platform:

  • Ignored status highlighting for .gitignore and .hgingore
  • Completion in .gitignore and .hgignore
  • Add to ignore actions

The plugin still provides other features for .gitignore and .hgignore, and the full set of features for other supported ignore files.

  • Fix dependency on Mercurial Integration #592
  • Fix index compatibility issue #593

Full Changelog History

Contribution

Check CONTRIBUTING.md file.

Compiling the source code

Since the project has been migrated to the Gradle and Gradle IntelliJ plugin, the build process is much simpler. The only thing to build the plugin is to run:

gradle build

All required dependencies like Grammar-Kit, JFlex are downloaded in the background and triggered properly during the build process. You can also test the plugin easily with running:

gradle runIdea

All of the gradle tasks can be connected to the IntelliJ debugger, so the development process is very easy.

Developed By

@hsz Jakub Chrzanowski

Contributors

Tools

I'm using Yourkit to locate and fix performance issues of .ignore. YourKit, LLC kindly provided a free open-source license of the YourKit Java Profiler.

YourKit Java Profiler Logo

License

Copyright (c) 2018 hsz Jakub Chrzanowski. See the LICENSE file for license rights and limitations (MIT).