Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/cvalencia1991/ruby-catalog-of-my-things

"Catalog of my things" is a Ruby console app for managing book, music, and game collections. It lets you input and view information about each item, making it an essential tool for collectors.
https://github.com/cvalencia1991/ruby-catalog-of-my-things

rspec ruby

Last synced: about 5 hours ago
JSON representation

"Catalog of my things" is a Ruby console app for managing book, music, and game collections. It lets you input and view information about each item, making it an essential tool for collectors.

Awesome Lists containing this project

README

        

# 📗 Table of Contents

- [📗 Table of Contents](#-table-of-contents)
- [📖 Catalog of my things ](#-catalog-of-my-things-)
- [🛠 Built With ](#-built-with-)
- [Tech Stack ](#tech-stack-)
- [Key Features ](#key-features-)
- [🚀 Live Demo ](#-live-demo-)
- [💻 Getting Started ](#-getting-started-)
- [Prerequisites](#prerequisites)
- [Setup](#setup)
- [Install](#install)
- [Usage](#usage)
- [Run tests](#run-tests)
- [Deployment](#deployment)
- [👥 Authors ](#-authors-)
- [🔭 Future Features ](#-future-features-)
- [🤝 Contributing ](#-contributing-)
- [⭐️ Show your support ](#️-show-your-support-)
- [🙏 Acknowledgments ](#-acknowledgments-)
- [❓ FAQ ](#-faq-)
- [📝 License ](#-license-)

# 📖 Catalog of my things

This project involves creating a console application that allows users to keep track of their personal collection of books, music albums, and games. The program is structured according to the [UML class diagram](./src/images/catalog_of_my_things.png). The data is stored in JSON files and a database is also set up with tables that match the class structure of the program

## 🛠 Built With

### Tech Stack

Server Side

Database

### Key Features

- **List all books**
- **List all music albums**
- **List of games**
- **List all genres (e.g 'Comedy', 'Thriller')**
- **List all labels (e.g. 'Gift', 'New')**
- **List all authors (e.g. 'Stephen King')**
- **Add a book**
- **Add a music album**
- **Add a game**
- **Preserve data in JSON files**
- **Created a console app**

(back to top)

## 🚀 Live Demo

- [Video Presentation](https://drive.google.com/file/d/13-B45_cwSHZzMrKYeY-2BehYVFYm5_Jb/view?usp=sharing)
- If you want to have a glimpse of our project, [here it is](./src//images/console_app.PNG)

(back to top)

## 💻 Getting Started

To get a local copy up and running, follow these steps.

### Prerequisites

In order to run this project you need:

```sh
gem install ruby or sudo gem install ruby
gem install rspec
gem install colorize
```

### Setup

Clone this repository to your desired folder:

```sh
cd my-folder
git clone https://github.com/cvalencia1991/Ruby-Catalog-of-my-things
```

### Install

Install this project with:

```sh
cd my-project
bundle install
```

### Usage

To run the project, execute the following command:

```sh
ruby main.rb
```

### Run tests

To run tests, run the following command:

```sh
src/spec rspec_file.rb or rspec .
```

### Deployment

You can deploy this project using:

```sh
ruby main.rb
```

(back to top)

## 👥 Authors

👤 **Kanza ahreem**

- GitHub: [@KanzaTahreem](https://github.com/KanzaTahreem)
- Twitter: [@kanza_tahreem](https://twitter.com/kanza_tahreem)
- LinkedIn: [Kanza Tahreem](https://www.linkedin.com/in/kanza-tahreem/)

👤 **Cesar Alberto Valencia Aguilar**

- GitHub: [@cvalencia1991](https://github.com/cvalencia1991)
- Twitter: [@cvalenciaguilar](https://twitter.com/cvalenciaguilar)
- LinkedIn: [@cvalencia1991](https://www.linkedin.com/in/cvalenciaguilar/)

👤 **Shaker AbuDrais**

- GitHub: [@Shaker](https://github.com/shakerAbuDrais/)
- LinkedIn: [Shaker](https://www.linkedin.com/in/shaker-abady/)

(back to top)

## 🔭 Future Features

- **List all movies**
- **List all sources (e.g. 'From a friend', 'Online shop')**
- **Add a movie**

(back to top)

## 🤝 Contributing

Contributions, issues, and feature requests are welcome!

Feel free to check the [issues page](https://github.com/cvalencia1991/Ruby-Catalog-of-my-things/issues).

(back to top)

## ⭐️ Show your support

Please ⭐️ this repository if you found the project useful.

(back to top)

## 🙏 Acknowledgments

I would like to thank for the group project, all great effort get award

(back to top)

## ❓ FAQ

> Add at least 2 questions new developers would ask when they decide to use your project.

- **could you deploy this project in any other language?**

- Yes, ou can deploy this project using any other back end language

(back to top)

## 📝 License

This project is [MIT](./LICENSE) licensed.

(back to top)