imacat/mia-accounting-django
1
0
Fork 0
Code Issues Pull Requests Projects Releases 4 Wiki Activity

Revised the documentation.

Browse Source
This commit is contained in:
依瑪貓 2020-07-02 00:50:27 +08:00
parent 4537681bb5
commit fbce3ab9ef
3 changed files with 29 additions and 33 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
accounting/utils.py
View File

@ -23,19 +23,17 @@
class PeriodParser:
"""The period parser.
Args:
period_spec (str): The period specification.
Attributes:
start: The start of the period.
end: The end of the period.
start (str): The start of the period.
end (str): The end of the period.
"""
start = None
end = None
def __init__(self, period_spec):
"""Constructs a new period parser.
Args:
period_spec (str): The period specification.
"""
self.start = period_spec + "-01"
self.end = period_spec + "-30"
@ -43,18 +41,6 @@ class PeriodParser:
class Pagination:
"""The pagination.
Attributes:
page_no (int): The current page number
page_size (int): The page size
"""
page_no = None
page_size = None
DEFAULT_PAGE_SIZE = 10
def __init__(self, count, page_no, page_size, is_reverse = False):
"""Constructs a new pagination.
Args:
count (int): The total number of records
page_no (int): The specified page number
@ -65,7 +51,17 @@ class Pagination:
Raises:
PageNoOutOfRangeError: if the specified page number is out
of range or is redundant.
Attributes:
page_no (int): The current page number
page_size (int): The page size
"""
page_no = None
page_size = None
DEFAULT_PAGE_SIZE = 10
def __init__(self, count, page_no, page_size, is_reverse = False):
self.page_size = page_size \
if page_size is not None \
else self.DEFAULT_PAGE_SIZE

6
accounting/views.py
View File

@ -39,7 +39,7 @@ def home(request):
"""The accounting home page.
Returns:
(HttpResponseRedirect) The redirection to the default
HttpResponseRedirect: The redirection to the default
accounting report.
"""
return HttpResponseRedirect(reverse("accounting:cash.home"))
@ -50,7 +50,7 @@ def cash_home(request):
"""The accounting cash report home page.
Returns:
(HttpResponseRedirect) The redirection to the default subject
HttpResponseRedirect: The redirection to the default subject
and month.
"""
subject_code = settings.ACCOUNTING["DEFAULT_CASH_SUBJECT"]
@ -123,7 +123,7 @@ class CashReportView(BaseReportView):
"""Return the accounting records for the cash report.
Returns:
(list[Record]) The accounting records for the cash report
List[Record]: The accounting records for the cash report
"""
period = PeriodParser(self.kwargs["period_spec"])
if self.kwargs["subject_code"] == "0":

8
mia_core/utils.py
View File

@ -37,7 +37,7 @@ class UrlBuilder:
value (str): The parameter value
Returns:
(UrlBuilder): The URL builder itself, with the parameter
UrlBuilder: The URL builder itself, with the parameter
modified.
"""
self.params.append(self.Param(name, value))
@ -50,7 +50,7 @@ class UrlBuilder:
name (str): The parameter name
Returns:
(UrlBuilder): The URL builder itself, with the parameter
UrlBuilder: The URL builder itself, with the parameter
modified.
"""
self.params = [x for x in self.params if x.name != name]
@ -65,7 +65,7 @@ class UrlBuilder:
value (str): The parameter value
Returns:
(UrlBuilder): The URL builder itself, with the parameter
UrlBuilder: The URL builder itself, with the parameter
modified.
"""
return self.del_param(name).add_param(name, value)
@ -98,7 +98,7 @@ class UrlBuilder:
parameter.
Returns:
(str) The string representation of this query
str: The string representation of this query
parameter
"""
return "%s=%s" % (