https://github.com/barbaraeguche/book-record-organizer

📖 a circular linked-list for organizing book records.
https://github.com/barbaraeguche/book-record-organizer

cli dsa exception-handling file-handling inner-classes linkedlist oop-principles

Last synced: 3 months ago
JSON representation

📖 a circular linked-list for organizing book records.

• Host: GitHub
• URL: https://github.com/barbaraeguche/book-record-organizer
• Owner: barbaraeguche
• License: mit
• Created: 2024-02-01T17:07:28.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-11-14T04:21:20.000Z (7 months ago)
• Last Synced: 2025-01-18T03:40:44.457Z (5 months ago)
• Topics: cli, dsa, exception-handling, file-handling, inner-classes, linkedlist, oop-principles
• Language: Python
• Homepage:
• Size: 42 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: readme.md
  • License: license

Awesome Lists containing this project

README

        
# book record organizer 📖

a circular linked list system designed to efficiently organize book records, featuring invalid year filtering, record insertions, and cleanup capabilities.

## features 👾

- **year extraction:** creates a `{year}.txt` file containing records based on a specified year.

- **record deletion:** removes consecutive repeated records from the list to maintain data integrity.

- **author records:** generates a new list that includes only the records from a specified author.

- **insertion before isbn:** inserts a book object before a record with a given isbn number.

- **insertion between isbns:** inserts a book object between two specified isbn numbers, provided both are found in the list.

- **isbn swaps:** swaps the positions of two isbn numbers in the list if they exist.

- **commit changes:** saves the updated list to a file named `commit.txt` upon command.

- **stop talking:** terminates the conversation and exits the program.

## running the project 🏁

to get the project up and running on your local machine, follow these steps:

- **ensure python is installed:** must have [python version ^3.11](https://www.python.org/downloads/) installed.

- **clone the repository:**

```bash

git clone https://github.com/barbaraeguche/book-record-organizer.git

```

- **navigate to the project directory:**

```bash

cd book-record-organizer

```

- **run the project:**

```bash

python3 driver.py

```

## gallery 📸

  showcase

  - **initial run**

  ![init](https://github.com/user-attachments/assets/606431a7-8c27-47e3-aebb-95f7b88e7b30)

  - **option 2**

  ![option 2](https://github.com/user-attachments/assets/356ddeaf-7a31-4aba-b1d4-1f2abea51312)

  - **option 3**

  ![option 3](https://github.com/user-attachments/assets/863fc0a0-ba9d-4c4c-9400-bac0d83d1cb2)

  - **option 5**

  ![option 5](https://github.com/user-attachments/assets/6f9764c9-b6a1-4094-9706-b8202cc28c17)