-
Notifications
You must be signed in to change notification settings - Fork 89
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Added bookshopper app README for more info
- Loading branch information
Showing
1 changed file
with
81 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,81 @@ | ||
<h1 align="center"> | ||
<img src=".github/pictures/bookshopper-menu-title.png" align="center" height="130"> | ||
<br> | ||
<font size="4"> Bookshopper application </font> | ||
</h1> | ||
|
||
## Table of Contents | ||
|
||
|
||
- [Details](#details) | ||
- [Get the app](#get-the-app) | ||
- [Downloading](#-downloading-) | ||
- [Installing](#-installing-) | ||
- [Running](#-running-) | ||
- [Usage](#usage) | ||
|
||
## Details | ||
|
||
A bookshop management application. | ||
|
||
The app is meant to help bookshop owners manage their books better and help clients manage their shopping carts, to keep track of the books taken for rental. | ||
|
||
It allows storing of information about books in the shop, helps manage them and acts like a small database manager for books. | ||
|
||
__Notes__: For now, only a _Command-Line Interface_ (CLI) is available for the app. | ||
|
||
## Get the app | ||
|
||
__Note__: for now, only the linux version of the app is supported, though it should run an all Unix-like operating systems. | ||
|
||
<h4 align="center"> Downloading: </h4> | ||
|
||
__Linux__: To download the app, got to the [release page](https://github.com/adipopbv/bookshopper/releases) and select the wanted version for downloading ([latest](https://github.com/adipopbv/bookshopper/releases/latest) version is recomended). | ||
|
||
<h4 align="center"> Installing: </h4> | ||
|
||
__Linux__: No installation is required. Just move the downloaded binary file wherever you like (recomended to ~/.local/bin for a 'this user' only install). | ||
|
||
<h4 align="center"> Running: </h4> | ||
|
||
__Linux__: | ||
* If the install location is in the <code>$PATH</code> variable, you can run the app by typing <code>bookshopper</code> in a command-line environment like a terminal emulator or a tty. | ||
* If the install location is not in the <code>$PATH</code> variable, you need to provide the relative (or absolute) path to the binary file in the command-line environment of your choice. | ||
|
||
## Usage | ||
|
||
The app displays a menu after each operation, presenting all posible operations. | ||
|
||
To select an operation, type the command number indicating the wanted operation and press <code>Enter</code> or <code>Return</code>. | ||
|
||
A book has some fields: _title_, _author_, _genre_, _release year_ and is uniqely identified by _**title**_ and _**author**_. Within the app you can do the following operations: | ||
> 1. Display the full list of books | ||
> 2. Basic operations: | ||
> * Add book | ||
> * Modify book | ||
> * Delete book | ||
<img src=".github/pictures/bookshopper-menu-main.png" align="right" height="350px"> | ||
> 3. Search book (by any fields) | ||
> 4. Filter books by: | ||
> * Title | ||
> * Release year | ||
> 5. Sort books by: | ||
> * Title | ||
> * Author | ||
> * Release year and genre | ||
> 6. Undo add/modify/delete book operations | ||
> 7. Shopping cart operations: | ||
> * List books in cart | ||
> * Empty the shopping cart | ||
> * Add book to cart (by title) | ||
> * Add random books to cart | ||
> * Export cart as CVS | ||
> * List titles | ||
A more elaborate manual will be added to the [wiki](https://github.com/adipopbv/bookshopper/wiki) if decided necessary. |