Metadata-Version: 2.1
Name: ignorem
Version: 1.0.1
Summary: Easily manage .gitignore files.
Home-page: https://github.com/itsmaxymoo/ignorem
Author: Max Loiacono
Author-email: 
License: Mozilla Public License version 2.0
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown

# ignorem

ignorem - The best git*ignore* *m*anager yet!

# About

ignorem makes interacting with your `.gitignore` file just like using a package manager. You can "install" [pre-made gitignores](https://github.com/github/gitignore) into your file, remove them, and update them with ease! ignorem also supports user-modified gitignores, so your manual gitignore entries will be saved.

# Installation

`pip install ignorem`

# Usage

`ignorem (command) [gitignore...]`

Run `ignorem` from the command line, in the directory that contains the `.gitignore` file. ignorem requires one additional command:

| Command | Description | Additional arguments |
| --- | --- | --- |
| help | Shows info/help text.
| list | Lists gitignores installed in `.gitignore`.
| query | Lists all available pre-made gitignores.
| add | Add the specified pre-made gitignore(s) to `.gitignore`. | Gitignore(s) to add |
| remove | Remove the specified pre-made gitignore(s) from `.gitignore`. | Gitignore(s) to remove |
| update | Update all pre-made gitignores installed to `.gitignore`.

## Examples

Create a new gitignore for python  
`ignorem add python`

Add android and vim to the gitignore  
`ignorem add android vim`

Remove vim from the gitignore  
`ignorem remove vim`

## Manual ignores

ignorem will save the entries you add manually to the `.gitignore` file. Simply place those entries outside of the `# (BEGIN/END) ignorem auto-gen` tags.

An empty gitignore is below to demonstrate this:  
```
# BEGIN ignorem auto-gen
# This gitingore was generated by ignorem version 1.0
# https://github.com/itsmaxymoo/ignorem
# DO NOT EDIT ANY TEXT INSIDE THE ignorem auto-gen tags!
# It will be overwritten next time ignorem is ran.
# Following this header are the loose ignores, or ignores added externally.
# After that, there are the ignores generated by ignorem.
# END ignorem auto-gen

(Place your manual entries here)

# BEGIN ignorem auto-gen
# Beginning of ignorem generated ignores.
# ignorem installed gitignores: 

(will contain pre-made gitignores)

# END ignorem auto-gen
```

