Small Enhancements - black, user-supplied string mode, utf-8 preview

LICENSE.txt

@@ -1,6 +1,8 @@
 The MIT License (MIT)
 
 Copyright (c) 2013 Eric Romano (@gelstudios).
+Copyright (c) 2020 Petabyte (@petabyt)
+Copyright (c) 2024 i-infra (@i-infra)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -18,4 +20,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE
+SOFTWARE

README.md

@@ -1,119 +1,7 @@
-[![Build Status](https://travis-ci.org/gelstudios/gitfiti.svg?branch=master)](https://travis-ci.org/gelstudios/gitfiti)
+# giving
 
-**gitfiti** _noun_ : Carefully crafted graffiti in a github commit history calendar.  
+Contribution-graph art, drawn with [gitfiti](https://github.com/gelstudios/gitfiti).
 
-An example of gitfiti in the wild:  
-![screenshot of gitfiti](https://raw.github.com/gelstudios/gitfiti/master/gitfiti-screenshot.png "screenshot")
-
-`gitfiti.py` is a tool to decorate your github account's commit history calendar by (blatantly) abusing git's ability to accept commits _in the past_.
-
-How? `gitfiti.py` generates a script (powershell or bash) that makes commits with the GIT_AUTHOR_DATE and GIT_COMMITTER_DATE environment variables set for each targeted pixel.
-
-Since this is likely to clobber repo's history, it is highly recommend that you create a _new_ github repo when using gitfiti. Also, the generated script assumes you are using public-key authentication with git.
-
-### Pixel Art
-
-![pixel art examples](https://raw.github.com/gelstudios/gitfiti/master/pixels-large.png "pixel art")  
-Included "art" from left to right: kitty, oneup, oneup2, hackerschool, octocat, octocat2
-
-### Usage
-
-1. Create a new github repo to store your handiwork.
-2. Run `gitfiti.py` and follow the prompts for username, art selection, offset, and repo name.
-
-For Python 3, use `python3`.
-
-```console
-    $ python3 ./gitfiti.py
-
-              _ __  _____ __  _
-       ____ _(_) /_/ __(_) /_(_)
-      / __ `/ / __/ /_/ / __/ /
-     / /_/ / / /_/ __/ / /_/ /
-     \__, /_/\__/_/ /_/\__/_/
-    /____/
-
-    Enter GitHub URL (leave blank to use https://github.com/):
-```
-
-For Python 2, use `python2`.
-
-```console
-    $ python2 ./gitfiti.py
-
-              _ __  _____ __  _
-       ____ _(_) /_/ __(_) /_(_)
-      / __ `/ / __/ /_/ / __/ /
-     / /_/ / / /_/ __/ / /_/ /
-     \__, /_/\__/_/ /_/\__/_/
-    /____/
-
-    Enter GitHub URL (leave blank to use https://github.com/):
-```
-
-3. Run the generated `gitfiti.sh` or `gitfiti.ps1` from your home directory (or any non-git tracked dir) and watch it go to work.
-4. Wait... Seriously, you'll probably need to wait a day or two for the gitfiti to show in your commit graph.
-
-### User Templates
-
-The file format for personal templates is the following:
-
-1. Each template starts off with a ":" and then a name (eg. ":foo")
-2. Each line after that is part of a json-recognizable array.
-3. The array contain values 0-4, 0 being blank and 4 being dark green.
-4. To add multiple templates, just add another name tag as described in 1.
-
-For example:
-
-```
-:center-blank
-[[1,1,1,1,1,1,1],
-[1,1,1,1,1,1,1],
-[1,1,1,1,1,1,1],
-[1,1,1,0,1,1,1],
-[1,1,1,1,1,1,1],
-[1,1,1,1,1,1,1],
-[1,1,1,1,1,1,1]]
-```
-
-This would output a 7 x 7 light green square with a single blank center square.
-
-Once you have a file with templates, enter its name when prompted and the templates will be added to the list of options.
-
-### Removal
-
-Fortunately if you regret your gitfiti in the morning, removing it is fairly easy: delete the repo you created for your gitfiti (and wait).
-
-### License
-
-gitfiti is released under [The MIT license (MIT)](http://opensource.org/licenses/MIT)
-
----
-
-#### Todo
-
-- ~~Remove 'requests' dependency~~ [_thanks empathetic-alligator_](https://github.com/empathetic-alligator)
-- ~~Web interface~~ See several web-based things below
-- ~~Load "art" from a file~~ [_thanks empathetic-alligator_](https://github.com/empathetic-alligator)
-- Load commit content from a file
-- Text/alphabet option
-- ~~powershell support!~~ [_thanks axzn_](https://github.com/axzn)
-- ...
-- Profit?
-
-#### Notable derivatives or mentions
-
-- [Vincent Van Git](https://github.com/jh3y/vincent-van-git) Vincent, which offers a [very slick web ui](https://vincent-van-git.netlify.app/) to generate a gitfiti script
-- [github-calendar-customerizer](https://github.com/ZachSaucier/github-calendar-customizer) from ZachSaucier, another very [nice web GUI](https://codepen.io/ZachSaucier/full/PzVRBy) for generating gitfiti templates
-- [git-art](https://github.com/jamesjarvis/git-art) from jamesjarvis, a work-alike web based [editor GUI](https://jamesjarvis.github.io/git-art/) that generates the script too
-- [Pikesley's](https://github.com/pikesley) Pokrovsky, which offers Github History Vandalism [as a Service!](http://pokrovsky.herokuapp.com/)
-- [PSVandalism](https://github.com/DenisBalan/PSVandalism) Wrapper around Pokrovsky, which makes possible vandalising Github History from Powershell
-- [github-board](https://github.com/bayandin/github-board) commits gitfiti from easy templates
-- [ghdecoy](https://github.com/tickelton/ghdecoy) fills the contribution graph with random data (sneaky!)
-- [Gitfiti Painter](http://codepen.io/cbas/pen/vOXeKV) visual drawing tool for artists to easily create templates
-- [git-draw](https://github.com/ben174/git-draw) a Chrome extension which will allow you to freely draw on your commit map(!)
-- [github-jack](https://github.com/tardypad/github-jack) a pure bash version with space invaders and shining creepypasta
-- [github-graffiti](https://github.com/mavrk/github-graffiti) a GUI editor with a bash script to allow custom designs on your commit map
-- [Paint GitHub](https://paintgithub.com/) is the most convenient way to paint your GitHub contribution graph!
-- [contribution-pixel-messages](https://github.com/abulvenz/contribution-pixel-messages) generates a date plan from an editable GUI
-- Seen something else? Submit a pull request or open an issue!
+The calendar squares for the quiet years spell **GIVING** and **SERVING**:
+time spent on community work instead of commits. The graph was never empty;
+it just was not measuring the right thing.