https://github.com/pbui-project/pbui-main

The main repository for the PBUI project
https://github.com/pbui-project/pbui-main

toolsets userland zig

Last synced: 3 months ago
JSON representation

The main repository for the PBUI project

• Host: GitHub
• URL: https://github.com/pbui-project/pbui-main
• Owner: pbui-project
• License: mit
• Created: 2020-01-15T17:15:19.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2021-07-14T02:51:42.000Z (over 3 years ago)
• Last Synced: 2024-05-03T12:12:10.780Z (6 months ago)
• Topics: toolsets, userland, zig
• Language: Zig
• Size: 319 KB
• Stars: 86
• Watchers: 8
• Forks: 8
• Open Issues: 18
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: Code_of_Conduct.md

Awesome Lists containing this project

• awesome-zig - pbui-project/pbui-main - compliant BSD/Linux Userland Implementation) project is a a free and open source project intended to implement some standard library toolsets in the Zig programming language. (General Operating System / Utility)
• awesome-zig - pbui-main🗒️The main repository for the PBUI project

README

        




pbui-main

Like idlebin, but in zig




  

  

  

  

  



![asciicast](https://chadpaste.com/f/qze.gif)

## What is the PBUI project?

The PBUI (POSIX-compliant BSD/Linux Userland Implementation) project is a a free and open source project intended 

to implement some standard library toolsets in the Zig programming language. We will also implement some basic applets 

and a shell to demonstrate usage of the toolsets as well as provide functionality. 

Another goal of the PBUI project is to help improve documentation for Zig through our blog posts, some of which

will take the form of tutorials that explain how to use both our toolsets and other Zig functions when creating 

applets. By doing this, we hope to make Zig more user friendly and encourage others to create Zig-based applications.

## Dependencies

Supported operating systems:

  - Linux kernel >= `5.4.23` (Validated for Ubuntu)

  - Zig `0.6.0`  

How do I get Zig? Visit the [Zig download page](https://ziglang.org/download/), where you can find source code and

compiled binaries for your operating system.  Zig is also available [

via various package managers](https://github.com/ziglang/zig/wiki/Install-Zig-from-a-Package-Manager).

  

## Installation

After cloning the repository, run `zig build`.  The `pbui` executable will be located in `zig-cache/bin/pbui`.

## Usage

For a list of applets, run `./pbui` or `./pbui -h`.  Currently supported applets include:

  - `basename`

  - `dirname`

  - `false`

  - `head`

  - `ls`

  - `main`

  - `mkdir`

  - `rm`

  - `sleep`

  - `tail`

  - `true`

  - `wc`

  - `zigsay`

  - `cat`

  - `du`

  - `uniq`

  - `shuf`

  - `sha1`

  - `sort`

To run a given applet, use: `./pbui [APPLET] [arguments]`.

### Running applets individually

To run applets individually, you can use `ln -s path/to/repository/zig-cache/bin/pbui APPLET_NAME`.

Then, you can execute the symlink, removing the need to prefix with "./pbui". You can even replace your default shell's applets with ours if you want less functionality but more zig!

Here is an example:

![Example](https://chadpaste.com/f/cgo.13)