# -*- coding: utf-8 -*- """Convert IDE TODOs to GitHub issues.""" import os import requests import re import json from time import sleep from io import StringIO from ruamel.yaml import YAML base_url = 'https://api.github.com/repos/' def main(): repo = os.getenv('INPUT_REPO') before = os.getenv('INPUT_BEFORE') sha = os.getenv('INPUT_SHA') comment_marker = os.getenv('INPUT_COMMENT_MARKER') label = os.getenv('INPUT_LABEL') token = os.getenv('INPUT_TOKEN') # Let's compare the last two pushed commits. diff_url = f'{base_url}{repo}/compare/{before}...{sha}' diff_headers = { 'Accept': 'application/vnd.github.v3.diff', 'Authorization': f'token {token}' } # Load a file so we can see what language each file is written in and apply highlighting later. languages_url = 'https://raw.githubusercontent.com/github/linguist/master/lib/linguist/languages.yml' languages_request = requests.get(url=languages_url) languages_dict = None if languages_request.status_code == 200: languages_data = languages_request.text yaml = YAML(typ='safe') languages_dict = yaml.load(languages_data) diff_request = requests.get(url=diff_url, headers=diff_headers) if diff_request.status_code == 200: diff = diff_request.text header_pattern = re.compile(r'(?<=diff\s--git\s).+') hunk_start_pattern = re.compile(r'((?<=^@@\s).+(?=\s@@))') line_num_pattern = re.compile(r'(?<=\+).+') addition_pattern = re.compile(r'(?<=^\+).*') deletion_pattern = re.compile(r'(?<=^-).*') todo_pattern = re.compile(r'(?<=' + label + r'\s).+') comment_pattern = re.compile(r'(?<=' + comment_marker + r'\s).+') new_issues = [] closed_issues = [] lines = [] curr_issue = None # Read the diff file one line at a time, checking for additions/deletions in each hunk. with StringIO(diff) as diff_file: curr_file = None previous_line_was_todo = False line_counter = None for n, line in enumerate(diff_file): # First look for a diff header so we can determine the file the changes relate to. encoded_line = line.encode('utf-8') cleaned_line = encoded_line.rstrip(b'\r\n').decode('utf-8') header_search = header_pattern.search(cleaned_line) if header_search: files = header_search.group(0).split(' ') curr_file = files[1][2:] line_counter = None else: # Look for hunks so we can get the line numbers for the changes. hunk_search = hunk_start_pattern.search(cleaned_line) if hunk_search: if curr_issue: curr_issue['hunk'] = lines new_issues.append(curr_issue) curr_issue = None lines = [] hunk = hunk_search.group(0) line_nums = line_num_pattern.search(hunk).group(0).split(',') hunk_start = int(line_nums[0]) line_counter = hunk_start else: # Look for additions and deletions (specifically TODOs) within each hunk. addition_search = addition_pattern.search(cleaned_line) if addition_search: lines.append(cleaned_line[1:]) addition = addition_search.group(0) todo_search = todo_pattern.search(addition) if todo_search: # Start recording so we can capture multiline TODOs. previous_line_was_todo = True todo = todo_search.group(0) if curr_issue: curr_issue['hunk'] = lines new_issues.append(curr_issue) curr_issue = { 'labels': ['todo'], 'todo': todo, 'body': todo, 'file': curr_file, 'line_num': line_counter } line_counter += 1 continue elif previous_line_was_todo: # Check if this is a continuation from the previous line. comment_search = comment_pattern.search(addition) if comment_search: curr_issue['body'] += '\n\n' + comment_search.group(0).lstrip() line_counter += 1 continue if line_counter is not None: line_counter += 1 else: deletion_search = deletion_pattern.search(cleaned_line) if deletion_search: deletion = deletion_search.group(0) todo_search = todo_pattern.search(deletion) if todo_search: closed_issues.append(todo_search.group(0)) else: lines.append(cleaned_line[1:]) if previous_line_was_todo: # Check if this is a continuation from the previous line. comment_search = comment_pattern.search(cleaned_line) if comment_search: curr_issue['body'] += '\n\n' + comment_search.group(0).lstrip() line_counter += 1 continue if line_counter is not None: line_counter += 1 if previous_line_was_todo: previous_line_was_todo = False if curr_issue: curr_issue['hunk'] = lines new_issues.append(curr_issue) # Create new issues for any newly added TODOs. issues_url = f'{base_url}{repo}/issues' issue_headers = { 'Content-Type': 'application/json', 'Authorization': f'token {token}' } for i, issue in enumerate(new_issues): title = issue['todo'] # Truncate the title if it's longer than 50 chars. if len(title) > 50: title = title[:50] + '...' file = issue['file'] line = issue['line_num'] body = issue['body'] + '\n\n' + f'https://github.com/{repo}/blob/{sha}/{file}#L{line}' if 'hunk' in issue: hunk = issue['hunk'] hunk.pop(0) file_name, extension = os.path.splitext(os.path.basename(file)) markdown_language = None if languages_dict: for language in languages_dict: if ('extensions' in languages_dict[language] and extension in languages_dict[language]['extensions']): markdown_language = languages_dict[language]['ace_mode'] if markdown_language: body += '\n\n' + '```' + markdown_language + '\n' + '\n'.join(hunk) + '```' else: body += '\n\n' + '```' + '\n'.join(hunk) + '```' new_issue_body = {'title': title, 'body': body, 'labels': ['todo']} new_issue_request = requests.post(url=issues_url, headers=issue_headers, data=json.dumps(new_issue_body)) print(f'Creating issue {i + 1} of {len(new_issues)}') if new_issue_request.status_code == 201: print('Issue created') else: print('Issue could not be created') # Don't add too many issues too quickly. sleep(1) if len(closed_issues) > 0: # Get the list of current issues. list_issues_request = requests.get(issues_url, headers=issue_headers) if list_issues_request.status_code == 200: current_issues = list_issues_request.json() for i, closed_issue in enumerate(closed_issues): title = closed_issue if len(title) > 50: title = closed_issue[:50] + '...' # Compare the title of each closed issue with each issue in the issues list. for current_issue in current_issues: if current_issue['title'] == title: # The titles match, so we will try and close the issue. issue_number = current_issue['number'] update_issue_url = f'{base_url}{repo}/issues/{issue_number}' body = {'state': 'closed'} requests.patch(update_issue_url, headers=issue_headers, data=json.dumps(body)) issue_comment_url = f'{base_url}{repo}/issues/{issue_number}/comments' body = {'body': f'Closed in {sha}'} update_issue_request = requests.post(issue_comment_url, headers=issue_headers, data=json.dumps(body)) print(f'Closing issue {i + 1} of {len(closed_issues)}') if update_issue_request.status_code == 201: print('Issue closed') else: print('Issue could not be closed') # Don't update too many issues too quickly. sleep(1) if __name__ == "__main__": main()