unkontributors/super_unko

Super Unko project is the one of the awesome, clean and sophisticated OSS projects in the world.

super_unko project is the one of the awesome, clean and sophisticated OSS project in the world. Let's create poop commands!

super_unko プロジェクトは世界で最もクリーンで洗練されたOSSプロジェクトの一つです。 うんこなコマンドを作りましょう。

Table of Contents

• Commands
• Installation
  • Linux
    • With yum (RHEL compatible distros)
    • With apt (Debian base distros)
    • With AUR (ArchLinux base distros)
  • macOS
  • Docker
  • Zsh plugin manager
  • Additional Installation
• Usage
• Development
  • Codestyle and lint
    • Help
    • Code format
    • Code format and save
    • Code lint
    • Code format and lint
  • Testing
  • CI workflow
• Contribution
• LICENSE
  • Source Code
  • Logo
• History
• For Unkontributors (開発者向け)

Commands

Command	Description
super_unko	Controles sub unkommands
unko.tr	Convert various expressions equals to poop into 💩 (poop).
unko.ls	Shows various poop expression.
unko.yes	Generate 💩 poop forever.
unko.tower	Build your poop tower.
unko.pyramid	Build your poop pyramid.
bigunko.show	Big poop.
unko.printpnm	Generate 💩 PNM image file.
unko.puzzle	Sliding block puzzle.
unko.toilet	Display large 💩 characters.
unko.grep	Print lines matching a 💩 pattern.
unko.say	King 💩 says a message.
unko.shout	King 💩 shouts a message.
unko.think	King 💩 thinks something.
unko.life	Play 💩's game of life.
unko.any	Simple wrapper to 💩 substitution for unko.shout.
unko.king	Build your king shift tower.
unko.fizzbuzz	No need to implement FizzBuzz.
unko.ping	Ping the 💩 domain.
unko.encode	Encode/Decode data and print to standard output.
unko.date	TBD
unko.awk	TBD
unko.xargs	TBD

Installation

Linux

With yum (RHEL compatible distros)

$ sudo yum install https://git.io/superunko.linux.rpm

Uninstall (not super_unko)

$ sudo yum remove superunko

With apt (Debian base distros)

$ wget https://git.io/superunko.linux.deb
$ sudo dpkg -i ./superunko.linux.deb

Uninstall (not super_unko)

$ sudo apt remove superunko

With AUR (ArchLinux base distros)

You can install super_unko from https://aur.archlinux.org/packages/super_unko-git/ with your favorite aur helper.

e.g. with yay:

$ yay -S super_unko-git

Uninstall (not super_unko)

$ sudo pacman -R super_unko-git

macOS

• With Homebrew

$ brew tap unkontributors/unko
$ brew install super_unko

Uninstall

$ brew remove super_unko

Docker

• With docker

$ git clone https://github.com/unkontributors/super_unko.git
$ cd super_unko
$ docker-compose build
$ docker-compose run super_unko unko.shout こんにちは
$ docker run --rm -it unkontributors/super_unko unko.shout こんにちは

Zsh plugin manager

Zsh plugin managers like antigen, zplug can be adoptive. Not only commands can be used but also command_not_found_handler is updated. It is extremely helpful for developers.

• Example of antigen

antigen bundle "unkontributors/super_unko"

Additional Installation

• unko.puzzle
• unko.shout - Need a echo-sd command
• unko.say - Need a cowsay command ($ apt install cowsay)
• unko.think - Need a cowthink command ($ apt install cowsay)
• unko.toilet - Need a toilet command ($ apt install toilet)

Usage

$ echo "うんこ" | unko.tr
💩

$ echo "うんち" | unko.tr
💩

$ ./unko.yes
💩
💩
💩
💩
💩
💩
💩
...

Development

Codestyle and lint

We are checking code with shfmt and shellcheck. Please check your code by linter.sh if you want to add your origin unko commands. We must provide clean unkos. So, please run below and pass all checkings.

make setup

make lint
# or
./linter.sh

linter.sh checks your code or all code of this project. linter.sh depends on docker and docker-compose commands. And you don't need to install shfmt and shellcheck.

Usage examples of linter.sh are below.

Help

./linter.sh help

Code format

./linter.sh format

Code format and save

./linter.sh format-save

Code lint

./linter.sh lint

Code format and lint

./linter.sh all

Testing

We use the bats testing framework. test.sh calls the bats. But you don't need to install bats. Test tasks use docker and the docker uses bats internally and runs tests.

Run below for testing.

make setup ## Need long times to build docker images.
make test

Run below for testing on multiple Bash versions. Please do that and fix it if tests failed on CI.

make check
make test-bash-version

CI workflow

CI workflow runs when you pushed. Workflow diagram is below.

Contribution

Welcome! Welcome!

LICENSE

Source Code

💩 LICENSE (Something like BSD license)

Logo

Creative 💩 license (Something like public domain)

History

• シェル芸勉強会中に爆誕したsuper_unkoリポジトリを巡る悲喜交々 - Togetter
• 【まとめたくない】super_unkoリポジトリがスクスク成長【義務感】 - Togetter

For Unkontributors (開発者向け)

Please put your commands under bin directory. Run bash package.sh on a host which docker installed to generate multiple installer packages under pkg directory.

Codebase is supposed to be scanned with code formatter and static analysis tools to ensure the quality of the code. Please make sure prepared static checks are passed by running ./liner.sh all before submitting your PR. It would be appreciated if you could add tests to ./test.sh.

Please make sure the default branch of this repository is oshiri (which means "bum") not master.

bin 以下になんか思いついたコマンドを放り投げてください。 docker が入った環境で bash package.sh すると pkg 以下に各種インストーラーが作成されます。

CIでコードフォーマットと静的解析にかけてコード品質を維持するようになりました。 PRするときは./linter.sh allで静的解析をパスすることを確認してください。

可能なら./test.shにもテストコードを追加していただけると助かります。

なお、このリポジトリのデフォルトのブランチはoshiriでありmasterではありません。