Skip to content
This repository has been archived by the owner on Sep 11, 2023. It is now read-only.
/ Owl Public archive

[WIP] 🦉 Owl is a pacman-like ReCT Package System CLI application 🦉

License

Notifications You must be signed in to change notification settings

hrszpuk/Owl

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Owl

[DEPRECIATED] 🦉 Owl is a pacman-like ReCT Package System CLI application 🦉

Owl is a CLI application to easily install ReCT packages from https://rps.rect.ml. Owl is inspired by Arch Linux package manager, pacman. Packages can be installed, removed, updated, and more!

⚠️ THIS REPOSITORY IS DEPRECIATED ⚠️

This repository has been publicly archived as the ReCT programming language has ceased development (and other project overtook this one).

An example of basic owl usage is shown below:

$ owl -Syu      // Update the RPS packages
$ owl -S sys    // Install "sys" package from RPS
$ owl -R sys    // Remove "sys" package from RPS

Installation

Build from source

AUR installation

Usage

The Owl help menu can be shown by typing owl or owl --help. Commands take a flag, and if that flag requires and argument it follows the flag.

$ owl <flag> [argument]

Flags

All the flags that Owl accepts are based on the pacmam package manager flags. In the table below, some flags require an argument and use example instead of a package name.

name Flag Example Explanation
Update Packages -Syu owl -Syu Update all packages and package dependencies on the system. This will also update the internal package index cache.
Install Package(s) -S owl -S example Sync package with package database. This installs the package and allows it to be used in ReCT code. Multiple packages can be installed by separating each package with a space after the -S flag.
Remove Package(s) -R owl -R example Removes package from package database and deletes package from package storage. Multiple packages can be removed by separating each package with a space after the -R flag.
Remove Package(s) and dependencies -Rd owl -Rd example Removes the package and it's dependencies from the database. Mutliple packages can be listed. Dependencies are only removed if they are not required by any other package.
Remove redundant dependencies -Rrd owl -Rrd Removes any packages that are installed as a dependency, but are not used as a dependency by any package on the system. This may be useful for freeing up space.
Search for package -Ss owl -Ss example Search through package index for the given package. If found, package information will be shown in the console (including how to install the package), otherwise owl will inform you of it's non-existence.
View dependencies of a package -Qds owl -Qds example Shows a list of dependencies required by a given package. This works for both installed packages and packages on the RPS.
View all installed dependencies -Qd owl -Qd Shows a list of all dependency packages installed on the system. This also tells you what packages are using each dependency.
View all installed packages -Q owl -Q Show a list of every package currently installed on the system as well as other useful information.
Install a local package -U owl -U path/to/package Opens a dialog to create a new package and install it onto the local package index. This will not upload the package to the RPS, but will allow the package to be used by any ReCT program system-wide.
View package information -I owl -I package View basic package information such as author, version, and more.

The shorthand version of these flags can be confusing and hard to learn. Owl also has alternatives to these shorthand flags that may be more appealing to you.

Flag Alternative
-Syu update
-S get
-R remove
-Rd eliminate
-Rrd clean
-Ss search
-Qds deps
-Qd deps
-Q packages
-U install
-I info

Contributing

Contributing helps keep this tool safe to use and up to date. If you want to help, why not create an issue?