https://github.com/aosc-dev/oma
Package Manager for AOSC OS
https://github.com/aosc-dev/oma
aosc apt cli package-manager rust
Last synced: 2 months ago
JSON representation
Package Manager for AOSC OS
- Host: GitHub
- URL: https://github.com/aosc-dev/oma
- Owner: AOSC-Dev
- License: gpl-3.0
- Created: 2023-01-29T10:02:36.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2024-10-29T09:00:16.000Z (6 months ago)
- Last Synced: 2024-10-29T09:26:30.876Z (6 months ago)
- Topics: aosc, apt, cli, package-manager, rust
- Language: Rust
- Homepage:
- Size: 32.9 MB
- Stars: 31
- Watchers: 3
- Forks: 2
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: COPYING
Awesome Lists containing this project
README
### oma - Oh My Ailurus / Package Manager for AOSC OS
[Features](#features) | [Install](#installation) | [Contribute](#contributing)
oma is an attempt at reworking APT's interface, making it more user-friendly, more robust against common user errors, and more performant during package downloads. oma also integrates closely with AOSC OS's various system management functions, from mirror configuration, topic (testing) repository enrollment, to system feature protection.
For a more detailed overview on oma's features, see [features](#Features).
### oma is also available for other dpkg-based OS.
Please see [Install](#installation).
## Features
- **Clear-and-Simple Interface:** Colorful and TUI-heavy interface, with clear marking for key information and simplified commands for common operations.
- **Faster Downloads:** Faster package downloads, powered by the performant [reqwest](https://crates.io/crates/reqwest) HTTP and multi-threaded downloads.
- **Smart Search:** Leveraging the [indicium](https://crates.io/crates/indicium) search engine for more relevant package search results.
- **Fool-Proofing Mechanisms:** Protection against system failures through a combination of mechanisms - active prevention against removal of essential packages, clear marking for potentially dangerous operations, and a disaster recovery mechanism through `undo` command.
- **System Feature Protection:** Informing and advising against uninstalling critical system components by detecting [System Feature Markers](https://wiki.aosc.io/developer/packaging/feature-marking-guidelines/) in key component packages (AOSC OS only).
- **System Status Integration:** Integration with system daemons, allowing oma to warn against performing package management operations on battery power, as well as actively inhibiting accidental reboots and suspends.
- **Compatibility with Other dpkg-based OS:** Bringing a more friendly package management experience to major dpkg-based distributions like Debian, Ubuntu, deepin, and openKylin.
- **Distro-specific Integration:** Supporting not only AOSC OS-specific features such as topic repository enrollment and mirror management, but also distro-specific services such as Ubuntu Pro.
## Installation
oma is pre-installed with AOSC OS. It is also available for Debian, Ubuntu, Deepin, openKylin, and more dpkg-based OS.
### Automatic Installation
```bash
curl -sSf https://repo.aosc.io/get-oma.sh | sudo sh
```
### Building from Source
#### Dependencies
To build oma, ensure the following dependencies are installed:
- libapt-pkg (part of [APT](https://salsa.debian.org/apt-team/apt.git))
- [LLVM and Clang](https://llvm.org/)
- [Nettle](https://www.lysator.liu.se/~nisse/nettle/) (recommended) or [OpenSSL](https://openssl.org/)
- [Rustc](https://www.rust-lang.org/) and [Cargo](https://crates.io/)
- [pkg-config](https://www.freedesktop.org/wiki/Software/pkg-config/) or [pkgconf](http://pkgconf.org/)
During runtime, oma requires or recommends the following:
- [ripgrep](https://github.com/BurntSushi/ripgrep) (optional, accelerates `oma provides`, `oma files`, and `oma command-not-found`)
#### Build Procedure
1. Clone the repository:
```bash
git clone https://github.com/AOSC-Dev/oma.git
cd oma
```
2. Build the binary as an installable .deb package (Ubuntu/Debian):
```bash
apt install build-essential zlib1g-dev libssl-dev pkgconf nettle-dev libapt-pkg-dev curl xz-utils clang libbz2-dev liblzma-dev
cargo install cargo-deb
cargo deb -Z xz
```
3. Install and profit!
## Usage
### Entering the interactive package management interface
```bash
oma # without arguments
```
### Example Commands
- Installing a package:
```bash
oma install
```
- Searching for a package:
```bash
oma search
```
- Removing a package:
```bash
oma remove
```
- Refreshing repository metadata (done automatically before `oma install` and `oma upgrade`):
```bash
oma refresh
```
For a full list of available sub-commands and arguments, run:
```bash
oma help
```
## Command Reference
| Command | Description |
| ------------ | ------------------------------------------- |
| `install` | Install package(s) from the repository |
| `upgrade` | Upgrade all installed packages |
| `download` | Download package(s) without installing |
| `remove` | Remove specified package(s) |
| `refresh` | Refresh repository metadata |
| `search` | Search for package(s) in the repository |
| `show` | Show detailed information for a package |
| `files` | List files in the specified package |
| `provides` | Find packages providing specific patterns |
| `fix-broken` | Fix broken dependencies |
| `pick` | Install a specific version of package(s) |
| `mark` | Mark package(s) with a specific status |
| `list` | List all available packages |
| `depends` | Show dependencies for package(s) |
| `rdepends` | Show reverse dependencies for package(s) |
| `clean` | Clear downloaded package cache |
| `history` | Show package history or change logs |
| `help` | Show help of oma or the given subcommand(s)
## Contributing
**Contributions are welcome!**
Please feel free to file issues or pull requests to help improve oma.
**Please see [CONTRIBUTING](./CONTRIBUTING.md) for detailed instructions.**
## License
oma is licensed under the GNU General Public License v3.0. See the [COPYING](./COPYING) file for details.
