def get_candidate(candidate_id, cycle, election_full): """ 1) By passing parameter "candidate_id" to get candidate data. 2) "cycle" and "election_full" are optional parameters. if no election_full, election_full = true. if no cycle, cycle = the latest item in rounded_election_years. 3) totally call 5-6 endpoints. """ # (1)call candidate/{candidate_id}/history/ under tag:candidate # get rounded_election_years(candidate_election_year). path = "/candidate/" + candidate_id + "/history/" filters = {} filters["per_page"] = 1 candidate = api_caller.load_first_row_data(path, **filters) if candidate is None: raise Http404() # a)Build List: even_election_years for candidate election dropdown list # on candidate profile page. # b)rounded_election_years round up any odd year special election_year # to even number. (ex:2017=>2018) # even_election_years = candidate.get('rounded_election_years') # if cycle = null, set cycle = the last of rounded_election_years. if not cycle: cycle = max(candidate.get("rounded_election_years")) # (2)call candidate/{candidate_id}/history/{cycle} under tag:candidate # (3)call candidate/{candidate_id}/committees/history/{cycle} # under tag:committee. candidate, committees, cycle = api_caller.load_with_nested( "candidate", candidate_id, "committees", cycle=cycle, election_full=election_full, ) result_type = "candidates" duration = election_durations.get(candidate["office"], 2) min_cycle = cycle - duration if election_full else cycle report_type = report_types.get(candidate["office"]) # For JavaScript context_vars = { "cycles": candidate["fec_cycles_in_election"], "name": candidate["name"], "cycle": cycle, "electionFull": election_full, "candidateID": candidate["candidate_id"], } max_cycle = int(cycle) # Check if cycle > latest_fec_cycles_in_election, such as:future candidate. if candidate["fec_cycles_in_election"]: latest_fec_cycles_in_election = max( candidate["fec_cycles_in_election"]) if int(cycle) > latest_fec_cycles_in_election: max_cycle = latest_fec_cycles_in_election # Annotate committees with most recent available cycle aggregate_cycles = (list(range(cycle, cycle - duration, -2)) if election_full else [cycle]) for committee in committees: committee["related_cycle"] = committee["cycle"] # Group the committees by designation committee_groups = groupby(committees, lambda each: each["designation"]) committees_authorized = committee_groups.get( "P", []) + committee_groups.get("A", []) committee_ids = [ committee["committee_id"] for committee in committees_authorized ] # (4)call candidate/{candidate_id}/totals/{cycle} under tag:candidate # Get aggregate totals for the financial summary filters["election_full"] = election_full filters["cycle"] = cycle path = "/candidate/" + candidate_id + "/totals/" aggregate = api_caller.load_first_row_data(path, **filters) if election_full: # (5)if election_full is true, need call # candidate/{candidate_id}/totals/{cycle} second time # for showing on raising and spending tabs # Get most recent 2-year period totals filters["election_full"] = False filters["cycle"] = max_cycle two_year_totals = api_caller.load_first_row_data(path, **filters) else: two_year_totals = aggregate if aggregate: raising_summary = utils.process_raising_data(aggregate) spending_summary = utils.process_spending_data(aggregate) cash_summary = utils.process_cash_data(aggregate) else: raising_summary = None spending_summary = None cash_summary = None # (6)Call /filings?candidate_id=P00003392&form_type=F2 # Get the statements of candidacy statement_of_candidacy = api_caller.load_candidate_statement_of_candidacy( candidate["candidate_id"]) if statement_of_candidacy: statement_of_candidacy["receipt_date"] = format_receipt_date( statement_of_candidacy["receipt_date"]) # Get all the elections elections = sorted( zip(candidate["election_years"], candidate["election_districts"]), key=lambda pair: pair[0], reverse=True, ) # (7)call efile/filings/ under tag:efiling # Check if there are raw_filings for this candidate raw_filing_start_date = utils.three_days_ago() filters["min_receipt_date"] = raw_filing_start_date filters["committee_id"] = candidate["candidate_id"] filters["cycle"] = cycle filters["per_page"] = 100 path = "/efile/" + "/filings/" raw_filings = api_caller.load_endpoint_results(path, **filters) has_raw_filings = True if raw_filings else False # Add message for when a candidate converts their candidate committee to an unauthorized committee current_committee_name = None converted_committee_id = None former_committee_name = None if cycle == 2020 and candidate_to_committee_linkage.get(candidate_id): # Call committee/{committee_id}/history/{cycle}/ filters = {"per_page": 1} path = "/committee/" + candidate_to_committee_linkage.get( candidate_id) + "/history/" + str(cycle) committee = api_caller.load_first_row_data(path, **filters) # Get the converted committee's name, committee ID, and former committee name current_committee_name = committee.get('name') converted_committee_id = committee.get('committee_id') former_committee_name = former_committee_names.get( converted_committee_id) return { "converted_committee_name": current_committee_name, "converted_committee_id": converted_committee_id, "former_committee_name": former_committee_name, "aggregate": aggregate, "aggregate_cycles": aggregate_cycles, "candidate": candidate, "candidate_id": candidate_id, "cash_summary": cash_summary, "committee_groups": committee_groups, "committee_ids": committee_ids, # filings endpoint takes candidate ID value as committee ID arg "committee_id": candidate["candidate_id"], "committees_authorized": committees_authorized, "context_vars": context_vars, "cycle": int(cycle), "cycles": candidate["fec_cycles_in_election"], "district": candidate["district"], "duration": duration, "election_year": cycle, "election_years": candidate.get("rounded_election_years"), "elections": elections, "has_raw_filings": has_raw_filings, "incumbent_challenge_full": candidate["incumbent_challenge_full"], "max_cycle": max_cycle, "min_cycle": min_cycle, "min_receipt_date": raw_filing_start_date, "name": candidate["name"], "office": candidate["office"], "office_full": candidate["office_full"], "party_full": candidate["party_full"], "raising_summary": raising_summary, "report_type": report_type, "result_type": result_type, "show_full_election": election_full, "spending_summary": spending_summary, "state": candidate["state"], "statement_of_candidacy": statement_of_candidacy, "two_year_totals": two_year_totals, "social_image_identifier": "data", }
def candidate(request, candidate_id): # grab url query string parameters cycle = request.GET.get('cycle', None) election_full = request.GET.get('election_full', True) if cycle is not None: cycle = int(cycle) # set election_full to boolean from passed string variable election_full = bool(strtobool(str(election_full))) candidate, committees, cycle = api_caller.load_with_nested( 'candidate', candidate_id, 'committees', cycle=cycle, cycle_key='two_year_period', election_full=election_full, ) if election_full and cycle and cycle not in candidate['election_years']: next_cycle = next( (year for year in sorted(candidate['election_years']) if year > cycle), max(candidate['election_years']), ) # If the next_cycle is odd set it to whatever the cycle value was # and then set election_full to false # This solves an issue with special elections if next_cycle % 2 > 0: next_cycle = cycle election_full = False candidate, committees, cycle = api_caller.load_with_nested( 'candidate', candidate_id, 'committees', cycle=next_cycle, cycle_key='two_year_period', election_full=election_full, ) election_year = next( (year for year in sorted(candidate['election_years']) if year >= cycle), None, ) result_type = 'candidates' duration = election_durations.get(candidate['office'], 2) min_cycle = cycle - duration if election_full else cycle report_type = report_types.get(candidate['office']) # For JavaScript context_vars = { 'cycles': candidate['cycles'], 'name': candidate['name'], 'cycle': cycle, 'electionFull': election_full, 'candidateID': candidate['candidate_id'] } # In the case of when a presidential or senate candidate has filed # for a future year that's beyond the current cycle, # set a max_cycle var to the current cycle we're in # and when calling the API for totals, set election_full to False. # The max_cycle value is also referenced in the templates for setting # the cycle for itemized tables. Because these are only in 2-year chunks, # the cycle should never be beyond the one we're in. cycles = [ cycle for cycle in candidate['cycles'] if cycle <= utils.current_cycle() ] max_cycle = cycle if cycle <= utils.current_cycle( ) else utils.current_cycle() show_full_election = election_full if cycle <= utils.current_cycle( ) else False # Annotate committees with most recent available cycle aggregate_cycles = (list(range(cycle, cycle - duration, -2)) if election_full else [cycle]) for committee in committees: committee['related_cycle'] = (max( cycle for cycle in aggregate_cycles if cycle in committee['cycles']) if election_full else candidate['two_year_period']) # Group the committees by designation committee_groups = groupby(committees, lambda each: each['designation']) committees_authorized = committee_groups.get( 'P', []) + committee_groups.get('A', []) committee_groups = committee_groups committees_authorized = committees_authorized committee_ids = [ committee['committee_id'] for committee in committees_authorized ] # Get aggregate totals for the financial summary # And pass through the data processing utils aggregate = api_caller.load_candidate_totals( candidate['candidate_id'], cycle=max_cycle, election_full=show_full_election, ) if aggregate: raising_summary = utils.process_raising_data(aggregate) spending_summary = utils.process_spending_data(aggregate) cash_summary = utils.process_cash_data(aggregate) else: raising_summary = None spending_summary = None cash_summary = None aggregate = aggregate # Get totals for the last two-year period of a cycle for showing on # raising and spending tabs two_year_totals = api_caller.load_candidate_totals( candidate['candidate_id'], cycle=max_cycle, election_full=False) # Get the statements of candidacy statement_of_candidacy = api_caller.load_candidate_statement_of_candidacy( candidate['candidate_id'], cycle=cycle) if statement_of_candidacy: for statement in statement_of_candidacy: # convert string to python datetime and parse for readable output statement['receipt_date'] = datetime.datetime.strptime( statement['receipt_date'], '%Y-%m-%dT%H:%M:%S') statement['receipt_date'] = statement['receipt_date'].strftime( '%m/%d/%Y') # Get all the elections elections = sorted( zip(candidate['election_years'], candidate['election_districts']), key=lambda pair: pair[0], reverse=True, ) return render( request, 'candidates-single.jinja', { 'name': candidate['name'], 'cycle': int(cycle), 'office': candidate['office'], 'office_full': candidate['office_full'], 'state': candidate['state'], 'district': candidate['district'], 'candidate_id': candidate_id, 'party_full': candidate['party_full'], 'incumbent_challenge_full': candidate['incumbent_challenge_full'], 'election_year': election_year, 'election_years': candidate['election_years'], 'result_type': result_type, 'duration': duration, 'min_cycle': min_cycle, 'report_type': report_type, 'cycles': cycles, 'max_cycle': max_cycle, 'show_full_election': show_full_election, 'committee_groups': committee_groups, 'committees_authorized': committees_authorized, 'committee_ids': committee_ids, 'raising_summary': raising_summary, 'spending_summary': spending_summary, 'cash_summary': cash_summary, 'aggregate': aggregate, 'two_year_totals': two_year_totals, 'statement_of_candidacy': statement_of_candidacy, 'elections': elections, 'candidate': candidate, 'context_vars': context_vars })
def get_candidate(candidate_id, cycle, election_full): """ 1) By passing parameter "candidate_id" to get candidate data. 2) "cycle" and "election_full" are optional parameters. if no election_full, election_full = true. if no cycle, cycle = the latest item in rounded_election_years. 3) totally call 5-6 endpoints. """ # (1) Call candidate/{candidate_id}/history/ under tag:candidate # get rounded_election_years(candidate_election_year). candidate = load_most_recent_candidate(candidate_id) if candidate is None: raise Http404() # if cycle = null, set cycle = the last of rounded_election_years. if not cycle: cycle = max(candidate.get("rounded_election_years")) # (2) Call candidate/{candidate_id}/history/{cycle} under tag:candidate # (3) Call candidate/{candidate_id}/committees/history/{cycle} # under tag:committee. candidate, committees, cycle = api_caller.load_with_nested( "candidate", candidate_id, "committees", cycle=cycle, election_full=election_full, ) result_type = "candidates" duration = election_durations.get(candidate["office"], 2) min_cycle = cycle - duration if election_full else cycle report_type = report_types.get(candidate["office"]) # For JavaScript context_vars = { "cycles": candidate["fec_cycles_in_election"], "name": candidate["name"], "cycle": cycle, "electionFull": election_full, "candidateID": candidate["candidate_id"], } max_cycle = int(cycle) # Check if cycle > latest_fec_cycles_in_election, such as:future candidate. if candidate["fec_cycles_in_election"]: latest_fec_cycles_in_election = max( candidate["fec_cycles_in_election"]) if int(cycle) > latest_fec_cycles_in_election: max_cycle = latest_fec_cycles_in_election # Annotate committees with most recent available cycle aggregate_cycles = (list(range(cycle, cycle - duration, -2)) if election_full else [cycle]) for committee in committees: committee["related_cycle"] = committee["cycle"] # Group the committees by designation committee_groups = groupby(committees, lambda each: each["designation"]) committees_authorized = committee_groups.get( "P", []) + committee_groups.get("A", []) committee_ids = [ committee["committee_id"] for committee in committees_authorized ] # Group the committees by leadership pac (designation=D) committees_d = committee_groups.get("D", []) committees_leadership_pac = [] if committees_d: # The candidate(id=P00009183) returns two rows from api result, # one is pcc converted to D, another is leadership pac committee, # remove the duplicate committees with same committees_id. # example api call: # https://fec-dev-api.app.cloud.gov/v1/candidate/P00009183/committees/history/2020/ len_d_cmte = len(committees_d) committees_leadership_pac.append(committees_d[0]) for i in range(len_d_cmte): if (i + 1) < len_d_cmte and committees_d[i].get( "committee_id") != committees_d[i + 1].get("committee_id"): committees_leadership_pac.append(committees_d[i + 1]) # (4) Call candidate/{candidate_id}/totals/{cycle} under tag:candidate # Get aggregate totals for the financial summary filters = {"election_full": election_full, "cycle": cycle} path = "/candidate/" + candidate_id + "/totals/" aggregate = api_caller.load_first_row_data(path, **filters) if election_full: # (5) if election_full is true, need call # candidate/{candidate_id}/totals/{cycle} second time # for showing on raising and spending tabs # Get most recent 2-year period totals filters = {"election_full": False, "cycle": max_cycle} two_year_totals = api_caller.load_first_row_data(path, **filters) else: two_year_totals = aggregate if aggregate: raising_summary = utils.process_raising_data(aggregate) spending_summary = utils.process_spending_data(aggregate) cash_summary = utils.process_cash_data(aggregate) else: raising_summary = None spending_summary = None cash_summary = None # (6) Call /filings?candidate_id=P00003392&form_type=F2 # Get the statements of candidacy statement_of_candidacy = api_caller.load_candidate_statement_of_candidacy( candidate["candidate_id"]) if statement_of_candidacy: statement_of_candidacy["receipt_date"] = format_receipt_date( statement_of_candidacy["receipt_date"]) # Get all the elections elections = sorted( zip(candidate["election_years"], candidate["election_districts"]), key=lambda pair: pair[0], reverse=True, ) # (7) Call efile/filings/ under tag:efiling # Check if there are raw_filings for this candidate raw_filing_start_date = utils.three_days_ago() filters = { "min_receipt_date": raw_filing_start_date, "committee_id": candidate["candidate_id"], "cycle": cycle, "per_page": 100, } path = "/efile/" + "/filings/" raw_filings = api_caller.load_endpoint_results(path, **filters) has_raw_filings = True if raw_filings else False # Add message for when a candidate converts their candidate committee to an unauthorized committee current_committee_name = None converted_committee_id = None former_committee_name = None # Get the latest committee name, former authorized committee name, and committee ID. # This will be the first item returned in the committees list # If there are no committees, return the normal no results message if len(committees) > 0: if committees[0].get('former_candidate_id'): current_committee_name = committees[0].get('name') converted_committee_id = committees[0].get('committee_id') former_committee_name = committees[0].get('former_committee_name') return { "converted_committee_name": current_committee_name, "converted_committee_id": converted_committee_id, "former_committee_name": former_committee_name, "aggregate": aggregate, "aggregate_cycles": aggregate_cycles, "candidate": candidate, "candidate_id": candidate_id, "cash_summary": cash_summary, "committee_groups": committee_groups, "committee_ids": committee_ids, # filings endpoint takes candidate ID value as committee ID arg "committee_id": candidate["candidate_id"], "committees_authorized": committees_authorized, "committees_leadership_pac": committees_leadership_pac, "context_vars": context_vars, "cycle": int(cycle), "cycles": candidate["fec_cycles_in_election"], "district": candidate["district"], "duration": duration, "election_year": cycle, "election_years": candidate.get("rounded_election_years"), "elections": elections, "has_raw_filings": has_raw_filings, "incumbent_challenge_full": candidate["incumbent_challenge_full"], "max_cycle": max_cycle, "min_cycle": min_cycle, "min_receipt_date": raw_filing_start_date, "name": candidate["name"], "office": candidate["office"], "office_full": candidate["office_full"], "party_full": candidate["party_full"], "raising_summary": raising_summary, "report_type": report_type, "result_type": result_type, "show_full_election": election_full, "spending_summary": spending_summary, "state": candidate["state"], "statement_of_candidacy": statement_of_candidacy, "two_year_totals": two_year_totals, "social_image_identifier": "data", }