# porcelain

cli dollcode encoder and decoder

## example usage

### encode

```sh
porcelain encode 893271
# ▖▖▘▘▌▘▌▌▘▘▘▌▌
porcelain encode 0xda157
# ▖▖▘▘▌▘▌▌▘▘▘▌▌
porcelain encode -x da157 # or --hex
# ▖▖▘▘▌▘▌▌▘▘▘▌▌
porcelain encode --string hello # or -s
# ▖▖▖▌▘▖▖▌▘▘▌▖▌▖▘▌▖▌▖▖▘▌▌▘▖
```

### decode

```sh
porcelain decode ▖▖▖▌▘▖▖▌▘▘▌▖▌▖▘▌▖▌▖▖▘▌▌▘▖
# decimial: 448378203247, hexadecimal: 68656C6C6F, string: hello
porcelain decode -d ▖▖▘▘▌▘▌▌▘▘▘▌ # or --decimial
# 893271
porcelain decode --hex ▖▖▘▘▌▘▌▌▘▘▘▌▌ # or -x
# DA157
porcelain decode --string ▖▖▖▌▘▖▖▌▘▘▌▖▌▖▘▌▖▌▖▖▘▌▌▘▖ # or -s
# hello
```

## packaged

### crates.io

```sh
cargo install porcelain
```

### nix flake

run without installing

```sh
nix run https://codeberg.org/da157/porcelain/archive/main.tar.gz -- encode 0xda157
```

install onto nixos system (with flakes)

```nix
# flake.nix
{
  inputs = {
    # ...
    porcelain = {
      url = "https://codeberg.org/da157/porcelain/archive/main.tar.gz";
      inputs.nixpkgs.follows = "nixpkgs";
    };
  };

  outputs = { nixpkgs, ... }@inputs: {
    nixosConfigurations.default = nixpkgs.lib.nixosSystem {
      modules = [ ./configuration.nix ];
      specialArgs = { inherit inputs; };
    };
  }
}
# configuration.nix
{ pkgs, inputs, ... }:
{
  environment.systemPackages = [
    inputs.porcelain.packages.${pkgs.stdenv.hostPlatform.system}.porcelain
  ];
}
```