class ReadingListApp(App):
"""
This is main class for this entire programm
"""
top_label = StringProperty()
bottom_label = StringProperty()
def on_start(self): # initializing the program
print("Programm is called.")
self.book_button("r")
def build(self):
"""
set Kivy for GUI
:return: root kivy widget
"""
self.status_text = "Reading List App 2.0"
self.title = "Reading list 2.0"
self.root = Builder.load_file("app.kv")
Window.size = (1000, 650) # window size
return self.root
def __init__(self, **kwargs):
"""
main application build
"""
super().__init__(**kwargs)
self.list_books = BookList()
self.list_books.load_file()
def display_book_list(self, required_or_complited):
"""
This function create button for required book and completed book and put th book in to the interface to display
Also, display the book with different colour depend on the number of pages
:param required_or_complited: "True" is required book and "False" is completed book
:return: None
"""
self.root.ids.displayBookList.clear_widgets()
if required_or_complited == True:
for book in self.list_books.booklists:
if book.status == 'r':
button = Button(text=book.title)
button.bind(on_release=self.required_book)
if book.longBook(
): # check ths number of pages of book whether the page is over 500
button.background_color = over_500_pages_book_colour # put the colour which is set on the first part of programm for over 500 pages Book
else:
button.background_color = under_500_pages_book_colour # put the colour which is set on the first part of programm for under 500 pages Book
self.root.ids.displayBookList.add_widget(button)
self.bottom_label = "Click books to mark them as completed" #display the message on botton bar
self.top_label = "Total pages to read: {}".format(
self.list_books.get_total_pages("r"))
elif required_or_complited == False:
for book in self.list_books.booklists:
if book.status == 'c':
button = Button(text=book.title)
button.bind(on_release=self.completed_book)
button.background_color = complited_book_colour # put the colour which is set on the first part of programm for completed book
self.root.ids.displayBookList.add_widget(button)
self.bottom_label = 'Click the book to see the details' #display the message on botton bar
self.top_label = "Total pages completed: {}".format(
self.list_books.get_total_pages('c'))
def required_book(self, sample):
"""
This function shows how many pages to read and have a button for moving required book to completed book
:param sample: kivy button
:return: None
"""
title = sample.text
getBook = self.list_books.get_book_by_title(title)
getBook.mark_book_completed() # move required book to completed book
self.top_label = "Total pages to read: {}".format(
self.list_books.get_total_pages('r'))
self.root.ids.displayBookList.remove_widget(widget=sample)
def completed_book(self, sample):
"""
This function displaying message for completed book
:param sample: kivy button
:return: None
"""
title = sample.text
completed_book = self.list_books.get_book_by_title(title)
self.bottom_label = '{},(completed)'.format(
completed_book) # displaying message for completed book
def book_button(self, mode):
"""
This function highlights the button pressed by the clicks by users
:param mode: "r" is required book and "c" is completed book.
This shows whether user clicked required book or completed book
:return: None
"""
if mode == "r":
self.display_book_list(True) # shows required books
self.root.ids.listRequired_button.state = 'down' # state of button when required book is displayed
self.root.ids.listCompleted_button.state = 'normal' # state of button when completed book is displayed
elif mode == "c":
self.display_book_list(False) # shows completed books
self.root.ids.listRequired_button.state = 'normal' # state of button when required book is displayed
self.root.ids.listCompleted_button.state = 'down' # state of button when completed book is displayed
def clear_button(self):
"""
This function delete the user input in "title", "author", and "page"
:return: None
"""
self.root.ids.title_of_book.text = ''
self.root.ids.book_author.text = ''
self.root.ids.number_of_page.text = ''
def add_new_book(self, name_of_book, name_of_author, number_of_pages):
"""
This function is for "add item" button for add a new book.
Also, displays suitable message for each situation
:param name_of_book: user input the "title" of new book
:param name_of_author: user input the "author"
:param number_of_pages: user input the number of "pages" of new book
:return: None
"""
try: # Error checking
count = 0
for each in str(
name_of_author
): # check whether there is no word in author name section
if each not in (string.ascii_letters + ' '):
count += 1
if count > 0:
self.bottom_label = "Please enter valid author name, Author name cannot be a number"
elif name_of_book == '' or name_of_book.isspace(
) or name_of_author == '' or name_of_author.isspace(
) or number_of_pages == '':
self.bottom_label = "All filed must be completed"
elif int(
number_of_pages
) <= 0: # check whether there is no number in page section
self.bottom_label = "Please enter a valid number"
else:
added_book = Book(name_of_book, name_of_author,
int(number_of_pages), 'r')
self.list_books.add_book(added_book)
self.list_books.save_file(
) # save a new book when a new book is added
self.book_button("r")
self.clear_button()
except ValueError: # check whether there is invalid entry on page section
self.bottom_label = "Please enter a valid number"
def on_stop(self):
print('Stop')
self.list_books.save_file(
) # save changed or added books to the "books.csv" when the program finish
class BookListPanel(GridLayout):
total_pages_label = ObjectProperty(None)
book_list_view = ObjectProperty(None)
status_bar = ObjectProperty(None)
total_pages_label_text = StringProperty()
status_bar_text = StringProperty()
def __init__(self, **kwargs):
kwargs['cols'] = 1
super(BookListPanel, self).__init__(**kwargs)
self.book_list = BookList('books.csv')
self.book_list_adapter = ListAdapter(data=[],
args_converter=self.book_convert,
cls=ListItemButton,
selection_mode='single',
allow_empty_selection=False)
self.refresh_books(completed=False)
# self.add_widget(self.book_list_view)
def refresh_books(self, completed: bool):
book_list_data = [
book for book in self.book_list.sorted()
if book.completed == completed
]
self.book_list_adapter.data = book_list_data
total_pages = self.book_list.get_total_pages(completed)
if completed:
self.status_bar_text = 'Select a book...'
self.total_pages_label_text = (
'Total pages completed: {}'.format(total_pages))
else:
self.status_bar_text = 'Click books to mark them as completed'
self.total_pages_label_text = (
'Total pages to read: {}'.format(total_pages))
def book_convert(self, row_index, book):
if book.is_long():
book_color = (0.5, 0, 0, 1) # red
else:
book_color = (0, 0.5, 0, 1) # green
return {
'text': book.title,
'on_press': self.book_click,
'size_hint_y': None,
'height': 25,
'deselected_color': book_color,
'selected_color': book_color
}
def book_click(self, button):
selected_book = self.book_list.get_by_title(button.text)
if selected_book.completed:
self.status_bar_text = str(selected_book)
else:
selected_book.mark_completed()
self.refresh_books(False)
self.book_list.save()
