whitespace fuckshit
This commit is contained in:
parent
347f869d2d
commit
61ea239cb0
GPG Key ID:
EF4B922DB85DC9DE
248
nanpa/client.py
248
nanpa/client.py
@ -1,5 +1,6 @@
|
|||||||
#!/usr/bin/env python3
|
#!/usr/bin/env python3
|
||||||
# North American Numbering Plan Administration (NANPA) API Client - Developed by acidvegas in Python (https://git.acid.vegas/nanpa)
|
# North American Numbering Plan Administration (NANPA) API Client - Developed by acidvegas in Python (https://git.acid.vegas/nanpa)
|
||||||
|
# nanpa/client.py
|
||||||
|
|
||||||
import json
|
import json
|
||||||
import logging
|
import logging
|
||||||
@ -9,210 +10,211 @@ import urllib.request
|
|||||||
|
|
||||||
|
|
||||||
class NanpaAPI:
|
class NanpaAPI:
|
||||||
def __init__(self):
|
def __init__(self):
|
||||||
'''Initialize the NANPA API client.'''
|
'''Initialize the NANPA API client.'''
|
||||||
|
|
||||||
self.base_url = 'https://api.nanpa.com/reports/public'
|
self.base_url = 'https://api.nanpa.com/reports/public'
|
||||||
|
|
||||||
def _make_request(self, endpoint: str, params: dict = None) -> dict:
|
|
||||||
'''
|
|
||||||
Make a request to the NANPA API.
|
|
||||||
|
|
||||||
:param endpoint: API endpoint to call
|
def _make_request(self, endpoint: str, params: dict = None) -> dict:
|
||||||
:param params: Optional query parameters
|
'''
|
||||||
'''
|
Make a request to the NANPA API.
|
||||||
|
|
||||||
url = f'{self.base_url}/{endpoint}'
|
:param endpoint: API endpoint to call
|
||||||
|
:param params: Optional query parameters
|
||||||
|
'''
|
||||||
|
|
||||||
if params:
|
url = f'{self.base_url}/{endpoint}'
|
||||||
url += '?' + urllib.parse.urlencode(params)
|
|
||||||
|
|
||||||
try:
|
if params:
|
||||||
with urllib.request.urlopen(url) as response:
|
url += '?' + urllib.parse.urlencode(params)
|
||||||
return json.loads(response.read().decode())
|
|
||||||
except urllib.error.URLError as e:
|
|
||||||
logging.error(f'Failed to make request to {url}: {e}')
|
|
||||||
return None
|
|
||||||
|
|
||||||
|
try:
|
||||||
|
with urllib.request.urlopen(url) as response:
|
||||||
|
return json.loads(response.read().decode())
|
||||||
|
except urllib.error.URLError as e:
|
||||||
|
logging.error(f'Failed to make request to {url}: {e}')
|
||||||
|
return None
|
||||||
|
|
||||||
def get_9yy_codes(self) -> dict:
|
|
||||||
'''Get 9YY specialty codes.'''
|
|
||||||
|
|
||||||
return self._make_request('specialityResources/9yy/codes')
|
def get_9yy_codes(self) -> dict:
|
||||||
|
'''Get 9YY specialty codes.'''
|
||||||
|
|
||||||
|
return self._make_request('specialityResources/9yy/codes')
|
||||||
|
|
||||||
def get_area_code_info(self, npa: str) -> dict:
|
|
||||||
'''
|
|
||||||
Get detailed information about a specific area code.
|
|
||||||
|
|
||||||
:param npa: Area code to lookup
|
def get_area_code_info(self, npa: str) -> dict:
|
||||||
'''
|
'''
|
||||||
|
Get detailed information about a specific area code.
|
||||||
|
|
||||||
params = {'npa': npa}
|
:param npa: Area code to lookup
|
||||||
|
'''
|
||||||
|
|
||||||
return self._make_request('npa/areaCodeListing', params)
|
params = {'npa': npa}
|
||||||
|
|
||||||
|
return self._make_request('npa/areaCodeListing', params)
|
||||||
|
|
||||||
def get_area_codes_by_state(self, state: str) -> dict:
|
|
||||||
'''
|
|
||||||
Get area codes for a specific state.
|
|
||||||
|
|
||||||
:param state: Two-letter state code
|
def get_area_codes_by_state(self, state: str) -> dict:
|
||||||
'''
|
'''
|
||||||
|
Get area codes for a specific state.
|
||||||
|
|
||||||
params = {'states': state, 'isExternal': 'false'}
|
:param state: Two-letter state code
|
||||||
|
'''
|
||||||
|
|
||||||
return self._make_request('code/getNpasForStates', params)
|
params = {'states': state, 'isExternal': 'false'}
|
||||||
|
|
||||||
|
return self._make_request('code/getNpasForStates', params)
|
||||||
|
|
||||||
def get_co_code_forecast(self, state: str, npa: str) -> dict:
|
|
||||||
'''
|
|
||||||
Get CO code forecast information.
|
|
||||||
|
|
||||||
:param state: Two-letter state code
|
def get_co_code_forecast(self, state: str, npa: str) -> dict:
|
||||||
:param npa: Area code
|
'''
|
||||||
|
Get CO code forecast information.
|
||||||
|
|
||||||
'''
|
:param state: Two-letter state code
|
||||||
|
:param npa: Area code
|
||||||
|
|
||||||
params = {'state': state, 'npa': npa}
|
'''
|
||||||
|
|
||||||
return self._make_request('tbco/coCodeForecast', params)
|
params = {'state': state, 'npa': npa}
|
||||||
|
|
||||||
|
return self._make_request('tbco/coCodeForecast', params)
|
||||||
|
|
||||||
def get_current_pool_tracking(self, state: str, npa: str) -> dict:
|
|
||||||
'''
|
|
||||||
Get current pool tracking information.
|
|
||||||
|
|
||||||
:param state: Two-letter state code
|
def get_current_pool_tracking(self, state: str, npa: str) -> dict:
|
||||||
:param npa: Area code
|
'''
|
||||||
'''
|
Get current pool tracking information.
|
||||||
|
|
||||||
params = {'state': state, 'npa': npa}
|
:param state: Two-letter state code
|
||||||
|
:param npa: Area code
|
||||||
|
'''
|
||||||
|
|
||||||
return self._make_request('tbco/currentPoolTracking', params)
|
params = {'state': state, 'npa': npa}
|
||||||
|
|
||||||
|
return self._make_request('tbco/currentPoolTracking', params)
|
||||||
|
|
||||||
def get_lrn_forecast(self, state: str, npa: str) -> dict:
|
|
||||||
'''
|
|
||||||
Get LRN forecast information.
|
|
||||||
|
|
||||||
:param state: Two-letter state code
|
def get_lrn_forecast(self, state: str, npa: str) -> dict:
|
||||||
:param npa: Area code
|
'''
|
||||||
'''
|
Get LRN forecast information.
|
||||||
|
|
||||||
params = {'state': state, 'npa': npa}
|
:param state: Two-letter state code
|
||||||
|
:param npa: Area code
|
||||||
|
'''
|
||||||
|
|
||||||
return self._make_request('tbco/lrnForecast', params)
|
params = {'state': state, 'npa': npa}
|
||||||
|
|
||||||
|
return self._make_request('tbco/lrnForecast', params)
|
||||||
|
|
||||||
def get_pooling_forecast(self, state: str, npa: str) -> dict:
|
|
||||||
'''
|
|
||||||
Get pooling forecast information.
|
|
||||||
|
|
||||||
:param state: Two-letter state code
|
def get_pooling_forecast(self, state: str, npa: str) -> dict:
|
||||||
:param npa: Area code
|
'''
|
||||||
'''
|
Get pooling forecast information.
|
||||||
|
|
||||||
params = {'state': state, 'npa': npa}
|
:param state: Two-letter state code
|
||||||
|
:param npa: Area code
|
||||||
|
'''
|
||||||
|
|
||||||
return self._make_request('tbco/poolingForecast', params)
|
params = {'state': state, 'npa': npa}
|
||||||
|
|
||||||
|
return self._make_request('tbco/poolingForecast', params)
|
||||||
|
|
||||||
def get_pstn_activation(self, state: str) -> dict:
|
|
||||||
'''
|
|
||||||
Get PSTN activation information.
|
|
||||||
|
|
||||||
:param state: Two-letter state code
|
def get_pstn_activation(self, state: str) -> dict:
|
||||||
'''
|
'''
|
||||||
|
Get PSTN activation information.
|
||||||
|
|
||||||
params = {'state': state}
|
:param state: Two-letter state code
|
||||||
|
'''
|
||||||
|
|
||||||
return self._make_request('tbco/pstnActivation', params)
|
params = {'state': state}
|
||||||
|
|
||||||
|
return self._make_request('tbco/pstnActivation', params)
|
||||||
|
|
||||||
def get_rate_center_changes(self, start_date: str, end_date: str) -> dict:
|
|
||||||
'''
|
|
||||||
Get rate center changes between two dates.
|
|
||||||
|
|
||||||
:param start_date: Start date in format YYYY-MM-DDT00:00:00.000-05:00
|
def get_rate_center_changes(self, start_date: str, end_date: str) -> dict:
|
||||||
:param end_date: End date in format YYYY-MM-DDT23:59:59.999-05:00
|
'''
|
||||||
'''
|
Get rate center changes between two dates.
|
||||||
|
|
||||||
params = {'startDate': start_date, 'endDate': end_date}
|
:param start_date: Start date in format YYYY-MM-DDT00:00:00.000-05:00
|
||||||
|
:param end_date: End date in format YYYY-MM-DDT23:59:59.999-05:00
|
||||||
|
'''
|
||||||
|
|
||||||
return self._make_request('npa/rateCenterChanges', params)
|
params = {'startDate': start_date, 'endDate': end_date}
|
||||||
|
|
||||||
|
return self._make_request('npa/rateCenterChanges', params)
|
||||||
|
|
||||||
def get_rate_centers(self, state: str) -> dict:
|
|
||||||
'''
|
|
||||||
Get rate centers for a specific state.
|
|
||||||
|
|
||||||
:param state: Two-letter state code
|
def get_rate_centers(self, state: str) -> dict:
|
||||||
'''
|
'''
|
||||||
|
Get rate centers for a specific state.
|
||||||
|
|
||||||
params = {'state': state}
|
:param state: Two-letter state code
|
||||||
|
'''
|
||||||
|
|
||||||
return self._make_request('npa/rateCenters', params)
|
params = {'state': state}
|
||||||
|
|
||||||
|
return self._make_request('npa/rateCenters', params)
|
||||||
|
|
||||||
def get_specialty_codes_aging(self) -> dict:
|
|
||||||
'''Get aging 5XX specialty codes.'''
|
|
||||||
|
|
||||||
return self._make_request('specialityResources/5xx/aging')
|
def get_specialty_codes_aging(self) -> dict:
|
||||||
|
'''Get aging 5XX specialty codes.'''
|
||||||
|
|
||||||
|
return self._make_request('specialityResources/5xx/aging')
|
||||||
|
|
||||||
def get_specialty_codes_assigned(self) -> dict:
|
|
||||||
'''Get assigned 5XX specialty codes.'''
|
|
||||||
|
|
||||||
return self._make_request('specialityResources/5xx/assigned')
|
def get_specialty_codes_assigned(self) -> dict:
|
||||||
|
'''Get assigned 5XX specialty codes.'''
|
||||||
|
|
||||||
|
return self._make_request('specialityResources/5xx/assigned')
|
||||||
|
|
||||||
def get_specialty_codes_available(self, code_type: str = '5xx') -> dict:
|
|
||||||
'''
|
|
||||||
Get available specialty codes.
|
|
||||||
|
|
||||||
:param code_type: Code type ('5xx' or '9yy')
|
def get_specialty_codes_available(self, code_type: str = '5xx') -> dict:
|
||||||
'''
|
'''
|
||||||
|
Get available specialty codes.
|
||||||
|
|
||||||
return self._make_request(f'specialityResources/{code_type}/available')
|
:param code_type: Code type ('5xx' or '9yy')
|
||||||
|
'''
|
||||||
|
|
||||||
|
return self._make_request(f'specialityResources/{code_type}/available')
|
||||||
|
|
||||||
def get_states(self) -> dict:
|
|
||||||
'''Get all NANPA states and territories.'''
|
|
||||||
|
|
||||||
return self._make_request('nanpaStates')
|
def get_states(self) -> dict:
|
||||||
|
'''Get all NANPA states and territories.'''
|
||||||
|
|
||||||
|
return self._make_request('nanpaStates')
|
||||||
|
|
||||||
def get_thousands_blocks(self, state: str, npa: str, report_type: str = 'AS') -> dict:
|
|
||||||
'''
|
|
||||||
Get thousands blocks information.
|
|
||||||
|
|
||||||
:param state: Two-letter state code
|
def get_thousands_blocks(self, state: str, npa: str, report_type: str = 'AS') -> dict:
|
||||||
:param npa: Area code
|
'''
|
||||||
:param report_type: Report type (default: AS)
|
Get thousands blocks information.
|
||||||
'''
|
|
||||||
|
|
||||||
params = {'state': state, 'npa': npa, 'reportType': report_type}
|
:param state: Two-letter state code
|
||||||
|
:param npa: Area code
|
||||||
|
:param report_type: Report type (default: AS)
|
||||||
|
'''
|
||||||
|
|
||||||
return self._make_request('tbco/thousandsBlocks', params)
|
params = {'state': state, 'npa': npa, 'reportType': report_type}
|
||||||
|
|
||||||
|
return self._make_request('tbco/thousandsBlocks', params)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
def main():
|
def main():
|
||||||
'''Example usage of the NANPA API client.'''
|
'''Example usage of the NANPA API client.'''
|
||||||
|
|
||||||
client = NanpaAPI()
|
client = NanpaAPI()
|
||||||
|
|
||||||
# Example API calls
|
# Example API calls
|
||||||
states = client.get_states()
|
states = client.get_states()
|
||||||
logging.info(f'States: {json.dumps(states, indent=2)}')
|
logging.info(f'States: {json.dumps(states, indent=2)}')
|
||||||
|
|
||||||
fl_codes = client.get_area_codes_by_state('FL')
|
fl_codes = client.get_area_codes_by_state('FL')
|
||||||
logging.info(f'Florida area codes: {json.dumps(fl_codes, indent=2)}')
|
logging.info(f'Florida area codes: {json.dumps(fl_codes, indent=2)}')
|
||||||
|
|
||||||
area_info = client.get_area_code_info('301')
|
area_info = client.get_area_code_info('301')
|
||||||
logging.info(f'301 area code info: {json.dumps(area_info, indent=2)}')
|
logging.info(f'301 area code info: {json.dumps(area_info, indent=2)}')
|
||||||
|
|
||||||
|
|
||||||
if __name__ == '__main__':
|
if __name__ == '__main__':
|
||||||
main()
|
main()
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user