.*?![](\"(.*?)\".*?class=\"name\".*?title=\"(.*?)\")
.*?class=\"star\">.*?class=\"tuijian\">(.*?).*?class=\"publisher_info\">.*?target=\"_blank\">(.*?).*?class=\"biaosheng\">.*?(.*?).*?(.*?).*?', re.S)\n items = re.findall(pattern, html)\n\n for item in items:\n yield {\n 'range': item[0],\n 'image': item[1],\n 'title': item[2],\n 'recommend': item[3],\n 'author': item[4],\n 'times': item[5],\n 'price': item[6]\n }\n\n\ndef write_item_to_file(item):\n print('开始写入数据 ====> ' + str(item))\n with open('book.txt', 'a', encoding='UTF-8') as f:\n f.write(json.dumps(item, ensure_ascii=False) + '\\n')\n\n\ndef main(page):\n url = 'http://bang.dangdang.com/books/fivestars/01.00.00.00.00.00-recent30-0-0-1-' + str(page)\n html = request_dandan(url)\n items = parse_result(html) # 解析过滤我们想要的信息\n for item in items:\n write_item_to_file(item)\n\n\nif __name__ == \"__main__\":\n for i in range(1, 26):\n main(i)\n"
},
{
"path": "douban_top_250_books.py",
"content": "import requests\nfrom bs4 import BeautifulSoup\nimport xlwt\n\n\ndef request_douban(url):\nheaders = {\n 'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) '\n 'Chrome/88.0.4324.146 Safari/537.36',\n }\n\n try:\n response = requests.get(url=url, headers=headers)\n if response.status_code == 200:\n return response.text\n except requests.RequestException:\n return None\n\n\nbook = xlwt.Workbook(encoding='utf-8', style_compression=0)\n\nsheet = book.add_sheet('豆瓣电影Top250', cell_overwrite_ok=True)\nsheet.write(0, 0, '名称')\nsheet.write(0, 1, '图片')\nsheet.write(0, 2, '排名')\nsheet.write(0, 3, '评分')\nsheet.write(0, 4, '作者')\nsheet.write(0, 5, '简介')\n\nn = 1\n\n\ndef save_to_excel(soup):\n list = soup.find(class_='grid_view').find_all('li')\n\n for item in list:\n item_name = item.find(class_='title').string\n item_img = item.find('a').find('img').get('src')\n item_index = item.find(class_='').string\n item_score = item.find(class_='rating_num').string\n item_author = item.find('p').text\n if item.find(class_='inq') is not None:\n item_intr = item.find(class_='inq').string\n else:\n item_intr = 'NOT AVAILABLE' \n\n # print('爬取电影：' + item_index + ' | ' + item_name +' | ' + item_img +' | ' + item_score +' | ' + item_author +' | ' + item_intr )\n print('爬取电影：' + item_index + ' | ' + item_name + ' | ' + item_score + ' | ' + item_intr)\n\n global n\n\n sheet.write(n, 0, item_name)\n sheet.write(n, 1, item_img)\n sheet.write(n, 2, item_index)\n sheet.write(n, 3, item_score)\n sheet.write(n, 4, item_author)\n sheet.write(n, 5, item_intr)\n\n n = n + 1\n\n\ndef main(page):\n url = 'https://movie.douban.com/top250?start=' + str(page * 25) + '&filter='\n html = request_douban(url)\n soup = BeautifulSoup(html, 'lxml')\n save_to_excel(soup)\n\n\nif __name__ == '__main__':\n\n for i in range(0, 10):\n main(i)\n\nbook.save(u'豆瓣最受欢迎的250部电影.xlsx')\n"
},
{
"path": "douban_top_250_books_mul_process.py",
"content": "import requests\nfrom bs4 import BeautifulSoup\nimport xlwt\nimport multiprocessing\nimport time\nimport sys\n\ndef request_douban(url):\n try:\n response = requests.get(url,headers={'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64)'})\n if response.status_code == 200:\n return response.text\n except requests.RequestException:\n return None\n\ndef main(url):\n sys.setrecursionlimit(1000000)\n data = []\n html = request_douban(url)\n # soup = BeautifulSoup(html, 'lxml')\n soup = BeautifulSoup(html, 'html.parser')\n list = soup.find(class_='grid_view').find_all('li')\n for item in list:\n item_name = item.find(class_='title').string\n item_img = item.find('a').find('img').get('src')\n item_index = item.find(class_='').string\n item_score = item.find(class_='rating_num').string\n item_author = item.find('p').text\n item_intr = ''\n if (item.find(class_='inq') != None):\n item_intr = item.find(class_='inq').string\n print('爬取电影：' + item_index + ' | ' + item_name + ' | ' + item_score + ' | ' + item_intr)\n item = {\n 'item_index': item_index,\n 'item_name': item_name,\n 'item_score': item_score,\n 'item_intr': item_intr,\n 'item_img': item_img,\n 'item_author': item_author\n }\n data.append(item)\n return data\n \nif __name__ == '__main__':\n startTime = time.time()\n data = []\n urls = []\n pool = multiprocessing.Pool(multiprocessing.cpu_count()-1)\n for i in range(0, 10):\n url = 'https://movie.douban.com/top250?start=' + str(i * 25) + '&filter='\n urls.append(url)\n pool.map(main, urls)\n for pageItem in pool.map(main, urls):\n data.extend(pageItem)\n book = xlwt.Workbook(encoding='utf-8', style_compression=0)\n sheet = book.add_sheet('豆瓣电影Top250-test', cell_overwrite_ok=True)\n sheet.write(0, 0, '名称')\n sheet.write(0, 1, '图片')\n sheet.write(0, 2, '排名')\n sheet.write(0, 3, '评分')\n sheet.write(0, 4, '作者')\n sheet.write(0, 5, '简介')\n for index,item in enumerate(data):\n sheet.write(index+1, 0, item['item_name'])\n sheet.write(index+1, 1, item['item_img'])\n sheet.write(index+1, 2, item['item_index'])\n sheet.write(index+1, 3, item['item_score'])\n sheet.write(index+1, 4, item['item_author'])\n sheet.write(index+1, 5, item['item_intr'])\n book.save(u'豆瓣最受欢迎的250部电影-mul.xlsx')\n\n endTime = time.time()\n dtime = endTime - startTime\n print(\"程序运行时间：%s s\" % dtime) # 4.036666631698608 s"
},
{
"path": "fuck_bilibili_captcha.py",
"content": "import time\nimport requests\nfrom PIL import Image\nfrom selenium import webdriver\nfrom selenium.webdriver import ActionChains\nfrom selenium.webdriver.common.by import By\nfrom selenium.webdriver.support.ui import WebDriverWait\nfrom selenium.webdriver.support import expected_conditions as EC\nfrom bs4 import BeautifulSoup\nimport re\nfrom io import BytesIO\n\ndriver = webdriver.Chrome('/usr/lib/chromium-browser/chromedriver')\nWAIT = WebDriverWait(driver, 10)\nurl = 'https://passport.bilibili.com/login'\n\n\ndef mergy_Image(image_file, location_list):\n \"\"\"\n 将原始图片进行合成\n :param image_file: 图片文件\n :param location_list: 图片位置\n :return: 合成新的图片\n \"\"\"\n\n # 存放上下部分的各个小块\n upper_half_list = []\n down_half_list = []\n\n image = Image.open(image_file)\n\n # 通过 y 的位置来判断是上半部分还是下半部分,然后切割\n for location in location_list:\n if location['y'] == -58:\n # 间距为10，y：58-116\n im = image.crop((abs(location['x']), 58, abs(location['x'])+10, 116))\n upper_half_list.append(im)\n if location['y'] == 0:\n # 间距为10，y：0-58\n im = image.crop((abs(location['x']), 0, abs(location['x']) + 10, 58))\n down_half_list.append(im)\n\n # 创建一张大小一样的图片\n new_image = Image.new('RGB', (260, 116))\n\n # 粘贴好上半部分 y坐标是从上到下（0-116）\n offset = 0\n for im in upper_half_list:\n new_image.paste(im, (offset, 0))\n offset += 10\n\n # 粘贴好下半部分\n offset = 0\n for im in down_half_list:\n new_image.paste(im, (offset, 58))\n offset += 10\n\n return new_image\n\n\ndef get_distance(bg_Image, fullbg_Image):\n\n # 阈值\n threshold = 200\n\n print(bg_Image.size[0])\n print(bg_Image.size[1])\n\n\n for i in range(60, bg_Image.size[0]):\n for j in range(bg_Image.size[1]):\n bg_pix = bg_Image.getpixel((i, j))\n fullbg_pix = fullbg_Image.getpixel((i, j))\n r = abs(bg_pix[0] - fullbg_pix[0])\n g = abs(bg_pix[1] - fullbg_pix[1])\n b = abs(bg_pix[2] - fullbg_pix[2])\n\n if r + g + b > threshold:\n return i\n\n\n\n\ndef get_path(distance):\n result = []\n current = 0\n mid = distance * 4 / 5\n t = 0.2\n v = 0\n while current < (distance - 10):\n if current < mid:\n a = 2\n else:\n a = -3\n v0 = v\n v = v0 + a * t\n s = v0 * t + 0.5 * a * t * t\n current += s\n result.append(round(s))\n return result\n\n\ndef start_drag(driver, distance):\n\n # 被妖怪吃掉了\n # knob = WAIT.until(EC.presence_of_element_located((By.CSS_SELECTOR, \"#gc-box > div > div.gt_slider > div.gt_slider_knob.gt_show\")))\n # ActionChains(driver).click_and_hold(knob).perform()\n # ActionChains(driver).move_by_offset(xoffset=distance, yoffset=0.1).perform()\n # time.sleep(0.5)\n # ActionChains(driver).release(knob).perform()\n\n # 被妖怪吃掉了\n # ActionChains(driver).drag_and_drop_by_offset(knob, distance-10, 0).perform()\n\n knob = WAIT.until(EC.presence_of_element_located((By.CSS_SELECTOR, \"#gc-box > div > div.gt_slider > div.gt_slider_knob.gt_show\")))\n result = get_path(distance)\n ActionChains(driver).click_and_hold(knob).perform()\n\n for x in result:\n ActionChains(driver).move_by_offset(xoffset=x, yoffset=0).perform()\n\n time.sleep(0.5)\n ActionChains(driver).release(knob).perform()\n\n\ndef recognize_code(driver):\n \"\"\"\n 识别滑动验证码\n :param driver: selenium驱动\n :return:\n \"\"\"\n\n bs = BeautifulSoup(driver.page_source,'lxml')\n # 找到背景图片和缺口图片的div\n bg_div = bs.find_all(class_='gt_cut_bg_slice')\n fullbg_div = bs.find_all(class_='gt_cut_fullbg_slice')\n\n # 获取缺口背景图片url\n bg_url = re.findall('background-image:\\surl\\(\"(.*?)\"\\)',bg_div[0].get('style'))\n # 获取背景图片url\n fullbg_url = re.findall('background-image:\\surl\\(\"(.*?)\"\\)',fullbg_div[0].get('style'))\n\n # 存放每个合成缺口背景图片的位置\n bg_location_list = []\n # 存放每个合成背景图片的位置\n fullbg_location_list = []\n\n for bg in bg_div:\n location = {}\n location['x'] = int(re.findall('background-position:\\s(.*?)px\\s(.*?)px;', bg.get('style'))[0][0])\n location['y'] = int(re.findall('background-position:\\s(.*?)px\\s(.*?)px;', bg.get('style'))[0][1])\n bg_location_list.append(location)\n\n for fullbg in fullbg_div:\n location = {}\n location['x'] = int(re.findall('background-position:\\s(.*?)px\\s(.*?)px;', fullbg.get('style'))[0][0])\n location['y'] = int(re.findall('background-position:\\s(.*?)px\\s(.*?)px;', fullbg.get('style'))[0][1])\n fullbg_location_list.append(location)\n\n print(bg_location_list)\n print(fullbg_location_list)\n\n # 将图片格式存为 jpg 格式\n bg_url = bg_url[0].replace('webp', 'jpg')\n fullbg_url = fullbg_url[0].replace('webp', 'jpg')\n # print(bg_url)\n # print(fullbg_url)\n\n # 下载图片\n bg_image = requests.get(bg_url).content\n fullbg_image = requests.get(fullbg_url).content\n print('完成图片下载')\n\n # 写入图片\n bg_image_file = BytesIO(bg_image)\n fullbg_image_file = BytesIO(fullbg_image)\n\n # 合成图片\n bg_Image = mergy_Image(bg_image_file, bg_location_list)\n fullbg_Image = mergy_Image(fullbg_image_file, fullbg_location_list)\n # bg_Image.show()\n # fullbg_Image.show()\n\n # 计算缺口偏移距离\n distance = get_distance(bg_Image, fullbg_Image)\n print('得到距离：%s' % str(distance))\n\n start_drag(driver, distance)\n\n\n\n\nif __name__ == '__main__':\n\n # 获取滑块按钮\n driver.get(url)\n slider = WAIT.until(EC.element_to_be_clickable(\n (By.CSS_SELECTOR, \"#gc-box > div > div.gt_slider > div.gt_slider_knob.gt_show\")))\n\n recognize_code(driver)\n\n\n # driver.close()\n\n"
},
{
"path": "ikun_basketball.py",
"content": "# coding=utf-8\n\n# 最新版的selenium(4.x.x)已经不支持PhantomJS。如要用PhantomJS，可用旧版本selenium。如pip install selenium==3.8.0。\nfrom selenium import webdriver\nfrom selenium.common.exceptions import TimeoutException\nfrom selenium.webdriver.common.by import By\nfrom selenium.webdriver.support.ui import WebDriverWait\nfrom selenium.webdriver.support import expected_conditions as EC\nfrom bs4 import BeautifulSoup\nimport xlwt\n\n# browser = webdriver.PhantomJS()\nbrowser = webdriver.Chrome()\nWAIT = WebDriverWait(browser, 10)\nbrowser.set_window_size(1400, 900)\n\nbook = xlwt.Workbook(encoding='utf-8', style_compression=0)\n\nsheet = book.add_sheet('蔡徐坤篮球', cell_overwrite_ok=True)\nsheet.write(0, 0, '名称')\nsheet.write(0, 1, '地址')\nsheet.write(0, 2, '描述')\nsheet.write(0, 3, '观看次数')\nsheet.write(0, 4, '弹幕数')\nsheet.write(0, 5, '发布时间')\n\nn = 1\n\n\ndef search():\n try:\n print('开始访问b站....')\n browser.get(\"https://www.bilibili.com/\")\n\n # 被那个破登录遮住了\n # index = WAIT.until(EC.element_to_be_clickable((By.CSS_SELECTOR, \"#primary_menu > ul > li.home > a\")))\n # index.click()\n\n input = WAIT.until(EC.presence_of_element_located((By.CSS_SELECTOR, \"#nav_searchform > input\")))\n submit = WAIT.until(EC.element_to_be_clickable(\n (By.XPATH, '/html/body/div[2]/div/div[1]/div[1]/div/div[2]/div/form/div/button')))\n\n input.send_keys('蔡徐坤 篮球')\n submit.click()\n\n # 跳转到新的窗口\n print('跳转到新窗口')\n all_h = browser.window_handles\n browser.switch_to.window(all_h[1])\n get_source()\n\n total = WAIT.until(EC.presence_of_element_located((By.CSS_SELECTOR,\n \"#all-list > div.flow-loader > div.page-wrap > div > ul > li.page-item.last > button\")))\n return int(total.text)\n except TimeoutException:\n return search()\n\n\ndef next_page(page_num):\n try:\n print('获取下一页数据')\n next_btn = WAIT.until(EC.element_to_be_clickable((By.CSS_SELECTOR,\n '#all-list > div.flow-loader > div.page-wrap > div > ul > li.page-item.next > button')))\n next_btn.click()\n WAIT.until(EC.text_to_be_present_in_element((By.CSS_SELECTOR,\n '#all-list > div.flow-loader > div.page-wrap > div > ul > li.page-item.active > button'),\n str(page_num)))\n get_source()\n except TimeoutException:\n browser.refresh()\n return next_page(page_num)\n\n\ndef save_to_excel(soup):\n list = soup.find(class_='video-list clearfix').find_all(class_='video-item matrix')\n\n for item in list:\n item_title = item.find('a').get('title')\n item_link = item.find('a').get('href')\n item_dec = item.find(class_='des hide').text\n item_view = item.find(class_='so-icon watch-num').text\n item_biubiu = item.find(class_='so-icon hide').text\n item_date = item.find(class_='so-icon time').text\n\n print('爬取：' + item_title)\n\n global n\n\n sheet.write(n, 0, item_title)\n sheet.write(n, 1, item_link)\n sheet.write(n, 2, item_dec)\n sheet.write(n, 3, item_view)\n sheet.write(n, 4, item_biubiu)\n sheet.write(n, 5, item_date)\n\n n = n + 1\n\n\ndef get_source():\n WAIT.until(EC.presence_of_element_located(\n (By.CSS_SELECTOR, '#all-list > div.flow-loader > div.filter-wrap')))\n\n html = browser.page_source\n soup = BeautifulSoup(html, 'lxml')\n print('到这')\n\n save_to_excel(soup)\n\n\ndef main():\n try:\n total = search()\n print(total)\n\n for i in range(2, int(total + 1)):\n next_page(i)\n\n finally:\n browser.close()\n\n\nif __name__ == '__main__':\n main()\n book.save('蔡徐坤篮球.xlsx')\n"
},
{
"path": "meizitu.py",
"content": "# encoding = utf-8\nimport concurrent\nimport os\nfrom concurrent.futures import ThreadPoolExecutor\nimport requests\nfrom bs4 import BeautifulSoup\n\n\ndef header(referer):\n\n headers = {\n 'Host': 'i.meizitu.net',\n 'Pragma': 'no-cache',\n 'Accept-Encoding': 'gzip, deflate',\n 'Accept-Language': 'zh-CN,zh;q=0.8,en;q=0.6',\n 'Cache-Control': 'no-cache',\n 'Connection': 'keep-alive',\n 'User-Agent': 'Mozilla/5.0 (Windows NT 6.1; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/72.0.3626.121 Safari/537.36',\n 'Accept': 'image/webp,image/apng,image/*,*/*;q=0.8',\n 'Referer': '{}'.format(referer),\n }\n\n return headers\n\n\ndef request_page(url):\n try:\n response = requests.get(url)\n if response.status_code == 200:\n return response.text\n except requests.RequestException:\n return None\n\n\ndef get_page_urls():\n\n for i in range(1, 2):\n baseurl = 'https://www.mzitu.com/page/{}'.format(i)\n html = request_page(baseurl)\n soup = BeautifulSoup(html, 'lxml')\n elements = soup.find(class_='postlist').find_all('li')\n urls = []\n for item in elements:\n url = item.find('span').find('a').get('href')\n print('页面链接：%s' % url)\n urls.append(url)\n\n return urls\n\n\ndef download_Pic(title, image_list):\n # 新建文件夹\n os.mkdir(title)\n j = 1\n # 下载图片\n for item in image_list:\n filename = '%s/%s.jpg' % (title, str(j))\n print('downloading....%s : NO.%s' % (title, str(j)))\n with open(filename, 'wb') as f:\n img = requests.get(item, headers=header(item)).content\n f.write(img)\n j += 1\n\ndef download(url):\n html = request_page(url)\n soup = BeautifulSoup(html, 'lxml')\n total = soup.find(class_='pagenavi').find_all('a')[-2].find('span').string\n title = soup.find('h2').string\n image_list = []\n\n for i in range(int(total)):\n html = request_page(url + '/%s' % (i + 1))\n soup = BeautifulSoup(html, 'lxml')\n img_url = soup.find('img').get('src')\n image_list.append(img_url)\n\n download_Pic(title, image_list)\n\n\ndef download_all_images(list_page_urls):\n # 获取每一个详情妹纸\n # works = len(list_page_urls)\n with concurrent.futures.ProcessPoolExecutor(max_workers=5) as exector:\n for url in list_page_urls:\n exector.submit(download, url)\n\n\nif __name__ == '__main__':\n # 获取每一页的链接和名称\n list_page_urls = get_page_urls()\n download_all_images(list_page_urls)"
},
{
"path": "qiushibaike/qiushibaike/__init__.py",
"content": ""
},
{
"path": "qiushibaike/qiushibaike/items.py",
"content": "# -*- coding: utf-8 -*-\n\n# Define here the models for your scraped items\n#\n# See documentation in:\n# https://doc.scrapy.org/en/latest/topics/items.html\n\nimport scrapy\n\n\nclass QiushibaikeItem(scrapy.Item):\n # define the fields for your item here like:\n # name = scrapy.Field()\n author = scrapy.Field()\n content = scrapy.Field()\n _id = scrapy.Field()\n\n\n"
},
{
"path": "qiushibaike/qiushibaike/middlewares.py",
"content": "# -*- coding: utf-8 -*-\n\n# Define here the models for your spider middleware\n#\n# See documentation in:\n# https://doc.scrapy.org/en/latest/topics/spider-middleware.html\n\nfrom scrapy import signals\n\n\nclass QiushibaikeSpiderMiddleware(object):\n # Not all methods need to be defined. If a method is not defined,\n # scrapy acts as if the spider middleware does not modify the\n # passed objects.\n\n @classmethod\n def from_crawler(cls, crawler):\n # This method is used by Scrapy to create your spiders.\n s = cls()\n crawler.signals.connect(s.spider_opened, signal=signals.spider_opened)\n return s\n\n def process_spider_input(self, response, spider):\n # Called for each response that goes through the spider\n # middleware and into the spider.\n\n # Should return None or raise an exception.\n return None\n\n def process_spider_output(self, response, result, spider):\n # Called with the results returned from the Spider, after\n # it has processed the response.\n\n # Must return an iterable of Request, dict or Item objects.\n for i in result:\n yield i\n\n def process_spider_exception(self, response, exception, spider):\n # Called when a spider or process_spider_input() method\n # (from other spider middleware) raises an exception.\n\n # Should return either None or an iterable of Response, dict\n # or Item objects.\n pass\n\n def process_start_requests(self, start_requests, spider):\n # Called with the start requests of the spider, and works\n # similarly to the process_spider_output() method, except\n # that it doesn’t have a response associated.\n\n # Must return only requests (not items).\n for r in start_requests:\n yield r\n\n def spider_opened(self, spider):\n spider.logger.info('Spider opened: %s' % spider.name)\n\n\nclass QiushibaikeDownloaderMiddleware(object):\n # Not all methods need to be defined. If a method is not defined,\n # scrapy acts as if the downloader middleware does not modify the\n # passed objects.\n\n @classmethod\n def from_crawler(cls, crawler):\n # This method is used by Scrapy to create your spiders.\n s = cls()\n crawler.signals.connect(s.spider_opened, signal=signals.spider_opened)\n return s\n\n def process_request(self, request, spider):\n # Called for each request that goes through the downloader\n # middleware.\n\n # Must either:\n # - return None: continue processing this request\n # - or return a Response object\n # - or return a Request object\n # - or raise IgnoreRequest: process_exception() methods of\n # installed downloader middleware will be called\n return None\n\n def process_response(self, request, response, spider):\n # Called with the response returned from the downloader.\n\n # Must either;\n # - return a Response object\n # - return a Request object\n # - or raise IgnoreRequest\n return response\n\n def process_exception(self, request, exception, spider):\n # Called when a download handler or a process_request()\n # (from other downloader middleware) raises an exception.\n\n # Must either:\n # - return None: continue processing this exception\n # - return a Response object: stops process_exception() chain\n # - return a Request object: stops process_exception() chain\n pass\n\n def spider_opened(self, spider):\n spider.logger.info('Spider opened: %s' % spider.name)\n"
},
{
"path": "qiushibaike/qiushibaike/pipelines.py",
"content": "# -*- coding: utf-8 -*-\n\n# Define your item pipelines here\n#\n# Don't forget to add your pipeline to the ITEM_PIPELINES setting\n# See: https://doc.scrapy.org/en/latest/topics/item-pipeline.html\nimport pymongo\n\n\nclass QiushibaikePipeline(object):\n\n def __init__(self):\n self.connection = pymongo.MongoClient('localhost', 27017)\n self.db = self.connection.scrapy\n self.collection = self.db.qiushibaike\n\n def process_item(self, item, spider):\n if not self.connection or not item:\n return\n self.collection.save(item)\n\n def __del__(self):\n if self.connection:\n self.connection.close()\n\n\n"
},
{
"path": "qiushibaike/qiushibaike/settings.py",
"content": "# -*- coding: utf-8 -*-\n\n# Scrapy settings for qiushibaike project\n#\n# For simplicity, this file contains only settings considered important or\n# commonly used. You can find more settings consulting the documentation:\n#\n# https://doc.scrapy.org/en/latest/topics/settings.html\n# https://doc.scrapy.org/en/latest/topics/downloader-middleware.html\n# https://doc.scrapy.org/en/latest/topics/spider-middleware.html\n\nBOT_NAME = 'qiushibaike'\n\nSPIDER_MODULES = ['qiushibaike.spiders']\nNEWSPIDER_MODULE = 'qiushibaike.spiders'\n\nFEED_EXPORT_ENCODING = 'utf-8'\n\n\n# Crawl responsibly by identifying yourself (and your website) on the user-agent\nUSER_AGENT = 'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Ubuntu Chromium/73.0.3683.86 Chrome/73.0.3683.86 Safari/537.36'\n\n# Obey robots.txt rules\nROBOTSTXT_OBEY = True\n\n# Configure maximum concurrent requests performed by Scrapy (default: 16)\n#CONCURRENT_REQUESTS = 32\n\n# Configure a delay for requests for the same website (default: 0)\n# See https://doc.scrapy.org/en/latest/topics/settings.html#download-delay\n# See also autothrottle settings and docs\n#DOWNLOAD_DELAY = 3\n# The download delay setting will honor only one of:\n#CONCURRENT_REQUESTS_PER_DOMAIN = 16\n#CONCURRENT_REQUESTS_PER_IP = 16\n\n# Disable cookies (enabled by default)\n#COOKIES_ENABLED = False\n\n# Disable Telnet Console (enabled by default)\n#TELNETCONSOLE_ENABLED = False\n\n# Override the default request headers:\n#DEFAULT_REQUEST_HEADERS = {\n# 'Accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',\n# 'Accept-Language': 'en',\n#}\n\n# Enable or disable spider middlewares\n# See https://doc.scrapy.org/en/latest/topics/spider-middleware.html\n#SPIDER_MIDDLEWARES = {\n# 'qiushibaike.middlewares.QiushibaikeSpiderMiddleware': 543,\n#}\n\n# Enable or disable downloader middlewares\n# See https://doc.scrapy.org/en/latest/topics/downloader-middleware.html\n#DOWNLOADER_MIDDLEWARES = {\n# 'qiushibaike.middlewares.QiushibaikeDownloaderMiddleware': 543,\n#}\n\n# Enable or disable extensions\n# See https://doc.scrapy.org/en/latest/topics/extensions.html\n#EXTENSIONS = {\n# 'scrapy.extensions.telnet.TelnetConsole': None,\n#}\n\n# Configure item pipelines\n# See https://doc.scrapy.org/en/latest/topics/item-pipeline.html\nITEM_PIPELINES = {\n 'qiushibaike.pipelines.QiushibaikePipeline': 300,\n}\n\n# Enable and configure the AutoThrottle extension (disabled by default)\n# See https://doc.scrapy.org/en/latest/topics/autothrottle.html\n#AUTOTHROTTLE_ENABLED = True\n# The initial download delay\n#AUTOTHROTTLE_START_DELAY = 5\n# The maximum download delay to be set in case of high latencies\n#AUTOTHROTTLE_MAX_DELAY = 60\n# The average number of requests Scrapy should be sending in parallel to\n# each remote server\n#AUTOTHROTTLE_TARGET_CONCURRENCY = 1.0\n# Enable showing throttling stats for every response received:\n#AUTOTHROTTLE_DEBUG = False\n\n# Enable and configure HTTP caching (disabled by default)\n# See https://doc.scrapy.org/en/latest/topics/downloader-middleware.html#httpcache-middleware-settings\n#HTTPCACHE_ENABLED = True\n#HTTPCACHE_EXPIRATION_SECS = 0\n#HTTPCACHE_DIR = 'httpcache'\n#HTTPCACHE_IGNORE_HTTP_CODES = []\n#HTTPCACHE_STORAGE = 'scrapy.extensions.httpcache.FilesystemCacheStorage'\n"
},
{
"path": "qiushibaike/qiushibaike/spiders/__init__.py",
"content": "# This package will contain the spiders of your Scrapy project\n#\n# Please refer to the documentation for information on how to create and manage\n# your spiders.\n"
},
{
"path": "qiushibaike/qiushibaike/spiders/qiushibaike_spider.py",
"content": "# -*- coding: utf-8 -*-\nimport random\n\nimport scrapy\n\nfrom qiushibaike.items import QiushibaikeItem\n\n\nclass QiushiSpider(scrapy.Spider):\n # 这里定义一个唯一的名称，用来标识糗事的爬虫，在项目中不能和别的爬虫名称一样，等会会用到这个名称\n name = \"qiushibaike\"\n\n\n def start_requests(self):\n urls = [\n 'https://www.qiushibaike.com/text/page/1/',\n ]\n for url in urls:\n yield scrapy.Request(url=url, callback=self.parse)\n\n def parse(self, response):\n\n content_left_div = response.xpath('//*[@id=\"content-left\"]')\n content_list_div = content_left_div.xpath('./div')\n\n for content_div in content_list_div:\n item = QiushibaikeItem()\n item['author'] = content_div.xpath('./div/a[2]/h2/text()').get()\n item['content'] = content_div.xpath('./a/div/span/text()').getall()\n item['_id'] = content_div.attrib['id']\n yield item\n\n next_page = response.xpath('//*[@id=\"content-left\"]/ul/li[last()]/a').attrib['href']\n\n if next_page is not None:\n yield response.follow(next_page, callback=self.parse)"
},
{
"path": "qiushibaike/scrapy.cfg",
"content": "# Automatically created by: scrapy startproject\n#\n# For more information about the [deploy] section see:\n# https://scrapyd.readthedocs.io/en/latest/deploy.html\n\n[settings]\ndefault = qiushibaike.settings\n\n[deploy]\n#url = http://localhost:6800/\nproject = qiushibaike\n"
},
{
"path": "stackoverflow/.idea/inspectionProfiles/profiles_settings.xml",
"content": "\n \n \n \n \n"
},
{
"path": "stackoverflow/.idea/misc.xml",
"content": "\n\n \n"
},
{
"path": "stackoverflow/.idea/modules.xml",
"content": "\n\n \n \n \n \n \n"
},
{
"path": "stackoverflow/.idea/stackoverflow.iml",
"content": "\n\n \n \n \n \n \n \n \n \n \n \n \n"
},
{
"path": "stackoverflow/.idea/vcs.xml",
"content": "\n\n \n \n \n"
},
{
"path": "stackoverflow/.idea/workspace.xml",
"content": "\n\n \n \n \n \n \n \n \n \n
\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
\n \n \n \n \n \n \n \n \n 1571212815240\n \n \n 1571212815240\n \n \n \n \n \n \n"
},
{
"path": "stackoverflow/scrapy.cfg",
"content": "# Automatically created by: scrapy startproject\n#\n# For more information about the [deploy] section see:\n# https://scrapyd.readthedocs.io/en/latest/deploy.html\n\n[settings]\ndefault = stackoverflow.settings\n\n[deploy]\n#url = http://localhost:6800/\nproject = stackoverflow\n"
},
{
"path": "stackoverflow/stackoverflow/__init__.py",
"content": ""
},
{
"path": "stackoverflow/stackoverflow/items.py",
"content": "# -*- coding: utf-8 -*-\n\n# Define here the models for your scraped items\n#\n# See documentation in:\n# https://doc.scrapy.org/en/latest/topics/items.html\n\nimport scrapy\n\nclass StackoverflowPythonItem(scrapy.Item):\n _id = scrapy.Field()\n questions = scrapy.Field()\n votes = scrapy.Field()\n answers = scrapy.Field()\n views = scrapy.Field()\n links = scrapy.Field()\n\n"
},
{
"path": "stackoverflow/stackoverflow/middlewares/StackoverflowDownloaderMiddleware.py",
"content": "from scrapy.downloadermiddlewares.httpproxy import HttpProxyMiddleware\n\n\nclass HttpProxy(HttpProxyMiddleware):\n\n @staticmethod\n def proxy_shadowsocks():\n proxy = \"http://127.0.0.1:1080\"\n return proxy\n"
},
{
"path": "stackoverflow/stackoverflow/middlewares/__init__.py",
"content": ""
},
{
"path": "stackoverflow/stackoverflow/middlewares.py",
"content": "# -*- coding: utf-8 -*-\n\n# Define here the models for your spider middleware\n#\n# See documentation in:\n# https://doc.scrapy.org/en/latest/topics/spider-middleware.html\n\nfrom scrapy import signals\n\n\nclass StackoverflowSpiderMiddleware(object):\n # Not all methods need to be defined. If a method is not defined,\n # scrapy acts as if the spider middleware does not modify the\n # passed objects.\n\n @classmethod\n def from_crawler(cls, crawler):\n # This method is used by Scrapy to create your spiders.\n s = cls()\n crawler.signals.connect(s.spider_opened, signal=signals.spider_opened)\n return s\n\n def process_spider_input(self, response, spider):\n # Called for each response that goes through the spider\n # middleware and into the spider.\n\n # Should return None or raise an exception.\n return None\n\n def process_spider_output(self, response, result, spider):\n # Called with the results returned from the Spider, after\n # it has processed the response.\n\n # Must return an iterable of Request, dict or Item objects.\n for i in result:\n yield i\n\n def process_spider_exception(self, response, exception, spider):\n # Called when a spider or process_spider_input() method\n # (from other spider middleware) raises an exception.\n\n # Should return either None or an iterable of Response, dict\n # or Item objects.\n pass\n\n def process_start_requests(self, start_requests, spider):\n # Called with the start requests of the spider, and works\n # similarly to the process_spider_output() method, except\n # that it doesn’t have a response associated.\n\n # Must return only requests (not items).\n for r in start_requests:\n yield r\n\n def spider_opened(self, spider):\n spider.logger.info('Spider opened: %s' % spider.name)\n\n\nclass StackoverflowDownloaderMiddleware(object):\n # Not all methods need to be defined. If a method is not defined,\n # scrapy acts as if the downloader middleware does not modify the\n # passed objects.\n\n @classmethod\n def from_crawler(cls, crawler):\n # This method is used by Scrapy to create your spiders.\n s = cls()\n crawler.signals.connect(s.spider_opened, signal=signals.spider_opened)\n return s\n\n def process_request(self, request, spider):\n # Called for each request that goes through the downloader\n # middleware.\n\n # Must either:\n # - return None: continue processing this request\n # - or return a Response object\n # - or return a Request object\n # - or raise IgnoreRequest: process_exception() methods of\n # installed downloader middleware will be called\n return None\n\n def process_response(self, request, response, spider):\n # Called with the response returned from the downloader.\n\n # Must either;\n # - return a Response object\n # - return a Request object\n # - or raise IgnoreRequest\n return response\n\n def process_exception(self, request, exception, spider):\n # Called when a download handler or a process_request()\n # (from other downloader middleware) raises an exception.\n\n # Must either:\n # - return None: continue processing this exception\n # - return a Response object: stops process_exception() chain\n # - return a Request object: stops process_exception() chain\n pass\n\n def spider_opened(self, spider):\n spider.logger.info('Spider opened: %s' % spider.name)\n"
},
{
"path": "stackoverflow/stackoverflow/pipelines.py",
"content": "# -*- coding: utf-8 -*-\n\n# Define your item pipelines here\n#\n# Don't forget to add your pipeline to the ITEM_PIPELINES setting\n# See: https://doc.scrapy.org/en/latest/topics/item-pipeline.html\nimport pymongo\n\nclass StackoverflowPipeline(object):\n def __init__(self):\n self.connection = pymongo.MongoClient('68.183.180.71', 27017)\n self.db = self.connection.scrapy\n self.collection = self.db.stackoverflow\n\n def process_item(self, item, spider):\n if not self.connection or not item:\n return\n self.collection.save(item)\n\n def __del__(self):\n if self.connection:\n self.connection.close()\n"
},
{
"path": "stackoverflow/stackoverflow/requirement.txt",
"content": "pymongo==3.9.0\nredis==3.3.11\nScrapy==1.7.4\nscrapy-redis==0.6.8\nlxml==4.4.1\nparsel==1.5.2\n\n\n\n"
},
{
"path": "stackoverflow/stackoverflow/settings.py",
"content": "# -*- coding: utf-8 -*-\n\n# Scrapy settings for stackoverflow project\n#\n# For simplicity, this file contains only settings considered important or\n# commonly used. You can find more settings consulting the documentation:\n#\n# https://doc.scrapy.org/en/latest/topics/settings.html\n# https://doc.scrapy.org/en/latest/topics/downloader-middleware.html\n# https://doc.scrapy.org/en/latest/topics/spider-middleware.html\n\nBOT_NAME = 'stackoverflow'\n\nSPIDER_MODULES = ['stackoverflow.spiders']\nNEWSPIDER_MODULE = 'stackoverflow.spiders'\n\n\n# Crawl responsibly by identifying yourself (and your website) on the user-agent\nUSER_AGENT = 'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Ubuntu Chromium/73.0.3683.86 Chrome/73.0.3683.86 Safari/537.36'\n\n# Obey robots.txt rules\nROBOTSTXT_OBEY = True\n\n# Configure maximum concurrent requests performed by Scrapy (default: 16)\n#CONCURRENT_REQUESTS = 32\n\n# Configure a delay for requests for the same website (default: 0)\n# See https://doc.scrapy.org/en/latest/topics/settings.html#download-delay\n# See also autothrottle settings and docs\nDOWNLOAD_DELAY = 1\n# The download delay setting will honor only one of:\n#CONCURRENT_REQUESTS_PER_DOMAIN = 16\n#CONCURRENT_REQUESTS_PER_IP = 16\n\n# Disable cookies (enabled by default)\n#COOKIES_ENABLED = False\n\n# Disable Telnet Console (enabled by default)\n#TELNETCONSOLE_ENABLED = False\n\n# Override the default request headers:\n#DEFAULT_REQUEST_HEADERS = {\n# 'Accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',\n# 'Accept-Language': 'en',\n#}\n\n# Enable or disable spider middlewares\n# See https://doc.scrapy.org/en/latest/topics/spider-middleware.html\n#SPIDER_MIDDLEWARES = {\n# 'stackoverflow.middlewares.StackoverflowSpiderMiddleware': 543,\n#}\n\n# Enable or disable downloader middlewares\n# See https://doc.scrapy.org/en/latest/topics/downloader-middleware.html\nDOWNLOADER_MIDDLEWARES = {\n 'stackoverflow.middlewares.StackoverflowDownloaderMiddleware.HttpProxy': 543,\n}\n\n# Enable or disable extensions\n# See https://doc.scrapy.org/en/latest/topics/extensions.html\n#EXTENSIONS = {\n# 'scrapy.extensions.telnet.TelnetConsole': None,\n#}\n\n# Configure item pipelines\n# See https://doc.scrapy.org/en/latest/topics/item-pipeline.html\nITEM_PIPELINES = {\n 'stackoverflow.pipelines.StackoverflowPipeline': 300,\n}\n\n# Enable and configure the AutoThrottle extension (disabled by default)\n# See https://doc.scrapy.org/en/latest/topics/autothrottle.html\n#AUTOTHROTTLE_ENABLED = True\n# The initial download delay\n#AUTOTHROTTLE_START_DELAY = 5\n# The maximum download delay to be set in case of high latencies\n#AUTOTHROTTLE_MAX_DELAY = 60\n# The average number of requests Scrapy should be sending in parallel to\n# each remote server\n#AUTOTHROTTLE_TARGET_CONCURRENCY = 1.0\n# Enable showing throttling stats for every response received:\n#AUTOTHROTTLE_DEBUG = False\n\n# Enable and configure HTTP caching (disabled by default)\n# See https://doc.scrapy.org/en/latest/topics/downloader-middleware.html#httpcache-middleware-settings\n#HTTPCACHE_ENABLED = True\n#HTTPCACHE_EXPIRATION_SECS = 0\n#HTTPCACHE_DIR = 'httpcache'\n#HTTPCACHE_IGNORE_HTTP_CODES = []\n#HTTPCACHE_STORAGE = 'scrapy.extensions.httpcache.FilesystemCacheStorage'\n\n\n# 调度器改为 scrapy_redis\nSCHEDULER = 'scrapy_redis.scheduler.Scheduler'\n# redis 去重\nDUPEFILTER_CLASS = \"scrapy_redis.dupefilter.RFPDupeFilter\"\n# redis服务器地址\nREDIS_HOST = '68.183.180.0'\nREDIS_PORT = 6379\n\n\n\n\n\n\n"
},
{
"path": "stackoverflow/stackoverflow/spiders/__init__.py",
"content": "# This package will contain the spiders of your Scrapy project\n#\n# Please refer to the documentation for information on how to create and manage\n# your spiders.\n"
},
{
"path": "stackoverflow/stackoverflow/spiders/stackoverflow-python-spider.py",
"content": "import scrapy\nfrom stackoverflow.items import StackoverflowPythonItem\n\nclass StackoverflowPythonSpider(scrapy.Spider):\n\n name = \"stackoverflow-python\"\n\n def start_requests(self):\n urls = []\n _url = 'https://stackoverflow.com/questions/tagged/python?tab=votes&page={}&pagesize=15'\n\n for page in range(1, 84322):\n urls.append(_url.format(page))\n\n for url in urls:\n yield scrapy.Request(url=url, callback=self.parse)\n\n def parse(self, response):\n question_list = response.xpath('//*[@id=\"questions\"]')\n\n for question in question_list.xpath('./div'):\n item = StackoverflowPythonItem()\n item['_id'] = question.attrib['id']\n item['questions'] = question.xpath('div[2]/h3/a/text()').extract()\n item['votes'] = question.xpath(\n 'div[1]/div[1]/div[1]/div[1]/span/strong/text()').extract()\n item['answers'] = question.xpath(\n 'div[1]/div[1]/div[2]/strong/text()').extract()\n item['views'] = question.xpath('div[1]/div[2]/@title').extract()\n item['links'] = question.xpath('div[2]/h3/a/@href').extract()\n yield item\n\n\n\n\n"
},
{
"path": "stackoverflow/venv/bin/activate",
"content": "# This file must be used with \"source bin/activate\" *from bash*\n# you cannot run it directly\n\ndeactivate () {\n # reset old environment variables\n if [ -n \"${_OLD_VIRTUAL_PATH:-}\" ] ; then\n PATH=\"${_OLD_VIRTUAL_PATH:-}\"\n export PATH\n unset _OLD_VIRTUAL_PATH\n fi\n if [ -n \"${_OLD_VIRTUAL_PYTHONHOME:-}\" ] ; then\n PYTHONHOME=\"${_OLD_VIRTUAL_PYTHONHOME:-}\"\n export PYTHONHOME\n unset _OLD_VIRTUAL_PYTHONHOME\n fi\n\n # This should detect bash and zsh, which have a hash command that must\n # be called to get it to forget past commands. Without forgetting\n # past commands the $PATH changes we made may not be respected\n if [ -n \"${BASH:-}\" -o -n \"${ZSH_VERSION:-}\" ] ; then\n hash -r\n fi\n\n if [ -n \"${_OLD_VIRTUAL_PS1:-}\" ] ; then\n PS1=\"${_OLD_VIRTUAL_PS1:-}\"\n export PS1\n unset _OLD_VIRTUAL_PS1\n fi\n\n unset VIRTUAL_ENV\n if [ ! \"$1\" = \"nondestructive\" ] ; then\n # Self destruct!\n unset -f deactivate\n fi\n}\n\n# unset irrelevant variables\ndeactivate nondestructive\n\nVIRTUAL_ENV=\"/home/wistbean/githubproject/learn_python3_spider/stackoverflow/venv\"\nexport VIRTUAL_ENV\n\n_OLD_VIRTUAL_PATH=\"$PATH\"\nPATH=\"$VIRTUAL_ENV/bin:$PATH\"\nexport PATH\n\n# unset PYTHONHOME if set\n# this will fail if PYTHONHOME is set to the empty string (which is bad anyway)\n# could use `if (set -u; : $PYTHONHOME) ;` in bash\nif [ -n \"${PYTHONHOME:-}\" ] ; then\n _OLD_VIRTUAL_PYTHONHOME=\"${PYTHONHOME:-}\"\n unset PYTHONHOME\nfi\n\nif [ -z \"${VIRTUAL_ENV_DISABLE_PROMPT:-}\" ] ; then\n _OLD_VIRTUAL_PS1=\"${PS1:-}\"\n if [ \"x(venv) \" != x ] ; then\n\tPS1=\"(venv) ${PS1:-}\"\n else\n if [ \"`basename \\\"$VIRTUAL_ENV\\\"`\" = \"__\" ] ; then\n # special case for Aspen magic directories\n # see http://www.zetadev.com/software/aspen/\n PS1=\"[`basename \\`dirname \\\"$VIRTUAL_ENV\\\"\\``] $PS1\"\n else\n PS1=\"(`basename \\\"$VIRTUAL_ENV\\\"`)$PS1\"\n fi\n fi\n export PS1\nfi\n\n# This should detect bash and zsh, which have a hash command that must\n# be called to get it to forget past commands. Without forgetting\n# past commands the $PATH changes we made may not be respected\nif [ -n \"${BASH:-}\" -o -n \"${ZSH_VERSION:-}\" ] ; then\n hash -r\nfi\n"
},
{
"path": "stackoverflow/venv/bin/activate.csh",
"content": "# This file must be used with \"source bin/activate.csh\" *from csh*.\n# You cannot run it directly.\n# Created by Davide Di Blasi .\n# Ported to Python 3.3 venv by Andrew Svetlov \n\nalias deactivate 'test $?_OLD_VIRTUAL_PATH != 0 && setenv PATH \"$_OLD_VIRTUAL_PATH\" && unset _OLD_VIRTUAL_PATH; rehash; test $?_OLD_VIRTUAL_PROMPT != 0 && set prompt=\"$_OLD_VIRTUAL_PROMPT\" && unset _OLD_VIRTUAL_PROMPT; unsetenv VIRTUAL_ENV; test \"\\!:*\" != \"nondestructive\" && unalias deactivate'\n\n# Unset irrelevant variables.\ndeactivate nondestructive\n\nsetenv VIRTUAL_ENV \"/home/wistbean/githubproject/learn_python3_spider/stackoverflow/venv\"\n\nset _OLD_VIRTUAL_PATH=\"$PATH\"\nsetenv PATH \"$VIRTUAL_ENV/bin:$PATH\"\n\n\nset _OLD_VIRTUAL_PROMPT=\"$prompt\"\n\nif (! \"$?VIRTUAL_ENV_DISABLE_PROMPT\") then\n if (\"venv\" != \"\") then\n set env_name = \"venv\"\n else\n if (`basename \"VIRTUAL_ENV\"` == \"__\") then\n # special case for Aspen magic directories\n # see http://www.zetadev.com/software/aspen/\n set env_name = `basename \\`dirname \"$VIRTUAL_ENV\"\\``\n else\n set env_name = `basename \"$VIRTUAL_ENV\"`\n endif\n endif\n set prompt = \"[$env_name] $prompt\"\n unset env_name\nendif\n\nalias pydoc python -m pydoc\n\nrehash\n"
},
{
"path": "stackoverflow/venv/bin/activate.fish",
"content": "# This file must be used with \". bin/activate.fish\" *from fish* (http://fishshell.org)\n# you cannot run it directly\n\nfunction deactivate -d \"Exit virtualenv and return to normal shell environment\"\n # reset old environment variables\n if test -n \"$_OLD_VIRTUAL_PATH\"\n set -gx PATH $_OLD_VIRTUAL_PATH\n set -e _OLD_VIRTUAL_PATH\n end\n if test -n \"$_OLD_VIRTUAL_PYTHONHOME\"\n set -gx PYTHONHOME $_OLD_VIRTUAL_PYTHONHOME\n set -e _OLD_VIRTUAL_PYTHONHOME\n end\n\n if test -n \"$_OLD_FISH_PROMPT_OVERRIDE\"\n functions -e fish_prompt\n set -e _OLD_FISH_PROMPT_OVERRIDE\n functions -c _old_fish_prompt fish_prompt\n functions -e _old_fish_prompt\n end\n\n set -e VIRTUAL_ENV\n if test \"$argv[1]\" != \"nondestructive\"\n # Self destruct!\n functions -e deactivate\n end\nend\n\n# unset irrelevant variables\ndeactivate nondestructive\n\nset -gx VIRTUAL_ENV \"/home/wistbean/githubproject/learn_python3_spider/stackoverflow/venv\"\n\nset -gx _OLD_VIRTUAL_PATH $PATH\nset -gx PATH \"$VIRTUAL_ENV/bin\" $PATH\n\n# unset PYTHONHOME if set\nif set -q PYTHONHOME\n set -gx _OLD_VIRTUAL_PYTHONHOME $PYTHONHOME\n set -e PYTHONHOME\nend\n\nif test -z \"$VIRTUAL_ENV_DISABLE_PROMPT\"\n # fish uses a function instead of an env var to generate the prompt.\n\n # save the current fish_prompt function as the function _old_fish_prompt\n functions -c fish_prompt _old_fish_prompt\n\n # with the original prompt function renamed, we can override with our own.\n function fish_prompt\n # Save the return status of the last command\n set -l old_status $status\n\n # Prompt override?\n if test -n \"(venv) \" \n printf \"%s%s\" \"(venv) \" (set_color normal)\n else\n # ...Otherwise, prepend env\n set -l _checkbase (basename \"$VIRTUAL_ENV\")\n if test $_checkbase = \"__\"\n # special case for Aspen magic directories\n # see http://www.zetadev.com/software/aspen/\n printf \"%s[%s]%s \" (set_color -b blue white) (basename (dirname \"$VIRTUAL_ENV\")) (set_color normal)\n else\n printf \"%s(%s)%s\" (set_color -b blue white) (basename \"$VIRTUAL_ENV\") (set_color normal)\n end\n end\n\n # Restore the return status of the previous command.\n echo \"exit $old_status\" | .\n _old_fish_prompt\n end\n\n set -gx _OLD_FISH_PROMPT_OVERRIDE \"$VIRTUAL_ENV\"\nend\n"
},
{
"path": "stackoverflow/venv/bin/automat-visualize",
"content": "#!/home/wistbean/githubproject/learn_python3_spider/stackoverflow/venv/bin/python\n# -*- coding: utf-8 -*-\nimport re\nimport sys\n\nfrom automat._visualize import tool\n\nif __name__ == '__main__':\n sys.argv[0] = re.sub(r'(-script\\.pyw?|\\.exe)?$', '', sys.argv[0])\n sys.exit(tool())\n"
},
{
"path": "stackoverflow/venv/bin/cftp",
"content": "#!/home/wistbean/githubproject/learn_python3_spider/stackoverflow/venv/bin/python\n# -*- coding: utf-8 -*-\nimport re\nimport sys\n\nfrom twisted.conch.scripts.cftp import run\n\nif __name__ == '__main__':\n sys.argv[0] = re.sub(r'(-script\\.pyw?|\\.exe)?$', '', sys.argv[0])\n sys.exit(run())\n"
},
{
"path": "stackoverflow/venv/bin/ckeygen",
"content": "#!/home/wistbean/githubproject/learn_python3_spider/stackoverflow/venv/bin/python\n# -*- coding: utf-8 -*-\nimport re\nimport sys\n\nfrom twisted.conch.scripts.ckeygen import run\n\nif __name__ == '__main__':\n sys.argv[0] = re.sub(r'(-script\\.pyw?|\\.exe)?$', '', sys.argv[0])\n sys.exit(run())\n"
},
{
"path": "stackoverflow/venv/bin/conch",
"content": "#!/home/wistbean/githubproject/learn_python3_spider/stackoverflow/venv/bin/python\n# -*- coding: utf-8 -*-\nimport re\nimport sys\n\nfrom twisted.conch.scripts.conch import run\n\nif __name__ == '__main__':\n sys.argv[0] = re.sub(r'(-script\\.pyw?|\\.exe)?$', '', sys.argv[0])\n sys.exit(run())\n"
},
{
"path": "stackoverflow/venv/bin/easy_install",
"content": "#!/home/wistbean/githubproject/learn_python3_spider/stackoverflow/venv/bin/python\n# EASY-INSTALL-ENTRY-SCRIPT: 'setuptools==40.8.0','console_scripts','easy_install'\n__requires__ = 'setuptools==40.8.0'\nimport re\nimport sys\nfrom pkg_resources import load_entry_point\n\nif __name__ == '__main__':\n sys.argv[0] = re.sub(r'(-script\\.pyw?|\\.exe)?$', '', sys.argv[0])\n sys.exit(\n load_entry_point('setuptools==40.8.0', 'console_scripts', 'easy_install')()\n )\n"
},
{
"path": "stackoverflow/venv/bin/easy_install-3.6",
"content": "#!/home/wistbean/githubproject/learn_python3_spider/stackoverflow/venv/bin/python\n# EASY-INSTALL-ENTRY-SCRIPT: 'setuptools==40.8.0','console_scripts','easy_install-3.6'\n__requires__ = 'setuptools==40.8.0'\nimport re\nimport sys\nfrom pkg_resources import load_entry_point\n\nif __name__ == '__main__':\n sys.argv[0] = re.sub(r'(-script\\.pyw?|\\.exe)?$', '', sys.argv[0])\n sys.exit(\n load_entry_point('setuptools==40.8.0', 'console_scripts', 'easy_install-3.6')()\n )\n"
},
{
"path": "stackoverflow/venv/bin/mailmail",
"content": "#!/home/wistbean/githubproject/learn_python3_spider/stackoverflow/venv/bin/python\n# -*- coding: utf-8 -*-\nimport re\nimport sys\n\nfrom twisted.mail.scripts.mailmail import run\n\nif __name__ == '__main__':\n sys.argv[0] = re.sub(r'(-script\\.pyw?|\\.exe)?$', '', sys.argv[0])\n sys.exit(run())\n"
},
{
"path": "stackoverflow/venv/bin/pip",
"content": "#!/home/wistbean/githubproject/learn_python3_spider/stackoverflow/venv/bin/python\n# EASY-INSTALL-ENTRY-SCRIPT: 'pip==19.0.3','console_scripts','pip'\n__requires__ = 'pip==19.0.3'\nimport re\nimport sys\nfrom pkg_resources import load_entry_point\n\nif __name__ == '__main__':\n sys.argv[0] = re.sub(r'(-script\\.pyw?|\\.exe)?$', '', sys.argv[0])\n sys.exit(\n load_entry_point('pip==19.0.3', 'console_scripts', 'pip')()\n )\n"
},
{
"path": "stackoverflow/venv/bin/pip3",
"content": "#!/home/wistbean/githubproject/learn_python3_spider/stackoverflow/venv/bin/python\n# EASY-INSTALL-ENTRY-SCRIPT: 'pip==19.0.3','console_scripts','pip3'\n__requires__ = 'pip==19.0.3'\nimport re\nimport sys\nfrom pkg_resources import load_entry_point\n\nif __name__ == '__main__':\n sys.argv[0] = re.sub(r'(-script\\.pyw?|\\.exe)?$', '', sys.argv[0])\n sys.exit(\n load_entry_point('pip==19.0.3', 'console_scripts', 'pip3')()\n )\n"
},
{
"path": "stackoverflow/venv/bin/pip3.6",
"content": "#!/home/wistbean/githubproject/learn_python3_spider/stackoverflow/venv/bin/python\n# EASY-INSTALL-ENTRY-SCRIPT: 'pip==19.0.3','console_scripts','pip3.6'\n__requires__ = 'pip==19.0.3'\nimport re\nimport sys\nfrom pkg_resources import load_entry_point\n\nif __name__ == '__main__':\n sys.argv[0] = re.sub(r'(-script\\.pyw?|\\.exe)?$', '', sys.argv[0])\n sys.exit(\n load_entry_point('pip==19.0.3', 'console_scripts', 'pip3.6')()\n )\n"
},
{
"path": "stackoverflow/venv/bin/pyhtmlizer",
"content": "#!/home/wistbean/githubproject/learn_python3_spider/stackoverflow/venv/bin/python\n# -*- coding: utf-8 -*-\nimport re\nimport sys\n\nfrom twisted.scripts.htmlizer import run\n\nif __name__ == '__main__':\n sys.argv[0] = re.sub(r'(-script\\.pyw?|\\.exe)?$', '', sys.argv[0])\n sys.exit(run())\n"
},
{
"path": "stackoverflow/venv/bin/scrapy",
"content": "#!/home/wistbean/githubproject/learn_python3_spider/stackoverflow/venv/bin/python\n# -*- coding: utf-8 -*-\nimport re\nimport sys\n\nfrom scrapy.cmdline import execute\n\nif __name__ == '__main__':\n sys.argv[0] = re.sub(r'(-script\\.pyw?|\\.exe)?$', '', sys.argv[0])\n sys.exit(execute())\n"
},
{
"path": "stackoverflow/venv/bin/tkconch",
"content": "#!/home/wistbean/githubproject/learn_python3_spider/stackoverflow/venv/bin/python\n# -*- coding: utf-8 -*-\nimport re\nimport sys\n\nfrom twisted.conch.scripts.tkconch import run\n\nif __name__ == '__main__':\n sys.argv[0] = re.sub(r'(-script\\.pyw?|\\.exe)?$', '', sys.argv[0])\n sys.exit(run())\n"
},
{
"path": "stackoverflow/venv/bin/trial",
"content": "#!/home/wistbean/githubproject/learn_python3_spider/stackoverflow/venv/bin/python\n# -*- coding: utf-8 -*-\nimport re\nimport sys\n\nfrom twisted.scripts.trial import run\n\nif __name__ == '__main__':\n sys.argv[0] = re.sub(r'(-script\\.pyw?|\\.exe)?$', '', sys.argv[0])\n sys.exit(run())\n"
},
{
"path": "stackoverflow/venv/bin/twist",
"content": "#!/home/wistbean/githubproject/learn_python3_spider/stackoverflow/venv/bin/python\n# -*- coding: utf-8 -*-\nimport re\nimport sys\n\nfrom twisted.application.twist._twist import Twist\n\nif __name__ == '__main__':\n sys.argv[0] = re.sub(r'(-script\\.pyw?|\\.exe)?$', '', sys.argv[0])\n sys.exit(Twist.main())\n"
},
{
"path": "stackoverflow/venv/bin/twistd",
"content": "#!/home/wistbean/githubproject/learn_python3_spider/stackoverflow/venv/bin/python\n# -*- coding: utf-8 -*-\nimport re\nimport sys\n\nfrom twisted.scripts.twistd import run\n\nif __name__ == '__main__':\n sys.argv[0] = re.sub(r'(-script\\.pyw?|\\.exe)?$', '', sys.argv[0])\n sys.exit(run())\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/Automat-0.8.0.dist-info/INSTALLER",
"content": "pip\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/Automat-0.8.0.dist-info/LICENSE",
"content": "Copyright (c) 2014\nRackspace\n\nPermission is hereby granted, free of charge, to any person obtaining\na copy of this software and associated documentation files (the\n\"Software\"), to deal in the Software without restriction, including\nwithout limitation the rights to use, copy, modify, merge, publish,\ndistribute, sublicense, and/or sell copies of the Software, and to\npermit persons to whom the Software is furnished to do so, subject to\nthe following conditions:\n\nThe above copyright notice and this permission notice shall be\nincluded in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\nEXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF\nMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\nNONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE\nLIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION\nOF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION\nWITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/Automat-0.8.0.dist-info/METADATA",
"content": "Metadata-Version: 2.1\nName: Automat\nVersion: 0.8.0\nSummary: Self-service finite-state machines for the programmer on the go.\nHome-page: https://github.com/glyph/Automat\nAuthor: Glyph\nAuthor-email: glyph@twistedmatrix.com\nLicense: MIT\nKeywords: fsm finite state machine automata\nPlatform: UNKNOWN\nClassifier: Intended Audience :: Developers\nClassifier: License :: OSI Approved :: MIT License\nClassifier: Operating System :: OS Independent\nClassifier: Programming Language :: Python\nClassifier: Programming Language :: Python :: 2\nClassifier: Programming Language :: Python :: 2.7\nClassifier: Programming Language :: Python :: 3\nClassifier: Programming Language :: Python :: 3.5\nClassifier: Programming Language :: Python :: 3.6\nClassifier: Programming Language :: Python :: 3.7\nClassifier: Programming Language :: Python :: 3.8\nRequires-Dist: attrs (>=16.1.0)\nRequires-Dist: six\nProvides-Extra: visualize\nRequires-Dist: graphviz (>0.5.1) ; extra == 'visualize'\nRequires-Dist: Twisted (>=16.1.1) ; extra == 'visualize'\n\nAutomat\n=======\n\n\n.. image:: https://readthedocs.org/projects/automat/badge/?version=latest\n :target: http://automat.readthedocs.io/en/latest/\n :alt: Documentation Status\n\n\n.. image:: https://travis-ci.org/glyph/automat.svg?branch=master\n :target: https://travis-ci.org/glyph/automat\n :alt: Build Status\n\n\n.. image:: https://coveralls.io/repos/glyph/automat/badge.png\n :target: https://coveralls.io/r/glyph/automat\n :alt: Coverage Status\n\n\nSelf-service finite-state machines for the programmer on the go.\n----------------------------------------------------------------\n\nAutomat is a library for concise, idiomatic Python expression of finite-state\nautomata (particularly deterministic finite-state transducers).\n\nRead more here, or on `Read the Docs `_\\ , or watch the following videos for an overview and presentation\n\nOverview and presentation by **Glyph Lefkowitz** at the first talk of the first Pyninsula meetup, on February 21st, 2017:\n\n.. image:: https://img.youtube.com/vi/0wOZBpD1VVk/0.jpg\n :target: https://www.youtube.com/watch?v=0wOZBpD1VVk\n :alt: Glyph Lefkowitz - Automat - Pyninsula #0\n\n\nPresentation by **Clinton Roy** at PyCon Australia, on August 6th 2017:\n\n.. image:: https://img.youtube.com/vi/TedUKXhu9kE/0.jpg\n :target: https://www.youtube.com/watch?v=TedUKXhu9kE\n :alt: Clinton Roy - State Machines - Pycon Australia 2017\n\n\nWhy use state machines?\n^^^^^^^^^^^^^^^^^^^^^^^\n\nSometimes you have to create an object whose behavior varies with its state,\nbut still wishes to present a consistent interface to its callers.\n\nFor example, let's say you're writing the software for a coffee machine. It\nhas a lid that can be opened or closed, a chamber for water, a chamber for\ncoffee beans, and a button for \"brew\".\n\nThere are a number of possible states for the coffee machine. It might or\nmight not have water. It might or might not have beans. The lid might be open\nor closed. The \"brew\" button should only actually attempt to brew coffee in\none of these configurations, and the \"open lid\" button should only work if the\ncoffee is not, in fact, brewing.\n\nWith diligence and attention to detail, you can implement this correctly using\na collection of attributes on an object; ``has_water``\\ , ``has_beans``\\ ,\n``is_lid_open`` and so on. However, you have to keep all these attributes\nconsistent. As the coffee maker becomes more complex - perhaps you add an\nadditional chamber for flavorings so you can make hazelnut coffee, for\nexample - you have to keep adding more and more checks and more and more\nreasoning about which combinations of states are allowed.\n\nRather than adding tedious 'if' checks to every single method to make sure that\neach of these flags are exactly what you expect, you can use a state machine to\nensure that if your code runs at all, it will be run with all the required\nvalues initialized, because they have to be called in the order you declare\nthem.\n\nYou can read about state machines and their advantages for Python programmers\nin considerably more detail\n`in this excellent series of articles from ClusterHQ `_.\n\nWhat makes Automat different?\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nThere are\n`dozens of libraries on PyPI implementing state machines `_.\nSo it behooves me to say why yet another one would be a good idea.\n\nAutomat is designed around this principle: while organizing your code around\nstate machines is a good idea, your callers don't, and shouldn't have to, care\nthat you've done so. In Python, the \"input\" to a stateful system is a method\ncall; the \"output\" may be a method call, if you need to invoke a side effect,\nor a return value, if you are just performing a computation in memory. Most\nother state-machine libraries require you to explicitly create an input object,\nprovide that object to a generic \"input\" method, and then receive results,\nsometimes in terms of that library's interfaces and sometimes in terms of\nclasses you define yourself.\n\nFor example, a snippet of the coffee-machine example above might be implemented\nas follows in naive Python:\n\n.. code-block:: python\n\n class CoffeeMachine(object):\n def brew_button(self):\n if self.has_water and self.has_beans and not self.is_lid_open:\n self.heat_the_heating_element()\n # ...\n\nWith Automat, you'd create a class with a ``MethodicalMachine`` attribute:\n\n.. code-block:: python\n\n from automat import MethodicalMachine\n\n class CoffeeBrewer(object):\n _machine = MethodicalMachine()\n\nand then you would break the above logic into two pieces - the ``brew_button``\n*input*\\ , declared like so:\n\n.. code-block:: python\n\n @_machine.input()\n def brew_button(self):\n \"The user pressed the 'brew' button.\"\n\nIt wouldn't do any good to declare a method *body* on this, however, because\ninput methods don't actually execute their bodies when called; doing actual\nwork is the *output*\\ 's job:\n\n.. code-block:: python\n\n @_machine.output()\n def _heat_the_heating_element(self):\n \"Heat up the heating element, which should cause coffee to happen.\"\n self._heating_element.turn_on()\n\nAs well as a couple of *states* - and for simplicity's sake let's say that the\nonly two states are ``have_beans`` and ``dont_have_beans``\\ :\n\n.. code-block:: python\n\n @_machine.state()\n def have_beans(self):\n \"In this state, you have some beans.\"\n @_machine.state(initial=True)\n def dont_have_beans(self):\n \"In this state, you don't have any beans.\"\n\n``dont_have_beans`` is the ``initial`` state because ``CoffeeBrewer`` starts without beans\nin it.\n\n(And another input to put some beans in:)\n\n.. code-block:: python\n\n @_machine.input()\n def put_in_beans(self):\n \"The user put in some beans.\"\n\nFinally, you hook everything together with the ``upon`` method of the functions\ndecorated with ``_machine.state``\\ :\n\n.. code-block:: python\n\n\n # When we don't have beans, upon putting in beans, we will then have beans\n # (and produce no output)\n dont_have_beans.upon(put_in_beans, enter=have_beans, outputs=[])\n\n # When we have beans, upon pressing the brew button, we will then not have\n # beans any more (as they have been entered into the brewing chamber) and\n # our output will be heating the heating element.\n have_beans.upon(brew_button, enter=dont_have_beans,\n outputs=[_heat_the_heating_element])\n\nTo *users* of this coffee machine class though, it still looks like a POPO\n(Plain Old Python Object):\n\n.. code-block:: python\n\n >>> coffee_machine = CoffeeMachine()\n >>> coffee_machine.put_in_beans()\n >>> coffee_machine.brew_button()\n\nAll of the *inputs* are provided by calling them like methods, all of the\n*outputs* are automatically invoked when they are produced according to the\noutputs specified to ``upon`` and all of the states are simply opaque tokens -\nalthough the fact that they're defined as methods like inputs and outputs\nallows you to put docstrings on them easily to document them.\n\nHow do I get the current state of a state machine?\n--------------------------------------------------\n\nDon't do that.\n\nOne major reason for having a state machine is that you want the callers of the\nstate machine to just provide the appropriate input to the machine at the\nappropriate time, and *not have to check themselves* what state the machine is\nin. So if you are tempted to write some code like this:\n\n.. code-block:: python\n\n if connection_state_machine.state == \"CONNECTED\":\n connection_state_machine.send_message()\n else:\n print(\"not connected\")\n\nInstead, just make your calling code do this:\n\n.. code-block:: python\n\n connection_state_machine.send_message()\n\nand then change your state machine to look like this:\n\n.. code-block:: python\n\n @_machine.state()\n def connected(self):\n \"connected\"\n @_machine.state()\n def not_connected(self):\n \"not connected\"\n @_machine.input()\n def send_message(self):\n \"send a message\"\n @_machine.output()\n def _actually_send_message(self):\n self._transport.send(b\"message\")\n @_machine.output()\n def _report_sending_failure(self):\n print(\"not connected\")\n connected.upon(send_message, enter=connected, [_actually_send_message])\n not_connected.upon(send_message, enter=not_connected, [_report_sending_failure])\n\nso that the responsibility for knowing which state the state machine is in\nremains within the state machine itself.\n\nInput for Inputs and Output for Outputs\n---------------------------------------\n\nQuite often you want to be able to pass parameters to your methods, as well as\ninspecting their results. For example, when you brew the coffee, you might\nexpect a cup of coffee to result, and you would like to see what kind of coffee\nit is. And if you were to put delicious hand-roasted small-batch artisanal\nbeans into the machine, you would expect a *better* cup of coffee than if you\nwere to use mass-produced beans. You would do this in plain old Python by\nadding a parameter, so that's how you do it in Automat as well.\n\n.. code-block:: python\n\n @_machine.input()\n def put_in_beans(self, beans):\n \"The user put in some beans.\"\n\nHowever, one important difference here is that *we can't add any\nimplementation code to the input method*. Inputs are purely a declaration of\nthe interface; the behavior must all come from outputs. Therefore, the change\nin the state of the coffee machine must be represented as an output. We can\nadd an output method like this:\n\n.. code-block:: python\n\n @_machine.output()\n def _save_beans(self, beans):\n \"The beans are now in the machine; save them.\"\n self._beans = beans\n\nand then connect it to the ``put_in_beans`` by changing the transition from\n``dont_have_beans`` to ``have_beans`` like so:\n\n.. code-block:: python\n\n dont_have_beans.upon(put_in_beans, enter=have_beans,\n outputs=[_save_beans])\n\nNow, when you call:\n\n.. code-block:: python\n\n coffee_machine.put_in_beans(\"real good beans\")\n\nthe machine will remember the beans for later.\n\nSo how do we get the beans back out again? One of our outputs needs to have a\nreturn value. It would make sense if our ``brew_button`` method returned the cup\nof coffee that it made, so we should add an output. So, in addition to heating\nthe heating element, let's add a return value that describes the coffee. First\na new output:\n\n.. code-block:: python\n\n @_machine.output()\n def _describe_coffee(self):\n return \"A cup of coffee made with {}.\".format(self._beans)\n\nNote that we don't need to check first whether ``self._beans`` exists or not,\nbecause we can only reach this output method if the state machine says we've\ngone through a set of states that sets this attribute.\n\nNow, we need to hook up ``_describe_coffee`` to the process of brewing, so change\nthe brewing transition to:\n\n.. code-block:: python\n\n have_beans.upon(brew_button, enter=dont_have_beans,\n outputs=[_heat_the_heating_element,\n _describe_coffee])\n\nNow, we can call it:\n\n.. code-block:: python\n\n >>> coffee_machine.brew_button()\n [None, 'A cup of coffee made with real good beans.']\n\nExcept... wait a second, what's that ``None`` doing there?\n\nSince every input can produce multiple outputs, in automat, the default return\nvalue from every input invocation is a ``list``. In this case, we have both\n``_heat_the_heating_element`` and ``_describe_coffee`` outputs, so we're seeing\nboth of their return values. However, this can be customized, with the\n``collector`` argument to ``upon``\\ ; the ``collector`` is a callable which takes an\niterable of all the outputs' return values and \"collects\" a single return value\nto return to the caller of the state machine.\n\nIn this case, we only care about the last output, so we can adjust the call to\n``upon`` like this:\n\n.. code-block:: python\n\n have_beans.upon(brew_button, enter=dont_have_beans,\n outputs=[_heat_the_heating_element,\n _describe_coffee],\n collector=lambda iterable: list(iterable)[-1]\n )\n\nAnd now, we'll get just the return value we want:\n\n.. code-block:: python\n\n >>> coffee_machine.brew_button()\n 'A cup of coffee made with real good beans.'\n\nIf I can't get the state of the state machine, how can I save it to (a database, an API response, a file on disk...)\n--------------------------------------------------------------------------------------------------------------------\n\nThere are APIs for serializing the state machine.\n\nFirst, you have to decide on a persistent representation of each state, via the\n``serialized=`` argument to the ``MethodicalMachine.state()`` decorator.\n\nLet's take this very simple \"light switch\" state machine, which can be on or\noff, and flipped to reverse its state:\n\n.. code-block:: python\n\n class LightSwitch(object):\n _machine = MethodicalMachine()\n @_machine.state(serialized=\"on\")\n def on_state(self):\n \"the switch is on\"\n @_machine.state(serialized=\"off\", initial=True)\n def off_state(self):\n \"the switch is off\"\n @_machine.input()\n def flip(self):\n \"flip the switch\"\n on_state.upon(flip, enter=off_state, outputs=[])\n off_state.upon(flip, enter=on_state, outputs=[])\n\nIn this case, we've chosen a serialized representation for each state via the\n``serialized`` argument. The on state is represented by the string ``\"on\"``\\ , and\nthe off state is represented by the string ``\"off\"``.\n\nNow, let's just add an input that lets us tell if the switch is on or not.\n\n.. code-block:: python\n\n @_machine.input()\n def query_power(self):\n \"return True if powered, False otherwise\"\n @_machine.output()\n def _is_powered(self):\n return True\n @_machine.output()\n def _not_powered(self):\n return False\n on_state.upon(query_power, enter=on_state, outputs=[_is_powered],\n collector=next)\n off_state.upon(query_power, enter=off_state, outputs=[_not_powered],\n collector=next)\n\nTo save the state, we have the ``MethodicalMachine.serializer()`` method. A\nmethod decorated with ``@serializer()`` gets an extra argument injected at the\nbeginning of its argument list: the serialized identifier for the state. In\nthis case, either ``\"on\"`` or ``\"off\"``. Since state machine output methods can\nalso affect other state on the object, a serializer method is expected to\nreturn *all* relevant state for serialization.\n\nFor our simple light switch, such a method might look like this:\n\n.. code-block:: python\n\n @_machine.serializer()\n def save(self, state):\n return {\"is-it-on\": state}\n\nSerializers can be public methods, and they can return whatever you like. If\nnecessary, you can have different serializers - just multiple methods decorated\nwith ``@_machine.serializer()`` - for different formats; return one data-structure\nfor JSON, one for XML, one for a database row, and so on.\n\nWhen it comes time to unserialize, though, you generally want a private method,\nbecause an unserializer has to take a not-fully-initialized instance and\npopulate it with state. It is expected to *return* the serialized machine\nstate token that was passed to the serializer, but it can take whatever\narguments you like. Of course, in order to return that, it probably has to\ntake it somewhere in its arguments, so it will generally take whatever a paired\nserializer has returned as an argument.\n\nSo our unserializer would look like this:\n\n.. code-block:: python\n\n @_machine.unserializer()\n def _restore(self, blob):\n return blob[\"is-it-on\"]\n\nGenerally you will want a classmethod deserialization constructor which you\nwrite yourself to call this, so that you know how to create an instance of your\nown object, like so:\n\n.. code-block:: python\n\n @classmethod\n def from_blob(cls, blob):\n self = cls()\n self._restore(blob)\n return self\n\nSaving and loading our ``LightSwitch`` along with its state-machine state can now\nbe accomplished as follows:\n\n.. code-block:: python\n\n >>> switch1 = LightSwitch()\n >>> switch1.query_power()\n False\n >>> switch1.flip()\n []\n >>> switch1.query_power()\n True\n >>> blob = switch1.save()\n >>> switch2 = LightSwitch.from_blob(blob)\n >>> switch2.query_power()\n True\n\nMore comprehensive (tested, working) examples are present in ``docs/examples``.\n\nGo forth and machine all the state!\n\n\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/Automat-0.8.0.dist-info/RECORD",
"content": "../../../bin/automat-visualize,sha256=VjaldkbEc5rfj7J6UEu5q63H4NX3pe_kve9ePk9txE0,283\r\nAutomat-0.8.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4\r\nAutomat-0.8.0.dist-info/LICENSE,sha256=siATAWeNCpN9k4VDgnyhNgcS6zTiPejuPzv_-9TA43Y,1053\r\nAutomat-0.8.0.dist-info/METADATA,sha256=IMGy5LioGR1j8VhvNYvnWPCGalDNx0WlqYU0ShTjOMc,17919\r\nAutomat-0.8.0.dist-info/RECORD,,\r\nAutomat-0.8.0.dist-info/WHEEL,sha256=8zNYZbwQSXoB9IfXOjPfeNwvAsALAjffgk27FqvCWbo,110\r\nAutomat-0.8.0.dist-info/entry_points.txt,sha256=i4tDM5qwy3v1KIN7ETS2XRVcHkThhkq7ZFTPuyP6BpA,63\r\nAutomat-0.8.0.dist-info/top_level.txt,sha256=vg4zAOyhP_3YCmpKZLNgFw1uMF3lC_b6TKsdz7jBSpI,8\r\nautomat/__init__.py,sha256=ec8PILBwt35xyzsstU9kx8p5ADi6KX9d1rBLZsocN_Y,169\r\nautomat/__pycache__/__init__.cpython-36.pyc,,\r\nautomat/__pycache__/_core.cpython-36.pyc,,\r\nautomat/__pycache__/_discover.cpython-36.pyc,,\r\nautomat/__pycache__/_introspection.cpython-36.pyc,,\r\nautomat/__pycache__/_methodical.cpython-36.pyc,,\r\nautomat/__pycache__/_visualize.cpython-36.pyc,,\r\nautomat/_core.py,sha256=IEtZHq3wsBZPX_VfMHMFy_uNjx1kfE11Qq-nmIXZe28,4819\r\nautomat/_discover.py,sha256=ye7NHLZkrwYsPmBpTIyJuJ-VRCmwkOUpA0is-A81z04,4367\r\nautomat/_introspection.py,sha256=i5UEGdj8lp2BnHnGeAyIwEyoN2gU1nXYg-ZPNX7oBbM,1274\r\nautomat/_methodical.py,sha256=AEWagTYaAF8PCXsYoQRYeRn07Jg5fdKDFuAlPvGYHUM,15932\r\nautomat/_test/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0\r\nautomat/_test/__pycache__/__init__.cpython-36.pyc,,\r\nautomat/_test/__pycache__/test_core.cpython-36.pyc,,\r\nautomat/_test/__pycache__/test_discover.cpython-36.pyc,,\r\nautomat/_test/__pycache__/test_methodical.cpython-36.pyc,,\r\nautomat/_test/__pycache__/test_trace.cpython-36.pyc,,\r\nautomat/_test/__pycache__/test_visualize.cpython-36.pyc,,\r\nautomat/_test/test_core.py,sha256=CDmGBQNi9Pr7ZktfBcOhBvwI7wjLLYRtWZ0P5baXONY,2833\r\nautomat/_test/test_discover.py,sha256=O9ndAdRAC8uO0uDhioz3e45EsJCF19jQZESj0RBC7ZM,21846\r\nautomat/_test/test_methodical.py,sha256=t1CAKtT1fs-FoKMQxXl4ky6_6pgpG7lGDbyQrb_vIeo,18856\r\nautomat/_test/test_trace.py,sha256=Mx1B8QgaE7QFk6blTie2j-Vx95hTV-zySnlxLalt8ek,3279\r\nautomat/_test/test_visualize.py,sha256=8ErNYxovTiDyZkYkoP1BcyEazU_s0YQ3NHdfH9OihAg,13744\r\nautomat/_visualize.py,sha256=jY8HkzaGdMoXB7LavvaneW4GdtBN6PRShl7-4OXDvss,6335\r\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/Automat-0.8.0.dist-info/WHEEL",
"content": "Wheel-Version: 1.0\nGenerator: bdist_wheel (0.33.6)\nRoot-Is-Purelib: true\nTag: py2-none-any\nTag: py3-none-any\n\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/Automat-0.8.0.dist-info/entry_points.txt",
"content": "[console_scripts]\nautomat-visualize = automat._visualize:tool\n\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/Automat-0.8.0.dist-info/top_level.txt",
"content": "automat\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/OpenSSL/SSL.py",
"content": "import os\nimport socket\nfrom sys import platform\nfrom functools import wraps, partial\nfrom itertools import count, chain\nfrom weakref import WeakValueDictionary\nfrom errno import errorcode\n\nfrom cryptography.utils import deprecated\n\nfrom six import (\n binary_type as _binary_type, integer_types as integer_types, int2byte,\n indexbytes)\n\nfrom OpenSSL._util import (\n UNSPECIFIED as _UNSPECIFIED,\n exception_from_error_queue as _exception_from_error_queue,\n ffi as _ffi,\n lib as _lib,\n make_assert as _make_assert,\n native as _native,\n path_string as _path_string,\n text_to_bytes_and_warn as _text_to_bytes_and_warn,\n no_zero_allocator as _no_zero_allocator,\n)\n\nfrom OpenSSL.crypto import (\n FILETYPE_PEM, _PassphraseHelper, PKey, X509Name, X509, X509Store)\n\n__all__ = [\n 'OPENSSL_VERSION_NUMBER',\n 'SSLEAY_VERSION',\n 'SSLEAY_CFLAGS',\n 'SSLEAY_PLATFORM',\n 'SSLEAY_DIR',\n 'SSLEAY_BUILT_ON',\n 'SENT_SHUTDOWN',\n 'RECEIVED_SHUTDOWN',\n 'SSLv2_METHOD',\n 'SSLv3_METHOD',\n 'SSLv23_METHOD',\n 'TLSv1_METHOD',\n 'TLSv1_1_METHOD',\n 'TLSv1_2_METHOD',\n 'OP_NO_SSLv2',\n 'OP_NO_SSLv3',\n 'OP_NO_TLSv1',\n 'OP_NO_TLSv1_1',\n 'OP_NO_TLSv1_2',\n 'MODE_RELEASE_BUFFERS',\n 'OP_SINGLE_DH_USE',\n 'OP_SINGLE_ECDH_USE',\n 'OP_EPHEMERAL_RSA',\n 'OP_MICROSOFT_SESS_ID_BUG',\n 'OP_NETSCAPE_CHALLENGE_BUG',\n 'OP_NETSCAPE_REUSE_CIPHER_CHANGE_BUG',\n 'OP_SSLREF2_REUSE_CERT_TYPE_BUG',\n 'OP_MICROSOFT_BIG_SSLV3_BUFFER',\n 'OP_MSIE_SSLV2_RSA_PADDING',\n 'OP_SSLEAY_080_CLIENT_DH_BUG',\n 'OP_TLS_D5_BUG',\n 'OP_TLS_BLOCK_PADDING_BUG',\n 'OP_DONT_INSERT_EMPTY_FRAGMENTS',\n 'OP_CIPHER_SERVER_PREFERENCE',\n 'OP_TLS_ROLLBACK_BUG',\n 'OP_PKCS1_CHECK_1',\n 'OP_PKCS1_CHECK_2',\n 'OP_NETSCAPE_CA_DN_BUG',\n 'OP_NETSCAPE_DEMO_CIPHER_CHANGE_BUG',\n 'OP_NO_COMPRESSION',\n 'OP_NO_QUERY_MTU',\n 'OP_COOKIE_EXCHANGE',\n 'OP_NO_TICKET',\n 'OP_ALL',\n 'VERIFY_PEER',\n 'VERIFY_FAIL_IF_NO_PEER_CERT',\n 'VERIFY_CLIENT_ONCE',\n 'VERIFY_NONE',\n 'SESS_CACHE_OFF',\n 'SESS_CACHE_CLIENT',\n 'SESS_CACHE_SERVER',\n 'SESS_CACHE_BOTH',\n 'SESS_CACHE_NO_AUTO_CLEAR',\n 'SESS_CACHE_NO_INTERNAL_LOOKUP',\n 'SESS_CACHE_NO_INTERNAL_STORE',\n 'SESS_CACHE_NO_INTERNAL',\n 'SSL_ST_CONNECT',\n 'SSL_ST_ACCEPT',\n 'SSL_ST_MASK',\n 'SSL_CB_LOOP',\n 'SSL_CB_EXIT',\n 'SSL_CB_READ',\n 'SSL_CB_WRITE',\n 'SSL_CB_ALERT',\n 'SSL_CB_READ_ALERT',\n 'SSL_CB_WRITE_ALERT',\n 'SSL_CB_ACCEPT_LOOP',\n 'SSL_CB_ACCEPT_EXIT',\n 'SSL_CB_CONNECT_LOOP',\n 'SSL_CB_CONNECT_EXIT',\n 'SSL_CB_HANDSHAKE_START',\n 'SSL_CB_HANDSHAKE_DONE',\n 'Error',\n 'WantReadError',\n 'WantWriteError',\n 'WantX509LookupError',\n 'ZeroReturnError',\n 'SysCallError',\n 'SSLeay_version',\n 'Session',\n 'Context',\n 'Connection'\n]\n\ntry:\n _buffer = buffer\nexcept NameError:\n class _buffer(object):\n pass\n\nOPENSSL_VERSION_NUMBER = _lib.OPENSSL_VERSION_NUMBER\nSSLEAY_VERSION = _lib.SSLEAY_VERSION\nSSLEAY_CFLAGS = _lib.SSLEAY_CFLAGS\nSSLEAY_PLATFORM = _lib.SSLEAY_PLATFORM\nSSLEAY_DIR = _lib.SSLEAY_DIR\nSSLEAY_BUILT_ON = _lib.SSLEAY_BUILT_ON\n\nSENT_SHUTDOWN = _lib.SSL_SENT_SHUTDOWN\nRECEIVED_SHUTDOWN = _lib.SSL_RECEIVED_SHUTDOWN\n\nSSLv2_METHOD = 1\nSSLv3_METHOD = 2\nSSLv23_METHOD = 3\nTLSv1_METHOD = 4\nTLSv1_1_METHOD = 5\nTLSv1_2_METHOD = 6\n\nOP_NO_SSLv2 = _lib.SSL_OP_NO_SSLv2\nOP_NO_SSLv3 = _lib.SSL_OP_NO_SSLv3\nOP_NO_TLSv1 = _lib.SSL_OP_NO_TLSv1\nOP_NO_TLSv1_1 = _lib.SSL_OP_NO_TLSv1_1\nOP_NO_TLSv1_2 = _lib.SSL_OP_NO_TLSv1_2\n\nMODE_RELEASE_BUFFERS = _lib.SSL_MODE_RELEASE_BUFFERS\n\nOP_SINGLE_DH_USE = _lib.SSL_OP_SINGLE_DH_USE\nOP_SINGLE_ECDH_USE = _lib.SSL_OP_SINGLE_ECDH_USE\nOP_EPHEMERAL_RSA = _lib.SSL_OP_EPHEMERAL_RSA\nOP_MICROSOFT_SESS_ID_BUG = _lib.SSL_OP_MICROSOFT_SESS_ID_BUG\nOP_NETSCAPE_CHALLENGE_BUG = _lib.SSL_OP_NETSCAPE_CHALLENGE_BUG\nOP_NETSCAPE_REUSE_CIPHER_CHANGE_BUG = (\n _lib.SSL_OP_NETSCAPE_REUSE_CIPHER_CHANGE_BUG\n)\nOP_SSLREF2_REUSE_CERT_TYPE_BUG = _lib.SSL_OP_SSLREF2_REUSE_CERT_TYPE_BUG\nOP_MICROSOFT_BIG_SSLV3_BUFFER = _lib.SSL_OP_MICROSOFT_BIG_SSLV3_BUFFER\nOP_MSIE_SSLV2_RSA_PADDING = _lib.SSL_OP_MSIE_SSLV2_RSA_PADDING\nOP_SSLEAY_080_CLIENT_DH_BUG = _lib.SSL_OP_SSLEAY_080_CLIENT_DH_BUG\nOP_TLS_D5_BUG = _lib.SSL_OP_TLS_D5_BUG\nOP_TLS_BLOCK_PADDING_BUG = _lib.SSL_OP_TLS_BLOCK_PADDING_BUG\nOP_DONT_INSERT_EMPTY_FRAGMENTS = _lib.SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS\nOP_CIPHER_SERVER_PREFERENCE = _lib.SSL_OP_CIPHER_SERVER_PREFERENCE\nOP_TLS_ROLLBACK_BUG = _lib.SSL_OP_TLS_ROLLBACK_BUG\nOP_PKCS1_CHECK_1 = _lib.SSL_OP_PKCS1_CHECK_1\nOP_PKCS1_CHECK_2 = _lib.SSL_OP_PKCS1_CHECK_2\nOP_NETSCAPE_CA_DN_BUG = _lib.SSL_OP_NETSCAPE_CA_DN_BUG\nOP_NETSCAPE_DEMO_CIPHER_CHANGE_BUG = (\n _lib.SSL_OP_NETSCAPE_DEMO_CIPHER_CHANGE_BUG\n)\nOP_NO_COMPRESSION = _lib.SSL_OP_NO_COMPRESSION\n\nOP_NO_QUERY_MTU = _lib.SSL_OP_NO_QUERY_MTU\nOP_COOKIE_EXCHANGE = _lib.SSL_OP_COOKIE_EXCHANGE\nOP_NO_TICKET = _lib.SSL_OP_NO_TICKET\n\nOP_ALL = _lib.SSL_OP_ALL\n\nVERIFY_PEER = _lib.SSL_VERIFY_PEER\nVERIFY_FAIL_IF_NO_PEER_CERT = _lib.SSL_VERIFY_FAIL_IF_NO_PEER_CERT\nVERIFY_CLIENT_ONCE = _lib.SSL_VERIFY_CLIENT_ONCE\nVERIFY_NONE = _lib.SSL_VERIFY_NONE\n\nSESS_CACHE_OFF = _lib.SSL_SESS_CACHE_OFF\nSESS_CACHE_CLIENT = _lib.SSL_SESS_CACHE_CLIENT\nSESS_CACHE_SERVER = _lib.SSL_SESS_CACHE_SERVER\nSESS_CACHE_BOTH = _lib.SSL_SESS_CACHE_BOTH\nSESS_CACHE_NO_AUTO_CLEAR = _lib.SSL_SESS_CACHE_NO_AUTO_CLEAR\nSESS_CACHE_NO_INTERNAL_LOOKUP = _lib.SSL_SESS_CACHE_NO_INTERNAL_LOOKUP\nSESS_CACHE_NO_INTERNAL_STORE = _lib.SSL_SESS_CACHE_NO_INTERNAL_STORE\nSESS_CACHE_NO_INTERNAL = _lib.SSL_SESS_CACHE_NO_INTERNAL\n\nSSL_ST_CONNECT = _lib.SSL_ST_CONNECT\nSSL_ST_ACCEPT = _lib.SSL_ST_ACCEPT\nSSL_ST_MASK = _lib.SSL_ST_MASK\nif _lib.Cryptography_HAS_SSL_ST:\n SSL_ST_INIT = _lib.SSL_ST_INIT\n SSL_ST_BEFORE = _lib.SSL_ST_BEFORE\n SSL_ST_OK = _lib.SSL_ST_OK\n SSL_ST_RENEGOTIATE = _lib.SSL_ST_RENEGOTIATE\n __all__.extend([\n 'SSL_ST_INIT',\n 'SSL_ST_BEFORE',\n 'SSL_ST_OK',\n 'SSL_ST_RENEGOTIATE',\n ])\n\nSSL_CB_LOOP = _lib.SSL_CB_LOOP\nSSL_CB_EXIT = _lib.SSL_CB_EXIT\nSSL_CB_READ = _lib.SSL_CB_READ\nSSL_CB_WRITE = _lib.SSL_CB_WRITE\nSSL_CB_ALERT = _lib.SSL_CB_ALERT\nSSL_CB_READ_ALERT = _lib.SSL_CB_READ_ALERT\nSSL_CB_WRITE_ALERT = _lib.SSL_CB_WRITE_ALERT\nSSL_CB_ACCEPT_LOOP = _lib.SSL_CB_ACCEPT_LOOP\nSSL_CB_ACCEPT_EXIT = _lib.SSL_CB_ACCEPT_EXIT\nSSL_CB_CONNECT_LOOP = _lib.SSL_CB_CONNECT_LOOP\nSSL_CB_CONNECT_EXIT = _lib.SSL_CB_CONNECT_EXIT\nSSL_CB_HANDSHAKE_START = _lib.SSL_CB_HANDSHAKE_START\nSSL_CB_HANDSHAKE_DONE = _lib.SSL_CB_HANDSHAKE_DONE\n\n# Taken from https://golang.org/src/crypto/x509/root_linux.go\n_CERTIFICATE_FILE_LOCATIONS = [\n \"/etc/ssl/certs/ca-certificates.crt\", # Debian/Ubuntu/Gentoo etc.\n \"/etc/pki/tls/certs/ca-bundle.crt\", # Fedora/RHEL 6\n \"/etc/ssl/ca-bundle.pem\", # OpenSUSE\n \"/etc/pki/tls/cacert.pem\", # OpenELEC\n \"/etc/pki/ca-trust/extracted/pem/tls-ca-bundle.pem\", # CentOS/RHEL 7\n]\n\n_CERTIFICATE_PATH_LOCATIONS = [\n \"/etc/ssl/certs\", # SLES10/SLES11\n]\n\n# These values are compared to output from cffi's ffi.string so they must be\n# byte strings.\n_CRYPTOGRAPHY_MANYLINUX1_CA_DIR = b\"/opt/pyca/cryptography/openssl/certs\"\n_CRYPTOGRAPHY_MANYLINUX1_CA_FILE = b\"/opt/pyca/cryptography/openssl/cert.pem\"\n\n\nclass Error(Exception):\n \"\"\"\n An error occurred in an `OpenSSL.SSL` API.\n \"\"\"\n\n\n_raise_current_error = partial(_exception_from_error_queue, Error)\n_openssl_assert = _make_assert(Error)\n\n\nclass WantReadError(Error):\n pass\n\n\nclass WantWriteError(Error):\n pass\n\n\nclass WantX509LookupError(Error):\n pass\n\n\nclass ZeroReturnError(Error):\n pass\n\n\nclass SysCallError(Error):\n pass\n\n\nclass _CallbackExceptionHelper(object):\n \"\"\"\n A base class for wrapper classes that allow for intelligent exception\n handling in OpenSSL callbacks.\n\n :ivar list _problems: Any exceptions that occurred while executing in a\n context where they could not be raised in the normal way. Typically\n this is because OpenSSL has called into some Python code and requires a\n return value. The exceptions are saved to be raised later when it is\n possible to do so.\n \"\"\"\n\n def __init__(self):\n self._problems = []\n\n def raise_if_problem(self):\n \"\"\"\n Raise an exception from the OpenSSL error queue or that was previously\n captured whe running a callback.\n \"\"\"\n if self._problems:\n try:\n _raise_current_error()\n except Error:\n pass\n raise self._problems.pop(0)\n\n\nclass _VerifyHelper(_CallbackExceptionHelper):\n \"\"\"\n Wrap a callback such that it can be used as a certificate verification\n callback.\n \"\"\"\n\n def __init__(self, callback):\n _CallbackExceptionHelper.__init__(self)\n\n @wraps(callback)\n def wrapper(ok, store_ctx):\n x509 = _lib.X509_STORE_CTX_get_current_cert(store_ctx)\n _lib.X509_up_ref(x509)\n cert = X509._from_raw_x509_ptr(x509)\n error_number = _lib.X509_STORE_CTX_get_error(store_ctx)\n error_depth = _lib.X509_STORE_CTX_get_error_depth(store_ctx)\n\n index = _lib.SSL_get_ex_data_X509_STORE_CTX_idx()\n ssl = _lib.X509_STORE_CTX_get_ex_data(store_ctx, index)\n connection = Connection._reverse_mapping[ssl]\n\n try:\n result = callback(\n connection, cert, error_number, error_depth, ok\n )\n except Exception as e:\n self._problems.append(e)\n return 0\n else:\n if result:\n _lib.X509_STORE_CTX_set_error(store_ctx, _lib.X509_V_OK)\n return 1\n else:\n return 0\n\n self.callback = _ffi.callback(\n \"int (*)(int, X509_STORE_CTX *)\", wrapper)\n\n\nclass _NpnAdvertiseHelper(_CallbackExceptionHelper):\n \"\"\"\n Wrap a callback such that it can be used as an NPN advertisement callback.\n \"\"\"\n\n def __init__(self, callback):\n _CallbackExceptionHelper.__init__(self)\n\n @wraps(callback)\n def wrapper(ssl, out, outlen, arg):\n try:\n conn = Connection._reverse_mapping[ssl]\n protos = callback(conn)\n\n # Join the protocols into a Python bytestring, length-prefixing\n # each element.\n protostr = b''.join(\n chain.from_iterable((int2byte(len(p)), p) for p in protos)\n )\n\n # Save our callback arguments on the connection object. This is\n # done to make sure that they don't get freed before OpenSSL\n # uses them. Then, return them appropriately in the output\n # parameters.\n conn._npn_advertise_callback_args = [\n _ffi.new(\"unsigned int *\", len(protostr)),\n _ffi.new(\"unsigned char[]\", protostr),\n ]\n outlen[0] = conn._npn_advertise_callback_args[0][0]\n out[0] = conn._npn_advertise_callback_args[1]\n return 0\n except Exception as e:\n self._problems.append(e)\n return 2 # SSL_TLSEXT_ERR_ALERT_FATAL\n\n self.callback = _ffi.callback(\n \"int (*)(SSL *, const unsigned char **, unsigned int *, void *)\",\n wrapper\n )\n\n\nclass _NpnSelectHelper(_CallbackExceptionHelper):\n \"\"\"\n Wrap a callback such that it can be used as an NPN selection callback.\n \"\"\"\n\n def __init__(self, callback):\n _CallbackExceptionHelper.__init__(self)\n\n @wraps(callback)\n def wrapper(ssl, out, outlen, in_, inlen, arg):\n try:\n conn = Connection._reverse_mapping[ssl]\n\n # The string passed to us is actually made up of multiple\n # length-prefixed bytestrings. We need to split that into a\n # list.\n instr = _ffi.buffer(in_, inlen)[:]\n protolist = []\n while instr:\n length = indexbytes(instr, 0)\n proto = instr[1:length + 1]\n protolist.append(proto)\n instr = instr[length + 1:]\n\n # Call the callback\n outstr = callback(conn, protolist)\n\n # Save our callback arguments on the connection object. This is\n # done to make sure that they don't get freed before OpenSSL\n # uses them. Then, return them appropriately in the output\n # parameters.\n conn._npn_select_callback_args = [\n _ffi.new(\"unsigned char *\", len(outstr)),\n _ffi.new(\"unsigned char[]\", outstr),\n ]\n outlen[0] = conn._npn_select_callback_args[0][0]\n out[0] = conn._npn_select_callback_args[1]\n return 0\n except Exception as e:\n self._problems.append(e)\n return 2 # SSL_TLSEXT_ERR_ALERT_FATAL\n\n self.callback = _ffi.callback(\n (\"int (*)(SSL *, unsigned char **, unsigned char *, \"\n \"const unsigned char *, unsigned int, void *)\"),\n wrapper\n )\n\n\nclass _ALPNSelectHelper(_CallbackExceptionHelper):\n \"\"\"\n Wrap a callback such that it can be used as an ALPN selection callback.\n \"\"\"\n\n def __init__(self, callback):\n _CallbackExceptionHelper.__init__(self)\n\n @wraps(callback)\n def wrapper(ssl, out, outlen, in_, inlen, arg):\n try:\n conn = Connection._reverse_mapping[ssl]\n\n # The string passed to us is made up of multiple\n # length-prefixed bytestrings. We need to split that into a\n # list.\n instr = _ffi.buffer(in_, inlen)[:]\n protolist = []\n while instr:\n encoded_len = indexbytes(instr, 0)\n proto = instr[1:encoded_len + 1]\n protolist.append(proto)\n instr = instr[encoded_len + 1:]\n\n # Call the callback\n outstr = callback(conn, protolist)\n\n if not isinstance(outstr, _binary_type):\n raise TypeError(\"ALPN callback must return a bytestring.\")\n\n # Save our callback arguments on the connection object to make\n # sure that they don't get freed before OpenSSL can use them.\n # Then, return them in the appropriate output parameters.\n conn._alpn_select_callback_args = [\n _ffi.new(\"unsigned char *\", len(outstr)),\n _ffi.new(\"unsigned char[]\", outstr),\n ]\n outlen[0] = conn._alpn_select_callback_args[0][0]\n out[0] = conn._alpn_select_callback_args[1]\n return 0\n except Exception as e:\n self._problems.append(e)\n return 2 # SSL_TLSEXT_ERR_ALERT_FATAL\n\n self.callback = _ffi.callback(\n (\"int (*)(SSL *, unsigned char **, unsigned char *, \"\n \"const unsigned char *, unsigned int, void *)\"),\n wrapper\n )\n\n\nclass _OCSPServerCallbackHelper(_CallbackExceptionHelper):\n \"\"\"\n Wrap a callback such that it can be used as an OCSP callback for the server\n side.\n\n Annoyingly, OpenSSL defines one OCSP callback but uses it in two different\n ways. For servers, that callback is expected to retrieve some OCSP data and\n hand it to OpenSSL, and may return only SSL_TLSEXT_ERR_OK,\n SSL_TLSEXT_ERR_FATAL, and SSL_TLSEXT_ERR_NOACK. For clients, that callback\n is expected to check the OCSP data, and returns a negative value on error,\n 0 if the response is not acceptable, or positive if it is. These are\n mutually exclusive return code behaviours, and they mean that we need two\n helpers so that we always return an appropriate error code if the user's\n code throws an exception.\n\n Given that we have to have two helpers anyway, these helpers are a bit more\n helpery than most: specifically, they hide a few more of the OpenSSL\n functions so that the user has an easier time writing these callbacks.\n\n This helper implements the server side.\n \"\"\"\n\n def __init__(self, callback):\n _CallbackExceptionHelper.__init__(self)\n\n @wraps(callback)\n def wrapper(ssl, cdata):\n try:\n conn = Connection._reverse_mapping[ssl]\n\n # Extract the data if any was provided.\n if cdata != _ffi.NULL:\n data = _ffi.from_handle(cdata)\n else:\n data = None\n\n # Call the callback.\n ocsp_data = callback(conn, data)\n\n if not isinstance(ocsp_data, _binary_type):\n raise TypeError(\"OCSP callback must return a bytestring.\")\n\n # If the OCSP data was provided, we will pass it to OpenSSL.\n # However, we have an early exit here: if no OCSP data was\n # provided we will just exit out and tell OpenSSL that there\n # is nothing to do.\n if not ocsp_data:\n return 3 # SSL_TLSEXT_ERR_NOACK\n\n # OpenSSL takes ownership of this data and expects it to have\n # been allocated by OPENSSL_malloc.\n ocsp_data_length = len(ocsp_data)\n data_ptr = _lib.OPENSSL_malloc(ocsp_data_length)\n _ffi.buffer(data_ptr, ocsp_data_length)[:] = ocsp_data\n\n _lib.SSL_set_tlsext_status_ocsp_resp(\n ssl, data_ptr, ocsp_data_length\n )\n\n return 0\n except Exception as e:\n self._problems.append(e)\n return 2 # SSL_TLSEXT_ERR_ALERT_FATAL\n\n self.callback = _ffi.callback(\"int (*)(SSL *, void *)\", wrapper)\n\n\nclass _OCSPClientCallbackHelper(_CallbackExceptionHelper):\n \"\"\"\n Wrap a callback such that it can be used as an OCSP callback for the client\n side.\n\n Annoyingly, OpenSSL defines one OCSP callback but uses it in two different\n ways. For servers, that callback is expected to retrieve some OCSP data and\n hand it to OpenSSL, and may return only SSL_TLSEXT_ERR_OK,\n SSL_TLSEXT_ERR_FATAL, and SSL_TLSEXT_ERR_NOACK. For clients, that callback\n is expected to check the OCSP data, and returns a negative value on error,\n 0 if the response is not acceptable, or positive if it is. These are\n mutually exclusive return code behaviours, and they mean that we need two\n helpers so that we always return an appropriate error code if the user's\n code throws an exception.\n\n Given that we have to have two helpers anyway, these helpers are a bit more\n helpery than most: specifically, they hide a few more of the OpenSSL\n functions so that the user has an easier time writing these callbacks.\n\n This helper implements the client side.\n \"\"\"\n\n def __init__(self, callback):\n _CallbackExceptionHelper.__init__(self)\n\n @wraps(callback)\n def wrapper(ssl, cdata):\n try:\n conn = Connection._reverse_mapping[ssl]\n\n # Extract the data if any was provided.\n if cdata != _ffi.NULL:\n data = _ffi.from_handle(cdata)\n else:\n data = None\n\n # Get the OCSP data.\n ocsp_ptr = _ffi.new(\"unsigned char **\")\n ocsp_len = _lib.SSL_get_tlsext_status_ocsp_resp(ssl, ocsp_ptr)\n if ocsp_len < 0:\n # No OCSP data.\n ocsp_data = b''\n else:\n # Copy the OCSP data, then pass it to the callback.\n ocsp_data = _ffi.buffer(ocsp_ptr[0], ocsp_len)[:]\n\n valid = callback(conn, ocsp_data, data)\n\n # Return 1 on success or 0 on error.\n return int(bool(valid))\n\n except Exception as e:\n self._problems.append(e)\n # Return negative value if an exception is hit.\n return -1\n\n self.callback = _ffi.callback(\"int (*)(SSL *, void *)\", wrapper)\n\n\ndef _asFileDescriptor(obj):\n fd = None\n if not isinstance(obj, integer_types):\n meth = getattr(obj, \"fileno\", None)\n if meth is not None:\n obj = meth()\n\n if isinstance(obj, integer_types):\n fd = obj\n\n if not isinstance(fd, integer_types):\n raise TypeError(\"argument must be an int, or have a fileno() method.\")\n elif fd < 0:\n raise ValueError(\n \"file descriptor cannot be a negative integer (%i)\" % (fd,))\n\n return fd\n\n\ndef SSLeay_version(type):\n \"\"\"\n Return a string describing the version of OpenSSL in use.\n\n :param type: One of the :const:`SSLEAY_` constants defined in this module.\n \"\"\"\n return _ffi.string(_lib.SSLeay_version(type))\n\n\ndef _make_requires(flag, error):\n \"\"\"\n Builds a decorator that ensures that functions that rely on OpenSSL\n functions that are not present in this build raise NotImplementedError,\n rather than AttributeError coming out of cryptography.\n\n :param flag: A cryptography flag that guards the functions, e.g.\n ``Cryptography_HAS_NEXTPROTONEG``.\n :param error: The string to be used in the exception if the flag is false.\n \"\"\"\n def _requires_decorator(func):\n if not flag:\n @wraps(func)\n def explode(*args, **kwargs):\n raise NotImplementedError(error)\n return explode\n else:\n return func\n\n return _requires_decorator\n\n\n_requires_npn = _make_requires(\n _lib.Cryptography_HAS_NEXTPROTONEG, \"NPN not available\"\n)\n\n\n_requires_alpn = _make_requires(\n _lib.Cryptography_HAS_ALPN, \"ALPN not available\"\n)\n\n\n_requires_sni = _make_requires(\n _lib.Cryptography_HAS_TLSEXT_HOSTNAME, \"SNI not available\"\n)\n\n\nclass Session(object):\n \"\"\"\n A class representing an SSL session. A session defines certain connection\n parameters which may be re-used to speed up the setup of subsequent\n connections.\n\n .. versionadded:: 0.14\n \"\"\"\n pass\n\n\nclass Context(object):\n \"\"\"\n :class:`OpenSSL.SSL.Context` instances define the parameters for setting\n up new SSL connections.\n\n :param method: One of SSLv2_METHOD, SSLv3_METHOD, SSLv23_METHOD, or\n TLSv1_METHOD.\n \"\"\"\n _methods = {\n SSLv2_METHOD: \"SSLv2_method\",\n SSLv3_METHOD: \"SSLv3_method\",\n SSLv23_METHOD: \"SSLv23_method\",\n TLSv1_METHOD: \"TLSv1_method\",\n TLSv1_1_METHOD: \"TLSv1_1_method\",\n TLSv1_2_METHOD: \"TLSv1_2_method\",\n }\n _methods = dict(\n (identifier, getattr(_lib, name))\n for (identifier, name) in _methods.items()\n if getattr(_lib, name, None) is not None)\n\n def __init__(self, method):\n if not isinstance(method, integer_types):\n raise TypeError(\"method must be an integer\")\n\n try:\n method_func = self._methods[method]\n except KeyError:\n raise ValueError(\"No such protocol\")\n\n method_obj = method_func()\n _openssl_assert(method_obj != _ffi.NULL)\n\n context = _lib.SSL_CTX_new(method_obj)\n _openssl_assert(context != _ffi.NULL)\n context = _ffi.gc(context, _lib.SSL_CTX_free)\n\n # If SSL_CTX_set_ecdh_auto is available then set it so the ECDH curve\n # will be auto-selected. This function was added in 1.0.2 and made a\n # noop in 1.1.0+ (where it is set automatically).\n try:\n res = _lib.SSL_CTX_set_ecdh_auto(context, 1)\n _openssl_assert(res == 1)\n except AttributeError:\n pass\n\n self._context = context\n self._passphrase_helper = None\n self._passphrase_callback = None\n self._passphrase_userdata = None\n self._verify_helper = None\n self._verify_callback = None\n self._info_callback = None\n self._tlsext_servername_callback = None\n self._app_data = None\n self._npn_advertise_helper = None\n self._npn_advertise_callback = None\n self._npn_select_helper = None\n self._npn_select_callback = None\n self._alpn_select_helper = None\n self._alpn_select_callback = None\n self._ocsp_helper = None\n self._ocsp_callback = None\n self._ocsp_data = None\n\n self.set_mode(_lib.SSL_MODE_ENABLE_PARTIAL_WRITE)\n\n def load_verify_locations(self, cafile, capath=None):\n \"\"\"\n Let SSL know where we can find trusted certificates for the certificate\n chain. Note that the certificates have to be in PEM format.\n\n If capath is passed, it must be a directory prepared using the\n ``c_rehash`` tool included with OpenSSL. Either, but not both, of\n *pemfile* or *capath* may be :data:`None`.\n\n :param cafile: In which file we can find the certificates (``bytes`` or\n ``unicode``).\n :param capath: In which directory we can find the certificates\n (``bytes`` or ``unicode``).\n\n :return: None\n \"\"\"\n if cafile is None:\n cafile = _ffi.NULL\n else:\n cafile = _path_string(cafile)\n\n if capath is None:\n capath = _ffi.NULL\n else:\n capath = _path_string(capath)\n\n load_result = _lib.SSL_CTX_load_verify_locations(\n self._context, cafile, capath\n )\n if not load_result:\n _raise_current_error()\n\n def _wrap_callback(self, callback):\n @wraps(callback)\n def wrapper(size, verify, userdata):\n return callback(size, verify, self._passphrase_userdata)\n return _PassphraseHelper(\n FILETYPE_PEM, wrapper, more_args=True, truncate=True)\n\n def set_passwd_cb(self, callback, userdata=None):\n \"\"\"\n Set the passphrase callback. This function will be called\n when a private key with a passphrase is loaded.\n\n :param callback: The Python callback to use. This must accept three\n positional arguments. First, an integer giving the maximum length\n of the passphrase it may return. If the returned passphrase is\n longer than this, it will be truncated. Second, a boolean value\n which will be true if the user should be prompted for the\n passphrase twice and the callback should verify that the two values\n supplied are equal. Third, the value given as the *userdata*\n parameter to :meth:`set_passwd_cb`. The *callback* must return\n a byte string. If an error occurs, *callback* should return a false\n value (e.g. an empty string).\n :param userdata: (optional) A Python object which will be given as\n argument to the callback\n :return: None\n \"\"\"\n if not callable(callback):\n raise TypeError(\"callback must be callable\")\n\n self._passphrase_helper = self._wrap_callback(callback)\n self._passphrase_callback = self._passphrase_helper.callback\n _lib.SSL_CTX_set_default_passwd_cb(\n self._context, self._passphrase_callback)\n self._passphrase_userdata = userdata\n\n def set_default_verify_paths(self):\n \"\"\"\n Specify that the platform provided CA certificates are to be used for\n verification purposes. This method has some caveats related to the\n binary wheels that cryptography (pyOpenSSL's primary dependency) ships:\n\n * macOS will only load certificates using this method if the user has\n the ``openssl@1.1`` `Homebrew `_ formula installed\n in the default location.\n * Windows will not work.\n * manylinux1 cryptography wheels will work on most common Linux\n distributions in pyOpenSSL 17.1.0 and above. pyOpenSSL detects the\n manylinux1 wheel and attempts to load roots via a fallback path.\n\n :return: None\n \"\"\"\n # SSL_CTX_set_default_verify_paths will attempt to load certs from\n # both a cafile and capath that are set at compile time. However,\n # it will first check environment variables and, if present, load\n # those paths instead\n set_result = _lib.SSL_CTX_set_default_verify_paths(self._context)\n _openssl_assert(set_result == 1)\n # After attempting to set default_verify_paths we need to know whether\n # to go down the fallback path.\n # First we'll check to see if any env vars have been set. If so,\n # we won't try to do anything else because the user has set the path\n # themselves.\n dir_env_var = _ffi.string(\n _lib.X509_get_default_cert_dir_env()\n ).decode(\"ascii\")\n file_env_var = _ffi.string(\n _lib.X509_get_default_cert_file_env()\n ).decode(\"ascii\")\n if not self._check_env_vars_set(dir_env_var, file_env_var):\n default_dir = _ffi.string(_lib.X509_get_default_cert_dir())\n default_file = _ffi.string(_lib.X509_get_default_cert_file())\n # Now we check to see if the default_dir and default_file are set\n # to the exact values we use in our manylinux1 builds. If they are\n # then we know to load the fallbacks\n if (\n default_dir == _CRYPTOGRAPHY_MANYLINUX1_CA_DIR and\n default_file == _CRYPTOGRAPHY_MANYLINUX1_CA_FILE\n ):\n # This is manylinux1, let's load our fallback paths\n self._fallback_default_verify_paths(\n _CERTIFICATE_FILE_LOCATIONS,\n _CERTIFICATE_PATH_LOCATIONS\n )\n\n def _check_env_vars_set(self, dir_env_var, file_env_var):\n \"\"\"\n Check to see if the default cert dir/file environment vars are present.\n\n :return: bool\n \"\"\"\n return (\n os.environ.get(file_env_var) is not None or\n os.environ.get(dir_env_var) is not None\n )\n\n def _fallback_default_verify_paths(self, file_path, dir_path):\n \"\"\"\n Default verify paths are based on the compiled version of OpenSSL.\n However, when pyca/cryptography is compiled as a manylinux1 wheel\n that compiled location can potentially be wrong. So, like Go, we\n will try a predefined set of paths and attempt to load roots\n from there.\n\n :return: None\n \"\"\"\n for cafile in file_path:\n if os.path.isfile(cafile):\n self.load_verify_locations(cafile)\n break\n\n for capath in dir_path:\n if os.path.isdir(capath):\n self.load_verify_locations(None, capath)\n break\n\n def use_certificate_chain_file(self, certfile):\n \"\"\"\n Load a certificate chain from a file.\n\n :param certfile: The name of the certificate chain file (``bytes`` or\n ``unicode``). Must be PEM encoded.\n\n :return: None\n \"\"\"\n certfile = _path_string(certfile)\n\n result = _lib.SSL_CTX_use_certificate_chain_file(\n self._context, certfile\n )\n if not result:\n _raise_current_error()\n\n def use_certificate_file(self, certfile, filetype=FILETYPE_PEM):\n \"\"\"\n Load a certificate from a file\n\n :param certfile: The name of the certificate file (``bytes`` or\n ``unicode``).\n :param filetype: (optional) The encoding of the file, which is either\n :const:`FILETYPE_PEM` or :const:`FILETYPE_ASN1`. The default is\n :const:`FILETYPE_PEM`.\n\n :return: None\n \"\"\"\n certfile = _path_string(certfile)\n if not isinstance(filetype, integer_types):\n raise TypeError(\"filetype must be an integer\")\n\n use_result = _lib.SSL_CTX_use_certificate_file(\n self._context, certfile, filetype\n )\n if not use_result:\n _raise_current_error()\n\n def use_certificate(self, cert):\n \"\"\"\n Load a certificate from a X509 object\n\n :param cert: The X509 object\n :return: None\n \"\"\"\n if not isinstance(cert, X509):\n raise TypeError(\"cert must be an X509 instance\")\n\n use_result = _lib.SSL_CTX_use_certificate(self._context, cert._x509)\n if not use_result:\n _raise_current_error()\n\n def add_extra_chain_cert(self, certobj):\n \"\"\"\n Add certificate to chain\n\n :param certobj: The X509 certificate object to add to the chain\n :return: None\n \"\"\"\n if not isinstance(certobj, X509):\n raise TypeError(\"certobj must be an X509 instance\")\n\n copy = _lib.X509_dup(certobj._x509)\n add_result = _lib.SSL_CTX_add_extra_chain_cert(self._context, copy)\n if not add_result:\n # TODO: This is untested.\n _lib.X509_free(copy)\n _raise_current_error()\n\n def _raise_passphrase_exception(self):\n if self._passphrase_helper is not None:\n self._passphrase_helper.raise_if_problem(Error)\n\n _raise_current_error()\n\n def use_privatekey_file(self, keyfile, filetype=_UNSPECIFIED):\n \"\"\"\n Load a private key from a file\n\n :param keyfile: The name of the key file (``bytes`` or ``unicode``)\n :param filetype: (optional) The encoding of the file, which is either\n :const:`FILETYPE_PEM` or :const:`FILETYPE_ASN1`. The default is\n :const:`FILETYPE_PEM`.\n\n :return: None\n \"\"\"\n keyfile = _path_string(keyfile)\n\n if filetype is _UNSPECIFIED:\n filetype = FILETYPE_PEM\n elif not isinstance(filetype, integer_types):\n raise TypeError(\"filetype must be an integer\")\n\n use_result = _lib.SSL_CTX_use_PrivateKey_file(\n self._context, keyfile, filetype)\n if not use_result:\n self._raise_passphrase_exception()\n\n def use_privatekey(self, pkey):\n \"\"\"\n Load a private key from a PKey object\n\n :param pkey: The PKey object\n :return: None\n \"\"\"\n if not isinstance(pkey, PKey):\n raise TypeError(\"pkey must be a PKey instance\")\n\n use_result = _lib.SSL_CTX_use_PrivateKey(self._context, pkey._pkey)\n if not use_result:\n self._raise_passphrase_exception()\n\n def check_privatekey(self):\n \"\"\"\n Check if the private key (loaded with :meth:`use_privatekey`) matches\n the certificate (loaded with :meth:`use_certificate`)\n\n :return: :data:`None` (raises :exc:`Error` if something's wrong)\n \"\"\"\n if not _lib.SSL_CTX_check_private_key(self._context):\n _raise_current_error()\n\n def load_client_ca(self, cafile):\n \"\"\"\n Load the trusted certificates that will be sent to the client. Does\n not actually imply any of the certificates are trusted; that must be\n configured separately.\n\n :param bytes cafile: The path to a certificates file in PEM format.\n :return: None\n \"\"\"\n ca_list = _lib.SSL_load_client_CA_file(\n _text_to_bytes_and_warn(\"cafile\", cafile)\n )\n _openssl_assert(ca_list != _ffi.NULL)\n _lib.SSL_CTX_set_client_CA_list(self._context, ca_list)\n\n def set_session_id(self, buf):\n \"\"\"\n Set the session id to *buf* within which a session can be reused for\n this Context object. This is needed when doing session resumption,\n because there is no way for a stored session to know which Context\n object it is associated with.\n\n :param bytes buf: The session id.\n\n :returns: None\n \"\"\"\n buf = _text_to_bytes_and_warn(\"buf\", buf)\n _openssl_assert(\n _lib.SSL_CTX_set_session_id_context(\n self._context,\n buf,\n len(buf),\n ) == 1\n )\n\n def set_session_cache_mode(self, mode):\n \"\"\"\n Set the behavior of the session cache used by all connections using\n this Context. The previously set mode is returned. See\n :const:`SESS_CACHE_*` for details about particular modes.\n\n :param mode: One or more of the SESS_CACHE_* flags (combine using\n bitwise or)\n :returns: The previously set caching mode.\n\n .. versionadded:: 0.14\n \"\"\"\n if not isinstance(mode, integer_types):\n raise TypeError(\"mode must be an integer\")\n\n return _lib.SSL_CTX_set_session_cache_mode(self._context, mode)\n\n def get_session_cache_mode(self):\n \"\"\"\n Get the current session cache mode.\n\n :returns: The currently used cache mode.\n\n .. versionadded:: 0.14\n \"\"\"\n return _lib.SSL_CTX_get_session_cache_mode(self._context)\n\n def set_verify(self, mode, callback):\n \"\"\"\n et the verification flags for this Context object to *mode* and specify\n that *callback* should be used for verification callbacks.\n\n :param mode: The verify mode, this should be one of\n :const:`VERIFY_NONE` and :const:`VERIFY_PEER`. If\n :const:`VERIFY_PEER` is used, *mode* can be OR:ed with\n :const:`VERIFY_FAIL_IF_NO_PEER_CERT` and\n :const:`VERIFY_CLIENT_ONCE` to further control the behaviour.\n :param callback: The Python callback to use. This should take five\n arguments: A Connection object, an X509 object, and three integer\n variables, which are in turn potential error number, error depth\n and return code. *callback* should return True if verification\n passes and False otherwise.\n :return: None\n\n See SSL_CTX_set_verify(3SSL) for further details.\n \"\"\"\n if not isinstance(mode, integer_types):\n raise TypeError(\"mode must be an integer\")\n\n if not callable(callback):\n raise TypeError(\"callback must be callable\")\n\n self._verify_helper = _VerifyHelper(callback)\n self._verify_callback = self._verify_helper.callback\n _lib.SSL_CTX_set_verify(self._context, mode, self._verify_callback)\n\n def set_verify_depth(self, depth):\n \"\"\"\n Set the maximum depth for the certificate chain verification that shall\n be allowed for this Context object.\n\n :param depth: An integer specifying the verify depth\n :return: None\n \"\"\"\n if not isinstance(depth, integer_types):\n raise TypeError(\"depth must be an integer\")\n\n _lib.SSL_CTX_set_verify_depth(self._context, depth)\n\n def get_verify_mode(self):\n \"\"\"\n Retrieve the Context object's verify mode, as set by\n :meth:`set_verify`.\n\n :return: The verify mode\n \"\"\"\n return _lib.SSL_CTX_get_verify_mode(self._context)\n\n def get_verify_depth(self):\n \"\"\"\n Retrieve the Context object's verify depth, as set by\n :meth:`set_verify_depth`.\n\n :return: The verify depth\n \"\"\"\n return _lib.SSL_CTX_get_verify_depth(self._context)\n\n def load_tmp_dh(self, dhfile):\n \"\"\"\n Load parameters for Ephemeral Diffie-Hellman\n\n :param dhfile: The file to load EDH parameters from (``bytes`` or\n ``unicode``).\n\n :return: None\n \"\"\"\n dhfile = _path_string(dhfile)\n\n bio = _lib.BIO_new_file(dhfile, b\"r\")\n if bio == _ffi.NULL:\n _raise_current_error()\n bio = _ffi.gc(bio, _lib.BIO_free)\n\n dh = _lib.PEM_read_bio_DHparams(bio, _ffi.NULL, _ffi.NULL, _ffi.NULL)\n dh = _ffi.gc(dh, _lib.DH_free)\n _lib.SSL_CTX_set_tmp_dh(self._context, dh)\n\n def set_tmp_ecdh(self, curve):\n \"\"\"\n Select a curve to use for ECDHE key exchange.\n\n :param curve: A curve object to use as returned by either\n :meth:`OpenSSL.crypto.get_elliptic_curve` or\n :meth:`OpenSSL.crypto.get_elliptic_curves`.\n\n :return: None\n \"\"\"\n _lib.SSL_CTX_set_tmp_ecdh(self._context, curve._to_EC_KEY())\n\n def set_cipher_list(self, cipher_list):\n \"\"\"\n Set the list of ciphers to be used in this context.\n\n See the OpenSSL manual for more information (e.g.\n :manpage:`ciphers(1)`).\n\n :param bytes cipher_list: An OpenSSL cipher string.\n :return: None\n \"\"\"\n cipher_list = _text_to_bytes_and_warn(\"cipher_list\", cipher_list)\n\n if not isinstance(cipher_list, bytes):\n raise TypeError(\"cipher_list must be a byte string.\")\n\n _openssl_assert(\n _lib.SSL_CTX_set_cipher_list(self._context, cipher_list) == 1\n )\n # In OpenSSL 1.1.1 setting the cipher list will always return TLS 1.3\n # ciphers even if you pass an invalid cipher. Applications (like\n # Twisted) have tests that depend on an error being raised if an\n # invalid cipher string is passed, but without the following check\n # for the TLS 1.3 specific cipher suites it would never error.\n tmpconn = Connection(self, None)\n _openssl_assert(\n tmpconn.get_cipher_list() != [\n 'TLS_AES_256_GCM_SHA384',\n 'TLS_CHACHA20_POLY1305_SHA256',\n 'TLS_AES_128_GCM_SHA256'\n ]\n )\n\n def set_client_ca_list(self, certificate_authorities):\n \"\"\"\n Set the list of preferred client certificate signers for this server\n context.\n\n This list of certificate authorities will be sent to the client when\n the server requests a client certificate.\n\n :param certificate_authorities: a sequence of X509Names.\n :return: None\n\n .. versionadded:: 0.10\n \"\"\"\n name_stack = _lib.sk_X509_NAME_new_null()\n _openssl_assert(name_stack != _ffi.NULL)\n\n try:\n for ca_name in certificate_authorities:\n if not isinstance(ca_name, X509Name):\n raise TypeError(\n \"client CAs must be X509Name objects, not %s \"\n \"objects\" % (\n type(ca_name).__name__,\n )\n )\n copy = _lib.X509_NAME_dup(ca_name._name)\n _openssl_assert(copy != _ffi.NULL)\n push_result = _lib.sk_X509_NAME_push(name_stack, copy)\n if not push_result:\n _lib.X509_NAME_free(copy)\n _raise_current_error()\n except Exception:\n _lib.sk_X509_NAME_free(name_stack)\n raise\n\n _lib.SSL_CTX_set_client_CA_list(self._context, name_stack)\n\n def add_client_ca(self, certificate_authority):\n \"\"\"\n Add the CA certificate to the list of preferred signers for this\n context.\n\n The list of certificate authorities will be sent to the client when the\n server requests a client certificate.\n\n :param certificate_authority: certificate authority's X509 certificate.\n :return: None\n\n .. versionadded:: 0.10\n \"\"\"\n if not isinstance(certificate_authority, X509):\n raise TypeError(\"certificate_authority must be an X509 instance\")\n\n add_result = _lib.SSL_CTX_add_client_CA(\n self._context, certificate_authority._x509)\n _openssl_assert(add_result == 1)\n\n def set_timeout(self, timeout):\n \"\"\"\n Set the timeout for newly created sessions for this Context object to\n *timeout*. The default value is 300 seconds. See the OpenSSL manual\n for more information (e.g. :manpage:`SSL_CTX_set_timeout(3)`).\n\n :param timeout: The timeout in (whole) seconds\n :return: The previous session timeout\n \"\"\"\n if not isinstance(timeout, integer_types):\n raise TypeError(\"timeout must be an integer\")\n\n return _lib.SSL_CTX_set_timeout(self._context, timeout)\n\n def get_timeout(self):\n \"\"\"\n Retrieve session timeout, as set by :meth:`set_timeout`. The default\n is 300 seconds.\n\n :return: The session timeout\n \"\"\"\n return _lib.SSL_CTX_get_timeout(self._context)\n\n def set_info_callback(self, callback):\n \"\"\"\n Set the information callback to *callback*. This function will be\n called from time to time during SSL handshakes.\n\n :param callback: The Python callback to use. This should take three\n arguments: a Connection object and two integers. The first integer\n specifies where in the SSL handshake the function was called, and\n the other the return code from a (possibly failed) internal\n function call.\n :return: None\n \"\"\"\n @wraps(callback)\n def wrapper(ssl, where, return_code):\n callback(Connection._reverse_mapping[ssl], where, return_code)\n self._info_callback = _ffi.callback(\n \"void (*)(const SSL *, int, int)\", wrapper)\n _lib.SSL_CTX_set_info_callback(self._context, self._info_callback)\n\n def get_app_data(self):\n \"\"\"\n Get the application data (supplied via :meth:`set_app_data()`)\n\n :return: The application data\n \"\"\"\n return self._app_data\n\n def set_app_data(self, data):\n \"\"\"\n Set the application data (will be returned from get_app_data())\n\n :param data: Any Python object\n :return: None\n \"\"\"\n self._app_data = data\n\n def get_cert_store(self):\n \"\"\"\n Get the certificate store for the context. This can be used to add\n \"trusted\" certificates without using the\n :meth:`load_verify_locations` method.\n\n :return: A X509Store object or None if it does not have one.\n \"\"\"\n store = _lib.SSL_CTX_get_cert_store(self._context)\n if store == _ffi.NULL:\n # TODO: This is untested.\n return None\n\n pystore = X509Store.__new__(X509Store)\n pystore._store = store\n return pystore\n\n def set_options(self, options):\n \"\"\"\n Add options. Options set before are not cleared!\n This method should be used with the :const:`OP_*` constants.\n\n :param options: The options to add.\n :return: The new option bitmask.\n \"\"\"\n if not isinstance(options, integer_types):\n raise TypeError(\"options must be an integer\")\n\n return _lib.SSL_CTX_set_options(self._context, options)\n\n def set_mode(self, mode):\n \"\"\"\n Add modes via bitmask. Modes set before are not cleared! This method\n should be used with the :const:`MODE_*` constants.\n\n :param mode: The mode to add.\n :return: The new mode bitmask.\n \"\"\"\n if not isinstance(mode, integer_types):\n raise TypeError(\"mode must be an integer\")\n\n return _lib.SSL_CTX_set_mode(self._context, mode)\n\n @_requires_sni\n def set_tlsext_servername_callback(self, callback):\n \"\"\"\n Specify a callback function to be called when clients specify a server\n name.\n\n :param callback: The callback function. It will be invoked with one\n argument, the Connection instance.\n\n .. versionadded:: 0.13\n \"\"\"\n @wraps(callback)\n def wrapper(ssl, alert, arg):\n callback(Connection._reverse_mapping[ssl])\n return 0\n\n self._tlsext_servername_callback = _ffi.callback(\n \"int (*)(SSL *, int *, void *)\", wrapper)\n _lib.SSL_CTX_set_tlsext_servername_callback(\n self._context, self._tlsext_servername_callback)\n\n def set_tlsext_use_srtp(self, profiles):\n \"\"\"\n Enable support for negotiating SRTP keying material.\n\n :param bytes profiles: A colon delimited list of protection profile\n names, like ``b'SRTP_AES128_CM_SHA1_80:SRTP_AES128_CM_SHA1_32'``.\n :return: None\n \"\"\"\n if not isinstance(profiles, bytes):\n raise TypeError(\"profiles must be a byte string.\")\n\n _openssl_assert(\n _lib.SSL_CTX_set_tlsext_use_srtp(self._context, profiles) == 0\n )\n\n @_requires_npn\n def set_npn_advertise_callback(self, callback):\n \"\"\"\n Specify a callback function that will be called when offering `Next\n Protocol Negotiation\n `_ as a server.\n\n :param callback: The callback function. It will be invoked with one\n argument, the :class:`Connection` instance. It should return a\n list of bytestrings representing the advertised protocols, like\n ``[b'http/1.1', b'spdy/2']``.\n\n .. versionadded:: 0.15\n \"\"\"\n self._npn_advertise_helper = _NpnAdvertiseHelper(callback)\n self._npn_advertise_callback = self._npn_advertise_helper.callback\n _lib.SSL_CTX_set_next_protos_advertised_cb(\n self._context, self._npn_advertise_callback, _ffi.NULL)\n\n @_requires_npn\n def set_npn_select_callback(self, callback):\n \"\"\"\n Specify a callback function that will be called when a server offers\n Next Protocol Negotiation options.\n\n :param callback: The callback function. It will be invoked with two\n arguments: the Connection, and a list of offered protocols as\n bytestrings, e.g. ``[b'http/1.1', b'spdy/2']``. It should return\n one of those bytestrings, the chosen protocol.\n\n .. versionadded:: 0.15\n \"\"\"\n self._npn_select_helper = _NpnSelectHelper(callback)\n self._npn_select_callback = self._npn_select_helper.callback\n _lib.SSL_CTX_set_next_proto_select_cb(\n self._context, self._npn_select_callback, _ffi.NULL)\n\n @_requires_alpn\n def set_alpn_protos(self, protos):\n \"\"\"\n Specify the protocols that the client is prepared to speak after the\n TLS connection has been negotiated using Application Layer Protocol\n Negotiation.\n\n :param protos: A list of the protocols to be offered to the server.\n This list should be a Python list of bytestrings representing the\n protocols to offer, e.g. ``[b'http/1.1', b'spdy/2']``.\n \"\"\"\n # Take the list of protocols and join them together, prefixing them\n # with their lengths.\n protostr = b''.join(\n chain.from_iterable((int2byte(len(p)), p) for p in protos)\n )\n\n # Build a C string from the list. We don't need to save this off\n # because OpenSSL immediately copies the data out.\n input_str = _ffi.new(\"unsigned char[]\", protostr)\n _lib.SSL_CTX_set_alpn_protos(self._context, input_str, len(protostr))\n\n @_requires_alpn\n def set_alpn_select_callback(self, callback):\n \"\"\"\n Specify a callback function that will be called on the server when a\n client offers protocols using ALPN.\n\n :param callback: The callback function. It will be invoked with two\n arguments: the Connection, and a list of offered protocols as\n bytestrings, e.g ``[b'http/1.1', b'spdy/2']``. It should return\n one of those bytestrings, the chosen protocol.\n \"\"\"\n self._alpn_select_helper = _ALPNSelectHelper(callback)\n self._alpn_select_callback = self._alpn_select_helper.callback\n _lib.SSL_CTX_set_alpn_select_cb(\n self._context, self._alpn_select_callback, _ffi.NULL)\n\n def _set_ocsp_callback(self, helper, data):\n \"\"\"\n This internal helper does the common work for\n ``set_ocsp_server_callback`` and ``set_ocsp_client_callback``, which is\n almost all of it.\n \"\"\"\n self._ocsp_helper = helper\n self._ocsp_callback = helper.callback\n if data is None:\n self._ocsp_data = _ffi.NULL\n else:\n self._ocsp_data = _ffi.new_handle(data)\n\n rc = _lib.SSL_CTX_set_tlsext_status_cb(\n self._context, self._ocsp_callback\n )\n _openssl_assert(rc == 1)\n rc = _lib.SSL_CTX_set_tlsext_status_arg(self._context, self._ocsp_data)\n _openssl_assert(rc == 1)\n\n def set_ocsp_server_callback(self, callback, data=None):\n \"\"\"\n Set a callback to provide OCSP data to be stapled to the TLS handshake\n on the server side.\n\n :param callback: The callback function. It will be invoked with two\n arguments: the Connection, and the optional arbitrary data you have\n provided. The callback must return a bytestring that contains the\n OCSP data to staple to the handshake. If no OCSP data is available\n for this connection, return the empty bytestring.\n :param data: Some opaque data that will be passed into the callback\n function when called. This can be used to avoid needing to do\n complex data lookups or to keep track of what context is being\n used. This parameter is optional.\n \"\"\"\n helper = _OCSPServerCallbackHelper(callback)\n self._set_ocsp_callback(helper, data)\n\n def set_ocsp_client_callback(self, callback, data=None):\n \"\"\"\n Set a callback to validate OCSP data stapled to the TLS handshake on\n the client side.\n\n :param callback: The callback function. It will be invoked with three\n arguments: the Connection, a bytestring containing the stapled OCSP\n assertion, and the optional arbitrary data you have provided. The\n callback must return a boolean that indicates the result of\n validating the OCSP data: ``True`` if the OCSP data is valid and\n the certificate can be trusted, or ``False`` if either the OCSP\n data is invalid or the certificate has been revoked.\n :param data: Some opaque data that will be passed into the callback\n function when called. This can be used to avoid needing to do\n complex data lookups or to keep track of what context is being\n used. This parameter is optional.\n \"\"\"\n helper = _OCSPClientCallbackHelper(callback)\n self._set_ocsp_callback(helper, data)\n\n\nContextType = deprecated(\n Context, __name__,\n \"ContextType has been deprecated, use Context instead\", DeprecationWarning\n)\n\n\nclass Connection(object):\n \"\"\"\n \"\"\"\n _reverse_mapping = WeakValueDictionary()\n\n def __init__(self, context, socket=None):\n \"\"\"\n Create a new Connection object, using the given OpenSSL.SSL.Context\n instance and socket.\n\n :param context: An SSL Context to use for this connection\n :param socket: The socket to use for transport layer\n \"\"\"\n if not isinstance(context, Context):\n raise TypeError(\"context must be a Context instance\")\n\n ssl = _lib.SSL_new(context._context)\n self._ssl = _ffi.gc(ssl, _lib.SSL_free)\n # We set SSL_MODE_AUTO_RETRY to handle situations where OpenSSL returns\n # an SSL_ERROR_WANT_READ when processing a non-application data packet\n # even though there is still data on the underlying transport.\n # See https://github.com/openssl/openssl/issues/6234 for more details.\n _lib.SSL_set_mode(self._ssl, _lib.SSL_MODE_AUTO_RETRY)\n self._context = context\n self._app_data = None\n\n # References to strings used for Next Protocol Negotiation. OpenSSL's\n # header files suggest that these might get copied at some point, but\n # doesn't specify when, so we store them here to make sure they don't\n # get freed before OpenSSL uses them.\n self._npn_advertise_callback_args = None\n self._npn_select_callback_args = None\n\n # References to strings used for Application Layer Protocol\n # Negotiation. These strings get copied at some point but it's well\n # after the callback returns, so we have to hang them somewhere to\n # avoid them getting freed.\n self._alpn_select_callback_args = None\n\n self._reverse_mapping[self._ssl] = self\n\n if socket is None:\n self._socket = None\n # Don't set up any gc for these, SSL_free will take care of them.\n self._into_ssl = _lib.BIO_new(_lib.BIO_s_mem())\n _openssl_assert(self._into_ssl != _ffi.NULL)\n\n self._from_ssl = _lib.BIO_new(_lib.BIO_s_mem())\n _openssl_assert(self._from_ssl != _ffi.NULL)\n\n _lib.SSL_set_bio(self._ssl, self._into_ssl, self._from_ssl)\n else:\n self._into_ssl = None\n self._from_ssl = None\n self._socket = socket\n set_result = _lib.SSL_set_fd(\n self._ssl, _asFileDescriptor(self._socket))\n _openssl_assert(set_result == 1)\n\n def __getattr__(self, name):\n \"\"\"\n Look up attributes on the wrapped socket object if they are not found\n on the Connection object.\n \"\"\"\n if self._socket is None:\n raise AttributeError(\"'%s' object has no attribute '%s'\" % (\n self.__class__.__name__, name\n ))\n else:\n return getattr(self._socket, name)\n\n def _raise_ssl_error(self, ssl, result):\n if self._context._verify_helper is not None:\n self._context._verify_helper.raise_if_problem()\n if self._context._npn_advertise_helper is not None:\n self._context._npn_advertise_helper.raise_if_problem()\n if self._context._npn_select_helper is not None:\n self._context._npn_select_helper.raise_if_problem()\n if self._context._alpn_select_helper is not None:\n self._context._alpn_select_helper.raise_if_problem()\n if self._context._ocsp_helper is not None:\n self._context._ocsp_helper.raise_if_problem()\n\n error = _lib.SSL_get_error(ssl, result)\n if error == _lib.SSL_ERROR_WANT_READ:\n raise WantReadError()\n elif error == _lib.SSL_ERROR_WANT_WRITE:\n raise WantWriteError()\n elif error == _lib.SSL_ERROR_ZERO_RETURN:\n raise ZeroReturnError()\n elif error == _lib.SSL_ERROR_WANT_X509_LOOKUP:\n # TODO: This is untested.\n raise WantX509LookupError()\n elif error == _lib.SSL_ERROR_SYSCALL:\n if _lib.ERR_peek_error() == 0:\n if result < 0:\n if platform == \"win32\":\n errno = _ffi.getwinerror()[0]\n else:\n errno = _ffi.errno\n\n if errno != 0:\n raise SysCallError(errno, errorcode.get(errno))\n raise SysCallError(-1, \"Unexpected EOF\")\n else:\n # TODO: This is untested.\n _raise_current_error()\n elif error == _lib.SSL_ERROR_NONE:\n pass\n else:\n _raise_current_error()\n\n def get_context(self):\n \"\"\"\n Retrieve the :class:`Context` object associated with this\n :class:`Connection`.\n \"\"\"\n return self._context\n\n def set_context(self, context):\n \"\"\"\n Switch this connection to a new session context.\n\n :param context: A :class:`Context` instance giving the new session\n context to use.\n \"\"\"\n if not isinstance(context, Context):\n raise TypeError(\"context must be a Context instance\")\n\n _lib.SSL_set_SSL_CTX(self._ssl, context._context)\n self._context = context\n\n @_requires_sni\n def get_servername(self):\n \"\"\"\n Retrieve the servername extension value if provided in the client hello\n message, or None if there wasn't one.\n\n :return: A byte string giving the server name or :data:`None`.\n\n .. versionadded:: 0.13\n \"\"\"\n name = _lib.SSL_get_servername(\n self._ssl, _lib.TLSEXT_NAMETYPE_host_name\n )\n if name == _ffi.NULL:\n return None\n\n return _ffi.string(name)\n\n @_requires_sni\n def set_tlsext_host_name(self, name):\n \"\"\"\n Set the value of the servername extension to send in the client hello.\n\n :param name: A byte string giving the name.\n\n .. versionadded:: 0.13\n \"\"\"\n if not isinstance(name, bytes):\n raise TypeError(\"name must be a byte string\")\n elif b\"\\0\" in name:\n raise TypeError(\"name must not contain NUL byte\")\n\n # XXX I guess this can fail sometimes?\n _lib.SSL_set_tlsext_host_name(self._ssl, name)\n\n def pending(self):\n \"\"\"\n Get the number of bytes that can be safely read from the SSL buffer\n (**not** the underlying transport buffer).\n\n :return: The number of bytes available in the receive buffer.\n \"\"\"\n return _lib.SSL_pending(self._ssl)\n\n def send(self, buf, flags=0):\n \"\"\"\n Send data on the connection. NOTE: If you get one of the WantRead,\n WantWrite or WantX509Lookup exceptions on this, you have to call the\n method again with the SAME buffer.\n\n :param buf: The string, buffer or memoryview to send\n :param flags: (optional) Included for compatibility with the socket\n API, the value is ignored\n :return: The number of bytes written\n \"\"\"\n # Backward compatibility\n buf = _text_to_bytes_and_warn(\"buf\", buf)\n\n if isinstance(buf, memoryview):\n buf = buf.tobytes()\n if isinstance(buf, _buffer):\n buf = str(buf)\n if not isinstance(buf, bytes):\n raise TypeError(\"data must be a memoryview, buffer or byte string\")\n if len(buf) > 2147483647:\n raise ValueError(\"Cannot send more than 2**31-1 bytes at once.\")\n\n result = _lib.SSL_write(self._ssl, buf, len(buf))\n self._raise_ssl_error(self._ssl, result)\n return result\n write = send\n\n def sendall(self, buf, flags=0):\n \"\"\"\n Send \"all\" data on the connection. This calls send() repeatedly until\n all data is sent. If an error occurs, it's impossible to tell how much\n data has been sent.\n\n :param buf: The string, buffer or memoryview to send\n :param flags: (optional) Included for compatibility with the socket\n API, the value is ignored\n :return: The number of bytes written\n \"\"\"\n buf = _text_to_bytes_and_warn(\"buf\", buf)\n\n if isinstance(buf, memoryview):\n buf = buf.tobytes()\n if isinstance(buf, _buffer):\n buf = str(buf)\n if not isinstance(buf, bytes):\n raise TypeError(\"buf must be a memoryview, buffer or byte string\")\n\n left_to_send = len(buf)\n total_sent = 0\n data = _ffi.new(\"char[]\", buf)\n\n while left_to_send:\n # SSL_write's num arg is an int,\n # so we cannot send more than 2**31-1 bytes at once.\n result = _lib.SSL_write(\n self._ssl,\n data + total_sent,\n min(left_to_send, 2147483647)\n )\n self._raise_ssl_error(self._ssl, result)\n total_sent += result\n left_to_send -= result\n\n def recv(self, bufsiz, flags=None):\n \"\"\"\n Receive data on the connection.\n\n :param bufsiz: The maximum number of bytes to read\n :param flags: (optional) The only supported flag is ``MSG_PEEK``,\n all other flags are ignored.\n :return: The string read from the Connection\n \"\"\"\n buf = _no_zero_allocator(\"char[]\", bufsiz)\n if flags is not None and flags & socket.MSG_PEEK:\n result = _lib.SSL_peek(self._ssl, buf, bufsiz)\n else:\n result = _lib.SSL_read(self._ssl, buf, bufsiz)\n self._raise_ssl_error(self._ssl, result)\n return _ffi.buffer(buf, result)[:]\n read = recv\n\n def recv_into(self, buffer, nbytes=None, flags=None):\n \"\"\"\n Receive data on the connection and copy it directly into the provided\n buffer, rather than creating a new string.\n\n :param buffer: The buffer to copy into.\n :param nbytes: (optional) The maximum number of bytes to read into the\n buffer. If not present, defaults to the size of the buffer. If\n larger than the size of the buffer, is reduced to the size of the\n buffer.\n :param flags: (optional) The only supported flag is ``MSG_PEEK``,\n all other flags are ignored.\n :return: The number of bytes read into the buffer.\n \"\"\"\n if nbytes is None:\n nbytes = len(buffer)\n else:\n nbytes = min(nbytes, len(buffer))\n\n # We need to create a temporary buffer. This is annoying, it would be\n # better if we could pass memoryviews straight into the SSL_read call,\n # but right now we can't. Revisit this if CFFI gets that ability.\n buf = _no_zero_allocator(\"char[]\", nbytes)\n if flags is not None and flags & socket.MSG_PEEK:\n result = _lib.SSL_peek(self._ssl, buf, nbytes)\n else:\n result = _lib.SSL_read(self._ssl, buf, nbytes)\n self._raise_ssl_error(self._ssl, result)\n\n # This strange line is all to avoid a memory copy. The buffer protocol\n # should allow us to assign a CFFI buffer to the LHS of this line, but\n # on CPython 3.3+ that segfaults. As a workaround, we can temporarily\n # wrap it in a memoryview.\n buffer[:result] = memoryview(_ffi.buffer(buf, result))\n\n return result\n\n def _handle_bio_errors(self, bio, result):\n if _lib.BIO_should_retry(bio):\n if _lib.BIO_should_read(bio):\n raise WantReadError()\n elif _lib.BIO_should_write(bio):\n # TODO: This is untested.\n raise WantWriteError()\n elif _lib.BIO_should_io_special(bio):\n # TODO: This is untested. I think io_special means the socket\n # BIO has a not-yet connected socket.\n raise ValueError(\"BIO_should_io_special\")\n else:\n # TODO: This is untested.\n raise ValueError(\"unknown bio failure\")\n else:\n # TODO: This is untested.\n _raise_current_error()\n\n def bio_read(self, bufsiz):\n \"\"\"\n If the Connection was created with a memory BIO, this method can be\n used to read bytes from the write end of that memory BIO. Many\n Connection methods will add bytes which must be read in this manner or\n the buffer will eventually fill up and the Connection will be able to\n take no further actions.\n\n :param bufsiz: The maximum number of bytes to read\n :return: The string read.\n \"\"\"\n if self._from_ssl is None:\n raise TypeError(\"Connection sock was not None\")\n\n if not isinstance(bufsiz, integer_types):\n raise TypeError(\"bufsiz must be an integer\")\n\n buf = _no_zero_allocator(\"char[]\", bufsiz)\n result = _lib.BIO_read(self._from_ssl, buf, bufsiz)\n if result <= 0:\n self._handle_bio_errors(self._from_ssl, result)\n\n return _ffi.buffer(buf, result)[:]\n\n def bio_write(self, buf):\n \"\"\"\n If the Connection was created with a memory BIO, this method can be\n used to add bytes to the read end of that memory BIO. The Connection\n can then read the bytes (for example, in response to a call to\n :meth:`recv`).\n\n :param buf: The string to put into the memory BIO.\n :return: The number of bytes written\n \"\"\"\n buf = _text_to_bytes_and_warn(\"buf\", buf)\n\n if self._into_ssl is None:\n raise TypeError(\"Connection sock was not None\")\n\n result = _lib.BIO_write(self._into_ssl, buf, len(buf))\n if result <= 0:\n self._handle_bio_errors(self._into_ssl, result)\n return result\n\n def renegotiate(self):\n \"\"\"\n Renegotiate the session.\n\n :return: True if the renegotiation can be started, False otherwise\n :rtype: bool\n \"\"\"\n if not self.renegotiate_pending():\n _openssl_assert(_lib.SSL_renegotiate(self._ssl) == 1)\n return True\n return False\n\n def do_handshake(self):\n \"\"\"\n Perform an SSL handshake (usually called after :meth:`renegotiate` or\n one of :meth:`set_accept_state` or :meth:`set_accept_state`). This can\n raise the same exceptions as :meth:`send` and :meth:`recv`.\n\n :return: None.\n \"\"\"\n result = _lib.SSL_do_handshake(self._ssl)\n self._raise_ssl_error(self._ssl, result)\n\n def renegotiate_pending(self):\n \"\"\"\n Check if there's a renegotiation in progress, it will return False once\n a renegotiation is finished.\n\n :return: Whether there's a renegotiation in progress\n :rtype: bool\n \"\"\"\n return _lib.SSL_renegotiate_pending(self._ssl) == 1\n\n def total_renegotiations(self):\n \"\"\"\n Find out the total number of renegotiations.\n\n :return: The number of renegotiations.\n :rtype: int\n \"\"\"\n return _lib.SSL_total_renegotiations(self._ssl)\n\n def connect(self, addr):\n \"\"\"\n Call the :meth:`connect` method of the underlying socket and set up SSL\n on the socket, using the :class:`Context` object supplied to this\n :class:`Connection` object at creation.\n\n :param addr: A remote address\n :return: What the socket's connect method returns\n \"\"\"\n _lib.SSL_set_connect_state(self._ssl)\n return self._socket.connect(addr)\n\n def connect_ex(self, addr):\n \"\"\"\n Call the :meth:`connect_ex` method of the underlying socket and set up\n SSL on the socket, using the Context object supplied to this Connection\n object at creation. Note that if the :meth:`connect_ex` method of the\n socket doesn't return 0, SSL won't be initialized.\n\n :param addr: A remove address\n :return: What the socket's connect_ex method returns\n \"\"\"\n connect_ex = self._socket.connect_ex\n self.set_connect_state()\n return connect_ex(addr)\n\n def accept(self):\n \"\"\"\n Call the :meth:`accept` method of the underlying socket and set up SSL\n on the returned socket, using the Context object supplied to this\n :class:`Connection` object at creation.\n\n :return: A *(conn, addr)* pair where *conn* is the new\n :class:`Connection` object created, and *address* is as returned by\n the socket's :meth:`accept`.\n \"\"\"\n client, addr = self._socket.accept()\n conn = Connection(self._context, client)\n conn.set_accept_state()\n return (conn, addr)\n\n def bio_shutdown(self):\n \"\"\"\n If the Connection was created with a memory BIO, this method can be\n used to indicate that *end of file* has been reached on the read end of\n that memory BIO.\n\n :return: None\n \"\"\"\n if self._from_ssl is None:\n raise TypeError(\"Connection sock was not None\")\n\n _lib.BIO_set_mem_eof_return(self._into_ssl, 0)\n\n def shutdown(self):\n \"\"\"\n Send the shutdown message to the Connection.\n\n :return: True if the shutdown completed successfully (i.e. both sides\n have sent closure alerts), False otherwise (in which case you\n call :meth:`recv` or :meth:`send` when the connection becomes\n readable/writeable).\n \"\"\"\n result = _lib.SSL_shutdown(self._ssl)\n if result < 0:\n self._raise_ssl_error(self._ssl, result)\n elif result > 0:\n return True\n else:\n return False\n\n def get_cipher_list(self):\n \"\"\"\n Retrieve the list of ciphers used by the Connection object.\n\n :return: A list of native cipher strings.\n \"\"\"\n ciphers = []\n for i in count():\n result = _lib.SSL_get_cipher_list(self._ssl, i)\n if result == _ffi.NULL:\n break\n ciphers.append(_native(_ffi.string(result)))\n return ciphers\n\n def get_client_ca_list(self):\n \"\"\"\n Get CAs whose certificates are suggested for client authentication.\n\n :return: If this is a server connection, the list of certificate\n authorities that will be sent or has been sent to the client, as\n controlled by this :class:`Connection`'s :class:`Context`.\n\n If this is a client connection, the list will be empty until the\n connection with the server is established.\n\n .. versionadded:: 0.10\n \"\"\"\n ca_names = _lib.SSL_get_client_CA_list(self._ssl)\n if ca_names == _ffi.NULL:\n # TODO: This is untested.\n return []\n\n result = []\n for i in range(_lib.sk_X509_NAME_num(ca_names)):\n name = _lib.sk_X509_NAME_value(ca_names, i)\n copy = _lib.X509_NAME_dup(name)\n _openssl_assert(copy != _ffi.NULL)\n\n pyname = X509Name.__new__(X509Name)\n pyname._name = _ffi.gc(copy, _lib.X509_NAME_free)\n result.append(pyname)\n return result\n\n def makefile(self, *args, **kwargs):\n \"\"\"\n The makefile() method is not implemented, since there is no dup\n semantics for SSL connections\n\n :raise: NotImplementedError\n \"\"\"\n raise NotImplementedError(\n \"Cannot make file object of OpenSSL.SSL.Connection\")\n\n def get_app_data(self):\n \"\"\"\n Retrieve application data as set by :meth:`set_app_data`.\n\n :return: The application data\n \"\"\"\n return self._app_data\n\n def set_app_data(self, data):\n \"\"\"\n Set application data\n\n :param data: The application data\n :return: None\n \"\"\"\n self._app_data = data\n\n def get_shutdown(self):\n \"\"\"\n Get the shutdown state of the Connection.\n\n :return: The shutdown state, a bitvector of SENT_SHUTDOWN,\n RECEIVED_SHUTDOWN.\n \"\"\"\n return _lib.SSL_get_shutdown(self._ssl)\n\n def set_shutdown(self, state):\n \"\"\"\n Set the shutdown state of the Connection.\n\n :param state: bitvector of SENT_SHUTDOWN, RECEIVED_SHUTDOWN.\n :return: None\n \"\"\"\n if not isinstance(state, integer_types):\n raise TypeError(\"state must be an integer\")\n\n _lib.SSL_set_shutdown(self._ssl, state)\n\n def get_state_string(self):\n \"\"\"\n Retrieve a verbose string detailing the state of the Connection.\n\n :return: A string representing the state\n :rtype: bytes\n \"\"\"\n return _ffi.string(_lib.SSL_state_string_long(self._ssl))\n\n def server_random(self):\n \"\"\"\n Retrieve the random value used with the server hello message.\n\n :return: A string representing the state\n \"\"\"\n session = _lib.SSL_get_session(self._ssl)\n if session == _ffi.NULL:\n return None\n length = _lib.SSL_get_server_random(self._ssl, _ffi.NULL, 0)\n assert length > 0\n outp = _no_zero_allocator(\"unsigned char[]\", length)\n _lib.SSL_get_server_random(self._ssl, outp, length)\n return _ffi.buffer(outp, length)[:]\n\n def client_random(self):\n \"\"\"\n Retrieve the random value used with the client hello message.\n\n :return: A string representing the state\n \"\"\"\n session = _lib.SSL_get_session(self._ssl)\n if session == _ffi.NULL:\n return None\n\n length = _lib.SSL_get_client_random(self._ssl, _ffi.NULL, 0)\n assert length > 0\n outp = _no_zero_allocator(\"unsigned char[]\", length)\n _lib.SSL_get_client_random(self._ssl, outp, length)\n return _ffi.buffer(outp, length)[:]\n\n def master_key(self):\n \"\"\"\n Retrieve the value of the master key for this session.\n\n :return: A string representing the state\n \"\"\"\n session = _lib.SSL_get_session(self._ssl)\n if session == _ffi.NULL:\n return None\n\n length = _lib.SSL_SESSION_get_master_key(session, _ffi.NULL, 0)\n assert length > 0\n outp = _no_zero_allocator(\"unsigned char[]\", length)\n _lib.SSL_SESSION_get_master_key(session, outp, length)\n return _ffi.buffer(outp, length)[:]\n\n def export_keying_material(self, label, olen, context=None):\n \"\"\"\n Obtain keying material for application use.\n\n :param: label - a disambiguating label string as described in RFC 5705\n :param: olen - the length of the exported key material in bytes\n :param: context - a per-association context value\n :return: the exported key material bytes or None\n \"\"\"\n outp = _no_zero_allocator(\"unsigned char[]\", olen)\n context_buf = _ffi.NULL\n context_len = 0\n use_context = 0\n if context is not None:\n context_buf = context\n context_len = len(context)\n use_context = 1\n success = _lib.SSL_export_keying_material(self._ssl, outp, olen,\n label, len(label),\n context_buf, context_len,\n use_context)\n _openssl_assert(success == 1)\n return _ffi.buffer(outp, olen)[:]\n\n def sock_shutdown(self, *args, **kwargs):\n \"\"\"\n Call the :meth:`shutdown` method of the underlying socket.\n See :manpage:`shutdown(2)`.\n\n :return: What the socket's shutdown() method returns\n \"\"\"\n return self._socket.shutdown(*args, **kwargs)\n\n def get_certificate(self):\n \"\"\"\n Retrieve the local certificate (if any)\n\n :return: The local certificate\n \"\"\"\n cert = _lib.SSL_get_certificate(self._ssl)\n if cert != _ffi.NULL:\n _lib.X509_up_ref(cert)\n return X509._from_raw_x509_ptr(cert)\n return None\n\n def get_peer_certificate(self):\n \"\"\"\n Retrieve the other side's certificate (if any)\n\n :return: The peer's certificate\n \"\"\"\n cert = _lib.SSL_get_peer_certificate(self._ssl)\n if cert != _ffi.NULL:\n return X509._from_raw_x509_ptr(cert)\n return None\n\n def get_peer_cert_chain(self):\n \"\"\"\n Retrieve the other side's certificate (if any)\n\n :return: A list of X509 instances giving the peer's certificate chain,\n or None if it does not have one.\n \"\"\"\n cert_stack = _lib.SSL_get_peer_cert_chain(self._ssl)\n if cert_stack == _ffi.NULL:\n return None\n\n result = []\n for i in range(_lib.sk_X509_num(cert_stack)):\n # TODO could incref instead of dup here\n cert = _lib.X509_dup(_lib.sk_X509_value(cert_stack, i))\n pycert = X509._from_raw_x509_ptr(cert)\n result.append(pycert)\n return result\n\n def want_read(self):\n \"\"\"\n Checks if more data has to be read from the transport layer to complete\n an operation.\n\n :return: True iff more data has to be read\n \"\"\"\n return _lib.SSL_want_read(self._ssl)\n\n def want_write(self):\n \"\"\"\n Checks if there is data to write to the transport layer to complete an\n operation.\n\n :return: True iff there is data to write\n \"\"\"\n return _lib.SSL_want_write(self._ssl)\n\n def set_accept_state(self):\n \"\"\"\n Set the connection to work in server mode. The handshake will be\n handled automatically by read/write.\n\n :return: None\n \"\"\"\n _lib.SSL_set_accept_state(self._ssl)\n\n def set_connect_state(self):\n \"\"\"\n Set the connection to work in client mode. The handshake will be\n handled automatically by read/write.\n\n :return: None\n \"\"\"\n _lib.SSL_set_connect_state(self._ssl)\n\n def get_session(self):\n \"\"\"\n Returns the Session currently used.\n\n :return: An instance of :class:`OpenSSL.SSL.Session` or\n :obj:`None` if no session exists.\n\n .. versionadded:: 0.14\n \"\"\"\n session = _lib.SSL_get1_session(self._ssl)\n if session == _ffi.NULL:\n return None\n\n pysession = Session.__new__(Session)\n pysession._session = _ffi.gc(session, _lib.SSL_SESSION_free)\n return pysession\n\n def set_session(self, session):\n \"\"\"\n Set the session to be used when the TLS/SSL connection is established.\n\n :param session: A Session instance representing the session to use.\n :returns: None\n\n .. versionadded:: 0.14\n \"\"\"\n if not isinstance(session, Session):\n raise TypeError(\"session must be a Session instance\")\n\n result = _lib.SSL_set_session(self._ssl, session._session)\n if not result:\n _raise_current_error()\n\n def _get_finished_message(self, function):\n \"\"\"\n Helper to implement :meth:`get_finished` and\n :meth:`get_peer_finished`.\n\n :param function: Either :data:`SSL_get_finished`: or\n :data:`SSL_get_peer_finished`.\n\n :return: :data:`None` if the desired message has not yet been\n received, otherwise the contents of the message.\n :rtype: :class:`bytes` or :class:`NoneType`\n \"\"\"\n # The OpenSSL documentation says nothing about what might happen if the\n # count argument given is zero. Specifically, it doesn't say whether\n # the output buffer may be NULL in that case or not. Inspection of the\n # implementation reveals that it calls memcpy() unconditionally.\n # Section 7.1.4, paragraph 1 of the C standard suggests that\n # memcpy(NULL, source, 0) is not guaranteed to produce defined (let\n # alone desirable) behavior (though it probably does on just about\n # every implementation...)\n #\n # Allocate a tiny buffer to pass in (instead of just passing NULL as\n # one might expect) for the initial call so as to be safe against this\n # potentially undefined behavior.\n empty = _ffi.new(\"char[]\", 0)\n size = function(self._ssl, empty, 0)\n if size == 0:\n # No Finished message so far.\n return None\n\n buf = _no_zero_allocator(\"char[]\", size)\n function(self._ssl, buf, size)\n return _ffi.buffer(buf, size)[:]\n\n def get_finished(self):\n \"\"\"\n Obtain the latest TLS Finished message that we sent.\n\n :return: The contents of the message or :obj:`None` if the TLS\n handshake has not yet completed.\n :rtype: :class:`bytes` or :class:`NoneType`\n\n .. versionadded:: 0.15\n \"\"\"\n return self._get_finished_message(_lib.SSL_get_finished)\n\n def get_peer_finished(self):\n \"\"\"\n Obtain the latest TLS Finished message that we received from the peer.\n\n :return: The contents of the message or :obj:`None` if the TLS\n handshake has not yet completed.\n :rtype: :class:`bytes` or :class:`NoneType`\n\n .. versionadded:: 0.15\n \"\"\"\n return self._get_finished_message(_lib.SSL_get_peer_finished)\n\n def get_cipher_name(self):\n \"\"\"\n Obtain the name of the currently used cipher.\n\n :returns: The name of the currently used cipher or :obj:`None`\n if no connection has been established.\n :rtype: :class:`unicode` or :class:`NoneType`\n\n .. versionadded:: 0.15\n \"\"\"\n cipher = _lib.SSL_get_current_cipher(self._ssl)\n if cipher == _ffi.NULL:\n return None\n else:\n name = _ffi.string(_lib.SSL_CIPHER_get_name(cipher))\n return name.decode(\"utf-8\")\n\n def get_cipher_bits(self):\n \"\"\"\n Obtain the number of secret bits of the currently used cipher.\n\n :returns: The number of secret bits of the currently used cipher\n or :obj:`None` if no connection has been established.\n :rtype: :class:`int` or :class:`NoneType`\n\n .. versionadded:: 0.15\n \"\"\"\n cipher = _lib.SSL_get_current_cipher(self._ssl)\n if cipher == _ffi.NULL:\n return None\n else:\n return _lib.SSL_CIPHER_get_bits(cipher, _ffi.NULL)\n\n def get_cipher_version(self):\n \"\"\"\n Obtain the protocol version of the currently used cipher.\n\n :returns: The protocol name of the currently used cipher\n or :obj:`None` if no connection has been established.\n :rtype: :class:`unicode` or :class:`NoneType`\n\n .. versionadded:: 0.15\n \"\"\"\n cipher = _lib.SSL_get_current_cipher(self._ssl)\n if cipher == _ffi.NULL:\n return None\n else:\n version = _ffi.string(_lib.SSL_CIPHER_get_version(cipher))\n return version.decode(\"utf-8\")\n\n def get_protocol_version_name(self):\n \"\"\"\n Retrieve the protocol version of the current connection.\n\n :returns: The TLS version of the current connection, for example\n the value for TLS 1.2 would be ``TLSv1.2``or ``Unknown``\n for connections that were not successfully established.\n :rtype: :class:`unicode`\n \"\"\"\n version = _ffi.string(_lib.SSL_get_version(self._ssl))\n return version.decode(\"utf-8\")\n\n def get_protocol_version(self):\n \"\"\"\n Retrieve the SSL or TLS protocol version of the current connection.\n\n :returns: The TLS version of the current connection. For example,\n it will return ``0x769`` for connections made over TLS version 1.\n :rtype: :class:`int`\n \"\"\"\n version = _lib.SSL_version(self._ssl)\n return version\n\n @_requires_npn\n def get_next_proto_negotiated(self):\n \"\"\"\n Get the protocol that was negotiated by NPN.\n\n :returns: A bytestring of the protocol name. If no protocol has been\n negotiated yet, returns an empty string.\n\n .. versionadded:: 0.15\n \"\"\"\n data = _ffi.new(\"unsigned char **\")\n data_len = _ffi.new(\"unsigned int *\")\n\n _lib.SSL_get0_next_proto_negotiated(self._ssl, data, data_len)\n\n return _ffi.buffer(data[0], data_len[0])[:]\n\n @_requires_alpn\n def set_alpn_protos(self, protos):\n \"\"\"\n Specify the client's ALPN protocol list.\n\n These protocols are offered to the server during protocol negotiation.\n\n :param protos: A list of the protocols to be offered to the server.\n This list should be a Python list of bytestrings representing the\n protocols to offer, e.g. ``[b'http/1.1', b'spdy/2']``.\n \"\"\"\n # Take the list of protocols and join them together, prefixing them\n # with their lengths.\n protostr = b''.join(\n chain.from_iterable((int2byte(len(p)), p) for p in protos)\n )\n\n # Build a C string from the list. We don't need to save this off\n # because OpenSSL immediately copies the data out.\n input_str = _ffi.new(\"unsigned char[]\", protostr)\n _lib.SSL_set_alpn_protos(self._ssl, input_str, len(protostr))\n\n @_requires_alpn\n def get_alpn_proto_negotiated(self):\n \"\"\"\n Get the protocol that was negotiated by ALPN.\n\n :returns: A bytestring of the protocol name. If no protocol has been\n negotiated yet, returns an empty string.\n \"\"\"\n data = _ffi.new(\"unsigned char **\")\n data_len = _ffi.new(\"unsigned int *\")\n\n _lib.SSL_get0_alpn_selected(self._ssl, data, data_len)\n\n if not data_len:\n return b''\n\n return _ffi.buffer(data[0], data_len[0])[:]\n\n def request_ocsp(self):\n \"\"\"\n Called to request that the server sends stapled OCSP data, if\n available. If this is not called on the client side then the server\n will not send OCSP data. Should be used in conjunction with\n :meth:`Context.set_ocsp_client_callback`.\n \"\"\"\n rc = _lib.SSL_set_tlsext_status_type(\n self._ssl, _lib.TLSEXT_STATUSTYPE_ocsp\n )\n _openssl_assert(rc == 1)\n\n\nConnectionType = deprecated(\n Connection, __name__,\n \"ConnectionType has been deprecated, use Connection instead\",\n DeprecationWarning\n)\n\n# This is similar to the initialization calls at the end of OpenSSL/crypto.py\n# but is exercised mostly by the Context initializer.\n_lib.SSL_library_init()\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/OpenSSL/__init__.py",
"content": "# Copyright (C) AB Strakt\n# See LICENSE for details.\n\n\"\"\"\npyOpenSSL - A simple wrapper around the OpenSSL library\n\"\"\"\n\nfrom OpenSSL import crypto, SSL\nfrom OpenSSL.version import (\n __author__, __copyright__, __email__, __license__, __summary__, __title__,\n __uri__, __version__,\n)\n\n\n__all__ = [\n \"SSL\", \"crypto\",\n\n \"__author__\", \"__copyright__\", \"__email__\", \"__license__\", \"__summary__\",\n \"__title__\", \"__uri__\", \"__version__\",\n]\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/OpenSSL/_util.py",
"content": "import sys\nimport warnings\n\nfrom six import PY3, binary_type, text_type\n\nfrom cryptography.hazmat.bindings.openssl.binding import Binding\n\n\nbinding = Binding()\nbinding.init_static_locks()\nffi = binding.ffi\nlib = binding.lib\n\n\n# This is a special CFFI allocator that does not bother to zero its memory\n# after allocation. This has vastly better performance on large allocations and\n# so should be used whenever we don't need the memory zeroed out.\nno_zero_allocator = ffi.new_allocator(should_clear_after_alloc=False)\n\n\ndef text(charp):\n \"\"\"\n Get a native string type representing of the given CFFI ``char*`` object.\n\n :param charp: A C-style string represented using CFFI.\n\n :return: :class:`str`\n \"\"\"\n if not charp:\n return \"\"\n return native(ffi.string(charp))\n\n\ndef exception_from_error_queue(exception_type):\n \"\"\"\n Convert an OpenSSL library failure into a Python exception.\n\n When a call to the native OpenSSL library fails, this is usually signalled\n by the return value, and an error code is stored in an error queue\n associated with the current thread. The err library provides functions to\n obtain these error codes and textual error messages.\n \"\"\"\n errors = []\n\n while True:\n error = lib.ERR_get_error()\n if error == 0:\n break\n errors.append((\n text(lib.ERR_lib_error_string(error)),\n text(lib.ERR_func_error_string(error)),\n text(lib.ERR_reason_error_string(error))))\n\n raise exception_type(errors)\n\n\ndef make_assert(error):\n \"\"\"\n Create an assert function that uses :func:`exception_from_error_queue` to\n raise an exception wrapped by *error*.\n \"\"\"\n def openssl_assert(ok):\n \"\"\"\n If *ok* is not True, retrieve the error from OpenSSL and raise it.\n \"\"\"\n if ok is not True:\n exception_from_error_queue(error)\n\n return openssl_assert\n\n\ndef native(s):\n \"\"\"\n Convert :py:class:`bytes` or :py:class:`unicode` to the native\n :py:class:`str` type, using UTF-8 encoding if conversion is necessary.\n\n :raise UnicodeError: The input string is not UTF-8 decodeable.\n\n :raise TypeError: The input is neither :py:class:`bytes` nor\n :py:class:`unicode`.\n \"\"\"\n if not isinstance(s, (binary_type, text_type)):\n raise TypeError(\"%r is neither bytes nor unicode\" % s)\n if PY3:\n if isinstance(s, binary_type):\n return s.decode(\"utf-8\")\n else:\n if isinstance(s, text_type):\n return s.encode(\"utf-8\")\n return s\n\n\ndef path_string(s):\n \"\"\"\n Convert a Python string to a :py:class:`bytes` string identifying the same\n path and which can be passed into an OpenSSL API accepting a filename.\n\n :param s: An instance of :py:class:`bytes` or :py:class:`unicode`.\n\n :return: An instance of :py:class:`bytes`.\n \"\"\"\n if isinstance(s, binary_type):\n return s\n elif isinstance(s, text_type):\n return s.encode(sys.getfilesystemencoding())\n else:\n raise TypeError(\"Path must be represented as bytes or unicode string\")\n\n\nif PY3:\n def byte_string(s):\n return s.encode(\"charmap\")\nelse:\n def byte_string(s):\n return s\n\n\n# A marker object to observe whether some optional arguments are passed any\n# value or not.\nUNSPECIFIED = object()\n\n_TEXT_WARNING = (\n text_type.__name__ + \" for {0} is no longer accepted, use bytes\"\n)\n\n\ndef text_to_bytes_and_warn(label, obj):\n \"\"\"\n If ``obj`` is text, emit a warning that it should be bytes instead and try\n to convert it to bytes automatically.\n\n :param str label: The name of the parameter from which ``obj`` was taken\n (so a developer can easily find the source of the problem and correct\n it).\n\n :return: If ``obj`` is the text string type, a ``bytes`` object giving the\n UTF-8 encoding of that text is returned. Otherwise, ``obj`` itself is\n returned.\n \"\"\"\n if isinstance(obj, text_type):\n warnings.warn(\n _TEXT_WARNING.format(label),\n category=DeprecationWarning,\n stacklevel=3\n )\n return obj.encode('utf-8')\n return obj\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/OpenSSL/crypto.py",
"content": "import datetime\n\nfrom base64 import b16encode\nfrom functools import partial\nfrom operator import __eq__, __ne__, __lt__, __le__, __gt__, __ge__\n\nfrom six import (\n integer_types as _integer_types,\n text_type as _text_type,\n PY3 as _PY3)\n\nfrom cryptography import x509\nfrom cryptography.hazmat.primitives.asymmetric import dsa, rsa\nfrom cryptography.utils import deprecated\n\nfrom OpenSSL._util import (\n ffi as _ffi,\n lib as _lib,\n exception_from_error_queue as _exception_from_error_queue,\n byte_string as _byte_string,\n native as _native,\n UNSPECIFIED as _UNSPECIFIED,\n text_to_bytes_and_warn as _text_to_bytes_and_warn,\n make_assert as _make_assert,\n)\n\n__all__ = [\n 'FILETYPE_PEM',\n 'FILETYPE_ASN1',\n 'FILETYPE_TEXT',\n 'TYPE_RSA',\n 'TYPE_DSA',\n 'Error',\n 'PKey',\n 'get_elliptic_curves',\n 'get_elliptic_curve',\n 'X509Name',\n 'X509Extension',\n 'X509Req',\n 'X509',\n 'X509StoreFlags',\n 'X509Store',\n 'X509StoreContextError',\n 'X509StoreContext',\n 'load_certificate',\n 'dump_certificate',\n 'dump_publickey',\n 'dump_privatekey',\n 'Revoked',\n 'CRL',\n 'PKCS7',\n 'PKCS12',\n 'NetscapeSPKI',\n 'load_publickey',\n 'load_privatekey',\n 'dump_certificate_request',\n 'load_certificate_request',\n 'sign',\n 'verify',\n 'dump_crl',\n 'load_crl',\n 'load_pkcs7_data',\n 'load_pkcs12'\n]\n\nFILETYPE_PEM = _lib.SSL_FILETYPE_PEM\nFILETYPE_ASN1 = _lib.SSL_FILETYPE_ASN1\n\n# TODO This was an API mistake. OpenSSL has no such constant.\nFILETYPE_TEXT = 2 ** 16 - 1\n\nTYPE_RSA = _lib.EVP_PKEY_RSA\nTYPE_DSA = _lib.EVP_PKEY_DSA\nTYPE_DH = _lib.EVP_PKEY_DH\nTYPE_EC = _lib.EVP_PKEY_EC\n\n\nclass Error(Exception):\n \"\"\"\n An error occurred in an `OpenSSL.crypto` API.\n \"\"\"\n\n\n_raise_current_error = partial(_exception_from_error_queue, Error)\n_openssl_assert = _make_assert(Error)\n\n\ndef _get_backend():\n \"\"\"\n Importing the backend from cryptography has the side effect of activating\n the osrandom engine. This mutates the global state of OpenSSL in the\n process and causes issues for various programs that use subinterpreters or\n embed Python. By putting the import in this function we can avoid\n triggering this side effect unless _get_backend is called.\n \"\"\"\n from cryptography.hazmat.backends.openssl.backend import backend\n return backend\n\n\ndef _untested_error(where):\n \"\"\"\n An OpenSSL API failed somehow. Additionally, the failure which was\n encountered isn't one that's exercised by the test suite so future behavior\n of pyOpenSSL is now somewhat less predictable.\n \"\"\"\n raise RuntimeError(\"Unknown %s failure\" % (where,))\n\n\ndef _new_mem_buf(buffer=None):\n \"\"\"\n Allocate a new OpenSSL memory BIO.\n\n Arrange for the garbage collector to clean it up automatically.\n\n :param buffer: None or some bytes to use to put into the BIO so that they\n can be read out.\n \"\"\"\n if buffer is None:\n bio = _lib.BIO_new(_lib.BIO_s_mem())\n free = _lib.BIO_free\n else:\n data = _ffi.new(\"char[]\", buffer)\n bio = _lib.BIO_new_mem_buf(data, len(buffer))\n\n # Keep the memory alive as long as the bio is alive!\n def free(bio, ref=data):\n return _lib.BIO_free(bio)\n\n _openssl_assert(bio != _ffi.NULL)\n\n bio = _ffi.gc(bio, free)\n return bio\n\n\ndef _bio_to_string(bio):\n \"\"\"\n Copy the contents of an OpenSSL BIO object into a Python byte string.\n \"\"\"\n result_buffer = _ffi.new('char**')\n buffer_length = _lib.BIO_get_mem_data(bio, result_buffer)\n return _ffi.buffer(result_buffer[0], buffer_length)[:]\n\n\ndef _set_asn1_time(boundary, when):\n \"\"\"\n The the time value of an ASN1 time object.\n\n @param boundary: An ASN1_TIME pointer (or an object safely\n castable to that type) which will have its value set.\n @param when: A string representation of the desired time value.\n\n @raise TypeError: If C{when} is not a L{bytes} string.\n @raise ValueError: If C{when} does not represent a time in the required\n format.\n @raise RuntimeError: If the time value cannot be set for some other\n (unspecified) reason.\n \"\"\"\n if not isinstance(when, bytes):\n raise TypeError(\"when must be a byte string\")\n\n set_result = _lib.ASN1_TIME_set_string(boundary, when)\n if set_result == 0:\n raise ValueError(\"Invalid string\")\n\n\ndef _get_asn1_time(timestamp):\n \"\"\"\n Retrieve the time value of an ASN1 time object.\n\n @param timestamp: An ASN1_GENERALIZEDTIME* (or an object safely castable to\n that type) from which the time value will be retrieved.\n\n @return: The time value from C{timestamp} as a L{bytes} string in a certain\n format. Or C{None} if the object contains no time value.\n \"\"\"\n string_timestamp = _ffi.cast('ASN1_STRING*', timestamp)\n if _lib.ASN1_STRING_length(string_timestamp) == 0:\n return None\n elif (\n _lib.ASN1_STRING_type(string_timestamp) == _lib.V_ASN1_GENERALIZEDTIME\n ):\n return _ffi.string(_lib.ASN1_STRING_data(string_timestamp))\n else:\n generalized_timestamp = _ffi.new(\"ASN1_GENERALIZEDTIME**\")\n _lib.ASN1_TIME_to_generalizedtime(timestamp, generalized_timestamp)\n if generalized_timestamp[0] == _ffi.NULL:\n # This may happen:\n # - if timestamp was not an ASN1_TIME\n # - if allocating memory for the ASN1_GENERALIZEDTIME failed\n # - if a copy of the time data from timestamp cannot be made for\n # the newly allocated ASN1_GENERALIZEDTIME\n #\n # These are difficult to test. cffi enforces the ASN1_TIME type.\n # Memory allocation failures are a pain to trigger\n # deterministically.\n _untested_error(\"ASN1_TIME_to_generalizedtime\")\n else:\n string_timestamp = _ffi.cast(\n \"ASN1_STRING*\", generalized_timestamp[0])\n string_data = _lib.ASN1_STRING_data(string_timestamp)\n string_result = _ffi.string(string_data)\n _lib.ASN1_GENERALIZEDTIME_free(generalized_timestamp[0])\n return string_result\n\n\nclass _X509NameInvalidator(object):\n def __init__(self):\n self._names = []\n\n def add(self, name):\n self._names.append(name)\n\n def clear(self):\n for name in self._names:\n # Breaks the object, but also prevents UAF!\n del name._name\n\n\nclass PKey(object):\n \"\"\"\n A class representing an DSA or RSA public key or key pair.\n \"\"\"\n _only_public = False\n _initialized = True\n\n def __init__(self):\n pkey = _lib.EVP_PKEY_new()\n self._pkey = _ffi.gc(pkey, _lib.EVP_PKEY_free)\n self._initialized = False\n\n def to_cryptography_key(self):\n \"\"\"\n Export as a ``cryptography`` key.\n\n :rtype: One of ``cryptography``'s `key interfaces`_.\n\n .. _key interfaces: https://cryptography.io/en/latest/hazmat/\\\n primitives/asymmetric/rsa/#key-interfaces\n\n .. versionadded:: 16.1.0\n \"\"\"\n backend = _get_backend()\n if self._only_public:\n return backend._evp_pkey_to_public_key(self._pkey)\n else:\n return backend._evp_pkey_to_private_key(self._pkey)\n\n @classmethod\n def from_cryptography_key(cls, crypto_key):\n \"\"\"\n Construct based on a ``cryptography`` *crypto_key*.\n\n :param crypto_key: A ``cryptography`` key.\n :type crypto_key: One of ``cryptography``'s `key interfaces`_.\n\n :rtype: PKey\n\n .. versionadded:: 16.1.0\n \"\"\"\n pkey = cls()\n if not isinstance(crypto_key, (rsa.RSAPublicKey, rsa.RSAPrivateKey,\n dsa.DSAPublicKey, dsa.DSAPrivateKey)):\n raise TypeError(\"Unsupported key type\")\n\n pkey._pkey = crypto_key._evp_pkey\n if isinstance(crypto_key, (rsa.RSAPublicKey, dsa.DSAPublicKey)):\n pkey._only_public = True\n pkey._initialized = True\n return pkey\n\n def generate_key(self, type, bits):\n \"\"\"\n Generate a key pair of the given type, with the given number of bits.\n\n This generates a key \"into\" the this object.\n\n :param type: The key type.\n :type type: :py:data:`TYPE_RSA` or :py:data:`TYPE_DSA`\n :param bits: The number of bits.\n :type bits: :py:data:`int` ``>= 0``\n :raises TypeError: If :py:data:`type` or :py:data:`bits` isn't\n of the appropriate type.\n :raises ValueError: If the number of bits isn't an integer of\n the appropriate size.\n :return: ``None``\n \"\"\"\n if not isinstance(type, int):\n raise TypeError(\"type must be an integer\")\n\n if not isinstance(bits, int):\n raise TypeError(\"bits must be an integer\")\n\n if type == TYPE_RSA:\n if bits <= 0:\n raise ValueError(\"Invalid number of bits\")\n\n # TODO Check error return\n exponent = _lib.BN_new()\n exponent = _ffi.gc(exponent, _lib.BN_free)\n _lib.BN_set_word(exponent, _lib.RSA_F4)\n\n rsa = _lib.RSA_new()\n\n result = _lib.RSA_generate_key_ex(rsa, bits, exponent, _ffi.NULL)\n _openssl_assert(result == 1)\n\n result = _lib.EVP_PKEY_assign_RSA(self._pkey, rsa)\n _openssl_assert(result == 1)\n\n elif type == TYPE_DSA:\n dsa = _lib.DSA_new()\n _openssl_assert(dsa != _ffi.NULL)\n\n dsa = _ffi.gc(dsa, _lib.DSA_free)\n res = _lib.DSA_generate_parameters_ex(\n dsa, bits, _ffi.NULL, 0, _ffi.NULL, _ffi.NULL, _ffi.NULL\n )\n _openssl_assert(res == 1)\n\n _openssl_assert(_lib.DSA_generate_key(dsa) == 1)\n _openssl_assert(_lib.EVP_PKEY_set1_DSA(self._pkey, dsa) == 1)\n else:\n raise Error(\"No such key type\")\n\n self._initialized = True\n\n def check(self):\n \"\"\"\n Check the consistency of an RSA private key.\n\n This is the Python equivalent of OpenSSL's ``RSA_check_key``.\n\n :return: ``True`` if key is consistent.\n\n :raise OpenSSL.crypto.Error: if the key is inconsistent.\n\n :raise TypeError: if the key is of a type which cannot be checked.\n Only RSA keys can currently be checked.\n \"\"\"\n if self._only_public:\n raise TypeError(\"public key only\")\n\n if _lib.EVP_PKEY_type(self.type()) != _lib.EVP_PKEY_RSA:\n raise TypeError(\"key type unsupported\")\n\n rsa = _lib.EVP_PKEY_get1_RSA(self._pkey)\n rsa = _ffi.gc(rsa, _lib.RSA_free)\n result = _lib.RSA_check_key(rsa)\n if result:\n return True\n _raise_current_error()\n\n def type(self):\n \"\"\"\n Returns the type of the key\n\n :return: The type of the key.\n \"\"\"\n return _lib.EVP_PKEY_id(self._pkey)\n\n def bits(self):\n \"\"\"\n Returns the number of bits of the key\n\n :return: The number of bits of the key.\n \"\"\"\n return _lib.EVP_PKEY_bits(self._pkey)\n\n\nPKeyType = deprecated(\n PKey, __name__,\n \"PKeyType has been deprecated, use PKey instead\",\n DeprecationWarning\n)\n\n\nclass _EllipticCurve(object):\n \"\"\"\n A representation of a supported elliptic curve.\n\n @cvar _curves: :py:obj:`None` until an attempt is made to load the curves.\n Thereafter, a :py:type:`set` containing :py:type:`_EllipticCurve`\n instances each of which represents one curve supported by the system.\n @type _curves: :py:type:`NoneType` or :py:type:`set`\n \"\"\"\n _curves = None\n\n if _PY3:\n # This only necessary on Python 3. Morever, it is broken on Python 2.\n def __ne__(self, other):\n \"\"\"\n Implement cooperation with the right-hand side argument of ``!=``.\n\n Python 3 seems to have dropped this cooperation in this very narrow\n circumstance.\n \"\"\"\n if isinstance(other, _EllipticCurve):\n return super(_EllipticCurve, self).__ne__(other)\n return NotImplemented\n\n @classmethod\n def _load_elliptic_curves(cls, lib):\n \"\"\"\n Get the curves supported by OpenSSL.\n\n :param lib: The OpenSSL library binding object.\n\n :return: A :py:type:`set` of ``cls`` instances giving the names of the\n elliptic curves the underlying library supports.\n \"\"\"\n num_curves = lib.EC_get_builtin_curves(_ffi.NULL, 0)\n builtin_curves = _ffi.new('EC_builtin_curve[]', num_curves)\n # The return value on this call should be num_curves again. We\n # could check it to make sure but if it *isn't* then.. what could\n # we do? Abort the whole process, I suppose...? -exarkun\n lib.EC_get_builtin_curves(builtin_curves, num_curves)\n return set(\n cls.from_nid(lib, c.nid)\n for c in builtin_curves)\n\n @classmethod\n def _get_elliptic_curves(cls, lib):\n \"\"\"\n Get, cache, and return the curves supported by OpenSSL.\n\n :param lib: The OpenSSL library binding object.\n\n :return: A :py:type:`set` of ``cls`` instances giving the names of the\n elliptic curves the underlying library supports.\n \"\"\"\n if cls._curves is None:\n cls._curves = cls._load_elliptic_curves(lib)\n return cls._curves\n\n @classmethod\n def from_nid(cls, lib, nid):\n \"\"\"\n Instantiate a new :py:class:`_EllipticCurve` associated with the given\n OpenSSL NID.\n\n :param lib: The OpenSSL library binding object.\n\n :param nid: The OpenSSL NID the resulting curve object will represent.\n This must be a curve NID (and not, for example, a hash NID) or\n subsequent operations will fail in unpredictable ways.\n :type nid: :py:class:`int`\n\n :return: The curve object.\n \"\"\"\n return cls(lib, nid, _ffi.string(lib.OBJ_nid2sn(nid)).decode(\"ascii\"))\n\n def __init__(self, lib, nid, name):\n \"\"\"\n :param _lib: The :py:mod:`cryptography` binding instance used to\n interface with OpenSSL.\n\n :param _nid: The OpenSSL NID identifying the curve this object\n represents.\n :type _nid: :py:class:`int`\n\n :param name: The OpenSSL short name identifying the curve this object\n represents.\n :type name: :py:class:`unicode`\n \"\"\"\n self._lib = lib\n self._nid = nid\n self.name = name\n\n def __repr__(self):\n return \"\" % (self.name,)\n\n def _to_EC_KEY(self):\n \"\"\"\n Create a new OpenSSL EC_KEY structure initialized to use this curve.\n\n The structure is automatically garbage collected when the Python object\n is garbage collected.\n \"\"\"\n key = self._lib.EC_KEY_new_by_curve_name(self._nid)\n return _ffi.gc(key, _lib.EC_KEY_free)\n\n\ndef get_elliptic_curves():\n \"\"\"\n Return a set of objects representing the elliptic curves supported in the\n OpenSSL build in use.\n\n The curve objects have a :py:class:`unicode` ``name`` attribute by which\n they identify themselves.\n\n The curve objects are useful as values for the argument accepted by\n :py:meth:`Context.set_tmp_ecdh` to specify which elliptical curve should be\n used for ECDHE key exchange.\n \"\"\"\n return _EllipticCurve._get_elliptic_curves(_lib)\n\n\ndef get_elliptic_curve(name):\n \"\"\"\n Return a single curve object selected by name.\n\n See :py:func:`get_elliptic_curves` for information about curve objects.\n\n :param name: The OpenSSL short name identifying the curve object to\n retrieve.\n :type name: :py:class:`unicode`\n\n If the named curve is not supported then :py:class:`ValueError` is raised.\n \"\"\"\n for curve in get_elliptic_curves():\n if curve.name == name:\n return curve\n raise ValueError(\"unknown curve name\", name)\n\n\nclass X509Name(object):\n \"\"\"\n An X.509 Distinguished Name.\n\n :ivar countryName: The country of the entity.\n :ivar C: Alias for :py:attr:`countryName`.\n\n :ivar stateOrProvinceName: The state or province of the entity.\n :ivar ST: Alias for :py:attr:`stateOrProvinceName`.\n\n :ivar localityName: The locality of the entity.\n :ivar L: Alias for :py:attr:`localityName`.\n\n :ivar organizationName: The organization name of the entity.\n :ivar O: Alias for :py:attr:`organizationName`.\n\n :ivar organizationalUnitName: The organizational unit of the entity.\n :ivar OU: Alias for :py:attr:`organizationalUnitName`\n\n :ivar commonName: The common name of the entity.\n :ivar CN: Alias for :py:attr:`commonName`.\n\n :ivar emailAddress: The e-mail address of the entity.\n \"\"\"\n\n def __init__(self, name):\n \"\"\"\n Create a new X509Name, copying the given X509Name instance.\n\n :param name: The name to copy.\n :type name: :py:class:`X509Name`\n \"\"\"\n name = _lib.X509_NAME_dup(name._name)\n self._name = _ffi.gc(name, _lib.X509_NAME_free)\n\n def __setattr__(self, name, value):\n if name.startswith('_'):\n return super(X509Name, self).__setattr__(name, value)\n\n # Note: we really do not want str subclasses here, so we do not use\n # isinstance.\n if type(name) is not str:\n raise TypeError(\"attribute name must be string, not '%.200s'\" % (\n type(value).__name__,))\n\n nid = _lib.OBJ_txt2nid(_byte_string(name))\n if nid == _lib.NID_undef:\n try:\n _raise_current_error()\n except Error:\n pass\n raise AttributeError(\"No such attribute\")\n\n # If there's an old entry for this NID, remove it\n for i in range(_lib.X509_NAME_entry_count(self._name)):\n ent = _lib.X509_NAME_get_entry(self._name, i)\n ent_obj = _lib.X509_NAME_ENTRY_get_object(ent)\n ent_nid = _lib.OBJ_obj2nid(ent_obj)\n if nid == ent_nid:\n ent = _lib.X509_NAME_delete_entry(self._name, i)\n _lib.X509_NAME_ENTRY_free(ent)\n break\n\n if isinstance(value, _text_type):\n value = value.encode('utf-8')\n\n add_result = _lib.X509_NAME_add_entry_by_NID(\n self._name, nid, _lib.MBSTRING_UTF8, value, -1, -1, 0)\n if not add_result:\n _raise_current_error()\n\n def __getattr__(self, name):\n \"\"\"\n Find attribute. An X509Name object has the following attributes:\n countryName (alias C), stateOrProvince (alias ST), locality (alias L),\n organization (alias O), organizationalUnit (alias OU), commonName\n (alias CN) and more...\n \"\"\"\n nid = _lib.OBJ_txt2nid(_byte_string(name))\n if nid == _lib.NID_undef:\n # This is a bit weird. OBJ_txt2nid indicated failure, but it seems\n # a lower level function, a2d_ASN1_OBJECT, also feels the need to\n # push something onto the error queue. If we don't clean that up\n # now, someone else will bump into it later and be quite confused.\n # See lp#314814.\n try:\n _raise_current_error()\n except Error:\n pass\n return super(X509Name, self).__getattr__(name)\n\n entry_index = _lib.X509_NAME_get_index_by_NID(self._name, nid, -1)\n if entry_index == -1:\n return None\n\n entry = _lib.X509_NAME_get_entry(self._name, entry_index)\n data = _lib.X509_NAME_ENTRY_get_data(entry)\n\n result_buffer = _ffi.new(\"unsigned char**\")\n data_length = _lib.ASN1_STRING_to_UTF8(result_buffer, data)\n _openssl_assert(data_length >= 0)\n\n try:\n result = _ffi.buffer(\n result_buffer[0], data_length\n )[:].decode('utf-8')\n finally:\n # XXX untested\n _lib.OPENSSL_free(result_buffer[0])\n return result\n\n def _cmp(op):\n def f(self, other):\n if not isinstance(other, X509Name):\n return NotImplemented\n result = _lib.X509_NAME_cmp(self._name, other._name)\n return op(result, 0)\n return f\n\n __eq__ = _cmp(__eq__)\n __ne__ = _cmp(__ne__)\n\n __lt__ = _cmp(__lt__)\n __le__ = _cmp(__le__)\n\n __gt__ = _cmp(__gt__)\n __ge__ = _cmp(__ge__)\n\n def __repr__(self):\n \"\"\"\n String representation of an X509Name\n \"\"\"\n result_buffer = _ffi.new(\"char[]\", 512)\n format_result = _lib.X509_NAME_oneline(\n self._name, result_buffer, len(result_buffer))\n _openssl_assert(format_result != _ffi.NULL)\n\n return \"\" % (\n _native(_ffi.string(result_buffer)),)\n\n def hash(self):\n \"\"\"\n Return an integer representation of the first four bytes of the\n MD5 digest of the DER representation of the name.\n\n This is the Python equivalent of OpenSSL's ``X509_NAME_hash``.\n\n :return: The (integer) hash of this name.\n :rtype: :py:class:`int`\n \"\"\"\n return _lib.X509_NAME_hash(self._name)\n\n def der(self):\n \"\"\"\n Return the DER encoding of this name.\n\n :return: The DER encoded form of this name.\n :rtype: :py:class:`bytes`\n \"\"\"\n result_buffer = _ffi.new('unsigned char**')\n encode_result = _lib.i2d_X509_NAME(self._name, result_buffer)\n _openssl_assert(encode_result >= 0)\n\n string_result = _ffi.buffer(result_buffer[0], encode_result)[:]\n _lib.OPENSSL_free(result_buffer[0])\n return string_result\n\n def get_components(self):\n \"\"\"\n Returns the components of this name, as a sequence of 2-tuples.\n\n :return: The components of this name.\n :rtype: :py:class:`list` of ``name, value`` tuples.\n \"\"\"\n result = []\n for i in range(_lib.X509_NAME_entry_count(self._name)):\n ent = _lib.X509_NAME_get_entry(self._name, i)\n\n fname = _lib.X509_NAME_ENTRY_get_object(ent)\n fval = _lib.X509_NAME_ENTRY_get_data(ent)\n\n nid = _lib.OBJ_obj2nid(fname)\n name = _lib.OBJ_nid2sn(nid)\n\n # ffi.string does not handle strings containing NULL bytes\n # (which may have been generated by old, broken software)\n value = _ffi.buffer(_lib.ASN1_STRING_data(fval),\n _lib.ASN1_STRING_length(fval))[:]\n result.append((_ffi.string(name), value))\n\n return result\n\n\nX509NameType = deprecated(\n X509Name, __name__,\n \"X509NameType has been deprecated, use X509Name instead\",\n DeprecationWarning\n)\n\n\nclass X509Extension(object):\n \"\"\"\n An X.509 v3 certificate extension.\n \"\"\"\n\n def __init__(self, type_name, critical, value, subject=None, issuer=None):\n \"\"\"\n Initializes an X509 extension.\n\n :param type_name: The name of the type of extension_ to create.\n :type type_name: :py:data:`bytes`\n\n :param bool critical: A flag indicating whether this is a critical\n extension.\n\n :param value: The value of the extension.\n :type value: :py:data:`bytes`\n\n :param subject: Optional X509 certificate to use as subject.\n :type subject: :py:class:`X509`\n\n :param issuer: Optional X509 certificate to use as issuer.\n :type issuer: :py:class:`X509`\n\n .. _extension: https://www.openssl.org/docs/manmaster/man5/\n x509v3_config.html#STANDARD-EXTENSIONS\n \"\"\"\n ctx = _ffi.new(\"X509V3_CTX*\")\n\n # A context is necessary for any extension which uses the r2i\n # conversion method. That is, X509V3_EXT_nconf may segfault if passed\n # a NULL ctx. Start off by initializing most of the fields to NULL.\n _lib.X509V3_set_ctx(ctx, _ffi.NULL, _ffi.NULL, _ffi.NULL, _ffi.NULL, 0)\n\n # We have no configuration database - but perhaps we should (some\n # extensions may require it).\n _lib.X509V3_set_ctx_nodb(ctx)\n\n # Initialize the subject and issuer, if appropriate. ctx is a local,\n # and as far as I can tell none of the X509V3_* APIs invoked here steal\n # any references, so no need to mess with reference counts or\n # duplicates.\n if issuer is not None:\n if not isinstance(issuer, X509):\n raise TypeError(\"issuer must be an X509 instance\")\n ctx.issuer_cert = issuer._x509\n if subject is not None:\n if not isinstance(subject, X509):\n raise TypeError(\"subject must be an X509 instance\")\n ctx.subject_cert = subject._x509\n\n if critical:\n # There are other OpenSSL APIs which would let us pass in critical\n # separately, but they're harder to use, and since value is already\n # a pile of crappy junk smuggling a ton of utterly important\n # structured data, what's the point of trying to avoid nasty stuff\n # with strings? (However, X509V3_EXT_i2d in particular seems like\n # it would be a better API to invoke. I do not know where to get\n # the ext_struc it desires for its last parameter, though.)\n value = b\"critical,\" + value\n\n extension = _lib.X509V3_EXT_nconf(_ffi.NULL, ctx, type_name, value)\n if extension == _ffi.NULL:\n _raise_current_error()\n self._extension = _ffi.gc(extension, _lib.X509_EXTENSION_free)\n\n @property\n def _nid(self):\n return _lib.OBJ_obj2nid(\n _lib.X509_EXTENSION_get_object(self._extension)\n )\n\n _prefixes = {\n _lib.GEN_EMAIL: \"email\",\n _lib.GEN_DNS: \"DNS\",\n _lib.GEN_URI: \"URI\",\n }\n\n def _subjectAltNameString(self):\n names = _ffi.cast(\n \"GENERAL_NAMES*\", _lib.X509V3_EXT_d2i(self._extension)\n )\n\n names = _ffi.gc(names, _lib.GENERAL_NAMES_free)\n parts = []\n for i in range(_lib.sk_GENERAL_NAME_num(names)):\n name = _lib.sk_GENERAL_NAME_value(names, i)\n try:\n label = self._prefixes[name.type]\n except KeyError:\n bio = _new_mem_buf()\n _lib.GENERAL_NAME_print(bio, name)\n parts.append(_native(_bio_to_string(bio)))\n else:\n value = _native(\n _ffi.buffer(name.d.ia5.data, name.d.ia5.length)[:])\n parts.append(label + \":\" + value)\n return \", \".join(parts)\n\n def __str__(self):\n \"\"\"\n :return: a nice text representation of the extension\n \"\"\"\n if _lib.NID_subject_alt_name == self._nid:\n return self._subjectAltNameString()\n\n bio = _new_mem_buf()\n print_result = _lib.X509V3_EXT_print(bio, self._extension, 0, 0)\n _openssl_assert(print_result != 0)\n\n return _native(_bio_to_string(bio))\n\n def get_critical(self):\n \"\"\"\n Returns the critical field of this X.509 extension.\n\n :return: The critical field.\n \"\"\"\n return _lib.X509_EXTENSION_get_critical(self._extension)\n\n def get_short_name(self):\n \"\"\"\n Returns the short type name of this X.509 extension.\n\n The result is a byte string such as :py:const:`b\"basicConstraints\"`.\n\n :return: The short type name.\n :rtype: :py:data:`bytes`\n\n .. versionadded:: 0.12\n \"\"\"\n obj = _lib.X509_EXTENSION_get_object(self._extension)\n nid = _lib.OBJ_obj2nid(obj)\n return _ffi.string(_lib.OBJ_nid2sn(nid))\n\n def get_data(self):\n \"\"\"\n Returns the data of the X509 extension, encoded as ASN.1.\n\n :return: The ASN.1 encoded data of this X509 extension.\n :rtype: :py:data:`bytes`\n\n .. versionadded:: 0.12\n \"\"\"\n octet_result = _lib.X509_EXTENSION_get_data(self._extension)\n string_result = _ffi.cast('ASN1_STRING*', octet_result)\n char_result = _lib.ASN1_STRING_data(string_result)\n result_length = _lib.ASN1_STRING_length(string_result)\n return _ffi.buffer(char_result, result_length)[:]\n\n\nX509ExtensionType = deprecated(\n X509Extension, __name__,\n \"X509ExtensionType has been deprecated, use X509Extension instead\",\n DeprecationWarning\n)\n\n\nclass X509Req(object):\n \"\"\"\n An X.509 certificate signing requests.\n \"\"\"\n\n def __init__(self):\n req = _lib.X509_REQ_new()\n self._req = _ffi.gc(req, _lib.X509_REQ_free)\n # Default to version 0.\n self.set_version(0)\n\n def to_cryptography(self):\n \"\"\"\n Export as a ``cryptography`` certificate signing request.\n\n :rtype: ``cryptography.x509.CertificateSigningRequest``\n\n .. versionadded:: 17.1.0\n \"\"\"\n from cryptography.hazmat.backends.openssl.x509 import (\n _CertificateSigningRequest\n )\n backend = _get_backend()\n return _CertificateSigningRequest(backend, self._req)\n\n @classmethod\n def from_cryptography(cls, crypto_req):\n \"\"\"\n Construct based on a ``cryptography`` *crypto_req*.\n\n :param crypto_req: A ``cryptography`` X.509 certificate signing request\n :type crypto_req: ``cryptography.x509.CertificateSigningRequest``\n\n :rtype: X509Req\n\n .. versionadded:: 17.1.0\n \"\"\"\n if not isinstance(crypto_req, x509.CertificateSigningRequest):\n raise TypeError(\"Must be a certificate signing request\")\n\n req = cls()\n req._req = crypto_req._x509_req\n return req\n\n def set_pubkey(self, pkey):\n \"\"\"\n Set the public key of the certificate signing request.\n\n :param pkey: The public key to use.\n :type pkey: :py:class:`PKey`\n\n :return: ``None``\n \"\"\"\n set_result = _lib.X509_REQ_set_pubkey(self._req, pkey._pkey)\n _openssl_assert(set_result == 1)\n\n def get_pubkey(self):\n \"\"\"\n Get the public key of the certificate signing request.\n\n :return: The public key.\n :rtype: :py:class:`PKey`\n \"\"\"\n pkey = PKey.__new__(PKey)\n pkey._pkey = _lib.X509_REQ_get_pubkey(self._req)\n _openssl_assert(pkey._pkey != _ffi.NULL)\n pkey._pkey = _ffi.gc(pkey._pkey, _lib.EVP_PKEY_free)\n pkey._only_public = True\n return pkey\n\n def set_version(self, version):\n \"\"\"\n Set the version subfield (RFC 2459, section 4.1.2.1) of the certificate\n request.\n\n :param int version: The version number.\n :return: ``None``\n \"\"\"\n set_result = _lib.X509_REQ_set_version(self._req, version)\n _openssl_assert(set_result == 1)\n\n def get_version(self):\n \"\"\"\n Get the version subfield (RFC 2459, section 4.1.2.1) of the certificate\n request.\n\n :return: The value of the version subfield.\n :rtype: :py:class:`int`\n \"\"\"\n return _lib.X509_REQ_get_version(self._req)\n\n def get_subject(self):\n \"\"\"\n Return the subject of this certificate signing request.\n\n This creates a new :class:`X509Name` that wraps the underlying subject\n name field on the certificate signing request. Modifying it will modify\n the underlying signing request, and will have the effect of modifying\n any other :class:`X509Name` that refers to this subject.\n\n :return: The subject of this certificate signing request.\n :rtype: :class:`X509Name`\n \"\"\"\n name = X509Name.__new__(X509Name)\n name._name = _lib.X509_REQ_get_subject_name(self._req)\n _openssl_assert(name._name != _ffi.NULL)\n\n # The name is owned by the X509Req structure. As long as the X509Name\n # Python object is alive, keep the X509Req Python object alive.\n name._owner = self\n\n return name\n\n def add_extensions(self, extensions):\n \"\"\"\n Add extensions to the certificate signing request.\n\n :param extensions: The X.509 extensions to add.\n :type extensions: iterable of :py:class:`X509Extension`\n :return: ``None``\n \"\"\"\n stack = _lib.sk_X509_EXTENSION_new_null()\n _openssl_assert(stack != _ffi.NULL)\n\n stack = _ffi.gc(stack, _lib.sk_X509_EXTENSION_free)\n\n for ext in extensions:\n if not isinstance(ext, X509Extension):\n raise ValueError(\"One of the elements is not an X509Extension\")\n\n # TODO push can fail (here and elsewhere)\n _lib.sk_X509_EXTENSION_push(stack, ext._extension)\n\n add_result = _lib.X509_REQ_add_extensions(self._req, stack)\n _openssl_assert(add_result == 1)\n\n def get_extensions(self):\n \"\"\"\n Get X.509 extensions in the certificate signing request.\n\n :return: The X.509 extensions in this request.\n :rtype: :py:class:`list` of :py:class:`X509Extension` objects.\n\n .. versionadded:: 0.15\n \"\"\"\n exts = []\n native_exts_obj = _lib.X509_REQ_get_extensions(self._req)\n for i in range(_lib.sk_X509_EXTENSION_num(native_exts_obj)):\n ext = X509Extension.__new__(X509Extension)\n ext._extension = _lib.sk_X509_EXTENSION_value(native_exts_obj, i)\n exts.append(ext)\n return exts\n\n def sign(self, pkey, digest):\n \"\"\"\n Sign the certificate signing request with this key and digest type.\n\n :param pkey: The key pair to sign with.\n :type pkey: :py:class:`PKey`\n :param digest: The name of the message digest to use for the signature,\n e.g. :py:data:`b\"sha256\"`.\n :type digest: :py:class:`bytes`\n :return: ``None``\n \"\"\"\n if pkey._only_public:\n raise ValueError(\"Key has only public part\")\n\n if not pkey._initialized:\n raise ValueError(\"Key is uninitialized\")\n\n digest_obj = _lib.EVP_get_digestbyname(_byte_string(digest))\n if digest_obj == _ffi.NULL:\n raise ValueError(\"No such digest method\")\n\n sign_result = _lib.X509_REQ_sign(self._req, pkey._pkey, digest_obj)\n _openssl_assert(sign_result > 0)\n\n def verify(self, pkey):\n \"\"\"\n Verifies the signature on this certificate signing request.\n\n :param PKey key: A public key.\n\n :return: ``True`` if the signature is correct.\n :rtype: bool\n\n :raises OpenSSL.crypto.Error: If the signature is invalid or there is a\n problem verifying the signature.\n \"\"\"\n if not isinstance(pkey, PKey):\n raise TypeError(\"pkey must be a PKey instance\")\n\n result = _lib.X509_REQ_verify(self._req, pkey._pkey)\n if result <= 0:\n _raise_current_error()\n\n return result\n\n\nX509ReqType = deprecated(\n X509Req, __name__,\n \"X509ReqType has been deprecated, use X509Req instead\",\n DeprecationWarning\n)\n\n\nclass X509(object):\n \"\"\"\n An X.509 certificate.\n \"\"\"\n def __init__(self):\n x509 = _lib.X509_new()\n _openssl_assert(x509 != _ffi.NULL)\n self._x509 = _ffi.gc(x509, _lib.X509_free)\n\n self._issuer_invalidator = _X509NameInvalidator()\n self._subject_invalidator = _X509NameInvalidator()\n\n @classmethod\n def _from_raw_x509_ptr(cls, x509):\n cert = cls.__new__(cls)\n cert._x509 = _ffi.gc(x509, _lib.X509_free)\n cert._issuer_invalidator = _X509NameInvalidator()\n cert._subject_invalidator = _X509NameInvalidator()\n return cert\n\n def to_cryptography(self):\n \"\"\"\n Export as a ``cryptography`` certificate.\n\n :rtype: ``cryptography.x509.Certificate``\n\n .. versionadded:: 17.1.0\n \"\"\"\n from cryptography.hazmat.backends.openssl.x509 import _Certificate\n backend = _get_backend()\n return _Certificate(backend, self._x509)\n\n @classmethod\n def from_cryptography(cls, crypto_cert):\n \"\"\"\n Construct based on a ``cryptography`` *crypto_cert*.\n\n :param crypto_key: A ``cryptography`` X.509 certificate.\n :type crypto_key: ``cryptography.x509.Certificate``\n\n :rtype: X509\n\n .. versionadded:: 17.1.0\n \"\"\"\n if not isinstance(crypto_cert, x509.Certificate):\n raise TypeError(\"Must be a certificate\")\n\n cert = cls()\n cert._x509 = crypto_cert._x509\n return cert\n\n def set_version(self, version):\n \"\"\"\n Set the version number of the certificate. Note that the\n version value is zero-based, eg. a value of 0 is V1.\n\n :param version: The version number of the certificate.\n :type version: :py:class:`int`\n\n :return: ``None``\n \"\"\"\n if not isinstance(version, int):\n raise TypeError(\"version must be an integer\")\n\n _lib.X509_set_version(self._x509, version)\n\n def get_version(self):\n \"\"\"\n Return the version number of the certificate.\n\n :return: The version number of the certificate.\n :rtype: :py:class:`int`\n \"\"\"\n return _lib.X509_get_version(self._x509)\n\n def get_pubkey(self):\n \"\"\"\n Get the public key of the certificate.\n\n :return: The public key.\n :rtype: :py:class:`PKey`\n \"\"\"\n pkey = PKey.__new__(PKey)\n pkey._pkey = _lib.X509_get_pubkey(self._x509)\n if pkey._pkey == _ffi.NULL:\n _raise_current_error()\n pkey._pkey = _ffi.gc(pkey._pkey, _lib.EVP_PKEY_free)\n pkey._only_public = True\n return pkey\n\n def set_pubkey(self, pkey):\n \"\"\"\n Set the public key of the certificate.\n\n :param pkey: The public key.\n :type pkey: :py:class:`PKey`\n\n :return: :py:data:`None`\n \"\"\"\n if not isinstance(pkey, PKey):\n raise TypeError(\"pkey must be a PKey instance\")\n\n set_result = _lib.X509_set_pubkey(self._x509, pkey._pkey)\n _openssl_assert(set_result == 1)\n\n def sign(self, pkey, digest):\n \"\"\"\n Sign the certificate with this key and digest type.\n\n :param pkey: The key to sign with.\n :type pkey: :py:class:`PKey`\n\n :param digest: The name of the message digest to use.\n :type digest: :py:class:`bytes`\n\n :return: :py:data:`None`\n \"\"\"\n if not isinstance(pkey, PKey):\n raise TypeError(\"pkey must be a PKey instance\")\n\n if pkey._only_public:\n raise ValueError(\"Key only has public part\")\n\n if not pkey._initialized:\n raise ValueError(\"Key is uninitialized\")\n\n evp_md = _lib.EVP_get_digestbyname(_byte_string(digest))\n if evp_md == _ffi.NULL:\n raise ValueError(\"No such digest method\")\n\n sign_result = _lib.X509_sign(self._x509, pkey._pkey, evp_md)\n _openssl_assert(sign_result > 0)\n\n def get_signature_algorithm(self):\n \"\"\"\n Return the signature algorithm used in the certificate.\n\n :return: The name of the algorithm.\n :rtype: :py:class:`bytes`\n\n :raises ValueError: If the signature algorithm is undefined.\n\n .. versionadded:: 0.13\n \"\"\"\n algor = _lib.X509_get0_tbs_sigalg(self._x509)\n nid = _lib.OBJ_obj2nid(algor.algorithm)\n if nid == _lib.NID_undef:\n raise ValueError(\"Undefined signature algorithm\")\n return _ffi.string(_lib.OBJ_nid2ln(nid))\n\n def digest(self, digest_name):\n \"\"\"\n Return the digest of the X509 object.\n\n :param digest_name: The name of the digest algorithm to use.\n :type digest_name: :py:class:`bytes`\n\n :return: The digest of the object, formatted as\n :py:const:`b\":\"`-delimited hex pairs.\n :rtype: :py:class:`bytes`\n \"\"\"\n digest = _lib.EVP_get_digestbyname(_byte_string(digest_name))\n if digest == _ffi.NULL:\n raise ValueError(\"No such digest method\")\n\n result_buffer = _ffi.new(\"unsigned char[]\", _lib.EVP_MAX_MD_SIZE)\n result_length = _ffi.new(\"unsigned int[]\", 1)\n result_length[0] = len(result_buffer)\n\n digest_result = _lib.X509_digest(\n self._x509, digest, result_buffer, result_length)\n _openssl_assert(digest_result == 1)\n\n return b\":\".join([\n b16encode(ch).upper() for ch\n in _ffi.buffer(result_buffer, result_length[0])])\n\n def subject_name_hash(self):\n \"\"\"\n Return the hash of the X509 subject.\n\n :return: The hash of the subject.\n :rtype: :py:class:`bytes`\n \"\"\"\n return _lib.X509_subject_name_hash(self._x509)\n\n def set_serial_number(self, serial):\n \"\"\"\n Set the serial number of the certificate.\n\n :param serial: The new serial number.\n :type serial: :py:class:`int`\n\n :return: :py:data`None`\n \"\"\"\n if not isinstance(serial, _integer_types):\n raise TypeError(\"serial must be an integer\")\n\n hex_serial = hex(serial)[2:]\n if not isinstance(hex_serial, bytes):\n hex_serial = hex_serial.encode('ascii')\n\n bignum_serial = _ffi.new(\"BIGNUM**\")\n\n # BN_hex2bn stores the result in &bignum. Unless it doesn't feel like\n # it. If bignum is still NULL after this call, then the return value\n # is actually the result. I hope. -exarkun\n small_serial = _lib.BN_hex2bn(bignum_serial, hex_serial)\n\n if bignum_serial[0] == _ffi.NULL:\n set_result = _lib.ASN1_INTEGER_set(\n _lib.X509_get_serialNumber(self._x509), small_serial)\n if set_result:\n # TODO Not tested\n _raise_current_error()\n else:\n asn1_serial = _lib.BN_to_ASN1_INTEGER(bignum_serial[0], _ffi.NULL)\n _lib.BN_free(bignum_serial[0])\n if asn1_serial == _ffi.NULL:\n # TODO Not tested\n _raise_current_error()\n asn1_serial = _ffi.gc(asn1_serial, _lib.ASN1_INTEGER_free)\n set_result = _lib.X509_set_serialNumber(self._x509, asn1_serial)\n _openssl_assert(set_result == 1)\n\n def get_serial_number(self):\n \"\"\"\n Return the serial number of this certificate.\n\n :return: The serial number.\n :rtype: int\n \"\"\"\n asn1_serial = _lib.X509_get_serialNumber(self._x509)\n bignum_serial = _lib.ASN1_INTEGER_to_BN(asn1_serial, _ffi.NULL)\n try:\n hex_serial = _lib.BN_bn2hex(bignum_serial)\n try:\n hexstring_serial = _ffi.string(hex_serial)\n serial = int(hexstring_serial, 16)\n return serial\n finally:\n _lib.OPENSSL_free(hex_serial)\n finally:\n _lib.BN_free(bignum_serial)\n\n def gmtime_adj_notAfter(self, amount):\n \"\"\"\n Adjust the time stamp on which the certificate stops being valid.\n\n :param int amount: The number of seconds by which to adjust the\n timestamp.\n :return: ``None``\n \"\"\"\n if not isinstance(amount, int):\n raise TypeError(\"amount must be an integer\")\n\n notAfter = _lib.X509_get_notAfter(self._x509)\n _lib.X509_gmtime_adj(notAfter, amount)\n\n def gmtime_adj_notBefore(self, amount):\n \"\"\"\n Adjust the timestamp on which the certificate starts being valid.\n\n :param amount: The number of seconds by which to adjust the timestamp.\n :return: ``None``\n \"\"\"\n if not isinstance(amount, int):\n raise TypeError(\"amount must be an integer\")\n\n notBefore = _lib.X509_get_notBefore(self._x509)\n _lib.X509_gmtime_adj(notBefore, amount)\n\n def has_expired(self):\n \"\"\"\n Check whether the certificate has expired.\n\n :return: ``True`` if the certificate has expired, ``False`` otherwise.\n :rtype: bool\n \"\"\"\n time_string = _native(self.get_notAfter())\n not_after = datetime.datetime.strptime(time_string, \"%Y%m%d%H%M%SZ\")\n\n return not_after < datetime.datetime.utcnow()\n\n def _get_boundary_time(self, which):\n return _get_asn1_time(which(self._x509))\n\n def get_notBefore(self):\n \"\"\"\n Get the timestamp at which the certificate starts being valid.\n\n The timestamp is formatted as an ASN.1 TIME::\n\n YYYYMMDDhhmmssZ\n\n :return: A timestamp string, or ``None`` if there is none.\n :rtype: bytes or NoneType\n \"\"\"\n return self._get_boundary_time(_lib.X509_get_notBefore)\n\n def _set_boundary_time(self, which, when):\n return _set_asn1_time(which(self._x509), when)\n\n def set_notBefore(self, when):\n \"\"\"\n Set the timestamp at which the certificate starts being valid.\n\n The timestamp is formatted as an ASN.1 TIME::\n\n YYYYMMDDhhmmssZ\n\n :param bytes when: A timestamp string.\n :return: ``None``\n \"\"\"\n return self._set_boundary_time(_lib.X509_get_notBefore, when)\n\n def get_notAfter(self):\n \"\"\"\n Get the timestamp at which the certificate stops being valid.\n\n The timestamp is formatted as an ASN.1 TIME::\n\n YYYYMMDDhhmmssZ\n\n :return: A timestamp string, or ``None`` if there is none.\n :rtype: bytes or NoneType\n \"\"\"\n return self._get_boundary_time(_lib.X509_get_notAfter)\n\n def set_notAfter(self, when):\n \"\"\"\n Set the timestamp at which the certificate stops being valid.\n\n The timestamp is formatted as an ASN.1 TIME::\n\n YYYYMMDDhhmmssZ\n\n :param bytes when: A timestamp string.\n :return: ``None``\n \"\"\"\n return self._set_boundary_time(_lib.X509_get_notAfter, when)\n\n def _get_name(self, which):\n name = X509Name.__new__(X509Name)\n name._name = which(self._x509)\n _openssl_assert(name._name != _ffi.NULL)\n\n # The name is owned by the X509 structure. As long as the X509Name\n # Python object is alive, keep the X509 Python object alive.\n name._owner = self\n\n return name\n\n def _set_name(self, which, name):\n if not isinstance(name, X509Name):\n raise TypeError(\"name must be an X509Name\")\n set_result = which(self._x509, name._name)\n _openssl_assert(set_result == 1)\n\n def get_issuer(self):\n \"\"\"\n Return the issuer of this certificate.\n\n This creates a new :class:`X509Name` that wraps the underlying issuer\n name field on the certificate. Modifying it will modify the underlying\n certificate, and will have the effect of modifying any other\n :class:`X509Name` that refers to this issuer.\n\n :return: The issuer of this certificate.\n :rtype: :class:`X509Name`\n \"\"\"\n name = self._get_name(_lib.X509_get_issuer_name)\n self._issuer_invalidator.add(name)\n return name\n\n def set_issuer(self, issuer):\n \"\"\"\n Set the issuer of this certificate.\n\n :param issuer: The issuer.\n :type issuer: :py:class:`X509Name`\n\n :return: ``None``\n \"\"\"\n self._set_name(_lib.X509_set_issuer_name, issuer)\n self._issuer_invalidator.clear()\n\n def get_subject(self):\n \"\"\"\n Return the subject of this certificate.\n\n This creates a new :class:`X509Name` that wraps the underlying subject\n name field on the certificate. Modifying it will modify the underlying\n certificate, and will have the effect of modifying any other\n :class:`X509Name` that refers to this subject.\n\n :return: The subject of this certificate.\n :rtype: :class:`X509Name`\n \"\"\"\n name = self._get_name(_lib.X509_get_subject_name)\n self._subject_invalidator.add(name)\n return name\n\n def set_subject(self, subject):\n \"\"\"\n Set the subject of this certificate.\n\n :param subject: The subject.\n :type subject: :py:class:`X509Name`\n\n :return: ``None``\n \"\"\"\n self._set_name(_lib.X509_set_subject_name, subject)\n self._subject_invalidator.clear()\n\n def get_extension_count(self):\n \"\"\"\n Get the number of extensions on this certificate.\n\n :return: The number of extensions.\n :rtype: :py:class:`int`\n\n .. versionadded:: 0.12\n \"\"\"\n return _lib.X509_get_ext_count(self._x509)\n\n def add_extensions(self, extensions):\n \"\"\"\n Add extensions to the certificate.\n\n :param extensions: The extensions to add.\n :type extensions: An iterable of :py:class:`X509Extension` objects.\n :return: ``None``\n \"\"\"\n for ext in extensions:\n if not isinstance(ext, X509Extension):\n raise ValueError(\"One of the elements is not an X509Extension\")\n\n add_result = _lib.X509_add_ext(self._x509, ext._extension, -1)\n if not add_result:\n _raise_current_error()\n\n def get_extension(self, index):\n \"\"\"\n Get a specific extension of the certificate by index.\n\n Extensions on a certificate are kept in order. The index\n parameter selects which extension will be returned.\n\n :param int index: The index of the extension to retrieve.\n :return: The extension at the specified index.\n :rtype: :py:class:`X509Extension`\n :raises IndexError: If the extension index was out of bounds.\n\n .. versionadded:: 0.12\n \"\"\"\n ext = X509Extension.__new__(X509Extension)\n ext._extension = _lib.X509_get_ext(self._x509, index)\n if ext._extension == _ffi.NULL:\n raise IndexError(\"extension index out of bounds\")\n\n extension = _lib.X509_EXTENSION_dup(ext._extension)\n ext._extension = _ffi.gc(extension, _lib.X509_EXTENSION_free)\n return ext\n\n\nX509Type = deprecated(\n X509, __name__,\n \"X509Type has been deprecated, use X509 instead\",\n DeprecationWarning\n)\n\n\nclass X509StoreFlags(object):\n \"\"\"\n Flags for X509 verification, used to change the behavior of\n :class:`X509Store`.\n\n See `OpenSSL Verification Flags`_ for details.\n\n .. _OpenSSL Verification Flags:\n https://www.openssl.org/docs/manmaster/man3/X509_VERIFY_PARAM_set_flags.html\n \"\"\"\n CRL_CHECK = _lib.X509_V_FLAG_CRL_CHECK\n CRL_CHECK_ALL = _lib.X509_V_FLAG_CRL_CHECK_ALL\n IGNORE_CRITICAL = _lib.X509_V_FLAG_IGNORE_CRITICAL\n X509_STRICT = _lib.X509_V_FLAG_X509_STRICT\n ALLOW_PROXY_CERTS = _lib.X509_V_FLAG_ALLOW_PROXY_CERTS\n POLICY_CHECK = _lib.X509_V_FLAG_POLICY_CHECK\n EXPLICIT_POLICY = _lib.X509_V_FLAG_EXPLICIT_POLICY\n INHIBIT_MAP = _lib.X509_V_FLAG_INHIBIT_MAP\n NOTIFY_POLICY = _lib.X509_V_FLAG_NOTIFY_POLICY\n CHECK_SS_SIGNATURE = _lib.X509_V_FLAG_CHECK_SS_SIGNATURE\n CB_ISSUER_CHECK = _lib.X509_V_FLAG_CB_ISSUER_CHECK\n\n\nclass X509Store(object):\n \"\"\"\n An X.509 store.\n\n An X.509 store is used to describe a context in which to verify a\n certificate. A description of a context may include a set of certificates\n to trust, a set of certificate revocation lists, verification flags and\n more.\n\n An X.509 store, being only a description, cannot be used by itself to\n verify a certificate. To carry out the actual verification process, see\n :class:`X509StoreContext`.\n \"\"\"\n\n def __init__(self):\n store = _lib.X509_STORE_new()\n self._store = _ffi.gc(store, _lib.X509_STORE_free)\n\n def add_cert(self, cert):\n \"\"\"\n Adds a trusted certificate to this store.\n\n Adding a certificate with this method adds this certificate as a\n *trusted* certificate.\n\n :param X509 cert: The certificate to add to this store.\n\n :raises TypeError: If the certificate is not an :class:`X509`.\n\n :raises OpenSSL.crypto.Error: If OpenSSL was unhappy with your\n certificate.\n\n :return: ``None`` if the certificate was added successfully.\n \"\"\"\n if not isinstance(cert, X509):\n raise TypeError()\n\n # As of OpenSSL 1.1.0i adding the same cert to the store more than\n # once doesn't cause an error. Accordingly, this code now silences\n # the error for OpenSSL < 1.1.0i as well.\n if _lib.X509_STORE_add_cert(self._store, cert._x509) == 0:\n code = _lib.ERR_peek_error()\n err_reason = _lib.ERR_GET_REASON(code)\n _openssl_assert(\n err_reason == _lib.X509_R_CERT_ALREADY_IN_HASH_TABLE\n )\n _lib.ERR_clear_error()\n\n def add_crl(self, crl):\n \"\"\"\n Add a certificate revocation list to this store.\n\n The certificate revocation lists added to a store will only be used if\n the associated flags are configured to check certificate revocation\n lists.\n\n .. versionadded:: 16.1.0\n\n :param CRL crl: The certificate revocation list to add to this store.\n :return: ``None`` if the certificate revocation list was added\n successfully.\n \"\"\"\n _openssl_assert(_lib.X509_STORE_add_crl(self._store, crl._crl) != 0)\n\n def set_flags(self, flags):\n \"\"\"\n Set verification flags to this store.\n\n Verification flags can be combined by oring them together.\n\n .. note::\n\n Setting a verification flag sometimes requires clients to add\n additional information to the store, otherwise a suitable error will\n be raised.\n\n For example, in setting flags to enable CRL checking a\n suitable CRL must be added to the store otherwise an error will be\n raised.\n\n .. versionadded:: 16.1.0\n\n :param int flags: The verification flags to set on this store.\n See :class:`X509StoreFlags` for available constants.\n :return: ``None`` if the verification flags were successfully set.\n \"\"\"\n _openssl_assert(_lib.X509_STORE_set_flags(self._store, flags) != 0)\n\n def set_time(self, vfy_time):\n \"\"\"\n Set the time against which the certificates are verified.\n\n Normally the current time is used.\n\n .. note::\n\n For example, you can determine if a certificate was valid at a given\n time.\n\n .. versionadded:: 17.0.0\n\n :param datetime vfy_time: The verification time to set on this store.\n :return: ``None`` if the verification time was successfully set.\n \"\"\"\n param = _lib.X509_VERIFY_PARAM_new()\n param = _ffi.gc(param, _lib.X509_VERIFY_PARAM_free)\n\n _lib.X509_VERIFY_PARAM_set_time(param, int(vfy_time.strftime('%s')))\n _openssl_assert(_lib.X509_STORE_set1_param(self._store, param) != 0)\n\n\nX509StoreType = deprecated(\n X509Store, __name__,\n \"X509StoreType has been deprecated, use X509Store instead\",\n DeprecationWarning\n)\n\n\nclass X509StoreContextError(Exception):\n \"\"\"\n An exception raised when an error occurred while verifying a certificate\n using `OpenSSL.X509StoreContext.verify_certificate`.\n\n :ivar certificate: The certificate which caused verificate failure.\n :type certificate: :class:`X509`\n \"\"\"\n\n def __init__(self, message, certificate):\n super(X509StoreContextError, self).__init__(message)\n self.certificate = certificate\n\n\nclass X509StoreContext(object):\n \"\"\"\n An X.509 store context.\n\n An X.509 store context is used to carry out the actual verification process\n of a certificate in a described context. For describing such a context, see\n :class:`X509Store`.\n\n :ivar _store_ctx: The underlying X509_STORE_CTX structure used by this\n instance. It is dynamically allocated and automatically garbage\n collected.\n :ivar _store: See the ``store`` ``__init__`` parameter.\n :ivar _cert: See the ``certificate`` ``__init__`` parameter.\n :param X509Store store: The certificates which will be trusted for the\n purposes of any verifications.\n :param X509 certificate: The certificate to be verified.\n \"\"\"\n\n def __init__(self, store, certificate):\n store_ctx = _lib.X509_STORE_CTX_new()\n self._store_ctx = _ffi.gc(store_ctx, _lib.X509_STORE_CTX_free)\n self._store = store\n self._cert = certificate\n # Make the store context available for use after instantiating this\n # class by initializing it now. Per testing, subsequent calls to\n # :meth:`_init` have no adverse affect.\n self._init()\n\n def _init(self):\n \"\"\"\n Set up the store context for a subsequent verification operation.\n\n Calling this method more than once without first calling\n :meth:`_cleanup` will leak memory.\n \"\"\"\n ret = _lib.X509_STORE_CTX_init(\n self._store_ctx, self._store._store, self._cert._x509, _ffi.NULL\n )\n if ret <= 0:\n _raise_current_error()\n\n def _cleanup(self):\n \"\"\"\n Internally cleans up the store context.\n\n The store context can then be reused with a new call to :meth:`_init`.\n \"\"\"\n _lib.X509_STORE_CTX_cleanup(self._store_ctx)\n\n def _exception_from_context(self):\n \"\"\"\n Convert an OpenSSL native context error failure into a Python\n exception.\n\n When a call to native OpenSSL X509_verify_cert fails, additional\n information about the failure can be obtained from the store context.\n \"\"\"\n errors = [\n _lib.X509_STORE_CTX_get_error(self._store_ctx),\n _lib.X509_STORE_CTX_get_error_depth(self._store_ctx),\n _native(_ffi.string(_lib.X509_verify_cert_error_string(\n _lib.X509_STORE_CTX_get_error(self._store_ctx)))),\n ]\n # A context error should always be associated with a certificate, so we\n # expect this call to never return :class:`None`.\n _x509 = _lib.X509_STORE_CTX_get_current_cert(self._store_ctx)\n _cert = _lib.X509_dup(_x509)\n pycert = X509._from_raw_x509_ptr(_cert)\n return X509StoreContextError(errors, pycert)\n\n def set_store(self, store):\n \"\"\"\n Set the context's X.509 store.\n\n .. versionadded:: 0.15\n\n :param X509Store store: The store description which will be used for\n the purposes of any *future* verifications.\n \"\"\"\n self._store = store\n\n def verify_certificate(self):\n \"\"\"\n Verify a certificate in a context.\n\n .. versionadded:: 0.15\n\n :raises X509StoreContextError: If an error occurred when validating a\n certificate in the context. Sets ``certificate`` attribute to\n indicate which certificate caused the error.\n \"\"\"\n # Always re-initialize the store context in case\n # :meth:`verify_certificate` is called multiple times.\n #\n # :meth:`_init` is called in :meth:`__init__` so _cleanup is called\n # before _init to ensure memory is not leaked.\n self._cleanup()\n self._init()\n ret = _lib.X509_verify_cert(self._store_ctx)\n self._cleanup()\n if ret <= 0:\n raise self._exception_from_context()\n\n\ndef load_certificate(type, buffer):\n \"\"\"\n Load a certificate (X509) from the string *buffer* encoded with the\n type *type*.\n\n :param type: The file type (one of FILETYPE_PEM, FILETYPE_ASN1)\n\n :param bytes buffer: The buffer the certificate is stored in\n\n :return: The X509 object\n \"\"\"\n if isinstance(buffer, _text_type):\n buffer = buffer.encode(\"ascii\")\n\n bio = _new_mem_buf(buffer)\n\n if type == FILETYPE_PEM:\n x509 = _lib.PEM_read_bio_X509(bio, _ffi.NULL, _ffi.NULL, _ffi.NULL)\n elif type == FILETYPE_ASN1:\n x509 = _lib.d2i_X509_bio(bio, _ffi.NULL)\n else:\n raise ValueError(\n \"type argument must be FILETYPE_PEM or FILETYPE_ASN1\")\n\n if x509 == _ffi.NULL:\n _raise_current_error()\n\n return X509._from_raw_x509_ptr(x509)\n\n\ndef dump_certificate(type, cert):\n \"\"\"\n Dump the certificate *cert* into a buffer string encoded with the type\n *type*.\n\n :param type: The file type (one of FILETYPE_PEM, FILETYPE_ASN1, or\n FILETYPE_TEXT)\n :param cert: The certificate to dump\n :return: The buffer with the dumped certificate in\n \"\"\"\n bio = _new_mem_buf()\n\n if type == FILETYPE_PEM:\n result_code = _lib.PEM_write_bio_X509(bio, cert._x509)\n elif type == FILETYPE_ASN1:\n result_code = _lib.i2d_X509_bio(bio, cert._x509)\n elif type == FILETYPE_TEXT:\n result_code = _lib.X509_print_ex(bio, cert._x509, 0, 0)\n else:\n raise ValueError(\n \"type argument must be FILETYPE_PEM, FILETYPE_ASN1, or \"\n \"FILETYPE_TEXT\")\n\n assert result_code == 1\n return _bio_to_string(bio)\n\n\ndef dump_publickey(type, pkey):\n \"\"\"\n Dump a public key to a buffer.\n\n :param type: The file type (one of :data:`FILETYPE_PEM` or\n :data:`FILETYPE_ASN1`).\n :param PKey pkey: The public key to dump\n :return: The buffer with the dumped key in it.\n :rtype: bytes\n \"\"\"\n bio = _new_mem_buf()\n if type == FILETYPE_PEM:\n write_bio = _lib.PEM_write_bio_PUBKEY\n elif type == FILETYPE_ASN1:\n write_bio = _lib.i2d_PUBKEY_bio\n else:\n raise ValueError(\"type argument must be FILETYPE_PEM or FILETYPE_ASN1\")\n\n result_code = write_bio(bio, pkey._pkey)\n if result_code != 1: # pragma: no cover\n _raise_current_error()\n\n return _bio_to_string(bio)\n\n\ndef dump_privatekey(type, pkey, cipher=None, passphrase=None):\n \"\"\"\n Dump the private key *pkey* into a buffer string encoded with the type\n *type*. Optionally (if *type* is :const:`FILETYPE_PEM`) encrypting it\n using *cipher* and *passphrase*.\n\n :param type: The file type (one of :const:`FILETYPE_PEM`,\n :const:`FILETYPE_ASN1`, or :const:`FILETYPE_TEXT`)\n :param PKey pkey: The PKey to dump\n :param cipher: (optional) if encrypted PEM format, the cipher to use\n :param passphrase: (optional) if encrypted PEM format, this can be either\n the passphrase to use, or a callback for providing the passphrase.\n\n :return: The buffer with the dumped key in\n :rtype: bytes\n \"\"\"\n bio = _new_mem_buf()\n\n if not isinstance(pkey, PKey):\n raise TypeError(\"pkey must be a PKey\")\n\n if cipher is not None:\n if passphrase is None:\n raise TypeError(\n \"if a value is given for cipher \"\n \"one must also be given for passphrase\")\n cipher_obj = _lib.EVP_get_cipherbyname(_byte_string(cipher))\n if cipher_obj == _ffi.NULL:\n raise ValueError(\"Invalid cipher name\")\n else:\n cipher_obj = _ffi.NULL\n\n helper = _PassphraseHelper(type, passphrase)\n if type == FILETYPE_PEM:\n result_code = _lib.PEM_write_bio_PrivateKey(\n bio, pkey._pkey, cipher_obj, _ffi.NULL, 0,\n helper.callback, helper.callback_args)\n helper.raise_if_problem()\n elif type == FILETYPE_ASN1:\n result_code = _lib.i2d_PrivateKey_bio(bio, pkey._pkey)\n elif type == FILETYPE_TEXT:\n if _lib.EVP_PKEY_id(pkey._pkey) != _lib.EVP_PKEY_RSA:\n raise TypeError(\"Only RSA keys are supported for FILETYPE_TEXT\")\n\n rsa = _ffi.gc(\n _lib.EVP_PKEY_get1_RSA(pkey._pkey),\n _lib.RSA_free\n )\n result_code = _lib.RSA_print(bio, rsa, 0)\n else:\n raise ValueError(\n \"type argument must be FILETYPE_PEM, FILETYPE_ASN1, or \"\n \"FILETYPE_TEXT\")\n\n _openssl_assert(result_code != 0)\n\n return _bio_to_string(bio)\n\n\nclass Revoked(object):\n \"\"\"\n A certificate revocation.\n \"\"\"\n # https://www.openssl.org/docs/manmaster/man5/x509v3_config.html#CRL-distribution-points\n # which differs from crl_reasons of crypto/x509v3/v3_enum.c that matches\n # OCSP_crl_reason_str. We use the latter, just like the command line\n # program.\n _crl_reasons = [\n b\"unspecified\",\n b\"keyCompromise\",\n b\"CACompromise\",\n b\"affiliationChanged\",\n b\"superseded\",\n b\"cessationOfOperation\",\n b\"certificateHold\",\n # b\"removeFromCRL\",\n ]\n\n def __init__(self):\n revoked = _lib.X509_REVOKED_new()\n self._revoked = _ffi.gc(revoked, _lib.X509_REVOKED_free)\n\n def set_serial(self, hex_str):\n \"\"\"\n Set the serial number.\n\n The serial number is formatted as a hexadecimal number encoded in\n ASCII.\n\n :param bytes hex_str: The new serial number.\n\n :return: ``None``\n \"\"\"\n bignum_serial = _ffi.gc(_lib.BN_new(), _lib.BN_free)\n bignum_ptr = _ffi.new(\"BIGNUM**\")\n bignum_ptr[0] = bignum_serial\n bn_result = _lib.BN_hex2bn(bignum_ptr, hex_str)\n if not bn_result:\n raise ValueError(\"bad hex string\")\n\n asn1_serial = _ffi.gc(\n _lib.BN_to_ASN1_INTEGER(bignum_serial, _ffi.NULL),\n _lib.ASN1_INTEGER_free)\n _lib.X509_REVOKED_set_serialNumber(self._revoked, asn1_serial)\n\n def get_serial(self):\n \"\"\"\n Get the serial number.\n\n The serial number is formatted as a hexadecimal number encoded in\n ASCII.\n\n :return: The serial number.\n :rtype: bytes\n \"\"\"\n bio = _new_mem_buf()\n\n asn1_int = _lib.X509_REVOKED_get0_serialNumber(self._revoked)\n _openssl_assert(asn1_int != _ffi.NULL)\n result = _lib.i2a_ASN1_INTEGER(bio, asn1_int)\n _openssl_assert(result >= 0)\n return _bio_to_string(bio)\n\n def _delete_reason(self):\n for i in range(_lib.X509_REVOKED_get_ext_count(self._revoked)):\n ext = _lib.X509_REVOKED_get_ext(self._revoked, i)\n obj = _lib.X509_EXTENSION_get_object(ext)\n if _lib.OBJ_obj2nid(obj) == _lib.NID_crl_reason:\n _lib.X509_EXTENSION_free(ext)\n _lib.X509_REVOKED_delete_ext(self._revoked, i)\n break\n\n def set_reason(self, reason):\n \"\"\"\n Set the reason of this revocation.\n\n If :data:`reason` is ``None``, delete the reason instead.\n\n :param reason: The reason string.\n :type reason: :class:`bytes` or :class:`NoneType`\n\n :return: ``None``\n\n .. seealso::\n\n :meth:`all_reasons`, which gives you a list of all supported\n reasons which you might pass to this method.\n \"\"\"\n if reason is None:\n self._delete_reason()\n elif not isinstance(reason, bytes):\n raise TypeError(\"reason must be None or a byte string\")\n else:\n reason = reason.lower().replace(b' ', b'')\n reason_code = [r.lower() for r in self._crl_reasons].index(reason)\n\n new_reason_ext = _lib.ASN1_ENUMERATED_new()\n _openssl_assert(new_reason_ext != _ffi.NULL)\n new_reason_ext = _ffi.gc(new_reason_ext, _lib.ASN1_ENUMERATED_free)\n\n set_result = _lib.ASN1_ENUMERATED_set(new_reason_ext, reason_code)\n _openssl_assert(set_result != _ffi.NULL)\n\n self._delete_reason()\n add_result = _lib.X509_REVOKED_add1_ext_i2d(\n self._revoked, _lib.NID_crl_reason, new_reason_ext, 0, 0)\n _openssl_assert(add_result == 1)\n\n def get_reason(self):\n \"\"\"\n Get the reason of this revocation.\n\n :return: The reason, or ``None`` if there is none.\n :rtype: bytes or NoneType\n\n .. seealso::\n\n :meth:`all_reasons`, which gives you a list of all supported\n reasons this method might return.\n \"\"\"\n for i in range(_lib.X509_REVOKED_get_ext_count(self._revoked)):\n ext = _lib.X509_REVOKED_get_ext(self._revoked, i)\n obj = _lib.X509_EXTENSION_get_object(ext)\n if _lib.OBJ_obj2nid(obj) == _lib.NID_crl_reason:\n bio = _new_mem_buf()\n\n print_result = _lib.X509V3_EXT_print(bio, ext, 0, 0)\n if not print_result:\n print_result = _lib.M_ASN1_OCTET_STRING_print(\n bio, _lib.X509_EXTENSION_get_data(ext)\n )\n _openssl_assert(print_result != 0)\n\n return _bio_to_string(bio)\n\n def all_reasons(self):\n \"\"\"\n Return a list of all the supported reason strings.\n\n This list is a copy; modifying it does not change the supported reason\n strings.\n\n :return: A list of reason strings.\n :rtype: :class:`list` of :class:`bytes`\n \"\"\"\n return self._crl_reasons[:]\n\n def set_rev_date(self, when):\n \"\"\"\n Set the revocation timestamp.\n\n :param bytes when: The timestamp of the revocation,\n as ASN.1 TIME.\n :return: ``None``\n \"\"\"\n dt = _lib.X509_REVOKED_get0_revocationDate(self._revoked)\n return _set_asn1_time(dt, when)\n\n def get_rev_date(self):\n \"\"\"\n Get the revocation timestamp.\n\n :return: The timestamp of the revocation, as ASN.1 TIME.\n :rtype: bytes\n \"\"\"\n dt = _lib.X509_REVOKED_get0_revocationDate(self._revoked)\n return _get_asn1_time(dt)\n\n\nclass CRL(object):\n \"\"\"\n A certificate revocation list.\n \"\"\"\n\n def __init__(self):\n crl = _lib.X509_CRL_new()\n self._crl = _ffi.gc(crl, _lib.X509_CRL_free)\n\n def to_cryptography(self):\n \"\"\"\n Export as a ``cryptography`` CRL.\n\n :rtype: ``cryptography.x509.CertificateRevocationList``\n\n .. versionadded:: 17.1.0\n \"\"\"\n from cryptography.hazmat.backends.openssl.x509 import (\n _CertificateRevocationList\n )\n backend = _get_backend()\n return _CertificateRevocationList(backend, self._crl)\n\n @classmethod\n def from_cryptography(cls, crypto_crl):\n \"\"\"\n Construct based on a ``cryptography`` *crypto_crl*.\n\n :param crypto_crl: A ``cryptography`` certificate revocation list\n :type crypto_crl: ``cryptography.x509.CertificateRevocationList``\n\n :rtype: CRL\n\n .. versionadded:: 17.1.0\n \"\"\"\n if not isinstance(crypto_crl, x509.CertificateRevocationList):\n raise TypeError(\"Must be a certificate revocation list\")\n\n crl = cls()\n crl._crl = crypto_crl._x509_crl\n return crl\n\n def get_revoked(self):\n \"\"\"\n Return the revocations in this certificate revocation list.\n\n These revocations will be provided by value, not by reference.\n That means it's okay to mutate them: it won't affect this CRL.\n\n :return: The revocations in this CRL.\n :rtype: :class:`tuple` of :class:`Revocation`\n \"\"\"\n results = []\n revoked_stack = _lib.X509_CRL_get_REVOKED(self._crl)\n for i in range(_lib.sk_X509_REVOKED_num(revoked_stack)):\n revoked = _lib.sk_X509_REVOKED_value(revoked_stack, i)\n revoked_copy = _lib.Cryptography_X509_REVOKED_dup(revoked)\n pyrev = Revoked.__new__(Revoked)\n pyrev._revoked = _ffi.gc(revoked_copy, _lib.X509_REVOKED_free)\n results.append(pyrev)\n if results:\n return tuple(results)\n\n def add_revoked(self, revoked):\n \"\"\"\n Add a revoked (by value not reference) to the CRL structure\n\n This revocation will be added by value, not by reference. That\n means it's okay to mutate it after adding: it won't affect\n this CRL.\n\n :param Revoked revoked: The new revocation.\n :return: ``None``\n \"\"\"\n copy = _lib.Cryptography_X509_REVOKED_dup(revoked._revoked)\n _openssl_assert(copy != _ffi.NULL)\n\n add_result = _lib.X509_CRL_add0_revoked(self._crl, copy)\n _openssl_assert(add_result != 0)\n\n def get_issuer(self):\n \"\"\"\n Get the CRL's issuer.\n\n .. versionadded:: 16.1.0\n\n :rtype: X509Name\n \"\"\"\n _issuer = _lib.X509_NAME_dup(_lib.X509_CRL_get_issuer(self._crl))\n _openssl_assert(_issuer != _ffi.NULL)\n _issuer = _ffi.gc(_issuer, _lib.X509_NAME_free)\n issuer = X509Name.__new__(X509Name)\n issuer._name = _issuer\n return issuer\n\n def set_version(self, version):\n \"\"\"\n Set the CRL version.\n\n .. versionadded:: 16.1.0\n\n :param int version: The version of the CRL.\n :return: ``None``\n \"\"\"\n _openssl_assert(_lib.X509_CRL_set_version(self._crl, version) != 0)\n\n def _set_boundary_time(self, which, when):\n return _set_asn1_time(which(self._crl), when)\n\n def set_lastUpdate(self, when):\n \"\"\"\n Set when the CRL was last updated.\n\n The timestamp is formatted as an ASN.1 TIME::\n\n YYYYMMDDhhmmssZ\n\n .. versionadded:: 16.1.0\n\n :param bytes when: A timestamp string.\n :return: ``None``\n \"\"\"\n return self._set_boundary_time(_lib.X509_CRL_get_lastUpdate, when)\n\n def set_nextUpdate(self, when):\n \"\"\"\n Set when the CRL will next be udpated.\n\n The timestamp is formatted as an ASN.1 TIME::\n\n YYYYMMDDhhmmssZ\n\n .. versionadded:: 16.1.0\n\n :param bytes when: A timestamp string.\n :return: ``None``\n \"\"\"\n return self._set_boundary_time(_lib.X509_CRL_get_nextUpdate, when)\n\n def sign(self, issuer_cert, issuer_key, digest):\n \"\"\"\n Sign the CRL.\n\n Signing a CRL enables clients to associate the CRL itself with an\n issuer. Before a CRL is meaningful to other OpenSSL functions, it must\n be signed by an issuer.\n\n This method implicitly sets the issuer's name based on the issuer\n certificate and private key used to sign the CRL.\n\n .. versionadded:: 16.1.0\n\n :param X509 issuer_cert: The issuer's certificate.\n :param PKey issuer_key: The issuer's private key.\n :param bytes digest: The digest method to sign the CRL with.\n \"\"\"\n digest_obj = _lib.EVP_get_digestbyname(digest)\n _openssl_assert(digest_obj != _ffi.NULL)\n _lib.X509_CRL_set_issuer_name(\n self._crl, _lib.X509_get_subject_name(issuer_cert._x509))\n _lib.X509_CRL_sort(self._crl)\n result = _lib.X509_CRL_sign(self._crl, issuer_key._pkey, digest_obj)\n _openssl_assert(result != 0)\n\n def export(self, cert, key, type=FILETYPE_PEM, days=100,\n digest=_UNSPECIFIED):\n \"\"\"\n Export the CRL as a string.\n\n :param X509 cert: The certificate used to sign the CRL.\n :param PKey key: The key used to sign the CRL.\n :param int type: The export format, either :data:`FILETYPE_PEM`,\n :data:`FILETYPE_ASN1`, or :data:`FILETYPE_TEXT`.\n :param int days: The number of days until the next update of this CRL.\n :param bytes digest: The name of the message digest to use (eg\n ``b\"sha2566\"``).\n :rtype: bytes\n \"\"\"\n\n if not isinstance(cert, X509):\n raise TypeError(\"cert must be an X509 instance\")\n if not isinstance(key, PKey):\n raise TypeError(\"key must be a PKey instance\")\n if not isinstance(type, int):\n raise TypeError(\"type must be an integer\")\n\n if digest is _UNSPECIFIED:\n raise TypeError(\"digest must be provided\")\n\n digest_obj = _lib.EVP_get_digestbyname(digest)\n if digest_obj == _ffi.NULL:\n raise ValueError(\"No such digest method\")\n\n bio = _lib.BIO_new(_lib.BIO_s_mem())\n _openssl_assert(bio != _ffi.NULL)\n\n # A scratch time object to give different values to different CRL\n # fields\n sometime = _lib.ASN1_TIME_new()\n _openssl_assert(sometime != _ffi.NULL)\n\n _lib.X509_gmtime_adj(sometime, 0)\n _lib.X509_CRL_set_lastUpdate(self._crl, sometime)\n\n _lib.X509_gmtime_adj(sometime, days * 24 * 60 * 60)\n _lib.X509_CRL_set_nextUpdate(self._crl, sometime)\n\n _lib.X509_CRL_set_issuer_name(\n self._crl, _lib.X509_get_subject_name(cert._x509)\n )\n\n sign_result = _lib.X509_CRL_sign(self._crl, key._pkey, digest_obj)\n if not sign_result:\n _raise_current_error()\n\n return dump_crl(type, self)\n\n\nCRLType = deprecated(\n CRL, __name__,\n \"CRLType has been deprecated, use CRL instead\",\n DeprecationWarning\n)\n\n\nclass PKCS7(object):\n def type_is_signed(self):\n \"\"\"\n Check if this NID_pkcs7_signed object\n\n :return: True if the PKCS7 is of type signed\n \"\"\"\n return bool(_lib.PKCS7_type_is_signed(self._pkcs7))\n\n def type_is_enveloped(self):\n \"\"\"\n Check if this NID_pkcs7_enveloped object\n\n :returns: True if the PKCS7 is of type enveloped\n \"\"\"\n return bool(_lib.PKCS7_type_is_enveloped(self._pkcs7))\n\n def type_is_signedAndEnveloped(self):\n \"\"\"\n Check if this NID_pkcs7_signedAndEnveloped object\n\n :returns: True if the PKCS7 is of type signedAndEnveloped\n \"\"\"\n return bool(_lib.PKCS7_type_is_signedAndEnveloped(self._pkcs7))\n\n def type_is_data(self):\n \"\"\"\n Check if this NID_pkcs7_data object\n\n :return: True if the PKCS7 is of type data\n \"\"\"\n return bool(_lib.PKCS7_type_is_data(self._pkcs7))\n\n def get_type_name(self):\n \"\"\"\n Returns the type name of the PKCS7 structure\n\n :return: A string with the typename\n \"\"\"\n nid = _lib.OBJ_obj2nid(self._pkcs7.type)\n string_type = _lib.OBJ_nid2sn(nid)\n return _ffi.string(string_type)\n\n\nPKCS7Type = deprecated(\n PKCS7, __name__,\n \"PKCS7Type has been deprecated, use PKCS7 instead\",\n DeprecationWarning\n)\n\n\nclass PKCS12(object):\n \"\"\"\n A PKCS #12 archive.\n \"\"\"\n\n def __init__(self):\n self._pkey = None\n self._cert = None\n self._cacerts = None\n self._friendlyname = None\n\n def get_certificate(self):\n \"\"\"\n Get the certificate in the PKCS #12 structure.\n\n :return: The certificate, or :py:const:`None` if there is none.\n :rtype: :py:class:`X509` or :py:const:`None`\n \"\"\"\n return self._cert\n\n def set_certificate(self, cert):\n \"\"\"\n Set the certificate in the PKCS #12 structure.\n\n :param cert: The new certificate, or :py:const:`None` to unset it.\n :type cert: :py:class:`X509` or :py:const:`None`\n\n :return: ``None``\n \"\"\"\n if not isinstance(cert, X509):\n raise TypeError(\"cert must be an X509 instance\")\n self._cert = cert\n\n def get_privatekey(self):\n \"\"\"\n Get the private key in the PKCS #12 structure.\n\n :return: The private key, or :py:const:`None` if there is none.\n :rtype: :py:class:`PKey`\n \"\"\"\n return self._pkey\n\n def set_privatekey(self, pkey):\n \"\"\"\n Set the certificate portion of the PKCS #12 structure.\n\n :param pkey: The new private key, or :py:const:`None` to unset it.\n :type pkey: :py:class:`PKey` or :py:const:`None`\n\n :return: ``None``\n \"\"\"\n if not isinstance(pkey, PKey):\n raise TypeError(\"pkey must be a PKey instance\")\n self._pkey = pkey\n\n def get_ca_certificates(self):\n \"\"\"\n Get the CA certificates in the PKCS #12 structure.\n\n :return: A tuple with the CA certificates in the chain, or\n :py:const:`None` if there are none.\n :rtype: :py:class:`tuple` of :py:class:`X509` or :py:const:`None`\n \"\"\"\n if self._cacerts is not None:\n return tuple(self._cacerts)\n\n def set_ca_certificates(self, cacerts):\n \"\"\"\n Replace or set the CA certificates within the PKCS12 object.\n\n :param cacerts: The new CA certificates, or :py:const:`None` to unset\n them.\n :type cacerts: An iterable of :py:class:`X509` or :py:const:`None`\n\n :return: ``None``\n \"\"\"\n if cacerts is None:\n self._cacerts = None\n else:\n cacerts = list(cacerts)\n for cert in cacerts:\n if not isinstance(cert, X509):\n raise TypeError(\n \"iterable must only contain X509 instances\"\n )\n self._cacerts = cacerts\n\n def set_friendlyname(self, name):\n \"\"\"\n Set the friendly name in the PKCS #12 structure.\n\n :param name: The new friendly name, or :py:const:`None` to unset.\n :type name: :py:class:`bytes` or :py:const:`None`\n\n :return: ``None``\n \"\"\"\n if name is None:\n self._friendlyname = None\n elif not isinstance(name, bytes):\n raise TypeError(\n \"name must be a byte string or None (not %r)\" % (name,)\n )\n self._friendlyname = name\n\n def get_friendlyname(self):\n \"\"\"\n Get the friendly name in the PKCS# 12 structure.\n\n :returns: The friendly name, or :py:const:`None` if there is none.\n :rtype: :py:class:`bytes` or :py:const:`None`\n \"\"\"\n return self._friendlyname\n\n def export(self, passphrase=None, iter=2048, maciter=1):\n \"\"\"\n Dump a PKCS12 object as a string.\n\n For more information, see the :c:func:`PKCS12_create` man page.\n\n :param passphrase: The passphrase used to encrypt the structure. Unlike\n some other passphrase arguments, this *must* be a string, not a\n callback.\n :type passphrase: :py:data:`bytes`\n\n :param iter: Number of times to repeat the encryption step.\n :type iter: :py:data:`int`\n\n :param maciter: Number of times to repeat the MAC step.\n :type maciter: :py:data:`int`\n\n :return: The string representation of the PKCS #12 structure.\n :rtype:\n \"\"\"\n passphrase = _text_to_bytes_and_warn(\"passphrase\", passphrase)\n\n if self._cacerts is None:\n cacerts = _ffi.NULL\n else:\n cacerts = _lib.sk_X509_new_null()\n cacerts = _ffi.gc(cacerts, _lib.sk_X509_free)\n for cert in self._cacerts:\n _lib.sk_X509_push(cacerts, cert._x509)\n\n if passphrase is None:\n passphrase = _ffi.NULL\n\n friendlyname = self._friendlyname\n if friendlyname is None:\n friendlyname = _ffi.NULL\n\n if self._pkey is None:\n pkey = _ffi.NULL\n else:\n pkey = self._pkey._pkey\n\n if self._cert is None:\n cert = _ffi.NULL\n else:\n cert = self._cert._x509\n\n pkcs12 = _lib.PKCS12_create(\n passphrase, friendlyname, pkey, cert, cacerts,\n _lib.NID_pbe_WithSHA1And3_Key_TripleDES_CBC,\n _lib.NID_pbe_WithSHA1And3_Key_TripleDES_CBC,\n iter, maciter, 0)\n if pkcs12 == _ffi.NULL:\n _raise_current_error()\n pkcs12 = _ffi.gc(pkcs12, _lib.PKCS12_free)\n\n bio = _new_mem_buf()\n _lib.i2d_PKCS12_bio(bio, pkcs12)\n return _bio_to_string(bio)\n\n\nPKCS12Type = deprecated(\n PKCS12, __name__,\n \"PKCS12Type has been deprecated, use PKCS12 instead\",\n DeprecationWarning\n)\n\n\nclass NetscapeSPKI(object):\n \"\"\"\n A Netscape SPKI object.\n \"\"\"\n\n def __init__(self):\n spki = _lib.NETSCAPE_SPKI_new()\n self._spki = _ffi.gc(spki, _lib.NETSCAPE_SPKI_free)\n\n def sign(self, pkey, digest):\n \"\"\"\n Sign the certificate request with this key and digest type.\n\n :param pkey: The private key to sign with.\n :type pkey: :py:class:`PKey`\n\n :param digest: The message digest to use.\n :type digest: :py:class:`bytes`\n\n :return: ``None``\n \"\"\"\n if pkey._only_public:\n raise ValueError(\"Key has only public part\")\n\n if not pkey._initialized:\n raise ValueError(\"Key is uninitialized\")\n\n digest_obj = _lib.EVP_get_digestbyname(_byte_string(digest))\n if digest_obj == _ffi.NULL:\n raise ValueError(\"No such digest method\")\n\n sign_result = _lib.NETSCAPE_SPKI_sign(\n self._spki, pkey._pkey, digest_obj\n )\n _openssl_assert(sign_result > 0)\n\n def verify(self, key):\n \"\"\"\n Verifies a signature on a certificate request.\n\n :param PKey key: The public key that signature is supposedly from.\n\n :return: ``True`` if the signature is correct.\n :rtype: bool\n\n :raises OpenSSL.crypto.Error: If the signature is invalid, or there was\n a problem verifying the signature.\n \"\"\"\n answer = _lib.NETSCAPE_SPKI_verify(self._spki, key._pkey)\n if answer <= 0:\n _raise_current_error()\n return True\n\n def b64_encode(self):\n \"\"\"\n Generate a base64 encoded representation of this SPKI object.\n\n :return: The base64 encoded string.\n :rtype: :py:class:`bytes`\n \"\"\"\n encoded = _lib.NETSCAPE_SPKI_b64_encode(self._spki)\n result = _ffi.string(encoded)\n _lib.OPENSSL_free(encoded)\n return result\n\n def get_pubkey(self):\n \"\"\"\n Get the public key of this certificate.\n\n :return: The public key.\n :rtype: :py:class:`PKey`\n \"\"\"\n pkey = PKey.__new__(PKey)\n pkey._pkey = _lib.NETSCAPE_SPKI_get_pubkey(self._spki)\n _openssl_assert(pkey._pkey != _ffi.NULL)\n pkey._pkey = _ffi.gc(pkey._pkey, _lib.EVP_PKEY_free)\n pkey._only_public = True\n return pkey\n\n def set_pubkey(self, pkey):\n \"\"\"\n Set the public key of the certificate\n\n :param pkey: The public key\n :return: ``None``\n \"\"\"\n set_result = _lib.NETSCAPE_SPKI_set_pubkey(self._spki, pkey._pkey)\n _openssl_assert(set_result == 1)\n\n\nNetscapeSPKIType = deprecated(\n NetscapeSPKI, __name__,\n \"NetscapeSPKIType has been deprecated, use NetscapeSPKI instead\",\n DeprecationWarning\n)\n\n\nclass _PassphraseHelper(object):\n def __init__(self, type, passphrase, more_args=False, truncate=False):\n if type != FILETYPE_PEM and passphrase is not None:\n raise ValueError(\n \"only FILETYPE_PEM key format supports encryption\"\n )\n self._passphrase = passphrase\n self._more_args = more_args\n self._truncate = truncate\n self._problems = []\n\n @property\n def callback(self):\n if self._passphrase is None:\n return _ffi.NULL\n elif isinstance(self._passphrase, bytes):\n return _ffi.NULL\n elif callable(self._passphrase):\n return _ffi.callback(\"pem_password_cb\", self._read_passphrase)\n else:\n raise TypeError(\n \"Last argument must be a byte string or a callable.\"\n )\n\n @property\n def callback_args(self):\n if self._passphrase is None:\n return _ffi.NULL\n elif isinstance(self._passphrase, bytes):\n return self._passphrase\n elif callable(self._passphrase):\n return _ffi.NULL\n else:\n raise TypeError(\n \"Last argument must be a byte string or a callable.\"\n )\n\n def raise_if_problem(self, exceptionType=Error):\n if self._problems:\n\n # Flush the OpenSSL error queue\n try:\n _exception_from_error_queue(exceptionType)\n except exceptionType:\n pass\n\n raise self._problems.pop(0)\n\n def _read_passphrase(self, buf, size, rwflag, userdata):\n try:\n if self._more_args:\n result = self._passphrase(size, rwflag, userdata)\n else:\n result = self._passphrase(rwflag)\n if not isinstance(result, bytes):\n raise ValueError(\"String expected\")\n if len(result) > size:\n if self._truncate:\n result = result[:size]\n else:\n raise ValueError(\n \"passphrase returned by callback is too long\"\n )\n for i in range(len(result)):\n buf[i] = result[i:i + 1]\n return len(result)\n except Exception as e:\n self._problems.append(e)\n return 0\n\n\ndef load_publickey(type, buffer):\n \"\"\"\n Load a public key from a buffer.\n\n :param type: The file type (one of :data:`FILETYPE_PEM`,\n :data:`FILETYPE_ASN1`).\n :param buffer: The buffer the key is stored in.\n :type buffer: A Python string object, either unicode or bytestring.\n :return: The PKey object.\n :rtype: :class:`PKey`\n \"\"\"\n if isinstance(buffer, _text_type):\n buffer = buffer.encode(\"ascii\")\n\n bio = _new_mem_buf(buffer)\n\n if type == FILETYPE_PEM:\n evp_pkey = _lib.PEM_read_bio_PUBKEY(\n bio, _ffi.NULL, _ffi.NULL, _ffi.NULL)\n elif type == FILETYPE_ASN1:\n evp_pkey = _lib.d2i_PUBKEY_bio(bio, _ffi.NULL)\n else:\n raise ValueError(\"type argument must be FILETYPE_PEM or FILETYPE_ASN1\")\n\n if evp_pkey == _ffi.NULL:\n _raise_current_error()\n\n pkey = PKey.__new__(PKey)\n pkey._pkey = _ffi.gc(evp_pkey, _lib.EVP_PKEY_free)\n pkey._only_public = True\n return pkey\n\n\ndef load_privatekey(type, buffer, passphrase=None):\n \"\"\"\n Load a private key (PKey) from the string *buffer* encoded with the type\n *type*.\n\n :param type: The file type (one of FILETYPE_PEM, FILETYPE_ASN1)\n :param buffer: The buffer the key is stored in\n :param passphrase: (optional) if encrypted PEM format, this can be\n either the passphrase to use, or a callback for\n providing the passphrase.\n\n :return: The PKey object\n \"\"\"\n if isinstance(buffer, _text_type):\n buffer = buffer.encode(\"ascii\")\n\n bio = _new_mem_buf(buffer)\n\n helper = _PassphraseHelper(type, passphrase)\n if type == FILETYPE_PEM:\n evp_pkey = _lib.PEM_read_bio_PrivateKey(\n bio, _ffi.NULL, helper.callback, helper.callback_args)\n helper.raise_if_problem()\n elif type == FILETYPE_ASN1:\n evp_pkey = _lib.d2i_PrivateKey_bio(bio, _ffi.NULL)\n else:\n raise ValueError(\"type argument must be FILETYPE_PEM or FILETYPE_ASN1\")\n\n if evp_pkey == _ffi.NULL:\n _raise_current_error()\n\n pkey = PKey.__new__(PKey)\n pkey._pkey = _ffi.gc(evp_pkey, _lib.EVP_PKEY_free)\n return pkey\n\n\ndef dump_certificate_request(type, req):\n \"\"\"\n Dump the certificate request *req* into a buffer string encoded with the\n type *type*.\n\n :param type: The file type (one of FILETYPE_PEM, FILETYPE_ASN1)\n :param req: The certificate request to dump\n :return: The buffer with the dumped certificate request in\n \"\"\"\n bio = _new_mem_buf()\n\n if type == FILETYPE_PEM:\n result_code = _lib.PEM_write_bio_X509_REQ(bio, req._req)\n elif type == FILETYPE_ASN1:\n result_code = _lib.i2d_X509_REQ_bio(bio, req._req)\n elif type == FILETYPE_TEXT:\n result_code = _lib.X509_REQ_print_ex(bio, req._req, 0, 0)\n else:\n raise ValueError(\n \"type argument must be FILETYPE_PEM, FILETYPE_ASN1, or \"\n \"FILETYPE_TEXT\"\n )\n\n _openssl_assert(result_code != 0)\n\n return _bio_to_string(bio)\n\n\ndef load_certificate_request(type, buffer):\n \"\"\"\n Load a certificate request (X509Req) from the string *buffer* encoded with\n the type *type*.\n\n :param type: The file type (one of FILETYPE_PEM, FILETYPE_ASN1)\n :param buffer: The buffer the certificate request is stored in\n :return: The X509Req object\n \"\"\"\n if isinstance(buffer, _text_type):\n buffer = buffer.encode(\"ascii\")\n\n bio = _new_mem_buf(buffer)\n\n if type == FILETYPE_PEM:\n req = _lib.PEM_read_bio_X509_REQ(bio, _ffi.NULL, _ffi.NULL, _ffi.NULL)\n elif type == FILETYPE_ASN1:\n req = _lib.d2i_X509_REQ_bio(bio, _ffi.NULL)\n else:\n raise ValueError(\"type argument must be FILETYPE_PEM or FILETYPE_ASN1\")\n\n _openssl_assert(req != _ffi.NULL)\n\n x509req = X509Req.__new__(X509Req)\n x509req._req = _ffi.gc(req, _lib.X509_REQ_free)\n return x509req\n\n\ndef sign(pkey, data, digest):\n \"\"\"\n Sign a data string using the given key and message digest.\n\n :param pkey: PKey to sign with\n :param data: data to be signed\n :param digest: message digest to use\n :return: signature\n\n .. versionadded:: 0.11\n \"\"\"\n data = _text_to_bytes_and_warn(\"data\", data)\n\n digest_obj = _lib.EVP_get_digestbyname(_byte_string(digest))\n if digest_obj == _ffi.NULL:\n raise ValueError(\"No such digest method\")\n\n md_ctx = _lib.Cryptography_EVP_MD_CTX_new()\n md_ctx = _ffi.gc(md_ctx, _lib.Cryptography_EVP_MD_CTX_free)\n\n _lib.EVP_SignInit(md_ctx, digest_obj)\n _lib.EVP_SignUpdate(md_ctx, data, len(data))\n\n length = _lib.EVP_PKEY_size(pkey._pkey)\n _openssl_assert(length > 0)\n signature_buffer = _ffi.new(\"unsigned char[]\", length)\n signature_length = _ffi.new(\"unsigned int *\")\n final_result = _lib.EVP_SignFinal(\n md_ctx, signature_buffer, signature_length, pkey._pkey)\n _openssl_assert(final_result == 1)\n\n return _ffi.buffer(signature_buffer, signature_length[0])[:]\n\n\ndef verify(cert, signature, data, digest):\n \"\"\"\n Verify the signature for a data string.\n\n :param cert: signing certificate (X509 object) corresponding to the\n private key which generated the signature.\n :param signature: signature returned by sign function\n :param data: data to be verified\n :param digest: message digest to use\n :return: ``None`` if the signature is correct, raise exception otherwise.\n\n .. versionadded:: 0.11\n \"\"\"\n data = _text_to_bytes_and_warn(\"data\", data)\n\n digest_obj = _lib.EVP_get_digestbyname(_byte_string(digest))\n if digest_obj == _ffi.NULL:\n raise ValueError(\"No such digest method\")\n\n pkey = _lib.X509_get_pubkey(cert._x509)\n _openssl_assert(pkey != _ffi.NULL)\n pkey = _ffi.gc(pkey, _lib.EVP_PKEY_free)\n\n md_ctx = _lib.Cryptography_EVP_MD_CTX_new()\n md_ctx = _ffi.gc(md_ctx, _lib.Cryptography_EVP_MD_CTX_free)\n\n _lib.EVP_VerifyInit(md_ctx, digest_obj)\n _lib.EVP_VerifyUpdate(md_ctx, data, len(data))\n verify_result = _lib.EVP_VerifyFinal(\n md_ctx, signature, len(signature), pkey\n )\n\n if verify_result != 1:\n _raise_current_error()\n\n\ndef dump_crl(type, crl):\n \"\"\"\n Dump a certificate revocation list to a buffer.\n\n :param type: The file type (one of ``FILETYPE_PEM``, ``FILETYPE_ASN1``, or\n ``FILETYPE_TEXT``).\n :param CRL crl: The CRL to dump.\n\n :return: The buffer with the CRL.\n :rtype: bytes\n \"\"\"\n bio = _new_mem_buf()\n\n if type == FILETYPE_PEM:\n ret = _lib.PEM_write_bio_X509_CRL(bio, crl._crl)\n elif type == FILETYPE_ASN1:\n ret = _lib.i2d_X509_CRL_bio(bio, crl._crl)\n elif type == FILETYPE_TEXT:\n ret = _lib.X509_CRL_print(bio, crl._crl)\n else:\n raise ValueError(\n \"type argument must be FILETYPE_PEM, FILETYPE_ASN1, or \"\n \"FILETYPE_TEXT\")\n\n assert ret == 1\n return _bio_to_string(bio)\n\n\ndef load_crl(type, buffer):\n \"\"\"\n Load Certificate Revocation List (CRL) data from a string *buffer*.\n *buffer* encoded with the type *type*.\n\n :param type: The file type (one of FILETYPE_PEM, FILETYPE_ASN1)\n :param buffer: The buffer the CRL is stored in\n\n :return: The PKey object\n \"\"\"\n if isinstance(buffer, _text_type):\n buffer = buffer.encode(\"ascii\")\n\n bio = _new_mem_buf(buffer)\n\n if type == FILETYPE_PEM:\n crl = _lib.PEM_read_bio_X509_CRL(bio, _ffi.NULL, _ffi.NULL, _ffi.NULL)\n elif type == FILETYPE_ASN1:\n crl = _lib.d2i_X509_CRL_bio(bio, _ffi.NULL)\n else:\n raise ValueError(\"type argument must be FILETYPE_PEM or FILETYPE_ASN1\")\n\n if crl == _ffi.NULL:\n _raise_current_error()\n\n result = CRL.__new__(CRL)\n result._crl = _ffi.gc(crl, _lib.X509_CRL_free)\n return result\n\n\ndef load_pkcs7_data(type, buffer):\n \"\"\"\n Load pkcs7 data from the string *buffer* encoded with the type\n *type*.\n\n :param type: The file type (one of FILETYPE_PEM or FILETYPE_ASN1)\n :param buffer: The buffer with the pkcs7 data.\n :return: The PKCS7 object\n \"\"\"\n if isinstance(buffer, _text_type):\n buffer = buffer.encode(\"ascii\")\n\n bio = _new_mem_buf(buffer)\n\n if type == FILETYPE_PEM:\n pkcs7 = _lib.PEM_read_bio_PKCS7(bio, _ffi.NULL, _ffi.NULL, _ffi.NULL)\n elif type == FILETYPE_ASN1:\n pkcs7 = _lib.d2i_PKCS7_bio(bio, _ffi.NULL)\n else:\n raise ValueError(\"type argument must be FILETYPE_PEM or FILETYPE_ASN1\")\n\n if pkcs7 == _ffi.NULL:\n _raise_current_error()\n\n pypkcs7 = PKCS7.__new__(PKCS7)\n pypkcs7._pkcs7 = _ffi.gc(pkcs7, _lib.PKCS7_free)\n return pypkcs7\n\n\ndef load_pkcs12(buffer, passphrase=None):\n \"\"\"\n Load pkcs12 data from the string *buffer*. If the pkcs12 structure is\n encrypted, a *passphrase* must be included. The MAC is always\n checked and thus required.\n\n See also the man page for the C function :py:func:`PKCS12_parse`.\n\n :param buffer: The buffer the certificate is stored in\n :param passphrase: (Optional) The password to decrypt the PKCS12 lump\n :returns: The PKCS12 object\n \"\"\"\n passphrase = _text_to_bytes_and_warn(\"passphrase\", passphrase)\n\n if isinstance(buffer, _text_type):\n buffer = buffer.encode(\"ascii\")\n\n bio = _new_mem_buf(buffer)\n\n # Use null passphrase if passphrase is None or empty string. With PKCS#12\n # password based encryption no password and a zero length password are two\n # different things, but OpenSSL implementation will try both to figure out\n # which one works.\n if not passphrase:\n passphrase = _ffi.NULL\n\n p12 = _lib.d2i_PKCS12_bio(bio, _ffi.NULL)\n if p12 == _ffi.NULL:\n _raise_current_error()\n p12 = _ffi.gc(p12, _lib.PKCS12_free)\n\n pkey = _ffi.new(\"EVP_PKEY**\")\n cert = _ffi.new(\"X509**\")\n cacerts = _ffi.new(\"Cryptography_STACK_OF_X509**\")\n\n parse_result = _lib.PKCS12_parse(p12, passphrase, pkey, cert, cacerts)\n if not parse_result:\n _raise_current_error()\n\n cacerts = _ffi.gc(cacerts[0], _lib.sk_X509_free)\n\n # openssl 1.0.0 sometimes leaves an X509_check_private_key error in the\n # queue for no particular reason. This error isn't interesting to anyone\n # outside this function. It's not even interesting to us. Get rid of it.\n try:\n _raise_current_error()\n except Error:\n pass\n\n if pkey[0] == _ffi.NULL:\n pykey = None\n else:\n pykey = PKey.__new__(PKey)\n pykey._pkey = _ffi.gc(pkey[0], _lib.EVP_PKEY_free)\n\n if cert[0] == _ffi.NULL:\n pycert = None\n friendlyname = None\n else:\n pycert = X509._from_raw_x509_ptr(cert[0])\n\n friendlyname_length = _ffi.new(\"int*\")\n friendlyname_buffer = _lib.X509_alias_get0(\n cert[0], friendlyname_length\n )\n friendlyname = _ffi.buffer(\n friendlyname_buffer, friendlyname_length[0]\n )[:]\n if friendlyname_buffer == _ffi.NULL:\n friendlyname = None\n\n pycacerts = []\n for i in range(_lib.sk_X509_num(cacerts)):\n x509 = _lib.sk_X509_value(cacerts, i)\n pycacert = X509._from_raw_x509_ptr(x509)\n pycacerts.append(pycacert)\n if not pycacerts:\n pycacerts = None\n\n pkcs12 = PKCS12.__new__(PKCS12)\n pkcs12._pkey = pykey\n pkcs12._cert = pycert\n pkcs12._cacerts = pycacerts\n pkcs12._friendlyname = friendlyname\n return pkcs12\n\n\n# There are no direct unit tests for this initialization. It is tested\n# indirectly since it is necessary for functions like dump_privatekey when\n# using encryption.\n#\n# Thus OpenSSL.test.test_crypto.FunctionTests.test_dump_privatekey_passphrase\n# and some other similar tests may fail without this (though they may not if\n# the Python runtime has already done some initialization of the underlying\n# OpenSSL library (and is linked against the same one that cryptography is\n# using)).\n_lib.OpenSSL_add_all_algorithms()\n\n# This is similar but exercised mainly by exception_from_error_queue. It calls\n# both ERR_load_crypto_strings() and ERR_load_SSL_strings().\n_lib.SSL_load_error_strings()\n\n\n# Set the default string mask to match OpenSSL upstream (since 2005) and\n# RFC5280 recommendations.\n_lib.ASN1_STRING_set_default_mask_asc(b'utf8only')\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/OpenSSL/debug.py",
"content": "from __future__ import print_function\n\nimport ssl\nimport sys\n\nimport OpenSSL.SSL\nimport cffi\nimport cryptography\n\nfrom . import version\n\n\n_env_info = u\"\"\"\\\npyOpenSSL: {pyopenssl}\ncryptography: {cryptography}\ncffi: {cffi}\ncryptography's compiled against OpenSSL: {crypto_openssl_compile}\ncryptography's linked OpenSSL: {crypto_openssl_link}\nPythons's OpenSSL: {python_openssl}\nPython executable: {python}\nPython version: {python_version}\nPlatform: {platform}\nsys.path: {sys_path}\"\"\".format(\n pyopenssl=version.__version__,\n crypto_openssl_compile=OpenSSL._util.ffi.string(\n OpenSSL._util.lib.OPENSSL_VERSION_TEXT,\n ).decode(\"ascii\"),\n crypto_openssl_link=OpenSSL.SSL.SSLeay_version(\n OpenSSL.SSL.SSLEAY_VERSION\n ).decode(\"ascii\"),\n python_openssl=getattr(ssl, \"OPENSSL_VERSION\", \"n/a\"),\n cryptography=cryptography.__version__,\n cffi=cffi.__version__,\n python=sys.executable,\n python_version=sys.version,\n platform=sys.platform,\n sys_path=sys.path,\n)\n\n\nif __name__ == \"__main__\":\n print(_env_info)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/OpenSSL/rand.py",
"content": "\"\"\"\nPRNG management routines, thin wrappers.\n\"\"\"\n\nfrom OpenSSL._util import lib as _lib\n\n\ndef add(buffer, entropy):\n \"\"\"\n Mix bytes from *string* into the PRNG state.\n\n The *entropy* argument is (the lower bound of) an estimate of how much\n randomness is contained in *string*, measured in bytes.\n\n For more information, see e.g. :rfc:`1750`.\n\n This function is only relevant if you are forking Python processes and\n need to reseed the CSPRNG after fork.\n\n :param buffer: Buffer with random data.\n :param entropy: The entropy (in bytes) measurement of the buffer.\n\n :return: :obj:`None`\n \"\"\"\n if not isinstance(buffer, bytes):\n raise TypeError(\"buffer must be a byte string\")\n\n if not isinstance(entropy, int):\n raise TypeError(\"entropy must be an integer\")\n\n _lib.RAND_add(buffer, len(buffer), entropy)\n\n\ndef status():\n \"\"\"\n Check whether the PRNG has been seeded with enough data.\n\n :return: 1 if the PRNG is seeded enough, 0 otherwise.\n \"\"\"\n return _lib.RAND_status()\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/OpenSSL/tsafe.py",
"content": "import warnings\nfrom threading import RLock as _RLock\n\nfrom OpenSSL import SSL as _ssl\n\n\nwarnings.warn(\n \"OpenSSL.tsafe is deprecated and will be removed\",\n DeprecationWarning, stacklevel=3\n)\n\n\nclass Connection:\n def __init__(self, *args):\n self._ssl_conn = _ssl.Connection(*args)\n self._lock = _RLock()\n\n for f in ('get_context', 'pending', 'send', 'write', 'recv', 'read',\n 'renegotiate', 'bind', 'listen', 'connect', 'accept',\n 'setblocking', 'fileno', 'shutdown', 'close', 'get_cipher_list',\n 'getpeername', 'getsockname', 'getsockopt', 'setsockopt',\n 'makefile', 'get_app_data', 'set_app_data', 'state_string',\n 'sock_shutdown', 'get_peer_certificate', 'get_peer_cert_chain',\n 'want_read', 'want_write', 'set_connect_state',\n 'set_accept_state', 'connect_ex', 'sendall'):\n exec(\"\"\"def %s(self, *args):\n self._lock.acquire()\n try:\n return self._ssl_conn.%s(*args)\n finally:\n self._lock.release()\\n\"\"\" % (f, f))\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/OpenSSL/version.py",
"content": "# Copyright (C) AB Strakt\n# Copyright (C) Jean-Paul Calderone\n# See LICENSE for details.\n\n\"\"\"\npyOpenSSL - A simple wrapper around the OpenSSL library\n\"\"\"\n\n__all__ = [\n \"__author__\", \"__copyright__\", \"__email__\", \"__license__\", \"__summary__\",\n \"__title__\", \"__uri__\", \"__version__\",\n]\n\n__version__ = \"19.0.0\"\n\n__title__ = \"pyOpenSSL\"\n__uri__ = \"https://pyopenssl.org/\"\n__summary__ = \"Python wrapper module around the OpenSSL library\"\n__author__ = \"The pyOpenSSL developers\"\n__email__ = \"cryptography-dev@python.org\"\n__license__ = \"Apache License, Version 2.0\"\n__copyright__ = \"Copyright 2001-2017 {0}\".format(__author__)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/PyDispatcher-2.0.5-py3.6.egg-info/PKG-INFO",
"content": "Metadata-Version: 1.2\nName: PyDispatcher\nVersion: 2.0.5\nSummary: Multi-producer-multi-consumer signal dispatching mechanism\nHome-page: http://pydispatcher.sourceforge.net\nAuthor: Patrick K. O'Brien\nAuthor-email: pydispatcher-devel@lists.sourceforge.net\nMaintainer: Mike C. Fletcher\nMaintainer-email: pydispatcher-devel@lists.sourceforge.net\nLicense: BSD\nDescription: Dispatcher mechanism for creating event models\n \n PyDispatcher is an enhanced version of Patrick K. O'Brien's\n original dispatcher.py module. It provides the Python\n programmer with a robust mechanism for event routing within\n various application contexts.\n \n Included in the package are the robustapply and saferef\n modules, which provide the ability to selectively apply\n arguments to callable objects and to reference instance\n methods using weak-references.\n \nKeywords: dispatcher,dispatch,pydispatch,event,signal,sender,receiver,propagate,multi-consumer,multi-producer,saferef,robustapply,apply\nPlatform: Any\nClassifier: License :: OSI Approved :: BSD License\nClassifier: Programming Language :: Python\nClassifier: Programming Language :: Python :: 3\nClassifier: Topic :: Software Development :: Libraries :: Python Modules\nClassifier: Intended Audience :: Developers\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/PyDispatcher-2.0.5-py3.6.egg-info/SOURCES.txt",
"content": "MANIFEST.in\nlicense.txt\nsetup.cfg\nsetup.py\nPyDispatcher.egg-info/PKG-INFO\nPyDispatcher.egg-info/SOURCES.txt\nPyDispatcher.egg-info/dependency_links.txt\nPyDispatcher.egg-info/top_level.txt\ndocs/index.html\ndocs/images/greypinstripe.png\ndocs/pydoc/__init__.py\ndocs/pydoc/builddocs.py\ndocs/pydoc/pydispatch.__init__.html\ndocs/pydoc/pydispatch.dispatcher.html\ndocs/pydoc/pydispatch.errors.html\ndocs/pydoc/pydispatch.html\ndocs/pydoc/pydispatch.robust.html\ndocs/pydoc/pydispatch.robustapply.html\ndocs/pydoc/pydispatch.saferef.html\ndocs/pydoc/pydoc2.py\ndocs/pydoc/weakref.html\ndocs/style/sitestyle.css\nexamples/__init__.py\nexamples/extra_args.py\nexamples/hello_messages.py\nexamples/simple_sample.py\npydispatch/__init__.py\npydispatch/dispatcher.py\npydispatch/errors.py\npydispatch/robust.py\npydispatch/robustapply.py\npydispatch/saferef.py\ntests/__init__.py\ntests/test_dispatcher.py\ntests/test_robustapply.py\ntests/test_saferef.py"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/PyDispatcher-2.0.5-py3.6.egg-info/dependency_links.txt",
"content": "\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/PyDispatcher-2.0.5-py3.6.egg-info/installed-files.txt",
"content": "../pydispatch/__init__.py\n../pydispatch/__pycache__/__init__.cpython-36.pyc\n../pydispatch/__pycache__/dispatcher.cpython-36.pyc\n../pydispatch/__pycache__/errors.cpython-36.pyc\n../pydispatch/__pycache__/robust.cpython-36.pyc\n../pydispatch/__pycache__/robustapply.cpython-36.pyc\n../pydispatch/__pycache__/saferef.cpython-36.pyc\n../pydispatch/dispatcher.py\n../pydispatch/errors.py\n../pydispatch/robust.py\n../pydispatch/robustapply.py\n../pydispatch/saferef.py\nPKG-INFO\nSOURCES.txt\ndependency_links.txt\ntop_level.txt\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/PyDispatcher-2.0.5-py3.6.egg-info/top_level.txt",
"content": "pydispatch\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/PyHamcrest-1.9.0.dist-info/DESCRIPTION.rst",
"content": "PyHamcrest\n==========\n\n| |docs| |travis| |coveralls| |landscape| |scrutinizer| |codeclimate|\n| |version| |downloads| |wheel| |supported-versions| |supported-implementations|\n\n.. |docs| image:: https://readthedocs.org/projects/pyhamcrest/badge/?style=flat\n :target: https://pyhamcrest.readthedocs.org/\n :alt: Documentation Status\n\n.. |travis| image:: http://img.shields.io/travis/hamcrest/PyHamcrest/master.png?style=flat\n :alt: Travis-CI Build Status\n :target: https://travis-ci.org/hamcrest/PyHamcrest\n\n.. |appveyor| image:: https://ci.appveyor.com/api/projects/status/github/hamcrest/PyHamcrest?branch=master\n :alt: AppVeyor Build Status\n :target: https://ci.appveyor.com/project/hamcrest/PyHamcrest\n\n.. |coveralls| image:: http://img.shields.io/coveralls/hamcrest/PyHamcrest/master.png?style=flat\n :alt: Coverage Status\n :target: https://coveralls.io/r/hamcrest/PyHamcrest\n\n.. |landscape| image:: https://landscape.io/github/hamcrest/PyHamcrest/master/landscape.svg?style=flat\n :target: https://landscape.io/github/hamcrest/PyHamcrest/master\n :alt: Code Quality Status\n\n.. |codeclimate| image:: https://codeclimate.com/github/hamcrest/PyHamcrest/badges/gpa.svg\n :target: https://codeclimate.com/github/hamcrest/PyHamcrest\n :alt: Code Climate\n\n.. |version| image:: http://img.shields.io/pypi/v/PyHamcrest.png?style=flat\n :alt: PyPI Package latest release\n :target: https://pypi.python.org/pypi/PyHamcrest\n\n.. |downloads| image:: http://img.shields.io/pypi/dm/PyHamcrest.png?style=flat\n :alt: PyPI Package monthly downloads\n :target: https://pypi.python.org/pypi/PyHamcrest\n\n.. |wheel| image:: https://pypip.in/wheel/PyHamcrest/badge.png?style=flat\n :alt: PyPI Wheel\n :target: https://pypi.python.org/pypi/PyHamcrest\n\n.. |supported-versions| image:: https://pypip.in/py_versions/PyHamcrest/badge.png?style=flat\n :alt: Supported versions\n :target: https://pypi.python.org/pypi/PyHamcrest\n\n.. |supported-implementations| image:: https://pypip.in/implementation/PyHamcrest/badge.png?style=flat\n :alt: Supported imlementations\n :target: https://pypi.python.org/pypi/PyHamcrest\n\n.. |scrutinizer| image:: https://img.shields.io/scrutinizer/g/hamcrest/PyHamcrest/master.png?style=flat\n :alt: Scrtinizer Status\n :target: https://scrutinizer-ci.com/g/hamcrest/PyHamcrest/\n\n\nIntroduction\n============\n\nPyHamcrest is a framework for writing matcher objects, allowing you to\ndeclaratively define \"match\" rules. There are a number of situations where\nmatchers are invaluable, such as UI validation, or data filtering, but it is in\nthe area of writing flexible tests that matchers are most commonly used. This\ntutorial shows you how to use PyHamcrest for unit testing.\n\nWhen writing tests it is sometimes difficult to get the balance right between\noverspecifying the test (and making it brittle to changes), and not specifying\nenough (making the test less valuable since it continues to pass even when the\nthing being tested is broken). Having a tool that allows you to pick out\nprecisely the aspect under test and describe the values it should have, to a\ncontrolled level of precision, helps greatly in writing tests that are \"just\nright.\" Such tests fail when the behavior of the aspect under test deviates\nfrom the expected behavior, yet continue to pass when minor, unrelated changes\nto the behaviour are made.\n\nInstallation\n============\n\nHamcrest can be installed using the usual Python packaging tools. It depends on\ndistribute, but as long as you have a network connection when you install, the\ninstallation process will take care of that for you.\n\nMy first PyHamcrest test\n========================\n\nWe'll start by writing a very simple PyUnit test, but instead of using PyUnit's\n``assertEqual`` method, we'll use PyHamcrest's ``assert_that`` construct and\nthe standard set of matchers:\n\n.. code:: python\n\n from hamcrest import *\n import unittest\n\n class BiscuitTest(unittest.TestCase):\n def testEquals(self):\n theBiscuit = Biscuit('Ginger')\n myBiscuit = Biscuit('Ginger')\n assert_that(theBiscuit, equal_to(myBiscuit))\n\n if __name__ == '__main__':\n unittest.main()\n\nThe ``assert_that`` function is a stylized sentence for making a test\nassertion. In this example, the subject of the assertion is the object\n``theBiscuit``, which is the first method parameter. The second method\nparameter is a matcher for ``Biscuit`` objects, here a matcher that checks one\nobject is equal to another using the Python ``==`` operator. The test passes\nsince the ``Biscuit`` class defines an ``__eq__`` method.\n\nIf you have more than one assertion in your test you can include an identifier\nfor the tested value in the assertion:\n\n.. code:: python\n\n assert_that(theBiscuit.getChocolateChipCount(), equal_to(10), 'chocolate chips')\n assert_that(theBiscuit.getHazelnutCount(), equal_to(3), 'hazelnuts')\n\nAs a convenience, assert_that can also be used to verify a boolean condition:\n\n.. code:: python\n\n assert_that(theBiscuit.isCooked(), 'cooked')\n\nThis is equivalent to the ``assert_`` method of unittest.TestCase, but because\nit's a standalone function, it offers greater flexibility in test writing.\n\n\nPredefined matchers\n===================\n\nPyHamcrest comes with a library of useful matchers:\n\n* Object\n\n * ``equal_to`` - match equal object\n * ``has_length`` - match ``len()``\n * ``has_property`` - match value of property with given name\n * ``has_properties`` - match an object that has all of the given properties.\n * ``has_string`` - match ``str()``\n * ``instance_of`` - match object type\n * ``none``, ``not_none`` - match ``None``, or not ``None``\n * ``same_instance`` - match same object\n * ``calling, raises`` - wrap a method call and assert that it raises an exception\n\n* Number\n\n * ``close_to`` - match number close to a given value\n * ``greater_than``, ``greater_than_or_equal_to``, ``less_than``,\n ``less_than_or_equal_to`` - match numeric ordering\n\n* Text\n\n * ``contains_string`` - match part of a string\n * ``ends_with`` - match the end of a string\n * ``equal_to_ignoring_case`` - match the complete string but ignore case\n * ``equal_to_ignoring_whitespace`` - match the complete string but ignore extra whitespace\n * ``matches_regexp`` - match a regular expression in a string\n * ``starts_with`` - match the beginning of a string\n * ``string_contains_in_order`` - match parts of a string, in relative order\n\n* Logical\n\n * ``all_of`` - ``and`` together all matchers\n * ``any_of`` - ``or`` together all matchers\n * ``anything`` - match anything, useful in composite matchers when you don't care about a particular value\n * ``is_not`` - negate the matcher\n\n* Sequence\n\n * ``contains`` - exactly match the entire sequence\n * ``contains_inanyorder`` - match the entire sequence, but in any order\n * ``has_item`` - match if given item appears in the sequence\n * ``has_items`` - match if all given items appear in the sequence, in any order\n * ``is_in`` - match if item appears in the given sequence\n * ``only_contains`` - match if sequence's items appear in given list\n * ``empty`` - match if the sequence is empty\n\n* Dictionary\n\n * ``has_entries`` - match dictionary with list of key-value pairs\n * ``has_entry`` - match dictionary containing a key-value pair\n * ``has_key`` - match dictionary with a key\n * ``has_value`` - match dictionary with a value\n\n* Decorator\n\n * ``calling`` - wrap a callable in a deffered object, for subsequent matching on calling behaviour\n * ``raises`` - Ensure that a deferred callable raises as expected\n * ``described_as`` - give the matcher a custom failure description\n * ``is_`` - decorator to improve readability - see `Syntactic sugar` below\n\nThe arguments for many of these matchers accept not just a matching value, but\nanother matcher, so matchers can be composed for greater flexibility. For\nexample, ``only_contains(less_than(5))`` will match any sequence where every\nitem is less than 5.\n\n\nSyntactic sugar\n===============\n\nPyHamcrest strives to make your tests as readable as possible. For example, the\n``is_`` matcher is a wrapper that doesn't add any extra behavior to the\nunderlying matcher. The following assertions are all equivalent:\n\n.. code:: python\n\n assert_that(theBiscuit, equal_to(myBiscuit))\n assert_that(theBiscuit, is_(equal_to(myBiscuit)))\n assert_that(theBiscuit, is_(myBiscuit))\n\nThe last form is allowed since ``is_(value)`` wraps most non-matcher arguments\nwith ``equal_to``. But if the argument is a type, it is wrapped with\n``instance_of``, so the following are also equivalent:\n\n.. code:: python\n\n assert_that(theBiscuit, instance_of(Biscuit))\n assert_that(theBiscuit, is_(instance_of(Biscuit)))\n assert_that(theBiscuit, is_(Biscuit))\n\n*Note that PyHamcrest's ``is_`` matcher is unrelated to Python's ``is``\noperator. The matcher for object identity is ``same_instance``.*\n\n\nWriting custom matchers\n=======================\n\nPyHamcrest comes bundled with lots of useful matchers, but you'll probably find\nthat you need to create your own from time to time to fit your testing needs.\nThis commonly occurs when you find a fragment of code that tests the same set\nof properties over and over again (and in different tests), and you want to\nbundle the fragment into a single assertion. By writing your own matcher you'll\neliminate code duplication and make your tests more readable!\n\nLet's write our own matcher for testing if a calendar date falls on a Saturday.\nThis is the test we want to write:\n\n.. code:: python\n\n def testDateIsOnASaturday(self):\n d = datetime.date(2008, 04, 26)\n assert_that(d, is_(on_a_saturday()))\n\nAnd here's the implementation:\n\n.. code:: python\n\n from hamcrest.core.base_matcher import BaseMatcher\n from hamcrest.core.helpers.hasmethod import hasmethod\n\n class IsGivenDayOfWeek(BaseMatcher):\n\n def __init__(self, day):\n self.day = day # Monday is 0, Sunday is 6\n\n def _matches(self, item):\n if not hasmethod(item, 'weekday'):\n return False\n return item.weekday() == self.day\n\n def describe_to(self, description):\n day_as_string = ['Monday', 'Tuesday', 'Wednesday', 'Thursday',\n 'Friday', 'Saturday', 'Sunday']\n description.append_text('calendar date falling on ') \\\n .append_text(day_as_string[self.day])\n\n def on_a_saturday():\n return IsGivenDayOfWeek(5)\n\nFor our Matcher implementation we implement the ``_matches`` method - which\ncalls the ``weekday`` method after confirming that the argument (which may not\nbe a date) has such a method - and the ``describe_to`` method - which is used\nto produce a failure message when a test fails. Here's an example of how the\nfailure message looks:\n\n.. code:: python\n\n assert_that(datetime.date(2008, 04, 06), is_(on_a_saturday()))\n\nfails with the message::\n\n AssertionError:\n Expected: is calendar date falling on Saturday\n got: <2008-04-06>\n\nLet's say this matcher is saved in a module named ``isgivendayofweek``. We\ncould use it in our test by importing the factory function ``on_a_saturday``:\n\n.. code:: python\n\n from hamcrest import *\n import unittest\n from isgivendayofweek import on_a_saturday\n\n class DateTest(unittest.TestCase):\n def testDateIsOnASaturday(self):\n d = datetime.date(2008, 04, 26)\n assert_that(d, is_(on_a_saturday()))\n\n if __name__ == '__main__':\n unittest.main()\n\nEven though the ``on_a_saturday`` function creates a new matcher each time it\nis called, you should not assume this is the only usage pattern for your\nmatcher. Therefore you should make sure your matcher is stateless, so a single\ninstance can be reused between matches.\n\n\nMore resources\n==============\n\n* Documentation_\n* Package_\n* Sources_\n* Hamcrest_\n\n.. _Documentation: http://readthedocs.org/docs/pyhamcrest/en/V1.8.2/\n.. _Package: http://pypi.python.org/pypi/PyHamcrest\n.. _Sources: https://github.com/hamcrest/PyHamcrest\n.. _Hamcrest: http://hamcrest.org\n\n\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/PyHamcrest-1.9.0.dist-info/INSTALLER",
"content": "pip\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/PyHamcrest-1.9.0.dist-info/METADATA",
"content": "Metadata-Version: 2.0\nName: PyHamcrest\nVersion: 1.9.0\nSummary: Hamcrest framework for matcher objects\nHome-page: https://github.com/hamcrest/PyHamcrest\nAuthor: Chris Rose\nAuthor-email: offline@offby1.net\nLicense: New BSD\nDownload-URL: http://pypi.python.org/packages/source/P/PyHamcrest/PyHamcrest-1.9.0.tar.gz\nKeywords: hamcrest matchers pyunit unit test testing unittest unittesting\nPlatform: All\nClassifier: Development Status :: 5 - Production/Stable\nClassifier: Environment :: Console\nClassifier: Intended Audience :: Developers\nClassifier: License :: OSI Approved :: BSD License\nClassifier: Natural Language :: English\nClassifier: Operating System :: OS Independent\nClassifier: Programming Language :: Python :: 2\nClassifier: Programming Language :: Python :: 2.7\nClassifier: Programming Language :: Python :: 3\nClassifier: Programming Language :: Python :: 3.4\nClassifier: Programming Language :: Python :: Implementation :: CPython\nClassifier: Programming Language :: Python :: Implementation :: Jython\nClassifier: Programming Language :: Python :: Implementation :: PyPy\nClassifier: Topic :: Software Development\nClassifier: Topic :: Software Development :: Quality Assurance\nClassifier: Topic :: Software Development :: Testing\nProvides: hamcrest\nRequires-Dist: setuptools\nRequires-Dist: six\n\nPyHamcrest\n==========\n\n| |docs| |travis| |coveralls| |landscape| |scrutinizer| |codeclimate|\n| |version| |downloads| |wheel| |supported-versions| |supported-implementations|\n\n.. |docs| image:: https://readthedocs.org/projects/pyhamcrest/badge/?style=flat\n :target: https://pyhamcrest.readthedocs.org/\n :alt: Documentation Status\n\n.. |travis| image:: http://img.shields.io/travis/hamcrest/PyHamcrest/master.png?style=flat\n :alt: Travis-CI Build Status\n :target: https://travis-ci.org/hamcrest/PyHamcrest\n\n.. |appveyor| image:: https://ci.appveyor.com/api/projects/status/github/hamcrest/PyHamcrest?branch=master\n :alt: AppVeyor Build Status\n :target: https://ci.appveyor.com/project/hamcrest/PyHamcrest\n\n.. |coveralls| image:: http://img.shields.io/coveralls/hamcrest/PyHamcrest/master.png?style=flat\n :alt: Coverage Status\n :target: https://coveralls.io/r/hamcrest/PyHamcrest\n\n.. |landscape| image:: https://landscape.io/github/hamcrest/PyHamcrest/master/landscape.svg?style=flat\n :target: https://landscape.io/github/hamcrest/PyHamcrest/master\n :alt: Code Quality Status\n\n.. |codeclimate| image:: https://codeclimate.com/github/hamcrest/PyHamcrest/badges/gpa.svg\n :target: https://codeclimate.com/github/hamcrest/PyHamcrest\n :alt: Code Climate\n\n.. |version| image:: http://img.shields.io/pypi/v/PyHamcrest.png?style=flat\n :alt: PyPI Package latest release\n :target: https://pypi.python.org/pypi/PyHamcrest\n\n.. |downloads| image:: http://img.shields.io/pypi/dm/PyHamcrest.png?style=flat\n :alt: PyPI Package monthly downloads\n :target: https://pypi.python.org/pypi/PyHamcrest\n\n.. |wheel| image:: https://pypip.in/wheel/PyHamcrest/badge.png?style=flat\n :alt: PyPI Wheel\n :target: https://pypi.python.org/pypi/PyHamcrest\n\n.. |supported-versions| image:: https://pypip.in/py_versions/PyHamcrest/badge.png?style=flat\n :alt: Supported versions\n :target: https://pypi.python.org/pypi/PyHamcrest\n\n.. |supported-implementations| image:: https://pypip.in/implementation/PyHamcrest/badge.png?style=flat\n :alt: Supported imlementations\n :target: https://pypi.python.org/pypi/PyHamcrest\n\n.. |scrutinizer| image:: https://img.shields.io/scrutinizer/g/hamcrest/PyHamcrest/master.png?style=flat\n :alt: Scrtinizer Status\n :target: https://scrutinizer-ci.com/g/hamcrest/PyHamcrest/\n\n\nIntroduction\n============\n\nPyHamcrest is a framework for writing matcher objects, allowing you to\ndeclaratively define \"match\" rules. There are a number of situations where\nmatchers are invaluable, such as UI validation, or data filtering, but it is in\nthe area of writing flexible tests that matchers are most commonly used. This\ntutorial shows you how to use PyHamcrest for unit testing.\n\nWhen writing tests it is sometimes difficult to get the balance right between\noverspecifying the test (and making it brittle to changes), and not specifying\nenough (making the test less valuable since it continues to pass even when the\nthing being tested is broken). Having a tool that allows you to pick out\nprecisely the aspect under test and describe the values it should have, to a\ncontrolled level of precision, helps greatly in writing tests that are \"just\nright.\" Such tests fail when the behavior of the aspect under test deviates\nfrom the expected behavior, yet continue to pass when minor, unrelated changes\nto the behaviour are made.\n\nInstallation\n============\n\nHamcrest can be installed using the usual Python packaging tools. It depends on\ndistribute, but as long as you have a network connection when you install, the\ninstallation process will take care of that for you.\n\nMy first PyHamcrest test\n========================\n\nWe'll start by writing a very simple PyUnit test, but instead of using PyUnit's\n``assertEqual`` method, we'll use PyHamcrest's ``assert_that`` construct and\nthe standard set of matchers:\n\n.. code:: python\n\n from hamcrest import *\n import unittest\n\n class BiscuitTest(unittest.TestCase):\n def testEquals(self):\n theBiscuit = Biscuit('Ginger')\n myBiscuit = Biscuit('Ginger')\n assert_that(theBiscuit, equal_to(myBiscuit))\n\n if __name__ == '__main__':\n unittest.main()\n\nThe ``assert_that`` function is a stylized sentence for making a test\nassertion. In this example, the subject of the assertion is the object\n``theBiscuit``, which is the first method parameter. The second method\nparameter is a matcher for ``Biscuit`` objects, here a matcher that checks one\nobject is equal to another using the Python ``==`` operator. The test passes\nsince the ``Biscuit`` class defines an ``__eq__`` method.\n\nIf you have more than one assertion in your test you can include an identifier\nfor the tested value in the assertion:\n\n.. code:: python\n\n assert_that(theBiscuit.getChocolateChipCount(), equal_to(10), 'chocolate chips')\n assert_that(theBiscuit.getHazelnutCount(), equal_to(3), 'hazelnuts')\n\nAs a convenience, assert_that can also be used to verify a boolean condition:\n\n.. code:: python\n\n assert_that(theBiscuit.isCooked(), 'cooked')\n\nThis is equivalent to the ``assert_`` method of unittest.TestCase, but because\nit's a standalone function, it offers greater flexibility in test writing.\n\n\nPredefined matchers\n===================\n\nPyHamcrest comes with a library of useful matchers:\n\n* Object\n\n * ``equal_to`` - match equal object\n * ``has_length`` - match ``len()``\n * ``has_property`` - match value of property with given name\n * ``has_properties`` - match an object that has all of the given properties.\n * ``has_string`` - match ``str()``\n * ``instance_of`` - match object type\n * ``none``, ``not_none`` - match ``None``, or not ``None``\n * ``same_instance`` - match same object\n * ``calling, raises`` - wrap a method call and assert that it raises an exception\n\n* Number\n\n * ``close_to`` - match number close to a given value\n * ``greater_than``, ``greater_than_or_equal_to``, ``less_than``,\n ``less_than_or_equal_to`` - match numeric ordering\n\n* Text\n\n * ``contains_string`` - match part of a string\n * ``ends_with`` - match the end of a string\n * ``equal_to_ignoring_case`` - match the complete string but ignore case\n * ``equal_to_ignoring_whitespace`` - match the complete string but ignore extra whitespace\n * ``matches_regexp`` - match a regular expression in a string\n * ``starts_with`` - match the beginning of a string\n * ``string_contains_in_order`` - match parts of a string, in relative order\n\n* Logical\n\n * ``all_of`` - ``and`` together all matchers\n * ``any_of`` - ``or`` together all matchers\n * ``anything`` - match anything, useful in composite matchers when you don't care about a particular value\n * ``is_not`` - negate the matcher\n\n* Sequence\n\n * ``contains`` - exactly match the entire sequence\n * ``contains_inanyorder`` - match the entire sequence, but in any order\n * ``has_item`` - match if given item appears in the sequence\n * ``has_items`` - match if all given items appear in the sequence, in any order\n * ``is_in`` - match if item appears in the given sequence\n * ``only_contains`` - match if sequence's items appear in given list\n * ``empty`` - match if the sequence is empty\n\n* Dictionary\n\n * ``has_entries`` - match dictionary with list of key-value pairs\n * ``has_entry`` - match dictionary containing a key-value pair\n * ``has_key`` - match dictionary with a key\n * ``has_value`` - match dictionary with a value\n\n* Decorator\n\n * ``calling`` - wrap a callable in a deffered object, for subsequent matching on calling behaviour\n * ``raises`` - Ensure that a deferred callable raises as expected\n * ``described_as`` - give the matcher a custom failure description\n * ``is_`` - decorator to improve readability - see `Syntactic sugar` below\n\nThe arguments for many of these matchers accept not just a matching value, but\nanother matcher, so matchers can be composed for greater flexibility. For\nexample, ``only_contains(less_than(5))`` will match any sequence where every\nitem is less than 5.\n\n\nSyntactic sugar\n===============\n\nPyHamcrest strives to make your tests as readable as possible. For example, the\n``is_`` matcher is a wrapper that doesn't add any extra behavior to the\nunderlying matcher. The following assertions are all equivalent:\n\n.. code:: python\n\n assert_that(theBiscuit, equal_to(myBiscuit))\n assert_that(theBiscuit, is_(equal_to(myBiscuit)))\n assert_that(theBiscuit, is_(myBiscuit))\n\nThe last form is allowed since ``is_(value)`` wraps most non-matcher arguments\nwith ``equal_to``. But if the argument is a type, it is wrapped with\n``instance_of``, so the following are also equivalent:\n\n.. code:: python\n\n assert_that(theBiscuit, instance_of(Biscuit))\n assert_that(theBiscuit, is_(instance_of(Biscuit)))\n assert_that(theBiscuit, is_(Biscuit))\n\n*Note that PyHamcrest's ``is_`` matcher is unrelated to Python's ``is``\noperator. The matcher for object identity is ``same_instance``.*\n\n\nWriting custom matchers\n=======================\n\nPyHamcrest comes bundled with lots of useful matchers, but you'll probably find\nthat you need to create your own from time to time to fit your testing needs.\nThis commonly occurs when you find a fragment of code that tests the same set\nof properties over and over again (and in different tests), and you want to\nbundle the fragment into a single assertion. By writing your own matcher you'll\neliminate code duplication and make your tests more readable!\n\nLet's write our own matcher for testing if a calendar date falls on a Saturday.\nThis is the test we want to write:\n\n.. code:: python\n\n def testDateIsOnASaturday(self):\n d = datetime.date(2008, 04, 26)\n assert_that(d, is_(on_a_saturday()))\n\nAnd here's the implementation:\n\n.. code:: python\n\n from hamcrest.core.base_matcher import BaseMatcher\n from hamcrest.core.helpers.hasmethod import hasmethod\n\n class IsGivenDayOfWeek(BaseMatcher):\n\n def __init__(self, day):\n self.day = day # Monday is 0, Sunday is 6\n\n def _matches(self, item):\n if not hasmethod(item, 'weekday'):\n return False\n return item.weekday() == self.day\n\n def describe_to(self, description):\n day_as_string = ['Monday', 'Tuesday', 'Wednesday', 'Thursday',\n 'Friday', 'Saturday', 'Sunday']\n description.append_text('calendar date falling on ') \\\n .append_text(day_as_string[self.day])\n\n def on_a_saturday():\n return IsGivenDayOfWeek(5)\n\nFor our Matcher implementation we implement the ``_matches`` method - which\ncalls the ``weekday`` method after confirming that the argument (which may not\nbe a date) has such a method - and the ``describe_to`` method - which is used\nto produce a failure message when a test fails. Here's an example of how the\nfailure message looks:\n\n.. code:: python\n\n assert_that(datetime.date(2008, 04, 06), is_(on_a_saturday()))\n\nfails with the message::\n\n AssertionError:\n Expected: is calendar date falling on Saturday\n got: <2008-04-06>\n\nLet's say this matcher is saved in a module named ``isgivendayofweek``. We\ncould use it in our test by importing the factory function ``on_a_saturday``:\n\n.. code:: python\n\n from hamcrest import *\n import unittest\n from isgivendayofweek import on_a_saturday\n\n class DateTest(unittest.TestCase):\n def testDateIsOnASaturday(self):\n d = datetime.date(2008, 04, 26)\n assert_that(d, is_(on_a_saturday()))\n\n if __name__ == '__main__':\n unittest.main()\n\nEven though the ``on_a_saturday`` function creates a new matcher each time it\nis called, you should not assume this is the only usage pattern for your\nmatcher. Therefore you should make sure your matcher is stateless, so a single\ninstance can be reused between matches.\n\n\nMore resources\n==============\n\n* Documentation_\n* Package_\n* Sources_\n* Hamcrest_\n\n.. _Documentation: http://readthedocs.org/docs/pyhamcrest/en/V1.8.2/\n.. _Package: http://pypi.python.org/pypi/PyHamcrest\n.. _Sources: https://github.com/hamcrest/PyHamcrest\n.. _Hamcrest: http://hamcrest.org\n\n\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/PyHamcrest-1.9.0.dist-info/RECORD",
"content": "PyHamcrest-1.9.0.dist-info/DESCRIPTION.rst,sha256=13XTDh2baR2aJ91v_lAOjEXD7Ydush_RHhk0Z3azfs8,11973\r\nPyHamcrest-1.9.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4\r\nPyHamcrest-1.9.0.dist-info/METADATA,sha256=s0naXZHUZhft0MWcUeZVaZYlREKPOqHp3mUQrhUoC6s,13276\r\nPyHamcrest-1.9.0.dist-info/RECORD,,\r\nPyHamcrest-1.9.0.dist-info/WHEEL,sha256=AvR0WeTpDaxT645bl5FQxUK6NPsTls2ttpcGJg3j1Xg,110\r\nPyHamcrest-1.9.0.dist-info/metadata.json,sha256=Jqs-ZSW5kWSnfvxDsRMwSQH6TxEqSJjBJWiQk1G-c_A,1545\r\nPyHamcrest-1.9.0.dist-info/pbr.json,sha256=jdAcCmfO0nnMs9-YKXuwDyKnxc4qGwyUxyGulF9Pam4,47\r\nPyHamcrest-1.9.0.dist-info/top_level.txt,sha256=mRc0yPsPQSqFgWBmZBY33u-05Xtm5M4GEve4NjYdloQ,9\r\nhamcrest/__init__.py,sha256=Uo0mxeePyXP9_yIzBBvKqIL6tzEHqBwBO1eSHfAKies,230\r\nhamcrest/__pycache__/__init__.cpython-36.pyc,,\r\nhamcrest/core/__init__.py,sha256=nDkYm1E1P7XpHmR8EHu17eahlmC6uYix4HurTyJjhlE,230\r\nhamcrest/core/__pycache__/__init__.cpython-36.pyc,,\r\nhamcrest/core/__pycache__/assert_that.cpython-36.pyc,,\r\nhamcrest/core/__pycache__/base_description.cpython-36.pyc,,\r\nhamcrest/core/__pycache__/base_matcher.cpython-36.pyc,,\r\nhamcrest/core/__pycache__/compat.cpython-36.pyc,,\r\nhamcrest/core/__pycache__/description.cpython-36.pyc,,\r\nhamcrest/core/__pycache__/matcher.cpython-36.pyc,,\r\nhamcrest/core/__pycache__/selfdescribing.cpython-36.pyc,,\r\nhamcrest/core/__pycache__/selfdescribingvalue.cpython-36.pyc,,\r\nhamcrest/core/__pycache__/string_description.cpython-36.pyc,,\r\nhamcrest/core/assert_that.py,sha256=mPdTQQVsjUliK3xp8l_Vn3YmMzg_h5rYhWJk2mstMc0,2428\r\nhamcrest/core/base_description.py,sha256=auvrelro2vGh_A05TQxwbaBJStvfHiFqm0TL56luxEU,2841\r\nhamcrest/core/base_matcher.py,sha256=eRhLv7zFBJGaz68vEsDlvKbrWwU8GRDfZc7pWBNcxwI,1193\r\nhamcrest/core/compat.py,sha256=wUi1u_nIhgUA3kFGJDZLQ2D_cRw79E1SxPDMaI4mzG0,642\r\nhamcrest/core/core/__init__.py,sha256=7q_pNO9cmtV3BEixiGcueNdbxRxlKEFZ1RSO-5GP58E,770\r\nhamcrest/core/core/__pycache__/__init__.cpython-36.pyc,,\r\nhamcrest/core/core/__pycache__/allof.cpython-36.pyc,,\r\nhamcrest/core/core/__pycache__/anyof.cpython-36.pyc,,\r\nhamcrest/core/core/__pycache__/described_as.cpython-36.pyc,,\r\nhamcrest/core/core/__pycache__/is_.cpython-36.pyc,,\r\nhamcrest/core/core/__pycache__/isanything.cpython-36.pyc,,\r\nhamcrest/core/core/__pycache__/isequal.cpython-36.pyc,,\r\nhamcrest/core/core/__pycache__/isinstanceof.cpython-36.pyc,,\r\nhamcrest/core/core/__pycache__/isnone.cpython-36.pyc,,\r\nhamcrest/core/core/__pycache__/isnot.cpython-36.pyc,,\r\nhamcrest/core/core/__pycache__/issame.cpython-36.pyc,,\r\nhamcrest/core/core/__pycache__/raises.cpython-36.pyc,,\r\nhamcrest/core/core/allof.py,sha256=x2ea18Z5cioRybs1heTd3E8zYtpFbuBJg3vIU3vl9k0,1487\r\nhamcrest/core/core/anyof.py,sha256=8j2KAsaToXbv8CA5hed4bqPR3hscODIiaFhAlAyJ2Vs,1097\r\nhamcrest/core/core/described_as.py,sha256=kyy_qRpoebWB1bS2ReAkNDt-79iXu6HqHxOG0GT7PtQ,1623\r\nhamcrest/core/core/is_.py,sha256=C7UCASfr4AIlaaMZnT5d34OthAZQ3rYv8OhszQjz-Eg,2547\r\nhamcrest/core/core/isanything.py,sha256=D2QO5dbDhwlVRGLFrnxOSijTyeKN2iWLRwjpvnumkvg,798\r\nhamcrest/core/core/isequal.py,sha256=TAwF_lWIjVokPruXN8IGS6ajzPGlThanTLPdhktKwRQ,893\r\nhamcrest/core/core/isinstanceof.py,sha256=dnt8YKLhYwGZvDkJ0OTdLd1PN9cB9ZWCg5k8kdnEuqI,1352\r\nhamcrest/core/core/isnone.py,sha256=51ueQKBgg0RzWVLzjFOyt6K0ejk2EbXUlUX90ORPm80,557\r\nhamcrest/core/core/isnot.py,sha256=_z_ynAVUXEUGWoiRlynFa_yaCVh9cK9LIOznDfKVZeo,1533\r\nhamcrest/core/core/issame.py,sha256=8FvAjud4HTuyz7O-XoJbzLtKhChCr1_5JmzMYMeQt1s,1261\r\nhamcrest/core/core/raises.py,sha256=BZXtMlQiEqEjQMYT76HUiuQNRjTECIUmL82_FKYhAvs,3610\r\nhamcrest/core/description.py,sha256=gbVS-ejZJ783o-WEA66bXnXc9DH5cOlQXg0FlzoVGro,1729\r\nhamcrest/core/helpers/__init__.py,sha256=mPsycYI18LoGawOo9BfETa7yKtnM-fDjFOr43BIevUg,146\r\nhamcrest/core/helpers/__pycache__/__init__.cpython-36.pyc,,\r\nhamcrest/core/helpers/__pycache__/hasmethod.cpython-36.pyc,,\r\nhamcrest/core/helpers/__pycache__/wrap_matcher.cpython-36.pyc,,\r\nhamcrest/core/helpers/hasmethod.py,sha256=LPh_WDRuyKYII3G3fX_x2Ql-ECuPJn4tK5eWMLbetLg,325\r\nhamcrest/core/helpers/wrap_matcher.py,sha256=IQTtw98Pp1NXcVTy9boaNh6jayvawKHhX62R3ZwnVwQ,880\r\nhamcrest/core/matcher.py,sha256=BG6e8bIJvwFI0qkaSkt_SOuuLI0VidvoX8GQLadYssU,1851\r\nhamcrest/core/selfdescribing.py,sha256=RzwqHRGg00AJYweGiP8JzSxoHFdBo0Q7m5axYfutfG8,574\r\nhamcrest/core/selfdescribingvalue.py,sha256=OpGLOjdPA9FSgmLZzmkfYrDvpG261TDDiM56muROFqQ,834\r\nhamcrest/core/string_description.py,sha256=Jp-SbuY8LAwPucL4NMrwWqRhkg6CMwYE-pH0ZDMUq8A,908\r\nhamcrest/library/__init__.py,sha256=2atNiBCC2g3c-7jw53CltNgU4wEao1uRcheUPl1ML50,1014\r\nhamcrest/library/__pycache__/__init__.cpython-36.pyc,,\r\nhamcrest/library/collection/__init__.py,sha256=iJU6WCsf0R22m11fqMA9Ztb161AZAdrsKG-4Cj38lZ0,635\r\nhamcrest/library/collection/__pycache__/__init__.cpython-36.pyc,,\r\nhamcrest/library/collection/__pycache__/is_empty.cpython-36.pyc,,\r\nhamcrest/library/collection/__pycache__/isdict_containing.cpython-36.pyc,,\r\nhamcrest/library/collection/__pycache__/isdict_containingentries.cpython-36.pyc,,\r\nhamcrest/library/collection/__pycache__/isdict_containingkey.cpython-36.pyc,,\r\nhamcrest/library/collection/__pycache__/isdict_containingvalue.cpython-36.pyc,,\r\nhamcrest/library/collection/__pycache__/isin.cpython-36.pyc,,\r\nhamcrest/library/collection/__pycache__/issequence_containing.cpython-36.pyc,,\r\nhamcrest/library/collection/__pycache__/issequence_containinginanyorder.cpython-36.pyc,,\r\nhamcrest/library/collection/__pycache__/issequence_containinginorder.cpython-36.pyc,,\r\nhamcrest/library/collection/__pycache__/issequence_onlycontaining.cpython-36.pyc,,\r\nhamcrest/library/collection/is_empty.py,sha256=p3-B7DCmdbVzqiW3D1h3krdeqmu9B0mfYOaa6HehODg,913\r\nhamcrest/library/collection/isdict_containing.py,sha256=6QxDtDp_Z2TK-6om8cHnJDh45YdmaNHAEy5n97rzf00,2056\r\nhamcrest/library/collection/isdict_containingentries.py,sha256=xKtdFjrwLN32rUdRR4PBUSYa3yACa6jXsmlZv0D9YAU,5168\r\nhamcrest/library/collection/isdict_containingkey.py,sha256=aiBpusjpZmkUEMZ_rUFZBB1GxIfsqluMjhXoWNScqZY,1535\r\nhamcrest/library/collection/isdict_containingvalue.py,sha256=N7mHKgMnd7q6HsQekHH6DShNYbLiSXN9cpQgcdMIjlw,1565\r\nhamcrest/library/collection/isin.py,sha256=bcVslW0fUq0pM_SrT9gdltTlNfeJkrVPZAlg6riV2Ys,774\r\nhamcrest/library/collection/issequence_containing.py,sha256=ZwYMm2-Ul_JtvjcgdMjipYdz82yUbGmRNsdPAjO9RX0,3001\r\nhamcrest/library/collection/issequence_containinginanyorder.py,sha256=Px_W2-_0XDOXiL2NTTMp16ZTZvBl4m5rXjlMoR4Ulmw,3613\r\nhamcrest/library/collection/issequence_containinginorder.py,sha256=x7AT_kOCaPY0LmZw28ln8xLLHBtT-I3NneoCWzMJoYA,3219\r\nhamcrest/library/collection/issequence_onlycontaining.py,sha256=Ia17P1HVgb43lZfdUEhmPyUUUWtGLix__fqXIQJTUiI,1626\r\nhamcrest/library/integration/__init__.py,sha256=3aiupojVacPksKTXVhqRs9OwUDoUlUw-bjWItJnRg8Q,254\r\nhamcrest/library/integration/__pycache__/__init__.cpython-36.pyc,,\r\nhamcrest/library/integration/__pycache__/match_equality.cpython-36.pyc,,\r\nhamcrest/library/integration/match_equality.py,sha256=0BMth20YLTqjqTLT4qMVldAe2dQV3CJ2j3zLXDIGl9c,1192\r\nhamcrest/library/number/__init__.py,sha256=J3UoFdR9UPq9zXSKe1a9qAlpjaVst8-pnaxsvbCPj78,335\r\nhamcrest/library/number/__pycache__/__init__.cpython-36.pyc,,\r\nhamcrest/library/number/__pycache__/iscloseto.cpython-36.pyc,,\r\nhamcrest/library/number/__pycache__/ordering_comparison.cpython-36.pyc,,\r\nhamcrest/library/number/iscloseto.py,sha256=2lQTw3Xvo5MW-aePxpWVUOwyV_ydXtH6cCAIAxeopk8,2259\r\nhamcrest/library/number/ordering_comparison.py,sha256=8XxVSOzPK29D14h4wtBZYVYKZf6IcABaQEKihEuzlhI,1700\r\nhamcrest/library/object/__init__.py,sha256=pxzCpybBHRaIg7RJUAw7R1Po0llw8QBbVv_R1TXNBhc,319\r\nhamcrest/library/object/__pycache__/__init__.cpython-36.pyc,,\r\nhamcrest/library/object/__pycache__/haslength.cpython-36.pyc,,\r\nhamcrest/library/object/__pycache__/hasproperty.cpython-36.pyc,,\r\nhamcrest/library/object/__pycache__/hasstring.cpython-36.pyc,,\r\nhamcrest/library/object/haslength.py,sha256=mpYVvrBZV548FwEeqlHWYofv9LPgChvnypZ4RhZDMp0,1681\r\nhamcrest/library/object/hasproperty.py,sha256=9t8upZxjqSQp6IvGyTm4ftGvcpBeyk0dy36HgvlXZBg,5740\r\nhamcrest/library/object/hasstring.py,sha256=_Ht1x-DwV4hk2fRuGo_KoayoLOIoWObKoA30u7HnABU,1250\r\nhamcrest/library/text/__init__.py,sha256=3Uuy1lY2p0VEUy1SAIO6IZgDDgyx8ZsB98k-J2FA_R0,548\r\nhamcrest/library/text/__pycache__/__init__.cpython-36.pyc,,\r\nhamcrest/library/text/__pycache__/isequal_ignoring_case.cpython-36.pyc,,\r\nhamcrest/library/text/__pycache__/isequal_ignoring_whitespace.cpython-36.pyc,,\r\nhamcrest/library/text/__pycache__/stringcontains.cpython-36.pyc,,\r\nhamcrest/library/text/__pycache__/stringcontainsinorder.cpython-36.pyc,,\r\nhamcrest/library/text/__pycache__/stringendswith.cpython-36.pyc,,\r\nhamcrest/library/text/__pycache__/stringmatches.cpython-36.pyc,,\r\nhamcrest/library/text/__pycache__/stringstartswith.cpython-36.pyc,,\r\nhamcrest/library/text/__pycache__/substringmatcher.cpython-36.pyc,,\r\nhamcrest/library/text/isequal_ignoring_case.py,sha256=VGkR3PNDOVE1MJT9H4a3SjR2SIYNzT80VoV6NEq3aqw,1257\r\nhamcrest/library/text/isequal_ignoring_whitespace.py,sha256=NQzswc7fk5rOhcoHO4zbYSWqn-WQdQ7Hwf0FoDHAwBM,1667\r\nhamcrest/library/text/stringcontains.py,sha256=JbkSxdFkpRrNYJfSUghboxe1jRLfHAJvOn6PYvMx7fQ,953\r\nhamcrest/library/text/stringcontainsinorder.py,sha256=B3qG7TG24_WyVPGJER2iqi7fzOMZN0UsBRJPtWutBkc,1705\r\nhamcrest/library/text/stringendswith.py,sha256=JjukJWSVWgURvTstrbCGCQdQzY0PMWLul__UlDh2NGA,980\r\nhamcrest/library/text/stringmatches.py,sha256=AEBn8NI3q-YzRUdXiAfnw1Kmse-LLxJUluDAuy_D9nU,1151\r\nhamcrest/library/text/stringstartswith.py,sha256=oOro8G3z8nAOUyOjHHkHhUvY-lt7XRTJzDr9dYxxons,1007\r\nhamcrest/library/text/substringmatcher.py,sha256=lSPxE7pTpTJlUkMtd28WgsM1FFm56JVZixSvAldSZXk,695\r\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/PyHamcrest-1.9.0.dist-info/WHEEL",
"content": "Wheel-Version: 1.0\nGenerator: bdist_wheel (0.24.0)\nRoot-Is-Purelib: true\nTag: py2-none-any\nTag: py3-none-any\n\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/PyHamcrest-1.9.0.dist-info/metadata.json",
"content": "{\"license\": \"New BSD\", \"download_url\": \"http://pypi.python.org/packages/source/P/PyHamcrest/PyHamcrest-1.9.0.tar.gz\", \"name\": \"PyHamcrest\", \"provides\": \"hamcrest\", \"test_requires\": [{\"requires\": [\"hypothesis (>=1.11)\", \"pytest (>=2.8)\", \"mock\", \"pytest-cov\"]}], \"extensions\": {\"python.details\": {\"project_urls\": {\"Home\": \"https://github.com/hamcrest/PyHamcrest\"}, \"contacts\": [{\"name\": \"Chris Rose\", \"role\": \"author\", \"email\": \"offline@offby1.net\"}], \"document_names\": {\"description\": \"DESCRIPTION.rst\"}}}, \"run_requires\": [{\"requires\": [\"setuptools\", \"six\"]}], \"generator\": \"bdist_wheel (0.24.0)\", \"summary\": \"Hamcrest framework for matcher objects\", \"extras\": [], \"classifiers\": [\"Development Status :: 5 - Production/Stable\", \"Environment :: Console\", \"Intended Audience :: Developers\", \"License :: OSI Approved :: BSD License\", \"Natural Language :: English\", \"Operating System :: OS Independent\", \"Programming Language :: Python :: 2\", \"Programming Language :: Python :: 2.7\", \"Programming Language :: Python :: 3\", \"Programming Language :: Python :: 3.4\", \"Programming Language :: Python :: Implementation :: CPython\", \"Programming Language :: Python :: Implementation :: Jython\", \"Programming Language :: Python :: Implementation :: PyPy\", \"Topic :: Software Development\", \"Topic :: Software Development :: Quality Assurance\", \"Topic :: Software Development :: Testing\"], \"version\": \"1.9.0\", \"metadata_version\": \"2.0\", \"keywords\": [\"hamcrest\", \"matchers\", \"pyunit\", \"unit\", \"test\", \"testing\", \"unittest\", \"unittesting\"], \"platform\": \"All\"}"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/PyHamcrest-1.9.0.dist-info/pbr.json",
"content": "{\"is_release\": false, \"git_version\": \"d572d69\"}"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/PyHamcrest-1.9.0.dist-info/top_level.txt",
"content": "hamcrest\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/Scrapy-1.7.4.dist-info/AUTHORS",
"content": "Scrapy was brought to life by Shane Evans while hacking a scraping framework\nprototype for Mydeco (mydeco.com). It soon became maintained, extended and\nimproved by Insophia (insophia.com), with the initial sponsorship of Mydeco to\nbootstrap the project. In mid-2011, Scrapinghub became the new official\nmaintainer.\n\nHere is the list of the primary authors & contributors:\n\n * Pablo Hoffman\n * Daniel Graña\n * Martin Olveyra\n * Gabriel García\n * Michael Cetrulo\n * Artem Bogomyagkov\n * Damian Canabal\n * Andres Moreira\n * Ismael Carnales\n * Matías Aguirre\n * German Hoffmann\n * Anibal Pacheco\n * Bruno Deferrari\n * Shane Evans\n * Ezequiel Rivero\n * Patrick Mezard\n * Rolando Espinoza\n * Ping Yin\n * Lucian Ursu\n * Shuaib Khan\n * Didier Deshommes\n * Vikas Dhiman\n * Jochen Maes\n * Darian Moody\n * Jordi Lonch\n * Zuhao Wan\n * Steven Almeroth\n * Tom Mortimer-Jones\n * Chris Tilden\n * Alexandr N Zamaraev\n * Emanuel Schorsch\n * Michal Danilak\n * Natan Lao\n * Hasnain Lakhani\n * Pedro Faustino\n * Alex Cepoi\n * Ilya Baryshev\n * Libor Nenadál\n * Jae-Myoung Yu\n * Vladislav Poluhin\n * Marc Abramowitz\n * Valentin-Costel Hăloiu\n * Jason Yeo\n * Сергей Прохоров\n * Simon Ratne\n * Julien Duponchelle\n * Jochen Maes\n * Vikas Dhiman\n * Juan Picca\n * Nicolás Ramírez\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/Scrapy-1.7.4.dist-info/INSTALLER",
"content": "pip\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/Scrapy-1.7.4.dist-info/LICENSE",
"content": "Copyright (c) Scrapy developers.\nAll rights reserved.\n\nRedistribution and use in source and binary forms, with or without modification,\nare permitted provided that the following conditions are met:\n\n 1. Redistributions of source code must retain the above copyright notice,\n this list of conditions, and the following disclaimer.\n\n 2. Redistributions in binary form must reproduce the above copyright\n notice, this list of conditions, and the following disclaimer in the\n documentation and/or other materials provided with the distribution.\n\n 3. Neither the name of Scrapy nor the names of its contributors may be used\n to endorse or promote products derived from this software without\n specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" AND\nANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED\nWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE\nDISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR\nANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES\n(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;\nLOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON\nANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS\nSOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/Scrapy-1.7.4.dist-info/METADATA",
"content": "Metadata-Version: 2.1\nName: Scrapy\nVersion: 1.7.4\nSummary: A high-level Web Crawling and Web Scraping framework\nHome-page: https://scrapy.org\nAuthor: Scrapy developers\nMaintainer: Pablo Hoffman\nMaintainer-email: pablo@pablohoffman.com\nLicense: BSD\nPlatform: UNKNOWN\nClassifier: Framework :: Scrapy\nClassifier: Development Status :: 5 - Production/Stable\nClassifier: Environment :: Console\nClassifier: Intended Audience :: Developers\nClassifier: License :: OSI Approved :: BSD License\nClassifier: Operating System :: OS Independent\nClassifier: Programming Language :: Python\nClassifier: Programming Language :: Python :: 2\nClassifier: Programming Language :: Python :: 2.7\nClassifier: Programming Language :: Python :: 3\nClassifier: Programming Language :: Python :: 3.4\nClassifier: Programming Language :: Python :: 3.5\nClassifier: Programming Language :: Python :: 3.6\nClassifier: Programming Language :: Python :: 3.7\nClassifier: Programming Language :: Python :: Implementation :: CPython\nClassifier: Programming Language :: Python :: Implementation :: PyPy\nClassifier: Topic :: Internet :: WWW/HTTP\nClassifier: Topic :: Software Development :: Libraries :: Application Frameworks\nClassifier: Topic :: Software Development :: Libraries :: Python Modules\nRequires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*\nRequires-Dist: w3lib (>=1.17.0)\nRequires-Dist: queuelib\nRequires-Dist: pyOpenSSL\nRequires-Dist: cssselect (>=0.9)\nRequires-Dist: six (>=1.5.2)\nRequires-Dist: parsel (>=1.5)\nRequires-Dist: PyDispatcher (>=2.0.5)\nRequires-Dist: service-identity\nRequires-Dist: PyPyDispatcher (>=2.1.0) ; platform_python_implementation == \"PyPy\"\nRequires-Dist: Twisted (>=13.1.0) ; python_version != \"3.4\"\nRequires-Dist: lxml ; python_version != \"3.4\"\nRequires-Dist: Twisted (<=19.2.0,>=13.1.0) ; python_version == \"3.4\"\nRequires-Dist: lxml (<=4.3.5) ; python_version == \"3.4\"\n\n======\nScrapy\n======\n\n.. image:: https://img.shields.io/pypi/v/Scrapy.svg\n :target: https://pypi.python.org/pypi/Scrapy\n :alt: PyPI Version\n\n.. image:: https://img.shields.io/pypi/pyversions/Scrapy.svg\n :target: https://pypi.python.org/pypi/Scrapy\n :alt: Supported Python Versions\n\n.. image:: https://img.shields.io/travis/scrapy/scrapy/master.svg\n :target: https://travis-ci.org/scrapy/scrapy\n :alt: Build Status\n\n.. image:: https://img.shields.io/badge/wheel-yes-brightgreen.svg\n :target: https://pypi.python.org/pypi/Scrapy\n :alt: Wheel Status\n\n.. image:: https://img.shields.io/codecov/c/github/scrapy/scrapy/master.svg\n :target: https://codecov.io/github/scrapy/scrapy?branch=master\n :alt: Coverage report\n\n.. image:: https://anaconda.org/conda-forge/scrapy/badges/version.svg\n :target: https://anaconda.org/conda-forge/scrapy\n :alt: Conda Version\n\n\nOverview\n========\n\nScrapy is a fast high-level web crawling and web scraping framework, used to\ncrawl websites and extract structured data from their pages. It can be used for\na wide range of purposes, from data mining to monitoring and automated testing.\n\nFor more information including a list of features check the Scrapy homepage at:\nhttps://scrapy.org\n\nRequirements\n============\n\n* Python 2.7 or Python 3.4+\n* Works on Linux, Windows, Mac OSX, BSD\n\nInstall\n=======\n\nThe quick way::\n\n pip install scrapy\n\nFor more details see the install section in the documentation:\nhttps://docs.scrapy.org/en/latest/intro/install.html\n\nDocumentation\n=============\n\nDocumentation is available online at https://docs.scrapy.org/ and in the ``docs``\ndirectory.\n\nReleases\n========\n\nYou can find release notes at https://docs.scrapy.org/en/latest/news.html\n\nCommunity (blog, twitter, mail list, IRC)\n=========================================\n\nSee https://scrapy.org/community/\n\nContributing\n============\n\nSee https://docs.scrapy.org/en/master/contributing.html\n\nCode of Conduct\n---------------\n\nPlease note that this project is released with a Contributor Code of Conduct\n(see https://github.com/scrapy/scrapy/blob/master/CODE_OF_CONDUCT.md).\n\nBy participating in this project you agree to abide by its terms.\nPlease report unacceptable behavior to opensource@scrapinghub.com.\n\nCompanies using Scrapy\n======================\n\nSee https://scrapy.org/companies/\n\nCommercial Support\n==================\n\nSee https://scrapy.org/support/\n\n\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/Scrapy-1.7.4.dist-info/RECORD",
"content": "../../../bin/scrapy,sha256=nBpGRsKtbys-Xp4iWs4bUk8T8k7OmhWXZrXiaWhKU1Q,285\r\nScrapy-1.7.4.dist-info/AUTHORS,sha256=wBeg3cpJ5eH5Ilhbd22N1Npk17-KVy7CwXL0uRshrYM,1273\r\nScrapy-1.7.4.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4\r\nScrapy-1.7.4.dist-info/LICENSE,sha256=_TMa88y4d2u-fzF4IeXguRwqt8c0ZOd0JdUiBPe12YA,1517\r\nScrapy-1.7.4.dist-info/METADATA,sha256=Xj14ruhbCZkQFrJRpOz6IYGkmpQSzZ0UNgPoeWsjGWc,4273\r\nScrapy-1.7.4.dist-info/RECORD,,\r\nScrapy-1.7.4.dist-info/WHEEL,sha256=8zNYZbwQSXoB9IfXOjPfeNwvAsALAjffgk27FqvCWbo,110\r\nScrapy-1.7.4.dist-info/entry_points.txt,sha256=WDkmo-mkyyTA0TS6pVQtxOnkG9VXzFeotzjdI7r5DO4,51\r\nScrapy-1.7.4.dist-info/top_level.txt,sha256=daQJ2I8J6o-AN_sw03XNdbAoaiFVV2v9xkB7FxB6dao,7\r\nscrapy/VERSION,sha256=wKWmSTuO_WdX5f7Mb8zT38UTsZYzMffIryxNaFT5v2Y,6\r\nscrapy/__init__.py,sha256=GtWfEXEqceruqbQHf_nbzQ_t-Gu8menXdEaj7C6qhR8,1146\r\nscrapy/__main__.py,sha256=0pB9bs0MIwKYELCv21imsZMzlfacVRGv6q49Vnbclvw,77\r\nscrapy/__pycache__/__init__.cpython-36.pyc,,\r\nscrapy/__pycache__/__main__.cpython-36.pyc,,\r\nscrapy/__pycache__/_monkeypatches.cpython-36.pyc,,\r\nscrapy/__pycache__/cmdline.cpython-36.pyc,,\r\nscrapy/__pycache__/crawler.cpython-36.pyc,,\r\nscrapy/__pycache__/dupefilters.cpython-36.pyc,,\r\nscrapy/__pycache__/exceptions.cpython-36.pyc,,\r\nscrapy/__pycache__/exporters.cpython-36.pyc,,\r\nscrapy/__pycache__/extension.cpython-36.pyc,,\r\nscrapy/__pycache__/interfaces.cpython-36.pyc,,\r\nscrapy/__pycache__/item.cpython-36.pyc,,\r\nscrapy/__pycache__/link.cpython-36.pyc,,\r\nscrapy/__pycache__/logformatter.cpython-36.pyc,,\r\nscrapy/__pycache__/mail.cpython-36.pyc,,\r\nscrapy/__pycache__/middleware.cpython-36.pyc,,\r\nscrapy/__pycache__/pqueues.cpython-36.pyc,,\r\nscrapy/__pycache__/resolver.cpython-36.pyc,,\r\nscrapy/__pycache__/responsetypes.cpython-36.pyc,,\r\nscrapy/__pycache__/shell.cpython-36.pyc,,\r\nscrapy/__pycache__/signalmanager.cpython-36.pyc,,\r\nscrapy/__pycache__/signals.cpython-36.pyc,,\r\nscrapy/__pycache__/spiderloader.cpython-36.pyc,,\r\nscrapy/__pycache__/squeues.cpython-36.pyc,,\r\nscrapy/__pycache__/statscollectors.cpython-36.pyc,,\r\nscrapy/_monkeypatches.py,sha256=IbS8a61u3tlJ-1KA_wdrDWGSjlO0MjYA23WGmGOPU8k,976\r\nscrapy/cmdline.py,sha256=VwGYKBNrih2fpVZ7vqG5A68kdT3egvM_1dK3TjyVk7E,5486\r\nscrapy/commands/__init__.py,sha256=RcI0G7rAPZ_FRycx9TDxV_vdI5ViJqNIbQyLSzgn9WI,3532\r\nscrapy/commands/__pycache__/__init__.cpython-36.pyc,,\r\nscrapy/commands/__pycache__/bench.cpython-36.pyc,,\r\nscrapy/commands/__pycache__/check.cpython-36.pyc,,\r\nscrapy/commands/__pycache__/crawl.cpython-36.pyc,,\r\nscrapy/commands/__pycache__/edit.cpython-36.pyc,,\r\nscrapy/commands/__pycache__/fetch.cpython-36.pyc,,\r\nscrapy/commands/__pycache__/genspider.cpython-36.pyc,,\r\nscrapy/commands/__pycache__/list.cpython-36.pyc,,\r\nscrapy/commands/__pycache__/parse.cpython-36.pyc,,\r\nscrapy/commands/__pycache__/runspider.cpython-36.pyc,,\r\nscrapy/commands/__pycache__/settings.cpython-36.pyc,,\r\nscrapy/commands/__pycache__/shell.cpython-36.pyc,,\r\nscrapy/commands/__pycache__/startproject.cpython-36.pyc,,\r\nscrapy/commands/__pycache__/version.cpython-36.pyc,,\r\nscrapy/commands/__pycache__/view.cpython-36.pyc,,\r\nscrapy/commands/bench.py,sha256=vm6kFt45KdJsCTNydR7BK1zki8cQfVbG9VcNVbPpIgQ,1640\r\nscrapy/commands/check.py,sha256=TaUfMEhB2IwgCGgk4i5BHGmqdtWUfm2D4FgfXpLlBPQ,3453\r\nscrapy/commands/crawl.py,sha256=u41-TBL-3Avw9CVGHNpflJKy83Jt-bPmOMpUGlL7jHQ,2625\r\nscrapy/commands/edit.py,sha256=OERVroFVEvfFoDda9xQ2Hm-0Sshq79cRV9g-UQKW1R8,1051\r\nscrapy/commands/fetch.py,sha256=m23twt8conAjm43S8nNReWcEt264O-4RqNf2IgOIDjo,2734\r\nscrapy/commands/genspider.py,sha256=7Yx4AZEGgzP1YfKAcaQkcJhR5svI7KZ92ls61sHybOg,4915\r\nscrapy/commands/list.py,sha256=L2C-B5m7rRNrENSOUNov_BZBdB_GF4ncJmaO7HVLOoQ,374\r\nscrapy/commands/parse.py,sha256=lUV4En8O_rOiQ_e0lfg4WgYq_v6yYcQ_twI4Q89w07c,10296\r\nscrapy/commands/runspider.py,sha256=UslNwaSU5kkCLO5cwprJI57t7rPO4djfak9fZCdNqgY,3668\r\nscrapy/commands/settings.py,sha256=0hbpJmWFcJTSpP7Xl67Szk03d5WJR9hJzCxKOUlctnA,1750\r\nscrapy/commands/shell.py,sha256=-RPATQEypBo6vGRZLY_76asJfH5jgXkLmQJnk1tiD3U,2720\r\nscrapy/commands/startproject.py,sha256=07eNX97Om03GDWdNATbCe6ff5kblTaVC85zPLY6Lq5E,3921\r\nscrapy/commands/version.py,sha256=4p4Aw_J-w2a5EOxwGX0QSUcuE_awKnSqLSGHZnvU2TE,1021\r\nscrapy/commands/view.py,sha256=naXH4HTkXjdSjkaevs5JuJcTbFE8o_EeHdvvfi_MWWM,557\r\nscrapy/contracts/__init__.py,sha256=r8HO_NAh0YjEszksbddFf64JFXhL32mSaC6VGZX8iBs,6017\r\nscrapy/contracts/__pycache__/__init__.cpython-36.pyc,,\r\nscrapy/contracts/__pycache__/default.cpython-36.pyc,,\r\nscrapy/contracts/default.py,sha256=NLJkh6yhxbm10R0d_m3FbhehxL7109OhORH9b_Iu3Ag,2334\r\nscrapy/core/__init__.py,sha256=qWrZeCfaO0rc0hg-MW2Famk13S-U5VcBqmJzRxEL8mc,51\r\nscrapy/core/__pycache__/__init__.cpython-36.pyc,,\r\nscrapy/core/__pycache__/engine.cpython-36.pyc,,\r\nscrapy/core/__pycache__/scheduler.cpython-36.pyc,,\r\nscrapy/core/__pycache__/scraper.cpython-36.pyc,,\r\nscrapy/core/__pycache__/spidermw.cpython-36.pyc,,\r\nscrapy/core/downloader/__init__.py,sha256=Cxa-FfH6Mz1A1Mp7PGBDpI9qWYtMea4Jt6u_DJWism4,7208\r\nscrapy/core/downloader/__pycache__/__init__.cpython-36.pyc,,\r\nscrapy/core/downloader/__pycache__/contextfactory.cpython-36.pyc,,\r\nscrapy/core/downloader/__pycache__/middleware.cpython-36.pyc,,\r\nscrapy/core/downloader/__pycache__/tls.cpython-36.pyc,,\r\nscrapy/core/downloader/__pycache__/webclient.cpython-36.pyc,,\r\nscrapy/core/downloader/contextfactory.py,sha256=Fvr6UnBKjEVfdnR2-LHHuvvURxI7jEoL9wdGbwN7Jy8,4480\r\nscrapy/core/downloader/handlers/__init__.py,sha256=Kf963BJqJgqknLvuDuuPg8rOdcbQWwNdoz8kQThN1WE,2806\r\nscrapy/core/downloader/handlers/__pycache__/__init__.cpython-36.pyc,,\r\nscrapy/core/downloader/handlers/__pycache__/datauri.cpython-36.pyc,,\r\nscrapy/core/downloader/handlers/__pycache__/file.cpython-36.pyc,,\r\nscrapy/core/downloader/handlers/__pycache__/ftp.cpython-36.pyc,,\r\nscrapy/core/downloader/handlers/__pycache__/http.cpython-36.pyc,,\r\nscrapy/core/downloader/handlers/__pycache__/http10.cpython-36.pyc,,\r\nscrapy/core/downloader/handlers/__pycache__/http11.cpython-36.pyc,,\r\nscrapy/core/downloader/handlers/__pycache__/s3.cpython-36.pyc,,\r\nscrapy/core/downloader/handlers/datauri.py,sha256=7nKvTXPCot1H8kqHYJnhj37SWgfafMi8wbCkv6k6p7s,791\r\nscrapy/core/downloader/handlers/file.py,sha256=I9YXSEhplT4-RyAjhLGeko_Uej_A5PeZew8ze32XcDY,535\r\nscrapy/core/downloader/handlers/ftp.py,sha256=8263S1q_4Av0T_dJ6YGvTIP5wkJ_hCt0sCjAgMQk_rA,4568\r\nscrapy/core/downloader/handlers/http.py,sha256=HKHUa25ANNGtrxEp3PDVhMno57K0EaWm2ZeroZPMZXQ,146\r\nscrapy/core/downloader/handlers/http10.py,sha256=BVxK2wWcmMUoSdpXf4-_3P4Ys1orVbm4dSHs_BVupIk,994\r\nscrapy/core/downloader/handlers/http11.py,sha256=12P2EfHOFXf4SMc9iO3s7bsR9NiY3oWTFw4nDQ8MznI,21150\r\nscrapy/core/downloader/handlers/s3.py,sha256=QKJqc4HtcKPlSQj6m7Ds936aPs8b_ELeEynCIi0B2tk,3870\r\nscrapy/core/downloader/middleware.py,sha256=Q_hkW8G5Dh6IV6Kcb6sOeWIZpVwYT9lbQCAAcNe8Agc,3500\r\nscrapy/core/downloader/tls.py,sha256=ckhjPgbcCBuwXGyADSK_LGE2jzpX_m11K7RniQST4Q0,3620\r\nscrapy/core/downloader/webclient.py,sha256=0I-V6vxB3dBmVsvpuKja7moGH9imAyGJ475Cu6Err6g,5796\r\nscrapy/core/engine.py,sha256=b_W67uhavv0W_eOOIOWfWXudw2inxT2-p_xwISrT_Ro,13114\r\nscrapy/core/scheduler.py,sha256=AXyJdDFk42wwcQtglrVjfDLM4sJM2Ebeiop04Ka9qR4,7220\r\nscrapy/core/scraper.py,sha256=CAXJZFV6HqHjaiT7hf7luNSZ4NmedEKIFAn1mx0PSGU,10190\r\nscrapy/core/spidermw.py,sha256=UuP_Eip2pMKB52RzoWuOMmFzcVS3ACPF63xJaHma3VA,5409\r\nscrapy/crawler.py,sha256=HQ-RTrk_XZhq-m0lY7NvG1vKJmSVxHETmpuLxuq0GVY,13435\r\nscrapy/downloadermiddlewares/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0\r\nscrapy/downloadermiddlewares/__pycache__/__init__.cpython-36.pyc,,\r\nscrapy/downloadermiddlewares/__pycache__/ajaxcrawl.cpython-36.pyc,,\r\nscrapy/downloadermiddlewares/__pycache__/chunked.cpython-36.pyc,,\r\nscrapy/downloadermiddlewares/__pycache__/cookies.cpython-36.pyc,,\r\nscrapy/downloadermiddlewares/__pycache__/decompression.cpython-36.pyc,,\r\nscrapy/downloadermiddlewares/__pycache__/defaultheaders.cpython-36.pyc,,\r\nscrapy/downloadermiddlewares/__pycache__/downloadtimeout.cpython-36.pyc,,\r\nscrapy/downloadermiddlewares/__pycache__/httpauth.cpython-36.pyc,,\r\nscrapy/downloadermiddlewares/__pycache__/httpcache.cpython-36.pyc,,\r\nscrapy/downloadermiddlewares/__pycache__/httpcompression.cpython-36.pyc,,\r\nscrapy/downloadermiddlewares/__pycache__/httpproxy.cpython-36.pyc,,\r\nscrapy/downloadermiddlewares/__pycache__/redirect.cpython-36.pyc,,\r\nscrapy/downloadermiddlewares/__pycache__/retry.cpython-36.pyc,,\r\nscrapy/downloadermiddlewares/__pycache__/robotstxt.cpython-36.pyc,,\r\nscrapy/downloadermiddlewares/__pycache__/stats.cpython-36.pyc,,\r\nscrapy/downloadermiddlewares/__pycache__/useragent.cpython-36.pyc,,\r\nscrapy/downloadermiddlewares/ajaxcrawl.py,sha256=wZp8pcTX4diWPRUuSfi7L80i7xa_nUDAanwDKrL6_Bc,3365\r\nscrapy/downloadermiddlewares/chunked.py,sha256=2BEDL3dYZNSrTSJEODMYRwVp_FcnxTmGYughULNafdk,773\r\nscrapy/downloadermiddlewares/cookies.py,sha256=Nv87VOoKoriX5VM98f_Xw_vir4lt8LQNTbhwTnSrFFM,3330\r\nscrapy/downloadermiddlewares/decompression.py,sha256=yueO97rb4GQxKEoON5qA6r7MfMVK6olMjfT2SSix0_I,2629\r\nscrapy/downloadermiddlewares/defaultheaders.py,sha256=2Q9ExGM7fM57k7nrv6U9NIJcl_BL9Wpaa_gRY-L_3x4,568\r\nscrapy/downloadermiddlewares/downloadtimeout.py,sha256=Pt-9xbi3obt8eEVjMD85VWcPXZc-VI0qB1uFC1pNQaY,709\r\nscrapy/downloadermiddlewares/httpauth.py,sha256=3ALLKVZmnsGIwTzbBad8R2As7Dt2GIRUPzXO-Jrso4s,893\r\nscrapy/downloadermiddlewares/httpcache.py,sha256=USiehBnBQncT_Q_MSzJdioAfFWi4raWXbqiSWuyh4Hc,4706\r\nscrapy/downloadermiddlewares/httpcompression.py,sha256=GE8MgpBzItVM3tcS2a11Avs5QS3dw87MIQMmAhl865c,2605\r\nscrapy/downloadermiddlewares/httpproxy.py,sha256=JJzzrLbmKEsXF-We2Iim4wXn-ulhekr1M69wxe1yzS0,2561\r\nscrapy/downloadermiddlewares/redirect.py,sha256=vjcwFvCewTsOHXW7GtBBPtl4r_tMjuUJCX6UBzYBhI4,4436\r\nscrapy/downloadermiddlewares/retry.py,sha256=eh6MIdgapC1ftJqYoypZDbCtDhFbjHc3Z0ImLXRp6L8,3746\r\nscrapy/downloadermiddlewares/robotstxt.py,sha256=j5fsGDc0ZINZhvaeX3kyj0DwHrKhazx7wysmGmK_L7o,4490\r\nscrapy/downloadermiddlewares/stats.py,sha256=djbnZUa9POgJbInehoJGA3NhzlXwXQeb5OqX1ngUs1I,1495\r\nscrapy/downloadermiddlewares/useragent.py,sha256=q-IAslxHg5ryft03xcyv8xzElGGP3zZTJCYPHTa8DQE,749\r\nscrapy/dupefilters.py,sha256=Hyf0ZSZ05VnmCHwL8JcRLAbY5OquxeaY7bhR-5BSODU,2302\r\nscrapy/exceptions.py,sha256=HUXqpZCoQuKnZxa-5eiK-GerV2EIqoLmYTcfANCj4ek,1620\r\nscrapy/exporters.py,sha256=xCJBbUVlF6DoBjoWN6XErnD30dtKez0hihiq5WckLeg,12541\r\nscrapy/extension.py,sha256=BAMLf4nYbRZkLwZZ6mXkKxozBWcnQFAaslTfCW-BqFw,396\r\nscrapy/extensions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0\r\nscrapy/extensions/__pycache__/__init__.cpython-36.pyc,,\r\nscrapy/extensions/__pycache__/closespider.cpython-36.pyc,,\r\nscrapy/extensions/__pycache__/corestats.cpython-36.pyc,,\r\nscrapy/extensions/__pycache__/debug.cpython-36.pyc,,\r\nscrapy/extensions/__pycache__/feedexport.cpython-36.pyc,,\r\nscrapy/extensions/__pycache__/httpcache.cpython-36.pyc,,\r\nscrapy/extensions/__pycache__/logstats.cpython-36.pyc,,\r\nscrapy/extensions/__pycache__/memdebug.cpython-36.pyc,,\r\nscrapy/extensions/__pycache__/memusage.cpython-36.pyc,,\r\nscrapy/extensions/__pycache__/spiderstate.cpython-36.pyc,,\r\nscrapy/extensions/__pycache__/statsmailer.cpython-36.pyc,,\r\nscrapy/extensions/__pycache__/telnet.cpython-36.pyc,,\r\nscrapy/extensions/__pycache__/throttle.cpython-36.pyc,,\r\nscrapy/extensions/closespider.py,sha256=TaIUui6l9ZJfLWLQ4X6jKyW_WREQenUmZttN04qESJU,2583\r\nscrapy/extensions/corestats.py,sha256=YAdF8DoCx2HeNqjvKijEcBMhMXpNyAQ9RcOrJSheCvM,1772\r\nscrapy/extensions/debug.py,sha256=XzJwGpW8jrRrl1g6b6pr5ABoakqHv9hU_v57RasCCYw,1890\r\nscrapy/extensions/feedexport.py,sha256=vtXB9mB34Y1TcA_YCab4THBjIHNSuAQEeUUmyNq15GE,11047\r\nscrapy/extensions/httpcache.py,sha256=FaM1QYyjRaeHKYgrDnEET61S0qx7tx6_CXhET2oTWF8,16924\r\nscrapy/extensions/logstats.py,sha256=5_Ds4kqQ5kf7RbjnPpUkZAZOHNK5uvWgDOQ7PzDFiEg,1754\r\nscrapy/extensions/memdebug.py,sha256=blguRbnQhDEXDUpsOQFfaRrRwVH6skymG-vH3jYdABs,945\r\nscrapy/extensions/memusage.py,sha256=CkteP9viQ8A5Exb5niRVsz_DnuDsIZUmZ3u7PqqFOd4,4940\r\nscrapy/extensions/spiderstate.py,sha256=oitUjBiG7_2d0UsXgwLF0FUJtBBOWVoQjSxI0NZcZVo,1169\r\nscrapy/extensions/statsmailer.py,sha256=BH22wLlpo2aCOvu-RJ3sfF5HrFf-SQlw8O8_gYKnpa8,1242\r\nscrapy/extensions/telnet.py,sha256=vTJLZvs6E0aaVRbxsSJGSbqCVS-OzhVgEvhegW0lXdM,4136\r\nscrapy/extensions/throttle.py,sha256=pRZLfXJqu_wnFkHNkKdDA2Z5vKuFhgVOpJ8TtzaRtPo,3586\r\nscrapy/http/__init__.py,sha256=5VPoouMGxjXuKrX42XKZQhEISVjbkWXNJqr1ID0cuVc,602\r\nscrapy/http/__pycache__/__init__.cpython-36.pyc,,\r\nscrapy/http/__pycache__/common.cpython-36.pyc,,\r\nscrapy/http/__pycache__/cookies.cpython-36.pyc,,\r\nscrapy/http/__pycache__/headers.cpython-36.pyc,,\r\nscrapy/http/common.py,sha256=xSv2z7fQKyyAtSj98H68xIcEoZI-1W7BVDD4lWM5mFM,247\r\nscrapy/http/cookies.py,sha256=uE3Js0R-lQZztadT3MMSRrlIouOaVQ4-uTdecUni8nk,5842\r\nscrapy/http/headers.py,sha256=95O4zWPdUmXJFgy2wMBe2SjvWfXPqzFtn6x2r8N_5-o,2738\r\nscrapy/http/request/__init__.py,sha256=ruK2uoGLPlocbhhccQaFFbfYvy8-pT6s1w8Wi5K4d-w,3483\r\nscrapy/http/request/__pycache__/__init__.cpython-36.pyc,,\r\nscrapy/http/request/__pycache__/form.cpython-36.pyc,,\r\nscrapy/http/request/__pycache__/json_request.cpython-36.pyc,,\r\nscrapy/http/request/__pycache__/rpc.cpython-36.pyc,,\r\nscrapy/http/request/form.py,sha256=XJhxnWFTjD6uBloDzIgr1AEnKtFHXuwshkxipTg-cWQ,7852\r\nscrapy/http/request/json_request.py,sha256=kLnvuqkml5L-nUHRjIT9QplTPCen4pBiNKNgSqZ6MKE,1722\r\nscrapy/http/request/rpc.py,sha256=81jlEaaSR3kOw1y7j6HQMEqdjxR__7bdnlG6PlrMEug,1109\r\nscrapy/http/response/__init__.py,sha256=7RgWzEdOVmmB3SEUZl3gAbVBkGOpqa1HzVikMNsyFKI,4624\r\nscrapy/http/response/__pycache__/__init__.cpython-36.pyc,,\r\nscrapy/http/response/__pycache__/html.cpython-36.pyc,,\r\nscrapy/http/response/__pycache__/text.cpython-36.pyc,,\r\nscrapy/http/response/__pycache__/xml.cpython-36.pyc,,\r\nscrapy/http/response/html.py,sha256=OMbreqX9_9ME0fUgl1FlGay86er_-bkJQCk-L7pn_DE,299\r\nscrapy/http/response/text.py,sha256=VlBm4EI3Qqu_VF3jhhSBt1DnhOTRgpFKm37S-PoHmvU,6459\r\nscrapy/http/response/xml.py,sha256=W02SvIrRv6OMNwqP3m5fnQVRVlExrMDOYZyyoiuNxAI,296\r\nscrapy/interfaces.py,sha256=DGvtWeh-AqQstCHTzhSTW7GR46OY0Q9Vyql0LVNCR-g,558\r\nscrapy/item.py,sha256=A6K2CvBY_dGmjahs83QaVqjTl5OPSPUZrDRhxDYwWHA,2936\r\nscrapy/link.py,sha256=Z8DIzb3SKfZFoyo9ZSaLVVYjxQYo-LxVbIjLj7-RPZ8,1456\r\nscrapy/linkextractors/__init__.py,sha256=UxqtWN2RYU9M9rFS0s8CeDmj4D1KXE-whvI3S4PRUuY,4272\r\nscrapy/linkextractors/__pycache__/__init__.cpython-36.pyc,,\r\nscrapy/linkextractors/__pycache__/htmlparser.cpython-36.pyc,,\r\nscrapy/linkextractors/__pycache__/lxmlhtml.cpython-36.pyc,,\r\nscrapy/linkextractors/__pycache__/regex.cpython-36.pyc,,\r\nscrapy/linkextractors/__pycache__/sgml.cpython-36.pyc,,\r\nscrapy/linkextractors/htmlparser.py,sha256=e02ScMDkPaft4X8aPIDboo0K0L4WmSSFgjRfDiK_tOs,3098\r\nscrapy/linkextractors/lxmlhtml.py,sha256=3aLIZYqNdHYTiFlHbpNjIpcV1byScQnLTwIKnsGHYGc,5167\r\nscrapy/linkextractors/regex.py,sha256=cFNdKeznrceSOjmFG7CneFMsi4Qt3e40-8PqFSsoPxQ,1365\r\nscrapy/linkextractors/sgml.py,sha256=Yud2amivbIrv0RHFxJbKKjVfk1GuNNqdqKQUd5sK6bw,6174\r\nscrapy/loader/__init__.py,sha256=t12Ut1BxLGYYnerT9c32bm5E2HWiq6H2xU912Ehwi-w,7377\r\nscrapy/loader/__pycache__/__init__.cpython-36.pyc,,\r\nscrapy/loader/__pycache__/common.cpython-36.pyc,,\r\nscrapy/loader/__pycache__/processors.cpython-36.pyc,,\r\nscrapy/loader/common.py,sha256=w6UWdlw7XwgBY0KhHpHoCBDBSsDg6DAJpXt8jPkYjQw,467\r\nscrapy/loader/processors.py,sha256=7yeJTlOl2HYHnv7siPpQgR5ZofepLJH18ufu-Pjb3is,3514\r\nscrapy/logformatter.py,sha256=S_J90TIMaAWIL1J19dqOYyQVmaCoCf-hhu6TATr-TPQ,2669\r\nscrapy/mail.py,sha256=nhEXQT_mW_KhIHe7SHc9E64jG4Ev2ByZHAJPorTIOoE,5008\r\nscrapy/middleware.py,sha256=O5I6Y14LojjmM6b72s6xCiw2MzfcwiptK2vbmp_YJSo,2729\r\nscrapy/mime.types,sha256=7qvGIyoPSzvg9yaUpGQ8Du29MCGWi4Em_W30NUnX8qQ,20392\r\nscrapy/pipelines/__init__.py,sha256=weq8sXL8EXHmgxrP5jXwijVI7hSfDJPY60_tGRzwNJA,714\r\nscrapy/pipelines/__pycache__/__init__.cpython-36.pyc,,\r\nscrapy/pipelines/__pycache__/files.cpython-36.pyc,,\r\nscrapy/pipelines/__pycache__/images.cpython-36.pyc,,\r\nscrapy/pipelines/__pycache__/media.cpython-36.pyc,,\r\nscrapy/pipelines/files.py,sha256=FuuOXlAR1uUbw8vGbGT1eJ1QvWcnT35vX_7PA43iWKE,17220\r\nscrapy/pipelines/images.py,sha256=zYgT6LBmU7fC_9HSKb9kFT-pCxR_Qtmr6lLZk6yx0-E,6282\r\nscrapy/pipelines/media.py,sha256=5uKBskmxqUv3iEhHSXZUth9ZWVDUPeVdGaS4CpjZnxA,7927\r\nscrapy/pqueues.py,sha256=559g--Af_FuI7nqd-swG2pI6BhmL2mTxVnzk6wzzBPk,7020\r\nscrapy/resolver.py,sha256=yvEwscKAwSN_k0rQcqKwZEmOoC89FGSzSD4SLgsFN-c,1114\r\nscrapy/responsetypes.py,sha256=c-0mDpDd4AzRAWL07Njsn4YDnQeJKgaMo6SyhlSFwpo,4856\r\nscrapy/selector/__init__.py,sha256=mqtn-787YUiKAQRNKSTrfcy7msFih5dvSfLk-Pxa0aE,56\r\nscrapy/selector/__pycache__/__init__.cpython-36.pyc,,\r\nscrapy/selector/__pycache__/unified.cpython-36.pyc,,\r\nscrapy/selector/unified.py,sha256=GPGc-44XU8boqL6BW4MOKKPJLofAJJ5L46QuFMRmWbw,2751\r\nscrapy/settings/__init__.py,sha256=ph4PLiBWcMLnJa5uk52W5cslp6VfZljM29g-yyUpiNE,15983\r\nscrapy/settings/__pycache__/__init__.cpython-36.pyc,,\r\nscrapy/settings/__pycache__/default_settings.cpython-36.pyc,,\r\nscrapy/settings/__pycache__/deprecated.cpython-36.pyc,,\r\nscrapy/settings/default_settings.py,sha256=AB8f1BJ81PvT6c0ip7VvzuvWg-77rGQ1PugrM28Jk8M,8753\r\nscrapy/settings/deprecated.py,sha256=QnHMsOyZ6FDD1h92Tev15HKgOt4MkUM8K8uLgxnAwRQ,1451\r\nscrapy/shell.py,sha256=mQjwfVt_57lkBZONQBBxJBd12p6JSUfUTE05w7-7GjA,7545\r\nscrapy/signalmanager.py,sha256=S1H3hKakZt6SihB9gjucPut9d_HtfMY8QpG4H5EcN84,2475\r\nscrapy/signals.py,sha256=rhvhVrwAeiuB1dXBgnjRVybdOOKnvfyWyLnoEynOQMY,726\r\nscrapy/spiderloader.py,sha256=QDSTZ7hZXI9x5_kyN611NxnZllyDv7MsG9o9S5KDSZc,2993\r\nscrapy/spidermiddlewares/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0\r\nscrapy/spidermiddlewares/__pycache__/__init__.cpython-36.pyc,,\r\nscrapy/spidermiddlewares/__pycache__/depth.cpython-36.pyc,,\r\nscrapy/spidermiddlewares/__pycache__/httperror.cpython-36.pyc,,\r\nscrapy/spidermiddlewares/__pycache__/offsite.cpython-36.pyc,,\r\nscrapy/spidermiddlewares/__pycache__/referer.cpython-36.pyc,,\r\nscrapy/spidermiddlewares/__pycache__/urllength.cpython-36.pyc,,\r\nscrapy/spidermiddlewares/depth.py,sha256=9PKNJhjK5ifYSAQkPm7A9a0HPgdcXy1ljNrStmN8kE4,2020\r\nscrapy/spidermiddlewares/httperror.py,sha256=S--1Fj3kDjGRpWxKrKBDI_ZbfKyTnXY1442GXx3WeLc,1921\r\nscrapy/spidermiddlewares/offsite.py,sha256=oj7KXRCb1yVixLCEtQfpJ_88fS4MP_l4oUyKlD3mkyE,2563\r\nscrapy/spidermiddlewares/referer.py,sha256=-qnECc8aGubdd2MNxFH-7KqCgTFiKwuB6cnddmnRe-U,13626\r\nscrapy/spidermiddlewares/urllength.py,sha256=ZLzHSY8GlgYElyY4L2v-XzXQ7e9ukEZ22nPfRfeeZEc,1059\r\nscrapy/spiders/__init__.py,sha256=7prK-GN_kfDtgqme7-40Br-R7DFuR-EUnaxVKjnHbD4,3370\r\nscrapy/spiders/__pycache__/__init__.cpython-36.pyc,,\r\nscrapy/spiders/__pycache__/crawl.cpython-36.pyc,,\r\nscrapy/spiders/__pycache__/feed.cpython-36.pyc,,\r\nscrapy/spiders/__pycache__/init.cpython-36.pyc,,\r\nscrapy/spiders/__pycache__/sitemap.cpython-36.pyc,,\r\nscrapy/spiders/crawl.py,sha256=6-5o4H2gcpTCQ51kOMIAMedKuQ0oWlncIt-Zi0fYkZU,4382\r\nscrapy/spiders/feed.py,sha256=uglx45zWWSCkHuMPxn-X_rBKc7qo3QU8Rz1gib4dyDo,5441\r\nscrapy/spiders/init.py,sha256=6moM5Uc_JHkB3ktCiEALBGukUIgBGKcbvGrqaZTVP6U,1354\r\nscrapy/spiders/sitemap.py,sha256=WOFv_p6cldLxaj4RDpdMYYXxqPFpG8aGiNp_3y_7NHs,3579\r\nscrapy/squeues.py,sha256=dTxBInUZUvE-jODzXZsA3ZGogeH43MGdU_IzdqOp1Ok,1301\r\nscrapy/statscollectors.py,sha256=lPGG3O2pifgY0hkPc47_BP1RxLpsC-4jLNG4BaxCC8U,2129\r\nscrapy/templates/project/module/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0\r\nscrapy/templates/project/module/__pycache__/__init__.cpython-36.pyc,,\r\nscrapy/templates/project/module/items.py.tmpl,sha256=PhB4ktMFPN6sxgq7NvBBc-jmNUl9IqIufiRigI86LJg,295\r\nscrapy/templates/project/module/middlewares.py.tmpl,sha256=KiJuaxDkJ2Ec7YlEZ1kare3_P7hH6Kk4il0gUDU0bFo,3613\r\nscrapy/templates/project/module/pipelines.py.tmpl,sha256=3d07xChH5DWvqHOhxnqFvwbNwVTIkHQKl5KwO-s8W1M,296\r\nscrapy/templates/project/module/settings.py.tmpl,sha256=Yl1ax5pQbCQb1lBf1VePOL65SFtWNPkzTqKD9bNTZUU,3162\r\nscrapy/templates/project/module/spiders/__init__.py,sha256=ULwecZkx3_NTphkz7y_qiazBeUoHFnCCWnKSjoDCZj0,161\r\nscrapy/templates/project/module/spiders/__pycache__/__init__.cpython-36.pyc,,\r\nscrapy/templates/project/scrapy.cfg,sha256=rRXe96NnAjpS8_2AtC_flgy7uleqtduLmPd-K720IG4,273\r\nscrapy/templates/spiders/basic.tmpl,sha256=DbIobzgnP0SSwCUFdpvF79zcViqO7Hp3MKlrSEYlriI,208\r\nscrapy/templates/spiders/crawl.tmpl,sha256=-X_oA4pShxJtcC6BsXXp3HljYeJDknBKG1uAueFmdHk,657\r\nscrapy/templates/spiders/csvfeed.tmpl,sha256=uxN0675_-ntfDkK9OBiu0B7x7dSXmxYWj5G5fV-0vIo,571\r\nscrapy/templates/spiders/xmlfeed.tmpl,sha256=cStRh3fgz_48X5B9tHtlqsyYbqfvBYC4cOTmzZx8nds,565\r\nscrapy/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0\r\nscrapy/utils/__pycache__/__init__.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/benchserver.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/boto.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/conf.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/console.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/datatypes.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/decorators.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/defer.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/deprecate.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/display.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/engine.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/ftp.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/gz.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/http.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/httpobj.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/iterators.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/job.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/log.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/markup.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/misc.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/multipart.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/ossignal.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/project.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/python.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/reactor.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/reqser.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/request.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/response.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/serialize.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/signal.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/sitemap.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/spider.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/template.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/test.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/testproc.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/testsite.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/trackref.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/url.cpython-36.pyc,,\r\nscrapy/utils/__pycache__/versions.cpython-36.pyc,,\r\nscrapy/utils/benchserver.py,sha256=WVbn3Qq78Ul7P8LbBPNxBp5-dh7h87STziVFnEVe044,1332\r\nscrapy/utils/boto.py,sha256=XOuDGZFSFu52k-zT8HR7Vmza6RevrrckvXhPPyyt45M,494\r\nscrapy/utils/conf.py,sha256=sDQtbM-G1vUhUy4ye3nY4g6pdHw6cv7r-xC3_TaIzlI,4102\r\nscrapy/utils/console.py,sha256=o_8iJo5CarNN5NgSEMnxkTTRScmsP4-iULNTMsr1ZPA,3403\r\nscrapy/utils/datatypes.py,sha256=M9Hb_GIy2E7Zi79acxIePD8WP_ns0gI4GGzlrj_KXhU,9823\r\nscrapy/utils/decorators.py,sha256=OR-tu3Xh2JW4tQsPFw18K7BdlY4xU64ukpqTFBQ8t0k,1273\r\nscrapy/utils/defer.py,sha256=k8gTXwubNeHa-dJ9kF910d0NVIxOIqNdrIMg7_wjGf4,3576\r\nscrapy/utils/deprecate.py,sha256=e9JdhwgIg4ygfYtxBMXi_Vw7oy69CHn1nHs7Mkcd3ho,6710\r\nscrapy/utils/display.py,sha256=e1fwP0uIEZyEmrJtYRynwKfrAfVPa58sh_NS1q3s7aM,699\r\nscrapy/utils/engine.py,sha256=DdlrtdxTAAT-lnC325WfGRrjJVfYYs_EIy2fXZl0p5w,1376\r\nscrapy/utils/ftp.py,sha256=Nt5QYvnBC1fs2RTm3dGfr5v1JeuXebS9Ass7bqjY6ds,531\r\nscrapy/utils/gz.py,sha256=3Hn1C_ck0nzowXo4NWau67ecp3GAySxnWOQ5IbFQn2U,2200\r\nscrapy/utils/http.py,sha256=lNaFKDZxXqbA-5kkCn_zMYp4s3KkSW-Q1Q8OC6uy8lw,905\r\nscrapy/utils/httpobj.py,sha256=zrs-XKmo12LCXqSzQUbkp17tx8CzjiM_a8K14M0805s,516\r\nscrapy/utils/iterators.py,sha256=KlR9nWVdWZ61YWwtCeY8KkMEp5VrM2IgPb7VUmE0l40,5025\r\nscrapy/utils/job.py,sha256=9aMdjUE8yXj_TUbTVzTVmyXpmT8WSSuytNJNM1L7Tx8,148\r\nscrapy/utils/log.py,sha256=oSB5QV5etHOBwpzF0rRUJwRcmkciWW7Fkh0t18UpyTU,6558\r\nscrapy/utils/markup.py,sha256=PTuqniHxdLO9IgjgdJA9_1P1iUR6itySyN5VHzdh4ss,400\r\nscrapy/utils/misc.py,sha256=loIAdMP21eLM26wbKNDg_8TgTyOaek1iC9E1MvWV4mg,5030\r\nscrapy/utils/multipart.py,sha256=sNbnG1slp7cNnI7ZJBFRMWeQodlPFTR_Hr8ZG2-vhjY,488\r\nscrapy/utils/ossignal.py,sha256=kxrCur_rPYVipHIBlwWHUScEFgULrC3UNi7IHIox_Kg,994\r\nscrapy/utils/project.py,sha256=ufFEQ5QSJ2uG9DEakWSdNOVC1R86NsG-pf8LstH65VI,2590\r\nscrapy/utils/python.py,sha256=m1ZocXLJHnxbhWHUw-ut1Rif8LNqWFSaWZCXwagaXhc,11805\r\nscrapy/utils/reactor.py,sha256=LkmKoT-YLTmIvCrBsvuPR_1Frkmj_0HAeOays4F9ztQ,1360\r\nscrapy/utils/reqser.py,sha256=E1bvBMrP_lKufCXUp_pbRfZtdTmps7lq0QUaPHU9LlM,3213\r\nscrapy/utils/request.py,sha256=Psnh6DX1vPjCIxVrYf19Zlrqh0FmH_xGj45qdeg9dGM,3459\r\nscrapy/utils/response.py,sha256=lI_NJ-oYJOQuWTXHh61Bmu0eY9qh6jVqAepI7e5A9-Y,2665\r\nscrapy/utils/serialize.py,sha256=J3T9E05j8HXqoqHuX_ZWSSqDes07iirCRl_BznHeyxg,1201\r\nscrapy/utils/signal.py,sha256=b4fTZbiqVSxZazdGmLLBirKHHW0U7e-7XqbWHd_5a04,2969\r\nscrapy/utils/sitemap.py,sha256=PSi3joL-4nVbBwhOqasDnOFcCQP8VA-BTtvEqX134as,1518\r\nscrapy/utils/spider.py,sha256=VdMMl1EhmN65nA3tC-Z4uKn-wKfBaGApsbJjGZZnUJw,1911\r\nscrapy/utils/template.py,sha256=JNCXL8NT0gGFgEK4aC0oCeUQlKOWzisdjdGNvnPJ4Q0,816\r\nscrapy/utils/test.py,sha256=fhMskcoxNFyNeSS9EZ1cCt_StVNgyr0UmRhUxdIW-cw,3089\r\nscrapy/utils/testproc.py,sha256=xDcuLRPWChiTL7L7wwYOT9XZjdzQUu0tDsMKyFSXzwc,1508\r\nscrapy/utils/testsite.py,sha256=yDS8GwhSKKBuNLCswrrmD2GfsB827sTlKfuQ8iorxao,1562\r\nscrapy/utils/trackref.py,sha256=rg82Iib9fkjqkfmFdE507VVxcOBfycG_FZZ9Hldyz08,2081\r\nscrapy/utils/url.py,sha256=5sWMcSbQQBe53pa2v5JOPMSq2cQmzsI09OEvQdCg0W8,5119\r\nscrapy/utils/versions.py,sha256=eMWzL4F0jIWnSxlSd-hysa9LoCSJjc9cwirxsdlWZIg,1419\r\nscrapy/xlib/__init__.py,sha256=CbHNJHO8-CRSs6dP3WIWf1u4ruo2KyTrio-GBpxr45Y,92\r\nscrapy/xlib/__pycache__/__init__.cpython-36.pyc,,\r\nscrapy/xlib/__pycache__/pydispatch.cpython-36.pyc,,\r\nscrapy/xlib/__pycache__/tx.cpython-36.pyc,,\r\nscrapy/xlib/pydispatch.py,sha256=Z4y2vxQ5k4SrDfLfjJsR2BUGNY0Pghn9lmVqpJEXyRo,629\r\nscrapy/xlib/tx.py,sha256=v08NnjBxl_kdLlCVSLEJcyEti-DHhw2Sklai2eCZhbY,749\r\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/Scrapy-1.7.4.dist-info/WHEEL",
"content": "Wheel-Version: 1.0\nGenerator: bdist_wheel (0.33.6)\nRoot-Is-Purelib: true\nTag: py2-none-any\nTag: py3-none-any\n\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/Scrapy-1.7.4.dist-info/entry_points.txt",
"content": "[console_scripts]\nscrapy = scrapy.cmdline:execute\n\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/Scrapy-1.7.4.dist-info/top_level.txt",
"content": "scrapy\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/Twisted-19.7.0.dist-info/INSTALLER",
"content": "pip\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/Twisted-19.7.0.dist-info/LICENSE",
"content": "Copyright (c) 2001-2019\nAllen Short\nAmber Hawkie Brown\nAndrew Bennetts\nAndy Gayton\nAntoine Pitrou\nApple Computer, Inc.\nAshwini Oruganti\nBenjamin Bruheim\nBob Ippolito\nCanonical Limited\nChristopher Armstrong\nCiena Corporation\nDavid Reid\nDivmod Inc.\nDonovan Preston\nEric Mangold\nEyal Lotem\nGoogle Inc.\nHybrid Logic Ltd.\nHynek Schlawack\nItamar Turner-Trauring\nJames Knight\nJason A. Mobarak\nJean-Paul Calderone\nJessica McKellar\nJonathan D. Simms\nJonathan Jacobs\nJonathan Lange\nJulian Berman\nJürgen Hermann\nKevin Horn\nKevin Turner\nLaurens Van Houtven\nMary Gardiner\nMassachusetts Institute of Technology\nMatthew Lefkowitz\nMoshe Zadka\nPaul Swartz\nPavel Pergamenshchik\nRackspace, US Inc.\nRalph Meijer\nRichard Wall\nSean Riley\nSoftware Freedom Conservancy\nTavendo GmbH\nThijs Triemstra\nThomas Herve\nTimothy Allen\nTom Most\nTom Prince\nTravis B. Hartwell\n\nand others that have contributed code to the public domain.\n\nPermission is hereby granted, free of charge, to any person obtaining\na copy of this software and associated documentation files (the\n\"Software\"), to deal in the Software without restriction, including\nwithout limitation the rights to use, copy, modify, merge, publish,\ndistribute, sublicense, and/or sell copies of the Software, and to\npermit persons to whom the Software is furnished to do so, subject to\nthe following conditions:\n\nThe above copyright notice and this permission notice shall be\nincluded in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\nEXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF\nMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\nNONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE\nLIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION\nOF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION\nWITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/Twisted-19.7.0.dist-info/METADATA",
"content": "Metadata-Version: 2.1\nName: Twisted\nVersion: 19.7.0\nSummary: An asynchronous networking framework written in Python\nHome-page: https://twistedmatrix.com/\nAuthor: Twisted Matrix Laboratories\nAuthor-email: twisted-python@twistedmatrix.com\nMaintainer: Glyph Lefkowitz\nMaintainer-email: glyph@twistedmatrix.com\nLicense: MIT\nProject-URL: Documentation, https://twistedmatrix.com/documents/current/\nProject-URL: Source, https://github.com/twisted/twisted\nProject-URL: Issues, https://twistedmatrix.com/trac/report\nPlatform: UNKNOWN\nClassifier: Programming Language :: Python :: 2.7\nClassifier: Programming Language :: Python :: 3\nClassifier: Programming Language :: Python :: 3.5\nClassifier: Programming Language :: Python :: 3.6\nClassifier: Programming Language :: Python :: 3.7\nDescription-Content-Type: text/x-rst\nRequires-Dist: zope.interface (>=4.4.2)\nRequires-Dist: constantly (>=15.1)\nRequires-Dist: incremental (>=16.10.1)\nRequires-Dist: Automat (>=0.3.0)\nRequires-Dist: hyperlink (>=17.1.1)\nRequires-Dist: PyHamcrest (>=1.9.0)\nRequires-Dist: attrs (>=17.4.0)\nProvides-Extra: all_non_platform\nRequires-Dist: pyopenssl (>=16.0.0) ; extra == 'all_non_platform'\nRequires-Dist: service-identity (>=18.1.0) ; extra == 'all_non_platform'\nRequires-Dist: idna (!=2.3,>=0.6) ; extra == 'all_non_platform'\nRequires-Dist: pyasn1 ; extra == 'all_non_platform'\nRequires-Dist: cryptography (>=2.5) ; extra == 'all_non_platform'\nRequires-Dist: appdirs (>=1.4.0) ; extra == 'all_non_platform'\nRequires-Dist: bcrypt (>=3.0.0) ; extra == 'all_non_platform'\nRequires-Dist: soappy ; extra == 'all_non_platform'\nRequires-Dist: pyserial (>=3.0) ; extra == 'all_non_platform'\nRequires-Dist: h2 (<4.0,>=3.0) ; extra == 'all_non_platform'\nRequires-Dist: priority (<2.0,>=1.1.0) ; extra == 'all_non_platform'\nProvides-Extra: conch\nRequires-Dist: pyasn1 ; extra == 'conch'\nRequires-Dist: cryptography (>=2.5) ; extra == 'conch'\nRequires-Dist: appdirs (>=1.4.0) ; extra == 'conch'\nRequires-Dist: bcrypt (>=3.0.0) ; extra == 'conch'\nProvides-Extra: dev\nRequires-Dist: pyflakes (>=1.0.0) ; extra == 'dev'\nRequires-Dist: twisted-dev-tools (>=0.0.2) ; extra == 'dev'\nRequires-Dist: python-subunit ; extra == 'dev'\nRequires-Dist: sphinx (>=1.3.1) ; extra == 'dev'\nRequires-Dist: towncrier (>=17.4.0) ; extra == 'dev'\nProvides-Extra: http2\nRequires-Dist: h2 (<4.0,>=3.0) ; extra == 'http2'\nRequires-Dist: priority (<2.0,>=1.1.0) ; extra == 'http2'\nProvides-Extra: macos_platform\nRequires-Dist: pyobjc-core ; extra == 'macos_platform'\nRequires-Dist: pyobjc-framework-CFNetwork ; extra == 'macos_platform'\nRequires-Dist: pyobjc-framework-Cocoa ; extra == 'macos_platform'\nRequires-Dist: pyopenssl (>=16.0.0) ; extra == 'macos_platform'\nRequires-Dist: service-identity (>=18.1.0) ; extra == 'macos_platform'\nRequires-Dist: idna (!=2.3,>=0.6) ; extra == 'macos_platform'\nRequires-Dist: pyasn1 ; extra == 'macos_platform'\nRequires-Dist: cryptography (>=2.5) ; extra == 'macos_platform'\nRequires-Dist: appdirs (>=1.4.0) ; extra == 'macos_platform'\nRequires-Dist: bcrypt (>=3.0.0) ; extra == 'macos_platform'\nRequires-Dist: soappy ; extra == 'macos_platform'\nRequires-Dist: pyserial (>=3.0) ; extra == 'macos_platform'\nRequires-Dist: h2 (<4.0,>=3.0) ; extra == 'macos_platform'\nRequires-Dist: priority (<2.0,>=1.1.0) ; extra == 'macos_platform'\nProvides-Extra: osx_platform\nRequires-Dist: pyobjc-core ; extra == 'osx_platform'\nRequires-Dist: pyobjc-framework-CFNetwork ; extra == 'osx_platform'\nRequires-Dist: pyobjc-framework-Cocoa ; extra == 'osx_platform'\nRequires-Dist: pyopenssl (>=16.0.0) ; extra == 'osx_platform'\nRequires-Dist: service-identity (>=18.1.0) ; extra == 'osx_platform'\nRequires-Dist: idna (!=2.3,>=0.6) ; extra == 'osx_platform'\nRequires-Dist: pyasn1 ; extra == 'osx_platform'\nRequires-Dist: cryptography (>=2.5) ; extra == 'osx_platform'\nRequires-Dist: appdirs (>=1.4.0) ; extra == 'osx_platform'\nRequires-Dist: bcrypt (>=3.0.0) ; extra == 'osx_platform'\nRequires-Dist: soappy ; extra == 'osx_platform'\nRequires-Dist: pyserial (>=3.0) ; extra == 'osx_platform'\nRequires-Dist: h2 (<4.0,>=3.0) ; extra == 'osx_platform'\nRequires-Dist: priority (<2.0,>=1.1.0) ; extra == 'osx_platform'\nProvides-Extra: serial\nRequires-Dist: pyserial (>=3.0) ; extra == 'serial'\nProvides-Extra: soap\nRequires-Dist: soappy ; extra == 'soap'\nProvides-Extra: tls\nRequires-Dist: pyopenssl (>=16.0.0) ; extra == 'tls'\nRequires-Dist: service-identity (>=18.1.0) ; extra == 'tls'\nRequires-Dist: idna (!=2.3,>=0.6) ; extra == 'tls'\nProvides-Extra: windows_platform\nRequires-Dist: pywin32 ; extra == 'windows_platform'\nRequires-Dist: pyopenssl (>=16.0.0) ; extra == 'windows_platform'\nRequires-Dist: service-identity (>=18.1.0) ; extra == 'windows_platform'\nRequires-Dist: idna (!=2.3,>=0.6) ; extra == 'windows_platform'\nRequires-Dist: pyasn1 ; extra == 'windows_platform'\nRequires-Dist: cryptography (>=2.5) ; extra == 'windows_platform'\nRequires-Dist: appdirs (>=1.4.0) ; extra == 'windows_platform'\nRequires-Dist: bcrypt (>=3.0.0) ; extra == 'windows_platform'\nRequires-Dist: soappy ; extra == 'windows_platform'\nRequires-Dist: pyserial (>=3.0) ; extra == 'windows_platform'\nRequires-Dist: h2 (<4.0,>=3.0) ; extra == 'windows_platform'\nRequires-Dist: priority (<2.0,>=1.1.0) ; extra == 'windows_platform'\n\nTwisted\n=======\n\n|pypi|_\n|travis|_\n|circleci|_\n\nFor information on what's new in Twisted 19.2.0, see the `NEWS `_ file that comes with the distribution.\n\n\nWhat is this?\n-------------\n\nTwisted is an event-based framework for internet applications, supporting Python 2.7 and Python 3.5+.\nIt includes modules for many different purposes, including the following:\n\n- ``twisted.web``: HTTP clients and servers, HTML templating, and a WSGI server\n- ``twisted.conch``: SSHv2 and Telnet clients and servers and terminal emulators\n- ``twisted.words``: Clients and servers for IRC, XMPP, and other IM protocols\n- ``twisted.mail``: IMAPv4, POP3, SMTP clients and servers\n- ``twisted.positioning``: Tools for communicating with NMEA-compatible GPS receivers\n- ``twisted.names``: DNS client and tools for making your own DNS servers\n- ``twisted.trial``: A unit testing framework that integrates well with Twisted-based code.\n\nTwisted supports all major system event loops -- ``select`` (all platforms), ``poll`` (most POSIX platforms), ``epoll`` (Linux), ``kqueue`` (FreeBSD, macOS), IOCP (Windows), and various GUI event loops (GTK+2/3, Qt, wxWidgets).\nThird-party reactors can plug into Twisted, and provide support for additional event loops.\n\n\nInstalling\n----------\n\nTo install the latest version of Twisted using pip::\n\n $ pip install twisted\n\nAdditional instructions for installing this software are in `the installation instructions `_.\n\n\nDocumentation and Support\n-------------------------\n\nTwisted's documentation is available from the `Twisted Matrix website `_.\nThis documentation contains how-tos, code examples, and an API reference.\n\nHelp is also available on the `Twisted mailing list `_.\n\nThere is also a pair of very lively IRC channels, ``#twisted`` (for general Twisted questions) and ``#twisted.web`` (for Twisted Web), on ``chat.freenode.net``.\n\n\nUnit Tests\n----------\n\nTwisted has a comprehensive test suite, which can be run by ``tox``::\n\n $ tox -l # to view all test environments\n $ tox -e py27-tests # to run the tests for Python 2.7\n $ tox -e py35-tests # to run the tests for Python 3.5\n\n\nYou can test running the test suite under the different reactors with the ``TWISTED_REACTOR`` environment variable::\n\n $ env TWISTED_REACTOR=epoll tox -e py27-tests\n\n\nSome of these tests may fail if you:\n\n* don't have the dependencies required for a particular subsystem installed,\n* have a firewall blocking some ports (or things like Multicast, which Linux NAT has shown itself to do), or\n* run them as root.\n\n\nCopyright\n---------\n\nAll of the code in this distribution is Copyright (c) 2001-2019 Twisted Matrix Laboratories.\n\nTwisted is made available under the MIT license.\nThe included `LICENSE `_ file describes this in detail.\n\n\nWarranty\n--------\n\n THIS SOFTWARE IS PROVIDED \"AS IS\" WITHOUT WARRANTY OF ANY KIND, EITHER\n EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES\n OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS\n TO THE USE OF THIS SOFTWARE IS WITH YOU.\n\n IN NO EVENT WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY\n AND/OR REDISTRIBUTE THE LIBRARY, BE LIABLE TO YOU FOR ANY DAMAGES, EVEN IF\n SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH\n DAMAGES.\n\nAgain, see the included `LICENSE `_ file for specific legal details.\n\n\n.. |pypi| image:: http://img.shields.io/pypi/v/twisted.svg\n.. _pypi: https://pypi.python.org/pypi/twisted\n\n.. |travis| image:: https://travis-ci.org/twisted/twisted.svg?branch=trunk\n.. _travis: https://travis-ci.org/twisted/twisted\n\n.. |circleci| image:: https://circleci.com/gh/twisted/twisted.svg?style=svg\n.. _circleci: https://circleci.com/gh/twisted/twisted\n\n\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/Twisted-19.7.0.dist-info/RECORD",
"content": "../../../bin/cftp,sha256=uQ-4stYf8E120-asLychp7hW1VjLJxFL_6HNQI0aHdo,289\r\n../../../bin/ckeygen,sha256=4GXdm-6Esn7pGzUxOvnNH_g6nl_jIsNazaBBzD_dkM4,292\r\n../../../bin/conch,sha256=_8hQIr6ODtna6muwkpUnV333R-PyKSOVPjW0PORO3Ho,290\r\n../../../bin/mailmail,sha256=QXut2P7LTlyKMFD6eM8uDlaXlUwnm523mrKmxiYgd4Y,292\r\n../../../bin/pyhtmlizer,sha256=fcX6JmFsYRGMDV9hyV1PULC6x3vJhi3fNW8hwlZVLdg,287\r\n../../../bin/tkconch,sha256=m7e0vrKcr_kYHru2A8qfTV-LynkDFJIc4uMZGh8yEMM,292\r\n../../../bin/trial,sha256=m3QRoAfu-MXf3yMnwDsRzEayV-GGnxNl5J9Si3psuX4,284\r\n../../../bin/twist,sha256=kJTyCYIA1VJw8qmtYnumNRt2eOljm68iOeauiljwibY,304\r\n../../../bin/twistd,sha256=RnXH8pBHK-V3QlTXoxihOlZjhkudgOV1hJr174Z7Sw0,285\r\nTwisted-19.7.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4\r\nTwisted-19.7.0.dist-info/LICENSE,sha256=hbeYQTuohbBswbke_oV6OfaUBxwpsE6A0j6ibuJx1hM,1926\r\nTwisted-19.7.0.dist-info/METADATA,sha256=9lvJRkxJOpFZ8fFA81XkDN6jkCljIvfEvxHUTrWRyFo,9321\r\nTwisted-19.7.0.dist-info/RECORD,,\r\nTwisted-19.7.0.dist-info/WHEEL,sha256=q6ZS0x11G9XscKQI--PbS172VpPpBOOoLI4QlxtsUa0,109\r\nTwisted-19.7.0.dist-info/entry_points.txt,sha256=UK8U0KNTSAegCW9a4j4bDwbOO5c1579QKqXzwsPPcnI,394\r\nTwisted-19.7.0.dist-info/top_level.txt,sha256=e9eVTH2N7T_qnhIPUQhDQilKWgnW7rTHCvHGyd7xp0k,8\r\ntwisted/__init__.py,sha256=A7hcrXmwPGeAGHDPU_wyOTjgqRHAPAuLVvMI9E6xblg,256\r\ntwisted/__main__.py,sha256=-IXh5Xk046Kf8k4NqwciSb4K6q4X4RnKEMwsrbrsn9g,448\r\ntwisted/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/__pycache__/__main__.cpython-36.pyc,,\r\ntwisted/__pycache__/_version.cpython-36.pyc,,\r\ntwisted/__pycache__/copyright.cpython-36.pyc,,\r\ntwisted/__pycache__/plugin.cpython-36.pyc,,\r\ntwisted/_threads/__init__.py,sha256=XUQc4vy6dlY3VYcNQZEGPOThfz6cB6x9-ySpiv3eW8w,570\r\ntwisted/_threads/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/_threads/__pycache__/_convenience.cpython-36.pyc,,\r\ntwisted/_threads/__pycache__/_ithreads.cpython-36.pyc,,\r\ntwisted/_threads/__pycache__/_memory.cpython-36.pyc,,\r\ntwisted/_threads/__pycache__/_pool.cpython-36.pyc,,\r\ntwisted/_threads/__pycache__/_team.cpython-36.pyc,,\r\ntwisted/_threads/__pycache__/_threadworker.cpython-36.pyc,,\r\ntwisted/_threads/_convenience.py,sha256=bME26wNYCSEtoVqCOSqqwMyEhgU9_UXzFu4r-lK9fsI,969\r\ntwisted/_threads/_ithreads.py,sha256=phOeuVsKw3K-BPex6ZutkvNyij8nrYZAmhVgi5wERUo,1810\r\ntwisted/_threads/_memory.py,sha256=8V-KVBG6ngic_XNenwGAslQWsNyoeRhn4Hd5vv4ByoY,1666\r\ntwisted/_threads/_pool.py,sha256=_Nw_ltHAfF24Vy72CoxPXiNkUAfRUlLD3PFiavzy00E,2399\r\ntwisted/_threads/_team.py,sha256=60gJbzlRrx6Ga8Qse7Klpsv5Sqc4a1DYGh52Qt1GJVA,7259\r\ntwisted/_threads/_threadworker.py,sha256=GnzPGY_4nz9_aohIK4l_UnEPEg-o-0u4jCmR8emV4AE,3376\r\ntwisted/_threads/test/__init__.py,sha256=-tNWrOXAaGo9x-k49W4kk9ol44DaBbLFeBSZaHxtzKk,226\r\ntwisted/_threads/test/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/_threads/test/__pycache__/test_convenience.cpython-36.pyc,,\r\ntwisted/_threads/test/__pycache__/test_memory.cpython-36.pyc,,\r\ntwisted/_threads/test/__pycache__/test_team.cpython-36.pyc,,\r\ntwisted/_threads/test/__pycache__/test_threadworker.cpython-36.pyc,,\r\ntwisted/_threads/test/test_convenience.py,sha256=-088jkN0O_GroTglswcmnzz9iS7vUdLvOwN0nwMcJuE,1442\r\ntwisted/_threads/test/test_memory.py,sha256=H3pafUk-1CJL3kE7JM_zQKd0Dte6twFJqFD4j3ntkNY,2148\r\ntwisted/_threads/test/test_team.py,sha256=zY3BDEA5TrQgL5ka1WHOFC4A-6NNA0QU2Th8FBgi5G0,9534\r\ntwisted/_threads/test/test_threadworker.py,sha256=O5QpeGz0vLPApZV1jmnq29jfhG9y8MV8ygnh_4A_YXw,8093\r\ntwisted/_version.py,sha256=2gUxEnRoE1XvGCGzKAozLESbm4b5o6Aaa8H9hqtyLFk,260\r\ntwisted/application/__init__.py,sha256=qAl6aEqUMpJJXs69xa8mxSVpiE4E9MzMkKWX26xo8MM,129\r\ntwisted/application/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/application/__pycache__/app.cpython-36.pyc,,\r\ntwisted/application/__pycache__/internet.cpython-36.pyc,,\r\ntwisted/application/__pycache__/reactors.cpython-36.pyc,,\r\ntwisted/application/__pycache__/service.cpython-36.pyc,,\r\ntwisted/application/__pycache__/strports.cpython-36.pyc,,\r\ntwisted/application/app.py,sha256=bILSMk-3-7MLqoZf7OpbbXwZpxu9KSPAeC52WjR26Hg,23465\r\ntwisted/application/internet.py,sha256=EzTydNA6GYP6bPhkw1Bs4u_hxmGmd-RE_oQwpZszXSg,36974\r\ntwisted/application/reactors.py,sha256=p0LAxCG6gUX4L5k07rIaDhwXZu22pyxaELpoD7USe1M,2169\r\ntwisted/application/runner/__init__.py,sha256=oAOyWGGBaaPSeeHS_vHk2pvip3_-nPVZlPvIf4EkKh4,185\r\ntwisted/application/runner/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/application/runner/__pycache__/_exit.cpython-36.pyc,,\r\ntwisted/application/runner/__pycache__/_pidfile.cpython-36.pyc,,\r\ntwisted/application/runner/__pycache__/_runner.cpython-36.pyc,,\r\ntwisted/application/runner/_exit.py,sha256=injGMM6zHAa488X2m7VE_ImIKxRHR76aXIuGftbTZyQ,3984\r\ntwisted/application/runner/_pidfile.py,sha256=7PJHb2IBI5nz6280u_LpE1yoR0SbbojjJBPvIJHlECQ,6995\r\ntwisted/application/runner/_runner.py,sha256=A2wlGmCgxoWMn48mK-AkN74MeODYbfvhzGU6nxCngK0,5765\r\ntwisted/application/runner/test/__init__.py,sha256=NAk9flgxX4siFhfJm6zpSt9odTHr3mmjQeuq-SOBobo,180\r\ntwisted/application/runner/test/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/application/runner/test/__pycache__/test_exit.cpython-36.pyc,,\r\ntwisted/application/runner/test/__pycache__/test_pidfile.cpython-36.pyc,,\r\ntwisted/application/runner/test/__pycache__/test_runner.cpython-36.pyc,,\r\ntwisted/application/runner/test/test_exit.py,sha256=M3WZICqMykDZg-02VMo2p8QIuyoONkmjMDFKFfIaKMw,2489\r\ntwisted/application/runner/test/test_pidfile.py,sha256=7VHnxmHJJk-_w-77Egk6zm2u-LoN5Sc-DX_Sif-7yHo,12984\r\ntwisted/application/runner/test/test_runner.py,sha256=RZkx-HqEe0lqyTN3QX6t7y7kUbsChAfRo4R5HWKf0s0,13293\r\ntwisted/application/service.py,sha256=7JGdq40MJ_8lgOmEqu_vR7oQHaiXE2H_51hzpneTSJA,12021\r\ntwisted/application/strports.py,sha256=n8kh_673Beui-gQQu5xj7lYxgNyzXWg4IzNNO39UIjk,2233\r\ntwisted/application/test/__init__.py,sha256=QJh3C_0yH0jDm6ViNbaoefp_no7sv7FyuV32ZYWE75s,124\r\ntwisted/application/test/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/application/test/__pycache__/test_internet.cpython-36.pyc,,\r\ntwisted/application/test/__pycache__/test_service.cpython-36.pyc,,\r\ntwisted/application/test/test_internet.py,sha256=bBcMqDsAoXDy88xg5X1nkm8tMruEYBtVmkCkylyeyoI,42340\r\ntwisted/application/test/test_service.py,sha256=YPdTXv2BdRFUOyJdhKO8cPtdplxOmwi1fQjcft_Kw4M,5091\r\ntwisted/application/twist/__init__.py,sha256=YPzoFOyJSICe6QB4XZXFxNyJWsRru-RRvYizhrN9jJE,166\r\ntwisted/application/twist/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/application/twist/__pycache__/_options.cpython-36.pyc,,\r\ntwisted/application/twist/__pycache__/_twist.cpython-36.pyc,,\r\ntwisted/application/twist/_options.py,sha256=7SUx3kQpZbmXEUusRl4tJrGqv0s78GHJGjSOcWk5088,5719\r\ntwisted/application/twist/_twist.py,sha256=hmdSn31p0CPsBupdKoaa_RvTShH4gwigOyuYsJns3to,3499\r\ntwisted/application/twist/test/__init__.py,sha256=B0KIIGDdfaLWhGhs1WBlDQoABIMxwJBl5tSEQmIkoBo,178\r\ntwisted/application/twist/test/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/application/twist/test/__pycache__/test_options.cpython-36.pyc,,\r\ntwisted/application/twist/test/__pycache__/test_twist.cpython-36.pyc,,\r\ntwisted/application/twist/test/test_options.py,sha256=XP8TpbptQST3zFChhBxGJ8SKqUdloxYhEPrUznFHPMc,10906\r\ntwisted/application/twist/test/test_twist.py,sha256=SkVSPN9RcaXZMBVzx3QqnBf2Ljquvjcldb4kZo_DzqI,7618\r\ntwisted/conch/__init__.py,sha256=ePuf1Y1dXhse4EBuyIQUPsHFurM3l28cenQc9R3fL3A,198\r\ntwisted/conch/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/conch/__pycache__/avatar.cpython-36.pyc,,\r\ntwisted/conch/__pycache__/checkers.cpython-36.pyc,,\r\ntwisted/conch/__pycache__/endpoints.cpython-36.pyc,,\r\ntwisted/conch/__pycache__/error.cpython-36.pyc,,\r\ntwisted/conch/__pycache__/interfaces.cpython-36.pyc,,\r\ntwisted/conch/__pycache__/ls.cpython-36.pyc,,\r\ntwisted/conch/__pycache__/manhole.cpython-36.pyc,,\r\ntwisted/conch/__pycache__/manhole_ssh.cpython-36.pyc,,\r\ntwisted/conch/__pycache__/manhole_tap.cpython-36.pyc,,\r\ntwisted/conch/__pycache__/mixin.cpython-36.pyc,,\r\ntwisted/conch/__pycache__/recvline.cpython-36.pyc,,\r\ntwisted/conch/__pycache__/stdio.cpython-36.pyc,,\r\ntwisted/conch/__pycache__/tap.cpython-36.pyc,,\r\ntwisted/conch/__pycache__/telnet.cpython-36.pyc,,\r\ntwisted/conch/__pycache__/ttymodes.cpython-36.pyc,,\r\ntwisted/conch/__pycache__/unix.cpython-36.pyc,,\r\ntwisted/conch/avatar.py,sha256=cJqlSmAbhtnxxsBFLvQ6-kRvbnDSuf4FvnrpvZqEo_Y,1438\r\ntwisted/conch/checkers.py,sha256=UPSJAg4CXSF8Sr1e6CvPYyOcrDJjCr9LLpj3kFisD_M,19742\r\ntwisted/conch/client/__init__.py,sha256=vbi0H87oC9ZMg2pFDUwAa-W7W7XDnFnrglQ3S1TOxKM,139\r\ntwisted/conch/client/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/conch/client/__pycache__/agent.cpython-36.pyc,,\r\ntwisted/conch/client/__pycache__/connect.cpython-36.pyc,,\r\ntwisted/conch/client/__pycache__/default.cpython-36.pyc,,\r\ntwisted/conch/client/__pycache__/direct.cpython-36.pyc,,\r\ntwisted/conch/client/__pycache__/knownhosts.cpython-36.pyc,,\r\ntwisted/conch/client/__pycache__/options.cpython-36.pyc,,\r\ntwisted/conch/client/agent.py,sha256=0barVVIXiD1O_DvfBdGsRobOS2i9pH1tHXuqq_kA1jo,1730\r\ntwisted/conch/client/connect.py,sha256=mEiTeBIhhKdZZkb-qYNwZ_RC75CZ1hf9A_b0Rg7eHuw,672\r\ntwisted/conch/client/default.py,sha256=ekQY-TV_kubRLcp2YGdEi3C1OnAc1_egRVV3qlP5VAQ,11976\r\ntwisted/conch/client/direct.py,sha256=O7Jf4KPh7cyh67VqD8HokSKWQtsyG6dAnexAFY-BbpU,3264\r\ntwisted/conch/client/knownhosts.py,sha256=MiXC4BSXkxq8AsvLhPA_wcgSywBwFOCD7KYvzUocDzA,19875\r\ntwisted/conch/client/options.py,sha256=MJPpxYF36jME_VH-b54klDTdCIlS5YevnDq_ozodjtg,4145\r\ntwisted/conch/endpoints.py,sha256=jOs-YG4F9qaZubNI2xKeKbJ5oXJ0cRym6EeqmO69FM8,29743\r\ntwisted/conch/error.py,sha256=ynbrCK0fo_wdvyUhbV5GsMVvNjbNIFZHzvoT05hOEyg,2716\r\ntwisted/conch/insults/__init__.py,sha256=PALruuxw5vHDKLyzbY6XUcn73FFKhMk44dRQpFdrJvc,76\r\ntwisted/conch/insults/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/conch/insults/__pycache__/helper.cpython-36.pyc,,\r\ntwisted/conch/insults/__pycache__/insults.cpython-36.pyc,,\r\ntwisted/conch/insults/__pycache__/text.cpython-36.pyc,,\r\ntwisted/conch/insults/__pycache__/window.cpython-36.pyc,,\r\ntwisted/conch/insults/helper.py,sha256=SwL14WVDDvHl1uWesi0c0H4BD6JLjgDsY2TUsg3IFPo,14396\r\ntwisted/conch/insults/insults.py,sha256=8q8d5kxf0ah9xgxgzaSfeYDqBhbpCtsO7_k06TOl-BQ,35589\r\ntwisted/conch/insults/text.py,sha256=Cc07uGyoLNcsmtsd_uGMj0aT37zZbUamJB2J4uiXqlk,5424\r\ntwisted/conch/insults/window.py,sha256=eC-Delffu-yT-cKOvkvPpm_Ft9nRYk8QF8_zNuJo8Sg,27812\r\ntwisted/conch/interfaces.py,sha256=6pOyjMrOXPqS1TVwYuoiXSoutO4Wmq-RbiXO1E3p_tI,13636\r\ntwisted/conch/ls.py,sha256=1KtrdFww3j6bIEY2gZ0y_gi4TBy6CLQsoHUzWRcsUR8,2551\r\ntwisted/conch/manhole.py,sha256=wjpTsXUQ2QRbev_1WcJ9Z-2pbi1J5OKmHY2XoeLUpeQ,11832\r\ntwisted/conch/manhole_ssh.py,sha256=NqYFUy305e1DH1WQ3X2SFEG8UPZ6aD8CMKfiQ_4Iduk,3990\r\ntwisted/conch/manhole_tap.py,sha256=Q5Ljl6d73Shi_84GNeAmnIcZKFo_MTkhaPBZIKvW9bs,5370\r\ntwisted/conch/mixin.py,sha256=8haxUUg5oxVCUzJ71-agK4lJ_ObJ828O2U2sds8dGPM,1374\r\ntwisted/conch/openssh_compat/__init__.py,sha256=uIe8Ifysdq6wuLyqjeMXT81DKsZw56QqgxWazKZERu0,152\r\ntwisted/conch/openssh_compat/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/conch/openssh_compat/__pycache__/factory.cpython-36.pyc,,\r\ntwisted/conch/openssh_compat/__pycache__/primes.cpython-36.pyc,,\r\ntwisted/conch/openssh_compat/factory.py,sha256=csprCbaqAQV2V3jcm0jmltxDnl4nY8v3hH7ztTf3lNE,2323\r\ntwisted/conch/openssh_compat/primes.py,sha256=_RyvlWjxwymp18gcA0HaiISr8OPwXM3WmsdowkTybeg,682\r\ntwisted/conch/recvline.py,sha256=jre0-Le7dp-RplyURznthdQuhu1ZQ5JC7V2YT93EK20,11523\r\ntwisted/conch/scripts/__init__.py,sha256=UJRr3MgRq7dcUk9OBG9M0jOmMs2H746XbolCl0dZgwI,16\r\ntwisted/conch/scripts/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/conch/scripts/__pycache__/cftp.cpython-36.pyc,,\r\ntwisted/conch/scripts/__pycache__/ckeygen.cpython-36.pyc,,\r\ntwisted/conch/scripts/__pycache__/conch.cpython-36.pyc,,\r\ntwisted/conch/scripts/__pycache__/tkconch.cpython-36.pyc,,\r\ntwisted/conch/scripts/cftp.py,sha256=TF1LsKgpmK1nCM_Z-2mgdP2ArVwULAYW44zWesmStkM,31775\r\ntwisted/conch/scripts/ckeygen.py,sha256=fceeMBsu3imO-lINBtU72KDMJMsXAT9t74jI9C9Mq6I,10078\r\ntwisted/conch/scripts/conch.py,sha256=gNpQFxlMJsrockj4-14kIqkHgEbB1l-xiXK5pQdeVEA,18462\r\ntwisted/conch/scripts/tkconch.py,sha256=nuBbI7FPh-ufV-RZGqOHFtJoN1-btbzjWE9LBsNd1_s,23189\r\ntwisted/conch/ssh/__init__.py,sha256=IDSvIu8OyDtv2iyBNQlgpZCYPmRDQ1OWBYDm2FUnSXM,183\r\ntwisted/conch/ssh/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/conch/ssh/__pycache__/_kex.cpython-36.pyc,,\r\ntwisted/conch/ssh/__pycache__/address.cpython-36.pyc,,\r\ntwisted/conch/ssh/__pycache__/agent.cpython-36.pyc,,\r\ntwisted/conch/ssh/__pycache__/channel.cpython-36.pyc,,\r\ntwisted/conch/ssh/__pycache__/common.cpython-36.pyc,,\r\ntwisted/conch/ssh/__pycache__/connection.cpython-36.pyc,,\r\ntwisted/conch/ssh/__pycache__/factory.cpython-36.pyc,,\r\ntwisted/conch/ssh/__pycache__/filetransfer.cpython-36.pyc,,\r\ntwisted/conch/ssh/__pycache__/forwarding.cpython-36.pyc,,\r\ntwisted/conch/ssh/__pycache__/keys.cpython-36.pyc,,\r\ntwisted/conch/ssh/__pycache__/service.cpython-36.pyc,,\r\ntwisted/conch/ssh/__pycache__/session.cpython-36.pyc,,\r\ntwisted/conch/ssh/__pycache__/sexpy.cpython-36.pyc,,\r\ntwisted/conch/ssh/__pycache__/transport.cpython-36.pyc,,\r\ntwisted/conch/ssh/__pycache__/userauth.cpython-36.pyc,,\r\ntwisted/conch/ssh/_kex.py,sha256=keHgecXDjuUHu_hv21Aaq6FBasMUZqFk1BtDAZ8DhUE,7668\r\ntwisted/conch/ssh/address.py,sha256=2ZCPpaUa_Evaj_M_KjbBzllx2gf1l2DQt30rXJwL_-s,1158\r\ntwisted/conch/ssh/agent.py,sha256=YITkSpOpiaNSI6EBt4M2EKogOk0Rlj4_QJX0lznRsAs,9692\r\ntwisted/conch/ssh/channel.py,sha256=nS1uE0DmZWUvp0vESpSQoanfktxYI50WNV6Sdfyrz1U,9852\r\ntwisted/conch/ssh/common.py,sha256=B9LRnUkmWZoQOF1PRFk6b-85_NH1jRzMaE0ROPZk1KY,2059\r\ntwisted/conch/ssh/connection.py,sha256=oTD85RQqrKGjHfRBG_PFNoMAJzLc8v6FvZpPY86Vxy0,26151\r\ntwisted/conch/ssh/factory.py,sha256=X28xtqHwEpsDtVswL6ele4Wo_4-q6mLugeW03LGW1As,3820\r\ntwisted/conch/ssh/filetransfer.py,sha256=pIbW2bXLGagYFKSNKmsn9px7tLto-mS3EhTgoM90778,34723\r\ntwisted/conch/ssh/forwarding.py,sha256=L0hBefu4bo4-L-4GCX-wnoFSGmCO9evRFQsm1YcPOVk,8176\r\ntwisted/conch/ssh/keys.py,sha256=zlpe3nNB5xWmgmepeXLN_2RsdCdNmTCR1fmhDw5tIdg,54988\r\ntwisted/conch/ssh/service.py,sha256=YV99lc0ZxNZMqKFurGXe-i5m8VbeBOZjti7HlO61fvU,1456\r\ntwisted/conch/ssh/session.py,sha256=xTVxNdd2MHBP-PhACVZHBLRJPdYn6auAbHZrYPtJ5TE,11225\r\ntwisted/conch/ssh/sexpy.py,sha256=lb0LVT8frScz5WEbMklatpcH5xqSV23ayw-m3CPlJP8,1053\r\ntwisted/conch/ssh/transport.py,sha256=r1xXHsOow7lOooe0rMgfb2cjyRgFcYrgg-JqiXb3los,73499\r\ntwisted/conch/ssh/userauth.py,sha256=jM51sMI7wmOgDVqH8Mbmc0QGWknJK5T5-y0iigchLR4,27336\r\ntwisted/conch/stdio.py,sha256=daZfnkeiP4dWbrAWVS3IwRVRrXA-VWvkyL1JpXO0uco,2764\r\ntwisted/conch/tap.py,sha256=9edTigyWQ7HmwQM52PPXIQEtjK_ENzLIm2TOqbsLnaE,3183\r\ntwisted/conch/telnet.py,sha256=hqa_MuP0QsaBfjqCA5I4qoJNgT0CIevrFZhlZRRqkhk,38539\r\ntwisted/conch/test/__init__.py,sha256=HAuvSUTlRN7E22xo4FEOw_2INTlSQcW-j3maA64RIWE,14\r\ntwisted/conch/test/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/conch/test/__pycache__/keydata.cpython-36.pyc,,\r\ntwisted/conch/test/__pycache__/loopback.cpython-36.pyc,,\r\ntwisted/conch/test/__pycache__/test_address.cpython-36.pyc,,\r\ntwisted/conch/test/__pycache__/test_agent.cpython-36.pyc,,\r\ntwisted/conch/test/__pycache__/test_cftp.cpython-36.pyc,,\r\ntwisted/conch/test/__pycache__/test_channel.cpython-36.pyc,,\r\ntwisted/conch/test/__pycache__/test_checkers.cpython-36.pyc,,\r\ntwisted/conch/test/__pycache__/test_ckeygen.cpython-36.pyc,,\r\ntwisted/conch/test/__pycache__/test_conch.cpython-36.pyc,,\r\ntwisted/conch/test/__pycache__/test_connection.cpython-36.pyc,,\r\ntwisted/conch/test/__pycache__/test_default.cpython-36.pyc,,\r\ntwisted/conch/test/__pycache__/test_endpoints.cpython-36.pyc,,\r\ntwisted/conch/test/__pycache__/test_filetransfer.cpython-36.pyc,,\r\ntwisted/conch/test/__pycache__/test_forwarding.cpython-36.pyc,,\r\ntwisted/conch/test/__pycache__/test_helper.cpython-36.pyc,,\r\ntwisted/conch/test/__pycache__/test_insults.cpython-36.pyc,,\r\ntwisted/conch/test/__pycache__/test_keys.cpython-36.pyc,,\r\ntwisted/conch/test/__pycache__/test_knownhosts.cpython-36.pyc,,\r\ntwisted/conch/test/__pycache__/test_manhole.cpython-36.pyc,,\r\ntwisted/conch/test/__pycache__/test_manhole_tap.cpython-36.pyc,,\r\ntwisted/conch/test/__pycache__/test_mixin.cpython-36.pyc,,\r\ntwisted/conch/test/__pycache__/test_openssh_compat.cpython-36.pyc,,\r\ntwisted/conch/test/__pycache__/test_recvline.cpython-36.pyc,,\r\ntwisted/conch/test/__pycache__/test_scripts.cpython-36.pyc,,\r\ntwisted/conch/test/__pycache__/test_session.cpython-36.pyc,,\r\ntwisted/conch/test/__pycache__/test_ssh.cpython-36.pyc,,\r\ntwisted/conch/test/__pycache__/test_tap.cpython-36.pyc,,\r\ntwisted/conch/test/__pycache__/test_telnet.cpython-36.pyc,,\r\ntwisted/conch/test/__pycache__/test_text.cpython-36.pyc,,\r\ntwisted/conch/test/__pycache__/test_transport.cpython-36.pyc,,\r\ntwisted/conch/test/__pycache__/test_unix.cpython-36.pyc,,\r\ntwisted/conch/test/__pycache__/test_userauth.cpython-36.pyc,,\r\ntwisted/conch/test/__pycache__/test_window.cpython-36.pyc,,\r\ntwisted/conch/test/keydata.py,sha256=kKR2HtebOfEYUJoitfE2f5WP0tLTfiX8T1Y-LuoSzDU,34462\r\ntwisted/conch/test/loopback.py,sha256=qV37tzWIsclzzTBSMiJfZP7-QDu9uBss82vNd926vZk,757\r\ntwisted/conch/test/test_address.py,sha256=OCDd05QbekjIIAMIeTlD39FfFc74TOUScnJSB1fHtQs,1629\r\ntwisted/conch/test/test_agent.py,sha256=9c_mMNa6OesLxvEblONmufuLKgkbngt9hKYZOA4KzAY,13086\r\ntwisted/conch/test/test_cftp.py,sha256=qfSE0uqVjEUqqNGZ24lm4bE3cl4KlisT_k5gT7NQP9Q,50866\r\ntwisted/conch/test/test_channel.py,sha256=xCt_cPTjQdHtu9kMNRBY5v3ZHOZnsiVRsmQaVBNcrO8,12099\r\ntwisted/conch/test/test_checkers.py,sha256=3bQSxiqv_91SAa55bfPKEVsLYccdJGAkQP2W7R2jm2A,31498\r\ntwisted/conch/test/test_ckeygen.py,sha256=Sk0IG-BX77iJfnnwJ6WVOA-1djeDec202WXtIYkL6Es,20158\r\ntwisted/conch/test/test_conch.py,sha256=OOjekhD7uE_VVi-4ShrO8Phss8nQJTbuoyLl2jzqKb0,25140\r\ntwisted/conch/test/test_connection.py,sha256=Bo-o57TFu_HJyD7YSS7L_WPg045bzl7dpoiHfr5F8pY,28729\r\ntwisted/conch/test/test_default.py,sha256=QPDy8v9neuR_q5y2l2-eRk2m7h70ZRX4vl26giyGTJI,11584\r\ntwisted/conch/test/test_endpoints.py,sha256=zEsFSKwShr_D70T5EGPplmldNq5vhKzpwngK-U8FhZE,54561\r\ntwisted/conch/test/test_filetransfer.py,sha256=DNiffEU0csVUwrLHq0kOqRmaRoGzDAgVvKYMh88MuDg,29239\r\ntwisted/conch/test/test_forwarding.py,sha256=DUUceXTLnXBPdEiEdnsRCFr_1mYnDprxgphXXQ3vW5g,2216\r\ntwisted/conch/test/test_helper.py,sha256=Fyl1gfsQbJMwzJN1OgyId5bEVW3rB1wWJdB5KCHpeZ4,20492\r\ntwisted/conch/test/test_insults.py,sha256=8TlCDalzJMnIsXm1nqMuGbkvdzHq9TkfIiR3Jlmtjf0,32330\r\ntwisted/conch/test/test_keys.py,sha256=Cp8SAlEUXm6ExJIo4yzodsDdVLdlnzDNn6DwZnQDwhk,50732\r\ntwisted/conch/test/test_knownhosts.py,sha256=hLDWLTA5UhVFW4kHGjUdXhlviG9ORD0SS0Y8zQy2x2w,49398\r\ntwisted/conch/test/test_manhole.py,sha256=7vznZ_Cye7YcnXUpxvDEMkxug_klwNSAIfiRbfva30U,13462\r\ntwisted/conch/test/test_manhole_tap.py,sha256=MzFrW10USUMe4tR2E7MpIGU94XPQogeSEg9_p6x9bM8,4235\r\ntwisted/conch/test/test_mixin.py,sha256=4_kOBOFf8gbWXEUuPPoggf5e2XBhdrZEa-dcnDoyWM4,1055\r\ntwisted/conch/test/test_openssh_compat.py,sha256=JoSP23u_ITcTvXju4mT_C7iHG3Aad0-R_C9Y7GQxnQM,4630\r\ntwisted/conch/test/test_recvline.py,sha256=81zKYJBYoxwPdr8Mm_yUXMgR4qykVGVaIitDGtK0pUU,25406\r\ntwisted/conch/test/test_scripts.py,sha256=hpbHxsJy4mC9Zn4qH_NVYUhKWaZ85o-9oKPzPppEwq4,1887\r\ntwisted/conch/test/test_session.py,sha256=O9EcNItOWoHaSIs18gzpzzuriKvZ-aQZF2hDpFj3vE8,39464\r\ntwisted/conch/test/test_ssh.py,sha256=XGM-BvVl_kK4bW9NFerqyZUeSso2cmDkxyyxCZbPrG0,32377\r\ntwisted/conch/test/test_tap.py,sha256=UDKmRhcEtFtV3G2D7WTyObP3z9QL1yBremFGxSBY7oc,4951\r\ntwisted/conch/test/test_telnet.py,sha256=-RCx8XJzNvSeygjJVco-RxyK-VYlTnVt29vbjfRGrK8,26524\r\ntwisted/conch/test/test_text.py,sha256=QvJbWCZTTLyAd87Cti2HmZPbDt9QECENq2nrNUvr-bk,3943\r\ntwisted/conch/test/test_transport.py,sha256=8QGS8Fp7bv5WoWEcXMXuvcBH1o_qBvJDNtSepffFzCg,94204\r\ntwisted/conch/test/test_unix.py,sha256=P5M6yUwDYz9x5mbbpO2KW13D-5I4aL2lpyRZ7PMr-9M,2533\r\ntwisted/conch/test/test_userauth.py,sha256=FHck9BxouYpJB42vth9xTCrfUQ2D0TaLwt1RBPuu8m8,32604\r\ntwisted/conch/test/test_window.py,sha256=2Qzq_paXugLOlUWEel3p79g71OuAOPahtQV_1d87mnU,2115\r\ntwisted/conch/ttymodes.py,sha256=J0Z95i2ljFJi9Wrclw_h7RvudTQp5TWXY_QerE8gY8Q,2239\r\ntwisted/conch/ui/__init__.py,sha256=RizFn8MwYiNGvqshvLD3SPhUGafTcMZ-o8U9EkwSF8k,167\r\ntwisted/conch/ui/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/conch/ui/__pycache__/ansi.cpython-36.pyc,,\r\ntwisted/conch/ui/__pycache__/tkvt100.cpython-36.pyc,,\r\ntwisted/conch/ui/ansi.py,sha256=ZMh5UAKbHP55G8nKJcWzdrrQO9wWj8bBMbTRA1c2zZY,7181\r\ntwisted/conch/ui/tkvt100.py,sha256=q3a8r-97Qya7ompsc2wxVHS55uNY_FPe-5vNzOBzoZY,7052\r\ntwisted/conch/unix.py,sha256=dbOqv_-62mWg-6LwfscElkY5ZWvRZIB0AfEry4k6lEk,16307\r\ntwisted/copyright.py,sha256=_BzTp6ekKVHGxy_igsXo4e4Y7TkQiRkGFglIjK0PHkQ,1531\r\ntwisted/cred/__init__.py,sha256=W4NhTuZj7C95wT9UlvVbCa37jcHD_QJCyo5CImBK8Pg,189\r\ntwisted/cred/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/cred/__pycache__/_digest.cpython-36.pyc,,\r\ntwisted/cred/__pycache__/checkers.cpython-36.pyc,,\r\ntwisted/cred/__pycache__/credentials.cpython-36.pyc,,\r\ntwisted/cred/__pycache__/error.cpython-36.pyc,,\r\ntwisted/cred/__pycache__/portal.cpython-36.pyc,,\r\ntwisted/cred/__pycache__/strcred.cpython-36.pyc,,\r\ntwisted/cred/_digest.py,sha256=sSpPeBMKKWYmYrW_fJ-5OwRUykFMVTsUAWHyonBbQ78,4114\r\ntwisted/cred/checkers.py,sha256=cAUY_9xiu8Fmrl1uMbvrkbxgaf137IOYQE8O5dYzKfQ,9219\r\ntwisted/cred/credentials.py,sha256=Q47WuA1omb0v5NoxIenOJV2sTUu_oFk1Ogfmlc2WMqU,16220\r\ntwisted/cred/error.py,sha256=Cpk_fR1EETu-HUAX7pbZakS-gw5nT8IADPbfdPMCt3Q,1037\r\ntwisted/cred/portal.py,sha256=-oz18ZO9qFnWGmTE4bqXmFIvjqJYKJBjebVhjkTuyh4,5406\r\ntwisted/cred/strcred.py,sha256=7_LkVWPalXkU5aTeU-KhNbnQs4Ov0wkM3fhW8xwRLIY,8385\r\ntwisted/cred/test/__init__.py,sha256=dJnJovocFbB0NlnMradQkTYnlhmluUFWNL3_wFUzJek,157\r\ntwisted/cred/test/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/cred/test/__pycache__/test_cramauth.cpython-36.pyc,,\r\ntwisted/cred/test/__pycache__/test_cred.cpython-36.pyc,,\r\ntwisted/cred/test/__pycache__/test_digestauth.cpython-36.pyc,,\r\ntwisted/cred/test/__pycache__/test_simpleauth.cpython-36.pyc,,\r\ntwisted/cred/test/__pycache__/test_strcred.cpython-36.pyc,,\r\ntwisted/cred/test/test_cramauth.py,sha256=8t4EMvxjl2iJBwSFEjppRO_VOunyzd_BWT5qGsJhLyM,2878\r\ntwisted/cred/test/test_cred.py,sha256=ikCGIkSBUkzXqNmqrX3PCJ2dsmAs8FN7FfG2Br3RYXM,13589\r\ntwisted/cred/test/test_digestauth.py,sha256=hJq6Zb5ZUY8FsOLf39tFSSpZxNFJ_0wq3W-DNfTsssU,24353\r\ntwisted/cred/test/test_simpleauth.py,sha256=9RuqcmpS17hEE6le1S5i44AO4PLYhKVhDVLsa5s0AyQ,2953\r\ntwisted/cred/test/test_strcred.py,sha256=CYIaHDkPqfD3lt-w2FPQNdDXZO0Q4CdSrYiDTniV9Z8,26359\r\ntwisted/enterprise/__init__.py,sha256=GnETu2_bpAushHQriI67GNeToHIqtrGNqOjXqg-cGsY,162\r\ntwisted/enterprise/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/enterprise/__pycache__/adbapi.cpython-36.pyc,,\r\ntwisted/enterprise/adbapi.py,sha256=-sHE2s0wLHiIEmModgIc8LfxZRjpG_Ljzv0h4D-rXp4,16883\r\ntwisted/internet/__init__.py,sha256=ickB0k1GfdghN-mprceL4YNhZOqOJTSbTssukmcHhyw,521\r\ntwisted/internet/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/_baseprocess.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/_dumbwin32proc.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/_glibbase.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/_idna.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/_newtls.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/_pollingfile.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/_posixserialport.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/_posixstdio.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/_producer_helpers.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/_resolver.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/_signals.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/_sslverify.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/_threadedselect.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/_win32serialport.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/_win32stdio.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/abstract.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/address.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/asyncioreactor.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/base.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/cfreactor.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/default.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/defer.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/endpoints.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/epollreactor.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/error.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/fdesc.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/gireactor.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/glib2reactor.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/gtk2reactor.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/gtk3reactor.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/inotify.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/interfaces.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/kqreactor.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/main.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/pollreactor.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/posixbase.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/process.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/protocol.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/pyuisupport.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/reactor.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/selectreactor.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/serialport.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/ssl.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/stdio.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/task.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/tcp.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/testing.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/threads.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/tksupport.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/udp.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/unix.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/utils.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/win32eventreactor.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/wxreactor.cpython-36.pyc,,\r\ntwisted/internet/__pycache__/wxsupport.cpython-36.pyc,,\r\ntwisted/internet/_baseprocess.py,sha256=oA5Yr481sEDg4UgsRyPDdwgz7RXJmasV6-jfuiSxlbE,1913\r\ntwisted/internet/_dumbwin32proc.py,sha256=7v0Zi003NzCWLE755g8cxr5ymcV2tN7R2B0Vdqc2WiI,13107\r\ntwisted/internet/_glibbase.py,sha256=UYNKRhHRPS9Qz8xmBIdDzZvYW9_-yQIy94P12O6pqGs,12813\r\ntwisted/internet/_idna.py,sha256=gYjexNDtZN1i0h6qoM161lGgOJrJHuBa1eP53oRr2jw,1397\r\ntwisted/internet/_newtls.py,sha256=NOCNH8CX-3CplooDfnprvg9o6qkUyt8QaMwN2r8_IKY,9332\r\ntwisted/internet/_pollingfile.py,sha256=qJAGGqXSJ6WYX6EyYe9wb-7OogZ_8DckKmTWjruyJDE,8982\r\ntwisted/internet/_posixserialport.py,sha256=gg1KrS3F4k33mULmkxekoM80XE8nhrZ-_oQxq27uTm8,1995\r\ntwisted/internet/_posixstdio.py,sha256=6vMt5L3wPA0c-rsTMyqDA583yVzsiR5o6lQ5FwmHkF8,4687\r\ntwisted/internet/_producer_helpers.py,sha256=eOqBQC5NsjBWT41oxQLwkyBQBh819uACCq-fIYDWRAs,3788\r\ntwisted/internet/_resolver.py,sha256=XjW_CQC8HxeWs7RvZXLLL6F4vN111Z1JC6uTbRK-skc,8530\r\ntwisted/internet/_signals.py,sha256=632Qy-EUB5v5RmhhhyntSkziY4jbb-kr2OhRDIHIrVQ,2718\r\ntwisted/internet/_sslverify.py,sha256=0wkJdmFhwHg4bA6iLSxRUU_hUZalgL0z5eT8WdrSrPk,72643\r\ntwisted/internet/_threadedselect.py,sha256=kYBjTox4Izt0jwTay-zrijjPN1PBZsOcbF1Q2HmsKi0,11764\r\ntwisted/internet/_win32serialport.py,sha256=BG-J2A18t-OWpFgRb0O3kN4KX6YPxVBq7q2knVA9muU,4744\r\ntwisted/internet/_win32stdio.py,sha256=XEF95KvNvyAThHvO3xBBR1ZZSRxyuuAnbWexYFN35Gc,3204\r\ntwisted/internet/abstract.py,sha256=64vN7f-4wT0SjMvZWxGbL0gLCagly7K_jfTJbhhylSU,19274\r\ntwisted/internet/address.py,sha256=etExPe2zLdiMZLMMPdl4sKw-b14-z4qk-es5AjR44P0,5246\r\ntwisted/internet/asyncioreactor.py,sha256=RgqUpwhb9Oj4wuj5S1YSZDcvDD0qfnIGeQ3Dl1T7djA,10553\r\ntwisted/internet/base.py,sha256=YosxpOp73JRDyuUFe6F86Vw5jbxfKkm3UJHgcsw71tE,44807\r\ntwisted/internet/cfreactor.py,sha256=XD3vxoojc4ol__9m-l1UjI7_8x_iy1mS91qK7rrFxDE,17501\r\ntwisted/internet/default.py,sha256=Kaer40mBJZh2FNUjdwkcjLx0H4otwVjSxGJAjah1PeA,1942\r\ntwisted/internet/defer.py,sha256=7tVf05OEL9ZeHi_fbEE5NhsP0e1KCFkt4eOIObyKEi0,71538\r\ntwisted/internet/endpoints.py,sha256=5w7doQW1XUaZeYCXovxOSEZKIun6ZZs8onbe-4p1sAA,77326\r\ntwisted/internet/epollreactor.py,sha256=C88W-ZnEGxH7rLHOyyZEVdjLqA0N4yeprhpMax3gTXc,8493\r\ntwisted/internet/error.py,sha256=sGIWVe03xkrfFv3B3y6oCfxxbvchBZFJg0bU5gPoJ6I,12930\r\ntwisted/internet/fdesc.py,sha256=nVL6TE6JBUJW-Yfyh7uaWBv-NHqE_Uc1qIT2Myz30qk,3223\r\ntwisted/internet/gireactor.py,sha256=CtgJNXQymPyihhiqrWHZqT89g65hSXXZHrITwypVQjI,6123\r\ntwisted/internet/glib2reactor.py,sha256=_fHgbRRmABRTuLZ9hGia_cf5WsKYUoUfn7G3Ue6r8oY,1115\r\ntwisted/internet/gtk2reactor.py,sha256=otOVjJ41g2XqlSkv917z_XjoXtxYku1G6Qu6OrkLCXA,3614\r\ntwisted/internet/gtk3reactor.py,sha256=j_m-9nnTk267VQpfE-SVRplkJTEQGmsRz-dZMQz5kZA,2252\r\ntwisted/internet/inotify.py,sha256=X4mQASe4bdY2_hyh80JdHQYElzqYmsH7I6GMHcJhXxM,14691\r\ntwisted/internet/interfaces.py,sha256=CQTA8orAZHIXl4SLOaPklIHBbplfF7qMT6W0JT_gX2g,96841\r\ntwisted/internet/iocpreactor/__init__.py,sha256=27qHsOLp9irn3pKHUwlAOyJdu9khir4tTTPLj8djNIg,191\r\ntwisted/internet/iocpreactor/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/internet/iocpreactor/__pycache__/abstract.cpython-36.pyc,,\r\ntwisted/internet/iocpreactor/__pycache__/const.cpython-36.pyc,,\r\ntwisted/internet/iocpreactor/__pycache__/interfaces.cpython-36.pyc,,\r\ntwisted/internet/iocpreactor/__pycache__/reactor.cpython-36.pyc,,\r\ntwisted/internet/iocpreactor/__pycache__/setup.cpython-36.pyc,,\r\ntwisted/internet/iocpreactor/__pycache__/tcp.cpython-36.pyc,,\r\ntwisted/internet/iocpreactor/__pycache__/udp.cpython-36.pyc,,\r\ntwisted/internet/iocpreactor/abstract.py,sha256=I9NG1gYeV_qM2GK0OQOsnATXo4mfbGov3KsMZuFKgVU,13140\r\ntwisted/internet/iocpreactor/const.py,sha256=t66XJONPOmxAo65y--PGT3hGuCuzW0hkZSYPn3_rxM0,524\r\ntwisted/internet/iocpreactor/interfaces.py,sha256=QjNOs3GrwNkJDhXno7a6t8cmYPYYZimfzAcolyW5APM,942\r\ntwisted/internet/iocpreactor/notes.txt,sha256=M0nci0EaspffjVOb52oxwbdcCldjBd861kJYbCtOpAg,890\r\ntwisted/internet/iocpreactor/reactor.py,sha256=ljIs-BjzYA4WdWWDuAeWq_FHOis4OhIsZxviOK0tDpE,9190\r\ntwisted/internet/iocpreactor/setup.py,sha256=cDNm15Q783-ma3x24dn_AskmZKzcw_Lm6kSTsb_5kXE,588\r\ntwisted/internet/iocpreactor/tcp.py,sha256=jpM9wcpgvuVvABk8pdWFd52IFOdVEZxG4u_ug_-6wIs,20143\r\ntwisted/internet/iocpreactor/udp.py,sha256=PDN_RpvDmk3P4wr_0NbUjB0c6d3_JWE99_BqIR7QZMA,14016\r\ntwisted/internet/kqreactor.py,sha256=q6rBYkifSJRLgvHM8_DG9yUxfIMrWD8GqXR3IhFOzI0,10292\r\ntwisted/internet/main.py,sha256=Be-vOTGwAjtJp4ClfJS_YcFNi4K6OD5MRZbPAdf1z0c,1054\r\ntwisted/internet/pollreactor.py,sha256=-8iCPvvAmFdrppsUmVi0Y3YB13shYVx5Butm804ECp8,6026\r\ntwisted/internet/posixbase.py,sha256=gqF-AR9g5fuZFuTYgE_bBomw15nf6wayV7T2w2PE0LY,26357\r\ntwisted/internet/process.py,sha256=xjwiddhe5gc77KuNaoJ_wvaoJHuB0PNpD7q32ELzvG4,37757\r\ntwisted/internet/protocol.py,sha256=4H2pC8sMBybJp91_1WEHMELsdndtydqnMIwzgyNnHmA,27134\r\ntwisted/internet/pyuisupport.py,sha256=v265CibEt7gJzS295Gp8krpqWi-6LQc8jOSuKPwILWs,817\r\ntwisted/internet/reactor.py,sha256=MKC3G2suikAAo6jxm2HTVRWizJ6aIoDUp4BBlG_TZ2Q,1863\r\ntwisted/internet/selectreactor.py,sha256=_4uNzRQ1pId94vFgYAILlfMNEC81P5OFjXfY4tXCBkE,6215\r\ntwisted/internet/serialport.py,sha256=6h2KSqB_U1GfduHwNO-XWVQ7deZdIaT9izwyI_OCQf0,2317\r\ntwisted/internet/ssl.py,sha256=p_eXSk4crn1yS9659veU9y-d0npj-61xKwdrLl7Lees,8444\r\ntwisted/internet/stdio.py,sha256=kbU3W7OTnXOvsHGgis2AeX13vzIgmzrgeS3DLRxlUnY,1045\r\ntwisted/internet/task.py,sha256=YwT9EXKh8X9W4UTnwDDVVWMbRQ755HfNc5Vd5sQ-pxs,31157\r\ntwisted/internet/tcp.py,sha256=jBDVMB8PVj2QvvwAgBkRgCLFCkhYT8hmW7X-0qI70EY,54908\r\ntwisted/internet/test/__init__.py,sha256=R0XCXlTn2bvT1mHPrDoQkW4y-WEXFq_jVBO83Nax7jY,112\r\ntwisted/internet/test/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/_posixifaces.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/_win32ifaces.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/connectionmixins.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/fakeendpoint.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/modulehelpers.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/process_cli.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/process_connectionlost.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/process_gireactornocompat.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/process_helper.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/reactormixins.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_abstract.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_address.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_asyncioreactor.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_base.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_baseprocess.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_core.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_coroutines.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_default.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_endpoints.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_epollreactor.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_error.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_fdset.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_filedescriptor.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_gireactor.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_glibbase.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_inlinecb.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_inotify.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_iocp.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_kqueuereactor.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_main.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_newtls.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_pollingfile.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_posixbase.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_posixprocess.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_process.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_protocol.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_resolver.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_serialport.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_sigchld.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_socket.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_stdio.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_tcp.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_testing.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_threads.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_time.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_tls.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_udp.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_udp_internals.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_unix.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_win32events.cpython-36.pyc,,\r\ntwisted/internet/test/__pycache__/test_win32serialport.cpython-36.pyc,,\r\ntwisted/internet/test/_awaittests.py.3only,sha256=651lYVAeyzETW_iKSUSuSC5e4PhbsA-wWTtTg_j8cKY,6175\r\ntwisted/internet/test/_posixifaces.py,sha256=xL3pSciwjrgsc2vDGnDKHOvE4mdrgcl7bn8k0Ntv_VU,4689\r\ntwisted/internet/test/_win32ifaces.py,sha256=vVJB50tK-ld9Dl4twObaEmKkPVUJ33aXGoR3_D-PJdA,3883\r\ntwisted/internet/test/_yieldfromtests.py.3only,sha256=cF9nuNuy-83kpGw7EaIbqZLWyopXSCI_VWNtLl3fZUM,4333\r\ntwisted/internet/test/connectionmixins.py,sha256=Pue7N7q7eKo3YmhcnAofG6Ywqm6qlg0aM-PEVyUo8zw,20442\r\ntwisted/internet/test/fake_CAs/chain.pem,sha256=3oISrpA2Sb0kD6NysWF0imvVJL3B27li6fhvN0f8NWQ,2090\r\ntwisted/internet/test/fake_CAs/not-a-certificate,sha256=GJS9_LOIDdjtHP_M9HZVBli__V-Drd2i_sWSMUyfzlg,84\r\ntwisted/internet/test/fake_CAs/thing1.pem,sha256=RWz-DQyE72AFJo6awm6JarF4NAtDdryvmlYCL1hgkEA,1339\r\ntwisted/internet/test/fake_CAs/thing2-duplicate.pem,sha256=jl9GaNBh32s56E8BGhxhvX9g-VcLFE9bmrcYh-ONyXU,1339\r\ntwisted/internet/test/fake_CAs/thing2.pem,sha256=jl9GaNBh32s56E8BGhxhvX9g-VcLFE9bmrcYh-ONyXU,1339\r\ntwisted/internet/test/fakeendpoint.py,sha256=WyT9ss1Fc_2yeLLgJYkHuunArjULjxP_vzq1NSJUIHQ,1555\r\ntwisted/internet/test/modulehelpers.py,sha256=mA3sU_zQ42YObsSffwtei1JaiB3vZHOQwJG864Nj3pU,1726\r\ntwisted/internet/test/process_cli.py,sha256=SJl3N3-wknNAZsd7gpLVSLNHAbd8XaoGxCgyczRkbE8,664\r\ntwisted/internet/test/process_connectionlost.py,sha256=aDGj_l1QlH2pSmwWRPQbW-YSqjgy-3pVm7tEjmveRVE,119\r\ntwisted/internet/test/process_gireactornocompat.py,sha256=2p8sOZbMzmzI3XsEF5KmG7f09fkNNIL9WSBl1B_5V6o,721\r\ntwisted/internet/test/process_helper.py,sha256=rTonb5m0GZ7SEHdD--OBxitBvOurLo_KXSewArnznos,1081\r\ntwisted/internet/test/reactormixins.py,sha256=bQDbUUhazlVO9ZAsFGD10WNicNlKxC_7MdgfWznPMQo,14054\r\ntwisted/internet/test/test_abstract.py,sha256=mxQNphfzUEaFw24JSP0EXE9DeSwqqoaxPY8u4xS6jc0,2032\r\ntwisted/internet/test/test_address.py,sha256=s2SRx7zOIfNzHsdyyd-Up54C1--5yPgYK_bifGpsCzg,8598\r\ntwisted/internet/test/test_asyncioreactor.py,sha256=AvqcLlFgGKeoMAH_KT0v09v0Kz1-Q-f2JBR6jsf57tg,1331\r\ntwisted/internet/test/test_base.py,sha256=ppOqFt_1MBBG6Gyod47GTwqIhwTiM_y2cyMPfRz8ISc,13369\r\ntwisted/internet/test/test_baseprocess.py,sha256=Z9RUmCFPJ8P75H0rnY7bpXor2ziJ3SG0dWcwYk3FYAM,2613\r\ntwisted/internet/test/test_core.py,sha256=Qvk9lprgYzWgLmGppftwu8VxG6m4trqIbohsRag8Oq4,11262\r\ntwisted/internet/test/test_coroutines.py,sha256=h7mJtgpmxyufah9lGIuobxR9zWZq021YtMhDbJW9dSg,1787\r\ntwisted/internet/test/test_default.py,sha256=Nzy-gVFdIG-jSuaLy79QryRBKKj7yCJN0cb5P2c0L1s,3540\r\ntwisted/internet/test/test_endpoints.py,sha256=cAEAumCdQvM7Hzsgv0zxVKe4-nyHZvvJUxifWKVCaRs,148715\r\ntwisted/internet/test/test_epollreactor.py,sha256=d4AYzKsTlX3vltXsYeuLs1_izD_SDlLppzZu3r8mkok,7336\r\ntwisted/internet/test/test_error.py,sha256=oDVs6B66RlGVry9EUFcB3veY6F7XKbP8ollJtzl3Vls,1117\r\ntwisted/internet/test/test_fdset.py,sha256=4nb3OZQ4IkvxdctWv9D7aqHt9Q2oG2AEnk96id_je8g,13501\r\ntwisted/internet/test/test_filedescriptor.py,sha256=n5dk7wBEBkdEHkdVoP8giao8TuNozXXhuo4u7Rck_Fc,2808\r\ntwisted/internet/test/test_gireactor.py,sha256=nKg_WP2t7Px0qLG0OWwYctQPNFA6umxPB8apJS4cJec,9042\r\ntwisted/internet/test/test_glibbase.py,sha256=cy_fhIkPU1hWGR7X7HCHdxyttwsCW9znx6TfkUx3Ydw,2284\r\ntwisted/internet/test/test_inlinecb.py,sha256=EVvSMw9_P-S6ZPFsvxTl_T1dDsqoa10mrY1ZmxK6pPI,11599\r\ntwisted/internet/test/test_inotify.py,sha256=iNsOQCxh7STqv6UyFVM3CPCUcMGHHoHj5lH9bR-sV-I,16686\r\ntwisted/internet/test/test_iocp.py,sha256=ToWR8uGVP-xRi95rLrgg3XihthvR5vbiJXd0KlRaM-E,5170\r\ntwisted/internet/test/test_kqueuereactor.py,sha256=gwI-cGpRR9clo65AT2O5hJ_ywk4Aa2s3fC5dQ8N5R-o,1916\r\ntwisted/internet/test/test_main.py,sha256=GTjenqA-4z9NgFjkol_umHmFT9yJPc7_hRZm5qvhOgM,1436\r\ntwisted/internet/test/test_newtls.py,sha256=lRPyRBQB23xjyYl26xsHmk3DNvRAXrGq8MGzu0IEMnk,6693\r\ntwisted/internet/test/test_pollingfile.py,sha256=Q9lXthu2zLgpSx8-0JxxRWso3rYy2KzTMS4oYefBKIU,1278\r\ntwisted/internet/test/test_posixbase.py,sha256=yViBaItENJAHROGogmQfYLcCpr214vxRb3Xs6hn-OhE,9536\r\ntwisted/internet/test/test_posixprocess.py,sha256=MAx23Bu8oDxxLD4wsiH8r8U0dG6mwzOC4Hoaxg3F-jQ,11166\r\ntwisted/internet/test/test_process.py,sha256=N7DsHIzbIHA2fQrPeuUKyFonWLOmC3u-yUkek08xWVU,32045\r\ntwisted/internet/test/test_protocol.py,sha256=FYOzV9o1sfU0f9mX-sqmnGRBTIqMFC0AX2VHxXfTkc8,18727\r\ntwisted/internet/test/test_resolver.py,sha256=XelBnCD7C7407RoIi_pmjejNkP7lKvYopFHoXI-ulzw,20153\r\ntwisted/internet/test/test_serialport.py,sha256=61zuFJtDV9_UTAbWWHqFN1X84q5lweVB9hswsjs_b8Q,1948\r\ntwisted/internet/test/test_sigchld.py,sha256=STT-nfEsm4n1Y2NJVkHzQhbQNc-6RnZlu3sXvbL65DU,3935\r\ntwisted/internet/test/test_socket.py,sha256=mYp89LTUAPIHQ-hk0dwBV07WY-jGHaT_xT47dshgLzs,9329\r\ntwisted/internet/test/test_stdio.py,sha256=rcuJcxmqTy253faCcKn5IOb4H37FA9-zD-WmRwRvSLk,6449\r\ntwisted/internet/test/test_tcp.py,sha256=eu263u3jtvHW8NJSMiWZ1D6cRwSznVIUXzGxclWLCGo,108446\r\ntwisted/internet/test/test_testing.py,sha256=3piwz-YZPbta29JSQ35u-gjJIJIB8LvhealU1nO9vGY,16676\r\ntwisted/internet/test/test_threads.py,sha256=QHJlDT8yrt2p694J73OyYuyaQbfoE5JFGhVY11PBrBA,8582\r\ntwisted/internet/test/test_time.py,sha256=mkm9Dzb7WGfSLrGKrO2H_FWYcj9Hd2N23sutQrZM9uY,3717\r\ntwisted/internet/test/test_tls.py,sha256=6B_p8wgbLtiREd7RC7bq91d6Nq3Ttu9EnMFiMxQXbns,13459\r\ntwisted/internet/test/test_udp.py,sha256=xG2LDYVIUDAt9GKo017kkIk2rZV2uDDSMg2Z6zOuaWc,17140\r\ntwisted/internet/test/test_udp_internals.py,sha256=W3KXCY9AGz_BCwSEP86XPmNfHBRPqLwHA1rS2oeXh0Q,4909\r\ntwisted/internet/test/test_unix.py,sha256=uImznrC0H-zKauZsH8EWD_ByLYc3Qc8bZZMj0k2u_yo,35712\r\ntwisted/internet/test/test_win32events.py,sha256=9mDXR-8OVTXow8hgR9F9ygn42NoWPtQjpcLA_RWRmjE,6500\r\ntwisted/internet/test/test_win32serialport.py,sha256=5--jrNIeK1Q5268i1qFlTyj8rvAHKuos53muqidCaNE,5282\r\ntwisted/internet/testing.py,sha256=3k4bJWjcekOwK1N7mT3A-R_IWYXa89gFpgRcv_MOTLc,29106\r\ntwisted/internet/threads.py,sha256=9iwvudl1ROPFollGPXuD7vHLHzZFajNO4QR-9C_apr8,3953\r\ntwisted/internet/tksupport.py,sha256=th9iaGhbwYdurBXmOHfqjagRvi3vKMF-f30FPMne_fk,2045\r\ntwisted/internet/udp.py,sha256=HUJClZLNANFQpmaWqRRV_zM8jbEhHNY7JT3dx8L4ljI,18569\r\ntwisted/internet/unix.py,sha256=i7213Texp8VocUlaFtSp0P75XMmYFkKjJ0Se3sNoOvU,21965\r\ntwisted/internet/utils.py,sha256=38YGqBFgj4aqWuXq6Zme3sAPIYoNB42kBF0qiejJtmc,8347\r\ntwisted/internet/win32eventreactor.py,sha256=XgPo4hKF0a1hLbOVCxRWspGUoB5DtTBQVzNBtV_Dkkc,15193\r\ntwisted/internet/wxreactor.py,sha256=Bj43Qo8v0tm1SDiehiFEZO81wn2vVBdSifKGH3LZuq4,5290\r\ntwisted/internet/wxsupport.py,sha256=gNrChXmxkAVv_ANnVWYIXM7_MHYztDrZXoP8GVGIDqA,1363\r\ntwisted/logger/__init__.py,sha256=wua2tX8Am7sKMFTGoIMhFzT6b6HJRZ46sV9zEVLOzKU,3318\r\ntwisted/logger/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/logger/__pycache__/_buffer.cpython-36.pyc,,\r\ntwisted/logger/__pycache__/_capture.cpython-36.pyc,,\r\ntwisted/logger/__pycache__/_file.cpython-36.pyc,,\r\ntwisted/logger/__pycache__/_filter.cpython-36.pyc,,\r\ntwisted/logger/__pycache__/_flatten.cpython-36.pyc,,\r\ntwisted/logger/__pycache__/_format.cpython-36.pyc,,\r\ntwisted/logger/__pycache__/_global.cpython-36.pyc,,\r\ntwisted/logger/__pycache__/_io.cpython-36.pyc,,\r\ntwisted/logger/__pycache__/_json.cpython-36.pyc,,\r\ntwisted/logger/__pycache__/_legacy.cpython-36.pyc,,\r\ntwisted/logger/__pycache__/_levels.cpython-36.pyc,,\r\ntwisted/logger/__pycache__/_logger.cpython-36.pyc,,\r\ntwisted/logger/__pycache__/_observer.cpython-36.pyc,,\r\ntwisted/logger/__pycache__/_stdlib.cpython-36.pyc,,\r\ntwisted/logger/__pycache__/_util.cpython-36.pyc,,\r\ntwisted/logger/_buffer.py,sha256=Ey_2hKMColHaD4hmmSAfeWx54_y6k2NN05ZtAlSSObg,1484\r\ntwisted/logger/_capture.py,sha256=gkkka_YA9mivTlOakGk1svO39-0z-PgaIyDAM1S_bZU,459\r\ntwisted/logger/_file.py,sha256=cTcmdYkAUG6ZXvSoPUEw6DCjWM9SeHR--KzSy0uoDtg,2485\r\ntwisted/logger/_filter.py,sha256=hFxcx_Zj2MXUdNqjCtxLdFQbd8LMJdtPrUfBxB6Jfgk,6986\r\ntwisted/logger/_flatten.py,sha256=4IHEykWLzF7ETajOPemB-SPJYWsnKlcjjDmiM2tbovA,5091\r\ntwisted/logger/_format.py,sha256=oL_JqJcitW7oB_qUkKNcoJdexU0vQahK8k8otQi4kDM,12436\r\ntwisted/logger/_global.py,sha256=vulnbrNmcfWWArNLjApYasXFt0qiH97w1_Ngu3khvqk,8787\r\ntwisted/logger/_io.py,sha256=nBp4WrTrb7QS2UL4rm8tIEXgBjOHq1pay6jcSWPC2PU,4459\r\ntwisted/logger/_json.py,sha256=8mWj_DOABHynHDSvUBEBqUMVHYZ-O4deVwKJGKx0TqE,10069\r\ntwisted/logger/_legacy.py,sha256=IGc2gfq-FFYz5gJwz-XpLuhHdGrpL0CNvyWiYTNJS2U,5237\r\ntwisted/logger/_levels.py,sha256=EHzcJgMG3TyKV0hnUqX1LIExbPlvXwlEbxQmca0qfLI,3772\r\ntwisted/logger/_logger.py,sha256=htbvVZ-uTQPgu_6SdH2G_S7-0QB6Ui6mcUrYYLHrWz8,9548\r\ntwisted/logger/_observer.py,sha256=3R7RC7t1HQzzoPPLsst76vAqAc8821ofXdL9qQrlcJw,4991\r\ntwisted/logger/_stdlib.py,sha256=FjMeA8N4BzrQL4F-ldsap8nIdBvYOXfYwDPr-39L5gI,4611\r\ntwisted/logger/_util.py,sha256=tjt6KwCfV4aCTZrKgTFhunTgMKsAY19JTUIBgSmDDZM,1328\r\ntwisted/logger/test/__init__.py,sha256=cGAk-ROeAJboDWOal_3es3XGNfc2Krzid7s4tD6zC40,161\r\ntwisted/logger/test/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/logger/test/__pycache__/test_buffer.cpython-36.pyc,,\r\ntwisted/logger/test/__pycache__/test_capture.cpython-36.pyc,,\r\ntwisted/logger/test/__pycache__/test_file.cpython-36.pyc,,\r\ntwisted/logger/test/__pycache__/test_filter.cpython-36.pyc,,\r\ntwisted/logger/test/__pycache__/test_flatten.cpython-36.pyc,,\r\ntwisted/logger/test/__pycache__/test_format.cpython-36.pyc,,\r\ntwisted/logger/test/__pycache__/test_global.cpython-36.pyc,,\r\ntwisted/logger/test/__pycache__/test_io.cpython-36.pyc,,\r\ntwisted/logger/test/__pycache__/test_json.cpython-36.pyc,,\r\ntwisted/logger/test/__pycache__/test_legacy.cpython-36.pyc,,\r\ntwisted/logger/test/__pycache__/test_levels.cpython-36.pyc,,\r\ntwisted/logger/test/__pycache__/test_logger.cpython-36.pyc,,\r\ntwisted/logger/test/__pycache__/test_observer.cpython-36.pyc,,\r\ntwisted/logger/test/__pycache__/test_stdlib.cpython-36.pyc,,\r\ntwisted/logger/test/__pycache__/test_util.cpython-36.pyc,,\r\ntwisted/logger/test/test_buffer.py,sha256=1aktli9DYcJNP6RoSP9UEGWFOZPRkt7X-JjXIp8Yodg,1642\r\ntwisted/logger/test/test_capture.py,sha256=RY6MlSSxV3t2CQfpSL4Bw22lAntqkv3_S9rdUav2vzs,1083\r\ntwisted/logger/test/test_file.py,sha256=cheG1k5tukraq-D69-YkpyYLVuCRwDZBxSJ6Vq_7AtE,5623\r\ntwisted/logger/test/test_filter.py,sha256=eKTEDG9D3A40xean4VURrDqt1E6ahW9zMH4c4M_SPeI,12010\r\ntwisted/logger/test/test_flatten.py,sha256=ED2GgB3lbdSPquZa05sp1A8C2V-vEfIjqIeSgg_ZiMs,9137\r\ntwisted/logger/test/test_format.py,sha256=Ai0fX0tiug5XeFwKkSC0KS5A1Il0zLSONSU6SAymhiA,22563\r\ntwisted/logger/test/test_global.py,sha256=ASCp2U2HY9pxX5mVxezfDf-AlI4Sz92p_DfE1z3_TqM,12049\r\ntwisted/logger/test/test_io.py,sha256=23iLbLF5LW6NNtl1OUF1cewOhahXANuzJdYnDg8zL5c,7212\r\ntwisted/logger/test/test_json.py,sha256=7b4vPpSA_rDvU4odC18GWgHNkGQd-424eENIv-vc4WA,18584\r\ntwisted/logger/test/test_legacy.py,sha256=1UunwkcS4wNj55U4UbI_ju9Ode_AEIP9rO0hERfFchQ,14395\r\ntwisted/logger/test/test_levels.py,sha256=tOk3LKjszhlzyL1Yf9mWDli7JnP3KokbFEk8hH2KSAM,875\r\ntwisted/logger/test/test_logger.py,sha256=DpDTOl2Uunn9MndN7eqxVEU4xZ0rOV7rs8wOJ2XrjoU,7354\r\ntwisted/logger/test/test_observer.py,sha256=gJxSYGkZDddedE5bRufQP6WZqOaVwpmQIykEPemRHEo,5253\r\ntwisted/logger/test/test_stdlib.py,sha256=0jMzZ7VT2KwXKqxmzycArG9FKzmOg6wwuktMJtodgk4,8639\r\ntwisted/logger/test/test_util.py,sha256=dyGJWIINUYI2MeIPEG-NntOByrg6eQ0IeZZhrcdt2K8,2671\r\ntwisted/mail/__init__.py,sha256=TTwDhFQPpKH_2LKY6Bcc1_eBoua-VUIeuY2S1-P22JI,142\r\ntwisted/mail/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/mail/__pycache__/_cred.cpython-36.pyc,,\r\ntwisted/mail/__pycache__/_except.cpython-36.pyc,,\r\ntwisted/mail/__pycache__/imap4.cpython-36.pyc,,\r\ntwisted/mail/__pycache__/interfaces.cpython-36.pyc,,\r\ntwisted/mail/__pycache__/pop3.cpython-36.pyc,,\r\ntwisted/mail/__pycache__/pop3client.cpython-36.pyc,,\r\ntwisted/mail/__pycache__/protocols.cpython-36.pyc,,\r\ntwisted/mail/__pycache__/relay.cpython-36.pyc,,\r\ntwisted/mail/__pycache__/smtp.cpython-36.pyc,,\r\ntwisted/mail/_cred.py,sha256=V-98-Kn5dWa1_6UboZEr77FgshnyFQSdPVcFypXcnZ4,2786\r\ntwisted/mail/_except.py,sha256=2bhvABOlSg_b2rwyyNIgAI4TpaNIsz0mkSVqHv0qn9o,8763\r\ntwisted/mail/imap4.py,sha256=Oa2_Utr0ojbY-cMuaQmGLowZ8_rm4rmalTqrz2W3aug,211261\r\ntwisted/mail/interfaces.py,sha256=RpN6ZHGZ34n2O7R4__AnVXyavlFdxF0hO20HG9-_Elc,32153\r\ntwisted/mail/pop3.py,sha256=IRFvrotm_YB7E3DXGXIn0rpRz4yVBgF4jxQt6TDfYWE,54946\r\ntwisted/mail/pop3client.py,sha256=dWHzCuiijPz2mm9p0AFGCVHzZccjcf2KN5wy6aF4yBY,46706\r\ntwisted/mail/protocols.py,sha256=OdMKy9HSqLjPfma78rFtu5UaHz_SzCBCV9vFucSjOOc,12644\r\ntwisted/mail/relay.py,sha256=DoGtkPnwEL6N9nutaWn4EmV8pxBTFrz_Mnh2tWwvQsY,5361\r\ntwisted/mail/scripts/__pycache__/mailmail.cpython-36.pyc,,\r\ntwisted/mail/scripts/mailmail.py,sha256=grFSxZpUjZvcegj2OkwUkfDunUGpAYv-c75nGY2JfT0,10581\r\ntwisted/mail/smtp.py,sha256=4t5MEHp3_1oaicOO1OQBHhKb-nDdha1FVhZrAu2USQA,71612\r\ntwisted/mail/test/__init__.py,sha256=p5MeYvSnUTo_P8vZfiYhJ1KXeI-Y090YiJfedQFqvkE,24\r\ntwisted/mail/test/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/mail/test/__pycache__/pop3testserver.cpython-36.pyc,,\r\ntwisted/mail/test/__pycache__/test_imap.cpython-36.pyc,,\r\ntwisted/mail/test/__pycache__/test_mailmail.cpython-36.pyc,,\r\ntwisted/mail/test/__pycache__/test_pop3.cpython-36.pyc,,\r\ntwisted/mail/test/__pycache__/test_pop3client.cpython-36.pyc,,\r\ntwisted/mail/test/__pycache__/test_smtp.cpython-36.pyc,,\r\ntwisted/mail/test/pop3testserver.py,sha256=GC8MrFuOEWCA55VkGuZ0cl5eQ8iL7lYj12PzegNhE6w,8249\r\ntwisted/mail/test/rfc822.message,sha256=0nsnccDczctGjuZaRUBDgJ29EViOh-lRVFvgy8Mhwwg,3834\r\ntwisted/mail/test/test_imap.py,sha256=903XJQbfxHo2QOvarhxi5k5vm6-dfTVQAZV3KK8AtX4,265738\r\ntwisted/mail/test/test_mailmail.py,sha256=DzcZrQr7HS_Mpkxtt5UQpIDyX5KwgauTQEbe1tvmHus,12930\r\ntwisted/mail/test/test_pop3.py,sha256=EC0-NqaECqKBEVC0-3vartbdySYWyzTf6w4wNhp5y9E,42094\r\ntwisted/mail/test/test_pop3client.py,sha256=sLFvUs8SEvR79eLVEOLos4ebYuw3xUZvc6_rxVs-pyQ,21986\r\ntwisted/mail/test/test_smtp.py,sha256=j8TwKunZaHIhY7sfS5VtnNRKjEYbp0HRKyojAiChDvc,63927\r\ntwisted/names/__init__.py,sha256=pn-zinHevqxkH0Ww1O7gdT7u_xNISy_is4ODYmO071E,135\r\ntwisted/names/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/names/__pycache__/_rfc1982.cpython-36.pyc,,\r\ntwisted/names/__pycache__/authority.cpython-36.pyc,,\r\ntwisted/names/__pycache__/cache.cpython-36.pyc,,\r\ntwisted/names/__pycache__/client.cpython-36.pyc,,\r\ntwisted/names/__pycache__/common.cpython-36.pyc,,\r\ntwisted/names/__pycache__/dns.cpython-36.pyc,,\r\ntwisted/names/__pycache__/error.cpython-36.pyc,,\r\ntwisted/names/__pycache__/hosts.cpython-36.pyc,,\r\ntwisted/names/__pycache__/resolve.cpython-36.pyc,,\r\ntwisted/names/__pycache__/root.cpython-36.pyc,,\r\ntwisted/names/__pycache__/secondary.cpython-36.pyc,,\r\ntwisted/names/__pycache__/server.cpython-36.pyc,,\r\ntwisted/names/__pycache__/srvconnect.cpython-36.pyc,,\r\ntwisted/names/__pycache__/tap.cpython-36.pyc,,\r\ntwisted/names/_rfc1982.py,sha256=m4BrYSy8VRvdlg4io8DeMB5wzF5v6c2hePVueBnN7Ec,9113\r\ntwisted/names/authority.py,sha256=_wFwPeeSsyMvhtvlCXdOm1CZRlYEhN-nHEO5tw0EHis,16530\r\ntwisted/names/cache.py,sha256=vRGMwuE4lFhf4W2BodlwD8u8SSaMpAOYmTtl8zH1AAE,3804\r\ntwisted/names/client.py,sha256=PDqrkmpwagwzKXGLw5vsisfnCt_YQaxbYpBFWbY1nhw,24549\r\ntwisted/names/common.py,sha256=nFbHZKgxS2m9mv4oOYYTTTxa2XR-Wf0UZ3wqlpTJfCA,7860\r\ntwisted/names/dns.py,sha256=7t4GaYbIOmPx7s54BPEjlktRPQ2lPF89fxsQbJ4-RqM,96976\r\ntwisted/names/error.py,sha256=02_cTkNE6K1Gahwpxwors_qd9gr5ts3x0PghidZejMQ,2056\r\ntwisted/names/hosts.py,sha256=RQlExFaZGDTLvFhRoBH85KeeRI8Eq7UtxcpECBpMF98,4521\r\ntwisted/names/resolve.py,sha256=-zMAKlRaex2DuUXGw7-o2RxYRRrxAGNNa5o_x0Dxrdc,3361\r\ntwisted/names/root.py,sha256=-Q17Eu87jHN8V1V2xkyS5Jk-rn-11Nd5jUvxPoMZ_Uw,12448\r\ntwisted/names/secondary.py,sha256=Rzwbf-PCbzePioyR5AArHoS7ua_qXOz5GwkYNOJhmP4,6085\r\ntwisted/names/server.py,sha256=jtcUz8H2GW3a0XeUrpmkhmlF7GVJZHd8u9Rei06BDJY,22305\r\ntwisted/names/srvconnect.py,sha256=uGSBa0VzKQJgi-E4NbyB0MQgDNiX2BUSgPqJGPF5rW8,9144\r\ntwisted/names/tap.py,sha256=Jls1yZyObp10LUj9DdWFDXniWfju5JbXG8qMJYBHrCY,4832\r\ntwisted/names/test/__init__.py,sha256=d3JTIolomvO_PAkMM5Huipo6vc06Zyp3zhfeAuu_rEQ,26\r\ntwisted/names/test/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/names/test/__pycache__/test_cache.cpython-36.pyc,,\r\ntwisted/names/test/__pycache__/test_client.cpython-36.pyc,,\r\ntwisted/names/test/__pycache__/test_common.cpython-36.pyc,,\r\ntwisted/names/test/__pycache__/test_dns.cpython-36.pyc,,\r\ntwisted/names/test/__pycache__/test_examples.cpython-36.pyc,,\r\ntwisted/names/test/__pycache__/test_hosts.cpython-36.pyc,,\r\ntwisted/names/test/__pycache__/test_names.cpython-36.pyc,,\r\ntwisted/names/test/__pycache__/test_resolve.cpython-36.pyc,,\r\ntwisted/names/test/__pycache__/test_rfc1982.cpython-36.pyc,,\r\ntwisted/names/test/__pycache__/test_rootresolve.cpython-36.pyc,,\r\ntwisted/names/test/__pycache__/test_server.cpython-36.pyc,,\r\ntwisted/names/test/__pycache__/test_srvconnect.cpython-36.pyc,,\r\ntwisted/names/test/__pycache__/test_tap.cpython-36.pyc,,\r\ntwisted/names/test/__pycache__/test_util.cpython-36.pyc,,\r\ntwisted/names/test/test_cache.py,sha256=YNu7OeMpeNNFPJbzvE9a6OxDMybG_hU3xd466ZM_ztM,4916\r\ntwisted/names/test/test_client.py,sha256=nbfVm1Zep5DpKtXhKASpaqXDrH1NbsQwVYC6WcWN1wc,41764\r\ntwisted/names/test/test_common.py,sha256=3iP0IAmfWr-RKQdCmCKNvJw5k8U6DhII6BIN1zvOR7c,4206\r\ntwisted/names/test/test_dns.py,sha256=Y-8t2MAVHOijV_zNx_5aaNr4C8Ac0ALOrg7LGa7ppow,158849\r\ntwisted/names/test/test_examples.py,sha256=-VKU30q-Jkfw2ucz0so0hyyjrH1fJOpcKD1u7NcS6yY,5349\r\ntwisted/names/test/test_hosts.py,sha256=c5cs0ksd5N6s9qa0gxC-rnKd7baJVSiehvSB46EnlDg,8547\r\ntwisted/names/test/test_names.py,sha256=KLblh3uylJ30Fr8Ku83qOwoCKdIg8v9D9JkEN7lMUNE,43096\r\ntwisted/names/test/test_resolve.py,sha256=A3KYPzouCKlR5UOcUz0NATHYhey8QnVLL_398BXQaCo,1075\r\ntwisted/names/test/test_rfc1982.py,sha256=Ib4CocE0s8JAEqp_TvaZH6EjweB_QnrTuuDPmBEmkDo,13992\r\ntwisted/names/test/test_rootresolve.py,sha256=1Cp_QKpBToYSyjW8R3EdJRvbfbHcvvnVMwKeQyNAG8Q,25643\r\ntwisted/names/test/test_server.py,sha256=JQYGRbPoW6Hk5Sq9vsinlehP3KSToh2nRoZdVc3RSFA,41234\r\ntwisted/names/test/test_srvconnect.py,sha256=XSatW9AjCca_uL60AhXrPpOLlosV0AkW733r6kw-iVc,10124\r\ntwisted/names/test/test_tap.py,sha256=kLMsChF8IiCt5l0FQNZeVxoOIG7FlIupb17q6Ld3Q_U,4961\r\ntwisted/names/test/test_util.py,sha256=IGGlPKZ5Wn5L0A_Jj0MdN3_r_xghj_X4J0VLAqR8LTQ,3915\r\ntwisted/pair/__init__.py,sha256=69Cr0TdbaWqxKH2AEB9jxdRNydRnbWwx4kHzYlAFs7c,315\r\ntwisted/pair/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/pair/__pycache__/ethernet.cpython-36.pyc,,\r\ntwisted/pair/__pycache__/ip.cpython-36.pyc,,\r\ntwisted/pair/__pycache__/raw.cpython-36.pyc,,\r\ntwisted/pair/__pycache__/rawudp.cpython-36.pyc,,\r\ntwisted/pair/__pycache__/testing.cpython-36.pyc,,\r\ntwisted/pair/__pycache__/tuntap.cpython-36.pyc,,\r\ntwisted/pair/ethernet.py,sha256=ZKLmhJ9rqPsDVFFgcYqjtnyQf8gkGL-G7jnMNaXc2jo,1698\r\ntwisted/pair/ip.py,sha256=Kb5HfbLZ0wikbfIaKPLgGQHkPHcba5GlbGad3s5932k,2595\r\ntwisted/pair/raw.py,sha256=NJOSZ0D9qp78r3B_T9jivDozAGPaUagg8xtQOogtbAo,811\r\ntwisted/pair/rawudp.py,sha256=F67B2yZ0IqpW9bMNWk3-4gvQ1YtW9DZyBL6ZeWwzG8Q,1813\r\ntwisted/pair/test/__init__.py,sha256=mAc-2NR8lrqRyWN-YI4kn9LUZ7So6ae3xJ2RzldDQ1w,13\r\ntwisted/pair/test/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/pair/test/__pycache__/test_ethernet.cpython-36.pyc,,\r\ntwisted/pair/test/__pycache__/test_ip.cpython-36.pyc,,\r\ntwisted/pair/test/__pycache__/test_rawudp.cpython-36.pyc,,\r\ntwisted/pair/test/__pycache__/test_tuntap.cpython-36.pyc,,\r\ntwisted/pair/test/test_ethernet.py,sha256=iWxYX0e65w5Nq6r_cthyLSpAwvWjVW7AX-UVhfBpR_c,6653\r\ntwisted/pair/test/test_ip.py,sha256=euftwHEBKqvwaQQpta9jvKS5de49tz3oqtLC10p2xlg,15148\r\ntwisted/pair/test/test_rawudp.py,sha256=yze31pPb0eKWsfRUrHOFBIr6jC9tTgGvekw42Gk-T5M,13074\r\ntwisted/pair/test/test_tuntap.py,sha256=S2OTUrXwu1-ku_dEM6MHjmTlKpuRsajQuUgn9XJKnpo,47567\r\ntwisted/pair/testing.py,sha256=MZRPms9JY-FTQX8k91gND5MNd23Esz_RDLBLqNZodp0,17307\r\ntwisted/pair/tuntap.py,sha256=TxshMXYq2GYTWyxxjaNPpIPggigozJ0PFLkAnG-z8GA,12538\r\ntwisted/persisted/__init__.py,sha256=zyAGR02ZdUO8fNoKHf602wUApt3DvnnfD-B4iJ1QJqI,136\r\ntwisted/persisted/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/persisted/__pycache__/aot.cpython-36.pyc,,\r\ntwisted/persisted/__pycache__/crefutil.cpython-36.pyc,,\r\ntwisted/persisted/__pycache__/dirdbm.cpython-36.pyc,,\r\ntwisted/persisted/__pycache__/sob.cpython-36.pyc,,\r\ntwisted/persisted/__pycache__/styles.cpython-36.pyc,,\r\ntwisted/persisted/aot.py,sha256=9J-HHadGM8z7jDH37peHqP1WdgZ9roqmAnqycOeB-n8,18605\r\ntwisted/persisted/crefutil.py,sha256=Xp3-vK0OeOroNd2NJH1vJhiXUHsmBZ6_9r_uDK9FE8g,4375\r\ntwisted/persisted/dirdbm.py,sha256=JU8ZwO7ZF2lIhc6H-T6lCvAsgXxiydYc31JRkLqbj_8,10141\r\ntwisted/persisted/sob.py,sha256=-yhIm6Ah6UhGRTs3v6l6ZWHJMU8DorDuadg34YztWHs,5197\r\ntwisted/persisted/styles.py,sha256=wD9iJHv7hIH6GUTP9s5HuREfNzCA4yguaRHeWacFzc4,13495\r\ntwisted/persisted/test/__init__.py,sha256=C5rPf38HFfuGrl35BEIrhxgs9HtwoEMpxPvNdNHNELk,113\r\ntwisted/persisted/test/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/persisted/test/__pycache__/test_styles.cpython-36.pyc,,\r\ntwisted/persisted/test/test_styles.py,sha256=0s26icbUsYU1v4FLhTpxaT49vLuYDhr4Y6etvTru1JQ,3388\r\ntwisted/plugin.py,sha256=1ZW0wvUbQ0GYV0ry7JX2qu2LTH35b6WzfPRTG9HhwDo,8407\r\ntwisted/plugins/__init__.py,sha256=lk9vXST0ZZip_WzApTLgsFmWKA0SDJLHe5HyNBFDers,590\r\ntwisted/plugins/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/plugins/__pycache__/cred_anonymous.cpython-36.pyc,,\r\ntwisted/plugins/__pycache__/cred_file.cpython-36.pyc,,\r\ntwisted/plugins/__pycache__/cred_memory.cpython-36.pyc,,\r\ntwisted/plugins/__pycache__/cred_sshkeys.cpython-36.pyc,,\r\ntwisted/plugins/__pycache__/cred_unix.cpython-36.pyc,,\r\ntwisted/plugins/__pycache__/twisted_conch.cpython-36.pyc,,\r\ntwisted/plugins/__pycache__/twisted_core.cpython-36.pyc,,\r\ntwisted/plugins/__pycache__/twisted_ftp.cpython-36.pyc,,\r\ntwisted/plugins/__pycache__/twisted_inet.cpython-36.pyc,,\r\ntwisted/plugins/__pycache__/twisted_names.cpython-36.pyc,,\r\ntwisted/plugins/__pycache__/twisted_portforward.cpython-36.pyc,,\r\ntwisted/plugins/__pycache__/twisted_reactors.cpython-36.pyc,,\r\ntwisted/plugins/__pycache__/twisted_runner.cpython-36.pyc,,\r\ntwisted/plugins/__pycache__/twisted_socks.cpython-36.pyc,,\r\ntwisted/plugins/__pycache__/twisted_trial.cpython-36.pyc,,\r\ntwisted/plugins/__pycache__/twisted_web.cpython-36.pyc,,\r\ntwisted/plugins/__pycache__/twisted_words.cpython-36.pyc,,\r\ntwisted/plugins/cred_anonymous.py,sha256=vpl3-TdqBrPcPYEMnuDPcI0ZfWDmvxS6n0W6rt9dS-Q,1017\r\ntwisted/plugins/cred_file.py,sha256=EbDvh1Sgf5BcoTD5k9-sJey43wiJpJNmypHUVWD4TcA,1875\r\ntwisted/plugins/cred_memory.py,sha256=8rRWaV93xIOIY5sXnUCpFsvD2va0v_iqs3dDO7KAUp0,2387\r\ntwisted/plugins/cred_sshkeys.py,sha256=0bSoTYESFswyRdGxSsmr5q9LZs4JL0sAnAzXMeLeecc,1498\r\ntwisted/plugins/cred_unix.py,sha256=xUlXtGd6RPEpWrO5J1cB6Cw6URJ1cSEtdcq1Xe5vBYc,5905\r\ntwisted/plugins/twisted_conch.py,sha256=5uZ8DxMkL9ZoajHKqTCxOGEMarZIeomKgfY9JfGA2LA,519\r\ntwisted/plugins/twisted_core.py,sha256=UYnNWMLp3tMpbWjzQYDNYGyQeO6CKhrum7-Qo_wUnos,589\r\ntwisted/plugins/twisted_ftp.py,sha256=2YITyfTb3iAUnJoEfMCh0jVjnGjO6O_nHR_SAS4auGs,229\r\ntwisted/plugins/twisted_inet.py,sha256=VBtuyAPilMxsjykF4rVLyGgtr0R_Q3dXB8E-SBFztVk,260\r\ntwisted/plugins/twisted_names.py,sha256=8dMOvdQzlVu6etrsLKGFcj4LJlbg9N2FFqzTZais7bg,247\r\ntwisted/plugins/twisted_portforward.py,sha256=f3tDxoFwoJV0BfW8b1jXrYjr72GQIKcgGykaxkUBcpg,275\r\ntwisted/plugins/twisted_reactors.py,sha256=bZjUWLDKFMRW5kReCWCyPTb6zYiPCSyZ4_dJJ0vgTH0,1880\r\ntwisted/plugins/twisted_runner.py,sha256=4onfqhfRsx2XnBn7c4bWt8dxMmQyrpALUYeB9ZZ20EQ,278\r\ntwisted/plugins/twisted_socks.py,sha256=M8G4xLBbk3S-klsY0HNwWIA2xXhy4VQpjsLRM_bIvLE,247\r\ntwisted/plugins/twisted_trial.py,sha256=hpii1iu8KvcTz6basUtpz0VfZ3b6TLCINYpLjy2l78I,2084\r\ntwisted/plugins/twisted_web.py,sha256=ef7vqQPmVigdoowgJWR3zAwgPs9ANV9ezC5cEQOuaQc,312\r\ntwisted/plugins/twisted_words.py,sha256=Qf1p7QsLjl0uqGAm-MvricGjyZE-Ceq3PqjwwrJokYo,1029\r\ntwisted/positioning/__init__.py,sha256=y_fhSJlC3z4GeB-rC3z2tiprb3JxxGvlYv-GHmuhv1Q,223\r\ntwisted/positioning/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/positioning/__pycache__/_sentence.cpython-36.pyc,,\r\ntwisted/positioning/__pycache__/base.cpython-36.pyc,,\r\ntwisted/positioning/__pycache__/ipositioning.cpython-36.pyc,,\r\ntwisted/positioning/__pycache__/nmea.cpython-36.pyc,,\r\ntwisted/positioning/_sentence.py,sha256=G8vKaSb_8T-khzyGeeDht6PWtQYugU4_kQr4-VdET8A,4004\r\ntwisted/positioning/base.py,sha256=H83JCeCxX0V3GGN0sEyHiEDeuM1GyDOMAgf6ngnl4LQ,28410\r\ntwisted/positioning/ipositioning.py,sha256=hxGOOrFK0Hqj0gvNA5lTU0J6sbQr-zN4ErVh8gRnffA,3013\r\ntwisted/positioning/nmea.py,sha256=1rcMypYwWD6A468USl9lbOb80Qxla6_VVsSTTOqXPyY,35975\r\ntwisted/positioning/test/__init__.py,sha256=Ekrh30kyy4hMgeFG33jFNP-S209JCflSF7hTan4MKEo,125\r\ntwisted/positioning/test/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/positioning/test/__pycache__/receiver.cpython-36.pyc,,\r\ntwisted/positioning/test/__pycache__/test_base.cpython-36.pyc,,\r\ntwisted/positioning/test/__pycache__/test_nmea.cpython-36.pyc,,\r\ntwisted/positioning/test/__pycache__/test_sentence.cpython-36.pyc,,\r\ntwisted/positioning/test/receiver.py,sha256=eLkfrggQVEPHfpB12vC1E8T3oud5tvAYK4gEejC4wjE,1166\r\ntwisted/positioning/test/test_base.py,sha256=FbsYzs122PkztgjDKxCb44Lb626UAqOyJBwwLXQjn6g,28897\r\ntwisted/positioning/test/test_nmea.py,sha256=mTs_PNwZv-DmMJC_QIibP_kbSazNXl2DY14BaheHKAw,39925\r\ntwisted/positioning/test/test_sentence.py,sha256=REOT5BUY-vUz_FEbmWrapgel9-dmcH41fIpeNo4peJE,4770\r\ntwisted/protocols/__init__.py,sha256=11Pa7Emr3WMc3VvzbjfrTydeVl4rpQJ587BWXZD125w,391\r\ntwisted/protocols/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/protocols/__pycache__/amp.cpython-36.pyc,,\r\ntwisted/protocols/__pycache__/basic.cpython-36.pyc,,\r\ntwisted/protocols/__pycache__/dict.cpython-36.pyc,,\r\ntwisted/protocols/__pycache__/finger.cpython-36.pyc,,\r\ntwisted/protocols/__pycache__/ftp.cpython-36.pyc,,\r\ntwisted/protocols/__pycache__/htb.cpython-36.pyc,,\r\ntwisted/protocols/__pycache__/ident.cpython-36.pyc,,\r\ntwisted/protocols/__pycache__/loopback.cpython-36.pyc,,\r\ntwisted/protocols/__pycache__/memcache.cpython-36.pyc,,\r\ntwisted/protocols/__pycache__/pcp.cpython-36.pyc,,\r\ntwisted/protocols/__pycache__/policies.cpython-36.pyc,,\r\ntwisted/protocols/__pycache__/portforward.cpython-36.pyc,,\r\ntwisted/protocols/__pycache__/postfix.cpython-36.pyc,,\r\ntwisted/protocols/__pycache__/sip.cpython-36.pyc,,\r\ntwisted/protocols/__pycache__/socks.cpython-36.pyc,,\r\ntwisted/protocols/__pycache__/stateful.cpython-36.pyc,,\r\ntwisted/protocols/__pycache__/tls.cpython-36.pyc,,\r\ntwisted/protocols/__pycache__/wire.cpython-36.pyc,,\r\ntwisted/protocols/amp.py,sha256=y_Nvxa4lOQpx3D3qrWIB_XkY3AiMCG7OQPSm5lBwI1Y,97898\r\ntwisted/protocols/basic.py,sha256=aJGgFcI8hRVuqcXJrp5aPCgUx-U73SKUYhOSprEK4LQ,32061\r\ntwisted/protocols/dict.py,sha256=osi8Fjn7QALiRTtuFyDdZymRtdjxceO5CxwIaQBeqSk,10762\r\ntwisted/protocols/finger.py,sha256=MHoysns-8Wi3QfrZNIvoUQVyASQSzx-t3GzjYp9MPK0,1220\r\ntwisted/protocols/ftp.py,sha256=DzUEKyf9NmVXtOrzOZbV0IPkpR96WSvcRRW1REM8CEk,106132\r\ntwisted/protocols/haproxy/__init__.py,sha256=TyD3qy2qDa2p6zw0Q3DkPeWS5ChiAEzX0JZfAfFdtYg,251\r\ntwisted/protocols/haproxy/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/protocols/haproxy/__pycache__/_exceptions.cpython-36.pyc,,\r\ntwisted/protocols/haproxy/__pycache__/_info.cpython-36.pyc,,\r\ntwisted/protocols/haproxy/__pycache__/_interfaces.cpython-36.pyc,,\r\ntwisted/protocols/haproxy/__pycache__/_parser.cpython-36.pyc,,\r\ntwisted/protocols/haproxy/__pycache__/_v1parser.cpython-36.pyc,,\r\ntwisted/protocols/haproxy/__pycache__/_v2parser.cpython-36.pyc,,\r\ntwisted/protocols/haproxy/__pycache__/_wrapper.cpython-36.pyc,,\r\ntwisted/protocols/haproxy/_exceptions.py,sha256=SW9Zeft6X9W2HtPY9Mfh2AIbQVuoX8UNs7l4eOz0Izo,1085\r\ntwisted/protocols/haproxy/_info.py,sha256=OB180dloGeTnpjxeVBObB6P-e3VU223ZK4ImHsBNvZM,929\r\ntwisted/protocols/haproxy/_interfaces.py,sha256=bDsfV4TKelDi5vW_dig0vmh8grcM7R6KZJrb7kTnlO0,1794\r\ntwisted/protocols/haproxy/_parser.py,sha256=AT7MMzwMx8kaMbVjDjLiJSt8MiuzApbwu7LFn5vxTOI,2051\r\ntwisted/protocols/haproxy/_v1parser.py,sha256=LAM2OeeV-vC5b85ohEPk1mcUnqMOQJgnUvA0NF7kUKk,4326\r\ntwisted/protocols/haproxy/_v2parser.py,sha256=JkSl8VWd7YMw5V6JNJ6LhunnWf_DVl_jde6isu7_VF4,6307\r\ntwisted/protocols/haproxy/_wrapper.py,sha256=4lA_nXL-pdzgXJ_5DXPwrnqvfOSC9gWLuovOdlMJ6jA,3323\r\ntwisted/protocols/haproxy/test/__init__.py,sha256=gxu5b7Qz4fM2tMbIm4VeUfMY4NthR3rzZlnX1VO_JUU,183\r\ntwisted/protocols/haproxy/test/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/protocols/haproxy/test/__pycache__/test_parser.cpython-36.pyc,,\r\ntwisted/protocols/haproxy/test/__pycache__/test_v1parser.cpython-36.pyc,,\r\ntwisted/protocols/haproxy/test/__pycache__/test_v2parser.cpython-36.pyc,,\r\ntwisted/protocols/haproxy/test/__pycache__/test_wrapper.cpython-36.pyc,,\r\ntwisted/protocols/haproxy/test/test_parser.py,sha256=k7RipRqyta7A4XySeBDQQrNBTqWO3nMr7ZgTgHpYLy4,3467\r\ntwisted/protocols/haproxy/test/test_v1parser.py,sha256=4hUm8u_vbAwPrrdRouAN1bDephjikVn5yFrB3e6b1H8,4694\r\ntwisted/protocols/haproxy/test/test_v2parser.py,sha256=PuyYjAYyLho-M8iOU1znggWjEvowhFTFVemblipH-EE,11777\r\ntwisted/protocols/haproxy/test/test_wrapper.py,sha256=8vRib0ifsoeAeeefQN0y5r0lo0_sTEMpoMzKUx6W4c4,13035\r\ntwisted/protocols/htb.py,sha256=NAiAptbEWvk46eDOlvLi1NjDfgkhSAFzNdS46mPjqsM,9327\r\ntwisted/protocols/ident.py,sha256=KV78Gj7IguHGpsOzEgkgIFPAqaiUNlXoiRSGBUChZcc,7781\r\ntwisted/protocols/loopback.py,sha256=xRPWLdrukRJth5yp8TWXspLofVR_HApqfk65pE7UJ4s,11928\r\ntwisted/protocols/memcache.py,sha256=98KnhDWuVDj_FBiNiM5MAsQrQg6xCrjkIko_rxqigTM,23693\r\ntwisted/protocols/pcp.py,sha256=sZWqAcibTFdsZnep-2Ml9lZwtT86z8FL6QCr-UH7-eU,7088\r\ntwisted/protocols/policies.py,sha256=SIp1MDpyhZTf7296XGiJHP_OC2WmMFS0G3Dwo9wOWl8,21327\r\ntwisted/protocols/portforward.py,sha256=Ob19TUzNKwq5OACeTBe35ZthfaGtu0o96gAbGBMGTNo,2383\r\ntwisted/protocols/postfix.py,sha256=2erA8Ap2nKF9W6t25TXk3ozG9wsW7ynDcjkN5BLwFQE,3953\r\ntwisted/protocols/sip.py,sha256=BSc-8qrcrx7gpz0Ku1vqX_wkdrZssi9huD1nDVEsoWs,37794\r\ntwisted/protocols/socks.py,sha256=kYGCYSO_K4YcSW3eG2iij9qye45-sokhMHz6h5gSejw,7816\r\ntwisted/protocols/stateful.py,sha256=6r-k3nLKMIa4M_9x1NRn5LWJ2BUPrn4jRh1TP8Jqltw,1640\r\ntwisted/protocols/test/__init__.py,sha256=QMkwFc9QOiSDp4ZU06wLjPDi3iw0y3ysUgdjOPceMu0,118\r\ntwisted/protocols/test/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/protocols/test/__pycache__/test_basic.cpython-36.pyc,,\r\ntwisted/protocols/test/__pycache__/test_tls.cpython-36.pyc,,\r\ntwisted/protocols/test/test_basic.py,sha256=2LqruAhTDMjhjP_afc018EQ2SwxmeBY6KXjS0KMBhZY,43214\r\ntwisted/protocols/test/test_tls.py,sha256=zSTdoAeXZEyNBM8yuMD07rBJSgGsoPJFjdCp7WQ_dyA,75552\r\ntwisted/protocols/tls.py,sha256=GmaSZCckJRo1W-winsYwf_uHfOeg-2wl1CveH5PgEWU,32620\r\ntwisted/protocols/wire.py,sha256=47h5tn358eT-T_c-QULiRm8CavhH74TxdLFKx-B1mUg,2556\r\ntwisted/python/__init__.py,sha256=59IqUE-1fknNPjKnfvC46EWCIdUeqEcUxAofVFiPSSU,674\r\ntwisted/python/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/python/__pycache__/_appdirs.cpython-36.pyc,,\r\ntwisted/python/__pycache__/_inotify.cpython-36.pyc,,\r\ntwisted/python/__pycache__/_oldstyle.cpython-36.pyc,,\r\ntwisted/python/__pycache__/_release.cpython-36.pyc,,\r\ntwisted/python/__pycache__/_setup.cpython-36.pyc,,\r\ntwisted/python/__pycache__/_shellcomp.cpython-36.pyc,,\r\ntwisted/python/__pycache__/_textattributes.cpython-36.pyc,,\r\ntwisted/python/__pycache__/_tzhelper.cpython-36.pyc,,\r\ntwisted/python/__pycache__/_url.cpython-36.pyc,,\r\ntwisted/python/__pycache__/compat.cpython-36.pyc,,\r\ntwisted/python/__pycache__/components.cpython-36.pyc,,\r\ntwisted/python/__pycache__/constants.cpython-36.pyc,,\r\ntwisted/python/__pycache__/context.cpython-36.pyc,,\r\ntwisted/python/__pycache__/deprecate.cpython-36.pyc,,\r\ntwisted/python/__pycache__/failure.cpython-36.pyc,,\r\ntwisted/python/__pycache__/fakepwd.cpython-36.pyc,,\r\ntwisted/python/__pycache__/filepath.cpython-36.pyc,,\r\ntwisted/python/__pycache__/formmethod.cpython-36.pyc,,\r\ntwisted/python/__pycache__/htmlizer.cpython-36.pyc,,\r\ntwisted/python/__pycache__/lockfile.cpython-36.pyc,,\r\ntwisted/python/__pycache__/log.cpython-36.pyc,,\r\ntwisted/python/__pycache__/logfile.cpython-36.pyc,,\r\ntwisted/python/__pycache__/modules.cpython-36.pyc,,\r\ntwisted/python/__pycache__/monkey.cpython-36.pyc,,\r\ntwisted/python/__pycache__/procutils.cpython-36.pyc,,\r\ntwisted/python/__pycache__/randbytes.cpython-36.pyc,,\r\ntwisted/python/__pycache__/rebuild.cpython-36.pyc,,\r\ntwisted/python/__pycache__/reflect.cpython-36.pyc,,\r\ntwisted/python/__pycache__/release.cpython-36.pyc,,\r\ntwisted/python/__pycache__/roots.cpython-36.pyc,,\r\ntwisted/python/__pycache__/runtime.cpython-36.pyc,,\r\ntwisted/python/__pycache__/sendmsg.cpython-36.pyc,,\r\ntwisted/python/__pycache__/shortcut.cpython-36.pyc,,\r\ntwisted/python/__pycache__/syslog.cpython-36.pyc,,\r\ntwisted/python/__pycache__/systemd.cpython-36.pyc,,\r\ntwisted/python/__pycache__/text.cpython-36.pyc,,\r\ntwisted/python/__pycache__/threadable.cpython-36.pyc,,\r\ntwisted/python/__pycache__/threadpool.cpython-36.pyc,,\r\ntwisted/python/__pycache__/url.cpython-36.pyc,,\r\ntwisted/python/__pycache__/urlpath.cpython-36.pyc,,\r\ntwisted/python/__pycache__/usage.cpython-36.pyc,,\r\ntwisted/python/__pycache__/util.cpython-36.pyc,,\r\ntwisted/python/__pycache__/versions.cpython-36.pyc,,\r\ntwisted/python/__pycache__/win32.cpython-36.pyc,,\r\ntwisted/python/__pycache__/zippath.cpython-36.pyc,,\r\ntwisted/python/__pycache__/zipstream.cpython-36.pyc,,\r\ntwisted/python/_appdirs.py,sha256=bw_i8btCVr-TH62QlcP-Gdt5v6R0hoCaiZyYk2ZvVxA,788\r\ntwisted/python/_inotify.py,sha256=aYbn1L_5MM62Gl60GzlkiwOHTc6mB0lUCr1tP-FsgPU,3455\r\ntwisted/python/_oldstyle.py,sha256=ksosHBxHm691H3HwaR1ORGMNC-7q2U-IwTMpcxqugZ0,2593\r\ntwisted/python/_pydoctortemplates/common.html,sha256=KxdAlEXi-ihLekHIh0t1VGHIRNv1QzOHLdU7F3jtuTY,3341\r\ntwisted/python/_pydoctortemplates/index.html,sha256=JecyxRLyBd8Z45KbYD_rQeTeRizrXIjlNslU3uLppjM,3565\r\ntwisted/python/_pydoctortemplates/summary.html,sha256=E_LjXUI4vwx8G7_5ZwAd6LndTeYxUTCrjGUOMiUtu1Y,1980\r\ntwisted/python/_release.py,sha256=xqUE9jUSx0rKKI00hFYfz7NXA8h7b9orFpWZODYRJek,18550\r\ntwisted/python/_setup.py,sha256=0qYzsSph8fvBU-XmVsCi6tTEz41Z2eva_N25E_1c78Q,14352\r\ntwisted/python/_shellcomp.py,sha256=9mb_W8t3VkpejPSNWyrkiT5fGLdTc4V6mi3uvS7Ej7k,24830\r\ntwisted/python/_textattributes.py,sha256=5HDokoRNMdRKmmKh1yrdymoOE7qTWkeNPOm8tOUePx8,9079\r\ntwisted/python/_tzhelper.py,sha256=YFN_nX1P-QvHzMUKKXcA9eQsUf2n9MHYr2lIecLqy70,3192\r\ntwisted/python/_url.py,sha256=7-vSoeXo3oMd6xDG3GvsDb7BXpRx8tnAc6HpPUk9zLQ,253\r\ntwisted/python/compat.py,sha256=NJEtYTaa_LA3j85-TkfyusjkRgk28CqpBy_3aDCvI0k,22907\r\ntwisted/python/components.py,sha256=jf9hOzQqetZfpDgBMELxCPdM6S8ALQYpBV-a2rVK4uc,14242\r\ntwisted/python/constants.py,sha256=GuTBebugkgjf4CkvJaOxy3GLYrV72Ftz_IFexC6dn2Y,544\r\ntwisted/python/context.py,sha256=2mPa-VtpamaSkfz5433svgisrVaT7mKPhQVgQ1i0SZY,4024\r\ntwisted/python/deprecate.py,sha256=EfkGx7d9K0st0vrsiNcvOIaD5_C2fQa8aWZbBCCloXI,26948\r\ntwisted/python/failure.py,sha256=2KBV5GN7gy-umIdziF1Mri_JCLlr6sL9fzx7Exp13i4,27564\r\ntwisted/python/fakepwd.py,sha256=26yDkt13tXXNTGv2Ua3qQ2t_0FJy0sesVge86O8ulAc,6138\r\ntwisted/python/filepath.py,sha256=rtd9HVtB_NZOWq3K2iZpaCw6_R-mjVlouVV6WylGljw,58887\r\ntwisted/python/formmethod.py,sha256=xpgE8EVYQQ_bgWySJp74ZT4ecY1SBL1hY4t5Oz_pDLg,11460\r\ntwisted/python/htmlizer.py,sha256=x91-QwzLlcF8Zfw3vG8NzzCabm7SF4m8EARO1v9llDI,3541\r\ntwisted/python/lockfile.py,sha256=ZgEOdSPnK3RFXTPz9cuvieQrp2uNvGV2bow8qiqSLmE,7718\r\ntwisted/python/log.py,sha256=etGKoolsiXr__IGZN9SG8YMd-JS3hMFIpphvvIRfNak,22472\r\ntwisted/python/logfile.py,sha256=TNbhiOp692oNKnQ9SCBz3oJAlfgbIYk1R6cnYFEYWRY,10083\r\ntwisted/python/modules.py,sha256=Zret5tlILxKbI05x4Rw_b0Qw0pBxcYIMn0ssSGQLaAs,27141\r\ntwisted/python/monkey.py,sha256=dTtT6kIz1vvSmIOUKOGGGlRAmpWS9UCzRGyc09hZHmE,2227\r\ntwisted/python/procutils.py,sha256=lkI5rWeD1iNyKsp9_L0XI8Lm3I4o7W6AzsiwdoFfLDU,1419\r\ntwisted/python/randbytes.py,sha256=dpPatxms22rgQwoLzuPYGWbWJc1ogVOyUrB_eAW1Fjs,3959\r\ntwisted/python/rebuild.py,sha256=9ro6DKmvmfQzMs7RKn3Tho2kL1pjmyyAwI1Rpm8mb2k,9268\r\ntwisted/python/reflect.py,sha256=ul_gpPzj1JhozrflHEW4UdRwysBtUd_N1fjSn8Wsn84,19477\r\ntwisted/python/release.py,sha256=fOCKs0fEKqLZduuDuBijZ0MDIkGEWliJApxEaAYlkEk,1192\r\ntwisted/python/roots.py,sha256=P98gPe16GCettjsnJCNPKAyeBJTyJOkvIKDx1-JMRu4,7404\r\ntwisted/python/runtime.py,sha256=XnzEnaDzX01aFGd-T-hw7sqP_yh30m56ttPALWNB9Fo,6216\r\ntwisted/python/sendmsg.py,sha256=V9Sxc2I2OI6iXS9Fy1GYR__nH8MiWEkLcxlhO6B3m24,3420\r\ntwisted/python/shortcut.py,sha256=HIlHg7G7u9jMhC09DrLPOv8zNnvF4wkz2AjBL-GKrn8,2253\r\ntwisted/python/syslog.py,sha256=Cu67zZN15N21NESUvs9RFQ4yQTdTzzn0ZTikKEhVDjA,3730\r\ntwisted/python/systemd.py,sha256=onsuaC2aPtrUS3DNeHMdoclD3v79vcm4jFmDU_pqBGE,2834\r\ntwisted/python/test/__init__.py,sha256=V0srj7fq1Y17ZVfFgUc0n5ueVkK0InJNIT90pWlEKLI,42\r\ntwisted/python/test/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/python/test/__pycache__/deprecatedattributes.cpython-36.pyc,,\r\ntwisted/python/test/__pycache__/modules_helpers.cpython-36.pyc,,\r\ntwisted/python/test/__pycache__/pullpipe.cpython-36.pyc,,\r\ntwisted/python/test/__pycache__/test_appdirs.cpython-36.pyc,,\r\ntwisted/python/test/__pycache__/test_components.cpython-36.pyc,,\r\ntwisted/python/test/__pycache__/test_constants.cpython-36.pyc,,\r\ntwisted/python/test/__pycache__/test_deprecate.cpython-36.pyc,,\r\ntwisted/python/test/__pycache__/test_dist3.cpython-36.pyc,,\r\ntwisted/python/test/__pycache__/test_fakepwd.cpython-36.pyc,,\r\ntwisted/python/test/__pycache__/test_htmlizer.cpython-36.pyc,,\r\ntwisted/python/test/__pycache__/test_inotify.cpython-36.pyc,,\r\ntwisted/python/test/__pycache__/test_release.cpython-36.pyc,,\r\ntwisted/python/test/__pycache__/test_runtime.cpython-36.pyc,,\r\ntwisted/python/test/__pycache__/test_sendmsg.cpython-36.pyc,,\r\ntwisted/python/test/__pycache__/test_setup.cpython-36.pyc,,\r\ntwisted/python/test/__pycache__/test_shellcomp.cpython-36.pyc,,\r\ntwisted/python/test/__pycache__/test_syslog.cpython-36.pyc,,\r\ntwisted/python/test/__pycache__/test_systemd.cpython-36.pyc,,\r\ntwisted/python/test/__pycache__/test_textattributes.cpython-36.pyc,,\r\ntwisted/python/test/__pycache__/test_tzhelper.cpython-36.pyc,,\r\ntwisted/python/test/__pycache__/test_url.cpython-36.pyc,,\r\ntwisted/python/test/__pycache__/test_urlpath.cpython-36.pyc,,\r\ntwisted/python/test/__pycache__/test_util.cpython-36.pyc,,\r\ntwisted/python/test/__pycache__/test_versions.cpython-36.pyc,,\r\ntwisted/python/test/__pycache__/test_zippath.cpython-36.pyc,,\r\ntwisted/python/test/__pycache__/test_zipstream.cpython-36.pyc,,\r\ntwisted/python/test/_deprecatetests.py.3only,sha256=qSX82XTcTBq4SpzmvjFlf-fK64geLp0spny-mRM_Kms,1814\r\ntwisted/python/test/deprecatedattributes.py,sha256=oTFSMS8Xi6q4JUgh5nUlBsmH3WrPkANJcKkI8plLJ94,571\r\ntwisted/python/test/modules_helpers.py,sha256=Ugs47h2kBaWydzLUHEYJx5lBf2a4vvpZuPAU3qaH4Sc,1605\r\ntwisted/python/test/pullpipe.py,sha256=hyX-tJuVuAo3QK76Q4Z0-Ots3Jo8ia3-9HWUPexlnuM,1220\r\ntwisted/python/test/test_appdirs.py,sha256=IpWQQKEiFNFnZahLWJZvHmM3dr1RKA_JERpbNLh3wLY,1081\r\ntwisted/python/test/test_components.py,sha256=HNKATjfPnL5lIxVS1wCBGTIb4NYFPkZzo05xNpJLRY8,25974\r\ntwisted/python/test/test_constants.py,sha256=_k490Ijg6HpYx_jHTjSedSD555Ujz0FHbrvLV1xNuYs,38117\r\ntwisted/python/test/test_deprecate.py,sha256=_xNUpOwd8TAbTC39m_wVEmQrSU3DaBfDoyVb40RLoDY,38930\r\ntwisted/python/test/test_dist3.py,sha256=QoIwlgUmeEtwcfbp2BLpqIiqub97v2fAHLw77BEYKbE,1858\r\ntwisted/python/test/test_fakepwd.py,sha256=2ulp3433yk5zIYcmb96ZUd2VXc8X-Q07xGdC54_OLyQ,14107\r\ntwisted/python/test/test_htmlizer.py,sha256=mA0YLFeplomK31oADOCo8-woa8ALbgfEu1FVLGSmLGw,1266\r\ntwisted/python/test/test_inotify.py,sha256=TPSjt9OPRp4hyEk05ZUl4281yuUI_etJ5LETjEMXz6s,3639\r\ntwisted/python/test/test_release.py,sha256=sLrfF-SJYRnjwiwGtbBVICaRniIh8Q_7TB612gPm9wg,41046\r\ntwisted/python/test/test_runtime.py,sha256=W3p_U-4eBEWYb2pQPfFEelUoHP-j9H-whEYbvgZtRKo,7926\r\ntwisted/python/test/test_sendmsg.py,sha256=gmm-zG0rRwfTuy8ozGJ7xeBhDSCJezjyAHyf8djNm1s,25233\r\ntwisted/python/test/test_setup.py,sha256=EXT8DjgyTqS5_ecN150HzZi7eMGJQHLCihwwxbzA6cE,13699\r\ntwisted/python/test/test_shellcomp.py,sha256=6mHTIncdngMe5Nm42x9_oXH-H-O4BO7g3QzwdiwHQ18,21809\r\ntwisted/python/test/test_syslog.py,sha256=2f2Ik8tLD89X905NtsKczHQNw4ssMd9sDmwpI5WTZEA,4948\r\ntwisted/python/test/test_systemd.py,sha256=lC5l4suhb6cQGnXlcxUyx5ZR7MUAAq0Zrci-f9pneCs,6401\r\ntwisted/python/test/test_textattributes.py,sha256=3tIa0LITcWGQraaeuu1S3Ai1v8rnGiNnRYnpRuDvBUE,712\r\ntwisted/python/test/test_tzhelper.py,sha256=qbJVrzd42-2SmiGTXBbDYbLLuSD1i1F4IkbLuT2X124,3984\r\ntwisted/python/test/test_url.py,sha256=mwDdEvACowrPyxYNPqCR_b32s93sN7DzvpR73SqEMZM,29313\r\ntwisted/python/test/test_urlpath.py,sha256=j7qCw-4PNgHeoYmIplna8zzt5EvrnluRFH8wf0d14Gs,10328\r\ntwisted/python/test/test_util.py,sha256=x5clz1UK59zQ1pETP-mKj5L2S8WUYRUjnieY1q-jl6k,36460\r\ntwisted/python/test/test_versions.py,sha256=xCTFjXPc8r6DujRCDzavd9qkzL1hwzcxwyDcT5fOAS8,5400\r\ntwisted/python/test/test_zippath.py,sha256=LRDWmsm8shSxYiw2QOs4NFjXFef1hsCUIzxmOhCn0f0,3474\r\ntwisted/python/test/test_zipstream.py,sha256=ai-XdQAlvQ6uUAmm5ikIjIpj7WU4KhWTj50tgbN_lRg,12308\r\ntwisted/python/text.py,sha256=bI7CKqBudIqueU7lduVKsQqzTZipPdSoZoa0lR9IklI,5482\r\ntwisted/python/threadable.py,sha256=yx-911e3S7loq9svlCLbqrFtLbATJd-IrXtFyC1FzKI,3297\r\ntwisted/python/threadpool.py,sha256=SfnPhHyfbfzB8IBu2p_qyHbA5PKqfEesMhNBKqz0ctQ,9840\r\ntwisted/python/twisted-completion.zsh,sha256=DkNZis_hXXFAxUutigSn6gDRk8i70ylRrJ7ZBy-8NZo,1371\r\ntwisted/python/url.py,sha256=0vJfs6hgMrWkIR2ZgovyPASQlYHh2afVCFaQaGSLA2c,244\r\ntwisted/python/urlpath.py,sha256=GV2oT4B_QwtKVOfKjOZC5J_bIxVzblHGtP7-2aCqxXk,9084\r\ntwisted/python/usage.py,sha256=PmukwnG15RZjJwCwX4Z5moDUShWKwBVHwj1jocLVDZY,35002\r\ntwisted/python/util.py,sha256=4Pz0IZzKDqY9UFwqb-RU4HJoCUgrAO_h2-sLBMNR58o,27931\r\ntwisted/python/versions.py,sha256=VV-6OHSdnxuUPrfZ0tfb1kIxwU_nIIUA8Isedy1wYxc,322\r\ntwisted/python/win32.py,sha256=i2e7daTFnZVYWpmGjlPBH97IsXQKm5kiwX7Zy1vY2S4,4317\r\ntwisted/python/zippath.py,sha256=3iNAMvf_shM4KMaIHttR5HsBawMmHJy_h1z0emsvGPQ,9237\r\ntwisted/python/zipstream.py,sha256=yZb1fdWj1YHXrK9_sG4auyiQbZYrZsf2tsbTE65fT08,9757\r\ntwisted/runner/__init__.py,sha256=ahzGC9cYnSf0DSsEzBgV1oK-AyD_jb3jvVfEZA6mJZ0,124\r\ntwisted/runner/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/runner/__pycache__/inetd.cpython-36.pyc,,\r\ntwisted/runner/__pycache__/inetdconf.cpython-36.pyc,,\r\ntwisted/runner/__pycache__/inetdtap.cpython-36.pyc,,\r\ntwisted/runner/__pycache__/procmon.cpython-36.pyc,,\r\ntwisted/runner/__pycache__/procmontap.cpython-36.pyc,,\r\ntwisted/runner/inetd.py,sha256=EHkgH-8dYHD75CUaby9dkui4zGFToR6HhOpOxd5c7os,1962\r\ntwisted/runner/inetdconf.py,sha256=hHz7QpqQGJtg5YQ2KRj_IdmfmasiYnvw4ZXK4nRy98w,4917\r\ntwisted/runner/inetdtap.py,sha256=3EfntNfqiEBApmNjyXv10v9DZ0u4pk8EUbaf2hPEbX8,3558\r\ntwisted/runner/procmon.py,sha256=e7Rr8ANff3jDDirWYHQxTGm_F5sH24eKQBRZRulrkjg,12675\r\ntwisted/runner/procmontap.py,sha256=3S6LdXV2qIzUrWyNvHlk8ZMpc2Pri79PXjBIB0p6oEw,2298\r\ntwisted/runner/test/__init__.py,sha256=tjveH1kCFEM9rVaT_bsWV8TURsUKAgqn9p3zHZdDK40,114\r\ntwisted/runner/test/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/runner/test/__pycache__/test_inetdconf.cpython-36.pyc,,\r\ntwisted/runner/test/__pycache__/test_procmon.cpython-36.pyc,,\r\ntwisted/runner/test/__pycache__/test_procmontap.cpython-36.pyc,,\r\ntwisted/runner/test/test_inetdconf.py,sha256=r-HcBqvSvDbqcyc6viHoBdCfLrP0Pqm-ptALYU-kjFU,1785\r\ntwisted/runner/test/test_procmon.py,sha256=juFE0_OW7YLTIr9Ohe35EK84T7NVB0NXGrz4UsuqWNg,23346\r\ntwisted/runner/test/test_procmontap.py,sha256=f237F_JUHlqJQ0IDXoVBB9C_Qu2FZHJGTGOduSXWyNM,2520\r\ntwisted/scripts/__init__.py,sha256=TSubMCp4NhcXtFvbrOT9boiIzXpbSvATakl3yGBQwQY,261\r\ntwisted/scripts/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/scripts/__pycache__/_twistd_unix.cpython-36.pyc,,\r\ntwisted/scripts/__pycache__/_twistw.cpython-36.pyc,,\r\ntwisted/scripts/__pycache__/htmlizer.cpython-36.pyc,,\r\ntwisted/scripts/__pycache__/trial.cpython-36.pyc,,\r\ntwisted/scripts/__pycache__/twistd.cpython-36.pyc,,\r\ntwisted/scripts/_twistd_unix.py,sha256=oxV8dzXcxZe-kwzQLUoBT9TFrOSUmnJnaQvqh0ZL0q4,16380\r\ntwisted/scripts/_twistw.py,sha256=DR_MP8Ij2fqlYNTACS384RPuNHdOdIhrHsO0mDfUJG0,1562\r\ntwisted/scripts/htmlizer.py,sha256=HSlaUZZ5O7Lxnay2tNm-eFq6sqh7pKhvysixJdyGY_s,1868\r\ntwisted/scripts/test/__init__.py,sha256=p8A4Q5FXoU8Mch55_ANwPbv5-vTZikEVox_gvZELTHg,118\r\ntwisted/scripts/test/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/scripts/test/__pycache__/test_scripts.cpython-36.pyc,,\r\ntwisted/scripts/test/test_scripts.py,sha256=zsK4xm834A3KBsx6qUlbjfNWOiqw4iK1AmY4Ktf7dzg,4880\r\ntwisted/scripts/trial.py,sha256=vlKgrnUIuBmmMB5uAQjv1MYUARKc5EF54bVfQ-XDggY,21132\r\ntwisted/scripts/twistd.py,sha256=1UX9uFucre3pMc5VqLD-QrIfNbLgkF8FQ_Swr0D2wn4,867\r\ntwisted/spread/__init__.py,sha256=gfxmcnrYlpVRF5hdBZ3WUCItFEAc6DNSQw6D8e_f3RE,159\r\ntwisted/spread/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/spread/__pycache__/banana.cpython-36.pyc,,\r\ntwisted/spread/__pycache__/flavors.cpython-36.pyc,,\r\ntwisted/spread/__pycache__/interfaces.cpython-36.pyc,,\r\ntwisted/spread/__pycache__/jelly.cpython-36.pyc,,\r\ntwisted/spread/__pycache__/pb.cpython-36.pyc,,\r\ntwisted/spread/__pycache__/publish.cpython-36.pyc,,\r\ntwisted/spread/__pycache__/util.cpython-36.pyc,,\r\ntwisted/spread/banana.py,sha256=ofAgyONvTiJ5H5AaGhLxK8mnAo-6u7sgo00KqwMrxGY,12334\r\ntwisted/spread/flavors.py,sha256=n2_9c16yhkbpDAk6SkbN6UBVmmQ4_QU2YeUkIW_WgAQ,23455\r\ntwisted/spread/interfaces.py,sha256=A7UjlK03QoQ5KnPMUkvlpSnYqe5pdt7hUKv6MTLWa30,686\r\ntwisted/spread/jelly.py,sha256=aCq16IuReZ7btYNcO2zBGHZwfUDqWJ3YY0AEdmPVMwU,36468\r\ntwisted/spread/pb.py,sha256=BUR4Cf3snqevg95aH3yri__uN1cda5K2WNGeman8ZoU,52385\r\ntwisted/spread/publish.py,sha256=G4n2VvafpTtx7S8eEZtHC8s6naDBdwmLWNG4itifat8,4480\r\ntwisted/spread/test/__init__.py,sha256=67HyXbsJ4DIBtcMcUWJqGMHdQc2Z-NLinUz2MVUEplI,110\r\ntwisted/spread/test/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/spread/test/__pycache__/test_banana.cpython-36.pyc,,\r\ntwisted/spread/test/__pycache__/test_jelly.cpython-36.pyc,,\r\ntwisted/spread/test/__pycache__/test_pb.cpython-36.pyc,,\r\ntwisted/spread/test/__pycache__/test_pbfailure.cpython-36.pyc,,\r\ntwisted/spread/test/test_banana.py,sha256=wV0I1JtZvg1VJZEZVPvfFEUQYSNS2eL-irtqarZyb_k,15456\r\ntwisted/spread/test/test_jelly.py,sha256=tVs3Ph0cGjO6lU9uqqe6qHTVASoUuPhi5N2Oa1FwFP8,19990\r\ntwisted/spread/test/test_pb.py,sha256=dy7mom3-TD89U_qz2NdnC1RTfwBwA4glz4QwvXxniuw,63874\r\ntwisted/spread/test/test_pbfailure.py,sha256=292uqxxnW0nLSWfubBnW3INJWksGImoECepvAC_h554,15433\r\ntwisted/spread/util.py,sha256=OWm_8dRgzKEvGVWxutxhdWOkupoc1sLj0FSuwX8JW1w,6387\r\ntwisted/tap/__init__.py,sha256=cWvA7ICrsBPoK11cax2E9a3OhvuDMYXRBvj_7tKXMDI,162\r\ntwisted/tap/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/tap/__pycache__/ftp.cpython-36.pyc,,\r\ntwisted/tap/__pycache__/portforward.cpython-36.pyc,,\r\ntwisted/tap/__pycache__/socks.cpython-36.pyc,,\r\ntwisted/tap/ftp.py,sha256=JmF1-GN5eoEYen773DBg0_-hSyHnFE94q1XrsG1Lz9Y,2002\r\ntwisted/tap/portforward.py,sha256=ZMY42wPvX5yfi1A3Ug_XLEOM7F5-UWhgzq2nY2WVNa8,795\r\ntwisted/tap/socks.py,sha256=uF0OnqGl16jcW6vtT7BvRImqsxSZPeJ8GPnUCoKghrc,1292\r\ntwisted/test/__init__.py,sha256=P8kgU78nKls3dRPDEW7-PYoYrm2J_hYMiYB6eJUHNbI,477\r\ntwisted/test/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/test/__pycache__/crash_test_dummy.cpython-36.pyc,,\r\ntwisted/test/__pycache__/iosim.cpython-36.pyc,,\r\ntwisted/test/__pycache__/mock_win32process.cpython-36.pyc,,\r\ntwisted/test/__pycache__/myrebuilder1.cpython-36.pyc,,\r\ntwisted/test/__pycache__/myrebuilder2.cpython-36.pyc,,\r\ntwisted/test/__pycache__/plugin_basic.cpython-36.pyc,,\r\ntwisted/test/__pycache__/plugin_extra1.cpython-36.pyc,,\r\ntwisted/test/__pycache__/plugin_extra2.cpython-36.pyc,,\r\ntwisted/test/__pycache__/process_cmdline.cpython-36.pyc,,\r\ntwisted/test/__pycache__/process_echoer.cpython-36.pyc,,\r\ntwisted/test/__pycache__/process_fds.cpython-36.pyc,,\r\ntwisted/test/__pycache__/process_getargv.cpython-36.pyc,,\r\ntwisted/test/__pycache__/process_getenv.cpython-36.pyc,,\r\ntwisted/test/__pycache__/process_linger.cpython-36.pyc,,\r\ntwisted/test/__pycache__/process_reader.cpython-36.pyc,,\r\ntwisted/test/__pycache__/process_signal.cpython-36.pyc,,\r\ntwisted/test/__pycache__/process_stdinreader.cpython-36.pyc,,\r\ntwisted/test/__pycache__/process_tester.cpython-36.pyc,,\r\ntwisted/test/__pycache__/process_tty.cpython-36.pyc,,\r\ntwisted/test/__pycache__/process_twisted.cpython-36.pyc,,\r\ntwisted/test/__pycache__/proto_helpers.cpython-36.pyc,,\r\ntwisted/test/__pycache__/reflect_helper_IE.cpython-36.pyc,,\r\ntwisted/test/__pycache__/reflect_helper_VE.cpython-36.pyc,,\r\ntwisted/test/__pycache__/reflect_helper_ZDE.cpython-36.pyc,,\r\ntwisted/test/__pycache__/ssl_helpers.cpython-36.pyc,,\r\ntwisted/test/__pycache__/stdio_test_consumer.cpython-36.pyc,,\r\ntwisted/test/__pycache__/stdio_test_halfclose.cpython-36.pyc,,\r\ntwisted/test/__pycache__/stdio_test_hostpeer.cpython-36.pyc,,\r\ntwisted/test/__pycache__/stdio_test_lastwrite.cpython-36.pyc,,\r\ntwisted/test/__pycache__/stdio_test_loseconn.cpython-36.pyc,,\r\ntwisted/test/__pycache__/stdio_test_producer.cpython-36.pyc,,\r\ntwisted/test/__pycache__/stdio_test_write.cpython-36.pyc,,\r\ntwisted/test/__pycache__/stdio_test_writeseq.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_abstract.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_adbapi.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_amp.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_application.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_compat.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_context.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_cooperator.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_defer.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_defgen.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_dict.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_dirdbm.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_error.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_factories.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_failure.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_fdesc.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_finger.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_formmethod.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_ftp.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_ftp_options.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_htb.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_ident.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_internet.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_iosim.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_iutils.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_lockfile.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_log.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_logfile.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_loopback.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_main.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_memcache.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_modules.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_monkey.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_nooldstyle.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_paths.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_pcp.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_persisted.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_plugin.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_policies.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_postfix.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_process.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_protocols.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_randbytes.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_rebuild.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_reflect.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_roots.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_shortcut.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_sip.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_sob.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_socks.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_ssl.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_sslverify.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_stateful.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_stdio.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_strerror.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_strports.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_task.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_tcp.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_tcp_internals.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_text.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_threadable.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_threadpool.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_threads.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_tpfile.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_twistd.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_twisted.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_udp.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_unix.cpython-36.pyc,,\r\ntwisted/test/__pycache__/test_usage.cpython-36.pyc,,\r\ntwisted/test/__pycache__/testutils.cpython-36.pyc,,\r\ntwisted/test/cert.pem.no_trailing_newline,sha256=zo_jqLPMFx4ihV8QxkdwD-_wT9WIC-zRDZcH23okXgk,1414\r\ntwisted/test/crash_test_dummy.py,sha256=e_KrrGBFmaXSLCLxq59VklPym1tY8UvzcCqZ-6xHzWU,543\r\ntwisted/test/iosim.py,sha256=HTAEcEPxQePmaPoMqBKBs4nS_J062aEyyKvOKax44II,17843\r\ntwisted/test/key.pem.no_trailing_newline,sha256=6ChUJWC8C3KXcoX1BBidlFOglMqHtYS-ul9cr6UMiHk,1707\r\ntwisted/test/mock_win32process.py,sha256=EeeQqdYC2ka1pqW10xDOblWBBuYGuIZc4OSIBRY9Czk,1499\r\ntwisted/test/myrebuilder1.py,sha256=IIZN_g1GPNIFVon6tbvPJmIHId7okkkY6P3QWQxKc1E,158\r\ntwisted/test/myrebuilder2.py,sha256=jCXJikyxA9P65EeQBypSXO5EPvPJ6tFhSfG2tuleLQI,158\r\ntwisted/test/plugin_basic.py,sha256=8xNGvfT0iGqQJoQlXNgV5MZBPh7kckLiCa75WOLPmZY,943\r\ntwisted/test/plugin_extra1.py,sha256=OfoMucKmCvgMRHL3YLhwU_Xi2CL4f862-44Au-SHe7c,407\r\ntwisted/test/plugin_extra2.py,sha256=EznTfuePvwBnCDi6eeth5bbUe41eS-LjLYmy516ynRU,579\r\ntwisted/test/process_cmdline.py,sha256=BimXPJAOrI7p6yeI__pflO_Jalk5y6tlgr-n2zgkaDo,162\r\ntwisted/test/process_echoer.py,sha256=USXd05oAkfmRKITVYXjpQ9lFouVEQbyA_a9mudWELpU,214\r\ntwisted/test/process_fds.py,sha256=id3GJEGB_uv9AmOPIC-yGvLehIRQDKrTEn5UDq_VSx4,945\r\ntwisted/test/process_getargv.py,sha256=WYk6DVL_Zviy160-eNWq263-i4nXAJpezsjpxBbDpUE,283\r\ntwisted/test/process_getenv.py,sha256=3micUPcws3OHsrbz6FvudJmAULuL7QxZQaPQL3yBddA,268\r\ntwisted/test/process_linger.py,sha256=g151drgjRfbI61dKYG0KYi8F8HxXRE3muWxBuzGVp4Q,286\r\ntwisted/test/process_reader.py,sha256=UbbRXJzTl8c6e_lGvFFlGsobtZUxkZovHPTUbfowDjg,188\r\ntwisted/test/process_signal.py,sha256=3HFQ8y72n9abUQHG0m_VuHddGePPgmZbjbCkkIbCpVc,214\r\ntwisted/test/process_stdinreader.py,sha256=2SQ9WN-X_qZPBc65dUBWEHVl1TtK_vOTKGzfbMwaRa4,857\r\ntwisted/test/process_tester.py,sha256=ahvvBnJv2a0z2X4FRXRkiYVrtgaWlotD2OaHHzAgR5I,1035\r\ntwisted/test/process_tty.py,sha256=hLLXgrwy_SF-dq2_moeGQSnpRJwyjgVMW7_z9ejXXvQ,130\r\ntwisted/test/process_twisted.py,sha256=MwDbDERsvFxRFkkuL48g-VJPVkUqI6GKl4skYpy14hg,1206\r\ntwisted/test/proto_helpers.py,sha256=O8Nwlhyg-0o7YmWyGk_0acecBlfbDAYjgXA3IB9CeAs,1009\r\ntwisted/test/raiser.cpython-36m-x86_64-linux-gnu.so,sha256=kLerOiQ3s3gyR_0He4TwA10Et2QImqI--T0CLU4r9OU,99619\r\ntwisted/test/reflect_helper_IE.py,sha256=D7N7dob70tx6BCuf2mTOVON-9iclUwWtKUTfvsU3F3M,61\r\ntwisted/test/reflect_helper_VE.py,sha256=VLu_9ughD3FOfYWMKw6N521vzp6YErR-d5IGnvVINzk,82\r\ntwisted/test/reflect_helper_ZDE.py,sha256=6eJjOrxytcz6G1a-NT3rz5fpIyof7ejuk4ZqxkXTAR0,47\r\ntwisted/test/server.pem,sha256=bAB7jzd2KxoBpd5VYhzgdmuPDKH9_XV_su2nNq6-xlI,4444\r\ntwisted/test/ssl_helpers.py,sha256=ZXyuxzyOz3eoedcTplun835Gru7UI1hj_tsZGGjHH5w,1032\r\ntwisted/test/stdio_test_consumer.py,sha256=UcpBNu9jRBjjplwDMFBvISaKV1G-MoZGpmdEN3y-AB0,1216\r\ntwisted/test/stdio_test_halfclose.py,sha256=1ULDASakPelEWZTmTEiGP_2yoqADEh_uO3NAtvf9f3w,1938\r\ntwisted/test/stdio_test_hostpeer.py,sha256=S4iym1eUrhSTI9q0_NyNFsU2vOt73kM80wQXAZPYiKc,1021\r\ntwisted/test/stdio_test_lastwrite.py,sha256=ja24d-ofVHcBwS-zQfZhepBu2DEMY10ESGNOc7NPiG0,1206\r\ntwisted/test/stdio_test_loseconn.py,sha256=4MuY6FhUQjVUOxJ-Da_oz87uAESTA2eqpOFjz36PbY8,1548\r\ntwisted/test/stdio_test_producer.py,sha256=OChDgtN-lKe4wv5afQiUngvvzJN-5ovdkNwDfsSooEQ,1507\r\ntwisted/test/stdio_test_write.py,sha256=ZzHl8uDvAuN987XKwHeU7huFJeUhkH2m7llj0_lb1TM,923\r\ntwisted/test/stdio_test_writeseq.py,sha256=KjDrpNrGdy6Ao66bUHuRlxk4r1hUxbf9z-q_YQPrrJQ,915\r\ntwisted/test/test_abstract.py,sha256=u1sJ3MqObQNQirOIL9KBdEK5GmHY-hfoX9MaaNbG7JQ,3497\r\ntwisted/test/test_adbapi.py,sha256=YZY7rTrIeImJlW852LbG19mMR_gPHq0gJyOCqBhh618,26148\r\ntwisted/test/test_amp.py,sha256=YsKFvd1aaugyD_lBDG0w6IPnDCKDjtcNPFO7YNmNBck,110553\r\ntwisted/test/test_application.py,sha256=vjgnjo4Q-IQ8NPZT8DH_hgyT2m0nrniw4nLEMpe4DOI,34210\r\ntwisted/test/test_compat.py,sha256=GKXSsM1F11qkVT0pPM6CPfVc1fugOMCUSB9EuBG0PJk,28527\r\ntwisted/test/test_context.py,sha256=zsV4fhj0VCrTLbzhjOdcr2gxG3kAOYCOwRjUvIs1ap4,1515\r\ntwisted/test/test_cooperator.py,sha256=vW_NFZ5arXXHquIBUeBwqUqb8cpLUP6ftFoDi6G-EXQ,21467\r\ntwisted/test/test_defer.py,sha256=3mNCERZAqGEP63g3dlCzJ4RGc-A2bD48zRaIM6_uyi8,104143\r\ntwisted/test/test_defer.py.3only,sha256=VUYRAxF1fFS6HBFPEmgQJF5cbF0T7hXMyuZI6ZOXqLM,2500\r\ntwisted/test/test_defgen.py,sha256=FcjjeYL5N9BbAnSf0rgTD36dN-zKTq2SR3pTKfBlBr0,10701\r\ntwisted/test/test_dict.py,sha256=GCmGM7c6XlVwIsQpkPJxeAW_Nyjy_kR2C6TsqXVruCU,1442\r\ntwisted/test/test_dirdbm.py,sha256=cPN4kXEgtG20KChbnVDwGfrRUCEiuvp8fSxY8UfBTM4,6695\r\ntwisted/test/test_error.py,sha256=3qPMbLZfUo_qvJx3E0m6mbXx-DYE_uP9mhkapMDix8g,8593\r\ntwisted/test/test_factories.py,sha256=i_dbiMVIhvx7f47BQK9I_Y8vdloV-9k33-0h2iX3uQ8,4637\r\ntwisted/test/test_failure.py,sha256=5G91yYuoSJ4-pwQlPTQIF3yMowcr7XFKFmSGA1vN09Q,32814\r\ntwisted/test/test_fdesc.py,sha256=DDqHNCrc5Q_gnDLyqGKI_ReNFjR1Qv79GQLjaWysIO0,7371\r\ntwisted/test/test_finger.py,sha256=lE5o_NacakzRCt5yYkCh-z_SktcXwK4FXhI5GXg9E0s,1997\r\ntwisted/test/test_formmethod.py,sha256=9aSzdUJSAzdrUhYGe-cf7nvDPU1L3JZCDIpYlSlrjjA,3645\r\ntwisted/test/test_ftp.py,sha256=Dmre2zNP4odYzKmK6KPzutLsv3T8zVS40eKmBkXvA80,130321\r\ntwisted/test/test_ftp_options.py,sha256=eGD8-ot2TGhcMTeP79EGhpmo-HfxmH3by_KzopdHNDw,2685\r\ntwisted/test/test_htb.py,sha256=nT0xU1fTt5TawiOd53Q7mQOkbSybNXa5Hdud74KO-bs,3190\r\ntwisted/test/test_ident.py,sha256=27hHDLdWQjZj_3511PpJ9jk-GKK8gRUOtmCzRLNMspw,7015\r\ntwisted/test/test_internet.py,sha256=WBPCf4NPaNWtDB9fIJ6Efwlel8QIn5DDC4BeBc2k3D0,46803\r\ntwisted/test/test_iosim.py,sha256=ZaDyIAoVKKjmmpZCugfrT6sKp0lVcgIrfGxqjvpqHL8,9060\r\ntwisted/test/test_iutils.py,sha256=Kv3t0iIi9u9fgzluaU2SVxVPGCQbcp3gwQfpkai0Spk,14384\r\ntwisted/test/test_lockfile.py,sha256=PsCJl1pA0K-aA-SIwW_i7VyN-43xTfxtmcmkPqDNQ3k,15506\r\ntwisted/test/test_log.py,sha256=0rlzX1ua_ZSqfDNsHc2tih12QZxsodgG4Ht4ELNpLzQ,36330\r\ntwisted/test/test_logfile.py,sha256=MPFH14kANpfxPbokwn9sZU4bK984kR6D1anoFJy_r58,18227\r\ntwisted/test/test_loopback.py,sha256=PTSDXS5TFz6L1GEkdXLWBHRrp3CJ0ds2WDodMrLWtLE,14486\r\ntwisted/test/test_main.py,sha256=F3x8NqO0CxZvfnmm6H2-x5Z4UsLH0htWUe0nwO_v4Qk,2501\r\ntwisted/test/test_memcache.py,sha256=lTdDfwGIOUIYv3nWC4TOpuY2oZ8D3--d6Z78a-5Spb4,25143\r\ntwisted/test/test_modules.py,sha256=VWkroMXc5duBPTOTtJnHgJDFSHUBmK2TfaJwvfa7w88,17888\r\ntwisted/test/test_monkey.py,sha256=D37NHborDX663mPE3vnYQP2OA8Ey37YDpuHCuXu4Gu4,5637\r\ntwisted/test/test_nooldstyle.py,sha256=hwfH8G2l4KJrHqUCmH__iUjhoFW34aGVy_WOE2iXi5g,5955\r\ntwisted/test/test_paths.py,sha256=j_0l5igUqehcYqvFfBG9KU0ZZlQKnho36ysoBNHxv64,74357\r\ntwisted/test/test_pcp.py,sha256=k13lppisnl5WYCS5BD-kAbyUzM1CZBLxbQ0rG_S3a-M,12551\r\ntwisted/test/test_persisted.py,sha256=KHfsZlx2feaihD0Ja5KBq_-h56CQ2ilxWDQ32xq-JnA,14624\r\ntwisted/test/test_plugin.py,sha256=r20OZv-hMr9DjMyk9tJxDykMV_g1seLgyDfp3eVz6Ww,26113\r\ntwisted/test/test_policies.py,sha256=KtUlbJZRqmqOpQT4E20PHb3V_6gvBa45DzkFZEr3Hck,33499\r\ntwisted/test/test_postfix.py,sha256=CrDVuSkr18QQDVhJ5lCCy07Fy6RQjOaMffUKmno0nZM,4243\r\ntwisted/test/test_process.py,sha256=Y5ntI0AwGXEsxuiViOB8bdVIyyFLUO3Efw3O9fs4vJk,86120\r\ntwisted/test/test_protocols.py,sha256=ZIk1-7OhE-04Oytmr9-ScYWBi_PrsBDh-aUFiiUYqgY,7450\r\ntwisted/test/test_randbytes.py,sha256=MkUMH7zYTdJ4Ln8J9VJDLueHFcZ4HR1Qz2aNPVFHKnw,3357\r\ntwisted/test/test_rebuild.py,sha256=iscBE4IMkfOmEGkHlyjCZC8ioXjnwNi5kQwmf19eduk,8495\r\ntwisted/test/test_reflect.py,sha256=riIAjcwwIq4ZeM4rGZIaxuDFLkrKtqr315-xM-j7ANw,26085\r\ntwisted/test/test_roots.py,sha256=4TzR1qugGrfLdjwO34KO0SAweOxOMHqkJtMwkWtbmm4,1812\r\ntwisted/test/test_shortcut.py,sha256=NkA5ho-Rvhhu9Dj_JD5N6VZS4lzNWHInPe2J4Clv-L4,1991\r\ntwisted/test/test_sip.py,sha256=wFVIuH_XqHAGlenbvtswDjBFZpo3E4RnIRAxEel_AEI,25284\r\ntwisted/test/test_sob.py,sha256=ttrn_p7OpR2ikvTm8oNxgxrxnQ4xMdT7YdIc02egl58,5632\r\ntwisted/test/test_socks.py,sha256=ImzFJie1KZesqrTM1LyhhCSD_WLXB-_eRrWWpAzw31c,17738\r\ntwisted/test/test_ssl.py,sha256=kqOXu-IGJKW4HuCSdTs4U2rORO-P4SrGBby5stQfmOE,22923\r\ntwisted/test/test_sslverify.py,sha256=iAjE3Zo6FKDhCaRE_PiyIFwVOGbAJ58ZAQcvsSisAJY,116121\r\ntwisted/test/test_stateful.py,sha256=-X78ROUUyb5c6-jzJ4DIi_NYf0t8xmLegEOSqrQSxnE,2021\r\ntwisted/test/test_stdio.py,sha256=M7agWsEf2cC2tpHrtqXEVn9jQXIqYYzYEW2eQ5RoB5U,13156\r\ntwisted/test/test_strerror.py,sha256=4lT14E-7oGKDHpsAoJ4Es6WDPa9h6fK3FS92B51w3s8,5183\r\ntwisted/test/test_strports.py,sha256=oM-EGX3x5WWQIMTXYWUy7fgscvVuhoaoKdxCqHTgSLE,1797\r\ntwisted/test/test_task.py,sha256=-7MgKjHCcIclp6DmwOegRo-C5Ury2lF4i3W5xBJRbLA,39683\r\ntwisted/test/test_tcp.py,sha256=ywEI3OaF7iJfY4l7eA6ZYBuem-TIegIiF1yEg8Bpuak,66192\r\ntwisted/test/test_tcp_internals.py,sha256=DCBr5-a2W12EvX9gWBlf8vIGc8YEizQ1Uodcdu5tfqk,13255\r\ntwisted/test/test_text.py,sha256=ZDBTmtLnIGkYwL08uX0MJ4Xq-B1oPgt8rAzO1_FT62o,6456\r\ntwisted/test/test_threadable.py,sha256=85oUaY3J3Cg7Y-uvm6Wk4f5cQ-RhYi5SCLIbS8fb7ZQ,3738\r\ntwisted/test/test_threadpool.py,sha256=1qoaUY1zYLmeW4M0ZRRNfvzH0CUwAkdPjQ-5L_Q0lEk,22204\r\ntwisted/test/test_threads.py,sha256=bLzBn98GjVgBCylKpps1oLFwpJKaGV9Q_79_6jDT_uc,13268\r\ntwisted/test/test_tpfile.py,sha256=f3apHS3fbcoNspvqJ4d3Tljtv44lHU3FcWgJIoyy4Gk,1601\r\ntwisted/test/test_twistd.py,sha256=BYTWg5qB6NVwGjIkM6qWUd54U6pj308SVQPfAA1Pw_Y,74201\r\ntwisted/test/test_twisted.py,sha256=JFiWXtkK0Si6NLrh1i3iLLplxie2_zZNb6DHB-tmAjo,9214\r\ntwisted/test/test_udp.py,sha256=K6uHGFmp7pLUpIjmfjNNFtyiFQmNHyO6XVVO783b3zU,24992\r\ntwisted/test/test_unix.py,sha256=sxRkpz0NzS98bXy1ZlfN_p3J2GRk2BbLg8aGGLv5vnM,15157\r\ntwisted/test/test_usage.py,sha256=E3vSRYqzzUbjWg3CZW4bFYAK8eoAtiuUGdb9jJH9JeY,23645\r\ntwisted/test/testutils.py,sha256=VWozf8WzYsiwRA8LCR7jIaLyi9x0dE2HOHJaJQTmtwc,5321\r\ntwisted/trial/__init__.py,sha256=2ib2sy-amXD8irsLolFFjjeNur8BnaXwBWaOCASmsFU,2040\r\ntwisted/trial/__main__.py,sha256=noqg0SgiYqvgjWVTPJCyrxZDdpR-l1p666wuE4a5388,249\r\ntwisted/trial/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/trial/__pycache__/__main__.cpython-36.pyc,,\r\ntwisted/trial/__pycache__/_asyncrunner.cpython-36.pyc,,\r\ntwisted/trial/__pycache__/_asynctest.cpython-36.pyc,,\r\ntwisted/trial/__pycache__/_synctest.cpython-36.pyc,,\r\ntwisted/trial/__pycache__/itrial.cpython-36.pyc,,\r\ntwisted/trial/__pycache__/reporter.cpython-36.pyc,,\r\ntwisted/trial/__pycache__/runner.cpython-36.pyc,,\r\ntwisted/trial/__pycache__/unittest.cpython-36.pyc,,\r\ntwisted/trial/__pycache__/util.cpython-36.pyc,,\r\ntwisted/trial/_asyncrunner.py,sha256=oNL10LsWsYgfPDZhAzO9Hes-yKZa17M6PF-JyAFamuw,4530\r\ntwisted/trial/_asynctest.py,sha256=qUGroPSQz4SPywueE4vxXnk8JtkbwopGFqA6D1J9-UA,14634\r\ntwisted/trial/_dist/__init__.py,sha256=0v2hhp_DnNSlYu4-6rS6SzWwFTqcl_1DCqPrWxKdEXc,1941\r\ntwisted/trial/_dist/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/trial/_dist/__pycache__/distreporter.cpython-36.pyc,,\r\ntwisted/trial/_dist/__pycache__/disttrial.cpython-36.pyc,,\r\ntwisted/trial/_dist/__pycache__/managercommands.cpython-36.pyc,,\r\ntwisted/trial/_dist/__pycache__/options.cpython-36.pyc,,\r\ntwisted/trial/_dist/__pycache__/worker.cpython-36.pyc,,\r\ntwisted/trial/_dist/__pycache__/workercommands.cpython-36.pyc,,\r\ntwisted/trial/_dist/__pycache__/workerreporter.cpython-36.pyc,,\r\ntwisted/trial/_dist/__pycache__/workertrial.cpython-36.pyc,,\r\ntwisted/trial/_dist/distreporter.py,sha256=4oiCkv6AZOIfBfZt8qDKyKSERZtx5S7r9AA170DAeYU,2495\r\ntwisted/trial/_dist/disttrial.py,sha256=T-QHOl0r5MztVjVBbfCyGtERQQs1ixeLqkYjOvtSXEM,8711\r\ntwisted/trial/_dist/managercommands.py,sha256=FDoWQMJXMu1UIzYseCtS4t2A7yKyZFfEM_Zc3U9qs7E,1897\r\ntwisted/trial/_dist/options.py,sha256=7GLbC2y5zGM3IwimCBg7H26AOlwiPb2dkoebWQFezzE,739\r\ntwisted/trial/_dist/test/__init__.py,sha256=IOS3XedcenVmIEF2Dn-7IhLiGyeN1IG33V51Pk_iS7o,118\r\ntwisted/trial/_dist/test/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/trial/_dist/test/__pycache__/test_distreporter.cpython-36.pyc,,\r\ntwisted/trial/_dist/test/__pycache__/test_disttrial.cpython-36.pyc,,\r\ntwisted/trial/_dist/test/__pycache__/test_options.cpython-36.pyc,,\r\ntwisted/trial/_dist/test/__pycache__/test_worker.cpython-36.pyc,,\r\ntwisted/trial/_dist/test/__pycache__/test_workerreporter.cpython-36.pyc,,\r\ntwisted/trial/_dist/test/__pycache__/test_workertrial.cpython-36.pyc,,\r\ntwisted/trial/_dist/test/test_distreporter.py,sha256=wrXX0UllZZRgCAArA8gdKHipm9JLi0cFMzdgk_pn2DU,2051\r\ntwisted/trial/_dist/test/test_disttrial.py,sha256=aJ7-xg5Ew1uwyoFq5F0T_YMK5u-JfZfbdAdYGJE3a9M,16757\r\ntwisted/trial/_dist/test/test_options.py,sha256=8cMl8nKBeXvnfuRDwL6oTluwnbtJ3GR9HZl45YEiAyA,1312\r\ntwisted/trial/_dist/test/test_worker.py,sha256=Lu4I8xl0i3kgyrpBTinEAgxrpDBX43vRF9otsDrZH4c,14784\r\ntwisted/trial/_dist/test/test_workerreporter.py,sha256=lNGGrJoiWsu58wVMAY9lF6twFISQgMyoRh60HT9ww80,5390\r\ntwisted/trial/_dist/test/test_workertrial.py,sha256=StZMQYWknt0nVg2F4KaJ9ZPUNFX-JVh0-5uF6d1kHB0,5014\r\ntwisted/trial/_dist/worker.py,sha256=uuzghTilXOwfiNHjKkgYUppJNkqzo4_VBEqwKNIXkR8,9153\r\ntwisted/trial/_dist/workercommands.py,sha256=GerNCLGPNP8asXy22Cl8qAKQYJ9sKiXDo729Lc1AbbE,641\r\ntwisted/trial/_dist/workerreporter.py,sha256=ysGwtY-e6c_sSTR3IGhy7f8kqgqOQI46EnJysD2LJxk,4856\r\ntwisted/trial/_dist/workertrial.py,sha256=BQDJ2KHnHQ6MtPwOq_pU428h2zvT7k-JYVnsc1Z62VY,2859\r\ntwisted/trial/_synctest.py,sha256=HgxTQKu4jMXjUjJyC48yNX7LVw4f8nEynMi3VyDdGtk,50017\r\ntwisted/trial/itrial.py,sha256=EmbbuIA4WItHcgQKEOGhfORSTxTuWX-DrRezBrcbj9k,6857\r\ntwisted/trial/reporter.py,sha256=peShSfUXXNGxHTQyxY-1WXuTEAaEhaWrUqRDh0YaPxI,40105\r\ntwisted/trial/runner.py,sha256=mzT5AVFYlBL97jCK8CjJLZjKor9zysNV-yff7bLX7OQ,36720\r\ntwisted/trial/test/__init__.py,sha256=uWFvjebi50_v57TkFDrFhvUS5oUq8Jo5y_vRBvpP9o4,130\r\ntwisted/trial/test/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/trial/test/__pycache__/detests.cpython-36.pyc,,\r\ntwisted/trial/test/__pycache__/erroneous.cpython-36.pyc,,\r\ntwisted/trial/test/__pycache__/mockcustomsuite.cpython-36.pyc,,\r\ntwisted/trial/test/__pycache__/mockcustomsuite2.cpython-36.pyc,,\r\ntwisted/trial/test/__pycache__/mockcustomsuite3.cpython-36.pyc,,\r\ntwisted/trial/test/__pycache__/mockdoctest.cpython-36.pyc,,\r\ntwisted/trial/test/__pycache__/moduleself.cpython-36.pyc,,\r\ntwisted/trial/test/__pycache__/moduletest.cpython-36.pyc,,\r\ntwisted/trial/test/__pycache__/novars.cpython-36.pyc,,\r\ntwisted/trial/test/__pycache__/ordertests.cpython-36.pyc,,\r\ntwisted/trial/test/__pycache__/packages.cpython-36.pyc,,\r\ntwisted/trial/test/__pycache__/sample.cpython-36.pyc,,\r\ntwisted/trial/test/__pycache__/scripttest.cpython-36.pyc,,\r\ntwisted/trial/test/__pycache__/skipping.cpython-36.pyc,,\r\ntwisted/trial/test/__pycache__/suppression.cpython-36.pyc,,\r\ntwisted/trial/test/__pycache__/test_assertions.cpython-36.pyc,,\r\ntwisted/trial/test/__pycache__/test_asyncassertions.cpython-36.pyc,,\r\ntwisted/trial/test/__pycache__/test_deferred.cpython-36.pyc,,\r\ntwisted/trial/test/__pycache__/test_doctest.cpython-36.pyc,,\r\ntwisted/trial/test/__pycache__/test_keyboard.cpython-36.pyc,,\r\ntwisted/trial/test/__pycache__/test_loader.cpython-36.pyc,,\r\ntwisted/trial/test/__pycache__/test_log.cpython-36.pyc,,\r\ntwisted/trial/test/__pycache__/test_output.cpython-36.pyc,,\r\ntwisted/trial/test/__pycache__/test_plugins.cpython-36.pyc,,\r\ntwisted/trial/test/__pycache__/test_pyunitcompat.cpython-36.pyc,,\r\ntwisted/trial/test/__pycache__/test_reporter.cpython-36.pyc,,\r\ntwisted/trial/test/__pycache__/test_runner.cpython-36.pyc,,\r\ntwisted/trial/test/__pycache__/test_script.cpython-36.pyc,,\r\ntwisted/trial/test/__pycache__/test_suppression.cpython-36.pyc,,\r\ntwisted/trial/test/__pycache__/test_testcase.cpython-36.pyc,,\r\ntwisted/trial/test/__pycache__/test_tests.cpython-36.pyc,,\r\ntwisted/trial/test/__pycache__/test_util.cpython-36.pyc,,\r\ntwisted/trial/test/__pycache__/test_warning.cpython-36.pyc,,\r\ntwisted/trial/test/__pycache__/weird.cpython-36.pyc,,\r\ntwisted/trial/test/detests.py,sha256=7uYBWdLD-Slpq6cXrgtdJyalwCvAZzhJGL0KX2jhbUA,5368\r\ntwisted/trial/test/erroneous.py,sha256=fM-kSxh_M7QfB0Oc9bIIQDX-r_29ZdJIrabqUqjxZhc,4829\r\ntwisted/trial/test/mockcustomsuite.py,sha256=pNEnsIgTTx-fp2hYS4GxkAenBER6uPot11VbkDzqQgM,535\r\ntwisted/trial/test/mockcustomsuite2.py,sha256=GPSbV-Ou5XCACyVF_DgD2SXDH3Ekvzab9rQiC0roUuQ,532\r\ntwisted/trial/test/mockcustomsuite3.py,sha256=zc_roFFRqTPwVGto3VL7_Ic15nGm4WvCEG-w5rHiYlw,675\r\ntwisted/trial/test/mockdoctest.py,sha256=f89ND666XnQnUuvIyR4begtzQWM_mBxzRWs5F9AeWvE,2645\r\ntwisted/trial/test/moduleself.py,sha256=UWx4cOBRU6OlGdjfjgEgNQPpfbp-biul5WCAtI30GD4,170\r\ntwisted/trial/test/moduletest.py,sha256=Yx-H7C4qwBgzKFkp1B_JYyq2D8CCiSEpE9qS2jwfD7A,310\r\ntwisted/trial/test/novars.py,sha256=asKIwzyfBjiDqHi8zeTzcHHdLYGBk1JQf1QvbZl25zc,189\r\ntwisted/trial/test/ordertests.py,sha256=ZZm2zhvHrEtN7hVXH49vVTOB7dEsXfuargd_8M1d0wM,867\r\ntwisted/trial/test/packages.py,sha256=lnN006Agb_-kEkNrKGus38S-ePaIl4JT8azwJFhTGRg,4927\r\ntwisted/trial/test/sample.py,sha256=nWBJwh0ZAu3tpLhV8N5RoNUI7HUQQWrkLIbVHrDDGbk,2155\r\ntwisted/trial/test/scripttest.py,sha256=1wey0lWic-hQv_NZ4YR6BS-GHFqcJaxf8CHGitkdosY,466\r\ntwisted/trial/test/skipping.py,sha256=y1Pkj2IMNGfVdrtwBEkPzRWh_zBia3srnkHySEbszPg,5356\r\ntwisted/trial/test/suppression.py,sha256=rHQuaV53Au_YXyYw0zZC4UToHp-o5_uQUB_vbmiS9GI,2497\r\ntwisted/trial/test/test_assertions.py,sha256=rIbGSAeiouJh_20HJZUib8D4u-wHN8rIVnUXIyFZYvI,46630\r\ntwisted/trial/test/test_asyncassertions.py,sha256=f-OE4xvhJ9jZmVUd74azvoUKgYcUW-BLHwRbYjIcCB8,2571\r\ntwisted/trial/test/test_deferred.py,sha256=d-iLD-GqYvAq2IvFUhmr8eVtOwGeP4X9bFg_BoqMAeY,8889\r\ntwisted/trial/test/test_doctest.py,sha256=p5fpDtW76E461ltTr5vrrz0V3Gas5nGz7lUypOvi90U,1766\r\ntwisted/trial/test/test_keyboard.py,sha256=Zc3E7yyNElQ9bI2E8wlsRj_1V5jOXFv_ylTi3FW9db8,4036\r\ntwisted/trial/test/test_loader.py,sha256=b6r0-_40GUTMZ2svo58Q_NBMXkxY3HmE5ffBb2mp4n8,26783\r\ntwisted/trial/test/test_log.py,sha256=4KbBgmQwI7IjFnZ8W8ZNdtb5RcSLoPGov7QL2Znxjmw,7969\r\ntwisted/trial/test/test_output.py,sha256=zQ94RkuSX1FOLTxlt7VqSAueSWmvpsYrGIHeTDINo8M,5299\r\ntwisted/trial/test/test_plugins.py,sha256=9KUuBPPm05bO1a7RxQP6fMRDr23S7_FKf81ssYL3GHo,1451\r\ntwisted/trial/test/test_pyunitcompat.py,sha256=HkGUKXAp9hfYOqjPY_DVWBvxpTVm-QC2qPAZXJHfUII,7670\r\ntwisted/trial/test/test_reporter.py,sha256=3vFYKFQSF5g_Gf21MN99PNiUAUdE9Xwq5-Wxp86Lpzw,57428\r\ntwisted/trial/test/test_runner.py,sha256=pRK1B-bIjTn9pCu2gSte_IVP_3i0OMitwasxQYBuptQ,34074\r\ntwisted/trial/test/test_script.py,sha256=YaO9q-4fH_9T6yhSTeEm0ciGv5ivM1DBdAlIDWa9U3I,29717\r\ntwisted/trial/test/test_suppression.py,sha256=vw8R3i_EaZgtdcGNxrzSbVI7gvLVm2baHh348g_yVvc,6089\r\ntwisted/trial/test/test_testcase.py,sha256=f2xpFykUxZoW8T5HzSiw7dc0pqOAh5ZswK4u1eC9ZOw,2043\r\ntwisted/trial/test/test_tests.py,sha256=koXRAKkmWDMXElmy87uPQCuIspyeYr4VeO4dbf1XPpc,50030\r\ntwisted/trial/test/test_util.py,sha256=faNL8ZBaOR83bcNQV7x7pNtXUofSSvj8h9gbq1m6o0s,24709\r\ntwisted/trial/test/test_warning.py,sha256=aZZSrMvdCvAf_EALAvTSBpQozfSpef_5GyelC7qpCgk,16770\r\ntwisted/trial/test/weird.py,sha256=apD_gjh7qeK_gEi9r3WErMHYvPuf0PIk_BoJZNAbvCA,721\r\ntwisted/trial/unittest.py,sha256=JQAudPGd--a9KNzsaGRCnzbQ2H_JzMSQFC-nMVJ4Xng,978\r\ntwisted/trial/util.py,sha256=FjW69s1ttgn3MHUXkv7HmhK2JXzceiE0BgTiAQnNgHw,13410\r\ntwisted/web/__init__.py,sha256=XDcQGn3KmRxndOIDTJZcSWGhxPALqHLMxbzsRhqsra4,384\r\ntwisted/web/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/web/__pycache__/_element.cpython-36.pyc,,\r\ntwisted/web/__pycache__/_flatten.cpython-36.pyc,,\r\ntwisted/web/__pycache__/_http2.cpython-36.pyc,,\r\ntwisted/web/__pycache__/_newclient.cpython-36.pyc,,\r\ntwisted/web/__pycache__/_responses.cpython-36.pyc,,\r\ntwisted/web/__pycache__/_stan.cpython-36.pyc,,\r\ntwisted/web/__pycache__/client.cpython-36.pyc,,\r\ntwisted/web/__pycache__/demo.cpython-36.pyc,,\r\ntwisted/web/__pycache__/distrib.cpython-36.pyc,,\r\ntwisted/web/__pycache__/domhelpers.cpython-36.pyc,,\r\ntwisted/web/__pycache__/error.cpython-36.pyc,,\r\ntwisted/web/__pycache__/guard.cpython-36.pyc,,\r\ntwisted/web/__pycache__/html.cpython-36.pyc,,\r\ntwisted/web/__pycache__/http.cpython-36.pyc,,\r\ntwisted/web/__pycache__/http_headers.cpython-36.pyc,,\r\ntwisted/web/__pycache__/iweb.cpython-36.pyc,,\r\ntwisted/web/__pycache__/microdom.cpython-36.pyc,,\r\ntwisted/web/__pycache__/proxy.cpython-36.pyc,,\r\ntwisted/web/__pycache__/resource.cpython-36.pyc,,\r\ntwisted/web/__pycache__/rewrite.cpython-36.pyc,,\r\ntwisted/web/__pycache__/script.cpython-36.pyc,,\r\ntwisted/web/__pycache__/server.cpython-36.pyc,,\r\ntwisted/web/__pycache__/static.cpython-36.pyc,,\r\ntwisted/web/__pycache__/sux.cpython-36.pyc,,\r\ntwisted/web/__pycache__/tap.cpython-36.pyc,,\r\ntwisted/web/__pycache__/template.cpython-36.pyc,,\r\ntwisted/web/__pycache__/twcgi.cpython-36.pyc,,\r\ntwisted/web/__pycache__/util.cpython-36.pyc,,\r\ntwisted/web/__pycache__/vhost.cpython-36.pyc,,\r\ntwisted/web/__pycache__/wsgi.cpython-36.pyc,,\r\ntwisted/web/__pycache__/xmlrpc.cpython-36.pyc,,\r\ntwisted/web/_auth/__init__.py,sha256=GD_euhqqSJj1fv_srRt5Yl5RfcExpzifR-PYLNTKIwI,190\r\ntwisted/web/_auth/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/web/_auth/__pycache__/basic.cpython-36.pyc,,\r\ntwisted/web/_auth/__pycache__/digest.cpython-36.pyc,,\r\ntwisted/web/_auth/__pycache__/wrapper.cpython-36.pyc,,\r\ntwisted/web/_auth/basic.py,sha256=S3KTEXHVdz8EFnrR3Un3kulhOO_kOUitt0D1cleHIzg,1689\r\ntwisted/web/_auth/digest.py,sha256=Cr3akmx_l73w-yZxUqB3CcF1DFNc9R41Ibpw63MIfHc,1770\r\ntwisted/web/_auth/wrapper.py,sha256=QjwuVhM9rwMcxiV1oF8u9YmH7YEy3EPC4BfzGsQy4U8,8566\r\ntwisted/web/_element.py,sha256=7vBEF4yTwCUsmeAsBCjSwYbutvNrLS4Bp-9PA0ae7mU,5947\r\ntwisted/web/_flatten.py,sha256=obSfnAN4wJ0n3DK_e1fxlj5qiVc_CwLkyMFKAI0QzdI,15912\r\ntwisted/web/_http2.py,sha256=mlomwH5LyFPIl3wZ1GE60BtIAx1mls-x54wagPni5AA,45545\r\ntwisted/web/_newclient.py,sha256=bsD00poQNKPGLeFY0pXkxZ1yaDV20Xe9sH5oc0x-KAg,63973\r\ntwisted/web/_responses.py,sha256=IuFI3g88Klz01-6AGus3FDu4ifFiSZcGpH_7xQFKv8U,3655\r\ntwisted/web/_stan.py,sha256=hr8FW8_qo-wFShnq3iGUmALNVew2k0is5YbRnuXliJ4,10790\r\ntwisted/web/client.py,sha256=wf2N3Rzn4lZ_lLc-DPc-euuiI0O7l35e1QxO2eeJLOg,76971\r\ntwisted/web/demo.py,sha256=g3JC8qhso0-sYmmRVjT_di_F2_-J09kdsM9Z5kH7u3g,554\r\ntwisted/web/distrib.py,sha256=ky8W3tDRSsVXmarhx3z7Ys9oKmho0UtNIKd0gv72LVE,11881\r\ntwisted/web/domhelpers.py,sha256=JJor6qQbzybg-D9rVX-9Q3vTvJZUDNbzp9HyaACvPc0,8645\r\ntwisted/web/error.py,sha256=z_QFN-l4gy370GEWXuue3MIliddbNa1VXroIRcfsfHA,12537\r\ntwisted/web/guard.py,sha256=2vGjNL9ZxbPxHZWuqXwJ1UFXGHfFgAxdD7kQ90I0OqU,630\r\ntwisted/web/html.py,sha256=7uKIiee9Sg6vKlV5juUTHoTSwLPVa6jXLSKTOkg6SKs,1557\r\ntwisted/web/http.py,sha256=xTllJJrr8PWDEmyvpkBNSVqsdrZo_ovErRz4fG8tEAc,104055\r\ntwisted/web/http_headers.py,sha256=L9yz-tM4HUP_xDU7fqvnNIuiEzj6yYRp6O766HDsYLA,8853\r\ntwisted/web/iweb.py,sha256=KYQqCnUp6ebvwa5BNCogYjKpdrY2p7_flVDbCa8A9rE,26778\r\ntwisted/web/microdom.py,sha256=a-LdI_UIIXFLMfFdHDVKYnAM8vTEfKhSkPAqeK_PC34,36197\r\ntwisted/web/proxy.py,sha256=u_LqSCDNuFKjs_K85LNzimWcsxrvtRuMe5ZHs3QO6lU,9837\r\ntwisted/web/resource.py,sha256=kpKqmCAWKXwNvokIGYM2pCCWM4AevSOgklRX20Oy3-8,13610\r\ntwisted/web/rewrite.py,sha256=ezcoNJcAy-ET1WmS2UF3JzTNhhNR1bGoyDK0dl_q9Fg,1852\r\ntwisted/web/script.py,sha256=pIQ-kiryhNxUjZlJUQyd2knXWjdzO_VZFm8-weXDIh0,5745\r\ntwisted/web/server.py,sha256=eDdTtMBs2fANGFR0oL5UWJLLrdRdClpIdAUJ0kbw0ic,28329\r\ntwisted/web/static.py,sha256=3iCMORPZXIwcujH1D4lwU7R-vISY-2RbBqUiC11vNHc,38007\r\ntwisted/web/sux.py,sha256=ue2_D9mzOOOPpPvJNTL-31jWbnAgsG-EimiuAIJQx2Q,20892\r\ntwisted/web/tap.py,sha256=nMnaXPp8dEHhOLDj_L6ogXyulXR387_-3hMVucoX5Vg,10331\r\ntwisted/web/template.py,sha256=IZMkl-eBtxot8sFb96C2xHBXMcHwwgvjE8egjy30pKo,17631\r\ntwisted/web/test/__init__.py,sha256=fUhYepItGqSYT0CsZLxIbU9lDRjUkJ0pGsdsr8GRp0c,108\r\ntwisted/web/test/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/web/test/__pycache__/_util.cpython-36.pyc,,\r\ntwisted/web/test/__pycache__/injectionhelpers.cpython-36.pyc,,\r\ntwisted/web/test/__pycache__/requesthelper.cpython-36.pyc,,\r\ntwisted/web/test/__pycache__/test_agent.cpython-36.pyc,,\r\ntwisted/web/test/__pycache__/test_cgi.cpython-36.pyc,,\r\ntwisted/web/test/__pycache__/test_client.cpython-36.pyc,,\r\ntwisted/web/test/__pycache__/test_distrib.cpython-36.pyc,,\r\ntwisted/web/test/__pycache__/test_domhelpers.cpython-36.pyc,,\r\ntwisted/web/test/__pycache__/test_error.cpython-36.pyc,,\r\ntwisted/web/test/__pycache__/test_flatten.cpython-36.pyc,,\r\ntwisted/web/test/__pycache__/test_html.cpython-36.pyc,,\r\ntwisted/web/test/__pycache__/test_http.cpython-36.pyc,,\r\ntwisted/web/test/__pycache__/test_http2.cpython-36.pyc,,\r\ntwisted/web/test/__pycache__/test_http_headers.cpython-36.pyc,,\r\ntwisted/web/test/__pycache__/test_httpauth.cpython-36.pyc,,\r\ntwisted/web/test/__pycache__/test_newclient.cpython-36.pyc,,\r\ntwisted/web/test/__pycache__/test_proxy.cpython-36.pyc,,\r\ntwisted/web/test/__pycache__/test_resource.cpython-36.pyc,,\r\ntwisted/web/test/__pycache__/test_script.cpython-36.pyc,,\r\ntwisted/web/test/__pycache__/test_stan.cpython-36.pyc,,\r\ntwisted/web/test/__pycache__/test_static.cpython-36.pyc,,\r\ntwisted/web/test/__pycache__/test_tap.cpython-36.pyc,,\r\ntwisted/web/test/__pycache__/test_template.cpython-36.pyc,,\r\ntwisted/web/test/__pycache__/test_util.cpython-36.pyc,,\r\ntwisted/web/test/__pycache__/test_vhost.cpython-36.pyc,,\r\ntwisted/web/test/__pycache__/test_web.cpython-36.pyc,,\r\ntwisted/web/test/__pycache__/test_web__responses.cpython-36.pyc,,\r\ntwisted/web/test/__pycache__/test_webclient.cpython-36.pyc,,\r\ntwisted/web/test/__pycache__/test_wsgi.cpython-36.pyc,,\r\ntwisted/web/test/__pycache__/test_xml.cpython-36.pyc,,\r\ntwisted/web/test/__pycache__/test_xmlrpc.cpython-36.pyc,,\r\ntwisted/web/test/_util.py,sha256=6pb3RDrdZoJ1DaELSW8PdaXUywANty8JN8j8AUwOKAM,2568\r\ntwisted/web/test/injectionhelpers.py,sha256=V2QQTamzKkOjypM7qdt2Y2iVHzQi4c83mZTesOt2_JU,5627\r\ntwisted/web/test/requesthelper.py,sha256=oP_zp0MkntT7TKvJPMIg6_7LlyQiuQ0-izoHRiYNIB0,13702\r\ntwisted/web/test/test_agent.py,sha256=ghnRnHIpSsrvi7ilIqdFU4a1MENBBzJ-PItrw6IAVQY,116623\r\ntwisted/web/test/test_cgi.py,sha256=fPZPDFG8JAOUJD2pXr7H_FOenrzy-RLdLW3FOTmM4L8,13761\r\ntwisted/web/test/test_client.py,sha256=rnMgKFRmeVFgtKTjnyAhJL2LvOI8P6WIjXJa--Juv5M,1372\r\ntwisted/web/test/test_distrib.py,sha256=SAHzSQyQa3IoYGi1dc0csEvSl69hSnBzRZGzKbfSIoI,18288\r\ntwisted/web/test/test_domhelpers.py,sha256=ir_GSEC4Y5eJUIP4mKi9GzFUdwLXvuDuBEHiUmSC2go,11103\r\ntwisted/web/test/test_error.py,sha256=a-KtTSqsH05SlDijTSPA50C7m-dgPhZH3Avc9uKs3uE,16210\r\ntwisted/web/test/test_flatten.py,sha256=TJTlohdbkYUC6OLIprKuYQrHoUh2aY86kVgzIQyp9Nk,18259\r\ntwisted/web/test/test_html.py,sha256=BBbAgc2B9f8-PmYvcyGDbhjKDUpBQTiuikNgaNpKaGo,1264\r\ntwisted/web/test/test_http.py,sha256=4IrPhkpFTHNSXbjQu9cjrOi6c-3X4LFGz6DYXIMah6k,131929\r\ntwisted/web/test/test_http2.py,sha256=LLlY0PSmFovpGoGe05bfTFrM8UetVZIhGrwCX4V_RUc,99939\r\ntwisted/web/test/test_http_headers.py,sha256=c3uv_Zbs5hDJQ64eGEErzs4iCVSnDdDCTp8sY3hbs0g,22177\r\ntwisted/web/test/test_httpauth.py,sha256=VyOB2BQqn2SEjXUsSUUc9OLHFgesUwjCvQD0U87XMSg,24128\r\ntwisted/web/test/test_newclient.py,sha256=rq4_W0WxH4NhCozadpy3gudGsD4zZTUDkdib1MMUSCY,110593\r\ntwisted/web/test/test_proxy.py,sha256=DW2jc_1elz_bPp4eU7qLK5peNTc_WM39p1TDnIMBaC8,20346\r\ntwisted/web/test/test_resource.py,sha256=EgBRDWfHTO01PNJgDbbAnUv9Pp_C5NmC2ZUOHiL-buI,9243\r\ntwisted/web/test/test_script.py,sha256=rQilL-H4VzO-NGU6_2Dv9h32VA3j4pZSPtwMW30e86E,3784\r\ntwisted/web/test/test_stan.py,sha256=5IqsRlFv_yp7HVZXFaqlFR1g79H2etwtPriydZkjaFE,5667\r\ntwisted/web/test/test_static.py,sha256=PqkZKWxhQ3GGmlMqwx2oDfrY_RlNc8ZPE5oaWLL74XU,67858\r\ntwisted/web/test/test_tap.py,sha256=w1GFPg5RbSWryvvp1wf7HleTz0EJHSoxHN3oMGpvzuc,12200\r\ntwisted/web/test/test_template.py,sha256=tVpMImaRl2wZQo1m-CPR1EfnApPSxhZedkLT4xTEsww,25977\r\ntwisted/web/test/test_util.py,sha256=pGxkGSoNPuWmunh_xqVJ8k4z97rMcZafvTgz6VOC770,12590\r\ntwisted/web/test/test_vhost.py,sha256=lF3ch-BlKMRqwug79z-y_dmFyJwQjVwLqhziruVeZz4,7398\r\ntwisted/web/test/test_web.py,sha256=CsyyQrdvYh-_r12YjuYXMS2z21hMR_bMZrXvqjfBgx8,64296\r\ntwisted/web/test/test_web__responses.py,sha256=Hsq7CDGZoxE9Iq78xaYuhZxqoN58qNuKsoaR4cgAMK0,877\r\ntwisted/web/test/test_webclient.py,sha256=Ww5dnXrDvtTsTwUAXtchL1vgKbQMrK_3Lbw4X9UtUMM,59615\r\ntwisted/web/test/test_wsgi.py,sha256=WAsGDXhOATeEIdDj-PPimPdrSoMVRKUl8EgCWVRcegw,78210\r\ntwisted/web/test/test_xml.py,sha256=zEnd97a1PSltKUfNyobziKKt7laDLWJV3jdfxJw3caw,42357\r\ntwisted/web/test/test_xmlrpc.py,sha256=6OL77o-ZcYUGS80cu5cyrbZA89DOkIB98xceNIOmQeA,30302\r\ntwisted/web/twcgi.py,sha256=_BIZTsI0soo5v7tf4gx25bqhbJhwNB8ZZCoDIdIgCr0,11343\r\ntwisted/web/util.py,sha256=Nwt-k63WLnLLhfA7vOh-10EkBboLhZehTM2oHpkFfjE,12412\r\ntwisted/web/vhost.py,sha256=9Y-li_wuLQmTJKPJWs4KOiT_WTVqhrnbfdcobtpbQnk,4463\r\ntwisted/web/wsgi.py,sha256=bjbeVJI5DrrhHlB1VFK-DVrOknosC_uRB6B4HGIMPDw,21879\r\ntwisted/web/xmlrpc.py,sha256=H5mFDI1rk1-dmj8QPijFyd34K5T7gKxTv8i-XMNFwak,20203\r\ntwisted/words/__init__.py,sha256=ffiFEwEz9RTE5rrSHV9jzhWhuomlg-tT7RQAXhlpGNI,215\r\ntwisted/words/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/words/__pycache__/ewords.cpython-36.pyc,,\r\ntwisted/words/__pycache__/iwords.cpython-36.pyc,,\r\ntwisted/words/__pycache__/service.cpython-36.pyc,,\r\ntwisted/words/__pycache__/tap.cpython-36.pyc,,\r\ntwisted/words/__pycache__/xmpproutertap.cpython-36.pyc,,\r\ntwisted/words/ewords.py,sha256=XOOQe4IRjQrj-kRj8Hu07VhjT6gCJYXmJ5MeFDhMEpE,623\r\ntwisted/words/im/__init__.py,sha256=ojtUkusjr0Xe56X-Oo4kmcmDCRCsC9C5qwZQZ_7vyPc,129\r\ntwisted/words/im/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/words/im/__pycache__/baseaccount.cpython-36.pyc,,\r\ntwisted/words/im/__pycache__/basechat.cpython-36.pyc,,\r\ntwisted/words/im/__pycache__/basesupport.cpython-36.pyc,,\r\ntwisted/words/im/__pycache__/interfaces.cpython-36.pyc,,\r\ntwisted/words/im/__pycache__/ircsupport.cpython-36.pyc,,\r\ntwisted/words/im/__pycache__/locals.cpython-36.pyc,,\r\ntwisted/words/im/__pycache__/pbsupport.cpython-36.pyc,,\r\ntwisted/words/im/baseaccount.py,sha256=s4wY-BSOVxOpuY85qyWzAV_Jcf53V48gPs7MA4ODitc,1808\r\ntwisted/words/im/basechat.py,sha256=sa3FXpKVESXmoCATOAq781KzPg-02vpk_Om42UcN1es,16454\r\ntwisted/words/im/basesupport.py,sha256=AmZMFNSPJRqriDckFSRrx2Ae2DeZUMblNdzi_yIPTpY,7842\r\ntwisted/words/im/instancemessenger.glade,sha256=Scnco66vE3ByEHRbXpG4jkjW8wBquLjVrPtTRXurkRs,77126\r\ntwisted/words/im/interfaces.py,sha256=C8hxSNUyi-BDhC7uzGQFAoQMGEb2BiqTekob5cOe-8o,8675\r\ntwisted/words/im/ircsupport.py,sha256=ZBhiItd93QgRcXZvEcSygIBi0-QJs5sWfyVAUY2bfQM,9150\r\ntwisted/words/im/locals.py,sha256=JCVxJC5thNvnoTQ9VbrGtdXtGoYDBAm4u9ZhqqL8G0I,499\r\ntwisted/words/im/pbsupport.py,sha256=964WKGL-swV-24Y_JT1-5hvfZwBxixjP-aDq5BebcJ8,9676\r\ntwisted/words/iwords.py,sha256=YtWBU_LM980pJN6_MjMToSVkZteZXYtTgM-wg5S9kPM,8528\r\ntwisted/words/protocols/__init__.py,sha256=zmeNC2QVvHipjDnBJSx2CKRWMONswC98R2IlwuAhWBw,97\r\ntwisted/words/protocols/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/words/protocols/__pycache__/irc.cpython-36.pyc,,\r\ntwisted/words/protocols/irc.py,sha256=spjIqZTWOAecb1e8iP5yTCxt5ArerCjo1gRpkxY_54I,125664\r\ntwisted/words/protocols/jabber/__init__.py,sha256=yofokZPwf09uggpzpyRuUCZf_qAkzijZZCZnDpkEN90,167\r\ntwisted/words/protocols/jabber/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/words/protocols/jabber/__pycache__/client.cpython-36.pyc,,\r\ntwisted/words/protocols/jabber/__pycache__/component.cpython-36.pyc,,\r\ntwisted/words/protocols/jabber/__pycache__/error.cpython-36.pyc,,\r\ntwisted/words/protocols/jabber/__pycache__/ijabber.cpython-36.pyc,,\r\ntwisted/words/protocols/jabber/__pycache__/jid.cpython-36.pyc,,\r\ntwisted/words/protocols/jabber/__pycache__/jstrports.cpython-36.pyc,,\r\ntwisted/words/protocols/jabber/__pycache__/sasl.cpython-36.pyc,,\r\ntwisted/words/protocols/jabber/__pycache__/sasl_mechanisms.cpython-36.pyc,,\r\ntwisted/words/protocols/jabber/__pycache__/xmlstream.cpython-36.pyc,,\r\ntwisted/words/protocols/jabber/__pycache__/xmpp_stringprep.cpython-36.pyc,,\r\ntwisted/words/protocols/jabber/client.py,sha256=L4rpVpZFzNGjaGw7nb4468ZIpPxzPdlRa6mjiJZIZ3U,14382\r\ntwisted/words/protocols/jabber/component.py,sha256=bcXoz0-mtxYrYjZy8m_BlFJhuiZk3TG5jQm_hLHx15o,15595\r\ntwisted/words/protocols/jabber/error.py,sha256=GsmBMFqyQ3dJMfMebbocmF1Dp_MFYWObsKswKoqiwLA,10802\r\ntwisted/words/protocols/jabber/ijabber.py,sha256=R2Y4N6jWJFb7Rqz5O_QelpHtbQpCA6yjGXNUWXe8xpE,5380\r\ntwisted/words/protocols/jabber/jid.py,sha256=xqT9MfeTo2YD2hqSmFJqkxmi6Fsf_3zdy423UWukFTE,7249\r\ntwisted/words/protocols/jabber/jstrports.py,sha256=RoATh0iNGE-qN1MoJKTd9TXN_51Sshoo80a7qlJQ2Nc,978\r\ntwisted/words/protocols/jabber/sasl.py,sha256=uEVeYQ9snoX4ODHQmxOQSC0-zIWEoA8Dnaki-vpxiFA,7461\r\ntwisted/words/protocols/jabber/sasl_mechanisms.py,sha256=rPBzN-_kiyIne3GDVHVyHi8tRoKoEeS2Nv2tD46un2U,8730\r\ntwisted/words/protocols/jabber/xmlstream.py,sha256=bExNRabsilWpyGLxjQeat4TJoHt7nE0OegMb4NBGLUg,36848\r\ntwisted/words/protocols/jabber/xmpp_stringprep.py,sha256=JaC22A1_c9_mR0RoxjHZ1oO_VKbRHE4h4kViPK9YcGQ,7221\r\ntwisted/words/service.py,sha256=gREUR1_Cq5kEUEDA9BnjWAM87nqYq_3JPUoIZf7VjTM,38173\r\ntwisted/words/tap.py,sha256=a0Q_SX7jt6adZYHX_sSkB16qwWqz-uLGTOYV-br54W8,2422\r\ntwisted/words/test/__init__.py,sha256=wDdSRMUVT0_hf5Fe36M3C6GiB4N1TOqgB41q9B-Ia04,14\r\ntwisted/words/test/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/words/test/__pycache__/test_basechat.cpython-36.pyc,,\r\ntwisted/words/test/__pycache__/test_basesupport.cpython-36.pyc,,\r\ntwisted/words/test/__pycache__/test_domish.cpython-36.pyc,,\r\ntwisted/words/test/__pycache__/test_irc.cpython-36.pyc,,\r\ntwisted/words/test/__pycache__/test_irc_service.cpython-36.pyc,,\r\ntwisted/words/test/__pycache__/test_ircsupport.cpython-36.pyc,,\r\ntwisted/words/test/__pycache__/test_jabberclient.cpython-36.pyc,,\r\ntwisted/words/test/__pycache__/test_jabbercomponent.cpython-36.pyc,,\r\ntwisted/words/test/__pycache__/test_jabbererror.cpython-36.pyc,,\r\ntwisted/words/test/__pycache__/test_jabberjid.cpython-36.pyc,,\r\ntwisted/words/test/__pycache__/test_jabberjstrports.cpython-36.pyc,,\r\ntwisted/words/test/__pycache__/test_jabbersasl.cpython-36.pyc,,\r\ntwisted/words/test/__pycache__/test_jabbersaslmechanisms.cpython-36.pyc,,\r\ntwisted/words/test/__pycache__/test_jabberxmlstream.cpython-36.pyc,,\r\ntwisted/words/test/__pycache__/test_jabberxmppstringprep.cpython-36.pyc,,\r\ntwisted/words/test/__pycache__/test_service.cpython-36.pyc,,\r\ntwisted/words/test/__pycache__/test_tap.cpython-36.pyc,,\r\ntwisted/words/test/__pycache__/test_xishutil.cpython-36.pyc,,\r\ntwisted/words/test/__pycache__/test_xmlstream.cpython-36.pyc,,\r\ntwisted/words/test/__pycache__/test_xmpproutertap.cpython-36.pyc,,\r\ntwisted/words/test/__pycache__/test_xpath.cpython-36.pyc,,\r\ntwisted/words/test/test_basechat.py,sha256=y01cIaQ3LrPRUbsdsiTt50w5WeRu-tQrDLHqZe9MQos,2504\r\ntwisted/words/test/test_basesupport.py,sha256=YtA2z8fxt1aP-AYSHpO3PCLNA9t-G5De5ibFH_JEEd8,3064\r\ntwisted/words/test/test_domish.py,sha256=QFHbVSG9SHOy0IJ2_Gx-hTD-KLHHGVeSMJC8IinO3xA,20172\r\ntwisted/words/test/test_irc.py,sha256=LNcjt-o8U2BSbxx6kNpBb-b5z5OTi1kbuM54pwfQIxU,103397\r\ntwisted/words/test/test_irc_service.py,sha256=X_pjwDVCfKBShdEHIiezZH4UFyoyxWaRkAWzP5yGEOM,9639\r\ntwisted/words/test/test_ircsupport.py,sha256=vhzh3PXjUynPnsf3NwZ5Nu67w-4ZBuC4u1Oiz4tBVgs,10702\r\ntwisted/words/test/test_jabberclient.py,sha256=22MQ-lfQCgrRe9r5qTmXuHluFa_pPaxSRHkONpAlj4E,16866\r\ntwisted/words/test/test_jabbercomponent.py,sha256=gw_WkkLLegqMjjWpnCJP59pSNlgBQB0Wbu7mLjpPDe0,14204\r\ntwisted/words/test/test_jabbererror.py,sha256=h97z_XCO11UhFw8Zkb2GH1y31uF6wcILTIdkTdqdsNU,11521\r\ntwisted/words/test/test_jabberjid.py,sha256=5WlXkppYf9H7y_zDOLpBaXAYo2Am2SB0SkvT4x2_LN0,7210\r\ntwisted/words/test/test_jabberjstrports.py,sha256=0SJ1Z8J27DcBHANt-7w6rgn34rlY65LNaTZcp2ysQuY,996\r\ntwisted/words/test/test_jabbersasl.py,sha256=2aTrH1bZXhmejB0ILDjcYHOrAvWN_nM6tMPaGOoBrTU,9432\r\ntwisted/words/test/test_jabbersaslmechanisms.py,sha256=uz_kmwx2T_sFGms27gZ7NGbGBPESRGy46HiWiP2o6mU,5758\r\ntwisted/words/test/test_jabberxmlstream.py,sha256=kasBxkHYAr22DwlscSsO9dNUk8xmFQQ9bphSgk0hnbA,45718\r\ntwisted/words/test/test_jabberxmppstringprep.py,sha256=9E7K3ji2kRRzTYU9NWqqjdSUyvT4iOxYJELgVZhDShk,5549\r\ntwisted/words/test/test_service.py,sha256=cH-DqZL7lV4_kTHlyF6_XzA3w9g4Zs8lbt0J2XdRqWw,28462\r\ntwisted/words/test/test_tap.py,sha256=rNN4d-kYxOe-6dUmRwHmJe1wjN74Px0v2MltP02_TB4,2180\r\ntwisted/words/test/test_xishutil.py,sha256=onFjooPZ3cM3r42-iw2H9ihBcXZ5q865C8p5JgpftgA,9396\r\ntwisted/words/test/test_xmlstream.py,sha256=YuCLqVj1s1Ccll11b7OG_bm8IaoNOlFjNZeNKeLIfJQ,6274\r\ntwisted/words/test/test_xmpproutertap.py,sha256=qROkHmUyHZ1kRwThHV9-28LOhR74lQJXM-g5NUIRMww,2398\r\ntwisted/words/test/test_xpath.py,sha256=m2Fvr_21iIKlBiWNWp-7Pf8YTJm6f9_e1t9Ga4XjMO4,11002\r\ntwisted/words/xish/__init__.py,sha256=XJs3sqZxj1QVTrrgkbVAUcpxMekKLPEKzuEXFJVwp0k,177\r\ntwisted/words/xish/__pycache__/__init__.cpython-36.pyc,,\r\ntwisted/words/xish/__pycache__/domish.cpython-36.pyc,,\r\ntwisted/words/xish/__pycache__/utility.cpython-36.pyc,,\r\ntwisted/words/xish/__pycache__/xmlstream.cpython-36.pyc,,\r\ntwisted/words/xish/__pycache__/xpath.cpython-36.pyc,,\r\ntwisted/words/xish/__pycache__/xpathparser.cpython-36.pyc,,\r\ntwisted/words/xish/domish.py,sha256=O41aNQaLjs5aAhleDGctdPOG5EU1r9QQJ_K6JHLEIlY,30564\r\ntwisted/words/xish/utility.py,sha256=bCnYogLhRc1BWprU8ewiPqiU9kCUUoDZQqcdZoXFuZI,13482\r\ntwisted/words/xish/xmlstream.py,sha256=p9zjmPIaBSDFIb8a4Cgi6ReOIeDO4GllurTclNLljJc,9189\r\ntwisted/words/xish/xpath.py,sha256=KLvSEWoNXnD7ruqsATQYIy70cMFD7uXE8B7mp6xV3bY,9556\r\ntwisted/words/xish/xpathparser.g,sha256=eJQMsCzdX76niIJm8hHiLNLLqq4G6uJl6TDx9iPx6qk,18122\r\ntwisted/words/xish/xpathparser.py,sha256=iPE2dtF79_SU2i0GDQR9jW2Gc2UP6yWeJ_EEgPLCHwk,22851\r\ntwisted/words/xmpproutertap.py,sha256=n9oc9f4xelocf6NGS0_BreuRGbe9YBMpsdKuMjPrd8E,820\r\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/Twisted-19.7.0.dist-info/WHEEL",
"content": "Wheel-Version: 1.0\nGenerator: bdist_wheel (0.33.4)\nRoot-Is-Purelib: false\nTag: cp36-cp36m-manylinux1_x86_64\n\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/Twisted-19.7.0.dist-info/entry_points.txt",
"content": "[console_scripts]\ncftp = twisted.conch.scripts.cftp:run\nckeygen = twisted.conch.scripts.ckeygen:run\nconch = twisted.conch.scripts.conch:run\nmailmail = twisted.mail.scripts.mailmail:run\npyhtmlizer = twisted.scripts.htmlizer:run\ntkconch = twisted.conch.scripts.tkconch:run\ntrial = twisted.scripts.trial:run\ntwist = twisted.application.twist._twist:Twist.main\ntwistd = twisted.scripts.twistd:run\n\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/Twisted-19.7.0.dist-info/top_level.txt",
"content": "twisted\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/attr/__init__.py",
"content": "from __future__ import absolute_import, division, print_function\n\nfrom functools import partial\n\nfrom . import converters, exceptions, filters, validators\nfrom ._config import get_run_validators, set_run_validators\nfrom ._funcs import asdict, assoc, astuple, evolve, has\nfrom ._make import (\n NOTHING,\n Attribute,\n Factory,\n attrib,\n attrs,\n fields,\n fields_dict,\n make_class,\n validate,\n)\nfrom ._version_info import VersionInfo\n\n\n__version__ = \"19.3.0\"\n__version_info__ = VersionInfo._from_version_string(__version__)\n\n__title__ = \"attrs\"\n__description__ = \"Classes Without Boilerplate\"\n__url__ = \"https://www.attrs.org/\"\n__uri__ = __url__\n__doc__ = __description__ + \" <\" + __uri__ + \">\"\n\n__author__ = \"Hynek Schlawack\"\n__email__ = \"hs@ox.cx\"\n\n__license__ = \"MIT\"\n__copyright__ = \"Copyright (c) 2015 Hynek Schlawack\"\n\n\ns = attributes = attrs\nib = attr = attrib\ndataclass = partial(attrs, auto_attribs=True) # happy Easter ;)\n\n\n__all__ = [\n \"Attribute\",\n \"Factory\",\n \"NOTHING\",\n \"asdict\",\n \"assoc\",\n \"astuple\",\n \"attr\",\n \"attrib\",\n \"attributes\",\n \"attrs\",\n \"converters\",\n \"evolve\",\n \"exceptions\",\n \"fields\",\n \"fields_dict\",\n \"filters\",\n \"get_run_validators\",\n \"has\",\n \"ib\",\n \"make_class\",\n \"s\",\n \"set_run_validators\",\n \"validate\",\n \"validators\",\n]\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/attr/__init__.pyi",
"content": "from typing import (\n Any,\n Callable,\n Dict,\n Generic,\n List,\n Optional,\n Sequence,\n Mapping,\n Tuple,\n Type,\n TypeVar,\n Union,\n overload,\n)\n\n# `import X as X` is required to make these public\nfrom . import exceptions as exceptions\nfrom . import filters as filters\nfrom . import converters as converters\nfrom . import validators as validators\n\nfrom ._version_info import VersionInfo\n\n__version__: str\n__version_info__: VersionInfo\n__title__: str\n__description__: str\n__url__: str\n__uri__: str\n__author__: str\n__email__: str\n__license__: str\n__copyright__: str\n\n_T = TypeVar(\"_T\")\n_C = TypeVar(\"_C\", bound=type)\n\n_ValidatorType = Callable[[Any, Attribute[_T], _T], Any]\n_ConverterType = Callable[[Any], _T]\n_FilterType = Callable[[Attribute[_T], _T], bool]\n_ReprType = Callable[[Any], str]\n_ReprArgType = Union[bool, _ReprType]\n# FIXME: in reality, if multiple validators are passed they must be in a list or tuple,\n# but those are invariant and so would prevent subtypes of _ValidatorType from working\n# when passed in a list or tuple.\n_ValidatorArgType = Union[_ValidatorType[_T], Sequence[_ValidatorType[_T]]]\n\n# _make --\n\nNOTHING: object\n\n# NOTE: Factory lies about its return type to make this possible: `x: List[int] = Factory(list)`\n# Work around mypy issue #4554 in the common case by using an overload.\n@overload\ndef Factory(factory: Callable[[], _T]) -> _T: ...\n@overload\ndef Factory(\n factory: Union[Callable[[Any], _T], Callable[[], _T]],\n takes_self: bool = ...,\n) -> _T: ...\n\nclass Attribute(Generic[_T]):\n name: str\n default: Optional[_T]\n validator: Optional[_ValidatorType[_T]]\n repr: _ReprArgType\n cmp: bool\n eq: bool\n order: bool\n hash: Optional[bool]\n init: bool\n converter: Optional[_ConverterType[_T]]\n metadata: Dict[Any, Any]\n type: Optional[Type[_T]]\n kw_only: bool\n\n# NOTE: We had several choices for the annotation to use for type arg:\n# 1) Type[_T]\n# - Pros: Handles simple cases correctly\n# - Cons: Might produce less informative errors in the case of conflicting TypeVars\n# e.g. `attr.ib(default='bad', type=int)`\n# 2) Callable[..., _T]\n# - Pros: Better error messages than #1 for conflicting TypeVars\n# - Cons: Terrible error messages for validator checks.\n# e.g. attr.ib(type=int, validator=validate_str)\n# -> error: Cannot infer function type argument\n# 3) type (and do all of the work in the mypy plugin)\n# - Pros: Simple here, and we could customize the plugin with our own errors.\n# - Cons: Would need to write mypy plugin code to handle all the cases.\n# We chose option #1.\n\n# `attr` lies about its return type to make the following possible:\n# attr() -> Any\n# attr(8) -> int\n# attr(validator=) -> Whatever the callable expects.\n# This makes this type of assignments possible:\n# x: int = attr(8)\n#\n# This form catches explicit None or no default but with no other arguments returns Any.\n@overload\ndef attrib(\n default: None = ...,\n validator: None = ...,\n repr: _ReprArgType = ...,\n cmp: Optional[bool] = ...,\n hash: Optional[bool] = ...,\n init: bool = ...,\n metadata: Optional[Mapping[Any, Any]] = ...,\n type: None = ...,\n converter: None = ...,\n factory: None = ...,\n kw_only: bool = ...,\n eq: Optional[bool] = ...,\n order: Optional[bool] = ...,\n) -> Any: ...\n\n# This form catches an explicit None or no default and infers the type from the other arguments.\n@overload\ndef attrib(\n default: None = ...,\n validator: Optional[_ValidatorArgType[_T]] = ...,\n repr: _ReprArgType = ...,\n cmp: Optional[bool] = ...,\n hash: Optional[bool] = ...,\n init: bool = ...,\n metadata: Optional[Mapping[Any, Any]] = ...,\n type: Optional[Type[_T]] = ...,\n converter: Optional[_ConverterType[_T]] = ...,\n factory: Optional[Callable[[], _T]] = ...,\n kw_only: bool = ...,\n eq: Optional[bool] = ...,\n order: Optional[bool] = ...,\n) -> _T: ...\n\n# This form catches an explicit default argument.\n@overload\ndef attrib(\n default: _T,\n validator: Optional[_ValidatorArgType[_T]] = ...,\n repr: _ReprArgType = ...,\n cmp: Optional[bool] = ...,\n hash: Optional[bool] = ...,\n init: bool = ...,\n metadata: Optional[Mapping[Any, Any]] = ...,\n type: Optional[Type[_T]] = ...,\n converter: Optional[_ConverterType[_T]] = ...,\n factory: Optional[Callable[[], _T]] = ...,\n kw_only: bool = ...,\n eq: Optional[bool] = ...,\n order: Optional[bool] = ...,\n) -> _T: ...\n\n# This form covers type=non-Type: e.g. forward references (str), Any\n@overload\ndef attrib(\n default: Optional[_T] = ...,\n validator: Optional[_ValidatorArgType[_T]] = ...,\n repr: _ReprArgType = ...,\n cmp: Optional[bool] = ...,\n hash: Optional[bool] = ...,\n init: bool = ...,\n metadata: Optional[Mapping[Any, Any]] = ...,\n type: object = ...,\n converter: Optional[_ConverterType[_T]] = ...,\n factory: Optional[Callable[[], _T]] = ...,\n kw_only: bool = ...,\n eq: Optional[bool] = ...,\n order: Optional[bool] = ...,\n) -> Any: ...\n@overload\ndef attrs(\n maybe_cls: _C,\n these: Optional[Dict[str, Any]] = ...,\n repr_ns: Optional[str] = ...,\n repr: bool = ...,\n cmp: Optional[bool] = ...,\n hash: Optional[bool] = ...,\n init: bool = ...,\n slots: bool = ...,\n frozen: bool = ...,\n weakref_slot: bool = ...,\n str: bool = ...,\n auto_attribs: bool = ...,\n kw_only: bool = ...,\n cache_hash: bool = ...,\n auto_exc: bool = ...,\n eq: Optional[bool] = ...,\n order: Optional[bool] = ...,\n) -> _C: ...\n@overload\ndef attrs(\n maybe_cls: None = ...,\n these: Optional[Dict[str, Any]] = ...,\n repr_ns: Optional[str] = ...,\n repr: bool = ...,\n cmp: Optional[bool] = ...,\n hash: Optional[bool] = ...,\n init: bool = ...,\n slots: bool = ...,\n frozen: bool = ...,\n weakref_slot: bool = ...,\n str: bool = ...,\n auto_attribs: bool = ...,\n kw_only: bool = ...,\n cache_hash: bool = ...,\n auto_exc: bool = ...,\n eq: Optional[bool] = ...,\n order: Optional[bool] = ...,\n) -> Callable[[_C], _C]: ...\n\n# TODO: add support for returning NamedTuple from the mypy plugin\nclass _Fields(Tuple[Attribute[Any], ...]):\n def __getattr__(self, name: str) -> Attribute[Any]: ...\n\ndef fields(cls: type) -> _Fields: ...\ndef fields_dict(cls: type) -> Dict[str, Attribute[Any]]: ...\ndef validate(inst: Any) -> None: ...\n\n# TODO: add support for returning a proper attrs class from the mypy plugin\n# we use Any instead of _CountingAttr so that e.g. `make_class('Foo', [attr.ib()])` is valid\ndef make_class(\n name: str,\n attrs: Union[List[str], Tuple[str, ...], Dict[str, Any]],\n bases: Tuple[type, ...] = ...,\n repr_ns: Optional[str] = ...,\n repr: bool = ...,\n cmp: Optional[bool] = ...,\n hash: Optional[bool] = ...,\n init: bool = ...,\n slots: bool = ...,\n frozen: bool = ...,\n weakref_slot: bool = ...,\n str: bool = ...,\n auto_attribs: bool = ...,\n kw_only: bool = ...,\n cache_hash: bool = ...,\n auto_exc: bool = ...,\n eq: Optional[bool] = ...,\n order: Optional[bool] = ...,\n) -> type: ...\n\n# _funcs --\n\n# TODO: add support for returning TypedDict from the mypy plugin\n# FIXME: asdict/astuple do not honor their factory args. waiting on one of these:\n# https://github.com/python/mypy/issues/4236\n# https://github.com/python/typing/issues/253\ndef asdict(\n inst: Any,\n recurse: bool = ...,\n filter: Optional[_FilterType[Any]] = ...,\n dict_factory: Type[Mapping[Any, Any]] = ...,\n retain_collection_types: bool = ...,\n) -> Dict[str, Any]: ...\n\n# TODO: add support for returning NamedTuple from the mypy plugin\ndef astuple(\n inst: Any,\n recurse: bool = ...,\n filter: Optional[_FilterType[Any]] = ...,\n tuple_factory: Type[Sequence[Any]] = ...,\n retain_collection_types: bool = ...,\n) -> Tuple[Any, ...]: ...\ndef has(cls: type) -> bool: ...\ndef assoc(inst: _T, **changes: Any) -> _T: ...\ndef evolve(inst: _T, **changes: Any) -> _T: ...\n\n# _config --\n\ndef set_run_validators(run: bool) -> None: ...\ndef get_run_validators() -> bool: ...\n\n# aliases --\n\ns = attributes = attrs\nib = attr = attrib\ndataclass = attrs # Technically, partial(attrs, auto_attribs=True) ;)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/attr/_compat.py",
"content": "from __future__ import absolute_import, division, print_function\n\nimport platform\nimport sys\nimport types\nimport warnings\n\n\nPY2 = sys.version_info[0] == 2\nPYPY = platform.python_implementation() == \"PyPy\"\n\n\nif PYPY or sys.version_info[:2] >= (3, 6):\n ordered_dict = dict\nelse:\n from collections import OrderedDict\n\n ordered_dict = OrderedDict\n\n\nif PY2:\n from UserDict import IterableUserDict\n from collections import Mapping, Sequence\n\n # We 'bundle' isclass instead of using inspect as importing inspect is\n # fairly expensive (order of 10-15 ms for a modern machine in 2016)\n def isclass(klass):\n return isinstance(klass, (type, types.ClassType))\n\n # TYPE is used in exceptions, repr(int) is different on Python 2 and 3.\n TYPE = \"type\"\n\n def iteritems(d):\n return d.iteritems()\n\n # Python 2 is bereft of a read-only dict proxy, so we make one!\n class ReadOnlyDict(IterableUserDict):\n \"\"\"\n Best-effort read-only dict wrapper.\n \"\"\"\n\n def __setitem__(self, key, val):\n # We gently pretend we're a Python 3 mappingproxy.\n raise TypeError(\n \"'mappingproxy' object does not support item assignment\"\n )\n\n def update(self, _):\n # We gently pretend we're a Python 3 mappingproxy.\n raise AttributeError(\n \"'mappingproxy' object has no attribute 'update'\"\n )\n\n def __delitem__(self, _):\n # We gently pretend we're a Python 3 mappingproxy.\n raise TypeError(\n \"'mappingproxy' object does not support item deletion\"\n )\n\n def clear(self):\n # We gently pretend we're a Python 3 mappingproxy.\n raise AttributeError(\n \"'mappingproxy' object has no attribute 'clear'\"\n )\n\n def pop(self, key, default=None):\n # We gently pretend we're a Python 3 mappingproxy.\n raise AttributeError(\n \"'mappingproxy' object has no attribute 'pop'\"\n )\n\n def popitem(self):\n # We gently pretend we're a Python 3 mappingproxy.\n raise AttributeError(\n \"'mappingproxy' object has no attribute 'popitem'\"\n )\n\n def setdefault(self, key, default=None):\n # We gently pretend we're a Python 3 mappingproxy.\n raise AttributeError(\n \"'mappingproxy' object has no attribute 'setdefault'\"\n )\n\n def __repr__(self):\n # Override to be identical to the Python 3 version.\n return \"mappingproxy(\" + repr(self.data) + \")\"\n\n def metadata_proxy(d):\n res = ReadOnlyDict()\n res.data.update(d) # We blocked update, so we have to do it like this.\n return res\n\n def just_warn(*args, **kw): # pragma: nocover\n \"\"\"\n We only warn on Python 3 because we are not aware of any concrete\n consequences of not setting the cell on Python 2.\n \"\"\"\n\n\nelse: # Python 3 and later.\n from collections.abc import Mapping, Sequence # noqa\n\n def just_warn(*args, **kw):\n \"\"\"\n We only warn on Python 3 because we are not aware of any concrete\n consequences of not setting the cell on Python 2.\n \"\"\"\n warnings.warn(\n \"Running interpreter doesn't sufficiently support code object \"\n \"introspection. Some features like bare super() or accessing \"\n \"__class__ will not work with slotted classes.\",\n RuntimeWarning,\n stacklevel=2,\n )\n\n def isclass(klass):\n return isinstance(klass, type)\n\n TYPE = \"class\"\n\n def iteritems(d):\n return d.items()\n\n def metadata_proxy(d):\n return types.MappingProxyType(dict(d))\n\n\ndef make_set_closure_cell():\n \"\"\"Return a function of two arguments (cell, value) which sets\n the value stored in the closure cell `cell` to `value`.\n \"\"\"\n # pypy makes this easy. (It also supports the logic below, but\n # why not do the easy/fast thing?)\n if PYPY: # pragma: no cover\n\n def set_closure_cell(cell, value):\n cell.__setstate__((value,))\n\n return set_closure_cell\n\n # Otherwise gotta do it the hard way.\n\n # Create a function that will set its first cellvar to `value`.\n def set_first_cellvar_to(value):\n x = value\n return\n\n # This function will be eliminated as dead code, but\n # not before its reference to `x` forces `x` to be\n # represented as a closure cell rather than a local.\n def force_x_to_be_a_cell(): # pragma: no cover\n return x\n\n try:\n # Extract the code object and make sure our assumptions about\n # the closure behavior are correct.\n if PY2:\n co = set_first_cellvar_to.func_code\n else:\n co = set_first_cellvar_to.__code__\n if co.co_cellvars != (\"x\",) or co.co_freevars != ():\n raise AssertionError # pragma: no cover\n\n # Convert this code object to a code object that sets the\n # function's first _freevar_ (not cellvar) to the argument.\n if sys.version_info >= (3, 8):\n # CPython 3.8+ has an incompatible CodeType signature\n # (added a posonlyargcount argument) but also added\n # CodeType.replace() to do this without counting parameters.\n set_first_freevar_code = co.replace(\n co_cellvars=co.co_freevars, co_freevars=co.co_cellvars\n )\n else:\n args = [co.co_argcount]\n if not PY2:\n args.append(co.co_kwonlyargcount)\n args.extend(\n [\n co.co_nlocals,\n co.co_stacksize,\n co.co_flags,\n co.co_code,\n co.co_consts,\n co.co_names,\n co.co_varnames,\n co.co_filename,\n co.co_name,\n co.co_firstlineno,\n co.co_lnotab,\n # These two arguments are reversed:\n co.co_cellvars,\n co.co_freevars,\n ]\n )\n set_first_freevar_code = types.CodeType(*args)\n\n def set_closure_cell(cell, value):\n # Create a function using the set_first_freevar_code,\n # whose first closure cell is `cell`. Calling it will\n # change the value of that cell.\n setter = types.FunctionType(\n set_first_freevar_code, {}, \"setter\", (), (cell,)\n )\n # And call it to set the cell.\n setter(value)\n\n # Make sure it works on this interpreter:\n def make_func_with_cell():\n x = None\n\n def func():\n return x # pragma: no cover\n\n return func\n\n if PY2:\n cell = make_func_with_cell().func_closure[0]\n else:\n cell = make_func_with_cell().__closure__[0]\n set_closure_cell(cell, 100)\n if cell.cell_contents != 100:\n raise AssertionError # pragma: no cover\n\n except Exception:\n return just_warn\n else:\n return set_closure_cell\n\n\nset_closure_cell = make_set_closure_cell()\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/attr/_config.py",
"content": "from __future__ import absolute_import, division, print_function\n\n\n__all__ = [\"set_run_validators\", \"get_run_validators\"]\n\n_run_validators = True\n\n\ndef set_run_validators(run):\n \"\"\"\n Set whether or not validators are run. By default, they are run.\n \"\"\"\n if not isinstance(run, bool):\n raise TypeError(\"'run' must be bool.\")\n global _run_validators\n _run_validators = run\n\n\ndef get_run_validators():\n \"\"\"\n Return whether or not validators are run.\n \"\"\"\n return _run_validators\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/attr/_funcs.py",
"content": "from __future__ import absolute_import, division, print_function\n\nimport copy\n\nfrom ._compat import iteritems\nfrom ._make import NOTHING, _obj_setattr, fields\nfrom .exceptions import AttrsAttributeNotFoundError\n\n\ndef asdict(\n inst,\n recurse=True,\n filter=None,\n dict_factory=dict,\n retain_collection_types=False,\n):\n \"\"\"\n Return the ``attrs`` attribute values of *inst* as a dict.\n\n Optionally recurse into other ``attrs``-decorated classes.\n\n :param inst: Instance of an ``attrs``-decorated class.\n :param bool recurse: Recurse into classes that are also\n ``attrs``-decorated.\n :param callable filter: A callable whose return code determines whether an\n attribute or element is included (``True``) or dropped (``False``). Is\n called with the `attr.Attribute` as the first argument and the\n value as the second argument.\n :param callable dict_factory: A callable to produce dictionaries from. For\n example, to produce ordered dictionaries instead of normal Python\n dictionaries, pass in ``collections.OrderedDict``.\n :param bool retain_collection_types: Do not convert to ``list`` when\n encountering an attribute whose type is ``tuple`` or ``set``. Only\n meaningful if ``recurse`` is ``True``.\n\n :rtype: return type of *dict_factory*\n\n :raise attr.exceptions.NotAnAttrsClassError: If *cls* is not an ``attrs``\n class.\n\n .. versionadded:: 16.0.0 *dict_factory*\n .. versionadded:: 16.1.0 *retain_collection_types*\n \"\"\"\n attrs = fields(inst.__class__)\n rv = dict_factory()\n for a in attrs:\n v = getattr(inst, a.name)\n if filter is not None and not filter(a, v):\n continue\n if recurse is True:\n if has(v.__class__):\n rv[a.name] = asdict(\n v, True, filter, dict_factory, retain_collection_types\n )\n elif isinstance(v, (tuple, list, set)):\n cf = v.__class__ if retain_collection_types is True else list\n rv[a.name] = cf(\n [\n _asdict_anything(\n i, filter, dict_factory, retain_collection_types\n )\n for i in v\n ]\n )\n elif isinstance(v, dict):\n df = dict_factory\n rv[a.name] = df(\n (\n _asdict_anything(\n kk, filter, df, retain_collection_types\n ),\n _asdict_anything(\n vv, filter, df, retain_collection_types\n ),\n )\n for kk, vv in iteritems(v)\n )\n else:\n rv[a.name] = v\n else:\n rv[a.name] = v\n return rv\n\n\ndef _asdict_anything(val, filter, dict_factory, retain_collection_types):\n \"\"\"\n ``asdict`` only works on attrs instances, this works on anything.\n \"\"\"\n if getattr(val.__class__, \"__attrs_attrs__\", None) is not None:\n # Attrs class.\n rv = asdict(val, True, filter, dict_factory, retain_collection_types)\n elif isinstance(val, (tuple, list, set)):\n cf = val.__class__ if retain_collection_types is True else list\n rv = cf(\n [\n _asdict_anything(\n i, filter, dict_factory, retain_collection_types\n )\n for i in val\n ]\n )\n elif isinstance(val, dict):\n df = dict_factory\n rv = df(\n (\n _asdict_anything(kk, filter, df, retain_collection_types),\n _asdict_anything(vv, filter, df, retain_collection_types),\n )\n for kk, vv in iteritems(val)\n )\n else:\n rv = val\n return rv\n\n\ndef astuple(\n inst,\n recurse=True,\n filter=None,\n tuple_factory=tuple,\n retain_collection_types=False,\n):\n \"\"\"\n Return the ``attrs`` attribute values of *inst* as a tuple.\n\n Optionally recurse into other ``attrs``-decorated classes.\n\n :param inst: Instance of an ``attrs``-decorated class.\n :param bool recurse: Recurse into classes that are also\n ``attrs``-decorated.\n :param callable filter: A callable whose return code determines whether an\n attribute or element is included (``True``) or dropped (``False``). Is\n called with the `attr.Attribute` as the first argument and the\n value as the second argument.\n :param callable tuple_factory: A callable to produce tuples from. For\n example, to produce lists instead of tuples.\n :param bool retain_collection_types: Do not convert to ``list``\n or ``dict`` when encountering an attribute which type is\n ``tuple``, ``dict`` or ``set``. Only meaningful if ``recurse`` is\n ``True``.\n\n :rtype: return type of *tuple_factory*\n\n :raise attr.exceptions.NotAnAttrsClassError: If *cls* is not an ``attrs``\n class.\n\n .. versionadded:: 16.2.0\n \"\"\"\n attrs = fields(inst.__class__)\n rv = []\n retain = retain_collection_types # Very long. :/\n for a in attrs:\n v = getattr(inst, a.name)\n if filter is not None and not filter(a, v):\n continue\n if recurse is True:\n if has(v.__class__):\n rv.append(\n astuple(\n v,\n recurse=True,\n filter=filter,\n tuple_factory=tuple_factory,\n retain_collection_types=retain,\n )\n )\n elif isinstance(v, (tuple, list, set)):\n cf = v.__class__ if retain is True else list\n rv.append(\n cf(\n [\n astuple(\n j,\n recurse=True,\n filter=filter,\n tuple_factory=tuple_factory,\n retain_collection_types=retain,\n )\n if has(j.__class__)\n else j\n for j in v\n ]\n )\n )\n elif isinstance(v, dict):\n df = v.__class__ if retain is True else dict\n rv.append(\n df(\n (\n astuple(\n kk,\n tuple_factory=tuple_factory,\n retain_collection_types=retain,\n )\n if has(kk.__class__)\n else kk,\n astuple(\n vv,\n tuple_factory=tuple_factory,\n retain_collection_types=retain,\n )\n if has(vv.__class__)\n else vv,\n )\n for kk, vv in iteritems(v)\n )\n )\n else:\n rv.append(v)\n else:\n rv.append(v)\n return rv if tuple_factory is list else tuple_factory(rv)\n\n\ndef has(cls):\n \"\"\"\n Check whether *cls* is a class with ``attrs`` attributes.\n\n :param type cls: Class to introspect.\n :raise TypeError: If *cls* is not a class.\n\n :rtype: bool\n \"\"\"\n return getattr(cls, \"__attrs_attrs__\", None) is not None\n\n\ndef assoc(inst, **changes):\n \"\"\"\n Copy *inst* and apply *changes*.\n\n :param inst: Instance of a class with ``attrs`` attributes.\n :param changes: Keyword changes in the new copy.\n\n :return: A copy of inst with *changes* incorporated.\n\n :raise attr.exceptions.AttrsAttributeNotFoundError: If *attr_name* couldn't\n be found on *cls*.\n :raise attr.exceptions.NotAnAttrsClassError: If *cls* is not an ``attrs``\n class.\n\n .. deprecated:: 17.1.0\n Use `evolve` instead.\n \"\"\"\n import warnings\n\n warnings.warn(\n \"assoc is deprecated and will be removed after 2018/01.\",\n DeprecationWarning,\n stacklevel=2,\n )\n new = copy.copy(inst)\n attrs = fields(inst.__class__)\n for k, v in iteritems(changes):\n a = getattr(attrs, k, NOTHING)\n if a is NOTHING:\n raise AttrsAttributeNotFoundError(\n \"{k} is not an attrs attribute on {cl}.\".format(\n k=k, cl=new.__class__\n )\n )\n _obj_setattr(new, k, v)\n return new\n\n\ndef evolve(inst, **changes):\n \"\"\"\n Create a new instance, based on *inst* with *changes* applied.\n\n :param inst: Instance of a class with ``attrs`` attributes.\n :param changes: Keyword changes in the new copy.\n\n :return: A copy of inst with *changes* incorporated.\n\n :raise TypeError: If *attr_name* couldn't be found in the class\n ``__init__``.\n :raise attr.exceptions.NotAnAttrsClassError: If *cls* is not an ``attrs``\n class.\n\n .. versionadded:: 17.1.0\n \"\"\"\n cls = inst.__class__\n attrs = fields(cls)\n for a in attrs:\n if not a.init:\n continue\n attr_name = a.name # To deal with private attributes.\n init_name = attr_name if attr_name[0] != \"_\" else attr_name[1:]\n if init_name not in changes:\n changes[init_name] = getattr(inst, attr_name)\n return cls(**changes)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/attr/_make.py",
"content": "from __future__ import absolute_import, division, print_function\n\nimport copy\nimport linecache\nimport sys\nimport threading\nimport uuid\nimport warnings\n\nfrom operator import itemgetter\n\nfrom . import _config\nfrom ._compat import (\n PY2,\n isclass,\n iteritems,\n metadata_proxy,\n ordered_dict,\n set_closure_cell,\n)\nfrom .exceptions import (\n DefaultAlreadySetError,\n FrozenInstanceError,\n NotAnAttrsClassError,\n PythonTooOldError,\n UnannotatedAttributeError,\n)\n\n\n# This is used at least twice, so cache it here.\n_obj_setattr = object.__setattr__\n_init_converter_pat = \"__attr_converter_{}\"\n_init_factory_pat = \"__attr_factory_{}\"\n_tuple_property_pat = (\n \" {attr_name} = _attrs_property(_attrs_itemgetter({index}))\"\n)\n_classvar_prefixes = (\"typing.ClassVar\", \"t.ClassVar\", \"ClassVar\")\n# we don't use a double-underscore prefix because that triggers\n# name mangling when trying to create a slot for the field\n# (when slots=True)\n_hash_cache_field = \"_attrs_cached_hash\"\n\n_empty_metadata_singleton = metadata_proxy({})\n\n# Unique object for unequivocal getattr() defaults.\n_sentinel = object()\n\n\nclass _Nothing(object):\n \"\"\"\n Sentinel class to indicate the lack of a value when ``None`` is ambiguous.\n\n ``_Nothing`` is a singleton. There is only ever one of it.\n \"\"\"\n\n _singleton = None\n\n def __new__(cls):\n if _Nothing._singleton is None:\n _Nothing._singleton = super(_Nothing, cls).__new__(cls)\n return _Nothing._singleton\n\n def __repr__(self):\n return \"NOTHING\"\n\n\nNOTHING = _Nothing()\n\"\"\"\nSentinel to indicate the lack of a value when ``None`` is ambiguous.\n\"\"\"\n\n\ndef attrib(\n default=NOTHING,\n validator=None,\n repr=True,\n cmp=None,\n hash=None,\n init=True,\n metadata=None,\n type=None,\n converter=None,\n factory=None,\n kw_only=False,\n eq=None,\n order=None,\n):\n \"\"\"\n Create a new attribute on a class.\n\n .. warning::\n\n Does *not* do anything unless the class is also decorated with\n `attr.s`!\n\n :param default: A value that is used if an ``attrs``-generated ``__init__``\n is used and no value is passed while instantiating or the attribute is\n excluded using ``init=False``.\n\n If the value is an instance of `Factory`, its callable will be\n used to construct a new value (useful for mutable data types like lists\n or dicts).\n\n If a default is not set (or set manually to ``attr.NOTHING``), a value\n *must* be supplied when instantiating; otherwise a `TypeError`\n will be raised.\n\n The default can also be set using decorator notation as shown below.\n\n :type default: Any value\n\n :param callable factory: Syntactic sugar for\n ``default=attr.Factory(callable)``.\n\n :param validator: `callable` that is called by ``attrs``-generated\n ``__init__`` methods after the instance has been initialized. They\n receive the initialized instance, the `Attribute`, and the\n passed value.\n\n The return value is *not* inspected so the validator has to throw an\n exception itself.\n\n If a ``list`` is passed, its items are treated as validators and must\n all pass.\n\n Validators can be globally disabled and re-enabled using\n `get_run_validators`.\n\n The validator can also be set using decorator notation as shown below.\n\n :type validator: ``callable`` or a ``list`` of ``callable``\\\\ s.\n\n :param repr: Include this attribute in the generated ``__repr__``\n method. If ``True``, include the attribute; if ``False``, omit it. By\n default, the built-in ``repr()`` function is used. To override how the\n attribute value is formatted, pass a ``callable`` that takes a single\n value and returns a string. Note that the resulting string is used\n as-is, i.e. it will be used directly *instead* of calling ``repr()``\n (the default).\n :type repr: a ``bool`` or a ``callable`` to use a custom function.\n :param bool eq: If ``True`` (default), include this attribute in the\n generated ``__eq__`` and ``__ne__`` methods that check two instances\n for equality.\n :param bool order: If ``True`` (default), include this attributes in the\n generated ``__lt__``, ``__le__``, ``__gt__`` and ``__ge__`` methods.\n :param bool cmp: Setting to ``True`` is equivalent to setting ``eq=True,\n order=True``. Deprecated in favor of *eq* and *order*.\n :param hash: Include this attribute in the generated ``__hash__``\n method. If ``None`` (default), mirror *eq*'s value. This is the\n correct behavior according the Python spec. Setting this value to\n anything else than ``None`` is *discouraged*.\n :type hash: ``bool`` or ``None``\n :param bool init: Include this attribute in the generated ``__init__``\n method. It is possible to set this to ``False`` and set a default\n value. In that case this attributed is unconditionally initialized\n with the specified default value or factory.\n :param callable converter: `callable` that is called by\n ``attrs``-generated ``__init__`` methods to converter attribute's value\n to the desired format. It is given the passed-in value, and the\n returned value will be used as the new value of the attribute. The\n value is converted before being passed to the validator, if any.\n :param metadata: An arbitrary mapping, to be used by third-party\n components. See `extending_metadata`.\n :param type: The type of the attribute. In Python 3.6 or greater, the\n preferred method to specify the type is using a variable annotation\n (see `PEP 526 `_).\n This argument is provided for backward compatibility.\n Regardless of the approach used, the type will be stored on\n ``Attribute.type``.\n\n Please note that ``attrs`` doesn't do anything with this metadata by\n itself. You can use it as part of your own code or for\n `static type checking `.\n :param kw_only: Make this attribute keyword-only (Python 3+)\n in the generated ``__init__`` (if ``init`` is ``False``, this\n parameter is ignored).\n\n .. versionadded:: 15.2.0 *convert*\n .. versionadded:: 16.3.0 *metadata*\n .. versionchanged:: 17.1.0 *validator* can be a ``list`` now.\n .. versionchanged:: 17.1.0\n *hash* is ``None`` and therefore mirrors *eq* by default.\n .. versionadded:: 17.3.0 *type*\n .. deprecated:: 17.4.0 *convert*\n .. versionadded:: 17.4.0 *converter* as a replacement for the deprecated\n *convert* to achieve consistency with other noun-based arguments.\n .. versionadded:: 18.1.0\n ``factory=f`` is syntactic sugar for ``default=attr.Factory(f)``.\n .. versionadded:: 18.2.0 *kw_only*\n .. versionchanged:: 19.2.0 *convert* keyword argument removed\n .. versionchanged:: 19.2.0 *repr* also accepts a custom callable.\n .. deprecated:: 19.2.0 *cmp* Removal on or after 2021-06-01.\n .. versionadded:: 19.2.0 *eq* and *order*\n \"\"\"\n eq, order = _determine_eq_order(cmp, eq, order)\n\n if hash is not None and hash is not True and hash is not False:\n raise TypeError(\n \"Invalid value for hash. Must be True, False, or None.\"\n )\n\n if factory is not None:\n if default is not NOTHING:\n raise ValueError(\n \"The `default` and `factory` arguments are mutually \"\n \"exclusive.\"\n )\n if not callable(factory):\n raise ValueError(\"The `factory` argument must be a callable.\")\n default = Factory(factory)\n\n if metadata is None:\n metadata = {}\n\n return _CountingAttr(\n default=default,\n validator=validator,\n repr=repr,\n cmp=None,\n hash=hash,\n init=init,\n converter=converter,\n metadata=metadata,\n type=type,\n kw_only=kw_only,\n eq=eq,\n order=order,\n )\n\n\ndef _make_attr_tuple_class(cls_name, attr_names):\n \"\"\"\n Create a tuple subclass to hold `Attribute`s for an `attrs` class.\n\n The subclass is a bare tuple with properties for names.\n\n class MyClassAttributes(tuple):\n __slots__ = ()\n x = property(itemgetter(0))\n \"\"\"\n attr_class_name = \"{}Attributes\".format(cls_name)\n attr_class_template = [\n \"class {}(tuple):\".format(attr_class_name),\n \" __slots__ = ()\",\n ]\n if attr_names:\n for i, attr_name in enumerate(attr_names):\n attr_class_template.append(\n _tuple_property_pat.format(index=i, attr_name=attr_name)\n )\n else:\n attr_class_template.append(\" pass\")\n globs = {\"_attrs_itemgetter\": itemgetter, \"_attrs_property\": property}\n eval(compile(\"\\n\".join(attr_class_template), \"\", \"exec\"), globs)\n\n return globs[attr_class_name]\n\n\n# Tuple class for extracted attributes from a class definition.\n# `base_attrs` is a subset of `attrs`.\n_Attributes = _make_attr_tuple_class(\n \"_Attributes\",\n [\n # all attributes to build dunder methods for\n \"attrs\",\n # attributes that have been inherited\n \"base_attrs\",\n # map inherited attributes to their originating classes\n \"base_attrs_map\",\n ],\n)\n\n\ndef _is_class_var(annot):\n \"\"\"\n Check whether *annot* is a typing.ClassVar.\n\n The string comparison hack is used to avoid evaluating all string\n annotations which would put attrs-based classes at a performance\n disadvantage compared to plain old classes.\n \"\"\"\n return str(annot).startswith(_classvar_prefixes)\n\n\ndef _get_annotations(cls):\n \"\"\"\n Get annotations for *cls*.\n \"\"\"\n anns = getattr(cls, \"__annotations__\", None)\n if anns is None:\n return {}\n\n # Verify that the annotations aren't merely inherited.\n for base_cls in cls.__mro__[1:]:\n if anns is getattr(base_cls, \"__annotations__\", None):\n return {}\n\n return anns\n\n\ndef _counter_getter(e):\n \"\"\"\n Key function for sorting to avoid re-creating a lambda for every class.\n \"\"\"\n return e[1].counter\n\n\ndef _transform_attrs(cls, these, auto_attribs, kw_only):\n \"\"\"\n Transform all `_CountingAttr`s on a class into `Attribute`s.\n\n If *these* is passed, use that and don't look for them on the class.\n\n Return an `_Attributes`.\n \"\"\"\n cd = cls.__dict__\n anns = _get_annotations(cls)\n\n if these is not None:\n ca_list = [(name, ca) for name, ca in iteritems(these)]\n\n if not isinstance(these, ordered_dict):\n ca_list.sort(key=_counter_getter)\n elif auto_attribs is True:\n ca_names = {\n name\n for name, attr in cd.items()\n if isinstance(attr, _CountingAttr)\n }\n ca_list = []\n annot_names = set()\n for attr_name, type in anns.items():\n if _is_class_var(type):\n continue\n annot_names.add(attr_name)\n a = cd.get(attr_name, NOTHING)\n if not isinstance(a, _CountingAttr):\n if a is NOTHING:\n a = attrib()\n else:\n a = attrib(default=a)\n ca_list.append((attr_name, a))\n\n unannotated = ca_names - annot_names\n if len(unannotated) > 0:\n raise UnannotatedAttributeError(\n \"The following `attr.ib`s lack a type annotation: \"\n + \", \".join(\n sorted(unannotated, key=lambda n: cd.get(n).counter)\n )\n + \".\"\n )\n else:\n ca_list = sorted(\n (\n (name, attr)\n for name, attr in cd.items()\n if isinstance(attr, _CountingAttr)\n ),\n key=lambda e: e[1].counter,\n )\n\n own_attrs = [\n Attribute.from_counting_attr(\n name=attr_name, ca=ca, type=anns.get(attr_name)\n )\n for attr_name, ca in ca_list\n ]\n\n base_attrs = []\n base_attr_map = {} # A dictionary of base attrs to their classes.\n taken_attr_names = {a.name: a for a in own_attrs}\n\n # Traverse the MRO and collect attributes.\n for base_cls in cls.__mro__[1:-1]:\n sub_attrs = getattr(base_cls, \"__attrs_attrs__\", None)\n if sub_attrs is not None:\n for a in sub_attrs:\n prev_a = taken_attr_names.get(a.name)\n # Only add an attribute if it hasn't been defined before. This\n # allows for overwriting attribute definitions by subclassing.\n if prev_a is None:\n base_attrs.append(a)\n taken_attr_names[a.name] = a\n base_attr_map[a.name] = base_cls\n\n attr_names = [a.name for a in base_attrs + own_attrs]\n\n AttrsClass = _make_attr_tuple_class(cls.__name__, attr_names)\n\n if kw_only:\n own_attrs = [a._assoc(kw_only=True) for a in own_attrs]\n base_attrs = [a._assoc(kw_only=True) for a in base_attrs]\n\n attrs = AttrsClass(base_attrs + own_attrs)\n\n # Mandatory vs non-mandatory attr order only matters when they are part of\n # the __init__ signature and when they aren't kw_only (which are moved to\n # the end and can be mandatory or non-mandatory in any order, as they will\n # be specified as keyword args anyway). Check the order of those attrs:\n had_default = False\n for a in (a for a in attrs if a.init is not False and a.kw_only is False):\n if had_default is True and a.default is NOTHING:\n raise ValueError(\n \"No mandatory attributes allowed after an attribute with a \"\n \"default value or factory. Attribute in question: %r\" % (a,)\n )\n\n if had_default is False and a.default is not NOTHING:\n had_default = True\n\n return _Attributes((attrs, base_attrs, base_attr_map))\n\n\ndef _frozen_setattrs(self, name, value):\n \"\"\"\n Attached to frozen classes as __setattr__.\n \"\"\"\n raise FrozenInstanceError()\n\n\ndef _frozen_delattrs(self, name):\n \"\"\"\n Attached to frozen classes as __delattr__.\n \"\"\"\n raise FrozenInstanceError()\n\n\nclass _ClassBuilder(object):\n \"\"\"\n Iteratively build *one* class.\n \"\"\"\n\n __slots__ = (\n \"_cls\",\n \"_cls_dict\",\n \"_attrs\",\n \"_base_names\",\n \"_attr_names\",\n \"_slots\",\n \"_frozen\",\n \"_weakref_slot\",\n \"_cache_hash\",\n \"_has_post_init\",\n \"_delete_attribs\",\n \"_base_attr_map\",\n \"_is_exc\",\n )\n\n def __init__(\n self,\n cls,\n these,\n slots,\n frozen,\n weakref_slot,\n auto_attribs,\n kw_only,\n cache_hash,\n is_exc,\n ):\n attrs, base_attrs, base_map = _transform_attrs(\n cls, these, auto_attribs, kw_only\n )\n\n self._cls = cls\n self._cls_dict = dict(cls.__dict__) if slots else {}\n self._attrs = attrs\n self._base_names = set(a.name for a in base_attrs)\n self._base_attr_map = base_map\n self._attr_names = tuple(a.name for a in attrs)\n self._slots = slots\n self._frozen = frozen or _has_frozen_base_class(cls)\n self._weakref_slot = weakref_slot\n self._cache_hash = cache_hash\n self._has_post_init = bool(getattr(cls, \"__attrs_post_init__\", False))\n self._delete_attribs = not bool(these)\n self._is_exc = is_exc\n\n self._cls_dict[\"__attrs_attrs__\"] = self._attrs\n\n if frozen:\n self._cls_dict[\"__setattr__\"] = _frozen_setattrs\n self._cls_dict[\"__delattr__\"] = _frozen_delattrs\n\n def __repr__(self):\n return \"<_ClassBuilder(cls={cls})>\".format(cls=self._cls.__name__)\n\n def build_class(self):\n \"\"\"\n Finalize class based on the accumulated configuration.\n\n Builder cannot be used after calling this method.\n \"\"\"\n if self._slots is True:\n return self._create_slots_class()\n else:\n return self._patch_original_class()\n\n def _patch_original_class(self):\n \"\"\"\n Apply accumulated methods and return the class.\n \"\"\"\n cls = self._cls\n base_names = self._base_names\n\n # Clean class of attribute definitions (`attr.ib()`s).\n if self._delete_attribs:\n for name in self._attr_names:\n if (\n name not in base_names\n and getattr(cls, name, _sentinel) is not _sentinel\n ):\n try:\n delattr(cls, name)\n except AttributeError:\n # This can happen if a base class defines a class\n # variable and we want to set an attribute with the\n # same name by using only a type annotation.\n pass\n\n # Attach our dunder methods.\n for name, value in self._cls_dict.items():\n setattr(cls, name, value)\n\n # Attach __setstate__. This is necessary to clear the hash code\n # cache on deserialization. See issue\n # https://github.com/python-attrs/attrs/issues/482 .\n # Note that this code only handles setstate for dict classes.\n # For slotted classes, see similar code in _create_slots_class .\n if self._cache_hash:\n existing_set_state_method = getattr(cls, \"__setstate__\", None)\n if existing_set_state_method:\n raise NotImplementedError(\n \"Currently you cannot use hash caching if \"\n \"you specify your own __setstate__ method.\"\n \"See https://github.com/python-attrs/attrs/issues/494 .\"\n )\n\n def cache_hash_set_state(chss_self, _):\n # clear hash code cache\n setattr(chss_self, _hash_cache_field, None)\n\n setattr(cls, \"__setstate__\", cache_hash_set_state)\n\n return cls\n\n def _create_slots_class(self):\n \"\"\"\n Build and return a new class with a `__slots__` attribute.\n \"\"\"\n base_names = self._base_names\n cd = {\n k: v\n for k, v in iteritems(self._cls_dict)\n if k not in tuple(self._attr_names) + (\"__dict__\", \"__weakref__\")\n }\n\n weakref_inherited = False\n\n # Traverse the MRO to check for an existing __weakref__.\n for base_cls in self._cls.__mro__[1:-1]:\n if \"__weakref__\" in getattr(base_cls, \"__dict__\", ()):\n weakref_inherited = True\n break\n\n names = self._attr_names\n if (\n self._weakref_slot\n and \"__weakref__\" not in getattr(self._cls, \"__slots__\", ())\n and \"__weakref__\" not in names\n and not weakref_inherited\n ):\n names += (\"__weakref__\",)\n\n # We only add the names of attributes that aren't inherited.\n # Settings __slots__ to inherited attributes wastes memory.\n slot_names = [name for name in names if name not in base_names]\n if self._cache_hash:\n slot_names.append(_hash_cache_field)\n cd[\"__slots__\"] = tuple(slot_names)\n\n qualname = getattr(self._cls, \"__qualname__\", None)\n if qualname is not None:\n cd[\"__qualname__\"] = qualname\n\n # __weakref__ is not writable.\n state_attr_names = tuple(\n an for an in self._attr_names if an != \"__weakref__\"\n )\n\n def slots_getstate(self):\n \"\"\"\n Automatically created by attrs.\n \"\"\"\n return tuple(getattr(self, name) for name in state_attr_names)\n\n hash_caching_enabled = self._cache_hash\n\n def slots_setstate(self, state):\n \"\"\"\n Automatically created by attrs.\n \"\"\"\n __bound_setattr = _obj_setattr.__get__(self, Attribute)\n for name, value in zip(state_attr_names, state):\n __bound_setattr(name, value)\n # Clearing the hash code cache on deserialization is needed\n # because hash codes can change from run to run. See issue\n # https://github.com/python-attrs/attrs/issues/482 .\n # Note that this code only handles setstate for slotted classes.\n # For dict classes, see similar code in _patch_original_class .\n if hash_caching_enabled:\n __bound_setattr(_hash_cache_field, None)\n\n # slots and frozen require __getstate__/__setstate__ to work\n cd[\"__getstate__\"] = slots_getstate\n cd[\"__setstate__\"] = slots_setstate\n\n # Create new class based on old class and our methods.\n cls = type(self._cls)(self._cls.__name__, self._cls.__bases__, cd)\n\n # The following is a fix for\n # https://github.com/python-attrs/attrs/issues/102. On Python 3,\n # if a method mentions `__class__` or uses the no-arg super(), the\n # compiler will bake a reference to the class in the method itself\n # as `method.__closure__`. Since we replace the class with a\n # clone, we rewrite these references so it keeps working.\n for item in cls.__dict__.values():\n if isinstance(item, (classmethod, staticmethod)):\n # Class- and staticmethods hide their functions inside.\n # These might need to be rewritten as well.\n closure_cells = getattr(item.__func__, \"__closure__\", None)\n else:\n closure_cells = getattr(item, \"__closure__\", None)\n\n if not closure_cells: # Catch None or the empty list.\n continue\n for cell in closure_cells:\n if cell.cell_contents is self._cls:\n set_closure_cell(cell, cls)\n\n return cls\n\n def add_repr(self, ns):\n self._cls_dict[\"__repr__\"] = self._add_method_dunders(\n _make_repr(self._attrs, ns=ns)\n )\n return self\n\n def add_str(self):\n repr = self._cls_dict.get(\"__repr__\")\n if repr is None:\n raise ValueError(\n \"__str__ can only be generated if a __repr__ exists.\"\n )\n\n def __str__(self):\n return self.__repr__()\n\n self._cls_dict[\"__str__\"] = self._add_method_dunders(__str__)\n return self\n\n def make_unhashable(self):\n self._cls_dict[\"__hash__\"] = None\n return self\n\n def add_hash(self):\n self._cls_dict[\"__hash__\"] = self._add_method_dunders(\n _make_hash(\n self._cls,\n self._attrs,\n frozen=self._frozen,\n cache_hash=self._cache_hash,\n )\n )\n\n return self\n\n def add_init(self):\n self._cls_dict[\"__init__\"] = self._add_method_dunders(\n _make_init(\n self._cls,\n self._attrs,\n self._has_post_init,\n self._frozen,\n self._slots,\n self._cache_hash,\n self._base_attr_map,\n self._is_exc,\n )\n )\n\n return self\n\n def add_eq(self):\n cd = self._cls_dict\n\n cd[\"__eq__\"], cd[\"__ne__\"] = (\n self._add_method_dunders(meth)\n for meth in _make_eq(self._cls, self._attrs)\n )\n\n return self\n\n def add_order(self):\n cd = self._cls_dict\n\n cd[\"__lt__\"], cd[\"__le__\"], cd[\"__gt__\"], cd[\"__ge__\"] = (\n self._add_method_dunders(meth)\n for meth in _make_order(self._cls, self._attrs)\n )\n\n return self\n\n def _add_method_dunders(self, method):\n \"\"\"\n Add __module__ and __qualname__ to a *method* if possible.\n \"\"\"\n try:\n method.__module__ = self._cls.__module__\n except AttributeError:\n pass\n\n try:\n method.__qualname__ = \".\".join(\n (self._cls.__qualname__, method.__name__)\n )\n except AttributeError:\n pass\n\n return method\n\n\n_CMP_DEPRECATION = (\n \"The usage of `cmp` is deprecated and will be removed on or after \"\n \"2021-06-01. Please use `eq` and `order` instead.\"\n)\n\n\ndef _determine_eq_order(cmp, eq, order):\n \"\"\"\n Validate the combination of *cmp*, *eq*, and *order*. Derive the effective\n values of eq and order.\n \"\"\"\n if cmp is not None and any((eq is not None, order is not None)):\n raise ValueError(\"Don't mix `cmp` with `eq' and `order`.\")\n\n # cmp takes precedence due to bw-compatibility.\n if cmp is not None:\n warnings.warn(_CMP_DEPRECATION, DeprecationWarning, stacklevel=3)\n\n return cmp, cmp\n\n # If left None, equality is on and ordering mirrors equality.\n if eq is None:\n eq = True\n\n if order is None:\n order = eq\n\n if eq is False and order is True:\n raise ValueError(\"`order` can only be True if `eq` is True too.\")\n\n return eq, order\n\n\ndef attrs(\n maybe_cls=None,\n these=None,\n repr_ns=None,\n repr=True,\n cmp=None,\n hash=None,\n init=True,\n slots=False,\n frozen=False,\n weakref_slot=True,\n str=False,\n auto_attribs=False,\n kw_only=False,\n cache_hash=False,\n auto_exc=False,\n eq=None,\n order=None,\n):\n r\"\"\"\n A class decorator that adds `dunder\n `_\\ -methods according to the\n specified attributes using `attr.ib` or the *these* argument.\n\n :param these: A dictionary of name to `attr.ib` mappings. This is\n useful to avoid the definition of your attributes within the class body\n because you can't (e.g. if you want to add ``__repr__`` methods to\n Django models) or don't want to.\n\n If *these* is not ``None``, ``attrs`` will *not* search the class body\n for attributes and will *not* remove any attributes from it.\n\n If *these* is an ordered dict (`dict` on Python 3.6+,\n `collections.OrderedDict` otherwise), the order is deduced from\n the order of the attributes inside *these*. Otherwise the order\n of the definition of the attributes is used.\n\n :type these: `dict` of `str` to `attr.ib`\n\n :param str repr_ns: When using nested classes, there's no way in Python 2\n to automatically detect that. Therefore it's possible to set the\n namespace explicitly for a more meaningful ``repr`` output.\n :param bool repr: Create a ``__repr__`` method with a human readable\n representation of ``attrs`` attributes..\n :param bool str: Create a ``__str__`` method that is identical to\n ``__repr__``. This is usually not necessary except for\n `Exception`\\ s.\n :param bool eq: If ``True`` or ``None`` (default), add ``__eq__`` and\n ``__ne__`` methods that check two instances for equality.\n\n They compare the instances as if they were tuples of their ``attrs``\n attributes, but only iff the types of both classes are *identical*!\n :type eq: `bool` or `None`\n :param bool order: If ``True``, add ``__lt__``, ``__le__``, ``__gt__``,\n and ``__ge__`` methods that behave like *eq* above and allow instances\n to be ordered. If ``None`` (default) mirror value of *eq*.\n :type order: `bool` or `None`\n :param cmp: Setting to ``True`` is equivalent to setting ``eq=True,\n order=True``. Deprecated in favor of *eq* and *order*, has precedence\n over them for backward-compatibility though. Must not be mixed with\n *eq* or *order*.\n :type cmp: `bool` or `None`\n :param hash: If ``None`` (default), the ``__hash__`` method is generated\n according how *eq* and *frozen* are set.\n\n 1. If *both* are True, ``attrs`` will generate a ``__hash__`` for you.\n 2. If *eq* is True and *frozen* is False, ``__hash__`` will be set to\n None, marking it unhashable (which it is).\n 3. If *eq* is False, ``__hash__`` will be left untouched meaning the\n ``__hash__`` method of the base class will be used (if base class is\n ``object``, this means it will fall back to id-based hashing.).\n\n Although not recommended, you can decide for yourself and force\n ``attrs`` to create one (e.g. if the class is immutable even though you\n didn't freeze it programmatically) by passing ``True`` or not. Both of\n these cases are rather special and should be used carefully.\n\n See our documentation on `hashing`, Python's documentation on\n `object.__hash__`, and the `GitHub issue that led to the default \\\n behavior `_ for more\n details.\n :type hash: ``bool`` or ``None``\n :param bool init: Create a ``__init__`` method that initializes the\n ``attrs`` attributes. Leading underscores are stripped for the\n argument name. If a ``__attrs_post_init__`` method exists on the\n class, it will be called after the class is fully initialized.\n :param bool slots: Create a `slotted class ` that's more\n memory-efficient.\n :param bool frozen: Make instances immutable after initialization. If\n someone attempts to modify a frozen instance,\n `attr.exceptions.FrozenInstanceError` is raised.\n\n Please note:\n\n 1. This is achieved by installing a custom ``__setattr__`` method\n on your class, so you can't implement your own.\n\n 2. True immutability is impossible in Python.\n\n 3. This *does* have a minor a runtime performance `impact\n ` when initializing new instances. In other words:\n ``__init__`` is slightly slower with ``frozen=True``.\n\n 4. If a class is frozen, you cannot modify ``self`` in\n ``__attrs_post_init__`` or a self-written ``__init__``. You can\n circumvent that limitation by using\n ``object.__setattr__(self, \"attribute_name\", value)``.\n\n :param bool weakref_slot: Make instances weak-referenceable. This has no\n effect unless ``slots`` is also enabled.\n :param bool auto_attribs: If True, collect `PEP 526`_-annotated attributes\n (Python 3.6 and later only) from the class body.\n\n In this case, you **must** annotate every field. If ``attrs``\n encounters a field that is set to an `attr.ib` but lacks a type\n annotation, an `attr.exceptions.UnannotatedAttributeError` is\n raised. Use ``field_name: typing.Any = attr.ib(...)`` if you don't\n want to set a type.\n\n If you assign a value to those attributes (e.g. ``x: int = 42``), that\n value becomes the default value like if it were passed using\n ``attr.ib(default=42)``. Passing an instance of `Factory` also\n works as expected.\n\n Attributes annotated as `typing.ClassVar`, and attributes that are\n neither annotated nor set to an `attr.ib` are **ignored**.\n\n .. _`PEP 526`: https://www.python.org/dev/peps/pep-0526/\n :param bool kw_only: Make all attributes keyword-only (Python 3+)\n in the generated ``__init__`` (if ``init`` is ``False``, this\n parameter is ignored).\n :param bool cache_hash: Ensure that the object's hash code is computed\n only once and stored on the object. If this is set to ``True``,\n hashing must be either explicitly or implicitly enabled for this\n class. If the hash code is cached, avoid any reassignments of\n fields involved in hash code computation or mutations of the objects\n those fields point to after object creation. If such changes occur,\n the behavior of the object's hash code is undefined.\n :param bool auto_exc: If the class subclasses `BaseException`\n (which implicitly includes any subclass of any exception), the\n following happens to behave like a well-behaved Python exceptions\n class:\n\n - the values for *eq*, *order*, and *hash* are ignored and the\n instances compare and hash by the instance's ids (N.B. ``attrs`` will\n *not* remove existing implementations of ``__hash__`` or the equality\n methods. It just won't add own ones.),\n - all attributes that are either passed into ``__init__`` or have a\n default value are additionally available as a tuple in the ``args``\n attribute,\n - the value of *str* is ignored leaving ``__str__`` to base classes.\n\n .. versionadded:: 16.0.0 *slots*\n .. versionadded:: 16.1.0 *frozen*\n .. versionadded:: 16.3.0 *str*\n .. versionadded:: 16.3.0 Support for ``__attrs_post_init__``.\n .. versionchanged:: 17.1.0\n *hash* supports ``None`` as value which is also the default now.\n .. versionadded:: 17.3.0 *auto_attribs*\n .. versionchanged:: 18.1.0\n If *these* is passed, no attributes are deleted from the class body.\n .. versionchanged:: 18.1.0 If *these* is ordered, the order is retained.\n .. versionadded:: 18.2.0 *weakref_slot*\n .. deprecated:: 18.2.0\n ``__lt__``, ``__le__``, ``__gt__``, and ``__ge__`` now raise a\n `DeprecationWarning` if the classes compared are subclasses of\n each other. ``__eq`` and ``__ne__`` never tried to compared subclasses\n to each other.\n .. versionchanged:: 19.2.0\n ``__lt__``, ``__le__``, ``__gt__``, and ``__ge__`` now do not consider\n subclasses comparable anymore.\n .. versionadded:: 18.2.0 *kw_only*\n .. versionadded:: 18.2.0 *cache_hash*\n .. versionadded:: 19.1.0 *auto_exc*\n .. deprecated:: 19.2.0 *cmp* Removal on or after 2021-06-01.\n .. versionadded:: 19.2.0 *eq* and *order*\n \"\"\"\n eq, order = _determine_eq_order(cmp, eq, order)\n\n def wrap(cls):\n\n if getattr(cls, \"__class__\", None) is None:\n raise TypeError(\"attrs only works with new-style classes.\")\n\n is_exc = auto_exc is True and issubclass(cls, BaseException)\n\n builder = _ClassBuilder(\n cls,\n these,\n slots,\n frozen,\n weakref_slot,\n auto_attribs,\n kw_only,\n cache_hash,\n is_exc,\n )\n\n if repr is True:\n builder.add_repr(repr_ns)\n if str is True:\n builder.add_str()\n if eq is True and not is_exc:\n builder.add_eq()\n if order is True and not is_exc:\n builder.add_order()\n\n if hash is not True and hash is not False and hash is not None:\n # Can't use `hash in` because 1 == True for example.\n raise TypeError(\n \"Invalid value for hash. Must be True, False, or None.\"\n )\n elif hash is False or (hash is None and eq is False) or is_exc:\n # Don't do anything. Should fall back to __object__'s __hash__\n # which is by id.\n if cache_hash:\n raise TypeError(\n \"Invalid value for cache_hash. To use hash caching,\"\n \" hashing must be either explicitly or implicitly \"\n \"enabled.\"\n )\n elif hash is True or (hash is None and eq is True and frozen is True):\n # Build a __hash__ if told so, or if it's safe.\n builder.add_hash()\n else:\n # Raise TypeError on attempts to hash.\n if cache_hash:\n raise TypeError(\n \"Invalid value for cache_hash. To use hash caching,\"\n \" hashing must be either explicitly or implicitly \"\n \"enabled.\"\n )\n builder.make_unhashable()\n\n if init is True:\n builder.add_init()\n else:\n if cache_hash:\n raise TypeError(\n \"Invalid value for cache_hash. To use hash caching,\"\n \" init must be True.\"\n )\n\n return builder.build_class()\n\n # maybe_cls's type depends on the usage of the decorator. It's a class\n # if it's used as `@attrs` but ``None`` if used as `@attrs()`.\n if maybe_cls is None:\n return wrap\n else:\n return wrap(maybe_cls)\n\n\n_attrs = attrs\n\"\"\"\nInternal alias so we can use it in functions that take an argument called\n*attrs*.\n\"\"\"\n\n\nif PY2:\n\n def _has_frozen_base_class(cls):\n \"\"\"\n Check whether *cls* has a frozen ancestor by looking at its\n __setattr__.\n \"\"\"\n return (\n getattr(cls.__setattr__, \"__module__\", None)\n == _frozen_setattrs.__module__\n and cls.__setattr__.__name__ == _frozen_setattrs.__name__\n )\n\n\nelse:\n\n def _has_frozen_base_class(cls):\n \"\"\"\n Check whether *cls* has a frozen ancestor by looking at its\n __setattr__.\n \"\"\"\n return cls.__setattr__ == _frozen_setattrs\n\n\ndef _attrs_to_tuple(obj, attrs):\n \"\"\"\n Create a tuple of all values of *obj*'s *attrs*.\n \"\"\"\n return tuple(getattr(obj, a.name) for a in attrs)\n\n\ndef _generate_unique_filename(cls, func_name):\n \"\"\"\n Create a \"filename\" suitable for a function being generated.\n \"\"\"\n unique_id = uuid.uuid4()\n extra = \"\"\n count = 1\n\n while True:\n unique_filename = \"\".format(\n func_name,\n cls.__module__,\n getattr(cls, \"__qualname__\", cls.__name__),\n extra,\n )\n # To handle concurrency we essentially \"reserve\" our spot in\n # the linecache with a dummy line. The caller can then\n # set this value correctly.\n cache_line = (1, None, (str(unique_id),), unique_filename)\n if (\n linecache.cache.setdefault(unique_filename, cache_line)\n == cache_line\n ):\n return unique_filename\n\n # Looks like this spot is taken. Try again.\n count += 1\n extra = \"-{0}\".format(count)\n\n\ndef _make_hash(cls, attrs, frozen, cache_hash):\n attrs = tuple(\n a for a in attrs if a.hash is True or (a.hash is None and a.eq is True)\n )\n\n tab = \" \"\n\n unique_filename = _generate_unique_filename(cls, \"hash\")\n type_hash = hash(unique_filename)\n\n method_lines = [\"def __hash__(self):\"]\n\n def append_hash_computation_lines(prefix, indent):\n \"\"\"\n Generate the code for actually computing the hash code.\n Below this will either be returned directly or used to compute\n a value which is then cached, depending on the value of cache_hash\n \"\"\"\n method_lines.extend(\n [indent + prefix + \"hash((\", indent + \" %d,\" % (type_hash,)]\n )\n\n for a in attrs:\n method_lines.append(indent + \" self.%s,\" % a.name)\n\n method_lines.append(indent + \" ))\")\n\n if cache_hash:\n method_lines.append(tab + \"if self.%s is None:\" % _hash_cache_field)\n if frozen:\n append_hash_computation_lines(\n \"object.__setattr__(self, '%s', \" % _hash_cache_field, tab * 2\n )\n method_lines.append(tab * 2 + \")\") # close __setattr__\n else:\n append_hash_computation_lines(\n \"self.%s = \" % _hash_cache_field, tab * 2\n )\n method_lines.append(tab + \"return self.%s\" % _hash_cache_field)\n else:\n append_hash_computation_lines(\"return \", tab)\n\n script = \"\\n\".join(method_lines)\n globs = {}\n locs = {}\n bytecode = compile(script, unique_filename, \"exec\")\n eval(bytecode, globs, locs)\n\n # In order of debuggers like PDB being able to step through the code,\n # we add a fake linecache entry.\n linecache.cache[unique_filename] = (\n len(script),\n None,\n script.splitlines(True),\n unique_filename,\n )\n\n return locs[\"__hash__\"]\n\n\ndef _add_hash(cls, attrs):\n \"\"\"\n Add a hash method to *cls*.\n \"\"\"\n cls.__hash__ = _make_hash(cls, attrs, frozen=False, cache_hash=False)\n return cls\n\n\ndef __ne__(self, other):\n \"\"\"\n Check equality and either forward a NotImplemented or return the result\n negated.\n \"\"\"\n result = self.__eq__(other)\n if result is NotImplemented:\n return NotImplemented\n\n return not result\n\n\ndef _make_eq(cls, attrs):\n attrs = [a for a in attrs if a.eq]\n\n unique_filename = _generate_unique_filename(cls, \"eq\")\n lines = [\n \"def __eq__(self, other):\",\n \" if other.__class__ is not self.__class__:\",\n \" return NotImplemented\",\n ]\n # We can't just do a big self.x = other.x and... clause due to\n # irregularities like nan == nan is false but (nan,) == (nan,) is true.\n if attrs:\n lines.append(\" return (\")\n others = [\" ) == (\"]\n for a in attrs:\n lines.append(\" self.%s,\" % (a.name,))\n others.append(\" other.%s,\" % (a.name,))\n\n lines += others + [\" )\"]\n else:\n lines.append(\" return True\")\n\n script = \"\\n\".join(lines)\n globs = {}\n locs = {}\n bytecode = compile(script, unique_filename, \"exec\")\n eval(bytecode, globs, locs)\n\n # In order of debuggers like PDB being able to step through the code,\n # we add a fake linecache entry.\n linecache.cache[unique_filename] = (\n len(script),\n None,\n script.splitlines(True),\n unique_filename,\n )\n return locs[\"__eq__\"], __ne__\n\n\ndef _make_order(cls, attrs):\n attrs = [a for a in attrs if a.order]\n\n def attrs_to_tuple(obj):\n \"\"\"\n Save us some typing.\n \"\"\"\n return _attrs_to_tuple(obj, attrs)\n\n def __lt__(self, other):\n \"\"\"\n Automatically created by attrs.\n \"\"\"\n if other.__class__ is self.__class__:\n return attrs_to_tuple(self) < attrs_to_tuple(other)\n\n return NotImplemented\n\n def __le__(self, other):\n \"\"\"\n Automatically created by attrs.\n \"\"\"\n if other.__class__ is self.__class__:\n return attrs_to_tuple(self) <= attrs_to_tuple(other)\n\n return NotImplemented\n\n def __gt__(self, other):\n \"\"\"\n Automatically created by attrs.\n \"\"\"\n if other.__class__ is self.__class__:\n return attrs_to_tuple(self) > attrs_to_tuple(other)\n\n return NotImplemented\n\n def __ge__(self, other):\n \"\"\"\n Automatically created by attrs.\n \"\"\"\n if other.__class__ is self.__class__:\n return attrs_to_tuple(self) >= attrs_to_tuple(other)\n\n return NotImplemented\n\n return __lt__, __le__, __gt__, __ge__\n\n\ndef _add_eq(cls, attrs=None):\n \"\"\"\n Add equality methods to *cls* with *attrs*.\n \"\"\"\n if attrs is None:\n attrs = cls.__attrs_attrs__\n\n cls.__eq__, cls.__ne__ = _make_eq(cls, attrs)\n\n return cls\n\n\n_already_repring = threading.local()\n\n\ndef _make_repr(attrs, ns):\n \"\"\"\n Make a repr method that includes relevant *attrs*, adding *ns* to the full\n name.\n \"\"\"\n\n # Figure out which attributes to include, and which function to use to\n # format them. The a.repr value can be either bool or a custom callable.\n attr_names_with_reprs = tuple(\n (a.name, repr if a.repr is True else a.repr)\n for a in attrs\n if a.repr is not False\n )\n\n def __repr__(self):\n \"\"\"\n Automatically created by attrs.\n \"\"\"\n try:\n working_set = _already_repring.working_set\n except AttributeError:\n working_set = set()\n _already_repring.working_set = working_set\n\n if id(self) in working_set:\n return \"...\"\n real_cls = self.__class__\n if ns is None:\n qualname = getattr(real_cls, \"__qualname__\", None)\n if qualname is not None:\n class_name = qualname.rsplit(\">.\", 1)[-1]\n else:\n class_name = real_cls.__name__\n else:\n class_name = ns + \".\" + real_cls.__name__\n\n # Since 'self' remains on the stack (i.e.: strongly referenced) for the\n # duration of this call, it's safe to depend on id(...) stability, and\n # not need to track the instance and therefore worry about properties\n # like weakref- or hash-ability.\n working_set.add(id(self))\n try:\n result = [class_name, \"(\"]\n first = True\n for name, attr_repr in attr_names_with_reprs:\n if first:\n first = False\n else:\n result.append(\", \")\n result.extend(\n (name, \"=\", attr_repr(getattr(self, name, NOTHING)))\n )\n return \"\".join(result) + \")\"\n finally:\n working_set.remove(id(self))\n\n return __repr__\n\n\ndef _add_repr(cls, ns=None, attrs=None):\n \"\"\"\n Add a repr method to *cls*.\n \"\"\"\n if attrs is None:\n attrs = cls.__attrs_attrs__\n\n cls.__repr__ = _make_repr(attrs, ns)\n return cls\n\n\ndef _make_init(\n cls, attrs, post_init, frozen, slots, cache_hash, base_attr_map, is_exc\n):\n attrs = [a for a in attrs if a.init or a.default is not NOTHING]\n\n unique_filename = _generate_unique_filename(cls, \"init\")\n\n script, globs, annotations = _attrs_to_init_script(\n attrs, frozen, slots, post_init, cache_hash, base_attr_map, is_exc\n )\n locs = {}\n bytecode = compile(script, unique_filename, \"exec\")\n attr_dict = dict((a.name, a) for a in attrs)\n globs.update({\"NOTHING\": NOTHING, \"attr_dict\": attr_dict})\n\n if frozen is True:\n # Save the lookup overhead in __init__ if we need to circumvent\n # immutability.\n globs[\"_cached_setattr\"] = _obj_setattr\n\n eval(bytecode, globs, locs)\n\n # In order of debuggers like PDB being able to step through the code,\n # we add a fake linecache entry.\n linecache.cache[unique_filename] = (\n len(script),\n None,\n script.splitlines(True),\n unique_filename,\n )\n\n __init__ = locs[\"__init__\"]\n __init__.__annotations__ = annotations\n\n return __init__\n\n\ndef fields(cls):\n \"\"\"\n Return the tuple of ``attrs`` attributes for a class.\n\n The tuple also allows accessing the fields by their names (see below for\n examples).\n\n :param type cls: Class to introspect.\n\n :raise TypeError: If *cls* is not a class.\n :raise attr.exceptions.NotAnAttrsClassError: If *cls* is not an ``attrs``\n class.\n\n :rtype: tuple (with name accessors) of `attr.Attribute`\n\n .. versionchanged:: 16.2.0 Returned tuple allows accessing the fields\n by name.\n \"\"\"\n if not isclass(cls):\n raise TypeError(\"Passed object must be a class.\")\n attrs = getattr(cls, \"__attrs_attrs__\", None)\n if attrs is None:\n raise NotAnAttrsClassError(\n \"{cls!r} is not an attrs-decorated class.\".format(cls=cls)\n )\n return attrs\n\n\ndef fields_dict(cls):\n \"\"\"\n Return an ordered dictionary of ``attrs`` attributes for a class, whose\n keys are the attribute names.\n\n :param type cls: Class to introspect.\n\n :raise TypeError: If *cls* is not a class.\n :raise attr.exceptions.NotAnAttrsClassError: If *cls* is not an ``attrs``\n class.\n\n :rtype: an ordered dict where keys are attribute names and values are\n `attr.Attribute`\\\\ s. This will be a `dict` if it's\n naturally ordered like on Python 3.6+ or an\n :class:`~collections.OrderedDict` otherwise.\n\n .. versionadded:: 18.1.0\n \"\"\"\n if not isclass(cls):\n raise TypeError(\"Passed object must be a class.\")\n attrs = getattr(cls, \"__attrs_attrs__\", None)\n if attrs is None:\n raise NotAnAttrsClassError(\n \"{cls!r} is not an attrs-decorated class.\".format(cls=cls)\n )\n return ordered_dict(((a.name, a) for a in attrs))\n\n\ndef validate(inst):\n \"\"\"\n Validate all attributes on *inst* that have a validator.\n\n Leaves all exceptions through.\n\n :param inst: Instance of a class with ``attrs`` attributes.\n \"\"\"\n if _config._run_validators is False:\n return\n\n for a in fields(inst.__class__):\n v = a.validator\n if v is not None:\n v(inst, a, getattr(inst, a.name))\n\n\ndef _is_slot_cls(cls):\n return \"__slots__\" in cls.__dict__\n\n\ndef _is_slot_attr(a_name, base_attr_map):\n \"\"\"\n Check if the attribute name comes from a slot class.\n \"\"\"\n return a_name in base_attr_map and _is_slot_cls(base_attr_map[a_name])\n\n\ndef _attrs_to_init_script(\n attrs, frozen, slots, post_init, cache_hash, base_attr_map, is_exc\n):\n \"\"\"\n Return a script of an initializer for *attrs* and a dict of globals.\n\n The globals are expected by the generated script.\n\n If *frozen* is True, we cannot set the attributes directly so we use\n a cached ``object.__setattr__``.\n \"\"\"\n lines = []\n any_slot_ancestors = any(\n _is_slot_attr(a.name, base_attr_map) for a in attrs\n )\n if frozen is True:\n if slots is True:\n lines.append(\n # Circumvent the __setattr__ descriptor to save one lookup per\n # assignment.\n # Note _setattr will be used again below if cache_hash is True\n \"_setattr = _cached_setattr.__get__(self, self.__class__)\"\n )\n\n def fmt_setter(attr_name, value_var):\n return \"_setattr('%(attr_name)s', %(value_var)s)\" % {\n \"attr_name\": attr_name,\n \"value_var\": value_var,\n }\n\n def fmt_setter_with_converter(attr_name, value_var):\n conv_name = _init_converter_pat.format(attr_name)\n return \"_setattr('%(attr_name)s', %(conv)s(%(value_var)s))\" % {\n \"attr_name\": attr_name,\n \"value_var\": value_var,\n \"conv\": conv_name,\n }\n\n else:\n # Dict frozen classes assign directly to __dict__.\n # But only if the attribute doesn't come from an ancestor slot\n # class.\n # Note _inst_dict will be used again below if cache_hash is True\n lines.append(\"_inst_dict = self.__dict__\")\n if any_slot_ancestors:\n lines.append(\n # Circumvent the __setattr__ descriptor to save one lookup\n # per assignment.\n \"_setattr = _cached_setattr.__get__(self, self.__class__)\"\n )\n\n def fmt_setter(attr_name, value_var):\n if _is_slot_attr(attr_name, base_attr_map):\n res = \"_setattr('%(attr_name)s', %(value_var)s)\" % {\n \"attr_name\": attr_name,\n \"value_var\": value_var,\n }\n else:\n res = \"_inst_dict['%(attr_name)s'] = %(value_var)s\" % {\n \"attr_name\": attr_name,\n \"value_var\": value_var,\n }\n return res\n\n def fmt_setter_with_converter(attr_name, value_var):\n conv_name = _init_converter_pat.format(attr_name)\n if _is_slot_attr(attr_name, base_attr_map):\n tmpl = \"_setattr('%(attr_name)s', %(c)s(%(value_var)s))\"\n else:\n tmpl = \"_inst_dict['%(attr_name)s'] = %(c)s(%(value_var)s)\"\n return tmpl % {\n \"attr_name\": attr_name,\n \"value_var\": value_var,\n \"c\": conv_name,\n }\n\n else:\n # Not frozen.\n def fmt_setter(attr_name, value):\n return \"self.%(attr_name)s = %(value)s\" % {\n \"attr_name\": attr_name,\n \"value\": value,\n }\n\n def fmt_setter_with_converter(attr_name, value_var):\n conv_name = _init_converter_pat.format(attr_name)\n return \"self.%(attr_name)s = %(conv)s(%(value_var)s)\" % {\n \"attr_name\": attr_name,\n \"value_var\": value_var,\n \"conv\": conv_name,\n }\n\n args = []\n kw_only_args = []\n attrs_to_validate = []\n\n # This is a dictionary of names to validator and converter callables.\n # Injecting this into __init__ globals lets us avoid lookups.\n names_for_globals = {}\n annotations = {\"return\": None}\n\n for a in attrs:\n if a.validator:\n attrs_to_validate.append(a)\n attr_name = a.name\n arg_name = a.name.lstrip(\"_\")\n has_factory = isinstance(a.default, Factory)\n if has_factory and a.default.takes_self:\n maybe_self = \"self\"\n else:\n maybe_self = \"\"\n if a.init is False:\n if has_factory:\n init_factory_name = _init_factory_pat.format(a.name)\n if a.converter is not None:\n lines.append(\n fmt_setter_with_converter(\n attr_name,\n init_factory_name + \"({0})\".format(maybe_self),\n )\n )\n conv_name = _init_converter_pat.format(a.name)\n names_for_globals[conv_name] = a.converter\n else:\n lines.append(\n fmt_setter(\n attr_name,\n init_factory_name + \"({0})\".format(maybe_self),\n )\n )\n names_for_globals[init_factory_name] = a.default.factory\n else:\n if a.converter is not None:\n lines.append(\n fmt_setter_with_converter(\n attr_name,\n \"attr_dict['{attr_name}'].default\".format(\n attr_name=attr_name\n ),\n )\n )\n conv_name = _init_converter_pat.format(a.name)\n names_for_globals[conv_name] = a.converter\n else:\n lines.append(\n fmt_setter(\n attr_name,\n \"attr_dict['{attr_name}'].default\".format(\n attr_name=attr_name\n ),\n )\n )\n elif a.default is not NOTHING and not has_factory:\n arg = \"{arg_name}=attr_dict['{attr_name}'].default\".format(\n arg_name=arg_name, attr_name=attr_name\n )\n if a.kw_only:\n kw_only_args.append(arg)\n else:\n args.append(arg)\n if a.converter is not None:\n lines.append(fmt_setter_with_converter(attr_name, arg_name))\n names_for_globals[\n _init_converter_pat.format(a.name)\n ] = a.converter\n else:\n lines.append(fmt_setter(attr_name, arg_name))\n elif has_factory:\n arg = \"{arg_name}=NOTHING\".format(arg_name=arg_name)\n if a.kw_only:\n kw_only_args.append(arg)\n else:\n args.append(arg)\n lines.append(\n \"if {arg_name} is not NOTHING:\".format(arg_name=arg_name)\n )\n init_factory_name = _init_factory_pat.format(a.name)\n if a.converter is not None:\n lines.append(\n \" \" + fmt_setter_with_converter(attr_name, arg_name)\n )\n lines.append(\"else:\")\n lines.append(\n \" \"\n + fmt_setter_with_converter(\n attr_name,\n init_factory_name + \"({0})\".format(maybe_self),\n )\n )\n names_for_globals[\n _init_converter_pat.format(a.name)\n ] = a.converter\n else:\n lines.append(\" \" + fmt_setter(attr_name, arg_name))\n lines.append(\"else:\")\n lines.append(\n \" \"\n + fmt_setter(\n attr_name,\n init_factory_name + \"({0})\".format(maybe_self),\n )\n )\n names_for_globals[init_factory_name] = a.default.factory\n else:\n if a.kw_only:\n kw_only_args.append(arg_name)\n else:\n args.append(arg_name)\n if a.converter is not None:\n lines.append(fmt_setter_with_converter(attr_name, arg_name))\n names_for_globals[\n _init_converter_pat.format(a.name)\n ] = a.converter\n else:\n lines.append(fmt_setter(attr_name, arg_name))\n\n if a.init is True and a.converter is None and a.type is not None:\n annotations[arg_name] = a.type\n\n if attrs_to_validate: # we can skip this if there are no validators.\n names_for_globals[\"_config\"] = _config\n lines.append(\"if _config._run_validators is True:\")\n for a in attrs_to_validate:\n val_name = \"__attr_validator_{}\".format(a.name)\n attr_name = \"__attr_{}\".format(a.name)\n lines.append(\n \" {}(self, {}, self.{})\".format(val_name, attr_name, a.name)\n )\n names_for_globals[val_name] = a.validator\n names_for_globals[attr_name] = a\n if post_init:\n lines.append(\"self.__attrs_post_init__()\")\n\n # because this is set only after __attrs_post_init is called, a crash\n # will result if post-init tries to access the hash code. This seemed\n # preferable to setting this beforehand, in which case alteration to\n # field values during post-init combined with post-init accessing the\n # hash code would result in silent bugs.\n if cache_hash:\n if frozen:\n if slots:\n # if frozen and slots, then _setattr defined above\n init_hash_cache = \"_setattr('%s', %s)\"\n else:\n # if frozen and not slots, then _inst_dict defined above\n init_hash_cache = \"_inst_dict['%s'] = %s\"\n else:\n init_hash_cache = \"self.%s = %s\"\n lines.append(init_hash_cache % (_hash_cache_field, \"None\"))\n\n # For exceptions we rely on BaseException.__init__ for proper\n # initialization.\n if is_exc:\n vals = \",\".join(\"self.\" + a.name for a in attrs if a.init)\n\n lines.append(\"BaseException.__init__(self, %s)\" % (vals,))\n\n args = \", \".join(args)\n if kw_only_args:\n if PY2:\n raise PythonTooOldError(\n \"Keyword-only arguments only work on Python 3 and later.\"\n )\n\n args += \"{leading_comma}*, {kw_only_args}\".format(\n leading_comma=\", \" if args else \"\",\n kw_only_args=\", \".join(kw_only_args),\n )\n return (\n \"\"\"\\\ndef __init__(self, {args}):\n {lines}\n\"\"\".format(\n args=args, lines=\"\\n \".join(lines) if lines else \"pass\"\n ),\n names_for_globals,\n annotations,\n )\n\n\nclass Attribute(object):\n \"\"\"\n *Read-only* representation of an attribute.\n\n :attribute name: The name of the attribute.\n\n Plus *all* arguments of `attr.ib` (except for ``factory``\n which is only syntactic sugar for ``default=Factory(...)``.\n\n For the version history of the fields, see `attr.ib`.\n \"\"\"\n\n __slots__ = (\n \"name\",\n \"default\",\n \"validator\",\n \"repr\",\n \"eq\",\n \"order\",\n \"hash\",\n \"init\",\n \"metadata\",\n \"type\",\n \"converter\",\n \"kw_only\",\n )\n\n def __init__(\n self,\n name,\n default,\n validator,\n repr,\n cmp, # XXX: unused, remove along with other cmp code.\n hash,\n init,\n metadata=None,\n type=None,\n converter=None,\n kw_only=False,\n eq=None,\n order=None,\n ):\n eq, order = _determine_eq_order(cmp, eq, order)\n\n # Cache this descriptor here to speed things up later.\n bound_setattr = _obj_setattr.__get__(self, Attribute)\n\n # Despite the big red warning, people *do* instantiate `Attribute`\n # themselves.\n bound_setattr(\"name\", name)\n bound_setattr(\"default\", default)\n bound_setattr(\"validator\", validator)\n bound_setattr(\"repr\", repr)\n bound_setattr(\"eq\", eq)\n bound_setattr(\"order\", order)\n bound_setattr(\"hash\", hash)\n bound_setattr(\"init\", init)\n bound_setattr(\"converter\", converter)\n bound_setattr(\n \"metadata\",\n (\n metadata_proxy(metadata)\n if metadata\n else _empty_metadata_singleton\n ),\n )\n bound_setattr(\"type\", type)\n bound_setattr(\"kw_only\", kw_only)\n\n def __setattr__(self, name, value):\n raise FrozenInstanceError()\n\n @classmethod\n def from_counting_attr(cls, name, ca, type=None):\n # type holds the annotated value. deal with conflicts:\n if type is None:\n type = ca.type\n elif ca.type is not None:\n raise ValueError(\n \"Type annotation and type argument cannot both be present\"\n )\n inst_dict = {\n k: getattr(ca, k)\n for k in Attribute.__slots__\n if k\n not in (\n \"name\",\n \"validator\",\n \"default\",\n \"type\",\n ) # exclude methods and deprecated alias\n }\n return cls(\n name=name,\n validator=ca._validator,\n default=ca._default,\n type=type,\n cmp=None,\n **inst_dict\n )\n\n @property\n def cmp(self):\n \"\"\"\n Simulate the presence of a cmp attribute and warn.\n \"\"\"\n warnings.warn(_CMP_DEPRECATION, DeprecationWarning, stacklevel=2)\n\n return self.eq and self.order\n\n # Don't use attr.assoc since fields(Attribute) doesn't work\n def _assoc(self, **changes):\n \"\"\"\n Copy *self* and apply *changes*.\n \"\"\"\n new = copy.copy(self)\n\n new._setattrs(changes.items())\n\n return new\n\n # Don't use _add_pickle since fields(Attribute) doesn't work\n def __getstate__(self):\n \"\"\"\n Play nice with pickle.\n \"\"\"\n return tuple(\n getattr(self, name) if name != \"metadata\" else dict(self.metadata)\n for name in self.__slots__\n )\n\n def __setstate__(self, state):\n \"\"\"\n Play nice with pickle.\n \"\"\"\n self._setattrs(zip(self.__slots__, state))\n\n def _setattrs(self, name_values_pairs):\n bound_setattr = _obj_setattr.__get__(self, Attribute)\n for name, value in name_values_pairs:\n if name != \"metadata\":\n bound_setattr(name, value)\n else:\n bound_setattr(\n name,\n metadata_proxy(value)\n if value\n else _empty_metadata_singleton,\n )\n\n\n_a = [\n Attribute(\n name=name,\n default=NOTHING,\n validator=None,\n repr=True,\n cmp=None,\n eq=True,\n order=False,\n hash=(name != \"metadata\"),\n init=True,\n )\n for name in Attribute.__slots__\n]\n\nAttribute = _add_hash(\n _add_eq(_add_repr(Attribute, attrs=_a), attrs=_a),\n attrs=[a for a in _a if a.hash],\n)\n\n\nclass _CountingAttr(object):\n \"\"\"\n Intermediate representation of attributes that uses a counter to preserve\n the order in which the attributes have been defined.\n\n *Internal* data structure of the attrs library. Running into is most\n likely the result of a bug like a forgotten `@attr.s` decorator.\n \"\"\"\n\n __slots__ = (\n \"counter\",\n \"_default\",\n \"repr\",\n \"eq\",\n \"order\",\n \"hash\",\n \"init\",\n \"metadata\",\n \"_validator\",\n \"converter\",\n \"type\",\n \"kw_only\",\n )\n __attrs_attrs__ = tuple(\n Attribute(\n name=name,\n default=NOTHING,\n validator=None,\n repr=True,\n cmp=None,\n hash=True,\n init=True,\n kw_only=False,\n eq=True,\n order=False,\n )\n for name in (\n \"counter\",\n \"_default\",\n \"repr\",\n \"eq\",\n \"order\",\n \"hash\",\n \"init\",\n )\n ) + (\n Attribute(\n name=\"metadata\",\n default=None,\n validator=None,\n repr=True,\n cmp=None,\n hash=False,\n init=True,\n kw_only=False,\n eq=True,\n order=False,\n ),\n )\n cls_counter = 0\n\n def __init__(\n self,\n default,\n validator,\n repr,\n cmp, # XXX: unused, remove along with cmp\n hash,\n init,\n converter,\n metadata,\n type,\n kw_only,\n eq,\n order,\n ):\n _CountingAttr.cls_counter += 1\n self.counter = _CountingAttr.cls_counter\n self._default = default\n # If validator is a list/tuple, wrap it using helper validator.\n if validator and isinstance(validator, (list, tuple)):\n self._validator = and_(*validator)\n else:\n self._validator = validator\n self.repr = repr\n self.eq = eq\n self.order = order\n self.hash = hash\n self.init = init\n self.converter = converter\n self.metadata = metadata\n self.type = type\n self.kw_only = kw_only\n\n def validator(self, meth):\n \"\"\"\n Decorator that adds *meth* to the list of validators.\n\n Returns *meth* unchanged.\n\n .. versionadded:: 17.1.0\n \"\"\"\n if self._validator is None:\n self._validator = meth\n else:\n self._validator = and_(self._validator, meth)\n return meth\n\n def default(self, meth):\n \"\"\"\n Decorator that allows to set the default for an attribute.\n\n Returns *meth* unchanged.\n\n :raises DefaultAlreadySetError: If default has been set before.\n\n .. versionadded:: 17.1.0\n \"\"\"\n if self._default is not NOTHING:\n raise DefaultAlreadySetError()\n\n self._default = Factory(meth, takes_self=True)\n\n return meth\n\n\n_CountingAttr = _add_eq(_add_repr(_CountingAttr))\n\n\n@attrs(slots=True, init=False, hash=True)\nclass Factory(object):\n \"\"\"\n Stores a factory callable.\n\n If passed as the default value to `attr.ib`, the factory is used to\n generate a new value.\n\n :param callable factory: A callable that takes either none or exactly one\n mandatory positional argument depending on *takes_self*.\n :param bool takes_self: Pass the partially initialized instance that is\n being initialized as a positional argument.\n\n .. versionadded:: 17.1.0 *takes_self*\n \"\"\"\n\n factory = attrib()\n takes_self = attrib()\n\n def __init__(self, factory, takes_self=False):\n \"\"\"\n `Factory` is part of the default machinery so if we want a default\n value here, we have to implement it ourselves.\n \"\"\"\n self.factory = factory\n self.takes_self = takes_self\n\n\ndef make_class(name, attrs, bases=(object,), **attributes_arguments):\n \"\"\"\n A quick way to create a new class called *name* with *attrs*.\n\n :param name: The name for the new class.\n :type name: str\n\n :param attrs: A list of names or a dictionary of mappings of names to\n attributes.\n\n If *attrs* is a list or an ordered dict (`dict` on Python 3.6+,\n `collections.OrderedDict` otherwise), the order is deduced from\n the order of the names or attributes inside *attrs*. Otherwise the\n order of the definition of the attributes is used.\n :type attrs: `list` or `dict`\n\n :param tuple bases: Classes that the new class will subclass.\n\n :param attributes_arguments: Passed unmodified to `attr.s`.\n\n :return: A new class with *attrs*.\n :rtype: type\n\n .. versionadded:: 17.1.0 *bases*\n .. versionchanged:: 18.1.0 If *attrs* is ordered, the order is retained.\n \"\"\"\n if isinstance(attrs, dict):\n cls_dict = attrs\n elif isinstance(attrs, (list, tuple)):\n cls_dict = dict((a, attrib()) for a in attrs)\n else:\n raise TypeError(\"attrs argument must be a dict or a list.\")\n\n post_init = cls_dict.pop(\"__attrs_post_init__\", None)\n type_ = type(\n name,\n bases,\n {} if post_init is None else {\"__attrs_post_init__\": post_init},\n )\n # For pickling to work, the __module__ variable needs to be set to the\n # frame where the class is created. Bypass this step in environments where\n # sys._getframe is not defined (Jython for example) or sys._getframe is not\n # defined for arguments greater than 0 (IronPython).\n try:\n type_.__module__ = sys._getframe(1).f_globals.get(\n \"__name__\", \"__main__\"\n )\n except (AttributeError, ValueError):\n pass\n\n # We do it here for proper warnings with meaningful stacklevel.\n cmp = attributes_arguments.pop(\"cmp\", None)\n attributes_arguments[\"eq\"], attributes_arguments[\n \"order\"\n ] = _determine_eq_order(\n cmp, attributes_arguments.get(\"eq\"), attributes_arguments.get(\"order\")\n )\n\n return _attrs(these=cls_dict, **attributes_arguments)(type_)\n\n\n# These are required by within this module so we define them here and merely\n# import into .validators.\n\n\n@attrs(slots=True, hash=True)\nclass _AndValidator(object):\n \"\"\"\n Compose many validators to a single one.\n \"\"\"\n\n _validators = attrib()\n\n def __call__(self, inst, attr, value):\n for v in self._validators:\n v(inst, attr, value)\n\n\ndef and_(*validators):\n \"\"\"\n A validator that composes multiple validators into one.\n\n When called on a value, it runs all wrapped validators.\n\n :param validators: Arbitrary number of validators.\n :type validators: callables\n\n .. versionadded:: 17.1.0\n \"\"\"\n vals = []\n for validator in validators:\n vals.extend(\n validator._validators\n if isinstance(validator, _AndValidator)\n else [validator]\n )\n\n return _AndValidator(tuple(vals))\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/attr/_version_info.py",
"content": "from __future__ import absolute_import, division, print_function\n\nfrom functools import total_ordering\n\nfrom ._funcs import astuple\nfrom ._make import attrib, attrs\n\n\n@total_ordering\n@attrs(eq=False, order=False, slots=True, frozen=True)\nclass VersionInfo(object):\n \"\"\"\n A version object that can be compared to tuple of length 1--4:\n\n >>> attr.VersionInfo(19, 1, 0, \"final\") <= (19, 2)\n True\n >>> attr.VersionInfo(19, 1, 0, \"final\") < (19, 1, 1)\n True\n >>> vi = attr.VersionInfo(19, 2, 0, \"final\")\n >>> vi < (19, 1, 1)\n False\n >>> vi < (19,)\n False\n >>> vi == (19, 2,)\n True\n >>> vi == (19, 2, 1)\n False\n\n .. versionadded:: 19.2\n \"\"\"\n\n year = attrib(type=int)\n minor = attrib(type=int)\n micro = attrib(type=int)\n releaselevel = attrib(type=str)\n\n @classmethod\n def _from_version_string(cls, s):\n \"\"\"\n Parse *s* and return a _VersionInfo.\n \"\"\"\n v = s.split(\".\")\n if len(v) == 3:\n v.append(\"final\")\n\n return cls(\n year=int(v[0]), minor=int(v[1]), micro=int(v[2]), releaselevel=v[3]\n )\n\n def _ensure_tuple(self, other):\n \"\"\"\n Ensure *other* is a tuple of a valid length.\n\n Returns a possibly transformed *other* and ourselves as a tuple of\n the same length as *other*.\n \"\"\"\n\n if self.__class__ is other.__class__:\n other = astuple(other)\n\n if not isinstance(other, tuple):\n raise NotImplementedError\n\n if not (1 <= len(other) <= 4):\n raise NotImplementedError\n\n return astuple(self)[: len(other)], other\n\n def __eq__(self, other):\n try:\n us, them = self._ensure_tuple(other)\n except NotImplementedError:\n return NotImplemented\n\n return us == them\n\n def __lt__(self, other):\n try:\n us, them = self._ensure_tuple(other)\n except NotImplementedError:\n return NotImplemented\n\n # Since alphabetically \"dev0\" < \"final\" < \"post1\" < \"post2\", we don't\n # have to do anything special with releaselevel for now.\n return us < them\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/attr/_version_info.pyi",
"content": "class VersionInfo:\n @property\n def year(self) -> int: ...\n @property\n def minor(self) -> int: ...\n @property\n def micro(self) -> int: ...\n @property\n def releaselevel(self) -> str: ...\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/attr/converters.py",
"content": "\"\"\"\nCommonly useful converters.\n\"\"\"\n\nfrom __future__ import absolute_import, division, print_function\n\nfrom ._make import NOTHING, Factory\n\n\ndef optional(converter):\n \"\"\"\n A converter that allows an attribute to be optional. An optional attribute\n is one which can be set to ``None``.\n\n :param callable converter: the converter that is used for non-``None``\n values.\n\n .. versionadded:: 17.1.0\n \"\"\"\n\n def optional_converter(val):\n if val is None:\n return None\n return converter(val)\n\n return optional_converter\n\n\ndef default_if_none(default=NOTHING, factory=None):\n \"\"\"\n A converter that allows to replace ``None`` values by *default* or the\n result of *factory*.\n\n :param default: Value to be used if ``None`` is passed. Passing an instance\n of `attr.Factory` is supported, however the ``takes_self`` option\n is *not*.\n :param callable factory: A callable that takes not parameters whose result\n is used if ``None`` is passed.\n\n :raises TypeError: If **neither** *default* or *factory* is passed.\n :raises TypeError: If **both** *default* and *factory* are passed.\n :raises ValueError: If an instance of `attr.Factory` is passed with\n ``takes_self=True``.\n\n .. versionadded:: 18.2.0\n \"\"\"\n if default is NOTHING and factory is None:\n raise TypeError(\"Must pass either `default` or `factory`.\")\n\n if default is not NOTHING and factory is not None:\n raise TypeError(\n \"Must pass either `default` or `factory` but not both.\"\n )\n\n if factory is not None:\n default = Factory(factory)\n\n if isinstance(default, Factory):\n if default.takes_self:\n raise ValueError(\n \"`takes_self` is not supported by default_if_none.\"\n )\n\n def default_if_none_converter(val):\n if val is not None:\n return val\n\n return default.factory()\n\n else:\n\n def default_if_none_converter(val):\n if val is not None:\n return val\n\n return default\n\n return default_if_none_converter\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/attr/converters.pyi",
"content": "from typing import TypeVar, Optional, Callable, overload\nfrom . import _ConverterType\n\n_T = TypeVar(\"_T\")\n\ndef optional(\n converter: _ConverterType[_T]\n) -> _ConverterType[Optional[_T]]: ...\n@overload\ndef default_if_none(default: _T) -> _ConverterType[_T]: ...\n@overload\ndef default_if_none(*, factory: Callable[[], _T]) -> _ConverterType[_T]: ...\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/attr/exceptions.py",
"content": "from __future__ import absolute_import, division, print_function\n\n\nclass FrozenInstanceError(AttributeError):\n \"\"\"\n A frozen/immutable instance has been attempted to be modified.\n\n It mirrors the behavior of ``namedtuples`` by using the same error message\n and subclassing `AttributeError`.\n\n .. versionadded:: 16.1.0\n \"\"\"\n\n msg = \"can't set attribute\"\n args = [msg]\n\n\nclass AttrsAttributeNotFoundError(ValueError):\n \"\"\"\n An ``attrs`` function couldn't find an attribute that the user asked for.\n\n .. versionadded:: 16.2.0\n \"\"\"\n\n\nclass NotAnAttrsClassError(ValueError):\n \"\"\"\n A non-``attrs`` class has been passed into an ``attrs`` function.\n\n .. versionadded:: 16.2.0\n \"\"\"\n\n\nclass DefaultAlreadySetError(RuntimeError):\n \"\"\"\n A default has been set using ``attr.ib()`` and is attempted to be reset\n using the decorator.\n\n .. versionadded:: 17.1.0\n \"\"\"\n\n\nclass UnannotatedAttributeError(RuntimeError):\n \"\"\"\n A class with ``auto_attribs=True`` has an ``attr.ib()`` without a type\n annotation.\n\n .. versionadded:: 17.3.0\n \"\"\"\n\n\nclass PythonTooOldError(RuntimeError):\n \"\"\"\n An ``attrs`` feature requiring a more recent python version has been used.\n\n .. versionadded:: 18.2.0\n \"\"\"\n\n\nclass NotCallableError(TypeError):\n \"\"\"\n A ``attr.ib()`` requiring a callable has been set with a value\n that is not callable.\n\n .. versionadded:: 19.2.0\n \"\"\"\n\n def __init__(self, msg, value):\n super(TypeError, self).__init__(msg, value)\n self.msg = msg\n self.value = value\n\n def __str__(self):\n return str(self.msg)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/attr/exceptions.pyi",
"content": "from typing import Any\n\nclass FrozenInstanceError(AttributeError):\n msg: str = ...\n\nclass AttrsAttributeNotFoundError(ValueError): ...\nclass NotAnAttrsClassError(ValueError): ...\nclass DefaultAlreadySetError(RuntimeError): ...\nclass UnannotatedAttributeError(RuntimeError): ...\nclass PythonTooOldError(RuntimeError): ...\n\nclass NotCallableError(TypeError):\n msg: str = ...\n value: Any = ...\n def __init__(self, msg: str, value: Any) -> None: ...\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/attr/filters.py",
"content": "\"\"\"\nCommonly useful filters for `attr.asdict`.\n\"\"\"\n\nfrom __future__ import absolute_import, division, print_function\n\nfrom ._compat import isclass\nfrom ._make import Attribute\n\n\ndef _split_what(what):\n \"\"\"\n Returns a tuple of `frozenset`s of classes and attributes.\n \"\"\"\n return (\n frozenset(cls for cls in what if isclass(cls)),\n frozenset(cls for cls in what if isinstance(cls, Attribute)),\n )\n\n\ndef include(*what):\n \"\"\"\n Whitelist *what*.\n\n :param what: What to whitelist.\n :type what: `list` of `type` or `attr.Attribute`\\\\ s\n\n :rtype: `callable`\n \"\"\"\n cls, attrs = _split_what(what)\n\n def include_(attribute, value):\n return value.__class__ in cls or attribute in attrs\n\n return include_\n\n\ndef exclude(*what):\n \"\"\"\n Blacklist *what*.\n\n :param what: What to blacklist.\n :type what: `list` of classes or `attr.Attribute`\\\\ s.\n\n :rtype: `callable`\n \"\"\"\n cls, attrs = _split_what(what)\n\n def exclude_(attribute, value):\n return value.__class__ not in cls and attribute not in attrs\n\n return exclude_\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/attr/filters.pyi",
"content": "from typing import Union, Any\nfrom . import Attribute, _FilterType\n\ndef include(*what: Union[type, Attribute[Any]]) -> _FilterType[Any]: ...\ndef exclude(*what: Union[type, Attribute[Any]]) -> _FilterType[Any]: ...\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/attr/py.typed",
"content": ""
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/attr/validators.py",
"content": "\"\"\"\nCommonly useful validators.\n\"\"\"\n\nfrom __future__ import absolute_import, division, print_function\n\nimport re\n\nfrom ._make import _AndValidator, and_, attrib, attrs\nfrom .exceptions import NotCallableError\n\n\n__all__ = [\n \"and_\",\n \"deep_iterable\",\n \"deep_mapping\",\n \"in_\",\n \"instance_of\",\n \"is_callable\",\n \"matches_re\",\n \"optional\",\n \"provides\",\n]\n\n\n@attrs(repr=False, slots=True, hash=True)\nclass _InstanceOfValidator(object):\n type = attrib()\n\n def __call__(self, inst, attr, value):\n \"\"\"\n We use a callable class to be able to change the ``__repr__``.\n \"\"\"\n if not isinstance(value, self.type):\n raise TypeError(\n \"'{name}' must be {type!r} (got {value!r} that is a \"\n \"{actual!r}).\".format(\n name=attr.name,\n type=self.type,\n actual=value.__class__,\n value=value,\n ),\n attr,\n self.type,\n value,\n )\n\n def __repr__(self):\n return \"\".format(\n type=self.type\n )\n\n\ndef instance_of(type):\n \"\"\"\n A validator that raises a `TypeError` if the initializer is called\n with a wrong type for this particular attribute (checks are performed using\n `isinstance` therefore it's also valid to pass a tuple of types).\n\n :param type: The type to check for.\n :type type: type or tuple of types\n\n :raises TypeError: With a human readable error message, the attribute\n (of type `attr.Attribute`), the expected type, and the value it\n got.\n \"\"\"\n return _InstanceOfValidator(type)\n\n\n@attrs(repr=False, frozen=True)\nclass _MatchesReValidator(object):\n regex = attrib()\n flags = attrib()\n match_func = attrib()\n\n def __call__(self, inst, attr, value):\n \"\"\"\n We use a callable class to be able to change the ``__repr__``.\n \"\"\"\n if not self.match_func(value):\n raise ValueError(\n \"'{name}' must match regex {regex!r}\"\n \" ({value!r} doesn't)\".format(\n name=attr.name, regex=self.regex.pattern, value=value\n ),\n attr,\n self.regex,\n value,\n )\n\n def __repr__(self):\n return \"\".format(\n regex=self.regex\n )\n\n\ndef matches_re(regex, flags=0, func=None):\n r\"\"\"\n A validator that raises `ValueError` if the initializer is called\n with a string that doesn't match *regex*.\n\n :param str regex: a regex string to match against\n :param int flags: flags that will be passed to the underlying re function\n (default 0)\n :param callable func: which underlying `re` function to call (options\n are `re.fullmatch`, `re.search`, `re.match`, default\n is ``None`` which means either `re.fullmatch` or an emulation of\n it on Python 2). For performance reasons, they won't be used directly\n but on a pre-`re.compile`\\ ed pattern.\n\n .. versionadded:: 19.2.0\n \"\"\"\n fullmatch = getattr(re, \"fullmatch\", None)\n valid_funcs = (fullmatch, None, re.search, re.match)\n if func not in valid_funcs:\n raise ValueError(\n \"'func' must be one of %s.\"\n % (\n \", \".join(\n sorted(\n e and e.__name__ or \"None\" for e in set(valid_funcs)\n )\n ),\n )\n )\n\n pattern = re.compile(regex, flags)\n if func is re.match:\n match_func = pattern.match\n elif func is re.search:\n match_func = pattern.search\n else:\n if fullmatch:\n match_func = pattern.fullmatch\n else:\n pattern = re.compile(r\"(?:{})\\Z\".format(regex), flags)\n match_func = pattern.match\n\n return _MatchesReValidator(pattern, flags, match_func)\n\n\n@attrs(repr=False, slots=True, hash=True)\nclass _ProvidesValidator(object):\n interface = attrib()\n\n def __call__(self, inst, attr, value):\n \"\"\"\n We use a callable class to be able to change the ``__repr__``.\n \"\"\"\n if not self.interface.providedBy(value):\n raise TypeError(\n \"'{name}' must provide {interface!r} which {value!r} \"\n \"doesn't.\".format(\n name=attr.name, interface=self.interface, value=value\n ),\n attr,\n self.interface,\n value,\n )\n\n def __repr__(self):\n return \"\".format(\n interface=self.interface\n )\n\n\ndef provides(interface):\n \"\"\"\n A validator that raises a `TypeError` if the initializer is called\n with an object that does not provide the requested *interface* (checks are\n performed using ``interface.providedBy(value)`` (see `zope.interface\n `_).\n\n :param zope.interface.Interface interface: The interface to check for.\n\n :raises TypeError: With a human readable error message, the attribute\n (of type `attr.Attribute`), the expected interface, and the\n value it got.\n \"\"\"\n return _ProvidesValidator(interface)\n\n\n@attrs(repr=False, slots=True, hash=True)\nclass _OptionalValidator(object):\n validator = attrib()\n\n def __call__(self, inst, attr, value):\n if value is None:\n return\n\n self.validator(inst, attr, value)\n\n def __repr__(self):\n return \"\".format(\n what=repr(self.validator)\n )\n\n\ndef optional(validator):\n \"\"\"\n A validator that makes an attribute optional. An optional attribute is one\n which can be set to ``None`` in addition to satisfying the requirements of\n the sub-validator.\n\n :param validator: A validator (or a list of validators) that is used for\n non-``None`` values.\n :type validator: callable or `list` of callables.\n\n .. versionadded:: 15.1.0\n .. versionchanged:: 17.1.0 *validator* can be a list of validators.\n \"\"\"\n if isinstance(validator, list):\n return _OptionalValidator(_AndValidator(validator))\n return _OptionalValidator(validator)\n\n\n@attrs(repr=False, slots=True, hash=True)\nclass _InValidator(object):\n options = attrib()\n\n def __call__(self, inst, attr, value):\n try:\n in_options = value in self.options\n except TypeError: # e.g. `1 in \"abc\"`\n in_options = False\n\n if not in_options:\n raise ValueError(\n \"'{name}' must be in {options!r} (got {value!r})\".format(\n name=attr.name, options=self.options, value=value\n )\n )\n\n def __repr__(self):\n return \"\".format(\n options=self.options\n )\n\n\ndef in_(options):\n \"\"\"\n A validator that raises a `ValueError` if the initializer is called\n with a value that does not belong in the options provided. The check is\n performed using ``value in options``.\n\n :param options: Allowed options.\n :type options: list, tuple, `enum.Enum`, ...\n\n :raises ValueError: With a human readable error message, the attribute (of\n type `attr.Attribute`), the expected options, and the value it\n got.\n\n .. versionadded:: 17.1.0\n \"\"\"\n return _InValidator(options)\n\n\n@attrs(repr=False, slots=False, hash=True)\nclass _IsCallableValidator(object):\n def __call__(self, inst, attr, value):\n \"\"\"\n We use a callable class to be able to change the ``__repr__``.\n \"\"\"\n if not callable(value):\n message = (\n \"'{name}' must be callable \"\n \"(got {value!r} that is a {actual!r}).\"\n )\n raise NotCallableError(\n msg=message.format(\n name=attr.name, value=value, actual=value.__class__\n ),\n value=value,\n )\n\n def __repr__(self):\n return \"\"\n\n\ndef is_callable():\n \"\"\"\n A validator that raises a `attr.exceptions.NotCallableError` if the\n initializer is called with a value for this particular attribute\n that is not callable.\n\n .. versionadded:: 19.1.0\n\n :raises `attr.exceptions.NotCallableError`: With a human readable error\n message containing the attribute (`attr.Attribute`) name,\n and the value it got.\n \"\"\"\n return _IsCallableValidator()\n\n\n@attrs(repr=False, slots=True, hash=True)\nclass _DeepIterable(object):\n member_validator = attrib(validator=is_callable())\n iterable_validator = attrib(\n default=None, validator=optional(is_callable())\n )\n\n def __call__(self, inst, attr, value):\n \"\"\"\n We use a callable class to be able to change the ``__repr__``.\n \"\"\"\n if self.iterable_validator is not None:\n self.iterable_validator(inst, attr, value)\n\n for member in value:\n self.member_validator(inst, attr, member)\n\n def __repr__(self):\n iterable_identifier = (\n \"\"\n if self.iterable_validator is None\n else \" {iterable!r}\".format(iterable=self.iterable_validator)\n )\n return (\n \"\"\n ).format(\n iterable_identifier=iterable_identifier,\n member=self.member_validator,\n )\n\n\ndef deep_iterable(member_validator, iterable_validator=None):\n \"\"\"\n A validator that performs deep validation of an iterable.\n\n :param member_validator: Validator to apply to iterable members\n :param iterable_validator: Validator to apply to iterable itself\n (optional)\n\n .. versionadded:: 19.1.0\n\n :raises TypeError: if any sub-validators fail\n \"\"\"\n return _DeepIterable(member_validator, iterable_validator)\n\n\n@attrs(repr=False, slots=True, hash=True)\nclass _DeepMapping(object):\n key_validator = attrib(validator=is_callable())\n value_validator = attrib(validator=is_callable())\n mapping_validator = attrib(default=None, validator=optional(is_callable()))\n\n def __call__(self, inst, attr, value):\n \"\"\"\n We use a callable class to be able to change the ``__repr__``.\n \"\"\"\n if self.mapping_validator is not None:\n self.mapping_validator(inst, attr, value)\n\n for key in value:\n self.key_validator(inst, attr, key)\n self.value_validator(inst, attr, value[key])\n\n def __repr__(self):\n return (\n \"\"\n ).format(key=self.key_validator, value=self.value_validator)\n\n\ndef deep_mapping(key_validator, value_validator, mapping_validator=None):\n \"\"\"\n A validator that performs deep validation of a dictionary.\n\n :param key_validator: Validator to apply to dictionary keys\n :param value_validator: Validator to apply to dictionary values\n :param mapping_validator: Validator to apply to top-level mapping\n attribute (optional)\n\n .. versionadded:: 19.1.0\n\n :raises TypeError: if any sub-validators fail\n \"\"\"\n return _DeepMapping(key_validator, value_validator, mapping_validator)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/attr/validators.pyi",
"content": "from typing import (\n Container,\n List,\n Union,\n TypeVar,\n Type,\n Any,\n Optional,\n Tuple,\n Iterable,\n Mapping,\n Callable,\n Match,\n AnyStr,\n overload,\n)\nfrom . import _ValidatorType\n\n_T = TypeVar(\"_T\")\n_T1 = TypeVar(\"_T1\")\n_T2 = TypeVar(\"_T2\")\n_T3 = TypeVar(\"_T3\")\n_I = TypeVar(\"_I\", bound=Iterable)\n_K = TypeVar(\"_K\")\n_V = TypeVar(\"_V\")\n_M = TypeVar(\"_M\", bound=Mapping)\n\n# To be more precise on instance_of use some overloads.\n# If there are more than 3 items in the tuple then we fall back to Any\n@overload\ndef instance_of(type: Type[_T]) -> _ValidatorType[_T]: ...\n@overload\ndef instance_of(type: Tuple[Type[_T]]) -> _ValidatorType[_T]: ...\n@overload\ndef instance_of(\n type: Tuple[Type[_T1], Type[_T2]]\n) -> _ValidatorType[Union[_T1, _T2]]: ...\n@overload\ndef instance_of(\n type: Tuple[Type[_T1], Type[_T2], Type[_T3]]\n) -> _ValidatorType[Union[_T1, _T2, _T3]]: ...\n@overload\ndef instance_of(type: Tuple[type, ...]) -> _ValidatorType[Any]: ...\ndef provides(interface: Any) -> _ValidatorType[Any]: ...\ndef optional(\n validator: Union[_ValidatorType[_T], List[_ValidatorType[_T]]]\n) -> _ValidatorType[Optional[_T]]: ...\ndef in_(options: Container[_T]) -> _ValidatorType[_T]: ...\ndef and_(*validators: _ValidatorType[_T]) -> _ValidatorType[_T]: ...\ndef matches_re(\n regex: AnyStr,\n flags: int = ...,\n func: Optional[\n Callable[[AnyStr, AnyStr, int], Optional[Match[AnyStr]]]\n ] = ...,\n) -> _ValidatorType[AnyStr]: ...\ndef deep_iterable(\n member_validator: _ValidatorType[_T],\n iterable_validator: Optional[_ValidatorType[_I]] = ...,\n) -> _ValidatorType[_I]: ...\ndef deep_mapping(\n key_validator: _ValidatorType[_K],\n value_validator: _ValidatorType[_V],\n mapping_validator: Optional[_ValidatorType[_M]] = ...,\n) -> _ValidatorType[_M]: ...\ndef is_callable() -> _ValidatorType[_T]: ...\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/attrs-19.3.0.dist-info/INSTALLER",
"content": "pip\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/attrs-19.3.0.dist-info/LICENSE",
"content": "The MIT License (MIT)\n\nCopyright (c) 2015 Hynek Schlawack\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/attrs-19.3.0.dist-info/METADATA",
"content": "Metadata-Version: 2.1\nName: attrs\nVersion: 19.3.0\nSummary: Classes Without Boilerplate\nHome-page: https://www.attrs.org/\nAuthor: Hynek Schlawack\nAuthor-email: hs@ox.cx\nMaintainer: Hynek Schlawack\nMaintainer-email: hs@ox.cx\nLicense: MIT\nProject-URL: Documentation, https://www.attrs.org/\nProject-URL: Bug Tracker, https://github.com/python-attrs/attrs/issues\nProject-URL: Source Code, https://github.com/python-attrs/attrs\nKeywords: class,attribute,boilerplate\nPlatform: UNKNOWN\nClassifier: Development Status :: 5 - Production/Stable\nClassifier: Intended Audience :: Developers\nClassifier: Natural Language :: English\nClassifier: License :: OSI Approved :: MIT License\nClassifier: Operating System :: OS Independent\nClassifier: Programming Language :: Python\nClassifier: Programming Language :: Python :: 2\nClassifier: Programming Language :: Python :: 2.7\nClassifier: Programming Language :: Python :: 3\nClassifier: Programming Language :: Python :: 3.4\nClassifier: Programming Language :: Python :: 3.5\nClassifier: Programming Language :: Python :: 3.6\nClassifier: Programming Language :: Python :: 3.7\nClassifier: Programming Language :: Python :: 3.8\nClassifier: Programming Language :: Python :: Implementation :: CPython\nClassifier: Programming Language :: Python :: Implementation :: PyPy\nClassifier: Topic :: Software Development :: Libraries :: Python Modules\nRequires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*\nDescription-Content-Type: text/x-rst\nProvides-Extra: azure-pipelines\nRequires-Dist: coverage ; extra == 'azure-pipelines'\nRequires-Dist: hypothesis ; extra == 'azure-pipelines'\nRequires-Dist: pympler ; extra == 'azure-pipelines'\nRequires-Dist: pytest (>=4.3.0) ; extra == 'azure-pipelines'\nRequires-Dist: six ; extra == 'azure-pipelines'\nRequires-Dist: zope.interface ; extra == 'azure-pipelines'\nRequires-Dist: pytest-azurepipelines ; extra == 'azure-pipelines'\nProvides-Extra: dev\nRequires-Dist: coverage ; extra == 'dev'\nRequires-Dist: hypothesis ; extra == 'dev'\nRequires-Dist: pympler ; extra == 'dev'\nRequires-Dist: pytest (>=4.3.0) ; extra == 'dev'\nRequires-Dist: six ; extra == 'dev'\nRequires-Dist: zope.interface ; extra == 'dev'\nRequires-Dist: sphinx ; extra == 'dev'\nRequires-Dist: pre-commit ; extra == 'dev'\nProvides-Extra: docs\nRequires-Dist: sphinx ; extra == 'docs'\nRequires-Dist: zope.interface ; extra == 'docs'\nProvides-Extra: tests\nRequires-Dist: coverage ; extra == 'tests'\nRequires-Dist: hypothesis ; extra == 'tests'\nRequires-Dist: pympler ; extra == 'tests'\nRequires-Dist: pytest (>=4.3.0) ; extra == 'tests'\nRequires-Dist: six ; extra == 'tests'\nRequires-Dist: zope.interface ; extra == 'tests'\n\n.. image:: https://www.attrs.org/en/latest/_static/attrs_logo.png\n :alt: attrs Logo\n\n======================================\n``attrs``: Classes Without Boilerplate\n======================================\n\n.. image:: https://readthedocs.org/projects/attrs/badge/?version=stable\n :target: https://www.attrs.org/en/stable/?badge=stable\n :alt: Documentation Status\n\n.. image:: https://attrs.visualstudio.com/attrs/_apis/build/status/python-attrs.attrs?branchName=master\n :target: https://attrs.visualstudio.com/attrs/_build/latest?definitionId=1&branchName=master\n :alt: CI Status\n\n.. image:: https://codecov.io/github/python-attrs/attrs/branch/master/graph/badge.svg\n :target: https://codecov.io/github/python-attrs/attrs\n :alt: Test Coverage\n\n.. image:: https://img.shields.io/badge/code%20style-black-000000.svg\n :target: https://github.com/psf/black\n :alt: Code style: black\n\n.. teaser-begin\n\n``attrs`` is the Python package that will bring back the **joy** of **writing classes** by relieving you from the drudgery of implementing object protocols (aka `dunder `_ methods).\n\nIts main goal is to help you to write **concise** and **correct** software without slowing down your code.\n\n.. -spiel-end-\n\nFor that, it gives you a class decorator and a way to declaratively define the attributes on that class:\n\n.. -code-begin-\n\n.. code-block:: pycon\n\n >>> import attr\n\n >>> @attr.s\n ... class SomeClass(object):\n ... a_number = attr.ib(default=42)\n ... list_of_numbers = attr.ib(factory=list)\n ...\n ... def hard_math(self, another_number):\n ... return self.a_number + sum(self.list_of_numbers) * another_number\n\n\n >>> sc = SomeClass(1, [1, 2, 3])\n >>> sc\n SomeClass(a_number=1, list_of_numbers=[1, 2, 3])\n\n >>> sc.hard_math(3)\n 19\n >>> sc == SomeClass(1, [1, 2, 3])\n True\n >>> sc != SomeClass(2, [3, 2, 1])\n True\n\n >>> attr.asdict(sc)\n {'a_number': 1, 'list_of_numbers': [1, 2, 3]}\n\n >>> SomeClass()\n SomeClass(a_number=42, list_of_numbers=[])\n\n >>> C = attr.make_class(\"C\", [\"a\", \"b\"])\n >>> C(\"foo\", \"bar\")\n C(a='foo', b='bar')\n\n\nAfter *declaring* your attributes ``attrs`` gives you:\n\n- a concise and explicit overview of the class's attributes,\n- a nice human-readable ``__repr__``,\n- a complete set of comparison methods (equality and ordering),\n- an initializer,\n- and much more,\n\n*without* writing dull boilerplate code again and again and *without* runtime performance penalties.\n\nOn Python 3.6 and later, you can often even drop the calls to ``attr.ib()`` by using `type annotations `_.\n\nThis gives you the power to use actual classes with actual types in your code instead of confusing ``tuple``\\ s or `confusingly behaving `_ ``namedtuple``\\ s.\nWhich in turn encourages you to write *small classes* that do `one thing well `_.\nNever again violate the `single responsibility principle `_ just because implementing ``__init__`` et al is a painful drag.\n\n\n.. -testimonials-\n\nTestimonials\n============\n\n**Amber Hawkie Brown**, Twisted Release Manager and Computer Owl:\n\n Writing a fully-functional class using attrs takes me less time than writing this testimonial.\n\n\n**Glyph Lefkowitz**, creator of `Twisted `_, `Automat `_, and other open source software, in `The One Python Library Everyone Needs `_:\n\n I’m looking forward to is being able to program in Python-with-attrs everywhere.\n It exerts a subtle, but positive, design influence in all the codebases I’ve see it used in.\n\n\n**Kenneth Reitz**, creator of `Requests `_ (`on paper no less `_!):\n\n attrs—classes for humans. I like it.\n\n\n**Łukasz Langa**, creator of `Black `_, prolific Python core developer, and release manager for Python 3.8 and 3.9:\n\n I'm increasingly digging your attr.ocity. Good job!\n\n\n.. -end-\n\n.. -project-information-\n\nGetting Help\n============\n\nPlease use the ``python-attrs`` tag on `StackOverflow `_ to get help.\n\nAnswering questions of your fellow developers is also great way to help the project!\n\n\nProject Information\n===================\n\n``attrs`` is released under the `MIT `_ license,\nits documentation lives at `Read the Docs `_,\nthe code on `GitHub `_,\nand the latest release on `PyPI `_.\nIt’s rigorously tested on Python 2.7, 3.4+, and PyPy.\n\nWe collect information on **third-party extensions** in our `wiki `_.\nFeel free to browse and add your own!\n\nIf you'd like to contribute to ``attrs`` you're most welcome and we've written `a little guide `_ to get you started!\n\n\nRelease Information\n===================\n\n19.3.0 (2019-10-15)\n-------------------\n\nChanges\n^^^^^^^\n\n- Fixed ``auto_attribs`` usage when default values cannot be compared directly with ``==``, such as ``numpy`` arrays.\n `#585 `_\n\n`Full changelog `_.\n\nCredits\n=======\n\n``attrs`` is written and maintained by `Hynek Schlawack `_.\n\nThe development is kindly supported by `Variomedia AG `_.\n\nA full list of contributors can be found in `GitHub's overview `_.\n\nIt’s the spiritual successor of `characteristic `_ and aspires to fix some of it clunkiness and unfortunate decisions.\nBoth were inspired by Twisted’s `FancyEqMixin `_ but both are implemented using class decorators because `subclassing is bad for you `_, m’kay?\n\n\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/attrs-19.3.0.dist-info/RECORD",
"content": "attr/__init__.py,sha256=ONaI-ZEGOIC7IDqH2HANgesnOxPE1m0GIRRYPPsXEHk,1349\r\nattr/__init__.pyi,sha256=fOnMRTF00b5J23PYPF74u66UVhVzzm0KYVxzmVXHPw0,8257\r\nattr/__pycache__/__init__.cpython-36.pyc,,\r\nattr/__pycache__/_compat.cpython-36.pyc,,\r\nattr/__pycache__/_config.cpython-36.pyc,,\r\nattr/__pycache__/_funcs.cpython-36.pyc,,\r\nattr/__pycache__/_make.cpython-36.pyc,,\r\nattr/__pycache__/_version_info.cpython-36.pyc,,\r\nattr/__pycache__/converters.cpython-36.pyc,,\r\nattr/__pycache__/exceptions.cpython-36.pyc,,\r\nattr/__pycache__/filters.cpython-36.pyc,,\r\nattr/__pycache__/validators.cpython-36.pyc,,\r\nattr/_compat.py,sha256=-pJtdtqgCg0K6rH_BWf3wKuTum58GD-WWPclQQ2SUaU,7326\r\nattr/_config.py,sha256=_KvW0mQdH2PYjHc0YfIUaV_o2pVfM7ziMEYTxwmEhOA,514\r\nattr/_funcs.py,sha256=unAJfNGSTOzxyFzkj7Rs3O1bfsQodmXyir9uZKen-vY,9696\r\nattr/_make.py,sha256=HhjGhFEbnxPKuUb9hFmAjXoQGpekniw1IEF3_Z-vwCc,70807\r\nattr/_version_info.py,sha256=azMi1lNelb3cJvvYUMXsXVbUANkRzbD5IEiaXVpeVr4,2162\r\nattr/_version_info.pyi,sha256=x_M3L3WuB7r_ULXAWjx959udKQ4HLB8l-hsc1FDGNvk,209\r\nattr/converters.py,sha256=5QJRYSXE8G7PW0289y_SPwvvZIcw-nJIuBlfYVdB4BQ,2141\r\nattr/converters.pyi,sha256=wAhCoOT1MFV8t323rpD87O7bxQ8CYLTPiBQd-29BieI,351\r\nattr/exceptions.py,sha256=hbhOa3b4W8_mRrbj3FsMTR4Bt5xzbJs5xaFTWn8s6h4,1635\r\nattr/exceptions.pyi,sha256=4zuaJyl2axxWbqnZgxo_2oTpPNbyowEw3A4hqV5PmAc,458\r\nattr/filters.py,sha256=weDxwATsa69T_0bPVjiM1fGsciAMQmwhY5G8Jm5BxuI,1098\r\nattr/filters.pyi,sha256=xDpmKQlFdssgxGa5tsl1ADh_3zwAwAT4vUhd8h-8-Tk,214\r\nattr/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0\r\nattr/validators.py,sha256=8AsxgdDgh3sGPseiUIMPGcTr6PvaDYfH3AK46tsvs8U,11460\r\nattr/validators.pyi,sha256=vZgsJqUwrJevh4v_Hd7_RSXqDrBctE6-3AEZ7uYKodo,1868\r\nattrs-19.3.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4\r\nattrs-19.3.0.dist-info/LICENSE,sha256=v2WaKLSSQGAvVrvfSQy-LsUJsVuY-Z17GaUsdA4yeGM,1082\r\nattrs-19.3.0.dist-info/METADATA,sha256=WmnjYy_TftebL3pewXyGEaD4TZRrLUEHk3frEkAtqL0,9022\r\nattrs-19.3.0.dist-info/RECORD,,\r\nattrs-19.3.0.dist-info/WHEEL,sha256=8zNYZbwQSXoB9IfXOjPfeNwvAsALAjffgk27FqvCWbo,110\r\nattrs-19.3.0.dist-info/top_level.txt,sha256=tlRYMddkRlKPqJ96wP2_j9uEsmcNHgD2SbuWd4CzGVU,5\r\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/attrs-19.3.0.dist-info/WHEEL",
"content": "Wheel-Version: 1.0\nGenerator: bdist_wheel (0.33.6)\nRoot-Is-Purelib: true\nTag: py2-none-any\nTag: py3-none-any\n\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/attrs-19.3.0.dist-info/top_level.txt",
"content": "attr\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/automat/__init__.py",
"content": "# -*- test-case-name: automat -*-\nfrom ._methodical import MethodicalMachine\nfrom ._core import NoTransition\n\n__all__ = [\n 'MethodicalMachine',\n 'NoTransition',\n]\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/automat/_core.py",
"content": "# -*- test-case-name: automat._test.test_core -*-\n\n\"\"\"\nA core state-machine abstraction.\n\nPerhaps something that could be replaced with or integrated into machinist.\n\"\"\"\n\nfrom itertools import chain\n\n_NO_STATE = \"\"\n\n\nclass NoTransition(Exception):\n \"\"\"\n A finite state machine in C{state} has no transition for C{symbol}.\n\n @param state: the finite state machine's state at the time of the\n illegal transition.\n\n @param symbol: the input symbol for which no transition exists.\n \"\"\"\n\n def __init__(self, state, symbol):\n self.state = state\n self.symbol = symbol\n super(Exception, self).__init__(\n \"no transition for {} in {}\".format(symbol, state)\n )\n\n\nclass Automaton(object):\n \"\"\"\n A declaration of a finite state machine.\n\n Note that this is not the machine itself; it is immutable.\n \"\"\"\n\n def __init__(self):\n \"\"\"\n Initialize the set of transitions and the initial state.\n \"\"\"\n self._initialState = _NO_STATE\n self._transitions = set()\n\n\n @property\n def initialState(self):\n \"\"\"\n Return this automaton's initial state.\n \"\"\"\n return self._initialState\n\n\n @initialState.setter\n def initialState(self, state):\n \"\"\"\n Set this automaton's initial state. Raises a ValueError if\n this automaton already has an initial state.\n \"\"\"\n\n if self._initialState is not _NO_STATE:\n raise ValueError(\n \"initial state already set to {}\".format(self._initialState))\n\n self._initialState = state\n\n\n def addTransition(self, inState, inputSymbol, outState, outputSymbols):\n \"\"\"\n Add the given transition to the outputSymbol. Raise ValueError if\n there is already a transition with the same inState and inputSymbol.\n \"\"\"\n # keeping self._transitions in a flat list makes addTransition\n # O(n^2), but state machines don't tend to have hundreds of\n # transitions.\n for (anInState, anInputSymbol, anOutState, _) in self._transitions:\n if (anInState == inState and anInputSymbol == inputSymbol):\n raise ValueError(\n \"already have transition from {} via {}\".format(inState, inputSymbol))\n self._transitions.add(\n (inState, inputSymbol, outState, tuple(outputSymbols))\n )\n\n\n def allTransitions(self):\n \"\"\"\n All transitions.\n \"\"\"\n return frozenset(self._transitions)\n\n\n def inputAlphabet(self):\n \"\"\"\n The full set of symbols acceptable to this automaton.\n \"\"\"\n return {inputSymbol for (inState, inputSymbol, outState,\n outputSymbol) in self._transitions}\n\n\n def outputAlphabet(self):\n \"\"\"\n The full set of symbols which can be produced by this automaton.\n \"\"\"\n return set(\n chain.from_iterable(\n outputSymbols for\n (inState, inputSymbol, outState, outputSymbols)\n in self._transitions\n )\n )\n\n\n def states(self):\n \"\"\"\n All valid states; \"Q\" in the mathematical description of a state\n machine.\n \"\"\"\n return frozenset(\n chain.from_iterable(\n (inState, outState)\n for\n (inState, inputSymbol, outState, outputSymbol)\n in self._transitions\n )\n )\n\n\n def outputForInput(self, inState, inputSymbol):\n \"\"\"\n A 2-tuple of (outState, outputSymbols) for inputSymbol.\n \"\"\"\n for (anInState, anInputSymbol,\n outState, outputSymbols) in self._transitions:\n if (inState, inputSymbol) == (anInState, anInputSymbol):\n return (outState, list(outputSymbols))\n raise NoTransition(state=inState, symbol=inputSymbol)\n\n\nclass Transitioner(object):\n \"\"\"\n The combination of a current state and an L{Automaton}.\n \"\"\"\n\n def __init__(self, automaton, initialState):\n self._automaton = automaton\n self._state = initialState\n self._tracer = None\n\n def setTrace(self, tracer):\n self._tracer = tracer\n\n def transition(self, inputSymbol):\n \"\"\"\n Transition between states, returning any outputs.\n \"\"\"\n outState, outputSymbols = self._automaton.outputForInput(self._state,\n inputSymbol)\n outTracer = None\n if self._tracer:\n outTracer = self._tracer(self._state._name(),\n inputSymbol._name(),\n outState._name())\n self._state = outState\n return (outputSymbols, outTracer)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/automat/_discover.py",
"content": "import collections\nimport inspect\nfrom automat import MethodicalMachine\nfrom twisted.python.modules import PythonModule, getModule\n\n\ndef isOriginalLocation(attr):\n \"\"\"\n Attempt to discover if this appearance of a PythonAttribute\n representing a class refers to the module where that class was\n defined.\n \"\"\"\n sourceModule = inspect.getmodule(attr.load())\n if sourceModule is None:\n return False\n\n currentModule = attr\n while not isinstance(currentModule, PythonModule):\n currentModule = currentModule.onObject\n\n return currentModule.name == sourceModule.__name__\n\n\ndef findMachinesViaWrapper(within):\n \"\"\"\n Recursively yield L{MethodicalMachine}s and their FQPNs within a\n L{PythonModule} or a L{twisted.python.modules.PythonAttribute}\n wrapper object.\n\n Note that L{PythonModule}s may refer to packages, as well.\n\n The discovery heuristic considers L{MethodicalMachine} instances\n that are module-level attributes or class-level attributes\n accessible from module scope. Machines inside nested classes will\n be discovered, but those returned from functions or methods will not be.\n\n @type within: L{PythonModule} or L{twisted.python.modules.PythonAttribute}\n @param within: Where to start the search.\n\n @return: a generator which yields FQPN, L{MethodicalMachine} pairs.\n \"\"\"\n queue = collections.deque([within])\n visited = set()\n\n while queue:\n attr = queue.pop()\n value = attr.load()\n\n if isinstance(value, MethodicalMachine) and value not in visited:\n visited.add(value)\n yield attr.name, value\n elif (inspect.isclass(value) and isOriginalLocation(attr) and\n value not in visited):\n visited.add(value)\n queue.extendleft(attr.iterAttributes())\n elif isinstance(attr, PythonModule) and value not in visited:\n visited.add(value)\n queue.extendleft(attr.iterAttributes())\n queue.extendleft(attr.iterModules())\n\n\nclass InvalidFQPN(Exception):\n \"\"\"\n The given FQPN was not a dot-separated list of Python objects.\n \"\"\"\n\n\nclass NoModule(InvalidFQPN):\n \"\"\"\n A prefix of the FQPN was not an importable module or package.\n \"\"\"\n\n\nclass NoObject(InvalidFQPN):\n \"\"\"\n A suffix of the FQPN was not an accessible object\n \"\"\"\n\n\ndef wrapFQPN(fqpn):\n \"\"\"\n Given an FQPN, retrieve the object via the global Python module\n namespace and wrap it with a L{PythonModule} or a\n L{twisted.python.modules.PythonAttribute}.\n \"\"\"\n # largely cribbed from t.p.reflect.namedAny\n\n if not fqpn:\n raise InvalidFQPN(\"FQPN was empty\")\n\n components = collections.deque(fqpn.split('.'))\n\n if '' in components:\n raise InvalidFQPN(\n \"name must be a string giving a '.'-separated list of Python \"\n \"identifiers, not %r\" % (fqpn,))\n\n component = components.popleft()\n try:\n module = getModule(component)\n except KeyError:\n raise NoModule(component)\n\n # find the bottom-most module\n while components:\n component = components.popleft()\n try:\n module = module[component]\n except KeyError:\n components.appendleft(component)\n break\n else:\n module.load()\n else:\n return module\n\n # find the bottom-most attribute\n attribute = module\n for component in components:\n try:\n attribute = next(child for child in attribute.iterAttributes()\n if child.name.rsplit('.', 1)[-1] == component)\n except StopIteration:\n raise NoObject('{}.{}'.format(attribute.name, component))\n\n return attribute\n\n\ndef findMachines(fqpn):\n \"\"\"\n Recursively yield L{MethodicalMachine}s and their FQPNs in and\n under the a Python object specified by an FQPN.\n\n The discovery heuristic considers L{MethodicalMachine} instances\n that are module-level attributes or class-level attributes\n accessible from module scope. Machines inside nested classes will\n be discovered, but those returned from functions or methods will not be.\n\n @type within: an FQPN\n @param within: Where to start the search.\n\n @return: a generator which yields FQPN, L{MethodicalMachine} pairs.\n \"\"\"\n return findMachinesViaWrapper(wrapFQPN(fqpn))\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/automat/_introspection.py",
"content": "\"\"\"\nPython introspection helpers.\n\"\"\"\n\nfrom types import CodeType as code, FunctionType as function\n\n\ndef copycode(template, changes):\n names = [\n \"argcount\", \"nlocals\", \"stacksize\", \"flags\", \"code\", \"consts\",\n \"names\", \"varnames\", \"filename\", \"name\", \"firstlineno\", \"lnotab\",\n \"freevars\", \"cellvars\"\n ]\n if hasattr(code, \"co_kwonlyargcount\"):\n names.insert(1, \"kwonlyargcount\")\n if hasattr(code, \"co_posonlyargcount\"):\n # PEP 570 added \"positional only arguments\"\n names.insert(1, \"posonlyargcount\")\n values = [\n changes.get(name, getattr(template, \"co_\" + name))\n for name in names\n ]\n return code(*values)\n\n\n\ndef copyfunction(template, funcchanges, codechanges):\n names = [\n \"globals\", \"name\", \"defaults\", \"closure\",\n ]\n values = [\n funcchanges.get(name, getattr(template, \"__\" + name + \"__\"))\n for name in names\n ]\n return function(copycode(template.__code__, codechanges), *values)\n\n\ndef preserveName(f):\n \"\"\"\n Preserve the name of the given function on the decorated function.\n \"\"\"\n def decorator(decorated):\n return copyfunction(decorated,\n dict(name=f.__name__), dict(name=f.__name__))\n return decorator\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/automat/_methodical.py",
"content": "# -*- test-case-name: automat._test.test_methodical -*-\n\nimport collections\nfrom functools import wraps\nfrom itertools import count\n\ntry:\n # Python 3\n from inspect import getfullargspec as getArgsSpec\nexcept ImportError:\n # Python 2\n from inspect import getargspec as getArgsSpec\n\nimport attr\nimport six\n\nfrom ._core import Transitioner, Automaton\nfrom ._introspection import preserveName\n\n\nArgSpec = collections.namedtuple('ArgSpec', ['args', 'varargs', 'varkw',\n 'defaults', 'kwonlyargs',\n 'kwonlydefaults', 'annotations'])\n\n\ndef _getArgSpec(func):\n \"\"\"\n Normalize inspect.ArgSpec across python versions\n and convert mutable attributes to immutable types.\n\n :param Callable func: A function.\n :return: The function's ArgSpec.\n :rtype: ArgSpec\n \"\"\"\n spec = getArgsSpec(func)\n return ArgSpec(\n args=tuple(spec.args),\n varargs=spec.varargs,\n varkw=spec.varkw if six.PY3 else spec.keywords,\n defaults=spec.defaults if spec.defaults else (),\n kwonlyargs=tuple(spec.kwonlyargs) if six.PY3 else (),\n kwonlydefaults=(\n tuple(spec.kwonlydefaults.items())\n if spec.kwonlydefaults else ()\n ) if six.PY3 else (),\n annotations=tuple(spec.annotations.items()) if six.PY3 else (),\n )\n\n\ndef _getArgNames(spec):\n \"\"\"\n Get the name of all arguments defined in a function signature.\n\n The name of * and ** arguments is normalized to \"*args\" and \"**kwargs\".\n\n :param ArgSpec spec: A function to interrogate for a signature.\n :return: The set of all argument names in `func`s signature.\n :rtype: Set[str]\n \"\"\"\n return set(\n spec.args\n + spec.kwonlyargs\n + (('*args',) if spec.varargs else ())\n + (('**kwargs',) if spec.varkw else ())\n + spec.annotations\n )\n\n\ndef _keywords_only(f):\n \"\"\"\n Decorate a function so all its arguments must be passed by keyword.\n\n A useful utility for decorators that take arguments so that they don't\n accidentally get passed the thing they're decorating as their first\n argument.\n\n Only works for methods right now.\n \"\"\"\n @wraps(f)\n def g(self, **kw):\n return f(self, **kw)\n return g\n\n\n@attr.s(frozen=True)\nclass MethodicalState(object):\n \"\"\"\n A state for a L{MethodicalMachine}.\n \"\"\"\n machine = attr.ib(repr=False)\n method = attr.ib()\n serialized = attr.ib(repr=False)\n\n def upon(self, input, enter, outputs, collector=list):\n \"\"\"\n Declare a state transition within the :class:`automat.MethodicalMachine`\n associated with this :class:`automat.MethodicalState`:\n upon the receipt of the `input`, enter the `state`,\n emitting each output in `outputs`.\n\n :param MethodicalInput input: The input triggering a state transition.\n :param MethodicalState enter: The resulting state.\n :param Iterable[MethodicalOutput] outputs: The outputs to be triggered\n as a result of the declared state transition.\n :param Callable collector: The function to be used when collecting\n output return values.\n\n :raises TypeError: if any of the `outputs` signatures do not match\n the `inputs` signature.\n :raises ValueError: if the state transition from `self` via `input`\n has already been defined.\n \"\"\"\n inputArgs = _getArgNames(input.argSpec)\n for output in outputs:\n outputArgs = _getArgNames(output.argSpec)\n if not outputArgs.issubset(inputArgs):\n raise TypeError(\n \"method {input} signature {inputSignature} \"\n \"does not match output {output} \"\n \"signature {outputSignature}\".format(\n input=input.method.__name__,\n output=output.method.__name__,\n inputSignature=getArgsSpec(input.method),\n outputSignature=getArgsSpec(output.method),\n ))\n self.machine._oneTransition(self, input, enter, outputs, collector)\n\n def _name(self):\n return self.method.__name__\n\n\ndef _transitionerFromInstance(oself, symbol, automaton):\n \"\"\"\n Get a L{Transitioner}\n \"\"\"\n transitioner = getattr(oself, symbol, None)\n if transitioner is None:\n transitioner = Transitioner(\n automaton,\n automaton.initialState,\n )\n setattr(oself, symbol, transitioner)\n return transitioner\n\n\ndef _empty():\n pass\n\ndef _docstring():\n \"\"\"docstring\"\"\"\n\ndef assertNoCode(inst, attribute, f):\n # The function body must be empty, i.e. \"pass\" or \"return None\", which\n # both yield the same bytecode: LOAD_CONST (None), RETURN_VALUE. We also\n # accept functions with only a docstring, which yields slightly different\n # bytecode, because the \"None\" is put in a different constant slot.\n\n # Unfortunately, this does not catch function bodies that return a\n # constant value, e.g. \"return 1\", because their code is identical to a\n # \"return None\". They differ in the contents of their constant table, but\n # checking that would require us to parse the bytecode, find the index\n # being returned, then making sure the table has a None at that index.\n\n if f.__code__.co_code not in (_empty.__code__.co_code,\n _docstring.__code__.co_code):\n raise ValueError(\"function body must be empty\")\n\n\ndef _filterArgs(args, kwargs, inputSpec, outputSpec):\n \"\"\"\n Filter out arguments that were passed to input that output won't accept.\n\n :param tuple args: The *args that input received.\n :param dict kwargs: The **kwargs that input received.\n :param ArgSpec inputSpec: The input's arg spec.\n :param ArgSpec outputSpec: The output's arg spec.\n :return: The args and kwargs that output will accept.\n :rtype: Tuple[tuple, dict]\n \"\"\"\n named_args = tuple(zip(inputSpec.args[1:], args))\n if outputSpec.varargs:\n # Only return all args if the output accepts *args.\n return_args = args\n else:\n # Filter out arguments that don't appear\n # in the output's method signature.\n return_args = [v for n, v in named_args if n in outputSpec.args]\n\n # Get any of input's default arguments that were not passed.\n passed_arg_names = tuple(kwargs)\n for name, value in named_args:\n passed_arg_names += (name, value)\n defaults = zip(inputSpec.args[::-1], inputSpec.defaults[::-1])\n full_kwargs = {n: v for n, v in defaults if n not in passed_arg_names}\n full_kwargs.update(kwargs)\n\n if outputSpec.varkw:\n # Only pass all kwargs if the output method accepts **kwargs.\n return_kwargs = full_kwargs\n else:\n # Filter out names that the output method does not accept.\n all_accepted_names = outputSpec.args[1:] + outputSpec.kwonlyargs\n return_kwargs = {n: v for n, v in full_kwargs.items()\n if n in all_accepted_names}\n\n return return_args, return_kwargs\n\n\n@attr.s(cmp=False, hash=False)\nclass MethodicalInput(object):\n \"\"\"\n An input for a L{MethodicalMachine}.\n \"\"\"\n automaton = attr.ib(repr=False)\n method = attr.ib(validator=assertNoCode)\n symbol = attr.ib(repr=False)\n collectors = attr.ib(default=attr.Factory(dict), repr=False)\n argSpec = attr.ib(init=False, repr=False)\n\n @argSpec.default\n def _buildArgSpec(self):\n return _getArgSpec(self.method)\n\n def __get__(self, oself, type=None):\n \"\"\"\n Return a function that takes no arguments and returns values returned\n by output functions produced by the given L{MethodicalInput} in\n C{oself}'s current state.\n \"\"\"\n transitioner = _transitionerFromInstance(oself, self.symbol,\n self.automaton)\n @preserveName(self.method)\n @wraps(self.method)\n def doInput(*args, **kwargs):\n self.method(oself, *args, **kwargs)\n previousState = transitioner._state\n (outputs, outTracer) = transitioner.transition(self)\n collector = self.collectors[previousState]\n values = []\n for output in outputs:\n if outTracer:\n outTracer(output._name())\n a, k = _filterArgs(args, kwargs, self.argSpec, output.argSpec)\n value = output(oself, *a, **k)\n values.append(value)\n return collector(values)\n return doInput\n\n def _name(self):\n return self.method.__name__\n\n\n@attr.s(frozen=True)\nclass MethodicalOutput(object):\n \"\"\"\n An output for a L{MethodicalMachine}.\n \"\"\"\n machine = attr.ib(repr=False)\n method = attr.ib()\n argSpec = attr.ib(init=False, repr=False)\n\n @argSpec.default\n def _buildArgSpec(self):\n return _getArgSpec(self.method)\n\n def __get__(self, oself, type=None):\n \"\"\"\n Outputs are private, so raise an exception when we attempt to get one.\n \"\"\"\n raise AttributeError(\n \"{cls}.{method} is a state-machine output method; \"\n \"to produce this output, call an input method instead.\".format(\n cls=type.__name__,\n method=self.method.__name__\n )\n )\n\n\n def __call__(self, oself, *args, **kwargs):\n \"\"\"\n Call the underlying method.\n \"\"\"\n return self.method(oself, *args, **kwargs)\n\n def _name(self):\n return self.method.__name__\n\n@attr.s(cmp=False, hash=False)\nclass MethodicalTracer(object):\n automaton = attr.ib(repr=False)\n symbol = attr.ib(repr=False)\n\n\n def __get__(self, oself, type=None):\n transitioner = _transitionerFromInstance(oself, self.symbol,\n self.automaton)\n def setTrace(tracer):\n transitioner.setTrace(tracer)\n return setTrace\n\n\n\ncounter = count()\ndef gensym():\n \"\"\"\n Create a unique Python identifier.\n \"\"\"\n return \"_symbol_\" + str(next(counter))\n\n\n\nclass MethodicalMachine(object):\n \"\"\"\n A :class:`MethodicalMachine` is an interface to an `Automaton`\n that uses methods on a class.\n \"\"\"\n\n def __init__(self):\n self._automaton = Automaton()\n self._reducers = {}\n self._symbol = gensym()\n\n\n def __get__(self, oself, type=None):\n \"\"\"\n L{MethodicalMachine} is an implementation detail for setting up\n class-level state; applications should never need to access it on an\n instance.\n \"\"\"\n if oself is not None:\n raise AttributeError(\n \"MethodicalMachine is an implementation detail.\")\n return self\n\n\n @_keywords_only\n def state(self, initial=False, terminal=False,\n serialized=None):\n \"\"\"\n Declare a state, possibly an initial state or a terminal state.\n\n This is a decorator for methods, but it will modify the method so as\n not to be callable any more.\n\n :param bool initial: is this state the initial state?\n Only one state on this :class:`automat.MethodicalMachine`\n may be an initial state; more than one is an error.\n\n :param bool terminal: Is this state a terminal state?\n i.e. a state that the machine can end up in?\n (This is purely informational at this point.)\n\n :param Hashable serialized: a serializable value\n to be used to represent this state to external systems.\n This value should be hashable;\n :py:func:`unicode` is a good type to use.\n \"\"\"\n def decorator(stateMethod):\n state = MethodicalState(machine=self,\n method=stateMethod,\n serialized=serialized)\n if initial:\n self._automaton.initialState = state\n return state\n return decorator\n\n\n @_keywords_only\n def input(self):\n \"\"\"\n Declare an input.\n\n This is a decorator for methods.\n \"\"\"\n def decorator(inputMethod):\n return MethodicalInput(automaton=self._automaton,\n method=inputMethod,\n symbol=self._symbol)\n return decorator\n\n\n @_keywords_only\n def output(self):\n \"\"\"\n Declare an output.\n\n This is a decorator for methods.\n\n This method will be called when the state machine transitions to this\n state as specified in the decorated `output` method.\n \"\"\"\n def decorator(outputMethod):\n return MethodicalOutput(machine=self, method=outputMethod)\n return decorator\n\n\n def _oneTransition(self, startState, inputToken, endState, outputTokens,\n collector):\n \"\"\"\n See L{MethodicalState.upon}.\n \"\"\"\n # FIXME: tests for all of this (some of it is wrong)\n # if not isinstance(startState, MethodicalState):\n # raise NotImplementedError(\"start state {} isn't a state\"\n # .format(startState))\n # if not isinstance(inputToken, MethodicalInput):\n # raise NotImplementedError(\"start state {} isn't an input\"\n # .format(inputToken))\n # if not isinstance(endState, MethodicalState):\n # raise NotImplementedError(\"end state {} isn't a state\"\n # .format(startState))\n # for output in outputTokens:\n # if not isinstance(endState, MethodicalState):\n # raise NotImplementedError(\"output state {} isn't a state\"\n # .format(endState))\n self._automaton.addTransition(startState, inputToken, endState,\n tuple(outputTokens))\n inputToken.collectors[startState] = collector\n\n\n @_keywords_only\n def serializer(self):\n \"\"\"\n\n \"\"\"\n def decorator(decoratee):\n @wraps(decoratee)\n def serialize(oself):\n transitioner = _transitionerFromInstance(oself, self._symbol,\n self._automaton)\n return decoratee(oself, transitioner._state.serialized)\n return serialize\n return decorator\n\n @_keywords_only\n def unserializer(self):\n \"\"\"\n\n \"\"\"\n def decorator(decoratee):\n @wraps(decoratee)\n def unserialize(oself, *args, **kwargs):\n state = decoratee(oself, *args, **kwargs)\n mapping = {}\n for eachState in self._automaton.states():\n mapping[eachState.serialized] = eachState\n transitioner = _transitionerFromInstance(\n oself, self._symbol, self._automaton)\n transitioner._state = mapping[state]\n return None # it's on purpose\n return unserialize\n return decorator\n\n @property\n def _setTrace(self):\n return MethodicalTracer(self._automaton, self._symbol)\n\n def asDigraph(self):\n \"\"\"\n Generate a L{graphviz.Digraph} that represents this machine's\n states and transitions.\n\n @return: L{graphviz.Digraph} object; for more information, please\n see the documentation for\n U{graphviz}\n\n \"\"\"\n from ._visualize import makeDigraph\n return makeDigraph(\n self._automaton,\n stateAsString=lambda state: state.method.__name__,\n inputAsString=lambda input: input.method.__name__,\n outputAsString=lambda output: output.method.__name__,\n )\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/automat/_test/__init__.py",
"content": ""
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/automat/_test/test_core.py",
"content": "\nfrom .._core import Automaton, NoTransition\n\nfrom unittest import TestCase\n\nclass CoreTests(TestCase):\n \"\"\"\n Tests for Automat's (currently private, implementation detail) core.\n \"\"\"\n\n def test_NoTransition(self):\n \"\"\"\n A L{NoTransition} exception describes the state and input symbol\n that caused it.\n \"\"\"\n # NoTransition requires two arguments\n with self.assertRaises(TypeError):\n NoTransition()\n\n state = \"current-state\"\n symbol = \"transitionless-symbol\"\n noTransitionException = NoTransition(state=state, symbol=symbol)\n\n self.assertIs(noTransitionException.symbol, symbol)\n\n self.assertIn(state, str(noTransitionException))\n self.assertIn(symbol, str(noTransitionException))\n\n\n def test_noOutputForInput(self):\n \"\"\"\n L{Automaton.outputForInput} raises L{NoTransition} if no\n transition for that input is defined.\n \"\"\"\n a = Automaton()\n self.assertRaises(NoTransition, a.outputForInput,\n \"no-state\", \"no-symbol\")\n\n\n def test_oneTransition(self):\n \"\"\"\n L{Automaton.addTransition} adds its input symbol to\n L{Automaton.inputAlphabet}, all its outputs to\n L{Automaton.outputAlphabet}, and causes L{Automaton.outputForInput} to\n start returning the new state and output symbols.\n \"\"\"\n a = Automaton()\n a.addTransition(\"beginning\", \"begin\", \"ending\", [\"end\"])\n self.assertEqual(a.inputAlphabet(), {\"begin\"})\n self.assertEqual(a.outputAlphabet(), {\"end\"})\n self.assertEqual(a.outputForInput(\"beginning\", \"begin\"),\n (\"ending\", [\"end\"]))\n self.assertEqual(a.states(), {\"beginning\", \"ending\"})\n\n\n def test_oneTransition_nonIterableOutputs(self):\n \"\"\"\n L{Automaton.addTransition} raises a TypeError when given outputs\n that aren't iterable and doesn't add any transitions.\n \"\"\"\n a = Automaton()\n nonIterableOutputs = 1\n self.assertRaises(\n TypeError,\n a.addTransition,\n \"fromState\", \"viaSymbol\", \"toState\", nonIterableOutputs)\n self.assertFalse(a.inputAlphabet())\n self.assertFalse(a.outputAlphabet())\n self.assertFalse(a.states())\n self.assertFalse(a.allTransitions())\n\n\n def test_initialState(self):\n \"\"\"\n L{Automaton.initialState} is a descriptor that sets the initial\n state if it's not yet set, and raises L{ValueError} if it is.\n\n \"\"\"\n a = Automaton()\n a.initialState = \"a state\"\n self.assertEqual(a.initialState, \"a state\")\n with self.assertRaises(ValueError):\n a.initialState = \"another state\"\n\n\n# FIXME: addTransition for transition that's been added before\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/automat/_test/test_discover.py",
"content": "import operator\nimport os\nimport shutil\nimport sys\nimport textwrap\nimport tempfile\nfrom unittest import skipIf, TestCase\n\nimport six\n\n\ndef isTwistedInstalled():\n try:\n __import__('twisted')\n except ImportError:\n return False\n else:\n return True\n\n\nclass _WritesPythonModules(TestCase):\n \"\"\"\n A helper that enables generating Python module test fixtures.\n \"\"\"\n\n def setUp(self):\n super(_WritesPythonModules, self).setUp()\n\n from twisted.python.modules import getModule, PythonPath\n from twisted.python.filepath import FilePath\n\n self.getModule = getModule\n self.PythonPath = PythonPath\n self.FilePath = FilePath\n\n self.originalSysModules = set(sys.modules.keys())\n self.savedSysPath = sys.path[:]\n\n self.pathDir = tempfile.mkdtemp()\n self.makeImportable(self.pathDir)\n\n def tearDown(self):\n super(_WritesPythonModules, self).tearDown()\n\n sys.path[:] = self.savedSysPath\n modulesToDelete = six.viewkeys(sys.modules) - self.originalSysModules\n for module in modulesToDelete:\n del sys.modules[module]\n\n shutil.rmtree(self.pathDir)\n\n def makeImportable(self, path):\n sys.path.append(path)\n\n def writeSourceInto(self, source, path, moduleName):\n directory = self.FilePath(path)\n\n module = directory.child(moduleName)\n # FilePath always opens a file in binary mode - but that will\n # break on Python 3\n with open(module.path, 'w') as f:\n f.write(textwrap.dedent(source))\n\n return self.PythonPath([directory.path])\n\n def makeModule(self, source, path, moduleName):\n pythonModuleName, _ = os.path.splitext(moduleName)\n return self.writeSourceInto(source, path, moduleName)[pythonModuleName]\n\n def attributesAsDict(self, hasIterAttributes):\n return {attr.name: attr for attr in hasIterAttributes.iterAttributes()}\n\n def loadModuleAsDict(self, module):\n module.load()\n return self.attributesAsDict(module)\n\n def makeModuleAsDict(self, source, path, name):\n return self.loadModuleAsDict(self.makeModule(source, path, name))\n\n\n@skipIf(not isTwistedInstalled(), \"Twisted is not installed.\")\nclass OriginalLocationTests(_WritesPythonModules):\n \"\"\"\n Tests that L{isOriginalLocation} detects when a\n L{PythonAttribute}'s FQPN refers to an object inside the module\n where it was defined.\n\n For example: A L{twisted.python.modules.PythonAttribute} with a\n name of 'foo.bar' that refers to a 'bar' object defined in module\n 'baz' does *not* refer to bar's original location, while a\n L{PythonAttribute} with a name of 'baz.bar' does.\n\n \"\"\"\n def setUp(self):\n super(OriginalLocationTests, self).setUp()\n from .._discover import isOriginalLocation\n self.isOriginalLocation = isOriginalLocation\n\n def test_failsWithNoModule(self):\n \"\"\"\n L{isOriginalLocation} returns False when the attribute refers to an\n object whose source module cannot be determined.\n \"\"\"\n source = \"\"\"\\\n class Fake(object):\n pass\n hasEmptyModule = Fake()\n hasEmptyModule.__module__ = None\n \"\"\"\n\n moduleDict = self.makeModuleAsDict(source,\n self.pathDir,\n 'empty_module_attr.py')\n\n self.assertFalse(self.isOriginalLocation(\n moduleDict['empty_module_attr.hasEmptyModule']))\n\n def test_failsWithDifferentModule(self):\n \"\"\"\n L{isOriginalLocation} returns False when the attribute refers to\n an object outside of the module where that object was defined.\n \"\"\"\n originalSource = \"\"\"\\\n class ImportThisClass(object):\n pass\n importThisObject = ImportThisClass()\n importThisNestingObject = ImportThisClass()\n importThisNestingObject.nestedObject = ImportThisClass()\n \"\"\"\n\n importingSource = \"\"\"\\\n from original import (ImportThisClass,\n importThisObject,\n importThisNestingObject)\n \"\"\"\n\n self.makeModule(originalSource, self.pathDir, 'original.py')\n importingDict = self.makeModuleAsDict(importingSource,\n self.pathDir,\n 'importing.py')\n self.assertFalse(\n self.isOriginalLocation(\n importingDict['importing.ImportThisClass']))\n self.assertFalse(\n self.isOriginalLocation(\n importingDict['importing.importThisObject']))\n\n nestingObject = importingDict['importing.importThisNestingObject']\n nestingObjectDict = self.attributesAsDict(nestingObject)\n nestedObject = nestingObjectDict[\n 'importing.importThisNestingObject.nestedObject']\n\n self.assertFalse(self.isOriginalLocation(nestedObject))\n\n def test_succeedsWithSameModule(self):\n \"\"\"\n L{isOriginalLocation} returns True when the attribute refers to an\n object inside the module where that object was defined.\n \"\"\"\n mSource = textwrap.dedent(\"\"\"\n class ThisClassWasDefinedHere(object):\n pass\n anObject = ThisClassWasDefinedHere()\n aNestingObject = ThisClassWasDefinedHere()\n aNestingObject.nestedObject = ThisClassWasDefinedHere()\n \"\"\")\n mDict = self.makeModuleAsDict(mSource, self.pathDir, 'm.py')\n self.assertTrue(self.isOriginalLocation(\n mDict['m.ThisClassWasDefinedHere']))\n self.assertTrue(self.isOriginalLocation(mDict['m.aNestingObject']))\n\n nestingObject = mDict['m.aNestingObject']\n nestingObjectDict = self.attributesAsDict(nestingObject)\n nestedObject = nestingObjectDict['m.aNestingObject.nestedObject']\n\n self.assertTrue(self.isOriginalLocation(nestedObject))\n\n\n@skipIf(not isTwistedInstalled(), \"Twisted is not installed.\")\nclass FindMachinesViaWrapperTests(_WritesPythonModules):\n \"\"\"\n L{findMachinesViaWrapper} recursively yields FQPN,\n L{MethodicalMachine} pairs in and under a given\n L{twisted.python.modules.PythonModule} or\n L{twisted.python.modules.PythonAttribute}.\n \"\"\"\n TEST_MODULE_SOURCE = \"\"\"\n from automat import MethodicalMachine\n\n\n class PythonClass(object):\n _classMachine = MethodicalMachine()\n\n class NestedClass(object):\n _nestedClassMachine = MethodicalMachine()\n\n ignoredAttribute = \"I am ignored.\"\n\n def ignoredMethod(self):\n \"I am also ignored.\"\n\n rootLevelMachine = MethodicalMachine()\n ignoredPythonObject = PythonClass()\n anotherIgnoredPythonObject = \"I am ignored.\"\n \"\"\"\n\n def setUp(self):\n super(FindMachinesViaWrapperTests, self).setUp()\n from .._discover import findMachinesViaWrapper\n self.findMachinesViaWrapper = findMachinesViaWrapper\n\n def test_yieldsMachine(self):\n \"\"\"\n When given a L{twisted.python.modules.PythonAttribute} that refers\n directly to a L{MethodicalMachine}, L{findMachinesViaWrapper}\n yields that machine and its FQPN.\n \"\"\"\n source = \"\"\"\\\n from automat import MethodicalMachine\n\n rootMachine = MethodicalMachine()\n \"\"\"\n\n moduleDict = self.makeModuleAsDict(source, self.pathDir, 'root.py')\n rootMachine = moduleDict['root.rootMachine']\n self.assertIn(('root.rootMachine', rootMachine.load()),\n list(self.findMachinesViaWrapper(rootMachine)))\n\n def test_yieldsMachineInClass(self):\n \"\"\"\n When given a L{twisted.python.modules.PythonAttribute} that refers\n to a class that contains a L{MethodicalMachine} as a class\n variable, L{findMachinesViaWrapper} yields that machine and\n its FQPN.\n \"\"\"\n source = \"\"\"\\\n from automat import MethodicalMachine\n\n class PythonClass(object):\n _classMachine = MethodicalMachine()\n \"\"\"\n moduleDict = self.makeModuleAsDict(source, self.pathDir, 'clsmod.py')\n PythonClass = moduleDict['clsmod.PythonClass']\n self.assertIn(('clsmod.PythonClass._classMachine',\n PythonClass.load()._classMachine),\n list(self.findMachinesViaWrapper(PythonClass)))\n\n def test_yieldsMachineInNestedClass(self):\n \"\"\"\n When given a L{twisted.python.modules.PythonAttribute} that refers\n to a nested class that contains a L{MethodicalMachine} as a\n class variable, L{findMachinesViaWrapper} yields that machine\n and its FQPN.\n \"\"\"\n source = \"\"\"\\\n from automat import MethodicalMachine\n\n class PythonClass(object):\n class NestedClass(object):\n _classMachine = MethodicalMachine()\n \"\"\"\n moduleDict = self.makeModuleAsDict(source,\n self.pathDir,\n 'nestedcls.py')\n\n PythonClass = moduleDict['nestedcls.PythonClass']\n self.assertIn(('nestedcls.PythonClass.NestedClass._classMachine',\n PythonClass.load().NestedClass._classMachine),\n list(self.findMachinesViaWrapper(PythonClass)))\n\n def test_yieldsMachineInModule(self):\n \"\"\"\n When given a L{twisted.python.modules.PythonModule} that refers to\n a module that contains a L{MethodicalMachine},\n L{findMachinesViaWrapper} yields that machine and its FQPN.\n \"\"\"\n source = \"\"\"\\\n from automat import MethodicalMachine\n\n rootMachine = MethodicalMachine()\n \"\"\"\n module = self.makeModule(source, self.pathDir, 'root.py')\n rootMachine = self.loadModuleAsDict(module)['root.rootMachine'].load()\n self.assertIn(('root.rootMachine', rootMachine),\n list(self.findMachinesViaWrapper(module)))\n\n def test_yieldsMachineInClassInModule(self):\n \"\"\"\n When given a L{twisted.python.modules.PythonModule} that refers to\n the original module of a class containing a\n L{MethodicalMachine}, L{findMachinesViaWrapper} yields that\n machine and its FQPN.\n \"\"\"\n source = \"\"\"\\\n from automat import MethodicalMachine\n\n class PythonClass(object):\n _classMachine = MethodicalMachine()\n \"\"\"\n module = self.makeModule(source, self.pathDir, 'clsmod.py')\n PythonClass = self.loadModuleAsDict(\n module)['clsmod.PythonClass'].load()\n self.assertIn(('clsmod.PythonClass._classMachine',\n PythonClass._classMachine),\n list(self.findMachinesViaWrapper(module)))\n\n def test_yieldsMachineInNestedClassInModule(self):\n \"\"\"\n When given a L{twisted.python.modules.PythonModule} that refers to\n the original module of a nested class containing a\n L{MethodicalMachine}, L{findMachinesViaWrapper} yields that\n machine and its FQPN.\n \"\"\"\n source = \"\"\"\\\n from automat import MethodicalMachine\n\n class PythonClass(object):\n class NestedClass(object):\n _classMachine = MethodicalMachine()\n \"\"\"\n module = self.makeModule(source, self.pathDir, 'nestedcls.py')\n PythonClass = self.loadModuleAsDict(\n module)['nestedcls.PythonClass'].load()\n\n self.assertIn(('nestedcls.PythonClass.NestedClass._classMachine',\n PythonClass.NestedClass._classMachine),\n list(self.findMachinesViaWrapper(module)))\n\n def test_ignoresImportedClass(self):\n \"\"\"\n When given a L{twisted.python.modules.PythonAttribute} that refers\n to a class imported from another module, any\n L{MethodicalMachine}s on that class are ignored.\n\n This behavior ensures that a machine is only discovered on a\n class when visiting the module where that class was defined.\n \"\"\"\n originalSource = \"\"\"\n from automat import MethodicalMachine\n\n class PythonClass(object):\n _classMachine = MethodicalMachine()\n \"\"\"\n\n importingSource = \"\"\"\n from original import PythonClass\n \"\"\"\n\n self.makeModule(originalSource, self.pathDir, 'original.py')\n importingModule = self.makeModule(importingSource,\n self.pathDir,\n 'importing.py')\n\n self.assertFalse(list(self.findMachinesViaWrapper(importingModule)))\n\n def test_descendsIntoPackages(self):\n \"\"\"\n L{findMachinesViaWrapper} descends into packages to discover\n machines.\n \"\"\"\n pythonPath = self.PythonPath([self.pathDir])\n package = self.FilePath(self.pathDir).child(\"test_package\")\n package.makedirs()\n package.child('__init__.py').touch()\n\n source = \"\"\"\n from automat import MethodicalMachine\n\n\n class PythonClass(object):\n _classMachine = MethodicalMachine()\n\n\n rootMachine = MethodicalMachine()\n \"\"\"\n self.makeModule(source, package.path, 'module.py')\n\n test_package = pythonPath['test_package']\n machines = sorted(self.findMachinesViaWrapper(test_package),\n key=operator.itemgetter(0))\n\n moduleDict = self.loadModuleAsDict(test_package['module'])\n rootMachine = moduleDict['test_package.module.rootMachine'].load()\n PythonClass = moduleDict['test_package.module.PythonClass'].load()\n\n expectedMachines = sorted(\n [('test_package.module.rootMachine',\n rootMachine),\n ('test_package.module.PythonClass._classMachine',\n PythonClass._classMachine)], key=operator.itemgetter(0))\n\n self.assertEqual(expectedMachines, machines)\n\n def test_infiniteLoop(self):\n \"\"\"\n L{findMachinesViaWrapper} ignores infinite loops.\n\n Note this test can't fail - it can only run forever!\n \"\"\"\n source = \"\"\"\n class InfiniteLoop(object):\n pass\n\n InfiniteLoop.loop = InfiniteLoop\n \"\"\"\n module = self.makeModule(source, self.pathDir, 'loop.py')\n self.assertFalse(list(self.findMachinesViaWrapper(module)))\n\n\n@skipIf(not isTwistedInstalled(), \"Twisted is not installed.\")\nclass WrapFQPNTests(TestCase):\n \"\"\"\n Tests that ensure L{wrapFQPN} loads the\n L{twisted.python.modules.PythonModule} or\n L{twisted.python.modules.PythonAttribute} for a given FQPN.\n \"\"\"\n\n def setUp(self):\n from twisted.python.modules import PythonModule, PythonAttribute\n from .._discover import wrapFQPN, InvalidFQPN, NoModule, NoObject\n\n self.PythonModule = PythonModule\n self.PythonAttribute = PythonAttribute\n self.wrapFQPN = wrapFQPN\n self.InvalidFQPN = InvalidFQPN\n self.NoModule = NoModule\n self.NoObject = NoObject\n\n def assertModuleWrapperRefersTo(self, moduleWrapper, module):\n \"\"\"\n Assert that a L{twisted.python.modules.PythonModule} refers to a\n particular Python module.\n \"\"\"\n self.assertIsInstance(moduleWrapper, self.PythonModule)\n self.assertEqual(moduleWrapper.name, module.__name__)\n self.assertIs(moduleWrapper.load(), module)\n\n def assertAttributeWrapperRefersTo(self, attributeWrapper, fqpn, obj):\n \"\"\"\n Assert that a L{twisted.python.modules.PythonAttribute} refers to a\n particular Python object.\n \"\"\"\n self.assertIsInstance(attributeWrapper, self.PythonAttribute)\n self.assertEqual(attributeWrapper.name, fqpn)\n self.assertIs(attributeWrapper.load(), obj)\n\n def test_failsWithEmptyFQPN(self):\n \"\"\"\n L{wrapFQPN} raises L{InvalidFQPN} when given an empty string.\n \"\"\"\n with self.assertRaises(self.InvalidFQPN):\n self.wrapFQPN('')\n\n def test_failsWithBadDotting(self):\n \"\"\"\"\n L{wrapFQPN} raises L{InvalidFQPN} when given a badly-dotted\n FQPN. (e.g., x..y).\n \"\"\"\n for bad in ('.fails', 'fails.', 'this..fails'):\n with self.assertRaises(self.InvalidFQPN):\n self.wrapFQPN(bad)\n\n def test_singleModule(self):\n \"\"\"\n L{wrapFQPN} returns a L{twisted.python.modules.PythonModule}\n referring to the single module a dotless FQPN describes.\n \"\"\"\n import os\n\n moduleWrapper = self.wrapFQPN('os')\n\n self.assertIsInstance(moduleWrapper, self.PythonModule)\n self.assertIs(moduleWrapper.load(), os)\n\n def test_failsWithMissingSingleModuleOrPackage(self):\n \"\"\"\n L{wrapFQPN} raises L{NoModule} when given a dotless FQPN that does\n not refer to a module or package.\n \"\"\"\n with self.assertRaises(self.NoModule):\n self.wrapFQPN(\"this is not an acceptable name!\")\n\n def test_singlePackage(self):\n \"\"\"\n L{wrapFQPN} returns a L{twisted.python.modules.PythonModule}\n referring to the single package a dotless FQPN describes.\n \"\"\"\n import xml\n self.assertModuleWrapperRefersTo(self.wrapFQPN('xml'), xml)\n\n def test_multiplePackages(self):\n \"\"\"\n L{wrapFQPN} returns a L{twisted.python.modules.PythonModule}\n referring to the deepest package described by dotted FQPN.\n \"\"\"\n import xml.etree\n self.assertModuleWrapperRefersTo(self.wrapFQPN('xml.etree'), xml.etree)\n\n def test_multiplePackagesFinalModule(self):\n \"\"\"\n L{wrapFQPN} returns a L{twisted.python.modules.PythonModule}\n referring to the deepest module described by dotted FQPN.\n \"\"\"\n import xml.etree.ElementTree\n self.assertModuleWrapperRefersTo(\n self.wrapFQPN('xml.etree.ElementTree'), xml.etree.ElementTree)\n\n def test_singleModuleObject(self):\n \"\"\"\n L{wrapFQPN} returns a L{twisted.python.modules.PythonAttribute}\n referring to the deepest object an FQPN names, traversing one module.\n \"\"\"\n import os\n self.assertAttributeWrapperRefersTo(\n self.wrapFQPN('os.path'), 'os.path', os.path)\n\n def test_multiplePackagesObject(self):\n \"\"\"\n L{wrapFQPN} returns a L{twisted.python.modules.PythonAttribute}\n referring to the deepest object described by an FQPN,\n descending through several packages.\n \"\"\"\n import xml.etree.ElementTree\n import automat\n\n for fqpn, obj in [('xml.etree.ElementTree.fromstring',\n xml.etree.ElementTree.fromstring),\n ('automat.MethodicalMachine.__doc__',\n automat.MethodicalMachine.__doc__)]:\n self.assertAttributeWrapperRefersTo(\n self.wrapFQPN(fqpn), fqpn, obj)\n\n def test_failsWithMultiplePackagesMissingModuleOrPackage(self):\n \"\"\"\n L{wrapFQPN} raises L{NoObject} when given an FQPN that contains a\n missing attribute, module, or package.\n \"\"\"\n for bad in ('xml.etree.nope!',\n 'xml.etree.nope!.but.the.rest.is.believable'):\n with self.assertRaises(self.NoObject):\n self.wrapFQPN(bad)\n\n\n@skipIf(not isTwistedInstalled(), \"Twisted is not installed.\")\nclass FindMachinesIntegrationTests(_WritesPythonModules):\n \"\"\"\n Integration tests to check that L{findMachines} yields all\n machines discoverable at or below an FQPN.\n \"\"\"\n\n SOURCE = \"\"\"\n from automat import MethodicalMachine\n\n class PythonClass(object):\n _machine = MethodicalMachine()\n ignored = \"i am ignored\"\n\n rootLevel = MethodicalMachine()\n\n ignored = \"i am ignored\"\n \"\"\"\n\n def setUp(self):\n super(FindMachinesIntegrationTests, self).setUp()\n from .._discover import findMachines\n\n self.findMachines = findMachines\n\n packageDir = self.FilePath(self.pathDir).child(\"test_package\")\n packageDir.makedirs()\n self.pythonPath = self.PythonPath([self.pathDir])\n self.writeSourceInto(self.SOURCE, packageDir.path, '__init__.py')\n\n subPackageDir = packageDir.child('subpackage')\n subPackageDir.makedirs()\n subPackageDir.child('__init__.py').touch()\n\n self.makeModule(self.SOURCE, subPackageDir.path, 'module.py')\n\n self.packageDict = self.loadModuleAsDict(\n self.pythonPath['test_package'])\n self.moduleDict = self.loadModuleAsDict(\n self.pythonPath['test_package']['subpackage']['module'])\n\n def test_discoverAll(self):\n \"\"\"\n Given a top-level package FQPN, L{findMachines} discovers all\n L{MethodicalMachine} instances in and below it.\n \"\"\"\n machines = sorted(self.findMachines('test_package'),\n key=operator.itemgetter(0))\n\n tpRootLevel = self.packageDict['test_package.rootLevel'].load()\n tpPythonClass = self.packageDict['test_package.PythonClass'].load()\n\n mRLAttr = self.moduleDict['test_package.subpackage.module.rootLevel']\n mRootLevel = mRLAttr.load()\n mPCAttr = self.moduleDict['test_package.subpackage.module.PythonClass']\n mPythonClass = mPCAttr.load()\n\n expectedMachines = sorted(\n [('test_package.rootLevel', tpRootLevel),\n ('test_package.PythonClass._machine', tpPythonClass._machine),\n ('test_package.subpackage.module.rootLevel', mRootLevel),\n ('test_package.subpackage.module.PythonClass._machine',\n mPythonClass._machine)],\n key=operator.itemgetter(0))\n\n self.assertEqual(expectedMachines, machines)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/automat/_test/test_methodical.py",
"content": "\n\"\"\"\nTests for the public interface of Automat.\n\"\"\"\n\nfrom functools import reduce\nfrom unittest import TestCase\n\nfrom automat._methodical import ArgSpec, _getArgNames, _getArgSpec, _filterArgs\nfrom .. import MethodicalMachine, NoTransition\nfrom .. import _methodical\n\n\nclass MethodicalTests(TestCase):\n \"\"\"\n Tests for L{MethodicalMachine}.\n \"\"\"\n\n def test_oneTransition(self):\n \"\"\"\n L{MethodicalMachine} provides a way for you to declare a state machine\n with inputs, outputs, and states as methods. When you have declared an\n input, an output, and a state, calling the input method in that state\n will produce the specified output.\n \"\"\"\n\n class Machination(object):\n machine = MethodicalMachine()\n @machine.input()\n def anInput(self):\n \"an input\"\n\n @machine.output()\n def anOutput(self):\n \"an output\"\n return \"an-output-value\"\n\n @machine.output()\n def anotherOutput(self):\n \"another output\"\n return \"another-output-value\"\n\n @machine.state(initial=True)\n def anState(self):\n \"a state\"\n\n @machine.state()\n def anotherState(self):\n \"another state\"\n\n anState.upon(anInput, enter=anotherState, outputs=[anOutput])\n anotherState.upon(anInput, enter=anotherState,\n outputs=[anotherOutput])\n\n m = Machination()\n self.assertEqual(m.anInput(), [\"an-output-value\"])\n self.assertEqual(m.anInput(), [\"another-output-value\"])\n\n\n def test_machineItselfIsPrivate(self):\n \"\"\"\n L{MethodicalMachine} is an implementation detail. If you attempt to\n access it on an instance of your class, you will get an exception.\n However, since tools may need to access it for the purposes of, for\n example, visualization, you may access it on the class itself.\n \"\"\"\n expectedMachine = MethodicalMachine()\n class Machination(object):\n machine = expectedMachine\n machination = Machination()\n with self.assertRaises(AttributeError) as cm:\n machination.machine\n self.assertIn(\"MethodicalMachine is an implementation detail\",\n str(cm.exception))\n self.assertIs(Machination.machine, expectedMachine)\n\n\n def test_outputsArePrivate(self):\n \"\"\"\n One of the benefits of using a state machine is that your output method\n implementations don't need to take invalid state transitions into\n account - the methods simply won't be called. This property would be\n broken if client code called output methods directly, so output methods\n are not directly visible under their names.\n \"\"\"\n class Machination(object):\n machine = MethodicalMachine()\n counter = 0\n @machine.input()\n def anInput(self):\n \"an input\"\n @machine.output()\n def anOutput(self):\n self.counter += 1\n @machine.state(initial=True)\n def state(self):\n \"a machine state\"\n state.upon(anInput, enter=state, outputs=[anOutput])\n mach1 = Machination()\n mach1.anInput()\n self.assertEqual(mach1.counter, 1)\n mach2 = Machination()\n with self.assertRaises(AttributeError) as cm:\n mach2.anOutput\n self.assertEqual(mach2.counter, 0)\n\n self.assertIn(\n \"Machination.anOutput is a state-machine output method; to \"\n \"produce this output, call an input method instead.\",\n str(cm.exception)\n )\n\n\n def test_multipleMachines(self):\n \"\"\"\n Two machines may co-exist happily on the same instance; they don't\n interfere with each other.\n \"\"\"\n class MultiMach(object):\n a = MethodicalMachine()\n b = MethodicalMachine()\n\n @a.input()\n def inputA(self):\n \"input A\"\n @b.input()\n def inputB(self):\n \"input B\"\n @a.state(initial=True)\n def initialA(self):\n \"initial A\"\n @b.state(initial=True)\n def initialB(self):\n \"initial B\"\n @a.output()\n def outputA(self):\n return \"A\"\n @b.output()\n def outputB(self):\n return \"B\"\n initialA.upon(inputA, initialA, [outputA])\n initialB.upon(inputB, initialB, [outputB])\n\n mm = MultiMach()\n self.assertEqual(mm.inputA(), [\"A\"])\n self.assertEqual(mm.inputB(), [\"B\"])\n\n\n def test_collectOutputs(self):\n \"\"\"\n Outputs can be combined with the \"collector\" argument to \"upon\".\n \"\"\"\n import operator\n class Machine(object):\n m = MethodicalMachine()\n @m.input()\n def input(self):\n \"an input\"\n @m.output()\n def outputA(self):\n return \"A\"\n @m.output()\n def outputB(self):\n return \"B\"\n @m.state(initial=True)\n def state(self):\n \"a state\"\n state.upon(input, state, [outputA, outputB],\n collector=lambda x: reduce(operator.add, x))\n m = Machine()\n self.assertEqual(m.input(), \"AB\")\n\n\n def test_methodName(self):\n \"\"\"\n Input methods preserve their declared names.\n \"\"\"\n class Mech(object):\n m = MethodicalMachine()\n @m.input()\n def declaredInputName(self):\n \"an input\"\n @m.state(initial=True)\n def aState(self):\n \"state\"\n m = Mech()\n with self.assertRaises(TypeError) as cm:\n m.declaredInputName(\"too\", \"many\", \"arguments\")\n self.assertIn(\"declaredInputName\", str(cm.exception))\n\n\n def test_inputWithArguments(self):\n \"\"\"\n If an input takes an argument, it will pass that along to its output.\n \"\"\"\n class Mechanism(object):\n m = MethodicalMachine()\n @m.input()\n def input(self, x, y=1):\n \"an input\"\n @m.state(initial=True)\n def state(self):\n \"a state\"\n @m.output()\n def output(self, x, y=1):\n self._x = x\n return x + y\n state.upon(input, state, [output])\n\n m = Mechanism()\n self.assertEqual(m.input(3), [4])\n self.assertEqual(m._x, 3)\n\n\n def test_outputWithSubsetOfArguments(self):\n \"\"\"\n Inputs pass arguments that output will accept.\n \"\"\"\n class Mechanism(object):\n m = MethodicalMachine()\n @m.input()\n def input(self, x, y=1):\n \"an input\"\n @m.state(initial=True)\n def state(self):\n \"a state\"\n @m.output()\n def outputX(self, x):\n self._x = x\n return x\n @m.output()\n def outputY(self, y):\n self._y = y\n return y\n @m.output()\n def outputNoArgs(self):\n return None\n state.upon(input, state, [outputX, outputY, outputNoArgs])\n\n m = Mechanism()\n\n # Pass x as positional argument.\n self.assertEqual(m.input(3), [3, 1, None])\n self.assertEqual(m._x, 3)\n self.assertEqual(m._y, 1)\n\n # Pass x as key word argument.\n self.assertEqual(m.input(x=4), [4, 1, None])\n self.assertEqual(m._x, 4)\n self.assertEqual(m._y, 1)\n\n # Pass y as positional argument.\n self.assertEqual(m.input(6, 3), [6, 3, None])\n self.assertEqual(m._x, 6)\n self.assertEqual(m._y, 3)\n\n # Pass y as key word argument.\n self.assertEqual(m.input(5, y=2), [5, 2, None])\n self.assertEqual(m._x, 5)\n self.assertEqual(m._y, 2)\n\n\n def test_inputFunctionsMustBeEmpty(self):\n \"\"\"\n The wrapped input function must have an empty body.\n \"\"\"\n # input functions are executed to assert that the signature matches,\n # but their body must be empty\n\n _methodical._empty() # chase coverage\n _methodical._docstring()\n\n class Mechanism(object):\n m = MethodicalMachine()\n with self.assertRaises(ValueError) as cm:\n @m.input()\n def input(self):\n \"an input\"\n list() # pragma: no cover\n self.assertEqual(str(cm.exception), \"function body must be empty\")\n\n # all three of these cases should be valid. Functions/methods with\n # docstrings produce slightly different bytecode than ones without.\n\n class MechanismWithDocstring(object):\n m = MethodicalMachine()\n @m.input()\n def input(self):\n \"an input\"\n @m.state(initial=True)\n def start(self):\n \"starting state\"\n start.upon(input, enter=start, outputs=[])\n MechanismWithDocstring().input()\n\n class MechanismWithPass(object):\n m = MethodicalMachine()\n @m.input()\n def input(self):\n pass\n @m.state(initial=True)\n def start(self):\n \"starting state\"\n start.upon(input, enter=start, outputs=[])\n MechanismWithPass().input()\n\n class MechanismWithDocstringAndPass(object):\n m = MethodicalMachine()\n @m.input()\n def input(self):\n \"an input\"\n pass\n @m.state(initial=True)\n def start(self):\n \"starting state\"\n start.upon(input, enter=start, outputs=[])\n MechanismWithDocstringAndPass().input()\n\n class MechanismReturnsNone(object):\n m = MethodicalMachine()\n @m.input()\n def input(self):\n return None\n @m.state(initial=True)\n def start(self):\n \"starting state\"\n start.upon(input, enter=start, outputs=[])\n MechanismReturnsNone().input()\n\n class MechanismWithDocstringAndReturnsNone(object):\n m = MethodicalMachine()\n @m.input()\n def input(self):\n \"an input\"\n return None\n @m.state(initial=True)\n def start(self):\n \"starting state\"\n start.upon(input, enter=start, outputs=[])\n MechanismWithDocstringAndReturnsNone().input()\n\n\n def test_inputOutputMismatch(self):\n \"\"\"\n All the argument lists of the outputs for a given input must match; if\n one does not the call to C{upon} will raise a C{TypeError}.\n \"\"\"\n class Mechanism(object):\n m = MethodicalMachine()\n @m.input()\n def nameOfInput(self, a):\n \"an input\"\n @m.output()\n def outputThatMatches(self, a):\n \"an output that matches\"\n @m.output()\n def outputThatDoesntMatch(self, b):\n \"an output that doesn't match\"\n @m.state()\n def state(self):\n \"a state\"\n with self.assertRaises(TypeError) as cm:\n state.upon(nameOfInput, state, [outputThatMatches,\n outputThatDoesntMatch])\n self.assertIn(\"nameOfInput\", str(cm.exception))\n self.assertIn(\"outputThatDoesntMatch\", str(cm.exception))\n\n\n def test_getArgNames(self):\n \"\"\"\n Type annotations should be included in the set of\n \"\"\"\n spec = ArgSpec(\n args=('a', 'b'),\n varargs=None,\n varkw=None,\n defaults=None,\n kwonlyargs=(),\n kwonlydefaults=None,\n annotations=(('a', int), ('b', str)),\n )\n self.assertEqual(\n _getArgNames(spec),\n {'a', 'b', ('a', int), ('b', str)},\n )\n\n\n def test_filterArgs(self):\n \"\"\"\n filterArgs() should not filter the `args` parameter\n if outputSpec accepts `*args`.\n \"\"\"\n inputSpec = _getArgSpec(lambda *args, **kwargs: None)\n outputSpec = _getArgSpec(lambda *args, **kwargs: None)\n argsIn = ()\n argsOut, _ = _filterArgs(argsIn, {}, inputSpec, outputSpec)\n self.assertIs(argsIn, argsOut)\n\n\n def test_multipleInitialStatesFailure(self):\n \"\"\"\n A L{MethodicalMachine} can only have one initial state.\n \"\"\"\n\n class WillFail(object):\n m = MethodicalMachine()\n\n @m.state(initial=True)\n def firstInitialState(self):\n \"The first initial state -- this is OK.\"\n\n with self.assertRaises(ValueError):\n @m.state(initial=True)\n def secondInitialState(self):\n \"The second initial state -- results in a ValueError.\"\n\n\n def test_multipleTransitionsFailure(self):\n \"\"\"\n A L{MethodicalMachine} can only have one transition per start/event\n pair.\n \"\"\"\n\n class WillFail(object):\n m = MethodicalMachine()\n\n @m.state(initial=True)\n def start(self):\n \"We start here.\"\n @m.state()\n def end(self):\n \"Rainbows end.\"\n\n @m.input()\n def event(self):\n \"An event.\"\n start.upon(event, enter=end, outputs=[])\n with self.assertRaises(ValueError):\n start.upon(event, enter=end, outputs=[])\n\n\n def test_badTransitionForCurrentState(self):\n \"\"\"\n Calling any input method that lacks a transition for the machine's\n current state raises an informative L{NoTransition}.\n \"\"\"\n\n class OnlyOnePath(object):\n m = MethodicalMachine()\n @m.state(initial=True)\n def start(self):\n \"Start state.\"\n @m.state()\n def end(self):\n \"End state.\"\n @m.input()\n def advance(self):\n \"Move from start to end.\"\n @m.input()\n def deadEnd(self):\n \"A transition from nowhere to nowhere.\"\n start.upon(advance, end, [])\n\n machine = OnlyOnePath()\n with self.assertRaises(NoTransition) as cm:\n machine.deadEnd()\n self.assertIn(\"deadEnd\", str(cm.exception))\n self.assertIn(\"start\", str(cm.exception))\n machine.advance()\n with self.assertRaises(NoTransition) as cm:\n machine.deadEnd()\n self.assertIn(\"deadEnd\", str(cm.exception))\n self.assertIn(\"end\", str(cm.exception))\n\n\n def test_saveState(self):\n \"\"\"\n L{MethodicalMachine.serializer} is a decorator that modifies its\n decoratee's signature to take a \"state\" object as its first argument,\n which is the \"serialized\" argument to the L{MethodicalMachine.state}\n decorator.\n \"\"\"\n\n class Mechanism(object):\n m = MethodicalMachine()\n def __init__(self):\n self.value = 1\n @m.state(serialized=\"first-state\", initial=True)\n def first(self):\n \"First state.\"\n @m.state(serialized=\"second-state\")\n def second(self):\n \"Second state.\"\n @m.serializer()\n def save(self, state):\n return {\n 'machine-state': state,\n 'some-value': self.value,\n }\n\n self.assertEqual(\n Mechanism().save(),\n {\n \"machine-state\": \"first-state\",\n \"some-value\": 1,\n }\n )\n\n\n def test_restoreState(self):\n \"\"\"\n L{MethodicalMachine.unserializer} decorates a function that becomes a\n machine-state unserializer; its return value is mapped to the\n C{serialized} parameter to C{state}, and the L{MethodicalMachine}\n associated with that instance's state is updated to that state.\n \"\"\"\n\n class Mechanism(object):\n m = MethodicalMachine()\n def __init__(self):\n self.value = 1\n self.ranOutput = False\n @m.state(serialized=\"first-state\", initial=True)\n def first(self):\n \"First state.\"\n @m.state(serialized=\"second-state\")\n def second(self):\n \"Second state.\"\n @m.input()\n def input(self):\n \"an input\"\n @m.output()\n def output(self):\n self.value = 2\n self.ranOutput = True\n return 1\n @m.output()\n def output2(self):\n return 2\n first.upon(input, second, [output],\n collector=lambda x: list(x)[0])\n second.upon(input, second, [output2],\n collector=lambda x: list(x)[0])\n @m.serializer()\n def save(self, state):\n return {\n 'machine-state': state,\n 'some-value': self.value,\n }\n\n @m.unserializer()\n def _restore(self, blob):\n self.value = blob['some-value']\n return blob['machine-state']\n\n @classmethod\n def fromBlob(cls, blob):\n self = cls()\n self._restore(blob)\n return self\n\n m1 = Mechanism()\n m1.input()\n blob = m1.save()\n m2 = Mechanism.fromBlob(blob)\n self.assertEqual(m2.ranOutput, False)\n self.assertEqual(m2.input(), 2)\n self.assertEqual(\n m2.save(),\n {\n 'machine-state': 'second-state',\n 'some-value': 2,\n }\n )\n\n\n\n# FIXME: error for wrong types on any call to _oneTransition\n# FIXME: better public API for .upon; maybe a context manager?\n# FIXME: when transitions are defined, validate that we can always get to\n# terminal? do we care about this?\n# FIXME: implementation (and use-case/example) for passing args from in to out\n\n# FIXME: possibly these need some kind of support from core\n# FIXME: wildcard state (in all states, when input X, emit Y and go to Z)\n# FIXME: wildcard input (in state X, when any input, emit Y and go to Z)\n# FIXME: combined wildcards (in any state for any input, emit Y go to Z)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/automat/_test/test_trace.py",
"content": "from unittest import TestCase\nfrom .._methodical import MethodicalMachine\n\nclass SampleObject(object):\n mm = MethodicalMachine()\n\n @mm.state(initial=True)\n def begin(self):\n \"initial state\"\n @mm.state()\n def middle(self):\n \"middle state\"\n @mm.state()\n def end(self):\n \"end state\"\n\n @mm.input()\n def go1(self):\n \"sample input\"\n @mm.input()\n def go2(self):\n \"sample input\"\n @mm.input()\n def back(self):\n \"sample input\"\n\n @mm.output()\n def out(self):\n \"sample output\"\n\n setTrace = mm._setTrace\n\n begin.upon(go1, middle, [out])\n middle.upon(go2, end, [out])\n end.upon(back, middle, [])\n middle.upon(back, begin, [])\n\nclass TraceTests(TestCase):\n def test_only_inputs(self):\n traces = []\n def tracer(old_state, input, new_state):\n traces.append((old_state, input, new_state))\n return None # \"I only care about inputs, not outputs\"\n s = SampleObject()\n s.setTrace(tracer)\n\n s.go1()\n self.assertEqual(traces, [(\"begin\", \"go1\", \"middle\"),\n ])\n\n s.go2()\n self.assertEqual(traces, [(\"begin\", \"go1\", \"middle\"),\n (\"middle\", \"go2\", \"end\"),\n ])\n s.setTrace(None)\n s.back()\n self.assertEqual(traces, [(\"begin\", \"go1\", \"middle\"),\n (\"middle\", \"go2\", \"end\"),\n ])\n s.go2()\n self.assertEqual(traces, [(\"begin\", \"go1\", \"middle\"),\n (\"middle\", \"go2\", \"end\"),\n ])\n\n def test_inputs_and_outputs(self):\n traces = []\n def tracer(old_state, input, new_state):\n traces.append((old_state, input, new_state, None))\n def trace_outputs(output):\n traces.append((old_state, input, new_state, output))\n return trace_outputs # \"I care about outputs too\"\n s = SampleObject()\n s.setTrace(tracer)\n\n s.go1()\n self.assertEqual(traces, [(\"begin\", \"go1\", \"middle\", None),\n (\"begin\", \"go1\", \"middle\", \"out\"),\n ])\n\n s.go2()\n self.assertEqual(traces, [(\"begin\", \"go1\", \"middle\", None),\n (\"begin\", \"go1\", \"middle\", \"out\"),\n (\"middle\", \"go2\", \"end\", None),\n (\"middle\", \"go2\", \"end\", \"out\"),\n ])\n s.setTrace(None)\n s.back()\n self.assertEqual(traces, [(\"begin\", \"go1\", \"middle\", None),\n (\"begin\", \"go1\", \"middle\", \"out\"),\n (\"middle\", \"go2\", \"end\", None),\n (\"middle\", \"go2\", \"end\", \"out\"),\n ])\n s.go2()\n self.assertEqual(traces, [(\"begin\", \"go1\", \"middle\", None),\n (\"begin\", \"go1\", \"middle\", \"out\"),\n (\"middle\", \"go2\", \"end\", None),\n (\"middle\", \"go2\", \"end\", \"out\"),\n ])\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/automat/_test/test_visualize.py",
"content": "from __future__ import print_function\nimport functools\n\nimport os\nimport subprocess\nfrom unittest import TestCase, skipIf\n\nimport attr\n\nfrom .._methodical import MethodicalMachine\n\nfrom .test_discover import isTwistedInstalled\n\n\ndef isGraphvizModuleInstalled():\n \"\"\"\n Is the graphviz Python module installed?\n \"\"\"\n try:\n __import__(\"graphviz\")\n except ImportError:\n return False\n else:\n return True\n\n\ndef isGraphvizInstalled():\n \"\"\"\n Are the graphviz tools installed?\n \"\"\"\n r, w = os.pipe()\n os.close(w)\n try:\n return not subprocess.call(\"dot\", stdin=r, shell=True)\n finally:\n os.close(r)\n\n\n\ndef sampleMachine():\n \"\"\"\n Create a sample L{MethodicalMachine} with some sample states.\n \"\"\"\n mm = MethodicalMachine()\n class SampleObject(object):\n @mm.state(initial=True)\n def begin(self):\n \"initial state\"\n @mm.state()\n def end(self):\n \"end state\"\n @mm.input()\n def go(self):\n \"sample input\"\n @mm.output()\n def out(self):\n \"sample output\"\n begin.upon(go, end, [out])\n so = SampleObject()\n so.go()\n return mm\n\n\n@skipIf(not isGraphvizModuleInstalled(), \"Graphviz module is not installed.\")\nclass ElementMakerTests(TestCase):\n \"\"\"\n L{elementMaker} generates HTML representing the specified element.\n \"\"\"\n\n def setUp(self):\n from .._visualize import elementMaker\n self.elementMaker = elementMaker\n\n def test_sortsAttrs(self):\n \"\"\"\n L{elementMaker} orders HTML attributes lexicographically.\n \"\"\"\n expected = r''\n self.assertEqual(expected,\n self.elementMaker(\"div\",\n b='2',\n a='1',\n c='3'))\n\n def test_quotesAttrs(self):\n \"\"\"\n L{elementMaker} quotes HTML attributes according to DOT's quoting rule.\n\n See U{http://www.graphviz.org/doc/info/lang.html}, footnote 1.\n \"\"\"\n expected = r''\n self.assertEqual(expected,\n self.elementMaker(\"div\",\n b='a \" quote',\n a=1,\n c=\"a string\"))\n\n def test_noAttrs(self):\n \"\"\"\n L{elementMaker} should render an element with no attributes.\n \"\"\"\n expected = r''\n self.assertEqual(expected, self.elementMaker(\"div\"))\n\n\n@attr.s\nclass HTMLElement(object):\n \"\"\"Holds an HTML element, as created by elementMaker.\"\"\"\n name = attr.ib()\n children = attr.ib()\n attributes = attr.ib()\n\n\ndef findElements(element, predicate):\n \"\"\"\n Recursively collect all elements in an L{HTMLElement} tree that\n match the optional predicate.\n \"\"\"\n if predicate(element):\n return [element]\n elif isLeaf(element):\n return []\n\n return [result\n for child in element.children\n for result in findElements(child, predicate)]\n\n\ndef isLeaf(element):\n \"\"\"\n This HTML element is actually leaf node.\n \"\"\"\n return not isinstance(element, HTMLElement)\n\n\n@skipIf(not isGraphvizModuleInstalled(), \"Graphviz module is not installed.\")\nclass TableMakerTests(TestCase):\n \"\"\"\n Tests that ensure L{tableMaker} generates HTML tables usable as\n labels in DOT graphs.\n\n For more information, read the \"HTML-Like Labels\" section of\n U{http://www.graphviz.org/doc/info/shapes.html}.\n \"\"\"\n\n def fakeElementMaker(self, name, *children, **attributes):\n return HTMLElement(name=name, children=children, attributes=attributes)\n\n def setUp(self):\n from .._visualize import tableMaker\n\n self.inputLabel = \"input label\"\n self.port = \"the port\"\n self.tableMaker = functools.partial(tableMaker,\n _E=self.fakeElementMaker)\n\n def test_inputLabelRow(self):\n \"\"\"\n The table returned by L{tableMaker} always contains the input\n symbol label in its first row, and that row contains one cell\n with a port attribute set to the provided port.\n \"\"\"\n\n def hasPort(element):\n return (not isLeaf(element)\n and element.attributes.get(\"port\") == self.port)\n\n for outputLabels in ([], [\"an output label\"]):\n table = self.tableMaker(self.inputLabel, outputLabels,\n port=self.port)\n self.assertGreater(len(table.children), 0)\n inputLabelRow = table.children[0]\n\n portCandidates = findElements(table, hasPort)\n\n self.assertEqual(len(portCandidates), 1)\n self.assertEqual(portCandidates[0].name, \"td\")\n self.assertEqual(findElements(inputLabelRow, isLeaf),\n [self.inputLabel])\n\n def test_noOutputLabels(self):\n \"\"\"\n L{tableMaker} does not add a colspan attribute to the input\n label's cell or a second row if there no output labels.\n \"\"\"\n table = self.tableMaker(\"input label\", (), port=self.port)\n self.assertEqual(len(table.children), 1)\n (inputLabelRow,) = table.children\n self.assertNotIn(\"colspan\", inputLabelRow.attributes)\n\n def test_withOutputLabels(self):\n \"\"\"\n L{tableMaker} adds a colspan attribute to the input label's cell\n equal to the number of output labels and a second row that\n contains the output labels.\n \"\"\"\n table = self.tableMaker(self.inputLabel, (\"output label 1\",\n \"output label 2\"),\n port=self.port)\n\n self.assertEqual(len(table.children), 2)\n inputRow, outputRow = table.children\n\n def hasCorrectColspan(element):\n return (not isLeaf(element)\n and element.name == \"td\"\n and element.attributes.get('colspan') == \"2\")\n\n self.assertEqual(len(findElements(inputRow, hasCorrectColspan)),\n 1)\n self.assertEqual(findElements(outputRow, isLeaf), [\"output label 1\",\n \"output label 2\"])\n\n\n@skipIf(not isGraphvizModuleInstalled(), \"Graphviz module is not installed.\")\n@skipIf(not isGraphvizInstalled(), \"Graphviz tools are not installed.\")\nclass IntegrationTests(TestCase):\n \"\"\"\n Tests which make sure Graphviz can understand the output produced by\n Automat.\n \"\"\"\n\n def test_validGraphviz(self):\n \"\"\"\n L{graphviz} emits valid graphviz data.\n \"\"\"\n p = subprocess.Popen(\"dot\", stdin=subprocess.PIPE,\n stdout=subprocess.PIPE)\n out, err = p.communicate(\"\".join(sampleMachine().asDigraph())\n .encode(\"utf-8\"))\n self.assertEqual(p.returncode, 0)\n\n\n@skipIf(not isGraphvizModuleInstalled(), \"Graphviz module is not installed.\")\nclass SpotChecks(TestCase):\n \"\"\"\n Tests to make sure that the output contains salient features of the machine\n being generated.\n \"\"\"\n\n def test_containsMachineFeatures(self):\n \"\"\"\n The output of L{graphviz} should contain the names of the states,\n inputs, outputs in the state machine.\n \"\"\"\n gvout = \"\".join(sampleMachine().asDigraph())\n self.assertIn(\"begin\", gvout)\n self.assertIn(\"end\", gvout)\n self.assertIn(\"go\", gvout)\n self.assertIn(\"out\", gvout)\n\n\nclass RecordsDigraphActions(object):\n \"\"\"\n Records calls made to L{FakeDigraph}.\n \"\"\"\n\n def __init__(self):\n self.reset()\n\n def reset(self):\n self.renderCalls = []\n self.saveCalls = []\n\n\nclass FakeDigraph(object):\n \"\"\"\n A fake L{graphviz.Digraph}. Instantiate it with a\n L{RecordsDigraphActions}.\n \"\"\"\n\n def __init__(self, recorder):\n self._recorder = recorder\n\n def render(self, **kwargs):\n self._recorder.renderCalls.append(kwargs)\n\n def save(self, **kwargs):\n self._recorder.saveCalls.append(kwargs)\n\n\nclass FakeMethodicalMachine(object):\n \"\"\"\n A fake L{MethodicalMachine}. Instantiate it with a L{FakeDigraph}\n \"\"\"\n\n def __init__(self, digraph):\n self._digraph = digraph\n\n def asDigraph(self):\n return self._digraph\n\n\n@skipIf(not isGraphvizModuleInstalled(), \"Graphviz module is not installed.\")\n@skipIf(not isGraphvizInstalled(), \"Graphviz tools are not installed.\")\n@skipIf(not isTwistedInstalled(), \"Twisted is not installed.\")\nclass VisualizeToolTests(TestCase):\n\n def setUp(self):\n self.digraphRecorder = RecordsDigraphActions()\n self.fakeDigraph = FakeDigraph(self.digraphRecorder)\n\n self.fakeProgname = 'tool-test'\n self.fakeSysPath = ['ignored']\n self.collectedOutput = []\n self.fakeFQPN = 'fake.fqpn'\n\n def collectPrints(self, *args):\n self.collectedOutput.append(' '.join(args))\n\n def fakeFindMachines(self, fqpn):\n yield fqpn, FakeMethodicalMachine(self.fakeDigraph)\n\n def tool(self,\n progname=None,\n argv=None,\n syspath=None,\n findMachines=None,\n print=None):\n from .._visualize import tool\n return tool(\n _progname=progname or self.fakeProgname,\n _argv=argv or [self.fakeFQPN],\n _syspath=syspath or self.fakeSysPath,\n _findMachines=findMachines or self.fakeFindMachines,\n _print=print or self.collectPrints)\n\n def test_checksCurrentDirectory(self):\n \"\"\"\n L{tool} adds '' to sys.path to ensure\n L{automat._discover.findMachines} searches the current\n directory.\n \"\"\"\n self.tool(argv=[self.fakeFQPN])\n self.assertEqual(self.fakeSysPath[0], '')\n\n def test_quietHidesOutput(self):\n \"\"\"\n Passing -q/--quiet hides all output.\n \"\"\"\n self.tool(argv=[self.fakeFQPN, '--quiet'])\n self.assertFalse(self.collectedOutput)\n self.tool(argv=[self.fakeFQPN, '-q'])\n self.assertFalse(self.collectedOutput)\n\n def test_onlySaveDot(self):\n \"\"\"\n Passing an empty string for --image-directory/-i disables\n rendering images.\n \"\"\"\n for arg in ('--image-directory', '-i'):\n self.digraphRecorder.reset()\n self.collectedOutput = []\n\n self.tool(argv=[self.fakeFQPN, arg, ''])\n self.assertFalse(any(\"image\" in line\n for line in self.collectedOutput))\n\n self.assertEqual(len(self.digraphRecorder.saveCalls), 1)\n (call,) = self.digraphRecorder.saveCalls\n self.assertEqual(\"{}.dot\".format(self.fakeFQPN),\n call['filename'])\n\n self.assertFalse(self.digraphRecorder.renderCalls)\n\n def test_saveOnlyImage(self):\n \"\"\"\n Passing an empty string for --dot-directory/-d disables saving dot\n files.\n \"\"\"\n for arg in ('--dot-directory', '-d'):\n self.digraphRecorder.reset()\n self.collectedOutput = []\n self.tool(argv=[self.fakeFQPN, arg, ''])\n\n self.assertFalse(any(\"dot\" in line\n for line in self.collectedOutput))\n\n self.assertEqual(len(self.digraphRecorder.renderCalls), 1)\n (call,) = self.digraphRecorder.renderCalls\n self.assertEqual(\"{}.dot\".format(self.fakeFQPN),\n call['filename'])\n self.assertTrue(call['cleanup'])\n\n self.assertFalse(self.digraphRecorder.saveCalls)\n\n def test_saveDotAndImagesInDifferentDirectories(self):\n \"\"\"\n Passing different directories to --image-directory and --dot-directory\n writes images and dot files to those directories.\n \"\"\"\n imageDirectory = 'image'\n dotDirectory = 'dot'\n self.tool(argv=[self.fakeFQPN,\n '--image-directory', imageDirectory,\n '--dot-directory', dotDirectory])\n\n self.assertTrue(any(\"image\" in line\n for line in self.collectedOutput))\n self.assertTrue(any(\"dot\" in line\n for line in self.collectedOutput))\n\n self.assertEqual(len(self.digraphRecorder.renderCalls), 1)\n (renderCall,) = self.digraphRecorder.renderCalls\n self.assertEqual(renderCall[\"directory\"], imageDirectory)\n self.assertTrue(renderCall['cleanup'])\n\n self.assertEqual(len(self.digraphRecorder.saveCalls), 1)\n (saveCall,) = self.digraphRecorder.saveCalls\n self.assertEqual(saveCall[\"directory\"], dotDirectory)\n\n def test_saveDotAndImagesInSameDirectory(self):\n \"\"\"\n Passing the same directory to --image-directory and --dot-directory\n writes images and dot files to that one directory.\n \"\"\"\n directory = 'imagesAndDot'\n self.tool(argv=[self.fakeFQPN,\n '--image-directory', directory,\n '--dot-directory', directory])\n\n self.assertTrue(any(\"image and dot\" in line\n for line in self.collectedOutput))\n\n self.assertEqual(len(self.digraphRecorder.renderCalls), 1)\n (renderCall,) = self.digraphRecorder.renderCalls\n self.assertEqual(renderCall[\"directory\"], directory)\n self.assertFalse(renderCall['cleanup'])\n\n self.assertFalse(len(self.digraphRecorder.saveCalls))\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/automat/_visualize.py",
"content": "from __future__ import print_function\nimport argparse\nimport sys\n\nimport graphviz\n\nfrom ._discover import findMachines\n\n\ndef _gvquote(s):\n return '\"{}\"'.format(s.replace('\"', r'\\\"'))\n\n\ndef _gvhtml(s):\n return '<{}>'.format(s)\n\n\ndef elementMaker(name, *children, **attrs):\n \"\"\"\n Construct a string from the HTML element description.\n \"\"\"\n formattedAttrs = ' '.join('{}={}'.format(key, _gvquote(str(value)))\n for key, value in sorted(attrs.items()))\n formattedChildren = ''.join(children)\n return u'<{name} {attrs}>{children}'.format(\n name=name,\n attrs=formattedAttrs,\n children=formattedChildren)\n\n\ndef tableMaker(inputLabel, outputLabels, port, _E=elementMaker):\n \"\"\"\n Construct an HTML table to label a state transition.\n \"\"\"\n colspan = {}\n if outputLabels:\n colspan['colspan'] = str(len(outputLabels))\n\n inputLabelCell = _E(\"td\",\n _E(\"font\",\n inputLabel,\n face=\"menlo-italic\"),\n color=\"purple\",\n port=port,\n **colspan)\n\n pointSize = {\"point-size\": \"9\"}\n outputLabelCells = [_E(\"td\",\n _E(\"font\",\n outputLabel,\n **pointSize),\n color=\"pink\")\n for outputLabel in outputLabels]\n\n rows = [_E(\"tr\", inputLabelCell)]\n\n if outputLabels:\n rows.append(_E(\"tr\", *outputLabelCells))\n\n return _E(\"table\", *rows)\n\n\ndef makeDigraph(automaton, inputAsString=repr,\n outputAsString=repr,\n stateAsString=repr):\n \"\"\"\n Produce a L{graphviz.Digraph} object from an automaton.\n \"\"\"\n digraph = graphviz.Digraph(graph_attr={'pack': 'true',\n 'dpi': '100'},\n node_attr={'fontname': 'Menlo'},\n edge_attr={'fontname': 'Menlo'})\n\n for state in automaton.states():\n if state is automaton.initialState:\n stateShape = \"bold\"\n fontName = \"Menlo-Bold\"\n else:\n stateShape = \"\"\n fontName = \"Menlo\"\n digraph.node(stateAsString(state),\n fontame=fontName,\n shape=\"ellipse\",\n style=stateShape,\n color=\"blue\")\n for n, eachTransition in enumerate(automaton.allTransitions()):\n inState, inputSymbol, outState, outputSymbols = eachTransition\n thisTransition = \"t{}\".format(n)\n inputLabel = inputAsString(inputSymbol)\n\n port = \"tableport\"\n table = tableMaker(inputLabel, [outputAsString(outputSymbol)\n for outputSymbol in outputSymbols],\n port=port)\n\n digraph.node(thisTransition,\n label=_gvhtml(table), margin=\"0.2\", shape=\"none\")\n\n digraph.edge(stateAsString(inState),\n '{}:{}:w'.format(thisTransition, port),\n arrowhead=\"none\")\n digraph.edge('{}:{}:e'.format(thisTransition, port),\n stateAsString(outState))\n\n return digraph\n\n\ndef tool(_progname=sys.argv[0],\n _argv=sys.argv[1:],\n _syspath=sys.path,\n _findMachines=findMachines,\n _print=print):\n \"\"\"\n Entry point for command line utility.\n \"\"\"\n\n DESCRIPTION = \"\"\"\n Visualize automat.MethodicalMachines as graphviz graphs.\n \"\"\"\n EPILOG = \"\"\"\n You must have the graphviz tool suite installed. Please visit\n http://www.graphviz.org for more information.\n \"\"\"\n if _syspath[0]:\n _syspath.insert(0, '')\n argumentParser = argparse.ArgumentParser(\n prog=_progname,\n description=DESCRIPTION,\n epilog=EPILOG)\n argumentParser.add_argument('fqpn',\n help=\"A Fully Qualified Path name\"\n \" representing where to find machines.\")\n argumentParser.add_argument('--quiet', '-q',\n help=\"suppress output\",\n default=False,\n action=\"store_true\")\n argumentParser.add_argument('--dot-directory', '-d',\n help=\"Where to write out .dot files.\",\n default=\".automat_visualize\")\n argumentParser.add_argument('--image-directory', '-i',\n help=\"Where to write out image files.\",\n default=\".automat_visualize\")\n argumentParser.add_argument('--image-type', '-t',\n help=\"The image format.\",\n choices=graphviz.FORMATS,\n default='png')\n argumentParser.add_argument('--view', '-v',\n help=\"View rendered graphs with\"\n \" default image viewer\",\n default=False,\n action=\"store_true\")\n args = argumentParser.parse_args(_argv)\n\n explicitlySaveDot = (args.dot_directory\n and (not args.image_directory\n or args.image_directory != args.dot_directory))\n if args.quiet:\n def _print(*args):\n pass\n\n for fqpn, machine in _findMachines(args.fqpn):\n _print(fqpn, '...discovered')\n\n digraph = machine.asDigraph()\n\n if explicitlySaveDot:\n digraph.save(filename=\"{}.dot\".format(fqpn),\n directory=args.dot_directory)\n _print(fqpn, \"...wrote dot into\", args.dot_directory)\n\n if args.image_directory:\n deleteDot = not args.dot_directory or explicitlySaveDot\n digraph.format = args.image_type\n digraph.render(filename=\"{}.dot\".format(fqpn),\n directory=args.image_directory,\n view=args.view,\n cleanup=deleteDot)\n if deleteDot:\n msg = \"...wrote image into\"\n else:\n msg = \"...wrote image and dot into\"\n _print(fqpn, msg, args.image_directory)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/bson/__init__.py",
"content": "# Copyright 2009-present MongoDB, Inc.\n#\n# Licensed under the Apache License, Version 2.0 (the \"License\");\n# you may not use this file except in compliance with the License.\n# You may obtain a copy of the License at\n#\n# http://www.apache.org/licenses/LICENSE-2.0\n#\n# Unless required by applicable law or agreed to in writing, software\n# distributed under the License is distributed on an \"AS IS\" BASIS,\n# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n# See the License for the specific language governing permissions and\n# limitations under the License.\n\n\"\"\"BSON (Binary JSON) encoding and decoding.\n\nThe mapping from Python types to BSON types is as follows:\n\n======================================= ============= ===================\nPython Type BSON Type Supported Direction\n======================================= ============= ===================\nNone null both\nbool boolean both\nint [#int]_ int32 / int64 py -> bson\nlong int64 py -> bson\n`bson.int64.Int64` int64 both\nfloat number (real) both\nstring string py -> bson\nunicode string both\nlist array both\ndict / `SON` object both\ndatetime.datetime [#dt]_ [#dt2]_ date both\n`bson.regex.Regex` regex both\ncompiled re [#re]_ regex py -> bson\n`bson.binary.Binary` binary both\n`bson.objectid.ObjectId` oid both\n`bson.dbref.DBRef` dbref both\nNone undefined bson -> py\nunicode code bson -> py\n`bson.code.Code` code py -> bson\nunicode symbol bson -> py\nbytes (Python 3) [#bytes]_ binary both\n======================================= ============= ===================\n\nNote that, when using Python 2.x, to save binary data it must be wrapped as\nan instance of `bson.binary.Binary`. Otherwise it will be saved as a BSON\nstring and retrieved as unicode. Users of Python 3.x can use the Python bytes\ntype.\n\n.. [#int] A Python int will be saved as a BSON int32 or BSON int64 depending\n on its size. A BSON int32 will always decode to a Python int. A BSON\n int64 will always decode to a :class:`~bson.int64.Int64`.\n.. [#dt] datetime.datetime instances will be rounded to the nearest\n millisecond when saved\n.. [#dt2] all datetime.datetime instances are treated as *naive*. clients\n should always use UTC.\n.. [#re] :class:`~bson.regex.Regex` instances and regular expression\n objects from ``re.compile()`` are both saved as BSON regular expressions.\n BSON regular expressions are decoded as :class:`~bson.regex.Regex`\n instances.\n.. [#bytes] The bytes type from Python 3.x is encoded as BSON binary with\n subtype 0. In Python 3.x it will be decoded back to bytes. In Python 2.x\n it will be decoded to an instance of :class:`~bson.binary.Binary` with\n subtype 0.\n\"\"\"\n\nimport calendar\nimport datetime\nimport itertools\nimport platform\nimport re\nimport struct\nimport sys\nimport uuid\n\nfrom codecs import (utf_8_decode as _utf_8_decode,\n utf_8_encode as _utf_8_encode)\n\nfrom bson.binary import (Binary, OLD_UUID_SUBTYPE,\n JAVA_LEGACY, CSHARP_LEGACY,\n UUIDLegacy)\nfrom bson.code import Code\nfrom bson.codec_options import (\n CodecOptions, DEFAULT_CODEC_OPTIONS, _raw_document_class)\nfrom bson.dbref import DBRef\nfrom bson.decimal128 import Decimal128\nfrom bson.errors import (InvalidBSON,\n InvalidDocument,\n InvalidStringData)\nfrom bson.int64 import Int64\nfrom bson.max_key import MaxKey\nfrom bson.min_key import MinKey\nfrom bson.objectid import ObjectId\nfrom bson.py3compat import (abc,\n b,\n PY3,\n iteritems,\n text_type,\n string_type,\n reraise)\nfrom bson.regex import Regex\nfrom bson.son import SON, RE_TYPE\nfrom bson.timestamp import Timestamp\nfrom bson.tz_util import utc\n\n\ntry:\n from bson import _cbson\n _USE_C = True\nexcept ImportError:\n _USE_C = False\n\n\nEPOCH_AWARE = datetime.datetime.fromtimestamp(0, utc)\nEPOCH_NAIVE = datetime.datetime.utcfromtimestamp(0)\n\n\nBSONNUM = b\"\\x01\" # Floating point\nBSONSTR = b\"\\x02\" # UTF-8 string\nBSONOBJ = b\"\\x03\" # Embedded document\nBSONARR = b\"\\x04\" # Array\nBSONBIN = b\"\\x05\" # Binary\nBSONUND = b\"\\x06\" # Undefined\nBSONOID = b\"\\x07\" # ObjectId\nBSONBOO = b\"\\x08\" # Boolean\nBSONDAT = b\"\\x09\" # UTC Datetime\nBSONNUL = b\"\\x0A\" # Null\nBSONRGX = b\"\\x0B\" # Regex\nBSONREF = b\"\\x0C\" # DBRef\nBSONCOD = b\"\\x0D\" # Javascript code\nBSONSYM = b\"\\x0E\" # Symbol\nBSONCWS = b\"\\x0F\" # Javascript code with scope\nBSONINT = b\"\\x10\" # 32bit int\nBSONTIM = b\"\\x11\" # Timestamp\nBSONLON = b\"\\x12\" # 64bit int\nBSONDEC = b\"\\x13\" # Decimal128\nBSONMIN = b\"\\xFF\" # Min key\nBSONMAX = b\"\\x7F\" # Max key\n\n\n_UNPACK_FLOAT_FROM = struct.Struct(\"= obj_end:\n raise InvalidBSON(\"invalid object length\")\n # If this is the top-level document, validate the total size too.\n if position == 0 and obj_size != obj_end:\n raise InvalidBSON(\"invalid object length\")\n return obj_size, end\n\n\ndef _get_object(data, view, position, obj_end, opts, dummy):\n \"\"\"Decode a BSON subdocument to opts.document_class or bson.dbref.DBRef.\"\"\"\n obj_size, end = _get_object_size(data, position, obj_end)\n if _raw_document_class(opts.document_class):\n return (opts.document_class(data[position:end + 1], opts),\n position + obj_size)\n\n obj = _elements_to_dict(data, view, position + 4, end, opts)\n\n position += obj_size\n if \"$ref\" in obj:\n return (DBRef(obj.pop(\"$ref\"), obj.pop(\"$id\", None),\n obj.pop(\"$db\", None), obj), position)\n return obj, position\n\n\ndef _get_array(data, view, position, obj_end, opts, element_name):\n \"\"\"Decode a BSON array to python list.\"\"\"\n size = _UNPACK_INT_FROM(data, position)[0]\n end = position + size - 1\n if data[end] != _OBJEND:\n raise InvalidBSON(\"bad eoo\")\n\n position += 4\n end -= 1\n result = []\n\n # Avoid doing global and attribute lookups in the loop.\n append = result.append\n index = data.index\n getter = _ELEMENT_GETTER\n decoder_map = opts.type_registry._decoder_map\n\n while position < end:\n element_type = data[position]\n # Just skip the keys.\n position = index(b'\\x00', position) + 1\n try:\n value, position = getter[element_type](\n data, view, position, obj_end, opts, element_name)\n except KeyError:\n _raise_unknown_type(element_type, element_name)\n\n if decoder_map:\n custom_decoder = decoder_map.get(type(value))\n if custom_decoder is not None:\n value = custom_decoder(value)\n\n append(value)\n\n if position != end + 1:\n raise InvalidBSON('bad array length')\n return result, position + 1\n\n\ndef _get_binary(data, view, position, obj_end, opts, dummy1):\n \"\"\"Decode a BSON binary to bson.binary.Binary or python UUID.\"\"\"\n length, subtype = _UNPACK_LENGTH_SUBTYPE_FROM(data, position)\n position += 5\n if subtype == 2:\n length2 = _UNPACK_INT_FROM(data, position)[0]\n position += 4\n if length2 != length - 4:\n raise InvalidBSON(\"invalid binary (st 2) - lengths don't match!\")\n length = length2\n end = position + length\n if length < 0 or end > obj_end:\n raise InvalidBSON('bad binary object length')\n if subtype == 3:\n # Java Legacy\n uuid_representation = opts.uuid_representation\n if uuid_representation == JAVA_LEGACY:\n java = data[position:end]\n value = uuid.UUID(bytes=java[0:8][::-1] + java[8:16][::-1])\n # C# legacy\n elif uuid_representation == CSHARP_LEGACY:\n value = uuid.UUID(bytes_le=data[position:end])\n # Python\n else:\n value = uuid.UUID(bytes=data[position:end])\n return value, end\n if subtype == 4:\n return uuid.UUID(bytes=data[position:end]), end\n # Python3 special case. Decode subtype 0 to 'bytes'.\n if PY3 and subtype == 0:\n value = data[position:end]\n else:\n value = Binary(data[position:end], subtype)\n return value, end\n\n\ndef _get_oid(data, view, position, dummy0, dummy1, dummy2):\n \"\"\"Decode a BSON ObjectId to bson.objectid.ObjectId.\"\"\"\n end = position + 12\n return ObjectId(data[position:end]), end\n\n\ndef _get_boolean(data, view, position, dummy0, dummy1, dummy2):\n \"\"\"Decode a BSON true/false to python True/False.\"\"\"\n end = position + 1\n boolean_byte = data[position:end]\n if boolean_byte == b'\\x00':\n return False, end\n elif boolean_byte == b'\\x01':\n return True, end\n raise InvalidBSON('invalid boolean value: %r' % boolean_byte)\n\n\ndef _get_date(data, view, position, dummy0, opts, dummy1):\n \"\"\"Decode a BSON datetime to python datetime.datetime.\"\"\"\n return _millis_to_datetime(\n _UNPACK_LONG_FROM(data, position)[0], opts), position + 8\n\n\ndef _get_code(data, view, position, obj_end, opts, element_name):\n \"\"\"Decode a BSON code to bson.code.Code.\"\"\"\n code, position = _get_string(data, view, position, obj_end, opts, element_name)\n return Code(code), position\n\n\ndef _get_code_w_scope(data, view, position, obj_end, opts, element_name):\n \"\"\"Decode a BSON code_w_scope to bson.code.Code.\"\"\"\n code_end = position + _UNPACK_INT_FROM(data, position)[0]\n code, position = _get_string(\n data, view, position + 4, code_end, opts, element_name)\n scope, position = _get_object(data, view, position, code_end, opts, element_name)\n if position != code_end:\n raise InvalidBSON('scope outside of javascript code boundaries')\n return Code(code, scope), position\n\n\ndef _get_regex(data, view, position, dummy0, opts, dummy1):\n \"\"\"Decode a BSON regex to bson.regex.Regex or a python pattern object.\"\"\"\n pattern, position = _get_c_string(data, view, position, opts)\n bson_flags, position = _get_c_string(data, view, position, opts)\n bson_re = Regex(pattern, bson_flags)\n return bson_re, position\n\n\ndef _get_ref(data, view, position, obj_end, opts, element_name):\n \"\"\"Decode (deprecated) BSON DBPointer to bson.dbref.DBRef.\"\"\"\n collection, position = _get_string(\n data, view, position, obj_end, opts, element_name)\n oid, position = _get_oid(data, view, position, obj_end, opts, element_name)\n return DBRef(collection, oid), position\n\n\ndef _get_timestamp(data, view, position, dummy0, dummy1, dummy2):\n \"\"\"Decode a BSON timestamp to bson.timestamp.Timestamp.\"\"\"\n inc, timestamp = _UNPACK_TIMESTAMP_FROM(data, position)\n return Timestamp(timestamp, inc), position + 8\n\n\ndef _get_int64(data, view, position, dummy0, dummy1, dummy2):\n \"\"\"Decode a BSON int64 to bson.int64.Int64.\"\"\"\n return Int64(_UNPACK_LONG_FROM(data, position)[0]), position + 8\n\n\ndef _get_decimal128(data, view, position, dummy0, dummy1, dummy2):\n \"\"\"Decode a BSON decimal128 to bson.decimal128.Decimal128.\"\"\"\n end = position + 16\n return Decimal128.from_bid(data[position:end]), end\n\n\n# Each decoder function's signature is:\n# - data: bytes\n# - view: memoryview that references `data`\n# - position: int, beginning of object in 'data' to decode\n# - obj_end: int, end of object to decode in 'data' if variable-length type\n# - opts: a CodecOptions\n_ELEMENT_GETTER = {\n _maybe_ord(BSONNUM): _get_float,\n _maybe_ord(BSONSTR): _get_string,\n _maybe_ord(BSONOBJ): _get_object,\n _maybe_ord(BSONARR): _get_array,\n _maybe_ord(BSONBIN): _get_binary,\n _maybe_ord(BSONUND): lambda u, v, w, x, y, z: (None, w), # Deprecated undefined\n _maybe_ord(BSONOID): _get_oid,\n _maybe_ord(BSONBOO): _get_boolean,\n _maybe_ord(BSONDAT): _get_date,\n _maybe_ord(BSONNUL): lambda u, v, w, x, y, z: (None, w),\n _maybe_ord(BSONRGX): _get_regex,\n _maybe_ord(BSONREF): _get_ref, # Deprecated DBPointer\n _maybe_ord(BSONCOD): _get_code,\n _maybe_ord(BSONSYM): _get_string, # Deprecated symbol\n _maybe_ord(BSONCWS): _get_code_w_scope,\n _maybe_ord(BSONINT): _get_int,\n _maybe_ord(BSONTIM): _get_timestamp,\n _maybe_ord(BSONLON): _get_int64,\n _maybe_ord(BSONDEC): _get_decimal128,\n _maybe_ord(BSONMIN): lambda u, v, w, x, y, z: (MinKey(), w),\n _maybe_ord(BSONMAX): lambda u, v, w, x, y, z: (MaxKey(), w)}\n\n\nif _USE_C:\n def _element_to_dict(data, view, position, obj_end, opts):\n return _cbson._element_to_dict(data, position, obj_end, opts)\nelse:\n def _element_to_dict(data, view, position, obj_end, opts):\n \"\"\"Decode a single key, value pair.\"\"\"\n element_type = data[position]\n position += 1\n element_name, position = _get_c_string(data, view, position, opts)\n try:\n value, position = _ELEMENT_GETTER[element_type](data, view, position,\n obj_end, opts,\n element_name)\n except KeyError:\n _raise_unknown_type(element_type, element_name)\n\n if opts.type_registry._decoder_map:\n custom_decoder = opts.type_registry._decoder_map.get(type(value))\n if custom_decoder is not None:\n value = custom_decoder(value)\n\n return element_name, value, position\n\n\ndef _raw_to_dict(data, position, obj_end, opts, result):\n data, view = get_data_and_view(data)\n return _elements_to_dict(data, view, position, obj_end, opts, result)\n\n\ndef _elements_to_dict(data, view, position, obj_end, opts, result=None):\n \"\"\"Decode a BSON document into result.\"\"\"\n if result is None:\n result = opts.document_class()\n end = obj_end - 1\n while position < end:\n key, value, position = _element_to_dict(data, view, position, obj_end, opts)\n result[key] = value\n if position != obj_end:\n raise InvalidBSON('bad object or element length')\n return result\n\n\ndef _bson_to_dict(data, opts):\n \"\"\"Decode a BSON string to document_class.\"\"\"\n data, view = get_data_and_view(data)\n try:\n if _raw_document_class(opts.document_class):\n return opts.document_class(data, opts)\n _, end = _get_object_size(data, 0, len(data))\n return _elements_to_dict(data, view, 4, end, opts)\n except InvalidBSON:\n raise\n except Exception:\n # Change exception type to InvalidBSON but preserve traceback.\n _, exc_value, exc_tb = sys.exc_info()\n reraise(InvalidBSON, exc_value, exc_tb)\nif _USE_C:\n _bson_to_dict = _cbson._bson_to_dict\n\n\n_PACK_FLOAT = struct.Struct(\">> import collections # From Python standard library.\n >>> import bson\n >>> from bson.codec_options import CodecOptions\n >>> data = bson.encode({'a': 1})\n >>> decoded_doc = bson.decode(data)\n \n >>> options = CodecOptions(document_class=collections.OrderedDict)\n >>> decoded_doc = bson.decode(data, codec_options=options)\n >>> type(decoded_doc)\n \n\n :Parameters:\n - `data`: the BSON to decode. Any bytes-like object that implements\n the buffer protocol.\n - `codec_options` (optional): An instance of\n :class:`~bson.codec_options.CodecOptions`.\n\n .. versionadded:: 3.9\n \"\"\"\n if not isinstance(codec_options, CodecOptions):\n raise _CODEC_OPTIONS_TYPE_ERROR\n\n return _bson_to_dict(data, codec_options)\n\n\ndef decode_all(data, codec_options=DEFAULT_CODEC_OPTIONS):\n \"\"\"Decode BSON data to multiple documents.\n\n `data` must be a bytes-like object implementing the buffer protocol that\n provides concatenated, valid, BSON-encoded documents.\n\n :Parameters:\n - `data`: BSON data\n - `codec_options` (optional): An instance of\n :class:`~bson.codec_options.CodecOptions`.\n\n .. versionchanged:: 3.9\n Supports bytes-like objects that implement the buffer protocol.\n\n .. versionchanged:: 3.0\n Removed `compile_re` option: PyMongo now always represents BSON regular\n expressions as :class:`~bson.regex.Regex` objects. Use\n :meth:`~bson.regex.Regex.try_compile` to attempt to convert from a\n BSON regular expression to a Python regular expression object.\n\n Replaced `as_class`, `tz_aware`, and `uuid_subtype` options with\n `codec_options`.\n\n .. versionchanged:: 2.7\n Added `compile_re` option. If set to False, PyMongo represented BSON\n regular expressions as :class:`~bson.regex.Regex` objects instead of\n attempting to compile BSON regular expressions as Python native\n regular expressions, thus preventing errors for some incompatible\n patterns, see `PYTHON-500`_.\n\n .. _PYTHON-500: https://jira.mongodb.org/browse/PYTHON-500\n \"\"\"\n data, view = get_data_and_view(data)\n if not isinstance(codec_options, CodecOptions):\n raise _CODEC_OPTIONS_TYPE_ERROR\n\n data_len = len(data)\n docs = []\n position = 0\n end = data_len - 1\n use_raw = _raw_document_class(codec_options.document_class)\n try:\n while position < end:\n obj_size = _UNPACK_INT_FROM(data, position)[0]\n if data_len - position < obj_size:\n raise InvalidBSON(\"invalid object size\")\n obj_end = position + obj_size - 1\n if data[obj_end] != _OBJEND:\n raise InvalidBSON(\"bad eoo\")\n if use_raw:\n docs.append(\n codec_options.document_class(\n data[position:obj_end + 1], codec_options))\n else:\n docs.append(_elements_to_dict(data,\n view,\n position + 4,\n obj_end,\n codec_options))\n position += obj_size\n return docs\n except InvalidBSON:\n raise\n except Exception:\n # Change exception type to InvalidBSON but preserve traceback.\n _, exc_value, exc_tb = sys.exc_info()\n reraise(InvalidBSON, exc_value, exc_tb)\n\n\nif _USE_C:\n decode_all = _cbson.decode_all\n\n\ndef _decode_selective(rawdoc, fields, codec_options):\n if _raw_document_class(codec_options.document_class):\n # If document_class is RawBSONDocument, use vanilla dictionary for\n # decoding command response.\n doc = {}\n else:\n # Else, use the specified document_class.\n doc = codec_options.document_class()\n for key, value in iteritems(rawdoc):\n if key in fields:\n if fields[key] == 1:\n doc[key] = _bson_to_dict(rawdoc.raw, codec_options)[key]\n else:\n doc[key] = _decode_selective(value, fields[key], codec_options)\n else:\n doc[key] = value\n return doc\n\n\ndef _decode_all_selective(data, codec_options, fields):\n \"\"\"Decode BSON data to a single document while using user-provided\n custom decoding logic.\n\n `data` must be a string representing a valid, BSON-encoded document.\n\n :Parameters:\n - `data`: BSON data\n - `codec_options`: An instance of\n :class:`~bson.codec_options.CodecOptions` with user-specified type\n decoders. If no decoders are found, this method is the same as\n ``decode_all``.\n - `fields`: Map of document namespaces where data that needs\n to be custom decoded lives or None. For example, to custom decode a\n list of objects in 'field1.subfield1', the specified value should be\n ``{'field1': {'subfield1': 1}}``. If ``fields`` is an empty map or\n None, this method is the same as ``decode_all``.\n\n :Returns:\n - `document_list`: Single-member list containing the decoded document.\n\n .. versionadded:: 3.8\n \"\"\"\n if not codec_options.type_registry._decoder_map:\n return decode_all(data, codec_options)\n\n if not fields:\n return decode_all(data, codec_options.with_options(type_registry=None))\n\n # Decode documents for internal use.\n from bson.raw_bson import RawBSONDocument\n internal_codec_options = codec_options.with_options(\n document_class=RawBSONDocument, type_registry=None)\n _doc = _bson_to_dict(data, internal_codec_options)\n return [_decode_selective(_doc, fields, codec_options,)]\n\n\ndef decode_iter(data, codec_options=DEFAULT_CODEC_OPTIONS):\n \"\"\"Decode BSON data to multiple documents as a generator.\n\n Works similarly to the decode_all function, but yields one document at a\n time.\n\n `data` must be a string of concatenated, valid, BSON-encoded\n documents.\n\n :Parameters:\n - `data`: BSON data\n - `codec_options` (optional): An instance of\n :class:`~bson.codec_options.CodecOptions`.\n\n .. versionchanged:: 3.0\n Replaced `as_class`, `tz_aware`, and `uuid_subtype` options with\n `codec_options`.\n\n .. versionadded:: 2.8\n \"\"\"\n if not isinstance(codec_options, CodecOptions):\n raise _CODEC_OPTIONS_TYPE_ERROR\n\n position = 0\n end = len(data) - 1\n while position < end:\n obj_size = _UNPACK_INT_FROM(data, position)[0]\n elements = data[position:position + obj_size]\n position += obj_size\n\n yield _bson_to_dict(elements, codec_options)\n\n\ndef decode_file_iter(file_obj, codec_options=DEFAULT_CODEC_OPTIONS):\n \"\"\"Decode bson data from a file to multiple documents as a generator.\n\n Works similarly to the decode_all function, but reads from the file object\n in chunks and parses bson in chunks, yielding one document at a time.\n\n :Parameters:\n - `file_obj`: A file object containing BSON data.\n - `codec_options` (optional): An instance of\n :class:`~bson.codec_options.CodecOptions`.\n\n .. versionchanged:: 3.0\n Replaced `as_class`, `tz_aware`, and `uuid_subtype` options with\n `codec_options`.\n\n .. versionadded:: 2.8\n \"\"\"\n while True:\n # Read size of next object.\n size_data = file_obj.read(4)\n if not size_data:\n break # Finished with file normaly.\n elif len(size_data) != 4:\n raise InvalidBSON(\"cut off in middle of objsize\")\n obj_size = _UNPACK_INT_FROM(size_data, 0)[0] - 4\n elements = size_data + file_obj.read(obj_size)\n yield _bson_to_dict(elements, codec_options)\n\n\ndef is_valid(bson):\n \"\"\"Check that the given string represents valid :class:`BSON` data.\n\n Raises :class:`TypeError` if `bson` is not an instance of\n :class:`str` (:class:`bytes` in python 3). Returns ``True``\n if `bson` is valid :class:`BSON`, ``False`` otherwise.\n\n :Parameters:\n - `bson`: the data to be validated\n \"\"\"\n if not isinstance(bson, bytes):\n raise TypeError(\"BSON data must be an instance of a subclass of bytes\")\n\n try:\n _bson_to_dict(bson, DEFAULT_CODEC_OPTIONS)\n return True\n except Exception:\n return False\n\n\nclass BSON(bytes):\n \"\"\"BSON (Binary JSON) data.\n\n .. warning:: Using this class to encode and decode BSON adds a performance\n cost. For better performance use the module level functions\n :func:`encode` and :func:`decode` instead.\n \"\"\"\n\n @classmethod\n def encode(cls, document, check_keys=False,\n codec_options=DEFAULT_CODEC_OPTIONS):\n \"\"\"Encode a document to a new :class:`BSON` instance.\n\n A document can be any mapping type (like :class:`dict`).\n\n Raises :class:`TypeError` if `document` is not a mapping type,\n or contains keys that are not instances of\n :class:`basestring` (:class:`str` in python 3). Raises\n :class:`~bson.errors.InvalidDocument` if `document` cannot be\n converted to :class:`BSON`.\n\n :Parameters:\n - `document`: mapping type representing a document\n - `check_keys` (optional): check if keys start with '$' or\n contain '.', raising :class:`~bson.errors.InvalidDocument` in\n either case\n - `codec_options` (optional): An instance of\n :class:`~bson.codec_options.CodecOptions`.\n\n .. versionchanged:: 3.0\n Replaced `uuid_subtype` option with `codec_options`.\n \"\"\"\n return cls(encode(document, check_keys, codec_options))\n\n def decode(self, codec_options=DEFAULT_CODEC_OPTIONS):\n \"\"\"Decode this BSON data.\n\n By default, returns a BSON document represented as a Python\n :class:`dict`. To use a different :class:`MutableMapping` class,\n configure a :class:`~bson.codec_options.CodecOptions`::\n\n >>> import collections # From Python standard library.\n >>> import bson\n >>> from bson.codec_options import CodecOptions\n >>> data = bson.BSON.encode({'a': 1})\n >>> decoded_doc = bson.BSON(data).decode()\n \n >>> options = CodecOptions(document_class=collections.OrderedDict)\n >>> decoded_doc = bson.BSON(data).decode(codec_options=options)\n >>> type(decoded_doc)\n \n\n :Parameters:\n - `codec_options` (optional): An instance of\n :class:`~bson.codec_options.CodecOptions`.\n\n .. versionchanged:: 3.0\n Removed `compile_re` option: PyMongo now always represents BSON\n regular expressions as :class:`~bson.regex.Regex` objects. Use\n :meth:`~bson.regex.Regex.try_compile` to attempt to convert from a\n BSON regular expression to a Python regular expression object.\n\n Replaced `as_class`, `tz_aware`, and `uuid_subtype` options with\n `codec_options`.\n\n .. versionchanged:: 2.7\n Added `compile_re` option. If set to False, PyMongo represented BSON\n regular expressions as :class:`~bson.regex.Regex` objects instead of\n attempting to compile BSON regular expressions as Python native\n regular expressions, thus preventing errors for some incompatible\n patterns, see `PYTHON-500`_.\n\n .. _PYTHON-500: https://jira.mongodb.org/browse/PYTHON-500\n \"\"\"\n return decode(self, codec_options)\n\n\ndef has_c():\n \"\"\"Is the C extension installed?\n \"\"\"\n return _USE_C\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/bson/binary.py",
"content": "# Copyright 2009-present MongoDB, Inc.\n#\n# Licensed under the Apache License, Version 2.0 (the \"License\");\n# you may not use this file except in compliance with the License.\n# You may obtain a copy of the License at\n#\n# http://www.apache.org/licenses/LICENSE-2.0\n#\n# Unless required by applicable law or agreed to in writing, software\n# distributed under the License is distributed on an \"AS IS\" BASIS,\n# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n# See the License for the specific language governing permissions and\n# limitations under the License.\n\nfrom uuid import UUID\n\nfrom bson.py3compat import PY3\n\n\"\"\"Tools for representing BSON binary data.\n\"\"\"\n\nBINARY_SUBTYPE = 0\n\"\"\"BSON binary subtype for binary data.\n\nThis is the default subtype for binary data.\n\"\"\"\n\nFUNCTION_SUBTYPE = 1\n\"\"\"BSON binary subtype for functions.\n\"\"\"\n\nOLD_BINARY_SUBTYPE = 2\n\"\"\"Old BSON binary subtype for binary data.\n\nThis is the old default subtype, the current\ndefault is :data:`BINARY_SUBTYPE`.\n\"\"\"\n\nOLD_UUID_SUBTYPE = 3\n\"\"\"Old BSON binary subtype for a UUID.\n\n:class:`uuid.UUID` instances will automatically be encoded\nby :mod:`bson` using this subtype.\n\n.. versionadded:: 2.1\n\"\"\"\n\nUUID_SUBTYPE = 4\n\"\"\"BSON binary subtype for a UUID.\n\nThis is the new BSON binary subtype for UUIDs. The\ncurrent default is :data:`OLD_UUID_SUBTYPE`.\n\n.. versionchanged:: 2.1\n Changed to subtype 4.\n\"\"\"\n\nSTANDARD = UUID_SUBTYPE\n\"\"\"The standard UUID representation.\n\n:class:`uuid.UUID` instances will automatically be encoded to\nand decoded from BSON binary, using RFC-4122 byte order with\nbinary subtype :data:`UUID_SUBTYPE`.\n\n.. versionadded:: 3.0\n\"\"\"\n\nPYTHON_LEGACY = OLD_UUID_SUBTYPE\n\"\"\"The Python legacy UUID representation.\n\n:class:`uuid.UUID` instances will automatically be encoded to\nand decoded from BSON binary, using RFC-4122 byte order with\nbinary subtype :data:`OLD_UUID_SUBTYPE`.\n\n.. versionadded:: 3.0\n\"\"\"\n\nJAVA_LEGACY = 5\n\"\"\"The Java legacy UUID representation.\n\n:class:`uuid.UUID` instances will automatically be encoded to\nand decoded from BSON binary subtype :data:`OLD_UUID_SUBTYPE`,\nusing the Java driver's legacy byte order.\n\n.. versionchanged:: 3.6\n BSON binary subtype 4 is decoded using RFC-4122 byte order.\n.. versionadded:: 2.3\n\"\"\"\n\nCSHARP_LEGACY = 6\n\"\"\"The C#/.net legacy UUID representation.\n\n:class:`uuid.UUID` instances will automatically be encoded to\nand decoded from BSON binary subtype :data:`OLD_UUID_SUBTYPE`,\nusing the C# driver's legacy byte order.\n\n.. versionchanged:: 3.6\n BSON binary subtype 4 is decoded using RFC-4122 byte order.\n.. versionadded:: 2.3\n\"\"\"\n\nALL_UUID_SUBTYPES = (OLD_UUID_SUBTYPE, UUID_SUBTYPE)\nALL_UUID_REPRESENTATIONS = (STANDARD, PYTHON_LEGACY, JAVA_LEGACY, CSHARP_LEGACY)\nUUID_REPRESENTATION_NAMES = {\n PYTHON_LEGACY: 'PYTHON_LEGACY',\n STANDARD: 'STANDARD',\n JAVA_LEGACY: 'JAVA_LEGACY',\n CSHARP_LEGACY: 'CSHARP_LEGACY'}\n\nMD5_SUBTYPE = 5\n\"\"\"BSON binary subtype for an MD5 hash.\n\"\"\"\n\nUSER_DEFINED_SUBTYPE = 128\n\"\"\"BSON binary subtype for any user defined structure.\n\"\"\"\n\n\nclass Binary(bytes):\n \"\"\"Representation of BSON binary data.\n\n This is necessary because we want to represent Python strings as\n the BSON string type. We need to wrap binary data so we can tell\n the difference between what should be considered binary data and\n what should be considered a string when we encode to BSON.\n\n Raises TypeError if `data` is not an instance of :class:`bytes`\n (:class:`str` in python 2) or `subtype` is not an instance of\n :class:`int`. Raises ValueError if `subtype` is not in [0, 256).\n\n .. note::\n In python 3 instances of Binary with subtype 0 will be decoded\n directly to :class:`bytes`.\n\n :Parameters:\n - `data`: the binary data to represent. Can be any bytes-like type\n that implements the buffer protocol.\n - `subtype` (optional): the `binary subtype\n `_\n to use\n\n .. versionchanged:: 3.9\n Support any bytes-like type that implements the buffer protocol.\n \"\"\"\n\n _type_marker = 5\n\n def __new__(cls, data, subtype=BINARY_SUBTYPE):\n if not isinstance(subtype, int):\n raise TypeError(\"subtype must be an instance of int\")\n if subtype >= 256 or subtype < 0:\n raise ValueError(\"subtype must be contained in [0, 256)\")\n # Support any type that implements the buffer protocol.\n self = bytes.__new__(cls, memoryview(data).tobytes())\n self.__subtype = subtype\n return self\n\n @property\n def subtype(self):\n \"\"\"Subtype of this binary data.\n \"\"\"\n return self.__subtype\n\n def __getnewargs__(self):\n # Work around http://bugs.python.org/issue7382\n data = super(Binary, self).__getnewargs__()[0]\n if PY3 and not isinstance(data, bytes):\n data = data.encode('latin-1')\n return data, self.__subtype\n\n def __eq__(self, other):\n if isinstance(other, Binary):\n return ((self.__subtype, bytes(self)) ==\n (other.subtype, bytes(other)))\n # We don't return NotImplemented here because if we did then\n # Binary(\"foo\") == \"foo\" would return True, since Binary is a\n # subclass of str...\n return False\n\n def __hash__(self):\n return super(Binary, self).__hash__() ^ hash(self.__subtype)\n\n def __ne__(self, other):\n return not self == other\n\n def __repr__(self):\n return \"Binary(%s, %s)\" % (bytes.__repr__(self), self.__subtype)\n\n\nclass UUIDLegacy(Binary):\n \"\"\"UUID wrapper to support working with UUIDs stored as PYTHON_LEGACY.\n\n .. doctest::\n\n >>> import uuid\n >>> from bson.binary import Binary, UUIDLegacy, STANDARD\n >>> from bson.codec_options import CodecOptions\n >>> my_uuid = uuid.uuid4()\n >>> coll = db.get_collection('test',\n ... CodecOptions(uuid_representation=STANDARD))\n >>> coll.insert_one({'uuid': Binary(my_uuid.bytes, 3)}).inserted_id\n ObjectId('...')\n >>> coll.count_documents({'uuid': my_uuid})\n 0\n >>> coll.count_documents({'uuid': UUIDLegacy(my_uuid)})\n 1\n >>> coll.find({'uuid': UUIDLegacy(my_uuid)})[0]['uuid']\n UUID('...')\n >>>\n >>> # Convert from subtype 3 to subtype 4\n >>> doc = coll.find_one({'uuid': UUIDLegacy(my_uuid)})\n >>> coll.replace_one({\"_id\": doc[\"_id\"]}, doc).matched_count\n 1\n >>> coll.count_documents({'uuid': UUIDLegacy(my_uuid)})\n 0\n >>> coll.count_documents({'uuid': {'$in': [UUIDLegacy(my_uuid), my_uuid]}})\n 1\n >>> coll.find_one({'uuid': my_uuid})['uuid']\n UUID('...')\n\n Raises TypeError if `obj` is not an instance of :class:`~uuid.UUID`.\n\n :Parameters:\n - `obj`: An instance of :class:`~uuid.UUID`.\n \"\"\"\n\n def __new__(cls, obj):\n if not isinstance(obj, UUID):\n raise TypeError(\"obj must be an instance of uuid.UUID\")\n self = Binary.__new__(cls, obj.bytes, OLD_UUID_SUBTYPE)\n self.__uuid = obj\n return self\n\n def __getnewargs__(self):\n # Support copy and deepcopy\n return (self.__uuid,)\n\n @property\n def uuid(self):\n \"\"\"UUID instance wrapped by this UUIDLegacy instance.\n \"\"\"\n return self.__uuid\n\n def __repr__(self):\n return \"UUIDLegacy('%s')\" % self.__uuid\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/bson/code.py",
"content": "# Copyright 2009-present MongoDB, Inc.\n#\n# Licensed under the Apache License, Version 2.0 (the \"License\");\n# you may not use this file except in compliance with the License.\n# You may obtain a copy of the License at\n#\n# http://www.apache.org/licenses/LICENSE-2.0\n#\n# Unless required by applicable law or agreed to in writing, software\n# distributed under the License is distributed on an \"AS IS\" BASIS,\n# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n# See the License for the specific language governing permissions and\n# limitations under the License.\n\n\"\"\"Tools for representing JavaScript code in BSON.\n\"\"\"\n\nfrom bson.py3compat import abc, string_type, PY3, text_type\n\n\nclass Code(str):\n \"\"\"BSON's JavaScript code type.\n\n Raises :class:`TypeError` if `code` is not an instance of\n :class:`basestring` (:class:`str` in python 3) or `scope`\n is not ``None`` or an instance of :class:`dict`.\n\n Scope variables can be set by passing a dictionary as the `scope`\n argument or by using keyword arguments. If a variable is set as a\n keyword argument it will override any setting for that variable in\n the `scope` dictionary.\n\n :Parameters:\n - `code`: A string containing JavaScript code to be evaluated or another\n instance of Code. In the latter case, the scope of `code` becomes this\n Code's :attr:`scope`.\n - `scope` (optional): dictionary representing the scope in which\n `code` should be evaluated - a mapping from identifiers (as\n strings) to values. Defaults to ``None``. This is applied after any\n scope associated with a given `code` above.\n - `**kwargs` (optional): scope variables can also be passed as\n keyword arguments. These are applied after `scope` and `code`.\n\n .. versionchanged:: 3.4\n The default value for :attr:`scope` is ``None`` instead of ``{}``.\n\n \"\"\"\n\n _type_marker = 13\n\n def __new__(cls, code, scope=None, **kwargs):\n if not isinstance(code, string_type):\n raise TypeError(\"code must be an \"\n \"instance of %s\" % (string_type.__name__))\n\n if not PY3 and isinstance(code, text_type):\n self = str.__new__(cls, code.encode('utf8'))\n else:\n self = str.__new__(cls, code)\n\n try:\n self.__scope = code.scope\n except AttributeError:\n self.__scope = None\n\n if scope is not None:\n if not isinstance(scope, abc.Mapping):\n raise TypeError(\"scope must be an instance of dict\")\n if self.__scope is not None:\n self.__scope.update(scope)\n else:\n self.__scope = scope\n\n if kwargs:\n if self.__scope is not None:\n self.__scope.update(kwargs)\n else:\n self.__scope = kwargs\n\n return self\n\n @property\n def scope(self):\n \"\"\"Scope dictionary for this instance or ``None``.\n \"\"\"\n return self.__scope\n\n def __repr__(self):\n return \"Code(%s, %r)\" % (str.__repr__(self), self.__scope)\n\n def __eq__(self, other):\n if isinstance(other, Code):\n return (self.__scope, str(self)) == (other.__scope, str(other))\n return False\n\n __hash__ = None\n\n def __ne__(self, other):\n return not self == other\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/bson/codec_options.py",
"content": "# Copyright 2014-present MongoDB, Inc.\n#\n# Licensed under the Apache License, Version 2.0 (the \"License\");\n# you may not use this file except in compliance with the License.\n# You may obtain a copy of the License at\n#\n# http://www.apache.org/licenses/LICENSE-2.0\n#\n# Unless required by applicable law or agreed to in writing, software\n# distributed under the License is distributed on an \"AS IS\" BASIS,\n# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n# See the License for the specific language governing permissions and\n# limitations under the License.\n\n\"\"\"Tools for specifying BSON codec options.\"\"\"\n\nimport datetime\n\nfrom abc import abstractmethod\nfrom collections import namedtuple\n\nfrom bson.py3compat import ABC, abc, abstractproperty, string_type\n\nfrom bson.binary import (ALL_UUID_REPRESENTATIONS,\n PYTHON_LEGACY,\n UUID_REPRESENTATION_NAMES)\n\n\n_RAW_BSON_DOCUMENT_MARKER = 101\n\n\ndef _raw_document_class(document_class):\n \"\"\"Determine if a document_class is a RawBSONDocument class.\"\"\"\n marker = getattr(document_class, '_type_marker', None)\n return marker == _RAW_BSON_DOCUMENT_MARKER\n\n\nclass TypeEncoder(ABC):\n \"\"\"Base class for defining type codec classes which describe how a\n custom type can be transformed to one of the types BSON understands.\n\n Codec classes must implement the ``python_type`` attribute, and the\n ``transform_python`` method to support encoding.\n\n See :ref:`custom-type-type-codec` documentation for an example.\n \"\"\"\n @abstractproperty\n def python_type(self):\n \"\"\"The Python type to be converted into something serializable.\"\"\"\n pass\n\n @abstractmethod\n def transform_python(self, value):\n \"\"\"Convert the given Python object into something serializable.\"\"\"\n pass\n\n\nclass TypeDecoder(ABC):\n \"\"\"Base class for defining type codec classes which describe how a\n BSON type can be transformed to a custom type.\n\n Codec classes must implement the ``bson_type`` attribute, and the\n ``transform_bson`` method to support decoding.\n\n See :ref:`custom-type-type-codec` documentation for an example.\n \"\"\"\n @abstractproperty\n def bson_type(self):\n \"\"\"The BSON type to be converted into our own type.\"\"\"\n pass\n\n @abstractmethod\n def transform_bson(self, value):\n \"\"\"Convert the given BSON value into our own type.\"\"\"\n pass\n\n\nclass TypeCodec(TypeEncoder, TypeDecoder):\n \"\"\"Base class for defining type codec classes which describe how a\n custom type can be transformed to/from one of the types :mod:`bson`\n can already encode/decode.\n\n Codec classes must implement the ``python_type`` attribute, and the\n ``transform_python`` method to support encoding, as well as the\n ``bson_type`` attribute, and the ``transform_bson`` method to support\n decoding.\n\n See :ref:`custom-type-type-codec` documentation for an example.\n \"\"\"\n pass\n\n\nclass TypeRegistry(object):\n \"\"\"Encapsulates type codecs used in encoding and / or decoding BSON, as\n well as the fallback encoder. Type registries cannot be modified after\n instantiation.\n\n ``TypeRegistry`` can be initialized with an iterable of type codecs, and\n a callable for the fallback encoder::\n\n >>> from bson.codec_options import TypeRegistry\n >>> type_registry = TypeRegistry([Codec1, Codec2, Codec3, ...],\n ... fallback_encoder)\n\n See :ref:`custom-type-type-registry` documentation for an example.\n\n :Parameters:\n - `type_codecs` (optional): iterable of type codec instances. If\n ``type_codecs`` contains multiple codecs that transform a single\n python or BSON type, the transformation specified by the type codec\n occurring last prevails. A TypeError will be raised if one or more\n type codecs modify the encoding behavior of a built-in :mod:`bson`\n type.\n - `fallback_encoder` (optional): callable that accepts a single,\n unencodable python value and transforms it into a type that\n :mod:`bson` can encode. See :ref:`fallback-encoder-callable`\n documentation for an example.\n \"\"\"\n def __init__(self, type_codecs=None, fallback_encoder=None):\n self.__type_codecs = list(type_codecs or [])\n self._fallback_encoder = fallback_encoder\n self._encoder_map = {}\n self._decoder_map = {}\n\n if self._fallback_encoder is not None:\n if not callable(fallback_encoder):\n raise TypeError(\"fallback_encoder %r is not a callable\" % (\n fallback_encoder))\n\n for codec in self.__type_codecs:\n is_valid_codec = False\n if isinstance(codec, TypeEncoder):\n self._validate_type_encoder(codec)\n is_valid_codec = True\n self._encoder_map[codec.python_type] = codec.transform_python\n if isinstance(codec, TypeDecoder):\n is_valid_codec = True\n self._decoder_map[codec.bson_type] = codec.transform_bson\n if not is_valid_codec:\n raise TypeError(\n \"Expected an instance of %s, %s, or %s, got %r instead\" % (\n TypeEncoder.__name__, TypeDecoder.__name__,\n TypeCodec.__name__, codec))\n\n def _validate_type_encoder(self, codec):\n from bson import _BUILT_IN_TYPES\n for pytype in _BUILT_IN_TYPES:\n if issubclass(codec.python_type, pytype):\n err_msg = (\"TypeEncoders cannot change how built-in types are \"\n \"encoded (encoder %s transforms type %s)\" %\n (codec, pytype))\n raise TypeError(err_msg)\n\n def __repr__(self):\n return ('%s(type_codecs=%r, fallback_encoder=%r)' % (\n self.__class__.__name__, self.__type_codecs,\n self._fallback_encoder))\n\n def __eq__(self, other):\n if not isinstance(other, type(self)):\n return NotImplemented\n return ((self._decoder_map == other._decoder_map) and\n (self._encoder_map == other._encoder_map) and\n (self._fallback_encoder == other._fallback_encoder))\n\n\n_options_base = namedtuple(\n 'CodecOptions',\n ('document_class', 'tz_aware', 'uuid_representation',\n 'unicode_decode_error_handler', 'tzinfo', 'type_registry'))\n\n\nclass CodecOptions(_options_base):\n \"\"\"Encapsulates options used encoding and / or decoding BSON.\n\n The `document_class` option is used to define a custom type for use\n decoding BSON documents. Access to the underlying raw BSON bytes for\n a document is available using the :class:`~bson.raw_bson.RawBSONDocument`\n type::\n\n >>> from bson.raw_bson import RawBSONDocument\n >>> from bson.codec_options import CodecOptions\n >>> codec_options = CodecOptions(document_class=RawBSONDocument)\n >>> coll = db.get_collection('test', codec_options=codec_options)\n >>> doc = coll.find_one()\n >>> doc.raw\n '\\\\x16\\\\x00\\\\x00\\\\x00\\\\x07_id\\\\x00[0\\\\x165\\\\x91\\\\x10\\\\xea\\\\x14\\\\xe8\\\\xc5\\\\x8b\\\\x93\\\\x00'\n\n The document class can be any type that inherits from\n :class:`~collections.MutableMapping`::\n\n >>> class AttributeDict(dict):\n ... # A dict that supports attribute access.\n ... def __getattr__(self, key):\n ... return self[key]\n ... def __setattr__(self, key, value):\n ... self[key] = value\n ...\n >>> codec_options = CodecOptions(document_class=AttributeDict)\n >>> coll = db.get_collection('test', codec_options=codec_options)\n >>> doc = coll.find_one()\n >>> doc._id\n ObjectId('5b3016359110ea14e8c58b93')\n\n See :doc:`/examples/datetimes` for examples using the `tz_aware` and\n `tzinfo` options.\n\n See :class:`~bson.binary.UUIDLegacy` for examples using the\n `uuid_representation` option.\n\n :Parameters:\n - `document_class`: BSON documents returned in queries will be decoded\n to an instance of this class. Must be a subclass of\n :class:`~collections.MutableMapping`. Defaults to :class:`dict`.\n - `tz_aware`: If ``True``, BSON datetimes will be decoded to timezone\n aware instances of :class:`~datetime.datetime`. Otherwise they will be\n naive. Defaults to ``False``.\n - `uuid_representation`: The BSON representation to use when encoding\n and decoding instances of :class:`~uuid.UUID`. Defaults to\n :data:`~bson.binary.PYTHON_LEGACY`.\n - `unicode_decode_error_handler`: The error handler to apply when\n a Unicode-related error occurs during BSON decoding that would\n otherwise raise :exc:`UnicodeDecodeError`. Valid options include\n 'strict', 'replace', and 'ignore'. Defaults to 'strict'.\n - `tzinfo`: A :class:`~datetime.tzinfo` subclass that specifies the\n timezone to/from which :class:`~datetime.datetime` objects should be\n encoded/decoded.\n - `type_registry`: Instance of :class:`TypeRegistry` used to customize\n encoding and decoding behavior.\n\n .. versionadded:: 3.8\n `type_registry` attribute.\n\n .. warning:: Care must be taken when changing\n `unicode_decode_error_handler` from its default value ('strict').\n The 'replace' and 'ignore' modes should not be used when documents\n retrieved from the server will be modified in the client application\n and stored back to the server.\n \"\"\"\n\n def __new__(cls, document_class=dict,\n tz_aware=False, uuid_representation=PYTHON_LEGACY,\n unicode_decode_error_handler=\"strict\",\n tzinfo=None, type_registry=None):\n if not (issubclass(document_class, abc.MutableMapping) or\n _raw_document_class(document_class)):\n raise TypeError(\"document_class must be dict, bson.son.SON, \"\n \"bson.raw_bson.RawBSONDocument, or a \"\n \"sublass of collections.MutableMapping\")\n if not isinstance(tz_aware, bool):\n raise TypeError(\"tz_aware must be True or False\")\n if uuid_representation not in ALL_UUID_REPRESENTATIONS:\n raise ValueError(\"uuid_representation must be a value \"\n \"from bson.binary.ALL_UUID_REPRESENTATIONS\")\n if not isinstance(unicode_decode_error_handler, (string_type, None)):\n raise ValueError(\"unicode_decode_error_handler must be a string \"\n \"or None\")\n if tzinfo is not None:\n if not isinstance(tzinfo, datetime.tzinfo):\n raise TypeError(\n \"tzinfo must be an instance of datetime.tzinfo\")\n if not tz_aware:\n raise ValueError(\n \"cannot specify tzinfo without also setting tz_aware=True\")\n\n type_registry = type_registry or TypeRegistry()\n\n if not isinstance(type_registry, TypeRegistry):\n raise TypeError(\"type_registry must be an instance of TypeRegistry\")\n\n return tuple.__new__(\n cls, (document_class, tz_aware, uuid_representation,\n unicode_decode_error_handler, tzinfo, type_registry))\n\n def _arguments_repr(self):\n \"\"\"Representation of the arguments used to create this object.\"\"\"\n document_class_repr = (\n 'dict' if self.document_class is dict\n else repr(self.document_class))\n\n uuid_rep_repr = UUID_REPRESENTATION_NAMES.get(self.uuid_representation,\n self.uuid_representation)\n\n return ('document_class=%s, tz_aware=%r, uuid_representation=%s, '\n 'unicode_decode_error_handler=%r, tzinfo=%r, '\n 'type_registry=%r' %\n (document_class_repr, self.tz_aware, uuid_rep_repr,\n self.unicode_decode_error_handler, self.tzinfo,\n self.type_registry))\n\n def __repr__(self):\n return '%s(%s)' % (self.__class__.__name__, self._arguments_repr())\n\n def with_options(self, **kwargs):\n \"\"\"Make a copy of this CodecOptions, overriding some options::\n\n >>> from bson.codec_options import DEFAULT_CODEC_OPTIONS\n >>> DEFAULT_CODEC_OPTIONS.tz_aware\n False\n >>> options = DEFAULT_CODEC_OPTIONS.with_options(tz_aware=True)\n >>> options.tz_aware\n True\n\n .. versionadded:: 3.5\n \"\"\"\n return CodecOptions(\n kwargs.get('document_class', self.document_class),\n kwargs.get('tz_aware', self.tz_aware),\n kwargs.get('uuid_representation', self.uuid_representation),\n kwargs.get('unicode_decode_error_handler',\n self.unicode_decode_error_handler),\n kwargs.get('tzinfo', self.tzinfo),\n kwargs.get('type_registry', self.type_registry)\n )\n\n\nDEFAULT_CODEC_OPTIONS = CodecOptions()\n\n\ndef _parse_codec_options(options):\n \"\"\"Parse BSON codec options.\"\"\"\n return CodecOptions(\n document_class=options.get(\n 'document_class', DEFAULT_CODEC_OPTIONS.document_class),\n tz_aware=options.get(\n 'tz_aware', DEFAULT_CODEC_OPTIONS.tz_aware),\n uuid_representation=options.get(\n 'uuidrepresentation', DEFAULT_CODEC_OPTIONS.uuid_representation),\n unicode_decode_error_handler=options.get(\n 'unicode_decode_error_handler',\n DEFAULT_CODEC_OPTIONS.unicode_decode_error_handler),\n tzinfo=options.get('tzinfo', DEFAULT_CODEC_OPTIONS.tzinfo),\n type_registry=options.get(\n 'type_registry', DEFAULT_CODEC_OPTIONS.type_registry))\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/bson/dbref.py",
"content": "# Copyright 2009-2015 MongoDB, Inc.\n#\n# Licensed under the Apache License, Version 2.0 (the \"License\");\n# you may not use this file except in compliance with the License.\n# You may obtain a copy of the License at\n#\n# http://www.apache.org/licenses/LICENSE-2.0\n#\n# Unless required by applicable law or agreed to in writing, software\n# distributed under the License is distributed on an \"AS IS\" BASIS,\n# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n# See the License for the specific language governing permissions and\n# limitations under the License.\n\n\"\"\"Tools for manipulating DBRefs (references to MongoDB documents).\"\"\"\n\nfrom copy import deepcopy\n\nfrom bson.py3compat import iteritems, string_type\nfrom bson.son import SON\n\n\nclass DBRef(object):\n \"\"\"A reference to a document stored in MongoDB.\n \"\"\"\n\n # DBRef isn't actually a BSON \"type\" so this number was arbitrarily chosen.\n _type_marker = 100\n\n def __init__(self, collection, id, database=None, _extra={}, **kwargs):\n \"\"\"Initialize a new :class:`DBRef`.\n\n Raises :class:`TypeError` if `collection` or `database` is not\n an instance of :class:`basestring` (:class:`str` in python 3).\n `database` is optional and allows references to documents to work\n across databases. Any additional keyword arguments will create\n additional fields in the resultant embedded document.\n\n :Parameters:\n - `collection`: name of the collection the document is stored in\n - `id`: the value of the document's ``\"_id\"`` field\n - `database` (optional): name of the database to reference\n - `**kwargs` (optional): additional keyword arguments will\n create additional, custom fields\n\n .. mongodoc:: dbrefs\n \"\"\"\n if not isinstance(collection, string_type):\n raise TypeError(\"collection must be an \"\n \"instance of %s\" % string_type.__name__)\n if database is not None and not isinstance(database, string_type):\n raise TypeError(\"database must be an \"\n \"instance of %s\" % string_type.__name__)\n\n self.__collection = collection\n self.__id = id\n self.__database = database\n kwargs.update(_extra)\n self.__kwargs = kwargs\n\n @property\n def collection(self):\n \"\"\"Get the name of this DBRef's collection as unicode.\n \"\"\"\n return self.__collection\n\n @property\n def id(self):\n \"\"\"Get this DBRef's _id.\n \"\"\"\n return self.__id\n\n @property\n def database(self):\n \"\"\"Get the name of this DBRef's database.\n\n Returns None if this DBRef doesn't specify a database.\n \"\"\"\n return self.__database\n\n def __getattr__(self, key):\n try:\n return self.__kwargs[key]\n except KeyError:\n raise AttributeError(key)\n\n # Have to provide __setstate__ to avoid\n # infinite recursion since we override\n # __getattr__.\n def __setstate__(self, state):\n self.__dict__.update(state)\n\n def as_doc(self):\n \"\"\"Get the SON document representation of this DBRef.\n\n Generally not needed by application developers\n \"\"\"\n doc = SON([(\"$ref\", self.collection),\n (\"$id\", self.id)])\n if self.database is not None:\n doc[\"$db\"] = self.database\n doc.update(self.__kwargs)\n return doc\n\n def __repr__(self):\n extra = \"\".join([\", %s=%r\" % (k, v)\n for k, v in iteritems(self.__kwargs)])\n if self.database is None:\n return \"DBRef(%r, %r%s)\" % (self.collection, self.id, extra)\n return \"DBRef(%r, %r, %r%s)\" % (self.collection, self.id,\n self.database, extra)\n\n def __eq__(self, other):\n if isinstance(other, DBRef):\n us = (self.__database, self.__collection,\n self.__id, self.__kwargs)\n them = (other.__database, other.__collection,\n other.__id, other.__kwargs)\n return us == them\n return NotImplemented\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n \"\"\"Get a hash value for this :class:`DBRef`.\"\"\"\n return hash((self.__collection, self.__id, self.__database,\n tuple(sorted(self.__kwargs.items()))))\n\n def __deepcopy__(self, memo):\n \"\"\"Support function for `copy.deepcopy()`.\"\"\"\n return DBRef(deepcopy(self.__collection, memo),\n deepcopy(self.__id, memo),\n deepcopy(self.__database, memo),\n deepcopy(self.__kwargs, memo))\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/bson/decimal128.py",
"content": "# Copyright 2016-present MongoDB, Inc.\n#\n# Licensed under the Apache License, Version 2.0 (the \"License\");\n# you may not use this file except in compliance with the License.\n# You may obtain a copy of the License at\n#\n# http://www.apache.org/licenses/LICENSE-2.0\n#\n# Unless required by applicable law or agreed to in writing, software\n# distributed under the License is distributed on an \"AS IS\" BASIS,\n# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n# See the License for the specific language governing permissions and\n# limitations under the License.\n\n\"\"\"Tools for working with the BSON decimal128 type.\n\n.. versionadded:: 3.4\n\n.. note:: The Decimal128 BSON type requires MongoDB 3.4+.\n\"\"\"\n\nimport decimal\nimport struct\nimport sys\n\nfrom bson.py3compat import (PY3 as _PY3,\n string_type as _string_type)\n\n\nif _PY3:\n _from_bytes = int.from_bytes # pylint: disable=no-member, invalid-name\nelse:\n import binascii\n def _from_bytes(value, dummy, _int=int, _hexlify=binascii.hexlify):\n \"An implementation of int.from_bytes for python 2.x.\"\n return _int(_hexlify(value), 16)\n\n\n_PACK_64 = struct.Struct(\"= 3.3, cdecimal\n decimal.Context(clamp=1) # pylint: disable=unexpected-keyword-arg\n _CTX_OPTIONS['clamp'] = 1\nexcept TypeError:\n # Python < 3.3\n _CTX_OPTIONS['_clamp'] = 1\n\n_DEC128_CTX = decimal.Context(**_CTX_OPTIONS.copy())\n\n\ndef create_decimal128_context():\n \"\"\"Returns an instance of :class:`decimal.Context` appropriate\n for working with IEEE-754 128-bit decimal floating point values.\n \"\"\"\n opts = _CTX_OPTIONS.copy()\n opts['traps'] = []\n return decimal.Context(**opts)\n\n\ndef _decimal_to_128(value):\n \"\"\"Converts a decimal.Decimal to BID (high bits, low bits).\n\n :Parameters:\n - `value`: An instance of decimal.Decimal\n \"\"\"\n with decimal.localcontext(_DEC128_CTX) as ctx:\n value = ctx.create_decimal(value)\n\n if value.is_infinite():\n return _NINF if value.is_signed() else _PINF\n\n sign, digits, exponent = value.as_tuple()\n\n if value.is_nan():\n if digits:\n raise ValueError(\"NaN with debug payload is not supported\")\n if value.is_snan():\n return _NSNAN if value.is_signed() else _PSNAN\n return _NNAN if value.is_signed() else _PNAN\n\n significand = int(\"\".join([str(digit) for digit in digits]))\n bit_length = significand.bit_length()\n\n high = 0\n low = 0\n for i in range(min(64, bit_length)):\n if significand & (1 << i):\n low |= 1 << i\n\n for i in range(64, bit_length):\n if significand & (1 << i):\n high |= 1 << (i - 64)\n\n biased_exponent = exponent + _EXPONENT_BIAS\n\n if high >> 49 == 1:\n high = high & 0x7fffffffffff\n high |= _EXPONENT_MASK\n high |= (biased_exponent & 0x3fff) << 47\n else:\n high |= biased_exponent << 49\n\n if sign:\n high |= _SIGN\n\n return high, low\n\n\nclass Decimal128(object):\n \"\"\"BSON Decimal128 type::\n\n >>> Decimal128(Decimal(\"0.0005\"))\n Decimal128('0.0005')\n >>> Decimal128(\"0.0005\")\n Decimal128('0.0005')\n >>> Decimal128((3474527112516337664, 5))\n Decimal128('0.0005')\n\n :Parameters:\n - `value`: An instance of :class:`decimal.Decimal`, string, or tuple of\n (high bits, low bits) from Binary Integer Decimal (BID) format.\n\n .. note:: :class:`~Decimal128` uses an instance of :class:`decimal.Context`\n configured for IEEE-754 Decimal128 when validating parameters.\n Signals like :class:`decimal.InvalidOperation`, :class:`decimal.Inexact`,\n and :class:`decimal.Overflow` are trapped and raised as exceptions::\n\n >>> Decimal128(\".13.1\")\n Traceback (most recent call last):\n File \"\", line 1, in \n ...\n decimal.InvalidOperation: []\n >>>\n >>> Decimal128(\"1E-6177\")\n Traceback (most recent call last):\n File \"\", line 1, in \n ...\n decimal.Inexact: []\n >>>\n >>> Decimal128(\"1E6145\")\n Traceback (most recent call last):\n File \"\", line 1, in \n ...\n decimal.Overflow: [, ]\n\n To ensure the result of a calculation can always be stored as BSON\n Decimal128 use the context returned by\n :func:`create_decimal128_context`::\n\n >>> import decimal\n >>> decimal128_ctx = create_decimal128_context()\n >>> with decimal.localcontext(decimal128_ctx) as ctx:\n ... Decimal128(ctx.create_decimal(\".13.3\"))\n ...\n Decimal128('NaN')\n >>>\n >>> with decimal.localcontext(decimal128_ctx) as ctx:\n ... Decimal128(ctx.create_decimal(\"1E-6177\"))\n ...\n Decimal128('0E-6176')\n >>>\n >>> with decimal.localcontext(DECIMAL128_CTX) as ctx:\n ... Decimal128(ctx.create_decimal(\"1E6145\"))\n ...\n Decimal128('Infinity')\n\n To match the behavior of MongoDB's Decimal128 implementation\n str(Decimal(value)) may not match str(Decimal128(value)) for NaN values::\n\n >>> Decimal128(Decimal('NaN'))\n Decimal128('NaN')\n >>> Decimal128(Decimal('-NaN'))\n Decimal128('NaN')\n >>> Decimal128(Decimal('sNaN'))\n Decimal128('NaN')\n >>> Decimal128(Decimal('-sNaN'))\n Decimal128('NaN')\n\n However, :meth:`~Decimal128.to_decimal` will return the exact value::\n\n >>> Decimal128(Decimal('NaN')).to_decimal()\n Decimal('NaN')\n >>> Decimal128(Decimal('-NaN')).to_decimal()\n Decimal('-NaN')\n >>> Decimal128(Decimal('sNaN')).to_decimal()\n Decimal('sNaN')\n >>> Decimal128(Decimal('-sNaN')).to_decimal()\n Decimal('-sNaN')\n\n Two instances of :class:`Decimal128` compare equal if their Binary\n Integer Decimal encodings are equal::\n\n >>> Decimal128('NaN') == Decimal128('NaN')\n True\n >>> Decimal128('NaN').bid == Decimal128('NaN').bid\n True\n\n This differs from :class:`decimal.Decimal` comparisons for NaN::\n\n >>> Decimal('NaN') == Decimal('NaN')\n False\n \"\"\"\n __slots__ = ('__high', '__low')\n\n _type_marker = 19\n\n def __init__(self, value):\n if isinstance(value, (_string_type, decimal.Decimal)):\n self.__high, self.__low = _decimal_to_128(value)\n elif isinstance(value, (list, tuple)):\n if len(value) != 2:\n raise ValueError('Invalid size for creation of Decimal128 '\n 'from list or tuple. Must have exactly 2 '\n 'elements.')\n self.__high, self.__low = value\n else:\n raise TypeError(\"Cannot convert %r to Decimal128\" % (value,))\n\n def to_decimal(self):\n \"\"\"Returns an instance of :class:`decimal.Decimal` for this\n :class:`Decimal128`.\n \"\"\"\n high = self.__high\n low = self.__low\n sign = 1 if (high & _SIGN) else 0\n\n if (high & _SNAN) == _SNAN:\n return decimal.Decimal((sign, (), 'N'))\n elif (high & _NAN) == _NAN:\n return decimal.Decimal((sign, (), 'n'))\n elif (high & _INF) == _INF:\n return decimal.Decimal((sign, (), 'F'))\n\n if (high & _EXPONENT_MASK) == _EXPONENT_MASK:\n exponent = ((high & 0x1fffe00000000000) >> 47) - _EXPONENT_BIAS\n return decimal.Decimal((sign, (0,), exponent))\n else:\n exponent = ((high & 0x7fff800000000000) >> 49) - _EXPONENT_BIAS\n\n arr = bytearray(15)\n mask = 0x00000000000000ff\n for i in range(14, 6, -1):\n arr[i] = (low & mask) >> ((14 - i) << 3)\n mask = mask << 8\n\n mask = 0x00000000000000ff\n for i in range(6, 0, -1):\n arr[i] = (high & mask) >> ((6 - i) << 3)\n mask = mask << 8\n\n mask = 0x0001000000000000\n arr[0] = (high & mask) >> 48\n\n # cdecimal only accepts a tuple for digits.\n digits = tuple(\n int(digit) for digit in str(_from_bytes(arr, 'big')))\n\n with decimal.localcontext(_DEC128_CTX) as ctx:\n return ctx.create_decimal((sign, digits, exponent))\n\n @classmethod\n def from_bid(cls, value):\n \"\"\"Create an instance of :class:`Decimal128` from Binary Integer\n Decimal string.\n\n :Parameters:\n - `value`: 16 byte string (128-bit IEEE 754-2008 decimal floating\n point in Binary Integer Decimal (BID) format).\n \"\"\"\n if not isinstance(value, bytes):\n raise TypeError(\"value must be an instance of bytes\")\n if len(value) != 16:\n raise ValueError(\"value must be exactly 16 bytes\")\n return cls((_UNPACK_64(value[8:])[0], _UNPACK_64(value[:8])[0]))\n\n @property\n def bid(self):\n \"\"\"The Binary Integer Decimal (BID) encoding of this instance.\"\"\"\n return _PACK_64(self.__low) + _PACK_64(self.__high)\n\n def __str__(self):\n dec = self.to_decimal()\n if dec.is_nan():\n # Required by the drivers spec to match MongoDB behavior.\n return \"NaN\"\n return str(dec)\n\n def __repr__(self):\n return \"Decimal128('%s')\" % (str(self),)\n\n def __setstate__(self, value):\n self.__high, self.__low = value\n\n def __getstate__(self):\n return self.__high, self.__low\n\n def __eq__(self, other):\n if isinstance(other, Decimal128):\n return self.bid == other.bid\n return NotImplemented\n\n def __ne__(self, other):\n return not self == other\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/bson/errors.py",
"content": "# Copyright 2009-present MongoDB, Inc.\n#\n# Licensed under the Apache License, Version 2.0 (the \"License\");\n# you may not use this file except in compliance with the License.\n# You may obtain a copy of the License at\n#\n# http://www.apache.org/licenses/LICENSE-2.0\n#\n# Unless required by applicable law or agreed to in writing, software\n# distributed under the License is distributed on an \"AS IS\" BASIS,\n# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n# See the License for the specific language governing permissions and\n# limitations under the License.\n\n\"\"\"Exceptions raised by the BSON package.\"\"\"\n\n\nclass BSONError(Exception):\n \"\"\"Base class for all BSON exceptions.\n \"\"\"\n\n\nclass InvalidBSON(BSONError):\n \"\"\"Raised when trying to create a BSON object from invalid data.\n \"\"\"\n\n\nclass InvalidStringData(BSONError):\n \"\"\"Raised when trying to encode a string containing non-UTF8 data.\n \"\"\"\n\n\nclass InvalidDocument(BSONError):\n \"\"\"Raised when trying to create a BSON object from an invalid document.\n \"\"\"\n\n\nclass InvalidId(BSONError):\n \"\"\"Raised when trying to create an ObjectId from invalid data.\n \"\"\"\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/bson/int64.py",
"content": "# Copyright 2014-2015 MongoDB, Inc.\n#\n# Licensed under the Apache License, Version 2.0 (the \"License\");\n# you may not use this file except in compliance with the License.\n# You may obtain a copy of the License at\n#\n# http://www.apache.org/licenses/LICENSE-2.0\n#\n# Unless required by applicable law or agreed to in writing, software\n# distributed under the License is distributed on an \"AS IS\" BASIS,\n# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n# See the License for the specific language governing permissions and\n# limitations under the License.\n\n\"\"\"A BSON wrapper for long (int in python3)\"\"\"\n\nfrom bson.py3compat import PY3\n\nif PY3:\n long = int\n\n\nclass Int64(long):\n \"\"\"Representation of the BSON int64 type.\n\n This is necessary because every integral number is an :class:`int` in\n Python 3. Small integral numbers are encoded to BSON int32 by default,\n but Int64 numbers will always be encoded to BSON int64.\n\n :Parameters:\n - `value`: the numeric value to represent\n \"\"\"\n\n _type_marker = 18\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/bson/json_util.py",
"content": "# Copyright 2009-present MongoDB, Inc.\n#\n# Licensed under the Apache License, Version 2.0 (the \"License\");\n# you may not use this file except in compliance with the License.\n# You may obtain a copy of the License at\n#\n# http://www.apache.org/licenses/LICENSE-2.0\n#\n# Unless required by applicable law or agreed to in writing, software\n# distributed under the License is distributed on an \"AS IS\" BASIS,\n# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n# See the License for the specific language governing permissions and\n# limitations under the License.\n\n\"\"\"Tools for using Python's :mod:`json` module with BSON documents.\n\nThis module provides two helper methods `dumps` and `loads` that wrap the\nnative :mod:`json` methods and provide explicit BSON conversion to and from\nJSON. :class:`~bson.json_util.JSONOptions` provides a way to control how JSON\nis emitted and parsed, with the default being the legacy PyMongo format.\n:mod:`~bson.json_util` can also generate Canonical or Relaxed `Extended JSON`_\nwhen :const:`CANONICAL_JSON_OPTIONS` or :const:`RELAXED_JSON_OPTIONS` is\nprovided, respectively.\n\n.. _Extended JSON: https://github.com/mongodb/specifications/blob/master/source/extended-json.rst\n\nExample usage (deserialization):\n\n.. doctest::\n\n >>> from bson.json_util import loads\n >>> loads('[{\"foo\": [1, 2]}, {\"bar\": {\"hello\": \"world\"}}, {\"code\": {\"$scope\": {}, \"$code\": \"function x() { return 1; }\"}}, {\"bin\": {\"$type\": \"80\", \"$binary\": \"AQIDBA==\"}}]')\n [{u'foo': [1, 2]}, {u'bar': {u'hello': u'world'}}, {u'code': Code('function x() { return 1; }', {})}, {u'bin': Binary('...', 128)}]\n\nExample usage (serialization):\n\n.. doctest::\n\n >>> from bson import Binary, Code\n >>> from bson.json_util import dumps\n >>> dumps([{'foo': [1, 2]},\n ... {'bar': {'hello': 'world'}},\n ... {'code': Code(\"function x() { return 1; }\", {})},\n ... {'bin': Binary(b\"\\x01\\x02\\x03\\x04\")}])\n '[{\"foo\": [1, 2]}, {\"bar\": {\"hello\": \"world\"}}, {\"code\": {\"$code\": \"function x() { return 1; }\", \"$scope\": {}}}, {\"bin\": {\"$binary\": \"AQIDBA==\", \"$type\": \"00\"}}]'\n\nExample usage (with :const:`CANONICAL_JSON_OPTIONS`):\n\n.. doctest::\n\n >>> from bson import Binary, Code\n >>> from bson.json_util import dumps, CANONICAL_JSON_OPTIONS\n >>> dumps([{'foo': [1, 2]},\n ... {'bar': {'hello': 'world'}},\n ... {'code': Code(\"function x() { return 1; }\")},\n ... {'bin': Binary(b\"\\x01\\x02\\x03\\x04\")}],\n ... json_options=CANONICAL_JSON_OPTIONS)\n '[{\"foo\": [{\"$numberInt\": \"1\"}, {\"$numberInt\": \"2\"}]}, {\"bar\": {\"hello\": \"world\"}}, {\"code\": {\"$code\": \"function x() { return 1; }\"}}, {\"bin\": {\"$binary\": {\"base64\": \"AQIDBA==\", \"subType\": \"00\"}}}]'\n\nExample usage (with :const:`RELAXED_JSON_OPTIONS`):\n\n.. doctest::\n\n >>> from bson import Binary, Code\n >>> from bson.json_util import dumps, RELAXED_JSON_OPTIONS\n >>> dumps([{'foo': [1, 2]},\n ... {'bar': {'hello': 'world'}},\n ... {'code': Code(\"function x() { return 1; }\")},\n ... {'bin': Binary(b\"\\x01\\x02\\x03\\x04\")}],\n ... json_options=RELAXED_JSON_OPTIONS)\n '[{\"foo\": [1, 2]}, {\"bar\": {\"hello\": \"world\"}}, {\"code\": {\"$code\": \"function x() { return 1; }\"}}, {\"bin\": {\"$binary\": {\"base64\": \"AQIDBA==\", \"subType\": \"00\"}}}]'\n\nAlternatively, you can manually pass the `default` to :func:`json.dumps`.\nIt won't handle :class:`~bson.binary.Binary` and :class:`~bson.code.Code`\ninstances (as they are extended strings you can't provide custom defaults),\nbut it will be faster as there is less recursion.\n\n.. note::\n If your application does not need the flexibility offered by\n :class:`JSONOptions` and spends a large amount of time in the `json_util`\n module, look to\n `python-bsonjs `_ for a nice\n performance improvement. `python-bsonjs` is a fast BSON to MongoDB\n Extended JSON converter for Python built on top of\n `libbson `_. `python-bsonjs` works best\n with PyMongo when using :class:`~bson.raw_bson.RawBSONDocument`.\n\n.. versionchanged:: 2.8\n The output format for :class:`~bson.timestamp.Timestamp` has changed from\n '{\"t\": , \"i\": }' to '{\"$timestamp\": {\"t\": , \"i\": }}'.\n This new format will be decoded to an instance of\n :class:`~bson.timestamp.Timestamp`. The old format will continue to be\n decoded to a python dict as before. Encoding to the old format is no longer\n supported as it was never correct and loses type information.\n Added support for $numberLong and $undefined - new in MongoDB 2.6 - and\n parsing $date in ISO-8601 format.\n\n.. versionchanged:: 2.7\n Preserves order when rendering SON, Timestamp, Code, Binary, and DBRef\n instances.\n\n.. versionchanged:: 2.3\n Added dumps and loads helpers to automatically handle conversion to and\n from json and supports :class:`~bson.binary.Binary` and\n :class:`~bson.code.Code`\n\"\"\"\n\nimport base64\nimport datetime\nimport json\nimport math\nimport re\nimport sys\nimport uuid\n\nfrom pymongo.errors import ConfigurationError\n\nimport bson\nfrom bson import EPOCH_AWARE, EPOCH_NAIVE, RE_TYPE, SON\nfrom bson.binary import (Binary, JAVA_LEGACY, CSHARP_LEGACY, OLD_UUID_SUBTYPE,\n UUID_SUBTYPE)\nfrom bson.code import Code\nfrom bson.codec_options import CodecOptions\nfrom bson.dbref import DBRef\nfrom bson.decimal128 import Decimal128\nfrom bson.int64 import Int64\nfrom bson.max_key import MaxKey\nfrom bson.min_key import MinKey\nfrom bson.objectid import ObjectId\nfrom bson.py3compat import (PY3, iteritems, integer_types, string_type,\n text_type)\nfrom bson.regex import Regex\nfrom bson.timestamp import Timestamp\nfrom bson.tz_util import utc\n\n\n_RE_OPT_TABLE = {\n \"i\": re.I,\n \"l\": re.L,\n \"m\": re.M,\n \"s\": re.S,\n \"u\": re.U,\n \"x\": re.X,\n}\n\n# Dollar-prefixed keys which may appear in DBRefs.\n_DBREF_KEYS = frozenset(['$id', '$ref', '$db'])\n\n\nclass DatetimeRepresentation:\n LEGACY = 0\n \"\"\"Legacy MongoDB Extended JSON datetime representation.\n\n :class:`datetime.datetime` instances will be encoded to JSON in the\n format `{\"$date\": }`, where `dateAsMilliseconds` is\n a 64-bit signed integer giving the number of milliseconds since the Unix\n epoch UTC. This was the default encoding before PyMongo version 3.4.\n\n .. versionadded:: 3.4\n \"\"\"\n\n NUMBERLONG = 1\n \"\"\"NumberLong datetime representation.\n\n :class:`datetime.datetime` instances will be encoded to JSON in the\n format `{\"$date\": {\"$numberLong\": \"\"}}`,\n where `dateAsMilliseconds` is the string representation of a 64-bit signed\n integer giving the number of milliseconds since the Unix epoch UTC.\n\n .. versionadded:: 3.4\n \"\"\"\n\n ISO8601 = 2\n \"\"\"ISO-8601 datetime representation.\n\n :class:`datetime.datetime` instances greater than or equal to the Unix\n epoch UTC will be encoded to JSON in the format `{\"$date\": \"\"}`.\n :class:`datetime.datetime` instances before the Unix epoch UTC will be\n encoded as if the datetime representation is\n :const:`~DatetimeRepresentation.NUMBERLONG`.\n\n .. versionadded:: 3.4\n \"\"\"\n\n\nclass JSONMode:\n LEGACY = 0\n \"\"\"Legacy Extended JSON representation.\n\n In this mode, :func:`~bson.json_util.dumps` produces PyMongo's legacy\n non-standard JSON output. Consider using\n :const:`~bson.json_util.JSONMode.RELAXED` or\n :const:`~bson.json_util.JSONMode.CANONICAL` instead.\n\n .. versionadded:: 3.5\n \"\"\"\n\n RELAXED = 1\n \"\"\"Relaxed Extended JSON representation.\n\n In this mode, :func:`~bson.json_util.dumps` produces Relaxed Extended JSON,\n a mostly JSON-like format. Consider using this for things like a web API,\n where one is sending a document (or a projection of a document) that only\n uses ordinary JSON type primitives. In particular, the ``int``,\n :class:`~bson.int64.Int64`, and ``float`` numeric types are represented in\n the native JSON number format. This output is also the most human readable\n and is useful for debugging and documentation.\n\n .. seealso:: The specification for Relaxed `Extended JSON`_.\n\n .. versionadded:: 3.5\n \"\"\"\n\n CANONICAL = 2\n \"\"\"Canonical Extended JSON representation.\n\n In this mode, :func:`~bson.json_util.dumps` produces Canonical Extended\n JSON, a type preserving format. Consider using this for things like\n testing, where one has to precisely specify expected types in JSON. In\n particular, the ``int``, :class:`~bson.int64.Int64`, and ``float`` numeric\n types are encoded with type wrappers.\n\n .. seealso:: The specification for Canonical `Extended JSON`_.\n\n .. versionadded:: 3.5\n \"\"\"\n\n\nclass JSONOptions(CodecOptions):\n \"\"\"Encapsulates JSON options for :func:`dumps` and :func:`loads`.\n\n :Parameters:\n - `strict_number_long`: If ``True``, :class:`~bson.int64.Int64` objects\n are encoded to MongoDB Extended JSON's *Strict mode* type\n `NumberLong`, ie ``'{\"$numberLong\": \"\" }'``. Otherwise they\n will be encoded as an `int`. Defaults to ``False``.\n - `datetime_representation`: The representation to use when encoding\n instances of :class:`datetime.datetime`. Defaults to\n :const:`~DatetimeRepresentation.LEGACY`.\n - `strict_uuid`: If ``True``, :class:`uuid.UUID` object are encoded to\n MongoDB Extended JSON's *Strict mode* type `Binary`. Otherwise it\n will be encoded as ``'{\"$uuid\": \"\" }'``. Defaults to ``False``.\n - `json_mode`: The :class:`JSONMode` to use when encoding BSON types to\n Extended JSON. Defaults to :const:`~JSONMode.LEGACY`.\n - `document_class`: BSON documents returned by :func:`loads` will be\n decoded to an instance of this class. Must be a subclass of\n :class:`collections.MutableMapping`. Defaults to :class:`dict`.\n - `uuid_representation`: The BSON representation to use when encoding\n and decoding instances of :class:`uuid.UUID`. Defaults to\n :const:`~bson.binary.PYTHON_LEGACY`.\n - `tz_aware`: If ``True``, MongoDB Extended JSON's *Strict mode* type\n `Date` will be decoded to timezone aware instances of\n :class:`datetime.datetime`. Otherwise they will be naive. Defaults\n to ``True``.\n - `tzinfo`: A :class:`datetime.tzinfo` subclass that specifies the\n timezone from which :class:`~datetime.datetime` objects should be\n decoded. Defaults to :const:`~bson.tz_util.utc`.\n - `args`: arguments to :class:`~bson.codec_options.CodecOptions`\n - `kwargs`: arguments to :class:`~bson.codec_options.CodecOptions`\n\n .. seealso:: The specification for Relaxed and Canonical `Extended JSON`_.\n\n .. versionadded:: 3.4\n\n .. versionchanged:: 3.5\n Accepts the optional parameter `json_mode`.\n\n \"\"\"\n\n def __new__(cls, strict_number_long=False,\n datetime_representation=DatetimeRepresentation.LEGACY,\n strict_uuid=False, json_mode=JSONMode.LEGACY,\n *args, **kwargs):\n kwargs[\"tz_aware\"] = kwargs.get(\"tz_aware\", True)\n if kwargs[\"tz_aware\"]:\n kwargs[\"tzinfo\"] = kwargs.get(\"tzinfo\", utc)\n if datetime_representation not in (DatetimeRepresentation.LEGACY,\n DatetimeRepresentation.NUMBERLONG,\n DatetimeRepresentation.ISO8601):\n raise ConfigurationError(\n \"JSONOptions.datetime_representation must be one of LEGACY, \"\n \"NUMBERLONG, or ISO8601 from DatetimeRepresentation.\")\n self = super(JSONOptions, cls).__new__(cls, *args, **kwargs)\n if json_mode not in (JSONMode.LEGACY,\n JSONMode.RELAXED,\n JSONMode.CANONICAL):\n raise ConfigurationError(\n \"JSONOptions.json_mode must be one of LEGACY, RELAXED, \"\n \"or CANONICAL from JSONMode.\")\n self.json_mode = json_mode\n if self.json_mode == JSONMode.RELAXED:\n self.strict_number_long = False\n self.datetime_representation = DatetimeRepresentation.ISO8601\n self.strict_uuid = True\n elif self.json_mode == JSONMode.CANONICAL:\n self.strict_number_long = True\n self.datetime_representation = DatetimeRepresentation.NUMBERLONG\n self.strict_uuid = True\n else:\n self.strict_number_long = strict_number_long\n self.datetime_representation = datetime_representation\n self.strict_uuid = strict_uuid\n return self\n\n def _arguments_repr(self):\n return ('strict_number_long=%r, '\n 'datetime_representation=%r, '\n 'strict_uuid=%r, json_mode=%r, %s' % (\n self.strict_number_long,\n self.datetime_representation,\n self.strict_uuid,\n self.json_mode,\n super(JSONOptions, self)._arguments_repr()))\n\n\nLEGACY_JSON_OPTIONS = JSONOptions(json_mode=JSONMode.LEGACY)\n\"\"\":class:`JSONOptions` for encoding to PyMongo's legacy JSON format.\n\n.. seealso:: The documentation for :const:`bson.json_util.JSONMode.LEGACY`.\n\n.. versionadded:: 3.5\n\"\"\"\n\nDEFAULT_JSON_OPTIONS = LEGACY_JSON_OPTIONS\n\"\"\"The default :class:`JSONOptions` for JSON encoding/decoding.\n\nThe same as :const:`LEGACY_JSON_OPTIONS`. This will change to\n:const:`RELAXED_JSON_OPTIONS` in a future release.\n\n.. versionadded:: 3.4\n\"\"\"\n\nCANONICAL_JSON_OPTIONS = JSONOptions(json_mode=JSONMode.CANONICAL)\n\"\"\":class:`JSONOptions` for Canonical Extended JSON.\n\n.. seealso:: The documentation for :const:`bson.json_util.JSONMode.CANONICAL`.\n\n.. versionadded:: 3.5\n\"\"\"\n\nRELAXED_JSON_OPTIONS = JSONOptions(json_mode=JSONMode.RELAXED)\n\"\"\":class:`JSONOptions` for Relaxed Extended JSON.\n\n.. seealso:: The documentation for :const:`bson.json_util.JSONMode.RELAXED`.\n\n.. versionadded:: 3.5\n\"\"\"\n\nSTRICT_JSON_OPTIONS = JSONOptions(\n strict_number_long=True,\n datetime_representation=DatetimeRepresentation.ISO8601,\n strict_uuid=True)\n\"\"\"**DEPRECATED** - :class:`JSONOptions` for MongoDB Extended JSON's *Strict\nmode* encoding.\n\n.. versionadded:: 3.4\n\n.. versionchanged:: 3.5\n Deprecated. Use :const:`RELAXED_JSON_OPTIONS` or\n :const:`CANONICAL_JSON_OPTIONS` instead.\n\"\"\"\n\n\ndef dumps(obj, *args, **kwargs):\n \"\"\"Helper function that wraps :func:`json.dumps`.\n\n Recursive function that handles all BSON types including\n :class:`~bson.binary.Binary` and :class:`~bson.code.Code`.\n\n :Parameters:\n - `json_options`: A :class:`JSONOptions` instance used to modify the\n encoding of MongoDB Extended JSON types. Defaults to\n :const:`DEFAULT_JSON_OPTIONS`.\n\n .. versionchanged:: 3.4\n Accepts optional parameter `json_options`. See :class:`JSONOptions`.\n\n .. versionchanged:: 2.7\n Preserves order when rendering SON, Timestamp, Code, Binary, and DBRef\n instances.\n \"\"\"\n json_options = kwargs.pop(\"json_options\", DEFAULT_JSON_OPTIONS)\n return json.dumps(_json_convert(obj, json_options), *args, **kwargs)\n\n\ndef loads(s, *args, **kwargs):\n \"\"\"Helper function that wraps :func:`json.loads`.\n\n Automatically passes the object_hook for BSON type conversion.\n\n Raises ``TypeError``, ``ValueError``, ``KeyError``, or\n :exc:`~bson.errors.InvalidId` on invalid MongoDB Extended JSON.\n\n :Parameters:\n - `json_options`: A :class:`JSONOptions` instance used to modify the\n decoding of MongoDB Extended JSON types. Defaults to\n :const:`DEFAULT_JSON_OPTIONS`.\n\n .. versionchanged:: 3.5\n Parses Relaxed and Canonical Extended JSON as well as PyMongo's legacy\n format. Now raises ``TypeError`` or ``ValueError`` when parsing JSON\n type wrappers with values of the wrong type or any extra keys.\n\n .. versionchanged:: 3.4\n Accepts optional parameter `json_options`. See :class:`JSONOptions`.\n \"\"\"\n json_options = kwargs.pop(\"json_options\", DEFAULT_JSON_OPTIONS)\n kwargs[\"object_pairs_hook\"] = lambda pairs: object_pairs_hook(\n pairs, json_options)\n return json.loads(s, *args, **kwargs)\n\n\ndef _json_convert(obj, json_options=DEFAULT_JSON_OPTIONS):\n \"\"\"Recursive helper method that converts BSON types so they can be\n converted into json.\n \"\"\"\n if hasattr(obj, 'iteritems') or hasattr(obj, 'items'): # PY3 support\n return SON(((k, _json_convert(v, json_options))\n for k, v in iteritems(obj)))\n elif hasattr(obj, '__iter__') and not isinstance(obj, (text_type, bytes)):\n return list((_json_convert(v, json_options) for v in obj))\n try:\n return default(obj, json_options)\n except TypeError:\n return obj\n\n\ndef object_pairs_hook(pairs, json_options=DEFAULT_JSON_OPTIONS):\n return object_hook(json_options.document_class(pairs), json_options)\n\n\ndef object_hook(dct, json_options=DEFAULT_JSON_OPTIONS):\n if \"$oid\" in dct:\n return _parse_canonical_oid(dct)\n if \"$ref\" in dct:\n return _parse_canonical_dbref(dct)\n if \"$date\" in dct:\n return _parse_canonical_datetime(dct, json_options)\n if \"$regex\" in dct:\n return _parse_legacy_regex(dct)\n if \"$minKey\" in dct:\n return _parse_canonical_minkey(dct)\n if \"$maxKey\" in dct:\n return _parse_canonical_maxkey(dct)\n if \"$binary\" in dct:\n if \"$type\" in dct:\n return _parse_legacy_binary(dct, json_options)\n else:\n return _parse_canonical_binary(dct, json_options)\n if \"$code\" in dct:\n return _parse_canonical_code(dct)\n if \"$uuid\" in dct:\n return _parse_legacy_uuid(dct)\n if \"$undefined\" in dct:\n return None\n if \"$numberLong\" in dct:\n return _parse_canonical_int64(dct)\n if \"$timestamp\" in dct:\n tsp = dct[\"$timestamp\"]\n return Timestamp(tsp[\"t\"], tsp[\"i\"])\n if \"$numberDecimal\" in dct:\n return _parse_canonical_decimal128(dct)\n if \"$dbPointer\" in dct:\n return _parse_canonical_dbpointer(dct)\n if \"$regularExpression\" in dct:\n return _parse_canonical_regex(dct)\n if \"$symbol\" in dct:\n return _parse_canonical_symbol(dct)\n if \"$numberInt\" in dct:\n return _parse_canonical_int32(dct)\n if \"$numberDouble\" in dct:\n return _parse_canonical_double(dct)\n return dct\n\n\ndef _parse_legacy_regex(doc):\n pattern = doc[\"$regex\"]\n # Check if this is the $regex query operator.\n if isinstance(pattern, Regex):\n return doc\n flags = 0\n # PyMongo always adds $options but some other tools may not.\n for opt in doc.get(\"$options\", \"\"):\n flags |= _RE_OPT_TABLE.get(opt, 0)\n return Regex(pattern, flags)\n\n\ndef _parse_legacy_uuid(doc):\n \"\"\"Decode a JSON legacy $uuid to Python UUID.\"\"\"\n if len(doc) != 1:\n raise TypeError('Bad $uuid, extra field(s): %s' % (doc,))\n return uuid.UUID(doc[\"$uuid\"])\n\n\ndef _binary_or_uuid(data, subtype, json_options):\n # special handling for UUID\n if subtype == OLD_UUID_SUBTYPE:\n if json_options.uuid_representation == CSHARP_LEGACY:\n return uuid.UUID(bytes_le=data)\n if json_options.uuid_representation == JAVA_LEGACY:\n data = data[7::-1] + data[:7:-1]\n return uuid.UUID(bytes=data)\n if subtype == UUID_SUBTYPE:\n return uuid.UUID(bytes=data)\n if PY3 and subtype == 0:\n return data\n return Binary(data, subtype)\n\n\ndef _parse_legacy_binary(doc, json_options):\n if isinstance(doc[\"$type\"], int):\n doc[\"$type\"] = \"%02x\" % doc[\"$type\"]\n subtype = int(doc[\"$type\"], 16)\n if subtype >= 0xffffff80: # Handle mongoexport values\n subtype = int(doc[\"$type\"][6:], 16)\n data = base64.b64decode(doc[\"$binary\"].encode())\n return _binary_or_uuid(data, subtype, json_options)\n\n\ndef _parse_canonical_binary(doc, json_options):\n binary = doc[\"$binary\"]\n b64 = binary[\"base64\"]\n subtype = binary[\"subType\"]\n if not isinstance(b64, string_type):\n raise TypeError('$binary base64 must be a string: %s' % (doc,))\n if not isinstance(subtype, string_type) or len(subtype) > 2:\n raise TypeError('$binary subType must be a string at most 2 '\n 'characters: %s' % (doc,))\n if len(binary) != 2:\n raise TypeError('$binary must include only \"base64\" and \"subType\" '\n 'components: %s' % (doc,))\n\n data = base64.b64decode(b64.encode())\n return _binary_or_uuid(data, int(subtype, 16), json_options)\n\n\ndef _parse_canonical_datetime(doc, json_options):\n \"\"\"Decode a JSON datetime to python datetime.datetime.\"\"\"\n dtm = doc[\"$date\"]\n if len(doc) != 1:\n raise TypeError('Bad $date, extra field(s): %s' % (doc,))\n # mongoexport 2.6 and newer\n if isinstance(dtm, string_type):\n # Parse offset\n if dtm[-1] == 'Z':\n dt = dtm[:-1]\n offset = 'Z'\n elif dtm[-6] in ('+', '-') and dtm[-3] == ':':\n # (+|-)HH:MM\n dt = dtm[:-6]\n offset = dtm[-6:]\n elif dtm[-5] in ('+', '-'):\n # (+|-)HHMM\n dt = dtm[:-5]\n offset = dtm[-5:]\n elif dtm[-3] in ('+', '-'):\n # (+|-)HH\n dt = dtm[:-3]\n offset = dtm[-3:]\n else:\n dt = dtm\n offset = ''\n\n # Parse the optional factional seconds portion.\n dot_index = dt.rfind('.')\n microsecond = 0\n if dot_index != -1:\n microsecond = int(float(dt[dot_index:]) * 1000000)\n dt = dt[:dot_index]\n\n aware = datetime.datetime.strptime(\n dt, \"%Y-%m-%dT%H:%M:%S\").replace(microsecond=microsecond,\n tzinfo=utc)\n\n if offset and offset != 'Z':\n if len(offset) == 6:\n hours, minutes = offset[1:].split(':')\n secs = (int(hours) * 3600 + int(minutes) * 60)\n elif len(offset) == 5:\n secs = (int(offset[1:3]) * 3600 + int(offset[3:]) * 60)\n elif len(offset) == 3:\n secs = int(offset[1:3]) * 3600\n if offset[0] == \"-\":\n secs *= -1\n aware = aware - datetime.timedelta(seconds=secs)\n\n if json_options.tz_aware:\n if json_options.tzinfo:\n aware = aware.astimezone(json_options.tzinfo)\n return aware\n else:\n return aware.replace(tzinfo=None)\n return bson._millis_to_datetime(int(dtm), json_options)\n\n\ndef _parse_canonical_oid(doc):\n \"\"\"Decode a JSON ObjectId to bson.objectid.ObjectId.\"\"\"\n if len(doc) != 1:\n raise TypeError('Bad $oid, extra field(s): %s' % (doc,))\n return ObjectId(doc['$oid'])\n\n\ndef _parse_canonical_symbol(doc):\n \"\"\"Decode a JSON symbol to Python string.\"\"\"\n symbol = doc['$symbol']\n if len(doc) != 1:\n raise TypeError('Bad $symbol, extra field(s): %s' % (doc,))\n return text_type(symbol)\n\n\ndef _parse_canonical_code(doc):\n \"\"\"Decode a JSON code to bson.code.Code.\"\"\"\n for key in doc:\n if key not in ('$code', '$scope'):\n raise TypeError('Bad $code, extra field(s): %s' % (doc,))\n return Code(doc['$code'], scope=doc.get('$scope'))\n\n\ndef _parse_canonical_regex(doc):\n \"\"\"Decode a JSON regex to bson.regex.Regex.\"\"\"\n regex = doc['$regularExpression']\n if len(doc) != 1:\n raise TypeError('Bad $regularExpression, extra field(s): %s' % (doc,))\n if len(regex) != 2:\n raise TypeError('Bad $regularExpression must include only \"pattern\"'\n 'and \"options\" components: %s' % (doc,))\n return Regex(regex['pattern'], regex['options'])\n\n\ndef _parse_canonical_dbref(doc):\n \"\"\"Decode a JSON DBRef to bson.dbref.DBRef.\"\"\"\n for key in doc:\n if key.startswith('$') and key not in _DBREF_KEYS:\n # Other keys start with $, so dct cannot be parsed as a DBRef.\n return doc\n return DBRef(doc.pop('$ref'), doc.pop('$id'),\n database=doc.pop('$db', None), **doc)\n\n\ndef _parse_canonical_dbpointer(doc):\n \"\"\"Decode a JSON (deprecated) DBPointer to bson.dbref.DBRef.\"\"\"\n dbref = doc['$dbPointer']\n if len(doc) != 1:\n raise TypeError('Bad $dbPointer, extra field(s): %s' % (doc,))\n if isinstance(dbref, DBRef):\n dbref_doc = dbref.as_doc()\n # DBPointer must not contain $db in its value.\n if dbref.database is not None:\n raise TypeError(\n 'Bad $dbPointer, extra field $db: %s' % (dbref_doc,))\n if not isinstance(dbref.id, ObjectId):\n raise TypeError(\n 'Bad $dbPointer, $id must be an ObjectId: %s' % (dbref_doc,))\n if len(dbref_doc) != 2:\n raise TypeError(\n 'Bad $dbPointer, extra field(s) in DBRef: %s' % (dbref_doc,))\n return dbref\n else:\n raise TypeError('Bad $dbPointer, expected a DBRef: %s' % (doc,))\n\n\ndef _parse_canonical_int32(doc):\n \"\"\"Decode a JSON int32 to python int.\"\"\"\n i_str = doc['$numberInt']\n if len(doc) != 1:\n raise TypeError('Bad $numberInt, extra field(s): %s' % (doc,))\n if not isinstance(i_str, string_type):\n raise TypeError('$numberInt must be string: %s' % (doc,))\n return int(i_str)\n\n\ndef _parse_canonical_int64(doc):\n \"\"\"Decode a JSON int64 to bson.int64.Int64.\"\"\"\n l_str = doc['$numberLong']\n if len(doc) != 1:\n raise TypeError('Bad $numberLong, extra field(s): %s' % (doc,))\n return Int64(l_str)\n\n\ndef _parse_canonical_double(doc):\n \"\"\"Decode a JSON double to python float.\"\"\"\n d_str = doc['$numberDouble']\n if len(doc) != 1:\n raise TypeError('Bad $numberDouble, extra field(s): %s' % (doc,))\n if not isinstance(d_str, string_type):\n raise TypeError('$numberDouble must be string: %s' % (doc,))\n return float(d_str)\n\n\ndef _parse_canonical_decimal128(doc):\n \"\"\"Decode a JSON decimal128 to bson.decimal128.Decimal128.\"\"\"\n d_str = doc['$numberDecimal']\n if len(doc) != 1:\n raise TypeError('Bad $numberDecimal, extra field(s): %s' % (doc,))\n if not isinstance(d_str, string_type):\n raise TypeError('$numberDecimal must be string: %s' % (doc,))\n return Decimal128(d_str)\n\n\ndef _parse_canonical_minkey(doc):\n \"\"\"Decode a JSON MinKey to bson.min_key.MinKey.\"\"\"\n if doc['$minKey'] is not 1:\n raise TypeError('$minKey value must be 1: %s' % (doc,))\n if len(doc) != 1:\n raise TypeError('Bad $minKey, extra field(s): %s' % (doc,))\n return MinKey()\n\n\ndef _parse_canonical_maxkey(doc):\n \"\"\"Decode a JSON MaxKey to bson.max_key.MaxKey.\"\"\"\n if doc['$maxKey'] is not 1:\n raise TypeError('$maxKey value must be 1: %s', (doc,))\n if len(doc) != 1:\n raise TypeError('Bad $minKey, extra field(s): %s' % (doc,))\n return MaxKey()\n\n\ndef _encode_binary(data, subtype, json_options):\n if json_options.json_mode == JSONMode.LEGACY:\n return SON([\n ('$binary', base64.b64encode(data).decode()),\n ('$type', \"%02x\" % subtype)])\n return {'$binary': SON([\n ('base64', base64.b64encode(data).decode()),\n ('subType', \"%02x\" % subtype)])}\n\n\ndef default(obj, json_options=DEFAULT_JSON_OPTIONS):\n # We preserve key order when rendering SON, DBRef, etc. as JSON by\n # returning a SON for those types instead of a dict.\n if isinstance(obj, ObjectId):\n return {\"$oid\": str(obj)}\n if isinstance(obj, DBRef):\n return _json_convert(obj.as_doc(), json_options=json_options)\n if isinstance(obj, datetime.datetime):\n if (json_options.datetime_representation ==\n DatetimeRepresentation.ISO8601):\n if not obj.tzinfo:\n obj = obj.replace(tzinfo=utc)\n if obj >= EPOCH_AWARE:\n off = obj.tzinfo.utcoffset(obj)\n if (off.days, off.seconds, off.microseconds) == (0, 0, 0):\n tz_string = 'Z'\n else:\n tz_string = obj.strftime('%z')\n millis = int(obj.microsecond / 1000)\n fracsecs = \".%03d\" % (millis,) if millis else \"\"\n return {\"$date\": \"%s%s%s\" % (\n obj.strftime(\"%Y-%m-%dT%H:%M:%S\"), fracsecs, tz_string)}\n\n millis = bson._datetime_to_millis(obj)\n if (json_options.datetime_representation ==\n DatetimeRepresentation.LEGACY):\n return {\"$date\": millis}\n return {\"$date\": {\"$numberLong\": str(millis)}}\n if json_options.strict_number_long and isinstance(obj, Int64):\n return {\"$numberLong\": str(obj)}\n if isinstance(obj, (RE_TYPE, Regex)):\n flags = \"\"\n if obj.flags & re.IGNORECASE:\n flags += \"i\"\n if obj.flags & re.LOCALE:\n flags += \"l\"\n if obj.flags & re.MULTILINE:\n flags += \"m\"\n if obj.flags & re.DOTALL:\n flags += \"s\"\n if obj.flags & re.UNICODE:\n flags += \"u\"\n if obj.flags & re.VERBOSE:\n flags += \"x\"\n if isinstance(obj.pattern, text_type):\n pattern = obj.pattern\n else:\n pattern = obj.pattern.decode('utf-8')\n if json_options.json_mode == JSONMode.LEGACY:\n return SON([(\"$regex\", pattern), (\"$options\", flags)])\n return {'$regularExpression': SON([(\"pattern\", pattern),\n (\"options\", flags)])}\n if isinstance(obj, MinKey):\n return {\"$minKey\": 1}\n if isinstance(obj, MaxKey):\n return {\"$maxKey\": 1}\n if isinstance(obj, Timestamp):\n return {\"$timestamp\": SON([(\"t\", obj.time), (\"i\", obj.inc)])}\n if isinstance(obj, Code):\n if obj.scope is None:\n return {'$code': str(obj)}\n return SON([\n ('$code', str(obj)),\n ('$scope', _json_convert(obj.scope, json_options))])\n if isinstance(obj, Binary):\n return _encode_binary(obj, obj.subtype, json_options)\n if PY3 and isinstance(obj, bytes):\n return _encode_binary(obj, 0, json_options)\n if isinstance(obj, uuid.UUID):\n if json_options.strict_uuid:\n data = obj.bytes\n subtype = OLD_UUID_SUBTYPE\n if json_options.uuid_representation == CSHARP_LEGACY:\n data = obj.bytes_le\n elif json_options.uuid_representation == JAVA_LEGACY:\n data = data[7::-1] + data[:7:-1]\n elif json_options.uuid_representation == UUID_SUBTYPE:\n subtype = UUID_SUBTYPE\n return _encode_binary(data, subtype, json_options)\n else:\n return {\"$uuid\": obj.hex}\n if isinstance(obj, Decimal128):\n return {\"$numberDecimal\": str(obj)}\n if isinstance(obj, bool):\n return obj\n if (json_options.json_mode == JSONMode.CANONICAL and\n isinstance(obj, integer_types)):\n if -2 ** 31 <= obj < 2 ** 31:\n return {'$numberInt': text_type(obj)}\n return {'$numberLong': text_type(obj)}\n if json_options.json_mode != JSONMode.LEGACY and isinstance(obj, float):\n if math.isnan(obj):\n return {'$numberDouble': 'NaN'}\n elif math.isinf(obj):\n representation = 'Infinity' if obj > 0 else '-Infinity'\n return {'$numberDouble': representation}\n elif json_options.json_mode == JSONMode.CANONICAL:\n # repr() will return the shortest string guaranteed to produce the\n # original value, when float() is called on it. str produces a\n # shorter string in Python 2.\n return {'$numberDouble': text_type(repr(obj))}\n raise TypeError(\"%r is not JSON serializable\" % obj)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/bson/max_key.py",
"content": "# Copyright 2010-present MongoDB, Inc.\n#\n# Licensed under the Apache License, Version 2.0 (the \"License\");\n# you may not use this file except in compliance with the License.\n# You may obtain a copy of the License at\n#\n# http://www.apache.org/licenses/LICENSE-2.0\n#\n# Unless required by applicable law or agreed to in writing, software\n# distributed under the License is distributed on an \"AS IS\" BASIS,\n# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n# See the License for the specific language governing permissions and\n# limitations under the License.\n\n\"\"\"Representation for the MongoDB internal MaxKey type.\n\"\"\"\n\n\nclass MaxKey(object):\n \"\"\"MongoDB internal MaxKey type.\n\n .. versionchanged:: 2.7\n ``MaxKey`` now implements comparison operators.\n \"\"\"\n\n _type_marker = 127\n\n def __eq__(self, other):\n return isinstance(other, MaxKey)\n\n def __hash__(self):\n return hash(self._type_marker)\n\n def __ne__(self, other):\n return not self == other\n\n def __le__(self, other):\n return isinstance(other, MaxKey)\n\n def __lt__(self, dummy):\n return False\n\n def __ge__(self, dummy):\n return True\n\n def __gt__(self, other):\n return not isinstance(other, MaxKey)\n\n def __repr__(self):\n return \"MaxKey()\"\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/bson/min_key.py",
"content": "# Copyright 2010-present MongoDB, Inc.\n#\n# Licensed under the Apache License, Version 2.0 (the \"License\");\n# you may not use this file except in compliance with the License.\n# You may obtain a copy of the License at\n#\n# http://www.apache.org/licenses/LICENSE-2.0\n#\n# Unless required by applicable law or agreed to in writing, software\n# distributed under the License is distributed on an \"AS IS\" BASIS,\n# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n# See the License for the specific language governing permissions and\n# limitations under the License.\n\n\"\"\"Representation for the MongoDB internal MinKey type.\n\"\"\"\n\n\nclass MinKey(object):\n \"\"\"MongoDB internal MinKey type.\n\n .. versionchanged:: 2.7\n ``MinKey`` now implements comparison operators.\n \"\"\"\n\n _type_marker = 255\n\n def __eq__(self, other):\n return isinstance(other, MinKey)\n\n def __hash__(self):\n return hash(self._type_marker)\n\n def __ne__(self, other):\n return not self == other\n\n def __le__(self, dummy):\n return True\n\n def __lt__(self, other):\n return not isinstance(other, MinKey)\n\n def __ge__(self, other):\n return isinstance(other, MinKey)\n\n def __gt__(self, dummy):\n return False\n\n def __repr__(self):\n return \"MinKey()\"\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/bson/objectid.py",
"content": "# Copyright 2009-2015 MongoDB, Inc.\n#\n# Licensed under the Apache License, Version 2.0 (the \"License\");\n# you may not use this file except in compliance with the License.\n# You may obtain a copy of the License at\n#\n# http://www.apache.org/licenses/LICENSE-2.0\n#\n# Unless required by applicable law or agreed to in writing, software\n# distributed under the License is distributed on an \"AS IS\" BASIS,\n# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n# See the License for the specific language governing permissions and\n# limitations under the License.\n\n\"\"\"Tools for working with MongoDB `ObjectIds\n`_.\n\"\"\"\n\nimport binascii\nimport calendar\nimport datetime\nimport os\nimport struct\nimport threading\nimport time\n\nfrom random import SystemRandom\n\nfrom bson.errors import InvalidId\nfrom bson.py3compat import PY3, bytes_from_hex, string_type, text_type\nfrom bson.tz_util import utc\n\n\n_MAX_COUNTER_VALUE = 0xFFFFFF\n\n\ndef _raise_invalid_id(oid):\n raise InvalidId(\n \"%r is not a valid ObjectId, it must be a 12-byte input\"\n \" or a 24-character hex string\" % oid)\n\n\ndef _random_bytes():\n \"\"\"Get the 5-byte random field of an ObjectId.\"\"\"\n return os.urandom(5)\n\n\nclass ObjectId(object):\n \"\"\"A MongoDB ObjectId.\n \"\"\"\n\n _pid = os.getpid()\n\n _inc = SystemRandom().randint(0, _MAX_COUNTER_VALUE)\n _inc_lock = threading.Lock()\n\n __random = _random_bytes()\n\n __slots__ = ('__id',)\n\n _type_marker = 7\n\n def __init__(self, oid=None):\n \"\"\"Initialize a new ObjectId.\n\n An ObjectId is a 12-byte unique identifier consisting of:\n\n - a 4-byte value representing the seconds since the Unix epoch,\n - a 5-byte random value,\n - a 3-byte counter, starting with a random value.\n\n By default, ``ObjectId()`` creates a new unique identifier. The\n optional parameter `oid` can be an :class:`ObjectId`, or any 12\n :class:`bytes` or, in Python 2, any 12-character :class:`str`.\n\n For example, the 12 bytes b'foo-bar-quux' do not follow the ObjectId\n specification but they are acceptable input::\n\n >>> ObjectId(b'foo-bar-quux')\n ObjectId('666f6f2d6261722d71757578')\n\n `oid` can also be a :class:`unicode` or :class:`str` of 24 hex digits::\n\n >>> ObjectId('0123456789ab0123456789ab')\n ObjectId('0123456789ab0123456789ab')\n >>>\n >>> # A u-prefixed unicode literal:\n >>> ObjectId(u'0123456789ab0123456789ab')\n ObjectId('0123456789ab0123456789ab')\n\n Raises :class:`~bson.errors.InvalidId` if `oid` is not 12 bytes nor\n 24 hex digits, or :class:`TypeError` if `oid` is not an accepted type.\n\n :Parameters:\n - `oid` (optional): a valid ObjectId.\n\n .. mongodoc:: objectids\n\n .. versionchanged:: 3.8\n :class:`~bson.objectid.ObjectId` now implements the `ObjectID\n specification version 0.2\n `_.\n \"\"\"\n if oid is None:\n self.__generate()\n elif isinstance(oid, bytes) and len(oid) == 12:\n self.__id = oid\n else:\n self.__validate(oid)\n\n @classmethod\n def from_datetime(cls, generation_time):\n \"\"\"Create a dummy ObjectId instance with a specific generation time.\n\n This method is useful for doing range queries on a field\n containing :class:`ObjectId` instances.\n\n .. warning::\n It is not safe to insert a document containing an ObjectId\n generated using this method. This method deliberately\n eliminates the uniqueness guarantee that ObjectIds\n generally provide. ObjectIds generated with this method\n should be used exclusively in queries.\n\n `generation_time` will be converted to UTC. Naive datetime\n instances will be treated as though they already contain UTC.\n\n An example using this helper to get documents where ``\"_id\"``\n was generated before January 1, 2010 would be:\n\n >>> gen_time = datetime.datetime(2010, 1, 1)\n >>> dummy_id = ObjectId.from_datetime(gen_time)\n >>> result = collection.find({\"_id\": {\"$lt\": dummy_id}})\n\n :Parameters:\n - `generation_time`: :class:`~datetime.datetime` to be used\n as the generation time for the resulting ObjectId.\n \"\"\"\n if generation_time.utcoffset() is not None:\n generation_time = generation_time - generation_time.utcoffset()\n timestamp = calendar.timegm(generation_time.timetuple())\n oid = struct.pack(\n \">I\", int(timestamp)) + b\"\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\"\n return cls(oid)\n\n @classmethod\n def is_valid(cls, oid):\n \"\"\"Checks if a `oid` string is valid or not.\n\n :Parameters:\n - `oid`: the object id to validate\n\n .. versionadded:: 2.3\n \"\"\"\n if not oid:\n return False\n\n try:\n ObjectId(oid)\n return True\n except (InvalidId, TypeError):\n return False\n\n @classmethod\n def _random(cls):\n \"\"\"Generate a 5-byte random number once per process.\n \"\"\"\n pid = os.getpid()\n if pid != cls._pid:\n cls._pid = pid\n cls.__random = _random_bytes()\n return cls.__random\n\n def __generate(self):\n \"\"\"Generate a new value for this ObjectId.\n \"\"\"\n\n # 4 bytes current time\n oid = struct.pack(\">I\", int(time.time()))\n\n # 5 bytes random\n oid += ObjectId._random()\n\n # 3 bytes inc\n with ObjectId._inc_lock:\n oid += struct.pack(\">I\", ObjectId._inc)[1:4]\n ObjectId._inc = (ObjectId._inc + 1) % (_MAX_COUNTER_VALUE + 1)\n\n self.__id = oid\n\n def __validate(self, oid):\n \"\"\"Validate and use the given id for this ObjectId.\n\n Raises TypeError if id is not an instance of\n (:class:`basestring` (:class:`str` or :class:`bytes`\n in python 3), ObjectId) and InvalidId if it is not a\n valid ObjectId.\n\n :Parameters:\n - `oid`: a valid ObjectId\n \"\"\"\n if isinstance(oid, ObjectId):\n self.__id = oid.binary\n # bytes or unicode in python 2, str in python 3\n elif isinstance(oid, string_type):\n if len(oid) == 24:\n try:\n self.__id = bytes_from_hex(oid)\n except (TypeError, ValueError):\n _raise_invalid_id(oid)\n else:\n _raise_invalid_id(oid)\n else:\n raise TypeError(\"id must be an instance of (bytes, %s, ObjectId), \"\n \"not %s\" % (text_type.__name__, type(oid)))\n\n @property\n def binary(self):\n \"\"\"12-byte binary representation of this ObjectId.\n \"\"\"\n return self.__id\n\n @property\n def generation_time(self):\n \"\"\"A :class:`datetime.datetime` instance representing the time of\n generation for this :class:`ObjectId`.\n\n The :class:`datetime.datetime` is timezone aware, and\n represents the generation time in UTC. It is precise to the\n second.\n \"\"\"\n timestamp = struct.unpack(\">I\", self.__id[0:4])[0]\n return datetime.datetime.fromtimestamp(timestamp, utc)\n\n def __getstate__(self):\n \"\"\"return value of object for pickling.\n needed explicitly because __slots__() defined.\n \"\"\"\n return self.__id\n\n def __setstate__(self, value):\n \"\"\"explicit state set from pickling\n \"\"\"\n # Provide backwards compatability with OIDs\n # pickled with pymongo-1.9 or older.\n if isinstance(value, dict):\n oid = value[\"_ObjectId__id\"]\n else:\n oid = value\n # ObjectIds pickled in python 2.x used `str` for __id.\n # In python 3.x this has to be converted to `bytes`\n # by encoding latin-1.\n if PY3 and isinstance(oid, text_type):\n self.__id = oid.encode('latin-1')\n else:\n self.__id = oid\n\n def __str__(self):\n if PY3:\n return binascii.hexlify(self.__id).decode()\n return binascii.hexlify(self.__id)\n\n def __repr__(self):\n return \"ObjectId('%s')\" % (str(self),)\n\n def __eq__(self, other):\n if isinstance(other, ObjectId):\n return self.__id == other.binary\n return NotImplemented\n\n def __ne__(self, other):\n if isinstance(other, ObjectId):\n return self.__id != other.binary\n return NotImplemented\n\n def __lt__(self, other):\n if isinstance(other, ObjectId):\n return self.__id < other.binary\n return NotImplemented\n\n def __le__(self, other):\n if isinstance(other, ObjectId):\n return self.__id <= other.binary\n return NotImplemented\n\n def __gt__(self, other):\n if isinstance(other, ObjectId):\n return self.__id > other.binary\n return NotImplemented\n\n def __ge__(self, other):\n if isinstance(other, ObjectId):\n return self.__id >= other.binary\n return NotImplemented\n\n def __hash__(self):\n \"\"\"Get a hash value for this :class:`ObjectId`.\"\"\"\n return hash(self.__id)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/bson/py3compat.py",
"content": "# Copyright 2009-present MongoDB, Inc.\n#\n# Licensed under the Apache License, Version 2.0 (the \"License\"); you\n# may not use this file except in compliance with the License. You\n# may obtain a copy of the License at\n#\n# http://www.apache.org/licenses/LICENSE-2.0\n#\n# Unless required by applicable law or agreed to in writing, software\n# distributed under the License is distributed on an \"AS IS\" BASIS,\n# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or\n# implied. See the License for the specific language governing\n# permissions and limitations under the License.\n\n\"\"\"Utility functions and definitions for python3 compatibility.\"\"\"\n\nimport sys\n\nPY3 = sys.version_info[0] == 3\n\nif PY3:\n import codecs\n import collections.abc as abc\n import _thread as thread\n from abc import ABC, abstractmethod\n from io import BytesIO as StringIO\n\n def abstractproperty(func):\n return property(abstractmethod(func))\n\n MAXSIZE = sys.maxsize\n\n imap = map\n\n def b(s):\n # BSON and socket operations deal in binary data. In\n # python 3 that means instances of `bytes`. In python\n # 2.7 you can create an alias for `bytes` using\n # the b prefix (e.g. b'foo').\n # See http://python3porting.com/problems.html#nicer-solutions\n return codecs.latin_1_encode(s)[0]\n\n def bytes_from_hex(h):\n return bytes.fromhex(h)\n\n def iteritems(d):\n return iter(d.items())\n\n def itervalues(d):\n return iter(d.values())\n\n def reraise(exctype, value, trace=None):\n raise exctype(str(value)).with_traceback(trace)\n\n def reraise_instance(exc_instance, trace=None):\n raise exc_instance.with_traceback(trace)\n\n def _unicode(s):\n return s\n\n text_type = str\n string_type = str\n integer_types = int\nelse:\n import collections as abc\n import thread\n from abc import ABCMeta, abstractproperty\n\n from itertools import imap\n try:\n from cStringIO import StringIO\n except ImportError:\n from StringIO import StringIO\n\n ABC = ABCMeta('ABC', (object,), {})\n\n MAXSIZE = sys.maxint\n\n def b(s):\n # See comments above. In python 2.x b('foo') is just 'foo'.\n return s\n\n def bytes_from_hex(h):\n return h.decode('hex')\n\n def iteritems(d):\n return d.iteritems()\n\n def itervalues(d):\n return d.itervalues()\n\n def reraise(exctype, value, trace=None):\n _reraise(exctype, str(value), trace)\n\n def reraise_instance(exc_instance, trace=None):\n _reraise(exc_instance, None, trace)\n\n # \"raise x, y, z\" raises SyntaxError in Python 3\n exec(\"\"\"def _reraise(exc, value, trace):\n raise exc, value, trace\n\"\"\")\n\n _unicode = unicode\n\n string_type = basestring\n text_type = unicode\n integer_types = (int, long)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/bson/raw_bson.py",
"content": "# Copyright 2015-present MongoDB, Inc.\n#\n# Licensed under the Apache License, Version 2.0 (the \"License\");\n# you may not use this file except in compliance with the License.\n# You may obtain a copy of the License at\n#\n# http://www.apache.org/licenses/LICENSE-2.0\n#\n# Unless required by applicable law or agreed to in writing, software\n# distributed under the License is distributed on an \"AS IS\" BASIS,\n# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n# See the License for the specific language governing permissions and\n# limitations under the License.\n\n\"\"\"Tools for representing raw BSON documents.\n\"\"\"\n\nfrom bson import _raw_to_dict, _get_object_size\nfrom bson.py3compat import abc, iteritems\nfrom bson.codec_options import (\n DEFAULT_CODEC_OPTIONS as DEFAULT, _RAW_BSON_DOCUMENT_MARKER)\nfrom bson.son import SON\n\n\nclass RawBSONDocument(abc.Mapping):\n \"\"\"Representation for a MongoDB document that provides access to the raw\n BSON bytes that compose it.\n\n Only when a field is accessed or modified within the document does\n RawBSONDocument decode its bytes.\n \"\"\"\n\n __slots__ = ('__raw', '__inflated_doc', '__codec_options')\n _type_marker = _RAW_BSON_DOCUMENT_MARKER\n\n def __init__(self, bson_bytes, codec_options=None):\n \"\"\"Create a new :class:`RawBSONDocument`\n\n :class:`RawBSONDocument` is a representation of a BSON document that\n provides access to the underlying raw BSON bytes. Only when a field is\n accessed or modified within the document does RawBSONDocument decode\n its bytes.\n\n :class:`RawBSONDocument` implements the ``Mapping`` abstract base\n class from the standard library so it can be used like a read-only\n ``dict``::\n\n >>> raw_doc = RawBSONDocument(BSON.encode({'_id': 'my_doc'}))\n >>> raw_doc.raw\n b'...'\n >>> raw_doc['_id']\n 'my_doc'\n\n :Parameters:\n - `bson_bytes`: the BSON bytes that compose this document\n - `codec_options` (optional): An instance of\n :class:`~bson.codec_options.CodecOptions` whose ``document_class``\n must be :class:`RawBSONDocument`. The default is\n :attr:`DEFAULT_RAW_BSON_OPTIONS`.\n\n .. versionchanged:: 3.8\n :class:`RawBSONDocument` now validates that the ``bson_bytes``\n passed in represent a single bson document.\n\n .. versionchanged:: 3.5\n If a :class:`~bson.codec_options.CodecOptions` is passed in, its\n `document_class` must be :class:`RawBSONDocument`.\n \"\"\"\n self.__raw = bson_bytes\n self.__inflated_doc = None\n # Can't default codec_options to DEFAULT_RAW_BSON_OPTIONS in signature,\n # it refers to this class RawBSONDocument.\n if codec_options is None:\n codec_options = DEFAULT_RAW_BSON_OPTIONS\n elif codec_options.document_class is not RawBSONDocument:\n raise TypeError(\n \"RawBSONDocument cannot use CodecOptions with document \"\n \"class %s\" % (codec_options.document_class, ))\n self.__codec_options = codec_options\n # Validate the bson object size.\n _get_object_size(bson_bytes, 0, len(bson_bytes))\n\n @property\n def raw(self):\n \"\"\"The raw BSON bytes composing this document.\"\"\"\n return self.__raw\n\n def items(self):\n \"\"\"Lazily decode and iterate elements in this document.\"\"\"\n return iteritems(self.__inflated)\n\n @property\n def __inflated(self):\n if self.__inflated_doc is None:\n # We already validated the object's size when this document was\n # created, so no need to do that again.\n # Use SON to preserve ordering of elements.\n self.__inflated_doc = _inflate_bson(\n self.__raw, self.__codec_options)\n return self.__inflated_doc\n\n def __getitem__(self, item):\n return self.__inflated[item]\n\n def __iter__(self):\n return iter(self.__inflated)\n\n def __len__(self):\n return len(self.__inflated)\n\n def __eq__(self, other):\n if isinstance(other, RawBSONDocument):\n return self.__raw == other.raw\n return NotImplemented\n\n def __repr__(self):\n return (\"RawBSONDocument(%r, codec_options=%r)\"\n % (self.raw, self.__codec_options))\n\n\ndef _inflate_bson(bson_bytes, codec_options):\n \"\"\"Inflates the top level fields of a BSON document.\n\n :Parameters:\n - `bson_bytes`: the BSON bytes that compose this document\n - `codec_options`: An instance of\n :class:`~bson.codec_options.CodecOptions` whose ``document_class``\n must be :class:`RawBSONDocument`.\n \"\"\"\n # Use SON to preserve ordering of elements.\n return _raw_to_dict(\n bson_bytes, 4, len(bson_bytes)-1, codec_options, SON())\n\n\nDEFAULT_RAW_BSON_OPTIONS = DEFAULT.with_options(document_class=RawBSONDocument)\n\"\"\"The default :class:`~bson.codec_options.CodecOptions` for\n:class:`RawBSONDocument`.\n\"\"\"\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/bson/regex.py",
"content": "# Copyright 2013-present MongoDB, Inc.\n#\n# Licensed under the Apache License, Version 2.0 (the \"License\");\n# you may not use this file except in compliance with the License.\n# You may obtain a copy of the License at\n#\n# http://www.apache.org/licenses/LICENSE-2.0\n#\n# Unless required by applicable law or agreed to in writing, software\n# distributed under the License is distributed on an \"AS IS\" BASIS,\n# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n# See the License for the specific language governing permissions and\n# limitations under the License.\n\n\"\"\"Tools for representing MongoDB regular expressions.\n\"\"\"\n\nimport re\n\nfrom bson.son import RE_TYPE\nfrom bson.py3compat import string_type, text_type\n\n\ndef str_flags_to_int(str_flags):\n flags = 0\n if \"i\" in str_flags:\n flags |= re.IGNORECASE\n if \"l\" in str_flags:\n flags |= re.LOCALE\n if \"m\" in str_flags:\n flags |= re.MULTILINE\n if \"s\" in str_flags:\n flags |= re.DOTALL\n if \"u\" in str_flags:\n flags |= re.UNICODE\n if \"x\" in str_flags:\n flags |= re.VERBOSE\n\n return flags\n\n\nclass Regex(object):\n \"\"\"BSON regular expression data.\"\"\"\n _type_marker = 11\n\n @classmethod\n def from_native(cls, regex):\n \"\"\"Convert a Python regular expression into a ``Regex`` instance.\n\n Note that in Python 3, a regular expression compiled from a\n :class:`str` has the ``re.UNICODE`` flag set. If it is undesirable\n to store this flag in a BSON regular expression, unset it first::\n\n >>> pattern = re.compile('.*')\n >>> regex = Regex.from_native(pattern)\n >>> regex.flags ^= re.UNICODE\n >>> db.collection.insert({'pattern': regex})\n\n :Parameters:\n - `regex`: A regular expression object from ``re.compile()``.\n\n .. warning::\n Python regular expressions use a different syntax and different\n set of flags than MongoDB, which uses `PCRE`_. A regular\n expression retrieved from the server may not compile in\n Python, or may match a different set of strings in Python than\n when used in a MongoDB query.\n\n .. _PCRE: http://www.pcre.org/\n \"\"\"\n if not isinstance(regex, RE_TYPE):\n raise TypeError(\n \"regex must be a compiled regular expression, not %s\"\n % type(regex))\n\n return Regex(regex.pattern, regex.flags)\n\n def __init__(self, pattern, flags=0):\n \"\"\"BSON regular expression data.\n\n This class is useful to store and retrieve regular expressions that are\n incompatible with Python's regular expression dialect.\n\n :Parameters:\n - `pattern`: string\n - `flags`: (optional) an integer bitmask, or a string of flag\n characters like \"im\" for IGNORECASE and MULTILINE\n \"\"\"\n if not isinstance(pattern, (text_type, bytes)):\n raise TypeError(\"pattern must be a string, not %s\" % type(pattern))\n self.pattern = pattern\n\n if isinstance(flags, string_type):\n self.flags = str_flags_to_int(flags)\n elif isinstance(flags, int):\n self.flags = flags\n else:\n raise TypeError(\n \"flags must be a string or int, not %s\" % type(flags))\n\n def __eq__(self, other):\n if isinstance(other, Regex):\n return self.pattern == other.pattern and self.flags == other.flags\n else:\n return NotImplemented\n\n __hash__ = None\n\n def __ne__(self, other):\n return not self == other\n\n def __repr__(self):\n return \"Regex(%r, %r)\" % (self.pattern, self.flags)\n\n def try_compile(self):\n \"\"\"Compile this :class:`Regex` as a Python regular expression.\n\n .. warning::\n Python regular expressions use a different syntax and different\n set of flags than MongoDB, which uses `PCRE`_. A regular\n expression retrieved from the server may not compile in\n Python, or may match a different set of strings in Python than\n when used in a MongoDB query. :meth:`try_compile()` may raise\n :exc:`re.error`.\n\n .. _PCRE: http://www.pcre.org/\n \"\"\"\n return re.compile(self.pattern, self.flags)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/bson/son.py",
"content": "# Copyright 2009-present MongoDB, Inc.\n#\n# Licensed under the Apache License, Version 2.0 (the \"License\");\n# you may not use this file except in compliance with the License.\n# You may obtain a copy of the License at\n#\n# http://www.apache.org/licenses/LICENSE-2.0\n#\n# Unless required by applicable law or agreed to in writing, software\n# distributed under the License is distributed on an \"AS IS\" BASIS,\n# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n# See the License for the specific language governing permissions and\n# limitations under the License.\n\n\"\"\"Tools for creating and manipulating SON, the Serialized Ocument Notation.\n\nRegular dictionaries can be used instead of SON objects, but not when the order\nof keys is important. A SON object can be used just like a normal Python\ndictionary.\"\"\"\n\nimport copy\nimport re\n\nfrom bson.py3compat import abc, iteritems\n\n\n# This sort of sucks, but seems to be as good as it gets...\n# This is essentially the same as re._pattern_type\nRE_TYPE = type(re.compile(\"\"))\n\n\nclass SON(dict):\n \"\"\"SON data.\n\n A subclass of dict that maintains ordering of keys and provides a\n few extra niceties for dealing with SON. SON provides an API\n similar to collections.OrderedDict from Python 2.7+.\n \"\"\"\n\n def __init__(self, data=None, **kwargs):\n self.__keys = []\n dict.__init__(self)\n self.update(data)\n self.update(kwargs)\n\n def __new__(cls, *args, **kwargs):\n instance = super(SON, cls).__new__(cls, *args, **kwargs)\n instance.__keys = []\n return instance\n\n def __repr__(self):\n result = []\n for key in self.__keys:\n result.append(\"(%r, %r)\" % (key, self[key]))\n return \"SON([%s])\" % \", \".join(result)\n\n def __setitem__(self, key, value):\n if key not in self.__keys:\n self.__keys.append(key)\n dict.__setitem__(self, key, value)\n\n def __delitem__(self, key):\n self.__keys.remove(key)\n dict.__delitem__(self, key)\n\n def keys(self):\n return list(self.__keys)\n\n def copy(self):\n other = SON()\n other.update(self)\n return other\n\n # TODO this is all from UserDict.DictMixin. it could probably be made more\n # efficient.\n # second level definitions support higher levels\n def __iter__(self):\n for k in self.__keys:\n yield k\n\n def has_key(self, key):\n return key in self.__keys\n\n # third level takes advantage of second level definitions\n def iteritems(self):\n for k in self:\n yield (k, self[k])\n\n def iterkeys(self):\n return self.__iter__()\n\n # fourth level uses definitions from lower levels\n def itervalues(self):\n for _, v in self.iteritems():\n yield v\n\n def values(self):\n return [v for _, v in self.iteritems()]\n\n def items(self):\n return [(key, self[key]) for key in self]\n\n def clear(self):\n self.__keys = []\n super(SON, self).clear()\n\n def setdefault(self, key, default=None):\n try:\n return self[key]\n except KeyError:\n self[key] = default\n return default\n\n def pop(self, key, *args):\n if len(args) > 1:\n raise TypeError(\"pop expected at most 2 arguments, got \"\\\n + repr(1 + len(args)))\n try:\n value = self[key]\n except KeyError:\n if args:\n return args[0]\n raise\n del self[key]\n return value\n\n def popitem(self):\n try:\n k, v = next(self.iteritems())\n except StopIteration:\n raise KeyError('container is empty')\n del self[k]\n return (k, v)\n\n def update(self, other=None, **kwargs):\n # Make progressively weaker assumptions about \"other\"\n if other is None:\n pass\n elif hasattr(other, 'iteritems'): # iteritems saves memory and lookups\n for k, v in other.iteritems():\n self[k] = v\n elif hasattr(other, 'keys'):\n for k in other.keys():\n self[k] = other[k]\n else:\n for k, v in other:\n self[k] = v\n if kwargs:\n self.update(kwargs)\n\n def get(self, key, default=None):\n try:\n return self[key]\n except KeyError:\n return default\n\n def __eq__(self, other):\n \"\"\"Comparison to another SON is order-sensitive while comparison to a\n regular dictionary is order-insensitive.\n \"\"\"\n if isinstance(other, SON):\n return len(self) == len(other) and self.items() == other.items()\n return self.to_dict() == other\n\n def __ne__(self, other):\n return not self == other\n\n def __len__(self):\n return len(self.__keys)\n\n def to_dict(self):\n \"\"\"Convert a SON document to a normal Python dictionary instance.\n\n This is trickier than just *dict(...)* because it needs to be\n recursive.\n \"\"\"\n\n def transform_value(value):\n if isinstance(value, list):\n return [transform_value(v) for v in value]\n elif isinstance(value, abc.Mapping):\n return dict([\n (k, transform_value(v))\n for k, v in iteritems(value)])\n else:\n return value\n\n return transform_value(dict(self))\n\n def __deepcopy__(self, memo):\n out = SON()\n val_id = id(self)\n if val_id in memo:\n return memo.get(val_id)\n memo[val_id] = out\n for k, v in self.iteritems():\n if not isinstance(v, RE_TYPE):\n v = copy.deepcopy(v, memo)\n out[k] = v\n return out\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/bson/timestamp.py",
"content": "# Copyright 2010-2015 MongoDB, Inc.\n#\n# Licensed under the Apache License, Version 2.0 (the \"License\");\n# you may not use this file except in compliance with the License.\n# You may obtain a copy of the License at\n#\n# http://www.apache.org/licenses/LICENSE-2.0\n#\n# Unless required by applicable law or agreed to in writing, software\n# distributed under the License is distributed on an \"AS IS\" BASIS,\n# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n# See the License for the specific language governing permissions and\n# limitations under the License.\n\n\"\"\"Tools for representing MongoDB internal Timestamps.\n\"\"\"\n\nimport calendar\nimport datetime\n\nfrom bson.py3compat import integer_types\nfrom bson.tz_util import utc\n\nUPPERBOUND = 4294967296\n\n\nclass Timestamp(object):\n \"\"\"MongoDB internal timestamps used in the opLog.\n \"\"\"\n\n _type_marker = 17\n\n def __init__(self, time, inc):\n \"\"\"Create a new :class:`Timestamp`.\n\n This class is only for use with the MongoDB opLog. If you need\n to store a regular timestamp, please use a\n :class:`~datetime.datetime`.\n\n Raises :class:`TypeError` if `time` is not an instance of\n :class: `int` or :class:`~datetime.datetime`, or `inc` is not\n an instance of :class:`int`. Raises :class:`ValueError` if\n `time` or `inc` is not in [0, 2**32).\n\n :Parameters:\n - `time`: time in seconds since epoch UTC, or a naive UTC\n :class:`~datetime.datetime`, or an aware\n :class:`~datetime.datetime`\n - `inc`: the incrementing counter\n \"\"\"\n if isinstance(time, datetime.datetime):\n if time.utcoffset() is not None:\n time = time - time.utcoffset()\n time = int(calendar.timegm(time.timetuple()))\n if not isinstance(time, integer_types):\n raise TypeError(\"time must be an instance of int\")\n if not isinstance(inc, integer_types):\n raise TypeError(\"inc must be an instance of int\")\n if not 0 <= time < UPPERBOUND:\n raise ValueError(\"time must be contained in [0, 2**32)\")\n if not 0 <= inc < UPPERBOUND:\n raise ValueError(\"inc must be contained in [0, 2**32)\")\n\n self.__time = time\n self.__inc = inc\n\n @property\n def time(self):\n \"\"\"Get the time portion of this :class:`Timestamp`.\n \"\"\"\n return self.__time\n\n @property\n def inc(self):\n \"\"\"Get the inc portion of this :class:`Timestamp`.\n \"\"\"\n return self.__inc\n\n def __eq__(self, other):\n if isinstance(other, Timestamp):\n return (self.__time == other.time and self.__inc == other.inc)\n else:\n return NotImplemented\n\n def __hash__(self):\n return hash(self.time) ^ hash(self.inc)\n\n def __ne__(self, other):\n return not self == other\n\n def __lt__(self, other):\n if isinstance(other, Timestamp):\n return (self.time, self.inc) < (other.time, other.inc)\n return NotImplemented\n\n def __le__(self, other):\n if isinstance(other, Timestamp):\n return (self.time, self.inc) <= (other.time, other.inc)\n return NotImplemented\n\n def __gt__(self, other):\n if isinstance(other, Timestamp):\n return (self.time, self.inc) > (other.time, other.inc)\n return NotImplemented\n\n def __ge__(self, other):\n if isinstance(other, Timestamp):\n return (self.time, self.inc) >= (other.time, other.inc)\n return NotImplemented\n\n def __repr__(self):\n return \"Timestamp(%s, %s)\" % (self.__time, self.__inc)\n\n def as_datetime(self):\n \"\"\"Return a :class:`~datetime.datetime` instance corresponding\n to the time portion of this :class:`Timestamp`.\n\n The returned datetime's timezone is UTC.\n \"\"\"\n return datetime.datetime.fromtimestamp(self.__time, utc)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/bson/tz_util.py",
"content": "# Copyright 2010-2015 MongoDB, Inc.\n#\n# Licensed under the Apache License, Version 2.0 (the \"License\");\n# you may not use this file except in compliance with the License.\n# You may obtain a copy of the License at\n#\n# http://www.apache.org/licenses/LICENSE-2.0\n#\n# Unless required by applicable law or agreed to in writing, software\n# distributed under the License is distributed on an \"AS IS\" BASIS,\n# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n# See the License for the specific language governing permissions and\n# limitations under the License.\n\n\"\"\"Timezone related utilities for BSON.\"\"\"\n\nfrom datetime import (timedelta,\n tzinfo)\n\nZERO = timedelta(0)\n\n\nclass FixedOffset(tzinfo):\n \"\"\"Fixed offset timezone, in minutes east from UTC.\n\n Implementation based from the Python `standard library documentation\n `_.\n Defining __getinitargs__ enables pickling / copying.\n \"\"\"\n\n def __init__(self, offset, name):\n if isinstance(offset, timedelta):\n self.__offset = offset\n else:\n self.__offset = timedelta(minutes=offset)\n self.__name = name\n\n def __getinitargs__(self):\n return self.__offset, self.__name\n\n def utcoffset(self, dt):\n return self.__offset\n\n def tzname(self, dt):\n return self.__name\n\n def dst(self, dt):\n return ZERO\n\n\nutc = FixedOffset(0, \"UTC\")\n\"\"\"Fixed offset timezone representing UTC.\"\"\"\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cffi/__init__.py",
"content": "__all__ = ['FFI', 'VerificationError', 'VerificationMissing', 'CDefError',\n 'FFIError']\n\nfrom .api import FFI\nfrom .error import CDefError, FFIError, VerificationError, VerificationMissing\nfrom .error import PkgConfigError\n\n__version__ = \"1.13.1\"\n__version_info__ = (1, 13, 1)\n\n# The verifier module file names are based on the CRC32 of a string that\n# contains the following version number. It may be older than __version__\n# if nothing is clearly incompatible.\n__version_verifier_modules__ = \"0.8.6\"\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cffi/_cffi_errors.h",
"content": "#ifndef CFFI_MESSAGEBOX\n# ifdef _MSC_VER\n# define CFFI_MESSAGEBOX 1\n# else\n# define CFFI_MESSAGEBOX 0\n# endif\n#endif\n\n\n#if CFFI_MESSAGEBOX\n/* Windows only: logic to take the Python-CFFI embedding logic\n initialization errors and display them in a background thread\n with MessageBox. The idea is that if the whole program closes\n as a result of this problem, then likely it is already a console\n program and you can read the stderr output in the console too.\n If it is not a console program, then it will likely show its own\n dialog to complain, or generally not abruptly close, and for this\n case the background thread should stay alive.\n*/\nstatic void *volatile _cffi_bootstrap_text;\n\nstatic PyObject *_cffi_start_error_capture(void)\n{\n PyObject *result = NULL;\n PyObject *x, *m, *bi;\n\n if (InterlockedCompareExchangePointer(&_cffi_bootstrap_text,\n (void *)1, NULL) != NULL)\n return (PyObject *)1;\n\n m = PyImport_AddModule(\"_cffi_error_capture\");\n if (m == NULL)\n goto error;\n\n result = PyModule_GetDict(m);\n if (result == NULL)\n goto error;\n\n#if PY_MAJOR_VERSION >= 3\n bi = PyImport_ImportModule(\"builtins\");\n#else\n bi = PyImport_ImportModule(\"__builtin__\");\n#endif\n if (bi == NULL)\n goto error;\n PyDict_SetItemString(result, \"__builtins__\", bi);\n Py_DECREF(bi);\n\n x = PyRun_String(\n \"import sys\\n\"\n \"class FileLike:\\n\"\n \" def write(self, x):\\n\"\n \" try:\\n\"\n \" of.write(x)\\n\"\n \" except: pass\\n\"\n \" self.buf += x\\n\"\n \"fl = FileLike()\\n\"\n \"fl.buf = ''\\n\"\n \"of = sys.stderr\\n\"\n \"sys.stderr = fl\\n\"\n \"def done():\\n\"\n \" sys.stderr = of\\n\"\n \" return fl.buf\\n\", /* make sure the returned value stays alive */\n Py_file_input,\n result, result);\n Py_XDECREF(x);\n\n error:\n if (PyErr_Occurred())\n {\n PyErr_WriteUnraisable(Py_None);\n PyErr_Clear();\n }\n return result;\n}\n\n#pragma comment(lib, \"user32.lib\")\n\nstatic DWORD WINAPI _cffi_bootstrap_dialog(LPVOID ignored)\n{\n Sleep(666); /* may be interrupted if the whole process is closing */\n#if PY_MAJOR_VERSION >= 3\n MessageBoxW(NULL, (wchar_t *)_cffi_bootstrap_text,\n L\"Python-CFFI error\",\n MB_OK | MB_ICONERROR);\n#else\n MessageBoxA(NULL, (char *)_cffi_bootstrap_text,\n \"Python-CFFI error\",\n MB_OK | MB_ICONERROR);\n#endif\n _cffi_bootstrap_text = NULL;\n return 0;\n}\n\nstatic void _cffi_stop_error_capture(PyObject *ecap)\n{\n PyObject *s;\n void *text;\n\n if (ecap == (PyObject *)1)\n return;\n\n if (ecap == NULL)\n goto error;\n\n s = PyRun_String(\"done()\", Py_eval_input, ecap, ecap);\n if (s == NULL)\n goto error;\n\n /* Show a dialog box, but in a background thread, and\n never show multiple dialog boxes at once. */\n#if PY_MAJOR_VERSION >= 3\n text = PyUnicode_AsWideCharString(s, NULL);\n#else\n text = PyString_AsString(s);\n#endif\n\n _cffi_bootstrap_text = text;\n\n if (text != NULL)\n {\n HANDLE h;\n h = CreateThread(NULL, 0, _cffi_bootstrap_dialog,\n NULL, 0, NULL);\n if (h != NULL)\n CloseHandle(h);\n }\n /* decref the string, but it should stay alive as 'fl.buf'\n in the small module above. It will really be freed only if\n we later get another similar error. So it's a leak of at\n most one copy of the small module. That's fine for this\n situation which is usually a \"fatal error\" anyway. */\n Py_DECREF(s);\n PyErr_Clear();\n return;\n\n error:\n _cffi_bootstrap_text = NULL;\n PyErr_Clear();\n}\n\n#else\n\nstatic PyObject *_cffi_start_error_capture(void) { return NULL; }\nstatic void _cffi_stop_error_capture(PyObject *ecap) { }\n\n#endif\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cffi/_cffi_include.h",
"content": "#define _CFFI_\n\n/* We try to define Py_LIMITED_API before including Python.h.\n\n Mess: we can only define it if Py_DEBUG, Py_TRACE_REFS and\n Py_REF_DEBUG are not defined. This is a best-effort approximation:\n we can learn about Py_DEBUG from pyconfig.h, but it is unclear if\n the same works for the other two macros. Py_DEBUG implies them,\n but not the other way around.\n\n Issue #350 is still open: on Windows, the code here causes it to link\n with PYTHON36.DLL (for example) instead of PYTHON3.DLL. A fix was\n attempted in 164e526a5515 and 14ce6985e1c3, but reverted: virtualenv\n does not make PYTHON3.DLL available, and so the \"correctly\" compiled\n version would not run inside a virtualenv. We will re-apply the fix\n after virtualenv has been fixed for some time. For explanation, see\n issue #355. For a workaround if you want PYTHON3.DLL and don't worry\n about virtualenv, see issue #350. See also 'py_limited_api' in\n setuptools_ext.py.\n*/\n#if !defined(_CFFI_USE_EMBEDDING) && !defined(Py_LIMITED_API)\n# include \n# if !defined(Py_DEBUG) && !defined(Py_TRACE_REFS) && !defined(Py_REF_DEBUG)\n# define Py_LIMITED_API\n# endif\n#endif\n\n#include \n#ifdef __cplusplus\nextern \"C\" {\n#endif\n#include \n#include \"parse_c_type.h\"\n\n/* this block of #ifs should be kept exactly identical between\n c/_cffi_backend.c, cffi/vengine_cpy.py, cffi/vengine_gen.py\n and cffi/_cffi_include.h */\n#if defined(_MSC_VER)\n# include /* for alloca() */\n# if _MSC_VER < 1600 /* MSVC < 2010 */\n typedef __int8 int8_t;\n typedef __int16 int16_t;\n typedef __int32 int32_t;\n typedef __int64 int64_t;\n typedef unsigned __int8 uint8_t;\n typedef unsigned __int16 uint16_t;\n typedef unsigned __int32 uint32_t;\n typedef unsigned __int64 uint64_t;\n typedef __int8 int_least8_t;\n typedef __int16 int_least16_t;\n typedef __int32 int_least32_t;\n typedef __int64 int_least64_t;\n typedef unsigned __int8 uint_least8_t;\n typedef unsigned __int16 uint_least16_t;\n typedef unsigned __int32 uint_least32_t;\n typedef unsigned __int64 uint_least64_t;\n typedef __int8 int_fast8_t;\n typedef __int16 int_fast16_t;\n typedef __int32 int_fast32_t;\n typedef __int64 int_fast64_t;\n typedef unsigned __int8 uint_fast8_t;\n typedef unsigned __int16 uint_fast16_t;\n typedef unsigned __int32 uint_fast32_t;\n typedef unsigned __int64 uint_fast64_t;\n typedef __int64 intmax_t;\n typedef unsigned __int64 uintmax_t;\n# else\n# include \n# endif\n# if _MSC_VER < 1800 /* MSVC < 2013 */\n# ifndef __cplusplus\n typedef unsigned char _Bool;\n# endif\n# endif\n#else\n# include \n# if (defined (__SVR4) && defined (__sun)) || defined(_AIX) || defined(__hpux)\n# include \n# endif\n#endif\n\n#ifdef __GNUC__\n# define _CFFI_UNUSED_FN __attribute__((unused))\n#else\n# define _CFFI_UNUSED_FN /* nothing */\n#endif\n\n#ifdef __cplusplus\n# ifndef _Bool\n typedef bool _Bool; /* semi-hackish: C++ has no _Bool; bool is builtin */\n# endif\n#endif\n\n/********** CPython-specific section **********/\n#ifndef PYPY_VERSION\n\n\n#if PY_MAJOR_VERSION >= 3\n# define PyInt_FromLong PyLong_FromLong\n#endif\n\n#define _cffi_from_c_double PyFloat_FromDouble\n#define _cffi_from_c_float PyFloat_FromDouble\n#define _cffi_from_c_long PyInt_FromLong\n#define _cffi_from_c_ulong PyLong_FromUnsignedLong\n#define _cffi_from_c_longlong PyLong_FromLongLong\n#define _cffi_from_c_ulonglong PyLong_FromUnsignedLongLong\n#define _cffi_from_c__Bool PyBool_FromLong\n\n#define _cffi_to_c_double PyFloat_AsDouble\n#define _cffi_to_c_float PyFloat_AsDouble\n\n#define _cffi_from_c_int(x, type) \\\n (((type)-1) > 0 ? /* unsigned */ \\\n (sizeof(type) < sizeof(long) ? \\\n PyInt_FromLong((long)x) : \\\n sizeof(type) == sizeof(long) ? \\\n PyLong_FromUnsignedLong((unsigned long)x) : \\\n PyLong_FromUnsignedLongLong((unsigned long long)x)) : \\\n (sizeof(type) <= sizeof(long) ? \\\n PyInt_FromLong((long)x) : \\\n PyLong_FromLongLong((long long)x)))\n\n#define _cffi_to_c_int(o, type) \\\n ((type)( \\\n sizeof(type) == 1 ? (((type)-1) > 0 ? (type)_cffi_to_c_u8(o) \\\n : (type)_cffi_to_c_i8(o)) : \\\n sizeof(type) == 2 ? (((type)-1) > 0 ? (type)_cffi_to_c_u16(o) \\\n : (type)_cffi_to_c_i16(o)) : \\\n sizeof(type) == 4 ? (((type)-1) > 0 ? (type)_cffi_to_c_u32(o) \\\n : (type)_cffi_to_c_i32(o)) : \\\n sizeof(type) == 8 ? (((type)-1) > 0 ? (type)_cffi_to_c_u64(o) \\\n : (type)_cffi_to_c_i64(o)) : \\\n (Py_FatalError(\"unsupported size for type \" #type), (type)0)))\n\n#define _cffi_to_c_i8 \\\n ((int(*)(PyObject *))_cffi_exports[1])\n#define _cffi_to_c_u8 \\\n ((int(*)(PyObject *))_cffi_exports[2])\n#define _cffi_to_c_i16 \\\n ((int(*)(PyObject *))_cffi_exports[3])\n#define _cffi_to_c_u16 \\\n ((int(*)(PyObject *))_cffi_exports[4])\n#define _cffi_to_c_i32 \\\n ((int(*)(PyObject *))_cffi_exports[5])\n#define _cffi_to_c_u32 \\\n ((unsigned int(*)(PyObject *))_cffi_exports[6])\n#define _cffi_to_c_i64 \\\n ((long long(*)(PyObject *))_cffi_exports[7])\n#define _cffi_to_c_u64 \\\n ((unsigned long long(*)(PyObject *))_cffi_exports[8])\n#define _cffi_to_c_char \\\n ((int(*)(PyObject *))_cffi_exports[9])\n#define _cffi_from_c_pointer \\\n ((PyObject *(*)(char *, struct _cffi_ctypedescr *))_cffi_exports[10])\n#define _cffi_to_c_pointer \\\n ((char *(*)(PyObject *, struct _cffi_ctypedescr *))_cffi_exports[11])\n#define _cffi_get_struct_layout \\\n not used any more\n#define _cffi_restore_errno \\\n ((void(*)(void))_cffi_exports[13])\n#define _cffi_save_errno \\\n ((void(*)(void))_cffi_exports[14])\n#define _cffi_from_c_char \\\n ((PyObject *(*)(char))_cffi_exports[15])\n#define _cffi_from_c_deref \\\n ((PyObject *(*)(char *, struct _cffi_ctypedescr *))_cffi_exports[16])\n#define _cffi_to_c \\\n ((int(*)(char *, struct _cffi_ctypedescr *, PyObject *))_cffi_exports[17])\n#define _cffi_from_c_struct \\\n ((PyObject *(*)(char *, struct _cffi_ctypedescr *))_cffi_exports[18])\n#define _cffi_to_c_wchar_t \\\n ((_cffi_wchar_t(*)(PyObject *))_cffi_exports[19])\n#define _cffi_from_c_wchar_t \\\n ((PyObject *(*)(_cffi_wchar_t))_cffi_exports[20])\n#define _cffi_to_c_long_double \\\n ((long double(*)(PyObject *))_cffi_exports[21])\n#define _cffi_to_c__Bool \\\n ((_Bool(*)(PyObject *))_cffi_exports[22])\n#define _cffi_prepare_pointer_call_argument \\\n ((Py_ssize_t(*)(struct _cffi_ctypedescr *, \\\n PyObject *, char **))_cffi_exports[23])\n#define _cffi_convert_array_from_object \\\n ((int(*)(char *, struct _cffi_ctypedescr *, PyObject *))_cffi_exports[24])\n#define _CFFI_CPIDX 25\n#define _cffi_call_python \\\n ((void(*)(struct _cffi_externpy_s *, char *))_cffi_exports[_CFFI_CPIDX])\n#define _cffi_to_c_wchar3216_t \\\n ((int(*)(PyObject *))_cffi_exports[26])\n#define _cffi_from_c_wchar3216_t \\\n ((PyObject *(*)(int))_cffi_exports[27])\n#define _CFFI_NUM_EXPORTS 28\n\nstruct _cffi_ctypedescr;\n\nstatic void *_cffi_exports[_CFFI_NUM_EXPORTS];\n\n#define _cffi_type(index) ( \\\n assert((((uintptr_t)_cffi_types[index]) & 1) == 0), \\\n (struct _cffi_ctypedescr *)_cffi_types[index])\n\nstatic PyObject *_cffi_init(const char *module_name, Py_ssize_t version,\n const struct _cffi_type_context_s *ctx)\n{\n PyObject *module, *o_arg, *new_module;\n void *raw[] = {\n (void *)module_name,\n (void *)version,\n (void *)_cffi_exports,\n (void *)ctx,\n };\n\n module = PyImport_ImportModule(\"_cffi_backend\");\n if (module == NULL)\n goto failure;\n\n o_arg = PyLong_FromVoidPtr((void *)raw);\n if (o_arg == NULL)\n goto failure;\n\n new_module = PyObject_CallMethod(\n module, (char *)\"_init_cffi_1_0_external_module\", (char *)\"O\", o_arg);\n\n Py_DECREF(o_arg);\n Py_DECREF(module);\n return new_module;\n\n failure:\n Py_XDECREF(module);\n return NULL;\n}\n\n\n#ifdef HAVE_WCHAR_H\ntypedef wchar_t _cffi_wchar_t;\n#else\ntypedef uint16_t _cffi_wchar_t; /* same random pick as _cffi_backend.c */\n#endif\n\n_CFFI_UNUSED_FN static uint16_t _cffi_to_c_char16_t(PyObject *o)\n{\n if (sizeof(_cffi_wchar_t) == 2)\n return (uint16_t)_cffi_to_c_wchar_t(o);\n else\n return (uint16_t)_cffi_to_c_wchar3216_t(o);\n}\n\n_CFFI_UNUSED_FN static PyObject *_cffi_from_c_char16_t(uint16_t x)\n{\n if (sizeof(_cffi_wchar_t) == 2)\n return _cffi_from_c_wchar_t((_cffi_wchar_t)x);\n else\n return _cffi_from_c_wchar3216_t((int)x);\n}\n\n_CFFI_UNUSED_FN static int _cffi_to_c_char32_t(PyObject *o)\n{\n if (sizeof(_cffi_wchar_t) == 4)\n return (int)_cffi_to_c_wchar_t(o);\n else\n return (int)_cffi_to_c_wchar3216_t(o);\n}\n\n_CFFI_UNUSED_FN static PyObject *_cffi_from_c_char32_t(int x)\n{\n if (sizeof(_cffi_wchar_t) == 4)\n return _cffi_from_c_wchar_t((_cffi_wchar_t)x);\n else\n return _cffi_from_c_wchar3216_t(x);\n}\n\n\n/********** end CPython-specific section **********/\n#else\n_CFFI_UNUSED_FN\nstatic void (*_cffi_call_python_org)(struct _cffi_externpy_s *, char *);\n# define _cffi_call_python _cffi_call_python_org\n#endif\n\n\n#define _cffi_array_len(array) (sizeof(array) / sizeof((array)[0]))\n\n#define _cffi_prim_int(size, sign) \\\n ((size) == 1 ? ((sign) ? _CFFI_PRIM_INT8 : _CFFI_PRIM_UINT8) : \\\n (size) == 2 ? ((sign) ? _CFFI_PRIM_INT16 : _CFFI_PRIM_UINT16) : \\\n (size) == 4 ? ((sign) ? _CFFI_PRIM_INT32 : _CFFI_PRIM_UINT32) : \\\n (size) == 8 ? ((sign) ? _CFFI_PRIM_INT64 : _CFFI_PRIM_UINT64) : \\\n _CFFI__UNKNOWN_PRIM)\n\n#define _cffi_prim_float(size) \\\n ((size) == sizeof(float) ? _CFFI_PRIM_FLOAT : \\\n (size) == sizeof(double) ? _CFFI_PRIM_DOUBLE : \\\n (size) == sizeof(long double) ? _CFFI__UNKNOWN_LONG_DOUBLE : \\\n _CFFI__UNKNOWN_FLOAT_PRIM)\n\n#define _cffi_check_int(got, got_nonpos, expected) \\\n ((got_nonpos) == (expected <= 0) && \\\n (got) == (unsigned long long)expected)\n\n#ifdef MS_WIN32\n# define _cffi_stdcall __stdcall\n#else\n# define _cffi_stdcall /* nothing */\n#endif\n\n#ifdef __cplusplus\n}\n#endif\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cffi/_embedding.h",
"content": "\n/***** Support code for embedding *****/\n\n#ifdef __cplusplus\nextern \"C\" {\n#endif\n\n\n#if defined(_WIN32)\n# define CFFI_DLLEXPORT __declspec(dllexport)\n#elif defined(__GNUC__)\n# define CFFI_DLLEXPORT __attribute__((visibility(\"default\")))\n#else\n# define CFFI_DLLEXPORT /* nothing */\n#endif\n\n\n/* There are two global variables of type _cffi_call_python_fnptr:\n\n * _cffi_call_python, which we declare just below, is the one called\n by ``extern \"Python\"`` implementations.\n\n * _cffi_call_python_org, which on CPython is actually part of the\n _cffi_exports[] array, is the function pointer copied from\n _cffi_backend.\n\n After initialization is complete, both are equal. However, the\n first one remains equal to &_cffi_start_and_call_python until the\n very end of initialization, when we are (or should be) sure that\n concurrent threads also see a completely initialized world, and\n only then is it changed.\n*/\n#undef _cffi_call_python\ntypedef void (*_cffi_call_python_fnptr)(struct _cffi_externpy_s *, char *);\nstatic void _cffi_start_and_call_python(struct _cffi_externpy_s *, char *);\nstatic _cffi_call_python_fnptr _cffi_call_python = &_cffi_start_and_call_python;\n\n\n#ifndef _MSC_VER\n /* --- Assuming a GCC not infinitely old --- */\n# define cffi_compare_and_swap(l,o,n) __sync_bool_compare_and_swap(l,o,n)\n# define cffi_write_barrier() __sync_synchronize()\n# if !defined(__amd64__) && !defined(__x86_64__) && \\\n !defined(__i386__) && !defined(__i386)\n# define cffi_read_barrier() __sync_synchronize()\n# else\n# define cffi_read_barrier() (void)0\n# endif\n#else\n /* --- Windows threads version --- */\n# include \n# define cffi_compare_and_swap(l,o,n) \\\n (InterlockedCompareExchangePointer(l,n,o) == (o))\n# define cffi_write_barrier() InterlockedCompareExchange(&_cffi_dummy,0,0)\n# define cffi_read_barrier() (void)0\nstatic volatile LONG _cffi_dummy;\n#endif\n\n#ifdef WITH_THREAD\n# ifndef _MSC_VER\n# include \n static pthread_mutex_t _cffi_embed_startup_lock;\n# else\n static CRITICAL_SECTION _cffi_embed_startup_lock;\n# endif\n static char _cffi_embed_startup_lock_ready = 0;\n#endif\n\nstatic void _cffi_acquire_reentrant_mutex(void)\n{\n static void *volatile lock = NULL;\n\n while (!cffi_compare_and_swap(&lock, NULL, (void *)1)) {\n /* should ideally do a spin loop instruction here, but\n hard to do it portably and doesn't really matter I\n think: pthread_mutex_init() should be very fast, and\n this is only run at start-up anyway. */\n }\n\n#ifdef WITH_THREAD\n if (!_cffi_embed_startup_lock_ready) {\n# ifndef _MSC_VER\n pthread_mutexattr_t attr;\n pthread_mutexattr_init(&attr);\n pthread_mutexattr_settype(&attr, PTHREAD_MUTEX_RECURSIVE);\n pthread_mutex_init(&_cffi_embed_startup_lock, &attr);\n# else\n InitializeCriticalSection(&_cffi_embed_startup_lock);\n# endif\n _cffi_embed_startup_lock_ready = 1;\n }\n#endif\n\n while (!cffi_compare_and_swap(&lock, (void *)1, NULL))\n ;\n\n#ifndef _MSC_VER\n pthread_mutex_lock(&_cffi_embed_startup_lock);\n#else\n EnterCriticalSection(&_cffi_embed_startup_lock);\n#endif\n}\n\nstatic void _cffi_release_reentrant_mutex(void)\n{\n#ifndef _MSC_VER\n pthread_mutex_unlock(&_cffi_embed_startup_lock);\n#else\n LeaveCriticalSection(&_cffi_embed_startup_lock);\n#endif\n}\n\n\n/********** CPython-specific section **********/\n#ifndef PYPY_VERSION\n\n#include \"_cffi_errors.h\"\n\n\n#define _cffi_call_python_org _cffi_exports[_CFFI_CPIDX]\n\nPyMODINIT_FUNC _CFFI_PYTHON_STARTUP_FUNC(void); /* forward */\n\nstatic void _cffi_py_initialize(void)\n{\n /* XXX use initsigs=0, which \"skips initialization registration of\n signal handlers, which might be useful when Python is\n embedded\" according to the Python docs. But review and think\n if it should be a user-controllable setting.\n\n XXX we should also give a way to write errors to a buffer\n instead of to stderr.\n\n XXX if importing 'site' fails, CPython (any version) calls\n exit(). Should we try to work around this behavior here?\n */\n Py_InitializeEx(0);\n}\n\nstatic int _cffi_initialize_python(void)\n{\n /* This initializes Python, imports _cffi_backend, and then the\n present .dll/.so is set up as a CPython C extension module.\n */\n int result;\n PyGILState_STATE state;\n PyObject *pycode=NULL, *global_dict=NULL, *x;\n PyObject *builtins;\n\n state = PyGILState_Ensure();\n\n /* Call the initxxx() function from the present module. It will\n create and initialize us as a CPython extension module, instead\n of letting the startup Python code do it---it might reimport\n the same .dll/.so and get maybe confused on some platforms.\n It might also have troubles locating the .dll/.so again for all\n I know.\n */\n (void)_CFFI_PYTHON_STARTUP_FUNC();\n if (PyErr_Occurred())\n goto error;\n\n /* Now run the Python code provided to ffi.embedding_init_code().\n */\n pycode = Py_CompileString(_CFFI_PYTHON_STARTUP_CODE,\n \"\",\n Py_file_input);\n if (pycode == NULL)\n goto error;\n global_dict = PyDict_New();\n if (global_dict == NULL)\n goto error;\n builtins = PyEval_GetBuiltins();\n if (builtins == NULL)\n goto error;\n if (PyDict_SetItemString(global_dict, \"__builtins__\", builtins) < 0)\n goto error;\n x = PyEval_EvalCode(\n#if PY_MAJOR_VERSION < 3\n (PyCodeObject *)\n#endif\n pycode, global_dict, global_dict);\n if (x == NULL)\n goto error;\n Py_DECREF(x);\n\n /* Done! Now if we've been called from\n _cffi_start_and_call_python() in an ``extern \"Python\"``, we can\n only hope that the Python code did correctly set up the\n corresponding @ffi.def_extern() function. Otherwise, the\n general logic of ``extern \"Python\"`` functions (inside the\n _cffi_backend module) will find that the reference is still\n missing and print an error.\n */\n result = 0;\n done:\n Py_XDECREF(pycode);\n Py_XDECREF(global_dict);\n PyGILState_Release(state);\n return result;\n\n error:;\n {\n /* Print as much information as potentially useful.\n Debugging load-time failures with embedding is not fun\n */\n PyObject *ecap;\n PyObject *exception, *v, *tb, *f, *modules, *mod;\n PyErr_Fetch(&exception, &v, &tb);\n ecap = _cffi_start_error_capture();\n f = PySys_GetObject((char *)\"stderr\");\n if (f != NULL && f != Py_None) {\n PyFile_WriteString(\n \"Failed to initialize the Python-CFFI embedding logic:\\n\\n\", f);\n }\n\n if (exception != NULL) {\n PyErr_NormalizeException(&exception, &v, &tb);\n PyErr_Display(exception, v, tb);\n }\n Py_XDECREF(exception);\n Py_XDECREF(v);\n Py_XDECREF(tb);\n\n if (f != NULL && f != Py_None) {\n PyFile_WriteString(\"\\nFrom: \" _CFFI_MODULE_NAME\n \"\\ncompiled with cffi version: 1.13.1\"\n \"\\n_cffi_backend module: \", f);\n modules = PyImport_GetModuleDict();\n mod = PyDict_GetItemString(modules, \"_cffi_backend\");\n if (mod == NULL) {\n PyFile_WriteString(\"not loaded\", f);\n }\n else {\n v = PyObject_GetAttrString(mod, \"__file__\");\n PyFile_WriteObject(v, f, 0);\n Py_XDECREF(v);\n }\n PyFile_WriteString(\"\\nsys.path: \", f);\n PyFile_WriteObject(PySys_GetObject((char *)\"path\"), f, 0);\n PyFile_WriteString(\"\\n\\n\", f);\n }\n _cffi_stop_error_capture(ecap);\n }\n result = -1;\n goto done;\n}\n\nPyAPI_DATA(char *) _PyParser_TokenNames[]; /* from CPython */\n\nstatic int _cffi_carefully_make_gil(void)\n{\n /* This does the basic initialization of Python. It can be called\n completely concurrently from unrelated threads. It assumes\n that we don't hold the GIL before (if it exists), and we don't\n hold it afterwards.\n\n (What it really does used to be completely different in Python 2\n and Python 3, with the Python 2 solution avoiding the spin-lock\n around the Py_InitializeEx() call. However, after recent changes\n to CPython 2.7 (issue #358) it no longer works. So we use the\n Python 3 solution everywhere.)\n\n This initializes Python by calling Py_InitializeEx().\n Important: this must not be called concurrently at all.\n So we use a global variable as a simple spin lock. This global\n variable must be from 'libpythonX.Y.so', not from this\n cffi-based extension module, because it must be shared from\n different cffi-based extension modules.\n\n In Python < 3.8, we choose\n _PyParser_TokenNames[0] as a completely arbitrary pointer value\n that is never written to. The default is to point to the\n string \"ENDMARKER\". We change it temporarily to point to the\n next character in that string. (Yes, I know it's REALLY\n obscure.)\n\n In Python >= 3.8, this string array is no longer writable, so\n instead we pick PyCapsuleType.tp_version_tag. We can't change\n Python < 3.8 because someone might use a mixture of cffi\n embedded modules, some of which were compiled before this file\n changed.\n */\n\n#ifdef WITH_THREAD\n# if PY_VERSION_HEX < 0x03080000\n char *volatile *lock = (char *volatile *)_PyParser_TokenNames;\n char *old_value, *locked_value;\n\n while (1) { /* spin loop */\n old_value = *lock;\n locked_value = old_value + 1;\n if (old_value[0] == 'E') {\n assert(old_value[1] == 'N');\n if (cffi_compare_and_swap(lock, old_value, locked_value))\n break;\n }\n else {\n assert(old_value[0] == 'N');\n /* should ideally do a spin loop instruction here, but\n hard to do it portably and doesn't really matter I\n think: PyEval_InitThreads() should be very fast, and\n this is only run at start-up anyway. */\n }\n }\n# else\n int volatile *lock = (int volatile *)&PyCapsule_Type.tp_version_tag;\n int old_value, locked_value;\n assert(!(PyCapsule_Type.tp_flags & Py_TPFLAGS_HAVE_VERSION_TAG));\n\n while (1) { /* spin loop */\n old_value = *lock;\n locked_value = -42;\n if (old_value == 0) {\n if (cffi_compare_and_swap(lock, old_value, locked_value))\n break;\n }\n else {\n assert(old_value == locked_value);\n /* should ideally do a spin loop instruction here, but\n hard to do it portably and doesn't really matter I\n think: PyEval_InitThreads() should be very fast, and\n this is only run at start-up anyway. */\n }\n }\n# endif\n#endif\n\n /* call Py_InitializeEx() */\n if (!Py_IsInitialized()) {\n _cffi_py_initialize();\n PyEval_InitThreads();\n PyEval_SaveThread(); /* release the GIL */\n /* the returned tstate must be the one that has been stored into the\n autoTLSkey by _PyGILState_Init() called from Py_Initialize(). */\n }\n else {\n PyGILState_STATE state = PyGILState_Ensure();\n PyEval_InitThreads();\n PyGILState_Release(state);\n }\n\n#ifdef WITH_THREAD\n /* release the lock */\n while (!cffi_compare_and_swap(lock, locked_value, old_value))\n ;\n#endif\n\n return 0;\n}\n\n/********** end CPython-specific section **********/\n\n\n#else\n\n\n/********** PyPy-specific section **********/\n\nPyMODINIT_FUNC _CFFI_PYTHON_STARTUP_FUNC(const void *[]); /* forward */\n\nstatic struct _cffi_pypy_init_s {\n const char *name;\n void (*func)(const void *[]);\n const char *code;\n} _cffi_pypy_init = {\n _CFFI_MODULE_NAME,\n (void(*)(const void *[]))_CFFI_PYTHON_STARTUP_FUNC,\n _CFFI_PYTHON_STARTUP_CODE,\n};\n\nextern int pypy_carefully_make_gil(const char *);\nextern int pypy_init_embedded_cffi_module(int, struct _cffi_pypy_init_s *);\n\nstatic int _cffi_carefully_make_gil(void)\n{\n return pypy_carefully_make_gil(_CFFI_MODULE_NAME);\n}\n\nstatic int _cffi_initialize_python(void)\n{\n return pypy_init_embedded_cffi_module(0xB011, &_cffi_pypy_init);\n}\n\n/********** end PyPy-specific section **********/\n\n\n#endif\n\n\n#ifdef __GNUC__\n__attribute__((noinline))\n#endif\nstatic _cffi_call_python_fnptr _cffi_start_python(void)\n{\n /* Delicate logic to initialize Python. This function can be\n called multiple times concurrently, e.g. when the process calls\n its first ``extern \"Python\"`` functions in multiple threads at\n once. It can also be called recursively, in which case we must\n ignore it. We also have to consider what occurs if several\n different cffi-based extensions reach this code in parallel\n threads---it is a different copy of the code, then, and we\n can't have any shared global variable unless it comes from\n 'libpythonX.Y.so'.\n\n Idea:\n\n * _cffi_carefully_make_gil(): \"carefully\" call\n PyEval_InitThreads() (possibly with Py_InitializeEx() first).\n\n * then we use a (local) custom lock to make sure that a call to this\n cffi-based extension will wait if another call to the *same*\n extension is running the initialization in another thread.\n It is reentrant, so that a recursive call will not block, but\n only one from a different thread.\n\n * then we grab the GIL and (Python 2) we call Py_InitializeEx().\n At this point, concurrent calls to Py_InitializeEx() are not\n possible: we have the GIL.\n\n * do the rest of the specific initialization, which may\n temporarily release the GIL but not the custom lock.\n Only release the custom lock when we are done.\n */\n static char called = 0;\n\n if (_cffi_carefully_make_gil() != 0)\n return NULL;\n\n _cffi_acquire_reentrant_mutex();\n\n /* Here the GIL exists, but we don't have it. We're only protected\n from concurrency by the reentrant mutex. */\n\n /* This file only initializes the embedded module once, the first\n time this is called, even if there are subinterpreters. */\n if (!called) {\n called = 1; /* invoke _cffi_initialize_python() only once,\n but don't set '_cffi_call_python' right now,\n otherwise concurrent threads won't call\n this function at all (we need them to wait) */\n if (_cffi_initialize_python() == 0) {\n /* now initialization is finished. Switch to the fast-path. */\n\n /* We would like nobody to see the new value of\n '_cffi_call_python' without also seeing the rest of the\n data initialized. However, this is not possible. But\n the new value of '_cffi_call_python' is the function\n 'cffi_call_python()' from _cffi_backend. So: */\n cffi_write_barrier();\n /* ^^^ we put a write barrier here, and a corresponding\n read barrier at the start of cffi_call_python(). This\n ensures that after that read barrier, we see everything\n done here before the write barrier.\n */\n\n assert(_cffi_call_python_org != NULL);\n _cffi_call_python = (_cffi_call_python_fnptr)_cffi_call_python_org;\n }\n else {\n /* initialization failed. Reset this to NULL, even if it was\n already set to some other value. Future calls to\n _cffi_start_python() are still forced to occur, and will\n always return NULL from now on. */\n _cffi_call_python_org = NULL;\n }\n }\n\n _cffi_release_reentrant_mutex();\n\n return (_cffi_call_python_fnptr)_cffi_call_python_org;\n}\n\nstatic\nvoid _cffi_start_and_call_python(struct _cffi_externpy_s *externpy, char *args)\n{\n _cffi_call_python_fnptr fnptr;\n int current_err = errno;\n#ifdef _MSC_VER\n int current_lasterr = GetLastError();\n#endif\n fnptr = _cffi_start_python();\n if (fnptr == NULL) {\n fprintf(stderr, \"function %s() called, but initialization code \"\n \"failed. Returning 0.\\n\", externpy->name);\n memset(args, 0, externpy->size_of_result);\n }\n#ifdef _MSC_VER\n SetLastError(current_lasterr);\n#endif\n errno = current_err;\n\n if (fnptr != NULL)\n fnptr(externpy, args);\n}\n\n\n/* The cffi_start_python() function makes sure Python is initialized\n and our cffi module is set up. It can be called manually from the\n user C code. The same effect is obtained automatically from any\n dll-exported ``extern \"Python\"`` function. This function returns\n -1 if initialization failed, 0 if all is OK. */\n_CFFI_UNUSED_FN\nstatic int cffi_start_python(void)\n{\n if (_cffi_call_python == &_cffi_start_and_call_python) {\n if (_cffi_start_python() == NULL)\n return -1;\n }\n cffi_read_barrier();\n return 0;\n}\n\n#undef cffi_compare_and_swap\n#undef cffi_write_barrier\n#undef cffi_read_barrier\n\n#ifdef __cplusplus\n}\n#endif\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cffi/api.py",
"content": "import sys, types\nfrom .lock import allocate_lock\nfrom .error import CDefError\nfrom . import model\n\ntry:\n callable\nexcept NameError:\n # Python 3.1\n from collections import Callable\n callable = lambda x: isinstance(x, Callable)\n\ntry:\n basestring\nexcept NameError:\n # Python 3.x\n basestring = str\n\n_unspecified = object()\n\n\n\nclass FFI(object):\n r'''\n The main top-level class that you instantiate once, or once per module.\n\n Example usage:\n\n ffi = FFI()\n ffi.cdef(\"\"\"\n int printf(const char *, ...);\n \"\"\")\n\n C = ffi.dlopen(None) # standard library\n -or-\n C = ffi.verify() # use a C compiler: verify the decl above is right\n\n C.printf(\"hello, %s!\\n\", ffi.new(\"char[]\", \"world\"))\n '''\n\n def __init__(self, backend=None):\n \"\"\"Create an FFI instance. The 'backend' argument is used to\n select a non-default backend, mostly for tests.\n \"\"\"\n if backend is None:\n # You need PyPy (>= 2.0 beta), or a CPython (>= 2.6) with\n # _cffi_backend.so compiled.\n import _cffi_backend as backend\n from . import __version__\n if backend.__version__ != __version__:\n # bad version! Try to be as explicit as possible.\n if hasattr(backend, '__file__'):\n # CPython\n raise Exception(\"Version mismatch: this is the 'cffi' package version %s, located in %r. When we import the top-level '_cffi_backend' extension module, we get version %s, located in %r. The two versions should be equal; check your installation.\" % (\n __version__, __file__,\n backend.__version__, backend.__file__))\n else:\n # PyPy\n raise Exception(\"Version mismatch: this is the 'cffi' package version %s, located in %r. This interpreter comes with a built-in '_cffi_backend' module, which is version %s. The two versions should be equal; check your installation.\" % (\n __version__, __file__, backend.__version__))\n # (If you insist you can also try to pass the option\n # 'backend=backend_ctypes.CTypesBackend()', but don't\n # rely on it! It's probably not going to work well.)\n\n from . import cparser\n self._backend = backend\n self._lock = allocate_lock()\n self._parser = cparser.Parser()\n self._cached_btypes = {}\n self._parsed_types = types.ModuleType('parsed_types').__dict__\n self._new_types = types.ModuleType('new_types').__dict__\n self._function_caches = []\n self._libraries = []\n self._cdefsources = []\n self._included_ffis = []\n self._windows_unicode = None\n self._init_once_cache = {}\n self._cdef_version = None\n self._embedding = None\n self._typecache = model.get_typecache(backend)\n if hasattr(backend, 'set_ffi'):\n backend.set_ffi(self)\n for name in list(backend.__dict__):\n if name.startswith('RTLD_'):\n setattr(self, name, getattr(backend, name))\n #\n with self._lock:\n self.BVoidP = self._get_cached_btype(model.voidp_type)\n self.BCharA = self._get_cached_btype(model.char_array_type)\n if isinstance(backend, types.ModuleType):\n # _cffi_backend: attach these constants to the class\n if not hasattr(FFI, 'NULL'):\n FFI.NULL = self.cast(self.BVoidP, 0)\n FFI.CData, FFI.CType = backend._get_types()\n else:\n # ctypes backend: attach these constants to the instance\n self.NULL = self.cast(self.BVoidP, 0)\n self.CData, self.CType = backend._get_types()\n self.buffer = backend.buffer\n\n def cdef(self, csource, override=False, packed=False, pack=None):\n \"\"\"Parse the given C source. This registers all declared functions,\n types, and global variables. The functions and global variables can\n then be accessed via either 'ffi.dlopen()' or 'ffi.verify()'.\n The types can be used in 'ffi.new()' and other functions.\n If 'packed' is specified as True, all structs declared inside this\n cdef are packed, i.e. laid out without any field alignment at all.\n Alternatively, 'pack' can be a small integer, and requests for\n alignment greater than that are ignored (pack=1 is equivalent to\n packed=True).\n \"\"\"\n self._cdef(csource, override=override, packed=packed, pack=pack)\n\n def embedding_api(self, csource, packed=False, pack=None):\n self._cdef(csource, packed=packed, pack=pack, dllexport=True)\n if self._embedding is None:\n self._embedding = ''\n\n def _cdef(self, csource, override=False, **options):\n if not isinstance(csource, str): # unicode, on Python 2\n if not isinstance(csource, basestring):\n raise TypeError(\"cdef() argument must be a string\")\n csource = csource.encode('ascii')\n with self._lock:\n self._cdef_version = object()\n self._parser.parse(csource, override=override, **options)\n self._cdefsources.append(csource)\n if override:\n for cache in self._function_caches:\n cache.clear()\n finishlist = self._parser._recomplete\n if finishlist:\n self._parser._recomplete = []\n for tp in finishlist:\n tp.finish_backend_type(self, finishlist)\n\n def dlopen(self, name, flags=0):\n \"\"\"Load and return a dynamic library identified by 'name'.\n The standard C library can be loaded by passing None.\n Note that functions and types declared by 'ffi.cdef()' are not\n linked to a particular library, just like C headers; in the\n library we only look for the actual (untyped) symbols.\n \"\"\"\n assert isinstance(name, basestring) or name is None\n with self._lock:\n lib, function_cache = _make_ffi_library(self, name, flags)\n self._function_caches.append(function_cache)\n self._libraries.append(lib)\n return lib\n\n def dlclose(self, lib):\n \"\"\"Close a library obtained with ffi.dlopen(). After this call,\n access to functions or variables from the library will fail\n (possibly with a segmentation fault).\n \"\"\"\n type(lib).__cffi_close__(lib)\n\n def _typeof_locked(self, cdecl):\n # call me with the lock!\n key = cdecl\n if key in self._parsed_types:\n return self._parsed_types[key]\n #\n if not isinstance(cdecl, str): # unicode, on Python 2\n cdecl = cdecl.encode('ascii')\n #\n type = self._parser.parse_type(cdecl)\n really_a_function_type = type.is_raw_function\n if really_a_function_type:\n type = type.as_function_pointer()\n btype = self._get_cached_btype(type)\n result = btype, really_a_function_type\n self._parsed_types[key] = result\n return result\n\n def _typeof(self, cdecl, consider_function_as_funcptr=False):\n # string -> ctype object\n try:\n result = self._parsed_types[cdecl]\n except KeyError:\n with self._lock:\n result = self._typeof_locked(cdecl)\n #\n btype, really_a_function_type = result\n if really_a_function_type and not consider_function_as_funcptr:\n raise CDefError(\"the type %r is a function type, not a \"\n \"pointer-to-function type\" % (cdecl,))\n return btype\n\n def typeof(self, cdecl):\n \"\"\"Parse the C type given as a string and return the\n corresponding object.\n It can also be used on 'cdata' instance to get its C type.\n \"\"\"\n if isinstance(cdecl, basestring):\n return self._typeof(cdecl)\n if isinstance(cdecl, self.CData):\n return self._backend.typeof(cdecl)\n if isinstance(cdecl, types.BuiltinFunctionType):\n res = _builtin_function_type(cdecl)\n if res is not None:\n return res\n if (isinstance(cdecl, types.FunctionType)\n and hasattr(cdecl, '_cffi_base_type')):\n with self._lock:\n return self._get_cached_btype(cdecl._cffi_base_type)\n raise TypeError(type(cdecl))\n\n def sizeof(self, cdecl):\n \"\"\"Return the size in bytes of the argument. It can be a\n string naming a C type, or a 'cdata' instance.\n \"\"\"\n if isinstance(cdecl, basestring):\n BType = self._typeof(cdecl)\n return self._backend.sizeof(BType)\n else:\n return self._backend.sizeof(cdecl)\n\n def alignof(self, cdecl):\n \"\"\"Return the natural alignment size in bytes of the C type\n given as a string.\n \"\"\"\n if isinstance(cdecl, basestring):\n cdecl = self._typeof(cdecl)\n return self._backend.alignof(cdecl)\n\n def offsetof(self, cdecl, *fields_or_indexes):\n \"\"\"Return the offset of the named field inside the given\n structure or array, which must be given as a C type name.\n You can give several field names in case of nested structures.\n You can also give numeric values which correspond to array\n items, in case of an array type.\n \"\"\"\n if isinstance(cdecl, basestring):\n cdecl = self._typeof(cdecl)\n return self._typeoffsetof(cdecl, *fields_or_indexes)[1]\n\n def new(self, cdecl, init=None):\n \"\"\"Allocate an instance according to the specified C type and\n return a pointer to it. The specified C type must be either a\n pointer or an array: ``new('X *')`` allocates an X and returns\n a pointer to it, whereas ``new('X[n]')`` allocates an array of\n n X'es and returns an array referencing it (which works\n mostly like a pointer, like in C). You can also use\n ``new('X[]', n)`` to allocate an array of a non-constant\n length n.\n\n The memory is initialized following the rules of declaring a\n global variable in C: by default it is zero-initialized, but\n an explicit initializer can be given which can be used to\n fill all or part of the memory.\n\n When the returned object goes out of scope, the memory\n is freed. In other words the returned object has\n ownership of the value of type 'cdecl' that it points to. This\n means that the raw data can be used as long as this object is\n kept alive, but must not be used for a longer time. Be careful\n about that when copying the pointer to the memory somewhere\n else, e.g. into another structure.\n \"\"\"\n if isinstance(cdecl, basestring):\n cdecl = self._typeof(cdecl)\n return self._backend.newp(cdecl, init)\n\n def new_allocator(self, alloc=None, free=None,\n should_clear_after_alloc=True):\n \"\"\"Return a new allocator, i.e. a function that behaves like ffi.new()\n but uses the provided low-level 'alloc' and 'free' functions.\n\n 'alloc' is called with the size as argument. If it returns NULL, a\n MemoryError is raised. 'free' is called with the result of 'alloc'\n as argument. Both can be either Python function or directly C\n functions. If 'free' is None, then no free function is called.\n If both 'alloc' and 'free' are None, the default is used.\n\n If 'should_clear_after_alloc' is set to False, then the memory\n returned by 'alloc' is assumed to be already cleared (or you are\n fine with garbage); otherwise CFFI will clear it.\n \"\"\"\n compiled_ffi = self._backend.FFI()\n allocator = compiled_ffi.new_allocator(alloc, free,\n should_clear_after_alloc)\n def allocate(cdecl, init=None):\n if isinstance(cdecl, basestring):\n cdecl = self._typeof(cdecl)\n return allocator(cdecl, init)\n return allocate\n\n def cast(self, cdecl, source):\n \"\"\"Similar to a C cast: returns an instance of the named C\n type initialized with the given 'source'. The source is\n casted between integers or pointers of any type.\n \"\"\"\n if isinstance(cdecl, basestring):\n cdecl = self._typeof(cdecl)\n return self._backend.cast(cdecl, source)\n\n def string(self, cdata, maxlen=-1):\n \"\"\"Return a Python string (or unicode string) from the 'cdata'.\n If 'cdata' is a pointer or array of characters or bytes, returns\n the null-terminated string. The returned string extends until\n the first null character, or at most 'maxlen' characters. If\n 'cdata' is an array then 'maxlen' defaults to its length.\n\n If 'cdata' is a pointer or array of wchar_t, returns a unicode\n string following the same rules.\n\n If 'cdata' is a single character or byte or a wchar_t, returns\n it as a string or unicode string.\n\n If 'cdata' is an enum, returns the value of the enumerator as a\n string, or 'NUMBER' if the value is out of range.\n \"\"\"\n return self._backend.string(cdata, maxlen)\n\n def unpack(self, cdata, length):\n \"\"\"Unpack an array of C data of the given length,\n returning a Python string/unicode/list.\n\n If 'cdata' is a pointer to 'char', returns a byte string.\n It does not stop at the first null. This is equivalent to:\n ffi.buffer(cdata, length)[:]\n\n If 'cdata' is a pointer to 'wchar_t', returns a unicode string.\n 'length' is measured in wchar_t's; it is not the size in bytes.\n\n If 'cdata' is a pointer to anything else, returns a list of\n 'length' items. This is a faster equivalent to:\n [cdata[i] for i in range(length)]\n \"\"\"\n return self._backend.unpack(cdata, length)\n\n #def buffer(self, cdata, size=-1):\n # \"\"\"Return a read-write buffer object that references the raw C data\n # pointed to by the given 'cdata'. The 'cdata' must be a pointer or\n # an array. Can be passed to functions expecting a buffer, or directly\n # manipulated with:\n #\n # buf[:] get a copy of it in a regular string, or\n # buf[idx] as a single character\n # buf[:] = ...\n # buf[idx] = ... change the content\n # \"\"\"\n # note that 'buffer' is a type, set on this instance by __init__\n\n def from_buffer(self, cdecl, python_buffer=_unspecified,\n require_writable=False):\n \"\"\"Return a cdata of the given type pointing to the data of the\n given Python object, which must support the buffer interface.\n Note that this is not meant to be used on the built-in types\n str or unicode (you can build 'char[]' arrays explicitly)\n but only on objects containing large quantities of raw data\n in some other format, like 'array.array' or numpy arrays.\n\n The first argument is optional and default to 'char[]'.\n \"\"\"\n if python_buffer is _unspecified:\n cdecl, python_buffer = self.BCharA, cdecl\n elif isinstance(cdecl, basestring):\n cdecl = self._typeof(cdecl)\n return self._backend.from_buffer(cdecl, python_buffer,\n require_writable)\n\n def memmove(self, dest, src, n):\n \"\"\"ffi.memmove(dest, src, n) copies n bytes of memory from src to dest.\n\n Like the C function memmove(), the memory areas may overlap;\n apart from that it behaves like the C function memcpy().\n\n 'src' can be any cdata ptr or array, or any Python buffer object.\n 'dest' can be any cdata ptr or array, or a writable Python buffer\n object. The size to copy, 'n', is always measured in bytes.\n\n Unlike other methods, this one supports all Python buffer including\n byte strings and bytearrays---but it still does not support\n non-contiguous buffers.\n \"\"\"\n return self._backend.memmove(dest, src, n)\n\n def callback(self, cdecl, python_callable=None, error=None, onerror=None):\n \"\"\"Return a callback object or a decorator making such a\n callback object. 'cdecl' must name a C function pointer type.\n The callback invokes the specified 'python_callable' (which may\n be provided either directly or via a decorator). Important: the\n callback object must be manually kept alive for as long as the\n callback may be invoked from the C level.\n \"\"\"\n def callback_decorator_wrap(python_callable):\n if not callable(python_callable):\n raise TypeError(\"the 'python_callable' argument \"\n \"is not callable\")\n return self._backend.callback(cdecl, python_callable,\n error, onerror)\n if isinstance(cdecl, basestring):\n cdecl = self._typeof(cdecl, consider_function_as_funcptr=True)\n if python_callable is None:\n return callback_decorator_wrap # decorator mode\n else:\n return callback_decorator_wrap(python_callable) # direct mode\n\n def getctype(self, cdecl, replace_with=''):\n \"\"\"Return a string giving the C type 'cdecl', which may be itself\n a string or a object. If 'replace_with' is given, it gives\n extra text to append (or insert for more complicated C types), like\n a variable name, or '*' to get actually the C type 'pointer-to-cdecl'.\n \"\"\"\n if isinstance(cdecl, basestring):\n cdecl = self._typeof(cdecl)\n replace_with = replace_with.strip()\n if (replace_with.startswith('*')\n and '&[' in self._backend.getcname(cdecl, '&')):\n replace_with = '(%s)' % replace_with\n elif replace_with and not replace_with[0] in '[(':\n replace_with = ' ' + replace_with\n return self._backend.getcname(cdecl, replace_with)\n\n def gc(self, cdata, destructor, size=0):\n \"\"\"Return a new cdata object that points to the same\n data. Later, when this new cdata object is garbage-collected,\n 'destructor(old_cdata_object)' will be called.\n\n The optional 'size' gives an estimate of the size, used to\n trigger the garbage collection more eagerly. So far only used\n on PyPy. It tells the GC that the returned object keeps alive\n roughly 'size' bytes of external memory.\n \"\"\"\n return self._backend.gcp(cdata, destructor, size)\n\n def _get_cached_btype(self, type):\n assert self._lock.acquire(False) is False\n # call me with the lock!\n try:\n BType = self._cached_btypes[type]\n except KeyError:\n finishlist = []\n BType = type.get_cached_btype(self, finishlist)\n for type in finishlist:\n type.finish_backend_type(self, finishlist)\n return BType\n\n def verify(self, source='', tmpdir=None, **kwargs):\n \"\"\"Verify that the current ffi signatures compile on this\n machine, and return a dynamic library object. The dynamic\n library can be used to call functions and access global\n variables declared in this 'ffi'. The library is compiled\n by the C compiler: it gives you C-level API compatibility\n (including calling macros). This is unlike 'ffi.dlopen()',\n which requires binary compatibility in the signatures.\n \"\"\"\n from .verifier import Verifier, _caller_dir_pycache\n #\n # If set_unicode(True) was called, insert the UNICODE and\n # _UNICODE macro declarations\n if self._windows_unicode:\n self._apply_windows_unicode(kwargs)\n #\n # Set the tmpdir here, and not in Verifier.__init__: it picks\n # up the caller's directory, which we want to be the caller of\n # ffi.verify(), as opposed to the caller of Veritier().\n tmpdir = tmpdir or _caller_dir_pycache()\n #\n # Make a Verifier() and use it to load the library.\n self.verifier = Verifier(self, source, tmpdir, **kwargs)\n lib = self.verifier.load_library()\n #\n # Save the loaded library for keep-alive purposes, even\n # if the caller doesn't keep it alive itself (it should).\n self._libraries.append(lib)\n return lib\n\n def _get_errno(self):\n return self._backend.get_errno()\n def _set_errno(self, errno):\n self._backend.set_errno(errno)\n errno = property(_get_errno, _set_errno, None,\n \"the value of 'errno' from/to the C calls\")\n\n def getwinerror(self, code=-1):\n return self._backend.getwinerror(code)\n\n def _pointer_to(self, ctype):\n with self._lock:\n return model.pointer_cache(self, ctype)\n\n def addressof(self, cdata, *fields_or_indexes):\n \"\"\"Return the address of a .\n If 'fields_or_indexes' are given, returns the address of that\n field or array item in the structure or array, recursively in\n case of nested structures.\n \"\"\"\n try:\n ctype = self._backend.typeof(cdata)\n except TypeError:\n if '__addressof__' in type(cdata).__dict__:\n return type(cdata).__addressof__(cdata, *fields_or_indexes)\n raise\n if fields_or_indexes:\n ctype, offset = self._typeoffsetof(ctype, *fields_or_indexes)\n else:\n if ctype.kind == \"pointer\":\n raise TypeError(\"addressof(pointer)\")\n offset = 0\n ctypeptr = self._pointer_to(ctype)\n return self._backend.rawaddressof(ctypeptr, cdata, offset)\n\n def _typeoffsetof(self, ctype, field_or_index, *fields_or_indexes):\n ctype, offset = self._backend.typeoffsetof(ctype, field_or_index)\n for field1 in fields_or_indexes:\n ctype, offset1 = self._backend.typeoffsetof(ctype, field1, 1)\n offset += offset1\n return ctype, offset\n\n def include(self, ffi_to_include):\n \"\"\"Includes the typedefs, structs, unions and enums defined\n in another FFI instance. Usage is similar to a #include in C,\n where a part of the program might include types defined in\n another part for its own usage. Note that the include()\n method has no effect on functions, constants and global\n variables, which must anyway be accessed directly from the\n lib object returned by the original FFI instance.\n \"\"\"\n if not isinstance(ffi_to_include, FFI):\n raise TypeError(\"ffi.include() expects an argument that is also of\"\n \" type cffi.FFI, not %r\" % (\n type(ffi_to_include).__name__,))\n if ffi_to_include is self:\n raise ValueError(\"self.include(self)\")\n with ffi_to_include._lock:\n with self._lock:\n self._parser.include(ffi_to_include._parser)\n self._cdefsources.append('[')\n self._cdefsources.extend(ffi_to_include._cdefsources)\n self._cdefsources.append(']')\n self._included_ffis.append(ffi_to_include)\n\n def new_handle(self, x):\n return self._backend.newp_handle(self.BVoidP, x)\n\n def from_handle(self, x):\n return self._backend.from_handle(x)\n\n def release(self, x):\n self._backend.release(x)\n\n def set_unicode(self, enabled_flag):\n \"\"\"Windows: if 'enabled_flag' is True, enable the UNICODE and\n _UNICODE defines in C, and declare the types like TCHAR and LPTCSTR\n to be (pointers to) wchar_t. If 'enabled_flag' is False,\n declare these types to be (pointers to) plain 8-bit characters.\n This is mostly for backward compatibility; you usually want True.\n \"\"\"\n if self._windows_unicode is not None:\n raise ValueError(\"set_unicode() can only be called once\")\n enabled_flag = bool(enabled_flag)\n if enabled_flag:\n self.cdef(\"typedef wchar_t TBYTE;\"\n \"typedef wchar_t TCHAR;\"\n \"typedef const wchar_t *LPCTSTR;\"\n \"typedef const wchar_t *PCTSTR;\"\n \"typedef wchar_t *LPTSTR;\"\n \"typedef wchar_t *PTSTR;\"\n \"typedef TBYTE *PTBYTE;\"\n \"typedef TCHAR *PTCHAR;\")\n else:\n self.cdef(\"typedef char TBYTE;\"\n \"typedef char TCHAR;\"\n \"typedef const char *LPCTSTR;\"\n \"typedef const char *PCTSTR;\"\n \"typedef char *LPTSTR;\"\n \"typedef char *PTSTR;\"\n \"typedef TBYTE *PTBYTE;\"\n \"typedef TCHAR *PTCHAR;\")\n self._windows_unicode = enabled_flag\n\n def _apply_windows_unicode(self, kwds):\n defmacros = kwds.get('define_macros', ())\n if not isinstance(defmacros, (list, tuple)):\n raise TypeError(\"'define_macros' must be a list or tuple\")\n defmacros = list(defmacros) + [('UNICODE', '1'),\n ('_UNICODE', '1')]\n kwds['define_macros'] = defmacros\n\n def _apply_embedding_fix(self, kwds):\n # must include an argument like \"-lpython2.7\" for the compiler\n def ensure(key, value):\n lst = kwds.setdefault(key, [])\n if value not in lst:\n lst.append(value)\n #\n if '__pypy__' in sys.builtin_module_names:\n import os\n if sys.platform == \"win32\":\n # we need 'libpypy-c.lib'. Current distributions of\n # pypy (>= 4.1) contain it as 'libs/python27.lib'.\n pythonlib = \"python{0[0]}{0[1]}\".format(sys.version_info)\n if hasattr(sys, 'prefix'):\n ensure('library_dirs', os.path.join(sys.prefix, 'libs'))\n else:\n # we need 'libpypy-c.{so,dylib}', which should be by\n # default located in 'sys.prefix/bin' for installed\n # systems.\n if sys.version_info < (3,):\n pythonlib = \"pypy-c\"\n else:\n pythonlib = \"pypy3-c\"\n if hasattr(sys, 'prefix'):\n ensure('library_dirs', os.path.join(sys.prefix, 'bin'))\n # On uninstalled pypy's, the libpypy-c is typically found in\n # .../pypy/goal/.\n if hasattr(sys, 'prefix'):\n ensure('library_dirs', os.path.join(sys.prefix, 'pypy', 'goal'))\n else:\n if sys.platform == \"win32\":\n template = \"python%d%d\"\n if hasattr(sys, 'gettotalrefcount'):\n template += '_d'\n else:\n try:\n import sysconfig\n except ImportError: # 2.6\n from distutils import sysconfig\n template = \"python%d.%d\"\n if sysconfig.get_config_var('DEBUG_EXT'):\n template += sysconfig.get_config_var('DEBUG_EXT')\n pythonlib = (template %\n (sys.hexversion >> 24, (sys.hexversion >> 16) & 0xff))\n if hasattr(sys, 'abiflags'):\n pythonlib += sys.abiflags\n ensure('libraries', pythonlib)\n if sys.platform == \"win32\":\n ensure('extra_link_args', '/MANIFEST')\n\n def set_source(self, module_name, source, source_extension='.c', **kwds):\n import os\n if hasattr(self, '_assigned_source'):\n raise ValueError(\"set_source() cannot be called several times \"\n \"per ffi object\")\n if not isinstance(module_name, basestring):\n raise TypeError(\"'module_name' must be a string\")\n if os.sep in module_name or (os.altsep and os.altsep in module_name):\n raise ValueError(\"'module_name' must not contain '/': use a dotted \"\n \"name to make a 'package.module' location\")\n self._assigned_source = (str(module_name), source,\n source_extension, kwds)\n\n def set_source_pkgconfig(self, module_name, pkgconfig_libs, source,\n source_extension='.c', **kwds):\n from . import pkgconfig\n if not isinstance(pkgconfig_libs, list):\n raise TypeError(\"the pkgconfig_libs argument must be a list \"\n \"of package names\")\n kwds2 = pkgconfig.flags_from_pkgconfig(pkgconfig_libs)\n pkgconfig.merge_flags(kwds, kwds2)\n self.set_source(module_name, source, source_extension, **kwds)\n\n def distutils_extension(self, tmpdir='build', verbose=True):\n from distutils.dir_util import mkpath\n from .recompiler import recompile\n #\n if not hasattr(self, '_assigned_source'):\n if hasattr(self, 'verifier'): # fallback, 'tmpdir' ignored\n return self.verifier.get_extension()\n raise ValueError(\"set_source() must be called before\"\n \" distutils_extension()\")\n module_name, source, source_extension, kwds = self._assigned_source\n if source is None:\n raise TypeError(\"distutils_extension() is only for C extension \"\n \"modules, not for dlopen()-style pure Python \"\n \"modules\")\n mkpath(tmpdir)\n ext, updated = recompile(self, module_name,\n source, tmpdir=tmpdir, extradir=tmpdir,\n source_extension=source_extension,\n call_c_compiler=False, **kwds)\n if verbose:\n if updated:\n sys.stderr.write(\"regenerated: %r\\n\" % (ext.sources[0],))\n else:\n sys.stderr.write(\"not modified: %r\\n\" % (ext.sources[0],))\n return ext\n\n def emit_c_code(self, filename):\n from .recompiler import recompile\n #\n if not hasattr(self, '_assigned_source'):\n raise ValueError(\"set_source() must be called before emit_c_code()\")\n module_name, source, source_extension, kwds = self._assigned_source\n if source is None:\n raise TypeError(\"emit_c_code() is only for C extension modules, \"\n \"not for dlopen()-style pure Python modules\")\n recompile(self, module_name, source,\n c_file=filename, call_c_compiler=False, **kwds)\n\n def emit_python_code(self, filename):\n from .recompiler import recompile\n #\n if not hasattr(self, '_assigned_source'):\n raise ValueError(\"set_source() must be called before emit_c_code()\")\n module_name, source, source_extension, kwds = self._assigned_source\n if source is not None:\n raise TypeError(\"emit_python_code() is only for dlopen()-style \"\n \"pure Python modules, not for C extension modules\")\n recompile(self, module_name, source,\n c_file=filename, call_c_compiler=False, **kwds)\n\n def compile(self, tmpdir='.', verbose=0, target=None, debug=None):\n \"\"\"The 'target' argument gives the final file name of the\n compiled DLL. Use '*' to force distutils' choice, suitable for\n regular CPython C API modules. Use a file name ending in '.*'\n to ask for the system's default extension for dynamic libraries\n (.so/.dll/.dylib).\n\n The default is '*' when building a non-embedded C API extension,\n and (module_name + '.*') when building an embedded library.\n \"\"\"\n from .recompiler import recompile\n #\n if not hasattr(self, '_assigned_source'):\n raise ValueError(\"set_source() must be called before compile()\")\n module_name, source, source_extension, kwds = self._assigned_source\n return recompile(self, module_name, source, tmpdir=tmpdir,\n target=target, source_extension=source_extension,\n compiler_verbose=verbose, debug=debug, **kwds)\n\n def init_once(self, func, tag):\n # Read _init_once_cache[tag], which is either (False, lock) if\n # we're calling the function now in some thread, or (True, result).\n # Don't call setdefault() in most cases, to avoid allocating and\n # immediately freeing a lock; but still use setdefaut() to avoid\n # races.\n try:\n x = self._init_once_cache[tag]\n except KeyError:\n x = self._init_once_cache.setdefault(tag, (False, allocate_lock()))\n # Common case: we got (True, result), so we return the result.\n if x[0]:\n return x[1]\n # Else, it's a lock. Acquire it to serialize the following tests.\n with x[1]:\n # Read again from _init_once_cache the current status.\n x = self._init_once_cache[tag]\n if x[0]:\n return x[1]\n # Call the function and store the result back.\n result = func()\n self._init_once_cache[tag] = (True, result)\n return result\n\n def embedding_init_code(self, pysource):\n if self._embedding:\n raise ValueError(\"embedding_init_code() can only be called once\")\n # fix 'pysource' before it gets dumped into the C file:\n # - remove empty lines at the beginning, so it starts at \"line 1\"\n # - dedent, if all non-empty lines are indented\n # - check for SyntaxErrors\n import re\n match = re.match(r'\\s*\\n', pysource)\n if match:\n pysource = pysource[match.end():]\n lines = pysource.splitlines() or ['']\n prefix = re.match(r'\\s*', lines[0]).group()\n for i in range(1, len(lines)):\n line = lines[i]\n if line.rstrip():\n while not line.startswith(prefix):\n prefix = prefix[:-1]\n i = len(prefix)\n lines = [line[i:]+'\\n' for line in lines]\n pysource = ''.join(lines)\n #\n compile(pysource, \"cffi_init\", \"exec\")\n #\n self._embedding = pysource\n\n def def_extern(self, *args, **kwds):\n raise ValueError(\"ffi.def_extern() is only available on API-mode FFI \"\n \"objects\")\n\n def list_types(self):\n \"\"\"Returns the user type names known to this FFI instance.\n This returns a tuple containing three lists of names:\n (typedef_names, names_of_structs, names_of_unions)\n \"\"\"\n typedefs = []\n structs = []\n unions = []\n for key in self._parser._declarations:\n if key.startswith('typedef '):\n typedefs.append(key[8:])\n elif key.startswith('struct '):\n structs.append(key[7:])\n elif key.startswith('union '):\n unions.append(key[6:])\n typedefs.sort()\n structs.sort()\n unions.sort()\n return (typedefs, structs, unions)\n\n\ndef _load_backend_lib(backend, name, flags):\n import os\n if name is None:\n if sys.platform != \"win32\":\n return backend.load_library(None, flags)\n name = \"c\" # Windows: load_library(None) fails, but this works\n # on Python 2 (backward compatibility hack only)\n first_error = None\n if '.' in name or '/' in name or os.sep in name:\n try:\n return backend.load_library(name, flags)\n except OSError as e:\n first_error = e\n import ctypes.util\n path = ctypes.util.find_library(name)\n if path is None:\n if name == \"c\" and sys.platform == \"win32\" and sys.version_info >= (3,):\n raise OSError(\"dlopen(None) cannot work on Windows for Python 3 \"\n \"(see http://bugs.python.org/issue23606)\")\n msg = (\"ctypes.util.find_library() did not manage \"\n \"to locate a library called %r\" % (name,))\n if first_error is not None:\n msg = \"%s. Additionally, %s\" % (first_error, msg)\n raise OSError(msg)\n return backend.load_library(path, flags)\n\ndef _make_ffi_library(ffi, libname, flags):\n backend = ffi._backend\n backendlib = _load_backend_lib(backend, libname, flags)\n #\n def accessor_function(name):\n key = 'function ' + name\n tp, _ = ffi._parser._declarations[key]\n BType = ffi._get_cached_btype(tp)\n value = backendlib.load_function(BType, name)\n library.__dict__[name] = value\n #\n def accessor_variable(name):\n key = 'variable ' + name\n tp, _ = ffi._parser._declarations[key]\n BType = ffi._get_cached_btype(tp)\n read_variable = backendlib.read_variable\n write_variable = backendlib.write_variable\n setattr(FFILibrary, name, property(\n lambda self: read_variable(BType, name),\n lambda self, value: write_variable(BType, name, value)))\n #\n def addressof_var(name):\n try:\n return addr_variables[name]\n except KeyError:\n with ffi._lock:\n if name not in addr_variables:\n key = 'variable ' + name\n tp, _ = ffi._parser._declarations[key]\n BType = ffi._get_cached_btype(tp)\n if BType.kind != 'array':\n BType = model.pointer_cache(ffi, BType)\n p = backendlib.load_function(BType, name)\n addr_variables[name] = p\n return addr_variables[name]\n #\n def accessor_constant(name):\n raise NotImplementedError(\"non-integer constant '%s' cannot be \"\n \"accessed from a dlopen() library\" % (name,))\n #\n def accessor_int_constant(name):\n library.__dict__[name] = ffi._parser._int_constants[name]\n #\n accessors = {}\n accessors_version = [False]\n addr_variables = {}\n #\n def update_accessors():\n if accessors_version[0] is ffi._cdef_version:\n return\n #\n for key, (tp, _) in ffi._parser._declarations.items():\n if not isinstance(tp, model.EnumType):\n tag, name = key.split(' ', 1)\n if tag == 'function':\n accessors[name] = accessor_function\n elif tag == 'variable':\n accessors[name] = accessor_variable\n elif tag == 'constant':\n accessors[name] = accessor_constant\n else:\n for i, enumname in enumerate(tp.enumerators):\n def accessor_enum(name, tp=tp, i=i):\n tp.check_not_partial()\n library.__dict__[name] = tp.enumvalues[i]\n accessors[enumname] = accessor_enum\n for name in ffi._parser._int_constants:\n accessors.setdefault(name, accessor_int_constant)\n accessors_version[0] = ffi._cdef_version\n #\n def make_accessor(name):\n with ffi._lock:\n if name in library.__dict__ or name in FFILibrary.__dict__:\n return # added by another thread while waiting for the lock\n if name not in accessors:\n update_accessors()\n if name not in accessors:\n raise AttributeError(name)\n accessors[name](name)\n #\n class FFILibrary(object):\n def __getattr__(self, name):\n make_accessor(name)\n return getattr(self, name)\n def __setattr__(self, name, value):\n try:\n property = getattr(self.__class__, name)\n except AttributeError:\n make_accessor(name)\n setattr(self, name, value)\n else:\n property.__set__(self, value)\n def __dir__(self):\n with ffi._lock:\n update_accessors()\n return accessors.keys()\n def __addressof__(self, name):\n if name in library.__dict__:\n return library.__dict__[name]\n if name in FFILibrary.__dict__:\n return addressof_var(name)\n make_accessor(name)\n if name in library.__dict__:\n return library.__dict__[name]\n if name in FFILibrary.__dict__:\n return addressof_var(name)\n raise AttributeError(\"cffi library has no function or \"\n \"global variable named '%s'\" % (name,))\n def __cffi_close__(self):\n backendlib.close_lib()\n self.__dict__.clear()\n #\n if libname is not None:\n try:\n if not isinstance(libname, str): # unicode, on Python 2\n libname = libname.encode('utf-8')\n FFILibrary.__name__ = 'FFILibrary_%s' % libname\n except UnicodeError:\n pass\n library = FFILibrary()\n return library, library.__dict__\n\ndef _builtin_function_type(func):\n # a hack to make at least ffi.typeof(builtin_function) work,\n # if the builtin function was obtained by 'vengine_cpy'.\n import sys\n try:\n module = sys.modules[func.__module__]\n ffi = module._cffi_original_ffi\n types_of_builtin_funcs = module._cffi_types_of_builtin_funcs\n tp = types_of_builtin_funcs[func]\n except (KeyError, AttributeError, TypeError):\n return None\n else:\n with ffi._lock:\n return ffi._get_cached_btype(tp)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cffi/backend_ctypes.py",
"content": "import ctypes, ctypes.util, operator, sys\nfrom . import model\n\nif sys.version_info < (3,):\n bytechr = chr\nelse:\n unicode = str\n long = int\n xrange = range\n bytechr = lambda num: bytes([num])\n\nclass CTypesType(type):\n pass\n\nclass CTypesData(object):\n __metaclass__ = CTypesType\n __slots__ = ['__weakref__']\n __name__ = ''\n\n def __init__(self, *args):\n raise TypeError(\"cannot instantiate %r\" % (self.__class__,))\n\n @classmethod\n def _newp(cls, init):\n raise TypeError(\"expected a pointer or array ctype, got '%s'\"\n % (cls._get_c_name(),))\n\n @staticmethod\n def _to_ctypes(value):\n raise TypeError\n\n @classmethod\n def _arg_to_ctypes(cls, *value):\n try:\n ctype = cls._ctype\n except AttributeError:\n raise TypeError(\"cannot create an instance of %r\" % (cls,))\n if value:\n res = cls._to_ctypes(*value)\n if not isinstance(res, ctype):\n res = cls._ctype(res)\n else:\n res = cls._ctype()\n return res\n\n @classmethod\n def _create_ctype_obj(cls, init):\n if init is None:\n return cls._arg_to_ctypes()\n else:\n return cls._arg_to_ctypes(init)\n\n @staticmethod\n def _from_ctypes(ctypes_value):\n raise TypeError\n\n @classmethod\n def _get_c_name(cls, replace_with=''):\n return cls._reftypename.replace(' &', replace_with)\n\n @classmethod\n def _fix_class(cls):\n cls.__name__ = 'CData<%s>' % (cls._get_c_name(),)\n cls.__qualname__ = 'CData<%s>' % (cls._get_c_name(),)\n cls.__module__ = 'ffi'\n\n def _get_own_repr(self):\n raise NotImplementedError\n\n def _addr_repr(self, address):\n if address == 0:\n return 'NULL'\n else:\n if address < 0:\n address += 1 << (8*ctypes.sizeof(ctypes.c_void_p))\n return '0x%x' % address\n\n def __repr__(self, c_name=None):\n own = self._get_own_repr()\n return '' % (c_name or self._get_c_name(), own)\n\n def _convert_to_address(self, BClass):\n if BClass is None:\n raise TypeError(\"cannot convert %r to an address\" % (\n self._get_c_name(),))\n else:\n raise TypeError(\"cannot convert %r to %r\" % (\n self._get_c_name(), BClass._get_c_name()))\n\n @classmethod\n def _get_size(cls):\n return ctypes.sizeof(cls._ctype)\n\n def _get_size_of_instance(self):\n return ctypes.sizeof(self._ctype)\n\n @classmethod\n def _cast_from(cls, source):\n raise TypeError(\"cannot cast to %r\" % (cls._get_c_name(),))\n\n def _cast_to_integer(self):\n return self._convert_to_address(None)\n\n @classmethod\n def _alignment(cls):\n return ctypes.alignment(cls._ctype)\n\n def __iter__(self):\n raise TypeError(\"cdata %r does not support iteration\" % (\n self._get_c_name()),)\n\n def _make_cmp(name):\n cmpfunc = getattr(operator, name)\n def cmp(self, other):\n v_is_ptr = not isinstance(self, CTypesGenericPrimitive)\n w_is_ptr = (isinstance(other, CTypesData) and\n not isinstance(other, CTypesGenericPrimitive))\n if v_is_ptr and w_is_ptr:\n return cmpfunc(self._convert_to_address(None),\n other._convert_to_address(None))\n elif v_is_ptr or w_is_ptr:\n return NotImplemented\n else:\n if isinstance(self, CTypesGenericPrimitive):\n self = self._value\n if isinstance(other, CTypesGenericPrimitive):\n other = other._value\n return cmpfunc(self, other)\n cmp.func_name = name\n return cmp\n\n __eq__ = _make_cmp('__eq__')\n __ne__ = _make_cmp('__ne__')\n __lt__ = _make_cmp('__lt__')\n __le__ = _make_cmp('__le__')\n __gt__ = _make_cmp('__gt__')\n __ge__ = _make_cmp('__ge__')\n\n def __hash__(self):\n return hash(self._convert_to_address(None))\n\n def _to_string(self, maxlen):\n raise TypeError(\"string(): %r\" % (self,))\n\n\nclass CTypesGenericPrimitive(CTypesData):\n __slots__ = []\n\n def __hash__(self):\n return hash(self._value)\n\n def _get_own_repr(self):\n return repr(self._from_ctypes(self._value))\n\n\nclass CTypesGenericArray(CTypesData):\n __slots__ = []\n\n @classmethod\n def _newp(cls, init):\n return cls(init)\n\n def __iter__(self):\n for i in xrange(len(self)):\n yield self[i]\n\n def _get_own_repr(self):\n return self._addr_repr(ctypes.addressof(self._blob))\n\n\nclass CTypesGenericPtr(CTypesData):\n __slots__ = ['_address', '_as_ctype_ptr']\n _automatic_casts = False\n kind = \"pointer\"\n\n @classmethod\n def _newp(cls, init):\n return cls(init)\n\n @classmethod\n def _cast_from(cls, source):\n if source is None:\n address = 0\n elif isinstance(source, CTypesData):\n address = source._cast_to_integer()\n elif isinstance(source, (int, long)):\n address = source\n else:\n raise TypeError(\"bad type for cast to %r: %r\" %\n (cls, type(source).__name__))\n return cls._new_pointer_at(address)\n\n @classmethod\n def _new_pointer_at(cls, address):\n self = cls.__new__(cls)\n self._address = address\n self._as_ctype_ptr = ctypes.cast(address, cls._ctype)\n return self\n\n def _get_own_repr(self):\n try:\n return self._addr_repr(self._address)\n except AttributeError:\n return '???'\n\n def _cast_to_integer(self):\n return self._address\n\n def __nonzero__(self):\n return bool(self._address)\n __bool__ = __nonzero__\n\n @classmethod\n def _to_ctypes(cls, value):\n if not isinstance(value, CTypesData):\n raise TypeError(\"unexpected %s object\" % type(value).__name__)\n address = value._convert_to_address(cls)\n return ctypes.cast(address, cls._ctype)\n\n @classmethod\n def _from_ctypes(cls, ctypes_ptr):\n address = ctypes.cast(ctypes_ptr, ctypes.c_void_p).value or 0\n return cls._new_pointer_at(address)\n\n @classmethod\n def _initialize(cls, ctypes_ptr, value):\n if value:\n ctypes_ptr.contents = cls._to_ctypes(value).contents\n\n def _convert_to_address(self, BClass):\n if (BClass in (self.__class__, None) or BClass._automatic_casts\n or self._automatic_casts):\n return self._address\n else:\n return CTypesData._convert_to_address(self, BClass)\n\n\nclass CTypesBaseStructOrUnion(CTypesData):\n __slots__ = ['_blob']\n\n @classmethod\n def _create_ctype_obj(cls, init):\n # may be overridden\n raise TypeError(\"cannot instantiate opaque type %s\" % (cls,))\n\n def _get_own_repr(self):\n return self._addr_repr(ctypes.addressof(self._blob))\n\n @classmethod\n def _offsetof(cls, fieldname):\n return getattr(cls._ctype, fieldname).offset\n\n def _convert_to_address(self, BClass):\n if getattr(BClass, '_BItem', None) is self.__class__:\n return ctypes.addressof(self._blob)\n else:\n return CTypesData._convert_to_address(self, BClass)\n\n @classmethod\n def _from_ctypes(cls, ctypes_struct_or_union):\n self = cls.__new__(cls)\n self._blob = ctypes_struct_or_union\n return self\n\n @classmethod\n def _to_ctypes(cls, value):\n return value._blob\n\n def __repr__(self, c_name=None):\n return CTypesData.__repr__(self, c_name or self._get_c_name(' &'))\n\n\nclass CTypesBackend(object):\n\n PRIMITIVE_TYPES = {\n 'char': ctypes.c_char,\n 'short': ctypes.c_short,\n 'int': ctypes.c_int,\n 'long': ctypes.c_long,\n 'long long': ctypes.c_longlong,\n 'signed char': ctypes.c_byte,\n 'unsigned char': ctypes.c_ubyte,\n 'unsigned short': ctypes.c_ushort,\n 'unsigned int': ctypes.c_uint,\n 'unsigned long': ctypes.c_ulong,\n 'unsigned long long': ctypes.c_ulonglong,\n 'float': ctypes.c_float,\n 'double': ctypes.c_double,\n '_Bool': ctypes.c_bool,\n }\n\n for _name in ['unsigned long long', 'unsigned long',\n 'unsigned int', 'unsigned short', 'unsigned char']:\n _size = ctypes.sizeof(PRIMITIVE_TYPES[_name])\n PRIMITIVE_TYPES['uint%d_t' % (8*_size)] = PRIMITIVE_TYPES[_name]\n if _size == ctypes.sizeof(ctypes.c_void_p):\n PRIMITIVE_TYPES['uintptr_t'] = PRIMITIVE_TYPES[_name]\n if _size == ctypes.sizeof(ctypes.c_size_t):\n PRIMITIVE_TYPES['size_t'] = PRIMITIVE_TYPES[_name]\n\n for _name in ['long long', 'long', 'int', 'short', 'signed char']:\n _size = ctypes.sizeof(PRIMITIVE_TYPES[_name])\n PRIMITIVE_TYPES['int%d_t' % (8*_size)] = PRIMITIVE_TYPES[_name]\n if _size == ctypes.sizeof(ctypes.c_void_p):\n PRIMITIVE_TYPES['intptr_t'] = PRIMITIVE_TYPES[_name]\n PRIMITIVE_TYPES['ptrdiff_t'] = PRIMITIVE_TYPES[_name]\n if _size == ctypes.sizeof(ctypes.c_size_t):\n PRIMITIVE_TYPES['ssize_t'] = PRIMITIVE_TYPES[_name]\n\n\n def __init__(self):\n self.RTLD_LAZY = 0 # not supported anyway by ctypes\n self.RTLD_NOW = 0\n self.RTLD_GLOBAL = ctypes.RTLD_GLOBAL\n self.RTLD_LOCAL = ctypes.RTLD_LOCAL\n\n def set_ffi(self, ffi):\n self.ffi = ffi\n\n def _get_types(self):\n return CTypesData, CTypesType\n\n def load_library(self, path, flags=0):\n cdll = ctypes.CDLL(path, flags)\n return CTypesLibrary(self, cdll)\n\n def new_void_type(self):\n class CTypesVoid(CTypesData):\n __slots__ = []\n _reftypename = 'void &'\n @staticmethod\n def _from_ctypes(novalue):\n return None\n @staticmethod\n def _to_ctypes(novalue):\n if novalue is not None:\n raise TypeError(\"None expected, got %s object\" %\n (type(novalue).__name__,))\n return None\n CTypesVoid._fix_class()\n return CTypesVoid\n\n def new_primitive_type(self, name):\n if name == 'wchar_t':\n raise NotImplementedError(name)\n ctype = self.PRIMITIVE_TYPES[name]\n if name == 'char':\n kind = 'char'\n elif name in ('float', 'double'):\n kind = 'float'\n else:\n if name in ('signed char', 'unsigned char'):\n kind = 'byte'\n elif name == '_Bool':\n kind = 'bool'\n else:\n kind = 'int'\n is_signed = (ctype(-1).value == -1)\n #\n def _cast_source_to_int(source):\n if isinstance(source, (int, long, float)):\n source = int(source)\n elif isinstance(source, CTypesData):\n source = source._cast_to_integer()\n elif isinstance(source, bytes):\n source = ord(source)\n elif source is None:\n source = 0\n else:\n raise TypeError(\"bad type for cast to %r: %r\" %\n (CTypesPrimitive, type(source).__name__))\n return source\n #\n kind1 = kind\n class CTypesPrimitive(CTypesGenericPrimitive):\n __slots__ = ['_value']\n _ctype = ctype\n _reftypename = '%s &' % name\n kind = kind1\n\n def __init__(self, value):\n self._value = value\n\n @staticmethod\n def _create_ctype_obj(init):\n if init is None:\n return ctype()\n return ctype(CTypesPrimitive._to_ctypes(init))\n\n if kind == 'int' or kind == 'byte':\n @classmethod\n def _cast_from(cls, source):\n source = _cast_source_to_int(source)\n source = ctype(source).value # cast within range\n return cls(source)\n def __int__(self):\n return self._value\n\n if kind == 'bool':\n @classmethod\n def _cast_from(cls, source):\n if not isinstance(source, (int, long, float)):\n source = _cast_source_to_int(source)\n return cls(bool(source))\n def __int__(self):\n return int(self._value)\n\n if kind == 'char':\n @classmethod\n def _cast_from(cls, source):\n source = _cast_source_to_int(source)\n source = bytechr(source & 0xFF)\n return cls(source)\n def __int__(self):\n return ord(self._value)\n\n if kind == 'float':\n @classmethod\n def _cast_from(cls, source):\n if isinstance(source, float):\n pass\n elif isinstance(source, CTypesGenericPrimitive):\n if hasattr(source, '__float__'):\n source = float(source)\n else:\n source = int(source)\n else:\n source = _cast_source_to_int(source)\n source = ctype(source).value # fix precision\n return cls(source)\n def __int__(self):\n return int(self._value)\n def __float__(self):\n return self._value\n\n _cast_to_integer = __int__\n\n if kind == 'int' or kind == 'byte' or kind == 'bool':\n @staticmethod\n def _to_ctypes(x):\n if not isinstance(x, (int, long)):\n if isinstance(x, CTypesData):\n x = int(x)\n else:\n raise TypeError(\"integer expected, got %s\" %\n type(x).__name__)\n if ctype(x).value != x:\n if not is_signed and x < 0:\n raise OverflowError(\"%s: negative integer\" % name)\n else:\n raise OverflowError(\"%s: integer out of bounds\"\n % name)\n return x\n\n if kind == 'char':\n @staticmethod\n def _to_ctypes(x):\n if isinstance(x, bytes) and len(x) == 1:\n return x\n if isinstance(x, CTypesPrimitive): # >\n return x._value\n raise TypeError(\"character expected, got %s\" %\n type(x).__name__)\n def __nonzero__(self):\n return ord(self._value) != 0\n else:\n def __nonzero__(self):\n return self._value != 0\n __bool__ = __nonzero__\n\n if kind == 'float':\n @staticmethod\n def _to_ctypes(x):\n if not isinstance(x, (int, long, float, CTypesData)):\n raise TypeError(\"float expected, got %s\" %\n type(x).__name__)\n return ctype(x).value\n\n @staticmethod\n def _from_ctypes(value):\n return getattr(value, 'value', value)\n\n @staticmethod\n def _initialize(blob, init):\n blob.value = CTypesPrimitive._to_ctypes(init)\n\n if kind == 'char':\n def _to_string(self, maxlen):\n return self._value\n if kind == 'byte':\n def _to_string(self, maxlen):\n return chr(self._value & 0xff)\n #\n CTypesPrimitive._fix_class()\n return CTypesPrimitive\n\n def new_pointer_type(self, BItem):\n getbtype = self.ffi._get_cached_btype\n if BItem is getbtype(model.PrimitiveType('char')):\n kind = 'charp'\n elif BItem in (getbtype(model.PrimitiveType('signed char')),\n getbtype(model.PrimitiveType('unsigned char'))):\n kind = 'bytep'\n elif BItem is getbtype(model.void_type):\n kind = 'voidp'\n else:\n kind = 'generic'\n #\n class CTypesPtr(CTypesGenericPtr):\n __slots__ = ['_own']\n if kind == 'charp':\n __slots__ += ['__as_strbuf']\n _BItem = BItem\n if hasattr(BItem, '_ctype'):\n _ctype = ctypes.POINTER(BItem._ctype)\n _bitem_size = ctypes.sizeof(BItem._ctype)\n else:\n _ctype = ctypes.c_void_p\n if issubclass(BItem, CTypesGenericArray):\n _reftypename = BItem._get_c_name('(* &)')\n else:\n _reftypename = BItem._get_c_name(' * &')\n\n def __init__(self, init):\n ctypeobj = BItem._create_ctype_obj(init)\n if kind == 'charp':\n self.__as_strbuf = ctypes.create_string_buffer(\n ctypeobj.value + b'\\x00')\n self._as_ctype_ptr = ctypes.cast(\n self.__as_strbuf, self._ctype)\n else:\n self._as_ctype_ptr = ctypes.pointer(ctypeobj)\n self._address = ctypes.cast(self._as_ctype_ptr,\n ctypes.c_void_p).value\n self._own = True\n\n def __add__(self, other):\n if isinstance(other, (int, long)):\n return self._new_pointer_at(self._address +\n other * self._bitem_size)\n else:\n return NotImplemented\n\n def __sub__(self, other):\n if isinstance(other, (int, long)):\n return self._new_pointer_at(self._address -\n other * self._bitem_size)\n elif type(self) is type(other):\n return (self._address - other._address) // self._bitem_size\n else:\n return NotImplemented\n\n def __getitem__(self, index):\n if getattr(self, '_own', False) and index != 0:\n raise IndexError\n return BItem._from_ctypes(self._as_ctype_ptr[index])\n\n def __setitem__(self, index, value):\n self._as_ctype_ptr[index] = BItem._to_ctypes(value)\n\n if kind == 'charp' or kind == 'voidp':\n @classmethod\n def _arg_to_ctypes(cls, *value):\n if value and isinstance(value[0], bytes):\n return ctypes.c_char_p(value[0])\n else:\n return super(CTypesPtr, cls)._arg_to_ctypes(*value)\n\n if kind == 'charp' or kind == 'bytep':\n def _to_string(self, maxlen):\n if maxlen < 0:\n maxlen = sys.maxsize\n p = ctypes.cast(self._as_ctype_ptr,\n ctypes.POINTER(ctypes.c_char))\n n = 0\n while n < maxlen and p[n] != b'\\x00':\n n += 1\n return b''.join([p[i] for i in range(n)])\n\n def _get_own_repr(self):\n if getattr(self, '_own', False):\n return 'owning %d bytes' % (\n ctypes.sizeof(self._as_ctype_ptr.contents),)\n return super(CTypesPtr, self)._get_own_repr()\n #\n if (BItem is self.ffi._get_cached_btype(model.void_type) or\n BItem is self.ffi._get_cached_btype(model.PrimitiveType('char'))):\n CTypesPtr._automatic_casts = True\n #\n CTypesPtr._fix_class()\n return CTypesPtr\n\n def new_array_type(self, CTypesPtr, length):\n if length is None:\n brackets = ' &[]'\n else:\n brackets = ' &[%d]' % length\n BItem = CTypesPtr._BItem\n getbtype = self.ffi._get_cached_btype\n if BItem is getbtype(model.PrimitiveType('char')):\n kind = 'char'\n elif BItem in (getbtype(model.PrimitiveType('signed char')),\n getbtype(model.PrimitiveType('unsigned char'))):\n kind = 'byte'\n else:\n kind = 'generic'\n #\n class CTypesArray(CTypesGenericArray):\n __slots__ = ['_blob', '_own']\n if length is not None:\n _ctype = BItem._ctype * length\n else:\n __slots__.append('_ctype')\n _reftypename = BItem._get_c_name(brackets)\n _declared_length = length\n _CTPtr = CTypesPtr\n\n def __init__(self, init):\n if length is None:\n if isinstance(init, (int, long)):\n len1 = init\n init = None\n elif kind == 'char' and isinstance(init, bytes):\n len1 = len(init) + 1 # extra null\n else:\n init = tuple(init)\n len1 = len(init)\n self._ctype = BItem._ctype * len1\n self._blob = self._ctype()\n self._own = True\n if init is not None:\n self._initialize(self._blob, init)\n\n @staticmethod\n def _initialize(blob, init):\n if isinstance(init, bytes):\n init = [init[i:i+1] for i in range(len(init))]\n else:\n if isinstance(init, CTypesGenericArray):\n if (len(init) != len(blob) or\n not isinstance(init, CTypesArray)):\n raise TypeError(\"length/type mismatch: %s\" % (init,))\n init = tuple(init)\n if len(init) > len(blob):\n raise IndexError(\"too many initializers\")\n addr = ctypes.cast(blob, ctypes.c_void_p).value\n PTR = ctypes.POINTER(BItem._ctype)\n itemsize = ctypes.sizeof(BItem._ctype)\n for i, value in enumerate(init):\n p = ctypes.cast(addr + i * itemsize, PTR)\n BItem._initialize(p.contents, value)\n\n def __len__(self):\n return len(self._blob)\n\n def __getitem__(self, index):\n if not (0 <= index < len(self._blob)):\n raise IndexError\n return BItem._from_ctypes(self._blob[index])\n\n def __setitem__(self, index, value):\n if not (0 <= index < len(self._blob)):\n raise IndexError\n self._blob[index] = BItem._to_ctypes(value)\n\n if kind == 'char' or kind == 'byte':\n def _to_string(self, maxlen):\n if maxlen < 0:\n maxlen = len(self._blob)\n p = ctypes.cast(self._blob,\n ctypes.POINTER(ctypes.c_char))\n n = 0\n while n < maxlen and p[n] != b'\\x00':\n n += 1\n return b''.join([p[i] for i in range(n)])\n\n def _get_own_repr(self):\n if getattr(self, '_own', False):\n return 'owning %d bytes' % (ctypes.sizeof(self._blob),)\n return super(CTypesArray, self)._get_own_repr()\n\n def _convert_to_address(self, BClass):\n if BClass in (CTypesPtr, None) or BClass._automatic_casts:\n return ctypes.addressof(self._blob)\n else:\n return CTypesData._convert_to_address(self, BClass)\n\n @staticmethod\n def _from_ctypes(ctypes_array):\n self = CTypesArray.__new__(CTypesArray)\n self._blob = ctypes_array\n return self\n\n @staticmethod\n def _arg_to_ctypes(value):\n return CTypesPtr._arg_to_ctypes(value)\n\n def __add__(self, other):\n if isinstance(other, (int, long)):\n return CTypesPtr._new_pointer_at(\n ctypes.addressof(self._blob) +\n other * ctypes.sizeof(BItem._ctype))\n else:\n return NotImplemented\n\n @classmethod\n def _cast_from(cls, source):\n raise NotImplementedError(\"casting to %r\" % (\n cls._get_c_name(),))\n #\n CTypesArray._fix_class()\n return CTypesArray\n\n def _new_struct_or_union(self, kind, name, base_ctypes_class):\n #\n class struct_or_union(base_ctypes_class):\n pass\n struct_or_union.__name__ = '%s_%s' % (kind, name)\n kind1 = kind\n #\n class CTypesStructOrUnion(CTypesBaseStructOrUnion):\n __slots__ = ['_blob']\n _ctype = struct_or_union\n _reftypename = '%s &' % (name,)\n _kind = kind = kind1\n #\n CTypesStructOrUnion._fix_class()\n return CTypesStructOrUnion\n\n def new_struct_type(self, name):\n return self._new_struct_or_union('struct', name, ctypes.Structure)\n\n def new_union_type(self, name):\n return self._new_struct_or_union('union', name, ctypes.Union)\n\n def complete_struct_or_union(self, CTypesStructOrUnion, fields, tp,\n totalsize=-1, totalalignment=-1, sflags=0,\n pack=0):\n if totalsize >= 0 or totalalignment >= 0:\n raise NotImplementedError(\"the ctypes backend of CFFI does not support \"\n \"structures completed by verify(); please \"\n \"compile and install the _cffi_backend module.\")\n struct_or_union = CTypesStructOrUnion._ctype\n fnames = [fname for (fname, BField, bitsize) in fields]\n btypes = [BField for (fname, BField, bitsize) in fields]\n bitfields = [bitsize for (fname, BField, bitsize) in fields]\n #\n bfield_types = {}\n cfields = []\n for (fname, BField, bitsize) in fields:\n if bitsize < 0:\n cfields.append((fname, BField._ctype))\n bfield_types[fname] = BField\n else:\n cfields.append((fname, BField._ctype, bitsize))\n bfield_types[fname] = Ellipsis\n if sflags & 8:\n struct_or_union._pack_ = 1\n elif pack:\n struct_or_union._pack_ = pack\n struct_or_union._fields_ = cfields\n CTypesStructOrUnion._bfield_types = bfield_types\n #\n @staticmethod\n def _create_ctype_obj(init):\n result = struct_or_union()\n if init is not None:\n initialize(result, init)\n return result\n CTypesStructOrUnion._create_ctype_obj = _create_ctype_obj\n #\n def initialize(blob, init):\n if is_union:\n if len(init) > 1:\n raise ValueError(\"union initializer: %d items given, but \"\n \"only one supported (use a dict if needed)\"\n % (len(init),))\n if not isinstance(init, dict):\n if isinstance(init, (bytes, unicode)):\n raise TypeError(\"union initializer: got a str\")\n init = tuple(init)\n if len(init) > len(fnames):\n raise ValueError(\"too many values for %s initializer\" %\n CTypesStructOrUnion._get_c_name())\n init = dict(zip(fnames, init))\n addr = ctypes.addressof(blob)\n for fname, value in init.items():\n BField, bitsize = name2fieldtype[fname]\n assert bitsize < 0, \\\n \"not implemented: initializer with bit fields\"\n offset = CTypesStructOrUnion._offsetof(fname)\n PTR = ctypes.POINTER(BField._ctype)\n p = ctypes.cast(addr + offset, PTR)\n BField._initialize(p.contents, value)\n is_union = CTypesStructOrUnion._kind == 'union'\n name2fieldtype = dict(zip(fnames, zip(btypes, bitfields)))\n #\n for fname, BField, bitsize in fields:\n if fname == '':\n raise NotImplementedError(\"nested anonymous structs/unions\")\n if hasattr(CTypesStructOrUnion, fname):\n raise ValueError(\"the field name %r conflicts in \"\n \"the ctypes backend\" % fname)\n if bitsize < 0:\n def getter(self, fname=fname, BField=BField,\n offset=CTypesStructOrUnion._offsetof(fname),\n PTR=ctypes.POINTER(BField._ctype)):\n addr = ctypes.addressof(self._blob)\n p = ctypes.cast(addr + offset, PTR)\n return BField._from_ctypes(p.contents)\n def setter(self, value, fname=fname, BField=BField):\n setattr(self._blob, fname, BField._to_ctypes(value))\n #\n if issubclass(BField, CTypesGenericArray):\n setter = None\n if BField._declared_length == 0:\n def getter(self, fname=fname, BFieldPtr=BField._CTPtr,\n offset=CTypesStructOrUnion._offsetof(fname),\n PTR=ctypes.POINTER(BField._ctype)):\n addr = ctypes.addressof(self._blob)\n p = ctypes.cast(addr + offset, PTR)\n return BFieldPtr._from_ctypes(p)\n #\n else:\n def getter(self, fname=fname, BField=BField):\n return BField._from_ctypes(getattr(self._blob, fname))\n def setter(self, value, fname=fname, BField=BField):\n # xxx obscure workaround\n value = BField._to_ctypes(value)\n oldvalue = getattr(self._blob, fname)\n setattr(self._blob, fname, value)\n if value != getattr(self._blob, fname):\n setattr(self._blob, fname, oldvalue)\n raise OverflowError(\"value too large for bitfield\")\n setattr(CTypesStructOrUnion, fname, property(getter, setter))\n #\n CTypesPtr = self.ffi._get_cached_btype(model.PointerType(tp))\n for fname in fnames:\n if hasattr(CTypesPtr, fname):\n raise ValueError(\"the field name %r conflicts in \"\n \"the ctypes backend\" % fname)\n def getter(self, fname=fname):\n return getattr(self[0], fname)\n def setter(self, value, fname=fname):\n setattr(self[0], fname, value)\n setattr(CTypesPtr, fname, property(getter, setter))\n\n def new_function_type(self, BArgs, BResult, has_varargs):\n nameargs = [BArg._get_c_name() for BArg in BArgs]\n if has_varargs:\n nameargs.append('...')\n nameargs = ', '.join(nameargs)\n #\n class CTypesFunctionPtr(CTypesGenericPtr):\n __slots__ = ['_own_callback', '_name']\n _ctype = ctypes.CFUNCTYPE(getattr(BResult, '_ctype', None),\n *[BArg._ctype for BArg in BArgs],\n use_errno=True)\n _reftypename = BResult._get_c_name('(* &)(%s)' % (nameargs,))\n\n def __init__(self, init, error=None):\n # create a callback to the Python callable init()\n import traceback\n assert not has_varargs, \"varargs not supported for callbacks\"\n if getattr(BResult, '_ctype', None) is not None:\n error = BResult._from_ctypes(\n BResult._create_ctype_obj(error))\n else:\n error = None\n def callback(*args):\n args2 = []\n for arg, BArg in zip(args, BArgs):\n args2.append(BArg._from_ctypes(arg))\n try:\n res2 = init(*args2)\n res2 = BResult._to_ctypes(res2)\n except:\n traceback.print_exc()\n res2 = error\n if issubclass(BResult, CTypesGenericPtr):\n if res2:\n res2 = ctypes.cast(res2, ctypes.c_void_p).value\n # .value: http://bugs.python.org/issue1574593\n else:\n res2 = None\n #print repr(res2)\n return res2\n if issubclass(BResult, CTypesGenericPtr):\n # The only pointers callbacks can return are void*s:\n # http://bugs.python.org/issue5710\n callback_ctype = ctypes.CFUNCTYPE(\n ctypes.c_void_p,\n *[BArg._ctype for BArg in BArgs],\n use_errno=True)\n else:\n callback_ctype = CTypesFunctionPtr._ctype\n self._as_ctype_ptr = callback_ctype(callback)\n self._address = ctypes.cast(self._as_ctype_ptr,\n ctypes.c_void_p).value\n self._own_callback = init\n\n @staticmethod\n def _initialize(ctypes_ptr, value):\n if value:\n raise NotImplementedError(\"ctypes backend: not supported: \"\n \"initializers for function pointers\")\n\n def __repr__(self):\n c_name = getattr(self, '_name', None)\n if c_name:\n i = self._reftypename.index('(* &)')\n if self._reftypename[i-1] not in ' )*':\n c_name = ' ' + c_name\n c_name = self._reftypename.replace('(* &)', c_name)\n return CTypesData.__repr__(self, c_name)\n\n def _get_own_repr(self):\n if getattr(self, '_own_callback', None) is not None:\n return 'calling %r' % (self._own_callback,)\n return super(CTypesFunctionPtr, self)._get_own_repr()\n\n def __call__(self, *args):\n if has_varargs:\n assert len(args) >= len(BArgs)\n extraargs = args[len(BArgs):]\n args = args[:len(BArgs)]\n else:\n assert len(args) == len(BArgs)\n ctypes_args = []\n for arg, BArg in zip(args, BArgs):\n ctypes_args.append(BArg._arg_to_ctypes(arg))\n if has_varargs:\n for i, arg in enumerate(extraargs):\n if arg is None:\n ctypes_args.append(ctypes.c_void_p(0)) # NULL\n continue\n if not isinstance(arg, CTypesData):\n raise TypeError(\n \"argument %d passed in the variadic part \"\n \"needs to be a cdata object (got %s)\" %\n (1 + len(BArgs) + i, type(arg).__name__))\n ctypes_args.append(arg._arg_to_ctypes(arg))\n result = self._as_ctype_ptr(*ctypes_args)\n return BResult._from_ctypes(result)\n #\n CTypesFunctionPtr._fix_class()\n return CTypesFunctionPtr\n\n def new_enum_type(self, name, enumerators, enumvalues, CTypesInt):\n assert isinstance(name, str)\n reverse_mapping = dict(zip(reversed(enumvalues),\n reversed(enumerators)))\n #\n class CTypesEnum(CTypesInt):\n __slots__ = []\n _reftypename = '%s &' % name\n\n def _get_own_repr(self):\n value = self._value\n try:\n return '%d: %s' % (value, reverse_mapping[value])\n except KeyError:\n return str(value)\n\n def _to_string(self, maxlen):\n value = self._value\n try:\n return reverse_mapping[value]\n except KeyError:\n return str(value)\n #\n CTypesEnum._fix_class()\n return CTypesEnum\n\n def get_errno(self):\n return ctypes.get_errno()\n\n def set_errno(self, value):\n ctypes.set_errno(value)\n\n def string(self, b, maxlen=-1):\n return b._to_string(maxlen)\n\n def buffer(self, bptr, size=-1):\n raise NotImplementedError(\"buffer() with ctypes backend\")\n\n def sizeof(self, cdata_or_BType):\n if isinstance(cdata_or_BType, CTypesData):\n return cdata_or_BType._get_size_of_instance()\n else:\n assert issubclass(cdata_or_BType, CTypesData)\n return cdata_or_BType._get_size()\n\n def alignof(self, BType):\n assert issubclass(BType, CTypesData)\n return BType._alignment()\n\n def newp(self, BType, source):\n if not issubclass(BType, CTypesData):\n raise TypeError\n return BType._newp(source)\n\n def cast(self, BType, source):\n return BType._cast_from(source)\n\n def callback(self, BType, source, error, onerror):\n assert onerror is None # XXX not implemented\n return BType(source, error)\n\n _weakref_cache_ref = None\n\n def gcp(self, cdata, destructor, size=0):\n if self._weakref_cache_ref is None:\n import weakref\n class MyRef(weakref.ref):\n def __eq__(self, other):\n myref = self()\n return self is other or (\n myref is not None and myref is other())\n def __ne__(self, other):\n return not (self == other)\n def __hash__(self):\n try:\n return self._hash\n except AttributeError:\n self._hash = hash(self())\n return self._hash\n self._weakref_cache_ref = {}, MyRef\n weak_cache, MyRef = self._weakref_cache_ref\n\n if destructor is None:\n try:\n del weak_cache[MyRef(cdata)]\n except KeyError:\n raise TypeError(\"Can remove destructor only on a object \"\n \"previously returned by ffi.gc()\")\n return None\n\n def remove(k):\n cdata, destructor = weak_cache.pop(k, (None, None))\n if destructor is not None:\n destructor(cdata)\n\n new_cdata = self.cast(self.typeof(cdata), cdata)\n assert new_cdata is not cdata\n weak_cache[MyRef(new_cdata, remove)] = (cdata, destructor)\n return new_cdata\n\n typeof = type\n\n def getcname(self, BType, replace_with):\n return BType._get_c_name(replace_with)\n\n def typeoffsetof(self, BType, fieldname, num=0):\n if isinstance(fieldname, str):\n if num == 0 and issubclass(BType, CTypesGenericPtr):\n BType = BType._BItem\n if not issubclass(BType, CTypesBaseStructOrUnion):\n raise TypeError(\"expected a struct or union ctype\")\n BField = BType._bfield_types[fieldname]\n if BField is Ellipsis:\n raise TypeError(\"not supported for bitfields\")\n return (BField, BType._offsetof(fieldname))\n elif isinstance(fieldname, (int, long)):\n if issubclass(BType, CTypesGenericArray):\n BType = BType._CTPtr\n if not issubclass(BType, CTypesGenericPtr):\n raise TypeError(\"expected an array or ptr ctype\")\n BItem = BType._BItem\n offset = BItem._get_size() * fieldname\n if offset > sys.maxsize:\n raise OverflowError\n return (BItem, offset)\n else:\n raise TypeError(type(fieldname))\n\n def rawaddressof(self, BTypePtr, cdata, offset=None):\n if isinstance(cdata, CTypesBaseStructOrUnion):\n ptr = ctypes.pointer(type(cdata)._to_ctypes(cdata))\n elif isinstance(cdata, CTypesGenericPtr):\n if offset is None or not issubclass(type(cdata)._BItem,\n CTypesBaseStructOrUnion):\n raise TypeError(\"unexpected cdata type\")\n ptr = type(cdata)._to_ctypes(cdata)\n elif isinstance(cdata, CTypesGenericArray):\n ptr = type(cdata)._to_ctypes(cdata)\n else:\n raise TypeError(\"expected a \")\n if offset:\n ptr = ctypes.cast(\n ctypes.c_void_p(\n ctypes.cast(ptr, ctypes.c_void_p).value + offset),\n type(ptr))\n return BTypePtr._from_ctypes(ptr)\n\n\nclass CTypesLibrary(object):\n\n def __init__(self, backend, cdll):\n self.backend = backend\n self.cdll = cdll\n\n def load_function(self, BType, name):\n c_func = getattr(self.cdll, name)\n funcobj = BType._from_ctypes(c_func)\n funcobj._name = name\n return funcobj\n\n def read_variable(self, BType, name):\n try:\n ctypes_obj = BType._ctype.in_dll(self.cdll, name)\n except AttributeError as e:\n raise NotImplementedError(e)\n return BType._from_ctypes(ctypes_obj)\n\n def write_variable(self, BType, name, value):\n new_ctypes_obj = BType._to_ctypes(value)\n ctypes_obj = BType._ctype.in_dll(self.cdll, name)\n ctypes.memmove(ctypes.addressof(ctypes_obj),\n ctypes.addressof(new_ctypes_obj),\n ctypes.sizeof(BType._ctype))\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cffi/cffi_opcode.py",
"content": "from .error import VerificationError\n\nclass CffiOp(object):\n def __init__(self, op, arg):\n self.op = op\n self.arg = arg\n\n def as_c_expr(self):\n if self.op is None:\n assert isinstance(self.arg, str)\n return '(_cffi_opcode_t)(%s)' % (self.arg,)\n classname = CLASS_NAME[self.op]\n return '_CFFI_OP(_CFFI_OP_%s, %s)' % (classname, self.arg)\n\n def as_python_bytes(self):\n if self.op is None and self.arg.isdigit():\n value = int(self.arg) # non-negative: '-' not in self.arg\n if value >= 2**31:\n raise OverflowError(\"cannot emit %r: limited to 2**31-1\"\n % (self.arg,))\n return format_four_bytes(value)\n if isinstance(self.arg, str):\n raise VerificationError(\"cannot emit to Python: %r\" % (self.arg,))\n return format_four_bytes((self.arg << 8) | self.op)\n\n def __str__(self):\n classname = CLASS_NAME.get(self.op, self.op)\n return '(%s %s)' % (classname, self.arg)\n\ndef format_four_bytes(num):\n return '\\\\x%02X\\\\x%02X\\\\x%02X\\\\x%02X' % (\n (num >> 24) & 0xFF,\n (num >> 16) & 0xFF,\n (num >> 8) & 0xFF,\n (num ) & 0xFF)\n\nOP_PRIMITIVE = 1\nOP_POINTER = 3\nOP_ARRAY = 5\nOP_OPEN_ARRAY = 7\nOP_STRUCT_UNION = 9\nOP_ENUM = 11\nOP_FUNCTION = 13\nOP_FUNCTION_END = 15\nOP_NOOP = 17\nOP_BITFIELD = 19\nOP_TYPENAME = 21\nOP_CPYTHON_BLTN_V = 23 # varargs\nOP_CPYTHON_BLTN_N = 25 # noargs\nOP_CPYTHON_BLTN_O = 27 # O (i.e. a single arg)\nOP_CONSTANT = 29\nOP_CONSTANT_INT = 31\nOP_GLOBAL_VAR = 33\nOP_DLOPEN_FUNC = 35\nOP_DLOPEN_CONST = 37\nOP_GLOBAL_VAR_F = 39\nOP_EXTERN_PYTHON = 41\n\nPRIM_VOID = 0\nPRIM_BOOL = 1\nPRIM_CHAR = 2\nPRIM_SCHAR = 3\nPRIM_UCHAR = 4\nPRIM_SHORT = 5\nPRIM_USHORT = 6\nPRIM_INT = 7\nPRIM_UINT = 8\nPRIM_LONG = 9\nPRIM_ULONG = 10\nPRIM_LONGLONG = 11\nPRIM_ULONGLONG = 12\nPRIM_FLOAT = 13\nPRIM_DOUBLE = 14\nPRIM_LONGDOUBLE = 15\n\nPRIM_WCHAR = 16\nPRIM_INT8 = 17\nPRIM_UINT8 = 18\nPRIM_INT16 = 19\nPRIM_UINT16 = 20\nPRIM_INT32 = 21\nPRIM_UINT32 = 22\nPRIM_INT64 = 23\nPRIM_UINT64 = 24\nPRIM_INTPTR = 25\nPRIM_UINTPTR = 26\nPRIM_PTRDIFF = 27\nPRIM_SIZE = 28\nPRIM_SSIZE = 29\nPRIM_INT_LEAST8 = 30\nPRIM_UINT_LEAST8 = 31\nPRIM_INT_LEAST16 = 32\nPRIM_UINT_LEAST16 = 33\nPRIM_INT_LEAST32 = 34\nPRIM_UINT_LEAST32 = 35\nPRIM_INT_LEAST64 = 36\nPRIM_UINT_LEAST64 = 37\nPRIM_INT_FAST8 = 38\nPRIM_UINT_FAST8 = 39\nPRIM_INT_FAST16 = 40\nPRIM_UINT_FAST16 = 41\nPRIM_INT_FAST32 = 42\nPRIM_UINT_FAST32 = 43\nPRIM_INT_FAST64 = 44\nPRIM_UINT_FAST64 = 45\nPRIM_INTMAX = 46\nPRIM_UINTMAX = 47\nPRIM_FLOATCOMPLEX = 48\nPRIM_DOUBLECOMPLEX = 49\nPRIM_CHAR16 = 50\nPRIM_CHAR32 = 51\n\n_NUM_PRIM = 52\n_UNKNOWN_PRIM = -1\n_UNKNOWN_FLOAT_PRIM = -2\n_UNKNOWN_LONG_DOUBLE = -3\n\n_IO_FILE_STRUCT = -1\n\nPRIMITIVE_TO_INDEX = {\n 'char': PRIM_CHAR,\n 'short': PRIM_SHORT,\n 'int': PRIM_INT,\n 'long': PRIM_LONG,\n 'long long': PRIM_LONGLONG,\n 'signed char': PRIM_SCHAR,\n 'unsigned char': PRIM_UCHAR,\n 'unsigned short': PRIM_USHORT,\n 'unsigned int': PRIM_UINT,\n 'unsigned long': PRIM_ULONG,\n 'unsigned long long': PRIM_ULONGLONG,\n 'float': PRIM_FLOAT,\n 'double': PRIM_DOUBLE,\n 'long double': PRIM_LONGDOUBLE,\n 'float _Complex': PRIM_FLOATCOMPLEX,\n 'double _Complex': PRIM_DOUBLECOMPLEX,\n '_Bool': PRIM_BOOL,\n 'wchar_t': PRIM_WCHAR,\n 'char16_t': PRIM_CHAR16,\n 'char32_t': PRIM_CHAR32,\n 'int8_t': PRIM_INT8,\n 'uint8_t': PRIM_UINT8,\n 'int16_t': PRIM_INT16,\n 'uint16_t': PRIM_UINT16,\n 'int32_t': PRIM_INT32,\n 'uint32_t': PRIM_UINT32,\n 'int64_t': PRIM_INT64,\n 'uint64_t': PRIM_UINT64,\n 'intptr_t': PRIM_INTPTR,\n 'uintptr_t': PRIM_UINTPTR,\n 'ptrdiff_t': PRIM_PTRDIFF,\n 'size_t': PRIM_SIZE,\n 'ssize_t': PRIM_SSIZE,\n 'int_least8_t': PRIM_INT_LEAST8,\n 'uint_least8_t': PRIM_UINT_LEAST8,\n 'int_least16_t': PRIM_INT_LEAST16,\n 'uint_least16_t': PRIM_UINT_LEAST16,\n 'int_least32_t': PRIM_INT_LEAST32,\n 'uint_least32_t': PRIM_UINT_LEAST32,\n 'int_least64_t': PRIM_INT_LEAST64,\n 'uint_least64_t': PRIM_UINT_LEAST64,\n 'int_fast8_t': PRIM_INT_FAST8,\n 'uint_fast8_t': PRIM_UINT_FAST8,\n 'int_fast16_t': PRIM_INT_FAST16,\n 'uint_fast16_t': PRIM_UINT_FAST16,\n 'int_fast32_t': PRIM_INT_FAST32,\n 'uint_fast32_t': PRIM_UINT_FAST32,\n 'int_fast64_t': PRIM_INT_FAST64,\n 'uint_fast64_t': PRIM_UINT_FAST64,\n 'intmax_t': PRIM_INTMAX,\n 'uintmax_t': PRIM_UINTMAX,\n }\n\nF_UNION = 0x01\nF_CHECK_FIELDS = 0x02\nF_PACKED = 0x04\nF_EXTERNAL = 0x08\nF_OPAQUE = 0x10\n\nG_FLAGS = dict([('_CFFI_' + _key, globals()[_key])\n for _key in ['F_UNION', 'F_CHECK_FIELDS', 'F_PACKED',\n 'F_EXTERNAL', 'F_OPAQUE']])\n\nCLASS_NAME = {}\nfor _name, _value in list(globals().items()):\n if _name.startswith('OP_') and isinstance(_value, int):\n CLASS_NAME[_value] = _name[3:]\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cffi/commontypes.py",
"content": "import sys\nfrom . import model\nfrom .error import FFIError\n\n\nCOMMON_TYPES = {}\n\ntry:\n # fetch \"bool\" and all simple Windows types\n from _cffi_backend import _get_common_types\n _get_common_types(COMMON_TYPES)\nexcept ImportError:\n pass\n\nCOMMON_TYPES['FILE'] = model.unknown_type('FILE', '_IO_FILE')\nCOMMON_TYPES['bool'] = '_Bool' # in case we got ImportError above\n\nfor _type in model.PrimitiveType.ALL_PRIMITIVE_TYPES:\n if _type.endswith('_t'):\n COMMON_TYPES[_type] = _type\ndel _type\n\n_CACHE = {}\n\ndef resolve_common_type(parser, commontype):\n try:\n return _CACHE[commontype]\n except KeyError:\n cdecl = COMMON_TYPES.get(commontype, commontype)\n if not isinstance(cdecl, str):\n result, quals = cdecl, 0 # cdecl is already a BaseType\n elif cdecl in model.PrimitiveType.ALL_PRIMITIVE_TYPES:\n result, quals = model.PrimitiveType(cdecl), 0\n elif cdecl == 'set-unicode-needed':\n raise FFIError(\"The Windows type %r is only available after \"\n \"you call ffi.set_unicode()\" % (commontype,))\n else:\n if commontype == cdecl:\n raise FFIError(\n \"Unsupported type: %r. Please look at \"\n \"http://cffi.readthedocs.io/en/latest/cdef.html#ffi-cdef-limitations \"\n \"and file an issue if you think this type should really \"\n \"be supported.\" % (commontype,))\n result, quals = parser.parse_type_and_quals(cdecl) # recursive\n\n assert isinstance(result, model.BaseTypeByIdentity)\n _CACHE[commontype] = result, quals\n return result, quals\n\n\n# ____________________________________________________________\n# extra types for Windows (most of them are in commontypes.c)\n\n\ndef win_common_types():\n return {\n \"UNICODE_STRING\": model.StructType(\n \"_UNICODE_STRING\",\n [\"Length\",\n \"MaximumLength\",\n \"Buffer\"],\n [model.PrimitiveType(\"unsigned short\"),\n model.PrimitiveType(\"unsigned short\"),\n model.PointerType(model.PrimitiveType(\"wchar_t\"))],\n [-1, -1, -1]),\n \"PUNICODE_STRING\": \"UNICODE_STRING *\",\n \"PCUNICODE_STRING\": \"const UNICODE_STRING *\",\n\n \"TBYTE\": \"set-unicode-needed\",\n \"TCHAR\": \"set-unicode-needed\",\n \"LPCTSTR\": \"set-unicode-needed\",\n \"PCTSTR\": \"set-unicode-needed\",\n \"LPTSTR\": \"set-unicode-needed\",\n \"PTSTR\": \"set-unicode-needed\",\n \"PTBYTE\": \"set-unicode-needed\",\n \"PTCHAR\": \"set-unicode-needed\",\n }\n\nif sys.platform == 'win32':\n COMMON_TYPES.update(win_common_types())\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cffi/cparser.py",
"content": "from . import model\nfrom .commontypes import COMMON_TYPES, resolve_common_type\nfrom .error import FFIError, CDefError\ntry:\n from . import _pycparser as pycparser\nexcept ImportError:\n import pycparser\nimport weakref, re, sys\n\ntry:\n if sys.version_info < (3,):\n import thread as _thread\n else:\n import _thread\n lock = _thread.allocate_lock()\nexcept ImportError:\n lock = None\n\ndef _workaround_for_static_import_finders():\n # Issue #392: packaging tools like cx_Freeze can not find these\n # because pycparser uses exec dynamic import. This is an obscure\n # workaround. This function is never called.\n import pycparser.yacctab\n import pycparser.lextab\n\nCDEF_SOURCE_STRING = \"\"\n_r_comment = re.compile(r\"/\\*.*?\\*/|//([^\\n\\\\]|\\\\.)*?$\",\n re.DOTALL | re.MULTILINE)\n_r_define = re.compile(r\"^\\s*#\\s*define\\s+([A-Za-z_][A-Za-z_0-9]*)\"\n r\"\\b((?:[^\\n\\\\]|\\\\.)*?)$\",\n re.DOTALL | re.MULTILINE)\n_r_partial_enum = re.compile(r\"=\\s*\\.\\.\\.\\s*[,}]|\\.\\.\\.\\s*\\}\")\n_r_enum_dotdotdot = re.compile(r\"__dotdotdot\\d+__$\")\n_r_partial_array = re.compile(r\"\\[\\s*\\.\\.\\.\\s*\\]\")\n_r_words = re.compile(r\"\\w+|\\S\")\n_parser_cache = None\n_r_int_literal = re.compile(r\"-?0?x?[0-9a-f]+[lu]*$\", re.IGNORECASE)\n_r_stdcall1 = re.compile(r\"\\b(__stdcall|WINAPI)\\b\")\n_r_stdcall2 = re.compile(r\"[(]\\s*(__stdcall|WINAPI)\\b\")\n_r_cdecl = re.compile(r\"\\b__cdecl\\b\")\n_r_extern_python = re.compile(r'\\bextern\\s*\"'\n r'(Python|Python\\s*\\+\\s*C|C\\s*\\+\\s*Python)\"\\s*.')\n_r_star_const_space = re.compile( # matches \"* const \"\n r\"[*]\\s*((const|volatile|restrict)\\b\\s*)+\")\n_r_int_dotdotdot = re.compile(r\"(\\b(int|long|short|signed|unsigned|char)\\s*)+\"\n r\"\\.\\.\\.\")\n_r_float_dotdotdot = re.compile(r\"\\b(double|float)\\s*\\.\\.\\.\")\n\ndef _get_parser():\n global _parser_cache\n if _parser_cache is None:\n _parser_cache = pycparser.CParser()\n return _parser_cache\n\ndef _workaround_for_old_pycparser(csource):\n # Workaround for a pycparser issue (fixed between pycparser 2.10 and\n # 2.14): \"char*const***\" gives us a wrong syntax tree, the same as\n # for \"char***(*const)\". This means we can't tell the difference\n # afterwards. But \"char(*const(***))\" gives us the right syntax\n # tree. The issue only occurs if there are several stars in\n # sequence with no parenthesis inbetween, just possibly qualifiers.\n # Attempt to fix it by adding some parentheses in the source: each\n # time we see \"* const\" or \"* const *\", we add an opening\n # parenthesis before each star---the hard part is figuring out where\n # to close them.\n parts = []\n while True:\n match = _r_star_const_space.search(csource)\n if not match:\n break\n #print repr(''.join(parts)+csource), '=>',\n parts.append(csource[:match.start()])\n parts.append('('); closing = ')'\n parts.append(match.group()) # e.g. \"* const \"\n endpos = match.end()\n if csource.startswith('*', endpos):\n parts.append('('); closing += ')'\n level = 0\n i = endpos\n while i < len(csource):\n c = csource[i]\n if c == '(':\n level += 1\n elif c == ')':\n if level == 0:\n break\n level -= 1\n elif c in ',;=':\n if level == 0:\n break\n i += 1\n csource = csource[endpos:i] + closing + csource[i:]\n #print repr(''.join(parts)+csource)\n parts.append(csource)\n return ''.join(parts)\n\ndef _preprocess_extern_python(csource):\n # input: `extern \"Python\" int foo(int);` or\n # `extern \"Python\" { int foo(int); }`\n # output:\n # void __cffi_extern_python_start;\n # int foo(int);\n # void __cffi_extern_python_stop;\n #\n # input: `extern \"Python+C\" int foo(int);`\n # output:\n # void __cffi_extern_python_plus_c_start;\n # int foo(int);\n # void __cffi_extern_python_stop;\n parts = []\n while True:\n match = _r_extern_python.search(csource)\n if not match:\n break\n endpos = match.end() - 1\n #print\n #print ''.join(parts)+csource\n #print '=>'\n parts.append(csource[:match.start()])\n if 'C' in match.group(1):\n parts.append('void __cffi_extern_python_plus_c_start; ')\n else:\n parts.append('void __cffi_extern_python_start; ')\n if csource[endpos] == '{':\n # grouping variant\n closing = csource.find('}', endpos)\n if closing < 0:\n raise CDefError(\"'extern \\\"Python\\\" {': no '}' found\")\n if csource.find('{', endpos + 1, closing) >= 0:\n raise NotImplementedError(\"cannot use { } inside a block \"\n \"'extern \\\"Python\\\" { ... }'\")\n parts.append(csource[endpos+1:closing])\n csource = csource[closing+1:]\n else:\n # non-grouping variant\n semicolon = csource.find(';', endpos)\n if semicolon < 0:\n raise CDefError(\"'extern \\\"Python\\\": no ';' found\")\n parts.append(csource[endpos:semicolon+1])\n csource = csource[semicolon+1:]\n parts.append(' void __cffi_extern_python_stop;')\n #print ''.join(parts)+csource\n #print\n parts.append(csource)\n return ''.join(parts)\n\ndef _warn_for_string_literal(csource):\n if '\"' not in csource:\n return\n for line in csource.splitlines():\n if '\"' in line and not line.lstrip().startswith('#'):\n import warnings\n warnings.warn(\"String literal found in cdef() or type source. \"\n \"String literals are ignored here, but you should \"\n \"remove them anyway because some character sequences \"\n \"confuse pre-parsing.\")\n break\n\ndef _warn_for_non_extern_non_static_global_variable(decl):\n if not decl.storage:\n import warnings\n warnings.warn(\"Declaration of global variable '%s' in cdef() should \"\n \"be marked 'extern' for consistency (or possibly \"\n \"'static' in API mode)\" % (decl.name,))\n\ndef _preprocess(csource):\n # Remove comments. NOTE: this only work because the cdef() section\n # should not contain any string literal!\n csource = _r_comment.sub(' ', csource)\n # Remove the \"#define FOO x\" lines\n macros = {}\n for match in _r_define.finditer(csource):\n macroname, macrovalue = match.groups()\n macrovalue = macrovalue.replace('\\\\\\n', '').strip()\n macros[macroname] = macrovalue\n csource = _r_define.sub('', csource)\n #\n if pycparser.__version__ < '2.14':\n csource = _workaround_for_old_pycparser(csource)\n #\n # BIG HACK: replace WINAPI or __stdcall with \"volatile const\".\n # It doesn't make sense for the return type of a function to be\n # \"volatile volatile const\", so we abuse it to detect __stdcall...\n # Hack number 2 is that \"int(volatile *fptr)();\" is not valid C\n # syntax, so we place the \"volatile\" before the opening parenthesis.\n csource = _r_stdcall2.sub(' volatile volatile const(', csource)\n csource = _r_stdcall1.sub(' volatile volatile const ', csource)\n csource = _r_cdecl.sub(' ', csource)\n #\n # Replace `extern \"Python\"` with start/end markers\n csource = _preprocess_extern_python(csource)\n #\n # Now there should not be any string literal left; warn if we get one\n _warn_for_string_literal(csource)\n #\n # Replace \"[...]\" with \"[__dotdotdotarray__]\"\n csource = _r_partial_array.sub('[__dotdotdotarray__]', csource)\n #\n # Replace \"...}\" with \"__dotdotdotNUM__}\". This construction should\n # occur only at the end of enums; at the end of structs we have \"...;}\"\n # and at the end of vararg functions \"...);\". Also replace \"=...[,}]\"\n # with \",__dotdotdotNUM__[,}]\": this occurs in the enums too, when\n # giving an unknown value.\n matches = list(_r_partial_enum.finditer(csource))\n for number, match in enumerate(reversed(matches)):\n p = match.start()\n if csource[p] == '=':\n p2 = csource.find('...', p, match.end())\n assert p2 > p\n csource = '%s,__dotdotdot%d__ %s' % (csource[:p], number,\n csource[p2+3:])\n else:\n assert csource[p:p+3] == '...'\n csource = '%s __dotdotdot%d__ %s' % (csource[:p], number,\n csource[p+3:])\n # Replace \"int ...\" or \"unsigned long int...\" with \"__dotdotdotint__\"\n csource = _r_int_dotdotdot.sub(' __dotdotdotint__ ', csource)\n # Replace \"float ...\" or \"double...\" with \"__dotdotdotfloat__\"\n csource = _r_float_dotdotdot.sub(' __dotdotdotfloat__ ', csource)\n # Replace all remaining \"...\" with the same name, \"__dotdotdot__\",\n # which is declared with a typedef for the purpose of C parsing.\n return csource.replace('...', ' __dotdotdot__ '), macros\n\ndef _common_type_names(csource):\n # Look in the source for what looks like usages of types from the\n # list of common types. A \"usage\" is approximated here as the\n # appearance of the word, minus a \"definition\" of the type, which\n # is the last word in a \"typedef\" statement. Approximative only\n # but should be fine for all the common types.\n look_for_words = set(COMMON_TYPES)\n look_for_words.add(';')\n look_for_words.add(',')\n look_for_words.add('(')\n look_for_words.add(')')\n look_for_words.add('typedef')\n words_used = set()\n is_typedef = False\n paren = 0\n previous_word = ''\n for word in _r_words.findall(csource):\n if word in look_for_words:\n if word == ';':\n if is_typedef:\n words_used.discard(previous_word)\n look_for_words.discard(previous_word)\n is_typedef = False\n elif word == 'typedef':\n is_typedef = True\n paren = 0\n elif word == '(':\n paren += 1\n elif word == ')':\n paren -= 1\n elif word == ',':\n if is_typedef and paren == 0:\n words_used.discard(previous_word)\n look_for_words.discard(previous_word)\n else: # word in COMMON_TYPES\n words_used.add(word)\n previous_word = word\n return words_used\n\n\nclass Parser(object):\n\n def __init__(self):\n self._declarations = {}\n self._included_declarations = set()\n self._anonymous_counter = 0\n self._structnode2type = weakref.WeakKeyDictionary()\n self._options = {}\n self._int_constants = {}\n self._recomplete = []\n self._uses_new_feature = None\n\n def _parse(self, csource):\n csource, macros = _preprocess(csource)\n # XXX: for more efficiency we would need to poke into the\n # internals of CParser... the following registers the\n # typedefs, because their presence or absence influences the\n # parsing itself (but what they are typedef'ed to plays no role)\n ctn = _common_type_names(csource)\n typenames = []\n for name in sorted(self._declarations):\n if name.startswith('typedef '):\n name = name[8:]\n typenames.append(name)\n ctn.discard(name)\n typenames += sorted(ctn)\n #\n csourcelines = []\n csourcelines.append('# 1 \"\"')\n for typename in typenames:\n csourcelines.append('typedef int %s;' % typename)\n csourcelines.append('typedef int __dotdotdotint__, __dotdotdotfloat__,'\n ' __dotdotdot__;')\n # this forces pycparser to consider the following in the file\n # called from line 1\n csourcelines.append('# 1 \"%s\"' % (CDEF_SOURCE_STRING,))\n csourcelines.append(csource)\n fullcsource = '\\n'.join(csourcelines)\n if lock is not None:\n lock.acquire() # pycparser is not thread-safe...\n try:\n ast = _get_parser().parse(fullcsource)\n except pycparser.c_parser.ParseError as e:\n self.convert_pycparser_error(e, csource)\n finally:\n if lock is not None:\n lock.release()\n # csource will be used to find buggy source text\n return ast, macros, csource\n\n def _convert_pycparser_error(self, e, csource):\n # xxx look for \":NUM:\" at the start of str(e)\n # and interpret that as a line number. This will not work if\n # the user gives explicit ``# NUM \"FILE\"`` directives.\n line = None\n msg = str(e)\n match = re.match(r\"%s:(\\d+):\" % (CDEF_SOURCE_STRING,), msg)\n if match:\n linenum = int(match.group(1), 10)\n csourcelines = csource.splitlines()\n if 1 <= linenum <= len(csourcelines):\n line = csourcelines[linenum-1]\n return line\n\n def convert_pycparser_error(self, e, csource):\n line = self._convert_pycparser_error(e, csource)\n\n msg = str(e)\n if line:\n msg = 'cannot parse \"%s\"\\n%s' % (line.strip(), msg)\n else:\n msg = 'parse error\\n%s' % (msg,)\n raise CDefError(msg)\n\n def parse(self, csource, override=False, packed=False, pack=None,\n dllexport=False):\n if packed:\n if packed != True:\n raise ValueError(\"'packed' should be False or True; use \"\n \"'pack' to give another value\")\n if pack:\n raise ValueError(\"cannot give both 'pack' and 'packed'\")\n pack = 1\n elif pack:\n if pack & (pack - 1):\n raise ValueError(\"'pack' must be a power of two, not %r\" %\n (pack,))\n else:\n pack = 0\n prev_options = self._options\n try:\n self._options = {'override': override,\n 'packed': pack,\n 'dllexport': dllexport}\n self._internal_parse(csource)\n finally:\n self._options = prev_options\n\n def _internal_parse(self, csource):\n ast, macros, csource = self._parse(csource)\n # add the macros\n self._process_macros(macros)\n # find the first \"__dotdotdot__\" and use that as a separator\n # between the repeated typedefs and the real csource\n iterator = iter(ast.ext)\n for decl in iterator:\n if decl.name == '__dotdotdot__':\n break\n else:\n assert 0\n current_decl = None\n #\n try:\n self._inside_extern_python = '__cffi_extern_python_stop'\n for decl in iterator:\n current_decl = decl\n if isinstance(decl, pycparser.c_ast.Decl):\n self._parse_decl(decl)\n elif isinstance(decl, pycparser.c_ast.Typedef):\n if not decl.name:\n raise CDefError(\"typedef does not declare any name\",\n decl)\n quals = 0\n if (isinstance(decl.type.type, pycparser.c_ast.IdentifierType) and\n decl.type.type.names[-1].startswith('__dotdotdot')):\n realtype = self._get_unknown_type(decl)\n elif (isinstance(decl.type, pycparser.c_ast.PtrDecl) and\n isinstance(decl.type.type, pycparser.c_ast.TypeDecl) and\n isinstance(decl.type.type.type,\n pycparser.c_ast.IdentifierType) and\n decl.type.type.type.names[-1].startswith('__dotdotdot')):\n realtype = self._get_unknown_ptr_type(decl)\n else:\n realtype, quals = self._get_type_and_quals(\n decl.type, name=decl.name, partial_length_ok=True)\n self._declare('typedef ' + decl.name, realtype, quals=quals)\n elif decl.__class__.__name__ == 'Pragma':\n pass # skip pragma, only in pycparser 2.15\n else:\n raise CDefError(\"unexpected <%s>: this construct is valid \"\n \"C but not valid in cdef()\" %\n decl.__class__.__name__, decl)\n except CDefError as e:\n if len(e.args) == 1:\n e.args = e.args + (current_decl,)\n raise\n except FFIError as e:\n msg = self._convert_pycparser_error(e, csource)\n if msg:\n e.args = (e.args[0] + \"\\n *** Err: %s\" % msg,)\n raise\n\n def _add_constants(self, key, val):\n if key in self._int_constants:\n if self._int_constants[key] == val:\n return # ignore identical double declarations\n raise FFIError(\n \"multiple declarations of constant: %s\" % (key,))\n self._int_constants[key] = val\n\n def _add_integer_constant(self, name, int_str):\n int_str = int_str.lower().rstrip(\"ul\")\n neg = int_str.startswith('-')\n if neg:\n int_str = int_str[1:]\n # \"010\" is not valid oct in py3\n if (int_str.startswith(\"0\") and int_str != '0'\n and not int_str.startswith(\"0x\")):\n int_str = \"0o\" + int_str[1:]\n pyvalue = int(int_str, 0)\n if neg:\n pyvalue = -pyvalue\n self._add_constants(name, pyvalue)\n self._declare('macro ' + name, pyvalue)\n\n def _process_macros(self, macros):\n for key, value in macros.items():\n value = value.strip()\n if _r_int_literal.match(value):\n self._add_integer_constant(key, value)\n elif value == '...':\n self._declare('macro ' + key, value)\n else:\n raise CDefError(\n 'only supports one of the following syntax:\\n'\n ' #define %s ... (literally dot-dot-dot)\\n'\n ' #define %s NUMBER (with NUMBER an integer'\n ' constant, decimal/hex/octal)\\n'\n 'got:\\n'\n ' #define %s %s'\n % (key, key, key, value))\n\n def _declare_function(self, tp, quals, decl):\n tp = self._get_type_pointer(tp, quals)\n if self._options.get('dllexport'):\n tag = 'dllexport_python '\n elif self._inside_extern_python == '__cffi_extern_python_start':\n tag = 'extern_python '\n elif self._inside_extern_python == '__cffi_extern_python_plus_c_start':\n tag = 'extern_python_plus_c '\n else:\n tag = 'function '\n self._declare(tag + decl.name, tp)\n\n def _parse_decl(self, decl):\n node = decl.type\n if isinstance(node, pycparser.c_ast.FuncDecl):\n tp, quals = self._get_type_and_quals(node, name=decl.name)\n assert isinstance(tp, model.RawFunctionType)\n self._declare_function(tp, quals, decl)\n else:\n if isinstance(node, pycparser.c_ast.Struct):\n self._get_struct_union_enum_type('struct', node)\n elif isinstance(node, pycparser.c_ast.Union):\n self._get_struct_union_enum_type('union', node)\n elif isinstance(node, pycparser.c_ast.Enum):\n self._get_struct_union_enum_type('enum', node)\n elif not decl.name:\n raise CDefError(\"construct does not declare any variable\",\n decl)\n #\n if decl.name:\n tp, quals = self._get_type_and_quals(node,\n partial_length_ok=True)\n if tp.is_raw_function:\n self._declare_function(tp, quals, decl)\n elif (tp.is_integer_type() and\n hasattr(decl, 'init') and\n hasattr(decl.init, 'value') and\n _r_int_literal.match(decl.init.value)):\n self._add_integer_constant(decl.name, decl.init.value)\n elif (tp.is_integer_type() and\n isinstance(decl.init, pycparser.c_ast.UnaryOp) and\n decl.init.op == '-' and\n hasattr(decl.init.expr, 'value') and\n _r_int_literal.match(decl.init.expr.value)):\n self._add_integer_constant(decl.name,\n '-' + decl.init.expr.value)\n elif (tp is model.void_type and\n decl.name.startswith('__cffi_extern_python_')):\n # hack: `extern \"Python\"` in the C source is replaced\n # with \"void __cffi_extern_python_start;\" and\n # \"void __cffi_extern_python_stop;\"\n self._inside_extern_python = decl.name\n else:\n if self._inside_extern_python !='__cffi_extern_python_stop':\n raise CDefError(\n \"cannot declare constants or \"\n \"variables with 'extern \\\"Python\\\"'\")\n if (quals & model.Q_CONST) and not tp.is_array_type:\n self._declare('constant ' + decl.name, tp, quals=quals)\n else:\n _warn_for_non_extern_non_static_global_variable(decl)\n self._declare('variable ' + decl.name, tp, quals=quals)\n\n def parse_type(self, cdecl):\n return self.parse_type_and_quals(cdecl)[0]\n\n def parse_type_and_quals(self, cdecl):\n ast, macros = self._parse('void __dummy(\\n%s\\n);' % cdecl)[:2]\n assert not macros\n exprnode = ast.ext[-1].type.args.params[0]\n if isinstance(exprnode, pycparser.c_ast.ID):\n raise CDefError(\"unknown identifier '%s'\" % (exprnode.name,))\n return self._get_type_and_quals(exprnode.type)\n\n def _declare(self, name, obj, included=False, quals=0):\n if name in self._declarations:\n prevobj, prevquals = self._declarations[name]\n if prevobj is obj and prevquals == quals:\n return\n if not self._options.get('override'):\n raise FFIError(\n \"multiple declarations of %s (for interactive usage, \"\n \"try cdef(xx, override=True))\" % (name,))\n assert '__dotdotdot__' not in name.split()\n self._declarations[name] = (obj, quals)\n if included:\n self._included_declarations.add(obj)\n\n def _extract_quals(self, type):\n quals = 0\n if isinstance(type, (pycparser.c_ast.TypeDecl,\n pycparser.c_ast.PtrDecl)):\n if 'const' in type.quals:\n quals |= model.Q_CONST\n if 'volatile' in type.quals:\n quals |= model.Q_VOLATILE\n if 'restrict' in type.quals:\n quals |= model.Q_RESTRICT\n return quals\n\n def _get_type_pointer(self, type, quals, declname=None):\n if isinstance(type, model.RawFunctionType):\n return type.as_function_pointer()\n if (isinstance(type, model.StructOrUnionOrEnum) and\n type.name.startswith('$') and type.name[1:].isdigit() and\n type.forcename is None and declname is not None):\n return model.NamedPointerType(type, declname, quals)\n return model.PointerType(type, quals)\n\n def _get_type_and_quals(self, typenode, name=None, partial_length_ok=False):\n # first, dereference typedefs, if we have it already parsed, we're good\n if (isinstance(typenode, pycparser.c_ast.TypeDecl) and\n isinstance(typenode.type, pycparser.c_ast.IdentifierType) and\n len(typenode.type.names) == 1 and\n ('typedef ' + typenode.type.names[0]) in self._declarations):\n tp, quals = self._declarations['typedef ' + typenode.type.names[0]]\n quals |= self._extract_quals(typenode)\n return tp, quals\n #\n if isinstance(typenode, pycparser.c_ast.ArrayDecl):\n # array type\n if typenode.dim is None:\n length = None\n else:\n length = self._parse_constant(\n typenode.dim, partial_length_ok=partial_length_ok)\n tp, quals = self._get_type_and_quals(typenode.type,\n partial_length_ok=partial_length_ok)\n return model.ArrayType(tp, length), quals\n #\n if isinstance(typenode, pycparser.c_ast.PtrDecl):\n # pointer type\n itemtype, itemquals = self._get_type_and_quals(typenode.type)\n tp = self._get_type_pointer(itemtype, itemquals, declname=name)\n quals = self._extract_quals(typenode)\n return tp, quals\n #\n if isinstance(typenode, pycparser.c_ast.TypeDecl):\n quals = self._extract_quals(typenode)\n type = typenode.type\n if isinstance(type, pycparser.c_ast.IdentifierType):\n # assume a primitive type. get it from .names, but reduce\n # synonyms to a single chosen combination\n names = list(type.names)\n if names != ['signed', 'char']: # keep this unmodified\n prefixes = {}\n while names:\n name = names[0]\n if name in ('short', 'long', 'signed', 'unsigned'):\n prefixes[name] = prefixes.get(name, 0) + 1\n del names[0]\n else:\n break\n # ignore the 'signed' prefix below, and reorder the others\n newnames = []\n for prefix in ('unsigned', 'short', 'long'):\n for i in range(prefixes.get(prefix, 0)):\n newnames.append(prefix)\n if not names:\n names = ['int'] # implicitly\n if names == ['int']: # but kill it if 'short' or 'long'\n if 'short' in prefixes or 'long' in prefixes:\n names = []\n names = newnames + names\n ident = ' '.join(names)\n if ident == 'void':\n return model.void_type, quals\n if ident == '__dotdotdot__':\n raise FFIError(':%d: bad usage of \"...\"' %\n typenode.coord.line)\n tp0, quals0 = resolve_common_type(self, ident)\n return tp0, (quals | quals0)\n #\n if isinstance(type, pycparser.c_ast.Struct):\n # 'struct foobar'\n tp = self._get_struct_union_enum_type('struct', type, name)\n return tp, quals\n #\n if isinstance(type, pycparser.c_ast.Union):\n # 'union foobar'\n tp = self._get_struct_union_enum_type('union', type, name)\n return tp, quals\n #\n if isinstance(type, pycparser.c_ast.Enum):\n # 'enum foobar'\n tp = self._get_struct_union_enum_type('enum', type, name)\n return tp, quals\n #\n if isinstance(typenode, pycparser.c_ast.FuncDecl):\n # a function type\n return self._parse_function_type(typenode, name), 0\n #\n # nested anonymous structs or unions end up here\n if isinstance(typenode, pycparser.c_ast.Struct):\n return self._get_struct_union_enum_type('struct', typenode, name,\n nested=True), 0\n if isinstance(typenode, pycparser.c_ast.Union):\n return self._get_struct_union_enum_type('union', typenode, name,\n nested=True), 0\n #\n raise FFIError(\":%d: bad or unsupported type declaration\" %\n typenode.coord.line)\n\n def _parse_function_type(self, typenode, funcname=None):\n params = list(getattr(typenode.args, 'params', []))\n for i, arg in enumerate(params):\n if not hasattr(arg, 'type'):\n raise CDefError(\"%s arg %d: unknown type '%s'\"\n \" (if you meant to use the old C syntax of giving\"\n \" untyped arguments, it is not supported)\"\n % (funcname or 'in expression', i + 1,\n getattr(arg, 'name', '?')))\n ellipsis = (\n len(params) > 0 and\n isinstance(params[-1].type, pycparser.c_ast.TypeDecl) and\n isinstance(params[-1].type.type,\n pycparser.c_ast.IdentifierType) and\n params[-1].type.type.names == ['__dotdotdot__'])\n if ellipsis:\n params.pop()\n if not params:\n raise CDefError(\n \"%s: a function with only '(...)' as argument\"\n \" is not correct C\" % (funcname or 'in expression'))\n args = [self._as_func_arg(*self._get_type_and_quals(argdeclnode.type))\n for argdeclnode in params]\n if not ellipsis and args == [model.void_type]:\n args = []\n result, quals = self._get_type_and_quals(typenode.type)\n # the 'quals' on the result type are ignored. HACK: we absure them\n # to detect __stdcall functions: we textually replace \"__stdcall\"\n # with \"volatile volatile const\" above.\n abi = None\n if hasattr(typenode.type, 'quals'): # else, probable syntax error anyway\n if typenode.type.quals[-3:] == ['volatile', 'volatile', 'const']:\n abi = '__stdcall'\n return model.RawFunctionType(tuple(args), result, ellipsis, abi)\n\n def _as_func_arg(self, type, quals):\n if isinstance(type, model.ArrayType):\n return model.PointerType(type.item, quals)\n elif isinstance(type, model.RawFunctionType):\n return type.as_function_pointer()\n else:\n return type\n\n def _get_struct_union_enum_type(self, kind, type, name=None, nested=False):\n # First, a level of caching on the exact 'type' node of the AST.\n # This is obscure, but needed because pycparser \"unrolls\" declarations\n # such as \"typedef struct { } foo_t, *foo_p\" and we end up with\n # an AST that is not a tree, but a DAG, with the \"type\" node of the\n # two branches foo_t and foo_p of the trees being the same node.\n # It's a bit silly but detecting \"DAG-ness\" in the AST tree seems\n # to be the only way to distinguish this case from two independent\n # structs. See test_struct_with_two_usages.\n try:\n return self._structnode2type[type]\n except KeyError:\n pass\n #\n # Note that this must handle parsing \"struct foo\" any number of\n # times and always return the same StructType object. Additionally,\n # one of these times (not necessarily the first), the fields of\n # the struct can be specified with \"struct foo { ...fields... }\".\n # If no name is given, then we have to create a new anonymous struct\n # with no caching; in this case, the fields are either specified\n # right now or never.\n #\n force_name = name\n name = type.name\n #\n # get the type or create it if needed\n if name is None:\n # 'force_name' is used to guess a more readable name for\n # anonymous structs, for the common case \"typedef struct { } foo\".\n if force_name is not None:\n explicit_name = '$%s' % force_name\n else:\n self._anonymous_counter += 1\n explicit_name = '$%d' % self._anonymous_counter\n tp = None\n else:\n explicit_name = name\n key = '%s %s' % (kind, name)\n tp, _ = self._declarations.get(key, (None, None))\n #\n if tp is None:\n if kind == 'struct':\n tp = model.StructType(explicit_name, None, None, None)\n elif kind == 'union':\n tp = model.UnionType(explicit_name, None, None, None)\n elif kind == 'enum':\n if explicit_name == '__dotdotdot__':\n raise CDefError(\"Enums cannot be declared with ...\")\n tp = self._build_enum_type(explicit_name, type.values)\n else:\n raise AssertionError(\"kind = %r\" % (kind,))\n if name is not None:\n self._declare(key, tp)\n else:\n if kind == 'enum' and type.values is not None:\n raise NotImplementedError(\n \"enum %s: the '{}' declaration should appear on the first \"\n \"time the enum is mentioned, not later\" % explicit_name)\n if not tp.forcename:\n tp.force_the_name(force_name)\n if tp.forcename and '$' in tp.name:\n self._declare('anonymous %s' % tp.forcename, tp)\n #\n self._structnode2type[type] = tp\n #\n # enums: done here\n if kind == 'enum':\n return tp\n #\n # is there a 'type.decls'? If yes, then this is the place in the\n # C sources that declare the fields. If no, then just return the\n # existing type, possibly still incomplete.\n if type.decls is None:\n return tp\n #\n if tp.fldnames is not None:\n raise CDefError(\"duplicate declaration of struct %s\" % name)\n fldnames = []\n fldtypes = []\n fldbitsize = []\n fldquals = []\n for decl in type.decls:\n if (isinstance(decl.type, pycparser.c_ast.IdentifierType) and\n ''.join(decl.type.names) == '__dotdotdot__'):\n # XXX pycparser is inconsistent: 'names' should be a list\n # of strings, but is sometimes just one string. Use\n # str.join() as a way to cope with both.\n self._make_partial(tp, nested)\n continue\n if decl.bitsize is None:\n bitsize = -1\n else:\n bitsize = self._parse_constant(decl.bitsize)\n self._partial_length = False\n type, fqual = self._get_type_and_quals(decl.type,\n partial_length_ok=True)\n if self._partial_length:\n self._make_partial(tp, nested)\n if isinstance(type, model.StructType) and type.partial:\n self._make_partial(tp, nested)\n fldnames.append(decl.name or '')\n fldtypes.append(type)\n fldbitsize.append(bitsize)\n fldquals.append(fqual)\n tp.fldnames = tuple(fldnames)\n tp.fldtypes = tuple(fldtypes)\n tp.fldbitsize = tuple(fldbitsize)\n tp.fldquals = tuple(fldquals)\n if fldbitsize != [-1] * len(fldbitsize):\n if isinstance(tp, model.StructType) and tp.partial:\n raise NotImplementedError(\"%s: using both bitfields and '...;'\"\n % (tp,))\n tp.packed = self._options.get('packed')\n if tp.completed: # must be re-completed: it is not opaque any more\n tp.completed = 0\n self._recomplete.append(tp)\n return tp\n\n def _make_partial(self, tp, nested):\n if not isinstance(tp, model.StructOrUnion):\n raise CDefError(\"%s cannot be partial\" % (tp,))\n if not tp.has_c_name() and not nested:\n raise NotImplementedError(\"%s is partial but has no C name\" %(tp,))\n tp.partial = True\n\n def _parse_constant(self, exprnode, partial_length_ok=False):\n # for now, limited to expressions that are an immediate number\n # or positive/negative number\n if isinstance(exprnode, pycparser.c_ast.Constant):\n s = exprnode.value\n if '0' <= s[0] <= '9':\n s = s.rstrip('uUlL')\n try:\n if s.startswith('0'):\n return int(s, 8)\n else:\n return int(s, 10)\n except ValueError:\n if len(s) > 1:\n if s.lower()[0:2] == '0x':\n return int(s, 16)\n elif s.lower()[0:2] == '0b':\n return int(s, 2)\n raise CDefError(\"invalid constant %r\" % (s,))\n elif s[0] == \"'\" and s[-1] == \"'\" and (\n len(s) == 3 or (len(s) == 4 and s[1] == \"\\\\\")):\n return ord(s[-2])\n else:\n raise CDefError(\"invalid constant %r\" % (s,))\n #\n if (isinstance(exprnode, pycparser.c_ast.UnaryOp) and\n exprnode.op == '+'):\n return self._parse_constant(exprnode.expr)\n #\n if (isinstance(exprnode, pycparser.c_ast.UnaryOp) and\n exprnode.op == '-'):\n return -self._parse_constant(exprnode.expr)\n # load previously defined int constant\n if (isinstance(exprnode, pycparser.c_ast.ID) and\n exprnode.name in self._int_constants):\n return self._int_constants[exprnode.name]\n #\n if (isinstance(exprnode, pycparser.c_ast.ID) and\n exprnode.name == '__dotdotdotarray__'):\n if partial_length_ok:\n self._partial_length = True\n return '...'\n raise FFIError(\":%d: unsupported '[...]' here, cannot derive \"\n \"the actual array length in this context\"\n % exprnode.coord.line)\n #\n if isinstance(exprnode, pycparser.c_ast.BinaryOp):\n left = self._parse_constant(exprnode.left)\n right = self._parse_constant(exprnode.right)\n if exprnode.op == '+':\n return left + right\n elif exprnode.op == '-':\n return left - right\n elif exprnode.op == '*':\n return left * right\n elif exprnode.op == '/':\n return self._c_div(left, right)\n elif exprnode.op == '%':\n return left - self._c_div(left, right) * right\n elif exprnode.op == '<<':\n return left << right\n elif exprnode.op == '>>':\n return left >> right\n elif exprnode.op == '&':\n return left & right\n elif exprnode.op == '|':\n return left | right\n elif exprnode.op == '^':\n return left ^ right\n #\n raise FFIError(\":%d: unsupported expression: expected a \"\n \"simple numeric constant\" % exprnode.coord.line)\n\n def _c_div(self, a, b):\n result = a // b\n if ((a < 0) ^ (b < 0)) and (a % b) != 0:\n result += 1\n return result\n\n def _build_enum_type(self, explicit_name, decls):\n if decls is not None:\n partial = False\n enumerators = []\n enumvalues = []\n nextenumvalue = 0\n for enum in decls.enumerators:\n if _r_enum_dotdotdot.match(enum.name):\n partial = True\n continue\n if enum.value is not None:\n nextenumvalue = self._parse_constant(enum.value)\n enumerators.append(enum.name)\n enumvalues.append(nextenumvalue)\n self._add_constants(enum.name, nextenumvalue)\n nextenumvalue += 1\n enumerators = tuple(enumerators)\n enumvalues = tuple(enumvalues)\n tp = model.EnumType(explicit_name, enumerators, enumvalues)\n tp.partial = partial\n else: # opaque enum\n tp = model.EnumType(explicit_name, (), ())\n return tp\n\n def include(self, other):\n for name, (tp, quals) in other._declarations.items():\n if name.startswith('anonymous $enum_$'):\n continue # fix for test_anonymous_enum_include\n kind = name.split(' ', 1)[0]\n if kind in ('struct', 'union', 'enum', 'anonymous', 'typedef'):\n self._declare(name, tp, included=True, quals=quals)\n for k, v in other._int_constants.items():\n self._add_constants(k, v)\n\n def _get_unknown_type(self, decl):\n typenames = decl.type.type.names\n if typenames == ['__dotdotdot__']:\n return model.unknown_type(decl.name)\n\n if typenames == ['__dotdotdotint__']:\n if self._uses_new_feature is None:\n self._uses_new_feature = \"'typedef int... %s'\" % decl.name\n return model.UnknownIntegerType(decl.name)\n\n if typenames == ['__dotdotdotfloat__']:\n # note: not for 'long double' so far\n if self._uses_new_feature is None:\n self._uses_new_feature = \"'typedef float... %s'\" % decl.name\n return model.UnknownFloatType(decl.name)\n\n raise FFIError(':%d: unsupported usage of \"...\" in typedef'\n % decl.coord.line)\n\n def _get_unknown_ptr_type(self, decl):\n if decl.type.type.type.names == ['__dotdotdot__']:\n return model.unknown_ptr_type(decl.name)\n raise FFIError(':%d: unsupported usage of \"...\" in typedef'\n % decl.coord.line)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cffi/error.py",
"content": "\nclass FFIError(Exception):\n __module__ = 'cffi'\n\nclass CDefError(Exception):\n __module__ = 'cffi'\n def __str__(self):\n try:\n current_decl = self.args[1]\n filename = current_decl.coord.file\n linenum = current_decl.coord.line\n prefix = '%s:%d: ' % (filename, linenum)\n except (AttributeError, TypeError, IndexError):\n prefix = ''\n return '%s%s' % (prefix, self.args[0])\n\nclass VerificationError(Exception):\n \"\"\" An error raised when verification fails\n \"\"\"\n __module__ = 'cffi'\n\nclass VerificationMissing(Exception):\n \"\"\" An error raised when incomplete structures are passed into\n cdef, but no verification has been done\n \"\"\"\n __module__ = 'cffi'\n\nclass PkgConfigError(Exception):\n \"\"\" An error raised for missing modules in pkg-config\n \"\"\"\n __module__ = 'cffi'\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cffi/ffiplatform.py",
"content": "import sys, os\nfrom .error import VerificationError\n\n\nLIST_OF_FILE_NAMES = ['sources', 'include_dirs', 'library_dirs',\n 'extra_objects', 'depends']\n\ndef get_extension(srcfilename, modname, sources=(), **kwds):\n _hack_at_distutils()\n from distutils.core import Extension\n allsources = [srcfilename]\n for src in sources:\n allsources.append(os.path.normpath(src))\n return Extension(name=modname, sources=allsources, **kwds)\n\ndef compile(tmpdir, ext, compiler_verbose=0, debug=None):\n \"\"\"Compile a C extension module using distutils.\"\"\"\n\n _hack_at_distutils()\n saved_environ = os.environ.copy()\n try:\n outputfilename = _build(tmpdir, ext, compiler_verbose, debug)\n outputfilename = os.path.abspath(outputfilename)\n finally:\n # workaround for a distutils bugs where some env vars can\n # become longer and longer every time it is used\n for key, value in saved_environ.items():\n if os.environ.get(key) != value:\n os.environ[key] = value\n return outputfilename\n\ndef _build(tmpdir, ext, compiler_verbose=0, debug=None):\n # XXX compact but horrible :-(\n from distutils.core import Distribution\n import distutils.errors, distutils.log\n #\n dist = Distribution({'ext_modules': [ext]})\n dist.parse_config_files()\n options = dist.get_option_dict('build_ext')\n if debug is None:\n debug = sys.flags.debug\n options['debug'] = ('ffiplatform', debug)\n options['force'] = ('ffiplatform', True)\n options['build_lib'] = ('ffiplatform', tmpdir)\n options['build_temp'] = ('ffiplatform', tmpdir)\n #\n try:\n old_level = distutils.log.set_threshold(0) or 0\n try:\n distutils.log.set_verbosity(compiler_verbose)\n dist.run_command('build_ext')\n cmd_obj = dist.get_command_obj('build_ext')\n [soname] = cmd_obj.get_outputs()\n finally:\n distutils.log.set_threshold(old_level)\n except (distutils.errors.CompileError,\n distutils.errors.LinkError) as e:\n raise VerificationError('%s: %s' % (e.__class__.__name__, e))\n #\n return soname\n\ntry:\n from os.path import samefile\nexcept ImportError:\n def samefile(f1, f2):\n return os.path.abspath(f1) == os.path.abspath(f2)\n\ndef maybe_relative_path(path):\n if not os.path.isabs(path):\n return path # already relative\n dir = path\n names = []\n while True:\n prevdir = dir\n dir, name = os.path.split(prevdir)\n if dir == prevdir or not dir:\n return path # failed to make it relative\n names.append(name)\n try:\n if samefile(dir, os.curdir):\n names.reverse()\n return os.path.join(*names)\n except OSError:\n pass\n\n# ____________________________________________________________\n\ntry:\n int_or_long = (int, long)\n import cStringIO\nexcept NameError:\n int_or_long = int # Python 3\n import io as cStringIO\n\ndef _flatten(x, f):\n if isinstance(x, str):\n f.write('%ds%s' % (len(x), x))\n elif isinstance(x, dict):\n keys = sorted(x.keys())\n f.write('%dd' % len(keys))\n for key in keys:\n _flatten(key, f)\n _flatten(x[key], f)\n elif isinstance(x, (list, tuple)):\n f.write('%dl' % len(x))\n for value in x:\n _flatten(value, f)\n elif isinstance(x, int_or_long):\n f.write('%di' % (x,))\n else:\n raise TypeError(\n \"the keywords to verify() contains unsupported object %r\" % (x,))\n\ndef flatten(x):\n f = cStringIO.StringIO()\n _flatten(x, f)\n return f.getvalue()\n\ndef _hack_at_distutils():\n # Windows-only workaround for some configurations: see\n # https://bugs.python.org/issue23246 (Python 2.7 with \n # a specific MS compiler suite download)\n if sys.platform == \"win32\":\n try:\n import setuptools # for side-effects, patches distutils\n except ImportError:\n pass\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cffi/lock.py",
"content": "import sys\n\nif sys.version_info < (3,):\n try:\n from thread import allocate_lock\n except ImportError:\n from dummy_thread import allocate_lock\nelse:\n try:\n from _thread import allocate_lock\n except ImportError:\n from _dummy_thread import allocate_lock\n\n\n##import sys\n##l1 = allocate_lock\n\n##class allocate_lock(object):\n## def __init__(self):\n## self._real = l1()\n## def __enter__(self):\n## for i in range(4, 0, -1):\n## print sys._getframe(i).f_code\n## print\n## return self._real.__enter__()\n## def __exit__(self, *args):\n## return self._real.__exit__(*args)\n## def acquire(self, f):\n## assert f is False\n## return self._real.acquire(f)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cffi/model.py",
"content": "import types\nimport weakref\n\nfrom .lock import allocate_lock\nfrom .error import CDefError, VerificationError, VerificationMissing\n\n# type qualifiers\nQ_CONST = 0x01\nQ_RESTRICT = 0x02\nQ_VOLATILE = 0x04\n\ndef qualify(quals, replace_with):\n if quals & Q_CONST:\n replace_with = ' const ' + replace_with.lstrip()\n if quals & Q_VOLATILE:\n replace_with = ' volatile ' + replace_with.lstrip()\n if quals & Q_RESTRICT:\n # It seems that __restrict is supported by gcc and msvc.\n # If you hit some different compiler, add a #define in\n # _cffi_include.h for it (and in its copies, documented there)\n replace_with = ' __restrict ' + replace_with.lstrip()\n return replace_with\n\n\nclass BaseTypeByIdentity(object):\n is_array_type = False\n is_raw_function = False\n\n def get_c_name(self, replace_with='', context='a C file', quals=0):\n result = self.c_name_with_marker\n assert result.count('&') == 1\n # some logic duplication with ffi.getctype()... :-(\n replace_with = replace_with.strip()\n if replace_with:\n if replace_with.startswith('*') and '&[' in result:\n replace_with = '(%s)' % replace_with\n elif not replace_with[0] in '[(':\n replace_with = ' ' + replace_with\n replace_with = qualify(quals, replace_with)\n result = result.replace('&', replace_with)\n if '$' in result:\n raise VerificationError(\n \"cannot generate '%s' in %s: unknown type name\"\n % (self._get_c_name(), context))\n return result\n\n def _get_c_name(self):\n return self.c_name_with_marker.replace('&', '')\n\n def has_c_name(self):\n return '$' not in self._get_c_name()\n\n def is_integer_type(self):\n return False\n\n def get_cached_btype(self, ffi, finishlist, can_delay=False):\n try:\n BType = ffi._cached_btypes[self]\n except KeyError:\n BType = self.build_backend_type(ffi, finishlist)\n BType2 = ffi._cached_btypes.setdefault(self, BType)\n assert BType2 is BType\n return BType\n\n def __repr__(self):\n return '<%s>' % (self._get_c_name(),)\n\n def _get_items(self):\n return [(name, getattr(self, name)) for name in self._attrs_]\n\n\nclass BaseType(BaseTypeByIdentity):\n\n def __eq__(self, other):\n return (self.__class__ == other.__class__ and\n self._get_items() == other._get_items())\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash((self.__class__, tuple(self._get_items())))\n\n\nclass VoidType(BaseType):\n _attrs_ = ()\n\n def __init__(self):\n self.c_name_with_marker = 'void&'\n\n def build_backend_type(self, ffi, finishlist):\n return global_cache(self, ffi, 'new_void_type')\n\nvoid_type = VoidType()\n\n\nclass BasePrimitiveType(BaseType):\n def is_complex_type(self):\n return False\n\n\nclass PrimitiveType(BasePrimitiveType):\n _attrs_ = ('name',)\n\n ALL_PRIMITIVE_TYPES = {\n 'char': 'c',\n 'short': 'i',\n 'int': 'i',\n 'long': 'i',\n 'long long': 'i',\n 'signed char': 'i',\n 'unsigned char': 'i',\n 'unsigned short': 'i',\n 'unsigned int': 'i',\n 'unsigned long': 'i',\n 'unsigned long long': 'i',\n 'float': 'f',\n 'double': 'f',\n 'long double': 'f',\n 'float _Complex': 'j',\n 'double _Complex': 'j',\n '_Bool': 'i',\n # the following types are not primitive in the C sense\n 'wchar_t': 'c',\n 'char16_t': 'c',\n 'char32_t': 'c',\n 'int8_t': 'i',\n 'uint8_t': 'i',\n 'int16_t': 'i',\n 'uint16_t': 'i',\n 'int32_t': 'i',\n 'uint32_t': 'i',\n 'int64_t': 'i',\n 'uint64_t': 'i',\n 'int_least8_t': 'i',\n 'uint_least8_t': 'i',\n 'int_least16_t': 'i',\n 'uint_least16_t': 'i',\n 'int_least32_t': 'i',\n 'uint_least32_t': 'i',\n 'int_least64_t': 'i',\n 'uint_least64_t': 'i',\n 'int_fast8_t': 'i',\n 'uint_fast8_t': 'i',\n 'int_fast16_t': 'i',\n 'uint_fast16_t': 'i',\n 'int_fast32_t': 'i',\n 'uint_fast32_t': 'i',\n 'int_fast64_t': 'i',\n 'uint_fast64_t': 'i',\n 'intptr_t': 'i',\n 'uintptr_t': 'i',\n 'intmax_t': 'i',\n 'uintmax_t': 'i',\n 'ptrdiff_t': 'i',\n 'size_t': 'i',\n 'ssize_t': 'i',\n }\n\n def __init__(self, name):\n assert name in self.ALL_PRIMITIVE_TYPES\n self.name = name\n self.c_name_with_marker = name + '&'\n\n def is_char_type(self):\n return self.ALL_PRIMITIVE_TYPES[self.name] == 'c'\n def is_integer_type(self):\n return self.ALL_PRIMITIVE_TYPES[self.name] == 'i'\n def is_float_type(self):\n return self.ALL_PRIMITIVE_TYPES[self.name] == 'f'\n def is_complex_type(self):\n return self.ALL_PRIMITIVE_TYPES[self.name] == 'j'\n\n def build_backend_type(self, ffi, finishlist):\n return global_cache(self, ffi, 'new_primitive_type', self.name)\n\n\nclass UnknownIntegerType(BasePrimitiveType):\n _attrs_ = ('name',)\n\n def __init__(self, name):\n self.name = name\n self.c_name_with_marker = name + '&'\n\n def is_integer_type(self):\n return True\n\n def build_backend_type(self, ffi, finishlist):\n raise NotImplementedError(\"integer type '%s' can only be used after \"\n \"compilation\" % self.name)\n\nclass UnknownFloatType(BasePrimitiveType):\n _attrs_ = ('name', )\n\n def __init__(self, name):\n self.name = name\n self.c_name_with_marker = name + '&'\n\n def build_backend_type(self, ffi, finishlist):\n raise NotImplementedError(\"float type '%s' can only be used after \"\n \"compilation\" % self.name)\n\n\nclass BaseFunctionType(BaseType):\n _attrs_ = ('args', 'result', 'ellipsis', 'abi')\n\n def __init__(self, args, result, ellipsis, abi=None):\n self.args = args\n self.result = result\n self.ellipsis = ellipsis\n self.abi = abi\n #\n reprargs = [arg._get_c_name() for arg in self.args]\n if self.ellipsis:\n reprargs.append('...')\n reprargs = reprargs or ['void']\n replace_with = self._base_pattern % (', '.join(reprargs),)\n if abi is not None:\n replace_with = replace_with[:1] + abi + ' ' + replace_with[1:]\n self.c_name_with_marker = (\n self.result.c_name_with_marker.replace('&', replace_with))\n\n\nclass RawFunctionType(BaseFunctionType):\n # Corresponds to a C type like 'int(int)', which is the C type of\n # a function, but not a pointer-to-function. The backend has no\n # notion of such a type; it's used temporarily by parsing.\n _base_pattern = '(&)(%s)'\n is_raw_function = True\n\n def build_backend_type(self, ffi, finishlist):\n raise CDefError(\"cannot render the type %r: it is a function \"\n \"type, not a pointer-to-function type\" % (self,))\n\n def as_function_pointer(self):\n return FunctionPtrType(self.args, self.result, self.ellipsis, self.abi)\n\n\nclass FunctionPtrType(BaseFunctionType):\n _base_pattern = '(*&)(%s)'\n\n def build_backend_type(self, ffi, finishlist):\n result = self.result.get_cached_btype(ffi, finishlist)\n args = []\n for tp in self.args:\n args.append(tp.get_cached_btype(ffi, finishlist))\n abi_args = ()\n if self.abi == \"__stdcall\":\n if not self.ellipsis: # __stdcall ignored for variadic funcs\n try:\n abi_args = (ffi._backend.FFI_STDCALL,)\n except AttributeError:\n pass\n return global_cache(self, ffi, 'new_function_type',\n tuple(args), result, self.ellipsis, *abi_args)\n\n def as_raw_function(self):\n return RawFunctionType(self.args, self.result, self.ellipsis, self.abi)\n\n\nclass PointerType(BaseType):\n _attrs_ = ('totype', 'quals')\n\n def __init__(self, totype, quals=0):\n self.totype = totype\n self.quals = quals\n extra = qualify(quals, \" *&\")\n if totype.is_array_type:\n extra = \"(%s)\" % (extra.lstrip(),)\n self.c_name_with_marker = totype.c_name_with_marker.replace('&', extra)\n\n def build_backend_type(self, ffi, finishlist):\n BItem = self.totype.get_cached_btype(ffi, finishlist, can_delay=True)\n return global_cache(self, ffi, 'new_pointer_type', BItem)\n\nvoidp_type = PointerType(void_type)\n\ndef ConstPointerType(totype):\n return PointerType(totype, Q_CONST)\n\nconst_voidp_type = ConstPointerType(void_type)\n\n\nclass NamedPointerType(PointerType):\n _attrs_ = ('totype', 'name')\n\n def __init__(self, totype, name, quals=0):\n PointerType.__init__(self, totype, quals)\n self.name = name\n self.c_name_with_marker = name + '&'\n\n\nclass ArrayType(BaseType):\n _attrs_ = ('item', 'length')\n is_array_type = True\n\n def __init__(self, item, length):\n self.item = item\n self.length = length\n #\n if length is None:\n brackets = '&[]'\n elif length == '...':\n brackets = '&[/*...*/]'\n else:\n brackets = '&[%s]' % length\n self.c_name_with_marker = (\n self.item.c_name_with_marker.replace('&', brackets))\n\n def resolve_length(self, newlength):\n return ArrayType(self.item, newlength)\n\n def build_backend_type(self, ffi, finishlist):\n if self.length == '...':\n raise CDefError(\"cannot render the type %r: unknown length\" %\n (self,))\n self.item.get_cached_btype(ffi, finishlist) # force the item BType\n BPtrItem = PointerType(self.item).get_cached_btype(ffi, finishlist)\n return global_cache(self, ffi, 'new_array_type', BPtrItem, self.length)\n\nchar_array_type = ArrayType(PrimitiveType('char'), None)\n\n\nclass StructOrUnionOrEnum(BaseTypeByIdentity):\n _attrs_ = ('name',)\n forcename = None\n\n def build_c_name_with_marker(self):\n name = self.forcename or '%s %s' % (self.kind, self.name)\n self.c_name_with_marker = name + '&'\n\n def force_the_name(self, forcename):\n self.forcename = forcename\n self.build_c_name_with_marker()\n\n def get_official_name(self):\n assert self.c_name_with_marker.endswith('&')\n return self.c_name_with_marker[:-1]\n\n\nclass StructOrUnion(StructOrUnionOrEnum):\n fixedlayout = None\n completed = 0\n partial = False\n packed = 0\n\n def __init__(self, name, fldnames, fldtypes, fldbitsize, fldquals=None):\n self.name = name\n self.fldnames = fldnames\n self.fldtypes = fldtypes\n self.fldbitsize = fldbitsize\n self.fldquals = fldquals\n self.build_c_name_with_marker()\n\n def anonymous_struct_fields(self):\n if self.fldtypes is not None:\n for name, type in zip(self.fldnames, self.fldtypes):\n if name == '' and isinstance(type, StructOrUnion):\n yield type\n\n def enumfields(self, expand_anonymous_struct_union=True):\n fldquals = self.fldquals\n if fldquals is None:\n fldquals = (0,) * len(self.fldnames)\n for name, type, bitsize, quals in zip(self.fldnames, self.fldtypes,\n self.fldbitsize, fldquals):\n if (name == '' and isinstance(type, StructOrUnion)\n and expand_anonymous_struct_union):\n # nested anonymous struct/union\n for result in type.enumfields():\n yield result\n else:\n yield (name, type, bitsize, quals)\n\n def force_flatten(self):\n # force the struct or union to have a declaration that lists\n # directly all fields returned by enumfields(), flattening\n # nested anonymous structs/unions.\n names = []\n types = []\n bitsizes = []\n fldquals = []\n for name, type, bitsize, quals in self.enumfields():\n names.append(name)\n types.append(type)\n bitsizes.append(bitsize)\n fldquals.append(quals)\n self.fldnames = tuple(names)\n self.fldtypes = tuple(types)\n self.fldbitsize = tuple(bitsizes)\n self.fldquals = tuple(fldquals)\n\n def get_cached_btype(self, ffi, finishlist, can_delay=False):\n BType = StructOrUnionOrEnum.get_cached_btype(self, ffi, finishlist,\n can_delay)\n if not can_delay:\n self.finish_backend_type(ffi, finishlist)\n return BType\n\n def finish_backend_type(self, ffi, finishlist):\n if self.completed:\n if self.completed != 2:\n raise NotImplementedError(\"recursive structure declaration \"\n \"for '%s'\" % (self.name,))\n return\n BType = ffi._cached_btypes[self]\n #\n self.completed = 1\n #\n if self.fldtypes is None:\n pass # not completing it: it's an opaque struct\n #\n elif self.fixedlayout is None:\n fldtypes = [tp.get_cached_btype(ffi, finishlist)\n for tp in self.fldtypes]\n lst = list(zip(self.fldnames, fldtypes, self.fldbitsize))\n extra_flags = ()\n if self.packed:\n if self.packed == 1:\n extra_flags = (8,) # SF_PACKED\n else:\n extra_flags = (0, self.packed)\n ffi._backend.complete_struct_or_union(BType, lst, self,\n -1, -1, *extra_flags)\n #\n else:\n fldtypes = []\n fieldofs, fieldsize, totalsize, totalalignment = self.fixedlayout\n for i in range(len(self.fldnames)):\n fsize = fieldsize[i]\n ftype = self.fldtypes[i]\n #\n if isinstance(ftype, ArrayType) and ftype.length == '...':\n # fix the length to match the total size\n BItemType = ftype.item.get_cached_btype(ffi, finishlist)\n nlen, nrest = divmod(fsize, ffi.sizeof(BItemType))\n if nrest != 0:\n self._verification_error(\n \"field '%s.%s' has a bogus size?\" % (\n self.name, self.fldnames[i] or '{}'))\n ftype = ftype.resolve_length(nlen)\n self.fldtypes = (self.fldtypes[:i] + (ftype,) +\n self.fldtypes[i+1:])\n #\n BFieldType = ftype.get_cached_btype(ffi, finishlist)\n if isinstance(ftype, ArrayType) and ftype.length is None:\n assert fsize == 0\n else:\n bitemsize = ffi.sizeof(BFieldType)\n if bitemsize != fsize:\n self._verification_error(\n \"field '%s.%s' is declared as %d bytes, but is \"\n \"really %d bytes\" % (self.name,\n self.fldnames[i] or '{}',\n bitemsize, fsize))\n fldtypes.append(BFieldType)\n #\n lst = list(zip(self.fldnames, fldtypes, self.fldbitsize, fieldofs))\n ffi._backend.complete_struct_or_union(BType, lst, self,\n totalsize, totalalignment)\n self.completed = 2\n\n def _verification_error(self, msg):\n raise VerificationError(msg)\n\n def check_not_partial(self):\n if self.partial and self.fixedlayout is None:\n raise VerificationMissing(self._get_c_name())\n\n def build_backend_type(self, ffi, finishlist):\n self.check_not_partial()\n finishlist.append(self)\n #\n return global_cache(self, ffi, 'new_%s_type' % self.kind,\n self.get_official_name(), key=self)\n\n\nclass StructType(StructOrUnion):\n kind = 'struct'\n\n\nclass UnionType(StructOrUnion):\n kind = 'union'\n\n\nclass EnumType(StructOrUnionOrEnum):\n kind = 'enum'\n partial = False\n partial_resolved = False\n\n def __init__(self, name, enumerators, enumvalues, baseinttype=None):\n self.name = name\n self.enumerators = enumerators\n self.enumvalues = enumvalues\n self.baseinttype = baseinttype\n self.build_c_name_with_marker()\n\n def force_the_name(self, forcename):\n StructOrUnionOrEnum.force_the_name(self, forcename)\n if self.forcename is None:\n name = self.get_official_name()\n self.forcename = '$' + name.replace(' ', '_')\n\n def check_not_partial(self):\n if self.partial and not self.partial_resolved:\n raise VerificationMissing(self._get_c_name())\n\n def build_backend_type(self, ffi, finishlist):\n self.check_not_partial()\n base_btype = self.build_baseinttype(ffi, finishlist)\n return global_cache(self, ffi, 'new_enum_type',\n self.get_official_name(),\n self.enumerators, self.enumvalues,\n base_btype, key=self)\n\n def build_baseinttype(self, ffi, finishlist):\n if self.baseinttype is not None:\n return self.baseinttype.get_cached_btype(ffi, finishlist)\n #\n if self.enumvalues:\n smallest_value = min(self.enumvalues)\n largest_value = max(self.enumvalues)\n else:\n import warnings\n try:\n # XXX! The goal is to ensure that the warnings.warn()\n # will not suppress the warning. We want to get it\n # several times if we reach this point several times.\n __warningregistry__.clear()\n except NameError:\n pass\n warnings.warn(\"%r has no values explicitly defined; \"\n \"guessing that it is equivalent to 'unsigned int'\"\n % self._get_c_name())\n smallest_value = largest_value = 0\n if smallest_value < 0: # needs a signed type\n sign = 1\n candidate1 = PrimitiveType(\"int\")\n candidate2 = PrimitiveType(\"long\")\n else:\n sign = 0\n candidate1 = PrimitiveType(\"unsigned int\")\n candidate2 = PrimitiveType(\"unsigned long\")\n btype1 = candidate1.get_cached_btype(ffi, finishlist)\n btype2 = candidate2.get_cached_btype(ffi, finishlist)\n size1 = ffi.sizeof(btype1)\n size2 = ffi.sizeof(btype2)\n if (smallest_value >= ((-1) << (8*size1-1)) and\n largest_value < (1 << (8*size1-sign))):\n return btype1\n if (smallest_value >= ((-1) << (8*size2-1)) and\n largest_value < (1 << (8*size2-sign))):\n return btype2\n raise CDefError(\"%s values don't all fit into either 'long' \"\n \"or 'unsigned long'\" % self._get_c_name())\n\ndef unknown_type(name, structname=None):\n if structname is None:\n structname = '$%s' % name\n tp = StructType(structname, None, None, None)\n tp.force_the_name(name)\n tp.origin = \"unknown_type\"\n return tp\n\ndef unknown_ptr_type(name, structname=None):\n if structname is None:\n structname = '$$%s' % name\n tp = StructType(structname, None, None, None)\n return NamedPointerType(tp, name)\n\n\nglobal_lock = allocate_lock()\n_typecache_cffi_backend = weakref.WeakValueDictionary()\n\ndef get_typecache(backend):\n # returns _typecache_cffi_backend if backend is the _cffi_backend\n # module, or type(backend).__typecache if backend is an instance of\n # CTypesBackend (or some FakeBackend class during tests)\n if isinstance(backend, types.ModuleType):\n return _typecache_cffi_backend\n with global_lock:\n if not hasattr(type(backend), '__typecache'):\n type(backend).__typecache = weakref.WeakValueDictionary()\n return type(backend).__typecache\n\ndef global_cache(srctype, ffi, funcname, *args, **kwds):\n key = kwds.pop('key', (funcname, args))\n assert not kwds\n try:\n return ffi._typecache[key]\n except KeyError:\n pass\n try:\n res = getattr(ffi._backend, funcname)(*args)\n except NotImplementedError as e:\n raise NotImplementedError(\"%s: %r: %s\" % (funcname, srctype, e))\n # note that setdefault() on WeakValueDictionary is not atomic\n # and contains a rare bug (http://bugs.python.org/issue19542);\n # we have to use a lock and do it ourselves\n cache = ffi._typecache\n with global_lock:\n res1 = cache.get(key)\n if res1 is None:\n cache[key] = res\n return res\n else:\n return res1\n\ndef pointer_cache(ffi, BType):\n return global_cache('?', ffi, 'new_pointer_type', BType)\n\ndef attach_exception_info(e, name):\n if e.args and type(e.args[0]) is str:\n e.args = ('%s: %s' % (name, e.args[0]),) + e.args[1:]\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cffi/parse_c_type.h",
"content": "\n/* This part is from file 'cffi/parse_c_type.h'. It is copied at the\n beginning of C sources generated by CFFI's ffi.set_source(). */\n\ntypedef void *_cffi_opcode_t;\n\n#define _CFFI_OP(opcode, arg) (_cffi_opcode_t)(opcode | (((uintptr_t)(arg)) << 8))\n#define _CFFI_GETOP(cffi_opcode) ((unsigned char)(uintptr_t)cffi_opcode)\n#define _CFFI_GETARG(cffi_opcode) (((intptr_t)cffi_opcode) >> 8)\n\n#define _CFFI_OP_PRIMITIVE 1\n#define _CFFI_OP_POINTER 3\n#define _CFFI_OP_ARRAY 5\n#define _CFFI_OP_OPEN_ARRAY 7\n#define _CFFI_OP_STRUCT_UNION 9\n#define _CFFI_OP_ENUM 11\n#define _CFFI_OP_FUNCTION 13\n#define _CFFI_OP_FUNCTION_END 15\n#define _CFFI_OP_NOOP 17\n#define _CFFI_OP_BITFIELD 19\n#define _CFFI_OP_TYPENAME 21\n#define _CFFI_OP_CPYTHON_BLTN_V 23 // varargs\n#define _CFFI_OP_CPYTHON_BLTN_N 25 // noargs\n#define _CFFI_OP_CPYTHON_BLTN_O 27 // O (i.e. a single arg)\n#define _CFFI_OP_CONSTANT 29\n#define _CFFI_OP_CONSTANT_INT 31\n#define _CFFI_OP_GLOBAL_VAR 33\n#define _CFFI_OP_DLOPEN_FUNC 35\n#define _CFFI_OP_DLOPEN_CONST 37\n#define _CFFI_OP_GLOBAL_VAR_F 39\n#define _CFFI_OP_EXTERN_PYTHON 41\n\n#define _CFFI_PRIM_VOID 0\n#define _CFFI_PRIM_BOOL 1\n#define _CFFI_PRIM_CHAR 2\n#define _CFFI_PRIM_SCHAR 3\n#define _CFFI_PRIM_UCHAR 4\n#define _CFFI_PRIM_SHORT 5\n#define _CFFI_PRIM_USHORT 6\n#define _CFFI_PRIM_INT 7\n#define _CFFI_PRIM_UINT 8\n#define _CFFI_PRIM_LONG 9\n#define _CFFI_PRIM_ULONG 10\n#define _CFFI_PRIM_LONGLONG 11\n#define _CFFI_PRIM_ULONGLONG 12\n#define _CFFI_PRIM_FLOAT 13\n#define _CFFI_PRIM_DOUBLE 14\n#define _CFFI_PRIM_LONGDOUBLE 15\n\n#define _CFFI_PRIM_WCHAR 16\n#define _CFFI_PRIM_INT8 17\n#define _CFFI_PRIM_UINT8 18\n#define _CFFI_PRIM_INT16 19\n#define _CFFI_PRIM_UINT16 20\n#define _CFFI_PRIM_INT32 21\n#define _CFFI_PRIM_UINT32 22\n#define _CFFI_PRIM_INT64 23\n#define _CFFI_PRIM_UINT64 24\n#define _CFFI_PRIM_INTPTR 25\n#define _CFFI_PRIM_UINTPTR 26\n#define _CFFI_PRIM_PTRDIFF 27\n#define _CFFI_PRIM_SIZE 28\n#define _CFFI_PRIM_SSIZE 29\n#define _CFFI_PRIM_INT_LEAST8 30\n#define _CFFI_PRIM_UINT_LEAST8 31\n#define _CFFI_PRIM_INT_LEAST16 32\n#define _CFFI_PRIM_UINT_LEAST16 33\n#define _CFFI_PRIM_INT_LEAST32 34\n#define _CFFI_PRIM_UINT_LEAST32 35\n#define _CFFI_PRIM_INT_LEAST64 36\n#define _CFFI_PRIM_UINT_LEAST64 37\n#define _CFFI_PRIM_INT_FAST8 38\n#define _CFFI_PRIM_UINT_FAST8 39\n#define _CFFI_PRIM_INT_FAST16 40\n#define _CFFI_PRIM_UINT_FAST16 41\n#define _CFFI_PRIM_INT_FAST32 42\n#define _CFFI_PRIM_UINT_FAST32 43\n#define _CFFI_PRIM_INT_FAST64 44\n#define _CFFI_PRIM_UINT_FAST64 45\n#define _CFFI_PRIM_INTMAX 46\n#define _CFFI_PRIM_UINTMAX 47\n#define _CFFI_PRIM_FLOATCOMPLEX 48\n#define _CFFI_PRIM_DOUBLECOMPLEX 49\n#define _CFFI_PRIM_CHAR16 50\n#define _CFFI_PRIM_CHAR32 51\n\n#define _CFFI__NUM_PRIM 52\n#define _CFFI__UNKNOWN_PRIM (-1)\n#define _CFFI__UNKNOWN_FLOAT_PRIM (-2)\n#define _CFFI__UNKNOWN_LONG_DOUBLE (-3)\n\n#define _CFFI__IO_FILE_STRUCT (-1)\n\n\nstruct _cffi_global_s {\n const char *name;\n void *address;\n _cffi_opcode_t type_op;\n void *size_or_direct_fn; // OP_GLOBAL_VAR: size, or 0 if unknown\n // OP_CPYTHON_BLTN_*: addr of direct function\n};\n\nstruct _cffi_getconst_s {\n unsigned long long value;\n const struct _cffi_type_context_s *ctx;\n int gindex;\n};\n\nstruct _cffi_struct_union_s {\n const char *name;\n int type_index; // -> _cffi_types, on a OP_STRUCT_UNION\n int flags; // _CFFI_F_* flags below\n size_t size;\n int alignment;\n int first_field_index; // -> _cffi_fields array\n int num_fields;\n};\n#define _CFFI_F_UNION 0x01 // is a union, not a struct\n#define _CFFI_F_CHECK_FIELDS 0x02 // complain if fields are not in the\n // \"standard layout\" or if some are missing\n#define _CFFI_F_PACKED 0x04 // for CHECK_FIELDS, assume a packed struct\n#define _CFFI_F_EXTERNAL 0x08 // in some other ffi.include()\n#define _CFFI_F_OPAQUE 0x10 // opaque\n\nstruct _cffi_field_s {\n const char *name;\n size_t field_offset;\n size_t field_size;\n _cffi_opcode_t field_type_op;\n};\n\nstruct _cffi_enum_s {\n const char *name;\n int type_index; // -> _cffi_types, on a OP_ENUM\n int type_prim; // _CFFI_PRIM_xxx\n const char *enumerators; // comma-delimited string\n};\n\nstruct _cffi_typename_s {\n const char *name;\n int type_index; /* if opaque, points to a possibly artificial\n OP_STRUCT which is itself opaque */\n};\n\nstruct _cffi_type_context_s {\n _cffi_opcode_t *types;\n const struct _cffi_global_s *globals;\n const struct _cffi_field_s *fields;\n const struct _cffi_struct_union_s *struct_unions;\n const struct _cffi_enum_s *enums;\n const struct _cffi_typename_s *typenames;\n int num_globals;\n int num_struct_unions;\n int num_enums;\n int num_typenames;\n const char *const *includes;\n int num_types;\n int flags; /* future extension */\n};\n\nstruct _cffi_parse_info_s {\n const struct _cffi_type_context_s *ctx;\n _cffi_opcode_t *output;\n unsigned int output_size;\n size_t error_location;\n const char *error_message;\n};\n\nstruct _cffi_externpy_s {\n const char *name;\n size_t size_of_result;\n void *reserved1, *reserved2;\n};\n\n#ifdef _CFFI_INTERNAL\nstatic int parse_c_type(struct _cffi_parse_info_s *info, const char *input);\nstatic int search_in_globals(const struct _cffi_type_context_s *ctx,\n const char *search, size_t search_len);\nstatic int search_in_struct_unions(const struct _cffi_type_context_s *ctx,\n const char *search, size_t search_len);\n#endif\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cffi/pkgconfig.py",
"content": "# pkg-config, https://www.freedesktop.org/wiki/Software/pkg-config/ integration for cffi\nimport sys, os, subprocess\n\nfrom .error import PkgConfigError\n\n\ndef merge_flags(cfg1, cfg2):\n \"\"\"Merge values from cffi config flags cfg2 to cf1\n\n Example:\n merge_flags({\"libraries\": [\"one\"]}, {\"libraries\": [\"two\"]})\n {\"libraries\": [\"one\", \"two\"]}\n \"\"\"\n for key, value in cfg2.items():\n if key not in cfg1:\n cfg1[key] = value\n else:\n if not isinstance(cfg1[key], list):\n raise TypeError(\"cfg1[%r] should be a list of strings\" % (key,))\n if not isinstance(value, list):\n raise TypeError(\"cfg2[%r] should be a list of strings\" % (key,))\n cfg1[key].extend(value)\n return cfg1\n\n\ndef call(libname, flag, encoding=sys.getfilesystemencoding()):\n \"\"\"Calls pkg-config and returns the output if found\n \"\"\"\n a = [\"pkg-config\", \"--print-errors\"]\n a.append(flag)\n a.append(libname)\n try:\n pc = subprocess.Popen(a, stdout=subprocess.PIPE, stderr=subprocess.PIPE)\n except EnvironmentError as e:\n raise PkgConfigError(\"cannot run pkg-config: %s\" % (str(e).strip(),))\n\n bout, berr = pc.communicate()\n if pc.returncode != 0:\n try:\n berr = berr.decode(encoding)\n except Exception:\n pass\n raise PkgConfigError(berr.strip())\n\n if sys.version_info >= (3,) and not isinstance(bout, str): # Python 3.x\n try:\n bout = bout.decode(encoding)\n except UnicodeDecodeError:\n raise PkgConfigError(\"pkg-config %s %s returned bytes that cannot \"\n \"be decoded with encoding %r:\\n%r\" %\n (flag, libname, encoding, bout))\n\n if os.altsep != '\\\\' and '\\\\' in bout:\n raise PkgConfigError(\"pkg-config %s %s returned an unsupported \"\n \"backslash-escaped output:\\n%r\" %\n (flag, libname, bout))\n return bout\n\n\ndef flags_from_pkgconfig(libs):\n r\"\"\"Return compiler line flags for FFI.set_source based on pkg-config output\n\n Usage\n ...\n ffibuilder.set_source(\"_foo\", pkgconfig = [\"libfoo\", \"libbar >= 1.8.3\"])\n\n If pkg-config is installed on build machine, then arguments include_dirs,\n library_dirs, libraries, define_macros, extra_compile_args and\n extra_link_args are extended with an output of pkg-config for libfoo and\n libbar.\n\n Raises PkgConfigError in case the pkg-config call fails.\n \"\"\"\n\n def get_include_dirs(string):\n return [x[2:] for x in string.split() if x.startswith(\"-I\")]\n\n def get_library_dirs(string):\n return [x[2:] for x in string.split() if x.startswith(\"-L\")]\n\n def get_libraries(string):\n return [x[2:] for x in string.split() if x.startswith(\"-l\")]\n\n # convert -Dfoo=bar to list of tuples [(\"foo\", \"bar\")] expected by distutils\n def get_macros(string):\n def _macro(x):\n x = x[2:] # drop \"-D\"\n if '=' in x:\n return tuple(x.split(\"=\", 1)) # \"-Dfoo=bar\" => (\"foo\", \"bar\")\n else:\n return (x, None) # \"-Dfoo\" => (\"foo\", None)\n return [_macro(x) for x in string.split() if x.startswith(\"-D\")]\n\n def get_other_cflags(string):\n return [x for x in string.split() if not x.startswith(\"-I\") and\n not x.startswith(\"-D\")]\n\n def get_other_libs(string):\n return [x for x in string.split() if not x.startswith(\"-L\") and\n not x.startswith(\"-l\")]\n\n # return kwargs for given libname\n def kwargs(libname):\n fse = sys.getfilesystemencoding()\n all_cflags = call(libname, \"--cflags\")\n all_libs = call(libname, \"--libs\")\n return {\n \"include_dirs\": get_include_dirs(all_cflags),\n \"library_dirs\": get_library_dirs(all_libs),\n \"libraries\": get_libraries(all_libs),\n \"define_macros\": get_macros(all_cflags),\n \"extra_compile_args\": get_other_cflags(all_cflags),\n \"extra_link_args\": get_other_libs(all_libs),\n }\n\n # merge all arguments together\n ret = {}\n for libname in libs:\n lib_flags = kwargs(libname)\n merge_flags(ret, lib_flags)\n return ret\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cffi/recompiler.py",
"content": "import os, sys, io\nfrom . import ffiplatform, model\nfrom .error import VerificationError\nfrom .cffi_opcode import *\n\nVERSION_BASE = 0x2601\nVERSION_EMBEDDED = 0x2701\nVERSION_CHAR16CHAR32 = 0x2801\n\n\nclass GlobalExpr:\n def __init__(self, name, address, type_op, size=0, check_value=0):\n self.name = name\n self.address = address\n self.type_op = type_op\n self.size = size\n self.check_value = check_value\n\n def as_c_expr(self):\n return ' { \"%s\", (void *)%s, %s, (void *)%s },' % (\n self.name, self.address, self.type_op.as_c_expr(), self.size)\n\n def as_python_expr(self):\n return \"b'%s%s',%d\" % (self.type_op.as_python_bytes(), self.name,\n self.check_value)\n\nclass FieldExpr:\n def __init__(self, name, field_offset, field_size, fbitsize, field_type_op):\n self.name = name\n self.field_offset = field_offset\n self.field_size = field_size\n self.fbitsize = fbitsize\n self.field_type_op = field_type_op\n\n def as_c_expr(self):\n spaces = \" \" * len(self.name)\n return (' { \"%s\", %s,\\n' % (self.name, self.field_offset) +\n ' %s %s,\\n' % (spaces, self.field_size) +\n ' %s %s },' % (spaces, self.field_type_op.as_c_expr()))\n\n def as_python_expr(self):\n raise NotImplementedError\n\n def as_field_python_expr(self):\n if self.field_type_op.op == OP_NOOP:\n size_expr = ''\n elif self.field_type_op.op == OP_BITFIELD:\n size_expr = format_four_bytes(self.fbitsize)\n else:\n raise NotImplementedError\n return \"b'%s%s%s'\" % (self.field_type_op.as_python_bytes(),\n size_expr,\n self.name)\n\nclass StructUnionExpr:\n def __init__(self, name, type_index, flags, size, alignment, comment,\n first_field_index, c_fields):\n self.name = name\n self.type_index = type_index\n self.flags = flags\n self.size = size\n self.alignment = alignment\n self.comment = comment\n self.first_field_index = first_field_index\n self.c_fields = c_fields\n\n def as_c_expr(self):\n return (' { \"%s\", %d, %s,' % (self.name, self.type_index, self.flags)\n + '\\n %s, %s, ' % (self.size, self.alignment)\n + '%d, %d ' % (self.first_field_index, len(self.c_fields))\n + ('/* %s */ ' % self.comment if self.comment else '')\n + '},')\n\n def as_python_expr(self):\n flags = eval(self.flags, G_FLAGS)\n fields_expr = [c_field.as_field_python_expr()\n for c_field in self.c_fields]\n return \"(b'%s%s%s',%s)\" % (\n format_four_bytes(self.type_index),\n format_four_bytes(flags),\n self.name,\n ','.join(fields_expr))\n\nclass EnumExpr:\n def __init__(self, name, type_index, size, signed, allenums):\n self.name = name\n self.type_index = type_index\n self.size = size\n self.signed = signed\n self.allenums = allenums\n\n def as_c_expr(self):\n return (' { \"%s\", %d, _cffi_prim_int(%s, %s),\\n'\n ' \"%s\" },' % (self.name, self.type_index,\n self.size, self.signed, self.allenums))\n\n def as_python_expr(self):\n prim_index = {\n (1, 0): PRIM_UINT8, (1, 1): PRIM_INT8,\n (2, 0): PRIM_UINT16, (2, 1): PRIM_INT16,\n (4, 0): PRIM_UINT32, (4, 1): PRIM_INT32,\n (8, 0): PRIM_UINT64, (8, 1): PRIM_INT64,\n }[self.size, self.signed]\n return \"b'%s%s%s\\\\x00%s'\" % (format_four_bytes(self.type_index),\n format_four_bytes(prim_index),\n self.name, self.allenums)\n\nclass TypenameExpr:\n def __init__(self, name, type_index):\n self.name = name\n self.type_index = type_index\n\n def as_c_expr(self):\n return ' { \"%s\", %d },' % (self.name, self.type_index)\n\n def as_python_expr(self):\n return \"b'%s%s'\" % (format_four_bytes(self.type_index), self.name)\n\n\n# ____________________________________________________________\n\n\nclass Recompiler:\n _num_externpy = 0\n\n def __init__(self, ffi, module_name, target_is_python=False):\n self.ffi = ffi\n self.module_name = module_name\n self.target_is_python = target_is_python\n self._version = VERSION_BASE\n\n def needs_version(self, ver):\n self._version = max(self._version, ver)\n\n def collect_type_table(self):\n self._typesdict = {}\n self._generate(\"collecttype\")\n #\n all_decls = sorted(self._typesdict, key=str)\n #\n # prepare all FUNCTION bytecode sequences first\n self.cffi_types = []\n for tp in all_decls:\n if tp.is_raw_function:\n assert self._typesdict[tp] is None\n self._typesdict[tp] = len(self.cffi_types)\n self.cffi_types.append(tp) # placeholder\n for tp1 in tp.args:\n assert isinstance(tp1, (model.VoidType,\n model.BasePrimitiveType,\n model.PointerType,\n model.StructOrUnionOrEnum,\n model.FunctionPtrType))\n if self._typesdict[tp1] is None:\n self._typesdict[tp1] = len(self.cffi_types)\n self.cffi_types.append(tp1) # placeholder\n self.cffi_types.append('END') # placeholder\n #\n # prepare all OTHER bytecode sequences\n for tp in all_decls:\n if not tp.is_raw_function and self._typesdict[tp] is None:\n self._typesdict[tp] = len(self.cffi_types)\n self.cffi_types.append(tp) # placeholder\n if tp.is_array_type and tp.length is not None:\n self.cffi_types.append('LEN') # placeholder\n assert None not in self._typesdict.values()\n #\n # collect all structs and unions and enums\n self._struct_unions = {}\n self._enums = {}\n for tp in all_decls:\n if isinstance(tp, model.StructOrUnion):\n self._struct_unions[tp] = None\n elif isinstance(tp, model.EnumType):\n self._enums[tp] = None\n for i, tp in enumerate(sorted(self._struct_unions,\n key=lambda tp: tp.name)):\n self._struct_unions[tp] = i\n for i, tp in enumerate(sorted(self._enums,\n key=lambda tp: tp.name)):\n self._enums[tp] = i\n #\n # emit all bytecode sequences now\n for tp in all_decls:\n method = getattr(self, '_emit_bytecode_' + tp.__class__.__name__)\n method(tp, self._typesdict[tp])\n #\n # consistency check\n for op in self.cffi_types:\n assert isinstance(op, CffiOp)\n self.cffi_types = tuple(self.cffi_types) # don't change any more\n\n def _do_collect_type(self, tp):\n if not isinstance(tp, model.BaseTypeByIdentity):\n if isinstance(tp, tuple):\n for x in tp:\n self._do_collect_type(x)\n return\n if tp not in self._typesdict:\n self._typesdict[tp] = None\n if isinstance(tp, model.FunctionPtrType):\n self._do_collect_type(tp.as_raw_function())\n elif isinstance(tp, model.StructOrUnion):\n if tp.fldtypes is not None and (\n tp not in self.ffi._parser._included_declarations):\n for name1, tp1, _, _ in tp.enumfields():\n self._do_collect_type(self._field_type(tp, name1, tp1))\n else:\n for _, x in tp._get_items():\n self._do_collect_type(x)\n\n def _generate(self, step_name):\n lst = self.ffi._parser._declarations.items()\n for name, (tp, quals) in sorted(lst):\n kind, realname = name.split(' ', 1)\n try:\n method = getattr(self, '_generate_cpy_%s_%s' % (kind,\n step_name))\n except AttributeError:\n raise VerificationError(\n \"not implemented in recompile(): %r\" % name)\n try:\n self._current_quals = quals\n method(tp, realname)\n except Exception as e:\n model.attach_exception_info(e, name)\n raise\n\n # ----------\n\n ALL_STEPS = [\"global\", \"field\", \"struct_union\", \"enum\", \"typename\"]\n\n def collect_step_tables(self):\n # collect the declarations for '_cffi_globals', '_cffi_typenames', etc.\n self._lsts = {}\n for step_name in self.ALL_STEPS:\n self._lsts[step_name] = []\n self._seen_struct_unions = set()\n self._generate(\"ctx\")\n self._add_missing_struct_unions()\n #\n for step_name in self.ALL_STEPS:\n lst = self._lsts[step_name]\n if step_name != \"field\":\n lst.sort(key=lambda entry: entry.name)\n self._lsts[step_name] = tuple(lst) # don't change any more\n #\n # check for a possible internal inconsistency: _cffi_struct_unions\n # should have been generated with exactly self._struct_unions\n lst = self._lsts[\"struct_union\"]\n for tp, i in self._struct_unions.items():\n assert i < len(lst)\n assert lst[i].name == tp.name\n assert len(lst) == len(self._struct_unions)\n # same with enums\n lst = self._lsts[\"enum\"]\n for tp, i in self._enums.items():\n assert i < len(lst)\n assert lst[i].name == tp.name\n assert len(lst) == len(self._enums)\n\n # ----------\n\n def _prnt(self, what=''):\n self._f.write(what + '\\n')\n\n def write_source_to_f(self, f, preamble):\n if self.target_is_python:\n assert preamble is None\n self.write_py_source_to_f(f)\n else:\n assert preamble is not None\n self.write_c_source_to_f(f, preamble)\n\n def _rel_readlines(self, filename):\n g = open(os.path.join(os.path.dirname(__file__), filename), 'r')\n lines = g.readlines()\n g.close()\n return lines\n\n def write_c_source_to_f(self, f, preamble):\n self._f = f\n prnt = self._prnt\n if self.ffi._embedding is not None:\n prnt('#define _CFFI_USE_EMBEDDING')\n #\n # first the '#include' (actually done by inlining the file's content)\n lines = self._rel_readlines('_cffi_include.h')\n i = lines.index('#include \"parse_c_type.h\"\\n')\n lines[i:i+1] = self._rel_readlines('parse_c_type.h')\n prnt(''.join(lines))\n #\n # if we have ffi._embedding != None, we give it here as a macro\n # and include an extra file\n base_module_name = self.module_name.split('.')[-1]\n if self.ffi._embedding is not None:\n prnt('#define _CFFI_MODULE_NAME \"%s\"' % (self.module_name,))\n prnt('static const char _CFFI_PYTHON_STARTUP_CODE[] = {')\n self._print_string_literal_in_array(self.ffi._embedding)\n prnt('0 };')\n prnt('#ifdef PYPY_VERSION')\n prnt('# define _CFFI_PYTHON_STARTUP_FUNC _cffi_pypyinit_%s' % (\n base_module_name,))\n prnt('#elif PY_MAJOR_VERSION >= 3')\n prnt('# define _CFFI_PYTHON_STARTUP_FUNC PyInit_%s' % (\n base_module_name,))\n prnt('#else')\n prnt('# define _CFFI_PYTHON_STARTUP_FUNC init%s' % (\n base_module_name,))\n prnt('#endif')\n lines = self._rel_readlines('_embedding.h')\n i = lines.index('#include \"_cffi_errors.h\"\\n')\n lines[i:i+1] = self._rel_readlines('_cffi_errors.h')\n prnt(''.join(lines))\n self.needs_version(VERSION_EMBEDDED)\n #\n # then paste the C source given by the user, verbatim.\n prnt('/************************************************************/')\n prnt()\n prnt(preamble)\n prnt()\n prnt('/************************************************************/')\n prnt()\n #\n # the declaration of '_cffi_types'\n prnt('static void *_cffi_types[] = {')\n typeindex2type = dict([(i, tp) for (tp, i) in self._typesdict.items()])\n for i, op in enumerate(self.cffi_types):\n comment = ''\n if i in typeindex2type:\n comment = ' // ' + typeindex2type[i]._get_c_name()\n prnt('/* %2d */ %s,%s' % (i, op.as_c_expr(), comment))\n if not self.cffi_types:\n prnt(' 0')\n prnt('};')\n prnt()\n #\n # call generate_cpy_xxx_decl(), for every xxx found from\n # ffi._parser._declarations. This generates all the functions.\n self._seen_constants = set()\n self._generate(\"decl\")\n #\n # the declaration of '_cffi_globals' and '_cffi_typenames'\n nums = {}\n for step_name in self.ALL_STEPS:\n lst = self._lsts[step_name]\n nums[step_name] = len(lst)\n if nums[step_name] > 0:\n prnt('static const struct _cffi_%s_s _cffi_%ss[] = {' % (\n step_name, step_name))\n for entry in lst:\n prnt(entry.as_c_expr())\n prnt('};')\n prnt()\n #\n # the declaration of '_cffi_includes'\n if self.ffi._included_ffis:\n prnt('static const char * const _cffi_includes[] = {')\n for ffi_to_include in self.ffi._included_ffis:\n try:\n included_module_name, included_source = (\n ffi_to_include._assigned_source[:2])\n except AttributeError:\n raise VerificationError(\n \"ffi object %r includes %r, but the latter has not \"\n \"been prepared with set_source()\" % (\n self.ffi, ffi_to_include,))\n if included_source is None:\n raise VerificationError(\n \"not implemented yet: ffi.include() of a Python-based \"\n \"ffi inside a C-based ffi\")\n prnt(' \"%s\",' % (included_module_name,))\n prnt(' NULL')\n prnt('};')\n prnt()\n #\n # the declaration of '_cffi_type_context'\n prnt('static const struct _cffi_type_context_s _cffi_type_context = {')\n prnt(' _cffi_types,')\n for step_name in self.ALL_STEPS:\n if nums[step_name] > 0:\n prnt(' _cffi_%ss,' % step_name)\n else:\n prnt(' NULL, /* no %ss */' % step_name)\n for step_name in self.ALL_STEPS:\n if step_name != \"field\":\n prnt(' %d, /* num_%ss */' % (nums[step_name], step_name))\n if self.ffi._included_ffis:\n prnt(' _cffi_includes,')\n else:\n prnt(' NULL, /* no includes */')\n prnt(' %d, /* num_types */' % (len(self.cffi_types),))\n flags = 0\n if self._num_externpy:\n flags |= 1 # set to mean that we use extern \"Python\"\n prnt(' %d, /* flags */' % flags)\n prnt('};')\n prnt()\n #\n # the init function\n prnt('#ifdef __GNUC__')\n prnt('# pragma GCC visibility push(default) /* for -fvisibility= */')\n prnt('#endif')\n prnt()\n prnt('#ifdef PYPY_VERSION')\n prnt('PyMODINIT_FUNC')\n prnt('_cffi_pypyinit_%s(const void *p[])' % (base_module_name,))\n prnt('{')\n if self._num_externpy:\n prnt(' if (((intptr_t)p[0]) >= 0x0A03) {')\n prnt(' _cffi_call_python_org = '\n '(void(*)(struct _cffi_externpy_s *, char *))p[1];')\n prnt(' }')\n prnt(' p[0] = (const void *)0x%x;' % self._version)\n prnt(' p[1] = &_cffi_type_context;')\n prnt('#if PY_MAJOR_VERSION >= 3')\n prnt(' return NULL;')\n prnt('#endif')\n prnt('}')\n # on Windows, distutils insists on putting init_cffi_xyz in\n # 'export_symbols', so instead of fighting it, just give up and\n # give it one\n prnt('# ifdef _MSC_VER')\n prnt(' PyMODINIT_FUNC')\n prnt('# if PY_MAJOR_VERSION >= 3')\n prnt(' PyInit_%s(void) { return NULL; }' % (base_module_name,))\n prnt('# else')\n prnt(' init%s(void) { }' % (base_module_name,))\n prnt('# endif')\n prnt('# endif')\n prnt('#elif PY_MAJOR_VERSION >= 3')\n prnt('PyMODINIT_FUNC')\n prnt('PyInit_%s(void)' % (base_module_name,))\n prnt('{')\n prnt(' return _cffi_init(\"%s\", 0x%x, &_cffi_type_context);' % (\n self.module_name, self._version))\n prnt('}')\n prnt('#else')\n prnt('PyMODINIT_FUNC')\n prnt('init%s(void)' % (base_module_name,))\n prnt('{')\n prnt(' _cffi_init(\"%s\", 0x%x, &_cffi_type_context);' % (\n self.module_name, self._version))\n prnt('}')\n prnt('#endif')\n prnt()\n prnt('#ifdef __GNUC__')\n prnt('# pragma GCC visibility pop')\n prnt('#endif')\n self._version = None\n\n def _to_py(self, x):\n if isinstance(x, str):\n return \"b'%s'\" % (x,)\n if isinstance(x, (list, tuple)):\n rep = [self._to_py(item) for item in x]\n if len(rep) == 1:\n rep.append('')\n return \"(%s)\" % (','.join(rep),)\n return x.as_python_expr() # Py2: unicode unexpected; Py3: bytes unexp.\n\n def write_py_source_to_f(self, f):\n self._f = f\n prnt = self._prnt\n #\n # header\n prnt(\"# auto-generated file\")\n prnt(\"import _cffi_backend\")\n #\n # the 'import' of the included ffis\n num_includes = len(self.ffi._included_ffis or ())\n for i in range(num_includes):\n ffi_to_include = self.ffi._included_ffis[i]\n try:\n included_module_name, included_source = (\n ffi_to_include._assigned_source[:2])\n except AttributeError:\n raise VerificationError(\n \"ffi object %r includes %r, but the latter has not \"\n \"been prepared with set_source()\" % (\n self.ffi, ffi_to_include,))\n if included_source is not None:\n raise VerificationError(\n \"not implemented yet: ffi.include() of a C-based \"\n \"ffi inside a Python-based ffi\")\n prnt('from %s import ffi as _ffi%d' % (included_module_name, i))\n prnt()\n prnt(\"ffi = _cffi_backend.FFI('%s',\" % (self.module_name,))\n prnt(\" _version = 0x%x,\" % (self._version,))\n self._version = None\n #\n # the '_types' keyword argument\n self.cffi_types = tuple(self.cffi_types) # don't change any more\n types_lst = [op.as_python_bytes() for op in self.cffi_types]\n prnt(' _types = %s,' % (self._to_py(''.join(types_lst)),))\n typeindex2type = dict([(i, tp) for (tp, i) in self._typesdict.items()])\n #\n # the keyword arguments from ALL_STEPS\n for step_name in self.ALL_STEPS:\n lst = self._lsts[step_name]\n if len(lst) > 0 and step_name != \"field\":\n prnt(' _%ss = %s,' % (step_name, self._to_py(lst)))\n #\n # the '_includes' keyword argument\n if num_includes > 0:\n prnt(' _includes = (%s,),' % (\n ', '.join(['_ffi%d' % i for i in range(num_includes)]),))\n #\n # the footer\n prnt(')')\n\n # ----------\n\n def _gettypenum(self, type):\n # a KeyError here is a bug. please report it! :-)\n return self._typesdict[type]\n\n def _convert_funcarg_to_c(self, tp, fromvar, tovar, errcode):\n extraarg = ''\n if isinstance(tp, model.BasePrimitiveType) and not tp.is_complex_type():\n if tp.is_integer_type() and tp.name != '_Bool':\n converter = '_cffi_to_c_int'\n extraarg = ', %s' % tp.name\n elif isinstance(tp, model.UnknownFloatType):\n # don't check with is_float_type(): it may be a 'long\n # double' here, and _cffi_to_c_double would loose precision\n converter = '(%s)_cffi_to_c_double' % (tp.get_c_name(''),)\n else:\n cname = tp.get_c_name('')\n converter = '(%s)_cffi_to_c_%s' % (cname,\n tp.name.replace(' ', '_'))\n if cname in ('char16_t', 'char32_t'):\n self.needs_version(VERSION_CHAR16CHAR32)\n errvalue = '-1'\n #\n elif isinstance(tp, model.PointerType):\n self._convert_funcarg_to_c_ptr_or_array(tp, fromvar,\n tovar, errcode)\n return\n #\n elif (isinstance(tp, model.StructOrUnionOrEnum) or\n isinstance(tp, model.BasePrimitiveType)):\n # a struct (not a struct pointer) as a function argument;\n # or, a complex (the same code works)\n self._prnt(' if (_cffi_to_c((char *)&%s, _cffi_type(%d), %s) < 0)'\n % (tovar, self._gettypenum(tp), fromvar))\n self._prnt(' %s;' % errcode)\n return\n #\n elif isinstance(tp, model.FunctionPtrType):\n converter = '(%s)_cffi_to_c_pointer' % tp.get_c_name('')\n extraarg = ', _cffi_type(%d)' % self._gettypenum(tp)\n errvalue = 'NULL'\n #\n else:\n raise NotImplementedError(tp)\n #\n self._prnt(' %s = %s(%s%s);' % (tovar, converter, fromvar, extraarg))\n self._prnt(' if (%s == (%s)%s && PyErr_Occurred())' % (\n tovar, tp.get_c_name(''), errvalue))\n self._prnt(' %s;' % errcode)\n\n def _extra_local_variables(self, tp, localvars):\n if isinstance(tp, model.PointerType):\n localvars.add('Py_ssize_t datasize')\n\n def _convert_funcarg_to_c_ptr_or_array(self, tp, fromvar, tovar, errcode):\n self._prnt(' datasize = _cffi_prepare_pointer_call_argument(')\n self._prnt(' _cffi_type(%d), %s, (char **)&%s);' % (\n self._gettypenum(tp), fromvar, tovar))\n self._prnt(' if (datasize != 0) {')\n self._prnt(' if (datasize < 0)')\n self._prnt(' %s;' % errcode)\n self._prnt(' %s = (%s)alloca((size_t)datasize);' % (\n tovar, tp.get_c_name('')))\n self._prnt(' memset((void *)%s, 0, (size_t)datasize);' % (tovar,))\n self._prnt(' if (_cffi_convert_array_from_object('\n '(char *)%s, _cffi_type(%d), %s) < 0)' % (\n tovar, self._gettypenum(tp), fromvar))\n self._prnt(' %s;' % errcode)\n self._prnt(' }')\n\n def _convert_expr_from_c(self, tp, var, context):\n if isinstance(tp, model.BasePrimitiveType):\n if tp.is_integer_type() and tp.name != '_Bool':\n return '_cffi_from_c_int(%s, %s)' % (var, tp.name)\n elif isinstance(tp, model.UnknownFloatType):\n return '_cffi_from_c_double(%s)' % (var,)\n elif tp.name != 'long double' and not tp.is_complex_type():\n cname = tp.name.replace(' ', '_')\n if cname in ('char16_t', 'char32_t'):\n self.needs_version(VERSION_CHAR16CHAR32)\n return '_cffi_from_c_%s(%s)' % (cname, var)\n else:\n return '_cffi_from_c_deref((char *)&%s, _cffi_type(%d))' % (\n var, self._gettypenum(tp))\n elif isinstance(tp, (model.PointerType, model.FunctionPtrType)):\n return '_cffi_from_c_pointer((char *)%s, _cffi_type(%d))' % (\n var, self._gettypenum(tp))\n elif isinstance(tp, model.ArrayType):\n return '_cffi_from_c_pointer((char *)%s, _cffi_type(%d))' % (\n var, self._gettypenum(model.PointerType(tp.item)))\n elif isinstance(tp, model.StructOrUnion):\n if tp.fldnames is None:\n raise TypeError(\"'%s' is used as %s, but is opaque\" % (\n tp._get_c_name(), context))\n return '_cffi_from_c_struct((char *)&%s, _cffi_type(%d))' % (\n var, self._gettypenum(tp))\n elif isinstance(tp, model.EnumType):\n return '_cffi_from_c_deref((char *)&%s, _cffi_type(%d))' % (\n var, self._gettypenum(tp))\n else:\n raise NotImplementedError(tp)\n\n # ----------\n # typedefs\n\n def _typedef_type(self, tp, name):\n return self._global_type(tp, \"(*(%s *)0)\" % (name,))\n\n def _generate_cpy_typedef_collecttype(self, tp, name):\n self._do_collect_type(self._typedef_type(tp, name))\n\n def _generate_cpy_typedef_decl(self, tp, name):\n pass\n\n def _typedef_ctx(self, tp, name):\n type_index = self._typesdict[tp]\n self._lsts[\"typename\"].append(TypenameExpr(name, type_index))\n\n def _generate_cpy_typedef_ctx(self, tp, name):\n tp = self._typedef_type(tp, name)\n self._typedef_ctx(tp, name)\n if getattr(tp, \"origin\", None) == \"unknown_type\":\n self._struct_ctx(tp, tp.name, approxname=None)\n elif isinstance(tp, model.NamedPointerType):\n self._struct_ctx(tp.totype, tp.totype.name, approxname=tp.name,\n named_ptr=tp)\n\n # ----------\n # function declarations\n\n def _generate_cpy_function_collecttype(self, tp, name):\n self._do_collect_type(tp.as_raw_function())\n if tp.ellipsis and not self.target_is_python:\n self._do_collect_type(tp)\n\n def _generate_cpy_function_decl(self, tp, name):\n assert not self.target_is_python\n assert isinstance(tp, model.FunctionPtrType)\n if tp.ellipsis:\n # cannot support vararg functions better than this: check for its\n # exact type (including the fixed arguments), and build it as a\n # constant function pointer (no CPython wrapper)\n self._generate_cpy_constant_decl(tp, name)\n return\n prnt = self._prnt\n numargs = len(tp.args)\n if numargs == 0:\n argname = 'noarg'\n elif numargs == 1:\n argname = 'arg0'\n else:\n argname = 'args'\n #\n # ------------------------------\n # the 'd' version of the function, only for addressof(lib, 'func')\n arguments = []\n call_arguments = []\n context = 'argument of %s' % name\n for i, type in enumerate(tp.args):\n arguments.append(type.get_c_name(' x%d' % i, context))\n call_arguments.append('x%d' % i)\n repr_arguments = ', '.join(arguments)\n repr_arguments = repr_arguments or 'void'\n if tp.abi:\n abi = tp.abi + ' '\n else:\n abi = ''\n name_and_arguments = '%s_cffi_d_%s(%s)' % (abi, name, repr_arguments)\n prnt('static %s' % (tp.result.get_c_name(name_and_arguments),))\n prnt('{')\n call_arguments = ', '.join(call_arguments)\n result_code = 'return '\n if isinstance(tp.result, model.VoidType):\n result_code = ''\n prnt(' %s%s(%s);' % (result_code, name, call_arguments))\n prnt('}')\n #\n prnt('#ifndef PYPY_VERSION') # ------------------------------\n #\n prnt('static PyObject *')\n prnt('_cffi_f_%s(PyObject *self, PyObject *%s)' % (name, argname))\n prnt('{')\n #\n context = 'argument of %s' % name\n for i, type in enumerate(tp.args):\n arg = type.get_c_name(' x%d' % i, context)\n prnt(' %s;' % arg)\n #\n localvars = set()\n for type in tp.args:\n self._extra_local_variables(type, localvars)\n for decl in localvars:\n prnt(' %s;' % (decl,))\n #\n if not isinstance(tp.result, model.VoidType):\n result_code = 'result = '\n context = 'result of %s' % name\n result_decl = ' %s;' % tp.result.get_c_name(' result', context)\n prnt(result_decl)\n else:\n result_decl = None\n result_code = ''\n #\n if len(tp.args) > 1:\n rng = range(len(tp.args))\n for i in rng:\n prnt(' PyObject *arg%d;' % i)\n prnt()\n prnt(' if (!PyArg_UnpackTuple(args, \"%s\", %d, %d, %s))' % (\n name, len(rng), len(rng),\n ', '.join(['&arg%d' % i for i in rng])))\n prnt(' return NULL;')\n prnt()\n #\n for i, type in enumerate(tp.args):\n self._convert_funcarg_to_c(type, 'arg%d' % i, 'x%d' % i,\n 'return NULL')\n prnt()\n #\n prnt(' Py_BEGIN_ALLOW_THREADS')\n prnt(' _cffi_restore_errno();')\n call_arguments = ['x%d' % i for i in range(len(tp.args))]\n call_arguments = ', '.join(call_arguments)\n prnt(' { %s%s(%s); }' % (result_code, name, call_arguments))\n prnt(' _cffi_save_errno();')\n prnt(' Py_END_ALLOW_THREADS')\n prnt()\n #\n prnt(' (void)self; /* unused */')\n if numargs == 0:\n prnt(' (void)noarg; /* unused */')\n if result_code:\n prnt(' return %s;' %\n self._convert_expr_from_c(tp.result, 'result', 'result type'))\n else:\n prnt(' Py_INCREF(Py_None);')\n prnt(' return Py_None;')\n prnt('}')\n #\n prnt('#else') # ------------------------------\n #\n # the PyPy version: need to replace struct/union arguments with\n # pointers, and if the result is a struct/union, insert a first\n # arg that is a pointer to the result. We also do that for\n # complex args and return type.\n def need_indirection(type):\n return (isinstance(type, model.StructOrUnion) or\n (isinstance(type, model.PrimitiveType) and\n type.is_complex_type()))\n difference = False\n arguments = []\n call_arguments = []\n context = 'argument of %s' % name\n for i, type in enumerate(tp.args):\n indirection = ''\n if need_indirection(type):\n indirection = '*'\n difference = True\n arg = type.get_c_name(' %sx%d' % (indirection, i), context)\n arguments.append(arg)\n call_arguments.append('%sx%d' % (indirection, i))\n tp_result = tp.result\n if need_indirection(tp_result):\n context = 'result of %s' % name\n arg = tp_result.get_c_name(' *result', context)\n arguments.insert(0, arg)\n tp_result = model.void_type\n result_decl = None\n result_code = '*result = '\n difference = True\n if difference:\n repr_arguments = ', '.join(arguments)\n repr_arguments = repr_arguments or 'void'\n name_and_arguments = '%s_cffi_f_%s(%s)' % (abi, name,\n repr_arguments)\n prnt('static %s' % (tp_result.get_c_name(name_and_arguments),))\n prnt('{')\n if result_decl:\n prnt(result_decl)\n call_arguments = ', '.join(call_arguments)\n prnt(' { %s%s(%s); }' % (result_code, name, call_arguments))\n if result_decl:\n prnt(' return result;')\n prnt('}')\n else:\n prnt('# define _cffi_f_%s _cffi_d_%s' % (name, name))\n #\n prnt('#endif') # ------------------------------\n prnt()\n\n def _generate_cpy_function_ctx(self, tp, name):\n if tp.ellipsis and not self.target_is_python:\n self._generate_cpy_constant_ctx(tp, name)\n return\n type_index = self._typesdict[tp.as_raw_function()]\n numargs = len(tp.args)\n if self.target_is_python:\n meth_kind = OP_DLOPEN_FUNC\n elif numargs == 0:\n meth_kind = OP_CPYTHON_BLTN_N # 'METH_NOARGS'\n elif numargs == 1:\n meth_kind = OP_CPYTHON_BLTN_O # 'METH_O'\n else:\n meth_kind = OP_CPYTHON_BLTN_V # 'METH_VARARGS'\n self._lsts[\"global\"].append(\n GlobalExpr(name, '_cffi_f_%s' % name,\n CffiOp(meth_kind, type_index),\n size='_cffi_d_%s' % name))\n\n # ----------\n # named structs or unions\n\n def _field_type(self, tp_struct, field_name, tp_field):\n if isinstance(tp_field, model.ArrayType):\n actual_length = tp_field.length\n if actual_length == '...':\n ptr_struct_name = tp_struct.get_c_name('*')\n actual_length = '_cffi_array_len(((%s)0)->%s)' % (\n ptr_struct_name, field_name)\n tp_item = self._field_type(tp_struct, '%s[0]' % field_name,\n tp_field.item)\n tp_field = model.ArrayType(tp_item, actual_length)\n return tp_field\n\n def _struct_collecttype(self, tp):\n self._do_collect_type(tp)\n if self.target_is_python:\n # also requires nested anon struct/unions in ABI mode, recursively\n for fldtype in tp.anonymous_struct_fields():\n self._struct_collecttype(fldtype)\n\n def _struct_decl(self, tp, cname, approxname):\n if tp.fldtypes is None:\n return\n prnt = self._prnt\n checkfuncname = '_cffi_checkfld_%s' % (approxname,)\n prnt('_CFFI_UNUSED_FN')\n prnt('static void %s(%s *p)' % (checkfuncname, cname))\n prnt('{')\n prnt(' /* only to generate compile-time warnings or errors */')\n prnt(' (void)p;')\n for fname, ftype, fbitsize, fqual in tp.enumfields():\n try:\n if ftype.is_integer_type() or fbitsize >= 0:\n # accept all integers, but complain on float or double\n if fname != '':\n prnt(\" (void)((p->%s) | 0); /* check that '%s.%s' is \"\n \"an integer */\" % (fname, cname, fname))\n continue\n # only accept exactly the type declared, except that '[]'\n # is interpreted as a '*' and so will match any array length.\n # (It would also match '*', but that's harder to detect...)\n while (isinstance(ftype, model.ArrayType)\n and (ftype.length is None or ftype.length == '...')):\n ftype = ftype.item\n fname = fname + '[0]'\n prnt(' { %s = &p->%s; (void)tmp; }' % (\n ftype.get_c_name('*tmp', 'field %r'%fname, quals=fqual),\n fname))\n except VerificationError as e:\n prnt(' /* %s */' % str(e)) # cannot verify it, ignore\n prnt('}')\n prnt('struct _cffi_align_%s { char x; %s y; };' % (approxname, cname))\n prnt()\n\n def _struct_ctx(self, tp, cname, approxname, named_ptr=None):\n type_index = self._typesdict[tp]\n reason_for_not_expanding = None\n flags = []\n if isinstance(tp, model.UnionType):\n flags.append(\"_CFFI_F_UNION\")\n if tp.fldtypes is None:\n flags.append(\"_CFFI_F_OPAQUE\")\n reason_for_not_expanding = \"opaque\"\n if (tp not in self.ffi._parser._included_declarations and\n (named_ptr is None or\n named_ptr not in self.ffi._parser._included_declarations)):\n if tp.fldtypes is None:\n pass # opaque\n elif tp.partial or any(tp.anonymous_struct_fields()):\n pass # field layout obtained silently from the C compiler\n else:\n flags.append(\"_CFFI_F_CHECK_FIELDS\")\n if tp.packed:\n if tp.packed > 1:\n raise NotImplementedError(\n \"%r is declared with 'pack=%r'; only 0 or 1 are \"\n \"supported in API mode (try to use \\\"...;\\\", which \"\n \"does not require a 'pack' declaration)\" %\n (tp, tp.packed))\n flags.append(\"_CFFI_F_PACKED\")\n else:\n flags.append(\"_CFFI_F_EXTERNAL\")\n reason_for_not_expanding = \"external\"\n flags = '|'.join(flags) or '0'\n c_fields = []\n if reason_for_not_expanding is None:\n expand_anonymous_struct_union = not self.target_is_python\n enumfields = list(tp.enumfields(expand_anonymous_struct_union))\n for fldname, fldtype, fbitsize, fqual in enumfields:\n fldtype = self._field_type(tp, fldname, fldtype)\n self._check_not_opaque(fldtype,\n \"field '%s.%s'\" % (tp.name, fldname))\n # cname is None for _add_missing_struct_unions() only\n op = OP_NOOP\n if fbitsize >= 0:\n op = OP_BITFIELD\n size = '%d /* bits */' % fbitsize\n elif cname is None or (\n isinstance(fldtype, model.ArrayType) and\n fldtype.length is None):\n size = '(size_t)-1'\n else:\n size = 'sizeof(((%s)0)->%s)' % (\n tp.get_c_name('*') if named_ptr is None\n else named_ptr.name,\n fldname)\n if cname is None or fbitsize >= 0:\n offset = '(size_t)-1'\n elif named_ptr is not None:\n offset = '((char *)&((%s)0)->%s) - (char *)0' % (\n named_ptr.name, fldname)\n else:\n offset = 'offsetof(%s, %s)' % (tp.get_c_name(''), fldname)\n c_fields.append(\n FieldExpr(fldname, offset, size, fbitsize,\n CffiOp(op, self._typesdict[fldtype])))\n first_field_index = len(self._lsts[\"field\"])\n self._lsts[\"field\"].extend(c_fields)\n #\n if cname is None: # unknown name, for _add_missing_struct_unions\n size = '(size_t)-2'\n align = -2\n comment = \"unnamed\"\n else:\n if named_ptr is not None:\n size = 'sizeof(*(%s)0)' % (named_ptr.name,)\n align = '-1 /* unknown alignment */'\n else:\n size = 'sizeof(%s)' % (cname,)\n align = 'offsetof(struct _cffi_align_%s, y)' % (approxname,)\n comment = None\n else:\n size = '(size_t)-1'\n align = -1\n first_field_index = -1\n comment = reason_for_not_expanding\n self._lsts[\"struct_union\"].append(\n StructUnionExpr(tp.name, type_index, flags, size, align, comment,\n first_field_index, c_fields))\n self._seen_struct_unions.add(tp)\n\n def _check_not_opaque(self, tp, location):\n while isinstance(tp, model.ArrayType):\n tp = tp.item\n if isinstance(tp, model.StructOrUnion) and tp.fldtypes is None:\n raise TypeError(\n \"%s is of an opaque type (not declared in cdef())\" % location)\n\n def _add_missing_struct_unions(self):\n # not very nice, but some struct declarations might be missing\n # because they don't have any known C name. Check that they are\n # not partial (we can't complete or verify them!) and emit them\n # anonymously.\n lst = list(self._struct_unions.items())\n lst.sort(key=lambda tp_order: tp_order[1])\n for tp, order in lst:\n if tp not in self._seen_struct_unions:\n if tp.partial:\n raise NotImplementedError(\"internal inconsistency: %r is \"\n \"partial but was not seen at \"\n \"this point\" % (tp,))\n if tp.name.startswith('$') and tp.name[1:].isdigit():\n approxname = tp.name[1:]\n elif tp.name == '_IO_FILE' and tp.forcename == 'FILE':\n approxname = 'FILE'\n self._typedef_ctx(tp, 'FILE')\n else:\n raise NotImplementedError(\"internal inconsistency: %r\" %\n (tp,))\n self._struct_ctx(tp, None, approxname)\n\n def _generate_cpy_struct_collecttype(self, tp, name):\n self._struct_collecttype(tp)\n _generate_cpy_union_collecttype = _generate_cpy_struct_collecttype\n\n def _struct_names(self, tp):\n cname = tp.get_c_name('')\n if ' ' in cname:\n return cname, cname.replace(' ', '_')\n else:\n return cname, '_' + cname\n\n def _generate_cpy_struct_decl(self, tp, name):\n self._struct_decl(tp, *self._struct_names(tp))\n _generate_cpy_union_decl = _generate_cpy_struct_decl\n\n def _generate_cpy_struct_ctx(self, tp, name):\n self._struct_ctx(tp, *self._struct_names(tp))\n _generate_cpy_union_ctx = _generate_cpy_struct_ctx\n\n # ----------\n # 'anonymous' declarations. These are produced for anonymous structs\n # or unions; the 'name' is obtained by a typedef.\n\n def _generate_cpy_anonymous_collecttype(self, tp, name):\n if isinstance(tp, model.EnumType):\n self._generate_cpy_enum_collecttype(tp, name)\n else:\n self._struct_collecttype(tp)\n\n def _generate_cpy_anonymous_decl(self, tp, name):\n if isinstance(tp, model.EnumType):\n self._generate_cpy_enum_decl(tp)\n else:\n self._struct_decl(tp, name, 'typedef_' + name)\n\n def _generate_cpy_anonymous_ctx(self, tp, name):\n if isinstance(tp, model.EnumType):\n self._enum_ctx(tp, name)\n else:\n self._struct_ctx(tp, name, 'typedef_' + name)\n\n # ----------\n # constants, declared with \"static const ...\"\n\n def _generate_cpy_const(self, is_int, name, tp=None, category='const',\n check_value=None):\n if (category, name) in self._seen_constants:\n raise VerificationError(\n \"duplicate declaration of %s '%s'\" % (category, name))\n self._seen_constants.add((category, name))\n #\n prnt = self._prnt\n funcname = '_cffi_%s_%s' % (category, name)\n if is_int:\n prnt('static int %s(unsigned long long *o)' % funcname)\n prnt('{')\n prnt(' int n = (%s) <= 0;' % (name,))\n prnt(' *o = (unsigned long long)((%s) | 0);'\n ' /* check that %s is an integer */' % (name, name))\n if check_value is not None:\n if check_value > 0:\n check_value = '%dU' % (check_value,)\n prnt(' if (!_cffi_check_int(*o, n, %s))' % (check_value,))\n prnt(' n |= 2;')\n prnt(' return n;')\n prnt('}')\n else:\n assert check_value is None\n prnt('static void %s(char *o)' % funcname)\n prnt('{')\n prnt(' *(%s)o = %s;' % (tp.get_c_name('*'), name))\n prnt('}')\n prnt()\n\n def _generate_cpy_constant_collecttype(self, tp, name):\n is_int = tp.is_integer_type()\n if not is_int or self.target_is_python:\n self._do_collect_type(tp)\n\n def _generate_cpy_constant_decl(self, tp, name):\n is_int = tp.is_integer_type()\n self._generate_cpy_const(is_int, name, tp)\n\n def _generate_cpy_constant_ctx(self, tp, name):\n if not self.target_is_python and tp.is_integer_type():\n type_op = CffiOp(OP_CONSTANT_INT, -1)\n else:\n if self.target_is_python:\n const_kind = OP_DLOPEN_CONST\n else:\n const_kind = OP_CONSTANT\n type_index = self._typesdict[tp]\n type_op = CffiOp(const_kind, type_index)\n self._lsts[\"global\"].append(\n GlobalExpr(name, '_cffi_const_%s' % name, type_op))\n\n # ----------\n # enums\n\n def _generate_cpy_enum_collecttype(self, tp, name):\n self._do_collect_type(tp)\n\n def _generate_cpy_enum_decl(self, tp, name=None):\n for enumerator in tp.enumerators:\n self._generate_cpy_const(True, enumerator)\n\n def _enum_ctx(self, tp, cname):\n type_index = self._typesdict[tp]\n type_op = CffiOp(OP_ENUM, -1)\n if self.target_is_python:\n tp.check_not_partial()\n for enumerator, enumvalue in zip(tp.enumerators, tp.enumvalues):\n self._lsts[\"global\"].append(\n GlobalExpr(enumerator, '_cffi_const_%s' % enumerator, type_op,\n check_value=enumvalue))\n #\n if cname is not None and '$' not in cname and not self.target_is_python:\n size = \"sizeof(%s)\" % cname\n signed = \"((%s)-1) <= 0\" % cname\n else:\n basetp = tp.build_baseinttype(self.ffi, [])\n size = self.ffi.sizeof(basetp)\n signed = int(int(self.ffi.cast(basetp, -1)) < 0)\n allenums = \",\".join(tp.enumerators)\n self._lsts[\"enum\"].append(\n EnumExpr(tp.name, type_index, size, signed, allenums))\n\n def _generate_cpy_enum_ctx(self, tp, name):\n self._enum_ctx(tp, tp._get_c_name())\n\n # ----------\n # macros: for now only for integers\n\n def _generate_cpy_macro_collecttype(self, tp, name):\n pass\n\n def _generate_cpy_macro_decl(self, tp, name):\n if tp == '...':\n check_value = None\n else:\n check_value = tp # an integer\n self._generate_cpy_const(True, name, check_value=check_value)\n\n def _generate_cpy_macro_ctx(self, tp, name):\n if tp == '...':\n if self.target_is_python:\n raise VerificationError(\n \"cannot use the syntax '...' in '#define %s ...' when \"\n \"using the ABI mode\" % (name,))\n check_value = None\n else:\n check_value = tp # an integer\n type_op = CffiOp(OP_CONSTANT_INT, -1)\n self._lsts[\"global\"].append(\n GlobalExpr(name, '_cffi_const_%s' % name, type_op,\n check_value=check_value))\n\n # ----------\n # global variables\n\n def _global_type(self, tp, global_name):\n if isinstance(tp, model.ArrayType):\n actual_length = tp.length\n if actual_length == '...':\n actual_length = '_cffi_array_len(%s)' % (global_name,)\n tp_item = self._global_type(tp.item, '%s[0]' % global_name)\n tp = model.ArrayType(tp_item, actual_length)\n return tp\n\n def _generate_cpy_variable_collecttype(self, tp, name):\n self._do_collect_type(self._global_type(tp, name))\n\n def _generate_cpy_variable_decl(self, tp, name):\n prnt = self._prnt\n tp = self._global_type(tp, name)\n if isinstance(tp, model.ArrayType) and tp.length is None:\n tp = tp.item\n ampersand = ''\n else:\n ampersand = '&'\n # This code assumes that casts from \"tp *\" to \"void *\" is a\n # no-op, i.e. a function that returns a \"tp *\" can be called\n # as if it returned a \"void *\". This should be generally true\n # on any modern machine. The only exception to that rule (on\n # uncommon architectures, and as far as I can tell) might be\n # if 'tp' were a function type, but that is not possible here.\n # (If 'tp' is a function _pointer_ type, then casts from \"fn_t\n # **\" to \"void *\" are again no-ops, as far as I can tell.)\n decl = '*_cffi_var_%s(void)' % (name,)\n prnt('static ' + tp.get_c_name(decl, quals=self._current_quals))\n prnt('{')\n prnt(' return %s(%s);' % (ampersand, name))\n prnt('}')\n prnt()\n\n def _generate_cpy_variable_ctx(self, tp, name):\n tp = self._global_type(tp, name)\n type_index = self._typesdict[tp]\n if self.target_is_python:\n op = OP_GLOBAL_VAR\n else:\n op = OP_GLOBAL_VAR_F\n self._lsts[\"global\"].append(\n GlobalExpr(name, '_cffi_var_%s' % name, CffiOp(op, type_index)))\n\n # ----------\n # extern \"Python\"\n\n def _generate_cpy_extern_python_collecttype(self, tp, name):\n assert isinstance(tp, model.FunctionPtrType)\n self._do_collect_type(tp)\n _generate_cpy_dllexport_python_collecttype = \\\n _generate_cpy_extern_python_plus_c_collecttype = \\\n _generate_cpy_extern_python_collecttype\n\n def _extern_python_decl(self, tp, name, tag_and_space):\n prnt = self._prnt\n if isinstance(tp.result, model.VoidType):\n size_of_result = '0'\n else:\n context = 'result of %s' % name\n size_of_result = '(int)sizeof(%s)' % (\n tp.result.get_c_name('', context),)\n prnt('static struct _cffi_externpy_s _cffi_externpy__%s =' % name)\n prnt(' { \"%s.%s\", %s };' % (self.module_name, name, size_of_result))\n prnt()\n #\n arguments = []\n context = 'argument of %s' % name\n for i, type in enumerate(tp.args):\n arg = type.get_c_name(' a%d' % i, context)\n arguments.append(arg)\n #\n repr_arguments = ', '.join(arguments)\n repr_arguments = repr_arguments or 'void'\n name_and_arguments = '%s(%s)' % (name, repr_arguments)\n if tp.abi == \"__stdcall\":\n name_and_arguments = '_cffi_stdcall ' + name_and_arguments\n #\n def may_need_128_bits(tp):\n return (isinstance(tp, model.PrimitiveType) and\n tp.name == 'long double')\n #\n size_of_a = max(len(tp.args)*8, 8)\n if may_need_128_bits(tp.result):\n size_of_a = max(size_of_a, 16)\n if isinstance(tp.result, model.StructOrUnion):\n size_of_a = 'sizeof(%s) > %d ? sizeof(%s) : %d' % (\n tp.result.get_c_name(''), size_of_a,\n tp.result.get_c_name(''), size_of_a)\n prnt('%s%s' % (tag_and_space, tp.result.get_c_name(name_and_arguments)))\n prnt('{')\n prnt(' char a[%s];' % size_of_a)\n prnt(' char *p = a;')\n for i, type in enumerate(tp.args):\n arg = 'a%d' % i\n if (isinstance(type, model.StructOrUnion) or\n may_need_128_bits(type)):\n arg = '&' + arg\n type = model.PointerType(type)\n prnt(' *(%s)(p + %d) = %s;' % (type.get_c_name('*'), i*8, arg))\n prnt(' _cffi_call_python(&_cffi_externpy__%s, p);' % name)\n if not isinstance(tp.result, model.VoidType):\n prnt(' return *(%s)p;' % (tp.result.get_c_name('*'),))\n prnt('}')\n prnt()\n self._num_externpy += 1\n\n def _generate_cpy_extern_python_decl(self, tp, name):\n self._extern_python_decl(tp, name, 'static ')\n\n def _generate_cpy_dllexport_python_decl(self, tp, name):\n self._extern_python_decl(tp, name, 'CFFI_DLLEXPORT ')\n\n def _generate_cpy_extern_python_plus_c_decl(self, tp, name):\n self._extern_python_decl(tp, name, '')\n\n def _generate_cpy_extern_python_ctx(self, tp, name):\n if self.target_is_python:\n raise VerificationError(\n \"cannot use 'extern \\\"Python\\\"' in the ABI mode\")\n if tp.ellipsis:\n raise NotImplementedError(\"a vararg function is extern \\\"Python\\\"\")\n type_index = self._typesdict[tp]\n type_op = CffiOp(OP_EXTERN_PYTHON, type_index)\n self._lsts[\"global\"].append(\n GlobalExpr(name, '&_cffi_externpy__%s' % name, type_op, name))\n\n _generate_cpy_dllexport_python_ctx = \\\n _generate_cpy_extern_python_plus_c_ctx = \\\n _generate_cpy_extern_python_ctx\n\n def _print_string_literal_in_array(self, s):\n prnt = self._prnt\n prnt('// # NB. this is not a string because of a size limit in MSVC')\n for line in s.splitlines(True):\n prnt(('// ' + line).rstrip())\n printed_line = ''\n for c in line:\n if len(printed_line) >= 76:\n prnt(printed_line)\n printed_line = ''\n printed_line += '%d,' % (ord(c),)\n prnt(printed_line)\n\n # ----------\n # emitting the opcodes for individual types\n\n def _emit_bytecode_VoidType(self, tp, index):\n self.cffi_types[index] = CffiOp(OP_PRIMITIVE, PRIM_VOID)\n\n def _emit_bytecode_PrimitiveType(self, tp, index):\n prim_index = PRIMITIVE_TO_INDEX[tp.name]\n self.cffi_types[index] = CffiOp(OP_PRIMITIVE, prim_index)\n\n def _emit_bytecode_UnknownIntegerType(self, tp, index):\n s = ('_cffi_prim_int(sizeof(%s), (\\n'\n ' ((%s)-1) | 0 /* check that %s is an integer type */\\n'\n ' ) <= 0)' % (tp.name, tp.name, tp.name))\n self.cffi_types[index] = CffiOp(OP_PRIMITIVE, s)\n\n def _emit_bytecode_UnknownFloatType(self, tp, index):\n s = ('_cffi_prim_float(sizeof(%s) *\\n'\n ' (((%s)1) / 2) * 2 /* integer => 0, float => 1 */\\n'\n ' )' % (tp.name, tp.name))\n self.cffi_types[index] = CffiOp(OP_PRIMITIVE, s)\n\n def _emit_bytecode_RawFunctionType(self, tp, index):\n self.cffi_types[index] = CffiOp(OP_FUNCTION, self._typesdict[tp.result])\n index += 1\n for tp1 in tp.args:\n realindex = self._typesdict[tp1]\n if index != realindex:\n if isinstance(tp1, model.PrimitiveType):\n self._emit_bytecode_PrimitiveType(tp1, index)\n else:\n self.cffi_types[index] = CffiOp(OP_NOOP, realindex)\n index += 1\n flags = int(tp.ellipsis)\n if tp.abi is not None:\n if tp.abi == '__stdcall':\n flags |= 2\n else:\n raise NotImplementedError(\"abi=%r\" % (tp.abi,))\n self.cffi_types[index] = CffiOp(OP_FUNCTION_END, flags)\n\n def _emit_bytecode_PointerType(self, tp, index):\n self.cffi_types[index] = CffiOp(OP_POINTER, self._typesdict[tp.totype])\n\n _emit_bytecode_ConstPointerType = _emit_bytecode_PointerType\n _emit_bytecode_NamedPointerType = _emit_bytecode_PointerType\n\n def _emit_bytecode_FunctionPtrType(self, tp, index):\n raw = tp.as_raw_function()\n self.cffi_types[index] = CffiOp(OP_POINTER, self._typesdict[raw])\n\n def _emit_bytecode_ArrayType(self, tp, index):\n item_index = self._typesdict[tp.item]\n if tp.length is None:\n self.cffi_types[index] = CffiOp(OP_OPEN_ARRAY, item_index)\n elif tp.length == '...':\n raise VerificationError(\n \"type %s badly placed: the '...' array length can only be \"\n \"used on global arrays or on fields of structures\" % (\n str(tp).replace('/*...*/', '...'),))\n else:\n assert self.cffi_types[index + 1] == 'LEN'\n self.cffi_types[index] = CffiOp(OP_ARRAY, item_index)\n self.cffi_types[index + 1] = CffiOp(None, str(tp.length))\n\n def _emit_bytecode_StructType(self, tp, index):\n struct_index = self._struct_unions[tp]\n self.cffi_types[index] = CffiOp(OP_STRUCT_UNION, struct_index)\n _emit_bytecode_UnionType = _emit_bytecode_StructType\n\n def _emit_bytecode_EnumType(self, tp, index):\n enum_index = self._enums[tp]\n self.cffi_types[index] = CffiOp(OP_ENUM, enum_index)\n\n\nif sys.version_info >= (3,):\n NativeIO = io.StringIO\nelse:\n class NativeIO(io.BytesIO):\n def write(self, s):\n if isinstance(s, unicode):\n s = s.encode('ascii')\n super(NativeIO, self).write(s)\n\ndef _make_c_or_py_source(ffi, module_name, preamble, target_file, verbose):\n if verbose:\n print(\"generating %s\" % (target_file,))\n recompiler = Recompiler(ffi, module_name,\n target_is_python=(preamble is None))\n recompiler.collect_type_table()\n recompiler.collect_step_tables()\n f = NativeIO()\n recompiler.write_source_to_f(f, preamble)\n output = f.getvalue()\n try:\n with open(target_file, 'r') as f1:\n if f1.read(len(output) + 1) != output:\n raise IOError\n if verbose:\n print(\"(already up-to-date)\")\n return False # already up-to-date\n except IOError:\n tmp_file = '%s.~%d' % (target_file, os.getpid())\n with open(tmp_file, 'w') as f1:\n f1.write(output)\n try:\n os.rename(tmp_file, target_file)\n except OSError:\n os.unlink(target_file)\n os.rename(tmp_file, target_file)\n return True\n\ndef make_c_source(ffi, module_name, preamble, target_c_file, verbose=False):\n assert preamble is not None\n return _make_c_or_py_source(ffi, module_name, preamble, target_c_file,\n verbose)\n\ndef make_py_source(ffi, module_name, target_py_file, verbose=False):\n return _make_c_or_py_source(ffi, module_name, None, target_py_file,\n verbose)\n\ndef _modname_to_file(outputdir, modname, extension):\n parts = modname.split('.')\n try:\n os.makedirs(os.path.join(outputdir, *parts[:-1]))\n except OSError:\n pass\n parts[-1] += extension\n return os.path.join(outputdir, *parts), parts\n\n\n# Aaargh. Distutils is not tested at all for the purpose of compiling\n# DLLs that are not extension modules. Here are some hacks to work\n# around that, in the _patch_for_*() functions...\n\ndef _patch_meth(patchlist, cls, name, new_meth):\n old = getattr(cls, name)\n patchlist.append((cls, name, old))\n setattr(cls, name, new_meth)\n return old\n\ndef _unpatch_meths(patchlist):\n for cls, name, old_meth in reversed(patchlist):\n setattr(cls, name, old_meth)\n\ndef _patch_for_embedding(patchlist):\n if sys.platform == 'win32':\n # we must not remove the manifest when building for embedding!\n from distutils.msvc9compiler import MSVCCompiler\n _patch_meth(patchlist, MSVCCompiler, '_remove_visual_c_ref',\n lambda self, manifest_file: manifest_file)\n\n if sys.platform == 'darwin':\n # we must not make a '-bundle', but a '-dynamiclib' instead\n from distutils.ccompiler import CCompiler\n def my_link_shared_object(self, *args, **kwds):\n if '-bundle' in self.linker_so:\n self.linker_so = list(self.linker_so)\n i = self.linker_so.index('-bundle')\n self.linker_so[i] = '-dynamiclib'\n return old_link_shared_object(self, *args, **kwds)\n old_link_shared_object = _patch_meth(patchlist, CCompiler,\n 'link_shared_object',\n my_link_shared_object)\n\ndef _patch_for_target(patchlist, target):\n from distutils.command.build_ext import build_ext\n # if 'target' is different from '*', we need to patch some internal\n # method to just return this 'target' value, instead of having it\n # built from module_name\n if target.endswith('.*'):\n target = target[:-2]\n if sys.platform == 'win32':\n target += '.dll'\n elif sys.platform == 'darwin':\n target += '.dylib'\n else:\n target += '.so'\n _patch_meth(patchlist, build_ext, 'get_ext_filename',\n lambda self, ext_name: target)\n\n\ndef recompile(ffi, module_name, preamble, tmpdir='.', call_c_compiler=True,\n c_file=None, source_extension='.c', extradir=None,\n compiler_verbose=1, target=None, debug=None, **kwds):\n if not isinstance(module_name, str):\n module_name = module_name.encode('ascii')\n if ffi._windows_unicode:\n ffi._apply_windows_unicode(kwds)\n if preamble is not None:\n embedding = (ffi._embedding is not None)\n if embedding:\n ffi._apply_embedding_fix(kwds)\n if c_file is None:\n c_file, parts = _modname_to_file(tmpdir, module_name,\n source_extension)\n if extradir:\n parts = [extradir] + parts\n ext_c_file = os.path.join(*parts)\n else:\n ext_c_file = c_file\n #\n if target is None:\n if embedding:\n target = '%s.*' % module_name\n else:\n target = '*'\n #\n ext = ffiplatform.get_extension(ext_c_file, module_name, **kwds)\n updated = make_c_source(ffi, module_name, preamble, c_file,\n verbose=compiler_verbose)\n if call_c_compiler:\n patchlist = []\n cwd = os.getcwd()\n try:\n if embedding:\n _patch_for_embedding(patchlist)\n if target != '*':\n _patch_for_target(patchlist, target)\n if compiler_verbose:\n if tmpdir == '.':\n msg = 'the current directory is'\n else:\n msg = 'setting the current directory to'\n print('%s %r' % (msg, os.path.abspath(tmpdir)))\n os.chdir(tmpdir)\n outputfilename = ffiplatform.compile('.', ext,\n compiler_verbose, debug)\n finally:\n os.chdir(cwd)\n _unpatch_meths(patchlist)\n return outputfilename\n else:\n return ext, updated\n else:\n if c_file is None:\n c_file, _ = _modname_to_file(tmpdir, module_name, '.py')\n updated = make_py_source(ffi, module_name, c_file,\n verbose=compiler_verbose)\n if call_c_compiler:\n return c_file\n else:\n return None, updated\n\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cffi/setuptools_ext.py",
"content": "import os\nimport sys\n\ntry:\n basestring\nexcept NameError:\n # Python 3.x\n basestring = str\n\ndef error(msg):\n from distutils.errors import DistutilsSetupError\n raise DistutilsSetupError(msg)\n\n\ndef execfile(filename, glob):\n # We use execfile() (here rewritten for Python 3) instead of\n # __import__() to load the build script. The problem with\n # a normal import is that in some packages, the intermediate\n # __init__.py files may already try to import the file that\n # we are generating.\n with open(filename) as f:\n src = f.read()\n src += '\\n' # Python 2.6 compatibility\n code = compile(src, filename, 'exec')\n exec(code, glob, glob)\n\n\ndef add_cffi_module(dist, mod_spec):\n from cffi.api import FFI\n\n if not isinstance(mod_spec, basestring):\n error(\"argument to 'cffi_modules=...' must be a str or a list of str,\"\n \" not %r\" % (type(mod_spec).__name__,))\n mod_spec = str(mod_spec)\n try:\n build_file_name, ffi_var_name = mod_spec.split(':')\n except ValueError:\n error(\"%r must be of the form 'path/build.py:ffi_variable'\" %\n (mod_spec,))\n if not os.path.exists(build_file_name):\n ext = ''\n rewritten = build_file_name.replace('.', '/') + '.py'\n if os.path.exists(rewritten):\n ext = ' (rewrite cffi_modules to [%r])' % (\n rewritten + ':' + ffi_var_name,)\n error(\"%r does not name an existing file%s\" % (build_file_name, ext))\n\n mod_vars = {'__name__': '__cffi__', '__file__': build_file_name}\n execfile(build_file_name, mod_vars)\n\n try:\n ffi = mod_vars[ffi_var_name]\n except KeyError:\n error(\"%r: object %r not found in module\" % (mod_spec,\n ffi_var_name))\n if not isinstance(ffi, FFI):\n ffi = ffi() # maybe it's a function instead of directly an ffi\n if not isinstance(ffi, FFI):\n error(\"%r is not an FFI instance (got %r)\" % (mod_spec,\n type(ffi).__name__))\n if not hasattr(ffi, '_assigned_source'):\n error(\"%r: the set_source() method was not called\" % (mod_spec,))\n module_name, source, source_extension, kwds = ffi._assigned_source\n if ffi._windows_unicode:\n kwds = kwds.copy()\n ffi._apply_windows_unicode(kwds)\n\n if source is None:\n _add_py_module(dist, ffi, module_name)\n else:\n _add_c_module(dist, ffi, module_name, source, source_extension, kwds)\n\ndef _set_py_limited_api(Extension, kwds):\n \"\"\"\n Add py_limited_api to kwds if setuptools >= 26 is in use.\n Do not alter the setting if it already exists.\n Setuptools takes care of ignoring the flag on Python 2 and PyPy.\n\n CPython itself should ignore the flag in a debugging version\n (by not listing .abi3.so in the extensions it supports), but\n it doesn't so far, creating troubles. That's why we check\n for \"not hasattr(sys, 'gettotalrefcount')\" (the 2.7 compatible equivalent\n of 'd' not in sys.abiflags). (http://bugs.python.org/issue28401)\n\n On Windows, with CPython <= 3.4, it's better not to use py_limited_api\n because virtualenv *still* doesn't copy PYTHON3.DLL on these versions.\n For now we'll skip py_limited_api on all Windows versions to avoid an\n inconsistent mess.\n \"\"\"\n if ('py_limited_api' not in kwds and not hasattr(sys, 'gettotalrefcount')\n and sys.platform != 'win32'):\n import setuptools\n try:\n setuptools_major_version = int(setuptools.__version__.partition('.')[0])\n if setuptools_major_version >= 26:\n kwds['py_limited_api'] = True\n except ValueError: # certain development versions of setuptools\n # If we don't know the version number of setuptools, we\n # try to set 'py_limited_api' anyway. At worst, we get a\n # warning.\n kwds['py_limited_api'] = True\n return kwds\n\ndef _add_c_module(dist, ffi, module_name, source, source_extension, kwds):\n from distutils.core import Extension\n # We are a setuptools extension. Need this build_ext for py_limited_api.\n from setuptools.command.build_ext import build_ext\n from distutils.dir_util import mkpath\n from distutils import log\n from cffi import recompiler\n\n allsources = ['$PLACEHOLDER']\n allsources.extend(kwds.pop('sources', []))\n kwds = _set_py_limited_api(Extension, kwds)\n ext = Extension(name=module_name, sources=allsources, **kwds)\n\n def make_mod(tmpdir, pre_run=None):\n c_file = os.path.join(tmpdir, module_name + source_extension)\n log.info(\"generating cffi module %r\" % c_file)\n mkpath(tmpdir)\n # a setuptools-only, API-only hook: called with the \"ext\" and \"ffi\"\n # arguments just before we turn the ffi into C code. To use it,\n # subclass the 'distutils.command.build_ext.build_ext' class and\n # add a method 'def pre_run(self, ext, ffi)'.\n if pre_run is not None:\n pre_run(ext, ffi)\n updated = recompiler.make_c_source(ffi, module_name, source, c_file)\n if not updated:\n log.info(\"already up-to-date\")\n return c_file\n\n if dist.ext_modules is None:\n dist.ext_modules = []\n dist.ext_modules.append(ext)\n\n base_class = dist.cmdclass.get('build_ext', build_ext)\n class build_ext_make_mod(base_class):\n def run(self):\n if ext.sources[0] == '$PLACEHOLDER':\n pre_run = getattr(self, 'pre_run', None)\n ext.sources[0] = make_mod(self.build_temp, pre_run)\n base_class.run(self)\n dist.cmdclass['build_ext'] = build_ext_make_mod\n # NB. multiple runs here will create multiple 'build_ext_make_mod'\n # classes. Even in this case the 'build_ext' command should be\n # run once; but just in case, the logic above does nothing if\n # called again.\n\n\ndef _add_py_module(dist, ffi, module_name):\n from distutils.dir_util import mkpath\n from setuptools.command.build_py import build_py\n from setuptools.command.build_ext import build_ext\n from distutils import log\n from cffi import recompiler\n\n def generate_mod(py_file):\n log.info(\"generating cffi module %r\" % py_file)\n mkpath(os.path.dirname(py_file))\n updated = recompiler.make_py_source(ffi, module_name, py_file)\n if not updated:\n log.info(\"already up-to-date\")\n\n base_class = dist.cmdclass.get('build_py', build_py)\n class build_py_make_mod(base_class):\n def run(self):\n base_class.run(self)\n module_path = module_name.split('.')\n module_path[-1] += '.py'\n generate_mod(os.path.join(self.build_lib, *module_path))\n def get_source_files(self):\n # This is called from 'setup.py sdist' only. Exclude\n # the generate .py module in this case.\n saved_py_modules = self.py_modules\n try:\n if saved_py_modules:\n self.py_modules = [m for m in saved_py_modules\n if m != module_name]\n return base_class.get_source_files(self)\n finally:\n self.py_modules = saved_py_modules\n dist.cmdclass['build_py'] = build_py_make_mod\n\n # distutils and setuptools have no notion I could find of a\n # generated python module. If we don't add module_name to\n # dist.py_modules, then things mostly work but there are some\n # combination of options (--root and --record) that will miss\n # the module. So we add it here, which gives a few apparently\n # harmless warnings about not finding the file outside the\n # build directory.\n # Then we need to hack more in get_source_files(); see above.\n if dist.py_modules is None:\n dist.py_modules = []\n dist.py_modules.append(module_name)\n\n # the following is only for \"build_ext -i\"\n base_class_2 = dist.cmdclass.get('build_ext', build_ext)\n class build_ext_make_mod(base_class_2):\n def run(self):\n base_class_2.run(self)\n if self.inplace:\n # from get_ext_fullpath() in distutils/command/build_ext.py\n module_path = module_name.split('.')\n package = '.'.join(module_path[:-1])\n build_py = self.get_finalized_command('build_py')\n package_dir = build_py.get_package_dir(package)\n file_name = module_path[-1] + '.py'\n generate_mod(os.path.join(package_dir, file_name))\n dist.cmdclass['build_ext'] = build_ext_make_mod\n\ndef cffi_modules(dist, attr, value):\n assert attr == 'cffi_modules'\n if isinstance(value, basestring):\n value = [value]\n\n for cffi_module in value:\n add_cffi_module(dist, cffi_module)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cffi/vengine_cpy.py",
"content": "#\n# DEPRECATED: implementation for ffi.verify()\n#\nimport sys, imp\nfrom . import model\nfrom .error import VerificationError\n\n\nclass VCPythonEngine(object):\n _class_key = 'x'\n _gen_python_module = True\n\n def __init__(self, verifier):\n self.verifier = verifier\n self.ffi = verifier.ffi\n self._struct_pending_verification = {}\n self._types_of_builtin_functions = {}\n\n def patch_extension_kwds(self, kwds):\n pass\n\n def find_module(self, module_name, path, so_suffixes):\n try:\n f, filename, descr = imp.find_module(module_name, path)\n except ImportError:\n return None\n if f is not None:\n f.close()\n # Note that after a setuptools installation, there are both .py\n # and .so files with the same basename. The code here relies on\n # imp.find_module() locating the .so in priority.\n if descr[0] not in so_suffixes:\n return None\n return filename\n\n def collect_types(self):\n self._typesdict = {}\n self._generate(\"collecttype\")\n\n def _prnt(self, what=''):\n self._f.write(what + '\\n')\n\n def _gettypenum(self, type):\n # a KeyError here is a bug. please report it! :-)\n return self._typesdict[type]\n\n def _do_collect_type(self, tp):\n if ((not isinstance(tp, model.PrimitiveType)\n or tp.name == 'long double')\n and tp not in self._typesdict):\n num = len(self._typesdict)\n self._typesdict[tp] = num\n\n def write_source_to_f(self):\n self.collect_types()\n #\n # The new module will have a _cffi_setup() function that receives\n # objects from the ffi world, and that calls some setup code in\n # the module. This setup code is split in several independent\n # functions, e.g. one per constant. The functions are \"chained\"\n # by ending in a tail call to each other.\n #\n # This is further split in two chained lists, depending on if we\n # can do it at import-time or if we must wait for _cffi_setup() to\n # provide us with the objects. This is needed because we\n # need the values of the enum constants in order to build the\n # that we may have to pass to _cffi_setup().\n #\n # The following two 'chained_list_constants' items contains\n # the head of these two chained lists, as a string that gives the\n # call to do, if any.\n self._chained_list_constants = ['((void)lib,0)', '((void)lib,0)']\n #\n prnt = self._prnt\n # first paste some standard set of lines that are mostly '#define'\n prnt(cffimod_header)\n prnt()\n # then paste the C source given by the user, verbatim.\n prnt(self.verifier.preamble)\n prnt()\n #\n # call generate_cpy_xxx_decl(), for every xxx found from\n # ffi._parser._declarations. This generates all the functions.\n self._generate(\"decl\")\n #\n # implement the function _cffi_setup_custom() as calling the\n # head of the chained list.\n self._generate_setup_custom()\n prnt()\n #\n # produce the method table, including the entries for the\n # generated Python->C function wrappers, which are done\n # by generate_cpy_function_method().\n prnt('static PyMethodDef _cffi_methods[] = {')\n self._generate(\"method\")\n prnt(' {\"_cffi_setup\", _cffi_setup, METH_VARARGS, NULL},')\n prnt(' {NULL, NULL, 0, NULL} /* Sentinel */')\n prnt('};')\n prnt()\n #\n # standard init.\n modname = self.verifier.get_module_name()\n constants = self._chained_list_constants[False]\n prnt('#if PY_MAJOR_VERSION >= 3')\n prnt()\n prnt('static struct PyModuleDef _cffi_module_def = {')\n prnt(' PyModuleDef_HEAD_INIT,')\n prnt(' \"%s\",' % modname)\n prnt(' NULL,')\n prnt(' -1,')\n prnt(' _cffi_methods,')\n prnt(' NULL, NULL, NULL, NULL')\n prnt('};')\n prnt()\n prnt('PyMODINIT_FUNC')\n prnt('PyInit_%s(void)' % modname)\n prnt('{')\n prnt(' PyObject *lib;')\n prnt(' lib = PyModule_Create(&_cffi_module_def);')\n prnt(' if (lib == NULL)')\n prnt(' return NULL;')\n prnt(' if (%s < 0 || _cffi_init() < 0) {' % (constants,))\n prnt(' Py_DECREF(lib);')\n prnt(' return NULL;')\n prnt(' }')\n prnt(' return lib;')\n prnt('}')\n prnt()\n prnt('#else')\n prnt()\n prnt('PyMODINIT_FUNC')\n prnt('init%s(void)' % modname)\n prnt('{')\n prnt(' PyObject *lib;')\n prnt(' lib = Py_InitModule(\"%s\", _cffi_methods);' % modname)\n prnt(' if (lib == NULL)')\n prnt(' return;')\n prnt(' if (%s < 0 || _cffi_init() < 0)' % (constants,))\n prnt(' return;')\n prnt(' return;')\n prnt('}')\n prnt()\n prnt('#endif')\n\n def load_library(self, flags=None):\n # XXX review all usages of 'self' here!\n # import it as a new extension module\n imp.acquire_lock()\n try:\n if hasattr(sys, \"getdlopenflags\"):\n previous_flags = sys.getdlopenflags()\n try:\n if hasattr(sys, \"setdlopenflags\") and flags is not None:\n sys.setdlopenflags(flags)\n module = imp.load_dynamic(self.verifier.get_module_name(),\n self.verifier.modulefilename)\n except ImportError as e:\n error = \"importing %r: %s\" % (self.verifier.modulefilename, e)\n raise VerificationError(error)\n finally:\n if hasattr(sys, \"setdlopenflags\"):\n sys.setdlopenflags(previous_flags)\n finally:\n imp.release_lock()\n #\n # call loading_cpy_struct() to get the struct layout inferred by\n # the C compiler\n self._load(module, 'loading')\n #\n # the C code will need the objects. Collect them in\n # order in a list.\n revmapping = dict([(value, key)\n for (key, value) in self._typesdict.items()])\n lst = [revmapping[i] for i in range(len(revmapping))]\n lst = list(map(self.ffi._get_cached_btype, lst))\n #\n # build the FFILibrary class and instance and call _cffi_setup().\n # this will set up some fields like '_cffi_types', and only then\n # it will invoke the chained list of functions that will really\n # build (notably) the constant objects, as if they are\n # pointers, and store them as attributes on the 'library' object.\n class FFILibrary(object):\n _cffi_python_module = module\n _cffi_ffi = self.ffi\n _cffi_dir = []\n def __dir__(self):\n return FFILibrary._cffi_dir + list(self.__dict__)\n library = FFILibrary()\n if module._cffi_setup(lst, VerificationError, library):\n import warnings\n warnings.warn(\"reimporting %r might overwrite older definitions\"\n % (self.verifier.get_module_name()))\n #\n # finally, call the loaded_cpy_xxx() functions. This will perform\n # the final adjustments, like copying the Python->C wrapper\n # functions from the module to the 'library' object, and setting\n # up the FFILibrary class with properties for the global C variables.\n self._load(module, 'loaded', library=library)\n module._cffi_original_ffi = self.ffi\n module._cffi_types_of_builtin_funcs = self._types_of_builtin_functions\n return library\n\n def _get_declarations(self):\n lst = [(key, tp) for (key, (tp, qual)) in\n self.ffi._parser._declarations.items()]\n lst.sort()\n return lst\n\n def _generate(self, step_name):\n for name, tp in self._get_declarations():\n kind, realname = name.split(' ', 1)\n try:\n method = getattr(self, '_generate_cpy_%s_%s' % (kind,\n step_name))\n except AttributeError:\n raise VerificationError(\n \"not implemented in verify(): %r\" % name)\n try:\n method(tp, realname)\n except Exception as e:\n model.attach_exception_info(e, name)\n raise\n\n def _load(self, module, step_name, **kwds):\n for name, tp in self._get_declarations():\n kind, realname = name.split(' ', 1)\n method = getattr(self, '_%s_cpy_%s' % (step_name, kind))\n try:\n method(tp, realname, module, **kwds)\n except Exception as e:\n model.attach_exception_info(e, name)\n raise\n\n def _generate_nothing(self, tp, name):\n pass\n\n def _loaded_noop(self, tp, name, module, **kwds):\n pass\n\n # ----------\n\n def _convert_funcarg_to_c(self, tp, fromvar, tovar, errcode):\n extraarg = ''\n if isinstance(tp, model.PrimitiveType):\n if tp.is_integer_type() and tp.name != '_Bool':\n converter = '_cffi_to_c_int'\n extraarg = ', %s' % tp.name\n else:\n converter = '(%s)_cffi_to_c_%s' % (tp.get_c_name(''),\n tp.name.replace(' ', '_'))\n errvalue = '-1'\n #\n elif isinstance(tp, model.PointerType):\n self._convert_funcarg_to_c_ptr_or_array(tp, fromvar,\n tovar, errcode)\n return\n #\n elif isinstance(tp, (model.StructOrUnion, model.EnumType)):\n # a struct (not a struct pointer) as a function argument\n self._prnt(' if (_cffi_to_c((char *)&%s, _cffi_type(%d), %s) < 0)'\n % (tovar, self._gettypenum(tp), fromvar))\n self._prnt(' %s;' % errcode)\n return\n #\n elif isinstance(tp, model.FunctionPtrType):\n converter = '(%s)_cffi_to_c_pointer' % tp.get_c_name('')\n extraarg = ', _cffi_type(%d)' % self._gettypenum(tp)\n errvalue = 'NULL'\n #\n else:\n raise NotImplementedError(tp)\n #\n self._prnt(' %s = %s(%s%s);' % (tovar, converter, fromvar, extraarg))\n self._prnt(' if (%s == (%s)%s && PyErr_Occurred())' % (\n tovar, tp.get_c_name(''), errvalue))\n self._prnt(' %s;' % errcode)\n\n def _extra_local_variables(self, tp, localvars):\n if isinstance(tp, model.PointerType):\n localvars.add('Py_ssize_t datasize')\n\n def _convert_funcarg_to_c_ptr_or_array(self, tp, fromvar, tovar, errcode):\n self._prnt(' datasize = _cffi_prepare_pointer_call_argument(')\n self._prnt(' _cffi_type(%d), %s, (char **)&%s);' % (\n self._gettypenum(tp), fromvar, tovar))\n self._prnt(' if (datasize != 0) {')\n self._prnt(' if (datasize < 0)')\n self._prnt(' %s;' % errcode)\n self._prnt(' %s = alloca((size_t)datasize);' % (tovar,))\n self._prnt(' memset((void *)%s, 0, (size_t)datasize);' % (tovar,))\n self._prnt(' if (_cffi_convert_array_from_object('\n '(char *)%s, _cffi_type(%d), %s) < 0)' % (\n tovar, self._gettypenum(tp), fromvar))\n self._prnt(' %s;' % errcode)\n self._prnt(' }')\n\n def _convert_expr_from_c(self, tp, var, context):\n if isinstance(tp, model.PrimitiveType):\n if tp.is_integer_type() and tp.name != '_Bool':\n return '_cffi_from_c_int(%s, %s)' % (var, tp.name)\n elif tp.name != 'long double':\n return '_cffi_from_c_%s(%s)' % (tp.name.replace(' ', '_'), var)\n else:\n return '_cffi_from_c_deref((char *)&%s, _cffi_type(%d))' % (\n var, self._gettypenum(tp))\n elif isinstance(tp, (model.PointerType, model.FunctionPtrType)):\n return '_cffi_from_c_pointer((char *)%s, _cffi_type(%d))' % (\n var, self._gettypenum(tp))\n elif isinstance(tp, model.ArrayType):\n return '_cffi_from_c_pointer((char *)%s, _cffi_type(%d))' % (\n var, self._gettypenum(model.PointerType(tp.item)))\n elif isinstance(tp, model.StructOrUnion):\n if tp.fldnames is None:\n raise TypeError(\"'%s' is used as %s, but is opaque\" % (\n tp._get_c_name(), context))\n return '_cffi_from_c_struct((char *)&%s, _cffi_type(%d))' % (\n var, self._gettypenum(tp))\n elif isinstance(tp, model.EnumType):\n return '_cffi_from_c_deref((char *)&%s, _cffi_type(%d))' % (\n var, self._gettypenum(tp))\n else:\n raise NotImplementedError(tp)\n\n # ----------\n # typedefs: generates no code so far\n\n _generate_cpy_typedef_collecttype = _generate_nothing\n _generate_cpy_typedef_decl = _generate_nothing\n _generate_cpy_typedef_method = _generate_nothing\n _loading_cpy_typedef = _loaded_noop\n _loaded_cpy_typedef = _loaded_noop\n\n # ----------\n # function declarations\n\n def _generate_cpy_function_collecttype(self, tp, name):\n assert isinstance(tp, model.FunctionPtrType)\n if tp.ellipsis:\n self._do_collect_type(tp)\n else:\n # don't call _do_collect_type(tp) in this common case,\n # otherwise test_autofilled_struct_as_argument fails\n for type in tp.args:\n self._do_collect_type(type)\n self._do_collect_type(tp.result)\n\n def _generate_cpy_function_decl(self, tp, name):\n assert isinstance(tp, model.FunctionPtrType)\n if tp.ellipsis:\n # cannot support vararg functions better than this: check for its\n # exact type (including the fixed arguments), and build it as a\n # constant function pointer (no CPython wrapper)\n self._generate_cpy_const(False, name, tp)\n return\n prnt = self._prnt\n numargs = len(tp.args)\n if numargs == 0:\n argname = 'noarg'\n elif numargs == 1:\n argname = 'arg0'\n else:\n argname = 'args'\n prnt('static PyObject *')\n prnt('_cffi_f_%s(PyObject *self, PyObject *%s)' % (name, argname))\n prnt('{')\n #\n context = 'argument of %s' % name\n for i, type in enumerate(tp.args):\n prnt(' %s;' % type.get_c_name(' x%d' % i, context))\n #\n localvars = set()\n for type in tp.args:\n self._extra_local_variables(type, localvars)\n for decl in localvars:\n prnt(' %s;' % (decl,))\n #\n if not isinstance(tp.result, model.VoidType):\n result_code = 'result = '\n context = 'result of %s' % name\n prnt(' %s;' % tp.result.get_c_name(' result', context))\n else:\n result_code = ''\n #\n if len(tp.args) > 1:\n rng = range(len(tp.args))\n for i in rng:\n prnt(' PyObject *arg%d;' % i)\n prnt()\n prnt(' if (!PyArg_ParseTuple(args, \"%s:%s\", %s))' % (\n 'O' * numargs, name, ', '.join(['&arg%d' % i for i in rng])))\n prnt(' return NULL;')\n prnt()\n #\n for i, type in enumerate(tp.args):\n self._convert_funcarg_to_c(type, 'arg%d' % i, 'x%d' % i,\n 'return NULL')\n prnt()\n #\n prnt(' Py_BEGIN_ALLOW_THREADS')\n prnt(' _cffi_restore_errno();')\n prnt(' { %s%s(%s); }' % (\n result_code, name,\n ', '.join(['x%d' % i for i in range(len(tp.args))])))\n prnt(' _cffi_save_errno();')\n prnt(' Py_END_ALLOW_THREADS')\n prnt()\n #\n prnt(' (void)self; /* unused */')\n if numargs == 0:\n prnt(' (void)noarg; /* unused */')\n if result_code:\n prnt(' return %s;' %\n self._convert_expr_from_c(tp.result, 'result', 'result type'))\n else:\n prnt(' Py_INCREF(Py_None);')\n prnt(' return Py_None;')\n prnt('}')\n prnt()\n\n def _generate_cpy_function_method(self, tp, name):\n if tp.ellipsis:\n return\n numargs = len(tp.args)\n if numargs == 0:\n meth = 'METH_NOARGS'\n elif numargs == 1:\n meth = 'METH_O'\n else:\n meth = 'METH_VARARGS'\n self._prnt(' {\"%s\", _cffi_f_%s, %s, NULL},' % (name, name, meth))\n\n _loading_cpy_function = _loaded_noop\n\n def _loaded_cpy_function(self, tp, name, module, library):\n if tp.ellipsis:\n return\n func = getattr(module, name)\n setattr(library, name, func)\n self._types_of_builtin_functions[func] = tp\n\n # ----------\n # named structs\n\n _generate_cpy_struct_collecttype = _generate_nothing\n def _generate_cpy_struct_decl(self, tp, name):\n assert name == tp.name\n self._generate_struct_or_union_decl(tp, 'struct', name)\n def _generate_cpy_struct_method(self, tp, name):\n self._generate_struct_or_union_method(tp, 'struct', name)\n def _loading_cpy_struct(self, tp, name, module):\n self._loading_struct_or_union(tp, 'struct', name, module)\n def _loaded_cpy_struct(self, tp, name, module, **kwds):\n self._loaded_struct_or_union(tp)\n\n _generate_cpy_union_collecttype = _generate_nothing\n def _generate_cpy_union_decl(self, tp, name):\n assert name == tp.name\n self._generate_struct_or_union_decl(tp, 'union', name)\n def _generate_cpy_union_method(self, tp, name):\n self._generate_struct_or_union_method(tp, 'union', name)\n def _loading_cpy_union(self, tp, name, module):\n self._loading_struct_or_union(tp, 'union', name, module)\n def _loaded_cpy_union(self, tp, name, module, **kwds):\n self._loaded_struct_or_union(tp)\n\n def _generate_struct_or_union_decl(self, tp, prefix, name):\n if tp.fldnames is None:\n return # nothing to do with opaque structs\n checkfuncname = '_cffi_check_%s_%s' % (prefix, name)\n layoutfuncname = '_cffi_layout_%s_%s' % (prefix, name)\n cname = ('%s %s' % (prefix, name)).strip()\n #\n prnt = self._prnt\n prnt('static void %s(%s *p)' % (checkfuncname, cname))\n prnt('{')\n prnt(' /* only to generate compile-time warnings or errors */')\n prnt(' (void)p;')\n for fname, ftype, fbitsize, fqual in tp.enumfields():\n if (isinstance(ftype, model.PrimitiveType)\n and ftype.is_integer_type()) or fbitsize >= 0:\n # accept all integers, but complain on float or double\n prnt(' (void)((p->%s) << 1);' % fname)\n else:\n # only accept exactly the type declared.\n try:\n prnt(' { %s = &p->%s; (void)tmp; }' % (\n ftype.get_c_name('*tmp', 'field %r'%fname, quals=fqual),\n fname))\n except VerificationError as e:\n prnt(' /* %s */' % str(e)) # cannot verify it, ignore\n prnt('}')\n prnt('static PyObject *')\n prnt('%s(PyObject *self, PyObject *noarg)' % (layoutfuncname,))\n prnt('{')\n prnt(' struct _cffi_aligncheck { char x; %s y; };' % cname)\n prnt(' static Py_ssize_t nums[] = {')\n prnt(' sizeof(%s),' % cname)\n prnt(' offsetof(struct _cffi_aligncheck, y),')\n for fname, ftype, fbitsize, fqual in tp.enumfields():\n if fbitsize >= 0:\n continue # xxx ignore fbitsize for now\n prnt(' offsetof(%s, %s),' % (cname, fname))\n if isinstance(ftype, model.ArrayType) and ftype.length is None:\n prnt(' 0, /* %s */' % ftype._get_c_name())\n else:\n prnt(' sizeof(((%s *)0)->%s),' % (cname, fname))\n prnt(' -1')\n prnt(' };')\n prnt(' (void)self; /* unused */')\n prnt(' (void)noarg; /* unused */')\n prnt(' return _cffi_get_struct_layout(nums);')\n prnt(' /* the next line is not executed, but compiled */')\n prnt(' %s(0);' % (checkfuncname,))\n prnt('}')\n prnt()\n\n def _generate_struct_or_union_method(self, tp, prefix, name):\n if tp.fldnames is None:\n return # nothing to do with opaque structs\n layoutfuncname = '_cffi_layout_%s_%s' % (prefix, name)\n self._prnt(' {\"%s\", %s, METH_NOARGS, NULL},' % (layoutfuncname,\n layoutfuncname))\n\n def _loading_struct_or_union(self, tp, prefix, name, module):\n if tp.fldnames is None:\n return # nothing to do with opaque structs\n layoutfuncname = '_cffi_layout_%s_%s' % (prefix, name)\n #\n function = getattr(module, layoutfuncname)\n layout = function()\n if isinstance(tp, model.StructOrUnion) and tp.partial:\n # use the function()'s sizes and offsets to guide the\n # layout of the struct\n totalsize = layout[0]\n totalalignment = layout[1]\n fieldofs = layout[2::2]\n fieldsize = layout[3::2]\n tp.force_flatten()\n assert len(fieldofs) == len(fieldsize) == len(tp.fldnames)\n tp.fixedlayout = fieldofs, fieldsize, totalsize, totalalignment\n else:\n cname = ('%s %s' % (prefix, name)).strip()\n self._struct_pending_verification[tp] = layout, cname\n\n def _loaded_struct_or_union(self, tp):\n if tp.fldnames is None:\n return # nothing to do with opaque structs\n self.ffi._get_cached_btype(tp) # force 'fixedlayout' to be considered\n\n if tp in self._struct_pending_verification:\n # check that the layout sizes and offsets match the real ones\n def check(realvalue, expectedvalue, msg):\n if realvalue != expectedvalue:\n raise VerificationError(\n \"%s (we have %d, but C compiler says %d)\"\n % (msg, expectedvalue, realvalue))\n ffi = self.ffi\n BStruct = ffi._get_cached_btype(tp)\n layout, cname = self._struct_pending_verification.pop(tp)\n check(layout[0], ffi.sizeof(BStruct), \"wrong total size\")\n check(layout[1], ffi.alignof(BStruct), \"wrong total alignment\")\n i = 2\n for fname, ftype, fbitsize, fqual in tp.enumfields():\n if fbitsize >= 0:\n continue # xxx ignore fbitsize for now\n check(layout[i], ffi.offsetof(BStruct, fname),\n \"wrong offset for field %r\" % (fname,))\n if layout[i+1] != 0:\n BField = ffi._get_cached_btype(ftype)\n check(layout[i+1], ffi.sizeof(BField),\n \"wrong size for field %r\" % (fname,))\n i += 2\n assert i == len(layout)\n\n # ----------\n # 'anonymous' declarations. These are produced for anonymous structs\n # or unions; the 'name' is obtained by a typedef.\n\n _generate_cpy_anonymous_collecttype = _generate_nothing\n\n def _generate_cpy_anonymous_decl(self, tp, name):\n if isinstance(tp, model.EnumType):\n self._generate_cpy_enum_decl(tp, name, '')\n else:\n self._generate_struct_or_union_decl(tp, '', name)\n\n def _generate_cpy_anonymous_method(self, tp, name):\n if not isinstance(tp, model.EnumType):\n self._generate_struct_or_union_method(tp, '', name)\n\n def _loading_cpy_anonymous(self, tp, name, module):\n if isinstance(tp, model.EnumType):\n self._loading_cpy_enum(tp, name, module)\n else:\n self._loading_struct_or_union(tp, '', name, module)\n\n def _loaded_cpy_anonymous(self, tp, name, module, **kwds):\n if isinstance(tp, model.EnumType):\n self._loaded_cpy_enum(tp, name, module, **kwds)\n else:\n self._loaded_struct_or_union(tp)\n\n # ----------\n # constants, likely declared with '#define'\n\n def _generate_cpy_const(self, is_int, name, tp=None, category='const',\n vartp=None, delayed=True, size_too=False,\n check_value=None):\n prnt = self._prnt\n funcname = '_cffi_%s_%s' % (category, name)\n prnt('static int %s(PyObject *lib)' % funcname)\n prnt('{')\n prnt(' PyObject *o;')\n prnt(' int res;')\n if not is_int:\n prnt(' %s;' % (vartp or tp).get_c_name(' i', name))\n else:\n assert category == 'const'\n #\n if check_value is not None:\n self._check_int_constant_value(name, check_value)\n #\n if not is_int:\n if category == 'var':\n realexpr = '&' + name\n else:\n realexpr = name\n prnt(' i = (%s);' % (realexpr,))\n prnt(' o = %s;' % (self._convert_expr_from_c(tp, 'i',\n 'variable type'),))\n assert delayed\n else:\n prnt(' o = _cffi_from_c_int_const(%s);' % name)\n prnt(' if (o == NULL)')\n prnt(' return -1;')\n if size_too:\n prnt(' {')\n prnt(' PyObject *o1 = o;')\n prnt(' o = Py_BuildValue(\"On\", o1, (Py_ssize_t)sizeof(%s));'\n % (name,))\n prnt(' Py_DECREF(o1);')\n prnt(' if (o == NULL)')\n prnt(' return -1;')\n prnt(' }')\n prnt(' res = PyObject_SetAttrString(lib, \"%s\", o);' % name)\n prnt(' Py_DECREF(o);')\n prnt(' if (res < 0)')\n prnt(' return -1;')\n prnt(' return %s;' % self._chained_list_constants[delayed])\n self._chained_list_constants[delayed] = funcname + '(lib)'\n prnt('}')\n prnt()\n\n def _generate_cpy_constant_collecttype(self, tp, name):\n is_int = isinstance(tp, model.PrimitiveType) and tp.is_integer_type()\n if not is_int:\n self._do_collect_type(tp)\n\n def _generate_cpy_constant_decl(self, tp, name):\n is_int = isinstance(tp, model.PrimitiveType) and tp.is_integer_type()\n self._generate_cpy_const(is_int, name, tp)\n\n _generate_cpy_constant_method = _generate_nothing\n _loading_cpy_constant = _loaded_noop\n _loaded_cpy_constant = _loaded_noop\n\n # ----------\n # enums\n\n def _check_int_constant_value(self, name, value, err_prefix=''):\n prnt = self._prnt\n if value <= 0:\n prnt(' if ((%s) > 0 || (long)(%s) != %dL) {' % (\n name, name, value))\n else:\n prnt(' if ((%s) <= 0 || (unsigned long)(%s) != %dUL) {' % (\n name, name, value))\n prnt(' char buf[64];')\n prnt(' if ((%s) <= 0)' % name)\n prnt(' snprintf(buf, 63, \"%%ld\", (long)(%s));' % name)\n prnt(' else')\n prnt(' snprintf(buf, 63, \"%%lu\", (unsigned long)(%s));' %\n name)\n prnt(' PyErr_Format(_cffi_VerificationError,')\n prnt(' \"%s%s has the real value %s, not %s\",')\n prnt(' \"%s\", \"%s\", buf, \"%d\");' % (\n err_prefix, name, value))\n prnt(' return -1;')\n prnt(' }')\n\n def _enum_funcname(self, prefix, name):\n # \"$enum_$1\" => \"___D_enum____D_1\"\n name = name.replace('$', '___D_')\n return '_cffi_e_%s_%s' % (prefix, name)\n\n def _generate_cpy_enum_decl(self, tp, name, prefix='enum'):\n if tp.partial:\n for enumerator in tp.enumerators:\n self._generate_cpy_const(True, enumerator, delayed=False)\n return\n #\n funcname = self._enum_funcname(prefix, name)\n prnt = self._prnt\n prnt('static int %s(PyObject *lib)' % funcname)\n prnt('{')\n for enumerator, enumvalue in zip(tp.enumerators, tp.enumvalues):\n self._check_int_constant_value(enumerator, enumvalue,\n \"enum %s: \" % name)\n prnt(' return %s;' % self._chained_list_constants[True])\n self._chained_list_constants[True] = funcname + '(lib)'\n prnt('}')\n prnt()\n\n _generate_cpy_enum_collecttype = _generate_nothing\n _generate_cpy_enum_method = _generate_nothing\n\n def _loading_cpy_enum(self, tp, name, module):\n if tp.partial:\n enumvalues = [getattr(module, enumerator)\n for enumerator in tp.enumerators]\n tp.enumvalues = tuple(enumvalues)\n tp.partial_resolved = True\n\n def _loaded_cpy_enum(self, tp, name, module, library):\n for enumerator, enumvalue in zip(tp.enumerators, tp.enumvalues):\n setattr(library, enumerator, enumvalue)\n\n # ----------\n # macros: for now only for integers\n\n def _generate_cpy_macro_decl(self, tp, name):\n if tp == '...':\n check_value = None\n else:\n check_value = tp # an integer\n self._generate_cpy_const(True, name, check_value=check_value)\n\n _generate_cpy_macro_collecttype = _generate_nothing\n _generate_cpy_macro_method = _generate_nothing\n _loading_cpy_macro = _loaded_noop\n _loaded_cpy_macro = _loaded_noop\n\n # ----------\n # global variables\n\n def _generate_cpy_variable_collecttype(self, tp, name):\n if isinstance(tp, model.ArrayType):\n tp_ptr = model.PointerType(tp.item)\n else:\n tp_ptr = model.PointerType(tp)\n self._do_collect_type(tp_ptr)\n\n def _generate_cpy_variable_decl(self, tp, name):\n if isinstance(tp, model.ArrayType):\n tp_ptr = model.PointerType(tp.item)\n self._generate_cpy_const(False, name, tp, vartp=tp_ptr,\n size_too = (tp.length == '...'))\n else:\n tp_ptr = model.PointerType(tp)\n self._generate_cpy_const(False, name, tp_ptr, category='var')\n\n _generate_cpy_variable_method = _generate_nothing\n _loading_cpy_variable = _loaded_noop\n\n def _loaded_cpy_variable(self, tp, name, module, library):\n value = getattr(library, name)\n if isinstance(tp, model.ArrayType): # int a[5] is \"constant\" in the\n # sense that \"a=...\" is forbidden\n if tp.length == '...':\n assert isinstance(value, tuple)\n (value, size) = value\n BItemType = self.ffi._get_cached_btype(tp.item)\n length, rest = divmod(size, self.ffi.sizeof(BItemType))\n if rest != 0:\n raise VerificationError(\n \"bad size: %r does not seem to be an array of %s\" %\n (name, tp.item))\n tp = tp.resolve_length(length)\n # 'value' is a which we have to replace with\n # a if the N is actually known\n if tp.length is not None:\n BArray = self.ffi._get_cached_btype(tp)\n value = self.ffi.cast(BArray, value)\n setattr(library, name, value)\n return\n # remove ptr= from the library instance, and replace\n # it by a property on the class, which reads/writes into ptr[0].\n ptr = value\n delattr(library, name)\n def getter(library):\n return ptr[0]\n def setter(library, value):\n ptr[0] = value\n setattr(type(library), name, property(getter, setter))\n type(library)._cffi_dir.append(name)\n\n # ----------\n\n def _generate_setup_custom(self):\n prnt = self._prnt\n prnt('static int _cffi_setup_custom(PyObject *lib)')\n prnt('{')\n prnt(' return %s;' % self._chained_list_constants[True])\n prnt('}')\n\ncffimod_header = r'''\n#include \n#include \n\n/* this block of #ifs should be kept exactly identical between\n c/_cffi_backend.c, cffi/vengine_cpy.py, cffi/vengine_gen.py\n and cffi/_cffi_include.h */\n#if defined(_MSC_VER)\n# include /* for alloca() */\n# if _MSC_VER < 1600 /* MSVC < 2010 */\n typedef __int8 int8_t;\n typedef __int16 int16_t;\n typedef __int32 int32_t;\n typedef __int64 int64_t;\n typedef unsigned __int8 uint8_t;\n typedef unsigned __int16 uint16_t;\n typedef unsigned __int32 uint32_t;\n typedef unsigned __int64 uint64_t;\n typedef __int8 int_least8_t;\n typedef __int16 int_least16_t;\n typedef __int32 int_least32_t;\n typedef __int64 int_least64_t;\n typedef unsigned __int8 uint_least8_t;\n typedef unsigned __int16 uint_least16_t;\n typedef unsigned __int32 uint_least32_t;\n typedef unsigned __int64 uint_least64_t;\n typedef __int8 int_fast8_t;\n typedef __int16 int_fast16_t;\n typedef __int32 int_fast32_t;\n typedef __int64 int_fast64_t;\n typedef unsigned __int8 uint_fast8_t;\n typedef unsigned __int16 uint_fast16_t;\n typedef unsigned __int32 uint_fast32_t;\n typedef unsigned __int64 uint_fast64_t;\n typedef __int64 intmax_t;\n typedef unsigned __int64 uintmax_t;\n# else\n# include \n# endif\n# if _MSC_VER < 1800 /* MSVC < 2013 */\n# ifndef __cplusplus\n typedef unsigned char _Bool;\n# endif\n# endif\n#else\n# include \n# if (defined (__SVR4) && defined (__sun)) || defined(_AIX) || defined(__hpux)\n# include \n# endif\n#endif\n\n#if PY_MAJOR_VERSION < 3\n# undef PyCapsule_CheckExact\n# undef PyCapsule_GetPointer\n# define PyCapsule_CheckExact(capsule) (PyCObject_Check(capsule))\n# define PyCapsule_GetPointer(capsule, name) \\\n (PyCObject_AsVoidPtr(capsule))\n#endif\n\n#if PY_MAJOR_VERSION >= 3\n# define PyInt_FromLong PyLong_FromLong\n#endif\n\n#define _cffi_from_c_double PyFloat_FromDouble\n#define _cffi_from_c_float PyFloat_FromDouble\n#define _cffi_from_c_long PyInt_FromLong\n#define _cffi_from_c_ulong PyLong_FromUnsignedLong\n#define _cffi_from_c_longlong PyLong_FromLongLong\n#define _cffi_from_c_ulonglong PyLong_FromUnsignedLongLong\n#define _cffi_from_c__Bool PyBool_FromLong\n\n#define _cffi_to_c_double PyFloat_AsDouble\n#define _cffi_to_c_float PyFloat_AsDouble\n\n#define _cffi_from_c_int_const(x) \\\n (((x) > 0) ? \\\n ((unsigned long long)(x) <= (unsigned long long)LONG_MAX) ? \\\n PyInt_FromLong((long)(x)) : \\\n PyLong_FromUnsignedLongLong((unsigned long long)(x)) : \\\n ((long long)(x) >= (long long)LONG_MIN) ? \\\n PyInt_FromLong((long)(x)) : \\\n PyLong_FromLongLong((long long)(x)))\n\n#define _cffi_from_c_int(x, type) \\\n (((type)-1) > 0 ? /* unsigned */ \\\n (sizeof(type) < sizeof(long) ? \\\n PyInt_FromLong((long)x) : \\\n sizeof(type) == sizeof(long) ? \\\n PyLong_FromUnsignedLong((unsigned long)x) : \\\n PyLong_FromUnsignedLongLong((unsigned long long)x)) : \\\n (sizeof(type) <= sizeof(long) ? \\\n PyInt_FromLong((long)x) : \\\n PyLong_FromLongLong((long long)x)))\n\n#define _cffi_to_c_int(o, type) \\\n ((type)( \\\n sizeof(type) == 1 ? (((type)-1) > 0 ? (type)_cffi_to_c_u8(o) \\\n : (type)_cffi_to_c_i8(o)) : \\\n sizeof(type) == 2 ? (((type)-1) > 0 ? (type)_cffi_to_c_u16(o) \\\n : (type)_cffi_to_c_i16(o)) : \\\n sizeof(type) == 4 ? (((type)-1) > 0 ? (type)_cffi_to_c_u32(o) \\\n : (type)_cffi_to_c_i32(o)) : \\\n sizeof(type) == 8 ? (((type)-1) > 0 ? (type)_cffi_to_c_u64(o) \\\n : (type)_cffi_to_c_i64(o)) : \\\n (Py_FatalError(\"unsupported size for type \" #type), (type)0)))\n\n#define _cffi_to_c_i8 \\\n ((int(*)(PyObject *))_cffi_exports[1])\n#define _cffi_to_c_u8 \\\n ((int(*)(PyObject *))_cffi_exports[2])\n#define _cffi_to_c_i16 \\\n ((int(*)(PyObject *))_cffi_exports[3])\n#define _cffi_to_c_u16 \\\n ((int(*)(PyObject *))_cffi_exports[4])\n#define _cffi_to_c_i32 \\\n ((int(*)(PyObject *))_cffi_exports[5])\n#define _cffi_to_c_u32 \\\n ((unsigned int(*)(PyObject *))_cffi_exports[6])\n#define _cffi_to_c_i64 \\\n ((long long(*)(PyObject *))_cffi_exports[7])\n#define _cffi_to_c_u64 \\\n ((unsigned long long(*)(PyObject *))_cffi_exports[8])\n#define _cffi_to_c_char \\\n ((int(*)(PyObject *))_cffi_exports[9])\n#define _cffi_from_c_pointer \\\n ((PyObject *(*)(char *, CTypeDescrObject *))_cffi_exports[10])\n#define _cffi_to_c_pointer \\\n ((char *(*)(PyObject *, CTypeDescrObject *))_cffi_exports[11])\n#define _cffi_get_struct_layout \\\n ((PyObject *(*)(Py_ssize_t[]))_cffi_exports[12])\n#define _cffi_restore_errno \\\n ((void(*)(void))_cffi_exports[13])\n#define _cffi_save_errno \\\n ((void(*)(void))_cffi_exports[14])\n#define _cffi_from_c_char \\\n ((PyObject *(*)(char))_cffi_exports[15])\n#define _cffi_from_c_deref \\\n ((PyObject *(*)(char *, CTypeDescrObject *))_cffi_exports[16])\n#define _cffi_to_c \\\n ((int(*)(char *, CTypeDescrObject *, PyObject *))_cffi_exports[17])\n#define _cffi_from_c_struct \\\n ((PyObject *(*)(char *, CTypeDescrObject *))_cffi_exports[18])\n#define _cffi_to_c_wchar_t \\\n ((wchar_t(*)(PyObject *))_cffi_exports[19])\n#define _cffi_from_c_wchar_t \\\n ((PyObject *(*)(wchar_t))_cffi_exports[20])\n#define _cffi_to_c_long_double \\\n ((long double(*)(PyObject *))_cffi_exports[21])\n#define _cffi_to_c__Bool \\\n ((_Bool(*)(PyObject *))_cffi_exports[22])\n#define _cffi_prepare_pointer_call_argument \\\n ((Py_ssize_t(*)(CTypeDescrObject *, PyObject *, char **))_cffi_exports[23])\n#define _cffi_convert_array_from_object \\\n ((int(*)(char *, CTypeDescrObject *, PyObject *))_cffi_exports[24])\n#define _CFFI_NUM_EXPORTS 25\n\ntypedef struct _ctypedescr CTypeDescrObject;\n\nstatic void *_cffi_exports[_CFFI_NUM_EXPORTS];\nstatic PyObject *_cffi_types, *_cffi_VerificationError;\n\nstatic int _cffi_setup_custom(PyObject *lib); /* forward */\n\nstatic PyObject *_cffi_setup(PyObject *self, PyObject *args)\n{\n PyObject *library;\n int was_alive = (_cffi_types != NULL);\n (void)self; /* unused */\n if (!PyArg_ParseTuple(args, \"OOO\", &_cffi_types, &_cffi_VerificationError,\n &library))\n return NULL;\n Py_INCREF(_cffi_types);\n Py_INCREF(_cffi_VerificationError);\n if (_cffi_setup_custom(library) < 0)\n return NULL;\n return PyBool_FromLong(was_alive);\n}\n\nstatic int _cffi_init(void)\n{\n PyObject *module, *c_api_object = NULL;\n\n module = PyImport_ImportModule(\"_cffi_backend\");\n if (module == NULL)\n goto failure;\n\n c_api_object = PyObject_GetAttrString(module, \"_C_API\");\n if (c_api_object == NULL)\n goto failure;\n if (!PyCapsule_CheckExact(c_api_object)) {\n PyErr_SetNone(PyExc_ImportError);\n goto failure;\n }\n memcpy(_cffi_exports, PyCapsule_GetPointer(c_api_object, \"cffi\"),\n _CFFI_NUM_EXPORTS * sizeof(void *));\n\n Py_DECREF(module);\n Py_DECREF(c_api_object);\n return 0;\n\n failure:\n Py_XDECREF(module);\n Py_XDECREF(c_api_object);\n return -1;\n}\n\n#define _cffi_type(num) ((CTypeDescrObject *)PyList_GET_ITEM(_cffi_types, num))\n\n/**********/\n'''\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cffi/vengine_gen.py",
"content": "#\n# DEPRECATED: implementation for ffi.verify()\n#\nimport sys, os\nimport types\n\nfrom . import model\nfrom .error import VerificationError\n\n\nclass VGenericEngine(object):\n _class_key = 'g'\n _gen_python_module = False\n\n def __init__(self, verifier):\n self.verifier = verifier\n self.ffi = verifier.ffi\n self.export_symbols = []\n self._struct_pending_verification = {}\n\n def patch_extension_kwds(self, kwds):\n # add 'export_symbols' to the dictionary. Note that we add the\n # list before filling it. When we fill it, it will thus also show\n # up in kwds['export_symbols'].\n kwds.setdefault('export_symbols', self.export_symbols)\n\n def find_module(self, module_name, path, so_suffixes):\n for so_suffix in so_suffixes:\n basename = module_name + so_suffix\n if path is None:\n path = sys.path\n for dirname in path:\n filename = os.path.join(dirname, basename)\n if os.path.isfile(filename):\n return filename\n\n def collect_types(self):\n pass # not needed in the generic engine\n\n def _prnt(self, what=''):\n self._f.write(what + '\\n')\n\n def write_source_to_f(self):\n prnt = self._prnt\n # first paste some standard set of lines that are mostly '#include'\n prnt(cffimod_header)\n # then paste the C source given by the user, verbatim.\n prnt(self.verifier.preamble)\n #\n # call generate_gen_xxx_decl(), for every xxx found from\n # ffi._parser._declarations. This generates all the functions.\n self._generate('decl')\n #\n # on Windows, distutils insists on putting init_cffi_xyz in\n # 'export_symbols', so instead of fighting it, just give up and\n # give it one\n if sys.platform == 'win32':\n if sys.version_info >= (3,):\n prefix = 'PyInit_'\n else:\n prefix = 'init'\n modname = self.verifier.get_module_name()\n prnt(\"void %s%s(void) { }\\n\" % (prefix, modname))\n\n def load_library(self, flags=0):\n # import it with the CFFI backend\n backend = self.ffi._backend\n # needs to make a path that contains '/', on Posix\n filename = os.path.join(os.curdir, self.verifier.modulefilename)\n module = backend.load_library(filename, flags)\n #\n # call loading_gen_struct() to get the struct layout inferred by\n # the C compiler\n self._load(module, 'loading')\n\n # build the FFILibrary class and instance, this is a module subclass\n # because modules are expected to have usually-constant-attributes and\n # in PyPy this means the JIT is able to treat attributes as constant,\n # which we want.\n class FFILibrary(types.ModuleType):\n _cffi_generic_module = module\n _cffi_ffi = self.ffi\n _cffi_dir = []\n def __dir__(self):\n return FFILibrary._cffi_dir\n library = FFILibrary(\"\")\n #\n # finally, call the loaded_gen_xxx() functions. This will set\n # up the 'library' object.\n self._load(module, 'loaded', library=library)\n return library\n\n def _get_declarations(self):\n lst = [(key, tp) for (key, (tp, qual)) in\n self.ffi._parser._declarations.items()]\n lst.sort()\n return lst\n\n def _generate(self, step_name):\n for name, tp in self._get_declarations():\n kind, realname = name.split(' ', 1)\n try:\n method = getattr(self, '_generate_gen_%s_%s' % (kind,\n step_name))\n except AttributeError:\n raise VerificationError(\n \"not implemented in verify(): %r\" % name)\n try:\n method(tp, realname)\n except Exception as e:\n model.attach_exception_info(e, name)\n raise\n\n def _load(self, module, step_name, **kwds):\n for name, tp in self._get_declarations():\n kind, realname = name.split(' ', 1)\n method = getattr(self, '_%s_gen_%s' % (step_name, kind))\n try:\n method(tp, realname, module, **kwds)\n except Exception as e:\n model.attach_exception_info(e, name)\n raise\n\n def _generate_nothing(self, tp, name):\n pass\n\n def _loaded_noop(self, tp, name, module, **kwds):\n pass\n\n # ----------\n # typedefs: generates no code so far\n\n _generate_gen_typedef_decl = _generate_nothing\n _loading_gen_typedef = _loaded_noop\n _loaded_gen_typedef = _loaded_noop\n\n # ----------\n # function declarations\n\n def _generate_gen_function_decl(self, tp, name):\n assert isinstance(tp, model.FunctionPtrType)\n if tp.ellipsis:\n # cannot support vararg functions better than this: check for its\n # exact type (including the fixed arguments), and build it as a\n # constant function pointer (no _cffi_f_%s wrapper)\n self._generate_gen_const(False, name, tp)\n return\n prnt = self._prnt\n numargs = len(tp.args)\n argnames = []\n for i, type in enumerate(tp.args):\n indirection = ''\n if isinstance(type, model.StructOrUnion):\n indirection = '*'\n argnames.append('%sx%d' % (indirection, i))\n context = 'argument of %s' % name\n arglist = [type.get_c_name(' %s' % arg, context)\n for type, arg in zip(tp.args, argnames)]\n tpresult = tp.result\n if isinstance(tpresult, model.StructOrUnion):\n arglist.insert(0, tpresult.get_c_name(' *r', context))\n tpresult = model.void_type\n arglist = ', '.join(arglist) or 'void'\n wrappername = '_cffi_f_%s' % name\n self.export_symbols.append(wrappername)\n if tp.abi:\n abi = tp.abi + ' '\n else:\n abi = ''\n funcdecl = ' %s%s(%s)' % (abi, wrappername, arglist)\n context = 'result of %s' % name\n prnt(tpresult.get_c_name(funcdecl, context))\n prnt('{')\n #\n if isinstance(tp.result, model.StructOrUnion):\n result_code = '*r = '\n elif not isinstance(tp.result, model.VoidType):\n result_code = 'return '\n else:\n result_code = ''\n prnt(' %s%s(%s);' % (result_code, name, ', '.join(argnames)))\n prnt('}')\n prnt()\n\n _loading_gen_function = _loaded_noop\n\n def _loaded_gen_function(self, tp, name, module, library):\n assert isinstance(tp, model.FunctionPtrType)\n if tp.ellipsis:\n newfunction = self._load_constant(False, tp, name, module)\n else:\n indirections = []\n base_tp = tp\n if (any(isinstance(typ, model.StructOrUnion) for typ in tp.args)\n or isinstance(tp.result, model.StructOrUnion)):\n indirect_args = []\n for i, typ in enumerate(tp.args):\n if isinstance(typ, model.StructOrUnion):\n typ = model.PointerType(typ)\n indirections.append((i, typ))\n indirect_args.append(typ)\n indirect_result = tp.result\n if isinstance(indirect_result, model.StructOrUnion):\n if indirect_result.fldtypes is None:\n raise TypeError(\"'%s' is used as result type, \"\n \"but is opaque\" % (\n indirect_result._get_c_name(),))\n indirect_result = model.PointerType(indirect_result)\n indirect_args.insert(0, indirect_result)\n indirections.insert(0, (\"result\", indirect_result))\n indirect_result = model.void_type\n tp = model.FunctionPtrType(tuple(indirect_args),\n indirect_result, tp.ellipsis)\n BFunc = self.ffi._get_cached_btype(tp)\n wrappername = '_cffi_f_%s' % name\n newfunction = module.load_function(BFunc, wrappername)\n for i, typ in indirections:\n newfunction = self._make_struct_wrapper(newfunction, i, typ,\n base_tp)\n setattr(library, name, newfunction)\n type(library)._cffi_dir.append(name)\n\n def _make_struct_wrapper(self, oldfunc, i, tp, base_tp):\n backend = self.ffi._backend\n BType = self.ffi._get_cached_btype(tp)\n if i == \"result\":\n ffi = self.ffi\n def newfunc(*args):\n res = ffi.new(BType)\n oldfunc(res, *args)\n return res[0]\n else:\n def newfunc(*args):\n args = args[:i] + (backend.newp(BType, args[i]),) + args[i+1:]\n return oldfunc(*args)\n newfunc._cffi_base_type = base_tp\n return newfunc\n\n # ----------\n # named structs\n\n def _generate_gen_struct_decl(self, tp, name):\n assert name == tp.name\n self._generate_struct_or_union_decl(tp, 'struct', name)\n\n def _loading_gen_struct(self, tp, name, module):\n self._loading_struct_or_union(tp, 'struct', name, module)\n\n def _loaded_gen_struct(self, tp, name, module, **kwds):\n self._loaded_struct_or_union(tp)\n\n def _generate_gen_union_decl(self, tp, name):\n assert name == tp.name\n self._generate_struct_or_union_decl(tp, 'union', name)\n\n def _loading_gen_union(self, tp, name, module):\n self._loading_struct_or_union(tp, 'union', name, module)\n\n def _loaded_gen_union(self, tp, name, module, **kwds):\n self._loaded_struct_or_union(tp)\n\n def _generate_struct_or_union_decl(self, tp, prefix, name):\n if tp.fldnames is None:\n return # nothing to do with opaque structs\n checkfuncname = '_cffi_check_%s_%s' % (prefix, name)\n layoutfuncname = '_cffi_layout_%s_%s' % (prefix, name)\n cname = ('%s %s' % (prefix, name)).strip()\n #\n prnt = self._prnt\n prnt('static void %s(%s *p)' % (checkfuncname, cname))\n prnt('{')\n prnt(' /* only to generate compile-time warnings or errors */')\n prnt(' (void)p;')\n for fname, ftype, fbitsize, fqual in tp.enumfields():\n if (isinstance(ftype, model.PrimitiveType)\n and ftype.is_integer_type()) or fbitsize >= 0:\n # accept all integers, but complain on float or double\n prnt(' (void)((p->%s) << 1);' % fname)\n else:\n # only accept exactly the type declared.\n try:\n prnt(' { %s = &p->%s; (void)tmp; }' % (\n ftype.get_c_name('*tmp', 'field %r'%fname, quals=fqual),\n fname))\n except VerificationError as e:\n prnt(' /* %s */' % str(e)) # cannot verify it, ignore\n prnt('}')\n self.export_symbols.append(layoutfuncname)\n prnt('intptr_t %s(intptr_t i)' % (layoutfuncname,))\n prnt('{')\n prnt(' struct _cffi_aligncheck { char x; %s y; };' % cname)\n prnt(' static intptr_t nums[] = {')\n prnt(' sizeof(%s),' % cname)\n prnt(' offsetof(struct _cffi_aligncheck, y),')\n for fname, ftype, fbitsize, fqual in tp.enumfields():\n if fbitsize >= 0:\n continue # xxx ignore fbitsize for now\n prnt(' offsetof(%s, %s),' % (cname, fname))\n if isinstance(ftype, model.ArrayType) and ftype.length is None:\n prnt(' 0, /* %s */' % ftype._get_c_name())\n else:\n prnt(' sizeof(((%s *)0)->%s),' % (cname, fname))\n prnt(' -1')\n prnt(' };')\n prnt(' return nums[i];')\n prnt(' /* the next line is not executed, but compiled */')\n prnt(' %s(0);' % (checkfuncname,))\n prnt('}')\n prnt()\n\n def _loading_struct_or_union(self, tp, prefix, name, module):\n if tp.fldnames is None:\n return # nothing to do with opaque structs\n layoutfuncname = '_cffi_layout_%s_%s' % (prefix, name)\n #\n BFunc = self.ffi._typeof_locked(\"intptr_t(*)(intptr_t)\")[0]\n function = module.load_function(BFunc, layoutfuncname)\n layout = []\n num = 0\n while True:\n x = function(num)\n if x < 0: break\n layout.append(x)\n num += 1\n if isinstance(tp, model.StructOrUnion) and tp.partial:\n # use the function()'s sizes and offsets to guide the\n # layout of the struct\n totalsize = layout[0]\n totalalignment = layout[1]\n fieldofs = layout[2::2]\n fieldsize = layout[3::2]\n tp.force_flatten()\n assert len(fieldofs) == len(fieldsize) == len(tp.fldnames)\n tp.fixedlayout = fieldofs, fieldsize, totalsize, totalalignment\n else:\n cname = ('%s %s' % (prefix, name)).strip()\n self._struct_pending_verification[tp] = layout, cname\n\n def _loaded_struct_or_union(self, tp):\n if tp.fldnames is None:\n return # nothing to do with opaque structs\n self.ffi._get_cached_btype(tp) # force 'fixedlayout' to be considered\n\n if tp in self._struct_pending_verification:\n # check that the layout sizes and offsets match the real ones\n def check(realvalue, expectedvalue, msg):\n if realvalue != expectedvalue:\n raise VerificationError(\n \"%s (we have %d, but C compiler says %d)\"\n % (msg, expectedvalue, realvalue))\n ffi = self.ffi\n BStruct = ffi._get_cached_btype(tp)\n layout, cname = self._struct_pending_verification.pop(tp)\n check(layout[0], ffi.sizeof(BStruct), \"wrong total size\")\n check(layout[1], ffi.alignof(BStruct), \"wrong total alignment\")\n i = 2\n for fname, ftype, fbitsize, fqual in tp.enumfields():\n if fbitsize >= 0:\n continue # xxx ignore fbitsize for now\n check(layout[i], ffi.offsetof(BStruct, fname),\n \"wrong offset for field %r\" % (fname,))\n if layout[i+1] != 0:\n BField = ffi._get_cached_btype(ftype)\n check(layout[i+1], ffi.sizeof(BField),\n \"wrong size for field %r\" % (fname,))\n i += 2\n assert i == len(layout)\n\n # ----------\n # 'anonymous' declarations. These are produced for anonymous structs\n # or unions; the 'name' is obtained by a typedef.\n\n def _generate_gen_anonymous_decl(self, tp, name):\n if isinstance(tp, model.EnumType):\n self._generate_gen_enum_decl(tp, name, '')\n else:\n self._generate_struct_or_union_decl(tp, '', name)\n\n def _loading_gen_anonymous(self, tp, name, module):\n if isinstance(tp, model.EnumType):\n self._loading_gen_enum(tp, name, module, '')\n else:\n self._loading_struct_or_union(tp, '', name, module)\n\n def _loaded_gen_anonymous(self, tp, name, module, **kwds):\n if isinstance(tp, model.EnumType):\n self._loaded_gen_enum(tp, name, module, **kwds)\n else:\n self._loaded_struct_or_union(tp)\n\n # ----------\n # constants, likely declared with '#define'\n\n def _generate_gen_const(self, is_int, name, tp=None, category='const',\n check_value=None):\n prnt = self._prnt\n funcname = '_cffi_%s_%s' % (category, name)\n self.export_symbols.append(funcname)\n if check_value is not None:\n assert is_int\n assert category == 'const'\n prnt('int %s(char *out_error)' % funcname)\n prnt('{')\n self._check_int_constant_value(name, check_value)\n prnt(' return 0;')\n prnt('}')\n elif is_int:\n assert category == 'const'\n prnt('int %s(long long *out_value)' % funcname)\n prnt('{')\n prnt(' *out_value = (long long)(%s);' % (name,))\n prnt(' return (%s) <= 0;' % (name,))\n prnt('}')\n else:\n assert tp is not None\n assert check_value is None\n if category == 'var':\n ampersand = '&'\n else:\n ampersand = ''\n extra = ''\n if category == 'const' and isinstance(tp, model.StructOrUnion):\n extra = 'const *'\n ampersand = '&'\n prnt(tp.get_c_name(' %s%s(void)' % (extra, funcname), name))\n prnt('{')\n prnt(' return (%s%s);' % (ampersand, name))\n prnt('}')\n prnt()\n\n def _generate_gen_constant_decl(self, tp, name):\n is_int = isinstance(tp, model.PrimitiveType) and tp.is_integer_type()\n self._generate_gen_const(is_int, name, tp)\n\n _loading_gen_constant = _loaded_noop\n\n def _load_constant(self, is_int, tp, name, module, check_value=None):\n funcname = '_cffi_const_%s' % name\n if check_value is not None:\n assert is_int\n self._load_known_int_constant(module, funcname)\n value = check_value\n elif is_int:\n BType = self.ffi._typeof_locked(\"long long*\")[0]\n BFunc = self.ffi._typeof_locked(\"int(*)(long long*)\")[0]\n function = module.load_function(BFunc, funcname)\n p = self.ffi.new(BType)\n negative = function(p)\n value = int(p[0])\n if value < 0 and not negative:\n BLongLong = self.ffi._typeof_locked(\"long long\")[0]\n value += (1 << (8*self.ffi.sizeof(BLongLong)))\n else:\n assert check_value is None\n fntypeextra = '(*)(void)'\n if isinstance(tp, model.StructOrUnion):\n fntypeextra = '*' + fntypeextra\n BFunc = self.ffi._typeof_locked(tp.get_c_name(fntypeextra, name))[0]\n function = module.load_function(BFunc, funcname)\n value = function()\n if isinstance(tp, model.StructOrUnion):\n value = value[0]\n return value\n\n def _loaded_gen_constant(self, tp, name, module, library):\n is_int = isinstance(tp, model.PrimitiveType) and tp.is_integer_type()\n value = self._load_constant(is_int, tp, name, module)\n setattr(library, name, value)\n type(library)._cffi_dir.append(name)\n\n # ----------\n # enums\n\n def _check_int_constant_value(self, name, value):\n prnt = self._prnt\n if value <= 0:\n prnt(' if ((%s) > 0 || (long)(%s) != %dL) {' % (\n name, name, value))\n else:\n prnt(' if ((%s) <= 0 || (unsigned long)(%s) != %dUL) {' % (\n name, name, value))\n prnt(' char buf[64];')\n prnt(' if ((%s) <= 0)' % name)\n prnt(' sprintf(buf, \"%%ld\", (long)(%s));' % name)\n prnt(' else')\n prnt(' sprintf(buf, \"%%lu\", (unsigned long)(%s));' %\n name)\n prnt(' sprintf(out_error, \"%s has the real value %s, not %s\",')\n prnt(' \"%s\", buf, \"%d\");' % (name[:100], value))\n prnt(' return -1;')\n prnt(' }')\n\n def _load_known_int_constant(self, module, funcname):\n BType = self.ffi._typeof_locked(\"char[]\")[0]\n BFunc = self.ffi._typeof_locked(\"int(*)(char*)\")[0]\n function = module.load_function(BFunc, funcname)\n p = self.ffi.new(BType, 256)\n if function(p) < 0:\n error = self.ffi.string(p)\n if sys.version_info >= (3,):\n error = str(error, 'utf-8')\n raise VerificationError(error)\n\n def _enum_funcname(self, prefix, name):\n # \"$enum_$1\" => \"___D_enum____D_1\"\n name = name.replace('$', '___D_')\n return '_cffi_e_%s_%s' % (prefix, name)\n\n def _generate_gen_enum_decl(self, tp, name, prefix='enum'):\n if tp.partial:\n for enumerator in tp.enumerators:\n self._generate_gen_const(True, enumerator)\n return\n #\n funcname = self._enum_funcname(prefix, name)\n self.export_symbols.append(funcname)\n prnt = self._prnt\n prnt('int %s(char *out_error)' % funcname)\n prnt('{')\n for enumerator, enumvalue in zip(tp.enumerators, tp.enumvalues):\n self._check_int_constant_value(enumerator, enumvalue)\n prnt(' return 0;')\n prnt('}')\n prnt()\n\n def _loading_gen_enum(self, tp, name, module, prefix='enum'):\n if tp.partial:\n enumvalues = [self._load_constant(True, tp, enumerator, module)\n for enumerator in tp.enumerators]\n tp.enumvalues = tuple(enumvalues)\n tp.partial_resolved = True\n else:\n funcname = self._enum_funcname(prefix, name)\n self._load_known_int_constant(module, funcname)\n\n def _loaded_gen_enum(self, tp, name, module, library):\n for enumerator, enumvalue in zip(tp.enumerators, tp.enumvalues):\n setattr(library, enumerator, enumvalue)\n type(library)._cffi_dir.append(enumerator)\n\n # ----------\n # macros: for now only for integers\n\n def _generate_gen_macro_decl(self, tp, name):\n if tp == '...':\n check_value = None\n else:\n check_value = tp # an integer\n self._generate_gen_const(True, name, check_value=check_value)\n\n _loading_gen_macro = _loaded_noop\n\n def _loaded_gen_macro(self, tp, name, module, library):\n if tp == '...':\n check_value = None\n else:\n check_value = tp # an integer\n value = self._load_constant(True, tp, name, module,\n check_value=check_value)\n setattr(library, name, value)\n type(library)._cffi_dir.append(name)\n\n # ----------\n # global variables\n\n def _generate_gen_variable_decl(self, tp, name):\n if isinstance(tp, model.ArrayType):\n if tp.length == '...':\n prnt = self._prnt\n funcname = '_cffi_sizeof_%s' % (name,)\n self.export_symbols.append(funcname)\n prnt(\"size_t %s(void)\" % funcname)\n prnt(\"{\")\n prnt(\" return sizeof(%s);\" % (name,))\n prnt(\"}\")\n tp_ptr = model.PointerType(tp.item)\n self._generate_gen_const(False, name, tp_ptr)\n else:\n tp_ptr = model.PointerType(tp)\n self._generate_gen_const(False, name, tp_ptr, category='var')\n\n _loading_gen_variable = _loaded_noop\n\n def _loaded_gen_variable(self, tp, name, module, library):\n if isinstance(tp, model.ArrayType): # int a[5] is \"constant\" in the\n # sense that \"a=...\" is forbidden\n if tp.length == '...':\n funcname = '_cffi_sizeof_%s' % (name,)\n BFunc = self.ffi._typeof_locked('size_t(*)(void)')[0]\n function = module.load_function(BFunc, funcname)\n size = function()\n BItemType = self.ffi._get_cached_btype(tp.item)\n length, rest = divmod(size, self.ffi.sizeof(BItemType))\n if rest != 0:\n raise VerificationError(\n \"bad size: %r does not seem to be an array of %s\" %\n (name, tp.item))\n tp = tp.resolve_length(length)\n tp_ptr = model.PointerType(tp.item)\n value = self._load_constant(False, tp_ptr, name, module)\n # 'value' is a which we have to replace with\n # a if the N is actually known\n if tp.length is not None:\n BArray = self.ffi._get_cached_btype(tp)\n value = self.ffi.cast(BArray, value)\n setattr(library, name, value)\n type(library)._cffi_dir.append(name)\n return\n # remove ptr= from the library instance, and replace\n # it by a property on the class, which reads/writes into ptr[0].\n funcname = '_cffi_var_%s' % name\n BFunc = self.ffi._typeof_locked(tp.get_c_name('*(*)(void)', name))[0]\n function = module.load_function(BFunc, funcname)\n ptr = function()\n def getter(library):\n return ptr[0]\n def setter(library, value):\n ptr[0] = value\n setattr(type(library), name, property(getter, setter))\n type(library)._cffi_dir.append(name)\n\ncffimod_header = r'''\n#include \n#include \n#include \n#include \n#include /* XXX for ssize_t on some platforms */\n\n/* this block of #ifs should be kept exactly identical between\n c/_cffi_backend.c, cffi/vengine_cpy.py, cffi/vengine_gen.py\n and cffi/_cffi_include.h */\n#if defined(_MSC_VER)\n# include /* for alloca() */\n# if _MSC_VER < 1600 /* MSVC < 2010 */\n typedef __int8 int8_t;\n typedef __int16 int16_t;\n typedef __int32 int32_t;\n typedef __int64 int64_t;\n typedef unsigned __int8 uint8_t;\n typedef unsigned __int16 uint16_t;\n typedef unsigned __int32 uint32_t;\n typedef unsigned __int64 uint64_t;\n typedef __int8 int_least8_t;\n typedef __int16 int_least16_t;\n typedef __int32 int_least32_t;\n typedef __int64 int_least64_t;\n typedef unsigned __int8 uint_least8_t;\n typedef unsigned __int16 uint_least16_t;\n typedef unsigned __int32 uint_least32_t;\n typedef unsigned __int64 uint_least64_t;\n typedef __int8 int_fast8_t;\n typedef __int16 int_fast16_t;\n typedef __int32 int_fast32_t;\n typedef __int64 int_fast64_t;\n typedef unsigned __int8 uint_fast8_t;\n typedef unsigned __int16 uint_fast16_t;\n typedef unsigned __int32 uint_fast32_t;\n typedef unsigned __int64 uint_fast64_t;\n typedef __int64 intmax_t;\n typedef unsigned __int64 uintmax_t;\n# else\n# include \n# endif\n# if _MSC_VER < 1800 /* MSVC < 2013 */\n# ifndef __cplusplus\n typedef unsigned char _Bool;\n# endif\n# endif\n#else\n# include \n# if (defined (__SVR4) && defined (__sun)) || defined(_AIX) || defined(__hpux)\n# include \n# endif\n#endif\n'''\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cffi/verifier.py",
"content": "#\n# DEPRECATED: implementation for ffi.verify()\n#\nimport sys, os, binascii, shutil, io\nfrom . import __version_verifier_modules__\nfrom . import ffiplatform\nfrom .error import VerificationError\n\nif sys.version_info >= (3, 3):\n import importlib.machinery\n def _extension_suffixes():\n return importlib.machinery.EXTENSION_SUFFIXES[:]\nelse:\n import imp\n def _extension_suffixes():\n return [suffix for suffix, _, type in imp.get_suffixes()\n if type == imp.C_EXTENSION]\n\n\nif sys.version_info >= (3,):\n NativeIO = io.StringIO\nelse:\n class NativeIO(io.BytesIO):\n def write(self, s):\n if isinstance(s, unicode):\n s = s.encode('ascii')\n super(NativeIO, self).write(s)\n\n\nclass Verifier(object):\n\n def __init__(self, ffi, preamble, tmpdir=None, modulename=None,\n ext_package=None, tag='', force_generic_engine=False,\n source_extension='.c', flags=None, relative_to=None, **kwds):\n if ffi._parser._uses_new_feature:\n raise VerificationError(\n \"feature not supported with ffi.verify(), but only \"\n \"with ffi.set_source(): %s\" % (ffi._parser._uses_new_feature,))\n self.ffi = ffi\n self.preamble = preamble\n if not modulename:\n flattened_kwds = ffiplatform.flatten(kwds)\n vengine_class = _locate_engine_class(ffi, force_generic_engine)\n self._vengine = vengine_class(self)\n self._vengine.patch_extension_kwds(kwds)\n self.flags = flags\n self.kwds = self.make_relative_to(kwds, relative_to)\n #\n if modulename:\n if tag:\n raise TypeError(\"can't specify both 'modulename' and 'tag'\")\n else:\n key = '\\x00'.join([sys.version[:3], __version_verifier_modules__,\n preamble, flattened_kwds] +\n ffi._cdefsources)\n if sys.version_info >= (3,):\n key = key.encode('utf-8')\n k1 = hex(binascii.crc32(key[0::2]) & 0xffffffff)\n k1 = k1.lstrip('0x').rstrip('L')\n k2 = hex(binascii.crc32(key[1::2]) & 0xffffffff)\n k2 = k2.lstrip('0').rstrip('L')\n modulename = '_cffi_%s_%s%s%s' % (tag, self._vengine._class_key,\n k1, k2)\n suffix = _get_so_suffixes()[0]\n self.tmpdir = tmpdir or _caller_dir_pycache()\n self.sourcefilename = os.path.join(self.tmpdir, modulename + source_extension)\n self.modulefilename = os.path.join(self.tmpdir, modulename + suffix)\n self.ext_package = ext_package\n self._has_source = False\n self._has_module = False\n\n def write_source(self, file=None):\n \"\"\"Write the C source code. It is produced in 'self.sourcefilename',\n which can be tweaked beforehand.\"\"\"\n with self.ffi._lock:\n if self._has_source and file is None:\n raise VerificationError(\n \"source code already written\")\n self._write_source(file)\n\n def compile_module(self):\n \"\"\"Write the C source code (if not done already) and compile it.\n This produces a dynamic link library in 'self.modulefilename'.\"\"\"\n with self.ffi._lock:\n if self._has_module:\n raise VerificationError(\"module already compiled\")\n if not self._has_source:\n self._write_source()\n self._compile_module()\n\n def load_library(self):\n \"\"\"Get a C module from this Verifier instance.\n Returns an instance of a FFILibrary class that behaves like the\n objects returned by ffi.dlopen(), but that delegates all\n operations to the C module. If necessary, the C code is written\n and compiled first.\n \"\"\"\n with self.ffi._lock:\n if not self._has_module:\n self._locate_module()\n if not self._has_module:\n if not self._has_source:\n self._write_source()\n self._compile_module()\n return self._load_library()\n\n def get_module_name(self):\n basename = os.path.basename(self.modulefilename)\n # kill both the .so extension and the other .'s, as introduced\n # by Python 3: 'basename.cpython-33m.so'\n basename = basename.split('.', 1)[0]\n # and the _d added in Python 2 debug builds --- but try to be\n # conservative and not kill a legitimate _d\n if basename.endswith('_d') and hasattr(sys, 'gettotalrefcount'):\n basename = basename[:-2]\n return basename\n\n def get_extension(self):\n ffiplatform._hack_at_distutils() # backward compatibility hack\n if not self._has_source:\n with self.ffi._lock:\n if not self._has_source:\n self._write_source()\n sourcename = ffiplatform.maybe_relative_path(self.sourcefilename)\n modname = self.get_module_name()\n return ffiplatform.get_extension(sourcename, modname, **self.kwds)\n\n def generates_python_module(self):\n return self._vengine._gen_python_module\n\n def make_relative_to(self, kwds, relative_to):\n if relative_to and os.path.dirname(relative_to):\n dirname = os.path.dirname(relative_to)\n kwds = kwds.copy()\n for key in ffiplatform.LIST_OF_FILE_NAMES:\n if key in kwds:\n lst = kwds[key]\n if not isinstance(lst, (list, tuple)):\n raise TypeError(\"keyword '%s' should be a list or tuple\"\n % (key,))\n lst = [os.path.join(dirname, fn) for fn in lst]\n kwds[key] = lst\n return kwds\n\n # ----------\n\n def _locate_module(self):\n if not os.path.isfile(self.modulefilename):\n if self.ext_package:\n try:\n pkg = __import__(self.ext_package, None, None, ['__doc__'])\n except ImportError:\n return # cannot import the package itself, give up\n # (e.g. it might be called differently before installation)\n path = pkg.__path__\n else:\n path = None\n filename = self._vengine.find_module(self.get_module_name(), path,\n _get_so_suffixes())\n if filename is None:\n return\n self.modulefilename = filename\n self._vengine.collect_types()\n self._has_module = True\n\n def _write_source_to(self, file):\n self._vengine._f = file\n try:\n self._vengine.write_source_to_f()\n finally:\n del self._vengine._f\n\n def _write_source(self, file=None):\n if file is not None:\n self._write_source_to(file)\n else:\n # Write our source file to an in memory file.\n f = NativeIO()\n self._write_source_to(f)\n source_data = f.getvalue()\n\n # Determine if this matches the current file\n if os.path.exists(self.sourcefilename):\n with open(self.sourcefilename, \"r\") as fp:\n needs_written = not (fp.read() == source_data)\n else:\n needs_written = True\n\n # Actually write the file out if it doesn't match\n if needs_written:\n _ensure_dir(self.sourcefilename)\n with open(self.sourcefilename, \"w\") as fp:\n fp.write(source_data)\n\n # Set this flag\n self._has_source = True\n\n def _compile_module(self):\n # compile this C source\n tmpdir = os.path.dirname(self.sourcefilename)\n outputfilename = ffiplatform.compile(tmpdir, self.get_extension())\n try:\n same = ffiplatform.samefile(outputfilename, self.modulefilename)\n except OSError:\n same = False\n if not same:\n _ensure_dir(self.modulefilename)\n shutil.move(outputfilename, self.modulefilename)\n self._has_module = True\n\n def _load_library(self):\n assert self._has_module\n if self.flags is not None:\n return self._vengine.load_library(self.flags)\n else:\n return self._vengine.load_library()\n\n# ____________________________________________________________\n\n_FORCE_GENERIC_ENGINE = False # for tests\n\ndef _locate_engine_class(ffi, force_generic_engine):\n if _FORCE_GENERIC_ENGINE:\n force_generic_engine = True\n if not force_generic_engine:\n if '__pypy__' in sys.builtin_module_names:\n force_generic_engine = True\n else:\n try:\n import _cffi_backend\n except ImportError:\n _cffi_backend = '?'\n if ffi._backend is not _cffi_backend:\n force_generic_engine = True\n if force_generic_engine:\n from . import vengine_gen\n return vengine_gen.VGenericEngine\n else:\n from . import vengine_cpy\n return vengine_cpy.VCPythonEngine\n\n# ____________________________________________________________\n\n_TMPDIR = None\n\ndef _caller_dir_pycache():\n if _TMPDIR:\n return _TMPDIR\n result = os.environ.get('CFFI_TMPDIR')\n if result:\n return result\n filename = sys._getframe(2).f_code.co_filename\n return os.path.abspath(os.path.join(os.path.dirname(filename),\n '__pycache__'))\n\ndef set_tmpdir(dirname):\n \"\"\"Set the temporary directory to use instead of __pycache__.\"\"\"\n global _TMPDIR\n _TMPDIR = dirname\n\ndef cleanup_tmpdir(tmpdir=None, keep_so=False):\n \"\"\"Clean up the temporary directory by removing all files in it\n called `_cffi_*.{c,so}` as well as the `build` subdirectory.\"\"\"\n tmpdir = tmpdir or _caller_dir_pycache()\n try:\n filelist = os.listdir(tmpdir)\n except OSError:\n return\n if keep_so:\n suffix = '.c' # only remove .c files\n else:\n suffix = _get_so_suffixes()[0].lower()\n for fn in filelist:\n if fn.lower().startswith('_cffi_') and (\n fn.lower().endswith(suffix) or fn.lower().endswith('.c')):\n try:\n os.unlink(os.path.join(tmpdir, fn))\n except OSError:\n pass\n clean_dir = [os.path.join(tmpdir, 'build')]\n for dir in clean_dir:\n try:\n for fn in os.listdir(dir):\n fn = os.path.join(dir, fn)\n if os.path.isdir(fn):\n clean_dir.append(fn)\n else:\n os.unlink(fn)\n except OSError:\n pass\n\ndef _get_so_suffixes():\n suffixes = _extension_suffixes()\n if not suffixes:\n # bah, no C_EXTENSION available. Occurs on pypy without cpyext\n if sys.platform == 'win32':\n suffixes = [\".pyd\"]\n else:\n suffixes = [\".so\"]\n\n return suffixes\n\ndef _ensure_dir(filename):\n dirname = os.path.dirname(filename)\n if dirname and not os.path.isdir(dirname):\n os.makedirs(dirname)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cffi-1.13.1.dist-info/INSTALLER",
"content": "pip\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cffi-1.13.1.dist-info/LICENSE.txt",
"content": "\nExcept when otherwise stated (look for LICENSE files in directories or\ninformation at the beginning of each file) all software and\ndocumentation is licensed as follows: \n\n The MIT License\n\n Permission is hereby granted, free of charge, to any person \n obtaining a copy of this software and associated documentation \n files (the \"Software\"), to deal in the Software without \n restriction, including without limitation the rights to use, \n copy, modify, merge, publish, distribute, sublicense, and/or \n sell copies of the Software, and to permit persons to whom the \n Software is furnished to do so, subject to the following conditions:\n\n The above copyright notice and this permission notice shall be included \n in all copies or substantial portions of the Software.\n\n THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS \n OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, \n FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL \n THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER \n LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING \n FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER \n DEALINGS IN THE SOFTWARE.\n\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cffi-1.13.1.dist-info/METADATA",
"content": "Metadata-Version: 2.1\nName: cffi\nVersion: 1.13.1\nSummary: Foreign Function Interface for Python calling C code.\nHome-page: http://cffi.readthedocs.org\nAuthor: Armin Rigo, Maciej Fijalkowski\nAuthor-email: python-cffi@googlegroups.com\nLicense: MIT\nPlatform: UNKNOWN\nClassifier: Programming Language :: Python\nClassifier: Programming Language :: Python :: 2\nClassifier: Programming Language :: Python :: 2.6\nClassifier: Programming Language :: Python :: 2.7\nClassifier: Programming Language :: Python :: 3\nClassifier: Programming Language :: Python :: 3.2\nClassifier: Programming Language :: Python :: 3.3\nClassifier: Programming Language :: Python :: 3.4\nClassifier: Programming Language :: Python :: 3.5\nClassifier: Programming Language :: Python :: 3.6\nClassifier: Programming Language :: Python :: Implementation :: CPython\nClassifier: Programming Language :: Python :: Implementation :: PyPy\nRequires-Dist: pycparser\n\n\nCFFI\n====\n\nForeign Function Interface for Python calling C code.\nPlease see the `Documentation `_.\n\nContact\n-------\n\n`Mailing list `_\n\n\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cffi-1.13.1.dist-info/RECORD",
"content": ".libs_cffi_backend/libffi-10449faf.so.5.0.6,sha256=PG7U56gJ8uCf3HUyfp4gVBQTu7rwI2GdyE7quplTB2o,34248\r\n_cffi_backend.cpython-36m-x86_64-linux-gnu.so,sha256=lyO5RSJGQG5eqiZKAfaFBevoOb4awoyRoAXv8qaxO0s,849704\r\ncffi-1.13.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4\r\ncffi-1.13.1.dist-info/LICENSE.txt,sha256=BLgPWwd7vtaICM_rreteNSPyqMmpZJXFh72W3x6sKjM,1294\r\ncffi-1.13.1.dist-info/METADATA,sha256=M7h8dR2tpB6Q5V46_Imv7Gxe7pKzA1hufeVHtu2sNAo,1140\r\ncffi-1.13.1.dist-info/RECORD,,\r\ncffi-1.13.1.dist-info/WHEEL,sha256=d2ILPScH-y2UwGxsW1PeA2TT-KW0Git4AJ6LeOK8sQo,109\r\ncffi-1.13.1.dist-info/entry_points.txt,sha256=Q9f5C9IpjYxo0d2PK9eUcnkgxHc9pHWwjEMaANPKNCI,76\r\ncffi-1.13.1.dist-info/top_level.txt,sha256=rE7WR3rZfNKxWI9-jn6hsHCAl7MDkB-FmuQbxWjFehQ,19\r\ncffi/__init__.py,sha256=vMoBBQacAlqzOsFf931EfnNqZnslrwcuaSeLUO6JTvY,513\r\ncffi/__pycache__/__init__.cpython-36.pyc,,\r\ncffi/__pycache__/api.cpython-36.pyc,,\r\ncffi/__pycache__/backend_ctypes.cpython-36.pyc,,\r\ncffi/__pycache__/cffi_opcode.cpython-36.pyc,,\r\ncffi/__pycache__/commontypes.cpython-36.pyc,,\r\ncffi/__pycache__/cparser.cpython-36.pyc,,\r\ncffi/__pycache__/error.cpython-36.pyc,,\r\ncffi/__pycache__/ffiplatform.cpython-36.pyc,,\r\ncffi/__pycache__/lock.cpython-36.pyc,,\r\ncffi/__pycache__/model.cpython-36.pyc,,\r\ncffi/__pycache__/pkgconfig.cpython-36.pyc,,\r\ncffi/__pycache__/recompiler.cpython-36.pyc,,\r\ncffi/__pycache__/setuptools_ext.cpython-36.pyc,,\r\ncffi/__pycache__/vengine_cpy.cpython-36.pyc,,\r\ncffi/__pycache__/vengine_gen.cpython-36.pyc,,\r\ncffi/__pycache__/verifier.cpython-36.pyc,,\r\ncffi/_cffi_errors.h,sha256=6nFQ-4dRQI1bXRoSeqdvyKU33TmutQJB_2fAhWSzdl8,3856\r\ncffi/_cffi_include.h,sha256=JuFfmwpRE65vym3Nxr9vDMOIEuv21tXdarkL1l2WNms,12149\r\ncffi/_embedding.h,sha256=bhLhKOkF46V3C5gHLb4OkxH9pdcwMJqpjPHNDYojwbc,17411\r\ncffi/api.py,sha256=Q07iwDD0FRwWa2fx2ZzQft69iJs9aNR52fvrtUy3EY4,41800\r\ncffi/backend_ctypes.py,sha256=h5ZIzLc6BFVXnGyc9xPqZWUS7qGy7yFSDqXe68Sa8z4,42454\r\ncffi/cffi_opcode.py,sha256=v9RdD_ovA8rCtqsC95Ivki5V667rAOhGgs3fb2q9xpM,5724\r\ncffi/commontypes.py,sha256=QS4uxCDI7JhtTyjh1hlnCA-gynmaszWxJaRRLGkJa1A,2689\r\ncffi/cparser.py,sha256=DIChXOqV-T3bZ3APc42V9zgeU0PdF4e57GU4WvIK4JQ,42079\r\ncffi/error.py,sha256=v6xTiS4U0kvDcy4h_BDRo5v39ZQuj-IMRYLv5ETddZs,877\r\ncffi/ffiplatform.py,sha256=HMXqR8ks2wtdsNxGaWpQ_PyqIvtiuos_vf1qKCy-cwg,4046\r\ncffi/lock.py,sha256=l9TTdwMIMpi6jDkJGnQgE9cvTIR7CAntIJr8EGHt3pY,747\r\ncffi/model.py,sha256=AYyjS26uiFKXtkm43qmStpy9zfGh5HVJF4UETYFBt6w,21682\r\ncffi/parse_c_type.h,sha256=OdwQfwM9ktq6vlCB43exFQmxDBtj2MBNdK8LYl15tjw,5976\r\ncffi/pkgconfig.py,sha256=LP1w7vmWvmKwyqLaU1Z243FOWGNQMrgMUZrvgFuOlco,4374\r\ncffi/recompiler.py,sha256=9BR4oOQ9wFTMrp6CGa4Pa4U1pAU64Mv5-KwW5Hdn3ZM,62755\r\ncffi/setuptools_ext.py,sha256=qc6arfrSzm4RNT5oJz6d5td7KJ-pHfI7bqYD0X4Q-08,8848\r\ncffi/vengine_cpy.py,sha256=hdyjjZNijLrg_uGMnnFyC-7GG_LxWtwB8BlS2vvVDQ0,41470\r\ncffi/vengine_gen.py,sha256=Zkq0-EdeZwn6qUvf_CI8iUEs2UxVIvDmKCH1j0-y0GI,26676\r\ncffi/verifier.py,sha256=J9Enz2rbJb9CHPqWlWQ5uQESoyr0uc7MNWugchjXBv4,11207\r\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cffi-1.13.1.dist-info/WHEEL",
"content": "Wheel-Version: 1.0\nGenerator: bdist_wheel (0.31.1)\nRoot-Is-Purelib: false\nTag: cp36-cp36m-manylinux1_x86_64\n\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cffi-1.13.1.dist-info/entry_points.txt",
"content": "[distutils.setup_keywords]\ncffi_modules = cffi.setuptools_ext:cffi_modules\n\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cffi-1.13.1.dist-info/top_level.txt",
"content": "_cffi_backend\ncffi\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/constantly/__init__.py",
"content": "# Copyright (c) Twisted Matrix Laboratories.\n# See LICENSE for details.\n\nfrom constantly._constants import (\n NamedConstant, Names, ValueConstant, Values, FlagConstant, Flags\n)\n\nfrom ._version import get_versions\n__version__ = get_versions()['version']\ndel get_versions\n\n__author__ = \"Twisted Matrix Laboratories\"\n__license__ = \"MIT\"\n__copyright__ = \"Copyright 2011-2015 {0}\".format(__author__)\n\n\n__all__ = [\n 'NamedConstant',\n 'ValueConstant',\n 'FlagConstant',\n 'Names',\n 'Values',\n 'Flags',\n]\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/constantly/_constants.py",
"content": "# -*- test-case-name: constantly.test.test_constants -*-\n# Copyright (c) Twisted Matrix Laboratories.\n# See LICENSE for details.\n\n\"\"\"\nSymbolic constant support, including collections and constants with text,\nnumeric, and bit flag values.\n\"\"\"\n\nfrom __future__ import division, absolute_import\n\n__all__ = [\n 'NamedConstant', 'ValueConstant', 'FlagConstant',\n 'Names', 'Values', 'Flags']\n\nfrom functools import partial\nfrom itertools import count\nfrom operator import and_, or_, xor\n\n_unspecified = object()\n_constantOrder = partial(next, count())\n\n\nclass _Constant(object):\n \"\"\"\n @ivar _index: A C{int} allocated from a shared counter in order to keep\n track of the order in which L{_Constant}s are instantiated.\n\n @ivar name: A C{str} giving the name of this constant; only set once the\n constant is initialized by L{_ConstantsContainer}.\n\n @ivar _container: The L{_ConstantsContainer} subclass this constant belongs\n to; C{None} until the constant is initialized by that subclass.\n \"\"\"\n def __init__(self):\n self._container = None\n self._index = _constantOrder()\n\n\n def __repr__(self):\n \"\"\"\n Return text identifying both which constant this is and which\n collection it belongs to.\n \"\"\"\n return \"<%s=%s>\" % (self._container.__name__, self.name)\n\n\n def __lt__(self, other):\n \"\"\"\n Implements C{<}. Order is defined by instantiation order.\n\n @param other: An object.\n\n @return: C{NotImplemented} if C{other} is not a constant belonging to\n the same container as this constant, C{True} if this constant is\n defined before C{other}, otherwise C{False}.\n \"\"\"\n if (\n not isinstance(other, self.__class__) or\n not self._container == other._container\n ):\n return NotImplemented\n return self._index < other._index\n\n\n def __le__(self, other):\n \"\"\"\n Implements C{<=}. Order is defined by instantiation order.\n\n @param other: An object.\n\n @return: C{NotImplemented} if C{other} is not a constant belonging to\n the same container as this constant, C{True} if this constant is\n defined before or equal to C{other}, otherwise C{False}.\n \"\"\"\n if (\n not isinstance(other, self.__class__) or\n not self._container == other._container\n ):\n return NotImplemented\n return self is other or self._index < other._index\n\n\n def __gt__(self, other):\n \"\"\"\n Implements C{>}. Order is defined by instantiation order.\n\n @param other: An object.\n\n @return: C{NotImplemented} if C{other} is not a constant belonging to\n the same container as this constant, C{True} if this constant is\n defined after C{other}, otherwise C{False}.\n \"\"\"\n if (\n not isinstance(other, self.__class__) or\n not self._container == other._container\n ):\n return NotImplemented\n return self._index > other._index\n\n\n def __ge__(self, other):\n \"\"\"\n Implements C{>=}. Order is defined by instantiation order.\n\n @param other: An object.\n\n @return: C{NotImplemented} if C{other} is not a constant belonging to\n the same container as this constant, C{True} if this constant is\n defined after or equal to C{other}, otherwise C{False}.\n \"\"\"\n if (\n not isinstance(other, self.__class__) or\n not self._container == other._container\n ):\n return NotImplemented\n return self is other or self._index > other._index\n\n\n def _realize(self, container, name, value):\n \"\"\"\n Complete the initialization of this L{_Constant}.\n\n @param container: The L{_ConstantsContainer} subclass this constant is\n part of.\n\n @param name: The name of this constant in its container.\n\n @param value: The value of this constant; not used, as named constants\n have no value apart from their identity.\n \"\"\"\n self._container = container\n self.name = name\n\n\n\nclass _ConstantsContainerType(type):\n \"\"\"\n L{_ConstantsContainerType} is a metaclass for creating constants container\n classes.\n \"\"\"\n def __new__(self, name, bases, attributes):\n \"\"\"\n Create a new constants container class.\n\n If C{attributes} includes a value of C{None} for the C{\"_constantType\"}\n key, the new class will not be initialized as a constants container and\n it will behave as a normal class.\n\n @param name: The name of the container class.\n @type name: L{str}\n\n @param bases: A tuple of the base classes for the new container class.\n @type bases: L{tuple} of L{_ConstantsContainerType} instances\n\n @param attributes: The attributes of the new container class, including\n any constants it is to contain.\n @type attributes: L{dict}\n \"\"\"\n cls = super(_ConstantsContainerType, self).__new__(\n self, name, bases, attributes)\n\n # Only realize constants in concrete _ConstantsContainer subclasses.\n # Ignore intermediate base classes.\n constantType = getattr(cls, '_constantType', None)\n if constantType is None:\n return cls\n\n constants = []\n for (name, descriptor) in attributes.items():\n if isinstance(descriptor, cls._constantType):\n if descriptor._container is not None:\n raise ValueError(\n \"Cannot use %s as the value of an attribute on %s\" % (\n descriptor, cls.__name__))\n constants.append((descriptor._index, name, descriptor))\n\n enumerants = {}\n for (index, enumerant, descriptor) in sorted(constants):\n value = cls._constantFactory(enumerant, descriptor)\n descriptor._realize(cls, enumerant, value)\n enumerants[enumerant] = descriptor\n\n # Save the dictionary which contains *only* constants (distinct from\n # any other attributes the application may have given the container)\n # where the class can use it later (eg for lookupByName).\n cls._enumerants = enumerants\n\n return cls\n\n\n\n# In Python3 metaclasses are defined using a C{metaclass} keyword argument in\n# the class definition. This would cause a syntax error in Python2.\n# So we use L{type} to introduce an intermediate base class with the desired\n# metaclass.\n# See:\n# * http://docs.python.org/2/library/functions.html#type\n# * http://docs.python.org/3/reference/datamodel.html#customizing-class-creation\nclass _ConstantsContainer(_ConstantsContainerType('', (object,), {})):\n \"\"\"\n L{_ConstantsContainer} is a class with attributes used as symbolic\n constants. It is up to subclasses to specify what kind of constants are\n allowed.\n\n @cvar _constantType: Specified by a L{_ConstantsContainer} subclass to\n specify the type of constants allowed by that subclass.\n\n @cvar _enumerants: A C{dict} mapping the names of constants (eg\n L{NamedConstant} instances) found in the class definition to those\n instances.\n \"\"\"\n\n _constantType = None\n\n def __new__(cls):\n \"\"\"\n Classes representing constants containers are not intended to be\n instantiated.\n\n The class object itself is used directly.\n \"\"\"\n raise TypeError(\"%s may not be instantiated.\" % (cls.__name__,))\n\n\n @classmethod\n def _constantFactory(cls, name, descriptor):\n \"\"\"\n Construct the value for a new constant to add to this container.\n\n @param name: The name of the constant to create.\n\n @param descriptor: An instance of a L{_Constant} subclass (eg\n L{NamedConstant}) which is assigned to C{name}.\n\n @return: L{NamedConstant} instances have no value apart from identity,\n so return a meaningless dummy value.\n \"\"\"\n return _unspecified\n\n\n @classmethod\n def lookupByName(cls, name):\n \"\"\"\n Retrieve a constant by its name or raise a C{ValueError} if there is no\n constant associated with that name.\n\n @param name: A C{str} giving the name of one of the constants defined\n by C{cls}.\n\n @raise ValueError: If C{name} is not the name of one of the constants\n defined by C{cls}.\n\n @return: The L{NamedConstant} associated with C{name}.\n \"\"\"\n if name in cls._enumerants:\n return getattr(cls, name)\n raise ValueError(name)\n\n\n @classmethod\n def iterconstants(cls):\n \"\"\"\n Iteration over a L{Names} subclass results in all of the constants it\n contains.\n\n @return: an iterator the elements of which are the L{NamedConstant}\n instances defined in the body of this L{Names} subclass.\n \"\"\"\n constants = cls._enumerants.values()\n\n return iter(\n sorted(constants, key=lambda descriptor: descriptor._index))\n\n\n\nclass NamedConstant(_Constant):\n \"\"\"\n L{NamedConstant} defines an attribute to be a named constant within a\n collection defined by a L{Names} subclass.\n\n L{NamedConstant} is only for use in the definition of L{Names}\n subclasses. Do not instantiate L{NamedConstant} elsewhere and do not\n subclass it.\n \"\"\"\n\n\n\nclass Names(_ConstantsContainer):\n \"\"\"\n A L{Names} subclass contains constants which differ only in their names and\n identities.\n \"\"\"\n _constantType = NamedConstant\n\n\n\nclass ValueConstant(_Constant):\n \"\"\"\n L{ValueConstant} defines an attribute to be a named constant within a\n collection defined by a L{Values} subclass.\n\n L{ValueConstant} is only for use in the definition of L{Values} subclasses.\n Do not instantiate L{ValueConstant} elsewhere and do not subclass it.\n \"\"\"\n def __init__(self, value):\n _Constant.__init__(self)\n self.value = value\n\n\n\nclass Values(_ConstantsContainer):\n \"\"\"\n A L{Values} subclass contains constants which are associated with arbitrary\n values.\n \"\"\"\n _constantType = ValueConstant\n\n @classmethod\n def lookupByValue(cls, value):\n \"\"\"\n Retrieve a constant by its value or raise a C{ValueError} if there is\n no constant associated with that value.\n\n @param value: The value of one of the constants defined by C{cls}.\n\n @raise ValueError: If C{value} is not the value of one of the constants\n defined by C{cls}.\n\n @return: The L{ValueConstant} associated with C{value}.\n \"\"\"\n for constant in cls.iterconstants():\n if constant.value == value:\n return constant\n raise ValueError(value)\n\n\n\ndef _flagOp(op, left, right):\n \"\"\"\n Implement a binary operator for a L{FlagConstant} instance.\n\n @param op: A two-argument callable implementing the binary operation. For\n example, C{operator.or_}.\n\n @param left: The left-hand L{FlagConstant} instance.\n @param right: The right-hand L{FlagConstant} instance.\n\n @return: A new L{FlagConstant} instance representing the result of the\n operation.\n \"\"\"\n value = op(left.value, right.value)\n names = op(left.names, right.names)\n result = FlagConstant()\n result._realize(left._container, names, value)\n return result\n\n\n\nclass FlagConstant(_Constant):\n \"\"\"\n L{FlagConstant} defines an attribute to be a flag constant within a\n collection defined by a L{Flags} subclass.\n\n L{FlagConstant} is only for use in the definition of L{Flags} subclasses.\n Do not instantiate L{FlagConstant} elsewhere and do not subclass it.\n \"\"\"\n def __init__(self, value=_unspecified):\n _Constant.__init__(self)\n self.value = value\n\n\n def _realize(self, container, names, value):\n \"\"\"\n Complete the initialization of this L{FlagConstant}.\n\n This implementation differs from other C{_realize} implementations in\n that a L{FlagConstant} may have several names which apply to it, due to\n flags being combined with various operators.\n\n @param container: The L{Flags} subclass this constant is part of.\n\n @param names: When a single-flag value is being initialized, a C{str}\n giving the name of that flag. This is the case which happens when\n a L{Flags} subclass is being initialized and L{FlagConstant}\n instances from its body are being realized. Otherwise, a C{set} of\n C{str} giving names of all the flags set on this L{FlagConstant}\n instance. This is the case when two flags are combined using C{|},\n for example.\n \"\"\"\n if isinstance(names, str):\n name = names\n names = set([names])\n elif len(names) == 1:\n (name,) = names\n else:\n name = \"{\" + \",\".join(sorted(names)) + \"}\"\n _Constant._realize(self, container, name, value)\n self.value = value\n self.names = names\n\n\n def __or__(self, other):\n \"\"\"\n Define C{|} on two L{FlagConstant} instances to create a new\n L{FlagConstant} instance with all flags set in either instance set.\n \"\"\"\n return _flagOp(or_, self, other)\n\n\n def __and__(self, other):\n \"\"\"\n Define C{&} on two L{FlagConstant} instances to create a new\n L{FlagConstant} instance with only flags set in both instances set.\n \"\"\"\n return _flagOp(and_, self, other)\n\n\n def __xor__(self, other):\n \"\"\"\n Define C{^} on two L{FlagConstant} instances to create a new\n L{FlagConstant} instance with only flags set on exactly one instance\n set.\n \"\"\"\n return _flagOp(xor, self, other)\n\n\n def __invert__(self):\n \"\"\"\n Define C{~} on a L{FlagConstant} instance to create a new\n L{FlagConstant} instance with all flags not set on this instance set.\n \"\"\"\n result = FlagConstant()\n result._realize(self._container, set(), 0)\n for flag in self._container.iterconstants():\n if flag.value & self.value == 0:\n result |= flag\n return result\n\n\n def __iter__(self):\n \"\"\"\n @return: An iterator of flags set on this instance set.\n \"\"\"\n return (self._container.lookupByName(name) for name in self.names)\n\n\n def __contains__(self, flag):\n \"\"\"\n @param flag: The flag to test for membership in this instance\n set.\n\n @return: C{True} if C{flag} is in this instance set, else\n C{False}.\n \"\"\"\n # Optimization for testing membership without iteration.\n return bool(flag & self)\n\n\n def __nonzero__(self):\n \"\"\"\n @return: C{False} if this flag's value is 0, else C{True}.\n \"\"\"\n return bool(self.value)\n __bool__ = __nonzero__\n\n\n\nclass Flags(Values):\n \"\"\"\n A L{Flags} subclass contains constants which can be combined using the\n common bitwise operators (C{|}, C{&}, etc) similar to a I{bitvector} from a\n language like C.\n \"\"\"\n _constantType = FlagConstant\n\n _value = 1\n\n @classmethod\n def _constantFactory(cls, name, descriptor):\n \"\"\"\n For L{FlagConstant} instances with no explicitly defined value, assign\n the next power of two as its value.\n\n @param name: The name of the constant to create.\n\n @param descriptor: An instance of a L{FlagConstant} which is assigned\n to C{name}.\n\n @return: Either the value passed to the C{descriptor} constructor, or\n the next power of 2 value which will be assigned to C{descriptor},\n relative to the value of the last defined L{FlagConstant}.\n \"\"\"\n if descriptor.value is _unspecified:\n value = cls._value\n cls._value <<= 1\n else:\n value = descriptor.value\n cls._value = value << 1\n return value\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/constantly/_version.py",
"content": "\n# This file was generated by 'versioneer.py' (0.15) from\n# revision-control system data, or from the parent directory name of an\n# unpacked source archive. Distribution tarballs contain a pre-generated copy\n# of this file.\n\nimport json\nimport sys\n\nversion_json = '''\n{\n \"dirty\": false,\n \"error\": null,\n \"full-revisionid\": \"c8375a7e3431792ea1b1b44678f3f6878d5e8c9a\",\n \"version\": \"15.1.0\"\n}\n''' # END VERSION_JSON\n\n\ndef get_versions():\n return json.loads(version_json)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/constantly-15.1.0.dist-info/DESCRIPTION.rst",
"content": "Constantly\n==========\n\nA library that provides symbolic constant support.\nIt includes collections and constants with text, numeric, and bit flag values.\nOriginally ``twisted.python.constants`` from the `Twisted `_ project.\n\n\nTests\n-----\n\nTo run tests::\n\n $ tox\n\nThis will run tests on Python 2.7, 3.3, 3.4, and PyPy, as well as doing coverage and pyflakes checks.\n\n\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/constantly-15.1.0.dist-info/INSTALLER",
"content": "pip\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/constantly-15.1.0.dist-info/METADATA",
"content": "Metadata-Version: 2.0\nName: constantly\nVersion: 15.1.0\nSummary: Symbolic constants in Python\nHome-page: https://github.com/twisted/constantly\nAuthor: Twisted Matrix Labs Developers\nAuthor-email: UNKNOWN\nLicense: MIT\nKeywords: constants,enum,twisted\nPlatform: UNKNOWN\nClassifier: Intended Audience :: Developers\nClassifier: License :: OSI Approved :: MIT License\nClassifier: Operating System :: OS Independent\nClassifier: Programming Language :: Python\nClassifier: Programming Language :: Python :: 2.7\nClassifier: Programming Language :: Python :: 3.3\nClassifier: Programming Language :: Python :: 3.4\nClassifier: Programming Language :: Python :: Implementation :: CPython\nClassifier: Programming Language :: Python :: Implementation :: PyPy\nClassifier: Topic :: Software Development :: Libraries :: Python Modules\n\nConstantly\n==========\n\nA library that provides symbolic constant support.\nIt includes collections and constants with text, numeric, and bit flag values.\nOriginally ``twisted.python.constants`` from the `Twisted `_ project.\n\n\nTests\n-----\n\nTo run tests::\n\n $ tox\n\nThis will run tests on Python 2.7, 3.3, 3.4, and PyPy, as well as doing coverage and pyflakes checks.\n\n\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/constantly-15.1.0.dist-info/RECORD",
"content": "constantly-15.1.0.dist-info/DESCRIPTION.rst,sha256=sx7cfQa9trLrI06ORsPDOgA4UkW9KdPxYfygiqt50R4,397\r\nconstantly-15.1.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4\r\nconstantly-15.1.0.dist-info/METADATA,sha256=4Rt-WjQ0S-JhhzVk__zpXfYLaC7KaVjQzW9SVaBhwoY,1214\r\nconstantly-15.1.0.dist-info/RECORD,,\r\nconstantly-15.1.0.dist-info/WHEEL,sha256=AvR0WeTpDaxT645bl5FQxUK6NPsTls2ttpcGJg3j1Xg,110\r\nconstantly-15.1.0.dist-info/metadata.json,sha256=y1-W-VJW79doSoMail8qNDduY5oHC2JGG1-tBZ_dA0k,923\r\nconstantly-15.1.0.dist-info/pbr.json,sha256=of4UIk4TOAoS3Gxf7oE2PwaRBcQW2ij9ZLRX1LMhy1A,47\r\nconstantly-15.1.0.dist-info/top_level.txt,sha256=Z3LZxRT3sV7OIcLddygWy8rRaguc4a1hlGotDs-vFIM,11\r\nconstantly/__init__.py,sha256=K2EFx89mIF8TkuE4F2ZhqeiE9UuB9S0DpFy0SNhu6uc,517\r\nconstantly/__pycache__/__init__.cpython-36.pyc,,\r\nconstantly/__pycache__/_constants.cpython-36.pyc,,\r\nconstantly/__pycache__/_version.cpython-36.pyc,,\r\nconstantly/_constants.py,sha256=n-QpkK73fCIyebkqp6hvUMuEe3uYeIptBtl4KahxpcI,16090\r\nconstantly/_version.py,sha256=kp8Hoj2tpH_Xpb4CONVFfYjTpEOr3EGzNRaT_IFZ3Ao,472\r\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/constantly-15.1.0.dist-info/WHEEL",
"content": "Wheel-Version: 1.0\nGenerator: bdist_wheel (0.24.0)\nRoot-Is-Purelib: true\nTag: py2-none-any\nTag: py3-none-any\n\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/constantly-15.1.0.dist-info/metadata.json",
"content": "{\"license\": \"MIT\", \"name\": \"constantly\", \"metadata_version\": \"2.0\", \"generator\": \"bdist_wheel (0.24.0)\", \"summary\": \"Symbolic constants in Python\", \"version\": \"15.1.0\", \"extensions\": {\"python.details\": {\"project_urls\": {\"Home\": \"https://github.com/twisted/constantly\"}, \"document_names\": {\"description\": \"DESCRIPTION.rst\"}, \"contacts\": [{\"role\": \"author\", \"name\": \"Twisted Matrix Labs Developers\"}]}}, \"keywords\": [\"constants\", \"enum\", \"twisted\"], \"classifiers\": [\"Intended Audience :: Developers\", \"License :: OSI Approved :: MIT License\", \"Operating System :: OS Independent\", \"Programming Language :: Python\", \"Programming Language :: Python :: 2.7\", \"Programming Language :: Python :: 3.3\", \"Programming Language :: Python :: 3.4\", \"Programming Language :: Python :: Implementation :: CPython\", \"Programming Language :: Python :: Implementation :: PyPy\", \"Topic :: Software Development :: Libraries :: Python Modules\"]}"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/constantly-15.1.0.dist-info/pbr.json",
"content": "{\"is_release\": false, \"git_version\": \"c8375a7\"}"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/constantly-15.1.0.dist-info/top_level.txt",
"content": "constantly\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/__about__.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\n__all__ = [\n \"__title__\", \"__summary__\", \"__uri__\", \"__version__\", \"__author__\",\n \"__email__\", \"__license__\", \"__copyright__\",\n]\n\n__title__ = \"cryptography\"\n__summary__ = (\"cryptography is a package which provides cryptographic recipes\"\n \" and primitives to Python developers.\")\n__uri__ = \"https://github.com/pyca/cryptography\"\n\n__version__ = \"2.8\"\n\n__author__ = \"The cryptography developers\"\n__email__ = \"cryptography-dev@python.org\"\n\n__license__ = \"BSD or Apache License, Version 2.0\"\n__copyright__ = \"Copyright 2013-2019 {}\".format(__author__)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/__init__.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nfrom cryptography.__about__ import (\n __author__, __copyright__, __email__, __license__, __summary__, __title__,\n __uri__, __version__\n)\n\n\n__all__ = [\n \"__title__\", \"__summary__\", \"__uri__\", \"__version__\", \"__author__\",\n \"__email__\", \"__license__\", \"__copyright__\",\n]\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/exceptions.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nfrom enum import Enum\n\n\nclass _Reasons(Enum):\n BACKEND_MISSING_INTERFACE = 0\n UNSUPPORTED_HASH = 1\n UNSUPPORTED_CIPHER = 2\n UNSUPPORTED_PADDING = 3\n UNSUPPORTED_MGF = 4\n UNSUPPORTED_PUBLIC_KEY_ALGORITHM = 5\n UNSUPPORTED_ELLIPTIC_CURVE = 6\n UNSUPPORTED_SERIALIZATION = 7\n UNSUPPORTED_X509 = 8\n UNSUPPORTED_EXCHANGE_ALGORITHM = 9\n UNSUPPORTED_DIFFIE_HELLMAN = 10\n UNSUPPORTED_MAC = 11\n\n\nclass UnsupportedAlgorithm(Exception):\n def __init__(self, message, reason=None):\n super(UnsupportedAlgorithm, self).__init__(message)\n self._reason = reason\n\n\nclass AlreadyFinalized(Exception):\n pass\n\n\nclass AlreadyUpdated(Exception):\n pass\n\n\nclass NotYetFinalized(Exception):\n pass\n\n\nclass InvalidTag(Exception):\n pass\n\n\nclass InvalidSignature(Exception):\n pass\n\n\nclass InternalError(Exception):\n def __init__(self, msg, err_code):\n super(InternalError, self).__init__(msg)\n self.err_code = err_code\n\n\nclass InvalidKey(Exception):\n pass\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/fernet.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport base64\nimport binascii\nimport os\nimport struct\nimport time\n\nimport six\n\nfrom cryptography import utils\nfrom cryptography.exceptions import InvalidSignature\nfrom cryptography.hazmat.backends import default_backend\nfrom cryptography.hazmat.primitives import hashes, padding\nfrom cryptography.hazmat.primitives.ciphers import Cipher, algorithms, modes\nfrom cryptography.hazmat.primitives.hmac import HMAC\n\n\nclass InvalidToken(Exception):\n pass\n\n\n_MAX_CLOCK_SKEW = 60\n\n\nclass Fernet(object):\n def __init__(self, key, backend=None):\n if backend is None:\n backend = default_backend()\n\n key = base64.urlsafe_b64decode(key)\n if len(key) != 32:\n raise ValueError(\n \"Fernet key must be 32 url-safe base64-encoded bytes.\"\n )\n\n self._signing_key = key[:16]\n self._encryption_key = key[16:]\n self._backend = backend\n\n @classmethod\n def generate_key(cls):\n return base64.urlsafe_b64encode(os.urandom(32))\n\n def encrypt(self, data):\n current_time = int(time.time())\n iv = os.urandom(16)\n return self._encrypt_from_parts(data, current_time, iv)\n\n def _encrypt_from_parts(self, data, current_time, iv):\n utils._check_bytes(\"data\", data)\n\n padder = padding.PKCS7(algorithms.AES.block_size).padder()\n padded_data = padder.update(data) + padder.finalize()\n encryptor = Cipher(\n algorithms.AES(self._encryption_key), modes.CBC(iv), self._backend\n ).encryptor()\n ciphertext = encryptor.update(padded_data) + encryptor.finalize()\n\n basic_parts = (\n b\"\\x80\" + struct.pack(\">Q\", current_time) + iv + ciphertext\n )\n\n h = HMAC(self._signing_key, hashes.SHA256(), backend=self._backend)\n h.update(basic_parts)\n hmac = h.finalize()\n return base64.urlsafe_b64encode(basic_parts + hmac)\n\n def decrypt(self, token, ttl=None):\n timestamp, data = Fernet._get_unverified_token_data(token)\n return self._decrypt_data(data, timestamp, ttl)\n\n def extract_timestamp(self, token):\n timestamp, data = Fernet._get_unverified_token_data(token)\n # Verify the token was not tampered with.\n self._verify_signature(data)\n return timestamp\n\n @staticmethod\n def _get_unverified_token_data(token):\n utils._check_bytes(\"token\", token)\n try:\n data = base64.urlsafe_b64decode(token)\n except (TypeError, binascii.Error):\n raise InvalidToken\n\n if not data or six.indexbytes(data, 0) != 0x80:\n raise InvalidToken\n\n try:\n timestamp, = struct.unpack(\">Q\", data[1:9])\n except struct.error:\n raise InvalidToken\n return timestamp, data\n\n def _verify_signature(self, data):\n h = HMAC(self._signing_key, hashes.SHA256(), backend=self._backend)\n h.update(data[:-32])\n try:\n h.verify(data[-32:])\n except InvalidSignature:\n raise InvalidToken\n\n def _decrypt_data(self, data, timestamp, ttl):\n current_time = int(time.time())\n if ttl is not None:\n if timestamp + ttl < current_time:\n raise InvalidToken\n\n if current_time + _MAX_CLOCK_SKEW < timestamp:\n raise InvalidToken\n\n self._verify_signature(data)\n\n iv = data[9:25]\n ciphertext = data[25:-32]\n decryptor = Cipher(\n algorithms.AES(self._encryption_key), modes.CBC(iv), self._backend\n ).decryptor()\n plaintext_padded = decryptor.update(ciphertext)\n try:\n plaintext_padded += decryptor.finalize()\n except ValueError:\n raise InvalidToken\n unpadder = padding.PKCS7(algorithms.AES.block_size).unpadder()\n\n unpadded = unpadder.update(plaintext_padded)\n try:\n unpadded += unpadder.finalize()\n except ValueError:\n raise InvalidToken\n return unpadded\n\n\nclass MultiFernet(object):\n def __init__(self, fernets):\n fernets = list(fernets)\n if not fernets:\n raise ValueError(\n \"MultiFernet requires at least one Fernet instance\"\n )\n self._fernets = fernets\n\n def encrypt(self, msg):\n return self._fernets[0].encrypt(msg)\n\n def rotate(self, msg):\n timestamp, data = Fernet._get_unverified_token_data(msg)\n for f in self._fernets:\n try:\n p = f._decrypt_data(data, timestamp, None)\n break\n except InvalidToken:\n pass\n else:\n raise InvalidToken\n\n iv = os.urandom(16)\n return self._fernets[0]._encrypt_from_parts(p, timestamp, iv)\n\n def decrypt(self, msg, ttl=None):\n for f in self._fernets:\n try:\n return f.decrypt(msg, ttl)\n except InvalidToken:\n pass\n raise InvalidToken\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/__init__.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\"\"\"\nHazardous Materials\n\nThis is a \"Hazardous Materials\" module. You should ONLY use it if you're\n100% absolutely sure that you know what you're doing because this module\nis full of land mines, dragons, and dinosaurs with laser guns.\n\"\"\"\nfrom __future__ import absolute_import, division, print_function\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/_der.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport six\n\nfrom cryptography.utils import int_from_bytes, int_to_bytes\n\n\n# This module contains a lightweight DER encoder and decoder. See X.690 for the\n# specification. This module intentionally does not implement the more complex\n# BER encoding, only DER.\n#\n# Note this implementation treats an element's constructed bit as part of the\n# tag. This is fine for DER, where the bit is always computable from the type.\n\n\nCONSTRUCTED = 0x20\nCONTEXT_SPECIFIC = 0x80\n\nINTEGER = 0x02\nBIT_STRING = 0x03\nOCTET_STRING = 0x04\nNULL = 0x05\nOBJECT_IDENTIFIER = 0x06\nSEQUENCE = 0x10 | CONSTRUCTED\nSET = 0x11 | CONSTRUCTED\nPRINTABLE_STRING = 0x13\nUTC_TIME = 0x17\nGENERALIZED_TIME = 0x18\n\n\nclass DERReader(object):\n def __init__(self, data):\n self.data = memoryview(data)\n\n def __enter__(self):\n return self\n\n def __exit__(self, exc_type, exc_value, tb):\n if exc_value is None:\n self.check_empty()\n\n def is_empty(self):\n return len(self.data) == 0\n\n def check_empty(self):\n if not self.is_empty():\n raise ValueError(\"Invalid DER input: trailing data\")\n\n def read_byte(self):\n if len(self.data) < 1:\n raise ValueError(\"Invalid DER input: insufficient data\")\n ret = six.indexbytes(self.data, 0)\n self.data = self.data[1:]\n return ret\n\n def read_bytes(self, n):\n if len(self.data) < n:\n raise ValueError(\"Invalid DER input: insufficient data\")\n ret = self.data[:n]\n self.data = self.data[n:]\n return ret\n\n def read_any_element(self):\n tag = self.read_byte()\n # Tag numbers 31 or higher are stored in multiple bytes. No supported\n # ASN.1 types use such tags, so reject these.\n if tag & 0x1f == 0x1f:\n raise ValueError(\"Invalid DER input: unexpected high tag number\")\n length_byte = self.read_byte()\n if length_byte & 0x80 == 0:\n # If the high bit is clear, the first length byte is the length.\n length = length_byte\n else:\n # If the high bit is set, the first length byte encodes the length\n # of the length.\n length_byte &= 0x7f\n if length_byte == 0:\n raise ValueError(\n \"Invalid DER input: indefinite length form is not allowed \"\n \"in DER\"\n )\n length = 0\n for i in range(length_byte):\n length <<= 8\n length |= self.read_byte()\n if length == 0:\n raise ValueError(\n \"Invalid DER input: length was not minimally-encoded\"\n )\n if length < 0x80:\n # If the length could have been encoded in short form, it must\n # not use long form.\n raise ValueError(\n \"Invalid DER input: length was not minimally-encoded\"\n )\n body = self.read_bytes(length)\n return tag, DERReader(body)\n\n def read_element(self, expected_tag):\n tag, body = self.read_any_element()\n if tag != expected_tag:\n raise ValueError(\"Invalid DER input: unexpected tag\")\n return body\n\n def read_single_element(self, expected_tag):\n with self:\n return self.read_element(expected_tag)\n\n def read_optional_element(self, expected_tag):\n if len(self.data) > 0 and six.indexbytes(self.data, 0) == expected_tag:\n return self.read_element(expected_tag)\n return None\n\n def as_integer(self):\n if len(self.data) == 0:\n raise ValueError(\"Invalid DER input: empty integer contents\")\n first = six.indexbytes(self.data, 0)\n if first & 0x80 == 0x80:\n raise ValueError(\"Negative DER integers are not supported\")\n # The first 9 bits must not all be zero or all be ones. Otherwise, the\n # encoding should have been one byte shorter.\n if len(self.data) > 1:\n second = six.indexbytes(self.data, 1)\n if first == 0 and second & 0x80 == 0:\n raise ValueError(\n \"Invalid DER input: integer not minimally-encoded\"\n )\n return int_from_bytes(self.data, \"big\")\n\n\ndef encode_der_integer(x):\n if not isinstance(x, six.integer_types):\n raise ValueError(\"Value must be an integer\")\n if x < 0:\n raise ValueError(\"Negative integers are not supported\")\n n = x.bit_length() // 8 + 1\n return int_to_bytes(x, n)\n\n\ndef encode_der(tag, *children):\n length = 0\n for child in children:\n length += len(child)\n chunks = [six.int2byte(tag)]\n if length < 0x80:\n chunks.append(six.int2byte(length))\n else:\n length_bytes = int_to_bytes(length)\n chunks.append(six.int2byte(0x80 | len(length_bytes)))\n chunks.append(length_bytes)\n chunks.extend(children)\n return b\"\".join(chunks)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/_oid.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nfrom cryptography import utils\n\n\nclass ObjectIdentifier(object):\n def __init__(self, dotted_string):\n self._dotted_string = dotted_string\n\n nodes = self._dotted_string.split(\".\")\n intnodes = []\n\n # There must be at least 2 nodes, the first node must be 0..2, and\n # if less than 2, the second node cannot have a value outside the\n # range 0..39. All nodes must be integers.\n for node in nodes:\n try:\n intnodes.append(int(node, 0))\n except ValueError:\n raise ValueError(\n \"Malformed OID: %s (non-integer nodes)\" % (\n self._dotted_string))\n\n if len(nodes) < 2:\n raise ValueError(\n \"Malformed OID: %s (insufficient number of nodes)\" % (\n self._dotted_string))\n\n if intnodes[0] > 2:\n raise ValueError(\n \"Malformed OID: %s (first node outside valid range)\" % (\n self._dotted_string))\n\n if intnodes[0] < 2 and intnodes[1] >= 40:\n raise ValueError(\n \"Malformed OID: %s (second node outside valid range)\" % (\n self._dotted_string))\n\n def __eq__(self, other):\n if not isinstance(other, ObjectIdentifier):\n return NotImplemented\n\n return self.dotted_string == other.dotted_string\n\n def __ne__(self, other):\n return not self == other\n\n def __repr__(self):\n return \"\".format(\n self.dotted_string,\n self._name\n )\n\n def __hash__(self):\n return hash(self.dotted_string)\n\n @property\n def _name(self):\n # Lazy import to avoid an import cycle\n from cryptography.x509.oid import _OID_NAMES\n return _OID_NAMES.get(self, \"Unknown OID\")\n\n dotted_string = utils.read_only_property(\"_dotted_string\")\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/backends/__init__.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\n\n_default_backend = None\n\n\ndef default_backend():\n global _default_backend\n\n if _default_backend is None:\n from cryptography.hazmat.backends.openssl.backend import backend\n _default_backend = backend\n\n return _default_backend\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/backends/interfaces.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport abc\n\nimport six\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass CipherBackend(object):\n @abc.abstractmethod\n def cipher_supported(self, cipher, mode):\n \"\"\"\n Return True if the given cipher and mode are supported.\n \"\"\"\n\n @abc.abstractmethod\n def create_symmetric_encryption_ctx(self, cipher, mode):\n \"\"\"\n Get a CipherContext that can be used for encryption.\n \"\"\"\n\n @abc.abstractmethod\n def create_symmetric_decryption_ctx(self, cipher, mode):\n \"\"\"\n Get a CipherContext that can be used for decryption.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass HashBackend(object):\n @abc.abstractmethod\n def hash_supported(self, algorithm):\n \"\"\"\n Return True if the hash algorithm is supported by this backend.\n \"\"\"\n\n @abc.abstractmethod\n def create_hash_ctx(self, algorithm):\n \"\"\"\n Create a HashContext for calculating a message digest.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass HMACBackend(object):\n @abc.abstractmethod\n def hmac_supported(self, algorithm):\n \"\"\"\n Return True if the hash algorithm is supported for HMAC by this\n backend.\n \"\"\"\n\n @abc.abstractmethod\n def create_hmac_ctx(self, key, algorithm):\n \"\"\"\n Create a context for calculating a message authentication code.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass CMACBackend(object):\n @abc.abstractmethod\n def cmac_algorithm_supported(self, algorithm):\n \"\"\"\n Returns True if the block cipher is supported for CMAC by this backend\n \"\"\"\n\n @abc.abstractmethod\n def create_cmac_ctx(self, algorithm):\n \"\"\"\n Create a context for calculating a message authentication code.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass PBKDF2HMACBackend(object):\n @abc.abstractmethod\n def pbkdf2_hmac_supported(self, algorithm):\n \"\"\"\n Return True if the hash algorithm is supported for PBKDF2 by this\n backend.\n \"\"\"\n\n @abc.abstractmethod\n def derive_pbkdf2_hmac(self, algorithm, length, salt, iterations,\n key_material):\n \"\"\"\n Return length bytes derived from provided PBKDF2 parameters.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass RSABackend(object):\n @abc.abstractmethod\n def generate_rsa_private_key(self, public_exponent, key_size):\n \"\"\"\n Generate an RSAPrivateKey instance with public_exponent and a modulus\n of key_size bits.\n \"\"\"\n\n @abc.abstractmethod\n def rsa_padding_supported(self, padding):\n \"\"\"\n Returns True if the backend supports the given padding options.\n \"\"\"\n\n @abc.abstractmethod\n def generate_rsa_parameters_supported(self, public_exponent, key_size):\n \"\"\"\n Returns True if the backend supports the given parameters for key\n generation.\n \"\"\"\n\n @abc.abstractmethod\n def load_rsa_private_numbers(self, numbers):\n \"\"\"\n Returns an RSAPrivateKey provider.\n \"\"\"\n\n @abc.abstractmethod\n def load_rsa_public_numbers(self, numbers):\n \"\"\"\n Returns an RSAPublicKey provider.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass DSABackend(object):\n @abc.abstractmethod\n def generate_dsa_parameters(self, key_size):\n \"\"\"\n Generate a DSAParameters instance with a modulus of key_size bits.\n \"\"\"\n\n @abc.abstractmethod\n def generate_dsa_private_key(self, parameters):\n \"\"\"\n Generate a DSAPrivateKey instance with parameters as a DSAParameters\n object.\n \"\"\"\n\n @abc.abstractmethod\n def generate_dsa_private_key_and_parameters(self, key_size):\n \"\"\"\n Generate a DSAPrivateKey instance using key size only.\n \"\"\"\n\n @abc.abstractmethod\n def dsa_hash_supported(self, algorithm):\n \"\"\"\n Return True if the hash algorithm is supported by the backend for DSA.\n \"\"\"\n\n @abc.abstractmethod\n def dsa_parameters_supported(self, p, q, g):\n \"\"\"\n Return True if the parameters are supported by the backend for DSA.\n \"\"\"\n\n @abc.abstractmethod\n def load_dsa_private_numbers(self, numbers):\n \"\"\"\n Returns a DSAPrivateKey provider.\n \"\"\"\n\n @abc.abstractmethod\n def load_dsa_public_numbers(self, numbers):\n \"\"\"\n Returns a DSAPublicKey provider.\n \"\"\"\n\n @abc.abstractmethod\n def load_dsa_parameter_numbers(self, numbers):\n \"\"\"\n Returns a DSAParameters provider.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass EllipticCurveBackend(object):\n @abc.abstractmethod\n def elliptic_curve_signature_algorithm_supported(\n self, signature_algorithm, curve\n ):\n \"\"\"\n Returns True if the backend supports the named elliptic curve with the\n specified signature algorithm.\n \"\"\"\n\n @abc.abstractmethod\n def elliptic_curve_supported(self, curve):\n \"\"\"\n Returns True if the backend supports the named elliptic curve.\n \"\"\"\n\n @abc.abstractmethod\n def generate_elliptic_curve_private_key(self, curve):\n \"\"\"\n Return an object conforming to the EllipticCurvePrivateKey interface.\n \"\"\"\n\n @abc.abstractmethod\n def load_elliptic_curve_public_numbers(self, numbers):\n \"\"\"\n Return an EllipticCurvePublicKey provider using the given numbers.\n \"\"\"\n\n @abc.abstractmethod\n def load_elliptic_curve_private_numbers(self, numbers):\n \"\"\"\n Return an EllipticCurvePrivateKey provider using the given numbers.\n \"\"\"\n\n @abc.abstractmethod\n def elliptic_curve_exchange_algorithm_supported(self, algorithm, curve):\n \"\"\"\n Returns whether the exchange algorithm is supported by this backend.\n \"\"\"\n\n @abc.abstractmethod\n def derive_elliptic_curve_private_key(self, private_value, curve):\n \"\"\"\n Compute the private key given the private value and curve.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass PEMSerializationBackend(object):\n @abc.abstractmethod\n def load_pem_private_key(self, data, password):\n \"\"\"\n Loads a private key from PEM encoded data, using the provided password\n if the data is encrypted.\n \"\"\"\n\n @abc.abstractmethod\n def load_pem_public_key(self, data):\n \"\"\"\n Loads a public key from PEM encoded data.\n \"\"\"\n\n @abc.abstractmethod\n def load_pem_parameters(self, data):\n \"\"\"\n Load encryption parameters from PEM encoded data.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass DERSerializationBackend(object):\n @abc.abstractmethod\n def load_der_private_key(self, data, password):\n \"\"\"\n Loads a private key from DER encoded data. Uses the provided password\n if the data is encrypted.\n \"\"\"\n\n @abc.abstractmethod\n def load_der_public_key(self, data):\n \"\"\"\n Loads a public key from DER encoded data.\n \"\"\"\n\n @abc.abstractmethod\n def load_der_parameters(self, data):\n \"\"\"\n Load encryption parameters from DER encoded data.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass X509Backend(object):\n @abc.abstractmethod\n def load_pem_x509_certificate(self, data):\n \"\"\"\n Load an X.509 certificate from PEM encoded data.\n \"\"\"\n\n @abc.abstractmethod\n def load_der_x509_certificate(self, data):\n \"\"\"\n Load an X.509 certificate from DER encoded data.\n \"\"\"\n\n @abc.abstractmethod\n def load_der_x509_csr(self, data):\n \"\"\"\n Load an X.509 CSR from DER encoded data.\n \"\"\"\n\n @abc.abstractmethod\n def load_pem_x509_csr(self, data):\n \"\"\"\n Load an X.509 CSR from PEM encoded data.\n \"\"\"\n\n @abc.abstractmethod\n def create_x509_csr(self, builder, private_key, algorithm):\n \"\"\"\n Create and sign an X.509 CSR from a CSR builder object.\n \"\"\"\n\n @abc.abstractmethod\n def create_x509_certificate(self, builder, private_key, algorithm):\n \"\"\"\n Create and sign an X.509 certificate from a CertificateBuilder object.\n \"\"\"\n\n @abc.abstractmethod\n def create_x509_crl(self, builder, private_key, algorithm):\n \"\"\"\n Create and sign an X.509 CertificateRevocationList from a\n CertificateRevocationListBuilder object.\n \"\"\"\n\n @abc.abstractmethod\n def create_x509_revoked_certificate(self, builder):\n \"\"\"\n Create a RevokedCertificate object from a RevokedCertificateBuilder\n object.\n \"\"\"\n\n @abc.abstractmethod\n def x509_name_bytes(self, name):\n \"\"\"\n Compute the DER encoded bytes of an X509 Name object.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass DHBackend(object):\n @abc.abstractmethod\n def generate_dh_parameters(self, generator, key_size):\n \"\"\"\n Generate a DHParameters instance with a modulus of key_size bits.\n Using the given generator. Often 2 or 5.\n \"\"\"\n\n @abc.abstractmethod\n def generate_dh_private_key(self, parameters):\n \"\"\"\n Generate a DHPrivateKey instance with parameters as a DHParameters\n object.\n \"\"\"\n\n @abc.abstractmethod\n def generate_dh_private_key_and_parameters(self, generator, key_size):\n \"\"\"\n Generate a DHPrivateKey instance using key size only.\n Using the given generator. Often 2 or 5.\n \"\"\"\n\n @abc.abstractmethod\n def load_dh_private_numbers(self, numbers):\n \"\"\"\n Load a DHPrivateKey from DHPrivateNumbers\n \"\"\"\n\n @abc.abstractmethod\n def load_dh_public_numbers(self, numbers):\n \"\"\"\n Load a DHPublicKey from DHPublicNumbers.\n \"\"\"\n\n @abc.abstractmethod\n def load_dh_parameter_numbers(self, numbers):\n \"\"\"\n Load DHParameters from DHParameterNumbers.\n \"\"\"\n\n @abc.abstractmethod\n def dh_parameters_supported(self, p, g, q=None):\n \"\"\"\n Returns whether the backend supports DH with these parameter values.\n \"\"\"\n\n @abc.abstractmethod\n def dh_x942_serialization_supported(self):\n \"\"\"\n Returns True if the backend supports the serialization of DH objects\n with subgroup order (q).\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass ScryptBackend(object):\n @abc.abstractmethod\n def derive_scrypt(self, key_material, salt, length, n, r, p):\n \"\"\"\n Return bytes derived from provided Scrypt parameters.\n \"\"\"\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/backends/openssl/__init__.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nfrom cryptography.hazmat.backends.openssl.backend import backend\n\n\n__all__ = [\"backend\"]\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/backends/openssl/aead.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nfrom cryptography.exceptions import InvalidTag\n\n\n_ENCRYPT = 1\n_DECRYPT = 0\n\n\ndef _aead_cipher_name(cipher):\n from cryptography.hazmat.primitives.ciphers.aead import (\n AESCCM, AESGCM, ChaCha20Poly1305\n )\n if isinstance(cipher, ChaCha20Poly1305):\n return b\"chacha20-poly1305\"\n elif isinstance(cipher, AESCCM):\n return \"aes-{}-ccm\".format(len(cipher._key) * 8).encode(\"ascii\")\n else:\n assert isinstance(cipher, AESGCM)\n return \"aes-{}-gcm\".format(len(cipher._key) * 8).encode(\"ascii\")\n\n\ndef _aead_setup(backend, cipher_name, key, nonce, tag, tag_len, operation):\n evp_cipher = backend._lib.EVP_get_cipherbyname(cipher_name)\n backend.openssl_assert(evp_cipher != backend._ffi.NULL)\n ctx = backend._lib.EVP_CIPHER_CTX_new()\n ctx = backend._ffi.gc(ctx, backend._lib.EVP_CIPHER_CTX_free)\n res = backend._lib.EVP_CipherInit_ex(\n ctx, evp_cipher,\n backend._ffi.NULL,\n backend._ffi.NULL,\n backend._ffi.NULL,\n int(operation == _ENCRYPT)\n )\n backend.openssl_assert(res != 0)\n res = backend._lib.EVP_CIPHER_CTX_set_key_length(ctx, len(key))\n backend.openssl_assert(res != 0)\n res = backend._lib.EVP_CIPHER_CTX_ctrl(\n ctx, backend._lib.EVP_CTRL_AEAD_SET_IVLEN, len(nonce),\n backend._ffi.NULL\n )\n backend.openssl_assert(res != 0)\n if operation == _DECRYPT:\n res = backend._lib.EVP_CIPHER_CTX_ctrl(\n ctx, backend._lib.EVP_CTRL_AEAD_SET_TAG, len(tag), tag\n )\n backend.openssl_assert(res != 0)\n elif cipher_name.endswith(b\"-ccm\"):\n res = backend._lib.EVP_CIPHER_CTX_ctrl(\n ctx, backend._lib.EVP_CTRL_AEAD_SET_TAG, tag_len, backend._ffi.NULL\n )\n backend.openssl_assert(res != 0)\n\n nonce_ptr = backend._ffi.from_buffer(nonce)\n key_ptr = backend._ffi.from_buffer(key)\n res = backend._lib.EVP_CipherInit_ex(\n ctx,\n backend._ffi.NULL,\n backend._ffi.NULL,\n key_ptr,\n nonce_ptr,\n int(operation == _ENCRYPT)\n )\n backend.openssl_assert(res != 0)\n return ctx\n\n\ndef _set_length(backend, ctx, data_len):\n intptr = backend._ffi.new(\"int *\")\n res = backend._lib.EVP_CipherUpdate(\n ctx,\n backend._ffi.NULL,\n intptr,\n backend._ffi.NULL,\n data_len\n )\n backend.openssl_assert(res != 0)\n\n\ndef _process_aad(backend, ctx, associated_data):\n outlen = backend._ffi.new(\"int *\")\n res = backend._lib.EVP_CipherUpdate(\n ctx, backend._ffi.NULL, outlen, associated_data, len(associated_data)\n )\n backend.openssl_assert(res != 0)\n\n\ndef _process_data(backend, ctx, data):\n outlen = backend._ffi.new(\"int *\")\n buf = backend._ffi.new(\"unsigned char[]\", len(data))\n res = backend._lib.EVP_CipherUpdate(ctx, buf, outlen, data, len(data))\n backend.openssl_assert(res != 0)\n return backend._ffi.buffer(buf, outlen[0])[:]\n\n\ndef _encrypt(backend, cipher, nonce, data, associated_data, tag_length):\n from cryptography.hazmat.primitives.ciphers.aead import AESCCM\n cipher_name = _aead_cipher_name(cipher)\n ctx = _aead_setup(\n backend, cipher_name, cipher._key, nonce, None, tag_length, _ENCRYPT\n )\n # CCM requires us to pass the length of the data before processing anything\n # However calling this with any other AEAD results in an error\n if isinstance(cipher, AESCCM):\n _set_length(backend, ctx, len(data))\n\n _process_aad(backend, ctx, associated_data)\n processed_data = _process_data(backend, ctx, data)\n outlen = backend._ffi.new(\"int *\")\n res = backend._lib.EVP_CipherFinal_ex(ctx, backend._ffi.NULL, outlen)\n backend.openssl_assert(res != 0)\n backend.openssl_assert(outlen[0] == 0)\n tag_buf = backend._ffi.new(\"unsigned char[]\", tag_length)\n res = backend._lib.EVP_CIPHER_CTX_ctrl(\n ctx, backend._lib.EVP_CTRL_AEAD_GET_TAG, tag_length, tag_buf\n )\n backend.openssl_assert(res != 0)\n tag = backend._ffi.buffer(tag_buf)[:]\n\n return processed_data + tag\n\n\ndef _decrypt(backend, cipher, nonce, data, associated_data, tag_length):\n from cryptography.hazmat.primitives.ciphers.aead import AESCCM\n if len(data) < tag_length:\n raise InvalidTag\n tag = data[-tag_length:]\n data = data[:-tag_length]\n cipher_name = _aead_cipher_name(cipher)\n ctx = _aead_setup(\n backend, cipher_name, cipher._key, nonce, tag, tag_length, _DECRYPT\n )\n # CCM requires us to pass the length of the data before processing anything\n # However calling this with any other AEAD results in an error\n if isinstance(cipher, AESCCM):\n _set_length(backend, ctx, len(data))\n\n _process_aad(backend, ctx, associated_data)\n # CCM has a different error path if the tag doesn't match. Errors are\n # raised in Update and Final is irrelevant.\n if isinstance(cipher, AESCCM):\n outlen = backend._ffi.new(\"int *\")\n buf = backend._ffi.new(\"unsigned char[]\", len(data))\n res = backend._lib.EVP_CipherUpdate(ctx, buf, outlen, data, len(data))\n if res != 1:\n backend._consume_errors()\n raise InvalidTag\n\n processed_data = backend._ffi.buffer(buf, outlen[0])[:]\n else:\n processed_data = _process_data(backend, ctx, data)\n outlen = backend._ffi.new(\"int *\")\n res = backend._lib.EVP_CipherFinal_ex(ctx, backend._ffi.NULL, outlen)\n if res == 0:\n backend._consume_errors()\n raise InvalidTag\n\n return processed_data\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/backends/openssl/backend.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport base64\nimport collections\nimport contextlib\nimport itertools\nfrom contextlib import contextmanager\n\nimport six\nfrom six.moves import range\n\nfrom cryptography import utils, x509\nfrom cryptography.exceptions import UnsupportedAlgorithm, _Reasons\nfrom cryptography.hazmat._der import (\n INTEGER, NULL, SEQUENCE, encode_der, encode_der_integer\n)\nfrom cryptography.hazmat.backends.interfaces import (\n CMACBackend, CipherBackend, DERSerializationBackend, DHBackend, DSABackend,\n EllipticCurveBackend, HMACBackend, HashBackend, PBKDF2HMACBackend,\n PEMSerializationBackend, RSABackend, ScryptBackend, X509Backend\n)\nfrom cryptography.hazmat.backends.openssl import aead\nfrom cryptography.hazmat.backends.openssl.ciphers import _CipherContext\nfrom cryptography.hazmat.backends.openssl.cmac import _CMACContext\nfrom cryptography.hazmat.backends.openssl.decode_asn1 import (\n _CRL_ENTRY_REASON_ENUM_TO_CODE\n)\nfrom cryptography.hazmat.backends.openssl.dh import (\n _DHParameters, _DHPrivateKey, _DHPublicKey, _dh_params_dup\n)\nfrom cryptography.hazmat.backends.openssl.dsa import (\n _DSAParameters, _DSAPrivateKey, _DSAPublicKey\n)\nfrom cryptography.hazmat.backends.openssl.ec import (\n _EllipticCurvePrivateKey, _EllipticCurvePublicKey\n)\nfrom cryptography.hazmat.backends.openssl.ed25519 import (\n _Ed25519PrivateKey, _Ed25519PublicKey\n)\nfrom cryptography.hazmat.backends.openssl.ed448 import (\n _ED448_KEY_SIZE, _Ed448PrivateKey, _Ed448PublicKey\n)\nfrom cryptography.hazmat.backends.openssl.encode_asn1 import (\n _CRL_ENTRY_EXTENSION_ENCODE_HANDLERS,\n _CRL_EXTENSION_ENCODE_HANDLERS, _EXTENSION_ENCODE_HANDLERS,\n _OCSP_BASICRESP_EXTENSION_ENCODE_HANDLERS,\n _OCSP_REQUEST_EXTENSION_ENCODE_HANDLERS,\n _encode_asn1_int_gc, _encode_asn1_str_gc, _encode_name_gc, _txt2obj_gc,\n)\nfrom cryptography.hazmat.backends.openssl.hashes import _HashContext\nfrom cryptography.hazmat.backends.openssl.hmac import _HMACContext\nfrom cryptography.hazmat.backends.openssl.ocsp import (\n _OCSPRequest, _OCSPResponse\n)\nfrom cryptography.hazmat.backends.openssl.poly1305 import (\n _POLY1305_KEY_SIZE, _Poly1305Context\n)\nfrom cryptography.hazmat.backends.openssl.rsa import (\n _RSAPrivateKey, _RSAPublicKey\n)\nfrom cryptography.hazmat.backends.openssl.x25519 import (\n _X25519PrivateKey, _X25519PublicKey\n)\nfrom cryptography.hazmat.backends.openssl.x448 import (\n _X448PrivateKey, _X448PublicKey\n)\nfrom cryptography.hazmat.backends.openssl.x509 import (\n _Certificate, _CertificateRevocationList,\n _CertificateSigningRequest, _RevokedCertificate\n)\nfrom cryptography.hazmat.bindings.openssl import binding\nfrom cryptography.hazmat.primitives import hashes, serialization\nfrom cryptography.hazmat.primitives.asymmetric import (\n dsa, ec, ed25519, ed448, rsa\n)\nfrom cryptography.hazmat.primitives.asymmetric.padding import (\n MGF1, OAEP, PKCS1v15, PSS\n)\nfrom cryptography.hazmat.primitives.ciphers.algorithms import (\n AES, ARC4, Blowfish, CAST5, Camellia, ChaCha20, IDEA, SEED, TripleDES\n)\nfrom cryptography.hazmat.primitives.ciphers.modes import (\n CBC, CFB, CFB8, CTR, ECB, GCM, OFB, XTS\n)\nfrom cryptography.hazmat.primitives.kdf import scrypt\nfrom cryptography.hazmat.primitives.serialization import ssh\nfrom cryptography.x509 import ocsp\n\n\n_MemoryBIO = collections.namedtuple(\"_MemoryBIO\", [\"bio\", \"char_ptr\"])\n\n\n@utils.register_interface(CipherBackend)\n@utils.register_interface(CMACBackend)\n@utils.register_interface(DERSerializationBackend)\n@utils.register_interface(DHBackend)\n@utils.register_interface(DSABackend)\n@utils.register_interface(EllipticCurveBackend)\n@utils.register_interface(HashBackend)\n@utils.register_interface(HMACBackend)\n@utils.register_interface(PBKDF2HMACBackend)\n@utils.register_interface(RSABackend)\n@utils.register_interface(PEMSerializationBackend)\n@utils.register_interface(X509Backend)\n@utils.register_interface_if(\n binding.Binding().lib.Cryptography_HAS_SCRYPT, ScryptBackend\n)\nclass Backend(object):\n \"\"\"\n OpenSSL API binding interfaces.\n \"\"\"\n name = \"openssl\"\n\n def __init__(self):\n self._binding = binding.Binding()\n self._ffi = self._binding.ffi\n self._lib = self._binding.lib\n\n self._cipher_registry = {}\n self._register_default_ciphers()\n self.activate_osrandom_engine()\n self._dh_types = [self._lib.EVP_PKEY_DH]\n if self._lib.Cryptography_HAS_EVP_PKEY_DHX:\n self._dh_types.append(self._lib.EVP_PKEY_DHX)\n\n def openssl_assert(self, ok):\n return binding._openssl_assert(self._lib, ok)\n\n def activate_builtin_random(self):\n if self._lib.Cryptography_HAS_ENGINE:\n # Obtain a new structural reference.\n e = self._lib.ENGINE_get_default_RAND()\n if e != self._ffi.NULL:\n self._lib.ENGINE_unregister_RAND(e)\n # Reset the RNG to use the built-in.\n res = self._lib.RAND_set_rand_method(self._ffi.NULL)\n self.openssl_assert(res == 1)\n # decrement the structural reference from get_default_RAND\n res = self._lib.ENGINE_finish(e)\n self.openssl_assert(res == 1)\n\n @contextlib.contextmanager\n def _get_osurandom_engine(self):\n # Fetches an engine by id and returns it. This creates a structural\n # reference.\n e = self._lib.ENGINE_by_id(self._lib.Cryptography_osrandom_engine_id)\n self.openssl_assert(e != self._ffi.NULL)\n # Initialize the engine for use. This adds a functional reference.\n res = self._lib.ENGINE_init(e)\n self.openssl_assert(res == 1)\n\n try:\n yield e\n finally:\n # Decrement the structural ref incremented by ENGINE_by_id.\n res = self._lib.ENGINE_free(e)\n self.openssl_assert(res == 1)\n # Decrement the functional ref incremented by ENGINE_init.\n res = self._lib.ENGINE_finish(e)\n self.openssl_assert(res == 1)\n\n def activate_osrandom_engine(self):\n if self._lib.Cryptography_HAS_ENGINE:\n # Unregister and free the current engine.\n self.activate_builtin_random()\n with self._get_osurandom_engine() as e:\n # Set the engine as the default RAND provider.\n res = self._lib.ENGINE_set_default_RAND(e)\n self.openssl_assert(res == 1)\n # Reset the RNG to use the engine\n res = self._lib.RAND_set_rand_method(self._ffi.NULL)\n self.openssl_assert(res == 1)\n\n def osrandom_engine_implementation(self):\n buf = self._ffi.new(\"char[]\", 64)\n with self._get_osurandom_engine() as e:\n res = self._lib.ENGINE_ctrl_cmd(e, b\"get_implementation\",\n len(buf), buf,\n self._ffi.NULL, 0)\n self.openssl_assert(res > 0)\n return self._ffi.string(buf).decode('ascii')\n\n def openssl_version_text(self):\n \"\"\"\n Friendly string name of the loaded OpenSSL library. This is not\n necessarily the same version as it was compiled against.\n\n Example: OpenSSL 1.0.1e 11 Feb 2013\n \"\"\"\n return self._ffi.string(\n self._lib.OpenSSL_version(self._lib.OPENSSL_VERSION)\n ).decode(\"ascii\")\n\n def openssl_version_number(self):\n return self._lib.OpenSSL_version_num()\n\n def create_hmac_ctx(self, key, algorithm):\n return _HMACContext(self, key, algorithm)\n\n def _evp_md_from_algorithm(self, algorithm):\n if algorithm.name == \"blake2b\" or algorithm.name == \"blake2s\":\n alg = \"{}{}\".format(\n algorithm.name, algorithm.digest_size * 8\n ).encode(\"ascii\")\n else:\n alg = algorithm.name.encode(\"ascii\")\n\n evp_md = self._lib.EVP_get_digestbyname(alg)\n return evp_md\n\n def _evp_md_non_null_from_algorithm(self, algorithm):\n evp_md = self._evp_md_from_algorithm(algorithm)\n self.openssl_assert(evp_md != self._ffi.NULL)\n return evp_md\n\n def hash_supported(self, algorithm):\n evp_md = self._evp_md_from_algorithm(algorithm)\n return evp_md != self._ffi.NULL\n\n def hmac_supported(self, algorithm):\n return self.hash_supported(algorithm)\n\n def create_hash_ctx(self, algorithm):\n return _HashContext(self, algorithm)\n\n def cipher_supported(self, cipher, mode):\n try:\n adapter = self._cipher_registry[type(cipher), type(mode)]\n except KeyError:\n return False\n evp_cipher = adapter(self, cipher, mode)\n return self._ffi.NULL != evp_cipher\n\n def register_cipher_adapter(self, cipher_cls, mode_cls, adapter):\n if (cipher_cls, mode_cls) in self._cipher_registry:\n raise ValueError(\"Duplicate registration for: {} {}.\".format(\n cipher_cls, mode_cls)\n )\n self._cipher_registry[cipher_cls, mode_cls] = adapter\n\n def _register_default_ciphers(self):\n for mode_cls in [CBC, CTR, ECB, OFB, CFB, CFB8, GCM]:\n self.register_cipher_adapter(\n AES,\n mode_cls,\n GetCipherByName(\"{cipher.name}-{cipher.key_size}-{mode.name}\")\n )\n for mode_cls in [CBC, CTR, ECB, OFB, CFB]:\n self.register_cipher_adapter(\n Camellia,\n mode_cls,\n GetCipherByName(\"{cipher.name}-{cipher.key_size}-{mode.name}\")\n )\n for mode_cls in [CBC, CFB, CFB8, OFB]:\n self.register_cipher_adapter(\n TripleDES,\n mode_cls,\n GetCipherByName(\"des-ede3-{mode.name}\")\n )\n self.register_cipher_adapter(\n TripleDES,\n ECB,\n GetCipherByName(\"des-ede3\")\n )\n for mode_cls in [CBC, CFB, OFB, ECB]:\n self.register_cipher_adapter(\n Blowfish,\n mode_cls,\n GetCipherByName(\"bf-{mode.name}\")\n )\n for mode_cls in [CBC, CFB, OFB, ECB]:\n self.register_cipher_adapter(\n SEED,\n mode_cls,\n GetCipherByName(\"seed-{mode.name}\")\n )\n for cipher_cls, mode_cls in itertools.product(\n [CAST5, IDEA],\n [CBC, OFB, CFB, ECB],\n ):\n self.register_cipher_adapter(\n cipher_cls,\n mode_cls,\n GetCipherByName(\"{cipher.name}-{mode.name}\")\n )\n self.register_cipher_adapter(\n ARC4,\n type(None),\n GetCipherByName(\"rc4\")\n )\n self.register_cipher_adapter(\n ChaCha20,\n type(None),\n GetCipherByName(\"chacha20\")\n )\n self.register_cipher_adapter(AES, XTS, _get_xts_cipher)\n\n def create_symmetric_encryption_ctx(self, cipher, mode):\n return _CipherContext(self, cipher, mode, _CipherContext._ENCRYPT)\n\n def create_symmetric_decryption_ctx(self, cipher, mode):\n return _CipherContext(self, cipher, mode, _CipherContext._DECRYPT)\n\n def pbkdf2_hmac_supported(self, algorithm):\n return self.hmac_supported(algorithm)\n\n def derive_pbkdf2_hmac(self, algorithm, length, salt, iterations,\n key_material):\n buf = self._ffi.new(\"unsigned char[]\", length)\n evp_md = self._evp_md_non_null_from_algorithm(algorithm)\n key_material_ptr = self._ffi.from_buffer(key_material)\n res = self._lib.PKCS5_PBKDF2_HMAC(\n key_material_ptr,\n len(key_material),\n salt,\n len(salt),\n iterations,\n evp_md,\n length,\n buf\n )\n self.openssl_assert(res == 1)\n return self._ffi.buffer(buf)[:]\n\n def _consume_errors(self):\n return binding._consume_errors(self._lib)\n\n def _bn_to_int(self, bn):\n assert bn != self._ffi.NULL\n\n if not six.PY2:\n # Python 3 has constant time from_bytes, so use that.\n bn_num_bytes = self._lib.BN_num_bytes(bn)\n bin_ptr = self._ffi.new(\"unsigned char[]\", bn_num_bytes)\n bin_len = self._lib.BN_bn2bin(bn, bin_ptr)\n # A zero length means the BN has value 0\n self.openssl_assert(bin_len >= 0)\n val = int.from_bytes(self._ffi.buffer(bin_ptr)[:bin_len], \"big\")\n if self._lib.BN_is_negative(bn):\n val = -val\n return val\n else:\n # Under Python 2 the best we can do is hex()\n hex_cdata = self._lib.BN_bn2hex(bn)\n self.openssl_assert(hex_cdata != self._ffi.NULL)\n hex_str = self._ffi.string(hex_cdata)\n self._lib.OPENSSL_free(hex_cdata)\n return int(hex_str, 16)\n\n def _int_to_bn(self, num, bn=None):\n \"\"\"\n Converts a python integer to a BIGNUM. The returned BIGNUM will not\n be garbage collected (to support adding them to structs that take\n ownership of the object). Be sure to register it for GC if it will\n be discarded after use.\n \"\"\"\n assert bn is None or bn != self._ffi.NULL\n\n if bn is None:\n bn = self._ffi.NULL\n\n if not six.PY2:\n # Python 3 has constant time to_bytes, so use that.\n\n binary = num.to_bytes(int(num.bit_length() / 8.0 + 1), \"big\")\n bn_ptr = self._lib.BN_bin2bn(binary, len(binary), bn)\n self.openssl_assert(bn_ptr != self._ffi.NULL)\n return bn_ptr\n\n else:\n # Under Python 2 the best we can do is hex(), [2:] removes the 0x\n # prefix.\n hex_num = hex(num).rstrip(\"L\")[2:].encode(\"ascii\")\n bn_ptr = self._ffi.new(\"BIGNUM **\")\n bn_ptr[0] = bn\n res = self._lib.BN_hex2bn(bn_ptr, hex_num)\n self.openssl_assert(res != 0)\n self.openssl_assert(bn_ptr[0] != self._ffi.NULL)\n return bn_ptr[0]\n\n def generate_rsa_private_key(self, public_exponent, key_size):\n rsa._verify_rsa_parameters(public_exponent, key_size)\n\n rsa_cdata = self._lib.RSA_new()\n self.openssl_assert(rsa_cdata != self._ffi.NULL)\n rsa_cdata = self._ffi.gc(rsa_cdata, self._lib.RSA_free)\n\n bn = self._int_to_bn(public_exponent)\n bn = self._ffi.gc(bn, self._lib.BN_free)\n\n res = self._lib.RSA_generate_key_ex(\n rsa_cdata, key_size, bn, self._ffi.NULL\n )\n self.openssl_assert(res == 1)\n evp_pkey = self._rsa_cdata_to_evp_pkey(rsa_cdata)\n\n return _RSAPrivateKey(self, rsa_cdata, evp_pkey)\n\n def generate_rsa_parameters_supported(self, public_exponent, key_size):\n return (public_exponent >= 3 and public_exponent & 1 != 0 and\n key_size >= 512)\n\n def load_rsa_private_numbers(self, numbers):\n rsa._check_private_key_components(\n numbers.p,\n numbers.q,\n numbers.d,\n numbers.dmp1,\n numbers.dmq1,\n numbers.iqmp,\n numbers.public_numbers.e,\n numbers.public_numbers.n\n )\n rsa_cdata = self._lib.RSA_new()\n self.openssl_assert(rsa_cdata != self._ffi.NULL)\n rsa_cdata = self._ffi.gc(rsa_cdata, self._lib.RSA_free)\n p = self._int_to_bn(numbers.p)\n q = self._int_to_bn(numbers.q)\n d = self._int_to_bn(numbers.d)\n dmp1 = self._int_to_bn(numbers.dmp1)\n dmq1 = self._int_to_bn(numbers.dmq1)\n iqmp = self._int_to_bn(numbers.iqmp)\n e = self._int_to_bn(numbers.public_numbers.e)\n n = self._int_to_bn(numbers.public_numbers.n)\n res = self._lib.RSA_set0_factors(rsa_cdata, p, q)\n self.openssl_assert(res == 1)\n res = self._lib.RSA_set0_key(rsa_cdata, n, e, d)\n self.openssl_assert(res == 1)\n res = self._lib.RSA_set0_crt_params(rsa_cdata, dmp1, dmq1, iqmp)\n self.openssl_assert(res == 1)\n res = self._lib.RSA_blinding_on(rsa_cdata, self._ffi.NULL)\n self.openssl_assert(res == 1)\n evp_pkey = self._rsa_cdata_to_evp_pkey(rsa_cdata)\n\n return _RSAPrivateKey(self, rsa_cdata, evp_pkey)\n\n def load_rsa_public_numbers(self, numbers):\n rsa._check_public_key_components(numbers.e, numbers.n)\n rsa_cdata = self._lib.RSA_new()\n self.openssl_assert(rsa_cdata != self._ffi.NULL)\n rsa_cdata = self._ffi.gc(rsa_cdata, self._lib.RSA_free)\n e = self._int_to_bn(numbers.e)\n n = self._int_to_bn(numbers.n)\n res = self._lib.RSA_set0_key(rsa_cdata, n, e, self._ffi.NULL)\n self.openssl_assert(res == 1)\n evp_pkey = self._rsa_cdata_to_evp_pkey(rsa_cdata)\n\n return _RSAPublicKey(self, rsa_cdata, evp_pkey)\n\n def _create_evp_pkey_gc(self):\n evp_pkey = self._lib.EVP_PKEY_new()\n self.openssl_assert(evp_pkey != self._ffi.NULL)\n evp_pkey = self._ffi.gc(evp_pkey, self._lib.EVP_PKEY_free)\n return evp_pkey\n\n def _rsa_cdata_to_evp_pkey(self, rsa_cdata):\n evp_pkey = self._create_evp_pkey_gc()\n res = self._lib.EVP_PKEY_set1_RSA(evp_pkey, rsa_cdata)\n self.openssl_assert(res == 1)\n return evp_pkey\n\n def _bytes_to_bio(self, data):\n \"\"\"\n Return a _MemoryBIO namedtuple of (BIO, char*).\n\n The char* is the storage for the BIO and it must stay alive until the\n BIO is finished with.\n \"\"\"\n data_ptr = self._ffi.from_buffer(data)\n bio = self._lib.BIO_new_mem_buf(\n data_ptr, len(data)\n )\n self.openssl_assert(bio != self._ffi.NULL)\n\n return _MemoryBIO(self._ffi.gc(bio, self._lib.BIO_free), data_ptr)\n\n def _create_mem_bio_gc(self):\n \"\"\"\n Creates an empty memory BIO.\n \"\"\"\n bio_method = self._lib.BIO_s_mem()\n self.openssl_assert(bio_method != self._ffi.NULL)\n bio = self._lib.BIO_new(bio_method)\n self.openssl_assert(bio != self._ffi.NULL)\n bio = self._ffi.gc(bio, self._lib.BIO_free)\n return bio\n\n def _read_mem_bio(self, bio):\n \"\"\"\n Reads a memory BIO. This only works on memory BIOs.\n \"\"\"\n buf = self._ffi.new(\"char **\")\n buf_len = self._lib.BIO_get_mem_data(bio, buf)\n self.openssl_assert(buf_len > 0)\n self.openssl_assert(buf[0] != self._ffi.NULL)\n bio_data = self._ffi.buffer(buf[0], buf_len)[:]\n return bio_data\n\n def _evp_pkey_to_private_key(self, evp_pkey):\n \"\"\"\n Return the appropriate type of PrivateKey given an evp_pkey cdata\n pointer.\n \"\"\"\n\n key_type = self._lib.EVP_PKEY_id(evp_pkey)\n\n if key_type == self._lib.EVP_PKEY_RSA:\n rsa_cdata = self._lib.EVP_PKEY_get1_RSA(evp_pkey)\n self.openssl_assert(rsa_cdata != self._ffi.NULL)\n rsa_cdata = self._ffi.gc(rsa_cdata, self._lib.RSA_free)\n return _RSAPrivateKey(self, rsa_cdata, evp_pkey)\n elif key_type == self._lib.EVP_PKEY_DSA:\n dsa_cdata = self._lib.EVP_PKEY_get1_DSA(evp_pkey)\n self.openssl_assert(dsa_cdata != self._ffi.NULL)\n dsa_cdata = self._ffi.gc(dsa_cdata, self._lib.DSA_free)\n return _DSAPrivateKey(self, dsa_cdata, evp_pkey)\n elif key_type == self._lib.EVP_PKEY_EC:\n ec_cdata = self._lib.EVP_PKEY_get1_EC_KEY(evp_pkey)\n self.openssl_assert(ec_cdata != self._ffi.NULL)\n ec_cdata = self._ffi.gc(ec_cdata, self._lib.EC_KEY_free)\n return _EllipticCurvePrivateKey(self, ec_cdata, evp_pkey)\n elif key_type in self._dh_types:\n dh_cdata = self._lib.EVP_PKEY_get1_DH(evp_pkey)\n self.openssl_assert(dh_cdata != self._ffi.NULL)\n dh_cdata = self._ffi.gc(dh_cdata, self._lib.DH_free)\n return _DHPrivateKey(self, dh_cdata, evp_pkey)\n elif key_type == getattr(self._lib, \"EVP_PKEY_ED25519\", None):\n # EVP_PKEY_ED25519 is not present in OpenSSL < 1.1.1\n return _Ed25519PrivateKey(self, evp_pkey)\n elif key_type == getattr(self._lib, \"EVP_PKEY_X448\", None):\n # EVP_PKEY_X448 is not present in OpenSSL < 1.1.1\n return _X448PrivateKey(self, evp_pkey)\n elif key_type == getattr(self._lib, \"EVP_PKEY_X25519\", None):\n # EVP_PKEY_X25519 is not present in OpenSSL < 1.1.0\n return _X25519PrivateKey(self, evp_pkey)\n elif key_type == getattr(self._lib, \"EVP_PKEY_ED448\", None):\n # EVP_PKEY_ED448 is not present in OpenSSL < 1.1.1\n return _Ed448PrivateKey(self, evp_pkey)\n else:\n raise UnsupportedAlgorithm(\"Unsupported key type.\")\n\n def _evp_pkey_to_public_key(self, evp_pkey):\n \"\"\"\n Return the appropriate type of PublicKey given an evp_pkey cdata\n pointer.\n \"\"\"\n\n key_type = self._lib.EVP_PKEY_id(evp_pkey)\n\n if key_type == self._lib.EVP_PKEY_RSA:\n rsa_cdata = self._lib.EVP_PKEY_get1_RSA(evp_pkey)\n self.openssl_assert(rsa_cdata != self._ffi.NULL)\n rsa_cdata = self._ffi.gc(rsa_cdata, self._lib.RSA_free)\n return _RSAPublicKey(self, rsa_cdata, evp_pkey)\n elif key_type == self._lib.EVP_PKEY_DSA:\n dsa_cdata = self._lib.EVP_PKEY_get1_DSA(evp_pkey)\n self.openssl_assert(dsa_cdata != self._ffi.NULL)\n dsa_cdata = self._ffi.gc(dsa_cdata, self._lib.DSA_free)\n return _DSAPublicKey(self, dsa_cdata, evp_pkey)\n elif key_type == self._lib.EVP_PKEY_EC:\n ec_cdata = self._lib.EVP_PKEY_get1_EC_KEY(evp_pkey)\n self.openssl_assert(ec_cdata != self._ffi.NULL)\n ec_cdata = self._ffi.gc(ec_cdata, self._lib.EC_KEY_free)\n return _EllipticCurvePublicKey(self, ec_cdata, evp_pkey)\n elif key_type in self._dh_types:\n dh_cdata = self._lib.EVP_PKEY_get1_DH(evp_pkey)\n self.openssl_assert(dh_cdata != self._ffi.NULL)\n dh_cdata = self._ffi.gc(dh_cdata, self._lib.DH_free)\n return _DHPublicKey(self, dh_cdata, evp_pkey)\n elif key_type == getattr(self._lib, \"EVP_PKEY_ED25519\", None):\n # EVP_PKEY_ED25519 is not present in OpenSSL < 1.1.1\n return _Ed25519PublicKey(self, evp_pkey)\n elif key_type == getattr(self._lib, \"EVP_PKEY_X448\", None):\n # EVP_PKEY_X448 is not present in OpenSSL < 1.1.1\n return _X448PublicKey(self, evp_pkey)\n elif key_type == getattr(self._lib, \"EVP_PKEY_X25519\", None):\n # EVP_PKEY_X25519 is not present in OpenSSL < 1.1.0\n return _X25519PublicKey(self, evp_pkey)\n elif key_type == getattr(self._lib, \"EVP_PKEY_ED448\", None):\n # EVP_PKEY_X25519 is not present in OpenSSL < 1.1.1\n return _Ed448PublicKey(self, evp_pkey)\n else:\n raise UnsupportedAlgorithm(\"Unsupported key type.\")\n\n def _oaep_hash_supported(self, algorithm):\n if self._lib.Cryptography_HAS_RSA_OAEP_MD:\n return isinstance(\n algorithm, (\n hashes.SHA1,\n hashes.SHA224,\n hashes.SHA256,\n hashes.SHA384,\n hashes.SHA512,\n )\n )\n else:\n return isinstance(algorithm, hashes.SHA1)\n\n def rsa_padding_supported(self, padding):\n if isinstance(padding, PKCS1v15):\n return True\n elif isinstance(padding, PSS) and isinstance(padding._mgf, MGF1):\n return self.hash_supported(padding._mgf._algorithm)\n elif isinstance(padding, OAEP) and isinstance(padding._mgf, MGF1):\n return (\n self._oaep_hash_supported(padding._mgf._algorithm) and\n self._oaep_hash_supported(padding._algorithm) and\n (\n (padding._label is None or len(padding._label) == 0) or\n self._lib.Cryptography_HAS_RSA_OAEP_LABEL == 1\n )\n )\n else:\n return False\n\n def generate_dsa_parameters(self, key_size):\n if key_size not in (1024, 2048, 3072):\n raise ValueError(\"Key size must be 1024 or 2048 or 3072 bits.\")\n\n ctx = self._lib.DSA_new()\n self.openssl_assert(ctx != self._ffi.NULL)\n ctx = self._ffi.gc(ctx, self._lib.DSA_free)\n\n res = self._lib.DSA_generate_parameters_ex(\n ctx, key_size, self._ffi.NULL, 0,\n self._ffi.NULL, self._ffi.NULL, self._ffi.NULL\n )\n\n self.openssl_assert(res == 1)\n\n return _DSAParameters(self, ctx)\n\n def generate_dsa_private_key(self, parameters):\n ctx = self._lib.DSAparams_dup(parameters._dsa_cdata)\n self.openssl_assert(ctx != self._ffi.NULL)\n ctx = self._ffi.gc(ctx, self._lib.DSA_free)\n self._lib.DSA_generate_key(ctx)\n evp_pkey = self._dsa_cdata_to_evp_pkey(ctx)\n\n return _DSAPrivateKey(self, ctx, evp_pkey)\n\n def generate_dsa_private_key_and_parameters(self, key_size):\n parameters = self.generate_dsa_parameters(key_size)\n return self.generate_dsa_private_key(parameters)\n\n def _dsa_cdata_set_values(self, dsa_cdata, p, q, g, pub_key, priv_key):\n res = self._lib.DSA_set0_pqg(dsa_cdata, p, q, g)\n self.openssl_assert(res == 1)\n res = self._lib.DSA_set0_key(dsa_cdata, pub_key, priv_key)\n self.openssl_assert(res == 1)\n\n def load_dsa_private_numbers(self, numbers):\n dsa._check_dsa_private_numbers(numbers)\n parameter_numbers = numbers.public_numbers.parameter_numbers\n\n dsa_cdata = self._lib.DSA_new()\n self.openssl_assert(dsa_cdata != self._ffi.NULL)\n dsa_cdata = self._ffi.gc(dsa_cdata, self._lib.DSA_free)\n\n p = self._int_to_bn(parameter_numbers.p)\n q = self._int_to_bn(parameter_numbers.q)\n g = self._int_to_bn(parameter_numbers.g)\n pub_key = self._int_to_bn(numbers.public_numbers.y)\n priv_key = self._int_to_bn(numbers.x)\n self._dsa_cdata_set_values(dsa_cdata, p, q, g, pub_key, priv_key)\n\n evp_pkey = self._dsa_cdata_to_evp_pkey(dsa_cdata)\n\n return _DSAPrivateKey(self, dsa_cdata, evp_pkey)\n\n def load_dsa_public_numbers(self, numbers):\n dsa._check_dsa_parameters(numbers.parameter_numbers)\n dsa_cdata = self._lib.DSA_new()\n self.openssl_assert(dsa_cdata != self._ffi.NULL)\n dsa_cdata = self._ffi.gc(dsa_cdata, self._lib.DSA_free)\n\n p = self._int_to_bn(numbers.parameter_numbers.p)\n q = self._int_to_bn(numbers.parameter_numbers.q)\n g = self._int_to_bn(numbers.parameter_numbers.g)\n pub_key = self._int_to_bn(numbers.y)\n priv_key = self._ffi.NULL\n self._dsa_cdata_set_values(dsa_cdata, p, q, g, pub_key, priv_key)\n\n evp_pkey = self._dsa_cdata_to_evp_pkey(dsa_cdata)\n\n return _DSAPublicKey(self, dsa_cdata, evp_pkey)\n\n def load_dsa_parameter_numbers(self, numbers):\n dsa._check_dsa_parameters(numbers)\n dsa_cdata = self._lib.DSA_new()\n self.openssl_assert(dsa_cdata != self._ffi.NULL)\n dsa_cdata = self._ffi.gc(dsa_cdata, self._lib.DSA_free)\n\n p = self._int_to_bn(numbers.p)\n q = self._int_to_bn(numbers.q)\n g = self._int_to_bn(numbers.g)\n res = self._lib.DSA_set0_pqg(dsa_cdata, p, q, g)\n self.openssl_assert(res == 1)\n\n return _DSAParameters(self, dsa_cdata)\n\n def _dsa_cdata_to_evp_pkey(self, dsa_cdata):\n evp_pkey = self._create_evp_pkey_gc()\n res = self._lib.EVP_PKEY_set1_DSA(evp_pkey, dsa_cdata)\n self.openssl_assert(res == 1)\n return evp_pkey\n\n def dsa_hash_supported(self, algorithm):\n return self.hash_supported(algorithm)\n\n def dsa_parameters_supported(self, p, q, g):\n return True\n\n def cmac_algorithm_supported(self, algorithm):\n return self.cipher_supported(\n algorithm, CBC(b\"\\x00\" * algorithm.block_size)\n )\n\n def create_cmac_ctx(self, algorithm):\n return _CMACContext(self, algorithm)\n\n def create_x509_csr(self, builder, private_key, algorithm):\n if not isinstance(builder, x509.CertificateSigningRequestBuilder):\n raise TypeError('Builder type mismatch.')\n\n if isinstance(private_key,\n (ed25519.Ed25519PrivateKey, ed448.Ed448PrivateKey)):\n if algorithm is not None:\n raise ValueError(\n \"algorithm must be None when signing via ed25519 or ed448\"\n )\n elif not isinstance(algorithm, hashes.HashAlgorithm):\n raise TypeError('Algorithm must be a registered hash algorithm.')\n elif (\n isinstance(algorithm, hashes.MD5) and not\n isinstance(private_key, rsa.RSAPrivateKey)\n ):\n raise ValueError(\n \"MD5 is not a supported hash algorithm for EC/DSA CSRs\"\n )\n\n # Resolve the signature algorithm.\n evp_md = self._evp_md_x509_null_if_eddsa(private_key, algorithm)\n\n # Create an empty request.\n x509_req = self._lib.X509_REQ_new()\n self.openssl_assert(x509_req != self._ffi.NULL)\n x509_req = self._ffi.gc(x509_req, self._lib.X509_REQ_free)\n\n # Set x509 version.\n res = self._lib.X509_REQ_set_version(x509_req, x509.Version.v1.value)\n self.openssl_assert(res == 1)\n\n # Set subject name.\n res = self._lib.X509_REQ_set_subject_name(\n x509_req, _encode_name_gc(self, builder._subject_name)\n )\n self.openssl_assert(res == 1)\n\n # Set subject public key.\n public_key = private_key.public_key()\n res = self._lib.X509_REQ_set_pubkey(\n x509_req, public_key._evp_pkey\n )\n self.openssl_assert(res == 1)\n\n # Add extensions.\n sk_extension = self._lib.sk_X509_EXTENSION_new_null()\n self.openssl_assert(sk_extension != self._ffi.NULL)\n sk_extension = self._ffi.gc(\n sk_extension,\n lambda x: self._lib.sk_X509_EXTENSION_pop_free(\n x, self._ffi.addressof(\n self._lib._original_lib, \"X509_EXTENSION_free\"\n )\n )\n )\n # Don't GC individual extensions because the memory is owned by\n # sk_extensions and will be freed along with it.\n self._create_x509_extensions(\n extensions=builder._extensions,\n handlers=_EXTENSION_ENCODE_HANDLERS,\n x509_obj=sk_extension,\n add_func=self._lib.sk_X509_EXTENSION_insert,\n gc=False\n )\n res = self._lib.X509_REQ_add_extensions(x509_req, sk_extension)\n self.openssl_assert(res == 1)\n\n # Sign the request using the requester's private key.\n res = self._lib.X509_REQ_sign(\n x509_req, private_key._evp_pkey, evp_md\n )\n if res == 0:\n errors = self._consume_errors()\n self.openssl_assert(\n errors[0]._lib_reason_match(\n self._lib.ERR_LIB_RSA,\n self._lib.RSA_R_DIGEST_TOO_BIG_FOR_RSA_KEY\n )\n )\n\n raise ValueError(\"Digest too big for RSA key\")\n\n return _CertificateSigningRequest(self, x509_req)\n\n def create_x509_certificate(self, builder, private_key, algorithm):\n if not isinstance(builder, x509.CertificateBuilder):\n raise TypeError('Builder type mismatch.')\n if isinstance(private_key,\n (ed25519.Ed25519PrivateKey, ed448.Ed448PrivateKey)):\n if algorithm is not None:\n raise ValueError(\n \"algorithm must be None when signing via ed25519 or ed448\"\n )\n elif not isinstance(algorithm, hashes.HashAlgorithm):\n raise TypeError('Algorithm must be a registered hash algorithm.')\n\n if (\n isinstance(algorithm, hashes.MD5) and not\n isinstance(private_key, rsa.RSAPrivateKey)\n ):\n raise ValueError(\n \"MD5 is only (reluctantly) supported for RSA certificates\"\n )\n\n # Resolve the signature algorithm.\n evp_md = self._evp_md_x509_null_if_eddsa(private_key, algorithm)\n\n # Create an empty certificate.\n x509_cert = self._lib.X509_new()\n x509_cert = self._ffi.gc(x509_cert, backend._lib.X509_free)\n\n # Set the x509 version.\n res = self._lib.X509_set_version(x509_cert, builder._version.value)\n self.openssl_assert(res == 1)\n\n # Set the subject's name.\n res = self._lib.X509_set_subject_name(\n x509_cert, _encode_name_gc(self, builder._subject_name)\n )\n self.openssl_assert(res == 1)\n\n # Set the subject's public key.\n res = self._lib.X509_set_pubkey(\n x509_cert, builder._public_key._evp_pkey\n )\n self.openssl_assert(res == 1)\n\n # Set the certificate serial number.\n serial_number = _encode_asn1_int_gc(self, builder._serial_number)\n res = self._lib.X509_set_serialNumber(x509_cert, serial_number)\n self.openssl_assert(res == 1)\n\n # Set the \"not before\" time.\n self._set_asn1_time(\n self._lib.X509_getm_notBefore(x509_cert), builder._not_valid_before\n )\n\n # Set the \"not after\" time.\n self._set_asn1_time(\n self._lib.X509_getm_notAfter(x509_cert), builder._not_valid_after\n )\n\n # Add extensions.\n self._create_x509_extensions(\n extensions=builder._extensions,\n handlers=_EXTENSION_ENCODE_HANDLERS,\n x509_obj=x509_cert,\n add_func=self._lib.X509_add_ext,\n gc=True\n )\n\n # Set the issuer name.\n res = self._lib.X509_set_issuer_name(\n x509_cert, _encode_name_gc(self, builder._issuer_name)\n )\n self.openssl_assert(res == 1)\n\n # Sign the certificate with the issuer's private key.\n res = self._lib.X509_sign(\n x509_cert, private_key._evp_pkey, evp_md\n )\n if res == 0:\n errors = self._consume_errors()\n self.openssl_assert(\n errors[0]._lib_reason_match(\n self._lib.ERR_LIB_RSA,\n self._lib.RSA_R_DIGEST_TOO_BIG_FOR_RSA_KEY\n )\n )\n raise ValueError(\"Digest too big for RSA key\")\n\n return _Certificate(self, x509_cert)\n\n def _evp_md_x509_null_if_eddsa(self, private_key, algorithm):\n if isinstance(private_key,\n (ed25519.Ed25519PrivateKey, ed448.Ed448PrivateKey)):\n # OpenSSL requires us to pass NULL for EVP_MD for ed25519/ed448\n return self._ffi.NULL\n else:\n return self._evp_md_non_null_from_algorithm(algorithm)\n\n def _set_asn1_time(self, asn1_time, time):\n if time.year >= 2050:\n asn1_str = time.strftime('%Y%m%d%H%M%SZ').encode('ascii')\n else:\n asn1_str = time.strftime('%y%m%d%H%M%SZ').encode('ascii')\n res = self._lib.ASN1_TIME_set_string(asn1_time, asn1_str)\n self.openssl_assert(res == 1)\n\n def _create_asn1_time(self, time):\n asn1_time = self._lib.ASN1_TIME_new()\n self.openssl_assert(asn1_time != self._ffi.NULL)\n asn1_time = self._ffi.gc(asn1_time, self._lib.ASN1_TIME_free)\n self._set_asn1_time(asn1_time, time)\n return asn1_time\n\n def create_x509_crl(self, builder, private_key, algorithm):\n if not isinstance(builder, x509.CertificateRevocationListBuilder):\n raise TypeError('Builder type mismatch.')\n if isinstance(private_key,\n (ed25519.Ed25519PrivateKey, ed448.Ed448PrivateKey)):\n if algorithm is not None:\n raise ValueError(\n \"algorithm must be None when signing via ed25519 or ed448\"\n )\n elif not isinstance(algorithm, hashes.HashAlgorithm):\n raise TypeError('Algorithm must be a registered hash algorithm.')\n\n if (\n isinstance(algorithm, hashes.MD5) and not\n isinstance(private_key, rsa.RSAPrivateKey)\n ):\n raise ValueError(\n \"MD5 is not a supported hash algorithm for EC/DSA CRLs\"\n )\n\n evp_md = self._evp_md_x509_null_if_eddsa(private_key, algorithm)\n\n # Create an empty CRL.\n x509_crl = self._lib.X509_CRL_new()\n x509_crl = self._ffi.gc(x509_crl, backend._lib.X509_CRL_free)\n\n # Set the x509 CRL version. We only support v2 (integer value 1).\n res = self._lib.X509_CRL_set_version(x509_crl, 1)\n self.openssl_assert(res == 1)\n\n # Set the issuer name.\n res = self._lib.X509_CRL_set_issuer_name(\n x509_crl, _encode_name_gc(self, builder._issuer_name)\n )\n self.openssl_assert(res == 1)\n\n # Set the last update time.\n last_update = self._create_asn1_time(builder._last_update)\n res = self._lib.X509_CRL_set_lastUpdate(x509_crl, last_update)\n self.openssl_assert(res == 1)\n\n # Set the next update time.\n next_update = self._create_asn1_time(builder._next_update)\n res = self._lib.X509_CRL_set_nextUpdate(x509_crl, next_update)\n self.openssl_assert(res == 1)\n\n # Add extensions.\n self._create_x509_extensions(\n extensions=builder._extensions,\n handlers=_CRL_EXTENSION_ENCODE_HANDLERS,\n x509_obj=x509_crl,\n add_func=self._lib.X509_CRL_add_ext,\n gc=True\n )\n\n # add revoked certificates\n for revoked_cert in builder._revoked_certificates:\n # Duplicating because the X509_CRL takes ownership and will free\n # this memory when X509_CRL_free is called.\n revoked = self._lib.Cryptography_X509_REVOKED_dup(\n revoked_cert._x509_revoked\n )\n self.openssl_assert(revoked != self._ffi.NULL)\n res = self._lib.X509_CRL_add0_revoked(x509_crl, revoked)\n self.openssl_assert(res == 1)\n\n res = self._lib.X509_CRL_sign(\n x509_crl, private_key._evp_pkey, evp_md\n )\n if res == 0:\n errors = self._consume_errors()\n self.openssl_assert(\n errors[0]._lib_reason_match(\n self._lib.ERR_LIB_RSA,\n self._lib.RSA_R_DIGEST_TOO_BIG_FOR_RSA_KEY\n )\n )\n raise ValueError(\"Digest too big for RSA key\")\n\n return _CertificateRevocationList(self, x509_crl)\n\n def _create_x509_extensions(self, extensions, handlers, x509_obj,\n add_func, gc):\n for i, extension in enumerate(extensions):\n x509_extension = self._create_x509_extension(\n handlers, extension\n )\n self.openssl_assert(x509_extension != self._ffi.NULL)\n\n if gc:\n x509_extension = self._ffi.gc(\n x509_extension, self._lib.X509_EXTENSION_free\n )\n res = add_func(x509_obj, x509_extension, i)\n self.openssl_assert(res >= 1)\n\n def _create_raw_x509_extension(self, extension, value):\n obj = _txt2obj_gc(self, extension.oid.dotted_string)\n return self._lib.X509_EXTENSION_create_by_OBJ(\n self._ffi.NULL, obj, 1 if extension.critical else 0, value\n )\n\n def _create_x509_extension(self, handlers, extension):\n if isinstance(extension.value, x509.UnrecognizedExtension):\n value = _encode_asn1_str_gc(self, extension.value.value)\n return self._create_raw_x509_extension(extension, value)\n elif isinstance(extension.value, x509.TLSFeature):\n asn1 = encode_der(\n SEQUENCE,\n *[\n encode_der(INTEGER, encode_der_integer(x.value))\n for x in extension.value\n ]\n )\n value = _encode_asn1_str_gc(self, asn1)\n return self._create_raw_x509_extension(extension, value)\n elif isinstance(extension.value, x509.PrecertPoison):\n value = _encode_asn1_str_gc(self, encode_der(NULL))\n return self._create_raw_x509_extension(extension, value)\n else:\n try:\n encode = handlers[extension.oid]\n except KeyError:\n raise NotImplementedError(\n 'Extension not supported: {}'.format(extension.oid)\n )\n\n ext_struct = encode(self, extension.value)\n nid = self._lib.OBJ_txt2nid(\n extension.oid.dotted_string.encode(\"ascii\")\n )\n backend.openssl_assert(nid != self._lib.NID_undef)\n return self._lib.X509V3_EXT_i2d(\n nid, 1 if extension.critical else 0, ext_struct\n )\n\n def create_x509_revoked_certificate(self, builder):\n if not isinstance(builder, x509.RevokedCertificateBuilder):\n raise TypeError('Builder type mismatch.')\n\n x509_revoked = self._lib.X509_REVOKED_new()\n self.openssl_assert(x509_revoked != self._ffi.NULL)\n x509_revoked = self._ffi.gc(x509_revoked, self._lib.X509_REVOKED_free)\n serial_number = _encode_asn1_int_gc(self, builder._serial_number)\n res = self._lib.X509_REVOKED_set_serialNumber(\n x509_revoked, serial_number\n )\n self.openssl_assert(res == 1)\n rev_date = self._create_asn1_time(builder._revocation_date)\n res = self._lib.X509_REVOKED_set_revocationDate(x509_revoked, rev_date)\n self.openssl_assert(res == 1)\n # add CRL entry extensions\n self._create_x509_extensions(\n extensions=builder._extensions,\n handlers=_CRL_ENTRY_EXTENSION_ENCODE_HANDLERS,\n x509_obj=x509_revoked,\n add_func=self._lib.X509_REVOKED_add_ext,\n gc=True\n )\n return _RevokedCertificate(self, None, x509_revoked)\n\n def load_pem_private_key(self, data, password):\n return self._load_key(\n self._lib.PEM_read_bio_PrivateKey,\n self._evp_pkey_to_private_key,\n data,\n password,\n )\n\n def load_pem_public_key(self, data):\n mem_bio = self._bytes_to_bio(data)\n evp_pkey = self._lib.PEM_read_bio_PUBKEY(\n mem_bio.bio, self._ffi.NULL, self._ffi.NULL, self._ffi.NULL\n )\n if evp_pkey != self._ffi.NULL:\n evp_pkey = self._ffi.gc(evp_pkey, self._lib.EVP_PKEY_free)\n return self._evp_pkey_to_public_key(evp_pkey)\n else:\n # It's not a (RSA/DSA/ECDSA) subjectPublicKeyInfo, but we still\n # need to check to see if it is a pure PKCS1 RSA public key (not\n # embedded in a subjectPublicKeyInfo)\n self._consume_errors()\n res = self._lib.BIO_reset(mem_bio.bio)\n self.openssl_assert(res == 1)\n rsa_cdata = self._lib.PEM_read_bio_RSAPublicKey(\n mem_bio.bio, self._ffi.NULL, self._ffi.NULL, self._ffi.NULL\n )\n if rsa_cdata != self._ffi.NULL:\n rsa_cdata = self._ffi.gc(rsa_cdata, self._lib.RSA_free)\n evp_pkey = self._rsa_cdata_to_evp_pkey(rsa_cdata)\n return _RSAPublicKey(self, rsa_cdata, evp_pkey)\n else:\n self._handle_key_loading_error()\n\n def load_pem_parameters(self, data):\n mem_bio = self._bytes_to_bio(data)\n # only DH is supported currently\n dh_cdata = self._lib.PEM_read_bio_DHparams(\n mem_bio.bio, self._ffi.NULL, self._ffi.NULL, self._ffi.NULL)\n if dh_cdata != self._ffi.NULL:\n dh_cdata = self._ffi.gc(dh_cdata, self._lib.DH_free)\n return _DHParameters(self, dh_cdata)\n else:\n self._handle_key_loading_error()\n\n def load_der_private_key(self, data, password):\n # OpenSSL has a function called d2i_AutoPrivateKey that in theory\n # handles this automatically, however it doesn't handle encrypted\n # private keys. Instead we try to load the key two different ways.\n # First we'll try to load it as a traditional key.\n bio_data = self._bytes_to_bio(data)\n key = self._evp_pkey_from_der_traditional_key(bio_data, password)\n if key:\n return self._evp_pkey_to_private_key(key)\n else:\n # Finally we try to load it with the method that handles encrypted\n # PKCS8 properly.\n return self._load_key(\n self._lib.d2i_PKCS8PrivateKey_bio,\n self._evp_pkey_to_private_key,\n data,\n password,\n )\n\n def _evp_pkey_from_der_traditional_key(self, bio_data, password):\n key = self._lib.d2i_PrivateKey_bio(bio_data.bio, self._ffi.NULL)\n if key != self._ffi.NULL:\n key = self._ffi.gc(key, self._lib.EVP_PKEY_free)\n if password is not None:\n raise TypeError(\n \"Password was given but private key is not encrypted.\"\n )\n\n return key\n else:\n self._consume_errors()\n return None\n\n def load_der_public_key(self, data):\n mem_bio = self._bytes_to_bio(data)\n evp_pkey = self._lib.d2i_PUBKEY_bio(mem_bio.bio, self._ffi.NULL)\n if evp_pkey != self._ffi.NULL:\n evp_pkey = self._ffi.gc(evp_pkey, self._lib.EVP_PKEY_free)\n return self._evp_pkey_to_public_key(evp_pkey)\n else:\n # It's not a (RSA/DSA/ECDSA) subjectPublicKeyInfo, but we still\n # need to check to see if it is a pure PKCS1 RSA public key (not\n # embedded in a subjectPublicKeyInfo)\n self._consume_errors()\n res = self._lib.BIO_reset(mem_bio.bio)\n self.openssl_assert(res == 1)\n rsa_cdata = self._lib.d2i_RSAPublicKey_bio(\n mem_bio.bio, self._ffi.NULL\n )\n if rsa_cdata != self._ffi.NULL:\n rsa_cdata = self._ffi.gc(rsa_cdata, self._lib.RSA_free)\n evp_pkey = self._rsa_cdata_to_evp_pkey(rsa_cdata)\n return _RSAPublicKey(self, rsa_cdata, evp_pkey)\n else:\n self._handle_key_loading_error()\n\n def load_der_parameters(self, data):\n mem_bio = self._bytes_to_bio(data)\n dh_cdata = self._lib.d2i_DHparams_bio(\n mem_bio.bio, self._ffi.NULL\n )\n if dh_cdata != self._ffi.NULL:\n dh_cdata = self._ffi.gc(dh_cdata, self._lib.DH_free)\n return _DHParameters(self, dh_cdata)\n elif self._lib.Cryptography_HAS_EVP_PKEY_DHX:\n # We check to see if the is dhx.\n self._consume_errors()\n res = self._lib.BIO_reset(mem_bio.bio)\n self.openssl_assert(res == 1)\n dh_cdata = self._lib.Cryptography_d2i_DHxparams_bio(\n mem_bio.bio, self._ffi.NULL\n )\n if dh_cdata != self._ffi.NULL:\n dh_cdata = self._ffi.gc(dh_cdata, self._lib.DH_free)\n return _DHParameters(self, dh_cdata)\n\n self._handle_key_loading_error()\n\n def load_pem_x509_certificate(self, data):\n mem_bio = self._bytes_to_bio(data)\n x509 = self._lib.PEM_read_bio_X509(\n mem_bio.bio, self._ffi.NULL, self._ffi.NULL, self._ffi.NULL\n )\n if x509 == self._ffi.NULL:\n self._consume_errors()\n raise ValueError(\n \"Unable to load certificate. See https://cryptography.io/en/la\"\n \"test/faq/#why-can-t-i-import-my-pem-file for more details.\"\n )\n\n x509 = self._ffi.gc(x509, self._lib.X509_free)\n return _Certificate(self, x509)\n\n def load_der_x509_certificate(self, data):\n mem_bio = self._bytes_to_bio(data)\n x509 = self._lib.d2i_X509_bio(mem_bio.bio, self._ffi.NULL)\n if x509 == self._ffi.NULL:\n self._consume_errors()\n raise ValueError(\"Unable to load certificate\")\n\n x509 = self._ffi.gc(x509, self._lib.X509_free)\n return _Certificate(self, x509)\n\n def load_pem_x509_crl(self, data):\n mem_bio = self._bytes_to_bio(data)\n x509_crl = self._lib.PEM_read_bio_X509_CRL(\n mem_bio.bio, self._ffi.NULL, self._ffi.NULL, self._ffi.NULL\n )\n if x509_crl == self._ffi.NULL:\n self._consume_errors()\n raise ValueError(\n \"Unable to load CRL. See https://cryptography.io/en/la\"\n \"test/faq/#why-can-t-i-import-my-pem-file for more details.\"\n )\n\n x509_crl = self._ffi.gc(x509_crl, self._lib.X509_CRL_free)\n return _CertificateRevocationList(self, x509_crl)\n\n def load_der_x509_crl(self, data):\n mem_bio = self._bytes_to_bio(data)\n x509_crl = self._lib.d2i_X509_CRL_bio(mem_bio.bio, self._ffi.NULL)\n if x509_crl == self._ffi.NULL:\n self._consume_errors()\n raise ValueError(\"Unable to load CRL\")\n\n x509_crl = self._ffi.gc(x509_crl, self._lib.X509_CRL_free)\n return _CertificateRevocationList(self, x509_crl)\n\n def load_pem_x509_csr(self, data):\n mem_bio = self._bytes_to_bio(data)\n x509_req = self._lib.PEM_read_bio_X509_REQ(\n mem_bio.bio, self._ffi.NULL, self._ffi.NULL, self._ffi.NULL\n )\n if x509_req == self._ffi.NULL:\n self._consume_errors()\n raise ValueError(\n \"Unable to load request. See https://cryptography.io/en/la\"\n \"test/faq/#why-can-t-i-import-my-pem-file for more details.\"\n )\n\n x509_req = self._ffi.gc(x509_req, self._lib.X509_REQ_free)\n return _CertificateSigningRequest(self, x509_req)\n\n def load_der_x509_csr(self, data):\n mem_bio = self._bytes_to_bio(data)\n x509_req = self._lib.d2i_X509_REQ_bio(mem_bio.bio, self._ffi.NULL)\n if x509_req == self._ffi.NULL:\n self._consume_errors()\n raise ValueError(\"Unable to load request\")\n\n x509_req = self._ffi.gc(x509_req, self._lib.X509_REQ_free)\n return _CertificateSigningRequest(self, x509_req)\n\n def _load_key(self, openssl_read_func, convert_func, data, password):\n mem_bio = self._bytes_to_bio(data)\n\n userdata = self._ffi.new(\"CRYPTOGRAPHY_PASSWORD_DATA *\")\n if password is not None:\n utils._check_byteslike(\"password\", password)\n password_ptr = self._ffi.from_buffer(password)\n userdata.password = password_ptr\n userdata.length = len(password)\n\n evp_pkey = openssl_read_func(\n mem_bio.bio,\n self._ffi.NULL,\n self._ffi.addressof(\n self._lib._original_lib, \"Cryptography_pem_password_cb\"\n ),\n userdata,\n )\n\n if evp_pkey == self._ffi.NULL:\n if userdata.error != 0:\n errors = self._consume_errors()\n self.openssl_assert(errors)\n if userdata.error == -1:\n raise TypeError(\n \"Password was not given but private key is encrypted\"\n )\n else:\n assert userdata.error == -2\n raise ValueError(\n \"Passwords longer than {} bytes are not supported \"\n \"by this backend.\".format(userdata.maxsize - 1)\n )\n else:\n self._handle_key_loading_error()\n\n evp_pkey = self._ffi.gc(evp_pkey, self._lib.EVP_PKEY_free)\n\n if password is not None and userdata.called == 0:\n raise TypeError(\n \"Password was given but private key is not encrypted.\")\n\n assert (\n (password is not None and userdata.called == 1) or\n password is None\n )\n\n return convert_func(evp_pkey)\n\n def _handle_key_loading_error(self):\n errors = self._consume_errors()\n\n if not errors:\n raise ValueError(\"Could not deserialize key data.\")\n\n elif (\n errors[0]._lib_reason_match(\n self._lib.ERR_LIB_EVP, self._lib.EVP_R_BAD_DECRYPT\n ) or errors[0]._lib_reason_match(\n self._lib.ERR_LIB_PKCS12,\n self._lib.PKCS12_R_PKCS12_CIPHERFINAL_ERROR\n )\n ):\n raise ValueError(\"Bad decrypt. Incorrect password?\")\n\n elif (\n errors[0]._lib_reason_match(\n self._lib.ERR_LIB_EVP, self._lib.EVP_R_UNKNOWN_PBE_ALGORITHM\n ) or errors[0]._lib_reason_match(\n self._lib.ERR_LIB_PEM, self._lib.PEM_R_UNSUPPORTED_ENCRYPTION\n )\n ):\n raise UnsupportedAlgorithm(\n \"PEM data is encrypted with an unsupported cipher\",\n _Reasons.UNSUPPORTED_CIPHER\n )\n\n elif any(\n error._lib_reason_match(\n self._lib.ERR_LIB_EVP,\n self._lib.EVP_R_UNSUPPORTED_PRIVATE_KEY_ALGORITHM\n )\n for error in errors\n ):\n raise ValueError(\"Unsupported public key algorithm.\")\n\n else:\n assert errors[0].lib in (\n self._lib.ERR_LIB_EVP,\n self._lib.ERR_LIB_PEM,\n self._lib.ERR_LIB_ASN1,\n )\n raise ValueError(\"Could not deserialize key data.\")\n\n def elliptic_curve_supported(self, curve):\n try:\n curve_nid = self._elliptic_curve_to_nid(curve)\n except UnsupportedAlgorithm:\n curve_nid = self._lib.NID_undef\n\n group = self._lib.EC_GROUP_new_by_curve_name(curve_nid)\n\n if group == self._ffi.NULL:\n errors = self._consume_errors()\n self.openssl_assert(\n curve_nid == self._lib.NID_undef or\n errors[0]._lib_reason_match(\n self._lib.ERR_LIB_EC,\n self._lib.EC_R_UNKNOWN_GROUP\n )\n )\n return False\n else:\n self.openssl_assert(curve_nid != self._lib.NID_undef)\n self._lib.EC_GROUP_free(group)\n return True\n\n def elliptic_curve_signature_algorithm_supported(\n self, signature_algorithm, curve\n ):\n # We only support ECDSA right now.\n if not isinstance(signature_algorithm, ec.ECDSA):\n return False\n\n return self.elliptic_curve_supported(curve)\n\n def generate_elliptic_curve_private_key(self, curve):\n \"\"\"\n Generate a new private key on the named curve.\n \"\"\"\n\n if self.elliptic_curve_supported(curve):\n ec_cdata = self._ec_key_new_by_curve(curve)\n\n res = self._lib.EC_KEY_generate_key(ec_cdata)\n self.openssl_assert(res == 1)\n\n evp_pkey = self._ec_cdata_to_evp_pkey(ec_cdata)\n\n return _EllipticCurvePrivateKey(self, ec_cdata, evp_pkey)\n else:\n raise UnsupportedAlgorithm(\n \"Backend object does not support {}.\".format(curve.name),\n _Reasons.UNSUPPORTED_ELLIPTIC_CURVE\n )\n\n def load_elliptic_curve_private_numbers(self, numbers):\n public = numbers.public_numbers\n\n ec_cdata = self._ec_key_new_by_curve(public.curve)\n\n private_value = self._ffi.gc(\n self._int_to_bn(numbers.private_value), self._lib.BN_clear_free\n )\n res = self._lib.EC_KEY_set_private_key(ec_cdata, private_value)\n self.openssl_assert(res == 1)\n\n ec_cdata = self._ec_key_set_public_key_affine_coordinates(\n ec_cdata, public.x, public.y)\n\n evp_pkey = self._ec_cdata_to_evp_pkey(ec_cdata)\n\n return _EllipticCurvePrivateKey(self, ec_cdata, evp_pkey)\n\n def load_elliptic_curve_public_numbers(self, numbers):\n ec_cdata = self._ec_key_new_by_curve(numbers.curve)\n ec_cdata = self._ec_key_set_public_key_affine_coordinates(\n ec_cdata, numbers.x, numbers.y)\n evp_pkey = self._ec_cdata_to_evp_pkey(ec_cdata)\n\n return _EllipticCurvePublicKey(self, ec_cdata, evp_pkey)\n\n def load_elliptic_curve_public_bytes(self, curve, point_bytes):\n ec_cdata = self._ec_key_new_by_curve(curve)\n group = self._lib.EC_KEY_get0_group(ec_cdata)\n self.openssl_assert(group != self._ffi.NULL)\n point = self._lib.EC_POINT_new(group)\n self.openssl_assert(point != self._ffi.NULL)\n point = self._ffi.gc(point, self._lib.EC_POINT_free)\n with self._tmp_bn_ctx() as bn_ctx:\n res = self._lib.EC_POINT_oct2point(\n group, point, point_bytes, len(point_bytes), bn_ctx\n )\n if res != 1:\n self._consume_errors()\n raise ValueError(\"Invalid public bytes for the given curve\")\n\n res = self._lib.EC_KEY_set_public_key(ec_cdata, point)\n self.openssl_assert(res == 1)\n evp_pkey = self._ec_cdata_to_evp_pkey(ec_cdata)\n return _EllipticCurvePublicKey(self, ec_cdata, evp_pkey)\n\n def derive_elliptic_curve_private_key(self, private_value, curve):\n ec_cdata = self._ec_key_new_by_curve(curve)\n\n get_func, group = self._ec_key_determine_group_get_func(ec_cdata)\n\n point = self._lib.EC_POINT_new(group)\n self.openssl_assert(point != self._ffi.NULL)\n point = self._ffi.gc(point, self._lib.EC_POINT_free)\n\n value = self._int_to_bn(private_value)\n value = self._ffi.gc(value, self._lib.BN_clear_free)\n\n with self._tmp_bn_ctx() as bn_ctx:\n res = self._lib.EC_POINT_mul(group, point, value, self._ffi.NULL,\n self._ffi.NULL, bn_ctx)\n self.openssl_assert(res == 1)\n\n bn_x = self._lib.BN_CTX_get(bn_ctx)\n bn_y = self._lib.BN_CTX_get(bn_ctx)\n\n res = get_func(group, point, bn_x, bn_y, bn_ctx)\n self.openssl_assert(res == 1)\n\n res = self._lib.EC_KEY_set_public_key(ec_cdata, point)\n self.openssl_assert(res == 1)\n private = self._int_to_bn(private_value)\n private = self._ffi.gc(private, self._lib.BN_clear_free)\n res = self._lib.EC_KEY_set_private_key(ec_cdata, private)\n self.openssl_assert(res == 1)\n\n evp_pkey = self._ec_cdata_to_evp_pkey(ec_cdata)\n\n return _EllipticCurvePrivateKey(self, ec_cdata, evp_pkey)\n\n def _ec_key_new_by_curve(self, curve):\n curve_nid = self._elliptic_curve_to_nid(curve)\n ec_cdata = self._lib.EC_KEY_new_by_curve_name(curve_nid)\n self.openssl_assert(ec_cdata != self._ffi.NULL)\n return self._ffi.gc(ec_cdata, self._lib.EC_KEY_free)\n\n def load_der_ocsp_request(self, data):\n mem_bio = self._bytes_to_bio(data)\n request = self._lib.d2i_OCSP_REQUEST_bio(mem_bio.bio, self._ffi.NULL)\n if request == self._ffi.NULL:\n self._consume_errors()\n raise ValueError(\"Unable to load OCSP request\")\n\n request = self._ffi.gc(request, self._lib.OCSP_REQUEST_free)\n return _OCSPRequest(self, request)\n\n def load_der_ocsp_response(self, data):\n mem_bio = self._bytes_to_bio(data)\n response = self._lib.d2i_OCSP_RESPONSE_bio(mem_bio.bio, self._ffi.NULL)\n if response == self._ffi.NULL:\n self._consume_errors()\n raise ValueError(\"Unable to load OCSP response\")\n\n response = self._ffi.gc(response, self._lib.OCSP_RESPONSE_free)\n return _OCSPResponse(self, response)\n\n def create_ocsp_request(self, builder):\n ocsp_req = self._lib.OCSP_REQUEST_new()\n self.openssl_assert(ocsp_req != self._ffi.NULL)\n ocsp_req = self._ffi.gc(ocsp_req, self._lib.OCSP_REQUEST_free)\n cert, issuer, algorithm = builder._request\n evp_md = self._evp_md_non_null_from_algorithm(algorithm)\n certid = self._lib.OCSP_cert_to_id(\n evp_md, cert._x509, issuer._x509\n )\n self.openssl_assert(certid != self._ffi.NULL)\n onereq = self._lib.OCSP_request_add0_id(ocsp_req, certid)\n self.openssl_assert(onereq != self._ffi.NULL)\n self._create_x509_extensions(\n extensions=builder._extensions,\n handlers=_OCSP_REQUEST_EXTENSION_ENCODE_HANDLERS,\n x509_obj=ocsp_req,\n add_func=self._lib.OCSP_REQUEST_add_ext,\n gc=True,\n )\n return _OCSPRequest(self, ocsp_req)\n\n def _create_ocsp_basic_response(self, builder, private_key, algorithm):\n basic = self._lib.OCSP_BASICRESP_new()\n self.openssl_assert(basic != self._ffi.NULL)\n basic = self._ffi.gc(basic, self._lib.OCSP_BASICRESP_free)\n evp_md = self._evp_md_non_null_from_algorithm(\n builder._response._algorithm\n )\n certid = self._lib.OCSP_cert_to_id(\n evp_md, builder._response._cert._x509,\n builder._response._issuer._x509\n )\n self.openssl_assert(certid != self._ffi.NULL)\n certid = self._ffi.gc(certid, self._lib.OCSP_CERTID_free)\n if builder._response._revocation_reason is None:\n reason = -1\n else:\n reason = _CRL_ENTRY_REASON_ENUM_TO_CODE[\n builder._response._revocation_reason\n ]\n if builder._response._revocation_time is None:\n rev_time = self._ffi.NULL\n else:\n rev_time = self._create_asn1_time(\n builder._response._revocation_time\n )\n\n next_update = self._ffi.NULL\n if builder._response._next_update is not None:\n next_update = self._create_asn1_time(\n builder._response._next_update\n )\n\n this_update = self._create_asn1_time(builder._response._this_update)\n\n res = self._lib.OCSP_basic_add1_status(\n basic,\n certid,\n builder._response._cert_status.value,\n reason,\n rev_time,\n this_update,\n next_update\n )\n self.openssl_assert(res != self._ffi.NULL)\n # okay, now sign the basic structure\n evp_md = self._evp_md_x509_null_if_eddsa(private_key, algorithm)\n responder_cert, responder_encoding = builder._responder_id\n flags = self._lib.OCSP_NOCERTS\n if responder_encoding is ocsp.OCSPResponderEncoding.HASH:\n flags |= self._lib.OCSP_RESPID_KEY\n\n if builder._certs is not None:\n for cert in builder._certs:\n res = self._lib.OCSP_basic_add1_cert(basic, cert._x509)\n self.openssl_assert(res == 1)\n\n self._create_x509_extensions(\n extensions=builder._extensions,\n handlers=_OCSP_BASICRESP_EXTENSION_ENCODE_HANDLERS,\n x509_obj=basic,\n add_func=self._lib.OCSP_BASICRESP_add_ext,\n gc=True,\n )\n\n res = self._lib.OCSP_basic_sign(\n basic, responder_cert._x509, private_key._evp_pkey,\n evp_md, self._ffi.NULL, flags\n )\n if res != 1:\n errors = self._consume_errors()\n self.openssl_assert(\n errors[0]._lib_reason_match(\n self._lib.ERR_LIB_X509,\n self._lib.X509_R_KEY_VALUES_MISMATCH\n )\n )\n raise ValueError(\"responder_cert must be signed by private_key\")\n\n return basic\n\n def create_ocsp_response(self, response_status, builder, private_key,\n algorithm):\n if response_status is ocsp.OCSPResponseStatus.SUCCESSFUL:\n basic = self._create_ocsp_basic_response(\n builder, private_key, algorithm\n )\n else:\n basic = self._ffi.NULL\n\n ocsp_resp = self._lib.OCSP_response_create(\n response_status.value, basic\n )\n self.openssl_assert(ocsp_resp != self._ffi.NULL)\n ocsp_resp = self._ffi.gc(ocsp_resp, self._lib.OCSP_RESPONSE_free)\n return _OCSPResponse(self, ocsp_resp)\n\n def elliptic_curve_exchange_algorithm_supported(self, algorithm, curve):\n return (\n self.elliptic_curve_supported(curve) and\n isinstance(algorithm, ec.ECDH)\n )\n\n def _ec_cdata_to_evp_pkey(self, ec_cdata):\n evp_pkey = self._create_evp_pkey_gc()\n res = self._lib.EVP_PKEY_set1_EC_KEY(evp_pkey, ec_cdata)\n self.openssl_assert(res == 1)\n return evp_pkey\n\n def _elliptic_curve_to_nid(self, curve):\n \"\"\"\n Get the NID for a curve name.\n \"\"\"\n\n curve_aliases = {\n \"secp192r1\": \"prime192v1\",\n \"secp256r1\": \"prime256v1\"\n }\n\n curve_name = curve_aliases.get(curve.name, curve.name)\n\n curve_nid = self._lib.OBJ_sn2nid(curve_name.encode())\n if curve_nid == self._lib.NID_undef:\n raise UnsupportedAlgorithm(\n \"{} is not a supported elliptic curve\".format(curve.name),\n _Reasons.UNSUPPORTED_ELLIPTIC_CURVE\n )\n return curve_nid\n\n @contextmanager\n def _tmp_bn_ctx(self):\n bn_ctx = self._lib.BN_CTX_new()\n self.openssl_assert(bn_ctx != self._ffi.NULL)\n bn_ctx = self._ffi.gc(bn_ctx, self._lib.BN_CTX_free)\n self._lib.BN_CTX_start(bn_ctx)\n try:\n yield bn_ctx\n finally:\n self._lib.BN_CTX_end(bn_ctx)\n\n def _ec_key_determine_group_get_func(self, ctx):\n \"\"\"\n Given an EC_KEY determine the group and what function is required to\n get point coordinates.\n \"\"\"\n self.openssl_assert(ctx != self._ffi.NULL)\n\n nid_two_field = self._lib.OBJ_sn2nid(b\"characteristic-two-field\")\n self.openssl_assert(nid_two_field != self._lib.NID_undef)\n\n group = self._lib.EC_KEY_get0_group(ctx)\n self.openssl_assert(group != self._ffi.NULL)\n\n method = self._lib.EC_GROUP_method_of(group)\n self.openssl_assert(method != self._ffi.NULL)\n\n nid = self._lib.EC_METHOD_get_field_type(method)\n self.openssl_assert(nid != self._lib.NID_undef)\n\n if nid == nid_two_field and self._lib.Cryptography_HAS_EC2M:\n get_func = self._lib.EC_POINT_get_affine_coordinates_GF2m\n else:\n get_func = self._lib.EC_POINT_get_affine_coordinates_GFp\n\n assert get_func\n\n return get_func, group\n\n def _ec_key_set_public_key_affine_coordinates(self, ctx, x, y):\n \"\"\"\n Sets the public key point in the EC_KEY context to the affine x and y\n values.\n \"\"\"\n\n if x < 0 or y < 0:\n raise ValueError(\n \"Invalid EC key. Both x and y must be non-negative.\"\n )\n\n x = self._ffi.gc(self._int_to_bn(x), self._lib.BN_free)\n y = self._ffi.gc(self._int_to_bn(y), self._lib.BN_free)\n res = self._lib.EC_KEY_set_public_key_affine_coordinates(ctx, x, y)\n if res != 1:\n self._consume_errors()\n raise ValueError(\"Invalid EC key.\")\n\n return ctx\n\n def _private_key_bytes(self, encoding, format, encryption_algorithm,\n evp_pkey, cdata):\n if not isinstance(format, serialization.PrivateFormat):\n raise TypeError(\n \"format must be an item from the PrivateFormat enum\"\n )\n\n # X9.62 encoding is only valid for EC public keys\n if encoding is serialization.Encoding.X962:\n raise ValueError(\"X9.62 format is only valid for EC public keys\")\n\n # Raw format and encoding are only valid for X25519, Ed25519, X448, and\n # Ed448 keys. We capture those cases before this method is called so if\n # we see those enum values here it means the caller has passed them to\n # a key that doesn't support raw type\n if format is serialization.PrivateFormat.Raw:\n raise ValueError(\"raw format is invalid with this key or encoding\")\n\n if encoding is serialization.Encoding.Raw:\n raise ValueError(\"raw encoding is invalid with this key or format\")\n\n if not isinstance(encryption_algorithm,\n serialization.KeySerializationEncryption):\n raise TypeError(\n \"Encryption algorithm must be a KeySerializationEncryption \"\n \"instance\"\n )\n\n if isinstance(encryption_algorithm, serialization.NoEncryption):\n password = b\"\"\n passlen = 0\n evp_cipher = self._ffi.NULL\n elif isinstance(encryption_algorithm,\n serialization.BestAvailableEncryption):\n # This is a curated value that we will update over time.\n evp_cipher = self._lib.EVP_get_cipherbyname(\n b\"aes-256-cbc\"\n )\n password = encryption_algorithm.password\n passlen = len(password)\n if passlen > 1023:\n raise ValueError(\n \"Passwords longer than 1023 bytes are not supported by \"\n \"this backend\"\n )\n else:\n raise ValueError(\"Unsupported encryption type\")\n\n key_type = self._lib.EVP_PKEY_id(evp_pkey)\n if encoding is serialization.Encoding.PEM:\n if format is serialization.PrivateFormat.PKCS8:\n write_bio = self._lib.PEM_write_bio_PKCS8PrivateKey\n key = evp_pkey\n else:\n assert format is serialization.PrivateFormat.TraditionalOpenSSL\n if key_type == self._lib.EVP_PKEY_RSA:\n write_bio = self._lib.PEM_write_bio_RSAPrivateKey\n elif key_type == self._lib.EVP_PKEY_DSA:\n write_bio = self._lib.PEM_write_bio_DSAPrivateKey\n else:\n assert key_type == self._lib.EVP_PKEY_EC\n write_bio = self._lib.PEM_write_bio_ECPrivateKey\n\n key = cdata\n elif encoding is serialization.Encoding.DER:\n if format is serialization.PrivateFormat.TraditionalOpenSSL:\n if not isinstance(\n encryption_algorithm, serialization.NoEncryption\n ):\n raise ValueError(\n \"Encryption is not supported for DER encoded \"\n \"traditional OpenSSL keys\"\n )\n\n return self._private_key_bytes_traditional_der(key_type, cdata)\n else:\n assert format is serialization.PrivateFormat.PKCS8\n write_bio = self._lib.i2d_PKCS8PrivateKey_bio\n key = evp_pkey\n else:\n raise TypeError(\"encoding must be Encoding.PEM or Encoding.DER\")\n\n bio = self._create_mem_bio_gc()\n res = write_bio(\n bio,\n key,\n evp_cipher,\n password,\n passlen,\n self._ffi.NULL,\n self._ffi.NULL\n )\n self.openssl_assert(res == 1)\n return self._read_mem_bio(bio)\n\n def _private_key_bytes_traditional_der(self, key_type, cdata):\n if key_type == self._lib.EVP_PKEY_RSA:\n write_bio = self._lib.i2d_RSAPrivateKey_bio\n elif key_type == self._lib.EVP_PKEY_EC:\n write_bio = self._lib.i2d_ECPrivateKey_bio\n else:\n self.openssl_assert(key_type == self._lib.EVP_PKEY_DSA)\n write_bio = self._lib.i2d_DSAPrivateKey_bio\n\n bio = self._create_mem_bio_gc()\n res = write_bio(bio, cdata)\n self.openssl_assert(res == 1)\n return self._read_mem_bio(bio)\n\n def _public_key_bytes(self, encoding, format, key, evp_pkey, cdata):\n if not isinstance(encoding, serialization.Encoding):\n raise TypeError(\"encoding must be an item from the Encoding enum\")\n\n # Compressed/UncompressedPoint are only valid for EC keys and those\n # cases are handled by the ECPublicKey public_bytes method before this\n # method is called\n if format in (serialization.PublicFormat.UncompressedPoint,\n serialization.PublicFormat.CompressedPoint):\n raise ValueError(\"Point formats are not valid for this key type\")\n\n # Raw format and encoding are only valid for X25519, Ed25519, X448, and\n # Ed448 keys. We capture those cases before this method is called so if\n # we see those enum values here it means the caller has passed them to\n # a key that doesn't support raw type\n if format is serialization.PublicFormat.Raw:\n raise ValueError(\"raw format is invalid with this key or encoding\")\n\n if encoding is serialization.Encoding.Raw:\n raise ValueError(\"raw encoding is invalid with this key or format\")\n\n if (\n format is serialization.PublicFormat.OpenSSH or\n encoding is serialization.Encoding.OpenSSH\n ):\n if (\n format is not serialization.PublicFormat.OpenSSH or\n encoding is not serialization.Encoding.OpenSSH\n ):\n raise ValueError(\n \"OpenSSH format must be used with OpenSSH encoding\"\n )\n return self._openssh_public_key_bytes(key)\n elif format is serialization.PublicFormat.SubjectPublicKeyInfo:\n if encoding is serialization.Encoding.PEM:\n write_bio = self._lib.PEM_write_bio_PUBKEY\n else:\n assert encoding is serialization.Encoding.DER\n write_bio = self._lib.i2d_PUBKEY_bio\n\n key = evp_pkey\n elif format is serialization.PublicFormat.PKCS1:\n # Only RSA is supported here.\n assert self._lib.EVP_PKEY_id(evp_pkey) == self._lib.EVP_PKEY_RSA\n if encoding is serialization.Encoding.PEM:\n write_bio = self._lib.PEM_write_bio_RSAPublicKey\n else:\n assert encoding is serialization.Encoding.DER\n write_bio = self._lib.i2d_RSAPublicKey_bio\n\n key = cdata\n else:\n raise TypeError(\n \"format must be an item from the PublicFormat enum\"\n )\n\n bio = self._create_mem_bio_gc()\n res = write_bio(bio, key)\n self.openssl_assert(res == 1)\n return self._read_mem_bio(bio)\n\n def _openssh_public_key_bytes(self, key):\n if isinstance(key, rsa.RSAPublicKey):\n public_numbers = key.public_numbers()\n return b\"ssh-rsa \" + base64.b64encode(\n ssh._ssh_write_string(b\"ssh-rsa\") +\n ssh._ssh_write_mpint(public_numbers.e) +\n ssh._ssh_write_mpint(public_numbers.n)\n )\n elif isinstance(key, dsa.DSAPublicKey):\n public_numbers = key.public_numbers()\n parameter_numbers = public_numbers.parameter_numbers\n return b\"ssh-dss \" + base64.b64encode(\n ssh._ssh_write_string(b\"ssh-dss\") +\n ssh._ssh_write_mpint(parameter_numbers.p) +\n ssh._ssh_write_mpint(parameter_numbers.q) +\n ssh._ssh_write_mpint(parameter_numbers.g) +\n ssh._ssh_write_mpint(public_numbers.y)\n )\n elif isinstance(key, ed25519.Ed25519PublicKey):\n raw_bytes = key.public_bytes(serialization.Encoding.Raw,\n serialization.PublicFormat.Raw)\n return b\"ssh-ed25519 \" + base64.b64encode(\n ssh._ssh_write_string(b\"ssh-ed25519\") +\n ssh._ssh_write_string(raw_bytes)\n )\n elif isinstance(key, ec.EllipticCurvePublicKey):\n public_numbers = key.public_numbers()\n try:\n curve_name = {\n ec.SECP256R1: b\"nistp256\",\n ec.SECP384R1: b\"nistp384\",\n ec.SECP521R1: b\"nistp521\",\n }[type(public_numbers.curve)]\n except KeyError:\n raise ValueError(\n \"Only SECP256R1, SECP384R1, and SECP521R1 curves are \"\n \"supported by the SSH public key format\"\n )\n\n point = key.public_bytes(\n serialization.Encoding.X962,\n serialization.PublicFormat.UncompressedPoint\n )\n return b\"ecdsa-sha2-\" + curve_name + b\" \" + base64.b64encode(\n ssh._ssh_write_string(b\"ecdsa-sha2-\" + curve_name) +\n ssh._ssh_write_string(curve_name) +\n ssh._ssh_write_string(point)\n )\n else:\n raise ValueError(\n \"OpenSSH encoding is not supported for this key type\"\n )\n\n def _parameter_bytes(self, encoding, format, cdata):\n if encoding is serialization.Encoding.OpenSSH:\n raise TypeError(\n \"OpenSSH encoding is not supported\"\n )\n\n # Only DH is supported here currently.\n q = self._ffi.new(\"BIGNUM **\")\n self._lib.DH_get0_pqg(cdata,\n self._ffi.NULL,\n q,\n self._ffi.NULL)\n if encoding is serialization.Encoding.PEM:\n if q[0] != self._ffi.NULL:\n write_bio = self._lib.PEM_write_bio_DHxparams\n else:\n write_bio = self._lib.PEM_write_bio_DHparams\n elif encoding is serialization.Encoding.DER:\n if q[0] != self._ffi.NULL:\n write_bio = self._lib.Cryptography_i2d_DHxparams_bio\n else:\n write_bio = self._lib.i2d_DHparams_bio\n else:\n raise TypeError(\"encoding must be an item from the Encoding enum\")\n\n bio = self._create_mem_bio_gc()\n res = write_bio(bio, cdata)\n self.openssl_assert(res == 1)\n return self._read_mem_bio(bio)\n\n def generate_dh_parameters(self, generator, key_size):\n if key_size < 512:\n raise ValueError(\"DH key_size must be at least 512 bits\")\n\n if generator not in (2, 5):\n raise ValueError(\"DH generator must be 2 or 5\")\n\n dh_param_cdata = self._lib.DH_new()\n self.openssl_assert(dh_param_cdata != self._ffi.NULL)\n dh_param_cdata = self._ffi.gc(dh_param_cdata, self._lib.DH_free)\n\n res = self._lib.DH_generate_parameters_ex(\n dh_param_cdata,\n key_size,\n generator,\n self._ffi.NULL\n )\n self.openssl_assert(res == 1)\n\n return _DHParameters(self, dh_param_cdata)\n\n def _dh_cdata_to_evp_pkey(self, dh_cdata):\n evp_pkey = self._create_evp_pkey_gc()\n res = self._lib.EVP_PKEY_set1_DH(evp_pkey, dh_cdata)\n self.openssl_assert(res == 1)\n return evp_pkey\n\n def generate_dh_private_key(self, parameters):\n dh_key_cdata = _dh_params_dup(parameters._dh_cdata, self)\n\n res = self._lib.DH_generate_key(dh_key_cdata)\n self.openssl_assert(res == 1)\n\n evp_pkey = self._dh_cdata_to_evp_pkey(dh_key_cdata)\n\n return _DHPrivateKey(self, dh_key_cdata, evp_pkey)\n\n def generate_dh_private_key_and_parameters(self, generator, key_size):\n return self.generate_dh_private_key(\n self.generate_dh_parameters(generator, key_size))\n\n def load_dh_private_numbers(self, numbers):\n parameter_numbers = numbers.public_numbers.parameter_numbers\n\n dh_cdata = self._lib.DH_new()\n self.openssl_assert(dh_cdata != self._ffi.NULL)\n dh_cdata = self._ffi.gc(dh_cdata, self._lib.DH_free)\n\n p = self._int_to_bn(parameter_numbers.p)\n g = self._int_to_bn(parameter_numbers.g)\n\n if parameter_numbers.q is not None:\n q = self._int_to_bn(parameter_numbers.q)\n else:\n q = self._ffi.NULL\n\n pub_key = self._int_to_bn(numbers.public_numbers.y)\n priv_key = self._int_to_bn(numbers.x)\n\n res = self._lib.DH_set0_pqg(dh_cdata, p, q, g)\n self.openssl_assert(res == 1)\n\n res = self._lib.DH_set0_key(dh_cdata, pub_key, priv_key)\n self.openssl_assert(res == 1)\n\n codes = self._ffi.new(\"int[]\", 1)\n res = self._lib.Cryptography_DH_check(dh_cdata, codes)\n self.openssl_assert(res == 1)\n\n # DH_check will return DH_NOT_SUITABLE_GENERATOR if p % 24 does not\n # equal 11 when the generator is 2 (a quadratic nonresidue).\n # We want to ignore that error because p % 24 == 23 is also fine.\n # Specifically, g is then a quadratic residue. Within the context of\n # Diffie-Hellman this means it can only generate half the possible\n # values. That sounds bad, but quadratic nonresidues leak a bit of\n # the key to the attacker in exchange for having the full key space\n # available. See: https://crypto.stackexchange.com/questions/12961\n if codes[0] != 0 and not (\n parameter_numbers.g == 2 and\n codes[0] ^ self._lib.DH_NOT_SUITABLE_GENERATOR == 0\n ):\n raise ValueError(\n \"DH private numbers did not pass safety checks.\"\n )\n\n evp_pkey = self._dh_cdata_to_evp_pkey(dh_cdata)\n\n return _DHPrivateKey(self, dh_cdata, evp_pkey)\n\n def load_dh_public_numbers(self, numbers):\n dh_cdata = self._lib.DH_new()\n self.openssl_assert(dh_cdata != self._ffi.NULL)\n dh_cdata = self._ffi.gc(dh_cdata, self._lib.DH_free)\n\n parameter_numbers = numbers.parameter_numbers\n\n p = self._int_to_bn(parameter_numbers.p)\n g = self._int_to_bn(parameter_numbers.g)\n\n if parameter_numbers.q is not None:\n q = self._int_to_bn(parameter_numbers.q)\n else:\n q = self._ffi.NULL\n\n pub_key = self._int_to_bn(numbers.y)\n\n res = self._lib.DH_set0_pqg(dh_cdata, p, q, g)\n self.openssl_assert(res == 1)\n\n res = self._lib.DH_set0_key(dh_cdata, pub_key, self._ffi.NULL)\n self.openssl_assert(res == 1)\n\n evp_pkey = self._dh_cdata_to_evp_pkey(dh_cdata)\n\n return _DHPublicKey(self, dh_cdata, evp_pkey)\n\n def load_dh_parameter_numbers(self, numbers):\n dh_cdata = self._lib.DH_new()\n self.openssl_assert(dh_cdata != self._ffi.NULL)\n dh_cdata = self._ffi.gc(dh_cdata, self._lib.DH_free)\n\n p = self._int_to_bn(numbers.p)\n g = self._int_to_bn(numbers.g)\n\n if numbers.q is not None:\n q = self._int_to_bn(numbers.q)\n else:\n q = self._ffi.NULL\n\n res = self._lib.DH_set0_pqg(dh_cdata, p, q, g)\n self.openssl_assert(res == 1)\n\n return _DHParameters(self, dh_cdata)\n\n def dh_parameters_supported(self, p, g, q=None):\n dh_cdata = self._lib.DH_new()\n self.openssl_assert(dh_cdata != self._ffi.NULL)\n dh_cdata = self._ffi.gc(dh_cdata, self._lib.DH_free)\n\n p = self._int_to_bn(p)\n g = self._int_to_bn(g)\n\n if q is not None:\n q = self._int_to_bn(q)\n else:\n q = self._ffi.NULL\n\n res = self._lib.DH_set0_pqg(dh_cdata, p, q, g)\n self.openssl_assert(res == 1)\n\n codes = self._ffi.new(\"int[]\", 1)\n res = self._lib.Cryptography_DH_check(dh_cdata, codes)\n self.openssl_assert(res == 1)\n\n return codes[0] == 0\n\n def dh_x942_serialization_supported(self):\n return self._lib.Cryptography_HAS_EVP_PKEY_DHX == 1\n\n def x509_name_bytes(self, name):\n x509_name = _encode_name_gc(self, name)\n pp = self._ffi.new(\"unsigned char **\")\n res = self._lib.i2d_X509_NAME(x509_name, pp)\n self.openssl_assert(pp[0] != self._ffi.NULL)\n pp = self._ffi.gc(\n pp, lambda pointer: self._lib.OPENSSL_free(pointer[0])\n )\n self.openssl_assert(res > 0)\n return self._ffi.buffer(pp[0], res)[:]\n\n def x25519_load_public_bytes(self, data):\n # When we drop support for CRYPTOGRAPHY_OPENSSL_LESS_THAN_111 we can\n # switch this to EVP_PKEY_new_raw_public_key\n if len(data) != 32:\n raise ValueError(\"An X25519 public key is 32 bytes long\")\n\n evp_pkey = self._create_evp_pkey_gc()\n res = self._lib.EVP_PKEY_set_type(evp_pkey, self._lib.NID_X25519)\n backend.openssl_assert(res == 1)\n res = self._lib.EVP_PKEY_set1_tls_encodedpoint(\n evp_pkey, data, len(data)\n )\n backend.openssl_assert(res == 1)\n return _X25519PublicKey(self, evp_pkey)\n\n def x25519_load_private_bytes(self, data):\n # When we drop support for CRYPTOGRAPHY_OPENSSL_LESS_THAN_111 we can\n # switch this to EVP_PKEY_new_raw_private_key and drop the\n # zeroed_bytearray garbage.\n # OpenSSL only has facilities for loading PKCS8 formatted private\n # keys using the algorithm identifiers specified in\n # https://tools.ietf.org/html/draft-ietf-curdle-pkix-09.\n # This is the standard PKCS8 prefix for a 32 byte X25519 key.\n # The form is:\n # 0:d=0 hl=2 l= 46 cons: SEQUENCE\n # 2:d=1 hl=2 l= 1 prim: INTEGER :00\n # 5:d=1 hl=2 l= 5 cons: SEQUENCE\n # 7:d=2 hl=2 l= 3 prim: OBJECT :1.3.101.110\n # 12:d=1 hl=2 l= 34 prim: OCTET STRING (the key)\n # Of course there's a bit more complexity. In reality OCTET STRING\n # contains an OCTET STRING of length 32! So the last two bytes here\n # are \\x04\\x20, which is an OCTET STRING of length 32.\n if len(data) != 32:\n raise ValueError(\"An X25519 private key is 32 bytes long\")\n\n pkcs8_prefix = b'0.\\x02\\x01\\x000\\x05\\x06\\x03+en\\x04\"\\x04 '\n with self._zeroed_bytearray(48) as ba:\n ba[0:16] = pkcs8_prefix\n ba[16:] = data\n bio = self._bytes_to_bio(ba)\n evp_pkey = backend._lib.d2i_PrivateKey_bio(bio.bio, self._ffi.NULL)\n\n self.openssl_assert(evp_pkey != self._ffi.NULL)\n evp_pkey = self._ffi.gc(evp_pkey, self._lib.EVP_PKEY_free)\n self.openssl_assert(\n self._lib.EVP_PKEY_id(evp_pkey) == self._lib.EVP_PKEY_X25519\n )\n return _X25519PrivateKey(self, evp_pkey)\n\n def _evp_pkey_keygen_gc(self, nid):\n evp_pkey_ctx = self._lib.EVP_PKEY_CTX_new_id(nid, self._ffi.NULL)\n self.openssl_assert(evp_pkey_ctx != self._ffi.NULL)\n evp_pkey_ctx = self._ffi.gc(evp_pkey_ctx, self._lib.EVP_PKEY_CTX_free)\n res = self._lib.EVP_PKEY_keygen_init(evp_pkey_ctx)\n self.openssl_assert(res == 1)\n evp_ppkey = self._ffi.new(\"EVP_PKEY **\")\n res = self._lib.EVP_PKEY_keygen(evp_pkey_ctx, evp_ppkey)\n self.openssl_assert(res == 1)\n self.openssl_assert(evp_ppkey[0] != self._ffi.NULL)\n evp_pkey = self._ffi.gc(evp_ppkey[0], self._lib.EVP_PKEY_free)\n return evp_pkey\n\n def x25519_generate_key(self):\n evp_pkey = self._evp_pkey_keygen_gc(self._lib.NID_X25519)\n return _X25519PrivateKey(self, evp_pkey)\n\n def x25519_supported(self):\n return self._lib.CRYPTOGRAPHY_OPENSSL_110_OR_GREATER\n\n def x448_load_public_bytes(self, data):\n if len(data) != 56:\n raise ValueError(\"An X448 public key is 56 bytes long\")\n\n evp_pkey = self._lib.EVP_PKEY_new_raw_public_key(\n self._lib.NID_X448, self._ffi.NULL, data, len(data)\n )\n self.openssl_assert(evp_pkey != self._ffi.NULL)\n evp_pkey = self._ffi.gc(evp_pkey, self._lib.EVP_PKEY_free)\n return _X448PublicKey(self, evp_pkey)\n\n def x448_load_private_bytes(self, data):\n if len(data) != 56:\n raise ValueError(\"An X448 private key is 56 bytes long\")\n\n data_ptr = self._ffi.from_buffer(data)\n evp_pkey = self._lib.EVP_PKEY_new_raw_private_key(\n self._lib.NID_X448, self._ffi.NULL, data_ptr, len(data)\n )\n self.openssl_assert(evp_pkey != self._ffi.NULL)\n evp_pkey = self._ffi.gc(evp_pkey, self._lib.EVP_PKEY_free)\n return _X448PrivateKey(self, evp_pkey)\n\n def x448_generate_key(self):\n evp_pkey = self._evp_pkey_keygen_gc(self._lib.NID_X448)\n return _X448PrivateKey(self, evp_pkey)\n\n def x448_supported(self):\n return not self._lib.CRYPTOGRAPHY_OPENSSL_LESS_THAN_111\n\n def ed25519_supported(self):\n return not self._lib.CRYPTOGRAPHY_OPENSSL_LESS_THAN_111B\n\n def ed25519_load_public_bytes(self, data):\n utils._check_bytes(\"data\", data)\n\n if len(data) != ed25519._ED25519_KEY_SIZE:\n raise ValueError(\"An Ed25519 public key is 32 bytes long\")\n\n evp_pkey = self._lib.EVP_PKEY_new_raw_public_key(\n self._lib.NID_ED25519, self._ffi.NULL, data, len(data)\n )\n self.openssl_assert(evp_pkey != self._ffi.NULL)\n evp_pkey = self._ffi.gc(evp_pkey, self._lib.EVP_PKEY_free)\n\n return _Ed25519PublicKey(self, evp_pkey)\n\n def ed25519_load_private_bytes(self, data):\n if len(data) != ed25519._ED25519_KEY_SIZE:\n raise ValueError(\"An Ed25519 private key is 32 bytes long\")\n\n utils._check_byteslike(\"data\", data)\n data_ptr = self._ffi.from_buffer(data)\n evp_pkey = self._lib.EVP_PKEY_new_raw_private_key(\n self._lib.NID_ED25519, self._ffi.NULL, data_ptr, len(data)\n )\n self.openssl_assert(evp_pkey != self._ffi.NULL)\n evp_pkey = self._ffi.gc(evp_pkey, self._lib.EVP_PKEY_free)\n\n return _Ed25519PrivateKey(self, evp_pkey)\n\n def ed25519_generate_key(self):\n evp_pkey = self._evp_pkey_keygen_gc(self._lib.NID_ED25519)\n return _Ed25519PrivateKey(self, evp_pkey)\n\n def ed448_supported(self):\n return not self._lib.CRYPTOGRAPHY_OPENSSL_LESS_THAN_111B\n\n def ed448_load_public_bytes(self, data):\n utils._check_bytes(\"data\", data)\n if len(data) != _ED448_KEY_SIZE:\n raise ValueError(\"An Ed448 public key is 57 bytes long\")\n\n evp_pkey = self._lib.EVP_PKEY_new_raw_public_key(\n self._lib.NID_ED448, self._ffi.NULL, data, len(data)\n )\n self.openssl_assert(evp_pkey != self._ffi.NULL)\n evp_pkey = self._ffi.gc(evp_pkey, self._lib.EVP_PKEY_free)\n\n return _Ed448PublicKey(self, evp_pkey)\n\n def ed448_load_private_bytes(self, data):\n utils._check_byteslike(\"data\", data)\n if len(data) != _ED448_KEY_SIZE:\n raise ValueError(\"An Ed448 private key is 57 bytes long\")\n\n data_ptr = self._ffi.from_buffer(data)\n evp_pkey = self._lib.EVP_PKEY_new_raw_private_key(\n self._lib.NID_ED448, self._ffi.NULL, data_ptr, len(data)\n )\n self.openssl_assert(evp_pkey != self._ffi.NULL)\n evp_pkey = self._ffi.gc(evp_pkey, self._lib.EVP_PKEY_free)\n\n return _Ed448PrivateKey(self, evp_pkey)\n\n def ed448_generate_key(self):\n evp_pkey = self._evp_pkey_keygen_gc(self._lib.NID_ED448)\n return _Ed448PrivateKey(self, evp_pkey)\n\n def derive_scrypt(self, key_material, salt, length, n, r, p):\n buf = self._ffi.new(\"unsigned char[]\", length)\n key_material_ptr = self._ffi.from_buffer(key_material)\n res = self._lib.EVP_PBE_scrypt(\n key_material_ptr, len(key_material), salt, len(salt), n, r, p,\n scrypt._MEM_LIMIT, buf, length\n )\n if res != 1:\n errors = self._consume_errors()\n if not self._lib.CRYPTOGRAPHY_OPENSSL_LESS_THAN_111:\n # This error is only added to the stack in 1.1.1+\n self.openssl_assert(\n errors[0]._lib_reason_match(\n self._lib.ERR_LIB_EVP,\n self._lib.ERR_R_MALLOC_FAILURE\n ) or\n errors[0]._lib_reason_match(\n self._lib.ERR_LIB_EVP,\n self._lib.EVP_R_MEMORY_LIMIT_EXCEEDED\n )\n )\n\n # memory required formula explained here:\n # https://blog.filippo.io/the-scrypt-parameters/\n min_memory = 128 * n * r // (1024**2)\n raise MemoryError(\n \"Not enough memory to derive key. These parameters require\"\n \" {} MB of memory.\".format(min_memory)\n )\n return self._ffi.buffer(buf)[:]\n\n def aead_cipher_supported(self, cipher):\n cipher_name = aead._aead_cipher_name(cipher)\n return (\n self._lib.EVP_get_cipherbyname(cipher_name) != self._ffi.NULL\n )\n\n @contextlib.contextmanager\n def _zeroed_bytearray(self, length):\n \"\"\"\n This method creates a bytearray, which we copy data into (hopefully\n also from a mutable buffer that can be dynamically erased!), and then\n zero when we're done.\n \"\"\"\n ba = bytearray(length)\n try:\n yield ba\n finally:\n self._zero_data(ba, length)\n\n def _zero_data(self, data, length):\n # We clear things this way because at the moment we're not\n # sure of a better way that can guarantee it overwrites the\n # memory of a bytearray and doesn't just replace the underlying char *.\n for i in range(length):\n data[i] = 0\n\n @contextlib.contextmanager\n def _zeroed_null_terminated_buf(self, data):\n \"\"\"\n This method takes bytes, which can be a bytestring or a mutable\n buffer like a bytearray, and yields a null-terminated version of that\n data. This is required because PKCS12_parse doesn't take a length with\n its password char * and ffi.from_buffer doesn't provide null\n termination. So, to support zeroing the data via bytearray we\n need to build this ridiculous construct that copies the memory, but\n zeroes it after use.\n \"\"\"\n if data is None:\n yield self._ffi.NULL\n else:\n data_len = len(data)\n buf = self._ffi.new(\"char[]\", data_len + 1)\n self._ffi.memmove(buf, data, data_len)\n try:\n yield buf\n finally:\n # Cast to a uint8_t * so we can assign by integer\n self._zero_data(self._ffi.cast(\"uint8_t *\", buf), data_len)\n\n def load_key_and_certificates_from_pkcs12(self, data, password):\n if password is not None:\n utils._check_byteslike(\"password\", password)\n\n bio = self._bytes_to_bio(data)\n p12 = self._lib.d2i_PKCS12_bio(bio.bio, self._ffi.NULL)\n if p12 == self._ffi.NULL:\n self._consume_errors()\n raise ValueError(\"Could not deserialize PKCS12 data\")\n\n p12 = self._ffi.gc(p12, self._lib.PKCS12_free)\n evp_pkey_ptr = self._ffi.new(\"EVP_PKEY **\")\n x509_ptr = self._ffi.new(\"X509 **\")\n sk_x509_ptr = self._ffi.new(\"Cryptography_STACK_OF_X509 **\")\n with self._zeroed_null_terminated_buf(password) as password_buf:\n res = self._lib.PKCS12_parse(\n p12, password_buf, evp_pkey_ptr, x509_ptr, sk_x509_ptr\n )\n\n if res == 0:\n self._consume_errors()\n raise ValueError(\"Invalid password or PKCS12 data\")\n\n cert = None\n key = None\n additional_certificates = []\n\n if evp_pkey_ptr[0] != self._ffi.NULL:\n evp_pkey = self._ffi.gc(evp_pkey_ptr[0], self._lib.EVP_PKEY_free)\n key = self._evp_pkey_to_private_key(evp_pkey)\n\n if x509_ptr[0] != self._ffi.NULL:\n x509 = self._ffi.gc(x509_ptr[0], self._lib.X509_free)\n cert = _Certificate(self, x509)\n\n if sk_x509_ptr[0] != self._ffi.NULL:\n sk_x509 = self._ffi.gc(sk_x509_ptr[0], self._lib.sk_X509_free)\n num = self._lib.sk_X509_num(sk_x509_ptr[0])\n for i in range(num):\n x509 = self._lib.sk_X509_value(sk_x509, i)\n x509 = self._ffi.gc(x509, self._lib.X509_free)\n self.openssl_assert(x509 != self._ffi.NULL)\n additional_certificates.append(_Certificate(self, x509))\n\n return (key, cert, additional_certificates)\n\n def poly1305_supported(self):\n return self._lib.Cryptography_HAS_POLY1305 == 1\n\n def create_poly1305_ctx(self, key):\n utils._check_byteslike(\"key\", key)\n if len(key) != _POLY1305_KEY_SIZE:\n raise ValueError(\"A poly1305 key is 32 bytes long\")\n\n return _Poly1305Context(self, key)\n\n\nclass GetCipherByName(object):\n def __init__(self, fmt):\n self._fmt = fmt\n\n def __call__(self, backend, cipher, mode):\n cipher_name = self._fmt.format(cipher=cipher, mode=mode).lower()\n return backend._lib.EVP_get_cipherbyname(cipher_name.encode(\"ascii\"))\n\n\ndef _get_xts_cipher(backend, cipher, mode):\n cipher_name = \"aes-{}-xts\".format(cipher.key_size // 2)\n return backend._lib.EVP_get_cipherbyname(cipher_name.encode(\"ascii\"))\n\n\nbackend = Backend()\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/backends/openssl/ciphers.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nfrom cryptography import utils\nfrom cryptography.exceptions import InvalidTag, UnsupportedAlgorithm, _Reasons\nfrom cryptography.hazmat.primitives import ciphers\nfrom cryptography.hazmat.primitives.ciphers import modes\n\n\n@utils.register_interface(ciphers.CipherContext)\n@utils.register_interface(ciphers.AEADCipherContext)\n@utils.register_interface(ciphers.AEADEncryptionContext)\n@utils.register_interface(ciphers.AEADDecryptionContext)\nclass _CipherContext(object):\n _ENCRYPT = 1\n _DECRYPT = 0\n\n def __init__(self, backend, cipher, mode, operation):\n self._backend = backend\n self._cipher = cipher\n self._mode = mode\n self._operation = operation\n self._tag = None\n\n if isinstance(self._cipher, ciphers.BlockCipherAlgorithm):\n self._block_size_bytes = self._cipher.block_size // 8\n else:\n self._block_size_bytes = 1\n\n ctx = self._backend._lib.EVP_CIPHER_CTX_new()\n ctx = self._backend._ffi.gc(\n ctx, self._backend._lib.EVP_CIPHER_CTX_free\n )\n\n registry = self._backend._cipher_registry\n try:\n adapter = registry[type(cipher), type(mode)]\n except KeyError:\n raise UnsupportedAlgorithm(\n \"cipher {} in {} mode is not supported \"\n \"by this backend.\".format(\n cipher.name, mode.name if mode else mode),\n _Reasons.UNSUPPORTED_CIPHER\n )\n\n evp_cipher = adapter(self._backend, cipher, mode)\n if evp_cipher == self._backend._ffi.NULL:\n msg = \"cipher {0.name} \".format(cipher)\n if mode is not None:\n msg += \"in {0.name} mode \".format(mode)\n msg += (\n \"is not supported by this backend (Your version of OpenSSL \"\n \"may be too old. Current version: {}.)\"\n ).format(self._backend.openssl_version_text())\n raise UnsupportedAlgorithm(msg, _Reasons.UNSUPPORTED_CIPHER)\n\n if isinstance(mode, modes.ModeWithInitializationVector):\n iv_nonce = self._backend._ffi.from_buffer(\n mode.initialization_vector\n )\n elif isinstance(mode, modes.ModeWithTweak):\n iv_nonce = self._backend._ffi.from_buffer(mode.tweak)\n elif isinstance(mode, modes.ModeWithNonce):\n iv_nonce = self._backend._ffi.from_buffer(mode.nonce)\n elif isinstance(cipher, modes.ModeWithNonce):\n iv_nonce = self._backend._ffi.from_buffer(cipher.nonce)\n else:\n iv_nonce = self._backend._ffi.NULL\n # begin init with cipher and operation type\n res = self._backend._lib.EVP_CipherInit_ex(ctx, evp_cipher,\n self._backend._ffi.NULL,\n self._backend._ffi.NULL,\n self._backend._ffi.NULL,\n operation)\n self._backend.openssl_assert(res != 0)\n # set the key length to handle variable key ciphers\n res = self._backend._lib.EVP_CIPHER_CTX_set_key_length(\n ctx, len(cipher.key)\n )\n self._backend.openssl_assert(res != 0)\n if isinstance(mode, modes.GCM):\n res = self._backend._lib.EVP_CIPHER_CTX_ctrl(\n ctx, self._backend._lib.EVP_CTRL_AEAD_SET_IVLEN,\n len(iv_nonce), self._backend._ffi.NULL\n )\n self._backend.openssl_assert(res != 0)\n if mode.tag is not None:\n res = self._backend._lib.EVP_CIPHER_CTX_ctrl(\n ctx, self._backend._lib.EVP_CTRL_AEAD_SET_TAG,\n len(mode.tag), mode.tag\n )\n self._backend.openssl_assert(res != 0)\n self._tag = mode.tag\n elif (\n self._operation == self._DECRYPT and\n self._backend._lib.CRYPTOGRAPHY_OPENSSL_LESS_THAN_102 and\n not self._backend._lib.CRYPTOGRAPHY_IS_LIBRESSL\n ):\n raise NotImplementedError(\n \"delayed passing of GCM tag requires OpenSSL >= 1.0.2.\"\n \" To use this feature please update OpenSSL\"\n )\n\n # pass key/iv\n res = self._backend._lib.EVP_CipherInit_ex(\n ctx,\n self._backend._ffi.NULL,\n self._backend._ffi.NULL,\n self._backend._ffi.from_buffer(cipher.key),\n iv_nonce,\n operation\n )\n self._backend.openssl_assert(res != 0)\n # We purposely disable padding here as it's handled higher up in the\n # API.\n self._backend._lib.EVP_CIPHER_CTX_set_padding(ctx, 0)\n self._ctx = ctx\n\n def update(self, data):\n buf = bytearray(len(data) + self._block_size_bytes - 1)\n n = self.update_into(data, buf)\n return bytes(buf[:n])\n\n def update_into(self, data, buf):\n if len(buf) < (len(data) + self._block_size_bytes - 1):\n raise ValueError(\n \"buffer must be at least {} bytes for this \"\n \"payload\".format(len(data) + self._block_size_bytes - 1)\n )\n\n buf = self._backend._ffi.cast(\n \"unsigned char *\", self._backend._ffi.from_buffer(buf)\n )\n outlen = self._backend._ffi.new(\"int *\")\n res = self._backend._lib.EVP_CipherUpdate(\n self._ctx, buf, outlen,\n self._backend._ffi.from_buffer(data), len(data)\n )\n self._backend.openssl_assert(res != 0)\n return outlen[0]\n\n def finalize(self):\n # OpenSSL 1.0.1 on Ubuntu 12.04 (and possibly other distributions)\n # appears to have a bug where you must make at least one call to update\n # even if you are only using authenticate_additional_data or the\n # GCM tag will be wrong. An (empty) call to update resolves this\n # and is harmless for all other versions of OpenSSL.\n if isinstance(self._mode, modes.GCM):\n self.update(b\"\")\n\n if (\n self._operation == self._DECRYPT and\n isinstance(self._mode, modes.ModeWithAuthenticationTag) and\n self.tag is None\n ):\n raise ValueError(\n \"Authentication tag must be provided when decrypting.\"\n )\n\n buf = self._backend._ffi.new(\"unsigned char[]\", self._block_size_bytes)\n outlen = self._backend._ffi.new(\"int *\")\n res = self._backend._lib.EVP_CipherFinal_ex(self._ctx, buf, outlen)\n if res == 0:\n errors = self._backend._consume_errors()\n\n if not errors and isinstance(self._mode, modes.GCM):\n raise InvalidTag\n\n self._backend.openssl_assert(\n errors[0]._lib_reason_match(\n self._backend._lib.ERR_LIB_EVP,\n self._backend._lib.EVP_R_DATA_NOT_MULTIPLE_OF_BLOCK_LENGTH\n )\n )\n raise ValueError(\n \"The length of the provided data is not a multiple of \"\n \"the block length.\"\n )\n\n if (isinstance(self._mode, modes.GCM) and\n self._operation == self._ENCRYPT):\n tag_buf = self._backend._ffi.new(\n \"unsigned char[]\", self._block_size_bytes\n )\n res = self._backend._lib.EVP_CIPHER_CTX_ctrl(\n self._ctx, self._backend._lib.EVP_CTRL_AEAD_GET_TAG,\n self._block_size_bytes, tag_buf\n )\n self._backend.openssl_assert(res != 0)\n self._tag = self._backend._ffi.buffer(tag_buf)[:]\n\n res = self._backend._lib.EVP_CIPHER_CTX_cleanup(self._ctx)\n self._backend.openssl_assert(res == 1)\n return self._backend._ffi.buffer(buf)[:outlen[0]]\n\n def finalize_with_tag(self, tag):\n if (\n self._backend._lib.CRYPTOGRAPHY_OPENSSL_LESS_THAN_102 and\n not self._backend._lib.CRYPTOGRAPHY_IS_LIBRESSL\n ):\n raise NotImplementedError(\n \"finalize_with_tag requires OpenSSL >= 1.0.2. To use this \"\n \"method please update OpenSSL\"\n )\n if len(tag) < self._mode._min_tag_length:\n raise ValueError(\n \"Authentication tag must be {} bytes or longer.\".format(\n self._mode._min_tag_length)\n )\n res = self._backend._lib.EVP_CIPHER_CTX_ctrl(\n self._ctx, self._backend._lib.EVP_CTRL_AEAD_SET_TAG,\n len(tag), tag\n )\n self._backend.openssl_assert(res != 0)\n self._tag = tag\n return self.finalize()\n\n def authenticate_additional_data(self, data):\n outlen = self._backend._ffi.new(\"int *\")\n res = self._backend._lib.EVP_CipherUpdate(\n self._ctx, self._backend._ffi.NULL, outlen,\n self._backend._ffi.from_buffer(data), len(data)\n )\n self._backend.openssl_assert(res != 0)\n\n tag = utils.read_only_property(\"_tag\")\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/backends/openssl/cmac.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\n\nfrom cryptography import utils\nfrom cryptography.exceptions import (\n InvalidSignature, UnsupportedAlgorithm, _Reasons\n)\nfrom cryptography.hazmat.primitives import constant_time\nfrom cryptography.hazmat.primitives.ciphers.modes import CBC\n\n\nclass _CMACContext(object):\n def __init__(self, backend, algorithm, ctx=None):\n if not backend.cmac_algorithm_supported(algorithm):\n raise UnsupportedAlgorithm(\"This backend does not support CMAC.\",\n _Reasons.UNSUPPORTED_CIPHER)\n\n self._backend = backend\n self._key = algorithm.key\n self._algorithm = algorithm\n self._output_length = algorithm.block_size // 8\n\n if ctx is None:\n registry = self._backend._cipher_registry\n adapter = registry[type(algorithm), CBC]\n\n evp_cipher = adapter(self._backend, algorithm, CBC)\n\n ctx = self._backend._lib.CMAC_CTX_new()\n\n self._backend.openssl_assert(ctx != self._backend._ffi.NULL)\n ctx = self._backend._ffi.gc(ctx, self._backend._lib.CMAC_CTX_free)\n\n key_ptr = self._backend._ffi.from_buffer(self._key)\n res = self._backend._lib.CMAC_Init(\n ctx, key_ptr, len(self._key),\n evp_cipher, self._backend._ffi.NULL\n )\n self._backend.openssl_assert(res == 1)\n\n self._ctx = ctx\n\n algorithm = utils.read_only_property(\"_algorithm\")\n\n def update(self, data):\n res = self._backend._lib.CMAC_Update(self._ctx, data, len(data))\n self._backend.openssl_assert(res == 1)\n\n def finalize(self):\n buf = self._backend._ffi.new(\"unsigned char[]\", self._output_length)\n length = self._backend._ffi.new(\"size_t *\", self._output_length)\n res = self._backend._lib.CMAC_Final(\n self._ctx, buf, length\n )\n self._backend.openssl_assert(res == 1)\n\n self._ctx = None\n\n return self._backend._ffi.buffer(buf)[:]\n\n def copy(self):\n copied_ctx = self._backend._lib.CMAC_CTX_new()\n copied_ctx = self._backend._ffi.gc(\n copied_ctx, self._backend._lib.CMAC_CTX_free\n )\n res = self._backend._lib.CMAC_CTX_copy(\n copied_ctx, self._ctx\n )\n self._backend.openssl_assert(res == 1)\n return _CMACContext(\n self._backend, self._algorithm, ctx=copied_ctx\n )\n\n def verify(self, signature):\n digest = self.finalize()\n if not constant_time.bytes_eq(digest, signature):\n raise InvalidSignature(\"Signature did not match digest.\")\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/backends/openssl/decode_asn1.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport datetime\nimport ipaddress\n\nimport six\n\nfrom cryptography import x509\nfrom cryptography.hazmat._der import DERReader, INTEGER, NULL, SEQUENCE\nfrom cryptography.x509.extensions import _TLS_FEATURE_TYPE_TO_ENUM\nfrom cryptography.x509.name import _ASN1_TYPE_TO_ENUM\nfrom cryptography.x509.oid import (\n CRLEntryExtensionOID, CertificatePoliciesOID, ExtensionOID,\n OCSPExtensionOID,\n)\n\n\ndef _obj2txt(backend, obj):\n # Set to 80 on the recommendation of\n # https://www.openssl.org/docs/crypto/OBJ_nid2ln.html#return_values\n #\n # But OIDs longer than this occur in real life (e.g. Active\n # Directory makes some very long OIDs). So we need to detect\n # and properly handle the case where the default buffer is not\n # big enough.\n #\n buf_len = 80\n buf = backend._ffi.new(\"char[]\", buf_len)\n\n # 'res' is the number of bytes that *would* be written if the\n # buffer is large enough. If 'res' > buf_len - 1, we need to\n # alloc a big-enough buffer and go again.\n res = backend._lib.OBJ_obj2txt(buf, buf_len, obj, 1)\n if res > buf_len - 1: # account for terminating null byte\n buf_len = res + 1\n buf = backend._ffi.new(\"char[]\", buf_len)\n res = backend._lib.OBJ_obj2txt(buf, buf_len, obj, 1)\n backend.openssl_assert(res > 0)\n return backend._ffi.buffer(buf, res)[:].decode()\n\n\ndef _decode_x509_name_entry(backend, x509_name_entry):\n obj = backend._lib.X509_NAME_ENTRY_get_object(x509_name_entry)\n backend.openssl_assert(obj != backend._ffi.NULL)\n data = backend._lib.X509_NAME_ENTRY_get_data(x509_name_entry)\n backend.openssl_assert(data != backend._ffi.NULL)\n value = _asn1_string_to_utf8(backend, data)\n oid = _obj2txt(backend, obj)\n type = _ASN1_TYPE_TO_ENUM[data.type]\n\n return x509.NameAttribute(x509.ObjectIdentifier(oid), value, type)\n\n\ndef _decode_x509_name(backend, x509_name):\n count = backend._lib.X509_NAME_entry_count(x509_name)\n attributes = []\n prev_set_id = -1\n for x in range(count):\n entry = backend._lib.X509_NAME_get_entry(x509_name, x)\n attribute = _decode_x509_name_entry(backend, entry)\n set_id = backend._lib.Cryptography_X509_NAME_ENTRY_set(entry)\n if set_id != prev_set_id:\n attributes.append(set([attribute]))\n else:\n # is in the same RDN a previous entry\n attributes[-1].add(attribute)\n prev_set_id = set_id\n\n return x509.Name(x509.RelativeDistinguishedName(rdn) for rdn in attributes)\n\n\ndef _decode_general_names(backend, gns):\n num = backend._lib.sk_GENERAL_NAME_num(gns)\n names = []\n for i in range(num):\n gn = backend._lib.sk_GENERAL_NAME_value(gns, i)\n backend.openssl_assert(gn != backend._ffi.NULL)\n names.append(_decode_general_name(backend, gn))\n\n return names\n\n\ndef _decode_general_name(backend, gn):\n if gn.type == backend._lib.GEN_DNS:\n # Convert to bytes and then decode to utf8. We don't use\n # asn1_string_to_utf8 here because it doesn't properly convert\n # utf8 from ia5strings.\n data = _asn1_string_to_bytes(backend, gn.d.dNSName).decode(\"utf8\")\n # We don't use the constructor for DNSName so we can bypass validation\n # This allows us to create DNSName objects that have unicode chars\n # when a certificate (against the RFC) contains them.\n return x509.DNSName._init_without_validation(data)\n elif gn.type == backend._lib.GEN_URI:\n # Convert to bytes and then decode to utf8. We don't use\n # asn1_string_to_utf8 here because it doesn't properly convert\n # utf8 from ia5strings.\n data = _asn1_string_to_bytes(\n backend, gn.d.uniformResourceIdentifier\n ).decode(\"utf8\")\n # We don't use the constructor for URI so we can bypass validation\n # This allows us to create URI objects that have unicode chars\n # when a certificate (against the RFC) contains them.\n return x509.UniformResourceIdentifier._init_without_validation(data)\n elif gn.type == backend._lib.GEN_RID:\n oid = _obj2txt(backend, gn.d.registeredID)\n return x509.RegisteredID(x509.ObjectIdentifier(oid))\n elif gn.type == backend._lib.GEN_IPADD:\n data = _asn1_string_to_bytes(backend, gn.d.iPAddress)\n data_len = len(data)\n if data_len == 8 or data_len == 32:\n # This is an IPv4 or IPv6 Network and not a single IP. This\n # type of data appears in Name Constraints. Unfortunately,\n # ipaddress doesn't support packed bytes + netmask. Additionally,\n # IPv6Network can only handle CIDR rather than the full 16 byte\n # netmask. To handle this we convert the netmask to integer, then\n # find the first 0 bit, which will be the prefix. If another 1\n # bit is present after that the netmask is invalid.\n base = ipaddress.ip_address(data[:data_len // 2])\n netmask = ipaddress.ip_address(data[data_len // 2:])\n bits = bin(int(netmask))[2:]\n prefix = bits.find('0')\n # If no 0 bits are found it is a /32 or /128\n if prefix == -1:\n prefix = len(bits)\n\n if \"1\" in bits[prefix:]:\n raise ValueError(\"Invalid netmask\")\n\n ip = ipaddress.ip_network(base.exploded + u\"/{}\".format(prefix))\n else:\n ip = ipaddress.ip_address(data)\n\n return x509.IPAddress(ip)\n elif gn.type == backend._lib.GEN_DIRNAME:\n return x509.DirectoryName(\n _decode_x509_name(backend, gn.d.directoryName)\n )\n elif gn.type == backend._lib.GEN_EMAIL:\n # Convert to bytes and then decode to utf8. We don't use\n # asn1_string_to_utf8 here because it doesn't properly convert\n # utf8 from ia5strings.\n data = _asn1_string_to_bytes(backend, gn.d.rfc822Name).decode(\"utf8\")\n # We don't use the constructor for RFC822Name so we can bypass\n # validation. This allows us to create RFC822Name objects that have\n # unicode chars when a certificate (against the RFC) contains them.\n return x509.RFC822Name._init_without_validation(data)\n elif gn.type == backend._lib.GEN_OTHERNAME:\n type_id = _obj2txt(backend, gn.d.otherName.type_id)\n value = _asn1_to_der(backend, gn.d.otherName.value)\n return x509.OtherName(x509.ObjectIdentifier(type_id), value)\n else:\n # x400Address or ediPartyName\n raise x509.UnsupportedGeneralNameType(\n \"{} is not a supported type\".format(\n x509._GENERAL_NAMES.get(gn.type, gn.type)\n ),\n gn.type\n )\n\n\ndef _decode_ocsp_no_check(backend, ext):\n return x509.OCSPNoCheck()\n\n\ndef _decode_crl_number(backend, ext):\n asn1_int = backend._ffi.cast(\"ASN1_INTEGER *\", ext)\n asn1_int = backend._ffi.gc(asn1_int, backend._lib.ASN1_INTEGER_free)\n return x509.CRLNumber(_asn1_integer_to_int(backend, asn1_int))\n\n\ndef _decode_delta_crl_indicator(backend, ext):\n asn1_int = backend._ffi.cast(\"ASN1_INTEGER *\", ext)\n asn1_int = backend._ffi.gc(asn1_int, backend._lib.ASN1_INTEGER_free)\n return x509.DeltaCRLIndicator(_asn1_integer_to_int(backend, asn1_int))\n\n\nclass _X509ExtensionParser(object):\n def __init__(self, ext_count, get_ext, handlers):\n self.ext_count = ext_count\n self.get_ext = get_ext\n self.handlers = handlers\n\n def parse(self, backend, x509_obj):\n extensions = []\n seen_oids = set()\n for i in range(self.ext_count(backend, x509_obj)):\n ext = self.get_ext(backend, x509_obj, i)\n backend.openssl_assert(ext != backend._ffi.NULL)\n crit = backend._lib.X509_EXTENSION_get_critical(ext)\n critical = crit == 1\n oid = x509.ObjectIdentifier(\n _obj2txt(backend, backend._lib.X509_EXTENSION_get_object(ext))\n )\n if oid in seen_oids:\n raise x509.DuplicateExtension(\n \"Duplicate {} extension found\".format(oid), oid\n )\n\n # These OIDs are only supported in OpenSSL 1.1.0+ but we want\n # to support them in all versions of OpenSSL so we decode them\n # ourselves.\n if oid == ExtensionOID.TLS_FEATURE:\n # The extension contents are a SEQUENCE OF INTEGERs.\n data = backend._lib.X509_EXTENSION_get_data(ext)\n data_bytes = _asn1_string_to_bytes(backend, data)\n features = DERReader(data_bytes).read_single_element(SEQUENCE)\n parsed = []\n while not features.is_empty():\n parsed.append(features.read_element(INTEGER).as_integer())\n # Map the features to their enum value.\n value = x509.TLSFeature(\n [_TLS_FEATURE_TYPE_TO_ENUM[x] for x in parsed]\n )\n extensions.append(x509.Extension(oid, critical, value))\n seen_oids.add(oid)\n continue\n elif oid == ExtensionOID.PRECERT_POISON:\n data = backend._lib.X509_EXTENSION_get_data(ext)\n # The contents of the extension must be an ASN.1 NULL.\n reader = DERReader(_asn1_string_to_bytes(backend, data))\n reader.read_single_element(NULL).check_empty()\n extensions.append(x509.Extension(\n oid, critical, x509.PrecertPoison()\n ))\n seen_oids.add(oid)\n continue\n\n try:\n handler = self.handlers[oid]\n except KeyError:\n # Dump the DER payload into an UnrecognizedExtension object\n data = backend._lib.X509_EXTENSION_get_data(ext)\n backend.openssl_assert(data != backend._ffi.NULL)\n der = backend._ffi.buffer(data.data, data.length)[:]\n unrecognized = x509.UnrecognizedExtension(oid, der)\n extensions.append(\n x509.Extension(oid, critical, unrecognized)\n )\n else:\n ext_data = backend._lib.X509V3_EXT_d2i(ext)\n if ext_data == backend._ffi.NULL:\n backend._consume_errors()\n raise ValueError(\n \"The {} extension is invalid and can't be \"\n \"parsed\".format(oid)\n )\n\n value = handler(backend, ext_data)\n extensions.append(x509.Extension(oid, critical, value))\n\n seen_oids.add(oid)\n\n return x509.Extensions(extensions)\n\n\ndef _decode_certificate_policies(backend, cp):\n cp = backend._ffi.cast(\"Cryptography_STACK_OF_POLICYINFO *\", cp)\n cp = backend._ffi.gc(cp, backend._lib.CERTIFICATEPOLICIES_free)\n\n num = backend._lib.sk_POLICYINFO_num(cp)\n certificate_policies = []\n for i in range(num):\n qualifiers = None\n pi = backend._lib.sk_POLICYINFO_value(cp, i)\n oid = x509.ObjectIdentifier(_obj2txt(backend, pi.policyid))\n if pi.qualifiers != backend._ffi.NULL:\n qnum = backend._lib.sk_POLICYQUALINFO_num(pi.qualifiers)\n qualifiers = []\n for j in range(qnum):\n pqi = backend._lib.sk_POLICYQUALINFO_value(\n pi.qualifiers, j\n )\n pqualid = x509.ObjectIdentifier(\n _obj2txt(backend, pqi.pqualid)\n )\n if pqualid == CertificatePoliciesOID.CPS_QUALIFIER:\n cpsuri = backend._ffi.buffer(\n pqi.d.cpsuri.data, pqi.d.cpsuri.length\n )[:].decode('ascii')\n qualifiers.append(cpsuri)\n else:\n assert pqualid == CertificatePoliciesOID.CPS_USER_NOTICE\n user_notice = _decode_user_notice(\n backend, pqi.d.usernotice\n )\n qualifiers.append(user_notice)\n\n certificate_policies.append(\n x509.PolicyInformation(oid, qualifiers)\n )\n\n return x509.CertificatePolicies(certificate_policies)\n\n\ndef _decode_user_notice(backend, un):\n explicit_text = None\n notice_reference = None\n\n if un.exptext != backend._ffi.NULL:\n explicit_text = _asn1_string_to_utf8(backend, un.exptext)\n\n if un.noticeref != backend._ffi.NULL:\n organization = _asn1_string_to_utf8(\n backend, un.noticeref.organization\n )\n\n num = backend._lib.sk_ASN1_INTEGER_num(\n un.noticeref.noticenos\n )\n notice_numbers = []\n for i in range(num):\n asn1_int = backend._lib.sk_ASN1_INTEGER_value(\n un.noticeref.noticenos, i\n )\n notice_num = _asn1_integer_to_int(backend, asn1_int)\n notice_numbers.append(notice_num)\n\n notice_reference = x509.NoticeReference(\n organization, notice_numbers\n )\n\n return x509.UserNotice(notice_reference, explicit_text)\n\n\ndef _decode_basic_constraints(backend, bc_st):\n basic_constraints = backend._ffi.cast(\"BASIC_CONSTRAINTS *\", bc_st)\n basic_constraints = backend._ffi.gc(\n basic_constraints, backend._lib.BASIC_CONSTRAINTS_free\n )\n # The byte representation of an ASN.1 boolean true is \\xff. OpenSSL\n # chooses to just map this to its ordinal value, so true is 255 and\n # false is 0.\n ca = basic_constraints.ca == 255\n path_length = _asn1_integer_to_int_or_none(\n backend, basic_constraints.pathlen\n )\n\n return x509.BasicConstraints(ca, path_length)\n\n\ndef _decode_subject_key_identifier(backend, asn1_string):\n asn1_string = backend._ffi.cast(\"ASN1_OCTET_STRING *\", asn1_string)\n asn1_string = backend._ffi.gc(\n asn1_string, backend._lib.ASN1_OCTET_STRING_free\n )\n return x509.SubjectKeyIdentifier(\n backend._ffi.buffer(asn1_string.data, asn1_string.length)[:]\n )\n\n\ndef _decode_authority_key_identifier(backend, akid):\n akid = backend._ffi.cast(\"AUTHORITY_KEYID *\", akid)\n akid = backend._ffi.gc(akid, backend._lib.AUTHORITY_KEYID_free)\n key_identifier = None\n authority_cert_issuer = None\n\n if akid.keyid != backend._ffi.NULL:\n key_identifier = backend._ffi.buffer(\n akid.keyid.data, akid.keyid.length\n )[:]\n\n if akid.issuer != backend._ffi.NULL:\n authority_cert_issuer = _decode_general_names(\n backend, akid.issuer\n )\n\n authority_cert_serial_number = _asn1_integer_to_int_or_none(\n backend, akid.serial\n )\n\n return x509.AuthorityKeyIdentifier(\n key_identifier, authority_cert_issuer, authority_cert_serial_number\n )\n\n\ndef _decode_authority_information_access(backend, aia):\n aia = backend._ffi.cast(\"Cryptography_STACK_OF_ACCESS_DESCRIPTION *\", aia)\n aia = backend._ffi.gc(\n aia,\n lambda x: backend._lib.sk_ACCESS_DESCRIPTION_pop_free(\n x, backend._ffi.addressof(\n backend._lib._original_lib, \"ACCESS_DESCRIPTION_free\"\n )\n )\n )\n num = backend._lib.sk_ACCESS_DESCRIPTION_num(aia)\n access_descriptions = []\n for i in range(num):\n ad = backend._lib.sk_ACCESS_DESCRIPTION_value(aia, i)\n backend.openssl_assert(ad.method != backend._ffi.NULL)\n oid = x509.ObjectIdentifier(_obj2txt(backend, ad.method))\n backend.openssl_assert(ad.location != backend._ffi.NULL)\n gn = _decode_general_name(backend, ad.location)\n access_descriptions.append(x509.AccessDescription(oid, gn))\n\n return x509.AuthorityInformationAccess(access_descriptions)\n\n\ndef _decode_key_usage(backend, bit_string):\n bit_string = backend._ffi.cast(\"ASN1_BIT_STRING *\", bit_string)\n bit_string = backend._ffi.gc(bit_string, backend._lib.ASN1_BIT_STRING_free)\n get_bit = backend._lib.ASN1_BIT_STRING_get_bit\n digital_signature = get_bit(bit_string, 0) == 1\n content_commitment = get_bit(bit_string, 1) == 1\n key_encipherment = get_bit(bit_string, 2) == 1\n data_encipherment = get_bit(bit_string, 3) == 1\n key_agreement = get_bit(bit_string, 4) == 1\n key_cert_sign = get_bit(bit_string, 5) == 1\n crl_sign = get_bit(bit_string, 6) == 1\n encipher_only = get_bit(bit_string, 7) == 1\n decipher_only = get_bit(bit_string, 8) == 1\n return x509.KeyUsage(\n digital_signature,\n content_commitment,\n key_encipherment,\n data_encipherment,\n key_agreement,\n key_cert_sign,\n crl_sign,\n encipher_only,\n decipher_only\n )\n\n\ndef _decode_general_names_extension(backend, gns):\n gns = backend._ffi.cast(\"GENERAL_NAMES *\", gns)\n gns = backend._ffi.gc(gns, backend._lib.GENERAL_NAMES_free)\n general_names = _decode_general_names(backend, gns)\n return general_names\n\n\ndef _decode_subject_alt_name(backend, ext):\n return x509.SubjectAlternativeName(\n _decode_general_names_extension(backend, ext)\n )\n\n\ndef _decode_issuer_alt_name(backend, ext):\n return x509.IssuerAlternativeName(\n _decode_general_names_extension(backend, ext)\n )\n\n\ndef _decode_name_constraints(backend, nc):\n nc = backend._ffi.cast(\"NAME_CONSTRAINTS *\", nc)\n nc = backend._ffi.gc(nc, backend._lib.NAME_CONSTRAINTS_free)\n permitted = _decode_general_subtrees(backend, nc.permittedSubtrees)\n excluded = _decode_general_subtrees(backend, nc.excludedSubtrees)\n return x509.NameConstraints(\n permitted_subtrees=permitted, excluded_subtrees=excluded\n )\n\n\ndef _decode_general_subtrees(backend, stack_subtrees):\n if stack_subtrees == backend._ffi.NULL:\n return None\n\n num = backend._lib.sk_GENERAL_SUBTREE_num(stack_subtrees)\n subtrees = []\n\n for i in range(num):\n obj = backend._lib.sk_GENERAL_SUBTREE_value(stack_subtrees, i)\n backend.openssl_assert(obj != backend._ffi.NULL)\n name = _decode_general_name(backend, obj.base)\n subtrees.append(name)\n\n return subtrees\n\n\ndef _decode_issuing_dist_point(backend, idp):\n idp = backend._ffi.cast(\"ISSUING_DIST_POINT *\", idp)\n idp = backend._ffi.gc(idp, backend._lib.ISSUING_DIST_POINT_free)\n if idp.distpoint != backend._ffi.NULL:\n full_name, relative_name = _decode_distpoint(backend, idp.distpoint)\n else:\n full_name = None\n relative_name = None\n\n only_user = idp.onlyuser == 255\n only_ca = idp.onlyCA == 255\n indirect_crl = idp.indirectCRL == 255\n only_attr = idp.onlyattr == 255\n if idp.onlysomereasons != backend._ffi.NULL:\n only_some_reasons = _decode_reasons(backend, idp.onlysomereasons)\n else:\n only_some_reasons = None\n\n return x509.IssuingDistributionPoint(\n full_name, relative_name, only_user, only_ca, only_some_reasons,\n indirect_crl, only_attr\n )\n\n\ndef _decode_policy_constraints(backend, pc):\n pc = backend._ffi.cast(\"POLICY_CONSTRAINTS *\", pc)\n pc = backend._ffi.gc(pc, backend._lib.POLICY_CONSTRAINTS_free)\n\n require_explicit_policy = _asn1_integer_to_int_or_none(\n backend, pc.requireExplicitPolicy\n )\n inhibit_policy_mapping = _asn1_integer_to_int_or_none(\n backend, pc.inhibitPolicyMapping\n )\n\n return x509.PolicyConstraints(\n require_explicit_policy, inhibit_policy_mapping\n )\n\n\ndef _decode_extended_key_usage(backend, sk):\n sk = backend._ffi.cast(\"Cryptography_STACK_OF_ASN1_OBJECT *\", sk)\n sk = backend._ffi.gc(sk, backend._lib.sk_ASN1_OBJECT_free)\n num = backend._lib.sk_ASN1_OBJECT_num(sk)\n ekus = []\n\n for i in range(num):\n obj = backend._lib.sk_ASN1_OBJECT_value(sk, i)\n backend.openssl_assert(obj != backend._ffi.NULL)\n oid = x509.ObjectIdentifier(_obj2txt(backend, obj))\n ekus.append(oid)\n\n return x509.ExtendedKeyUsage(ekus)\n\n\n_DISTPOINT_TYPE_FULLNAME = 0\n_DISTPOINT_TYPE_RELATIVENAME = 1\n\n\ndef _decode_dist_points(backend, cdps):\n cdps = backend._ffi.cast(\"Cryptography_STACK_OF_DIST_POINT *\", cdps)\n cdps = backend._ffi.gc(cdps, backend._lib.CRL_DIST_POINTS_free)\n\n num = backend._lib.sk_DIST_POINT_num(cdps)\n dist_points = []\n for i in range(num):\n full_name = None\n relative_name = None\n crl_issuer = None\n reasons = None\n cdp = backend._lib.sk_DIST_POINT_value(cdps, i)\n if cdp.reasons != backend._ffi.NULL:\n reasons = _decode_reasons(backend, cdp.reasons)\n\n if cdp.CRLissuer != backend._ffi.NULL:\n crl_issuer = _decode_general_names(backend, cdp.CRLissuer)\n\n # Certificates may have a crl_issuer/reasons and no distribution\n # point so make sure it's not null.\n if cdp.distpoint != backend._ffi.NULL:\n full_name, relative_name = _decode_distpoint(\n backend, cdp.distpoint\n )\n\n dist_points.append(\n x509.DistributionPoint(\n full_name, relative_name, reasons, crl_issuer\n )\n )\n\n return dist_points\n\n\n# ReasonFlags ::= BIT STRING {\n# unused (0),\n# keyCompromise (1),\n# cACompromise (2),\n# affiliationChanged (3),\n# superseded (4),\n# cessationOfOperation (5),\n# certificateHold (6),\n# privilegeWithdrawn (7),\n# aACompromise (8) }\n_REASON_BIT_MAPPING = {\n 1: x509.ReasonFlags.key_compromise,\n 2: x509.ReasonFlags.ca_compromise,\n 3: x509.ReasonFlags.affiliation_changed,\n 4: x509.ReasonFlags.superseded,\n 5: x509.ReasonFlags.cessation_of_operation,\n 6: x509.ReasonFlags.certificate_hold,\n 7: x509.ReasonFlags.privilege_withdrawn,\n 8: x509.ReasonFlags.aa_compromise,\n}\n\n\ndef _decode_reasons(backend, reasons):\n # We will check each bit from RFC 5280\n enum_reasons = []\n for bit_position, reason in six.iteritems(_REASON_BIT_MAPPING):\n if backend._lib.ASN1_BIT_STRING_get_bit(reasons, bit_position):\n enum_reasons.append(reason)\n\n return frozenset(enum_reasons)\n\n\ndef _decode_distpoint(backend, distpoint):\n if distpoint.type == _DISTPOINT_TYPE_FULLNAME:\n full_name = _decode_general_names(backend, distpoint.name.fullname)\n return full_name, None\n\n # OpenSSL code doesn't test for a specific type for\n # relativename, everything that isn't fullname is considered\n # relativename. Per RFC 5280:\n #\n # DistributionPointName ::= CHOICE {\n # fullName [0] GeneralNames,\n # nameRelativeToCRLIssuer [1] RelativeDistinguishedName }\n rns = distpoint.name.relativename\n rnum = backend._lib.sk_X509_NAME_ENTRY_num(rns)\n attributes = set()\n for i in range(rnum):\n rn = backend._lib.sk_X509_NAME_ENTRY_value(\n rns, i\n )\n backend.openssl_assert(rn != backend._ffi.NULL)\n attributes.add(\n _decode_x509_name_entry(backend, rn)\n )\n\n relative_name = x509.RelativeDistinguishedName(attributes)\n\n return None, relative_name\n\n\ndef _decode_crl_distribution_points(backend, cdps):\n dist_points = _decode_dist_points(backend, cdps)\n return x509.CRLDistributionPoints(dist_points)\n\n\ndef _decode_freshest_crl(backend, cdps):\n dist_points = _decode_dist_points(backend, cdps)\n return x509.FreshestCRL(dist_points)\n\n\ndef _decode_inhibit_any_policy(backend, asn1_int):\n asn1_int = backend._ffi.cast(\"ASN1_INTEGER *\", asn1_int)\n asn1_int = backend._ffi.gc(asn1_int, backend._lib.ASN1_INTEGER_free)\n skip_certs = _asn1_integer_to_int(backend, asn1_int)\n return x509.InhibitAnyPolicy(skip_certs)\n\n\ndef _decode_precert_signed_certificate_timestamps(backend, asn1_scts):\n from cryptography.hazmat.backends.openssl.x509 import (\n _SignedCertificateTimestamp\n )\n asn1_scts = backend._ffi.cast(\"Cryptography_STACK_OF_SCT *\", asn1_scts)\n asn1_scts = backend._ffi.gc(asn1_scts, backend._lib.SCT_LIST_free)\n\n scts = []\n for i in range(backend._lib.sk_SCT_num(asn1_scts)):\n sct = backend._lib.sk_SCT_value(asn1_scts, i)\n\n scts.append(_SignedCertificateTimestamp(backend, asn1_scts, sct))\n return x509.PrecertificateSignedCertificateTimestamps(scts)\n\n\n# CRLReason ::= ENUMERATED {\n# unspecified (0),\n# keyCompromise (1),\n# cACompromise (2),\n# affiliationChanged (3),\n# superseded (4),\n# cessationOfOperation (5),\n# certificateHold (6),\n# -- value 7 is not used\n# removeFromCRL (8),\n# privilegeWithdrawn (9),\n# aACompromise (10) }\n_CRL_ENTRY_REASON_CODE_TO_ENUM = {\n 0: x509.ReasonFlags.unspecified,\n 1: x509.ReasonFlags.key_compromise,\n 2: x509.ReasonFlags.ca_compromise,\n 3: x509.ReasonFlags.affiliation_changed,\n 4: x509.ReasonFlags.superseded,\n 5: x509.ReasonFlags.cessation_of_operation,\n 6: x509.ReasonFlags.certificate_hold,\n 8: x509.ReasonFlags.remove_from_crl,\n 9: x509.ReasonFlags.privilege_withdrawn,\n 10: x509.ReasonFlags.aa_compromise,\n}\n\n\n_CRL_ENTRY_REASON_ENUM_TO_CODE = {\n x509.ReasonFlags.unspecified: 0,\n x509.ReasonFlags.key_compromise: 1,\n x509.ReasonFlags.ca_compromise: 2,\n x509.ReasonFlags.affiliation_changed: 3,\n x509.ReasonFlags.superseded: 4,\n x509.ReasonFlags.cessation_of_operation: 5,\n x509.ReasonFlags.certificate_hold: 6,\n x509.ReasonFlags.remove_from_crl: 8,\n x509.ReasonFlags.privilege_withdrawn: 9,\n x509.ReasonFlags.aa_compromise: 10\n}\n\n\ndef _decode_crl_reason(backend, enum):\n enum = backend._ffi.cast(\"ASN1_ENUMERATED *\", enum)\n enum = backend._ffi.gc(enum, backend._lib.ASN1_ENUMERATED_free)\n code = backend._lib.ASN1_ENUMERATED_get(enum)\n\n try:\n return x509.CRLReason(_CRL_ENTRY_REASON_CODE_TO_ENUM[code])\n except KeyError:\n raise ValueError(\"Unsupported reason code: {}\".format(code))\n\n\ndef _decode_invalidity_date(backend, inv_date):\n generalized_time = backend._ffi.cast(\n \"ASN1_GENERALIZEDTIME *\", inv_date\n )\n generalized_time = backend._ffi.gc(\n generalized_time, backend._lib.ASN1_GENERALIZEDTIME_free\n )\n return x509.InvalidityDate(\n _parse_asn1_generalized_time(backend, generalized_time)\n )\n\n\ndef _decode_cert_issuer(backend, gns):\n gns = backend._ffi.cast(\"GENERAL_NAMES *\", gns)\n gns = backend._ffi.gc(gns, backend._lib.GENERAL_NAMES_free)\n general_names = _decode_general_names(backend, gns)\n return x509.CertificateIssuer(general_names)\n\n\ndef _asn1_to_der(backend, asn1_type):\n buf = backend._ffi.new(\"unsigned char **\")\n res = backend._lib.i2d_ASN1_TYPE(asn1_type, buf)\n backend.openssl_assert(res >= 0)\n backend.openssl_assert(buf[0] != backend._ffi.NULL)\n buf = backend._ffi.gc(\n buf, lambda buffer: backend._lib.OPENSSL_free(buffer[0])\n )\n return backend._ffi.buffer(buf[0], res)[:]\n\n\ndef _asn1_integer_to_int(backend, asn1_int):\n bn = backend._lib.ASN1_INTEGER_to_BN(asn1_int, backend._ffi.NULL)\n backend.openssl_assert(bn != backend._ffi.NULL)\n bn = backend._ffi.gc(bn, backend._lib.BN_free)\n return backend._bn_to_int(bn)\n\n\ndef _asn1_integer_to_int_or_none(backend, asn1_int):\n if asn1_int == backend._ffi.NULL:\n return None\n else:\n return _asn1_integer_to_int(backend, asn1_int)\n\n\ndef _asn1_string_to_bytes(backend, asn1_string):\n return backend._ffi.buffer(asn1_string.data, asn1_string.length)[:]\n\n\ndef _asn1_string_to_ascii(backend, asn1_string):\n return _asn1_string_to_bytes(backend, asn1_string).decode(\"ascii\")\n\n\ndef _asn1_string_to_utf8(backend, asn1_string):\n buf = backend._ffi.new(\"unsigned char **\")\n res = backend._lib.ASN1_STRING_to_UTF8(buf, asn1_string)\n if res == -1:\n raise ValueError(\n \"Unsupported ASN1 string type. Type: {}\".format(asn1_string.type)\n )\n\n backend.openssl_assert(buf[0] != backend._ffi.NULL)\n buf = backend._ffi.gc(\n buf, lambda buffer: backend._lib.OPENSSL_free(buffer[0])\n )\n return backend._ffi.buffer(buf[0], res)[:].decode('utf8')\n\n\ndef _parse_asn1_time(backend, asn1_time):\n backend.openssl_assert(asn1_time != backend._ffi.NULL)\n generalized_time = backend._lib.ASN1_TIME_to_generalizedtime(\n asn1_time, backend._ffi.NULL\n )\n if generalized_time == backend._ffi.NULL:\n raise ValueError(\n \"Couldn't parse ASN.1 time as generalizedtime {!r}\".format(\n _asn1_string_to_bytes(backend, asn1_time)\n )\n )\n\n generalized_time = backend._ffi.gc(\n generalized_time, backend._lib.ASN1_GENERALIZEDTIME_free\n )\n return _parse_asn1_generalized_time(backend, generalized_time)\n\n\ndef _parse_asn1_generalized_time(backend, generalized_time):\n time = _asn1_string_to_ascii(\n backend, backend._ffi.cast(\"ASN1_STRING *\", generalized_time)\n )\n return datetime.datetime.strptime(time, \"%Y%m%d%H%M%SZ\")\n\n\ndef _decode_nonce(backend, nonce):\n nonce = backend._ffi.cast(\"ASN1_OCTET_STRING *\", nonce)\n nonce = backend._ffi.gc(nonce, backend._lib.ASN1_OCTET_STRING_free)\n return x509.OCSPNonce(_asn1_string_to_bytes(backend, nonce))\n\n\n_EXTENSION_HANDLERS_NO_SCT = {\n ExtensionOID.BASIC_CONSTRAINTS: _decode_basic_constraints,\n ExtensionOID.SUBJECT_KEY_IDENTIFIER: _decode_subject_key_identifier,\n ExtensionOID.KEY_USAGE: _decode_key_usage,\n ExtensionOID.SUBJECT_ALTERNATIVE_NAME: _decode_subject_alt_name,\n ExtensionOID.EXTENDED_KEY_USAGE: _decode_extended_key_usage,\n ExtensionOID.AUTHORITY_KEY_IDENTIFIER: _decode_authority_key_identifier,\n ExtensionOID.AUTHORITY_INFORMATION_ACCESS: (\n _decode_authority_information_access\n ),\n ExtensionOID.CERTIFICATE_POLICIES: _decode_certificate_policies,\n ExtensionOID.CRL_DISTRIBUTION_POINTS: _decode_crl_distribution_points,\n ExtensionOID.FRESHEST_CRL: _decode_freshest_crl,\n ExtensionOID.OCSP_NO_CHECK: _decode_ocsp_no_check,\n ExtensionOID.INHIBIT_ANY_POLICY: _decode_inhibit_any_policy,\n ExtensionOID.ISSUER_ALTERNATIVE_NAME: _decode_issuer_alt_name,\n ExtensionOID.NAME_CONSTRAINTS: _decode_name_constraints,\n ExtensionOID.POLICY_CONSTRAINTS: _decode_policy_constraints,\n}\n_EXTENSION_HANDLERS = _EXTENSION_HANDLERS_NO_SCT.copy()\n_EXTENSION_HANDLERS[\n ExtensionOID.PRECERT_SIGNED_CERTIFICATE_TIMESTAMPS\n] = _decode_precert_signed_certificate_timestamps\n\n\n_REVOKED_EXTENSION_HANDLERS = {\n CRLEntryExtensionOID.CRL_REASON: _decode_crl_reason,\n CRLEntryExtensionOID.INVALIDITY_DATE: _decode_invalidity_date,\n CRLEntryExtensionOID.CERTIFICATE_ISSUER: _decode_cert_issuer,\n}\n\n_CRL_EXTENSION_HANDLERS = {\n ExtensionOID.CRL_NUMBER: _decode_crl_number,\n ExtensionOID.DELTA_CRL_INDICATOR: _decode_delta_crl_indicator,\n ExtensionOID.AUTHORITY_KEY_IDENTIFIER: _decode_authority_key_identifier,\n ExtensionOID.ISSUER_ALTERNATIVE_NAME: _decode_issuer_alt_name,\n ExtensionOID.AUTHORITY_INFORMATION_ACCESS: (\n _decode_authority_information_access\n ),\n ExtensionOID.ISSUING_DISTRIBUTION_POINT: _decode_issuing_dist_point,\n ExtensionOID.FRESHEST_CRL: _decode_freshest_crl,\n}\n\n_OCSP_REQ_EXTENSION_HANDLERS = {\n OCSPExtensionOID.NONCE: _decode_nonce,\n}\n\n_OCSP_BASICRESP_EXTENSION_HANDLERS = {\n OCSPExtensionOID.NONCE: _decode_nonce,\n}\n\n_CERTIFICATE_EXTENSION_PARSER_NO_SCT = _X509ExtensionParser(\n ext_count=lambda backend, x: backend._lib.X509_get_ext_count(x),\n get_ext=lambda backend, x, i: backend._lib.X509_get_ext(x, i),\n handlers=_EXTENSION_HANDLERS_NO_SCT\n)\n\n_CERTIFICATE_EXTENSION_PARSER = _X509ExtensionParser(\n ext_count=lambda backend, x: backend._lib.X509_get_ext_count(x),\n get_ext=lambda backend, x, i: backend._lib.X509_get_ext(x, i),\n handlers=_EXTENSION_HANDLERS\n)\n\n_CSR_EXTENSION_PARSER = _X509ExtensionParser(\n ext_count=lambda backend, x: backend._lib.sk_X509_EXTENSION_num(x),\n get_ext=lambda backend, x, i: backend._lib.sk_X509_EXTENSION_value(x, i),\n handlers=_EXTENSION_HANDLERS\n)\n\n_REVOKED_CERTIFICATE_EXTENSION_PARSER = _X509ExtensionParser(\n ext_count=lambda backend, x: backend._lib.X509_REVOKED_get_ext_count(x),\n get_ext=lambda backend, x, i: backend._lib.X509_REVOKED_get_ext(x, i),\n handlers=_REVOKED_EXTENSION_HANDLERS,\n)\n\n_CRL_EXTENSION_PARSER = _X509ExtensionParser(\n ext_count=lambda backend, x: backend._lib.X509_CRL_get_ext_count(x),\n get_ext=lambda backend, x, i: backend._lib.X509_CRL_get_ext(x, i),\n handlers=_CRL_EXTENSION_HANDLERS,\n)\n\n_OCSP_REQ_EXT_PARSER = _X509ExtensionParser(\n ext_count=lambda backend, x: backend._lib.OCSP_REQUEST_get_ext_count(x),\n get_ext=lambda backend, x, i: backend._lib.OCSP_REQUEST_get_ext(x, i),\n handlers=_OCSP_REQ_EXTENSION_HANDLERS,\n)\n\n_OCSP_BASICRESP_EXT_PARSER = _X509ExtensionParser(\n ext_count=lambda backend, x: backend._lib.OCSP_BASICRESP_get_ext_count(x),\n get_ext=lambda backend, x, i: backend._lib.OCSP_BASICRESP_get_ext(x, i),\n handlers=_OCSP_BASICRESP_EXTENSION_HANDLERS,\n)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/backends/openssl/dh.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nfrom cryptography import utils\nfrom cryptography.exceptions import UnsupportedAlgorithm, _Reasons\nfrom cryptography.hazmat.primitives import serialization\nfrom cryptography.hazmat.primitives.asymmetric import dh\n\n\ndef _dh_params_dup(dh_cdata, backend):\n lib = backend._lib\n ffi = backend._ffi\n\n param_cdata = lib.DHparams_dup(dh_cdata)\n backend.openssl_assert(param_cdata != ffi.NULL)\n param_cdata = ffi.gc(param_cdata, lib.DH_free)\n if lib.CRYPTOGRAPHY_OPENSSL_LESS_THAN_102:\n # In OpenSSL versions < 1.0.2 or libressl DHparams_dup don't copy q\n q = ffi.new(\"BIGNUM **\")\n lib.DH_get0_pqg(dh_cdata, ffi.NULL, q, ffi.NULL)\n q_dup = lib.BN_dup(q[0])\n res = lib.DH_set0_pqg(param_cdata, ffi.NULL, q_dup, ffi.NULL)\n backend.openssl_assert(res == 1)\n\n return param_cdata\n\n\ndef _dh_cdata_to_parameters(dh_cdata, backend):\n param_cdata = _dh_params_dup(dh_cdata, backend)\n return _DHParameters(backend, param_cdata)\n\n\n@utils.register_interface(dh.DHParametersWithSerialization)\nclass _DHParameters(object):\n def __init__(self, backend, dh_cdata):\n self._backend = backend\n self._dh_cdata = dh_cdata\n\n def parameter_numbers(self):\n p = self._backend._ffi.new(\"BIGNUM **\")\n g = self._backend._ffi.new(\"BIGNUM **\")\n q = self._backend._ffi.new(\"BIGNUM **\")\n self._backend._lib.DH_get0_pqg(self._dh_cdata, p, q, g)\n self._backend.openssl_assert(p[0] != self._backend._ffi.NULL)\n self._backend.openssl_assert(g[0] != self._backend._ffi.NULL)\n if q[0] == self._backend._ffi.NULL:\n q_val = None\n else:\n q_val = self._backend._bn_to_int(q[0])\n return dh.DHParameterNumbers(\n p=self._backend._bn_to_int(p[0]),\n g=self._backend._bn_to_int(g[0]),\n q=q_val\n )\n\n def generate_private_key(self):\n return self._backend.generate_dh_private_key(self)\n\n def parameter_bytes(self, encoding, format):\n if format is not serialization.ParameterFormat.PKCS3:\n raise ValueError(\n \"Only PKCS3 serialization is supported\"\n )\n if not self._backend._lib.Cryptography_HAS_EVP_PKEY_DHX:\n q = self._backend._ffi.new(\"BIGNUM **\")\n self._backend._lib.DH_get0_pqg(self._dh_cdata,\n self._backend._ffi.NULL,\n q,\n self._backend._ffi.NULL)\n if q[0] != self._backend._ffi.NULL:\n raise UnsupportedAlgorithm(\n \"DH X9.42 serialization is not supported\",\n _Reasons.UNSUPPORTED_SERIALIZATION)\n\n return self._backend._parameter_bytes(\n encoding,\n format,\n self._dh_cdata\n )\n\n\ndef _handle_dh_compute_key_error(errors, backend):\n lib = backend._lib\n\n backend.openssl_assert(\n errors[0]._lib_reason_match(\n lib.ERR_LIB_DH, lib.DH_R_INVALID_PUBKEY\n )\n )\n\n raise ValueError(\"Public key value is invalid for this exchange.\")\n\n\ndef _get_dh_num_bits(backend, dh_cdata):\n p = backend._ffi.new(\"BIGNUM **\")\n backend._lib.DH_get0_pqg(dh_cdata, p,\n backend._ffi.NULL,\n backend._ffi.NULL)\n backend.openssl_assert(p[0] != backend._ffi.NULL)\n return backend._lib.BN_num_bits(p[0])\n\n\n@utils.register_interface(dh.DHPrivateKeyWithSerialization)\nclass _DHPrivateKey(object):\n def __init__(self, backend, dh_cdata, evp_pkey):\n self._backend = backend\n self._dh_cdata = dh_cdata\n self._evp_pkey = evp_pkey\n self._key_size_bytes = self._backend._lib.DH_size(dh_cdata)\n\n @property\n def key_size(self):\n return _get_dh_num_bits(self._backend, self._dh_cdata)\n\n def private_numbers(self):\n p = self._backend._ffi.new(\"BIGNUM **\")\n g = self._backend._ffi.new(\"BIGNUM **\")\n q = self._backend._ffi.new(\"BIGNUM **\")\n self._backend._lib.DH_get0_pqg(self._dh_cdata, p, q, g)\n self._backend.openssl_assert(p[0] != self._backend._ffi.NULL)\n self._backend.openssl_assert(g[0] != self._backend._ffi.NULL)\n if q[0] == self._backend._ffi.NULL:\n q_val = None\n else:\n q_val = self._backend._bn_to_int(q[0])\n pub_key = self._backend._ffi.new(\"BIGNUM **\")\n priv_key = self._backend._ffi.new(\"BIGNUM **\")\n self._backend._lib.DH_get0_key(self._dh_cdata, pub_key, priv_key)\n self._backend.openssl_assert(pub_key[0] != self._backend._ffi.NULL)\n self._backend.openssl_assert(priv_key[0] != self._backend._ffi.NULL)\n return dh.DHPrivateNumbers(\n public_numbers=dh.DHPublicNumbers(\n parameter_numbers=dh.DHParameterNumbers(\n p=self._backend._bn_to_int(p[0]),\n g=self._backend._bn_to_int(g[0]),\n q=q_val\n ),\n y=self._backend._bn_to_int(pub_key[0])\n ),\n x=self._backend._bn_to_int(priv_key[0])\n )\n\n def exchange(self, peer_public_key):\n\n buf = self._backend._ffi.new(\"unsigned char[]\", self._key_size_bytes)\n pub_key = self._backend._ffi.new(\"BIGNUM **\")\n self._backend._lib.DH_get0_key(peer_public_key._dh_cdata, pub_key,\n self._backend._ffi.NULL)\n self._backend.openssl_assert(pub_key[0] != self._backend._ffi.NULL)\n res = self._backend._lib.DH_compute_key(\n buf,\n pub_key[0],\n self._dh_cdata\n )\n\n if res == -1:\n errors = self._backend._consume_errors()\n return _handle_dh_compute_key_error(errors, self._backend)\n else:\n self._backend.openssl_assert(res >= 1)\n\n key = self._backend._ffi.buffer(buf)[:res]\n pad = self._key_size_bytes - len(key)\n\n if pad > 0:\n key = (b\"\\x00\" * pad) + key\n\n return key\n\n def public_key(self):\n dh_cdata = _dh_params_dup(self._dh_cdata, self._backend)\n pub_key = self._backend._ffi.new(\"BIGNUM **\")\n self._backend._lib.DH_get0_key(self._dh_cdata,\n pub_key, self._backend._ffi.NULL)\n self._backend.openssl_assert(pub_key[0] != self._backend._ffi.NULL)\n pub_key_dup = self._backend._lib.BN_dup(pub_key[0])\n self._backend.openssl_assert(pub_key_dup != self._backend._ffi.NULL)\n\n res = self._backend._lib.DH_set0_key(dh_cdata,\n pub_key_dup,\n self._backend._ffi.NULL)\n self._backend.openssl_assert(res == 1)\n evp_pkey = self._backend._dh_cdata_to_evp_pkey(dh_cdata)\n return _DHPublicKey(self._backend, dh_cdata, evp_pkey)\n\n def parameters(self):\n return _dh_cdata_to_parameters(self._dh_cdata, self._backend)\n\n def private_bytes(self, encoding, format, encryption_algorithm):\n if format is not serialization.PrivateFormat.PKCS8:\n raise ValueError(\n \"DH private keys support only PKCS8 serialization\"\n )\n if not self._backend._lib.Cryptography_HAS_EVP_PKEY_DHX:\n q = self._backend._ffi.new(\"BIGNUM **\")\n self._backend._lib.DH_get0_pqg(self._dh_cdata,\n self._backend._ffi.NULL,\n q,\n self._backend._ffi.NULL)\n if q[0] != self._backend._ffi.NULL:\n raise UnsupportedAlgorithm(\n \"DH X9.42 serialization is not supported\",\n _Reasons.UNSUPPORTED_SERIALIZATION)\n\n return self._backend._private_key_bytes(\n encoding,\n format,\n encryption_algorithm,\n self._evp_pkey,\n self._dh_cdata\n )\n\n\n@utils.register_interface(dh.DHPublicKeyWithSerialization)\nclass _DHPublicKey(object):\n def __init__(self, backend, dh_cdata, evp_pkey):\n self._backend = backend\n self._dh_cdata = dh_cdata\n self._evp_pkey = evp_pkey\n self._key_size_bits = _get_dh_num_bits(self._backend, self._dh_cdata)\n\n @property\n def key_size(self):\n return self._key_size_bits\n\n def public_numbers(self):\n p = self._backend._ffi.new(\"BIGNUM **\")\n g = self._backend._ffi.new(\"BIGNUM **\")\n q = self._backend._ffi.new(\"BIGNUM **\")\n self._backend._lib.DH_get0_pqg(self._dh_cdata, p, q, g)\n self._backend.openssl_assert(p[0] != self._backend._ffi.NULL)\n self._backend.openssl_assert(g[0] != self._backend._ffi.NULL)\n if q[0] == self._backend._ffi.NULL:\n q_val = None\n else:\n q_val = self._backend._bn_to_int(q[0])\n pub_key = self._backend._ffi.new(\"BIGNUM **\")\n self._backend._lib.DH_get0_key(self._dh_cdata,\n pub_key, self._backend._ffi.NULL)\n self._backend.openssl_assert(pub_key[0] != self._backend._ffi.NULL)\n return dh.DHPublicNumbers(\n parameter_numbers=dh.DHParameterNumbers(\n p=self._backend._bn_to_int(p[0]),\n g=self._backend._bn_to_int(g[0]),\n q=q_val\n ),\n y=self._backend._bn_to_int(pub_key[0])\n )\n\n def parameters(self):\n return _dh_cdata_to_parameters(self._dh_cdata, self._backend)\n\n def public_bytes(self, encoding, format):\n if format is not serialization.PublicFormat.SubjectPublicKeyInfo:\n raise ValueError(\n \"DH public keys support only \"\n \"SubjectPublicKeyInfo serialization\"\n )\n\n if not self._backend._lib.Cryptography_HAS_EVP_PKEY_DHX:\n q = self._backend._ffi.new(\"BIGNUM **\")\n self._backend._lib.DH_get0_pqg(self._dh_cdata,\n self._backend._ffi.NULL,\n q,\n self._backend._ffi.NULL)\n if q[0] != self._backend._ffi.NULL:\n raise UnsupportedAlgorithm(\n \"DH X9.42 serialization is not supported\",\n _Reasons.UNSUPPORTED_SERIALIZATION)\n\n return self._backend._public_key_bytes(\n encoding,\n format,\n self,\n self._evp_pkey,\n None\n )\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/backends/openssl/dsa.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nfrom cryptography import utils\nfrom cryptography.exceptions import InvalidSignature\nfrom cryptography.hazmat.backends.openssl.utils import (\n _calculate_digest_and_algorithm, _check_not_prehashed,\n _warn_sign_verify_deprecated\n)\nfrom cryptography.hazmat.primitives import hashes, serialization\nfrom cryptography.hazmat.primitives.asymmetric import (\n AsymmetricSignatureContext, AsymmetricVerificationContext, dsa\n)\n\n\ndef _dsa_sig_sign(backend, private_key, data):\n sig_buf_len = backend._lib.DSA_size(private_key._dsa_cdata)\n sig_buf = backend._ffi.new(\"unsigned char[]\", sig_buf_len)\n buflen = backend._ffi.new(\"unsigned int *\")\n\n # The first parameter passed to DSA_sign is unused by OpenSSL but\n # must be an integer.\n res = backend._lib.DSA_sign(\n 0, data, len(data), sig_buf, buflen, private_key._dsa_cdata\n )\n backend.openssl_assert(res == 1)\n backend.openssl_assert(buflen[0])\n\n return backend._ffi.buffer(sig_buf)[:buflen[0]]\n\n\ndef _dsa_sig_verify(backend, public_key, signature, data):\n # The first parameter passed to DSA_verify is unused by OpenSSL but\n # must be an integer.\n res = backend._lib.DSA_verify(\n 0, data, len(data), signature, len(signature), public_key._dsa_cdata\n )\n\n if res != 1:\n backend._consume_errors()\n raise InvalidSignature\n\n\n@utils.register_interface(AsymmetricVerificationContext)\nclass _DSAVerificationContext(object):\n def __init__(self, backend, public_key, signature, algorithm):\n self._backend = backend\n self._public_key = public_key\n self._signature = signature\n self._algorithm = algorithm\n\n self._hash_ctx = hashes.Hash(self._algorithm, self._backend)\n\n def update(self, data):\n self._hash_ctx.update(data)\n\n def verify(self):\n data_to_verify = self._hash_ctx.finalize()\n\n _dsa_sig_verify(\n self._backend, self._public_key, self._signature, data_to_verify\n )\n\n\n@utils.register_interface(AsymmetricSignatureContext)\nclass _DSASignatureContext(object):\n def __init__(self, backend, private_key, algorithm):\n self._backend = backend\n self._private_key = private_key\n self._algorithm = algorithm\n self._hash_ctx = hashes.Hash(self._algorithm, self._backend)\n\n def update(self, data):\n self._hash_ctx.update(data)\n\n def finalize(self):\n data_to_sign = self._hash_ctx.finalize()\n return _dsa_sig_sign(self._backend, self._private_key, data_to_sign)\n\n\n@utils.register_interface(dsa.DSAParametersWithNumbers)\nclass _DSAParameters(object):\n def __init__(self, backend, dsa_cdata):\n self._backend = backend\n self._dsa_cdata = dsa_cdata\n\n def parameter_numbers(self):\n p = self._backend._ffi.new(\"BIGNUM **\")\n q = self._backend._ffi.new(\"BIGNUM **\")\n g = self._backend._ffi.new(\"BIGNUM **\")\n self._backend._lib.DSA_get0_pqg(self._dsa_cdata, p, q, g)\n self._backend.openssl_assert(p[0] != self._backend._ffi.NULL)\n self._backend.openssl_assert(q[0] != self._backend._ffi.NULL)\n self._backend.openssl_assert(g[0] != self._backend._ffi.NULL)\n return dsa.DSAParameterNumbers(\n p=self._backend._bn_to_int(p[0]),\n q=self._backend._bn_to_int(q[0]),\n g=self._backend._bn_to_int(g[0])\n )\n\n def generate_private_key(self):\n return self._backend.generate_dsa_private_key(self)\n\n\n@utils.register_interface(dsa.DSAPrivateKeyWithSerialization)\nclass _DSAPrivateKey(object):\n def __init__(self, backend, dsa_cdata, evp_pkey):\n self._backend = backend\n self._dsa_cdata = dsa_cdata\n self._evp_pkey = evp_pkey\n\n p = self._backend._ffi.new(\"BIGNUM **\")\n self._backend._lib.DSA_get0_pqg(\n dsa_cdata, p, self._backend._ffi.NULL, self._backend._ffi.NULL\n )\n self._backend.openssl_assert(p[0] != backend._ffi.NULL)\n self._key_size = self._backend._lib.BN_num_bits(p[0])\n\n key_size = utils.read_only_property(\"_key_size\")\n\n def signer(self, signature_algorithm):\n _warn_sign_verify_deprecated()\n _check_not_prehashed(signature_algorithm)\n return _DSASignatureContext(self._backend, self, signature_algorithm)\n\n def private_numbers(self):\n p = self._backend._ffi.new(\"BIGNUM **\")\n q = self._backend._ffi.new(\"BIGNUM **\")\n g = self._backend._ffi.new(\"BIGNUM **\")\n pub_key = self._backend._ffi.new(\"BIGNUM **\")\n priv_key = self._backend._ffi.new(\"BIGNUM **\")\n self._backend._lib.DSA_get0_pqg(self._dsa_cdata, p, q, g)\n self._backend.openssl_assert(p[0] != self._backend._ffi.NULL)\n self._backend.openssl_assert(q[0] != self._backend._ffi.NULL)\n self._backend.openssl_assert(g[0] != self._backend._ffi.NULL)\n self._backend._lib.DSA_get0_key(self._dsa_cdata, pub_key, priv_key)\n self._backend.openssl_assert(pub_key[0] != self._backend._ffi.NULL)\n self._backend.openssl_assert(priv_key[0] != self._backend._ffi.NULL)\n return dsa.DSAPrivateNumbers(\n public_numbers=dsa.DSAPublicNumbers(\n parameter_numbers=dsa.DSAParameterNumbers(\n p=self._backend._bn_to_int(p[0]),\n q=self._backend._bn_to_int(q[0]),\n g=self._backend._bn_to_int(g[0])\n ),\n y=self._backend._bn_to_int(pub_key[0])\n ),\n x=self._backend._bn_to_int(priv_key[0])\n )\n\n def public_key(self):\n dsa_cdata = self._backend._lib.DSAparams_dup(self._dsa_cdata)\n self._backend.openssl_assert(dsa_cdata != self._backend._ffi.NULL)\n dsa_cdata = self._backend._ffi.gc(\n dsa_cdata, self._backend._lib.DSA_free\n )\n pub_key = self._backend._ffi.new(\"BIGNUM **\")\n self._backend._lib.DSA_get0_key(\n self._dsa_cdata, pub_key, self._backend._ffi.NULL\n )\n self._backend.openssl_assert(pub_key[0] != self._backend._ffi.NULL)\n pub_key_dup = self._backend._lib.BN_dup(pub_key[0])\n res = self._backend._lib.DSA_set0_key(\n dsa_cdata, pub_key_dup, self._backend._ffi.NULL\n )\n self._backend.openssl_assert(res == 1)\n evp_pkey = self._backend._dsa_cdata_to_evp_pkey(dsa_cdata)\n return _DSAPublicKey(self._backend, dsa_cdata, evp_pkey)\n\n def parameters(self):\n dsa_cdata = self._backend._lib.DSAparams_dup(self._dsa_cdata)\n self._backend.openssl_assert(dsa_cdata != self._backend._ffi.NULL)\n dsa_cdata = self._backend._ffi.gc(\n dsa_cdata, self._backend._lib.DSA_free\n )\n return _DSAParameters(self._backend, dsa_cdata)\n\n def private_bytes(self, encoding, format, encryption_algorithm):\n return self._backend._private_key_bytes(\n encoding,\n format,\n encryption_algorithm,\n self._evp_pkey,\n self._dsa_cdata\n )\n\n def sign(self, data, algorithm):\n data, algorithm = _calculate_digest_and_algorithm(\n self._backend, data, algorithm\n )\n return _dsa_sig_sign(self._backend, self, data)\n\n\n@utils.register_interface(dsa.DSAPublicKeyWithSerialization)\nclass _DSAPublicKey(object):\n def __init__(self, backend, dsa_cdata, evp_pkey):\n self._backend = backend\n self._dsa_cdata = dsa_cdata\n self._evp_pkey = evp_pkey\n p = self._backend._ffi.new(\"BIGNUM **\")\n self._backend._lib.DSA_get0_pqg(\n dsa_cdata, p, self._backend._ffi.NULL, self._backend._ffi.NULL\n )\n self._backend.openssl_assert(p[0] != backend._ffi.NULL)\n self._key_size = self._backend._lib.BN_num_bits(p[0])\n\n key_size = utils.read_only_property(\"_key_size\")\n\n def verifier(self, signature, signature_algorithm):\n _warn_sign_verify_deprecated()\n utils._check_bytes(\"signature\", signature)\n\n _check_not_prehashed(signature_algorithm)\n return _DSAVerificationContext(\n self._backend, self, signature, signature_algorithm\n )\n\n def public_numbers(self):\n p = self._backend._ffi.new(\"BIGNUM **\")\n q = self._backend._ffi.new(\"BIGNUM **\")\n g = self._backend._ffi.new(\"BIGNUM **\")\n pub_key = self._backend._ffi.new(\"BIGNUM **\")\n self._backend._lib.DSA_get0_pqg(self._dsa_cdata, p, q, g)\n self._backend.openssl_assert(p[0] != self._backend._ffi.NULL)\n self._backend.openssl_assert(q[0] != self._backend._ffi.NULL)\n self._backend.openssl_assert(g[0] != self._backend._ffi.NULL)\n self._backend._lib.DSA_get0_key(\n self._dsa_cdata, pub_key, self._backend._ffi.NULL\n )\n self._backend.openssl_assert(pub_key[0] != self._backend._ffi.NULL)\n return dsa.DSAPublicNumbers(\n parameter_numbers=dsa.DSAParameterNumbers(\n p=self._backend._bn_to_int(p[0]),\n q=self._backend._bn_to_int(q[0]),\n g=self._backend._bn_to_int(g[0])\n ),\n y=self._backend._bn_to_int(pub_key[0])\n )\n\n def parameters(self):\n dsa_cdata = self._backend._lib.DSAparams_dup(self._dsa_cdata)\n dsa_cdata = self._backend._ffi.gc(\n dsa_cdata, self._backend._lib.DSA_free\n )\n return _DSAParameters(self._backend, dsa_cdata)\n\n def public_bytes(self, encoding, format):\n if format is serialization.PublicFormat.PKCS1:\n raise ValueError(\n \"DSA public keys do not support PKCS1 serialization\"\n )\n\n return self._backend._public_key_bytes(\n encoding,\n format,\n self,\n self._evp_pkey,\n None\n )\n\n def verify(self, signature, data, algorithm):\n data, algorithm = _calculate_digest_and_algorithm(\n self._backend, data, algorithm\n )\n return _dsa_sig_verify(self._backend, self, signature, data)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/backends/openssl/ec.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nfrom cryptography import utils\nfrom cryptography.exceptions import (\n InvalidSignature, UnsupportedAlgorithm, _Reasons\n)\nfrom cryptography.hazmat.backends.openssl.utils import (\n _calculate_digest_and_algorithm, _check_not_prehashed,\n _warn_sign_verify_deprecated\n)\nfrom cryptography.hazmat.primitives import hashes, serialization\nfrom cryptography.hazmat.primitives.asymmetric import (\n AsymmetricSignatureContext, AsymmetricVerificationContext, ec\n)\n\n\ndef _check_signature_algorithm(signature_algorithm):\n if not isinstance(signature_algorithm, ec.ECDSA):\n raise UnsupportedAlgorithm(\n \"Unsupported elliptic curve signature algorithm.\",\n _Reasons.UNSUPPORTED_PUBLIC_KEY_ALGORITHM)\n\n\ndef _ec_key_curve_sn(backend, ec_key):\n group = backend._lib.EC_KEY_get0_group(ec_key)\n backend.openssl_assert(group != backend._ffi.NULL)\n\n nid = backend._lib.EC_GROUP_get_curve_name(group)\n # The following check is to find EC keys with unnamed curves and raise\n # an error for now.\n if nid == backend._lib.NID_undef:\n raise NotImplementedError(\n \"ECDSA keys with unnamed curves are unsupported \"\n \"at this time\"\n )\n\n # This is like the above check, but it also catches the case where you\n # explicitly encoded a curve with the same parameters as a named curve.\n # Don't do that.\n if (\n backend._lib.CRYPTOGRAPHY_OPENSSL_110_OR_GREATER and\n backend._lib.EC_GROUP_get_asn1_flag(group) == 0\n ):\n raise NotImplementedError(\n \"ECDSA keys with unnamed curves are unsupported \"\n \"at this time\"\n )\n\n curve_name = backend._lib.OBJ_nid2sn(nid)\n backend.openssl_assert(curve_name != backend._ffi.NULL)\n\n sn = backend._ffi.string(curve_name).decode('ascii')\n return sn\n\n\ndef _mark_asn1_named_ec_curve(backend, ec_cdata):\n \"\"\"\n Set the named curve flag on the EC_KEY. This causes OpenSSL to\n serialize EC keys along with their curve OID which makes\n deserialization easier.\n \"\"\"\n\n backend._lib.EC_KEY_set_asn1_flag(\n ec_cdata, backend._lib.OPENSSL_EC_NAMED_CURVE\n )\n\n\ndef _sn_to_elliptic_curve(backend, sn):\n try:\n return ec._CURVE_TYPES[sn]()\n except KeyError:\n raise UnsupportedAlgorithm(\n \"{} is not a supported elliptic curve\".format(sn),\n _Reasons.UNSUPPORTED_ELLIPTIC_CURVE\n )\n\n\ndef _ecdsa_sig_sign(backend, private_key, data):\n max_size = backend._lib.ECDSA_size(private_key._ec_key)\n backend.openssl_assert(max_size > 0)\n\n sigbuf = backend._ffi.new(\"unsigned char[]\", max_size)\n siglen_ptr = backend._ffi.new(\"unsigned int[]\", 1)\n res = backend._lib.ECDSA_sign(\n 0, data, len(data), sigbuf, siglen_ptr, private_key._ec_key\n )\n backend.openssl_assert(res == 1)\n return backend._ffi.buffer(sigbuf)[:siglen_ptr[0]]\n\n\ndef _ecdsa_sig_verify(backend, public_key, signature, data):\n res = backend._lib.ECDSA_verify(\n 0, data, len(data), signature, len(signature), public_key._ec_key\n )\n if res != 1:\n backend._consume_errors()\n raise InvalidSignature\n\n\n@utils.register_interface(AsymmetricSignatureContext)\nclass _ECDSASignatureContext(object):\n def __init__(self, backend, private_key, algorithm):\n self._backend = backend\n self._private_key = private_key\n self._digest = hashes.Hash(algorithm, backend)\n\n def update(self, data):\n self._digest.update(data)\n\n def finalize(self):\n digest = self._digest.finalize()\n\n return _ecdsa_sig_sign(self._backend, self._private_key, digest)\n\n\n@utils.register_interface(AsymmetricVerificationContext)\nclass _ECDSAVerificationContext(object):\n def __init__(self, backend, public_key, signature, algorithm):\n self._backend = backend\n self._public_key = public_key\n self._signature = signature\n self._digest = hashes.Hash(algorithm, backend)\n\n def update(self, data):\n self._digest.update(data)\n\n def verify(self):\n digest = self._digest.finalize()\n _ecdsa_sig_verify(\n self._backend, self._public_key, self._signature, digest\n )\n\n\n@utils.register_interface(ec.EllipticCurvePrivateKeyWithSerialization)\nclass _EllipticCurvePrivateKey(object):\n def __init__(self, backend, ec_key_cdata, evp_pkey):\n self._backend = backend\n self._ec_key = ec_key_cdata\n self._evp_pkey = evp_pkey\n\n sn = _ec_key_curve_sn(backend, ec_key_cdata)\n self._curve = _sn_to_elliptic_curve(backend, sn)\n _mark_asn1_named_ec_curve(backend, ec_key_cdata)\n\n curve = utils.read_only_property(\"_curve\")\n\n @property\n def key_size(self):\n return self.curve.key_size\n\n def signer(self, signature_algorithm):\n _warn_sign_verify_deprecated()\n _check_signature_algorithm(signature_algorithm)\n _check_not_prehashed(signature_algorithm.algorithm)\n return _ECDSASignatureContext(\n self._backend, self, signature_algorithm.algorithm\n )\n\n def exchange(self, algorithm, peer_public_key):\n if not (\n self._backend.elliptic_curve_exchange_algorithm_supported(\n algorithm, self.curve\n )\n ):\n raise UnsupportedAlgorithm(\n \"This backend does not support the ECDH algorithm.\",\n _Reasons.UNSUPPORTED_EXCHANGE_ALGORITHM\n )\n\n if peer_public_key.curve.name != self.curve.name:\n raise ValueError(\n \"peer_public_key and self are not on the same curve\"\n )\n\n group = self._backend._lib.EC_KEY_get0_group(self._ec_key)\n z_len = (self._backend._lib.EC_GROUP_get_degree(group) + 7) // 8\n self._backend.openssl_assert(z_len > 0)\n z_buf = self._backend._ffi.new(\"uint8_t[]\", z_len)\n peer_key = self._backend._lib.EC_KEY_get0_public_key(\n peer_public_key._ec_key\n )\n\n r = self._backend._lib.ECDH_compute_key(\n z_buf, z_len, peer_key, self._ec_key, self._backend._ffi.NULL\n )\n self._backend.openssl_assert(r > 0)\n return self._backend._ffi.buffer(z_buf)[:z_len]\n\n def public_key(self):\n group = self._backend._lib.EC_KEY_get0_group(self._ec_key)\n self._backend.openssl_assert(group != self._backend._ffi.NULL)\n\n curve_nid = self._backend._lib.EC_GROUP_get_curve_name(group)\n\n public_ec_key = self._backend._lib.EC_KEY_new_by_curve_name(curve_nid)\n self._backend.openssl_assert(public_ec_key != self._backend._ffi.NULL)\n public_ec_key = self._backend._ffi.gc(\n public_ec_key, self._backend._lib.EC_KEY_free\n )\n\n point = self._backend._lib.EC_KEY_get0_public_key(self._ec_key)\n self._backend.openssl_assert(point != self._backend._ffi.NULL)\n\n res = self._backend._lib.EC_KEY_set_public_key(public_ec_key, point)\n self._backend.openssl_assert(res == 1)\n\n evp_pkey = self._backend._ec_cdata_to_evp_pkey(public_ec_key)\n\n return _EllipticCurvePublicKey(self._backend, public_ec_key, evp_pkey)\n\n def private_numbers(self):\n bn = self._backend._lib.EC_KEY_get0_private_key(self._ec_key)\n private_value = self._backend._bn_to_int(bn)\n return ec.EllipticCurvePrivateNumbers(\n private_value=private_value,\n public_numbers=self.public_key().public_numbers()\n )\n\n def private_bytes(self, encoding, format, encryption_algorithm):\n return self._backend._private_key_bytes(\n encoding,\n format,\n encryption_algorithm,\n self._evp_pkey,\n self._ec_key\n )\n\n def sign(self, data, signature_algorithm):\n _check_signature_algorithm(signature_algorithm)\n data, algorithm = _calculate_digest_and_algorithm(\n self._backend, data, signature_algorithm._algorithm\n )\n return _ecdsa_sig_sign(self._backend, self, data)\n\n\n@utils.register_interface(ec.EllipticCurvePublicKeyWithSerialization)\nclass _EllipticCurvePublicKey(object):\n def __init__(self, backend, ec_key_cdata, evp_pkey):\n self._backend = backend\n self._ec_key = ec_key_cdata\n self._evp_pkey = evp_pkey\n\n sn = _ec_key_curve_sn(backend, ec_key_cdata)\n self._curve = _sn_to_elliptic_curve(backend, sn)\n _mark_asn1_named_ec_curve(backend, ec_key_cdata)\n\n curve = utils.read_only_property(\"_curve\")\n\n @property\n def key_size(self):\n return self.curve.key_size\n\n def verifier(self, signature, signature_algorithm):\n _warn_sign_verify_deprecated()\n utils._check_bytes(\"signature\", signature)\n\n _check_signature_algorithm(signature_algorithm)\n _check_not_prehashed(signature_algorithm.algorithm)\n return _ECDSAVerificationContext(\n self._backend, self, signature, signature_algorithm.algorithm\n )\n\n def public_numbers(self):\n get_func, group = (\n self._backend._ec_key_determine_group_get_func(self._ec_key)\n )\n point = self._backend._lib.EC_KEY_get0_public_key(self._ec_key)\n self._backend.openssl_assert(point != self._backend._ffi.NULL)\n\n with self._backend._tmp_bn_ctx() as bn_ctx:\n bn_x = self._backend._lib.BN_CTX_get(bn_ctx)\n bn_y = self._backend._lib.BN_CTX_get(bn_ctx)\n\n res = get_func(group, point, bn_x, bn_y, bn_ctx)\n self._backend.openssl_assert(res == 1)\n\n x = self._backend._bn_to_int(bn_x)\n y = self._backend._bn_to_int(bn_y)\n\n return ec.EllipticCurvePublicNumbers(\n x=x,\n y=y,\n curve=self._curve\n )\n\n def _encode_point(self, format):\n if format is serialization.PublicFormat.CompressedPoint:\n conversion = self._backend._lib.POINT_CONVERSION_COMPRESSED\n else:\n assert format is serialization.PublicFormat.UncompressedPoint\n conversion = self._backend._lib.POINT_CONVERSION_UNCOMPRESSED\n\n group = self._backend._lib.EC_KEY_get0_group(self._ec_key)\n self._backend.openssl_assert(group != self._backend._ffi.NULL)\n point = self._backend._lib.EC_KEY_get0_public_key(self._ec_key)\n self._backend.openssl_assert(point != self._backend._ffi.NULL)\n with self._backend._tmp_bn_ctx() as bn_ctx:\n buflen = self._backend._lib.EC_POINT_point2oct(\n group, point, conversion, self._backend._ffi.NULL, 0, bn_ctx\n )\n self._backend.openssl_assert(buflen > 0)\n buf = self._backend._ffi.new(\"char[]\", buflen)\n res = self._backend._lib.EC_POINT_point2oct(\n group, point, conversion, buf, buflen, bn_ctx\n )\n self._backend.openssl_assert(buflen == res)\n\n return self._backend._ffi.buffer(buf)[:]\n\n def public_bytes(self, encoding, format):\n if format is serialization.PublicFormat.PKCS1:\n raise ValueError(\n \"EC public keys do not support PKCS1 serialization\"\n )\n\n if (\n encoding is serialization.Encoding.X962 or\n format is serialization.PublicFormat.CompressedPoint or\n format is serialization.PublicFormat.UncompressedPoint\n ):\n if (\n encoding is not serialization.Encoding.X962 or\n format not in (\n serialization.PublicFormat.CompressedPoint,\n serialization.PublicFormat.UncompressedPoint\n )\n ):\n raise ValueError(\n \"X962 encoding must be used with CompressedPoint or \"\n \"UncompressedPoint format\"\n )\n\n return self._encode_point(format)\n else:\n return self._backend._public_key_bytes(\n encoding,\n format,\n self,\n self._evp_pkey,\n None\n )\n\n def verify(self, signature, data, signature_algorithm):\n _check_signature_algorithm(signature_algorithm)\n data, algorithm = _calculate_digest_and_algorithm(\n self._backend, data, signature_algorithm._algorithm\n )\n _ecdsa_sig_verify(self._backend, self, signature, data)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/backends/openssl/ed25519.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nfrom cryptography import exceptions, utils\nfrom cryptography.hazmat.primitives import serialization\nfrom cryptography.hazmat.primitives.asymmetric.ed25519 import (\n Ed25519PrivateKey, Ed25519PublicKey, _ED25519_KEY_SIZE, _ED25519_SIG_SIZE\n)\n\n\n@utils.register_interface(Ed25519PublicKey)\nclass _Ed25519PublicKey(object):\n def __init__(self, backend, evp_pkey):\n self._backend = backend\n self._evp_pkey = evp_pkey\n\n def public_bytes(self, encoding, format):\n if (\n encoding is serialization.Encoding.Raw or\n format is serialization.PublicFormat.Raw\n ):\n if (\n encoding is not serialization.Encoding.Raw or\n format is not serialization.PublicFormat.Raw\n ):\n raise ValueError(\n \"When using Raw both encoding and format must be Raw\"\n )\n\n return self._raw_public_bytes()\n\n if (\n encoding in serialization._PEM_DER and\n format is not serialization.PublicFormat.SubjectPublicKeyInfo\n ):\n raise ValueError(\n \"format must be SubjectPublicKeyInfo when encoding is PEM or \"\n \"DER\"\n )\n\n return self._backend._public_key_bytes(\n encoding, format, self, self._evp_pkey, None\n )\n\n def _raw_public_bytes(self):\n buf = self._backend._ffi.new(\"unsigned char []\", _ED25519_KEY_SIZE)\n buflen = self._backend._ffi.new(\"size_t *\", _ED25519_KEY_SIZE)\n res = self._backend._lib.EVP_PKEY_get_raw_public_key(\n self._evp_pkey, buf, buflen\n )\n self._backend.openssl_assert(res == 1)\n self._backend.openssl_assert(buflen[0] == _ED25519_KEY_SIZE)\n return self._backend._ffi.buffer(buf, _ED25519_KEY_SIZE)[:]\n\n def verify(self, signature, data):\n evp_md_ctx = self._backend._lib.Cryptography_EVP_MD_CTX_new()\n self._backend.openssl_assert(evp_md_ctx != self._backend._ffi.NULL)\n evp_md_ctx = self._backend._ffi.gc(\n evp_md_ctx, self._backend._lib.Cryptography_EVP_MD_CTX_free\n )\n res = self._backend._lib.EVP_DigestVerifyInit(\n evp_md_ctx, self._backend._ffi.NULL, self._backend._ffi.NULL,\n self._backend._ffi.NULL, self._evp_pkey\n )\n self._backend.openssl_assert(res == 1)\n res = self._backend._lib.EVP_DigestVerify(\n evp_md_ctx, signature, len(signature), data, len(data)\n )\n if res != 1:\n self._backend._consume_errors()\n raise exceptions.InvalidSignature\n\n\n@utils.register_interface(Ed25519PrivateKey)\nclass _Ed25519PrivateKey(object):\n def __init__(self, backend, evp_pkey):\n self._backend = backend\n self._evp_pkey = evp_pkey\n\n def public_key(self):\n buf = self._backend._ffi.new(\"unsigned char []\", _ED25519_KEY_SIZE)\n buflen = self._backend._ffi.new(\"size_t *\", _ED25519_KEY_SIZE)\n res = self._backend._lib.EVP_PKEY_get_raw_public_key(\n self._evp_pkey, buf, buflen\n )\n self._backend.openssl_assert(res == 1)\n self._backend.openssl_assert(buflen[0] == _ED25519_KEY_SIZE)\n public_bytes = self._backend._ffi.buffer(buf)[:]\n return self._backend.ed25519_load_public_bytes(public_bytes)\n\n def sign(self, data):\n evp_md_ctx = self._backend._lib.Cryptography_EVP_MD_CTX_new()\n self._backend.openssl_assert(evp_md_ctx != self._backend._ffi.NULL)\n evp_md_ctx = self._backend._ffi.gc(\n evp_md_ctx, self._backend._lib.Cryptography_EVP_MD_CTX_free\n )\n res = self._backend._lib.EVP_DigestSignInit(\n evp_md_ctx, self._backend._ffi.NULL, self._backend._ffi.NULL,\n self._backend._ffi.NULL, self._evp_pkey\n )\n self._backend.openssl_assert(res == 1)\n buf = self._backend._ffi.new(\"unsigned char[]\", _ED25519_SIG_SIZE)\n buflen = self._backend._ffi.new(\"size_t *\", len(buf))\n res = self._backend._lib.EVP_DigestSign(\n evp_md_ctx, buf, buflen, data, len(data)\n )\n self._backend.openssl_assert(res == 1)\n self._backend.openssl_assert(buflen[0] == _ED25519_SIG_SIZE)\n return self._backend._ffi.buffer(buf, buflen[0])[:]\n\n def private_bytes(self, encoding, format, encryption_algorithm):\n if (\n encoding is serialization.Encoding.Raw or\n format is serialization.PublicFormat.Raw\n ):\n if (\n format is not serialization.PrivateFormat.Raw or\n encoding is not serialization.Encoding.Raw or not\n isinstance(encryption_algorithm, serialization.NoEncryption)\n ):\n raise ValueError(\n \"When using Raw both encoding and format must be Raw \"\n \"and encryption_algorithm must be NoEncryption()\"\n )\n\n return self._raw_private_bytes()\n\n if (\n encoding in serialization._PEM_DER and\n format is not serialization.PrivateFormat.PKCS8\n ):\n raise ValueError(\n \"format must be PKCS8 when encoding is PEM or DER\"\n )\n\n return self._backend._private_key_bytes(\n encoding, format, encryption_algorithm, self._evp_pkey, None\n )\n\n def _raw_private_bytes(self):\n buf = self._backend._ffi.new(\"unsigned char []\", _ED25519_KEY_SIZE)\n buflen = self._backend._ffi.new(\"size_t *\", _ED25519_KEY_SIZE)\n res = self._backend._lib.EVP_PKEY_get_raw_private_key(\n self._evp_pkey, buf, buflen\n )\n self._backend.openssl_assert(res == 1)\n self._backend.openssl_assert(buflen[0] == _ED25519_KEY_SIZE)\n return self._backend._ffi.buffer(buf, _ED25519_KEY_SIZE)[:]\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/backends/openssl/ed448.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nfrom cryptography import exceptions, utils\nfrom cryptography.hazmat.primitives import serialization\nfrom cryptography.hazmat.primitives.asymmetric.ed448 import (\n Ed448PrivateKey, Ed448PublicKey\n)\n\n_ED448_KEY_SIZE = 57\n_ED448_SIG_SIZE = 114\n\n\n@utils.register_interface(Ed448PublicKey)\nclass _Ed448PublicKey(object):\n def __init__(self, backend, evp_pkey):\n self._backend = backend\n self._evp_pkey = evp_pkey\n\n def public_bytes(self, encoding, format):\n if (\n encoding is serialization.Encoding.Raw or\n format is serialization.PublicFormat.Raw\n ):\n if (\n encoding is not serialization.Encoding.Raw or\n format is not serialization.PublicFormat.Raw\n ):\n raise ValueError(\n \"When using Raw both encoding and format must be Raw\"\n )\n\n return self._raw_public_bytes()\n\n if (\n encoding in serialization._PEM_DER and\n format is not serialization.PublicFormat.SubjectPublicKeyInfo\n ):\n raise ValueError(\n \"format must be SubjectPublicKeyInfo when encoding is PEM or \"\n \"DER\"\n )\n\n return self._backend._public_key_bytes(\n encoding, format, self, self._evp_pkey, None\n )\n\n def _raw_public_bytes(self):\n buf = self._backend._ffi.new(\"unsigned char []\", _ED448_KEY_SIZE)\n buflen = self._backend._ffi.new(\"size_t *\", _ED448_KEY_SIZE)\n res = self._backend._lib.EVP_PKEY_get_raw_public_key(\n self._evp_pkey, buf, buflen\n )\n self._backend.openssl_assert(res == 1)\n self._backend.openssl_assert(buflen[0] == _ED448_KEY_SIZE)\n return self._backend._ffi.buffer(buf, _ED448_KEY_SIZE)[:]\n\n def verify(self, signature, data):\n evp_md_ctx = self._backend._lib.Cryptography_EVP_MD_CTX_new()\n self._backend.openssl_assert(evp_md_ctx != self._backend._ffi.NULL)\n evp_md_ctx = self._backend._ffi.gc(\n evp_md_ctx, self._backend._lib.Cryptography_EVP_MD_CTX_free\n )\n res = self._backend._lib.EVP_DigestVerifyInit(\n evp_md_ctx, self._backend._ffi.NULL, self._backend._ffi.NULL,\n self._backend._ffi.NULL, self._evp_pkey\n )\n self._backend.openssl_assert(res == 1)\n res = self._backend._lib.EVP_DigestVerify(\n evp_md_ctx, signature, len(signature), data, len(data)\n )\n if res != 1:\n self._backend._consume_errors()\n raise exceptions.InvalidSignature\n\n\n@utils.register_interface(Ed448PrivateKey)\nclass _Ed448PrivateKey(object):\n def __init__(self, backend, evp_pkey):\n self._backend = backend\n self._evp_pkey = evp_pkey\n\n def public_key(self):\n buf = self._backend._ffi.new(\"unsigned char []\", _ED448_KEY_SIZE)\n buflen = self._backend._ffi.new(\"size_t *\", _ED448_KEY_SIZE)\n res = self._backend._lib.EVP_PKEY_get_raw_public_key(\n self._evp_pkey, buf, buflen\n )\n self._backend.openssl_assert(res == 1)\n self._backend.openssl_assert(buflen[0] == _ED448_KEY_SIZE)\n public_bytes = self._backend._ffi.buffer(buf)[:]\n return self._backend.ed448_load_public_bytes(public_bytes)\n\n def sign(self, data):\n evp_md_ctx = self._backend._lib.Cryptography_EVP_MD_CTX_new()\n self._backend.openssl_assert(evp_md_ctx != self._backend._ffi.NULL)\n evp_md_ctx = self._backend._ffi.gc(\n evp_md_ctx, self._backend._lib.Cryptography_EVP_MD_CTX_free\n )\n res = self._backend._lib.EVP_DigestSignInit(\n evp_md_ctx, self._backend._ffi.NULL, self._backend._ffi.NULL,\n self._backend._ffi.NULL, self._evp_pkey\n )\n self._backend.openssl_assert(res == 1)\n buf = self._backend._ffi.new(\"unsigned char[]\", _ED448_SIG_SIZE)\n buflen = self._backend._ffi.new(\"size_t *\", len(buf))\n res = self._backend._lib.EVP_DigestSign(\n evp_md_ctx, buf, buflen, data, len(data)\n )\n self._backend.openssl_assert(res == 1)\n self._backend.openssl_assert(buflen[0] == _ED448_SIG_SIZE)\n return self._backend._ffi.buffer(buf, buflen[0])[:]\n\n def private_bytes(self, encoding, format, encryption_algorithm):\n if (\n encoding is serialization.Encoding.Raw or\n format is serialization.PublicFormat.Raw\n ):\n if (\n format is not serialization.PrivateFormat.Raw or\n encoding is not serialization.Encoding.Raw or not\n isinstance(encryption_algorithm, serialization.NoEncryption)\n ):\n raise ValueError(\n \"When using Raw both encoding and format must be Raw \"\n \"and encryption_algorithm must be NoEncryption()\"\n )\n\n return self._raw_private_bytes()\n\n if (\n encoding in serialization._PEM_DER and\n format is not serialization.PrivateFormat.PKCS8\n ):\n raise ValueError(\n \"format must be PKCS8 when encoding is PEM or DER\"\n )\n\n return self._backend._private_key_bytes(\n encoding, format, encryption_algorithm, self._evp_pkey, None\n )\n\n def _raw_private_bytes(self):\n buf = self._backend._ffi.new(\"unsigned char []\", _ED448_KEY_SIZE)\n buflen = self._backend._ffi.new(\"size_t *\", _ED448_KEY_SIZE)\n res = self._backend._lib.EVP_PKEY_get_raw_private_key(\n self._evp_pkey, buf, buflen\n )\n self._backend.openssl_assert(res == 1)\n self._backend.openssl_assert(buflen[0] == _ED448_KEY_SIZE)\n return self._backend._ffi.buffer(buf, _ED448_KEY_SIZE)[:]\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/backends/openssl/encode_asn1.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport calendar\nimport ipaddress\n\nimport six\n\nfrom cryptography import utils, x509\nfrom cryptography.hazmat.backends.openssl.decode_asn1 import (\n _CRL_ENTRY_REASON_ENUM_TO_CODE, _DISTPOINT_TYPE_FULLNAME,\n _DISTPOINT_TYPE_RELATIVENAME\n)\nfrom cryptography.x509.name import _ASN1Type\nfrom cryptography.x509.oid import (\n CRLEntryExtensionOID, ExtensionOID, OCSPExtensionOID,\n)\n\n\ndef _encode_asn1_int(backend, x):\n \"\"\"\n Converts a python integer to an ASN1_INTEGER. The returned ASN1_INTEGER\n will not be garbage collected (to support adding them to structs that take\n ownership of the object). Be sure to register it for GC if it will be\n discarded after use.\n\n \"\"\"\n # Convert Python integer to OpenSSL \"bignum\" in case value exceeds\n # machine's native integer limits (note: `int_to_bn` doesn't automatically\n # GC).\n i = backend._int_to_bn(x)\n i = backend._ffi.gc(i, backend._lib.BN_free)\n\n # Wrap in an ASN.1 integer. Don't GC -- as documented.\n i = backend._lib.BN_to_ASN1_INTEGER(i, backend._ffi.NULL)\n backend.openssl_assert(i != backend._ffi.NULL)\n return i\n\n\ndef _encode_asn1_int_gc(backend, x):\n i = _encode_asn1_int(backend, x)\n i = backend._ffi.gc(i, backend._lib.ASN1_INTEGER_free)\n return i\n\n\ndef _encode_asn1_str(backend, data):\n \"\"\"\n Create an ASN1_OCTET_STRING from a Python byte string.\n \"\"\"\n s = backend._lib.ASN1_OCTET_STRING_new()\n res = backend._lib.ASN1_OCTET_STRING_set(s, data, len(data))\n backend.openssl_assert(res == 1)\n return s\n\n\ndef _encode_asn1_utf8_str(backend, string):\n \"\"\"\n Create an ASN1_UTF8STRING from a Python unicode string.\n This object will be an ASN1_STRING with UTF8 type in OpenSSL and\n can be decoded with ASN1_STRING_to_UTF8.\n \"\"\"\n s = backend._lib.ASN1_UTF8STRING_new()\n res = backend._lib.ASN1_STRING_set(\n s, string.encode(\"utf8\"), len(string.encode(\"utf8\"))\n )\n backend.openssl_assert(res == 1)\n return s\n\n\ndef _encode_asn1_str_gc(backend, data):\n s = _encode_asn1_str(backend, data)\n s = backend._ffi.gc(s, backend._lib.ASN1_OCTET_STRING_free)\n return s\n\n\ndef _encode_inhibit_any_policy(backend, inhibit_any_policy):\n return _encode_asn1_int_gc(backend, inhibit_any_policy.skip_certs)\n\n\ndef _encode_name(backend, name):\n \"\"\"\n The X509_NAME created will not be gc'd. Use _encode_name_gc if needed.\n \"\"\"\n subject = backend._lib.X509_NAME_new()\n for rdn in name.rdns:\n set_flag = 0 # indicate whether to add to last RDN or create new RDN\n for attribute in rdn:\n name_entry = _encode_name_entry(backend, attribute)\n # X509_NAME_add_entry dups the object so we need to gc this copy\n name_entry = backend._ffi.gc(\n name_entry, backend._lib.X509_NAME_ENTRY_free\n )\n res = backend._lib.X509_NAME_add_entry(\n subject, name_entry, -1, set_flag)\n backend.openssl_assert(res == 1)\n set_flag = -1\n return subject\n\n\ndef _encode_name_gc(backend, attributes):\n subject = _encode_name(backend, attributes)\n subject = backend._ffi.gc(subject, backend._lib.X509_NAME_free)\n return subject\n\n\ndef _encode_sk_name_entry(backend, attributes):\n \"\"\"\n The sk_X509_NAME_ENTRY created will not be gc'd.\n \"\"\"\n stack = backend._lib.sk_X509_NAME_ENTRY_new_null()\n for attribute in attributes:\n name_entry = _encode_name_entry(backend, attribute)\n res = backend._lib.sk_X509_NAME_ENTRY_push(stack, name_entry)\n backend.openssl_assert(res >= 1)\n return stack\n\n\ndef _encode_name_entry(backend, attribute):\n if attribute._type is _ASN1Type.BMPString:\n value = attribute.value.encode('utf_16_be')\n elif attribute._type is _ASN1Type.UniversalString:\n value = attribute.value.encode('utf_32_be')\n else:\n value = attribute.value.encode('utf8')\n\n obj = _txt2obj_gc(backend, attribute.oid.dotted_string)\n\n name_entry = backend._lib.X509_NAME_ENTRY_create_by_OBJ(\n backend._ffi.NULL, obj, attribute._type.value, value, len(value)\n )\n return name_entry\n\n\ndef _encode_crl_number_delta_crl_indicator(backend, ext):\n return _encode_asn1_int_gc(backend, ext.crl_number)\n\n\ndef _encode_issuing_dist_point(backend, ext):\n idp = backend._lib.ISSUING_DIST_POINT_new()\n backend.openssl_assert(idp != backend._ffi.NULL)\n idp = backend._ffi.gc(idp, backend._lib.ISSUING_DIST_POINT_free)\n idp.onlyuser = 255 if ext.only_contains_user_certs else 0\n idp.onlyCA = 255 if ext.only_contains_ca_certs else 0\n idp.indirectCRL = 255 if ext.indirect_crl else 0\n idp.onlyattr = 255 if ext.only_contains_attribute_certs else 0\n if ext.only_some_reasons:\n idp.onlysomereasons = _encode_reasonflags(\n backend, ext.only_some_reasons\n )\n\n if ext.full_name:\n idp.distpoint = _encode_full_name(backend, ext.full_name)\n\n if ext.relative_name:\n idp.distpoint = _encode_relative_name(backend, ext.relative_name)\n\n return idp\n\n\ndef _encode_crl_reason(backend, crl_reason):\n asn1enum = backend._lib.ASN1_ENUMERATED_new()\n backend.openssl_assert(asn1enum != backend._ffi.NULL)\n asn1enum = backend._ffi.gc(asn1enum, backend._lib.ASN1_ENUMERATED_free)\n res = backend._lib.ASN1_ENUMERATED_set(\n asn1enum, _CRL_ENTRY_REASON_ENUM_TO_CODE[crl_reason.reason]\n )\n backend.openssl_assert(res == 1)\n\n return asn1enum\n\n\ndef _encode_invalidity_date(backend, invalidity_date):\n time = backend._lib.ASN1_GENERALIZEDTIME_set(\n backend._ffi.NULL, calendar.timegm(\n invalidity_date.invalidity_date.timetuple()\n )\n )\n backend.openssl_assert(time != backend._ffi.NULL)\n time = backend._ffi.gc(time, backend._lib.ASN1_GENERALIZEDTIME_free)\n\n return time\n\n\ndef _encode_certificate_policies(backend, certificate_policies):\n cp = backend._lib.sk_POLICYINFO_new_null()\n backend.openssl_assert(cp != backend._ffi.NULL)\n cp = backend._ffi.gc(cp, backend._lib.sk_POLICYINFO_free)\n for policy_info in certificate_policies:\n pi = backend._lib.POLICYINFO_new()\n backend.openssl_assert(pi != backend._ffi.NULL)\n res = backend._lib.sk_POLICYINFO_push(cp, pi)\n backend.openssl_assert(res >= 1)\n oid = _txt2obj(backend, policy_info.policy_identifier.dotted_string)\n pi.policyid = oid\n if policy_info.policy_qualifiers:\n pqis = backend._lib.sk_POLICYQUALINFO_new_null()\n backend.openssl_assert(pqis != backend._ffi.NULL)\n for qualifier in policy_info.policy_qualifiers:\n pqi = backend._lib.POLICYQUALINFO_new()\n backend.openssl_assert(pqi != backend._ffi.NULL)\n res = backend._lib.sk_POLICYQUALINFO_push(pqis, pqi)\n backend.openssl_assert(res >= 1)\n if isinstance(qualifier, six.text_type):\n pqi.pqualid = _txt2obj(\n backend, x509.OID_CPS_QUALIFIER.dotted_string\n )\n pqi.d.cpsuri = _encode_asn1_str(\n backend,\n qualifier.encode(\"ascii\"),\n )\n else:\n assert isinstance(qualifier, x509.UserNotice)\n pqi.pqualid = _txt2obj(\n backend, x509.OID_CPS_USER_NOTICE.dotted_string\n )\n un = backend._lib.USERNOTICE_new()\n backend.openssl_assert(un != backend._ffi.NULL)\n pqi.d.usernotice = un\n if qualifier.explicit_text:\n un.exptext = _encode_asn1_utf8_str(\n backend, qualifier.explicit_text\n )\n\n un.noticeref = _encode_notice_reference(\n backend, qualifier.notice_reference\n )\n\n pi.qualifiers = pqis\n\n return cp\n\n\ndef _encode_notice_reference(backend, notice):\n if notice is None:\n return backend._ffi.NULL\n else:\n nr = backend._lib.NOTICEREF_new()\n backend.openssl_assert(nr != backend._ffi.NULL)\n # organization is a required field\n nr.organization = _encode_asn1_utf8_str(backend, notice.organization)\n\n notice_stack = backend._lib.sk_ASN1_INTEGER_new_null()\n nr.noticenos = notice_stack\n for number in notice.notice_numbers:\n num = _encode_asn1_int(backend, number)\n res = backend._lib.sk_ASN1_INTEGER_push(notice_stack, num)\n backend.openssl_assert(res >= 1)\n\n return nr\n\n\ndef _txt2obj(backend, name):\n \"\"\"\n Converts a Python string with an ASN.1 object ID in dotted form to a\n ASN1_OBJECT.\n \"\"\"\n name = name.encode('ascii')\n obj = backend._lib.OBJ_txt2obj(name, 1)\n backend.openssl_assert(obj != backend._ffi.NULL)\n return obj\n\n\ndef _txt2obj_gc(backend, name):\n obj = _txt2obj(backend, name)\n obj = backend._ffi.gc(obj, backend._lib.ASN1_OBJECT_free)\n return obj\n\n\ndef _encode_ocsp_nocheck(backend, ext):\n # Doesn't need to be GC'd\n return backend._lib.ASN1_NULL_new()\n\n\ndef _encode_key_usage(backend, key_usage):\n set_bit = backend._lib.ASN1_BIT_STRING_set_bit\n ku = backend._lib.ASN1_BIT_STRING_new()\n ku = backend._ffi.gc(ku, backend._lib.ASN1_BIT_STRING_free)\n res = set_bit(ku, 0, key_usage.digital_signature)\n backend.openssl_assert(res == 1)\n res = set_bit(ku, 1, key_usage.content_commitment)\n backend.openssl_assert(res == 1)\n res = set_bit(ku, 2, key_usage.key_encipherment)\n backend.openssl_assert(res == 1)\n res = set_bit(ku, 3, key_usage.data_encipherment)\n backend.openssl_assert(res == 1)\n res = set_bit(ku, 4, key_usage.key_agreement)\n backend.openssl_assert(res == 1)\n res = set_bit(ku, 5, key_usage.key_cert_sign)\n backend.openssl_assert(res == 1)\n res = set_bit(ku, 6, key_usage.crl_sign)\n backend.openssl_assert(res == 1)\n if key_usage.key_agreement:\n res = set_bit(ku, 7, key_usage.encipher_only)\n backend.openssl_assert(res == 1)\n res = set_bit(ku, 8, key_usage.decipher_only)\n backend.openssl_assert(res == 1)\n else:\n res = set_bit(ku, 7, 0)\n backend.openssl_assert(res == 1)\n res = set_bit(ku, 8, 0)\n backend.openssl_assert(res == 1)\n\n return ku\n\n\ndef _encode_authority_key_identifier(backend, authority_keyid):\n akid = backend._lib.AUTHORITY_KEYID_new()\n backend.openssl_assert(akid != backend._ffi.NULL)\n akid = backend._ffi.gc(akid, backend._lib.AUTHORITY_KEYID_free)\n if authority_keyid.key_identifier is not None:\n akid.keyid = _encode_asn1_str(\n backend,\n authority_keyid.key_identifier,\n )\n\n if authority_keyid.authority_cert_issuer is not None:\n akid.issuer = _encode_general_names(\n backend, authority_keyid.authority_cert_issuer\n )\n\n if authority_keyid.authority_cert_serial_number is not None:\n akid.serial = _encode_asn1_int(\n backend, authority_keyid.authority_cert_serial_number\n )\n\n return akid\n\n\ndef _encode_basic_constraints(backend, basic_constraints):\n constraints = backend._lib.BASIC_CONSTRAINTS_new()\n constraints = backend._ffi.gc(\n constraints, backend._lib.BASIC_CONSTRAINTS_free\n )\n constraints.ca = 255 if basic_constraints.ca else 0\n if basic_constraints.ca and basic_constraints.path_length is not None:\n constraints.pathlen = _encode_asn1_int(\n backend, basic_constraints.path_length\n )\n\n return constraints\n\n\ndef _encode_authority_information_access(backend, authority_info_access):\n aia = backend._lib.sk_ACCESS_DESCRIPTION_new_null()\n backend.openssl_assert(aia != backend._ffi.NULL)\n aia = backend._ffi.gc(\n aia,\n lambda x: backend._lib.sk_ACCESS_DESCRIPTION_pop_free(\n x, backend._ffi.addressof(\n backend._lib._original_lib, \"ACCESS_DESCRIPTION_free\"\n )\n )\n )\n for access_description in authority_info_access:\n ad = backend._lib.ACCESS_DESCRIPTION_new()\n method = _txt2obj(\n backend, access_description.access_method.dotted_string\n )\n _encode_general_name_preallocated(\n backend, access_description.access_location, ad.location\n )\n ad.method = method\n res = backend._lib.sk_ACCESS_DESCRIPTION_push(aia, ad)\n backend.openssl_assert(res >= 1)\n\n return aia\n\n\ndef _encode_general_names(backend, names):\n general_names = backend._lib.GENERAL_NAMES_new()\n backend.openssl_assert(general_names != backend._ffi.NULL)\n for name in names:\n gn = _encode_general_name(backend, name)\n res = backend._lib.sk_GENERAL_NAME_push(general_names, gn)\n backend.openssl_assert(res != 0)\n\n return general_names\n\n\ndef _encode_alt_name(backend, san):\n general_names = _encode_general_names(backend, san)\n general_names = backend._ffi.gc(\n general_names, backend._lib.GENERAL_NAMES_free\n )\n return general_names\n\n\ndef _encode_subject_key_identifier(backend, ski):\n return _encode_asn1_str_gc(backend, ski.digest)\n\n\ndef _encode_general_name(backend, name):\n gn = backend._lib.GENERAL_NAME_new()\n _encode_general_name_preallocated(backend, name, gn)\n return gn\n\n\ndef _encode_general_name_preallocated(backend, name, gn):\n if isinstance(name, x509.DNSName):\n backend.openssl_assert(gn != backend._ffi.NULL)\n gn.type = backend._lib.GEN_DNS\n\n ia5 = backend._lib.ASN1_IA5STRING_new()\n backend.openssl_assert(ia5 != backend._ffi.NULL)\n # ia5strings are supposed to be ITU T.50 but to allow round-tripping\n # of broken certs that encode utf8 we'll encode utf8 here too.\n value = name.value.encode(\"utf8\")\n\n res = backend._lib.ASN1_STRING_set(ia5, value, len(value))\n backend.openssl_assert(res == 1)\n gn.d.dNSName = ia5\n elif isinstance(name, x509.RegisteredID):\n backend.openssl_assert(gn != backend._ffi.NULL)\n gn.type = backend._lib.GEN_RID\n obj = backend._lib.OBJ_txt2obj(\n name.value.dotted_string.encode('ascii'), 1\n )\n backend.openssl_assert(obj != backend._ffi.NULL)\n gn.d.registeredID = obj\n elif isinstance(name, x509.DirectoryName):\n backend.openssl_assert(gn != backend._ffi.NULL)\n dir_name = _encode_name(backend, name.value)\n gn.type = backend._lib.GEN_DIRNAME\n gn.d.directoryName = dir_name\n elif isinstance(name, x509.IPAddress):\n backend.openssl_assert(gn != backend._ffi.NULL)\n if isinstance(name.value, ipaddress.IPv4Network):\n packed = (\n name.value.network_address.packed +\n utils.int_to_bytes(((1 << 32) - name.value.num_addresses), 4)\n )\n elif isinstance(name.value, ipaddress.IPv6Network):\n packed = (\n name.value.network_address.packed +\n utils.int_to_bytes((1 << 128) - name.value.num_addresses, 16)\n )\n else:\n packed = name.value.packed\n ipaddr = _encode_asn1_str(backend, packed)\n gn.type = backend._lib.GEN_IPADD\n gn.d.iPAddress = ipaddr\n elif isinstance(name, x509.OtherName):\n backend.openssl_assert(gn != backend._ffi.NULL)\n other_name = backend._lib.OTHERNAME_new()\n backend.openssl_assert(other_name != backend._ffi.NULL)\n\n type_id = backend._lib.OBJ_txt2obj(\n name.type_id.dotted_string.encode('ascii'), 1\n )\n backend.openssl_assert(type_id != backend._ffi.NULL)\n data = backend._ffi.new(\"unsigned char[]\", name.value)\n data_ptr_ptr = backend._ffi.new(\"unsigned char **\")\n data_ptr_ptr[0] = data\n value = backend._lib.d2i_ASN1_TYPE(\n backend._ffi.NULL, data_ptr_ptr, len(name.value)\n )\n if value == backend._ffi.NULL:\n backend._consume_errors()\n raise ValueError(\"Invalid ASN.1 data\")\n other_name.type_id = type_id\n other_name.value = value\n gn.type = backend._lib.GEN_OTHERNAME\n gn.d.otherName = other_name\n elif isinstance(name, x509.RFC822Name):\n backend.openssl_assert(gn != backend._ffi.NULL)\n # ia5strings are supposed to be ITU T.50 but to allow round-tripping\n # of broken certs that encode utf8 we'll encode utf8 here too.\n data = name.value.encode(\"utf8\")\n asn1_str = _encode_asn1_str(backend, data)\n gn.type = backend._lib.GEN_EMAIL\n gn.d.rfc822Name = asn1_str\n elif isinstance(name, x509.UniformResourceIdentifier):\n backend.openssl_assert(gn != backend._ffi.NULL)\n # ia5strings are supposed to be ITU T.50 but to allow round-tripping\n # of broken certs that encode utf8 we'll encode utf8 here too.\n data = name.value.encode(\"utf8\")\n asn1_str = _encode_asn1_str(backend, data)\n gn.type = backend._lib.GEN_URI\n gn.d.uniformResourceIdentifier = asn1_str\n else:\n raise ValueError(\n \"{} is an unknown GeneralName type\".format(name)\n )\n\n\ndef _encode_extended_key_usage(backend, extended_key_usage):\n eku = backend._lib.sk_ASN1_OBJECT_new_null()\n eku = backend._ffi.gc(eku, backend._lib.sk_ASN1_OBJECT_free)\n for oid in extended_key_usage:\n obj = _txt2obj(backend, oid.dotted_string)\n res = backend._lib.sk_ASN1_OBJECT_push(eku, obj)\n backend.openssl_assert(res >= 1)\n\n return eku\n\n\n_CRLREASONFLAGS = {\n x509.ReasonFlags.key_compromise: 1,\n x509.ReasonFlags.ca_compromise: 2,\n x509.ReasonFlags.affiliation_changed: 3,\n x509.ReasonFlags.superseded: 4,\n x509.ReasonFlags.cessation_of_operation: 5,\n x509.ReasonFlags.certificate_hold: 6,\n x509.ReasonFlags.privilege_withdrawn: 7,\n x509.ReasonFlags.aa_compromise: 8,\n}\n\n\ndef _encode_reasonflags(backend, reasons):\n bitmask = backend._lib.ASN1_BIT_STRING_new()\n backend.openssl_assert(bitmask != backend._ffi.NULL)\n for reason in reasons:\n res = backend._lib.ASN1_BIT_STRING_set_bit(\n bitmask, _CRLREASONFLAGS[reason], 1\n )\n backend.openssl_assert(res == 1)\n\n return bitmask\n\n\ndef _encode_full_name(backend, full_name):\n dpn = backend._lib.DIST_POINT_NAME_new()\n backend.openssl_assert(dpn != backend._ffi.NULL)\n dpn.type = _DISTPOINT_TYPE_FULLNAME\n dpn.name.fullname = _encode_general_names(backend, full_name)\n return dpn\n\n\ndef _encode_relative_name(backend, relative_name):\n dpn = backend._lib.DIST_POINT_NAME_new()\n backend.openssl_assert(dpn != backend._ffi.NULL)\n dpn.type = _DISTPOINT_TYPE_RELATIVENAME\n dpn.name.relativename = _encode_sk_name_entry(backend, relative_name)\n return dpn\n\n\ndef _encode_cdps_freshest_crl(backend, cdps):\n cdp = backend._lib.sk_DIST_POINT_new_null()\n cdp = backend._ffi.gc(cdp, backend._lib.sk_DIST_POINT_free)\n for point in cdps:\n dp = backend._lib.DIST_POINT_new()\n backend.openssl_assert(dp != backend._ffi.NULL)\n\n if point.reasons:\n dp.reasons = _encode_reasonflags(backend, point.reasons)\n\n if point.full_name:\n dp.distpoint = _encode_full_name(backend, point.full_name)\n\n if point.relative_name:\n dp.distpoint = _encode_relative_name(backend, point.relative_name)\n\n if point.crl_issuer:\n dp.CRLissuer = _encode_general_names(backend, point.crl_issuer)\n\n res = backend._lib.sk_DIST_POINT_push(cdp, dp)\n backend.openssl_assert(res >= 1)\n\n return cdp\n\n\ndef _encode_name_constraints(backend, name_constraints):\n nc = backend._lib.NAME_CONSTRAINTS_new()\n backend.openssl_assert(nc != backend._ffi.NULL)\n nc = backend._ffi.gc(nc, backend._lib.NAME_CONSTRAINTS_free)\n permitted = _encode_general_subtree(\n backend, name_constraints.permitted_subtrees\n )\n nc.permittedSubtrees = permitted\n excluded = _encode_general_subtree(\n backend, name_constraints.excluded_subtrees\n )\n nc.excludedSubtrees = excluded\n\n return nc\n\n\ndef _encode_policy_constraints(backend, policy_constraints):\n pc = backend._lib.POLICY_CONSTRAINTS_new()\n backend.openssl_assert(pc != backend._ffi.NULL)\n pc = backend._ffi.gc(pc, backend._lib.POLICY_CONSTRAINTS_free)\n if policy_constraints.require_explicit_policy is not None:\n pc.requireExplicitPolicy = _encode_asn1_int(\n backend, policy_constraints.require_explicit_policy\n )\n\n if policy_constraints.inhibit_policy_mapping is not None:\n pc.inhibitPolicyMapping = _encode_asn1_int(\n backend, policy_constraints.inhibit_policy_mapping\n )\n\n return pc\n\n\ndef _encode_general_subtree(backend, subtrees):\n if subtrees is None:\n return backend._ffi.NULL\n else:\n general_subtrees = backend._lib.sk_GENERAL_SUBTREE_new_null()\n for name in subtrees:\n gs = backend._lib.GENERAL_SUBTREE_new()\n gs.base = _encode_general_name(backend, name)\n res = backend._lib.sk_GENERAL_SUBTREE_push(general_subtrees, gs)\n assert res >= 1\n\n return general_subtrees\n\n\ndef _encode_nonce(backend, nonce):\n return _encode_asn1_str_gc(backend, nonce.nonce)\n\n\n_EXTENSION_ENCODE_HANDLERS = {\n ExtensionOID.BASIC_CONSTRAINTS: _encode_basic_constraints,\n ExtensionOID.SUBJECT_KEY_IDENTIFIER: _encode_subject_key_identifier,\n ExtensionOID.KEY_USAGE: _encode_key_usage,\n ExtensionOID.SUBJECT_ALTERNATIVE_NAME: _encode_alt_name,\n ExtensionOID.ISSUER_ALTERNATIVE_NAME: _encode_alt_name,\n ExtensionOID.EXTENDED_KEY_USAGE: _encode_extended_key_usage,\n ExtensionOID.AUTHORITY_KEY_IDENTIFIER: _encode_authority_key_identifier,\n ExtensionOID.CERTIFICATE_POLICIES: _encode_certificate_policies,\n ExtensionOID.AUTHORITY_INFORMATION_ACCESS: (\n _encode_authority_information_access\n ),\n ExtensionOID.CRL_DISTRIBUTION_POINTS: _encode_cdps_freshest_crl,\n ExtensionOID.FRESHEST_CRL: _encode_cdps_freshest_crl,\n ExtensionOID.INHIBIT_ANY_POLICY: _encode_inhibit_any_policy,\n ExtensionOID.OCSP_NO_CHECK: _encode_ocsp_nocheck,\n ExtensionOID.NAME_CONSTRAINTS: _encode_name_constraints,\n ExtensionOID.POLICY_CONSTRAINTS: _encode_policy_constraints,\n}\n\n_CRL_EXTENSION_ENCODE_HANDLERS = {\n ExtensionOID.ISSUER_ALTERNATIVE_NAME: _encode_alt_name,\n ExtensionOID.AUTHORITY_KEY_IDENTIFIER: _encode_authority_key_identifier,\n ExtensionOID.AUTHORITY_INFORMATION_ACCESS: (\n _encode_authority_information_access\n ),\n ExtensionOID.CRL_NUMBER: _encode_crl_number_delta_crl_indicator,\n ExtensionOID.DELTA_CRL_INDICATOR: _encode_crl_number_delta_crl_indicator,\n ExtensionOID.ISSUING_DISTRIBUTION_POINT: _encode_issuing_dist_point,\n ExtensionOID.FRESHEST_CRL: _encode_cdps_freshest_crl,\n}\n\n_CRL_ENTRY_EXTENSION_ENCODE_HANDLERS = {\n CRLEntryExtensionOID.CERTIFICATE_ISSUER: _encode_alt_name,\n CRLEntryExtensionOID.CRL_REASON: _encode_crl_reason,\n CRLEntryExtensionOID.INVALIDITY_DATE: _encode_invalidity_date,\n}\n\n_OCSP_REQUEST_EXTENSION_ENCODE_HANDLERS = {\n OCSPExtensionOID.NONCE: _encode_nonce,\n}\n\n_OCSP_BASICRESP_EXTENSION_ENCODE_HANDLERS = {\n OCSPExtensionOID.NONCE: _encode_nonce,\n}\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/backends/openssl/hashes.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\n\nfrom cryptography import utils\nfrom cryptography.exceptions import UnsupportedAlgorithm, _Reasons\nfrom cryptography.hazmat.primitives import hashes\n\n\n@utils.register_interface(hashes.HashContext)\nclass _HashContext(object):\n def __init__(self, backend, algorithm, ctx=None):\n self._algorithm = algorithm\n\n self._backend = backend\n\n if ctx is None:\n ctx = self._backend._lib.Cryptography_EVP_MD_CTX_new()\n ctx = self._backend._ffi.gc(\n ctx, self._backend._lib.Cryptography_EVP_MD_CTX_free\n )\n evp_md = self._backend._evp_md_from_algorithm(algorithm)\n if evp_md == self._backend._ffi.NULL:\n raise UnsupportedAlgorithm(\n \"{} is not a supported hash on this backend.\".format(\n algorithm.name),\n _Reasons.UNSUPPORTED_HASH\n )\n res = self._backend._lib.EVP_DigestInit_ex(ctx, evp_md,\n self._backend._ffi.NULL)\n self._backend.openssl_assert(res != 0)\n\n self._ctx = ctx\n\n algorithm = utils.read_only_property(\"_algorithm\")\n\n def copy(self):\n copied_ctx = self._backend._lib.Cryptography_EVP_MD_CTX_new()\n copied_ctx = self._backend._ffi.gc(\n copied_ctx, self._backend._lib.Cryptography_EVP_MD_CTX_free\n )\n res = self._backend._lib.EVP_MD_CTX_copy_ex(copied_ctx, self._ctx)\n self._backend.openssl_assert(res != 0)\n return _HashContext(self._backend, self.algorithm, ctx=copied_ctx)\n\n def update(self, data):\n data_ptr = self._backend._ffi.from_buffer(data)\n res = self._backend._lib.EVP_DigestUpdate(\n self._ctx, data_ptr, len(data)\n )\n self._backend.openssl_assert(res != 0)\n\n def finalize(self):\n if isinstance(self.algorithm, hashes.ExtendableOutputFunction):\n # extendable output functions use a different finalize\n return self._finalize_xof()\n else:\n buf = self._backend._ffi.new(\"unsigned char[]\",\n self._backend._lib.EVP_MAX_MD_SIZE)\n outlen = self._backend._ffi.new(\"unsigned int *\")\n res = self._backend._lib.EVP_DigestFinal_ex(self._ctx, buf, outlen)\n self._backend.openssl_assert(res != 0)\n self._backend.openssl_assert(\n outlen[0] == self.algorithm.digest_size\n )\n return self._backend._ffi.buffer(buf)[:outlen[0]]\n\n def _finalize_xof(self):\n buf = self._backend._ffi.new(\"unsigned char[]\",\n self.algorithm.digest_size)\n res = self._backend._lib.EVP_DigestFinalXOF(\n self._ctx, buf, self.algorithm.digest_size\n )\n self._backend.openssl_assert(res != 0)\n return self._backend._ffi.buffer(buf)[:self.algorithm.digest_size]\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/backends/openssl/hmac.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\n\nfrom cryptography import utils\nfrom cryptography.exceptions import (\n InvalidSignature, UnsupportedAlgorithm, _Reasons\n)\nfrom cryptography.hazmat.primitives import constant_time, hashes\n\n\n@utils.register_interface(hashes.HashContext)\nclass _HMACContext(object):\n def __init__(self, backend, key, algorithm, ctx=None):\n self._algorithm = algorithm\n self._backend = backend\n\n if ctx is None:\n ctx = self._backend._lib.Cryptography_HMAC_CTX_new()\n self._backend.openssl_assert(ctx != self._backend._ffi.NULL)\n ctx = self._backend._ffi.gc(\n ctx, self._backend._lib.Cryptography_HMAC_CTX_free\n )\n evp_md = self._backend._evp_md_from_algorithm(algorithm)\n if evp_md == self._backend._ffi.NULL:\n raise UnsupportedAlgorithm(\n \"{} is not a supported hash on this backend\".format(\n algorithm.name),\n _Reasons.UNSUPPORTED_HASH\n )\n key_ptr = self._backend._ffi.from_buffer(key)\n res = self._backend._lib.HMAC_Init_ex(\n ctx, key_ptr, len(key), evp_md, self._backend._ffi.NULL\n )\n self._backend.openssl_assert(res != 0)\n\n self._ctx = ctx\n self._key = key\n\n algorithm = utils.read_only_property(\"_algorithm\")\n\n def copy(self):\n copied_ctx = self._backend._lib.Cryptography_HMAC_CTX_new()\n self._backend.openssl_assert(copied_ctx != self._backend._ffi.NULL)\n copied_ctx = self._backend._ffi.gc(\n copied_ctx, self._backend._lib.Cryptography_HMAC_CTX_free\n )\n res = self._backend._lib.HMAC_CTX_copy(copied_ctx, self._ctx)\n self._backend.openssl_assert(res != 0)\n return _HMACContext(\n self._backend, self._key, self.algorithm, ctx=copied_ctx\n )\n\n def update(self, data):\n data_ptr = self._backend._ffi.from_buffer(data)\n res = self._backend._lib.HMAC_Update(self._ctx, data_ptr, len(data))\n self._backend.openssl_assert(res != 0)\n\n def finalize(self):\n buf = self._backend._ffi.new(\"unsigned char[]\",\n self._backend._lib.EVP_MAX_MD_SIZE)\n outlen = self._backend._ffi.new(\"unsigned int *\")\n res = self._backend._lib.HMAC_Final(self._ctx, buf, outlen)\n self._backend.openssl_assert(res != 0)\n self._backend.openssl_assert(outlen[0] == self.algorithm.digest_size)\n return self._backend._ffi.buffer(buf)[:outlen[0]]\n\n def verify(self, signature):\n digest = self.finalize()\n if not constant_time.bytes_eq(digest, signature):\n raise InvalidSignature(\"Signature did not match digest.\")\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/backends/openssl/ocsp.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport functools\n\nfrom cryptography import utils, x509\nfrom cryptography.exceptions import UnsupportedAlgorithm\nfrom cryptography.hazmat.backends.openssl.decode_asn1 import (\n _CRL_ENTRY_REASON_CODE_TO_ENUM, _OCSP_BASICRESP_EXT_PARSER,\n _OCSP_REQ_EXT_PARSER, _asn1_integer_to_int,\n _asn1_string_to_bytes, _decode_x509_name, _obj2txt,\n _parse_asn1_generalized_time,\n)\nfrom cryptography.hazmat.backends.openssl.x509 import _Certificate\nfrom cryptography.hazmat.primitives import serialization\nfrom cryptography.x509.ocsp import (\n OCSPCertStatus, OCSPRequest, OCSPResponse, OCSPResponseStatus,\n _CERT_STATUS_TO_ENUM, _OIDS_TO_HASH, _RESPONSE_STATUS_TO_ENUM,\n)\n\n\ndef _requires_successful_response(func):\n @functools.wraps(func)\n def wrapper(self, *args):\n if self.response_status != OCSPResponseStatus.SUCCESSFUL:\n raise ValueError(\n \"OCSP response status is not successful so the property \"\n \"has no value\"\n )\n else:\n return func(self, *args)\n\n return wrapper\n\n\ndef _issuer_key_hash(backend, cert_id):\n key_hash = backend._ffi.new(\"ASN1_OCTET_STRING **\")\n res = backend._lib.OCSP_id_get0_info(\n backend._ffi.NULL, backend._ffi.NULL,\n key_hash, backend._ffi.NULL, cert_id\n )\n backend.openssl_assert(res == 1)\n backend.openssl_assert(key_hash[0] != backend._ffi.NULL)\n return _asn1_string_to_bytes(backend, key_hash[0])\n\n\ndef _issuer_name_hash(backend, cert_id):\n name_hash = backend._ffi.new(\"ASN1_OCTET_STRING **\")\n res = backend._lib.OCSP_id_get0_info(\n name_hash, backend._ffi.NULL,\n backend._ffi.NULL, backend._ffi.NULL, cert_id\n )\n backend.openssl_assert(res == 1)\n backend.openssl_assert(name_hash[0] != backend._ffi.NULL)\n return _asn1_string_to_bytes(backend, name_hash[0])\n\n\ndef _serial_number(backend, cert_id):\n num = backend._ffi.new(\"ASN1_INTEGER **\")\n res = backend._lib.OCSP_id_get0_info(\n backend._ffi.NULL, backend._ffi.NULL,\n backend._ffi.NULL, num, cert_id\n )\n backend.openssl_assert(res == 1)\n backend.openssl_assert(num[0] != backend._ffi.NULL)\n return _asn1_integer_to_int(backend, num[0])\n\n\ndef _hash_algorithm(backend, cert_id):\n asn1obj = backend._ffi.new(\"ASN1_OBJECT **\")\n res = backend._lib.OCSP_id_get0_info(\n backend._ffi.NULL, asn1obj,\n backend._ffi.NULL, backend._ffi.NULL, cert_id\n )\n backend.openssl_assert(res == 1)\n backend.openssl_assert(asn1obj[0] != backend._ffi.NULL)\n oid = _obj2txt(backend, asn1obj[0])\n try:\n return _OIDS_TO_HASH[oid]\n except KeyError:\n raise UnsupportedAlgorithm(\n \"Signature algorithm OID: {} not recognized\".format(oid)\n )\n\n\n@utils.register_interface(OCSPResponse)\nclass _OCSPResponse(object):\n def __init__(self, backend, ocsp_response):\n self._backend = backend\n self._ocsp_response = ocsp_response\n status = self._backend._lib.OCSP_response_status(self._ocsp_response)\n self._backend.openssl_assert(status in _RESPONSE_STATUS_TO_ENUM)\n self._status = _RESPONSE_STATUS_TO_ENUM[status]\n if self._status is OCSPResponseStatus.SUCCESSFUL:\n basic = self._backend._lib.OCSP_response_get1_basic(\n self._ocsp_response\n )\n self._backend.openssl_assert(basic != self._backend._ffi.NULL)\n self._basic = self._backend._ffi.gc(\n basic, self._backend._lib.OCSP_BASICRESP_free\n )\n self._backend.openssl_assert(\n self._backend._lib.OCSP_resp_count(self._basic) == 1\n )\n self._single = self._backend._lib.OCSP_resp_get0(self._basic, 0)\n self._backend.openssl_assert(\n self._single != self._backend._ffi.NULL\n )\n self._cert_id = self._backend._lib.OCSP_SINGLERESP_get0_id(\n self._single\n )\n self._backend.openssl_assert(\n self._cert_id != self._backend._ffi.NULL\n )\n\n response_status = utils.read_only_property(\"_status\")\n\n @property\n @_requires_successful_response\n def signature_algorithm_oid(self):\n alg = self._backend._lib.OCSP_resp_get0_tbs_sigalg(self._basic)\n self._backend.openssl_assert(alg != self._backend._ffi.NULL)\n oid = _obj2txt(self._backend, alg.algorithm)\n return x509.ObjectIdentifier(oid)\n\n @property\n @_requires_successful_response\n def signature_hash_algorithm(self):\n oid = self.signature_algorithm_oid\n try:\n return x509._SIG_OIDS_TO_HASH[oid]\n except KeyError:\n raise UnsupportedAlgorithm(\n \"Signature algorithm OID:{} not recognized\".format(oid)\n )\n\n @property\n @_requires_successful_response\n def signature(self):\n sig = self._backend._lib.OCSP_resp_get0_signature(self._basic)\n self._backend.openssl_assert(sig != self._backend._ffi.NULL)\n return _asn1_string_to_bytes(self._backend, sig)\n\n @property\n @_requires_successful_response\n def tbs_response_bytes(self):\n respdata = self._backend._lib.OCSP_resp_get0_respdata(self._basic)\n self._backend.openssl_assert(respdata != self._backend._ffi.NULL)\n pp = self._backend._ffi.new(\"unsigned char **\")\n res = self._backend._lib.i2d_OCSP_RESPDATA(respdata, pp)\n self._backend.openssl_assert(pp[0] != self._backend._ffi.NULL)\n pp = self._backend._ffi.gc(\n pp, lambda pointer: self._backend._lib.OPENSSL_free(pointer[0])\n )\n self._backend.openssl_assert(res > 0)\n return self._backend._ffi.buffer(pp[0], res)[:]\n\n @property\n @_requires_successful_response\n def certificates(self):\n sk_x509 = self._backend._lib.OCSP_resp_get0_certs(self._basic)\n num = self._backend._lib.sk_X509_num(sk_x509)\n certs = []\n for i in range(num):\n x509 = self._backend._lib.sk_X509_value(sk_x509, i)\n self._backend.openssl_assert(x509 != self._backend._ffi.NULL)\n cert = _Certificate(self._backend, x509)\n # We need to keep the OCSP response that the certificate came from\n # alive until the Certificate object itself goes out of scope, so\n # we give it a private reference.\n cert._ocsp_resp = self\n certs.append(cert)\n\n return certs\n\n @property\n @_requires_successful_response\n def responder_key_hash(self):\n _, asn1_string = self._responder_key_name()\n if asn1_string == self._backend._ffi.NULL:\n return None\n else:\n return _asn1_string_to_bytes(self._backend, asn1_string)\n\n @property\n @_requires_successful_response\n def responder_name(self):\n x509_name, _ = self._responder_key_name()\n if x509_name == self._backend._ffi.NULL:\n return None\n else:\n return _decode_x509_name(self._backend, x509_name)\n\n def _responder_key_name(self):\n asn1_string = self._backend._ffi.new(\"ASN1_OCTET_STRING **\")\n x509_name = self._backend._ffi.new(\"X509_NAME **\")\n res = self._backend._lib.OCSP_resp_get0_id(\n self._basic, asn1_string, x509_name\n )\n self._backend.openssl_assert(res == 1)\n return x509_name[0], asn1_string[0]\n\n @property\n @_requires_successful_response\n def produced_at(self):\n produced_at = self._backend._lib.OCSP_resp_get0_produced_at(\n self._basic\n )\n return _parse_asn1_generalized_time(self._backend, produced_at)\n\n @property\n @_requires_successful_response\n def certificate_status(self):\n status = self._backend._lib.OCSP_single_get0_status(\n self._single,\n self._backend._ffi.NULL,\n self._backend._ffi.NULL,\n self._backend._ffi.NULL,\n self._backend._ffi.NULL,\n )\n self._backend.openssl_assert(status in _CERT_STATUS_TO_ENUM)\n return _CERT_STATUS_TO_ENUM[status]\n\n @property\n @_requires_successful_response\n def revocation_time(self):\n if self.certificate_status is not OCSPCertStatus.REVOKED:\n return None\n\n asn1_time = self._backend._ffi.new(\"ASN1_GENERALIZEDTIME **\")\n self._backend._lib.OCSP_single_get0_status(\n self._single,\n self._backend._ffi.NULL,\n asn1_time,\n self._backend._ffi.NULL,\n self._backend._ffi.NULL,\n )\n self._backend.openssl_assert(asn1_time[0] != self._backend._ffi.NULL)\n return _parse_asn1_generalized_time(self._backend, asn1_time[0])\n\n @property\n @_requires_successful_response\n def revocation_reason(self):\n if self.certificate_status is not OCSPCertStatus.REVOKED:\n return None\n\n reason_ptr = self._backend._ffi.new(\"int *\")\n self._backend._lib.OCSP_single_get0_status(\n self._single,\n reason_ptr,\n self._backend._ffi.NULL,\n self._backend._ffi.NULL,\n self._backend._ffi.NULL,\n )\n # If no reason is encoded OpenSSL returns -1\n if reason_ptr[0] == -1:\n return None\n else:\n self._backend.openssl_assert(\n reason_ptr[0] in _CRL_ENTRY_REASON_CODE_TO_ENUM\n )\n return _CRL_ENTRY_REASON_CODE_TO_ENUM[reason_ptr[0]]\n\n @property\n @_requires_successful_response\n def this_update(self):\n asn1_time = self._backend._ffi.new(\"ASN1_GENERALIZEDTIME **\")\n self._backend._lib.OCSP_single_get0_status(\n self._single,\n self._backend._ffi.NULL,\n self._backend._ffi.NULL,\n asn1_time,\n self._backend._ffi.NULL,\n )\n self._backend.openssl_assert(asn1_time[0] != self._backend._ffi.NULL)\n return _parse_asn1_generalized_time(self._backend, asn1_time[0])\n\n @property\n @_requires_successful_response\n def next_update(self):\n asn1_time = self._backend._ffi.new(\"ASN1_GENERALIZEDTIME **\")\n self._backend._lib.OCSP_single_get0_status(\n self._single,\n self._backend._ffi.NULL,\n self._backend._ffi.NULL,\n self._backend._ffi.NULL,\n asn1_time,\n )\n if asn1_time[0] != self._backend._ffi.NULL:\n return _parse_asn1_generalized_time(self._backend, asn1_time[0])\n else:\n return None\n\n @property\n @_requires_successful_response\n def issuer_key_hash(self):\n return _issuer_key_hash(self._backend, self._cert_id)\n\n @property\n @_requires_successful_response\n def issuer_name_hash(self):\n return _issuer_name_hash(self._backend, self._cert_id)\n\n @property\n @_requires_successful_response\n def hash_algorithm(self):\n return _hash_algorithm(self._backend, self._cert_id)\n\n @property\n @_requires_successful_response\n def serial_number(self):\n return _serial_number(self._backend, self._cert_id)\n\n @utils.cached_property\n @_requires_successful_response\n def extensions(self):\n return _OCSP_BASICRESP_EXT_PARSER.parse(self._backend, self._basic)\n\n def public_bytes(self, encoding):\n if encoding is not serialization.Encoding.DER:\n raise ValueError(\n \"The only allowed encoding value is Encoding.DER\"\n )\n\n bio = self._backend._create_mem_bio_gc()\n res = self._backend._lib.i2d_OCSP_RESPONSE_bio(\n bio, self._ocsp_response\n )\n self._backend.openssl_assert(res > 0)\n return self._backend._read_mem_bio(bio)\n\n\n@utils.register_interface(OCSPRequest)\nclass _OCSPRequest(object):\n def __init__(self, backend, ocsp_request):\n if backend._lib.OCSP_request_onereq_count(ocsp_request) > 1:\n raise NotImplementedError(\n 'OCSP request contains more than one request'\n )\n self._backend = backend\n self._ocsp_request = ocsp_request\n self._request = self._backend._lib.OCSP_request_onereq_get0(\n self._ocsp_request, 0\n )\n self._backend.openssl_assert(self._request != self._backend._ffi.NULL)\n self._cert_id = self._backend._lib.OCSP_onereq_get0_id(self._request)\n self._backend.openssl_assert(self._cert_id != self._backend._ffi.NULL)\n\n @property\n def issuer_key_hash(self):\n return _issuer_key_hash(self._backend, self._cert_id)\n\n @property\n def issuer_name_hash(self):\n return _issuer_name_hash(self._backend, self._cert_id)\n\n @property\n def serial_number(self):\n return _serial_number(self._backend, self._cert_id)\n\n @property\n def hash_algorithm(self):\n return _hash_algorithm(self._backend, self._cert_id)\n\n @utils.cached_property\n def extensions(self):\n return _OCSP_REQ_EXT_PARSER.parse(self._backend, self._ocsp_request)\n\n def public_bytes(self, encoding):\n if encoding is not serialization.Encoding.DER:\n raise ValueError(\n \"The only allowed encoding value is Encoding.DER\"\n )\n\n bio = self._backend._create_mem_bio_gc()\n res = self._backend._lib.i2d_OCSP_REQUEST_bio(bio, self._ocsp_request)\n self._backend.openssl_assert(res > 0)\n return self._backend._read_mem_bio(bio)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/backends/openssl/poly1305.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\n\nfrom cryptography.exceptions import InvalidSignature\nfrom cryptography.hazmat.primitives import constant_time\n\n\n_POLY1305_TAG_SIZE = 16\n_POLY1305_KEY_SIZE = 32\n\n\nclass _Poly1305Context(object):\n def __init__(self, backend, key):\n self._backend = backend\n\n key_ptr = self._backend._ffi.from_buffer(key)\n # This function copies the key into OpenSSL-owned memory so we don't\n # need to retain it ourselves\n evp_pkey = self._backend._lib.EVP_PKEY_new_raw_private_key(\n self._backend._lib.NID_poly1305,\n self._backend._ffi.NULL, key_ptr, len(key)\n )\n self._backend.openssl_assert(evp_pkey != self._backend._ffi.NULL)\n self._evp_pkey = self._backend._ffi.gc(\n evp_pkey, self._backend._lib.EVP_PKEY_free\n )\n ctx = self._backend._lib.Cryptography_EVP_MD_CTX_new()\n self._backend.openssl_assert(ctx != self._backend._ffi.NULL)\n self._ctx = self._backend._ffi.gc(\n ctx, self._backend._lib.Cryptography_EVP_MD_CTX_free\n )\n res = self._backend._lib.EVP_DigestSignInit(\n self._ctx, self._backend._ffi.NULL, self._backend._ffi.NULL,\n self._backend._ffi.NULL, self._evp_pkey\n )\n self._backend.openssl_assert(res == 1)\n\n def update(self, data):\n data_ptr = self._backend._ffi.from_buffer(data)\n res = self._backend._lib.EVP_DigestSignUpdate(\n self._ctx, data_ptr, len(data)\n )\n self._backend.openssl_assert(res != 0)\n\n def finalize(self):\n buf = self._backend._ffi.new(\"unsigned char[]\", _POLY1305_TAG_SIZE)\n outlen = self._backend._ffi.new(\"size_t *\")\n res = self._backend._lib.EVP_DigestSignFinal(self._ctx, buf, outlen)\n self._backend.openssl_assert(res != 0)\n self._backend.openssl_assert(outlen[0] == _POLY1305_TAG_SIZE)\n return self._backend._ffi.buffer(buf)[:outlen[0]]\n\n def verify(self, tag):\n mac = self.finalize()\n if not constant_time.bytes_eq(mac, tag):\n raise InvalidSignature(\"Value did not match computed tag.\")\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/backends/openssl/rsa.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport math\n\nfrom cryptography import utils\nfrom cryptography.exceptions import (\n InvalidSignature, UnsupportedAlgorithm, _Reasons\n)\nfrom cryptography.hazmat.backends.openssl.utils import (\n _calculate_digest_and_algorithm, _check_not_prehashed,\n _warn_sign_verify_deprecated\n)\nfrom cryptography.hazmat.primitives import hashes\nfrom cryptography.hazmat.primitives.asymmetric import (\n AsymmetricSignatureContext, AsymmetricVerificationContext, rsa\n)\nfrom cryptography.hazmat.primitives.asymmetric.padding import (\n AsymmetricPadding, MGF1, OAEP, PKCS1v15, PSS, calculate_max_pss_salt_length\n)\nfrom cryptography.hazmat.primitives.asymmetric.rsa import (\n RSAPrivateKeyWithSerialization, RSAPublicKeyWithSerialization\n)\n\n\ndef _get_rsa_pss_salt_length(pss, key, hash_algorithm):\n salt = pss._salt_length\n\n if salt is MGF1.MAX_LENGTH or salt is PSS.MAX_LENGTH:\n return calculate_max_pss_salt_length(key, hash_algorithm)\n else:\n return salt\n\n\ndef _enc_dec_rsa(backend, key, data, padding):\n if not isinstance(padding, AsymmetricPadding):\n raise TypeError(\"Padding must be an instance of AsymmetricPadding.\")\n\n if isinstance(padding, PKCS1v15):\n padding_enum = backend._lib.RSA_PKCS1_PADDING\n elif isinstance(padding, OAEP):\n padding_enum = backend._lib.RSA_PKCS1_OAEP_PADDING\n\n if not isinstance(padding._mgf, MGF1):\n raise UnsupportedAlgorithm(\n \"Only MGF1 is supported by this backend.\",\n _Reasons.UNSUPPORTED_MGF\n )\n\n if not backend.rsa_padding_supported(padding):\n raise UnsupportedAlgorithm(\n \"This combination of padding and hash algorithm is not \"\n \"supported by this backend.\",\n _Reasons.UNSUPPORTED_PADDING\n )\n\n else:\n raise UnsupportedAlgorithm(\n \"{} is not supported by this backend.\".format(\n padding.name\n ),\n _Reasons.UNSUPPORTED_PADDING\n )\n\n return _enc_dec_rsa_pkey_ctx(backend, key, data, padding_enum, padding)\n\n\ndef _enc_dec_rsa_pkey_ctx(backend, key, data, padding_enum, padding):\n if isinstance(key, _RSAPublicKey):\n init = backend._lib.EVP_PKEY_encrypt_init\n crypt = backend._lib.EVP_PKEY_encrypt\n else:\n init = backend._lib.EVP_PKEY_decrypt_init\n crypt = backend._lib.EVP_PKEY_decrypt\n\n pkey_ctx = backend._lib.EVP_PKEY_CTX_new(\n key._evp_pkey, backend._ffi.NULL\n )\n backend.openssl_assert(pkey_ctx != backend._ffi.NULL)\n pkey_ctx = backend._ffi.gc(pkey_ctx, backend._lib.EVP_PKEY_CTX_free)\n res = init(pkey_ctx)\n backend.openssl_assert(res == 1)\n res = backend._lib.EVP_PKEY_CTX_set_rsa_padding(\n pkey_ctx, padding_enum)\n backend.openssl_assert(res > 0)\n buf_size = backend._lib.EVP_PKEY_size(key._evp_pkey)\n backend.openssl_assert(buf_size > 0)\n if (\n isinstance(padding, OAEP) and\n backend._lib.Cryptography_HAS_RSA_OAEP_MD\n ):\n mgf1_md = backend._evp_md_non_null_from_algorithm(\n padding._mgf._algorithm)\n res = backend._lib.EVP_PKEY_CTX_set_rsa_mgf1_md(pkey_ctx, mgf1_md)\n backend.openssl_assert(res > 0)\n oaep_md = backend._evp_md_non_null_from_algorithm(padding._algorithm)\n res = backend._lib.EVP_PKEY_CTX_set_rsa_oaep_md(pkey_ctx, oaep_md)\n backend.openssl_assert(res > 0)\n\n if (\n isinstance(padding, OAEP) and\n padding._label is not None and\n len(padding._label) > 0\n ):\n # set0_rsa_oaep_label takes ownership of the char * so we need to\n # copy it into some new memory\n labelptr = backend._lib.OPENSSL_malloc(len(padding._label))\n backend.openssl_assert(labelptr != backend._ffi.NULL)\n backend._ffi.memmove(labelptr, padding._label, len(padding._label))\n res = backend._lib.EVP_PKEY_CTX_set0_rsa_oaep_label(\n pkey_ctx, labelptr, len(padding._label)\n )\n backend.openssl_assert(res == 1)\n\n outlen = backend._ffi.new(\"size_t *\", buf_size)\n buf = backend._ffi.new(\"unsigned char[]\", buf_size)\n res = crypt(pkey_ctx, buf, outlen, data, len(data))\n if res <= 0:\n _handle_rsa_enc_dec_error(backend, key)\n\n return backend._ffi.buffer(buf)[:outlen[0]]\n\n\ndef _handle_rsa_enc_dec_error(backend, key):\n errors = backend._consume_errors()\n backend.openssl_assert(errors)\n backend.openssl_assert(errors[0].lib == backend._lib.ERR_LIB_RSA)\n if isinstance(key, _RSAPublicKey):\n backend.openssl_assert(\n errors[0].reason == backend._lib.RSA_R_DATA_TOO_LARGE_FOR_KEY_SIZE\n )\n raise ValueError(\n \"Data too long for key size. Encrypt less data or use a \"\n \"larger key size.\"\n )\n else:\n decoding_errors = [\n backend._lib.RSA_R_BLOCK_TYPE_IS_NOT_01,\n backend._lib.RSA_R_BLOCK_TYPE_IS_NOT_02,\n backend._lib.RSA_R_OAEP_DECODING_ERROR,\n # Though this error looks similar to the\n # RSA_R_DATA_TOO_LARGE_FOR_KEY_SIZE, this occurs on decrypts,\n # rather than on encrypts\n backend._lib.RSA_R_DATA_TOO_LARGE_FOR_MODULUS,\n ]\n if backend._lib.Cryptography_HAS_RSA_R_PKCS_DECODING_ERROR:\n decoding_errors.append(backend._lib.RSA_R_PKCS_DECODING_ERROR)\n\n backend.openssl_assert(errors[0].reason in decoding_errors)\n raise ValueError(\"Decryption failed.\")\n\n\ndef _rsa_sig_determine_padding(backend, key, padding, algorithm):\n if not isinstance(padding, AsymmetricPadding):\n raise TypeError(\"Expected provider of AsymmetricPadding.\")\n\n pkey_size = backend._lib.EVP_PKEY_size(key._evp_pkey)\n backend.openssl_assert(pkey_size > 0)\n\n if isinstance(padding, PKCS1v15):\n padding_enum = backend._lib.RSA_PKCS1_PADDING\n elif isinstance(padding, PSS):\n if not isinstance(padding._mgf, MGF1):\n raise UnsupportedAlgorithm(\n \"Only MGF1 is supported by this backend.\",\n _Reasons.UNSUPPORTED_MGF\n )\n\n # Size of key in bytes - 2 is the maximum\n # PSS signature length (salt length is checked later)\n if pkey_size - algorithm.digest_size - 2 < 0:\n raise ValueError(\"Digest too large for key size. Use a larger \"\n \"key or different digest.\")\n\n padding_enum = backend._lib.RSA_PKCS1_PSS_PADDING\n else:\n raise UnsupportedAlgorithm(\n \"{} is not supported by this backend.\".format(padding.name),\n _Reasons.UNSUPPORTED_PADDING\n )\n\n return padding_enum\n\n\ndef _rsa_sig_setup(backend, padding, algorithm, key, data, init_func):\n padding_enum = _rsa_sig_determine_padding(backend, key, padding, algorithm)\n evp_md = backend._evp_md_non_null_from_algorithm(algorithm)\n pkey_ctx = backend._lib.EVP_PKEY_CTX_new(key._evp_pkey, backend._ffi.NULL)\n backend.openssl_assert(pkey_ctx != backend._ffi.NULL)\n pkey_ctx = backend._ffi.gc(pkey_ctx, backend._lib.EVP_PKEY_CTX_free)\n res = init_func(pkey_ctx)\n backend.openssl_assert(res == 1)\n res = backend._lib.EVP_PKEY_CTX_set_signature_md(pkey_ctx, evp_md)\n if res == 0:\n backend._consume_errors()\n raise UnsupportedAlgorithm(\n \"{} is not supported by this backend for RSA signing.\".format(\n algorithm.name\n ),\n _Reasons.UNSUPPORTED_HASH\n )\n res = backend._lib.EVP_PKEY_CTX_set_rsa_padding(pkey_ctx, padding_enum)\n backend.openssl_assert(res > 0)\n if isinstance(padding, PSS):\n res = backend._lib.EVP_PKEY_CTX_set_rsa_pss_saltlen(\n pkey_ctx, _get_rsa_pss_salt_length(padding, key, algorithm)\n )\n backend.openssl_assert(res > 0)\n\n mgf1_md = backend._evp_md_non_null_from_algorithm(\n padding._mgf._algorithm)\n res = backend._lib.EVP_PKEY_CTX_set_rsa_mgf1_md(pkey_ctx, mgf1_md)\n backend.openssl_assert(res > 0)\n\n return pkey_ctx\n\n\ndef _rsa_sig_sign(backend, padding, algorithm, private_key, data):\n pkey_ctx = _rsa_sig_setup(\n backend, padding, algorithm, private_key, data,\n backend._lib.EVP_PKEY_sign_init\n )\n buflen = backend._ffi.new(\"size_t *\")\n res = backend._lib.EVP_PKEY_sign(\n pkey_ctx,\n backend._ffi.NULL,\n buflen,\n data,\n len(data)\n )\n backend.openssl_assert(res == 1)\n buf = backend._ffi.new(\"unsigned char[]\", buflen[0])\n res = backend._lib.EVP_PKEY_sign(\n pkey_ctx, buf, buflen, data, len(data))\n if res != 1:\n errors = backend._consume_errors()\n backend.openssl_assert(errors[0].lib == backend._lib.ERR_LIB_RSA)\n if (\n errors[0].reason ==\n backend._lib.RSA_R_DATA_TOO_LARGE_FOR_KEY_SIZE\n ):\n reason = (\"Salt length too long for key size. Try using \"\n \"MAX_LENGTH instead.\")\n else:\n backend.openssl_assert(\n errors[0].reason ==\n backend._lib.RSA_R_DIGEST_TOO_BIG_FOR_RSA_KEY\n )\n reason = \"Digest too large for key size. Use a larger key.\"\n raise ValueError(reason)\n\n return backend._ffi.buffer(buf)[:]\n\n\ndef _rsa_sig_verify(backend, padding, algorithm, public_key, signature, data):\n pkey_ctx = _rsa_sig_setup(\n backend, padding, algorithm, public_key, data,\n backend._lib.EVP_PKEY_verify_init\n )\n res = backend._lib.EVP_PKEY_verify(\n pkey_ctx, signature, len(signature), data, len(data)\n )\n # The previous call can return negative numbers in the event of an\n # error. This is not a signature failure but we need to fail if it\n # occurs.\n backend.openssl_assert(res >= 0)\n if res == 0:\n backend._consume_errors()\n raise InvalidSignature\n\n\n@utils.register_interface(AsymmetricSignatureContext)\nclass _RSASignatureContext(object):\n def __init__(self, backend, private_key, padding, algorithm):\n self._backend = backend\n self._private_key = private_key\n\n # We now call _rsa_sig_determine_padding in _rsa_sig_setup. However\n # we need to make a pointless call to it here so we maintain the\n # API of erroring on init with this context if the values are invalid.\n _rsa_sig_determine_padding(backend, private_key, padding, algorithm)\n self._padding = padding\n self._algorithm = algorithm\n self._hash_ctx = hashes.Hash(self._algorithm, self._backend)\n\n def update(self, data):\n self._hash_ctx.update(data)\n\n def finalize(self):\n return _rsa_sig_sign(\n self._backend,\n self._padding,\n self._algorithm,\n self._private_key,\n self._hash_ctx.finalize()\n )\n\n\n@utils.register_interface(AsymmetricVerificationContext)\nclass _RSAVerificationContext(object):\n def __init__(self, backend, public_key, signature, padding, algorithm):\n self._backend = backend\n self._public_key = public_key\n self._signature = signature\n self._padding = padding\n # We now call _rsa_sig_determine_padding in _rsa_sig_setup. However\n # we need to make a pointless call to it here so we maintain the\n # API of erroring on init with this context if the values are invalid.\n _rsa_sig_determine_padding(backend, public_key, padding, algorithm)\n\n padding = padding\n self._algorithm = algorithm\n self._hash_ctx = hashes.Hash(self._algorithm, self._backend)\n\n def update(self, data):\n self._hash_ctx.update(data)\n\n def verify(self):\n return _rsa_sig_verify(\n self._backend,\n self._padding,\n self._algorithm,\n self._public_key,\n self._signature,\n self._hash_ctx.finalize()\n )\n\n\n@utils.register_interface(RSAPrivateKeyWithSerialization)\nclass _RSAPrivateKey(object):\n def __init__(self, backend, rsa_cdata, evp_pkey):\n self._backend = backend\n self._rsa_cdata = rsa_cdata\n self._evp_pkey = evp_pkey\n\n n = self._backend._ffi.new(\"BIGNUM **\")\n self._backend._lib.RSA_get0_key(\n self._rsa_cdata, n, self._backend._ffi.NULL,\n self._backend._ffi.NULL\n )\n self._backend.openssl_assert(n[0] != self._backend._ffi.NULL)\n self._key_size = self._backend._lib.BN_num_bits(n[0])\n\n key_size = utils.read_only_property(\"_key_size\")\n\n def signer(self, padding, algorithm):\n _warn_sign_verify_deprecated()\n _check_not_prehashed(algorithm)\n return _RSASignatureContext(self._backend, self, padding, algorithm)\n\n def decrypt(self, ciphertext, padding):\n key_size_bytes = int(math.ceil(self.key_size / 8.0))\n if key_size_bytes != len(ciphertext):\n raise ValueError(\"Ciphertext length must be equal to key size.\")\n\n return _enc_dec_rsa(self._backend, self, ciphertext, padding)\n\n def public_key(self):\n ctx = self._backend._lib.RSAPublicKey_dup(self._rsa_cdata)\n self._backend.openssl_assert(ctx != self._backend._ffi.NULL)\n ctx = self._backend._ffi.gc(ctx, self._backend._lib.RSA_free)\n res = self._backend._lib.RSA_blinding_on(ctx, self._backend._ffi.NULL)\n self._backend.openssl_assert(res == 1)\n evp_pkey = self._backend._rsa_cdata_to_evp_pkey(ctx)\n return _RSAPublicKey(self._backend, ctx, evp_pkey)\n\n def private_numbers(self):\n n = self._backend._ffi.new(\"BIGNUM **\")\n e = self._backend._ffi.new(\"BIGNUM **\")\n d = self._backend._ffi.new(\"BIGNUM **\")\n p = self._backend._ffi.new(\"BIGNUM **\")\n q = self._backend._ffi.new(\"BIGNUM **\")\n dmp1 = self._backend._ffi.new(\"BIGNUM **\")\n dmq1 = self._backend._ffi.new(\"BIGNUM **\")\n iqmp = self._backend._ffi.new(\"BIGNUM **\")\n self._backend._lib.RSA_get0_key(self._rsa_cdata, n, e, d)\n self._backend.openssl_assert(n[0] != self._backend._ffi.NULL)\n self._backend.openssl_assert(e[0] != self._backend._ffi.NULL)\n self._backend.openssl_assert(d[0] != self._backend._ffi.NULL)\n self._backend._lib.RSA_get0_factors(self._rsa_cdata, p, q)\n self._backend.openssl_assert(p[0] != self._backend._ffi.NULL)\n self._backend.openssl_assert(q[0] != self._backend._ffi.NULL)\n self._backend._lib.RSA_get0_crt_params(\n self._rsa_cdata, dmp1, dmq1, iqmp\n )\n self._backend.openssl_assert(dmp1[0] != self._backend._ffi.NULL)\n self._backend.openssl_assert(dmq1[0] != self._backend._ffi.NULL)\n self._backend.openssl_assert(iqmp[0] != self._backend._ffi.NULL)\n return rsa.RSAPrivateNumbers(\n p=self._backend._bn_to_int(p[0]),\n q=self._backend._bn_to_int(q[0]),\n d=self._backend._bn_to_int(d[0]),\n dmp1=self._backend._bn_to_int(dmp1[0]),\n dmq1=self._backend._bn_to_int(dmq1[0]),\n iqmp=self._backend._bn_to_int(iqmp[0]),\n public_numbers=rsa.RSAPublicNumbers(\n e=self._backend._bn_to_int(e[0]),\n n=self._backend._bn_to_int(n[0]),\n )\n )\n\n def private_bytes(self, encoding, format, encryption_algorithm):\n return self._backend._private_key_bytes(\n encoding,\n format,\n encryption_algorithm,\n self._evp_pkey,\n self._rsa_cdata\n )\n\n def sign(self, data, padding, algorithm):\n data, algorithm = _calculate_digest_and_algorithm(\n self._backend, data, algorithm\n )\n return _rsa_sig_sign(self._backend, padding, algorithm, self, data)\n\n\n@utils.register_interface(RSAPublicKeyWithSerialization)\nclass _RSAPublicKey(object):\n def __init__(self, backend, rsa_cdata, evp_pkey):\n self._backend = backend\n self._rsa_cdata = rsa_cdata\n self._evp_pkey = evp_pkey\n\n n = self._backend._ffi.new(\"BIGNUM **\")\n self._backend._lib.RSA_get0_key(\n self._rsa_cdata, n, self._backend._ffi.NULL,\n self._backend._ffi.NULL\n )\n self._backend.openssl_assert(n[0] != self._backend._ffi.NULL)\n self._key_size = self._backend._lib.BN_num_bits(n[0])\n\n key_size = utils.read_only_property(\"_key_size\")\n\n def verifier(self, signature, padding, algorithm):\n _warn_sign_verify_deprecated()\n utils._check_bytes(\"signature\", signature)\n\n _check_not_prehashed(algorithm)\n return _RSAVerificationContext(\n self._backend, self, signature, padding, algorithm\n )\n\n def encrypt(self, plaintext, padding):\n return _enc_dec_rsa(self._backend, self, plaintext, padding)\n\n def public_numbers(self):\n n = self._backend._ffi.new(\"BIGNUM **\")\n e = self._backend._ffi.new(\"BIGNUM **\")\n self._backend._lib.RSA_get0_key(\n self._rsa_cdata, n, e, self._backend._ffi.NULL\n )\n self._backend.openssl_assert(n[0] != self._backend._ffi.NULL)\n self._backend.openssl_assert(e[0] != self._backend._ffi.NULL)\n return rsa.RSAPublicNumbers(\n e=self._backend._bn_to_int(e[0]),\n n=self._backend._bn_to_int(n[0]),\n )\n\n def public_bytes(self, encoding, format):\n return self._backend._public_key_bytes(\n encoding,\n format,\n self,\n self._evp_pkey,\n self._rsa_cdata\n )\n\n def verify(self, signature, data, padding, algorithm):\n data, algorithm = _calculate_digest_and_algorithm(\n self._backend, data, algorithm\n )\n return _rsa_sig_verify(\n self._backend, padding, algorithm, self, signature, data\n )\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/backends/openssl/utils.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport warnings\n\nfrom cryptography import utils\nfrom cryptography.hazmat.primitives import hashes\nfrom cryptography.hazmat.primitives.asymmetric.utils import Prehashed\n\n\ndef _evp_pkey_derive(backend, evp_pkey, peer_public_key):\n ctx = backend._lib.EVP_PKEY_CTX_new(evp_pkey, backend._ffi.NULL)\n backend.openssl_assert(ctx != backend._ffi.NULL)\n ctx = backend._ffi.gc(ctx, backend._lib.EVP_PKEY_CTX_free)\n res = backend._lib.EVP_PKEY_derive_init(ctx)\n backend.openssl_assert(res == 1)\n res = backend._lib.EVP_PKEY_derive_set_peer(\n ctx, peer_public_key._evp_pkey\n )\n backend.openssl_assert(res == 1)\n keylen = backend._ffi.new(\"size_t *\")\n res = backend._lib.EVP_PKEY_derive(ctx, backend._ffi.NULL, keylen)\n backend.openssl_assert(res == 1)\n backend.openssl_assert(keylen[0] > 0)\n buf = backend._ffi.new(\"unsigned char[]\", keylen[0])\n res = backend._lib.EVP_PKEY_derive(ctx, buf, keylen)\n if res != 1:\n raise ValueError(\n \"Null shared key derived from public/private pair.\"\n )\n\n return backend._ffi.buffer(buf, keylen[0])[:]\n\n\ndef _calculate_digest_and_algorithm(backend, data, algorithm):\n if not isinstance(algorithm, Prehashed):\n hash_ctx = hashes.Hash(algorithm, backend)\n hash_ctx.update(data)\n data = hash_ctx.finalize()\n else:\n algorithm = algorithm._algorithm\n\n if len(data) != algorithm.digest_size:\n raise ValueError(\n \"The provided data must be the same length as the hash \"\n \"algorithm's digest size.\"\n )\n\n return (data, algorithm)\n\n\ndef _check_not_prehashed(signature_algorithm):\n if isinstance(signature_algorithm, Prehashed):\n raise TypeError(\n \"Prehashed is only supported in the sign and verify methods. \"\n \"It cannot be used with signer or verifier.\"\n )\n\n\ndef _warn_sign_verify_deprecated():\n warnings.warn(\n \"signer and verifier have been deprecated. Please use sign \"\n \"and verify instead.\",\n utils.PersistentlyDeprecated2017,\n stacklevel=3\n )\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/backends/openssl/x25519.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport warnings\n\nfrom cryptography import utils\nfrom cryptography.hazmat.backends.openssl.utils import _evp_pkey_derive\nfrom cryptography.hazmat.primitives import serialization\nfrom cryptography.hazmat.primitives.asymmetric.x25519 import (\n X25519PrivateKey, X25519PublicKey\n)\n\n\n_X25519_KEY_SIZE = 32\n\n\n@utils.register_interface(X25519PublicKey)\nclass _X25519PublicKey(object):\n def __init__(self, backend, evp_pkey):\n self._backend = backend\n self._evp_pkey = evp_pkey\n\n def public_bytes(self, encoding=None, format=None):\n if encoding is None or format is None:\n if encoding is not None or format is not None:\n raise ValueError(\"Both encoding and format are required\")\n else:\n warnings.warn(\n \"public_bytes now requires encoding and format arguments. \"\n \"Support for calling without arguments will be removed in \"\n \"cryptography 2.7\",\n utils.DeprecatedIn25,\n )\n encoding = serialization.Encoding.Raw\n format = serialization.PublicFormat.Raw\n if (\n encoding is serialization.Encoding.Raw or\n format is serialization.PublicFormat.Raw\n ):\n if (\n encoding is not serialization.Encoding.Raw or\n format is not serialization.PublicFormat.Raw\n ):\n raise ValueError(\n \"When using Raw both encoding and format must be Raw\"\n )\n\n return self._raw_public_bytes()\n\n if (\n encoding in serialization._PEM_DER and\n format is not serialization.PublicFormat.SubjectPublicKeyInfo\n ):\n raise ValueError(\n \"format must be SubjectPublicKeyInfo when encoding is PEM or \"\n \"DER\"\n )\n\n return self._backend._public_key_bytes(\n encoding, format, self, self._evp_pkey, None\n )\n\n def _raw_public_bytes(self):\n ucharpp = self._backend._ffi.new(\"unsigned char **\")\n res = self._backend._lib.EVP_PKEY_get1_tls_encodedpoint(\n self._evp_pkey, ucharpp\n )\n self._backend.openssl_assert(res == 32)\n self._backend.openssl_assert(ucharpp[0] != self._backend._ffi.NULL)\n data = self._backend._ffi.gc(\n ucharpp[0], self._backend._lib.OPENSSL_free\n )\n return self._backend._ffi.buffer(data, res)[:]\n\n\n@utils.register_interface(X25519PrivateKey)\nclass _X25519PrivateKey(object):\n def __init__(self, backend, evp_pkey):\n self._backend = backend\n self._evp_pkey = evp_pkey\n\n def public_key(self):\n bio = self._backend._create_mem_bio_gc()\n res = self._backend._lib.i2d_PUBKEY_bio(bio, self._evp_pkey)\n self._backend.openssl_assert(res == 1)\n evp_pkey = self._backend._lib.d2i_PUBKEY_bio(\n bio, self._backend._ffi.NULL\n )\n self._backend.openssl_assert(evp_pkey != self._backend._ffi.NULL)\n evp_pkey = self._backend._ffi.gc(\n evp_pkey, self._backend._lib.EVP_PKEY_free\n )\n return _X25519PublicKey(self._backend, evp_pkey)\n\n def exchange(self, peer_public_key):\n if not isinstance(peer_public_key, X25519PublicKey):\n raise TypeError(\"peer_public_key must be X25519PublicKey.\")\n\n return _evp_pkey_derive(\n self._backend, self._evp_pkey, peer_public_key\n )\n\n def private_bytes(self, encoding, format, encryption_algorithm):\n if (\n encoding is serialization.Encoding.Raw or\n format is serialization.PublicFormat.Raw\n ):\n if (\n format is not serialization.PrivateFormat.Raw or\n encoding is not serialization.Encoding.Raw or not\n isinstance(encryption_algorithm, serialization.NoEncryption)\n ):\n raise ValueError(\n \"When using Raw both encoding and format must be Raw \"\n \"and encryption_algorithm must be NoEncryption()\"\n )\n\n return self._raw_private_bytes()\n\n if (\n encoding in serialization._PEM_DER and\n format is not serialization.PrivateFormat.PKCS8\n ):\n raise ValueError(\n \"format must be PKCS8 when encoding is PEM or DER\"\n )\n\n return self._backend._private_key_bytes(\n encoding, format, encryption_algorithm, self._evp_pkey, None\n )\n\n def _raw_private_bytes(self):\n # When we drop support for CRYPTOGRAPHY_OPENSSL_LESS_THAN_111 we can\n # switch this to EVP_PKEY_new_raw_private_key\n # The trick we use here is serializing to a PKCS8 key and just\n # using the last 32 bytes, which is the key itself.\n bio = self._backend._create_mem_bio_gc()\n res = self._backend._lib.i2d_PKCS8PrivateKey_bio(\n bio, self._evp_pkey,\n self._backend._ffi.NULL, self._backend._ffi.NULL,\n 0, self._backend._ffi.NULL, self._backend._ffi.NULL\n )\n self._backend.openssl_assert(res == 1)\n pkcs8 = self._backend._read_mem_bio(bio)\n self._backend.openssl_assert(len(pkcs8) == 48)\n return pkcs8[-_X25519_KEY_SIZE:]\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/backends/openssl/x448.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nfrom cryptography import utils\nfrom cryptography.hazmat.backends.openssl.utils import _evp_pkey_derive\nfrom cryptography.hazmat.primitives import serialization\nfrom cryptography.hazmat.primitives.asymmetric.x448 import (\n X448PrivateKey, X448PublicKey\n)\n\n_X448_KEY_SIZE = 56\n\n\n@utils.register_interface(X448PublicKey)\nclass _X448PublicKey(object):\n def __init__(self, backend, evp_pkey):\n self._backend = backend\n self._evp_pkey = evp_pkey\n\n def public_bytes(self, encoding, format):\n if (\n encoding is serialization.Encoding.Raw or\n format is serialization.PublicFormat.Raw\n ):\n if (\n encoding is not serialization.Encoding.Raw or\n format is not serialization.PublicFormat.Raw\n ):\n raise ValueError(\n \"When using Raw both encoding and format must be Raw\"\n )\n\n return self._raw_public_bytes()\n\n if (\n encoding in serialization._PEM_DER and\n format is not serialization.PublicFormat.SubjectPublicKeyInfo\n ):\n raise ValueError(\n \"format must be SubjectPublicKeyInfo when encoding is PEM or \"\n \"DER\"\n )\n\n return self._backend._public_key_bytes(\n encoding, format, self, self._evp_pkey, None\n )\n\n def _raw_public_bytes(self):\n buf = self._backend._ffi.new(\"unsigned char []\", _X448_KEY_SIZE)\n buflen = self._backend._ffi.new(\"size_t *\", _X448_KEY_SIZE)\n res = self._backend._lib.EVP_PKEY_get_raw_public_key(\n self._evp_pkey, buf, buflen\n )\n self._backend.openssl_assert(res == 1)\n self._backend.openssl_assert(buflen[0] == _X448_KEY_SIZE)\n return self._backend._ffi.buffer(buf, _X448_KEY_SIZE)[:]\n\n\n@utils.register_interface(X448PrivateKey)\nclass _X448PrivateKey(object):\n def __init__(self, backend, evp_pkey):\n self._backend = backend\n self._evp_pkey = evp_pkey\n\n def public_key(self):\n buf = self._backend._ffi.new(\"unsigned char []\", _X448_KEY_SIZE)\n buflen = self._backend._ffi.new(\"size_t *\", _X448_KEY_SIZE)\n res = self._backend._lib.EVP_PKEY_get_raw_public_key(\n self._evp_pkey, buf, buflen\n )\n self._backend.openssl_assert(res == 1)\n self._backend.openssl_assert(buflen[0] == _X448_KEY_SIZE)\n return self._backend.x448_load_public_bytes(buf)\n\n def exchange(self, peer_public_key):\n if not isinstance(peer_public_key, X448PublicKey):\n raise TypeError(\"peer_public_key must be X448PublicKey.\")\n\n return _evp_pkey_derive(\n self._backend, self._evp_pkey, peer_public_key\n )\n\n def private_bytes(self, encoding, format, encryption_algorithm):\n if (\n encoding is serialization.Encoding.Raw or\n format is serialization.PublicFormat.Raw\n ):\n if (\n format is not serialization.PrivateFormat.Raw or\n encoding is not serialization.Encoding.Raw or not\n isinstance(encryption_algorithm, serialization.NoEncryption)\n ):\n raise ValueError(\n \"When using Raw both encoding and format must be Raw \"\n \"and encryption_algorithm must be NoEncryption()\"\n )\n\n return self._raw_private_bytes()\n\n if (\n encoding in serialization._PEM_DER and\n format is not serialization.PrivateFormat.PKCS8\n ):\n raise ValueError(\n \"format must be PKCS8 when encoding is PEM or DER\"\n )\n\n return self._backend._private_key_bytes(\n encoding, format, encryption_algorithm, self._evp_pkey, None\n )\n\n def _raw_private_bytes(self):\n buf = self._backend._ffi.new(\"unsigned char []\", _X448_KEY_SIZE)\n buflen = self._backend._ffi.new(\"size_t *\", _X448_KEY_SIZE)\n res = self._backend._lib.EVP_PKEY_get_raw_private_key(\n self._evp_pkey, buf, buflen\n )\n self._backend.openssl_assert(res == 1)\n self._backend.openssl_assert(buflen[0] == _X448_KEY_SIZE)\n return self._backend._ffi.buffer(buf, _X448_KEY_SIZE)[:]\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/backends/openssl/x509.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport datetime\nimport operator\n\nfrom cryptography import utils, x509\nfrom cryptography.exceptions import UnsupportedAlgorithm\nfrom cryptography.hazmat.backends.openssl.decode_asn1 import (\n _CERTIFICATE_EXTENSION_PARSER, _CERTIFICATE_EXTENSION_PARSER_NO_SCT,\n _CRL_EXTENSION_PARSER, _CSR_EXTENSION_PARSER,\n _REVOKED_CERTIFICATE_EXTENSION_PARSER, _asn1_integer_to_int,\n _asn1_string_to_bytes, _decode_x509_name, _obj2txt, _parse_asn1_time\n)\nfrom cryptography.hazmat.backends.openssl.encode_asn1 import (\n _encode_asn1_int_gc\n)\nfrom cryptography.hazmat.primitives import hashes, serialization\nfrom cryptography.hazmat.primitives.asymmetric import dsa, ec, rsa\n\n\n@utils.register_interface(x509.Certificate)\nclass _Certificate(object):\n def __init__(self, backend, x509):\n self._backend = backend\n self._x509 = x509\n\n def __repr__(self):\n return \"\".format(self.subject)\n\n def __eq__(self, other):\n if not isinstance(other, x509.Certificate):\n return NotImplemented\n\n res = self._backend._lib.X509_cmp(self._x509, other._x509)\n return res == 0\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash(self.public_bytes(serialization.Encoding.DER))\n\n def fingerprint(self, algorithm):\n h = hashes.Hash(algorithm, self._backend)\n h.update(self.public_bytes(serialization.Encoding.DER))\n return h.finalize()\n\n @property\n def version(self):\n version = self._backend._lib.X509_get_version(self._x509)\n if version == 0:\n return x509.Version.v1\n elif version == 2:\n return x509.Version.v3\n else:\n raise x509.InvalidVersion(\n \"{} is not a valid X509 version\".format(version), version\n )\n\n @property\n def serial_number(self):\n asn1_int = self._backend._lib.X509_get_serialNumber(self._x509)\n self._backend.openssl_assert(asn1_int != self._backend._ffi.NULL)\n return _asn1_integer_to_int(self._backend, asn1_int)\n\n def public_key(self):\n pkey = self._backend._lib.X509_get_pubkey(self._x509)\n if pkey == self._backend._ffi.NULL:\n # Remove errors from the stack.\n self._backend._consume_errors()\n raise ValueError(\"Certificate public key is of an unknown type\")\n\n pkey = self._backend._ffi.gc(pkey, self._backend._lib.EVP_PKEY_free)\n\n return self._backend._evp_pkey_to_public_key(pkey)\n\n @property\n def not_valid_before(self):\n asn1_time = self._backend._lib.X509_getm_notBefore(self._x509)\n return _parse_asn1_time(self._backend, asn1_time)\n\n @property\n def not_valid_after(self):\n asn1_time = self._backend._lib.X509_getm_notAfter(self._x509)\n return _parse_asn1_time(self._backend, asn1_time)\n\n @property\n def issuer(self):\n issuer = self._backend._lib.X509_get_issuer_name(self._x509)\n self._backend.openssl_assert(issuer != self._backend._ffi.NULL)\n return _decode_x509_name(self._backend, issuer)\n\n @property\n def subject(self):\n subject = self._backend._lib.X509_get_subject_name(self._x509)\n self._backend.openssl_assert(subject != self._backend._ffi.NULL)\n return _decode_x509_name(self._backend, subject)\n\n @property\n def signature_hash_algorithm(self):\n oid = self.signature_algorithm_oid\n try:\n return x509._SIG_OIDS_TO_HASH[oid]\n except KeyError:\n raise UnsupportedAlgorithm(\n \"Signature algorithm OID:{} not recognized\".format(oid)\n )\n\n @property\n def signature_algorithm_oid(self):\n alg = self._backend._ffi.new(\"X509_ALGOR **\")\n self._backend._lib.X509_get0_signature(\n self._backend._ffi.NULL, alg, self._x509\n )\n self._backend.openssl_assert(alg[0] != self._backend._ffi.NULL)\n oid = _obj2txt(self._backend, alg[0].algorithm)\n return x509.ObjectIdentifier(oid)\n\n @utils.cached_property\n def extensions(self):\n if self._backend._lib.CRYPTOGRAPHY_OPENSSL_110_OR_GREATER:\n return _CERTIFICATE_EXTENSION_PARSER.parse(\n self._backend, self._x509\n )\n else:\n return _CERTIFICATE_EXTENSION_PARSER_NO_SCT.parse(\n self._backend, self._x509\n )\n\n @property\n def signature(self):\n sig = self._backend._ffi.new(\"ASN1_BIT_STRING **\")\n self._backend._lib.X509_get0_signature(\n sig, self._backend._ffi.NULL, self._x509\n )\n self._backend.openssl_assert(sig[0] != self._backend._ffi.NULL)\n return _asn1_string_to_bytes(self._backend, sig[0])\n\n @property\n def tbs_certificate_bytes(self):\n pp = self._backend._ffi.new(\"unsigned char **\")\n res = self._backend._lib.i2d_re_X509_tbs(self._x509, pp)\n self._backend.openssl_assert(res > 0)\n pp = self._backend._ffi.gc(\n pp, lambda pointer: self._backend._lib.OPENSSL_free(pointer[0])\n )\n return self._backend._ffi.buffer(pp[0], res)[:]\n\n def public_bytes(self, encoding):\n bio = self._backend._create_mem_bio_gc()\n if encoding is serialization.Encoding.PEM:\n res = self._backend._lib.PEM_write_bio_X509(bio, self._x509)\n elif encoding is serialization.Encoding.DER:\n res = self._backend._lib.i2d_X509_bio(bio, self._x509)\n else:\n raise TypeError(\"encoding must be an item from the Encoding enum\")\n\n self._backend.openssl_assert(res == 1)\n return self._backend._read_mem_bio(bio)\n\n\n@utils.register_interface(x509.RevokedCertificate)\nclass _RevokedCertificate(object):\n def __init__(self, backend, crl, x509_revoked):\n self._backend = backend\n # The X509_REVOKED_value is a X509_REVOKED * that has\n # no reference counting. This means when X509_CRL_free is\n # called then the CRL and all X509_REVOKED * are freed. Since\n # you can retain a reference to a single revoked certificate\n # and let the CRL fall out of scope we need to retain a\n # private reference to the CRL inside the RevokedCertificate\n # object to prevent the gc from being called inappropriately.\n self._crl = crl\n self._x509_revoked = x509_revoked\n\n @property\n def serial_number(self):\n asn1_int = self._backend._lib.X509_REVOKED_get0_serialNumber(\n self._x509_revoked\n )\n self._backend.openssl_assert(asn1_int != self._backend._ffi.NULL)\n return _asn1_integer_to_int(self._backend, asn1_int)\n\n @property\n def revocation_date(self):\n return _parse_asn1_time(\n self._backend,\n self._backend._lib.X509_REVOKED_get0_revocationDate(\n self._x509_revoked\n )\n )\n\n @utils.cached_property\n def extensions(self):\n return _REVOKED_CERTIFICATE_EXTENSION_PARSER.parse(\n self._backend, self._x509_revoked\n )\n\n\n@utils.register_interface(x509.CertificateRevocationList)\nclass _CertificateRevocationList(object):\n def __init__(self, backend, x509_crl):\n self._backend = backend\n self._x509_crl = x509_crl\n\n def __eq__(self, other):\n if not isinstance(other, x509.CertificateRevocationList):\n return NotImplemented\n\n res = self._backend._lib.X509_CRL_cmp(self._x509_crl, other._x509_crl)\n return res == 0\n\n def __ne__(self, other):\n return not self == other\n\n def fingerprint(self, algorithm):\n h = hashes.Hash(algorithm, self._backend)\n bio = self._backend._create_mem_bio_gc()\n res = self._backend._lib.i2d_X509_CRL_bio(\n bio, self._x509_crl\n )\n self._backend.openssl_assert(res == 1)\n der = self._backend._read_mem_bio(bio)\n h.update(der)\n return h.finalize()\n\n @utils.cached_property\n def _sorted_crl(self):\n # X509_CRL_get0_by_serial sorts in place, which breaks a variety of\n # things we don't want to break (like iteration and the signature).\n # Let's dupe it and sort that instead.\n dup = self._backend._lib.X509_CRL_dup(self._x509_crl)\n self._backend.openssl_assert(dup != self._backend._ffi.NULL)\n dup = self._backend._ffi.gc(dup, self._backend._lib.X509_CRL_free)\n return dup\n\n def get_revoked_certificate_by_serial_number(self, serial_number):\n revoked = self._backend._ffi.new(\"X509_REVOKED **\")\n asn1_int = _encode_asn1_int_gc(self._backend, serial_number)\n res = self._backend._lib.X509_CRL_get0_by_serial(\n self._sorted_crl, revoked, asn1_int\n )\n if res == 0:\n return None\n else:\n self._backend.openssl_assert(\n revoked[0] != self._backend._ffi.NULL\n )\n return _RevokedCertificate(\n self._backend, self._sorted_crl, revoked[0]\n )\n\n @property\n def signature_hash_algorithm(self):\n oid = self.signature_algorithm_oid\n try:\n return x509._SIG_OIDS_TO_HASH[oid]\n except KeyError:\n raise UnsupportedAlgorithm(\n \"Signature algorithm OID:{} not recognized\".format(oid)\n )\n\n @property\n def signature_algorithm_oid(self):\n alg = self._backend._ffi.new(\"X509_ALGOR **\")\n self._backend._lib.X509_CRL_get0_signature(\n self._x509_crl, self._backend._ffi.NULL, alg\n )\n self._backend.openssl_assert(alg[0] != self._backend._ffi.NULL)\n oid = _obj2txt(self._backend, alg[0].algorithm)\n return x509.ObjectIdentifier(oid)\n\n @property\n def issuer(self):\n issuer = self._backend._lib.X509_CRL_get_issuer(self._x509_crl)\n self._backend.openssl_assert(issuer != self._backend._ffi.NULL)\n return _decode_x509_name(self._backend, issuer)\n\n @property\n def next_update(self):\n nu = self._backend._lib.X509_CRL_get_nextUpdate(self._x509_crl)\n self._backend.openssl_assert(nu != self._backend._ffi.NULL)\n return _parse_asn1_time(self._backend, nu)\n\n @property\n def last_update(self):\n lu = self._backend._lib.X509_CRL_get_lastUpdate(self._x509_crl)\n self._backend.openssl_assert(lu != self._backend._ffi.NULL)\n return _parse_asn1_time(self._backend, lu)\n\n @property\n def signature(self):\n sig = self._backend._ffi.new(\"ASN1_BIT_STRING **\")\n self._backend._lib.X509_CRL_get0_signature(\n self._x509_crl, sig, self._backend._ffi.NULL\n )\n self._backend.openssl_assert(sig[0] != self._backend._ffi.NULL)\n return _asn1_string_to_bytes(self._backend, sig[0])\n\n @property\n def tbs_certlist_bytes(self):\n pp = self._backend._ffi.new(\"unsigned char **\")\n res = self._backend._lib.i2d_re_X509_CRL_tbs(self._x509_crl, pp)\n self._backend.openssl_assert(res > 0)\n pp = self._backend._ffi.gc(\n pp, lambda pointer: self._backend._lib.OPENSSL_free(pointer[0])\n )\n return self._backend._ffi.buffer(pp[0], res)[:]\n\n def public_bytes(self, encoding):\n bio = self._backend._create_mem_bio_gc()\n if encoding is serialization.Encoding.PEM:\n res = self._backend._lib.PEM_write_bio_X509_CRL(\n bio, self._x509_crl\n )\n elif encoding is serialization.Encoding.DER:\n res = self._backend._lib.i2d_X509_CRL_bio(bio, self._x509_crl)\n else:\n raise TypeError(\"encoding must be an item from the Encoding enum\")\n\n self._backend.openssl_assert(res == 1)\n return self._backend._read_mem_bio(bio)\n\n def _revoked_cert(self, idx):\n revoked = self._backend._lib.X509_CRL_get_REVOKED(self._x509_crl)\n r = self._backend._lib.sk_X509_REVOKED_value(revoked, idx)\n self._backend.openssl_assert(r != self._backend._ffi.NULL)\n return _RevokedCertificate(self._backend, self, r)\n\n def __iter__(self):\n for i in range(len(self)):\n yield self._revoked_cert(i)\n\n def __getitem__(self, idx):\n if isinstance(idx, slice):\n start, stop, step = idx.indices(len(self))\n return [self._revoked_cert(i) for i in range(start, stop, step)]\n else:\n idx = operator.index(idx)\n if idx < 0:\n idx += len(self)\n if not 0 <= idx < len(self):\n raise IndexError\n return self._revoked_cert(idx)\n\n def __len__(self):\n revoked = self._backend._lib.X509_CRL_get_REVOKED(self._x509_crl)\n if revoked == self._backend._ffi.NULL:\n return 0\n else:\n return self._backend._lib.sk_X509_REVOKED_num(revoked)\n\n @utils.cached_property\n def extensions(self):\n return _CRL_EXTENSION_PARSER.parse(self._backend, self._x509_crl)\n\n def is_signature_valid(self, public_key):\n if not isinstance(public_key, (dsa.DSAPublicKey, rsa.RSAPublicKey,\n ec.EllipticCurvePublicKey)):\n raise TypeError('Expecting one of DSAPublicKey, RSAPublicKey,'\n ' or EllipticCurvePublicKey.')\n res = self._backend._lib.X509_CRL_verify(\n self._x509_crl, public_key._evp_pkey\n )\n\n if res != 1:\n self._backend._consume_errors()\n return False\n\n return True\n\n\n@utils.register_interface(x509.CertificateSigningRequest)\nclass _CertificateSigningRequest(object):\n def __init__(self, backend, x509_req):\n self._backend = backend\n self._x509_req = x509_req\n\n def __eq__(self, other):\n if not isinstance(other, _CertificateSigningRequest):\n return NotImplemented\n\n self_bytes = self.public_bytes(serialization.Encoding.DER)\n other_bytes = other.public_bytes(serialization.Encoding.DER)\n return self_bytes == other_bytes\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash(self.public_bytes(serialization.Encoding.DER))\n\n def public_key(self):\n pkey = self._backend._lib.X509_REQ_get_pubkey(self._x509_req)\n self._backend.openssl_assert(pkey != self._backend._ffi.NULL)\n pkey = self._backend._ffi.gc(pkey, self._backend._lib.EVP_PKEY_free)\n return self._backend._evp_pkey_to_public_key(pkey)\n\n @property\n def subject(self):\n subject = self._backend._lib.X509_REQ_get_subject_name(self._x509_req)\n self._backend.openssl_assert(subject != self._backend._ffi.NULL)\n return _decode_x509_name(self._backend, subject)\n\n @property\n def signature_hash_algorithm(self):\n oid = self.signature_algorithm_oid\n try:\n return x509._SIG_OIDS_TO_HASH[oid]\n except KeyError:\n raise UnsupportedAlgorithm(\n \"Signature algorithm OID:{} not recognized\".format(oid)\n )\n\n @property\n def signature_algorithm_oid(self):\n alg = self._backend._ffi.new(\"X509_ALGOR **\")\n self._backend._lib.X509_REQ_get0_signature(\n self._x509_req, self._backend._ffi.NULL, alg\n )\n self._backend.openssl_assert(alg[0] != self._backend._ffi.NULL)\n oid = _obj2txt(self._backend, alg[0].algorithm)\n return x509.ObjectIdentifier(oid)\n\n @utils.cached_property\n def extensions(self):\n x509_exts = self._backend._lib.X509_REQ_get_extensions(self._x509_req)\n x509_exts = self._backend._ffi.gc(\n x509_exts,\n lambda x: self._backend._lib.sk_X509_EXTENSION_pop_free(\n x, self._backend._ffi.addressof(\n self._backend._lib._original_lib, \"X509_EXTENSION_free\"\n )\n )\n )\n return _CSR_EXTENSION_PARSER.parse(self._backend, x509_exts)\n\n def public_bytes(self, encoding):\n bio = self._backend._create_mem_bio_gc()\n if encoding is serialization.Encoding.PEM:\n res = self._backend._lib.PEM_write_bio_X509_REQ(\n bio, self._x509_req\n )\n elif encoding is serialization.Encoding.DER:\n res = self._backend._lib.i2d_X509_REQ_bio(bio, self._x509_req)\n else:\n raise TypeError(\"encoding must be an item from the Encoding enum\")\n\n self._backend.openssl_assert(res == 1)\n return self._backend._read_mem_bio(bio)\n\n @property\n def tbs_certrequest_bytes(self):\n pp = self._backend._ffi.new(\"unsigned char **\")\n res = self._backend._lib.i2d_re_X509_REQ_tbs(self._x509_req, pp)\n self._backend.openssl_assert(res > 0)\n pp = self._backend._ffi.gc(\n pp, lambda pointer: self._backend._lib.OPENSSL_free(pointer[0])\n )\n return self._backend._ffi.buffer(pp[0], res)[:]\n\n @property\n def signature(self):\n sig = self._backend._ffi.new(\"ASN1_BIT_STRING **\")\n self._backend._lib.X509_REQ_get0_signature(\n self._x509_req, sig, self._backend._ffi.NULL\n )\n self._backend.openssl_assert(sig[0] != self._backend._ffi.NULL)\n return _asn1_string_to_bytes(self._backend, sig[0])\n\n @property\n def is_signature_valid(self):\n pkey = self._backend._lib.X509_REQ_get_pubkey(self._x509_req)\n self._backend.openssl_assert(pkey != self._backend._ffi.NULL)\n pkey = self._backend._ffi.gc(pkey, self._backend._lib.EVP_PKEY_free)\n res = self._backend._lib.X509_REQ_verify(self._x509_req, pkey)\n\n if res != 1:\n self._backend._consume_errors()\n return False\n\n return True\n\n\n@utils.register_interface(\n x509.certificate_transparency.SignedCertificateTimestamp\n)\nclass _SignedCertificateTimestamp(object):\n def __init__(self, backend, sct_list, sct):\n self._backend = backend\n # Keep the SCT_LIST that this SCT came from alive.\n self._sct_list = sct_list\n self._sct = sct\n\n @property\n def version(self):\n version = self._backend._lib.SCT_get_version(self._sct)\n assert version == self._backend._lib.SCT_VERSION_V1\n return x509.certificate_transparency.Version.v1\n\n @property\n def log_id(self):\n out = self._backend._ffi.new(\"unsigned char **\")\n log_id_length = self._backend._lib.SCT_get0_log_id(self._sct, out)\n assert log_id_length >= 0\n return self._backend._ffi.buffer(out[0], log_id_length)[:]\n\n @property\n def timestamp(self):\n timestamp = self._backend._lib.SCT_get_timestamp(self._sct)\n milliseconds = timestamp % 1000\n return datetime.datetime.utcfromtimestamp(\n timestamp // 1000\n ).replace(microsecond=milliseconds * 1000)\n\n @property\n def entry_type(self):\n entry_type = self._backend._lib.SCT_get_log_entry_type(self._sct)\n # We currently only support loading SCTs from the X.509 extension, so\n # we only have precerts.\n assert entry_type == self._backend._lib.CT_LOG_ENTRY_TYPE_PRECERT\n return x509.certificate_transparency.LogEntryType.PRE_CERTIFICATE\n\n @property\n def _signature(self):\n ptrptr = self._backend._ffi.new(\"unsigned char **\")\n res = self._backend._lib.SCT_get0_signature(self._sct, ptrptr)\n self._backend.openssl_assert(res > 0)\n self._backend.openssl_assert(ptrptr[0] != self._backend._ffi.NULL)\n return self._backend._ffi.buffer(ptrptr[0], res)[:]\n\n def __hash__(self):\n return hash(self._signature)\n\n def __eq__(self, other):\n if not isinstance(other, _SignedCertificateTimestamp):\n return NotImplemented\n\n return self._signature == other._signature\n\n def __ne__(self, other):\n return not self == other\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/bindings/__init__.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/bindings/openssl/__init__.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/bindings/openssl/_conditional.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\n\ndef cryptography_has_ec2m():\n return [\n \"EC_POINT_set_affine_coordinates_GF2m\",\n \"EC_POINT_get_affine_coordinates_GF2m\",\n \"EC_POINT_set_compressed_coordinates_GF2m\",\n ]\n\n\ndef cryptography_has_ec_1_0_2():\n return [\n \"EC_curve_nid2nist\",\n ]\n\n\ndef cryptography_has_set_ecdh_auto():\n return [\n \"SSL_CTX_set_ecdh_auto\",\n ]\n\n\ndef cryptography_has_rsa_r_pkcs_decoding_error():\n return [\n \"RSA_R_PKCS_DECODING_ERROR\"\n ]\n\n\ndef cryptography_has_rsa_oaep_md():\n return [\n \"EVP_PKEY_CTX_set_rsa_oaep_md\",\n ]\n\n\ndef cryptography_has_rsa_oaep_label():\n return [\n \"EVP_PKEY_CTX_set0_rsa_oaep_label\",\n ]\n\n\ndef cryptography_has_ssl3_method():\n return [\n \"SSLv3_method\",\n \"SSLv3_client_method\",\n \"SSLv3_server_method\",\n ]\n\n\ndef cryptography_has_alpn():\n return [\n \"SSL_CTX_set_alpn_protos\",\n \"SSL_set_alpn_protos\",\n \"SSL_CTX_set_alpn_select_cb\",\n \"SSL_get0_alpn_selected\",\n ]\n\n\ndef cryptography_has_compression():\n return [\n \"SSL_get_current_compression\",\n \"SSL_get_current_expansion\",\n \"SSL_COMP_get_name\",\n ]\n\n\ndef cryptography_has_get_server_tmp_key():\n return [\n \"SSL_get_server_tmp_key\",\n ]\n\n\ndef cryptography_has_102_verification_error_codes():\n return [\n 'X509_V_ERR_SUITE_B_INVALID_VERSION',\n 'X509_V_ERR_SUITE_B_INVALID_ALGORITHM',\n 'X509_V_ERR_SUITE_B_INVALID_CURVE',\n 'X509_V_ERR_SUITE_B_INVALID_SIGNATURE_ALGORITHM',\n 'X509_V_ERR_SUITE_B_LOS_NOT_ALLOWED',\n 'X509_V_ERR_SUITE_B_CANNOT_SIGN_P_384_WITH_P_256',\n 'X509_V_ERR_HOSTNAME_MISMATCH',\n 'X509_V_ERR_EMAIL_MISMATCH',\n 'X509_V_ERR_IP_ADDRESS_MISMATCH'\n ]\n\n\ndef cryptography_has_102_verification_params():\n return [\n \"X509_V_FLAG_SUITEB_128_LOS_ONLY\",\n \"X509_V_FLAG_SUITEB_192_LOS\",\n \"X509_V_FLAG_SUITEB_128_LOS\",\n \"X509_VERIFY_PARAM_set1_host\",\n \"X509_VERIFY_PARAM_set1_email\",\n \"X509_VERIFY_PARAM_set1_ip\",\n \"X509_VERIFY_PARAM_set1_ip_asc\",\n \"X509_VERIFY_PARAM_set_hostflags\",\n \"SSL_get0_param\",\n \"X509_CHECK_FLAG_ALWAYS_CHECK_SUBJECT\",\n \"X509_CHECK_FLAG_NO_WILDCARDS\",\n \"X509_CHECK_FLAG_NO_PARTIAL_WILDCARDS\",\n \"X509_CHECK_FLAG_MULTI_LABEL_WILDCARDS\",\n \"X509_CHECK_FLAG_SINGLE_LABEL_SUBDOMAINS\"\n ]\n\n\ndef cryptography_has_110_verification_params():\n return [\n \"X509_CHECK_FLAG_NEVER_CHECK_SUBJECT\"\n ]\n\n\ndef cryptography_has_x509_v_flag_trusted_first():\n return [\n \"X509_V_FLAG_TRUSTED_FIRST\",\n ]\n\n\ndef cryptography_has_x509_v_flag_partial_chain():\n return [\n \"X509_V_FLAG_PARTIAL_CHAIN\",\n ]\n\n\ndef cryptography_has_set_cert_cb():\n return [\n \"SSL_CTX_set_cert_cb\",\n \"SSL_set_cert_cb\",\n ]\n\n\ndef cryptography_has_ssl_st():\n return [\n \"SSL_ST_BEFORE\",\n \"SSL_ST_OK\",\n \"SSL_ST_INIT\",\n \"SSL_ST_RENEGOTIATE\",\n ]\n\n\ndef cryptography_has_tls_st():\n return [\n \"TLS_ST_BEFORE\",\n \"TLS_ST_OK\",\n ]\n\n\ndef cryptography_has_locking_callbacks():\n return [\n \"Cryptography_setup_ssl_threads\",\n ]\n\n\ndef cryptography_has_scrypt():\n return [\n \"EVP_PBE_scrypt\",\n ]\n\n\ndef cryptography_has_generic_dtls_method():\n return [\n \"DTLS_method\",\n \"DTLS_server_method\",\n \"DTLS_client_method\",\n \"SSL_OP_NO_DTLSv1\",\n \"SSL_OP_NO_DTLSv1_2\",\n \"DTLS_set_link_mtu\",\n \"DTLS_get_link_min_mtu\",\n ]\n\n\ndef cryptography_has_evp_pkey_dhx():\n return [\n \"EVP_PKEY_DHX\",\n ]\n\n\ndef cryptography_has_mem_functions():\n return [\n \"Cryptography_CRYPTO_set_mem_functions\",\n ]\n\n\ndef cryptography_has_sct():\n return [\n \"SCT_get_version\",\n \"SCT_get_log_entry_type\",\n \"SCT_get0_log_id\",\n \"SCT_get0_signature\",\n \"SCT_get_timestamp\",\n \"SCT_set_source\",\n \"sk_SCT_num\",\n \"sk_SCT_value\",\n \"SCT_LIST_free\",\n \"sk_SCT_push\",\n \"sk_SCT_new_null\",\n \"SCT_new\",\n \"SCT_set1_log_id\",\n \"SCT_set_timestamp\",\n \"SCT_set_version\",\n \"SCT_set_log_entry_type\",\n ]\n\n\ndef cryptography_has_x509_store_ctx_get_issuer():\n return [\n \"X509_STORE_get_get_issuer\",\n \"X509_STORE_set_get_issuer\",\n ]\n\n\ndef cryptography_has_x25519():\n return [\n \"EVP_PKEY_X25519\",\n \"NID_X25519\",\n ]\n\n\ndef cryptography_has_x448():\n return [\n \"EVP_PKEY_X448\",\n \"NID_X448\",\n ]\n\n\ndef cryptography_has_ed448():\n return [\n \"EVP_PKEY_ED448\",\n \"NID_ED448\",\n ]\n\n\ndef cryptography_has_ed25519():\n return [\n \"NID_ED25519\",\n \"EVP_PKEY_ED25519\",\n ]\n\n\ndef cryptography_has_poly1305():\n return [\n \"NID_poly1305\",\n \"EVP_PKEY_POLY1305\",\n ]\n\n\ndef cryptography_has_oneshot_evp_digest_sign_verify():\n return [\n \"EVP_DigestSign\",\n \"EVP_DigestVerify\",\n ]\n\n\ndef cryptography_has_evp_digestfinal_xof():\n return [\n \"EVP_DigestFinalXOF\",\n ]\n\n\ndef cryptography_has_evp_pkey_get_set_tls_encodedpoint():\n return [\n \"EVP_PKEY_get1_tls_encodedpoint\",\n \"EVP_PKEY_set1_tls_encodedpoint\",\n ]\n\n\ndef cryptography_has_fips():\n return [\n \"FIPS_mode_set\",\n \"FIPS_mode\",\n ]\n\n\ndef cryptography_has_ssl_sigalgs():\n return [\n \"SSL_CTX_set1_sigalgs_list\",\n \"SSL_get_sigalgs\",\n ]\n\n\ndef cryptography_has_psk():\n return [\n \"SSL_CTX_use_psk_identity_hint\",\n \"SSL_CTX_set_psk_server_callback\",\n \"SSL_CTX_set_psk_client_callback\",\n ]\n\n\ndef cryptography_has_custom_ext():\n return [\n \"SSL_CTX_add_client_custom_ext\",\n \"SSL_CTX_add_server_custom_ext\",\n \"SSL_extension_supported\",\n ]\n\n\ndef cryptography_has_openssl_cleanup():\n return [\n \"OPENSSL_cleanup\",\n ]\n\n\ndef cryptography_has_cipher_details():\n return [\n \"SSL_CIPHER_is_aead\",\n \"SSL_CIPHER_get_cipher_nid\",\n \"SSL_CIPHER_get_digest_nid\",\n \"SSL_CIPHER_get_kx_nid\",\n \"SSL_CIPHER_get_auth_nid\",\n ]\n\n\ndef cryptography_has_tlsv13():\n return [\n \"SSL_OP_NO_TLSv1_3\",\n \"SSL_VERIFY_POST_HANDSHAKE\",\n \"SSL_CTX_set_ciphersuites\",\n \"SSL_verify_client_post_handshake\",\n \"SSL_CTX_set_post_handshake_auth\",\n \"SSL_set_post_handshake_auth\",\n \"SSL_SESSION_get_max_early_data\",\n \"SSL_write_early_data\",\n \"SSL_read_early_data\",\n \"SSL_CTX_set_max_early_data\",\n ]\n\n\ndef cryptography_has_raw_key():\n return [\n \"EVP_PKEY_new_raw_private_key\",\n \"EVP_PKEY_new_raw_public_key\",\n \"EVP_PKEY_get_raw_private_key\",\n \"EVP_PKEY_get_raw_public_key\",\n ]\n\n\ndef cryptography_has_evp_r_memory_limit_exceeded():\n return [\n \"EVP_R_MEMORY_LIMIT_EXCEEDED\",\n ]\n\n\ndef cryptography_has_engine():\n return [\n \"ENGINE_by_id\",\n \"ENGINE_init\",\n \"ENGINE_finish\",\n \"ENGINE_get_default_RAND\",\n \"ENGINE_set_default_RAND\",\n \"ENGINE_unregister_RAND\",\n \"ENGINE_ctrl_cmd\",\n \"ENGINE_free\",\n \"ENGINE_get_name\",\n \"Cryptography_add_osrandom_engine\",\n ]\n\n\ndef cryptography_has_verified_chain():\n return [\n \"SSL_get0_verified_chain\",\n ]\n\n\n# This is a mapping of\n# {condition: function-returning-names-dependent-on-that-condition} so we can\n# loop over them and delete unsupported names at runtime. It will be removed\n# when cffi supports #if in cdef. We use functions instead of just a dict of\n# lists so we can use coverage to measure which are used.\nCONDITIONAL_NAMES = {\n \"Cryptography_HAS_EC2M\": cryptography_has_ec2m,\n \"Cryptography_HAS_EC_1_0_2\": cryptography_has_ec_1_0_2,\n \"Cryptography_HAS_SET_ECDH_AUTO\": cryptography_has_set_ecdh_auto,\n \"Cryptography_HAS_RSA_R_PKCS_DECODING_ERROR\": (\n cryptography_has_rsa_r_pkcs_decoding_error\n ),\n \"Cryptography_HAS_RSA_OAEP_MD\": cryptography_has_rsa_oaep_md,\n \"Cryptography_HAS_RSA_OAEP_LABEL\": cryptography_has_rsa_oaep_label,\n \"Cryptography_HAS_SSL3_METHOD\": cryptography_has_ssl3_method,\n \"Cryptography_HAS_ALPN\": cryptography_has_alpn,\n \"Cryptography_HAS_COMPRESSION\": cryptography_has_compression,\n \"Cryptography_HAS_GET_SERVER_TMP_KEY\": cryptography_has_get_server_tmp_key,\n \"Cryptography_HAS_102_VERIFICATION_ERROR_CODES\": (\n cryptography_has_102_verification_error_codes\n ),\n \"Cryptography_HAS_102_VERIFICATION_PARAMS\": (\n cryptography_has_102_verification_params\n ),\n \"Cryptography_HAS_110_VERIFICATION_PARAMS\": (\n cryptography_has_110_verification_params\n ),\n \"Cryptography_HAS_X509_V_FLAG_TRUSTED_FIRST\": (\n cryptography_has_x509_v_flag_trusted_first\n ),\n \"Cryptography_HAS_X509_V_FLAG_PARTIAL_CHAIN\": (\n cryptography_has_x509_v_flag_partial_chain\n ),\n \"Cryptography_HAS_SET_CERT_CB\": cryptography_has_set_cert_cb,\n \"Cryptography_HAS_SSL_ST\": cryptography_has_ssl_st,\n \"Cryptography_HAS_TLS_ST\": cryptography_has_tls_st,\n \"Cryptography_HAS_LOCKING_CALLBACKS\": cryptography_has_locking_callbacks,\n \"Cryptography_HAS_SCRYPT\": cryptography_has_scrypt,\n \"Cryptography_HAS_GENERIC_DTLS_METHOD\": (\n cryptography_has_generic_dtls_method\n ),\n \"Cryptography_HAS_EVP_PKEY_DHX\": cryptography_has_evp_pkey_dhx,\n \"Cryptography_HAS_MEM_FUNCTIONS\": cryptography_has_mem_functions,\n \"Cryptography_HAS_SCT\": cryptography_has_sct,\n \"Cryptography_HAS_X509_STORE_CTX_GET_ISSUER\": (\n cryptography_has_x509_store_ctx_get_issuer\n ),\n \"Cryptography_HAS_X25519\": cryptography_has_x25519,\n \"Cryptography_HAS_X448\": cryptography_has_x448,\n \"Cryptography_HAS_ED448\": cryptography_has_ed448,\n \"Cryptography_HAS_ED25519\": cryptography_has_ed25519,\n \"Cryptography_HAS_POLY1305\": cryptography_has_poly1305,\n \"Cryptography_HAS_ONESHOT_EVP_DIGEST_SIGN_VERIFY\": (\n cryptography_has_oneshot_evp_digest_sign_verify\n ),\n \"Cryptography_HAS_EVP_PKEY_get_set_tls_encodedpoint\": (\n cryptography_has_evp_pkey_get_set_tls_encodedpoint\n ),\n \"Cryptography_HAS_FIPS\": cryptography_has_fips,\n \"Cryptography_HAS_SIGALGS\": cryptography_has_ssl_sigalgs,\n \"Cryptography_HAS_PSK\": cryptography_has_psk,\n \"Cryptography_HAS_CUSTOM_EXT\": cryptography_has_custom_ext,\n \"Cryptography_HAS_OPENSSL_CLEANUP\": cryptography_has_openssl_cleanup,\n \"Cryptography_HAS_CIPHER_DETAILS\": cryptography_has_cipher_details,\n \"Cryptography_HAS_TLSv1_3\": cryptography_has_tlsv13,\n \"Cryptography_HAS_RAW_KEY\": cryptography_has_raw_key,\n \"Cryptography_HAS_EVP_DIGESTFINAL_XOF\": (\n cryptography_has_evp_digestfinal_xof\n ),\n \"Cryptography_HAS_EVP_R_MEMORY_LIMIT_EXCEEDED\": (\n cryptography_has_evp_r_memory_limit_exceeded\n ),\n \"Cryptography_HAS_ENGINE\": cryptography_has_engine,\n \"Cryptography_HAS_VERIFIED_CHAIN\": cryptography_has_verified_chain,\n}\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/bindings/openssl/binding.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport collections\nimport threading\nimport types\nimport warnings\n\nimport cryptography\nfrom cryptography import utils\nfrom cryptography.exceptions import InternalError\nfrom cryptography.hazmat.bindings._openssl import ffi, lib\nfrom cryptography.hazmat.bindings.openssl._conditional import CONDITIONAL_NAMES\n\n_OpenSSLErrorWithText = collections.namedtuple(\n \"_OpenSSLErrorWithText\", [\"code\", \"lib\", \"func\", \"reason\", \"reason_text\"]\n)\n\n\nclass _OpenSSLError(object):\n def __init__(self, code, lib, func, reason):\n self._code = code\n self._lib = lib\n self._func = func\n self._reason = reason\n\n def _lib_reason_match(self, lib, reason):\n return lib == self.lib and reason == self.reason\n\n code = utils.read_only_property(\"_code\")\n lib = utils.read_only_property(\"_lib\")\n func = utils.read_only_property(\"_func\")\n reason = utils.read_only_property(\"_reason\")\n\n\ndef _consume_errors(lib):\n errors = []\n while True:\n code = lib.ERR_get_error()\n if code == 0:\n break\n\n err_lib = lib.ERR_GET_LIB(code)\n err_func = lib.ERR_GET_FUNC(code)\n err_reason = lib.ERR_GET_REASON(code)\n\n errors.append(_OpenSSLError(code, err_lib, err_func, err_reason))\n\n return errors\n\n\ndef _openssl_assert(lib, ok):\n if not ok:\n errors = _consume_errors(lib)\n errors_with_text = []\n for err in errors:\n buf = ffi.new(\"char[]\", 256)\n lib.ERR_error_string_n(err.code, buf, len(buf))\n err_text_reason = ffi.string(buf)\n\n errors_with_text.append(\n _OpenSSLErrorWithText(\n err.code, err.lib, err.func, err.reason, err_text_reason\n )\n )\n\n raise InternalError(\n \"Unknown OpenSSL error. This error is commonly encountered when \"\n \"another library is not cleaning up the OpenSSL error stack. If \"\n \"you are using cryptography with another library that uses \"\n \"OpenSSL try disabling it before reporting a bug. Otherwise \"\n \"please file an issue at https://github.com/pyca/cryptography/\"\n \"issues with information on how to reproduce \"\n \"this. ({0!r})\".format(errors_with_text),\n errors_with_text\n )\n\n\ndef build_conditional_library(lib, conditional_names):\n conditional_lib = types.ModuleType(\"lib\")\n conditional_lib._original_lib = lib\n excluded_names = set()\n for condition, names_cb in conditional_names.items():\n if not getattr(lib, condition):\n excluded_names.update(names_cb())\n\n for attr in dir(lib):\n if attr not in excluded_names:\n setattr(conditional_lib, attr, getattr(lib, attr))\n\n return conditional_lib\n\n\nclass Binding(object):\n \"\"\"\n OpenSSL API wrapper.\n \"\"\"\n lib = None\n ffi = ffi\n _lib_loaded = False\n _init_lock = threading.Lock()\n _lock_init_lock = threading.Lock()\n\n def __init__(self):\n self._ensure_ffi_initialized()\n\n @classmethod\n def _register_osrandom_engine(cls):\n # Clear any errors extant in the queue before we start. In many\n # scenarios other things may be interacting with OpenSSL in the same\n # process space and it has proven untenable to assume that they will\n # reliably clear the error queue. Once we clear it here we will\n # error on any subsequent unexpected item in the stack.\n cls.lib.ERR_clear_error()\n if cls.lib.Cryptography_HAS_ENGINE:\n result = cls.lib.Cryptography_add_osrandom_engine()\n _openssl_assert(cls.lib, result in (1, 2))\n\n @classmethod\n def _ensure_ffi_initialized(cls):\n with cls._init_lock:\n if not cls._lib_loaded:\n cls.lib = build_conditional_library(lib, CONDITIONAL_NAMES)\n cls._lib_loaded = True\n # initialize the SSL library\n cls.lib.SSL_library_init()\n # adds all ciphers/digests for EVP\n cls.lib.OpenSSL_add_all_algorithms()\n # loads error strings for libcrypto and libssl functions\n cls.lib.SSL_load_error_strings()\n cls._register_osrandom_engine()\n\n @classmethod\n def init_static_locks(cls):\n with cls._lock_init_lock:\n cls._ensure_ffi_initialized()\n # Use Python's implementation if available, importing _ssl triggers\n # the setup for this.\n __import__(\"_ssl\")\n\n if (not cls.lib.Cryptography_HAS_LOCKING_CALLBACKS or\n cls.lib.CRYPTO_get_locking_callback() != cls.ffi.NULL):\n return\n\n # If nothing else has setup a locking callback already, we set up\n # our own\n res = lib.Cryptography_setup_ssl_threads()\n _openssl_assert(cls.lib, res == 1)\n\n\ndef _verify_openssl_version(lib):\n if (\n lib.CRYPTOGRAPHY_OPENSSL_LESS_THAN_102 and\n not lib.CRYPTOGRAPHY_IS_LIBRESSL\n ):\n warnings.warn(\n \"OpenSSL version 1.0.1 is no longer supported by the OpenSSL \"\n \"project, please upgrade. The next version of cryptography will \"\n \"drop support for it.\",\n utils.CryptographyDeprecationWarning\n )\n\n\ndef _verify_package_version(version):\n # Occasionally we run into situations where the version of the Python\n # package does not match the version of the shared object that is loaded.\n # This may occur in environments where multiple versions of cryptography\n # are installed and available in the python path. To avoid errors cropping\n # up later this code checks that the currently imported package and the\n # shared object that were loaded have the same version and raise an\n # ImportError if they do not\n so_package_version = ffi.string(lib.CRYPTOGRAPHY_PACKAGE_VERSION)\n if version.encode(\"ascii\") != so_package_version:\n raise ImportError(\n \"The version of cryptography does not match the loaded \"\n \"shared object. This can happen if you have multiple copies of \"\n \"cryptography installed in your Python path. Please try creating \"\n \"a new virtual environment to resolve this issue. \"\n \"Loaded python version: {}, shared object version: {}\".format(\n version, so_package_version\n )\n )\n\n\n_verify_package_version(cryptography.__version__)\n\n# OpenSSL is not thread safe until the locks are initialized. We call this\n# method in module scope so that it executes with the import lock. On\n# Pythons < 3.4 this import lock is a global lock, which can prevent a race\n# condition registering the OpenSSL locks. On Python 3.4+ the import lock\n# is per module so this approach will not work.\nBinding.init_static_locks()\n\n_verify_openssl_version(Binding.lib)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/__init__.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/asymmetric/__init__.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport abc\n\nimport six\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass AsymmetricSignatureContext(object):\n @abc.abstractmethod\n def update(self, data):\n \"\"\"\n Processes the provided bytes and returns nothing.\n \"\"\"\n\n @abc.abstractmethod\n def finalize(self):\n \"\"\"\n Returns the signature as bytes.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass AsymmetricVerificationContext(object):\n @abc.abstractmethod\n def update(self, data):\n \"\"\"\n Processes the provided bytes and returns nothing.\n \"\"\"\n\n @abc.abstractmethod\n def verify(self):\n \"\"\"\n Raises an exception if the bytes provided to update do not match the\n signature or the signature does not match the public key.\n \"\"\"\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/asymmetric/dh.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport abc\n\nimport six\n\nfrom cryptography import utils\n\n\ndef generate_parameters(generator, key_size, backend):\n return backend.generate_dh_parameters(generator, key_size)\n\n\nclass DHPrivateNumbers(object):\n def __init__(self, x, public_numbers):\n if not isinstance(x, six.integer_types):\n raise TypeError(\"x must be an integer.\")\n\n if not isinstance(public_numbers, DHPublicNumbers):\n raise TypeError(\"public_numbers must be an instance of \"\n \"DHPublicNumbers.\")\n\n self._x = x\n self._public_numbers = public_numbers\n\n def __eq__(self, other):\n if not isinstance(other, DHPrivateNumbers):\n return NotImplemented\n\n return (\n self._x == other._x and\n self._public_numbers == other._public_numbers\n )\n\n def __ne__(self, other):\n return not self == other\n\n def private_key(self, backend):\n return backend.load_dh_private_numbers(self)\n\n public_numbers = utils.read_only_property(\"_public_numbers\")\n x = utils.read_only_property(\"_x\")\n\n\nclass DHPublicNumbers(object):\n def __init__(self, y, parameter_numbers):\n if not isinstance(y, six.integer_types):\n raise TypeError(\"y must be an integer.\")\n\n if not isinstance(parameter_numbers, DHParameterNumbers):\n raise TypeError(\n \"parameters must be an instance of DHParameterNumbers.\")\n\n self._y = y\n self._parameter_numbers = parameter_numbers\n\n def __eq__(self, other):\n if not isinstance(other, DHPublicNumbers):\n return NotImplemented\n\n return (\n self._y == other._y and\n self._parameter_numbers == other._parameter_numbers\n )\n\n def __ne__(self, other):\n return not self == other\n\n def public_key(self, backend):\n return backend.load_dh_public_numbers(self)\n\n y = utils.read_only_property(\"_y\")\n parameter_numbers = utils.read_only_property(\"_parameter_numbers\")\n\n\nclass DHParameterNumbers(object):\n def __init__(self, p, g, q=None):\n if (\n not isinstance(p, six.integer_types) or\n not isinstance(g, six.integer_types)\n ):\n raise TypeError(\"p and g must be integers\")\n if q is not None and not isinstance(q, six.integer_types):\n raise TypeError(\"q must be integer or None\")\n\n if g < 2:\n raise ValueError(\"DH generator must be 2 or greater\")\n\n self._p = p\n self._g = g\n self._q = q\n\n def __eq__(self, other):\n if not isinstance(other, DHParameterNumbers):\n return NotImplemented\n\n return (\n self._p == other._p and\n self._g == other._g and\n self._q == other._q\n )\n\n def __ne__(self, other):\n return not self == other\n\n def parameters(self, backend):\n return backend.load_dh_parameter_numbers(self)\n\n p = utils.read_only_property(\"_p\")\n g = utils.read_only_property(\"_g\")\n q = utils.read_only_property(\"_q\")\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass DHParameters(object):\n @abc.abstractmethod\n def generate_private_key(self):\n \"\"\"\n Generates and returns a DHPrivateKey.\n \"\"\"\n\n @abc.abstractmethod\n def parameter_bytes(self, encoding, format):\n \"\"\"\n Returns the parameters serialized as bytes.\n \"\"\"\n\n @abc.abstractmethod\n def parameter_numbers(self):\n \"\"\"\n Returns a DHParameterNumbers.\n \"\"\"\n\n\nDHParametersWithSerialization = DHParameters\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass DHPrivateKey(object):\n @abc.abstractproperty\n def key_size(self):\n \"\"\"\n The bit length of the prime modulus.\n \"\"\"\n\n @abc.abstractmethod\n def public_key(self):\n \"\"\"\n The DHPublicKey associated with this private key.\n \"\"\"\n\n @abc.abstractmethod\n def parameters(self):\n \"\"\"\n The DHParameters object associated with this private key.\n \"\"\"\n\n @abc.abstractmethod\n def exchange(self, peer_public_key):\n \"\"\"\n Given peer's DHPublicKey, carry out the key exchange and\n return shared key as bytes.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass DHPrivateKeyWithSerialization(DHPrivateKey):\n @abc.abstractmethod\n def private_numbers(self):\n \"\"\"\n Returns a DHPrivateNumbers.\n \"\"\"\n\n @abc.abstractmethod\n def private_bytes(self, encoding, format, encryption_algorithm):\n \"\"\"\n Returns the key serialized as bytes.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass DHPublicKey(object):\n @abc.abstractproperty\n def key_size(self):\n \"\"\"\n The bit length of the prime modulus.\n \"\"\"\n\n @abc.abstractmethod\n def parameters(self):\n \"\"\"\n The DHParameters object associated with this public key.\n \"\"\"\n\n @abc.abstractmethod\n def public_numbers(self):\n \"\"\"\n Returns a DHPublicNumbers.\n \"\"\"\n\n @abc.abstractmethod\n def public_bytes(self, encoding, format):\n \"\"\"\n Returns the key serialized as bytes.\n \"\"\"\n\n\nDHPublicKeyWithSerialization = DHPublicKey\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/asymmetric/dsa.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport abc\n\nimport six\n\nfrom cryptography import utils\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass DSAParameters(object):\n @abc.abstractmethod\n def generate_private_key(self):\n \"\"\"\n Generates and returns a DSAPrivateKey.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass DSAParametersWithNumbers(DSAParameters):\n @abc.abstractmethod\n def parameter_numbers(self):\n \"\"\"\n Returns a DSAParameterNumbers.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass DSAPrivateKey(object):\n @abc.abstractproperty\n def key_size(self):\n \"\"\"\n The bit length of the prime modulus.\n \"\"\"\n\n @abc.abstractmethod\n def public_key(self):\n \"\"\"\n The DSAPublicKey associated with this private key.\n \"\"\"\n\n @abc.abstractmethod\n def parameters(self):\n \"\"\"\n The DSAParameters object associated with this private key.\n \"\"\"\n\n @abc.abstractmethod\n def signer(self, signature_algorithm):\n \"\"\"\n Returns an AsymmetricSignatureContext used for signing data.\n \"\"\"\n\n @abc.abstractmethod\n def sign(self, data, algorithm):\n \"\"\"\n Signs the data\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass DSAPrivateKeyWithSerialization(DSAPrivateKey):\n @abc.abstractmethod\n def private_numbers(self):\n \"\"\"\n Returns a DSAPrivateNumbers.\n \"\"\"\n\n @abc.abstractmethod\n def private_bytes(self, encoding, format, encryption_algorithm):\n \"\"\"\n Returns the key serialized as bytes.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass DSAPublicKey(object):\n @abc.abstractproperty\n def key_size(self):\n \"\"\"\n The bit length of the prime modulus.\n \"\"\"\n\n @abc.abstractmethod\n def parameters(self):\n \"\"\"\n The DSAParameters object associated with this public key.\n \"\"\"\n\n @abc.abstractmethod\n def verifier(self, signature, signature_algorithm):\n \"\"\"\n Returns an AsymmetricVerificationContext used for signing data.\n \"\"\"\n\n @abc.abstractmethod\n def public_numbers(self):\n \"\"\"\n Returns a DSAPublicNumbers.\n \"\"\"\n\n @abc.abstractmethod\n def public_bytes(self, encoding, format):\n \"\"\"\n Returns the key serialized as bytes.\n \"\"\"\n\n @abc.abstractmethod\n def verify(self, signature, data, algorithm):\n \"\"\"\n Verifies the signature of the data.\n \"\"\"\n\n\nDSAPublicKeyWithSerialization = DSAPublicKey\n\n\ndef generate_parameters(key_size, backend):\n return backend.generate_dsa_parameters(key_size)\n\n\ndef generate_private_key(key_size, backend):\n return backend.generate_dsa_private_key_and_parameters(key_size)\n\n\ndef _check_dsa_parameters(parameters):\n if parameters.p.bit_length() not in [1024, 2048, 3072]:\n raise ValueError(\"p must be exactly 1024, 2048, or 3072 bits long\")\n if parameters.q.bit_length() not in [160, 224, 256]:\n raise ValueError(\"q must be exactly 160, 224, or 256 bits long\")\n\n if not (1 < parameters.g < parameters.p):\n raise ValueError(\"g, p don't satisfy 1 < g < p.\")\n\n\ndef _check_dsa_private_numbers(numbers):\n parameters = numbers.public_numbers.parameter_numbers\n _check_dsa_parameters(parameters)\n if numbers.x <= 0 or numbers.x >= parameters.q:\n raise ValueError(\"x must be > 0 and < q.\")\n\n if numbers.public_numbers.y != pow(parameters.g, numbers.x, parameters.p):\n raise ValueError(\"y must be equal to (g ** x % p).\")\n\n\nclass DSAParameterNumbers(object):\n def __init__(self, p, q, g):\n if (\n not isinstance(p, six.integer_types) or\n not isinstance(q, six.integer_types) or\n not isinstance(g, six.integer_types)\n ):\n raise TypeError(\n \"DSAParameterNumbers p, q, and g arguments must be integers.\"\n )\n\n self._p = p\n self._q = q\n self._g = g\n\n p = utils.read_only_property(\"_p\")\n q = utils.read_only_property(\"_q\")\n g = utils.read_only_property(\"_g\")\n\n def parameters(self, backend):\n return backend.load_dsa_parameter_numbers(self)\n\n def __eq__(self, other):\n if not isinstance(other, DSAParameterNumbers):\n return NotImplemented\n\n return self.p == other.p and self.q == other.q and self.g == other.g\n\n def __ne__(self, other):\n return not self == other\n\n def __repr__(self):\n return (\n \"\".format(\n self=self\n )\n )\n\n\nclass DSAPublicNumbers(object):\n def __init__(self, y, parameter_numbers):\n if not isinstance(y, six.integer_types):\n raise TypeError(\"DSAPublicNumbers y argument must be an integer.\")\n\n if not isinstance(parameter_numbers, DSAParameterNumbers):\n raise TypeError(\n \"parameter_numbers must be a DSAParameterNumbers instance.\"\n )\n\n self._y = y\n self._parameter_numbers = parameter_numbers\n\n y = utils.read_only_property(\"_y\")\n parameter_numbers = utils.read_only_property(\"_parameter_numbers\")\n\n def public_key(self, backend):\n return backend.load_dsa_public_numbers(self)\n\n def __eq__(self, other):\n if not isinstance(other, DSAPublicNumbers):\n return NotImplemented\n\n return (\n self.y == other.y and\n self.parameter_numbers == other.parameter_numbers\n )\n\n def __ne__(self, other):\n return not self == other\n\n def __repr__(self):\n return (\n \"\".format(self=self)\n )\n\n\nclass DSAPrivateNumbers(object):\n def __init__(self, x, public_numbers):\n if not isinstance(x, six.integer_types):\n raise TypeError(\"DSAPrivateNumbers x argument must be an integer.\")\n\n if not isinstance(public_numbers, DSAPublicNumbers):\n raise TypeError(\n \"public_numbers must be a DSAPublicNumbers instance.\"\n )\n self._public_numbers = public_numbers\n self._x = x\n\n x = utils.read_only_property(\"_x\")\n public_numbers = utils.read_only_property(\"_public_numbers\")\n\n def private_key(self, backend):\n return backend.load_dsa_private_numbers(self)\n\n def __eq__(self, other):\n if not isinstance(other, DSAPrivateNumbers):\n return NotImplemented\n\n return (\n self.x == other.x and self.public_numbers == other.public_numbers\n )\n\n def __ne__(self, other):\n return not self == other\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/asymmetric/ec.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport abc\nimport warnings\n\nimport six\n\nfrom cryptography import utils\nfrom cryptography.hazmat._oid import ObjectIdentifier\n\n\nclass EllipticCurveOID(object):\n SECP192R1 = ObjectIdentifier(\"1.2.840.10045.3.1.1\")\n SECP224R1 = ObjectIdentifier(\"1.3.132.0.33\")\n SECP256K1 = ObjectIdentifier(\"1.3.132.0.10\")\n SECP256R1 = ObjectIdentifier(\"1.2.840.10045.3.1.7\")\n SECP384R1 = ObjectIdentifier(\"1.3.132.0.34\")\n SECP521R1 = ObjectIdentifier(\"1.3.132.0.35\")\n BRAINPOOLP256R1 = ObjectIdentifier(\"1.3.36.3.3.2.8.1.1.7\")\n BRAINPOOLP384R1 = ObjectIdentifier(\"1.3.36.3.3.2.8.1.1.11\")\n BRAINPOOLP512R1 = ObjectIdentifier(\"1.3.36.3.3.2.8.1.1.13\")\n SECT163K1 = ObjectIdentifier(\"1.3.132.0.1\")\n SECT163R2 = ObjectIdentifier(\"1.3.132.0.15\")\n SECT233K1 = ObjectIdentifier(\"1.3.132.0.26\")\n SECT233R1 = ObjectIdentifier(\"1.3.132.0.27\")\n SECT283K1 = ObjectIdentifier(\"1.3.132.0.16\")\n SECT283R1 = ObjectIdentifier(\"1.3.132.0.17\")\n SECT409K1 = ObjectIdentifier(\"1.3.132.0.36\")\n SECT409R1 = ObjectIdentifier(\"1.3.132.0.37\")\n SECT571K1 = ObjectIdentifier(\"1.3.132.0.38\")\n SECT571R1 = ObjectIdentifier(\"1.3.132.0.39\")\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass EllipticCurve(object):\n @abc.abstractproperty\n def name(self):\n \"\"\"\n The name of the curve. e.g. secp256r1.\n \"\"\"\n\n @abc.abstractproperty\n def key_size(self):\n \"\"\"\n Bit size of a secret scalar for the curve.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass EllipticCurveSignatureAlgorithm(object):\n @abc.abstractproperty\n def algorithm(self):\n \"\"\"\n The digest algorithm used with this signature.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass EllipticCurvePrivateKey(object):\n @abc.abstractmethod\n def signer(self, signature_algorithm):\n \"\"\"\n Returns an AsymmetricSignatureContext used for signing data.\n \"\"\"\n\n @abc.abstractmethod\n def exchange(self, algorithm, peer_public_key):\n \"\"\"\n Performs a key exchange operation using the provided algorithm with the\n provided peer's public key.\n \"\"\"\n\n @abc.abstractmethod\n def public_key(self):\n \"\"\"\n The EllipticCurvePublicKey for this private key.\n \"\"\"\n\n @abc.abstractproperty\n def curve(self):\n \"\"\"\n The EllipticCurve that this key is on.\n \"\"\"\n\n @abc.abstractproperty\n def key_size(self):\n \"\"\"\n Bit size of a secret scalar for the curve.\n \"\"\"\n\n @abc.abstractmethod\n def sign(self, data, signature_algorithm):\n \"\"\"\n Signs the data\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass EllipticCurvePrivateKeyWithSerialization(EllipticCurvePrivateKey):\n @abc.abstractmethod\n def private_numbers(self):\n \"\"\"\n Returns an EllipticCurvePrivateNumbers.\n \"\"\"\n\n @abc.abstractmethod\n def private_bytes(self, encoding, format, encryption_algorithm):\n \"\"\"\n Returns the key serialized as bytes.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass EllipticCurvePublicKey(object):\n @abc.abstractmethod\n def verifier(self, signature, signature_algorithm):\n \"\"\"\n Returns an AsymmetricVerificationContext used for signing data.\n \"\"\"\n\n @abc.abstractproperty\n def curve(self):\n \"\"\"\n The EllipticCurve that this key is on.\n \"\"\"\n\n @abc.abstractproperty\n def key_size(self):\n \"\"\"\n Bit size of a secret scalar for the curve.\n \"\"\"\n\n @abc.abstractmethod\n def public_numbers(self):\n \"\"\"\n Returns an EllipticCurvePublicNumbers.\n \"\"\"\n\n @abc.abstractmethod\n def public_bytes(self, encoding, format):\n \"\"\"\n Returns the key serialized as bytes.\n \"\"\"\n\n @abc.abstractmethod\n def verify(self, signature, data, signature_algorithm):\n \"\"\"\n Verifies the signature of the data.\n \"\"\"\n\n @classmethod\n def from_encoded_point(cls, curve, data):\n utils._check_bytes(\"data\", data)\n\n if not isinstance(curve, EllipticCurve):\n raise TypeError(\"curve must be an EllipticCurve instance\")\n\n if len(data) == 0:\n raise ValueError(\"data must not be an empty byte string\")\n\n if six.indexbytes(data, 0) not in [0x02, 0x03, 0x04]:\n raise ValueError(\"Unsupported elliptic curve point type\")\n\n from cryptography.hazmat.backends.openssl.backend import backend\n return backend.load_elliptic_curve_public_bytes(curve, data)\n\n\nEllipticCurvePublicKeyWithSerialization = EllipticCurvePublicKey\n\n\n@utils.register_interface(EllipticCurve)\nclass SECT571R1(object):\n name = \"sect571r1\"\n key_size = 570\n\n\n@utils.register_interface(EllipticCurve)\nclass SECT409R1(object):\n name = \"sect409r1\"\n key_size = 409\n\n\n@utils.register_interface(EllipticCurve)\nclass SECT283R1(object):\n name = \"sect283r1\"\n key_size = 283\n\n\n@utils.register_interface(EllipticCurve)\nclass SECT233R1(object):\n name = \"sect233r1\"\n key_size = 233\n\n\n@utils.register_interface(EllipticCurve)\nclass SECT163R2(object):\n name = \"sect163r2\"\n key_size = 163\n\n\n@utils.register_interface(EllipticCurve)\nclass SECT571K1(object):\n name = \"sect571k1\"\n key_size = 571\n\n\n@utils.register_interface(EllipticCurve)\nclass SECT409K1(object):\n name = \"sect409k1\"\n key_size = 409\n\n\n@utils.register_interface(EllipticCurve)\nclass SECT283K1(object):\n name = \"sect283k1\"\n key_size = 283\n\n\n@utils.register_interface(EllipticCurve)\nclass SECT233K1(object):\n name = \"sect233k1\"\n key_size = 233\n\n\n@utils.register_interface(EllipticCurve)\nclass SECT163K1(object):\n name = \"sect163k1\"\n key_size = 163\n\n\n@utils.register_interface(EllipticCurve)\nclass SECP521R1(object):\n name = \"secp521r1\"\n key_size = 521\n\n\n@utils.register_interface(EllipticCurve)\nclass SECP384R1(object):\n name = \"secp384r1\"\n key_size = 384\n\n\n@utils.register_interface(EllipticCurve)\nclass SECP256R1(object):\n name = \"secp256r1\"\n key_size = 256\n\n\n@utils.register_interface(EllipticCurve)\nclass SECP256K1(object):\n name = \"secp256k1\"\n key_size = 256\n\n\n@utils.register_interface(EllipticCurve)\nclass SECP224R1(object):\n name = \"secp224r1\"\n key_size = 224\n\n\n@utils.register_interface(EllipticCurve)\nclass SECP192R1(object):\n name = \"secp192r1\"\n key_size = 192\n\n\n@utils.register_interface(EllipticCurve)\nclass BrainpoolP256R1(object):\n name = \"brainpoolP256r1\"\n key_size = 256\n\n\n@utils.register_interface(EllipticCurve)\nclass BrainpoolP384R1(object):\n name = \"brainpoolP384r1\"\n key_size = 384\n\n\n@utils.register_interface(EllipticCurve)\nclass BrainpoolP512R1(object):\n name = \"brainpoolP512r1\"\n key_size = 512\n\n\n_CURVE_TYPES = {\n \"prime192v1\": SECP192R1,\n \"prime256v1\": SECP256R1,\n\n \"secp192r1\": SECP192R1,\n \"secp224r1\": SECP224R1,\n \"secp256r1\": SECP256R1,\n \"secp384r1\": SECP384R1,\n \"secp521r1\": SECP521R1,\n \"secp256k1\": SECP256K1,\n\n \"sect163k1\": SECT163K1,\n \"sect233k1\": SECT233K1,\n \"sect283k1\": SECT283K1,\n \"sect409k1\": SECT409K1,\n \"sect571k1\": SECT571K1,\n\n \"sect163r2\": SECT163R2,\n \"sect233r1\": SECT233R1,\n \"sect283r1\": SECT283R1,\n \"sect409r1\": SECT409R1,\n \"sect571r1\": SECT571R1,\n\n \"brainpoolP256r1\": BrainpoolP256R1,\n \"brainpoolP384r1\": BrainpoolP384R1,\n \"brainpoolP512r1\": BrainpoolP512R1,\n}\n\n\n@utils.register_interface(EllipticCurveSignatureAlgorithm)\nclass ECDSA(object):\n def __init__(self, algorithm):\n self._algorithm = algorithm\n\n algorithm = utils.read_only_property(\"_algorithm\")\n\n\ndef generate_private_key(curve, backend):\n return backend.generate_elliptic_curve_private_key(curve)\n\n\ndef derive_private_key(private_value, curve, backend):\n if not isinstance(private_value, six.integer_types):\n raise TypeError(\"private_value must be an integer type.\")\n\n if private_value <= 0:\n raise ValueError(\"private_value must be a positive integer.\")\n\n if not isinstance(curve, EllipticCurve):\n raise TypeError(\"curve must provide the EllipticCurve interface.\")\n\n return backend.derive_elliptic_curve_private_key(private_value, curve)\n\n\nclass EllipticCurvePublicNumbers(object):\n def __init__(self, x, y, curve):\n if (\n not isinstance(x, six.integer_types) or\n not isinstance(y, six.integer_types)\n ):\n raise TypeError(\"x and y must be integers.\")\n\n if not isinstance(curve, EllipticCurve):\n raise TypeError(\"curve must provide the EllipticCurve interface.\")\n\n self._y = y\n self._x = x\n self._curve = curve\n\n def public_key(self, backend):\n return backend.load_elliptic_curve_public_numbers(self)\n\n def encode_point(self):\n warnings.warn(\n \"encode_point has been deprecated on EllipticCurvePublicNumbers\"\n \" and will be removed in a future version. Please use \"\n \"EllipticCurvePublicKey.public_bytes to obtain both \"\n \"compressed and uncompressed point encoding.\",\n utils.DeprecatedIn25,\n stacklevel=2,\n )\n # key_size is in bits. Convert to bytes and round up\n byte_length = (self.curve.key_size + 7) // 8\n return (\n b'\\x04' + utils.int_to_bytes(self.x, byte_length) +\n utils.int_to_bytes(self.y, byte_length)\n )\n\n @classmethod\n def from_encoded_point(cls, curve, data):\n if not isinstance(curve, EllipticCurve):\n raise TypeError(\"curve must be an EllipticCurve instance\")\n\n warnings.warn(\n \"Support for unsafe construction of public numbers from \"\n \"encoded data will be removed in a future version. \"\n \"Please use EllipticCurvePublicKey.from_encoded_point\",\n utils.DeprecatedIn25,\n stacklevel=2,\n )\n\n if data.startswith(b'\\x04'):\n # key_size is in bits. Convert to bytes and round up\n byte_length = (curve.key_size + 7) // 8\n if len(data) == 2 * byte_length + 1:\n x = utils.int_from_bytes(data[1:byte_length + 1], 'big')\n y = utils.int_from_bytes(data[byte_length + 1:], 'big')\n return cls(x, y, curve)\n else:\n raise ValueError('Invalid elliptic curve point data length')\n else:\n raise ValueError('Unsupported elliptic curve point type')\n\n curve = utils.read_only_property(\"_curve\")\n x = utils.read_only_property(\"_x\")\n y = utils.read_only_property(\"_y\")\n\n def __eq__(self, other):\n if not isinstance(other, EllipticCurvePublicNumbers):\n return NotImplemented\n\n return (\n self.x == other.x and\n self.y == other.y and\n self.curve.name == other.curve.name and\n self.curve.key_size == other.curve.key_size\n )\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash((self.x, self.y, self.curve.name, self.curve.key_size))\n\n def __repr__(self):\n return (\n \"\".format(self)\n )\n\n\nclass EllipticCurvePrivateNumbers(object):\n def __init__(self, private_value, public_numbers):\n if not isinstance(private_value, six.integer_types):\n raise TypeError(\"private_value must be an integer.\")\n\n if not isinstance(public_numbers, EllipticCurvePublicNumbers):\n raise TypeError(\n \"public_numbers must be an EllipticCurvePublicNumbers \"\n \"instance.\"\n )\n\n self._private_value = private_value\n self._public_numbers = public_numbers\n\n def private_key(self, backend):\n return backend.load_elliptic_curve_private_numbers(self)\n\n private_value = utils.read_only_property(\"_private_value\")\n public_numbers = utils.read_only_property(\"_public_numbers\")\n\n def __eq__(self, other):\n if not isinstance(other, EllipticCurvePrivateNumbers):\n return NotImplemented\n\n return (\n self.private_value == other.private_value and\n self.public_numbers == other.public_numbers\n )\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash((self.private_value, self.public_numbers))\n\n\nclass ECDH(object):\n pass\n\n\n_OID_TO_CURVE = {\n EllipticCurveOID.SECP192R1: SECP192R1,\n EllipticCurveOID.SECP224R1: SECP224R1,\n EllipticCurveOID.SECP256K1: SECP256K1,\n EllipticCurveOID.SECP256R1: SECP256R1,\n EllipticCurveOID.SECP384R1: SECP384R1,\n EllipticCurveOID.SECP521R1: SECP521R1,\n EllipticCurveOID.BRAINPOOLP256R1: BrainpoolP256R1,\n EllipticCurveOID.BRAINPOOLP384R1: BrainpoolP384R1,\n EllipticCurveOID.BRAINPOOLP512R1: BrainpoolP512R1,\n EllipticCurveOID.SECT163K1: SECT163K1,\n EllipticCurveOID.SECT163R2: SECT163R2,\n EllipticCurveOID.SECT233K1: SECT233K1,\n EllipticCurveOID.SECT233R1: SECT233R1,\n EllipticCurveOID.SECT283K1: SECT283K1,\n EllipticCurveOID.SECT283R1: SECT283R1,\n EllipticCurveOID.SECT409K1: SECT409K1,\n EllipticCurveOID.SECT409R1: SECT409R1,\n EllipticCurveOID.SECT571K1: SECT571K1,\n EllipticCurveOID.SECT571R1: SECT571R1,\n}\n\n\ndef get_curve_for_oid(oid):\n try:\n return _OID_TO_CURVE[oid]\n except KeyError:\n raise LookupError(\n \"The provided object identifier has no matching elliptic \"\n \"curve class\"\n )\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/asymmetric/ed25519.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport abc\n\nimport six\n\nfrom cryptography.exceptions import UnsupportedAlgorithm, _Reasons\n\n\n_ED25519_KEY_SIZE = 32\n_ED25519_SIG_SIZE = 64\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass Ed25519PublicKey(object):\n @classmethod\n def from_public_bytes(cls, data):\n from cryptography.hazmat.backends.openssl.backend import backend\n if not backend.ed25519_supported():\n raise UnsupportedAlgorithm(\n \"ed25519 is not supported by this version of OpenSSL.\",\n _Reasons.UNSUPPORTED_PUBLIC_KEY_ALGORITHM\n )\n\n return backend.ed25519_load_public_bytes(data)\n\n @abc.abstractmethod\n def public_bytes(self, encoding, format):\n \"\"\"\n The serialized bytes of the public key.\n \"\"\"\n\n @abc.abstractmethod\n def verify(self, signature, data):\n \"\"\"\n Verify the signature.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass Ed25519PrivateKey(object):\n @classmethod\n def generate(cls):\n from cryptography.hazmat.backends.openssl.backend import backend\n if not backend.ed25519_supported():\n raise UnsupportedAlgorithm(\n \"ed25519 is not supported by this version of OpenSSL.\",\n _Reasons.UNSUPPORTED_PUBLIC_KEY_ALGORITHM\n )\n\n return backend.ed25519_generate_key()\n\n @classmethod\n def from_private_bytes(cls, data):\n from cryptography.hazmat.backends.openssl.backend import backend\n if not backend.ed25519_supported():\n raise UnsupportedAlgorithm(\n \"ed25519 is not supported by this version of OpenSSL.\",\n _Reasons.UNSUPPORTED_PUBLIC_KEY_ALGORITHM\n )\n\n return backend.ed25519_load_private_bytes(data)\n\n @abc.abstractmethod\n def public_key(self):\n \"\"\"\n The Ed25519PublicKey derived from the private key.\n \"\"\"\n\n @abc.abstractmethod\n def private_bytes(self, encoding, format, encryption_algorithm):\n \"\"\"\n The serialized bytes of the private key.\n \"\"\"\n\n @abc.abstractmethod\n def sign(self, data):\n \"\"\"\n Signs the data.\n \"\"\"\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/asymmetric/ed448.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport abc\n\nimport six\n\nfrom cryptography.exceptions import UnsupportedAlgorithm, _Reasons\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass Ed448PublicKey(object):\n @classmethod\n def from_public_bytes(cls, data):\n from cryptography.hazmat.backends.openssl.backend import backend\n if not backend.ed448_supported():\n raise UnsupportedAlgorithm(\n \"ed448 is not supported by this version of OpenSSL.\",\n _Reasons.UNSUPPORTED_PUBLIC_KEY_ALGORITHM\n )\n\n return backend.ed448_load_public_bytes(data)\n\n @abc.abstractmethod\n def public_bytes(self, encoding, format):\n \"\"\"\n The serialized bytes of the public key.\n \"\"\"\n\n @abc.abstractmethod\n def verify(self, signature, data):\n \"\"\"\n Verify the signature.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass Ed448PrivateKey(object):\n @classmethod\n def generate(cls):\n from cryptography.hazmat.backends.openssl.backend import backend\n if not backend.ed448_supported():\n raise UnsupportedAlgorithm(\n \"ed448 is not supported by this version of OpenSSL.\",\n _Reasons.UNSUPPORTED_PUBLIC_KEY_ALGORITHM\n )\n return backend.ed448_generate_key()\n\n @classmethod\n def from_private_bytes(cls, data):\n from cryptography.hazmat.backends.openssl.backend import backend\n if not backend.ed448_supported():\n raise UnsupportedAlgorithm(\n \"ed448 is not supported by this version of OpenSSL.\",\n _Reasons.UNSUPPORTED_PUBLIC_KEY_ALGORITHM\n )\n\n return backend.ed448_load_private_bytes(data)\n\n @abc.abstractmethod\n def public_key(self):\n \"\"\"\n The Ed448PublicKey derived from the private key.\n \"\"\"\n\n @abc.abstractmethod\n def sign(self, data):\n \"\"\"\n Signs the data.\n \"\"\"\n\n @abc.abstractmethod\n def private_bytes(self, encoding, format, encryption_algorithm):\n \"\"\"\n The serialized bytes of the private key.\n \"\"\"\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/asymmetric/padding.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport abc\nimport math\n\nimport six\n\nfrom cryptography import utils\nfrom cryptography.hazmat.primitives import hashes\nfrom cryptography.hazmat.primitives.asymmetric import rsa\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass AsymmetricPadding(object):\n @abc.abstractproperty\n def name(self):\n \"\"\"\n A string naming this padding (e.g. \"PSS\", \"PKCS1\").\n \"\"\"\n\n\n@utils.register_interface(AsymmetricPadding)\nclass PKCS1v15(object):\n name = \"EMSA-PKCS1-v1_5\"\n\n\n@utils.register_interface(AsymmetricPadding)\nclass PSS(object):\n MAX_LENGTH = object()\n name = \"EMSA-PSS\"\n\n def __init__(self, mgf, salt_length):\n self._mgf = mgf\n\n if (not isinstance(salt_length, six.integer_types) and\n salt_length is not self.MAX_LENGTH):\n raise TypeError(\"salt_length must be an integer.\")\n\n if salt_length is not self.MAX_LENGTH and salt_length < 0:\n raise ValueError(\"salt_length must be zero or greater.\")\n\n self._salt_length = salt_length\n\n\n@utils.register_interface(AsymmetricPadding)\nclass OAEP(object):\n name = \"EME-OAEP\"\n\n def __init__(self, mgf, algorithm, label):\n if not isinstance(algorithm, hashes.HashAlgorithm):\n raise TypeError(\"Expected instance of hashes.HashAlgorithm.\")\n\n self._mgf = mgf\n self._algorithm = algorithm\n self._label = label\n\n\nclass MGF1(object):\n MAX_LENGTH = object()\n\n def __init__(self, algorithm):\n if not isinstance(algorithm, hashes.HashAlgorithm):\n raise TypeError(\"Expected instance of hashes.HashAlgorithm.\")\n\n self._algorithm = algorithm\n\n\ndef calculate_max_pss_salt_length(key, hash_algorithm):\n if not isinstance(key, (rsa.RSAPrivateKey, rsa.RSAPublicKey)):\n raise TypeError(\"key must be an RSA public or private key\")\n # bit length - 1 per RFC 3447\n emlen = int(math.ceil((key.key_size - 1) / 8.0))\n salt_length = emlen - hash_algorithm.digest_size - 2\n assert salt_length >= 0\n return salt_length\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/asymmetric/rsa.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport abc\ntry:\n # Only available in math in 3.5+\n from math import gcd\nexcept ImportError:\n from fractions import gcd\n\nimport six\n\nfrom cryptography import utils\nfrom cryptography.exceptions import UnsupportedAlgorithm, _Reasons\nfrom cryptography.hazmat.backends.interfaces import RSABackend\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass RSAPrivateKey(object):\n @abc.abstractmethod\n def signer(self, padding, algorithm):\n \"\"\"\n Returns an AsymmetricSignatureContext used for signing data.\n \"\"\"\n\n @abc.abstractmethod\n def decrypt(self, ciphertext, padding):\n \"\"\"\n Decrypts the provided ciphertext.\n \"\"\"\n\n @abc.abstractproperty\n def key_size(self):\n \"\"\"\n The bit length of the public modulus.\n \"\"\"\n\n @abc.abstractmethod\n def public_key(self):\n \"\"\"\n The RSAPublicKey associated with this private key.\n \"\"\"\n\n @abc.abstractmethod\n def sign(self, data, padding, algorithm):\n \"\"\"\n Signs the data.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass RSAPrivateKeyWithSerialization(RSAPrivateKey):\n @abc.abstractmethod\n def private_numbers(self):\n \"\"\"\n Returns an RSAPrivateNumbers.\n \"\"\"\n\n @abc.abstractmethod\n def private_bytes(self, encoding, format, encryption_algorithm):\n \"\"\"\n Returns the key serialized as bytes.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass RSAPublicKey(object):\n @abc.abstractmethod\n def verifier(self, signature, padding, algorithm):\n \"\"\"\n Returns an AsymmetricVerificationContext used for verifying signatures.\n \"\"\"\n\n @abc.abstractmethod\n def encrypt(self, plaintext, padding):\n \"\"\"\n Encrypts the given plaintext.\n \"\"\"\n\n @abc.abstractproperty\n def key_size(self):\n \"\"\"\n The bit length of the public modulus.\n \"\"\"\n\n @abc.abstractmethod\n def public_numbers(self):\n \"\"\"\n Returns an RSAPublicNumbers\n \"\"\"\n\n @abc.abstractmethod\n def public_bytes(self, encoding, format):\n \"\"\"\n Returns the key serialized as bytes.\n \"\"\"\n\n @abc.abstractmethod\n def verify(self, signature, data, padding, algorithm):\n \"\"\"\n Verifies the signature of the data.\n \"\"\"\n\n\nRSAPublicKeyWithSerialization = RSAPublicKey\n\n\ndef generate_private_key(public_exponent, key_size, backend):\n if not isinstance(backend, RSABackend):\n raise UnsupportedAlgorithm(\n \"Backend object does not implement RSABackend.\",\n _Reasons.BACKEND_MISSING_INTERFACE\n )\n\n _verify_rsa_parameters(public_exponent, key_size)\n return backend.generate_rsa_private_key(public_exponent, key_size)\n\n\ndef _verify_rsa_parameters(public_exponent, key_size):\n if public_exponent < 3:\n raise ValueError(\"public_exponent must be >= 3.\")\n\n if public_exponent & 1 == 0:\n raise ValueError(\"public_exponent must be odd.\")\n\n if key_size < 512:\n raise ValueError(\"key_size must be at least 512-bits.\")\n\n\ndef _check_private_key_components(p, q, private_exponent, dmp1, dmq1, iqmp,\n public_exponent, modulus):\n if modulus < 3:\n raise ValueError(\"modulus must be >= 3.\")\n\n if p >= modulus:\n raise ValueError(\"p must be < modulus.\")\n\n if q >= modulus:\n raise ValueError(\"q must be < modulus.\")\n\n if dmp1 >= modulus:\n raise ValueError(\"dmp1 must be < modulus.\")\n\n if dmq1 >= modulus:\n raise ValueError(\"dmq1 must be < modulus.\")\n\n if iqmp >= modulus:\n raise ValueError(\"iqmp must be < modulus.\")\n\n if private_exponent >= modulus:\n raise ValueError(\"private_exponent must be < modulus.\")\n\n if public_exponent < 3 or public_exponent >= modulus:\n raise ValueError(\"public_exponent must be >= 3 and < modulus.\")\n\n if public_exponent & 1 == 0:\n raise ValueError(\"public_exponent must be odd.\")\n\n if dmp1 & 1 == 0:\n raise ValueError(\"dmp1 must be odd.\")\n\n if dmq1 & 1 == 0:\n raise ValueError(\"dmq1 must be odd.\")\n\n if p * q != modulus:\n raise ValueError(\"p*q must equal modulus.\")\n\n\ndef _check_public_key_components(e, n):\n if n < 3:\n raise ValueError(\"n must be >= 3.\")\n\n if e < 3 or e >= n:\n raise ValueError(\"e must be >= 3 and < n.\")\n\n if e & 1 == 0:\n raise ValueError(\"e must be odd.\")\n\n\ndef _modinv(e, m):\n \"\"\"\n Modular Multiplicative Inverse. Returns x such that: (x*e) mod m == 1\n \"\"\"\n x1, y1, x2, y2 = 1, 0, 0, 1\n a, b = e, m\n while b > 0:\n q, r = divmod(a, b)\n xn, yn = x1 - q * x2, y1 - q * y2\n a, b, x1, y1, x2, y2 = b, r, x2, y2, xn, yn\n return x1 % m\n\n\ndef rsa_crt_iqmp(p, q):\n \"\"\"\n Compute the CRT (q ** -1) % p value from RSA primes p and q.\n \"\"\"\n return _modinv(q, p)\n\n\ndef rsa_crt_dmp1(private_exponent, p):\n \"\"\"\n Compute the CRT private_exponent % (p - 1) value from the RSA\n private_exponent (d) and p.\n \"\"\"\n return private_exponent % (p - 1)\n\n\ndef rsa_crt_dmq1(private_exponent, q):\n \"\"\"\n Compute the CRT private_exponent % (q - 1) value from the RSA\n private_exponent (d) and q.\n \"\"\"\n return private_exponent % (q - 1)\n\n\n# Controls the number of iterations rsa_recover_prime_factors will perform\n# to obtain the prime factors. Each iteration increments by 2 so the actual\n# maximum attempts is half this number.\n_MAX_RECOVERY_ATTEMPTS = 1000\n\n\ndef rsa_recover_prime_factors(n, e, d):\n \"\"\"\n Compute factors p and q from the private exponent d. We assume that n has\n no more than two factors. This function is adapted from code in PyCrypto.\n \"\"\"\n # See 8.2.2(i) in Handbook of Applied Cryptography.\n ktot = d * e - 1\n # The quantity d*e-1 is a multiple of phi(n), even,\n # and can be represented as t*2^s.\n t = ktot\n while t % 2 == 0:\n t = t // 2\n # Cycle through all multiplicative inverses in Zn.\n # The algorithm is non-deterministic, but there is a 50% chance\n # any candidate a leads to successful factoring.\n # See \"Digitalized Signatures and Public Key Functions as Intractable\n # as Factorization\", M. Rabin, 1979\n spotted = False\n a = 2\n while not spotted and a < _MAX_RECOVERY_ATTEMPTS:\n k = t\n # Cycle through all values a^{t*2^i}=a^k\n while k < ktot:\n cand = pow(a, k, n)\n # Check if a^k is a non-trivial root of unity (mod n)\n if cand != 1 and cand != (n - 1) and pow(cand, 2, n) == 1:\n # We have found a number such that (cand-1)(cand+1)=0 (mod n).\n # Either of the terms divides n.\n p = gcd(cand + 1, n)\n spotted = True\n break\n k *= 2\n # This value was not any good... let's try another!\n a += 2\n if not spotted:\n raise ValueError(\"Unable to compute factors p and q from exponent d.\")\n # Found !\n q, r = divmod(n, p)\n assert r == 0\n p, q = sorted((p, q), reverse=True)\n return (p, q)\n\n\nclass RSAPrivateNumbers(object):\n def __init__(self, p, q, d, dmp1, dmq1, iqmp,\n public_numbers):\n if (\n not isinstance(p, six.integer_types) or\n not isinstance(q, six.integer_types) or\n not isinstance(d, six.integer_types) or\n not isinstance(dmp1, six.integer_types) or\n not isinstance(dmq1, six.integer_types) or\n not isinstance(iqmp, six.integer_types)\n ):\n raise TypeError(\n \"RSAPrivateNumbers p, q, d, dmp1, dmq1, iqmp arguments must\"\n \" all be an integers.\"\n )\n\n if not isinstance(public_numbers, RSAPublicNumbers):\n raise TypeError(\n \"RSAPrivateNumbers public_numbers must be an RSAPublicNumbers\"\n \" instance.\"\n )\n\n self._p = p\n self._q = q\n self._d = d\n self._dmp1 = dmp1\n self._dmq1 = dmq1\n self._iqmp = iqmp\n self._public_numbers = public_numbers\n\n p = utils.read_only_property(\"_p\")\n q = utils.read_only_property(\"_q\")\n d = utils.read_only_property(\"_d\")\n dmp1 = utils.read_only_property(\"_dmp1\")\n dmq1 = utils.read_only_property(\"_dmq1\")\n iqmp = utils.read_only_property(\"_iqmp\")\n public_numbers = utils.read_only_property(\"_public_numbers\")\n\n def private_key(self, backend):\n return backend.load_rsa_private_numbers(self)\n\n def __eq__(self, other):\n if not isinstance(other, RSAPrivateNumbers):\n return NotImplemented\n\n return (\n self.p == other.p and\n self.q == other.q and\n self.d == other.d and\n self.dmp1 == other.dmp1 and\n self.dmq1 == other.dmq1 and\n self.iqmp == other.iqmp and\n self.public_numbers == other.public_numbers\n )\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash((\n self.p,\n self.q,\n self.d,\n self.dmp1,\n self.dmq1,\n self.iqmp,\n self.public_numbers,\n ))\n\n\nclass RSAPublicNumbers(object):\n def __init__(self, e, n):\n if (\n not isinstance(e, six.integer_types) or\n not isinstance(n, six.integer_types)\n ):\n raise TypeError(\"RSAPublicNumbers arguments must be integers.\")\n\n self._e = e\n self._n = n\n\n e = utils.read_only_property(\"_e\")\n n = utils.read_only_property(\"_n\")\n\n def public_key(self, backend):\n return backend.load_rsa_public_numbers(self)\n\n def __repr__(self):\n return \"\".format(self)\n\n def __eq__(self, other):\n if not isinstance(other, RSAPublicNumbers):\n return NotImplemented\n\n return self.e == other.e and self.n == other.n\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash((self.e, self.n))\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/asymmetric/utils.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nfrom cryptography import utils\nfrom cryptography.hazmat._der import (\n DERReader, INTEGER, SEQUENCE, encode_der, encode_der_integer\n)\nfrom cryptography.hazmat.primitives import hashes\n\n\ndef decode_dss_signature(signature):\n with DERReader(signature).read_single_element(SEQUENCE) as seq:\n r = seq.read_element(INTEGER).as_integer()\n s = seq.read_element(INTEGER).as_integer()\n return r, s\n\n\ndef encode_dss_signature(r, s):\n return encode_der(\n SEQUENCE,\n encode_der(INTEGER, encode_der_integer(r)),\n encode_der(INTEGER, encode_der_integer(s)),\n )\n\n\nclass Prehashed(object):\n def __init__(self, algorithm):\n if not isinstance(algorithm, hashes.HashAlgorithm):\n raise TypeError(\"Expected instance of HashAlgorithm.\")\n\n self._algorithm = algorithm\n self._digest_size = algorithm.digest_size\n\n digest_size = utils.read_only_property(\"_digest_size\")\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/asymmetric/x25519.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport abc\n\nimport six\n\nfrom cryptography.exceptions import UnsupportedAlgorithm, _Reasons\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass X25519PublicKey(object):\n @classmethod\n def from_public_bytes(cls, data):\n from cryptography.hazmat.backends.openssl.backend import backend\n if not backend.x25519_supported():\n raise UnsupportedAlgorithm(\n \"X25519 is not supported by this version of OpenSSL.\",\n _Reasons.UNSUPPORTED_EXCHANGE_ALGORITHM\n )\n\n return backend.x25519_load_public_bytes(data)\n\n @abc.abstractmethod\n def public_bytes(self, encoding=None, format=None):\n \"\"\"\n The serialized bytes of the public key.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass X25519PrivateKey(object):\n @classmethod\n def generate(cls):\n from cryptography.hazmat.backends.openssl.backend import backend\n if not backend.x25519_supported():\n raise UnsupportedAlgorithm(\n \"X25519 is not supported by this version of OpenSSL.\",\n _Reasons.UNSUPPORTED_EXCHANGE_ALGORITHM\n )\n return backend.x25519_generate_key()\n\n @classmethod\n def from_private_bytes(cls, data):\n from cryptography.hazmat.backends.openssl.backend import backend\n if not backend.x25519_supported():\n raise UnsupportedAlgorithm(\n \"X25519 is not supported by this version of OpenSSL.\",\n _Reasons.UNSUPPORTED_EXCHANGE_ALGORITHM\n )\n\n return backend.x25519_load_private_bytes(data)\n\n @abc.abstractmethod\n def public_key(self):\n \"\"\"\n The serialized bytes of the public key.\n \"\"\"\n\n @abc.abstractmethod\n def private_bytes(self, encoding, format, encryption_algorithm):\n \"\"\"\n The serialized bytes of the private key.\n \"\"\"\n\n @abc.abstractmethod\n def exchange(self, peer_public_key):\n \"\"\"\n Performs a key exchange operation using the provided peer's public key.\n \"\"\"\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/asymmetric/x448.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport abc\n\nimport six\n\nfrom cryptography.exceptions import UnsupportedAlgorithm, _Reasons\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass X448PublicKey(object):\n @classmethod\n def from_public_bytes(cls, data):\n from cryptography.hazmat.backends.openssl.backend import backend\n if not backend.x448_supported():\n raise UnsupportedAlgorithm(\n \"X448 is not supported by this version of OpenSSL.\",\n _Reasons.UNSUPPORTED_EXCHANGE_ALGORITHM\n )\n\n return backend.x448_load_public_bytes(data)\n\n @abc.abstractmethod\n def public_bytes(self, encoding, format):\n \"\"\"\n The serialized bytes of the public key.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass X448PrivateKey(object):\n @classmethod\n def generate(cls):\n from cryptography.hazmat.backends.openssl.backend import backend\n if not backend.x448_supported():\n raise UnsupportedAlgorithm(\n \"X448 is not supported by this version of OpenSSL.\",\n _Reasons.UNSUPPORTED_EXCHANGE_ALGORITHM\n )\n return backend.x448_generate_key()\n\n @classmethod\n def from_private_bytes(cls, data):\n from cryptography.hazmat.backends.openssl.backend import backend\n if not backend.x448_supported():\n raise UnsupportedAlgorithm(\n \"X448 is not supported by this version of OpenSSL.\",\n _Reasons.UNSUPPORTED_EXCHANGE_ALGORITHM\n )\n\n return backend.x448_load_private_bytes(data)\n\n @abc.abstractmethod\n def public_key(self):\n \"\"\"\n The serialized bytes of the public key.\n \"\"\"\n\n @abc.abstractmethod\n def private_bytes(self, encoding, format, encryption_algorithm):\n \"\"\"\n The serialized bytes of the private key.\n \"\"\"\n\n @abc.abstractmethod\n def exchange(self, peer_public_key):\n \"\"\"\n Performs a key exchange operation using the provided peer's public key.\n \"\"\"\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/ciphers/__init__.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nfrom cryptography.hazmat.primitives.ciphers.base import (\n AEADCipherContext, AEADDecryptionContext, AEADEncryptionContext,\n BlockCipherAlgorithm, Cipher, CipherAlgorithm, CipherContext\n)\n\n\n__all__ = [\n \"Cipher\",\n \"CipherAlgorithm\",\n \"BlockCipherAlgorithm\",\n \"CipherContext\",\n \"AEADCipherContext\",\n \"AEADDecryptionContext\",\n \"AEADEncryptionContext\",\n]\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/ciphers/aead.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport os\n\nfrom cryptography import exceptions, utils\nfrom cryptography.hazmat.backends.openssl import aead\nfrom cryptography.hazmat.backends.openssl.backend import backend\n\n\nclass ChaCha20Poly1305(object):\n _MAX_SIZE = 2 ** 32\n\n def __init__(self, key):\n if not backend.aead_cipher_supported(self):\n raise exceptions.UnsupportedAlgorithm(\n \"ChaCha20Poly1305 is not supported by this version of OpenSSL\",\n exceptions._Reasons.UNSUPPORTED_CIPHER\n )\n utils._check_byteslike(\"key\", key)\n\n if len(key) != 32:\n raise ValueError(\"ChaCha20Poly1305 key must be 32 bytes.\")\n\n self._key = key\n\n @classmethod\n def generate_key(cls):\n return os.urandom(32)\n\n def encrypt(self, nonce, data, associated_data):\n if associated_data is None:\n associated_data = b\"\"\n\n if len(data) > self._MAX_SIZE or len(associated_data) > self._MAX_SIZE:\n # This is OverflowError to match what cffi would raise\n raise OverflowError(\n \"Data or associated data too long. Max 2**32 bytes\"\n )\n\n self._check_params(nonce, data, associated_data)\n return aead._encrypt(\n backend, self, nonce, data, associated_data, 16\n )\n\n def decrypt(self, nonce, data, associated_data):\n if associated_data is None:\n associated_data = b\"\"\n\n self._check_params(nonce, data, associated_data)\n return aead._decrypt(\n backend, self, nonce, data, associated_data, 16\n )\n\n def _check_params(self, nonce, data, associated_data):\n utils._check_byteslike(\"nonce\", nonce)\n utils._check_bytes(\"data\", data)\n utils._check_bytes(\"associated_data\", associated_data)\n if len(nonce) != 12:\n raise ValueError(\"Nonce must be 12 bytes\")\n\n\nclass AESCCM(object):\n _MAX_SIZE = 2 ** 32\n\n def __init__(self, key, tag_length=16):\n utils._check_byteslike(\"key\", key)\n if len(key) not in (16, 24, 32):\n raise ValueError(\"AESCCM key must be 128, 192, or 256 bits.\")\n\n self._key = key\n if not isinstance(tag_length, int):\n raise TypeError(\"tag_length must be an integer\")\n\n if tag_length not in (4, 6, 8, 10, 12, 14, 16):\n raise ValueError(\"Invalid tag_length\")\n\n self._tag_length = tag_length\n\n if not backend.aead_cipher_supported(self):\n raise exceptions.UnsupportedAlgorithm(\n \"AESCCM is not supported by this version of OpenSSL\",\n exceptions._Reasons.UNSUPPORTED_CIPHER\n )\n\n @classmethod\n def generate_key(cls, bit_length):\n if not isinstance(bit_length, int):\n raise TypeError(\"bit_length must be an integer\")\n\n if bit_length not in (128, 192, 256):\n raise ValueError(\"bit_length must be 128, 192, or 256\")\n\n return os.urandom(bit_length // 8)\n\n def encrypt(self, nonce, data, associated_data):\n if associated_data is None:\n associated_data = b\"\"\n\n if len(data) > self._MAX_SIZE or len(associated_data) > self._MAX_SIZE:\n # This is OverflowError to match what cffi would raise\n raise OverflowError(\n \"Data or associated data too long. Max 2**32 bytes\"\n )\n\n self._check_params(nonce, data, associated_data)\n self._validate_lengths(nonce, len(data))\n return aead._encrypt(\n backend, self, nonce, data, associated_data, self._tag_length\n )\n\n def decrypt(self, nonce, data, associated_data):\n if associated_data is None:\n associated_data = b\"\"\n\n self._check_params(nonce, data, associated_data)\n return aead._decrypt(\n backend, self, nonce, data, associated_data, self._tag_length\n )\n\n def _validate_lengths(self, nonce, data_len):\n # For information about computing this, see\n # https://tools.ietf.org/html/rfc3610#section-2.1\n l_val = 15 - len(nonce)\n if 2 ** (8 * l_val) < data_len:\n raise ValueError(\"Nonce too long for data\")\n\n def _check_params(self, nonce, data, associated_data):\n utils._check_byteslike(\"nonce\", nonce)\n utils._check_bytes(\"data\", data)\n utils._check_bytes(\"associated_data\", associated_data)\n if not 7 <= len(nonce) <= 13:\n raise ValueError(\"Nonce must be between 7 and 13 bytes\")\n\n\nclass AESGCM(object):\n _MAX_SIZE = 2 ** 32\n\n def __init__(self, key):\n utils._check_byteslike(\"key\", key)\n if len(key) not in (16, 24, 32):\n raise ValueError(\"AESGCM key must be 128, 192, or 256 bits.\")\n\n self._key = key\n\n @classmethod\n def generate_key(cls, bit_length):\n if not isinstance(bit_length, int):\n raise TypeError(\"bit_length must be an integer\")\n\n if bit_length not in (128, 192, 256):\n raise ValueError(\"bit_length must be 128, 192, or 256\")\n\n return os.urandom(bit_length // 8)\n\n def encrypt(self, nonce, data, associated_data):\n if associated_data is None:\n associated_data = b\"\"\n\n if len(data) > self._MAX_SIZE or len(associated_data) > self._MAX_SIZE:\n # This is OverflowError to match what cffi would raise\n raise OverflowError(\n \"Data or associated data too long. Max 2**32 bytes\"\n )\n\n self._check_params(nonce, data, associated_data)\n return aead._encrypt(\n backend, self, nonce, data, associated_data, 16\n )\n\n def decrypt(self, nonce, data, associated_data):\n if associated_data is None:\n associated_data = b\"\"\n\n self._check_params(nonce, data, associated_data)\n return aead._decrypt(\n backend, self, nonce, data, associated_data, 16\n )\n\n def _check_params(self, nonce, data, associated_data):\n utils._check_byteslike(\"nonce\", nonce)\n utils._check_bytes(\"data\", data)\n utils._check_bytes(\"associated_data\", associated_data)\n if len(nonce) == 0:\n raise ValueError(\"Nonce must be at least 1 byte\")\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/ciphers/algorithms.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nfrom cryptography import utils\nfrom cryptography.hazmat.primitives.ciphers import (\n BlockCipherAlgorithm, CipherAlgorithm\n)\nfrom cryptography.hazmat.primitives.ciphers.modes import ModeWithNonce\n\n\ndef _verify_key_size(algorithm, key):\n # Verify that the key is instance of bytes\n utils._check_byteslike(\"key\", key)\n\n # Verify that the key size matches the expected key size\n if len(key) * 8 not in algorithm.key_sizes:\n raise ValueError(\"Invalid key size ({}) for {}.\".format(\n len(key) * 8, algorithm.name\n ))\n return key\n\n\n@utils.register_interface(BlockCipherAlgorithm)\n@utils.register_interface(CipherAlgorithm)\nclass AES(object):\n name = \"AES\"\n block_size = 128\n # 512 added to support AES-256-XTS, which uses 512-bit keys\n key_sizes = frozenset([128, 192, 256, 512])\n\n def __init__(self, key):\n self.key = _verify_key_size(self, key)\n\n @property\n def key_size(self):\n return len(self.key) * 8\n\n\n@utils.register_interface(BlockCipherAlgorithm)\n@utils.register_interface(CipherAlgorithm)\nclass Camellia(object):\n name = \"camellia\"\n block_size = 128\n key_sizes = frozenset([128, 192, 256])\n\n def __init__(self, key):\n self.key = _verify_key_size(self, key)\n\n @property\n def key_size(self):\n return len(self.key) * 8\n\n\n@utils.register_interface(BlockCipherAlgorithm)\n@utils.register_interface(CipherAlgorithm)\nclass TripleDES(object):\n name = \"3DES\"\n block_size = 64\n key_sizes = frozenset([64, 128, 192])\n\n def __init__(self, key):\n if len(key) == 8:\n key += key + key\n elif len(key) == 16:\n key += key[:8]\n self.key = _verify_key_size(self, key)\n\n @property\n def key_size(self):\n return len(self.key) * 8\n\n\n@utils.register_interface(BlockCipherAlgorithm)\n@utils.register_interface(CipherAlgorithm)\nclass Blowfish(object):\n name = \"Blowfish\"\n block_size = 64\n key_sizes = frozenset(range(32, 449, 8))\n\n def __init__(self, key):\n self.key = _verify_key_size(self, key)\n\n @property\n def key_size(self):\n return len(self.key) * 8\n\n\n@utils.register_interface(BlockCipherAlgorithm)\n@utils.register_interface(CipherAlgorithm)\nclass CAST5(object):\n name = \"CAST5\"\n block_size = 64\n key_sizes = frozenset(range(40, 129, 8))\n\n def __init__(self, key):\n self.key = _verify_key_size(self, key)\n\n @property\n def key_size(self):\n return len(self.key) * 8\n\n\n@utils.register_interface(CipherAlgorithm)\nclass ARC4(object):\n name = \"RC4\"\n key_sizes = frozenset([40, 56, 64, 80, 128, 160, 192, 256])\n\n def __init__(self, key):\n self.key = _verify_key_size(self, key)\n\n @property\n def key_size(self):\n return len(self.key) * 8\n\n\n@utils.register_interface(CipherAlgorithm)\nclass IDEA(object):\n name = \"IDEA\"\n block_size = 64\n key_sizes = frozenset([128])\n\n def __init__(self, key):\n self.key = _verify_key_size(self, key)\n\n @property\n def key_size(self):\n return len(self.key) * 8\n\n\n@utils.register_interface(BlockCipherAlgorithm)\n@utils.register_interface(CipherAlgorithm)\nclass SEED(object):\n name = \"SEED\"\n block_size = 128\n key_sizes = frozenset([128])\n\n def __init__(self, key):\n self.key = _verify_key_size(self, key)\n\n @property\n def key_size(self):\n return len(self.key) * 8\n\n\n@utils.register_interface(CipherAlgorithm)\n@utils.register_interface(ModeWithNonce)\nclass ChaCha20(object):\n name = \"ChaCha20\"\n key_sizes = frozenset([256])\n\n def __init__(self, key, nonce):\n self.key = _verify_key_size(self, key)\n utils._check_byteslike(\"nonce\", nonce)\n\n if len(nonce) != 16:\n raise ValueError(\"nonce must be 128-bits (16 bytes)\")\n\n self._nonce = nonce\n\n nonce = utils.read_only_property(\"_nonce\")\n\n @property\n def key_size(self):\n return len(self.key) * 8\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/ciphers/base.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport abc\n\nimport six\n\nfrom cryptography import utils\nfrom cryptography.exceptions import (\n AlreadyFinalized, AlreadyUpdated, NotYetFinalized, UnsupportedAlgorithm,\n _Reasons\n)\nfrom cryptography.hazmat.backends.interfaces import CipherBackend\nfrom cryptography.hazmat.primitives.ciphers import modes\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass CipherAlgorithm(object):\n @abc.abstractproperty\n def name(self):\n \"\"\"\n A string naming this mode (e.g. \"AES\", \"Camellia\").\n \"\"\"\n\n @abc.abstractproperty\n def key_size(self):\n \"\"\"\n The size of the key being used as an integer in bits (e.g. 128, 256).\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass BlockCipherAlgorithm(object):\n @abc.abstractproperty\n def block_size(self):\n \"\"\"\n The size of a block as an integer in bits (e.g. 64, 128).\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass CipherContext(object):\n @abc.abstractmethod\n def update(self, data):\n \"\"\"\n Processes the provided bytes through the cipher and returns the results\n as bytes.\n \"\"\"\n\n @abc.abstractmethod\n def update_into(self, data, buf):\n \"\"\"\n Processes the provided bytes and writes the resulting data into the\n provided buffer. Returns the number of bytes written.\n \"\"\"\n\n @abc.abstractmethod\n def finalize(self):\n \"\"\"\n Returns the results of processing the final block as bytes.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass AEADCipherContext(object):\n @abc.abstractmethod\n def authenticate_additional_data(self, data):\n \"\"\"\n Authenticates the provided bytes.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass AEADDecryptionContext(object):\n @abc.abstractmethod\n def finalize_with_tag(self, tag):\n \"\"\"\n Returns the results of processing the final block as bytes and allows\n delayed passing of the authentication tag.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass AEADEncryptionContext(object):\n @abc.abstractproperty\n def tag(self):\n \"\"\"\n Returns tag bytes. This is only available after encryption is\n finalized.\n \"\"\"\n\n\nclass Cipher(object):\n def __init__(self, algorithm, mode, backend):\n if not isinstance(backend, CipherBackend):\n raise UnsupportedAlgorithm(\n \"Backend object does not implement CipherBackend.\",\n _Reasons.BACKEND_MISSING_INTERFACE\n )\n\n if not isinstance(algorithm, CipherAlgorithm):\n raise TypeError(\"Expected interface of CipherAlgorithm.\")\n\n if mode is not None:\n mode.validate_for_algorithm(algorithm)\n\n self.algorithm = algorithm\n self.mode = mode\n self._backend = backend\n\n def encryptor(self):\n if isinstance(self.mode, modes.ModeWithAuthenticationTag):\n if self.mode.tag is not None:\n raise ValueError(\n \"Authentication tag must be None when encrypting.\"\n )\n ctx = self._backend.create_symmetric_encryption_ctx(\n self.algorithm, self.mode\n )\n return self._wrap_ctx(ctx, encrypt=True)\n\n def decryptor(self):\n ctx = self._backend.create_symmetric_decryption_ctx(\n self.algorithm, self.mode\n )\n return self._wrap_ctx(ctx, encrypt=False)\n\n def _wrap_ctx(self, ctx, encrypt):\n if isinstance(self.mode, modes.ModeWithAuthenticationTag):\n if encrypt:\n return _AEADEncryptionContext(ctx)\n else:\n return _AEADCipherContext(ctx)\n else:\n return _CipherContext(ctx)\n\n\n@utils.register_interface(CipherContext)\nclass _CipherContext(object):\n def __init__(self, ctx):\n self._ctx = ctx\n\n def update(self, data):\n if self._ctx is None:\n raise AlreadyFinalized(\"Context was already finalized.\")\n return self._ctx.update(data)\n\n def update_into(self, data, buf):\n if self._ctx is None:\n raise AlreadyFinalized(\"Context was already finalized.\")\n return self._ctx.update_into(data, buf)\n\n def finalize(self):\n if self._ctx is None:\n raise AlreadyFinalized(\"Context was already finalized.\")\n data = self._ctx.finalize()\n self._ctx = None\n return data\n\n\n@utils.register_interface(AEADCipherContext)\n@utils.register_interface(CipherContext)\n@utils.register_interface(AEADDecryptionContext)\nclass _AEADCipherContext(object):\n def __init__(self, ctx):\n self._ctx = ctx\n self._bytes_processed = 0\n self._aad_bytes_processed = 0\n self._tag = None\n self._updated = False\n\n def _check_limit(self, data_size):\n if self._ctx is None:\n raise AlreadyFinalized(\"Context was already finalized.\")\n self._updated = True\n self._bytes_processed += data_size\n if self._bytes_processed > self._ctx._mode._MAX_ENCRYPTED_BYTES:\n raise ValueError(\n \"{} has a maximum encrypted byte limit of {}\".format(\n self._ctx._mode.name, self._ctx._mode._MAX_ENCRYPTED_BYTES\n )\n )\n\n def update(self, data):\n self._check_limit(len(data))\n return self._ctx.update(data)\n\n def update_into(self, data, buf):\n self._check_limit(len(data))\n return self._ctx.update_into(data, buf)\n\n def finalize(self):\n if self._ctx is None:\n raise AlreadyFinalized(\"Context was already finalized.\")\n data = self._ctx.finalize()\n self._tag = self._ctx.tag\n self._ctx = None\n return data\n\n def finalize_with_tag(self, tag):\n if self._ctx is None:\n raise AlreadyFinalized(\"Context was already finalized.\")\n data = self._ctx.finalize_with_tag(tag)\n self._tag = self._ctx.tag\n self._ctx = None\n return data\n\n def authenticate_additional_data(self, data):\n if self._ctx is None:\n raise AlreadyFinalized(\"Context was already finalized.\")\n if self._updated:\n raise AlreadyUpdated(\"Update has been called on this context.\")\n\n self._aad_bytes_processed += len(data)\n if self._aad_bytes_processed > self._ctx._mode._MAX_AAD_BYTES:\n raise ValueError(\n \"{} has a maximum AAD byte limit of {}\".format(\n self._ctx._mode.name, self._ctx._mode._MAX_AAD_BYTES\n )\n )\n\n self._ctx.authenticate_additional_data(data)\n\n\n@utils.register_interface(AEADEncryptionContext)\nclass _AEADEncryptionContext(_AEADCipherContext):\n @property\n def tag(self):\n if self._ctx is not None:\n raise NotYetFinalized(\"You must finalize encryption before \"\n \"getting the tag.\")\n return self._tag\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/ciphers/modes.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport abc\n\nimport six\n\nfrom cryptography import utils\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass Mode(object):\n @abc.abstractproperty\n def name(self):\n \"\"\"\n A string naming this mode (e.g. \"ECB\", \"CBC\").\n \"\"\"\n\n @abc.abstractmethod\n def validate_for_algorithm(self, algorithm):\n \"\"\"\n Checks that all the necessary invariants of this (mode, algorithm)\n combination are met.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass ModeWithInitializationVector(object):\n @abc.abstractproperty\n def initialization_vector(self):\n \"\"\"\n The value of the initialization vector for this mode as bytes.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass ModeWithTweak(object):\n @abc.abstractproperty\n def tweak(self):\n \"\"\"\n The value of the tweak for this mode as bytes.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass ModeWithNonce(object):\n @abc.abstractproperty\n def nonce(self):\n \"\"\"\n The value of the nonce for this mode as bytes.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass ModeWithAuthenticationTag(object):\n @abc.abstractproperty\n def tag(self):\n \"\"\"\n The value of the tag supplied to the constructor of this mode.\n \"\"\"\n\n\ndef _check_aes_key_length(self, algorithm):\n if algorithm.key_size > 256 and algorithm.name == \"AES\":\n raise ValueError(\n \"Only 128, 192, and 256 bit keys are allowed for this AES mode\"\n )\n\n\ndef _check_iv_length(self, algorithm):\n if len(self.initialization_vector) * 8 != algorithm.block_size:\n raise ValueError(\"Invalid IV size ({}) for {}.\".format(\n len(self.initialization_vector), self.name\n ))\n\n\ndef _check_iv_and_key_length(self, algorithm):\n _check_aes_key_length(self, algorithm)\n _check_iv_length(self, algorithm)\n\n\n@utils.register_interface(Mode)\n@utils.register_interface(ModeWithInitializationVector)\nclass CBC(object):\n name = \"CBC\"\n\n def __init__(self, initialization_vector):\n utils._check_byteslike(\"initialization_vector\", initialization_vector)\n self._initialization_vector = initialization_vector\n\n initialization_vector = utils.read_only_property(\"_initialization_vector\")\n validate_for_algorithm = _check_iv_and_key_length\n\n\n@utils.register_interface(Mode)\n@utils.register_interface(ModeWithTweak)\nclass XTS(object):\n name = \"XTS\"\n\n def __init__(self, tweak):\n utils._check_byteslike(\"tweak\", tweak)\n\n if len(tweak) != 16:\n raise ValueError(\"tweak must be 128-bits (16 bytes)\")\n\n self._tweak = tweak\n\n tweak = utils.read_only_property(\"_tweak\")\n\n def validate_for_algorithm(self, algorithm):\n if algorithm.key_size not in (256, 512):\n raise ValueError(\n \"The XTS specification requires a 256-bit key for AES-128-XTS\"\n \" and 512-bit key for AES-256-XTS\"\n )\n\n\n@utils.register_interface(Mode)\nclass ECB(object):\n name = \"ECB\"\n\n validate_for_algorithm = _check_aes_key_length\n\n\n@utils.register_interface(Mode)\n@utils.register_interface(ModeWithInitializationVector)\nclass OFB(object):\n name = \"OFB\"\n\n def __init__(self, initialization_vector):\n utils._check_byteslike(\"initialization_vector\", initialization_vector)\n self._initialization_vector = initialization_vector\n\n initialization_vector = utils.read_only_property(\"_initialization_vector\")\n validate_for_algorithm = _check_iv_and_key_length\n\n\n@utils.register_interface(Mode)\n@utils.register_interface(ModeWithInitializationVector)\nclass CFB(object):\n name = \"CFB\"\n\n def __init__(self, initialization_vector):\n utils._check_byteslike(\"initialization_vector\", initialization_vector)\n self._initialization_vector = initialization_vector\n\n initialization_vector = utils.read_only_property(\"_initialization_vector\")\n validate_for_algorithm = _check_iv_and_key_length\n\n\n@utils.register_interface(Mode)\n@utils.register_interface(ModeWithInitializationVector)\nclass CFB8(object):\n name = \"CFB8\"\n\n def __init__(self, initialization_vector):\n utils._check_byteslike(\"initialization_vector\", initialization_vector)\n self._initialization_vector = initialization_vector\n\n initialization_vector = utils.read_only_property(\"_initialization_vector\")\n validate_for_algorithm = _check_iv_and_key_length\n\n\n@utils.register_interface(Mode)\n@utils.register_interface(ModeWithNonce)\nclass CTR(object):\n name = \"CTR\"\n\n def __init__(self, nonce):\n utils._check_byteslike(\"nonce\", nonce)\n self._nonce = nonce\n\n nonce = utils.read_only_property(\"_nonce\")\n\n def validate_for_algorithm(self, algorithm):\n _check_aes_key_length(self, algorithm)\n if len(self.nonce) * 8 != algorithm.block_size:\n raise ValueError(\"Invalid nonce size ({}) for {}.\".format(\n len(self.nonce), self.name\n ))\n\n\n@utils.register_interface(Mode)\n@utils.register_interface(ModeWithInitializationVector)\n@utils.register_interface(ModeWithAuthenticationTag)\nclass GCM(object):\n name = \"GCM\"\n _MAX_ENCRYPTED_BYTES = (2 ** 39 - 256) // 8\n _MAX_AAD_BYTES = (2 ** 64) // 8\n\n def __init__(self, initialization_vector, tag=None, min_tag_length=16):\n # len(initialization_vector) must in [1, 2 ** 64), but it's impossible\n # to actually construct a bytes object that large, so we don't check\n # for it\n utils._check_byteslike(\"initialization_vector\", initialization_vector)\n if len(initialization_vector) == 0:\n raise ValueError(\"initialization_vector must be at least 1 byte\")\n self._initialization_vector = initialization_vector\n if tag is not None:\n utils._check_bytes(\"tag\", tag)\n if min_tag_length < 4:\n raise ValueError(\"min_tag_length must be >= 4\")\n if len(tag) < min_tag_length:\n raise ValueError(\n \"Authentication tag must be {} bytes or longer.\".format(\n min_tag_length)\n )\n self._tag = tag\n self._min_tag_length = min_tag_length\n\n tag = utils.read_only_property(\"_tag\")\n initialization_vector = utils.read_only_property(\"_initialization_vector\")\n\n def validate_for_algorithm(self, algorithm):\n _check_aes_key_length(self, algorithm)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/cmac.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nfrom cryptography import utils\nfrom cryptography.exceptions import (\n AlreadyFinalized, UnsupportedAlgorithm, _Reasons\n)\nfrom cryptography.hazmat.backends.interfaces import CMACBackend\nfrom cryptography.hazmat.primitives import ciphers\n\n\nclass CMAC(object):\n def __init__(self, algorithm, backend, ctx=None):\n if not isinstance(backend, CMACBackend):\n raise UnsupportedAlgorithm(\n \"Backend object does not implement CMACBackend.\",\n _Reasons.BACKEND_MISSING_INTERFACE\n )\n\n if not isinstance(algorithm, ciphers.BlockCipherAlgorithm):\n raise TypeError(\n \"Expected instance of BlockCipherAlgorithm.\"\n )\n self._algorithm = algorithm\n\n self._backend = backend\n if ctx is None:\n self._ctx = self._backend.create_cmac_ctx(self._algorithm)\n else:\n self._ctx = ctx\n\n def update(self, data):\n if self._ctx is None:\n raise AlreadyFinalized(\"Context was already finalized.\")\n\n utils._check_bytes(\"data\", data)\n self._ctx.update(data)\n\n def finalize(self):\n if self._ctx is None:\n raise AlreadyFinalized(\"Context was already finalized.\")\n digest = self._ctx.finalize()\n self._ctx = None\n return digest\n\n def verify(self, signature):\n utils._check_bytes(\"signature\", signature)\n if self._ctx is None:\n raise AlreadyFinalized(\"Context was already finalized.\")\n\n ctx, self._ctx = self._ctx, None\n ctx.verify(signature)\n\n def copy(self):\n if self._ctx is None:\n raise AlreadyFinalized(\"Context was already finalized.\")\n return CMAC(\n self._algorithm,\n backend=self._backend,\n ctx=self._ctx.copy()\n )\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/constant_time.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport hmac\nimport warnings\n\nfrom cryptography import utils\nfrom cryptography.hazmat.bindings._constant_time import lib\n\n\nif hasattr(hmac, \"compare_digest\"):\n def bytes_eq(a, b):\n if not isinstance(a, bytes) or not isinstance(b, bytes):\n raise TypeError(\"a and b must be bytes.\")\n\n return hmac.compare_digest(a, b)\n\nelse:\n warnings.warn(\n \"Support for your Python version is deprecated. The next version of \"\n \"cryptography will remove support. Please upgrade to a release \"\n \"(2.7.7+) that supports hmac.compare_digest as soon as possible.\",\n utils.PersistentlyDeprecated2018,\n )\n\n def bytes_eq(a, b):\n if not isinstance(a, bytes) or not isinstance(b, bytes):\n raise TypeError(\"a and b must be bytes.\")\n\n return lib.Cryptography_constant_time_bytes_eq(\n a, len(a), b, len(b)\n ) == 1\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/hashes.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport abc\n\nimport six\n\nfrom cryptography import utils\nfrom cryptography.exceptions import (\n AlreadyFinalized, UnsupportedAlgorithm, _Reasons\n)\nfrom cryptography.hazmat.backends.interfaces import HashBackend\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass HashAlgorithm(object):\n @abc.abstractproperty\n def name(self):\n \"\"\"\n A string naming this algorithm (e.g. \"sha256\", \"md5\").\n \"\"\"\n\n @abc.abstractproperty\n def digest_size(self):\n \"\"\"\n The size of the resulting digest in bytes.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass HashContext(object):\n @abc.abstractproperty\n def algorithm(self):\n \"\"\"\n A HashAlgorithm that will be used by this context.\n \"\"\"\n\n @abc.abstractmethod\n def update(self, data):\n \"\"\"\n Processes the provided bytes through the hash.\n \"\"\"\n\n @abc.abstractmethod\n def finalize(self):\n \"\"\"\n Finalizes the hash context and returns the hash digest as bytes.\n \"\"\"\n\n @abc.abstractmethod\n def copy(self):\n \"\"\"\n Return a HashContext that is a copy of the current context.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass ExtendableOutputFunction(object):\n \"\"\"\n An interface for extendable output functions.\n \"\"\"\n\n\n@utils.register_interface(HashContext)\nclass Hash(object):\n def __init__(self, algorithm, backend, ctx=None):\n if not isinstance(backend, HashBackend):\n raise UnsupportedAlgorithm(\n \"Backend object does not implement HashBackend.\",\n _Reasons.BACKEND_MISSING_INTERFACE\n )\n\n if not isinstance(algorithm, HashAlgorithm):\n raise TypeError(\"Expected instance of hashes.HashAlgorithm.\")\n self._algorithm = algorithm\n\n self._backend = backend\n\n if ctx is None:\n self._ctx = self._backend.create_hash_ctx(self.algorithm)\n else:\n self._ctx = ctx\n\n algorithm = utils.read_only_property(\"_algorithm\")\n\n def update(self, data):\n if self._ctx is None:\n raise AlreadyFinalized(\"Context was already finalized.\")\n utils._check_byteslike(\"data\", data)\n self._ctx.update(data)\n\n def copy(self):\n if self._ctx is None:\n raise AlreadyFinalized(\"Context was already finalized.\")\n return Hash(\n self.algorithm, backend=self._backend, ctx=self._ctx.copy()\n )\n\n def finalize(self):\n if self._ctx is None:\n raise AlreadyFinalized(\"Context was already finalized.\")\n digest = self._ctx.finalize()\n self._ctx = None\n return digest\n\n\n@utils.register_interface(HashAlgorithm)\nclass SHA1(object):\n name = \"sha1\"\n digest_size = 20\n block_size = 64\n\n\n@utils.register_interface(HashAlgorithm)\nclass SHA512_224(object): # noqa: N801\n name = \"sha512-224\"\n digest_size = 28\n block_size = 128\n\n\n@utils.register_interface(HashAlgorithm)\nclass SHA512_256(object): # noqa: N801\n name = \"sha512-256\"\n digest_size = 32\n block_size = 128\n\n\n@utils.register_interface(HashAlgorithm)\nclass SHA224(object):\n name = \"sha224\"\n digest_size = 28\n block_size = 64\n\n\n@utils.register_interface(HashAlgorithm)\nclass SHA256(object):\n name = \"sha256\"\n digest_size = 32\n block_size = 64\n\n\n@utils.register_interface(HashAlgorithm)\nclass SHA384(object):\n name = \"sha384\"\n digest_size = 48\n block_size = 128\n\n\n@utils.register_interface(HashAlgorithm)\nclass SHA512(object):\n name = \"sha512\"\n digest_size = 64\n block_size = 128\n\n\n@utils.register_interface(HashAlgorithm)\nclass SHA3_224(object): # noqa: N801\n name = \"sha3-224\"\n digest_size = 28\n\n\n@utils.register_interface(HashAlgorithm)\nclass SHA3_256(object): # noqa: N801\n name = \"sha3-256\"\n digest_size = 32\n\n\n@utils.register_interface(HashAlgorithm)\nclass SHA3_384(object): # noqa: N801\n name = \"sha3-384\"\n digest_size = 48\n\n\n@utils.register_interface(HashAlgorithm)\nclass SHA3_512(object): # noqa: N801\n name = \"sha3-512\"\n digest_size = 64\n\n\n@utils.register_interface(HashAlgorithm)\n@utils.register_interface(ExtendableOutputFunction)\nclass SHAKE128(object):\n name = \"shake128\"\n\n def __init__(self, digest_size):\n if not isinstance(digest_size, six.integer_types):\n raise TypeError(\"digest_size must be an integer\")\n\n if digest_size < 1:\n raise ValueError(\"digest_size must be a positive integer\")\n\n self._digest_size = digest_size\n\n digest_size = utils.read_only_property(\"_digest_size\")\n\n\n@utils.register_interface(HashAlgorithm)\n@utils.register_interface(ExtendableOutputFunction)\nclass SHAKE256(object):\n name = \"shake256\"\n\n def __init__(self, digest_size):\n if not isinstance(digest_size, six.integer_types):\n raise TypeError(\"digest_size must be an integer\")\n\n if digest_size < 1:\n raise ValueError(\"digest_size must be a positive integer\")\n\n self._digest_size = digest_size\n\n digest_size = utils.read_only_property(\"_digest_size\")\n\n\n@utils.register_interface(HashAlgorithm)\nclass MD5(object):\n name = \"md5\"\n digest_size = 16\n block_size = 64\n\n\n@utils.register_interface(HashAlgorithm)\nclass BLAKE2b(object):\n name = \"blake2b\"\n _max_digest_size = 64\n _min_digest_size = 1\n block_size = 128\n\n def __init__(self, digest_size):\n\n if digest_size != 64:\n raise ValueError(\"Digest size must be 64\")\n\n self._digest_size = digest_size\n\n digest_size = utils.read_only_property(\"_digest_size\")\n\n\n@utils.register_interface(HashAlgorithm)\nclass BLAKE2s(object):\n name = \"blake2s\"\n block_size = 64\n _max_digest_size = 32\n _min_digest_size = 1\n\n def __init__(self, digest_size):\n\n if digest_size != 32:\n raise ValueError(\"Digest size must be 32\")\n\n self._digest_size = digest_size\n\n digest_size = utils.read_only_property(\"_digest_size\")\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/hmac.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nfrom cryptography import utils\nfrom cryptography.exceptions import (\n AlreadyFinalized, UnsupportedAlgorithm, _Reasons\n)\nfrom cryptography.hazmat.backends.interfaces import HMACBackend\nfrom cryptography.hazmat.primitives import hashes\n\n\n@utils.register_interface(hashes.HashContext)\nclass HMAC(object):\n def __init__(self, key, algorithm, backend, ctx=None):\n if not isinstance(backend, HMACBackend):\n raise UnsupportedAlgorithm(\n \"Backend object does not implement HMACBackend.\",\n _Reasons.BACKEND_MISSING_INTERFACE\n )\n\n if not isinstance(algorithm, hashes.HashAlgorithm):\n raise TypeError(\"Expected instance of hashes.HashAlgorithm.\")\n self._algorithm = algorithm\n\n self._backend = backend\n self._key = key\n if ctx is None:\n self._ctx = self._backend.create_hmac_ctx(key, self.algorithm)\n else:\n self._ctx = ctx\n\n algorithm = utils.read_only_property(\"_algorithm\")\n\n def update(self, data):\n if self._ctx is None:\n raise AlreadyFinalized(\"Context was already finalized.\")\n utils._check_byteslike(\"data\", data)\n self._ctx.update(data)\n\n def copy(self):\n if self._ctx is None:\n raise AlreadyFinalized(\"Context was already finalized.\")\n return HMAC(\n self._key,\n self.algorithm,\n backend=self._backend,\n ctx=self._ctx.copy()\n )\n\n def finalize(self):\n if self._ctx is None:\n raise AlreadyFinalized(\"Context was already finalized.\")\n digest = self._ctx.finalize()\n self._ctx = None\n return digest\n\n def verify(self, signature):\n utils._check_bytes(\"signature\", signature)\n if self._ctx is None:\n raise AlreadyFinalized(\"Context was already finalized.\")\n\n ctx, self._ctx = self._ctx, None\n ctx.verify(signature)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/kdf/__init__.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport abc\n\nimport six\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass KeyDerivationFunction(object):\n @abc.abstractmethod\n def derive(self, key_material):\n \"\"\"\n Deterministically generates and returns a new key based on the existing\n key material.\n \"\"\"\n\n @abc.abstractmethod\n def verify(self, key_material, expected_key):\n \"\"\"\n Checks whether the key generated by the key material matches the\n expected derived key. Raises an exception if they do not match.\n \"\"\"\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/kdf/concatkdf.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport struct\n\nfrom cryptography import utils\nfrom cryptography.exceptions import (\n AlreadyFinalized, InvalidKey, UnsupportedAlgorithm, _Reasons\n)\nfrom cryptography.hazmat.backends.interfaces import HMACBackend\nfrom cryptography.hazmat.backends.interfaces import HashBackend\nfrom cryptography.hazmat.primitives import constant_time, hashes, hmac\nfrom cryptography.hazmat.primitives.kdf import KeyDerivationFunction\n\n\ndef _int_to_u32be(n):\n return struct.pack('>I', n)\n\n\ndef _common_args_checks(algorithm, length, otherinfo):\n max_length = algorithm.digest_size * (2 ** 32 - 1)\n if length > max_length:\n raise ValueError(\n \"Can not derive keys larger than {} bits.\".format(\n max_length\n ))\n if otherinfo is not None:\n utils._check_bytes(\"otherinfo\", otherinfo)\n\n\ndef _concatkdf_derive(key_material, length, auxfn, otherinfo):\n utils._check_byteslike(\"key_material\", key_material)\n output = [b\"\"]\n outlen = 0\n counter = 1\n\n while (length > outlen):\n h = auxfn()\n h.update(_int_to_u32be(counter))\n h.update(key_material)\n h.update(otherinfo)\n output.append(h.finalize())\n outlen += len(output[-1])\n counter += 1\n\n return b\"\".join(output)[:length]\n\n\n@utils.register_interface(KeyDerivationFunction)\nclass ConcatKDFHash(object):\n def __init__(self, algorithm, length, otherinfo, backend):\n\n _common_args_checks(algorithm, length, otherinfo)\n self._algorithm = algorithm\n self._length = length\n self._otherinfo = otherinfo\n if self._otherinfo is None:\n self._otherinfo = b\"\"\n\n if not isinstance(backend, HashBackend):\n raise UnsupportedAlgorithm(\n \"Backend object does not implement HashBackend.\",\n _Reasons.BACKEND_MISSING_INTERFACE\n )\n self._backend = backend\n self._used = False\n\n def _hash(self):\n return hashes.Hash(self._algorithm, self._backend)\n\n def derive(self, key_material):\n if self._used:\n raise AlreadyFinalized\n self._used = True\n return _concatkdf_derive(key_material, self._length,\n self._hash, self._otherinfo)\n\n def verify(self, key_material, expected_key):\n if not constant_time.bytes_eq(self.derive(key_material), expected_key):\n raise InvalidKey\n\n\n@utils.register_interface(KeyDerivationFunction)\nclass ConcatKDFHMAC(object):\n def __init__(self, algorithm, length, salt, otherinfo, backend):\n\n _common_args_checks(algorithm, length, otherinfo)\n self._algorithm = algorithm\n self._length = length\n self._otherinfo = otherinfo\n if self._otherinfo is None:\n self._otherinfo = b\"\"\n\n if salt is None:\n salt = b\"\\x00\" * algorithm.block_size\n else:\n utils._check_bytes(\"salt\", salt)\n\n self._salt = salt\n\n if not isinstance(backend, HMACBackend):\n raise UnsupportedAlgorithm(\n \"Backend object does not implement HMACBackend.\",\n _Reasons.BACKEND_MISSING_INTERFACE\n )\n self._backend = backend\n self._used = False\n\n def _hmac(self):\n return hmac.HMAC(self._salt, self._algorithm, self._backend)\n\n def derive(self, key_material):\n if self._used:\n raise AlreadyFinalized\n self._used = True\n return _concatkdf_derive(key_material, self._length,\n self._hmac, self._otherinfo)\n\n def verify(self, key_material, expected_key):\n if not constant_time.bytes_eq(self.derive(key_material), expected_key):\n raise InvalidKey\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/kdf/hkdf.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport six\n\nfrom cryptography import utils\nfrom cryptography.exceptions import (\n AlreadyFinalized, InvalidKey, UnsupportedAlgorithm, _Reasons\n)\nfrom cryptography.hazmat.backends.interfaces import HMACBackend\nfrom cryptography.hazmat.primitives import constant_time, hmac\nfrom cryptography.hazmat.primitives.kdf import KeyDerivationFunction\n\n\n@utils.register_interface(KeyDerivationFunction)\nclass HKDF(object):\n def __init__(self, algorithm, length, salt, info, backend):\n if not isinstance(backend, HMACBackend):\n raise UnsupportedAlgorithm(\n \"Backend object does not implement HMACBackend.\",\n _Reasons.BACKEND_MISSING_INTERFACE\n )\n\n self._algorithm = algorithm\n\n if salt is None:\n salt = b\"\\x00\" * self._algorithm.digest_size\n else:\n utils._check_bytes(\"salt\", salt)\n\n self._salt = salt\n\n self._backend = backend\n\n self._hkdf_expand = HKDFExpand(self._algorithm, length, info, backend)\n\n def _extract(self, key_material):\n h = hmac.HMAC(self._salt, self._algorithm, backend=self._backend)\n h.update(key_material)\n return h.finalize()\n\n def derive(self, key_material):\n utils._check_byteslike(\"key_material\", key_material)\n return self._hkdf_expand.derive(self._extract(key_material))\n\n def verify(self, key_material, expected_key):\n if not constant_time.bytes_eq(self.derive(key_material), expected_key):\n raise InvalidKey\n\n\n@utils.register_interface(KeyDerivationFunction)\nclass HKDFExpand(object):\n def __init__(self, algorithm, length, info, backend):\n if not isinstance(backend, HMACBackend):\n raise UnsupportedAlgorithm(\n \"Backend object does not implement HMACBackend.\",\n _Reasons.BACKEND_MISSING_INTERFACE\n )\n\n self._algorithm = algorithm\n\n self._backend = backend\n\n max_length = 255 * algorithm.digest_size\n\n if length > max_length:\n raise ValueError(\n \"Can not derive keys larger than {} octets.\".format(\n max_length\n ))\n\n self._length = length\n\n if info is None:\n info = b\"\"\n else:\n utils._check_bytes(\"info\", info)\n\n self._info = info\n\n self._used = False\n\n def _expand(self, key_material):\n output = [b\"\"]\n counter = 1\n\n while self._algorithm.digest_size * (len(output) - 1) < self._length:\n h = hmac.HMAC(key_material, self._algorithm, backend=self._backend)\n h.update(output[-1])\n h.update(self._info)\n h.update(six.int2byte(counter))\n output.append(h.finalize())\n counter += 1\n\n return b\"\".join(output)[:self._length]\n\n def derive(self, key_material):\n utils._check_byteslike(\"key_material\", key_material)\n if self._used:\n raise AlreadyFinalized\n\n self._used = True\n return self._expand(key_material)\n\n def verify(self, key_material, expected_key):\n if not constant_time.bytes_eq(self.derive(key_material), expected_key):\n raise InvalidKey\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/kdf/kbkdf.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nfrom enum import Enum\n\nfrom six.moves import range\n\nfrom cryptography import utils\nfrom cryptography.exceptions import (\n AlreadyFinalized, InvalidKey, UnsupportedAlgorithm, _Reasons\n)\nfrom cryptography.hazmat.backends.interfaces import HMACBackend\nfrom cryptography.hazmat.primitives import constant_time, hashes, hmac\nfrom cryptography.hazmat.primitives.kdf import KeyDerivationFunction\n\n\nclass Mode(Enum):\n CounterMode = \"ctr\"\n\n\nclass CounterLocation(Enum):\n BeforeFixed = \"before_fixed\"\n AfterFixed = \"after_fixed\"\n\n\n@utils.register_interface(KeyDerivationFunction)\nclass KBKDFHMAC(object):\n def __init__(self, algorithm, mode, length, rlen, llen,\n location, label, context, fixed, backend):\n if not isinstance(backend, HMACBackend):\n raise UnsupportedAlgorithm(\n \"Backend object does not implement HMACBackend.\",\n _Reasons.BACKEND_MISSING_INTERFACE\n )\n\n if not isinstance(algorithm, hashes.HashAlgorithm):\n raise UnsupportedAlgorithm(\n \"Algorithm supplied is not a supported hash algorithm.\",\n _Reasons.UNSUPPORTED_HASH\n )\n\n if not backend.hmac_supported(algorithm):\n raise UnsupportedAlgorithm(\n \"Algorithm supplied is not a supported hmac algorithm.\",\n _Reasons.UNSUPPORTED_HASH\n )\n\n if not isinstance(mode, Mode):\n raise TypeError(\"mode must be of type Mode\")\n\n if not isinstance(location, CounterLocation):\n raise TypeError(\"location must be of type CounterLocation\")\n\n if (label or context) and fixed:\n raise ValueError(\"When supplying fixed data, \"\n \"label and context are ignored.\")\n\n if rlen is None or not self._valid_byte_length(rlen):\n raise ValueError(\"rlen must be between 1 and 4\")\n\n if llen is None and fixed is None:\n raise ValueError(\"Please specify an llen\")\n\n if llen is not None and not isinstance(llen, int):\n raise TypeError(\"llen must be an integer\")\n\n if label is None:\n label = b''\n\n if context is None:\n context = b''\n\n utils._check_bytes(\"label\", label)\n utils._check_bytes(\"context\", context)\n self._algorithm = algorithm\n self._mode = mode\n self._length = length\n self._rlen = rlen\n self._llen = llen\n self._location = location\n self._label = label\n self._context = context\n self._backend = backend\n self._used = False\n self._fixed_data = fixed\n\n def _valid_byte_length(self, value):\n if not isinstance(value, int):\n raise TypeError('value must be of type int')\n\n value_bin = utils.int_to_bytes(1, value)\n if not 1 <= len(value_bin) <= 4:\n return False\n return True\n\n def derive(self, key_material):\n if self._used:\n raise AlreadyFinalized\n\n utils._check_byteslike(\"key_material\", key_material)\n self._used = True\n\n # inverse floor division (equivalent to ceiling)\n rounds = -(-self._length // self._algorithm.digest_size)\n\n output = [b'']\n\n # For counter mode, the number of iterations shall not be\n # larger than 2^r-1, where r <= 32 is the binary length of the counter\n # This ensures that the counter values used as an input to the\n # PRF will not repeat during a particular call to the KDF function.\n r_bin = utils.int_to_bytes(1, self._rlen)\n if rounds > pow(2, len(r_bin) * 8) - 1:\n raise ValueError('There are too many iterations.')\n\n for i in range(1, rounds + 1):\n h = hmac.HMAC(key_material, self._algorithm, backend=self._backend)\n\n counter = utils.int_to_bytes(i, self._rlen)\n if self._location == CounterLocation.BeforeFixed:\n h.update(counter)\n\n h.update(self._generate_fixed_input())\n\n if self._location == CounterLocation.AfterFixed:\n h.update(counter)\n\n output.append(h.finalize())\n\n return b''.join(output)[:self._length]\n\n def _generate_fixed_input(self):\n if self._fixed_data and isinstance(self._fixed_data, bytes):\n return self._fixed_data\n\n l_val = utils.int_to_bytes(self._length * 8, self._llen)\n\n return b\"\".join([self._label, b\"\\x00\", self._context, l_val])\n\n def verify(self, key_material, expected_key):\n if not constant_time.bytes_eq(self.derive(key_material), expected_key):\n raise InvalidKey\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/kdf/pbkdf2.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nfrom cryptography import utils\nfrom cryptography.exceptions import (\n AlreadyFinalized, InvalidKey, UnsupportedAlgorithm, _Reasons\n)\nfrom cryptography.hazmat.backends.interfaces import PBKDF2HMACBackend\nfrom cryptography.hazmat.primitives import constant_time\nfrom cryptography.hazmat.primitives.kdf import KeyDerivationFunction\n\n\n@utils.register_interface(KeyDerivationFunction)\nclass PBKDF2HMAC(object):\n def __init__(self, algorithm, length, salt, iterations, backend):\n if not isinstance(backend, PBKDF2HMACBackend):\n raise UnsupportedAlgorithm(\n \"Backend object does not implement PBKDF2HMACBackend.\",\n _Reasons.BACKEND_MISSING_INTERFACE\n )\n\n if not backend.pbkdf2_hmac_supported(algorithm):\n raise UnsupportedAlgorithm(\n \"{} is not supported for PBKDF2 by this backend.\".format(\n algorithm.name),\n _Reasons.UNSUPPORTED_HASH\n )\n self._used = False\n self._algorithm = algorithm\n self._length = length\n utils._check_bytes(\"salt\", salt)\n self._salt = salt\n self._iterations = iterations\n self._backend = backend\n\n def derive(self, key_material):\n if self._used:\n raise AlreadyFinalized(\"PBKDF2 instances can only be used once.\")\n self._used = True\n\n utils._check_byteslike(\"key_material\", key_material)\n return self._backend.derive_pbkdf2_hmac(\n self._algorithm,\n self._length,\n self._salt,\n self._iterations,\n key_material\n )\n\n def verify(self, key_material, expected_key):\n derived_key = self.derive(key_material)\n if not constant_time.bytes_eq(derived_key, expected_key):\n raise InvalidKey(\"Keys do not match.\")\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/kdf/scrypt.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport sys\n\nfrom cryptography import utils\nfrom cryptography.exceptions import (\n AlreadyFinalized, InvalidKey, UnsupportedAlgorithm, _Reasons\n)\nfrom cryptography.hazmat.backends.interfaces import ScryptBackend\nfrom cryptography.hazmat.primitives import constant_time\nfrom cryptography.hazmat.primitives.kdf import KeyDerivationFunction\n\n\n# This is used by the scrypt tests to skip tests that require more memory\n# than the MEM_LIMIT\n_MEM_LIMIT = sys.maxsize // 2\n\n\n@utils.register_interface(KeyDerivationFunction)\nclass Scrypt(object):\n def __init__(self, salt, length, n, r, p, backend):\n if not isinstance(backend, ScryptBackend):\n raise UnsupportedAlgorithm(\n \"Backend object does not implement ScryptBackend.\",\n _Reasons.BACKEND_MISSING_INTERFACE\n )\n\n self._length = length\n utils._check_bytes(\"salt\", salt)\n if n < 2 or (n & (n - 1)) != 0:\n raise ValueError(\"n must be greater than 1 and be a power of 2.\")\n\n if r < 1:\n raise ValueError(\"r must be greater than or equal to 1.\")\n\n if p < 1:\n raise ValueError(\"p must be greater than or equal to 1.\")\n\n self._used = False\n self._salt = salt\n self._n = n\n self._r = r\n self._p = p\n self._backend = backend\n\n def derive(self, key_material):\n if self._used:\n raise AlreadyFinalized(\"Scrypt instances can only be used once.\")\n self._used = True\n\n utils._check_byteslike(\"key_material\", key_material)\n return self._backend.derive_scrypt(\n key_material, self._salt, self._length, self._n, self._r, self._p\n )\n\n def verify(self, key_material, expected_key):\n derived_key = self.derive(key_material)\n if not constant_time.bytes_eq(derived_key, expected_key):\n raise InvalidKey(\"Keys do not match.\")\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/kdf/x963kdf.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport struct\n\nfrom cryptography import utils\nfrom cryptography.exceptions import (\n AlreadyFinalized, InvalidKey, UnsupportedAlgorithm, _Reasons\n)\nfrom cryptography.hazmat.backends.interfaces import HashBackend\nfrom cryptography.hazmat.primitives import constant_time, hashes\nfrom cryptography.hazmat.primitives.kdf import KeyDerivationFunction\n\n\ndef _int_to_u32be(n):\n return struct.pack('>I', n)\n\n\n@utils.register_interface(KeyDerivationFunction)\nclass X963KDF(object):\n def __init__(self, algorithm, length, sharedinfo, backend):\n\n max_len = algorithm.digest_size * (2 ** 32 - 1)\n if length > max_len:\n raise ValueError(\n \"Can not derive keys larger than {} bits.\".format(max_len))\n if sharedinfo is not None:\n utils._check_bytes(\"sharedinfo\", sharedinfo)\n\n self._algorithm = algorithm\n self._length = length\n self._sharedinfo = sharedinfo\n\n if not isinstance(backend, HashBackend):\n raise UnsupportedAlgorithm(\n \"Backend object does not implement HashBackend.\",\n _Reasons.BACKEND_MISSING_INTERFACE\n )\n self._backend = backend\n self._used = False\n\n def derive(self, key_material):\n if self._used:\n raise AlreadyFinalized\n self._used = True\n utils._check_byteslike(\"key_material\", key_material)\n output = [b\"\"]\n outlen = 0\n counter = 1\n\n while self._length > outlen:\n h = hashes.Hash(self._algorithm, self._backend)\n h.update(key_material)\n h.update(_int_to_u32be(counter))\n if self._sharedinfo is not None:\n h.update(self._sharedinfo)\n output.append(h.finalize())\n outlen += len(output[-1])\n counter += 1\n\n return b\"\".join(output)[:self._length]\n\n def verify(self, key_material, expected_key):\n if not constant_time.bytes_eq(self.derive(key_material), expected_key):\n raise InvalidKey\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/keywrap.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport struct\n\nfrom cryptography.hazmat.primitives.ciphers import Cipher\nfrom cryptography.hazmat.primitives.ciphers.algorithms import AES\nfrom cryptography.hazmat.primitives.ciphers.modes import ECB\nfrom cryptography.hazmat.primitives.constant_time import bytes_eq\n\n\ndef _wrap_core(wrapping_key, a, r, backend):\n # RFC 3394 Key Wrap - 2.2.1 (index method)\n encryptor = Cipher(AES(wrapping_key), ECB(), backend).encryptor()\n n = len(r)\n for j in range(6):\n for i in range(n):\n # every encryption operation is a discrete 16 byte chunk (because\n # AES has a 128-bit block size) and since we're using ECB it is\n # safe to reuse the encryptor for the entire operation\n b = encryptor.update(a + r[i])\n # pack/unpack are safe as these are always 64-bit chunks\n a = struct.pack(\n \">Q\", struct.unpack(\">Q\", b[:8])[0] ^ ((n * j) + i + 1)\n )\n r[i] = b[-8:]\n\n assert encryptor.finalize() == b\"\"\n\n return a + b\"\".join(r)\n\n\ndef aes_key_wrap(wrapping_key, key_to_wrap, backend):\n if len(wrapping_key) not in [16, 24, 32]:\n raise ValueError(\"The wrapping key must be a valid AES key length\")\n\n if len(key_to_wrap) < 16:\n raise ValueError(\"The key to wrap must be at least 16 bytes\")\n\n if len(key_to_wrap) % 8 != 0:\n raise ValueError(\"The key to wrap must be a multiple of 8 bytes\")\n\n a = b\"\\xa6\\xa6\\xa6\\xa6\\xa6\\xa6\\xa6\\xa6\"\n r = [key_to_wrap[i:i + 8] for i in range(0, len(key_to_wrap), 8)]\n return _wrap_core(wrapping_key, a, r, backend)\n\n\ndef _unwrap_core(wrapping_key, a, r, backend):\n # Implement RFC 3394 Key Unwrap - 2.2.2 (index method)\n decryptor = Cipher(AES(wrapping_key), ECB(), backend).decryptor()\n n = len(r)\n for j in reversed(range(6)):\n for i in reversed(range(n)):\n # pack/unpack are safe as these are always 64-bit chunks\n atr = struct.pack(\n \">Q\", struct.unpack(\">Q\", a)[0] ^ ((n * j) + i + 1)\n ) + r[i]\n # every decryption operation is a discrete 16 byte chunk so\n # it is safe to reuse the decryptor for the entire operation\n b = decryptor.update(atr)\n a = b[:8]\n r[i] = b[-8:]\n\n assert decryptor.finalize() == b\"\"\n return a, r\n\n\ndef aes_key_wrap_with_padding(wrapping_key, key_to_wrap, backend):\n if len(wrapping_key) not in [16, 24, 32]:\n raise ValueError(\"The wrapping key must be a valid AES key length\")\n\n aiv = b\"\\xA6\\x59\\x59\\xA6\" + struct.pack(\">i\", len(key_to_wrap))\n # pad the key to wrap if necessary\n pad = (8 - (len(key_to_wrap) % 8)) % 8\n key_to_wrap = key_to_wrap + b\"\\x00\" * pad\n if len(key_to_wrap) == 8:\n # RFC 5649 - 4.1 - exactly 8 octets after padding\n encryptor = Cipher(AES(wrapping_key), ECB(), backend).encryptor()\n b = encryptor.update(aiv + key_to_wrap)\n assert encryptor.finalize() == b\"\"\n return b\n else:\n r = [key_to_wrap[i:i + 8] for i in range(0, len(key_to_wrap), 8)]\n return _wrap_core(wrapping_key, aiv, r, backend)\n\n\ndef aes_key_unwrap_with_padding(wrapping_key, wrapped_key, backend):\n if len(wrapped_key) < 16:\n raise InvalidUnwrap(\"Must be at least 16 bytes\")\n\n if len(wrapping_key) not in [16, 24, 32]:\n raise ValueError(\"The wrapping key must be a valid AES key length\")\n\n if len(wrapped_key) == 16:\n # RFC 5649 - 4.2 - exactly two 64-bit blocks\n decryptor = Cipher(AES(wrapping_key), ECB(), backend).decryptor()\n b = decryptor.update(wrapped_key)\n assert decryptor.finalize() == b\"\"\n a = b[:8]\n data = b[8:]\n n = 1\n else:\n r = [wrapped_key[i:i + 8] for i in range(0, len(wrapped_key), 8)]\n encrypted_aiv = r.pop(0)\n n = len(r)\n a, r = _unwrap_core(wrapping_key, encrypted_aiv, r, backend)\n data = b\"\".join(r)\n\n # 1) Check that MSB(32,A) = A65959A6.\n # 2) Check that 8*(n-1) < LSB(32,A) <= 8*n. If so, let\n # MLI = LSB(32,A).\n # 3) Let b = (8*n)-MLI, and then check that the rightmost b octets of\n # the output data are zero.\n (mli,) = struct.unpack(\">I\", a[4:])\n b = (8 * n) - mli\n if (\n not bytes_eq(a[:4], b\"\\xa6\\x59\\x59\\xa6\") or not\n 8 * (n - 1) < mli <= 8 * n or (\n b != 0 and not bytes_eq(data[-b:], b\"\\x00\" * b)\n )\n ):\n raise InvalidUnwrap()\n\n if b == 0:\n return data\n else:\n return data[:-b]\n\n\ndef aes_key_unwrap(wrapping_key, wrapped_key, backend):\n if len(wrapped_key) < 24:\n raise InvalidUnwrap(\"Must be at least 24 bytes\")\n\n if len(wrapped_key) % 8 != 0:\n raise InvalidUnwrap(\"The wrapped key must be a multiple of 8 bytes\")\n\n if len(wrapping_key) not in [16, 24, 32]:\n raise ValueError(\"The wrapping key must be a valid AES key length\")\n\n aiv = b\"\\xa6\\xa6\\xa6\\xa6\\xa6\\xa6\\xa6\\xa6\"\n r = [wrapped_key[i:i + 8] for i in range(0, len(wrapped_key), 8)]\n a = r.pop(0)\n a, r = _unwrap_core(wrapping_key, a, r, backend)\n if not bytes_eq(a, aiv):\n raise InvalidUnwrap()\n\n return b\"\".join(r)\n\n\nclass InvalidUnwrap(Exception):\n pass\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/padding.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport abc\n\nimport six\n\nfrom cryptography import utils\nfrom cryptography.exceptions import AlreadyFinalized\nfrom cryptography.hazmat.bindings._padding import lib\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass PaddingContext(object):\n @abc.abstractmethod\n def update(self, data):\n \"\"\"\n Pads the provided bytes and returns any available data as bytes.\n \"\"\"\n\n @abc.abstractmethod\n def finalize(self):\n \"\"\"\n Finalize the padding, returns bytes.\n \"\"\"\n\n\ndef _byte_padding_check(block_size):\n if not (0 <= block_size <= 2040):\n raise ValueError(\"block_size must be in range(0, 2041).\")\n\n if block_size % 8 != 0:\n raise ValueError(\"block_size must be a multiple of 8.\")\n\n\ndef _byte_padding_update(buffer_, data, block_size):\n if buffer_ is None:\n raise AlreadyFinalized(\"Context was already finalized.\")\n\n utils._check_bytes(\"data\", data)\n\n buffer_ += data\n\n finished_blocks = len(buffer_) // (block_size // 8)\n\n result = buffer_[:finished_blocks * (block_size // 8)]\n buffer_ = buffer_[finished_blocks * (block_size // 8):]\n\n return buffer_, result\n\n\ndef _byte_padding_pad(buffer_, block_size, paddingfn):\n if buffer_ is None:\n raise AlreadyFinalized(\"Context was already finalized.\")\n\n pad_size = block_size // 8 - len(buffer_)\n return buffer_ + paddingfn(pad_size)\n\n\ndef _byte_unpadding_update(buffer_, data, block_size):\n if buffer_ is None:\n raise AlreadyFinalized(\"Context was already finalized.\")\n\n utils._check_bytes(\"data\", data)\n\n buffer_ += data\n\n finished_blocks = max(len(buffer_) // (block_size // 8) - 1, 0)\n\n result = buffer_[:finished_blocks * (block_size // 8)]\n buffer_ = buffer_[finished_blocks * (block_size // 8):]\n\n return buffer_, result\n\n\ndef _byte_unpadding_check(buffer_, block_size, checkfn):\n if buffer_ is None:\n raise AlreadyFinalized(\"Context was already finalized.\")\n\n if len(buffer_) != block_size // 8:\n raise ValueError(\"Invalid padding bytes.\")\n\n valid = checkfn(buffer_, block_size // 8)\n\n if not valid:\n raise ValueError(\"Invalid padding bytes.\")\n\n pad_size = six.indexbytes(buffer_, -1)\n return buffer_[:-pad_size]\n\n\nclass PKCS7(object):\n def __init__(self, block_size):\n _byte_padding_check(block_size)\n self.block_size = block_size\n\n def padder(self):\n return _PKCS7PaddingContext(self.block_size)\n\n def unpadder(self):\n return _PKCS7UnpaddingContext(self.block_size)\n\n\n@utils.register_interface(PaddingContext)\nclass _PKCS7PaddingContext(object):\n def __init__(self, block_size):\n self.block_size = block_size\n # TODO: more copies than necessary, we should use zero-buffer (#193)\n self._buffer = b\"\"\n\n def update(self, data):\n self._buffer, result = _byte_padding_update(\n self._buffer, data, self.block_size)\n return result\n\n def _padding(self, size):\n return six.int2byte(size) * size\n\n def finalize(self):\n result = _byte_padding_pad(\n self._buffer, self.block_size, self._padding)\n self._buffer = None\n return result\n\n\n@utils.register_interface(PaddingContext)\nclass _PKCS7UnpaddingContext(object):\n def __init__(self, block_size):\n self.block_size = block_size\n # TODO: more copies than necessary, we should use zero-buffer (#193)\n self._buffer = b\"\"\n\n def update(self, data):\n self._buffer, result = _byte_unpadding_update(\n self._buffer, data, self.block_size)\n return result\n\n def finalize(self):\n result = _byte_unpadding_check(\n self._buffer, self.block_size,\n lib.Cryptography_check_pkcs7_padding)\n self._buffer = None\n return result\n\n\nclass ANSIX923(object):\n def __init__(self, block_size):\n _byte_padding_check(block_size)\n self.block_size = block_size\n\n def padder(self):\n return _ANSIX923PaddingContext(self.block_size)\n\n def unpadder(self):\n return _ANSIX923UnpaddingContext(self.block_size)\n\n\n@utils.register_interface(PaddingContext)\nclass _ANSIX923PaddingContext(object):\n def __init__(self, block_size):\n self.block_size = block_size\n # TODO: more copies than necessary, we should use zero-buffer (#193)\n self._buffer = b\"\"\n\n def update(self, data):\n self._buffer, result = _byte_padding_update(\n self._buffer, data, self.block_size)\n return result\n\n def _padding(self, size):\n return six.int2byte(0) * (size - 1) + six.int2byte(size)\n\n def finalize(self):\n result = _byte_padding_pad(\n self._buffer, self.block_size, self._padding)\n self._buffer = None\n return result\n\n\n@utils.register_interface(PaddingContext)\nclass _ANSIX923UnpaddingContext(object):\n def __init__(self, block_size):\n self.block_size = block_size\n # TODO: more copies than necessary, we should use zero-buffer (#193)\n self._buffer = b\"\"\n\n def update(self, data):\n self._buffer, result = _byte_unpadding_update(\n self._buffer, data, self.block_size)\n return result\n\n def finalize(self):\n result = _byte_unpadding_check(\n self._buffer, self.block_size,\n lib.Cryptography_check_ansix923_padding)\n self._buffer = None\n return result\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/poly1305.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\n\nfrom cryptography import utils\nfrom cryptography.exceptions import (\n AlreadyFinalized, UnsupportedAlgorithm, _Reasons\n)\n\n\nclass Poly1305(object):\n def __init__(self, key):\n from cryptography.hazmat.backends.openssl.backend import backend\n if not backend.poly1305_supported():\n raise UnsupportedAlgorithm(\n \"poly1305 is not supported by this version of OpenSSL.\",\n _Reasons.UNSUPPORTED_MAC\n )\n self._ctx = backend.create_poly1305_ctx(key)\n\n def update(self, data):\n if self._ctx is None:\n raise AlreadyFinalized(\"Context was already finalized.\")\n utils._check_byteslike(\"data\", data)\n self._ctx.update(data)\n\n def finalize(self):\n if self._ctx is None:\n raise AlreadyFinalized(\"Context was already finalized.\")\n mac = self._ctx.finalize()\n self._ctx = None\n return mac\n\n def verify(self, tag):\n utils._check_bytes(\"tag\", tag)\n if self._ctx is None:\n raise AlreadyFinalized(\"Context was already finalized.\")\n\n ctx, self._ctx = self._ctx, None\n ctx.verify(tag)\n\n @classmethod\n def generate_tag(cls, key, data):\n p = Poly1305(key)\n p.update(data)\n return p.finalize()\n\n @classmethod\n def verify_tag(cls, key, data, tag):\n p = Poly1305(key)\n p.update(data)\n p.verify(tag)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/serialization/__init__.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nfrom cryptography.hazmat.primitives.serialization.base import (\n BestAvailableEncryption, Encoding, KeySerializationEncryption,\n NoEncryption, ParameterFormat, PrivateFormat, PublicFormat,\n load_der_parameters, load_der_private_key, load_der_public_key,\n load_pem_parameters, load_pem_private_key, load_pem_public_key,\n)\nfrom cryptography.hazmat.primitives.serialization.ssh import (\n load_ssh_public_key\n)\n\n\n_PEM_DER = (Encoding.PEM, Encoding.DER)\n\n__all__ = [\n \"load_der_parameters\", \"load_der_private_key\", \"load_der_public_key\",\n \"load_pem_parameters\", \"load_pem_private_key\", \"load_pem_public_key\",\n \"load_ssh_public_key\", \"Encoding\", \"PrivateFormat\", \"PublicFormat\",\n \"ParameterFormat\", \"KeySerializationEncryption\", \"BestAvailableEncryption\",\n \"NoEncryption\",\n]\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/serialization/base.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport abc\nfrom enum import Enum\n\nimport six\n\nfrom cryptography import utils\n\n\ndef load_pem_private_key(data, password, backend):\n return backend.load_pem_private_key(data, password)\n\n\ndef load_pem_public_key(data, backend):\n return backend.load_pem_public_key(data)\n\n\ndef load_pem_parameters(data, backend):\n return backend.load_pem_parameters(data)\n\n\ndef load_der_private_key(data, password, backend):\n return backend.load_der_private_key(data, password)\n\n\ndef load_der_public_key(data, backend):\n return backend.load_der_public_key(data)\n\n\ndef load_der_parameters(data, backend):\n return backend.load_der_parameters(data)\n\n\nclass Encoding(Enum):\n PEM = \"PEM\"\n DER = \"DER\"\n OpenSSH = \"OpenSSH\"\n Raw = \"Raw\"\n X962 = \"ANSI X9.62\"\n\n\nclass PrivateFormat(Enum):\n PKCS8 = \"PKCS8\"\n TraditionalOpenSSL = \"TraditionalOpenSSL\"\n Raw = \"Raw\"\n\n\nclass PublicFormat(Enum):\n SubjectPublicKeyInfo = \"X.509 subjectPublicKeyInfo with PKCS#1\"\n PKCS1 = \"Raw PKCS#1\"\n OpenSSH = \"OpenSSH\"\n Raw = \"Raw\"\n CompressedPoint = \"X9.62 Compressed Point\"\n UncompressedPoint = \"X9.62 Uncompressed Point\"\n\n\nclass ParameterFormat(Enum):\n PKCS3 = \"PKCS3\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass KeySerializationEncryption(object):\n pass\n\n\n@utils.register_interface(KeySerializationEncryption)\nclass BestAvailableEncryption(object):\n def __init__(self, password):\n if not isinstance(password, bytes) or len(password) == 0:\n raise ValueError(\"Password must be 1 or more bytes.\")\n\n self.password = password\n\n\n@utils.register_interface(KeySerializationEncryption)\nclass NoEncryption(object):\n pass\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/serialization/pkcs12.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\n\ndef load_key_and_certificates(data, password, backend):\n return backend.load_key_and_certificates_from_pkcs12(data, password)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/serialization/ssh.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport base64\nimport struct\n\nimport six\n\nfrom cryptography import utils\nfrom cryptography.exceptions import UnsupportedAlgorithm\nfrom cryptography.hazmat.primitives.asymmetric import dsa, ec, ed25519, rsa\n\n\ndef load_ssh_public_key(data, backend):\n key_parts = data.split(b' ', 2)\n\n if len(key_parts) < 2:\n raise ValueError(\n 'Key is not in the proper format or contains extra data.')\n\n key_type = key_parts[0]\n\n if key_type == b'ssh-rsa':\n loader = _load_ssh_rsa_public_key\n elif key_type == b'ssh-dss':\n loader = _load_ssh_dss_public_key\n elif key_type in [\n b'ecdsa-sha2-nistp256', b'ecdsa-sha2-nistp384', b'ecdsa-sha2-nistp521',\n ]:\n loader = _load_ssh_ecdsa_public_key\n elif key_type == b'ssh-ed25519':\n loader = _load_ssh_ed25519_public_key\n else:\n raise UnsupportedAlgorithm('Key type is not supported.')\n\n key_body = key_parts[1]\n\n try:\n decoded_data = base64.b64decode(key_body)\n except TypeError:\n raise ValueError('Key is not in the proper format.')\n\n inner_key_type, rest = _ssh_read_next_string(decoded_data)\n\n if inner_key_type != key_type:\n raise ValueError(\n 'Key header and key body contain different key type values.'\n )\n\n return loader(key_type, rest, backend)\n\n\ndef _load_ssh_rsa_public_key(key_type, decoded_data, backend):\n e, rest = _ssh_read_next_mpint(decoded_data)\n n, rest = _ssh_read_next_mpint(rest)\n\n if rest:\n raise ValueError('Key body contains extra bytes.')\n\n return rsa.RSAPublicNumbers(e, n).public_key(backend)\n\n\ndef _load_ssh_dss_public_key(key_type, decoded_data, backend):\n p, rest = _ssh_read_next_mpint(decoded_data)\n q, rest = _ssh_read_next_mpint(rest)\n g, rest = _ssh_read_next_mpint(rest)\n y, rest = _ssh_read_next_mpint(rest)\n\n if rest:\n raise ValueError('Key body contains extra bytes.')\n\n parameter_numbers = dsa.DSAParameterNumbers(p, q, g)\n public_numbers = dsa.DSAPublicNumbers(y, parameter_numbers)\n\n return public_numbers.public_key(backend)\n\n\ndef _load_ssh_ecdsa_public_key(expected_key_type, decoded_data, backend):\n curve_name, rest = _ssh_read_next_string(decoded_data)\n data, rest = _ssh_read_next_string(rest)\n\n if expected_key_type != b\"ecdsa-sha2-\" + curve_name:\n raise ValueError(\n 'Key header and key body contain different key type values.'\n )\n\n if rest:\n raise ValueError('Key body contains extra bytes.')\n\n curve = {\n b\"nistp256\": ec.SECP256R1,\n b\"nistp384\": ec.SECP384R1,\n b\"nistp521\": ec.SECP521R1,\n }[curve_name]()\n\n if six.indexbytes(data, 0) != 4:\n raise NotImplementedError(\n \"Compressed elliptic curve points are not supported\"\n )\n\n return ec.EllipticCurvePublicKey.from_encoded_point(curve, data)\n\n\ndef _load_ssh_ed25519_public_key(expected_key_type, decoded_data, backend):\n data, rest = _ssh_read_next_string(decoded_data)\n\n if rest:\n raise ValueError('Key body contains extra bytes.')\n\n return ed25519.Ed25519PublicKey.from_public_bytes(data)\n\n\ndef _ssh_read_next_string(data):\n \"\"\"\n Retrieves the next RFC 4251 string value from the data.\n\n While the RFC calls these strings, in Python they are bytes objects.\n \"\"\"\n if len(data) < 4:\n raise ValueError(\"Key is not in the proper format\")\n\n str_len, = struct.unpack('>I', data[:4])\n if len(data) < str_len + 4:\n raise ValueError(\"Key is not in the proper format\")\n\n return data[4:4 + str_len], data[4 + str_len:]\n\n\ndef _ssh_read_next_mpint(data):\n \"\"\"\n Reads the next mpint from the data.\n\n Currently, all mpints are interpreted as unsigned.\n \"\"\"\n mpint_data, rest = _ssh_read_next_string(data)\n\n return (\n utils.int_from_bytes(mpint_data, byteorder='big', signed=False), rest\n )\n\n\ndef _ssh_write_string(data):\n return struct.pack(\">I\", len(data)) + data\n\n\ndef _ssh_write_mpint(value):\n data = utils.int_to_bytes(value)\n if six.indexbytes(data, 0) & 0x80:\n data = b\"\\x00\" + data\n return _ssh_write_string(data)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/twofactor/__init__.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\n\nclass InvalidToken(Exception):\n pass\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/twofactor/hotp.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport struct\n\nimport six\n\nfrom cryptography.exceptions import (\n UnsupportedAlgorithm, _Reasons\n)\nfrom cryptography.hazmat.backends.interfaces import HMACBackend\nfrom cryptography.hazmat.primitives import constant_time, hmac\nfrom cryptography.hazmat.primitives.hashes import SHA1, SHA256, SHA512\nfrom cryptography.hazmat.primitives.twofactor import InvalidToken\nfrom cryptography.hazmat.primitives.twofactor.utils import _generate_uri\n\n\nclass HOTP(object):\n def __init__(self, key, length, algorithm, backend,\n enforce_key_length=True):\n if not isinstance(backend, HMACBackend):\n raise UnsupportedAlgorithm(\n \"Backend object does not implement HMACBackend.\",\n _Reasons.BACKEND_MISSING_INTERFACE\n )\n\n if len(key) < 16 and enforce_key_length is True:\n raise ValueError(\"Key length has to be at least 128 bits.\")\n\n if not isinstance(length, six.integer_types):\n raise TypeError(\"Length parameter must be an integer type.\")\n\n if length < 6 or length > 8:\n raise ValueError(\"Length of HOTP has to be between 6 to 8.\")\n\n if not isinstance(algorithm, (SHA1, SHA256, SHA512)):\n raise TypeError(\"Algorithm must be SHA1, SHA256 or SHA512.\")\n\n self._key = key\n self._length = length\n self._algorithm = algorithm\n self._backend = backend\n\n def generate(self, counter):\n truncated_value = self._dynamic_truncate(counter)\n hotp = truncated_value % (10 ** self._length)\n return \"{0:0{1}}\".format(hotp, self._length).encode()\n\n def verify(self, hotp, counter):\n if not constant_time.bytes_eq(self.generate(counter), hotp):\n raise InvalidToken(\"Supplied HOTP value does not match.\")\n\n def _dynamic_truncate(self, counter):\n ctx = hmac.HMAC(self._key, self._algorithm, self._backend)\n ctx.update(struct.pack(\">Q\", counter))\n hmac_value = ctx.finalize()\n\n offset = six.indexbytes(hmac_value, len(hmac_value) - 1) & 0b1111\n p = hmac_value[offset:offset + 4]\n return struct.unpack(\">I\", p)[0] & 0x7fffffff\n\n def get_provisioning_uri(self, account_name, counter, issuer):\n return _generate_uri(self, \"hotp\", account_name, issuer, [\n (\"counter\", int(counter)),\n ])\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/twofactor/totp.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nfrom cryptography.exceptions import (\n UnsupportedAlgorithm, _Reasons\n)\nfrom cryptography.hazmat.backends.interfaces import HMACBackend\nfrom cryptography.hazmat.primitives import constant_time\nfrom cryptography.hazmat.primitives.twofactor import InvalidToken\nfrom cryptography.hazmat.primitives.twofactor.hotp import HOTP\nfrom cryptography.hazmat.primitives.twofactor.utils import _generate_uri\n\n\nclass TOTP(object):\n def __init__(self, key, length, algorithm, time_step, backend,\n enforce_key_length=True):\n if not isinstance(backend, HMACBackend):\n raise UnsupportedAlgorithm(\n \"Backend object does not implement HMACBackend.\",\n _Reasons.BACKEND_MISSING_INTERFACE\n )\n\n self._time_step = time_step\n self._hotp = HOTP(key, length, algorithm, backend, enforce_key_length)\n\n def generate(self, time):\n counter = int(time / self._time_step)\n return self._hotp.generate(counter)\n\n def verify(self, totp, time):\n if not constant_time.bytes_eq(self.generate(time), totp):\n raise InvalidToken(\"Supplied TOTP value does not match.\")\n\n def get_provisioning_uri(self, account_name, issuer):\n return _generate_uri(self._hotp, \"totp\", account_name, issuer, [\n (\"period\", int(self._time_step)),\n ])\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/hazmat/primitives/twofactor/utils.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport base64\n\nfrom six.moves.urllib.parse import quote, urlencode\n\n\ndef _generate_uri(hotp, type_name, account_name, issuer, extra_parameters):\n parameters = [\n (\"digits\", hotp._length),\n (\"secret\", base64.b32encode(hotp._key)),\n (\"algorithm\", hotp._algorithm.name.upper()),\n ]\n\n if issuer is not None:\n parameters.append((\"issuer\", issuer))\n\n parameters.extend(extra_parameters)\n\n uriparts = {\n \"type\": type_name,\n \"label\": (\"%s:%s\" % (quote(issuer), quote(account_name)) if issuer\n else quote(account_name)),\n \"parameters\": urlencode(parameters),\n }\n return \"otpauth://{type}/{label}?{parameters}\".format(**uriparts)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/utils.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport abc\nimport binascii\nimport inspect\nimport sys\nimport warnings\n\n\n# We use a UserWarning subclass, instead of DeprecationWarning, because CPython\n# decided deprecation warnings should be invisble by default.\nclass CryptographyDeprecationWarning(UserWarning):\n pass\n\n\n# Several APIs were deprecated with no specific end-of-life date because of the\n# ubiquity of their use. They should not be removed until we agree on when that\n# cycle ends.\nPersistentlyDeprecated2017 = CryptographyDeprecationWarning\nPersistentlyDeprecated2018 = CryptographyDeprecationWarning\nDeprecatedIn25 = CryptographyDeprecationWarning\nDeprecatedIn27 = CryptographyDeprecationWarning\n\n\ndef _check_bytes(name, value):\n if not isinstance(value, bytes):\n raise TypeError(\"{} must be bytes\".format(name))\n\n\ndef _check_byteslike(name, value):\n try:\n memoryview(value)\n except TypeError:\n raise TypeError(\"{} must be bytes-like\".format(name))\n\n\ndef read_only_property(name):\n return property(lambda self: getattr(self, name))\n\n\ndef register_interface(iface):\n def register_decorator(klass):\n verify_interface(iface, klass)\n iface.register(klass)\n return klass\n return register_decorator\n\n\ndef register_interface_if(predicate, iface):\n def register_decorator(klass):\n if predicate:\n verify_interface(iface, klass)\n iface.register(klass)\n return klass\n return register_decorator\n\n\nif hasattr(int, \"from_bytes\"):\n int_from_bytes = int.from_bytes\nelse:\n def int_from_bytes(data, byteorder, signed=False):\n assert byteorder == 'big'\n assert not signed\n\n return int(binascii.hexlify(data), 16)\n\n\nif hasattr(int, \"to_bytes\"):\n def int_to_bytes(integer, length=None):\n return integer.to_bytes(\n length or (integer.bit_length() + 7) // 8 or 1, 'big'\n )\nelse:\n def int_to_bytes(integer, length=None):\n hex_string = '%x' % integer\n if length is None:\n n = len(hex_string)\n else:\n n = length * 2\n return binascii.unhexlify(hex_string.zfill(n + (n & 1)))\n\n\nclass InterfaceNotImplemented(Exception):\n pass\n\n\nif hasattr(inspect, \"signature\"):\n signature = inspect.signature\nelse:\n signature = inspect.getargspec\n\n\ndef verify_interface(iface, klass):\n for method in iface.__abstractmethods__:\n if not hasattr(klass, method):\n raise InterfaceNotImplemented(\n \"{} is missing a {!r} method\".format(klass, method)\n )\n if isinstance(getattr(iface, method), abc.abstractproperty):\n # Can't properly verify these yet.\n continue\n sig = signature(getattr(iface, method))\n actual = signature(getattr(klass, method))\n if sig != actual:\n raise InterfaceNotImplemented(\n \"{}.{}'s signature differs from the expected. Expected: \"\n \"{!r}. Received: {!r}\".format(\n klass, method, sig, actual\n )\n )\n\n\n# No longer needed as of 2.2, but retained because we have external consumers\n# who use it.\ndef bit_length(x):\n return x.bit_length()\n\n\nclass _DeprecatedValue(object):\n def __init__(self, value, message, warning_class):\n self.value = value\n self.message = message\n self.warning_class = warning_class\n\n\nclass _ModuleWithDeprecations(object):\n def __init__(self, module):\n self.__dict__[\"_module\"] = module\n\n def __getattr__(self, attr):\n obj = getattr(self._module, attr)\n if isinstance(obj, _DeprecatedValue):\n warnings.warn(obj.message, obj.warning_class, stacklevel=2)\n obj = obj.value\n return obj\n\n def __setattr__(self, attr, value):\n setattr(self._module, attr, value)\n\n def __delattr__(self, attr):\n obj = getattr(self._module, attr)\n if isinstance(obj, _DeprecatedValue):\n warnings.warn(obj.message, obj.warning_class, stacklevel=2)\n\n delattr(self._module, attr)\n\n def __dir__(self):\n return [\"_module\"] + dir(self._module)\n\n\ndef deprecated(value, module_name, message, warning_class):\n module = sys.modules[module_name]\n if not isinstance(module, _ModuleWithDeprecations):\n sys.modules[module_name] = _ModuleWithDeprecations(module)\n return _DeprecatedValue(value, message, warning_class)\n\n\ndef cached_property(func):\n cached_name = \"_cached_{}\".format(func)\n sentinel = object()\n\n def inner(instance):\n cache = getattr(instance, cached_name, sentinel)\n if cache is not sentinel:\n return cache\n result = func(instance)\n setattr(instance, cached_name, result)\n return result\n return property(inner)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/x509/__init__.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nfrom cryptography.x509 import certificate_transparency\nfrom cryptography.x509.base import (\n Certificate, CertificateBuilder, CertificateRevocationList,\n CertificateRevocationListBuilder,\n CertificateSigningRequest, CertificateSigningRequestBuilder,\n InvalidVersion, RevokedCertificate, RevokedCertificateBuilder,\n Version, load_der_x509_certificate, load_der_x509_crl, load_der_x509_csr,\n load_pem_x509_certificate, load_pem_x509_crl, load_pem_x509_csr,\n random_serial_number,\n)\nfrom cryptography.x509.extensions import (\n AccessDescription, AuthorityInformationAccess,\n AuthorityKeyIdentifier, BasicConstraints, CRLDistributionPoints,\n CRLNumber, CRLReason, CertificateIssuer, CertificatePolicies,\n DeltaCRLIndicator, DistributionPoint, DuplicateExtension, ExtendedKeyUsage,\n Extension, ExtensionNotFound, ExtensionType, Extensions, FreshestCRL,\n GeneralNames, InhibitAnyPolicy, InvalidityDate, IssuerAlternativeName,\n IssuingDistributionPoint, KeyUsage, NameConstraints, NoticeReference,\n OCSPNoCheck, OCSPNonce, PolicyConstraints, PolicyInformation,\n PrecertPoison, PrecertificateSignedCertificateTimestamps, ReasonFlags,\n SubjectAlternativeName, SubjectKeyIdentifier, TLSFeature, TLSFeatureType,\n UnrecognizedExtension, UserNotice\n)\nfrom cryptography.x509.general_name import (\n DNSName, DirectoryName, GeneralName, IPAddress, OtherName, RFC822Name,\n RegisteredID, UniformResourceIdentifier, UnsupportedGeneralNameType,\n _GENERAL_NAMES\n)\nfrom cryptography.x509.name import (\n Name, NameAttribute, RelativeDistinguishedName\n)\nfrom cryptography.x509.oid import (\n AuthorityInformationAccessOID, CRLEntryExtensionOID,\n CertificatePoliciesOID, ExtendedKeyUsageOID, ExtensionOID, NameOID,\n ObjectIdentifier, SignatureAlgorithmOID, _SIG_OIDS_TO_HASH\n)\n\n\nOID_AUTHORITY_INFORMATION_ACCESS = ExtensionOID.AUTHORITY_INFORMATION_ACCESS\nOID_AUTHORITY_KEY_IDENTIFIER = ExtensionOID.AUTHORITY_KEY_IDENTIFIER\nOID_BASIC_CONSTRAINTS = ExtensionOID.BASIC_CONSTRAINTS\nOID_CERTIFICATE_POLICIES = ExtensionOID.CERTIFICATE_POLICIES\nOID_CRL_DISTRIBUTION_POINTS = ExtensionOID.CRL_DISTRIBUTION_POINTS\nOID_EXTENDED_KEY_USAGE = ExtensionOID.EXTENDED_KEY_USAGE\nOID_FRESHEST_CRL = ExtensionOID.FRESHEST_CRL\nOID_INHIBIT_ANY_POLICY = ExtensionOID.INHIBIT_ANY_POLICY\nOID_ISSUER_ALTERNATIVE_NAME = ExtensionOID.ISSUER_ALTERNATIVE_NAME\nOID_KEY_USAGE = ExtensionOID.KEY_USAGE\nOID_NAME_CONSTRAINTS = ExtensionOID.NAME_CONSTRAINTS\nOID_OCSP_NO_CHECK = ExtensionOID.OCSP_NO_CHECK\nOID_POLICY_CONSTRAINTS = ExtensionOID.POLICY_CONSTRAINTS\nOID_POLICY_MAPPINGS = ExtensionOID.POLICY_MAPPINGS\nOID_SUBJECT_ALTERNATIVE_NAME = ExtensionOID.SUBJECT_ALTERNATIVE_NAME\nOID_SUBJECT_DIRECTORY_ATTRIBUTES = ExtensionOID.SUBJECT_DIRECTORY_ATTRIBUTES\nOID_SUBJECT_INFORMATION_ACCESS = ExtensionOID.SUBJECT_INFORMATION_ACCESS\nOID_SUBJECT_KEY_IDENTIFIER = ExtensionOID.SUBJECT_KEY_IDENTIFIER\n\nOID_DSA_WITH_SHA1 = SignatureAlgorithmOID.DSA_WITH_SHA1\nOID_DSA_WITH_SHA224 = SignatureAlgorithmOID.DSA_WITH_SHA224\nOID_DSA_WITH_SHA256 = SignatureAlgorithmOID.DSA_WITH_SHA256\nOID_ECDSA_WITH_SHA1 = SignatureAlgorithmOID.ECDSA_WITH_SHA1\nOID_ECDSA_WITH_SHA224 = SignatureAlgorithmOID.ECDSA_WITH_SHA224\nOID_ECDSA_WITH_SHA256 = SignatureAlgorithmOID.ECDSA_WITH_SHA256\nOID_ECDSA_WITH_SHA384 = SignatureAlgorithmOID.ECDSA_WITH_SHA384\nOID_ECDSA_WITH_SHA512 = SignatureAlgorithmOID.ECDSA_WITH_SHA512\nOID_RSA_WITH_MD5 = SignatureAlgorithmOID.RSA_WITH_MD5\nOID_RSA_WITH_SHA1 = SignatureAlgorithmOID.RSA_WITH_SHA1\nOID_RSA_WITH_SHA224 = SignatureAlgorithmOID.RSA_WITH_SHA224\nOID_RSA_WITH_SHA256 = SignatureAlgorithmOID.RSA_WITH_SHA256\nOID_RSA_WITH_SHA384 = SignatureAlgorithmOID.RSA_WITH_SHA384\nOID_RSA_WITH_SHA512 = SignatureAlgorithmOID.RSA_WITH_SHA512\nOID_RSASSA_PSS = SignatureAlgorithmOID.RSASSA_PSS\n\nOID_COMMON_NAME = NameOID.COMMON_NAME\nOID_COUNTRY_NAME = NameOID.COUNTRY_NAME\nOID_DOMAIN_COMPONENT = NameOID.DOMAIN_COMPONENT\nOID_DN_QUALIFIER = NameOID.DN_QUALIFIER\nOID_EMAIL_ADDRESS = NameOID.EMAIL_ADDRESS\nOID_GENERATION_QUALIFIER = NameOID.GENERATION_QUALIFIER\nOID_GIVEN_NAME = NameOID.GIVEN_NAME\nOID_LOCALITY_NAME = NameOID.LOCALITY_NAME\nOID_ORGANIZATIONAL_UNIT_NAME = NameOID.ORGANIZATIONAL_UNIT_NAME\nOID_ORGANIZATION_NAME = NameOID.ORGANIZATION_NAME\nOID_PSEUDONYM = NameOID.PSEUDONYM\nOID_SERIAL_NUMBER = NameOID.SERIAL_NUMBER\nOID_STATE_OR_PROVINCE_NAME = NameOID.STATE_OR_PROVINCE_NAME\nOID_SURNAME = NameOID.SURNAME\nOID_TITLE = NameOID.TITLE\n\nOID_CLIENT_AUTH = ExtendedKeyUsageOID.CLIENT_AUTH\nOID_CODE_SIGNING = ExtendedKeyUsageOID.CODE_SIGNING\nOID_EMAIL_PROTECTION = ExtendedKeyUsageOID.EMAIL_PROTECTION\nOID_OCSP_SIGNING = ExtendedKeyUsageOID.OCSP_SIGNING\nOID_SERVER_AUTH = ExtendedKeyUsageOID.SERVER_AUTH\nOID_TIME_STAMPING = ExtendedKeyUsageOID.TIME_STAMPING\n\nOID_ANY_POLICY = CertificatePoliciesOID.ANY_POLICY\nOID_CPS_QUALIFIER = CertificatePoliciesOID.CPS_QUALIFIER\nOID_CPS_USER_NOTICE = CertificatePoliciesOID.CPS_USER_NOTICE\n\nOID_CERTIFICATE_ISSUER = CRLEntryExtensionOID.CERTIFICATE_ISSUER\nOID_CRL_REASON = CRLEntryExtensionOID.CRL_REASON\nOID_INVALIDITY_DATE = CRLEntryExtensionOID.INVALIDITY_DATE\n\nOID_CA_ISSUERS = AuthorityInformationAccessOID.CA_ISSUERS\nOID_OCSP = AuthorityInformationAccessOID.OCSP\n\n__all__ = [\n \"certificate_transparency\",\n \"load_pem_x509_certificate\",\n \"load_der_x509_certificate\",\n \"load_pem_x509_csr\",\n \"load_der_x509_csr\",\n \"load_pem_x509_crl\",\n \"load_der_x509_crl\",\n \"random_serial_number\",\n \"InvalidVersion\",\n \"DeltaCRLIndicator\",\n \"DuplicateExtension\",\n \"ExtensionNotFound\",\n \"UnsupportedGeneralNameType\",\n \"NameAttribute\",\n \"Name\",\n \"RelativeDistinguishedName\",\n \"ObjectIdentifier\",\n \"ExtensionType\",\n \"Extensions\",\n \"Extension\",\n \"ExtendedKeyUsage\",\n \"FreshestCRL\",\n \"IssuingDistributionPoint\",\n \"TLSFeature\",\n \"TLSFeatureType\",\n \"OCSPNoCheck\",\n \"BasicConstraints\",\n \"CRLNumber\",\n \"KeyUsage\",\n \"AuthorityInformationAccess\",\n \"AccessDescription\",\n \"CertificatePolicies\",\n \"PolicyInformation\",\n \"UserNotice\",\n \"NoticeReference\",\n \"SubjectKeyIdentifier\",\n \"NameConstraints\",\n \"CRLDistributionPoints\",\n \"DistributionPoint\",\n \"ReasonFlags\",\n \"InhibitAnyPolicy\",\n \"SubjectAlternativeName\",\n \"IssuerAlternativeName\",\n \"AuthorityKeyIdentifier\",\n \"GeneralNames\",\n \"GeneralName\",\n \"RFC822Name\",\n \"DNSName\",\n \"UniformResourceIdentifier\",\n \"RegisteredID\",\n \"DirectoryName\",\n \"IPAddress\",\n \"OtherName\",\n \"Certificate\",\n \"CertificateRevocationList\",\n \"CertificateRevocationListBuilder\",\n \"CertificateSigningRequest\",\n \"RevokedCertificate\",\n \"RevokedCertificateBuilder\",\n \"CertificateSigningRequestBuilder\",\n \"CertificateBuilder\",\n \"Version\",\n \"_SIG_OIDS_TO_HASH\",\n \"OID_CA_ISSUERS\",\n \"OID_OCSP\",\n \"_GENERAL_NAMES\",\n \"CertificateIssuer\",\n \"CRLReason\",\n \"InvalidityDate\",\n \"UnrecognizedExtension\",\n \"PolicyConstraints\",\n \"PrecertificateSignedCertificateTimestamps\",\n \"PrecertPoison\",\n \"OCSPNonce\",\n]\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/x509/base.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport abc\nimport datetime\nimport os\nfrom enum import Enum\n\nimport six\n\nfrom cryptography import utils\nfrom cryptography.hazmat.primitives.asymmetric import (\n dsa, ec, ed25519, ed448, rsa\n)\nfrom cryptography.x509.extensions import Extension, ExtensionType\nfrom cryptography.x509.name import Name\n\n\n_EARLIEST_UTC_TIME = datetime.datetime(1950, 1, 1)\n\n\ndef _reject_duplicate_extension(extension, extensions):\n # This is quadratic in the number of extensions\n for e in extensions:\n if e.oid == extension.oid:\n raise ValueError('This extension has already been set.')\n\n\ndef _convert_to_naive_utc_time(time):\n \"\"\"Normalizes a datetime to a naive datetime in UTC.\n\n time -- datetime to normalize. Assumed to be in UTC if not timezone\n aware.\n \"\"\"\n if time.tzinfo is not None:\n offset = time.utcoffset()\n offset = offset if offset else datetime.timedelta()\n return time.replace(tzinfo=None) - offset\n else:\n return time\n\n\nclass Version(Enum):\n v1 = 0\n v3 = 2\n\n\ndef load_pem_x509_certificate(data, backend):\n return backend.load_pem_x509_certificate(data)\n\n\ndef load_der_x509_certificate(data, backend):\n return backend.load_der_x509_certificate(data)\n\n\ndef load_pem_x509_csr(data, backend):\n return backend.load_pem_x509_csr(data)\n\n\ndef load_der_x509_csr(data, backend):\n return backend.load_der_x509_csr(data)\n\n\ndef load_pem_x509_crl(data, backend):\n return backend.load_pem_x509_crl(data)\n\n\ndef load_der_x509_crl(data, backend):\n return backend.load_der_x509_crl(data)\n\n\nclass InvalidVersion(Exception):\n def __init__(self, msg, parsed_version):\n super(InvalidVersion, self).__init__(msg)\n self.parsed_version = parsed_version\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass Certificate(object):\n @abc.abstractmethod\n def fingerprint(self, algorithm):\n \"\"\"\n Returns bytes using digest passed.\n \"\"\"\n\n @abc.abstractproperty\n def serial_number(self):\n \"\"\"\n Returns certificate serial number\n \"\"\"\n\n @abc.abstractproperty\n def version(self):\n \"\"\"\n Returns the certificate version\n \"\"\"\n\n @abc.abstractmethod\n def public_key(self):\n \"\"\"\n Returns the public key\n \"\"\"\n\n @abc.abstractproperty\n def not_valid_before(self):\n \"\"\"\n Not before time (represented as UTC datetime)\n \"\"\"\n\n @abc.abstractproperty\n def not_valid_after(self):\n \"\"\"\n Not after time (represented as UTC datetime)\n \"\"\"\n\n @abc.abstractproperty\n def issuer(self):\n \"\"\"\n Returns the issuer name object.\n \"\"\"\n\n @abc.abstractproperty\n def subject(self):\n \"\"\"\n Returns the subject name object.\n \"\"\"\n\n @abc.abstractproperty\n def signature_hash_algorithm(self):\n \"\"\"\n Returns a HashAlgorithm corresponding to the type of the digest signed\n in the certificate.\n \"\"\"\n\n @abc.abstractproperty\n def signature_algorithm_oid(self):\n \"\"\"\n Returns the ObjectIdentifier of the signature algorithm.\n \"\"\"\n\n @abc.abstractproperty\n def extensions(self):\n \"\"\"\n Returns an Extensions object.\n \"\"\"\n\n @abc.abstractproperty\n def signature(self):\n \"\"\"\n Returns the signature bytes.\n \"\"\"\n\n @abc.abstractproperty\n def tbs_certificate_bytes(self):\n \"\"\"\n Returns the tbsCertificate payload bytes as defined in RFC 5280.\n \"\"\"\n\n @abc.abstractmethod\n def __eq__(self, other):\n \"\"\"\n Checks equality.\n \"\"\"\n\n @abc.abstractmethod\n def __ne__(self, other):\n \"\"\"\n Checks not equal.\n \"\"\"\n\n @abc.abstractmethod\n def __hash__(self):\n \"\"\"\n Computes a hash.\n \"\"\"\n\n @abc.abstractmethod\n def public_bytes(self, encoding):\n \"\"\"\n Serializes the certificate to PEM or DER format.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass CertificateRevocationList(object):\n @abc.abstractmethod\n def public_bytes(self, encoding):\n \"\"\"\n Serializes the CRL to PEM or DER format.\n \"\"\"\n\n @abc.abstractmethod\n def fingerprint(self, algorithm):\n \"\"\"\n Returns bytes using digest passed.\n \"\"\"\n\n @abc.abstractmethod\n def get_revoked_certificate_by_serial_number(self, serial_number):\n \"\"\"\n Returns an instance of RevokedCertificate or None if the serial_number\n is not in the CRL.\n \"\"\"\n\n @abc.abstractproperty\n def signature_hash_algorithm(self):\n \"\"\"\n Returns a HashAlgorithm corresponding to the type of the digest signed\n in the certificate.\n \"\"\"\n\n @abc.abstractproperty\n def signature_algorithm_oid(self):\n \"\"\"\n Returns the ObjectIdentifier of the signature algorithm.\n \"\"\"\n\n @abc.abstractproperty\n def issuer(self):\n \"\"\"\n Returns the X509Name with the issuer of this CRL.\n \"\"\"\n\n @abc.abstractproperty\n def next_update(self):\n \"\"\"\n Returns the date of next update for this CRL.\n \"\"\"\n\n @abc.abstractproperty\n def last_update(self):\n \"\"\"\n Returns the date of last update for this CRL.\n \"\"\"\n\n @abc.abstractproperty\n def extensions(self):\n \"\"\"\n Returns an Extensions object containing a list of CRL extensions.\n \"\"\"\n\n @abc.abstractproperty\n def signature(self):\n \"\"\"\n Returns the signature bytes.\n \"\"\"\n\n @abc.abstractproperty\n def tbs_certlist_bytes(self):\n \"\"\"\n Returns the tbsCertList payload bytes as defined in RFC 5280.\n \"\"\"\n\n @abc.abstractmethod\n def __eq__(self, other):\n \"\"\"\n Checks equality.\n \"\"\"\n\n @abc.abstractmethod\n def __ne__(self, other):\n \"\"\"\n Checks not equal.\n \"\"\"\n\n @abc.abstractmethod\n def __len__(self):\n \"\"\"\n Number of revoked certificates in the CRL.\n \"\"\"\n\n @abc.abstractmethod\n def __getitem__(self, idx):\n \"\"\"\n Returns a revoked certificate (or slice of revoked certificates).\n \"\"\"\n\n @abc.abstractmethod\n def __iter__(self):\n \"\"\"\n Iterator over the revoked certificates\n \"\"\"\n\n @abc.abstractmethod\n def is_signature_valid(self, public_key):\n \"\"\"\n Verifies signature of revocation list against given public key.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass CertificateSigningRequest(object):\n @abc.abstractmethod\n def __eq__(self, other):\n \"\"\"\n Checks equality.\n \"\"\"\n\n @abc.abstractmethod\n def __ne__(self, other):\n \"\"\"\n Checks not equal.\n \"\"\"\n\n @abc.abstractmethod\n def __hash__(self):\n \"\"\"\n Computes a hash.\n \"\"\"\n\n @abc.abstractmethod\n def public_key(self):\n \"\"\"\n Returns the public key\n \"\"\"\n\n @abc.abstractproperty\n def subject(self):\n \"\"\"\n Returns the subject name object.\n \"\"\"\n\n @abc.abstractproperty\n def signature_hash_algorithm(self):\n \"\"\"\n Returns a HashAlgorithm corresponding to the type of the digest signed\n in the certificate.\n \"\"\"\n\n @abc.abstractproperty\n def signature_algorithm_oid(self):\n \"\"\"\n Returns the ObjectIdentifier of the signature algorithm.\n \"\"\"\n\n @abc.abstractproperty\n def extensions(self):\n \"\"\"\n Returns the extensions in the signing request.\n \"\"\"\n\n @abc.abstractmethod\n def public_bytes(self, encoding):\n \"\"\"\n Encodes the request to PEM or DER format.\n \"\"\"\n\n @abc.abstractproperty\n def signature(self):\n \"\"\"\n Returns the signature bytes.\n \"\"\"\n\n @abc.abstractproperty\n def tbs_certrequest_bytes(self):\n \"\"\"\n Returns the PKCS#10 CertificationRequestInfo bytes as defined in RFC\n 2986.\n \"\"\"\n\n @abc.abstractproperty\n def is_signature_valid(self):\n \"\"\"\n Verifies signature of signing request.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass RevokedCertificate(object):\n @abc.abstractproperty\n def serial_number(self):\n \"\"\"\n Returns the serial number of the revoked certificate.\n \"\"\"\n\n @abc.abstractproperty\n def revocation_date(self):\n \"\"\"\n Returns the date of when this certificate was revoked.\n \"\"\"\n\n @abc.abstractproperty\n def extensions(self):\n \"\"\"\n Returns an Extensions object containing a list of Revoked extensions.\n \"\"\"\n\n\nclass CertificateSigningRequestBuilder(object):\n def __init__(self, subject_name=None, extensions=[]):\n \"\"\"\n Creates an empty X.509 certificate request (v1).\n \"\"\"\n self._subject_name = subject_name\n self._extensions = extensions\n\n def subject_name(self, name):\n \"\"\"\n Sets the certificate requestor's distinguished name.\n \"\"\"\n if not isinstance(name, Name):\n raise TypeError('Expecting x509.Name object.')\n if self._subject_name is not None:\n raise ValueError('The subject name may only be set once.')\n return CertificateSigningRequestBuilder(name, self._extensions)\n\n def add_extension(self, extension, critical):\n \"\"\"\n Adds an X.509 extension to the certificate request.\n \"\"\"\n if not isinstance(extension, ExtensionType):\n raise TypeError(\"extension must be an ExtensionType\")\n\n extension = Extension(extension.oid, critical, extension)\n _reject_duplicate_extension(extension, self._extensions)\n\n return CertificateSigningRequestBuilder(\n self._subject_name, self._extensions + [extension]\n )\n\n def sign(self, private_key, algorithm, backend):\n \"\"\"\n Signs the request using the requestor's private key.\n \"\"\"\n if self._subject_name is None:\n raise ValueError(\"A CertificateSigningRequest must have a subject\")\n return backend.create_x509_csr(self, private_key, algorithm)\n\n\nclass CertificateBuilder(object):\n def __init__(self, issuer_name=None, subject_name=None,\n public_key=None, serial_number=None, not_valid_before=None,\n not_valid_after=None, extensions=[]):\n self._version = Version.v3\n self._issuer_name = issuer_name\n self._subject_name = subject_name\n self._public_key = public_key\n self._serial_number = serial_number\n self._not_valid_before = not_valid_before\n self._not_valid_after = not_valid_after\n self._extensions = extensions\n\n def issuer_name(self, name):\n \"\"\"\n Sets the CA's distinguished name.\n \"\"\"\n if not isinstance(name, Name):\n raise TypeError('Expecting x509.Name object.')\n if self._issuer_name is not None:\n raise ValueError('The issuer name may only be set once.')\n return CertificateBuilder(\n name, self._subject_name, self._public_key,\n self._serial_number, self._not_valid_before,\n self._not_valid_after, self._extensions\n )\n\n def subject_name(self, name):\n \"\"\"\n Sets the requestor's distinguished name.\n \"\"\"\n if not isinstance(name, Name):\n raise TypeError('Expecting x509.Name object.')\n if self._subject_name is not None:\n raise ValueError('The subject name may only be set once.')\n return CertificateBuilder(\n self._issuer_name, name, self._public_key,\n self._serial_number, self._not_valid_before,\n self._not_valid_after, self._extensions\n )\n\n def public_key(self, key):\n \"\"\"\n Sets the requestor's public key (as found in the signing request).\n \"\"\"\n if not isinstance(key, (dsa.DSAPublicKey, rsa.RSAPublicKey,\n ec.EllipticCurvePublicKey,\n ed25519.Ed25519PublicKey,\n ed448.Ed448PublicKey)):\n raise TypeError('Expecting one of DSAPublicKey, RSAPublicKey,'\n ' EllipticCurvePublicKey, Ed25519PublicKey or'\n ' Ed448PublicKey.')\n if self._public_key is not None:\n raise ValueError('The public key may only be set once.')\n return CertificateBuilder(\n self._issuer_name, self._subject_name, key,\n self._serial_number, self._not_valid_before,\n self._not_valid_after, self._extensions\n )\n\n def serial_number(self, number):\n \"\"\"\n Sets the certificate serial number.\n \"\"\"\n if not isinstance(number, six.integer_types):\n raise TypeError('Serial number must be of integral type.')\n if self._serial_number is not None:\n raise ValueError('The serial number may only be set once.')\n if number <= 0:\n raise ValueError('The serial number should be positive.')\n\n # ASN.1 integers are always signed, so most significant bit must be\n # zero.\n if number.bit_length() >= 160: # As defined in RFC 5280\n raise ValueError('The serial number should not be more than 159 '\n 'bits.')\n return CertificateBuilder(\n self._issuer_name, self._subject_name,\n self._public_key, number, self._not_valid_before,\n self._not_valid_after, self._extensions\n )\n\n def not_valid_before(self, time):\n \"\"\"\n Sets the certificate activation time.\n \"\"\"\n if not isinstance(time, datetime.datetime):\n raise TypeError('Expecting datetime object.')\n if self._not_valid_before is not None:\n raise ValueError('The not valid before may only be set once.')\n time = _convert_to_naive_utc_time(time)\n if time < _EARLIEST_UTC_TIME:\n raise ValueError('The not valid before date must be on or after'\n ' 1950 January 1).')\n if self._not_valid_after is not None and time > self._not_valid_after:\n raise ValueError(\n 'The not valid before date must be before the not valid after '\n 'date.'\n )\n return CertificateBuilder(\n self._issuer_name, self._subject_name,\n self._public_key, self._serial_number, time,\n self._not_valid_after, self._extensions\n )\n\n def not_valid_after(self, time):\n \"\"\"\n Sets the certificate expiration time.\n \"\"\"\n if not isinstance(time, datetime.datetime):\n raise TypeError('Expecting datetime object.')\n if self._not_valid_after is not None:\n raise ValueError('The not valid after may only be set once.')\n time = _convert_to_naive_utc_time(time)\n if time < _EARLIEST_UTC_TIME:\n raise ValueError('The not valid after date must be on or after'\n ' 1950 January 1.')\n if (self._not_valid_before is not None and\n time < self._not_valid_before):\n raise ValueError(\n 'The not valid after date must be after the not valid before '\n 'date.'\n )\n return CertificateBuilder(\n self._issuer_name, self._subject_name,\n self._public_key, self._serial_number, self._not_valid_before,\n time, self._extensions\n )\n\n def add_extension(self, extension, critical):\n \"\"\"\n Adds an X.509 extension to the certificate.\n \"\"\"\n if not isinstance(extension, ExtensionType):\n raise TypeError(\"extension must be an ExtensionType\")\n\n extension = Extension(extension.oid, critical, extension)\n _reject_duplicate_extension(extension, self._extensions)\n\n return CertificateBuilder(\n self._issuer_name, self._subject_name,\n self._public_key, self._serial_number, self._not_valid_before,\n self._not_valid_after, self._extensions + [extension]\n )\n\n def sign(self, private_key, algorithm, backend):\n \"\"\"\n Signs the certificate using the CA's private key.\n \"\"\"\n if self._subject_name is None:\n raise ValueError(\"A certificate must have a subject name\")\n\n if self._issuer_name is None:\n raise ValueError(\"A certificate must have an issuer name\")\n\n if self._serial_number is None:\n raise ValueError(\"A certificate must have a serial number\")\n\n if self._not_valid_before is None:\n raise ValueError(\"A certificate must have a not valid before time\")\n\n if self._not_valid_after is None:\n raise ValueError(\"A certificate must have a not valid after time\")\n\n if self._public_key is None:\n raise ValueError(\"A certificate must have a public key\")\n\n return backend.create_x509_certificate(self, private_key, algorithm)\n\n\nclass CertificateRevocationListBuilder(object):\n def __init__(self, issuer_name=None, last_update=None, next_update=None,\n extensions=[], revoked_certificates=[]):\n self._issuer_name = issuer_name\n self._last_update = last_update\n self._next_update = next_update\n self._extensions = extensions\n self._revoked_certificates = revoked_certificates\n\n def issuer_name(self, issuer_name):\n if not isinstance(issuer_name, Name):\n raise TypeError('Expecting x509.Name object.')\n if self._issuer_name is not None:\n raise ValueError('The issuer name may only be set once.')\n return CertificateRevocationListBuilder(\n issuer_name, self._last_update, self._next_update,\n self._extensions, self._revoked_certificates\n )\n\n def last_update(self, last_update):\n if not isinstance(last_update, datetime.datetime):\n raise TypeError('Expecting datetime object.')\n if self._last_update is not None:\n raise ValueError('Last update may only be set once.')\n last_update = _convert_to_naive_utc_time(last_update)\n if last_update < _EARLIEST_UTC_TIME:\n raise ValueError('The last update date must be on or after'\n ' 1950 January 1.')\n if self._next_update is not None and last_update > self._next_update:\n raise ValueError(\n 'The last update date must be before the next update date.'\n )\n return CertificateRevocationListBuilder(\n self._issuer_name, last_update, self._next_update,\n self._extensions, self._revoked_certificates\n )\n\n def next_update(self, next_update):\n if not isinstance(next_update, datetime.datetime):\n raise TypeError('Expecting datetime object.')\n if self._next_update is not None:\n raise ValueError('Last update may only be set once.')\n next_update = _convert_to_naive_utc_time(next_update)\n if next_update < _EARLIEST_UTC_TIME:\n raise ValueError('The last update date must be on or after'\n ' 1950 January 1.')\n if self._last_update is not None and next_update < self._last_update:\n raise ValueError(\n 'The next update date must be after the last update date.'\n )\n return CertificateRevocationListBuilder(\n self._issuer_name, self._last_update, next_update,\n self._extensions, self._revoked_certificates\n )\n\n def add_extension(self, extension, critical):\n \"\"\"\n Adds an X.509 extension to the certificate revocation list.\n \"\"\"\n if not isinstance(extension, ExtensionType):\n raise TypeError(\"extension must be an ExtensionType\")\n\n extension = Extension(extension.oid, critical, extension)\n _reject_duplicate_extension(extension, self._extensions)\n return CertificateRevocationListBuilder(\n self._issuer_name, self._last_update, self._next_update,\n self._extensions + [extension], self._revoked_certificates\n )\n\n def add_revoked_certificate(self, revoked_certificate):\n \"\"\"\n Adds a revoked certificate to the CRL.\n \"\"\"\n if not isinstance(revoked_certificate, RevokedCertificate):\n raise TypeError(\"Must be an instance of RevokedCertificate\")\n\n return CertificateRevocationListBuilder(\n self._issuer_name, self._last_update,\n self._next_update, self._extensions,\n self._revoked_certificates + [revoked_certificate]\n )\n\n def sign(self, private_key, algorithm, backend):\n if self._issuer_name is None:\n raise ValueError(\"A CRL must have an issuer name\")\n\n if self._last_update is None:\n raise ValueError(\"A CRL must have a last update time\")\n\n if self._next_update is None:\n raise ValueError(\"A CRL must have a next update time\")\n\n return backend.create_x509_crl(self, private_key, algorithm)\n\n\nclass RevokedCertificateBuilder(object):\n def __init__(self, serial_number=None, revocation_date=None,\n extensions=[]):\n self._serial_number = serial_number\n self._revocation_date = revocation_date\n self._extensions = extensions\n\n def serial_number(self, number):\n if not isinstance(number, six.integer_types):\n raise TypeError('Serial number must be of integral type.')\n if self._serial_number is not None:\n raise ValueError('The serial number may only be set once.')\n if number <= 0:\n raise ValueError('The serial number should be positive')\n\n # ASN.1 integers are always signed, so most significant bit must be\n # zero.\n if number.bit_length() >= 160: # As defined in RFC 5280\n raise ValueError('The serial number should not be more than 159 '\n 'bits.')\n return RevokedCertificateBuilder(\n number, self._revocation_date, self._extensions\n )\n\n def revocation_date(self, time):\n if not isinstance(time, datetime.datetime):\n raise TypeError('Expecting datetime object.')\n if self._revocation_date is not None:\n raise ValueError('The revocation date may only be set once.')\n time = _convert_to_naive_utc_time(time)\n if time < _EARLIEST_UTC_TIME:\n raise ValueError('The revocation date must be on or after'\n ' 1950 January 1.')\n return RevokedCertificateBuilder(\n self._serial_number, time, self._extensions\n )\n\n def add_extension(self, extension, critical):\n if not isinstance(extension, ExtensionType):\n raise TypeError(\"extension must be an ExtensionType\")\n\n extension = Extension(extension.oid, critical, extension)\n _reject_duplicate_extension(extension, self._extensions)\n return RevokedCertificateBuilder(\n self._serial_number, self._revocation_date,\n self._extensions + [extension]\n )\n\n def build(self, backend):\n if self._serial_number is None:\n raise ValueError(\"A revoked certificate must have a serial number\")\n if self._revocation_date is None:\n raise ValueError(\n \"A revoked certificate must have a revocation date\"\n )\n\n return backend.create_x509_revoked_certificate(self)\n\n\ndef random_serial_number():\n return utils.int_from_bytes(os.urandom(20), \"big\") >> 1\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/x509/certificate_transparency.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport abc\nfrom enum import Enum\n\nimport six\n\n\nclass LogEntryType(Enum):\n X509_CERTIFICATE = 0\n PRE_CERTIFICATE = 1\n\n\nclass Version(Enum):\n v1 = 0\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass SignedCertificateTimestamp(object):\n @abc.abstractproperty\n def version(self):\n \"\"\"\n Returns the SCT version.\n \"\"\"\n\n @abc.abstractproperty\n def log_id(self):\n \"\"\"\n Returns an identifier indicating which log this SCT is for.\n \"\"\"\n\n @abc.abstractproperty\n def timestamp(self):\n \"\"\"\n Returns the timestamp for this SCT.\n \"\"\"\n\n @abc.abstractproperty\n def entry_type(self):\n \"\"\"\n Returns whether this is an SCT for a certificate or pre-certificate.\n \"\"\"\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/x509/extensions.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport abc\nimport datetime\nimport hashlib\nimport ipaddress\nimport warnings\nfrom enum import Enum\n\nimport six\n\nfrom cryptography import utils\nfrom cryptography.hazmat._der import (\n BIT_STRING, DERReader, OBJECT_IDENTIFIER, SEQUENCE\n)\nfrom cryptography.hazmat.primitives import constant_time, serialization\nfrom cryptography.hazmat.primitives.asymmetric.ec import EllipticCurvePublicKey\nfrom cryptography.hazmat.primitives.asymmetric.rsa import RSAPublicKey\nfrom cryptography.x509.certificate_transparency import (\n SignedCertificateTimestamp\n)\nfrom cryptography.x509.general_name import GeneralName, IPAddress, OtherName\nfrom cryptography.x509.name import RelativeDistinguishedName\nfrom cryptography.x509.oid import (\n CRLEntryExtensionOID, ExtensionOID, OCSPExtensionOID, ObjectIdentifier,\n)\n\n\ndef _key_identifier_from_public_key(public_key):\n if isinstance(public_key, RSAPublicKey):\n data = public_key.public_bytes(\n serialization.Encoding.DER,\n serialization.PublicFormat.PKCS1,\n )\n elif isinstance(public_key, EllipticCurvePublicKey):\n data = public_key.public_bytes(\n serialization.Encoding.X962,\n serialization.PublicFormat.UncompressedPoint\n )\n else:\n # This is a very slow way to do this.\n serialized = public_key.public_bytes(\n serialization.Encoding.DER,\n serialization.PublicFormat.SubjectPublicKeyInfo\n )\n\n reader = DERReader(serialized)\n with reader.read_single_element(SEQUENCE) as public_key_info:\n algorithm = public_key_info.read_element(SEQUENCE)\n public_key = public_key_info.read_element(BIT_STRING)\n\n # Double-check the algorithm structure.\n with algorithm:\n algorithm.read_element(OBJECT_IDENTIFIER)\n if not algorithm.is_empty():\n # Skip the optional parameters field.\n algorithm.read_any_element()\n\n # BIT STRING contents begin with the number of padding bytes added. It\n # must be zero for SubjectPublicKeyInfo structures.\n if public_key.read_byte() != 0:\n raise ValueError('Invalid public key encoding')\n\n data = public_key.data\n\n return hashlib.sha1(data).digest()\n\n\ndef _make_sequence_methods(field_name):\n def len_method(self):\n return len(getattr(self, field_name))\n\n def iter_method(self):\n return iter(getattr(self, field_name))\n\n def getitem_method(self, idx):\n return getattr(self, field_name)[idx]\n\n return len_method, iter_method, getitem_method\n\n\nclass DuplicateExtension(Exception):\n def __init__(self, msg, oid):\n super(DuplicateExtension, self).__init__(msg)\n self.oid = oid\n\n\nclass ExtensionNotFound(Exception):\n def __init__(self, msg, oid):\n super(ExtensionNotFound, self).__init__(msg)\n self.oid = oid\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass ExtensionType(object):\n @abc.abstractproperty\n def oid(self):\n \"\"\"\n Returns the oid associated with the given extension type.\n \"\"\"\n\n\nclass Extensions(object):\n def __init__(self, extensions):\n self._extensions = extensions\n\n def get_extension_for_oid(self, oid):\n for ext in self:\n if ext.oid == oid:\n return ext\n\n raise ExtensionNotFound(\"No {} extension was found\".format(oid), oid)\n\n def get_extension_for_class(self, extclass):\n if extclass is UnrecognizedExtension:\n raise TypeError(\n \"UnrecognizedExtension can't be used with \"\n \"get_extension_for_class because more than one instance of the\"\n \" class may be present.\"\n )\n\n for ext in self:\n if isinstance(ext.value, extclass):\n return ext\n\n raise ExtensionNotFound(\n \"No {} extension was found\".format(extclass), extclass.oid\n )\n\n __len__, __iter__, __getitem__ = _make_sequence_methods(\"_extensions\")\n\n def __repr__(self):\n return (\n \"\".format(self._extensions)\n )\n\n\n@utils.register_interface(ExtensionType)\nclass CRLNumber(object):\n oid = ExtensionOID.CRL_NUMBER\n\n def __init__(self, crl_number):\n if not isinstance(crl_number, six.integer_types):\n raise TypeError(\"crl_number must be an integer\")\n\n self._crl_number = crl_number\n\n def __eq__(self, other):\n if not isinstance(other, CRLNumber):\n return NotImplemented\n\n return self.crl_number == other.crl_number\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash(self.crl_number)\n\n def __repr__(self):\n return \"\".format(self.crl_number)\n\n crl_number = utils.read_only_property(\"_crl_number\")\n\n\n@utils.register_interface(ExtensionType)\nclass AuthorityKeyIdentifier(object):\n oid = ExtensionOID.AUTHORITY_KEY_IDENTIFIER\n\n def __init__(self, key_identifier, authority_cert_issuer,\n authority_cert_serial_number):\n if (authority_cert_issuer is None) != (\n authority_cert_serial_number is None\n ):\n raise ValueError(\n \"authority_cert_issuer and authority_cert_serial_number \"\n \"must both be present or both None\"\n )\n\n if authority_cert_issuer is not None:\n authority_cert_issuer = list(authority_cert_issuer)\n if not all(\n isinstance(x, GeneralName) for x in authority_cert_issuer\n ):\n raise TypeError(\n \"authority_cert_issuer must be a list of GeneralName \"\n \"objects\"\n )\n\n if authority_cert_serial_number is not None and not isinstance(\n authority_cert_serial_number, six.integer_types\n ):\n raise TypeError(\n \"authority_cert_serial_number must be an integer\"\n )\n\n self._key_identifier = key_identifier\n self._authority_cert_issuer = authority_cert_issuer\n self._authority_cert_serial_number = authority_cert_serial_number\n\n @classmethod\n def from_issuer_public_key(cls, public_key):\n digest = _key_identifier_from_public_key(public_key)\n return cls(\n key_identifier=digest,\n authority_cert_issuer=None,\n authority_cert_serial_number=None\n )\n\n @classmethod\n def from_issuer_subject_key_identifier(cls, ski):\n if isinstance(ski, SubjectKeyIdentifier):\n digest = ski.digest\n else:\n digest = ski.value.digest\n warnings.warn(\n \"Extension objects are deprecated as arguments to \"\n \"from_issuer_subject_key_identifier and support will be \"\n \"removed soon. Please migrate to passing a \"\n \"SubjectKeyIdentifier directly.\",\n utils.DeprecatedIn27,\n stacklevel=2,\n )\n\n return cls(\n key_identifier=digest,\n authority_cert_issuer=None,\n authority_cert_serial_number=None\n )\n\n def __repr__(self):\n return (\n \"\".format(self)\n )\n\n def __eq__(self, other):\n if not isinstance(other, AuthorityKeyIdentifier):\n return NotImplemented\n\n return (\n self.key_identifier == other.key_identifier and\n self.authority_cert_issuer == other.authority_cert_issuer and\n self.authority_cert_serial_number ==\n other.authority_cert_serial_number\n )\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n if self.authority_cert_issuer is None:\n aci = None\n else:\n aci = tuple(self.authority_cert_issuer)\n return hash((\n self.key_identifier, aci, self.authority_cert_serial_number\n ))\n\n key_identifier = utils.read_only_property(\"_key_identifier\")\n authority_cert_issuer = utils.read_only_property(\"_authority_cert_issuer\")\n authority_cert_serial_number = utils.read_only_property(\n \"_authority_cert_serial_number\"\n )\n\n\n@utils.register_interface(ExtensionType)\nclass SubjectKeyIdentifier(object):\n oid = ExtensionOID.SUBJECT_KEY_IDENTIFIER\n\n def __init__(self, digest):\n self._digest = digest\n\n @classmethod\n def from_public_key(cls, public_key):\n return cls(_key_identifier_from_public_key(public_key))\n\n digest = utils.read_only_property(\"_digest\")\n\n def __repr__(self):\n return \"\".format(self.digest)\n\n def __eq__(self, other):\n if not isinstance(other, SubjectKeyIdentifier):\n return NotImplemented\n\n return constant_time.bytes_eq(self.digest, other.digest)\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash(self.digest)\n\n\n@utils.register_interface(ExtensionType)\nclass AuthorityInformationAccess(object):\n oid = ExtensionOID.AUTHORITY_INFORMATION_ACCESS\n\n def __init__(self, descriptions):\n descriptions = list(descriptions)\n if not all(isinstance(x, AccessDescription) for x in descriptions):\n raise TypeError(\n \"Every item in the descriptions list must be an \"\n \"AccessDescription\"\n )\n\n self._descriptions = descriptions\n\n __len__, __iter__, __getitem__ = _make_sequence_methods(\"_descriptions\")\n\n def __repr__(self):\n return \"\".format(self._descriptions)\n\n def __eq__(self, other):\n if not isinstance(other, AuthorityInformationAccess):\n return NotImplemented\n\n return self._descriptions == other._descriptions\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash(tuple(self._descriptions))\n\n\nclass AccessDescription(object):\n def __init__(self, access_method, access_location):\n if not isinstance(access_method, ObjectIdentifier):\n raise TypeError(\"access_method must be an ObjectIdentifier\")\n\n if not isinstance(access_location, GeneralName):\n raise TypeError(\"access_location must be a GeneralName\")\n\n self._access_method = access_method\n self._access_location = access_location\n\n def __repr__(self):\n return (\n \"\".format(self)\n )\n\n def __eq__(self, other):\n if not isinstance(other, AccessDescription):\n return NotImplemented\n\n return (\n self.access_method == other.access_method and\n self.access_location == other.access_location\n )\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash((self.access_method, self.access_location))\n\n access_method = utils.read_only_property(\"_access_method\")\n access_location = utils.read_only_property(\"_access_location\")\n\n\n@utils.register_interface(ExtensionType)\nclass BasicConstraints(object):\n oid = ExtensionOID.BASIC_CONSTRAINTS\n\n def __init__(self, ca, path_length):\n if not isinstance(ca, bool):\n raise TypeError(\"ca must be a boolean value\")\n\n if path_length is not None and not ca:\n raise ValueError(\"path_length must be None when ca is False\")\n\n if (\n path_length is not None and\n (not isinstance(path_length, six.integer_types) or path_length < 0)\n ):\n raise TypeError(\n \"path_length must be a non-negative integer or None\"\n )\n\n self._ca = ca\n self._path_length = path_length\n\n ca = utils.read_only_property(\"_ca\")\n path_length = utils.read_only_property(\"_path_length\")\n\n def __repr__(self):\n return (\"\").format(self)\n\n def __eq__(self, other):\n if not isinstance(other, BasicConstraints):\n return NotImplemented\n\n return self.ca == other.ca and self.path_length == other.path_length\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash((self.ca, self.path_length))\n\n\n@utils.register_interface(ExtensionType)\nclass DeltaCRLIndicator(object):\n oid = ExtensionOID.DELTA_CRL_INDICATOR\n\n def __init__(self, crl_number):\n if not isinstance(crl_number, six.integer_types):\n raise TypeError(\"crl_number must be an integer\")\n\n self._crl_number = crl_number\n\n crl_number = utils.read_only_property(\"_crl_number\")\n\n def __eq__(self, other):\n if not isinstance(other, DeltaCRLIndicator):\n return NotImplemented\n\n return self.crl_number == other.crl_number\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash(self.crl_number)\n\n def __repr__(self):\n return \"\".format(self)\n\n\n@utils.register_interface(ExtensionType)\nclass CRLDistributionPoints(object):\n oid = ExtensionOID.CRL_DISTRIBUTION_POINTS\n\n def __init__(self, distribution_points):\n distribution_points = list(distribution_points)\n if not all(\n isinstance(x, DistributionPoint) for x in distribution_points\n ):\n raise TypeError(\n \"distribution_points must be a list of DistributionPoint \"\n \"objects\"\n )\n\n self._distribution_points = distribution_points\n\n __len__, __iter__, __getitem__ = _make_sequence_methods(\n \"_distribution_points\"\n )\n\n def __repr__(self):\n return \"\".format(self._distribution_points)\n\n def __eq__(self, other):\n if not isinstance(other, CRLDistributionPoints):\n return NotImplemented\n\n return self._distribution_points == other._distribution_points\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash(tuple(self._distribution_points))\n\n\n@utils.register_interface(ExtensionType)\nclass FreshestCRL(object):\n oid = ExtensionOID.FRESHEST_CRL\n\n def __init__(self, distribution_points):\n distribution_points = list(distribution_points)\n if not all(\n isinstance(x, DistributionPoint) for x in distribution_points\n ):\n raise TypeError(\n \"distribution_points must be a list of DistributionPoint \"\n \"objects\"\n )\n\n self._distribution_points = distribution_points\n\n __len__, __iter__, __getitem__ = _make_sequence_methods(\n \"_distribution_points\"\n )\n\n def __repr__(self):\n return \"\".format(self._distribution_points)\n\n def __eq__(self, other):\n if not isinstance(other, FreshestCRL):\n return NotImplemented\n\n return self._distribution_points == other._distribution_points\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash(tuple(self._distribution_points))\n\n\nclass DistributionPoint(object):\n def __init__(self, full_name, relative_name, reasons, crl_issuer):\n if full_name and relative_name:\n raise ValueError(\n \"You cannot provide both full_name and relative_name, at \"\n \"least one must be None.\"\n )\n\n if full_name:\n full_name = list(full_name)\n if not all(isinstance(x, GeneralName) for x in full_name):\n raise TypeError(\n \"full_name must be a list of GeneralName objects\"\n )\n\n if relative_name:\n if not isinstance(relative_name, RelativeDistinguishedName):\n raise TypeError(\n \"relative_name must be a RelativeDistinguishedName\"\n )\n\n if crl_issuer:\n crl_issuer = list(crl_issuer)\n if not all(isinstance(x, GeneralName) for x in crl_issuer):\n raise TypeError(\n \"crl_issuer must be None or a list of general names\"\n )\n\n if reasons and (not isinstance(reasons, frozenset) or not all(\n isinstance(x, ReasonFlags) for x in reasons\n )):\n raise TypeError(\"reasons must be None or frozenset of ReasonFlags\")\n\n if reasons and (\n ReasonFlags.unspecified in reasons or\n ReasonFlags.remove_from_crl in reasons\n ):\n raise ValueError(\n \"unspecified and remove_from_crl are not valid reasons in a \"\n \"DistributionPoint\"\n )\n\n if reasons and not crl_issuer and not (full_name or relative_name):\n raise ValueError(\n \"You must supply crl_issuer, full_name, or relative_name when \"\n \"reasons is not None\"\n )\n\n self._full_name = full_name\n self._relative_name = relative_name\n self._reasons = reasons\n self._crl_issuer = crl_issuer\n\n def __repr__(self):\n return (\n \"\"\n .format(self)\n )\n\n def __eq__(self, other):\n if not isinstance(other, DistributionPoint):\n return NotImplemented\n\n return (\n self.full_name == other.full_name and\n self.relative_name == other.relative_name and\n self.reasons == other.reasons and\n self.crl_issuer == other.crl_issuer\n )\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n if self.full_name is not None:\n fn = tuple(self.full_name)\n else:\n fn = None\n\n if self.crl_issuer is not None:\n crl_issuer = tuple(self.crl_issuer)\n else:\n crl_issuer = None\n\n return hash((fn, self.relative_name, self.reasons, crl_issuer))\n\n full_name = utils.read_only_property(\"_full_name\")\n relative_name = utils.read_only_property(\"_relative_name\")\n reasons = utils.read_only_property(\"_reasons\")\n crl_issuer = utils.read_only_property(\"_crl_issuer\")\n\n\nclass ReasonFlags(Enum):\n unspecified = \"unspecified\"\n key_compromise = \"keyCompromise\"\n ca_compromise = \"cACompromise\"\n affiliation_changed = \"affiliationChanged\"\n superseded = \"superseded\"\n cessation_of_operation = \"cessationOfOperation\"\n certificate_hold = \"certificateHold\"\n privilege_withdrawn = \"privilegeWithdrawn\"\n aa_compromise = \"aACompromise\"\n remove_from_crl = \"removeFromCRL\"\n\n\n@utils.register_interface(ExtensionType)\nclass PolicyConstraints(object):\n oid = ExtensionOID.POLICY_CONSTRAINTS\n\n def __init__(self, require_explicit_policy, inhibit_policy_mapping):\n if require_explicit_policy is not None and not isinstance(\n require_explicit_policy, six.integer_types\n ):\n raise TypeError(\n \"require_explicit_policy must be a non-negative integer or \"\n \"None\"\n )\n\n if inhibit_policy_mapping is not None and not isinstance(\n inhibit_policy_mapping, six.integer_types\n ):\n raise TypeError(\n \"inhibit_policy_mapping must be a non-negative integer or None\"\n )\n\n if inhibit_policy_mapping is None and require_explicit_policy is None:\n raise ValueError(\n \"At least one of require_explicit_policy and \"\n \"inhibit_policy_mapping must not be None\"\n )\n\n self._require_explicit_policy = require_explicit_policy\n self._inhibit_policy_mapping = inhibit_policy_mapping\n\n def __repr__(self):\n return (\n u\"\".format(self)\n )\n\n def __eq__(self, other):\n if not isinstance(other, PolicyConstraints):\n return NotImplemented\n\n return (\n self.require_explicit_policy == other.require_explicit_policy and\n self.inhibit_policy_mapping == other.inhibit_policy_mapping\n )\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash(\n (self.require_explicit_policy, self.inhibit_policy_mapping)\n )\n\n require_explicit_policy = utils.read_only_property(\n \"_require_explicit_policy\"\n )\n inhibit_policy_mapping = utils.read_only_property(\n \"_inhibit_policy_mapping\"\n )\n\n\n@utils.register_interface(ExtensionType)\nclass CertificatePolicies(object):\n oid = ExtensionOID.CERTIFICATE_POLICIES\n\n def __init__(self, policies):\n policies = list(policies)\n if not all(isinstance(x, PolicyInformation) for x in policies):\n raise TypeError(\n \"Every item in the policies list must be a \"\n \"PolicyInformation\"\n )\n\n self._policies = policies\n\n __len__, __iter__, __getitem__ = _make_sequence_methods(\"_policies\")\n\n def __repr__(self):\n return \"\".format(self._policies)\n\n def __eq__(self, other):\n if not isinstance(other, CertificatePolicies):\n return NotImplemented\n\n return self._policies == other._policies\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash(tuple(self._policies))\n\n\nclass PolicyInformation(object):\n def __init__(self, policy_identifier, policy_qualifiers):\n if not isinstance(policy_identifier, ObjectIdentifier):\n raise TypeError(\"policy_identifier must be an ObjectIdentifier\")\n\n self._policy_identifier = policy_identifier\n\n if policy_qualifiers:\n policy_qualifiers = list(policy_qualifiers)\n if not all(\n isinstance(x, (six.text_type, UserNotice))\n for x in policy_qualifiers\n ):\n raise TypeError(\n \"policy_qualifiers must be a list of strings and/or \"\n \"UserNotice objects or None\"\n )\n\n self._policy_qualifiers = policy_qualifiers\n\n def __repr__(self):\n return (\n \"\".format(self)\n )\n\n def __eq__(self, other):\n if not isinstance(other, PolicyInformation):\n return NotImplemented\n\n return (\n self.policy_identifier == other.policy_identifier and\n self.policy_qualifiers == other.policy_qualifiers\n )\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n if self.policy_qualifiers is not None:\n pq = tuple(self.policy_qualifiers)\n else:\n pq = None\n\n return hash((self.policy_identifier, pq))\n\n policy_identifier = utils.read_only_property(\"_policy_identifier\")\n policy_qualifiers = utils.read_only_property(\"_policy_qualifiers\")\n\n\nclass UserNotice(object):\n def __init__(self, notice_reference, explicit_text):\n if notice_reference and not isinstance(\n notice_reference, NoticeReference\n ):\n raise TypeError(\n \"notice_reference must be None or a NoticeReference\"\n )\n\n self._notice_reference = notice_reference\n self._explicit_text = explicit_text\n\n def __repr__(self):\n return (\n \"\".format(self)\n )\n\n def __eq__(self, other):\n if not isinstance(other, UserNotice):\n return NotImplemented\n\n return (\n self.notice_reference == other.notice_reference and\n self.explicit_text == other.explicit_text\n )\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash((self.notice_reference, self.explicit_text))\n\n notice_reference = utils.read_only_property(\"_notice_reference\")\n explicit_text = utils.read_only_property(\"_explicit_text\")\n\n\nclass NoticeReference(object):\n def __init__(self, organization, notice_numbers):\n self._organization = organization\n notice_numbers = list(notice_numbers)\n if not all(isinstance(x, int) for x in notice_numbers):\n raise TypeError(\n \"notice_numbers must be a list of integers\"\n )\n\n self._notice_numbers = notice_numbers\n\n def __repr__(self):\n return (\n \"\".format(self)\n )\n\n def __eq__(self, other):\n if not isinstance(other, NoticeReference):\n return NotImplemented\n\n return (\n self.organization == other.organization and\n self.notice_numbers == other.notice_numbers\n )\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash((self.organization, tuple(self.notice_numbers)))\n\n organization = utils.read_only_property(\"_organization\")\n notice_numbers = utils.read_only_property(\"_notice_numbers\")\n\n\n@utils.register_interface(ExtensionType)\nclass ExtendedKeyUsage(object):\n oid = ExtensionOID.EXTENDED_KEY_USAGE\n\n def __init__(self, usages):\n usages = list(usages)\n if not all(isinstance(x, ObjectIdentifier) for x in usages):\n raise TypeError(\n \"Every item in the usages list must be an ObjectIdentifier\"\n )\n\n self._usages = usages\n\n __len__, __iter__, __getitem__ = _make_sequence_methods(\"_usages\")\n\n def __repr__(self):\n return \"\".format(self._usages)\n\n def __eq__(self, other):\n if not isinstance(other, ExtendedKeyUsage):\n return NotImplemented\n\n return self._usages == other._usages\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash(tuple(self._usages))\n\n\n@utils.register_interface(ExtensionType)\nclass OCSPNoCheck(object):\n oid = ExtensionOID.OCSP_NO_CHECK\n\n def __eq__(self, other):\n if not isinstance(other, OCSPNoCheck):\n return NotImplemented\n\n return True\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash(OCSPNoCheck)\n\n def __repr__(self):\n return \"\"\n\n\n@utils.register_interface(ExtensionType)\nclass PrecertPoison(object):\n oid = ExtensionOID.PRECERT_POISON\n\n def __eq__(self, other):\n if not isinstance(other, PrecertPoison):\n return NotImplemented\n\n return True\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash(PrecertPoison)\n\n def __repr__(self):\n return \"\"\n\n\n@utils.register_interface(ExtensionType)\nclass TLSFeature(object):\n oid = ExtensionOID.TLS_FEATURE\n\n def __init__(self, features):\n features = list(features)\n if (\n not all(isinstance(x, TLSFeatureType) for x in features) or\n len(features) == 0\n ):\n raise TypeError(\n \"features must be a list of elements from the TLSFeatureType \"\n \"enum\"\n )\n\n self._features = features\n\n __len__, __iter__, __getitem__ = _make_sequence_methods(\"_features\")\n\n def __repr__(self):\n return \"\".format(self)\n\n def __eq__(self, other):\n if not isinstance(other, TLSFeature):\n return NotImplemented\n\n return self._features == other._features\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash(tuple(self._features))\n\n\nclass TLSFeatureType(Enum):\n # status_request is defined in RFC 6066 and is used for what is commonly\n # called OCSP Must-Staple when present in the TLS Feature extension in an\n # X.509 certificate.\n status_request = 5\n # status_request_v2 is defined in RFC 6961 and allows multiple OCSP\n # responses to be provided. It is not currently in use by clients or\n # servers.\n status_request_v2 = 17\n\n\n_TLS_FEATURE_TYPE_TO_ENUM = dict((x.value, x) for x in TLSFeatureType)\n\n\n@utils.register_interface(ExtensionType)\nclass InhibitAnyPolicy(object):\n oid = ExtensionOID.INHIBIT_ANY_POLICY\n\n def __init__(self, skip_certs):\n if not isinstance(skip_certs, six.integer_types):\n raise TypeError(\"skip_certs must be an integer\")\n\n if skip_certs < 0:\n raise ValueError(\"skip_certs must be a non-negative integer\")\n\n self._skip_certs = skip_certs\n\n def __repr__(self):\n return \"\".format(self)\n\n def __eq__(self, other):\n if not isinstance(other, InhibitAnyPolicy):\n return NotImplemented\n\n return self.skip_certs == other.skip_certs\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash(self.skip_certs)\n\n skip_certs = utils.read_only_property(\"_skip_certs\")\n\n\n@utils.register_interface(ExtensionType)\nclass KeyUsage(object):\n oid = ExtensionOID.KEY_USAGE\n\n def __init__(self, digital_signature, content_commitment, key_encipherment,\n data_encipherment, key_agreement, key_cert_sign, crl_sign,\n encipher_only, decipher_only):\n if not key_agreement and (encipher_only or decipher_only):\n raise ValueError(\n \"encipher_only and decipher_only can only be true when \"\n \"key_agreement is true\"\n )\n\n self._digital_signature = digital_signature\n self._content_commitment = content_commitment\n self._key_encipherment = key_encipherment\n self._data_encipherment = data_encipherment\n self._key_agreement = key_agreement\n self._key_cert_sign = key_cert_sign\n self._crl_sign = crl_sign\n self._encipher_only = encipher_only\n self._decipher_only = decipher_only\n\n digital_signature = utils.read_only_property(\"_digital_signature\")\n content_commitment = utils.read_only_property(\"_content_commitment\")\n key_encipherment = utils.read_only_property(\"_key_encipherment\")\n data_encipherment = utils.read_only_property(\"_data_encipherment\")\n key_agreement = utils.read_only_property(\"_key_agreement\")\n key_cert_sign = utils.read_only_property(\"_key_cert_sign\")\n crl_sign = utils.read_only_property(\"_crl_sign\")\n\n @property\n def encipher_only(self):\n if not self.key_agreement:\n raise ValueError(\n \"encipher_only is undefined unless key_agreement is true\"\n )\n else:\n return self._encipher_only\n\n @property\n def decipher_only(self):\n if not self.key_agreement:\n raise ValueError(\n \"decipher_only is undefined unless key_agreement is true\"\n )\n else:\n return self._decipher_only\n\n def __repr__(self):\n try:\n encipher_only = self.encipher_only\n decipher_only = self.decipher_only\n except ValueError:\n encipher_only = None\n decipher_only = None\n\n return (\"\").format(\n self, encipher_only, decipher_only)\n\n def __eq__(self, other):\n if not isinstance(other, KeyUsage):\n return NotImplemented\n\n return (\n self.digital_signature == other.digital_signature and\n self.content_commitment == other.content_commitment and\n self.key_encipherment == other.key_encipherment and\n self.data_encipherment == other.data_encipherment and\n self.key_agreement == other.key_agreement and\n self.key_cert_sign == other.key_cert_sign and\n self.crl_sign == other.crl_sign and\n self._encipher_only == other._encipher_only and\n self._decipher_only == other._decipher_only\n )\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash((\n self.digital_signature, self.content_commitment,\n self.key_encipherment, self.data_encipherment,\n self.key_agreement, self.key_cert_sign,\n self.crl_sign, self._encipher_only,\n self._decipher_only\n ))\n\n\n@utils.register_interface(ExtensionType)\nclass NameConstraints(object):\n oid = ExtensionOID.NAME_CONSTRAINTS\n\n def __init__(self, permitted_subtrees, excluded_subtrees):\n if permitted_subtrees is not None:\n permitted_subtrees = list(permitted_subtrees)\n if not all(\n isinstance(x, GeneralName) for x in permitted_subtrees\n ):\n raise TypeError(\n \"permitted_subtrees must be a list of GeneralName objects \"\n \"or None\"\n )\n\n self._validate_ip_name(permitted_subtrees)\n\n if excluded_subtrees is not None:\n excluded_subtrees = list(excluded_subtrees)\n if not all(\n isinstance(x, GeneralName) for x in excluded_subtrees\n ):\n raise TypeError(\n \"excluded_subtrees must be a list of GeneralName objects \"\n \"or None\"\n )\n\n self._validate_ip_name(excluded_subtrees)\n\n if permitted_subtrees is None and excluded_subtrees is None:\n raise ValueError(\n \"At least one of permitted_subtrees and excluded_subtrees \"\n \"must not be None\"\n )\n\n self._permitted_subtrees = permitted_subtrees\n self._excluded_subtrees = excluded_subtrees\n\n def __eq__(self, other):\n if not isinstance(other, NameConstraints):\n return NotImplemented\n\n return (\n self.excluded_subtrees == other.excluded_subtrees and\n self.permitted_subtrees == other.permitted_subtrees\n )\n\n def __ne__(self, other):\n return not self == other\n\n def _validate_ip_name(self, tree):\n if any(isinstance(name, IPAddress) and not isinstance(\n name.value, (ipaddress.IPv4Network, ipaddress.IPv6Network)\n ) for name in tree):\n raise TypeError(\n \"IPAddress name constraints must be an IPv4Network or\"\n \" IPv6Network object\"\n )\n\n def __repr__(self):\n return (\n u\"\".format(self)\n )\n\n def __hash__(self):\n if self.permitted_subtrees is not None:\n ps = tuple(self.permitted_subtrees)\n else:\n ps = None\n\n if self.excluded_subtrees is not None:\n es = tuple(self.excluded_subtrees)\n else:\n es = None\n\n return hash((ps, es))\n\n permitted_subtrees = utils.read_only_property(\"_permitted_subtrees\")\n excluded_subtrees = utils.read_only_property(\"_excluded_subtrees\")\n\n\nclass Extension(object):\n def __init__(self, oid, critical, value):\n if not isinstance(oid, ObjectIdentifier):\n raise TypeError(\n \"oid argument must be an ObjectIdentifier instance.\"\n )\n\n if not isinstance(critical, bool):\n raise TypeError(\"critical must be a boolean value\")\n\n self._oid = oid\n self._critical = critical\n self._value = value\n\n oid = utils.read_only_property(\"_oid\")\n critical = utils.read_only_property(\"_critical\")\n value = utils.read_only_property(\"_value\")\n\n def __repr__(self):\n return (\"\").format(self)\n\n def __eq__(self, other):\n if not isinstance(other, Extension):\n return NotImplemented\n\n return (\n self.oid == other.oid and\n self.critical == other.critical and\n self.value == other.value\n )\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash((self.oid, self.critical, self.value))\n\n\nclass GeneralNames(object):\n def __init__(self, general_names):\n general_names = list(general_names)\n if not all(isinstance(x, GeneralName) for x in general_names):\n raise TypeError(\n \"Every item in the general_names list must be an \"\n \"object conforming to the GeneralName interface\"\n )\n\n self._general_names = general_names\n __len__, __iter__, __getitem__ = _make_sequence_methods(\"_general_names\")\n\n def get_values_for_type(self, type):\n # Return the value of each GeneralName, except for OtherName instances\n # which we return directly because it has two important properties not\n # just one value.\n objs = (i for i in self if isinstance(i, type))\n if type != OtherName:\n objs = (i.value for i in objs)\n return list(objs)\n\n def __repr__(self):\n return \"\".format(self._general_names)\n\n def __eq__(self, other):\n if not isinstance(other, GeneralNames):\n return NotImplemented\n\n return self._general_names == other._general_names\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash(tuple(self._general_names))\n\n\n@utils.register_interface(ExtensionType)\nclass SubjectAlternativeName(object):\n oid = ExtensionOID.SUBJECT_ALTERNATIVE_NAME\n\n def __init__(self, general_names):\n self._general_names = GeneralNames(general_names)\n\n __len__, __iter__, __getitem__ = _make_sequence_methods(\"_general_names\")\n\n def get_values_for_type(self, type):\n return self._general_names.get_values_for_type(type)\n\n def __repr__(self):\n return \"\".format(self._general_names)\n\n def __eq__(self, other):\n if not isinstance(other, SubjectAlternativeName):\n return NotImplemented\n\n return self._general_names == other._general_names\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash(self._general_names)\n\n\n@utils.register_interface(ExtensionType)\nclass IssuerAlternativeName(object):\n oid = ExtensionOID.ISSUER_ALTERNATIVE_NAME\n\n def __init__(self, general_names):\n self._general_names = GeneralNames(general_names)\n\n __len__, __iter__, __getitem__ = _make_sequence_methods(\"_general_names\")\n\n def get_values_for_type(self, type):\n return self._general_names.get_values_for_type(type)\n\n def __repr__(self):\n return \"\".format(self._general_names)\n\n def __eq__(self, other):\n if not isinstance(other, IssuerAlternativeName):\n return NotImplemented\n\n return self._general_names == other._general_names\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash(self._general_names)\n\n\n@utils.register_interface(ExtensionType)\nclass CertificateIssuer(object):\n oid = CRLEntryExtensionOID.CERTIFICATE_ISSUER\n\n def __init__(self, general_names):\n self._general_names = GeneralNames(general_names)\n\n __len__, __iter__, __getitem__ = _make_sequence_methods(\"_general_names\")\n\n def get_values_for_type(self, type):\n return self._general_names.get_values_for_type(type)\n\n def __repr__(self):\n return \"\".format(self._general_names)\n\n def __eq__(self, other):\n if not isinstance(other, CertificateIssuer):\n return NotImplemented\n\n return self._general_names == other._general_names\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash(self._general_names)\n\n\n@utils.register_interface(ExtensionType)\nclass CRLReason(object):\n oid = CRLEntryExtensionOID.CRL_REASON\n\n def __init__(self, reason):\n if not isinstance(reason, ReasonFlags):\n raise TypeError(\"reason must be an element from ReasonFlags\")\n\n self._reason = reason\n\n def __repr__(self):\n return \"\".format(self._reason)\n\n def __eq__(self, other):\n if not isinstance(other, CRLReason):\n return NotImplemented\n\n return self.reason == other.reason\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash(self.reason)\n\n reason = utils.read_only_property(\"_reason\")\n\n\n@utils.register_interface(ExtensionType)\nclass InvalidityDate(object):\n oid = CRLEntryExtensionOID.INVALIDITY_DATE\n\n def __init__(self, invalidity_date):\n if not isinstance(invalidity_date, datetime.datetime):\n raise TypeError(\"invalidity_date must be a datetime.datetime\")\n\n self._invalidity_date = invalidity_date\n\n def __repr__(self):\n return \"\".format(\n self._invalidity_date\n )\n\n def __eq__(self, other):\n if not isinstance(other, InvalidityDate):\n return NotImplemented\n\n return self.invalidity_date == other.invalidity_date\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash(self.invalidity_date)\n\n invalidity_date = utils.read_only_property(\"_invalidity_date\")\n\n\n@utils.register_interface(ExtensionType)\nclass PrecertificateSignedCertificateTimestamps(object):\n oid = ExtensionOID.PRECERT_SIGNED_CERTIFICATE_TIMESTAMPS\n\n def __init__(self, signed_certificate_timestamps):\n signed_certificate_timestamps = list(signed_certificate_timestamps)\n if not all(\n isinstance(sct, SignedCertificateTimestamp)\n for sct in signed_certificate_timestamps\n ):\n raise TypeError(\n \"Every item in the signed_certificate_timestamps list must be \"\n \"a SignedCertificateTimestamp\"\n )\n self._signed_certificate_timestamps = signed_certificate_timestamps\n\n __len__, __iter__, __getitem__ = _make_sequence_methods(\n \"_signed_certificate_timestamps\"\n )\n\n def __repr__(self):\n return (\n \"\".format(\n list(self)\n )\n )\n\n def __hash__(self):\n return hash(tuple(self._signed_certificate_timestamps))\n\n def __eq__(self, other):\n if not isinstance(other, PrecertificateSignedCertificateTimestamps):\n return NotImplemented\n\n return (\n self._signed_certificate_timestamps ==\n other._signed_certificate_timestamps\n )\n\n def __ne__(self, other):\n return not self == other\n\n\n@utils.register_interface(ExtensionType)\nclass OCSPNonce(object):\n oid = OCSPExtensionOID.NONCE\n\n def __init__(self, nonce):\n if not isinstance(nonce, bytes):\n raise TypeError(\"nonce must be bytes\")\n\n self._nonce = nonce\n\n def __eq__(self, other):\n if not isinstance(other, OCSPNonce):\n return NotImplemented\n\n return self.nonce == other.nonce\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash(self.nonce)\n\n def __repr__(self):\n return \"\".format(self)\n\n nonce = utils.read_only_property(\"_nonce\")\n\n\n@utils.register_interface(ExtensionType)\nclass IssuingDistributionPoint(object):\n oid = ExtensionOID.ISSUING_DISTRIBUTION_POINT\n\n def __init__(self, full_name, relative_name, only_contains_user_certs,\n only_contains_ca_certs, only_some_reasons, indirect_crl,\n only_contains_attribute_certs):\n if (\n only_some_reasons and (\n not isinstance(only_some_reasons, frozenset) or not all(\n isinstance(x, ReasonFlags) for x in only_some_reasons\n )\n )\n ):\n raise TypeError(\n \"only_some_reasons must be None or frozenset of ReasonFlags\"\n )\n\n if only_some_reasons and (\n ReasonFlags.unspecified in only_some_reasons or\n ReasonFlags.remove_from_crl in only_some_reasons\n ):\n raise ValueError(\n \"unspecified and remove_from_crl are not valid reasons in an \"\n \"IssuingDistributionPoint\"\n )\n\n if not (\n isinstance(only_contains_user_certs, bool) and\n isinstance(only_contains_ca_certs, bool) and\n isinstance(indirect_crl, bool) and\n isinstance(only_contains_attribute_certs, bool)\n ):\n raise TypeError(\n \"only_contains_user_certs, only_contains_ca_certs, \"\n \"indirect_crl and only_contains_attribute_certs \"\n \"must all be boolean.\"\n )\n\n crl_constraints = [\n only_contains_user_certs, only_contains_ca_certs,\n indirect_crl, only_contains_attribute_certs\n ]\n\n if len([x for x in crl_constraints if x]) > 1:\n raise ValueError(\n \"Only one of the following can be set to True: \"\n \"only_contains_user_certs, only_contains_ca_certs, \"\n \"indirect_crl, only_contains_attribute_certs\"\n )\n\n if (\n not any([\n only_contains_user_certs, only_contains_ca_certs,\n indirect_crl, only_contains_attribute_certs, full_name,\n relative_name, only_some_reasons\n ])\n ):\n raise ValueError(\n \"Cannot create empty extension: \"\n \"if only_contains_user_certs, only_contains_ca_certs, \"\n \"indirect_crl, and only_contains_attribute_certs are all False\"\n \", then either full_name, relative_name, or only_some_reasons \"\n \"must have a value.\"\n )\n\n self._only_contains_user_certs = only_contains_user_certs\n self._only_contains_ca_certs = only_contains_ca_certs\n self._indirect_crl = indirect_crl\n self._only_contains_attribute_certs = only_contains_attribute_certs\n self._only_some_reasons = only_some_reasons\n self._full_name = full_name\n self._relative_name = relative_name\n\n def __repr__(self):\n return (\n \"\".format(self)\n )\n\n def __eq__(self, other):\n if not isinstance(other, IssuingDistributionPoint):\n return NotImplemented\n\n return (\n self.full_name == other.full_name and\n self.relative_name == other.relative_name and\n self.only_contains_user_certs == other.only_contains_user_certs and\n self.only_contains_ca_certs == other.only_contains_ca_certs and\n self.only_some_reasons == other.only_some_reasons and\n self.indirect_crl == other.indirect_crl and\n self.only_contains_attribute_certs ==\n other.only_contains_attribute_certs\n )\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash((\n self.full_name,\n self.relative_name,\n self.only_contains_user_certs,\n self.only_contains_ca_certs,\n self.only_some_reasons,\n self.indirect_crl,\n self.only_contains_attribute_certs,\n ))\n\n full_name = utils.read_only_property(\"_full_name\")\n relative_name = utils.read_only_property(\"_relative_name\")\n only_contains_user_certs = utils.read_only_property(\n \"_only_contains_user_certs\"\n )\n only_contains_ca_certs = utils.read_only_property(\n \"_only_contains_ca_certs\"\n )\n only_some_reasons = utils.read_only_property(\"_only_some_reasons\")\n indirect_crl = utils.read_only_property(\"_indirect_crl\")\n only_contains_attribute_certs = utils.read_only_property(\n \"_only_contains_attribute_certs\"\n )\n\n\n@utils.register_interface(ExtensionType)\nclass UnrecognizedExtension(object):\n def __init__(self, oid, value):\n if not isinstance(oid, ObjectIdentifier):\n raise TypeError(\"oid must be an ObjectIdentifier\")\n self._oid = oid\n self._value = value\n\n oid = utils.read_only_property(\"_oid\")\n value = utils.read_only_property(\"_value\")\n\n def __repr__(self):\n return (\n \"\".format(\n self\n )\n )\n\n def __eq__(self, other):\n if not isinstance(other, UnrecognizedExtension):\n return NotImplemented\n\n return self.oid == other.oid and self.value == other.value\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash((self.oid, self.value))\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/x509/general_name.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport abc\nimport ipaddress\nimport warnings\nfrom email.utils import parseaddr\n\nimport six\nfrom six.moves import urllib_parse\n\nfrom cryptography import utils\nfrom cryptography.x509.name import Name\nfrom cryptography.x509.oid import ObjectIdentifier\n\n\n_GENERAL_NAMES = {\n 0: \"otherName\",\n 1: \"rfc822Name\",\n 2: \"dNSName\",\n 3: \"x400Address\",\n 4: \"directoryName\",\n 5: \"ediPartyName\",\n 6: \"uniformResourceIdentifier\",\n 7: \"iPAddress\",\n 8: \"registeredID\",\n}\n\n\ndef _lazy_import_idna():\n # Import idna lazily becase it allocates a decent amount of memory, and\n # we're only using it in deprecated paths.\n try:\n import idna\n return idna\n except ImportError:\n raise ImportError(\n \"idna is not installed, but a deprecated feature that requires it\"\n \" was used. See: https://cryptography.io/en/latest/faq/#importe\"\n \"rror-idna-is-not-installed\"\n )\n\n\nclass UnsupportedGeneralNameType(Exception):\n def __init__(self, msg, type):\n super(UnsupportedGeneralNameType, self).__init__(msg)\n self.type = type\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass GeneralName(object):\n @abc.abstractproperty\n def value(self):\n \"\"\"\n Return the value of the object\n \"\"\"\n\n\n@utils.register_interface(GeneralName)\nclass RFC822Name(object):\n def __init__(self, value):\n if isinstance(value, six.text_type):\n try:\n value.encode(\"ascii\")\n except UnicodeEncodeError:\n value = self._idna_encode(value)\n warnings.warn(\n \"RFC822Name values should be passed as an A-label string. \"\n \"This means unicode characters should be encoded via \"\n \"idna. Support for passing unicode strings (aka U-label) \"\n \"will be removed in a future version.\",\n utils.PersistentlyDeprecated2017,\n stacklevel=2,\n )\n else:\n raise TypeError(\"value must be string\")\n\n name, address = parseaddr(value)\n if name or not address:\n # parseaddr has found a name (e.g. Name ) or the entire\n # value is an empty string.\n raise ValueError(\"Invalid rfc822name value\")\n\n self._value = value\n\n value = utils.read_only_property(\"_value\")\n\n @classmethod\n def _init_without_validation(cls, value):\n instance = cls.__new__(cls)\n instance._value = value\n return instance\n\n def _idna_encode(self, value):\n idna = _lazy_import_idna()\n _, address = parseaddr(value)\n parts = address.split(u\"@\")\n return parts[0] + \"@\" + idna.encode(parts[1]).decode(\"ascii\")\n\n def __repr__(self):\n return \"\".format(self.value)\n\n def __eq__(self, other):\n if not isinstance(other, RFC822Name):\n return NotImplemented\n\n return self.value == other.value\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash(self.value)\n\n\ndef _idna_encode(value):\n idna = _lazy_import_idna()\n # Retain prefixes '*.' for common/alt names and '.' for name constraints\n for prefix in ['*.', '.']:\n if value.startswith(prefix):\n value = value[len(prefix):]\n return prefix + idna.encode(value).decode(\"ascii\")\n return idna.encode(value).decode(\"ascii\")\n\n\n@utils.register_interface(GeneralName)\nclass DNSName(object):\n def __init__(self, value):\n if isinstance(value, six.text_type):\n try:\n value.encode(\"ascii\")\n except UnicodeEncodeError:\n value = _idna_encode(value)\n warnings.warn(\n \"DNSName values should be passed as an A-label string. \"\n \"This means unicode characters should be encoded via \"\n \"idna. Support for passing unicode strings (aka U-label) \"\n \"will be removed in a future version.\",\n utils.PersistentlyDeprecated2017,\n stacklevel=2,\n )\n else:\n raise TypeError(\"value must be string\")\n\n self._value = value\n\n value = utils.read_only_property(\"_value\")\n\n @classmethod\n def _init_without_validation(cls, value):\n instance = cls.__new__(cls)\n instance._value = value\n return instance\n\n def __repr__(self):\n return \"\".format(self.value)\n\n def __eq__(self, other):\n if not isinstance(other, DNSName):\n return NotImplemented\n\n return self.value == other.value\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash(self.value)\n\n\n@utils.register_interface(GeneralName)\nclass UniformResourceIdentifier(object):\n def __init__(self, value):\n if isinstance(value, six.text_type):\n try:\n value.encode(\"ascii\")\n except UnicodeEncodeError:\n value = self._idna_encode(value)\n warnings.warn(\n \"URI values should be passed as an A-label string. \"\n \"This means unicode characters should be encoded via \"\n \"idna. Support for passing unicode strings (aka U-label) \"\n \" will be removed in a future version.\",\n utils.PersistentlyDeprecated2017,\n stacklevel=2,\n )\n else:\n raise TypeError(\"value must be string\")\n\n self._value = value\n\n value = utils.read_only_property(\"_value\")\n\n @classmethod\n def _init_without_validation(cls, value):\n instance = cls.__new__(cls)\n instance._value = value\n return instance\n\n def _idna_encode(self, value):\n idna = _lazy_import_idna()\n parsed = urllib_parse.urlparse(value)\n if parsed.port:\n netloc = (\n idna.encode(parsed.hostname) +\n \":{}\".format(parsed.port).encode(\"ascii\")\n ).decode(\"ascii\")\n else:\n netloc = idna.encode(parsed.hostname).decode(\"ascii\")\n\n # Note that building a URL in this fashion means it should be\n # semantically indistinguishable from the original but is not\n # guaranteed to be exactly the same.\n return urllib_parse.urlunparse((\n parsed.scheme,\n netloc,\n parsed.path,\n parsed.params,\n parsed.query,\n parsed.fragment\n ))\n\n def __repr__(self):\n return \"\".format(self.value)\n\n def __eq__(self, other):\n if not isinstance(other, UniformResourceIdentifier):\n return NotImplemented\n\n return self.value == other.value\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash(self.value)\n\n\n@utils.register_interface(GeneralName)\nclass DirectoryName(object):\n def __init__(self, value):\n if not isinstance(value, Name):\n raise TypeError(\"value must be a Name\")\n\n self._value = value\n\n value = utils.read_only_property(\"_value\")\n\n def __repr__(self):\n return \"\".format(self.value)\n\n def __eq__(self, other):\n if not isinstance(other, DirectoryName):\n return NotImplemented\n\n return self.value == other.value\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash(self.value)\n\n\n@utils.register_interface(GeneralName)\nclass RegisteredID(object):\n def __init__(self, value):\n if not isinstance(value, ObjectIdentifier):\n raise TypeError(\"value must be an ObjectIdentifier\")\n\n self._value = value\n\n value = utils.read_only_property(\"_value\")\n\n def __repr__(self):\n return \"\".format(self.value)\n\n def __eq__(self, other):\n if not isinstance(other, RegisteredID):\n return NotImplemented\n\n return self.value == other.value\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash(self.value)\n\n\n@utils.register_interface(GeneralName)\nclass IPAddress(object):\n def __init__(self, value):\n if not isinstance(\n value,\n (\n ipaddress.IPv4Address,\n ipaddress.IPv6Address,\n ipaddress.IPv4Network,\n ipaddress.IPv6Network\n )\n ):\n raise TypeError(\n \"value must be an instance of ipaddress.IPv4Address, \"\n \"ipaddress.IPv6Address, ipaddress.IPv4Network, or \"\n \"ipaddress.IPv6Network\"\n )\n\n self._value = value\n\n value = utils.read_only_property(\"_value\")\n\n def __repr__(self):\n return \"\".format(self.value)\n\n def __eq__(self, other):\n if not isinstance(other, IPAddress):\n return NotImplemented\n\n return self.value == other.value\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash(self.value)\n\n\n@utils.register_interface(GeneralName)\nclass OtherName(object):\n def __init__(self, type_id, value):\n if not isinstance(type_id, ObjectIdentifier):\n raise TypeError(\"type_id must be an ObjectIdentifier\")\n if not isinstance(value, bytes):\n raise TypeError(\"value must be a binary string\")\n\n self._type_id = type_id\n self._value = value\n\n type_id = utils.read_only_property(\"_type_id\")\n value = utils.read_only_property(\"_value\")\n\n def __repr__(self):\n return \"\".format(\n self.type_id, self.value)\n\n def __eq__(self, other):\n if not isinstance(other, OtherName):\n return NotImplemented\n\n return self.type_id == other.type_id and self.value == other.value\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash((self.type_id, self.value))\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/x509/name.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nfrom enum import Enum\n\nimport six\n\nfrom cryptography import utils\nfrom cryptography.x509.oid import NameOID, ObjectIdentifier\n\n\nclass _ASN1Type(Enum):\n UTF8String = 12\n NumericString = 18\n PrintableString = 19\n T61String = 20\n IA5String = 22\n UTCTime = 23\n GeneralizedTime = 24\n VisibleString = 26\n UniversalString = 28\n BMPString = 30\n\n\n_ASN1_TYPE_TO_ENUM = dict((i.value, i) for i in _ASN1Type)\n_SENTINEL = object()\n_NAMEOID_DEFAULT_TYPE = {\n NameOID.COUNTRY_NAME: _ASN1Type.PrintableString,\n NameOID.JURISDICTION_COUNTRY_NAME: _ASN1Type.PrintableString,\n NameOID.SERIAL_NUMBER: _ASN1Type.PrintableString,\n NameOID.DN_QUALIFIER: _ASN1Type.PrintableString,\n NameOID.EMAIL_ADDRESS: _ASN1Type.IA5String,\n NameOID.DOMAIN_COMPONENT: _ASN1Type.IA5String,\n}\n\n#: Short attribute names from RFC 4514:\n#: https://tools.ietf.org/html/rfc4514#page-7\n_NAMEOID_TO_NAME = {\n NameOID.COMMON_NAME: 'CN',\n NameOID.LOCALITY_NAME: 'L',\n NameOID.STATE_OR_PROVINCE_NAME: 'ST',\n NameOID.ORGANIZATION_NAME: 'O',\n NameOID.ORGANIZATIONAL_UNIT_NAME: 'OU',\n NameOID.COUNTRY_NAME: 'C',\n NameOID.STREET_ADDRESS: 'STREET',\n NameOID.DOMAIN_COMPONENT: 'DC',\n NameOID.USER_ID: 'UID',\n}\n\n\ndef _escape_dn_value(val):\n \"\"\"Escape special characters in RFC4514 Distinguished Name value.\"\"\"\n\n # See https://tools.ietf.org/html/rfc4514#section-2.4\n val = val.replace('\\\\', '\\\\\\\\')\n val = val.replace('\"', '\\\\\"')\n val = val.replace('+', '\\\\+')\n val = val.replace(',', '\\\\,')\n val = val.replace(';', '\\\\;')\n val = val.replace('<', '\\\\<')\n val = val.replace('>', '\\\\>')\n val = val.replace('\\0', '\\\\00')\n\n if val[0] in ('#', ' '):\n val = '\\\\' + val\n if val[-1] == ' ':\n val = val[:-1] + '\\\\ '\n\n return val\n\n\nclass NameAttribute(object):\n def __init__(self, oid, value, _type=_SENTINEL):\n if not isinstance(oid, ObjectIdentifier):\n raise TypeError(\n \"oid argument must be an ObjectIdentifier instance.\"\n )\n\n if not isinstance(value, six.text_type):\n raise TypeError(\n \"value argument must be a text type.\"\n )\n\n if (\n oid == NameOID.COUNTRY_NAME or\n oid == NameOID.JURISDICTION_COUNTRY_NAME\n ):\n if len(value.encode(\"utf8\")) != 2:\n raise ValueError(\n \"Country name must be a 2 character country code\"\n )\n\n if len(value) == 0:\n raise ValueError(\"Value cannot be an empty string\")\n\n # The appropriate ASN1 string type varies by OID and is defined across\n # multiple RFCs including 2459, 3280, and 5280. In general UTF8String\n # is preferred (2459), but 3280 and 5280 specify several OIDs with\n # alternate types. This means when we see the sentinel value we need\n # to look up whether the OID has a non-UTF8 type. If it does, set it\n # to that. Otherwise, UTF8!\n if _type == _SENTINEL:\n _type = _NAMEOID_DEFAULT_TYPE.get(oid, _ASN1Type.UTF8String)\n\n if not isinstance(_type, _ASN1Type):\n raise TypeError(\"_type must be from the _ASN1Type enum\")\n\n self._oid = oid\n self._value = value\n self._type = _type\n\n oid = utils.read_only_property(\"_oid\")\n value = utils.read_only_property(\"_value\")\n\n def rfc4514_string(self):\n \"\"\"\n Format as RFC4514 Distinguished Name string.\n\n Use short attribute name if available, otherwise fall back to OID\n dotted string.\n \"\"\"\n key = _NAMEOID_TO_NAME.get(self.oid, self.oid.dotted_string)\n return '%s=%s' % (key, _escape_dn_value(self.value))\n\n def __eq__(self, other):\n if not isinstance(other, NameAttribute):\n return NotImplemented\n\n return (\n self.oid == other.oid and\n self.value == other.value\n )\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash((self.oid, self.value))\n\n def __repr__(self):\n return \"\".format(self)\n\n\nclass RelativeDistinguishedName(object):\n def __init__(self, attributes):\n attributes = list(attributes)\n if not attributes:\n raise ValueError(\"a relative distinguished name cannot be empty\")\n if not all(isinstance(x, NameAttribute) for x in attributes):\n raise TypeError(\"attributes must be an iterable of NameAttribute\")\n\n # Keep list and frozenset to preserve attribute order where it matters\n self._attributes = attributes\n self._attribute_set = frozenset(attributes)\n\n if len(self._attribute_set) != len(attributes):\n raise ValueError(\"duplicate attributes are not allowed\")\n\n def get_attributes_for_oid(self, oid):\n return [i for i in self if i.oid == oid]\n\n def rfc4514_string(self):\n \"\"\"\n Format as RFC4514 Distinguished Name string.\n\n Within each RDN, attributes are joined by '+', although that is rarely\n used in certificates.\n \"\"\"\n return '+'.join(attr.rfc4514_string() for attr in self._attributes)\n\n def __eq__(self, other):\n if not isinstance(other, RelativeDistinguishedName):\n return NotImplemented\n\n return self._attribute_set == other._attribute_set\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n return hash(self._attribute_set)\n\n def __iter__(self):\n return iter(self._attributes)\n\n def __len__(self):\n return len(self._attributes)\n\n def __repr__(self):\n return \"\".format(self.rfc4514_string())\n\n\nclass Name(object):\n def __init__(self, attributes):\n attributes = list(attributes)\n if all(isinstance(x, NameAttribute) for x in attributes):\n self._attributes = [\n RelativeDistinguishedName([x]) for x in attributes\n ]\n elif all(isinstance(x, RelativeDistinguishedName) for x in attributes):\n self._attributes = attributes\n else:\n raise TypeError(\n \"attributes must be a list of NameAttribute\"\n \" or a list RelativeDistinguishedName\"\n )\n\n def rfc4514_string(self):\n \"\"\"\n Format as RFC4514 Distinguished Name string.\n For example 'CN=foobar.com,O=Foo Corp,C=US'\n\n An X.509 name is a two-level structure: a list of sets of attributes.\n Each list element is separated by ',' and within each list element, set\n elements are separated by '+'. The latter is almost never used in\n real world certificates.\n \"\"\"\n return ','.join(attr.rfc4514_string() for attr in self._attributes)\n\n def get_attributes_for_oid(self, oid):\n return [i for i in self if i.oid == oid]\n\n @property\n def rdns(self):\n return self._attributes\n\n def public_bytes(self, backend):\n return backend.x509_name_bytes(self)\n\n def __eq__(self, other):\n if not isinstance(other, Name):\n return NotImplemented\n\n return self._attributes == other._attributes\n\n def __ne__(self, other):\n return not self == other\n\n def __hash__(self):\n # TODO: this is relatively expensive, if this looks like a bottleneck\n # for you, consider optimizing!\n return hash(tuple(self._attributes))\n\n def __iter__(self):\n for rdn in self._attributes:\n for ava in rdn:\n yield ava\n\n def __len__(self):\n return sum(len(rdn) for rdn in self._attributes)\n\n def __repr__(self):\n if six.PY2:\n return \"\".format(self.rfc4514_string().encode('utf8'))\n else:\n return \"\".format(self.rfc4514_string())\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/x509/ocsp.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport abc\nimport datetime\nfrom enum import Enum\n\nimport six\n\nfrom cryptography import x509\nfrom cryptography.hazmat.primitives import hashes\nfrom cryptography.hazmat.primitives.asymmetric import ed25519, ed448\nfrom cryptography.x509.base import (\n _EARLIEST_UTC_TIME, _convert_to_naive_utc_time, _reject_duplicate_extension\n)\n\n\n_OIDS_TO_HASH = {\n \"1.3.14.3.2.26\": hashes.SHA1(),\n \"2.16.840.1.101.3.4.2.4\": hashes.SHA224(),\n \"2.16.840.1.101.3.4.2.1\": hashes.SHA256(),\n \"2.16.840.1.101.3.4.2.2\": hashes.SHA384(),\n \"2.16.840.1.101.3.4.2.3\": hashes.SHA512(),\n}\n\n\nclass OCSPResponderEncoding(Enum):\n HASH = \"By Hash\"\n NAME = \"By Name\"\n\n\nclass OCSPResponseStatus(Enum):\n SUCCESSFUL = 0\n MALFORMED_REQUEST = 1\n INTERNAL_ERROR = 2\n TRY_LATER = 3\n SIG_REQUIRED = 5\n UNAUTHORIZED = 6\n\n\n_RESPONSE_STATUS_TO_ENUM = dict((x.value, x) for x in OCSPResponseStatus)\n_ALLOWED_HASHES = (\n hashes.SHA1, hashes.SHA224, hashes.SHA256,\n hashes.SHA384, hashes.SHA512\n)\n\n\ndef _verify_algorithm(algorithm):\n if not isinstance(algorithm, _ALLOWED_HASHES):\n raise ValueError(\n \"Algorithm must be SHA1, SHA224, SHA256, SHA384, or SHA512\"\n )\n\n\nclass OCSPCertStatus(Enum):\n GOOD = 0\n REVOKED = 1\n UNKNOWN = 2\n\n\n_CERT_STATUS_TO_ENUM = dict((x.value, x) for x in OCSPCertStatus)\n\n\ndef load_der_ocsp_request(data):\n from cryptography.hazmat.backends.openssl.backend import backend\n return backend.load_der_ocsp_request(data)\n\n\ndef load_der_ocsp_response(data):\n from cryptography.hazmat.backends.openssl.backend import backend\n return backend.load_der_ocsp_response(data)\n\n\nclass OCSPRequestBuilder(object):\n def __init__(self, request=None, extensions=[]):\n self._request = request\n self._extensions = extensions\n\n def add_certificate(self, cert, issuer, algorithm):\n if self._request is not None:\n raise ValueError(\"Only one certificate can be added to a request\")\n\n _verify_algorithm(algorithm)\n if (\n not isinstance(cert, x509.Certificate) or\n not isinstance(issuer, x509.Certificate)\n ):\n raise TypeError(\"cert and issuer must be a Certificate\")\n\n return OCSPRequestBuilder((cert, issuer, algorithm), self._extensions)\n\n def add_extension(self, extension, critical):\n if not isinstance(extension, x509.ExtensionType):\n raise TypeError(\"extension must be an ExtensionType\")\n\n extension = x509.Extension(extension.oid, critical, extension)\n _reject_duplicate_extension(extension, self._extensions)\n\n return OCSPRequestBuilder(\n self._request, self._extensions + [extension]\n )\n\n def build(self):\n from cryptography.hazmat.backends.openssl.backend import backend\n if self._request is None:\n raise ValueError(\"You must add a certificate before building\")\n\n return backend.create_ocsp_request(self)\n\n\nclass _SingleResponse(object):\n def __init__(self, cert, issuer, algorithm, cert_status, this_update,\n next_update, revocation_time, revocation_reason):\n if (\n not isinstance(cert, x509.Certificate) or\n not isinstance(issuer, x509.Certificate)\n ):\n raise TypeError(\"cert and issuer must be a Certificate\")\n\n _verify_algorithm(algorithm)\n if not isinstance(this_update, datetime.datetime):\n raise TypeError(\"this_update must be a datetime object\")\n if (\n next_update is not None and\n not isinstance(next_update, datetime.datetime)\n ):\n raise TypeError(\"next_update must be a datetime object or None\")\n\n self._cert = cert\n self._issuer = issuer\n self._algorithm = algorithm\n self._this_update = this_update\n self._next_update = next_update\n\n if not isinstance(cert_status, OCSPCertStatus):\n raise TypeError(\n \"cert_status must be an item from the OCSPCertStatus enum\"\n )\n if cert_status is not OCSPCertStatus.REVOKED:\n if revocation_time is not None:\n raise ValueError(\n \"revocation_time can only be provided if the certificate \"\n \"is revoked\"\n )\n if revocation_reason is not None:\n raise ValueError(\n \"revocation_reason can only be provided if the certificate\"\n \" is revoked\"\n )\n else:\n if not isinstance(revocation_time, datetime.datetime):\n raise TypeError(\"revocation_time must be a datetime object\")\n\n revocation_time = _convert_to_naive_utc_time(revocation_time)\n if revocation_time < _EARLIEST_UTC_TIME:\n raise ValueError('The revocation_time must be on or after'\n ' 1950 January 1.')\n\n if (\n revocation_reason is not None and\n not isinstance(revocation_reason, x509.ReasonFlags)\n ):\n raise TypeError(\n \"revocation_reason must be an item from the ReasonFlags \"\n \"enum or None\"\n )\n\n self._cert_status = cert_status\n self._revocation_time = revocation_time\n self._revocation_reason = revocation_reason\n\n\nclass OCSPResponseBuilder(object):\n def __init__(self, response=None, responder_id=None, certs=None,\n extensions=[]):\n self._response = response\n self._responder_id = responder_id\n self._certs = certs\n self._extensions = extensions\n\n def add_response(self, cert, issuer, algorithm, cert_status, this_update,\n next_update, revocation_time, revocation_reason):\n if self._response is not None:\n raise ValueError(\"Only one response per OCSPResponse.\")\n\n singleresp = _SingleResponse(\n cert, issuer, algorithm, cert_status, this_update, next_update,\n revocation_time, revocation_reason\n )\n return OCSPResponseBuilder(\n singleresp, self._responder_id,\n self._certs, self._extensions,\n )\n\n def responder_id(self, encoding, responder_cert):\n if self._responder_id is not None:\n raise ValueError(\"responder_id can only be set once\")\n if not isinstance(responder_cert, x509.Certificate):\n raise TypeError(\"responder_cert must be a Certificate\")\n if not isinstance(encoding, OCSPResponderEncoding):\n raise TypeError(\n \"encoding must be an element from OCSPResponderEncoding\"\n )\n\n return OCSPResponseBuilder(\n self._response, (responder_cert, encoding),\n self._certs, self._extensions,\n )\n\n def certificates(self, certs):\n if self._certs is not None:\n raise ValueError(\"certificates may only be set once\")\n certs = list(certs)\n if len(certs) == 0:\n raise ValueError(\"certs must not be an empty list\")\n if not all(isinstance(x, x509.Certificate) for x in certs):\n raise TypeError(\"certs must be a list of Certificates\")\n return OCSPResponseBuilder(\n self._response, self._responder_id,\n certs, self._extensions,\n )\n\n def add_extension(self, extension, critical):\n if not isinstance(extension, x509.ExtensionType):\n raise TypeError(\"extension must be an ExtensionType\")\n\n extension = x509.Extension(extension.oid, critical, extension)\n _reject_duplicate_extension(extension, self._extensions)\n\n return OCSPResponseBuilder(\n self._response, self._responder_id,\n self._certs, self._extensions + [extension],\n )\n\n def sign(self, private_key, algorithm):\n from cryptography.hazmat.backends.openssl.backend import backend\n if self._response is None:\n raise ValueError(\"You must add a response before signing\")\n if self._responder_id is None:\n raise ValueError(\"You must add a responder_id before signing\")\n\n if isinstance(private_key,\n (ed25519.Ed25519PrivateKey, ed448.Ed448PrivateKey)):\n if algorithm is not None:\n raise ValueError(\n \"algorithm must be None when signing via ed25519 or ed448\"\n )\n elif not isinstance(algorithm, hashes.HashAlgorithm):\n raise TypeError(\"Algorithm must be a registered hash algorithm.\")\n\n return backend.create_ocsp_response(\n OCSPResponseStatus.SUCCESSFUL, self, private_key, algorithm\n )\n\n @classmethod\n def build_unsuccessful(cls, response_status):\n from cryptography.hazmat.backends.openssl.backend import backend\n if not isinstance(response_status, OCSPResponseStatus):\n raise TypeError(\n \"response_status must be an item from OCSPResponseStatus\"\n )\n if response_status is OCSPResponseStatus.SUCCESSFUL:\n raise ValueError(\"response_status cannot be SUCCESSFUL\")\n\n return backend.create_ocsp_response(response_status, None, None, None)\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass OCSPRequest(object):\n @abc.abstractproperty\n def issuer_key_hash(self):\n \"\"\"\n The hash of the issuer public key\n \"\"\"\n\n @abc.abstractproperty\n def issuer_name_hash(self):\n \"\"\"\n The hash of the issuer name\n \"\"\"\n\n @abc.abstractproperty\n def hash_algorithm(self):\n \"\"\"\n The hash algorithm used in the issuer name and key hashes\n \"\"\"\n\n @abc.abstractproperty\n def serial_number(self):\n \"\"\"\n The serial number of the cert whose status is being checked\n \"\"\"\n @abc.abstractmethod\n def public_bytes(self, encoding):\n \"\"\"\n Serializes the request to DER\n \"\"\"\n\n @abc.abstractproperty\n def extensions(self):\n \"\"\"\n The list of request extensions. Not single request extensions.\n \"\"\"\n\n\n@six.add_metaclass(abc.ABCMeta)\nclass OCSPResponse(object):\n @abc.abstractproperty\n def response_status(self):\n \"\"\"\n The status of the response. This is a value from the OCSPResponseStatus\n enumeration\n \"\"\"\n\n @abc.abstractproperty\n def signature_algorithm_oid(self):\n \"\"\"\n The ObjectIdentifier of the signature algorithm\n \"\"\"\n\n @abc.abstractproperty\n def signature_hash_algorithm(self):\n \"\"\"\n Returns a HashAlgorithm corresponding to the type of the digest signed\n \"\"\"\n\n @abc.abstractproperty\n def signature(self):\n \"\"\"\n The signature bytes\n \"\"\"\n\n @abc.abstractproperty\n def tbs_response_bytes(self):\n \"\"\"\n The tbsResponseData bytes\n \"\"\"\n\n @abc.abstractproperty\n def certificates(self):\n \"\"\"\n A list of certificates used to help build a chain to verify the OCSP\n response. This situation occurs when the OCSP responder uses a delegate\n certificate.\n \"\"\"\n\n @abc.abstractproperty\n def responder_key_hash(self):\n \"\"\"\n The responder's key hash or None\n \"\"\"\n\n @abc.abstractproperty\n def responder_name(self):\n \"\"\"\n The responder's Name or None\n \"\"\"\n\n @abc.abstractproperty\n def produced_at(self):\n \"\"\"\n The time the response was produced\n \"\"\"\n\n @abc.abstractproperty\n def certificate_status(self):\n \"\"\"\n The status of the certificate (an element from the OCSPCertStatus enum)\n \"\"\"\n\n @abc.abstractproperty\n def revocation_time(self):\n \"\"\"\n The date of when the certificate was revoked or None if not\n revoked.\n \"\"\"\n\n @abc.abstractproperty\n def revocation_reason(self):\n \"\"\"\n The reason the certificate was revoked or None if not specified or\n not revoked.\n \"\"\"\n\n @abc.abstractproperty\n def this_update(self):\n \"\"\"\n The most recent time at which the status being indicated is known by\n the responder to have been correct\n \"\"\"\n\n @abc.abstractproperty\n def next_update(self):\n \"\"\"\n The time when newer information will be available\n \"\"\"\n\n @abc.abstractproperty\n def issuer_key_hash(self):\n \"\"\"\n The hash of the issuer public key\n \"\"\"\n\n @abc.abstractproperty\n def issuer_name_hash(self):\n \"\"\"\n The hash of the issuer name\n \"\"\"\n\n @abc.abstractproperty\n def hash_algorithm(self):\n \"\"\"\n The hash algorithm used in the issuer name and key hashes\n \"\"\"\n\n @abc.abstractproperty\n def serial_number(self):\n \"\"\"\n The serial number of the cert whose status is being checked\n \"\"\"\n\n @abc.abstractproperty\n def extensions(self):\n \"\"\"\n The list of response extensions. Not single response extensions.\n \"\"\"\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography/x509/oid.py",
"content": "# This file is dual licensed under the terms of the Apache License, Version\n# 2.0, and the BSD License. See the LICENSE file in the root of this repository\n# for complete details.\n\nfrom __future__ import absolute_import, division, print_function\n\nfrom cryptography.hazmat._oid import ObjectIdentifier\nfrom cryptography.hazmat.primitives import hashes\n\n\nclass ExtensionOID(object):\n SUBJECT_DIRECTORY_ATTRIBUTES = ObjectIdentifier(\"2.5.29.9\")\n SUBJECT_KEY_IDENTIFIER = ObjectIdentifier(\"2.5.29.14\")\n KEY_USAGE = ObjectIdentifier(\"2.5.29.15\")\n SUBJECT_ALTERNATIVE_NAME = ObjectIdentifier(\"2.5.29.17\")\n ISSUER_ALTERNATIVE_NAME = ObjectIdentifier(\"2.5.29.18\")\n BASIC_CONSTRAINTS = ObjectIdentifier(\"2.5.29.19\")\n NAME_CONSTRAINTS = ObjectIdentifier(\"2.5.29.30\")\n CRL_DISTRIBUTION_POINTS = ObjectIdentifier(\"2.5.29.31\")\n CERTIFICATE_POLICIES = ObjectIdentifier(\"2.5.29.32\")\n POLICY_MAPPINGS = ObjectIdentifier(\"2.5.29.33\")\n AUTHORITY_KEY_IDENTIFIER = ObjectIdentifier(\"2.5.29.35\")\n POLICY_CONSTRAINTS = ObjectIdentifier(\"2.5.29.36\")\n EXTENDED_KEY_USAGE = ObjectIdentifier(\"2.5.29.37\")\n FRESHEST_CRL = ObjectIdentifier(\"2.5.29.46\")\n INHIBIT_ANY_POLICY = ObjectIdentifier(\"2.5.29.54\")\n ISSUING_DISTRIBUTION_POINT = ObjectIdentifier(\"2.5.29.28\")\n AUTHORITY_INFORMATION_ACCESS = ObjectIdentifier(\"1.3.6.1.5.5.7.1.1\")\n SUBJECT_INFORMATION_ACCESS = ObjectIdentifier(\"1.3.6.1.5.5.7.1.11\")\n OCSP_NO_CHECK = ObjectIdentifier(\"1.3.6.1.5.5.7.48.1.5\")\n TLS_FEATURE = ObjectIdentifier(\"1.3.6.1.5.5.7.1.24\")\n CRL_NUMBER = ObjectIdentifier(\"2.5.29.20\")\n DELTA_CRL_INDICATOR = ObjectIdentifier(\"2.5.29.27\")\n PRECERT_SIGNED_CERTIFICATE_TIMESTAMPS = (\n ObjectIdentifier(\"1.3.6.1.4.1.11129.2.4.2\")\n )\n PRECERT_POISON = (\n ObjectIdentifier(\"1.3.6.1.4.1.11129.2.4.3\")\n )\n\n\nclass OCSPExtensionOID(object):\n NONCE = ObjectIdentifier(\"1.3.6.1.5.5.7.48.1.2\")\n\n\nclass CRLEntryExtensionOID(object):\n CERTIFICATE_ISSUER = ObjectIdentifier(\"2.5.29.29\")\n CRL_REASON = ObjectIdentifier(\"2.5.29.21\")\n INVALIDITY_DATE = ObjectIdentifier(\"2.5.29.24\")\n\n\nclass NameOID(object):\n COMMON_NAME = ObjectIdentifier(\"2.5.4.3\")\n COUNTRY_NAME = ObjectIdentifier(\"2.5.4.6\")\n LOCALITY_NAME = ObjectIdentifier(\"2.5.4.7\")\n STATE_OR_PROVINCE_NAME = ObjectIdentifier(\"2.5.4.8\")\n STREET_ADDRESS = ObjectIdentifier(\"2.5.4.9\")\n ORGANIZATION_NAME = ObjectIdentifier(\"2.5.4.10\")\n ORGANIZATIONAL_UNIT_NAME = ObjectIdentifier(\"2.5.4.11\")\n SERIAL_NUMBER = ObjectIdentifier(\"2.5.4.5\")\n SURNAME = ObjectIdentifier(\"2.5.4.4\")\n GIVEN_NAME = ObjectIdentifier(\"2.5.4.42\")\n TITLE = ObjectIdentifier(\"2.5.4.12\")\n GENERATION_QUALIFIER = ObjectIdentifier(\"2.5.4.44\")\n X500_UNIQUE_IDENTIFIER = ObjectIdentifier(\"2.5.4.45\")\n DN_QUALIFIER = ObjectIdentifier(\"2.5.4.46\")\n PSEUDONYM = ObjectIdentifier(\"2.5.4.65\")\n USER_ID = ObjectIdentifier(\"0.9.2342.19200300.100.1.1\")\n DOMAIN_COMPONENT = ObjectIdentifier(\"0.9.2342.19200300.100.1.25\")\n EMAIL_ADDRESS = ObjectIdentifier(\"1.2.840.113549.1.9.1\")\n JURISDICTION_COUNTRY_NAME = ObjectIdentifier(\"1.3.6.1.4.1.311.60.2.1.3\")\n JURISDICTION_LOCALITY_NAME = ObjectIdentifier(\"1.3.6.1.4.1.311.60.2.1.1\")\n JURISDICTION_STATE_OR_PROVINCE_NAME = ObjectIdentifier(\n \"1.3.6.1.4.1.311.60.2.1.2\"\n )\n BUSINESS_CATEGORY = ObjectIdentifier(\"2.5.4.15\")\n POSTAL_ADDRESS = ObjectIdentifier(\"2.5.4.16\")\n POSTAL_CODE = ObjectIdentifier(\"2.5.4.17\")\n\n\nclass SignatureAlgorithmOID(object):\n RSA_WITH_MD5 = ObjectIdentifier(\"1.2.840.113549.1.1.4\")\n RSA_WITH_SHA1 = ObjectIdentifier(\"1.2.840.113549.1.1.5\")\n # This is an alternate OID for RSA with SHA1 that is occasionally seen\n _RSA_WITH_SHA1 = ObjectIdentifier(\"1.3.14.3.2.29\")\n RSA_WITH_SHA224 = ObjectIdentifier(\"1.2.840.113549.1.1.14\")\n RSA_WITH_SHA256 = ObjectIdentifier(\"1.2.840.113549.1.1.11\")\n RSA_WITH_SHA384 = ObjectIdentifier(\"1.2.840.113549.1.1.12\")\n RSA_WITH_SHA512 = ObjectIdentifier(\"1.2.840.113549.1.1.13\")\n RSASSA_PSS = ObjectIdentifier(\"1.2.840.113549.1.1.10\")\n ECDSA_WITH_SHA1 = ObjectIdentifier(\"1.2.840.10045.4.1\")\n ECDSA_WITH_SHA224 = ObjectIdentifier(\"1.2.840.10045.4.3.1\")\n ECDSA_WITH_SHA256 = ObjectIdentifier(\"1.2.840.10045.4.3.2\")\n ECDSA_WITH_SHA384 = ObjectIdentifier(\"1.2.840.10045.4.3.3\")\n ECDSA_WITH_SHA512 = ObjectIdentifier(\"1.2.840.10045.4.3.4\")\n DSA_WITH_SHA1 = ObjectIdentifier(\"1.2.840.10040.4.3\")\n DSA_WITH_SHA224 = ObjectIdentifier(\"2.16.840.1.101.3.4.3.1\")\n DSA_WITH_SHA256 = ObjectIdentifier(\"2.16.840.1.101.3.4.3.2\")\n ED25519 = ObjectIdentifier(\"1.3.101.112\")\n ED448 = ObjectIdentifier(\"1.3.101.113\")\n\n\n_SIG_OIDS_TO_HASH = {\n SignatureAlgorithmOID.RSA_WITH_MD5: hashes.MD5(),\n SignatureAlgorithmOID.RSA_WITH_SHA1: hashes.SHA1(),\n SignatureAlgorithmOID._RSA_WITH_SHA1: hashes.SHA1(),\n SignatureAlgorithmOID.RSA_WITH_SHA224: hashes.SHA224(),\n SignatureAlgorithmOID.RSA_WITH_SHA256: hashes.SHA256(),\n SignatureAlgorithmOID.RSA_WITH_SHA384: hashes.SHA384(),\n SignatureAlgorithmOID.RSA_WITH_SHA512: hashes.SHA512(),\n SignatureAlgorithmOID.ECDSA_WITH_SHA1: hashes.SHA1(),\n SignatureAlgorithmOID.ECDSA_WITH_SHA224: hashes.SHA224(),\n SignatureAlgorithmOID.ECDSA_WITH_SHA256: hashes.SHA256(),\n SignatureAlgorithmOID.ECDSA_WITH_SHA384: hashes.SHA384(),\n SignatureAlgorithmOID.ECDSA_WITH_SHA512: hashes.SHA512(),\n SignatureAlgorithmOID.DSA_WITH_SHA1: hashes.SHA1(),\n SignatureAlgorithmOID.DSA_WITH_SHA224: hashes.SHA224(),\n SignatureAlgorithmOID.DSA_WITH_SHA256: hashes.SHA256(),\n SignatureAlgorithmOID.ED25519: None,\n SignatureAlgorithmOID.ED448: None,\n}\n\n\nclass ExtendedKeyUsageOID(object):\n SERVER_AUTH = ObjectIdentifier(\"1.3.6.1.5.5.7.3.1\")\n CLIENT_AUTH = ObjectIdentifier(\"1.3.6.1.5.5.7.3.2\")\n CODE_SIGNING = ObjectIdentifier(\"1.3.6.1.5.5.7.3.3\")\n EMAIL_PROTECTION = ObjectIdentifier(\"1.3.6.1.5.5.7.3.4\")\n TIME_STAMPING = ObjectIdentifier(\"1.3.6.1.5.5.7.3.8\")\n OCSP_SIGNING = ObjectIdentifier(\"1.3.6.1.5.5.7.3.9\")\n ANY_EXTENDED_KEY_USAGE = ObjectIdentifier(\"2.5.29.37.0\")\n\n\nclass AuthorityInformationAccessOID(object):\n CA_ISSUERS = ObjectIdentifier(\"1.3.6.1.5.5.7.48.2\")\n OCSP = ObjectIdentifier(\"1.3.6.1.5.5.7.48.1\")\n\n\nclass CertificatePoliciesOID(object):\n CPS_QUALIFIER = ObjectIdentifier(\"1.3.6.1.5.5.7.2.1\")\n CPS_USER_NOTICE = ObjectIdentifier(\"1.3.6.1.5.5.7.2.2\")\n ANY_POLICY = ObjectIdentifier(\"2.5.29.32.0\")\n\n\n_OID_NAMES = {\n NameOID.COMMON_NAME: \"commonName\",\n NameOID.COUNTRY_NAME: \"countryName\",\n NameOID.LOCALITY_NAME: \"localityName\",\n NameOID.STATE_OR_PROVINCE_NAME: \"stateOrProvinceName\",\n NameOID.STREET_ADDRESS: \"streetAddress\",\n NameOID.ORGANIZATION_NAME: \"organizationName\",\n NameOID.ORGANIZATIONAL_UNIT_NAME: \"organizationalUnitName\",\n NameOID.SERIAL_NUMBER: \"serialNumber\",\n NameOID.SURNAME: \"surname\",\n NameOID.GIVEN_NAME: \"givenName\",\n NameOID.TITLE: \"title\",\n NameOID.GENERATION_QUALIFIER: \"generationQualifier\",\n NameOID.X500_UNIQUE_IDENTIFIER: \"x500UniqueIdentifier\",\n NameOID.DN_QUALIFIER: \"dnQualifier\",\n NameOID.PSEUDONYM: \"pseudonym\",\n NameOID.USER_ID: \"userID\",\n NameOID.DOMAIN_COMPONENT: \"domainComponent\",\n NameOID.EMAIL_ADDRESS: \"emailAddress\",\n NameOID.JURISDICTION_COUNTRY_NAME: \"jurisdictionCountryName\",\n NameOID.JURISDICTION_LOCALITY_NAME: \"jurisdictionLocalityName\",\n NameOID.JURISDICTION_STATE_OR_PROVINCE_NAME: (\n \"jurisdictionStateOrProvinceName\"\n ),\n NameOID.BUSINESS_CATEGORY: \"businessCategory\",\n NameOID.POSTAL_ADDRESS: \"postalAddress\",\n NameOID.POSTAL_CODE: \"postalCode\",\n\n SignatureAlgorithmOID.RSA_WITH_MD5: \"md5WithRSAEncryption\",\n SignatureAlgorithmOID.RSA_WITH_SHA1: \"sha1WithRSAEncryption\",\n SignatureAlgorithmOID.RSA_WITH_SHA224: \"sha224WithRSAEncryption\",\n SignatureAlgorithmOID.RSA_WITH_SHA256: \"sha256WithRSAEncryption\",\n SignatureAlgorithmOID.RSA_WITH_SHA384: \"sha384WithRSAEncryption\",\n SignatureAlgorithmOID.RSA_WITH_SHA512: \"sha512WithRSAEncryption\",\n SignatureAlgorithmOID.RSASSA_PSS: \"RSASSA-PSS\",\n SignatureAlgorithmOID.ECDSA_WITH_SHA1: \"ecdsa-with-SHA1\",\n SignatureAlgorithmOID.ECDSA_WITH_SHA224: \"ecdsa-with-SHA224\",\n SignatureAlgorithmOID.ECDSA_WITH_SHA256: \"ecdsa-with-SHA256\",\n SignatureAlgorithmOID.ECDSA_WITH_SHA384: \"ecdsa-with-SHA384\",\n SignatureAlgorithmOID.ECDSA_WITH_SHA512: \"ecdsa-with-SHA512\",\n SignatureAlgorithmOID.DSA_WITH_SHA1: \"dsa-with-sha1\",\n SignatureAlgorithmOID.DSA_WITH_SHA224: \"dsa-with-sha224\",\n SignatureAlgorithmOID.DSA_WITH_SHA256: \"dsa-with-sha256\",\n SignatureAlgorithmOID.ED25519: \"ed25519\",\n SignatureAlgorithmOID.ED448: \"ed448\",\n ExtendedKeyUsageOID.SERVER_AUTH: \"serverAuth\",\n ExtendedKeyUsageOID.CLIENT_AUTH: \"clientAuth\",\n ExtendedKeyUsageOID.CODE_SIGNING: \"codeSigning\",\n ExtendedKeyUsageOID.EMAIL_PROTECTION: \"emailProtection\",\n ExtendedKeyUsageOID.TIME_STAMPING: \"timeStamping\",\n ExtendedKeyUsageOID.OCSP_SIGNING: \"OCSPSigning\",\n ExtensionOID.SUBJECT_DIRECTORY_ATTRIBUTES: \"subjectDirectoryAttributes\",\n ExtensionOID.SUBJECT_KEY_IDENTIFIER: \"subjectKeyIdentifier\",\n ExtensionOID.KEY_USAGE: \"keyUsage\",\n ExtensionOID.SUBJECT_ALTERNATIVE_NAME: \"subjectAltName\",\n ExtensionOID.ISSUER_ALTERNATIVE_NAME: \"issuerAltName\",\n ExtensionOID.BASIC_CONSTRAINTS: \"basicConstraints\",\n ExtensionOID.PRECERT_SIGNED_CERTIFICATE_TIMESTAMPS: (\n \"signedCertificateTimestampList\"\n ),\n ExtensionOID.PRECERT_POISON: \"ctPoison\",\n CRLEntryExtensionOID.CRL_REASON: \"cRLReason\",\n CRLEntryExtensionOID.INVALIDITY_DATE: \"invalidityDate\",\n CRLEntryExtensionOID.CERTIFICATE_ISSUER: \"certificateIssuer\",\n ExtensionOID.NAME_CONSTRAINTS: \"nameConstraints\",\n ExtensionOID.CRL_DISTRIBUTION_POINTS: \"cRLDistributionPoints\",\n ExtensionOID.CERTIFICATE_POLICIES: \"certificatePolicies\",\n ExtensionOID.POLICY_MAPPINGS: \"policyMappings\",\n ExtensionOID.AUTHORITY_KEY_IDENTIFIER: \"authorityKeyIdentifier\",\n ExtensionOID.POLICY_CONSTRAINTS: \"policyConstraints\",\n ExtensionOID.EXTENDED_KEY_USAGE: \"extendedKeyUsage\",\n ExtensionOID.FRESHEST_CRL: \"freshestCRL\",\n ExtensionOID.INHIBIT_ANY_POLICY: \"inhibitAnyPolicy\",\n ExtensionOID.ISSUING_DISTRIBUTION_POINT: (\n \"issuingDistributionPoint\"\n ),\n ExtensionOID.AUTHORITY_INFORMATION_ACCESS: \"authorityInfoAccess\",\n ExtensionOID.SUBJECT_INFORMATION_ACCESS: \"subjectInfoAccess\",\n ExtensionOID.OCSP_NO_CHECK: \"OCSPNoCheck\",\n ExtensionOID.CRL_NUMBER: \"cRLNumber\",\n ExtensionOID.DELTA_CRL_INDICATOR: \"deltaCRLIndicator\",\n ExtensionOID.TLS_FEATURE: \"TLSFeature\",\n AuthorityInformationAccessOID.OCSP: \"OCSP\",\n AuthorityInformationAccessOID.CA_ISSUERS: \"caIssuers\",\n CertificatePoliciesOID.CPS_QUALIFIER: \"id-qt-cps\",\n CertificatePoliciesOID.CPS_USER_NOTICE: \"id-qt-unotice\",\n OCSPExtensionOID.NONCE: \"OCSPNonce\",\n}\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography-2.8.dist-info/AUTHORS.rst",
"content": "AUTHORS\n=======\n\nPGP key fingerprints are enclosed in parentheses.\n\n* Alex Gaynor (E27D 4AA0 1651 72CB C5D2 AF2B 125F 5C67 DFE9 4084)\n* Hynek Schlawack (C2A0 4F86 ACE2 8ADC F817 DBB7 AE25 3622 7F69 F181)\n* Donald Stufft \n* Laurens Van Houtven <_@lvh.io> (D9DC 4315 772F 8E91 DD22 B153 DFD1 3DF7 A8DD 569B)\n* Christian Heimes \n* Paul Kehrer (05FD 9FA1 6CF7 5735 0D91 A560 235A E5F1 29F9 ED98)\n* Jarret Raim \n* Alex Stapleton (A1C7 E50B 66DE 39ED C847 9665 8E3C 20D1 9BD9 5C4C)\n* David Reid (0F83 CC87 B32F 482B C726 B58A 9FBF D8F4 DA89 6D74)\n* Matthew Lefkowitz (06AB F638 E878 CD29 1264 18AB 7EC2 8125 0FBC 4A07)\n* Konstantinos Koukopoulos (D6BD 52B6 8C99 A91C E2C8 934D 3300 566B 3A46 726E)\n* Stephen Holsapple \n* Terry Chia \n* Matthew Iversen (2F04 3DCC D6E6 D5AC D262 2E0B C046 E8A8 7452 2973)\n* Mohammed Attia \n* Michael Hart \n* Mark Adams (A18A 7DD3 283C CF2A B0CE FE0E C7A0 5E3F C972 098C)\n* Gregory Haynes (6FB6 44BF 9FD0 EBA2 1CE9 471F B08F 42F9 0DC6 599F)\n* Chelsea Winfree \n* Steven Buss (1FB9 2EC1 CF93 DFD6 B47F F583 B1A5 6C22 290D A4C3)\n* Andre Caron \n* Jiangge Zhang (BBEC 782B 015F 71B1 5FF7 EACA 1A8C AA98 255F 5000)\n* Major Hayden (1BF9 9264 9596 0033 698C 252B 7370 51E0 C101 1FB1)\n* Phoebe Queen (10D4 7741 AB65 50F4 B264 3888 DA40 201A 072B C1FA)\n* Google Inc.\n* Amaury Forgeot d'Arc \n* Dirkjan Ochtman (25BB BAC1 13C1 BFD5 AA59 4A4C 9F96 B929 3038 0381)\n* Maximilian Hils \n* Simo Sorce \n* Thomas Sileo \n* Fraser Tweedale \n* Ofek Lev (FFB6 B92B 30B1 7848 546E 9912 972F E913 DAD5 A46E)\n* Erik Daguerre \n* Aviv Palivoda \n* Chris Wolfe \n* Jeremy Lainé \n* Denis Gladkikh \n* John Pacific (2CF6 0381 B5EF 29B7 D48C 2020 7BB9 71A0 E891 44D9)\n* Marti Raudsepp \n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography-2.8.dist-info/INSTALLER",
"content": "pip\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography-2.8.dist-info/LICENSE",
"content": "This software is made available under the terms of *either* of the licenses\nfound in LICENSE.APACHE or LICENSE.BSD. Contributions to cryptography are made\nunder the terms of *both* these licenses.\n\nThe code used in the OpenSSL locking callback and OS random engine is derived\nfrom CPython, and is licensed under the terms of the PSF License Agreement.\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography-2.8.dist-info/LICENSE.APACHE",
"content": "\n Apache License\n Version 2.0, January 2004\n https://www.apache.org/licenses/\n\n TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION\n\n 1. Definitions.\n\n \"License\" shall mean the terms and conditions for use, reproduction,\n and distribution as defined by Sections 1 through 9 of this document.\n\n \"Licensor\" shall mean the copyright owner or entity authorized by\n the copyright owner that is granting the License.\n\n \"Legal Entity\" shall mean the union of the acting entity and all\n other entities that control, are controlled by, or are under common\n control with that entity. For the purposes of this definition,\n \"control\" means (i) the power, direct or indirect, to cause the\n direction or management of such entity, whether by contract or\n otherwise, or (ii) ownership of fifty percent (50%) or more of the\n outstanding shares, or (iii) beneficial ownership of such entity.\n\n \"You\" (or \"Your\") shall mean an individual or Legal Entity\n exercising permissions granted by this License.\n\n \"Source\" form shall mean the preferred form for making modifications,\n including but not limited to software source code, documentation\n source, and configuration files.\n\n \"Object\" form shall mean any form resulting from mechanical\n transformation or translation of a Source form, including but\n not limited to compiled object code, generated documentation,\n and conversions to other media types.\n\n \"Work\" shall mean the work of authorship, whether in Source or\n Object form, made available under the License, as indicated by a\n copyright notice that is included in or attached to the work\n (an example is provided in the Appendix below).\n\n \"Derivative Works\" shall mean any work, whether in Source or Object\n form, that is based on (or derived from) the Work and for which the\n editorial revisions, annotations, elaborations, or other modifications\n represent, as a whole, an original work of authorship. For the purposes\n of this License, Derivative Works shall not include works that remain\n separable from, or merely link (or bind by name) to the interfaces of,\n the Work and Derivative Works thereof.\n\n \"Contribution\" shall mean any work of authorship, including\n the original version of the Work and any modifications or additions\n to that Work or Derivative Works thereof, that is intentionally\n submitted to Licensor for inclusion in the Work by the copyright owner\n or by an individual or Legal Entity authorized to submit on behalf of\n the copyright owner. For the purposes of this definition, \"submitted\"\n means any form of electronic, verbal, or written communication sent\n to the Licensor or its representatives, including but not limited to\n communication on electronic mailing lists, source code control systems,\n and issue tracking systems that are managed by, or on behalf of, the\n Licensor for the purpose of discussing and improving the Work, but\n excluding communication that is conspicuously marked or otherwise\n designated in writing by the copyright owner as \"Not a Contribution.\"\n\n \"Contributor\" shall mean Licensor and any individual or Legal Entity\n on behalf of whom a Contribution has been received by Licensor and\n subsequently incorporated within the Work.\n\n 2. Grant of Copyright License. Subject to the terms and conditions of\n this License, each Contributor hereby grants to You a perpetual,\n worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n copyright license to reproduce, prepare Derivative Works of,\n publicly display, publicly perform, sublicense, and distribute the\n Work and such Derivative Works in Source or Object form.\n\n 3. Grant of Patent License. Subject to the terms and conditions of\n this License, each Contributor hereby grants to You a perpetual,\n worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n (except as stated in this section) patent license to make, have made,\n use, offer to sell, sell, import, and otherwise transfer the Work,\n where such license applies only to those patent claims licensable\n by such Contributor that are necessarily infringed by their\n Contribution(s) alone or by combination of their Contribution(s)\n with the Work to which such Contribution(s) was submitted. If You\n institute patent litigation against any entity (including a\n cross-claim or counterclaim in a lawsuit) alleging that the Work\n or a Contribution incorporated within the Work constitutes direct\n or contributory patent infringement, then any patent licenses\n granted to You under this License for that Work shall terminate\n as of the date such litigation is filed.\n\n 4. Redistribution. You may reproduce and distribute copies of the\n Work or Derivative Works thereof in any medium, with or without\n modifications, and in Source or Object form, provided that You\n meet the following conditions:\n\n (a) You must give any other recipients of the Work or\n Derivative Works a copy of this License; and\n\n (b) You must cause any modified files to carry prominent notices\n stating that You changed the files; and\n\n (c) You must retain, in the Source form of any Derivative Works\n that You distribute, all copyright, patent, trademark, and\n attribution notices from the Source form of the Work,\n excluding those notices that do not pertain to any part of\n the Derivative Works; and\n\n (d) If the Work includes a \"NOTICE\" text file as part of its\n distribution, then any Derivative Works that You distribute must\n include a readable copy of the attribution notices contained\n within such NOTICE file, excluding those notices that do not\n pertain to any part of the Derivative Works, in at least one\n of the following places: within a NOTICE text file distributed\n as part of the Derivative Works; within the Source form or\n documentation, if provided along with the Derivative Works; or,\n within a display generated by the Derivative Works, if and\n wherever such third-party notices normally appear. The contents\n of the NOTICE file are for informational purposes only and\n do not modify the License. You may add Your own attribution\n notices within Derivative Works that You distribute, alongside\n or as an addendum to the NOTICE text from the Work, provided\n that such additional attribution notices cannot be construed\n as modifying the License.\n\n You may add Your own copyright statement to Your modifications and\n may provide additional or different license terms and conditions\n for use, reproduction, or distribution of Your modifications, or\n for any such Derivative Works as a whole, provided Your use,\n reproduction, and distribution of the Work otherwise complies with\n the conditions stated in this License.\n\n 5. Submission of Contributions. Unless You explicitly state otherwise,\n any Contribution intentionally submitted for inclusion in the Work\n by You to the Licensor shall be under the terms and conditions of\n this License, without any additional terms or conditions.\n Notwithstanding the above, nothing herein shall supersede or modify\n the terms of any separate license agreement you may have executed\n with Licensor regarding such Contributions.\n\n 6. Trademarks. This License does not grant permission to use the trade\n names, trademarks, service marks, or product names of the Licensor,\n except as required for reasonable and customary use in describing the\n origin of the Work and reproducing the content of the NOTICE file.\n\n 7. Disclaimer of Warranty. Unless required by applicable law or\n agreed to in writing, Licensor provides the Work (and each\n Contributor provides its Contributions) on an \"AS IS\" BASIS,\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or\n implied, including, without limitation, any warranties or conditions\n of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A\n PARTICULAR PURPOSE. You are solely responsible for determining the\n appropriateness of using or redistributing the Work and assume any\n risks associated with Your exercise of permissions under this License.\n\n 8. Limitation of Liability. In no event and under no legal theory,\n whether in tort (including negligence), contract, or otherwise,\n unless required by applicable law (such as deliberate and grossly\n negligent acts) or agreed to in writing, shall any Contributor be\n liable to You for damages, including any direct, indirect, special,\n incidental, or consequential damages of any character arising as a\n result of this License or out of the use or inability to use the\n Work (including but not limited to damages for loss of goodwill,\n work stoppage, computer failure or malfunction, or any and all\n other commercial damages or losses), even if such Contributor\n has been advised of the possibility of such damages.\n\n 9. Accepting Warranty or Additional Liability. While redistributing\n the Work or Derivative Works thereof, You may choose to offer,\n and charge a fee for, acceptance of support, warranty, indemnity,\n or other liability obligations and/or rights consistent with this\n License. However, in accepting such obligations, You may act only\n on Your own behalf and on Your sole responsibility, not on behalf\n of any other Contributor, and only if You agree to indemnify,\n defend, and hold each Contributor harmless for any liability\n incurred by, or claims asserted against, such Contributor by reason\n of your accepting any such warranty or additional liability.\n\n END OF TERMS AND CONDITIONS\n\n APPENDIX: How to apply the Apache License to your work.\n\n To apply the Apache License to your work, attach the following\n boilerplate notice, with the fields enclosed by brackets \"[]\"\n replaced with your own identifying information. (Don't include\n the brackets!) The text should be enclosed in the appropriate\n comment syntax for the file format. We also recommend that a\n file or class name and description of purpose be included on the\n same \"printed page\" as the copyright notice for easier\n identification within third-party archives.\n\n Copyright [yyyy] [name of copyright owner]\n\n Licensed under the Apache License, Version 2.0 (the \"License\");\n you may not use this file except in compliance with the License.\n You may obtain a copy of the License at\n\n https://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing, software\n distributed under the License is distributed on an \"AS IS\" BASIS,\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n See the License for the specific language governing permissions and\n limitations under the License.\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography-2.8.dist-info/LICENSE.BSD",
"content": "Copyright (c) Individual contributors.\nAll rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are met:\n\n 1. Redistributions of source code must retain the above copyright notice,\n this list of conditions and the following disclaimer.\n\n 2. Redistributions in binary form must reproduce the above copyright\n notice, this list of conditions and the following disclaimer in the\n documentation and/or other materials provided with the distribution.\n\n 3. Neither the name of PyCA Cryptography nor the names of its contributors\n may be used to endorse or promote products derived from this software\n without specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" AND\nANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED\nWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE\nDISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR\nANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES\n(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;\nLOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON\nANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS\nSOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography-2.8.dist-info/LICENSE.PSF",
"content": "1. This LICENSE AGREEMENT is between the Python Software Foundation (\"PSF\"), and\n the Individual or Organization (\"Licensee\") accessing and otherwise using Python\n 2.7.12 software in source or binary form and its associated documentation.\n\n2. Subject to the terms and conditions of this License Agreement, PSF hereby\n grants Licensee a nonexclusive, royalty-free, world-wide license to reproduce,\n analyze, test, perform and/or display publicly, prepare derivative works,\n distribute, and otherwise use Python 2.7.12 alone or in any derivative\n version, provided, however, that PSF's License Agreement and PSF's notice of\n copyright, i.e., \"Copyright © 2001-2016 Python Software Foundation; All Rights\n Reserved\" are retained in Python 2.7.12 alone or in any derivative version\n prepared by Licensee.\n\n3. In the event Licensee prepares a derivative work that is based on or\n incorporates Python 2.7.12 or any part thereof, and wants to make the\n derivative work available to others as provided herein, then Licensee hereby\n agrees to include in any such work a brief summary of the changes made to Python\n 2.7.12.\n\n4. PSF is making Python 2.7.12 available to Licensee on an \"AS IS\" basis.\n PSF MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED. BY WAY OF\n EXAMPLE, BUT NOT LIMITATION, PSF MAKES NO AND DISCLAIMS ANY REPRESENTATION OR\n WARRANTY OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE\n USE OF PYTHON 2.7.12 WILL NOT INFRINGE ANY THIRD PARTY RIGHTS.\n\n5. PSF SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON 2.7.12\n FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS A RESULT OF\n MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON 2.7.12, OR ANY DERIVATIVE\n THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF.\n\n6. This License Agreement will automatically terminate upon a material breach of\n its terms and conditions.\n\n7. Nothing in this License Agreement shall be deemed to create any relationship\n of agency, partnership, or joint venture between PSF and Licensee. This License\n Agreement does not grant permission to use PSF trademarks or trade name in a\n trademark sense to endorse or promote products or services of Licensee, or any\n third party.\n\n8. By copying, installing or otherwise using Python 2.7.12, Licensee agrees\n to be bound by the terms and conditions of this License Agreement.\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography-2.8.dist-info/METADATA",
"content": "Metadata-Version: 2.1\nName: cryptography\nVersion: 2.8\nSummary: cryptography is a package which provides cryptographic recipes and primitives to Python developers.\nHome-page: https://github.com/pyca/cryptography\nAuthor: The cryptography developers\nAuthor-email: cryptography-dev@python.org\nLicense: BSD or Apache License, Version 2.0\nPlatform: UNKNOWN\nClassifier: Development Status :: 5 - Production/Stable\nClassifier: Intended Audience :: Developers\nClassifier: License :: OSI Approved :: Apache Software License\nClassifier: License :: OSI Approved :: BSD License\nClassifier: Natural Language :: English\nClassifier: Operating System :: MacOS :: MacOS X\nClassifier: Operating System :: POSIX\nClassifier: Operating System :: POSIX :: BSD\nClassifier: Operating System :: POSIX :: Linux\nClassifier: Operating System :: Microsoft :: Windows\nClassifier: Programming Language :: Python\nClassifier: Programming Language :: Python :: 2\nClassifier: Programming Language :: Python :: 2.7\nClassifier: Programming Language :: Python :: 3\nClassifier: Programming Language :: Python :: 3.4\nClassifier: Programming Language :: Python :: 3.5\nClassifier: Programming Language :: Python :: 3.6\nClassifier: Programming Language :: Python :: 3.7\nClassifier: Programming Language :: Python :: 3.8\nClassifier: Programming Language :: Python :: Implementation :: CPython\nClassifier: Programming Language :: Python :: Implementation :: PyPy\nClassifier: Topic :: Security :: Cryptography\nRequires-Python: >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*\nDescription-Content-Type: text/x-rst\nRequires-Dist: six (>=1.4.1)\nRequires-Dist: cffi (!=1.11.3,>=1.8)\nRequires-Dist: enum34 ; python_version < '3'\nRequires-Dist: ipaddress ; python_version < '3'\nProvides-Extra: docs\nRequires-Dist: sphinx (!=1.8.0,>=1.6.5) ; extra == 'docs'\nRequires-Dist: sphinx-rtd-theme ; extra == 'docs'\nProvides-Extra: docstest\nRequires-Dist: doc8 ; extra == 'docstest'\nRequires-Dist: pyenchant (>=1.6.11) ; extra == 'docstest'\nRequires-Dist: twine (>=1.12.0) ; extra == 'docstest'\nRequires-Dist: sphinxcontrib-spelling (>=4.0.1) ; extra == 'docstest'\nProvides-Extra: idna\nRequires-Dist: idna (>=2.1) ; extra == 'idna'\nProvides-Extra: pep8test\nRequires-Dist: flake8 ; extra == 'pep8test'\nRequires-Dist: flake8-import-order ; extra == 'pep8test'\nRequires-Dist: pep8-naming ; extra == 'pep8test'\nProvides-Extra: test\nRequires-Dist: pytest (!=3.9.0,!=3.9.1,!=3.9.2,>=3.6.0) ; extra == 'test'\nRequires-Dist: pretend ; extra == 'test'\nRequires-Dist: iso8601 ; extra == 'test'\nRequires-Dist: pytz ; extra == 'test'\nRequires-Dist: hypothesis (!=3.79.2,>=1.11.4) ; extra == 'test'\n\npyca/cryptography\n=================\n\n.. image:: https://img.shields.io/pypi/v/cryptography.svg\n :target: https://pypi.org/project/cryptography/\n :alt: Latest Version\n\n.. image:: https://readthedocs.org/projects/cryptography/badge/?version=latest\n :target: https://cryptography.io\n :alt: Latest Docs\n\n.. image:: https://travis-ci.org/pyca/cryptography.svg?branch=master\n :target: https://travis-ci.org/pyca/cryptography\n\n.. image:: https://dev.azure.com/pyca/cryptography/_apis/build/status/Azure%20CI?branchName=master\n :target: https://dev.azure.com/pyca/cryptography/_build/latest?definitionId=3&branchName=master\n\n.. image:: https://codecov.io/github/pyca/cryptography/coverage.svg?branch=master\n :target: https://codecov.io/github/pyca/cryptography?branch=master\n\n\n``cryptography`` is a package which provides cryptographic recipes and\nprimitives to Python developers. Our goal is for it to be your \"cryptographic\nstandard library\". It supports Python 2.7, Python 3.4+, and PyPy 5.4+.\n\n``cryptography`` includes both high level recipes and low level interfaces to\ncommon cryptographic algorithms such as symmetric ciphers, message digests, and\nkey derivation functions. For example, to encrypt something with\n``cryptography``'s high level symmetric encryption recipe:\n\n.. code-block:: pycon\n\n >>> from cryptography.fernet import Fernet\n >>> # Put this somewhere safe!\n >>> key = Fernet.generate_key()\n >>> f = Fernet(key)\n >>> token = f.encrypt(b\"A really secret message. Not for prying eyes.\")\n >>> token\n '...'\n >>> f.decrypt(token)\n 'A really secret message. Not for prying eyes.'\n\nYou can find more information in the `documentation`_.\n\nYou can install ``cryptography`` with:\n\n.. code-block:: console\n\n $ pip install cryptography\n\nFor full details see `the installation documentation`_.\n\nDiscussion\n~~~~~~~~~~\n\nIf you run into bugs, you can file them in our `issue tracker`_.\n\nWe maintain a `cryptography-dev`_ mailing list for development discussion.\n\nYou can also join ``#cryptography-dev`` on Freenode to ask questions or get\ninvolved.\n\nSecurity\n~~~~~~~~\n\nNeed to report a security issue? Please consult our `security reporting`_\ndocumentation.\n\n\n.. _`documentation`: https://cryptography.io/\n.. _`the installation documentation`: https://cryptography.io/en/latest/installation/\n.. _`issue tracker`: https://github.com/pyca/cryptography/issues\n.. _`cryptography-dev`: https://mail.python.org/mailman/listinfo/cryptography-dev\n.. _`security reporting`: https://cryptography.io/en/latest/security/\n\n\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography-2.8.dist-info/RECORD",
"content": "cryptography-2.8.dist-info/AUTHORS.rst,sha256=MoKTlP6yOmnLC_KXarHVQP0sItBk11dtZ7LzV0VhNB0,2475\r\ncryptography-2.8.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4\r\ncryptography-2.8.dist-info/LICENSE,sha256=NUUrVX-rDvsegNftucTlEYuThAgq2qBR3eNCECy53o0,352\r\ncryptography-2.8.dist-info/LICENSE.APACHE,sha256=qsc7MUj20dcRHbyjIJn2jSbGRMaBOuHk8F9leaomY_4,11360\r\ncryptography-2.8.dist-info/LICENSE.BSD,sha256=YCxMdILeZHndLpeTzaJ15eY9dz2s0eymiSMqtwCPtPs,1532\r\ncryptography-2.8.dist-info/LICENSE.PSF,sha256=aT7ApmKzn5laTyUrA6YiKUVHDBtvEsoCkY5O_g32S58,2415\r\ncryptography-2.8.dist-info/METADATA,sha256=DTs0WZ8nip9kDpwx2m_l-9t0E6gBmIPs-BuE_EJOtbg,5175\r\ncryptography-2.8.dist-info/RECORD,,\r\ncryptography-2.8.dist-info/WHEEL,sha256=QMVol4obO-h_ZZLSvUyPjs3tbFnVOtWLzOTlaMWgEN8,111\r\ncryptography-2.8.dist-info/top_level.txt,sha256=QCkYQE4HJBpqIr-aBqbOZ70NlfbejKnDE6ODbNgUwwg,46\r\ncryptography/__about__.py,sha256=DfioEQ1oTJa9q9bA7yTTxFvxt_oik9bZQDZbgeU5XcE,814\r\ncryptography/__init__.py,sha256=M7mQrfCHYuk7TpEPpfYxkhc95comqxOt41xYjLa5wiA,527\r\ncryptography/__pycache__/__about__.cpython-36.pyc,,\r\ncryptography/__pycache__/__init__.cpython-36.pyc,,\r\ncryptography/__pycache__/exceptions.cpython-36.pyc,,\r\ncryptography/__pycache__/fernet.cpython-36.pyc,,\r\ncryptography/__pycache__/utils.cpython-36.pyc,,\r\ncryptography/exceptions.py,sha256=NPtDqIq1lsQ1Gb1BXkjsGIvbMrWMaKCaT8epiSgi010,1259\r\ncryptography/fernet.py,sha256=CA4iWQvPDeF9EN0IWq8xyuBBqMvcpEE17Ii8VGbi19Y,5220\r\ncryptography/hazmat/__init__.py,sha256=hEPNQw8dgjIPIn42qaLwXNRLCyTGNZeSvkQb57DPhbs,483\r\ncryptography/hazmat/__pycache__/__init__.cpython-36.pyc,,\r\ncryptography/hazmat/__pycache__/_der.cpython-36.pyc,,\r\ncryptography/hazmat/__pycache__/_oid.cpython-36.pyc,,\r\ncryptography/hazmat/_der.py,sha256=9wV7usssA-_Ikxo0h5uVEJJcY6uRbw4UhlgjLhXYsk0,5205\r\ncryptography/hazmat/_oid.py,sha256=F1RU1q8LPLrCoCxyBk_TZ5yJeFt1kYcPMqaIHu4sBRY,2178\r\ncryptography/hazmat/backends/__init__.py,sha256=92UZdmqTyQPOYA2ui17tksyjxBnTmj1XDsxDCChLvxE,496\r\ncryptography/hazmat/backends/__pycache__/__init__.cpython-36.pyc,,\r\ncryptography/hazmat/backends/__pycache__/interfaces.cpython-36.pyc,,\r\ncryptography/hazmat/backends/interfaces.py,sha256=MoNrfcaP5cpD0_wJH5v6vyGSXC8OsbAAHm4-9TZSIU0,10783\r\ncryptography/hazmat/backends/openssl/__init__.py,sha256=k4DMe228_hTuB2kY3Lwk62JdI3EmCd7VkV01zJm57ps,336\r\ncryptography/hazmat/backends/openssl/__pycache__/__init__.cpython-36.pyc,,\r\ncryptography/hazmat/backends/openssl/__pycache__/aead.cpython-36.pyc,,\r\ncryptography/hazmat/backends/openssl/__pycache__/backend.cpython-36.pyc,,\r\ncryptography/hazmat/backends/openssl/__pycache__/ciphers.cpython-36.pyc,,\r\ncryptography/hazmat/backends/openssl/__pycache__/cmac.cpython-36.pyc,,\r\ncryptography/hazmat/backends/openssl/__pycache__/decode_asn1.cpython-36.pyc,,\r\ncryptography/hazmat/backends/openssl/__pycache__/dh.cpython-36.pyc,,\r\ncryptography/hazmat/backends/openssl/__pycache__/dsa.cpython-36.pyc,,\r\ncryptography/hazmat/backends/openssl/__pycache__/ec.cpython-36.pyc,,\r\ncryptography/hazmat/backends/openssl/__pycache__/ed25519.cpython-36.pyc,,\r\ncryptography/hazmat/backends/openssl/__pycache__/ed448.cpython-36.pyc,,\r\ncryptography/hazmat/backends/openssl/__pycache__/encode_asn1.cpython-36.pyc,,\r\ncryptography/hazmat/backends/openssl/__pycache__/hashes.cpython-36.pyc,,\r\ncryptography/hazmat/backends/openssl/__pycache__/hmac.cpython-36.pyc,,\r\ncryptography/hazmat/backends/openssl/__pycache__/ocsp.cpython-36.pyc,,\r\ncryptography/hazmat/backends/openssl/__pycache__/poly1305.cpython-36.pyc,,\r\ncryptography/hazmat/backends/openssl/__pycache__/rsa.cpython-36.pyc,,\r\ncryptography/hazmat/backends/openssl/__pycache__/utils.cpython-36.pyc,,\r\ncryptography/hazmat/backends/openssl/__pycache__/x25519.cpython-36.pyc,,\r\ncryptography/hazmat/backends/openssl/__pycache__/x448.cpython-36.pyc,,\r\ncryptography/hazmat/backends/openssl/__pycache__/x509.cpython-36.pyc,,\r\ncryptography/hazmat/backends/openssl/aead.py,sha256=U0Ncw0z4-pqEWRxJu9GzZDPTvp8YBW5GHFebckaFLTs,5750\r\ncryptography/hazmat/backends/openssl/backend.py,sha256=9ZcByUpQS8kwqLKeZoKUDZGj1dwCnrnAyEJ1ng__TUc,97231\r\ncryptography/hazmat/backends/openssl/ciphers.py,sha256=glsURUBxfMqj0XYTcEosZx6oBL-FCadhIIuQA1cxmfU,9314\r\ncryptography/hazmat/backends/openssl/cmac.py,sha256=wxCHffVAEFxcn6ATMPy7HATIjWZWMoKdTXHJCgeUf48,2855\r\ncryptography/hazmat/backends/openssl/decode_asn1.py,sha256=kPsCTGczXnxkGP471kot8rw9CBFvcuyAtJX13caubDo,33303\r\ncryptography/hazmat/backends/openssl/dh.py,sha256=kXH0LXLsgo7FLNan6V5BiidS30zVkWNwaWuVZ-n6Uog,10814\r\ncryptography/hazmat/backends/openssl/dsa.py,sha256=YOFM_ml2J4q6TI5-oh8M9RPS3u2dcUWxT51Yxfpbs7o,10228\r\ncryptography/hazmat/backends/openssl/ec.py,sha256=okZ87EcaOJRGmjEUvIPqDV7Jp6xcky4oFPSN6fXbGrs,12590\r\ncryptography/hazmat/backends/openssl/ed25519.py,sha256=66dkJPZ6gvUCJSA0RPydi1-0Q2WjhiAcKwvD2R59Zzc,6081\r\ncryptography/hazmat/backends/openssl/ed448.py,sha256=2W6KwzPQXPvvkaNZWFxI_L8rIP80vhBcdZVbIzS5MmY,6045\r\ncryptography/hazmat/backends/openssl/encode_asn1.py,sha256=8XUOTdGreOYvWhiVeQtL7XVqlBpP-rnLuDrmM7bG4LQ,23593\r\ncryptography/hazmat/backends/openssl/hashes.py,sha256=_uYcKjrWzCifz9uONPFBGba7QC3o66-KzxkSNf2uI_A,3196\r\ncryptography/hazmat/backends/openssl/hmac.py,sha256=-5MsNq9-A7Is_nUjMdz0FnOpdy3MnowCWqDGGL67hyM,2998\r\ncryptography/hazmat/backends/openssl/ocsp.py,sha256=lnCm5e37lLoqI_dTgf2dv5qS-vGo8CL3MQh6ojLFBA0,13654\r\ncryptography/hazmat/backends/openssl/poly1305.py,sha256=WaQ3LyxPD2m9auySy4mzDMMoWxTT4pw_zhg55n1D6Gg,2356\r\ncryptography/hazmat/backends/openssl/rsa.py,sha256=swgjJBJfxskdLzAiUJ_jJ9lAzkn83un5Tqvi4fV8p98,18021\r\ncryptography/hazmat/backends/openssl/utils.py,sha256=LqzoMfLbO3385h-JgV8RiWQj0bvtRy76LzimRqjIT2Q,2339\r\ncryptography/hazmat/backends/openssl/x25519.py,sha256=Soo-zS0WsXp6jwJgzVWjhhosMNWbZ6QR6kC-Splwd8I,5580\r\ncryptography/hazmat/backends/openssl/x448.py,sha256=-vMoIJJ4X3HdB4LrWxxq0_xp0sDM69S6VM_P-dqie24,4526\r\ncryptography/hazmat/backends/openssl/x509.py,sha256=Jjl-sJiQvtmM9CbnRCqGs3bxeyfW-TrDsUAX0GvHqrM,20099\r\ncryptography/hazmat/bindings/__init__.py,sha256=0wGw2OF9R7fHX7NWENCmrsYigbXHU2ojgn-N4Rkjs9U,246\r\ncryptography/hazmat/bindings/__pycache__/__init__.cpython-36.pyc,,\r\ncryptography/hazmat/bindings/_constant_time.abi3.so,sha256=F5VZJgeBmqhXqtR39Uf3-T3tZUwRx0Qcwm5XZL_MoXI,30048\r\ncryptography/hazmat/bindings/_openssl.abi3.so,sha256=k2K7IN4Ao0OhMNPZY-GV3CgX0ie3f2WS3XzDZKltrSw,5627248\r\ncryptography/hazmat/bindings/_padding.abi3.so,sha256=pT7wrkBNuG7Y-gm6XSqV7pq_Ni1nadb1rJAh7QUKQNM,33520\r\ncryptography/hazmat/bindings/openssl/__init__.py,sha256=0wGw2OF9R7fHX7NWENCmrsYigbXHU2ojgn-N4Rkjs9U,246\r\ncryptography/hazmat/bindings/openssl/__pycache__/__init__.cpython-36.pyc,,\r\ncryptography/hazmat/bindings/openssl/__pycache__/_conditional.cpython-36.pyc,,\r\ncryptography/hazmat/bindings/openssl/__pycache__/binding.cpython-36.pyc,,\r\ncryptography/hazmat/bindings/openssl/_conditional.py,sha256=HXtnoHgt5jIsEjWcKQFHJ47yBAVsBfLO2XMSbffd-JE,11233\r\ncryptography/hazmat/bindings/openssl/binding.py,sha256=QCYFKaDiuYFhxK3l6Lkvr4V-PXuu26saC09AUNzUJvQ,7120\r\ncryptography/hazmat/primitives/__init__.py,sha256=0wGw2OF9R7fHX7NWENCmrsYigbXHU2ojgn-N4Rkjs9U,246\r\ncryptography/hazmat/primitives/__pycache__/__init__.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/__pycache__/cmac.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/__pycache__/constant_time.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/__pycache__/hashes.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/__pycache__/hmac.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/__pycache__/keywrap.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/__pycache__/padding.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/__pycache__/poly1305.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/asymmetric/__init__.py,sha256=WhUn3tGxoLAxGAsZHElJ2aOILXSh55AZi04MBudYmQA,1020\r\ncryptography/hazmat/primitives/asymmetric/__pycache__/__init__.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/asymmetric/__pycache__/dh.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/asymmetric/__pycache__/dsa.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/asymmetric/__pycache__/ec.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/asymmetric/__pycache__/ed25519.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/asymmetric/__pycache__/ed448.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/asymmetric/__pycache__/padding.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/asymmetric/__pycache__/rsa.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/asymmetric/__pycache__/utils.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/asymmetric/__pycache__/x25519.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/asymmetric/__pycache__/x448.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/asymmetric/dh.py,sha256=6Xl01bjTVHFCcdJr3Ph2cQ7hxkYYedqm-SekZpxnntY,5454\r\ncryptography/hazmat/primitives/asymmetric/dsa.py,sha256=uzK7qpe0BtqHkgVLSrNGtska1w3JSUN_uZp6XAA5LMY,6891\r\ncryptography/hazmat/primitives/asymmetric/ec.py,sha256=omk32C3oyISuzjH37lmzO2e95DU3qnkTPwzZAHXj4dw,13758\r\ncryptography/hazmat/primitives/asymmetric/ed25519.py,sha256=K7dGHENDEmO0kS0fqeT6dcmMRo9IbKLus26WAfDDhjM,2395\r\ncryptography/hazmat/primitives/asymmetric/ed448.py,sha256=eoRniA5yN3fgT0Vutuo-j6i1yeiKEKA_-4aErJPdl6w,2322\r\ncryptography/hazmat/primitives/asymmetric/padding.py,sha256=aCZatU5-q_WW5vazBWeKPF8ZZa0AI8hWzbJaVRN3RWI,2261\r\ncryptography/hazmat/primitives/asymmetric/rsa.py,sha256=V7MKK29BpNGF2f3uWEs3HPYbGuL3YtDFujvjFQrle0Q,10317\r\ncryptography/hazmat/primitives/asymmetric/utils.py,sha256=Og5jZxYoCE9BMb3dmquMTantjsjzl0z2mqoc9s-0588,1184\r\ncryptography/hazmat/primitives/asymmetric/x25519.py,sha256=LZ9dKxAjFdR-VE5OO0CijGUyJxiqFFynCeucTOYQUCk,2281\r\ncryptography/hazmat/primitives/asymmetric/x448.py,sha256=gbZ_UdVIozeZV7FfdpI5qp4t31nWGUXiKwfgMYrF2iY,2249\r\ncryptography/hazmat/primitives/ciphers/__init__.py,sha256=QxaxejeFfz6CPhI1c4iNq_7DsiB41Y_Q-uLfzOx7fv8,626\r\ncryptography/hazmat/primitives/ciphers/__pycache__/__init__.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/ciphers/__pycache__/aead.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/ciphers/__pycache__/algorithms.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/ciphers/__pycache__/base.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/ciphers/__pycache__/modes.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/ciphers/aead.py,sha256=XpXxKVAOznjEpFcPxa-sU_kJSowGjGljpp779Ob8W9g,6437\r\ncryptography/hazmat/primitives/ciphers/algorithms.py,sha256=IXGUj-SRVKyHfDdyqUkRkVdySJ5s9qjIesjFd-EIbwI,4190\r\ncryptography/hazmat/primitives/ciphers/base.py,sha256=hUe5MPVeWB-21ako6_yVGI7GBNCnROkkS53zy8oSO-o,7144\r\ncryptography/hazmat/primitives/ciphers/modes.py,sha256=nUHeQ9I0AIs30Ni2w9TcU9w-AQIpeOA6wLdfA-zkTmI,6641\r\ncryptography/hazmat/primitives/cmac.py,sha256=QgOXACkva7RUbVYvSq3ryw2RdZLOOJgt_zgyCKBmJF4,2075\r\ncryptography/hazmat/primitives/constant_time.py,sha256=TYFSRknWvKlz68rCwfdMw93w0Jy1-3B5F9PQzxH0MbI,1139\r\ncryptography/hazmat/primitives/hashes.py,sha256=hqAOjSu4l7ZOG0U7kJQn0kSHgFuI57o5nb4oTQ7vGnE,6206\r\ncryptography/hazmat/primitives/hmac.py,sha256=MGsVrE_ghlZW0HUH70seV4vCWlIZNSUgB0v9n05vcGg,2196\r\ncryptography/hazmat/primitives/kdf/__init__.py,sha256=nod5HjPswjZr8wFp6Tsu6en9blHYF3khgXI5R0zIcnM,771\r\ncryptography/hazmat/primitives/kdf/__pycache__/__init__.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/kdf/__pycache__/concatkdf.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/kdf/__pycache__/hkdf.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/kdf/__pycache__/kbkdf.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/kdf/__pycache__/pbkdf2.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/kdf/__pycache__/scrypt.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/kdf/__pycache__/x963kdf.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/kdf/concatkdf.py,sha256=MSb4abF8jrICg1v9NSr0QQMfQ1r23RDoUkU0X8rQrhE,3981\r\ncryptography/hazmat/primitives/kdf/hkdf.py,sha256=lcqU0pI3HFKUC9L5LpO4gxPSRsES-x1lePDfryu5U4w,3463\r\ncryptography/hazmat/primitives/kdf/kbkdf.py,sha256=EWeLFPINGl50hkSJj3z62WwePpzRiqGMo1nKm7at1_g,4905\r\ncryptography/hazmat/primitives/kdf/pbkdf2.py,sha256=EK3xDD-Y29DLJulQjHraWrwX7psqCWs7NwSTto4YRxs,2088\r\ncryptography/hazmat/primitives/kdf/scrypt.py,sha256=2BrGwbyk3VvY4szQY2EBvZMaf8AYPWlX84aSj-TXLXk,2155\r\ncryptography/hazmat/primitives/kdf/x963kdf.py,sha256=YL88ILo4eBYP_LhlJcEgKnMqputkOmB-FBCsy6KZ2RA,2280\r\ncryptography/hazmat/primitives/keywrap.py,sha256=LqjkVIs7ub5I5gwmYSb9Ia0VdXMqWWHmnKSdQ7HOGEA,5462\r\ncryptography/hazmat/primitives/padding.py,sha256=CtKBj2nR50m4ZXFAonOxDcymW8Jkj0A9xxt7EMLbpJY,5644\r\ncryptography/hazmat/primitives/poly1305.py,sha256=n7CbIXH3F3HwDsXIaaHJGC-RsSPUuLZG1MJeb1FqBv8,1668\r\ncryptography/hazmat/primitives/serialization/__init__.py,sha256=R-4wUb_UMp3Wh_tWn8nIBJXWVR7Oo0ZRhgm1wEPCMjE,1046\r\ncryptography/hazmat/primitives/serialization/__pycache__/__init__.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/serialization/__pycache__/base.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/serialization/__pycache__/pkcs12.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/serialization/__pycache__/ssh.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/serialization/base.py,sha256=CY8d3TjQ2wPotHpQpkZ-kyVkAwW95y6TFw0JN9KpbFM,1904\r\ncryptography/hazmat/primitives/serialization/pkcs12.py,sha256=LWIA6SVMxc4nnAtSivs8rTpwG6Fy3ppSfHRDiJGdJUw,377\r\ncryptography/hazmat/primitives/serialization/ssh.py,sha256=U94cOHI42BlgiqRXDlsPoqUa5C_Ww_uuu2Njr93d1fA,4381\r\ncryptography/hazmat/primitives/twofactor/__init__.py,sha256=BWrm3DKDoAa281E7U_nzz8v44OmAiXmlIycFcsehwfE,288\r\ncryptography/hazmat/primitives/twofactor/__pycache__/__init__.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/twofactor/__pycache__/hotp.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/twofactor/__pycache__/totp.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/twofactor/__pycache__/utils.cpython-36.pyc,,\r\ncryptography/hazmat/primitives/twofactor/hotp.py,sha256=6_EnKl-zRs0yCXuHxQhs2TEkHaprWxZnfJGrQjs5RIg,2589\r\ncryptography/hazmat/primitives/twofactor/totp.py,sha256=KL3A4bjpqaqynQYd9hfPVkvs5vYVqf1JVpucEX7_ddM,1594\r\ncryptography/hazmat/primitives/twofactor/utils.py,sha256=71gX1bJeP9TQa-HbSPzeUUJwVY78ALYQNvuusknUO4U,954\r\ncryptography/utils.py,sha256=2ml4dp8EPZ-1SNwmqy5vVVFhMWTeHVvHoDJo9QswlPc,5010\r\ncryptography/x509/__init__.py,sha256=F01ZMHaefgsvMeSthFQEa1gz_q7553LMa_IqOq8tD7w,7305\r\ncryptography/x509/__pycache__/__init__.cpython-36.pyc,,\r\ncryptography/x509/__pycache__/base.cpython-36.pyc,,\r\ncryptography/x509/__pycache__/certificate_transparency.cpython-36.pyc,,\r\ncryptography/x509/__pycache__/extensions.cpython-36.pyc,,\r\ncryptography/x509/__pycache__/general_name.cpython-36.pyc,,\r\ncryptography/x509/__pycache__/name.cpython-36.pyc,,\r\ncryptography/x509/__pycache__/ocsp.cpython-36.pyc,,\r\ncryptography/x509/__pycache__/oid.cpython-36.pyc,,\r\ncryptography/x509/base.py,sha256=HlnDQMCpOqZu_ARcysk6zjUNulMPP7nuQz57L8bW-HM,23939\r\ncryptography/x509/certificate_transparency.py,sha256=eJ9lrITdyMn4XsrcVdrTaFVI_RR7mX_VzMZyiaEpbps,1000\r\ncryptography/x509/extensions.py,sha256=T_Xo0Rugk4xZUwDVTtEaci7y2MDHeBXf5jXT3fB_8PU,50781\r\ncryptography/x509/general_name.py,sha256=cwcI1Yez1K9OEdG0wukDWGfS_b6xN21eHOyPaCqjrGY,10462\r\ncryptography/x509/name.py,sha256=f4lg9Ej5izBMHm2sv5OeviQpzmvjSA3951PMGWUF7ac,8131\r\ncryptography/x509/ocsp.py,sha256=_Tbb3M2qe65r2MYlsjXH_vjLwDvaAZZ7-Y5GAXwuqxY,13310\r\ncryptography/x509/oid.py,sha256=iN1TLtCuI1j-WebvLeQM_yni-Uu90nYOglGJAXCCYao,10936\r\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography-2.8.dist-info/WHEEL",
"content": "Wheel-Version: 1.0\nGenerator: bdist_wheel (0.33.6)\nRoot-Is-Purelib: false\nTag: cp34-abi3-manylinux2010_x86_64\n\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cryptography-2.8.dist-info/top_level.txt",
"content": "_constant_time\n_openssl\n_padding\ncryptography\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cssselect/__init__.py",
"content": "# -*- coding: utf-8 -*-\n\"\"\"\n CSS Selectors based on XPath\n ============================\n\n This module supports selecting XML/HTML elements based on CSS selectors.\n See the `CSSSelector` class for details.\n\n\n :copyright: (c) 2007-2012 Ian Bicking and contributors.\n See AUTHORS for more details.\n :license: BSD, see LICENSE for more details.\n\n\"\"\"\n\nfrom cssselect.parser import (parse, Selector, FunctionalPseudoElement,\n SelectorError, SelectorSyntaxError)\nfrom cssselect.xpath import GenericTranslator, HTMLTranslator, ExpressionError\n\n\nVERSION = '1.1.0'\n__version__ = VERSION\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cssselect/parser.py",
"content": "# -*- coding: utf-8 -*-\n\"\"\"\n cssselect.parser\n ================\n\n Tokenizer, parser and parsed objects for CSS selectors.\n\n\n :copyright: (c) 2007-2012 Ian Bicking and contributors.\n See AUTHORS for more details.\n :license: BSD, see LICENSE for more details.\n\n\"\"\"\n\nimport sys\nimport re\nimport operator\n\n\nif sys.version_info[0] < 3:\n _unicode = unicode\n _unichr = unichr\nelse:\n _unicode = str\n _unichr = chr\n\n\ndef ascii_lower(string):\n \"\"\"Lower-case, but only in the ASCII range.\"\"\"\n return string.encode('utf8').lower().decode('utf8')\n\n\nclass SelectorError(Exception):\n \"\"\"Common parent for :class:`SelectorSyntaxError` and\n :class:`ExpressionError`.\n\n You can just use ``except SelectorError:`` when calling\n :meth:`~GenericTranslator.css_to_xpath` and handle both exceptions types.\n\n \"\"\"\n\nclass SelectorSyntaxError(SelectorError, SyntaxError):\n \"\"\"Parsing a selector that does not match the grammar.\"\"\"\n\n\n#### Parsed objects\n\nclass Selector(object):\n \"\"\"\n Represents a parsed selector.\n\n :meth:`~GenericTranslator.selector_to_xpath` accepts this object,\n but ignores :attr:`pseudo_element`. It is the user’s responsibility\n to account for pseudo-elements and reject selectors with unknown\n or unsupported pseudo-elements.\n\n \"\"\"\n def __init__(self, tree, pseudo_element=None):\n self.parsed_tree = tree\n if pseudo_element is not None and not isinstance(\n pseudo_element, FunctionalPseudoElement):\n pseudo_element = ascii_lower(pseudo_element)\n #: A :class:`FunctionalPseudoElement`,\n #: or the identifier for the pseudo-element as a string,\n # or ``None``.\n #:\n #: +-------------------------+----------------+--------------------------------+\n #: | | Selector | Pseudo-element |\n #: +=========================+================+================================+\n #: | CSS3 syntax | ``a::before`` | ``'before'`` |\n #: +-------------------------+----------------+--------------------------------+\n #: | Older syntax | ``a:before`` | ``'before'`` |\n #: +-------------------------+----------------+--------------------------------+\n #: | From the Lists3_ draft, | ``li::marker`` | ``'marker'`` |\n #: | not in Selectors3 | | |\n #: +-------------------------+----------------+--------------------------------+\n #: | Invalid pseudo-class | ``li:marker`` | ``None`` |\n #: +-------------------------+----------------+--------------------------------+\n #: | Functional | ``a::foo(2)`` | ``FunctionalPseudoElement(…)`` |\n #: +-------------------------+----------------+--------------------------------+\n #:\n #: .. _Lists3: http://www.w3.org/TR/2011/WD-css3-lists-20110524/#marker-pseudoelement\n self.pseudo_element = pseudo_element\n\n def __repr__(self):\n if isinstance(self.pseudo_element, FunctionalPseudoElement):\n pseudo_element = repr(self.pseudo_element)\n elif self.pseudo_element:\n pseudo_element = '::%s' % self.pseudo_element\n else:\n pseudo_element = ''\n return '%s[%r%s]' % (\n self.__class__.__name__, self.parsed_tree, pseudo_element)\n\n def canonical(self):\n \"\"\"Return a CSS representation for this selector (a string)\n \"\"\"\n if isinstance(self.pseudo_element, FunctionalPseudoElement):\n pseudo_element = '::%s' % self.pseudo_element.canonical()\n elif self.pseudo_element:\n pseudo_element = '::%s' % self.pseudo_element\n else:\n pseudo_element = ''\n res = '%s%s' % (self.parsed_tree.canonical(), pseudo_element)\n if len(res) > 1:\n res = res.lstrip('*')\n return res\n\n def specificity(self):\n \"\"\"Return the specificity_ of this selector as a tuple of 3 integers.\n\n .. _specificity: http://www.w3.org/TR/selectors/#specificity\n\n \"\"\"\n a, b, c = self.parsed_tree.specificity()\n if self.pseudo_element:\n c += 1\n return a, b, c\n\n\nclass Class(object):\n \"\"\"\n Represents selector.class_name\n \"\"\"\n def __init__(self, selector, class_name):\n self.selector = selector\n self.class_name = class_name\n\n def __repr__(self):\n return '%s[%r.%s]' % (\n self.__class__.__name__, self.selector, self.class_name)\n\n def canonical(self):\n return '%s.%s' % (self.selector.canonical(), self.class_name)\n\n def specificity(self):\n a, b, c = self.selector.specificity()\n b += 1\n return a, b, c\n\n\nclass FunctionalPseudoElement(object):\n \"\"\"\n Represents selector::name(arguments)\n\n .. attribute:: name\n\n The name (identifier) of the pseudo-element, as a string.\n\n .. attribute:: arguments\n\n The arguments of the pseudo-element, as a list of tokens.\n\n **Note:** tokens are not part of the public API,\n and may change between cssselect versions.\n Use at your own risks.\n\n \"\"\"\n def __init__(self, name, arguments):\n self.name = ascii_lower(name)\n self.arguments = arguments\n\n def __repr__(self):\n return '%s[::%s(%r)]' % (\n self.__class__.__name__, self.name,\n [token.value for token in self.arguments])\n\n def argument_types(self):\n return [token.type for token in self.arguments]\n\n def canonical(self):\n args = ''.join(token.css() for token in self.arguments)\n return '%s(%s)' % (self.name, args)\n\n def specificity(self):\n a, b, c = self.selector.specificity()\n b += 1\n return a, b, c\n\n\nclass Function(object):\n \"\"\"\n Represents selector:name(expr)\n \"\"\"\n def __init__(self, selector, name, arguments):\n self.selector = selector\n self.name = ascii_lower(name)\n self.arguments = arguments\n\n def __repr__(self):\n return '%s[%r:%s(%r)]' % (\n self.__class__.__name__, self.selector, self.name,\n [token.value for token in self.arguments])\n\n def argument_types(self):\n return [token.type for token in self.arguments]\n\n def canonical(self):\n args = ''.join(token.css() for token in self.arguments)\n return '%s:%s(%s)' % (self.selector.canonical(), self.name, args)\n\n def specificity(self):\n a, b, c = self.selector.specificity()\n b += 1\n return a, b, c\n\n\nclass Pseudo(object):\n \"\"\"\n Represents selector:ident\n \"\"\"\n def __init__(self, selector, ident):\n self.selector = selector\n self.ident = ascii_lower(ident)\n\n def __repr__(self):\n return '%s[%r:%s]' % (\n self.__class__.__name__, self.selector, self.ident)\n\n def canonical(self):\n return '%s:%s' % (self.selector.canonical(), self.ident)\n\n def specificity(self):\n a, b, c = self.selector.specificity()\n b += 1\n return a, b, c\n\n\nclass Negation(object):\n \"\"\"\n Represents selector:not(subselector)\n \"\"\"\n def __init__(self, selector, subselector):\n self.selector = selector\n self.subselector = subselector\n\n def __repr__(self):\n return '%s[%r:not(%r)]' % (\n self.__class__.__name__, self.selector, self.subselector)\n\n def canonical(self):\n subsel = self.subselector.canonical()\n if len(subsel) > 1:\n subsel = subsel.lstrip('*')\n return '%s:not(%s)' % (self.selector.canonical(), subsel)\n\n def specificity(self):\n a1, b1, c1 = self.selector.specificity()\n a2, b2, c2 = self.subselector.specificity()\n return a1 + a2, b1 + b2, c1 + c2\n\n\nclass Attrib(object):\n \"\"\"\n Represents selector[namespace|attrib operator value]\n \"\"\"\n def __init__(self, selector, namespace, attrib, operator, value):\n self.selector = selector\n self.namespace = namespace\n self.attrib = attrib\n self.operator = operator\n self.value = value\n\n def __repr__(self):\n if self.namespace:\n attrib = '%s|%s' % (self.namespace, self.attrib)\n else:\n attrib = self.attrib\n if self.operator == 'exists':\n return '%s[%r[%s]]' % (\n self.__class__.__name__, self.selector, attrib)\n else:\n return '%s[%r[%s %s %r]]' % (\n self.__class__.__name__, self.selector, attrib,\n self.operator, self.value.value)\n\n def canonical(self):\n if self.namespace:\n attrib = '%s|%s' % (self.namespace, self.attrib)\n else:\n attrib = self.attrib\n\n if self.operator == 'exists':\n op = attrib\n else:\n op = '%s%s%s' % (attrib, self.operator, self.value.css())\n\n return '%s[%s]' % (self.selector.canonical(), op)\n\n def specificity(self):\n a, b, c = self.selector.specificity()\n b += 1\n return a, b, c\n\n\nclass Element(object):\n \"\"\"\n Represents namespace|element\n\n `None` is for the universal selector '*'\n\n \"\"\"\n def __init__(self, namespace=None, element=None):\n self.namespace = namespace\n self.element = element\n\n def __repr__(self):\n return '%s[%s]' % (self.__class__.__name__, self.canonical())\n\n def canonical(self):\n element = self.element or '*'\n if self.namespace:\n element = '%s|%s' % (self.namespace, element)\n return element\n\n def specificity(self):\n if self.element:\n return 0, 0, 1\n else:\n return 0, 0, 0\n\n\nclass Hash(object):\n \"\"\"\n Represents selector#id\n \"\"\"\n def __init__(self, selector, id):\n self.selector = selector\n self.id = id\n\n def __repr__(self):\n return '%s[%r#%s]' % (\n self.__class__.__name__, self.selector, self.id)\n\n def canonical(self):\n return '%s#%s' % (self.selector.canonical(), self.id)\n\n def specificity(self):\n a, b, c = self.selector.specificity()\n a += 1\n return a, b, c\n\n\nclass CombinedSelector(object):\n def __init__(self, selector, combinator, subselector):\n assert selector is not None\n self.selector = selector\n self.combinator = combinator\n self.subselector = subselector\n\n def __repr__(self):\n if self.combinator == ' ':\n comb = ''\n else:\n comb = self.combinator\n return '%s[%r %s %r]' % (\n self.__class__.__name__, self.selector, comb, self.subselector)\n\n def canonical(self):\n subsel = self.subselector.canonical()\n if len(subsel) > 1:\n subsel = subsel.lstrip('*')\n return '%s %s %s' % (\n self.selector.canonical(), self.combinator, subsel)\n\n def specificity(self):\n a1, b1, c1 = self.selector.specificity()\n a2, b2, c2 = self.subselector.specificity()\n return a1 + a2, b1 + b2, c1 + c2\n\n\n#### Parser\n\n# foo\n_el_re = re.compile(r'^[ \\t\\r\\n\\f]*([a-zA-Z]+)[ \\t\\r\\n\\f]*$')\n\n# foo#bar or #bar\n_id_re = re.compile(r'^[ \\t\\r\\n\\f]*([a-zA-Z]*)#([a-zA-Z0-9_-]+)[ \\t\\r\\n\\f]*$')\n\n# foo.bar or .bar\n_class_re = re.compile(\n r'^[ \\t\\r\\n\\f]*([a-zA-Z]*)\\.([a-zA-Z][a-zA-Z0-9_-]*)[ \\t\\r\\n\\f]*$')\n\n\ndef parse(css):\n \"\"\"Parse a CSS *group of selectors*.\n\n If you don't care about pseudo-elements or selector specificity,\n you can skip this and use :meth:`~GenericTranslator.css_to_xpath`.\n\n :param css:\n A *group of selectors* as an Unicode string.\n :raises:\n :class:`SelectorSyntaxError` on invalid selectors.\n :returns:\n A list of parsed :class:`Selector` objects, one for each\n selector in the comma-separated group.\n\n \"\"\"\n # Fast path for simple cases\n match = _el_re.match(css)\n if match:\n return [Selector(Element(element=match.group(1)))]\n match = _id_re.match(css)\n if match is not None:\n return [Selector(Hash(Element(element=match.group(1) or None),\n match.group(2)))]\n match = _class_re.match(css)\n if match is not None:\n return [Selector(Class(Element(element=match.group(1) or None),\n match.group(2)))]\n\n stream = TokenStream(tokenize(css))\n stream.source = css\n return list(parse_selector_group(stream))\n# except SelectorSyntaxError:\n# e = sys.exc_info()[1]\n# message = \"%s at %s -> %r\" % (\n# e, stream.used, stream.peek())\n# e.msg = message\n# e.args = tuple([message])\n# raise\n\n\ndef parse_selector_group(stream):\n stream.skip_whitespace()\n while 1:\n yield Selector(*parse_selector(stream))\n if stream.peek() == ('DELIM', ','):\n stream.next()\n stream.skip_whitespace()\n else:\n break\n\ndef parse_selector(stream):\n result, pseudo_element = parse_simple_selector(stream)\n while 1:\n stream.skip_whitespace()\n peek = stream.peek()\n if peek in (('EOF', None), ('DELIM', ',')):\n break\n if pseudo_element:\n raise SelectorSyntaxError(\n 'Got pseudo-element ::%s not at the end of a selector'\n % pseudo_element)\n if peek.is_delim('+', '>', '~'):\n # A combinator\n combinator = stream.next().value\n stream.skip_whitespace()\n else:\n # By exclusion, the last parse_simple_selector() ended\n # at peek == ' '\n combinator = ' '\n next_selector, pseudo_element = parse_simple_selector(stream)\n result = CombinedSelector(result, combinator, next_selector)\n return result, pseudo_element\n\n\ndef parse_simple_selector(stream, inside_negation=False):\n stream.skip_whitespace()\n selector_start = len(stream.used)\n peek = stream.peek()\n if peek.type == 'IDENT' or peek == ('DELIM', '*'):\n if peek.type == 'IDENT':\n namespace = stream.next().value\n else:\n stream.next()\n namespace = None\n if stream.peek() == ('DELIM', '|'):\n stream.next()\n element = stream.next_ident_or_star()\n else:\n element = namespace\n namespace = None\n else:\n element = namespace = None\n result = Element(namespace, element)\n pseudo_element = None\n while 1:\n peek = stream.peek()\n if peek.type in ('S', 'EOF') or peek.is_delim(',', '+', '>', '~') or (\n inside_negation and peek == ('DELIM', ')')):\n break\n if pseudo_element:\n raise SelectorSyntaxError(\n 'Got pseudo-element ::%s not at the end of a selector'\n % pseudo_element)\n if peek.type == 'HASH':\n result = Hash(result, stream.next().value)\n elif peek == ('DELIM', '.'):\n stream.next()\n result = Class(result, stream.next_ident())\n elif peek == ('DELIM', '|'):\n stream.next()\n result = Element(None, stream.next_ident())\n elif peek == ('DELIM', '['):\n stream.next()\n result = parse_attrib(result, stream)\n elif peek == ('DELIM', ':'):\n stream.next()\n if stream.peek() == ('DELIM', ':'):\n stream.next()\n pseudo_element = stream.next_ident()\n if stream.peek() == ('DELIM', '('):\n stream.next()\n pseudo_element = FunctionalPseudoElement(\n pseudo_element, parse_arguments(stream))\n continue\n ident = stream.next_ident()\n if ident.lower() in ('first-line', 'first-letter',\n 'before', 'after'):\n # Special case: CSS 2.1 pseudo-elements can have a single ':'\n # Any new pseudo-element must have two.\n pseudo_element = _unicode(ident)\n continue\n if stream.peek() != ('DELIM', '('):\n result = Pseudo(result, ident)\n if result.__repr__() == 'Pseudo[Element[*]:scope]':\n if not (len(stream.used) == 2 or\n (len(stream.used) == 3\n and stream.used[0].type == 'S')):\n raise SelectorSyntaxError(\n 'Got immediate child pseudo-element \":scope\" '\n 'not at the start of a selector')\n continue\n stream.next()\n stream.skip_whitespace()\n if ident.lower() == 'not':\n if inside_negation:\n raise SelectorSyntaxError('Got nested :not()')\n argument, argument_pseudo_element = parse_simple_selector(\n stream, inside_negation=True)\n next = stream.next()\n if argument_pseudo_element:\n raise SelectorSyntaxError(\n 'Got pseudo-element ::%s inside :not() at %s'\n % (argument_pseudo_element, next.pos))\n if next != ('DELIM', ')'):\n raise SelectorSyntaxError(\"Expected ')', got %s\" % (next,))\n result = Negation(result, argument)\n else:\n result = Function(result, ident, parse_arguments(stream))\n else:\n raise SelectorSyntaxError(\n \"Expected selector, got %s\" % (peek,))\n if len(stream.used) == selector_start:\n raise SelectorSyntaxError(\n \"Expected selector, got %s\" % (stream.peek(),))\n return result, pseudo_element\n\n\ndef parse_arguments(stream):\n arguments = []\n while 1:\n stream.skip_whitespace()\n next = stream.next()\n if next.type in ('IDENT', 'STRING', 'NUMBER') or next in [\n ('DELIM', '+'), ('DELIM', '-')]:\n arguments.append(next)\n elif next == ('DELIM', ')'):\n return arguments\n else:\n raise SelectorSyntaxError(\n \"Expected an argument, got %s\" % (next,))\n\n\ndef parse_attrib(selector, stream):\n stream.skip_whitespace()\n attrib = stream.next_ident_or_star()\n if attrib is None and stream.peek() != ('DELIM', '|'):\n raise SelectorSyntaxError(\n \"Expected '|', got %s\" % (stream.peek(),))\n if stream.peek() == ('DELIM', '|'):\n stream.next()\n if stream.peek() == ('DELIM', '='):\n namespace = None\n stream.next()\n op = '|='\n else:\n namespace = attrib\n attrib = stream.next_ident()\n op = None\n else:\n namespace = op = None\n if op is None:\n stream.skip_whitespace()\n next = stream.next()\n if next == ('DELIM', ']'):\n return Attrib(selector, namespace, attrib, 'exists', None)\n elif next == ('DELIM', '='):\n op = '='\n elif next.is_delim('^', '$', '*', '~', '|', '!') and (\n stream.peek() == ('DELIM', '=')):\n op = next.value + '='\n stream.next()\n else:\n raise SelectorSyntaxError(\n \"Operator expected, got %s\" % (next,))\n stream.skip_whitespace()\n value = stream.next()\n if value.type not in ('IDENT', 'STRING'):\n raise SelectorSyntaxError(\n \"Expected string or ident, got %s\" % (value,))\n stream.skip_whitespace()\n next = stream.next()\n if next != ('DELIM', ']'):\n raise SelectorSyntaxError(\n \"Expected ']', got %s\" % (next,))\n return Attrib(selector, namespace, attrib, op, value)\n\n\ndef parse_series(tokens):\n \"\"\"\n Parses the arguments for :nth-child() and friends.\n\n :raises: A list of tokens\n :returns: :``(a, b)``\n\n \"\"\"\n for token in tokens:\n if token.type == 'STRING':\n raise ValueError('String tokens not allowed in series.')\n s = ''.join(token.value for token in tokens).strip()\n if s == 'odd':\n return 2, 1\n elif s == 'even':\n return 2, 0\n elif s == 'n':\n return 1, 0\n if 'n' not in s:\n # Just b\n return 0, int(s)\n a, b = s.split('n', 1)\n if not a:\n a = 1\n elif a == '-' or a == '+':\n a = int(a+'1')\n else:\n a = int(a)\n if not b:\n b = 0\n else:\n b = int(b)\n return a, b\n\n\n#### Token objects\n\nclass Token(tuple):\n def __new__(cls, type_, value, pos):\n obj = tuple.__new__(cls, (type_, value))\n obj.pos = pos\n return obj\n\n def __repr__(self):\n return \"<%s '%s' at %i>\" % (self.type, self.value, self.pos)\n\n def is_delim(self, *values):\n return self.type == 'DELIM' and self.value in values\n\n type = property(operator.itemgetter(0))\n value = property(operator.itemgetter(1))\n\n def css(self):\n if self.type == 'STRING':\n return repr(self.value)\n else:\n return self.value\n\n\nclass EOFToken(Token):\n def __new__(cls, pos):\n return Token.__new__(cls, 'EOF', None, pos)\n\n def __repr__(self):\n return '<%s at %i>' % (self.type, self.pos)\n\n\n#### Tokenizer\n\n\nclass TokenMacros:\n unicode_escape = r'\\\\([0-9a-f]{1,6})(?:\\r\\n|[ \\n\\r\\t\\f])?'\n escape = unicode_escape + r'|\\\\[^\\n\\r\\f0-9a-f]'\n string_escape = r'\\\\(?:\\n|\\r\\n|\\r|\\f)|' + escape\n nonascii = r'[^\\0-\\177]'\n nmchar = '[_a-z0-9-]|%s|%s' % (escape, nonascii)\n nmstart = '[_a-z]|%s|%s' % (escape, nonascii)\n\ndef _compile(pattern):\n return re.compile(pattern % vars(TokenMacros), re.IGNORECASE).match\n\n_match_whitespace = _compile(r'[ \\t\\r\\n\\f]+')\n_match_number = _compile(r'[+-]?(?:[0-9]*\\.[0-9]+|[0-9]+)')\n_match_hash = _compile('#(?:%(nmchar)s)+')\n_match_ident = _compile('-?(?:%(nmstart)s)(?:%(nmchar)s)*')\n_match_string_by_quote = {\n \"'\": _compile(r\"([^\\n\\r\\f\\\\']|%(string_escape)s)*\"),\n '\"': _compile(r'([^\\n\\r\\f\\\\\"]|%(string_escape)s)*'),\n}\n\n_sub_simple_escape = re.compile(r'\\\\(.)').sub\n_sub_unicode_escape = re.compile(TokenMacros.unicode_escape, re.I).sub\n_sub_newline_escape =re.compile(r'\\\\(?:\\n|\\r\\n|\\r|\\f)').sub\n\n# Same as r'\\1', but faster on CPython\n_replace_simple = operator.methodcaller('group', 1)\n\ndef _replace_unicode(match):\n codepoint = int(match.group(1), 16)\n if codepoint > sys.maxunicode:\n codepoint = 0xFFFD\n return _unichr(codepoint)\n\n\ndef unescape_ident(value):\n value = _sub_unicode_escape(_replace_unicode, value)\n value = _sub_simple_escape(_replace_simple, value)\n return value\n\n\ndef tokenize(s):\n pos = 0\n len_s = len(s)\n while pos < len_s:\n match = _match_whitespace(s, pos=pos)\n if match:\n yield Token('S', ' ', pos)\n pos = match.end()\n continue\n\n match = _match_ident(s, pos=pos)\n if match:\n value = _sub_simple_escape(_replace_simple,\n _sub_unicode_escape(_replace_unicode, match.group()))\n yield Token('IDENT', value, pos)\n pos = match.end()\n continue\n\n match = _match_hash(s, pos=pos)\n if match:\n value = _sub_simple_escape(_replace_simple,\n _sub_unicode_escape(_replace_unicode, match.group()[1:]))\n yield Token('HASH', value, pos)\n pos = match.end()\n continue\n\n quote = s[pos]\n if quote in _match_string_by_quote:\n match = _match_string_by_quote[quote](s, pos=pos + 1)\n assert match, 'Should have found at least an empty match'\n end_pos = match.end()\n if end_pos == len_s:\n raise SelectorSyntaxError('Unclosed string at %s' % pos)\n if s[end_pos] != quote:\n raise SelectorSyntaxError('Invalid string at %s' % pos)\n value = _sub_simple_escape(_replace_simple,\n _sub_unicode_escape(_replace_unicode,\n _sub_newline_escape('', match.group())))\n yield Token('STRING', value, pos)\n pos = end_pos + 1\n continue\n\n match = _match_number(s, pos=pos)\n if match:\n value = match.group()\n yield Token('NUMBER', value, pos)\n pos = match.end()\n continue\n\n pos2 = pos + 2\n if s[pos:pos2] == '/*':\n pos = s.find('*/', pos2)\n if pos == -1:\n pos = len_s\n else:\n pos += 2\n continue\n\n yield Token('DELIM', s[pos], pos)\n pos += 1\n\n assert pos == len_s\n yield EOFToken(pos)\n\n\nclass TokenStream(object):\n def __init__(self, tokens, source=None):\n self.used = []\n self.tokens = iter(tokens)\n self.source = source\n self.peeked = None\n self._peeking = False\n try:\n self.next_token = self.tokens.next\n except AttributeError:\n # Python 3\n self.next_token = self.tokens.__next__\n\n def next(self):\n if self._peeking:\n self._peeking = False\n self.used.append(self.peeked)\n return self.peeked\n else:\n next = self.next_token()\n self.used.append(next)\n return next\n\n def peek(self):\n if not self._peeking:\n self.peeked = self.next_token()\n self._peeking = True\n return self.peeked\n\n def next_ident(self):\n next = self.next()\n if next.type != 'IDENT':\n raise SelectorSyntaxError('Expected ident, got %s' % (next,))\n return next.value\n\n def next_ident_or_star(self):\n next = self.next()\n if next.type == 'IDENT':\n return next.value\n elif next == ('DELIM', '*'):\n return None\n else:\n raise SelectorSyntaxError(\n \"Expected ident or '*', got %s\" % (next,))\n\n def skip_whitespace(self):\n peek = self.peek()\n if peek.type == 'S':\n self.next()\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cssselect/xpath.py",
"content": "# -*- coding: utf-8 -*-\n\"\"\"\n cssselect.xpath\n ===============\n\n Translation of parsed CSS selectors to XPath expressions.\n\n\n :copyright: (c) 2007-2012 Ian Bicking and contributors.\n See AUTHORS for more details.\n :license: BSD, see LICENSE for more details.\n\n\"\"\"\n\nimport sys\nimport re\n\nfrom cssselect.parser import parse, parse_series, SelectorError\n\n\nif sys.version_info[0] < 3:\n _basestring = basestring\n _unicode = unicode\nelse:\n _basestring = str\n _unicode = str\n\n\ndef _unicode_safe_getattr(obj, name, default=None):\n # getattr() with a non-ASCII name fails on Python 2.x\n name = name.encode('ascii', 'replace').decode('ascii')\n return getattr(obj, name, default)\n\n\nclass ExpressionError(SelectorError, RuntimeError):\n \"\"\"Unknown or unsupported selector (eg. pseudo-class).\"\"\"\n\n\n#### XPath Helpers\n\nclass XPathExpr(object):\n\n def __init__(self, path='', element='*', condition='', star_prefix=False):\n self.path = path\n self.element = element\n self.condition = condition\n\n def __str__(self):\n path = _unicode(self.path) + _unicode(self.element)\n if self.condition:\n path += '[%s]' % self.condition\n return path\n\n def __repr__(self):\n return '%s[%s]' % (self.__class__.__name__, self)\n\n def add_condition(self, condition):\n if self.condition:\n self.condition = '%s and (%s)' % (self.condition, condition)\n else:\n self.condition = condition\n return self\n\n def add_name_test(self):\n if self.element == '*':\n # We weren't doing a test anyway\n return\n self.add_condition(\n \"name() = %s\" % GenericTranslator.xpath_literal(self.element))\n self.element = '*'\n\n def add_star_prefix(self):\n \"\"\"\n Append '*/' to the path to keep the context constrained\n to a single parent.\n \"\"\"\n self.path += '*/'\n\n def join(self, combiner, other):\n path = _unicode(self) + combiner\n # Any \"star prefix\" is redundant when joining.\n if other.path != '*/':\n path += other.path\n self.path = path\n self.element = other.element\n self.condition = other.condition\n return self\n\n\nsplit_at_single_quotes = re.compile(\"('+)\").split\n\n# The spec is actually more permissive than that, but don’t bother.\n# This is just for the fast path.\n# http://www.w3.org/TR/REC-xml/#NT-NameStartChar\nis_safe_name = re.compile('^[a-zA-Z_][a-zA-Z0-9_.-]*$').match\n\n# Test that the string is not empty and does not contain whitespace\nis_non_whitespace = re.compile(r'^[^ \\t\\r\\n\\f]+$').match\n\n\n#### Translation\n\nclass GenericTranslator(object):\n \"\"\"\n Translator for \"generic\" XML documents.\n\n Everything is case-sensitive, no assumption is made on the meaning\n of element names and attribute names.\n\n \"\"\"\n\n ####\n #### HERE BE DRAGONS\n ####\n #### You are welcome to hook into this to change some behavior,\n #### but do so at your own risks.\n #### Until it has received a lot more work and review,\n #### I reserve the right to change this API in backward-incompatible ways\n #### with any minor version of cssselect.\n #### See https://github.com/scrapy/cssselect/pull/22\n #### -- Simon Sapin.\n ####\n\n combinator_mapping = {\n ' ': 'descendant',\n '>': 'child',\n '+': 'direct_adjacent',\n '~': 'indirect_adjacent',\n }\n\n attribute_operator_mapping = {\n 'exists': 'exists',\n '=': 'equals',\n '~=': 'includes',\n '|=': 'dashmatch',\n '^=': 'prefixmatch',\n '$=': 'suffixmatch',\n '*=': 'substringmatch',\n '!=': 'different', # XXX Not in Level 3 but meh\n }\n\n #: The attribute used for ID selectors depends on the document language:\n #: http://www.w3.org/TR/selectors/#id-selectors\n id_attribute = 'id'\n\n #: The attribute used for ``:lang()`` depends on the document language:\n #: http://www.w3.org/TR/selectors/#lang-pseudo\n lang_attribute = 'xml:lang'\n\n #: The case sensitivity of document language element names,\n #: attribute names, and attribute values in selectors depends\n #: on the document language.\n #: http://www.w3.org/TR/selectors/#casesens\n #:\n #: When a document language defines one of these as case-insensitive,\n #: cssselect assumes that the document parser makes the parsed values\n #: lower-case. Making the selector lower-case too makes the comparaison\n #: case-insensitive.\n #:\n #: In HTML, element names and attributes names (but not attribute values)\n #: are case-insensitive. All of lxml.html, html5lib, BeautifulSoup4\n #: and HTMLParser make them lower-case in their parse result, so\n #: the assumption holds.\n lower_case_element_names = False\n lower_case_attribute_names = False\n lower_case_attribute_values = False\n\n # class used to represent and xpath expression\n xpathexpr_cls = XPathExpr\n\n def css_to_xpath(self, css, prefix='descendant-or-self::'):\n \"\"\"Translate a *group of selectors* to XPath.\n\n Pseudo-elements are not supported here since XPath only knows\n about \"real\" elements.\n\n :param css:\n A *group of selectors* as an Unicode string.\n :param prefix:\n This string is prepended to the XPath expression for each selector.\n The default makes selectors scoped to the context node’s subtree.\n :raises:\n :class:`SelectorSyntaxError` on invalid selectors,\n :class:`ExpressionError` on unknown/unsupported selectors,\n including pseudo-elements.\n :returns:\n The equivalent XPath 1.0 expression as an Unicode string.\n\n \"\"\"\n return ' | '.join(self.selector_to_xpath(selector, prefix,\n translate_pseudo_elements=True)\n for selector in parse(css))\n\n def selector_to_xpath(self, selector, prefix='descendant-or-self::',\n translate_pseudo_elements=False):\n \"\"\"Translate a parsed selector to XPath.\n\n\n :param selector:\n A parsed :class:`Selector` object.\n :param prefix:\n This string is prepended to the resulting XPath expression.\n The default makes selectors scoped to the context node’s subtree.\n :param translate_pseudo_elements:\n Unless this is set to ``True`` (as :meth:`css_to_xpath` does),\n the :attr:`~Selector.pseudo_element` attribute of the selector\n is ignored.\n It is the caller's responsibility to reject selectors\n with pseudo-elements, or to account for them somehow.\n :raises:\n :class:`ExpressionError` on unknown/unsupported selectors.\n :returns:\n The equivalent XPath 1.0 expression as an Unicode string.\n\n \"\"\"\n tree = getattr(selector, 'parsed_tree', None)\n if not tree:\n raise TypeError('Expected a parsed selector, got %r' % (selector,))\n xpath = self.xpath(tree)\n assert isinstance(xpath, self.xpathexpr_cls) # help debug a missing 'return'\n if translate_pseudo_elements and selector.pseudo_element:\n xpath = self.xpath_pseudo_element(xpath, selector.pseudo_element)\n return (prefix or '') + _unicode(xpath)\n\n def xpath_pseudo_element(self, xpath, pseudo_element):\n \"\"\"Translate a pseudo-element.\n\n Defaults to not supporting pseudo-elements at all,\n but can be overridden by sub-classes.\n\n \"\"\"\n raise ExpressionError('Pseudo-elements are not supported.')\n\n @staticmethod\n def xpath_literal(s):\n s = _unicode(s)\n if \"'\" not in s:\n s = \"'%s'\" % s\n elif '\"' not in s:\n s = '\"%s\"' % s\n else:\n s = \"concat(%s)\" % ','.join([\n ((\"'\" in part) and '\"%s\"' or \"'%s'\") % part\n for part in split_at_single_quotes(s) if part\n ])\n return s\n\n def xpath(self, parsed_selector):\n \"\"\"Translate any parsed selector object.\"\"\"\n type_name = type(parsed_selector).__name__\n method = getattr(self, 'xpath_%s' % type_name.lower(), None)\n if method is None:\n raise ExpressionError('%s is not supported.' % type_name)\n return method(parsed_selector)\n\n\n # Dispatched by parsed object type\n\n def xpath_combinedselector(self, combined):\n \"\"\"Translate a combined selector.\"\"\"\n combinator = self.combinator_mapping[combined.combinator]\n method = getattr(self, 'xpath_%s_combinator' % combinator)\n return method(self.xpath(combined.selector),\n self.xpath(combined.subselector))\n\n def xpath_negation(self, negation):\n xpath = self.xpath(negation.selector)\n sub_xpath = self.xpath(negation.subselector)\n sub_xpath.add_name_test()\n if sub_xpath.condition:\n return xpath.add_condition('not(%s)' % sub_xpath.condition)\n else:\n return xpath.add_condition('0')\n\n def xpath_function(self, function):\n \"\"\"Translate a functional pseudo-class.\"\"\"\n method = 'xpath_%s_function' % function.name.replace('-', '_')\n method = _unicode_safe_getattr(self, method, None)\n if not method:\n raise ExpressionError(\n \"The pseudo-class :%s() is unknown\" % function.name)\n return method(self.xpath(function.selector), function)\n\n def xpath_pseudo(self, pseudo):\n \"\"\"Translate a pseudo-class.\"\"\"\n method = 'xpath_%s_pseudo' % pseudo.ident.replace('-', '_')\n method = _unicode_safe_getattr(self, method, None)\n if not method:\n # TODO: better error message for pseudo-elements?\n raise ExpressionError(\n \"The pseudo-class :%s is unknown\" % pseudo.ident)\n return method(self.xpath(pseudo.selector))\n\n\n def xpath_attrib(self, selector):\n \"\"\"Translate an attribute selector.\"\"\"\n operator = self.attribute_operator_mapping[selector.operator]\n method = getattr(self, 'xpath_attrib_%s' % operator)\n if self.lower_case_attribute_names:\n name = selector.attrib.lower()\n else:\n name = selector.attrib\n safe = is_safe_name(name)\n if selector.namespace:\n name = '%s:%s' % (selector.namespace, name)\n safe = safe and is_safe_name(selector.namespace)\n if safe:\n attrib = '@' + name\n else:\n attrib = 'attribute::*[name() = %s]' % self.xpath_literal(name)\n if selector.value is None:\n value = None\n elif self.lower_case_attribute_values:\n value = selector.value.value.lower()\n else:\n value = selector.value.value\n return method(self.xpath(selector.selector), attrib, value)\n\n def xpath_class(self, class_selector):\n \"\"\"Translate a class selector.\"\"\"\n # .foo is defined as [class~=foo] in the spec.\n xpath = self.xpath(class_selector.selector)\n return self.xpath_attrib_includes(\n xpath, '@class', class_selector.class_name)\n\n def xpath_hash(self, id_selector):\n \"\"\"Translate an ID selector.\"\"\"\n xpath = self.xpath(id_selector.selector)\n return self.xpath_attrib_equals(xpath, '@id', id_selector.id)\n\n def xpath_element(self, selector):\n \"\"\"Translate a type or universal selector.\"\"\"\n element = selector.element\n if not element:\n element = '*'\n safe = True\n else:\n safe = is_safe_name(element)\n if self.lower_case_element_names:\n element = element.lower()\n if selector.namespace:\n # Namespace prefixes are case-sensitive.\n # http://www.w3.org/TR/css3-namespace/#prefixes\n element = '%s:%s' % (selector.namespace, element)\n safe = safe and is_safe_name(selector.namespace)\n xpath = self.xpathexpr_cls(element=element)\n if not safe:\n xpath.add_name_test()\n return xpath\n\n\n # CombinedSelector: dispatch by combinator\n\n def xpath_descendant_combinator(self, left, right):\n \"\"\"right is a child, grand-child or further descendant of left\"\"\"\n return left.join('/descendant-or-self::*/', right)\n\n def xpath_child_combinator(self, left, right):\n \"\"\"right is an immediate child of left\"\"\"\n return left.join('/', right)\n\n def xpath_direct_adjacent_combinator(self, left, right):\n \"\"\"right is a sibling immediately after left\"\"\"\n xpath = left.join('/following-sibling::', right)\n xpath.add_name_test()\n return xpath.add_condition('position() = 1')\n\n def xpath_indirect_adjacent_combinator(self, left, right):\n \"\"\"right is a sibling after left, immediately or not\"\"\"\n return left.join('/following-sibling::', right)\n\n\n # Function: dispatch by function/pseudo-class name\n\n def xpath_nth_child_function(self, xpath, function, last=False,\n add_name_test=True):\n try:\n a, b = parse_series(function.arguments)\n except ValueError:\n raise ExpressionError(\"Invalid series: '%r'\" % function.arguments)\n\n # From https://www.w3.org/TR/css3-selectors/#structural-pseudos:\n #\n # :nth-child(an+b)\n # an+b-1 siblings before\n #\n # :nth-last-child(an+b)\n # an+b-1 siblings after\n #\n # :nth-of-type(an+b)\n # an+b-1 siblings with the same expanded element name before\n #\n # :nth-last-of-type(an+b)\n # an+b-1 siblings with the same expanded element name after\n #\n # So,\n # for :nth-child and :nth-of-type\n #\n # count(preceding-sibling::) = an+b-1\n #\n # for :nth-last-child and :nth-last-of-type\n #\n # count(following-sibling::) = an+b-1\n #\n # therefore,\n # count(...) - (b-1) ≡ 0 (mod a)\n #\n # if a == 0:\n # ~~~~~~~~~~\n # count(...) = b-1\n #\n # if a < 0:\n # ~~~~~~~~~\n # count(...) - b +1 <= 0\n # -> count(...) <= b-1\n #\n # if a > 0:\n # ~~~~~~~~~\n # count(...) - b +1 >= 0\n # -> count(...) >= b-1\n\n # work with b-1 instead\n b_min_1 = b - 1\n\n # early-exit condition 1:\n # ~~~~~~~~~~~~~~~~~~~~~~~\n # for a == 1, nth-*(an+b) means n+b-1 siblings before/after,\n # and since n ∈ {0, 1, 2, ...}, if b-1<=0,\n # there is always an \"n\" matching any number of siblings (maybe none)\n if a == 1 and b_min_1 <=0:\n return xpath\n\n # early-exit condition 2:\n # ~~~~~~~~~~~~~~~~~~~~~~~\n # an+b-1 siblings with a<0 and (b-1)<0 is not possible\n if a < 0 and b_min_1 < 0:\n return xpath.add_condition('0')\n\n # `add_name_test` boolean is inverted and somewhat counter-intuitive:\n #\n # nth_of_type() calls nth_child(add_name_test=False)\n if add_name_test:\n nodetest = '*'\n else:\n nodetest = '%s' % xpath.element\n\n # count siblings before or after the element\n if not last:\n siblings_count = 'count(preceding-sibling::%s)' % nodetest\n else:\n siblings_count = 'count(following-sibling::%s)' % nodetest\n\n # special case of fixed position: nth-*(0n+b)\n # if a == 0:\n # ~~~~~~~~~~\n # count(***-sibling::***) = b-1\n if a == 0:\n return xpath.add_condition('%s = %s' % (siblings_count, b_min_1))\n\n expr = []\n\n if a > 0:\n # siblings count, an+b-1, is always >= 0,\n # so if a>0, and (b-1)<=0, an \"n\" exists to satisfy this,\n # therefore, the predicate is only interesting if (b-1)>0\n if b_min_1 > 0:\n expr.append('%s >= %s' % (siblings_count, b_min_1))\n else:\n # if a<0, and (b-1)<0, no \"n\" satisfies this,\n # this is tested above as an early exist condition\n # otherwise,\n expr.append('%s <= %s' % (siblings_count, b_min_1))\n\n # operations modulo 1 or -1 are simpler, one only needs to verify:\n #\n # - either:\n # count(***-sibling::***) - (b-1) = n = 0, 1, 2, 3, etc.,\n # i.e. count(***-sibling::***) >= (b-1)\n #\n # - or:\n # count(***-sibling::***) - (b-1) = -n = 0, -1, -2, -3, etc.,\n # i.e. count(***-sibling::***) <= (b-1)\n # we we just did above.\n #\n if abs(a) != 1:\n # count(***-sibling::***) - (b-1) ≡ 0 (mod a)\n left = siblings_count\n\n # apply \"modulo a\" on 2nd term, -(b-1),\n # to simplify things like \"(... +6) % -3\",\n # and also make it positive with |a|\n b_neg = (-b_min_1) % abs(a)\n\n if b_neg != 0:\n b_neg = '+%s' % b_neg\n left = '(%s %s)' % (left, b_neg)\n\n expr.append('%s mod %s = 0' % (left, a))\n\n xpath.add_condition(' and '.join(expr))\n return xpath\n\n def xpath_nth_last_child_function(self, xpath, function):\n return self.xpath_nth_child_function(xpath, function, last=True)\n\n def xpath_nth_of_type_function(self, xpath, function):\n if xpath.element == '*':\n raise ExpressionError(\n \"*:nth-of-type() is not implemented\")\n return self.xpath_nth_child_function(xpath, function,\n add_name_test=False)\n\n def xpath_nth_last_of_type_function(self, xpath, function):\n if xpath.element == '*':\n raise ExpressionError(\n \"*:nth-of-type() is not implemented\")\n return self.xpath_nth_child_function(xpath, function, last=True,\n add_name_test=False)\n\n def xpath_contains_function(self, xpath, function):\n # Defined there, removed in later drafts:\n # http://www.w3.org/TR/2001/CR-css3-selectors-20011113/#content-selectors\n if function.argument_types() not in (['STRING'], ['IDENT']):\n raise ExpressionError(\n \"Expected a single string or ident for :contains(), got %r\"\n % function.arguments)\n value = function.arguments[0].value\n return xpath.add_condition(\n 'contains(., %s)' % self.xpath_literal(value))\n\n def xpath_lang_function(self, xpath, function):\n if function.argument_types() not in (['STRING'], ['IDENT']):\n raise ExpressionError(\n \"Expected a single string or ident for :lang(), got %r\"\n % function.arguments)\n value = function.arguments[0].value\n return xpath.add_condition(\n \"lang(%s)\" % (self.xpath_literal(value)))\n\n\n # Pseudo: dispatch by pseudo-class name\n\n def xpath_root_pseudo(self, xpath):\n return xpath.add_condition(\"not(parent::*)\")\n\n # CSS immediate children (CSS \":scope > div\" to XPath \"child::div\" or \"./div\")\n # Works only at the start of a selector\n # Needed to get immediate children of a processed selector in Scrapy\n # for product in response.css('.product'):\n # description = product.css(':scope > div::text').get()\n def xpath_scope_pseudo(self, xpath):\n return xpath.add_condition(\"1\")\n\n def xpath_first_child_pseudo(self, xpath):\n return xpath.add_condition('count(preceding-sibling::*) = 0')\n\n def xpath_last_child_pseudo(self, xpath):\n return xpath.add_condition('count(following-sibling::*) = 0')\n\n def xpath_first_of_type_pseudo(self, xpath):\n if xpath.element == '*':\n raise ExpressionError(\n \"*:first-of-type is not implemented\")\n return xpath.add_condition('count(preceding-sibling::%s) = 0' % xpath.element)\n\n def xpath_last_of_type_pseudo(self, xpath):\n if xpath.element == '*':\n raise ExpressionError(\n \"*:last-of-type is not implemented\")\n return xpath.add_condition('count(following-sibling::%s) = 0' % xpath.element)\n\n def xpath_only_child_pseudo(self, xpath):\n return xpath.add_condition('count(parent::*/child::*) = 1')\n\n def xpath_only_of_type_pseudo(self, xpath):\n if xpath.element == '*':\n raise ExpressionError(\n \"*:only-of-type is not implemented\")\n return xpath.add_condition('count(parent::*/child::%s) = 1' % xpath.element)\n\n def xpath_empty_pseudo(self, xpath):\n return xpath.add_condition(\"not(*) and not(string-length())\")\n\n def pseudo_never_matches(self, xpath):\n \"\"\"Common implementation for pseudo-classes that never match.\"\"\"\n return xpath.add_condition(\"0\")\n\n xpath_link_pseudo = pseudo_never_matches\n xpath_visited_pseudo = pseudo_never_matches\n xpath_hover_pseudo = pseudo_never_matches\n xpath_active_pseudo = pseudo_never_matches\n xpath_focus_pseudo = pseudo_never_matches\n xpath_target_pseudo = pseudo_never_matches\n xpath_enabled_pseudo = pseudo_never_matches\n xpath_disabled_pseudo = pseudo_never_matches\n xpath_checked_pseudo = pseudo_never_matches\n\n # Attrib: dispatch by attribute operator\n\n def xpath_attrib_exists(self, xpath, name, value):\n assert not value\n xpath.add_condition(name)\n return xpath\n\n def xpath_attrib_equals(self, xpath, name, value):\n xpath.add_condition('%s = %s' % (name, self.xpath_literal(value)))\n return xpath\n\n def xpath_attrib_different(self, xpath, name, value):\n # FIXME: this seems like a weird hack...\n if value:\n xpath.add_condition('not(%s) or %s != %s'\n % (name, name, self.xpath_literal(value)))\n else:\n xpath.add_condition('%s != %s'\n % (name, self.xpath_literal(value)))\n return xpath\n\n def xpath_attrib_includes(self, xpath, name, value):\n if is_non_whitespace(value):\n xpath.add_condition(\n \"%s and contains(concat(' ', normalize-space(%s), ' '), %s)\"\n % (name, name, self.xpath_literal(' '+value+' ')))\n else:\n xpath.add_condition('0')\n return xpath\n\n def xpath_attrib_dashmatch(self, xpath, name, value):\n # Weird, but true...\n xpath.add_condition('%s and (%s = %s or starts-with(%s, %s))' % (\n name,\n name, self.xpath_literal(value),\n name, self.xpath_literal(value + '-')))\n return xpath\n\n def xpath_attrib_prefixmatch(self, xpath, name, value):\n if value:\n xpath.add_condition('%s and starts-with(%s, %s)' % (\n name, name, self.xpath_literal(value)))\n else:\n xpath.add_condition('0')\n return xpath\n\n def xpath_attrib_suffixmatch(self, xpath, name, value):\n if value:\n # Oddly there is a starts-with in XPath 1.0, but not ends-with\n xpath.add_condition(\n '%s and substring(%s, string-length(%s)-%s) = %s'\n % (name, name, name, len(value)-1, self.xpath_literal(value)))\n else:\n xpath.add_condition('0')\n return xpath\n\n def xpath_attrib_substringmatch(self, xpath, name, value):\n if value:\n # Attribute selectors are case sensitive\n xpath.add_condition('%s and contains(%s, %s)' % (\n name, name, self.xpath_literal(value)))\n else:\n xpath.add_condition('0')\n return xpath\n\n\nclass HTMLTranslator(GenericTranslator):\n \"\"\"\n Translator for (X)HTML documents.\n\n Has a more useful implementation of some pseudo-classes based on\n HTML-specific element names and attribute names, as described in\n the `HTML5 specification`_. It assumes no-quirks mode.\n The API is the same as :class:`GenericTranslator`.\n\n .. _HTML5 specification: http://www.w3.org/TR/html5/links.html#selectors\n\n :param xhtml:\n If false (the default), element names and attribute names\n are case-insensitive.\n\n \"\"\"\n\n lang_attribute = 'lang'\n\n def __init__(self, xhtml=False):\n self.xhtml = xhtml # Might be useful for sub-classes?\n if not xhtml:\n # See their definition in GenericTranslator.\n self.lower_case_element_names = True\n self.lower_case_attribute_names = True\n\n def xpath_checked_pseudo(self, xpath):\n # FIXME: is this really all the elements?\n return xpath.add_condition(\n \"(@selected and name(.) = 'option') or \"\n \"(@checked \"\n \"and (name(.) = 'input' or name(.) = 'command')\"\n \"and (@type = 'checkbox' or @type = 'radio'))\")\n\n def xpath_lang_function(self, xpath, function):\n if function.argument_types() not in (['STRING'], ['IDENT']):\n raise ExpressionError(\n \"Expected a single string or ident for :lang(), got %r\"\n % function.arguments)\n value = function.arguments[0].value\n return xpath.add_condition(\n \"ancestor-or-self::*[@lang][1][starts-with(concat(\"\n # XPath 1.0 has no lower-case function...\n \"translate(@%s, 'ABCDEFGHIJKLMNOPQRSTUVWXYZ', \"\n \"'abcdefghijklmnopqrstuvwxyz'), \"\n \"'-'), %s)]\"\n % (self.lang_attribute, self.xpath_literal(value.lower() + '-')))\n\n def xpath_link_pseudo(self, xpath):\n return xpath.add_condition(\"@href and \"\n \"(name(.) = 'a' or name(.) = 'link' or name(.) = 'area')\")\n\n # Links are never visited, the implementation for :visited is the same\n # as in GenericTranslator\n\n def xpath_disabled_pseudo(self, xpath):\n # http://www.w3.org/TR/html5/section-index.html#attributes-1\n return xpath.add_condition('''\n (\n @disabled and\n (\n (name(.) = 'input' and @type != 'hidden') or\n name(.) = 'button' or\n name(.) = 'select' or\n name(.) = 'textarea' or\n name(.) = 'command' or\n name(.) = 'fieldset' or\n name(.) = 'optgroup' or\n name(.) = 'option'\n )\n ) or (\n (\n (name(.) = 'input' and @type != 'hidden') or\n name(.) = 'button' or\n name(.) = 'select' or\n name(.) = 'textarea'\n )\n and ancestor::fieldset[@disabled]\n )\n ''')\n # FIXME: in the second half, add \"and is not a descendant of that\n # fieldset element's first legend element child, if any.\"\n\n def xpath_enabled_pseudo(self, xpath):\n # http://www.w3.org/TR/html5/section-index.html#attributes-1\n return xpath.add_condition('''\n (\n @href and (\n name(.) = 'a' or\n name(.) = 'link' or\n name(.) = 'area'\n )\n ) or (\n (\n name(.) = 'command' or\n name(.) = 'fieldset' or\n name(.) = 'optgroup'\n )\n and not(@disabled)\n ) or (\n (\n (name(.) = 'input' and @type != 'hidden') or\n name(.) = 'button' or\n name(.) = 'select' or\n name(.) = 'textarea' or\n name(.) = 'keygen'\n )\n and not (@disabled or ancestor::fieldset[@disabled])\n ) or (\n name(.) = 'option' and not(\n @disabled or ancestor::optgroup[@disabled]\n )\n )\n ''')\n # FIXME: ... or \"li elements that are children of menu elements,\n # and that have a child element that defines a command, if the first\n # such element's Disabled State facet is false (not disabled)\".\n # FIXME: after ancestor::fieldset[@disabled], add \"and is not a\n # descendant of that fieldset element's first legend element child,\n # if any.\"\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cssselect-1.1.0.dist-info/AUTHORS",
"content": "Daniel Graña\nIan Bicking\nJames Salter\nLaurence Rowe\nMikhail Korobov\nNik Nyby\nPaul Tremberth\nSimon Potter\nSimon Sapin\nStefan Behnel\nThomas Grainger\nVarialus\nArthur Darcet\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cssselect-1.1.0.dist-info/INSTALLER",
"content": "pip\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cssselect-1.1.0.dist-info/LICENSE",
"content": "Copyright (c) 2007-2012 Ian Bicking and contributors. See AUTHORS\nfor more details.\n\nAll rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are\nmet:\n\n1. Redistributions of source code must retain the above copyright\nnotice, this list of conditions and the following disclaimer.\n\n2. Redistributions in binary form must reproduce the above copyright\nnotice, this list of conditions and the following disclaimer in\nthe documentation and/or other materials provided with the\ndistribution.\n\n3. Neither the name of Ian Bicking nor the names of its contributors may\nbe used to endorse or promote products derived from this software\nwithout specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS\n\"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT\nLIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR\nA PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL IAN BICKING OR\nCONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,\nEXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,\nPROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR\nPROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF\nLIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING\nNEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS\nSOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cssselect-1.1.0.dist-info/METADATA",
"content": "Metadata-Version: 2.1\nName: cssselect\nVersion: 1.1.0\nSummary: cssselect parses CSS3 Selectors and translates them to XPath 1.0\nHome-page: https://github.com/scrapy/cssselect\nAuthor: Ian Bicking\nAuthor-email: ianb@colorstudy.com\nMaintainer: Paul Tremberth\nMaintainer-email: paul.tremberth@gmail.com\nLicense: BSD\nPlatform: UNKNOWN\nClassifier: Development Status :: 4 - Beta\nClassifier: Intended Audience :: Developers\nClassifier: License :: OSI Approved :: BSD License\nClassifier: Programming Language :: Python :: 2\nClassifier: Programming Language :: Python :: 2.7\nClassifier: Programming Language :: Python :: 3\nClassifier: Programming Language :: Python :: 3.4\nClassifier: Programming Language :: Python :: 3.5\nClassifier: Programming Language :: Python :: 3.6\nRequires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*\n\n===================================\ncssselect: CSS Selectors for Python\n===================================\n\n.. image:: https://img.shields.io/pypi/v/cssselect.svg\n :target: https://pypi.python.org/pypi/cssselect\n :alt: PyPI Version\n\n.. image:: https://img.shields.io/pypi/pyversions/cssselect.svg\n :target: https://pypi.python.org/pypi/cssselect\n :alt: Supported Python Versions\n\n.. image:: https://img.shields.io/travis/scrapy/cssselect/master.svg\n :target: https://travis-ci.org/scrapy/cssselect\n :alt: Build Status\n\n.. image:: https://img.shields.io/codecov/c/github/scrapy/cssselect/master.svg\n :target: https://codecov.io/github/scrapy/cssselect?branch=master\n :alt: Coverage report\n\n*cssselect* parses `CSS3 Selectors`_ and translate them to `XPath 1.0`_\nexpressions. Such expressions can be used in lxml_ or another XPath engine\nto find the matching elements in an XML or HTML document.\n\nThis module used to live inside of lxml as ``lxml.cssselect`` before it was\nextracted as a stand-alone project.\n\n.. _CSS3 Selectors: https://www.w3.org/TR/css3-selectors/\n.. _XPath 1.0: https://www.w3.org/TR/xpath/\n.. _lxml: http://lxml.de/\n\n\nQuick facts:\n\n* Free software: BSD licensed\n* Compatible with Python 2.7 and 3.4+\n* Latest documentation `on Read the Docs `_\n* Source, issues and pull requests `on GitHub\n `_\n* Releases `on PyPI `_\n* Install with ``pip install cssselect``\n\n\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cssselect-1.1.0.dist-info/RECORD",
"content": "cssselect-1.1.0.dist-info/AUTHORS,sha256=0xOj3H8iII6M_KWmoDYQRuzTrYrLPbJ8K2kVSAoQ5zQ,171\r\ncssselect-1.1.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4\r\ncssselect-1.1.0.dist-info/LICENSE,sha256=XI2p90Tgr7qBpIybXb5zBI95izKH1vGvigXuCOuxCJI,1517\r\ncssselect-1.1.0.dist-info/METADATA,sha256=L1k9gxlz3quPBMPepkTOo0tPXV2l8cQl-yZGnO-gNUc,2332\r\ncssselect-1.1.0.dist-info/RECORD,,\r\ncssselect-1.1.0.dist-info/WHEEL,sha256=h_aVn5OB2IERUjMbi2pucmR_zzWJtk303YXvhh60NJ8,110\r\ncssselect-1.1.0.dist-info/top_level.txt,sha256=GKK3Utu_ceog6CK27VXNdbyiqGnoyJo3970FLo5JdUU,10\r\ncssselect/__init__.py,sha256=fmdpKrz5-uYAzXUh3LMOrEPiJMENB1gf962v5Nq5yis,639\r\ncssselect/__pycache__/__init__.cpython-36.pyc,,\r\ncssselect/__pycache__/parser.cpython-36.pyc,,\r\ncssselect/__pycache__/xpath.cpython-36.pyc,,\r\ncssselect/parser.py,sha256=jrlRxEpSFfiqYHKfUHjgERdMQwFbvsh3sONi_HiTDys,26145\r\ncssselect/xpath.py,sha256=Izy4CXmK6zMHg13PP63bBp065eFZNBfPJeNyhjSsS7Q,28257\r\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cssselect-1.1.0.dist-info/WHEEL",
"content": "Wheel-Version: 1.0\nGenerator: bdist_wheel (0.33.4)\nRoot-Is-Purelib: true\nTag: py2-none-any\nTag: py3-none-any\n\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/cssselect-1.1.0.dist-info/top_level.txt",
"content": "cssselect\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/easy-install.pth",
"content": "./setuptools-40.8.0-py3.6.egg\n./pip-19.0.3-py3.6.egg\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/exampleproj/__init__.py",
"content": "\"\"\"\nAn example project.\n\n@added: exampleproj NEXT\n\"\"\"\n\nfrom incremental import Version\nfrom ._version import __version__\n\n__all__ = [\"__version__\"]\n\nif Version(\"exampleproj\", \"NEXT\", 0, 0) > __version__:\n print(\"Unreleased!\")\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/exampleproj/_version.py",
"content": "# This file is auto-generated! Do not edit!\n# Use `python -m incremental.update exampleproj` to change this file.\n\nfrom incremental import Version\n__version__ = Version('exampleproj', 1, 2, 3)\n\n__all__ = [\"__version__\"]\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/gridfs/__init__.py",
"content": "# Copyright 2009-present MongoDB, Inc.\n#\n# Licensed under the Apache License, Version 2.0 (the \"License\");\n# you may not use this file except in compliance with the License.\n# You may obtain a copy of the License at\n#\n# http://www.apache.org/licenses/LICENSE-2.0\n#\n# Unless required by applicable law or agreed to in writing, software\n# distributed under the License is distributed on an \"AS IS\" BASIS,\n# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n# See the License for the specific language governing permissions and\n# limitations under the License.\n\n\"\"\"GridFS is a specification for storing large objects in Mongo.\n\nThe :mod:`gridfs` package is an implementation of GridFS on top of\n:mod:`pymongo`, exposing a file-like interface.\n\n.. mongodoc:: gridfs\n\"\"\"\n\nfrom bson.py3compat import abc\nfrom gridfs.errors import NoFile\nfrom gridfs.grid_file import (GridIn,\n GridOut,\n GridOutCursor,\n DEFAULT_CHUNK_SIZE,\n _clear_entity_type_registry)\nfrom pymongo import (ASCENDING,\n DESCENDING)\nfrom pymongo.common import UNAUTHORIZED_CODES, validate_string\nfrom pymongo.database import Database\nfrom pymongo.errors import ConfigurationError, OperationFailure\n\n\nclass GridFS(object):\n \"\"\"An instance of GridFS on top of a single Database.\n \"\"\"\n def __init__(self, database, collection=\"fs\", disable_md5=False):\n \"\"\"Create a new instance of :class:`GridFS`.\n\n Raises :class:`TypeError` if `database` is not an instance of\n :class:`~pymongo.database.Database`.\n\n :Parameters:\n - `database`: database to use\n - `collection` (optional): root collection to use\n - `disable_md5` (optional): When True, MD5 checksums will not be\n computed for uploaded files. Useful in environments where MD5\n cannot be used for regulatory or other reasons. Defaults to False.\n\n .. versionchanged:: 3.1\n Indexes are only ensured on the first write to the DB.\n\n .. versionchanged:: 3.0\n `database` must use an acknowledged\n :attr:`~pymongo.database.Database.write_concern`\n\n .. mongodoc:: gridfs\n \"\"\"\n if not isinstance(database, Database):\n raise TypeError(\"database must be an instance of Database\")\n\n database = _clear_entity_type_registry(database)\n\n if not database.write_concern.acknowledged:\n raise ConfigurationError('database must use '\n 'acknowledged write_concern')\n\n self.__database = database\n self.__collection = database[collection]\n self.__files = self.__collection.files\n self.__chunks = self.__collection.chunks\n self.__disable_md5 = disable_md5\n\n def new_file(self, **kwargs):\n \"\"\"Create a new file in GridFS.\n\n Returns a new :class:`~gridfs.grid_file.GridIn` instance to\n which data can be written. Any keyword arguments will be\n passed through to :meth:`~gridfs.grid_file.GridIn`.\n\n If the ``\"_id\"`` of the file is manually specified, it must\n not already exist in GridFS. Otherwise\n :class:`~gridfs.errors.FileExists` is raised.\n\n :Parameters:\n - `**kwargs` (optional): keyword arguments for file creation\n \"\"\"\n # No need for __ensure_index_files_id() here; GridIn ensures\n # the (files_id, n) index when needed.\n return GridIn(\n self.__collection, disable_md5=self.__disable_md5, **kwargs)\n\n def put(self, data, **kwargs):\n \"\"\"Put data in GridFS as a new file.\n\n Equivalent to doing::\n\n try:\n f = new_file(**kwargs)\n f.write(data)\n finally:\n f.close()\n\n `data` can be either an instance of :class:`str` (:class:`bytes`\n in python 3) or a file-like object providing a :meth:`read` method.\n If an `encoding` keyword argument is passed, `data` can also be a\n :class:`unicode` (:class:`str` in python 3) instance, which will\n be encoded as `encoding` before being written. Any keyword arguments\n will be passed through to the created file - see\n :meth:`~gridfs.grid_file.GridIn` for possible arguments. Returns the\n ``\"_id\"`` of the created file.\n\n If the ``\"_id\"`` of the file is manually specified, it must\n not already exist in GridFS. Otherwise\n :class:`~gridfs.errors.FileExists` is raised.\n\n :Parameters:\n - `data`: data to be written as a file.\n - `**kwargs` (optional): keyword arguments for file creation\n\n .. versionchanged:: 3.0\n w=0 writes to GridFS are now prohibited.\n \"\"\"\n grid_file = GridIn(\n self.__collection, disable_md5=self.__disable_md5, **kwargs)\n try:\n grid_file.write(data)\n finally:\n grid_file.close()\n\n return grid_file._id\n\n def get(self, file_id, session=None):\n \"\"\"Get a file from GridFS by ``\"_id\"``.\n\n Returns an instance of :class:`~gridfs.grid_file.GridOut`,\n which provides a file-like interface for reading.\n\n :Parameters:\n - `file_id`: ``\"_id\"`` of the file to get\n - `session` (optional): a\n :class:`~pymongo.client_session.ClientSession`\n\n .. versionchanged:: 3.6\n Added ``session`` parameter.\n \"\"\"\n gout = GridOut(self.__collection, file_id, session=session)\n\n # Raise NoFile now, instead of on first attribute access.\n gout._ensure_file()\n return gout\n\n def get_version(self, filename=None, version=-1, session=None, **kwargs):\n \"\"\"Get a file from GridFS by ``\"filename\"`` or metadata fields.\n\n Returns a version of the file in GridFS whose filename matches\n `filename` and whose metadata fields match the supplied keyword\n arguments, as an instance of :class:`~gridfs.grid_file.GridOut`.\n\n Version numbering is a convenience atop the GridFS API provided\n by MongoDB. If more than one file matches the query (either by\n `filename` alone, by metadata fields, or by a combination of\n both), then version ``-1`` will be the most recently uploaded\n matching file, ``-2`` the second most recently\n uploaded, etc. Version ``0`` will be the first version\n uploaded, ``1`` the second version, etc. So if three versions\n have been uploaded, then version ``0`` is the same as version\n ``-3``, version ``1`` is the same as version ``-2``, and\n version ``2`` is the same as version ``-1``.\n\n Raises :class:`~gridfs.errors.NoFile` if no such version of\n that file exists.\n\n :Parameters:\n - `filename`: ``\"filename\"`` of the file to get, or `None`\n - `version` (optional): version of the file to get (defaults\n to -1, the most recent version uploaded)\n - `session` (optional): a\n :class:`~pymongo.client_session.ClientSession`\n - `**kwargs` (optional): find files by custom metadata.\n\n .. versionchanged:: 3.6\n Added ``session`` parameter.\n\n .. versionchanged:: 3.1\n ``get_version`` no longer ensures indexes.\n \"\"\"\n query = kwargs\n if filename is not None:\n query[\"filename\"] = filename\n\n cursor = self.__files.find(query, session=session)\n if version < 0:\n skip = abs(version) - 1\n cursor.limit(-1).skip(skip).sort(\"uploadDate\", DESCENDING)\n else:\n cursor.limit(-1).skip(version).sort(\"uploadDate\", ASCENDING)\n try:\n doc = next(cursor)\n return GridOut(\n self.__collection, file_document=doc, session=session)\n except StopIteration:\n raise NoFile(\"no version %d for filename %r\" % (version, filename))\n\n def get_last_version(self, filename=None, session=None, **kwargs):\n \"\"\"Get the most recent version of a file in GridFS by ``\"filename\"``\n or metadata fields.\n\n Equivalent to calling :meth:`get_version` with the default\n `version` (``-1``).\n\n :Parameters:\n - `filename`: ``\"filename\"`` of the file to get, or `None`\n - `session` (optional): a\n :class:`~pymongo.client_session.ClientSession`\n - `**kwargs` (optional): find files by custom metadata.\n\n .. versionchanged:: 3.6\n Added ``session`` parameter.\n \"\"\"\n return self.get_version(filename=filename, session=session, **kwargs)\n\n # TODO add optional safe mode for chunk removal?\n def delete(self, file_id, session=None):\n \"\"\"Delete a file from GridFS by ``\"_id\"``.\n\n Deletes all data belonging to the file with ``\"_id\"``:\n `file_id`.\n\n .. warning:: Any processes/threads reading from the file while\n this method is executing will likely see an invalid/corrupt\n file. Care should be taken to avoid concurrent reads to a file\n while it is being deleted.\n\n .. note:: Deletes of non-existent files are considered successful\n since the end result is the same: no file with that _id remains.\n\n :Parameters:\n - `file_id`: ``\"_id\"`` of the file to delete\n - `session` (optional): a\n :class:`~pymongo.client_session.ClientSession`\n\n .. versionchanged:: 3.6\n Added ``session`` parameter.\n\n .. versionchanged:: 3.1\n ``delete`` no longer ensures indexes.\n \"\"\"\n self.__files.delete_one({\"_id\": file_id}, session=session)\n self.__chunks.delete_many({\"files_id\": file_id}, session=session)\n\n def list(self, session=None):\n \"\"\"List the names of all files stored in this instance of\n :class:`GridFS`.\n\n :Parameters:\n - `session` (optional): a\n :class:`~pymongo.client_session.ClientSession`\n\n .. versionchanged:: 3.6\n Added ``session`` parameter.\n\n .. versionchanged:: 3.1\n ``list`` no longer ensures indexes.\n \"\"\"\n # With an index, distinct includes documents with no filename\n # as None.\n return [\n name for name in self.__files.distinct(\"filename\", session=session)\n if name is not None]\n\n def find_one(self, filter=None, session=None, *args, **kwargs):\n \"\"\"Get a single file from gridfs.\n\n All arguments to :meth:`find` are also valid arguments for\n :meth:`find_one`, although any `limit` argument will be\n ignored. Returns a single :class:`~gridfs.grid_file.GridOut`,\n or ``None`` if no matching file is found. For example::\n\n file = fs.find_one({\"filename\": \"lisa.txt\"})\n\n :Parameters:\n - `filter` (optional): a dictionary specifying\n the query to be performing OR any other type to be used as\n the value for a query for ``\"_id\"`` in the file collection.\n - `*args` (optional): any additional positional arguments are\n the same as the arguments to :meth:`find`.\n - `session` (optional): a\n :class:`~pymongo.client_session.ClientSession`\n - `**kwargs` (optional): any additional keyword arguments\n are the same as the arguments to :meth:`find`.\n\n .. versionchanged:: 3.6\n Added ``session`` parameter.\n \"\"\"\n if filter is not None and not isinstance(filter, abc.Mapping):\n filter = {\"_id\": filter}\n\n for f in self.find(filter, *args, session=session, **kwargs):\n return f\n\n return None\n\n def find(self, *args, **kwargs):\n \"\"\"Query GridFS for files.\n\n Returns a cursor that iterates across files matching\n arbitrary queries on the files collection. Can be combined\n with other modifiers for additional control. For example::\n\n for grid_out in fs.find({\"filename\": \"lisa.txt\"},\n no_cursor_timeout=True):\n data = grid_out.read()\n\n would iterate through all versions of \"lisa.txt\" stored in GridFS.\n Note that setting no_cursor_timeout to True may be important to\n prevent the cursor from timing out during long multi-file processing\n work.\n\n As another example, the call::\n\n most_recent_three = fs.find().sort(\"uploadDate\", -1).limit(3)\n\n would return a cursor to the three most recently uploaded files\n in GridFS.\n\n Follows a similar interface to\n :meth:`~pymongo.collection.Collection.find`\n in :class:`~pymongo.collection.Collection`.\n\n If a :class:`~pymongo.client_session.ClientSession` is passed to\n :meth:`find`, all returned :class:`~gridfs.grid_file.GridOut` instances\n are associated with that session.\n\n :Parameters:\n - `filter` (optional): a SON object specifying elements which\n must be present for a document to be included in the\n result set\n - `skip` (optional): the number of files to omit (from\n the start of the result set) when returning the results\n - `limit` (optional): the maximum number of results to\n return\n - `no_cursor_timeout` (optional): if False (the default), any\n returned cursor is closed by the server after 10 minutes of\n inactivity. If set to True, the returned cursor will never\n time out on the server. Care should be taken to ensure that\n cursors with no_cursor_timeout turned on are properly closed.\n - `sort` (optional): a list of (key, direction) pairs\n specifying the sort order for this query. See\n :meth:`~pymongo.cursor.Cursor.sort` for details.\n\n Raises :class:`TypeError` if any of the arguments are of\n improper type. Returns an instance of\n :class:`~gridfs.grid_file.GridOutCursor`\n corresponding to this query.\n\n .. versionchanged:: 3.0\n Removed the read_preference, tag_sets, and\n secondary_acceptable_latency_ms options.\n .. versionadded:: 2.7\n .. mongodoc:: find\n \"\"\"\n return GridOutCursor(self.__collection, *args, **kwargs)\n\n def exists(self, document_or_id=None, session=None, **kwargs):\n \"\"\"Check if a file exists in this instance of :class:`GridFS`.\n\n The file to check for can be specified by the value of its\n ``_id`` key, or by passing in a query document. A query\n document can be passed in as dictionary, or by using keyword\n arguments. Thus, the following three calls are equivalent:\n\n >>> fs.exists(file_id)\n >>> fs.exists({\"_id\": file_id})\n >>> fs.exists(_id=file_id)\n\n As are the following two calls:\n\n >>> fs.exists({\"filename\": \"mike.txt\"})\n >>> fs.exists(filename=\"mike.txt\")\n\n And the following two:\n\n >>> fs.exists({\"foo\": {\"$gt\": 12}})\n >>> fs.exists(foo={\"$gt\": 12})\n\n Returns ``True`` if a matching file exists, ``False``\n otherwise. Calls to :meth:`exists` will not automatically\n create appropriate indexes; application developers should be\n sure to create indexes if needed and as appropriate.\n\n :Parameters:\n - `document_or_id` (optional): query document, or _id of the\n document to check for\n - `session` (optional): a\n :class:`~pymongo.client_session.ClientSession`\n - `**kwargs` (optional): keyword arguments are used as a\n query document, if they're present.\n\n .. versionchanged:: 3.6\n Added ``session`` parameter.\n \"\"\"\n if kwargs:\n f = self.__files.find_one(kwargs, [\"_id\"], session=session)\n else:\n f = self.__files.find_one(document_or_id, [\"_id\"], session=session)\n\n return f is not None\n\n\nclass GridFSBucket(object):\n \"\"\"An instance of GridFS on top of a single Database.\"\"\"\n\n def __init__(self, db, bucket_name=\"fs\",\n chunk_size_bytes=DEFAULT_CHUNK_SIZE, write_concern=None,\n read_preference=None, disable_md5=False):\n \"\"\"Create a new instance of :class:`GridFSBucket`.\n\n Raises :exc:`TypeError` if `database` is not an instance of\n :class:`~pymongo.database.Database`.\n\n Raises :exc:`~pymongo.errors.ConfigurationError` if `write_concern`\n is not acknowledged.\n\n :Parameters:\n - `database`: database to use.\n - `bucket_name` (optional): The name of the bucket. Defaults to 'fs'.\n - `chunk_size_bytes` (optional): The chunk size in bytes. Defaults\n to 255KB.\n - `write_concern` (optional): The\n :class:`~pymongo.write_concern.WriteConcern` to use. If ``None``\n (the default) db.write_concern is used.\n - `read_preference` (optional): The read preference to use. If\n ``None`` (the default) db.read_preference is used.\n - `disable_md5` (optional): When True, MD5 checksums will not be\n computed for uploaded files. Useful in environments where MD5\n cannot be used for regulatory or other reasons. Defaults to False.\n\n .. versionadded:: 3.1\n\n .. mongodoc:: gridfs\n \"\"\"\n if not isinstance(db, Database):\n raise TypeError(\"database must be an instance of Database\")\n\n db = _clear_entity_type_registry(db)\n\n wtc = write_concern if write_concern is not None else db.write_concern\n if not wtc.acknowledged:\n raise ConfigurationError('write concern must be acknowledged')\n\n self._db = db\n self._bucket_name = bucket_name\n self._collection = db[bucket_name]\n self._disable_md5 = disable_md5\n\n self._chunks = self._collection.chunks.with_options(\n write_concern=write_concern,\n read_preference=read_preference)\n\n self._files = self._collection.files.with_options(\n write_concern=write_concern,\n read_preference=read_preference)\n\n self._chunk_size_bytes = chunk_size_bytes\n\n def open_upload_stream(self, filename, chunk_size_bytes=None,\n metadata=None, session=None):\n \"\"\"Opens a Stream that the application can write the contents of the\n file to.\n\n The user must specify the filename, and can choose to add any\n additional information in the metadata field of the file document or\n modify the chunk size.\n For example::\n\n my_db = MongoClient().test\n fs = GridFSBucket(my_db)\n grid_in = fs.open_upload_stream(\n \"test_file\", chunk_size_bytes=4,\n metadata={\"contentType\": \"text/plain\"})\n grid_in.write(\"data I want to store!\")\n grid_in.close() # uploaded on close\n\n Returns an instance of :class:`~gridfs.grid_file.GridIn`.\n\n Raises :exc:`~gridfs.errors.NoFile` if no such version of\n that file exists.\n Raises :exc:`~ValueError` if `filename` is not a string.\n\n :Parameters:\n - `filename`: The name of the file to upload.\n - `chunk_size_bytes` (options): The number of bytes per chunk of this\n file. Defaults to the chunk_size_bytes in :class:`GridFSBucket`.\n - `metadata` (optional): User data for the 'metadata' field of the\n files collection document. If not provided the metadata field will\n be omitted from the files collection document.\n - `session` (optional): a\n :class:`~pymongo.client_session.ClientSession`\n\n .. versionchanged:: 3.6\n Added ``session`` parameter.\n \"\"\"\n validate_string(\"filename\", filename)\n\n opts = {\"filename\": filename,\n \"chunk_size\": (chunk_size_bytes if chunk_size_bytes\n is not None else self._chunk_size_bytes)}\n if metadata is not None:\n opts[\"metadata\"] = metadata\n\n return GridIn(\n self._collection,\n session=session,\n disable_md5=self._disable_md5,\n **opts)\n\n def open_upload_stream_with_id(\n self, file_id, filename, chunk_size_bytes=None, metadata=None,\n session=None):\n \"\"\"Opens a Stream that the application can write the contents of the\n file to.\n\n The user must specify the file id and filename, and can choose to add\n any additional information in the metadata field of the file document\n or modify the chunk size.\n For example::\n\n my_db = MongoClient().test\n fs = GridFSBucket(my_db)\n grid_in = fs.open_upload_stream_with_id(\n ObjectId(),\n \"test_file\",\n chunk_size_bytes=4,\n metadata={\"contentType\": \"text/plain\"})\n grid_in.write(\"data I want to store!\")\n grid_in.close() # uploaded on close\n\n Returns an instance of :class:`~gridfs.grid_file.GridIn`.\n\n Raises :exc:`~gridfs.errors.NoFile` if no such version of\n that file exists.\n Raises :exc:`~ValueError` if `filename` is not a string.\n\n :Parameters:\n - `file_id`: The id to use for this file. The id must not have\n already been used for another file.\n - `filename`: The name of the file to upload.\n - `chunk_size_bytes` (options): The number of bytes per chunk of this\n file. Defaults to the chunk_size_bytes in :class:`GridFSBucket`.\n - `metadata` (optional): User data for the 'metadata' field of the\n files collection document. If not provided the metadata field will\n be omitted from the files collection document.\n - `session` (optional): a\n :class:`~pymongo.client_session.ClientSession`\n\n .. versionchanged:: 3.6\n Added ``session`` parameter.\n \"\"\"\n validate_string(\"filename\", filename)\n\n opts = {\"_id\": file_id,\n \"filename\": filename,\n \"chunk_size\": (chunk_size_bytes if chunk_size_bytes\n is not None else self._chunk_size_bytes)}\n if metadata is not None:\n opts[\"metadata\"] = metadata\n\n return GridIn(\n self._collection,\n session=session,\n disable_md5=self._disable_md5,\n **opts)\n\n def upload_from_stream(self, filename, source, chunk_size_bytes=None,\n metadata=None, session=None):\n \"\"\"Uploads a user file to a GridFS bucket.\n\n Reads the contents of the user file from `source` and uploads\n it to the file `filename`. Source can be a string or file-like object.\n For example::\n\n my_db = MongoClient().test\n fs = GridFSBucket(my_db)\n file_id = fs.upload_from_stream(\n \"test_file\",\n \"data I want to store!\",\n chunk_size_bytes=4,\n metadata={\"contentType\": \"text/plain\"})\n\n Returns the _id of the uploaded file.\n\n Raises :exc:`~gridfs.errors.NoFile` if no such version of\n that file exists.\n Raises :exc:`~ValueError` if `filename` is not a string.\n\n :Parameters:\n - `filename`: The name of the file to upload.\n - `source`: The source stream of the content to be uploaded. Must be\n a file-like object that implements :meth:`read` or a string.\n - `chunk_size_bytes` (options): The number of bytes per chunk of this\n file. Defaults to the chunk_size_bytes of :class:`GridFSBucket`.\n - `metadata` (optional): User data for the 'metadata' field of the\n files collection document. If not provided the metadata field will\n be omitted from the files collection document.\n - `session` (optional): a\n :class:`~pymongo.client_session.ClientSession`\n\n .. versionchanged:: 3.6\n Added ``session`` parameter.\n \"\"\"\n with self.open_upload_stream(\n filename, chunk_size_bytes, metadata, session=session) as gin:\n gin.write(source)\n\n return gin._id\n\n def upload_from_stream_with_id(self, file_id, filename, source,\n chunk_size_bytes=None, metadata=None,\n session=None):\n \"\"\"Uploads a user file to a GridFS bucket with a custom file id.\n\n Reads the contents of the user file from `source` and uploads\n it to the file `filename`. Source can be a string or file-like object.\n For example::\n\n my_db = MongoClient().test\n fs = GridFSBucket(my_db)\n file_id = fs.upload_from_stream(\n ObjectId(),\n \"test_file\",\n \"data I want to store!\",\n chunk_size_bytes=4,\n metadata={\"contentType\": \"text/plain\"})\n\n Raises :exc:`~gridfs.errors.NoFile` if no such version of\n that file exists.\n Raises :exc:`~ValueError` if `filename` is not a string.\n\n :Parameters:\n - `file_id`: The id to use for this file. The id must not have\n already been used for another file.\n - `filename`: The name of the file to upload.\n - `source`: The source stream of the content to be uploaded. Must be\n a file-like object that implements :meth:`read` or a string.\n - `chunk_size_bytes` (options): The number of bytes per chunk of this\n file. Defaults to the chunk_size_bytes of :class:`GridFSBucket`.\n - `metadata` (optional): User data for the 'metadata' field of the\n files collection document. If not provided the metadata field will\n be omitted from the files collection document.\n - `session` (optional): a\n :class:`~pymongo.client_session.ClientSession`\n\n .. versionchanged:: 3.6\n Added ``session`` parameter.\n \"\"\"\n with self.open_upload_stream_with_id(\n file_id, filename, chunk_size_bytes, metadata,\n session=session) as gin:\n gin.write(source)\n\n def open_download_stream(self, file_id, session=None):\n \"\"\"Opens a Stream from which the application can read the contents of\n the stored file specified by file_id.\n\n For example::\n\n my_db = MongoClient().test\n fs = GridFSBucket(my_db)\n # get _id of file to read.\n file_id = fs.upload_from_stream(\"test_file\", \"data I want to store!\")\n grid_out = fs.open_download_stream(file_id)\n contents = grid_out.read()\n\n Returns an instance of :class:`~gridfs.grid_file.GridOut`.\n\n Raises :exc:`~gridfs.errors.NoFile` if no file with file_id exists.\n\n :Parameters:\n - `file_id`: The _id of the file to be downloaded.\n - `session` (optional): a\n :class:`~pymongo.client_session.ClientSession`\n\n .. versionchanged:: 3.6\n Added ``session`` parameter.\n \"\"\"\n gout = GridOut(self._collection, file_id, session=session)\n\n # Raise NoFile now, instead of on first attribute access.\n gout._ensure_file()\n return gout\n\n def download_to_stream(self, file_id, destination, session=None):\n \"\"\"Downloads the contents of the stored file specified by file_id and\n writes the contents to `destination`.\n\n For example::\n\n my_db = MongoClient().test\n fs = GridFSBucket(my_db)\n # Get _id of file to read\n file_id = fs.upload_from_stream(\"test_file\", \"data I want to store!\")\n # Get file to write to\n file = open('myfile','wb+')\n fs.download_to_stream(file_id, file)\n file.seek(0)\n contents = file.read()\n\n Raises :exc:`~gridfs.errors.NoFile` if no file with file_id exists.\n\n :Parameters:\n - `file_id`: The _id of the file to be downloaded.\n - `destination`: a file-like object implementing :meth:`write`.\n - `session` (optional): a\n :class:`~pymongo.client_session.ClientSession`\n\n .. versionchanged:: 3.6\n Added ``session`` parameter.\n \"\"\"\n with self.open_download_stream(file_id, session=session) as gout:\n for chunk in gout:\n destination.write(chunk)\n\n def delete(self, file_id, session=None):\n \"\"\"Given an file_id, delete this stored file's files collection document\n and associated chunks from a GridFS bucket.\n\n For example::\n\n my_db = MongoClient().test\n fs = GridFSBucket(my_db)\n # Get _id of file to delete\n file_id = fs.upload_from_stream(\"test_file\", \"data I want to store!\")\n fs.delete(file_id)\n\n Raises :exc:`~gridfs.errors.NoFile` if no file with file_id exists.\n\n :Parameters:\n - `file_id`: The _id of the file to be deleted.\n - `session` (optional): a\n :class:`~pymongo.client_session.ClientSession`\n\n .. versionchanged:: 3.6\n Added ``session`` parameter.\n \"\"\"\n res = self._files.delete_one({\"_id\": file_id}, session=session)\n self._chunks.delete_many({\"files_id\": file_id}, session=session)\n if not res.deleted_count:\n raise NoFile(\n \"no file could be deleted because none matched %s\" % file_id)\n\n def find(self, *args, **kwargs):\n \"\"\"Find and return the files collection documents that match ``filter``\n\n Returns a cursor that iterates across files matching\n arbitrary queries on the files collection. Can be combined\n with other modifiers for additional control.\n\n For example::\n\n for grid_data in fs.find({\"filename\": \"lisa.txt\"},\n no_cursor_timeout=True):\n data = grid_data.read()\n\n would iterate through all versions of \"lisa.txt\" stored in GridFS.\n Note that setting no_cursor_timeout to True may be important to\n prevent the cursor from timing out during long multi-file processing\n work.\n\n As another example, the call::\n\n most_recent_three = fs.find().sort(\"uploadDate\", -1).limit(3)\n\n would return a cursor to the three most recently uploaded files\n in GridFS.\n\n Follows a similar interface to\n :meth:`~pymongo.collection.Collection.find`\n in :class:`~pymongo.collection.Collection`.\n\n If a :class:`~pymongo.client_session.ClientSession` is passed to\n :meth:`find`, all returned :class:`~gridfs.grid_file.GridOut` instances\n are associated with that session.\n\n :Parameters:\n - `filter`: Search query.\n - `batch_size` (optional): The number of documents to return per\n batch.\n - `limit` (optional): The maximum number of documents to return.\n - `no_cursor_timeout` (optional): The server normally times out idle\n cursors after an inactivity period (10 minutes) to prevent excess\n memory use. Set this option to True prevent that.\n - `skip` (optional): The number of documents to skip before\n returning.\n - `sort` (optional): The order by which to sort results. Defaults to\n None.\n \"\"\"\n return GridOutCursor(self._collection, *args, **kwargs)\n\n def open_download_stream_by_name(self, filename, revision=-1, session=None):\n \"\"\"Opens a Stream from which the application can read the contents of\n `filename` and optional `revision`.\n\n For example::\n\n my_db = MongoClient().test\n fs = GridFSBucket(my_db)\n grid_out = fs.open_download_stream_by_name(\"test_file\")\n contents = grid_out.read()\n\n Returns an instance of :class:`~gridfs.grid_file.GridOut`.\n\n Raises :exc:`~gridfs.errors.NoFile` if no such version of\n that file exists.\n\n Raises :exc:`~ValueError` filename is not a string.\n\n :Parameters:\n - `filename`: The name of the file to read from.\n - `revision` (optional): Which revision (documents with the same\n filename and different uploadDate) of the file to retrieve.\n Defaults to -1 (the most recent revision).\n - `session` (optional): a\n :class:`~pymongo.client_session.ClientSession`\n\n :Note: Revision numbers are defined as follows:\n\n - 0 = the original stored file\n - 1 = the first revision\n - 2 = the second revision\n - etc...\n - -2 = the second most recent revision\n - -1 = the most recent revision\n\n .. versionchanged:: 3.6\n Added ``session`` parameter.\n \"\"\"\n validate_string(\"filename\", filename)\n\n query = {\"filename\": filename}\n\n cursor = self._files.find(query, session=session)\n if revision < 0:\n skip = abs(revision) - 1\n cursor.limit(-1).skip(skip).sort(\"uploadDate\", DESCENDING)\n else:\n cursor.limit(-1).skip(revision).sort(\"uploadDate\", ASCENDING)\n try:\n grid_file = next(cursor)\n return GridOut(\n self._collection, file_document=grid_file, session=session)\n except StopIteration:\n raise NoFile(\n \"no version %d for filename %r\" % (revision, filename))\n\n def download_to_stream_by_name(self, filename, destination, revision=-1,\n session=None):\n \"\"\"Write the contents of `filename` (with optional `revision`) to\n `destination`.\n\n For example::\n\n my_db = MongoClient().test\n fs = GridFSBucket(my_db)\n # Get file to write to\n file = open('myfile','wb')\n fs.download_to_stream_by_name(\"test_file\", file)\n\n Raises :exc:`~gridfs.errors.NoFile` if no such version of\n that file exists.\n\n Raises :exc:`~ValueError` if `filename` is not a string.\n\n :Parameters:\n - `filename`: The name of the file to read from.\n - `destination`: A file-like object that implements :meth:`write`.\n - `revision` (optional): Which revision (documents with the same\n filename and different uploadDate) of the file to retrieve.\n Defaults to -1 (the most recent revision).\n - `session` (optional): a\n :class:`~pymongo.client_session.ClientSession`\n\n :Note: Revision numbers are defined as follows:\n\n - 0 = the original stored file\n - 1 = the first revision\n - 2 = the second revision\n - etc...\n - -2 = the second most recent revision\n - -1 = the most recent revision\n\n .. versionchanged:: 3.6\n Added ``session`` parameter.\n \"\"\"\n with self.open_download_stream_by_name(\n filename, revision, session=session) as gout:\n for chunk in gout:\n destination.write(chunk)\n\n def rename(self, file_id, new_filename, session=None):\n \"\"\"Renames the stored file with the specified file_id.\n\n For example::\n\n my_db = MongoClient().test\n fs = GridFSBucket(my_db)\n # Get _id of file to rename\n file_id = fs.upload_from_stream(\"test_file\", \"data I want to store!\")\n fs.rename(file_id, \"new_test_name\")\n\n Raises :exc:`~gridfs.errors.NoFile` if no file with file_id exists.\n\n :Parameters:\n - `file_id`: The _id of the file to be renamed.\n - `new_filename`: The new name of the file.\n - `session` (optional): a\n :class:`~pymongo.client_session.ClientSession`\n\n .. versionchanged:: 3.6\n Added ``session`` parameter.\n \"\"\"\n result = self._files.update_one({\"_id\": file_id},\n {\"$set\": {\"filename\": new_filename}},\n session=session)\n if not result.matched_count:\n raise NoFile(\"no files could be renamed %r because none \"\n \"matched file_id %i\" % (new_filename, file_id))\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/gridfs/errors.py",
"content": "# Copyright 2009-2015 MongoDB, Inc.\n#\n# Licensed under the Apache License, Version 2.0 (the \"License\");\n# you may not use this file except in compliance with the License.\n# You may obtain a copy of the License at\n#\n# http://www.apache.org/licenses/LICENSE-2.0\n#\n# Unless required by applicable law or agreed to in writing, software\n# distributed under the License is distributed on an \"AS IS\" BASIS,\n# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n# See the License for the specific language governing permissions and\n# limitations under the License.\n\n\"\"\"Exceptions raised by the :mod:`gridfs` package\"\"\"\n\nfrom pymongo.errors import PyMongoError\n\n\nclass GridFSError(PyMongoError):\n \"\"\"Base class for all GridFS exceptions.\"\"\"\n\n\nclass CorruptGridFile(GridFSError):\n \"\"\"Raised when a file in :class:`~gridfs.GridFS` is malformed.\"\"\"\n\n\nclass NoFile(GridFSError):\n \"\"\"Raised when trying to read from a non-existent file.\"\"\"\n\n\nclass FileExists(GridFSError):\n \"\"\"Raised when trying to create a file that already exists.\"\"\"\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/gridfs/grid_file.py",
"content": "# Copyright 2009-present MongoDB, Inc.\n#\n# Licensed under the Apache License, Version 2.0 (the \"License\");\n# you may not use this file except in compliance with the License.\n# You may obtain a copy of the License at\n#\n# http://www.apache.org/licenses/LICENSE-2.0\n#\n# Unless required by applicable law or agreed to in writing, software\n# distributed under the License is distributed on an \"AS IS\" BASIS,\n# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n# See the License for the specific language governing permissions and\n# limitations under the License.\n\n\"\"\"Tools for representing files stored in GridFS.\"\"\"\nimport datetime\nimport hashlib\nimport io\nimport math\nimport os\n\nfrom bson.int64 import Int64\nfrom bson.son import SON\nfrom bson.binary import Binary\nfrom bson.objectid import ObjectId\nfrom bson.py3compat import text_type, StringIO\nfrom gridfs.errors import CorruptGridFile, FileExists, NoFile\nfrom pymongo import ASCENDING\nfrom pymongo.collection import Collection\nfrom pymongo.cursor import Cursor\nfrom pymongo.errors import (ConfigurationError,\n CursorNotFound,\n DuplicateKeyError,\n OperationFailure)\nfrom pymongo.read_preferences import ReadPreference\n\ntry:\n _SEEK_SET = os.SEEK_SET\n _SEEK_CUR = os.SEEK_CUR\n _SEEK_END = os.SEEK_END\n# before 2.5\nexcept AttributeError:\n _SEEK_SET = 0\n _SEEK_CUR = 1\n _SEEK_END = 2\n\nEMPTY = b\"\"\nNEWLN = b\"\\n\"\n\n\"\"\"Default chunk size, in bytes.\"\"\"\n# Slightly under a power of 2, to work well with server's record allocations.\nDEFAULT_CHUNK_SIZE = 255 * 1024\n\n_C_INDEX = SON([(\"files_id\", ASCENDING), (\"n\", ASCENDING)])\n_F_INDEX = SON([(\"filename\", ASCENDING), (\"uploadDate\", ASCENDING)])\n\n\ndef _grid_in_property(field_name, docstring, read_only=False,\n closed_only=False):\n \"\"\"Create a GridIn property.\"\"\"\n def getter(self):\n if closed_only and not self._closed:\n raise AttributeError(\"can only get %r on a closed file\" %\n field_name)\n # Protect against PHP-237\n if field_name == 'length':\n return self._file.get(field_name, 0)\n return self._file.get(field_name, None)\n\n def setter(self, value):\n if self._closed:\n self._coll.files.update_one({\"_id\": self._file[\"_id\"]},\n {\"$set\": {field_name: value}})\n self._file[field_name] = value\n\n if read_only:\n docstring += \"\\n\\nThis attribute is read-only.\"\n elif closed_only:\n docstring = \"%s\\n\\n%s\" % (docstring, \"This attribute is read-only and \"\n \"can only be read after :meth:`close` \"\n \"has been called.\")\n\n if not read_only and not closed_only:\n return property(getter, setter, doc=docstring)\n return property(getter, doc=docstring)\n\n\ndef _grid_out_property(field_name, docstring):\n \"\"\"Create a GridOut property.\"\"\"\n def getter(self):\n self._ensure_file()\n\n # Protect against PHP-237\n if field_name == 'length':\n return self._file.get(field_name, 0)\n return self._file.get(field_name, None)\n\n docstring += \"\\n\\nThis attribute is read-only.\"\n return property(getter, doc=docstring)\n\n\ndef _clear_entity_type_registry(entity, **kwargs):\n \"\"\"Clear the given database/collection object's type registry.\"\"\"\n codecopts = entity.codec_options.with_options(type_registry=None)\n return entity.with_options(codec_options=codecopts, **kwargs)\n\n\nclass GridIn(object):\n \"\"\"Class to write data to GridFS.\n \"\"\"\n def __init__(\n self, root_collection, session=None, disable_md5=False, **kwargs):\n \"\"\"Write a file to GridFS\n\n Application developers should generally not need to\n instantiate this class directly - instead see the methods\n provided by :class:`~gridfs.GridFS`.\n\n Raises :class:`TypeError` if `root_collection` is not an\n instance of :class:`~pymongo.collection.Collection`.\n\n Any of the file level options specified in the `GridFS Spec\n `_ may be passed as\n keyword arguments. Any additional keyword arguments will be\n set as additional fields on the file document. Valid keyword\n arguments include:\n\n - ``\"_id\"``: unique ID for this file (default:\n :class:`~bson.objectid.ObjectId`) - this ``\"_id\"`` must\n not have already been used for another file\n\n - ``\"filename\"``: human name for the file\n\n - ``\"contentType\"`` or ``\"content_type\"``: valid mime-type\n for the file\n\n - ``\"chunkSize\"`` or ``\"chunk_size\"``: size of each of the\n chunks, in bytes (default: 255 kb)\n\n - ``\"encoding\"``: encoding used for this file. In Python 2,\n any :class:`unicode` that is written to the file will be\n converted to a :class:`str`. In Python 3, any :class:`str`\n that is written to the file will be converted to\n :class:`bytes`.\n\n :Parameters:\n - `root_collection`: root collection to write to\n - `session` (optional): a\n :class:`~pymongo.client_session.ClientSession` to use for all\n commands\n - `disable_md5` (optional): When True, an MD5 checksum will not be\n computed for the uploaded file. Useful in environments where\n MD5 cannot be used for regulatory or other reasons. Defaults to\n False.\n - `**kwargs` (optional): file level options (see above)\n\n .. versionchanged:: 3.6\n Added ``session`` parameter.\n\n .. versionchanged:: 3.0\n `root_collection` must use an acknowledged\n :attr:`~pymongo.collection.Collection.write_concern`\n \"\"\"\n if not isinstance(root_collection, Collection):\n raise TypeError(\"root_collection must be an \"\n \"instance of Collection\")\n\n if not root_collection.write_concern.acknowledged:\n raise ConfigurationError('root_collection must use '\n 'acknowledged write_concern')\n\n # Handle alternative naming\n if \"content_type\" in kwargs:\n kwargs[\"contentType\"] = kwargs.pop(\"content_type\")\n if \"chunk_size\" in kwargs:\n kwargs[\"chunkSize\"] = kwargs.pop(\"chunk_size\")\n\n coll = _clear_entity_type_registry(\n root_collection, read_preference=ReadPreference.PRIMARY)\n\n if not disable_md5:\n kwargs[\"md5\"] = hashlib.md5()\n # Defaults\n kwargs[\"_id\"] = kwargs.get(\"_id\", ObjectId())\n kwargs[\"chunkSize\"] = kwargs.get(\"chunkSize\", DEFAULT_CHUNK_SIZE)\n object.__setattr__(self, \"_session\", session)\n object.__setattr__(self, \"_coll\", coll)\n object.__setattr__(self, \"_chunks\", coll.chunks)\n object.__setattr__(self, \"_file\", kwargs)\n object.__setattr__(self, \"_buffer\", StringIO())\n object.__setattr__(self, \"_position\", 0)\n object.__setattr__(self, \"_chunk_number\", 0)\n object.__setattr__(self, \"_closed\", False)\n object.__setattr__(self, \"_ensured_index\", False)\n\n def __create_index(self, collection, index_key, unique):\n doc = collection.find_one(projection={\"_id\": 1}, session=self._session)\n if doc is None:\n try:\n index_keys = [index_spec['key'] for index_spec in\n collection.list_indexes(session=self._session)]\n except OperationFailure:\n index_keys = []\n if index_key not in index_keys:\n collection.create_index(\n index_key.items(), unique=unique, session=self._session)\n\n def __ensure_indexes(self):\n if not object.__getattribute__(self, \"_ensured_index\"):\n self.__create_index(self._coll.files, _F_INDEX, False)\n self.__create_index(self._coll.chunks, _C_INDEX, True)\n object.__setattr__(self, \"_ensured_index\", True)\n\n def abort(self):\n \"\"\"Remove all chunks/files that may have been uploaded and close.\n \"\"\"\n self._coll.chunks.delete_many(\n {\"files_id\": self._file['_id']}, session=self._session)\n self._coll.files.delete_one(\n {\"_id\": self._file['_id']}, session=self._session)\n object.__setattr__(self, \"_closed\", True)\n\n @property\n def closed(self):\n \"\"\"Is this file closed?\n \"\"\"\n return self._closed\n\n _id = _grid_in_property(\"_id\", \"The ``'_id'`` value for this file.\",\n read_only=True)\n filename = _grid_in_property(\"filename\", \"Name of this file.\")\n name = _grid_in_property(\"filename\", \"Alias for `filename`.\")\n content_type = _grid_in_property(\"contentType\", \"Mime-type for this file.\")\n length = _grid_in_property(\"length\", \"Length (in bytes) of this file.\",\n closed_only=True)\n chunk_size = _grid_in_property(\"chunkSize\", \"Chunk size for this file.\",\n read_only=True)\n upload_date = _grid_in_property(\"uploadDate\",\n \"Date that this file was uploaded.\",\n closed_only=True)\n md5 = _grid_in_property(\"md5\", \"MD5 of the contents of this file \"\n \"if an md5 sum was created.\",\n closed_only=True)\n\n def __getattr__(self, name):\n if name in self._file:\n return self._file[name]\n raise AttributeError(\"GridIn object has no attribute '%s'\" % name)\n\n def __setattr__(self, name, value):\n # For properties of this instance like _buffer, or descriptors set on\n # the class like filename, use regular __setattr__\n if name in self.__dict__ or name in self.__class__.__dict__:\n object.__setattr__(self, name, value)\n else:\n # All other attributes are part of the document in db.fs.files.\n # Store them to be sent to server on close() or if closed, send\n # them now.\n self._file[name] = value\n if self._closed:\n self._coll.files.update_one({\"_id\": self._file[\"_id\"]},\n {\"$set\": {name: value}})\n\n def __flush_data(self, data):\n \"\"\"Flush `data` to a chunk.\n \"\"\"\n self.__ensure_indexes()\n if 'md5' in self._file:\n self._file['md5'].update(data)\n\n if not data:\n return\n assert(len(data) <= self.chunk_size)\n\n chunk = {\"files_id\": self._file[\"_id\"],\n \"n\": self._chunk_number,\n \"data\": Binary(data)}\n\n try:\n self._chunks.insert_one(chunk, session=self._session)\n except DuplicateKeyError:\n self._raise_file_exists(self._file['_id'])\n self._chunk_number += 1\n self._position += len(data)\n\n def __flush_buffer(self):\n \"\"\"Flush the buffer contents out to a chunk.\n \"\"\"\n self.__flush_data(self._buffer.getvalue())\n self._buffer.close()\n self._buffer = StringIO()\n\n def __flush(self):\n \"\"\"Flush the file to the database.\n \"\"\"\n try:\n self.__flush_buffer()\n\n if \"md5\" in self._file:\n self._file[\"md5\"] = self._file[\"md5\"].hexdigest()\n # The GridFS spec says length SHOULD be an Int64.\n self._file[\"length\"] = Int64(self._position)\n self._file[\"uploadDate\"] = datetime.datetime.utcnow()\n\n return self._coll.files.insert_one(\n self._file, session=self._session)\n except DuplicateKeyError:\n self._raise_file_exists(self._id)\n\n def _raise_file_exists(self, file_id):\n \"\"\"Raise a FileExists exception for the given file_id.\"\"\"\n raise FileExists(\"file with _id %r already exists\" % file_id)\n\n def close(self):\n \"\"\"Flush the file and close it.\n\n A closed file cannot be written any more. Calling\n :meth:`close` more than once is allowed.\n \"\"\"\n if not self._closed:\n self.__flush()\n object.__setattr__(self, \"_closed\", True)\n\n def read(self, size=-1):\n raise io.UnsupportedOperation('read')\n\n def readable(self):\n return False\n\n def seekable(self):\n return False\n\n def write(self, data):\n \"\"\"Write data to the file. There is no return value.\n\n `data` can be either a string of bytes or a file-like object\n (implementing :meth:`read`). If the file has an\n :attr:`encoding` attribute, `data` can also be a\n :class:`unicode` (:class:`str` in python 3) instance, which\n will be encoded as :attr:`encoding` before being written.\n\n Due to buffering, the data may not actually be written to the\n database until the :meth:`close` method is called. Raises\n :class:`ValueError` if this file is already closed. Raises\n :class:`TypeError` if `data` is not an instance of\n :class:`str` (:class:`bytes` in python 3), a file-like object,\n or an instance of :class:`unicode` (:class:`str` in python 3).\n Unicode data is only allowed if the file has an :attr:`encoding`\n attribute.\n\n :Parameters:\n - `data`: string of bytes or file-like object to be written\n to the file\n \"\"\"\n if self._closed:\n raise ValueError(\"cannot write to a closed file\")\n\n try:\n # file-like\n read = data.read\n except AttributeError:\n # string\n if not isinstance(data, (text_type, bytes)):\n raise TypeError(\"can only write strings or file-like objects\")\n if isinstance(data, text_type):\n try:\n data = data.encode(self.encoding)\n except AttributeError:\n raise TypeError(\"must specify an encoding for file in \"\n \"order to write %s\" % (text_type.__name__,))\n read = StringIO(data).read\n\n if self._buffer.tell() > 0:\n # Make sure to flush only when _buffer is complete\n space = self.chunk_size - self._buffer.tell()\n if space:\n try:\n to_write = read(space)\n except:\n self.abort()\n raise\n self._buffer.write(to_write)\n if len(to_write) < space:\n return # EOF or incomplete\n self.__flush_buffer()\n to_write = read(self.chunk_size)\n while to_write and len(to_write) == self.chunk_size:\n self.__flush_data(to_write)\n to_write = read(self.chunk_size)\n self._buffer.write(to_write)\n\n def writelines(self, sequence):\n \"\"\"Write a sequence of strings to the file.\n\n Does not add seperators.\n \"\"\"\n for line in sequence:\n self.write(line)\n\n def writeable(self):\n return True\n\n def __enter__(self):\n \"\"\"Support for the context manager protocol.\n \"\"\"\n return self\n\n def __exit__(self, exc_type, exc_val, exc_tb):\n \"\"\"Support for the context manager protocol.\n\n Close the file and allow exceptions to propagate.\n \"\"\"\n self.close()\n\n # propagate exceptions\n return False\n\n\nclass GridOut(object):\n \"\"\"Class to read data out of GridFS.\n \"\"\"\n def __init__(self, root_collection, file_id=None, file_document=None,\n session=None):\n \"\"\"Read a file from GridFS\n\n Application developers should generally not need to\n instantiate this class directly - instead see the methods\n provided by :class:`~gridfs.GridFS`.\n\n Either `file_id` or `file_document` must be specified,\n `file_document` will be given priority if present. Raises\n :class:`TypeError` if `root_collection` is not an instance of\n :class:`~pymongo.collection.Collection`.\n\n :Parameters:\n - `root_collection`: root collection to read from\n - `file_id` (optional): value of ``\"_id\"`` for the file to read\n - `file_document` (optional): file document from\n `root_collection.files`\n - `session` (optional): a\n :class:`~pymongo.client_session.ClientSession` to use for all\n commands\n\n .. versionchanged:: 3.8\n For better performance and to better follow the GridFS spec,\n :class:`GridOut` now uses a single cursor to read all the chunks in\n the file.\n\n .. versionchanged:: 3.6\n Added ``session`` parameter.\n\n .. versionchanged:: 3.0\n Creating a GridOut does not immediately retrieve the file metadata\n from the server. Metadata is fetched when first needed.\n \"\"\"\n if not isinstance(root_collection, Collection):\n raise TypeError(\"root_collection must be an \"\n \"instance of Collection\")\n\n root_collection = _clear_entity_type_registry(root_collection)\n\n self.__chunks = root_collection.chunks\n self.__files = root_collection.files\n self.__file_id = file_id\n self.__buffer = EMPTY\n self.__chunk_iter = None\n self.__position = 0\n self._file = file_document\n self._session = session\n\n _id = _grid_out_property(\"_id\", \"The ``'_id'`` value for this file.\")\n filename = _grid_out_property(\"filename\", \"Name of this file.\")\n name = _grid_out_property(\"filename\", \"Alias for `filename`.\")\n content_type = _grid_out_property(\"contentType\", \"Mime-type for this file.\")\n length = _grid_out_property(\"length\", \"Length (in bytes) of this file.\")\n chunk_size = _grid_out_property(\"chunkSize\", \"Chunk size for this file.\")\n upload_date = _grid_out_property(\"uploadDate\",\n \"Date that this file was first uploaded.\")\n aliases = _grid_out_property(\"aliases\", \"List of aliases for this file.\")\n metadata = _grid_out_property(\"metadata\", \"Metadata attached to this file.\")\n md5 = _grid_out_property(\"md5\", \"MD5 of the contents of this file \"\n \"if an md5 sum was created.\")\n\n def _ensure_file(self):\n if not self._file:\n self._file = self.__files.find_one({\"_id\": self.__file_id},\n session=self._session)\n if not self._file:\n raise NoFile(\"no file in gridfs collection %r with _id %r\" %\n (self.__files, self.__file_id))\n\n def __getattr__(self, name):\n self._ensure_file()\n if name in self._file:\n return self._file[name]\n raise AttributeError(\"GridOut object has no attribute '%s'\" % name)\n\n def readable(self):\n return True\n\n def readchunk(self):\n \"\"\"Reads a chunk at a time. If the current position is within a\n chunk the remainder of the chunk is returned.\n \"\"\"\n received = len(self.__buffer)\n chunk_data = EMPTY\n chunk_size = int(self.chunk_size)\n\n if received > 0:\n chunk_data = self.__buffer\n elif self.__position < int(self.length):\n chunk_number = int((received + self.__position) / chunk_size)\n if self.__chunk_iter is None:\n self.__chunk_iter = _GridOutChunkIterator(\n self, self.__chunks, self._session, chunk_number)\n\n chunk = self.__chunk_iter.next()\n chunk_data = chunk[\"data\"][self.__position % chunk_size:]\n\n if not chunk_data:\n raise CorruptGridFile(\"truncated chunk\")\n\n self.__position += len(chunk_data)\n self.__buffer = EMPTY\n return chunk_data\n\n def read(self, size=-1):\n \"\"\"Read at most `size` bytes from the file (less if there\n isn't enough data).\n\n The bytes are returned as an instance of :class:`str` (:class:`bytes`\n in python 3). If `size` is negative or omitted all data is read.\n\n :Parameters:\n - `size` (optional): the number of bytes to read\n\n .. versionchanged:: 3.8\n This method now only checks for extra chunks after reading the\n entire file. Previously, this method would check for extra chunks\n on every call.\n \"\"\"\n self._ensure_file()\n\n remainder = int(self.length) - self.__position\n if size < 0 or size > remainder:\n size = remainder\n\n if size == 0:\n return EMPTY\n\n received = 0\n data = StringIO()\n while received < size:\n chunk_data = self.readchunk()\n received += len(chunk_data)\n data.write(chunk_data)\n\n # Detect extra chunks after reading the entire file.\n if size == remainder and self.__chunk_iter:\n try:\n self.__chunk_iter.next()\n except StopIteration:\n pass\n\n self.__position -= received - size\n\n # Return 'size' bytes and store the rest.\n data.seek(size)\n self.__buffer = data.read()\n data.seek(0)\n return data.read(size)\n\n def readline(self, size=-1):\n \"\"\"Read one line or up to `size` bytes from the file.\n\n :Parameters:\n - `size` (optional): the maximum number of bytes to read\n \"\"\"\n remainder = int(self.length) - self.__position\n if size < 0 or size > remainder:\n size = remainder\n\n if size == 0:\n return EMPTY\n\n received = 0\n data = StringIO()\n while received < size:\n chunk_data = self.readchunk()\n pos = chunk_data.find(NEWLN, 0, size)\n if pos != -1:\n size = received + pos + 1\n\n received += len(chunk_data)\n data.write(chunk_data)\n if pos != -1:\n break\n\n self.__position -= received - size\n\n # Return 'size' bytes and store the rest.\n data.seek(size)\n self.__buffer = data.read()\n data.seek(0)\n return data.read(size)\n\n def tell(self):\n \"\"\"Return the current position of this file.\n \"\"\"\n return self.__position\n\n def seek(self, pos, whence=_SEEK_SET):\n \"\"\"Set the current position of this file.\n\n :Parameters:\n - `pos`: the position (or offset if using relative\n positioning) to seek to\n - `whence` (optional): where to seek\n from. :attr:`os.SEEK_SET` (``0``) for absolute file\n positioning, :attr:`os.SEEK_CUR` (``1``) to seek relative\n to the current position, :attr:`os.SEEK_END` (``2``) to\n seek relative to the file's end.\n \"\"\"\n if whence == _SEEK_SET:\n new_pos = pos\n elif whence == _SEEK_CUR:\n new_pos = self.__position + pos\n elif whence == _SEEK_END:\n new_pos = int(self.length) + pos\n else:\n raise IOError(22, \"Invalid value for `whence`\")\n\n if new_pos < 0:\n raise IOError(22, \"Invalid value for `pos` - must be positive\")\n\n # Optimization, continue using the same buffer and chunk iterator.\n if new_pos == self.__position:\n return\n\n self.__position = new_pos\n self.__buffer = EMPTY\n if self.__chunk_iter:\n self.__chunk_iter.close()\n self.__chunk_iter = None\n\n def seekable(self):\n return True\n\n def __iter__(self):\n \"\"\"Return an iterator over all of this file's data.\n\n The iterator will return chunk-sized instances of\n :class:`str` (:class:`bytes` in python 3). This can be\n useful when serving files using a webserver that handles\n such an iterator efficiently.\n\n .. note::\n This is different from :py:class:`io.IOBase` which iterates over\n *lines* in the file. Use :meth:`GridOut.readline` to read line by\n line instead of chunk by chunk.\n\n .. versionchanged:: 3.8\n The iterator now raises :class:`CorruptGridFile` when encountering\n any truncated, missing, or extra chunk in a file. The previous\n behavior was to only raise :class:`CorruptGridFile` on a missing\n chunk.\n \"\"\"\n return GridOutIterator(self, self.__chunks, self._session)\n\n def close(self):\n \"\"\"Make GridOut more generically file-like.\"\"\"\n if self.__chunk_iter:\n self.__chunk_iter.close()\n self.__chunk_iter = None\n\n def write(self, value):\n raise io.UnsupportedOperation('write')\n\n def __enter__(self):\n \"\"\"Makes it possible to use :class:`GridOut` files\n with the context manager protocol.\n \"\"\"\n return self\n\n def __exit__(self, exc_type, exc_val, exc_tb):\n \"\"\"Makes it possible to use :class:`GridOut` files\n with the context manager protocol.\n \"\"\"\n self.close()\n return False\n\n\nclass _GridOutChunkIterator(object):\n \"\"\"Iterates over a file's chunks using a single cursor.\n\n Raises CorruptGridFile when encountering any truncated, missing, or extra\n chunk in a file.\n \"\"\"\n def __init__(self, grid_out, chunks, session, next_chunk):\n self._id = grid_out._id\n self._chunk_size = int(grid_out.chunk_size)\n self._length = int(grid_out.length)\n self._chunks = chunks\n self._session = session\n self._next_chunk = next_chunk\n self._num_chunks = math.ceil(float(self._length) / self._chunk_size)\n self._cursor = None\n\n def expected_chunk_length(self, chunk_n):\n if chunk_n < self._num_chunks - 1:\n return self._chunk_size\n return self._length - (self._chunk_size * (self._num_chunks - 1))\n\n def __iter__(self):\n return self\n\n def _create_cursor(self):\n filter = {\"files_id\": self._id}\n if self._next_chunk > 0:\n filter[\"n\"] = {\"$gte\": self._next_chunk}\n self._cursor = self._chunks.find(filter, sort=[(\"n\", 1)],\n session=self._session)\n\n def _next_with_retry(self):\n \"\"\"Return the next chunk and retry once on CursorNotFound.\n\n We retry on CursorNotFound to maintain backwards compatibility in\n cases where two calls to read occur more than 10 minutes apart (the\n server's default cursor timeout).\n \"\"\"\n if self._cursor is None:\n self._create_cursor()\n\n try:\n return self._cursor.next()\n except CursorNotFound:\n self._cursor.close()\n self._create_cursor()\n return self._cursor.next()\n\n def next(self):\n try:\n chunk = self._next_with_retry()\n except StopIteration:\n if self._next_chunk >= self._num_chunks:\n raise\n raise CorruptGridFile(\"no chunk #%d\" % self._next_chunk)\n\n if chunk[\"n\"] != self._next_chunk:\n self.close()\n raise CorruptGridFile(\n \"Missing chunk: expected chunk #%d but found \"\n \"chunk with n=%d\" % (self._next_chunk, chunk[\"n\"]))\n\n if chunk[\"n\"] >= self._num_chunks:\n # According to spec, ignore extra chunks if they are empty.\n if len(chunk[\"data\"]):\n self.close()\n raise CorruptGridFile(\n \"Extra chunk found: expected %d chunks but found \"\n \"chunk with n=%d\" % (self._num_chunks, chunk[\"n\"]))\n\n expected_length = self.expected_chunk_length(chunk[\"n\"])\n if len(chunk[\"data\"]) != expected_length:\n self.close()\n raise CorruptGridFile(\n \"truncated chunk #%d: expected chunk length to be %d but \"\n \"found chunk with length %d\" % (\n chunk[\"n\"], expected_length, len(chunk[\"data\"])))\n\n self._next_chunk += 1\n return chunk\n\n __next__ = next\n\n def close(self):\n if self._cursor:\n self._cursor.close()\n self._cursor = None\n\n\nclass GridOutIterator(object):\n def __init__(self, grid_out, chunks, session):\n self.__chunk_iter = _GridOutChunkIterator(grid_out, chunks, session, 0)\n\n def __iter__(self):\n return self\n\n def next(self):\n chunk = self.__chunk_iter.next()\n return bytes(chunk[\"data\"])\n\n __next__ = next\n\n\nclass GridOutCursor(Cursor):\n \"\"\"A cursor / iterator for returning GridOut objects as the result\n of an arbitrary query against the GridFS files collection.\n \"\"\"\n def __init__(self, collection, filter=None, skip=0, limit=0,\n no_cursor_timeout=False, sort=None, batch_size=0,\n session=None):\n \"\"\"Create a new cursor, similar to the normal\n :class:`~pymongo.cursor.Cursor`.\n\n Should not be called directly by application developers - see\n the :class:`~gridfs.GridFS` method :meth:`~gridfs.GridFS.find` instead.\n\n .. versionadded 2.7\n\n .. mongodoc:: cursors\n \"\"\"\n collection = _clear_entity_type_registry(collection)\n\n # Hold on to the base \"fs\" collection to create GridOut objects later.\n self.__root_collection = collection\n\n super(GridOutCursor, self).__init__(\n collection.files, filter, skip=skip, limit=limit,\n no_cursor_timeout=no_cursor_timeout, sort=sort,\n batch_size=batch_size, session=session)\n\n def next(self):\n \"\"\"Get next GridOut object from cursor.\n \"\"\"\n # Work around \"super is not iterable\" issue in Python 3.x\n next_file = super(GridOutCursor, self).next()\n return GridOut(self.__root_collection, file_document=next_file,\n session=self.session)\n\n __next__ = next\n\n def add_option(self, *args, **kwargs):\n raise NotImplementedError(\"Method does not exist for GridOutCursor\")\n\n def remove_option(self, *args, **kwargs):\n raise NotImplementedError(\"Method does not exist for GridOutCursor\")\n\n def _clone_base(self, session):\n \"\"\"Creates an empty GridOutCursor for information to be copied into.\n \"\"\"\n return GridOutCursor(self.__root_collection, session=session)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/__init__.py",
"content": "from __future__ import absolute_import\nfrom hamcrest.core import *\nfrom hamcrest.library import *\n\n__version__ = \"1.9.0\"\n__author__ = \"Chris Rose\"\n__copyright__ = \"Copyright 2015 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/core/__init__.py",
"content": "from __future__ import absolute_import\nfrom hamcrest.core.assert_that import assert_that\nfrom hamcrest.core.core import *\n\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/core/assert_that.py",
"content": "from __future__ import absolute_import\nfrom hamcrest.core.matcher import Matcher\nfrom hamcrest.core.string_description import StringDescription\n\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n# unittest integration; hide these frames from tracebacks\n__unittest = True\n# py.test integration; hide these frames from tracebacks\n__tracebackhide__ = True\n\ndef assert_that(arg1, arg2=None, arg3=''):\n \"\"\"Asserts that actual value satisfies matcher. (Can also assert plain\n boolean condition.)\n\n :param actual: The object to evaluate as the actual value.\n :param matcher: The matcher to satisfy as the expected condition.\n :param reason: Optional explanation to include in failure description.\n\n ``assert_that`` passes the actual value to the matcher for evaluation. If\n the matcher is not satisfied, an exception is thrown describing the\n mismatch.\n\n ``assert_that`` is designed to integrate well with PyUnit and other unit\n testing frameworks. The exception raised for an unmet assertion is an\n :py:exc:`AssertionError`, which PyUnit reports as a test failure.\n\n With a different set of parameters, ``assert_that`` can also verify a\n boolean condition:\n\n .. function:: assert_that(assertion[, reason])\n\n :param assertion: Boolean condition to verify.\n :param reason: Optional explanation to include in failure description.\n\n This is equivalent to the :py:meth:`~unittest.TestCase.assertTrue` method\n of :py:class:`unittest.TestCase`, but offers greater flexibility in test\n writing by being a standalone function.\n\n \"\"\"\n if isinstance(arg2, Matcher):\n _assert_match(actual=arg1, matcher=arg2, reason=arg3)\n else:\n _assert_bool(assertion=arg1, reason=arg2)\n\n\ndef _assert_match(actual, matcher, reason):\n if not matcher.matches(actual):\n description = StringDescription()\n description.append_text(reason) \\\n .append_text('\\nExpected: ') \\\n .append_description_of(matcher) \\\n .append_text('\\n but: ')\n matcher.describe_mismatch(actual, description)\n description.append_text('\\n')\n raise AssertionError(description)\n\n\ndef _assert_bool(assertion, reason=None):\n if not assertion:\n if not reason:\n reason = 'Assertion failed'\n raise AssertionError(reason)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/core/base_description.py",
"content": "from __future__ import absolute_import\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\nimport warnings\nimport six\n\nfrom hamcrest.core.description import Description\nfrom hamcrest.core.selfdescribingvalue import SelfDescribingValue\nfrom hamcrest.core.helpers.hasmethod import hasmethod\n\nclass BaseDescription(Description):\n \"\"\"Base class for all :py:class:`~hamcrest.core.description.Description`\n implementations.\n\n \"\"\"\n\n def append_text(self, text):\n self.append(text)\n return self\n\n def append_description_of(self, value):\n if hasmethod(value, 'describe_to'):\n value.describe_to(self)\n elif six.PY3 and isinstance(value, six.text_type):\n self.append(repr(value))\n elif six.PY2 and isinstance(value, six.binary_type):\n self.append_string_in_python_syntax(value)\n elif isinstance(value, six.text_type):\n self.append_string_in_python_syntax(value)\n else:\n description = str(value)\n if description[:1] == '<' and description[-1:] == '>':\n self.append(description)\n else:\n self.append('<')\n self.append(description)\n self.append('>')\n return self\n\n def append_value(self, value):\n warnings.warn('Call append_description_of instead of append_value',\n DeprecationWarning)\n if isinstance(value, str):\n self.append_string_in_python_syntax(value)\n else:\n self.append('<')\n self.append(str(value))\n self.append('>')\n return self\n\n def append_value_list(self, start, separator, end, list):\n warnings.warn('Call append_list instead of append_value_list',\n DeprecationWarning)\n return self.append_list(start, separator, end,\n map(SelfDescribingValue, list))\n\n def append_list(self, start, separator, end, list):\n separate = False\n\n self.append(start)\n for item in list:\n if separate:\n self.append(separator)\n self.append_description_of(item)\n separate = True\n self.append(end)\n return self\n\n def append(self, string):\n \"\"\"Append the string to the description.\"\"\"\n raise NotImplementedError('append')\n\n def append_string_in_python_syntax(self, string):\n self.append(\"'\")\n for ch in string:\n self.append(character_in_python_syntax(ch))\n self.append(\"'\")\n\n\ndef character_in_python_syntax(ch):\n if ch == \"'\":\n return \"\\'\"\n elif ch == '\\n':\n return '\\\\n'\n elif ch == '\\r':\n return '\\\\r'\n elif ch == '\\t':\n return '\\\\t'\n else:\n return ch\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/core/base_matcher.py",
"content": "from __future__ import absolute_import\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\nfrom hamcrest.core.matcher import Matcher\nfrom hamcrest.core.string_description import tostring\n\n\nclass BaseMatcher(Matcher):\n \"\"\"Base class for all :py:class:`~hamcrest.core.matcher.Matcher`\n implementations.\n\n Most implementations can just implement :py:obj:`_matches`, leaving the\n handling of any mismatch description to the ``matches`` method. But if it\n makes more sense to generate the mismatch description during the matching,\n override :py:meth:`~hamcrest.core.matcher.Matcher.matches` instead.\n\n \"\"\"\n\n def __str__(self):\n return tostring(self)\n\n def _matches(self, item):\n raise NotImplementedError('_matches')\n\n def matches(self, item, mismatch_description=None):\n match_result = self._matches(item)\n if not match_result and mismatch_description:\n self.describe_mismatch(item, mismatch_description)\n return match_result\n\n def describe_mismatch(self, item, mismatch_description):\n mismatch_description.append_text('was ').append_description_of(item)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/core/compat.py",
"content": "__author__ = \"Per Fagrell\"\n__copyright__ = \"Copyright 2013 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\n__all__ = ['is_callable']\n\nimport sys\n\n# callable was not part of py3k until 3.2, so we create this\n# generic is_callable to use callable if possible, otherwise\n# we use generic homebrew.\nif sys.version_info[0] == 3 and sys.version_info[1] < 2:\n def is_callable(function):\n \"\"\"Return whether the object is callable (i.e., some kind of function).\"\"\"\n if function is None:\n return False\n return any(\"__call__\" in klass.__dict__ for klass in type(function).__mro__)\nelse:\n is_callable = callable\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/core/core/__init__.py",
"content": "from __future__ import absolute_import\n\"\"\"Fundamental matchers of objects and values, and composite matchers.\"\"\"\n\nfrom hamcrest.core.core.allof import all_of\nfrom hamcrest.core.core.anyof import any_of\nfrom hamcrest.core.core.described_as import described_as\nfrom hamcrest.core.core.is_ import is_\nfrom hamcrest.core.core.isanything import anything\nfrom hamcrest.core.core.isequal import equal_to\nfrom hamcrest.core.core.isinstanceof import instance_of\nfrom hamcrest.core.core.isnone import none, not_none\nfrom hamcrest.core.core.isnot import is_not, not_\nfrom hamcrest.core.core.issame import same_instance\nfrom hamcrest.core.core.raises import calling, raises\n\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/core/core/allof.py",
"content": "from hamcrest.core.base_matcher import BaseMatcher\nfrom hamcrest.core.helpers.wrap_matcher import wrap_matcher\n\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\n\nclass AllOf(BaseMatcher):\n\n def __init__(self, *matchers):\n self.matchers = matchers\n\n def matches(self, item, mismatch_description=None):\n for matcher in self.matchers:\n if not matcher.matches(item):\n if mismatch_description:\n mismatch_description.append_description_of(matcher) \\\n .append_text(' ')\n matcher.describe_mismatch(item, mismatch_description)\n return False\n return True\n\n def describe_mismatch(self, item, mismatch_description):\n self.matches(item, mismatch_description)\n\n def describe_to(self, description):\n description.append_list('(', ' and ', ')', self.matchers)\n\n\ndef all_of(*items):\n \"\"\"Matches if all of the given matchers evaluate to ``True``.\n\n :param matcher1,...: A comma-separated list of matchers.\n\n The matchers are evaluated from left to right using short-circuit\n evaluation, so evaluation stops as soon as a matcher returns ``False``.\n\n Any argument that is not a matcher is implicitly wrapped in an\n :py:func:`~hamcrest.core.core.isequal.equal_to` matcher to check for\n equality.\n\n \"\"\"\n return AllOf(*[wrap_matcher(item) for item in items])\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/core/core/anyof.py",
"content": "from hamcrest.core.base_matcher import BaseMatcher\nfrom hamcrest.core.helpers.wrap_matcher import wrap_matcher\n\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\n\nclass AnyOf(BaseMatcher):\n\n def __init__(self, *matchers):\n self.matchers = matchers\n\n def _matches(self, item):\n for matcher in self.matchers:\n if matcher.matches(item):\n return True\n return False\n\n def describe_to(self, description):\n description.append_list('(', ' or ', ')', self.matchers)\n\n\ndef any_of(*items):\n \"\"\"Matches if any of the given matchers evaluate to ``True``.\n\n :param matcher1,...: A comma-separated list of matchers.\n\n The matchers are evaluated from left to right using short-circuit\n evaluation, so evaluation stops as soon as a matcher returns ``True``.\n\n Any argument that is not a matcher is implicitly wrapped in an\n :py:func:`~hamcrest.core.core.isequal.equal_to` matcher to check for\n equality.\n\n \"\"\"\n return AnyOf(*[wrap_matcher(item) for item in items])\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/core/core/described_as.py",
"content": "from hamcrest.core.base_matcher import BaseMatcher\nimport re\n\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\n\nARG_PATTERN = re.compile('%([0-9]+)')\n\n\nclass DescribedAs(BaseMatcher):\n\n def __init__(self, description_template, matcher, *values):\n self.template = description_template\n self.matcher = matcher\n self.values = values\n\n def matches(self, item, mismatch_description=None):\n return self.matcher.matches(item, mismatch_description)\n\n def describe_mismatch(self, item, mismatch_description):\n self.matcher.describe_mismatch(item, mismatch_description)\n\n def describe_to(self, description):\n text_start = 0\n for match in re.finditer(ARG_PATTERN, self.template):\n description.append_text(self.template[text_start:match.start()])\n arg_index = int(match.group()[1:])\n description.append_description_of(self.values[arg_index])\n text_start = match.end()\n\n if text_start < len(self.template):\n description.append_text(self.template[text_start:])\n\n\ndef described_as(description, matcher, *values):\n \"\"\"Adds custom failure description to a given matcher.\n\n :param description: Overrides the matcher's description.\n :param matcher: The matcher to satisfy.\n :param value1,...: Optional comma-separated list of substitution values.\n\n The description may contain substitution placeholders %0, %1, etc. These\n will be replaced by any values that follow the matcher.\n\n \"\"\"\n return DescribedAs(description, matcher, *values)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/core/core/is_.py",
"content": "from __future__ import absolute_import\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\nfrom hamcrest.core.base_matcher import BaseMatcher\nfrom hamcrest.core.helpers.wrap_matcher import wrap_matcher, is_matchable_type\nfrom .isinstanceof import instance_of\n\n\nclass Is(BaseMatcher):\n\n def __init__(self, matcher):\n self.matcher = matcher\n\n def matches(self, item, mismatch_description=None):\n return self.matcher.matches(item, mismatch_description)\n\n def describe_mismatch(self, item, mismatch_description):\n return self.matcher.describe_mismatch(item, mismatch_description)\n\n def describe_to(self, description):\n description.append_description_of(self.matcher)\n\n\ndef wrap_value_or_type(x):\n if is_matchable_type(x):\n return instance_of(x)\n else:\n return wrap_matcher(x)\n\n\ndef is_(x):\n \"\"\"Decorates another matcher, or provides shortcuts to the frequently used\n ``is(equal_to(x))`` and ``is(instance_of(x))``.\n\n :param x: The matcher to satisfy, or a type for\n :py:func:`~hamcrest.core.core.isinstanceof.instance_of` matching, or an\n expected value for :py:func:`~hamcrest.core.core.isequal.equal_to`\n matching.\n\n This matcher compares the evaluated object to the given matcher.\n\n .. note::\n\n PyHamcrest's ``is_`` matcher is unrelated to Python's ``is`` operator.\n The matcher for object identity is\n :py:func:`~hamcrest.core.core.issame.same_instance`.\n\n If the ``x`` argument is a matcher, its behavior is retained, but the test\n may be more expressive. For example::\n\n assert_that(value, less_than(5))\n assert_that(value, is_(less_than(5)))\n\n If the ``x`` argument is a type, it is wrapped in an\n :py:func:`~hamcrest.core.core.isinstanceof.instance_of` matcher. This makes\n the following statements equivalent::\n\n assert_that(cheese, instance_of(Cheddar))\n assert_that(cheese, is_(instance_of(Cheddar)))\n assert_that(cheese, is_(Cheddar))\n\n Otherwise, if the ``x`` argument is not a matcher, it is wrapped in an\n :py:func:`~hamcrest.core.core.isequal.equal_to` matcher. This makes the\n following statements equivalent::\n\n assert_that(cheese, equal_to(smelly))\n assert_that(cheese, is_(equal_to(smelly)))\n assert_that(cheese, is_(smelly))\n\n Choose the style that makes your expression most readable. This will vary\n depending on context.\n\n \"\"\"\n return Is(wrap_value_or_type(x))\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/core/core/isanything.py",
"content": "from hamcrest.core.base_matcher import BaseMatcher\n\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\n\nclass IsAnything(BaseMatcher):\n\n def __init__(self, description):\n self.description = description\n if not description:\n self.description = 'ANYTHING'\n\n def _matches(self, item):\n return True\n\n def describe_to(self, description):\n description.append_text(self.description)\n\n\ndef anything(description=None):\n \"\"\"Matches anything.\n\n :param description: Optional string used to describe this matcher.\n\n This matcher always evaluates to ``True``. Specify this in composite\n matchers when the value of a particular element is unimportant.\n\n \"\"\"\n return IsAnything(description)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/core/core/isequal.py",
"content": "__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\nfrom hamcrest.core.base_matcher import BaseMatcher\nfrom hamcrest.core.matcher import Matcher\n\n\nclass IsEqual(BaseMatcher):\n\n def __init__(self, equals):\n self.object = equals\n\n def _matches(self, item):\n return item == self.object\n\n def describe_to(self, description):\n nested_matcher = isinstance(self.object, Matcher)\n if nested_matcher:\n description.append_text('<')\n description.append_description_of(self.object)\n if nested_matcher:\n description.append_text('>')\n\n\ndef equal_to(obj):\n \"\"\"Matches if object is equal to a given object.\n\n :param obj: The object to compare against as the expected value.\n\n This matcher compares the evaluated object to ``obj`` for equality.\"\"\"\n return IsEqual(obj)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/core/core/isinstanceof.py",
"content": "from hamcrest.core.base_matcher import BaseMatcher\nfrom hamcrest.core.helpers.wrap_matcher import is_matchable_type\n\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\nimport types\n\nclass IsInstanceOf(BaseMatcher):\n\n def __init__(self, expected_type):\n if not is_matchable_type(expected_type):\n raise TypeError('IsInstanceOf requires type or a tuple of classes and types')\n self.expected_type = expected_type\n\n def _matches(self, item):\n return isinstance(item, self.expected_type)\n\n def describe_to(self, description):\n try:\n type_description = self.expected_type.__name__\n except AttributeError:\n type_description = \"one of %s\" % \",\".join(str(e) for e in self.expected_type)\n description.append_text('an instance of ') \\\n .append_text(type_description)\n\n\ndef instance_of(atype):\n \"\"\"Matches if object is an instance of, or inherits from, a given type.\n\n :param atype: The type to compare against as the expected type or a tuple\n of types.\n\n This matcher checks whether the evaluated object is an instance of\n ``atype`` or an instance of any class that inherits from ``atype``.\n\n Example::\n\n instance_of(str)\n\n \"\"\"\n return IsInstanceOf(atype)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/core/core/isnone.py",
"content": "from __future__ import absolute_import\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\nfrom hamcrest.core.base_matcher import BaseMatcher\nfrom .isnot import is_not\n\n\nclass IsNone(BaseMatcher):\n\n def _matches(self, item):\n return item is None\n\n def describe_to(self, description):\n description.append_text('None')\n\n\ndef none():\n \"\"\"Matches if object is ``None``.\"\"\"\n return IsNone()\n\n\ndef not_none():\n \"\"\"Matches if object is not ``None``.\"\"\"\n return is_not(none())\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/core/core/isnot.py",
"content": "from __future__ import absolute_import\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\nfrom hamcrest.core.base_matcher import BaseMatcher, Matcher\nfrom hamcrest.core.helpers.wrap_matcher import wrap_matcher, is_matchable_type\nfrom .isequal import equal_to\nfrom .isinstanceof import instance_of\n\n\nclass IsNot(BaseMatcher):\n\n def __init__(self, matcher):\n self.matcher = matcher\n\n def _matches(self, item):\n return not self.matcher.matches(item)\n\n def describe_to(self, description):\n description.append_text('not ').append_description_of(self.matcher)\n\n\ndef wrap_value_or_type(x):\n if is_matchable_type(x):\n return instance_of(x)\n else:\n return wrap_matcher(x)\n\n\ndef is_not(match):\n \"\"\"Inverts the given matcher to its logical negation.\n\n :param match: The matcher to negate.\n\n This matcher compares the evaluated object to the negation of the given\n matcher. If the ``match`` argument is not a matcher, it is implicitly\n wrapped in an :py:func:`~hamcrest.core.core.isequal.equal_to` matcher to\n check for equality, and thus matches for inequality.\n\n Examples::\n\n assert_that(cheese, is_not(equal_to(smelly)))\n assert_that(cheese, is_not(smelly))\n\n \"\"\"\n return IsNot(wrap_value_or_type(match))\n\ndef not_(match):\n \"\"\"Alias of :py:func:`is_not` for better readability of negations.\n\n Examples::\n\n assert_that(alist, not_(has_item(item)))\n\n \"\"\"\n return is_not(match)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/core/core/issame.py",
"content": "__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\nfrom hamcrest.core.base_matcher import BaseMatcher\n\n\nclass IsSame(BaseMatcher):\n\n def __init__(self, object):\n self.object = object\n\n def _matches(self, item):\n return item is self.object\n\n def describe_to(self, description):\n description.append_text('same instance as ') \\\n .append_text(hex(id(self.object))) \\\n .append_text(' ') \\\n .append_description_of(self.object)\n\n def describe_mismatch(self, item, mismatch_description):\n mismatch_description.append_text('was ')\n if item is not None:\n mismatch_description.append_text(hex(id(item))) \\\n .append_text(' ')\n mismatch_description.append_description_of(item)\n\n\ndef same_instance(obj):\n \"\"\"Matches if evaluated object is the same instance as a given object.\n\n :param obj: The object to compare against as the expected value.\n\n This matcher invokes the ``is`` identity operator to determine if the\n evaluated object is the the same object as ``obj``.\n\n \"\"\"\n return IsSame(obj)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/core/core/raises.py",
"content": "from weakref import ref\nimport re\nimport sys\nfrom hamcrest.core.base_matcher import BaseMatcher\nfrom hamcrest.core.compat import is_callable\n\n__author__ = \"Per Fagrell\"\n__copyright__ = \"Copyright 2013 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\n\nclass Raises(BaseMatcher):\n def __init__(self, expected, pattern=None):\n self.pattern = pattern\n self.expected = expected\n self.actual = None\n self.function = None\n\n def _matches(self, function):\n if not is_callable(function):\n return False\n\n self.function = ref(function)\n return self._call_function(function)\n\n def _call_function(self, function):\n self.actual = None\n try:\n function()\n except Exception:\n self.actual = sys.exc_info()[1]\n\n if isinstance(self.actual, self.expected):\n if self.pattern is not None:\n return re.search(self.pattern, str(self.actual)) is not None\n return True\n return False\n\n def describe_to(self, description):\n description.append_text('Expected a callable raising %s' % self.expected)\n\n def describe_mismatch(self, item, description):\n if not is_callable(item):\n description.append_text('%s is not callable' % item)\n return\n\n function = None if self.function is None else self.function()\n if function is None or function is not item:\n self.function = ref(item)\n if not self._call_function(item):\n return\n\n if self.actual is None:\n description.append_text('No exception raised.')\n elif isinstance(self.actual, self.expected) and self.pattern is not None:\n description.append_text('Correct assertion type raised, but the expected pattern (\"%s\") not found.' % self.pattern)\n description.append_text('\\n message was: \"%s\"' % str(self.actual))\n else:\n description.append_text('%s was raised instead' % type(self.actual))\n\n\ndef raises(exception, pattern=None):\n \"\"\"Matches if the called function raised the expected exception.\n\n :param exception: The class of the expected exception\n :param pattern: Optional regular expression to match exception message.\n\n Expects the actual to be wrapped by using :py:func:`~hamcrest.core.core.raises.calling`,\n or a callable taking no arguments.\n Optional argument pattern should be a string containing a regular expression. If provided,\n the string representation of the actual exception - e.g. `str(actual)` - must match pattern.\n\n Examples::\n\n assert_that(calling(int).with_args('q'), raises(TypeError))\n assert_that(calling(parse, broken_input), raises(ValueError))\n \"\"\"\n return Raises(exception, pattern)\n\n\nclass DeferredCallable(object):\n def __init__(self, func):\n self.func = func\n self.args = tuple()\n self.kwargs = {}\n\n def __call__(self):\n return self.func(*self.args, **self.kwargs)\n\n def with_args(self, *args, **kwargs):\n self.args = args\n self.kwargs = kwargs\n return self\n\n\ndef calling(func):\n \"\"\"Wrapper for function call that delays the actual execution so that\n :py:func:`~hamcrest.core.core.raises.raises` matcher can catch any thrown exception.\n\n :param func: The function or method to be called\n\n The arguments can be provided with a call to the `with_args` function on the returned\n object::\n\n calling(my_method).with_args(arguments, and_='keywords')\n \"\"\"\n return DeferredCallable(func)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/core/description.py",
"content": "__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\n\nclass Description(object):\n \"\"\"A description of a :py:class:`~hamcrest.core.matcher.Matcher`.\n\n A :py:class:`~hamcrest.core.matcher.Matcher` will describe itself to a\n description which can later be used for reporting.\n\n \"\"\"\n\n def append_text(self, text):\n \"\"\"Appends some plain text to the description.\n\n :returns: ``self``, for chaining\n\n \"\"\"\n raise NotImplementedError('append_text')\n\n def append_description_of(self, value):\n \"\"\"Appends description of given value to this description.\n\n If the value implements\n :py:meth:`~hamcrest.core.selfdescribing.SelfDescribing.describe_to`,\n then it will be used.\n\n :returns: ``self``, for chaining\n\n \"\"\"\n raise NotImplementedError('append_description_of')\n\n def append_value(self, value):\n \"\"\"Appends an arbitary value to the description.\n\n **Deprecated:** Call\n :py:meth:`~hamcrest.core.description.Description.append_description_of`\n instead.\n\n :returns: ``self``, for chaining\n\n \"\"\"\n raise NotImplementedError('append_value')\n\n def append_list(self, start, separator, end, list):\n \"\"\"Appends a list of objects to the description.\n\n :param start: String that will begin the list description.\n :param separator: String that will separate each object in the\n description.\n :param end: String that will end the list description.\n :param list: List of objects to be described.\n\n :returns: ``self``, for chaining\n\n \"\"\"\n raise NotImplementedError('append_list')\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/core/helpers/__init__.py",
"content": "\"\"\"Utilities for writing Matchers.\"\"\"\n\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/core/helpers/hasmethod.py",
"content": "__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\n\ndef hasmethod(obj, methodname):\n \"\"\"Does ``obj`` have a method named ``methodname``?\"\"\"\n\n if not hasattr(obj, methodname):\n return False\n method = getattr(obj, methodname)\n return callable(method)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/core/helpers/wrap_matcher.py",
"content": "import six\n\nfrom hamcrest.core.base_matcher import Matcher\nfrom hamcrest.core.core.isequal import equal_to\n\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\nimport types\n\ndef wrap_matcher(x):\n \"\"\"Wraps argument in a matcher, if necessary.\n\n :returns: the argument as-is if it is already a matcher, otherwise wrapped\n in an :py:func:`~hamcrest.core.core.isequal.equal_to` matcher.\n\n \"\"\"\n if isinstance(x, Matcher):\n return x\n else:\n return equal_to(x)\n\ndef is_matchable_type(expected_type):\n if isinstance(expected_type, type):\n return True\n\n if isinstance(expected_type, six.class_types):\n return True\n\n if isinstance(expected_type, tuple) and \\\n expected_type and \\\n all(map(is_matchable_type, expected_type)):\n return True\n\n return False\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/core/matcher.py",
"content": "from __future__ import absolute_import\nfrom .selfdescribing import SelfDescribing\n\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\n\nclass Matcher(SelfDescribing):\n \"\"\"A matcher over acceptable values.\n\n A matcher is able to describe itself to give feedback when it fails.\n\n Matcher implementations should *not* directly implement this protocol.\n Instead, *extend* the :py:class:`~hamcrest.core.base_matcher.BaseMatcher`\n class, which will ensure that the\n :py:class:`~hamcrest.core.matcher.Matcher` API can grow to support new\n features and remain compatible with all\n :py:class:`~hamcrest.core.matcher.Matcher` implementations.\n\n \"\"\"\n\n def matches(self, item, mismatch_description=None):\n \"\"\"Evaluates the matcher for argument item.\n\n If a mismatch is detected and argument ``mismatch_description`` is\n provided, it will generate a description of why the matcher has not\n accepted the item.\n\n :param item: The object against which the matcher is evaluated.\n :returns: ``True`` if ``item`` matches, otherwise ``False``.\n\n \"\"\"\n raise NotImplementedError('matches')\n\n def describe_mismatch(self, item, mismatch_description):\n \"\"\"Generates a description of why the matcher has not accepted the\n item.\n\n The description will be part of a larger description of why a matching\n failed, so it should be concise.\n\n This method assumes that ``matches(item)`` is ``False``, but will not\n check this.\n\n :param item: The item that the\n :py:class:`~hamcrest.core.matcher.Matcher` has rejected.\n :param mismatch_description: The description to be built or appended\n to.\n\n \"\"\"\n raise NotImplementedError('describe_mismatch')\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/core/selfdescribing.py",
"content": "__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\n\nclass SelfDescribing(object):\n \"\"\"The ability of an object to describe itself.\"\"\"\n\n def describe_to(self, description):\n \"\"\"Generates a description of the object.\n\n The description may be part of a description of a larger object of\n which this is just a component, so it should be worded appropriately.\n\n :param description: The description to be built or appended to.\n\n \"\"\"\n raise NotImplementedError('describe_to')\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/core/selfdescribingvalue.py",
"content": "from hamcrest.core.selfdescribing import SelfDescribing\n\nimport warnings\n\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\n\nclass SelfDescribingValue(SelfDescribing):\n \"\"\"Wrap any value in a ``SelfDescribingValue`` to satisfy the\n :py:class:`~hamcrest.core.selfdescribing.SelfDescribing` interface.\n\n **Deprecated:** No need for this class now that\n :py:meth:`~hamcrest.core.description.Description.append_description_of`\n handles any type of value.\n\n \"\"\"\n\n def __init__(self, value):\n warnings.warn('SelfDescribingValue no longer needed',\n DeprecationWarning)\n self.value = value\n\n def describe_to(self, description):\n \"\"\"Generates a description of the value.\"\"\"\n description.append_value(self.value)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/core/string_description.py",
"content": "from __future__ import absolute_import\n\nimport codecs\nimport six\n\nfrom .base_description import BaseDescription\n\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\n\ndef tostring(selfdescribing):\n \"\"\"Returns the description of a\n :py:class:`~hamcrest.core.selfdescribing.SelfDescribing` object as a\n string.\n\n :param selfdescribing: The object to be described.\n :returns: The description of the object.\n \"\"\"\n return str(StringDescription().append_description_of(selfdescribing))\n\n\nclass StringDescription(BaseDescription):\n \"\"\"A :py:class:`~hamcrest.core.description.Description` that is stored as a\n string.\n\n \"\"\"\n\n def __init__(self):\n self.out = ''\n\n def __str__(self):\n \"\"\"Returns the description.\"\"\"\n return self.out\n\n def append(self, string):\n self.out += six.text_type(string)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/library/__init__.py",
"content": "from __future__ import absolute_import\n\"\"\"Library of Matcher implementations.\"\"\"\n\nfrom hamcrest.core import *\nfrom hamcrest.library.collection import *\nfrom hamcrest.library.integration import *\nfrom hamcrest.library.number import *\nfrom hamcrest.library.object import *\nfrom hamcrest.library.text import *\n\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\n__all__ = [\n 'has_entry',\n 'has_entries',\n 'has_key',\n 'has_value',\n 'is_in',\n 'empty',\n 'has_item',\n 'has_items',\n 'contains_inanyorder',\n 'contains',\n 'only_contains',\n 'match_equality',\n 'matches_regexp',\n 'close_to',\n 'greater_than',\n 'greater_than_or_equal_to',\n 'less_than',\n 'less_than_or_equal_to',\n 'has_length',\n 'has_property',\n 'has_properties',\n 'has_string',\n 'equal_to_ignoring_case',\n 'equal_to_ignoring_whitespace',\n 'contains_string',\n 'ends_with',\n 'starts_with',\n 'string_contains_in_order',\n]\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/library/collection/__init__.py",
"content": "\"\"\"Matchers of collections.\"\"\"\nfrom __future__ import absolute_import\nfrom .isdict_containing import has_entry\nfrom .isdict_containingentries import has_entries\nfrom .isdict_containingkey import has_key\nfrom .isdict_containingvalue import has_value\nfrom .isin import is_in\nfrom .issequence_containing import has_item, has_items\nfrom .issequence_containinginanyorder import contains_inanyorder\nfrom .issequence_containinginorder import contains\nfrom .issequence_onlycontaining import only_contains\nfrom .is_empty import empty\n\n__author__ = \"Chris Rose\"\n__copyright__ = \"Copyright 2013 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/library/collection/is_empty.py",
"content": "from hamcrest.core.base_matcher import BaseMatcher\n\n__author__ = \"Chris Rose\"\n__copyright__ = \"Copyright 2012 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\n\nclass IsEmpty(BaseMatcher):\n\n def matches(self, item, mismatch_description=None):\n try:\n if len(item) == 0:\n return True\n\n if mismatch_description:\n mismatch_description \\\n .append_text('has %d item(s)' % len(item))\n\n except TypeError:\n if mismatch_description:\n mismatch_description \\\n .append_text('does not support length')\n\n return False\n\n def describe_to(self, description):\n description.append_text('an empty collection')\n\n\ndef empty():\n \"\"\"\n This matcher matches any collection-like object that responds to the\n __len__ method, and has a length of 0.\n \"\"\"\n return IsEmpty()\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/library/collection/isdict_containing.py",
"content": "from hamcrest.core.base_matcher import BaseMatcher\nfrom hamcrest.core.helpers.hasmethod import hasmethod\nfrom hamcrest.core.helpers.wrap_matcher import wrap_matcher\n\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\n\nclass IsDictContaining(BaseMatcher):\n\n def __init__(self, key_matcher, value_matcher):\n self.key_matcher = key_matcher\n self.value_matcher = value_matcher\n\n def _matches(self, dictionary):\n if hasmethod(dictionary, 'items'):\n for key, value in dictionary.items():\n if self.key_matcher.matches(key) and self.value_matcher.matches(value):\n return True\n return False\n\n def describe_to(self, description):\n description.append_text('a dictionary containing [') \\\n .append_description_of(self.key_matcher) \\\n .append_text(': ') \\\n .append_description_of(self.value_matcher) \\\n .append_text(']')\n\n\ndef has_entry(key_match, value_match):\n \"\"\"Matches if dictionary contains key-value entry satisfying a given pair\n of matchers.\n\n :param key_match: The matcher to satisfy for the key, or an expected value\n for :py:func:`~hamcrest.core.core.isequal.equal_to` matching.\n :param value_match: The matcher to satisfy for the value, or an expected\n value for :py:func:`~hamcrest.core.core.isequal.equal_to` matching.\n\n This matcher iterates the evaluated dictionary, searching for any key-value\n entry that satisfies ``key_match`` and ``value_match``. If a matching entry\n is found, ``has_entry`` is satisfied.\n\n Any argument that is not a matcher is implicitly wrapped in an\n :py:func:`~hamcrest.core.core.isequal.equal_to` matcher to check for\n equality.\n\n Examples::\n\n has_entry(equal_to('foo'), equal_to(1))\n has_entry('foo', 1)\n\n \"\"\"\n return IsDictContaining(wrap_matcher(key_match), wrap_matcher(value_match))\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/library/collection/isdict_containingentries.py",
"content": "from hamcrest.core.base_matcher import BaseMatcher\nfrom hamcrest.core.helpers.hasmethod import hasmethod\nfrom hamcrest.core.helpers.wrap_matcher import wrap_matcher\n\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\n\nclass IsDictContainingEntries(BaseMatcher):\n\n def __init__(self, value_matchers):\n self.value_matchers = sorted(value_matchers.items())\n\n def _not_a_dictionary(self, dictionary, mismatch_description):\n if mismatch_description:\n mismatch_description.append_description_of(dictionary) \\\n .append_text(' is not a mapping object')\n return False\n\n def matches(self, dictionary, mismatch_description=None):\n for key, value_matcher in self.value_matchers:\n\n try:\n if not key in dictionary:\n if mismatch_description:\n mismatch_description.append_text('no ') \\\n .append_description_of(key) \\\n .append_text(' key in ') \\\n .append_description_of(dictionary)\n return False\n except TypeError:\n return self._not_a_dictionary(dictionary, mismatch_description)\n\n try:\n actual_value = dictionary[key]\n except TypeError:\n return self._not_a_dictionary(dictionary, mismatch_description)\n\n if not value_matcher.matches(actual_value):\n if mismatch_description:\n mismatch_description.append_text('value for ') \\\n .append_description_of(key) \\\n .append_text(' ')\n value_matcher.describe_mismatch(actual_value, mismatch_description)\n return False\n\n return True\n\n def describe_mismatch(self, item, mismatch_description):\n self.matches(item, mismatch_description)\n\n def describe_keyvalue(self, index, value, description):\n \"\"\"Describes key-value pair at given index.\"\"\"\n description.append_description_of(index) \\\n .append_text(': ') \\\n .append_description_of(value)\n\n def describe_to(self, description):\n description.append_text('a dictionary containing {')\n first = True\n for key, value in self.value_matchers:\n if not first:\n description.append_text(', ')\n self.describe_keyvalue(key, value, description)\n first = False\n description.append_text('}')\n\n\ndef has_entries(*keys_valuematchers, **kv_args):\n \"\"\"Matches if dictionary contains entries satisfying a dictionary of keys\n and corresponding value matchers.\n\n :param matcher_dict: A dictionary mapping keys to associated value matchers,\n or to expected values for\n :py:func:`~hamcrest.core.core.isequal.equal_to` matching.\n\n Note that the keys must be actual keys, not matchers. Any value argument\n that is not a matcher is implicitly wrapped in an\n :py:func:`~hamcrest.core.core.isequal.equal_to` matcher to check for\n equality.\n\n Examples::\n\n has_entries({'foo':equal_to(1), 'bar':equal_to(2)})\n has_entries({'foo':1, 'bar':2})\n\n ``has_entries`` also accepts a list of keyword arguments:\n\n .. function:: has_entries(keyword1=value_matcher1[, keyword2=value_matcher2[, ...]])\n\n :param keyword1: A keyword to look up.\n :param valueMatcher1: The matcher to satisfy for the value, or an expected\n value for :py:func:`~hamcrest.core.core.isequal.equal_to` matching.\n\n Examples::\n\n has_entries(foo=equal_to(1), bar=equal_to(2))\n has_entries(foo=1, bar=2)\n\n Finally, ``has_entries`` also accepts a list of alternating keys and their\n value matchers:\n\n .. function:: has_entries(key1, value_matcher1[, ...])\n\n :param key1: A key (not a matcher) to look up.\n :param valueMatcher1: The matcher to satisfy for the value, or an expected\n value for :py:func:`~hamcrest.core.core.isequal.equal_to` matching.\n\n Examples::\n\n has_entries('foo', equal_to(1), 'bar', equal_to(2))\n has_entries('foo', 1, 'bar', 2)\n\n \"\"\"\n if len(keys_valuematchers) == 1:\n try:\n base_dict = keys_valuematchers[0].copy()\n for key in base_dict:\n base_dict[key] = wrap_matcher(base_dict[key])\n except AttributeError:\n raise ValueError('single-argument calls to has_entries must pass a dict as the argument')\n else:\n if len(keys_valuematchers) % 2:\n raise ValueError('has_entries requires key-value pairs')\n base_dict = {}\n for index in range(int(len(keys_valuematchers) / 2)):\n base_dict[keys_valuematchers[2 * index]] = wrap_matcher(keys_valuematchers[2 * index + 1])\n\n for key, value in kv_args.items():\n base_dict[key] = wrap_matcher(value)\n\n return IsDictContainingEntries(base_dict)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/library/collection/isdict_containingkey.py",
"content": "from hamcrest.core.base_matcher import BaseMatcher\nfrom hamcrest.core.helpers.hasmethod import hasmethod\nfrom hamcrest.core.helpers.wrap_matcher import wrap_matcher\n\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\n\nclass IsDictContainingKey(BaseMatcher):\n\n def __init__(self, key_matcher):\n self.key_matcher = key_matcher\n\n def _matches(self, dictionary):\n if hasmethod(dictionary, 'keys'):\n for key in dictionary.keys():\n if self.key_matcher.matches(key):\n return True\n return False\n\n def describe_to(self, description):\n description.append_text('a dictionary containing key ') \\\n .append_description_of(self.key_matcher)\n\n\ndef has_key(key_match):\n \"\"\"Matches if dictionary contains an entry whose key satisfies a given\n matcher.\n\n :param key_match: The matcher to satisfy for the key, or an expected value\n for :py:func:`~hamcrest.core.core.isequal.equal_to` matching.\n\n This matcher iterates the evaluated dictionary, searching for any key-value\n entry whose key satisfies the given matcher. If a matching entry is found,\n ``has_key`` is satisfied.\n\n Any argument that is not a matcher is implicitly wrapped in an\n :py:func:`~hamcrest.core.core.isequal.equal_to` matcher to check for\n equality.\n\n Examples::\n\n has_key(equal_to('foo'))\n has_key('foo')\n\n \"\"\"\n return IsDictContainingKey(wrap_matcher(key_match))\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/library/collection/isdict_containingvalue.py",
"content": "from hamcrest.core.base_matcher import BaseMatcher\nfrom hamcrest.core.helpers.hasmethod import hasmethod\nfrom hamcrest.core.helpers.wrap_matcher import wrap_matcher\n\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\n\nclass IsDictContainingValue(BaseMatcher):\n\n def __init__(self, value_matcher):\n self.value_matcher = value_matcher\n\n def _matches(self, dictionary):\n if hasmethod(dictionary, 'values'):\n for value in dictionary.values():\n if self.value_matcher.matches(value):\n return True\n return False\n\n def describe_to(self, description):\n description.append_text('a dictionary containing value ') \\\n .append_description_of(self.value_matcher)\n\n\ndef has_value(value):\n \"\"\"Matches if dictionary contains an entry whose value satisfies a given\n matcher.\n\n :param value_match: The matcher to satisfy for the value, or an expected\n value for :py:func:`~hamcrest.core.core.isequal.equal_to` matching.\n\n This matcher iterates the evaluated dictionary, searching for any key-value\n entry whose value satisfies the given matcher. If a matching entry is\n found, ``has_value`` is satisfied.\n\n Any argument that is not a matcher is implicitly wrapped in an\n :py:func:`~hamcrest.core.core.isequal.equal_to` matcher to check for\n equality.\n\n Examples::\n\n has_value(equal_to('bar'))\n has_value('bar')\n\n \"\"\"\n return IsDictContainingValue(wrap_matcher(value))\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/library/collection/isin.py",
"content": "from hamcrest.core.base_matcher import BaseMatcher\n\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\n\nclass IsIn(BaseMatcher):\n\n def __init__(self, sequence):\n self.sequence = sequence\n\n def _matches(self, item):\n return item in self.sequence\n\n def describe_to(self, description):\n description.append_text('one of ') \\\n .append_list('(', ', ', ')', self.sequence)\n\n\ndef is_in(sequence):\n \"\"\"Matches if evaluated object is present in a given sequence.\n\n :param sequence: The sequence to search.\n\n This matcher invokes the ``in`` membership operator to determine if the\n evaluated object is a member of the sequence.\n\n \"\"\"\n return IsIn(sequence)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/library/collection/issequence_containing.py",
"content": "__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\nfrom hamcrest.core.base_matcher import BaseMatcher\nfrom hamcrest.core.core.allof import all_of\nfrom hamcrest.core.helpers.hasmethod import hasmethod\nfrom hamcrest.core.helpers.wrap_matcher import wrap_matcher\n\n\nclass IsSequenceContaining(BaseMatcher):\n\n def __init__(self, element_matcher):\n self.element_matcher = element_matcher\n\n def _matches(self, sequence):\n try:\n for item in sequence:\n if self.element_matcher.matches(item):\n return True\n except TypeError: # not a sequence\n return False\n\n def describe_to(self, description):\n description.append_text('a sequence containing ') \\\n .append_description_of(self.element_matcher)\n\n\n# It'd be great to make use of all_of, but we can't be sure we won't\n# be seeing a one-time sequence here (like a generator); see issue #20\n# Instead, we wrap it inside a class that will convert the sequence into\n# a concrete list and then hand it off to the all_of matcher.\nclass IsSequenceContainingEvery(BaseMatcher):\n\n def __init__(self, *element_matchers):\n delegates = [has_item(e) for e in element_matchers]\n self.matcher = all_of(*delegates)\n\n def _matches(self, sequence):\n try:\n return self.matcher.matches(list(sequence))\n except TypeError:\n return False\n\n def describe_mismatch(self, item, mismatch_description):\n self.matcher.describe_mismatch(item, mismatch_description)\n\n def describe_to(self, description):\n self.matcher.describe_to(description)\n\n\n\ndef has_item(match):\n \"\"\"Matches if any element of sequence satisfies a given matcher.\n\n :param match: The matcher to satisfy, or an expected value for\n :py:func:`~hamcrest.core.core.isequal.equal_to` matching.\n\n This matcher iterates the evaluated sequence, searching for any element\n that satisfies a given matcher. If a matching element is found,\n ``has_item`` is satisfied.\n\n If the ``match`` argument is not a matcher, it is implicitly wrapped in an\n :py:func:`~hamcrest.core.core.isequal.equal_to` matcher to check for\n equality.\n\n \"\"\"\n return IsSequenceContaining(wrap_matcher(match))\n\n\ndef has_items(*items):\n \"\"\"Matches if all of the given matchers are satisfied by any elements of\n the sequence.\n\n :param match1,...: A comma-separated list of matchers.\n\n This matcher iterates the given matchers, searching for any elements in the\n evaluated sequence that satisfy them. If each matcher is satisfied, then\n ``has_items`` is satisfied.\n\n Any argument that is not a matcher is implicitly wrapped in an\n :py:func:`~hamcrest.core.core.isequal.equal_to` matcher to check for\n equality.\n\n \"\"\"\n matchers = []\n for item in items:\n matchers.append(wrap_matcher(item))\n return IsSequenceContainingEvery(*matchers)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/library/collection/issequence_containinginanyorder.py",
"content": "from hamcrest.core.base_matcher import BaseMatcher\nfrom hamcrest.core.helpers.hasmethod import hasmethod\nfrom hamcrest.core.helpers.wrap_matcher import wrap_matcher\n\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\n\nclass MatchInAnyOrder(object):\n def __init__(self, matchers, mismatch_description):\n self.matchers = matchers[:]\n self.mismatch_description = mismatch_description\n\n def matches(self, item):\n return self.isnotsurplus(item) and self.ismatched(item)\n\n def isfinished(self, sequence):\n if not self.matchers:\n return True\n if self.mismatch_description:\n self.mismatch_description.append_text('no item matches: ') \\\n .append_list('', ', ', '', self.matchers) \\\n .append_text(' in ') \\\n .append_list('[', ', ', ']', sequence)\n return False\n\n def isnotsurplus(self, item):\n if not self.matchers:\n if self.mismatch_description:\n self.mismatch_description.append_text('not matched: ') \\\n .append_description_of(item)\n return False\n return True\n\n def ismatched(self, item):\n for index, matcher in enumerate(self.matchers):\n if matcher.matches(item):\n del self.matchers[index]\n return True\n\n if self.mismatch_description:\n self.mismatch_description.append_text('not matched: ') \\\n .append_description_of(item)\n return False\n\n\nclass IsSequenceContainingInAnyOrder(BaseMatcher):\n\n def __init__(self, matchers):\n self.matchers = matchers\n\n def matches(self, sequence, mismatch_description=None):\n try:\n sequence = list(sequence)\n matchsequence = MatchInAnyOrder(self.matchers, mismatch_description)\n for item in sequence:\n if not matchsequence.matches(item):\n return False\n return matchsequence.isfinished(sequence)\n except TypeError:\n if mismatch_description:\n super(IsSequenceContainingInAnyOrder, self) \\\n .describe_mismatch(sequence, mismatch_description)\n return False\n\n def describe_mismatch(self, item, mismatch_description):\n self.matches(item, mismatch_description)\n\n def describe_to(self, description):\n description.append_text('a sequence over ') \\\n .append_list('[', ', ', ']', self.matchers) \\\n .append_text(' in any order')\n\n\ndef contains_inanyorder(*items):\n \"\"\"Matches if sequences's elements, in any order, satisfy a given list of\n matchers.\n\n :param match1,...: A comma-separated list of matchers.\n\n This matcher iterates the evaluated sequence, seeing if each element\n satisfies any of the given matchers. The matchers are tried from left to\n right, and when a satisfied matcher is found, it is no longer a candidate\n for the remaining elements. If a one-to-one correspondence is established\n between elements and matchers, ``contains_inanyorder`` is satisfied.\n\n Any argument that is not a matcher is implicitly wrapped in an\n :py:func:`~hamcrest.core.core.isequal.equal_to` matcher to check for\n equality.\n\n \"\"\"\n\n matchers = []\n for item in items:\n matchers.append(wrap_matcher(item))\n return IsSequenceContainingInAnyOrder(matchers)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/library/collection/issequence_containinginorder.py",
"content": "__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\nfrom hamcrest.core.base_matcher import BaseMatcher\nfrom hamcrest.core.helpers.hasmethod import hasmethod\nfrom hamcrest.core.helpers.wrap_matcher import wrap_matcher\n\n\nclass MatchingInOrder(object):\n def __init__(self, matchers, mismatch_description):\n self.matchers = matchers\n self.mismatch_description = mismatch_description\n self.next_match_index = 0\n\n def matches(self, item):\n return self.isnotsurplus(item) and self.ismatched(item)\n\n def isfinished(self):\n if self.next_match_index < len(self.matchers):\n if self.mismatch_description:\n self.mismatch_description.append_text('No item matched: ') \\\n .append_description_of(self.matchers[self.next_match_index])\n return False\n return True\n\n def ismatched(self, item):\n matcher = self.matchers[self.next_match_index]\n if not matcher.matches(item):\n if self.mismatch_description:\n self.mismatch_description.append_text('item ' + str(self.next_match_index) + ': ')\n matcher.describe_mismatch(item, self.mismatch_description)\n return False\n self.next_match_index += 1\n return True\n\n def isnotsurplus(self, item):\n if len(self.matchers) <= self.next_match_index:\n if self.mismatch_description:\n self.mismatch_description.append_text('Not matched: ') \\\n .append_description_of(item)\n return False\n return True\n\n\nclass IsSequenceContainingInOrder(BaseMatcher):\n\n def __init__(self, matchers):\n self.matchers = matchers\n\n def matches(self, sequence, mismatch_description=None):\n try:\n matchsequence = MatchingInOrder(self.matchers, mismatch_description)\n for item in sequence:\n if not matchsequence.matches(item):\n return False\n return matchsequence.isfinished()\n except TypeError:\n if mismatch_description:\n super(IsSequenceContainingInOrder, self) \\\n .describe_mismatch(sequence, mismatch_description)\n return False\n\n def describe_mismatch(self, item, mismatch_description):\n self.matches(item, mismatch_description)\n\n def describe_to(self, description):\n description.append_text('a sequence containing ') \\\n .append_list('[', ', ', ']', self.matchers)\n\n\ndef contains(*items):\n \"\"\"Matches if sequence's elements satisfy a given list of matchers, in order.\n\n :param match1,...: A comma-separated list of matchers.\n\n This matcher iterates the evaluated sequence and a given list of matchers,\n seeing if each element satisfies its corresponding matcher.\n\n Any argument that is not a matcher is implicitly wrapped in an\n :py:func:`~hamcrest.core.core.isequal.equal_to` matcher to check for\n equality.\n\n \"\"\"\n matchers = []\n for item in items:\n matchers.append(wrap_matcher(item))\n return IsSequenceContainingInOrder(matchers)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/library/collection/issequence_onlycontaining.py",
"content": "from hamcrest.core.base_matcher import BaseMatcher\nfrom hamcrest.core.core.anyof import any_of\nfrom hamcrest.core.helpers.hasmethod import hasmethod\nfrom hamcrest.core.helpers.wrap_matcher import wrap_matcher\n\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\n\nclass IsSequenceOnlyContaining(BaseMatcher):\n\n def __init__(self, matcher):\n self.matcher = matcher\n\n def _matches(self, sequence):\n try:\n sequence = list(sequence)\n if len(sequence) == 0:\n return False\n for item in sequence:\n if not self.matcher.matches(item):\n return False\n return True\n except TypeError:\n return False\n\n def describe_to(self, description):\n description.append_text('a sequence containing items matching ') \\\n .append_description_of(self.matcher)\n\n\ndef only_contains(*items):\n \"\"\"Matches if each element of sequence satisfies any of the given matchers.\n\n :param match1,...: A comma-separated list of matchers.\n\n This matcher iterates the evaluated sequence, confirming whether each\n element satisfies any of the given matchers.\n\n Example::\n\n only_contains(less_than(4))\n\n will match ``[3,1,2]``.\n\n Any argument that is not a matcher is implicitly wrapped in an\n :py:func:`~hamcrest.core.core.isequal.equal_to` matcher to check for\n equality.\n\n \"\"\"\n matchers = []\n for item in items:\n matchers.append(wrap_matcher(item))\n return IsSequenceOnlyContaining(any_of(*matchers))\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/library/integration/__init__.py",
"content": "from __future__ import absolute_import\n\"\"\"Utilities for integrating Hamcrest with other libraries.\"\"\"\n\nfrom .match_equality import match_equality\n\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/library/integration/match_equality.py",
"content": "from hamcrest.core.string_description import tostring\nfrom hamcrest.core.helpers.wrap_matcher import wrap_matcher\n\n__author__ = \"Chris Rose\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n__unittest = True\n\n\nclass EqualityWrapper(object):\n\n def __init__(self, matcher):\n self.matcher = matcher\n\n def __eq__(self, object):\n return self.matcher.matches(object)\n\n def __str__(self):\n return repr(self)\n\n def __repr__(self):\n return tostring(self.matcher)\n\n\ndef match_equality(matcher):\n \"\"\"Wraps a matcher to define equality in terms of satisfying the matcher.\n\n ``match_equality`` allows Hamcrest matchers to be used in libraries that\n are not Hamcrest-aware. They might use the equality operator::\n\n assert match_equality(matcher) == object\n\n Or they might provide a method that uses equality for its test::\n\n library.method_that_tests_eq(match_equality(matcher))\n\n One concrete example is integrating with the ``assert_called_with`` methods\n in Michael Foord's `mock `_\n library.\n\n \"\"\"\n return EqualityWrapper(wrap_matcher(matcher))\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/library/number/__init__.py",
"content": "from __future__ import absolute_import\n\"\"\"Matchers that perform numeric comparisons.\"\"\"\n\nfrom .iscloseto import close_to\nfrom .ordering_comparison import greater_than, greater_than_or_equal_to, less_than, less_than_or_equal_to\n\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/library/number/iscloseto.py",
"content": "import six\nfrom hamcrest.core.base_matcher import BaseMatcher\nfrom math import fabs\n\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\n\ndef isnumeric(value):\n \"\"\"Confirm that 'value' can be treated numerically; duck-test accordingly\n \"\"\"\n if isinstance(value, (float, complex) + six.integer_types):\n return True\n\n try:\n _ = (fabs(value) + 0 - 0) * 1\n return True\n except ArithmeticError:\n return True\n except:\n return False\n return False\n\n\nclass IsCloseTo(BaseMatcher):\n\n def __init__(self, value, delta):\n if not isnumeric(value):\n raise TypeError('IsCloseTo value must be numeric')\n if not isnumeric(delta):\n raise TypeError('IsCloseTo delta must be numeric')\n\n self.value = value\n self.delta = delta\n\n def _matches(self, item):\n if not isnumeric(item):\n return False\n return fabs(item - self.value) <= self.delta\n\n def describe_mismatch(self, item, mismatch_description):\n if not isnumeric(item):\n super(IsCloseTo, self).describe_mismatch(item, mismatch_description)\n else:\n actual_delta = fabs(item - self.value)\n mismatch_description.append_description_of(item) \\\n .append_text(' differed by ') \\\n .append_description_of(actual_delta)\n\n def describe_to(self, description):\n description.append_text('a numeric value within ') \\\n .append_description_of(self.delta) \\\n .append_text(' of ') \\\n .append_description_of(self.value)\n\n\ndef close_to(value, delta):\n \"\"\"Matches if object is a number close to a given value, within a given\n delta.\n\n :param value: The value to compare against as the expected value.\n :param delta: The maximum delta between the values for which the numbers\n are considered close.\n\n This matcher compares the evaluated object against ``value`` to see if the\n difference is within a positive ``delta``.\n\n Example::\n\n close_to(3.0, 0.25)\n\n \"\"\"\n return IsCloseTo(value, delta)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/library/number/ordering_comparison.py",
"content": "from hamcrest.core.base_matcher import BaseMatcher\nimport operator\n\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\n\nclass OrderingComparison(BaseMatcher):\n\n def __init__(self, value, comparison_function, comparison_description):\n self.value = value\n self.comparison_function = comparison_function\n self.comparison_description = comparison_description\n\n def _matches(self, item):\n return self.comparison_function(item, self.value)\n\n def describe_to(self, description):\n description.append_text('a value ') \\\n .append_text(self.comparison_description) \\\n .append_text(' ') \\\n .append_description_of(self.value)\n\n\ndef greater_than(value):\n \"\"\"Matches if object is greater than a given value.\n\n :param value: The value to compare against.\n\n \"\"\"\n return OrderingComparison(value, operator.gt, 'greater than')\n\n\ndef greater_than_or_equal_to(value):\n \"\"\"Matches if object is greater than or equal to a given value.\n\n :param value: The value to compare against.\n\n \"\"\"\n return OrderingComparison(value, operator.ge, 'greater than or equal to')\n\n\ndef less_than(value):\n \"\"\"Matches if object is less than a given value.\n\n :param value: The value to compare against.\n\n \"\"\"\n return OrderingComparison(value, operator.lt, 'less than')\n\n\ndef less_than_or_equal_to(value):\n \"\"\"Matches if object is less than or equal to a given value.\n\n :param value: The value to compare against.\n\n \"\"\"\n return OrderingComparison(value, operator.le, 'less than or equal to')\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/library/object/__init__.py",
"content": "from __future__ import absolute_import\n\"\"\"Matchers that inspect objects and classes.\"\"\"\n\nfrom .haslength import has_length\nfrom .hasproperty import has_property, has_properties\nfrom .hasstring import has_string\n\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/library/object/haslength.py",
"content": "from hamcrest.core.base_matcher import BaseMatcher\nfrom hamcrest.core.helpers.hasmethod import hasmethod\nfrom hamcrest.core.helpers.wrap_matcher import wrap_matcher\n\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\n\nclass HasLength(BaseMatcher):\n\n def __init__(self, len_matcher):\n self.len_matcher = len_matcher\n\n def _matches(self, item):\n if not hasmethod(item, '__len__'):\n return False\n return self.len_matcher.matches(len(item))\n\n def describe_mismatch(self, item, mismatch_description):\n super(HasLength, self).describe_mismatch(item, mismatch_description)\n if hasmethod(item, '__len__'):\n mismatch_description.append_text(' with length of ') \\\n .append_description_of(len(item))\n\n def describe_to(self, description):\n description.append_text('an object with length of ') \\\n .append_description_of(self.len_matcher)\n\n\ndef has_length(match):\n \"\"\"Matches if ``len(item)`` satisfies a given matcher.\n\n :param match: The matcher to satisfy, or an expected value for\n :py:func:`~hamcrest.core.core.isequal.equal_to` matching.\n\n This matcher invokes the :py:func:`len` function on the evaluated object to\n get its length, passing the result to a given matcher for evaluation.\n\n If the ``match`` argument is not a matcher, it is implicitly wrapped in an\n :py:func:`~hamcrest.core.core.isequal.equal_to` matcher to check for\n :equality.\n\n Examples::\n\n has_length(greater_than(6))\n has_length(5)\n\n \"\"\"\n return HasLength(wrap_matcher(match))\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/library/object/hasproperty.py",
"content": "from hamcrest.core.base_matcher import BaseMatcher\nfrom hamcrest.core import anything\nfrom hamcrest.core.core.allof import all_of\nfrom hamcrest.core.string_description import StringDescription\nfrom hamcrest.core.helpers.hasmethod import hasmethod\nfrom hamcrest.core.helpers.wrap_matcher import wrap_matcher as wrap_shortcut\n\n__author__ = \"Chris Rose\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\n\nclass IsObjectWithProperty(BaseMatcher):\n\n def __init__(self, property_name, value_matcher):\n self.property_name = property_name\n self.value_matcher = value_matcher\n\n def _matches(self, o):\n if o is None:\n return False\n\n if not hasattr(o, self.property_name):\n return False\n\n value = getattr(o, self.property_name)\n return self.value_matcher.matches(value)\n\n def describe_to(self, description):\n description.append_text(\"an object with a property '\") \\\n .append_text(self.property_name) \\\n .append_text(\"' matching \") \\\n .append_description_of(self.value_matcher)\n\n def describe_mismatch(self, item, mismatch_description):\n if item is None:\n mismatch_description.append_text('was None')\n return\n\n if not hasattr(item, self.property_name):\n mismatch_description.append_value(item) \\\n .append_text(' did not have the ') \\\n .append_value(self.property_name) \\\n .append_text(' property')\n return\n\n mismatch_description.append_text('property ').append_value(self.property_name).append_text(' ')\n value = getattr(item, self.property_name)\n self.value_matcher.describe_mismatch(value, mismatch_description)\n\n def __str__(self):\n d = StringDescription()\n self.describe_to(d)\n return str(d)\n\n\ndef has_property(name, match=None):\n \"\"\"Matches if object has a property with a given name whose value satisfies\n a given matcher.\n\n :param name: The name of the property.\n :param match: Optional matcher to satisfy.\n\n This matcher determines if the evaluated object has a property with a given\n name. If no such property is found, ``has_property`` is not satisfied.\n\n If the property is found, its value is passed to a given matcher for\n evaluation. If the ``match`` argument is not a matcher, it is implicitly\n wrapped in an :py:func:`~hamcrest.core.core.isequal.equal_to` matcher to\n check for equality.\n\n If the ``match`` argument is not provided, the\n :py:func:`~hamcrest.core.core.isanything.anything` matcher is used so that\n ``has_property`` is satisfied if a matching property is found.\n\n Examples::\n\n has_property('name', starts_with('J'))\n has_property('name', 'Jon')\n has_property('name')\n\n \"\"\"\n\n if match is None:\n match = anything()\n\n return IsObjectWithProperty(name, wrap_shortcut(match))\n\n\ndef has_properties(*keys_valuematchers, **kv_args):\n \"\"\"Matches if an object has properties satisfying all of a dictionary\n of string property names and corresponding value matchers.\n\n :param matcher_dict: A dictionary mapping keys to associated value matchers,\n or to expected values for\n :py:func:`~hamcrest.core.core.isequal.equal_to` matching.\n\n Note that the keys must be actual keys, not matchers. Any value argument\n that is not a matcher is implicitly wrapped in an\n :py:func:`~hamcrest.core.core.isequal.equal_to` matcher to check for\n equality.\n\n Examples::\n\n has_properties({'foo':equal_to(1), 'bar':equal_to(2)})\n has_properties({'foo':1, 'bar':2})\n\n ``has_properties`` also accepts a list of keyword arguments:\n\n .. function:: has_properties(keyword1=value_matcher1[, keyword2=value_matcher2[, ...]])\n\n :param keyword1: A keyword to look up.\n :param valueMatcher1: The matcher to satisfy for the value, or an expected\n value for :py:func:`~hamcrest.core.core.isequal.equal_to` matching.\n\n Examples::\n\n has_properties(foo=equal_to(1), bar=equal_to(2))\n has_properties(foo=1, bar=2)\n\n Finally, ``has_properties`` also accepts a list of alternating keys and their\n value matchers:\n\n .. function:: has_properties(key1, value_matcher1[, ...])\n\n :param key1: A key (not a matcher) to look up.\n :param valueMatcher1: The matcher to satisfy for the value, or an expected\n value for :py:func:`~hamcrest.core.core.isequal.equal_to` matching.\n\n Examples::\n\n has_properties('foo', equal_to(1), 'bar', equal_to(2))\n has_properties('foo', 1, 'bar', 2)\n\n \"\"\"\n if len(keys_valuematchers) == 1:\n try:\n base_dict = keys_valuematchers[0].copy()\n for key in base_dict:\n base_dict[key] = wrap_shortcut(base_dict[key])\n except AttributeError:\n raise ValueError('single-argument calls to has_properties must pass a dict as the argument')\n else:\n if len(keys_valuematchers) % 2:\n raise ValueError('has_properties requires key-value pairs')\n base_dict = {}\n for index in range(int(len(keys_valuematchers) / 2)):\n base_dict[keys_valuematchers[2 * index]] = wrap_shortcut(keys_valuematchers[2 * index + 1])\n\n for key, value in kv_args.items():\n base_dict[key] = wrap_shortcut(value)\n\n return all_of(*[has_property(property_name, property_value_matcher) for \\\n property_name, property_value_matcher in base_dict.items()])\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/library/object/hasstring.py",
"content": "from hamcrest.core.base_matcher import BaseMatcher\nfrom hamcrest.core.helpers.wrap_matcher import wrap_matcher\n\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\n\nclass HasString(BaseMatcher):\n\n def __init__(self, str_matcher):\n self.str_matcher = str_matcher\n\n def _matches(self, item):\n return self.str_matcher.matches(str(item))\n\n def describe_to(self, description):\n description.append_text('an object with str ') \\\n .append_description_of(self.str_matcher)\n\n\ndef has_string(match):\n \"\"\"Matches if ``str(item)`` satisfies a given matcher.\n\n :param match: The matcher to satisfy, or an expected value for\n :py:func:`~hamcrest.core.core.isequal.equal_to` matching.\n\n This matcher invokes the :py:func:`str` function on the evaluated object to\n get its length, passing the result to a given matcher for evaluation. If\n the ``match`` argument is not a matcher, it is implicitly wrapped in an\n :py:func:`~hamcrest.core.core.isequal.equal_to` matcher to check for\n equality.\n\n Examples::\n\n has_string(starts_with('foo'))\n has_string('bar')\n\n \"\"\"\n return HasString(wrap_matcher(match))\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/library/text/__init__.py",
"content": "from __future__ import absolute_import\n\"\"\"Matchers that perform text comparisons.\"\"\"\n\nfrom .isequal_ignoring_case import equal_to_ignoring_case\nfrom .isequal_ignoring_whitespace import equal_to_ignoring_whitespace\nfrom .stringcontains import contains_string\nfrom .stringendswith import ends_with\nfrom .stringstartswith import starts_with\nfrom .stringmatches import matches_regexp\nfrom .stringcontainsinorder import string_contains_in_order\n\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/library/text/isequal_ignoring_case.py",
"content": "__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\nfrom hamcrest.core.base_matcher import BaseMatcher\n\nimport six\n\nclass IsEqualIgnoringCase(BaseMatcher):\n\n def __init__(self, string):\n if not isinstance(string, six.string_types):\n raise TypeError('IsEqualIgnoringCase requires string')\n self.original_string = string\n self.lowered_string = string.lower()\n\n def _matches(self, item):\n if not isinstance(item, six.string_types):\n return False\n return self.lowered_string == item.lower()\n\n def describe_to(self, description):\n description.append_description_of(self.original_string) \\\n .append_text(' ignoring case')\n\n\ndef equal_to_ignoring_case(string):\n \"\"\"Matches if object is a string equal to a given string, ignoring case\n differences.\n\n :param string: The string to compare against as the expected value.\n\n This matcher first checks whether the evaluated object is a string. If so,\n it compares it with ``string``, ignoring differences of case.\n\n Example::\n\n equal_to_ignoring_case(\"hello world\")\n\n will match \"heLLo WorlD\".\n\n \"\"\"\n return IsEqualIgnoringCase(string)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/library/text/isequal_ignoring_whitespace.py",
"content": "__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\nfrom hamcrest.core.base_matcher import BaseMatcher\n\nimport six\n\ndef stripspace(string):\n result = ''\n last_was_space = True\n for character in string:\n if character.isspace():\n if not last_was_space:\n result += ' '\n last_was_space = True\n else:\n result += character\n last_was_space = False\n return result.strip()\n\n\nclass IsEqualIgnoringWhiteSpace(BaseMatcher):\n\n def __init__(self, string):\n if not isinstance(string, six.string_types):\n raise TypeError('IsEqualIgnoringWhiteSpace requires string')\n self.original_string = string\n self.stripped_string = stripspace(string)\n\n def _matches(self, item):\n if not isinstance(item, six.string_types):\n return False\n return self.stripped_string == stripspace(item)\n\n def describe_to(self, description):\n description.append_description_of(self.original_string) \\\n .append_text(' ignoring whitespace')\n\n\ndef equal_to_ignoring_whitespace(string):\n \"\"\"Matches if object is a string equal to a given string, ignoring\n differences in whitespace.\n\n :param string: The string to compare against as the expected value.\n\n This matcher first checks whether the evaluated object is a string. If so,\n it compares it with ``string``, ignoring differences in runs of whitespace.\n\n Example::\n\n equal_to_ignoring_whitespace(\"hello world\")\n\n will match ``\"hello world\"``.\n\n \"\"\"\n return IsEqualIgnoringWhiteSpace(string)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/library/text/stringcontains.py",
"content": "from hamcrest.library.text.substringmatcher import SubstringMatcher\nfrom hamcrest.core.helpers.hasmethod import hasmethod\n\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\n\nclass StringContains(SubstringMatcher):\n\n def __init__(self, substring):\n super(StringContains, self).__init__(substring)\n\n def _matches(self, item):\n if not hasmethod(item, 'find'):\n return False\n return item.find(self.substring) >= 0\n\n def relationship(self):\n return 'containing'\n\n\ndef contains_string(substring):\n \"\"\"Matches if object is a string containing a given string.\n\n :param string: The string to search for.\n\n This matcher first checks whether the evaluated object is a string. If so,\n it checks whether it contains ``string``.\n\n Example::\n\n contains_string(\"def\")\n\n will match \"abcdefg\".\n\n \"\"\"\n return StringContains(substring)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/library/text/stringcontainsinorder.py",
"content": "__author__ = \"Romilly Cocking\"\r\n__copyright__ = \"Copyright 2011 hamcrest.org\"\r\n__license__ = \"BSD, see License.txt\"\r\n\r\nfrom hamcrest.core.base_matcher import BaseMatcher\r\nfrom hamcrest.core.helpers.hasmethod import hasmethod\r\n\r\nimport six\r\n\r\nclass StringContainsInOrder(BaseMatcher):\r\n\r\n def __init__(self, *substrings):\r\n for substring in substrings:\r\n if not isinstance(substring, six.string_types):\r\n raise TypeError(self.__class__.__name__\r\n + ' requires string arguments')\r\n self.substrings = substrings\r\n\r\n def _matches(self, item):\r\n if not hasmethod(item, 'find'):\r\n return False\r\n from_index = 0\r\n for substring in self.substrings:\r\n from_index = item.find(substring, from_index)\r\n if from_index == -1:\r\n return False\r\n return True\r\n\r\n def describe_to(self, description):\r\n description.append_list('a string containing ', ', ', ' in order',\r\n self.substrings)\r\n\r\n\r\ndef string_contains_in_order(*substrings):\r\n \"\"\"Matches if object is a string containing a given list of substrings in\r\n relative order.\r\n\r\n :param string1,...: A comma-separated list of strings.\r\n\r\n This matcher first checks whether the evaluated object is a string. If so,\r\n it checks whether it contains a given list of strings, in relative order to\r\n each other. The searches are performed starting from the beginning of the\r\n evaluated string.\r\n\r\n Example::\r\n\r\n string_contains_in_order(\"bc\", \"fg\", \"jkl\")\r\n\r\n will match \"abcdefghijklm\".\r\n\r\n \"\"\"\r\n return StringContainsInOrder(*substrings)\r\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/library/text/stringendswith.py",
"content": "from hamcrest.library.text.substringmatcher import SubstringMatcher\nfrom hamcrest.core.helpers.hasmethod import hasmethod\n\n__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\n\nclass StringEndsWith(SubstringMatcher):\n\n def __init__(self, substring):\n super(StringEndsWith, self).__init__(substring)\n\n def _matches(self, item):\n if not hasmethod(item, 'endswith'):\n return False\n return item.endswith(self.substring)\n\n def relationship(self):\n return 'ending with'\n\n\ndef ends_with(string):\n \"\"\"Matches if object is a string ending with a given string.\n\n :param string: The string to search for.\n\n This matcher first checks whether the evaluated object is a string. If so,\n it checks if ``string`` matches the ending characters of the evaluated\n object.\n\n Example::\n\n ends_with(\"bar\")\n\n will match \"foobar\".\n\n \"\"\"\n return StringEndsWith(string)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/library/text/stringmatches.py",
"content": "__author__ = \"Chris Rose\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\nimport re\n\nimport six\n\nfrom hamcrest.core.base_matcher import BaseMatcher\nfrom hamcrest.core.helpers.hasmethod import hasmethod\n\nclass StringMatchesPattern(BaseMatcher):\n\n def __init__(self, pattern):\n self.pattern = pattern\n\n def describe_to(self, description):\n description.append_text(\"a string matching '\") \\\n .append_text(self.pattern.pattern) \\\n .append_text(\"'\")\n\n def _matches(self, item):\n return self.pattern.search(item) is not None\n\n\ndef matches_regexp(pattern):\n \"\"\"Matches if object is a string containing a match for a given regular\n expression.\n\n :param pattern: The regular expression to search for.\n\n This matcher first checks whether the evaluated object is a string. If so,\n it checks if the regular expression ``pattern`` matches anywhere within the\n evaluated object.\n\n \"\"\"\n if isinstance(pattern, six.string_types):\n pattern = re.compile(pattern)\n\n return StringMatchesPattern(pattern)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/library/text/stringstartswith.py",
"content": "__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\nfrom hamcrest.library.text.substringmatcher import SubstringMatcher\nfrom hamcrest.core.helpers.hasmethod import hasmethod\n\n\nclass StringStartsWith(SubstringMatcher):\n\n def __init__(self, substring):\n super(StringStartsWith, self).__init__(substring)\n\n def _matches(self, item):\n if not hasmethod(item, 'startswith'):\n return False\n return item.startswith(self.substring)\n\n def relationship(self):\n return 'starting with'\n\n\ndef starts_with(substring):\n \"\"\"Matches if object is a string starting with a given string.\n\n :param string: The string to search for.\n\n This matcher first checks whether the evaluated object is a string. If so,\n it checks if ``string`` matches the beginning characters of the evaluated\n object.\n\n Example::\n\n starts_with(\"foo\")\n\n will match \"foobar\".\n\n \"\"\"\n return StringStartsWith(substring)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hamcrest/library/text/substringmatcher.py",
"content": "__author__ = \"Jon Reid\"\n__copyright__ = \"Copyright 2011 hamcrest.org\"\n__license__ = \"BSD, see License.txt\"\n\nfrom hamcrest.core.base_matcher import BaseMatcher\n\nimport six\n\nclass SubstringMatcher(BaseMatcher):\n\n def __init__(self, substring):\n if not isinstance(substring, six.string_types):\n raise TypeError(self.__class__.__name__ + ' requires string')\n self.substring = substring\n\n def describe_to(self, description):\n description.append_text('a string ') \\\n .append_text(self.relationship()) \\\n .append_text(' ') \\\n .append_description_of(self.substring)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hyperlink/__init__.py",
"content": "\nfrom ._url import (URL,\n parse,\n EncodedURL,\n DecodedURL,\n URLParseError,\n register_scheme)\n\n__all__ = [\n \"URL\",\n \"parse\",\n \"EncodedURL\",\n \"DecodedURL\",\n \"URLParseError\",\n \"register_scheme\",\n]\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hyperlink/_url.py",
"content": "# -*- coding: utf-8 -*-\nu\"\"\"Hyperlink provides Pythonic URL parsing, construction, and rendering.\n\nUsage is straightforward::\n\n >>> from hyperlink import URL\n >>> url = URL.from_text(u'http://github.com/mahmoud/hyperlink?utm_source=docs')\n >>> url.host\n u'github.com'\n >>> secure_url = url.replace(scheme=u'https')\n >>> secure_url.get('utm_source')[0]\n u'docs'\n\nAs seen here, the API revolves around the lightweight and immutable\n:class:`URL` type, documented below.\n\"\"\"\n\nimport re\nimport sys\nimport string\nimport socket\nfrom unicodedata import normalize\ntry:\n from socket import inet_pton\nexcept ImportError:\n inet_pton = None # defined below\ntry:\n from collections.abc import Mapping\nexcept ImportError: # Python 2\n from collections import Mapping\n\n# Note: IDNAError is a subclass of UnicodeError\nfrom idna import encode as idna_encode, decode as idna_decode, IDNAError\n\n\nif inet_pton is None:\n # based on https://gist.github.com/nnemkin/4966028\n # this code only applies on Windows Python 2.7\n import ctypes\n\n class _sockaddr(ctypes.Structure):\n _fields_ = [(\"sa_family\", ctypes.c_short),\n (\"__pad1\", ctypes.c_ushort),\n (\"ipv4_addr\", ctypes.c_byte * 4),\n (\"ipv6_addr\", ctypes.c_byte * 16),\n (\"__pad2\", ctypes.c_ulong)]\n\n WSAStringToAddressA = ctypes.windll.ws2_32.WSAStringToAddressA\n WSAAddressToStringA = ctypes.windll.ws2_32.WSAAddressToStringA\n\n def inet_pton(address_family, ip_string):\n addr = _sockaddr()\n ip_string = ip_string.encode('ascii')\n addr.sa_family = address_family\n addr_size = ctypes.c_int(ctypes.sizeof(addr))\n\n if WSAStringToAddressA(ip_string, address_family, None, ctypes.byref(addr), ctypes.byref(addr_size)) != 0:\n raise socket.error(ctypes.FormatError())\n\n if address_family == socket.AF_INET:\n return ctypes.string_at(addr.ipv4_addr, 4)\n if address_family == socket.AF_INET6:\n return ctypes.string_at(addr.ipv6_addr, 16)\n raise socket.error('unknown address family')\n\n\nPY2 = (sys.version_info[0] == 2)\nunicode = type(u'')\ntry:\n unichr\nexcept NameError:\n unichr = chr # py3\nNoneType = type(None)\n\n\n# from boltons.typeutils\ndef make_sentinel(name='_MISSING', var_name=None):\n \"\"\"Creates and returns a new **instance** of a new class, suitable for\n usage as a \"sentinel\", a kind of singleton often used to indicate\n a value is missing when ``None`` is a valid input.\n\n Args:\n name (str): Name of the Sentinel\n var_name (str): Set this name to the name of the variable in\n its respective module enable pickleability.\n\n >>> make_sentinel(var_name='_MISSING')\n _MISSING\n\n The most common use cases here in boltons are as default values\n for optional function arguments, partly because of its\n less-confusing appearance in automatically generated\n documentation. Sentinels also function well as placeholders in queues\n and linked lists.\n\n .. note::\n\n By design, additional calls to ``make_sentinel`` with the same\n values will not produce equivalent objects.\n\n >>> make_sentinel('TEST') == make_sentinel('TEST')\n False\n >>> type(make_sentinel('TEST')) == type(make_sentinel('TEST'))\n False\n\n \"\"\"\n class Sentinel(object):\n def __init__(self):\n self.name = name\n self.var_name = var_name\n\n def __repr__(self):\n if self.var_name:\n return self.var_name\n return '%s(%r)' % (self.__class__.__name__, self.name)\n if var_name:\n def __reduce__(self):\n return self.var_name\n\n def __nonzero__(self):\n return False\n\n __bool__ = __nonzero__\n\n return Sentinel()\n\n\n_unspecified = _UNSET = make_sentinel('_UNSET')\n\n\n# RFC 3986 Section 2.3, Unreserved URI Characters\n# https://tools.ietf.org/html/rfc3986#section-2.3\n_UNRESERVED_CHARS = frozenset('~-._0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ'\n 'abcdefghijklmnopqrstuvwxyz')\n\n\n# URL parsing regex (based on RFC 3986 Appendix B, with modifications)\n_URL_RE = re.compile(r'^((?P[^:/?#]+):)?'\n r'((?P<_netloc_sep>//)'\n r'(?P[^/?#]*))?'\n r'(?P[^?#]*)'\n r'(\\?(?P[^#]*))?'\n r'(#(?P.*))?$')\n_SCHEME_RE = re.compile(r'^[a-zA-Z0-9+-.]*$')\n_AUTHORITY_RE = re.compile(r'^(?:(?P[^@/?#]*)@)?'\n r'(?P'\n r'(?:\\[(?P[^[\\]/?#]*)\\])'\n r'|(?P[^:/?#[\\]]*)'\n r'|(?P.*?))?'\n r'(?::(?P.*))?$')\n\n\n_HEX_CHAR_MAP = dict([((a + b).encode('ascii'),\n unichr(int(a + b, 16)).encode('charmap'))\n for a in string.hexdigits for b in string.hexdigits])\n_ASCII_RE = re.compile('([\\x00-\\x7f]+)')\n\n# RFC 3986 section 2.2, Reserved Characters\n# https://tools.ietf.org/html/rfc3986#section-2.2\n_GEN_DELIMS = frozenset(u':/?#[]@')\n_SUB_DELIMS = frozenset(u\"!$&'()*+,;=\")\n_ALL_DELIMS = _GEN_DELIMS | _SUB_DELIMS\n\n_USERINFO_SAFE = _UNRESERVED_CHARS | _SUB_DELIMS | set(u'%')\n_USERINFO_DELIMS = _ALL_DELIMS - _USERINFO_SAFE\n_PATH_SAFE = _USERINFO_SAFE | set(u':@')\n_PATH_DELIMS = _ALL_DELIMS - _PATH_SAFE\n_SCHEMELESS_PATH_SAFE = _PATH_SAFE - set(':')\n_SCHEMELESS_PATH_DELIMS = _ALL_DELIMS - _SCHEMELESS_PATH_SAFE\n_FRAGMENT_SAFE = _UNRESERVED_CHARS | _PATH_SAFE | set(u'/?')\n_FRAGMENT_DELIMS = _ALL_DELIMS - _FRAGMENT_SAFE\n_QUERY_VALUE_SAFE = _UNRESERVED_CHARS | _FRAGMENT_SAFE - set(u'&+')\n_QUERY_VALUE_DELIMS = _ALL_DELIMS - _QUERY_VALUE_SAFE\n_QUERY_KEY_SAFE = _UNRESERVED_CHARS | _QUERY_VALUE_SAFE - set(u'=')\n_QUERY_KEY_DELIMS = _ALL_DELIMS - _QUERY_KEY_SAFE\n\n\ndef _make_decode_map(delims, allow_percent=False):\n ret = dict(_HEX_CHAR_MAP)\n if not allow_percent:\n delims = set(delims) | set([u'%'])\n for delim in delims:\n _hexord = '{0:02X}'.format(ord(delim)).encode('ascii')\n _hexord_lower = _hexord.lower()\n ret.pop(_hexord)\n if _hexord != _hexord_lower:\n ret.pop(_hexord_lower)\n return ret\n\n\ndef _make_quote_map(safe_chars):\n ret = {}\n # v is included in the dict for py3 mostly, because bytestrings\n # are iterables of ints, of course!\n for i, v in zip(range(256), range(256)):\n c = chr(v)\n if c in safe_chars:\n ret[c] = ret[v] = c\n else:\n ret[c] = ret[v] = '%{0:02X}'.format(i)\n return ret\n\n\n_USERINFO_PART_QUOTE_MAP = _make_quote_map(_USERINFO_SAFE)\n_USERINFO_DECODE_MAP = _make_decode_map(_USERINFO_DELIMS)\n_PATH_PART_QUOTE_MAP = _make_quote_map(_PATH_SAFE)\n_SCHEMELESS_PATH_PART_QUOTE_MAP = _make_quote_map(_SCHEMELESS_PATH_SAFE)\n_PATH_DECODE_MAP = _make_decode_map(_PATH_DELIMS)\n_QUERY_KEY_QUOTE_MAP = _make_quote_map(_QUERY_KEY_SAFE)\n_QUERY_KEY_DECODE_MAP = _make_decode_map(_QUERY_KEY_DELIMS)\n_QUERY_VALUE_QUOTE_MAP = _make_quote_map(_QUERY_VALUE_SAFE)\n_QUERY_VALUE_DECODE_MAP = _make_decode_map(_QUERY_VALUE_DELIMS)\n_FRAGMENT_QUOTE_MAP = _make_quote_map(_FRAGMENT_SAFE)\n_FRAGMENT_DECODE_MAP = _make_decode_map(_FRAGMENT_DELIMS)\n_UNRESERVED_QUOTE_MAP = _make_quote_map(_UNRESERVED_CHARS)\n_UNRESERVED_DECODE_MAP = dict([(k, v) for k, v in _HEX_CHAR_MAP.items()\n if v.decode('ascii', 'replace')\n in _UNRESERVED_CHARS])\n\n_ROOT_PATHS = frozenset(((), (u'',)))\n\n\ndef _encode_reserved(text, maximal=True):\n \"\"\"A very comprehensive percent encoding for encoding all\n delimiters. Used for arguments to DecodedURL, where a % means a\n percent sign, and not the character used by URLs for escaping\n bytes.\n \"\"\"\n if maximal:\n bytestr = normalize('NFC', text).encode('utf8')\n return u''.join([_UNRESERVED_QUOTE_MAP[b] for b in bytestr])\n return u''.join([_UNRESERVED_QUOTE_MAP[t] if t in _UNRESERVED_CHARS\n else t for t in text])\n\n\ndef _encode_path_part(text, maximal=True):\n \"Percent-encode a single segment of a URL path.\"\n if maximal:\n bytestr = normalize('NFC', text).encode('utf8')\n return u''.join([_PATH_PART_QUOTE_MAP[b] for b in bytestr])\n return u''.join([_PATH_PART_QUOTE_MAP[t] if t in _PATH_DELIMS else t\n for t in text])\n\n\ndef _encode_schemeless_path_part(text, maximal=True):\n \"\"\"Percent-encode the first segment of a URL path for a URL without a\n scheme specified.\n \"\"\"\n if maximal:\n bytestr = normalize('NFC', text).encode('utf8')\n return u''.join([_SCHEMELESS_PATH_PART_QUOTE_MAP[b] for b in bytestr])\n return u''.join([_SCHEMELESS_PATH_PART_QUOTE_MAP[t]\n if t in _SCHEMELESS_PATH_DELIMS else t for t in text])\n\n\ndef _encode_path_parts(text_parts, rooted=False, has_scheme=True,\n has_authority=True, joined=True, maximal=True):\n \"\"\"\n Percent-encode a tuple of path parts into a complete path.\n\n Setting *maximal* to False percent-encodes only the reserved\n characters that are syntactically necessary for serialization,\n preserving any IRI-style textual data.\n\n Leaving *maximal* set to its default True percent-encodes\n everything required to convert a portion of an IRI to a portion of\n a URI.\n\n RFC 3986 3.3:\n\n If a URI contains an authority component, then the path component\n must either be empty or begin with a slash (\"/\") character. If a URI\n does not contain an authority component, then the path cannot begin\n with two slash characters (\"//\"). In addition, a URI reference\n (Section 4.1) may be a relative-path reference, in which case the\n first path segment cannot contain a colon (\":\") character.\n \"\"\"\n if not text_parts:\n return u'' if joined else text_parts\n if rooted:\n text_parts = (u'',) + text_parts\n # elif has_authority and text_parts:\n # raise Exception('see rfc above') # TODO: too late to fail like this?\n encoded_parts = []\n if has_scheme:\n encoded_parts = [_encode_path_part(part, maximal=maximal)\n if part else part for part in text_parts]\n else:\n encoded_parts = [_encode_schemeless_path_part(text_parts[0])]\n encoded_parts.extend([_encode_path_part(part, maximal=maximal)\n if part else part for part in text_parts[1:]])\n if joined:\n return u'/'.join(encoded_parts)\n return tuple(encoded_parts)\n\n\ndef _encode_query_key(text, maximal=True):\n \"\"\"\n Percent-encode a single query string key or value.\n \"\"\"\n if maximal:\n bytestr = normalize('NFC', text).encode('utf8')\n return u''.join([_QUERY_KEY_QUOTE_MAP[b] for b in bytestr])\n return u''.join([_QUERY_KEY_QUOTE_MAP[t] if t in _QUERY_KEY_DELIMS else t\n for t in text])\n\n\ndef _encode_query_value(text, maximal=True):\n \"\"\"\n Percent-encode a single query string key or value.\n \"\"\"\n if maximal:\n bytestr = normalize('NFC', text).encode('utf8')\n return u''.join([_QUERY_VALUE_QUOTE_MAP[b] for b in bytestr])\n return u''.join([_QUERY_VALUE_QUOTE_MAP[t]\n if t in _QUERY_VALUE_DELIMS else t for t in text])\n\n\ndef _encode_fragment_part(text, maximal=True):\n \"\"\"Quote the fragment part of the URL. Fragments don't have\n subdelimiters, so the whole URL fragment can be passed.\n \"\"\"\n if maximal:\n bytestr = normalize('NFC', text).encode('utf8')\n return u''.join([_FRAGMENT_QUOTE_MAP[b] for b in bytestr])\n return u''.join([_FRAGMENT_QUOTE_MAP[t] if t in _FRAGMENT_DELIMS else t\n for t in text])\n\n\ndef _encode_userinfo_part(text, maximal=True):\n \"\"\"Quote special characters in either the username or password\n section of the URL.\n \"\"\"\n if maximal:\n bytestr = normalize('NFC', text).encode('utf8')\n return u''.join([_USERINFO_PART_QUOTE_MAP[b] for b in bytestr])\n return u''.join([_USERINFO_PART_QUOTE_MAP[t] if t in _USERINFO_DELIMS\n else t for t in text])\n\n\n\n# This port list painstakingly curated by hand searching through\n# https://www.iana.org/assignments/uri-schemes/uri-schemes.xhtml\n# and\n# https://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.xhtml\nSCHEME_PORT_MAP = {'acap': 674, 'afp': 548, 'dict': 2628, 'dns': 53,\n 'file': None, 'ftp': 21, 'git': 9418, 'gopher': 70,\n 'http': 80, 'https': 443, 'imap': 143, 'ipp': 631,\n 'ipps': 631, 'irc': 194, 'ircs': 6697, 'ldap': 389,\n 'ldaps': 636, 'mms': 1755, 'msrp': 2855, 'msrps': None,\n 'mtqp': 1038, 'nfs': 111, 'nntp': 119, 'nntps': 563,\n 'pop': 110, 'prospero': 1525, 'redis': 6379, 'rsync': 873,\n 'rtsp': 554, 'rtsps': 322, 'rtspu': 5005, 'sftp': 22,\n 'smb': 445, 'snmp': 161, 'ssh': 22, 'steam': None,\n 'svn': 3690, 'telnet': 23, 'ventrilo': 3784, 'vnc': 5900,\n 'wais': 210, 'ws': 80, 'wss': 443, 'xmpp': None}\n\n# This list of schemes that don't use authorities is also from the link above.\nNO_NETLOC_SCHEMES = set(['urn', 'about', 'bitcoin', 'blob', 'data', 'geo',\n 'magnet', 'mailto', 'news', 'pkcs11',\n 'sip', 'sips', 'tel'])\n# As of Mar 11, 2017, there were 44 netloc schemes, and 13 non-netloc\n\n\ndef register_scheme(text, uses_netloc=True, default_port=None):\n \"\"\"Registers new scheme information, resulting in correct port and\n slash behavior from the URL object. There are dozens of standard\n schemes preregistered, so this function is mostly meant for\n proprietary internal customizations or stopgaps on missing\n standards information. If a scheme seems to be missing, please\n `file an issue`_!\n\n Args:\n text (unicode): Text representing the scheme.\n (the 'http' in 'http://hatnote.com')\n uses_netloc (bool): Does the scheme support specifying a\n network host? For instance, \"http\" does, \"mailto\" does\n not. Defaults to True.\n default_port (int): The default port, if any, for netloc-using\n schemes.\n\n .. _file an issue: https://github.com/mahmoud/hyperlink/issues\n\n \"\"\"\n text = text.lower()\n if default_port is not None:\n try:\n default_port = int(default_port)\n except (ValueError, TypeError):\n raise ValueError('default_port expected integer or None, not %r'\n % (default_port,))\n\n if uses_netloc is True:\n SCHEME_PORT_MAP[text] = default_port\n elif uses_netloc is False:\n if default_port is not None:\n raise ValueError('unexpected default port while specifying'\n ' non-netloc scheme: %r' % default_port)\n NO_NETLOC_SCHEMES.add(text)\n else:\n raise ValueError('uses_netloc expected bool, not: %r' % uses_netloc)\n\n return\n\n\ndef scheme_uses_netloc(scheme, default=None):\n \"\"\"Whether or not a URL uses :code:`:` or :code:`://` to separate the\n scheme from the rest of the URL depends on the scheme's own\n standard definition. There is no way to infer this behavior\n from other parts of the URL. A scheme either supports network\n locations or it does not.\n\n The URL type's approach to this is to check for explicitly\n registered schemes, with common schemes like HTTP\n preregistered. This is the same approach taken by\n :mod:`urlparse`.\n\n URL adds two additional heuristics if the scheme as a whole is\n not registered. First, it attempts to check the subpart of the\n scheme after the last ``+`` character. This adds intuitive\n behavior for schemes like ``git+ssh``. Second, if a URL with\n an unrecognized scheme is loaded, it will maintain the\n separator it sees.\n \"\"\"\n if not scheme:\n return False\n scheme = scheme.lower()\n if scheme in SCHEME_PORT_MAP:\n return True\n if scheme in NO_NETLOC_SCHEMES:\n return False\n if scheme.split('+')[-1] in SCHEME_PORT_MAP:\n return True\n return default\n\n\nclass URLParseError(ValueError):\n \"\"\"Exception inheriting from :exc:`ValueError`, raised when failing to\n parse a URL. Mostly raised on invalid ports and IPv6 addresses.\n \"\"\"\n pass\n\n\ndef _optional(argument, default):\n if argument is _UNSET:\n return default\n else:\n return argument\n\n\ndef _typecheck(name, value, *types):\n \"\"\"\n Check that the given *value* is one of the given *types*, or raise an\n exception describing the problem using *name*.\n \"\"\"\n if not types:\n raise ValueError('expected one or more types, maybe use _textcheck?')\n if not isinstance(value, types):\n raise TypeError(\"expected %s for %s, got %r\"\n % (\" or \".join([t.__name__ for t in types]),\n name, value))\n return value\n\n\ndef _textcheck(name, value, delims=frozenset(), nullable=False):\n if not isinstance(value, unicode):\n if nullable and value is None:\n return value # used by query string values\n else:\n str_name = \"unicode\" if PY2 else \"str\"\n exp = str_name + ' or NoneType' if nullable else str_name\n raise TypeError('expected %s for %s, got %r' % (exp, name, value))\n if delims and set(value) & set(delims): # TODO: test caching into regexes\n raise ValueError('one or more reserved delimiters %s present in %s: %r'\n % (''.join(delims), name, value))\n return value\n\n\ndef iter_pairs(iterable):\n \"\"\"\n Iterate over the (key, value) pairs in ``iterable``.\n\n This handles dictionaries sensibly, and falls back to assuming the\n iterable yields (key, value) pairs. This behaviour is similar to\n what Python's ``dict()`` constructor does.\n \"\"\"\n if isinstance(iterable, Mapping):\n iterable = iterable.items()\n return iter(iterable)\n\n\ndef _decode_unreserved(text, normalize_case=False, encode_stray_percents=False):\n return _percent_decode(text, normalize_case=normalize_case,\n encode_stray_percents=encode_stray_percents,\n _decode_map=_UNRESERVED_DECODE_MAP)\n\n\ndef _decode_userinfo_part(text, normalize_case=False, encode_stray_percents=False):\n return _percent_decode(text, normalize_case=normalize_case,\n encode_stray_percents=encode_stray_percents,\n _decode_map=_USERINFO_DECODE_MAP)\n\n\ndef _decode_path_part(text, normalize_case=False, encode_stray_percents=False):\n \"\"\"\n >>> _decode_path_part(u'%61%77%2f%7a')\n u'aw%2fz'\n >>> _decode_path_part(u'%61%77%2f%7a', normalize_case=True)\n u'aw%2Fz'\n \"\"\"\n return _percent_decode(text, normalize_case=normalize_case,\n encode_stray_percents=encode_stray_percents,\n _decode_map=_PATH_DECODE_MAP)\n\n\ndef _decode_query_key(text, normalize_case=False, encode_stray_percents=False):\n return _percent_decode(text, normalize_case=normalize_case,\n encode_stray_percents=encode_stray_percents,\n _decode_map=_QUERY_KEY_DECODE_MAP)\n\n\ndef _decode_query_value(text, normalize_case=False, encode_stray_percents=False):\n return _percent_decode(text, normalize_case=normalize_case,\n encode_stray_percents=encode_stray_percents,\n _decode_map=_QUERY_VALUE_DECODE_MAP)\n\n\ndef _decode_fragment_part(text, normalize_case=False, encode_stray_percents=False):\n return _percent_decode(text, normalize_case=normalize_case,\n encode_stray_percents=encode_stray_percents,\n _decode_map=_FRAGMENT_DECODE_MAP)\n\n\ndef _percent_decode(text, normalize_case=False, subencoding='utf-8',\n raise_subencoding_exc=False, encode_stray_percents=False,\n _decode_map=_HEX_CHAR_MAP):\n \"\"\"Convert percent-encoded text characters to their normal,\n human-readable equivalents.\n\n All characters in the input text must be encodable by\n *subencoding*. All special characters underlying the values in the\n percent-encoding must be decodable as *subencoding*. If a\n non-*subencoding*-valid string is passed, the original text is\n returned with no changes applied.\n\n Only called by field-tailored variants, e.g.,\n :func:`_decode_path_part`, as every percent-encodable part of the\n URL has characters which should not be percent decoded.\n\n >>> _percent_decode(u'abc%20def')\n u'abc def'\n\n Args:\n text (unicode): Text with percent-encoding present.\n normalize_case (bool): Whether undecoded percent segments, such\n as encoded delimiters, should be uppercased, per RFC 3986\n Section 2.1. See :func:`_decode_path_part` for an example.\n subencoding (unicode): The name of the encoding underlying the\n percent-encoding. Pass `False` to get back raw bytes.\n raise_subencoding_exc (bool): Whether an error in decoding the bytes\n underlying the percent-decoding should be raised.\n\n Returns:\n unicode: The percent-decoded version of *text*, decoded by\n *subencoding*, unless `subencoding=False` which returns bytes.\n\n \"\"\"\n try:\n quoted_bytes = text.encode('utf-8' if subencoding is False else subencoding)\n except UnicodeEncodeError:\n return text\n\n bits = quoted_bytes.split(b'%')\n if len(bits) == 1:\n return text\n\n res = [bits[0]]\n append = res.append\n\n for item in bits[1:]:\n hexpair, rest = item[:2], item[2:]\n try:\n append(_decode_map[hexpair])\n append(rest)\n except KeyError:\n pair_is_hex = hexpair in _HEX_CHAR_MAP\n if pair_is_hex or not encode_stray_percents:\n append(b'%')\n else:\n # if it's undecodable, treat as a real percent sign,\n # which is reserved (because it wasn't in the\n # context-aware _decode_map passed in), and should\n # stay in an encoded state.\n append(b'%25')\n if normalize_case and pair_is_hex:\n append(hexpair.upper())\n append(rest)\n else:\n append(item)\n\n unquoted_bytes = b''.join(res)\n\n if subencoding is False:\n return unquoted_bytes\n try:\n return unquoted_bytes.decode(subencoding)\n except UnicodeDecodeError:\n if raise_subencoding_exc:\n raise\n return text\n\n\ndef _decode_host(host):\n \"\"\"Decode a host from ASCII-encodable text to IDNA-decoded text. If\n the host text is not ASCII, it is returned unchanged, as it is\n presumed that it is already IDNA-decoded.\n\n Some technical details: _decode_host is built on top of the \"idna\"\n package, which has some quirks:\n\n Capital letters are not valid IDNA2008. The idna package will\n raise an exception like this on capital letters:\n\n > idna.core.InvalidCodepoint: Codepoint U+004B at position 1 ... not allowed\n\n However, if a segment of a host (i.e., something in\n url.host.split('.')) is already ASCII, idna doesn't perform its\n usual checks. In fact, for capital letters it automatically\n lowercases them.\n\n This check and some other functionality can be bypassed by passing\n uts46=True to idna.encode/decode. This allows a more permissive and\n convenient interface. So far it seems like the balanced approach.\n\n Example output (from idna==2.6):\n\n >> idna.encode(u'mahmöud.io')\n 'xn--mahmud-zxa.io'\n >> idna.encode(u'Mahmöud.io')\n Traceback (most recent call last):\n File \"\", line 1, in \n File \"/home/mahmoud/virtualenvs/hyperlink/local/lib/python2.7/site-packages/idna/core.py\", line 355, in encode\n result.append(alabel(label))\n File \"/home/mahmoud/virtualenvs/hyperlink/local/lib/python2.7/site-packages/idna/core.py\", line 276, in alabel\n check_label(label)\n File \"/home/mahmoud/virtualenvs/hyperlink/local/lib/python2.7/site-packages/idna/core.py\", line 253, in check_label\n raise InvalidCodepoint('Codepoint {0} at position {1} of {2} not allowed'.format(_unot(cp_value), pos+1, repr(label)))\n idna.core.InvalidCodepoint: Codepoint U+004D at position 1 of u'Mahm\\xf6ud' not allowed\n >> idna.encode(u'Mahmoud.io')\n 'Mahmoud.io'\n\n # Similar behavior for decodes below\n >> idna.decode(u'Mahmoud.io')\n u'mahmoud.io\n >> idna.decode(u'Méhmoud.io', uts46=True)\n u'm\\xe9hmoud.io'\n \"\"\"\n if not host:\n return u''\n try:\n host_bytes = host.encode(\"ascii\")\n except UnicodeEncodeError:\n host_text = host\n else:\n try:\n host_text = idna_decode(host_bytes, uts46=True)\n except ValueError:\n # only reached on \"narrow\" (UCS-2) Python builds <3.4, see #7\n # NOTE: not going to raise here, because there's no\n # ambiguity in the IDNA, and the host is still\n # technically usable\n host_text = host\n return host_text\n\n\ndef _resolve_dot_segments(path):\n \"\"\"Normalize the URL path by resolving segments of '.' and '..'. For\n more details, see `RFC 3986 section 5.2.4, Remove Dot Segments`_.\n\n Args:\n path (list): path segments in string form\n\n Returns:\n list: a new list of path segments with the '.' and '..' elements\n removed and resolved.\n\n .. _RFC 3986 section 5.2.4, Remove Dot Segments: https://tools.ietf.org/html/rfc3986#section-5.2.4\n \"\"\"\n segs = []\n\n for seg in path:\n if seg == u'.':\n pass\n elif seg == u'..':\n if segs:\n segs.pop()\n else:\n segs.append(seg)\n\n if list(path[-1:]) in ([u'.'], [u'..']):\n segs.append(u'')\n\n return segs\n\n\ndef parse_host(host):\n \"\"\"Parse the host into a tuple of ``(family, host)``, where family\n is the appropriate :mod:`socket` module constant when the host is\n an IP address. Family is ``None`` when the host is not an IP.\n\n Will raise :class:`URLParseError` on invalid IPv6 constants.\n\n Returns:\n tuple: family (socket constant or None), host (string)\n\n >>> parse_host('googlewebsite.com') == (None, 'googlewebsite.com')\n True\n >>> parse_host('::1') == (socket.AF_INET6, '::1')\n True\n >>> parse_host('192.168.1.1') == (socket.AF_INET, '192.168.1.1')\n True\n \"\"\"\n if not host:\n return None, u''\n if u':' in host:\n try:\n inet_pton(socket.AF_INET6, host)\n except socket.error as se:\n raise URLParseError('invalid IPv6 host: %r (%r)' % (host, se))\n except UnicodeEncodeError:\n pass # TODO: this can't be a real host right?\n else:\n family = socket.AF_INET6\n return family, host\n try:\n inet_pton(socket.AF_INET, host)\n except (socket.error, UnicodeEncodeError):\n family = None # not an IP\n else:\n family = socket.AF_INET\n return family, host\n\n\nclass URL(object):\n \"\"\"From blogs to billboards, URLs are so common, that it's easy to\n overlook their complexity and power. With hyperlink's\n :class:`URL` type, working with URLs doesn't have to be hard.\n\n URLs are made of many parts. Most of these parts are officially\n named in `RFC 3986`_ and this diagram may prove handy in identifying\n them::\n\n foo://user:pass@example.com:8042/over/there?name=ferret#nose\n \\_/ \\_______/ \\_________/ \\__/\\_________/ \\_________/ \\__/\n | | | | | | |\n scheme userinfo host port path query fragment\n\n While :meth:`~URL.from_text` is used for parsing whole URLs, the\n :class:`URL` constructor builds a URL from the individual\n components, like so::\n\n >>> from hyperlink import URL\n >>> url = URL(scheme=u'https', host=u'example.com', path=[u'hello', u'world'])\n >>> print(url.to_text())\n https://example.com/hello/world\n\n The constructor runs basic type checks. All strings are expected\n to be decoded (:class:`unicode` in Python 2). All arguments are\n optional, defaulting to appropriately empty values. A full list of\n constructor arguments is below.\n\n Args:\n scheme (unicode): The text name of the scheme.\n host (unicode): The host portion of the network location\n port (int): The port part of the network location. If\n ``None`` or no port is passed, the port will default to\n the default port of the scheme, if it is known. See the\n ``SCHEME_PORT_MAP`` and :func:`register_default_port`\n for more info.\n path (tuple): A tuple of strings representing the\n slash-separated parts of the path.\n query (tuple): The query parameters, as a dictionary or\n as an iterable of key-value pairs.\n fragment (unicode): The fragment part of the URL.\n rooted (bool): Whether or not the path begins with a slash.\n userinfo (unicode): The username or colon-separated\n username:password pair.\n uses_netloc (bool): Indicates whether two slashes appear\n between the scheme and the host (``http://eg.com`` vs\n ``mailto:e@g.com``). Set automatically based on scheme.\n\n All of these parts are also exposed as read-only attributes of\n URL instances, along with several useful methods.\n\n .. _RFC 3986: https://tools.ietf.org/html/rfc3986\n .. _RFC 3987: https://tools.ietf.org/html/rfc3987\n \"\"\"\n\n def __init__(self, scheme=None, host=None, path=(), query=(), fragment=u'',\n port=None, rooted=None, userinfo=u'', uses_netloc=None):\n if host is not None and scheme is None:\n scheme = u'http' # TODO: why\n if port is None:\n port = SCHEME_PORT_MAP.get(scheme)\n if host and query and not path:\n # per RFC 3986 6.2.3, \"a URI that uses the generic syntax\n # for authority with an empty path should be normalized to\n # a path of '/'.\"\n path = (u'',)\n\n # Now that we're done detecting whether they were passed, we can set\n # them to their defaults:\n if scheme is None:\n scheme = u''\n if host is None:\n host = u''\n if rooted is None:\n rooted = bool(host)\n\n # Set attributes.\n self._scheme = _textcheck(\"scheme\", scheme)\n if self._scheme:\n if not _SCHEME_RE.match(self._scheme):\n raise ValueError('invalid scheme: %r. Only alphanumeric, \"+\",'\n ' \"-\", and \".\" allowed. Did you meant to call'\n ' %s.from_text()?'\n % (self._scheme, self.__class__.__name__))\n\n _, self._host = parse_host(_textcheck('host', host, '/?#@'))\n if isinstance(path, unicode):\n raise TypeError(\"expected iterable of text for path, not: %r\"\n % (path,))\n self._path = tuple((_textcheck(\"path segment\", segment, '/?#')\n for segment in path))\n self._query = tuple(\n (_textcheck(\"query parameter name\", k, '&=#'),\n _textcheck(\"query parameter value\", v, '&#', nullable=True))\n for k, v in iter_pairs(query))\n self._fragment = _textcheck(\"fragment\", fragment)\n self._port = _typecheck(\"port\", port, int, NoneType)\n self._rooted = _typecheck(\"rooted\", rooted, bool)\n self._userinfo = _textcheck(\"userinfo\", userinfo, '/?#@')\n\n uses_netloc = scheme_uses_netloc(self._scheme, uses_netloc)\n self._uses_netloc = _typecheck(\"uses_netloc\",\n uses_netloc, bool, NoneType)\n\n return\n\n def get_decoded_url(self, lazy=False):\n try:\n return self._decoded_url\n except AttributeError:\n self._decoded_url = DecodedURL(self, lazy=lazy)\n return self._decoded_url\n\n @property\n def scheme(self):\n \"\"\"The scheme is a string, and the first part of an absolute URL, the\n part before the first colon, and the part which defines the\n semantics of the rest of the URL. Examples include \"http\",\n \"https\", \"ssh\", \"file\", \"mailto\", and many others. See\n :func:`~hyperlink.register_scheme()` for more info.\n \"\"\"\n return self._scheme\n\n @property\n def host(self):\n \"\"\"The host is a string, and the second standard part of an absolute\n URL. When present, a valid host must be a domain name, or an\n IP (v4 or v6). It occurs before the first slash, or the second\n colon, if a :attr:`~hyperlink.URL.port` is provided.\n \"\"\"\n return self._host\n\n @property\n def port(self):\n \"\"\"The port is an integer that is commonly used in connecting to the\n :attr:`host`, and almost never appears without it.\n\n When not present in the original URL, this attribute defaults\n to the scheme's default port. If the scheme's default port is\n not known, and the port is not provided, this attribute will\n be set to None.\n\n >>> URL.from_text(u'http://example.com/pa/th').port\n 80\n >>> URL.from_text(u'foo://example.com/pa/th').port\n >>> URL.from_text(u'foo://example.com:8042/pa/th').port\n 8042\n\n .. note::\n\n Per the standard, when the port is the same as the schemes\n default port, it will be omitted in the text URL.\n\n \"\"\"\n return self._port\n\n @property\n def path(self):\n \"\"\"A tuple of strings, created by splitting the slash-separated\n hierarchical path. Started by the first slash after the host,\n terminated by a \"?\", which indicates the start of the\n :attr:`~hyperlink.URL.query` string.\n \"\"\"\n return self._path\n\n @property\n def query(self):\n \"\"\"Tuple of pairs, created by splitting the ampersand-separated\n mapping of keys and optional values representing\n non-hierarchical data used to identify the resource. Keys are\n always strings. Values are strings when present, or None when\n missing.\n\n For more operations on the mapping, see\n :meth:`~hyperlink.URL.get()`, :meth:`~hyperlink.URL.add()`,\n :meth:`~hyperlink.URL.set()`, and\n :meth:`~hyperlink.URL.delete()`.\n \"\"\"\n return self._query\n\n @property\n def fragment(self):\n \"\"\"A string, the last part of the URL, indicated by the first \"#\"\n after the :attr:`~hyperlink.URL.path` or\n :attr:`~hyperlink.URL.query`. Enables indirect identification\n of a secondary resource, like an anchor within an HTML page.\n\n \"\"\"\n return self._fragment\n\n @property\n def rooted(self):\n \"\"\"Whether or not the path starts with a forward slash (``/``).\n\n This is taken from the terminology in the BNF grammar,\n specifically the \"path-rootless\", rule, since \"absolute path\"\n and \"absolute URI\" are somewhat ambiguous. :attr:`path` does\n not contain the implicit prefixed ``\"/\"`` since that is\n somewhat awkward to work with.\n\n \"\"\"\n return self._rooted\n\n @property\n def userinfo(self):\n \"\"\"The colon-separated string forming the username-password\n combination.\n \"\"\"\n return self._userinfo\n\n @property\n def uses_netloc(self):\n \"\"\"\n \"\"\"\n return self._uses_netloc\n\n @property\n def user(self):\n \"\"\"\n The user portion of :attr:`~hyperlink.URL.userinfo`.\n \"\"\"\n return self.userinfo.split(u':')[0]\n\n def authority(self, with_password=False, **kw):\n \"\"\"Compute and return the appropriate host/port/userinfo combination.\n\n >>> url = URL.from_text(u'http://user:pass@localhost:8080/a/b?x=y')\n >>> url.authority()\n u'user:@localhost:8080'\n >>> url.authority(with_password=True)\n u'user:pass@localhost:8080'\n\n Args:\n with_password (bool): Whether the return value of this\n method include the password in the URL, if it is\n set. Defaults to False.\n\n Returns:\n str: The authority (network location and user information) portion\n of the URL.\n \"\"\"\n # first, a bit of twisted compat\n with_password = kw.pop('includeSecrets', with_password)\n if kw:\n raise TypeError('got unexpected keyword arguments: %r' % kw.keys())\n host = self.host\n if ':' in host:\n hostport = ['[' + host + ']']\n else:\n hostport = [self.host]\n if self.port != SCHEME_PORT_MAP.get(self.scheme):\n hostport.append(unicode(self.port))\n authority = []\n if self.userinfo:\n userinfo = self.userinfo\n if not with_password and u\":\" in userinfo:\n userinfo = userinfo[:userinfo.index(u\":\") + 1]\n authority.append(userinfo)\n authority.append(u\":\".join(hostport))\n return u\"@\".join(authority)\n\n def __eq__(self, other):\n if not isinstance(other, self.__class__):\n return NotImplemented\n for attr in ['scheme', 'userinfo', 'host', 'query',\n 'fragment', 'port', 'uses_netloc']:\n if getattr(self, attr) != getattr(other, attr):\n return False\n if self.path == other.path or (self.path in _ROOT_PATHS\n and other.path in _ROOT_PATHS):\n return True\n return False\n\n def __ne__(self, other):\n if not isinstance(other, self.__class__):\n return NotImplemented\n return not self.__eq__(other)\n\n def __hash__(self):\n return hash((self.__class__, self.scheme, self.userinfo, self.host,\n self.path, self.query, self.fragment, self.port,\n self.rooted, self.uses_netloc))\n\n @property\n def absolute(self):\n \"\"\"Whether or not the URL is \"absolute\". Absolute URLs are complete\n enough to resolve to a network resource without being relative\n to a base URI.\n\n >>> URL.from_text(u'http://wikipedia.org/').absolute\n True\n >>> URL.from_text(u'?a=b&c=d').absolute\n False\n\n Absolute URLs must have both a scheme and a host set.\n \"\"\"\n return bool(self.scheme and self.host)\n\n def replace(self, scheme=_UNSET, host=_UNSET, path=_UNSET, query=_UNSET,\n fragment=_UNSET, port=_UNSET, rooted=_UNSET, userinfo=_UNSET,\n uses_netloc=_UNSET):\n \"\"\":class:`URL` objects are immutable, which means that attributes\n are designed to be set only once, at construction. Instead of\n modifying an existing URL, one simply creates a copy with the\n desired changes.\n\n If any of the following arguments is omitted, it defaults to\n the value on the current URL.\n\n Args:\n scheme (unicode): The text name of the scheme.\n host (unicode): The host portion of the network location\n port (int): The port part of the network location.\n path (tuple): A tuple of strings representing the\n slash-separated parts of the path.\n query (tuple): The query parameters, as a tuple of\n key-value pairs.\n query (tuple): The query parameters, as a dictionary or\n as an iterable of key-value pairs.\n fragment (unicode): The fragment part of the URL.\n rooted (bool): Whether or not the path begins with a slash.\n userinfo (unicode): The username or colon-separated\n username:password pair.\n uses_netloc (bool): Indicates whether two slashes appear\n between the scheme and the host (``http://eg.com`` vs\n ``mailto:e@g.com``)\n\n Returns:\n URL: a copy of the current :class:`URL`, with new values for\n parameters passed.\n\n \"\"\"\n return self.__class__(\n scheme=_optional(scheme, self.scheme),\n host=_optional(host, self.host),\n path=_optional(path, self.path),\n query=_optional(query, self.query),\n fragment=_optional(fragment, self.fragment),\n port=_optional(port, self.port),\n rooted=_optional(rooted, self.rooted),\n userinfo=_optional(userinfo, self.userinfo),\n uses_netloc=_optional(uses_netloc, self.uses_netloc)\n )\n\n @classmethod\n def from_text(cls, text):\n \"\"\"Whereas the :class:`URL` constructor is useful for constructing\n URLs from parts, :meth:`~URL.from_text` supports parsing whole\n URLs from their string form::\n\n >>> URL.from_text(u'http://example.com')\n URL.from_text(u'http://example.com')\n >>> URL.from_text(u'?a=b&x=y')\n URL.from_text(u'?a=b&x=y')\n\n As you can see above, it's also used as the :func:`repr` of\n :class:`URL` objects. The natural counterpart to\n :func:`~URL.to_text()`. This method only accepts *text*, so be\n sure to decode those bytestrings.\n\n Args:\n text (unicode): A valid URL string.\n\n Returns:\n URL: The structured object version of the parsed string.\n\n .. note::\n\n Somewhat unexpectedly, URLs are a far more permissive\n format than most would assume. Many strings which don't\n look like URLs are still valid URLs. As a result, this\n method only raises :class:`URLParseError` on invalid port\n and IPv6 values in the host portion of the URL.\n\n \"\"\"\n um = _URL_RE.match(_textcheck('text', text))\n try:\n gs = um.groupdict()\n except AttributeError:\n raise URLParseError('could not parse url: %r' % text)\n\n au_text = gs['authority'] or u''\n au_m = _AUTHORITY_RE.match(au_text)\n try:\n au_gs = au_m.groupdict()\n except AttributeError:\n raise URLParseError('invalid authority %r in url: %r'\n % (au_text, text))\n if au_gs['bad_host']:\n raise URLParseError('invalid host %r in url: %r'\n % (au_gs['bad_host'], text))\n\n userinfo = au_gs['userinfo'] or u''\n\n host = au_gs['ipv6_host'] or au_gs['plain_host']\n port = au_gs['port']\n if port is not None:\n try:\n port = int(port)\n except ValueError:\n if not port: # TODO: excessive?\n raise URLParseError('port must not be empty: %r' % au_text)\n raise URLParseError('expected integer for port, not %r' % port)\n\n scheme = gs['scheme'] or u''\n fragment = gs['fragment'] or u''\n uses_netloc = bool(gs['_netloc_sep'])\n\n if gs['path']:\n path = gs['path'].split(u\"/\")\n if not path[0]:\n path.pop(0)\n rooted = True\n else:\n rooted = False\n else:\n path = ()\n rooted = bool(au_text)\n if gs['query']:\n query = ((qe.split(u\"=\", 1) if u'=' in qe else (qe, None))\n for qe in gs['query'].split(u\"&\"))\n else:\n query = ()\n return cls(scheme, host, path, query, fragment, port,\n rooted, userinfo, uses_netloc)\n\n def normalize(self, scheme=True, host=True, path=True, query=True,\n fragment=True, userinfo=True, percents=True):\n \"\"\"Return a new URL object with several standard normalizations\n applied:\n\n * Decode unreserved characters (`RFC 3986 2.3`_)\n * Uppercase remaining percent-encoded octets (`RFC 3986 2.1`_)\n * Convert scheme and host casing to lowercase (`RFC 3986 3.2.2`_)\n * Resolve any \".\" and \"..\" references in the path (`RFC 3986 6.2.2.3`_)\n * Ensure an ending slash on URLs with an empty path (`RFC 3986 6.2.3`_)\n * Encode any stray percent signs (`%`) in percent-encoded\n fields (path, query, fragment, userinfo) (`RFC 3986 2.4`_)\n\n All are applied by default, but normalizations can be disabled\n per-part by passing `False` for that part's corresponding\n name.\n\n Args:\n scheme (bool): Convert the scheme to lowercase\n host (bool): Convert the host to lowercase\n path (bool): Normalize the path (see above for details)\n query (bool): Normalize the query string\n fragment (bool): Normalize the fragment\n userinfo (bool): Normalize the userinfo\n percents (bool): Encode isolated percent signs\n for any percent-encoded fields which are being\n normalized (defaults to True).\n\n >>> url = URL.from_text(u'Http://example.COM/a/../b/./c%2f?%61%')\n >>> print(url.normalize().to_text())\n http://example.com/b/c%2F?a%25\n\n .. _RFC 3986 3.2.2: https://tools.ietf.org/html/rfc3986#section-3.2.2\n .. _RFC 3986 2.3: https://tools.ietf.org/html/rfc3986#section-2.3\n .. _RFC 3986 2.1: https://tools.ietf.org/html/rfc3986#section-2.1\n .. _RFC 3986 6.2.2.3: https://tools.ietf.org/html/rfc3986#section-6.2.2.3\n .. _RFC 3986 6.2.3: https://tools.ietf.org/html/rfc3986#section-6.2.3\n .. _RFC 3986 2.4: https://tools.ietf.org/html/rfc3986#section-2.4\n\n \"\"\"\n kw = {}\n if scheme:\n kw['scheme'] = self.scheme.lower()\n if host:\n kw['host'] = self.host.lower()\n def _dec_unres(target):\n return _decode_unreserved(target, normalize_case=True,\n encode_stray_percents=percents)\n if path:\n if self.path:\n kw['path'] = [_dec_unres(p) for p in _resolve_dot_segments(self.path)]\n else:\n kw['path'] = (u'',)\n if query:\n kw['query'] = [(_dec_unres(k), _dec_unres(v) if v else v)\n for k, v in self.query]\n if fragment:\n kw['fragment'] = _dec_unres(self.fragment)\n if userinfo:\n kw['userinfo'] = u':'.join([_dec_unres(p)\n for p in self.userinfo.split(':', 1)])\n\n return self.replace(**kw)\n\n def child(self, *segments):\n \"\"\"Make a new :class:`URL` where the given path segments are a child\n of this URL, preserving other parts of the URL, including the\n query string and fragment.\n\n For example::\n\n >>> url = URL.from_text(u'http://localhost/a/b?x=y')\n >>> child_url = url.child(u\"c\", u\"d\")\n >>> child_url.to_text()\n u'http://localhost/a/b/c/d?x=y'\n\n Args:\n segments (unicode): Additional parts to be joined and added to\n the path, like :func:`os.path.join`. Special characters\n in segments will be percent encoded.\n\n Returns:\n URL: A copy of the current URL with the extra path segments.\n\n \"\"\"\n if not segments:\n return self\n\n segments = [_textcheck('path segment', s) for s in segments]\n new_segs = _encode_path_parts(segments, joined=False, maximal=False)\n new_path = self.path[:-1 if (self.path and self.path[-1] == u'')\n else None] + new_segs\n return self.replace(path=new_path)\n\n def sibling(self, segment):\n \"\"\"Make a new :class:`URL` with a single path segment that is a\n sibling of this URL path.\n\n Args:\n segment (unicode): A single path segment.\n\n Returns:\n URL: A copy of the current URL with the last path segment\n replaced by *segment*. Special characters such as\n ``/?#`` will be percent encoded.\n\n \"\"\"\n _textcheck('path segment', segment)\n new_path = self.path[:-1] + (_encode_path_part(segment),)\n return self.replace(path=new_path)\n\n def click(self, href=u''):\n \"\"\"Resolve the given URL relative to this URL.\n\n The resulting URI should match what a web browser would\n generate if you visited the current URL and clicked on *href*.\n\n >>> url = URL.from_text(u'http://blog.hatnote.com/')\n >>> url.click(u'/post/155074058790').to_text()\n u'http://blog.hatnote.com/post/155074058790'\n >>> url = URL.from_text(u'http://localhost/a/b/c/')\n >>> url.click(u'../d/./e').to_text()\n u'http://localhost/a/b/d/e'\n\n Args:\n href (unicode): A string representing a clicked URL.\n\n Return:\n URL: A copy of the current URL with navigation logic applied.\n\n For more information, see `RFC 3986 section 5`_.\n\n .. _RFC 3986 section 5: https://tools.ietf.org/html/rfc3986#section-5\n \"\"\"\n if href:\n if isinstance(href, URL):\n clicked = href\n else:\n # TODO: This error message is not completely accurate,\n # as URL objects are now also valid, but Twisted's\n # test suite (wrongly) relies on this exact message.\n _textcheck('relative URL', href)\n clicked = URL.from_text(href)\n if clicked.absolute:\n return clicked\n else:\n clicked = self\n\n query = clicked.query\n if clicked.scheme and not clicked.rooted:\n # Schemes with relative paths are not well-defined. RFC 3986 calls\n # them a \"loophole in prior specifications\" that should be avoided,\n # or supported only for backwards compatibility.\n raise NotImplementedError('absolute URI with rootless path: %r'\n % (href,))\n else:\n if clicked.rooted:\n path = clicked.path\n elif clicked.path:\n path = self.path[:-1] + clicked.path\n else:\n path = self.path\n if not query:\n query = self.query\n return self.replace(scheme=clicked.scheme or self.scheme,\n host=clicked.host or self.host,\n port=clicked.port or self.port,\n path=_resolve_dot_segments(path),\n query=query,\n fragment=clicked.fragment)\n\n def to_uri(self):\n u\"\"\"Make a new :class:`URL` instance with all non-ASCII characters\n appropriately percent-encoded. This is useful to do in preparation\n for sending a :class:`URL` over a network protocol.\n\n For example::\n\n >>> URL.from_text(u'https://ايران.com/foo⇧bar/').to_uri()\n URL.from_text(u'https://xn--mgba3a4fra.com/foo%E2%87%A7bar/')\n\n Returns:\n URL: A new instance with its path segments, query parameters, and\n hostname encoded, so that they are all in the standard\n US-ASCII range.\n \"\"\"\n new_userinfo = u':'.join([_encode_userinfo_part(p) for p in\n self.userinfo.split(':', 1)])\n new_path = _encode_path_parts(self.path, has_scheme=bool(self.scheme),\n rooted=False, joined=False, maximal=True)\n new_host = self.host if not self.host else idna_encode(self.host, uts46=True).decode(\"ascii\")\n return self.replace(\n userinfo=new_userinfo,\n host=new_host,\n path=new_path,\n query=tuple([(_encode_query_key(k, maximal=True),\n _encode_query_value(v, maximal=True)\n if v is not None else None)\n for k, v in self.query]),\n fragment=_encode_fragment_part(self.fragment, maximal=True)\n )\n\n def to_iri(self):\n u\"\"\"Make a new :class:`URL` instance with all but a few reserved\n characters decoded into human-readable format.\n\n Percent-encoded Unicode and IDNA-encoded hostnames are\n decoded, like so::\n\n >>> url = URL.from_text(u'https://xn--mgba3a4fra.example.com/foo%E2%87%A7bar/')\n >>> print(url.to_iri().to_text())\n https://ايران.example.com/foo⇧bar/\n\n .. note::\n\n As a general Python issue, \"narrow\" (UCS-2) builds of\n Python may not be able to fully decode certain URLs, and\n the in those cases, this method will return a best-effort,\n partially-decoded, URL which is still valid. This issue\n does not affect any Python builds 3.4+.\n\n Returns:\n URL: A new instance with its path segments, query parameters, and\n hostname decoded for display purposes.\n \"\"\"\n new_userinfo = u':'.join([_decode_userinfo_part(p) for p in\n self.userinfo.split(':', 1)])\n host_text = _decode_host(self.host)\n\n return self.replace(userinfo=new_userinfo,\n host=host_text,\n path=[_decode_path_part(segment)\n for segment in self.path],\n query=[(_decode_query_key(k),\n _decode_query_value(v)\n if v is not None else None)\n for k, v in self.query],\n fragment=_decode_fragment_part(self.fragment))\n\n def to_text(self, with_password=False):\n \"\"\"Render this URL to its textual representation.\n\n By default, the URL text will *not* include a password, if one\n is set. RFC 3986 considers using URLs to represent such\n sensitive information as deprecated. Quoting from RFC 3986,\n `section 3.2.1`:\n\n \"Applications should not render as clear text any data after the\n first colon (\":\") character found within a userinfo subcomponent\n unless the data after the colon is the empty string (indicating no\n password).\"\n\n Args:\n with_password (bool): Whether or not to include the\n password in the URL text. Defaults to False.\n\n Returns:\n str: The serialized textual representation of this URL,\n such as ``u\"http://example.com/some/path?some=query\"``.\n\n The natural counterpart to :class:`URL.from_text()`.\n\n .. _section 3.2.1: https://tools.ietf.org/html/rfc3986#section-3.2.1\n \"\"\"\n scheme = self.scheme\n authority = self.authority(with_password)\n path = _encode_path_parts(self.path,\n rooted=self.rooted,\n has_scheme=bool(scheme),\n has_authority=bool(authority),\n maximal=False)\n query_parts = []\n for k, v in self.query:\n if v is None:\n query_parts.append(_encode_query_key(k, maximal=False))\n else:\n query_parts.append(u'='.join((_encode_query_key(k, maximal=False),\n _encode_query_value(v, maximal=False))))\n query_string = u'&'.join(query_parts)\n\n fragment = self.fragment\n\n parts = []\n _add = parts.append\n if scheme:\n _add(scheme)\n _add(':')\n if authority:\n _add('//')\n _add(authority)\n elif (scheme and path[:2] != '//' and self.uses_netloc):\n _add('//')\n if path:\n if scheme and authority and path[:1] != '/':\n _add('/') # relpaths with abs authorities auto get '/'\n _add(path)\n if query_string:\n _add('?')\n _add(query_string)\n if fragment:\n _add('#')\n _add(fragment)\n return u''.join(parts)\n\n def __repr__(self):\n \"\"\"Convert this URL to an representation that shows all of its\n constituent parts, as well as being a valid argument to\n :func:`eval`.\n \"\"\"\n return '%s.from_text(%r)' % (self.__class__.__name__, self.to_text())\n\n def _to_bytes(self):\n \"\"\"\n Allows for direct usage of URL objects with libraries like\n requests, which automatically stringify URL parameters. See\n issue #49.\n \"\"\"\n return self.to_uri().to_text().encode('ascii')\n\n if PY2:\n __str__ = _to_bytes\n __unicode__ = to_text\n else:\n __bytes__ = _to_bytes\n __str__ = to_text\n\n # # Begin Twisted Compat Code\n asURI = to_uri\n asIRI = to_iri\n\n @classmethod\n def fromText(cls, s):\n return cls.from_text(s)\n\n def asText(self, includeSecrets=False):\n return self.to_text(with_password=includeSecrets)\n\n def __dir__(self):\n try:\n ret = object.__dir__(self)\n except AttributeError:\n # object.__dir__ == AttributeError # pdw for py2\n ret = dir(self.__class__) + list(self.__dict__.keys())\n ret = sorted(set(ret) - set(['fromText', 'asURI', 'asIRI', 'asText']))\n return ret\n\n # # End Twisted Compat Code\n\n def add(self, name, value=None):\n \"\"\"Make a new :class:`URL` instance with a given query argument,\n *name*, added to it with the value *value*, like so::\n\n >>> URL.from_text(u'https://example.com/?x=y').add(u'x')\n URL.from_text(u'https://example.com/?x=y&x')\n >>> URL.from_text(u'https://example.com/?x=y').add(u'x', u'z')\n URL.from_text(u'https://example.com/?x=y&x=z')\n\n Args:\n name (unicode): The name of the query parameter to add. The\n part before the ``=``.\n value (unicode): The value of the query parameter to add. The\n part after the ``=``. Defaults to ``None``, meaning no\n value.\n\n Returns:\n URL: A new :class:`URL` instance with the parameter added.\n \"\"\"\n return self.replace(query=self.query + ((name, value),))\n\n def set(self, name, value=None):\n \"\"\"Make a new :class:`URL` instance with the query parameter *name*\n set to *value*. All existing occurences, if any are replaced\n by the single name-value pair.\n\n >>> URL.from_text(u'https://example.com/?x=y').set(u'x')\n URL.from_text(u'https://example.com/?x')\n >>> URL.from_text(u'https://example.com/?x=y').set(u'x', u'z')\n URL.from_text(u'https://example.com/?x=z')\n\n Args:\n name (unicode): The name of the query parameter to set. The\n part before the ``=``.\n value (unicode): The value of the query parameter to set. The\n part after the ``=``. Defaults to ``None``, meaning no\n value.\n\n Returns:\n URL: A new :class:`URL` instance with the parameter set.\n \"\"\"\n # Preserve the original position of the query key in the list\n q = [(k, v) for (k, v) in self.query if k != name]\n idx = next((i for (i, (k, v)) in enumerate(self.query)\n if k == name), -1)\n q[idx:idx] = [(name, value)]\n return self.replace(query=q)\n\n def get(self, name):\n \"\"\"Get a list of values for the given query parameter, *name*::\n\n >>> url = URL.from_text(u'?x=1&x=2')\n >>> url.get('x')\n [u'1', u'2']\n >>> url.get('y')\n []\n\n If the given *name* is not set, an empty list is returned. A\n list is always returned, and this method raises no exceptions.\n\n Args:\n name (unicode): The name of the query parameter to get.\n\n Returns:\n list: A list of all the values associated with the key, in\n string form.\n\n \"\"\"\n return [value for (key, value) in self.query if name == key]\n\n def remove(self, name, value=_UNSET, limit=None):\n \"\"\"Make a new :class:`URL` instance with occurrences of the query\n parameter *name* removed, or, if *value* is set, parameters\n matching *name* and *value*. No exception is raised if the\n parameter is not already set.\n\n Args:\n name (unicode): The name of the query parameter to remove.\n value (unicode): Optional value to additionally filter\n on. Setting this removes query parameters which match\n both name and value.\n limit (int): Optional maximum number of parameters to remove.\n\n Returns:\n URL: A new :class:`URL` instance with the parameter removed.\n \"\"\"\n if limit is None:\n if value is _UNSET:\n nq = [(k, v) for (k, v) in self.query if k != name]\n else:\n nq = [(k, v) for (k, v) in self.query if not (k == name and v == value)]\n else:\n nq, removed_count = [], 0\n\n for k, v in self.query:\n if k == name and (value is _UNSET or v == value) and removed_count < limit:\n removed_count += 1 # drop it\n else:\n nq.append((k, v)) # keep it\n\n return self.replace(query=nq)\n\n\nEncodedURL = URL # An alias better describing what the URL really is\n\n\nclass DecodedURL(object):\n \"\"\"DecodedURL is a type meant to act as a higher-level interface to\n the URL. It is the `unicode` to URL's `bytes`. `DecodedURL` has\n almost exactly the same API as `URL`, but everything going in and\n out is in its maximally decoded state. All percent decoding is\n handled automatically.\n\n Where applicable, a UTF-8 encoding is presumed. Be advised that\n some interactions can raise :exc:`UnicodeEncodeErrors` and\n :exc:`UnicodeDecodeErrors`, just like when working with\n bytestrings. Examples of such interactions include handling query\n strings encoding binary data, and paths containing segments with\n special characters encoded with codecs other than UTF-8.\n\n Args:\n url (URL): A :class:`URL` object to wrap.\n lazy (bool): Set to True to avoid pre-decode all parts of the\n URL to check for validity. Defaults to False.\n\n \"\"\"\n def __init__(self, url, lazy=False):\n self._url = url\n if not lazy:\n # cache the following, while triggering any decoding\n # issues with decodable fields\n self.host, self.userinfo, self.path, self.query, self.fragment\n return\n\n @classmethod\n def from_text(cls, text, lazy=False):\n \"\"\"\\\n Make a `DecodedURL` instance from any text string containing a URL.\n\n Args:\n text (unicode): Text containing the URL\n lazy (bool): Whether to pre-decode all parts of the URL to\n check for validity. Defaults to True.\n \"\"\"\n _url = URL.from_text(text)\n return cls(_url, lazy=lazy)\n\n @property\n def encoded_url(self):\n \"\"\"Access the underlying :class:`URL` object, which has any special\n characters encoded.\n \"\"\"\n return self._url\n\n def to_text(self, *a, **kw):\n \"Passthrough to :meth:`~hyperlink.URL.to_text()`\"\n return self._url.to_text(*a, **kw)\n\n def to_uri(self, *a, **kw):\n \"Passthrough to :meth:`~hyperlink.URL.to_uri()`\"\n return self._url.to_uri(*a, **kw)\n\n def to_iri(self, *a, **kw):\n \"Passthrough to :meth:`~hyperlink.URL.to_iri()`\"\n return self._url.to_iri(*a, **kw)\n\n def click(self, href=u''):\n \"Return a new DecodedURL wrapping the result of :meth:`~hyperlink.URL.click()`\"\n if isinstance(href, DecodedURL):\n href = href._url\n return self.__class__(self._url.click(href=href))\n\n def sibling(self, segment):\n \"\"\"Automatically encode any reserved characters in *segment* and\n return a new `DecodedURL` wrapping the result of\n :meth:`~hyperlink.URL.sibling()`\n \"\"\"\n return self.__class__(self._url.sibling(_encode_reserved(segment)))\n\n def child(self, *segments):\n \"\"\"Automatically encode any reserved characters in *segments* and\n return a new `DecodedURL` wrapping the result of\n :meth:`~hyperlink.URL.child()`.\n \"\"\"\n if not segments:\n return self\n new_segs = [_encode_reserved(s) for s in segments]\n return self.__class__(self._url.child(*new_segs))\n\n def normalize(self, *a, **kw):\n \"Return a new `DecodedURL` wrapping the result of :meth:`~hyperlink.URL.normalize()`\"\n return self.__class__(self._url.normalize(*a, **kw))\n\n @property\n def absolute(self):\n return self._url.absolute\n\n @property\n def scheme(self):\n return self._url.scheme\n\n @property\n def host(self):\n return _decode_host(self._url.host)\n\n @property\n def port(self):\n return self._url.port\n\n @property\n def rooted(self):\n return self._url.rooted\n\n @property\n def path(self):\n try:\n return self._path\n except AttributeError:\n pass\n self._path = tuple([_percent_decode(p, raise_subencoding_exc=True)\n for p in self._url.path])\n return self._path\n\n @property\n def query(self):\n try:\n return self._query\n except AttributeError:\n pass\n _q = [tuple(_percent_decode(x, raise_subencoding_exc=True)\n if x is not None else None\n for x in (k, v))\n for k, v in self._url.query]\n self._query = tuple(_q)\n return self._query\n\n @property\n def fragment(self):\n try:\n return self._fragment\n except AttributeError:\n pass\n frag = self._url.fragment\n self._fragment = _percent_decode(frag, raise_subencoding_exc=True)\n return self._fragment\n\n @property\n def userinfo(self):\n try:\n return self._userinfo\n except AttributeError:\n pass\n self._userinfo = tuple([_percent_decode(p, raise_subencoding_exc=True)\n for p in self._url.userinfo.split(':', 1)])\n return self._userinfo\n\n @property\n def user(self):\n return self.userinfo[0]\n\n @property\n def uses_netloc(self):\n return self._url.uses_netloc\n\n def replace(self, scheme=_UNSET, host=_UNSET, path=_UNSET, query=_UNSET,\n fragment=_UNSET, port=_UNSET, rooted=_UNSET, userinfo=_UNSET,\n uses_netloc=_UNSET):\n \"\"\"While the signature is the same, this `replace()` differs a little\n from URL.replace. For instance, it accepts userinfo as a\n tuple, not as a string, handling the case of having a username\n containing a `:`. As with the rest of the methods on\n DecodedURL, if you pass a reserved character, it will be\n automatically encoded instead of an error being raised.\n\n \"\"\"\n if path is not _UNSET:\n path = [_encode_reserved(p) for p in path]\n if query is not _UNSET:\n query = [[_encode_reserved(x)\n if x is not None else None\n for x in (k, v)]\n for k, v in iter_pairs(query)]\n if userinfo is not _UNSET:\n if len(userinfo) > 2:\n raise ValueError('userinfo expected sequence of [\"user\"] or'\n ' [\"user\", \"password\"], got %r' % userinfo)\n userinfo = u':'.join([_encode_reserved(p) for p in userinfo])\n new_url = self._url.replace(scheme=scheme,\n host=host,\n path=path,\n query=query,\n fragment=fragment,\n port=port,\n rooted=rooted,\n userinfo=userinfo,\n uses_netloc=uses_netloc)\n return self.__class__(url=new_url)\n\n def get(self, name):\n \"Get the value of all query parameters whose name matches *name*\"\n return [v for (k, v) in self.query if name == k]\n\n def add(self, name, value=None):\n \"Return a new DecodedURL with the query parameter *name* and *value* added.\"\n return self.replace(query=self.query + ((name, value),))\n\n def set(self, name, value=None):\n \"Return a new DecodedURL with query parameter *name* set to *value*\"\n query = self.query\n q = [(k, v) for (k, v) in query if k != name]\n idx = next((i for (i, (k, v)) in enumerate(query) if k == name), -1)\n q[idx:idx] = [(name, value)]\n return self.replace(query=q)\n\n def remove(self, name, value=_UNSET, limit=None):\n \"\"\"Return a new DecodedURL with query parameter *name* removed.\n\n Optionally also filter for *value*, as well as cap the number\n of parameters removed with *limit*.\n \"\"\"\n if limit is None:\n if value is _UNSET:\n nq = [(k, v) for (k, v) in self.query if k != name]\n else:\n nq = [(k, v) for (k, v) in self.query if not (k == name and v == value)]\n else:\n nq, removed_count = [], 0\n for k, v in self.query:\n if k == name and (value is _UNSET or v == value) and removed_count < limit:\n removed_count += 1 # drop it\n else:\n nq.append((k, v)) # keep it\n\n return self.replace(query=nq)\n\n def __repr__(self):\n cn = self.__class__.__name__\n return '%s(url=%r)' % (cn, self._url)\n\n def __str__(self):\n # TODO: the underlying URL's __str__ needs to change to make\n # this work as the URL, see #55\n return str(self._url)\n\n def __eq__(self, other):\n if not isinstance(other, self.__class__):\n return NotImplemented\n return self.normalize().to_uri() == other.normalize().to_uri()\n\n def __ne__(self, other):\n if not isinstance(other, self.__class__):\n return NotImplemented\n return not self.__eq__(other)\n\n def __hash__(self):\n return hash((self.__class__, self.scheme, self.userinfo, self.host,\n self.path, self.query, self.fragment, self.port,\n self.rooted, self.uses_netloc))\n\n # # Begin Twisted Compat Code\n asURI = to_uri\n asIRI = to_iri\n\n @classmethod\n def fromText(cls, s, lazy=False):\n return cls.from_text(s, lazy=lazy)\n\n def asText(self, includeSecrets=False):\n return self.to_text(with_password=includeSecrets)\n\n def __dir__(self):\n try:\n ret = object.__dir__(self)\n except AttributeError:\n # object.__dir__ == AttributeError # pdw for py2\n ret = dir(self.__class__) + list(self.__dict__.keys())\n ret = sorted(set(ret) - set(['fromText', 'asURI', 'asIRI', 'asText']))\n return ret\n\n # # End Twisted Compat Code\n\n\ndef parse(url, decoded=True, lazy=False):\n \"\"\"Automatically turn text into a structured URL object.\n\n Args:\n\n decoded (bool): Whether or not to return a :class:`DecodedURL`,\n which automatically handles all\n encoding/decoding/quoting/unquoting for all the various\n accessors of parts of the URL, or an :class:`EncodedURL`,\n which has the same API, but requires handling of special\n characters for different parts of the URL.\n\n lazy (bool): In the case of `decoded=True`, this controls\n whether the URL is decoded immediately or as accessed. The\n default, `lazy=False`, checks all encoded parts of the URL\n for decodability.\n \"\"\"\n enc_url = EncodedURL.from_text(url)\n if not decoded:\n return enc_url\n dec_url = DecodedURL(enc_url, lazy=lazy)\n return dec_url\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hyperlink/test/__init__.py",
"content": ""
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hyperlink/test/common.py",
"content": "\n\nfrom unittest import TestCase\n\n\nclass HyperlinkTestCase(TestCase):\n \"\"\"This type mostly exists to provide a backwards-compatible\n assertRaises method for Python 2.6 testing.\n \"\"\"\n def assertRaises(self, excClass, callableObj=None, *args, **kwargs):\n \"\"\"Fail unless an exception of class excClass is raised\n by callableObj when invoked with arguments args and keyword\n arguments kwargs. If a different type of exception is\n raised, it will not be caught, and the test case will be\n deemed to have suffered an error, exactly as for an\n unexpected exception.\n\n If called with callableObj omitted or None, will return a\n context object used like this::\n\n with self.assertRaises(SomeException):\n do_something()\n\n The context manager keeps a reference to the exception as\n the 'exception' attribute. This allows you to inspect the\n exception after the assertion::\n\n with self.assertRaises(SomeException) as cm:\n do_something()\n the_exception = cm.exception\n self.assertEqual(the_exception.error_code, 3)\n \"\"\"\n context = _AssertRaisesContext(excClass, self)\n if callableObj is None:\n return context\n with context:\n callableObj(*args, **kwargs)\n\n\nclass _AssertRaisesContext(object):\n \"A context manager used to implement HyperlinkTestCase.assertRaises.\"\n\n def __init__(self, expected, test_case):\n self.expected = expected\n self.failureException = test_case.failureException\n\n def __enter__(self):\n return self\n\n def __exit__(self, exc_type, exc_value, tb):\n if exc_type is None:\n exc_name = self.expected.__name__\n raise self.failureException(\"%s not raised\" % (exc_name,))\n if not issubclass(exc_type, self.expected):\n # let unexpected exceptions pass through\n return False\n self.exception = exc_value # store for later retrieval\n return True\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hyperlink/test/test_common.py",
"content": "\"\"\"\nTests for hyperlink.test.common\n\"\"\"\nfrom unittest import TestCase\nfrom .common import HyperlinkTestCase\n\n\nclass _ExpectedException(Exception):\n \"\"\"An exception used to test HyperlinkTestCase.assertRaises.\n\n \"\"\"\n\n\nclass _UnexpectedException(Exception):\n \"\"\"An exception used to test HyperlinkTestCase.assertRaises.\n\n \"\"\"\n\n\nclass TestHyperlink(TestCase):\n \"\"\"Tests for HyperlinkTestCase\"\"\"\n\n def setUp(self):\n self.hyperlink_test = HyperlinkTestCase(\"run\")\n\n def test_assertRaisesWithCallable(self):\n \"\"\"HyperlinkTestCase.assertRaises does not raise an AssertionError\n when given a callable that, when called with the provided\n arguments, raises the expected exception.\n\n \"\"\"\n called_with = []\n\n def raisesExpected(*args, **kwargs):\n called_with.append((args, kwargs))\n raise _ExpectedException\n\n self.hyperlink_test.assertRaises(_ExpectedException,\n raisesExpected, 1, keyword=True)\n self.assertEqual(called_with, [((1,), {\"keyword\": True})])\n\n def test_assertRaisesWithCallableUnexpectedException(self):\n \"\"\"When given a callable that raises an unexpected exception,\n HyperlinkTestCase.assertRaises raises that exception.\n\n \"\"\"\n\n def doesNotRaiseExpected(*args, **kwargs):\n raise _UnexpectedException\n\n try:\n self.hyperlink_test.assertRaises(_ExpectedException,\n doesNotRaiseExpected)\n except _UnexpectedException:\n pass\n\n def test_assertRaisesWithCallableDoesNotRaise(self):\n \"\"\"HyperlinkTestCase.assertRaises raises an AssertionError when given\n a callable that, when called, does not raise any exception.\n\n \"\"\"\n\n def doesNotRaise(*args, **kwargs):\n return True\n\n try:\n self.hyperlink_test.assertRaises(_ExpectedException,\n doesNotRaise)\n except AssertionError:\n pass\n\n def test_assertRaisesContextManager(self):\n \"\"\"HyperlinkTestCase.assertRaises does not raise an AssertionError\n when used as a context manager with a suite that raises the\n expected exception. The context manager stores the exception\n instance under its `exception` instance variable.\n\n \"\"\"\n with self.hyperlink_test.assertRaises(_ExpectedException) as cm:\n raise _ExpectedException\n\n self.assertTrue(isinstance(cm.exception, _ExpectedException))\n\n def test_assertRaisesContextManagerUnexpectedException(self):\n \"\"\"When used as a context manager with a block that raises an\n unexpected exception, HyperlinkTestCase.assertRaises raises\n that unexpected exception.\n\n \"\"\"\n try:\n with self.hyperlink_test.assertRaises(_ExpectedException):\n raise _UnexpectedException\n except _UnexpectedException:\n pass\n\n def test_assertRaisesContextManagerDoesNotRaise(self):\n \"\"\"HyperlinkTestcase.assertRaises raises an AssertionError when used\n as a context manager with a block that does not raise any\n exception.\n\n \"\"\"\n try:\n with self.hyperlink_test.assertRaises(_ExpectedException):\n pass\n except AssertionError:\n pass\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hyperlink/test/test_decoded_url.py",
"content": "# -*- coding: utf-8 -*-\n\nfrom __future__ import unicode_literals\n\nfrom .. import DecodedURL\nfrom .._url import _percent_decode\nfrom .common import HyperlinkTestCase\n\nBASIC_URL = 'http://example.com/#'\nTOTAL_URL = \"https://%75%73%65%72:%00%00%00%00@xn--bcher-kva.ch:8080/a/nice%20nice/./path/?zot=23%25&zut#frég\"\n\n\nclass TestURL(HyperlinkTestCase):\n\n def test_durl_basic(self):\n bdurl = DecodedURL.from_text(BASIC_URL)\n assert bdurl.scheme == 'http'\n assert bdurl.host == 'example.com'\n assert bdurl.port == 80\n assert bdurl.path == ('',)\n assert bdurl.fragment == ''\n\n durl = DecodedURL.from_text(TOTAL_URL)\n\n assert durl.scheme == 'https'\n assert durl.host == 'bücher.ch'\n assert durl.port == 8080\n assert durl.path == ('a', 'nice nice', '.', 'path', '')\n assert durl.fragment == 'frég'\n assert durl.get('zot') == ['23%']\n\n assert durl.user == 'user'\n assert durl.userinfo == ('user', '\\0\\0\\0\\0')\n\n def test_passthroughs(self):\n # just basic tests for the methods that more or less pass straight\n # through to the underlying URL\n\n durl = DecodedURL.from_text(TOTAL_URL)\n assert durl.sibling('te%t').path[-1] == 'te%t'\n assert durl.child('../test2%').path[-1] == '../test2%'\n assert durl.child() == durl\n assert durl.child() is durl\n assert durl.click('/').path[-1] == ''\n assert durl.user == 'user'\n\n assert '.' in durl.path\n assert '.' not in durl.normalize().path\n\n assert durl.to_uri().fragment == 'fr%C3%A9g'\n assert ' ' in durl.to_iri().path[1]\n\n assert durl.to_text(with_password=True) == TOTAL_URL\n\n assert durl.absolute\n assert durl.rooted\n\n assert durl == durl.encoded_url.get_decoded_url()\n\n durl2 = DecodedURL.from_text(TOTAL_URL, lazy=True)\n assert durl2 == durl2.encoded_url.get_decoded_url(lazy=True)\n\n assert str(DecodedURL.from_text(BASIC_URL).child(' ')) == 'http://example.com/%20'\n\n assert not (durl == 1)\n assert durl != 1\n\n def test_repr(self):\n durl = DecodedURL.from_text(TOTAL_URL)\n assert repr(durl) == 'DecodedURL(url=' + repr(durl._url) + ')'\n\n def test_query_manipulation(self):\n durl = DecodedURL.from_text(TOTAL_URL)\n\n assert durl.get('zot') == ['23%']\n durl = durl.add(' ', 'space')\n assert durl.get(' ') == ['space']\n durl = durl.set(' ', 'spa%ed')\n assert durl.get(' ') == ['spa%ed']\n\n durl = DecodedURL(url=durl.to_uri())\n assert durl.get(' ') == ['spa%ed']\n durl = durl.remove(' ')\n assert durl.get(' ') == []\n\n durl = DecodedURL.from_text('/?%61rg=b&arg=c')\n assert durl.get('arg') == ['b', 'c']\n\n assert durl.set('arg', 'd').get('arg') == ['d']\n\n durl = DecodedURL.from_text(u\"https://example.com/a/b/?fóó=1&bar=2&fóó=3\")\n assert durl.remove(\"fóó\") == DecodedURL.from_text(\"https://example.com/a/b/?bar=2\")\n assert durl.remove(\"fóó\", value=\"1\") == DecodedURL.from_text(\"https://example.com/a/b/?bar=2&fóó=3\")\n assert durl.remove(\"fóó\", limit=1) == DecodedURL.from_text(\"https://example.com/a/b/?bar=2&fóó=3\")\n assert durl.remove(\"fóó\", value=\"1\", limit=0) == DecodedURL.from_text(\"https://example.com/a/b/?fóó=1&bar=2&fóó=3\")\n\n def test_equality_and_hashability(self):\n durl = DecodedURL.from_text(TOTAL_URL)\n durl2 = DecodedURL.from_text(TOTAL_URL)\n burl = DecodedURL.from_text(BASIC_URL)\n durl_uri = durl.to_uri()\n\n assert durl == durl\n assert durl == durl2\n assert durl != burl\n assert durl != None\n assert durl != durl._url\n\n durl_map = {}\n durl_map[durl] = durl\n durl_map[durl2] = durl2\n\n assert len(durl_map) == 1\n\n durl_map[burl] = burl\n\n assert len(durl_map) == 2\n\n durl_map[durl_uri] = durl_uri\n\n assert len(durl_map) == 3\n\n def test_replace_roundtrip(self):\n durl = DecodedURL.from_text(TOTAL_URL)\n\n durl2 = durl.replace(scheme=durl.scheme,\n host=durl.host,\n path=durl.path,\n query=durl.query,\n fragment=durl.fragment,\n port=durl.port,\n rooted=durl.rooted,\n userinfo=durl.userinfo,\n uses_netloc=durl.uses_netloc)\n\n assert durl == durl2\n\n def test_replace_userinfo(self):\n durl = DecodedURL.from_text(TOTAL_URL)\n with self.assertRaises(ValueError):\n durl.replace(userinfo=['user', 'pw', 'thiswillcauseafailure'])\n return\n\n def test_twisted_compat(self):\n durl = DecodedURL.from_text(TOTAL_URL)\n\n assert durl == DecodedURL.fromText(TOTAL_URL)\n assert 'to_text' in dir(durl)\n assert 'asText' not in dir(durl)\n assert durl.to_text() == durl.asText()\n\n def test_percent_decode_bytes(self):\n assert _percent_decode('%00', subencoding=False) == b'\\0'\n\n def test_percent_decode_mixed(self):\n # See https://github.com/python-hyper/hyperlink/pull/59 for a\n # nice discussion of the possibilities\n assert _percent_decode('abcdé%C3%A9éfg') == 'abcdéééfg'\n\n # still allow percent encoding in the case of an error\n assert _percent_decode('abcdé%C3éfg') == 'abcdé%C3éfg'\n\n # ...unless explicitly told otherwise\n with self.assertRaises(UnicodeDecodeError):\n _percent_decode('abcdé%C3éfg', raise_subencoding_exc=True)\n\n # check that getting raw bytes works ok\n assert _percent_decode('a%00b', subencoding=False) == b'a\\x00b'\n\n # when not encodable as subencoding\n assert _percent_decode('é%25é', subencoding='ascii') == 'é%25é'\n\n def test_click_decoded_url(self):\n durl = DecodedURL.from_text(TOTAL_URL)\n durl_dest = DecodedURL.from_text('/tëst')\n\n clicked = durl.click(durl_dest)\n assert clicked.host == durl.host\n assert clicked.path == durl_dest.path\n assert clicked.path == ('tëst',)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hyperlink/test/test_parse.py",
"content": "# -*- coding: utf-8 -*-\n\nfrom __future__ import unicode_literals\n\nfrom .common import HyperlinkTestCase\nfrom hyperlink import parse, EncodedURL, DecodedURL\n\nBASIC_URL = 'http://example.com/#'\nTOTAL_URL = \"https://%75%73%65%72:%00%00%00%00@xn--bcher-kva.ch:8080/a/nice%20nice/./path/?zot=23%25&zut#frég\"\nUNDECODABLE_FRAG_URL = TOTAL_URL + '%C3'\n# the %C3 above percent-decodes to an unpaired \\xc3 byte which makes this\n# invalid utf8\n\n\nclass TestURL(HyperlinkTestCase):\n def test_parse(self):\n purl = parse(TOTAL_URL)\n assert isinstance(purl, DecodedURL)\n assert purl.user == 'user'\n assert purl.get('zot') == ['23%']\n assert purl.fragment == 'frég'\n\n purl2 = parse(TOTAL_URL, decoded=False)\n assert isinstance(purl2, EncodedURL)\n assert purl2.get('zot') == ['23%25']\n\n with self.assertRaises(UnicodeDecodeError):\n purl3 = parse(UNDECODABLE_FRAG_URL)\n\n purl3 = parse(UNDECODABLE_FRAG_URL, lazy=True)\n\n with self.assertRaises(UnicodeDecodeError):\n purl3.fragment\n\n return\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hyperlink/test/test_scheme_registration.py",
"content": "# -*- coding: utf-8 -*-\nfrom __future__ import unicode_literals\n\n\nfrom .. import _url\nfrom .common import HyperlinkTestCase\nfrom .._url import register_scheme, URL\n\n\nclass TestSchemeRegistration(HyperlinkTestCase):\n\n def setUp(self):\n self._orig_scheme_port_map = dict(_url.SCHEME_PORT_MAP)\n self._orig_no_netloc_schemes = set(_url.NO_NETLOC_SCHEMES)\n\n def tearDown(self):\n _url.SCHEME_PORT_MAP = self._orig_scheme_port_map\n _url.NO_NETLOC_SCHEMES = self._orig_no_netloc_schemes\n\n def test_register_scheme_basic(self):\n register_scheme('deltron', uses_netloc=True, default_port=3030)\n\n u1 = URL.from_text('deltron://example.com')\n assert u1.scheme == 'deltron'\n assert u1.port == 3030\n assert u1.uses_netloc is True\n\n # test netloc works even when the original gives no indication\n u2 = URL.from_text('deltron:')\n u2 = u2.replace(host='example.com')\n assert u2.to_text() == 'deltron://example.com'\n\n # test default port means no emission\n u3 = URL.from_text('deltron://example.com:3030')\n assert u3.to_text() == 'deltron://example.com'\n\n register_scheme('nonetron', default_port=3031)\n u4 = URL(scheme='nonetron')\n u4 = u4.replace(host='example.com')\n assert u4.to_text() == 'nonetron://example.com'\n\n def test_register_no_netloc_scheme(self):\n register_scheme('noloctron', uses_netloc=False)\n u4 = URL(scheme='noloctron')\n u4 = u4.replace(path=(\"example\", \"path\"))\n assert u4.to_text() == 'noloctron:example/path'\n\n def test_register_no_netloc_with_port(self):\n with self.assertRaises(ValueError):\n register_scheme('badnetlocless', uses_netloc=False, default_port=7)\n\n def test_invalid_uses_netloc(self):\n with self.assertRaises(ValueError):\n register_scheme('badnetloc', uses_netloc=None)\n with self.assertRaises(ValueError):\n register_scheme('badnetloc', uses_netloc=object())\n\n def test_register_invalid_uses_netloc(self):\n with self.assertRaises(ValueError):\n register_scheme('lol', uses_netloc=lambda: 'nope')\n\n def test_register_invalid_port(self):\n with self.assertRaises(ValueError):\n register_scheme('nope', default_port=lambda: 'lol')\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hyperlink/test/test_url.py",
"content": "# -*- coding: utf-8 -*-\n\n# Copyright (c) Twisted Matrix Laboratories.\n# See LICENSE for details.\n\nfrom __future__ import unicode_literals\n\nimport sys\nimport socket\n\nfrom .common import HyperlinkTestCase\nfrom .. import URL, URLParseError\n# automatically import the py27 windows implementation when appropriate\nfrom .. import _url\nfrom .._url import inet_pton, SCHEME_PORT_MAP, parse_host\n\n\nPY2 = (sys.version_info[0] == 2)\nunicode = type(u'')\n\n\nBASIC_URL = \"http://www.foo.com/a/nice/path/?zot=23&zut\"\n\n# Examples from RFC 3986 section 5.4, Reference Resolution Examples\nrelativeLinkBaseForRFC3986 = 'http://a/b/c/d;p?q'\nrelativeLinkTestsForRFC3986 = [\n # \"Normal\"\n # ('g:h', 'g:h'), # can't click on a scheme-having url without an abs path\n ('g', 'http://a/b/c/g'),\n ('./g', 'http://a/b/c/g'),\n ('g/', 'http://a/b/c/g/'),\n ('/g', 'http://a/g'),\n ('//g', 'http://g'),\n ('?y', 'http://a/b/c/d;p?y'),\n ('g?y', 'http://a/b/c/g?y'),\n ('#s', 'http://a/b/c/d;p?q#s'),\n ('g#s', 'http://a/b/c/g#s'),\n ('g?y#s', 'http://a/b/c/g?y#s'),\n (';x', 'http://a/b/c/;x'),\n ('g;x', 'http://a/b/c/g;x'),\n ('g;x?y#s', 'http://a/b/c/g;x?y#s'),\n ('', 'http://a/b/c/d;p?q'),\n ('.', 'http://a/b/c/'),\n ('./', 'http://a/b/c/'),\n ('..', 'http://a/b/'),\n ('../', 'http://a/b/'),\n ('../g', 'http://a/b/g'),\n ('../..', 'http://a/'),\n ('../../', 'http://a/'),\n ('../../g', 'http://a/g'),\n\n # Abnormal examples\n # \"..\" cannot be used to change the authority component of a URI.\n ('../../../g', 'http://a/g'),\n ('../../../../g', 'http://a/g'),\n\n # Only include \".\" and \"..\" when they are only part of a larger segment,\n # not by themselves.\n ('/./g', 'http://a/g'),\n ('/../g', 'http://a/g'),\n ('g.', 'http://a/b/c/g.'),\n ('.g', 'http://a/b/c/.g'),\n ('g..', 'http://a/b/c/g..'),\n ('..g', 'http://a/b/c/..g'),\n # Unnecessary or nonsensical forms of \".\" and \"..\".\n ('./../g', 'http://a/b/g'),\n ('./g/.', 'http://a/b/c/g/'),\n ('g/./h', 'http://a/b/c/g/h'),\n ('g/../h', 'http://a/b/c/h'),\n ('g;x=1/./y', 'http://a/b/c/g;x=1/y'),\n ('g;x=1/../y', 'http://a/b/c/y'),\n # Separating the reference's query and fragment components from the path.\n ('g?y/./x', 'http://a/b/c/g?y/./x'),\n ('g?y/../x', 'http://a/b/c/g?y/../x'),\n ('g#s/./x', 'http://a/b/c/g#s/./x'),\n ('g#s/../x', 'http://a/b/c/g#s/../x')\n]\n\n\nROUNDTRIP_TESTS = (\n \"http://localhost\",\n \"http://localhost/\",\n \"http://127.0.0.1/\",\n \"http://[::127.0.0.1]/\",\n \"http://[::1]/\",\n \"http://localhost/foo\",\n \"http://localhost/foo/\",\n \"http://localhost/foo!!bar/\",\n \"http://localhost/foo%20bar/\",\n \"http://localhost/foo%2Fbar/\",\n \"http://localhost/foo?n\",\n \"http://localhost/foo?n=v\",\n \"http://localhost/foo?n=/a/b\",\n \"http://example.com/foo!@$bar?b!@z=123\",\n \"http://localhost/asd?a=asd%20sdf/345\",\n \"http://(%2525)/(%2525)?(%2525)&(%2525)=(%2525)#(%2525)\",\n \"http://(%C3%A9)/(%C3%A9)?(%C3%A9)&(%C3%A9)=(%C3%A9)#(%C3%A9)\",\n \"?sslrootcert=/Users/glyph/Downloads/rds-ca-2015-root.pem&sslmode=verify\",\n\n # from boltons.urlutils' tests\n\n 'http://googlewebsite.com/e-shops.aspx',\n 'http://example.com:8080/search?q=123&business=Nothing%20Special',\n 'http://hatnote.com:9000/?arg=1&arg=2&arg=3',\n 'https://xn--bcher-kva.ch',\n 'http://xn--ggbla1c4e.xn--ngbc5azd/',\n 'http://tools.ietf.org/html/rfc3986#section-3.4',\n # 'http://wiki:pedia@hatnote.com',\n 'ftp://ftp.rfc-editor.org/in-notes/tar/RFCs0001-0500.tar.gz',\n 'http://[1080:0:0:0:8:800:200C:417A]/index.html',\n 'ssh://192.0.2.16:2222/',\n 'https://[::101.45.75.219]:80/?hi=bye',\n 'ldap://[::192.9.5.5]/dc=example,dc=com??sub?(sn=Jensen)',\n 'mailto:me@example.com?to=me@example.com&body=hi%20http://wikipedia.org',\n 'news:alt.rec.motorcycle',\n 'tel:+1-800-867-5309',\n 'urn:oasis:member:A00024:x',\n ('magnet:?xt=urn:btih:1a42b9e04e122b97a5254e3df77ab3c4b7da725f&dn=Puppy%'\n '20Linux%20precise-5.7.1.iso&tr=udp://tracker.openbittorrent.com:80&'\n 'tr=udp://tracker.publicbt.com:80&tr=udp://tracker.istole.it:6969&'\n 'tr=udp://tracker.ccc.de:80&tr=udp://open.demonii.com:1337'),\n\n # percent-encoded delimiters in percent-encodable fields\n\n 'https://%3A@example.com/', # colon in username\n 'https://%40@example.com/', # at sign in username\n 'https://%2f@example.com/', # slash in username\n 'https://a:%3a@example.com/', # colon in password\n 'https://a:%40@example.com/', # at sign in password\n 'https://a:%2f@example.com/', # slash in password\n 'https://a:%3f@example.com/', # question mark in password\n 'https://example.com/%2F/', # slash in path\n 'https://example.com/%3F/', # question mark in path\n 'https://example.com/%23/', # hash in path\n 'https://example.com/?%23=b', # hash in query param name\n 'https://example.com/?%3D=b', # equals in query param name\n 'https://example.com/?%26=b', # ampersand in query param name\n 'https://example.com/?a=%23', # hash in query param value\n 'https://example.com/?a=%26', # ampersand in query param value\n 'https://example.com/?a=%3D', # equals in query param value\n # double-encoded percent sign in all percent-encodable positions:\n \"http://(%2525):(%2525)@example.com/(%2525)/?(%2525)=(%2525)#(%2525)\",\n # colon in first part of schemeless relative url\n 'first_seg_rel_path__colon%3Anotok/second_seg__colon%3Aok',\n)\n\n\nclass TestURL(HyperlinkTestCase):\n \"\"\"\n Tests for L{URL}.\n \"\"\"\n\n def assertUnicoded(self, u):\n \"\"\"\n The given L{URL}'s components should be L{unicode}.\n\n @param u: The L{URL} to test.\n \"\"\"\n self.assertTrue(isinstance(u.scheme, unicode) or u.scheme is None,\n repr(u))\n self.assertTrue(isinstance(u.host, unicode) or u.host is None,\n repr(u))\n for seg in u.path:\n self.assertEqual(type(seg), unicode, repr(u))\n for (k, v) in u.query:\n self.assertEqual(type(seg), unicode, repr(u))\n self.assertTrue(v is None or isinstance(v, unicode), repr(u))\n self.assertEqual(type(u.fragment), unicode, repr(u))\n\n def assertURL(self, u, scheme, host, path, query,\n fragment, port, userinfo=''):\n \"\"\"\n The given L{URL} should have the given components.\n\n @param u: The actual L{URL} to examine.\n\n @param scheme: The expected scheme.\n\n @param host: The expected host.\n\n @param path: The expected path.\n\n @param query: The expected query.\n\n @param fragment: The expected fragment.\n\n @param port: The expected port.\n\n @param userinfo: The expected userinfo.\n \"\"\"\n actual = (u.scheme, u.host, u.path, u.query,\n u.fragment, u.port, u.userinfo)\n expected = (scheme, host, tuple(path), tuple(query),\n fragment, port, u.userinfo)\n self.assertEqual(actual, expected)\n\n def test_initDefaults(self):\n \"\"\"\n L{URL} should have appropriate default values.\n \"\"\"\n def check(u):\n self.assertUnicoded(u)\n self.assertURL(u, 'http', '', [], [], '', 80, '')\n\n check(URL('http', ''))\n check(URL('http', '', [], []))\n check(URL('http', '', [], [], ''))\n\n def test_init(self):\n \"\"\"\n L{URL} should accept L{unicode} parameters.\n \"\"\"\n u = URL('s', 'h', ['p'], [('k', 'v'), ('k', None)], 'f')\n self.assertUnicoded(u)\n self.assertURL(u, 's', 'h', ['p'], [('k', 'v'), ('k', None)],\n 'f', None)\n\n self.assertURL(URL('http', '\\xe0', ['\\xe9'],\n [('\\u03bb', '\\u03c0')], '\\u22a5'),\n 'http', '\\xe0', ['\\xe9'],\n [('\\u03bb', '\\u03c0')], '\\u22a5', 80)\n\n def test_initPercent(self):\n \"\"\"\n L{URL} should accept (and not interpret) percent characters.\n \"\"\"\n u = URL('s', '%68', ['%70'], [('%6B', '%76'), ('%6B', None)],\n '%66')\n self.assertUnicoded(u)\n self.assertURL(u,\n 's', '%68', ['%70'],\n [('%6B', '%76'), ('%6B', None)],\n '%66', None)\n\n def test_repr(self):\n \"\"\"\n L{URL.__repr__} will display the canonical form of the URL, wrapped in\n a L{URL.from_text} invocation, so that it is C{eval}-able but still easy\n to read.\n \"\"\"\n self.assertEqual(\n repr(URL(scheme='http', host='foo', path=['bar'],\n query=[('baz', None), ('k', 'v')],\n fragment='frob')),\n \"URL.from_text(%s)\" % (repr(u\"http://foo/bar?baz&k=v#frob\"),)\n )\n\n def test_from_text(self):\n \"\"\"\n Round-tripping L{URL.from_text} with C{str} results in an equivalent\n URL.\n \"\"\"\n urlpath = URL.from_text(BASIC_URL)\n self.assertEqual(BASIC_URL, urlpath.to_text())\n\n def test_roundtrip(self):\n \"\"\"\n L{URL.to_text} should invert L{URL.from_text}.\n \"\"\"\n for test in ROUNDTRIP_TESTS:\n result = URL.from_text(test).to_text(with_password=True)\n self.assertEqual(test, result)\n\n def test_roundtrip_double_iri(self):\n for test in ROUNDTRIP_TESTS:\n url = URL.from_text(test)\n iri = url.to_iri()\n double_iri = iri.to_iri()\n assert iri == double_iri\n\n iri_text = iri.to_text(with_password=True)\n double_iri_text = double_iri.to_text(with_password=True)\n assert iri_text == double_iri_text\n return\n\n def test_equality(self):\n \"\"\"\n Two URLs decoded using L{URL.from_text} will be equal (C{==}) if they\n decoded same URL string, and unequal (C{!=}) if they decoded different\n strings.\n \"\"\"\n urlpath = URL.from_text(BASIC_URL)\n self.assertEqual(urlpath, URL.from_text(BASIC_URL))\n self.assertNotEqual(\n urlpath,\n URL.from_text('ftp://www.anotherinvaliddomain.com/'\n 'foo/bar/baz/?zot=21&zut')\n )\n\n def test_fragmentEquality(self):\n \"\"\"\n An URL created with the empty string for a fragment compares equal\n to an URL created with an unspecified fragment.\n \"\"\"\n self.assertEqual(URL(fragment=''), URL())\n self.assertEqual(URL.from_text(u\"http://localhost/#\"),\n URL.from_text(u\"http://localhost/\"))\n\n def test_child(self):\n \"\"\"\n L{URL.child} appends a new path segment, but does not affect the query\n or fragment.\n \"\"\"\n urlpath = URL.from_text(BASIC_URL)\n self.assertEqual(\"http://www.foo.com/a/nice/path/gong?zot=23&zut\",\n urlpath.child('gong').to_text())\n self.assertEqual(\"http://www.foo.com/a/nice/path/gong%2F?zot=23&zut\",\n urlpath.child('gong/').to_text())\n self.assertEqual(\n \"http://www.foo.com/a/nice/path/gong%2Fdouble?zot=23&zut\",\n urlpath.child('gong/double').to_text()\n )\n self.assertEqual(\n \"http://www.foo.com/a/nice/path/gong%2Fdouble%2F?zot=23&zut\",\n urlpath.child('gong/double/').to_text()\n )\n\n def test_multiChild(self):\n \"\"\"\n L{URL.child} receives multiple segments as C{*args} and appends each in\n turn.\n \"\"\"\n url = URL.from_text('http://example.com/a/b')\n self.assertEqual(url.child('c', 'd', 'e').to_text(),\n 'http://example.com/a/b/c/d/e')\n\n def test_childInitRoot(self):\n \"\"\"\n L{URL.child} of a L{URL} without a path produces a L{URL} with a single\n path segment.\n \"\"\"\n childURL = URL(host=u\"www.foo.com\").child(u\"c\")\n self.assertTrue(childURL.rooted)\n self.assertEqual(\"http://www.foo.com/c\", childURL.to_text())\n\n def test_emptyChild(self):\n \"\"\"\n L{URL.child} without any new segments returns the original L{URL}.\n \"\"\"\n url = URL(host=u\"www.foo.com\")\n self.assertEqual(url.child(), url)\n\n def test_sibling(self):\n \"\"\"\n L{URL.sibling} of a L{URL} replaces the last path segment, but does not\n affect the query or fragment.\n \"\"\"\n urlpath = URL.from_text(BASIC_URL)\n self.assertEqual(\n \"http://www.foo.com/a/nice/path/sister?zot=23&zut\",\n urlpath.sibling('sister').to_text()\n )\n # Use an url without trailing '/' to check child removal.\n url_text = \"http://www.foo.com/a/nice/path?zot=23&zut\"\n urlpath = URL.from_text(url_text)\n self.assertEqual(\n \"http://www.foo.com/a/nice/sister?zot=23&zut\",\n urlpath.sibling('sister').to_text()\n )\n\n def test_click(self):\n \"\"\"\n L{URL.click} interprets the given string as a relative URI-reference\n and returns a new L{URL} interpreting C{self} as the base absolute URI.\n \"\"\"\n urlpath = URL.from_text(BASIC_URL)\n # A null uri should be valid (return here).\n self.assertEqual(\"http://www.foo.com/a/nice/path/?zot=23&zut\",\n urlpath.click(\"\").to_text())\n # A simple relative path remove the query.\n self.assertEqual(\"http://www.foo.com/a/nice/path/click\",\n urlpath.click(\"click\").to_text())\n # An absolute path replace path and query.\n self.assertEqual(\"http://www.foo.com/click\",\n urlpath.click(\"/click\").to_text())\n # Replace just the query.\n self.assertEqual(\"http://www.foo.com/a/nice/path/?burp\",\n urlpath.click(\"?burp\").to_text())\n # One full url to another should not generate '//' between authority.\n # and path\n self.assertTrue(\"//foobar\" not in\n urlpath.click('http://www.foo.com/foobar').to_text())\n\n # From a url with no query clicking a url with a query, the query\n # should be handled properly.\n u = URL.from_text('http://www.foo.com/me/noquery')\n self.assertEqual('http://www.foo.com/me/17?spam=158',\n u.click('/me/17?spam=158').to_text())\n\n # Check that everything from the path onward is removed when the click\n # link has no path.\n u = URL.from_text('http://localhost/foo?abc=def')\n self.assertEqual(u.click('http://www.python.org').to_text(),\n 'http://www.python.org')\n\n # https://twistedmatrix.com/trac/ticket/8184\n u = URL.from_text('http://hatnote.com/a/b/../c/./d/e/..')\n res = 'http://hatnote.com/a/c/d/'\n self.assertEqual(u.click('').to_text(), res)\n\n # test click default arg is same as empty string above\n self.assertEqual(u.click().to_text(), res)\n\n # test click on a URL instance\n u = URL.fromText('http://localhost/foo/?abc=def')\n u2 = URL.from_text('bar')\n u3 = u.click(u2)\n self.assertEqual(u3.to_text(), 'http://localhost/foo/bar')\n\n def test_clickRFC3986(self):\n \"\"\"\n L{URL.click} should correctly resolve the examples in RFC 3986.\n \"\"\"\n base = URL.from_text(relativeLinkBaseForRFC3986)\n for (ref, expected) in relativeLinkTestsForRFC3986:\n self.assertEqual(base.click(ref).to_text(), expected)\n\n def test_clickSchemeRelPath(self):\n \"\"\"\n L{URL.click} should not accept schemes with relative paths.\n \"\"\"\n base = URL.from_text(relativeLinkBaseForRFC3986)\n self.assertRaises(NotImplementedError, base.click, 'g:h')\n self.assertRaises(NotImplementedError, base.click, 'http:h')\n\n def test_cloneUnchanged(self):\n \"\"\"\n Verify that L{URL.replace} doesn't change any of the arguments it\n is passed.\n \"\"\"\n urlpath = URL.from_text('https://x:1/y?z=1#A')\n self.assertEqual(urlpath.replace(urlpath.scheme,\n urlpath.host,\n urlpath.path,\n urlpath.query,\n urlpath.fragment,\n urlpath.port),\n urlpath)\n self.assertEqual(urlpath.replace(), urlpath)\n\n def test_clickCollapse(self):\n \"\"\"\n L{URL.click} collapses C{.} and C{..} according to RFC 3986 section\n 5.2.4.\n \"\"\"\n tests = [\n ['http://localhost/', '.', 'http://localhost/'],\n ['http://localhost/', '..', 'http://localhost/'],\n ['http://localhost/a/b/c', '.', 'http://localhost/a/b/'],\n ['http://localhost/a/b/c', '..', 'http://localhost/a/'],\n ['http://localhost/a/b/c', './d/e', 'http://localhost/a/b/d/e'],\n ['http://localhost/a/b/c', '../d/e', 'http://localhost/a/d/e'],\n ['http://localhost/a/b/c', '/./d/e', 'http://localhost/d/e'],\n ['http://localhost/a/b/c', '/../d/e', 'http://localhost/d/e'],\n ['http://localhost/a/b/c/', '../../d/e/',\n 'http://localhost/a/d/e/'],\n ['http://localhost/a/./c', '../d/e', 'http://localhost/d/e'],\n ['http://localhost/a/./c/', '../d/e', 'http://localhost/a/d/e'],\n ['http://localhost/a/b/c/d', './e/../f/../g',\n 'http://localhost/a/b/c/g'],\n ['http://localhost/a/b/c', 'd//e', 'http://localhost/a/b/d//e'],\n ]\n for start, click, expected in tests:\n actual = URL.from_text(start).click(click).to_text()\n self.assertEqual(\n actual,\n expected,\n \"{start}.click({click}) => {actual} not {expected}\".format(\n start=start,\n click=repr(click),\n actual=actual,\n expected=expected,\n )\n )\n\n def test_queryAdd(self):\n \"\"\"\n L{URL.add} adds query parameters.\n \"\"\"\n self.assertEqual(\n \"http://www.foo.com/a/nice/path/?foo=bar\",\n URL.from_text(\"http://www.foo.com/a/nice/path/\")\n .add(u\"foo\", u\"bar\").to_text())\n self.assertEqual(\n \"http://www.foo.com/?foo=bar\",\n URL(host=u\"www.foo.com\").add(u\"foo\", u\"bar\")\n .to_text())\n urlpath = URL.from_text(BASIC_URL)\n self.assertEqual(\n \"http://www.foo.com/a/nice/path/?zot=23&zut&burp\",\n urlpath.add(u\"burp\").to_text())\n self.assertEqual(\n \"http://www.foo.com/a/nice/path/?zot=23&zut&burp=xxx\",\n urlpath.add(u\"burp\", u\"xxx\").to_text())\n self.assertEqual(\n \"http://www.foo.com/a/nice/path/?zot=23&zut&burp=xxx&zing\",\n urlpath.add(u\"burp\", u\"xxx\").add(u\"zing\").to_text())\n # Note the inversion!\n self.assertEqual(\n \"http://www.foo.com/a/nice/path/?zot=23&zut&zing&burp=xxx\",\n urlpath.add(u\"zing\").add(u\"burp\", u\"xxx\").to_text())\n # Note the two values for the same name.\n self.assertEqual(\n \"http://www.foo.com/a/nice/path/?zot=23&zut&burp=xxx&zot=32\",\n urlpath.add(u\"burp\", u\"xxx\").add(u\"zot\", '32')\n .to_text())\n\n def test_querySet(self):\n \"\"\"\n L{URL.set} replaces query parameters by name.\n \"\"\"\n urlpath = URL.from_text(BASIC_URL)\n self.assertEqual(\n \"http://www.foo.com/a/nice/path/?zot=32&zut\",\n urlpath.set(u\"zot\", '32').to_text())\n # Replace name without value with name/value and vice-versa.\n self.assertEqual(\n \"http://www.foo.com/a/nice/path/?zot&zut=itworked\",\n urlpath.set(u\"zot\").set(u\"zut\", u\"itworked\").to_text()\n )\n # Q: what happens when the query has two values and we replace?\n # A: we replace both values with a single one\n self.assertEqual(\n \"http://www.foo.com/a/nice/path/?zot=32&zut\",\n urlpath.add(u\"zot\", u\"xxx\").set(u\"zot\", '32').to_text()\n )\n\n def test_queryRemove(self):\n \"\"\"\n L{URL.remove} removes instances of a query parameter.\n \"\"\"\n url = URL.from_text(u\"https://example.com/a/b/?foo=1&bar=2&foo=3\")\n self.assertEqual(\n url.remove(u\"foo\"),\n URL.from_text(u\"https://example.com/a/b/?bar=2\")\n )\n\n self.assertEqual(\n url.remove(name=u\"foo\", value=u\"1\"),\n URL.from_text(u\"https://example.com/a/b/?bar=2&foo=3\")\n )\n\n self.assertEqual(\n url.remove(name=u\"foo\", limit=1),\n URL.from_text(u\"https://example.com/a/b/?bar=2&foo=3\")\n )\n\n self.assertEqual(\n url.remove(name=u\"foo\", value=u\"1\", limit=0),\n URL.from_text(u\"https://example.com/a/b/?foo=1&bar=2&foo=3\")\n )\n\n def test_parseEqualSignInParamValue(self):\n \"\"\"\n Every C{=}-sign after the first in a query parameter is simply included\n in the value of the parameter.\n \"\"\"\n u = URL.from_text('http://localhost/?=x=x=x')\n self.assertEqual(u.get(''), ['x=x=x'])\n self.assertEqual(u.to_text(), 'http://localhost/?=x=x=x')\n u = URL.from_text('http://localhost/?foo=x=x=x&bar=y')\n self.assertEqual(u.query, (('foo', 'x=x=x'), ('bar', 'y')))\n self.assertEqual(u.to_text(), 'http://localhost/?foo=x=x=x&bar=y')\n\n u = URL.from_text('https://example.com/?argument=3&argument=4&operator=%3D')\n iri = u.to_iri()\n self.assertEqual(iri.get('operator'), ['='])\n # assert that the equals is not unnecessarily escaped\n self.assertEqual(iri.to_uri().get('operator'), ['='])\n\n def test_empty(self):\n \"\"\"\n An empty L{URL} should serialize as the empty string.\n \"\"\"\n self.assertEqual(URL().to_text(), '')\n\n def test_justQueryText(self):\n \"\"\"\n An L{URL} with query text should serialize as just query text.\n \"\"\"\n u = URL(query=[(u\"hello\", u\"world\")])\n self.assertEqual(u.to_text(), '?hello=world')\n\n def test_identicalEqual(self):\n \"\"\"\n L{URL} compares equal to itself.\n \"\"\"\n u = URL.from_text('http://localhost/')\n self.assertEqual(u, u)\n\n def test_similarEqual(self):\n \"\"\"\n URLs with equivalent components should compare equal.\n \"\"\"\n u1 = URL.from_text('http://u@localhost:8080/p/a/t/h?q=p#f')\n u2 = URL.from_text('http://u@localhost:8080/p/a/t/h?q=p#f')\n self.assertEqual(u1, u2)\n\n def test_differentNotEqual(self):\n \"\"\"\n L{URL}s that refer to different resources are both unequal (C{!=}) and\n also not equal (not C{==}).\n \"\"\"\n u1 = URL.from_text('http://localhost/a')\n u2 = URL.from_text('http://localhost/b')\n self.assertFalse(u1 == u2, \"%r != %r\" % (u1, u2))\n self.assertNotEqual(u1, u2)\n\n def test_otherTypesNotEqual(self):\n \"\"\"\n L{URL} is not equal (C{==}) to other types.\n \"\"\"\n u = URL.from_text('http://localhost/')\n self.assertFalse(u == 42, \"URL must not equal a number.\")\n self.assertFalse(u == object(), \"URL must not equal an object.\")\n self.assertNotEqual(u, 42)\n self.assertNotEqual(u, object())\n\n def test_identicalNotUnequal(self):\n \"\"\"\n Identical L{URL}s are not unequal (C{!=}) to each other.\n \"\"\"\n u = URL.from_text('http://u@localhost:8080/p/a/t/h?q=p#f')\n self.assertFalse(u != u, \"%r == itself\" % u)\n\n def test_similarNotUnequal(self):\n \"\"\"\n Structurally similar L{URL}s are not unequal (C{!=}) to each other.\n \"\"\"\n u1 = URL.from_text('http://u@localhost:8080/p/a/t/h?q=p#f')\n u2 = URL.from_text('http://u@localhost:8080/p/a/t/h?q=p#f')\n self.assertFalse(u1 != u2, \"%r == %r\" % (u1, u2))\n\n def test_differentUnequal(self):\n \"\"\"\n Structurally different L{URL}s are unequal (C{!=}) to each other.\n \"\"\"\n u1 = URL.from_text('http://localhost/a')\n u2 = URL.from_text('http://localhost/b')\n self.assertTrue(u1 != u2, \"%r == %r\" % (u1, u2))\n\n def test_otherTypesUnequal(self):\n \"\"\"\n L{URL} is unequal (C{!=}) to other types.\n \"\"\"\n u = URL.from_text('http://localhost/')\n self.assertTrue(u != 42, \"URL must differ from a number.\")\n self.assertTrue(u != object(), \"URL must be differ from an object.\")\n\n def test_asURI(self):\n \"\"\"\n L{URL.asURI} produces an URI which converts any URI unicode encoding\n into pure US-ASCII and returns a new L{URL}.\n \"\"\"\n unicodey = ('http://\\N{LATIN SMALL LETTER E WITH ACUTE}.com/'\n '\\N{LATIN SMALL LETTER E}\\N{COMBINING ACUTE ACCENT}'\n '?\\N{LATIN SMALL LETTER A}\\N{COMBINING ACUTE ACCENT}='\n '\\N{LATIN SMALL LETTER I}\\N{COMBINING ACUTE ACCENT}'\n '#\\N{LATIN SMALL LETTER U}\\N{COMBINING ACUTE ACCENT}')\n iri = URL.from_text(unicodey)\n uri = iri.asURI()\n self.assertEqual(iri.host, '\\N{LATIN SMALL LETTER E WITH ACUTE}.com')\n self.assertEqual(iri.path[0],\n '\\N{LATIN SMALL LETTER E}\\N{COMBINING ACUTE ACCENT}')\n self.assertEqual(iri.to_text(), unicodey)\n expectedURI = 'http://xn--9ca.com/%C3%A9?%C3%A1=%C3%AD#%C3%BA'\n actualURI = uri.to_text()\n self.assertEqual(actualURI, expectedURI,\n '%r != %r' % (actualURI, expectedURI))\n\n def test_asIRI(self):\n \"\"\"\n L{URL.asIRI} decodes any percent-encoded text in the URI, making it\n more suitable for reading by humans, and returns a new L{URL}.\n \"\"\"\n asciiish = 'http://xn--9ca.com/%C3%A9?%C3%A1=%C3%AD#%C3%BA'\n uri = URL.from_text(asciiish)\n iri = uri.asIRI()\n self.assertEqual(uri.host, 'xn--9ca.com')\n self.assertEqual(uri.path[0], '%C3%A9')\n self.assertEqual(uri.to_text(), asciiish)\n expectedIRI = ('http://\\N{LATIN SMALL LETTER E WITH ACUTE}.com/'\n '\\N{LATIN SMALL LETTER E WITH ACUTE}'\n '?\\N{LATIN SMALL LETTER A WITH ACUTE}='\n '\\N{LATIN SMALL LETTER I WITH ACUTE}'\n '#\\N{LATIN SMALL LETTER U WITH ACUTE}')\n actualIRI = iri.to_text()\n self.assertEqual(actualIRI, expectedIRI,\n '%r != %r' % (actualIRI, expectedIRI))\n\n def test_badUTF8AsIRI(self):\n \"\"\"\n Bad UTF-8 in a path segment, query parameter, or fragment results in\n that portion of the URI remaining percent-encoded in the IRI.\n \"\"\"\n urlWithBinary = 'http://xn--9ca.com/%00%FF/%C3%A9'\n uri = URL.from_text(urlWithBinary)\n iri = uri.asIRI()\n expectedIRI = ('http://\\N{LATIN SMALL LETTER E WITH ACUTE}.com/'\n '%00%FF/'\n '\\N{LATIN SMALL LETTER E WITH ACUTE}')\n actualIRI = iri.to_text()\n self.assertEqual(actualIRI, expectedIRI,\n '%r != %r' % (actualIRI, expectedIRI))\n\n def test_alreadyIRIAsIRI(self):\n \"\"\"\n A L{URL} composed of non-ASCII text will result in non-ASCII text.\n \"\"\"\n unicodey = ('http://\\N{LATIN SMALL LETTER E WITH ACUTE}.com/'\n '\\N{LATIN SMALL LETTER E}\\N{COMBINING ACUTE ACCENT}'\n '?\\N{LATIN SMALL LETTER A}\\N{COMBINING ACUTE ACCENT}='\n '\\N{LATIN SMALL LETTER I}\\N{COMBINING ACUTE ACCENT}'\n '#\\N{LATIN SMALL LETTER U}\\N{COMBINING ACUTE ACCENT}')\n iri = URL.from_text(unicodey)\n alsoIRI = iri.asIRI()\n self.assertEqual(alsoIRI.to_text(), unicodey)\n\n def test_alreadyURIAsURI(self):\n \"\"\"\n A L{URL} composed of encoded text will remain encoded.\n \"\"\"\n expectedURI = 'http://xn--9ca.com/%C3%A9?%C3%A1=%C3%AD#%C3%BA'\n uri = URL.from_text(expectedURI)\n actualURI = uri.asURI().to_text()\n self.assertEqual(actualURI, expectedURI)\n\n def test_userinfo(self):\n \"\"\"\n L{URL.from_text} will parse the C{userinfo} portion of the URI\n separately from the host and port.\n \"\"\"\n url = URL.from_text(\n 'http://someuser:somepassword@example.com/some-segment@ignore'\n )\n self.assertEqual(url.authority(True),\n 'someuser:somepassword@example.com')\n self.assertEqual(url.authority(False), 'someuser:@example.com')\n self.assertEqual(url.userinfo, 'someuser:somepassword')\n self.assertEqual(url.user, 'someuser')\n self.assertEqual(url.to_text(),\n 'http://someuser:@example.com/some-segment@ignore')\n self.assertEqual(\n url.replace(userinfo=u\"someuser\").to_text(),\n 'http://someuser@example.com/some-segment@ignore'\n )\n\n def test_portText(self):\n \"\"\"\n L{URL.from_text} parses custom port numbers as integers.\n \"\"\"\n portURL = URL.from_text(u\"http://www.example.com:8080/\")\n self.assertEqual(portURL.port, 8080)\n self.assertEqual(portURL.to_text(), u\"http://www.example.com:8080/\")\n\n def test_mailto(self):\n \"\"\"\n Although L{URL} instances are mainly for dealing with HTTP, other\n schemes (such as C{mailto:}) should work as well. For example,\n L{URL.from_text}/L{URL.to_text} round-trips cleanly for a C{mailto:} URL\n representing an email address.\n \"\"\"\n self.assertEqual(URL.from_text(u\"mailto:user@example.com\").to_text(),\n u\"mailto:user@example.com\")\n\n def test_queryIterable(self):\n \"\"\"\n When a L{URL} is created with a C{query} argument, the C{query}\n argument is converted into an N-tuple of 2-tuples, sensibly\n handling dictionaries.\n \"\"\"\n expected = (('alpha', 'beta'),)\n url = URL(query=[['alpha', 'beta']])\n self.assertEqual(url.query, expected)\n url = URL(query={'alpha': 'beta'})\n self.assertEqual(url.query, expected)\n\n def test_pathIterable(self):\n \"\"\"\n When a L{URL} is created with a C{path} argument, the C{path} is\n converted into a tuple.\n \"\"\"\n url = URL(path=['hello', 'world'])\n self.assertEqual(url.path, ('hello', 'world'))\n\n def test_invalidArguments(self):\n \"\"\"\n Passing an argument of the wrong type to any of the constructor\n arguments of L{URL} will raise a descriptive L{TypeError}.\n\n L{URL} typechecks very aggressively to ensure that its constitutent\n parts are all properly immutable and to prevent confusing errors when\n bad data crops up in a method call long after the code that called the\n constructor is off the stack.\n \"\"\"\n class Unexpected(object):\n def __str__(self):\n return \"wrong\"\n\n def __repr__(self):\n return \"\"\n\n defaultExpectation = \"unicode\" if bytes is str else \"str\"\n\n def assertRaised(raised, expectation, name):\n self.assertEqual(str(raised.exception),\n \"expected {0} for {1}, got {2}\".format(\n expectation,\n name, \"\"))\n\n def check(param, expectation=defaultExpectation):\n with self.assertRaises(TypeError) as raised:\n URL(**{param: Unexpected()})\n\n assertRaised(raised, expectation, param)\n\n check(\"scheme\")\n check(\"host\")\n check(\"fragment\")\n check(\"rooted\", \"bool\")\n check(\"userinfo\")\n check(\"port\", \"int or NoneType\")\n\n with self.assertRaises(TypeError) as raised:\n URL(path=[Unexpected()])\n\n assertRaised(raised, defaultExpectation, \"path segment\")\n\n with self.assertRaises(TypeError) as raised:\n URL(query=[(u\"name\", Unexpected())])\n\n assertRaised(raised, defaultExpectation + \" or NoneType\",\n \"query parameter value\")\n\n with self.assertRaises(TypeError) as raised:\n URL(query=[(Unexpected(), u\"value\")])\n\n assertRaised(raised, defaultExpectation, \"query parameter name\")\n # No custom error message for this one, just want to make sure\n # non-2-tuples don't get through.\n\n with self.assertRaises(TypeError):\n URL(query=[Unexpected()])\n\n with self.assertRaises(ValueError):\n URL(query=[('k', 'v', 'vv')])\n\n with self.assertRaises(ValueError):\n URL(query=[('k',)])\n\n url = URL.from_text(\"https://valid.example.com/\")\n with self.assertRaises(TypeError) as raised:\n url.child(Unexpected())\n assertRaised(raised, defaultExpectation, \"path segment\")\n with self.assertRaises(TypeError) as raised:\n url.sibling(Unexpected())\n assertRaised(raised, defaultExpectation, \"path segment\")\n with self.assertRaises(TypeError) as raised:\n url.click(Unexpected())\n assertRaised(raised, defaultExpectation, \"relative URL\")\n\n def test_technicallyTextIsIterableBut(self):\n \"\"\"\n Technically, L{str} (or L{unicode}, as appropriate) is iterable, but\n C{URL(path=\"foo\")} resulting in C{URL.from_text(\"f/o/o\")} is never what\n you want.\n \"\"\"\n with self.assertRaises(TypeError) as raised:\n URL(path='foo')\n self.assertEqual(\n str(raised.exception),\n \"expected iterable of text for path, not: {0}\"\n .format(repr('foo'))\n )\n\n def test_netloc(self):\n url = URL(scheme='https')\n self.assertEqual(url.uses_netloc, True)\n\n url = URL(scheme='git+https')\n self.assertEqual(url.uses_netloc, True)\n\n url = URL(scheme='mailto')\n self.assertEqual(url.uses_netloc, False)\n\n url = URL(scheme='ztp')\n self.assertEqual(url.uses_netloc, None)\n\n url = URL.from_text('ztp://test.com')\n self.assertEqual(url.uses_netloc, True)\n\n url = URL.from_text('ztp:test:com')\n self.assertEqual(url.uses_netloc, False)\n\n def test_ipv6_with_port(self):\n t = 'https://[2001:0db8:85a3:0000:0000:8a2e:0370:7334]:80/'\n url = URL.from_text(t)\n assert url.host == '2001:0db8:85a3:0000:0000:8a2e:0370:7334'\n assert url.port == 80\n assert SCHEME_PORT_MAP[url.scheme] != url.port\n\n def test_basic(self):\n text = 'https://user:pass@example.com/path/to/here?k=v#nice'\n url = URL.from_text(text)\n assert url.scheme == 'https'\n assert url.userinfo == 'user:pass'\n assert url.host == 'example.com'\n assert url.path == ('path', 'to', 'here')\n assert url.fragment == 'nice'\n\n text = 'https://user:pass@127.0.0.1/path/to/here?k=v#nice'\n url = URL.from_text(text)\n assert url.scheme == 'https'\n assert url.userinfo == 'user:pass'\n assert url.host == '127.0.0.1'\n assert url.path == ('path', 'to', 'here')\n\n text = 'https://user:pass@[::1]/path/to/here?k=v#nice'\n url = URL.from_text(text)\n assert url.scheme == 'https'\n assert url.userinfo == 'user:pass'\n assert url.host == '::1'\n assert url.path == ('path', 'to', 'here')\n\n def test_invalid_url(self):\n self.assertRaises(URLParseError, URL.from_text, '#\\n\\n')\n\n def test_invalid_authority_url(self):\n self.assertRaises(URLParseError, URL.from_text, 'http://abc:\\n\\n/#')\n\n def test_invalid_ipv6(self):\n invalid_ipv6_ips = ['2001::0234:C1ab::A0:aabc:003F',\n '2001::1::3F',\n ':',\n '::::',\n '::256.0.0.1']\n for ip in invalid_ipv6_ips:\n url_text = 'http://[' + ip + ']'\n self.assertRaises(socket.error, inet_pton,\n socket.AF_INET6, ip)\n self.assertRaises(URLParseError, URL.from_text, url_text)\n\n def test_invalid_port(self):\n self.assertRaises(URLParseError, URL.from_text, 'ftp://portmouth:smash')\n self.assertRaises(ValueError, URL.from_text,\n 'http://reader.googlewebsite.com:neverforget')\n\n def test_idna(self):\n u1 = URL.from_text('http://bücher.ch')\n self.assertEquals(u1.host, 'bücher.ch')\n self.assertEquals(u1.to_text(), 'http://bücher.ch')\n self.assertEquals(u1.to_uri().to_text(), 'http://xn--bcher-kva.ch')\n\n u2 = URL.from_text('https://xn--bcher-kva.ch')\n self.assertEquals(u2.host, 'xn--bcher-kva.ch')\n self.assertEquals(u2.to_text(), 'https://xn--bcher-kva.ch')\n self.assertEquals(u2.to_iri().to_text(), u'https://bücher.ch')\n\n def test_netloc_slashes(self):\n # basic sanity checks\n url = URL.from_text('mailto:mahmoud@hatnote.com')\n self.assertEquals(url.scheme, 'mailto')\n self.assertEquals(url.to_text(), 'mailto:mahmoud@hatnote.com')\n\n url = URL.from_text('http://hatnote.com')\n self.assertEquals(url.scheme, 'http')\n self.assertEquals(url.to_text(), 'http://hatnote.com')\n\n # test that unrecognized schemes stay consistent with '//'\n url = URL.from_text('newscheme:a:b:c')\n self.assertEquals(url.scheme, 'newscheme')\n self.assertEquals(url.to_text(), 'newscheme:a:b:c')\n\n url = URL.from_text('newerscheme://a/b/c')\n self.assertEquals(url.scheme, 'newerscheme')\n self.assertEquals(url.to_text(), 'newerscheme://a/b/c')\n\n # test that reasonable guesses are made\n url = URL.from_text('git+ftp://gitstub.biz/glyph/lefkowitz')\n self.assertEquals(url.scheme, 'git+ftp')\n self.assertEquals(url.to_text(),\n 'git+ftp://gitstub.biz/glyph/lefkowitz')\n\n url = URL.from_text('what+mailto:freerealestate@enotuniq.org')\n self.assertEquals(url.scheme, 'what+mailto')\n self.assertEquals(url.to_text(),\n 'what+mailto:freerealestate@enotuniq.org')\n\n url = URL(scheme='ztp', path=('x', 'y', 'z'), rooted=True)\n self.assertEquals(url.to_text(), 'ztp:/x/y/z')\n\n # also works when the input doesn't include '//'\n url = URL(scheme='git+ftp', path=('x', 'y', 'z' ,''),\n rooted=True, uses_netloc=True)\n # broken bc urlunsplit\n self.assertEquals(url.to_text(), 'git+ftp:///x/y/z/')\n\n # really why would this ever come up but ok\n url = URL.from_text('file:///path/to/heck')\n url2 = url.replace(scheme='mailto')\n self.assertEquals(url2.to_text(), 'mailto:/path/to/heck')\n\n url_text = 'unregisteredscheme:///a/b/c'\n url = URL.from_text(url_text)\n no_netloc_url = url.replace(uses_netloc=False)\n self.assertEquals(no_netloc_url.to_text(), 'unregisteredscheme:/a/b/c')\n netloc_url = url.replace(uses_netloc=True)\n self.assertEquals(netloc_url.to_text(), url_text)\n\n return\n\n def test_wrong_constructor(self):\n with self.assertRaises(ValueError):\n # whole URL not allowed\n URL(BASIC_URL)\n with self.assertRaises(ValueError):\n # explicitly bad scheme not allowed\n URL('HTTP_____more_like_imHoTTeP')\n\n def test_encoded_userinfo(self):\n url = URL.from_text('http://user:pass@example.com')\n assert url.userinfo == 'user:pass'\n url = url.replace(userinfo='us%20her:pass')\n iri = url.to_iri()\n assert iri.to_text(with_password=True) == 'http://us her:pass@example.com'\n assert iri.to_text(with_password=False) == 'http://us her:@example.com'\n assert iri.to_uri().to_text(with_password=True) == 'http://us%20her:pass@example.com'\n\n def test_hash(self):\n url_map = {}\n url1 = URL.from_text('http://blog.hatnote.com/ask?utm_source=geocity')\n assert hash(url1) == hash(url1) # sanity\n\n url_map[url1] = 1\n\n url2 = URL.from_text('http://blog.hatnote.com/ask')\n url2 = url2.set('utm_source', 'geocity')\n\n url_map[url2] = 2\n\n assert len(url_map) == 1\n assert list(url_map.values()) == [2]\n\n assert hash(URL()) == hash(URL()) # slightly more sanity\n\n def test_dir(self):\n url = URL()\n res = dir(url)\n\n assert len(res) > 15\n # twisted compat\n assert 'fromText' not in res\n assert 'asText' not in res\n assert 'asURI' not in res\n assert 'asIRI' not in res\n\n def test_twisted_compat(self):\n url = URL.fromText(u'http://example.com/a%20té%C3%A9st')\n assert url.asText() == 'http://example.com/a%20té%C3%A9st'\n assert url.asURI().asText() == 'http://example.com/a%20t%C3%A9%C3%A9st'\n # TODO: assert url.asIRI().asText() == u'http://example.com/a%20téést'\n\n def test_set_ordering(self):\n # TODO\n url = URL.from_text('http://example.com/?a=b&c')\n url = url.set(u'x', u'x')\n url = url.add(u'x', u'y')\n assert url.to_text() == u'http://example.com/?a=b&x=x&c&x=y'\n # Would expect:\n # assert url.to_text() == u'http://example.com/?a=b&c&x=x&x=y'\n\n def test_schemeless_path(self):\n \"See issue #4\"\n u1 = URL.from_text(\"urn%3Aietf%3Awg%3Aoauth%3A2.0%3Aoob\")\n u2 = URL.from_text(u1.to_text())\n assert u1 == u2 # sanity testing roundtripping\n\n u3 = URL.from_text(u1.to_iri().to_text())\n assert u1 == u3\n assert u2 == u3\n\n # test that colons are ok past the first segment\n u4 = URL.from_text(\"first-segment/urn%3Aietf%3Awg%3Aoauth%3A2.0%3Aoob\")\n u5 = u4.to_iri()\n assert u5.to_text() == u'first-segment/urn:ietf:wg:oauth:2.0:oob'\n\n u6 = URL.from_text(u5.to_text()).to_uri()\n assert u5 == u6 # colons stay decoded bc they're not in the first seg\n\n def test_emoji_domain(self):\n \"See issue #7, affecting only narrow builds (2.6-3.3)\"\n url = URL.from_text('https://xn--vi8hiv.ws')\n iri = url.to_iri()\n iri.to_text()\n # as long as we don't get ValueErrors, we're good\n\n def test_delim_in_param(self):\n \"Per issue #6 and #8\"\n self.assertRaises(ValueError, URL, scheme=u'http', host=u'a/c')\n self.assertRaises(ValueError, URL, path=(u\"?\",))\n self.assertRaises(ValueError, URL, path=(u\"#\",))\n self.assertRaises(ValueError, URL, query=((u\"&\", \"test\")))\n\n def test_empty_paths_eq(self):\n u1 = URL.from_text('http://example.com/')\n u2 = URL.from_text('http://example.com')\n\n assert u1 == u2\n\n u1 = URL.from_text('http://example.com')\n u2 = URL.from_text('http://example.com')\n\n assert u1 == u2\n\n u1 = URL.from_text('http://example.com')\n u2 = URL.from_text('http://example.com/')\n\n assert u1 == u2\n\n u1 = URL.from_text('http://example.com/')\n u2 = URL.from_text('http://example.com/')\n\n assert u1 == u2\n\n def test_from_text_type(self):\n assert URL.from_text(u'#ok').fragment == u'ok' # sanity\n self.assertRaises(TypeError, URL.from_text, b'bytes://x.y.z')\n self.assertRaises(TypeError, URL.from_text, object())\n\n def test_from_text_bad_authority(self):\n # bad ipv6 brackets\n self.assertRaises(URLParseError, URL.from_text, 'http://[::1/')\n self.assertRaises(URLParseError, URL.from_text, 'http://::1]/')\n self.assertRaises(URLParseError, URL.from_text, 'http://[[::1]/')\n self.assertRaises(URLParseError, URL.from_text, 'http://[::1]]/')\n\n # empty port\n self.assertRaises(URLParseError, URL.from_text, 'http://127.0.0.1:')\n # non-integer port\n self.assertRaises(URLParseError, URL.from_text, 'http://127.0.0.1:hi')\n # extra port colon (makes for an invalid host)\n self.assertRaises(URLParseError, URL.from_text, 'http://127.0.0.1::80')\n\n def test_normalize(self):\n url = URL.from_text('HTTP://Example.com/A%61/./../A%61?B%62=C%63#D%64')\n assert url.get('Bb') == []\n assert url.get('B%62') == ['C%63']\n assert len(url.path) == 4\n\n # test that most expected normalizations happen\n norm_url = url.normalize()\n\n assert norm_url.scheme == 'http'\n assert norm_url.host == 'example.com'\n assert norm_url.path == ('Aa',)\n assert norm_url.get('Bb') == ['Cc']\n assert norm_url.fragment == 'Dd'\n assert norm_url.to_text() == 'http://example.com/Aa?Bb=Cc#Dd'\n\n # test that flags work\n noop_norm_url = url.normalize(scheme=False, host=False,\n path=False, query=False, fragment=False)\n assert noop_norm_url == url\n\n # test that empty paths get at least one slash\n slashless_url = URL.from_text('http://example.io')\n slashful_url = slashless_url.normalize()\n assert slashful_url.to_text() == 'http://example.io/'\n\n # test case normalization for percent encoding\n delimited_url = URL.from_text('/a%2fb/cd%3f?k%3d=v%23#test')\n norm_delimited_url = delimited_url.normalize()\n assert norm_delimited_url.to_text() == '/a%2Fb/cd%3F?k%3D=v%23#test'\n\n # test invalid percent encoding during normalize\n assert URL(path=('', '%te%sts')).normalize(percents=False).to_text() == '/%te%sts'\n assert URL(path=('', '%te%sts')).normalize().to_text() == '/%25te%25sts'\n\n percenty_url = URL(scheme='ftp', path=['%%%', '%a%b'], query=[('%', '%%')], fragment='%', userinfo='%:%')\n\n assert percenty_url.to_text(with_password=True) == 'ftp://%:%@/%%%/%a%b?%=%%#%'\n assert percenty_url.normalize().to_text(with_password=True) == 'ftp://%25:%25@/%25%25%25/%25a%25b?%25=%25%25#%25'\n\n def test_str(self):\n # see also issue #49\n text = u'http://example.com/á/y%20a%20y/?b=%25'\n url = URL.from_text(text)\n assert unicode(url) == text\n assert bytes(url) == b'http://example.com/%C3%A1/y%20a%20y/?b=%25'\n\n if PY2:\n assert isinstance(str(url), bytes)\n assert isinstance(unicode(url), unicode)\n else:\n assert isinstance(str(url), unicode)\n assert isinstance(bytes(url), bytes)\n\n def test_idna_corners(self):\n text = u'http://abé.com/'\n url = URL.from_text(text)\n assert url.to_iri().host == u'abé.com'\n assert url.to_uri().host == u'xn--ab-cja.com'\n\n url = URL.from_text(\"http://ドメイン.テスト.co.jp#test\")\n assert url.to_iri().host == u'ドメイン.テスト.co.jp'\n assert url.to_uri().host == u'xn--eckwd4c7c.xn--zckzah.co.jp'\n\n assert url.to_uri().get_decoded_url().host == u'ドメイン.テスト.co.jp'\n\n assert URL.from_text('http://Example.com').to_uri().get_decoded_url().host == 'example.com'\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hyperlink-19.0.0.dist-info/DESCRIPTION.rst",
"content": "The humble, but powerful, URL runs everything around us. Chances\nare you've used several just to read this text.\n\nHyperlink is a featureful, pure-Python implementation of the URL, with\nan emphasis on correctness. BSD licensed.\n\nSee the docs at http://hyperlink.readthedocs.io.\n\n\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hyperlink-19.0.0.dist-info/INSTALLER",
"content": "pip\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hyperlink-19.0.0.dist-info/METADATA",
"content": "Metadata-Version: 2.0\nName: hyperlink\nVersion: 19.0.0\nSummary: A featureful, immutable, and correct URL for Python.\nHome-page: https://github.com/python-hyper/hyperlink\nAuthor: Mahmoud Hashemi and Glyph Lefkowitz\nAuthor-email: mahmoud@hatnote.com\nLicense: MIT\nPlatform: any\nClassifier: Topic :: Utilities\nClassifier: Intended Audience :: Developers\nClassifier: Topic :: Software Development :: Libraries\nClassifier: Development Status :: 5 - Production/Stable\nClassifier: Programming Language :: Python :: 2.6\nClassifier: Programming Language :: Python :: 2.7\nClassifier: Programming Language :: Python :: 3.4\nClassifier: Programming Language :: Python :: 3.5\nClassifier: Programming Language :: Python :: 3.6\nClassifier: Programming Language :: Python :: Implementation :: PyPy\nRequires-Dist: idna (>=2.5)\n\nThe humble, but powerful, URL runs everything around us. Chances\nare you've used several just to read this text.\n\nHyperlink is a featureful, pure-Python implementation of the URL, with\nan emphasis on correctness. BSD licensed.\n\nSee the docs at http://hyperlink.readthedocs.io.\n\n\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hyperlink-19.0.0.dist-info/RECORD",
"content": "hyperlink-19.0.0.dist-info/DESCRIPTION.rst,sha256=a-0GCP8glYZ0Ysq4Y0mPEe6VJHqJNsGdheikkI7rwCo,279\r\nhyperlink-19.0.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4\r\nhyperlink-19.0.0.dist-info/METADATA,sha256=y172hVTAqkayU3cFJRIJNy5At7oX9iecXN70uD1tY68,1087\r\nhyperlink-19.0.0.dist-info/RECORD,,\r\nhyperlink-19.0.0.dist-info/WHEEL,sha256=5wvfB7GvgZAbKBSE9uX9Zbi6LCL-_KgezgHblXhCRnM,113\r\nhyperlink-19.0.0.dist-info/metadata.json,sha256=JAh7SySskyDcNAPuBXetb6bTuS_-euZRkk75-LVtNBI,983\r\nhyperlink-19.0.0.dist-info/top_level.txt,sha256=qKx9FGU_zxD9mGqiFgleNejfO4AwPY7duhQPaZ30U_M,10\r\nhyperlink/__init__.py,sha256=OFqG_8hDTyyc8MmhVR-LyXL-aShz_Y9Qg98__-vcfTE,302\r\nhyperlink/__pycache__/__init__.cpython-36.pyc,,\r\nhyperlink/__pycache__/_url.cpython-36.pyc,,\r\nhyperlink/_url.py,sha256=JW1raJr9hSmMyqDi_1GTgo0oes2RGL_zsEXhkaQLHKE,72479\r\nhyperlink/test/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0\r\nhyperlink/test/__pycache__/__init__.cpython-36.pyc,,\r\nhyperlink/test/__pycache__/common.cpython-36.pyc,,\r\nhyperlink/test/__pycache__/test_common.cpython-36.pyc,,\r\nhyperlink/test/__pycache__/test_decoded_url.cpython-36.pyc,,\r\nhyperlink/test/__pycache__/test_parse.cpython-36.pyc,,\r\nhyperlink/test/__pycache__/test_scheme_registration.cpython-36.pyc,,\r\nhyperlink/test/__pycache__/test_url.cpython-36.pyc,,\r\nhyperlink/test/common.py,sha256=fZ0gLTlEC1YFnlyn8Hc7_aJJCEGadL1Glw3BVtIvOkQ,2108\r\nhyperlink/test/test_common.py,sha256=6wiI5TjCYO0cyJwPXSL3TFTlkaSyGYGem5_uGIN-6p8,3399\r\nhyperlink/test/test_decoded_url.py,sha256=2aF0fxCJXVjSdownHyD7y-HMnlsnRnsHl4RPOPdKYpM,6259\r\nhyperlink/test/test_parse.py,sha256=HOF7Ns2tGnXUDrX5i8apyVEfnqsiuCtHu2_9uueY5xg,1081\r\nhyperlink/test/test_scheme_registration.py,sha256=cRlrJVt3aFCAYOpz6rqSf9YHFBgjsimbfNdW8PYqbfM,2328\r\nhyperlink/test/test_url.py,sha256=a8mHV7_VfsW4_Uim13q3PSvmBCMLHut_lu9b4zFv8W4,47162\r\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hyperlink-19.0.0.dist-info/WHEEL",
"content": "Wheel-Version: 1.0\nGenerator: bdist_wheel (0.30.0.a0)\nRoot-Is-Purelib: true\nTag: py2-none-any\nTag: py3-none-any\n\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hyperlink-19.0.0.dist-info/metadata.json",
"content": "{\"classifiers\": [\"Topic :: Utilities\", \"Intended Audience :: Developers\", \"Topic :: Software Development :: Libraries\", \"Development Status :: 5 - Production/Stable\", \"Programming Language :: Python :: 2.6\", \"Programming Language :: Python :: 2.7\", \"Programming Language :: Python :: 3.4\", \"Programming Language :: Python :: 3.5\", \"Programming Language :: Python :: 3.6\", \"Programming Language :: Python :: Implementation :: PyPy\"], \"extensions\": {\"python.details\": {\"contacts\": [{\"email\": \"mahmoud@hatnote.com\", \"name\": \"Mahmoud Hashemi and Glyph Lefkowitz\", \"role\": \"author\"}], \"document_names\": {\"description\": \"DESCRIPTION.rst\"}, \"project_urls\": {\"Home\": \"https://github.com/python-hyper/hyperlink\"}}}, \"extras\": [], \"generator\": \"bdist_wheel (0.30.0.a0)\", \"license\": \"MIT\", \"metadata_version\": \"2.0\", \"name\": \"hyperlink\", \"platform\": \"any\", \"run_requires\": [{\"requires\": [\"idna (>=2.5)\"]}], \"summary\": \"A featureful, immutable, and correct URL for Python.\", \"version\": \"19.0.0\"}"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/hyperlink-19.0.0.dist-info/top_level.txt",
"content": "hyperlink\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/idna/__init__.py",
"content": "from .package_data import __version__\nfrom .core import *\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/idna/codec.py",
"content": "from .core import encode, decode, alabel, ulabel, IDNAError\nimport codecs\nimport re\n\n_unicode_dots_re = re.compile(u'[\\u002e\\u3002\\uff0e\\uff61]')\n\nclass Codec(codecs.Codec):\n\n def encode(self, data, errors='strict'):\n\n if errors != 'strict':\n raise IDNAError(\"Unsupported error handling \\\"{0}\\\"\".format(errors))\n\n if not data:\n return \"\", 0\n\n return encode(data), len(data)\n\n def decode(self, data, errors='strict'):\n\n if errors != 'strict':\n raise IDNAError(\"Unsupported error handling \\\"{0}\\\"\".format(errors))\n\n if not data:\n return u\"\", 0\n\n return decode(data), len(data)\n\nclass IncrementalEncoder(codecs.BufferedIncrementalEncoder):\n def _buffer_encode(self, data, errors, final):\n if errors != 'strict':\n raise IDNAError(\"Unsupported error handling \\\"{0}\\\"\".format(errors))\n\n if not data:\n return (\"\", 0)\n\n labels = _unicode_dots_re.split(data)\n trailing_dot = u''\n if labels:\n if not labels[-1]:\n trailing_dot = '.'\n del labels[-1]\n elif not final:\n # Keep potentially unfinished label until the next call\n del labels[-1]\n if labels:\n trailing_dot = '.'\n\n result = []\n size = 0\n for label in labels:\n result.append(alabel(label))\n if size:\n size += 1\n size += len(label)\n\n # Join with U+002E\n result = \".\".join(result) + trailing_dot\n size += len(trailing_dot)\n return (result, size)\n\nclass IncrementalDecoder(codecs.BufferedIncrementalDecoder):\n def _buffer_decode(self, data, errors, final):\n if errors != 'strict':\n raise IDNAError(\"Unsupported error handling \\\"{0}\\\"\".format(errors))\n\n if not data:\n return (u\"\", 0)\n\n # IDNA allows decoding to operate on Unicode strings, too.\n if isinstance(data, unicode):\n labels = _unicode_dots_re.split(data)\n else:\n # Must be ASCII string\n data = str(data)\n unicode(data, \"ascii\")\n labels = data.split(\".\")\n\n trailing_dot = u''\n if labels:\n if not labels[-1]:\n trailing_dot = u'.'\n del labels[-1]\n elif not final:\n # Keep potentially unfinished label until the next call\n del labels[-1]\n if labels:\n trailing_dot = u'.'\n\n result = []\n size = 0\n for label in labels:\n result.append(ulabel(label))\n if size:\n size += 1\n size += len(label)\n\n result = u\".\".join(result) + trailing_dot\n size += len(trailing_dot)\n return (result, size)\n\n\nclass StreamWriter(Codec, codecs.StreamWriter):\n pass\n\nclass StreamReader(Codec, codecs.StreamReader):\n pass\n\ndef getregentry():\n return codecs.CodecInfo(\n name='idna',\n encode=Codec().encode,\n decode=Codec().decode,\n incrementalencoder=IncrementalEncoder,\n incrementaldecoder=IncrementalDecoder,\n streamwriter=StreamWriter,\n streamreader=StreamReader,\n )\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/idna/compat.py",
"content": "from .core import *\nfrom .codec import *\n\ndef ToASCII(label):\n return encode(label)\n\ndef ToUnicode(label):\n return decode(label)\n\ndef nameprep(s):\n raise NotImplementedError(\"IDNA 2008 does not utilise nameprep protocol\")\n\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/idna/core.py",
"content": "from . import idnadata\nimport bisect\nimport unicodedata\nimport re\nimport sys\nfrom .intranges import intranges_contain\n\n_virama_combining_class = 9\n_alabel_prefix = b'xn--'\n_unicode_dots_re = re.compile(u'[\\u002e\\u3002\\uff0e\\uff61]')\n\nif sys.version_info[0] == 3:\n unicode = str\n unichr = chr\n\nclass IDNAError(UnicodeError):\n \"\"\" Base exception for all IDNA-encoding related problems \"\"\"\n pass\n\n\nclass IDNABidiError(IDNAError):\n \"\"\" Exception when bidirectional requirements are not satisfied \"\"\"\n pass\n\n\nclass InvalidCodepoint(IDNAError):\n \"\"\" Exception when a disallowed or unallocated codepoint is used \"\"\"\n pass\n\n\nclass InvalidCodepointContext(IDNAError):\n \"\"\" Exception when the codepoint is not valid in the context it is used \"\"\"\n pass\n\n\ndef _combining_class(cp):\n v = unicodedata.combining(unichr(cp))\n if v == 0:\n if not unicodedata.name(unichr(cp)):\n raise ValueError(\"Unknown character in unicodedata\")\n return v\n\ndef _is_script(cp, script):\n return intranges_contain(ord(cp), idnadata.scripts[script])\n\ndef _punycode(s):\n return s.encode('punycode')\n\ndef _unot(s):\n return 'U+{0:04X}'.format(s)\n\n\ndef valid_label_length(label):\n\n if len(label) > 63:\n return False\n return True\n\n\ndef valid_string_length(label, trailing_dot):\n\n if len(label) > (254 if trailing_dot else 253):\n return False\n return True\n\n\ndef check_bidi(label, check_ltr=False):\n\n # Bidi rules should only be applied if string contains RTL characters\n bidi_label = False\n for (idx, cp) in enumerate(label, 1):\n direction = unicodedata.bidirectional(cp)\n if direction == '':\n # String likely comes from a newer version of Unicode\n raise IDNABidiError('Unknown directionality in label {0} at position {1}'.format(repr(label), idx))\n if direction in ['R', 'AL', 'AN']:\n bidi_label = True\n if not bidi_label and not check_ltr:\n return True\n\n # Bidi rule 1\n direction = unicodedata.bidirectional(label[0])\n if direction in ['R', 'AL']:\n rtl = True\n elif direction == 'L':\n rtl = False\n else:\n raise IDNABidiError('First codepoint in label {0} must be directionality L, R or AL'.format(repr(label)))\n\n valid_ending = False\n number_type = False\n for (idx, cp) in enumerate(label, 1):\n direction = unicodedata.bidirectional(cp)\n\n if rtl:\n # Bidi rule 2\n if not direction in ['R', 'AL', 'AN', 'EN', 'ES', 'CS', 'ET', 'ON', 'BN', 'NSM']:\n raise IDNABidiError('Invalid direction for codepoint at position {0} in a right-to-left label'.format(idx))\n # Bidi rule 3\n if direction in ['R', 'AL', 'EN', 'AN']:\n valid_ending = True\n elif direction != 'NSM':\n valid_ending = False\n # Bidi rule 4\n if direction in ['AN', 'EN']:\n if not number_type:\n number_type = direction\n else:\n if number_type != direction:\n raise IDNABidiError('Can not mix numeral types in a right-to-left label')\n else:\n # Bidi rule 5\n if not direction in ['L', 'EN', 'ES', 'CS', 'ET', 'ON', 'BN', 'NSM']:\n raise IDNABidiError('Invalid direction for codepoint at position {0} in a left-to-right label'.format(idx))\n # Bidi rule 6\n if direction in ['L', 'EN']:\n valid_ending = True\n elif direction != 'NSM':\n valid_ending = False\n\n if not valid_ending:\n raise IDNABidiError('Label ends with illegal codepoint directionality')\n\n return True\n\n\ndef check_initial_combiner(label):\n\n if unicodedata.category(label[0])[0] == 'M':\n raise IDNAError('Label begins with an illegal combining character')\n return True\n\n\ndef check_hyphen_ok(label):\n\n if label[2:4] == '--':\n raise IDNAError('Label has disallowed hyphens in 3rd and 4th position')\n if label[0] == '-' or label[-1] == '-':\n raise IDNAError('Label must not start or end with a hyphen')\n return True\n\n\ndef check_nfc(label):\n\n if unicodedata.normalize('NFC', label) != label:\n raise IDNAError('Label must be in Normalization Form C')\n\n\ndef valid_contextj(label, pos):\n\n cp_value = ord(label[pos])\n\n if cp_value == 0x200c:\n\n if pos > 0:\n if _combining_class(ord(label[pos - 1])) == _virama_combining_class:\n return True\n\n ok = False\n for i in range(pos-1, -1, -1):\n joining_type = idnadata.joining_types.get(ord(label[i]))\n if joining_type == ord('T'):\n continue\n if joining_type in [ord('L'), ord('D')]:\n ok = True\n break\n\n if not ok:\n return False\n\n ok = False\n for i in range(pos+1, len(label)):\n joining_type = idnadata.joining_types.get(ord(label[i]))\n if joining_type == ord('T'):\n continue\n if joining_type in [ord('R'), ord('D')]:\n ok = True\n break\n return ok\n\n if cp_value == 0x200d:\n\n if pos > 0:\n if _combining_class(ord(label[pos - 1])) == _virama_combining_class:\n return True\n return False\n\n else:\n\n return False\n\n\ndef valid_contexto(label, pos, exception=False):\n\n cp_value = ord(label[pos])\n\n if cp_value == 0x00b7:\n if 0 < pos < len(label)-1:\n if ord(label[pos - 1]) == 0x006c and ord(label[pos + 1]) == 0x006c:\n return True\n return False\n\n elif cp_value == 0x0375:\n if pos < len(label)-1 and len(label) > 1:\n return _is_script(label[pos + 1], 'Greek')\n return False\n\n elif cp_value == 0x05f3 or cp_value == 0x05f4:\n if pos > 0:\n return _is_script(label[pos - 1], 'Hebrew')\n return False\n\n elif cp_value == 0x30fb:\n for cp in label:\n if cp == u'\\u30fb':\n continue\n if _is_script(cp, 'Hiragana') or _is_script(cp, 'Katakana') or _is_script(cp, 'Han'):\n return True\n return False\n\n elif 0x660 <= cp_value <= 0x669:\n for cp in label:\n if 0x6f0 <= ord(cp) <= 0x06f9:\n return False\n return True\n\n elif 0x6f0 <= cp_value <= 0x6f9:\n for cp in label:\n if 0x660 <= ord(cp) <= 0x0669:\n return False\n return True\n\n\ndef check_label(label):\n\n if isinstance(label, (bytes, bytearray)):\n label = label.decode('utf-8')\n if len(label) == 0:\n raise IDNAError('Empty Label')\n\n check_nfc(label)\n check_hyphen_ok(label)\n check_initial_combiner(label)\n\n for (pos, cp) in enumerate(label):\n cp_value = ord(cp)\n if intranges_contain(cp_value, idnadata.codepoint_classes['PVALID']):\n continue\n elif intranges_contain(cp_value, idnadata.codepoint_classes['CONTEXTJ']):\n try:\n if not valid_contextj(label, pos):\n raise InvalidCodepointContext('Joiner {0} not allowed at position {1} in {2}'.format(\n _unot(cp_value), pos+1, repr(label)))\n except ValueError:\n raise IDNAError('Unknown codepoint adjacent to joiner {0} at position {1} in {2}'.format(\n _unot(cp_value), pos+1, repr(label)))\n elif intranges_contain(cp_value, idnadata.codepoint_classes['CONTEXTO']):\n if not valid_contexto(label, pos):\n raise InvalidCodepointContext('Codepoint {0} not allowed at position {1} in {2}'.format(_unot(cp_value), pos+1, repr(label)))\n else:\n raise InvalidCodepoint('Codepoint {0} at position {1} of {2} not allowed'.format(_unot(cp_value), pos+1, repr(label)))\n\n check_bidi(label)\n\n\ndef alabel(label):\n\n try:\n label = label.encode('ascii')\n ulabel(label)\n if not valid_label_length(label):\n raise IDNAError('Label too long')\n return label\n except UnicodeEncodeError:\n pass\n\n if not label:\n raise IDNAError('No Input')\n\n label = unicode(label)\n check_label(label)\n label = _punycode(label)\n label = _alabel_prefix + label\n\n if not valid_label_length(label):\n raise IDNAError('Label too long')\n\n return label\n\n\ndef ulabel(label):\n\n if not isinstance(label, (bytes, bytearray)):\n try:\n label = label.encode('ascii')\n except UnicodeEncodeError:\n check_label(label)\n return label\n\n label = label.lower()\n if label.startswith(_alabel_prefix):\n label = label[len(_alabel_prefix):]\n else:\n check_label(label)\n return label.decode('ascii')\n\n label = label.decode('punycode')\n check_label(label)\n return label\n\n\ndef uts46_remap(domain, std3_rules=True, transitional=False):\n \"\"\"Re-map the characters in the string according to UTS46 processing.\"\"\"\n from .uts46data import uts46data\n output = u\"\"\n try:\n for pos, char in enumerate(domain):\n code_point = ord(char)\n uts46row = uts46data[code_point if code_point < 256 else\n bisect.bisect_left(uts46data, (code_point, \"Z\")) - 1]\n status = uts46row[1]\n replacement = uts46row[2] if len(uts46row) == 3 else None\n if (status == \"V\" or\n (status == \"D\" and not transitional) or\n (status == \"3\" and not std3_rules and replacement is None)):\n output += char\n elif replacement is not None and (status == \"M\" or\n (status == \"3\" and not std3_rules) or\n (status == \"D\" and transitional)):\n output += replacement\n elif status != \"I\":\n raise IndexError()\n return unicodedata.normalize(\"NFC\", output)\n except IndexError:\n raise InvalidCodepoint(\n \"Codepoint {0} not allowed at position {1} in {2}\".format(\n _unot(code_point), pos + 1, repr(domain)))\n\n\ndef encode(s, strict=False, uts46=False, std3_rules=False, transitional=False):\n\n if isinstance(s, (bytes, bytearray)):\n s = s.decode(\"ascii\")\n if uts46:\n s = uts46_remap(s, std3_rules, transitional)\n trailing_dot = False\n result = []\n if strict:\n labels = s.split('.')\n else:\n labels = _unicode_dots_re.split(s)\n if not labels or labels == ['']:\n raise IDNAError('Empty domain')\n if labels[-1] == '':\n del labels[-1]\n trailing_dot = True\n for label in labels:\n s = alabel(label)\n if s:\n result.append(s)\n else:\n raise IDNAError('Empty label')\n if trailing_dot:\n result.append(b'')\n s = b'.'.join(result)\n if not valid_string_length(s, trailing_dot):\n raise IDNAError('Domain too long')\n return s\n\n\ndef decode(s, strict=False, uts46=False, std3_rules=False):\n\n if isinstance(s, (bytes, bytearray)):\n s = s.decode(\"ascii\")\n if uts46:\n s = uts46_remap(s, std3_rules, False)\n trailing_dot = False\n result = []\n if not strict:\n labels = _unicode_dots_re.split(s)\n else:\n labels = s.split(u'.')\n if not labels or labels == ['']:\n raise IDNAError('Empty domain')\n if not labels[-1]:\n del labels[-1]\n trailing_dot = True\n for label in labels:\n s = ulabel(label)\n if s:\n result.append(s)\n else:\n raise IDNAError('Empty label')\n if trailing_dot:\n result.append(u'')\n return u'.'.join(result)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/idna/idnadata.py",
"content": "# This file is automatically generated by tools/idna-data\n\n__version__ = \"11.0.0\"\nscripts = {\n 'Greek': (\n 0x37000000374,\n 0x37500000378,\n 0x37a0000037e,\n 0x37f00000380,\n 0x38400000385,\n 0x38600000387,\n 0x3880000038b,\n 0x38c0000038d,\n 0x38e000003a2,\n 0x3a3000003e2,\n 0x3f000000400,\n 0x1d2600001d2b,\n 0x1d5d00001d62,\n 0x1d6600001d6b,\n 0x1dbf00001dc0,\n 0x1f0000001f16,\n 0x1f1800001f1e,\n 0x1f2000001f46,\n 0x1f4800001f4e,\n 0x1f5000001f58,\n 0x1f5900001f5a,\n 0x1f5b00001f5c,\n 0x1f5d00001f5e,\n 0x1f5f00001f7e,\n 0x1f8000001fb5,\n 0x1fb600001fc5,\n 0x1fc600001fd4,\n 0x1fd600001fdc,\n 0x1fdd00001ff0,\n 0x1ff200001ff5,\n 0x1ff600001fff,\n 0x212600002127,\n 0xab650000ab66,\n 0x101400001018f,\n 0x101a0000101a1,\n 0x1d2000001d246,\n ),\n 'Han': (\n 0x2e8000002e9a,\n 0x2e9b00002ef4,\n 0x2f0000002fd6,\n 0x300500003006,\n 0x300700003008,\n 0x30210000302a,\n 0x30380000303c,\n 0x340000004db6,\n 0x4e0000009ff0,\n 0xf9000000fa6e,\n 0xfa700000fada,\n 0x200000002a6d7,\n 0x2a7000002b735,\n 0x2b7400002b81e,\n 0x2b8200002cea2,\n 0x2ceb00002ebe1,\n 0x2f8000002fa1e,\n ),\n 'Hebrew': (\n 0x591000005c8,\n 0x5d0000005eb,\n 0x5ef000005f5,\n 0xfb1d0000fb37,\n 0xfb380000fb3d,\n 0xfb3e0000fb3f,\n 0xfb400000fb42,\n 0xfb430000fb45,\n 0xfb460000fb50,\n ),\n 'Hiragana': (\n 0x304100003097,\n 0x309d000030a0,\n 0x1b0010001b11f,\n 0x1f2000001f201,\n ),\n 'Katakana': (\n 0x30a1000030fb,\n 0x30fd00003100,\n 0x31f000003200,\n 0x32d0000032ff,\n 0x330000003358,\n 0xff660000ff70,\n 0xff710000ff9e,\n 0x1b0000001b001,\n ),\n}\njoining_types = {\n 0x600: 85,\n 0x601: 85,\n 0x602: 85,\n 0x603: 85,\n 0x604: 85,\n 0x605: 85,\n 0x608: 85,\n 0x60b: 85,\n 0x620: 68,\n 0x621: 85,\n 0x622: 82,\n 0x623: 82,\n 0x624: 82,\n 0x625: 82,\n 0x626: 68,\n 0x627: 82,\n 0x628: 68,\n 0x629: 82,\n 0x62a: 68,\n 0x62b: 68,\n 0x62c: 68,\n 0x62d: 68,\n 0x62e: 68,\n 0x62f: 82,\n 0x630: 82,\n 0x631: 82,\n 0x632: 82,\n 0x633: 68,\n 0x634: 68,\n 0x635: 68,\n 0x636: 68,\n 0x637: 68,\n 0x638: 68,\n 0x639: 68,\n 0x63a: 68,\n 0x63b: 68,\n 0x63c: 68,\n 0x63d: 68,\n 0x63e: 68,\n 0x63f: 68,\n 0x640: 67,\n 0x641: 68,\n 0x642: 68,\n 0x643: 68,\n 0x644: 68,\n 0x645: 68,\n 0x646: 68,\n 0x647: 68,\n 0x648: 82,\n 0x649: 68,\n 0x64a: 68,\n 0x66e: 68,\n 0x66f: 68,\n 0x671: 82,\n 0x672: 82,\n 0x673: 82,\n 0x674: 85,\n 0x675: 82,\n 0x676: 82,\n 0x677: 82,\n 0x678: 68,\n 0x679: 68,\n 0x67a: 68,\n 0x67b: 68,\n 0x67c: 68,\n 0x67d: 68,\n 0x67e: 68,\n 0x67f: 68,\n 0x680: 68,\n 0x681: 68,\n 0x682: 68,\n 0x683: 68,\n 0x684: 68,\n 0x685: 68,\n 0x686: 68,\n 0x687: 68,\n 0x688: 82,\n 0x689: 82,\n 0x68a: 82,\n 0x68b: 82,\n 0x68c: 82,\n 0x68d: 82,\n 0x68e: 82,\n 0x68f: 82,\n 0x690: 82,\n 0x691: 82,\n 0x692: 82,\n 0x693: 82,\n 0x694: 82,\n 0x695: 82,\n 0x696: 82,\n 0x697: 82,\n 0x698: 82,\n 0x699: 82,\n 0x69a: 68,\n 0x69b: 68,\n 0x69c: 68,\n 0x69d: 68,\n 0x69e: 68,\n 0x69f: 68,\n 0x6a0: 68,\n 0x6a1: 68,\n 0x6a2: 68,\n 0x6a3: 68,\n 0x6a4: 68,\n 0x6a5: 68,\n 0x6a6: 68,\n 0x6a7: 68,\n 0x6a8: 68,\n 0x6a9: 68,\n 0x6aa: 68,\n 0x6ab: 68,\n 0x6ac: 68,\n 0x6ad: 68,\n 0x6ae: 68,\n 0x6af: 68,\n 0x6b0: 68,\n 0x6b1: 68,\n 0x6b2: 68,\n 0x6b3: 68,\n 0x6b4: 68,\n 0x6b5: 68,\n 0x6b6: 68,\n 0x6b7: 68,\n 0x6b8: 68,\n 0x6b9: 68,\n 0x6ba: 68,\n 0x6bb: 68,\n 0x6bc: 68,\n 0x6bd: 68,\n 0x6be: 68,\n 0x6bf: 68,\n 0x6c0: 82,\n 0x6c1: 68,\n 0x6c2: 68,\n 0x6c3: 82,\n 0x6c4: 82,\n 0x6c5: 82,\n 0x6c6: 82,\n 0x6c7: 82,\n 0x6c8: 82,\n 0x6c9: 82,\n 0x6ca: 82,\n 0x6cb: 82,\n 0x6cc: 68,\n 0x6cd: 82,\n 0x6ce: 68,\n 0x6cf: 82,\n 0x6d0: 68,\n 0x6d1: 68,\n 0x6d2: 82,\n 0x6d3: 82,\n 0x6d5: 82,\n 0x6dd: 85,\n 0x6ee: 82,\n 0x6ef: 82,\n 0x6fa: 68,\n 0x6fb: 68,\n 0x6fc: 68,\n 0x6ff: 68,\n 0x70f: 84,\n 0x710: 82,\n 0x712: 68,\n 0x713: 68,\n 0x714: 68,\n 0x715: 82,\n 0x716: 82,\n 0x717: 82,\n 0x718: 82,\n 0x719: 82,\n 0x71a: 68,\n 0x71b: 68,\n 0x71c: 68,\n 0x71d: 68,\n 0x71e: 82,\n 0x71f: 68,\n 0x720: 68,\n 0x721: 68,\n 0x722: 68,\n 0x723: 68,\n 0x724: 68,\n 0x725: 68,\n 0x726: 68,\n 0x727: 68,\n 0x728: 82,\n 0x729: 68,\n 0x72a: 82,\n 0x72b: 68,\n 0x72c: 82,\n 0x72d: 68,\n 0x72e: 68,\n 0x72f: 82,\n 0x74d: 82,\n 0x74e: 68,\n 0x74f: 68,\n 0x750: 68,\n 0x751: 68,\n 0x752: 68,\n 0x753: 68,\n 0x754: 68,\n 0x755: 68,\n 0x756: 68,\n 0x757: 68,\n 0x758: 68,\n 0x759: 82,\n 0x75a: 82,\n 0x75b: 82,\n 0x75c: 68,\n 0x75d: 68,\n 0x75e: 68,\n 0x75f: 68,\n 0x760: 68,\n 0x761: 68,\n 0x762: 68,\n 0x763: 68,\n 0x764: 68,\n 0x765: 68,\n 0x766: 68,\n 0x767: 68,\n 0x768: 68,\n 0x769: 68,\n 0x76a: 68,\n 0x76b: 82,\n 0x76c: 82,\n 0x76d: 68,\n 0x76e: 68,\n 0x76f: 68,\n 0x770: 68,\n 0x771: 82,\n 0x772: 68,\n 0x773: 82,\n 0x774: 82,\n 0x775: 68,\n 0x776: 68,\n 0x777: 68,\n 0x778: 82,\n 0x779: 82,\n 0x77a: 68,\n 0x77b: 68,\n 0x77c: 68,\n 0x77d: 68,\n 0x77e: 68,\n 0x77f: 68,\n 0x7ca: 68,\n 0x7cb: 68,\n 0x7cc: 68,\n 0x7cd: 68,\n 0x7ce: 68,\n 0x7cf: 68,\n 0x7d0: 68,\n 0x7d1: 68,\n 0x7d2: 68,\n 0x7d3: 68,\n 0x7d4: 68,\n 0x7d5: 68,\n 0x7d6: 68,\n 0x7d7: 68,\n 0x7d8: 68,\n 0x7d9: 68,\n 0x7da: 68,\n 0x7db: 68,\n 0x7dc: 68,\n 0x7dd: 68,\n 0x7de: 68,\n 0x7df: 68,\n 0x7e0: 68,\n 0x7e1: 68,\n 0x7e2: 68,\n 0x7e3: 68,\n 0x7e4: 68,\n 0x7e5: 68,\n 0x7e6: 68,\n 0x7e7: 68,\n 0x7e8: 68,\n 0x7e9: 68,\n 0x7ea: 68,\n 0x7fa: 67,\n 0x840: 82,\n 0x841: 68,\n 0x842: 68,\n 0x843: 68,\n 0x844: 68,\n 0x845: 68,\n 0x846: 82,\n 0x847: 82,\n 0x848: 68,\n 0x849: 82,\n 0x84a: 68,\n 0x84b: 68,\n 0x84c: 68,\n 0x84d: 68,\n 0x84e: 68,\n 0x84f: 68,\n 0x850: 68,\n 0x851: 68,\n 0x852: 68,\n 0x853: 68,\n 0x854: 82,\n 0x855: 68,\n 0x856: 85,\n 0x857: 85,\n 0x858: 85,\n 0x860: 68,\n 0x861: 85,\n 0x862: 68,\n 0x863: 68,\n 0x864: 68,\n 0x865: 68,\n 0x866: 85,\n 0x867: 82,\n 0x868: 68,\n 0x869: 82,\n 0x86a: 82,\n 0x8a0: 68,\n 0x8a1: 68,\n 0x8a2: 68,\n 0x8a3: 68,\n 0x8a4: 68,\n 0x8a5: 68,\n 0x8a6: 68,\n 0x8a7: 68,\n 0x8a8: 68,\n 0x8a9: 68,\n 0x8aa: 82,\n 0x8ab: 82,\n 0x8ac: 82,\n 0x8ad: 85,\n 0x8ae: 82,\n 0x8af: 68,\n 0x8b0: 68,\n 0x8b1: 82,\n 0x8b2: 82,\n 0x8b3: 68,\n 0x8b4: 68,\n 0x8b6: 68,\n 0x8b7: 68,\n 0x8b8: 68,\n 0x8b9: 82,\n 0x8ba: 68,\n 0x8bb: 68,\n 0x8bc: 68,\n 0x8bd: 68,\n 0x8e2: 85,\n 0x1806: 85,\n 0x1807: 68,\n 0x180a: 67,\n 0x180e: 85,\n 0x1820: 68,\n 0x1821: 68,\n 0x1822: 68,\n 0x1823: 68,\n 0x1824: 68,\n 0x1825: 68,\n 0x1826: 68,\n 0x1827: 68,\n 0x1828: 68,\n 0x1829: 68,\n 0x182a: 68,\n 0x182b: 68,\n 0x182c: 68,\n 0x182d: 68,\n 0x182e: 68,\n 0x182f: 68,\n 0x1830: 68,\n 0x1831: 68,\n 0x1832: 68,\n 0x1833: 68,\n 0x1834: 68,\n 0x1835: 68,\n 0x1836: 68,\n 0x1837: 68,\n 0x1838: 68,\n 0x1839: 68,\n 0x183a: 68,\n 0x183b: 68,\n 0x183c: 68,\n 0x183d: 68,\n 0x183e: 68,\n 0x183f: 68,\n 0x1840: 68,\n 0x1841: 68,\n 0x1842: 68,\n 0x1843: 68,\n 0x1844: 68,\n 0x1845: 68,\n 0x1846: 68,\n 0x1847: 68,\n 0x1848: 68,\n 0x1849: 68,\n 0x184a: 68,\n 0x184b: 68,\n 0x184c: 68,\n 0x184d: 68,\n 0x184e: 68,\n 0x184f: 68,\n 0x1850: 68,\n 0x1851: 68,\n 0x1852: 68,\n 0x1853: 68,\n 0x1854: 68,\n 0x1855: 68,\n 0x1856: 68,\n 0x1857: 68,\n 0x1858: 68,\n 0x1859: 68,\n 0x185a: 68,\n 0x185b: 68,\n 0x185c: 68,\n 0x185d: 68,\n 0x185e: 68,\n 0x185f: 68,\n 0x1860: 68,\n 0x1861: 68,\n 0x1862: 68,\n 0x1863: 68,\n 0x1864: 68,\n 0x1865: 68,\n 0x1866: 68,\n 0x1867: 68,\n 0x1868: 68,\n 0x1869: 68,\n 0x186a: 68,\n 0x186b: 68,\n 0x186c: 68,\n 0x186d: 68,\n 0x186e: 68,\n 0x186f: 68,\n 0x1870: 68,\n 0x1871: 68,\n 0x1872: 68,\n 0x1873: 68,\n 0x1874: 68,\n 0x1875: 68,\n 0x1876: 68,\n 0x1877: 68,\n 0x1878: 68,\n 0x1880: 85,\n 0x1881: 85,\n 0x1882: 85,\n 0x1883: 85,\n 0x1884: 85,\n 0x1885: 84,\n 0x1886: 84,\n 0x1887: 68,\n 0x1888: 68,\n 0x1889: 68,\n 0x188a: 68,\n 0x188b: 68,\n 0x188c: 68,\n 0x188d: 68,\n 0x188e: 68,\n 0x188f: 68,\n 0x1890: 68,\n 0x1891: 68,\n 0x1892: 68,\n 0x1893: 68,\n 0x1894: 68,\n 0x1895: 68,\n 0x1896: 68,\n 0x1897: 68,\n 0x1898: 68,\n 0x1899: 68,\n 0x189a: 68,\n 0x189b: 68,\n 0x189c: 68,\n 0x189d: 68,\n 0x189e: 68,\n 0x189f: 68,\n 0x18a0: 68,\n 0x18a1: 68,\n 0x18a2: 68,\n 0x18a3: 68,\n 0x18a4: 68,\n 0x18a5: 68,\n 0x18a6: 68,\n 0x18a7: 68,\n 0x18a8: 68,\n 0x18aa: 68,\n 0x200c: 85,\n 0x200d: 67,\n 0x202f: 85,\n 0x2066: 85,\n 0x2067: 85,\n 0x2068: 85,\n 0x2069: 85,\n 0xa840: 68,\n 0xa841: 68,\n 0xa842: 68,\n 0xa843: 68,\n 0xa844: 68,\n 0xa845: 68,\n 0xa846: 68,\n 0xa847: 68,\n 0xa848: 68,\n 0xa849: 68,\n 0xa84a: 68,\n 0xa84b: 68,\n 0xa84c: 68,\n 0xa84d: 68,\n 0xa84e: 68,\n 0xa84f: 68,\n 0xa850: 68,\n 0xa851: 68,\n 0xa852: 68,\n 0xa853: 68,\n 0xa854: 68,\n 0xa855: 68,\n 0xa856: 68,\n 0xa857: 68,\n 0xa858: 68,\n 0xa859: 68,\n 0xa85a: 68,\n 0xa85b: 68,\n 0xa85c: 68,\n 0xa85d: 68,\n 0xa85e: 68,\n 0xa85f: 68,\n 0xa860: 68,\n 0xa861: 68,\n 0xa862: 68,\n 0xa863: 68,\n 0xa864: 68,\n 0xa865: 68,\n 0xa866: 68,\n 0xa867: 68,\n 0xa868: 68,\n 0xa869: 68,\n 0xa86a: 68,\n 0xa86b: 68,\n 0xa86c: 68,\n 0xa86d: 68,\n 0xa86e: 68,\n 0xa86f: 68,\n 0xa870: 68,\n 0xa871: 68,\n 0xa872: 76,\n 0xa873: 85,\n 0x10ac0: 68,\n 0x10ac1: 68,\n 0x10ac2: 68,\n 0x10ac3: 68,\n 0x10ac4: 68,\n 0x10ac5: 82,\n 0x10ac6: 85,\n 0x10ac7: 82,\n 0x10ac8: 85,\n 0x10ac9: 82,\n 0x10aca: 82,\n 0x10acb: 85,\n 0x10acc: 85,\n 0x10acd: 76,\n 0x10ace: 82,\n 0x10acf: 82,\n 0x10ad0: 82,\n 0x10ad1: 82,\n 0x10ad2: 82,\n 0x10ad3: 68,\n 0x10ad4: 68,\n 0x10ad5: 68,\n 0x10ad6: 68,\n 0x10ad7: 76,\n 0x10ad8: 68,\n 0x10ad9: 68,\n 0x10ada: 68,\n 0x10adb: 68,\n 0x10adc: 68,\n 0x10add: 82,\n 0x10ade: 68,\n 0x10adf: 68,\n 0x10ae0: 68,\n 0x10ae1: 82,\n 0x10ae2: 85,\n 0x10ae3: 85,\n 0x10ae4: 82,\n 0x10aeb: 68,\n 0x10aec: 68,\n 0x10aed: 68,\n 0x10aee: 68,\n 0x10aef: 82,\n 0x10b80: 68,\n 0x10b81: 82,\n 0x10b82: 68,\n 0x10b83: 82,\n 0x10b84: 82,\n 0x10b85: 82,\n 0x10b86: 68,\n 0x10b87: 68,\n 0x10b88: 68,\n 0x10b89: 82,\n 0x10b8a: 68,\n 0x10b8b: 68,\n 0x10b8c: 82,\n 0x10b8d: 68,\n 0x10b8e: 82,\n 0x10b8f: 82,\n 0x10b90: 68,\n 0x10b91: 82,\n 0x10ba9: 82,\n 0x10baa: 82,\n 0x10bab: 82,\n 0x10bac: 82,\n 0x10bad: 68,\n 0x10bae: 68,\n 0x10baf: 85,\n 0x10d00: 76,\n 0x10d01: 68,\n 0x10d02: 68,\n 0x10d03: 68,\n 0x10d04: 68,\n 0x10d05: 68,\n 0x10d06: 68,\n 0x10d07: 68,\n 0x10d08: 68,\n 0x10d09: 68,\n 0x10d0a: 68,\n 0x10d0b: 68,\n 0x10d0c: 68,\n 0x10d0d: 68,\n 0x10d0e: 68,\n 0x10d0f: 68,\n 0x10d10: 68,\n 0x10d11: 68,\n 0x10d12: 68,\n 0x10d13: 68,\n 0x10d14: 68,\n 0x10d15: 68,\n 0x10d16: 68,\n 0x10d17: 68,\n 0x10d18: 68,\n 0x10d19: 68,\n 0x10d1a: 68,\n 0x10d1b: 68,\n 0x10d1c: 68,\n 0x10d1d: 68,\n 0x10d1e: 68,\n 0x10d1f: 68,\n 0x10d20: 68,\n 0x10d21: 68,\n 0x10d22: 82,\n 0x10d23: 68,\n 0x10f30: 68,\n 0x10f31: 68,\n 0x10f32: 68,\n 0x10f33: 82,\n 0x10f34: 68,\n 0x10f35: 68,\n 0x10f36: 68,\n 0x10f37: 68,\n 0x10f38: 68,\n 0x10f39: 68,\n 0x10f3a: 68,\n 0x10f3b: 68,\n 0x10f3c: 68,\n 0x10f3d: 68,\n 0x10f3e: 68,\n 0x10f3f: 68,\n 0x10f40: 68,\n 0x10f41: 68,\n 0x10f42: 68,\n 0x10f43: 68,\n 0x10f44: 68,\n 0x10f45: 85,\n 0x10f51: 68,\n 0x10f52: 68,\n 0x10f53: 68,\n 0x10f54: 82,\n 0x110bd: 85,\n 0x110cd: 85,\n 0x1e900: 68,\n 0x1e901: 68,\n 0x1e902: 68,\n 0x1e903: 68,\n 0x1e904: 68,\n 0x1e905: 68,\n 0x1e906: 68,\n 0x1e907: 68,\n 0x1e908: 68,\n 0x1e909: 68,\n 0x1e90a: 68,\n 0x1e90b: 68,\n 0x1e90c: 68,\n 0x1e90d: 68,\n 0x1e90e: 68,\n 0x1e90f: 68,\n 0x1e910: 68,\n 0x1e911: 68,\n 0x1e912: 68,\n 0x1e913: 68,\n 0x1e914: 68,\n 0x1e915: 68,\n 0x1e916: 68,\n 0x1e917: 68,\n 0x1e918: 68,\n 0x1e919: 68,\n 0x1e91a: 68,\n 0x1e91b: 68,\n 0x1e91c: 68,\n 0x1e91d: 68,\n 0x1e91e: 68,\n 0x1e91f: 68,\n 0x1e920: 68,\n 0x1e921: 68,\n 0x1e922: 68,\n 0x1e923: 68,\n 0x1e924: 68,\n 0x1e925: 68,\n 0x1e926: 68,\n 0x1e927: 68,\n 0x1e928: 68,\n 0x1e929: 68,\n 0x1e92a: 68,\n 0x1e92b: 68,\n 0x1e92c: 68,\n 0x1e92d: 68,\n 0x1e92e: 68,\n 0x1e92f: 68,\n 0x1e930: 68,\n 0x1e931: 68,\n 0x1e932: 68,\n 0x1e933: 68,\n 0x1e934: 68,\n 0x1e935: 68,\n 0x1e936: 68,\n 0x1e937: 68,\n 0x1e938: 68,\n 0x1e939: 68,\n 0x1e93a: 68,\n 0x1e93b: 68,\n 0x1e93c: 68,\n 0x1e93d: 68,\n 0x1e93e: 68,\n 0x1e93f: 68,\n 0x1e940: 68,\n 0x1e941: 68,\n 0x1e942: 68,\n 0x1e943: 68,\n}\ncodepoint_classes = {\n 'PVALID': (\n 0x2d0000002e,\n 0x300000003a,\n 0x610000007b,\n 0xdf000000f7,\n 0xf800000100,\n 0x10100000102,\n 0x10300000104,\n 0x10500000106,\n 0x10700000108,\n 0x1090000010a,\n 0x10b0000010c,\n 0x10d0000010e,\n 0x10f00000110,\n 0x11100000112,\n 0x11300000114,\n 0x11500000116,\n 0x11700000118,\n 0x1190000011a,\n 0x11b0000011c,\n 0x11d0000011e,\n 0x11f00000120,\n 0x12100000122,\n 0x12300000124,\n 0x12500000126,\n 0x12700000128,\n 0x1290000012a,\n 0x12b0000012c,\n 0x12d0000012e,\n 0x12f00000130,\n 0x13100000132,\n 0x13500000136,\n 0x13700000139,\n 0x13a0000013b,\n 0x13c0000013d,\n 0x13e0000013f,\n 0x14200000143,\n 0x14400000145,\n 0x14600000147,\n 0x14800000149,\n 0x14b0000014c,\n 0x14d0000014e,\n 0x14f00000150,\n 0x15100000152,\n 0x15300000154,\n 0x15500000156,\n 0x15700000158,\n 0x1590000015a,\n 0x15b0000015c,\n 0x15d0000015e,\n 0x15f00000160,\n 0x16100000162,\n 0x16300000164,\n 0x16500000166,\n 0x16700000168,\n 0x1690000016a,\n 0x16b0000016c,\n 0x16d0000016e,\n 0x16f00000170,\n 0x17100000172,\n 0x17300000174,\n 0x17500000176,\n 0x17700000178,\n 0x17a0000017b,\n 0x17c0000017d,\n 0x17e0000017f,\n 0x18000000181,\n 0x18300000184,\n 0x18500000186,\n 0x18800000189,\n 0x18c0000018e,\n 0x19200000193,\n 0x19500000196,\n 0x1990000019c,\n 0x19e0000019f,\n 0x1a1000001a2,\n 0x1a3000001a4,\n 0x1a5000001a6,\n 0x1a8000001a9,\n 0x1aa000001ac,\n 0x1ad000001ae,\n 0x1b0000001b1,\n 0x1b4000001b5,\n 0x1b6000001b7,\n 0x1b9000001bc,\n 0x1bd000001c4,\n 0x1ce000001cf,\n 0x1d0000001d1,\n 0x1d2000001d3,\n 0x1d4000001d5,\n 0x1d6000001d7,\n 0x1d8000001d9,\n 0x1da000001db,\n 0x1dc000001de,\n 0x1df000001e0,\n 0x1e1000001e2,\n 0x1e3000001e4,\n 0x1e5000001e6,\n 0x1e7000001e8,\n 0x1e9000001ea,\n 0x1eb000001ec,\n 0x1ed000001ee,\n 0x1ef000001f1,\n 0x1f5000001f6,\n 0x1f9000001fa,\n 0x1fb000001fc,\n 0x1fd000001fe,\n 0x1ff00000200,\n 0x20100000202,\n 0x20300000204,\n 0x20500000206,\n 0x20700000208,\n 0x2090000020a,\n 0x20b0000020c,\n 0x20d0000020e,\n 0x20f00000210,\n 0x21100000212,\n 0x21300000214,\n 0x21500000216,\n 0x21700000218,\n 0x2190000021a,\n 0x21b0000021c,\n 0x21d0000021e,\n 0x21f00000220,\n 0x22100000222,\n 0x22300000224,\n 0x22500000226,\n 0x22700000228,\n 0x2290000022a,\n 0x22b0000022c,\n 0x22d0000022e,\n 0x22f00000230,\n 0x23100000232,\n 0x2330000023a,\n 0x23c0000023d,\n 0x23f00000241,\n 0x24200000243,\n 0x24700000248,\n 0x2490000024a,\n 0x24b0000024c,\n 0x24d0000024e,\n 0x24f000002b0,\n 0x2b9000002c2,\n 0x2c6000002d2,\n 0x2ec000002ed,\n 0x2ee000002ef,\n 0x30000000340,\n 0x34200000343,\n 0x3460000034f,\n 0x35000000370,\n 0x37100000372,\n 0x37300000374,\n 0x37700000378,\n 0x37b0000037e,\n 0x39000000391,\n 0x3ac000003cf,\n 0x3d7000003d8,\n 0x3d9000003da,\n 0x3db000003dc,\n 0x3dd000003de,\n 0x3df000003e0,\n 0x3e1000003e2,\n 0x3e3000003e4,\n 0x3e5000003e6,\n 0x3e7000003e8,\n 0x3e9000003ea,\n 0x3eb000003ec,\n 0x3ed000003ee,\n 0x3ef000003f0,\n 0x3f3000003f4,\n 0x3f8000003f9,\n 0x3fb000003fd,\n 0x43000000460,\n 0x46100000462,\n 0x46300000464,\n 0x46500000466,\n 0x46700000468,\n 0x4690000046a,\n 0x46b0000046c,\n 0x46d0000046e,\n 0x46f00000470,\n 0x47100000472,\n 0x47300000474,\n 0x47500000476,\n 0x47700000478,\n 0x4790000047a,\n 0x47b0000047c,\n 0x47d0000047e,\n 0x47f00000480,\n 0x48100000482,\n 0x48300000488,\n 0x48b0000048c,\n 0x48d0000048e,\n 0x48f00000490,\n 0x49100000492,\n 0x49300000494,\n 0x49500000496,\n 0x49700000498,\n 0x4990000049a,\n 0x49b0000049c,\n 0x49d0000049e,\n 0x49f000004a0,\n 0x4a1000004a2,\n 0x4a3000004a4,\n 0x4a5000004a6,\n 0x4a7000004a8,\n 0x4a9000004aa,\n 0x4ab000004ac,\n 0x4ad000004ae,\n 0x4af000004b0,\n 0x4b1000004b2,\n 0x4b3000004b4,\n 0x4b5000004b6,\n 0x4b7000004b8,\n 0x4b9000004ba,\n 0x4bb000004bc,\n 0x4bd000004be,\n 0x4bf000004c0,\n 0x4c2000004c3,\n 0x4c4000004c5,\n 0x4c6000004c7,\n 0x4c8000004c9,\n 0x4ca000004cb,\n 0x4cc000004cd,\n 0x4ce000004d0,\n 0x4d1000004d2,\n 0x4d3000004d4,\n 0x4d5000004d6,\n 0x4d7000004d8,\n 0x4d9000004da,\n 0x4db000004dc,\n 0x4dd000004de,\n 0x4df000004e0,\n 0x4e1000004e2,\n 0x4e3000004e4,\n 0x4e5000004e6,\n 0x4e7000004e8,\n 0x4e9000004ea,\n 0x4eb000004ec,\n 0x4ed000004ee,\n 0x4ef000004f0,\n 0x4f1000004f2,\n 0x4f3000004f4,\n 0x4f5000004f6,\n 0x4f7000004f8,\n 0x4f9000004fa,\n 0x4fb000004fc,\n 0x4fd000004fe,\n 0x4ff00000500,\n 0x50100000502,\n 0x50300000504,\n 0x50500000506,\n 0x50700000508,\n 0x5090000050a,\n 0x50b0000050c,\n 0x50d0000050e,\n 0x50f00000510,\n 0x51100000512,\n 0x51300000514,\n 0x51500000516,\n 0x51700000518,\n 0x5190000051a,\n 0x51b0000051c,\n 0x51d0000051e,\n 0x51f00000520,\n 0x52100000522,\n 0x52300000524,\n 0x52500000526,\n 0x52700000528,\n 0x5290000052a,\n 0x52b0000052c,\n 0x52d0000052e,\n 0x52f00000530,\n 0x5590000055a,\n 0x56000000587,\n 0x58800000589,\n 0x591000005be,\n 0x5bf000005c0,\n 0x5c1000005c3,\n 0x5c4000005c6,\n 0x5c7000005c8,\n 0x5d0000005eb,\n 0x5ef000005f3,\n 0x6100000061b,\n 0x62000000640,\n 0x64100000660,\n 0x66e00000675,\n 0x679000006d4,\n 0x6d5000006dd,\n 0x6df000006e9,\n 0x6ea000006f0,\n 0x6fa00000700,\n 0x7100000074b,\n 0x74d000007b2,\n 0x7c0000007f6,\n 0x7fd000007fe,\n 0x8000000082e,\n 0x8400000085c,\n 0x8600000086b,\n 0x8a0000008b5,\n 0x8b6000008be,\n 0x8d3000008e2,\n 0x8e300000958,\n 0x96000000964,\n 0x96600000970,\n 0x97100000984,\n 0x9850000098d,\n 0x98f00000991,\n 0x993000009a9,\n 0x9aa000009b1,\n 0x9b2000009b3,\n 0x9b6000009ba,\n 0x9bc000009c5,\n 0x9c7000009c9,\n 0x9cb000009cf,\n 0x9d7000009d8,\n 0x9e0000009e4,\n 0x9e6000009f2,\n 0x9fc000009fd,\n 0x9fe000009ff,\n 0xa0100000a04,\n 0xa0500000a0b,\n 0xa0f00000a11,\n 0xa1300000a29,\n 0xa2a00000a31,\n 0xa3200000a33,\n 0xa3500000a36,\n 0xa3800000a3a,\n 0xa3c00000a3d,\n 0xa3e00000a43,\n 0xa4700000a49,\n 0xa4b00000a4e,\n 0xa5100000a52,\n 0xa5c00000a5d,\n 0xa6600000a76,\n 0xa8100000a84,\n 0xa8500000a8e,\n 0xa8f00000a92,\n 0xa9300000aa9,\n 0xaaa00000ab1,\n 0xab200000ab4,\n 0xab500000aba,\n 0xabc00000ac6,\n 0xac700000aca,\n 0xacb00000ace,\n 0xad000000ad1,\n 0xae000000ae4,\n 0xae600000af0,\n 0xaf900000b00,\n 0xb0100000b04,\n 0xb0500000b0d,\n 0xb0f00000b11,\n 0xb1300000b29,\n 0xb2a00000b31,\n 0xb3200000b34,\n 0xb3500000b3a,\n 0xb3c00000b45,\n 0xb4700000b49,\n 0xb4b00000b4e,\n 0xb5600000b58,\n 0xb5f00000b64,\n 0xb6600000b70,\n 0xb7100000b72,\n 0xb8200000b84,\n 0xb8500000b8b,\n 0xb8e00000b91,\n 0xb9200000b96,\n 0xb9900000b9b,\n 0xb9c00000b9d,\n 0xb9e00000ba0,\n 0xba300000ba5,\n 0xba800000bab,\n 0xbae00000bba,\n 0xbbe00000bc3,\n 0xbc600000bc9,\n 0xbca00000bce,\n 0xbd000000bd1,\n 0xbd700000bd8,\n 0xbe600000bf0,\n 0xc0000000c0d,\n 0xc0e00000c11,\n 0xc1200000c29,\n 0xc2a00000c3a,\n 0xc3d00000c45,\n 0xc4600000c49,\n 0xc4a00000c4e,\n 0xc5500000c57,\n 0xc5800000c5b,\n 0xc6000000c64,\n 0xc6600000c70,\n 0xc8000000c84,\n 0xc8500000c8d,\n 0xc8e00000c91,\n 0xc9200000ca9,\n 0xcaa00000cb4,\n 0xcb500000cba,\n 0xcbc00000cc5,\n 0xcc600000cc9,\n 0xcca00000cce,\n 0xcd500000cd7,\n 0xcde00000cdf,\n 0xce000000ce4,\n 0xce600000cf0,\n 0xcf100000cf3,\n 0xd0000000d04,\n 0xd0500000d0d,\n 0xd0e00000d11,\n 0xd1200000d45,\n 0xd4600000d49,\n 0xd4a00000d4f,\n 0xd5400000d58,\n 0xd5f00000d64,\n 0xd6600000d70,\n 0xd7a00000d80,\n 0xd8200000d84,\n 0xd8500000d97,\n 0xd9a00000db2,\n 0xdb300000dbc,\n 0xdbd00000dbe,\n 0xdc000000dc7,\n 0xdca00000dcb,\n 0xdcf00000dd5,\n 0xdd600000dd7,\n 0xdd800000de0,\n 0xde600000df0,\n 0xdf200000df4,\n 0xe0100000e33,\n 0xe3400000e3b,\n 0xe4000000e4f,\n 0xe5000000e5a,\n 0xe8100000e83,\n 0xe8400000e85,\n 0xe8700000e89,\n 0xe8a00000e8b,\n 0xe8d00000e8e,\n 0xe9400000e98,\n 0xe9900000ea0,\n 0xea100000ea4,\n 0xea500000ea6,\n 0xea700000ea8,\n 0xeaa00000eac,\n 0xead00000eb3,\n 0xeb400000eba,\n 0xebb00000ebe,\n 0xec000000ec5,\n 0xec600000ec7,\n 0xec800000ece,\n 0xed000000eda,\n 0xede00000ee0,\n 0xf0000000f01,\n 0xf0b00000f0c,\n 0xf1800000f1a,\n 0xf2000000f2a,\n 0xf3500000f36,\n 0xf3700000f38,\n 0xf3900000f3a,\n 0xf3e00000f43,\n 0xf4400000f48,\n 0xf4900000f4d,\n 0xf4e00000f52,\n 0xf5300000f57,\n 0xf5800000f5c,\n 0xf5d00000f69,\n 0xf6a00000f6d,\n 0xf7100000f73,\n 0xf7400000f75,\n 0xf7a00000f81,\n 0xf8200000f85,\n 0xf8600000f93,\n 0xf9400000f98,\n 0xf9900000f9d,\n 0xf9e00000fa2,\n 0xfa300000fa7,\n 0xfa800000fac,\n 0xfad00000fb9,\n 0xfba00000fbd,\n 0xfc600000fc7,\n 0x10000000104a,\n 0x10500000109e,\n 0x10d0000010fb,\n 0x10fd00001100,\n 0x120000001249,\n 0x124a0000124e,\n 0x125000001257,\n 0x125800001259,\n 0x125a0000125e,\n 0x126000001289,\n 0x128a0000128e,\n 0x1290000012b1,\n 0x12b2000012b6,\n 0x12b8000012bf,\n 0x12c0000012c1,\n 0x12c2000012c6,\n 0x12c8000012d7,\n 0x12d800001311,\n 0x131200001316,\n 0x13180000135b,\n 0x135d00001360,\n 0x138000001390,\n 0x13a0000013f6,\n 0x14010000166d,\n 0x166f00001680,\n 0x16810000169b,\n 0x16a0000016eb,\n 0x16f1000016f9,\n 0x17000000170d,\n 0x170e00001715,\n 0x172000001735,\n 0x174000001754,\n 0x17600000176d,\n 0x176e00001771,\n 0x177200001774,\n 0x1780000017b4,\n 0x17b6000017d4,\n 0x17d7000017d8,\n 0x17dc000017de,\n 0x17e0000017ea,\n 0x18100000181a,\n 0x182000001879,\n 0x1880000018ab,\n 0x18b0000018f6,\n 0x19000000191f,\n 0x19200000192c,\n 0x19300000193c,\n 0x19460000196e,\n 0x197000001975,\n 0x1980000019ac,\n 0x19b0000019ca,\n 0x19d0000019da,\n 0x1a0000001a1c,\n 0x1a2000001a5f,\n 0x1a6000001a7d,\n 0x1a7f00001a8a,\n 0x1a9000001a9a,\n 0x1aa700001aa8,\n 0x1ab000001abe,\n 0x1b0000001b4c,\n 0x1b5000001b5a,\n 0x1b6b00001b74,\n 0x1b8000001bf4,\n 0x1c0000001c38,\n 0x1c4000001c4a,\n 0x1c4d00001c7e,\n 0x1cd000001cd3,\n 0x1cd400001cfa,\n 0x1d0000001d2c,\n 0x1d2f00001d30,\n 0x1d3b00001d3c,\n 0x1d4e00001d4f,\n 0x1d6b00001d78,\n 0x1d7900001d9b,\n 0x1dc000001dfa,\n 0x1dfb00001e00,\n 0x1e0100001e02,\n 0x1e0300001e04,\n 0x1e0500001e06,\n 0x1e0700001e08,\n 0x1e0900001e0a,\n 0x1e0b00001e0c,\n 0x1e0d00001e0e,\n 0x1e0f00001e10,\n 0x1e1100001e12,\n 0x1e1300001e14,\n 0x1e1500001e16,\n 0x1e1700001e18,\n 0x1e1900001e1a,\n 0x1e1b00001e1c,\n 0x1e1d00001e1e,\n 0x1e1f00001e20,\n 0x1e2100001e22,\n 0x1e2300001e24,\n 0x1e2500001e26,\n 0x1e2700001e28,\n 0x1e2900001e2a,\n 0x1e2b00001e2c,\n 0x1e2d00001e2e,\n 0x1e2f00001e30,\n 0x1e3100001e32,\n 0x1e3300001e34,\n 0x1e3500001e36,\n 0x1e3700001e38,\n 0x1e3900001e3a,\n 0x1e3b00001e3c,\n 0x1e3d00001e3e,\n 0x1e3f00001e40,\n 0x1e4100001e42,\n 0x1e4300001e44,\n 0x1e4500001e46,\n 0x1e4700001e48,\n 0x1e4900001e4a,\n 0x1e4b00001e4c,\n 0x1e4d00001e4e,\n 0x1e4f00001e50,\n 0x1e5100001e52,\n 0x1e5300001e54,\n 0x1e5500001e56,\n 0x1e5700001e58,\n 0x1e5900001e5a,\n 0x1e5b00001e5c,\n 0x1e5d00001e5e,\n 0x1e5f00001e60,\n 0x1e6100001e62,\n 0x1e6300001e64,\n 0x1e6500001e66,\n 0x1e6700001e68,\n 0x1e6900001e6a,\n 0x1e6b00001e6c,\n 0x1e6d00001e6e,\n 0x1e6f00001e70,\n 0x1e7100001e72,\n 0x1e7300001e74,\n 0x1e7500001e76,\n 0x1e7700001e78,\n 0x1e7900001e7a,\n 0x1e7b00001e7c,\n 0x1e7d00001e7e,\n 0x1e7f00001e80,\n 0x1e8100001e82,\n 0x1e8300001e84,\n 0x1e8500001e86,\n 0x1e8700001e88,\n 0x1e8900001e8a,\n 0x1e8b00001e8c,\n 0x1e8d00001e8e,\n 0x1e8f00001e90,\n 0x1e9100001e92,\n 0x1e9300001e94,\n 0x1e9500001e9a,\n 0x1e9c00001e9e,\n 0x1e9f00001ea0,\n 0x1ea100001ea2,\n 0x1ea300001ea4,\n 0x1ea500001ea6,\n 0x1ea700001ea8,\n 0x1ea900001eaa,\n 0x1eab00001eac,\n 0x1ead00001eae,\n 0x1eaf00001eb0,\n 0x1eb100001eb2,\n 0x1eb300001eb4,\n 0x1eb500001eb6,\n 0x1eb700001eb8,\n 0x1eb900001eba,\n 0x1ebb00001ebc,\n 0x1ebd00001ebe,\n 0x1ebf00001ec0,\n 0x1ec100001ec2,\n 0x1ec300001ec4,\n 0x1ec500001ec6,\n 0x1ec700001ec8,\n 0x1ec900001eca,\n 0x1ecb00001ecc,\n 0x1ecd00001ece,\n 0x1ecf00001ed0,\n 0x1ed100001ed2,\n 0x1ed300001ed4,\n 0x1ed500001ed6,\n 0x1ed700001ed8,\n 0x1ed900001eda,\n 0x1edb00001edc,\n 0x1edd00001ede,\n 0x1edf00001ee0,\n 0x1ee100001ee2,\n 0x1ee300001ee4,\n 0x1ee500001ee6,\n 0x1ee700001ee8,\n 0x1ee900001eea,\n 0x1eeb00001eec,\n 0x1eed00001eee,\n 0x1eef00001ef0,\n 0x1ef100001ef2,\n 0x1ef300001ef4,\n 0x1ef500001ef6,\n 0x1ef700001ef8,\n 0x1ef900001efa,\n 0x1efb00001efc,\n 0x1efd00001efe,\n 0x1eff00001f08,\n 0x1f1000001f16,\n 0x1f2000001f28,\n 0x1f3000001f38,\n 0x1f4000001f46,\n 0x1f5000001f58,\n 0x1f6000001f68,\n 0x1f7000001f71,\n 0x1f7200001f73,\n 0x1f7400001f75,\n 0x1f7600001f77,\n 0x1f7800001f79,\n 0x1f7a00001f7b,\n 0x1f7c00001f7d,\n 0x1fb000001fb2,\n 0x1fb600001fb7,\n 0x1fc600001fc7,\n 0x1fd000001fd3,\n 0x1fd600001fd8,\n 0x1fe000001fe3,\n 0x1fe400001fe8,\n 0x1ff600001ff7,\n 0x214e0000214f,\n 0x218400002185,\n 0x2c3000002c5f,\n 0x2c6100002c62,\n 0x2c6500002c67,\n 0x2c6800002c69,\n 0x2c6a00002c6b,\n 0x2c6c00002c6d,\n 0x2c7100002c72,\n 0x2c7300002c75,\n 0x2c7600002c7c,\n 0x2c8100002c82,\n 0x2c8300002c84,\n 0x2c8500002c86,\n 0x2c8700002c88,\n 0x2c8900002c8a,\n 0x2c8b00002c8c,\n 0x2c8d00002c8e,\n 0x2c8f00002c90,\n 0x2c9100002c92,\n 0x2c9300002c94,\n 0x2c9500002c96,\n 0x2c9700002c98,\n 0x2c9900002c9a,\n 0x2c9b00002c9c,\n 0x2c9d00002c9e,\n 0x2c9f00002ca0,\n 0x2ca100002ca2,\n 0x2ca300002ca4,\n 0x2ca500002ca6,\n 0x2ca700002ca8,\n 0x2ca900002caa,\n 0x2cab00002cac,\n 0x2cad00002cae,\n 0x2caf00002cb0,\n 0x2cb100002cb2,\n 0x2cb300002cb4,\n 0x2cb500002cb6,\n 0x2cb700002cb8,\n 0x2cb900002cba,\n 0x2cbb00002cbc,\n 0x2cbd00002cbe,\n 0x2cbf00002cc0,\n 0x2cc100002cc2,\n 0x2cc300002cc4,\n 0x2cc500002cc6,\n 0x2cc700002cc8,\n 0x2cc900002cca,\n 0x2ccb00002ccc,\n 0x2ccd00002cce,\n 0x2ccf00002cd0,\n 0x2cd100002cd2,\n 0x2cd300002cd4,\n 0x2cd500002cd6,\n 0x2cd700002cd8,\n 0x2cd900002cda,\n 0x2cdb00002cdc,\n 0x2cdd00002cde,\n 0x2cdf00002ce0,\n 0x2ce100002ce2,\n 0x2ce300002ce5,\n 0x2cec00002ced,\n 0x2cee00002cf2,\n 0x2cf300002cf4,\n 0x2d0000002d26,\n 0x2d2700002d28,\n 0x2d2d00002d2e,\n 0x2d3000002d68,\n 0x2d7f00002d97,\n 0x2da000002da7,\n 0x2da800002daf,\n 0x2db000002db7,\n 0x2db800002dbf,\n 0x2dc000002dc7,\n 0x2dc800002dcf,\n 0x2dd000002dd7,\n 0x2dd800002ddf,\n 0x2de000002e00,\n 0x2e2f00002e30,\n 0x300500003008,\n 0x302a0000302e,\n 0x303c0000303d,\n 0x304100003097,\n 0x30990000309b,\n 0x309d0000309f,\n 0x30a1000030fb,\n 0x30fc000030ff,\n 0x310500003130,\n 0x31a0000031bb,\n 0x31f000003200,\n 0x340000004db6,\n 0x4e0000009ff0,\n 0xa0000000a48d,\n 0xa4d00000a4fe,\n 0xa5000000a60d,\n 0xa6100000a62c,\n 0xa6410000a642,\n 0xa6430000a644,\n 0xa6450000a646,\n 0xa6470000a648,\n 0xa6490000a64a,\n 0xa64b0000a64c,\n 0xa64d0000a64e,\n 0xa64f0000a650,\n 0xa6510000a652,\n 0xa6530000a654,\n 0xa6550000a656,\n 0xa6570000a658,\n 0xa6590000a65a,\n 0xa65b0000a65c,\n 0xa65d0000a65e,\n 0xa65f0000a660,\n 0xa6610000a662,\n 0xa6630000a664,\n 0xa6650000a666,\n 0xa6670000a668,\n 0xa6690000a66a,\n 0xa66b0000a66c,\n 0xa66d0000a670,\n 0xa6740000a67e,\n 0xa67f0000a680,\n 0xa6810000a682,\n 0xa6830000a684,\n 0xa6850000a686,\n 0xa6870000a688,\n 0xa6890000a68a,\n 0xa68b0000a68c,\n 0xa68d0000a68e,\n 0xa68f0000a690,\n 0xa6910000a692,\n 0xa6930000a694,\n 0xa6950000a696,\n 0xa6970000a698,\n 0xa6990000a69a,\n 0xa69b0000a69c,\n 0xa69e0000a6e6,\n 0xa6f00000a6f2,\n 0xa7170000a720,\n 0xa7230000a724,\n 0xa7250000a726,\n 0xa7270000a728,\n 0xa7290000a72a,\n 0xa72b0000a72c,\n 0xa72d0000a72e,\n 0xa72f0000a732,\n 0xa7330000a734,\n 0xa7350000a736,\n 0xa7370000a738,\n 0xa7390000a73a,\n 0xa73b0000a73c,\n 0xa73d0000a73e,\n 0xa73f0000a740,\n 0xa7410000a742,\n 0xa7430000a744,\n 0xa7450000a746,\n 0xa7470000a748,\n 0xa7490000a74a,\n 0xa74b0000a74c,\n 0xa74d0000a74e,\n 0xa74f0000a750,\n 0xa7510000a752,\n 0xa7530000a754,\n 0xa7550000a756,\n 0xa7570000a758,\n 0xa7590000a75a,\n 0xa75b0000a75c,\n 0xa75d0000a75e,\n 0xa75f0000a760,\n 0xa7610000a762,\n 0xa7630000a764,\n 0xa7650000a766,\n 0xa7670000a768,\n 0xa7690000a76a,\n 0xa76b0000a76c,\n 0xa76d0000a76e,\n 0xa76f0000a770,\n 0xa7710000a779,\n 0xa77a0000a77b,\n 0xa77c0000a77d,\n 0xa77f0000a780,\n 0xa7810000a782,\n 0xa7830000a784,\n 0xa7850000a786,\n 0xa7870000a789,\n 0xa78c0000a78d,\n 0xa78e0000a790,\n 0xa7910000a792,\n 0xa7930000a796,\n 0xa7970000a798,\n 0xa7990000a79a,\n 0xa79b0000a79c,\n 0xa79d0000a79e,\n 0xa79f0000a7a0,\n 0xa7a10000a7a2,\n 0xa7a30000a7a4,\n 0xa7a50000a7a6,\n 0xa7a70000a7a8,\n 0xa7a90000a7aa,\n 0xa7af0000a7b0,\n 0xa7b50000a7b6,\n 0xa7b70000a7b8,\n 0xa7b90000a7ba,\n 0xa7f70000a7f8,\n 0xa7fa0000a828,\n 0xa8400000a874,\n 0xa8800000a8c6,\n 0xa8d00000a8da,\n 0xa8e00000a8f8,\n 0xa8fb0000a8fc,\n 0xa8fd0000a92e,\n 0xa9300000a954,\n 0xa9800000a9c1,\n 0xa9cf0000a9da,\n 0xa9e00000a9ff,\n 0xaa000000aa37,\n 0xaa400000aa4e,\n 0xaa500000aa5a,\n 0xaa600000aa77,\n 0xaa7a0000aac3,\n 0xaadb0000aade,\n 0xaae00000aaf0,\n 0xaaf20000aaf7,\n 0xab010000ab07,\n 0xab090000ab0f,\n 0xab110000ab17,\n 0xab200000ab27,\n 0xab280000ab2f,\n 0xab300000ab5b,\n 0xab600000ab66,\n 0xabc00000abeb,\n 0xabec0000abee,\n 0xabf00000abfa,\n 0xac000000d7a4,\n 0xfa0e0000fa10,\n 0xfa110000fa12,\n 0xfa130000fa15,\n 0xfa1f0000fa20,\n 0xfa210000fa22,\n 0xfa230000fa25,\n 0xfa270000fa2a,\n 0xfb1e0000fb1f,\n 0xfe200000fe30,\n 0xfe730000fe74,\n 0x100000001000c,\n 0x1000d00010027,\n 0x100280001003b,\n 0x1003c0001003e,\n 0x1003f0001004e,\n 0x100500001005e,\n 0x10080000100fb,\n 0x101fd000101fe,\n 0x102800001029d,\n 0x102a0000102d1,\n 0x102e0000102e1,\n 0x1030000010320,\n 0x1032d00010341,\n 0x103420001034a,\n 0x103500001037b,\n 0x103800001039e,\n 0x103a0000103c4,\n 0x103c8000103d0,\n 0x104280001049e,\n 0x104a0000104aa,\n 0x104d8000104fc,\n 0x1050000010528,\n 0x1053000010564,\n 0x1060000010737,\n 0x1074000010756,\n 0x1076000010768,\n 0x1080000010806,\n 0x1080800010809,\n 0x1080a00010836,\n 0x1083700010839,\n 0x1083c0001083d,\n 0x1083f00010856,\n 0x1086000010877,\n 0x108800001089f,\n 0x108e0000108f3,\n 0x108f4000108f6,\n 0x1090000010916,\n 0x109200001093a,\n 0x10980000109b8,\n 0x109be000109c0,\n 0x10a0000010a04,\n 0x10a0500010a07,\n 0x10a0c00010a14,\n 0x10a1500010a18,\n 0x10a1900010a36,\n 0x10a3800010a3b,\n 0x10a3f00010a40,\n 0x10a6000010a7d,\n 0x10a8000010a9d,\n 0x10ac000010ac8,\n 0x10ac900010ae7,\n 0x10b0000010b36,\n 0x10b4000010b56,\n 0x10b6000010b73,\n 0x10b8000010b92,\n 0x10c0000010c49,\n 0x10cc000010cf3,\n 0x10d0000010d28,\n 0x10d3000010d3a,\n 0x10f0000010f1d,\n 0x10f2700010f28,\n 0x10f3000010f51,\n 0x1100000011047,\n 0x1106600011070,\n 0x1107f000110bb,\n 0x110d0000110e9,\n 0x110f0000110fa,\n 0x1110000011135,\n 0x1113600011140,\n 0x1114400011147,\n 0x1115000011174,\n 0x1117600011177,\n 0x11180000111c5,\n 0x111c9000111cd,\n 0x111d0000111db,\n 0x111dc000111dd,\n 0x1120000011212,\n 0x1121300011238,\n 0x1123e0001123f,\n 0x1128000011287,\n 0x1128800011289,\n 0x1128a0001128e,\n 0x1128f0001129e,\n 0x1129f000112a9,\n 0x112b0000112eb,\n 0x112f0000112fa,\n 0x1130000011304,\n 0x113050001130d,\n 0x1130f00011311,\n 0x1131300011329,\n 0x1132a00011331,\n 0x1133200011334,\n 0x113350001133a,\n 0x1133b00011345,\n 0x1134700011349,\n 0x1134b0001134e,\n 0x1135000011351,\n 0x1135700011358,\n 0x1135d00011364,\n 0x113660001136d,\n 0x1137000011375,\n 0x114000001144b,\n 0x114500001145a,\n 0x1145e0001145f,\n 0x11480000114c6,\n 0x114c7000114c8,\n 0x114d0000114da,\n 0x11580000115b6,\n 0x115b8000115c1,\n 0x115d8000115de,\n 0x1160000011641,\n 0x1164400011645,\n 0x116500001165a,\n 0x11680000116b8,\n 0x116c0000116ca,\n 0x117000001171b,\n 0x1171d0001172c,\n 0x117300001173a,\n 0x118000001183b,\n 0x118c0000118ea,\n 0x118ff00011900,\n 0x11a0000011a3f,\n 0x11a4700011a48,\n 0x11a5000011a84,\n 0x11a8600011a9a,\n 0x11a9d00011a9e,\n 0x11ac000011af9,\n 0x11c0000011c09,\n 0x11c0a00011c37,\n 0x11c3800011c41,\n 0x11c5000011c5a,\n 0x11c7200011c90,\n 0x11c9200011ca8,\n 0x11ca900011cb7,\n 0x11d0000011d07,\n 0x11d0800011d0a,\n 0x11d0b00011d37,\n 0x11d3a00011d3b,\n 0x11d3c00011d3e,\n 0x11d3f00011d48,\n 0x11d5000011d5a,\n 0x11d6000011d66,\n 0x11d6700011d69,\n 0x11d6a00011d8f,\n 0x11d9000011d92,\n 0x11d9300011d99,\n 0x11da000011daa,\n 0x11ee000011ef7,\n 0x120000001239a,\n 0x1248000012544,\n 0x130000001342f,\n 0x1440000014647,\n 0x1680000016a39,\n 0x16a4000016a5f,\n 0x16a6000016a6a,\n 0x16ad000016aee,\n 0x16af000016af5,\n 0x16b0000016b37,\n 0x16b4000016b44,\n 0x16b5000016b5a,\n 0x16b6300016b78,\n 0x16b7d00016b90,\n 0x16e6000016e80,\n 0x16f0000016f45,\n 0x16f5000016f7f,\n 0x16f8f00016fa0,\n 0x16fe000016fe2,\n 0x17000000187f2,\n 0x1880000018af3,\n 0x1b0000001b11f,\n 0x1b1700001b2fc,\n 0x1bc000001bc6b,\n 0x1bc700001bc7d,\n 0x1bc800001bc89,\n 0x1bc900001bc9a,\n 0x1bc9d0001bc9f,\n 0x1da000001da37,\n 0x1da3b0001da6d,\n 0x1da750001da76,\n 0x1da840001da85,\n 0x1da9b0001daa0,\n 0x1daa10001dab0,\n 0x1e0000001e007,\n 0x1e0080001e019,\n 0x1e01b0001e022,\n 0x1e0230001e025,\n 0x1e0260001e02b,\n 0x1e8000001e8c5,\n 0x1e8d00001e8d7,\n 0x1e9220001e94b,\n 0x1e9500001e95a,\n 0x200000002a6d7,\n 0x2a7000002b735,\n 0x2b7400002b81e,\n 0x2b8200002cea2,\n 0x2ceb00002ebe1,\n ),\n 'CONTEXTJ': (\n 0x200c0000200e,\n ),\n 'CONTEXTO': (\n 0xb7000000b8,\n 0x37500000376,\n 0x5f3000005f5,\n 0x6600000066a,\n 0x6f0000006fa,\n 0x30fb000030fc,\n ),\n}\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/idna/intranges.py",
"content": "\"\"\"\nGiven a list of integers, made up of (hopefully) a small number of long runs\nof consecutive integers, compute a representation of the form\n((start1, end1), (start2, end2) ...). Then answer the question \"was x present\nin the original list?\" in time O(log(# runs)).\n\"\"\"\n\nimport bisect\n\ndef intranges_from_list(list_):\n \"\"\"Represent a list of integers as a sequence of ranges:\n ((start_0, end_0), (start_1, end_1), ...), such that the original\n integers are exactly those x such that start_i <= x < end_i for some i.\n\n Ranges are encoded as single integers (start << 32 | end), not as tuples.\n \"\"\"\n\n sorted_list = sorted(list_)\n ranges = []\n last_write = -1\n for i in range(len(sorted_list)):\n if i+1 < len(sorted_list):\n if sorted_list[i] == sorted_list[i+1]-1:\n continue\n current_range = sorted_list[last_write+1:i+1]\n ranges.append(_encode_range(current_range[0], current_range[-1] + 1))\n last_write = i\n\n return tuple(ranges)\n\ndef _encode_range(start, end):\n return (start << 32) | end\n\ndef _decode_range(r):\n return (r >> 32), (r & ((1 << 32) - 1))\n\n\ndef intranges_contain(int_, ranges):\n \"\"\"Determine if `int_` falls into one of the ranges in `ranges`.\"\"\"\n tuple_ = _encode_range(int_, 0)\n pos = bisect.bisect_left(ranges, tuple_)\n # we could be immediately ahead of a tuple (start, end)\n # with start < int_ <= end\n if pos > 0:\n left, right = _decode_range(ranges[pos-1])\n if left <= int_ < right:\n return True\n # or we could be immediately behind a tuple (int_, end)\n if pos < len(ranges):\n left, _ = _decode_range(ranges[pos])\n if left == int_:\n return True\n return False\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/idna/package_data.py",
"content": "__version__ = '2.8'\n\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/idna/uts46data.py",
"content": "# This file is automatically generated by tools/idna-data\n# vim: set fileencoding=utf-8 :\n\n\"\"\"IDNA Mapping Table from UTS46.\"\"\"\n\n\n__version__ = \"11.0.0\"\ndef _seg_0():\n return [\n (0x0, '3'),\n (0x1, '3'),\n (0x2, '3'),\n (0x3, '3'),\n (0x4, '3'),\n (0x5, '3'),\n (0x6, '3'),\n (0x7, '3'),\n (0x8, '3'),\n (0x9, '3'),\n (0xA, '3'),\n (0xB, '3'),\n (0xC, '3'),\n (0xD, '3'),\n (0xE, '3'),\n (0xF, '3'),\n (0x10, '3'),\n (0x11, '3'),\n (0x12, '3'),\n (0x13, '3'),\n (0x14, '3'),\n (0x15, '3'),\n (0x16, '3'),\n (0x17, '3'),\n (0x18, '3'),\n (0x19, '3'),\n (0x1A, '3'),\n (0x1B, '3'),\n (0x1C, '3'),\n (0x1D, '3'),\n (0x1E, '3'),\n (0x1F, '3'),\n (0x20, '3'),\n (0x21, '3'),\n (0x22, '3'),\n (0x23, '3'),\n (0x24, '3'),\n (0x25, '3'),\n (0x26, '3'),\n (0x27, '3'),\n (0x28, '3'),\n (0x29, '3'),\n (0x2A, '3'),\n (0x2B, '3'),\n (0x2C, '3'),\n (0x2D, 'V'),\n (0x2E, 'V'),\n (0x2F, '3'),\n (0x30, 'V'),\n (0x31, 'V'),\n (0x32, 'V'),\n (0x33, 'V'),\n (0x34, 'V'),\n (0x35, 'V'),\n (0x36, 'V'),\n (0x37, 'V'),\n (0x38, 'V'),\n (0x39, 'V'),\n (0x3A, '3'),\n (0x3B, '3'),\n (0x3C, '3'),\n (0x3D, '3'),\n (0x3E, '3'),\n (0x3F, '3'),\n (0x40, '3'),\n (0x41, 'M', u'a'),\n (0x42, 'M', u'b'),\n (0x43, 'M', u'c'),\n (0x44, 'M', u'd'),\n (0x45, 'M', u'e'),\n (0x46, 'M', u'f'),\n (0x47, 'M', u'g'),\n (0x48, 'M', u'h'),\n (0x49, 'M', u'i'),\n (0x4A, 'M', u'j'),\n (0x4B, 'M', u'k'),\n (0x4C, 'M', u'l'),\n (0x4D, 'M', u'm'),\n (0x4E, 'M', u'n'),\n (0x4F, 'M', u'o'),\n (0x50, 'M', u'p'),\n (0x51, 'M', u'q'),\n (0x52, 'M', u'r'),\n (0x53, 'M', u's'),\n (0x54, 'M', u't'),\n (0x55, 'M', u'u'),\n (0x56, 'M', u'v'),\n (0x57, 'M', u'w'),\n (0x58, 'M', u'x'),\n (0x59, 'M', u'y'),\n (0x5A, 'M', u'z'),\n (0x5B, '3'),\n (0x5C, '3'),\n (0x5D, '3'),\n (0x5E, '3'),\n (0x5F, '3'),\n (0x60, '3'),\n (0x61, 'V'),\n (0x62, 'V'),\n (0x63, 'V'),\n ]\n\ndef _seg_1():\n return [\n (0x64, 'V'),\n (0x65, 'V'),\n (0x66, 'V'),\n (0x67, 'V'),\n (0x68, 'V'),\n (0x69, 'V'),\n (0x6A, 'V'),\n (0x6B, 'V'),\n (0x6C, 'V'),\n (0x6D, 'V'),\n (0x6E, 'V'),\n (0x6F, 'V'),\n (0x70, 'V'),\n (0x71, 'V'),\n (0x72, 'V'),\n (0x73, 'V'),\n (0x74, 'V'),\n (0x75, 'V'),\n (0x76, 'V'),\n (0x77, 'V'),\n (0x78, 'V'),\n (0x79, 'V'),\n (0x7A, 'V'),\n (0x7B, '3'),\n (0x7C, '3'),\n (0x7D, '3'),\n (0x7E, '3'),\n (0x7F, '3'),\n (0x80, 'X'),\n (0x81, 'X'),\n (0x82, 'X'),\n (0x83, 'X'),\n (0x84, 'X'),\n (0x85, 'X'),\n (0x86, 'X'),\n (0x87, 'X'),\n (0x88, 'X'),\n (0x89, 'X'),\n (0x8A, 'X'),\n (0x8B, 'X'),\n (0x8C, 'X'),\n (0x8D, 'X'),\n (0x8E, 'X'),\n (0x8F, 'X'),\n (0x90, 'X'),\n (0x91, 'X'),\n (0x92, 'X'),\n (0x93, 'X'),\n (0x94, 'X'),\n (0x95, 'X'),\n (0x96, 'X'),\n (0x97, 'X'),\n (0x98, 'X'),\n (0x99, 'X'),\n (0x9A, 'X'),\n (0x9B, 'X'),\n (0x9C, 'X'),\n (0x9D, 'X'),\n (0x9E, 'X'),\n (0x9F, 'X'),\n (0xA0, '3', u' '),\n (0xA1, 'V'),\n (0xA2, 'V'),\n (0xA3, 'V'),\n (0xA4, 'V'),\n (0xA5, 'V'),\n (0xA6, 'V'),\n (0xA7, 'V'),\n (0xA8, '3', u' ̈'),\n (0xA9, 'V'),\n (0xAA, 'M', u'a'),\n (0xAB, 'V'),\n (0xAC, 'V'),\n (0xAD, 'I'),\n (0xAE, 'V'),\n (0xAF, '3', u' ̄'),\n (0xB0, 'V'),\n (0xB1, 'V'),\n (0xB2, 'M', u'2'),\n (0xB3, 'M', u'3'),\n (0xB4, '3', u' ́'),\n (0xB5, 'M', u'μ'),\n (0xB6, 'V'),\n (0xB7, 'V'),\n (0xB8, '3', u' ̧'),\n (0xB9, 'M', u'1'),\n (0xBA, 'M', u'o'),\n (0xBB, 'V'),\n (0xBC, 'M', u'1⁄4'),\n (0xBD, 'M', u'1⁄2'),\n (0xBE, 'M', u'3⁄4'),\n (0xBF, 'V'),\n (0xC0, 'M', u'à'),\n (0xC1, 'M', u'á'),\n (0xC2, 'M', u'â'),\n (0xC3, 'M', u'ã'),\n (0xC4, 'M', u'ä'),\n (0xC5, 'M', u'å'),\n (0xC6, 'M', u'æ'),\n (0xC7, 'M', u'ç'),\n ]\n\ndef _seg_2():\n return [\n (0xC8, 'M', u'è'),\n (0xC9, 'M', u'é'),\n (0xCA, 'M', u'ê'),\n (0xCB, 'M', u'ë'),\n (0xCC, 'M', u'ì'),\n (0xCD, 'M', u'í'),\n (0xCE, 'M', u'î'),\n (0xCF, 'M', u'ï'),\n (0xD0, 'M', u'ð'),\n (0xD1, 'M', u'ñ'),\n (0xD2, 'M', u'ò'),\n (0xD3, 'M', u'ó'),\n (0xD4, 'M', u'ô'),\n (0xD5, 'M', u'õ'),\n (0xD6, 'M', u'ö'),\n (0xD7, 'V'),\n (0xD8, 'M', u'ø'),\n (0xD9, 'M', u'ù'),\n (0xDA, 'M', u'ú'),\n (0xDB, 'M', u'û'),\n (0xDC, 'M', u'ü'),\n (0xDD, 'M', u'ý'),\n (0xDE, 'M', u'þ'),\n (0xDF, 'D', u'ss'),\n (0xE0, 'V'),\n (0xE1, 'V'),\n (0xE2, 'V'),\n (0xE3, 'V'),\n (0xE4, 'V'),\n (0xE5, 'V'),\n (0xE6, 'V'),\n (0xE7, 'V'),\n (0xE8, 'V'),\n (0xE9, 'V'),\n (0xEA, 'V'),\n (0xEB, 'V'),\n (0xEC, 'V'),\n (0xED, 'V'),\n (0xEE, 'V'),\n (0xEF, 'V'),\n (0xF0, 'V'),\n (0xF1, 'V'),\n (0xF2, 'V'),\n (0xF3, 'V'),\n (0xF4, 'V'),\n (0xF5, 'V'),\n (0xF6, 'V'),\n (0xF7, 'V'),\n (0xF8, 'V'),\n (0xF9, 'V'),\n (0xFA, 'V'),\n (0xFB, 'V'),\n (0xFC, 'V'),\n (0xFD, 'V'),\n (0xFE, 'V'),\n (0xFF, 'V'),\n (0x100, 'M', u'ā'),\n (0x101, 'V'),\n (0x102, 'M', u'ă'),\n (0x103, 'V'),\n (0x104, 'M', u'ą'),\n (0x105, 'V'),\n (0x106, 'M', u'ć'),\n (0x107, 'V'),\n (0x108, 'M', u'ĉ'),\n (0x109, 'V'),\n (0x10A, 'M', u'ċ'),\n (0x10B, 'V'),\n (0x10C, 'M', u'č'),\n (0x10D, 'V'),\n (0x10E, 'M', u'ď'),\n (0x10F, 'V'),\n (0x110, 'M', u'đ'),\n (0x111, 'V'),\n (0x112, 'M', u'ē'),\n (0x113, 'V'),\n (0x114, 'M', u'ĕ'),\n (0x115, 'V'),\n (0x116, 'M', u'ė'),\n (0x117, 'V'),\n (0x118, 'M', u'ę'),\n (0x119, 'V'),\n (0x11A, 'M', u'ě'),\n (0x11B, 'V'),\n (0x11C, 'M', u'ĝ'),\n (0x11D, 'V'),\n (0x11E, 'M', u'ğ'),\n (0x11F, 'V'),\n (0x120, 'M', u'ġ'),\n (0x121, 'V'),\n (0x122, 'M', u'ģ'),\n (0x123, 'V'),\n (0x124, 'M', u'ĥ'),\n (0x125, 'V'),\n (0x126, 'M', u'ħ'),\n (0x127, 'V'),\n (0x128, 'M', u'ĩ'),\n (0x129, 'V'),\n (0x12A, 'M', u'ī'),\n (0x12B, 'V'),\n ]\n\ndef _seg_3():\n return [\n (0x12C, 'M', u'ĭ'),\n (0x12D, 'V'),\n (0x12E, 'M', u'į'),\n (0x12F, 'V'),\n (0x130, 'M', u'i̇'),\n (0x131, 'V'),\n (0x132, 'M', u'ij'),\n (0x134, 'M', u'ĵ'),\n (0x135, 'V'),\n (0x136, 'M', u'ķ'),\n (0x137, 'V'),\n (0x139, 'M', u'ĺ'),\n (0x13A, 'V'),\n (0x13B, 'M', u'ļ'),\n (0x13C, 'V'),\n (0x13D, 'M', u'ľ'),\n (0x13E, 'V'),\n (0x13F, 'M', u'l·'),\n (0x141, 'M', u'ł'),\n (0x142, 'V'),\n (0x143, 'M', u'ń'),\n (0x144, 'V'),\n (0x145, 'M', u'ņ'),\n (0x146, 'V'),\n (0x147, 'M', u'ň'),\n (0x148, 'V'),\n (0x149, 'M', u'ʼn'),\n (0x14A, 'M', u'ŋ'),\n (0x14B, 'V'),\n (0x14C, 'M', u'ō'),\n (0x14D, 'V'),\n (0x14E, 'M', u'ŏ'),\n (0x14F, 'V'),\n (0x150, 'M', u'ő'),\n (0x151, 'V'),\n (0x152, 'M', u'œ'),\n (0x153, 'V'),\n (0x154, 'M', u'ŕ'),\n (0x155, 'V'),\n (0x156, 'M', u'ŗ'),\n (0x157, 'V'),\n (0x158, 'M', u'ř'),\n (0x159, 'V'),\n (0x15A, 'M', u'ś'),\n (0x15B, 'V'),\n (0x15C, 'M', u'ŝ'),\n (0x15D, 'V'),\n (0x15E, 'M', u'ş'),\n (0x15F, 'V'),\n (0x160, 'M', u'š'),\n (0x161, 'V'),\n (0x162, 'M', u'ţ'),\n (0x163, 'V'),\n (0x164, 'M', u'ť'),\n (0x165, 'V'),\n (0x166, 'M', u'ŧ'),\n (0x167, 'V'),\n (0x168, 'M', u'ũ'),\n (0x169, 'V'),\n (0x16A, 'M', u'ū'),\n (0x16B, 'V'),\n (0x16C, 'M', u'ŭ'),\n (0x16D, 'V'),\n (0x16E, 'M', u'ů'),\n (0x16F, 'V'),\n (0x170, 'M', u'ű'),\n (0x171, 'V'),\n (0x172, 'M', u'ų'),\n (0x173, 'V'),\n (0x174, 'M', u'ŵ'),\n (0x175, 'V'),\n (0x176, 'M', u'ŷ'),\n (0x177, 'V'),\n (0x178, 'M', u'ÿ'),\n (0x179, 'M', u'ź'),\n (0x17A, 'V'),\n (0x17B, 'M', u'ż'),\n (0x17C, 'V'),\n (0x17D, 'M', u'ž'),\n (0x17E, 'V'),\n (0x17F, 'M', u's'),\n (0x180, 'V'),\n (0x181, 'M', u'ɓ'),\n (0x182, 'M', u'ƃ'),\n (0x183, 'V'),\n (0x184, 'M', u'ƅ'),\n (0x185, 'V'),\n (0x186, 'M', u'ɔ'),\n (0x187, 'M', u'ƈ'),\n (0x188, 'V'),\n (0x189, 'M', u'ɖ'),\n (0x18A, 'M', u'ɗ'),\n (0x18B, 'M', u'ƌ'),\n (0x18C, 'V'),\n (0x18E, 'M', u'ǝ'),\n (0x18F, 'M', u'ə'),\n (0x190, 'M', u'ɛ'),\n (0x191, 'M', u'ƒ'),\n (0x192, 'V'),\n (0x193, 'M', u'ɠ'),\n ]\n\ndef _seg_4():\n return [\n (0x194, 'M', u'ɣ'),\n (0x195, 'V'),\n (0x196, 'M', u'ɩ'),\n (0x197, 'M', u'ɨ'),\n (0x198, 'M', u'ƙ'),\n (0x199, 'V'),\n (0x19C, 'M', u'ɯ'),\n (0x19D, 'M', u'ɲ'),\n (0x19E, 'V'),\n (0x19F, 'M', u'ɵ'),\n (0x1A0, 'M', u'ơ'),\n (0x1A1, 'V'),\n (0x1A2, 'M', u'ƣ'),\n (0x1A3, 'V'),\n (0x1A4, 'M', u'ƥ'),\n (0x1A5, 'V'),\n (0x1A6, 'M', u'ʀ'),\n (0x1A7, 'M', u'ƨ'),\n (0x1A8, 'V'),\n (0x1A9, 'M', u'ʃ'),\n (0x1AA, 'V'),\n (0x1AC, 'M', u'ƭ'),\n (0x1AD, 'V'),\n (0x1AE, 'M', u'ʈ'),\n (0x1AF, 'M', u'ư'),\n (0x1B0, 'V'),\n (0x1B1, 'M', u'ʊ'),\n (0x1B2, 'M', u'ʋ'),\n (0x1B3, 'M', u'ƴ'),\n (0x1B4, 'V'),\n (0x1B5, 'M', u'ƶ'),\n (0x1B6, 'V'),\n (0x1B7, 'M', u'ʒ'),\n (0x1B8, 'M', u'ƹ'),\n (0x1B9, 'V'),\n (0x1BC, 'M', u'ƽ'),\n (0x1BD, 'V'),\n (0x1C4, 'M', u'dž'),\n (0x1C7, 'M', u'lj'),\n (0x1CA, 'M', u'nj'),\n (0x1CD, 'M', u'ǎ'),\n (0x1CE, 'V'),\n (0x1CF, 'M', u'ǐ'),\n (0x1D0, 'V'),\n (0x1D1, 'M', u'ǒ'),\n (0x1D2, 'V'),\n (0x1D3, 'M', u'ǔ'),\n (0x1D4, 'V'),\n (0x1D5, 'M', u'ǖ'),\n (0x1D6, 'V'),\n (0x1D7, 'M', u'ǘ'),\n (0x1D8, 'V'),\n (0x1D9, 'M', u'ǚ'),\n (0x1DA, 'V'),\n (0x1DB, 'M', u'ǜ'),\n (0x1DC, 'V'),\n (0x1DE, 'M', u'ǟ'),\n (0x1DF, 'V'),\n (0x1E0, 'M', u'ǡ'),\n (0x1E1, 'V'),\n (0x1E2, 'M', u'ǣ'),\n (0x1E3, 'V'),\n (0x1E4, 'M', u'ǥ'),\n (0x1E5, 'V'),\n (0x1E6, 'M', u'ǧ'),\n (0x1E7, 'V'),\n (0x1E8, 'M', u'ǩ'),\n (0x1E9, 'V'),\n (0x1EA, 'M', u'ǫ'),\n (0x1EB, 'V'),\n (0x1EC, 'M', u'ǭ'),\n (0x1ED, 'V'),\n (0x1EE, 'M', u'ǯ'),\n (0x1EF, 'V'),\n (0x1F1, 'M', u'dz'),\n (0x1F4, 'M', u'ǵ'),\n (0x1F5, 'V'),\n (0x1F6, 'M', u'ƕ'),\n (0x1F7, 'M', u'ƿ'),\n (0x1F8, 'M', u'ǹ'),\n (0x1F9, 'V'),\n (0x1FA, 'M', u'ǻ'),\n (0x1FB, 'V'),\n (0x1FC, 'M', u'ǽ'),\n (0x1FD, 'V'),\n (0x1FE, 'M', u'ǿ'),\n (0x1FF, 'V'),\n (0x200, 'M', u'ȁ'),\n (0x201, 'V'),\n (0x202, 'M', u'ȃ'),\n (0x203, 'V'),\n (0x204, 'M', u'ȅ'),\n (0x205, 'V'),\n (0x206, 'M', u'ȇ'),\n (0x207, 'V'),\n (0x208, 'M', u'ȉ'),\n (0x209, 'V'),\n (0x20A, 'M', u'ȋ'),\n (0x20B, 'V'),\n (0x20C, 'M', u'ȍ'),\n ]\n\ndef _seg_5():\n return [\n (0x20D, 'V'),\n (0x20E, 'M', u'ȏ'),\n (0x20F, 'V'),\n (0x210, 'M', u'ȑ'),\n (0x211, 'V'),\n (0x212, 'M', u'ȓ'),\n (0x213, 'V'),\n (0x214, 'M', u'ȕ'),\n (0x215, 'V'),\n (0x216, 'M', u'ȗ'),\n (0x217, 'V'),\n (0x218, 'M', u'ș'),\n (0x219, 'V'),\n (0x21A, 'M', u'ț'),\n (0x21B, 'V'),\n (0x21C, 'M', u'ȝ'),\n (0x21D, 'V'),\n (0x21E, 'M', u'ȟ'),\n (0x21F, 'V'),\n (0x220, 'M', u'ƞ'),\n (0x221, 'V'),\n (0x222, 'M', u'ȣ'),\n (0x223, 'V'),\n (0x224, 'M', u'ȥ'),\n (0x225, 'V'),\n (0x226, 'M', u'ȧ'),\n (0x227, 'V'),\n (0x228, 'M', u'ȩ'),\n (0x229, 'V'),\n (0x22A, 'M', u'ȫ'),\n (0x22B, 'V'),\n (0x22C, 'M', u'ȭ'),\n (0x22D, 'V'),\n (0x22E, 'M', u'ȯ'),\n (0x22F, 'V'),\n (0x230, 'M', u'ȱ'),\n (0x231, 'V'),\n (0x232, 'M', u'ȳ'),\n (0x233, 'V'),\n (0x23A, 'M', u'ⱥ'),\n (0x23B, 'M', u'ȼ'),\n (0x23C, 'V'),\n (0x23D, 'M', u'ƚ'),\n (0x23E, 'M', u'ⱦ'),\n (0x23F, 'V'),\n (0x241, 'M', u'ɂ'),\n (0x242, 'V'),\n (0x243, 'M', u'ƀ'),\n (0x244, 'M', u'ʉ'),\n (0x245, 'M', u'ʌ'),\n (0x246, 'M', u'ɇ'),\n (0x247, 'V'),\n (0x248, 'M', u'ɉ'),\n (0x249, 'V'),\n (0x24A, 'M', u'ɋ'),\n (0x24B, 'V'),\n (0x24C, 'M', u'ɍ'),\n (0x24D, 'V'),\n (0x24E, 'M', u'ɏ'),\n (0x24F, 'V'),\n (0x2B0, 'M', u'h'),\n (0x2B1, 'M', u'ɦ'),\n (0x2B2, 'M', u'j'),\n (0x2B3, 'M', u'r'),\n (0x2B4, 'M', u'ɹ'),\n (0x2B5, 'M', u'ɻ'),\n (0x2B6, 'M', u'ʁ'),\n (0x2B7, 'M', u'w'),\n (0x2B8, 'M', u'y'),\n (0x2B9, 'V'),\n (0x2D8, '3', u' ̆'),\n (0x2D9, '3', u' ̇'),\n (0x2DA, '3', u' ̊'),\n (0x2DB, '3', u' ̨'),\n (0x2DC, '3', u' ̃'),\n (0x2DD, '3', u' ̋'),\n (0x2DE, 'V'),\n (0x2E0, 'M', u'ɣ'),\n (0x2E1, 'M', u'l'),\n (0x2E2, 'M', u's'),\n (0x2E3, 'M', u'x'),\n (0x2E4, 'M', u'ʕ'),\n (0x2E5, 'V'),\n (0x340, 'M', u'̀'),\n (0x341, 'M', u'́'),\n (0x342, 'V'),\n (0x343, 'M', u'̓'),\n (0x344, 'M', u'̈́'),\n (0x345, 'M', u'ι'),\n (0x346, 'V'),\n (0x34F, 'I'),\n (0x350, 'V'),\n (0x370, 'M', u'ͱ'),\n (0x371, 'V'),\n (0x372, 'M', u'ͳ'),\n (0x373, 'V'),\n (0x374, 'M', u'ʹ'),\n (0x375, 'V'),\n (0x376, 'M', u'ͷ'),\n (0x377, 'V'),\n ]\n\ndef _seg_6():\n return [\n (0x378, 'X'),\n (0x37A, '3', u' ι'),\n (0x37B, 'V'),\n (0x37E, '3', u';'),\n (0x37F, 'M', u'ϳ'),\n (0x380, 'X'),\n (0x384, '3', u' ́'),\n (0x385, '3', u' ̈́'),\n (0x386, 'M', u'ά'),\n (0x387, 'M', u'·'),\n (0x388, 'M', u'έ'),\n (0x389, 'M', u'ή'),\n (0x38A, 'M', u'ί'),\n (0x38B, 'X'),\n (0x38C, 'M', u'ό'),\n (0x38D, 'X'),\n (0x38E, 'M', u'ύ'),\n (0x38F, 'M', u'ώ'),\n (0x390, 'V'),\n (0x391, 'M', u'α'),\n (0x392, 'M', u'β'),\n (0x393, 'M', u'γ'),\n (0x394, 'M', u'δ'),\n (0x395, 'M', u'ε'),\n (0x396, 'M', u'ζ'),\n (0x397, 'M', u'η'),\n (0x398, 'M', u'θ'),\n (0x399, 'M', u'ι'),\n (0x39A, 'M', u'κ'),\n (0x39B, 'M', u'λ'),\n (0x39C, 'M', u'μ'),\n (0x39D, 'M', u'ν'),\n (0x39E, 'M', u'ξ'),\n (0x39F, 'M', u'ο'),\n (0x3A0, 'M', u'π'),\n (0x3A1, 'M', u'ρ'),\n (0x3A2, 'X'),\n (0x3A3, 'M', u'σ'),\n (0x3A4, 'M', u'τ'),\n (0x3A5, 'M', u'υ'),\n (0x3A6, 'M', u'φ'),\n (0x3A7, 'M', u'χ'),\n (0x3A8, 'M', u'ψ'),\n (0x3A9, 'M', u'ω'),\n (0x3AA, 'M', u'ϊ'),\n (0x3AB, 'M', u'ϋ'),\n (0x3AC, 'V'),\n (0x3C2, 'D', u'σ'),\n (0x3C3, 'V'),\n (0x3CF, 'M', u'ϗ'),\n (0x3D0, 'M', u'β'),\n (0x3D1, 'M', u'θ'),\n (0x3D2, 'M', u'υ'),\n (0x3D3, 'M', u'ύ'),\n (0x3D4, 'M', u'ϋ'),\n (0x3D5, 'M', u'φ'),\n (0x3D6, 'M', u'π'),\n (0x3D7, 'V'),\n (0x3D8, 'M', u'ϙ'),\n (0x3D9, 'V'),\n (0x3DA, 'M', u'ϛ'),\n (0x3DB, 'V'),\n (0x3DC, 'M', u'ϝ'),\n (0x3DD, 'V'),\n (0x3DE, 'M', u'ϟ'),\n (0x3DF, 'V'),\n (0x3E0, 'M', u'ϡ'),\n (0x3E1, 'V'),\n (0x3E2, 'M', u'ϣ'),\n (0x3E3, 'V'),\n (0x3E4, 'M', u'ϥ'),\n (0x3E5, 'V'),\n (0x3E6, 'M', u'ϧ'),\n (0x3E7, 'V'),\n (0x3E8, 'M', u'ϩ'),\n (0x3E9, 'V'),\n (0x3EA, 'M', u'ϫ'),\n (0x3EB, 'V'),\n (0x3EC, 'M', u'ϭ'),\n (0x3ED, 'V'),\n (0x3EE, 'M', u'ϯ'),\n (0x3EF, 'V'),\n (0x3F0, 'M', u'κ'),\n (0x3F1, 'M', u'ρ'),\n (0x3F2, 'M', u'σ'),\n (0x3F3, 'V'),\n (0x3F4, 'M', u'θ'),\n (0x3F5, 'M', u'ε'),\n (0x3F6, 'V'),\n (0x3F7, 'M', u'ϸ'),\n (0x3F8, 'V'),\n (0x3F9, 'M', u'σ'),\n (0x3FA, 'M', u'ϻ'),\n (0x3FB, 'V'),\n (0x3FD, 'M', u'ͻ'),\n (0x3FE, 'M', u'ͼ'),\n (0x3FF, 'M', u'ͽ'),\n (0x400, 'M', u'ѐ'),\n (0x401, 'M', u'ё'),\n (0x402, 'M', u'ђ'),\n ]\n\ndef _seg_7():\n return [\n (0x403, 'M', u'ѓ'),\n (0x404, 'M', u'є'),\n (0x405, 'M', u'ѕ'),\n (0x406, 'M', u'і'),\n (0x407, 'M', u'ї'),\n (0x408, 'M', u'ј'),\n (0x409, 'M', u'љ'),\n (0x40A, 'M', u'њ'),\n (0x40B, 'M', u'ћ'),\n (0x40C, 'M', u'ќ'),\n (0x40D, 'M', u'ѝ'),\n (0x40E, 'M', u'ў'),\n (0x40F, 'M', u'џ'),\n (0x410, 'M', u'а'),\n (0x411, 'M', u'б'),\n (0x412, 'M', u'в'),\n (0x413, 'M', u'г'),\n (0x414, 'M', u'д'),\n (0x415, 'M', u'е'),\n (0x416, 'M', u'ж'),\n (0x417, 'M', u'з'),\n (0x418, 'M', u'и'),\n (0x419, 'M', u'й'),\n (0x41A, 'M', u'к'),\n (0x41B, 'M', u'л'),\n (0x41C, 'M', u'м'),\n (0x41D, 'M', u'н'),\n (0x41E, 'M', u'о'),\n (0x41F, 'M', u'п'),\n (0x420, 'M', u'р'),\n (0x421, 'M', u'с'),\n (0x422, 'M', u'т'),\n (0x423, 'M', u'у'),\n (0x424, 'M', u'ф'),\n (0x425, 'M', u'х'),\n (0x426, 'M', u'ц'),\n (0x427, 'M', u'ч'),\n (0x428, 'M', u'ш'),\n (0x429, 'M', u'щ'),\n (0x42A, 'M', u'ъ'),\n (0x42B, 'M', u'ы'),\n (0x42C, 'M', u'ь'),\n (0x42D, 'M', u'э'),\n (0x42E, 'M', u'ю'),\n (0x42F, 'M', u'я'),\n (0x430, 'V'),\n (0x460, 'M', u'ѡ'),\n (0x461, 'V'),\n (0x462, 'M', u'ѣ'),\n (0x463, 'V'),\n (0x464, 'M', u'ѥ'),\n (0x465, 'V'),\n (0x466, 'M', u'ѧ'),\n (0x467, 'V'),\n (0x468, 'M', u'ѩ'),\n (0x469, 'V'),\n (0x46A, 'M', u'ѫ'),\n (0x46B, 'V'),\n (0x46C, 'M', u'ѭ'),\n (0x46D, 'V'),\n (0x46E, 'M', u'ѯ'),\n (0x46F, 'V'),\n (0x470, 'M', u'ѱ'),\n (0x471, 'V'),\n (0x472, 'M', u'ѳ'),\n (0x473, 'V'),\n (0x474, 'M', u'ѵ'),\n (0x475, 'V'),\n (0x476, 'M', u'ѷ'),\n (0x477, 'V'),\n (0x478, 'M', u'ѹ'),\n (0x479, 'V'),\n (0x47A, 'M', u'ѻ'),\n (0x47B, 'V'),\n (0x47C, 'M', u'ѽ'),\n (0x47D, 'V'),\n (0x47E, 'M', u'ѿ'),\n (0x47F, 'V'),\n (0x480, 'M', u'ҁ'),\n (0x481, 'V'),\n (0x48A, 'M', u'ҋ'),\n (0x48B, 'V'),\n (0x48C, 'M', u'ҍ'),\n (0x48D, 'V'),\n (0x48E, 'M', u'ҏ'),\n (0x48F, 'V'),\n (0x490, 'M', u'ґ'),\n (0x491, 'V'),\n (0x492, 'M', u'ғ'),\n (0x493, 'V'),\n (0x494, 'M', u'ҕ'),\n (0x495, 'V'),\n (0x496, 'M', u'җ'),\n (0x497, 'V'),\n (0x498, 'M', u'ҙ'),\n (0x499, 'V'),\n (0x49A, 'M', u'қ'),\n (0x49B, 'V'),\n (0x49C, 'M', u'ҝ'),\n (0x49D, 'V'),\n ]\n\ndef _seg_8():\n return [\n (0x49E, 'M', u'ҟ'),\n (0x49F, 'V'),\n (0x4A0, 'M', u'ҡ'),\n (0x4A1, 'V'),\n (0x4A2, 'M', u'ң'),\n (0x4A3, 'V'),\n (0x4A4, 'M', u'ҥ'),\n (0x4A5, 'V'),\n (0x4A6, 'M', u'ҧ'),\n (0x4A7, 'V'),\n (0x4A8, 'M', u'ҩ'),\n (0x4A9, 'V'),\n (0x4AA, 'M', u'ҫ'),\n (0x4AB, 'V'),\n (0x4AC, 'M', u'ҭ'),\n (0x4AD, 'V'),\n (0x4AE, 'M', u'ү'),\n (0x4AF, 'V'),\n (0x4B0, 'M', u'ұ'),\n (0x4B1, 'V'),\n (0x4B2, 'M', u'ҳ'),\n (0x4B3, 'V'),\n (0x4B4, 'M', u'ҵ'),\n (0x4B5, 'V'),\n (0x4B6, 'M', u'ҷ'),\n (0x4B7, 'V'),\n (0x4B8, 'M', u'ҹ'),\n (0x4B9, 'V'),\n (0x4BA, 'M', u'һ'),\n (0x4BB, 'V'),\n (0x4BC, 'M', u'ҽ'),\n (0x4BD, 'V'),\n (0x4BE, 'M', u'ҿ'),\n (0x4BF, 'V'),\n (0x4C0, 'X'),\n (0x4C1, 'M', u'ӂ'),\n (0x4C2, 'V'),\n (0x4C3, 'M', u'ӄ'),\n (0x4C4, 'V'),\n (0x4C5, 'M', u'ӆ'),\n (0x4C6, 'V'),\n (0x4C7, 'M', u'ӈ'),\n (0x4C8, 'V'),\n (0x4C9, 'M', u'ӊ'),\n (0x4CA, 'V'),\n (0x4CB, 'M', u'ӌ'),\n (0x4CC, 'V'),\n (0x4CD, 'M', u'ӎ'),\n (0x4CE, 'V'),\n (0x4D0, 'M', u'ӑ'),\n (0x4D1, 'V'),\n (0x4D2, 'M', u'ӓ'),\n (0x4D3, 'V'),\n (0x4D4, 'M', u'ӕ'),\n (0x4D5, 'V'),\n (0x4D6, 'M', u'ӗ'),\n (0x4D7, 'V'),\n (0x4D8, 'M', u'ә'),\n (0x4D9, 'V'),\n (0x4DA, 'M', u'ӛ'),\n (0x4DB, 'V'),\n (0x4DC, 'M', u'ӝ'),\n (0x4DD, 'V'),\n (0x4DE, 'M', u'ӟ'),\n (0x4DF, 'V'),\n (0x4E0, 'M', u'ӡ'),\n (0x4E1, 'V'),\n (0x4E2, 'M', u'ӣ'),\n (0x4E3, 'V'),\n (0x4E4, 'M', u'ӥ'),\n (0x4E5, 'V'),\n (0x4E6, 'M', u'ӧ'),\n (0x4E7, 'V'),\n (0x4E8, 'M', u'ө'),\n (0x4E9, 'V'),\n (0x4EA, 'M', u'ӫ'),\n (0x4EB, 'V'),\n (0x4EC, 'M', u'ӭ'),\n (0x4ED, 'V'),\n (0x4EE, 'M', u'ӯ'),\n (0x4EF, 'V'),\n (0x4F0, 'M', u'ӱ'),\n (0x4F1, 'V'),\n (0x4F2, 'M', u'ӳ'),\n (0x4F3, 'V'),\n (0x4F4, 'M', u'ӵ'),\n (0x4F5, 'V'),\n (0x4F6, 'M', u'ӷ'),\n (0x4F7, 'V'),\n (0x4F8, 'M', u'ӹ'),\n (0x4F9, 'V'),\n (0x4FA, 'M', u'ӻ'),\n (0x4FB, 'V'),\n (0x4FC, 'M', u'ӽ'),\n (0x4FD, 'V'),\n (0x4FE, 'M', u'ӿ'),\n (0x4FF, 'V'),\n (0x500, 'M', u'ԁ'),\n (0x501, 'V'),\n (0x502, 'M', u'ԃ'),\n ]\n\ndef _seg_9():\n return [\n (0x503, 'V'),\n (0x504, 'M', u'ԅ'),\n (0x505, 'V'),\n (0x506, 'M', u'ԇ'),\n (0x507, 'V'),\n (0x508, 'M', u'ԉ'),\n (0x509, 'V'),\n (0x50A, 'M', u'ԋ'),\n (0x50B, 'V'),\n (0x50C, 'M', u'ԍ'),\n (0x50D, 'V'),\n (0x50E, 'M', u'ԏ'),\n (0x50F, 'V'),\n (0x510, 'M', u'ԑ'),\n (0x511, 'V'),\n (0x512, 'M', u'ԓ'),\n (0x513, 'V'),\n (0x514, 'M', u'ԕ'),\n (0x515, 'V'),\n (0x516, 'M', u'ԗ'),\n (0x517, 'V'),\n (0x518, 'M', u'ԙ'),\n (0x519, 'V'),\n (0x51A, 'M', u'ԛ'),\n (0x51B, 'V'),\n (0x51C, 'M', u'ԝ'),\n (0x51D, 'V'),\n (0x51E, 'M', u'ԟ'),\n (0x51F, 'V'),\n (0x520, 'M', u'ԡ'),\n (0x521, 'V'),\n (0x522, 'M', u'ԣ'),\n (0x523, 'V'),\n (0x524, 'M', u'ԥ'),\n (0x525, 'V'),\n (0x526, 'M', u'ԧ'),\n (0x527, 'V'),\n (0x528, 'M', u'ԩ'),\n (0x529, 'V'),\n (0x52A, 'M', u'ԫ'),\n (0x52B, 'V'),\n (0x52C, 'M', u'ԭ'),\n (0x52D, 'V'),\n (0x52E, 'M', u'ԯ'),\n (0x52F, 'V'),\n (0x530, 'X'),\n (0x531, 'M', u'ա'),\n (0x532, 'M', u'բ'),\n (0x533, 'M', u'գ'),\n (0x534, 'M', u'դ'),\n (0x535, 'M', u'ե'),\n (0x536, 'M', u'զ'),\n (0x537, 'M', u'է'),\n (0x538, 'M', u'ը'),\n (0x539, 'M', u'թ'),\n (0x53A, 'M', u'ժ'),\n (0x53B, 'M', u'ի'),\n (0x53C, 'M', u'լ'),\n (0x53D, 'M', u'խ'),\n (0x53E, 'M', u'ծ'),\n (0x53F, 'M', u'կ'),\n (0x540, 'M', u'հ'),\n (0x541, 'M', u'ձ'),\n (0x542, 'M', u'ղ'),\n (0x543, 'M', u'ճ'),\n (0x544, 'M', u'մ'),\n (0x545, 'M', u'յ'),\n (0x546, 'M', u'ն'),\n (0x547, 'M', u'շ'),\n (0x548, 'M', u'ո'),\n (0x549, 'M', u'չ'),\n (0x54A, 'M', u'պ'),\n (0x54B, 'M', u'ջ'),\n (0x54C, 'M', u'ռ'),\n (0x54D, 'M', u'ս'),\n (0x54E, 'M', u'վ'),\n (0x54F, 'M', u'տ'),\n (0x550, 'M', u'ր'),\n (0x551, 'M', u'ց'),\n (0x552, 'M', u'ւ'),\n (0x553, 'M', u'փ'),\n (0x554, 'M', u'ք'),\n (0x555, 'M', u'օ'),\n (0x556, 'M', u'ֆ'),\n (0x557, 'X'),\n (0x559, 'V'),\n (0x587, 'M', u'եւ'),\n (0x588, 'V'),\n (0x58B, 'X'),\n (0x58D, 'V'),\n (0x590, 'X'),\n (0x591, 'V'),\n (0x5C8, 'X'),\n (0x5D0, 'V'),\n (0x5EB, 'X'),\n (0x5EF, 'V'),\n (0x5F5, 'X'),\n (0x606, 'V'),\n (0x61C, 'X'),\n (0x61E, 'V'),\n ]\n\ndef _seg_10():\n return [\n (0x675, 'M', u'اٴ'),\n (0x676, 'M', u'وٴ'),\n (0x677, 'M', u'ۇٴ'),\n (0x678, 'M', u'يٴ'),\n (0x679, 'V'),\n (0x6DD, 'X'),\n (0x6DE, 'V'),\n (0x70E, 'X'),\n (0x710, 'V'),\n (0x74B, 'X'),\n (0x74D, 'V'),\n (0x7B2, 'X'),\n (0x7C0, 'V'),\n (0x7FB, 'X'),\n (0x7FD, 'V'),\n (0x82E, 'X'),\n (0x830, 'V'),\n (0x83F, 'X'),\n (0x840, 'V'),\n (0x85C, 'X'),\n (0x85E, 'V'),\n (0x85F, 'X'),\n (0x860, 'V'),\n (0x86B, 'X'),\n (0x8A0, 'V'),\n (0x8B5, 'X'),\n (0x8B6, 'V'),\n (0x8BE, 'X'),\n (0x8D3, 'V'),\n (0x8E2, 'X'),\n (0x8E3, 'V'),\n (0x958, 'M', u'क़'),\n (0x959, 'M', u'ख़'),\n (0x95A, 'M', u'ग़'),\n (0x95B, 'M', u'ज़'),\n (0x95C, 'M', u'ड़'),\n (0x95D, 'M', u'ढ़'),\n (0x95E, 'M', u'फ़'),\n (0x95F, 'M', u'य़'),\n (0x960, 'V'),\n (0x984, 'X'),\n (0x985, 'V'),\n (0x98D, 'X'),\n (0x98F, 'V'),\n (0x991, 'X'),\n (0x993, 'V'),\n (0x9A9, 'X'),\n (0x9AA, 'V'),\n (0x9B1, 'X'),\n (0x9B2, 'V'),\n (0x9B3, 'X'),\n (0x9B6, 'V'),\n (0x9BA, 'X'),\n (0x9BC, 'V'),\n (0x9C5, 'X'),\n (0x9C7, 'V'),\n (0x9C9, 'X'),\n (0x9CB, 'V'),\n (0x9CF, 'X'),\n (0x9D7, 'V'),\n (0x9D8, 'X'),\n (0x9DC, 'M', u'ড়'),\n (0x9DD, 'M', u'ঢ়'),\n (0x9DE, 'X'),\n (0x9DF, 'M', u'য়'),\n (0x9E0, 'V'),\n (0x9E4, 'X'),\n (0x9E6, 'V'),\n (0x9FF, 'X'),\n (0xA01, 'V'),\n (0xA04, 'X'),\n (0xA05, 'V'),\n (0xA0B, 'X'),\n (0xA0F, 'V'),\n (0xA11, 'X'),\n (0xA13, 'V'),\n (0xA29, 'X'),\n (0xA2A, 'V'),\n (0xA31, 'X'),\n (0xA32, 'V'),\n (0xA33, 'M', u'ਲ਼'),\n (0xA34, 'X'),\n (0xA35, 'V'),\n (0xA36, 'M', u'ਸ਼'),\n (0xA37, 'X'),\n (0xA38, 'V'),\n (0xA3A, 'X'),\n (0xA3C, 'V'),\n (0xA3D, 'X'),\n (0xA3E, 'V'),\n (0xA43, 'X'),\n (0xA47, 'V'),\n (0xA49, 'X'),\n (0xA4B, 'V'),\n (0xA4E, 'X'),\n (0xA51, 'V'),\n (0xA52, 'X'),\n (0xA59, 'M', u'ਖ਼'),\n (0xA5A, 'M', u'ਗ਼'),\n (0xA5B, 'M', u'ਜ਼'),\n ]\n\ndef _seg_11():\n return [\n (0xA5C, 'V'),\n (0xA5D, 'X'),\n (0xA5E, 'M', u'ਫ਼'),\n (0xA5F, 'X'),\n (0xA66, 'V'),\n (0xA77, 'X'),\n (0xA81, 'V'),\n (0xA84, 'X'),\n (0xA85, 'V'),\n (0xA8E, 'X'),\n (0xA8F, 'V'),\n (0xA92, 'X'),\n (0xA93, 'V'),\n (0xAA9, 'X'),\n (0xAAA, 'V'),\n (0xAB1, 'X'),\n (0xAB2, 'V'),\n (0xAB4, 'X'),\n (0xAB5, 'V'),\n (0xABA, 'X'),\n (0xABC, 'V'),\n (0xAC6, 'X'),\n (0xAC7, 'V'),\n (0xACA, 'X'),\n (0xACB, 'V'),\n (0xACE, 'X'),\n (0xAD0, 'V'),\n (0xAD1, 'X'),\n (0xAE0, 'V'),\n (0xAE4, 'X'),\n (0xAE6, 'V'),\n (0xAF2, 'X'),\n (0xAF9, 'V'),\n (0xB00, 'X'),\n (0xB01, 'V'),\n (0xB04, 'X'),\n (0xB05, 'V'),\n (0xB0D, 'X'),\n (0xB0F, 'V'),\n (0xB11, 'X'),\n (0xB13, 'V'),\n (0xB29, 'X'),\n (0xB2A, 'V'),\n (0xB31, 'X'),\n (0xB32, 'V'),\n (0xB34, 'X'),\n (0xB35, 'V'),\n (0xB3A, 'X'),\n (0xB3C, 'V'),\n (0xB45, 'X'),\n (0xB47, 'V'),\n (0xB49, 'X'),\n (0xB4B, 'V'),\n (0xB4E, 'X'),\n (0xB56, 'V'),\n (0xB58, 'X'),\n (0xB5C, 'M', u'ଡ଼'),\n (0xB5D, 'M', u'ଢ଼'),\n (0xB5E, 'X'),\n (0xB5F, 'V'),\n (0xB64, 'X'),\n (0xB66, 'V'),\n (0xB78, 'X'),\n (0xB82, 'V'),\n (0xB84, 'X'),\n (0xB85, 'V'),\n (0xB8B, 'X'),\n (0xB8E, 'V'),\n (0xB91, 'X'),\n (0xB92, 'V'),\n (0xB96, 'X'),\n (0xB99, 'V'),\n (0xB9B, 'X'),\n (0xB9C, 'V'),\n (0xB9D, 'X'),\n (0xB9E, 'V'),\n (0xBA0, 'X'),\n (0xBA3, 'V'),\n (0xBA5, 'X'),\n (0xBA8, 'V'),\n (0xBAB, 'X'),\n (0xBAE, 'V'),\n (0xBBA, 'X'),\n (0xBBE, 'V'),\n (0xBC3, 'X'),\n (0xBC6, 'V'),\n (0xBC9, 'X'),\n (0xBCA, 'V'),\n (0xBCE, 'X'),\n (0xBD0, 'V'),\n (0xBD1, 'X'),\n (0xBD7, 'V'),\n (0xBD8, 'X'),\n (0xBE6, 'V'),\n (0xBFB, 'X'),\n (0xC00, 'V'),\n (0xC0D, 'X'),\n (0xC0E, 'V'),\n (0xC11, 'X'),\n (0xC12, 'V'),\n ]\n\ndef _seg_12():\n return [\n (0xC29, 'X'),\n (0xC2A, 'V'),\n (0xC3A, 'X'),\n (0xC3D, 'V'),\n (0xC45, 'X'),\n (0xC46, 'V'),\n (0xC49, 'X'),\n (0xC4A, 'V'),\n (0xC4E, 'X'),\n (0xC55, 'V'),\n (0xC57, 'X'),\n (0xC58, 'V'),\n (0xC5B, 'X'),\n (0xC60, 'V'),\n (0xC64, 'X'),\n (0xC66, 'V'),\n (0xC70, 'X'),\n (0xC78, 'V'),\n (0xC8D, 'X'),\n (0xC8E, 'V'),\n (0xC91, 'X'),\n (0xC92, 'V'),\n (0xCA9, 'X'),\n (0xCAA, 'V'),\n (0xCB4, 'X'),\n (0xCB5, 'V'),\n (0xCBA, 'X'),\n (0xCBC, 'V'),\n (0xCC5, 'X'),\n (0xCC6, 'V'),\n (0xCC9, 'X'),\n (0xCCA, 'V'),\n (0xCCE, 'X'),\n (0xCD5, 'V'),\n (0xCD7, 'X'),\n (0xCDE, 'V'),\n (0xCDF, 'X'),\n (0xCE0, 'V'),\n (0xCE4, 'X'),\n (0xCE6, 'V'),\n (0xCF0, 'X'),\n (0xCF1, 'V'),\n (0xCF3, 'X'),\n (0xD00, 'V'),\n (0xD04, 'X'),\n (0xD05, 'V'),\n (0xD0D, 'X'),\n (0xD0E, 'V'),\n (0xD11, 'X'),\n (0xD12, 'V'),\n (0xD45, 'X'),\n (0xD46, 'V'),\n (0xD49, 'X'),\n (0xD4A, 'V'),\n (0xD50, 'X'),\n (0xD54, 'V'),\n (0xD64, 'X'),\n (0xD66, 'V'),\n (0xD80, 'X'),\n (0xD82, 'V'),\n (0xD84, 'X'),\n (0xD85, 'V'),\n (0xD97, 'X'),\n (0xD9A, 'V'),\n (0xDB2, 'X'),\n (0xDB3, 'V'),\n (0xDBC, 'X'),\n (0xDBD, 'V'),\n (0xDBE, 'X'),\n (0xDC0, 'V'),\n (0xDC7, 'X'),\n (0xDCA, 'V'),\n (0xDCB, 'X'),\n (0xDCF, 'V'),\n (0xDD5, 'X'),\n (0xDD6, 'V'),\n (0xDD7, 'X'),\n (0xDD8, 'V'),\n (0xDE0, 'X'),\n (0xDE6, 'V'),\n (0xDF0, 'X'),\n (0xDF2, 'V'),\n (0xDF5, 'X'),\n (0xE01, 'V'),\n (0xE33, 'M', u'ํา'),\n (0xE34, 'V'),\n (0xE3B, 'X'),\n (0xE3F, 'V'),\n (0xE5C, 'X'),\n (0xE81, 'V'),\n (0xE83, 'X'),\n (0xE84, 'V'),\n (0xE85, 'X'),\n (0xE87, 'V'),\n (0xE89, 'X'),\n (0xE8A, 'V'),\n (0xE8B, 'X'),\n (0xE8D, 'V'),\n (0xE8E, 'X'),\n (0xE94, 'V'),\n ]\n\ndef _seg_13():\n return [\n (0xE98, 'X'),\n (0xE99, 'V'),\n (0xEA0, 'X'),\n (0xEA1, 'V'),\n (0xEA4, 'X'),\n (0xEA5, 'V'),\n (0xEA6, 'X'),\n (0xEA7, 'V'),\n (0xEA8, 'X'),\n (0xEAA, 'V'),\n (0xEAC, 'X'),\n (0xEAD, 'V'),\n (0xEB3, 'M', u'ໍາ'),\n (0xEB4, 'V'),\n (0xEBA, 'X'),\n (0xEBB, 'V'),\n (0xEBE, 'X'),\n (0xEC0, 'V'),\n (0xEC5, 'X'),\n (0xEC6, 'V'),\n (0xEC7, 'X'),\n (0xEC8, 'V'),\n (0xECE, 'X'),\n (0xED0, 'V'),\n (0xEDA, 'X'),\n (0xEDC, 'M', u'ຫນ'),\n (0xEDD, 'M', u'ຫມ'),\n (0xEDE, 'V'),\n (0xEE0, 'X'),\n (0xF00, 'V'),\n (0xF0C, 'M', u'་'),\n (0xF0D, 'V'),\n (0xF43, 'M', u'གྷ'),\n (0xF44, 'V'),\n (0xF48, 'X'),\n (0xF49, 'V'),\n (0xF4D, 'M', u'ཌྷ'),\n (0xF4E, 'V'),\n (0xF52, 'M', u'དྷ'),\n (0xF53, 'V'),\n (0xF57, 'M', u'བྷ'),\n (0xF58, 'V'),\n (0xF5C, 'M', u'ཛྷ'),\n (0xF5D, 'V'),\n (0xF69, 'M', u'ཀྵ'),\n (0xF6A, 'V'),\n (0xF6D, 'X'),\n (0xF71, 'V'),\n (0xF73, 'M', u'ཱི'),\n (0xF74, 'V'),\n (0xF75, 'M', u'ཱུ'),\n (0xF76, 'M', u'ྲྀ'),\n (0xF77, 'M', u'ྲཱྀ'),\n (0xF78, 'M', u'ླྀ'),\n (0xF79, 'M', u'ླཱྀ'),\n (0xF7A, 'V'),\n (0xF81, 'M', u'ཱྀ'),\n (0xF82, 'V'),\n (0xF93, 'M', u'ྒྷ'),\n (0xF94, 'V'),\n (0xF98, 'X'),\n (0xF99, 'V'),\n (0xF9D, 'M', u'ྜྷ'),\n (0xF9E, 'V'),\n (0xFA2, 'M', u'ྡྷ'),\n (0xFA3, 'V'),\n (0xFA7, 'M', u'ྦྷ'),\n (0xFA8, 'V'),\n (0xFAC, 'M', u'ྫྷ'),\n (0xFAD, 'V'),\n (0xFB9, 'M', u'ྐྵ'),\n (0xFBA, 'V'),\n (0xFBD, 'X'),\n (0xFBE, 'V'),\n (0xFCD, 'X'),\n (0xFCE, 'V'),\n (0xFDB, 'X'),\n (0x1000, 'V'),\n (0x10A0, 'X'),\n (0x10C7, 'M', u'ⴧ'),\n (0x10C8, 'X'),\n (0x10CD, 'M', u'ⴭ'),\n (0x10CE, 'X'),\n (0x10D0, 'V'),\n (0x10FC, 'M', u'ნ'),\n (0x10FD, 'V'),\n (0x115F, 'X'),\n (0x1161, 'V'),\n (0x1249, 'X'),\n (0x124A, 'V'),\n (0x124E, 'X'),\n (0x1250, 'V'),\n (0x1257, 'X'),\n (0x1258, 'V'),\n (0x1259, 'X'),\n (0x125A, 'V'),\n (0x125E, 'X'),\n (0x1260, 'V'),\n (0x1289, 'X'),\n (0x128A, 'V'),\n ]\n\ndef _seg_14():\n return [\n (0x128E, 'X'),\n (0x1290, 'V'),\n (0x12B1, 'X'),\n (0x12B2, 'V'),\n (0x12B6, 'X'),\n (0x12B8, 'V'),\n (0x12BF, 'X'),\n (0x12C0, 'V'),\n (0x12C1, 'X'),\n (0x12C2, 'V'),\n (0x12C6, 'X'),\n (0x12C8, 'V'),\n (0x12D7, 'X'),\n (0x12D8, 'V'),\n (0x1311, 'X'),\n (0x1312, 'V'),\n (0x1316, 'X'),\n (0x1318, 'V'),\n (0x135B, 'X'),\n (0x135D, 'V'),\n (0x137D, 'X'),\n (0x1380, 'V'),\n (0x139A, 'X'),\n (0x13A0, 'V'),\n (0x13F6, 'X'),\n (0x13F8, 'M', u'Ᏸ'),\n (0x13F9, 'M', u'Ᏹ'),\n (0x13FA, 'M', u'Ᏺ'),\n (0x13FB, 'M', u'Ᏻ'),\n (0x13FC, 'M', u'Ᏼ'),\n (0x13FD, 'M', u'Ᏽ'),\n (0x13FE, 'X'),\n (0x1400, 'V'),\n (0x1680, 'X'),\n (0x1681, 'V'),\n (0x169D, 'X'),\n (0x16A0, 'V'),\n (0x16F9, 'X'),\n (0x1700, 'V'),\n (0x170D, 'X'),\n (0x170E, 'V'),\n (0x1715, 'X'),\n (0x1720, 'V'),\n (0x1737, 'X'),\n (0x1740, 'V'),\n (0x1754, 'X'),\n (0x1760, 'V'),\n (0x176D, 'X'),\n (0x176E, 'V'),\n (0x1771, 'X'),\n (0x1772, 'V'),\n (0x1774, 'X'),\n (0x1780, 'V'),\n (0x17B4, 'X'),\n (0x17B6, 'V'),\n (0x17DE, 'X'),\n (0x17E0, 'V'),\n (0x17EA, 'X'),\n (0x17F0, 'V'),\n (0x17FA, 'X'),\n (0x1800, 'V'),\n (0x1806, 'X'),\n (0x1807, 'V'),\n (0x180B, 'I'),\n (0x180E, 'X'),\n (0x1810, 'V'),\n (0x181A, 'X'),\n (0x1820, 'V'),\n (0x1879, 'X'),\n (0x1880, 'V'),\n (0x18AB, 'X'),\n (0x18B0, 'V'),\n (0x18F6, 'X'),\n (0x1900, 'V'),\n (0x191F, 'X'),\n (0x1920, 'V'),\n (0x192C, 'X'),\n (0x1930, 'V'),\n (0x193C, 'X'),\n (0x1940, 'V'),\n (0x1941, 'X'),\n (0x1944, 'V'),\n (0x196E, 'X'),\n (0x1970, 'V'),\n (0x1975, 'X'),\n (0x1980, 'V'),\n (0x19AC, 'X'),\n (0x19B0, 'V'),\n (0x19CA, 'X'),\n (0x19D0, 'V'),\n (0x19DB, 'X'),\n (0x19DE, 'V'),\n (0x1A1C, 'X'),\n (0x1A1E, 'V'),\n (0x1A5F, 'X'),\n (0x1A60, 'V'),\n (0x1A7D, 'X'),\n (0x1A7F, 'V'),\n (0x1A8A, 'X'),\n (0x1A90, 'V'),\n ]\n\ndef _seg_15():\n return [\n (0x1A9A, 'X'),\n (0x1AA0, 'V'),\n (0x1AAE, 'X'),\n (0x1AB0, 'V'),\n (0x1ABF, 'X'),\n (0x1B00, 'V'),\n (0x1B4C, 'X'),\n (0x1B50, 'V'),\n (0x1B7D, 'X'),\n (0x1B80, 'V'),\n (0x1BF4, 'X'),\n (0x1BFC, 'V'),\n (0x1C38, 'X'),\n (0x1C3B, 'V'),\n (0x1C4A, 'X'),\n (0x1C4D, 'V'),\n (0x1C80, 'M', u'в'),\n (0x1C81, 'M', u'д'),\n (0x1C82, 'M', u'о'),\n (0x1C83, 'M', u'с'),\n (0x1C84, 'M', u'т'),\n (0x1C86, 'M', u'ъ'),\n (0x1C87, 'M', u'ѣ'),\n (0x1C88, 'M', u'ꙋ'),\n (0x1C89, 'X'),\n (0x1CC0, 'V'),\n (0x1CC8, 'X'),\n (0x1CD0, 'V'),\n (0x1CFA, 'X'),\n (0x1D00, 'V'),\n (0x1D2C, 'M', u'a'),\n (0x1D2D, 'M', u'æ'),\n (0x1D2E, 'M', u'b'),\n (0x1D2F, 'V'),\n (0x1D30, 'M', u'd'),\n (0x1D31, 'M', u'e'),\n (0x1D32, 'M', u'ǝ'),\n (0x1D33, 'M', u'g'),\n (0x1D34, 'M', u'h'),\n (0x1D35, 'M', u'i'),\n (0x1D36, 'M', u'j'),\n (0x1D37, 'M', u'k'),\n (0x1D38, 'M', u'l'),\n (0x1D39, 'M', u'm'),\n (0x1D3A, 'M', u'n'),\n (0x1D3B, 'V'),\n (0x1D3C, 'M', u'o'),\n (0x1D3D, 'M', u'ȣ'),\n (0x1D3E, 'M', u'p'),\n (0x1D3F, 'M', u'r'),\n (0x1D40, 'M', u't'),\n (0x1D41, 'M', u'u'),\n (0x1D42, 'M', u'w'),\n (0x1D43, 'M', u'a'),\n (0x1D44, 'M', u'ɐ'),\n (0x1D45, 'M', u'ɑ'),\n (0x1D46, 'M', u'ᴂ'),\n (0x1D47, 'M', u'b'),\n (0x1D48, 'M', u'd'),\n (0x1D49, 'M', u'e'),\n (0x1D4A, 'M', u'ə'),\n (0x1D4B, 'M', u'ɛ'),\n (0x1D4C, 'M', u'ɜ'),\n (0x1D4D, 'M', u'g'),\n (0x1D4E, 'V'),\n (0x1D4F, 'M', u'k'),\n (0x1D50, 'M', u'm'),\n (0x1D51, 'M', u'ŋ'),\n (0x1D52, 'M', u'o'),\n (0x1D53, 'M', u'ɔ'),\n (0x1D54, 'M', u'ᴖ'),\n (0x1D55, 'M', u'ᴗ'),\n (0x1D56, 'M', u'p'),\n (0x1D57, 'M', u't'),\n (0x1D58, 'M', u'u'),\n (0x1D59, 'M', u'ᴝ'),\n (0x1D5A, 'M', u'ɯ'),\n (0x1D5B, 'M', u'v'),\n (0x1D5C, 'M', u'ᴥ'),\n (0x1D5D, 'M', u'β'),\n (0x1D5E, 'M', u'γ'),\n (0x1D5F, 'M', u'δ'),\n (0x1D60, 'M', u'φ'),\n (0x1D61, 'M', u'χ'),\n (0x1D62, 'M', u'i'),\n (0x1D63, 'M', u'r'),\n (0x1D64, 'M', u'u'),\n (0x1D65, 'M', u'v'),\n (0x1D66, 'M', u'β'),\n (0x1D67, 'M', u'γ'),\n (0x1D68, 'M', u'ρ'),\n (0x1D69, 'M', u'φ'),\n (0x1D6A, 'M', u'χ'),\n (0x1D6B, 'V'),\n (0x1D78, 'M', u'н'),\n (0x1D79, 'V'),\n (0x1D9B, 'M', u'ɒ'),\n (0x1D9C, 'M', u'c'),\n (0x1D9D, 'M', u'ɕ'),\n (0x1D9E, 'M', u'ð'),\n ]\n\ndef _seg_16():\n return [\n (0x1D9F, 'M', u'ɜ'),\n (0x1DA0, 'M', u'f'),\n (0x1DA1, 'M', u'ɟ'),\n (0x1DA2, 'M', u'ɡ'),\n (0x1DA3, 'M', u'ɥ'),\n (0x1DA4, 'M', u'ɨ'),\n (0x1DA5, 'M', u'ɩ'),\n (0x1DA6, 'M', u'ɪ'),\n (0x1DA7, 'M', u'ᵻ'),\n (0x1DA8, 'M', u'ʝ'),\n (0x1DA9, 'M', u'ɭ'),\n (0x1DAA, 'M', u'ᶅ'),\n (0x1DAB, 'M', u'ʟ'),\n (0x1DAC, 'M', u'ɱ'),\n (0x1DAD, 'M', u'ɰ'),\n (0x1DAE, 'M', u'ɲ'),\n (0x1DAF, 'M', u'ɳ'),\n (0x1DB0, 'M', u'ɴ'),\n (0x1DB1, 'M', u'ɵ'),\n (0x1DB2, 'M', u'ɸ'),\n (0x1DB3, 'M', u'ʂ'),\n (0x1DB4, 'M', u'ʃ'),\n (0x1DB5, 'M', u'ƫ'),\n (0x1DB6, 'M', u'ʉ'),\n (0x1DB7, 'M', u'ʊ'),\n (0x1DB8, 'M', u'ᴜ'),\n (0x1DB9, 'M', u'ʋ'),\n (0x1DBA, 'M', u'ʌ'),\n (0x1DBB, 'M', u'z'),\n (0x1DBC, 'M', u'ʐ'),\n (0x1DBD, 'M', u'ʑ'),\n (0x1DBE, 'M', u'ʒ'),\n (0x1DBF, 'M', u'θ'),\n (0x1DC0, 'V'),\n (0x1DFA, 'X'),\n (0x1DFB, 'V'),\n (0x1E00, 'M', u'ḁ'),\n (0x1E01, 'V'),\n (0x1E02, 'M', u'ḃ'),\n (0x1E03, 'V'),\n (0x1E04, 'M', u'ḅ'),\n (0x1E05, 'V'),\n (0x1E06, 'M', u'ḇ'),\n (0x1E07, 'V'),\n (0x1E08, 'M', u'ḉ'),\n (0x1E09, 'V'),\n (0x1E0A, 'M', u'ḋ'),\n (0x1E0B, 'V'),\n (0x1E0C, 'M', u'ḍ'),\n (0x1E0D, 'V'),\n (0x1E0E, 'M', u'ḏ'),\n (0x1E0F, 'V'),\n (0x1E10, 'M', u'ḑ'),\n (0x1E11, 'V'),\n (0x1E12, 'M', u'ḓ'),\n (0x1E13, 'V'),\n (0x1E14, 'M', u'ḕ'),\n (0x1E15, 'V'),\n (0x1E16, 'M', u'ḗ'),\n (0x1E17, 'V'),\n (0x1E18, 'M', u'ḙ'),\n (0x1E19, 'V'),\n (0x1E1A, 'M', u'ḛ'),\n (0x1E1B, 'V'),\n (0x1E1C, 'M', u'ḝ'),\n (0x1E1D, 'V'),\n (0x1E1E, 'M', u'ḟ'),\n (0x1E1F, 'V'),\n (0x1E20, 'M', u'ḡ'),\n (0x1E21, 'V'),\n (0x1E22, 'M', u'ḣ'),\n (0x1E23, 'V'),\n (0x1E24, 'M', u'ḥ'),\n (0x1E25, 'V'),\n (0x1E26, 'M', u'ḧ'),\n (0x1E27, 'V'),\n (0x1E28, 'M', u'ḩ'),\n (0x1E29, 'V'),\n (0x1E2A, 'M', u'ḫ'),\n (0x1E2B, 'V'),\n (0x1E2C, 'M', u'ḭ'),\n (0x1E2D, 'V'),\n (0x1E2E, 'M', u'ḯ'),\n (0x1E2F, 'V'),\n (0x1E30, 'M', u'ḱ'),\n (0x1E31, 'V'),\n (0x1E32, 'M', u'ḳ'),\n (0x1E33, 'V'),\n (0x1E34, 'M', u'ḵ'),\n (0x1E35, 'V'),\n (0x1E36, 'M', u'ḷ'),\n (0x1E37, 'V'),\n (0x1E38, 'M', u'ḹ'),\n (0x1E39, 'V'),\n (0x1E3A, 'M', u'ḻ'),\n (0x1E3B, 'V'),\n (0x1E3C, 'M', u'ḽ'),\n (0x1E3D, 'V'),\n (0x1E3E, 'M', u'ḿ'),\n (0x1E3F, 'V'),\n ]\n\ndef _seg_17():\n return [\n (0x1E40, 'M', u'ṁ'),\n (0x1E41, 'V'),\n (0x1E42, 'M', u'ṃ'),\n (0x1E43, 'V'),\n (0x1E44, 'M', u'ṅ'),\n (0x1E45, 'V'),\n (0x1E46, 'M', u'ṇ'),\n (0x1E47, 'V'),\n (0x1E48, 'M', u'ṉ'),\n (0x1E49, 'V'),\n (0x1E4A, 'M', u'ṋ'),\n (0x1E4B, 'V'),\n (0x1E4C, 'M', u'ṍ'),\n (0x1E4D, 'V'),\n (0x1E4E, 'M', u'ṏ'),\n (0x1E4F, 'V'),\n (0x1E50, 'M', u'ṑ'),\n (0x1E51, 'V'),\n (0x1E52, 'M', u'ṓ'),\n (0x1E53, 'V'),\n (0x1E54, 'M', u'ṕ'),\n (0x1E55, 'V'),\n (0x1E56, 'M', u'ṗ'),\n (0x1E57, 'V'),\n (0x1E58, 'M', u'ṙ'),\n (0x1E59, 'V'),\n (0x1E5A, 'M', u'ṛ'),\n (0x1E5B, 'V'),\n (0x1E5C, 'M', u'ṝ'),\n (0x1E5D, 'V'),\n (0x1E5E, 'M', u'ṟ'),\n (0x1E5F, 'V'),\n (0x1E60, 'M', u'ṡ'),\n (0x1E61, 'V'),\n (0x1E62, 'M', u'ṣ'),\n (0x1E63, 'V'),\n (0x1E64, 'M', u'ṥ'),\n (0x1E65, 'V'),\n (0x1E66, 'M', u'ṧ'),\n (0x1E67, 'V'),\n (0x1E68, 'M', u'ṩ'),\n (0x1E69, 'V'),\n (0x1E6A, 'M', u'ṫ'),\n (0x1E6B, 'V'),\n (0x1E6C, 'M', u'ṭ'),\n (0x1E6D, 'V'),\n (0x1E6E, 'M', u'ṯ'),\n (0x1E6F, 'V'),\n (0x1E70, 'M', u'ṱ'),\n (0x1E71, 'V'),\n (0x1E72, 'M', u'ṳ'),\n (0x1E73, 'V'),\n (0x1E74, 'M', u'ṵ'),\n (0x1E75, 'V'),\n (0x1E76, 'M', u'ṷ'),\n (0x1E77, 'V'),\n (0x1E78, 'M', u'ṹ'),\n (0x1E79, 'V'),\n (0x1E7A, 'M', u'ṻ'),\n (0x1E7B, 'V'),\n (0x1E7C, 'M', u'ṽ'),\n (0x1E7D, 'V'),\n (0x1E7E, 'M', u'ṿ'),\n (0x1E7F, 'V'),\n (0x1E80, 'M', u'ẁ'),\n (0x1E81, 'V'),\n (0x1E82, 'M', u'ẃ'),\n (0x1E83, 'V'),\n (0x1E84, 'M', u'ẅ'),\n (0x1E85, 'V'),\n (0x1E86, 'M', u'ẇ'),\n (0x1E87, 'V'),\n (0x1E88, 'M', u'ẉ'),\n (0x1E89, 'V'),\n (0x1E8A, 'M', u'ẋ'),\n (0x1E8B, 'V'),\n (0x1E8C, 'M', u'ẍ'),\n (0x1E8D, 'V'),\n (0x1E8E, 'M', u'ẏ'),\n (0x1E8F, 'V'),\n (0x1E90, 'M', u'ẑ'),\n (0x1E91, 'V'),\n (0x1E92, 'M', u'ẓ'),\n (0x1E93, 'V'),\n (0x1E94, 'M', u'ẕ'),\n (0x1E95, 'V'),\n (0x1E9A, 'M', u'aʾ'),\n (0x1E9B, 'M', u'ṡ'),\n (0x1E9C, 'V'),\n (0x1E9E, 'M', u'ss'),\n (0x1E9F, 'V'),\n (0x1EA0, 'M', u'ạ'),\n (0x1EA1, 'V'),\n (0x1EA2, 'M', u'ả'),\n (0x1EA3, 'V'),\n (0x1EA4, 'M', u'ấ'),\n (0x1EA5, 'V'),\n (0x1EA6, 'M', u'ầ'),\n (0x1EA7, 'V'),\n (0x1EA8, 'M', u'ẩ'),\n ]\n\ndef _seg_18():\n return [\n (0x1EA9, 'V'),\n (0x1EAA, 'M', u'ẫ'),\n (0x1EAB, 'V'),\n (0x1EAC, 'M', u'ậ'),\n (0x1EAD, 'V'),\n (0x1EAE, 'M', u'ắ'),\n (0x1EAF, 'V'),\n (0x1EB0, 'M', u'ằ'),\n (0x1EB1, 'V'),\n (0x1EB2, 'M', u'ẳ'),\n (0x1EB3, 'V'),\n (0x1EB4, 'M', u'ẵ'),\n (0x1EB5, 'V'),\n (0x1EB6, 'M', u'ặ'),\n (0x1EB7, 'V'),\n (0x1EB8, 'M', u'ẹ'),\n (0x1EB9, 'V'),\n (0x1EBA, 'M', u'ẻ'),\n (0x1EBB, 'V'),\n (0x1EBC, 'M', u'ẽ'),\n (0x1EBD, 'V'),\n (0x1EBE, 'M', u'ế'),\n (0x1EBF, 'V'),\n (0x1EC0, 'M', u'ề'),\n (0x1EC1, 'V'),\n (0x1EC2, 'M', u'ể'),\n (0x1EC3, 'V'),\n (0x1EC4, 'M', u'ễ'),\n (0x1EC5, 'V'),\n (0x1EC6, 'M', u'ệ'),\n (0x1EC7, 'V'),\n (0x1EC8, 'M', u'ỉ'),\n (0x1EC9, 'V'),\n (0x1ECA, 'M', u'ị'),\n (0x1ECB, 'V'),\n (0x1ECC, 'M', u'ọ'),\n (0x1ECD, 'V'),\n (0x1ECE, 'M', u'ỏ'),\n (0x1ECF, 'V'),\n (0x1ED0, 'M', u'ố'),\n (0x1ED1, 'V'),\n (0x1ED2, 'M', u'ồ'),\n (0x1ED3, 'V'),\n (0x1ED4, 'M', u'ổ'),\n (0x1ED5, 'V'),\n (0x1ED6, 'M', u'ỗ'),\n (0x1ED7, 'V'),\n (0x1ED8, 'M', u'ộ'),\n (0x1ED9, 'V'),\n (0x1EDA, 'M', u'ớ'),\n (0x1EDB, 'V'),\n (0x1EDC, 'M', u'ờ'),\n (0x1EDD, 'V'),\n (0x1EDE, 'M', u'ở'),\n (0x1EDF, 'V'),\n (0x1EE0, 'M', u'ỡ'),\n (0x1EE1, 'V'),\n (0x1EE2, 'M', u'ợ'),\n (0x1EE3, 'V'),\n (0x1EE4, 'M', u'ụ'),\n (0x1EE5, 'V'),\n (0x1EE6, 'M', u'ủ'),\n (0x1EE7, 'V'),\n (0x1EE8, 'M', u'ứ'),\n (0x1EE9, 'V'),\n (0x1EEA, 'M', u'ừ'),\n (0x1EEB, 'V'),\n (0x1EEC, 'M', u'ử'),\n (0x1EED, 'V'),\n (0x1EEE, 'M', u'ữ'),\n (0x1EEF, 'V'),\n (0x1EF0, 'M', u'ự'),\n (0x1EF1, 'V'),\n (0x1EF2, 'M', u'ỳ'),\n (0x1EF3, 'V'),\n (0x1EF4, 'M', u'ỵ'),\n (0x1EF5, 'V'),\n (0x1EF6, 'M', u'ỷ'),\n (0x1EF7, 'V'),\n (0x1EF8, 'M', u'ỹ'),\n (0x1EF9, 'V'),\n (0x1EFA, 'M', u'ỻ'),\n (0x1EFB, 'V'),\n (0x1EFC, 'M', u'ỽ'),\n (0x1EFD, 'V'),\n (0x1EFE, 'M', u'ỿ'),\n (0x1EFF, 'V'),\n (0x1F08, 'M', u'ἀ'),\n (0x1F09, 'M', u'ἁ'),\n (0x1F0A, 'M', u'ἂ'),\n (0x1F0B, 'M', u'ἃ'),\n (0x1F0C, 'M', u'ἄ'),\n (0x1F0D, 'M', u'ἅ'),\n (0x1F0E, 'M', u'ἆ'),\n (0x1F0F, 'M', u'ἇ'),\n (0x1F10, 'V'),\n (0x1F16, 'X'),\n (0x1F18, 'M', u'ἐ'),\n (0x1F19, 'M', u'ἑ'),\n (0x1F1A, 'M', u'ἒ'),\n ]\n\ndef _seg_19():\n return [\n (0x1F1B, 'M', u'ἓ'),\n (0x1F1C, 'M', u'ἔ'),\n (0x1F1D, 'M', u'ἕ'),\n (0x1F1E, 'X'),\n (0x1F20, 'V'),\n (0x1F28, 'M', u'ἠ'),\n (0x1F29, 'M', u'ἡ'),\n (0x1F2A, 'M', u'ἢ'),\n (0x1F2B, 'M', u'ἣ'),\n (0x1F2C, 'M', u'ἤ'),\n (0x1F2D, 'M', u'ἥ'),\n (0x1F2E, 'M', u'ἦ'),\n (0x1F2F, 'M', u'ἧ'),\n (0x1F30, 'V'),\n (0x1F38, 'M', u'ἰ'),\n (0x1F39, 'M', u'ἱ'),\n (0x1F3A, 'M', u'ἲ'),\n (0x1F3B, 'M', u'ἳ'),\n (0x1F3C, 'M', u'ἴ'),\n (0x1F3D, 'M', u'ἵ'),\n (0x1F3E, 'M', u'ἶ'),\n (0x1F3F, 'M', u'ἷ'),\n (0x1F40, 'V'),\n (0x1F46, 'X'),\n (0x1F48, 'M', u'ὀ'),\n (0x1F49, 'M', u'ὁ'),\n (0x1F4A, 'M', u'ὂ'),\n (0x1F4B, 'M', u'ὃ'),\n (0x1F4C, 'M', u'ὄ'),\n (0x1F4D, 'M', u'ὅ'),\n (0x1F4E, 'X'),\n (0x1F50, 'V'),\n (0x1F58, 'X'),\n (0x1F59, 'M', u'ὑ'),\n (0x1F5A, 'X'),\n (0x1F5B, 'M', u'ὓ'),\n (0x1F5C, 'X'),\n (0x1F5D, 'M', u'ὕ'),\n (0x1F5E, 'X'),\n (0x1F5F, 'M', u'ὗ'),\n (0x1F60, 'V'),\n (0x1F68, 'M', u'ὠ'),\n (0x1F69, 'M', u'ὡ'),\n (0x1F6A, 'M', u'ὢ'),\n (0x1F6B, 'M', u'ὣ'),\n (0x1F6C, 'M', u'ὤ'),\n (0x1F6D, 'M', u'ὥ'),\n (0x1F6E, 'M', u'ὦ'),\n (0x1F6F, 'M', u'ὧ'),\n (0x1F70, 'V'),\n (0x1F71, 'M', u'ά'),\n (0x1F72, 'V'),\n (0x1F73, 'M', u'έ'),\n (0x1F74, 'V'),\n (0x1F75, 'M', u'ή'),\n (0x1F76, 'V'),\n (0x1F77, 'M', u'ί'),\n (0x1F78, 'V'),\n (0x1F79, 'M', u'ό'),\n (0x1F7A, 'V'),\n (0x1F7B, 'M', u'ύ'),\n (0x1F7C, 'V'),\n (0x1F7D, 'M', u'ώ'),\n (0x1F7E, 'X'),\n (0x1F80, 'M', u'ἀι'),\n (0x1F81, 'M', u'ἁι'),\n (0x1F82, 'M', u'ἂι'),\n (0x1F83, 'M', u'ἃι'),\n (0x1F84, 'M', u'ἄι'),\n (0x1F85, 'M', u'ἅι'),\n (0x1F86, 'M', u'ἆι'),\n (0x1F87, 'M', u'ἇι'),\n (0x1F88, 'M', u'ἀι'),\n (0x1F89, 'M', u'ἁι'),\n (0x1F8A, 'M', u'ἂι'),\n (0x1F8B, 'M', u'ἃι'),\n (0x1F8C, 'M', u'ἄι'),\n (0x1F8D, 'M', u'ἅι'),\n (0x1F8E, 'M', u'ἆι'),\n (0x1F8F, 'M', u'ἇι'),\n (0x1F90, 'M', u'ἠι'),\n (0x1F91, 'M', u'ἡι'),\n (0x1F92, 'M', u'ἢι'),\n (0x1F93, 'M', u'ἣι'),\n (0x1F94, 'M', u'ἤι'),\n (0x1F95, 'M', u'ἥι'),\n (0x1F96, 'M', u'ἦι'),\n (0x1F97, 'M', u'ἧι'),\n (0x1F98, 'M', u'ἠι'),\n (0x1F99, 'M', u'ἡι'),\n (0x1F9A, 'M', u'ἢι'),\n (0x1F9B, 'M', u'ἣι'),\n (0x1F9C, 'M', u'ἤι'),\n (0x1F9D, 'M', u'ἥι'),\n (0x1F9E, 'M', u'ἦι'),\n (0x1F9F, 'M', u'ἧι'),\n (0x1FA0, 'M', u'ὠι'),\n (0x1FA1, 'M', u'ὡι'),\n (0x1FA2, 'M', u'ὢι'),\n (0x1FA3, 'M', u'ὣι'),\n ]\n\ndef _seg_20():\n return [\n (0x1FA4, 'M', u'ὤι'),\n (0x1FA5, 'M', u'ὥι'),\n (0x1FA6, 'M', u'ὦι'),\n (0x1FA7, 'M', u'ὧι'),\n (0x1FA8, 'M', u'ὠι'),\n (0x1FA9, 'M', u'ὡι'),\n (0x1FAA, 'M', u'ὢι'),\n (0x1FAB, 'M', u'ὣι'),\n (0x1FAC, 'M', u'ὤι'),\n (0x1FAD, 'M', u'ὥι'),\n (0x1FAE, 'M', u'ὦι'),\n (0x1FAF, 'M', u'ὧι'),\n (0x1FB0, 'V'),\n (0x1FB2, 'M', u'ὰι'),\n (0x1FB3, 'M', u'αι'),\n (0x1FB4, 'M', u'άι'),\n (0x1FB5, 'X'),\n (0x1FB6, 'V'),\n (0x1FB7, 'M', u'ᾶι'),\n (0x1FB8, 'M', u'ᾰ'),\n (0x1FB9, 'M', u'ᾱ'),\n (0x1FBA, 'M', u'ὰ'),\n (0x1FBB, 'M', u'ά'),\n (0x1FBC, 'M', u'αι'),\n (0x1FBD, '3', u' ̓'),\n (0x1FBE, 'M', u'ι'),\n (0x1FBF, '3', u' ̓'),\n (0x1FC0, '3', u' ͂'),\n (0x1FC1, '3', u' ̈͂'),\n (0x1FC2, 'M', u'ὴι'),\n (0x1FC3, 'M', u'ηι'),\n (0x1FC4, 'M', u'ήι'),\n (0x1FC5, 'X'),\n (0x1FC6, 'V'),\n (0x1FC7, 'M', u'ῆι'),\n (0x1FC8, 'M', u'ὲ'),\n (0x1FC9, 'M', u'έ'),\n (0x1FCA, 'M', u'ὴ'),\n (0x1FCB, 'M', u'ή'),\n (0x1FCC, 'M', u'ηι'),\n (0x1FCD, '3', u' ̓̀'),\n (0x1FCE, '3', u' ̓́'),\n (0x1FCF, '3', u' ̓͂'),\n (0x1FD0, 'V'),\n (0x1FD3, 'M', u'ΐ'),\n (0x1FD4, 'X'),\n (0x1FD6, 'V'),\n (0x1FD8, 'M', u'ῐ'),\n (0x1FD9, 'M', u'ῑ'),\n (0x1FDA, 'M', u'ὶ'),\n (0x1FDB, 'M', u'ί'),\n (0x1FDC, 'X'),\n (0x1FDD, '3', u' ̔̀'),\n (0x1FDE, '3', u' ̔́'),\n (0x1FDF, '3', u' ̔͂'),\n (0x1FE0, 'V'),\n (0x1FE3, 'M', u'ΰ'),\n (0x1FE4, 'V'),\n (0x1FE8, 'M', u'ῠ'),\n (0x1FE9, 'M', u'ῡ'),\n (0x1FEA, 'M', u'ὺ'),\n (0x1FEB, 'M', u'ύ'),\n (0x1FEC, 'M', u'ῥ'),\n (0x1FED, '3', u' ̈̀'),\n (0x1FEE, '3', u' ̈́'),\n (0x1FEF, '3', u'`'),\n (0x1FF0, 'X'),\n (0x1FF2, 'M', u'ὼι'),\n (0x1FF3, 'M', u'ωι'),\n (0x1FF4, 'M', u'ώι'),\n (0x1FF5, 'X'),\n (0x1FF6, 'V'),\n (0x1FF7, 'M', u'ῶι'),\n (0x1FF8, 'M', u'ὸ'),\n (0x1FF9, 'M', u'ό'),\n (0x1FFA, 'M', u'ὼ'),\n (0x1FFB, 'M', u'ώ'),\n (0x1FFC, 'M', u'ωι'),\n (0x1FFD, '3', u' ́'),\n (0x1FFE, '3', u' ̔'),\n (0x1FFF, 'X'),\n (0x2000, '3', u' '),\n (0x200B, 'I'),\n (0x200C, 'D', u''),\n (0x200E, 'X'),\n (0x2010, 'V'),\n (0x2011, 'M', u'‐'),\n (0x2012, 'V'),\n (0x2017, '3', u' ̳'),\n (0x2018, 'V'),\n (0x2024, 'X'),\n (0x2027, 'V'),\n (0x2028, 'X'),\n (0x202F, '3', u' '),\n (0x2030, 'V'),\n (0x2033, 'M', u'′′'),\n (0x2034, 'M', u'′′′'),\n (0x2035, 'V'),\n (0x2036, 'M', u'‵‵'),\n (0x2037, 'M', u'‵‵‵'),\n ]\n\ndef _seg_21():\n return [\n (0x2038, 'V'),\n (0x203C, '3', u'!!'),\n (0x203D, 'V'),\n (0x203E, '3', u' ̅'),\n (0x203F, 'V'),\n (0x2047, '3', u'??'),\n (0x2048, '3', u'?!'),\n (0x2049, '3', u'!?'),\n (0x204A, 'V'),\n (0x2057, 'M', u'′′′′'),\n (0x2058, 'V'),\n (0x205F, '3', u' '),\n (0x2060, 'I'),\n (0x2061, 'X'),\n (0x2064, 'I'),\n (0x2065, 'X'),\n (0x2070, 'M', u'0'),\n (0x2071, 'M', u'i'),\n (0x2072, 'X'),\n (0x2074, 'M', u'4'),\n (0x2075, 'M', u'5'),\n (0x2076, 'M', u'6'),\n (0x2077, 'M', u'7'),\n (0x2078, 'M', u'8'),\n (0x2079, 'M', u'9'),\n (0x207A, '3', u'+'),\n (0x207B, 'M', u'−'),\n (0x207C, '3', u'='),\n (0x207D, '3', u'('),\n (0x207E, '3', u')'),\n (0x207F, 'M', u'n'),\n (0x2080, 'M', u'0'),\n (0x2081, 'M', u'1'),\n (0x2082, 'M', u'2'),\n (0x2083, 'M', u'3'),\n (0x2084, 'M', u'4'),\n (0x2085, 'M', u'5'),\n (0x2086, 'M', u'6'),\n (0x2087, 'M', u'7'),\n (0x2088, 'M', u'8'),\n (0x2089, 'M', u'9'),\n (0x208A, '3', u'+'),\n (0x208B, 'M', u'−'),\n (0x208C, '3', u'='),\n (0x208D, '3', u'('),\n (0x208E, '3', u')'),\n (0x208F, 'X'),\n (0x2090, 'M', u'a'),\n (0x2091, 'M', u'e'),\n (0x2092, 'M', u'o'),\n (0x2093, 'M', u'x'),\n (0x2094, 'M', u'ə'),\n (0x2095, 'M', u'h'),\n (0x2096, 'M', u'k'),\n (0x2097, 'M', u'l'),\n (0x2098, 'M', u'm'),\n (0x2099, 'M', u'n'),\n (0x209A, 'M', u'p'),\n (0x209B, 'M', u's'),\n (0x209C, 'M', u't'),\n (0x209D, 'X'),\n (0x20A0, 'V'),\n (0x20A8, 'M', u'rs'),\n (0x20A9, 'V'),\n (0x20C0, 'X'),\n (0x20D0, 'V'),\n (0x20F1, 'X'),\n (0x2100, '3', u'a/c'),\n (0x2101, '3', u'a/s'),\n (0x2102, 'M', u'c'),\n (0x2103, 'M', u'°c'),\n (0x2104, 'V'),\n (0x2105, '3', u'c/o'),\n (0x2106, '3', u'c/u'),\n (0x2107, 'M', u'ɛ'),\n (0x2108, 'V'),\n (0x2109, 'M', u'°f'),\n (0x210A, 'M', u'g'),\n (0x210B, 'M', u'h'),\n (0x210F, 'M', u'ħ'),\n (0x2110, 'M', u'i'),\n (0x2112, 'M', u'l'),\n (0x2114, 'V'),\n (0x2115, 'M', u'n'),\n (0x2116, 'M', u'no'),\n (0x2117, 'V'),\n (0x2119, 'M', u'p'),\n (0x211A, 'M', u'q'),\n (0x211B, 'M', u'r'),\n (0x211E, 'V'),\n (0x2120, 'M', u'sm'),\n (0x2121, 'M', u'tel'),\n (0x2122, 'M', u'tm'),\n (0x2123, 'V'),\n (0x2124, 'M', u'z'),\n (0x2125, 'V'),\n (0x2126, 'M', u'ω'),\n (0x2127, 'V'),\n (0x2128, 'M', u'z'),\n (0x2129, 'V'),\n ]\n\ndef _seg_22():\n return [\n (0x212A, 'M', u'k'),\n (0x212B, 'M', u'å'),\n (0x212C, 'M', u'b'),\n (0x212D, 'M', u'c'),\n (0x212E, 'V'),\n (0x212F, 'M', u'e'),\n (0x2131, 'M', u'f'),\n (0x2132, 'X'),\n (0x2133, 'M', u'm'),\n (0x2134, 'M', u'o'),\n (0x2135, 'M', u'א'),\n (0x2136, 'M', u'ב'),\n (0x2137, 'M', u'ג'),\n (0x2138, 'M', u'ד'),\n (0x2139, 'M', u'i'),\n (0x213A, 'V'),\n (0x213B, 'M', u'fax'),\n (0x213C, 'M', u'π'),\n (0x213D, 'M', u'γ'),\n (0x213F, 'M', u'π'),\n (0x2140, 'M', u'∑'),\n (0x2141, 'V'),\n (0x2145, 'M', u'd'),\n (0x2147, 'M', u'e'),\n (0x2148, 'M', u'i'),\n (0x2149, 'M', u'j'),\n (0x214A, 'V'),\n (0x2150, 'M', u'1⁄7'),\n (0x2151, 'M', u'1⁄9'),\n (0x2152, 'M', u'1⁄10'),\n (0x2153, 'M', u'1⁄3'),\n (0x2154, 'M', u'2⁄3'),\n (0x2155, 'M', u'1⁄5'),\n (0x2156, 'M', u'2⁄5'),\n (0x2157, 'M', u'3⁄5'),\n (0x2158, 'M', u'4⁄5'),\n (0x2159, 'M', u'1⁄6'),\n (0x215A, 'M', u'5⁄6'),\n (0x215B, 'M', u'1⁄8'),\n (0x215C, 'M', u'3⁄8'),\n (0x215D, 'M', u'5⁄8'),\n (0x215E, 'M', u'7⁄8'),\n (0x215F, 'M', u'1⁄'),\n (0x2160, 'M', u'i'),\n (0x2161, 'M', u'ii'),\n (0x2162, 'M', u'iii'),\n (0x2163, 'M', u'iv'),\n (0x2164, 'M', u'v'),\n (0x2165, 'M', u'vi'),\n (0x2166, 'M', u'vii'),\n (0x2167, 'M', u'viii'),\n (0x2168, 'M', u'ix'),\n (0x2169, 'M', u'x'),\n (0x216A, 'M', u'xi'),\n (0x216B, 'M', u'xii'),\n (0x216C, 'M', u'l'),\n (0x216D, 'M', u'c'),\n (0x216E, 'M', u'd'),\n (0x216F, 'M', u'm'),\n (0x2170, 'M', u'i'),\n (0x2171, 'M', u'ii'),\n (0x2172, 'M', u'iii'),\n (0x2173, 'M', u'iv'),\n (0x2174, 'M', u'v'),\n (0x2175, 'M', u'vi'),\n (0x2176, 'M', u'vii'),\n (0x2177, 'M', u'viii'),\n (0x2178, 'M', u'ix'),\n (0x2179, 'M', u'x'),\n (0x217A, 'M', u'xi'),\n (0x217B, 'M', u'xii'),\n (0x217C, 'M', u'l'),\n (0x217D, 'M', u'c'),\n (0x217E, 'M', u'd'),\n (0x217F, 'M', u'm'),\n (0x2180, 'V'),\n (0x2183, 'X'),\n (0x2184, 'V'),\n (0x2189, 'M', u'0⁄3'),\n (0x218A, 'V'),\n (0x218C, 'X'),\n (0x2190, 'V'),\n (0x222C, 'M', u'∫∫'),\n (0x222D, 'M', u'∫∫∫'),\n (0x222E, 'V'),\n (0x222F, 'M', u'∮∮'),\n (0x2230, 'M', u'∮∮∮'),\n (0x2231, 'V'),\n (0x2260, '3'),\n (0x2261, 'V'),\n (0x226E, '3'),\n (0x2270, 'V'),\n (0x2329, 'M', u'〈'),\n (0x232A, 'M', u'〉'),\n (0x232B, 'V'),\n (0x2427, 'X'),\n (0x2440, 'V'),\n (0x244B, 'X'),\n (0x2460, 'M', u'1'),\n (0x2461, 'M', u'2'),\n ]\n\ndef _seg_23():\n return [\n (0x2462, 'M', u'3'),\n (0x2463, 'M', u'4'),\n (0x2464, 'M', u'5'),\n (0x2465, 'M', u'6'),\n (0x2466, 'M', u'7'),\n (0x2467, 'M', u'8'),\n (0x2468, 'M', u'9'),\n (0x2469, 'M', u'10'),\n (0x246A, 'M', u'11'),\n (0x246B, 'M', u'12'),\n (0x246C, 'M', u'13'),\n (0x246D, 'M', u'14'),\n (0x246E, 'M', u'15'),\n (0x246F, 'M', u'16'),\n (0x2470, 'M', u'17'),\n (0x2471, 'M', u'18'),\n (0x2472, 'M', u'19'),\n (0x2473, 'M', u'20'),\n (0x2474, '3', u'(1)'),\n (0x2475, '3', u'(2)'),\n (0x2476, '3', u'(3)'),\n (0x2477, '3', u'(4)'),\n (0x2478, '3', u'(5)'),\n (0x2479, '3', u'(6)'),\n (0x247A, '3', u'(7)'),\n (0x247B, '3', u'(8)'),\n (0x247C, '3', u'(9)'),\n (0x247D, '3', u'(10)'),\n (0x247E, '3', u'(11)'),\n (0x247F, '3', u'(12)'),\n (0x2480, '3', u'(13)'),\n (0x2481, '3', u'(14)'),\n (0x2482, '3', u'(15)'),\n (0x2483, '3', u'(16)'),\n (0x2484, '3', u'(17)'),\n (0x2485, '3', u'(18)'),\n (0x2486, '3', u'(19)'),\n (0x2487, '3', u'(20)'),\n (0x2488, 'X'),\n (0x249C, '3', u'(a)'),\n (0x249D, '3', u'(b)'),\n (0x249E, '3', u'(c)'),\n (0x249F, '3', u'(d)'),\n (0x24A0, '3', u'(e)'),\n (0x24A1, '3', u'(f)'),\n (0x24A2, '3', u'(g)'),\n (0x24A3, '3', u'(h)'),\n (0x24A4, '3', u'(i)'),\n (0x24A5, '3', u'(j)'),\n (0x24A6, '3', u'(k)'),\n (0x24A7, '3', u'(l)'),\n (0x24A8, '3', u'(m)'),\n (0x24A9, '3', u'(n)'),\n (0x24AA, '3', u'(o)'),\n (0x24AB, '3', u'(p)'),\n (0x24AC, '3', u'(q)'),\n (0x24AD, '3', u'(r)'),\n (0x24AE, '3', u'(s)'),\n (0x24AF, '3', u'(t)'),\n (0x24B0, '3', u'(u)'),\n (0x24B1, '3', u'(v)'),\n (0x24B2, '3', u'(w)'),\n (0x24B3, '3', u'(x)'),\n (0x24B4, '3', u'(y)'),\n (0x24B5, '3', u'(z)'),\n (0x24B6, 'M', u'a'),\n (0x24B7, 'M', u'b'),\n (0x24B8, 'M', u'c'),\n (0x24B9, 'M', u'd'),\n (0x24BA, 'M', u'e'),\n (0x24BB, 'M', u'f'),\n (0x24BC, 'M', u'g'),\n (0x24BD, 'M', u'h'),\n (0x24BE, 'M', u'i'),\n (0x24BF, 'M', u'j'),\n (0x24C0, 'M', u'k'),\n (0x24C1, 'M', u'l'),\n (0x24C2, 'M', u'm'),\n (0x24C3, 'M', u'n'),\n (0x24C4, 'M', u'o'),\n (0x24C5, 'M', u'p'),\n (0x24C6, 'M', u'q'),\n (0x24C7, 'M', u'r'),\n (0x24C8, 'M', u's'),\n (0x24C9, 'M', u't'),\n (0x24CA, 'M', u'u'),\n (0x24CB, 'M', u'v'),\n (0x24CC, 'M', u'w'),\n (0x24CD, 'M', u'x'),\n (0x24CE, 'M', u'y'),\n (0x24CF, 'M', u'z'),\n (0x24D0, 'M', u'a'),\n (0x24D1, 'M', u'b'),\n (0x24D2, 'M', u'c'),\n (0x24D3, 'M', u'd'),\n (0x24D4, 'M', u'e'),\n (0x24D5, 'M', u'f'),\n (0x24D6, 'M', u'g'),\n (0x24D7, 'M', u'h'),\n (0x24D8, 'M', u'i'),\n ]\n\ndef _seg_24():\n return [\n (0x24D9, 'M', u'j'),\n (0x24DA, 'M', u'k'),\n (0x24DB, 'M', u'l'),\n (0x24DC, 'M', u'm'),\n (0x24DD, 'M', u'n'),\n (0x24DE, 'M', u'o'),\n (0x24DF, 'M', u'p'),\n (0x24E0, 'M', u'q'),\n (0x24E1, 'M', u'r'),\n (0x24E2, 'M', u's'),\n (0x24E3, 'M', u't'),\n (0x24E4, 'M', u'u'),\n (0x24E5, 'M', u'v'),\n (0x24E6, 'M', u'w'),\n (0x24E7, 'M', u'x'),\n (0x24E8, 'M', u'y'),\n (0x24E9, 'M', u'z'),\n (0x24EA, 'M', u'0'),\n (0x24EB, 'V'),\n (0x2A0C, 'M', u'∫∫∫∫'),\n (0x2A0D, 'V'),\n (0x2A74, '3', u'::='),\n (0x2A75, '3', u'=='),\n (0x2A76, '3', u'==='),\n (0x2A77, 'V'),\n (0x2ADC, 'M', u'⫝̸'),\n (0x2ADD, 'V'),\n (0x2B74, 'X'),\n (0x2B76, 'V'),\n (0x2B96, 'X'),\n (0x2B98, 'V'),\n (0x2BC9, 'X'),\n (0x2BCA, 'V'),\n (0x2BFF, 'X'),\n (0x2C00, 'M', u'ⰰ'),\n (0x2C01, 'M', u'ⰱ'),\n (0x2C02, 'M', u'ⰲ'),\n (0x2C03, 'M', u'ⰳ'),\n (0x2C04, 'M', u'ⰴ'),\n (0x2C05, 'M', u'ⰵ'),\n (0x2C06, 'M', u'ⰶ'),\n (0x2C07, 'M', u'ⰷ'),\n (0x2C08, 'M', u'ⰸ'),\n (0x2C09, 'M', u'ⰹ'),\n (0x2C0A, 'M', u'ⰺ'),\n (0x2C0B, 'M', u'ⰻ'),\n (0x2C0C, 'M', u'ⰼ'),\n (0x2C0D, 'M', u'ⰽ'),\n (0x2C0E, 'M', u'ⰾ'),\n (0x2C0F, 'M', u'ⰿ'),\n (0x2C10, 'M', u'ⱀ'),\n (0x2C11, 'M', u'ⱁ'),\n (0x2C12, 'M', u'ⱂ'),\n (0x2C13, 'M', u'ⱃ'),\n (0x2C14, 'M', u'ⱄ'),\n (0x2C15, 'M', u'ⱅ'),\n (0x2C16, 'M', u'ⱆ'),\n (0x2C17, 'M', u'ⱇ'),\n (0x2C18, 'M', u'ⱈ'),\n (0x2C19, 'M', u'ⱉ'),\n (0x2C1A, 'M', u'ⱊ'),\n (0x2C1B, 'M', u'ⱋ'),\n (0x2C1C, 'M', u'ⱌ'),\n (0x2C1D, 'M', u'ⱍ'),\n (0x2C1E, 'M', u'ⱎ'),\n (0x2C1F, 'M', u'ⱏ'),\n (0x2C20, 'M', u'ⱐ'),\n (0x2C21, 'M', u'ⱑ'),\n (0x2C22, 'M', u'ⱒ'),\n (0x2C23, 'M', u'ⱓ'),\n (0x2C24, 'M', u'ⱔ'),\n (0x2C25, 'M', u'ⱕ'),\n (0x2C26, 'M', u'ⱖ'),\n (0x2C27, 'M', u'ⱗ'),\n (0x2C28, 'M', u'ⱘ'),\n (0x2C29, 'M', u'ⱙ'),\n (0x2C2A, 'M', u'ⱚ'),\n (0x2C2B, 'M', u'ⱛ'),\n (0x2C2C, 'M', u'ⱜ'),\n (0x2C2D, 'M', u'ⱝ'),\n (0x2C2E, 'M', u'ⱞ'),\n (0x2C2F, 'X'),\n (0x2C30, 'V'),\n (0x2C5F, 'X'),\n (0x2C60, 'M', u'ⱡ'),\n (0x2C61, 'V'),\n (0x2C62, 'M', u'ɫ'),\n (0x2C63, 'M', u'ᵽ'),\n (0x2C64, 'M', u'ɽ'),\n (0x2C65, 'V'),\n (0x2C67, 'M', u'ⱨ'),\n (0x2C68, 'V'),\n (0x2C69, 'M', u'ⱪ'),\n (0x2C6A, 'V'),\n (0x2C6B, 'M', u'ⱬ'),\n (0x2C6C, 'V'),\n (0x2C6D, 'M', u'ɑ'),\n (0x2C6E, 'M', u'ɱ'),\n (0x2C6F, 'M', u'ɐ'),\n (0x2C70, 'M', u'ɒ'),\n ]\n\ndef _seg_25():\n return [\n (0x2C71, 'V'),\n (0x2C72, 'M', u'ⱳ'),\n (0x2C73, 'V'),\n (0x2C75, 'M', u'ⱶ'),\n (0x2C76, 'V'),\n (0x2C7C, 'M', u'j'),\n (0x2C7D, 'M', u'v'),\n (0x2C7E, 'M', u'ȿ'),\n (0x2C7F, 'M', u'ɀ'),\n (0x2C80, 'M', u'ⲁ'),\n (0x2C81, 'V'),\n (0x2C82, 'M', u'ⲃ'),\n (0x2C83, 'V'),\n (0x2C84, 'M', u'ⲅ'),\n (0x2C85, 'V'),\n (0x2C86, 'M', u'ⲇ'),\n (0x2C87, 'V'),\n (0x2C88, 'M', u'ⲉ'),\n (0x2C89, 'V'),\n (0x2C8A, 'M', u'ⲋ'),\n (0x2C8B, 'V'),\n (0x2C8C, 'M', u'ⲍ'),\n (0x2C8D, 'V'),\n (0x2C8E, 'M', u'ⲏ'),\n (0x2C8F, 'V'),\n (0x2C90, 'M', u'ⲑ'),\n (0x2C91, 'V'),\n (0x2C92, 'M', u'ⲓ'),\n (0x2C93, 'V'),\n (0x2C94, 'M', u'ⲕ'),\n (0x2C95, 'V'),\n (0x2C96, 'M', u'ⲗ'),\n (0x2C97, 'V'),\n (0x2C98, 'M', u'ⲙ'),\n (0x2C99, 'V'),\n (0x2C9A, 'M', u'ⲛ'),\n (0x2C9B, 'V'),\n (0x2C9C, 'M', u'ⲝ'),\n (0x2C9D, 'V'),\n (0x2C9E, 'M', u'ⲟ'),\n (0x2C9F, 'V'),\n (0x2CA0, 'M', u'ⲡ'),\n (0x2CA1, 'V'),\n (0x2CA2, 'M', u'ⲣ'),\n (0x2CA3, 'V'),\n (0x2CA4, 'M', u'ⲥ'),\n (0x2CA5, 'V'),\n (0x2CA6, 'M', u'ⲧ'),\n (0x2CA7, 'V'),\n (0x2CA8, 'M', u'ⲩ'),\n (0x2CA9, 'V'),\n (0x2CAA, 'M', u'ⲫ'),\n (0x2CAB, 'V'),\n (0x2CAC, 'M', u'ⲭ'),\n (0x2CAD, 'V'),\n (0x2CAE, 'M', u'ⲯ'),\n (0x2CAF, 'V'),\n (0x2CB0, 'M', u'ⲱ'),\n (0x2CB1, 'V'),\n (0x2CB2, 'M', u'ⲳ'),\n (0x2CB3, 'V'),\n (0x2CB4, 'M', u'ⲵ'),\n (0x2CB5, 'V'),\n (0x2CB6, 'M', u'ⲷ'),\n (0x2CB7, 'V'),\n (0x2CB8, 'M', u'ⲹ'),\n (0x2CB9, 'V'),\n (0x2CBA, 'M', u'ⲻ'),\n (0x2CBB, 'V'),\n (0x2CBC, 'M', u'ⲽ'),\n (0x2CBD, 'V'),\n (0x2CBE, 'M', u'ⲿ'),\n (0x2CBF, 'V'),\n (0x2CC0, 'M', u'ⳁ'),\n (0x2CC1, 'V'),\n (0x2CC2, 'M', u'ⳃ'),\n (0x2CC3, 'V'),\n (0x2CC4, 'M', u'ⳅ'),\n (0x2CC5, 'V'),\n (0x2CC6, 'M', u'ⳇ'),\n (0x2CC7, 'V'),\n (0x2CC8, 'M', u'ⳉ'),\n (0x2CC9, 'V'),\n (0x2CCA, 'M', u'ⳋ'),\n (0x2CCB, 'V'),\n (0x2CCC, 'M', u'ⳍ'),\n (0x2CCD, 'V'),\n (0x2CCE, 'M', u'ⳏ'),\n (0x2CCF, 'V'),\n (0x2CD0, 'M', u'ⳑ'),\n (0x2CD1, 'V'),\n (0x2CD2, 'M', u'ⳓ'),\n (0x2CD3, 'V'),\n (0x2CD4, 'M', u'ⳕ'),\n (0x2CD5, 'V'),\n (0x2CD6, 'M', u'ⳗ'),\n (0x2CD7, 'V'),\n (0x2CD8, 'M', u'ⳙ'),\n (0x2CD9, 'V'),\n (0x2CDA, 'M', u'ⳛ'),\n ]\n\ndef _seg_26():\n return [\n (0x2CDB, 'V'),\n (0x2CDC, 'M', u'ⳝ'),\n (0x2CDD, 'V'),\n (0x2CDE, 'M', u'ⳟ'),\n (0x2CDF, 'V'),\n (0x2CE0, 'M', u'ⳡ'),\n (0x2CE1, 'V'),\n (0x2CE2, 'M', u'ⳣ'),\n (0x2CE3, 'V'),\n (0x2CEB, 'M', u'ⳬ'),\n (0x2CEC, 'V'),\n (0x2CED, 'M', u'ⳮ'),\n (0x2CEE, 'V'),\n (0x2CF2, 'M', u'ⳳ'),\n (0x2CF3, 'V'),\n (0x2CF4, 'X'),\n (0x2CF9, 'V'),\n (0x2D26, 'X'),\n (0x2D27, 'V'),\n (0x2D28, 'X'),\n (0x2D2D, 'V'),\n (0x2D2E, 'X'),\n (0x2D30, 'V'),\n (0x2D68, 'X'),\n (0x2D6F, 'M', u'ⵡ'),\n (0x2D70, 'V'),\n (0x2D71, 'X'),\n (0x2D7F, 'V'),\n (0x2D97, 'X'),\n (0x2DA0, 'V'),\n (0x2DA7, 'X'),\n (0x2DA8, 'V'),\n (0x2DAF, 'X'),\n (0x2DB0, 'V'),\n (0x2DB7, 'X'),\n (0x2DB8, 'V'),\n (0x2DBF, 'X'),\n (0x2DC0, 'V'),\n (0x2DC7, 'X'),\n (0x2DC8, 'V'),\n (0x2DCF, 'X'),\n (0x2DD0, 'V'),\n (0x2DD7, 'X'),\n (0x2DD8, 'V'),\n (0x2DDF, 'X'),\n (0x2DE0, 'V'),\n (0x2E4F, 'X'),\n (0x2E80, 'V'),\n (0x2E9A, 'X'),\n (0x2E9B, 'V'),\n (0x2E9F, 'M', u'母'),\n (0x2EA0, 'V'),\n (0x2EF3, 'M', u'龟'),\n (0x2EF4, 'X'),\n (0x2F00, 'M', u'一'),\n (0x2F01, 'M', u'丨'),\n (0x2F02, 'M', u'丶'),\n (0x2F03, 'M', u'丿'),\n (0x2F04, 'M', u'乙'),\n (0x2F05, 'M', u'亅'),\n (0x2F06, 'M', u'二'),\n (0x2F07, 'M', u'亠'),\n (0x2F08, 'M', u'人'),\n (0x2F09, 'M', u'儿'),\n (0x2F0A, 'M', u'入'),\n (0x2F0B, 'M', u'八'),\n (0x2F0C, 'M', u'冂'),\n (0x2F0D, 'M', u'冖'),\n (0x2F0E, 'M', u'冫'),\n (0x2F0F, 'M', u'几'),\n (0x2F10, 'M', u'凵'),\n (0x2F11, 'M', u'刀'),\n (0x2F12, 'M', u'力'),\n (0x2F13, 'M', u'勹'),\n (0x2F14, 'M', u'匕'),\n (0x2F15, 'M', u'匚'),\n (0x2F16, 'M', u'匸'),\n (0x2F17, 'M', u'十'),\n (0x2F18, 'M', u'卜'),\n (0x2F19, 'M', u'卩'),\n (0x2F1A, 'M', u'厂'),\n (0x2F1B, 'M', u'厶'),\n (0x2F1C, 'M', u'又'),\n (0x2F1D, 'M', u'口'),\n (0x2F1E, 'M', u'囗'),\n (0x2F1F, 'M', u'土'),\n (0x2F20, 'M', u'士'),\n (0x2F21, 'M', u'夂'),\n (0x2F22, 'M', u'夊'),\n (0x2F23, 'M', u'夕'),\n (0x2F24, 'M', u'大'),\n (0x2F25, 'M', u'女'),\n (0x2F26, 'M', u'子'),\n (0x2F27, 'M', u'宀'),\n (0x2F28, 'M', u'寸'),\n (0x2F29, 'M', u'小'),\n (0x2F2A, 'M', u'尢'),\n (0x2F2B, 'M', u'尸'),\n (0x2F2C, 'M', u'屮'),\n (0x2F2D, 'M', u'山'),\n ]\n\ndef _seg_27():\n return [\n (0x2F2E, 'M', u'巛'),\n (0x2F2F, 'M', u'工'),\n (0x2F30, 'M', u'己'),\n (0x2F31, 'M', u'巾'),\n (0x2F32, 'M', u'干'),\n (0x2F33, 'M', u'幺'),\n (0x2F34, 'M', u'广'),\n (0x2F35, 'M', u'廴'),\n (0x2F36, 'M', u'廾'),\n (0x2F37, 'M', u'弋'),\n (0x2F38, 'M', u'弓'),\n (0x2F39, 'M', u'彐'),\n (0x2F3A, 'M', u'彡'),\n (0x2F3B, 'M', u'彳'),\n (0x2F3C, 'M', u'心'),\n (0x2F3D, 'M', u'戈'),\n (0x2F3E, 'M', u'戶'),\n (0x2F3F, 'M', u'手'),\n (0x2F40, 'M', u'支'),\n (0x2F41, 'M', u'攴'),\n (0x2F42, 'M', u'文'),\n (0x2F43, 'M', u'斗'),\n (0x2F44, 'M', u'斤'),\n (0x2F45, 'M', u'方'),\n (0x2F46, 'M', u'无'),\n (0x2F47, 'M', u'日'),\n (0x2F48, 'M', u'曰'),\n (0x2F49, 'M', u'月'),\n (0x2F4A, 'M', u'木'),\n (0x2F4B, 'M', u'欠'),\n (0x2F4C, 'M', u'止'),\n (0x2F4D, 'M', u'歹'),\n (0x2F4E, 'M', u'殳'),\n (0x2F4F, 'M', u'毋'),\n (0x2F50, 'M', u'比'),\n (0x2F51, 'M', u'毛'),\n (0x2F52, 'M', u'氏'),\n (0x2F53, 'M', u'气'),\n (0x2F54, 'M', u'水'),\n (0x2F55, 'M', u'火'),\n (0x2F56, 'M', u'爪'),\n (0x2F57, 'M', u'父'),\n (0x2F58, 'M', u'爻'),\n (0x2F59, 'M', u'爿'),\n (0x2F5A, 'M', u'片'),\n (0x2F5B, 'M', u'牙'),\n (0x2F5C, 'M', u'牛'),\n (0x2F5D, 'M', u'犬'),\n (0x2F5E, 'M', u'玄'),\n (0x2F5F, 'M', u'玉'),\n (0x2F60, 'M', u'瓜'),\n (0x2F61, 'M', u'瓦'),\n (0x2F62, 'M', u'甘'),\n (0x2F63, 'M', u'生'),\n (0x2F64, 'M', u'用'),\n (0x2F65, 'M', u'田'),\n (0x2F66, 'M', u'疋'),\n (0x2F67, 'M', u'疒'),\n (0x2F68, 'M', u'癶'),\n (0x2F69, 'M', u'白'),\n (0x2F6A, 'M', u'皮'),\n (0x2F6B, 'M', u'皿'),\n (0x2F6C, 'M', u'目'),\n (0x2F6D, 'M', u'矛'),\n (0x2F6E, 'M', u'矢'),\n (0x2F6F, 'M', u'石'),\n (0x2F70, 'M', u'示'),\n (0x2F71, 'M', u'禸'),\n (0x2F72, 'M', u'禾'),\n (0x2F73, 'M', u'穴'),\n (0x2F74, 'M', u'立'),\n (0x2F75, 'M', u'竹'),\n (0x2F76, 'M', u'米'),\n (0x2F77, 'M', u'糸'),\n (0x2F78, 'M', u'缶'),\n (0x2F79, 'M', u'网'),\n (0x2F7A, 'M', u'羊'),\n (0x2F7B, 'M', u'羽'),\n (0x2F7C, 'M', u'老'),\n (0x2F7D, 'M', u'而'),\n (0x2F7E, 'M', u'耒'),\n (0x2F7F, 'M', u'耳'),\n (0x2F80, 'M', u'聿'),\n (0x2F81, 'M', u'肉'),\n (0x2F82, 'M', u'臣'),\n (0x2F83, 'M', u'自'),\n (0x2F84, 'M', u'至'),\n (0x2F85, 'M', u'臼'),\n (0x2F86, 'M', u'舌'),\n (0x2F87, 'M', u'舛'),\n (0x2F88, 'M', u'舟'),\n (0x2F89, 'M', u'艮'),\n (0x2F8A, 'M', u'色'),\n (0x2F8B, 'M', u'艸'),\n (0x2F8C, 'M', u'虍'),\n (0x2F8D, 'M', u'虫'),\n (0x2F8E, 'M', u'血'),\n (0x2F8F, 'M', u'行'),\n (0x2F90, 'M', u'衣'),\n (0x2F91, 'M', u'襾'),\n ]\n\ndef _seg_28():\n return [\n (0x2F92, 'M', u'見'),\n (0x2F93, 'M', u'角'),\n (0x2F94, 'M', u'言'),\n (0x2F95, 'M', u'谷'),\n (0x2F96, 'M', u'豆'),\n (0x2F97, 'M', u'豕'),\n (0x2F98, 'M', u'豸'),\n (0x2F99, 'M', u'貝'),\n (0x2F9A, 'M', u'赤'),\n (0x2F9B, 'M', u'走'),\n (0x2F9C, 'M', u'足'),\n (0x2F9D, 'M', u'身'),\n (0x2F9E, 'M', u'車'),\n (0x2F9F, 'M', u'辛'),\n (0x2FA0, 'M', u'辰'),\n (0x2FA1, 'M', u'辵'),\n (0x2FA2, 'M', u'邑'),\n (0x2FA3, 'M', u'酉'),\n (0x2FA4, 'M', u'釆'),\n (0x2FA5, 'M', u'里'),\n (0x2FA6, 'M', u'金'),\n (0x2FA7, 'M', u'長'),\n (0x2FA8, 'M', u'門'),\n (0x2FA9, 'M', u'阜'),\n (0x2FAA, 'M', u'隶'),\n (0x2FAB, 'M', u'隹'),\n (0x2FAC, 'M', u'雨'),\n (0x2FAD, 'M', u'靑'),\n (0x2FAE, 'M', u'非'),\n (0x2FAF, 'M', u'面'),\n (0x2FB0, 'M', u'革'),\n (0x2FB1, 'M', u'韋'),\n (0x2FB2, 'M', u'韭'),\n (0x2FB3, 'M', u'音'),\n (0x2FB4, 'M', u'頁'),\n (0x2FB5, 'M', u'風'),\n (0x2FB6, 'M', u'飛'),\n (0x2FB7, 'M', u'食'),\n (0x2FB8, 'M', u'首'),\n (0x2FB9, 'M', u'香'),\n (0x2FBA, 'M', u'馬'),\n (0x2FBB, 'M', u'骨'),\n (0x2FBC, 'M', u'高'),\n (0x2FBD, 'M', u'髟'),\n (0x2FBE, 'M', u'鬥'),\n (0x2FBF, 'M', u'鬯'),\n (0x2FC0, 'M', u'鬲'),\n (0x2FC1, 'M', u'鬼'),\n (0x2FC2, 'M', u'魚'),\n (0x2FC3, 'M', u'鳥'),\n (0x2FC4, 'M', u'鹵'),\n (0x2FC5, 'M', u'鹿'),\n (0x2FC6, 'M', u'麥'),\n (0x2FC7, 'M', u'麻'),\n (0x2FC8, 'M', u'黃'),\n (0x2FC9, 'M', u'黍'),\n (0x2FCA, 'M', u'黑'),\n (0x2FCB, 'M', u'黹'),\n (0x2FCC, 'M', u'黽'),\n (0x2FCD, 'M', u'鼎'),\n (0x2FCE, 'M', u'鼓'),\n (0x2FCF, 'M', u'鼠'),\n (0x2FD0, 'M', u'鼻'),\n (0x2FD1, 'M', u'齊'),\n (0x2FD2, 'M', u'齒'),\n (0x2FD3, 'M', u'龍'),\n (0x2FD4, 'M', u'龜'),\n (0x2FD5, 'M', u'龠'),\n (0x2FD6, 'X'),\n (0x3000, '3', u' '),\n (0x3001, 'V'),\n (0x3002, 'M', u'.'),\n (0x3003, 'V'),\n (0x3036, 'M', u'〒'),\n (0x3037, 'V'),\n (0x3038, 'M', u'十'),\n (0x3039, 'M', u'卄'),\n (0x303A, 'M', u'卅'),\n (0x303B, 'V'),\n (0x3040, 'X'),\n (0x3041, 'V'),\n (0x3097, 'X'),\n (0x3099, 'V'),\n (0x309B, '3', u' ゙'),\n (0x309C, '3', u' ゚'),\n (0x309D, 'V'),\n (0x309F, 'M', u'より'),\n (0x30A0, 'V'),\n (0x30FF, 'M', u'コト'),\n (0x3100, 'X'),\n (0x3105, 'V'),\n (0x3130, 'X'),\n (0x3131, 'M', u'ᄀ'),\n (0x3132, 'M', u'ᄁ'),\n (0x3133, 'M', u'ᆪ'),\n (0x3134, 'M', u'ᄂ'),\n (0x3135, 'M', u'ᆬ'),\n (0x3136, 'M', u'ᆭ'),\n (0x3137, 'M', u'ᄃ'),\n (0x3138, 'M', u'ᄄ'),\n ]\n\ndef _seg_29():\n return [\n (0x3139, 'M', u'ᄅ'),\n (0x313A, 'M', u'ᆰ'),\n (0x313B, 'M', u'ᆱ'),\n (0x313C, 'M', u'ᆲ'),\n (0x313D, 'M', u'ᆳ'),\n (0x313E, 'M', u'ᆴ'),\n (0x313F, 'M', u'ᆵ'),\n (0x3140, 'M', u'ᄚ'),\n (0x3141, 'M', u'ᄆ'),\n (0x3142, 'M', u'ᄇ'),\n (0x3143, 'M', u'ᄈ'),\n (0x3144, 'M', u'ᄡ'),\n (0x3145, 'M', u'ᄉ'),\n (0x3146, 'M', u'ᄊ'),\n (0x3147, 'M', u'ᄋ'),\n (0x3148, 'M', u'ᄌ'),\n (0x3149, 'M', u'ᄍ'),\n (0x314A, 'M', u'ᄎ'),\n (0x314B, 'M', u'ᄏ'),\n (0x314C, 'M', u'ᄐ'),\n (0x314D, 'M', u'ᄑ'),\n (0x314E, 'M', u'ᄒ'),\n (0x314F, 'M', u'ᅡ'),\n (0x3150, 'M', u'ᅢ'),\n (0x3151, 'M', u'ᅣ'),\n (0x3152, 'M', u'ᅤ'),\n (0x3153, 'M', u'ᅥ'),\n (0x3154, 'M', u'ᅦ'),\n (0x3155, 'M', u'ᅧ'),\n (0x3156, 'M', u'ᅨ'),\n (0x3157, 'M', u'ᅩ'),\n (0x3158, 'M', u'ᅪ'),\n (0x3159, 'M', u'ᅫ'),\n (0x315A, 'M', u'ᅬ'),\n (0x315B, 'M', u'ᅭ'),\n (0x315C, 'M', u'ᅮ'),\n (0x315D, 'M', u'ᅯ'),\n (0x315E, 'M', u'ᅰ'),\n (0x315F, 'M', u'ᅱ'),\n (0x3160, 'M', u'ᅲ'),\n (0x3161, 'M', u'ᅳ'),\n (0x3162, 'M', u'ᅴ'),\n (0x3163, 'M', u'ᅵ'),\n (0x3164, 'X'),\n (0x3165, 'M', u'ᄔ'),\n (0x3166, 'M', u'ᄕ'),\n (0x3167, 'M', u'ᇇ'),\n (0x3168, 'M', u'ᇈ'),\n (0x3169, 'M', u'ᇌ'),\n (0x316A, 'M', u'ᇎ'),\n (0x316B, 'M', u'ᇓ'),\n (0x316C, 'M', u'ᇗ'),\n (0x316D, 'M', u'ᇙ'),\n (0x316E, 'M', u'ᄜ'),\n (0x316F, 'M', u'ᇝ'),\n (0x3170, 'M', u'ᇟ'),\n (0x3171, 'M', u'ᄝ'),\n (0x3172, 'M', u'ᄞ'),\n (0x3173, 'M', u'ᄠ'),\n (0x3174, 'M', u'ᄢ'),\n (0x3175, 'M', u'ᄣ'),\n (0x3176, 'M', u'ᄧ'),\n (0x3177, 'M', u'ᄩ'),\n (0x3178, 'M', u'ᄫ'),\n (0x3179, 'M', u'ᄬ'),\n (0x317A, 'M', u'ᄭ'),\n (0x317B, 'M', u'ᄮ'),\n (0x317C, 'M', u'ᄯ'),\n (0x317D, 'M', u'ᄲ'),\n (0x317E, 'M', u'ᄶ'),\n (0x317F, 'M', u'ᅀ'),\n (0x3180, 'M', u'ᅇ'),\n (0x3181, 'M', u'ᅌ'),\n (0x3182, 'M', u'ᇱ'),\n (0x3183, 'M', u'ᇲ'),\n (0x3184, 'M', u'ᅗ'),\n (0x3185, 'M', u'ᅘ'),\n (0x3186, 'M', u'ᅙ'),\n (0x3187, 'M', u'ᆄ'),\n (0x3188, 'M', u'ᆅ'),\n (0x3189, 'M', u'ᆈ'),\n (0x318A, 'M', u'ᆑ'),\n (0x318B, 'M', u'ᆒ'),\n (0x318C, 'M', u'ᆔ'),\n (0x318D, 'M', u'ᆞ'),\n (0x318E, 'M', u'ᆡ'),\n (0x318F, 'X'),\n (0x3190, 'V'),\n (0x3192, 'M', u'一'),\n (0x3193, 'M', u'二'),\n (0x3194, 'M', u'三'),\n (0x3195, 'M', u'四'),\n (0x3196, 'M', u'上'),\n (0x3197, 'M', u'中'),\n (0x3198, 'M', u'下'),\n (0x3199, 'M', u'甲'),\n (0x319A, 'M', u'乙'),\n (0x319B, 'M', u'丙'),\n (0x319C, 'M', u'丁'),\n (0x319D, 'M', u'天'),\n ]\n\ndef _seg_30():\n return [\n (0x319E, 'M', u'地'),\n (0x319F, 'M', u'人'),\n (0x31A0, 'V'),\n (0x31BB, 'X'),\n (0x31C0, 'V'),\n (0x31E4, 'X'),\n (0x31F0, 'V'),\n (0x3200, '3', u'(ᄀ)'),\n (0x3201, '3', u'(ᄂ)'),\n (0x3202, '3', u'(ᄃ)'),\n (0x3203, '3', u'(ᄅ)'),\n (0x3204, '3', u'(ᄆ)'),\n (0x3205, '3', u'(ᄇ)'),\n (0x3206, '3', u'(ᄉ)'),\n (0x3207, '3', u'(ᄋ)'),\n (0x3208, '3', u'(ᄌ)'),\n (0x3209, '3', u'(ᄎ)'),\n (0x320A, '3', u'(ᄏ)'),\n (0x320B, '3', u'(ᄐ)'),\n (0x320C, '3', u'(ᄑ)'),\n (0x320D, '3', u'(ᄒ)'),\n (0x320E, '3', u'(가)'),\n (0x320F, '3', u'(나)'),\n (0x3210, '3', u'(다)'),\n (0x3211, '3', u'(라)'),\n (0x3212, '3', u'(마)'),\n (0x3213, '3', u'(바)'),\n (0x3214, '3', u'(사)'),\n (0x3215, '3', u'(아)'),\n (0x3216, '3', u'(자)'),\n (0x3217, '3', u'(차)'),\n (0x3218, '3', u'(카)'),\n (0x3219, '3', u'(타)'),\n (0x321A, '3', u'(파)'),\n (0x321B, '3', u'(하)'),\n (0x321C, '3', u'(주)'),\n (0x321D, '3', u'(오전)'),\n (0x321E, '3', u'(오후)'),\n (0x321F, 'X'),\n (0x3220, '3', u'(一)'),\n (0x3221, '3', u'(二)'),\n (0x3222, '3', u'(三)'),\n (0x3223, '3', u'(四)'),\n (0x3224, '3', u'(五)'),\n (0x3225, '3', u'(六)'),\n (0x3226, '3', u'(七)'),\n (0x3227, '3', u'(八)'),\n (0x3228, '3', u'(九)'),\n (0x3229, '3', u'(十)'),\n (0x322A, '3', u'(月)'),\n (0x322B, '3', u'(火)'),\n (0x322C, '3', u'(水)'),\n (0x322D, '3', u'(木)'),\n (0x322E, '3', u'(金)'),\n (0x322F, '3', u'(土)'),\n (0x3230, '3', u'(日)'),\n (0x3231, '3', u'(株)'),\n (0x3232, '3', u'(有)'),\n (0x3233, '3', u'(社)'),\n (0x3234, '3', u'(名)'),\n (0x3235, '3', u'(特)'),\n (0x3236, '3', u'(財)'),\n (0x3237, '3', u'(祝)'),\n (0x3238, '3', u'(労)'),\n (0x3239, '3', u'(代)'),\n (0x323A, '3', u'(呼)'),\n (0x323B, '3', u'(学)'),\n (0x323C, '3', u'(監)'),\n (0x323D, '3', u'(企)'),\n (0x323E, '3', u'(資)'),\n (0x323F, '3', u'(協)'),\n (0x3240, '3', u'(祭)'),\n (0x3241, '3', u'(休)'),\n (0x3242, '3', u'(自)'),\n (0x3243, '3', u'(至)'),\n (0x3244, 'M', u'問'),\n (0x3245, 'M', u'幼'),\n (0x3246, 'M', u'文'),\n (0x3247, 'M', u'箏'),\n (0x3248, 'V'),\n (0x3250, 'M', u'pte'),\n (0x3251, 'M', u'21'),\n (0x3252, 'M', u'22'),\n (0x3253, 'M', u'23'),\n (0x3254, 'M', u'24'),\n (0x3255, 'M', u'25'),\n (0x3256, 'M', u'26'),\n (0x3257, 'M', u'27'),\n (0x3258, 'M', u'28'),\n (0x3259, 'M', u'29'),\n (0x325A, 'M', u'30'),\n (0x325B, 'M', u'31'),\n (0x325C, 'M', u'32'),\n (0x325D, 'M', u'33'),\n (0x325E, 'M', u'34'),\n (0x325F, 'M', u'35'),\n (0x3260, 'M', u'ᄀ'),\n (0x3261, 'M', u'ᄂ'),\n (0x3262, 'M', u'ᄃ'),\n (0x3263, 'M', u'ᄅ'),\n ]\n\ndef _seg_31():\n return [\n (0x3264, 'M', u'ᄆ'),\n (0x3265, 'M', u'ᄇ'),\n (0x3266, 'M', u'ᄉ'),\n (0x3267, 'M', u'ᄋ'),\n (0x3268, 'M', u'ᄌ'),\n (0x3269, 'M', u'ᄎ'),\n (0x326A, 'M', u'ᄏ'),\n (0x326B, 'M', u'ᄐ'),\n (0x326C, 'M', u'ᄑ'),\n (0x326D, 'M', u'ᄒ'),\n (0x326E, 'M', u'가'),\n (0x326F, 'M', u'나'),\n (0x3270, 'M', u'다'),\n (0x3271, 'M', u'라'),\n (0x3272, 'M', u'마'),\n (0x3273, 'M', u'바'),\n (0x3274, 'M', u'사'),\n (0x3275, 'M', u'아'),\n (0x3276, 'M', u'자'),\n (0x3277, 'M', u'차'),\n (0x3278, 'M', u'카'),\n (0x3279, 'M', u'타'),\n (0x327A, 'M', u'파'),\n (0x327B, 'M', u'하'),\n (0x327C, 'M', u'참고'),\n (0x327D, 'M', u'주의'),\n (0x327E, 'M', u'우'),\n (0x327F, 'V'),\n (0x3280, 'M', u'一'),\n (0x3281, 'M', u'二'),\n (0x3282, 'M', u'三'),\n (0x3283, 'M', u'四'),\n (0x3284, 'M', u'五'),\n (0x3285, 'M', u'六'),\n (0x3286, 'M', u'七'),\n (0x3287, 'M', u'八'),\n (0x3288, 'M', u'九'),\n (0x3289, 'M', u'十'),\n (0x328A, 'M', u'月'),\n (0x328B, 'M', u'火'),\n (0x328C, 'M', u'水'),\n (0x328D, 'M', u'木'),\n (0x328E, 'M', u'金'),\n (0x328F, 'M', u'土'),\n (0x3290, 'M', u'日'),\n (0x3291, 'M', u'株'),\n (0x3292, 'M', u'有'),\n (0x3293, 'M', u'社'),\n (0x3294, 'M', u'名'),\n (0x3295, 'M', u'特'),\n (0x3296, 'M', u'財'),\n (0x3297, 'M', u'祝'),\n (0x3298, 'M', u'労'),\n (0x3299, 'M', u'秘'),\n (0x329A, 'M', u'男'),\n (0x329B, 'M', u'女'),\n (0x329C, 'M', u'適'),\n (0x329D, 'M', u'優'),\n (0x329E, 'M', u'印'),\n (0x329F, 'M', u'注'),\n (0x32A0, 'M', u'項'),\n (0x32A1, 'M', u'休'),\n (0x32A2, 'M', u'写'),\n (0x32A3, 'M', u'正'),\n (0x32A4, 'M', u'上'),\n (0x32A5, 'M', u'中'),\n (0x32A6, 'M', u'下'),\n (0x32A7, 'M', u'左'),\n (0x32A8, 'M', u'右'),\n (0x32A9, 'M', u'医'),\n (0x32AA, 'M', u'宗'),\n (0x32AB, 'M', u'学'),\n (0x32AC, 'M', u'監'),\n (0x32AD, 'M', u'企'),\n (0x32AE, 'M', u'資'),\n (0x32AF, 'M', u'協'),\n (0x32B0, 'M', u'夜'),\n (0x32B1, 'M', u'36'),\n (0x32B2, 'M', u'37'),\n (0x32B3, 'M', u'38'),\n (0x32B4, 'M', u'39'),\n (0x32B5, 'M', u'40'),\n (0x32B6, 'M', u'41'),\n (0x32B7, 'M', u'42'),\n (0x32B8, 'M', u'43'),\n (0x32B9, 'M', u'44'),\n (0x32BA, 'M', u'45'),\n (0x32BB, 'M', u'46'),\n (0x32BC, 'M', u'47'),\n (0x32BD, 'M', u'48'),\n (0x32BE, 'M', u'49'),\n (0x32BF, 'M', u'50'),\n (0x32C0, 'M', u'1月'),\n (0x32C1, 'M', u'2月'),\n (0x32C2, 'M', u'3月'),\n (0x32C3, 'M', u'4月'),\n (0x32C4, 'M', u'5月'),\n (0x32C5, 'M', u'6月'),\n (0x32C6, 'M', u'7月'),\n (0x32C7, 'M', u'8月'),\n ]\n\ndef _seg_32():\n return [\n (0x32C8, 'M', u'9月'),\n (0x32C9, 'M', u'10月'),\n (0x32CA, 'M', u'11月'),\n (0x32CB, 'M', u'12月'),\n (0x32CC, 'M', u'hg'),\n (0x32CD, 'M', u'erg'),\n (0x32CE, 'M', u'ev'),\n (0x32CF, 'M', u'ltd'),\n (0x32D0, 'M', u'ア'),\n (0x32D1, 'M', u'イ'),\n (0x32D2, 'M', u'ウ'),\n (0x32D3, 'M', u'エ'),\n (0x32D4, 'M', u'オ'),\n (0x32D5, 'M', u'カ'),\n (0x32D6, 'M', u'キ'),\n (0x32D7, 'M', u'ク'),\n (0x32D8, 'M', u'ケ'),\n (0x32D9, 'M', u'コ'),\n (0x32DA, 'M', u'サ'),\n (0x32DB, 'M', u'シ'),\n (0x32DC, 'M', u'ス'),\n (0x32DD, 'M', u'セ'),\n (0x32DE, 'M', u'ソ'),\n (0x32DF, 'M', u'タ'),\n (0x32E0, 'M', u'チ'),\n (0x32E1, 'M', u'ツ'),\n (0x32E2, 'M', u'テ'),\n (0x32E3, 'M', u'ト'),\n (0x32E4, 'M', u'ナ'),\n (0x32E5, 'M', u'ニ'),\n (0x32E6, 'M', u'ヌ'),\n (0x32E7, 'M', u'ネ'),\n (0x32E8, 'M', u'ノ'),\n (0x32E9, 'M', u'ハ'),\n (0x32EA, 'M', u'ヒ'),\n (0x32EB, 'M', u'フ'),\n (0x32EC, 'M', u'ヘ'),\n (0x32ED, 'M', u'ホ'),\n (0x32EE, 'M', u'マ'),\n (0x32EF, 'M', u'ミ'),\n (0x32F0, 'M', u'ム'),\n (0x32F1, 'M', u'メ'),\n (0x32F2, 'M', u'モ'),\n (0x32F3, 'M', u'ヤ'),\n (0x32F4, 'M', u'ユ'),\n (0x32F5, 'M', u'ヨ'),\n (0x32F6, 'M', u'ラ'),\n (0x32F7, 'M', u'リ'),\n (0x32F8, 'M', u'ル'),\n (0x32F9, 'M', u'レ'),\n (0x32FA, 'M', u'ロ'),\n (0x32FB, 'M', u'ワ'),\n (0x32FC, 'M', u'ヰ'),\n (0x32FD, 'M', u'ヱ'),\n (0x32FE, 'M', u'ヲ'),\n (0x32FF, 'X'),\n (0x3300, 'M', u'アパート'),\n (0x3301, 'M', u'アルファ'),\n (0x3302, 'M', u'アンペア'),\n (0x3303, 'M', u'アール'),\n (0x3304, 'M', u'イニング'),\n (0x3305, 'M', u'インチ'),\n (0x3306, 'M', u'ウォン'),\n (0x3307, 'M', u'エスクード'),\n (0x3308, 'M', u'エーカー'),\n (0x3309, 'M', u'オンス'),\n (0x330A, 'M', u'オーム'),\n (0x330B, 'M', u'カイリ'),\n (0x330C, 'M', u'カラット'),\n (0x330D, 'M', u'カロリー'),\n (0x330E, 'M', u'ガロン'),\n (0x330F, 'M', u'ガンマ'),\n (0x3310, 'M', u'ギガ'),\n (0x3311, 'M', u'ギニー'),\n (0x3312, 'M', u'キュリー'),\n (0x3313, 'M', u'ギルダー'),\n (0x3314, 'M', u'キロ'),\n (0x3315, 'M', u'キログラム'),\n (0x3316, 'M', u'キロメートル'),\n (0x3317, 'M', u'キロワット'),\n (0x3318, 'M', u'グラム'),\n (0x3319, 'M', u'グラムトン'),\n (0x331A, 'M', u'クルゼイロ'),\n (0x331B, 'M', u'クローネ'),\n (0x331C, 'M', u'ケース'),\n (0x331D, 'M', u'コルナ'),\n (0x331E, 'M', u'コーポ'),\n (0x331F, 'M', u'サイクル'),\n (0x3320, 'M', u'サンチーム'),\n (0x3321, 'M', u'シリング'),\n (0x3322, 'M', u'センチ'),\n (0x3323, 'M', u'セント'),\n (0x3324, 'M', u'ダース'),\n (0x3325, 'M', u'デシ'),\n (0x3326, 'M', u'ドル'),\n (0x3327, 'M', u'トン'),\n (0x3328, 'M', u'ナノ'),\n (0x3329, 'M', u'ノット'),\n (0x332A, 'M', u'ハイツ'),\n (0x332B, 'M', u'パーセント'),\n ]\n\ndef _seg_33():\n return [\n (0x332C, 'M', u'パーツ'),\n (0x332D, 'M', u'バーレル'),\n (0x332E, 'M', u'ピアストル'),\n (0x332F, 'M', u'ピクル'),\n (0x3330, 'M', u'ピコ'),\n (0x3331, 'M', u'ビル'),\n (0x3332, 'M', u'ファラッド'),\n (0x3333, 'M', u'フィート'),\n (0x3334, 'M', u'ブッシェル'),\n (0x3335, 'M', u'フラン'),\n (0x3336, 'M', u'ヘクタール'),\n (0x3337, 'M', u'ペソ'),\n (0x3338, 'M', u'ペニヒ'),\n (0x3339, 'M', u'ヘルツ'),\n (0x333A, 'M', u'ペンス'),\n (0x333B, 'M', u'ページ'),\n (0x333C, 'M', u'ベータ'),\n (0x333D, 'M', u'ポイント'),\n (0x333E, 'M', u'ボルト'),\n (0x333F, 'M', u'ホン'),\n (0x3340, 'M', u'ポンド'),\n (0x3341, 'M', u'ホール'),\n (0x3342, 'M', u'ホーン'),\n (0x3343, 'M', u'マイクロ'),\n (0x3344, 'M', u'マイル'),\n (0x3345, 'M', u'マッハ'),\n (0x3346, 'M', u'マルク'),\n (0x3347, 'M', u'マンション'),\n (0x3348, 'M', u'ミクロン'),\n (0x3349, 'M', u'ミリ'),\n (0x334A, 'M', u'ミリバール'),\n (0x334B, 'M', u'メガ'),\n (0x334C, 'M', u'メガトン'),\n (0x334D, 'M', u'メートル'),\n (0x334E, 'M', u'ヤード'),\n (0x334F, 'M', u'ヤール'),\n (0x3350, 'M', u'ユアン'),\n (0x3351, 'M', u'リットル'),\n (0x3352, 'M', u'リラ'),\n (0x3353, 'M', u'ルピー'),\n (0x3354, 'M', u'ルーブル'),\n (0x3355, 'M', u'レム'),\n (0x3356, 'M', u'レントゲン'),\n (0x3357, 'M', u'ワット'),\n (0x3358, 'M', u'0点'),\n (0x3359, 'M', u'1点'),\n (0x335A, 'M', u'2点'),\n (0x335B, 'M', u'3点'),\n (0x335C, 'M', u'4点'),\n (0x335D, 'M', u'5点'),\n (0x335E, 'M', u'6点'),\n (0x335F, 'M', u'7点'),\n (0x3360, 'M', u'8点'),\n (0x3361, 'M', u'9点'),\n (0x3362, 'M', u'10点'),\n (0x3363, 'M', u'11点'),\n (0x3364, 'M', u'12点'),\n (0x3365, 'M', u'13点'),\n (0x3366, 'M', u'14点'),\n (0x3367, 'M', u'15点'),\n (0x3368, 'M', u'16点'),\n (0x3369, 'M', u'17点'),\n (0x336A, 'M', u'18点'),\n (0x336B, 'M', u'19点'),\n (0x336C, 'M', u'20点'),\n (0x336D, 'M', u'21点'),\n (0x336E, 'M', u'22点'),\n (0x336F, 'M', u'23点'),\n (0x3370, 'M', u'24点'),\n (0x3371, 'M', u'hpa'),\n (0x3372, 'M', u'da'),\n (0x3373, 'M', u'au'),\n (0x3374, 'M', u'bar'),\n (0x3375, 'M', u'ov'),\n (0x3376, 'M', u'pc'),\n (0x3377, 'M', u'dm'),\n (0x3378, 'M', u'dm2'),\n (0x3379, 'M', u'dm3'),\n (0x337A, 'M', u'iu'),\n (0x337B, 'M', u'平成'),\n (0x337C, 'M', u'昭和'),\n (0x337D, 'M', u'大正'),\n (0x337E, 'M', u'明治'),\n (0x337F, 'M', u'株式会社'),\n (0x3380, 'M', u'pa'),\n (0x3381, 'M', u'na'),\n (0x3382, 'M', u'μa'),\n (0x3383, 'M', u'ma'),\n (0x3384, 'M', u'ka'),\n (0x3385, 'M', u'kb'),\n (0x3386, 'M', u'mb'),\n (0x3387, 'M', u'gb'),\n (0x3388, 'M', u'cal'),\n (0x3389, 'M', u'kcal'),\n (0x338A, 'M', u'pf'),\n (0x338B, 'M', u'nf'),\n (0x338C, 'M', u'μf'),\n (0x338D, 'M', u'μg'),\n (0x338E, 'M', u'mg'),\n (0x338F, 'M', u'kg'),\n ]\n\ndef _seg_34():\n return [\n (0x3390, 'M', u'hz'),\n (0x3391, 'M', u'khz'),\n (0x3392, 'M', u'mhz'),\n (0x3393, 'M', u'ghz'),\n (0x3394, 'M', u'thz'),\n (0x3395, 'M', u'μl'),\n (0x3396, 'M', u'ml'),\n (0x3397, 'M', u'dl'),\n (0x3398, 'M', u'kl'),\n (0x3399, 'M', u'fm'),\n (0x339A, 'M', u'nm'),\n (0x339B, 'M', u'μm'),\n (0x339C, 'M', u'mm'),\n (0x339D, 'M', u'cm'),\n (0x339E, 'M', u'km'),\n (0x339F, 'M', u'mm2'),\n (0x33A0, 'M', u'cm2'),\n (0x33A1, 'M', u'm2'),\n (0x33A2, 'M', u'km2'),\n (0x33A3, 'M', u'mm3'),\n (0x33A4, 'M', u'cm3'),\n (0x33A5, 'M', u'm3'),\n (0x33A6, 'M', u'km3'),\n (0x33A7, 'M', u'm∕s'),\n (0x33A8, 'M', u'm∕s2'),\n (0x33A9, 'M', u'pa'),\n (0x33AA, 'M', u'kpa'),\n (0x33AB, 'M', u'mpa'),\n (0x33AC, 'M', u'gpa'),\n (0x33AD, 'M', u'rad'),\n (0x33AE, 'M', u'rad∕s'),\n (0x33AF, 'M', u'rad∕s2'),\n (0x33B0, 'M', u'ps'),\n (0x33B1, 'M', u'ns'),\n (0x33B2, 'M', u'μs'),\n (0x33B3, 'M', u'ms'),\n (0x33B4, 'M', u'pv'),\n (0x33B5, 'M', u'nv'),\n (0x33B6, 'M', u'μv'),\n (0x33B7, 'M', u'mv'),\n (0x33B8, 'M', u'kv'),\n (0x33B9, 'M', u'mv'),\n (0x33BA, 'M', u'pw'),\n (0x33BB, 'M', u'nw'),\n (0x33BC, 'M', u'μw'),\n (0x33BD, 'M', u'mw'),\n (0x33BE, 'M', u'kw'),\n (0x33BF, 'M', u'mw'),\n (0x33C0, 'M', u'kω'),\n (0x33C1, 'M', u'mω'),\n (0x33C2, 'X'),\n (0x33C3, 'M', u'bq'),\n (0x33C4, 'M', u'cc'),\n (0x33C5, 'M', u'cd'),\n (0x33C6, 'M', u'c∕kg'),\n (0x33C7, 'X'),\n (0x33C8, 'M', u'db'),\n (0x33C9, 'M', u'gy'),\n (0x33CA, 'M', u'ha'),\n (0x33CB, 'M', u'hp'),\n (0x33CC, 'M', u'in'),\n (0x33CD, 'M', u'kk'),\n (0x33CE, 'M', u'km'),\n (0x33CF, 'M', u'kt'),\n (0x33D0, 'M', u'lm'),\n (0x33D1, 'M', u'ln'),\n (0x33D2, 'M', u'log'),\n (0x33D3, 'M', u'lx'),\n (0x33D4, 'M', u'mb'),\n (0x33D5, 'M', u'mil'),\n (0x33D6, 'M', u'mol'),\n (0x33D7, 'M', u'ph'),\n (0x33D8, 'X'),\n (0x33D9, 'M', u'ppm'),\n (0x33DA, 'M', u'pr'),\n (0x33DB, 'M', u'sr'),\n (0x33DC, 'M', u'sv'),\n (0x33DD, 'M', u'wb'),\n (0x33DE, 'M', u'v∕m'),\n (0x33DF, 'M', u'a∕m'),\n (0x33E0, 'M', u'1日'),\n (0x33E1, 'M', u'2日'),\n (0x33E2, 'M', u'3日'),\n (0x33E3, 'M', u'4日'),\n (0x33E4, 'M', u'5日'),\n (0x33E5, 'M', u'6日'),\n (0x33E6, 'M', u'7日'),\n (0x33E7, 'M', u'8日'),\n (0x33E8, 'M', u'9日'),\n (0x33E9, 'M', u'10日'),\n (0x33EA, 'M', u'11日'),\n (0x33EB, 'M', u'12日'),\n (0x33EC, 'M', u'13日'),\n (0x33ED, 'M', u'14日'),\n (0x33EE, 'M', u'15日'),\n (0x33EF, 'M', u'16日'),\n (0x33F0, 'M', u'17日'),\n (0x33F1, 'M', u'18日'),\n (0x33F2, 'M', u'19日'),\n (0x33F3, 'M', u'20日'),\n ]\n\ndef _seg_35():\n return [\n (0x33F4, 'M', u'21日'),\n (0x33F5, 'M', u'22日'),\n (0x33F6, 'M', u'23日'),\n (0x33F7, 'M', u'24日'),\n (0x33F8, 'M', u'25日'),\n (0x33F9, 'M', u'26日'),\n (0x33FA, 'M', u'27日'),\n (0x33FB, 'M', u'28日'),\n (0x33FC, 'M', u'29日'),\n (0x33FD, 'M', u'30日'),\n (0x33FE, 'M', u'31日'),\n (0x33FF, 'M', u'gal'),\n (0x3400, 'V'),\n (0x4DB6, 'X'),\n (0x4DC0, 'V'),\n (0x9FF0, 'X'),\n (0xA000, 'V'),\n (0xA48D, 'X'),\n (0xA490, 'V'),\n (0xA4C7, 'X'),\n (0xA4D0, 'V'),\n (0xA62C, 'X'),\n (0xA640, 'M', u'ꙁ'),\n (0xA641, 'V'),\n (0xA642, 'M', u'ꙃ'),\n (0xA643, 'V'),\n (0xA644, 'M', u'ꙅ'),\n (0xA645, 'V'),\n (0xA646, 'M', u'ꙇ'),\n (0xA647, 'V'),\n (0xA648, 'M', u'ꙉ'),\n (0xA649, 'V'),\n (0xA64A, 'M', u'ꙋ'),\n (0xA64B, 'V'),\n (0xA64C, 'M', u'ꙍ'),\n (0xA64D, 'V'),\n (0xA64E, 'M', u'ꙏ'),\n (0xA64F, 'V'),\n (0xA650, 'M', u'ꙑ'),\n (0xA651, 'V'),\n (0xA652, 'M', u'ꙓ'),\n (0xA653, 'V'),\n (0xA654, 'M', u'ꙕ'),\n (0xA655, 'V'),\n (0xA656, 'M', u'ꙗ'),\n (0xA657, 'V'),\n (0xA658, 'M', u'ꙙ'),\n (0xA659, 'V'),\n (0xA65A, 'M', u'ꙛ'),\n (0xA65B, 'V'),\n (0xA65C, 'M', u'ꙝ'),\n (0xA65D, 'V'),\n (0xA65E, 'M', u'ꙟ'),\n (0xA65F, 'V'),\n (0xA660, 'M', u'ꙡ'),\n (0xA661, 'V'),\n (0xA662, 'M', u'ꙣ'),\n (0xA663, 'V'),\n (0xA664, 'M', u'ꙥ'),\n (0xA665, 'V'),\n (0xA666, 'M', u'ꙧ'),\n (0xA667, 'V'),\n (0xA668, 'M', u'ꙩ'),\n (0xA669, 'V'),\n (0xA66A, 'M', u'ꙫ'),\n (0xA66B, 'V'),\n (0xA66C, 'M', u'ꙭ'),\n (0xA66D, 'V'),\n (0xA680, 'M', u'ꚁ'),\n (0xA681, 'V'),\n (0xA682, 'M', u'ꚃ'),\n (0xA683, 'V'),\n (0xA684, 'M', u'ꚅ'),\n (0xA685, 'V'),\n (0xA686, 'M', u'ꚇ'),\n (0xA687, 'V'),\n (0xA688, 'M', u'ꚉ'),\n (0xA689, 'V'),\n (0xA68A, 'M', u'ꚋ'),\n (0xA68B, 'V'),\n (0xA68C, 'M', u'ꚍ'),\n (0xA68D, 'V'),\n (0xA68E, 'M', u'ꚏ'),\n (0xA68F, 'V'),\n (0xA690, 'M', u'ꚑ'),\n (0xA691, 'V'),\n (0xA692, 'M', u'ꚓ'),\n (0xA693, 'V'),\n (0xA694, 'M', u'ꚕ'),\n (0xA695, 'V'),\n (0xA696, 'M', u'ꚗ'),\n (0xA697, 'V'),\n (0xA698, 'M', u'ꚙ'),\n (0xA699, 'V'),\n (0xA69A, 'M', u'ꚛ'),\n (0xA69B, 'V'),\n (0xA69C, 'M', u'ъ'),\n (0xA69D, 'M', u'ь'),\n (0xA69E, 'V'),\n (0xA6F8, 'X'),\n ]\n\ndef _seg_36():\n return [\n (0xA700, 'V'),\n (0xA722, 'M', u'ꜣ'),\n (0xA723, 'V'),\n (0xA724, 'M', u'ꜥ'),\n (0xA725, 'V'),\n (0xA726, 'M', u'ꜧ'),\n (0xA727, 'V'),\n (0xA728, 'M', u'ꜩ'),\n (0xA729, 'V'),\n (0xA72A, 'M', u'ꜫ'),\n (0xA72B, 'V'),\n (0xA72C, 'M', u'ꜭ'),\n (0xA72D, 'V'),\n (0xA72E, 'M', u'ꜯ'),\n (0xA72F, 'V'),\n (0xA732, 'M', u'ꜳ'),\n (0xA733, 'V'),\n (0xA734, 'M', u'ꜵ'),\n (0xA735, 'V'),\n (0xA736, 'M', u'ꜷ'),\n (0xA737, 'V'),\n (0xA738, 'M', u'ꜹ'),\n (0xA739, 'V'),\n (0xA73A, 'M', u'ꜻ'),\n (0xA73B, 'V'),\n (0xA73C, 'M', u'ꜽ'),\n (0xA73D, 'V'),\n (0xA73E, 'M', u'ꜿ'),\n (0xA73F, 'V'),\n (0xA740, 'M', u'ꝁ'),\n (0xA741, 'V'),\n (0xA742, 'M', u'ꝃ'),\n (0xA743, 'V'),\n (0xA744, 'M', u'ꝅ'),\n (0xA745, 'V'),\n (0xA746, 'M', u'ꝇ'),\n (0xA747, 'V'),\n (0xA748, 'M', u'ꝉ'),\n (0xA749, 'V'),\n (0xA74A, 'M', u'ꝋ'),\n (0xA74B, 'V'),\n (0xA74C, 'M', u'ꝍ'),\n (0xA74D, 'V'),\n (0xA74E, 'M', u'ꝏ'),\n (0xA74F, 'V'),\n (0xA750, 'M', u'ꝑ'),\n (0xA751, 'V'),\n (0xA752, 'M', u'ꝓ'),\n (0xA753, 'V'),\n (0xA754, 'M', u'ꝕ'),\n (0xA755, 'V'),\n (0xA756, 'M', u'ꝗ'),\n (0xA757, 'V'),\n (0xA758, 'M', u'ꝙ'),\n (0xA759, 'V'),\n (0xA75A, 'M', u'ꝛ'),\n (0xA75B, 'V'),\n (0xA75C, 'M', u'ꝝ'),\n (0xA75D, 'V'),\n (0xA75E, 'M', u'ꝟ'),\n (0xA75F, 'V'),\n (0xA760, 'M', u'ꝡ'),\n (0xA761, 'V'),\n (0xA762, 'M', u'ꝣ'),\n (0xA763, 'V'),\n (0xA764, 'M', u'ꝥ'),\n (0xA765, 'V'),\n (0xA766, 'M', u'ꝧ'),\n (0xA767, 'V'),\n (0xA768, 'M', u'ꝩ'),\n (0xA769, 'V'),\n (0xA76A, 'M', u'ꝫ'),\n (0xA76B, 'V'),\n (0xA76C, 'M', u'ꝭ'),\n (0xA76D, 'V'),\n (0xA76E, 'M', u'ꝯ'),\n (0xA76F, 'V'),\n (0xA770, 'M', u'ꝯ'),\n (0xA771, 'V'),\n (0xA779, 'M', u'ꝺ'),\n (0xA77A, 'V'),\n (0xA77B, 'M', u'ꝼ'),\n (0xA77C, 'V'),\n (0xA77D, 'M', u'ᵹ'),\n (0xA77E, 'M', u'ꝿ'),\n (0xA77F, 'V'),\n (0xA780, 'M', u'ꞁ'),\n (0xA781, 'V'),\n (0xA782, 'M', u'ꞃ'),\n (0xA783, 'V'),\n (0xA784, 'M', u'ꞅ'),\n (0xA785, 'V'),\n (0xA786, 'M', u'ꞇ'),\n (0xA787, 'V'),\n (0xA78B, 'M', u'ꞌ'),\n (0xA78C, 'V'),\n (0xA78D, 'M', u'ɥ'),\n (0xA78E, 'V'),\n (0xA790, 'M', u'ꞑ'),\n (0xA791, 'V'),\n ]\n\ndef _seg_37():\n return [\n (0xA792, 'M', u'ꞓ'),\n (0xA793, 'V'),\n (0xA796, 'M', u'ꞗ'),\n (0xA797, 'V'),\n (0xA798, 'M', u'ꞙ'),\n (0xA799, 'V'),\n (0xA79A, 'M', u'ꞛ'),\n (0xA79B, 'V'),\n (0xA79C, 'M', u'ꞝ'),\n (0xA79D, 'V'),\n (0xA79E, 'M', u'ꞟ'),\n (0xA79F, 'V'),\n (0xA7A0, 'M', u'ꞡ'),\n (0xA7A1, 'V'),\n (0xA7A2, 'M', u'ꞣ'),\n (0xA7A3, 'V'),\n (0xA7A4, 'M', u'ꞥ'),\n (0xA7A5, 'V'),\n (0xA7A6, 'M', u'ꞧ'),\n (0xA7A7, 'V'),\n (0xA7A8, 'M', u'ꞩ'),\n (0xA7A9, 'V'),\n (0xA7AA, 'M', u'ɦ'),\n (0xA7AB, 'M', u'ɜ'),\n (0xA7AC, 'M', u'ɡ'),\n (0xA7AD, 'M', u'ɬ'),\n (0xA7AE, 'M', u'ɪ'),\n (0xA7AF, 'V'),\n (0xA7B0, 'M', u'ʞ'),\n (0xA7B1, 'M', u'ʇ'),\n (0xA7B2, 'M', u'ʝ'),\n (0xA7B3, 'M', u'ꭓ'),\n (0xA7B4, 'M', u'ꞵ'),\n (0xA7B5, 'V'),\n (0xA7B6, 'M', u'ꞷ'),\n (0xA7B7, 'V'),\n (0xA7B8, 'X'),\n (0xA7B9, 'V'),\n (0xA7BA, 'X'),\n (0xA7F7, 'V'),\n (0xA7F8, 'M', u'ħ'),\n (0xA7F9, 'M', u'œ'),\n (0xA7FA, 'V'),\n (0xA82C, 'X'),\n (0xA830, 'V'),\n (0xA83A, 'X'),\n (0xA840, 'V'),\n (0xA878, 'X'),\n (0xA880, 'V'),\n (0xA8C6, 'X'),\n (0xA8CE, 'V'),\n (0xA8DA, 'X'),\n (0xA8E0, 'V'),\n (0xA954, 'X'),\n (0xA95F, 'V'),\n (0xA97D, 'X'),\n (0xA980, 'V'),\n (0xA9CE, 'X'),\n (0xA9CF, 'V'),\n (0xA9DA, 'X'),\n (0xA9DE, 'V'),\n (0xA9FF, 'X'),\n (0xAA00, 'V'),\n (0xAA37, 'X'),\n (0xAA40, 'V'),\n (0xAA4E, 'X'),\n (0xAA50, 'V'),\n (0xAA5A, 'X'),\n (0xAA5C, 'V'),\n (0xAAC3, 'X'),\n (0xAADB, 'V'),\n (0xAAF7, 'X'),\n (0xAB01, 'V'),\n (0xAB07, 'X'),\n (0xAB09, 'V'),\n (0xAB0F, 'X'),\n (0xAB11, 'V'),\n (0xAB17, 'X'),\n (0xAB20, 'V'),\n (0xAB27, 'X'),\n (0xAB28, 'V'),\n (0xAB2F, 'X'),\n (0xAB30, 'V'),\n (0xAB5C, 'M', u'ꜧ'),\n (0xAB5D, 'M', u'ꬷ'),\n (0xAB5E, 'M', u'ɫ'),\n (0xAB5F, 'M', u'ꭒ'),\n (0xAB60, 'V'),\n (0xAB66, 'X'),\n (0xAB70, 'M', u'Ꭰ'),\n (0xAB71, 'M', u'Ꭱ'),\n (0xAB72, 'M', u'Ꭲ'),\n (0xAB73, 'M', u'Ꭳ'),\n (0xAB74, 'M', u'Ꭴ'),\n (0xAB75, 'M', u'Ꭵ'),\n (0xAB76, 'M', u'Ꭶ'),\n (0xAB77, 'M', u'Ꭷ'),\n (0xAB78, 'M', u'Ꭸ'),\n (0xAB79, 'M', u'Ꭹ'),\n (0xAB7A, 'M', u'Ꭺ'),\n ]\n\ndef _seg_38():\n return [\n (0xAB7B, 'M', u'Ꭻ'),\n (0xAB7C, 'M', u'Ꭼ'),\n (0xAB7D, 'M', u'Ꭽ'),\n (0xAB7E, 'M', u'Ꭾ'),\n (0xAB7F, 'M', u'Ꭿ'),\n (0xAB80, 'M', u'Ꮀ'),\n (0xAB81, 'M', u'Ꮁ'),\n (0xAB82, 'M', u'Ꮂ'),\n (0xAB83, 'M', u'Ꮃ'),\n (0xAB84, 'M', u'Ꮄ'),\n (0xAB85, 'M', u'Ꮅ'),\n (0xAB86, 'M', u'Ꮆ'),\n (0xAB87, 'M', u'Ꮇ'),\n (0xAB88, 'M', u'Ꮈ'),\n (0xAB89, 'M', u'Ꮉ'),\n (0xAB8A, 'M', u'Ꮊ'),\n (0xAB8B, 'M', u'Ꮋ'),\n (0xAB8C, 'M', u'Ꮌ'),\n (0xAB8D, 'M', u'Ꮍ'),\n (0xAB8E, 'M', u'Ꮎ'),\n (0xAB8F, 'M', u'Ꮏ'),\n (0xAB90, 'M', u'Ꮐ'),\n (0xAB91, 'M', u'Ꮑ'),\n (0xAB92, 'M', u'Ꮒ'),\n (0xAB93, 'M', u'Ꮓ'),\n (0xAB94, 'M', u'Ꮔ'),\n (0xAB95, 'M', u'Ꮕ'),\n (0xAB96, 'M', u'Ꮖ'),\n (0xAB97, 'M', u'Ꮗ'),\n (0xAB98, 'M', u'Ꮘ'),\n (0xAB99, 'M', u'Ꮙ'),\n (0xAB9A, 'M', u'Ꮚ'),\n (0xAB9B, 'M', u'Ꮛ'),\n (0xAB9C, 'M', u'Ꮜ'),\n (0xAB9D, 'M', u'Ꮝ'),\n (0xAB9E, 'M', u'Ꮞ'),\n (0xAB9F, 'M', u'Ꮟ'),\n (0xABA0, 'M', u'Ꮠ'),\n (0xABA1, 'M', u'Ꮡ'),\n (0xABA2, 'M', u'Ꮢ'),\n (0xABA3, 'M', u'Ꮣ'),\n (0xABA4, 'M', u'Ꮤ'),\n (0xABA5, 'M', u'Ꮥ'),\n (0xABA6, 'M', u'Ꮦ'),\n (0xABA7, 'M', u'Ꮧ'),\n (0xABA8, 'M', u'Ꮨ'),\n (0xABA9, 'M', u'Ꮩ'),\n (0xABAA, 'M', u'Ꮪ'),\n (0xABAB, 'M', u'Ꮫ'),\n (0xABAC, 'M', u'Ꮬ'),\n (0xABAD, 'M', u'Ꮭ'),\n (0xABAE, 'M', u'Ꮮ'),\n (0xABAF, 'M', u'Ꮯ'),\n (0xABB0, 'M', u'Ꮰ'),\n (0xABB1, 'M', u'Ꮱ'),\n (0xABB2, 'M', u'Ꮲ'),\n (0xABB3, 'M', u'Ꮳ'),\n (0xABB4, 'M', u'Ꮴ'),\n (0xABB5, 'M', u'Ꮵ'),\n (0xABB6, 'M', u'Ꮶ'),\n (0xABB7, 'M', u'Ꮷ'),\n (0xABB8, 'M', u'Ꮸ'),\n (0xABB9, 'M', u'Ꮹ'),\n (0xABBA, 'M', u'Ꮺ'),\n (0xABBB, 'M', u'Ꮻ'),\n (0xABBC, 'M', u'Ꮼ'),\n (0xABBD, 'M', u'Ꮽ'),\n (0xABBE, 'M', u'Ꮾ'),\n (0xABBF, 'M', u'Ꮿ'),\n (0xABC0, 'V'),\n (0xABEE, 'X'),\n (0xABF0, 'V'),\n (0xABFA, 'X'),\n (0xAC00, 'V'),\n (0xD7A4, 'X'),\n (0xD7B0, 'V'),\n (0xD7C7, 'X'),\n (0xD7CB, 'V'),\n (0xD7FC, 'X'),\n (0xF900, 'M', u'豈'),\n (0xF901, 'M', u'更'),\n (0xF902, 'M', u'車'),\n (0xF903, 'M', u'賈'),\n (0xF904, 'M', u'滑'),\n (0xF905, 'M', u'串'),\n (0xF906, 'M', u'句'),\n (0xF907, 'M', u'龜'),\n (0xF909, 'M', u'契'),\n (0xF90A, 'M', u'金'),\n (0xF90B, 'M', u'喇'),\n (0xF90C, 'M', u'奈'),\n (0xF90D, 'M', u'懶'),\n (0xF90E, 'M', u'癩'),\n (0xF90F, 'M', u'羅'),\n (0xF910, 'M', u'蘿'),\n (0xF911, 'M', u'螺'),\n (0xF912, 'M', u'裸'),\n (0xF913, 'M', u'邏'),\n (0xF914, 'M', u'樂'),\n (0xF915, 'M', u'洛'),\n ]\n\ndef _seg_39():\n return [\n (0xF916, 'M', u'烙'),\n (0xF917, 'M', u'珞'),\n (0xF918, 'M', u'落'),\n (0xF919, 'M', u'酪'),\n (0xF91A, 'M', u'駱'),\n (0xF91B, 'M', u'亂'),\n (0xF91C, 'M', u'卵'),\n (0xF91D, 'M', u'欄'),\n (0xF91E, 'M', u'爛'),\n (0xF91F, 'M', u'蘭'),\n (0xF920, 'M', u'鸞'),\n (0xF921, 'M', u'嵐'),\n (0xF922, 'M', u'濫'),\n (0xF923, 'M', u'藍'),\n (0xF924, 'M', u'襤'),\n (0xF925, 'M', u'拉'),\n (0xF926, 'M', u'臘'),\n (0xF927, 'M', u'蠟'),\n (0xF928, 'M', u'廊'),\n (0xF929, 'M', u'朗'),\n (0xF92A, 'M', u'浪'),\n (0xF92B, 'M', u'狼'),\n (0xF92C, 'M', u'郎'),\n (0xF92D, 'M', u'來'),\n (0xF92E, 'M', u'冷'),\n (0xF92F, 'M', u'勞'),\n (0xF930, 'M', u'擄'),\n (0xF931, 'M', u'櫓'),\n (0xF932, 'M', u'爐'),\n (0xF933, 'M', u'盧'),\n (0xF934, 'M', u'老'),\n (0xF935, 'M', u'蘆'),\n (0xF936, 'M', u'虜'),\n (0xF937, 'M', u'路'),\n (0xF938, 'M', u'露'),\n (0xF939, 'M', u'魯'),\n (0xF93A, 'M', u'鷺'),\n (0xF93B, 'M', u'碌'),\n (0xF93C, 'M', u'祿'),\n (0xF93D, 'M', u'綠'),\n (0xF93E, 'M', u'菉'),\n (0xF93F, 'M', u'錄'),\n (0xF940, 'M', u'鹿'),\n (0xF941, 'M', u'論'),\n (0xF942, 'M', u'壟'),\n (0xF943, 'M', u'弄'),\n (0xF944, 'M', u'籠'),\n (0xF945, 'M', u'聾'),\n (0xF946, 'M', u'牢'),\n (0xF947, 'M', u'磊'),\n (0xF948, 'M', u'賂'),\n (0xF949, 'M', u'雷'),\n (0xF94A, 'M', u'壘'),\n (0xF94B, 'M', u'屢'),\n (0xF94C, 'M', u'樓'),\n (0xF94D, 'M', u'淚'),\n (0xF94E, 'M', u'漏'),\n (0xF94F, 'M', u'累'),\n (0xF950, 'M', u'縷'),\n (0xF951, 'M', u'陋'),\n (0xF952, 'M', u'勒'),\n (0xF953, 'M', u'肋'),\n (0xF954, 'M', u'凜'),\n (0xF955, 'M', u'凌'),\n (0xF956, 'M', u'稜'),\n (0xF957, 'M', u'綾'),\n (0xF958, 'M', u'菱'),\n (0xF959, 'M', u'陵'),\n (0xF95A, 'M', u'讀'),\n (0xF95B, 'M', u'拏'),\n (0xF95C, 'M', u'樂'),\n (0xF95D, 'M', u'諾'),\n (0xF95E, 'M', u'丹'),\n (0xF95F, 'M', u'寧'),\n (0xF960, 'M', u'怒'),\n (0xF961, 'M', u'率'),\n (0xF962, 'M', u'異'),\n (0xF963, 'M', u'北'),\n (0xF964, 'M', u'磻'),\n (0xF965, 'M', u'便'),\n (0xF966, 'M', u'復'),\n (0xF967, 'M', u'不'),\n (0xF968, 'M', u'泌'),\n (0xF969, 'M', u'數'),\n (0xF96A, 'M', u'索'),\n (0xF96B, 'M', u'參'),\n (0xF96C, 'M', u'塞'),\n (0xF96D, 'M', u'省'),\n (0xF96E, 'M', u'葉'),\n (0xF96F, 'M', u'說'),\n (0xF970, 'M', u'殺'),\n (0xF971, 'M', u'辰'),\n (0xF972, 'M', u'沈'),\n (0xF973, 'M', u'拾'),\n (0xF974, 'M', u'若'),\n (0xF975, 'M', u'掠'),\n (0xF976, 'M', u'略'),\n (0xF977, 'M', u'亮'),\n (0xF978, 'M', u'兩'),\n (0xF979, 'M', u'凉'),\n ]\n\ndef _seg_40():\n return [\n (0xF97A, 'M', u'梁'),\n (0xF97B, 'M', u'糧'),\n (0xF97C, 'M', u'良'),\n (0xF97D, 'M', u'諒'),\n (0xF97E, 'M', u'量'),\n (0xF97F, 'M', u'勵'),\n (0xF980, 'M', u'呂'),\n (0xF981, 'M', u'女'),\n (0xF982, 'M', u'廬'),\n (0xF983, 'M', u'旅'),\n (0xF984, 'M', u'濾'),\n (0xF985, 'M', u'礪'),\n (0xF986, 'M', u'閭'),\n (0xF987, 'M', u'驪'),\n (0xF988, 'M', u'麗'),\n (0xF989, 'M', u'黎'),\n (0xF98A, 'M', u'力'),\n (0xF98B, 'M', u'曆'),\n (0xF98C, 'M', u'歷'),\n (0xF98D, 'M', u'轢'),\n (0xF98E, 'M', u'年'),\n (0xF98F, 'M', u'憐'),\n (0xF990, 'M', u'戀'),\n (0xF991, 'M', u'撚'),\n (0xF992, 'M', u'漣'),\n (0xF993, 'M', u'煉'),\n (0xF994, 'M', u'璉'),\n (0xF995, 'M', u'秊'),\n (0xF996, 'M', u'練'),\n (0xF997, 'M', u'聯'),\n (0xF998, 'M', u'輦'),\n (0xF999, 'M', u'蓮'),\n (0xF99A, 'M', u'連'),\n (0xF99B, 'M', u'鍊'),\n (0xF99C, 'M', u'列'),\n (0xF99D, 'M', u'劣'),\n (0xF99E, 'M', u'咽'),\n (0xF99F, 'M', u'烈'),\n (0xF9A0, 'M', u'裂'),\n (0xF9A1, 'M', u'說'),\n (0xF9A2, 'M', u'廉'),\n (0xF9A3, 'M', u'念'),\n (0xF9A4, 'M', u'捻'),\n (0xF9A5, 'M', u'殮'),\n (0xF9A6, 'M', u'簾'),\n (0xF9A7, 'M', u'獵'),\n (0xF9A8, 'M', u'令'),\n (0xF9A9, 'M', u'囹'),\n (0xF9AA, 'M', u'寧'),\n (0xF9AB, 'M', u'嶺'),\n (0xF9AC, 'M', u'怜'),\n (0xF9AD, 'M', u'玲'),\n (0xF9AE, 'M', u'瑩'),\n (0xF9AF, 'M', u'羚'),\n (0xF9B0, 'M', u'聆'),\n (0xF9B1, 'M', u'鈴'),\n (0xF9B2, 'M', u'零'),\n (0xF9B3, 'M', u'靈'),\n (0xF9B4, 'M', u'領'),\n (0xF9B5, 'M', u'例'),\n (0xF9B6, 'M', u'禮'),\n (0xF9B7, 'M', u'醴'),\n (0xF9B8, 'M', u'隸'),\n (0xF9B9, 'M', u'惡'),\n (0xF9BA, 'M', u'了'),\n (0xF9BB, 'M', u'僚'),\n (0xF9BC, 'M', u'寮'),\n (0xF9BD, 'M', u'尿'),\n (0xF9BE, 'M', u'料'),\n (0xF9BF, 'M', u'樂'),\n (0xF9C0, 'M', u'燎'),\n (0xF9C1, 'M', u'療'),\n (0xF9C2, 'M', u'蓼'),\n (0xF9C3, 'M', u'遼'),\n (0xF9C4, 'M', u'龍'),\n (0xF9C5, 'M', u'暈'),\n (0xF9C6, 'M', u'阮'),\n (0xF9C7, 'M', u'劉'),\n (0xF9C8, 'M', u'杻'),\n (0xF9C9, 'M', u'柳'),\n (0xF9CA, 'M', u'流'),\n (0xF9CB, 'M', u'溜'),\n (0xF9CC, 'M', u'琉'),\n (0xF9CD, 'M', u'留'),\n (0xF9CE, 'M', u'硫'),\n (0xF9CF, 'M', u'紐'),\n (0xF9D0, 'M', u'類'),\n (0xF9D1, 'M', u'六'),\n (0xF9D2, 'M', u'戮'),\n (0xF9D3, 'M', u'陸'),\n (0xF9D4, 'M', u'倫'),\n (0xF9D5, 'M', u'崙'),\n (0xF9D6, 'M', u'淪'),\n (0xF9D7, 'M', u'輪'),\n (0xF9D8, 'M', u'律'),\n (0xF9D9, 'M', u'慄'),\n (0xF9DA, 'M', u'栗'),\n (0xF9DB, 'M', u'率'),\n (0xF9DC, 'M', u'隆'),\n (0xF9DD, 'M', u'利'),\n ]\n\ndef _seg_41():\n return [\n (0xF9DE, 'M', u'吏'),\n (0xF9DF, 'M', u'履'),\n (0xF9E0, 'M', u'易'),\n (0xF9E1, 'M', u'李'),\n (0xF9E2, 'M', u'梨'),\n (0xF9E3, 'M', u'泥'),\n (0xF9E4, 'M', u'理'),\n (0xF9E5, 'M', u'痢'),\n (0xF9E6, 'M', u'罹'),\n (0xF9E7, 'M', u'裏'),\n (0xF9E8, 'M', u'裡'),\n (0xF9E9, 'M', u'里'),\n (0xF9EA, 'M', u'離'),\n (0xF9EB, 'M', u'匿'),\n (0xF9EC, 'M', u'溺'),\n (0xF9ED, 'M', u'吝'),\n (0xF9EE, 'M', u'燐'),\n (0xF9EF, 'M', u'璘'),\n (0xF9F0, 'M', u'藺'),\n (0xF9F1, 'M', u'隣'),\n (0xF9F2, 'M', u'鱗'),\n (0xF9F3, 'M', u'麟'),\n (0xF9F4, 'M', u'林'),\n (0xF9F5, 'M', u'淋'),\n (0xF9F6, 'M', u'臨'),\n (0xF9F7, 'M', u'立'),\n (0xF9F8, 'M', u'笠'),\n (0xF9F9, 'M', u'粒'),\n (0xF9FA, 'M', u'狀'),\n (0xF9FB, 'M', u'炙'),\n (0xF9FC, 'M', u'識'),\n (0xF9FD, 'M', u'什'),\n (0xF9FE, 'M', u'茶'),\n (0xF9FF, 'M', u'刺'),\n (0xFA00, 'M', u'切'),\n (0xFA01, 'M', u'度'),\n (0xFA02, 'M', u'拓'),\n (0xFA03, 'M', u'糖'),\n (0xFA04, 'M', u'宅'),\n (0xFA05, 'M', u'洞'),\n (0xFA06, 'M', u'暴'),\n (0xFA07, 'M', u'輻'),\n (0xFA08, 'M', u'行'),\n (0xFA09, 'M', u'降'),\n (0xFA0A, 'M', u'見'),\n (0xFA0B, 'M', u'廓'),\n (0xFA0C, 'M', u'兀'),\n (0xFA0D, 'M', u'嗀'),\n (0xFA0E, 'V'),\n (0xFA10, 'M', u'塚'),\n (0xFA11, 'V'),\n (0xFA12, 'M', u'晴'),\n (0xFA13, 'V'),\n (0xFA15, 'M', u'凞'),\n (0xFA16, 'M', u'猪'),\n (0xFA17, 'M', u'益'),\n (0xFA18, 'M', u'礼'),\n (0xFA19, 'M', u'神'),\n (0xFA1A, 'M', u'祥'),\n (0xFA1B, 'M', u'福'),\n (0xFA1C, 'M', u'靖'),\n (0xFA1D, 'M', u'精'),\n (0xFA1E, 'M', u'羽'),\n (0xFA1F, 'V'),\n (0xFA20, 'M', u'蘒'),\n (0xFA21, 'V'),\n (0xFA22, 'M', u'諸'),\n (0xFA23, 'V'),\n (0xFA25, 'M', u'逸'),\n (0xFA26, 'M', u'都'),\n (0xFA27, 'V'),\n (0xFA2A, 'M', u'飯'),\n (0xFA2B, 'M', u'飼'),\n (0xFA2C, 'M', u'館'),\n (0xFA2D, 'M', u'鶴'),\n (0xFA2E, 'M', u'郞'),\n (0xFA2F, 'M', u'隷'),\n (0xFA30, 'M', u'侮'),\n (0xFA31, 'M', u'僧'),\n (0xFA32, 'M', u'免'),\n (0xFA33, 'M', u'勉'),\n (0xFA34, 'M', u'勤'),\n (0xFA35, 'M', u'卑'),\n (0xFA36, 'M', u'喝'),\n (0xFA37, 'M', u'嘆'),\n (0xFA38, 'M', u'器'),\n (0xFA39, 'M', u'塀'),\n (0xFA3A, 'M', u'墨'),\n (0xFA3B, 'M', u'層'),\n (0xFA3C, 'M', u'屮'),\n (0xFA3D, 'M', u'悔'),\n (0xFA3E, 'M', u'慨'),\n (0xFA3F, 'M', u'憎'),\n (0xFA40, 'M', u'懲'),\n (0xFA41, 'M', u'敏'),\n (0xFA42, 'M', u'既'),\n (0xFA43, 'M', u'暑'),\n (0xFA44, 'M', u'梅'),\n (0xFA45, 'M', u'海'),\n (0xFA46, 'M', u'渚'),\n ]\n\ndef _seg_42():\n return [\n (0xFA47, 'M', u'漢'),\n (0xFA48, 'M', u'煮'),\n (0xFA49, 'M', u'爫'),\n (0xFA4A, 'M', u'琢'),\n (0xFA4B, 'M', u'碑'),\n (0xFA4C, 'M', u'社'),\n (0xFA4D, 'M', u'祉'),\n (0xFA4E, 'M', u'祈'),\n (0xFA4F, 'M', u'祐'),\n (0xFA50, 'M', u'祖'),\n (0xFA51, 'M', u'祝'),\n (0xFA52, 'M', u'禍'),\n (0xFA53, 'M', u'禎'),\n (0xFA54, 'M', u'穀'),\n (0xFA55, 'M', u'突'),\n (0xFA56, 'M', u'節'),\n (0xFA57, 'M', u'練'),\n (0xFA58, 'M', u'縉'),\n (0xFA59, 'M', u'繁'),\n (0xFA5A, 'M', u'署'),\n (0xFA5B, 'M', u'者'),\n (0xFA5C, 'M', u'臭'),\n (0xFA5D, 'M', u'艹'),\n (0xFA5F, 'M', u'著'),\n (0xFA60, 'M', u'褐'),\n (0xFA61, 'M', u'視'),\n (0xFA62, 'M', u'謁'),\n (0xFA63, 'M', u'謹'),\n (0xFA64, 'M', u'賓'),\n (0xFA65, 'M', u'贈'),\n (0xFA66, 'M', u'辶'),\n (0xFA67, 'M', u'逸'),\n (0xFA68, 'M', u'難'),\n (0xFA69, 'M', u'響'),\n (0xFA6A, 'M', u'頻'),\n (0xFA6B, 'M', u'恵'),\n (0xFA6C, 'M', u'𤋮'),\n (0xFA6D, 'M', u'舘'),\n (0xFA6E, 'X'),\n (0xFA70, 'M', u'並'),\n (0xFA71, 'M', u'况'),\n (0xFA72, 'M', u'全'),\n (0xFA73, 'M', u'侀'),\n (0xFA74, 'M', u'充'),\n (0xFA75, 'M', u'冀'),\n (0xFA76, 'M', u'勇'),\n (0xFA77, 'M', u'勺'),\n (0xFA78, 'M', u'喝'),\n (0xFA79, 'M', u'啕'),\n (0xFA7A, 'M', u'喙'),\n (0xFA7B, 'M', u'嗢'),\n (0xFA7C, 'M', u'塚'),\n (0xFA7D, 'M', u'墳'),\n (0xFA7E, 'M', u'奄'),\n (0xFA7F, 'M', u'奔'),\n (0xFA80, 'M', u'婢'),\n (0xFA81, 'M', u'嬨'),\n (0xFA82, 'M', u'廒'),\n (0xFA83, 'M', u'廙'),\n (0xFA84, 'M', u'彩'),\n (0xFA85, 'M', u'徭'),\n (0xFA86, 'M', u'惘'),\n (0xFA87, 'M', u'慎'),\n (0xFA88, 'M', u'愈'),\n (0xFA89, 'M', u'憎'),\n (0xFA8A, 'M', u'慠'),\n (0xFA8B, 'M', u'懲'),\n (0xFA8C, 'M', u'戴'),\n (0xFA8D, 'M', u'揄'),\n (0xFA8E, 'M', u'搜'),\n (0xFA8F, 'M', u'摒'),\n (0xFA90, 'M', u'敖'),\n (0xFA91, 'M', u'晴'),\n (0xFA92, 'M', u'朗'),\n (0xFA93, 'M', u'望'),\n (0xFA94, 'M', u'杖'),\n (0xFA95, 'M', u'歹'),\n (0xFA96, 'M', u'殺'),\n (0xFA97, 'M', u'流'),\n (0xFA98, 'M', u'滛'),\n (0xFA99, 'M', u'滋'),\n (0xFA9A, 'M', u'漢'),\n (0xFA9B, 'M', u'瀞'),\n (0xFA9C, 'M', u'煮'),\n (0xFA9D, 'M', u'瞧'),\n (0xFA9E, 'M', u'爵'),\n (0xFA9F, 'M', u'犯'),\n (0xFAA0, 'M', u'猪'),\n (0xFAA1, 'M', u'瑱'),\n (0xFAA2, 'M', u'甆'),\n (0xFAA3, 'M', u'画'),\n (0xFAA4, 'M', u'瘝'),\n (0xFAA5, 'M', u'瘟'),\n (0xFAA6, 'M', u'益'),\n (0xFAA7, 'M', u'盛'),\n (0xFAA8, 'M', u'直'),\n (0xFAA9, 'M', u'睊'),\n (0xFAAA, 'M', u'着'),\n (0xFAAB, 'M', u'磌'),\n (0xFAAC, 'M', u'窱'),\n ]\n\ndef _seg_43():\n return [\n (0xFAAD, 'M', u'節'),\n (0xFAAE, 'M', u'类'),\n (0xFAAF, 'M', u'絛'),\n (0xFAB0, 'M', u'練'),\n (0xFAB1, 'M', u'缾'),\n (0xFAB2, 'M', u'者'),\n (0xFAB3, 'M', u'荒'),\n (0xFAB4, 'M', u'華'),\n (0xFAB5, 'M', u'蝹'),\n (0xFAB6, 'M', u'襁'),\n (0xFAB7, 'M', u'覆'),\n (0xFAB8, 'M', u'視'),\n (0xFAB9, 'M', u'調'),\n (0xFABA, 'M', u'諸'),\n (0xFABB, 'M', u'請'),\n (0xFABC, 'M', u'謁'),\n (0xFABD, 'M', u'諾'),\n (0xFABE, 'M', u'諭'),\n (0xFABF, 'M', u'謹'),\n (0xFAC0, 'M', u'變'),\n (0xFAC1, 'M', u'贈'),\n (0xFAC2, 'M', u'輸'),\n (0xFAC3, 'M', u'遲'),\n (0xFAC4, 'M', u'醙'),\n (0xFAC5, 'M', u'鉶'),\n (0xFAC6, 'M', u'陼'),\n (0xFAC7, 'M', u'難'),\n (0xFAC8, 'M', u'靖'),\n (0xFAC9, 'M', u'韛'),\n (0xFACA, 'M', u'響'),\n (0xFACB, 'M', u'頋'),\n (0xFACC, 'M', u'頻'),\n (0xFACD, 'M', u'鬒'),\n (0xFACE, 'M', u'龜'),\n (0xFACF, 'M', u'𢡊'),\n (0xFAD0, 'M', u'𢡄'),\n (0xFAD1, 'M', u'𣏕'),\n (0xFAD2, 'M', u'㮝'),\n (0xFAD3, 'M', u'䀘'),\n (0xFAD4, 'M', u'䀹'),\n (0xFAD5, 'M', u'𥉉'),\n (0xFAD6, 'M', u'𥳐'),\n (0xFAD7, 'M', u'𧻓'),\n (0xFAD8, 'M', u'齃'),\n (0xFAD9, 'M', u'龎'),\n (0xFADA, 'X'),\n (0xFB00, 'M', u'ff'),\n (0xFB01, 'M', u'fi'),\n (0xFB02, 'M', u'fl'),\n (0xFB03, 'M', u'ffi'),\n (0xFB04, 'M', u'ffl'),\n (0xFB05, 'M', u'st'),\n (0xFB07, 'X'),\n (0xFB13, 'M', u'մն'),\n (0xFB14, 'M', u'մե'),\n (0xFB15, 'M', u'մի'),\n (0xFB16, 'M', u'վն'),\n (0xFB17, 'M', u'մխ'),\n (0xFB18, 'X'),\n (0xFB1D, 'M', u'יִ'),\n (0xFB1E, 'V'),\n (0xFB1F, 'M', u'ײַ'),\n (0xFB20, 'M', u'ע'),\n (0xFB21, 'M', u'א'),\n (0xFB22, 'M', u'ד'),\n (0xFB23, 'M', u'ה'),\n (0xFB24, 'M', u'כ'),\n (0xFB25, 'M', u'ל'),\n (0xFB26, 'M', u'ם'),\n (0xFB27, 'M', u'ר'),\n (0xFB28, 'M', u'ת'),\n (0xFB29, '3', u'+'),\n (0xFB2A, 'M', u'שׁ'),\n (0xFB2B, 'M', u'שׂ'),\n (0xFB2C, 'M', u'שּׁ'),\n (0xFB2D, 'M', u'שּׂ'),\n (0xFB2E, 'M', u'אַ'),\n (0xFB2F, 'M', u'אָ'),\n (0xFB30, 'M', u'אּ'),\n (0xFB31, 'M', u'בּ'),\n (0xFB32, 'M', u'גּ'),\n (0xFB33, 'M', u'דּ'),\n (0xFB34, 'M', u'הּ'),\n (0xFB35, 'M', u'וּ'),\n (0xFB36, 'M', u'זּ'),\n (0xFB37, 'X'),\n (0xFB38, 'M', u'טּ'),\n (0xFB39, 'M', u'יּ'),\n (0xFB3A, 'M', u'ךּ'),\n (0xFB3B, 'M', u'כּ'),\n (0xFB3C, 'M', u'לּ'),\n (0xFB3D, 'X'),\n (0xFB3E, 'M', u'מּ'),\n (0xFB3F, 'X'),\n (0xFB40, 'M', u'נּ'),\n (0xFB41, 'M', u'סּ'),\n (0xFB42, 'X'),\n (0xFB43, 'M', u'ףּ'),\n (0xFB44, 'M', u'פּ'),\n (0xFB45, 'X'),\n ]\n\ndef _seg_44():\n return [\n (0xFB46, 'M', u'צּ'),\n (0xFB47, 'M', u'קּ'),\n (0xFB48, 'M', u'רּ'),\n (0xFB49, 'M', u'שּ'),\n (0xFB4A, 'M', u'תּ'),\n (0xFB4B, 'M', u'וֹ'),\n (0xFB4C, 'M', u'בֿ'),\n (0xFB4D, 'M', u'כֿ'),\n (0xFB4E, 'M', u'פֿ'),\n (0xFB4F, 'M', u'אל'),\n (0xFB50, 'M', u'ٱ'),\n (0xFB52, 'M', u'ٻ'),\n (0xFB56, 'M', u'پ'),\n (0xFB5A, 'M', u'ڀ'),\n (0xFB5E, 'M', u'ٺ'),\n (0xFB62, 'M', u'ٿ'),\n (0xFB66, 'M', u'ٹ'),\n (0xFB6A, 'M', u'ڤ'),\n (0xFB6E, 'M', u'ڦ'),\n (0xFB72, 'M', u'ڄ'),\n (0xFB76, 'M', u'ڃ'),\n (0xFB7A, 'M', u'چ'),\n (0xFB7E, 'M', u'ڇ'),\n (0xFB82, 'M', u'ڍ'),\n (0xFB84, 'M', u'ڌ'),\n (0xFB86, 'M', u'ڎ'),\n (0xFB88, 'M', u'ڈ'),\n (0xFB8A, 'M', u'ژ'),\n (0xFB8C, 'M', u'ڑ'),\n (0xFB8E, 'M', u'ک'),\n (0xFB92, 'M', u'گ'),\n (0xFB96, 'M', u'ڳ'),\n (0xFB9A, 'M', u'ڱ'),\n (0xFB9E, 'M', u'ں'),\n (0xFBA0, 'M', u'ڻ'),\n (0xFBA4, 'M', u'ۀ'),\n (0xFBA6, 'M', u'ہ'),\n (0xFBAA, 'M', u'ھ'),\n (0xFBAE, 'M', u'ے'),\n (0xFBB0, 'M', u'ۓ'),\n (0xFBB2, 'V'),\n (0xFBC2, 'X'),\n (0xFBD3, 'M', u'ڭ'),\n (0xFBD7, 'M', u'ۇ'),\n (0xFBD9, 'M', u'ۆ'),\n (0xFBDB, 'M', u'ۈ'),\n (0xFBDD, 'M', u'ۇٴ'),\n (0xFBDE, 'M', u'ۋ'),\n (0xFBE0, 'M', u'ۅ'),\n (0xFBE2, 'M', u'ۉ'),\n (0xFBE4, 'M', u'ې'),\n (0xFBE8, 'M', u'ى'),\n (0xFBEA, 'M', u'ئا'),\n (0xFBEC, 'M', u'ئە'),\n (0xFBEE, 'M', u'ئو'),\n (0xFBF0, 'M', u'ئۇ'),\n (0xFBF2, 'M', u'ئۆ'),\n (0xFBF4, 'M', u'ئۈ'),\n (0xFBF6, 'M', u'ئې'),\n (0xFBF9, 'M', u'ئى'),\n (0xFBFC, 'M', u'ی'),\n (0xFC00, 'M', u'ئج'),\n (0xFC01, 'M', u'ئح'),\n (0xFC02, 'M', u'ئم'),\n (0xFC03, 'M', u'ئى'),\n (0xFC04, 'M', u'ئي'),\n (0xFC05, 'M', u'بج'),\n (0xFC06, 'M', u'بح'),\n (0xFC07, 'M', u'بخ'),\n (0xFC08, 'M', u'بم'),\n (0xFC09, 'M', u'بى'),\n (0xFC0A, 'M', u'بي'),\n (0xFC0B, 'M', u'تج'),\n (0xFC0C, 'M', u'تح'),\n (0xFC0D, 'M', u'تخ'),\n (0xFC0E, 'M', u'تم'),\n (0xFC0F, 'M', u'تى'),\n (0xFC10, 'M', u'تي'),\n (0xFC11, 'M', u'ثج'),\n (0xFC12, 'M', u'ثم'),\n (0xFC13, 'M', u'ثى'),\n (0xFC14, 'M', u'ثي'),\n (0xFC15, 'M', u'جح'),\n (0xFC16, 'M', u'جم'),\n (0xFC17, 'M', u'حج'),\n (0xFC18, 'M', u'حم'),\n (0xFC19, 'M', u'خج'),\n (0xFC1A, 'M', u'خح'),\n (0xFC1B, 'M', u'خم'),\n (0xFC1C, 'M', u'سج'),\n (0xFC1D, 'M', u'سح'),\n (0xFC1E, 'M', u'سخ'),\n (0xFC1F, 'M', u'سم'),\n (0xFC20, 'M', u'صح'),\n (0xFC21, 'M', u'صم'),\n (0xFC22, 'M', u'ضج'),\n (0xFC23, 'M', u'ضح'),\n (0xFC24, 'M', u'ضخ'),\n (0xFC25, 'M', u'ضم'),\n (0xFC26, 'M', u'طح'),\n ]\n\ndef _seg_45():\n return [\n (0xFC27, 'M', u'طم'),\n (0xFC28, 'M', u'ظم'),\n (0xFC29, 'M', u'عج'),\n (0xFC2A, 'M', u'عم'),\n (0xFC2B, 'M', u'غج'),\n (0xFC2C, 'M', u'غم'),\n (0xFC2D, 'M', u'فج'),\n (0xFC2E, 'M', u'فح'),\n (0xFC2F, 'M', u'فخ'),\n (0xFC30, 'M', u'فم'),\n (0xFC31, 'M', u'فى'),\n (0xFC32, 'M', u'في'),\n (0xFC33, 'M', u'قح'),\n (0xFC34, 'M', u'قم'),\n (0xFC35, 'M', u'قى'),\n (0xFC36, 'M', u'قي'),\n (0xFC37, 'M', u'كا'),\n (0xFC38, 'M', u'كج'),\n (0xFC39, 'M', u'كح'),\n (0xFC3A, 'M', u'كخ'),\n (0xFC3B, 'M', u'كل'),\n (0xFC3C, 'M', u'كم'),\n (0xFC3D, 'M', u'كى'),\n (0xFC3E, 'M', u'كي'),\n (0xFC3F, 'M', u'لج'),\n (0xFC40, 'M', u'لح'),\n (0xFC41, 'M', u'لخ'),\n (0xFC42, 'M', u'لم'),\n (0xFC43, 'M', u'لى'),\n (0xFC44, 'M', u'لي'),\n (0xFC45, 'M', u'مج'),\n (0xFC46, 'M', u'مح'),\n (0xFC47, 'M', u'مخ'),\n (0xFC48, 'M', u'مم'),\n (0xFC49, 'M', u'مى'),\n (0xFC4A, 'M', u'مي'),\n (0xFC4B, 'M', u'نج'),\n (0xFC4C, 'M', u'نح'),\n (0xFC4D, 'M', u'نخ'),\n (0xFC4E, 'M', u'نم'),\n (0xFC4F, 'M', u'نى'),\n (0xFC50, 'M', u'ني'),\n (0xFC51, 'M', u'هج'),\n (0xFC52, 'M', u'هم'),\n (0xFC53, 'M', u'هى'),\n (0xFC54, 'M', u'هي'),\n (0xFC55, 'M', u'يج'),\n (0xFC56, 'M', u'يح'),\n (0xFC57, 'M', u'يخ'),\n (0xFC58, 'M', u'يم'),\n (0xFC59, 'M', u'يى'),\n (0xFC5A, 'M', u'يي'),\n (0xFC5B, 'M', u'ذٰ'),\n (0xFC5C, 'M', u'رٰ'),\n (0xFC5D, 'M', u'ىٰ'),\n (0xFC5E, '3', u' ٌّ'),\n (0xFC5F, '3', u' ٍّ'),\n (0xFC60, '3', u' َّ'),\n (0xFC61, '3', u' ُّ'),\n (0xFC62, '3', u' ِّ'),\n (0xFC63, '3', u' ّٰ'),\n (0xFC64, 'M', u'ئر'),\n (0xFC65, 'M', u'ئز'),\n (0xFC66, 'M', u'ئم'),\n (0xFC67, 'M', u'ئن'),\n (0xFC68, 'M', u'ئى'),\n (0xFC69, 'M', u'ئي'),\n (0xFC6A, 'M', u'بر'),\n (0xFC6B, 'M', u'بز'),\n (0xFC6C, 'M', u'بم'),\n (0xFC6D, 'M', u'بن'),\n (0xFC6E, 'M', u'بى'),\n (0xFC6F, 'M', u'بي'),\n (0xFC70, 'M', u'تر'),\n (0xFC71, 'M', u'تز'),\n (0xFC72, 'M', u'تم'),\n (0xFC73, 'M', u'تن'),\n (0xFC74, 'M', u'تى'),\n (0xFC75, 'M', u'تي'),\n (0xFC76, 'M', u'ثر'),\n (0xFC77, 'M', u'ثز'),\n (0xFC78, 'M', u'ثم'),\n (0xFC79, 'M', u'ثن'),\n (0xFC7A, 'M', u'ثى'),\n (0xFC7B, 'M', u'ثي'),\n (0xFC7C, 'M', u'فى'),\n (0xFC7D, 'M', u'في'),\n (0xFC7E, 'M', u'قى'),\n (0xFC7F, 'M', u'قي'),\n (0xFC80, 'M', u'كا'),\n (0xFC81, 'M', u'كل'),\n (0xFC82, 'M', u'كم'),\n (0xFC83, 'M', u'كى'),\n (0xFC84, 'M', u'كي'),\n (0xFC85, 'M', u'لم'),\n (0xFC86, 'M', u'لى'),\n (0xFC87, 'M', u'لي'),\n (0xFC88, 'M', u'ما'),\n (0xFC89, 'M', u'مم'),\n (0xFC8A, 'M', u'نر'),\n ]\n\ndef _seg_46():\n return [\n (0xFC8B, 'M', u'نز'),\n (0xFC8C, 'M', u'نم'),\n (0xFC8D, 'M', u'نن'),\n (0xFC8E, 'M', u'نى'),\n (0xFC8F, 'M', u'ني'),\n (0xFC90, 'M', u'ىٰ'),\n (0xFC91, 'M', u'ير'),\n (0xFC92, 'M', u'يز'),\n (0xFC93, 'M', u'يم'),\n (0xFC94, 'M', u'ين'),\n (0xFC95, 'M', u'يى'),\n (0xFC96, 'M', u'يي'),\n (0xFC97, 'M', u'ئج'),\n (0xFC98, 'M', u'ئح'),\n (0xFC99, 'M', u'ئخ'),\n (0xFC9A, 'M', u'ئم'),\n (0xFC9B, 'M', u'ئه'),\n (0xFC9C, 'M', u'بج'),\n (0xFC9D, 'M', u'بح'),\n (0xFC9E, 'M', u'بخ'),\n (0xFC9F, 'M', u'بم'),\n (0xFCA0, 'M', u'به'),\n (0xFCA1, 'M', u'تج'),\n (0xFCA2, 'M', u'تح'),\n (0xFCA3, 'M', u'تخ'),\n (0xFCA4, 'M', u'تم'),\n (0xFCA5, 'M', u'ته'),\n (0xFCA6, 'M', u'ثم'),\n (0xFCA7, 'M', u'جح'),\n (0xFCA8, 'M', u'جم'),\n (0xFCA9, 'M', u'حج'),\n (0xFCAA, 'M', u'حم'),\n (0xFCAB, 'M', u'خج'),\n (0xFCAC, 'M', u'خم'),\n (0xFCAD, 'M', u'سج'),\n (0xFCAE, 'M', u'سح'),\n (0xFCAF, 'M', u'سخ'),\n (0xFCB0, 'M', u'سم'),\n (0xFCB1, 'M', u'صح'),\n (0xFCB2, 'M', u'صخ'),\n (0xFCB3, 'M', u'صم'),\n (0xFCB4, 'M', u'ضج'),\n (0xFCB5, 'M', u'ضح'),\n (0xFCB6, 'M', u'ضخ'),\n (0xFCB7, 'M', u'ضم'),\n (0xFCB8, 'M', u'طح'),\n (0xFCB9, 'M', u'ظم'),\n (0xFCBA, 'M', u'عج'),\n (0xFCBB, 'M', u'عم'),\n (0xFCBC, 'M', u'غج'),\n (0xFCBD, 'M', u'غم'),\n (0xFCBE, 'M', u'فج'),\n (0xFCBF, 'M', u'فح'),\n (0xFCC0, 'M', u'فخ'),\n (0xFCC1, 'M', u'فم'),\n (0xFCC2, 'M', u'قح'),\n (0xFCC3, 'M', u'قم'),\n (0xFCC4, 'M', u'كج'),\n (0xFCC5, 'M', u'كح'),\n (0xFCC6, 'M', u'كخ'),\n (0xFCC7, 'M', u'كل'),\n (0xFCC8, 'M', u'كم'),\n (0xFCC9, 'M', u'لج'),\n (0xFCCA, 'M', u'لح'),\n (0xFCCB, 'M', u'لخ'),\n (0xFCCC, 'M', u'لم'),\n (0xFCCD, 'M', u'له'),\n (0xFCCE, 'M', u'مج'),\n (0xFCCF, 'M', u'مح'),\n (0xFCD0, 'M', u'مخ'),\n (0xFCD1, 'M', u'مم'),\n (0xFCD2, 'M', u'نج'),\n (0xFCD3, 'M', u'نح'),\n (0xFCD4, 'M', u'نخ'),\n (0xFCD5, 'M', u'نم'),\n (0xFCD6, 'M', u'نه'),\n (0xFCD7, 'M', u'هج'),\n (0xFCD8, 'M', u'هم'),\n (0xFCD9, 'M', u'هٰ'),\n (0xFCDA, 'M', u'يج'),\n (0xFCDB, 'M', u'يح'),\n (0xFCDC, 'M', u'يخ'),\n (0xFCDD, 'M', u'يم'),\n (0xFCDE, 'M', u'يه'),\n (0xFCDF, 'M', u'ئم'),\n (0xFCE0, 'M', u'ئه'),\n (0xFCE1, 'M', u'بم'),\n (0xFCE2, 'M', u'به'),\n (0xFCE3, 'M', u'تم'),\n (0xFCE4, 'M', u'ته'),\n (0xFCE5, 'M', u'ثم'),\n (0xFCE6, 'M', u'ثه'),\n (0xFCE7, 'M', u'سم'),\n (0xFCE8, 'M', u'سه'),\n (0xFCE9, 'M', u'شم'),\n (0xFCEA, 'M', u'شه'),\n (0xFCEB, 'M', u'كل'),\n (0xFCEC, 'M', u'كم'),\n (0xFCED, 'M', u'لم'),\n (0xFCEE, 'M', u'نم'),\n ]\n\ndef _seg_47():\n return [\n (0xFCEF, 'M', u'نه'),\n (0xFCF0, 'M', u'يم'),\n (0xFCF1, 'M', u'يه'),\n (0xFCF2, 'M', u'ـَّ'),\n (0xFCF3, 'M', u'ـُّ'),\n (0xFCF4, 'M', u'ـِّ'),\n (0xFCF5, 'M', u'طى'),\n (0xFCF6, 'M', u'طي'),\n (0xFCF7, 'M', u'عى'),\n (0xFCF8, 'M', u'عي'),\n (0xFCF9, 'M', u'غى'),\n (0xFCFA, 'M', u'غي'),\n (0xFCFB, 'M', u'سى'),\n (0xFCFC, 'M', u'سي'),\n (0xFCFD, 'M', u'شى'),\n (0xFCFE, 'M', u'شي'),\n (0xFCFF, 'M', u'حى'),\n (0xFD00, 'M', u'حي'),\n (0xFD01, 'M', u'جى'),\n (0xFD02, 'M', u'جي'),\n (0xFD03, 'M', u'خى'),\n (0xFD04, 'M', u'خي'),\n (0xFD05, 'M', u'صى'),\n (0xFD06, 'M', u'صي'),\n (0xFD07, 'M', u'ضى'),\n (0xFD08, 'M', u'ضي'),\n (0xFD09, 'M', u'شج'),\n (0xFD0A, 'M', u'شح'),\n (0xFD0B, 'M', u'شخ'),\n (0xFD0C, 'M', u'شم'),\n (0xFD0D, 'M', u'شر'),\n (0xFD0E, 'M', u'سر'),\n (0xFD0F, 'M', u'صر'),\n (0xFD10, 'M', u'ضر'),\n (0xFD11, 'M', u'طى'),\n (0xFD12, 'M', u'طي'),\n (0xFD13, 'M', u'عى'),\n (0xFD14, 'M', u'عي'),\n (0xFD15, 'M', u'غى'),\n (0xFD16, 'M', u'غي'),\n (0xFD17, 'M', u'سى'),\n (0xFD18, 'M', u'سي'),\n (0xFD19, 'M', u'شى'),\n (0xFD1A, 'M', u'شي'),\n (0xFD1B, 'M', u'حى'),\n (0xFD1C, 'M', u'حي'),\n (0xFD1D, 'M', u'جى'),\n (0xFD1E, 'M', u'جي'),\n (0xFD1F, 'M', u'خى'),\n (0xFD20, 'M', u'خي'),\n (0xFD21, 'M', u'صى'),\n (0xFD22, 'M', u'صي'),\n (0xFD23, 'M', u'ضى'),\n (0xFD24, 'M', u'ضي'),\n (0xFD25, 'M', u'شج'),\n (0xFD26, 'M', u'شح'),\n (0xFD27, 'M', u'شخ'),\n (0xFD28, 'M', u'شم'),\n (0xFD29, 'M', u'شر'),\n (0xFD2A, 'M', u'سر'),\n (0xFD2B, 'M', u'صر'),\n (0xFD2C, 'M', u'ضر'),\n (0xFD2D, 'M', u'شج'),\n (0xFD2E, 'M', u'شح'),\n (0xFD2F, 'M', u'شخ'),\n (0xFD30, 'M', u'شم'),\n (0xFD31, 'M', u'سه'),\n (0xFD32, 'M', u'شه'),\n (0xFD33, 'M', u'طم'),\n (0xFD34, 'M', u'سج'),\n (0xFD35, 'M', u'سح'),\n (0xFD36, 'M', u'سخ'),\n (0xFD37, 'M', u'شج'),\n (0xFD38, 'M', u'شح'),\n (0xFD39, 'M', u'شخ'),\n (0xFD3A, 'M', u'طم'),\n (0xFD3B, 'M', u'ظم'),\n (0xFD3C, 'M', u'اً'),\n (0xFD3E, 'V'),\n (0xFD40, 'X'),\n (0xFD50, 'M', u'تجم'),\n (0xFD51, 'M', u'تحج'),\n (0xFD53, 'M', u'تحم'),\n (0xFD54, 'M', u'تخم'),\n (0xFD55, 'M', u'تمج'),\n (0xFD56, 'M', u'تمح'),\n (0xFD57, 'M', u'تمخ'),\n (0xFD58, 'M', u'جمح'),\n (0xFD5A, 'M', u'حمي'),\n (0xFD5B, 'M', u'حمى'),\n (0xFD5C, 'M', u'سحج'),\n (0xFD5D, 'M', u'سجح'),\n (0xFD5E, 'M', u'سجى'),\n (0xFD5F, 'M', u'سمح'),\n (0xFD61, 'M', u'سمج'),\n (0xFD62, 'M', u'سمم'),\n (0xFD64, 'M', u'صحح'),\n (0xFD66, 'M', u'صمم'),\n (0xFD67, 'M', u'شحم'),\n (0xFD69, 'M', u'شجي'),\n ]\n\ndef _seg_48():\n return [\n (0xFD6A, 'M', u'شمخ'),\n (0xFD6C, 'M', u'شمم'),\n (0xFD6E, 'M', u'ضحى'),\n (0xFD6F, 'M', u'ضخم'),\n (0xFD71, 'M', u'طمح'),\n (0xFD73, 'M', u'طمم'),\n (0xFD74, 'M', u'طمي'),\n (0xFD75, 'M', u'عجم'),\n (0xFD76, 'M', u'عمم'),\n (0xFD78, 'M', u'عمى'),\n (0xFD79, 'M', u'غمم'),\n (0xFD7A, 'M', u'غمي'),\n (0xFD7B, 'M', u'غمى'),\n (0xFD7C, 'M', u'فخم'),\n (0xFD7E, 'M', u'قمح'),\n (0xFD7F, 'M', u'قمم'),\n (0xFD80, 'M', u'لحم'),\n (0xFD81, 'M', u'لحي'),\n (0xFD82, 'M', u'لحى'),\n (0xFD83, 'M', u'لجج'),\n (0xFD85, 'M', u'لخم'),\n (0xFD87, 'M', u'لمح'),\n (0xFD89, 'M', u'محج'),\n (0xFD8A, 'M', u'محم'),\n (0xFD8B, 'M', u'محي'),\n (0xFD8C, 'M', u'مجح'),\n (0xFD8D, 'M', u'مجم'),\n (0xFD8E, 'M', u'مخج'),\n (0xFD8F, 'M', u'مخم'),\n (0xFD90, 'X'),\n (0xFD92, 'M', u'مجخ'),\n (0xFD93, 'M', u'همج'),\n (0xFD94, 'M', u'همم'),\n (0xFD95, 'M', u'نحم'),\n (0xFD96, 'M', u'نحى'),\n (0xFD97, 'M', u'نجم'),\n (0xFD99, 'M', u'نجى'),\n (0xFD9A, 'M', u'نمي'),\n (0xFD9B, 'M', u'نمى'),\n (0xFD9C, 'M', u'يمم'),\n (0xFD9E, 'M', u'بخي'),\n (0xFD9F, 'M', u'تجي'),\n (0xFDA0, 'M', u'تجى'),\n (0xFDA1, 'M', u'تخي'),\n (0xFDA2, 'M', u'تخى'),\n (0xFDA3, 'M', u'تمي'),\n (0xFDA4, 'M', u'تمى'),\n (0xFDA5, 'M', u'جمي'),\n (0xFDA6, 'M', u'جحى'),\n (0xFDA7, 'M', u'جمى'),\n (0xFDA8, 'M', u'سخى'),\n (0xFDA9, 'M', u'صحي'),\n (0xFDAA, 'M', u'شحي'),\n (0xFDAB, 'M', u'ضحي'),\n (0xFDAC, 'M', u'لجي'),\n (0xFDAD, 'M', u'لمي'),\n (0xFDAE, 'M', u'يحي'),\n (0xFDAF, 'M', u'يجي'),\n (0xFDB0, 'M', u'يمي'),\n (0xFDB1, 'M', u'ممي'),\n (0xFDB2, 'M', u'قمي'),\n (0xFDB3, 'M', u'نحي'),\n (0xFDB4, 'M', u'قمح'),\n (0xFDB5, 'M', u'لحم'),\n (0xFDB6, 'M', u'عمي'),\n (0xFDB7, 'M', u'كمي'),\n (0xFDB8, 'M', u'نجح'),\n (0xFDB9, 'M', u'مخي'),\n (0xFDBA, 'M', u'لجم'),\n (0xFDBB, 'M', u'كمم'),\n (0xFDBC, 'M', u'لجم'),\n (0xFDBD, 'M', u'نجح'),\n (0xFDBE, 'M', u'جحي'),\n (0xFDBF, 'M', u'حجي'),\n (0xFDC0, 'M', u'مجي'),\n (0xFDC1, 'M', u'فمي'),\n (0xFDC2, 'M', u'بحي'),\n (0xFDC3, 'M', u'كمم'),\n (0xFDC4, 'M', u'عجم'),\n (0xFDC5, 'M', u'صمم'),\n (0xFDC6, 'M', u'سخي'),\n (0xFDC7, 'M', u'نجي'),\n (0xFDC8, 'X'),\n (0xFDF0, 'M', u'صلے'),\n (0xFDF1, 'M', u'قلے'),\n (0xFDF2, 'M', u'الله'),\n (0xFDF3, 'M', u'اكبر'),\n (0xFDF4, 'M', u'محمد'),\n (0xFDF5, 'M', u'صلعم'),\n (0xFDF6, 'M', u'رسول'),\n (0xFDF7, 'M', u'عليه'),\n (0xFDF8, 'M', u'وسلم'),\n (0xFDF9, 'M', u'صلى'),\n (0xFDFA, '3', u'صلى الله عليه وسلم'),\n (0xFDFB, '3', u'جل جلاله'),\n (0xFDFC, 'M', u'ریال'),\n (0xFDFD, 'V'),\n (0xFDFE, 'X'),\n (0xFE00, 'I'),\n (0xFE10, '3', u','),\n ]\n\ndef _seg_49():\n return [\n (0xFE11, 'M', u'、'),\n (0xFE12, 'X'),\n (0xFE13, '3', u':'),\n (0xFE14, '3', u';'),\n (0xFE15, '3', u'!'),\n (0xFE16, '3', u'?'),\n (0xFE17, 'M', u'〖'),\n (0xFE18, 'M', u'〗'),\n (0xFE19, 'X'),\n (0xFE20, 'V'),\n (0xFE30, 'X'),\n (0xFE31, 'M', u'—'),\n (0xFE32, 'M', u'–'),\n (0xFE33, '3', u'_'),\n (0xFE35, '3', u'('),\n (0xFE36, '3', u')'),\n (0xFE37, '3', u'{'),\n (0xFE38, '3', u'}'),\n (0xFE39, 'M', u'〔'),\n (0xFE3A, 'M', u'〕'),\n (0xFE3B, 'M', u'【'),\n (0xFE3C, 'M', u'】'),\n (0xFE3D, 'M', u'《'),\n (0xFE3E, 'M', u'》'),\n (0xFE3F, 'M', u'〈'),\n (0xFE40, 'M', u'〉'),\n (0xFE41, 'M', u'「'),\n (0xFE42, 'M', u'」'),\n (0xFE43, 'M', u'『'),\n (0xFE44, 'M', u'』'),\n (0xFE45, 'V'),\n (0xFE47, '3', u'['),\n (0xFE48, '3', u']'),\n (0xFE49, '3', u' ̅'),\n (0xFE4D, '3', u'_'),\n (0xFE50, '3', u','),\n (0xFE51, 'M', u'、'),\n (0xFE52, 'X'),\n (0xFE54, '3', u';'),\n (0xFE55, '3', u':'),\n (0xFE56, '3', u'?'),\n (0xFE57, '3', u'!'),\n (0xFE58, 'M', u'—'),\n (0xFE59, '3', u'('),\n (0xFE5A, '3', u')'),\n (0xFE5B, '3', u'{'),\n (0xFE5C, '3', u'}'),\n (0xFE5D, 'M', u'〔'),\n (0xFE5E, 'M', u'〕'),\n (0xFE5F, '3', u'#'),\n (0xFE60, '3', u'&'),\n (0xFE61, '3', u'*'),\n (0xFE62, '3', u'+'),\n (0xFE63, 'M', u'-'),\n (0xFE64, '3', u'<'),\n (0xFE65, '3', u'>'),\n (0xFE66, '3', u'='),\n (0xFE67, 'X'),\n (0xFE68, '3', u'\\\\'),\n (0xFE69, '3', u'$'),\n (0xFE6A, '3', u'%'),\n (0xFE6B, '3', u'@'),\n (0xFE6C, 'X'),\n (0xFE70, '3', u' ً'),\n (0xFE71, 'M', u'ـً'),\n (0xFE72, '3', u' ٌ'),\n (0xFE73, 'V'),\n (0xFE74, '3', u' ٍ'),\n (0xFE75, 'X'),\n (0xFE76, '3', u' َ'),\n (0xFE77, 'M', u'ـَ'),\n (0xFE78, '3', u' ُ'),\n (0xFE79, 'M', u'ـُ'),\n (0xFE7A, '3', u' ِ'),\n (0xFE7B, 'M', u'ـِ'),\n (0xFE7C, '3', u' ّ'),\n (0xFE7D, 'M', u'ـّ'),\n (0xFE7E, '3', u' ْ'),\n (0xFE7F, 'M', u'ـْ'),\n (0xFE80, 'M', u'ء'),\n (0xFE81, 'M', u'آ'),\n (0xFE83, 'M', u'أ'),\n (0xFE85, 'M', u'ؤ'),\n (0xFE87, 'M', u'إ'),\n (0xFE89, 'M', u'ئ'),\n (0xFE8D, 'M', u'ا'),\n (0xFE8F, 'M', u'ب'),\n (0xFE93, 'M', u'ة'),\n (0xFE95, 'M', u'ت'),\n (0xFE99, 'M', u'ث'),\n (0xFE9D, 'M', u'ج'),\n (0xFEA1, 'M', u'ح'),\n (0xFEA5, 'M', u'خ'),\n (0xFEA9, 'M', u'د'),\n (0xFEAB, 'M', u'ذ'),\n (0xFEAD, 'M', u'ر'),\n (0xFEAF, 'M', u'ز'),\n (0xFEB1, 'M', u'س'),\n (0xFEB5, 'M', u'ش'),\n (0xFEB9, 'M', u'ص'),\n ]\n\ndef _seg_50():\n return [\n (0xFEBD, 'M', u'ض'),\n (0xFEC1, 'M', u'ط'),\n (0xFEC5, 'M', u'ظ'),\n (0xFEC9, 'M', u'ع'),\n (0xFECD, 'M', u'غ'),\n (0xFED1, 'M', u'ف'),\n (0xFED5, 'M', u'ق'),\n (0xFED9, 'M', u'ك'),\n (0xFEDD, 'M', u'ل'),\n (0xFEE1, 'M', u'م'),\n (0xFEE5, 'M', u'ن'),\n (0xFEE9, 'M', u'ه'),\n (0xFEED, 'M', u'و'),\n (0xFEEF, 'M', u'ى'),\n (0xFEF1, 'M', u'ي'),\n (0xFEF5, 'M', u'لآ'),\n (0xFEF7, 'M', u'لأ'),\n (0xFEF9, 'M', u'لإ'),\n (0xFEFB, 'M', u'لا'),\n (0xFEFD, 'X'),\n (0xFEFF, 'I'),\n (0xFF00, 'X'),\n (0xFF01, '3', u'!'),\n (0xFF02, '3', u'\"'),\n (0xFF03, '3', u'#'),\n (0xFF04, '3', u'$'),\n (0xFF05, '3', u'%'),\n (0xFF06, '3', u'&'),\n (0xFF07, '3', u'\\''),\n (0xFF08, '3', u'('),\n (0xFF09, '3', u')'),\n (0xFF0A, '3', u'*'),\n (0xFF0B, '3', u'+'),\n (0xFF0C, '3', u','),\n (0xFF0D, 'M', u'-'),\n (0xFF0E, 'M', u'.'),\n (0xFF0F, '3', u'/'),\n (0xFF10, 'M', u'0'),\n (0xFF11, 'M', u'1'),\n (0xFF12, 'M', u'2'),\n (0xFF13, 'M', u'3'),\n (0xFF14, 'M', u'4'),\n (0xFF15, 'M', u'5'),\n (0xFF16, 'M', u'6'),\n (0xFF17, 'M', u'7'),\n (0xFF18, 'M', u'8'),\n (0xFF19, 'M', u'9'),\n (0xFF1A, '3', u':'),\n (0xFF1B, '3', u';'),\n (0xFF1C, '3', u'<'),\n (0xFF1D, '3', u'='),\n (0xFF1E, '3', u'>'),\n (0xFF1F, '3', u'?'),\n (0xFF20, '3', u'@'),\n (0xFF21, 'M', u'a'),\n (0xFF22, 'M', u'b'),\n (0xFF23, 'M', u'c'),\n (0xFF24, 'M', u'd'),\n (0xFF25, 'M', u'e'),\n (0xFF26, 'M', u'f'),\n (0xFF27, 'M', u'g'),\n (0xFF28, 'M', u'h'),\n (0xFF29, 'M', u'i'),\n (0xFF2A, 'M', u'j'),\n (0xFF2B, 'M', u'k'),\n (0xFF2C, 'M', u'l'),\n (0xFF2D, 'M', u'm'),\n (0xFF2E, 'M', u'n'),\n (0xFF2F, 'M', u'o'),\n (0xFF30, 'M', u'p'),\n (0xFF31, 'M', u'q'),\n (0xFF32, 'M', u'r'),\n (0xFF33, 'M', u's'),\n (0xFF34, 'M', u't'),\n (0xFF35, 'M', u'u'),\n (0xFF36, 'M', u'v'),\n (0xFF37, 'M', u'w'),\n (0xFF38, 'M', u'x'),\n (0xFF39, 'M', u'y'),\n (0xFF3A, 'M', u'z'),\n (0xFF3B, '3', u'['),\n (0xFF3C, '3', u'\\\\'),\n (0xFF3D, '3', u']'),\n (0xFF3E, '3', u'^'),\n (0xFF3F, '3', u'_'),\n (0xFF40, '3', u'`'),\n (0xFF41, 'M', u'a'),\n (0xFF42, 'M', u'b'),\n (0xFF43, 'M', u'c'),\n (0xFF44, 'M', u'd'),\n (0xFF45, 'M', u'e'),\n (0xFF46, 'M', u'f'),\n (0xFF47, 'M', u'g'),\n (0xFF48, 'M', u'h'),\n (0xFF49, 'M', u'i'),\n (0xFF4A, 'M', u'j'),\n (0xFF4B, 'M', u'k'),\n (0xFF4C, 'M', u'l'),\n (0xFF4D, 'M', u'm'),\n (0xFF4E, 'M', u'n'),\n ]\n\ndef _seg_51():\n return [\n (0xFF4F, 'M', u'o'),\n (0xFF50, 'M', u'p'),\n (0xFF51, 'M', u'q'),\n (0xFF52, 'M', u'r'),\n (0xFF53, 'M', u's'),\n (0xFF54, 'M', u't'),\n (0xFF55, 'M', u'u'),\n (0xFF56, 'M', u'v'),\n (0xFF57, 'M', u'w'),\n (0xFF58, 'M', u'x'),\n (0xFF59, 'M', u'y'),\n (0xFF5A, 'M', u'z'),\n (0xFF5B, '3', u'{'),\n (0xFF5C, '3', u'|'),\n (0xFF5D, '3', u'}'),\n (0xFF5E, '3', u'~'),\n (0xFF5F, 'M', u'⦅'),\n (0xFF60, 'M', u'⦆'),\n (0xFF61, 'M', u'.'),\n (0xFF62, 'M', u'「'),\n (0xFF63, 'M', u'」'),\n (0xFF64, 'M', u'、'),\n (0xFF65, 'M', u'・'),\n (0xFF66, 'M', u'ヲ'),\n (0xFF67, 'M', u'ァ'),\n (0xFF68, 'M', u'ィ'),\n (0xFF69, 'M', u'ゥ'),\n (0xFF6A, 'M', u'ェ'),\n (0xFF6B, 'M', u'ォ'),\n (0xFF6C, 'M', u'ャ'),\n (0xFF6D, 'M', u'ュ'),\n (0xFF6E, 'M', u'ョ'),\n (0xFF6F, 'M', u'ッ'),\n (0xFF70, 'M', u'ー'),\n (0xFF71, 'M', u'ア'),\n (0xFF72, 'M', u'イ'),\n (0xFF73, 'M', u'ウ'),\n (0xFF74, 'M', u'エ'),\n (0xFF75, 'M', u'オ'),\n (0xFF76, 'M', u'カ'),\n (0xFF77, 'M', u'キ'),\n (0xFF78, 'M', u'ク'),\n (0xFF79, 'M', u'ケ'),\n (0xFF7A, 'M', u'コ'),\n (0xFF7B, 'M', u'サ'),\n (0xFF7C, 'M', u'シ'),\n (0xFF7D, 'M', u'ス'),\n (0xFF7E, 'M', u'セ'),\n (0xFF7F, 'M', u'ソ'),\n (0xFF80, 'M', u'タ'),\n (0xFF81, 'M', u'チ'),\n (0xFF82, 'M', u'ツ'),\n (0xFF83, 'M', u'テ'),\n (0xFF84, 'M', u'ト'),\n (0xFF85, 'M', u'ナ'),\n (0xFF86, 'M', u'ニ'),\n (0xFF87, 'M', u'ヌ'),\n (0xFF88, 'M', u'ネ'),\n (0xFF89, 'M', u'ノ'),\n (0xFF8A, 'M', u'ハ'),\n (0xFF8B, 'M', u'ヒ'),\n (0xFF8C, 'M', u'フ'),\n (0xFF8D, 'M', u'ヘ'),\n (0xFF8E, 'M', u'ホ'),\n (0xFF8F, 'M', u'マ'),\n (0xFF90, 'M', u'ミ'),\n (0xFF91, 'M', u'ム'),\n (0xFF92, 'M', u'メ'),\n (0xFF93, 'M', u'モ'),\n (0xFF94, 'M', u'ヤ'),\n (0xFF95, 'M', u'ユ'),\n (0xFF96, 'M', u'ヨ'),\n (0xFF97, 'M', u'ラ'),\n (0xFF98, 'M', u'リ'),\n (0xFF99, 'M', u'ル'),\n (0xFF9A, 'M', u'レ'),\n (0xFF9B, 'M', u'ロ'),\n (0xFF9C, 'M', u'ワ'),\n (0xFF9D, 'M', u'ン'),\n (0xFF9E, 'M', u'゙'),\n (0xFF9F, 'M', u'゚'),\n (0xFFA0, 'X'),\n (0xFFA1, 'M', u'ᄀ'),\n (0xFFA2, 'M', u'ᄁ'),\n (0xFFA3, 'M', u'ᆪ'),\n (0xFFA4, 'M', u'ᄂ'),\n (0xFFA5, 'M', u'ᆬ'),\n (0xFFA6, 'M', u'ᆭ'),\n (0xFFA7, 'M', u'ᄃ'),\n (0xFFA8, 'M', u'ᄄ'),\n (0xFFA9, 'M', u'ᄅ'),\n (0xFFAA, 'M', u'ᆰ'),\n (0xFFAB, 'M', u'ᆱ'),\n (0xFFAC, 'M', u'ᆲ'),\n (0xFFAD, 'M', u'ᆳ'),\n (0xFFAE, 'M', u'ᆴ'),\n (0xFFAF, 'M', u'ᆵ'),\n (0xFFB0, 'M', u'ᄚ'),\n (0xFFB1, 'M', u'ᄆ'),\n (0xFFB2, 'M', u'ᄇ'),\n ]\n\ndef _seg_52():\n return [\n (0xFFB3, 'M', u'ᄈ'),\n (0xFFB4, 'M', u'ᄡ'),\n (0xFFB5, 'M', u'ᄉ'),\n (0xFFB6, 'M', u'ᄊ'),\n (0xFFB7, 'M', u'ᄋ'),\n (0xFFB8, 'M', u'ᄌ'),\n (0xFFB9, 'M', u'ᄍ'),\n (0xFFBA, 'M', u'ᄎ'),\n (0xFFBB, 'M', u'ᄏ'),\n (0xFFBC, 'M', u'ᄐ'),\n (0xFFBD, 'M', u'ᄑ'),\n (0xFFBE, 'M', u'ᄒ'),\n (0xFFBF, 'X'),\n (0xFFC2, 'M', u'ᅡ'),\n (0xFFC3, 'M', u'ᅢ'),\n (0xFFC4, 'M', u'ᅣ'),\n (0xFFC5, 'M', u'ᅤ'),\n (0xFFC6, 'M', u'ᅥ'),\n (0xFFC7, 'M', u'ᅦ'),\n (0xFFC8, 'X'),\n (0xFFCA, 'M', u'ᅧ'),\n (0xFFCB, 'M', u'ᅨ'),\n (0xFFCC, 'M', u'ᅩ'),\n (0xFFCD, 'M', u'ᅪ'),\n (0xFFCE, 'M', u'ᅫ'),\n (0xFFCF, 'M', u'ᅬ'),\n (0xFFD0, 'X'),\n (0xFFD2, 'M', u'ᅭ'),\n (0xFFD3, 'M', u'ᅮ'),\n (0xFFD4, 'M', u'ᅯ'),\n (0xFFD5, 'M', u'ᅰ'),\n (0xFFD6, 'M', u'ᅱ'),\n (0xFFD7, 'M', u'ᅲ'),\n (0xFFD8, 'X'),\n (0xFFDA, 'M', u'ᅳ'),\n (0xFFDB, 'M', u'ᅴ'),\n (0xFFDC, 'M', u'ᅵ'),\n (0xFFDD, 'X'),\n (0xFFE0, 'M', u'¢'),\n (0xFFE1, 'M', u'£'),\n (0xFFE2, 'M', u'¬'),\n (0xFFE3, '3', u' ̄'),\n (0xFFE4, 'M', u'¦'),\n (0xFFE5, 'M', u'¥'),\n (0xFFE6, 'M', u'₩'),\n (0xFFE7, 'X'),\n (0xFFE8, 'M', u'│'),\n (0xFFE9, 'M', u'←'),\n (0xFFEA, 'M', u'↑'),\n (0xFFEB, 'M', u'→'),\n (0xFFEC, 'M', u'↓'),\n (0xFFED, 'M', u'■'),\n (0xFFEE, 'M', u'○'),\n (0xFFEF, 'X'),\n (0x10000, 'V'),\n (0x1000C, 'X'),\n (0x1000D, 'V'),\n (0x10027, 'X'),\n (0x10028, 'V'),\n (0x1003B, 'X'),\n (0x1003C, 'V'),\n (0x1003E, 'X'),\n (0x1003F, 'V'),\n (0x1004E, 'X'),\n (0x10050, 'V'),\n (0x1005E, 'X'),\n (0x10080, 'V'),\n (0x100FB, 'X'),\n (0x10100, 'V'),\n (0x10103, 'X'),\n (0x10107, 'V'),\n (0x10134, 'X'),\n (0x10137, 'V'),\n (0x1018F, 'X'),\n (0x10190, 'V'),\n (0x1019C, 'X'),\n (0x101A0, 'V'),\n (0x101A1, 'X'),\n (0x101D0, 'V'),\n (0x101FE, 'X'),\n (0x10280, 'V'),\n (0x1029D, 'X'),\n (0x102A0, 'V'),\n (0x102D1, 'X'),\n (0x102E0, 'V'),\n (0x102FC, 'X'),\n (0x10300, 'V'),\n (0x10324, 'X'),\n (0x1032D, 'V'),\n (0x1034B, 'X'),\n (0x10350, 'V'),\n (0x1037B, 'X'),\n (0x10380, 'V'),\n (0x1039E, 'X'),\n (0x1039F, 'V'),\n (0x103C4, 'X'),\n (0x103C8, 'V'),\n (0x103D6, 'X'),\n (0x10400, 'M', u'𐐨'),\n (0x10401, 'M', u'𐐩'),\n ]\n\ndef _seg_53():\n return [\n (0x10402, 'M', u'𐐪'),\n (0x10403, 'M', u'𐐫'),\n (0x10404, 'M', u'𐐬'),\n (0x10405, 'M', u'𐐭'),\n (0x10406, 'M', u'𐐮'),\n (0x10407, 'M', u'𐐯'),\n (0x10408, 'M', u'𐐰'),\n (0x10409, 'M', u'𐐱'),\n (0x1040A, 'M', u'𐐲'),\n (0x1040B, 'M', u'𐐳'),\n (0x1040C, 'M', u'𐐴'),\n (0x1040D, 'M', u'𐐵'),\n (0x1040E, 'M', u'𐐶'),\n (0x1040F, 'M', u'𐐷'),\n (0x10410, 'M', u'𐐸'),\n (0x10411, 'M', u'𐐹'),\n (0x10412, 'M', u'𐐺'),\n (0x10413, 'M', u'𐐻'),\n (0x10414, 'M', u'𐐼'),\n (0x10415, 'M', u'𐐽'),\n (0x10416, 'M', u'𐐾'),\n (0x10417, 'M', u'𐐿'),\n (0x10418, 'M', u'𐑀'),\n (0x10419, 'M', u'𐑁'),\n (0x1041A, 'M', u'𐑂'),\n (0x1041B, 'M', u'𐑃'),\n (0x1041C, 'M', u'𐑄'),\n (0x1041D, 'M', u'𐑅'),\n (0x1041E, 'M', u'𐑆'),\n (0x1041F, 'M', u'𐑇'),\n (0x10420, 'M', u'𐑈'),\n (0x10421, 'M', u'𐑉'),\n (0x10422, 'M', u'𐑊'),\n (0x10423, 'M', u'𐑋'),\n (0x10424, 'M', u'𐑌'),\n (0x10425, 'M', u'𐑍'),\n (0x10426, 'M', u'𐑎'),\n (0x10427, 'M', u'𐑏'),\n (0x10428, 'V'),\n (0x1049E, 'X'),\n (0x104A0, 'V'),\n (0x104AA, 'X'),\n (0x104B0, 'M', u'𐓘'),\n (0x104B1, 'M', u'𐓙'),\n (0x104B2, 'M', u'𐓚'),\n (0x104B3, 'M', u'𐓛'),\n (0x104B4, 'M', u'𐓜'),\n (0x104B5, 'M', u'𐓝'),\n (0x104B6, 'M', u'𐓞'),\n (0x104B7, 'M', u'𐓟'),\n (0x104B8, 'M', u'𐓠'),\n (0x104B9, 'M', u'𐓡'),\n (0x104BA, 'M', u'𐓢'),\n (0x104BB, 'M', u'𐓣'),\n (0x104BC, 'M', u'𐓤'),\n (0x104BD, 'M', u'𐓥'),\n (0x104BE, 'M', u'𐓦'),\n (0x104BF, 'M', u'𐓧'),\n (0x104C0, 'M', u'𐓨'),\n (0x104C1, 'M', u'𐓩'),\n (0x104C2, 'M', u'𐓪'),\n (0x104C3, 'M', u'𐓫'),\n (0x104C4, 'M', u'𐓬'),\n (0x104C5, 'M', u'𐓭'),\n (0x104C6, 'M', u'𐓮'),\n (0x104C7, 'M', u'𐓯'),\n (0x104C8, 'M', u'𐓰'),\n (0x104C9, 'M', u'𐓱'),\n (0x104CA, 'M', u'𐓲'),\n (0x104CB, 'M', u'𐓳'),\n (0x104CC, 'M', u'𐓴'),\n (0x104CD, 'M', u'𐓵'),\n (0x104CE, 'M', u'𐓶'),\n (0x104CF, 'M', u'𐓷'),\n (0x104D0, 'M', u'𐓸'),\n (0x104D1, 'M', u'𐓹'),\n (0x104D2, 'M', u'𐓺'),\n (0x104D3, 'M', u'𐓻'),\n (0x104D4, 'X'),\n (0x104D8, 'V'),\n (0x104FC, 'X'),\n (0x10500, 'V'),\n (0x10528, 'X'),\n (0x10530, 'V'),\n (0x10564, 'X'),\n (0x1056F, 'V'),\n (0x10570, 'X'),\n (0x10600, 'V'),\n (0x10737, 'X'),\n (0x10740, 'V'),\n (0x10756, 'X'),\n (0x10760, 'V'),\n (0x10768, 'X'),\n (0x10800, 'V'),\n (0x10806, 'X'),\n (0x10808, 'V'),\n (0x10809, 'X'),\n (0x1080A, 'V'),\n (0x10836, 'X'),\n (0x10837, 'V'),\n ]\n\ndef _seg_54():\n return [\n (0x10839, 'X'),\n (0x1083C, 'V'),\n (0x1083D, 'X'),\n (0x1083F, 'V'),\n (0x10856, 'X'),\n (0x10857, 'V'),\n (0x1089F, 'X'),\n (0x108A7, 'V'),\n (0x108B0, 'X'),\n (0x108E0, 'V'),\n (0x108F3, 'X'),\n (0x108F4, 'V'),\n (0x108F6, 'X'),\n (0x108FB, 'V'),\n (0x1091C, 'X'),\n (0x1091F, 'V'),\n (0x1093A, 'X'),\n (0x1093F, 'V'),\n (0x10940, 'X'),\n (0x10980, 'V'),\n (0x109B8, 'X'),\n (0x109BC, 'V'),\n (0x109D0, 'X'),\n (0x109D2, 'V'),\n (0x10A04, 'X'),\n (0x10A05, 'V'),\n (0x10A07, 'X'),\n (0x10A0C, 'V'),\n (0x10A14, 'X'),\n (0x10A15, 'V'),\n (0x10A18, 'X'),\n (0x10A19, 'V'),\n (0x10A36, 'X'),\n (0x10A38, 'V'),\n (0x10A3B, 'X'),\n (0x10A3F, 'V'),\n (0x10A49, 'X'),\n (0x10A50, 'V'),\n (0x10A59, 'X'),\n (0x10A60, 'V'),\n (0x10AA0, 'X'),\n (0x10AC0, 'V'),\n (0x10AE7, 'X'),\n (0x10AEB, 'V'),\n (0x10AF7, 'X'),\n (0x10B00, 'V'),\n (0x10B36, 'X'),\n (0x10B39, 'V'),\n (0x10B56, 'X'),\n (0x10B58, 'V'),\n (0x10B73, 'X'),\n (0x10B78, 'V'),\n (0x10B92, 'X'),\n (0x10B99, 'V'),\n (0x10B9D, 'X'),\n (0x10BA9, 'V'),\n (0x10BB0, 'X'),\n (0x10C00, 'V'),\n (0x10C49, 'X'),\n (0x10C80, 'M', u'𐳀'),\n (0x10C81, 'M', u'𐳁'),\n (0x10C82, 'M', u'𐳂'),\n (0x10C83, 'M', u'𐳃'),\n (0x10C84, 'M', u'𐳄'),\n (0x10C85, 'M', u'𐳅'),\n (0x10C86, 'M', u'𐳆'),\n (0x10C87, 'M', u'𐳇'),\n (0x10C88, 'M', u'𐳈'),\n (0x10C89, 'M', u'𐳉'),\n (0x10C8A, 'M', u'𐳊'),\n (0x10C8B, 'M', u'𐳋'),\n (0x10C8C, 'M', u'𐳌'),\n (0x10C8D, 'M', u'𐳍'),\n (0x10C8E, 'M', u'𐳎'),\n (0x10C8F, 'M', u'𐳏'),\n (0x10C90, 'M', u'𐳐'),\n (0x10C91, 'M', u'𐳑'),\n (0x10C92, 'M', u'𐳒'),\n (0x10C93, 'M', u'𐳓'),\n (0x10C94, 'M', u'𐳔'),\n (0x10C95, 'M', u'𐳕'),\n (0x10C96, 'M', u'𐳖'),\n (0x10C97, 'M', u'𐳗'),\n (0x10C98, 'M', u'𐳘'),\n (0x10C99, 'M', u'𐳙'),\n (0x10C9A, 'M', u'𐳚'),\n (0x10C9B, 'M', u'𐳛'),\n (0x10C9C, 'M', u'𐳜'),\n (0x10C9D, 'M', u'𐳝'),\n (0x10C9E, 'M', u'𐳞'),\n (0x10C9F, 'M', u'𐳟'),\n (0x10CA0, 'M', u'𐳠'),\n (0x10CA1, 'M', u'𐳡'),\n (0x10CA2, 'M', u'𐳢'),\n (0x10CA3, 'M', u'𐳣'),\n (0x10CA4, 'M', u'𐳤'),\n (0x10CA5, 'M', u'𐳥'),\n (0x10CA6, 'M', u'𐳦'),\n (0x10CA7, 'M', u'𐳧'),\n (0x10CA8, 'M', u'𐳨'),\n ]\n\ndef _seg_55():\n return [\n (0x10CA9, 'M', u'𐳩'),\n (0x10CAA, 'M', u'𐳪'),\n (0x10CAB, 'M', u'𐳫'),\n (0x10CAC, 'M', u'𐳬'),\n (0x10CAD, 'M', u'𐳭'),\n (0x10CAE, 'M', u'𐳮'),\n (0x10CAF, 'M', u'𐳯'),\n (0x10CB0, 'M', u'𐳰'),\n (0x10CB1, 'M', u'𐳱'),\n (0x10CB2, 'M', u'𐳲'),\n (0x10CB3, 'X'),\n (0x10CC0, 'V'),\n (0x10CF3, 'X'),\n (0x10CFA, 'V'),\n (0x10D28, 'X'),\n (0x10D30, 'V'),\n (0x10D3A, 'X'),\n (0x10E60, 'V'),\n (0x10E7F, 'X'),\n (0x10F00, 'V'),\n (0x10F28, 'X'),\n (0x10F30, 'V'),\n (0x10F5A, 'X'),\n (0x11000, 'V'),\n (0x1104E, 'X'),\n (0x11052, 'V'),\n (0x11070, 'X'),\n (0x1107F, 'V'),\n (0x110BD, 'X'),\n (0x110BE, 'V'),\n (0x110C2, 'X'),\n (0x110D0, 'V'),\n (0x110E9, 'X'),\n (0x110F0, 'V'),\n (0x110FA, 'X'),\n (0x11100, 'V'),\n (0x11135, 'X'),\n (0x11136, 'V'),\n (0x11147, 'X'),\n (0x11150, 'V'),\n (0x11177, 'X'),\n (0x11180, 'V'),\n (0x111CE, 'X'),\n (0x111D0, 'V'),\n (0x111E0, 'X'),\n (0x111E1, 'V'),\n (0x111F5, 'X'),\n (0x11200, 'V'),\n (0x11212, 'X'),\n (0x11213, 'V'),\n (0x1123F, 'X'),\n (0x11280, 'V'),\n (0x11287, 'X'),\n (0x11288, 'V'),\n (0x11289, 'X'),\n (0x1128A, 'V'),\n (0x1128E, 'X'),\n (0x1128F, 'V'),\n (0x1129E, 'X'),\n (0x1129F, 'V'),\n (0x112AA, 'X'),\n (0x112B0, 'V'),\n (0x112EB, 'X'),\n (0x112F0, 'V'),\n (0x112FA, 'X'),\n (0x11300, 'V'),\n (0x11304, 'X'),\n (0x11305, 'V'),\n (0x1130D, 'X'),\n (0x1130F, 'V'),\n (0x11311, 'X'),\n (0x11313, 'V'),\n (0x11329, 'X'),\n (0x1132A, 'V'),\n (0x11331, 'X'),\n (0x11332, 'V'),\n (0x11334, 'X'),\n (0x11335, 'V'),\n (0x1133A, 'X'),\n (0x1133B, 'V'),\n (0x11345, 'X'),\n (0x11347, 'V'),\n (0x11349, 'X'),\n (0x1134B, 'V'),\n (0x1134E, 'X'),\n (0x11350, 'V'),\n (0x11351, 'X'),\n (0x11357, 'V'),\n (0x11358, 'X'),\n (0x1135D, 'V'),\n (0x11364, 'X'),\n (0x11366, 'V'),\n (0x1136D, 'X'),\n (0x11370, 'V'),\n (0x11375, 'X'),\n (0x11400, 'V'),\n (0x1145A, 'X'),\n (0x1145B, 'V'),\n (0x1145C, 'X'),\n (0x1145D, 'V'),\n ]\n\ndef _seg_56():\n return [\n (0x1145F, 'X'),\n (0x11480, 'V'),\n (0x114C8, 'X'),\n (0x114D0, 'V'),\n (0x114DA, 'X'),\n (0x11580, 'V'),\n (0x115B6, 'X'),\n (0x115B8, 'V'),\n (0x115DE, 'X'),\n (0x11600, 'V'),\n (0x11645, 'X'),\n (0x11650, 'V'),\n (0x1165A, 'X'),\n (0x11660, 'V'),\n (0x1166D, 'X'),\n (0x11680, 'V'),\n (0x116B8, 'X'),\n (0x116C0, 'V'),\n (0x116CA, 'X'),\n (0x11700, 'V'),\n (0x1171B, 'X'),\n (0x1171D, 'V'),\n (0x1172C, 'X'),\n (0x11730, 'V'),\n (0x11740, 'X'),\n (0x11800, 'V'),\n (0x1183C, 'X'),\n (0x118A0, 'M', u'𑣀'),\n (0x118A1, 'M', u'𑣁'),\n (0x118A2, 'M', u'𑣂'),\n (0x118A3, 'M', u'𑣃'),\n (0x118A4, 'M', u'𑣄'),\n (0x118A5, 'M', u'𑣅'),\n (0x118A6, 'M', u'𑣆'),\n (0x118A7, 'M', u'𑣇'),\n (0x118A8, 'M', u'𑣈'),\n (0x118A9, 'M', u'𑣉'),\n (0x118AA, 'M', u'𑣊'),\n (0x118AB, 'M', u'𑣋'),\n (0x118AC, 'M', u'𑣌'),\n (0x118AD, 'M', u'𑣍'),\n (0x118AE, 'M', u'𑣎'),\n (0x118AF, 'M', u'𑣏'),\n (0x118B0, 'M', u'𑣐'),\n (0x118B1, 'M', u'𑣑'),\n (0x118B2, 'M', u'𑣒'),\n (0x118B3, 'M', u'𑣓'),\n (0x118B4, 'M', u'𑣔'),\n (0x118B5, 'M', u'𑣕'),\n (0x118B6, 'M', u'𑣖'),\n (0x118B7, 'M', u'𑣗'),\n (0x118B8, 'M', u'𑣘'),\n (0x118B9, 'M', u'𑣙'),\n (0x118BA, 'M', u'𑣚'),\n (0x118BB, 'M', u'𑣛'),\n (0x118BC, 'M', u'𑣜'),\n (0x118BD, 'M', u'𑣝'),\n (0x118BE, 'M', u'𑣞'),\n (0x118BF, 'M', u'𑣟'),\n (0x118C0, 'V'),\n (0x118F3, 'X'),\n (0x118FF, 'V'),\n (0x11900, 'X'),\n (0x11A00, 'V'),\n (0x11A48, 'X'),\n (0x11A50, 'V'),\n (0x11A84, 'X'),\n (0x11A86, 'V'),\n (0x11AA3, 'X'),\n (0x11AC0, 'V'),\n (0x11AF9, 'X'),\n (0x11C00, 'V'),\n (0x11C09, 'X'),\n (0x11C0A, 'V'),\n (0x11C37, 'X'),\n (0x11C38, 'V'),\n (0x11C46, 'X'),\n (0x11C50, 'V'),\n (0x11C6D, 'X'),\n (0x11C70, 'V'),\n (0x11C90, 'X'),\n (0x11C92, 'V'),\n (0x11CA8, 'X'),\n (0x11CA9, 'V'),\n (0x11CB7, 'X'),\n (0x11D00, 'V'),\n (0x11D07, 'X'),\n (0x11D08, 'V'),\n (0x11D0A, 'X'),\n (0x11D0B, 'V'),\n (0x11D37, 'X'),\n (0x11D3A, 'V'),\n (0x11D3B, 'X'),\n (0x11D3C, 'V'),\n (0x11D3E, 'X'),\n (0x11D3F, 'V'),\n (0x11D48, 'X'),\n (0x11D50, 'V'),\n (0x11D5A, 'X'),\n (0x11D60, 'V'),\n ]\n\ndef _seg_57():\n return [\n (0x11D66, 'X'),\n (0x11D67, 'V'),\n (0x11D69, 'X'),\n (0x11D6A, 'V'),\n (0x11D8F, 'X'),\n (0x11D90, 'V'),\n (0x11D92, 'X'),\n (0x11D93, 'V'),\n (0x11D99, 'X'),\n (0x11DA0, 'V'),\n (0x11DAA, 'X'),\n (0x11EE0, 'V'),\n (0x11EF9, 'X'),\n (0x12000, 'V'),\n (0x1239A, 'X'),\n (0x12400, 'V'),\n (0x1246F, 'X'),\n (0x12470, 'V'),\n (0x12475, 'X'),\n (0x12480, 'V'),\n (0x12544, 'X'),\n (0x13000, 'V'),\n (0x1342F, 'X'),\n (0x14400, 'V'),\n (0x14647, 'X'),\n (0x16800, 'V'),\n (0x16A39, 'X'),\n (0x16A40, 'V'),\n (0x16A5F, 'X'),\n (0x16A60, 'V'),\n (0x16A6A, 'X'),\n (0x16A6E, 'V'),\n (0x16A70, 'X'),\n (0x16AD0, 'V'),\n (0x16AEE, 'X'),\n (0x16AF0, 'V'),\n (0x16AF6, 'X'),\n (0x16B00, 'V'),\n (0x16B46, 'X'),\n (0x16B50, 'V'),\n (0x16B5A, 'X'),\n (0x16B5B, 'V'),\n (0x16B62, 'X'),\n (0x16B63, 'V'),\n (0x16B78, 'X'),\n (0x16B7D, 'V'),\n (0x16B90, 'X'),\n (0x16E60, 'V'),\n (0x16E9B, 'X'),\n (0x16F00, 'V'),\n (0x16F45, 'X'),\n (0x16F50, 'V'),\n (0x16F7F, 'X'),\n (0x16F8F, 'V'),\n (0x16FA0, 'X'),\n (0x16FE0, 'V'),\n (0x16FE2, 'X'),\n (0x17000, 'V'),\n (0x187F2, 'X'),\n (0x18800, 'V'),\n (0x18AF3, 'X'),\n (0x1B000, 'V'),\n (0x1B11F, 'X'),\n (0x1B170, 'V'),\n (0x1B2FC, 'X'),\n (0x1BC00, 'V'),\n (0x1BC6B, 'X'),\n (0x1BC70, 'V'),\n (0x1BC7D, 'X'),\n (0x1BC80, 'V'),\n (0x1BC89, 'X'),\n (0x1BC90, 'V'),\n (0x1BC9A, 'X'),\n (0x1BC9C, 'V'),\n (0x1BCA0, 'I'),\n (0x1BCA4, 'X'),\n (0x1D000, 'V'),\n (0x1D0F6, 'X'),\n (0x1D100, 'V'),\n (0x1D127, 'X'),\n (0x1D129, 'V'),\n (0x1D15E, 'M', u'𝅗𝅥'),\n (0x1D15F, 'M', u'𝅘𝅥'),\n (0x1D160, 'M', u'𝅘𝅥𝅮'),\n (0x1D161, 'M', u'𝅘𝅥𝅯'),\n (0x1D162, 'M', u'𝅘𝅥𝅰'),\n (0x1D163, 'M', u'𝅘𝅥𝅱'),\n (0x1D164, 'M', u'𝅘𝅥𝅲'),\n (0x1D165, 'V'),\n (0x1D173, 'X'),\n (0x1D17B, 'V'),\n (0x1D1BB, 'M', u'𝆹𝅥'),\n (0x1D1BC, 'M', u'𝆺𝅥'),\n (0x1D1BD, 'M', u'𝆹𝅥𝅮'),\n (0x1D1BE, 'M', u'𝆺𝅥𝅮'),\n (0x1D1BF, 'M', u'𝆹𝅥𝅯'),\n (0x1D1C0, 'M', u'𝆺𝅥𝅯'),\n (0x1D1C1, 'V'),\n (0x1D1E9, 'X'),\n (0x1D200, 'V'),\n ]\n\ndef _seg_58():\n return [\n (0x1D246, 'X'),\n (0x1D2E0, 'V'),\n (0x1D2F4, 'X'),\n (0x1D300, 'V'),\n (0x1D357, 'X'),\n (0x1D360, 'V'),\n (0x1D379, 'X'),\n (0x1D400, 'M', u'a'),\n (0x1D401, 'M', u'b'),\n (0x1D402, 'M', u'c'),\n (0x1D403, 'M', u'd'),\n (0x1D404, 'M', u'e'),\n (0x1D405, 'M', u'f'),\n (0x1D406, 'M', u'g'),\n (0x1D407, 'M', u'h'),\n (0x1D408, 'M', u'i'),\n (0x1D409, 'M', u'j'),\n (0x1D40A, 'M', u'k'),\n (0x1D40B, 'M', u'l'),\n (0x1D40C, 'M', u'm'),\n (0x1D40D, 'M', u'n'),\n (0x1D40E, 'M', u'o'),\n (0x1D40F, 'M', u'p'),\n (0x1D410, 'M', u'q'),\n (0x1D411, 'M', u'r'),\n (0x1D412, 'M', u's'),\n (0x1D413, 'M', u't'),\n (0x1D414, 'M', u'u'),\n (0x1D415, 'M', u'v'),\n (0x1D416, 'M', u'w'),\n (0x1D417, 'M', u'x'),\n (0x1D418, 'M', u'y'),\n (0x1D419, 'M', u'z'),\n (0x1D41A, 'M', u'a'),\n (0x1D41B, 'M', u'b'),\n (0x1D41C, 'M', u'c'),\n (0x1D41D, 'M', u'd'),\n (0x1D41E, 'M', u'e'),\n (0x1D41F, 'M', u'f'),\n (0x1D420, 'M', u'g'),\n (0x1D421, 'M', u'h'),\n (0x1D422, 'M', u'i'),\n (0x1D423, 'M', u'j'),\n (0x1D424, 'M', u'k'),\n (0x1D425, 'M', u'l'),\n (0x1D426, 'M', u'm'),\n (0x1D427, 'M', u'n'),\n (0x1D428, 'M', u'o'),\n (0x1D429, 'M', u'p'),\n (0x1D42A, 'M', u'q'),\n (0x1D42B, 'M', u'r'),\n (0x1D42C, 'M', u's'),\n (0x1D42D, 'M', u't'),\n (0x1D42E, 'M', u'u'),\n (0x1D42F, 'M', u'v'),\n (0x1D430, 'M', u'w'),\n (0x1D431, 'M', u'x'),\n (0x1D432, 'M', u'y'),\n (0x1D433, 'M', u'z'),\n (0x1D434, 'M', u'a'),\n (0x1D435, 'M', u'b'),\n (0x1D436, 'M', u'c'),\n (0x1D437, 'M', u'd'),\n (0x1D438, 'M', u'e'),\n (0x1D439, 'M', u'f'),\n (0x1D43A, 'M', u'g'),\n (0x1D43B, 'M', u'h'),\n (0x1D43C, 'M', u'i'),\n (0x1D43D, 'M', u'j'),\n (0x1D43E, 'M', u'k'),\n (0x1D43F, 'M', u'l'),\n (0x1D440, 'M', u'm'),\n (0x1D441, 'M', u'n'),\n (0x1D442, 'M', u'o'),\n (0x1D443, 'M', u'p'),\n (0x1D444, 'M', u'q'),\n (0x1D445, 'M', u'r'),\n (0x1D446, 'M', u's'),\n (0x1D447, 'M', u't'),\n (0x1D448, 'M', u'u'),\n (0x1D449, 'M', u'v'),\n (0x1D44A, 'M', u'w'),\n (0x1D44B, 'M', u'x'),\n (0x1D44C, 'M', u'y'),\n (0x1D44D, 'M', u'z'),\n (0x1D44E, 'M', u'a'),\n (0x1D44F, 'M', u'b'),\n (0x1D450, 'M', u'c'),\n (0x1D451, 'M', u'd'),\n (0x1D452, 'M', u'e'),\n (0x1D453, 'M', u'f'),\n (0x1D454, 'M', u'g'),\n (0x1D455, 'X'),\n (0x1D456, 'M', u'i'),\n (0x1D457, 'M', u'j'),\n (0x1D458, 'M', u'k'),\n (0x1D459, 'M', u'l'),\n (0x1D45A, 'M', u'm'),\n (0x1D45B, 'M', u'n'),\n (0x1D45C, 'M', u'o'),\n ]\n\ndef _seg_59():\n return [\n (0x1D45D, 'M', u'p'),\n (0x1D45E, 'M', u'q'),\n (0x1D45F, 'M', u'r'),\n (0x1D460, 'M', u's'),\n (0x1D461, 'M', u't'),\n (0x1D462, 'M', u'u'),\n (0x1D463, 'M', u'v'),\n (0x1D464, 'M', u'w'),\n (0x1D465, 'M', u'x'),\n (0x1D466, 'M', u'y'),\n (0x1D467, 'M', u'z'),\n (0x1D468, 'M', u'a'),\n (0x1D469, 'M', u'b'),\n (0x1D46A, 'M', u'c'),\n (0x1D46B, 'M', u'd'),\n (0x1D46C, 'M', u'e'),\n (0x1D46D, 'M', u'f'),\n (0x1D46E, 'M', u'g'),\n (0x1D46F, 'M', u'h'),\n (0x1D470, 'M', u'i'),\n (0x1D471, 'M', u'j'),\n (0x1D472, 'M', u'k'),\n (0x1D473, 'M', u'l'),\n (0x1D474, 'M', u'm'),\n (0x1D475, 'M', u'n'),\n (0x1D476, 'M', u'o'),\n (0x1D477, 'M', u'p'),\n (0x1D478, 'M', u'q'),\n (0x1D479, 'M', u'r'),\n (0x1D47A, 'M', u's'),\n (0x1D47B, 'M', u't'),\n (0x1D47C, 'M', u'u'),\n (0x1D47D, 'M', u'v'),\n (0x1D47E, 'M', u'w'),\n (0x1D47F, 'M', u'x'),\n (0x1D480, 'M', u'y'),\n (0x1D481, 'M', u'z'),\n (0x1D482, 'M', u'a'),\n (0x1D483, 'M', u'b'),\n (0x1D484, 'M', u'c'),\n (0x1D485, 'M', u'd'),\n (0x1D486, 'M', u'e'),\n (0x1D487, 'M', u'f'),\n (0x1D488, 'M', u'g'),\n (0x1D489, 'M', u'h'),\n (0x1D48A, 'M', u'i'),\n (0x1D48B, 'M', u'j'),\n (0x1D48C, 'M', u'k'),\n (0x1D48D, 'M', u'l'),\n (0x1D48E, 'M', u'm'),\n (0x1D48F, 'M', u'n'),\n (0x1D490, 'M', u'o'),\n (0x1D491, 'M', u'p'),\n (0x1D492, 'M', u'q'),\n (0x1D493, 'M', u'r'),\n (0x1D494, 'M', u's'),\n (0x1D495, 'M', u't'),\n (0x1D496, 'M', u'u'),\n (0x1D497, 'M', u'v'),\n (0x1D498, 'M', u'w'),\n (0x1D499, 'M', u'x'),\n (0x1D49A, 'M', u'y'),\n (0x1D49B, 'M', u'z'),\n (0x1D49C, 'M', u'a'),\n (0x1D49D, 'X'),\n (0x1D49E, 'M', u'c'),\n (0x1D49F, 'M', u'd'),\n (0x1D4A0, 'X'),\n (0x1D4A2, 'M', u'g'),\n (0x1D4A3, 'X'),\n (0x1D4A5, 'M', u'j'),\n (0x1D4A6, 'M', u'k'),\n (0x1D4A7, 'X'),\n (0x1D4A9, 'M', u'n'),\n (0x1D4AA, 'M', u'o'),\n (0x1D4AB, 'M', u'p'),\n (0x1D4AC, 'M', u'q'),\n (0x1D4AD, 'X'),\n (0x1D4AE, 'M', u's'),\n (0x1D4AF, 'M', u't'),\n (0x1D4B0, 'M', u'u'),\n (0x1D4B1, 'M', u'v'),\n (0x1D4B2, 'M', u'w'),\n (0x1D4B3, 'M', u'x'),\n (0x1D4B4, 'M', u'y'),\n (0x1D4B5, 'M', u'z'),\n (0x1D4B6, 'M', u'a'),\n (0x1D4B7, 'M', u'b'),\n (0x1D4B8, 'M', u'c'),\n (0x1D4B9, 'M', u'd'),\n (0x1D4BA, 'X'),\n (0x1D4BB, 'M', u'f'),\n (0x1D4BC, 'X'),\n (0x1D4BD, 'M', u'h'),\n (0x1D4BE, 'M', u'i'),\n (0x1D4BF, 'M', u'j'),\n (0x1D4C0, 'M', u'k'),\n (0x1D4C1, 'M', u'l'),\n (0x1D4C2, 'M', u'm'),\n (0x1D4C3, 'M', u'n'),\n ]\n\ndef _seg_60():\n return [\n (0x1D4C4, 'X'),\n (0x1D4C5, 'M', u'p'),\n (0x1D4C6, 'M', u'q'),\n (0x1D4C7, 'M', u'r'),\n (0x1D4C8, 'M', u's'),\n (0x1D4C9, 'M', u't'),\n (0x1D4CA, 'M', u'u'),\n (0x1D4CB, 'M', u'v'),\n (0x1D4CC, 'M', u'w'),\n (0x1D4CD, 'M', u'x'),\n (0x1D4CE, 'M', u'y'),\n (0x1D4CF, 'M', u'z'),\n (0x1D4D0, 'M', u'a'),\n (0x1D4D1, 'M', u'b'),\n (0x1D4D2, 'M', u'c'),\n (0x1D4D3, 'M', u'd'),\n (0x1D4D4, 'M', u'e'),\n (0x1D4D5, 'M', u'f'),\n (0x1D4D6, 'M', u'g'),\n (0x1D4D7, 'M', u'h'),\n (0x1D4D8, 'M', u'i'),\n (0x1D4D9, 'M', u'j'),\n (0x1D4DA, 'M', u'k'),\n (0x1D4DB, 'M', u'l'),\n (0x1D4DC, 'M', u'm'),\n (0x1D4DD, 'M', u'n'),\n (0x1D4DE, 'M', u'o'),\n (0x1D4DF, 'M', u'p'),\n (0x1D4E0, 'M', u'q'),\n (0x1D4E1, 'M', u'r'),\n (0x1D4E2, 'M', u's'),\n (0x1D4E3, 'M', u't'),\n (0x1D4E4, 'M', u'u'),\n (0x1D4E5, 'M', u'v'),\n (0x1D4E6, 'M', u'w'),\n (0x1D4E7, 'M', u'x'),\n (0x1D4E8, 'M', u'y'),\n (0x1D4E9, 'M', u'z'),\n (0x1D4EA, 'M', u'a'),\n (0x1D4EB, 'M', u'b'),\n (0x1D4EC, 'M', u'c'),\n (0x1D4ED, 'M', u'd'),\n (0x1D4EE, 'M', u'e'),\n (0x1D4EF, 'M', u'f'),\n (0x1D4F0, 'M', u'g'),\n (0x1D4F1, 'M', u'h'),\n (0x1D4F2, 'M', u'i'),\n (0x1D4F3, 'M', u'j'),\n (0x1D4F4, 'M', u'k'),\n (0x1D4F5, 'M', u'l'),\n (0x1D4F6, 'M', u'm'),\n (0x1D4F7, 'M', u'n'),\n (0x1D4F8, 'M', u'o'),\n (0x1D4F9, 'M', u'p'),\n (0x1D4FA, 'M', u'q'),\n (0x1D4FB, 'M', u'r'),\n (0x1D4FC, 'M', u's'),\n (0x1D4FD, 'M', u't'),\n (0x1D4FE, 'M', u'u'),\n (0x1D4FF, 'M', u'v'),\n (0x1D500, 'M', u'w'),\n (0x1D501, 'M', u'x'),\n (0x1D502, 'M', u'y'),\n (0x1D503, 'M', u'z'),\n (0x1D504, 'M', u'a'),\n (0x1D505, 'M', u'b'),\n (0x1D506, 'X'),\n (0x1D507, 'M', u'd'),\n (0x1D508, 'M', u'e'),\n (0x1D509, 'M', u'f'),\n (0x1D50A, 'M', u'g'),\n (0x1D50B, 'X'),\n (0x1D50D, 'M', u'j'),\n (0x1D50E, 'M', u'k'),\n (0x1D50F, 'M', u'l'),\n (0x1D510, 'M', u'm'),\n (0x1D511, 'M', u'n'),\n (0x1D512, 'M', u'o'),\n (0x1D513, 'M', u'p'),\n (0x1D514, 'M', u'q'),\n (0x1D515, 'X'),\n (0x1D516, 'M', u's'),\n (0x1D517, 'M', u't'),\n (0x1D518, 'M', u'u'),\n (0x1D519, 'M', u'v'),\n (0x1D51A, 'M', u'w'),\n (0x1D51B, 'M', u'x'),\n (0x1D51C, 'M', u'y'),\n (0x1D51D, 'X'),\n (0x1D51E, 'M', u'a'),\n (0x1D51F, 'M', u'b'),\n (0x1D520, 'M', u'c'),\n (0x1D521, 'M', u'd'),\n (0x1D522, 'M', u'e'),\n (0x1D523, 'M', u'f'),\n (0x1D524, 'M', u'g'),\n (0x1D525, 'M', u'h'),\n (0x1D526, 'M', u'i'),\n (0x1D527, 'M', u'j'),\n (0x1D528, 'M', u'k'),\n ]\n\ndef _seg_61():\n return [\n (0x1D529, 'M', u'l'),\n (0x1D52A, 'M', u'm'),\n (0x1D52B, 'M', u'n'),\n (0x1D52C, 'M', u'o'),\n (0x1D52D, 'M', u'p'),\n (0x1D52E, 'M', u'q'),\n (0x1D52F, 'M', u'r'),\n (0x1D530, 'M', u's'),\n (0x1D531, 'M', u't'),\n (0x1D532, 'M', u'u'),\n (0x1D533, 'M', u'v'),\n (0x1D534, 'M', u'w'),\n (0x1D535, 'M', u'x'),\n (0x1D536, 'M', u'y'),\n (0x1D537, 'M', u'z'),\n (0x1D538, 'M', u'a'),\n (0x1D539, 'M', u'b'),\n (0x1D53A, 'X'),\n (0x1D53B, 'M', u'd'),\n (0x1D53C, 'M', u'e'),\n (0x1D53D, 'M', u'f'),\n (0x1D53E, 'M', u'g'),\n (0x1D53F, 'X'),\n (0x1D540, 'M', u'i'),\n (0x1D541, 'M', u'j'),\n (0x1D542, 'M', u'k'),\n (0x1D543, 'M', u'l'),\n (0x1D544, 'M', u'm'),\n (0x1D545, 'X'),\n (0x1D546, 'M', u'o'),\n (0x1D547, 'X'),\n (0x1D54A, 'M', u's'),\n (0x1D54B, 'M', u't'),\n (0x1D54C, 'M', u'u'),\n (0x1D54D, 'M', u'v'),\n (0x1D54E, 'M', u'w'),\n (0x1D54F, 'M', u'x'),\n (0x1D550, 'M', u'y'),\n (0x1D551, 'X'),\n (0x1D552, 'M', u'a'),\n (0x1D553, 'M', u'b'),\n (0x1D554, 'M', u'c'),\n (0x1D555, 'M', u'd'),\n (0x1D556, 'M', u'e'),\n (0x1D557, 'M', u'f'),\n (0x1D558, 'M', u'g'),\n (0x1D559, 'M', u'h'),\n (0x1D55A, 'M', u'i'),\n (0x1D55B, 'M', u'j'),\n (0x1D55C, 'M', u'k'),\n (0x1D55D, 'M', u'l'),\n (0x1D55E, 'M', u'm'),\n (0x1D55F, 'M', u'n'),\n (0x1D560, 'M', u'o'),\n (0x1D561, 'M', u'p'),\n (0x1D562, 'M', u'q'),\n (0x1D563, 'M', u'r'),\n (0x1D564, 'M', u's'),\n (0x1D565, 'M', u't'),\n (0x1D566, 'M', u'u'),\n (0x1D567, 'M', u'v'),\n (0x1D568, 'M', u'w'),\n (0x1D569, 'M', u'x'),\n (0x1D56A, 'M', u'y'),\n (0x1D56B, 'M', u'z'),\n (0x1D56C, 'M', u'a'),\n (0x1D56D, 'M', u'b'),\n (0x1D56E, 'M', u'c'),\n (0x1D56F, 'M', u'd'),\n (0x1D570, 'M', u'e'),\n (0x1D571, 'M', u'f'),\n (0x1D572, 'M', u'g'),\n (0x1D573, 'M', u'h'),\n (0x1D574, 'M', u'i'),\n (0x1D575, 'M', u'j'),\n (0x1D576, 'M', u'k'),\n (0x1D577, 'M', u'l'),\n (0x1D578, 'M', u'm'),\n (0x1D579, 'M', u'n'),\n (0x1D57A, 'M', u'o'),\n (0x1D57B, 'M', u'p'),\n (0x1D57C, 'M', u'q'),\n (0x1D57D, 'M', u'r'),\n (0x1D57E, 'M', u's'),\n (0x1D57F, 'M', u't'),\n (0x1D580, 'M', u'u'),\n (0x1D581, 'M', u'v'),\n (0x1D582, 'M', u'w'),\n (0x1D583, 'M', u'x'),\n (0x1D584, 'M', u'y'),\n (0x1D585, 'M', u'z'),\n (0x1D586, 'M', u'a'),\n (0x1D587, 'M', u'b'),\n (0x1D588, 'M', u'c'),\n (0x1D589, 'M', u'd'),\n (0x1D58A, 'M', u'e'),\n (0x1D58B, 'M', u'f'),\n (0x1D58C, 'M', u'g'),\n (0x1D58D, 'M', u'h'),\n (0x1D58E, 'M', u'i'),\n ]\n\ndef _seg_62():\n return [\n (0x1D58F, 'M', u'j'),\n (0x1D590, 'M', u'k'),\n (0x1D591, 'M', u'l'),\n (0x1D592, 'M', u'm'),\n (0x1D593, 'M', u'n'),\n (0x1D594, 'M', u'o'),\n (0x1D595, 'M', u'p'),\n (0x1D596, 'M', u'q'),\n (0x1D597, 'M', u'r'),\n (0x1D598, 'M', u's'),\n (0x1D599, 'M', u't'),\n (0x1D59A, 'M', u'u'),\n (0x1D59B, 'M', u'v'),\n (0x1D59C, 'M', u'w'),\n (0x1D59D, 'M', u'x'),\n (0x1D59E, 'M', u'y'),\n (0x1D59F, 'M', u'z'),\n (0x1D5A0, 'M', u'a'),\n (0x1D5A1, 'M', u'b'),\n (0x1D5A2, 'M', u'c'),\n (0x1D5A3, 'M', u'd'),\n (0x1D5A4, 'M', u'e'),\n (0x1D5A5, 'M', u'f'),\n (0x1D5A6, 'M', u'g'),\n (0x1D5A7, 'M', u'h'),\n (0x1D5A8, 'M', u'i'),\n (0x1D5A9, 'M', u'j'),\n (0x1D5AA, 'M', u'k'),\n (0x1D5AB, 'M', u'l'),\n (0x1D5AC, 'M', u'm'),\n (0x1D5AD, 'M', u'n'),\n (0x1D5AE, 'M', u'o'),\n (0x1D5AF, 'M', u'p'),\n (0x1D5B0, 'M', u'q'),\n (0x1D5B1, 'M', u'r'),\n (0x1D5B2, 'M', u's'),\n (0x1D5B3, 'M', u't'),\n (0x1D5B4, 'M', u'u'),\n (0x1D5B5, 'M', u'v'),\n (0x1D5B6, 'M', u'w'),\n (0x1D5B7, 'M', u'x'),\n (0x1D5B8, 'M', u'y'),\n (0x1D5B9, 'M', u'z'),\n (0x1D5BA, 'M', u'a'),\n (0x1D5BB, 'M', u'b'),\n (0x1D5BC, 'M', u'c'),\n (0x1D5BD, 'M', u'd'),\n (0x1D5BE, 'M', u'e'),\n (0x1D5BF, 'M', u'f'),\n (0x1D5C0, 'M', u'g'),\n (0x1D5C1, 'M', u'h'),\n (0x1D5C2, 'M', u'i'),\n (0x1D5C3, 'M', u'j'),\n (0x1D5C4, 'M', u'k'),\n (0x1D5C5, 'M', u'l'),\n (0x1D5C6, 'M', u'm'),\n (0x1D5C7, 'M', u'n'),\n (0x1D5C8, 'M', u'o'),\n (0x1D5C9, 'M', u'p'),\n (0x1D5CA, 'M', u'q'),\n (0x1D5CB, 'M', u'r'),\n (0x1D5CC, 'M', u's'),\n (0x1D5CD, 'M', u't'),\n (0x1D5CE, 'M', u'u'),\n (0x1D5CF, 'M', u'v'),\n (0x1D5D0, 'M', u'w'),\n (0x1D5D1, 'M', u'x'),\n (0x1D5D2, 'M', u'y'),\n (0x1D5D3, 'M', u'z'),\n (0x1D5D4, 'M', u'a'),\n (0x1D5D5, 'M', u'b'),\n (0x1D5D6, 'M', u'c'),\n (0x1D5D7, 'M', u'd'),\n (0x1D5D8, 'M', u'e'),\n (0x1D5D9, 'M', u'f'),\n (0x1D5DA, 'M', u'g'),\n (0x1D5DB, 'M', u'h'),\n (0x1D5DC, 'M', u'i'),\n (0x1D5DD, 'M', u'j'),\n (0x1D5DE, 'M', u'k'),\n (0x1D5DF, 'M', u'l'),\n (0x1D5E0, 'M', u'm'),\n (0x1D5E1, 'M', u'n'),\n (0x1D5E2, 'M', u'o'),\n (0x1D5E3, 'M', u'p'),\n (0x1D5E4, 'M', u'q'),\n (0x1D5E5, 'M', u'r'),\n (0x1D5E6, 'M', u's'),\n (0x1D5E7, 'M', u't'),\n (0x1D5E8, 'M', u'u'),\n (0x1D5E9, 'M', u'v'),\n (0x1D5EA, 'M', u'w'),\n (0x1D5EB, 'M', u'x'),\n (0x1D5EC, 'M', u'y'),\n (0x1D5ED, 'M', u'z'),\n (0x1D5EE, 'M', u'a'),\n (0x1D5EF, 'M', u'b'),\n (0x1D5F0, 'M', u'c'),\n (0x1D5F1, 'M', u'd'),\n (0x1D5F2, 'M', u'e'),\n ]\n\ndef _seg_63():\n return [\n (0x1D5F3, 'M', u'f'),\n (0x1D5F4, 'M', u'g'),\n (0x1D5F5, 'M', u'h'),\n (0x1D5F6, 'M', u'i'),\n (0x1D5F7, 'M', u'j'),\n (0x1D5F8, 'M', u'k'),\n (0x1D5F9, 'M', u'l'),\n (0x1D5FA, 'M', u'm'),\n (0x1D5FB, 'M', u'n'),\n (0x1D5FC, 'M', u'o'),\n (0x1D5FD, 'M', u'p'),\n (0x1D5FE, 'M', u'q'),\n (0x1D5FF, 'M', u'r'),\n (0x1D600, 'M', u's'),\n (0x1D601, 'M', u't'),\n (0x1D602, 'M', u'u'),\n (0x1D603, 'M', u'v'),\n (0x1D604, 'M', u'w'),\n (0x1D605, 'M', u'x'),\n (0x1D606, 'M', u'y'),\n (0x1D607, 'M', u'z'),\n (0x1D608, 'M', u'a'),\n (0x1D609, 'M', u'b'),\n (0x1D60A, 'M', u'c'),\n (0x1D60B, 'M', u'd'),\n (0x1D60C, 'M', u'e'),\n (0x1D60D, 'M', u'f'),\n (0x1D60E, 'M', u'g'),\n (0x1D60F, 'M', u'h'),\n (0x1D610, 'M', u'i'),\n (0x1D611, 'M', u'j'),\n (0x1D612, 'M', u'k'),\n (0x1D613, 'M', u'l'),\n (0x1D614, 'M', u'm'),\n (0x1D615, 'M', u'n'),\n (0x1D616, 'M', u'o'),\n (0x1D617, 'M', u'p'),\n (0x1D618, 'M', u'q'),\n (0x1D619, 'M', u'r'),\n (0x1D61A, 'M', u's'),\n (0x1D61B, 'M', u't'),\n (0x1D61C, 'M', u'u'),\n (0x1D61D, 'M', u'v'),\n (0x1D61E, 'M', u'w'),\n (0x1D61F, 'M', u'x'),\n (0x1D620, 'M', u'y'),\n (0x1D621, 'M', u'z'),\n (0x1D622, 'M', u'a'),\n (0x1D623, 'M', u'b'),\n (0x1D624, 'M', u'c'),\n (0x1D625, 'M', u'd'),\n (0x1D626, 'M', u'e'),\n (0x1D627, 'M', u'f'),\n (0x1D628, 'M', u'g'),\n (0x1D629, 'M', u'h'),\n (0x1D62A, 'M', u'i'),\n (0x1D62B, 'M', u'j'),\n (0x1D62C, 'M', u'k'),\n (0x1D62D, 'M', u'l'),\n (0x1D62E, 'M', u'm'),\n (0x1D62F, 'M', u'n'),\n (0x1D630, 'M', u'o'),\n (0x1D631, 'M', u'p'),\n (0x1D632, 'M', u'q'),\n (0x1D633, 'M', u'r'),\n (0x1D634, 'M', u's'),\n (0x1D635, 'M', u't'),\n (0x1D636, 'M', u'u'),\n (0x1D637, 'M', u'v'),\n (0x1D638, 'M', u'w'),\n (0x1D639, 'M', u'x'),\n (0x1D63A, 'M', u'y'),\n (0x1D63B, 'M', u'z'),\n (0x1D63C, 'M', u'a'),\n (0x1D63D, 'M', u'b'),\n (0x1D63E, 'M', u'c'),\n (0x1D63F, 'M', u'd'),\n (0x1D640, 'M', u'e'),\n (0x1D641, 'M', u'f'),\n (0x1D642, 'M', u'g'),\n (0x1D643, 'M', u'h'),\n (0x1D644, 'M', u'i'),\n (0x1D645, 'M', u'j'),\n (0x1D646, 'M', u'k'),\n (0x1D647, 'M', u'l'),\n (0x1D648, 'M', u'm'),\n (0x1D649, 'M', u'n'),\n (0x1D64A, 'M', u'o'),\n (0x1D64B, 'M', u'p'),\n (0x1D64C, 'M', u'q'),\n (0x1D64D, 'M', u'r'),\n (0x1D64E, 'M', u's'),\n (0x1D64F, 'M', u't'),\n (0x1D650, 'M', u'u'),\n (0x1D651, 'M', u'v'),\n (0x1D652, 'M', u'w'),\n (0x1D653, 'M', u'x'),\n (0x1D654, 'M', u'y'),\n (0x1D655, 'M', u'z'),\n (0x1D656, 'M', u'a'),\n ]\n\ndef _seg_64():\n return [\n (0x1D657, 'M', u'b'),\n (0x1D658, 'M', u'c'),\n (0x1D659, 'M', u'd'),\n (0x1D65A, 'M', u'e'),\n (0x1D65B, 'M', u'f'),\n (0x1D65C, 'M', u'g'),\n (0x1D65D, 'M', u'h'),\n (0x1D65E, 'M', u'i'),\n (0x1D65F, 'M', u'j'),\n (0x1D660, 'M', u'k'),\n (0x1D661, 'M', u'l'),\n (0x1D662, 'M', u'm'),\n (0x1D663, 'M', u'n'),\n (0x1D664, 'M', u'o'),\n (0x1D665, 'M', u'p'),\n (0x1D666, 'M', u'q'),\n (0x1D667, 'M', u'r'),\n (0x1D668, 'M', u's'),\n (0x1D669, 'M', u't'),\n (0x1D66A, 'M', u'u'),\n (0x1D66B, 'M', u'v'),\n (0x1D66C, 'M', u'w'),\n (0x1D66D, 'M', u'x'),\n (0x1D66E, 'M', u'y'),\n (0x1D66F, 'M', u'z'),\n (0x1D670, 'M', u'a'),\n (0x1D671, 'M', u'b'),\n (0x1D672, 'M', u'c'),\n (0x1D673, 'M', u'd'),\n (0x1D674, 'M', u'e'),\n (0x1D675, 'M', u'f'),\n (0x1D676, 'M', u'g'),\n (0x1D677, 'M', u'h'),\n (0x1D678, 'M', u'i'),\n (0x1D679, 'M', u'j'),\n (0x1D67A, 'M', u'k'),\n (0x1D67B, 'M', u'l'),\n (0x1D67C, 'M', u'm'),\n (0x1D67D, 'M', u'n'),\n (0x1D67E, 'M', u'o'),\n (0x1D67F, 'M', u'p'),\n (0x1D680, 'M', u'q'),\n (0x1D681, 'M', u'r'),\n (0x1D682, 'M', u's'),\n (0x1D683, 'M', u't'),\n (0x1D684, 'M', u'u'),\n (0x1D685, 'M', u'v'),\n (0x1D686, 'M', u'w'),\n (0x1D687, 'M', u'x'),\n (0x1D688, 'M', u'y'),\n (0x1D689, 'M', u'z'),\n (0x1D68A, 'M', u'a'),\n (0x1D68B, 'M', u'b'),\n (0x1D68C, 'M', u'c'),\n (0x1D68D, 'M', u'd'),\n (0x1D68E, 'M', u'e'),\n (0x1D68F, 'M', u'f'),\n (0x1D690, 'M', u'g'),\n (0x1D691, 'M', u'h'),\n (0x1D692, 'M', u'i'),\n (0x1D693, 'M', u'j'),\n (0x1D694, 'M', u'k'),\n (0x1D695, 'M', u'l'),\n (0x1D696, 'M', u'm'),\n (0x1D697, 'M', u'n'),\n (0x1D698, 'M', u'o'),\n (0x1D699, 'M', u'p'),\n (0x1D69A, 'M', u'q'),\n (0x1D69B, 'M', u'r'),\n (0x1D69C, 'M', u's'),\n (0x1D69D, 'M', u't'),\n (0x1D69E, 'M', u'u'),\n (0x1D69F, 'M', u'v'),\n (0x1D6A0, 'M', u'w'),\n (0x1D6A1, 'M', u'x'),\n (0x1D6A2, 'M', u'y'),\n (0x1D6A3, 'M', u'z'),\n (0x1D6A4, 'M', u'ı'),\n (0x1D6A5, 'M', u'ȷ'),\n (0x1D6A6, 'X'),\n (0x1D6A8, 'M', u'α'),\n (0x1D6A9, 'M', u'β'),\n (0x1D6AA, 'M', u'γ'),\n (0x1D6AB, 'M', u'δ'),\n (0x1D6AC, 'M', u'ε'),\n (0x1D6AD, 'M', u'ζ'),\n (0x1D6AE, 'M', u'η'),\n (0x1D6AF, 'M', u'θ'),\n (0x1D6B0, 'M', u'ι'),\n (0x1D6B1, 'M', u'κ'),\n (0x1D6B2, 'M', u'λ'),\n (0x1D6B3, 'M', u'μ'),\n (0x1D6B4, 'M', u'ν'),\n (0x1D6B5, 'M', u'ξ'),\n (0x1D6B6, 'M', u'ο'),\n (0x1D6B7, 'M', u'π'),\n (0x1D6B8, 'M', u'ρ'),\n (0x1D6B9, 'M', u'θ'),\n (0x1D6BA, 'M', u'σ'),\n (0x1D6BB, 'M', u'τ'),\n ]\n\ndef _seg_65():\n return [\n (0x1D6BC, 'M', u'υ'),\n (0x1D6BD, 'M', u'φ'),\n (0x1D6BE, 'M', u'χ'),\n (0x1D6BF, 'M', u'ψ'),\n (0x1D6C0, 'M', u'ω'),\n (0x1D6C1, 'M', u'∇'),\n (0x1D6C2, 'M', u'α'),\n (0x1D6C3, 'M', u'β'),\n (0x1D6C4, 'M', u'γ'),\n (0x1D6C5, 'M', u'δ'),\n (0x1D6C6, 'M', u'ε'),\n (0x1D6C7, 'M', u'ζ'),\n (0x1D6C8, 'M', u'η'),\n (0x1D6C9, 'M', u'θ'),\n (0x1D6CA, 'M', u'ι'),\n (0x1D6CB, 'M', u'κ'),\n (0x1D6CC, 'M', u'λ'),\n (0x1D6CD, 'M', u'μ'),\n (0x1D6CE, 'M', u'ν'),\n (0x1D6CF, 'M', u'ξ'),\n (0x1D6D0, 'M', u'ο'),\n (0x1D6D1, 'M', u'π'),\n (0x1D6D2, 'M', u'ρ'),\n (0x1D6D3, 'M', u'σ'),\n (0x1D6D5, 'M', u'τ'),\n (0x1D6D6, 'M', u'υ'),\n (0x1D6D7, 'M', u'φ'),\n (0x1D6D8, 'M', u'χ'),\n (0x1D6D9, 'M', u'ψ'),\n (0x1D6DA, 'M', u'ω'),\n (0x1D6DB, 'M', u'∂'),\n (0x1D6DC, 'M', u'ε'),\n (0x1D6DD, 'M', u'θ'),\n (0x1D6DE, 'M', u'κ'),\n (0x1D6DF, 'M', u'φ'),\n (0x1D6E0, 'M', u'ρ'),\n (0x1D6E1, 'M', u'π'),\n (0x1D6E2, 'M', u'α'),\n (0x1D6E3, 'M', u'β'),\n (0x1D6E4, 'M', u'γ'),\n (0x1D6E5, 'M', u'δ'),\n (0x1D6E6, 'M', u'ε'),\n (0x1D6E7, 'M', u'ζ'),\n (0x1D6E8, 'M', u'η'),\n (0x1D6E9, 'M', u'θ'),\n (0x1D6EA, 'M', u'ι'),\n (0x1D6EB, 'M', u'κ'),\n (0x1D6EC, 'M', u'λ'),\n (0x1D6ED, 'M', u'μ'),\n (0x1D6EE, 'M', u'ν'),\n (0x1D6EF, 'M', u'ξ'),\n (0x1D6F0, 'M', u'ο'),\n (0x1D6F1, 'M', u'π'),\n (0x1D6F2, 'M', u'ρ'),\n (0x1D6F3, 'M', u'θ'),\n (0x1D6F4, 'M', u'σ'),\n (0x1D6F5, 'M', u'τ'),\n (0x1D6F6, 'M', u'υ'),\n (0x1D6F7, 'M', u'φ'),\n (0x1D6F8, 'M', u'χ'),\n (0x1D6F9, 'M', u'ψ'),\n (0x1D6FA, 'M', u'ω'),\n (0x1D6FB, 'M', u'∇'),\n (0x1D6FC, 'M', u'α'),\n (0x1D6FD, 'M', u'β'),\n (0x1D6FE, 'M', u'γ'),\n (0x1D6FF, 'M', u'δ'),\n (0x1D700, 'M', u'ε'),\n (0x1D701, 'M', u'ζ'),\n (0x1D702, 'M', u'η'),\n (0x1D703, 'M', u'θ'),\n (0x1D704, 'M', u'ι'),\n (0x1D705, 'M', u'κ'),\n (0x1D706, 'M', u'λ'),\n (0x1D707, 'M', u'μ'),\n (0x1D708, 'M', u'ν'),\n (0x1D709, 'M', u'ξ'),\n (0x1D70A, 'M', u'ο'),\n (0x1D70B, 'M', u'π'),\n (0x1D70C, 'M', u'ρ'),\n (0x1D70D, 'M', u'σ'),\n (0x1D70F, 'M', u'τ'),\n (0x1D710, 'M', u'υ'),\n (0x1D711, 'M', u'φ'),\n (0x1D712, 'M', u'χ'),\n (0x1D713, 'M', u'ψ'),\n (0x1D714, 'M', u'ω'),\n (0x1D715, 'M', u'∂'),\n (0x1D716, 'M', u'ε'),\n (0x1D717, 'M', u'θ'),\n (0x1D718, 'M', u'κ'),\n (0x1D719, 'M', u'φ'),\n (0x1D71A, 'M', u'ρ'),\n (0x1D71B, 'M', u'π'),\n (0x1D71C, 'M', u'α'),\n (0x1D71D, 'M', u'β'),\n (0x1D71E, 'M', u'γ'),\n (0x1D71F, 'M', u'δ'),\n (0x1D720, 'M', u'ε'),\n (0x1D721, 'M', u'ζ'),\n ]\n\ndef _seg_66():\n return [\n (0x1D722, 'M', u'η'),\n (0x1D723, 'M', u'θ'),\n (0x1D724, 'M', u'ι'),\n (0x1D725, 'M', u'κ'),\n (0x1D726, 'M', u'λ'),\n (0x1D727, 'M', u'μ'),\n (0x1D728, 'M', u'ν'),\n (0x1D729, 'M', u'ξ'),\n (0x1D72A, 'M', u'ο'),\n (0x1D72B, 'M', u'π'),\n (0x1D72C, 'M', u'ρ'),\n (0x1D72D, 'M', u'θ'),\n (0x1D72E, 'M', u'σ'),\n (0x1D72F, 'M', u'τ'),\n (0x1D730, 'M', u'υ'),\n (0x1D731, 'M', u'φ'),\n (0x1D732, 'M', u'χ'),\n (0x1D733, 'M', u'ψ'),\n (0x1D734, 'M', u'ω'),\n (0x1D735, 'M', u'∇'),\n (0x1D736, 'M', u'α'),\n (0x1D737, 'M', u'β'),\n (0x1D738, 'M', u'γ'),\n (0x1D739, 'M', u'δ'),\n (0x1D73A, 'M', u'ε'),\n (0x1D73B, 'M', u'ζ'),\n (0x1D73C, 'M', u'η'),\n (0x1D73D, 'M', u'θ'),\n (0x1D73E, 'M', u'ι'),\n (0x1D73F, 'M', u'κ'),\n (0x1D740, 'M', u'λ'),\n (0x1D741, 'M', u'μ'),\n (0x1D742, 'M', u'ν'),\n (0x1D743, 'M', u'ξ'),\n (0x1D744, 'M', u'ο'),\n (0x1D745, 'M', u'π'),\n (0x1D746, 'M', u'ρ'),\n (0x1D747, 'M', u'σ'),\n (0x1D749, 'M', u'τ'),\n (0x1D74A, 'M', u'υ'),\n (0x1D74B, 'M', u'φ'),\n (0x1D74C, 'M', u'χ'),\n (0x1D74D, 'M', u'ψ'),\n (0x1D74E, 'M', u'ω'),\n (0x1D74F, 'M', u'∂'),\n (0x1D750, 'M', u'ε'),\n (0x1D751, 'M', u'θ'),\n (0x1D752, 'M', u'κ'),\n (0x1D753, 'M', u'φ'),\n (0x1D754, 'M', u'ρ'),\n (0x1D755, 'M', u'π'),\n (0x1D756, 'M', u'α'),\n (0x1D757, 'M', u'β'),\n (0x1D758, 'M', u'γ'),\n (0x1D759, 'M', u'δ'),\n (0x1D75A, 'M', u'ε'),\n (0x1D75B, 'M', u'ζ'),\n (0x1D75C, 'M', u'η'),\n (0x1D75D, 'M', u'θ'),\n (0x1D75E, 'M', u'ι'),\n (0x1D75F, 'M', u'κ'),\n (0x1D760, 'M', u'λ'),\n (0x1D761, 'M', u'μ'),\n (0x1D762, 'M', u'ν'),\n (0x1D763, 'M', u'ξ'),\n (0x1D764, 'M', u'ο'),\n (0x1D765, 'M', u'π'),\n (0x1D766, 'M', u'ρ'),\n (0x1D767, 'M', u'θ'),\n (0x1D768, 'M', u'σ'),\n (0x1D769, 'M', u'τ'),\n (0x1D76A, 'M', u'υ'),\n (0x1D76B, 'M', u'φ'),\n (0x1D76C, 'M', u'χ'),\n (0x1D76D, 'M', u'ψ'),\n (0x1D76E, 'M', u'ω'),\n (0x1D76F, 'M', u'∇'),\n (0x1D770, 'M', u'α'),\n (0x1D771, 'M', u'β'),\n (0x1D772, 'M', u'γ'),\n (0x1D773, 'M', u'δ'),\n (0x1D774, 'M', u'ε'),\n (0x1D775, 'M', u'ζ'),\n (0x1D776, 'M', u'η'),\n (0x1D777, 'M', u'θ'),\n (0x1D778, 'M', u'ι'),\n (0x1D779, 'M', u'κ'),\n (0x1D77A, 'M', u'λ'),\n (0x1D77B, 'M', u'μ'),\n (0x1D77C, 'M', u'ν'),\n (0x1D77D, 'M', u'ξ'),\n (0x1D77E, 'M', u'ο'),\n (0x1D77F, 'M', u'π'),\n (0x1D780, 'M', u'ρ'),\n (0x1D781, 'M', u'σ'),\n (0x1D783, 'M', u'τ'),\n (0x1D784, 'M', u'υ'),\n (0x1D785, 'M', u'φ'),\n (0x1D786, 'M', u'χ'),\n (0x1D787, 'M', u'ψ'),\n ]\n\ndef _seg_67():\n return [\n (0x1D788, 'M', u'ω'),\n (0x1D789, 'M', u'∂'),\n (0x1D78A, 'M', u'ε'),\n (0x1D78B, 'M', u'θ'),\n (0x1D78C, 'M', u'κ'),\n (0x1D78D, 'M', u'φ'),\n (0x1D78E, 'M', u'ρ'),\n (0x1D78F, 'M', u'π'),\n (0x1D790, 'M', u'α'),\n (0x1D791, 'M', u'β'),\n (0x1D792, 'M', u'γ'),\n (0x1D793, 'M', u'δ'),\n (0x1D794, 'M', u'ε'),\n (0x1D795, 'M', u'ζ'),\n (0x1D796, 'M', u'η'),\n (0x1D797, 'M', u'θ'),\n (0x1D798, 'M', u'ι'),\n (0x1D799, 'M', u'κ'),\n (0x1D79A, 'M', u'λ'),\n (0x1D79B, 'M', u'μ'),\n (0x1D79C, 'M', u'ν'),\n (0x1D79D, 'M', u'ξ'),\n (0x1D79E, 'M', u'ο'),\n (0x1D79F, 'M', u'π'),\n (0x1D7A0, 'M', u'ρ'),\n (0x1D7A1, 'M', u'θ'),\n (0x1D7A2, 'M', u'σ'),\n (0x1D7A3, 'M', u'τ'),\n (0x1D7A4, 'M', u'υ'),\n (0x1D7A5, 'M', u'φ'),\n (0x1D7A6, 'M', u'χ'),\n (0x1D7A7, 'M', u'ψ'),\n (0x1D7A8, 'M', u'ω'),\n (0x1D7A9, 'M', u'∇'),\n (0x1D7AA, 'M', u'α'),\n (0x1D7AB, 'M', u'β'),\n (0x1D7AC, 'M', u'γ'),\n (0x1D7AD, 'M', u'δ'),\n (0x1D7AE, 'M', u'ε'),\n (0x1D7AF, 'M', u'ζ'),\n (0x1D7B0, 'M', u'η'),\n (0x1D7B1, 'M', u'θ'),\n (0x1D7B2, 'M', u'ι'),\n (0x1D7B3, 'M', u'κ'),\n (0x1D7B4, 'M', u'λ'),\n (0x1D7B5, 'M', u'μ'),\n (0x1D7B6, 'M', u'ν'),\n (0x1D7B7, 'M', u'ξ'),\n (0x1D7B8, 'M', u'ο'),\n (0x1D7B9, 'M', u'π'),\n (0x1D7BA, 'M', u'ρ'),\n (0x1D7BB, 'M', u'σ'),\n (0x1D7BD, 'M', u'τ'),\n (0x1D7BE, 'M', u'υ'),\n (0x1D7BF, 'M', u'φ'),\n (0x1D7C0, 'M', u'χ'),\n (0x1D7C1, 'M', u'ψ'),\n (0x1D7C2, 'M', u'ω'),\n (0x1D7C3, 'M', u'∂'),\n (0x1D7C4, 'M', u'ε'),\n (0x1D7C5, 'M', u'θ'),\n (0x1D7C6, 'M', u'κ'),\n (0x1D7C7, 'M', u'φ'),\n (0x1D7C8, 'M', u'ρ'),\n (0x1D7C9, 'M', u'π'),\n (0x1D7CA, 'M', u'ϝ'),\n (0x1D7CC, 'X'),\n (0x1D7CE, 'M', u'0'),\n (0x1D7CF, 'M', u'1'),\n (0x1D7D0, 'M', u'2'),\n (0x1D7D1, 'M', u'3'),\n (0x1D7D2, 'M', u'4'),\n (0x1D7D3, 'M', u'5'),\n (0x1D7D4, 'M', u'6'),\n (0x1D7D5, 'M', u'7'),\n (0x1D7D6, 'M', u'8'),\n (0x1D7D7, 'M', u'9'),\n (0x1D7D8, 'M', u'0'),\n (0x1D7D9, 'M', u'1'),\n (0x1D7DA, 'M', u'2'),\n (0x1D7DB, 'M', u'3'),\n (0x1D7DC, 'M', u'4'),\n (0x1D7DD, 'M', u'5'),\n (0x1D7DE, 'M', u'6'),\n (0x1D7DF, 'M', u'7'),\n (0x1D7E0, 'M', u'8'),\n (0x1D7E1, 'M', u'9'),\n (0x1D7E2, 'M', u'0'),\n (0x1D7E3, 'M', u'1'),\n (0x1D7E4, 'M', u'2'),\n (0x1D7E5, 'M', u'3'),\n (0x1D7E6, 'M', u'4'),\n (0x1D7E7, 'M', u'5'),\n (0x1D7E8, 'M', u'6'),\n (0x1D7E9, 'M', u'7'),\n (0x1D7EA, 'M', u'8'),\n (0x1D7EB, 'M', u'9'),\n (0x1D7EC, 'M', u'0'),\n (0x1D7ED, 'M', u'1'),\n (0x1D7EE, 'M', u'2'),\n ]\n\ndef _seg_68():\n return [\n (0x1D7EF, 'M', u'3'),\n (0x1D7F0, 'M', u'4'),\n (0x1D7F1, 'M', u'5'),\n (0x1D7F2, 'M', u'6'),\n (0x1D7F3, 'M', u'7'),\n (0x1D7F4, 'M', u'8'),\n (0x1D7F5, 'M', u'9'),\n (0x1D7F6, 'M', u'0'),\n (0x1D7F7, 'M', u'1'),\n (0x1D7F8, 'M', u'2'),\n (0x1D7F9, 'M', u'3'),\n (0x1D7FA, 'M', u'4'),\n (0x1D7FB, 'M', u'5'),\n (0x1D7FC, 'M', u'6'),\n (0x1D7FD, 'M', u'7'),\n (0x1D7FE, 'M', u'8'),\n (0x1D7FF, 'M', u'9'),\n (0x1D800, 'V'),\n (0x1DA8C, 'X'),\n (0x1DA9B, 'V'),\n (0x1DAA0, 'X'),\n (0x1DAA1, 'V'),\n (0x1DAB0, 'X'),\n (0x1E000, 'V'),\n (0x1E007, 'X'),\n (0x1E008, 'V'),\n (0x1E019, 'X'),\n (0x1E01B, 'V'),\n (0x1E022, 'X'),\n (0x1E023, 'V'),\n (0x1E025, 'X'),\n (0x1E026, 'V'),\n (0x1E02B, 'X'),\n (0x1E800, 'V'),\n (0x1E8C5, 'X'),\n (0x1E8C7, 'V'),\n (0x1E8D7, 'X'),\n (0x1E900, 'M', u'𞤢'),\n (0x1E901, 'M', u'𞤣'),\n (0x1E902, 'M', u'𞤤'),\n (0x1E903, 'M', u'𞤥'),\n (0x1E904, 'M', u'𞤦'),\n (0x1E905, 'M', u'𞤧'),\n (0x1E906, 'M', u'𞤨'),\n (0x1E907, 'M', u'𞤩'),\n (0x1E908, 'M', u'𞤪'),\n (0x1E909, 'M', u'𞤫'),\n (0x1E90A, 'M', u'𞤬'),\n (0x1E90B, 'M', u'𞤭'),\n (0x1E90C, 'M', u'𞤮'),\n (0x1E90D, 'M', u'𞤯'),\n (0x1E90E, 'M', u'𞤰'),\n (0x1E90F, 'M', u'𞤱'),\n (0x1E910, 'M', u'𞤲'),\n (0x1E911, 'M', u'𞤳'),\n (0x1E912, 'M', u'𞤴'),\n (0x1E913, 'M', u'𞤵'),\n (0x1E914, 'M', u'𞤶'),\n (0x1E915, 'M', u'𞤷'),\n (0x1E916, 'M', u'𞤸'),\n (0x1E917, 'M', u'𞤹'),\n (0x1E918, 'M', u'𞤺'),\n (0x1E919, 'M', u'𞤻'),\n (0x1E91A, 'M', u'𞤼'),\n (0x1E91B, 'M', u'𞤽'),\n (0x1E91C, 'M', u'𞤾'),\n (0x1E91D, 'M', u'𞤿'),\n (0x1E91E, 'M', u'𞥀'),\n (0x1E91F, 'M', u'𞥁'),\n (0x1E920, 'M', u'𞥂'),\n (0x1E921, 'M', u'𞥃'),\n (0x1E922, 'V'),\n (0x1E94B, 'X'),\n (0x1E950, 'V'),\n (0x1E95A, 'X'),\n (0x1E95E, 'V'),\n (0x1E960, 'X'),\n (0x1EC71, 'V'),\n (0x1ECB5, 'X'),\n (0x1EE00, 'M', u'ا'),\n (0x1EE01, 'M', u'ب'),\n (0x1EE02, 'M', u'ج'),\n (0x1EE03, 'M', u'د'),\n (0x1EE04, 'X'),\n (0x1EE05, 'M', u'و'),\n (0x1EE06, 'M', u'ز'),\n (0x1EE07, 'M', u'ح'),\n (0x1EE08, 'M', u'ط'),\n (0x1EE09, 'M', u'ي'),\n (0x1EE0A, 'M', u'ك'),\n (0x1EE0B, 'M', u'ل'),\n (0x1EE0C, 'M', u'م'),\n (0x1EE0D, 'M', u'ن'),\n (0x1EE0E, 'M', u'س'),\n (0x1EE0F, 'M', u'ع'),\n (0x1EE10, 'M', u'ف'),\n (0x1EE11, 'M', u'ص'),\n (0x1EE12, 'M', u'ق'),\n (0x1EE13, 'M', u'ر'),\n (0x1EE14, 'M', u'ش'),\n ]\n\ndef _seg_69():\n return [\n (0x1EE15, 'M', u'ت'),\n (0x1EE16, 'M', u'ث'),\n (0x1EE17, 'M', u'خ'),\n (0x1EE18, 'M', u'ذ'),\n (0x1EE19, 'M', u'ض'),\n (0x1EE1A, 'M', u'ظ'),\n (0x1EE1B, 'M', u'غ'),\n (0x1EE1C, 'M', u'ٮ'),\n (0x1EE1D, 'M', u'ں'),\n (0x1EE1E, 'M', u'ڡ'),\n (0x1EE1F, 'M', u'ٯ'),\n (0x1EE20, 'X'),\n (0x1EE21, 'M', u'ب'),\n (0x1EE22, 'M', u'ج'),\n (0x1EE23, 'X'),\n (0x1EE24, 'M', u'ه'),\n (0x1EE25, 'X'),\n (0x1EE27, 'M', u'ح'),\n (0x1EE28, 'X'),\n (0x1EE29, 'M', u'ي'),\n (0x1EE2A, 'M', u'ك'),\n (0x1EE2B, 'M', u'ل'),\n (0x1EE2C, 'M', u'م'),\n (0x1EE2D, 'M', u'ن'),\n (0x1EE2E, 'M', u'س'),\n (0x1EE2F, 'M', u'ع'),\n (0x1EE30, 'M', u'ف'),\n (0x1EE31, 'M', u'ص'),\n (0x1EE32, 'M', u'ق'),\n (0x1EE33, 'X'),\n (0x1EE34, 'M', u'ش'),\n (0x1EE35, 'M', u'ت'),\n (0x1EE36, 'M', u'ث'),\n (0x1EE37, 'M', u'خ'),\n (0x1EE38, 'X'),\n (0x1EE39, 'M', u'ض'),\n (0x1EE3A, 'X'),\n (0x1EE3B, 'M', u'غ'),\n (0x1EE3C, 'X'),\n (0x1EE42, 'M', u'ج'),\n (0x1EE43, 'X'),\n (0x1EE47, 'M', u'ح'),\n (0x1EE48, 'X'),\n (0x1EE49, 'M', u'ي'),\n (0x1EE4A, 'X'),\n (0x1EE4B, 'M', u'ل'),\n (0x1EE4C, 'X'),\n (0x1EE4D, 'M', u'ن'),\n (0x1EE4E, 'M', u'س'),\n (0x1EE4F, 'M', u'ع'),\n (0x1EE50, 'X'),\n (0x1EE51, 'M', u'ص'),\n (0x1EE52, 'M', u'ق'),\n (0x1EE53, 'X'),\n (0x1EE54, 'M', u'ش'),\n (0x1EE55, 'X'),\n (0x1EE57, 'M', u'خ'),\n (0x1EE58, 'X'),\n (0x1EE59, 'M', u'ض'),\n (0x1EE5A, 'X'),\n (0x1EE5B, 'M', u'غ'),\n (0x1EE5C, 'X'),\n (0x1EE5D, 'M', u'ں'),\n (0x1EE5E, 'X'),\n (0x1EE5F, 'M', u'ٯ'),\n (0x1EE60, 'X'),\n (0x1EE61, 'M', u'ب'),\n (0x1EE62, 'M', u'ج'),\n (0x1EE63, 'X'),\n (0x1EE64, 'M', u'ه'),\n (0x1EE65, 'X'),\n (0x1EE67, 'M', u'ح'),\n (0x1EE68, 'M', u'ط'),\n (0x1EE69, 'M', u'ي'),\n (0x1EE6A, 'M', u'ك'),\n (0x1EE6B, 'X'),\n (0x1EE6C, 'M', u'م'),\n (0x1EE6D, 'M', u'ن'),\n (0x1EE6E, 'M', u'س'),\n (0x1EE6F, 'M', u'ع'),\n (0x1EE70, 'M', u'ف'),\n (0x1EE71, 'M', u'ص'),\n (0x1EE72, 'M', u'ق'),\n (0x1EE73, 'X'),\n (0x1EE74, 'M', u'ش'),\n (0x1EE75, 'M', u'ت'),\n (0x1EE76, 'M', u'ث'),\n (0x1EE77, 'M', u'خ'),\n (0x1EE78, 'X'),\n (0x1EE79, 'M', u'ض'),\n (0x1EE7A, 'M', u'ظ'),\n (0x1EE7B, 'M', u'غ'),\n (0x1EE7C, 'M', u'ٮ'),\n (0x1EE7D, 'X'),\n (0x1EE7E, 'M', u'ڡ'),\n (0x1EE7F, 'X'),\n (0x1EE80, 'M', u'ا'),\n (0x1EE81, 'M', u'ب'),\n (0x1EE82, 'M', u'ج'),\n (0x1EE83, 'M', u'د'),\n ]\n\ndef _seg_70():\n return [\n (0x1EE84, 'M', u'ه'),\n (0x1EE85, 'M', u'و'),\n (0x1EE86, 'M', u'ز'),\n (0x1EE87, 'M', u'ح'),\n (0x1EE88, 'M', u'ط'),\n (0x1EE89, 'M', u'ي'),\n (0x1EE8A, 'X'),\n (0x1EE8B, 'M', u'ل'),\n (0x1EE8C, 'M', u'م'),\n (0x1EE8D, 'M', u'ن'),\n (0x1EE8E, 'M', u'س'),\n (0x1EE8F, 'M', u'ع'),\n (0x1EE90, 'M', u'ف'),\n (0x1EE91, 'M', u'ص'),\n (0x1EE92, 'M', u'ق'),\n (0x1EE93, 'M', u'ر'),\n (0x1EE94, 'M', u'ش'),\n (0x1EE95, 'M', u'ت'),\n (0x1EE96, 'M', u'ث'),\n (0x1EE97, 'M', u'خ'),\n (0x1EE98, 'M', u'ذ'),\n (0x1EE99, 'M', u'ض'),\n (0x1EE9A, 'M', u'ظ'),\n (0x1EE9B, 'M', u'غ'),\n (0x1EE9C, 'X'),\n (0x1EEA1, 'M', u'ب'),\n (0x1EEA2, 'M', u'ج'),\n (0x1EEA3, 'M', u'د'),\n (0x1EEA4, 'X'),\n (0x1EEA5, 'M', u'و'),\n (0x1EEA6, 'M', u'ز'),\n (0x1EEA7, 'M', u'ح'),\n (0x1EEA8, 'M', u'ط'),\n (0x1EEA9, 'M', u'ي'),\n (0x1EEAA, 'X'),\n (0x1EEAB, 'M', u'ل'),\n (0x1EEAC, 'M', u'م'),\n (0x1EEAD, 'M', u'ن'),\n (0x1EEAE, 'M', u'س'),\n (0x1EEAF, 'M', u'ع'),\n (0x1EEB0, 'M', u'ف'),\n (0x1EEB1, 'M', u'ص'),\n (0x1EEB2, 'M', u'ق'),\n (0x1EEB3, 'M', u'ر'),\n (0x1EEB4, 'M', u'ش'),\n (0x1EEB5, 'M', u'ت'),\n (0x1EEB6, 'M', u'ث'),\n (0x1EEB7, 'M', u'خ'),\n (0x1EEB8, 'M', u'ذ'),\n (0x1EEB9, 'M', u'ض'),\n (0x1EEBA, 'M', u'ظ'),\n (0x1EEBB, 'M', u'غ'),\n (0x1EEBC, 'X'),\n (0x1EEF0, 'V'),\n (0x1EEF2, 'X'),\n (0x1F000, 'V'),\n (0x1F02C, 'X'),\n (0x1F030, 'V'),\n (0x1F094, 'X'),\n (0x1F0A0, 'V'),\n (0x1F0AF, 'X'),\n (0x1F0B1, 'V'),\n (0x1F0C0, 'X'),\n (0x1F0C1, 'V'),\n (0x1F0D0, 'X'),\n (0x1F0D1, 'V'),\n (0x1F0F6, 'X'),\n (0x1F101, '3', u'0,'),\n (0x1F102, '3', u'1,'),\n (0x1F103, '3', u'2,'),\n (0x1F104, '3', u'3,'),\n (0x1F105, '3', u'4,'),\n (0x1F106, '3', u'5,'),\n (0x1F107, '3', u'6,'),\n (0x1F108, '3', u'7,'),\n (0x1F109, '3', u'8,'),\n (0x1F10A, '3', u'9,'),\n (0x1F10B, 'V'),\n (0x1F10D, 'X'),\n (0x1F110, '3', u'(a)'),\n (0x1F111, '3', u'(b)'),\n (0x1F112, '3', u'(c)'),\n (0x1F113, '3', u'(d)'),\n (0x1F114, '3', u'(e)'),\n (0x1F115, '3', u'(f)'),\n (0x1F116, '3', u'(g)'),\n (0x1F117, '3', u'(h)'),\n (0x1F118, '3', u'(i)'),\n (0x1F119, '3', u'(j)'),\n (0x1F11A, '3', u'(k)'),\n (0x1F11B, '3', u'(l)'),\n (0x1F11C, '3', u'(m)'),\n (0x1F11D, '3', u'(n)'),\n (0x1F11E, '3', u'(o)'),\n (0x1F11F, '3', u'(p)'),\n (0x1F120, '3', u'(q)'),\n (0x1F121, '3', u'(r)'),\n (0x1F122, '3', u'(s)'),\n (0x1F123, '3', u'(t)'),\n (0x1F124, '3', u'(u)'),\n ]\n\ndef _seg_71():\n return [\n (0x1F125, '3', u'(v)'),\n (0x1F126, '3', u'(w)'),\n (0x1F127, '3', u'(x)'),\n (0x1F128, '3', u'(y)'),\n (0x1F129, '3', u'(z)'),\n (0x1F12A, 'M', u'〔s〕'),\n (0x1F12B, 'M', u'c'),\n (0x1F12C, 'M', u'r'),\n (0x1F12D, 'M', u'cd'),\n (0x1F12E, 'M', u'wz'),\n (0x1F12F, 'V'),\n (0x1F130, 'M', u'a'),\n (0x1F131, 'M', u'b'),\n (0x1F132, 'M', u'c'),\n (0x1F133, 'M', u'd'),\n (0x1F134, 'M', u'e'),\n (0x1F135, 'M', u'f'),\n (0x1F136, 'M', u'g'),\n (0x1F137, 'M', u'h'),\n (0x1F138, 'M', u'i'),\n (0x1F139, 'M', u'j'),\n (0x1F13A, 'M', u'k'),\n (0x1F13B, 'M', u'l'),\n (0x1F13C, 'M', u'm'),\n (0x1F13D, 'M', u'n'),\n (0x1F13E, 'M', u'o'),\n (0x1F13F, 'M', u'p'),\n (0x1F140, 'M', u'q'),\n (0x1F141, 'M', u'r'),\n (0x1F142, 'M', u's'),\n (0x1F143, 'M', u't'),\n (0x1F144, 'M', u'u'),\n (0x1F145, 'M', u'v'),\n (0x1F146, 'M', u'w'),\n (0x1F147, 'M', u'x'),\n (0x1F148, 'M', u'y'),\n (0x1F149, 'M', u'z'),\n (0x1F14A, 'M', u'hv'),\n (0x1F14B, 'M', u'mv'),\n (0x1F14C, 'M', u'sd'),\n (0x1F14D, 'M', u'ss'),\n (0x1F14E, 'M', u'ppv'),\n (0x1F14F, 'M', u'wc'),\n (0x1F150, 'V'),\n (0x1F16A, 'M', u'mc'),\n (0x1F16B, 'M', u'md'),\n (0x1F16C, 'X'),\n (0x1F170, 'V'),\n (0x1F190, 'M', u'dj'),\n (0x1F191, 'V'),\n (0x1F1AD, 'X'),\n (0x1F1E6, 'V'),\n (0x1F200, 'M', u'ほか'),\n (0x1F201, 'M', u'ココ'),\n (0x1F202, 'M', u'サ'),\n (0x1F203, 'X'),\n (0x1F210, 'M', u'手'),\n (0x1F211, 'M', u'字'),\n (0x1F212, 'M', u'双'),\n (0x1F213, 'M', u'デ'),\n (0x1F214, 'M', u'二'),\n (0x1F215, 'M', u'多'),\n (0x1F216, 'M', u'解'),\n (0x1F217, 'M', u'天'),\n (0x1F218, 'M', u'交'),\n (0x1F219, 'M', u'映'),\n (0x1F21A, 'M', u'無'),\n (0x1F21B, 'M', u'料'),\n (0x1F21C, 'M', u'前'),\n (0x1F21D, 'M', u'後'),\n (0x1F21E, 'M', u'再'),\n (0x1F21F, 'M', u'新'),\n (0x1F220, 'M', u'初'),\n (0x1F221, 'M', u'終'),\n (0x1F222, 'M', u'生'),\n (0x1F223, 'M', u'販'),\n (0x1F224, 'M', u'声'),\n (0x1F225, 'M', u'吹'),\n (0x1F226, 'M', u'演'),\n (0x1F227, 'M', u'投'),\n (0x1F228, 'M', u'捕'),\n (0x1F229, 'M', u'一'),\n (0x1F22A, 'M', u'三'),\n (0x1F22B, 'M', u'遊'),\n (0x1F22C, 'M', u'左'),\n (0x1F22D, 'M', u'中'),\n (0x1F22E, 'M', u'右'),\n (0x1F22F, 'M', u'指'),\n (0x1F230, 'M', u'走'),\n (0x1F231, 'M', u'打'),\n (0x1F232, 'M', u'禁'),\n (0x1F233, 'M', u'空'),\n (0x1F234, 'M', u'合'),\n (0x1F235, 'M', u'満'),\n (0x1F236, 'M', u'有'),\n (0x1F237, 'M', u'月'),\n (0x1F238, 'M', u'申'),\n (0x1F239, 'M', u'割'),\n (0x1F23A, 'M', u'営'),\n (0x1F23B, 'M', u'配'),\n ]\n\ndef _seg_72():\n return [\n (0x1F23C, 'X'),\n (0x1F240, 'M', u'〔本〕'),\n (0x1F241, 'M', u'〔三〕'),\n (0x1F242, 'M', u'〔二〕'),\n (0x1F243, 'M', u'〔安〕'),\n (0x1F244, 'M', u'〔点〕'),\n (0x1F245, 'M', u'〔打〕'),\n (0x1F246, 'M', u'〔盗〕'),\n (0x1F247, 'M', u'〔勝〕'),\n (0x1F248, 'M', u'〔敗〕'),\n (0x1F249, 'X'),\n (0x1F250, 'M', u'得'),\n (0x1F251, 'M', u'可'),\n (0x1F252, 'X'),\n (0x1F260, 'V'),\n (0x1F266, 'X'),\n (0x1F300, 'V'),\n (0x1F6D5, 'X'),\n (0x1F6E0, 'V'),\n (0x1F6ED, 'X'),\n (0x1F6F0, 'V'),\n (0x1F6FA, 'X'),\n (0x1F700, 'V'),\n (0x1F774, 'X'),\n (0x1F780, 'V'),\n (0x1F7D9, 'X'),\n (0x1F800, 'V'),\n (0x1F80C, 'X'),\n (0x1F810, 'V'),\n (0x1F848, 'X'),\n (0x1F850, 'V'),\n (0x1F85A, 'X'),\n (0x1F860, 'V'),\n (0x1F888, 'X'),\n (0x1F890, 'V'),\n (0x1F8AE, 'X'),\n (0x1F900, 'V'),\n (0x1F90C, 'X'),\n (0x1F910, 'V'),\n (0x1F93F, 'X'),\n (0x1F940, 'V'),\n (0x1F971, 'X'),\n (0x1F973, 'V'),\n (0x1F977, 'X'),\n (0x1F97A, 'V'),\n (0x1F97B, 'X'),\n (0x1F97C, 'V'),\n (0x1F9A3, 'X'),\n (0x1F9B0, 'V'),\n (0x1F9BA, 'X'),\n (0x1F9C0, 'V'),\n (0x1F9C3, 'X'),\n (0x1F9D0, 'V'),\n (0x1FA00, 'X'),\n (0x1FA60, 'V'),\n (0x1FA6E, 'X'),\n (0x20000, 'V'),\n (0x2A6D7, 'X'),\n (0x2A700, 'V'),\n (0x2B735, 'X'),\n (0x2B740, 'V'),\n (0x2B81E, 'X'),\n (0x2B820, 'V'),\n (0x2CEA2, 'X'),\n (0x2CEB0, 'V'),\n (0x2EBE1, 'X'),\n (0x2F800, 'M', u'丽'),\n (0x2F801, 'M', u'丸'),\n (0x2F802, 'M', u'乁'),\n (0x2F803, 'M', u'𠄢'),\n (0x2F804, 'M', u'你'),\n (0x2F805, 'M', u'侮'),\n (0x2F806, 'M', u'侻'),\n (0x2F807, 'M', u'倂'),\n (0x2F808, 'M', u'偺'),\n (0x2F809, 'M', u'備'),\n (0x2F80A, 'M', u'僧'),\n (0x2F80B, 'M', u'像'),\n (0x2F80C, 'M', u'㒞'),\n (0x2F80D, 'M', u'𠘺'),\n (0x2F80E, 'M', u'免'),\n (0x2F80F, 'M', u'兔'),\n (0x2F810, 'M', u'兤'),\n (0x2F811, 'M', u'具'),\n (0x2F812, 'M', u'𠔜'),\n (0x2F813, 'M', u'㒹'),\n (0x2F814, 'M', u'內'),\n (0x2F815, 'M', u'再'),\n (0x2F816, 'M', u'𠕋'),\n (0x2F817, 'M', u'冗'),\n (0x2F818, 'M', u'冤'),\n (0x2F819, 'M', u'仌'),\n (0x2F81A, 'M', u'冬'),\n (0x2F81B, 'M', u'况'),\n (0x2F81C, 'M', u'𩇟'),\n (0x2F81D, 'M', u'凵'),\n (0x2F81E, 'M', u'刃'),\n (0x2F81F, 'M', u'㓟'),\n (0x2F820, 'M', u'刻'),\n (0x2F821, 'M', u'剆'),\n ]\n\ndef _seg_73():\n return [\n (0x2F822, 'M', u'割'),\n (0x2F823, 'M', u'剷'),\n (0x2F824, 'M', u'㔕'),\n (0x2F825, 'M', u'勇'),\n (0x2F826, 'M', u'勉'),\n (0x2F827, 'M', u'勤'),\n (0x2F828, 'M', u'勺'),\n (0x2F829, 'M', u'包'),\n (0x2F82A, 'M', u'匆'),\n (0x2F82B, 'M', u'北'),\n (0x2F82C, 'M', u'卉'),\n (0x2F82D, 'M', u'卑'),\n (0x2F82E, 'M', u'博'),\n (0x2F82F, 'M', u'即'),\n (0x2F830, 'M', u'卽'),\n (0x2F831, 'M', u'卿'),\n (0x2F834, 'M', u'𠨬'),\n (0x2F835, 'M', u'灰'),\n (0x2F836, 'M', u'及'),\n (0x2F837, 'M', u'叟'),\n (0x2F838, 'M', u'𠭣'),\n (0x2F839, 'M', u'叫'),\n (0x2F83A, 'M', u'叱'),\n (0x2F83B, 'M', u'吆'),\n (0x2F83C, 'M', u'咞'),\n (0x2F83D, 'M', u'吸'),\n (0x2F83E, 'M', u'呈'),\n (0x2F83F, 'M', u'周'),\n (0x2F840, 'M', u'咢'),\n (0x2F841, 'M', u'哶'),\n (0x2F842, 'M', u'唐'),\n (0x2F843, 'M', u'啓'),\n (0x2F844, 'M', u'啣'),\n (0x2F845, 'M', u'善'),\n (0x2F847, 'M', u'喙'),\n (0x2F848, 'M', u'喫'),\n (0x2F849, 'M', u'喳'),\n (0x2F84A, 'M', u'嗂'),\n (0x2F84B, 'M', u'圖'),\n (0x2F84C, 'M', u'嘆'),\n (0x2F84D, 'M', u'圗'),\n (0x2F84E, 'M', u'噑'),\n (0x2F84F, 'M', u'噴'),\n (0x2F850, 'M', u'切'),\n (0x2F851, 'M', u'壮'),\n (0x2F852, 'M', u'城'),\n (0x2F853, 'M', u'埴'),\n (0x2F854, 'M', u'堍'),\n (0x2F855, 'M', u'型'),\n (0x2F856, 'M', u'堲'),\n (0x2F857, 'M', u'報'),\n (0x2F858, 'M', u'墬'),\n (0x2F859, 'M', u'𡓤'),\n (0x2F85A, 'M', u'売'),\n (0x2F85B, 'M', u'壷'),\n (0x2F85C, 'M', u'夆'),\n (0x2F85D, 'M', u'多'),\n (0x2F85E, 'M', u'夢'),\n (0x2F85F, 'M', u'奢'),\n (0x2F860, 'M', u'𡚨'),\n (0x2F861, 'M', u'𡛪'),\n (0x2F862, 'M', u'姬'),\n (0x2F863, 'M', u'娛'),\n (0x2F864, 'M', u'娧'),\n (0x2F865, 'M', u'姘'),\n (0x2F866, 'M', u'婦'),\n (0x2F867, 'M', u'㛮'),\n (0x2F868, 'X'),\n (0x2F869, 'M', u'嬈'),\n (0x2F86A, 'M', u'嬾'),\n (0x2F86C, 'M', u'𡧈'),\n (0x2F86D, 'M', u'寃'),\n (0x2F86E, 'M', u'寘'),\n (0x2F86F, 'M', u'寧'),\n (0x2F870, 'M', u'寳'),\n (0x2F871, 'M', u'𡬘'),\n (0x2F872, 'M', u'寿'),\n (0x2F873, 'M', u'将'),\n (0x2F874, 'X'),\n (0x2F875, 'M', u'尢'),\n (0x2F876, 'M', u'㞁'),\n (0x2F877, 'M', u'屠'),\n (0x2F878, 'M', u'屮'),\n (0x2F879, 'M', u'峀'),\n (0x2F87A, 'M', u'岍'),\n (0x2F87B, 'M', u'𡷤'),\n (0x2F87C, 'M', u'嵃'),\n (0x2F87D, 'M', u'𡷦'),\n (0x2F87E, 'M', u'嵮'),\n (0x2F87F, 'M', u'嵫'),\n (0x2F880, 'M', u'嵼'),\n (0x2F881, 'M', u'巡'),\n (0x2F882, 'M', u'巢'),\n (0x2F883, 'M', u'㠯'),\n (0x2F884, 'M', u'巽'),\n (0x2F885, 'M', u'帨'),\n (0x2F886, 'M', u'帽'),\n (0x2F887, 'M', u'幩'),\n (0x2F888, 'M', u'㡢'),\n (0x2F889, 'M', u'𢆃'),\n ]\n\ndef _seg_74():\n return [\n (0x2F88A, 'M', u'㡼'),\n (0x2F88B, 'M', u'庰'),\n (0x2F88C, 'M', u'庳'),\n (0x2F88D, 'M', u'庶'),\n (0x2F88E, 'M', u'廊'),\n (0x2F88F, 'M', u'𪎒'),\n (0x2F890, 'M', u'廾'),\n (0x2F891, 'M', u'𢌱'),\n (0x2F893, 'M', u'舁'),\n (0x2F894, 'M', u'弢'),\n (0x2F896, 'M', u'㣇'),\n (0x2F897, 'M', u'𣊸'),\n (0x2F898, 'M', u'𦇚'),\n (0x2F899, 'M', u'形'),\n (0x2F89A, 'M', u'彫'),\n (0x2F89B, 'M', u'㣣'),\n (0x2F89C, 'M', u'徚'),\n (0x2F89D, 'M', u'忍'),\n (0x2F89E, 'M', u'志'),\n (0x2F89F, 'M', u'忹'),\n (0x2F8A0, 'M', u'悁'),\n (0x2F8A1, 'M', u'㤺'),\n (0x2F8A2, 'M', u'㤜'),\n (0x2F8A3, 'M', u'悔'),\n (0x2F8A4, 'M', u'𢛔'),\n (0x2F8A5, 'M', u'惇'),\n (0x2F8A6, 'M', u'慈'),\n (0x2F8A7, 'M', u'慌'),\n (0x2F8A8, 'M', u'慎'),\n (0x2F8A9, 'M', u'慌'),\n (0x2F8AA, 'M', u'慺'),\n (0x2F8AB, 'M', u'憎'),\n (0x2F8AC, 'M', u'憲'),\n (0x2F8AD, 'M', u'憤'),\n (0x2F8AE, 'M', u'憯'),\n (0x2F8AF, 'M', u'懞'),\n (0x2F8B0, 'M', u'懲'),\n (0x2F8B1, 'M', u'懶'),\n (0x2F8B2, 'M', u'成'),\n (0x2F8B3, 'M', u'戛'),\n (0x2F8B4, 'M', u'扝'),\n (0x2F8B5, 'M', u'抱'),\n (0x2F8B6, 'M', u'拔'),\n (0x2F8B7, 'M', u'捐'),\n (0x2F8B8, 'M', u'𢬌'),\n (0x2F8B9, 'M', u'挽'),\n (0x2F8BA, 'M', u'拼'),\n (0x2F8BB, 'M', u'捨'),\n (0x2F8BC, 'M', u'掃'),\n (0x2F8BD, 'M', u'揤'),\n (0x2F8BE, 'M', u'𢯱'),\n (0x2F8BF, 'M', u'搢'),\n (0x2F8C0, 'M', u'揅'),\n (0x2F8C1, 'M', u'掩'),\n (0x2F8C2, 'M', u'㨮'),\n (0x2F8C3, 'M', u'摩'),\n (0x2F8C4, 'M', u'摾'),\n (0x2F8C5, 'M', u'撝'),\n (0x2F8C6, 'M', u'摷'),\n (0x2F8C7, 'M', u'㩬'),\n (0x2F8C8, 'M', u'敏'),\n (0x2F8C9, 'M', u'敬'),\n (0x2F8CA, 'M', u'𣀊'),\n (0x2F8CB, 'M', u'旣'),\n (0x2F8CC, 'M', u'書'),\n (0x2F8CD, 'M', u'晉'),\n (0x2F8CE, 'M', u'㬙'),\n (0x2F8CF, 'M', u'暑'),\n (0x2F8D0, 'M', u'㬈'),\n (0x2F8D1, 'M', u'㫤'),\n (0x2F8D2, 'M', u'冒'),\n (0x2F8D3, 'M', u'冕'),\n (0x2F8D4, 'M', u'最'),\n (0x2F8D5, 'M', u'暜'),\n (0x2F8D6, 'M', u'肭'),\n (0x2F8D7, 'M', u'䏙'),\n (0x2F8D8, 'M', u'朗'),\n (0x2F8D9, 'M', u'望'),\n (0x2F8DA, 'M', u'朡'),\n (0x2F8DB, 'M', u'杞'),\n (0x2F8DC, 'M', u'杓'),\n (0x2F8DD, 'M', u'𣏃'),\n (0x2F8DE, 'M', u'㭉'),\n (0x2F8DF, 'M', u'柺'),\n (0x2F8E0, 'M', u'枅'),\n (0x2F8E1, 'M', u'桒'),\n (0x2F8E2, 'M', u'梅'),\n (0x2F8E3, 'M', u'𣑭'),\n (0x2F8E4, 'M', u'梎'),\n (0x2F8E5, 'M', u'栟'),\n (0x2F8E6, 'M', u'椔'),\n (0x2F8E7, 'M', u'㮝'),\n (0x2F8E8, 'M', u'楂'),\n (0x2F8E9, 'M', u'榣'),\n (0x2F8EA, 'M', u'槪'),\n (0x2F8EB, 'M', u'檨'),\n (0x2F8EC, 'M', u'𣚣'),\n (0x2F8ED, 'M', u'櫛'),\n (0x2F8EE, 'M', u'㰘'),\n (0x2F8EF, 'M', u'次'),\n ]\n\ndef _seg_75():\n return [\n (0x2F8F0, 'M', u'𣢧'),\n (0x2F8F1, 'M', u'歔'),\n (0x2F8F2, 'M', u'㱎'),\n (0x2F8F3, 'M', u'歲'),\n (0x2F8F4, 'M', u'殟'),\n (0x2F8F5, 'M', u'殺'),\n (0x2F8F6, 'M', u'殻'),\n (0x2F8F7, 'M', u'𣪍'),\n (0x2F8F8, 'M', u'𡴋'),\n (0x2F8F9, 'M', u'𣫺'),\n (0x2F8FA, 'M', u'汎'),\n (0x2F8FB, 'M', u'𣲼'),\n (0x2F8FC, 'M', u'沿'),\n (0x2F8FD, 'M', u'泍'),\n (0x2F8FE, 'M', u'汧'),\n (0x2F8FF, 'M', u'洖'),\n (0x2F900, 'M', u'派'),\n (0x2F901, 'M', u'海'),\n (0x2F902, 'M', u'流'),\n (0x2F903, 'M', u'浩'),\n (0x2F904, 'M', u'浸'),\n (0x2F905, 'M', u'涅'),\n (0x2F906, 'M', u'𣴞'),\n (0x2F907, 'M', u'洴'),\n (0x2F908, 'M', u'港'),\n (0x2F909, 'M', u'湮'),\n (0x2F90A, 'M', u'㴳'),\n (0x2F90B, 'M', u'滋'),\n (0x2F90C, 'M', u'滇'),\n (0x2F90D, 'M', u'𣻑'),\n (0x2F90E, 'M', u'淹'),\n (0x2F90F, 'M', u'潮'),\n (0x2F910, 'M', u'𣽞'),\n (0x2F911, 'M', u'𣾎'),\n (0x2F912, 'M', u'濆'),\n (0x2F913, 'M', u'瀹'),\n (0x2F914, 'M', u'瀞'),\n (0x2F915, 'M', u'瀛'),\n (0x2F916, 'M', u'㶖'),\n (0x2F917, 'M', u'灊'),\n (0x2F918, 'M', u'災'),\n (0x2F919, 'M', u'灷'),\n (0x2F91A, 'M', u'炭'),\n (0x2F91B, 'M', u'𠔥'),\n (0x2F91C, 'M', u'煅'),\n (0x2F91D, 'M', u'𤉣'),\n (0x2F91E, 'M', u'熜'),\n (0x2F91F, 'X'),\n (0x2F920, 'M', u'爨'),\n (0x2F921, 'M', u'爵'),\n (0x2F922, 'M', u'牐'),\n (0x2F923, 'M', u'𤘈'),\n (0x2F924, 'M', u'犀'),\n (0x2F925, 'M', u'犕'),\n (0x2F926, 'M', u'𤜵'),\n (0x2F927, 'M', u'𤠔'),\n (0x2F928, 'M', u'獺'),\n (0x2F929, 'M', u'王'),\n (0x2F92A, 'M', u'㺬'),\n (0x2F92B, 'M', u'玥'),\n (0x2F92C, 'M', u'㺸'),\n (0x2F92E, 'M', u'瑇'),\n (0x2F92F, 'M', u'瑜'),\n (0x2F930, 'M', u'瑱'),\n (0x2F931, 'M', u'璅'),\n (0x2F932, 'M', u'瓊'),\n (0x2F933, 'M', u'㼛'),\n (0x2F934, 'M', u'甤'),\n (0x2F935, 'M', u'𤰶'),\n (0x2F936, 'M', u'甾'),\n (0x2F937, 'M', u'𤲒'),\n (0x2F938, 'M', u'異'),\n (0x2F939, 'M', u'𢆟'),\n (0x2F93A, 'M', u'瘐'),\n (0x2F93B, 'M', u'𤾡'),\n (0x2F93C, 'M', u'𤾸'),\n (0x2F93D, 'M', u'𥁄'),\n (0x2F93E, 'M', u'㿼'),\n (0x2F93F, 'M', u'䀈'),\n (0x2F940, 'M', u'直'),\n (0x2F941, 'M', u'𥃳'),\n (0x2F942, 'M', u'𥃲'),\n (0x2F943, 'M', u'𥄙'),\n (0x2F944, 'M', u'𥄳'),\n (0x2F945, 'M', u'眞'),\n (0x2F946, 'M', u'真'),\n (0x2F948, 'M', u'睊'),\n (0x2F949, 'M', u'䀹'),\n (0x2F94A, 'M', u'瞋'),\n (0x2F94B, 'M', u'䁆'),\n (0x2F94C, 'M', u'䂖'),\n (0x2F94D, 'M', u'𥐝'),\n (0x2F94E, 'M', u'硎'),\n (0x2F94F, 'M', u'碌'),\n (0x2F950, 'M', u'磌'),\n (0x2F951, 'M', u'䃣'),\n (0x2F952, 'M', u'𥘦'),\n (0x2F953, 'M', u'祖'),\n (0x2F954, 'M', u'𥚚'),\n (0x2F955, 'M', u'𥛅'),\n ]\n\ndef _seg_76():\n return [\n (0x2F956, 'M', u'福'),\n (0x2F957, 'M', u'秫'),\n (0x2F958, 'M', u'䄯'),\n (0x2F959, 'M', u'穀'),\n (0x2F95A, 'M', u'穊'),\n (0x2F95B, 'M', u'穏'),\n (0x2F95C, 'M', u'𥥼'),\n (0x2F95D, 'M', u'𥪧'),\n (0x2F95F, 'X'),\n (0x2F960, 'M', u'䈂'),\n (0x2F961, 'M', u'𥮫'),\n (0x2F962, 'M', u'篆'),\n (0x2F963, 'M', u'築'),\n (0x2F964, 'M', u'䈧'),\n (0x2F965, 'M', u'𥲀'),\n (0x2F966, 'M', u'糒'),\n (0x2F967, 'M', u'䊠'),\n (0x2F968, 'M', u'糨'),\n (0x2F969, 'M', u'糣'),\n (0x2F96A, 'M', u'紀'),\n (0x2F96B, 'M', u'𥾆'),\n (0x2F96C, 'M', u'絣'),\n (0x2F96D, 'M', u'䌁'),\n (0x2F96E, 'M', u'緇'),\n (0x2F96F, 'M', u'縂'),\n (0x2F970, 'M', u'繅'),\n (0x2F971, 'M', u'䌴'),\n (0x2F972, 'M', u'𦈨'),\n (0x2F973, 'M', u'𦉇'),\n (0x2F974, 'M', u'䍙'),\n (0x2F975, 'M', u'𦋙'),\n (0x2F976, 'M', u'罺'),\n (0x2F977, 'M', u'𦌾'),\n (0x2F978, 'M', u'羕'),\n (0x2F979, 'M', u'翺'),\n (0x2F97A, 'M', u'者'),\n (0x2F97B, 'M', u'𦓚'),\n (0x2F97C, 'M', u'𦔣'),\n (0x2F97D, 'M', u'聠'),\n (0x2F97E, 'M', u'𦖨'),\n (0x2F97F, 'M', u'聰'),\n (0x2F980, 'M', u'𣍟'),\n (0x2F981, 'M', u'䏕'),\n (0x2F982, 'M', u'育'),\n (0x2F983, 'M', u'脃'),\n (0x2F984, 'M', u'䐋'),\n (0x2F985, 'M', u'脾'),\n (0x2F986, 'M', u'媵'),\n (0x2F987, 'M', u'𦞧'),\n (0x2F988, 'M', u'𦞵'),\n (0x2F989, 'M', u'𣎓'),\n (0x2F98A, 'M', u'𣎜'),\n (0x2F98B, 'M', u'舁'),\n (0x2F98C, 'M', u'舄'),\n (0x2F98D, 'M', u'辞'),\n (0x2F98E, 'M', u'䑫'),\n (0x2F98F, 'M', u'芑'),\n (0x2F990, 'M', u'芋'),\n (0x2F991, 'M', u'芝'),\n (0x2F992, 'M', u'劳'),\n (0x2F993, 'M', u'花'),\n (0x2F994, 'M', u'芳'),\n (0x2F995, 'M', u'芽'),\n (0x2F996, 'M', u'苦'),\n (0x2F997, 'M', u'𦬼'),\n (0x2F998, 'M', u'若'),\n (0x2F999, 'M', u'茝'),\n (0x2F99A, 'M', u'荣'),\n (0x2F99B, 'M', u'莭'),\n (0x2F99C, 'M', u'茣'),\n (0x2F99D, 'M', u'莽'),\n (0x2F99E, 'M', u'菧'),\n (0x2F99F, 'M', u'著'),\n (0x2F9A0, 'M', u'荓'),\n (0x2F9A1, 'M', u'菊'),\n (0x2F9A2, 'M', u'菌'),\n (0x2F9A3, 'M', u'菜'),\n (0x2F9A4, 'M', u'𦰶'),\n (0x2F9A5, 'M', u'𦵫'),\n (0x2F9A6, 'M', u'𦳕'),\n (0x2F9A7, 'M', u'䔫'),\n (0x2F9A8, 'M', u'蓱'),\n (0x2F9A9, 'M', u'蓳'),\n (0x2F9AA, 'M', u'蔖'),\n (0x2F9AB, 'M', u'𧏊'),\n (0x2F9AC, 'M', u'蕤'),\n (0x2F9AD, 'M', u'𦼬'),\n (0x2F9AE, 'M', u'䕝'),\n (0x2F9AF, 'M', u'䕡'),\n (0x2F9B0, 'M', u'𦾱'),\n (0x2F9B1, 'M', u'𧃒'),\n (0x2F9B2, 'M', u'䕫'),\n (0x2F9B3, 'M', u'虐'),\n (0x2F9B4, 'M', u'虜'),\n (0x2F9B5, 'M', u'虧'),\n (0x2F9B6, 'M', u'虩'),\n (0x2F9B7, 'M', u'蚩'),\n (0x2F9B8, 'M', u'蚈'),\n (0x2F9B9, 'M', u'蜎'),\n (0x2F9BA, 'M', u'蛢'),\n ]\n\ndef _seg_77():\n return [\n (0x2F9BB, 'M', u'蝹'),\n (0x2F9BC, 'M', u'蜨'),\n (0x2F9BD, 'M', u'蝫'),\n (0x2F9BE, 'M', u'螆'),\n (0x2F9BF, 'X'),\n (0x2F9C0, 'M', u'蟡'),\n (0x2F9C1, 'M', u'蠁'),\n (0x2F9C2, 'M', u'䗹'),\n (0x2F9C3, 'M', u'衠'),\n (0x2F9C4, 'M', u'衣'),\n (0x2F9C5, 'M', u'𧙧'),\n (0x2F9C6, 'M', u'裗'),\n (0x2F9C7, 'M', u'裞'),\n (0x2F9C8, 'M', u'䘵'),\n (0x2F9C9, 'M', u'裺'),\n (0x2F9CA, 'M', u'㒻'),\n (0x2F9CB, 'M', u'𧢮'),\n (0x2F9CC, 'M', u'𧥦'),\n (0x2F9CD, 'M', u'䚾'),\n (0x2F9CE, 'M', u'䛇'),\n (0x2F9CF, 'M', u'誠'),\n (0x2F9D0, 'M', u'諭'),\n (0x2F9D1, 'M', u'變'),\n (0x2F9D2, 'M', u'豕'),\n (0x2F9D3, 'M', u'𧲨'),\n (0x2F9D4, 'M', u'貫'),\n (0x2F9D5, 'M', u'賁'),\n (0x2F9D6, 'M', u'贛'),\n (0x2F9D7, 'M', u'起'),\n (0x2F9D8, 'M', u'𧼯'),\n (0x2F9D9, 'M', u'𠠄'),\n (0x2F9DA, 'M', u'跋'),\n (0x2F9DB, 'M', u'趼'),\n (0x2F9DC, 'M', u'跰'),\n (0x2F9DD, 'M', u'𠣞'),\n (0x2F9DE, 'M', u'軔'),\n (0x2F9DF, 'M', u'輸'),\n (0x2F9E0, 'M', u'𨗒'),\n (0x2F9E1, 'M', u'𨗭'),\n (0x2F9E2, 'M', u'邔'),\n (0x2F9E3, 'M', u'郱'),\n (0x2F9E4, 'M', u'鄑'),\n (0x2F9E5, 'M', u'𨜮'),\n (0x2F9E6, 'M', u'鄛'),\n (0x2F9E7, 'M', u'鈸'),\n (0x2F9E8, 'M', u'鋗'),\n (0x2F9E9, 'M', u'鋘'),\n (0x2F9EA, 'M', u'鉼'),\n (0x2F9EB, 'M', u'鏹'),\n (0x2F9EC, 'M', u'鐕'),\n (0x2F9ED, 'M', u'𨯺'),\n (0x2F9EE, 'M', u'開'),\n (0x2F9EF, 'M', u'䦕'),\n (0x2F9F0, 'M', u'閷'),\n (0x2F9F1, 'M', u'𨵷'),\n (0x2F9F2, 'M', u'䧦'),\n (0x2F9F3, 'M', u'雃'),\n (0x2F9F4, 'M', u'嶲'),\n (0x2F9F5, 'M', u'霣'),\n (0x2F9F6, 'M', u'𩅅'),\n (0x2F9F7, 'M', u'𩈚'),\n (0x2F9F8, 'M', u'䩮'),\n (0x2F9F9, 'M', u'䩶'),\n (0x2F9FA, 'M', u'韠'),\n (0x2F9FB, 'M', u'𩐊'),\n (0x2F9FC, 'M', u'䪲'),\n (0x2F9FD, 'M', u'𩒖'),\n (0x2F9FE, 'M', u'頋'),\n (0x2FA00, 'M', u'頩'),\n (0x2FA01, 'M', u'𩖶'),\n (0x2FA02, 'M', u'飢'),\n (0x2FA03, 'M', u'䬳'),\n (0x2FA04, 'M', u'餩'),\n (0x2FA05, 'M', u'馧'),\n (0x2FA06, 'M', u'駂'),\n (0x2FA07, 'M', u'駾'),\n (0x2FA08, 'M', u'䯎'),\n (0x2FA09, 'M', u'𩬰'),\n (0x2FA0A, 'M', u'鬒'),\n (0x2FA0B, 'M', u'鱀'),\n (0x2FA0C, 'M', u'鳽'),\n (0x2FA0D, 'M', u'䳎'),\n (0x2FA0E, 'M', u'䳭'),\n (0x2FA0F, 'M', u'鵧'),\n (0x2FA10, 'M', u'𪃎'),\n (0x2FA11, 'M', u'䳸'),\n (0x2FA12, 'M', u'𪄅'),\n (0x2FA13, 'M', u'𪈎'),\n (0x2FA14, 'M', u'𪊑'),\n (0x2FA15, 'M', u'麻'),\n (0x2FA16, 'M', u'䵖'),\n (0x2FA17, 'M', u'黹'),\n (0x2FA18, 'M', u'黾'),\n (0x2FA19, 'M', u'鼅'),\n (0x2FA1A, 'M', u'鼏'),\n (0x2FA1B, 'M', u'鼖'),\n (0x2FA1C, 'M', u'鼻'),\n (0x2FA1D, 'M', u'𪘀'),\n (0x2FA1E, 'X'),\n (0xE0100, 'I'),\n ]\n\ndef _seg_78():\n return [\n (0xE01F0, 'X'),\n ]\n\nuts46data = tuple(\n _seg_0()\n + _seg_1()\n + _seg_2()\n + _seg_3()\n + _seg_4()\n + _seg_5()\n + _seg_6()\n + _seg_7()\n + _seg_8()\n + _seg_9()\n + _seg_10()\n + _seg_11()\n + _seg_12()\n + _seg_13()\n + _seg_14()\n + _seg_15()\n + _seg_16()\n + _seg_17()\n + _seg_18()\n + _seg_19()\n + _seg_20()\n + _seg_21()\n + _seg_22()\n + _seg_23()\n + _seg_24()\n + _seg_25()\n + _seg_26()\n + _seg_27()\n + _seg_28()\n + _seg_29()\n + _seg_30()\n + _seg_31()\n + _seg_32()\n + _seg_33()\n + _seg_34()\n + _seg_35()\n + _seg_36()\n + _seg_37()\n + _seg_38()\n + _seg_39()\n + _seg_40()\n + _seg_41()\n + _seg_42()\n + _seg_43()\n + _seg_44()\n + _seg_45()\n + _seg_46()\n + _seg_47()\n + _seg_48()\n + _seg_49()\n + _seg_50()\n + _seg_51()\n + _seg_52()\n + _seg_53()\n + _seg_54()\n + _seg_55()\n + _seg_56()\n + _seg_57()\n + _seg_58()\n + _seg_59()\n + _seg_60()\n + _seg_61()\n + _seg_62()\n + _seg_63()\n + _seg_64()\n + _seg_65()\n + _seg_66()\n + _seg_67()\n + _seg_68()\n + _seg_69()\n + _seg_70()\n + _seg_71()\n + _seg_72()\n + _seg_73()\n + _seg_74()\n + _seg_75()\n + _seg_76()\n + _seg_77()\n + _seg_78()\n)\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/idna-2.8.dist-info/INSTALLER",
"content": "pip\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/idna-2.8.dist-info/LICENSE.rst",
"content": "License\n-------\n\nCopyright (c) 2013-2018, Kim Davies. All rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are met:\n\n#. Redistributions of source code must retain the above copyright\n notice, this list of conditions and the following disclaimer.\n\n#. Redistributions in binary form must reproduce the above\n copyright notice, this list of conditions and the following\n disclaimer in the documentation and/or other materials provided with\n the distribution.\n\n#. Neither the name of the copyright holder nor the names of the \n contributors may be used to endorse or promote products derived \n from this software without specific prior written permission.\n\n#. THIS SOFTWARE IS PROVIDED BY THE CONTRIBUTORS \"AS IS\" AND ANY\n EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE\n IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR\n PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR \n CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, \n SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT \n LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,\n DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY\n THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE\n USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH\n DAMAGE.\n\nPortions of the codec implementation and unit tests are derived from the\nPython standard library, which carries the `Python Software Foundation\nLicense `_:\n\n Copyright (c) 2001-2014 Python Software Foundation; All Rights Reserved\n\nPortions of the unit tests are derived from the Unicode standard, which \nis subject to the Unicode, Inc. License Agreement:\n\n Copyright (c) 1991-2014 Unicode, Inc. All rights reserved.\n Distributed under the Terms of Use in \n .\n\n Permission is hereby granted, free of charge, to any person obtaining\n a copy of the Unicode data files and any associated documentation\n (the \"Data Files\") or Unicode software and any associated documentation\n (the \"Software\") to deal in the Data Files or Software\n without restriction, including without limitation the rights to use,\n copy, modify, merge, publish, distribute, and/or sell copies of\n the Data Files or Software, and to permit persons to whom the Data Files\n or Software are furnished to do so, provided that\n \n (a) this copyright and permission notice appear with all copies \n of the Data Files or Software,\n\n (b) this copyright and permission notice appear in associated \n documentation, and\n\n (c) there is clear notice in each modified Data File or in the Software\n as well as in the documentation associated with the Data File(s) or\n Software that the data or software has been modified.\n\n THE DATA FILES AND SOFTWARE ARE PROVIDED \"AS IS\", WITHOUT WARRANTY OF\n ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE\n WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\n NONINFRINGEMENT OF THIRD PARTY RIGHTS.\n IN NO EVENT SHALL THE COPYRIGHT HOLDER OR HOLDERS INCLUDED IN THIS\n NOTICE BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL\n DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,\n DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER\n TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR\n PERFORMANCE OF THE DATA FILES OR SOFTWARE.\n\n Except as contained in this notice, the name of a copyright holder\n shall not be used in advertising or otherwise to promote the sale,\n use or other dealings in these Data Files or Software without prior\n written authorization of the copyright holder.\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/idna-2.8.dist-info/METADATA",
"content": "Metadata-Version: 2.1\nName: idna\nVersion: 2.8\nSummary: Internationalized Domain Names in Applications (IDNA)\nHome-page: https://github.com/kjd/idna\nAuthor: Kim Davies\nAuthor-email: kim@cynosure.com.au\nLicense: BSD-like\nPlatform: UNKNOWN\nClassifier: Development Status :: 5 - Production/Stable\nClassifier: Intended Audience :: Developers\nClassifier: Intended Audience :: System Administrators\nClassifier: License :: OSI Approved :: BSD License\nClassifier: Operating System :: OS Independent\nClassifier: Programming Language :: Python\nClassifier: Programming Language :: Python :: 2\nClassifier: Programming Language :: Python :: 2.7\nClassifier: Programming Language :: Python :: 3\nClassifier: Programming Language :: Python :: 3.4\nClassifier: Programming Language :: Python :: 3.5\nClassifier: Programming Language :: Python :: 3.6\nClassifier: Topic :: Internet :: Name Service (DNS)\nClassifier: Topic :: Software Development :: Libraries :: Python Modules\nClassifier: Topic :: Utilities\nRequires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*\n\nInternationalized Domain Names in Applications (IDNA)\n=====================================================\n\nSupport for the Internationalised Domain Names in Applications\n(IDNA) protocol as specified in `RFC 5891 `_.\nThis is the latest version of the protocol and is sometimes referred to as\n“IDNA 2008”.\n\nThis library also provides support for Unicode Technical Standard 46,\n`Unicode IDNA Compatibility Processing `_.\n\nThis acts as a suitable replacement for the “encodings.idna” module that\ncomes with the Python standard library, but only supports the\nold, deprecated IDNA specification (`RFC 3490 `_).\n\nBasic functions are simply executed:\n\n.. code-block:: pycon\n\n # Python 3\n >>> import idna\n >>> idna.encode('ドメイン.テスト')\n b'xn--eckwd4c7c.xn--zckzah'\n >>> print(idna.decode('xn--eckwd4c7c.xn--zckzah'))\n ドメイン.テスト\n\n # Python 2\n >>> import idna\n >>> idna.encode(u'ドメイン.テスト')\n 'xn--eckwd4c7c.xn--zckzah'\n >>> print idna.decode('xn--eckwd4c7c.xn--zckzah')\n ドメイン.テスト\n\nPackages\n--------\n\nThe latest tagged release version is published in the PyPI repository:\n\n.. image:: https://badge.fury.io/py/idna.svg\n :target: http://badge.fury.io/py/idna\n\n\nInstallation\n------------\n\nTo install this library, you can use pip:\n\n.. code-block:: bash\n\n $ pip install idna\n\nAlternatively, you can install the package using the bundled setup script:\n\n.. code-block:: bash\n\n $ python setup.py install\n\nThis library works with Python 2.7 and Python 3.4 or later.\n\n\nUsage\n-----\n\nFor typical usage, the ``encode`` and ``decode`` functions will take a domain\nname argument and perform a conversion to A-labels or U-labels respectively.\n\n.. code-block:: pycon\n\n # Python 3\n >>> import idna\n >>> idna.encode('ドメイン.テスト')\n b'xn--eckwd4c7c.xn--zckzah'\n >>> print(idna.decode('xn--eckwd4c7c.xn--zckzah'))\n ドメイン.テスト\n\nYou may use the codec encoding and decoding methods using the\n``idna.codec`` module:\n\n.. code-block:: pycon\n\n # Python 2\n >>> import idna.codec\n >>> print u'домена.испытание'.encode('idna')\n xn--80ahd1agd.xn--80akhbyknj4f\n >>> print 'xn--80ahd1agd.xn--80akhbyknj4f'.decode('idna')\n домена.испытание\n\nConversions can be applied at a per-label basis using the ``ulabel`` or ``alabel``\nfunctions if necessary:\n\n.. code-block:: pycon\n\n # Python 2\n >>> idna.alabel(u'测试')\n 'xn--0zwm56d'\n\nCompatibility Mapping (UTS #46)\n+++++++++++++++++++++++++++++++\n\nAs described in `RFC 5895 `_, the IDNA\nspecification no longer normalizes input from different potential ways a user\nmay input a domain name. This functionality, known as a “mapping”, is now\nconsidered by the specification to be a local user-interface issue distinct\nfrom IDNA conversion functionality.\n\nThis library provides one such mapping, that was developed by the Unicode\nConsortium. Known as `Unicode IDNA Compatibility Processing `_,\nit provides for both a regular mapping for typical applications, as well as\na transitional mapping to help migrate from older IDNA 2003 applications.\n\nFor example, “Königsgäßchen” is not a permissible label as *LATIN CAPITAL\nLETTER K* is not allowed (nor are capital letters in general). UTS 46 will\nconvert this into lower case prior to applying the IDNA conversion.\n\n.. code-block:: pycon\n\n # Python 3\n >>> import idna\n >>> idna.encode(u'Königsgäßchen')\n ...\n idna.core.InvalidCodepoint: Codepoint U+004B at position 1 of 'Königsgäßchen' not allowed\n >>> idna.encode('Königsgäßchen', uts46=True)\n b'xn--knigsgchen-b4a3dun'\n >>> print(idna.decode('xn--knigsgchen-b4a3dun'))\n königsgäßchen\n\nTransitional processing provides conversions to help transition from the older\n2003 standard to the current standard. For example, in the original IDNA\nspecification, the *LATIN SMALL LETTER SHARP S* (ß) was converted into two\n*LATIN SMALL LETTER S* (ss), whereas in the current IDNA specification this\nconversion is not performed.\n\n.. code-block:: pycon\n\n # Python 2\n >>> idna.encode(u'Königsgäßchen', uts46=True, transitional=True)\n 'xn--knigsgsschen-lcb0w'\n\nImplementors should use transitional processing with caution, only in rare\ncases where conversion from legacy labels to current labels must be performed\n(i.e. IDNA implementations that pre-date 2008). For typical applications\nthat just need to convert labels, transitional processing is unlikely to be\nbeneficial and could produce unexpected incompatible results.\n\n``encodings.idna`` Compatibility\n++++++++++++++++++++++++++++++++\n\nFunction calls from the Python built-in ``encodings.idna`` module are\nmapped to their IDNA 2008 equivalents using the ``idna.compat`` module.\nSimply substitute the ``import`` clause in your code to refer to the\nnew module name.\n\nExceptions\n----------\n\nAll errors raised during the conversion following the specification should\nraise an exception derived from the ``idna.IDNAError`` base class.\n\nMore specific exceptions that may be generated as ``idna.IDNABidiError``\nwhen the error reflects an illegal combination of left-to-right and right-to-left\ncharacters in a label; ``idna.InvalidCodepoint`` when a specific codepoint is\nan illegal character in an IDN label (i.e. INVALID); and ``idna.InvalidCodepointContext``\nwhen the codepoint is illegal based on its positional context (i.e. it is CONTEXTO\nor CONTEXTJ but the contextual requirements are not satisfied.)\n\nBuilding and Diagnostics\n------------------------\n\nThe IDNA and UTS 46 functionality relies upon pre-calculated lookup tables for\nperformance. These tables are derived from computing against eligibility criteria\nin the respective standards. These tables are computed using the command-line\nscript ``tools/idna-data``.\n\nThis tool will fetch relevant tables from the Unicode Consortium and perform the\nrequired calculations to identify eligibility. It has three main modes:\n\n* ``idna-data make-libdata``. Generates ``idnadata.py`` and ``uts46data.py``,\n the pre-calculated lookup tables using for IDNA and UTS 46 conversions. Implementors\n who wish to track this library against a different Unicode version may use this tool\n to manually generate a different version of the ``idnadata.py`` and ``uts46data.py``\n files.\n\n* ``idna-data make-table``. Generate a table of the IDNA disposition\n (e.g. PVALID, CONTEXTJ, CONTEXTO) in the format found in Appendix B.1 of RFC\n 5892 and the pre-computed tables published by `IANA `_.\n\n* ``idna-data U+0061``. Prints debugging output on the various properties\n associated with an individual Unicode codepoint (in this case, U+0061), that are\n used to assess the IDNA and UTS 46 status of a codepoint. This is helpful in debugging\n or analysis.\n\nThe tool accepts a number of arguments, described using ``idna-data -h``. Most notably,\nthe ``--version`` argument allows the specification of the version of Unicode to use\nin computing the table data. For example, ``idna-data --version 9.0.0 make-libdata``\nwill generate library data against Unicode 9.0.0.\n\nNote that this script requires Python 3, but all generated library data will work\nin Python 2.7.\n\n\nTesting\n-------\n\nThe library has a test suite based on each rule of the IDNA specification, as\nwell as tests that are provided as part of the Unicode Technical Standard 46,\n`Unicode IDNA Compatibility Processing `_.\n\nThe tests are run automatically on each commit at Travis CI:\n\n.. image:: https://travis-ci.org/kjd/idna.svg?branch=master\n :target: https://travis-ci.org/kjd/idna\n\n\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/idna-2.8.dist-info/RECORD",
"content": "idna-2.8.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4\r\nidna-2.8.dist-info/LICENSE.rst,sha256=DUvHq9SNz7FOJCVO5AQGZzf_AWcUTiIpFKIRO4eUaD4,3947\r\nidna-2.8.dist-info/METADATA,sha256=X4QsM_BLMPhl4gC8SEnXjvl5-gj7hvwAl7UCyR418so,8862\r\nidna-2.8.dist-info/RECORD,,\r\nidna-2.8.dist-info/WHEEL,sha256=CihQvCnsGZQBGAHLEUMf0IdA4fRduS_NBUTMgCTtvPM,110\r\nidna-2.8.dist-info/top_level.txt,sha256=jSag9sEDqvSPftxOQy-ABfGV_RSy7oFh4zZJpODV8k0,5\r\nidna/__init__.py,sha256=9Nt7xpyet3DmOrPUGooDdAwmHZZu1qUAy2EaJ93kGiQ,58\r\nidna/__pycache__/__init__.cpython-36.pyc,,\r\nidna/__pycache__/codec.cpython-36.pyc,,\r\nidna/__pycache__/compat.cpython-36.pyc,,\r\nidna/__pycache__/core.cpython-36.pyc,,\r\nidna/__pycache__/idnadata.cpython-36.pyc,,\r\nidna/__pycache__/intranges.cpython-36.pyc,,\r\nidna/__pycache__/package_data.cpython-36.pyc,,\r\nidna/__pycache__/uts46data.cpython-36.pyc,,\r\nidna/codec.py,sha256=lvYb7yu7PhAqFaAIAdWcwgaWI2UmgseUua-1c0AsG0A,3299\r\nidna/compat.py,sha256=R-h29D-6mrnJzbXxymrWUW7iZUvy-26TQwZ0ij57i4U,232\r\nidna/core.py,sha256=JDCZZ_PLESqIgEbU8mPyoEufWwoOiIqygA17-QZIe3s,11733\r\nidna/idnadata.py,sha256=HXaPFw6_YAJ0qppACPu0YLAULtRs3QovRM_CCZHGdY0,40899\r\nidna/intranges.py,sha256=TY1lpxZIQWEP6tNqjZkFA5hgoMWOj1OBmnUG8ihT87E,1749\r\nidna/package_data.py,sha256=kIzeKKXEouXLR4srqwf9Q3zv-NffKSOz5aSDOJARPB0,21\r\nidna/uts46data.py,sha256=oLyNZ1pBaiBlj9zFzLFRd_P7J8MkRcgDisjExZR_4MY,198292\r\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/idna-2.8.dist-info/WHEEL",
"content": "Wheel-Version: 1.0\nGenerator: bdist_wheel (0.32.2)\nRoot-Is-Purelib: true\nTag: py2-none-any\nTag: py3-none-any\n\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/idna-2.8.dist-info/top_level.txt",
"content": "idna\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/incremental/__init__.py",
"content": "# Copyright (c) Twisted Matrix Laboratories.\n# See LICENSE for details.\n\n\"\"\"\nVersions for Python packages.\n\nSee L{Version}.\n\"\"\"\n\nfrom __future__ import division, absolute_import\n\nimport sys\nimport warnings\n\n#\n# Compat functions\n#\n\nif sys.version_info < (3, 0):\n _PY3 = False\nelse:\n _PY3 = True\n\ntry:\n _cmp = cmp\nexcept NameError:\n def _cmp(a, b):\n \"\"\"\n Compare two objects.\n\n Returns a negative number if C{a < b}, zero if they are equal, and a\n positive number if C{a > b}.\n \"\"\"\n if a < b:\n return -1\n elif a == b:\n return 0\n else:\n return 1\n\n\ndef _comparable(klass):\n \"\"\"\n Class decorator that ensures support for the special C{__cmp__} method.\n\n On Python 2 this does nothing.\n\n On Python 3, C{__eq__}, C{__lt__}, etc. methods are added to the class,\n relying on C{__cmp__} to implement their comparisons.\n \"\"\"\n # On Python 2, __cmp__ will just work, so no need to add extra methods:\n if not _PY3:\n return klass\n\n def __eq__(self, other):\n c = self.__cmp__(other)\n if c is NotImplemented:\n return c\n return c == 0\n\n def __ne__(self, other):\n c = self.__cmp__(other)\n if c is NotImplemented:\n return c\n return c != 0\n\n def __lt__(self, other):\n c = self.__cmp__(other)\n if c is NotImplemented:\n return c\n return c < 0\n\n def __le__(self, other):\n c = self.__cmp__(other)\n if c is NotImplemented:\n return c\n return c <= 0\n\n def __gt__(self, other):\n c = self.__cmp__(other)\n if c is NotImplemented:\n return c\n return c > 0\n\n def __ge__(self, other):\n c = self.__cmp__(other)\n if c is NotImplemented:\n return c\n return c >= 0\n\n klass.__lt__ = __lt__\n klass.__gt__ = __gt__\n klass.__le__ = __le__\n klass.__ge__ = __ge__\n klass.__eq__ = __eq__\n klass.__ne__ = __ne__\n return klass\n\n#\n# Versioning\n#\n\n\n@_comparable\nclass _inf(object):\n \"\"\"\n An object that is bigger than all other objects.\n \"\"\"\n def __cmp__(self, other):\n \"\"\"\n @param other: Another object.\n @type other: any\n\n @return: 0 if other is inf, 1 otherwise.\n @rtype: C{int}\n \"\"\"\n if other is _inf:\n return 0\n return 1\n\n\n_inf = _inf()\n\n\nclass IncomparableVersions(TypeError):\n \"\"\"\n Two versions could not be compared.\n \"\"\"\n\n\n@_comparable\nclass Version(object):\n \"\"\"\n An encapsulation of a version for a project, with support for outputting\n PEP-440 compatible version strings.\n\n This class supports the standard major.minor.micro[rcN] scheme of\n versioning.\n \"\"\"\n def __init__(self, package, major, minor, micro, release_candidate=None,\n prerelease=None, dev=None):\n \"\"\"\n @param package: Name of the package that this is a version of.\n @type package: C{str}\n @param major: The major version number.\n @type major: C{int} or C{str} (for the \"NEXT\" symbol)\n @param minor: The minor version number.\n @type minor: C{int}\n @param micro: The micro version number.\n @type micro: C{int}\n @param release_candidate: The release candidate number.\n @type release_candidate: C{int}\n @param prerelease: The prerelease number. (Deprecated)\n @type prerelease: C{int}\n @param dev: The development release number.\n @type dev: C{int}\n \"\"\"\n if release_candidate and prerelease:\n raise ValueError(\"Please only return one of these.\")\n elif prerelease and not release_candidate:\n release_candidate = prerelease\n warnings.warn((\"Passing prerelease to incremental.Version was \"\n \"deprecated in Incremental 16.9.0. Please pass \"\n \"release_candidate instead.\"),\n DeprecationWarning, stacklevel=2)\n\n if major == \"NEXT\":\n if minor or micro or release_candidate or dev:\n raise ValueError((\"When using NEXT, all other values except \"\n \"Package must be 0.\"))\n\n self.package = package\n self.major = major\n self.minor = minor\n self.micro = micro\n self.release_candidate = release_candidate\n self.dev = dev\n\n @property\n def prerelease(self):\n warnings.warn((\"Accessing incremental.Version.prerelease was \"\n \"deprecated in Incremental 16.9.0. Use \"\n \"Version.release_candidate instead.\"),\n DeprecationWarning, stacklevel=2),\n return self.release_candidate\n\n def public(self):\n \"\"\"\n Return a PEP440-compatible \"public\" representation of this L{Version}.\n\n Examples:\n\n - 14.4.0\n - 1.2.3rc1\n - 14.2.1rc1dev9\n - 16.04.0dev0\n \"\"\"\n if self.major == \"NEXT\":\n return self.major\n\n if self.release_candidate is None:\n rc = \"\"\n else:\n rc = \"rc%s\" % (self.release_candidate,)\n\n if self.dev is None:\n dev = \"\"\n else:\n dev = \"dev%s\" % (self.dev,)\n\n return '%r.%d.%d%s%s' % (self.major,\n self.minor,\n self.micro,\n rc, dev)\n\n base = public\n short = public\n local = public\n\n def __repr__(self):\n\n if self.release_candidate is None:\n release_candidate = \"\"\n else:\n release_candidate = \", release_candidate=%r\" % (\n self.release_candidate,)\n\n if self.dev is None:\n dev = \"\"\n else:\n dev = \", dev=%r\" % (self.dev,)\n\n return '%s(%r, %r, %d, %d%s%s)' % (\n self.__class__.__name__,\n self.package,\n self.major,\n self.minor,\n self.micro,\n release_candidate,\n dev)\n\n def __str__(self):\n return '[%s, version %s]' % (\n self.package,\n self.short())\n\n def __cmp__(self, other):\n \"\"\"\n Compare two versions, considering major versions, minor versions, micro\n versions, then release candidates. Package names are case insensitive.\n\n A version with a release candidate is always less than a version\n without a release candidate. If both versions have release candidates,\n they will be included in the comparison.\n\n @param other: Another version.\n @type other: L{Version}\n\n @return: NotImplemented when the other object is not a Version, or one\n of -1, 0, or 1.\n\n @raise IncomparableVersions: when the package names of the versions\n differ.\n \"\"\"\n if not isinstance(other, self.__class__):\n return NotImplemented\n if self.package.lower() != other.package.lower():\n raise IncomparableVersions(\"%r != %r\"\n % (self.package, other.package))\n\n if self.major == \"NEXT\":\n major = _inf\n else:\n major = self.major\n\n if self.release_candidate is None:\n release_candidate = _inf\n else:\n release_candidate = self.release_candidate\n\n if self.dev is None:\n dev = _inf\n else:\n dev = self.dev\n\n if other.major == \"NEXT\":\n othermajor = _inf\n else:\n othermajor = other.major\n\n if other.release_candidate is None:\n otherrc = _inf\n else:\n otherrc = other.release_candidate\n\n if other.dev is None:\n otherdev = _inf\n else:\n otherdev = other.dev\n\n x = _cmp((major,\n self.minor,\n self.micro,\n release_candidate,\n dev),\n (othermajor,\n other.minor,\n other.micro,\n otherrc,\n otherdev))\n return x\n\n\ndef getVersionString(version):\n \"\"\"\n Get a friendly string for the given version object.\n\n @param version: A L{Version} object.\n @return: A string containing the package and short version number.\n \"\"\"\n result = '%s %s' % (version.package, version.short())\n return result\n\n\ndef _get_version(dist, keyword, value):\n \"\"\"\n Get the version from the package listed in the Distribution.\n \"\"\"\n if not value:\n return\n\n from distutils.command import build_py\n\n sp_command = build_py.build_py(dist)\n sp_command.finalize_options()\n\n for item in sp_command.find_all_modules():\n if item[1] == \"_version\":\n version_file = {}\n\n with open(item[2]) as f:\n exec(f.read(), version_file)\n\n dist.metadata.version = version_file[\"__version__\"].public()\n return None\n\n raise Exception(\"No _version.py found.\")\n\n\nfrom ._version import __version__ # noqa\n\n\n__all__ = [\"__version__\", \"Version\", \"getVersionString\"]\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/incremental/_version.py",
"content": "\"\"\"\nProvides Incremental version information.\n\"\"\"\n\n# This file is auto-generated! Do not edit!\n# Use `python -m incremental.update Incremental` to change this file.\n\nfrom incremental import Version\n\n__version__ = Version('Incremental', 17, 5, 0)\n__all__ = [\"__version__\"]\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/incremental/tests/__init__.py",
"content": ""
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/incremental/tests/test_update.py",
"content": "# Copyright (c) Twisted Matrix Laboratories.\n# See LICENSE for details.\n\n\"\"\"\nTests for L{incremental.update}.\n\"\"\"\n\nfrom __future__ import division, absolute_import\n\nimport sys\nimport os\nimport datetime\n\nfrom twisted.python.filepath import FilePath\nfrom twisted.python.compat import NativeStringIO\nfrom twisted.trial.unittest import TestCase\n\nfrom incremental.update import _run, run\n\n\nclass NonCreatedUpdateTests(TestCase):\n\n def setUp(self):\n\n self.srcdir = FilePath(self.mktemp())\n self.srcdir.makedirs()\n\n packagedir = self.srcdir.child('inctestpkg')\n packagedir.makedirs()\n\n packagedir.child('__init__.py').setContent(b\"\"\"\nfrom incremental import Version\nintroduced_in = Version('inctestpkg', 'NEXT', 0, 0).short()\nnext_released_version = \"inctestpkg NEXT\"\n\"\"\")\n self.getcwd = lambda: self.srcdir.path\n self.packagedir = packagedir\n\n class Date(object):\n year = 2016\n month = 8\n\n self.date = Date()\n\n def test_create(self):\n \"\"\"\n `incremental.update package --create` initialises the version.\n \"\"\"\n self.assertFalse(self.packagedir.child(\"_version.py\").exists())\n\n out = []\n _run('inctestpkg', path=None, newversion=None, patch=False, rc=False,\n dev=False, create=True, _date=self.date, _getcwd=self.getcwd,\n _print=out.append)\n\n self.assertTrue(self.packagedir.child(\"_version.py\").exists())\n self.assertEqual(self.packagedir.child(\"_version.py\").getContent(),\n b'''\"\"\"\nProvides inctestpkg version information.\n\"\"\"\n\n# This file is auto-generated! Do not edit!\n# Use `python -m incremental.update inctestpkg` to change this file.\n\nfrom incremental import Version\n\n__version__ = Version('inctestpkg', 16, 8, 0)\n__all__ = [\"__version__\"]\n''')\n\n\nclass MissingTests(TestCase):\n\n def setUp(self):\n\n self.srcdir = FilePath(self.mktemp())\n self.srcdir.makedirs()\n\n self.srcdir.child('srca').makedirs()\n\n packagedir = self.srcdir.child('srca').child('inctestpkg')\n packagedir.makedirs()\n\n packagedir.child('__init__.py').setContent(b\"\"\"\nfrom incremental import Version\nintroduced_in = Version('inctestpkg', 'NEXT', 0, 0).short()\nnext_released_version = \"inctestpkg NEXT\"\n\"\"\")\n packagedir.child('_version.py').setContent(b\"\"\"\nfrom incremental import Version\n__version__ = Version('inctestpkg', 1, 2, 3)\n__all__ = [\"__version__\"]\n\"\"\")\n self.getcwd = lambda: self.srcdir.path\n self.packagedir = packagedir\n\n class Date(object):\n year = 2016\n month = 8\n\n self.date = Date()\n\n def test_path(self):\n \"\"\"\n `incremental.update package --dev` raises and quits if it can't find\n the package.\n \"\"\"\n out = []\n with self.assertRaises(ValueError):\n _run(u'inctestpkg', path=None, newversion=None,\n patch=False, rc=False, dev=True, create=False,\n _date=self.date, _getcwd=self.getcwd, _print=out.append)\n\n\nclass CreatedUpdateInSrcTests(TestCase):\n\n def setUp(self):\n\n self.srcdir = FilePath(self.mktemp())\n self.srcdir.makedirs()\n\n self.srcdir.child('src').makedirs()\n\n packagedir = self.srcdir.child('src').child('inctestpkg')\n packagedir.makedirs()\n\n packagedir.child('__init__.py').setContent(b\"\"\"\nfrom incremental import Version\nintroduced_in = Version('inctestpkg', 'NEXT', 0, 0).short()\nnext_released_version = \"inctestpkg NEXT\"\n\"\"\")\n packagedir.child('_version.py').setContent(b\"\"\"\nfrom incremental import Version\n__version__ = Version('inctestpkg', 1, 2, 3)\n__all__ = [\"__version__\"]\n\"\"\")\n self.getcwd = lambda: self.srcdir.path\n self.packagedir = packagedir\n\n class Date(object):\n year = 2016\n month = 8\n\n self.date = Date()\n\n def test_path(self):\n \"\"\"\n `incremental.update package --path= --dev` increments the dev\n version of the package on the given path\n \"\"\"\n out = []\n _run(u'inctestpkg', path=None, newversion=None,\n patch=False, rc=False, dev=True, create=False, _date=self.date,\n _getcwd=self.getcwd, _print=out.append)\n\n self.assertTrue(self.packagedir.child(\"_version.py\").exists())\n self.assertEqual(self.packagedir.child(\"_version.py\").getContent(),\n b'''\"\"\"\nProvides inctestpkg version information.\n\"\"\"\n\n# This file is auto-generated! Do not edit!\n# Use `python -m incremental.update inctestpkg` to change this file.\n\nfrom incremental import Version\n\n__version__ = Version('inctestpkg', 1, 2, 3, dev=0)\n__all__ = [\"__version__\"]\n''')\n\n _run(u'inctestpkg', path=None, newversion=None,\n patch=False, rc=False, dev=True, create=False, _date=self.date,\n _getcwd=self.getcwd, _print=out.append)\n\n self.assertTrue(self.packagedir.child(\"_version.py\").exists())\n self.assertEqual(self.packagedir.child(\"_version.py\").getContent(),\n b'''\"\"\"\nProvides inctestpkg version information.\n\"\"\"\n\n# This file is auto-generated! Do not edit!\n# Use `python -m incremental.update inctestpkg` to change this file.\n\nfrom incremental import Version\n\n__version__ = Version('inctestpkg', 1, 2, 3, dev=1)\n__all__ = [\"__version__\"]\n''')\n\n\nclass CreatedUpdateTests(TestCase):\n\n maxDiff = None\n\n def setUp(self):\n\n self.srcdir = FilePath(self.mktemp())\n self.srcdir.makedirs()\n\n packagedir = self.srcdir.child('inctestpkg')\n packagedir.makedirs()\n\n packagedir.child('__init__.py').setContent(b\"\"\"\nfrom incremental import Version\nintroduced_in = Version('inctestpkg', 'NEXT', 0, 0).short()\nnext_released_version = \"inctestpkg NEXT\"\n\"\"\")\n packagedir.child('_version.py').setContent(b\"\"\"\nfrom incremental import Version\n__version__ = Version('inctestpkg', 1, 2, 3)\n__all__ = [\"__version__\"]\n\"\"\")\n self.getcwd = lambda: self.srcdir.path\n self.packagedir = packagedir\n\n class Date(object):\n year = 2016\n month = 8\n\n self.date = Date()\n\n def test_path(self):\n \"\"\"\n `incremental.update package --path= --dev` increments the dev\n version of the package on the given path\n \"\"\"\n out = []\n _run(u'inctestpkg', path=self.packagedir.path, newversion=None,\n patch=False, rc=False, dev=True, create=False, _date=self.date,\n _print=out.append)\n\n self.assertTrue(self.packagedir.child(\"_version.py\").exists())\n self.assertEqual(self.packagedir.child(\"_version.py\").getContent(),\n b'''\"\"\"\nProvides inctestpkg version information.\n\"\"\"\n\n# This file is auto-generated! Do not edit!\n# Use `python -m incremental.update inctestpkg` to change this file.\n\nfrom incremental import Version\n\n__version__ = Version('inctestpkg', 1, 2, 3, dev=0)\n__all__ = [\"__version__\"]\n''')\n\n def test_dev(self):\n \"\"\"\n `incremental.update package --dev` increments the dev version.\n \"\"\"\n out = []\n _run(u'inctestpkg', path=None, newversion=None, patch=False, rc=False,\n dev=True, create=False, _date=self.date, _getcwd=self.getcwd,\n _print=out.append)\n\n self.assertTrue(self.packagedir.child(\"_version.py\").exists())\n self.assertEqual(self.packagedir.child(\"_version.py\").getContent(),\n b'''\"\"\"\nProvides inctestpkg version information.\n\"\"\"\n\n# This file is auto-generated! Do not edit!\n# Use `python -m incremental.update inctestpkg` to change this file.\n\nfrom incremental import Version\n\n__version__ = Version('inctestpkg', 1, 2, 3, dev=0)\n__all__ = [\"__version__\"]\n''')\n\n def test_patch(self):\n \"\"\"\n `incremental.update package --patch` increments the patch version.\n \"\"\"\n out = []\n _run(u'inctestpkg', path=None, newversion=None, patch=True, rc=False,\n dev=False, create=False, _date=self.date, _getcwd=self.getcwd,\n _print=out.append)\n\n self.assertEqual(self.packagedir.child(\"_version.py\").getContent(),\n b'''\"\"\"\nProvides inctestpkg version information.\n\"\"\"\n\n# This file is auto-generated! Do not edit!\n# Use `python -m incremental.update inctestpkg` to change this file.\n\nfrom incremental import Version\n\n__version__ = Version('inctestpkg', 1, 2, 4)\n__all__ = [\"__version__\"]\n''')\n self.assertEqual(self.packagedir.child(\"__init__.py\").getContent(),\n b\"\"\"\nfrom incremental import Version\nintroduced_in = Version('inctestpkg', 1, 2, 4).short()\nnext_released_version = \"inctestpkg 1.2.4\"\n\"\"\")\n\n def test_patch_with_prerelease_and_dev(self):\n \"\"\"\n `incremental.update package --patch` increments the patch version, and\n disregards any old prerelease/dev versions.\n \"\"\"\n self.packagedir.child('_version.py').setContent(b\"\"\"\nfrom incremental import Version\n__version__ = Version('inctestpkg', 1, 2, 3, release_candidate=1, dev=2)\n__all__ = [\"__version__\"]\n\"\"\")\n\n out = []\n _run(u'inctestpkg', path=None, newversion=None, patch=True, rc=False,\n dev=False, create=False, _date=self.date, _getcwd=self.getcwd,\n _print=out.append)\n\n self.assertEqual(self.packagedir.child(\"_version.py\").getContent(),\n b'''\"\"\"\nProvides inctestpkg version information.\n\"\"\"\n\n# This file is auto-generated! Do not edit!\n# Use `python -m incremental.update inctestpkg` to change this file.\n\nfrom incremental import Version\n\n__version__ = Version('inctestpkg', 1, 2, 4)\n__all__ = [\"__version__\"]\n''')\n\n def test_rc_patch(self):\n \"\"\"\n `incremental.update package --patch --rc` increments the patch\n version and makes it a release candidate.\n \"\"\"\n out = []\n _run(u'inctestpkg', path=None, newversion=None, patch=True, rc=True,\n dev=False, create=False, _date=self.date, _getcwd=self.getcwd,\n _print=out.append)\n\n self.assertEqual(self.packagedir.child(\"_version.py\").getContent(),\n b'''\"\"\"\nProvides inctestpkg version information.\n\"\"\"\n\n# This file is auto-generated! Do not edit!\n# Use `python -m incremental.update inctestpkg` to change this file.\n\nfrom incremental import Version\n\n__version__ = Version('inctestpkg', 1, 2, 4, release_candidate=1)\n__all__ = [\"__version__\"]\n''')\n self.assertEqual(self.packagedir.child(\"__init__.py\").getContent(),\n b\"\"\"\nfrom incremental import Version\nintroduced_in = Version('inctestpkg', 1, 2, 4, release_candidate=1).short()\nnext_released_version = \"inctestpkg 1.2.4rc1\"\n\"\"\")\n\n def test_rc_with_existing_rc(self):\n \"\"\"\n `incremental.update package --rc` increments the rc version if the\n existing version is an rc, and discards any dev version.\n \"\"\"\n self.packagedir.child('_version.py').setContent(b\"\"\"\nfrom incremental import Version\n__version__ = Version('inctestpkg', 1, 2, 3, release_candidate=1, dev=2)\n__all__ = [\"__version__\"]\n\"\"\")\n\n out = []\n _run(u'inctestpkg', path=None, newversion=None, patch=False, rc=True,\n dev=False, create=False, _date=self.date, _getcwd=self.getcwd,\n _print=out.append)\n\n self.assertEqual(self.packagedir.child(\"_version.py\").getContent(),\n b'''\"\"\"\nProvides inctestpkg version information.\n\"\"\"\n\n# This file is auto-generated! Do not edit!\n# Use `python -m incremental.update inctestpkg` to change this file.\n\nfrom incremental import Version\n\n__version__ = Version('inctestpkg', 1, 2, 3, release_candidate=2)\n__all__ = [\"__version__\"]\n''')\n self.assertEqual(self.packagedir.child(\"__init__.py\").getContent(),\n b\"\"\"\nfrom incremental import Version\nintroduced_in = Version('inctestpkg', 1, 2, 3, release_candidate=2).short()\nnext_released_version = \"inctestpkg 1.2.3rc2\"\n\"\"\")\n\n def test_rc_with_no_rc(self):\n \"\"\"\n `incremental.update package --rc`, when the package is not a release\n candidate, will issue a new major/minor rc, and disregards the micro\n and dev.\n \"\"\"\n self.packagedir.child('_version.py').setContent(b\"\"\"\nfrom incremental import Version\n__version__ = Version('inctestpkg', 1, 2, 3, dev=2)\n__all__ = [\"__version__\"]\n\"\"\")\n\n out = []\n _run(u'inctestpkg', path=None, newversion=None, patch=False, rc=True,\n dev=False, create=False, _date=self.date, _getcwd=self.getcwd,\n _print=out.append)\n\n self.assertEqual(self.packagedir.child(\"_version.py\").getContent(),\n b'''\"\"\"\nProvides inctestpkg version information.\n\"\"\"\n\n# This file is auto-generated! Do not edit!\n# Use `python -m incremental.update inctestpkg` to change this file.\n\nfrom incremental import Version\n\n__version__ = Version('inctestpkg', 16, 8, 0, release_candidate=1)\n__all__ = [\"__version__\"]\n''')\n self.assertEqual(self.packagedir.child(\"__init__.py\").getContent(),\n b\"\"\"\nfrom incremental import Version\nintroduced_in = Version('inctestpkg', 16, 8, 0, release_candidate=1).short()\nnext_released_version = \"inctestpkg 16.8.0rc1\"\n\"\"\")\n\n def test_full_with_rc(self):\n \"\"\"\n `incremental.update package`, when the package is a release\n candidate, will issue the major/minor, sans release candidate or dev.\n \"\"\"\n out = []\n _run(u'inctestpkg', path=None, newversion=None, patch=False, rc=True,\n dev=False, create=False, _date=self.date, _getcwd=self.getcwd,\n _print=out.append)\n\n self.assertEqual(self.packagedir.child(\"_version.py\").getContent(),\n b'''\"\"\"\nProvides inctestpkg version information.\n\"\"\"\n\n# This file is auto-generated! Do not edit!\n# Use `python -m incremental.update inctestpkg` to change this file.\n\nfrom incremental import Version\n\n__version__ = Version('inctestpkg', 16, 8, 0, release_candidate=1)\n__all__ = [\"__version__\"]\n''')\n self.assertEqual(self.packagedir.child(\"__init__.py\").getContent(),\n b\"\"\"\nfrom incremental import Version\nintroduced_in = Version('inctestpkg', 16, 8, 0, release_candidate=1).short()\nnext_released_version = \"inctestpkg 16.8.0rc1\"\n\"\"\")\n\n _run(u'inctestpkg', path=None, newversion=None, patch=False, rc=False,\n dev=False, create=False, _date=self.date, _getcwd=self.getcwd,\n _print=out.append)\n\n self.assertEqual(self.packagedir.child(\"_version.py\").getContent(),\n b'''\"\"\"\nProvides inctestpkg version information.\n\"\"\"\n\n# This file is auto-generated! Do not edit!\n# Use `python -m incremental.update inctestpkg` to change this file.\n\nfrom incremental import Version\n\n__version__ = Version('inctestpkg', 16, 8, 0)\n__all__ = [\"__version__\"]\n''')\n self.assertEqual(self.packagedir.child(\"__init__.py\").getContent(),\n b\"\"\"\nfrom incremental import Version\nintroduced_in = Version('inctestpkg', 16, 8, 0).short()\nnext_released_version = \"inctestpkg 16.8.0\"\n\"\"\")\n\n def test_full_without_rc(self):\n \"\"\"\n `incremental.update package`, when the package is NOT a release\n candidate, will raise an error.\n \"\"\"\n out = []\n with self.assertRaises(ValueError) as e:\n _run(u'inctestpkg', path=None, newversion=None, patch=False,\n rc=False, dev=False, create=False, _date=self.date,\n _getcwd=self.getcwd, _print=out.append)\n\n self.assertEqual(\n e.exception.args[0],\n \"You need to issue a rc before updating the major/minor\")\n\n def test_no_mix_newversion(self):\n \"\"\"\n The `--newversion` flag can't be mixed with --patch, --rc, or --dev.\n \"\"\"\n out = []\n with self.assertRaises(ValueError) as e:\n _run(u'inctestpkg', path=None, newversion=\"1\", patch=True,\n rc=False, dev=False, create=False, _date=self.date,\n _getcwd=self.getcwd, _print=out.append)\n self.assertEqual(e.exception.args[0], \"Only give --newversion\")\n\n with self.assertRaises(ValueError) as e:\n _run(u'inctestpkg', path=None, newversion=\"1\", patch=False,\n rc=True, dev=False, create=False, _date=self.date,\n _getcwd=self.getcwd, _print=out.append)\n self.assertEqual(e.exception.args[0], \"Only give --newversion\")\n\n with self.assertRaises(ValueError) as e:\n _run(u'inctestpkg', path=None, newversion=\"1\", patch=False,\n rc=False, dev=True, create=False, _date=self.date,\n _getcwd=self.getcwd, _print=out.append)\n self.assertEqual(e.exception.args[0], \"Only give --newversion\")\n\n def test_no_mix_dev(self):\n \"\"\"\n The `--dev` flag can't be mixed with --patch, or --rc.\n \"\"\"\n out = []\n with self.assertRaises(ValueError) as e:\n _run(u'inctestpkg', path=None, newversion=None, patch=True,\n rc=False, dev=True, create=False, _date=self.date,\n _getcwd=self.getcwd, _print=out.append)\n self.assertEqual(e.exception.args[0], \"Only give --dev\")\n\n with self.assertRaises(ValueError) as e:\n _run(u'inctestpkg', path=None, newversion=None, patch=False,\n rc=True, dev=True, create=False, _date=self.date,\n _getcwd=self.getcwd, _print=out.append)\n self.assertEqual(e.exception.args[0], \"Only give --dev\")\n\n def test_no_mix_create(self):\n \"\"\"\n The `--create` flag can't be mixed with --patch, --rc, --dev, or\n --newversion.\n \"\"\"\n out = []\n with self.assertRaises(ValueError) as e:\n _run(u'inctestpkg', path=None, newversion=None, patch=True,\n rc=False, dev=False, create=True, _date=self.date,\n _getcwd=self.getcwd, _print=out.append)\n self.assertEqual(e.exception.args[0], \"Only give --create\")\n\n with self.assertRaises(ValueError) as e:\n _run(u'inctestpkg', path=None, newversion=\"1\", patch=False,\n rc=False, dev=False, create=True, _date=self.date,\n _getcwd=self.getcwd, _print=out.append)\n self.assertEqual(e.exception.args[0], \"Only give --create\")\n\n with self.assertRaises(ValueError) as e:\n _run(u'inctestpkg', path=None, newversion=None, patch=False,\n rc=True, dev=False, create=True, _date=self.date,\n _getcwd=self.getcwd, _print=out.append)\n self.assertEqual(e.exception.args[0], \"Only give --create\")\n\n with self.assertRaises(ValueError) as e:\n _run(u'inctestpkg', path=None, newversion=None, patch=False,\n rc=False, dev=True, create=True, _date=self.date,\n _getcwd=self.getcwd, _print=out.append)\n self.assertEqual(e.exception.args[0], \"Only give --create\")\n\n def test_newversion(self):\n \"\"\"\n `incremental.update package --newversion=1.2.3rc1dev3`, will set that\n version in the package.\n \"\"\"\n out = []\n _run(u'inctestpkg', path=None, newversion=\"1.2.3rc1dev3\", patch=False,\n rc=False, dev=False, create=False, _date=self.date,\n _getcwd=self.getcwd, _print=out.append)\n\n self.assertEqual(self.packagedir.child(\"_version.py\").getContent(),\n b'''\"\"\"\nProvides inctestpkg version information.\n\"\"\"\n\n# This file is auto-generated! Do not edit!\n# Use `python -m incremental.update inctestpkg` to change this file.\n\nfrom incremental import Version\n\n__version__ = Version('inctestpkg', 1, 2, 3, release_candidate=1, dev=3)\n__all__ = [\"__version__\"]\n''')\n self.assertEqual(self.packagedir.child(\"__init__.py\").getContent(),\n (b\"\"\"\nfrom incremental import Version\nintroduced_in = Version('inctestpkg', 1, 2, 3, \"\"\"\n b\"\"\"release_candidate=1, dev=3).short()\nnext_released_version = \"inctestpkg 1.2.3rc1dev3\"\n\"\"\"))\n\n def test_newversion_bare(self):\n \"\"\"\n `incremental.update package --newversion=1`, will set that\n version in the package.\n \"\"\"\n out = []\n _run(u'inctestpkg', path=None, newversion=\"1\", patch=False,\n rc=False, dev=False, create=False, _date=self.date,\n _getcwd=self.getcwd, _print=out.append)\n\n self.assertEqual(self.packagedir.child(\"_version.py\").getContent(),\n b'''\"\"\"\nProvides inctestpkg version information.\n\"\"\"\n\n# This file is auto-generated! Do not edit!\n# Use `python -m incremental.update inctestpkg` to change this file.\n\nfrom incremental import Version\n\n__version__ = Version('inctestpkg', 1, 0, 0)\n__all__ = [\"__version__\"]\n''')\n self.assertEqual(self.packagedir.child(\"__init__.py\").getContent(),\n b\"\"\"\nfrom incremental import Version\nintroduced_in = Version('inctestpkg', 1, 0, 0).short()\nnext_released_version = \"inctestpkg 1.0.0\"\n\"\"\")\n\n\nclass ScriptTests(TestCase):\n\n def setUp(self):\n\n self.srcdir = FilePath(self.mktemp())\n self.srcdir.makedirs()\n\n self.srcdir.child('src').makedirs()\n\n packagedir = self.srcdir.child('src').child('inctestpkg')\n packagedir.makedirs()\n\n packagedir.child('__init__.py').setContent(b\"\"\"\nfrom incremental import Version\nintroduced_in = Version('inctestpkg', 'NEXT', 0, 0).short()\nnext_released_version = \"inctestpkg NEXT\"\n\"\"\")\n packagedir.child('_version.py').setContent(b\"\"\"\nfrom incremental import Version\n__version__ = Version('inctestpkg', 1, 2, 3)\n__all__ = [\"__version__\"]\n\"\"\")\n self.getcwd = lambda: self.srcdir.path\n self.packagedir = packagedir\n\n class Date(object):\n year = 2016\n month = 8\n\n class DateModule(object):\n def today(self):\n return Date()\n\n self.date = DateModule()\n\n def test_run(self):\n \"\"\"\n Calling run() with no args will cause it to print help.\n \"\"\"\n stringio = NativeStringIO()\n self.patch(sys, 'stdout', stringio)\n\n with self.assertRaises(SystemExit) as e:\n run([\"--help\"])\n\n self.assertEqual(e.exception.args[0], 0)\n self.assertIn(\"Show this message and exit\", stringio.getvalue())\n\n def test_insufficient_args(self):\n \"\"\"\n Calling run() with no args will cause it to print help.\n \"\"\"\n stringio = NativeStringIO()\n self.patch(sys, 'stdout', stringio)\n self.patch(os, 'getcwd', self.getcwd)\n self.patch(datetime, 'date', self.date)\n\n with self.assertRaises(SystemExit) as e:\n run([\"inctestpkg\", \"--rc\"])\n\n self.assertEqual(e.exception.args[0], 0)\n self.assertIn(\"Updating codebase\", stringio.getvalue())\n\n self.assertEqual(self.packagedir.child(\"_version.py\").getContent(),\n b'''\"\"\"\nProvides inctestpkg version information.\n\"\"\"\n\n# This file is auto-generated! Do not edit!\n# Use `python -m incremental.update inctestpkg` to change this file.\n\nfrom incremental import Version\n\n__version__ = Version('inctestpkg', 16, 8, 0, release_candidate=1)\n__all__ = [\"__version__\"]\n''')\n self.assertEqual(self.packagedir.child(\"__init__.py\").getContent(),\n b\"\"\"\nfrom incremental import Version\nintroduced_in = Version('inctestpkg', 16, 8, 0, release_candidate=1).short()\nnext_released_version = \"inctestpkg 16.8.0rc1\"\n\"\"\")\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/incremental/tests/test_version.py",
"content": "# Copyright (c) Twisted Matrix Laboratories.\n# See LICENSE for details.\n\n\"\"\"\nTests for L{incremental}.\n\"\"\"\n\nfrom __future__ import division, absolute_import\n\nimport operator\n\nfrom incremental import getVersionString, IncomparableVersions\nfrom incremental import Version, _inf\n\nfrom twisted.trial.unittest import TestCase\n\n\nclass VersionsTests(TestCase):\n\n def test_localIsShort(self):\n \"\"\"\n The local version is the same as the short version.\n \"\"\"\n va = Version(\"dummy\", 1, 0, 0, release_candidate=1, dev=3)\n self.assertEqual(va.local(), va.short())\n\n def test_versionComparison(self):\n \"\"\"\n Versions can be compared for equality and order.\n \"\"\"\n va = Version(\"dummy\", 1, 0, 0)\n vb = Version(\"dummy\", 0, 1, 0)\n self.assertTrue(va > vb)\n self.assertTrue(vb < va)\n self.assertTrue(va >= vb)\n self.assertTrue(vb <= va)\n self.assertTrue(va != vb)\n self.assertTrue(vb == Version(\"dummy\", 0, 1, 0))\n self.assertTrue(vb == vb)\n\n def test_versionComparisonCaseInsensitive(self):\n \"\"\"\n Version package names are case insensitive.\n \"\"\"\n va = Version(\"dummy\", 1, 0, 0)\n vb = Version(\"DuMmY\", 0, 1, 0)\n self.assertTrue(va > vb)\n self.assertTrue(vb < va)\n self.assertTrue(va >= vb)\n self.assertTrue(vb <= va)\n self.assertTrue(va != vb)\n self.assertTrue(vb == Version(\"dummy\", 0, 1, 0))\n self.assertTrue(vb == vb)\n\n def test_comparingNEXTReleases(self):\n \"\"\"\n NEXT releases are always larger than numbered releases.\n \"\"\"\n va = Version(\"whatever\", \"NEXT\", 0, 0)\n vb = Version(\"whatever\", 1, 0, 0)\n self.assertTrue(va > vb)\n self.assertFalse(va < vb)\n self.assertNotEquals(vb, va)\n\n def test_NEXTMustBeAlone(self):\n \"\"\"\n NEXT releases must always have the rest of the numbers set to 0.\n \"\"\"\n with self.assertRaises(ValueError):\n Version(\"whatever\", \"NEXT\", 1, 0, release_candidate=0, dev=0)\n\n with self.assertRaises(ValueError):\n Version(\"whatever\", \"NEXT\", 0, 1, release_candidate=0, dev=0)\n\n with self.assertRaises(ValueError):\n Version(\"whatever\", \"NEXT\", 0, 0, release_candidate=1, dev=0)\n\n with self.assertRaises(ValueError):\n Version(\"whatever\", \"NEXT\", 0, 0, release_candidate=0, dev=1)\n\n def test_comparingNEXTReleasesEqual(self):\n \"\"\"\n NEXT releases are equal to each other.\n \"\"\"\n va = Version(\"whatever\", \"NEXT\", 0, 0)\n vb = Version(\"whatever\", \"NEXT\", 0, 0)\n self.assertEquals(vb, va)\n\n def test_comparingPrereleasesWithReleases(self):\n \"\"\"\n Prereleases are always less than versions without prereleases.\n \"\"\"\n va = Version(\"whatever\", 1, 0, 0, prerelease=1)\n vb = Version(\"whatever\", 1, 0, 0)\n self.assertTrue(va < vb)\n self.assertFalse(va > vb)\n self.assertNotEquals(vb, va)\n\n def test_prereleaseDeprecated(self):\n \"\"\"\n Passing 'prerelease' to Version is deprecated.\n \"\"\"\n Version(\"whatever\", 1, 0, 0, prerelease=1)\n warnings = self.flushWarnings([self.test_prereleaseDeprecated])\n self.assertEqual(len(warnings), 1)\n self.assertEqual(\n warnings[0]['message'],\n (\"Passing prerelease to incremental.Version was deprecated in \"\n \"Incremental 16.9.0. Please pass release_candidate instead.\"))\n\n def test_prereleaseAttributeDeprecated(self):\n \"\"\"\n Accessing 'prerelease' on a Version is deprecated.\n \"\"\"\n va = Version(\"whatever\", 1, 0, 0, release_candidate=1)\n va.prerelease\n warnings = self.flushWarnings(\n [self.test_prereleaseAttributeDeprecated])\n self.assertEqual(len(warnings), 1)\n self.assertEqual(\n warnings[0]['message'],\n (\"Accessing incremental.Version.prerelease was deprecated in \"\n \"Incremental 16.9.0. Use Version.release_candidate instead.\"))\n\n def test_comparingReleaseCandidatesWithReleases(self):\n \"\"\"\n Release Candidates are always less than versions without release\n candidates.\n \"\"\"\n va = Version(\"whatever\", 1, 0, 0, release_candidate=1)\n vb = Version(\"whatever\", 1, 0, 0)\n self.assertTrue(va < vb)\n self.assertFalse(va > vb)\n self.assertNotEquals(vb, va)\n\n def test_comparingDevReleasesWithReleases(self):\n \"\"\"\n Dev releases are always less than versions without dev releases.\n \"\"\"\n va = Version(\"whatever\", 1, 0, 0, dev=1)\n vb = Version(\"whatever\", 1, 0, 0)\n self.assertTrue(va < vb)\n self.assertFalse(va > vb)\n self.assertNotEquals(vb, va)\n\n def test_rcEqualspre(self):\n \"\"\"\n Release Candidates are equal to prereleases.\n \"\"\"\n va = Version(\"whatever\", 1, 0, 0, release_candidate=1)\n vb = Version(\"whatever\", 1, 0, 0, prerelease=1)\n self.assertTrue(va == vb)\n self.assertFalse(va != vb)\n\n def test_rcOrpreButNotBoth(self):\n \"\"\"\n Release Candidate and prerelease can't both be given.\n \"\"\"\n with self.assertRaises(ValueError):\n Version(\"whatever\", 1, 0, 0,\n prerelease=1, release_candidate=1)\n\n def test_comparingReleaseCandidates(self):\n \"\"\"\n The value specified as the release candidate is used in version\n comparisons.\n \"\"\"\n va = Version(\"whatever\", 1, 0, 0, release_candidate=1)\n vb = Version(\"whatever\", 1, 0, 0, release_candidate=2)\n self.assertTrue(va < vb)\n self.assertTrue(vb > va)\n self.assertTrue(va <= vb)\n self.assertTrue(vb >= va)\n self.assertTrue(va != vb)\n self.assertTrue(vb == Version(\"whatever\", 1, 0, 0,\n release_candidate=2))\n self.assertTrue(va == va)\n\n def test_comparingDev(self):\n \"\"\"\n The value specified as the dev release is used in version comparisons.\n \"\"\"\n va = Version(\"whatever\", 1, 0, 0, dev=1)\n vb = Version(\"whatever\", 1, 0, 0, dev=2)\n self.assertTrue(va < vb)\n self.assertTrue(vb > va)\n self.assertTrue(va <= vb)\n self.assertTrue(vb >= va)\n self.assertTrue(va != vb)\n self.assertTrue(vb == Version(\"whatever\", 1, 0, 0,\n dev=2))\n self.assertTrue(va == va)\n\n def test_comparingDevAndRC(self):\n \"\"\"\n The value specified as the dev release and release candidate is used in\n version comparisons.\n \"\"\"\n va = Version(\"whatever\", 1, 0, 0, release_candidate=1, dev=1)\n vb = Version(\"whatever\", 1, 0, 0, release_candidate=1, dev=2)\n self.assertTrue(va < vb)\n self.assertTrue(vb > va)\n self.assertTrue(va <= vb)\n self.assertTrue(vb >= va)\n self.assertTrue(va != vb)\n self.assertTrue(vb == Version(\"whatever\", 1, 0, 0,\n release_candidate=1, dev=2))\n self.assertTrue(va == va)\n\n def test_comparingDevAndRCDifferent(self):\n \"\"\"\n The value specified as the dev release and release candidate is used in\n version comparisons.\n \"\"\"\n va = Version(\"whatever\", 1, 0, 0, release_candidate=1, dev=1)\n vb = Version(\"whatever\", 1, 0, 0, release_candidate=2, dev=1)\n self.assertTrue(va < vb)\n self.assertTrue(vb > va)\n self.assertTrue(va <= vb)\n self.assertTrue(vb >= va)\n self.assertTrue(va != vb)\n self.assertTrue(vb == Version(\"whatever\", 1, 0, 0,\n release_candidate=2, dev=1))\n self.assertTrue(va == va)\n\n def test_infComparison(self):\n \"\"\"\n L{_inf} is equal to L{_inf}.\n\n This is a regression test.\n \"\"\"\n self.assertEqual(_inf, _inf)\n\n def test_disallowBuggyComparisons(self):\n \"\"\"\n The package names of the Version objects need to be the same.\n \"\"\"\n self.assertRaises(IncomparableVersions,\n operator.eq,\n Version(\"dummy\", 1, 0, 0),\n Version(\"dumym\", 1, 0, 0))\n\n def test_notImplementedComparisons(self):\n \"\"\"\n Comparing a L{Version} to some other object type results in\n C{NotImplemented}.\n \"\"\"\n va = Version(\"dummy\", 1, 0, 0)\n vb = (\"dummy\", 1, 0, 0) # a tuple is not a Version object\n self.assertEqual(va.__cmp__(vb), NotImplemented)\n\n def test_repr(self):\n \"\"\"\n Calling C{repr} on a version returns a human-readable string\n representation of the version.\n \"\"\"\n self.assertEqual(repr(Version(\"dummy\", 1, 2, 3)),\n \"Version('dummy', 1, 2, 3)\")\n\n def test_reprWithPrerelease(self):\n \"\"\"\n Calling C{repr} on a version with a prerelease returns a human-readable\n string representation of the version including the prerelease as a\n release candidate..\n \"\"\"\n self.assertEqual(repr(Version(\"dummy\", 1, 2, 3, prerelease=4)),\n \"Version('dummy', 1, 2, 3, release_candidate=4)\")\n\n def test_reprWithReleaseCandidate(self):\n \"\"\"\n Calling C{repr} on a version with a release candidate returns a\n human-readable string representation of the version including the rc.\n \"\"\"\n self.assertEqual(repr(Version(\"dummy\", 1, 2, 3, release_candidate=4)),\n \"Version('dummy', 1, 2, 3, release_candidate=4)\")\n\n def test_devWithReleaseCandidate(self):\n \"\"\"\n Calling C{repr} on a version with a dev release returns a\n human-readable string representation of the version including the dev\n release.\n \"\"\"\n self.assertEqual(repr(Version(\"dummy\", 1, 2, 3, dev=4)),\n \"Version('dummy', 1, 2, 3, dev=4)\")\n\n def test_str(self):\n \"\"\"\n Calling C{str} on a version returns a human-readable string\n representation of the version.\n \"\"\"\n self.assertEqual(str(Version(\"dummy\", 1, 2, 3)),\n \"[dummy, version 1.2.3]\")\n\n def test_strWithPrerelease(self):\n \"\"\"\n Calling C{str} on a version with a prerelease includes the prerelease\n as a release candidate.\n \"\"\"\n self.assertEqual(str(Version(\"dummy\", 1, 0, 0, prerelease=1)),\n \"[dummy, version 1.0.0rc1]\")\n\n def test_strWithReleaseCandidate(self):\n \"\"\"\n Calling C{str} on a version with a release candidate includes the\n release candidate.\n \"\"\"\n self.assertEqual(str(Version(\"dummy\", 1, 0, 0, release_candidate=1)),\n \"[dummy, version 1.0.0rc1]\")\n\n def test_strWithDevAndReleaseCandidate(self):\n \"\"\"\n Calling C{str} on a version with a release candidate and dev release\n includes the release candidate and the dev release.\n \"\"\"\n self.assertEqual(str(Version(\"dummy\", 1, 0, 0,\n release_candidate=1, dev=2)),\n \"[dummy, version 1.0.0rc1dev2]\")\n\n def test_strWithDev(self):\n \"\"\"\n Calling C{str} on a version with a dev release includes the dev\n release.\n \"\"\"\n self.assertEqual(str(Version(\"dummy\", 1, 0, 0, dev=1)),\n \"[dummy, version 1.0.0dev1]\")\n\n def testShort(self):\n self.assertEqual(Version('dummy', 1, 2, 3).short(), '1.2.3')\n\n def test_getVersionString(self):\n \"\"\"\n L{getVersionString} returns a string with the package name and the\n short version number.\n \"\"\"\n self.assertEqual(\n 'Twisted 8.0.0', getVersionString(Version('Twisted', 8, 0, 0)))\n\n def test_getVersionStringWithPrerelease(self):\n \"\"\"\n L{getVersionString} includes the prerelease as a release candidate, if\n any.\n \"\"\"\n self.assertEqual(\n getVersionString(Version(\"whatever\", 8, 0, 0, prerelease=1)),\n \"whatever 8.0.0rc1\")\n\n def test_getVersionStringWithReleaseCandidate(self):\n \"\"\"\n L{getVersionString} includes the release candidate, if any.\n \"\"\"\n self.assertEqual(\n getVersionString(Version(\"whatever\", 8, 0, 0,\n release_candidate=1)),\n \"whatever 8.0.0rc1\")\n\n def test_getVersionStringWithDev(self):\n \"\"\"\n L{getVersionString} includes the dev release, if any.\n \"\"\"\n self.assertEqual(\n getVersionString(Version(\"whatever\", 8, 0, 0,\n dev=1)),\n \"whatever 8.0.0dev1\")\n\n def test_getVersionStringWithDevAndRC(self):\n \"\"\"\n L{getVersionString} includes the dev release and release candidate, if\n any.\n \"\"\"\n self.assertEqual(\n getVersionString(Version(\"whatever\", 8, 0, 0,\n release_candidate=2, dev=1)),\n \"whatever 8.0.0rc2dev1\")\n\n def test_baseWithNEXT(self):\n \"\"\"\n The C{base} method returns just \"NEXT\" when NEXT is the major version.\n \"\"\"\n self.assertEqual(Version(\"foo\", \"NEXT\", 0, 0).base(), \"NEXT\")\n\n def test_base(self):\n \"\"\"\n The C{base} method returns a very simple representation of the version.\n \"\"\"\n self.assertEqual(Version(\"foo\", 1, 0, 0).base(), \"1.0.0\")\n\n def test_baseWithPrerelease(self):\n \"\"\"\n The base version includes 'rcX' for versions with prereleases.\n \"\"\"\n self.assertEqual(Version(\"foo\", 1, 0, 0, prerelease=8).base(),\n \"1.0.0rc8\")\n\n def test_baseWithDev(self):\n \"\"\"\n The base version includes 'devX' for versions with dev releases.\n \"\"\"\n self.assertEqual(Version(\"foo\", 1, 0, 0, dev=8).base(),\n \"1.0.0dev8\")\n\n def test_baseWithReleaseCandidate(self):\n \"\"\"\n The base version includes 'rcX' for versions with prereleases.\n \"\"\"\n self.assertEqual(Version(\"foo\", 1, 0, 0, release_candidate=8).base(),\n \"1.0.0rc8\")\n\n def test_baseWithDevAndRC(self):\n \"\"\"\n The base version includes 'rcXdevX' for versions with dev releases and\n a release candidate.\n \"\"\"\n self.assertEqual(Version(\"foo\", 1, 0, 0,\n release_candidate=2, dev=8).base(),\n \"1.0.0rc2dev8\")\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/incremental/update.py",
"content": "# Copyright (c) Twisted Matrix Laboratories.\n# See LICENSE for details.\n\nfrom __future__ import absolute_import, division, print_function\n\nimport click\nimport os\nimport datetime\n\nfrom incremental import Version\nfrom twisted.python.filepath import FilePath\n\n_VERSIONPY_TEMPLATE = '''\"\"\"\nProvides %s version information.\n\"\"\"\n\n# This file is auto-generated! Do not edit!\n# Use `python -m incremental.update %s` to change this file.\n\nfrom incremental import Version\n\n__version__ = %s\n__all__ = [\"__version__\"]\n'''\n\n_YEAR_START = 2000\n\n\ndef _findPath(path, package):\n\n cwd = FilePath(path)\n\n src_dir = cwd.child(\"src\").child(package.lower())\n current_dir = cwd.child(package.lower())\n\n if src_dir.isdir():\n return src_dir\n elif current_dir.isdir():\n return current_dir\n else:\n raise ValueError((\"Can't find under `./src` or `./`. Check the \"\n \"package name is right (note that we expect your \"\n \"package name to be lower cased), or pass it using \"\n \"'--path'.\"))\n\n\ndef _existing_version(path):\n version_info = {}\n\n with path.child(\"_version.py\").open('r') as f:\n exec(f.read(), version_info)\n\n return version_info[\"__version__\"]\n\n\ndef _run(package, path, newversion, patch, rc, dev, create,\n _date=None, _getcwd=None, _print=print):\n\n if not _getcwd:\n _getcwd = os.getcwd\n\n if not _date:\n _date = datetime.date.today()\n\n if type(package) != str:\n package = package.encode('utf8')\n\n if not path:\n path = _findPath(_getcwd(), package)\n else:\n path = FilePath(path)\n\n if newversion and patch or newversion and dev or newversion and rc:\n raise ValueError(\"Only give --newversion\")\n\n if dev and patch or dev and rc:\n raise ValueError(\"Only give --dev\")\n\n if create and dev or create and patch or create and rc or \\\n create and newversion:\n raise ValueError(\"Only give --create\")\n\n if newversion:\n from pkg_resources import parse_version\n existing = _existing_version(path)\n st_version = parse_version(newversion)._version\n\n release = list(st_version.release)\n\n if len(release) == 1:\n release.append(0)\n if len(release) == 2:\n release.append(0)\n\n v = Version(\n package, *release,\n release_candidate=st_version.pre[1] if st_version.pre else None,\n dev=st_version.dev[1] if st_version.dev else None)\n\n elif create:\n v = Version(package, _date.year - _YEAR_START, _date.month, 0)\n existing = v\n\n elif rc and not patch:\n existing = _existing_version(path)\n\n if existing.release_candidate:\n v = Version(package, existing.major, existing.minor,\n existing.micro, existing.release_candidate + 1)\n else:\n v = Version(package, _date.year - _YEAR_START, _date.month, 0, 1)\n\n elif patch:\n if rc:\n rc = 1\n else:\n rc = None\n\n existing = _existing_version(path)\n v = Version(package, existing.major, existing.minor,\n existing.micro + 1, rc)\n\n elif dev:\n existing = _existing_version(path)\n\n if existing.dev is None:\n _dev = 0\n else:\n _dev = existing.dev + 1\n\n v = Version(package, existing.major, existing.minor,\n existing.micro, existing.release_candidate, dev=_dev)\n\n else:\n existing = _existing_version(path)\n\n if existing.release_candidate:\n v = Version(package,\n existing.major, existing.minor, existing.micro)\n else:\n raise ValueError(\n \"You need to issue a rc before updating the major/minor\")\n\n NEXT_repr = repr(Version(package, \"NEXT\", 0, 0)).split(\"#\")[0]\n NEXT_repr_bytes = NEXT_repr.encode('utf8')\n\n version_repr = repr(v).split(\"#\")[0]\n version_repr_bytes = version_repr.encode('utf8')\n\n existing_version_repr = repr(existing).split(\"#\")[0]\n existing_version_repr_bytes = existing_version_repr.encode('utf8')\n\n _print(\"Updating codebase to %s\" % (v.public()))\n\n for x in path.walk():\n\n if not x.isfile():\n continue\n\n original_content = x.getContent()\n content = original_content\n\n # Replace previous release_candidate calls to the new one\n if existing.release_candidate:\n content = content.replace(existing_version_repr_bytes,\n version_repr_bytes)\n content = content.replace(\n (package.encode('utf8') + b\" \" +\n existing.public().encode('utf8')),\n (package.encode('utf8') + b\" \" +\n v.public().encode('utf8')))\n\n # Replace NEXT Version calls with the new one\n content = content.replace(NEXT_repr_bytes,\n version_repr_bytes)\n content = content.replace(NEXT_repr_bytes.replace(b\"'\", b'\"'),\n version_repr_bytes)\n\n # Replace NEXT with \n content = content.replace(package.encode('utf8') + b\" NEXT\",\n (package.encode('utf8') + b\" \" +\n v.public().encode('utf8')))\n\n if content != original_content:\n _print(\"Updating %s\" % (x.path,))\n with x.open('w') as f:\n f.write(content)\n\n _print(\"Updating %s/_version.py\" % (path.path))\n with path.child(\"_version.py\").open('w') as f:\n f.write(\n (_VERSIONPY_TEMPLATE % (\n package, package, version_repr)).encode('utf8'))\n\n\n@click.command()\n@click.argument('package')\n@click.option('--path', default=None)\n@click.option('--newversion', default=None)\n@click.option('--patch', is_flag=True)\n@click.option('--rc', is_flag=True)\n@click.option('--dev', is_flag=True)\n@click.option('--create', is_flag=True)\ndef run(*args, **kwargs):\n return _run(*args, **kwargs)\n\n\nif __name__ == '__main__': # pragma: no cover\n run()\n"
},
{
"path": "stackoverflow/venv/lib/python3.6/site-packages/incremental-17.5.0.dist-info/DESCRIPTION.rst",
"content": "Incremental\n===========\n\n|travis|\n|pypi|\n|coverage|\n\nIncremental is a small library that versions your Python projects.\n\nAPI documentation can be found `here `_.\n\n\nQuick Start\n-----------\n\nAdd this to your ``setup.py``\\ 's ``setup()`` call, removing any other versioning arguments:\n\n.. code::\n\n setup(\n use_incremental=True,\n setup_requires=['incremental'],\n install_requires=['incremental'], # along with any other install dependencies\n ...\n }\n\n\nThen run ``python -m incremental.update --create`` (you will need ``click`` installed from PyPI).\nIt will create a file in your package named ``_version.py`` and look like this:\n\n.. code::\n\n from incremental import Version\n\n __version__ = Version(\"widgetbox\", 17, 1, 0)\n __all__ = [\"__version__\"]\n\n\nThen, so users of your project can find your version, in your root package's ``__init__.py`` add:\n\n.. code::\n\n from ._version import __version__\n\n\nSubsequent installations of your project will then use Incremental for versioning.\n\n\nIncremental Versions\n--------------------\n\n``incremental.Version`` is a class that represents a version of a given project.\nIt is made up of the following elements (which are given during instantiation):\n\n- ``package`` (required), the name of the package this ``Version`` represents.\n- ``major``, ``minor``, ``micro`` (all required), the X.Y.Z of your project's ``Version``.\n- ``release_candidate`` (optional), set to 0 or higher to mark this ``Version`` being of a release candidate (also sometimes called a \"prerelease\").\n- ``dev`` (optional), set to 0 or higher to mark this ``Version`` as a development release.\n\nYou can extract a PEP-440 compatible version string by using the following methods:\n\n- ``.local()``, which returns a ``str`` containing the full version plus any Git or SVN information, if available. An example output would be ``\"17.1.1rc1+r123\"`` or ``\"3.7.0+rb2e812003b5d5fcf08efd1dffed6afa98d44ac8c\"``.\n- ``.public()``, which returns a ``str`` containing the full version, without any Git or SVN information. This is the version you should provide to users, or publicly use. An example output would be ``\"13.2.0\"``, ``\"17.1.2dev1\"``, or ``\"18.8.0rc2\"``.\n\nCalling ``repr()`` with a ``Version`` will give a Python-source-code representation of it, and calling ``str()`` with a ``Version`` will provide a string similar to ``'[Incremental, version 16.10.1]'``.\n\n\nUpdating\n--------\n\nIncremental includes a tool to automate updating your Incremental-using project's version called ``incremental.update``.\nIt updates the ``_version.py`` file and automatically updates some uses of Incremental versions from an indeterminate version to the current one.\nIt requires ``click`` from PyPI.\n\n``python -m incremental.update `` will perform updates on that package.\nThe commands that can be given after that will determine what the next version is.\n\n- ``--newversion=``, to set the project version to a fully-specified version (like 1.2.3, or 17.1.0dev1).\n- ``--rc``, to set the project version to ``.