IssueReports

<pre># IssueReports -*-*-*-*-* Abstract *-*-*-*-*- The IssueReports dataset contains issues acquired from popular projects between 2017-2022.09. The popular projects are the 36 projects with more than 10,000 closed Issues since 2017. This data was collected with PyGitHub and GitHub API v3. We use this dataset in our TOSEM project (the details will be found in the paper). -*-*-*-*- Components -*-*-*-*- IssueReports/ ├─ PROJECT(FIRST)/ │ ├─ _index.csv │ ├─ _repo_raw_data.json │ └─ issue#(FIRST)/ │ │ ├─ issue_raw_data.json │ │ ├─ comments_raw_data.json │ │ ├─ img_urls.csv │ │ └─ vid_urls.csv │ . │ . │ . │ └─ issue#(LAST)/ . . . └─ PROJECT(LAST)/ -*-*-*-*-*- Details -*-*-*-*-*- ## _index.csv This file contains partial information about the Issues included in the project. - repo_org This refers to the name of the project owner. - issue_title This refers to the title of the issue. - issue_number This refers to the identification number of the issue. - issue_state This refers to the state (i.e., open/closed) of the issue. - issue_created_at This refers to the time when the issue was created. - issue_created_by This refers to the user name who created the issue. - issue_closed_at This refers to the time when the issue was closed. - issue_closed_by This refers to the user name who closed the issue. - issue_labels This refers to the labels attached to the issue. - num_of_vid This refers to the number of videos pasted into the issue description. Note that they must be registered in the GitHub database (i.e., https://user-images.githubusercontent.com/). - num_of_img This refers to the number of images pasted into the issue description. Note that they must be registered in the GitHub database (i.e., https://user-images.githubusercontent.com/). - First_comment_time This refers to the time when the first comment on the issue was received. - num_of_comments This refers to the number of comments on the issue. The number of comments in comments_raw_data.json and the number of comments in _index.csv may differ (very rarely). This is because there is a delay in data collection timing between _index.csv and comments_raw_data.json. comments_raw_data.json should be given priority. ## _repo_raw_data.json This file contains APIv3-available information about the project. Details can be found on the PyGitHub documentation site. ## issue_raw_data.json This file contains APIv3-available information about the issue. Details can be found on the PyGitHub documentation site. ## comments_raw_data.json This file contains APIv3-available information about all comments attached to the issue. Details can be found on the PyGitHub documentation site. ## img_urls.csv This file contains links to images pasted into the issue description. ## vid_urls.csv This file contains links to videos pasted into the issue description. -*-*-*-*-* Reference *-*-*-*-*- [PyGitHub](https://github.com/PyGithub/PyGithub) [PyGitHub Document](https://pygithub.readthedocs.io/en/latest/introduction.html) [GitHub REST API](https://docs.github.com/en/rest) </pre># 问题报告数据集（IssueReports） ## 摘要 本数据集收录了2017年至2022年9月期间从热门开源项目中获取的GitHub问题（Issue）。此处的热门项目指自2017年以来已关闭问题数量超过10000个的36个项目。本数据集通过PyGitHub与GitHub API v3采集所得，已应用于我们的TOSEM研究项目（详细信息请参见相关论文）。 ## 数据集组件 数据集目录结构如下： IssueReports/ ├─ 首个项目（PROJECT(FIRST)）/ │ ├─ _index.csv │ ├─ _repo_raw_data.json │ └─ 首个问题（issue#(FIRST)）/ │ ├─ issue_raw_data.json │ ├─ comments_raw_data.json │ ├─ img_urls.csv │ └─ vid_urls.csv │ . │ . │ . │ └─ 末个问题（issue#(LAST)）/ . . . └─ 末个项目（PROJECT(LAST)）/ ## 详细说明 ### _index.csv 该文件存储了对应项目所包含问题的部分信息，各字段含义如下： - `repo_org`：项目所属的组织/所有者名称 - `issue_title`：问题的标题 - `issue_number`：问题的唯一标识编号 - `issue_state`：问题的状态（即已开启/已关闭） - `issue_created_at`：问题的创建时间 - `issue_created_by`：创建该问题的用户名 - `issue_closed_at`：问题的关闭时间 - `issue_closed_by`：关闭该问题的用户名 - `issue_labels`：附着于该问题的标签集合 - `num_of_vid`：粘贴至问题描述中的视频链接数量，且这些视频必须托管于GitHub数据库（即`https://user-images.githubusercontent.com/`） - `num_of_img`：粘贴至问题描述中的图片链接数量，且这些图片必须托管于GitHub数据库（即`https://user-images.githubusercontent.com/`） - `First_comment_time`：该问题收到的第一条评论的时间 - `num_of_comments`：该问题的评论总数。需注意：`comments_raw_data.json`中记录的评论数与`_index.csv`中的数值可能存在极少量差异，这是由于`_index.csv`与`comments_raw_data.json`的数据采集时序存在延迟，因此以`comments_raw_data.json`中的数据为准。 ### _repo_raw_data.json 该文件存储了对应项目通过GitHub API v3可获取的原始信息，详细说明请参见PyGitHub官方文档站点。 ### issue_raw_data.json 该文件存储了对应问题通过GitHub API v3可获取的原始信息，详细说明请参见PyGitHub官方文档站点。 ### comments_raw_data.json 该文件存储了附着于该问题的所有评论的原始信息，详细说明请参见PyGitHub官方文档站点。 ### img_urls.csv 该文件存储了粘贴至问题描述中的图片链接。 ### vid_urls.csv 该文件存储了粘贴至问题描述中的视频链接。 ## 参考资料 [PyGitHub](https://github.com/PyGithub/PyGithub) [PyGitHub官方文档](https://pygithub.readthedocs.io/en/latest/introduction.html) [GitHub REST API](https://docs.github.com/en/rest)