Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/TheAlexDev23/japm
A package manager that uses curses to provide a friendly UI
https://github.com/TheAlexDev23/japm
c cli package package-manager packages tui
Last synced: about 2 months ago
JSON representation
A package manager that uses curses to provide a friendly UI
- Host: GitHub
- URL: https://github.com/TheAlexDev23/japm
- Owner: TheAlexDev23
- License: gpl-3.0
- Created: 2022-03-27T13:51:03.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2023-05-17T09:23:34.000Z (about 1 year ago)
- Last Synced: 2024-01-27T17:01:42.875Z (5 months ago)
- Topics: c, cli, package, package-manager, packages, tui
- Language: C
- Homepage:
- Size: 259 KB
- Stars: 11
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Lists
- cli-apps - JAPM - A package manager that uses curses to provide a friendly UI (<a name="package-manager"></a>Package managers)
- awesome-cli-apps - JAPM - A package manager that uses curses to provide a friendly UI (<a name="package-manager"></a>Package managers)
README
JAPM
Just-Another-Package-Manager
JAPM is not intended to be the *"next package manger"* nor a large and powerfull package manager like apt or pacman. It is, rather, a small and light-weight package manager that can allow you to install small programs. These programs are usually made by indie open source developers. Having a separate package manager allows managing packages in a more organized way. From one side you will have large software that is installed by your main package manager and from the other you have small tools you found on github that make your day-to-day easier. Having all those packages managed by a single package manager can be uncomfortable, and JAPM tries to bring a solution to this.
JAPM is also different from other package managers in the sense that it uses ncurses to create a TUI and represent information in a more organized and better looking way.
However if you want to use it without ncurses it can also work as a normal comand-line package manager.
A package is a .json file usually saved in a remote repository, by default it is [Japm Official Packages](https://github.com/TheAlexDev23/japm-official-packages). If you want to create a package, said repository has the instructions.
# JAPM necessary milestones
- [x] Logging system
- [x] Error system
- [x] Input parsing system
- [x] JSON parsing
- [x] Local DB CRUD
- [x] Remote DB reading
- [x] Actions system
- [x] Package file download
- [x] Package Installation
- [x] Package Removal
- [x] Package Update
- [x] Package Search
- [x] Progress bar
- [x] Package list
# Dependencies:
```
libjson-c sqlite3 ncurses curl
```
Note, that even though JAPML has an option of not displaying curses mode, the ncurses library is still required for building from source.
# Bulding from source
```bash
git clone https://github.com/TheAlexDev23/japm.git
cd japm
cmake -S . -B build
cd build
make
cp ./japm /usr/bin
```
# Downloading a release
Download the [latest release](https://github.com/TheAlexDev23/japm/releases/latest) and move japm to /usr/bin
# How to use
## Installing packages
This will install all packages and it's dependencies
`sudo japm install package_name1 package_name2 package_name2`
## Removing packages
Will remove if no packages depend on these.
`sudo japm remove package_name1 package_name2 package_name3`
If you want to delete a package and all packages that depend on it run the following:
`sudo japm -rec remove package_name1 package_name2 package_name3`
## Updating packages
Will reinstall selected packages but not dependencies
`sudo japm update package_name1 package_name2 package_name3`
If you want to update **all** installed packages
`sudo japm -all update`
## Searching for packages
Will search and print general information about a package.
`sudo japm search package_name1 package_name2 package_name3`
## Running without ncurses
`sudo japm -nocurses ...`
## Providing log files
`sudo japm --log_files logf1 logf2 logf3 --error_log_files errlogf1 errlogf2 errlogf3`
## Other commands
Run `sudo japm --help` for a list of available commands and parameters.