Skip to content

Commit 1ee58eb

Browse files
author
Maximilian Karl
committed
update documentation
1 parent 8032561 commit 1ee58eb

File tree

8 files changed

+594
-292
lines changed

8 files changed

+594
-292
lines changed

github2pandas/core.py

Lines changed: 82 additions & 75 deletions
Large diffs are not rendered by default.

github2pandas/git_releases.py

Lines changed: 19 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -15,22 +15,16 @@ class GitReleases(Core):
1515
1616
Attributes
1717
----------
18-
DATA_DIR : str
19-
Git releases directory where all files are saved in.
20-
GIT_RELEASES : str
21-
Pandas table file for git releases data.
22-
FILES : dict
23-
Mappings from data directories to pandas table files.
2418
git_releases_df : DataFrame
2519
Pandas DataFrame object with git releases data.
2620
2721
Methods
2822
-------
29-
__init__(self, github_connection, repo, data_root_dir, request_maximum)
23+
__init__(self, github_connection, repo, data_root_dir, request_maximum = 40000, log_level=logging.INFO)
3024
Initializes git releases object with general information.
3125
generate_pandas_tables(self, check_for_updates=False)
3226
Generates pandas tables for git releases data.
33-
__extract_git_releases_data(git_release)
27+
__extract_git_releases_data(self, git_release)
3428
Extracts general git releases data.
3529
3630
"""
@@ -50,9 +44,9 @@ class Files(Core.Files):
5044
DATA_DIR = "Releases"
5145
GIT_RELEASES = "Releases.p"
5246

53-
def __init__(self, github_connection:Github, repo:GitHubRepository, data_root_dir:Path, request_maximum:int = 40000, log_level:int=logging.INFO) -> None:
47+
def __init__(self, github_connection: Github, repo: GitHubRepository, data_root_dir: Path, request_maximum: int = 40000, log_level: int = logging.INFO) -> None:
5448
"""
55-
__init__(self, github_connection, repo, data_root_dir, request_maximum)
49+
__init__(self, github_connection, repo, data_root_dir, request_maximum = 40000, log_level=logging.INFO)
5650
5751
Initializes git releases object with general information.
5852
@@ -87,11 +81,22 @@ def __init__(self, github_connection:Github, repo:GitHubRepository, data_root_di
8781

8882
@property
8983
def git_releases_df(self) -> pd.DataFrame:
84+
"""
85+
git_releases_df(self)
86+
87+
Pandas DataFrame object with git releases data.
88+
89+
Returns
90+
-------
91+
pd.DataFrame
92+
DataFrame of git releases.
93+
94+
"""
9095
return Core.get_pandas_data_frame(self.current_dir,GitReleases.Files.GIT_RELEASES)
9196

92-
def generate_pandas_tables(self, check_for_updates:bool = False) -> None:
97+
def generate_pandas_tables(self, check_for_updates: bool = False) -> None:
9398
"""
94-
generate_pandas_tables(check_for_updates=False)
99+
generate_pandas_tables(self, check_for_updates=False)
95100
96101
Generates pandas tables for git releases data from a repository.
97102
Checks first if there are any new git releases information in dependence of parameter check_for_updates.
@@ -120,9 +125,9 @@ def generate_pandas_tables(self, check_for_updates:bool = False) -> None:
120125
git_releases_df = pd.DataFrame(git_releases_list)
121126
self.save_pandas_data_frame(GitReleases.Files.GIT_RELEASES, git_releases_df)
122127

123-
def __extract_git_releases_data(self, git_release:GitHubGitRelease) -> dict:
128+
def __extract_git_releases_data(self, git_release: GitHubGitRelease) -> dict:
124129
"""
125-
__extract_git_releases_data(git_release)
130+
__extract_git_releases_data(self, git_release)
126131
127132
Extracts general git releases data from pygithub GitRelease object.
128133
Returns dictionary with the extracted data.

0 commit comments

Comments
 (0)