Skip to content

A nix shell library for generating .gitignore files from github's own templates, with sane defaults!

License

Notifications You must be signed in to change notification settings

Ookiiboy/ignoreBoy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

IgnoreBoy

What is this?

This is a nix-shell lib that helps you create best practice .gitignore files by using Githubs Default .gitignore Templates. No longer will you be held back by the tyrany of copy and pasting files from around the internet! Let this copy paste for you!

Why would I use this? Like, my guy, I almost never touch my .gitignore.

There are a few interesting reasons that you might enjoy using this:

  • Codebases with diverse languages often tend to have a .gitignore that are sparse, and don't use best practices.
  • If you're setting up a development environment for a new codebase, you might not event know what a best practice code .gitignore looks like! Take the Julia language for example. I didn't know it looked like that.
  • You could just copy and paste these templates, but keeping track, and checking for updates (if ever!) is annoying, and might be at the very bottom of your todo list.
  • For the low-low price of using this, there are some sane defaults built-in. All the stuff you forget to add (or never add but should), now added by default!
  • Did a goddamned Node.js project get added to your codebase by Alice. Don't know what to add to the .gitignore? Add "Node" to the array and be done with it.

Okay, I want to at least give it a whirl. How do you use this?

It should look something like the below. We've left out non-related code for brevity. In short, add it to your inputs, and have it run in your shellhook of your main devshell.

{
  inputs = {
    # ...
    ignoreBoy.url = "github:Ookiiboy/ignoreBoy";
  };

  outputs = {
    # ...
    ignoreBoy,
    ...
  } @ inputs: let
    forAllSystems = nixpkgs.lib.genAttrs (import systems);
  in {
    devShells = forAllSystems (system: {
      default = 
        pkgs.mkShell {
          shellHook = ''
            # ...
            ${ignoreBoy.lib.${system}.gitignore {
              # https://github.com/github/gitignore - use this repo, and add 
              # the filename and/ or path/filename to the array, drop the extension.
              ignores = ["Node" "community/JavaScript/Vue"]; 
              # Defaults to true, but you can set to false if you don't want OS
              # related ignores
              useSaneDefaults = true; 
              # Anything custom you might want in your .gitignore you can place in extraConfig.
              extraConfig = ''
                .editorconfig
                .pre-commit-config.yaml
              '';
            }}
            # ...
          '';
          buildInputs = with pkgs; [
            # ...
          ];
        };
    });
    };
  }

About

A nix shell library for generating .gitignore files from github's own templates, with sane defaults!

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published