From 00d88fc934add6c1fccb7373ddf02795d89d4498 Mon Sep 17 00:00:00 2001 From: sooctosnake Date: Wed, 23 Aug 2023 09:29:22 -0700 Subject: [PATCH 01/27] Change home screen with title and picture --- _notebooks/2023-08-16-linux_shell.ipynb | 492 ++++++++++++++++++ images/about_me_picture_csp.png | Bin 0 -> 415567 bytes index.md | 6 +- .../convert_notebooks.cpython-310.pyc | Bin 0 -> 2745 bytes 4 files changed, 495 insertions(+), 3 deletions(-) create mode 100644 _notebooks/2023-08-16-linux_shell.ipynb create mode 100644 images/about_me_picture_csp.png create mode 100644 scripts/__pycache__/convert_notebooks.cpython-310.pyc diff --git a/_notebooks/2023-08-16-linux_shell.ipynb b/_notebooks/2023-08-16-linux_shell.ipynb new file mode 100644 index 000000000..50e4c53ef --- /dev/null +++ b/_notebooks/2023-08-16-linux_shell.ipynb @@ -0,0 +1,492 @@ +{ + "cells": [ + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "---\n", + "layout: post\n", + "title: Linux Shell and Bash\n", + "description: A Tech Talk on Linux and the Bash shell.\n", + "toc: true\n", + "comments: true\n", + "categories: [5.A, C4.1]\n", + "courses: { csse: {week: 1}, csp: {week: 1, categories: [6.B]}, csa: {week: 1} }\n", + "type: devops\n", + "---" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Bash Tutorial\n", + "> A brief overview of Bash, on your way to becoming a Linux expert. When a computer boots up, a kernel (MacOS, Windows, Linux) is started. This kernel provides a shell, or terminal, that allows user to interact with a most basic set of commands. Typically, the casual user will not interact with the shell/terminal as a Desktop User Interface is started by the computer boot up process. To activate a shell directly, users will run a \"terminal\" through the Desktop. VS Code provides ability to activate \"terminal\" while in the IDE." + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Variable Prerequisites\n", + "> Setup bash shell dependency variables for this page. Variables are one of the first aspects of programming. Variables have \"name\" and a \"value\".\n", + "\n", + "- Hack Note: Change variables to match your student project." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Define variable\n", + "The following code cell defines 3 variables and assigns each a value. There are some extra command, called a HERE document, that write these variables to a file. This is so we can use these variables over and over below." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "vscode": { + "languageId": "shellscript" + } + }, + "outputs": [], + "source": [ + "%%script bash\n", + "\n", + "# Dependency Variables, set to match your project directories\n", + "\n", + "cat < /tmp/variables.sh\n", + "export project_dir=$HOME/vscode # change vscode to different name to test git clone\n", + "export project=\\$project_dir/teacher # change teacher to name of project from git clone\n", + "export project_repo=\"https://github.com/nighthawkcoders/teacher.git\" # change to project of choice\n", + "EOF" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Output the value of a variable\n", + "The following code cell outputs the value of the variables, using the echo command. For visual understanding in the output, each echo command provide a title before the $variable " + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "vscode": { + "languageId": "shellscript" + } + }, + "outputs": [], + "source": [ + "%%script bash\n", + "\n", + "# Extract saved variables\n", + "source /tmp/variables.sh\n", + "\n", + "# Output shown title and value variables\n", + "echo \"Project dir: $project_dir\"\n", + "echo \"Project: $project\"\n", + "echo \"Repo: $project_repo\"" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Project Setup and Analysis with Bash Scripts\n", + "The bash scripts that follow automate what was done in the setup procedures. The purpose of this is to show that many of the commands we performed can be added to a script, then performed automatically." + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Pull Code\n", + "> Pull code from GitHub to your machine. This is a bash script, a sequence of commands, that will create a project directory and add the \"project\" from GitHub to the vscode directory. There is conditional logic to make sure that clone only happen if it does not (!) exist. Here are some key elements in this code...\n", + "\n", + "- cd command (change directory), remember this from terminal session\n", + "- if statements (conditional statement, called selection statement by College Board), code inside only happens if condition is met" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "vscode": { + "languageId": "shellscript" + } + }, + "outputs": [], + "source": [ + "%%script bash\n", + "\n", + "# Extract saved variables\n", + "source /tmp/variables.sh\n", + "\n", + "echo \"Using conditional statement to create a project directory and project\"\n", + "\n", + "cd ~ # start in home directory\n", + "\n", + "# Conditional block to make a project directory\n", + "if [ ! -d $project_dir ]\n", + "then \n", + " echo \"Directory $project_dir does not exists... makinng directory $project_dir\"\n", + " mkdir -p $project_dir\n", + "fi\n", + "echo \"Directory $project_dir exists.\" \n", + "\n", + "# Conditional block to git clone a project from project_repo\n", + "if [ ! -d $project ]\n", + "then\n", + " echo \"Directory $project does not exists... cloning $project_repo\"\n", + " cd $project_dir\n", + " git clone $project_repo\n", + " cd ~\n", + "fi\n", + "echo \"Directory $project exists.\" " + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Look at files Github project\n", + "> All computers contain files and directories. The clone brought more files from cloud to your machine. Review the bash shell script, observe the commands that show and interact with files and directories. These were used during setup.\n", + "\n", + "- \"ls\" lists computer files in Unix and Unix-like operating systems\n", + "- \"cd\" offers way to navigate and change working directory\n", + "- \"pwd\" print working directory\n", + "- \"echo\" used to display line of text/string that are passed as an argument" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "vscode": { + "languageId": "shellscript" + } + }, + "outputs": [], + "source": [ + "%%script bash\n", + "\n", + "# Extract saved variables\n", + "source /tmp/variables.sh\n", + "\n", + "echo \"Navigate to project, then navigate to area wwhere files were cloned\"\n", + "cd $project\n", + "pwd\n", + "\n", + "echo \"\"\n", + "echo \"list top level or root of files with project pulled from github\"\n", + "ls\n" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Look at file list with hidden and long attributes\n", + "> Most linux commands have options to enhance behavior. The enhanced listing below shows permission bits, owner of file, size and date.\n", + "\n", + "[ls reference](https://www.rapidtables.com/code/linux/ls.html)" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "vscode": { + "languageId": "shellscript" + } + }, + "outputs": [], + "source": [ + "%%script bash\n", + "\n", + "# Extract saved variables\n", + "source /tmp/variables.sh\n", + "\n", + "echo \"Navigate to project, then navigate to area wwhere files were cloned\"\n", + "cd $project\n", + "pwd\n", + "\n", + "echo \"\"\n", + "echo \"list all files in long format\"\n", + "ls -al # all files -a (hidden) in -l long listing" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "vscode": { + "languageId": "shellscript" + } + }, + "outputs": [], + "source": [ + "%%script bash\n", + "\n", + "# Extract saved variables\n", + "source /tmp/variables.sh\n", + "\n", + "echo \"Look for posts\"\n", + "export posts=$project/_posts # _posts inside project\n", + "cd $posts # this should exist per fastpages\n", + "pwd # present working directory\n", + "ls -l # list posts" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "vscode": { + "languageId": "shellscript" + } + }, + "outputs": [], + "source": [ + "%%script bash\n", + "\n", + "# Extract saved variables\n", + "source /tmp/variables.sh\n", + "\n", + "echo \"Look for notebooks\"\n", + "export notebooks=$project/_notebooks # _notebooks is inside project\n", + "cd $notebooks # this should exist per fastpages\n", + "pwd # present working directory\n", + "ls -l # list notebooks" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "vscode": { + "languageId": "shellscript" + } + }, + "outputs": [], + "source": [ + "%%script bash\n", + "\n", + "# Extract saved variables\n", + "source /tmp/variables.sh\n", + "\n", + "echo \"Look for images in notebooks, print working directory, list files\"\n", + "cd $notebooks/images # this should exist per fastpages\n", + "pwd\n", + "ls -l" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Look inside a Markdown File\n", + "> \"cat\" reads data from the file and gives its content as output" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "vscode": { + "languageId": "shellscript" + } + }, + "outputs": [], + "source": [ + "%%script bash\n", + "\n", + "# Extract saved variables\n", + "source /tmp/variables.sh\n", + "\n", + "echo \"Navigate to project, then navigate to area wwhere files were cloned\"\n", + "\n", + "cd $project\n", + "echo \"show the contents of README.md\"\n", + "echo \"\"\n", + "\n", + "cat README.md # show contents of file, in this case markdown\n", + "echo \"\"\n", + "echo \"end of README.md\"\n" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Env, Git and GitHub\n", + "> Env(ironment) is used to capture things like path to Code or Home directory. Git and GitHub is NOT Only used to exchange code between individuals, it is often used to exchange code through servers, in our case deployment for Website. All tools we use have a behind the scenes relationships with the system they run on (MacOS, Windows, Linus) or a relationship with servers which they are connected to (ie GitHub). There is an \"env\" command in bash. There are environment files and setting files (.git/config) for Git. They both use a key/value concept.\n", + "\n", + "- \"env\" show setting for your shell\n", + "- \"git clone\" sets up a director of files\n", + "- \"cd $project\" allows user to move inside that directory of files\n", + "- \".git\" is a hidden directory that is used by git to establish relationship between machine and the git server on GitHub. " + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "vscode": { + "languageId": "shellscript" + } + }, + "outputs": [], + "source": [ + "%%script bash\n", + "\n", + "# This command has no dependencies\n", + "\n", + "echo \"Show the shell environment variables, key on left of equal value on right\"\n", + "echo \"\"\n", + "\n", + "env" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "vscode": { + "languageId": "shellscript" + } + }, + "outputs": [], + "source": [ + "%%script bash\n", + "\n", + "# Extract saved variables\n", + "source /tmp/variables.sh\n", + "\n", + "cd $project\n", + "\n", + "echo \"\"\n", + "echo \"show the secrets of .git\"\n", + "cd .git\n", + "ls -l\n", + "\n", + "echo \"\"\n", + "echo \"look at config file\"\n", + "cat config" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Advanced Student Request - Make a file in Bash\n", + "> This example was requested by a student (Jun Lim, CSA). The request was to make jupyer file using bash, I adapted the request to markdown. This type of thought will have great extrapolation to coding and possibilities of using List, Arrays, or APIs to build user interfaces. JavaScript is a language where building HTML is very common.\n", + "\n", + "> To get more interesting output from terminal, this will require using something like mdless (https://github.com/ttscoff/mdless). This enables see markdown in rendered format.\n", + "- On Desktop [Install PKG from MacPorts](https://www.macports.org/install.php)\n", + "- In Terminal on MacOS\n", + " - [Install ncurses](https://ports.macports.org/port/ncurses/)\n", + " - ```gem install mdless```\n", + " \n", + "> Output of the example is much nicer in \"jupyter\"" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "vscode": { + "languageId": "shellscript" + } + }, + "outputs": [], + "source": [ + "%%script bash\n", + "\n", + "# This example has error in VSCode, it run best on Jupyter\n", + "cd /tmp\n", + "\n", + "file=\"sample.md\"\n", + "if [ -f \"$file\" ]; then\n", + " rm $file\n", + "fi\n", + "\n", + "tee -a $file >/dev/null <>) redirection operator.\" >> $file\n", + "echo \"- The list definition, as is, is using space to seperate lines. Thus the use of commas and hyphens in output.\" >> $file\n", + "actions=(\"ls,list-directory\" \"cd,change-directory\" \"pwd,present-working-directory\" \"if-then-fi,test-condition\" \"env,bash-environment-variables\" \"cat,view-file-contents\" \"tee,write-to-output\" \"echo,display-content-of-string\" \"echo_text_>\\$file,write-content-to-file\" \"echo_text_>>\\$file,append-content-to-file\")\n", + "for action in ${actions[@]}; do # for loop is very similar to other language, though [@], semi-colon, do are new\n", + " action=${action//-/ } # convert dash to space\n", + " action=${action//,/: } # convert comma to colon\n", + " action=${action//_text_/ \\\"sample text\\\" } # convert _text_ to sample text, note escape character \\ to avoid \"\" having meaning\n", + " echo \" - ${action//-/ }\" >> $file # echo is redirected to file with >>\n", + "done\n", + "\n", + "echo \"\"\n", + "echo \"File listing and status\"\n", + "ls -l $file # list file\n", + "wc $file # show words\n", + "mdless $file # this requires installation, but renders markown from terminal\n", + "\n", + "rm $file # clean up termporary file" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Hack Preparation.\n", + "> Review Tool Setup Procedures and think about some thing you could verify through a Shell notebook.\n", + "- Come up with your own student view of this procedure to show your tools are installed. It is best that you keep the few things you understand, add things later as you start to understand them.\n", + "- Name and create blog notes on some Linux commands you will use frequently.\n", + "- Is there anything we use to verify tools we installed? Review versions?\n", + "- How would you update a repository? Use the git command line? \n" + ] + } + ], + "metadata": { + "kernelspec": { + "display_name": "Python 3.10.6 64-bit", + "language": "python", + "name": "python3" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.9.12" + }, + "vscode": { + "interpreter": { + "hash": "aee8b7b246df8f9039afb4144a1f6fd8d2ca17a180786b69acc140d282b71a49" + } + } + }, + "nbformat": 4, + "nbformat_minor": 2 +} diff --git a/images/about_me_picture_csp.png b/images/about_me_picture_csp.png new file mode 100644 index 0000000000000000000000000000000000000000..3e58f3189283fa4023e04dd3ed025b6eb211fd6b GIT binary patch literal 415567 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

Hello. Welcome to the Get To Know Me Game.

+

This is a multiple choice test that will test your knowledge about me.

+ +
+
+ +
+ + + + + + ## Overview of Hacks, Study and Tangibles From b28d01a319b8305e091156bb7f80b087d8cba578 Mon Sep 17 00:00:00 2001 From: sooctosnake Date: Thu, 24 Aug 2023 23:58:02 -0700 Subject: [PATCH 05/27] added_game --- _config.yml | 2 +- indexBlogs.md | 70 ++++++++++++++++++++++++++++++++++++++++++++++---- search_term.py | 24 +++++++++++++++++ terms.txt | 20 +++++++++++++++ 4 files changed, 110 insertions(+), 6 deletions(-) create mode 100644 search_term.py create mode 100644 terms.txt diff --git a/_config.yml b/_config.yml index 8f941a22e..50a14ce16 100644 --- a/_config.yml +++ b/_config.yml @@ -3,7 +3,7 @@ description: "August 2023 to June 2024" owner_name: Nighthawk Coders github_username: nighthawkcoders baseurl: "/student" -remote_theme: pages-themes/midnight@v0.2.0 +remote_theme: pages-themes/cayman@v0.2.0 # remote_theme: pages-themes/dinky@v0.2.0 # remote_theme: pages-themes/minimal@v0.2.0 # remote_theme: pages-themes/hacker@v0.2.0 diff --git a/indexBlogs.md b/indexBlogs.md index 2b558dfad..960e2aa77 100644 --- a/indexBlogs.md +++ b/indexBlogs.md @@ -3,12 +3,76 @@ layout: blogs permalink: /blogs title: Soham's Blogs --- +##### This is what I have been doing in CSP class + + + + + Search Terms + + + +

Search Terms

+ + +
+ + + + + +## Super Quick Overview + +| Week | Accomplishments | +| ----------- | ----------- | +| 0 | Installed WSL, VSCode, and created github repo| +| 1 |Set up website, commited changes to github| + + ## August 22th 2023 Committed the repository to github. And started working on my website. ### 1) Committing and Push -a) I clicked source control on the right side of VSCode and committed all the changes. I also synce all the changes +a) I clicked source control on the right side of VSCode and committed all the changes. I also synced all the changes + +b) I started working on my website ## August 21th, 2023 Today I setup Jupyter notebook, Installed Gemfile dependencies, and started a server @@ -126,7 +190,3 @@ Now I have VSCode and WSL working! -| Week | Accomplishment | -| ---- | -------------- | -| 1 | Learnt about github | -| 2 | | \ No newline at end of file diff --git a/search_term.py b/search_term.py new file mode 100644 index 000000000..630ad6f99 --- /dev/null +++ b/search_term.py @@ -0,0 +1,24 @@ +raw_terms = open("terms.txt","r") +terms = [] +for i in range(13): + terms.append(raw_terms.readline().strip("\n").split("=")) + +search = "" +is_md = "on Markdown" +found = False +while True: + search = input("Enter your search: ") + for i in range(len(terms)): + if search == terms[i][0]: + found = True + if is_md in search: + print("Format: ", terms[i][1]) + + else: + print("Definition:", "\n", terms[i][1]) + + if found == False: + print("Sorry we can't find that term. Make sure you have spell your query correctly") + + +print(terms) \ No newline at end of file diff --git a/terms.txt b/terms.txt new file mode 100644 index 000000000..3b7366478 --- /dev/null +++ b/terms.txt @@ -0,0 +1,20 @@ +make=command that helps run your local server +make convert=checks and ensures Jupyter notebooks are up to date +make clean=stops the local server and cleans the files +make stop=stops the local server +cd=allows you to move through directories +cd vscode=allows you to go to VSCode directory +python –version=shows you your current python version +jupyter –version=shows all your jupyter files and their current versions +git clone-clones a repository +rbenv versions=shows your current ruby versions +ruby -v=shows your current ruby version +bundle install=this command installs the dependencies in your Gemfile +Image on Markdown=![text](image_file) +ls=lists files in the respository +pwd=Print working directory command +mkdir=Command used to create directories +echo=Print any text that follows the command +clear=Clear the terminal display +mv=Move or rename files +sudo=command to create privileges From bff78bf5799273aeed8fa267f75140b2775dacf4 Mon Sep 17 00:00:00 2001 From: sooctosnake Date: Sun, 10 Sep 2023 10:01:47 -0700 Subject: [PATCH 06/27] week3 changes merged to main --- Makefile | 4 +- README.md | 98 ++-- _config.yml | 5 +- _data/compsci.yml | 11 + _data/csa.yml | 46 -- _data/csp.yml | 46 -- _data/csse.yml | 31 -- _data/mario_metadata.yml | 65 --- _includes/header.html | 5 +- _includes/help_list.html | 9 + _layouts/help.html | 55 ++ _notebooks/2023-08-16-linux_shell.ipynb | 492 ------------------ ...2023-08-17-Markdown_Table_Code_Hack.ipynb} | 25 +- ...ipynb => 2023-08-21-HTML_Image_Hack.ipynb} | 4 +- _notebooks/2023-08-30-Calculator.ipynb | 455 ++++++++++++++++ _posts/2023-08-15-Tools_Plans_Sample.md | 15 + _posts/2023-08-16-Tools_Equipment.md | 93 ---- _posts/2023-08-16-Tools_Help.md | 18 + _posts/2023-08-16-Week_0_Hacks_Sample.md | 134 +++++ _posts/2023-08-21-GitHub_Pages.md | 18 - _posts/2023-08-26-GitHub_Sync.md | 67 +++ ...s_Sprint.md => 2023-08-28-Week_1_Plans.md} | 26 +- _posts/2023-08-30-Calculator_imported_2_.md | 201 +++++++ _posts/2023-08-30-game_of_life.md | 200 +++++++ _posts/2023-08-30-get_to_know_me.md | 70 +++ _posts/2023-08-30-search_terms.md | 99 ++++ _posts/2023-08-30-snakegame.md | 374 +++++++++++++ _posts/2023-08-30-week_0_ticket.md | 16 + _posts/2023-08-30-week_1_ticket.md | 24 + _posts/2023-08-31-Week_2_Plans.md | 20 + _posts/2023-08-31-calculator_game.md | 74 +++ _posts/2023-09-01-week_2_ticket.md | 24 + _posts/2023-09-02-grade-calculator.md | 92 ++++ _posts/2023-09-04-dodging_game.md | 125 +++++ _posts/2023-09-06-image_viewer.ipynb | 80 +++ _posts/2023-09-08-search_brittanica.md | 28 + _posts/britannica_search.js | 10 + _posts/terms.txt | 20 + assets/css/style.scss | 90 ++++ assets/js/three.r119.min.js | 2 + assets/js/vanta.birds.min.js | 1 + assets/js/vanta.halo.min.js | 1 + assets/js/vanta.net.min.js | 1 + assets/js/vanta.rings.min.js | 1 + compsci.md | 6 + csa.md | 6 - csp.md | 6 - csse.md | 6 - get_to_know_me_game.py | 11 +- images/push.jpg | Bin 0 -> 29416 bytes indexHelp.md | 5 + .../convert_notebooks.cpython-310.pyc | Bin 2745 -> 2758 bytes scripts/activate.sh | 39 +- scripts/activate_macos.sh | 39 ++ scripts/activate_ubuntu.sh | 39 ++ scripts/setup_macos.sh | 64 +++ scripts/setup_ubuntu.sh | 43 ++ 57 files changed, 2622 insertions(+), 917 deletions(-) create mode 100644 _data/compsci.yml delete mode 100644 _data/csa.yml delete mode 100644 _data/csp.yml delete mode 100644 _data/csse.yml delete mode 100644 _data/mario_metadata.yml create mode 100644 _includes/help_list.html create mode 100644 _layouts/help.html delete mode 100644 _notebooks/2023-08-16-linux_shell.ipynb rename _notebooks/{2023-08-17-AP-pseudo-vs-python.ipynb => 2023-08-17-Markdown_Table_Code_Hack.ipynb} (93%) rename _notebooks/{2023-08-21-VSCode-GitHub_Pages.ipynb => 2023-08-21-HTML_Image_Hack.ipynb} (98%) create mode 100644 _notebooks/2023-08-30-Calculator.ipynb create mode 100644 _posts/2023-08-15-Tools_Plans_Sample.md delete mode 100644 _posts/2023-08-16-Tools_Equipment.md create mode 100644 _posts/2023-08-16-Tools_Help.md create mode 100644 _posts/2023-08-16-Week_0_Hacks_Sample.md delete mode 100644 _posts/2023-08-21-GitHub_Pages.md create mode 100644 _posts/2023-08-26-GitHub_Sync.md rename _posts/{2023-08-15-Tools_Sprint.md => 2023-08-28-Week_1_Plans.md} (53%) create mode 100644 _posts/2023-08-30-Calculator_imported_2_.md create mode 100644 _posts/2023-08-30-game_of_life.md create mode 100644 _posts/2023-08-30-get_to_know_me.md create mode 100644 _posts/2023-08-30-search_terms.md create mode 100644 _posts/2023-08-30-snakegame.md create mode 100644 _posts/2023-08-30-week_0_ticket.md create mode 100644 _posts/2023-08-30-week_1_ticket.md create mode 100644 _posts/2023-08-31-Week_2_Plans.md create mode 100644 _posts/2023-08-31-calculator_game.md create mode 100644 _posts/2023-09-01-week_2_ticket.md create mode 100644 _posts/2023-09-02-grade-calculator.md create mode 100644 _posts/2023-09-04-dodging_game.md create mode 100644 _posts/2023-09-06-image_viewer.ipynb create mode 100644 _posts/2023-09-08-search_brittanica.md create mode 100644 _posts/britannica_search.js create mode 100644 _posts/terms.txt create mode 100644 assets/css/style.scss create mode 100644 assets/js/three.r119.min.js create mode 100644 assets/js/vanta.birds.min.js create mode 100644 assets/js/vanta.halo.min.js create mode 100644 assets/js/vanta.net.min.js create mode 100644 assets/js/vanta.rings.min.js create mode 100644 compsci.md delete mode 100644 csa.md delete mode 100644 csp.md delete mode 100644 csse.md create mode 100644 images/push.jpg create mode 100644 indexHelp.md create mode 100755 scripts/activate_macos.sh create mode 100755 scripts/activate_ubuntu.sh create mode 100755 scripts/setup_macos.sh create mode 100755 scripts/setup_ubuntu.sh diff --git a/Makefile b/Makefile index ff05f9436..0a403a4d4 100644 --- a/Makefile +++ b/Makefile @@ -25,7 +25,7 @@ default: server @# tail and awk work together to extract Jekyll regeneration messages @# When a _notebook is detected in the log, call make convert in the background @# Note: We use the "if ($$0 ~ /_notebooks\/.*\.ipynb/) { system(\"make convert &\") }" to call make convert - @(tail -f $(LOG_FILE) | awk '/Server address: http:\/\/0.0.0.0:$(PORT)\/$(REPO_NAME)\// { serverReady=1 } \ + @(tail -f $(LOG_FILE) | awk '/Server address: http:\/\/127.0.0.1:$(PORT)\/$(REPO_NAME)\// { serverReady=1 } \ serverReady && /^ *Regenerating:/ { regenerate=1 } \ regenerate { \ if (/^[[:blank:]]*$$/) { regenerate=0 } \ @@ -56,7 +56,7 @@ default: server # Start the local web server server: stop convert @echo "Starting server..." - @@nohup bundle exec jekyll serve -H 0.0.0.0 -P $(PORT) > $(LOG_FILE) 2>&1 & \ + @@nohup bundle exec jekyll serve -H 127.0.0.1 -P $(PORT) > $(LOG_FILE) 2>&1 & \ PID=$$!; \ echo "Server PID: $$PID" @@until [ -f $(LOG_FILE) ]; do sleep 1; done diff --git a/README.md b/README.md index 0794b445e..8b3bf059c 100644 --- a/README.md +++ b/README.md @@ -18,66 +18,10 @@ Deployment Cycle. In the deplopyment cycle, `sync-github-action-review`, it is ### WSL and/or Ubuntu installation requirements - The result of these step is Ubuntu tools to run preview server. These procedures were created using [jekyllrb.com](https://jekyllrb.com/docs/installation/ubuntu/) -- Run scripts in scripts directory of teacher repo: setup_ubuntu.sh and activate.sh. Or, follow commands below. -```bash -## WSL/Ubuntu commands -# sudo apt install, installs packages for Ubuntu -echo "=== Ugrade Packages ===" -sudo apt update -sudo apt upgrade -y -# -echo "=== Install Ruby ===" -sudo apt install -y ruby-full build-essential zlib1g-dev -# -echo "=== Install Python ===" -sudo apt-get install -y python3 python3-pip python-is-python3 -# -echo "=== Install Jupyter Notebook ===" -sudo apt-get install -y jupyter-notebook - -# bash commands, install user requirements. -echo "=== GitHub pages build tools ===" -export GEM_HOME="$HOME/gems" -export PATH="$HOME/gems/bin:$PATH" -echo '# Install Ruby Gems to ~/gems' >> ~/.bashrc -echo 'export GEM_HOME="$HOME/gems"' >> ~/.bashrc -echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.bashrc -echo "=== Gem install starting, thinking... ===" -gem install jekyll bundler -head -30 ./teacher/scripts/activate.sh -echo "=== !!!Start a new Terminal!!! ===" -``` +- Run scripts in scripts directory of student repo: setup_ubuntu.sh and activate.sh. Expected name of the repository to run these scripts is 'student'. ### MacOs installation requirements -- Ihe result of these step are MacOS tools to run preview server. These procedures were created using [jekyllrb.com](https://jekyllrb.com/docs/installation/macos/). Run scripts in scripts directory of teacher repo: setup_macos.sh and activate_macos.sh. Or, follow commands below. -```bash -# MacOS commands -# brew install, installs packages for MacOS -echo "=== Ugrade Packages ===" -brew update -brew upgrade -# -echo "=== Install Ruby ===" -brew install chruby ruby-install xz -ruby-install ruby 3.1.3 -# -echo "=== Install Python ===" -brew install python -# -echo "=== Install Jupyter Notebook ===" -brew install jupyter - -# bash commands, install user requirements. -export GEM_HOME="$HOME/gems" -export PATH="$HOME/gems/bin:$PATH" -echo '# Install Ruby Gems to ~/gems' >> ~/.zshrc -echo 'export GEM_HOME="$HOME/gems"' >> ~/.zshrc -echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.zshrc -echo "=== Gem install starting, thinking... ===" -gem install jekyll bundler -head -30 ./teacher/scripts/activate.sh -echo "=== !!!Start a new Terminal!!! ===" -``` +- Ihe result of these step are MacOS tools to run preview server. These procedures were created using [jekyllrb.com](https://jekyllrb.com/docs/installation/macos/). Run scripts in scripts directory of student repo: setup_macos.sh and activate_macos.sh. Expected name of the repository to run these scripts is 'student'. ### Preview - The result of these step is server running on: http://0.0.0.0:4100/teacher/. Regeneration messages will run in terminal on any save. Press the Enter or Return key in the terminal at any time to enter commands. @@ -122,3 +66,41 @@ bundle install ```bash make convert ``` +### Meta Data (Front Matter) +- Meta data also known as front matter is a set of key value pairs that can provide additional information to github pages about .md and .ipynb files. This can and probably will be used in other file types (ie doc, pdf), if we added them to the system. + +- In the front matter you can also define things like a title and description for the page. Additional front matter is defined to place content on "Computer Science Lab Notebook" page. The `courses:` key will place data on a specific page with the nested `week:` placing data on a specific row on the page. The `type:` key in front matter will place blog under the plans, hacks(ToDo), and tangibles column. + +- In our files the front matter is defined at the top of the page or the first markdown cell. + + - First open one of the .md or .ipynb files already included in either your _posts folder or your _notebooks folder. + + - In the .md file you should notice something similar to this at the top of the page. To see this in your .ipynb files you will need to double click the markdown cell at the top of the file. + + ```yaml + --- + toc: true + comments: false + layout: post + title: Daily Plan Sample + description: Example Blog!!! This shows planning and notes from hacks. + type: plans + courses: { compsci: {week: 0} } + --- + ``` + +- Front matter will always have '---' at the top and bottom to distinguish it and each key value pair will be separated by a ':'. + +- Here we can modify things like the title and description. + +- The type value will tells us which column this is going to appear under, supported values: `plans`, `hacks`, `tangibles`. + +- The courses tells us which menu item it will be under, in this case the `compsci` menu, and the `week` tells it what row (week) it will appear under that menu. + +- In our examples, hacks(ToDo) contains references to our IPYNB files; these are stored in GitHub under the `_notebooks` folder. The plans and tangibles contains references to our MD files; these are stored in GitHub under the `_posts` folder. + +- Key files in Computer Science Lab Notebook + - `compsci.md` - this is the "Computer Science Lab Notebook" page and is the link `https://nighthawkcoders.github.io/student/compsci`. It contains the Title and Number of units on the page. + - `_data/compsci.yml` - this contains the supporting data that helps organize the units on the page. + - `_layouts`\schedule.html - this contains code, in the Liquid language, that generates the HTML for all the rows and columns. + - fyi, the schedule.html could work for another type of page. For instance, you could make a csa.md, _data/csa.yml, and tag files with `csa: {week: 0}` under courses. diff --git a/_config.yml b/_config.yml index 50a14ce16..3ed1dbdf7 100644 --- a/_config.yml +++ b/_config.yml @@ -3,8 +3,8 @@ description: "August 2023 to June 2024" owner_name: Nighthawk Coders github_username: nighthawkcoders baseurl: "/student" -remote_theme: pages-themes/cayman@v0.2.0 -# remote_theme: pages-themes/dinky@v0.2.0 +remote_theme: pages-themes/modernist@v0.2.0 +#remote_theme: pages-themes/dinky@v0.2.0 # remote_theme: pages-themes/minimal@v0.2.0 # remote_theme: pages-themes/hacker@v0.2.0 # remote_theme: pages-themes/cayman@v0.2.0 @@ -12,3 +12,4 @@ remote_theme: pages-themes/cayman@v0.2.0 plugins: - jekyll-remote-theme future: true + diff --git a/_data/compsci.yml b/_data/compsci.yml new file mode 100644 index 000000000..624c41d5d --- /dev/null +++ b/_data/compsci.yml @@ -0,0 +1,11 @@ +# CSP course meta data +Unit1: + title: Build a Lab Notebook + description: Install Tools. Design lab notebook. Learn GitHub Pages. Work with Pair (pair name). + start: 0 + end: 3 +Unit2: + title: Learn Language + description: Learn (JavaScript|Python|Java). Start Agile development process. + start: 4 + end: 7 diff --git a/_data/csa.yml b/_data/csa.yml deleted file mode 100644 index d690f859a..000000000 --- a/_data/csa.yml +++ /dev/null @@ -1,46 +0,0 @@ -# CSP course meta data -Unit1: - title: Introduction to Tools and Resources - description: To learn Java and build skills for Career Technical Education students will quickly immerse into Tools and Resources for Java Development and Blogging. These early weeks will focus on the Development Environment, GitHub Pages Blogging platform, AP Classroom resources, and Programming Java with VSCode and Jupyter Notebooks. - start: 0 - end: 3 -Unit2: - title: Java Mini-labs - description: Students have been introduced to Classes and Inheritance in Python and JavaScript. In this unit students will become more familiar with Java development and classes through mini-labs. These labs will focus on AP required aspects of Java, additionally they can be used as code to support the backend of a Desktop App or WebSite. This unit concludes with 4 person Project Plan, kicking off the end of trimester N@TM project. Students will be able to write code that completes full stack process of Frontend talking to the Java backend. - start: 4 - end: 7 -Unit3: - title: Individual/Team Projects and N@tM - description: This Units requirement is to to build individual development skills and a Team Frontend and Backend project in Java. By the end of this unit students will be aware of all the College Board Units and FRQ types. Student will participate in live grading of peers work. Fastpages Blogs and Jupyter Notebooks are required for all individuals. By the end of this section you should have examples, study materials, and code that show a great deal of effort, understanding, and competency. - start: 8 - end: 12 -Unit4: - title: College Board Teaching and Study - description: This period will complete formal teaching and grading on the basics of the 10 units. Also, there will be a tech talk and homework on each FRQ type customized for Team PBL idea. - start: 13 - end: 16 -Unit5: - title: Passion Projects - description: Objective of these weeks is to explore and create ideas and concepts for a Team two trimester project. Adding frontend and creativity while using APIs/Databases. This should be a project of personal and team interest. Team projects that are most liked by Teachers and Students will be continued in Trimester 3. - start: 17 - end: 20 -Unit6: - title: Creative Development and N@tM - description: This will be most creative portion of year for CSA students. Each person within "Student Teams" will have their own specialty within their student project that shows Full Stack competency, requiring Java as backend. Intentions for this period is to have a free and creative period, driven by your Issues and Scrum Board. Student should be able to talk about design, do fe/be coding, addd database features and perform weekly live reviews. - start: 21 - end: 24 -Unit7: - title: Data Structures - description: A focus Data Structures that relate to the AP exam. A key requirement is to make your own Algo Rythmic sorting video. The theme is produce work that can be used to help you pass the AP Exam and improve your Passion Project. Each student must cover key concepts from one of the Four AP FRQ types, contain a key Data Structure, and utilize sorting. These requirements are fairly generic and could complement any project. - start: 25 - end: 29 -Unit8: - title: AP Weeks - description: Student will lead several study sessions (20 minute test, follow by review) the week before the exam. In any break in study, students will transition activities to a final project. - start: 30 - end: 32 -Unit9: - title: Final Project and N@tM - description: Wrap up your preferred project. There will be an opportunity to contribute and be published to the NightHawk Coding Society library. If your project is selected, then you will receive a high 'A' on final. - start: 33 - end: 36 diff --git a/_data/csp.yml b/_data/csp.yml deleted file mode 100644 index 9ca76bfaf..000000000 --- a/_data/csp.yml +++ /dev/null @@ -1,46 +0,0 @@ -# CSP course meta data -Unit1: - title: Introduction to Tools and Resources - description: The initial weeks focus on introducing Tools, Pair Programming, and the AP Resources that we plan to use throughout the year. At the end of Weeks 0-3, students will be exposed to blogging with GitHub Pages; developing with Jupyter Notebooks, Python, JavaScript, HTML, and Code.org AppLab; working with AP classroom and becoming familiar with Create Performance Task project requirements. - start: 0 - end: 3 -Unit2: - title: Introduction to Web Development - description: Websites are made up of several key parts. Frontend, Backend, Data and Deployment. The focus for these weeks is to enable students to perform the aspects of constructing and deploying a simple Website. There will be several lectures during this period to provide you with concepts on how to build a WebSite, including working with data from a backend server. - start: 4 - end: 7 -Unit3: - title: Web Application, Data, and N@tM - description: Student at teams need to build their own Website and Blog their understanding. The Website should include their own interests, but requires use of Python Flask and JavaScript programming. By the end of the Unit, students will be ready to start many of the technical coding aspects of Web Development, having established a Deployed Website. In November, the Trimester work will end with a project and student participation in Electives Department "Night at the Museum" (N@tM). - start: 8 - end: 12 -Unit4: - title: Algorithmic Programming - description: Trimester 2 begins with student teaching and a focus on algorithms. Each week a "Student Team" has a teaching assignment supported by College Board materials. Additionally, the Teacher is providing Career Tech mini-labs that correspond to one or more topics for the week. Use the two things together as you improve your learning experience, Frontend blog and Jupyter Notebooks. - start: 13 - end: 16 -Unit5: - title: OOP and Databases - description: Trimester 2 continues with student learning OOP and immediately applying it to Databases. Each week a "Student Teams" will be working on frontend and backend elements for their Create Performance Task (CPT). GitHub pages will be focus of instruction for frontend, OOP in Python will be instruction provided to create a database which will help exceed every CPT requirement. - start: 17 - end: 20 -Unit6: - title: Create Performance Task (CPT) and N@tM - description: Trimester 2 concludes with student presenting their CPT project at N@tM. Each person within "Student Teams" will have their own specialty within the student project that satisfied all their Create Performance Task requirements. Student should be able to talk about design, coding, and present features of their portion of the system. - start: 21 - end: 24 -Unit7: - title: Data Structures - description: This is the beginning of a college course following outline of CS113 Data Structures from Mira Costa CC. Topics, using Python, include searching, sorting, hashing, algorithms, analysis, object-oriented design, collections, lists, stacks, queues, trees, sets, dictionaries, and graphs. - start: 25 - end: 29 -Unit8: - title: AP Weeks - description: Activities will be focused on supporting students in test preparations, including student teaching. Days that are not focused on test preparation will be focused on planning for year end project/portfolio. - start: 30 - end: 32 -Unit9: - title: Passion Project and N@tM - description: Presenting accomplishments for the year by creating a passion project for N@tM. This project will serve as the year end final exam. - start: 33 - end: 36 diff --git a/_data/csse.yml b/_data/csse.yml deleted file mode 100644 index 502026602..000000000 --- a/_data/csse.yml +++ /dev/null @@ -1,31 +0,0 @@ -# CSP course meta data -Unit1: - title: Introduction to Tools, Blogging, Markdown, HTML and CSS - description: The initial weeks focus on introducing Tools, Pair Programming, and tools we will using throughout the year. At the end of the first unit, students will be blogging on GitHub and creating GitHub Pages; be introduced to Jupyter Notebooks and VSCode, coding with JavaScript, HTML, and CSS - start: 0 - end: 3 -Unit2: - title: Introduction to Development with JavaScript - description: A key focus of this course is to make Web Games using JavaScript. These next few weeks we will perform the aspects of constructing a game and deploying the game to GitHub Pages. Our goal is to participate in N@tM with the other CS classes and other classes from the Electives Department. - start: 4 - end: 7 -Unit3: - title: Building a Web Application with GitHub Pages for N@tM - description: Part of the process of becoming technically proficient is taking on challenges while coding, these challenges will often make a student feel uncomforatable. But with some vision, questions, and AI research it is amazing what can be done. - start: 8 - end: 12 -Unit4: - title: Working with Data and Frameworks - description: Understanding key development frameworks available in GitHub Pages make development faster. We will look at storing data in the Browsers with Local Storage, generating repetitive code using YML and Liquid and styling HTML with SASS. - start: 13 - end: 16 -Unit5: - title: Algorithmic and Programming Fundamentals - description: Each week a "Student Team" will have a teaching assignment. Additionally, the Teacher is providing mini-labs that correspond to topics for the week. Using the two things together, you will your learning experience, blogging and Jupyter Notebooks skills. - start: 17 - end: 20 -Unit6: - title: Create a Final Project and N@tM - description: Trimester 2 concludes with student presenting their CPT project at N@tM. Each person within "Student Teams" will have their own specialty within the student project that satisfied all their Create Performance Task requirements. Student should be able to talk about design, coding, and present features of their portion of the system. - start: 21 - end: 24 diff --git a/_data/mario_metadata.yml b/_data/mario_metadata.yml deleted file mode 100644 index 53bc09674..000000000 --- a/_data/mario_metadata.yml +++ /dev/null @@ -1,65 +0,0 @@ -# Metadata to describe animations in sprite file images/mario_animations.png -- Rest: - row: 0 - col: 0 - frames: 15 -- RestL: - row: 1 - col: 0 - frames: 15 -- Walk: - row: 2 - col: 0 - frames: 8 -- Tada: - row: 2 - col: 11 - frames: 3 -- WalkL: - row: 3 - col: 0 - frames: 8 -- TadaL: - row: 3 - col: 11 - frames: 3 -- Run1: - row: 4 - col: 0 - frames: 15 -- Run1L: - row: 5 - col: 0 - frames: 15 -- Run2: - row: 6 - col: 0 - frames: 15 -- Run2L: - row: 7 - col: 0 - frames: 15 -- Puff: - row: 8 - col: 0 - frames: 15 -- PuffL: - row: 9 - col: 0 - frames: 15 -- Cheer: - row: 10 - col: 0 - frames: 15 -- CheerL: - row: 11 - col: 0 - frames: 15 -- Flip: - row: 12 - col: 0 - frames: 15 -- FlipL: - row: 13 - col: 0 - frames: 15 diff --git a/_includes/header.html b/_includes/header.html index 4c482389c..ea6f0644c 100644 --- a/_includes/header.html +++ b/_includes/header.html @@ -4,10 +4,9 @@ diff --git a/_includes/help_list.html b/_includes/help_list.html new file mode 100644 index 000000000..c4373a391 --- /dev/null +++ b/_includes/help_list.html @@ -0,0 +1,9 @@ + \ No newline at end of file diff --git a/_layouts/help.html b/_layouts/help.html new file mode 100644 index 000000000..60723f97f --- /dev/null +++ b/_layouts/help.html @@ -0,0 +1,55 @@ +--- +layout: default +--- + +
+ {%- if page.title -%} +

{{ page.title }}

+ {%- endif -%} + + {{ content | markdownify }} + + + {% if site.paginate %} + {% assign rawposts = paginator.posts %} + {% else %} + {% assign rawposts = site.posts %} + {% endif %} + + + {% assign posts = ''|split:'' %} + {% for post in rawposts %} + {% if post.type == "help" %} + {% assign posts = posts|push:post%} + {% endif %} + {% endfor %} + + + {% assign grouped_posts = posts | group_by: "sticky_rank" | sort: "name", "last" %} + {% assign sticky_posts = ''|split:'' %} + {% assign non_sticky_posts = '' | split:'' %} + + + {% for gp in grouped_posts %} + {%- if gp.name == "" -%} + {% assign non_sticky_posts = gp.items | sort: "date" | reverse %} + {%- else %} + {% assign sticky_posts = sticky_posts | concat: gp.items %} + {%- endif -%} + {% endfor %} + + + {% assign sticky_posts = sticky_posts | sort: "sticky_rank", "last" %} + {% assign posts = sticky_posts | concat: non_sticky_posts %} + + {%- if posts.size > 0 -%} +
    + {%- assign date_format = site.minima.date_format | default: "%b %-d, %Y" -%} + {%- for post in posts -%} +
  • + {%- include help_list.html -%} +
  • + {%- endfor -%} +
+ + {%- endif -%} diff --git a/_notebooks/2023-08-16-linux_shell.ipynb b/_notebooks/2023-08-16-linux_shell.ipynb deleted file mode 100644 index 50e4c53ef..000000000 --- a/_notebooks/2023-08-16-linux_shell.ipynb +++ /dev/null @@ -1,492 +0,0 @@ -{ - "cells": [ - { - "attachments": {}, - "cell_type": "markdown", - "metadata": {}, - "source": [ - "---\n", - "layout: post\n", - "title: Linux Shell and Bash\n", - "description: A Tech Talk on Linux and the Bash shell.\n", - "toc: true\n", - "comments: true\n", - "categories: [5.A, C4.1]\n", - "courses: { csse: {week: 1}, csp: {week: 1, categories: [6.B]}, csa: {week: 1} }\n", - "type: devops\n", - "---" - ] - }, - { - "attachments": {}, - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Bash Tutorial\n", - "> A brief overview of Bash, on your way to becoming a Linux expert. When a computer boots up, a kernel (MacOS, Windows, Linux) is started. This kernel provides a shell, or terminal, that allows user to interact with a most basic set of commands. Typically, the casual user will not interact with the shell/terminal as a Desktop User Interface is started by the computer boot up process. To activate a shell directly, users will run a \"terminal\" through the Desktop. VS Code provides ability to activate \"terminal\" while in the IDE." - ] - }, - { - "attachments": {}, - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Variable Prerequisites\n", - "> Setup bash shell dependency variables for this page. Variables are one of the first aspects of programming. Variables have \"name\" and a \"value\".\n", - "\n", - "- Hack Note: Change variables to match your student project." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### Define variable\n", - "The following code cell defines 3 variables and assigns each a value. There are some extra command, called a HERE document, that write these variables to a file. This is so we can use these variables over and over below." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "vscode": { - "languageId": "shellscript" - } - }, - "outputs": [], - "source": [ - "%%script bash\n", - "\n", - "# Dependency Variables, set to match your project directories\n", - "\n", - "cat < /tmp/variables.sh\n", - "export project_dir=$HOME/vscode # change vscode to different name to test git clone\n", - "export project=\\$project_dir/teacher # change teacher to name of project from git clone\n", - "export project_repo=\"https://github.com/nighthawkcoders/teacher.git\" # change to project of choice\n", - "EOF" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### Output the value of a variable\n", - "The following code cell outputs the value of the variables, using the echo command. For visual understanding in the output, each echo command provide a title before the $variable " - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "vscode": { - "languageId": "shellscript" - } - }, - "outputs": [], - "source": [ - "%%script bash\n", - "\n", - "# Extract saved variables\n", - "source /tmp/variables.sh\n", - "\n", - "# Output shown title and value variables\n", - "echo \"Project dir: $project_dir\"\n", - "echo \"Project: $project\"\n", - "echo \"Repo: $project_repo\"" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Project Setup and Analysis with Bash Scripts\n", - "The bash scripts that follow automate what was done in the setup procedures. The purpose of this is to show that many of the commands we performed can be added to a script, then performed automatically." - ] - }, - { - "attachments": {}, - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### Pull Code\n", - "> Pull code from GitHub to your machine. This is a bash script, a sequence of commands, that will create a project directory and add the \"project\" from GitHub to the vscode directory. There is conditional logic to make sure that clone only happen if it does not (!) exist. Here are some key elements in this code...\n", - "\n", - "- cd command (change directory), remember this from terminal session\n", - "- if statements (conditional statement, called selection statement by College Board), code inside only happens if condition is met" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "vscode": { - "languageId": "shellscript" - } - }, - "outputs": [], - "source": [ - "%%script bash\n", - "\n", - "# Extract saved variables\n", - "source /tmp/variables.sh\n", - "\n", - "echo \"Using conditional statement to create a project directory and project\"\n", - "\n", - "cd ~ # start in home directory\n", - "\n", - "# Conditional block to make a project directory\n", - "if [ ! -d $project_dir ]\n", - "then \n", - " echo \"Directory $project_dir does not exists... makinng directory $project_dir\"\n", - " mkdir -p $project_dir\n", - "fi\n", - "echo \"Directory $project_dir exists.\" \n", - "\n", - "# Conditional block to git clone a project from project_repo\n", - "if [ ! -d $project ]\n", - "then\n", - " echo \"Directory $project does not exists... cloning $project_repo\"\n", - " cd $project_dir\n", - " git clone $project_repo\n", - " cd ~\n", - "fi\n", - "echo \"Directory $project exists.\" " - ] - }, - { - "attachments": {}, - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### Look at files Github project\n", - "> All computers contain files and directories. The clone brought more files from cloud to your machine. Review the bash shell script, observe the commands that show and interact with files and directories. These were used during setup.\n", - "\n", - "- \"ls\" lists computer files in Unix and Unix-like operating systems\n", - "- \"cd\" offers way to navigate and change working directory\n", - "- \"pwd\" print working directory\n", - "- \"echo\" used to display line of text/string that are passed as an argument" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "vscode": { - "languageId": "shellscript" - } - }, - "outputs": [], - "source": [ - "%%script bash\n", - "\n", - "# Extract saved variables\n", - "source /tmp/variables.sh\n", - "\n", - "echo \"Navigate to project, then navigate to area wwhere files were cloned\"\n", - "cd $project\n", - "pwd\n", - "\n", - "echo \"\"\n", - "echo \"list top level or root of files with project pulled from github\"\n", - "ls\n" - ] - }, - { - "attachments": {}, - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### Look at file list with hidden and long attributes\n", - "> Most linux commands have options to enhance behavior. The enhanced listing below shows permission bits, owner of file, size and date.\n", - "\n", - "[ls reference](https://www.rapidtables.com/code/linux/ls.html)" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "vscode": { - "languageId": "shellscript" - } - }, - "outputs": [], - "source": [ - "%%script bash\n", - "\n", - "# Extract saved variables\n", - "source /tmp/variables.sh\n", - "\n", - "echo \"Navigate to project, then navigate to area wwhere files were cloned\"\n", - "cd $project\n", - "pwd\n", - "\n", - "echo \"\"\n", - "echo \"list all files in long format\"\n", - "ls -al # all files -a (hidden) in -l long listing" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "vscode": { - "languageId": "shellscript" - } - }, - "outputs": [], - "source": [ - "%%script bash\n", - "\n", - "# Extract saved variables\n", - "source /tmp/variables.sh\n", - "\n", - "echo \"Look for posts\"\n", - "export posts=$project/_posts # _posts inside project\n", - "cd $posts # this should exist per fastpages\n", - "pwd # present working directory\n", - "ls -l # list posts" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "vscode": { - "languageId": "shellscript" - } - }, - "outputs": [], - "source": [ - "%%script bash\n", - "\n", - "# Extract saved variables\n", - "source /tmp/variables.sh\n", - "\n", - "echo \"Look for notebooks\"\n", - "export notebooks=$project/_notebooks # _notebooks is inside project\n", - "cd $notebooks # this should exist per fastpages\n", - "pwd # present working directory\n", - "ls -l # list notebooks" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "vscode": { - "languageId": "shellscript" - } - }, - "outputs": [], - "source": [ - "%%script bash\n", - "\n", - "# Extract saved variables\n", - "source /tmp/variables.sh\n", - "\n", - "echo \"Look for images in notebooks, print working directory, list files\"\n", - "cd $notebooks/images # this should exist per fastpages\n", - "pwd\n", - "ls -l" - ] - }, - { - "attachments": {}, - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### Look inside a Markdown File\n", - "> \"cat\" reads data from the file and gives its content as output" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "vscode": { - "languageId": "shellscript" - } - }, - "outputs": [], - "source": [ - "%%script bash\n", - "\n", - "# Extract saved variables\n", - "source /tmp/variables.sh\n", - "\n", - "echo \"Navigate to project, then navigate to area wwhere files were cloned\"\n", - "\n", - "cd $project\n", - "echo \"show the contents of README.md\"\n", - "echo \"\"\n", - "\n", - "cat README.md # show contents of file, in this case markdown\n", - "echo \"\"\n", - "echo \"end of README.md\"\n" - ] - }, - { - "attachments": {}, - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Env, Git and GitHub\n", - "> Env(ironment) is used to capture things like path to Code or Home directory. Git and GitHub is NOT Only used to exchange code between individuals, it is often used to exchange code through servers, in our case deployment for Website. All tools we use have a behind the scenes relationships with the system they run on (MacOS, Windows, Linus) or a relationship with servers which they are connected to (ie GitHub). There is an \"env\" command in bash. There are environment files and setting files (.git/config) for Git. They both use a key/value concept.\n", - "\n", - "- \"env\" show setting for your shell\n", - "- \"git clone\" sets up a director of files\n", - "- \"cd $project\" allows user to move inside that directory of files\n", - "- \".git\" is a hidden directory that is used by git to establish relationship between machine and the git server on GitHub. " - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "vscode": { - "languageId": "shellscript" - } - }, - "outputs": [], - "source": [ - "%%script bash\n", - "\n", - "# This command has no dependencies\n", - "\n", - "echo \"Show the shell environment variables, key on left of equal value on right\"\n", - "echo \"\"\n", - "\n", - "env" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "vscode": { - "languageId": "shellscript" - } - }, - "outputs": [], - "source": [ - "%%script bash\n", - "\n", - "# Extract saved variables\n", - "source /tmp/variables.sh\n", - "\n", - "cd $project\n", - "\n", - "echo \"\"\n", - "echo \"show the secrets of .git\"\n", - "cd .git\n", - "ls -l\n", - "\n", - "echo \"\"\n", - "echo \"look at config file\"\n", - "cat config" - ] - }, - { - "attachments": {}, - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Advanced Student Request - Make a file in Bash\n", - "> This example was requested by a student (Jun Lim, CSA). The request was to make jupyer file using bash, I adapted the request to markdown. This type of thought will have great extrapolation to coding and possibilities of using List, Arrays, or APIs to build user interfaces. JavaScript is a language where building HTML is very common.\n", - "\n", - "> To get more interesting output from terminal, this will require using something like mdless (https://github.com/ttscoff/mdless). This enables see markdown in rendered format.\n", - "- On Desktop [Install PKG from MacPorts](https://www.macports.org/install.php)\n", - "- In Terminal on MacOS\n", - " - [Install ncurses](https://ports.macports.org/port/ncurses/)\n", - " - ```gem install mdless```\n", - " \n", - "> Output of the example is much nicer in \"jupyter\"" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "vscode": { - "languageId": "shellscript" - } - }, - "outputs": [], - "source": [ - "%%script bash\n", - "\n", - "# This example has error in VSCode, it run best on Jupyter\n", - "cd /tmp\n", - "\n", - "file=\"sample.md\"\n", - "if [ -f \"$file\" ]; then\n", - " rm $file\n", - "fi\n", - "\n", - "tee -a $file >/dev/null <>) redirection operator.\" >> $file\n", - "echo \"- The list definition, as is, is using space to seperate lines. Thus the use of commas and hyphens in output.\" >> $file\n", - "actions=(\"ls,list-directory\" \"cd,change-directory\" \"pwd,present-working-directory\" \"if-then-fi,test-condition\" \"env,bash-environment-variables\" \"cat,view-file-contents\" \"tee,write-to-output\" \"echo,display-content-of-string\" \"echo_text_>\\$file,write-content-to-file\" \"echo_text_>>\\$file,append-content-to-file\")\n", - "for action in ${actions[@]}; do # for loop is very similar to other language, though [@], semi-colon, do are new\n", - " action=${action//-/ } # convert dash to space\n", - " action=${action//,/: } # convert comma to colon\n", - " action=${action//_text_/ \\\"sample text\\\" } # convert _text_ to sample text, note escape character \\ to avoid \"\" having meaning\n", - " echo \" - ${action//-/ }\" >> $file # echo is redirected to file with >>\n", - "done\n", - "\n", - "echo \"\"\n", - "echo \"File listing and status\"\n", - "ls -l $file # list file\n", - "wc $file # show words\n", - "mdless $file # this requires installation, but renders markown from terminal\n", - "\n", - "rm $file # clean up termporary file" - ] - }, - { - "attachments": {}, - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Hack Preparation.\n", - "> Review Tool Setup Procedures and think about some thing you could verify through a Shell notebook.\n", - "- Come up with your own student view of this procedure to show your tools are installed. It is best that you keep the few things you understand, add things later as you start to understand them.\n", - "- Name and create blog notes on some Linux commands you will use frequently.\n", - "- Is there anything we use to verify tools we installed? Review versions?\n", - "- How would you update a repository? Use the git command line? \n" - ] - } - ], - "metadata": { - "kernelspec": { - "display_name": "Python 3.10.6 64-bit", - "language": "python", - "name": "python3" - }, - "language_info": { - "codemirror_mode": { - "name": "ipython", - "version": 3 - }, - "file_extension": ".py", - "mimetype": "text/x-python", - "name": "python", - "nbconvert_exporter": "python", - "pygments_lexer": "ipython3", - "version": "3.9.12" - }, - "vscode": { - "interpreter": { - "hash": "aee8b7b246df8f9039afb4144a1f6fd8d2ca17a180786b69acc140d282b71a49" - } - } - }, - "nbformat": 4, - "nbformat_minor": 2 -} diff --git a/_notebooks/2023-08-17-AP-pseudo-vs-python.ipynb b/_notebooks/2023-08-17-Markdown_Table_Code_Hack.ipynb similarity index 93% rename from _notebooks/2023-08-17-AP-pseudo-vs-python.ipynb rename to _notebooks/2023-08-17-Markdown_Table_Code_Hack.ipynb index 2bf2ad3e4..dfa1a0a76 100644 --- a/_notebooks/2023-08-17-AP-pseudo-vs-python.ipynb +++ b/_notebooks/2023-08-17-Markdown_Table_Code_Hack.ipynb @@ -9,20 +9,13 @@ "toc: true\n", "comments: true\n", "layout: post\n", - "title: College Board Pseudo Code \n", - "description: The College Board testing language is Pseudo Code. Pseudo mean kind-of language that we will compare to Python.\n", - "courses: { csp: {week: 1} }\n", + "title: Sample IPYNB w/ table,code\n", + "description: Example!!! This sample shows markdown cell, markdown table, markdown code fencing, and code cells.\n", + "courses: { compsci: {week: 1} }\n", "type: hacks\n", "---" ] }, - { - "cell_type": "code", - "execution_count": null, - "metadata": {}, - "outputs": [], - "source": [] - }, { "attachments": {}, "cell_type": "markdown", @@ -76,9 +69,17 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 1, "metadata": {}, - "outputs": [], + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "A equals B\n" + ] + } + ], "source": [ "# Python code if block to match Pseudo Code\n", "a = 1\n", diff --git a/_notebooks/2023-08-21-VSCode-GitHub_Pages.ipynb b/_notebooks/2023-08-21-HTML_Image_Hack.ipynb similarity index 98% rename from _notebooks/2023-08-21-VSCode-GitHub_Pages.ipynb rename to _notebooks/2023-08-21-HTML_Image_Hack.ipynb index 81fa14f6f..87fc24d7f 100644 --- a/_notebooks/2023-08-21-VSCode-GitHub_Pages.ipynb +++ b/_notebooks/2023-08-21-HTML_Image_Hack.ipynb @@ -8,10 +8,10 @@ "---\n", "comments: true\n", "layout: post\n", - "title: Student GitHub Pages\n", + "title: Sample IPYNB w/ html,img\n", "description: A key to development in this class is the association VSCode to a GitHub pages project. This is where students update assignments and present work.\n", "type: hacks\n", - "courses: { csse: {week: 0}, csp: {week: 0}, csa: {week: 0} }\n", + "courses: { compsci: {week: 0} }\n", "categories: [C4.1]\n", "---" ] diff --git a/_notebooks/2023-08-30-Calculator.ipynb b/_notebooks/2023-08-30-Calculator.ipynb new file mode 100644 index 000000000..45216098e --- /dev/null +++ b/_notebooks/2023-08-30-Calculator.ipynb @@ -0,0 +1,455 @@ +{ + "cells": [ + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "---\n", + "comments: true\n", + "layout: post\n", + "title: Calculator IPYNB\n", + "description: Grab Calculator Code and place in IPYNB\n", + "type: hacks\n", + "courses: { compsci: {week: 2} }\n", + "---" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Make a GitHub Pages Repository\n", + "Understanding Calculator code is a great way to learn JavaScript.\n", + "- Calculator was obtained from Teacher in _post directory\n", + "- Calculator also requires assets directory also obtained from Teacher\n", + " - assets/css contains customized style for buttons\n", + " - assets/js contains vanta animations \n", + "- Code cell requires `%%html` at the top of cell to support css, html, script." + ] + }, + { + "cell_type": "code", + "execution_count": 2, + "metadata": { + "vscode": { + "languageId": "html" + } + }, + "outputs": [ + { + "data": { + "text/html": [ + "\n", + "\n", + "\n", + "
\n", + "
\n", + " \n", + "
0
\n", + " \n", + "
1
\n", + "
2
\n", + "
3
\n", + "
+
\n", + " \n", + "
4
\n", + "
5
\n", + "
6
\n", + "
-
\n", + " \n", + "
7
\n", + "
8
\n", + "
9
\n", + "
*
\n", + " \n", + "
A/C
\n", + "
0
\n", + "
.
\n", + "
=
\n", + "
\n", + "
\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n" + ], + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "%%html\n", + "\n", + "\n", + "\n", + "
\n", + "
\n", + " \n", + "
0
\n", + " \n", + "
1
\n", + "
2
\n", + "
3
\n", + "
+
\n", + " \n", + "
4
\n", + "
5
\n", + "
6
\n", + "
-
\n", + " \n", + "
7
\n", + "
8
\n", + "
9
\n", + "
*
\n", + " \n", + "
A/C
\n", + "
0
\n", + "
.
\n", + "
=
\n", + "
\n", + "
\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "" + ] + } + ], + "metadata": { + "kernelspec": { + "display_name": "Python 3 (ipykernel)", + "language": "python", + "name": "python3" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.11.4" + } + }, + "nbformat": 4, + "nbformat_minor": 2 +} diff --git a/_posts/2023-08-15-Tools_Plans_Sample.md b/_posts/2023-08-15-Tools_Plans_Sample.md new file mode 100644 index 000000000..b695367b7 --- /dev/null +++ b/_posts/2023-08-15-Tools_Plans_Sample.md @@ -0,0 +1,15 @@ +--- +toc: true +comments: false +layout: post +title: Starting Plans +description: Plans for Week 0 and Notes +type: plans +courses: { compsci: {week: 0} } +--- + +### PBL Unit 1 / Week 0 +Learning outcome. Installing Tools and showing usage of VSCode. +- Wednesday - Pick pair share partner, Pick crossover pair, Establish team of four. Spend some time talking and getting to know each other, particularly with Computer Science experience and goals. You should be matched with someone that has similar experience. +- Thursday - Setup Tools on laptop and/or Cloud Computer. +- Friday - Review and test as a Pair. Spend 25 minutes at one keyboard then switch for next 25 minutes. \ No newline at end of file diff --git a/_posts/2023-08-16-Tools_Equipment.md b/_posts/2023-08-16-Tools_Equipment.md deleted file mode 100644 index 999b24b01..000000000 --- a/_posts/2023-08-16-Tools_Equipment.md +++ /dev/null @@ -1,93 +0,0 @@ ---- -toc: true -comments: true -layout: post -title: VSCode, Python, Jupyter, ... -description: Tools and equipment setup for tools used throughout this class. -courses: { csse: {week: 0}, csp: {week: 0}, csa: {week: 0} } -type: hacks ---- - -## Hacks -> Complete the procedure below accurately. These are absolutely required and must be 100% accurate for your success. - -### GitHub Account -- Follow instruction [https://docs.github.com/en/get-started/signing-up-for-github/signing-up-for-a-new-github-account](https://docs.github.com/en/get-started/signing-up-for-github/signing-up-for-a-new-github-account) Use your own personal/permanent email... NOT SCHOOL!!! GitHub account belongs to you. - -### MacOS 1st Time Developer -> VSCode install -- Install [VSCode](https://code.visualstudio.com/docs/setup/mac) - -> Anaconda install -- Download for MacOS: [Anaconda](https://www.anaconda.com/products/distribution) -- Run Install: Answer yes to questions - -> Homebrew install -- Copy and Paste to Install from Terminal [Homebrew](https://brew.sh) - - Copy ```bash ... curl ...``` command using copy box on website - - Launch ```terminal``` from search bar - - Paste ```bash ... curl ...``` command into Terminal ... - - Make sure command starts, this should provide feedback/output in terminal and could take a long time, like 10-min, there could be a prompt in the middle, at about 5-minutes. Follow any on screen instructions provided in terminal output to finish. -- Homebrew installs a tool called "brew" which helps add and manage developer packages on MacOS. - -> At this point, the next task is to prepare tools. You must start a new Terminal. Now the Terminal prompt should be prefixed with (base). If not, you need to go back to Anaconda install. -- Open new Terminal, your prompt should look like this... -```bash -(base) iMac:~ jmort1021$ -``` - -> Key Packages needed on MacOS -- Close and Start a new terminal, run each command in Terminal -```bash -$ brew list # list packages -$ brew update # update package list -$ brew upgrade # upgrade packages -$ brew install git # install latest git -$ brew install python # install python3 for development -$ python --version # version of python3 installed -``` -### Windows 1st Time Developer -> VSCode install using WSL. Windows users have option to have best of Windows and Linux while developing within VSCode. -- Install [VSCode using WSL]({{site.baseurl}}/techtalk/vscode-wsl). -- Required review, become familiar with [Windows WSL development](https://code.visualstudio.com/docs/remote/wsl-tutorial) - -> Anaconda install on WSL. -- Try the exact commands in WSL Command / Powershell. -- Only if there is a wget error... To find the latest Linux-x86 distribution hover over ```64-Bit (x86) Installer``` of this page: https://www.anaconda.com/download#downloads. Hover over wget and Anaconda3 commands based on new link. -```bash -> PS C:\Users\UserName> wsl # Windows prompt to WSL command -$ cd /tmp -$ wget https://repo.anaconda.com/archive/Anaconda3-2023.03-1-Linux-x86_64.sh -$ chmod +x Anaconda3-2023.03-1-Linux-x86_64.sh -# Answer yes to all the prompts -$ ./Anaconda3-2023.03-1-Linux-x86_64.sh -``` - -> At this point, the next task is to prepare for Packages, Jupyter Notebooks, and Kernels. You must start a new WSL Command / Powershell. Now the WSL prompt should be prefixed with (base) from Anaconda install. If not, you need to go back to Anaconda install. -- Open Command / Powershell. If you are not looking like this you need to back up. -```bash -> PS C:\Users\ShayM> wsl # Windows prompt -(base) shay@MSI:/mnt/c/Users/ShayM$ cd ~ # WSL prompt -(base) shay@MSI:~$ # WSL home, best place to install files -``` - -> Key Packages needing update on WSL Ubuntu -- In a WSL Command / Powershell install Python3 -```bash -$ sudo apt list # list packages -$ sudo apt update # update package list -$ sudo apt upgrade # upgrade packages -$ sudo apt install python3 python3-pip # install python3 and pip3 for development -$ python --version # version of python3 should be shown - - -### Jupyter Install and Kernels (MacOs and WSL) - -> Install Jupyter and check python kernel -```bash -(base) id:~$ conda --version -(base) id:~$ conda install jupyter # install jupyter -(base) id:~$ jupyter kernelspec list # list installed kernels -Available kernels: - python3 /home/shay/.local/share/jupyter/kernels/python3 -``` diff --git a/_posts/2023-08-16-Tools_Help.md b/_posts/2023-08-16-Tools_Help.md new file mode 100644 index 000000000..1de4a4095 --- /dev/null +++ b/_posts/2023-08-16-Tools_Help.md @@ -0,0 +1,18 @@ +--- +toc: false +comments: false +hide: true +layout: post +type: help +title: Tool References +--- + +### `Visual Studio Code` [Overview](https://code.visualstudio.com/docs/introvideos/basics) + +### `Jupyter Notebooks` [Review Jupyter basics 6-min](https://www.youtube.com/watch?v=3jZYC9rGrNg) + +### `WSL` [Basic Commands](https://learn.microsoft.com/en-us/windows/wsl/basic-commands) + +### `Linux Commands` [Cheat Sheet](https://www.geeksforgeeks.org/linux-commands-cheat-sheet/) + +### `Docker` [Docker Overview](https://docs.docker.com/get-started/overview/) diff --git a/_posts/2023-08-16-Week_0_Hacks_Sample.md b/_posts/2023-08-16-Week_0_Hacks_Sample.md new file mode 100644 index 000000000..1a9e9b68f --- /dev/null +++ b/_posts/2023-08-16-Week_0_Hacks_Sample.md @@ -0,0 +1,134 @@ +--- +toc: true +comments: true +layout: post +title: Week 0 Hacks +description: +courses: { compsci: {week: 0} } +type: hacks +--- + + +## Hacks +> Make you own project from GitHub Pages Student Repo. +1. Open terminal and go to terminal +2. Run cd command to go to home directory +3. Create and move into a vscode directory with mkdir vscode and then cd vscode +4. Clone the student repository using "git clone" +5. Go to terminal and run these commands git config --global user.email (your email) git config --global user.name (your github id) +6. Download necessary tools such as rbenv, python, jupyter, and gems + +## Make a GitHub Pages Repository +> Goto GitHub [student](https://github.com/nighthawkcoders/student). + +- Reference: [Create from template](https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template). Most student will pick this option. + + +- Reference: [Fork a repo](https://docs.github.com/en/get-started/quickstart/fork-a-repo). Student in CSA that teacher has asked to contribute to student example repo will pick this. + + +## Start the GitHub Pages Student Project +> Run the following commands using terminal on you machine. Be sure Repo has been forked. + +- Clone and Open project in VSCode +- Change "forkme" text with your "ghid" or selected location + + +```bash +(base) id:~$ mkdir vscode # make a vscode directory, if you don't have one +(base) id:~$ cd vscode # change to the directory +(base) id:~$ git clone https://github.com/forkme/student.git # change to your repo +(base) id:~$ cd student # change to the project directory +(base) id:~$ code . # open VSCode in project directory +``` + +### VSCode for Python Extensions, adapt for your needs JavaScript, Python, Java +- VSCode [Language extensions](https://code.visualstudio.com/docs/languages/overview) + - Install Python, Python Environment Manager, Python Extension Pack, Pylance + - Install Jupyter, Jupyter Keymap + - Install IntelliCode, IntelliCode API Usage Examples + - Windows machines install WSL Remote Development + + +```python +%%HTML + + + +
+
+ + Extensions + +
+
+
+

+ Visual Studio Code claims to provide just the tools a developer needs for a quick code-build-debug and version control cycle. It provides a Market Place for enhancements and more complex workflows. Before adding extensions, clone projects and see what is requested or added. Here are some extension that were added through that process or that I have added... +

+
    +
  • + In marketplace there are several extensions for Python, Python Intellisense, Python Extension Pack +
  • +
  • + Jupyter: This supports build jupyter ipynb files from within VS Code +
  • +
  • + Code Spell Checker: Got to have it when building documents, particularly if you spell and typo like the Teacher +
  • +
  • + IntelliCode: Got to have it when creating a code file, it will sense type of code by extension. Also, it help with syntax as you are coding. +
  • +
+

+ Review Details in Marketplace for better explanation of purpose of the things explained above. There is a lot more! As you need Git help look at things like Git History and GitLens. Or, perhaps you enjoy Vim and want Vim emulation for editing, their is an extension for that. Later, there may be interest in AWS Toolkit or Deploy extensions. We will learn more about Marketplace Extensions as we do more. +

+
+
+
+``` + + + + + +
+
+ + Extensions + +
+
+
+

+ Visual Studio Code claims to provide just the tools a developer needs for a quick code-build-debug and version control cycle. It provides a Market Place for enhancements and more complex workflows. Before adding extensions, clone projects and see what is requested or added. Here are some extension that were added through that process or that I have added... +

+
    +
  • + In marketplace there are several extensions for Python, Python Intellisense, Python Extension Pack +
  • +
  • + Jupyter: This supports build jupyter ipynb files from within VS Code +
  • +
  • + Code Spell Checker: Got to have it when building documents, particularly if you spell and typo like the Teacher +
  • +
  • + IntelliCode: Got to have it when creating a code file, it will sense type of code by extension. Also, it help with syntax as you are coding. +
  • +
+

+ Review Details in Marketplace for better explanation of purpose of the things explained above. There is a lot more! As you need Git help look at things like Git History and GitLens. Or, perhaps you enjoy Vim and want Vim emulation for editing, their is an extension for that. Later, there may be interest in AWS Toolkit or Deploy extensions. We will learn more about Marketplace Extensions as we do more. +

+
+
+
+ + + +## Hacks +> Setup Tools and test GitHub connection. Tool and Equipment setup is like attendance, without Tools and Equipment you are effectually absent. +- Change index.md to show it is REALLY YOURS. Refer to [Markdown Cheet Sheet](https://www.markdownguide.org/cheat-sheet/). + - Push a minor "index.md" change and Verify on GitHub [https://code.visualstudio.com/docs/editor/versioncontrol#_git-support](https://code.visualstudio.com/docs/editor/versioncontrol#_git-support) + - Verify "index.md" change on deployed GitHub Pages + diff --git a/_posts/2023-08-21-GitHub_Pages.md b/_posts/2023-08-21-GitHub_Pages.md deleted file mode 100644 index 5e0cb12cd..000000000 --- a/_posts/2023-08-21-GitHub_Pages.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -toc: true -comments: true -layout: post -title: GitHub Pages -description: Build your first Blog. This will help us communicate results. -type: plans -courses: { csse: {week: 1}, csp: {week: 1, categories: [4.A]}, csa: {week: 0} } -categories: [C1.4] ---- - -### PBL Unit 1 / Week 1 -Learning outcome. Building a personal and running GitHub Pages. -- Monday: Schedule Live Review - 4 minutes. Finish Tools setup. Attend Office Hours on HTML, CSS, JS and Student Blog. -- Tuesday: Read [Markdown Student Page](https://nighthawkcoders.github.io/teacher//c4.3/c5.0/2023/08/17/markdown-html_fragments.html), Attend Office Hours on Updating Home Page and Plan Page. -- Wednesday: Work Plan Page and Home Page. Prep with pair on live review. -- Thursday: 10:45 live review per Canvas. Read [Linux Shell and Bash](https://nighthawkcoders.github.io/teacher//5.a/c4.1/2023/08/16/linux_shell_IPYNB_2_.html). Tranfer blog and customize for my lab notebook. -- Update Blog to contain all hacks. Review week with Pair and look ahead and start plan for next week. diff --git a/_posts/2023-08-26-GitHub_Sync.md b/_posts/2023-08-26-GitHub_Sync.md new file mode 100644 index 000000000..27ac13d7b --- /dev/null +++ b/_posts/2023-08-26-GitHub_Sync.md @@ -0,0 +1,67 @@ +--- +toc: true +comments: false +hide: true +layout: post +type: help +title: GitHub Overview +--- + +## References + +### `GitHub` [Review GitHub concepts 2-min](https://www.youtube.com/watch?v=phGdqJB6ep0) + +### `Git source control` [VSCode](https://code.visualstudio.com/docs/sourcecontrol/overview) +
+ +## Create GitHub Page Repository +You will want to create a personal Github Pages blog for this class. This is a place where you can code, complete the hacks, and record what you have learned. + +### Git Config +Run the following commands to configure user git connection to GitHub. This is required, before pushing code to GitHub. + + ```bash + # Setup GitHub ID + git config --global user.email + git config --global user.name + # Verify Setup + git config --list + ``` + +### [click to Create Repository](https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template) + +1. Use Template to create [student repository](https://github.com/nighthawkcoders/student) + +2. Once your repository is created, click on the green "Code" button and copy the HTTPS link provided. + +3. In Terminal, to your vscode directory (`cd ~/vscode`). Then clone the repository with `git clone `. + +4. Open your repository in VS Code with `code `. Cloud Terminal requires you to open after lanuching VSCode. +
+ +## VSCode commit/sync to GitHub Pages +The VSCode saved files are only stored on your computer locally until you commit and then sync the changes. + +### Commit Changes, version control locally +This creates a version of your files in you local git database. Often developers commit several times before they sync in VSCode or push from command line. This allows lots of small changes that can be easily reviewed and rolled back. + +1. Click on the button that supports "Source Control" in VS Code's left sidebar + +2. Click on the plus sign to stage your changes + + ![]({{ site.baseurl }}/images/stage.jpg) + +3. Enter a message for your commit in the message box. + +4. Click the "Commit button" + + +### Sync Changes, update change in GitHub +Sync will push files to GitHub and create an Action for GitHub Pages updates, site will update if code is without errors. + +- Click the Menu button and then click "Push". + + ![]({{ site.baseurl }}/images/push.jpg) + +- Watch Actions until done, open action link and review changes on github.io + diff --git a/_posts/2023-08-15-Tools_Sprint.md b/_posts/2023-08-28-Week_1_Plans.md similarity index 53% rename from _posts/2023-08-15-Tools_Sprint.md rename to _posts/2023-08-28-Week_1_Plans.md index eb5a0cb74..b194c2364 100644 --- a/_posts/2023-08-15-Tools_Sprint.md +++ b/_posts/2023-08-28-Week_1_Plans.md @@ -1,26 +1,26 @@ --- toc: true -comments: true +comments: false layout: post -title: Tools Setup -description: Become one with your tools. They could be more important than code, code, coding. +title: Weekly Plan +description: Plan for Week 1 type: plans -courses: { csse: {week: 0}, csp: {week: 0, categories: [4.A]}, csa: {week: 0} } -categories: [C1.4] +courses: { compsci: {week: 1} } --- -### PBL Unit 1 / Week 0 -Learning outcome. Installing Tools and showing usage of VSCode. -- Wednesday - Pick pair share partner, Pick crossover pair, Establish team of four. Spend some time talking and getting to know each other, particularly with Computer Science experience and goals. You should be matched with someone that has similar experience. -- Thursday - Setup Tools on laptop and/or Cloud Computer. -- Friday - Review and test as a Pair. Spend 25 minutes at one keyboard then switch for next 25 minutes. +### PBL Unit 1 / Week 1 + - Download remaining tools, get a local website running + - Experiment on modifying the website with images, videos, minigames + - Edit blogs to create notebook and modify it + - Test around with the blogs and index, add minigames -### Hack Prepartation -> Look for 'Hacks' to know what to do next. Try to be done and learn your machine before Monday EOD. + +### Pair Planning Meeting +> Update Blog to contain all hacks. Review week with Pair and look ahead and start plan for next week. Try to be done and learn your machine before Monday EOD. - A laptop, that you bring to class every day with ability to operate Development Tools on it or within the Cloud. - GitHub Account, VSCode will be used to push/pull changes. GitHub is where we store and share code in the cloud, think of Google Docs but for Code. - GitHub Pages will be used to host your personal blog: containing notes, answering hacks, and showing tangibles. Building pages will teach Markdown, HTML, CSS, JavaScript and more. - Jupyter Notebooks will be used in conjunction with GitHub Pages to build running Code in your blog. - Slack Account, install the App on Laptop and/or phone, get used to reading announcements. Slack is the tool that we will use for messaging, we have been averaging 1000s of essages each year. - VSCode is the code editor we will be using in this class. VSCode is more than and editor, this type of tool is often called an Interactive Development Environment (IDE). -- Run make commands to build and test blog locally, before pushing changes to GitHub pages. +- Run make commands to build and test blog locally, before pushing changes to GitHub pages. \ No newline at end of file diff --git a/_posts/2023-08-30-Calculator_imported_2_.md b/_posts/2023-08-30-Calculator_imported_2_.md new file mode 100644 index 000000000..5b4b93924 --- /dev/null +++ b/_posts/2023-08-30-Calculator_imported_2_.md @@ -0,0 +1,201 @@ +--- +comments: false +layout: post +title: Imported Calculator +description: Grab Calculator Code and place in IPYNB +type: hacks +courses: {'compsci': {'week': 2}} +--- + + + + + + +
+
+ +
0
+ +
1
+
2
+
3
+
+
+ +
4
+
5
+
6
+
-
+ +
7
+
8
+
9
+
*
+ +
A/C
+
0
+
.
+
=
+
+
+ + + + + + + + + + + + + + diff --git a/_posts/2023-08-30-game_of_life.md b/_posts/2023-08-30-game_of_life.md new file mode 100644 index 000000000..a371e546b --- /dev/null +++ b/_posts/2023-08-30-game_of_life.md @@ -0,0 +1,200 @@ +--- +toc: True +comments: False +layout: post +title: Game of life +description: A simulation fof Convay's game of life +courses: {'compsci': {'week': 2}} +type: hacks +--- + + + + +
+
+ Remix of Game of Life +
+ + + + +
+
+
+ + \ No newline at end of file diff --git a/_posts/2023-08-30-get_to_know_me.md b/_posts/2023-08-30-get_to_know_me.md new file mode 100644 index 000000000..45617e78a --- /dev/null +++ b/_posts/2023-08-30-get_to_know_me.md @@ -0,0 +1,70 @@ +--- +toc: True +comments: False +layout: post +title: Get to Know Me Game +description: A simple quiz on me using input and output in html +courses: {'compsci': {'week': 1}} +type: hacks +--- + + + + Get To Know Me Game + + +

Hello. Welcome to the Get To Know Me Game.

+

This is a multiple choice test that will test your knowledge about me.

+ +
+
+ +
+ + + + \ No newline at end of file diff --git a/_posts/2023-08-30-search_terms.md b/_posts/2023-08-30-search_terms.md new file mode 100644 index 000000000..342cbb7f4 --- /dev/null +++ b/_posts/2023-08-30-search_terms.md @@ -0,0 +1,99 @@ +--- +toc: true +comments: true +layout: post +title: Glossary +description: Search up terms for their definiton. These terms are from notes/hacks. +type: tangibles +courses: { compsci: {week: 1} } +--- + + + + Command Glossary + + + +

Command Glossary

+

Enter a command to get its definition:

+ + +

+ + + + + +- make - command that helps run your local server +- make convert - checks and ensures Jupyter notebooks are up to date +- make clean - stops the local server and cleans the files +- make stop - stops the local server +- cd - allows you to move through directories +- cd vscode - allows you to go to VSCode directory +- python –version - shows you your current python version +- jupyter –version - shows all your jupyter files and their current versions +- git clone - clones a repository +- rbenv versions - shows your current ruby versions +- ruby -v - shows your current ruby version +- bundle install - this command installs the dependencies in your Gemfile +- adds an image +- ls - lists files in the respository +- pwd - Print working directory command +- mkdir - Command used to create directories +- echo - Print any text that follows the command +- clear - Clear the terminal display +- mv - Move or rename files +- useradd - adds a new user +- sudo - command to create privileges \ No newline at end of file diff --git a/_posts/2023-08-30-snakegame.md b/_posts/2023-08-30-snakegame.md new file mode 100644 index 000000000..a765e284a --- /dev/null +++ b/_posts/2023-08-30-snakegame.md @@ -0,0 +1,374 @@ +--- +toc: true +comments: false +layout: post +title: Snake Game +description: A classic snake game +type: hacks +courses: { compsci: {week: 2} } +--- + + + + +
+
+

Snake score: 0

+
+
+ + + +
+

Game Over, press space to try again

+ new game + settings +
+ + + +
+

Settings Screen, press space to go back to playing

+ new game +
+

Speed: + + + + + + +

+

Wall: + + + + +

+
+
+
+ + diff --git a/_posts/2023-08-30-week_0_ticket.md b/_posts/2023-08-30-week_0_ticket.md new file mode 100644 index 000000000..8213fb597 --- /dev/null +++ b/_posts/2023-08-30-week_0_ticket.md @@ -0,0 +1,16 @@ +--- +toc: true +comments: false +layout: post +title: Review Ticket +description: Review for Week 0 +type: tangibles +courses: { compsci: {week: 0} } +--- + +### Week Overview +Learning outcome. Installing Tools and showing usage of VSCode. + - Listened to Mr. Mortenson talk about the class, online notebooks are important + - Installed VSCode, homebrew, and made an account for Github + - Was playing around with the terminal by opening directories + - Installed python and Jupyter on VSCode \ No newline at end of file diff --git a/_posts/2023-08-30-week_1_ticket.md b/_posts/2023-08-30-week_1_ticket.md new file mode 100644 index 000000000..1d82bd2f4 --- /dev/null +++ b/_posts/2023-08-30-week_1_ticket.md @@ -0,0 +1,24 @@ +--- +toc: true +comments: true +layout: post +title: Review Ticket +description: Overview of Week 1 +type: tangibles +courses: { compsci: {week: 1} } +--- + +### Summary of Accomplishments +- Opened a new terminal, created a vscode directory with mkdir vscode and then cd vscode +- Cloned a teacher repository by using git clone +- After learning how do clone a teacher repository I cloned a student repository and forked it onto my Github account +- Opened my student repository in VSCode +- Followed install steps to install gems, pip, ruby, and more +- Once done installing all the necessary tools, I opened terminal in vscode and wrote bundle install and then typed make +- Once the server ran and provided with the link, I opened the website +- I linked the website to my Github Account +- Played around with the website, opened index.md and then changed the heading text to Sri’s Page +- Pressed command save and then went to my website again to see the change +- Repeated the 2 steps above and added more info about me +- Wanted to add free form picture, tried dragging and linking image to my index.md but it didn’t work +- Fixed the problem by copying the relative path of the image and pasting it in and using ![](imageurl) \ No newline at end of file diff --git a/_posts/2023-08-31-Week_2_Plans.md b/_posts/2023-08-31-Week_2_Plans.md new file mode 100644 index 000000000..cea686b7e --- /dev/null +++ b/_posts/2023-08-31-Week_2_Plans.md @@ -0,0 +1,20 @@ +--- +toc: false +comments: false +layout: post +title: Weekly Plan +description: Plans for week 2 +type: plans +courses: { compsci: {week: 2} } +--- + +# Notebook/Website Plans +- Copy new reposity Mortensen created with new files and ad to your local repository +- Edit the lab notebook to maintain a record of project activities and progress. +- Gain increased familiarity with working with .ipynb (Jupyter Notebook) and .md (Markdown) files. + +# Hacks Plan +- Added games including Game of Life and Snake to the project. +- Develop a new game called "Calculator Quiz" from scratch, without copying existing code. +- Develop any other programs/tools that require coding + diff --git a/_posts/2023-08-31-calculator_game.md b/_posts/2023-08-31-calculator_game.md new file mode 100644 index 000000000..159056aaf --- /dev/null +++ b/_posts/2023-08-31-calculator_game.md @@ -0,0 +1,74 @@ +--- +toc: true +comments: false +layout: post +title: Math Quiz +description: A a game where you get randomly generated equations and have to solve them +type: hacks +courses: { compsci: {week: 2} } +--- + + + + Math Quiz + + +

Math Quiz

+
+
+ + + +
+
+ + + + diff --git a/_posts/2023-09-01-week_2_ticket.md b/_posts/2023-09-01-week_2_ticket.md new file mode 100644 index 000000000..52e0dfc56 --- /dev/null +++ b/_posts/2023-09-01-week_2_ticket.md @@ -0,0 +1,24 @@ +--- +toc: true +comments: true +layout: post +title: Review Ticket +description: Overview of Week 2 +type: tangibles +courses: { compsci: {week: 2} } +--- + +# Notebook/Website: + +- Copying New Repository: My first task was to copy a new repository created by Mortensen, which contained important files related to our project. This was essential to ensure that I had access to the latest updates and materials. I was able to successfully clone the repository. + +- Editing the Lab Notebook: Maintaining a comprehensive record of project activities and progress is crucial for tracking our work and ensuring that everyone is on the same page. I added all the programs, blogs and plans to my website. I used .ipynb and .md files to edit my page + +- Gaining Familiarity with .ipynb and .md Files: Working with .ipynb (Jupyter Notebook) and .md (Markdown) files is an essential skill in modern coding and data science projects. + +# Hacks: + +- We added a few game that Mortensen gave use. We add the calculator, game of life, and snake. + +- Developing "Calculator Quiz" from Scratch: Perhaps one of the most exciting accomplishments of the week was the development of the "Calculator Quiz" game entirely from scratch. The game generated a random equation and the user has to answer it correctly + diff --git a/_posts/2023-09-02-grade-calculator.md b/_posts/2023-09-02-grade-calculator.md new file mode 100644 index 000000000..ce84ab4c4 --- /dev/null +++ b/_posts/2023-09-02-grade-calculator.md @@ -0,0 +1,92 @@ +--- +comments: false +layout: post +title: Grade Calculator +description: A calculator that averages your grade +type: hacks +courses: {'compsci': {'week': 3}} +--- + + + +

Grade Calculator

+

Input scores, press tab to add each new number.

+ +

+ Total : 0.0 + Count : 0.0 + Average : 0.0 +

+ +
+ +
+ + \ No newline at end of file diff --git a/_posts/2023-09-04-dodging_game.md b/_posts/2023-09-04-dodging_game.md new file mode 100644 index 000000000..97182f2fa --- /dev/null +++ b/_posts/2023-09-04-dodging_game.md @@ -0,0 +1,125 @@ +--- +comments: false +layout: post +title: DodgingGame +description: A calculator that averages your grade +type: hacks +courses: {'compsci': {'week': 3}} +--- + + + + + + +
+
+
+ + + \ No newline at end of file diff --git a/_posts/2023-09-06-image_viewer.ipynb b/_posts/2023-09-06-image_viewer.ipynb new file mode 100644 index 000000000..a267a3290 --- /dev/null +++ b/_posts/2023-09-06-image_viewer.ipynb @@ -0,0 +1,80 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "---\n", + "comments: false\n", + "layout: post\n", + "title: Image Viewer\n", + "description: View any image\n", + "type: hacks\n", + "courses: {'compsci': {'week': 3}}\n", + "---\n" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "import tkinter as tk\n", + "from tkinter import filedialog\n", + "from PIL import Image, ImageTk\n", + "\n", + "# Function to open and display an image\n", + "def display_image():\n", + " # Open a file dialog for the user to select an image\n", + " file_path = filedialog.askopenfilename()\n", + " \n", + " if file_path:\n", + " # Open and display the selected image using Pillow (PIL)\n", + " img = Image.open(file_path)\n", + " img = img.resize((400, 400)) # Resize the image to fit the window\n", + " img = ImageTk.PhotoImage(img)\n", + " \n", + " # Create a label to display the image\n", + " img_label.config(image=img)\n", + " img_label.image = img\n", + "\n", + "# Create a GUI window\n", + "root = tk.Tk()\n", + "root.title('Image Viewer')\n", + "\n", + "# Create a button to trigger image selection and display\n", + "open_button = tk.Button(root, text='Open Image', command=display_image)\n", + "open_button.pack(pady=20)\n", + "\n", + "# Create a label to display the image\n", + "img_label = tk.Label(root)\n", + "img_label.pack()\n", + "\n", + "root.mainloop()\n" + ] + } + ], + "metadata": { + "kernelspec": { + "display_name": "Python 3", + "language": "python", + "name": "python3" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.10.12" + }, + "orig_nbformat": 4 + }, + "nbformat": 4, + "nbformat_minor": 2 +} diff --git a/_posts/2023-09-08-search_brittanica.md b/_posts/2023-09-08-search_brittanica.md new file mode 100644 index 000000000..4141357a7 --- /dev/null +++ b/_posts/2023-09-08-search_brittanica.md @@ -0,0 +1,28 @@ +--- +comments: false +layout: post +title: Search Britanica +description: View any image +type: hacks +courses: {'compsci': {'week': 3}} +--- + + + + + Britannica Search + + +

Britannica Search

+ + + + + + +
+ + + + + diff --git a/_posts/britannica_search.js b/_posts/britannica_search.js new file mode 100644 index 000000000..7b296f51a --- /dev/null +++ b/_posts/britannica_search.js @@ -0,0 +1,10 @@ +function searchBritannica() { + // Get the search query from the input field + const query = document.getElementById('searchQuery').value; + + // Construct the Britannica search URL + const britannicaURL = `https://www.britannica.com/search?query=${encodeURIComponent(query)}`; + + // Open a new tab/window with the Britannica search results + window.open(britannicaURL, '_blank'); +} diff --git a/_posts/terms.txt b/_posts/terms.txt new file mode 100644 index 000000000..3b7366478 --- /dev/null +++ b/_posts/terms.txt @@ -0,0 +1,20 @@ +make=command that helps run your local server +make convert=checks and ensures Jupyter notebooks are up to date +make clean=stops the local server and cleans the files +make stop=stops the local server +cd=allows you to move through directories +cd vscode=allows you to go to VSCode directory +python –version=shows you your current python version +jupyter –version=shows all your jupyter files and their current versions +git clone-clones a repository +rbenv versions=shows your current ruby versions +ruby -v=shows your current ruby version +bundle install=this command installs the dependencies in your Gemfile +Image on Markdown=![text](image_file) +ls=lists files in the respository +pwd=Print working directory command +mkdir=Command used to create directories +echo=Print any text that follows the command +clear=Clear the terminal display +mv=Move or rename files +sudo=command to create privileges diff --git a/assets/css/style.scss b/assets/css/style.scss new file mode 100644 index 000000000..f16fba087 --- /dev/null +++ b/assets/css/style.scss @@ -0,0 +1,90 @@ +--- +--- + +@import "{{ site.theme }}"; + +// STYLING PREFERNCES for SITE +// mixin used as a template for buttons + @mixin button { + width: auto; + height: auto; + border-radius: 10px; + background-color: #21807c; + border: 3px solid black; + font-size: 1.5em; + + display: flex; + justify-content: center; + align-items: center; + + grid-column: span 1; + grid-row: span 1; + + // Creates smooth animation effect + transition: all 0.5s; + } + + /* define class for redifined button */ + .button { + @include button; + } + + /* darkens the background color on hover to create a selecting effect */ + .button:hover { + background-color: #373737; + } + + /* "row style" is flexible size and aligns pictures in center */ + .row { + align-items: center; + display: flex; + } + + /* "column style" is one-third of the width with padding */ + .column { + flex: 16.66%; + padding: 3px; + } + +// STYLING FOR CALCULATOR + /* class to create the calculator's container; uses CSS grid dsiplay to partition off buttons */ + .calculator-container { + width: 90vw; /* this width and height is specified for mobile devices by default */ + height: 80vh; + margin: 0 auto; + + display: grid; + grid-template-columns: repeat(4, 1fr); /* fr is a special unit; learn more here: https://css-tricks.com/introduction-fr-css-unit/ */ + grid-template-rows: 0.5fr repeat(4, 1fr); + gap: 10px 10px; + } + + @media (min-width: 600px) { + .calculator-container { + width: 40vw; + height: 80vh; + } + } + + /* styling for the calculator number button */ + .calculator-number { + @extend .button; + } + + /* styling for the calculator operation button */ + .calculator-operation { + @extend .button; + } + + /* styling for the calculator clear button */ + .calculator-clear { + @extend .button; + background-color: #e68b1c; + } + + /* styling for the calculator equals button */ + .calculator-equals { + @extend .button; + background-color: #e70f0f; + } + diff --git a/assets/js/three.r119.min.js b/assets/js/three.r119.min.js new file mode 100644 index 000000000..bdaa29bcc --- /dev/null +++ b/assets/js/three.r119.min.js @@ -0,0 +1,2 @@ +// threejs.org/license +!function(t,e){"object"==typeof exports&&"undefined"!=typeof module?e(exports):"function"==typeof define&&define.amd?define(["exports"],e):e((t="undefined"!=typeof globalThis?globalThis:t||self).THREE={})}(this,(function(t){"use strict";void 0===Number.EPSILON&&(Number.EPSILON=Math.pow(2,-52)),void 0===Number.isInteger&&(Number.isInteger=function(t){return"number"==typeof t&&isFinite(t)&&Math.floor(t)===t}),void 0===Math.sign&&(Math.sign=function(t){return t<0?-1:t>0?1:+t}),"name"in Function.prototype==!1&&Object.defineProperty(Function.prototype,"name",{get:function(){return this.toString().match(/^\s*function\s*([^\(\s]*)/)[1]}}),void 0===Object.assign&&(Object.assign=function(t){if(null==t)throw new TypeError("Cannot convert undefined or null to object");for(var e=Object(t),n=1;n>8&255]+it[t>>16&255]+it[t>>24&255]+"-"+it[255&e]+it[e>>8&255]+"-"+it[e>>16&15|64]+it[e>>24&255]+"-"+it[63&n|128]+it[n>>8&255]+"-"+it[n>>16&255]+it[n>>24&255]+it[255&r]+it[r>>8&255]+it[r>>16&255]+it[r>>24&255]).toUpperCase()},clamp:function(t,e,n){return Math.max(e,Math.min(n,t))},euclideanModulo:function(t,e){return(t%e+e)%e},mapLinear:function(t,e,n,r,i){return r+(t-e)*(i-r)/(n-e)},lerp:function(t,e,n){return(1-n)*t+n*e},smoothstep:function(t,e,n){return t<=e?0:t>=n?1:(t=(t-e)/(n-e))*t*(3-2*t)},smootherstep:function(t,e,n){return t<=e?0:t>=n?1:(t=(t-e)/(n-e))*t*t*(t*(6*t-15)+10)},randInt:function(t,e){return t+Math.floor(Math.random()*(e-t+1))},randFloat:function(t,e){return t+Math.random()*(e-t)},randFloatSpread:function(t){return t*(.5-Math.random())},seededRandom:function(t){return void 0!==t&&(ot=t%2147483647),((ot=16807*ot%2147483647)-1)/2147483646},degToRad:function(t){return t*st.DEG2RAD},radToDeg:function(t){return t*st.RAD2DEG},isPowerOfTwo:function(t){return 0==(t&t-1)&&0!==t},ceilPowerOfTwo:function(t){return Math.pow(2,Math.ceil(Math.log(t)/Math.LN2))},floorPowerOfTwo:function(t){return Math.pow(2,Math.floor(Math.log(t)/Math.LN2))},setQuaternionFromProperEuler:function(t,e,n,r,i){var a=Math.cos,o=Math.sin,s=a(n/2),c=o(n/2),l=a((e+r)/2),u=o((e+r)/2),h=a((e-r)/2),d=o((e-r)/2),p=a((r-e)/2),f=o((r-e)/2);switch(i){case"XYX":t.set(s*u,c*h,c*d,s*l);break;case"YZY":t.set(c*d,s*u,c*h,s*l);break;case"ZXZ":t.set(c*h,c*d,s*u,s*l);break;case"XZX":t.set(s*u,c*f,c*p,s*l);break;case"YXY":t.set(c*p,s*u,c*f,s*l);break;case"ZYZ":t.set(c*f,c*p,s*u,s*l);break;default:console.warn("THREE.MathUtils: .setQuaternionFromProperEuler() encountered an unknown order: "+i)}}};function ct(t,e){for(var n=0;n0&&console.error("THREE.Matrix3: the constructor no longer reads arguments. use .set() instead.")}var e=t.prototype;return e.set=function(t,e,n,r,i,a,o,s,c){var l=this.elements;return l[0]=t,l[1]=r,l[2]=o,l[3]=e,l[4]=i,l[5]=s,l[6]=n,l[7]=a,l[8]=c,this},e.identity=function(){return this.set(1,0,0,0,1,0,0,0,1),this},e.clone=function(){return(new this.constructor).fromArray(this.elements)},e.copy=function(t){var e=this.elements,n=t.elements;return e[0]=n[0],e[1]=n[1],e[2]=n[2],e[3]=n[3],e[4]=n[4],e[5]=n[5],e[6]=n[6],e[7]=n[7],e[8]=n[8],this},e.extractBasis=function(t,e,n){return t.setFromMatrix3Column(this,0),e.setFromMatrix3Column(this,1),n.setFromMatrix3Column(this,2),this},e.setFromMatrix4=function(t){var e=t.elements;return this.set(e[0],e[4],e[8],e[1],e[5],e[9],e[2],e[6],e[10]),this},e.multiply=function(t){return this.multiplyMatrices(this,t)},e.premultiply=function(t){return this.multiplyMatrices(t,this)},e.multiplyMatrices=function(t,e){var n=t.elements,r=e.elements,i=this.elements,a=n[0],o=n[3],s=n[6],c=n[1],l=n[4],u=n[7],h=n[2],d=n[5],p=n[8],f=r[0],m=r[3],v=r[6],g=r[1],y=r[4],x=r[7],_=r[2],b=r[5],w=r[8];return i[0]=a*f+o*g+s*_,i[3]=a*m+o*y+s*b,i[6]=a*v+o*x+s*w,i[1]=c*f+l*g+u*_,i[4]=c*m+l*y+u*b,i[7]=c*v+l*x+u*w,i[2]=h*f+d*g+p*_,i[5]=h*m+d*y+p*b,i[8]=h*v+d*x+p*w,this},e.multiplyScalar=function(t){var e=this.elements;return e[0]*=t,e[3]*=t,e[6]*=t,e[1]*=t,e[4]*=t,e[7]*=t,e[2]*=t,e[5]*=t,e[8]*=t,this},e.determinant=function(){var t=this.elements,e=t[0],n=t[1],r=t[2],i=t[3],a=t[4],o=t[5],s=t[6],c=t[7],l=t[8];return e*a*l-e*o*c-n*i*l+n*o*s+r*i*c-r*a*s},e.getInverse=function(t,e){void 0!==e&&console.warn("THREE.Matrix3: .getInverse() can no longer be configured to throw on degenerate.");var n=t.elements,r=this.elements,i=n[0],a=n[1],o=n[2],s=n[3],c=n[4],l=n[5],u=n[6],h=n[7],d=n[8],p=d*c-l*h,f=l*u-d*s,m=h*s-c*u,v=i*p+a*f+o*m;if(0===v)return this.set(0,0,0,0,0,0,0,0,0);var g=1/v;return r[0]=p*g,r[1]=(o*h-d*a)*g,r[2]=(l*a-o*c)*g,r[3]=f*g,r[4]=(d*i-o*u)*g,r[5]=(o*s-l*i)*g,r[6]=m*g,r[7]=(a*u-h*i)*g,r[8]=(c*i-a*s)*g,this},e.transpose=function(){var t,e=this.elements;return t=e[1],e[1]=e[3],e[3]=t,t=e[2],e[2]=e[6],e[6]=t,t=e[5],e[5]=e[7],e[7]=t,this},e.getNormalMatrix=function(t){return this.setFromMatrix4(t).getInverse(this).transpose()},e.transposeIntoArray=function(t){var e=this.elements;return t[0]=e[0],t[1]=e[3],t[2]=e[6],t[3]=e[1],t[4]=e[4],t[5]=e[7],t[6]=e[2],t[7]=e[5],t[8]=e[8],this},e.setUvTransform=function(t,e,n,r,i,a,o){var s=Math.cos(i),c=Math.sin(i);this.set(n*s,n*c,-n*(s*a+c*o)+a+t,-r*c,r*s,-r*(-c*a+s*o)+o+e,0,0,1)},e.scale=function(t,e){var n=this.elements;return n[0]*=t,n[3]*=t,n[6]*=t,n[1]*=e,n[4]*=e,n[7]*=e,this},e.rotate=function(t){var e=Math.cos(t),n=Math.sin(t),r=this.elements,i=r[0],a=r[3],o=r[6],s=r[1],c=r[4],l=r[7];return r[0]=e*i+n*s,r[3]=e*a+n*c,r[6]=e*o+n*l,r[1]=-n*i+e*s,r[4]=-n*a+e*c,r[7]=-n*o+e*l,this},e.translate=function(t,e){var n=this.elements;return n[0]+=t*n[2],n[3]+=t*n[5],n[6]+=t*n[8],n[1]+=e*n[2],n[4]+=e*n[5],n[7]+=e*n[8],this},e.equals=function(t){for(var e=this.elements,n=t.elements,r=0;r<9;r++)if(e[r]!==n[r])return!1;return!0},e.fromArray=function(t,e){void 0===e&&(e=0);for(var n=0;n<9;n++)this.elements[n]=t[n+e];return this},e.toArray=function(t,e){void 0===t&&(t=[]),void 0===e&&(e=0);var n=this.elements;return t[e]=n[0],t[e+1]=n[1],t[e+2]=n[2],t[e+3]=n[3],t[e+4]=n[4],t[e+5]=n[5],t[e+6]=n[6],t[e+7]=n[7],t[e+8]=n[8],t},t}(),mt={getDataURL:function(t){if(/^data:/i.test(t.src))return t.src;if("undefined"==typeof HTMLCanvasElement)return t.src;var e;if(t instanceof HTMLCanvasElement)e=t;else{void 0===dt&&(dt=document.createElementNS("http://www.w3.org/1999/xhtml","canvas")),dt.width=t.width,dt.height=t.height;var n=dt.getContext("2d");t instanceof ImageData?n.putImageData(t,0,0):n.drawImage(t,0,0,t.width,t.height),e=dt}return e.width>2048||e.height>2048?e.toDataURL("image/jpeg",.6):e.toDataURL("image/png")}},vt=0;function gt(t,e,n,r,i,a,o,s,c,l){Object.defineProperty(this,"id",{value:vt++}),this.uuid=st.generateUUID(),this.name="",this.image=void 0!==t?t:gt.DEFAULT_IMAGE,this.mipmaps=[],this.mapping=void 0!==e?e:gt.DEFAULT_MAPPING,this.wrapS=void 0!==n?n:u,this.wrapT=void 0!==r?r:u,this.magFilter=void 0!==i?i:m,this.minFilter=void 0!==a?a:g,this.anisotropy=void 0!==c?c:1,this.format=void 0!==o?o:T,this.internalFormat=null,this.type=void 0!==s?s:y,this.offset=new pt(0,0),this.repeat=new pt(1,1),this.center=new pt(0,0),this.rotation=0,this.matrixAutoUpdate=!0,this.matrix=new ft,this.generateMipmaps=!0,this.premultiplyAlpha=!1,this.flipY=!0,this.unpackAlignment=4,this.encoding=void 0!==l?l:q,this.version=0,this.onUpdate=null}gt.DEFAULT_IMAGE=void 0,gt.DEFAULT_MAPPING=n,gt.prototype=Object.assign(Object.create(rt.prototype),{constructor:gt,isTexture:!0,updateMatrix:function(){this.matrix.setUvTransform(this.offset.x,this.offset.y,this.repeat.x,this.repeat.y,this.rotation,this.center.x,this.center.y)},clone:function(){return(new this.constructor).copy(this)},copy:function(t){return this.name=t.name,this.image=t.image,this.mipmaps=t.mipmaps.slice(0),this.mapping=t.mapping,this.wrapS=t.wrapS,this.wrapT=t.wrapT,this.magFilter=t.magFilter,this.minFilter=t.minFilter,this.anisotropy=t.anisotropy,this.format=t.format,this.internalFormat=t.internalFormat,this.type=t.type,this.offset.copy(t.offset),this.repeat.copy(t.repeat),this.center.copy(t.center),this.rotation=t.rotation,this.matrixAutoUpdate=t.matrixAutoUpdate,this.matrix.copy(t.matrix),this.generateMipmaps=t.generateMipmaps,this.premultiplyAlpha=t.premultiplyAlpha,this.flipY=t.flipY,this.unpackAlignment=t.unpackAlignment,this.encoding=t.encoding,this},toJSON:function(t){var e=void 0===t||"string"==typeof t;if(!e&&void 0!==t.textures[this.uuid])return t.textures[this.uuid];var n={metadata:{version:4.5,type:"Texture",generator:"Texture.toJSON"},uuid:this.uuid,name:this.name,mapping:this.mapping,repeat:[this.repeat.x,this.repeat.y],offset:[this.offset.x,this.offset.y],center:[this.center.x,this.center.y],rotation:this.rotation,wrap:[this.wrapS,this.wrapT],format:this.format,type:this.type,encoding:this.encoding,minFilter:this.minFilter,magFilter:this.magFilter,anisotropy:this.anisotropy,flipY:this.flipY,premultiplyAlpha:this.premultiplyAlpha,unpackAlignment:this.unpackAlignment};if(void 0!==this.image){var r=this.image;if(void 0===r.uuid&&(r.uuid=st.generateUUID()),!e&&void 0===t.images[r.uuid]){var i;if(Array.isArray(r)){i=[];for(var a=0,o=r.length;a1)switch(this.wrapS){case l:t.x=t.x-Math.floor(t.x);break;case u:t.x=t.x<0?0:1;break;case h:1===Math.abs(Math.floor(t.x)%2)?t.x=Math.ceil(t.x)-t.x:t.x=t.x-Math.floor(t.x)}if(t.y<0||t.y>1)switch(this.wrapT){case l:t.y=t.y-Math.floor(t.y);break;case u:t.y=t.y<0?0:1;break;case h:1===Math.abs(Math.floor(t.y)%2)?t.y=Math.ceil(t.y)-t.y:t.y=t.y-Math.floor(t.y)}return this.flipY&&(t.y=1-t.y),t}}),Object.defineProperty(gt.prototype,"needsUpdate",{set:function(t){!0===t&&this.version++}});var yt=function(){function t(t,e,n,r){void 0===t&&(t=0),void 0===e&&(e=0),void 0===n&&(n=0),void 0===r&&(r=1),Object.defineProperty(this,"isVector4",{value:!0}),this.x=t,this.y=e,this.z=n,this.w=r}var e=t.prototype;return e.set=function(t,e,n,r){return this.x=t,this.y=e,this.z=n,this.w=r,this},e.setScalar=function(t){return this.x=t,this.y=t,this.z=t,this.w=t,this},e.setX=function(t){return this.x=t,this},e.setY=function(t){return this.y=t,this},e.setZ=function(t){return this.z=t,this},e.setW=function(t){return this.w=t,this},e.setComponent=function(t,e){switch(t){case 0:this.x=e;break;case 1:this.y=e;break;case 2:this.z=e;break;case 3:this.w=e;break;default:throw new Error("index is out of range: "+t)}return this},e.getComponent=function(t){switch(t){case 0:return this.x;case 1:return this.y;case 2:return this.z;case 3:return this.w;default:throw new Error("index is out of range: "+t)}},e.clone=function(){return new this.constructor(this.x,this.y,this.z,this.w)},e.copy=function(t){return this.x=t.x,this.y=t.y,this.z=t.z,this.w=void 0!==t.w?t.w:1,this},e.add=function(t,e){return void 0!==e?(console.warn("THREE.Vector4: .add() now only accepts one argument. Use .addVectors( a, b ) instead."),this.addVectors(t,e)):(this.x+=t.x,this.y+=t.y,this.z+=t.z,this.w+=t.w,this)},e.addScalar=function(t){return this.x+=t,this.y+=t,this.z+=t,this.w+=t,this},e.addVectors=function(t,e){return this.x=t.x+e.x,this.y=t.y+e.y,this.z=t.z+e.z,this.w=t.w+e.w,this},e.addScaledVector=function(t,e){return this.x+=t.x*e,this.y+=t.y*e,this.z+=t.z*e,this.w+=t.w*e,this},e.sub=function(t,e){return void 0!==e?(console.warn("THREE.Vector4: .sub() now only accepts one argument. Use .subVectors( a, b ) instead."),this.subVectors(t,e)):(this.x-=t.x,this.y-=t.y,this.z-=t.z,this.w-=t.w,this)},e.subScalar=function(t){return this.x-=t,this.y-=t,this.z-=t,this.w-=t,this},e.subVectors=function(t,e){return this.x=t.x-e.x,this.y=t.y-e.y,this.z=t.z-e.z,this.w=t.w-e.w,this},e.multiplyScalar=function(t){return this.x*=t,this.y*=t,this.z*=t,this.w*=t,this},e.applyMatrix4=function(t){var e=this.x,n=this.y,r=this.z,i=this.w,a=t.elements;return this.x=a[0]*e+a[4]*n+a[8]*r+a[12]*i,this.y=a[1]*e+a[5]*n+a[9]*r+a[13]*i,this.z=a[2]*e+a[6]*n+a[10]*r+a[14]*i,this.w=a[3]*e+a[7]*n+a[11]*r+a[15]*i,this},e.divideScalar=function(t){return this.multiplyScalar(1/t)},e.setAxisAngleFromQuaternion=function(t){this.w=2*Math.acos(t.w);var e=Math.sqrt(1-t.w*t.w);return e<1e-4?(this.x=1,this.y=0,this.z=0):(this.x=t.x/e,this.y=t.y/e,this.z=t.z/e),this},e.setAxisAngleFromRotationMatrix=function(t){var e,n,r,i,a=.01,o=.1,s=t.elements,c=s[0],l=s[4],u=s[8],h=s[1],d=s[5],p=s[9],f=s[2],m=s[6],v=s[10];if(Math.abs(l-h)y&&g>x?gx?y=0?1:-1,y=1-v*v;if(y>Number.EPSILON){var x=Math.sqrt(y),_=Math.atan2(x,v*g);m=Math.sin(m*_)/x,o=Math.sin(o*_)/x}var b=o*g;if(s=s*m+h*b,c=c*m+d*b,l=l*m+p*b,u=u*m+f*b,m===1-o){var w=1/Math.sqrt(s*s+c*c+l*l+u*u);s*=w,c*=w,l*=w,u*=w}}t[e]=s,t[e+1]=c,t[e+2]=l,t[e+3]=u},t.multiplyQuaternionsFlat=function(t,e,n,r,i,a){var o=n[r],s=n[r+1],c=n[r+2],l=n[r+3],u=i[a],h=i[a+1],d=i[a+2],p=i[a+3];return t[e]=o*p+l*u+s*d-c*h,t[e+1]=s*p+l*h+c*u-o*d,t[e+2]=c*p+l*d+o*h-s*u,t[e+3]=l*p-o*u-s*h-c*d,t};var e=t.prototype;return e.set=function(t,e,n,r){return this._x=t,this._y=e,this._z=n,this._w=r,this._onChangeCallback(),this},e.clone=function(){return new this.constructor(this._x,this._y,this._z,this._w)},e.copy=function(t){return this._x=t.x,this._y=t.y,this._z=t.z,this._w=t.w,this._onChangeCallback(),this},e.setFromEuler=function(t,e){if(!t||!t.isEuler)throw new Error("THREE.Quaternion: .setFromEuler() now expects an Euler rotation rather than a Vector3 and order.");var n=t._x,r=t._y,i=t._z,a=t._order,o=Math.cos,s=Math.sin,c=o(n/2),l=o(r/2),u=o(i/2),h=s(n/2),d=s(r/2),p=s(i/2);switch(a){case"XYZ":this._x=h*l*u+c*d*p,this._y=c*d*u-h*l*p,this._z=c*l*p+h*d*u,this._w=c*l*u-h*d*p;break;case"YXZ":this._x=h*l*u+c*d*p,this._y=c*d*u-h*l*p,this._z=c*l*p-h*d*u,this._w=c*l*u+h*d*p;break;case"ZXY":this._x=h*l*u-c*d*p,this._y=c*d*u+h*l*p,this._z=c*l*p+h*d*u,this._w=c*l*u-h*d*p;break;case"ZYX":this._x=h*l*u-c*d*p,this._y=c*d*u+h*l*p,this._z=c*l*p-h*d*u,this._w=c*l*u+h*d*p;break;case"YZX":this._x=h*l*u+c*d*p,this._y=c*d*u+h*l*p,this._z=c*l*p-h*d*u,this._w=c*l*u-h*d*p;break;case"XZY":this._x=h*l*u-c*d*p,this._y=c*d*u-h*l*p,this._z=c*l*p+h*d*u,this._w=c*l*u+h*d*p;break;default:console.warn("THREE.Quaternion: .setFromEuler() encountered an unknown order: "+a)}return!1!==e&&this._onChangeCallback(),this},e.setFromAxisAngle=function(t,e){var n=e/2,r=Math.sin(n);return this._x=t.x*r,this._y=t.y*r,this._z=t.z*r,this._w=Math.cos(n),this._onChangeCallback(),this},e.setFromRotationMatrix=function(t){var e=t.elements,n=e[0],r=e[4],i=e[8],a=e[1],o=e[5],s=e[9],c=e[2],l=e[6],u=e[10],h=n+o+u;if(h>0){var d=.5/Math.sqrt(h+1);this._w=.25/d,this._x=(l-s)*d,this._y=(i-c)*d,this._z=(a-r)*d}else if(n>o&&n>u){var p=2*Math.sqrt(1+n-o-u);this._w=(l-s)/p,this._x=.25*p,this._y=(r+a)/p,this._z=(i+c)/p}else if(o>u){var f=2*Math.sqrt(1+o-n-u);this._w=(i-c)/f,this._x=(r+a)/f,this._y=.25*f,this._z=(s+l)/f}else{var m=2*Math.sqrt(1+u-n-o);this._w=(a-r)/m,this._x=(i+c)/m,this._y=(s+l)/m,this._z=.25*m}return this._onChangeCallback(),this},e.setFromUnitVectors=function(t,e){var n=t.dot(e)+1;return n<1e-6?(n=0,Math.abs(t.x)>Math.abs(t.z)?(this._x=-t.y,this._y=t.x,this._z=0,this._w=n):(this._x=0,this._y=-t.z,this._z=t.y,this._w=n)):(this._x=t.y*e.z-t.z*e.y,this._y=t.z*e.x-t.x*e.z,this._z=t.x*e.y-t.y*e.x,this._w=n),this.normalize()},e.angleTo=function(t){return 2*Math.acos(Math.abs(st.clamp(this.dot(t),-1,1)))},e.rotateTowards=function(t,e){var n=this.angleTo(t);if(0===n)return this;var r=Math.min(1,e/n);return this.slerp(t,r),this},e.identity=function(){return this.set(0,0,0,1)},e.inverse=function(){return this.conjugate()},e.conjugate=function(){return this._x*=-1,this._y*=-1,this._z*=-1,this._onChangeCallback(),this},e.dot=function(t){return this._x*t._x+this._y*t._y+this._z*t._z+this._w*t._w},e.lengthSq=function(){return this._x*this._x+this._y*this._y+this._z*this._z+this._w*this._w},e.length=function(){return Math.sqrt(this._x*this._x+this._y*this._y+this._z*this._z+this._w*this._w)},e.normalize=function(){var t=this.length();return 0===t?(this._x=0,this._y=0,this._z=0,this._w=1):(t=1/t,this._x=this._x*t,this._y=this._y*t,this._z=this._z*t,this._w=this._w*t),this._onChangeCallback(),this},e.multiply=function(t,e){return void 0!==e?(console.warn("THREE.Quaternion: .multiply() now only accepts one argument. Use .multiplyQuaternions( a, b ) instead."),this.multiplyQuaternions(t,e)):this.multiplyQuaternions(this,t)},e.premultiply=function(t){return this.multiplyQuaternions(t,this)},e.multiplyQuaternions=function(t,e){var n=t._x,r=t._y,i=t._z,a=t._w,o=e._x,s=e._y,c=e._z,l=e._w;return this._x=n*l+a*o+r*c-i*s,this._y=r*l+a*s+i*o-n*c,this._z=i*l+a*c+n*s-r*o,this._w=a*l-n*o-r*s-i*c,this._onChangeCallback(),this},e.slerp=function(t,e){if(0===e)return this;if(1===e)return this.copy(t);var n=this._x,r=this._y,i=this._z,a=this._w,o=a*t._w+n*t._x+r*t._y+i*t._z;if(o<0?(this._w=-t._w,this._x=-t._x,this._y=-t._y,this._z=-t._z,o=-o):this.copy(t),o>=1)return this._w=a,this._x=n,this._y=r,this._z=i,this;var s=1-o*o;if(s<=Number.EPSILON){var c=1-e;return this._w=c*a+e*this._w,this._x=c*n+e*this._x,this._y=c*r+e*this._y,this._z=c*i+e*this._z,this.normalize(),this._onChangeCallback(),this}var l=Math.sqrt(s),u=Math.atan2(l,o),h=Math.sin((1-e)*u)/l,d=Math.sin(e*u)/l;return this._w=a*h+this._w*d,this._x=n*h+this._x*d,this._y=r*h+this._y*d,this._z=i*h+this._z*d,this._onChangeCallback(),this},e.equals=function(t){return t._x===this._x&&t._y===this._y&&t._z===this._z&&t._w===this._w},e.fromArray=function(t,e){return void 0===e&&(e=0),this._x=t[e],this._y=t[e+1],this._z=t[e+2],this._w=t[e+3],this._onChangeCallback(),this},e.toArray=function(t,e){return void 0===t&&(t=[]),void 0===e&&(e=0),t[e]=this._x,t[e+1]=this._y,t[e+2]=this._z,t[e+3]=this._w,t},e.fromBufferAttribute=function(t,e){return this._x=t.getX(e),this._y=t.getY(e),this._z=t.getZ(e),this._w=t.getW(e),this},e._onChange=function(t){return this._onChangeCallback=t,this},e._onChangeCallback=function(){},lt(t,[{key:"x",get:function(){return this._x},set:function(t){this._x=t,this._onChangeCallback()}},{key:"y",get:function(){return this._y},set:function(t){this._y=t,this._onChangeCallback()}},{key:"z",get:function(){return this._z},set:function(t){this._z=t,this._onChangeCallback()}},{key:"w",get:function(){return this._w},set:function(t){this._w=t,this._onChangeCallback()}}]),t}(),wt=function(){function t(t,e,n){void 0===t&&(t=0),void 0===e&&(e=0),void 0===n&&(n=0),Object.defineProperty(this,"isVector3",{value:!0}),this.x=t,this.y=e,this.z=n}var e=t.prototype;return e.set=function(t,e,n){return void 0===n&&(n=this.z),this.x=t,this.y=e,this.z=n,this},e.setScalar=function(t){return this.x=t,this.y=t,this.z=t,this},e.setX=function(t){return this.x=t,this},e.setY=function(t){return this.y=t,this},e.setZ=function(t){return this.z=t,this},e.setComponent=function(t,e){switch(t){case 0:this.x=e;break;case 1:this.y=e;break;case 2:this.z=e;break;default:throw new Error("index is out of range: "+t)}return this},e.getComponent=function(t){switch(t){case 0:return this.x;case 1:return this.y;case 2:return this.z;default:throw new Error("index is out of range: "+t)}},e.clone=function(){return new this.constructor(this.x,this.y,this.z)},e.copy=function(t){return this.x=t.x,this.y=t.y,this.z=t.z,this},e.add=function(t,e){return void 0!==e?(console.warn("THREE.Vector3: .add() now only accepts one argument. Use .addVectors( a, b ) instead."),this.addVectors(t,e)):(this.x+=t.x,this.y+=t.y,this.z+=t.z,this)},e.addScalar=function(t){return this.x+=t,this.y+=t,this.z+=t,this},e.addVectors=function(t,e){return this.x=t.x+e.x,this.y=t.y+e.y,this.z=t.z+e.z,this},e.addScaledVector=function(t,e){return this.x+=t.x*e,this.y+=t.y*e,this.z+=t.z*e,this},e.sub=function(t,e){return void 0!==e?(console.warn("THREE.Vector3: .sub() now only accepts one argument. Use .subVectors( a, b ) instead."),this.subVectors(t,e)):(this.x-=t.x,this.y-=t.y,this.z-=t.z,this)},e.subScalar=function(t){return this.x-=t,this.y-=t,this.z-=t,this},e.subVectors=function(t,e){return this.x=t.x-e.x,this.y=t.y-e.y,this.z=t.z-e.z,this},e.multiply=function(t,e){return void 0!==e?(console.warn("THREE.Vector3: .multiply() now only accepts one argument. Use .multiplyVectors( a, b ) instead."),this.multiplyVectors(t,e)):(this.x*=t.x,this.y*=t.y,this.z*=t.z,this)},e.multiplyScalar=function(t){return this.x*=t,this.y*=t,this.z*=t,this},e.multiplyVectors=function(t,e){return this.x=t.x*e.x,this.y=t.y*e.y,this.z=t.z*e.z,this},e.applyEuler=function(t){return t&&t.isEuler||console.error("THREE.Vector3: .applyEuler() now expects an Euler rotation rather than a Vector3 and order."),this.applyQuaternion(St.setFromEuler(t))},e.applyAxisAngle=function(t,e){return this.applyQuaternion(St.setFromAxisAngle(t,e))},e.applyMatrix3=function(t){var e=this.x,n=this.y,r=this.z,i=t.elements;return this.x=i[0]*e+i[3]*n+i[6]*r,this.y=i[1]*e+i[4]*n+i[7]*r,this.z=i[2]*e+i[5]*n+i[8]*r,this},e.applyNormalMatrix=function(t){return this.applyMatrix3(t).normalize()},e.applyMatrix4=function(t){var e=this.x,n=this.y,r=this.z,i=t.elements,a=1/(i[3]*e+i[7]*n+i[11]*r+i[15]);return this.x=(i[0]*e+i[4]*n+i[8]*r+i[12])*a,this.y=(i[1]*e+i[5]*n+i[9]*r+i[13])*a,this.z=(i[2]*e+i[6]*n+i[10]*r+i[14])*a,this},e.applyQuaternion=function(t){var e=this.x,n=this.y,r=this.z,i=t.x,a=t.y,o=t.z,s=t.w,c=s*e+a*r-o*n,l=s*n+o*e-i*r,u=s*r+i*n-a*e,h=-i*e-a*n-o*r;return this.x=c*s+h*-i+l*-o-u*-a,this.y=l*s+h*-a+u*-i-c*-o,this.z=u*s+h*-o+c*-a-l*-i,this},e.project=function(t){return this.applyMatrix4(t.matrixWorldInverse).applyMatrix4(t.projectionMatrix)},e.unproject=function(t){return this.applyMatrix4(t.projectionMatrixInverse).applyMatrix4(t.matrixWorld)},e.transformDirection=function(t){var e=this.x,n=this.y,r=this.z,i=t.elements;return this.x=i[0]*e+i[4]*n+i[8]*r,this.y=i[1]*e+i[5]*n+i[9]*r,this.z=i[2]*e+i[6]*n+i[10]*r,this.normalize()},e.divide=function(t){return this.x/=t.x,this.y/=t.y,this.z/=t.z,this},e.divideScalar=function(t){return this.multiplyScalar(1/t)},e.min=function(t){return this.x=Math.min(this.x,t.x),this.y=Math.min(this.y,t.y),this.z=Math.min(this.z,t.z),this},e.max=function(t){return this.x=Math.max(this.x,t.x),this.y=Math.max(this.y,t.y),this.z=Math.max(this.z,t.z),this},e.clamp=function(t,e){return this.x=Math.max(t.x,Math.min(e.x,this.x)),this.y=Math.max(t.y,Math.min(e.y,this.y)),this.z=Math.max(t.z,Math.min(e.z,this.z)),this},e.clampScalar=function(t,e){return this.x=Math.max(t,Math.min(e,this.x)),this.y=Math.max(t,Math.min(e,this.y)),this.z=Math.max(t,Math.min(e,this.z)),this},e.clampLength=function(t,e){var n=this.length();return this.divideScalar(n||1).multiplyScalar(Math.max(t,Math.min(e,n)))},e.floor=function(){return this.x=Math.floor(this.x),this.y=Math.floor(this.y),this.z=Math.floor(this.z),this},e.ceil=function(){return this.x=Math.ceil(this.x),this.y=Math.ceil(this.y),this.z=Math.ceil(this.z),this},e.round=function(){return this.x=Math.round(this.x),this.y=Math.round(this.y),this.z=Math.round(this.z),this},e.roundToZero=function(){return this.x=this.x<0?Math.ceil(this.x):Math.floor(this.x),this.y=this.y<0?Math.ceil(this.y):Math.floor(this.y),this.z=this.z<0?Math.ceil(this.z):Math.floor(this.z),this},e.negate=function(){return this.x=-this.x,this.y=-this.y,this.z=-this.z,this},e.dot=function(t){return this.x*t.x+this.y*t.y+this.z*t.z},e.lengthSq=function(){return this.x*this.x+this.y*this.y+this.z*this.z},e.length=function(){return Math.sqrt(this.x*this.x+this.y*this.y+this.z*this.z)},e.manhattanLength=function(){return Math.abs(this.x)+Math.abs(this.y)+Math.abs(this.z)},e.normalize=function(){return this.divideScalar(this.length()||1)},e.setLength=function(t){return this.normalize().multiplyScalar(t)},e.lerp=function(t,e){return this.x+=(t.x-this.x)*e,this.y+=(t.y-this.y)*e,this.z+=(t.z-this.z)*e,this},e.lerpVectors=function(t,e,n){return this.x=t.x+(e.x-t.x)*n,this.y=t.y+(e.y-t.y)*n,this.z=t.z+(e.z-t.z)*n,this},e.cross=function(t,e){return void 0!==e?(console.warn("THREE.Vector3: .cross() now only accepts one argument. Use .crossVectors( a, b ) instead."),this.crossVectors(t,e)):this.crossVectors(this,t)},e.crossVectors=function(t,e){var n=t.x,r=t.y,i=t.z,a=e.x,o=e.y,s=e.z;return this.x=r*s-i*o,this.y=i*a-n*s,this.z=n*o-r*a,this},e.projectOnVector=function(t){var e=t.lengthSq();if(0===e)return this.set(0,0,0);var n=t.dot(this)/e;return this.copy(t).multiplyScalar(n)},e.projectOnPlane=function(t){return Mt.copy(this).projectOnVector(t),this.sub(Mt)},e.reflect=function(t){return this.sub(Mt.copy(t).multiplyScalar(2*this.dot(t)))},e.angleTo=function(t){var e=Math.sqrt(this.lengthSq()*t.lengthSq());if(0===e)return Math.PI/2;var n=this.dot(t)/e;return Math.acos(st.clamp(n,-1,1))},e.distanceTo=function(t){return Math.sqrt(this.distanceToSquared(t))},e.distanceToSquared=function(t){var e=this.x-t.x,n=this.y-t.y,r=this.z-t.z;return e*e+n*n+r*r},e.manhattanDistanceTo=function(t){return Math.abs(this.x-t.x)+Math.abs(this.y-t.y)+Math.abs(this.z-t.z)},e.setFromSpherical=function(t){return this.setFromSphericalCoords(t.radius,t.phi,t.theta)},e.setFromSphericalCoords=function(t,e,n){var r=Math.sin(e)*t;return this.x=r*Math.sin(n),this.y=Math.cos(e)*t,this.z=r*Math.cos(n),this},e.setFromCylindrical=function(t){return this.setFromCylindricalCoords(t.radius,t.theta,t.y)},e.setFromCylindricalCoords=function(t,e,n){return this.x=t*Math.sin(e),this.y=n,this.z=t*Math.cos(e),this},e.setFromMatrixPosition=function(t){var e=t.elements;return this.x=e[12],this.y=e[13],this.z=e[14],this},e.setFromMatrixScale=function(t){var e=this.setFromMatrixColumn(t,0).length(),n=this.setFromMatrixColumn(t,1).length(),r=this.setFromMatrixColumn(t,2).length();return this.x=e,this.y=n,this.z=r,this},e.setFromMatrixColumn=function(t,e){return this.fromArray(t.elements,4*e)},e.setFromMatrix3Column=function(t,e){return this.fromArray(t.elements,3*e)},e.equals=function(t){return t.x===this.x&&t.y===this.y&&t.z===this.z},e.fromArray=function(t,e){return void 0===e&&(e=0),this.x=t[e],this.y=t[e+1],this.z=t[e+2],this},e.toArray=function(t,e){return void 0===t&&(t=[]),void 0===e&&(e=0),t[e]=this.x,t[e+1]=this.y,t[e+2]=this.z,t},e.fromBufferAttribute=function(t,e,n){return void 0!==n&&console.warn("THREE.Vector3: offset has been removed from .fromBufferAttribute()."),this.x=t.getX(e),this.y=t.getY(e),this.z=t.getZ(e),this},e.random=function(){return this.x=Math.random(),this.y=Math.random(),this.z=Math.random(),this},t}(),Mt=new wt,St=new bt,Tt=function(){function t(t,e){Object.defineProperty(this,"isBox3",{value:!0}),this.min=void 0!==t?t:new wt(1/0,1/0,1/0),this.max=void 0!==e?e:new wt(-1/0,-1/0,-1/0)}var e=t.prototype;return e.set=function(t,e){return this.min.copy(t),this.max.copy(e),this},e.setFromArray=function(t){for(var e=1/0,n=1/0,r=1/0,i=-1/0,a=-1/0,o=-1/0,s=0,c=t.length;si&&(i=l),u>a&&(a=u),h>o&&(o=h)}return this.min.set(e,n,r),this.max.set(i,a,o),this},e.setFromBufferAttribute=function(t){for(var e=1/0,n=1/0,r=1/0,i=-1/0,a=-1/0,o=-1/0,s=0,c=t.count;si&&(i=l),u>a&&(a=u),h>o&&(o=h)}return this.min.set(e,n,r),this.max.set(i,a,o),this},e.setFromPoints=function(t){this.makeEmpty();for(var e=0,n=t.length;ethis.max.x||t.ythis.max.y||t.zthis.max.z)},e.containsBox=function(t){return this.min.x<=t.min.x&&t.max.x<=this.max.x&&this.min.y<=t.min.y&&t.max.y<=this.max.y&&this.min.z<=t.min.z&&t.max.z<=this.max.z},e.getParameter=function(t,e){return void 0===e&&(console.warn("THREE.Box3: .getParameter() target is now required"),e=new wt),e.set((t.x-this.min.x)/(this.max.x-this.min.x),(t.y-this.min.y)/(this.max.y-this.min.y),(t.z-this.min.z)/(this.max.z-this.min.z))},e.intersectsBox=function(t){return!(t.max.xthis.max.x||t.max.ythis.max.y||t.max.zthis.max.z)},e.intersectsSphere=function(t){return this.clampPoint(t.center,Lt),Lt.distanceToSquared(t.center)<=t.radius*t.radius},e.intersectsPlane=function(t){var e,n;return t.normal.x>0?(e=t.normal.x*this.min.x,n=t.normal.x*this.max.x):(e=t.normal.x*this.max.x,n=t.normal.x*this.min.x),t.normal.y>0?(e+=t.normal.y*this.min.y,n+=t.normal.y*this.max.y):(e+=t.normal.y*this.max.y,n+=t.normal.y*this.min.y),t.normal.z>0?(e+=t.normal.z*this.min.z,n+=t.normal.z*this.max.z):(e+=t.normal.z*this.max.z,n+=t.normal.z*this.min.z),e<=-t.constant&&n>=-t.constant},e.intersectsTriangle=function(t){if(this.isEmpty())return!1;this.getCenter(Bt),zt.subVectors(this.max,Bt),Ct.subVectors(t.a,Bt),Pt.subVectors(t.b,Bt),It.subVectors(t.c,Bt),Dt.subVectors(Pt,Ct),Nt.subVectors(It,Pt),Ot.subVectors(Ct,It);var e=[0,-Dt.z,Dt.y,0,-Nt.z,Nt.y,0,-Ot.z,Ot.y,Dt.z,0,-Dt.x,Nt.z,0,-Nt.x,Ot.z,0,-Ot.x,-Dt.y,Dt.x,0,-Nt.y,Nt.x,0,-Ot.y,Ot.x,0];return!!Et(e,Ct,Pt,It,zt)&&(!!Et(e=[1,0,0,0,1,0,0,0,1],Ct,Pt,It,zt)&&(Gt.crossVectors(Dt,Nt),Et(e=[Gt.x,Gt.y,Gt.z],Ct,Pt,It,zt)))},e.clampPoint=function(t,e){return void 0===e&&(console.warn("THREE.Box3: .clampPoint() target is now required"),e=new wt),e.copy(t).clamp(this.min,this.max)},e.distanceToPoint=function(t){return Lt.copy(t).clamp(this.min,this.max).sub(t).length()},e.getBoundingSphere=function(t){return void 0===t&&console.error("THREE.Box3: .getBoundingSphere() target is now required"),this.getCenter(t.center),t.radius=.5*this.getSize(Lt).length(),t},e.intersect=function(t){return this.min.max(t.min),this.max.min(t.max),this.isEmpty()&&this.makeEmpty(),this},e.union=function(t){return this.min.min(t.min),this.max.max(t.max),this},e.applyMatrix4=function(t){return this.isEmpty()||(At[0].set(this.min.x,this.min.y,this.min.z).applyMatrix4(t),At[1].set(this.min.x,this.min.y,this.max.z).applyMatrix4(t),At[2].set(this.min.x,this.max.y,this.min.z).applyMatrix4(t),At[3].set(this.min.x,this.max.y,this.max.z).applyMatrix4(t),At[4].set(this.max.x,this.min.y,this.min.z).applyMatrix4(t),At[5].set(this.max.x,this.min.y,this.max.z).applyMatrix4(t),At[6].set(this.max.x,this.max.y,this.min.z).applyMatrix4(t),At[7].set(this.max.x,this.max.y,this.max.z).applyMatrix4(t),this.setFromPoints(At)),this},e.translate=function(t){return this.min.add(t),this.max.add(t),this},e.equals=function(t){return t.min.equals(this.min)&&t.max.equals(this.max)},t}();function Et(t,e,n,r,i){for(var a=0,o=t.length-3;a<=o;a+=3){Ft.fromArray(t,a);var s=i.x*Math.abs(Ft.x)+i.y*Math.abs(Ft.y)+i.z*Math.abs(Ft.z),c=e.dot(Ft),l=n.dot(Ft),u=r.dot(Ft);if(Math.max(-Math.max(c,l,u),Math.min(c,l,u))>s)return!1}return!0}var At=[new wt,new wt,new wt,new wt,new wt,new wt,new wt,new wt],Lt=new wt,Rt=new Tt,Ct=new wt,Pt=new wt,It=new wt,Dt=new wt,Nt=new wt,Ot=new wt,Bt=new wt,zt=new wt,Gt=new wt,Ft=new wt,Ut=new Tt,Ht=function(){function t(t,e){this.center=void 0!==t?t:new wt,this.radius=void 0!==e?e:-1}var e=t.prototype;return e.set=function(t,e){return this.center.copy(t),this.radius=e,this},e.setFromPoints=function(t,e){var n=this.center;void 0!==e?n.copy(e):Ut.setFromPoints(t).getCenter(n);for(var r=0,i=0,a=t.length;ithis.radius*this.radius&&(e.sub(this.center).normalize(),e.multiplyScalar(this.radius).add(this.center)),e},e.getBoundingBox=function(t){return void 0===t&&(console.warn("THREE.Sphere: .getBoundingBox() target is now required"),t=new Tt),this.isEmpty()?(t.makeEmpty(),t):(t.set(this.center,this.center),t.expandByScalar(this.radius),t)},e.applyMatrix4=function(t){return this.center.applyMatrix4(t),this.radius=this.radius*t.getMaxScaleOnAxis(),this},e.translate=function(t){return this.center.add(t),this},e.equals=function(t){return t.center.equals(this.center)&&t.radius===this.radius},t}(),kt=new wt,Vt=new wt,Wt=new wt,jt=new wt,qt=new wt,Xt=new wt,Yt=new wt,Zt=function(){function t(t,e){this.origin=void 0!==t?t:new wt,this.direction=void 0!==e?e:new wt(0,0,-1)}var e=t.prototype;return e.set=function(t,e){return this.origin.copy(t),this.direction.copy(e),this},e.clone=function(){return(new this.constructor).copy(this)},e.copy=function(t){return this.origin.copy(t.origin),this.direction.copy(t.direction),this},e.at=function(t,e){return void 0===e&&(console.warn("THREE.Ray: .at() target is now required"),e=new wt),e.copy(this.direction).multiplyScalar(t).add(this.origin)},e.lookAt=function(t){return this.direction.copy(t).sub(this.origin).normalize(),this},e.recast=function(t){return this.origin.copy(this.at(t,kt)),this},e.closestPointToPoint=function(t,e){void 0===e&&(console.warn("THREE.Ray: .closestPointToPoint() target is now required"),e=new wt),e.subVectors(t,this.origin);var n=e.dot(this.direction);return n<0?e.copy(this.origin):e.copy(this.direction).multiplyScalar(n).add(this.origin)},e.distanceToPoint=function(t){return Math.sqrt(this.distanceSqToPoint(t))},e.distanceSqToPoint=function(t){var e=kt.subVectors(t,this.origin).dot(this.direction);return e<0?this.origin.distanceToSquared(t):(kt.copy(this.direction).multiplyScalar(e).add(this.origin),kt.distanceToSquared(t))},e.distanceSqToSegment=function(t,e,n,r){Vt.copy(t).add(e).multiplyScalar(.5),Wt.copy(e).sub(t).normalize(),jt.copy(this.origin).sub(Vt);var i,a,o,s,c=.5*t.distanceTo(e),l=-this.direction.dot(Wt),u=jt.dot(this.direction),h=-jt.dot(Wt),d=jt.lengthSq(),p=Math.abs(1-l*l);if(p>0)if(a=l*u-h,s=c*p,(i=l*h-u)>=0)if(a>=-s)if(a<=s){var f=1/p;o=(i*=f)*(i+l*(a*=f)+2*u)+a*(l*i+a+2*h)+d}else a=c,o=-(i=Math.max(0,-(l*a+u)))*i+a*(a+2*h)+d;else a=-c,o=-(i=Math.max(0,-(l*a+u)))*i+a*(a+2*h)+d;else a<=-s?o=-(i=Math.max(0,-(-l*c+u)))*i+(a=i>0?-c:Math.min(Math.max(-c,-h),c))*(a+2*h)+d:a<=s?(i=0,o=(a=Math.min(Math.max(-c,-h),c))*(a+2*h)+d):o=-(i=Math.max(0,-(l*c+u)))*i+(a=i>0?c:Math.min(Math.max(-c,-h),c))*(a+2*h)+d;else a=l>0?-c:c,o=-(i=Math.max(0,-(l*a+u)))*i+a*(a+2*h)+d;return n&&n.copy(this.direction).multiplyScalar(i).add(this.origin),r&&r.copy(Wt).multiplyScalar(a).add(Vt),o},e.intersectSphere=function(t,e){kt.subVectors(t.center,this.origin);var n=kt.dot(this.direction),r=kt.dot(kt)-n*n,i=t.radius*t.radius;if(r>i)return null;var a=Math.sqrt(i-r),o=n-a,s=n+a;return o<0&&s<0?null:o<0?this.at(s,e):this.at(o,e)},e.intersectsSphere=function(t){return this.distanceSqToPoint(t.center)<=t.radius*t.radius},e.distanceToPlane=function(t){var e=t.normal.dot(this.direction);if(0===e)return 0===t.distanceToPoint(this.origin)?0:null;var n=-(this.origin.dot(t.normal)+t.constant)/e;return n>=0?n:null},e.intersectPlane=function(t,e){var n=this.distanceToPlane(t);return null===n?null:this.at(n,e)},e.intersectsPlane=function(t){var e=t.distanceToPoint(this.origin);return 0===e||t.normal.dot(this.direction)*e<0},e.intersectBox=function(t,e){var n,r,i,a,o,s,c=1/this.direction.x,l=1/this.direction.y,u=1/this.direction.z,h=this.origin;return c>=0?(n=(t.min.x-h.x)*c,r=(t.max.x-h.x)*c):(n=(t.max.x-h.x)*c,r=(t.min.x-h.x)*c),l>=0?(i=(t.min.y-h.y)*l,a=(t.max.y-h.y)*l):(i=(t.max.y-h.y)*l,a=(t.min.y-h.y)*l),n>a||i>r?null:((i>n||n!=n)&&(n=i),(a=0?(o=(t.min.z-h.z)*u,s=(t.max.z-h.z)*u):(o=(t.max.z-h.z)*u,s=(t.min.z-h.z)*u),n>s||o>r?null:((o>n||n!=n)&&(n=o),(s=0?n:r,e)))},e.intersectsBox=function(t){return null!==this.intersectBox(t,kt)},e.intersectTriangle=function(t,e,n,r,i){qt.subVectors(e,t),Xt.subVectors(n,t),Yt.crossVectors(qt,Xt);var a,o=this.direction.dot(Yt);if(o>0){if(r)return null;a=1}else{if(!(o<0))return null;a=-1,o=-o}jt.subVectors(this.origin,t);var s=a*this.direction.dot(Xt.crossVectors(jt,Xt));if(s<0)return null;var c=a*this.direction.dot(qt.cross(jt));if(c<0)return null;if(s+c>o)return null;var l=-a*jt.dot(Yt);return l<0?null:this.at(l/o,i)},e.applyMatrix4=function(t){return this.origin.applyMatrix4(t),this.direction.transformDirection(t),this},e.equals=function(t){return t.origin.equals(this.origin)&&t.direction.equals(this.direction)},t}(),Jt=function(){function t(){Object.defineProperty(this,"isMatrix4",{value:!0}),this.elements=[1,0,0,0,0,1,0,0,0,0,1,0,0,0,0,1],arguments.length>0&&console.error("THREE.Matrix4: the constructor no longer reads arguments. use .set() instead.")}var e=t.prototype;return e.set=function(t,e,n,r,i,a,o,s,c,l,u,h,d,p,f,m){var v=this.elements;return v[0]=t,v[4]=e,v[8]=n,v[12]=r,v[1]=i,v[5]=a,v[9]=o,v[13]=s,v[2]=c,v[6]=l,v[10]=u,v[14]=h,v[3]=d,v[7]=p,v[11]=f,v[15]=m,this},e.identity=function(){return this.set(1,0,0,0,0,1,0,0,0,0,1,0,0,0,0,1),this},e.clone=function(){return(new t).fromArray(this.elements)},e.copy=function(t){var e=this.elements,n=t.elements;return e[0]=n[0],e[1]=n[1],e[2]=n[2],e[3]=n[3],e[4]=n[4],e[5]=n[5],e[6]=n[6],e[7]=n[7],e[8]=n[8],e[9]=n[9],e[10]=n[10],e[11]=n[11],e[12]=n[12],e[13]=n[13],e[14]=n[14],e[15]=n[15],this},e.copyPosition=function(t){var e=this.elements,n=t.elements;return e[12]=n[12],e[13]=n[13],e[14]=n[14],this},e.extractBasis=function(t,e,n){return t.setFromMatrixColumn(this,0),e.setFromMatrixColumn(this,1),n.setFromMatrixColumn(this,2),this},e.makeBasis=function(t,e,n){return this.set(t.x,e.x,n.x,0,t.y,e.y,n.y,0,t.z,e.z,n.z,0,0,0,0,1),this},e.extractRotation=function(t){var e=this.elements,n=t.elements,r=1/Qt.setFromMatrixColumn(t,0).length(),i=1/Qt.setFromMatrixColumn(t,1).length(),a=1/Qt.setFromMatrixColumn(t,2).length();return e[0]=n[0]*r,e[1]=n[1]*r,e[2]=n[2]*r,e[3]=0,e[4]=n[4]*i,e[5]=n[5]*i,e[6]=n[6]*i,e[7]=0,e[8]=n[8]*a,e[9]=n[9]*a,e[10]=n[10]*a,e[11]=0,e[12]=0,e[13]=0,e[14]=0,e[15]=1,this},e.makeRotationFromEuler=function(t){t&&t.isEuler||console.error("THREE.Matrix4: .makeRotationFromEuler() now expects a Euler rotation rather than a Vector3 and order.");var e=this.elements,n=t.x,r=t.y,i=t.z,a=Math.cos(n),o=Math.sin(n),s=Math.cos(r),c=Math.sin(r),l=Math.cos(i),u=Math.sin(i);if("XYZ"===t.order){var h=a*l,d=a*u,p=o*l,f=o*u;e[0]=s*l,e[4]=-s*u,e[8]=c,e[1]=d+p*c,e[5]=h-f*c,e[9]=-o*s,e[2]=f-h*c,e[6]=p+d*c,e[10]=a*s}else if("YXZ"===t.order){var m=s*l,v=s*u,g=c*l,y=c*u;e[0]=m+y*o,e[4]=g*o-v,e[8]=a*c,e[1]=a*u,e[5]=a*l,e[9]=-o,e[2]=v*o-g,e[6]=y+m*o,e[10]=a*s}else if("ZXY"===t.order){var x=s*l,_=s*u,b=c*l,w=c*u;e[0]=x-w*o,e[4]=-a*u,e[8]=b+_*o,e[1]=_+b*o,e[5]=a*l,e[9]=w-x*o,e[2]=-a*c,e[6]=o,e[10]=a*s}else if("ZYX"===t.order){var M=a*l,S=a*u,T=o*l,E=o*u;e[0]=s*l,e[4]=T*c-S,e[8]=M*c+E,e[1]=s*u,e[5]=E*c+M,e[9]=S*c-T,e[2]=-c,e[6]=o*s,e[10]=a*s}else if("YZX"===t.order){var A=a*s,L=a*c,R=o*s,C=o*c;e[0]=s*l,e[4]=C-A*u,e[8]=R*u+L,e[1]=u,e[5]=a*l,e[9]=-o*l,e[2]=-c*l,e[6]=L*u+R,e[10]=A-C*u}else if("XZY"===t.order){var P=a*s,I=a*c,D=o*s,N=o*c;e[0]=s*l,e[4]=-u,e[8]=c*l,e[1]=P*u+N,e[5]=a*l,e[9]=I*u-D,e[2]=D*u-I,e[6]=o*l,e[10]=N*u+P}return e[3]=0,e[7]=0,e[11]=0,e[12]=0,e[13]=0,e[14]=0,e[15]=1,this},e.makeRotationFromQuaternion=function(t){return this.compose($t,t,te)},e.lookAt=function(t,e,n){var r=this.elements;return re.subVectors(t,e),0===re.lengthSq()&&(re.z=1),re.normalize(),ee.crossVectors(n,re),0===ee.lengthSq()&&(1===Math.abs(n.z)?re.x+=1e-4:re.z+=1e-4,re.normalize(),ee.crossVectors(n,re)),ee.normalize(),ne.crossVectors(re,ee),r[0]=ee.x,r[4]=ne.x,r[8]=re.x,r[1]=ee.y,r[5]=ne.y,r[9]=re.y,r[2]=ee.z,r[6]=ne.z,r[10]=re.z,this},e.multiply=function(t,e){return void 0!==e?(console.warn("THREE.Matrix4: .multiply() now only accepts one argument. Use .multiplyMatrices( a, b ) instead."),this.multiplyMatrices(t,e)):this.multiplyMatrices(this,t)},e.premultiply=function(t){return this.multiplyMatrices(t,this)},e.multiplyMatrices=function(t,e){var n=t.elements,r=e.elements,i=this.elements,a=n[0],o=n[4],s=n[8],c=n[12],l=n[1],u=n[5],h=n[9],d=n[13],p=n[2],f=n[6],m=n[10],v=n[14],g=n[3],y=n[7],x=n[11],_=n[15],b=r[0],w=r[4],M=r[8],S=r[12],T=r[1],E=r[5],A=r[9],L=r[13],R=r[2],C=r[6],P=r[10],I=r[14],D=r[3],N=r[7],O=r[11],B=r[15];return i[0]=a*b+o*T+s*R+c*D,i[4]=a*w+o*E+s*C+c*N,i[8]=a*M+o*A+s*P+c*O,i[12]=a*S+o*L+s*I+c*B,i[1]=l*b+u*T+h*R+d*D,i[5]=l*w+u*E+h*C+d*N,i[9]=l*M+u*A+h*P+d*O,i[13]=l*S+u*L+h*I+d*B,i[2]=p*b+f*T+m*R+v*D,i[6]=p*w+f*E+m*C+v*N,i[10]=p*M+f*A+m*P+v*O,i[14]=p*S+f*L+m*I+v*B,i[3]=g*b+y*T+x*R+_*D,i[7]=g*w+y*E+x*C+_*N,i[11]=g*M+y*A+x*P+_*O,i[15]=g*S+y*L+x*I+_*B,this},e.multiplyScalar=function(t){var e=this.elements;return e[0]*=t,e[4]*=t,e[8]*=t,e[12]*=t,e[1]*=t,e[5]*=t,e[9]*=t,e[13]*=t,e[2]*=t,e[6]*=t,e[10]*=t,e[14]*=t,e[3]*=t,e[7]*=t,e[11]*=t,e[15]*=t,this},e.determinant=function(){var t=this.elements,e=t[0],n=t[4],r=t[8],i=t[12],a=t[1],o=t[5],s=t[9],c=t[13],l=t[2],u=t[6],h=t[10],d=t[14];return t[3]*(+i*s*u-r*c*u-i*o*h+n*c*h+r*o*d-n*s*d)+t[7]*(+e*s*d-e*c*h+i*a*h-r*a*d+r*c*l-i*s*l)+t[11]*(+e*c*u-e*o*d-i*a*u+n*a*d+i*o*l-n*c*l)+t[15]*(-r*o*l-e*s*u+e*o*h+r*a*u-n*a*h+n*s*l)},e.transpose=function(){var t,e=this.elements;return t=e[1],e[1]=e[4],e[4]=t,t=e[2],e[2]=e[8],e[8]=t,t=e[6],e[6]=e[9],e[9]=t,t=e[3],e[3]=e[12],e[12]=t,t=e[7],e[7]=e[13],e[13]=t,t=e[11],e[11]=e[14],e[14]=t,this},e.setPosition=function(t,e,n){var r=this.elements;return t.isVector3?(r[12]=t.x,r[13]=t.y,r[14]=t.z):(r[12]=t,r[13]=e,r[14]=n),this},e.getInverse=function(t,e){void 0!==e&&console.warn("THREE.Matrix4: .getInverse() can no longer be configured to throw on degenerate.");var n=this.elements,r=t.elements,i=r[0],a=r[1],o=r[2],s=r[3],c=r[4],l=r[5],u=r[6],h=r[7],d=r[8],p=r[9],f=r[10],m=r[11],v=r[12],g=r[13],y=r[14],x=r[15],_=p*y*h-g*f*h+g*u*m-l*y*m-p*u*x+l*f*x,b=v*f*h-d*y*h-v*u*m+c*y*m+d*u*x-c*f*x,w=d*g*h-v*p*h+v*l*m-c*g*m-d*l*x+c*p*x,M=v*p*u-d*g*u-v*l*f+c*g*f+d*l*y-c*p*y,S=i*_+a*b+o*w+s*M;if(0===S)return this.set(0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0);var T=1/S;return n[0]=_*T,n[1]=(g*f*s-p*y*s-g*o*m+a*y*m+p*o*x-a*f*x)*T,n[2]=(l*y*s-g*u*s+g*o*h-a*y*h-l*o*x+a*u*x)*T,n[3]=(p*u*s-l*f*s-p*o*h+a*f*h+l*o*m-a*u*m)*T,n[4]=b*T,n[5]=(d*y*s-v*f*s+v*o*m-i*y*m-d*o*x+i*f*x)*T,n[6]=(v*u*s-c*y*s-v*o*h+i*y*h+c*o*x-i*u*x)*T,n[7]=(c*f*s-d*u*s+d*o*h-i*f*h-c*o*m+i*u*m)*T,n[8]=w*T,n[9]=(v*p*s-d*g*s-v*a*m+i*g*m+d*a*x-i*p*x)*T,n[10]=(c*g*s-v*l*s+v*a*h-i*g*h-c*a*x+i*l*x)*T,n[11]=(d*l*s-c*p*s-d*a*h+i*p*h+c*a*m-i*l*m)*T,n[12]=M*T,n[13]=(d*g*o-v*p*o+v*a*f-i*g*f-d*a*y+i*p*y)*T,n[14]=(v*l*o-c*g*o-v*a*u+i*g*u+c*a*y-i*l*y)*T,n[15]=(c*p*o-d*l*o+d*a*u-i*p*u-c*a*f+i*l*f)*T,this},e.scale=function(t){var e=this.elements,n=t.x,r=t.y,i=t.z;return e[0]*=n,e[4]*=r,e[8]*=i,e[1]*=n,e[5]*=r,e[9]*=i,e[2]*=n,e[6]*=r,e[10]*=i,e[3]*=n,e[7]*=r,e[11]*=i,this},e.getMaxScaleOnAxis=function(){var t=this.elements,e=t[0]*t[0]+t[1]*t[1]+t[2]*t[2],n=t[4]*t[4]+t[5]*t[5]+t[6]*t[6],r=t[8]*t[8]+t[9]*t[9]+t[10]*t[10];return Math.sqrt(Math.max(e,n,r))},e.makeTranslation=function(t,e,n){return this.set(1,0,0,t,0,1,0,e,0,0,1,n,0,0,0,1),this},e.makeRotationX=function(t){var e=Math.cos(t),n=Math.sin(t);return this.set(1,0,0,0,0,e,-n,0,0,n,e,0,0,0,0,1),this},e.makeRotationY=function(t){var e=Math.cos(t),n=Math.sin(t);return this.set(e,0,n,0,0,1,0,0,-n,0,e,0,0,0,0,1),this},e.makeRotationZ=function(t){var e=Math.cos(t),n=Math.sin(t);return this.set(e,-n,0,0,n,e,0,0,0,0,1,0,0,0,0,1),this},e.makeRotationAxis=function(t,e){var n=Math.cos(e),r=Math.sin(e),i=1-n,a=t.x,o=t.y,s=t.z,c=i*a,l=i*o;return this.set(c*a+n,c*o-r*s,c*s+r*o,0,c*o+r*s,l*o+n,l*s-r*a,0,c*s-r*o,l*s+r*a,i*s*s+n,0,0,0,0,1),this},e.makeScale=function(t,e,n){return this.set(t,0,0,0,0,e,0,0,0,0,n,0,0,0,0,1),this},e.makeShear=function(t,e,n){return this.set(1,e,n,0,t,1,n,0,t,e,1,0,0,0,0,1),this},e.compose=function(t,e,n){var r=this.elements,i=e._x,a=e._y,o=e._z,s=e._w,c=i+i,l=a+a,u=o+o,h=i*c,d=i*l,p=i*u,f=a*l,m=a*u,v=o*u,g=s*c,y=s*l,x=s*u,_=n.x,b=n.y,w=n.z;return r[0]=(1-(f+v))*_,r[1]=(d+x)*_,r[2]=(p-y)*_,r[3]=0,r[4]=(d-x)*b,r[5]=(1-(h+v))*b,r[6]=(m+g)*b,r[7]=0,r[8]=(p+y)*w,r[9]=(m-g)*w,r[10]=(1-(h+f))*w,r[11]=0,r[12]=t.x,r[13]=t.y,r[14]=t.z,r[15]=1,this},e.decompose=function(t,e,n){var r=this.elements,i=Qt.set(r[0],r[1],r[2]).length(),a=Qt.set(r[4],r[5],r[6]).length(),o=Qt.set(r[8],r[9],r[10]).length();this.determinant()<0&&(i=-i),t.x=r[12],t.y=r[13],t.z=r[14],Kt.copy(this);var s=1/i,c=1/a,l=1/o;return Kt.elements[0]*=s,Kt.elements[1]*=s,Kt.elements[2]*=s,Kt.elements[4]*=c,Kt.elements[5]*=c,Kt.elements[6]*=c,Kt.elements[8]*=l,Kt.elements[9]*=l,Kt.elements[10]*=l,e.setFromRotationMatrix(Kt),n.x=i,n.y=a,n.z=o,this},e.makePerspective=function(t,e,n,r,i,a){void 0===a&&console.warn("THREE.Matrix4: .makePerspective() has been redefined and has a new signature. Please check the docs.");var o=this.elements,s=2*i/(e-t),c=2*i/(n-r),l=(e+t)/(e-t),u=(n+r)/(n-r),h=-(a+i)/(a-i),d=-2*a*i/(a-i);return o[0]=s,o[4]=0,o[8]=l,o[12]=0,o[1]=0,o[5]=c,o[9]=u,o[13]=0,o[2]=0,o[6]=0,o[10]=h,o[14]=d,o[3]=0,o[7]=0,o[11]=-1,o[15]=0,this},e.makeOrthographic=function(t,e,n,r,i,a){var o=this.elements,s=1/(e-t),c=1/(n-r),l=1/(a-i),u=(e+t)*s,h=(n+r)*c,d=(a+i)*l;return o[0]=2*s,o[4]=0,o[8]=0,o[12]=-u,o[1]=0,o[5]=2*c,o[9]=0,o[13]=-h,o[2]=0,o[6]=0,o[10]=-2*l,o[14]=-d,o[3]=0,o[7]=0,o[11]=0,o[15]=1,this},e.equals=function(t){for(var e=this.elements,n=t.elements,r=0;r<16;r++)if(e[r]!==n[r])return!1;return!0},e.fromArray=function(t,e){void 0===e&&(e=0);for(var n=0;n<16;n++)this.elements[n]=t[n+e];return this},e.toArray=function(t,e){void 0===t&&(t=[]),void 0===e&&(e=0);var n=this.elements;return t[e]=n[0],t[e+1]=n[1],t[e+2]=n[2],t[e+3]=n[3],t[e+4]=n[4],t[e+5]=n[5],t[e+6]=n[6],t[e+7]=n[7],t[e+8]=n[8],t[e+9]=n[9],t[e+10]=n[10],t[e+11]=n[11],t[e+12]=n[12],t[e+13]=n[13],t[e+14]=n[14],t[e+15]=n[15],t},t}(),Qt=new wt,Kt=new Jt,$t=new wt(0,0,0),te=new wt(1,1,1),ee=new wt,ne=new wt,re=new wt,ie=function(){function t(e,n,r,i){void 0===e&&(e=0),void 0===n&&(n=0),void 0===r&&(r=0),void 0===i&&(i=t.DefaultOrder),Object.defineProperty(this,"isEuler",{value:!0}),this._x=e,this._y=n,this._z=r,this._order=i}var e=t.prototype;return e.set=function(t,e,n,r){return this._x=t,this._y=e,this._z=n,this._order=r||this._order,this._onChangeCallback(),this},e.clone=function(){return new this.constructor(this._x,this._y,this._z,this._order)},e.copy=function(t){return this._x=t._x,this._y=t._y,this._z=t._z,this._order=t._order,this._onChangeCallback(),this},e.setFromRotationMatrix=function(t,e,n){var r=st.clamp,i=t.elements,a=i[0],o=i[4],s=i[8],c=i[1],l=i[5],u=i[9],h=i[2],d=i[6],p=i[10];switch(e=e||this._order){case"XYZ":this._y=Math.asin(r(s,-1,1)),Math.abs(s)<.9999999?(this._x=Math.atan2(-u,p),this._z=Math.atan2(-o,a)):(this._x=Math.atan2(d,l),this._z=0);break;case"YXZ":this._x=Math.asin(-r(u,-1,1)),Math.abs(u)<.9999999?(this._y=Math.atan2(s,p),this._z=Math.atan2(c,l)):(this._y=Math.atan2(-h,a),this._z=0);break;case"ZXY":this._x=Math.asin(r(d,-1,1)),Math.abs(d)<.9999999?(this._y=Math.atan2(-h,p),this._z=Math.atan2(-o,l)):(this._y=0,this._z=Math.atan2(c,a));break;case"ZYX":this._y=Math.asin(-r(h,-1,1)),Math.abs(h)<.9999999?(this._x=Math.atan2(d,p),this._z=Math.atan2(c,a)):(this._x=0,this._z=Math.atan2(-o,l));break;case"YZX":this._z=Math.asin(r(c,-1,1)),Math.abs(c)<.9999999?(this._x=Math.atan2(-u,l),this._y=Math.atan2(-h,a)):(this._x=0,this._y=Math.atan2(s,p));break;case"XZY":this._z=Math.asin(-r(o,-1,1)),Math.abs(o)<.9999999?(this._x=Math.atan2(d,l),this._y=Math.atan2(s,a)):(this._x=Math.atan2(-u,p),this._y=0);break;default:console.warn("THREE.Euler: .setFromRotationMatrix() encountered an unknown order: "+e)}return this._order=e,!1!==n&&this._onChangeCallback(),this},e.setFromQuaternion=function(t,e,n){return ae.makeRotationFromQuaternion(t),this.setFromRotationMatrix(ae,e,n)},e.setFromVector3=function(t,e){return this.set(t.x,t.y,t.z,e||this._order)},e.reorder=function(t){return oe.setFromEuler(this),this.setFromQuaternion(oe,t)},e.equals=function(t){return t._x===this._x&&t._y===this._y&&t._z===this._z&&t._order===this._order},e.fromArray=function(t){return this._x=t[0],this._y=t[1],this._z=t[2],void 0!==t[3]&&(this._order=t[3]),this._onChangeCallback(),this},e.toArray=function(t,e){return void 0===t&&(t=[]),void 0===e&&(e=0),t[e]=this._x,t[e+1]=this._y,t[e+2]=this._z,t[e+3]=this._order,t},e.toVector3=function(t){return t?t.set(this._x,this._y,this._z):new wt(this._x,this._y,this._z)},e._onChange=function(t){return this._onChangeCallback=t,this},e._onChangeCallback=function(){},lt(t,[{key:"x",get:function(){return this._x},set:function(t){this._x=t,this._onChangeCallback()}},{key:"y",get:function(){return this._y},set:function(t){this._y=t,this._onChangeCallback()}},{key:"z",get:function(){return this._z},set:function(t){this._z=t,this._onChangeCallback()}},{key:"order",get:function(){return this._order},set:function(t){this._order=t,this._onChangeCallback()}}]),t}();ie.DefaultOrder="XYZ",ie.RotationOrders=["XYZ","YZX","ZXY","XZY","YXZ","ZYX"];var ae=new Jt,oe=new bt,se=function(){function t(){this.mask=1}var e=t.prototype;return e.set=function(t){this.mask=1<1){for(var e=0;e1){for(var e=0;e0){r.children=[];for(var p=0;p0&&(n.geometries=f),m.length>0&&(n.materials=m),v.length>0&&(n.textures=v),g.length>0&&(n.images=g),y.length>0&&(n.shapes=y)}return n.object=r,n;function x(t){var e=[];for(var n in t){var r=t[n];delete r.metadata,e.push(r)}return e}},clone:function(t){return(new this.constructor).copy(this,t)},copy:function(t,e){if(void 0===e&&(e=!0),this.name=t.name,this.up.copy(t.up),this.position.copy(t.position),this.rotation.order=t.rotation.order,this.quaternion.copy(t.quaternion),this.scale.copy(t.scale),this.matrix.copy(t.matrix),this.matrixWorld.copy(t.matrixWorld),this.matrixAutoUpdate=t.matrixAutoUpdate,this.matrixWorldNeedsUpdate=t.matrixWorldNeedsUpdate,this.layers.mask=t.layers.mask,this.visible=t.visible,this.castShadow=t.castShadow,this.receiveShadow=t.receiveShadow,this.frustumCulled=t.frustumCulled,this.renderOrder=t.renderOrder,this.userData=JSON.parse(JSON.stringify(t.userData)),!0===e)for(var n=0;n1?void 0:e.copy(n).multiplyScalar(i).add(t.start)},e.intersectsLine=function(t){var e=this.distanceToPoint(t.start),n=this.distanceToPoint(t.end);return e<0&&n>0||n<0&&e>0},e.intersectsBox=function(t){return t.intersectsPlane(this)},e.intersectsSphere=function(t){return t.intersectsPlane(this)},e.coplanarPoint=function(t){return void 0===t&&(console.warn("THREE.Plane: .coplanarPoint() target is now required"),t=new wt),t.copy(this.normal).multiplyScalar(-this.constant)},e.applyMatrix4=function(t,e){var n=e||Se.getNormalMatrix(t),r=this.coplanarPoint(we).applyMatrix4(t),i=this.normal.applyMatrix3(n).normalize();return this.constant=-r.dot(i),this},e.translate=function(t){return this.constant-=t.dot(this.normal),this},e.equals=function(t){return t.normal.equals(this.normal)&&t.constant===this.constant},t}(),Ee=new wt,Ae=new wt,Le=new wt,Re=new wt,Ce=new wt,Pe=new wt,Ie=new wt,De=new wt,Ne=new wt,Oe=new wt,Be=function(){function t(t,e,n){this.a=void 0!==t?t:new wt,this.b=void 0!==e?e:new wt,this.c=void 0!==n?n:new wt}t.getNormal=function(t,e,n,r){void 0===r&&(console.warn("THREE.Triangle: .getNormal() target is now required"),r=new wt),r.subVectors(n,e),Ee.subVectors(t,e),r.cross(Ee);var i=r.lengthSq();return i>0?r.multiplyScalar(1/Math.sqrt(i)):r.set(0,0,0)},t.getBarycoord=function(t,e,n,r,i){Ee.subVectors(r,e),Ae.subVectors(n,e),Le.subVectors(t,e);var a=Ee.dot(Ee),o=Ee.dot(Ae),s=Ee.dot(Le),c=Ae.dot(Ae),l=Ae.dot(Le),u=a*c-o*o;if(void 0===i&&(console.warn("THREE.Triangle: .getBarycoord() target is now required"),i=new wt),0===u)return i.set(-2,-1,-1);var h=1/u,d=(c*s-o*l)*h,p=(a*l-o*s)*h;return i.set(1-d-p,p,d)},t.containsPoint=function(t,e,n,r){return this.getBarycoord(t,e,n,r,Re),Re.x>=0&&Re.y>=0&&Re.x+Re.y<=1},t.getUV=function(t,e,n,r,i,a,o,s){return this.getBarycoord(t,e,n,r,Re),s.set(0,0),s.addScaledVector(i,Re.x),s.addScaledVector(a,Re.y),s.addScaledVector(o,Re.z),s},t.isFrontFacing=function(t,e,n,r){return Ee.subVectors(n,e),Ae.subVectors(t,e),Ee.cross(Ae).dot(r)<0};var e=t.prototype;return e.set=function(t,e,n){return this.a.copy(t),this.b.copy(e),this.c.copy(n),this},e.setFromPointsAndIndices=function(t,e,n,r){return this.a.copy(t[e]),this.b.copy(t[n]),this.c.copy(t[r]),this},e.clone=function(){return(new this.constructor).copy(this)},e.copy=function(t){return this.a.copy(t.a),this.b.copy(t.b),this.c.copy(t.c),this},e.getArea=function(){return Ee.subVectors(this.c,this.b),Ae.subVectors(this.a,this.b),.5*Ee.cross(Ae).length()},e.getMidpoint=function(t){return void 0===t&&(console.warn("THREE.Triangle: .getMidpoint() target is now required"),t=new wt),t.addVectors(this.a,this.b).add(this.c).multiplyScalar(1/3)},e.getNormal=function(e){return t.getNormal(this.a,this.b,this.c,e)},e.getPlane=function(t){return void 0===t&&(console.warn("THREE.Triangle: .getPlane() target is now required"),t=new Te),t.setFromCoplanarPoints(this.a,this.b,this.c)},e.getBarycoord=function(e,n){return t.getBarycoord(e,this.a,this.b,this.c,n)},e.getUV=function(e,n,r,i,a){return t.getUV(e,this.a,this.b,this.c,n,r,i,a)},e.containsPoint=function(e){return t.containsPoint(e,this.a,this.b,this.c)},e.isFrontFacing=function(e){return t.isFrontFacing(this.a,this.b,this.c,e)},e.intersectsBox=function(t){return t.intersectsTriangle(this)},e.closestPointToPoint=function(t,e){void 0===e&&(console.warn("THREE.Triangle: .closestPointToPoint() target is now required"),e=new wt);var n,r,i=this.a,a=this.b,o=this.c;Ce.subVectors(a,i),Pe.subVectors(o,i),De.subVectors(t,i);var s=Ce.dot(De),c=Pe.dot(De);if(s<=0&&c<=0)return e.copy(i);Ne.subVectors(t,a);var l=Ce.dot(Ne),u=Pe.dot(Ne);if(l>=0&&u<=l)return e.copy(a);var h=s*u-l*c;if(h<=0&&s>=0&&l<=0)return n=s/(s-l),e.copy(i).addScaledVector(Ce,n);Oe.subVectors(t,o);var d=Ce.dot(Oe),p=Pe.dot(Oe);if(p>=0&&d<=p)return e.copy(o);var f=d*c-s*p;if(f<=0&&c>=0&&p<=0)return r=c/(c-p),e.copy(i).addScaledVector(Pe,r);var m=l*p-d*u;if(m<=0&&u-l>=0&&d-p>=0)return Ie.subVectors(o,a),r=(u-l)/(u-l+(d-p)),e.copy(a).addScaledVector(Ie,r);var v=1/(m+f+h);return n=f*v,r=h*v,e.copy(i).addScaledVector(Ce,n).addScaledVector(Pe,r)},e.equals=function(t){return t.a.equals(this.a)&&t.b.equals(this.b)&&t.c.equals(this.c)},t}(),ze={aliceblue:15792383,antiquewhite:16444375,aqua:65535,aquamarine:8388564,azure:15794175,beige:16119260,bisque:16770244,black:0,blanchedalmond:16772045,blue:255,blueviolet:9055202,brown:10824234,burlywood:14596231,cadetblue:6266528,chartreuse:8388352,chocolate:13789470,coral:16744272,cornflowerblue:6591981,cornsilk:16775388,crimson:14423100,cyan:65535,darkblue:139,darkcyan:35723,darkgoldenrod:12092939,darkgray:11119017,darkgreen:25600,darkgrey:11119017,darkkhaki:12433259,darkmagenta:9109643,darkolivegreen:5597999,darkorange:16747520,darkorchid:10040012,darkred:9109504,darksalmon:15308410,darkseagreen:9419919,darkslateblue:4734347,darkslategray:3100495,darkslategrey:3100495,darkturquoise:52945,darkviolet:9699539,deeppink:16716947,deepskyblue:49151,dimgray:6908265,dimgrey:6908265,dodgerblue:2003199,firebrick:11674146,floralwhite:16775920,forestgreen:2263842,fuchsia:16711935,gainsboro:14474460,ghostwhite:16316671,gold:16766720,goldenrod:14329120,gray:8421504,green:32768,greenyellow:11403055,grey:8421504,honeydew:15794160,hotpink:16738740,indianred:13458524,indigo:4915330,ivory:16777200,khaki:15787660,lavender:15132410,lavenderblush:16773365,lawngreen:8190976,lemonchiffon:16775885,lightblue:11393254,lightcoral:15761536,lightcyan:14745599,lightgoldenrodyellow:16448210,lightgray:13882323,lightgreen:9498256,lightgrey:13882323,lightpink:16758465,lightsalmon:16752762,lightseagreen:2142890,lightskyblue:8900346,lightslategray:7833753,lightslategrey:7833753,lightsteelblue:11584734,lightyellow:16777184,lime:65280,limegreen:3329330,linen:16445670,magenta:16711935,maroon:8388608,mediumaquamarine:6737322,mediumblue:205,mediumorchid:12211667,mediumpurple:9662683,mediumseagreen:3978097,mediumslateblue:8087790,mediumspringgreen:64154,mediumturquoise:4772300,mediumvioletred:13047173,midnightblue:1644912,mintcream:16121850,mistyrose:16770273,moccasin:16770229,navajowhite:16768685,navy:128,oldlace:16643558,olive:8421376,olivedrab:7048739,orange:16753920,orangered:16729344,orchid:14315734,palegoldenrod:15657130,palegreen:10025880,paleturquoise:11529966,palevioletred:14381203,papayawhip:16773077,peachpuff:16767673,peru:13468991,pink:16761035,plum:14524637,powderblue:11591910,purple:8388736,rebeccapurple:6697881,red:16711680,rosybrown:12357519,royalblue:4286945,saddlebrown:9127187,salmon:16416882,sandybrown:16032864,seagreen:3050327,seashell:16774638,sienna:10506797,silver:12632256,skyblue:8900331,slateblue:6970061,slategray:7372944,slategrey:7372944,snow:16775930,springgreen:65407,steelblue:4620980,tan:13808780,teal:32896,thistle:14204888,tomato:16737095,turquoise:4251856,violet:15631086,wheat:16113331,white:16777215,whitesmoke:16119285,yellow:16776960,yellowgreen:10145074},Ge={h:0,s:0,l:0},Fe={h:0,s:0,l:0};function Ue(t,e,n){return n<0&&(n+=1),n>1&&(n-=1),n<1/6?t+6*(e-t)*n:n<.5?e:n<2/3?t+6*(e-t)*(2/3-n):t}function He(t){return t<.04045?.0773993808*t:Math.pow(.9478672986*t+.0521327014,2.4)}function ke(t){return t<.0031308?12.92*t:1.055*Math.pow(t,.41666)-.055}var Ve=function(){function t(t,e,n){return Object.defineProperty(this,"isColor",{value:!0}),void 0===e&&void 0===n?this.set(t):this.setRGB(t,e,n)}var e=t.prototype;return e.set=function(t){return t&&t.isColor?this.copy(t):"number"==typeof t?this.setHex(t):"string"==typeof t&&this.setStyle(t),this},e.setScalar=function(t){return this.r=t,this.g=t,this.b=t,this},e.setHex=function(t){return t=Math.floor(t),this.r=(t>>16&255)/255,this.g=(t>>8&255)/255,this.b=(255&t)/255,this},e.setRGB=function(t,e,n){return this.r=t,this.g=e,this.b=n,this},e.setHSL=function(t,e,n){if(t=st.euclideanModulo(t,1),e=st.clamp(e,0,1),n=st.clamp(n,0,1),0===e)this.r=this.g=this.b=n;else{var r=n<=.5?n*(1+e):n+e-n*e,i=2*n-r;this.r=Ue(i,r,t+1/3),this.g=Ue(i,r,t),this.b=Ue(i,r,t-1/3)}return this},e.setStyle=function(t){function e(e){void 0!==e&&parseFloat(e)<1&&console.warn("THREE.Color: Alpha component of "+t+" will be ignored.")}var n;if(n=/^((?:rgb|hsl)a?)\(\s*([^\)]*)\)/.exec(t)){var r,i=n[1],a=n[2];switch(i){case"rgb":case"rgba":if(r=/^(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*(,\s*([0-9]*\.?[0-9]+)\s*)?$/.exec(a))return this.r=Math.min(255,parseInt(r[1],10))/255,this.g=Math.min(255,parseInt(r[2],10))/255,this.b=Math.min(255,parseInt(r[3],10))/255,e(r[5]),this;if(r=/^(\d+)\%\s*,\s*(\d+)\%\s*,\s*(\d+)\%\s*(,\s*([0-9]*\.?[0-9]+)\s*)?$/.exec(a))return this.r=Math.min(100,parseInt(r[1],10))/100,this.g=Math.min(100,parseInt(r[2],10))/100,this.b=Math.min(100,parseInt(r[3],10))/100,e(r[5]),this;break;case"hsl":case"hsla":if(r=/^([0-9]*\.?[0-9]+)\s*,\s*(\d+)\%\s*,\s*(\d+)\%\s*(,\s*([0-9]*\.?[0-9]+)\s*)?$/.exec(a)){var o=parseFloat(r[1])/360,s=parseInt(r[2],10)/100,c=parseInt(r[3],10)/100;return e(r[5]),this.setHSL(o,s,c)}}}else if(n=/^\#([A-Fa-f0-9]+)$/.exec(t)){var l=n[1],u=l.length;if(3===u)return this.r=parseInt(l.charAt(0)+l.charAt(0),16)/255,this.g=parseInt(l.charAt(1)+l.charAt(1),16)/255,this.b=parseInt(l.charAt(2)+l.charAt(2),16)/255,this;if(6===u)return this.r=parseInt(l.charAt(0)+l.charAt(1),16)/255,this.g=parseInt(l.charAt(2)+l.charAt(3),16)/255,this.b=parseInt(l.charAt(4)+l.charAt(5),16)/255,this}return t&&t.length>0?this.setColorName(t):this},e.setColorName=function(t){var e=ze[t];return void 0!==e?this.setHex(e):console.warn("THREE.Color: Unknown color "+t),this},e.clone=function(){return new this.constructor(this.r,this.g,this.b)},e.copy=function(t){return this.r=t.r,this.g=t.g,this.b=t.b,this},e.copyGammaToLinear=function(t,e){return void 0===e&&(e=2),this.r=Math.pow(t.r,e),this.g=Math.pow(t.g,e),this.b=Math.pow(t.b,e),this},e.copyLinearToGamma=function(t,e){void 0===e&&(e=2);var n=e>0?1/e:1;return this.r=Math.pow(t.r,n),this.g=Math.pow(t.g,n),this.b=Math.pow(t.b,n),this},e.convertGammaToLinear=function(t){return this.copyGammaToLinear(this,t),this},e.convertLinearToGamma=function(t){return this.copyLinearToGamma(this,t),this},e.copySRGBToLinear=function(t){return this.r=He(t.r),this.g=He(t.g),this.b=He(t.b),this},e.copyLinearToSRGB=function(t){return this.r=ke(t.r),this.g=ke(t.g),this.b=ke(t.b),this},e.convertSRGBToLinear=function(){return this.copySRGBToLinear(this),this},e.convertLinearToSRGB=function(){return this.copyLinearToSRGB(this),this},e.getHex=function(){return 255*this.r<<16^255*this.g<<8^255*this.b<<0},e.getHexString=function(){return("000000"+this.getHex().toString(16)).slice(-6)},e.getHSL=function(t){void 0===t&&(console.warn("THREE.Color: .getHSL() target is now required"),t={h:0,s:0,l:0});var e,n,r=this.r,i=this.g,a=this.b,o=Math.max(r,i,a),s=Math.min(r,i,a),c=(s+o)/2;if(s===o)e=0,n=0;else{var l=o-s;switch(n=c<=.5?l/(o+s):l/(2-o-s),o){case r:e=(i-a)/l+(i0&&(n.alphaTest=this.alphaTest),!0===this.premultipliedAlpha&&(n.premultipliedAlpha=this.premultipliedAlpha),!0===this.wireframe&&(n.wireframe=this.wireframe),this.wireframeLinewidth>1&&(n.wireframeLinewidth=this.wireframeLinewidth),"round"!==this.wireframeLinecap&&(n.wireframeLinecap=this.wireframeLinecap),"round"!==this.wireframeLinejoin&&(n.wireframeLinejoin=this.wireframeLinejoin),!0===this.morphTargets&&(n.morphTargets=!0),!0===this.morphNormals&&(n.morphNormals=!0),!0===this.skinning&&(n.skinning=!0),!1===this.visible&&(n.visible=!1),!1===this.toneMapped&&(n.toneMapped=!1),"{}"!==JSON.stringify(this.userData)&&(n.userData=this.userData),e){var i=r(t.textures),a=r(t.images);i.length>0&&(n.textures=i),a.length>0&&(n.images=a)}return n},clone:function(){return(new this.constructor).copy(this)},copy:function(t){this.name=t.name,this.fog=t.fog,this.blending=t.blending,this.side=t.side,this.flatShading=t.flatShading,this.vertexColors=t.vertexColors,this.opacity=t.opacity,this.transparent=t.transparent,this.blendSrc=t.blendSrc,this.blendDst=t.blendDst,this.blendEquation=t.blendEquation,this.blendSrcAlpha=t.blendSrcAlpha,this.blendDstAlpha=t.blendDstAlpha,this.blendEquationAlpha=t.blendEquationAlpha,this.depthFunc=t.depthFunc,this.depthTest=t.depthTest,this.depthWrite=t.depthWrite,this.stencilWriteMask=t.stencilWriteMask,this.stencilFunc=t.stencilFunc,this.stencilRef=t.stencilRef,this.stencilFuncMask=t.stencilFuncMask,this.stencilFail=t.stencilFail,this.stencilZFail=t.stencilZFail,this.stencilZPass=t.stencilZPass,this.stencilWrite=t.stencilWrite;var e=t.clippingPlanes,n=null;if(null!==e){var r=e.length;n=new Array(r);for(var i=0;i!==r;++i)n[i]=e[i].clone()}return this.clippingPlanes=n,this.clipIntersection=t.clipIntersection,this.clipShadows=t.clipShadows,this.shadowSide=t.shadowSide,this.colorWrite=t.colorWrite,this.precision=t.precision,this.polygonOffset=t.polygonOffset,this.polygonOffsetFactor=t.polygonOffsetFactor,this.polygonOffsetUnits=t.polygonOffsetUnits,this.dithering=t.dithering,this.alphaTest=t.alphaTest,this.premultipliedAlpha=t.premultipliedAlpha,this.visible=t.visible,this.toneMapped=t.toneMapped,this.userData=JSON.parse(JSON.stringify(t.userData)),this},dispose:function(){this.dispatchEvent({type:"dispose"})}}),Object.defineProperty(qe.prototype,"needsUpdate",{set:function(t){!0===t&&this.version++}}),Xe.prototype=Object.create(qe.prototype),Xe.prototype.constructor=Xe,Xe.prototype.isMeshBasicMaterial=!0,Xe.prototype.copy=function(t){return qe.prototype.copy.call(this,t),this.color.copy(t.color),this.map=t.map,this.lightMap=t.lightMap,this.lightMapIntensity=t.lightMapIntensity,this.aoMap=t.aoMap,this.aoMapIntensity=t.aoMapIntensity,this.specularMap=t.specularMap,this.alphaMap=t.alphaMap,this.envMap=t.envMap,this.combine=t.combine,this.reflectivity=t.reflectivity,this.refractionRatio=t.refractionRatio,this.wireframe=t.wireframe,this.wireframeLinewidth=t.wireframeLinewidth,this.wireframeLinecap=t.wireframeLinecap,this.wireframeLinejoin=t.wireframeLinejoin,this.skinning=t.skinning,this.morphTargets=t.morphTargets,this};var Ye=new wt,Ze=new pt;function Je(t,e,n){if(Array.isArray(t))throw new TypeError("THREE.BufferAttribute: array should be a Typed Array.");this.name="",this.array=t,this.itemSize=e,this.count=void 0!==t?t.length/e:0,this.normalized=!0===n,this.usage=tt,this.updateRange={offset:0,count:-1},this.version=0}function Qe(t,e,n){Je.call(this,new Int8Array(t),e,n)}function Ke(t,e,n){Je.call(this,new Uint8Array(t),e,n)}function $e(t,e,n){Je.call(this,new Uint8ClampedArray(t),e,n)}function tn(t,e,n){Je.call(this,new Int16Array(t),e,n)}function en(t,e,n){Je.call(this,new Uint16Array(t),e,n)}function nn(t,e,n){Je.call(this,new Int32Array(t),e,n)}function rn(t,e,n){Je.call(this,new Uint32Array(t),e,n)}function an(t,e,n){Je.call(this,new Float32Array(t),e,n)}function on(t,e,n){Je.call(this,new Float64Array(t),e,n)}Object.defineProperty(Je.prototype,"needsUpdate",{set:function(t){!0===t&&this.version++}}),Object.assign(Je.prototype,{isBufferAttribute:!0,onUploadCallback:function(){},setUsage:function(t){return this.usage=t,this},copy:function(t){return this.name=t.name,this.array=new t.array.constructor(t.array),this.itemSize=t.itemSize,this.count=t.count,this.normalized=t.normalized,this.usage=t.usage,this},copyAt:function(t,e,n){t*=this.itemSize,n*=e.itemSize;for(var r=0,i=this.itemSize;r0,o=i[1]&&i[1].length>0,s=t.morphTargets,c=s.length;if(c>0){e=[];for(var l=0;l0){u=[];for(var p=0;p0&&0===n.length&&console.error("THREE.DirectGeometry: Faceless geometries are not supported.");for(var y=0;ye&&(e=t[n]);return e}var ln=1,un=new Jt,hn=new be,dn=new wt,pn=new Tt,fn=new Tt,mn=new wt;function vn(){Object.defineProperty(this,"id",{value:ln+=2}),this.uuid=st.generateUUID(),this.name="",this.type="BufferGeometry",this.index=null,this.attributes={},this.morphAttributes={},this.morphTargetsRelative=!1,this.groups=[],this.boundingBox=null,this.boundingSphere=null,this.drawRange={start:0,count:1/0},this.userData={}}vn.prototype=Object.assign(Object.create(rt.prototype),{constructor:vn,isBufferGeometry:!0,getIndex:function(){return this.index},setIndex:function(t){return Array.isArray(t)?this.index=new(cn(t)>65535?rn:en)(t,1):this.index=t,this},getAttribute:function(t){return this.attributes[t]},setAttribute:function(t,e){return this.attributes[t]=e,this},deleteAttribute:function(t){return delete this.attributes[t],this},addGroup:function(t,e,n){this.groups.push({start:t,count:e,materialIndex:void 0!==n?n:0})},clearGroups:function(){this.groups=[]},setDrawRange:function(t,e){this.drawRange.start=t,this.drawRange.count=e},applyMatrix4:function(t){var e=this.attributes.position;void 0!==e&&(e.applyMatrix4(t),e.needsUpdate=!0);var n=this.attributes.normal;if(void 0!==n){var r=(new ft).getNormalMatrix(t);n.applyNormalMatrix(r),n.needsUpdate=!0}var i=this.attributes.tangent;return void 0!==i&&(i.transformDirection(t),i.needsUpdate=!0),null!==this.boundingBox&&this.computeBoundingBox(),null!==this.boundingSphere&&this.computeBoundingSphere(),this},rotateX:function(t){return un.makeRotationX(t),this.applyMatrix4(un),this},rotateY:function(t){return un.makeRotationY(t),this.applyMatrix4(un),this},rotateZ:function(t){return un.makeRotationZ(t),this.applyMatrix4(un),this},translate:function(t,e,n){return un.makeTranslation(t,e,n),this.applyMatrix4(un),this},scale:function(t,e,n){return un.makeScale(t,e,n),this.applyMatrix4(un),this},lookAt:function(t){return hn.lookAt(t),hn.updateMatrix(),this.applyMatrix4(hn.matrix),this},center:function(){return this.computeBoundingBox(),this.boundingBox.getCenter(dn).negate(),this.translate(dn.x,dn.y,dn.z),this},setFromObject:function(t){var e=t.geometry;if(t.isPoints||t.isLine){var n=new an(3*e.vertices.length,3),r=new an(3*e.colors.length,3);if(this.setAttribute("position",n.copyVector3sArray(e.vertices)),this.setAttribute("color",r.copyColorsArray(e.colors)),e.lineDistances&&e.lineDistances.length===e.vertices.length){var i=new an(e.lineDistances.length,1);this.setAttribute("lineDistance",i.copyArray(e.lineDistances))}null!==e.boundingSphere&&(this.boundingSphere=e.boundingSphere.clone()),null!==e.boundingBox&&(this.boundingBox=e.boundingBox.clone())}else t.isMesh&&e&&e.isGeometry&&this.fromGeometry(e);return this},setFromPoints:function(t){for(var e=[],n=0,r=t.length;n0){var n=new Float32Array(3*t.normals.length);this.setAttribute("normal",new Je(n,3).copyVector3sArray(t.normals))}if(t.colors.length>0){var r=new Float32Array(3*t.colors.length);this.setAttribute("color",new Je(r,3).copyColorsArray(t.colors))}if(t.uvs.length>0){var i=new Float32Array(2*t.uvs.length);this.setAttribute("uv",new Je(i,2).copyVector2sArray(t.uvs))}if(t.uvs2.length>0){var a=new Float32Array(2*t.uvs2.length);this.setAttribute("uv2",new Je(a,2).copyVector2sArray(t.uvs2))}for(var o in this.groups=t.groups,t.morphTargets){for(var s=[],c=t.morphTargets[o],l=0,u=c.length;l0){var p=new an(4*t.skinIndices.length,4);this.setAttribute("skinIndex",p.copyVector4sArray(t.skinIndices))}if(t.skinWeights.length>0){var f=new an(4*t.skinWeights.length,4);this.setAttribute("skinWeight",f.copyVector4sArray(t.skinWeights))}return null!==t.boundingSphere&&(this.boundingSphere=t.boundingSphere.clone()),null!==t.boundingBox&&(this.boundingBox=t.boundingBox.clone()),this},computeBoundingBox:function(){null===this.boundingBox&&(this.boundingBox=new Tt);var t=this.attributes.position,e=this.morphAttributes.position;if(t&&t.isGLBufferAttribute)return console.error('THREE.BufferGeometry.computeBoundingBox(): GLBufferAttribute requires a manual bounding box. Alternatively set "mesh.frustumCulled" to "false".',this),void this.boundingBox.set(new wt(-1/0,-1/0,-1/0),new wt(1/0,1/0,1/0));if(void 0!==t){if(this.boundingBox.setFromBufferAttribute(t),e)for(var n=0,r=e.length;n0&&(t.userData=this.userData),void 0!==this.parameters){var e=this.parameters;for(var n in e)void 0!==e[n]&&(t[n]=e[n]);return t}t.data={attributes:{}};var r=this.index;null!==r&&(t.data.index={type:r.array.constructor.name,array:Array.prototype.slice.call(r.array)});var i=this.attributes;for(var a in i){var o=i[a],s=o.toJSON(t.data);""!==o.name&&(s.name=o.name),t.data.attributes[a]=s}var c={},l=!1;for(var u in this.morphAttributes){for(var h=this.morphAttributes[u],d=[],p=0,f=h.length;p0&&(c[u]=d,l=!0)}l&&(t.data.morphAttributes=c,t.data.morphTargetsRelative=this.morphTargetsRelative);var g=this.groups;g.length>0&&(t.data.groups=JSON.parse(JSON.stringify(g)));var y=this.boundingSphere;return null!==y&&(t.data.boundingSphere={center:y.center.toArray(),radius:y.radius}),t},clone:function(){return(new vn).copy(this)},copy:function(t){this.index=null,this.attributes={},this.morphAttributes={},this.groups=[],this.boundingBox=null,this.boundingSphere=null;var e={};this.name=t.name;var n=t.index;null!==n&&this.setIndex(n.clone(e));var r=t.attributes;for(var i in r){var a=r[i];this.setAttribute(i,a.clone(e))}var o=t.morphAttributes;for(var s in o){for(var c=[],l=o[s],u=0,h=l.length;un.far?null:{distance:c,point:Dn.clone(),object:t}}function Bn(t,e,n,r,i,a,o,s,c,l,u,h){_n.fromBufferAttribute(i,l),bn.fromBufferAttribute(i,u),wn.fromBufferAttribute(i,h);var d=t.morphTargetInfluences;if(e.morphTargets&&a&&d){En.set(0,0,0),An.set(0,0,0),Ln.set(0,0,0);for(var p=0,f=a.length;p0){var r=e[n[0]];if(void 0!==r){this.morphTargetInfluences=[],this.morphTargetDictionary={};for(var i=0,a=r.length;i0&&console.error("THREE.Mesh.updateMorphTargets() no longer supports THREE.Geometry. Use THREE.BufferGeometry instead.")}},raycast:function(t,e){var n,r=this.geometry,i=this.material,a=this.matrixWorld;if(void 0!==i&&(null===r.boundingSphere&&r.computeBoundingSphere(),xn.copy(r.boundingSphere),xn.applyMatrix4(a),!1!==t.ray.intersectsSphere(xn)&&(gn.getInverse(a),yn.copy(t.ray).applyMatrix4(gn),null===r.boundingBox||!1!==yn.intersectsBox(r.boundingBox))))if(r.isBufferGeometry){var o=r.index,s=r.attributes.position,c=r.morphAttributes.position,l=r.morphTargetsRelative,u=r.attributes.uv,h=r.attributes.uv2,d=r.groups,p=r.drawRange;if(null!==o)if(Array.isArray(i))for(var f=0,m=d.length;f0&&(B=U);for(var H=0,k=F.length;H0?1:-1,h.push(A.x,A.y,A.z),d.push(C/m),d.push(1-L/v),T+=1}for(var I=0;I0&&(e.defines=this.defines),e.vertexShader=this.vertexShader,e.fragmentShader=this.fragmentShader;var i={};for(var a in this.extensions)!0===this.extensions[a]&&(i[a]=!0);return Object.keys(i).length>0&&(e.extensions=i),e},kn.prototype=Object.assign(Object.create(be.prototype),{constructor:kn,isCamera:!0,copy:function(t,e){return be.prototype.copy.call(this,t,e),this.matrixWorldInverse.copy(t.matrixWorldInverse),this.projectionMatrix.copy(t.projectionMatrix),this.projectionMatrixInverse.copy(t.projectionMatrixInverse),this},getWorldDirection:function(t){void 0===t&&(console.warn("THREE.Camera: .getWorldDirection() target is now required"),t=new wt),this.updateMatrixWorld(!0);var e=this.matrixWorld.elements;return t.set(-e[8],-e[9],-e[10]).normalize()},updateMatrixWorld:function(t){be.prototype.updateMatrixWorld.call(this,t),this.matrixWorldInverse.getInverse(this.matrixWorld)},updateWorldMatrix:function(t,e){be.prototype.updateWorldMatrix.call(this,t,e),this.matrixWorldInverse.getInverse(this.matrixWorld)},clone:function(){return(new this.constructor).copy(this)}}),Vn.prototype=Object.assign(Object.create(kn.prototype),{constructor:Vn,isPerspectiveCamera:!0,copy:function(t,e){return kn.prototype.copy.call(this,t,e),this.fov=t.fov,this.zoom=t.zoom,this.near=t.near,this.far=t.far,this.focus=t.focus,this.aspect=t.aspect,this.view=null===t.view?null:Object.assign({},t.view),this.filmGauge=t.filmGauge,this.filmOffset=t.filmOffset,this},setFocalLength:function(t){var e=.5*this.getFilmHeight()/t;this.fov=2*st.RAD2DEG*Math.atan(e),this.updateProjectionMatrix()},getFocalLength:function(){var t=Math.tan(.5*st.DEG2RAD*this.fov);return.5*this.getFilmHeight()/t},getEffectiveFOV:function(){return 2*st.RAD2DEG*Math.atan(Math.tan(.5*st.DEG2RAD*this.fov)/this.zoom)},getFilmWidth:function(){return this.filmGauge*Math.min(this.aspect,1)},getFilmHeight:function(){return this.filmGauge/Math.max(this.aspect,1)},setViewOffset:function(t,e,n,r,i,a){this.aspect=t/e,null===this.view&&(this.view={enabled:!0,fullWidth:1,fullHeight:1,offsetX:0,offsetY:0,width:1,height:1}),this.view.enabled=!0,this.view.fullWidth=t,this.view.fullHeight=e,this.view.offsetX=n,this.view.offsetY=r,this.view.width=i,this.view.height=a,this.updateProjectionMatrix()},clearViewOffset:function(){null!==this.view&&(this.view.enabled=!1),this.updateProjectionMatrix()},updateProjectionMatrix:function(){var t=this.near,e=t*Math.tan(.5*st.DEG2RAD*this.fov)/this.zoom,n=2*e,r=this.aspect*n,i=-.5*r,a=this.view;if(null!==this.view&&this.view.enabled){var o=a.fullWidth,s=a.fullHeight;i+=a.offsetX*r/o,e-=a.offsetY*n/s,r*=a.width/o,n*=a.height/s}var c=this.filmOffset;0!==c&&(i+=t*c/this.getFilmWidth()),this.projectionMatrix.makePerspective(i,i+r,e,e-n,t,this.far),this.projectionMatrixInverse.getInverse(this.projectionMatrix)},toJSON:function(t){var e=be.prototype.toJSON.call(this,t);return e.object.fov=this.fov,e.object.zoom=this.zoom,e.object.near=this.near,e.object.far=this.far,e.object.focus=this.focus,e.object.aspect=this.aspect,null!==this.view&&(e.object.view=Object.assign({},this.view)),e.object.filmGauge=this.filmGauge,e.object.filmOffset=this.filmOffset,e}});var Wn=90;function jn(t,e,n){if(be.call(this),this.type="CubeCamera",!0===n.isWebGLCubeRenderTarget){this.renderTarget=n;var r=new Vn(Wn,1,t,e);r.layers=this.layers,r.up.set(0,-1,0),r.lookAt(new wt(1,0,0)),this.add(r);var i=new Vn(Wn,1,t,e);i.layers=this.layers,i.up.set(0,-1,0),i.lookAt(new wt(-1,0,0)),this.add(i);var a=new Vn(Wn,1,t,e);a.layers=this.layers,a.up.set(0,0,1),a.lookAt(new wt(0,1,0)),this.add(a);var o=new Vn(Wn,1,t,e);o.layers=this.layers,o.up.set(0,0,-1),o.lookAt(new wt(0,-1,0)),this.add(o);var s=new Vn(Wn,1,t,e);s.layers=this.layers,s.up.set(0,-1,0),s.lookAt(new wt(0,0,1)),this.add(s);var c=new Vn(Wn,1,t,e);c.layers=this.layers,c.up.set(0,-1,0),c.lookAt(new wt(0,0,-1)),this.add(c),this.update=function(t,e){null===this.parent&&this.updateMatrixWorld();var l=t.xr.enabled,u=t.getRenderTarget();t.xr.enabled=!1;var h=n.texture.generateMipmaps;n.texture.generateMipmaps=!1,t.setRenderTarget(n,0),t.render(e,r),t.setRenderTarget(n,1),t.render(e,i),t.setRenderTarget(n,2),t.render(e,a),t.setRenderTarget(n,3),t.render(e,o),t.setRenderTarget(n,4),t.render(e,s),n.texture.generateMipmaps=h,t.setRenderTarget(n,5),t.render(e,c),t.setRenderTarget(u),t.xr.enabled=l},this.clear=function(t,e,r,i){for(var a=t.getRenderTarget(),o=0;o<6;o++)t.setRenderTarget(n,o),t.clear(e,r,i);t.setRenderTarget(a)}}else console.error("THREE.CubeCamera: The constructor now expects an instance of WebGLCubeRenderTarget as third parameter.")}function qn(t,e,n,i,a,o,s,c,l,u){t=void 0!==t?t:[],e=void 0!==e?e:r,s=void 0!==s?s:S,gt.call(this,t,e,n,i,a,o,s,c,l,u),this.flipY=!1,this._needsFlipEnvMap=!0}function Xn(t,e,n){Number.isInteger(e)&&(console.warn("THREE.WebGLCubeRenderTarget: constructor signature is now WebGLCubeRenderTarget( size, options )"),e=n),xt.call(this,t,t,e),e=e||{},this.texture=new qn(void 0,e.mapping,e.wrapS,e.wrapT,e.magFilter,e.minFilter,e.format,e.type,e.anisotropy,e.encoding),this.texture._needsFlipEnvMap=!1}function Yn(t,e,n,r,i,a,o,s,c,l,u,h){gt.call(this,null,a,o,s,c,l,r,i,u,h),this.image={data:t||null,width:e||1,height:n||1},this.magFilter=void 0!==c?c:d,this.minFilter=void 0!==l?l:d,this.generateMipmaps=!1,this.flipY=!1,this.unpackAlignment=1,this.needsUpdate=!0}jn.prototype=Object.create(be.prototype),jn.prototype.constructor=jn,qn.prototype=Object.create(gt.prototype),qn.prototype.constructor=qn,qn.prototype.isCubeTexture=!0,Object.defineProperty(qn.prototype,"images",{get:function(){return this.image},set:function(t){this.image=t}}),Xn.prototype=Object.create(xt.prototype),Xn.prototype.constructor=Xn,Xn.prototype.isWebGLCubeRenderTarget=!0,Xn.prototype.fromEquirectangularTexture=function(t,e){this.texture.type=e.type,this.texture.format=T,this.texture.encoding=e.encoding,this.texture.generateMipmaps=e.generateMipmaps,this.texture.minFilter=e.minFilter,this.texture.magFilter=e.magFilter;var n={tEquirect:{value:null}},r="\n\n\t\t\tvarying vec3 vWorldDirection;\n\n\t\t\tvec3 transformDirection( in vec3 dir, in mat4 matrix ) {\n\n\t\t\t\treturn normalize( ( matrix * vec4( dir, 0.0 ) ).xyz );\n\n\t\t\t}\n\n\t\t\tvoid main() {\n\n\t\t\t\tvWorldDirection = transformDirection( position, modelMatrix );\n\n\t\t\t\t#include \n\t\t\t\t#include \n\n\t\t\t}\n\t\t",i="\n\n\t\t\tuniform sampler2D tEquirect;\n\n\t\t\tvarying vec3 vWorldDirection;\n\n\t\t\t#include \n\n\t\t\tvoid main() {\n\n\t\t\t\tvec3 direction = normalize( vWorldDirection );\n\n\t\t\t\tvec2 sampleUV = equirectUv( direction );\n\n\t\t\t\tgl_FragColor = texture2D( tEquirect, sampleUV );\n\n\t\t\t}\n\t\t",a=new zn(5,5,5),o=new Hn({name:"CubemapFromEquirect",uniforms:Gn(n),vertexShader:r,fragmentShader:i,side:1,blending:0});o.uniforms.tEquirect.value=e;var s=new Nn(a,o),c=e.minFilter;return e.minFilter===g&&(e.minFilter=m),new jn(1,10,this).update(t,s),e.minFilter=c,s.geometry.dispose(),s.material.dispose(),this},Yn.prototype=Object.create(gt.prototype),Yn.prototype.constructor=Yn,Yn.prototype.isDataTexture=!0;var Zn=new Ht,Jn=new wt,Qn=function(){function t(t,e,n,r,i,a){this.planes=[void 0!==t?t:new Te,void 0!==e?e:new Te,void 0!==n?n:new Te,void 0!==r?r:new Te,void 0!==i?i:new Te,void 0!==a?a:new Te]}var e=t.prototype;return e.set=function(t,e,n,r,i,a){var o=this.planes;return o[0].copy(t),o[1].copy(e),o[2].copy(n),o[3].copy(r),o[4].copy(i),o[5].copy(a),this},e.clone=function(){return(new this.constructor).copy(this)},e.copy=function(t){for(var e=this.planes,n=0;n<6;n++)e[n].copy(t.planes[n]);return this},e.setFromProjectionMatrix=function(t){var e=this.planes,n=t.elements,r=n[0],i=n[1],a=n[2],o=n[3],s=n[4],c=n[5],l=n[6],u=n[7],h=n[8],d=n[9],p=n[10],f=n[11],m=n[12],v=n[13],g=n[14],y=n[15];return e[0].setComponents(o-r,u-s,f-h,y-m).normalize(),e[1].setComponents(o+r,u+s,f+h,y+m).normalize(),e[2].setComponents(o+i,u+c,f+d,y+v).normalize(),e[3].setComponents(o-i,u-c,f-d,y-v).normalize(),e[4].setComponents(o-a,u-l,f-p,y-g).normalize(),e[5].setComponents(o+a,u+l,f+p,y+g).normalize(),this},e.intersectsObject=function(t){var e=t.geometry;return null===e.boundingSphere&&e.computeBoundingSphere(),Zn.copy(e.boundingSphere).applyMatrix4(t.matrixWorld),this.intersectsSphere(Zn)},e.intersectsSprite=function(t){return Zn.center.set(0,0,0),Zn.radius=.7071067811865476,Zn.applyMatrix4(t.matrixWorld),this.intersectsSphere(Zn)},e.intersectsSphere=function(t){for(var e=this.planes,n=t.center,r=-t.radius,i=0;i<6;i++){if(e[i].distanceToPoint(n)0?t.max.x:t.min.x,Jn.y=r.normal.y>0?t.max.y:t.min.y,Jn.z=r.normal.z>0?t.max.z:t.min.z,r.distanceToPoint(Jn)<0)return!1}return!0},e.containsPoint=function(t){for(var e=this.planes,n=0;n<6;n++)if(e[n].distanceToPoint(t)<0)return!1;return!0},t}();function Kn(){var t=null,e=!1,n=null,r=null;function i(e,a){n(e,a),r=t.requestAnimationFrame(i)}return{start:function(){!0!==e&&null!==n&&(r=t.requestAnimationFrame(i),e=!0)},stop:function(){t.cancelAnimationFrame(r),e=!1},setAnimationLoop:function(t){n=t},setContext:function(e){t=e}}}function $n(t,e){var n=e.isWebGL2,r=new WeakMap;return{get:function(t){return t.isInterleavedBufferAttribute&&(t=t.data),r.get(t)},remove:function(e){e.isInterleavedBufferAttribute&&(e=e.data);var n=r.get(e);n&&(t.deleteBuffer(n.buffer),r.delete(e))},update:function(e,i){if(e.isGLBufferAttribute){var a=r.get(e);(!a||a.version 0.0 ) {\n\t\tdistanceFalloff *= pow2( saturate( 1.0 - pow4( lightDistance / cutoffDistance ) ) );\n\t}\n\treturn distanceFalloff;\n#else\n\tif( cutoffDistance > 0.0 && decayExponent > 0.0 ) {\n\t\treturn pow( saturate( -lightDistance / cutoffDistance + 1.0 ), decayExponent );\n\t}\n\treturn 1.0;\n#endif\n}\nvec3 BRDF_Diffuse_Lambert( const in vec3 diffuseColor ) {\n\treturn RECIPROCAL_PI * diffuseColor;\n}\nvec3 F_Schlick( const in vec3 specularColor, const in float dotLH ) {\n\tfloat fresnel = exp2( ( -5.55473 * dotLH - 6.98316 ) * dotLH );\n\treturn ( 1.0 - specularColor ) * fresnel + specularColor;\n}\nvec3 F_Schlick_RoughnessDependent( const in vec3 F0, const in float dotNV, const in float roughness ) {\n\tfloat fresnel = exp2( ( -5.55473 * dotNV - 6.98316 ) * dotNV );\n\tvec3 Fr = max( vec3( 1.0 - roughness ), F0 ) - F0;\n\treturn Fr * fresnel + F0;\n}\nfloat G_GGX_Smith( const in float alpha, const in float dotNL, const in float dotNV ) {\n\tfloat a2 = pow2( alpha );\n\tfloat gl = dotNL + sqrt( a2 + ( 1.0 - a2 ) * pow2( dotNL ) );\n\tfloat gv = dotNV + sqrt( a2 + ( 1.0 - a2 ) * pow2( dotNV ) );\n\treturn 1.0 / ( gl * gv );\n}\nfloat G_GGX_SmithCorrelated( const in float alpha, const in float dotNL, const in float dotNV ) {\n\tfloat a2 = pow2( alpha );\n\tfloat gv = dotNL * sqrt( a2 + ( 1.0 - a2 ) * pow2( dotNV ) );\n\tfloat gl = dotNV * sqrt( a2 + ( 1.0 - a2 ) * pow2( dotNL ) );\n\treturn 0.5 / max( gv + gl, EPSILON );\n}\nfloat D_GGX( const in float alpha, const in float dotNH ) {\n\tfloat a2 = pow2( alpha );\n\tfloat denom = pow2( dotNH ) * ( a2 - 1.0 ) + 1.0;\n\treturn RECIPROCAL_PI * a2 / pow2( denom );\n}\nvec3 BRDF_Specular_GGX( const in IncidentLight incidentLight, const in vec3 viewDir, const in vec3 normal, const in vec3 specularColor, const in float roughness ) {\n\tfloat alpha = pow2( roughness );\n\tvec3 halfDir = normalize( incidentLight.direction + viewDir );\n\tfloat dotNL = saturate( dot( normal, incidentLight.direction ) );\n\tfloat dotNV = saturate( dot( normal, viewDir ) );\n\tfloat dotNH = saturate( dot( normal, halfDir ) );\n\tfloat dotLH = saturate( dot( incidentLight.direction, halfDir ) );\n\tvec3 F = F_Schlick( specularColor, dotLH );\n\tfloat G = G_GGX_SmithCorrelated( alpha, dotNL, dotNV );\n\tfloat D = D_GGX( alpha, dotNH );\n\treturn F * ( G * D );\n}\nvec2 LTC_Uv( const in vec3 N, const in vec3 V, const in float roughness ) {\n\tconst float LUT_SIZE = 64.0;\n\tconst float LUT_SCALE = ( LUT_SIZE - 1.0 ) / LUT_SIZE;\n\tconst float LUT_BIAS = 0.5 / LUT_SIZE;\n\tfloat dotNV = saturate( dot( N, V ) );\n\tvec2 uv = vec2( roughness, sqrt( 1.0 - dotNV ) );\n\tuv = uv * LUT_SCALE + LUT_BIAS;\n\treturn uv;\n}\nfloat LTC_ClippedSphereFormFactor( const in vec3 f ) {\n\tfloat l = length( f );\n\treturn max( ( l * l + f.z ) / ( l + 1.0 ), 0.0 );\n}\nvec3 LTC_EdgeVectorFormFactor( const in vec3 v1, const in vec3 v2 ) {\n\tfloat x = dot( v1, v2 );\n\tfloat y = abs( x );\n\tfloat a = 0.8543985 + ( 0.4965155 + 0.0145206 * y ) * y;\n\tfloat b = 3.4175940 + ( 4.1616724 + y ) * y;\n\tfloat v = a / b;\n\tfloat theta_sintheta = ( x > 0.0 ) ? v : 0.5 * inversesqrt( max( 1.0 - x * x, 1e-7 ) ) - v;\n\treturn cross( v1, v2 ) * theta_sintheta;\n}\nvec3 LTC_Evaluate( const in vec3 N, const in vec3 V, const in vec3 P, const in mat3 mInv, const in vec3 rectCoords[ 4 ] ) {\n\tvec3 v1 = rectCoords[ 1 ] - rectCoords[ 0 ];\n\tvec3 v2 = rectCoords[ 3 ] - rectCoords[ 0 ];\n\tvec3 lightNormal = cross( v1, v2 );\n\tif( dot( lightNormal, P - rectCoords[ 0 ] ) < 0.0 ) return vec3( 0.0 );\n\tvec3 T1, T2;\n\tT1 = normalize( V - N * dot( V, N ) );\n\tT2 = - cross( N, T1 );\n\tmat3 mat = mInv * transposeMat3( mat3( T1, T2, N ) );\n\tvec3 coords[ 4 ];\n\tcoords[ 0 ] = mat * ( rectCoords[ 0 ] - P );\n\tcoords[ 1 ] = mat * ( rectCoords[ 1 ] - P );\n\tcoords[ 2 ] = mat * ( rectCoords[ 2 ] - P );\n\tcoords[ 3 ] = mat * ( rectCoords[ 3 ] - P );\n\tcoords[ 0 ] = normalize( coords[ 0 ] );\n\tcoords[ 1 ] = normalize( coords[ 1 ] );\n\tcoords[ 2 ] = normalize( coords[ 2 ] );\n\tcoords[ 3 ] = normalize( coords[ 3 ] );\n\tvec3 vectorFormFactor = vec3( 0.0 );\n\tvectorFormFactor += LTC_EdgeVectorFormFactor( coords[ 0 ], coords[ 1 ] );\n\tvectorFormFactor += LTC_EdgeVectorFormFactor( coords[ 1 ], coords[ 2 ] );\n\tvectorFormFactor += LTC_EdgeVectorFormFactor( coords[ 2 ], coords[ 3 ] );\n\tvectorFormFactor += LTC_EdgeVectorFormFactor( coords[ 3 ], coords[ 0 ] );\n\tfloat result = LTC_ClippedSphereFormFactor( vectorFormFactor );\n\treturn vec3( result );\n}\nvec3 BRDF_Specular_GGX_Environment( const in vec3 viewDir, const in vec3 normal, const in vec3 specularColor, const in float roughness ) {\n\tfloat dotNV = saturate( dot( normal, viewDir ) );\n\tvec2 brdf = integrateSpecularBRDF( dotNV, roughness );\n\treturn specularColor * brdf.x + brdf.y;\n}\nvoid BRDF_Specular_Multiscattering_Environment( const in GeometricContext geometry, const in vec3 specularColor, const in float roughness, inout vec3 singleScatter, inout vec3 multiScatter ) {\n\tfloat dotNV = saturate( dot( geometry.normal, geometry.viewDir ) );\n\tvec3 F = F_Schlick_RoughnessDependent( specularColor, dotNV, roughness );\n\tvec2 brdf = integrateSpecularBRDF( dotNV, roughness );\n\tvec3 FssEss = F * brdf.x + brdf.y;\n\tfloat Ess = brdf.x + brdf.y;\n\tfloat Ems = 1.0 - Ess;\n\tvec3 Favg = specularColor + ( 1.0 - specularColor ) * 0.047619;\tvec3 Fms = FssEss * Favg / ( 1.0 - Ems * Favg );\n\tsingleScatter += FssEss;\n\tmultiScatter += Fms * Ems;\n}\nfloat G_BlinnPhong_Implicit( ) {\n\treturn 0.25;\n}\nfloat D_BlinnPhong( const in float shininess, const in float dotNH ) {\n\treturn RECIPROCAL_PI * ( shininess * 0.5 + 1.0 ) * pow( dotNH, shininess );\n}\nvec3 BRDF_Specular_BlinnPhong( const in IncidentLight incidentLight, const in GeometricContext geometry, const in vec3 specularColor, const in float shininess ) {\n\tvec3 halfDir = normalize( incidentLight.direction + geometry.viewDir );\n\tfloat dotNH = saturate( dot( geometry.normal, halfDir ) );\n\tfloat dotLH = saturate( dot( incidentLight.direction, halfDir ) );\n\tvec3 F = F_Schlick( specularColor, dotLH );\n\tfloat G = G_BlinnPhong_Implicit( );\n\tfloat D = D_BlinnPhong( shininess, dotNH );\n\treturn F * ( G * D );\n}\nfloat GGXRoughnessToBlinnExponent( const in float ggxRoughness ) {\n\treturn ( 2.0 / pow2( ggxRoughness + 0.0001 ) - 2.0 );\n}\nfloat BlinnExponentToGGXRoughness( const in float blinnExponent ) {\n\treturn sqrt( 2.0 / ( blinnExponent + 2.0 ) );\n}\n#if defined( USE_SHEEN )\nfloat D_Charlie(float roughness, float NoH) {\n\tfloat invAlpha = 1.0 / roughness;\n\tfloat cos2h = NoH * NoH;\n\tfloat sin2h = max(1.0 - cos2h, 0.0078125);\treturn (2.0 + invAlpha) * pow(sin2h, invAlpha * 0.5) / (2.0 * PI);\n}\nfloat V_Neubelt(float NoV, float NoL) {\n\treturn saturate(1.0 / (4.0 * (NoL + NoV - NoL * NoV)));\n}\nvec3 BRDF_Specular_Sheen( const in float roughness, const in vec3 L, const in GeometricContext geometry, vec3 specularColor ) {\n\tvec3 N = geometry.normal;\n\tvec3 V = geometry.viewDir;\n\tvec3 H = normalize( V + L );\n\tfloat dotNH = saturate( dot( N, H ) );\n\treturn specularColor * D_Charlie( roughness, dotNH ) * V_Neubelt( dot(N, V), dot(N, L) );\n}\n#endif",bumpmap_pars_fragment:"#ifdef USE_BUMPMAP\n\tuniform sampler2D bumpMap;\n\tuniform float bumpScale;\n\tvec2 dHdxy_fwd() {\n\t\tvec2 dSTdx = dFdx( vUv );\n\t\tvec2 dSTdy = dFdy( vUv );\n\t\tfloat Hll = bumpScale * texture2D( bumpMap, vUv ).x;\n\t\tfloat dBx = bumpScale * texture2D( bumpMap, vUv + dSTdx ).x - Hll;\n\t\tfloat dBy = bumpScale * texture2D( bumpMap, vUv + dSTdy ).x - Hll;\n\t\treturn vec2( dBx, dBy );\n\t}\n\tvec3 perturbNormalArb( vec3 surf_pos, vec3 surf_norm, vec2 dHdxy ) {\n\t\tvec3 vSigmaX = vec3( dFdx( surf_pos.x ), dFdx( surf_pos.y ), dFdx( surf_pos.z ) );\n\t\tvec3 vSigmaY = vec3( dFdy( surf_pos.x ), dFdy( surf_pos.y ), dFdy( surf_pos.z ) );\n\t\tvec3 vN = surf_norm;\n\t\tvec3 R1 = cross( vSigmaY, vN );\n\t\tvec3 R2 = cross( vN, vSigmaX );\n\t\tfloat fDet = dot( vSigmaX, R1 );\n\t\tfDet *= ( float( gl_FrontFacing ) * 2.0 - 1.0 );\n\t\tvec3 vGrad = sign( fDet ) * ( dHdxy.x * R1 + dHdxy.y * R2 );\n\t\treturn normalize( abs( fDet ) * surf_norm - vGrad );\n\t}\n#endif",clipping_planes_fragment:"#if NUM_CLIPPING_PLANES > 0\n\tvec4 plane;\n\t#pragma unroll_loop_start\n\tfor ( int i = 0; i < UNION_CLIPPING_PLANES; i ++ ) {\n\t\tplane = clippingPlanes[ i ];\n\t\tif ( dot( vClipPosition, plane.xyz ) > plane.w ) discard;\n\t}\n\t#pragma unroll_loop_end\n\t#if UNION_CLIPPING_PLANES < NUM_CLIPPING_PLANES\n\t\tbool clipped = true;\n\t\t#pragma unroll_loop_start\n\t\tfor ( int i = UNION_CLIPPING_PLANES; i < NUM_CLIPPING_PLANES; i ++ ) {\n\t\t\tplane = clippingPlanes[ i ];\n\t\t\tclipped = ( dot( vClipPosition, plane.xyz ) > plane.w ) && clipped;\n\t\t}\n\t\t#pragma unroll_loop_end\n\t\tif ( clipped ) discard;\n\t#endif\n#endif",clipping_planes_pars_fragment:"#if NUM_CLIPPING_PLANES > 0\n\tvarying vec3 vClipPosition;\n\tuniform vec4 clippingPlanes[ NUM_CLIPPING_PLANES ];\n#endif",clipping_planes_pars_vertex:"#if NUM_CLIPPING_PLANES > 0\n\tvarying vec3 vClipPosition;\n#endif",clipping_planes_vertex:"#if NUM_CLIPPING_PLANES > 0\n\tvClipPosition = - mvPosition.xyz;\n#endif",color_fragment:"#ifdef USE_COLOR\n\tdiffuseColor.rgb *= vColor;\n#endif",color_pars_fragment:"#ifdef USE_COLOR\n\tvarying vec3 vColor;\n#endif",color_pars_vertex:"#if defined( USE_COLOR ) || defined( USE_INSTANCING_COLOR )\n\tvarying vec3 vColor;\n#endif",color_vertex:"#if defined( USE_COLOR ) || defined( USE_INSTANCING_COLOR )\n\tvColor = vec3( 1.0 );\n#endif\n#ifdef USE_COLOR\n\tvColor.xyz *= color.xyz;\n#endif\n#ifdef USE_INSTANCING_COLOR\n\tvColor.xyz *= instanceColor.xyz;\n#endif",common:"#define PI 3.141592653589793\n#define PI2 6.283185307179586\n#define PI_HALF 1.5707963267948966\n#define RECIPROCAL_PI 0.3183098861837907\n#define RECIPROCAL_PI2 0.15915494309189535\n#define EPSILON 1e-6\n#ifndef saturate\n#define saturate(a) clamp( a, 0.0, 1.0 )\n#endif\n#define whiteComplement(a) ( 1.0 - saturate( a ) )\nfloat pow2( const in float x ) { return x*x; }\nfloat pow3( const in float x ) { return x*x*x; }\nfloat pow4( const in float x ) { float x2 = x*x; return x2*x2; }\nfloat average( const in vec3 color ) { return dot( color, vec3( 0.3333 ) ); }\nhighp float rand( const in vec2 uv ) {\n\tconst highp float a = 12.9898, b = 78.233, c = 43758.5453;\n\thighp float dt = dot( uv.xy, vec2( a,b ) ), sn = mod( dt, PI );\n\treturn fract(sin(sn) * c);\n}\n#ifdef HIGH_PRECISION\n\tfloat precisionSafeLength( vec3 v ) { return length( v ); }\n#else\n\tfloat max3( vec3 v ) { return max( max( v.x, v.y ), v.z ); }\n\tfloat precisionSafeLength( vec3 v ) {\n\t\tfloat maxComponent = max3( abs( v ) );\n\t\treturn length( v / maxComponent ) * maxComponent;\n\t}\n#endif\nstruct IncidentLight {\n\tvec3 color;\n\tvec3 direction;\n\tbool visible;\n};\nstruct ReflectedLight {\n\tvec3 directDiffuse;\n\tvec3 directSpecular;\n\tvec3 indirectDiffuse;\n\tvec3 indirectSpecular;\n};\nstruct GeometricContext {\n\tvec3 position;\n\tvec3 normal;\n\tvec3 viewDir;\n#ifdef CLEARCOAT\n\tvec3 clearcoatNormal;\n#endif\n};\nvec3 transformDirection( in vec3 dir, in mat4 matrix ) {\n\treturn normalize( ( matrix * vec4( dir, 0.0 ) ).xyz );\n}\nvec3 inverseTransformDirection( in vec3 dir, in mat4 matrix ) {\n\treturn normalize( ( vec4( dir, 0.0 ) * matrix ).xyz );\n}\nvec3 projectOnPlane(in vec3 point, in vec3 pointOnPlane, in vec3 planeNormal ) {\n\tfloat distance = dot( planeNormal, point - pointOnPlane );\n\treturn - distance * planeNormal + point;\n}\nfloat sideOfPlane( in vec3 point, in vec3 pointOnPlane, in vec3 planeNormal ) {\n\treturn sign( dot( point - pointOnPlane, planeNormal ) );\n}\nvec3 linePlaneIntersect( in vec3 pointOnLine, in vec3 lineDirection, in vec3 pointOnPlane, in vec3 planeNormal ) {\n\treturn lineDirection * ( dot( planeNormal, pointOnPlane - pointOnLine ) / dot( planeNormal, lineDirection ) ) + pointOnLine;\n}\nmat3 transposeMat3( const in mat3 m ) {\n\tmat3 tmp;\n\ttmp[ 0 ] = vec3( m[ 0 ].x, m[ 1 ].x, m[ 2 ].x );\n\ttmp[ 1 ] = vec3( m[ 0 ].y, m[ 1 ].y, m[ 2 ].y );\n\ttmp[ 2 ] = vec3( m[ 0 ].z, m[ 1 ].z, m[ 2 ].z );\n\treturn tmp;\n}\nfloat linearToRelativeLuminance( const in vec3 color ) {\n\tvec3 weights = vec3( 0.2126, 0.7152, 0.0722 );\n\treturn dot( weights, color.rgb );\n}\nbool isPerspectiveMatrix( mat4 m ) {\n\treturn m[ 2 ][ 3 ] == - 1.0;\n}\nvec2 equirectUv( in vec3 dir ) {\n\tfloat u = atan( dir.z, dir.x ) * RECIPROCAL_PI2 + 0.5;\n\tfloat v = asin( clamp( dir.y, - 1.0, 1.0 ) ) * RECIPROCAL_PI + 0.5;\n\treturn vec2( u, v );\n}",cube_uv_reflection_fragment:"#ifdef ENVMAP_TYPE_CUBE_UV\n\t#define cubeUV_maxMipLevel 8.0\n\t#define cubeUV_minMipLevel 4.0\n\t#define cubeUV_maxTileSize 256.0\n\t#define cubeUV_minTileSize 16.0\n\tfloat getFace( vec3 direction ) {\n\t\tvec3 absDirection = abs( direction );\n\t\tfloat face = - 1.0;\n\t\tif ( absDirection.x > absDirection.z ) {\n\t\t\tif ( absDirection.x > absDirection.y )\n\t\t\t\tface = direction.x > 0.0 ? 0.0 : 3.0;\n\t\t\telse\n\t\t\t\tface = direction.y > 0.0 ? 1.0 : 4.0;\n\t\t} else {\n\t\t\tif ( absDirection.z > absDirection.y )\n\t\t\t\tface = direction.z > 0.0 ? 2.0 : 5.0;\n\t\t\telse\n\t\t\t\tface = direction.y > 0.0 ? 1.0 : 4.0;\n\t\t}\n\t\treturn face;\n\t}\n\tvec2 getUV( vec3 direction, float face ) {\n\t\tvec2 uv;\n\t\tif ( face == 0.0 ) {\n\t\t\tuv = vec2( direction.z, direction.y ) / abs( direction.x );\n\t\t} else if ( face == 1.0 ) {\n\t\t\tuv = vec2( - direction.x, - direction.z ) / abs( direction.y );\n\t\t} else if ( face == 2.0 ) {\n\t\t\tuv = vec2( - direction.x, direction.y ) / abs( direction.z );\n\t\t} else if ( face == 3.0 ) {\n\t\t\tuv = vec2( - direction.z, direction.y ) / abs( direction.x );\n\t\t} else if ( face == 4.0 ) {\n\t\t\tuv = vec2( - direction.x, direction.z ) / abs( direction.y );\n\t\t} else {\n\t\t\tuv = vec2( direction.x, direction.y ) / abs( direction.z );\n\t\t}\n\t\treturn 0.5 * ( uv + 1.0 );\n\t}\n\tvec3 bilinearCubeUV( sampler2D envMap, vec3 direction, float mipInt ) {\n\t\tfloat face = getFace( direction );\n\t\tfloat filterInt = max( cubeUV_minMipLevel - mipInt, 0.0 );\n\t\tmipInt = max( mipInt, cubeUV_minMipLevel );\n\t\tfloat faceSize = exp2( mipInt );\n\t\tfloat texelSize = 1.0 / ( 3.0 * cubeUV_maxTileSize );\n\t\tvec2 uv = getUV( direction, face ) * ( faceSize - 1.0 );\n\t\tvec2 f = fract( uv );\n\t\tuv += 0.5 - f;\n\t\tif ( face > 2.0 ) {\n\t\t\tuv.y += faceSize;\n\t\t\tface -= 3.0;\n\t\t}\n\t\tuv.x += face * faceSize;\n\t\tif ( mipInt < cubeUV_maxMipLevel ) {\n\t\t\tuv.y += 2.0 * cubeUV_maxTileSize;\n\t\t}\n\t\tuv.y += filterInt * 2.0 * cubeUV_minTileSize;\n\t\tuv.x += 3.0 * max( 0.0, cubeUV_maxTileSize - 2.0 * faceSize );\n\t\tuv *= texelSize;\n\t\tvec3 tl = envMapTexelToLinear( texture2D( envMap, uv ) ).rgb;\n\t\tuv.x += texelSize;\n\t\tvec3 tr = envMapTexelToLinear( texture2D( envMap, uv ) ).rgb;\n\t\tuv.y += texelSize;\n\t\tvec3 br = envMapTexelToLinear( texture2D( envMap, uv ) ).rgb;\n\t\tuv.x -= texelSize;\n\t\tvec3 bl = envMapTexelToLinear( texture2D( envMap, uv ) ).rgb;\n\t\tvec3 tm = mix( tl, tr, f.x );\n\t\tvec3 bm = mix( bl, br, f.x );\n\t\treturn mix( tm, bm, f.y );\n\t}\n\t#define r0 1.0\n\t#define v0 0.339\n\t#define m0 - 2.0\n\t#define r1 0.8\n\t#define v1 0.276\n\t#define m1 - 1.0\n\t#define r4 0.4\n\t#define v4 0.046\n\t#define m4 2.0\n\t#define r5 0.305\n\t#define v5 0.016\n\t#define m5 3.0\n\t#define r6 0.21\n\t#define v6 0.0038\n\t#define m6 4.0\n\tfloat roughnessToMip( float roughness ) {\n\t\tfloat mip = 0.0;\n\t\tif ( roughness >= r1 ) {\n\t\t\tmip = ( r0 - roughness ) * ( m1 - m0 ) / ( r0 - r1 ) + m0;\n\t\t} else if ( roughness >= r4 ) {\n\t\t\tmip = ( r1 - roughness ) * ( m4 - m1 ) / ( r1 - r4 ) + m1;\n\t\t} else if ( roughness >= r5 ) {\n\t\t\tmip = ( r4 - roughness ) * ( m5 - m4 ) / ( r4 - r5 ) + m4;\n\t\t} else if ( roughness >= r6 ) {\n\t\t\tmip = ( r5 - roughness ) * ( m6 - m5 ) / ( r5 - r6 ) + m5;\n\t\t} else {\n\t\t\tmip = - 2.0 * log2( 1.16 * roughness );\t\t}\n\t\treturn mip;\n\t}\n\tvec4 textureCubeUV( sampler2D envMap, vec3 sampleDir, float roughness ) {\n\t\tfloat mip = clamp( roughnessToMip( roughness ), m0, cubeUV_maxMipLevel );\n\t\tfloat mipF = fract( mip );\n\t\tfloat mipInt = floor( mip );\n\t\tvec3 color0 = bilinearCubeUV( envMap, sampleDir, mipInt );\n\t\tif ( mipF == 0.0 ) {\n\t\t\treturn vec4( color0, 1.0 );\n\t\t} else {\n\t\t\tvec3 color1 = bilinearCubeUV( envMap, sampleDir, mipInt + 1.0 );\n\t\t\treturn vec4( mix( color0, color1, mipF ), 1.0 );\n\t\t}\n\t}\n#endif",defaultnormal_vertex:"vec3 transformedNormal = objectNormal;\n#ifdef USE_INSTANCING\n\tmat3 m = mat3( instanceMatrix );\n\ttransformedNormal /= vec3( dot( m[ 0 ], m[ 0 ] ), dot( m[ 1 ], m[ 1 ] ), dot( m[ 2 ], m[ 2 ] ) );\n\ttransformedNormal = m * transformedNormal;\n#endif\ntransformedNormal = normalMatrix * transformedNormal;\n#ifdef FLIP_SIDED\n\ttransformedNormal = - transformedNormal;\n#endif\n#ifdef USE_TANGENT\n\tvec3 transformedTangent = ( modelViewMatrix * vec4( objectTangent, 0.0 ) ).xyz;\n\t#ifdef FLIP_SIDED\n\t\ttransformedTangent = - transformedTangent;\n\t#endif\n#endif",displacementmap_pars_vertex:"#ifdef USE_DISPLACEMENTMAP\n\tuniform sampler2D displacementMap;\n\tuniform float displacementScale;\n\tuniform float displacementBias;\n#endif",displacementmap_vertex:"#ifdef USE_DISPLACEMENTMAP\n\ttransformed += normalize( objectNormal ) * ( texture2D( displacementMap, vUv ).x * displacementScale + displacementBias );\n#endif",emissivemap_fragment:"#ifdef USE_EMISSIVEMAP\n\tvec4 emissiveColor = texture2D( emissiveMap, vUv );\n\temissiveColor.rgb = emissiveMapTexelToLinear( emissiveColor ).rgb;\n\ttotalEmissiveRadiance *= emissiveColor.rgb;\n#endif",emissivemap_pars_fragment:"#ifdef USE_EMISSIVEMAP\n\tuniform sampler2D emissiveMap;\n#endif",encodings_fragment:"gl_FragColor = linearToOutputTexel( gl_FragColor );",encodings_pars_fragment:"\nvec4 LinearToLinear( in vec4 value ) {\n\treturn value;\n}\nvec4 GammaToLinear( in vec4 value, in float gammaFactor ) {\n\treturn vec4( pow( value.rgb, vec3( gammaFactor ) ), value.a );\n}\nvec4 LinearToGamma( in vec4 value, in float gammaFactor ) {\n\treturn vec4( pow( value.rgb, vec3( 1.0 / gammaFactor ) ), value.a );\n}\nvec4 sRGBToLinear( in vec4 value ) {\n\treturn vec4( mix( pow( value.rgb * 0.9478672986 + vec3( 0.0521327014 ), vec3( 2.4 ) ), value.rgb * 0.0773993808, vec3( lessThanEqual( value.rgb, vec3( 0.04045 ) ) ) ), value.a );\n}\nvec4 LinearTosRGB( in vec4 value ) {\n\treturn vec4( mix( pow( value.rgb, vec3( 0.41666 ) ) * 1.055 - vec3( 0.055 ), value.rgb * 12.92, vec3( lessThanEqual( value.rgb, vec3( 0.0031308 ) ) ) ), value.a );\n}\nvec4 RGBEToLinear( in vec4 value ) {\n\treturn vec4( value.rgb * exp2( value.a * 255.0 - 128.0 ), 1.0 );\n}\nvec4 LinearToRGBE( in vec4 value ) {\n\tfloat maxComponent = max( max( value.r, value.g ), value.b );\n\tfloat fExp = clamp( ceil( log2( maxComponent ) ), -128.0, 127.0 );\n\treturn vec4( value.rgb / exp2( fExp ), ( fExp + 128.0 ) / 255.0 );\n}\nvec4 RGBMToLinear( in vec4 value, in float maxRange ) {\n\treturn vec4( value.rgb * value.a * maxRange, 1.0 );\n}\nvec4 LinearToRGBM( in vec4 value, in float maxRange ) {\n\tfloat maxRGB = max( value.r, max( value.g, value.b ) );\n\tfloat M = clamp( maxRGB / maxRange, 0.0, 1.0 );\n\tM = ceil( M * 255.0 ) / 255.0;\n\treturn vec4( value.rgb / ( M * maxRange ), M );\n}\nvec4 RGBDToLinear( in vec4 value, in float maxRange ) {\n\treturn vec4( value.rgb * ( ( maxRange / 255.0 ) / value.a ), 1.0 );\n}\nvec4 LinearToRGBD( in vec4 value, in float maxRange ) {\n\tfloat maxRGB = max( value.r, max( value.g, value.b ) );\n\tfloat D = max( maxRange / maxRGB, 1.0 );\n\tD = clamp( floor( D ) / 255.0, 0.0, 1.0 );\n\treturn vec4( value.rgb * ( D * ( 255.0 / maxRange ) ), D );\n}\nconst mat3 cLogLuvM = mat3( 0.2209, 0.3390, 0.4184, 0.1138, 0.6780, 0.7319, 0.0102, 0.1130, 0.2969 );\nvec4 LinearToLogLuv( in vec4 value ) {\n\tvec3 Xp_Y_XYZp = cLogLuvM * value.rgb;\n\tXp_Y_XYZp = max( Xp_Y_XYZp, vec3( 1e-6, 1e-6, 1e-6 ) );\n\tvec4 vResult;\n\tvResult.xy = Xp_Y_XYZp.xy / Xp_Y_XYZp.z;\n\tfloat Le = 2.0 * log2(Xp_Y_XYZp.y) + 127.0;\n\tvResult.w = fract( Le );\n\tvResult.z = ( Le - ( floor( vResult.w * 255.0 ) ) / 255.0 ) / 255.0;\n\treturn vResult;\n}\nconst mat3 cLogLuvInverseM = mat3( 6.0014, -2.7008, -1.7996, -1.3320, 3.1029, -5.7721, 0.3008, -1.0882, 5.6268 );\nvec4 LogLuvToLinear( in vec4 value ) {\n\tfloat Le = value.z * 255.0 + value.w;\n\tvec3 Xp_Y_XYZp;\n\tXp_Y_XYZp.y = exp2( ( Le - 127.0 ) / 2.0 );\n\tXp_Y_XYZp.z = Xp_Y_XYZp.y / value.y;\n\tXp_Y_XYZp.x = value.x * Xp_Y_XYZp.z;\n\tvec3 vRGB = cLogLuvInverseM * Xp_Y_XYZp.rgb;\n\treturn vec4( max( vRGB, 0.0 ), 1.0 );\n}",envmap_fragment:"#ifdef USE_ENVMAP\n\t#ifdef ENV_WORLDPOS\n\t\tvec3 cameraToFrag;\n\t\tif ( isOrthographic ) {\n\t\t\tcameraToFrag = normalize( vec3( - viewMatrix[ 0 ][ 2 ], - viewMatrix[ 1 ][ 2 ], - viewMatrix[ 2 ][ 2 ] ) );\n\t\t} else {\n\t\t\tcameraToFrag = normalize( vWorldPosition - cameraPosition );\n\t\t}\n\t\tvec3 worldNormal = inverseTransformDirection( normal, viewMatrix );\n\t\t#ifdef ENVMAP_MODE_REFLECTION\n\t\t\tvec3 reflectVec = reflect( cameraToFrag, worldNormal );\n\t\t#else\n\t\t\tvec3 reflectVec = refract( cameraToFrag, worldNormal, refractionRatio );\n\t\t#endif\n\t#else\n\t\tvec3 reflectVec = vReflect;\n\t#endif\n\t#ifdef ENVMAP_TYPE_CUBE\n\t\tvec4 envColor = textureCube( envMap, vec3( flipEnvMap * reflectVec.x, reflectVec.yz ) );\n\t#elif defined( ENVMAP_TYPE_CUBE_UV )\n\t\tvec4 envColor = textureCubeUV( envMap, reflectVec, 0.0 );\n\t#else\n\t\tvec4 envColor = vec4( 0.0 );\n\t#endif\n\t#ifndef ENVMAP_TYPE_CUBE_UV\n\t\tenvColor = envMapTexelToLinear( envColor );\n\t#endif\n\t#ifdef ENVMAP_BLENDING_MULTIPLY\n\t\toutgoingLight = mix( outgoingLight, outgoingLight * envColor.xyz, specularStrength * reflectivity );\n\t#elif defined( ENVMAP_BLENDING_MIX )\n\t\toutgoingLight = mix( outgoingLight, envColor.xyz, specularStrength * reflectivity );\n\t#elif defined( ENVMAP_BLENDING_ADD )\n\t\toutgoingLight += envColor.xyz * specularStrength * reflectivity;\n\t#endif\n#endif",envmap_common_pars_fragment:"#ifdef USE_ENVMAP\n\tuniform float envMapIntensity;\n\tuniform float flipEnvMap;\n\tuniform int maxMipLevel;\n\t#ifdef ENVMAP_TYPE_CUBE\n\t\tuniform samplerCube envMap;\n\t#else\n\t\tuniform sampler2D envMap;\n\t#endif\n\t\n#endif",envmap_pars_fragment:"#ifdef USE_ENVMAP\n\tuniform float reflectivity;\n\t#if defined( USE_BUMPMAP ) || defined( USE_NORMALMAP ) || defined( PHONG )\n\t\t#define ENV_WORLDPOS\n\t#endif\n\t#ifdef ENV_WORLDPOS\n\t\tvarying vec3 vWorldPosition;\n\t\tuniform float refractionRatio;\n\t#else\n\t\tvarying vec3 vReflect;\n\t#endif\n#endif",envmap_pars_vertex:"#ifdef USE_ENVMAP\n\t#if defined( USE_BUMPMAP ) || defined( USE_NORMALMAP ) ||defined( PHONG )\n\t\t#define ENV_WORLDPOS\n\t#endif\n\t#ifdef ENV_WORLDPOS\n\t\t\n\t\tvarying vec3 vWorldPosition;\n\t#else\n\t\tvarying vec3 vReflect;\n\t\tuniform float refractionRatio;\n\t#endif\n#endif",envmap_physical_pars_fragment:"#if defined( USE_ENVMAP )\n\t#ifdef ENVMAP_MODE_REFRACTION\n\t\tuniform float refractionRatio;\n\t#endif\n\tvec3 getLightProbeIndirectIrradiance( const in GeometricContext geometry, const in int maxMIPLevel ) {\n\t\tvec3 worldNormal = inverseTransformDirection( geometry.normal, viewMatrix );\n\t\t#ifdef ENVMAP_TYPE_CUBE\n\t\t\tvec3 queryVec = vec3( flipEnvMap * worldNormal.x, worldNormal.yz );\n\t\t\t#ifdef TEXTURE_LOD_EXT\n\t\t\t\tvec4 envMapColor = textureCubeLodEXT( envMap, queryVec, float( maxMIPLevel ) );\n\t\t\t#else\n\t\t\t\tvec4 envMapColor = textureCube( envMap, queryVec, float( maxMIPLevel ) );\n\t\t\t#endif\n\t\t\tenvMapColor.rgb = envMapTexelToLinear( envMapColor ).rgb;\n\t\t#elif defined( ENVMAP_TYPE_CUBE_UV )\n\t\t\tvec4 envMapColor = textureCubeUV( envMap, worldNormal, 1.0 );\n\t\t#else\n\t\t\tvec4 envMapColor = vec4( 0.0 );\n\t\t#endif\n\t\treturn PI * envMapColor.rgb * envMapIntensity;\n\t}\n\tfloat getSpecularMIPLevel( const in float roughness, const in int maxMIPLevel ) {\n\t\tfloat maxMIPLevelScalar = float( maxMIPLevel );\n\t\tfloat sigma = PI * roughness * roughness / ( 1.0 + roughness );\n\t\tfloat desiredMIPLevel = maxMIPLevelScalar + log2( sigma );\n\t\treturn clamp( desiredMIPLevel, 0.0, maxMIPLevelScalar );\n\t}\n\tvec3 getLightProbeIndirectRadiance( const in vec3 viewDir, const in vec3 normal, const in float roughness, const in int maxMIPLevel ) {\n\t\t#ifdef ENVMAP_MODE_REFLECTION\n\t\t\tvec3 reflectVec = reflect( -viewDir, normal );\n\t\t\treflectVec = normalize( mix( reflectVec, normal, roughness * roughness) );\n\t\t#else\n\t\t\tvec3 reflectVec = refract( -viewDir, normal, refractionRatio );\n\t\t#endif\n\t\treflectVec = inverseTransformDirection( reflectVec, viewMatrix );\n\t\tfloat specularMIPLevel = getSpecularMIPLevel( roughness, maxMIPLevel );\n\t\t#ifdef ENVMAP_TYPE_CUBE\n\t\t\tvec3 queryReflectVec = vec3( flipEnvMap * reflectVec.x, reflectVec.yz );\n\t\t\t#ifdef TEXTURE_LOD_EXT\n\t\t\t\tvec4 envMapColor = textureCubeLodEXT( envMap, queryReflectVec, specularMIPLevel );\n\t\t\t#else\n\t\t\t\tvec4 envMapColor = textureCube( envMap, queryReflectVec, specularMIPLevel );\n\t\t\t#endif\n\t\t\tenvMapColor.rgb = envMapTexelToLinear( envMapColor ).rgb;\n\t\t#elif defined( ENVMAP_TYPE_CUBE_UV )\n\t\t\tvec4 envMapColor = textureCubeUV( envMap, reflectVec, roughness );\n\t\t#endif\n\t\treturn envMapColor.rgb * envMapIntensity;\n\t}\n#endif",envmap_vertex:"#ifdef USE_ENVMAP\n\t#ifdef ENV_WORLDPOS\n\t\tvWorldPosition = worldPosition.xyz;\n\t#else\n\t\tvec3 cameraToVertex;\n\t\tif ( isOrthographic ) {\n\t\t\tcameraToVertex = normalize( vec3( - viewMatrix[ 0 ][ 2 ], - viewMatrix[ 1 ][ 2 ], - viewMatrix[ 2 ][ 2 ] ) );\n\t\t} else {\n\t\t\tcameraToVertex = normalize( worldPosition.xyz - cameraPosition );\n\t\t}\n\t\tvec3 worldNormal = inverseTransformDirection( transformedNormal, viewMatrix );\n\t\t#ifdef ENVMAP_MODE_REFLECTION\n\t\t\tvReflect = reflect( cameraToVertex, worldNormal );\n\t\t#else\n\t\t\tvReflect = refract( cameraToVertex, worldNormal, refractionRatio );\n\t\t#endif\n\t#endif\n#endif",fog_vertex:"#ifdef USE_FOG\n\tfogDepth = - mvPosition.z;\n#endif",fog_pars_vertex:"#ifdef USE_FOG\n\tvarying float fogDepth;\n#endif",fog_fragment:"#ifdef USE_FOG\n\t#ifdef FOG_EXP2\n\t\tfloat fogFactor = 1.0 - exp( - fogDensity * fogDensity * fogDepth * fogDepth );\n\t#else\n\t\tfloat fogFactor = smoothstep( fogNear, fogFar, fogDepth );\n\t#endif\n\tgl_FragColor.rgb = mix( gl_FragColor.rgb, fogColor, fogFactor );\n#endif",fog_pars_fragment:"#ifdef USE_FOG\n\tuniform vec3 fogColor;\n\tvarying float fogDepth;\n\t#ifdef FOG_EXP2\n\t\tuniform float fogDensity;\n\t#else\n\t\tuniform float fogNear;\n\t\tuniform float fogFar;\n\t#endif\n#endif",gradientmap_pars_fragment:"#ifdef USE_GRADIENTMAP\n\tuniform sampler2D gradientMap;\n#endif\nvec3 getGradientIrradiance( vec3 normal, vec3 lightDirection ) {\n\tfloat dotNL = dot( normal, lightDirection );\n\tvec2 coord = vec2( dotNL * 0.5 + 0.5, 0.0 );\n\t#ifdef USE_GRADIENTMAP\n\t\treturn texture2D( gradientMap, coord ).rgb;\n\t#else\n\t\treturn ( coord.x < 0.7 ) ? vec3( 0.7 ) : vec3( 1.0 );\n\t#endif\n}",lightmap_fragment:"#ifdef USE_LIGHTMAP\n\tvec4 lightMapTexel= texture2D( lightMap, vUv2 );\n\treflectedLight.indirectDiffuse += PI * lightMapTexelToLinear( lightMapTexel ).rgb * lightMapIntensity;\n#endif",lightmap_pars_fragment:"#ifdef USE_LIGHTMAP\n\tuniform sampler2D lightMap;\n\tuniform float lightMapIntensity;\n#endif",lights_lambert_vertex:"vec3 diffuse = vec3( 1.0 );\nGeometricContext geometry;\ngeometry.position = mvPosition.xyz;\ngeometry.normal = normalize( transformedNormal );\ngeometry.viewDir = ( isOrthographic ) ? vec3( 0, 0, 1 ) : normalize( -mvPosition.xyz );\nGeometricContext backGeometry;\nbackGeometry.position = geometry.position;\nbackGeometry.normal = -geometry.normal;\nbackGeometry.viewDir = geometry.viewDir;\nvLightFront = vec3( 0.0 );\nvIndirectFront = vec3( 0.0 );\n#ifdef DOUBLE_SIDED\n\tvLightBack = vec3( 0.0 );\n\tvIndirectBack = vec3( 0.0 );\n#endif\nIncidentLight directLight;\nfloat dotNL;\nvec3 directLightColor_Diffuse;\nvIndirectFront += getAmbientLightIrradiance( ambientLightColor );\nvIndirectFront += getLightProbeIrradiance( lightProbe, geometry );\n#ifdef DOUBLE_SIDED\n\tvIndirectBack += getAmbientLightIrradiance( ambientLightColor );\n\tvIndirectBack += getLightProbeIrradiance( lightProbe, backGeometry );\n#endif\n#if NUM_POINT_LIGHTS > 0\n\t#pragma unroll_loop_start\n\tfor ( int i = 0; i < NUM_POINT_LIGHTS; i ++ ) {\n\t\tgetPointDirectLightIrradiance( pointLights[ i ], geometry, directLight );\n\t\tdotNL = dot( geometry.normal, directLight.direction );\n\t\tdirectLightColor_Diffuse = PI * directLight.color;\n\t\tvLightFront += saturate( dotNL ) * directLightColor_Diffuse;\n\t\t#ifdef DOUBLE_SIDED\n\t\t\tvLightBack += saturate( -dotNL ) * directLightColor_Diffuse;\n\t\t#endif\n\t}\n\t#pragma unroll_loop_end\n#endif\n#if NUM_SPOT_LIGHTS > 0\n\t#pragma unroll_loop_start\n\tfor ( int i = 0; i < NUM_SPOT_LIGHTS; i ++ ) {\n\t\tgetSpotDirectLightIrradiance( spotLights[ i ], geometry, directLight );\n\t\tdotNL = dot( geometry.normal, directLight.direction );\n\t\tdirectLightColor_Diffuse = PI * directLight.color;\n\t\tvLightFront += saturate( dotNL ) * directLightColor_Diffuse;\n\t\t#ifdef DOUBLE_SIDED\n\t\t\tvLightBack += saturate( -dotNL ) * directLightColor_Diffuse;\n\t\t#endif\n\t}\n\t#pragma unroll_loop_end\n#endif\n#if NUM_DIR_LIGHTS > 0\n\t#pragma unroll_loop_start\n\tfor ( int i = 0; i < NUM_DIR_LIGHTS; i ++ ) {\n\t\tgetDirectionalDirectLightIrradiance( directionalLights[ i ], geometry, directLight );\n\t\tdotNL = dot( geometry.normal, directLight.direction );\n\t\tdirectLightColor_Diffuse = PI * directLight.color;\n\t\tvLightFront += saturate( dotNL ) * directLightColor_Diffuse;\n\t\t#ifdef DOUBLE_SIDED\n\t\t\tvLightBack += saturate( -dotNL ) * directLightColor_Diffuse;\n\t\t#endif\n\t}\n\t#pragma unroll_loop_end\n#endif\n#if NUM_HEMI_LIGHTS > 0\n\t#pragma unroll_loop_start\n\tfor ( int i = 0; i < NUM_HEMI_LIGHTS; i ++ ) {\n\t\tvIndirectFront += getHemisphereLightIrradiance( hemisphereLights[ i ], geometry );\n\t\t#ifdef DOUBLE_SIDED\n\t\t\tvIndirectBack += getHemisphereLightIrradiance( hemisphereLights[ i ], backGeometry );\n\t\t#endif\n\t}\n\t#pragma unroll_loop_end\n#endif",lights_pars_begin:"uniform bool receiveShadow;\nuniform vec3 ambientLightColor;\nuniform vec3 lightProbe[ 9 ];\nvec3 shGetIrradianceAt( in vec3 normal, in vec3 shCoefficients[ 9 ] ) {\n\tfloat x = normal.x, y = normal.y, z = normal.z;\n\tvec3 result = shCoefficients[ 0 ] * 0.886227;\n\tresult += shCoefficients[ 1 ] * 2.0 * 0.511664 * y;\n\tresult += shCoefficients[ 2 ] * 2.0 * 0.511664 * z;\n\tresult += shCoefficients[ 3 ] * 2.0 * 0.511664 * x;\n\tresult += shCoefficients[ 4 ] * 2.0 * 0.429043 * x * y;\n\tresult += shCoefficients[ 5 ] * 2.0 * 0.429043 * y * z;\n\tresult += shCoefficients[ 6 ] * ( 0.743125 * z * z - 0.247708 );\n\tresult += shCoefficients[ 7 ] * 2.0 * 0.429043 * x * z;\n\tresult += shCoefficients[ 8 ] * 0.429043 * ( x * x - y * y );\n\treturn result;\n}\nvec3 getLightProbeIrradiance( const in vec3 lightProbe[ 9 ], const in GeometricContext geometry ) {\n\tvec3 worldNormal = inverseTransformDirection( geometry.normal, viewMatrix );\n\tvec3 irradiance = shGetIrradianceAt( worldNormal, lightProbe );\n\treturn irradiance;\n}\nvec3 getAmbientLightIrradiance( const in vec3 ambientLightColor ) {\n\tvec3 irradiance = ambientLightColor;\n\t#ifndef PHYSICALLY_CORRECT_LIGHTS\n\t\tirradiance *= PI;\n\t#endif\n\treturn irradiance;\n}\n#if NUM_DIR_LIGHTS > 0\n\tstruct DirectionalLight {\n\t\tvec3 direction;\n\t\tvec3 color;\n\t};\n\tuniform DirectionalLight directionalLights[ NUM_DIR_LIGHTS ];\n\tvoid getDirectionalDirectLightIrradiance( const in DirectionalLight directionalLight, const in GeometricContext geometry, out IncidentLight directLight ) {\n\t\tdirectLight.color = directionalLight.color;\n\t\tdirectLight.direction = directionalLight.direction;\n\t\tdirectLight.visible = true;\n\t}\n#endif\n#if NUM_POINT_LIGHTS > 0\n\tstruct PointLight {\n\t\tvec3 position;\n\t\tvec3 color;\n\t\tfloat distance;\n\t\tfloat decay;\n\t};\n\tuniform PointLight pointLights[ NUM_POINT_LIGHTS ];\n\tvoid getPointDirectLightIrradiance( const in PointLight pointLight, const in GeometricContext geometry, out IncidentLight directLight ) {\n\t\tvec3 lVector = pointLight.position - geometry.position;\n\t\tdirectLight.direction = normalize( lVector );\n\t\tfloat lightDistance = length( lVector );\n\t\tdirectLight.color = pointLight.color;\n\t\tdirectLight.color *= punctualLightIntensityToIrradianceFactor( lightDistance, pointLight.distance, pointLight.decay );\n\t\tdirectLight.visible = ( directLight.color != vec3( 0.0 ) );\n\t}\n#endif\n#if NUM_SPOT_LIGHTS > 0\n\tstruct SpotLight {\n\t\tvec3 position;\n\t\tvec3 direction;\n\t\tvec3 color;\n\t\tfloat distance;\n\t\tfloat decay;\n\t\tfloat coneCos;\n\t\tfloat penumbraCos;\n\t};\n\tuniform SpotLight spotLights[ NUM_SPOT_LIGHTS ];\n\tvoid getSpotDirectLightIrradiance( const in SpotLight spotLight, const in GeometricContext geometry, out IncidentLight directLight ) {\n\t\tvec3 lVector = spotLight.position - geometry.position;\n\t\tdirectLight.direction = normalize( lVector );\n\t\tfloat lightDistance = length( lVector );\n\t\tfloat angleCos = dot( directLight.direction, spotLight.direction );\n\t\tif ( angleCos > spotLight.coneCos ) {\n\t\t\tfloat spotEffect = smoothstep( spotLight.coneCos, spotLight.penumbraCos, angleCos );\n\t\t\tdirectLight.color = spotLight.color;\n\t\t\tdirectLight.color *= spotEffect * punctualLightIntensityToIrradianceFactor( lightDistance, spotLight.distance, spotLight.decay );\n\t\t\tdirectLight.visible = true;\n\t\t} else {\n\t\t\tdirectLight.color = vec3( 0.0 );\n\t\t\tdirectLight.visible = false;\n\t\t}\n\t}\n#endif\n#if NUM_RECT_AREA_LIGHTS > 0\n\tstruct RectAreaLight {\n\t\tvec3 color;\n\t\tvec3 position;\n\t\tvec3 halfWidth;\n\t\tvec3 halfHeight;\n\t};\n\tuniform sampler2D ltc_1;\tuniform sampler2D ltc_2;\n\tuniform RectAreaLight rectAreaLights[ NUM_RECT_AREA_LIGHTS ];\n#endif\n#if NUM_HEMI_LIGHTS > 0\n\tstruct HemisphereLight {\n\t\tvec3 direction;\n\t\tvec3 skyColor;\n\t\tvec3 groundColor;\n\t};\n\tuniform HemisphereLight hemisphereLights[ NUM_HEMI_LIGHTS ];\n\tvec3 getHemisphereLightIrradiance( const in HemisphereLight hemiLight, const in GeometricContext geometry ) {\n\t\tfloat dotNL = dot( geometry.normal, hemiLight.direction );\n\t\tfloat hemiDiffuseWeight = 0.5 * dotNL + 0.5;\n\t\tvec3 irradiance = mix( hemiLight.groundColor, hemiLight.skyColor, hemiDiffuseWeight );\n\t\t#ifndef PHYSICALLY_CORRECT_LIGHTS\n\t\t\tirradiance *= PI;\n\t\t#endif\n\t\treturn irradiance;\n\t}\n#endif",lights_toon_fragment:"ToonMaterial material;\nmaterial.diffuseColor = diffuseColor.rgb;",lights_toon_pars_fragment:"varying vec3 vViewPosition;\n#ifndef FLAT_SHADED\n\tvarying vec3 vNormal;\n#endif\nstruct ToonMaterial {\n\tvec3 diffuseColor;\n};\nvoid RE_Direct_Toon( const in IncidentLight directLight, const in GeometricContext geometry, const in ToonMaterial material, inout ReflectedLight reflectedLight ) {\n\tvec3 irradiance = getGradientIrradiance( geometry.normal, directLight.direction ) * directLight.color;\n\t#ifndef PHYSICALLY_CORRECT_LIGHTS\n\t\tirradiance *= PI;\n\t#endif\n\treflectedLight.directDiffuse += irradiance * BRDF_Diffuse_Lambert( material.diffuseColor );\n}\nvoid RE_IndirectDiffuse_Toon( const in vec3 irradiance, const in GeometricContext geometry, const in ToonMaterial material, inout ReflectedLight reflectedLight ) {\n\treflectedLight.indirectDiffuse += irradiance * BRDF_Diffuse_Lambert( material.diffuseColor );\n}\n#define RE_Direct\t\t\t\tRE_Direct_Toon\n#define RE_IndirectDiffuse\t\tRE_IndirectDiffuse_Toon\n#define Material_LightProbeLOD( material )\t(0)",lights_phong_fragment:"BlinnPhongMaterial material;\nmaterial.diffuseColor = diffuseColor.rgb;\nmaterial.specularColor = specular;\nmaterial.specularShininess = shininess;\nmaterial.specularStrength = specularStrength;",lights_phong_pars_fragment:"varying vec3 vViewPosition;\n#ifndef FLAT_SHADED\n\tvarying vec3 vNormal;\n#endif\nstruct BlinnPhongMaterial {\n\tvec3 diffuseColor;\n\tvec3 specularColor;\n\tfloat specularShininess;\n\tfloat specularStrength;\n};\nvoid RE_Direct_BlinnPhong( const in IncidentLight directLight, const in GeometricContext geometry, const in BlinnPhongMaterial material, inout ReflectedLight reflectedLight ) {\n\tfloat dotNL = saturate( dot( geometry.normal, directLight.direction ) );\n\tvec3 irradiance = dotNL * directLight.color;\n\t#ifndef PHYSICALLY_CORRECT_LIGHTS\n\t\tirradiance *= PI;\n\t#endif\n\treflectedLight.directDiffuse += irradiance * BRDF_Diffuse_Lambert( material.diffuseColor );\n\treflectedLight.directSpecular += irradiance * BRDF_Specular_BlinnPhong( directLight, geometry, material.specularColor, material.specularShininess ) * material.specularStrength;\n}\nvoid RE_IndirectDiffuse_BlinnPhong( const in vec3 irradiance, const in GeometricContext geometry, const in BlinnPhongMaterial material, inout ReflectedLight reflectedLight ) {\n\treflectedLight.indirectDiffuse += irradiance * BRDF_Diffuse_Lambert( material.diffuseColor );\n}\n#define RE_Direct\t\t\t\tRE_Direct_BlinnPhong\n#define RE_IndirectDiffuse\t\tRE_IndirectDiffuse_BlinnPhong\n#define Material_LightProbeLOD( material )\t(0)",lights_physical_fragment:"PhysicalMaterial material;\nmaterial.diffuseColor = diffuseColor.rgb * ( 1.0 - metalnessFactor );\nvec3 dxy = max( abs( dFdx( geometryNormal ) ), abs( dFdy( geometryNormal ) ) );\nfloat geometryRoughness = max( max( dxy.x, dxy.y ), dxy.z );\nmaterial.specularRoughness = max( roughnessFactor, 0.0525 );material.specularRoughness += geometryRoughness;\nmaterial.specularRoughness = min( material.specularRoughness, 1.0 );\n#ifdef REFLECTIVITY\n\tmaterial.specularColor = mix( vec3( MAXIMUM_SPECULAR_COEFFICIENT * pow2( reflectivity ) ), diffuseColor.rgb, metalnessFactor );\n#else\n\tmaterial.specularColor = mix( vec3( DEFAULT_SPECULAR_COEFFICIENT ), diffuseColor.rgb, metalnessFactor );\n#endif\n#ifdef CLEARCOAT\n\tmaterial.clearcoat = clearcoat;\n\tmaterial.clearcoatRoughness = clearcoatRoughness;\n\t#ifdef USE_CLEARCOATMAP\n\t\tmaterial.clearcoat *= texture2D( clearcoatMap, vUv ).x;\n\t#endif\n\t#ifdef USE_CLEARCOAT_ROUGHNESSMAP\n\t\tmaterial.clearcoatRoughness *= texture2D( clearcoatRoughnessMap, vUv ).y;\n\t#endif\n\tmaterial.clearcoat = saturate( material.clearcoat );\tmaterial.clearcoatRoughness = max( material.clearcoatRoughness, 0.0525 );\n\tmaterial.clearcoatRoughness += geometryRoughness;\n\tmaterial.clearcoatRoughness = min( material.clearcoatRoughness, 1.0 );\n#endif\n#ifdef USE_SHEEN\n\tmaterial.sheenColor = sheen;\n#endif",lights_physical_pars_fragment:"struct PhysicalMaterial {\n\tvec3 diffuseColor;\n\tfloat specularRoughness;\n\tvec3 specularColor;\n#ifdef CLEARCOAT\n\tfloat clearcoat;\n\tfloat clearcoatRoughness;\n#endif\n#ifdef USE_SHEEN\n\tvec3 sheenColor;\n#endif\n};\n#define MAXIMUM_SPECULAR_COEFFICIENT 0.16\n#define DEFAULT_SPECULAR_COEFFICIENT 0.04\nfloat clearcoatDHRApprox( const in float roughness, const in float dotNL ) {\n\treturn DEFAULT_SPECULAR_COEFFICIENT + ( 1.0 - DEFAULT_SPECULAR_COEFFICIENT ) * ( pow( 1.0 - dotNL, 5.0 ) * pow( 1.0 - roughness, 2.0 ) );\n}\n#if NUM_RECT_AREA_LIGHTS > 0\n\tvoid RE_Direct_RectArea_Physical( const in RectAreaLight rectAreaLight, const in GeometricContext geometry, const in PhysicalMaterial material, inout ReflectedLight reflectedLight ) {\n\t\tvec3 normal = geometry.normal;\n\t\tvec3 viewDir = geometry.viewDir;\n\t\tvec3 position = geometry.position;\n\t\tvec3 lightPos = rectAreaLight.position;\n\t\tvec3 halfWidth = rectAreaLight.halfWidth;\n\t\tvec3 halfHeight = rectAreaLight.halfHeight;\n\t\tvec3 lightColor = rectAreaLight.color;\n\t\tfloat roughness = material.specularRoughness;\n\t\tvec3 rectCoords[ 4 ];\n\t\trectCoords[ 0 ] = lightPos + halfWidth - halfHeight;\t\trectCoords[ 1 ] = lightPos - halfWidth - halfHeight;\n\t\trectCoords[ 2 ] = lightPos - halfWidth + halfHeight;\n\t\trectCoords[ 3 ] = lightPos + halfWidth + halfHeight;\n\t\tvec2 uv = LTC_Uv( normal, viewDir, roughness );\n\t\tvec4 t1 = texture2D( ltc_1, uv );\n\t\tvec4 t2 = texture2D( ltc_2, uv );\n\t\tmat3 mInv = mat3(\n\t\t\tvec3( t1.x, 0, t1.y ),\n\t\t\tvec3(\t\t0, 1,\t\t0 ),\n\t\t\tvec3( t1.z, 0, t1.w )\n\t\t);\n\t\tvec3 fresnel = ( material.specularColor * t2.x + ( vec3( 1.0 ) - material.specularColor ) * t2.y );\n\t\treflectedLight.directSpecular += lightColor * fresnel * LTC_Evaluate( normal, viewDir, position, mInv, rectCoords );\n\t\treflectedLight.directDiffuse += lightColor * material.diffuseColor * LTC_Evaluate( normal, viewDir, position, mat3( 1.0 ), rectCoords );\n\t}\n#endif\nvoid RE_Direct_Physical( const in IncidentLight directLight, const in GeometricContext geometry, const in PhysicalMaterial material, inout ReflectedLight reflectedLight ) {\n\tfloat dotNL = saturate( dot( geometry.normal, directLight.direction ) );\n\tvec3 irradiance = dotNL * directLight.color;\n\t#ifndef PHYSICALLY_CORRECT_LIGHTS\n\t\tirradiance *= PI;\n\t#endif\n\t#ifdef CLEARCOAT\n\t\tfloat ccDotNL = saturate( dot( geometry.clearcoatNormal, directLight.direction ) );\n\t\tvec3 ccIrradiance = ccDotNL * directLight.color;\n\t\t#ifndef PHYSICALLY_CORRECT_LIGHTS\n\t\t\tccIrradiance *= PI;\n\t\t#endif\n\t\tfloat clearcoatDHR = material.clearcoat * clearcoatDHRApprox( material.clearcoatRoughness, ccDotNL );\n\t\treflectedLight.directSpecular += ccIrradiance * material.clearcoat * BRDF_Specular_GGX( directLight, geometry.viewDir, geometry.clearcoatNormal, vec3( DEFAULT_SPECULAR_COEFFICIENT ), material.clearcoatRoughness );\n\t#else\n\t\tfloat clearcoatDHR = 0.0;\n\t#endif\n\t#ifdef USE_SHEEN\n\t\treflectedLight.directSpecular += ( 1.0 - clearcoatDHR ) * irradiance * BRDF_Specular_Sheen(\n\t\t\tmaterial.specularRoughness,\n\t\t\tdirectLight.direction,\n\t\t\tgeometry,\n\t\t\tmaterial.sheenColor\n\t\t);\n\t#else\n\t\treflectedLight.directSpecular += ( 1.0 - clearcoatDHR ) * irradiance * BRDF_Specular_GGX( directLight, geometry.viewDir, geometry.normal, material.specularColor, material.specularRoughness);\n\t#endif\n\treflectedLight.directDiffuse += ( 1.0 - clearcoatDHR ) * irradiance * BRDF_Diffuse_Lambert( material.diffuseColor );\n}\nvoid RE_IndirectDiffuse_Physical( const in vec3 irradiance, const in GeometricContext geometry, const in PhysicalMaterial material, inout ReflectedLight reflectedLight ) {\n\treflectedLight.indirectDiffuse += irradiance * BRDF_Diffuse_Lambert( material.diffuseColor );\n}\nvoid RE_IndirectSpecular_Physical( const in vec3 radiance, const in vec3 irradiance, const in vec3 clearcoatRadiance, const in GeometricContext geometry, const in PhysicalMaterial material, inout ReflectedLight reflectedLight) {\n\t#ifdef CLEARCOAT\n\t\tfloat ccDotNV = saturate( dot( geometry.clearcoatNormal, geometry.viewDir ) );\n\t\treflectedLight.indirectSpecular += clearcoatRadiance * material.clearcoat * BRDF_Specular_GGX_Environment( geometry.viewDir, geometry.clearcoatNormal, vec3( DEFAULT_SPECULAR_COEFFICIENT ), material.clearcoatRoughness );\n\t\tfloat ccDotNL = ccDotNV;\n\t\tfloat clearcoatDHR = material.clearcoat * clearcoatDHRApprox( material.clearcoatRoughness, ccDotNL );\n\t#else\n\t\tfloat clearcoatDHR = 0.0;\n\t#endif\n\tfloat clearcoatInv = 1.0 - clearcoatDHR;\n\tvec3 singleScattering = vec3( 0.0 );\n\tvec3 multiScattering = vec3( 0.0 );\n\tvec3 cosineWeightedIrradiance = irradiance * RECIPROCAL_PI;\n\tBRDF_Specular_Multiscattering_Environment( geometry, material.specularColor, material.specularRoughness, singleScattering, multiScattering );\n\tvec3 diffuse = material.diffuseColor * ( 1.0 - ( singleScattering + multiScattering ) );\n\treflectedLight.indirectSpecular += clearcoatInv * radiance * singleScattering;\n\treflectedLight.indirectSpecular += multiScattering * cosineWeightedIrradiance;\n\treflectedLight.indirectDiffuse += diffuse * cosineWeightedIrradiance;\n}\n#define RE_Direct\t\t\t\tRE_Direct_Physical\n#define RE_Direct_RectArea\t\tRE_Direct_RectArea_Physical\n#define RE_IndirectDiffuse\t\tRE_IndirectDiffuse_Physical\n#define RE_IndirectSpecular\t\tRE_IndirectSpecular_Physical\nfloat computeSpecularOcclusion( const in float dotNV, const in float ambientOcclusion, const in float roughness ) {\n\treturn saturate( pow( dotNV + ambientOcclusion, exp2( - 16.0 * roughness - 1.0 ) ) - 1.0 + ambientOcclusion );\n}",lights_fragment_begin:"\nGeometricContext geometry;\ngeometry.position = - vViewPosition;\ngeometry.normal = normal;\ngeometry.viewDir = ( isOrthographic ) ? vec3( 0, 0, 1 ) : normalize( vViewPosition );\n#ifdef CLEARCOAT\n\tgeometry.clearcoatNormal = clearcoatNormal;\n#endif\nIncidentLight directLight;\n#if ( NUM_POINT_LIGHTS > 0 ) && defined( RE_Direct )\n\tPointLight pointLight;\n\t#if defined( USE_SHADOWMAP ) && NUM_POINT_LIGHT_SHADOWS > 0\n\tPointLightShadow pointLightShadow;\n\t#endif\n\t#pragma unroll_loop_start\n\tfor ( int i = 0; i < NUM_POINT_LIGHTS; i ++ ) {\n\t\tpointLight = pointLights[ i ];\n\t\tgetPointDirectLightIrradiance( pointLight, geometry, directLight );\n\t\t#if defined( USE_SHADOWMAP ) && ( UNROLLED_LOOP_INDEX < NUM_POINT_LIGHT_SHADOWS )\n\t\tpointLightShadow = pointLightShadows[ i ];\n\t\tdirectLight.color *= all( bvec2( directLight.visible, receiveShadow ) ) ? getPointShadow( pointShadowMap[ i ], pointLightShadow.shadowMapSize, pointLightShadow.shadowBias, pointLightShadow.shadowRadius, vPointShadowCoord[ i ], pointLightShadow.shadowCameraNear, pointLightShadow.shadowCameraFar ) : 1.0;\n\t\t#endif\n\t\tRE_Direct( directLight, geometry, material, reflectedLight );\n\t}\n\t#pragma unroll_loop_end\n#endif\n#if ( NUM_SPOT_LIGHTS > 0 ) && defined( RE_Direct )\n\tSpotLight spotLight;\n\t#if defined( USE_SHADOWMAP ) && NUM_SPOT_LIGHT_SHADOWS > 0\n\tSpotLightShadow spotLightShadow;\n\t#endif\n\t#pragma unroll_loop_start\n\tfor ( int i = 0; i < NUM_SPOT_LIGHTS; i ++ ) {\n\t\tspotLight = spotLights[ i ];\n\t\tgetSpotDirectLightIrradiance( spotLight, geometry, directLight );\n\t\t#if defined( USE_SHADOWMAP ) && ( UNROLLED_LOOP_INDEX < NUM_SPOT_LIGHT_SHADOWS )\n\t\tspotLightShadow = spotLightShadows[ i ];\n\t\tdirectLight.color *= all( bvec2( directLight.visible, receiveShadow ) ) ? getShadow( spotShadowMap[ i ], spotLightShadow.shadowMapSize, spotLightShadow.shadowBias, spotLightShadow.shadowRadius, vSpotShadowCoord[ i ] ) : 1.0;\n\t\t#endif\n\t\tRE_Direct( directLight, geometry, material, reflectedLight );\n\t}\n\t#pragma unroll_loop_end\n#endif\n#if ( NUM_DIR_LIGHTS > 0 ) && defined( RE_Direct )\n\tDirectionalLight directionalLight;\n\t#if defined( USE_SHADOWMAP ) && NUM_DIR_LIGHT_SHADOWS > 0\n\tDirectionalLightShadow directionalLightShadow;\n\t#endif\n\t#pragma unroll_loop_start\n\tfor ( int i = 0; i < NUM_DIR_LIGHTS; i ++ ) {\n\t\tdirectionalLight = directionalLights[ i ];\n\t\tgetDirectionalDirectLightIrradiance( directionalLight, geometry, directLight );\n\t\t#if defined( USE_SHADOWMAP ) && ( UNROLLED_LOOP_INDEX < NUM_DIR_LIGHT_SHADOWS )\n\t\tdirectionalLightShadow = directionalLightShadows[ i ];\n\t\tdirectLight.color *= all( bvec2( directLight.visible, receiveShadow ) ) ? getShadow( directionalShadowMap[ i ], directionalLightShadow.shadowMapSize, directionalLightShadow.shadowBias, directionalLightShadow.shadowRadius, vDirectionalShadowCoord[ i ] ) : 1.0;\n\t\t#endif\n\t\tRE_Direct( directLight, geometry, material, reflectedLight );\n\t}\n\t#pragma unroll_loop_end\n#endif\n#if ( NUM_RECT_AREA_LIGHTS > 0 ) && defined( RE_Direct_RectArea )\n\tRectAreaLight rectAreaLight;\n\t#pragma unroll_loop_start\n\tfor ( int i = 0; i < NUM_RECT_AREA_LIGHTS; i ++ ) {\n\t\trectAreaLight = rectAreaLights[ i ];\n\t\tRE_Direct_RectArea( rectAreaLight, geometry, material, reflectedLight );\n\t}\n\t#pragma unroll_loop_end\n#endif\n#if defined( RE_IndirectDiffuse )\n\tvec3 iblIrradiance = vec3( 0.0 );\n\tvec3 irradiance = getAmbientLightIrradiance( ambientLightColor );\n\tirradiance += getLightProbeIrradiance( lightProbe, geometry );\n\t#if ( NUM_HEMI_LIGHTS > 0 )\n\t\t#pragma unroll_loop_start\n\t\tfor ( int i = 0; i < NUM_HEMI_LIGHTS; i ++ ) {\n\t\t\tirradiance += getHemisphereLightIrradiance( hemisphereLights[ i ], geometry );\n\t\t}\n\t\t#pragma unroll_loop_end\n\t#endif\n#endif\n#if defined( RE_IndirectSpecular )\n\tvec3 radiance = vec3( 0.0 );\n\tvec3 clearcoatRadiance = vec3( 0.0 );\n#endif",lights_fragment_maps:"#if defined( RE_IndirectDiffuse )\n\t#ifdef USE_LIGHTMAP\n\t\tvec4 lightMapTexel= texture2D( lightMap, vUv2 );\n\t\tvec3 lightMapIrradiance = lightMapTexelToLinear( lightMapTexel ).rgb * lightMapIntensity;\n\t\t#ifndef PHYSICALLY_CORRECT_LIGHTS\n\t\t\tlightMapIrradiance *= PI;\n\t\t#endif\n\t\tirradiance += lightMapIrradiance;\n\t#endif\n\t#if defined( USE_ENVMAP ) && defined( STANDARD ) && defined( ENVMAP_TYPE_CUBE_UV )\n\t\tiblIrradiance += getLightProbeIndirectIrradiance( geometry, maxMipLevel );\n\t#endif\n#endif\n#if defined( USE_ENVMAP ) && defined( RE_IndirectSpecular )\n\tradiance += getLightProbeIndirectRadiance( geometry.viewDir, geometry.normal, material.specularRoughness, maxMipLevel );\n\t#ifdef CLEARCOAT\n\t\tclearcoatRadiance += getLightProbeIndirectRadiance( geometry.viewDir, geometry.clearcoatNormal, material.clearcoatRoughness, maxMipLevel );\n\t#endif\n#endif",lights_fragment_end:"#if defined( RE_IndirectDiffuse )\n\tRE_IndirectDiffuse( irradiance, geometry, material, reflectedLight );\n#endif\n#if defined( RE_IndirectSpecular )\n\tRE_IndirectSpecular( radiance, iblIrradiance, clearcoatRadiance, geometry, material, reflectedLight );\n#endif",logdepthbuf_fragment:"#if defined( USE_LOGDEPTHBUF ) && defined( USE_LOGDEPTHBUF_EXT )\n\tgl_FragDepthEXT = vIsPerspective == 0.0 ? gl_FragCoord.z : log2( vFragDepth ) * logDepthBufFC * 0.5;\n#endif",logdepthbuf_pars_fragment:"#if defined( USE_LOGDEPTHBUF ) && defined( USE_LOGDEPTHBUF_EXT )\n\tuniform float logDepthBufFC;\n\tvarying float vFragDepth;\n\tvarying float vIsPerspective;\n#endif",logdepthbuf_pars_vertex:"#ifdef USE_LOGDEPTHBUF\n\t#ifdef USE_LOGDEPTHBUF_EXT\n\t\tvarying float vFragDepth;\n\t\tvarying float vIsPerspective;\n\t#else\n\t\tuniform float logDepthBufFC;\n\t#endif\n#endif",logdepthbuf_vertex:"#ifdef USE_LOGDEPTHBUF\n\t#ifdef USE_LOGDEPTHBUF_EXT\n\t\tvFragDepth = 1.0 + gl_Position.w;\n\t\tvIsPerspective = float( isPerspectiveMatrix( projectionMatrix ) );\n\t#else\n\t\tif ( isPerspectiveMatrix( projectionMatrix ) ) {\n\t\t\tgl_Position.z = log2( max( EPSILON, gl_Position.w + 1.0 ) ) * logDepthBufFC - 1.0;\n\t\t\tgl_Position.z *= gl_Position.w;\n\t\t}\n\t#endif\n#endif",map_fragment:"#ifdef USE_MAP\n\tvec4 texelColor = texture2D( map, vUv );\n\ttexelColor = mapTexelToLinear( texelColor );\n\tdiffuseColor *= texelColor;\n#endif",map_pars_fragment:"#ifdef USE_MAP\n\tuniform sampler2D map;\n#endif",map_particle_fragment:"#if defined( USE_MAP ) || defined( USE_ALPHAMAP )\n\tvec2 uv = ( uvTransform * vec3( gl_PointCoord.x, 1.0 - gl_PointCoord.y, 1 ) ).xy;\n#endif\n#ifdef USE_MAP\n\tvec4 mapTexel = texture2D( map, uv );\n\tdiffuseColor *= mapTexelToLinear( mapTexel );\n#endif\n#ifdef USE_ALPHAMAP\n\tdiffuseColor.a *= texture2D( alphaMap, uv ).g;\n#endif",map_particle_pars_fragment:"#if defined( USE_MAP ) || defined( USE_ALPHAMAP )\n\tuniform mat3 uvTransform;\n#endif\n#ifdef USE_MAP\n\tuniform sampler2D map;\n#endif\n#ifdef USE_ALPHAMAP\n\tuniform sampler2D alphaMap;\n#endif",metalnessmap_fragment:"float metalnessFactor = metalness;\n#ifdef USE_METALNESSMAP\n\tvec4 texelMetalness = texture2D( metalnessMap, vUv );\n\tmetalnessFactor *= texelMetalness.b;\n#endif",metalnessmap_pars_fragment:"#ifdef USE_METALNESSMAP\n\tuniform sampler2D metalnessMap;\n#endif",morphnormal_vertex:"#ifdef USE_MORPHNORMALS\n\tobjectNormal *= morphTargetBaseInfluence;\n\tobjectNormal += morphNormal0 * morphTargetInfluences[ 0 ];\n\tobjectNormal += morphNormal1 * morphTargetInfluences[ 1 ];\n\tobjectNormal += morphNormal2 * morphTargetInfluences[ 2 ];\n\tobjectNormal += morphNormal3 * morphTargetInfluences[ 3 ];\n#endif",morphtarget_pars_vertex:"#ifdef USE_MORPHTARGETS\n\tuniform float morphTargetBaseInfluence;\n\t#ifndef USE_MORPHNORMALS\n\t\tuniform float morphTargetInfluences[ 8 ];\n\t#else\n\t\tuniform float morphTargetInfluences[ 4 ];\n\t#endif\n#endif",morphtarget_vertex:"#ifdef USE_MORPHTARGETS\n\ttransformed *= morphTargetBaseInfluence;\n\ttransformed += morphTarget0 * morphTargetInfluences[ 0 ];\n\ttransformed += morphTarget1 * morphTargetInfluences[ 1 ];\n\ttransformed += morphTarget2 * morphTargetInfluences[ 2 ];\n\ttransformed += morphTarget3 * morphTargetInfluences[ 3 ];\n\t#ifndef USE_MORPHNORMALS\n\t\ttransformed += morphTarget4 * morphTargetInfluences[ 4 ];\n\t\ttransformed += morphTarget5 * morphTargetInfluences[ 5 ];\n\t\ttransformed += morphTarget6 * morphTargetInfluences[ 6 ];\n\t\ttransformed += morphTarget7 * morphTargetInfluences[ 7 ];\n\t#endif\n#endif",normal_fragment_begin:"#ifdef FLAT_SHADED\n\tvec3 fdx = vec3( dFdx( vViewPosition.x ), dFdx( vViewPosition.y ), dFdx( vViewPosition.z ) );\n\tvec3 fdy = vec3( dFdy( vViewPosition.x ), dFdy( vViewPosition.y ), dFdy( vViewPosition.z ) );\n\tvec3 normal = normalize( cross( fdx, fdy ) );\n#else\n\tvec3 normal = normalize( vNormal );\n\t#ifdef DOUBLE_SIDED\n\t\tnormal = normal * ( float( gl_FrontFacing ) * 2.0 - 1.0 );\n\t#endif\n\t#ifdef USE_TANGENT\n\t\tvec3 tangent = normalize( vTangent );\n\t\tvec3 bitangent = normalize( vBitangent );\n\t\t#ifdef DOUBLE_SIDED\n\t\t\ttangent = tangent * ( float( gl_FrontFacing ) * 2.0 - 1.0 );\n\t\t\tbitangent = bitangent * ( float( gl_FrontFacing ) * 2.0 - 1.0 );\n\t\t#endif\n\t\t#if defined( TANGENTSPACE_NORMALMAP ) || defined( USE_CLEARCOAT_NORMALMAP )\n\t\t\tmat3 vTBN = mat3( tangent, bitangent, normal );\n\t\t#endif\n\t#endif\n#endif\nvec3 geometryNormal = normal;",normal_fragment_maps:"#ifdef OBJECTSPACE_NORMALMAP\n\tnormal = texture2D( normalMap, vUv ).xyz * 2.0 - 1.0;\n\t#ifdef FLIP_SIDED\n\t\tnormal = - normal;\n\t#endif\n\t#ifdef DOUBLE_SIDED\n\t\tnormal = normal * ( float( gl_FrontFacing ) * 2.0 - 1.0 );\n\t#endif\n\tnormal = normalize( normalMatrix * normal );\n#elif defined( TANGENTSPACE_NORMALMAP )\n\tvec3 mapN = texture2D( normalMap, vUv ).xyz * 2.0 - 1.0;\n\tmapN.xy *= normalScale;\n\t#ifdef USE_TANGENT\n\t\tnormal = normalize( vTBN * mapN );\n\t#else\n\t\tnormal = perturbNormal2Arb( -vViewPosition, normal, mapN );\n\t#endif\n#elif defined( USE_BUMPMAP )\n\tnormal = perturbNormalArb( -vViewPosition, normal, dHdxy_fwd() );\n#endif",normalmap_pars_fragment:"#ifdef USE_NORMALMAP\n\tuniform sampler2D normalMap;\n\tuniform vec2 normalScale;\n#endif\n#ifdef OBJECTSPACE_NORMALMAP\n\tuniform mat3 normalMatrix;\n#endif\n#if ! defined ( USE_TANGENT ) && ( defined ( TANGENTSPACE_NORMALMAP ) || defined ( USE_CLEARCOAT_NORMALMAP ) )\n\tvec3 perturbNormal2Arb( vec3 eye_pos, vec3 surf_norm, vec3 mapN ) {\n\t\tvec3 q0 = vec3( dFdx( eye_pos.x ), dFdx( eye_pos.y ), dFdx( eye_pos.z ) );\n\t\tvec3 q1 = vec3( dFdy( eye_pos.x ), dFdy( eye_pos.y ), dFdy( eye_pos.z ) );\n\t\tvec2 st0 = dFdx( vUv.st );\n\t\tvec2 st1 = dFdy( vUv.st );\n\t\tfloat scale = sign( st1.t * st0.s - st0.t * st1.s );\n\t\tvec3 S = normalize( ( q0 * st1.t - q1 * st0.t ) * scale );\n\t\tvec3 T = normalize( ( - q0 * st1.s + q1 * st0.s ) * scale );\n\t\tvec3 N = normalize( surf_norm );\n\t\tmat3 tsn = mat3( S, T, N );\n\t\tmapN.xy *= ( float( gl_FrontFacing ) * 2.0 - 1.0 );\n\t\treturn normalize( tsn * mapN );\n\t}\n#endif",clearcoat_normal_fragment_begin:"#ifdef CLEARCOAT\n\tvec3 clearcoatNormal = geometryNormal;\n#endif",clearcoat_normal_fragment_maps:"#ifdef USE_CLEARCOAT_NORMALMAP\n\tvec3 clearcoatMapN = texture2D( clearcoatNormalMap, vUv ).xyz * 2.0 - 1.0;\n\tclearcoatMapN.xy *= clearcoatNormalScale;\n\t#ifdef USE_TANGENT\n\t\tclearcoatNormal = normalize( vTBN * clearcoatMapN );\n\t#else\n\t\tclearcoatNormal = perturbNormal2Arb( - vViewPosition, clearcoatNormal, clearcoatMapN );\n\t#endif\n#endif",clearcoat_pars_fragment:"#ifdef USE_CLEARCOATMAP\n\tuniform sampler2D clearcoatMap;\n#endif\n#ifdef USE_CLEARCOAT_ROUGHNESSMAP\n\tuniform sampler2D clearcoatRoughnessMap;\n#endif\n#ifdef USE_CLEARCOAT_NORMALMAP\n\tuniform sampler2D clearcoatNormalMap;\n\tuniform vec2 clearcoatNormalScale;\n#endif",packing:"vec3 packNormalToRGB( const in vec3 normal ) {\n\treturn normalize( normal ) * 0.5 + 0.5;\n}\nvec3 unpackRGBToNormal( const in vec3 rgb ) {\n\treturn 2.0 * rgb.xyz - 1.0;\n}\nconst float PackUpscale = 256. / 255.;const float UnpackDownscale = 255. / 256.;\nconst vec3 PackFactors = vec3( 256. * 256. * 256., 256. * 256., 256. );\nconst vec4 UnpackFactors = UnpackDownscale / vec4( PackFactors, 1. );\nconst float ShiftRight8 = 1. / 256.;\nvec4 packDepthToRGBA( const in float v ) {\n\tvec4 r = vec4( fract( v * PackFactors ), v );\n\tr.yzw -= r.xyz * ShiftRight8;\treturn r * PackUpscale;\n}\nfloat unpackRGBAToDepth( const in vec4 v ) {\n\treturn dot( v, UnpackFactors );\n}\nvec4 pack2HalfToRGBA( vec2 v ) {\n\tvec4 r = vec4( v.x, fract( v.x * 255.0 ), v.y, fract( v.y * 255.0 ));\n\treturn vec4( r.x - r.y / 255.0, r.y, r.z - r.w / 255.0, r.w);\n}\nvec2 unpackRGBATo2Half( vec4 v ) {\n\treturn vec2( v.x + ( v.y / 255.0 ), v.z + ( v.w / 255.0 ) );\n}\nfloat viewZToOrthographicDepth( const in float viewZ, const in float near, const in float far ) {\n\treturn ( viewZ + near ) / ( near - far );\n}\nfloat orthographicDepthToViewZ( const in float linearClipZ, const in float near, const in float far ) {\n\treturn linearClipZ * ( near - far ) - near;\n}\nfloat viewZToPerspectiveDepth( const in float viewZ, const in float near, const in float far ) {\n\treturn (( near + viewZ ) * far ) / (( far - near ) * viewZ );\n}\nfloat perspectiveDepthToViewZ( const in float invClipZ, const in float near, const in float far ) {\n\treturn ( near * far ) / ( ( far - near ) * invClipZ - far );\n}",premultiplied_alpha_fragment:"#ifdef PREMULTIPLIED_ALPHA\n\tgl_FragColor.rgb *= gl_FragColor.a;\n#endif",project_vertex:"vec4 mvPosition = vec4( transformed, 1.0 );\n#ifdef USE_INSTANCING\n\tmvPosition = instanceMatrix * mvPosition;\n#endif\nmvPosition = modelViewMatrix * mvPosition;\ngl_Position = projectionMatrix * mvPosition;",dithering_fragment:"#ifdef DITHERING\n\tgl_FragColor.rgb = dithering( gl_FragColor.rgb );\n#endif",dithering_pars_fragment:"#ifdef DITHERING\n\tvec3 dithering( vec3 color ) {\n\t\tfloat grid_position = rand( gl_FragCoord.xy );\n\t\tvec3 dither_shift_RGB = vec3( 0.25 / 255.0, -0.25 / 255.0, 0.25 / 255.0 );\n\t\tdither_shift_RGB = mix( 2.0 * dither_shift_RGB, -2.0 * dither_shift_RGB, grid_position );\n\t\treturn color + dither_shift_RGB;\n\t}\n#endif",roughnessmap_fragment:"float roughnessFactor = roughness;\n#ifdef USE_ROUGHNESSMAP\n\tvec4 texelRoughness = texture2D( roughnessMap, vUv );\n\troughnessFactor *= texelRoughness.g;\n#endif",roughnessmap_pars_fragment:"#ifdef USE_ROUGHNESSMAP\n\tuniform sampler2D roughnessMap;\n#endif",shadowmap_pars_fragment:"#ifdef USE_SHADOWMAP\n\t#if NUM_DIR_LIGHT_SHADOWS > 0\n\t\tuniform sampler2D directionalShadowMap[ NUM_DIR_LIGHT_SHADOWS ];\n\t\tvarying vec4 vDirectionalShadowCoord[ NUM_DIR_LIGHT_SHADOWS ];\n\t\tstruct DirectionalLightShadow {\n\t\t\tfloat shadowBias;\n\t\t\tfloat shadowNormalBias;\n\t\t\tfloat shadowRadius;\n\t\t\tvec2 shadowMapSize;\n\t\t};\n\t\tuniform DirectionalLightShadow directionalLightShadows[ NUM_DIR_LIGHT_SHADOWS ];\n\t#endif\n\t#if NUM_SPOT_LIGHT_SHADOWS > 0\n\t\tuniform sampler2D spotShadowMap[ NUM_SPOT_LIGHT_SHADOWS ];\n\t\tvarying vec4 vSpotShadowCoord[ NUM_SPOT_LIGHT_SHADOWS ];\n\t\tstruct SpotLightShadow {\n\t\t\tfloat shadowBias;\n\t\t\tfloat shadowNormalBias;\n\t\t\tfloat shadowRadius;\n\t\t\tvec2 shadowMapSize;\n\t\t};\n\t\tuniform SpotLightShadow spotLightShadows[ NUM_SPOT_LIGHT_SHADOWS ];\n\t#endif\n\t#if NUM_POINT_LIGHT_SHADOWS > 0\n\t\tuniform sampler2D pointShadowMap[ NUM_POINT_LIGHT_SHADOWS ];\n\t\tvarying vec4 vPointShadowCoord[ NUM_POINT_LIGHT_SHADOWS ];\n\t\tstruct PointLightShadow {\n\t\t\tfloat shadowBias;\n\t\t\tfloat shadowNormalBias;\n\t\t\tfloat shadowRadius;\n\t\t\tvec2 shadowMapSize;\n\t\t\tfloat shadowCameraNear;\n\t\t\tfloat shadowCameraFar;\n\t\t};\n\t\tuniform PointLightShadow pointLightShadows[ NUM_POINT_LIGHT_SHADOWS ];\n\t#endif\n\tfloat texture2DCompare( sampler2D depths, vec2 uv, float compare ) {\n\t\treturn step( compare, unpackRGBAToDepth( texture2D( depths, uv ) ) );\n\t}\n\tvec2 texture2DDistribution( sampler2D shadow, vec2 uv ) {\n\t\treturn unpackRGBATo2Half( texture2D( shadow, uv ) );\n\t}\n\tfloat VSMShadow (sampler2D shadow, vec2 uv, float compare ){\n\t\tfloat occlusion = 1.0;\n\t\tvec2 distribution = texture2DDistribution( shadow, uv );\n\t\tfloat hard_shadow = step( compare , distribution.x );\n\t\tif (hard_shadow != 1.0 ) {\n\t\t\tfloat distance = compare - distribution.x ;\n\t\t\tfloat variance = max( 0.00000, distribution.y * distribution.y );\n\t\t\tfloat softness_probability = variance / (variance + distance * distance );\t\t\tsoftness_probability = clamp( ( softness_probability - 0.3 ) / ( 0.95 - 0.3 ), 0.0, 1.0 );\t\t\tocclusion = clamp( max( hard_shadow, softness_probability ), 0.0, 1.0 );\n\t\t}\n\t\treturn occlusion;\n\t}\n\tfloat getShadow( sampler2D shadowMap, vec2 shadowMapSize, float shadowBias, float shadowRadius, vec4 shadowCoord ) {\n\t\tfloat shadow = 1.0;\n\t\tshadowCoord.xyz /= shadowCoord.w;\n\t\tshadowCoord.z += shadowBias;\n\t\tbvec4 inFrustumVec = bvec4 ( shadowCoord.x >= 0.0, shadowCoord.x <= 1.0, shadowCoord.y >= 0.0, shadowCoord.y <= 1.0 );\n\t\tbool inFrustum = all( inFrustumVec );\n\t\tbvec2 frustumTestVec = bvec2( inFrustum, shadowCoord.z <= 1.0 );\n\t\tbool frustumTest = all( frustumTestVec );\n\t\tif ( frustumTest ) {\n\t\t#if defined( SHADOWMAP_TYPE_PCF )\n\t\t\tvec2 texelSize = vec2( 1.0 ) / shadowMapSize;\n\t\t\tfloat dx0 = - texelSize.x * shadowRadius;\n\t\t\tfloat dy0 = - texelSize.y * shadowRadius;\n\t\t\tfloat dx1 = + texelSize.x * shadowRadius;\n\t\t\tfloat dy1 = + texelSize.y * shadowRadius;\n\t\t\tfloat dx2 = dx0 / 2.0;\n\t\t\tfloat dy2 = dy0 / 2.0;\n\t\t\tfloat dx3 = dx1 / 2.0;\n\t\t\tfloat dy3 = dy1 / 2.0;\n\t\t\tshadow = (\n\t\t\t\ttexture2DCompare( shadowMap, shadowCoord.xy + vec2( dx0, dy0 ), shadowCoord.z ) +\n\t\t\t\ttexture2DCompare( shadowMap, shadowCoord.xy + vec2( 0.0, dy0 ), shadowCoord.z ) +\n\t\t\t\ttexture2DCompare( shadowMap, shadowCoord.xy + vec2( dx1, dy0 ), shadowCoord.z ) +\n\t\t\t\ttexture2DCompare( shadowMap, shadowCoord.xy + vec2( dx2, dy2 ), shadowCoord.z ) +\n\t\t\t\ttexture2DCompare( shadowMap, shadowCoord.xy + vec2( 0.0, dy2 ), shadowCoord.z ) +\n\t\t\t\ttexture2DCompare( shadowMap, shadowCoord.xy + vec2( dx3, dy2 ), shadowCoord.z ) +\n\t\t\t\ttexture2DCompare( shadowMap, shadowCoord.xy + vec2( dx0, 0.0 ), shadowCoord.z ) +\n\t\t\t\ttexture2DCompare( shadowMap, shadowCoord.xy + vec2( dx2, 0.0 ), shadowCoord.z ) +\n\t\t\t\ttexture2DCompare( shadowMap, shadowCoord.xy, shadowCoord.z ) +\n\t\t\t\ttexture2DCompare( shadowMap, shadowCoord.xy + vec2( dx3, 0.0 ), shadowCoord.z ) +\n\t\t\t\ttexture2DCompare( shadowMap, shadowCoord.xy + vec2( dx1, 0.0 ), shadowCoord.z ) +\n\t\t\t\ttexture2DCompare( shadowMap, shadowCoord.xy + vec2( dx2, dy3 ), shadowCoord.z ) +\n\t\t\t\ttexture2DCompare( shadowMap, shadowCoord.xy + vec2( 0.0, dy3 ), shadowCoord.z ) +\n\t\t\t\ttexture2DCompare( shadowMap, shadowCoord.xy + vec2( dx3, dy3 ), shadowCoord.z ) +\n\t\t\t\ttexture2DCompare( shadowMap, shadowCoord.xy + vec2( dx0, dy1 ), shadowCoord.z ) +\n\t\t\t\ttexture2DCompare( shadowMap, shadowCoord.xy + vec2( 0.0, dy1 ), shadowCoord.z ) +\n\t\t\t\ttexture2DCompare( shadowMap, shadowCoord.xy + vec2( dx1, dy1 ), shadowCoord.z )\n\t\t\t) * ( 1.0 / 17.0 );\n\t\t#elif defined( SHADOWMAP_TYPE_PCF_SOFT )\n\t\t\tvec2 texelSize = vec2( 1.0 ) / shadowMapSize;\n\t\t\tfloat dx = texelSize.x;\n\t\t\tfloat dy = texelSize.y;\n\t\t\tvec2 uv = shadowCoord.xy;\n\t\t\tvec2 f = fract( uv * shadowMapSize + 0.5 );\n\t\t\tuv -= f * texelSize;\n\t\t\tshadow = (\n\t\t\t\ttexture2DCompare( shadowMap, uv, shadowCoord.z ) +\n\t\t\t\ttexture2DCompare( shadowMap, uv + vec2( dx, 0.0 ), shadowCoord.z ) +\n\t\t\t\ttexture2DCompare( shadowMap, uv + vec2( 0.0, dy ), shadowCoord.z ) +\n\t\t\t\ttexture2DCompare( shadowMap, uv + texelSize, shadowCoord.z ) +\n\t\t\t\tmix( texture2DCompare( shadowMap, uv + vec2( -dx, 0.0 ), shadowCoord.z ), \n\t\t\t\t\t texture2DCompare( shadowMap, uv + vec2( 2.0 * dx, 0.0 ), shadowCoord.z ),\n\t\t\t\t\t f.x ) +\n\t\t\t\tmix( texture2DCompare( shadowMap, uv + vec2( -dx, dy ), shadowCoord.z ), \n\t\t\t\t\t texture2DCompare( shadowMap, uv + vec2( 2.0 * dx, dy ), shadowCoord.z ),\n\t\t\t\t\t f.x ) +\n\t\t\t\tmix( texture2DCompare( shadowMap, uv + vec2( 0.0, -dy ), shadowCoord.z ), \n\t\t\t\t\t texture2DCompare( shadowMap, uv + vec2( 0.0, 2.0 * dy ), shadowCoord.z ),\n\t\t\t\t\t f.y ) +\n\t\t\t\tmix( texture2DCompare( shadowMap, uv + vec2( dx, -dy ), shadowCoord.z ), \n\t\t\t\t\t texture2DCompare( shadowMap, uv + vec2( dx, 2.0 * dy ), shadowCoord.z ),\n\t\t\t\t\t f.y ) +\n\t\t\t\tmix( mix( texture2DCompare( shadowMap, uv + vec2( -dx, -dy ), shadowCoord.z ), \n\t\t\t\t\t\t\ttexture2DCompare( shadowMap, uv + vec2( 2.0 * dx, -dy ), shadowCoord.z ),\n\t\t\t\t\t\t\tf.x ),\n\t\t\t\t\t mix( texture2DCompare( shadowMap, uv + vec2( -dx, 2.0 * dy ), shadowCoord.z ), \n\t\t\t\t\t\t\ttexture2DCompare( shadowMap, uv + vec2( 2.0 * dx, 2.0 * dy ), shadowCoord.z ),\n\t\t\t\t\t\t\tf.x ),\n\t\t\t\t\t f.y )\n\t\t\t) * ( 1.0 / 9.0 );\n\t\t#elif defined( SHADOWMAP_TYPE_VSM )\n\t\t\tshadow = VSMShadow( shadowMap, shadowCoord.xy, shadowCoord.z );\n\t\t#else\n\t\t\tshadow = texture2DCompare( shadowMap, shadowCoord.xy, shadowCoord.z );\n\t\t#endif\n\t\t}\n\t\treturn shadow;\n\t}\n\tvec2 cubeToUV( vec3 v, float texelSizeY ) {\n\t\tvec3 absV = abs( v );\n\t\tfloat scaleToCube = 1.0 / max( absV.x, max( absV.y, absV.z ) );\n\t\tabsV *= scaleToCube;\n\t\tv *= scaleToCube * ( 1.0 - 2.0 * texelSizeY );\n\t\tvec2 planar = v.xy;\n\t\tfloat almostATexel = 1.5 * texelSizeY;\n\t\tfloat almostOne = 1.0 - almostATexel;\n\t\tif ( absV.z >= almostOne ) {\n\t\t\tif ( v.z > 0.0 )\n\t\t\t\tplanar.x = 4.0 - v.x;\n\t\t} else if ( absV.x >= almostOne ) {\n\t\t\tfloat signX = sign( v.x );\n\t\t\tplanar.x = v.z * signX + 2.0 * signX;\n\t\t} else if ( absV.y >= almostOne ) {\n\t\t\tfloat signY = sign( v.y );\n\t\t\tplanar.x = v.x + 2.0 * signY + 2.0;\n\t\t\tplanar.y = v.z * signY - 2.0;\n\t\t}\n\t\treturn vec2( 0.125, 0.25 ) * planar + vec2( 0.375, 0.75 );\n\t}\n\tfloat getPointShadow( sampler2D shadowMap, vec2 shadowMapSize, float shadowBias, float shadowRadius, vec4 shadowCoord, float shadowCameraNear, float shadowCameraFar ) {\n\t\tvec2 texelSize = vec2( 1.0 ) / ( shadowMapSize * vec2( 4.0, 2.0 ) );\n\t\tvec3 lightToPosition = shadowCoord.xyz;\n\t\tfloat dp = ( length( lightToPosition ) - shadowCameraNear ) / ( shadowCameraFar - shadowCameraNear );\t\tdp += shadowBias;\n\t\tvec3 bd3D = normalize( lightToPosition );\n\t\t#if defined( SHADOWMAP_TYPE_PCF ) || defined( SHADOWMAP_TYPE_PCF_SOFT ) || defined( SHADOWMAP_TYPE_VSM )\n\t\t\tvec2 offset = vec2( - 1, 1 ) * shadowRadius * texelSize.y;\n\t\t\treturn (\n\t\t\t\ttexture2DCompare( shadowMap, cubeToUV( bd3D + offset.xyy, texelSize.y ), dp ) +\n\t\t\t\ttexture2DCompare( shadowMap, cubeToUV( bd3D + offset.yyy, texelSize.y ), dp ) +\n\t\t\t\ttexture2DCompare( shadowMap, cubeToUV( bd3D + offset.xyx, texelSize.y ), dp ) +\n\t\t\t\ttexture2DCompare( shadowMap, cubeToUV( bd3D + offset.yyx, texelSize.y ), dp ) +\n\t\t\t\ttexture2DCompare( shadowMap, cubeToUV( bd3D, texelSize.y ), dp ) +\n\t\t\t\ttexture2DCompare( shadowMap, cubeToUV( bd3D + offset.xxy, texelSize.y ), dp ) +\n\t\t\t\ttexture2DCompare( shadowMap, cubeToUV( bd3D + offset.yxy, texelSize.y ), dp ) +\n\t\t\t\ttexture2DCompare( shadowMap, cubeToUV( bd3D + offset.xxx, texelSize.y ), dp ) +\n\t\t\t\ttexture2DCompare( shadowMap, cubeToUV( bd3D + offset.yxx, texelSize.y ), dp )\n\t\t\t) * ( 1.0 / 9.0 );\n\t\t#else\n\t\t\treturn texture2DCompare( shadowMap, cubeToUV( bd3D, texelSize.y ), dp );\n\t\t#endif\n\t}\n#endif",shadowmap_pars_vertex:"#ifdef USE_SHADOWMAP\n\t#if NUM_DIR_LIGHT_SHADOWS > 0\n\t\tuniform mat4 directionalShadowMatrix[ NUM_DIR_LIGHT_SHADOWS ];\n\t\tvarying vec4 vDirectionalShadowCoord[ NUM_DIR_LIGHT_SHADOWS ];\n\t\tstruct DirectionalLightShadow {\n\t\t\tfloat shadowBias;\n\t\t\tfloat shadowNormalBias;\n\t\t\tfloat shadowRadius;\n\t\t\tvec2 shadowMapSize;\n\t\t};\n\t\tuniform DirectionalLightShadow directionalLightShadows[ NUM_DIR_LIGHT_SHADOWS ];\n\t#endif\n\t#if NUM_SPOT_LIGHT_SHADOWS > 0\n\t\tuniform mat4 spotShadowMatrix[ NUM_SPOT_LIGHT_SHADOWS ];\n\t\tvarying vec4 vSpotShadowCoord[ NUM_SPOT_LIGHT_SHADOWS ];\n\t\tstruct SpotLightShadow {\n\t\t\tfloat shadowBias;\n\t\t\tfloat shadowNormalBias;\n\t\t\tfloat shadowRadius;\n\t\t\tvec2 shadowMapSize;\n\t\t};\n\t\tuniform SpotLightShadow spotLightShadows[ NUM_SPOT_LIGHT_SHADOWS ];\n\t#endif\n\t#if NUM_POINT_LIGHT_SHADOWS > 0\n\t\tuniform mat4 pointShadowMatrix[ NUM_POINT_LIGHT_SHADOWS ];\n\t\tvarying vec4 vPointShadowCoord[ NUM_POINT_LIGHT_SHADOWS ];\n\t\tstruct PointLightShadow {\n\t\t\tfloat shadowBias;\n\t\t\tfloat shadowNormalBias;\n\t\t\tfloat shadowRadius;\n\t\t\tvec2 shadowMapSize;\n\t\t\tfloat shadowCameraNear;\n\t\t\tfloat shadowCameraFar;\n\t\t};\n\t\tuniform PointLightShadow pointLightShadows[ NUM_POINT_LIGHT_SHADOWS ];\n\t#endif\n#endif",shadowmap_vertex:"#ifdef USE_SHADOWMAP\n\t#if NUM_DIR_LIGHT_SHADOWS > 0 || NUM_SPOT_LIGHT_SHADOWS > 0 || NUM_POINT_LIGHT_SHADOWS > 0\n\t\tvec3 shadowWorldNormal = inverseTransformDirection( transformedNormal, viewMatrix );\n\t\tvec4 shadowWorldPosition;\n\t#endif\n\t#if NUM_DIR_LIGHT_SHADOWS > 0\n\t#pragma unroll_loop_start\n\tfor ( int i = 0; i < NUM_DIR_LIGHT_SHADOWS; i ++ ) {\n\t\tshadowWorldPosition = worldPosition + vec4( shadowWorldNormal * directionalLightShadows[ i ].shadowNormalBias, 0 );\n\t\tvDirectionalShadowCoord[ i ] = directionalShadowMatrix[ i ] * shadowWorldPosition;\n\t}\n\t#pragma unroll_loop_end\n\t#endif\n\t#if NUM_SPOT_LIGHT_SHADOWS > 0\n\t#pragma unroll_loop_start\n\tfor ( int i = 0; i < NUM_SPOT_LIGHT_SHADOWS; i ++ ) {\n\t\tshadowWorldPosition = worldPosition + vec4( shadowWorldNormal * spotLightShadows[ i ].shadowNormalBias, 0 );\n\t\tvSpotShadowCoord[ i ] = spotShadowMatrix[ i ] * shadowWorldPosition;\n\t}\n\t#pragma unroll_loop_end\n\t#endif\n\t#if NUM_POINT_LIGHT_SHADOWS > 0\n\t#pragma unroll_loop_start\n\tfor ( int i = 0; i < NUM_POINT_LIGHT_SHADOWS; i ++ ) {\n\t\tshadowWorldPosition = worldPosition + vec4( shadowWorldNormal * pointLightShadows[ i ].shadowNormalBias, 0 );\n\t\tvPointShadowCoord[ i ] = pointShadowMatrix[ i ] * shadowWorldPosition;\n\t}\n\t#pragma unroll_loop_end\n\t#endif\n#endif",shadowmask_pars_fragment:"float getShadowMask() {\n\tfloat shadow = 1.0;\n\t#ifdef USE_SHADOWMAP\n\t#if NUM_DIR_LIGHT_SHADOWS > 0\n\tDirectionalLightShadow directionalLight;\n\t#pragma unroll_loop_start\n\tfor ( int i = 0; i < NUM_DIR_LIGHT_SHADOWS; i ++ ) {\n\t\tdirectionalLight = directionalLightShadows[ i ];\n\t\tshadow *= receiveShadow ? getShadow( directionalShadowMap[ i ], directionalLight.shadowMapSize, directionalLight.shadowBias, directionalLight.shadowRadius, vDirectionalShadowCoord[ i ] ) : 1.0;\n\t}\n\t#pragma unroll_loop_end\n\t#endif\n\t#if NUM_SPOT_LIGHT_SHADOWS > 0\n\tSpotLightShadow spotLight;\n\t#pragma unroll_loop_start\n\tfor ( int i = 0; i < NUM_SPOT_LIGHT_SHADOWS; i ++ ) {\n\t\tspotLight = spotLightShadows[ i ];\n\t\tshadow *= receiveShadow ? getShadow( spotShadowMap[ i ], spotLight.shadowMapSize, spotLight.shadowBias, spotLight.shadowRadius, vSpotShadowCoord[ i ] ) : 1.0;\n\t}\n\t#pragma unroll_loop_end\n\t#endif\n\t#if NUM_POINT_LIGHT_SHADOWS > 0\n\tPointLightShadow pointLight;\n\t#pragma unroll_loop_start\n\tfor ( int i = 0; i < NUM_POINT_LIGHT_SHADOWS; i ++ ) {\n\t\tpointLight = pointLightShadows[ i ];\n\t\tshadow *= receiveShadow ? getPointShadow( pointShadowMap[ i ], pointLight.shadowMapSize, pointLight.shadowBias, pointLight.shadowRadius, vPointShadowCoord[ i ], pointLight.shadowCameraNear, pointLight.shadowCameraFar ) : 1.0;\n\t}\n\t#pragma unroll_loop_end\n\t#endif\n\t#endif\n\treturn shadow;\n}",skinbase_vertex:"#ifdef USE_SKINNING\n\tmat4 boneMatX = getBoneMatrix( skinIndex.x );\n\tmat4 boneMatY = getBoneMatrix( skinIndex.y );\n\tmat4 boneMatZ = getBoneMatrix( skinIndex.z );\n\tmat4 boneMatW = getBoneMatrix( skinIndex.w );\n#endif",skinning_pars_vertex:"#ifdef USE_SKINNING\n\tuniform mat4 bindMatrix;\n\tuniform mat4 bindMatrixInverse;\n\t#ifdef BONE_TEXTURE\n\t\tuniform highp sampler2D boneTexture;\n\t\tuniform int boneTextureSize;\n\t\tmat4 getBoneMatrix( const in float i ) {\n\t\t\tfloat j = i * 4.0;\n\t\t\tfloat x = mod( j, float( boneTextureSize ) );\n\t\t\tfloat y = floor( j / float( boneTextureSize ) );\n\t\t\tfloat dx = 1.0 / float( boneTextureSize );\n\t\t\tfloat dy = 1.0 / float( boneTextureSize );\n\t\t\ty = dy * ( y + 0.5 );\n\t\t\tvec4 v1 = texture2D( boneTexture, vec2( dx * ( x + 0.5 ), y ) );\n\t\t\tvec4 v2 = texture2D( boneTexture, vec2( dx * ( x + 1.5 ), y ) );\n\t\t\tvec4 v3 = texture2D( boneTexture, vec2( dx * ( x + 2.5 ), y ) );\n\t\t\tvec4 v4 = texture2D( boneTexture, vec2( dx * ( x + 3.5 ), y ) );\n\t\t\tmat4 bone = mat4( v1, v2, v3, v4 );\n\t\t\treturn bone;\n\t\t}\n\t#else\n\t\tuniform mat4 boneMatrices[ MAX_BONES ];\n\t\tmat4 getBoneMatrix( const in float i ) {\n\t\t\tmat4 bone = boneMatrices[ int(i) ];\n\t\t\treturn bone;\n\t\t}\n\t#endif\n#endif",skinning_vertex:"#ifdef USE_SKINNING\n\tvec4 skinVertex = bindMatrix * vec4( transformed, 1.0 );\n\tvec4 skinned = vec4( 0.0 );\n\tskinned += boneMatX * skinVertex * skinWeight.x;\n\tskinned += boneMatY * skinVertex * skinWeight.y;\n\tskinned += boneMatZ * skinVertex * skinWeight.z;\n\tskinned += boneMatW * skinVertex * skinWeight.w;\n\ttransformed = ( bindMatrixInverse * skinned ).xyz;\n#endif",skinnormal_vertex:"#ifdef USE_SKINNING\n\tmat4 skinMatrix = mat4( 0.0 );\n\tskinMatrix += skinWeight.x * boneMatX;\n\tskinMatrix += skinWeight.y * boneMatY;\n\tskinMatrix += skinWeight.z * boneMatZ;\n\tskinMatrix += skinWeight.w * boneMatW;\n\tskinMatrix = bindMatrixInverse * skinMatrix * bindMatrix;\n\tobjectNormal = vec4( skinMatrix * vec4( objectNormal, 0.0 ) ).xyz;\n\t#ifdef USE_TANGENT\n\t\tobjectTangent = vec4( skinMatrix * vec4( objectTangent, 0.0 ) ).xyz;\n\t#endif\n#endif",specularmap_fragment:"float specularStrength;\n#ifdef USE_SPECULARMAP\n\tvec4 texelSpecular = texture2D( specularMap, vUv );\n\tspecularStrength = texelSpecular.r;\n#else\n\tspecularStrength = 1.0;\n#endif",specularmap_pars_fragment:"#ifdef USE_SPECULARMAP\n\tuniform sampler2D specularMap;\n#endif",tonemapping_fragment:"#if defined( TONE_MAPPING )\n\tgl_FragColor.rgb = toneMapping( gl_FragColor.rgb );\n#endif",tonemapping_pars_fragment:"#ifndef saturate\n#define saturate(a) clamp( a, 0.0, 1.0 )\n#endif\nuniform float toneMappingExposure;\nvec3 LinearToneMapping( vec3 color ) {\n\treturn toneMappingExposure * color;\n}\nvec3 ReinhardToneMapping( vec3 color ) {\n\tcolor *= toneMappingExposure;\n\treturn saturate( color / ( vec3( 1.0 ) + color ) );\n}\nvec3 OptimizedCineonToneMapping( vec3 color ) {\n\tcolor *= toneMappingExposure;\n\tcolor = max( vec3( 0.0 ), color - 0.004 );\n\treturn pow( ( color * ( 6.2 * color + 0.5 ) ) / ( color * ( 6.2 * color + 1.7 ) + 0.06 ), vec3( 2.2 ) );\n}\nvec3 RRTAndODTFit( vec3 v ) {\n\tvec3 a = v * ( v + 0.0245786 ) - 0.000090537;\n\tvec3 b = v * ( 0.983729 * v + 0.4329510 ) + 0.238081;\n\treturn a / b;\n}\nvec3 ACESFilmicToneMapping( vec3 color ) {\n\tconst mat3 ACESInputMat = mat3(\n\t\tvec3( 0.59719, 0.07600, 0.02840 ),\t\tvec3( 0.35458, 0.90834, 0.13383 ),\n\t\tvec3( 0.04823, 0.01566, 0.83777 )\n\t);\n\tconst mat3 ACESOutputMat = mat3(\n\t\tvec3(\t1.60475, -0.10208, -0.00327 ),\t\tvec3( -0.53108,\t1.10813, -0.07276 ),\n\t\tvec3( -0.07367, -0.00605,\t1.07602 )\n\t);\n\tcolor *= toneMappingExposure / 0.6;\n\tcolor = ACESInputMat * color;\n\tcolor = RRTAndODTFit( color );\n\tcolor = ACESOutputMat * color;\n\treturn saturate( color );\n}\nvec3 CustomToneMapping( vec3 color ) { return color; }",transmissionmap_fragment:"#ifdef USE_TRANSMISSIONMAP\n\ttotalTransmission *= texture2D( transmissionMap, vUv ).r;\n#endif",transmissionmap_pars_fragment:"#ifdef USE_TRANSMISSIONMAP\n\tuniform sampler2D transmissionMap;\n#endif",uv_pars_fragment:"#if ( defined( USE_UV ) && ! defined( UVS_VERTEX_ONLY ) )\n\tvarying vec2 vUv;\n#endif",uv_pars_vertex:"#ifdef USE_UV\n\t#ifdef UVS_VERTEX_ONLY\n\t\tvec2 vUv;\n\t#else\n\t\tvarying vec2 vUv;\n\t#endif\n\tuniform mat3 uvTransform;\n#endif",uv_vertex:"#ifdef USE_UV\n\tvUv = ( uvTransform * vec3( uv, 1 ) ).xy;\n#endif",uv2_pars_fragment:"#if defined( USE_LIGHTMAP ) || defined( USE_AOMAP )\n\tvarying vec2 vUv2;\n#endif",uv2_pars_vertex:"#if defined( USE_LIGHTMAP ) || defined( USE_AOMAP )\n\tattribute vec2 uv2;\n\tvarying vec2 vUv2;\n\tuniform mat3 uv2Transform;\n#endif",uv2_vertex:"#if defined( USE_LIGHTMAP ) || defined( USE_AOMAP )\n\tvUv2 = ( uv2Transform * vec3( uv2, 1 ) ).xy;\n#endif",worldpos_vertex:"#if defined( USE_ENVMAP ) || defined( DISTANCE ) || defined ( USE_SHADOWMAP )\n\tvec4 worldPosition = vec4( transformed, 1.0 );\n\t#ifdef USE_INSTANCING\n\t\tworldPosition = instanceMatrix * worldPosition;\n\t#endif\n\tworldPosition = modelMatrix * worldPosition;\n#endif",background_frag:"uniform sampler2D t2D;\nvarying vec2 vUv;\nvoid main() {\n\tvec4 texColor = texture2D( t2D, vUv );\n\tgl_FragColor = mapTexelToLinear( texColor );\n\t#include \n\t#include \n}",background_vert:"varying vec2 vUv;\nuniform mat3 uvTransform;\nvoid main() {\n\tvUv = ( uvTransform * vec3( uv, 1 ) ).xy;\n\tgl_Position = vec4( position.xy, 1.0, 1.0 );\n}",cube_frag:"#include \nuniform float opacity;\nvarying vec3 vWorldDirection;\n#include \nvoid main() {\n\tvec3 vReflect = vWorldDirection;\n\t#include \n\tgl_FragColor = envColor;\n\tgl_FragColor.a *= opacity;\n\t#include \n\t#include \n}",cube_vert:"varying vec3 vWorldDirection;\n#include \nvoid main() {\n\tvWorldDirection = transformDirection( position, modelMatrix );\n\t#include \n\t#include \n\tgl_Position.z = gl_Position.w;\n}",depth_frag:"#if DEPTH_PACKING == 3200\n\tuniform float opacity;\n#endif\n#include \n#include \n#include \n#include \n#include \n#include \n#include \nvarying vec2 vHighPrecisionZW;\nvoid main() {\n\t#include \n\tvec4 diffuseColor = vec4( 1.0 );\n\t#if DEPTH_PACKING == 3200\n\t\tdiffuseColor.a = opacity;\n\t#endif\n\t#include \n\t#include \n\t#include \n\t#include \n\tfloat fragCoordZ = 0.5 * vHighPrecisionZW[0] / vHighPrecisionZW[1] + 0.5;\n\t#if DEPTH_PACKING == 3200\n\t\tgl_FragColor = vec4( vec3( 1.0 - fragCoordZ ), opacity );\n\t#elif DEPTH_PACKING == 3201\n\t\tgl_FragColor = packDepthToRGBA( fragCoordZ );\n\t#endif\n}",depth_vert:"#include \n#include \n#include \n#include \n#include \n#include \n#include \nvarying vec2 vHighPrecisionZW;\nvoid main() {\n\t#include \n\t#include \n\t#ifdef USE_DISPLACEMENTMAP\n\t\t#include \n\t\t#include \n\t\t#include \n\t#endif\n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\tvHighPrecisionZW = gl_Position.zw;\n}",distanceRGBA_frag:"#define DISTANCE\nuniform vec3 referencePosition;\nuniform float nearDistance;\nuniform float farDistance;\nvarying vec3 vWorldPosition;\n#include \n#include \n#include \n#include \n#include \n#include \nvoid main () {\n\t#include \n\tvec4 diffuseColor = vec4( 1.0 );\n\t#include \n\t#include \n\t#include \n\tfloat dist = length( vWorldPosition - referencePosition );\n\tdist = ( dist - nearDistance ) / ( farDistance - nearDistance );\n\tdist = saturate( dist );\n\tgl_FragColor = packDepthToRGBA( dist );\n}",distanceRGBA_vert:"#define DISTANCE\nvarying vec3 vWorldPosition;\n#include \n#include \n#include \n#include \n#include \n#include \nvoid main() {\n\t#include \n\t#include \n\t#ifdef USE_DISPLACEMENTMAP\n\t\t#include \n\t\t#include \n\t\t#include \n\t#endif\n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\tvWorldPosition = worldPosition.xyz;\n}",equirect_frag:"uniform sampler2D tEquirect;\nvarying vec3 vWorldDirection;\n#include \nvoid main() {\n\tvec3 direction = normalize( vWorldDirection );\n\tvec2 sampleUV = equirectUv( direction );\n\tvec4 texColor = texture2D( tEquirect, sampleUV );\n\tgl_FragColor = mapTexelToLinear( texColor );\n\t#include \n\t#include \n}",equirect_vert:"varying vec3 vWorldDirection;\n#include \nvoid main() {\n\tvWorldDirection = transformDirection( position, modelMatrix );\n\t#include \n\t#include \n}",linedashed_frag:"uniform vec3 diffuse;\nuniform float opacity;\nuniform float dashSize;\nuniform float totalSize;\nvarying float vLineDistance;\n#include \n#include \n#include \n#include \n#include \nvoid main() {\n\t#include \n\tif ( mod( vLineDistance, totalSize ) > dashSize ) {\n\t\tdiscard;\n\t}\n\tvec3 outgoingLight = vec3( 0.0 );\n\tvec4 diffuseColor = vec4( diffuse, opacity );\n\t#include \n\t#include \n\toutgoingLight = diffuseColor.rgb;\n\tgl_FragColor = vec4( outgoingLight, diffuseColor.a );\n\t#include \n\t#include \n\t#include \n\t#include \n}",linedashed_vert:"uniform float scale;\nattribute float lineDistance;\nvarying float vLineDistance;\n#include \n#include \n#include \n#include \n#include \n#include \nvoid main() {\n\tvLineDistance = scale * lineDistance;\n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n}",meshbasic_frag:"uniform vec3 diffuse;\nuniform float opacity;\n#ifndef FLAT_SHADED\n\tvarying vec3 vNormal;\n#endif\n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \nvoid main() {\n\t#include \n\tvec4 diffuseColor = vec4( diffuse, opacity );\n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\tReflectedLight reflectedLight = ReflectedLight( vec3( 0.0 ), vec3( 0.0 ), vec3( 0.0 ), vec3( 0.0 ) );\n\t#ifdef USE_LIGHTMAP\n\t\n\t\tvec4 lightMapTexel= texture2D( lightMap, vUv2 );\n\t\treflectedLight.indirectDiffuse += lightMapTexelToLinear( lightMapTexel ).rgb * lightMapIntensity;\n\t#else\n\t\treflectedLight.indirectDiffuse += vec3( 1.0 );\n\t#endif\n\t#include \n\treflectedLight.indirectDiffuse *= diffuseColor.rgb;\n\tvec3 outgoingLight = reflectedLight.indirectDiffuse;\n\t#include \n\tgl_FragColor = vec4( outgoingLight, diffuseColor.a );\n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n}",meshbasic_vert:"#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \nvoid main() {\n\t#include \n\t#include \n\t#include \n\t#include \n\t#ifdef USE_ENVMAP\n\t#include \n\t#include \n\t#include \n\t#include \n\t#endif\n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n}",meshlambert_frag:"uniform vec3 diffuse;\nuniform vec3 emissive;\nuniform float opacity;\nvarying vec3 vLightFront;\nvarying vec3 vIndirectFront;\n#ifdef DOUBLE_SIDED\n\tvarying vec3 vLightBack;\n\tvarying vec3 vIndirectBack;\n#endif\n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \nvoid main() {\n\t#include \n\tvec4 diffuseColor = vec4( diffuse, opacity );\n\tReflectedLight reflectedLight = ReflectedLight( vec3( 0.0 ), vec3( 0.0 ), vec3( 0.0 ), vec3( 0.0 ) );\n\tvec3 totalEmissiveRadiance = emissive;\n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#ifdef DOUBLE_SIDED\n\t\treflectedLight.indirectDiffuse += ( gl_FrontFacing ) ? vIndirectFront : vIndirectBack;\n\t#else\n\t\treflectedLight.indirectDiffuse += vIndirectFront;\n\t#endif\n\t#include \n\treflectedLight.indirectDiffuse *= BRDF_Diffuse_Lambert( diffuseColor.rgb );\n\t#ifdef DOUBLE_SIDED\n\t\treflectedLight.directDiffuse = ( gl_FrontFacing ) ? vLightFront : vLightBack;\n\t#else\n\t\treflectedLight.directDiffuse = vLightFront;\n\t#endif\n\treflectedLight.directDiffuse *= BRDF_Diffuse_Lambert( diffuseColor.rgb ) * getShadowMask();\n\t#include \n\tvec3 outgoingLight = reflectedLight.directDiffuse + reflectedLight.indirectDiffuse + totalEmissiveRadiance;\n\t#include \n\tgl_FragColor = vec4( outgoingLight, diffuseColor.a );\n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n}",meshlambert_vert:"#define LAMBERT\nvarying vec3 vLightFront;\nvarying vec3 vIndirectFront;\n#ifdef DOUBLE_SIDED\n\tvarying vec3 vLightBack;\n\tvarying vec3 vIndirectBack;\n#endif\n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \nvoid main() {\n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n}",meshmatcap_frag:"#define MATCAP\nuniform vec3 diffuse;\nuniform float opacity;\nuniform sampler2D matcap;\nvarying vec3 vViewPosition;\n#ifndef FLAT_SHADED\n\tvarying vec3 vNormal;\n#endif\n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \nvoid main() {\n\t#include \n\tvec4 diffuseColor = vec4( diffuse, opacity );\n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\tvec3 viewDir = normalize( vViewPosition );\n\tvec3 x = normalize( vec3( viewDir.z, 0.0, - viewDir.x ) );\n\tvec3 y = cross( viewDir, x );\n\tvec2 uv = vec2( dot( x, normal ), dot( y, normal ) ) * 0.495 + 0.5;\n\t#ifdef USE_MATCAP\n\t\tvec4 matcapColor = texture2D( matcap, uv );\n\t\tmatcapColor = matcapTexelToLinear( matcapColor );\n\t#else\n\t\tvec4 matcapColor = vec4( 1.0 );\n\t#endif\n\tvec3 outgoingLight = diffuseColor.rgb * matcapColor.rgb;\n\tgl_FragColor = vec4( outgoingLight, diffuseColor.a );\n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n}",meshmatcap_vert:"#define MATCAP\nvarying vec3 vViewPosition;\n#ifndef FLAT_SHADED\n\tvarying vec3 vNormal;\n#endif\n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \nvoid main() {\n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#ifndef FLAT_SHADED\n\t\tvNormal = normalize( transformedNormal );\n\t#endif\n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\tvViewPosition = - mvPosition.xyz;\n}",meshtoon_frag:"#define TOON\nuniform vec3 diffuse;\nuniform vec3 emissive;\nuniform float opacity;\n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \nvoid main() {\n\t#include \n\tvec4 diffuseColor = vec4( diffuse, opacity );\n\tReflectedLight reflectedLight = ReflectedLight( vec3( 0.0 ), vec3( 0.0 ), vec3( 0.0 ), vec3( 0.0 ) );\n\tvec3 totalEmissiveRadiance = emissive;\n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\tvec3 outgoingLight = reflectedLight.directDiffuse + reflectedLight.indirectDiffuse + totalEmissiveRadiance;\n\tgl_FragColor = vec4( outgoingLight, diffuseColor.a );\n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n}",meshtoon_vert:"#define TOON\nvarying vec3 vViewPosition;\n#ifndef FLAT_SHADED\n\tvarying vec3 vNormal;\n#endif\n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \nvoid main() {\n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n#ifndef FLAT_SHADED\n\tvNormal = normalize( transformedNormal );\n#endif\n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\tvViewPosition = - mvPosition.xyz;\n\t#include \n\t#include \n\t#include \n}",meshphong_frag:"#define PHONG\nuniform vec3 diffuse;\nuniform vec3 emissive;\nuniform vec3 specular;\nuniform float shininess;\nuniform float opacity;\n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \nvoid main() {\n\t#include \n\tvec4 diffuseColor = vec4( diffuse, opacity );\n\tReflectedLight reflectedLight = ReflectedLight( vec3( 0.0 ), vec3( 0.0 ), vec3( 0.0 ), vec3( 0.0 ) );\n\tvec3 totalEmissiveRadiance = emissive;\n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\tvec3 outgoingLight = reflectedLight.directDiffuse + reflectedLight.indirectDiffuse + reflectedLight.directSpecular + reflectedLight.indirectSpecular + totalEmissiveRadiance;\n\t#include \n\tgl_FragColor = vec4( outgoingLight, diffuseColor.a );\n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n}",meshphong_vert:"#define PHONG\nvarying vec3 vViewPosition;\n#ifndef FLAT_SHADED\n\tvarying vec3 vNormal;\n#endif\n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \nvoid main() {\n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n#ifndef FLAT_SHADED\n\tvNormal = normalize( transformedNormal );\n#endif\n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\tvViewPosition = - mvPosition.xyz;\n\t#include \n\t#include \n\t#include \n\t#include \n}",meshphysical_frag:"#define STANDARD\n#ifdef PHYSICAL\n\t#define REFLECTIVITY\n\t#define CLEARCOAT\n\t#define TRANSMISSION\n#endif\nuniform vec3 diffuse;\nuniform vec3 emissive;\nuniform float roughness;\nuniform float metalness;\nuniform float opacity;\n#ifdef TRANSMISSION\n\tuniform float transmission;\n#endif\n#ifdef REFLECTIVITY\n\tuniform float reflectivity;\n#endif\n#ifdef CLEARCOAT\n\tuniform float clearcoat;\n\tuniform float clearcoatRoughness;\n#endif\n#ifdef USE_SHEEN\n\tuniform vec3 sheen;\n#endif\nvarying vec3 vViewPosition;\n#ifndef FLAT_SHADED\n\tvarying vec3 vNormal;\n\t#ifdef USE_TANGENT\n\t\tvarying vec3 vTangent;\n\t\tvarying vec3 vBitangent;\n\t#endif\n#endif\n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \nvoid main() {\n\t#include \n\tvec4 diffuseColor = vec4( diffuse, opacity );\n\tReflectedLight reflectedLight = ReflectedLight( vec3( 0.0 ), vec3( 0.0 ), vec3( 0.0 ), vec3( 0.0 ) );\n\tvec3 totalEmissiveRadiance = emissive;\n\t#ifdef TRANSMISSION\n\t\tfloat totalTransmission = transmission;\n\t#endif\n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\tvec3 outgoingLight = reflectedLight.directDiffuse + reflectedLight.indirectDiffuse + reflectedLight.directSpecular + reflectedLight.indirectSpecular + totalEmissiveRadiance;\n\t#ifdef TRANSMISSION\n\t\tdiffuseColor.a *= mix( saturate( 1. - totalTransmission + linearToRelativeLuminance( reflectedLight.directSpecular + reflectedLight.indirectSpecular ) ), 1.0, metalness );\n\t#endif\n\tgl_FragColor = vec4( outgoingLight, diffuseColor.a );\n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n}",meshphysical_vert:"#define STANDARD\nvarying vec3 vViewPosition;\n#ifndef FLAT_SHADED\n\tvarying vec3 vNormal;\n\t#ifdef USE_TANGENT\n\t\tvarying vec3 vTangent;\n\t\tvarying vec3 vBitangent;\n\t#endif\n#endif\n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \nvoid main() {\n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n#ifndef FLAT_SHADED\n\tvNormal = normalize( transformedNormal );\n\t#ifdef USE_TANGENT\n\t\tvTangent = normalize( transformedTangent );\n\t\tvBitangent = normalize( cross( vNormal, vTangent ) * tangent.w );\n\t#endif\n#endif\n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\tvViewPosition = - mvPosition.xyz;\n\t#include \n\t#include \n\t#include \n}",normal_frag:"#define NORMAL\nuniform float opacity;\n#if defined( FLAT_SHADED ) || defined( USE_BUMPMAP ) || defined( TANGENTSPACE_NORMALMAP )\n\tvarying vec3 vViewPosition;\n#endif\n#ifndef FLAT_SHADED\n\tvarying vec3 vNormal;\n\t#ifdef USE_TANGENT\n\t\tvarying vec3 vTangent;\n\t\tvarying vec3 vBitangent;\n\t#endif\n#endif\n#include \n#include \n#include \n#include \n#include \n#include \nvoid main() {\n\t#include \n\t#include \n\t#include \n\t#include \n\tgl_FragColor = vec4( packNormalToRGB( normal ), opacity );\n}",normal_vert:"#define NORMAL\n#if defined( FLAT_SHADED ) || defined( USE_BUMPMAP ) || defined( TANGENTSPACE_NORMALMAP )\n\tvarying vec3 vViewPosition;\n#endif\n#ifndef FLAT_SHADED\n\tvarying vec3 vNormal;\n\t#ifdef USE_TANGENT\n\t\tvarying vec3 vTangent;\n\t\tvarying vec3 vBitangent;\n\t#endif\n#endif\n#include \n#include \n#include \n#include \n#include \n#include \n#include \nvoid main() {\n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n#ifndef FLAT_SHADED\n\tvNormal = normalize( transformedNormal );\n\t#ifdef USE_TANGENT\n\t\tvTangent = normalize( transformedTangent );\n\t\tvBitangent = normalize( cross( vNormal, vTangent ) * tangent.w );\n\t#endif\n#endif\n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n#if defined( FLAT_SHADED ) || defined( USE_BUMPMAP ) || defined( TANGENTSPACE_NORMALMAP )\n\tvViewPosition = - mvPosition.xyz;\n#endif\n}",points_frag:"uniform vec3 diffuse;\nuniform float opacity;\n#include \n#include \n#include \n#include \n#include \n#include \nvoid main() {\n\t#include \n\tvec3 outgoingLight = vec3( 0.0 );\n\tvec4 diffuseColor = vec4( diffuse, opacity );\n\t#include \n\t#include \n\t#include \n\t#include \n\toutgoingLight = diffuseColor.rgb;\n\tgl_FragColor = vec4( outgoingLight, diffuseColor.a );\n\t#include \n\t#include \n\t#include \n\t#include \n}",points_vert:"uniform float size;\nuniform float scale;\n#include \n#include \n#include \n#include \n#include \n#include \nvoid main() {\n\t#include \n\t#include \n\t#include \n\t#include \n\tgl_PointSize = size;\n\t#ifdef USE_SIZEATTENUATION\n\t\tbool isPerspective = isPerspectiveMatrix( projectionMatrix );\n\t\tif ( isPerspective ) gl_PointSize *= ( scale / - mvPosition.z );\n\t#endif\n\t#include \n\t#include \n\t#include \n\t#include \n}",shadow_frag:"uniform vec3 color;\nuniform float opacity;\n#include \n#include \n#include \n#include \n#include \n#include \n#include \nvoid main() {\n\tgl_FragColor = vec4( color, opacity * ( 1.0 - getShadowMask() ) );\n\t#include \n\t#include \n\t#include \n}",shadow_vert:"#include \n#include \n#include \nvoid main() {\n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n\t#include \n}",sprite_frag:"uniform vec3 diffuse;\nuniform float opacity;\n#include \n#include \n#include \n#include \n#include \n#include \n#include \nvoid main() {\n\t#include \n\tvec3 outgoingLight = vec3( 0.0 );\n\tvec4 diffuseColor = vec4( diffuse, opacity );\n\t#include \n\t#include \n\t#include \n\t#include \n\toutgoingLight = diffuseColor.rgb;\n\tgl_FragColor = vec4( outgoingLight, diffuseColor.a );\n\t#include \n\t#include \n\t#include \n}",sprite_vert:"uniform float rotation;\nuniform vec2 center;\n#include \n#include \n#include \n#include \n#include \nvoid main() {\n\t#include \n\tvec4 mvPosition = modelViewMatrix * vec4( 0.0, 0.0, 0.0, 1.0 );\n\tvec2 scale;\n\tscale.x = length( vec3( modelMatrix[ 0 ].x, modelMatrix[ 0 ].y, modelMatrix[ 0 ].z ) );\n\tscale.y = length( vec3( modelMatrix[ 1 ].x, modelMatrix[ 1 ].y, modelMatrix[ 1 ].z ) );\n\t#ifndef USE_SIZEATTENUATION\n\t\tbool isPerspective = isPerspectiveMatrix( projectionMatrix );\n\t\tif ( isPerspective ) scale *= - mvPosition.z;\n\t#endif\n\tvec2 alignedPosition = ( position.xy - ( center - vec2( 0.5 ) ) ) * scale;\n\tvec2 rotatedPosition;\n\trotatedPosition.x = cos( rotation ) * alignedPosition.x - sin( rotation ) * alignedPosition.y;\n\trotatedPosition.y = sin( rotation ) * alignedPosition.x + cos( rotation ) * alignedPosition.y;\n\tmvPosition.xy += rotatedPosition;\n\tgl_Position = projectionMatrix * mvPosition;\n\t#include \n\t#include \n\t#include \n}"},nr={common:{diffuse:{value:new Ve(15658734)},opacity:{value:1},map:{value:null},uvTransform:{value:new ft},uv2Transform:{value:new ft},alphaMap:{value:null}},specularmap:{specularMap:{value:null}},envmap:{envMap:{value:null},flipEnvMap:{value:-1},reflectivity:{value:1},refractionRatio:{value:.98},maxMipLevel:{value:0}},aomap:{aoMap:{value:null},aoMapIntensity:{value:1}},lightmap:{lightMap:{value:null},lightMapIntensity:{value:1}},emissivemap:{emissiveMap:{value:null}},bumpmap:{bumpMap:{value:null},bumpScale:{value:1}},normalmap:{normalMap:{value:null},normalScale:{value:new pt(1,1)}},displacementmap:{displacementMap:{value:null},displacementScale:{value:1},displacementBias:{value:0}},roughnessmap:{roughnessMap:{value:null}},metalnessmap:{metalnessMap:{value:null}},gradientmap:{gradientMap:{value:null}},fog:{fogDensity:{value:25e-5},fogNear:{value:1},fogFar:{value:2e3},fogColor:{value:new Ve(16777215)}},lights:{ambientLightColor:{value:[]},lightProbe:{value:[]},directionalLights:{value:[],properties:{direction:{},color:{}}},directionalLightShadows:{value:[],properties:{shadowBias:{},shadowNormalBias:{},shadowRadius:{},shadowMapSize:{}}},directionalShadowMap:{value:[]},directionalShadowMatrix:{value:[]},spotLights:{value:[],properties:{color:{},position:{},direction:{},distance:{},coneCos:{},penumbraCos:{},decay:{}}},spotLightShadows:{value:[],properties:{shadowBias:{},shadowNormalBias:{},shadowRadius:{},shadowMapSize:{}}},spotShadowMap:{value:[]},spotShadowMatrix:{value:[]},pointLights:{value:[],properties:{color:{},position:{},decay:{},distance:{}}},pointLightShadows:{value:[],properties:{shadowBias:{},shadowNormalBias:{},shadowRadius:{},shadowMapSize:{},shadowCameraNear:{},shadowCameraFar:{}}},pointShadowMap:{value:[]},pointShadowMatrix:{value:[]},hemisphereLights:{value:[],properties:{direction:{},skyColor:{},groundColor:{}}},rectAreaLights:{value:[],properties:{color:{},position:{},width:{},height:{}}},ltc_1:{value:null},ltc_2:{value:null}},points:{diffuse:{value:new Ve(15658734)},opacity:{value:1},size:{value:1},scale:{value:1},map:{value:null},alphaMap:{value:null},uvTransform:{value:new ft}},sprite:{diffuse:{value:new Ve(15658734)},opacity:{value:1},center:{value:new pt(.5,.5)},rotation:{value:0},map:{value:null},alphaMap:{value:null},uvTransform:{value:new ft}}},rr={basic:{uniforms:Fn([nr.common,nr.specularmap,nr.envmap,nr.aomap,nr.lightmap,nr.fog]),vertexShader:er.meshbasic_vert,fragmentShader:er.meshbasic_frag},lambert:{uniforms:Fn([nr.common,nr.specularmap,nr.envmap,nr.aomap,nr.lightmap,nr.emissivemap,nr.fog,nr.lights,{emissive:{value:new Ve(0)}}]),vertexShader:er.meshlambert_vert,fragmentShader:er.meshlambert_frag},phong:{uniforms:Fn([nr.common,nr.specularmap,nr.envmap,nr.aomap,nr.lightmap,nr.emissivemap,nr.bumpmap,nr.normalmap,nr.displacementmap,nr.fog,nr.lights,{emissive:{value:new Ve(0)},specular:{value:new Ve(1118481)},shininess:{value:30}}]),vertexShader:er.meshphong_vert,fragmentShader:er.meshphong_frag},standard:{uniforms:Fn([nr.common,nr.envmap,nr.aomap,nr.lightmap,nr.emissivemap,nr.bumpmap,nr.normalmap,nr.displacementmap,nr.roughnessmap,nr.metalnessmap,nr.fog,nr.lights,{emissive:{value:new Ve(0)},roughness:{value:1},metalness:{value:0},envMapIntensity:{value:1}}]),vertexShader:er.meshphysical_vert,fragmentShader:er.meshphysical_frag},toon:{uniforms:Fn([nr.common,nr.aomap,nr.lightmap,nr.emissivemap,nr.bumpmap,nr.normalmap,nr.displacementmap,nr.gradientmap,nr.fog,nr.lights,{emissive:{value:new Ve(0)}}]),vertexShader:er.meshtoon_vert,fragmentShader:er.meshtoon_frag},matcap:{uniforms:Fn([nr.common,nr.bumpmap,nr.normalmap,nr.displacementmap,nr.fog,{matcap:{value:null}}]),vertexShader:er.meshmatcap_vert,fragmentShader:er.meshmatcap_frag},points:{uniforms:Fn([nr.points,nr.fog]),vertexShader:er.points_vert,fragmentShader:er.points_frag},dashed:{uniforms:Fn([nr.common,nr.fog,{scale:{value:1},dashSize:{value:1},totalSize:{value:2}}]),vertexShader:er.linedashed_vert,fragmentShader:er.linedashed_frag},depth:{uniforms:Fn([nr.common,nr.displacementmap]),vertexShader:er.depth_vert,fragmentShader:er.depth_frag},normal:{uniforms:Fn([nr.common,nr.bumpmap,nr.normalmap,nr.displacementmap,{opacity:{value:1}}]),vertexShader:er.normal_vert,fragmentShader:er.normal_frag},sprite:{uniforms:Fn([nr.sprite,nr.fog]),vertexShader:er.sprite_vert,fragmentShader:er.sprite_frag},background:{uniforms:{uvTransform:{value:new ft},t2D:{value:null}},vertexShader:er.background_vert,fragmentShader:er.background_frag},cube:{uniforms:Fn([nr.envmap,{opacity:{value:1}}]),vertexShader:er.cube_vert,fragmentShader:er.cube_frag},equirect:{uniforms:{tEquirect:{value:null}},vertexShader:er.equirect_vert,fragmentShader:er.equirect_frag},distanceRGBA:{uniforms:Fn([nr.common,nr.displacementmap,{referencePosition:{value:new wt},nearDistance:{value:1},farDistance:{value:1e3}}]),vertexShader:er.distanceRGBA_vert,fragmentShader:er.distanceRGBA_frag},shadow:{uniforms:Fn([nr.lights,nr.fog,{color:{value:new Ve(0)},opacity:{value:1}}]),vertexShader:er.shadow_vert,fragmentShader:er.shadow_frag}};function ir(t,e,n,r,i){var a,o,c=new Ve(0),l=0,u=null,h=0,d=null;function p(t,e){n.buffers.color.setClear(t.r,t.g,t.b,e,i)}return{getClearColor:function(){return c},setClearColor:function(t,e){c.set(t),p(c,l=void 0!==e?e:1)},getClearAlpha:function(){return l},setClearAlpha:function(t){p(c,l=t)},render:function(n,i,f,m){var v=!0===i.isScene?i.background:null;v&&v.isTexture&&(v=e.get(v));var g=t.xr,y=g.getSession&&g.getSession();y&&"additive"===y.environmentBlendMode&&(v=null),null===v?p(c,l):v&&v.isColor&&(p(v,1),m=!0),(t.autoClear||m)&&t.clear(t.autoClearColor,t.autoClearDepth,t.autoClearStencil),v&&(v.isCubeTexture||v.isWebGLCubeRenderTarget||v.mapping===s)?(void 0===o&&((o=new Nn(new zn(1,1,1),new Hn({name:"BackgroundCubeMaterial",uniforms:Gn(rr.cube.uniforms),vertexShader:rr.cube.vertexShader,fragmentShader:rr.cube.fragmentShader,side:1,depthTest:!1,depthWrite:!1,fog:!1}))).geometry.deleteAttribute("normal"),o.geometry.deleteAttribute("uv"),o.onBeforeRender=function(t,e,n){this.matrixWorld.copyPosition(n.matrixWorld)},Object.defineProperty(o.material,"envMap",{get:function(){return this.uniforms.envMap.value}}),r.update(o)),v.isWebGLCubeRenderTarget&&(v=v.texture),o.material.uniforms.envMap.value=v,o.material.uniforms.flipEnvMap.value=v.isCubeTexture&&v._needsFlipEnvMap?-1:1,u===v&&h===v.version&&d===t.toneMapping||(o.material.needsUpdate=!0,u=v,h=v.version,d=t.toneMapping),n.unshift(o,o.geometry,o.material,0,0,null)):v&&v.isTexture&&(void 0===a&&((a=new Nn(new tr(2,2),new Hn({name:"BackgroundMaterial",uniforms:Gn(rr.background.uniforms),vertexShader:rr.background.vertexShader,fragmentShader:rr.background.fragmentShader,side:0,depthTest:!1,depthWrite:!1,fog:!1}))).geometry.deleteAttribute("normal"),Object.defineProperty(a.material,"map",{get:function(){return this.uniforms.t2D.value}}),r.update(a)),a.material.uniforms.t2D.value=v,!0===v.matrixAutoUpdate&&v.updateMatrix(),a.material.uniforms.uvTransform.value.copy(v.matrix),u===v&&h===v.version&&d===t.toneMapping||(a.material.needsUpdate=!0,u=v,h=v.version,d=t.toneMapping),n.unshift(a,a.geometry,a.material,0,0,null))}}}function ar(t,e,n,r){var i=t.getParameter(34921),a=r.isWebGL2?null:e.get("OES_vertex_array_object"),o=r.isWebGL2||null!==a,s={},c=d(null),l=c;function u(e){return r.isWebGL2?t.bindVertexArray(e):a.bindVertexArrayOES(e)}function h(e){return r.isWebGL2?t.deleteVertexArray(e):a.deleteVertexArrayOES(e)}function d(t){for(var e=[],n=[],r=[],a=0;a=0){var y=c[h];if(void 0!==y){var x=y.normalized,_=y.itemSize,b=n.get(y);if(void 0===b)continue;var w=b.buffer,M=b.type,S=b.bytesPerElement;if(y.isInterleavedBufferAttribute){var T=y.data,E=T.stride,A=y.offset;T&&T.isInstancedInterleavedBuffer?(m(d,T.meshPerAttribute),void 0===s._maxInstanceCount&&(s._maxInstanceCount=T.meshPerAttribute*T.count)):f(d),t.bindBuffer(34962,w),g(d,_,M,x,E*S,A*S)}else y.isInstancedBufferAttribute?(m(d,y.meshPerAttribute),void 0===s._maxInstanceCount&&(s._maxInstanceCount=y.meshPerAttribute*y.count)):f(d),t.bindBuffer(34962,w),g(d,_,M,x,0,0)}else if("instanceMatrix"===h){var L=n.get(i.instanceMatrix);if(void 0===L)continue;var R=L.buffer,C=L.type;m(d+0,1),m(d+1,1),m(d+2,1),m(d+3,1),t.bindBuffer(34962,R),t.vertexAttribPointer(d+0,4,C,!1,64,0),t.vertexAttribPointer(d+1,4,C,!1,64,16),t.vertexAttribPointer(d+2,4,C,!1,64,32),t.vertexAttribPointer(d+3,4,C,!1,64,48)}else if("instanceColor"===h){var P=n.get(i.instanceColor);if(void 0===P)continue;var I=P.buffer,D=P.type;m(d,1),t.bindBuffer(34962,I),t.vertexAttribPointer(d,3,D,!1,12,0)}else if(void 0!==u){var N=u[h];if(void 0!==N)switch(N.length){case 2:t.vertexAttrib2fv(d,N);break;case 3:t.vertexAttrib3fv(d,N);break;case 4:t.vertexAttrib4fv(d,N);break;default:t.vertexAttrib1fv(d,N)}}}}v()}(i,c,h,y),null!==x&&t.bindBuffer(34963,n.get(x).buffer))},reset:y,resetDefaultState:x,dispose:function(){for(var t in y(),s){var e=s[t];for(var n in e){var r=e[n];for(var i in r)h(r[i].object),delete r[i];delete e[n]}delete s[t]}},releaseStatesOfGeometry:function(t){if(void 0!==s[t.id]){var e=s[t.id];for(var n in e){var r=e[n];for(var i in r)h(r[i].object),delete r[i];delete e[n]}delete s[t.id]}},releaseStatesOfProgram:function(t){for(var e in s){var n=s[e];if(void 0!==n[t.id]){var r=n[t.id];for(var i in r)h(r[i].object),delete r[i];delete n[t.id]}}},initAttributes:p,enableAttribute:f,disableUnusedAttributes:v}}function or(t,e,n,r){var i,a=r.isWebGL2;this.setMode=function(t){i=t},this.render=function(e,r){t.drawArrays(i,e,r),n.update(r,i,1)},this.renderInstances=function(r,o,s){if(0!==s){var c,l;if(a)c=t,l="drawArraysInstanced";else if(l="drawArraysInstancedANGLE",null===(c=e.get("ANGLE_instanced_arrays")))return void console.error("THREE.WebGLBufferRenderer: using THREE.InstancedBufferGeometry but hardware does not support extension ANGLE_instanced_arrays.");c[l](i,r,o,s),n.update(o,i,s)}}}function sr(t,e,n){var r;function i(e){if("highp"===e){if(t.getShaderPrecisionFormat(35633,36338).precision>0&&t.getShaderPrecisionFormat(35632,36338).precision>0)return"highp";e="mediump"}return"mediump"===e&&t.getShaderPrecisionFormat(35633,36337).precision>0&&t.getShaderPrecisionFormat(35632,36337).precision>0?"mediump":"lowp"}var a="undefined"!=typeof WebGL2RenderingContext&&t instanceof WebGL2RenderingContext||"undefined"!=typeof WebGL2ComputeRenderingContext&&t instanceof WebGL2ComputeRenderingContext,o=void 0!==n.precision?n.precision:"highp",s=i(o);s!==o&&(console.warn("THREE.WebGLRenderer:",o,"not supported, using",s,"instead."),o=s);var c=!0===n.logarithmicDepthBuffer,l=t.getParameter(34930),u=t.getParameter(35660),h=t.getParameter(3379),d=t.getParameter(34076),p=t.getParameter(34921),f=t.getParameter(36347),m=t.getParameter(36348),v=t.getParameter(36349),g=u>0,y=a||!!e.get("OES_texture_float");return{isWebGL2:a,getMaxAnisotropy:function(){if(void 0!==r)return r;var n=e.get("EXT_texture_filter_anisotropic");return r=null!==n?t.getParameter(n.MAX_TEXTURE_MAX_ANISOTROPY_EXT):0},getMaxPrecision:i,precision:o,logarithmicDepthBuffer:c,maxTextures:l,maxVertexTextures:u,maxTextureSize:h,maxCubemapSize:d,maxAttributes:p,maxVertexUniforms:f,maxVaryings:m,maxFragmentUniforms:v,vertexTextures:g,floatFragmentTextures:y,floatVertexTextures:g&&y,maxSamples:a?t.getParameter(36183):0}}function cr(t){var e=this,n=null,r=0,i=!1,a=!1,o=new Te,s=new ft,c={value:null,needsUpdate:!1};function l(){c.value!==n&&(c.value=n,c.needsUpdate=r>0),e.numPlanes=r,e.numIntersection=0}function u(t,n,r,i){var a=null!==t?t.length:0,l=null;if(0!==a){if(l=c.value,!0!==i||null===l){var u=r+4*a,h=n.matrixWorldInverse;s.getNormalMatrix(h),(null===l||l.length0){var c=t.getRenderList(),l=t.getRenderTarget(),u=t.getRenderState(),h=new Xn(s.height/2);return h.fromEquirectangularTexture(t,r),e.set(r,h),t.setRenderTarget(l),t.setRenderList(c),t.setRenderState(u),n(h.texture,r.mapping)}return null}}return r},dispose:function(){e=new WeakMap}}}function ur(t){var e={};return{has:function(n){if(void 0!==e[n])return null!==e[n];var r;switch(n){case"WEBGL_depth_texture":r=t.getExtension("WEBGL_depth_texture")||t.getExtension("MOZ_WEBGL_depth_texture")||t.getExtension("WEBKIT_WEBGL_depth_texture");break;case"EXT_texture_filter_anisotropic":r=t.getExtension("EXT_texture_filter_anisotropic")||t.getExtension("MOZ_EXT_texture_filter_anisotropic")||t.getExtension("WEBKIT_EXT_texture_filter_anisotropic");break;case"WEBGL_compressed_texture_s3tc":r=t.getExtension("WEBGL_compressed_texture_s3tc")||t.getExtension("MOZ_WEBGL_compressed_texture_s3tc")||t.getExtension("WEBKIT_WEBGL_compressed_texture_s3tc");break;case"WEBGL_compressed_texture_pvrtc":r=t.getExtension("WEBGL_compressed_texture_pvrtc")||t.getExtension("WEBKIT_WEBGL_compressed_texture_pvrtc");break;default:r=t.getExtension(n)}return e[n]=r,null!==r},get:function(t){return this.has(t)||console.warn("THREE.WebGLRenderer: "+t+" extension not supported."),e[t]}}}function hr(t,e,n,r){var i=new WeakMap,a=new WeakMap;function o(t){var s=t.target,c=i.get(s);for(var l in null!==c.index&&e.remove(c.index),c.attributes)e.remove(c.attributes[l]);s.removeEventListener("dispose",o),i.delete(s);var u=a.get(c);u&&(e.remove(u),a.delete(c)),r.releaseStatesOfGeometry(s),!0===s.isInstancedBufferGeometry&&delete s._maxInstanceCount,n.memory.geometries--}function s(t){var n=[],r=t.index,i=t.attributes.position,o=0;if(null!==r){var s=r.array;o=r.version;for(var c=0,l=s.length;c65535?rn:en)(n,1);x.version=o;var _=a.get(t);_&&e.remove(_),a.set(t,x)}return{get:function(t,e){var r=i.get(e);return r||(e.addEventListener("dispose",o),e.isBufferGeometry?r=e:e.isGeometry&&(void 0===e._bufferGeometry&&(e._bufferGeometry=(new vn).setFromObject(t)),r=e._bufferGeometry),i.set(e,r),n.memory.geometries++,r)},update:function(t){var n=t.attributes;for(var r in n)e.update(n[r],34962);var i=t.morphAttributes;for(var a in i)for(var o=i[a],s=0,c=o.length;s0)return t;var i=e*n,a=Sr[i];if(void 0===a&&(a=new Float32Array(i),Sr[i]=a),0!==e){r.toArray(a,0);for(var o=1,s=0;o!==e;++o)s+=n,t[o].toArray(a,s)}return a}function Cr(t,e){if(t.length!==e.length)return!1;for(var n=0,r=t.length;n/gm;function Ti(t){return t.replace(Si,Ei)}function Ei(t,e){var n=er[e];if(void 0===n)throw new Error("Can not resolve #include <"+e+">");return Ti(n)}var Ai=/#pragma unroll_loop[\s]+?for \( int i \= (\d+)\; i < (\d+)\; i \+\+ \) \{([\s\S]+?)(?=\})\}/g,Li=/#pragma unroll_loop_start\s+for\s*\(\s*int\s+i\s*=\s*(\d+)\s*;\s*i\s*<\s*(\d+)\s*;\s*i\s*\+\+\s*\)\s*{([\s\S]+?)}\s+#pragma unroll_loop_end/g;function Ri(t){return t.replace(Li,Pi).replace(Ai,Ci)}function Ci(t,e,n,r){return console.warn("WebGLProgram: #pragma unroll_loop shader syntax is deprecated. Please use #pragma unroll_loop_start syntax instead."),Pi(t,e,n,r)}function Pi(t,e,n,r){for(var i="",a=parseInt(e);a0?t.gammaFactor:1,w=n.isWebGL2?"":function(t){return[t.extensionDerivatives||t.envMapCubeUV||t.bumpMap||t.tangentSpaceNormalMap||t.clearcoatNormalMap||t.flatShading||"physical"===t.shaderID?"#extension GL_OES_standard_derivatives : enable":"",(t.extensionFragDepth||t.logarithmicDepthBuffer)&&t.rendererExtensionFragDepth?"#extension GL_EXT_frag_depth : enable":"",t.extensionDrawBuffers&&t.rendererExtensionDrawBuffers?"#extension GL_EXT_draw_buffers : require":"",(t.extensionShaderTextureLOD||t.envMap)&&t.rendererExtensionShaderTextureLod?"#extension GL_EXT_shader_texture_lod : enable":""].filter(bi).join("\n")}(n),M=function(t){var e=[];for(var n in t){var r=t[n];!1!==r&&e.push("#define "+n+" "+r)}return e.join("\n")}(f),S=p.createProgram(),T=n.glslVersion?"#version "+n.glslVersion+"\n":"";n.isRawShaderMaterial?((o=[M].filter(bi).join("\n")).length>0&&(o+="\n"),(l=[w,M].filter(bi).join("\n")).length>0&&(l+="\n")):(o=[Ii(n),"#define SHADER_NAME "+n.shaderName,M,n.instancing?"#define USE_INSTANCING":"",n.instancingColor?"#define USE_INSTANCING_COLOR":"",n.supportsVertexTextures?"#define VERTEX_TEXTURES":"","#define GAMMA_FACTOR "+b,"#define MAX_BONES "+n.maxBones,n.useFog&&n.fog?"#define USE_FOG":"",n.useFog&&n.fogExp2?"#define FOG_EXP2":"",n.map?"#define USE_MAP":"",n.envMap?"#define USE_ENVMAP":"",n.envMap?"#define "+x:"",n.lightMap?"#define USE_LIGHTMAP":"",n.aoMap?"#define USE_AOMAP":"",n.emissiveMap?"#define USE_EMISSIVEMAP":"",n.bumpMap?"#define USE_BUMPMAP":"",n.normalMap?"#define USE_NORMALMAP":"",n.normalMap&&n.objectSpaceNormalMap?"#define OBJECTSPACE_NORMALMAP":"",n.normalMap&&n.tangentSpaceNormalMap?"#define TANGENTSPACE_NORMALMAP":"",n.clearcoatMap?"#define USE_CLEARCOATMAP":"",n.clearcoatRoughnessMap?"#define USE_CLEARCOAT_ROUGHNESSMAP":"",n.clearcoatNormalMap?"#define USE_CLEARCOAT_NORMALMAP":"",n.displacementMap&&n.supportsVertexTextures?"#define USE_DISPLACEMENTMAP":"",n.specularMap?"#define USE_SPECULARMAP":"",n.roughnessMap?"#define USE_ROUGHNESSMAP":"",n.metalnessMap?"#define USE_METALNESSMAP":"",n.alphaMap?"#define USE_ALPHAMAP":"",n.transmissionMap?"#define USE_TRANSMISSIONMAP":"",n.vertexTangents?"#define USE_TANGENT":"",n.vertexColors?"#define USE_COLOR":"",n.vertexUvs?"#define USE_UV":"",n.uvsVertexOnly?"#define UVS_VERTEX_ONLY":"",n.flatShading?"#define FLAT_SHADED":"",n.skinning?"#define USE_SKINNING":"",n.useVertexTexture?"#define BONE_TEXTURE":"",n.morphTargets?"#define USE_MORPHTARGETS":"",n.morphNormals&&!1===n.flatShading?"#define USE_MORPHNORMALS":"",n.doubleSided?"#define DOUBLE_SIDED":"",n.flipSided?"#define FLIP_SIDED":"",n.shadowMapEnabled?"#define USE_SHADOWMAP":"",n.shadowMapEnabled?"#define "+g:"",n.sizeAttenuation?"#define USE_SIZEATTENUATION":"",n.logarithmicDepthBuffer?"#define USE_LOGDEPTHBUF":"",n.logarithmicDepthBuffer&&n.rendererExtensionFragDepth?"#define USE_LOGDEPTHBUF_EXT":"","uniform mat4 modelMatrix;","uniform mat4 modelViewMatrix;","uniform mat4 projectionMatrix;","uniform mat4 viewMatrix;","uniform mat3 normalMatrix;","uniform vec3 cameraPosition;","uniform bool isOrthographic;","#ifdef USE_INSTANCING","\tattribute mat4 instanceMatrix;","#endif","#ifdef USE_INSTANCING_COLOR","\tattribute vec3 instanceColor;","#endif","attribute vec3 position;","attribute vec3 normal;","attribute vec2 uv;","#ifdef USE_TANGENT","\tattribute vec4 tangent;","#endif","#ifdef USE_COLOR","\tattribute vec3 color;","#endif","#ifdef USE_MORPHTARGETS","\tattribute vec3 morphTarget0;","\tattribute vec3 morphTarget1;","\tattribute vec3 morphTarget2;","\tattribute vec3 morphTarget3;","\t#ifdef USE_MORPHNORMALS","\t\tattribute vec3 morphNormal0;","\t\tattribute vec3 morphNormal1;","\t\tattribute vec3 morphNormal2;","\t\tattribute vec3 morphNormal3;","\t#else","\t\tattribute vec3 morphTarget4;","\t\tattribute vec3 morphTarget5;","\t\tattribute vec3 morphTarget6;","\t\tattribute vec3 morphTarget7;","\t#endif","#endif","#ifdef USE_SKINNING","\tattribute vec4 skinIndex;","\tattribute vec4 skinWeight;","#endif","\n"].filter(bi).join("\n"),l=[w,Ii(n),"#define SHADER_NAME "+n.shaderName,M,n.alphaTest?"#define ALPHATEST "+n.alphaTest+(n.alphaTest%1?"":".0"):"","#define GAMMA_FACTOR "+b,n.useFog&&n.fog?"#define USE_FOG":"",n.useFog&&n.fogExp2?"#define FOG_EXP2":"",n.map?"#define USE_MAP":"",n.matcap?"#define USE_MATCAP":"",n.envMap?"#define USE_ENVMAP":"",n.envMap?"#define "+y:"",n.envMap?"#define "+x:"",n.envMap?"#define "+_:"",n.lightMap?"#define USE_LIGHTMAP":"",n.aoMap?"#define USE_AOMAP":"",n.emissiveMap?"#define USE_EMISSIVEMAP":"",n.bumpMap?"#define USE_BUMPMAP":"",n.normalMap?"#define USE_NORMALMAP":"",n.normalMap&&n.objectSpaceNormalMap?"#define OBJECTSPACE_NORMALMAP":"",n.normalMap&&n.tangentSpaceNormalMap?"#define TANGENTSPACE_NORMALMAP":"",n.clearcoatMap?"#define USE_CLEARCOATMAP":"",n.clearcoatRoughnessMap?"#define USE_CLEARCOAT_ROUGHNESSMAP":"",n.clearcoatNormalMap?"#define USE_CLEARCOAT_NORMALMAP":"",n.specularMap?"#define USE_SPECULARMAP":"",n.roughnessMap?"#define USE_ROUGHNESSMAP":"",n.metalnessMap?"#define USE_METALNESSMAP":"",n.alphaMap?"#define USE_ALPHAMAP":"",n.sheen?"#define USE_SHEEN":"",n.transmissionMap?"#define USE_TRANSMISSIONMAP":"",n.vertexTangents?"#define USE_TANGENT":"",n.vertexColors||n.instancingColor?"#define USE_COLOR":"",n.vertexUvs?"#define USE_UV":"",n.uvsVertexOnly?"#define UVS_VERTEX_ONLY":"",n.gradientMap?"#define USE_GRADIENTMAP":"",n.flatShading?"#define FLAT_SHADED":"",n.doubleSided?"#define DOUBLE_SIDED":"",n.flipSided?"#define FLIP_SIDED":"",n.shadowMapEnabled?"#define USE_SHADOWMAP":"",n.shadowMapEnabled?"#define "+g:"",n.premultipliedAlpha?"#define PREMULTIPLIED_ALPHA":"",n.physicallyCorrectLights?"#define PHYSICALLY_CORRECT_LIGHTS":"",n.logarithmicDepthBuffer?"#define USE_LOGDEPTHBUF":"",n.logarithmicDepthBuffer&&n.rendererExtensionFragDepth?"#define USE_LOGDEPTHBUF_EXT":"",(n.extensionShaderTextureLOD||n.envMap)&&n.rendererExtensionShaderTextureLod?"#define TEXTURE_LOD_EXT":"","uniform mat4 viewMatrix;","uniform vec3 cameraPosition;","uniform bool isOrthographic;",0!==n.toneMapping?"#define TONE_MAPPING":"",0!==n.toneMapping?er.tonemapping_pars_fragment:"",0!==n.toneMapping?_i("toneMapping",n.toneMapping):"",n.dithering?"#define DITHERING":"",er.encodings_pars_fragment,n.map?xi("mapTexelToLinear",n.mapEncoding):"",n.matcap?xi("matcapTexelToLinear",n.matcapEncoding):"",n.envMap?xi("envMapTexelToLinear",n.envMapEncoding):"",n.emissiveMap?xi("emissiveMapTexelToLinear",n.emissiveMapEncoding):"",n.lightMap?xi("lightMapTexelToLinear",n.lightMapEncoding):"",(u="linearToOutputTexel",h=n.outputEncoding,d=gi(h),"vec4 "+u+"( vec4 value ) { return LinearTo"+d[0]+d[1]+"; }"),n.depthPacking?"#define DEPTH_PACKING "+n.depthPacking:"","\n"].filter(bi).join("\n")),m=Mi(m=wi(m=Ti(m),n),n),v=Mi(v=wi(v=Ti(v),n),n),m=Ri(m),v=Ri(v),n.isWebGL2&&!0!==n.isRawShaderMaterial&&(T="#version 300 es\n",o=["#define attribute in","#define varying out","#define texture2D texture"].join("\n")+"\n"+o,l=["#define varying in",n.glslVersion===nt?"":"out highp vec4 pc_fragColor;",n.glslVersion===nt?"":"#define gl_FragColor pc_fragColor","#define gl_FragDepthEXT gl_FragDepth","#define texture2D texture","#define textureCube texture","#define texture2DProj textureProj","#define texture2DLodEXT textureLod","#define texture2DProjLodEXT textureProjLod","#define textureCubeLodEXT textureLod","#define texture2DGradEXT textureGrad","#define texture2DProjGradEXT textureProjGrad","#define textureCubeGradEXT textureGrad"].join("\n")+"\n"+l);var E,A,L=T+l+v,R=mi(p,35633,T+o+m),C=mi(p,35632,L);if(p.attachShader(S,R),p.attachShader(S,C),void 0!==n.index0AttributeName?p.bindAttribLocation(S,0,n.index0AttributeName):!0===n.morphTargets&&p.bindAttribLocation(S,0,"position"),p.linkProgram(S),t.debug.checkShaderErrors){var P=p.getProgramInfoLog(S).trim(),I=p.getShaderInfoLog(R).trim(),D=p.getShaderInfoLog(C).trim(),N=!0,O=!0;if(!1===p.getProgramParameter(S,35714)){N=!1;var B=yi(p,R,"vertex"),z=yi(p,C,"fragment");console.error("THREE.WebGLProgram: shader error: ",p.getError(),"35715",p.getProgramParameter(S,35715),"gl.getProgramInfoLog",P,B,z)}else""!==P?console.warn("THREE.WebGLProgram: gl.getProgramInfoLog()",P):""!==I&&""!==D||(O=!1);O&&(this.diagnostics={runnable:N,programLog:P,vertexShader:{log:I,prefix:o},fragmentShader:{log:D,prefix:l}})}return p.deleteShader(R),p.deleteShader(C),this.getUniforms=function(){return void 0===E&&(E=new fi(p,S)),E},this.getAttributes=function(){return void 0===A&&(A=function(t,e){for(var n={},r=t.getProgramParameter(e,35721),i=0;i0,maxBones:E,useVertexTexture:h,morphTargets:i.morphTargets,morphNormals:i.morphNormals,maxMorphTargets:t.maxMorphTargets,maxMorphNormals:t.maxMorphNormals,numDirLights:o.directional.length,numPointLights:o.point.length,numSpotLights:o.spot.length,numRectAreaLights:o.rectArea.length,numHemiLights:o.hemi.length,numDirLightShadows:o.directionalShadowMap.length,numPointLightShadows:o.pointShadowMap.length,numSpotLightShadows:o.spotShadowMap.length,numClippingPlanes:a.numPlanes,numClipIntersection:a.numIntersection,dithering:i.dithering,shadowMapEnabled:t.shadowMap.enabled&&v.length>0,shadowMapType:t.shadowMap.type,toneMapping:i.toneMapped?t.toneMapping:0,physicallyCorrectLights:t.physicallyCorrectLights,premultipliedAlpha:i.premultipliedAlpha,alphaTest:i.alphaTest,doubleSided:2===i.side,flipSided:1===i.side,depthPacking:void 0!==i.depthPacking&&i.depthPacking,index0AttributeName:i.index0AttributeName,extensionDerivatives:i.extensions&&i.extensions.derivatives,extensionFragDepth:i.extensions&&i.extensions.fragDepth,extensionDrawBuffers:i.extensions&&i.extensions.drawBuffers,extensionShaderTextureLOD:i.extensions&&i.extensions.shaderTextureLOD,rendererExtensionFragDepth:l||n.has("EXT_frag_depth"),rendererExtensionDrawBuffers:l||n.has("WEBGL_draw_buffers"),rendererExtensionShaderTextureLod:l||n.has("EXT_shader_texture_lod"),customProgramCacheKey:i.customProgramCacheKey()}},getProgramCacheKey:function(e){var n=[];if(e.shaderID?n.push(e.shaderID):(n.push(e.fragmentShader),n.push(e.vertexShader)),void 0!==e.defines)for(var r in e.defines)n.push(r),n.push(e.defines[r]);if(!1===e.isRawShaderMaterial){for(var i=0;i1&&r.sort(t||Bi),i.length>1&&i.sort(e||zi)}}}function Fi(t){var e=new WeakMap;return{get:function(n,r){var i,a=e.get(n);return void 0===a?(i=new Gi(t),e.set(n,new WeakMap),e.get(n).set(r,i)):void 0===(i=a.get(r))&&(i=new Gi(t),a.set(r,i)),i},dispose:function(){e=new WeakMap}}}function Ui(){var t={};return{get:function(e){if(void 0!==t[e.id])return t[e.id];var n;switch(e.type){case"DirectionalLight":n={direction:new wt,color:new Ve};break;case"SpotLight":n={position:new wt,direction:new wt,color:new Ve,distance:0,coneCos:0,penumbraCos:0,decay:0};break;case"PointLight":n={position:new wt,color:new Ve,distance:0,decay:0};break;case"HemisphereLight":n={direction:new wt,skyColor:new Ve,groundColor:new Ve};break;case"RectAreaLight":n={color:new Ve,position:new wt,halfWidth:new wt,halfHeight:new wt}}return t[e.id]=n,n}}}var Hi=0;function ki(t,e){return(e.castShadow?1:0)-(t.castShadow?1:0)}function Vi(){for(var t,e=new Ui,n=(t={},{get:function(e){if(void 0!==t[e.id])return t[e.id];var n;switch(e.type){case"DirectionalLight":case"SpotLight":n={shadowBias:0,shadowNormalBias:0,shadowRadius:1,shadowMapSize:new pt};break;case"PointLight":n={shadowBias:0,shadowNormalBias:0,shadowRadius:1,shadowMapSize:new pt,shadowCameraNear:1,shadowCameraFar:1e3}}return t[e.id]=n,n}}),r={version:0,hash:{directionalLength:-1,pointLength:-1,spotLength:-1,rectAreaLength:-1,hemiLength:-1,numDirectionalShadows:-1,numPointShadows:-1,numSpotShadows:-1},ambient:[0,0,0],probe:[],directional:[],directionalShadow:[],directionalShadowMap:[],directionalShadowMatrix:[],spot:[],spotShadow:[],spotShadowMap:[],spotShadowMatrix:[],rectArea:[],rectAreaLTC1:null,rectAreaLTC2:null,point:[],pointShadow:[],pointShadowMap:[],pointShadowMatrix:[],hemi:[]},i=0;i<9;i++)r.probe.push(new wt);var a=new wt,o=new Jt,s=new Jt;return{setup:function(t,i,c){for(var l=0,u=0,h=0,d=0;d<9;d++)r.probe[d].set(0,0,0);var p=0,f=0,m=0,v=0,g=0,y=0,x=0,_=0,b=c.matrixWorldInverse;t.sort(ki);for(var w=0,M=t.length;w0&&(r.rectAreaLTC1=nr.LTC_1,r.rectAreaLTC2=nr.LTC_2),r.ambient[0]=l,r.ambient[1]=u,r.ambient[2]=h;var H=r.hash;H.directionalLength===p&&H.pointLength===f&&H.spotLength===m&&H.rectAreaLength===v&&H.hemiLength===g&&H.numDirectionalShadows===y&&H.numPointShadows===x&&H.numSpotShadows===_||(r.directional.length=p,r.spot.length=m,r.rectArea.length=v,r.point.length=f,r.hemi.length=g,r.directionalShadow.length=y,r.directionalShadowMap.length=y,r.pointShadow.length=x,r.pointShadowMap.length=x,r.spotShadow.length=_,r.spotShadowMap.length=_,r.directionalShadowMatrix.length=y,r.pointShadowMatrix.length=x,r.spotShadowMatrix.length=_,H.directionalLength=p,H.pointLength=f,H.spotLength=m,H.rectAreaLength=v,H.hemiLength=g,H.numDirectionalShadows=y,H.numPointShadows=x,H.numSpotShadows=_,r.version=Hi++)},state:r}}function Wi(){var t=new Vi,e=[],n=[];return{init:function(){e.length=0,n.length=0},state:{lightsArray:e,shadowsArray:n,lights:t},setupLights:function(r){t.setup(e,n,r)},pushLight:function(t){e.push(t)},pushShadow:function(t){n.push(t)}}}function ji(){var t=new WeakMap;return{get:function(e,n){var r;return!1===t.has(e)?(r=new Wi,t.set(e,new WeakMap),t.get(e).set(n,r)):!1===t.get(e).has(n)?(r=new Wi,t.get(e).set(n,r)):r=t.get(e).get(n),r},dispose:function(){t=new WeakMap}}}function qi(t){qe.call(this),this.type="MeshDepthMaterial",this.depthPacking=3200,this.skinning=!1,this.morphTargets=!1,this.map=null,this.alphaMap=null,this.displacementMap=null,this.displacementScale=1,this.displacementBias=0,this.wireframe=!1,this.wireframeLinewidth=1,this.fog=!1,this.setValues(t)}function Xi(t){qe.call(this),this.type="MeshDistanceMaterial",this.referencePosition=new wt,this.nearDistance=1,this.farDistance=1e3,this.skinning=!1,this.morphTargets=!1,this.map=null,this.alphaMap=null,this.displacementMap=null,this.displacementScale=1,this.displacementBias=0,this.fog=!1,this.setValues(t)}qi.prototype=Object.create(qe.prototype),qi.prototype.constructor=qi,qi.prototype.isMeshDepthMaterial=!0,qi.prototype.copy=function(t){return qe.prototype.copy.call(this,t),this.depthPacking=t.depthPacking,this.skinning=t.skinning,this.morphTargets=t.morphTargets,this.map=t.map,this.alphaMap=t.alphaMap,this.displacementMap=t.displacementMap,this.displacementScale=t.displacementScale,this.displacementBias=t.displacementBias,this.wireframe=t.wireframe,this.wireframeLinewidth=t.wireframeLinewidth,this},Xi.prototype=Object.create(qe.prototype),Xi.prototype.constructor=Xi,Xi.prototype.isMeshDistanceMaterial=!0,Xi.prototype.copy=function(t){return qe.prototype.copy.call(this,t),this.referencePosition.copy(t.referencePosition),this.nearDistance=t.nearDistance,this.farDistance=t.farDistance,this.skinning=t.skinning,this.morphTargets=t.morphTargets,this.map=t.map,this.alphaMap=t.alphaMap,this.displacementMap=t.displacementMap,this.displacementScale=t.displacementScale,this.displacementBias=t.displacementBias,this};function Yi(t,e,n){var r=new Qn,i=new pt,a=new pt,o=new yt,s=[],c=[],l={},u={0:1,1:0,2:2},h=new Hn({defines:{SAMPLE_RATE:2/8,HALF_SAMPLE_RATE:1/8},uniforms:{shadow_pass:{value:null},resolution:{value:new pt},radius:{value:4}},vertexShader:"void main() {\n\tgl_Position = vec4( position, 1.0 );\n}",fragmentShader:"uniform sampler2D shadow_pass;\nuniform vec2 resolution;\nuniform float radius;\n#include \nvoid main() {\n\tfloat mean = 0.0;\n\tfloat squared_mean = 0.0;\n\tfloat depth = unpackRGBAToDepth( texture2D( shadow_pass, ( gl_FragCoord.xy ) / resolution ) );\n\tfor ( float i = -1.0; i < 1.0 ; i += SAMPLE_RATE) {\n\t\t#ifdef HORIZONAL_PASS\n\t\t\tvec2 distribution = unpackRGBATo2Half( texture2D( shadow_pass, ( gl_FragCoord.xy + vec2( i, 0.0 ) * radius ) / resolution ) );\n\t\t\tmean += distribution.x;\n\t\t\tsquared_mean += distribution.y * distribution.y + distribution.x * distribution.x;\n\t\t#else\n\t\t\tfloat depth = unpackRGBAToDepth( texture2D( shadow_pass, ( gl_FragCoord.xy + vec2( 0.0, i ) * radius ) / resolution ) );\n\t\t\tmean += depth;\n\t\t\tsquared_mean += depth * depth;\n\t\t#endif\n\t}\n\tmean = mean * HALF_SAMPLE_RATE;\n\tsquared_mean = squared_mean * HALF_SAMPLE_RATE;\n\tfloat std_dev = sqrt( squared_mean - mean * mean );\n\tgl_FragColor = pack2HalfToRGBA( vec2( mean, std_dev ) );\n}"}),p=h.clone();p.defines.HORIZONAL_PASS=1;var f=new vn;f.setAttribute("position",new Je(new Float32Array([-1,-1,.5,3,-1,.5,-1,3,.5]),3));var v=new Nn(f,h),g=this;function y(n,r){var i=e.update(v);h.uniforms.shadow_pass.value=n.map.texture,h.uniforms.resolution.value=n.mapSize,h.uniforms.radius.value=n.radius,t.setRenderTarget(n.mapPass),t.clear(),t.renderBufferDirect(r,null,i,h,v,null),p.uniforms.shadow_pass.value=n.mapPass.texture,p.uniforms.resolution.value=n.mapSize,p.uniforms.radius.value=n.radius,t.setRenderTarget(n.map),t.clear(),t.renderBufferDirect(r,null,i,p,v,null)}function x(t,e,n){var r=t<<0|e<<1|n<<2,i=s[r];return void 0===i&&(i=new qi({depthPacking:3201,morphTargets:t,skinning:e}),s[r]=i),i}function _(t,e,n){var r=t<<0|e<<1|n<<2,i=c[r];return void 0===i&&(i=new Xi({morphTargets:t,skinning:e}),c[r]=i),i}function b(e,n,r,i,a,o,s){var c=null,h=x,d=e.customDepthMaterial;if(!0===i.isPointLight&&(h=_,d=e.customDistanceMaterial),void 0===d){var p=!1;!0===r.morphTargets&&(p=n.morphAttributes&&n.morphAttributes.position&&n.morphAttributes.position.length>0);var f=!1;!0===e.isSkinnedMesh&&(!0===r.skinning?f=!0:console.warn("THREE.WebGLShadowMap: THREE.SkinnedMesh with material.skinning set to false:",e)),c=h(p,f,!0===e.isInstancedMesh)}else c=d;if(t.localClippingEnabled&&!0===r.clipShadows&&0!==r.clippingPlanes.length){var m=c.uuid,v=r.uuid,g=l[m];void 0===g&&(g={},l[m]=g);var y=g[v];void 0===y&&(y=c.clone(),g[v]=y),c=y}return c.visible=r.visible,c.wireframe=r.wireframe,c.side=3===s?null!==r.shadowSide?r.shadowSide:r.side:null!==r.shadowSide?r.shadowSide:u[r.side],c.clipShadows=r.clipShadows,c.clippingPlanes=r.clippingPlanes,c.clipIntersection=r.clipIntersection,c.wireframeLinewidth=r.wireframeLinewidth,c.linewidth=r.linewidth,!0===i.isPointLight&&!0===c.isMeshDistanceMaterial&&(c.referencePosition.setFromMatrixPosition(i.matrixWorld),c.nearDistance=a,c.farDistance=o),c}function w(n,i,a,o,s){if(!1!==n.visible){if(n.layers.test(i.layers)&&(n.isMesh||n.isLine||n.isPoints)&&(n.castShadow||n.receiveShadow&&3===s)&&(!n.frustumCulled||r.intersectsObject(n))){n.modelViewMatrix.multiplyMatrices(a.matrixWorldInverse,n.matrixWorld);var c=e.update(n),l=n.material;if(Array.isArray(l))for(var u=c.groups,h=0,d=u.length;hn||i.y>n)&&(i.x>n&&(a.x=Math.floor(n/b.x),i.x=a.x*b.x,_.mapSize.x=a.x),i.y>n&&(a.y=Math.floor(n/b.y),i.y=a.y*b.y,_.mapSize.y=a.y)),null===_.map&&!_.isPointLightShadow&&3===this.type){var M={minFilter:m,magFilter:m,format:T};_.map=new xt(i.x,i.y,M),_.map.texture.name=x.name+".shadowMap",_.mapPass=new xt(i.x,i.y,M),_.camera.updateProjectionMatrix()}if(null===_.map){var S={minFilter:d,magFilter:d,format:T};_.map=new xt(i.x,i.y,S),_.map.texture.name=x.name+".shadowMap",_.camera.updateProjectionMatrix()}t.setRenderTarget(_.map),t.clear();for(var E=_.getViewportCount(),A=0;A=1):-1!==R.indexOf("OpenGL ES")&&(L=parseFloat(/^OpenGL\ ES\ ([0-9])/.exec(R)[1]),A=L>=2);var C=null,P={},I=new yt,D=new yt;function N(e,n,r){var i=new Uint8Array(4),a=t.createTexture();t.bindTexture(e,a),t.texParameteri(e,10241,9728),t.texParameteri(e,10240,9728);for(var o=0;or||t.height>r)&&(i=r/Math.max(t.width,t.height)),i<1||!0===e){if("undefined"!=typeof HTMLImageElement&&t instanceof HTMLImageElement||"undefined"!=typeof HTMLCanvasElement&&t instanceof HTMLCanvasElement||"undefined"!=typeof ImageBitmap&&t instanceof ImageBitmap){var a=e?st.floorPowerOfTwo:Math.floor,o=a(i*t.width),s=a(i*t.height);void 0===l&&(l=P(o,s));var c=n?P(o,s):l;return c.width=o,c.height=s,c.getContext("2d").drawImage(t,0,0,o,s),console.warn("THREE.WebGLRenderer: Texture has been resized from ("+t.width+"x"+t.height+") to ("+o+"x"+s+")."),c}return"data"in t&&console.warn("THREE.WebGLRenderer: Image in DataTexture is too big ("+t.width+"x"+t.height+")."),t}return t}function D(t){return st.isPowerOfTwo(t.width)&&st.isPowerOfTwo(t.height)}function N(t,e){return t.generateMipmaps&&e&&t.minFilter!==d&&t.minFilter!==m}function O(e,n,i,a){t.generateMipmap(e),r.get(n).__maxMipLevel=Math.log(Math.max(i,a))*Math.LOG2E}function B(n,r,i){if(!1===h)return r;if(null!==n){if(void 0!==t[n])return t[n];console.warn("THREE.WebGLRenderer: Attempt to use non-existing WebGL internal format '"+n+"'")}var a=r;return 6403===r&&(5126===i&&(a=33326),5131===i&&(a=33325),5121===i&&(a=33321)),6407===r&&(5126===i&&(a=34837),5131===i&&(a=34843),5121===i&&(a=32849)),6408===r&&(5126===i&&(a=34836),5131===i&&(a=34842),5121===i&&(a=32856)),33325!==a&&33326!==a&&34842!==a&&34836!==a||e.get("EXT_color_buffer_float"),a}function z(t){return t===d||t===p||t===f?9728:9729}function G(e){var n=e.target;n.removeEventListener("dispose",G),function(e){var n=r.get(e);if(void 0===n.__webglInit)return;t.deleteTexture(n.__webglTexture),r.remove(e)}(n),n.isVideoTexture&&R.delete(n),o.memory.textures--}function F(e){var n=e.target;n.removeEventListener("dispose",F),function(e){var n=r.get(e),i=r.get(e.texture);if(!e)return;void 0!==i.__webglTexture&&t.deleteTexture(i.__webglTexture);e.depthTexture&&e.depthTexture.dispose();if(e.isWebGLCubeRenderTarget)for(var a=0;a<6;a++)t.deleteFramebuffer(n.__webglFramebuffer[a]),n.__webglDepthbuffer&&t.deleteRenderbuffer(n.__webglDepthbuffer[a]);else t.deleteFramebuffer(n.__webglFramebuffer),n.__webglDepthbuffer&&t.deleteRenderbuffer(n.__webglDepthbuffer),n.__webglMultisampledFramebuffer&&t.deleteFramebuffer(n.__webglMultisampledFramebuffer),n.__webglColorRenderbuffer&&t.deleteRenderbuffer(n.__webglColorRenderbuffer),n.__webglDepthRenderbuffer&&t.deleteRenderbuffer(n.__webglDepthRenderbuffer);r.remove(e.texture),r.remove(e)}(n),o.memory.textures--}var U=0;function H(t,e){var i=r.get(t);if(t.isVideoTexture&&function(t){var e=o.render.frame;R.get(t)!==e&&(R.set(t,e),t.update())}(t),t.version>0&&i.__version!==t.version){var a=t.image;if(void 0===a)console.warn("THREE.WebGLRenderer: Texture marked for update but image is undefined");else{if(!1!==a.complete)return void X(i,t,e);console.warn("THREE.WebGLRenderer: Texture marked for update but image is incomplete")}}n.activeTexture(33984+e),n.bindTexture(3553,i.__webglTexture)}function k(e,i){var o=r.get(e);e.version>0&&o.__version!==e.version?function(e,r,i){if(6!==r.image.length)return;q(e,r),n.activeTexture(33984+i),n.bindTexture(34067,e.__webglTexture),t.pixelStorei(37440,r.flipY);for(var o=r&&(r.isCompressedTexture||r.image[0].isCompressedTexture),s=r.image[0]&&r.image[0].isDataTexture,c=[],l=0;l<6;l++)c[l]=o||s?s?r.image[l].image:r.image[l]:I(r.image[l],!1,!0,g);var u,d=c[0],p=D(d)||h,f=a.convert(r.format),m=a.convert(r.type),v=B(r.internalFormat,f,m);if(j(34067,r,p),o){for(var y=0;y<6;y++){u=c[y].mipmaps;for(var x=0;x1||r.get(a).__currentAnisotropy)&&(t.texParameterf(n,s.TEXTURE_MAX_ANISOTROPY_EXT,Math.min(a.anisotropy,i.getMaxAnisotropy())),r.get(a).__currentAnisotropy=a.anisotropy)}}function q(e,n){void 0===e.__webglInit&&(e.__webglInit=!0,n.addEventListener("dispose",G),e.__webglTexture=t.createTexture(),o.memory.textures++)}function X(e,r,i){var o=3553;r.isDataTexture2DArray&&(o=35866),r.isDataTexture3D&&(o=32879),q(e,r),n.activeTexture(33984+i),n.bindTexture(o,e.__webglTexture),t.pixelStorei(37440,r.flipY),t.pixelStorei(37441,r.premultiplyAlpha),t.pixelStorei(3317,r.unpackAlignment);var s,c=function(t){return!h&&(t.wrapS!==u||t.wrapT!==u||t.minFilter!==d&&t.minFilter!==m)}(r)&&!1===D(r.image),l=I(r.image,c,!1,y),p=D(l)||h,f=a.convert(r.format),v=a.convert(r.type),g=B(r.internalFormat,f,v);j(o,r,p);var w=r.mipmaps;if(r.isDepthTexture)g=6402,h?g=r.type===b?36012:r.type===_?33190:r.type===M?35056:33189:r.type===b&&console.error("WebGLRenderer: Floating point depth texture requires WebGL2."),r.format===E&&6402===g&&r.type!==x&&r.type!==_&&(console.warn("THREE.WebGLRenderer: Use UnsignedShortType or UnsignedIntType for DepthFormat DepthTexture."),r.type=x,v=a.convert(r.type)),r.format===A&&6402===g&&(g=34041,r.type!==M&&(console.warn("THREE.WebGLRenderer: Use UnsignedInt248Type for DepthStencilFormat DepthTexture."),r.type=M,v=a.convert(r.type))),n.texImage2D(3553,0,g,l.width,l.height,0,f,v,null);else if(r.isDataTexture)if(w.length>0&&p){for(var L=0,R=w.length;L0&&p){for(var z=0,G=w.length;z=v&&console.warn("THREE.WebGLTextures: Trying to use "+t+" texture units while this GPU supports only "+v),U+=1,t},this.resetTextureUnits=function(){U=0},this.setTexture2D=H,this.setTexture2DArray=function(t,e){var i=r.get(t);t.version>0&&i.__version!==t.version?X(i,t,e):(n.activeTexture(33984+e),n.bindTexture(35866,i.__webglTexture))},this.setTexture3D=function(t,e){var i=r.get(t);t.version>0&&i.__version!==t.version?X(i,t,e):(n.activeTexture(33984+e),n.bindTexture(32879,i.__webglTexture))},this.setTextureCube=k,this.setupRenderTarget=function(e){var i=r.get(e),s=r.get(e.texture);e.addEventListener("dispose",F),s.__webglTexture=t.createTexture(),o.memory.textures++;var c=!0===e.isWebGLCubeRenderTarget,l=!0===e.isWebGLMultisampleRenderTarget,u=D(e)||h;if(!h||e.texture.format!==S||e.texture.type!==b&&e.texture.type!==w||(e.texture.format=T,console.warn("THREE.WebGLRenderer: Rendering to textures with RGB format is not supported. Using RGBA format instead.")),c){i.__webglFramebuffer=[];for(var d=0;d<6;d++)i.__webglFramebuffer[d]=t.createFramebuffer()}else if(i.__webglFramebuffer=t.createFramebuffer(),l)if(h){i.__webglMultisampledFramebuffer=t.createFramebuffer(),i.__webglColorRenderbuffer=t.createRenderbuffer(),t.bindRenderbuffer(36161,i.__webglColorRenderbuffer);var p=a.convert(e.texture.format),f=a.convert(e.texture.type),m=B(e.texture.internalFormat,p,f),v=Q(e);t.renderbufferStorageMultisample(36161,v,m,e.width,e.height),t.bindFramebuffer(36160,i.__webglMultisampledFramebuffer),t.framebufferRenderbuffer(36160,36064,36161,i.__webglColorRenderbuffer),t.bindRenderbuffer(36161,null),e.depthBuffer&&(i.__webglDepthRenderbuffer=t.createRenderbuffer(),Z(i.__webglDepthRenderbuffer,e,!0)),t.bindFramebuffer(36160,null)}else console.warn("THREE.WebGLRenderer: WebGLMultisampleRenderTarget can only be used with WebGL2.");if(c){n.bindTexture(34067,s.__webglTexture),j(34067,e.texture,u);for(var g=0;g<6;g++)Y(i.__webglFramebuffer[g],e,36064,34069+g);N(e.texture,u)&&O(34067,e.texture,e.width,e.height),n.bindTexture(34067,null)}else n.bindTexture(3553,s.__webglTexture),j(3553,e.texture,u),Y(i.__webglFramebuffer,e,36064,3553),N(e.texture,u)&&O(3553,e.texture,e.width,e.height),n.bindTexture(3553,null);e.depthBuffer&&J(e)},this.updateRenderTargetMipmap=function(t){var e=t.texture;if(N(e,D(t)||h)){var i=t.isWebGLCubeRenderTarget?34067:3553,a=r.get(e).__webglTexture;n.bindTexture(i,a),O(i,e,t.width,t.height),n.bindTexture(i,null)}},this.updateMultisampleRenderTarget=function(e){if(e.isWebGLMultisampleRenderTarget)if(h){var n=r.get(e);t.bindFramebuffer(36008,n.__webglMultisampledFramebuffer),t.bindFramebuffer(36009,n.__webglFramebuffer);var i=e.width,a=e.height,o=16384;e.depthBuffer&&(o|=256),e.stencilBuffer&&(o|=1024),t.blitFramebuffer(0,0,i,a,0,0,i,a,o,9728),t.bindFramebuffer(36160,n.__webglMultisampledFramebuffer)}else console.warn("THREE.WebGLRenderer: WebGLMultisampleRenderTarget can only be used with WebGL2.")},this.safeSetTexture2D=function(t,e){t&&t.isWebGLRenderTarget&&(!1===K&&(console.warn("THREE.WebGLTextures.safeSetTexture2D: don't use render targets as textures. Use their .texture property instead."),K=!0),t=t.texture),H(t,e)},this.safeSetTextureCube=function(t,e){t&&t.isWebGLCubeRenderTarget&&(!1===$&&(console.warn("THREE.WebGLTextures.safeSetTextureCube: don't use cube render targets as textures. Use their .texture property instead."),$=!0),t=t.texture),k(t,e)}}function Qi(t,e,n){var r=n.isWebGL2;return{convert:function(t){var n;if(t===y)return 5121;if(1017===t)return 32819;if(1018===t)return 32820;if(1019===t)return 33635;if(1010===t)return 5120;if(1011===t)return 5122;if(t===x)return 5123;if(1013===t)return 5124;if(t===_)return 5125;if(t===b)return 5126;if(t===w)return r?5131:null!==(n=e.get("OES_texture_half_float"))?n.HALF_FLOAT_OES:null;if(1021===t)return 6406;if(t===S)return 6407;if(t===T)return 6408;if(1024===t)return 6409;if(1025===t)return 6410;if(t===E)return 6402;if(t===A)return 34041;if(1028===t)return 6403;if(1029===t)return 36244;if(1030===t)return 33319;if(1031===t)return 33320;if(1032===t)return 36248;if(1033===t)return 36249;if(t===L||t===R||t===C||t===P){if(null===(n=e.get("WEBGL_compressed_texture_s3tc")))return null;if(t===L)return n.COMPRESSED_RGB_S3TC_DXT1_EXT;if(t===R)return n.COMPRESSED_RGBA_S3TC_DXT1_EXT;if(t===C)return n.COMPRESSED_RGBA_S3TC_DXT3_EXT;if(t===P)return n.COMPRESSED_RGBA_S3TC_DXT5_EXT}if(t===I||t===D||t===N||t===O){if(null===(n=e.get("WEBGL_compressed_texture_pvrtc")))return null;if(t===I)return n.COMPRESSED_RGB_PVRTC_4BPPV1_IMG;if(t===D)return n.COMPRESSED_RGB_PVRTC_2BPPV1_IMG;if(t===N)return n.COMPRESSED_RGBA_PVRTC_4BPPV1_IMG;if(t===O)return n.COMPRESSED_RGBA_PVRTC_2BPPV1_IMG}if(36196===t)return null!==(n=e.get("WEBGL_compressed_texture_etc1"))?n.COMPRESSED_RGB_ETC1_WEBGL:null;if((t===B||t===z)&&null!==(n=e.get("WEBGL_compressed_texture_etc"))){if(t===B)return n.COMPRESSED_RGB8_ETC2;if(t===z)return n.COMPRESSED_RGBA8_ETC2_EAC}return 37808===t||37809===t||37810===t||37811===t||37812===t||37813===t||37814===t||37815===t||37816===t||37817===t||37818===t||37819===t||37820===t||37821===t||37840===t||37841===t||37842===t||37843===t||37844===t||37845===t||37846===t||37847===t||37848===t||37849===t||37850===t||37851===t||37852===t||37853===t?null!==(n=e.get("WEBGL_compressed_texture_astc"))?t:null:36492===t?null!==(n=e.get("EXT_texture_compression_bptc"))?t:null:t===M?r?34042:null!==(n=e.get("WEBGL_depth_texture"))?n.UNSIGNED_INT_24_8_WEBGL:null:void 0}}}function Ki(t){Vn.call(this),this.cameras=t||[]}function $i(){be.call(this),this.type="Group"}function ta(){this._targetRay=null,this._grip=null,this._hand=null}function ea(t,e){var n=this,r=null,i=1,a=null,o="local-floor",s=null,c=[],l=new Map,u=new Vn;u.layers.enable(1),u.viewport=new yt;var h=new Vn;h.layers.enable(2),h.viewport=new yt;var d=[u,h],p=new Ki;p.layers.enable(1),p.layers.enable(2);var f=null,m=null;function v(t){var e=l.get(t.inputSource);e&&e.dispatchEvent({type:t.type,data:t.inputSource})}function g(){l.forEach((function(t,e){t.disconnect(e)})),l.clear(),t.setFramebuffer(null),t.setRenderTarget(t.getRenderTarget()),S.stop(),n.isPresenting=!1,n.dispatchEvent({type:"sessionend"})}function y(t){a=t,S.setContext(r),S.start(),n.isPresenting=!0,n.dispatchEvent({type:"sessionstart"})}function x(t){for(var e=r.inputSources,n=0;n0&&Pt(a,t,e),o.length>0&&Pt(o,t,e),!0===t.isScene&&t.onAfterRender(p,t,e),null!==x&&(Q.updateRenderTargetMipmap(x),Q.updateMultisampleRenderTarget(x)),Y.buffers.depth.setTest(!0),Y.buffers.depth.setMask(!0),Y.buffers.color.setMask(!0),Y.setPolygonOffset(!1),h=null,d=null}}else console.error("THREE.WebGLRenderer.render: camera is not an instance of THREE.Camera.")},this.setFramebuffer=function(t){m!==t&&null===x&&mt.bindFramebuffer(36160,t),m=t},this.getActiveCubeFace=function(){return v},this.getActiveMipmapLevel=function(){return g},this.getRenderList=function(){return h},this.setRenderList=function(t){h=t},this.getRenderState=function(){return d},this.setRenderState=function(t){d=t},this.getRenderTarget=function(){return x},this.setRenderTarget=function(t,e,n){void 0===e&&(e=0),void 0===n&&(n=0),x=t,v=e,g=n,t&&void 0===J.get(t).__webglFramebuffer&&Q.setupRenderTarget(t);var r=m,i=!1;if(t){var a=J.get(t).__webglFramebuffer;t.isWebGLCubeRenderTarget?(r=a[e],i=!0):r=t.isWebGLMultisampleRenderTarget?J.get(t).__webglMultisampledFramebuffer:a,A.copy(t.viewport),L.copy(t.scissor),R=t.scissorTest}else A.copy(O).multiplyScalar(I).floor(),L.copy(B).multiplyScalar(I).floor(),R=z;if(_!==r&&(mt.bindFramebuffer(36160,r),_=r),Y.viewport(A),Y.scissor(L),Y.setScissorTest(R),i){var o=J.get(t.texture);mt.framebufferTexture2D(36160,36064,34069+e,o.__webglTexture,n)}},this.readRenderTargetPixels=function(t,e,n,r,i,a,o){if(t&&t.isWebGLRenderTarget){var s=J.get(t).__webglFramebuffer;if(t.isWebGLCubeRenderTarget&&void 0!==o&&(s=s[o]),s){var c=!1;s!==_&&(mt.bindFramebuffer(36160,s),c=!0);try{var l=t.texture,u=l.format,h=l.type;if(u!==T&&dt.convert(u)!==mt.getParameter(35739))return void console.error("THREE.WebGLRenderer.readRenderTargetPixels: renderTarget is not in RGBA or implementation defined format.");if(!(h===y||dt.convert(h)===mt.getParameter(35738)||h===b&&(X.isWebGL2||j.get("OES_texture_float")||j.get("WEBGL_color_buffer_float"))||h===w&&(X.isWebGL2?j.get("EXT_color_buffer_float"):j.get("EXT_color_buffer_half_float"))))return void console.error("THREE.WebGLRenderer.readRenderTargetPixels: renderTarget is not in UnsignedByteType or implementation defined type.");36053===mt.checkFramebufferStatus(36160)?e>=0&&e<=t.width-r&&n>=0&&n<=t.height-i&&mt.readPixels(e,n,r,i,dt.convert(u),dt.convert(h),a):console.error("THREE.WebGLRenderer.readRenderTargetPixels: readPixels from renderTarget failed. Framebuffer not complete.")}finally{c&&mt.bindFramebuffer(36160,_)}}}else console.error("THREE.WebGLRenderer.readRenderTargetPixels: renderTarget is not THREE.WebGLRenderTarget.")},this.copyFramebufferToTexture=function(t,e,n){void 0===n&&(n=0);var r=Math.pow(2,-n),i=Math.floor(e.image.width*r),a=Math.floor(e.image.height*r),o=dt.convert(e.format);Q.setTexture2D(e,0),mt.copyTexImage2D(3553,n,o,t.x,t.y,i,a,0),Y.unbindTexture()},this.copyTextureToTexture=function(t,e,n,r){void 0===r&&(r=0);var i=e.image.width,a=e.image.height,o=dt.convert(n.format),s=dt.convert(n.type);Q.setTexture2D(n,0),mt.pixelStorei(37440,n.flipY),mt.pixelStorei(37441,n.premultiplyAlpha),mt.pixelStorei(3317,n.unpackAlignment),e.isDataTexture?mt.texSubImage2D(3553,r,t.x,t.y,i,a,o,s,e.image.data):e.isCompressedTexture?mt.compressedTexSubImage2D(3553,r,t.x,t.y,e.mipmaps[0].width,e.mipmaps[0].height,o,e.mipmaps[0].data):mt.texSubImage2D(3553,r,t.x,t.y,o,s,e.image),0===r&&n.generateMipmaps&&mt.generateMipmap(3553),Y.unbindTexture()},this.initTexture=function(t){Q.setTexture2D(t,0),Y.unbindTexture()},"undefined"!=typeof __THREE_DEVTOOLS__&&__THREE_DEVTOOLS__.dispatchEvent(new CustomEvent("observe",{detail:this}))}function ia(t){ra.call(this,t)}Ki.prototype=Object.assign(Object.create(Vn.prototype),{constructor:Ki,isArrayCamera:!0}),$i.prototype=Object.assign(Object.create(be.prototype),{constructor:$i,isGroup:!0}),Object.assign(ta.prototype,{constructor:ta,getHandSpace:function(){if(null===this._hand&&(this._hand=new $i,this._hand.matrixAutoUpdate=!1,this._hand.visible=!1,this._hand.joints=[],this._hand.inputState={pinching:!1},window.XRHand))for(var t=0;t<=window.XRHand.LITTLE_PHALANX_TIP;t++){var e=new $i;e.matrixAutoUpdate=!1,e.visible=!1,this._hand.joints.push(e),this._hand.add(e)}return this._hand},getTargetRaySpace:function(){return null===this._targetRay&&(this._targetRay=new $i,this._targetRay.matrixAutoUpdate=!1,this._targetRay.visible=!1),this._targetRay},getGripSpace:function(){return null===this._grip&&(this._grip=new $i,this._grip.matrixAutoUpdate=!1,this._grip.visible=!1),this._grip},dispatchEvent:function(t){return null!==this._targetRay&&this._targetRay.dispatchEvent(t),null!==this._grip&&this._grip.dispatchEvent(t),null!==this._hand&&this._hand.dispatchEvent(t),this},disconnect:function(t){return this.dispatchEvent({type:"disconnected",data:t}),null!==this._targetRay&&(this._targetRay.visible=!1),null!==this._grip&&(this._grip.visible=!1),null!==this._hand&&(this._hand.visible=!1),this},update:function(t,e,n){var r=null,i=null,a=null,o=this._targetRay,s=this._grip,c=this._hand;if(t)if(c&&t.hand){a=!0;for(var l=0;l<=window.XRHand.LITTLE_PHALANX_TIP;l++)if(t.hand[l]){var u=e.getJointPose(t.hand[l],n),h=c.joints[l];null!==u&&(h.matrix.fromArray(u.transform.matrix),h.matrix.decompose(h.position,h.rotation,h.scale),h.jointRadius=u.radius),h.visible=null!==u;var d=c.joints[window.XRHand.INDEX_PHALANX_TIP],p=c.joints[window.XRHand.THUMB_PHALANX_TIP],f=d.position.distanceTo(p.position);c.inputState.pinching&&f>.025?(c.inputState.pinching=!1,this.dispatchEvent({type:"pinchend",handedness:t.handedness,target:this})):!c.inputState.pinching&&f<=.015&&(c.inputState.pinching=!0,this.dispatchEvent({type:"pinchstart",handedness:t.handedness,target:this}))}}else null!==o&&null!==(r=e.getPose(t.targetRaySpace,n))&&(o.matrix.fromArray(r.transform.matrix),o.matrix.decompose(o.position,o.rotation,o.scale)),null!==s&&t.gripSpace&&null!==(i=e.getPose(t.gripSpace,n))&&(s.matrix.fromArray(i.transform.matrix),s.matrix.decompose(s.position,s.rotation,s.scale));return null!==o&&(o.visible=null!==r),null!==s&&(s.visible=null!==i),null!==c&&(c.visible=null!==a),this}}),Object.assign(ea.prototype,rt.prototype),ia.prototype=Object.assign(Object.create(ra.prototype),{constructor:ia,isWebGL1Renderer:!0});var aa=function(){function t(t,e){Object.defineProperty(this,"isFogExp2",{value:!0}),this.name="",this.color=new Ve(t),this.density=void 0!==e?e:25e-5}var e=t.prototype;return e.clone=function(){return new t(this.color,this.density)},e.toJSON=function(){return{type:"FogExp2",color:this.color.getHex(),density:this.density}},t}(),oa=function(){function t(t,e,n){Object.defineProperty(this,"isFog",{value:!0}),this.name="",this.color=new Ve(t),this.near=void 0!==e?e:1,this.far=void 0!==n?n:1e3}var e=t.prototype;return e.clone=function(){return new t(this.color,this.near,this.far)},e.toJSON=function(){return{type:"Fog",color:this.color.getHex(),near:this.near,far:this.far}},t}(),sa=function(t){function e(){var e;return e=t.call(this)||this,Object.defineProperty(ht(e),"isScene",{value:!0}),e.type="Scene",e.background=null,e.environment=null,e.fog=null,e.overrideMaterial=null,e.autoUpdate=!0,"undefined"!=typeof __THREE_DEVTOOLS__&&__THREE_DEVTOOLS__.dispatchEvent(new CustomEvent("observe",{detail:ht(e)})),e}ut(e,t);var n=e.prototype;return n.copy=function(e,n){return t.prototype.copy.call(this,e,n),null!==e.background&&(this.background=e.background.clone()),null!==e.environment&&(this.environment=e.environment.clone()),null!==e.fog&&(this.fog=e.fog.clone()),null!==e.overrideMaterial&&(this.overrideMaterial=e.overrideMaterial.clone()),this.autoUpdate=e.autoUpdate,this.matrixAutoUpdate=e.matrixAutoUpdate,this},n.toJSON=function(e){var n=t.prototype.toJSON.call(this,e);return null!==this.background&&(n.object.background=this.background.toJSON(e)),null!==this.environment&&(n.object.environment=this.environment.toJSON(e)),null!==this.fog&&(n.object.fog=this.fog.toJSON()),n},e}(be);function ca(t,e){this.array=t,this.stride=e,this.count=void 0!==t?t.length/e:0,this.usage=tt,this.updateRange={offset:0,count:-1},this.version=0,this.uuid=st.generateUUID()}Object.defineProperty(ca.prototype,"needsUpdate",{set:function(t){!0===t&&this.version++}}),Object.assign(ca.prototype,{isInterleavedBuffer:!0,onUploadCallback:function(){},setUsage:function(t){return this.usage=t,this},copy:function(t){return this.array=new t.array.constructor(t.array),this.count=t.count,this.stride=t.stride,this.usage=t.usage,this},copyAt:function(t,e,n){t*=this.stride,n*=e.stride;for(var r=0,i=this.stride;rt.far||e.push({distance:s,point:pa.clone(),uv:Be.getUV(pa,xa,_a,ba,wa,Ma,Sa,new pt),face:null,object:this})}},copy:function(t){return be.prototype.copy.call(this,t),void 0!==t.center&&this.center.copy(t.center),this.material=t.material,this}});var Aa,La,Ra,Ca,Pa,Ia=new wt,Da=new wt;function Na(){be.call(this),this._currentLevel=0,this.type="LOD",Object.defineProperties(this,{levels:{enumerable:!0,value:[]}}),this.autoUpdate=!0}function Oa(t,e){t&&t.isGeometry&&console.error("THREE.SkinnedMesh no longer supports THREE.Geometry. Use THREE.BufferGeometry instead."),Nn.call(this,t,e),this.type="SkinnedMesh",this.bindMode="attached",this.bindMatrix=new Jt,this.bindMatrixInverse=new Jt}Na.prototype=Object.assign(Object.create(be.prototype),{constructor:Na,isLOD:!0,copy:function(t){be.prototype.copy.call(this,t,!1);for(var e=t.levels,n=0,r=e.length;n0){var n,r;for(n=1,r=e.length;n0){Ia.setFromMatrixPosition(this.matrixWorld);var n=t.ray.origin.distanceTo(Ia);this.getObjectForDistance(n).raycast(t,e)}},update:function(t){var e=this.levels;if(e.length>1){Ia.setFromMatrixPosition(t.matrixWorld),Da.setFromMatrixPosition(this.matrixWorld);var n,r,i=Ia.distanceTo(Da)/t.zoom;for(e[0].object.visible=!0,n=1,r=e.length;n=e[n].distance;n++)e[n-1].object.visible=!1,e[n].object.visible=!0;for(this._currentLevel=n-1;no)){u.applyMatrix4(this.matrixWorld);var x=t.ray.origin.distanceTo(u);xt.far||e.push({distance:x,point:l.clone().applyMatrix4(this.matrixWorld),index:m,face:null,faceIndex:null,object:this})}}else for(var _=0,b=p.count-1;_o)){u.applyMatrix4(this.matrixWorld);var w=t.ray.origin.distanceTo(u);wt.far||e.push({distance:w,point:l.clone().applyMatrix4(this.matrixWorld),index:_,face:null,faceIndex:null,object:this})}}}else if(n.isGeometry)for(var M=n.vertices,S=M.length,T=0;To)){u.applyMatrix4(this.matrixWorld);var E=t.ray.origin.distanceTo(u);Et.far||e.push({distance:E,point:l.clone().applyMatrix4(this.matrixWorld),index:T,face:null,faceIndex:null,object:this})}}}},updateMorphTargets:function(){var t=this.geometry;if(t.isBufferGeometry){var e=t.morphAttributes,n=Object.keys(e);if(n.length>0){var r=e[n[0]];if(void 0!==r){this.morphTargetInfluences=[],this.morphTargetDictionary={};for(var i=0,a=r.length;i0&&console.error("THREE.Line.updateMorphTargets() does not support THREE.Geometry. Use THREE.BufferGeometry instead.")}}});var Ka=new wt,$a=new wt;function to(t,e){Qa.call(this,t,e),this.type="LineSegments"}function eo(t,e){Qa.call(this,t,e),this.type="LineLoop"}function no(t){qe.call(this),this.type="PointsMaterial",this.color=new Ve(16777215),this.map=null,this.alphaMap=null,this.size=1,this.sizeAttenuation=!0,this.morphTargets=!1,this.setValues(t)}to.prototype=Object.assign(Object.create(Qa.prototype),{constructor:to,isLineSegments:!0,computeLineDistances:function(){var t=this.geometry;if(t.isBufferGeometry)if(null===t.index){for(var e=t.attributes.position,n=[],r=0,i=e.count;ri.far)return;a.push({distance:l,distanceToRay:Math.sqrt(s),point:c,index:e,face:null,object:o})}}function lo(t,e,n,r,i,a,o,s,c){gt.call(this,t,e,n,r,i,a,o,s,c),this.format=void 0!==o?o:S,this.minFilter=void 0!==a?a:m,this.magFilter=void 0!==i?i:m,this.generateMipmaps=!1;var l=this;"requestVideoFrameCallback"in t&&t.requestVideoFrameCallback((function e(){l.needsUpdate=!0,t.requestVideoFrameCallback(e)}))}function uo(t,e,n,r,i,a,o,s,c,l,u,h){gt.call(this,null,a,o,s,c,l,r,i,u,h),this.image={width:e,height:n},this.mipmaps=t,this.flipY=!1,this.generateMipmaps=!1}function ho(t,e,n,r,i,a,o,s,c){gt.call(this,t,e,n,r,i,a,o,s,c),this.needsUpdate=!0}function po(t,e,n,r,i,a,o,s,c,l){if((l=void 0!==l?l:E)!==E&&l!==A)throw new Error("DepthTexture format must be either THREE.DepthFormat or THREE.DepthStencilFormat");void 0===n&&l===E&&(n=x),void 0===n&&l===A&&(n=M),gt.call(this,null,r,i,a,o,s,l,n,c),this.image={width:t,height:e},this.magFilter=void 0!==o?o:d,this.minFilter=void 0!==s?s:d,this.flipY=!1,this.generateMipmaps=!1}so.prototype=Object.assign(Object.create(be.prototype),{constructor:so,isPoints:!0,copy:function(t){return be.prototype.copy.call(this,t),this.material=t.material,this.geometry=t.geometry,this},raycast:function(t,e){var n=this.geometry,r=this.matrixWorld,i=t.params.Points.threshold;if(null===n.boundingSphere&&n.computeBoundingSphere(),ao.copy(n.boundingSphere),ao.applyMatrix4(r),ao.radius+=i,!1!==t.ray.intersectsSphere(ao)){ro.getInverse(r),io.copy(t.ray).applyMatrix4(ro);var a=i/((this.scale.x+this.scale.y+this.scale.z)/3),o=a*a;if(n.isBufferGeometry){var s=n.index,c=n.attributes.position;if(null!==s)for(var l=s.array,u=0,h=l.length;u0){var r=e[n[0]];if(void 0!==r){this.morphTargetInfluences=[],this.morphTargetDictionary={};for(var i=0,a=r.length;i0&&console.error("THREE.Points.updateMorphTargets() does not support THREE.Geometry. Use THREE.BufferGeometry instead.")}}}),lo.prototype=Object.assign(Object.create(gt.prototype),{constructor:lo,isVideoTexture:!0,update:function(){var t=this.image;!1==="requestVideoFrameCallback"in t&&t.readyState>=t.HAVE_CURRENT_DATA&&(this.needsUpdate=!0)}}),uo.prototype=Object.create(gt.prototype),uo.prototype.constructor=uo,uo.prototype.isCompressedTexture=!0,ho.prototype=Object.create(gt.prototype),ho.prototype.constructor=ho,ho.prototype.isCanvasTexture=!0,po.prototype=Object.create(gt.prototype),po.prototype.constructor=po,po.prototype.isDepthTexture=!0;var fo=0,mo=new Jt,vo=new be,go=new wt;function yo(){Object.defineProperty(this,"id",{value:fo+=2}),this.uuid=st.generateUUID(),this.name="",this.type="Geometry",this.vertices=[],this.colors=[],this.faces=[],this.faceVertexUvs=[[]],this.morphTargets=[],this.morphNormals=[],this.skinWeights=[],this.skinIndices=[],this.lineDistances=[],this.boundingBox=null,this.boundingSphere=null,this.elementsNeedUpdate=!1,this.verticesNeedUpdate=!1,this.uvsNeedUpdate=!1,this.normalsNeedUpdate=!1,this.colorsNeedUpdate=!1,this.lineDistancesNeedUpdate=!1,this.groupsNeedUpdate=!1}yo.prototype=Object.assign(Object.create(rt.prototype),{constructor:yo,isGeometry:!0,applyMatrix4:function(t){for(var e=(new ft).getNormalMatrix(t),n=0,r=this.vertices.length;n0)for(var d=0;d0&&(this.normalsNeedUpdate=!0)},computeFlatVertexNormals:function(){this.computeFaceNormals();for(var t=0,e=this.faces.length;t0&&(this.normalsNeedUpdate=!0)},computeMorphNormals:function(){for(var t=0,e=this.faces.length;t=0;f--){var m=c[f];this.faces.splice(m,1);for(var v=0,g=this.faceVertexUvs.length;v0,g=f.vertexNormals.length>0,y=1!==f.color.r||1!==f.color.g||1!==f.color.b,x=f.vertexColors.length>0,_=0;if(_=S(_,0,0),_=S(_,1,!0),_=S(_,2,!1),_=S(_,3,m),_=S(_,4,v),_=S(_,5,g),_=S(_,6,y),_=S(_,7,x),o.push(_),o.push(f.a,f.b,f.c),o.push(f.materialIndex),m){var b=this.faceVertexUvs[0][p];o.push(A(b[0]),A(b[1]),A(b[2]))}if(v&&o.push(T(f.normal)),g){var w=f.vertexNormals;o.push(T(w[0]),T(w[1]),T(w[2]))}if(y&&o.push(E(f.color)),x){var M=f.vertexColors;o.push(E(M[0]),E(M[1]),E(M[2]))}}function S(t,e,n){return n?t|1<0&&(t.data.colors=l),h.length>0&&(t.data.uvs=[h]),t.data.faces=o,t},clone:function(){return(new yo).copy(this)},copy:function(t){this.vertices=[],this.colors=[],this.faces=[],this.faceVertexUvs=[[]],this.morphTargets=[],this.morphNormals=[],this.skinWeights=[],this.skinIndices=[],this.lineDistances=[],this.boundingBox=null,this.boundingSphere=null,this.name=t.name;for(var e=t.vertices,n=0,r=e.length;n0&&x(!0),n>0&&x(!1)),l.setIndex(h),l.setAttribute("position",new an(d,3)),l.setAttribute("normal",new an(p,3)),l.setAttribute("uv",new an(f,2)),l}return ut(e,t),e}(vn),Mo=function(t){function e(e,n,r,i,a,o,s,c){var l;return(l=t.call(this)||this).type="CylinderGeometry",l.parameters={radiusTop:e,radiusBottom:n,height:r,radialSegments:i,heightSegments:a,openEnded:o,thetaStart:s,thetaLength:c},l.fromBufferGeometry(new wo(e,n,r,i,a,o,s,c)),l.mergeVertices(),l}return ut(e,t),e}(yo),So=function(t){function e(e,n,r,i,a,o,s){var c;return(c=t.call(this,0,e,n,r,i,a,o,s)||this).type="ConeGeometry",c.parameters={radius:e,height:n,radialSegments:r,heightSegments:i,openEnded:a,thetaStart:o,thetaLength:s},c}return ut(e,t),e}(Mo),To=function(t){function e(e,n,r,i,a,o,s){var c;return(c=t.call(this,0,e,n,r,i,a,o,s)||this).type="ConeBufferGeometry",c.parameters={radius:e,height:n,radialSegments:r,heightSegments:i,openEnded:a,thetaStart:o,thetaLength:s},c}return ut(e,t),e}(wo),Eo=function(t){function e(e,n,r,i){var a;(a=t.call(this)||this).type="PolyhedronBufferGeometry",a.parameters={vertices:e,indices:n,radius:r,detail:i},r=r||1;var o=[],s=[];function c(t,e,n,r){for(var i=r+1,a=[],o=0;o<=i;o++){a[o]=[];for(var s=t.clone().lerp(n,o/i),c=e.clone().lerp(n,o/i),u=i-o,h=0;h<=u;h++)a[o][h]=0===h&&o===i?s:s.clone().lerp(c,h/u)}for(var d=0;d.9&&a<.1&&(e<.2&&(s[t+0]+=1),n<.2&&(s[t+2]+=1),r<.2&&(s[t+4]+=1))}}()}(),a.setAttribute("position",new an(o,3)),a.setAttribute("normal",new an(o.slice(),3)),a.setAttribute("uv",new an(s,2)),0===i?a.computeVertexNormals():a.normalizeNormals(),a}return ut(e,t),e}(vn),Ao=function(t){function e(e,n){var r,i=(1+Math.sqrt(5))/2,a=1/i,o=[-1,-1,-1,-1,-1,1,-1,1,-1,-1,1,1,1,-1,-1,1,-1,1,1,1,-1,1,1,1,0,-a,-i,0,-a,i,0,a,-i,0,a,i,-a,-i,0,-a,i,0,a,-i,0,a,i,0,-i,0,-a,i,0,-a,-i,0,a,i,0,a];return(r=t.call(this,o,[3,11,7,3,7,15,3,15,13,7,19,17,7,17,6,7,6,15,17,4,8,17,8,10,17,10,6,8,0,16,8,16,2,8,2,10,0,12,1,0,1,18,0,18,16,6,10,2,6,2,13,6,13,15,2,16,18,2,18,3,2,3,13,18,1,9,18,9,11,18,11,3,4,14,12,4,12,0,4,0,8,11,9,5,11,5,19,11,19,7,19,5,14,19,14,4,19,4,17,1,12,14,1,14,5,1,5,9],e,n)||this).type="DodecahedronBufferGeometry",r.parameters={radius:e,detail:n},r}return ut(e,t),e}(Eo),Lo=function(t){function e(e,n){var r;return(r=t.call(this)||this).type="DodecahedronGeometry",r.parameters={radius:e,detail:n},r.fromBufferGeometry(new Ao(e,n)),r.mergeVertices(),r}return ut(e,t),e}(yo),Ro=new wt,Co=new wt,Po=new wt,Io=new Be,Do=function(t){function e(e,n){var r;(r=t.call(this)||this).type="EdgesGeometry",r.parameters={thresholdAngle:n},n=void 0!==n?n:1,e.isGeometry&&(e=(new vn).fromGeometry(e));for(var i=Math.pow(10,4),a=Math.cos(st.DEG2RAD*n),o=e.getIndex(),s=e.getAttribute("position"),c=o?o.count:s.count,l=[0,0,0],u=["a","b","c"],h=new Array(3),d={},p=[],f=0;f80*n){r=a=t[0],i=o=t[1];for(var f=n;fa&&(a=s),c>o&&(o=c);l=0!==(l=Math.max(a-r,o-i))?1/l:0}return zo(d,p,n,r,i,l),p};function Oo(t,e,n,r,i){var a,o;if(i===function(t,e,n,r){for(var i=0,a=e,o=n-r;a0)for(a=e;a=e;a-=r)o=ns(a,t[a],t[a+1],o);return o&&Jo(o,o.next)&&(rs(o),o=o.next),o}function Bo(t,e){if(!t)return t;e||(e=t);var n,r=t;do{if(n=!1,r.steiner||!Jo(r,r.next)&&0!==Zo(r.prev,r,r.next))r=r.next;else{if(rs(r),(r=e=r.prev)===r.next)break;n=!0}}while(n||r!==e);return e}function zo(t,e,n,r,i,a,o){if(t){!o&&a&&function(t,e,n,r){var i=t;do{null===i.z&&(i.z=jo(i.x,i.y,e,n,r)),i.prevZ=i.prev,i.nextZ=i.next,i=i.next}while(i!==t);i.prevZ.nextZ=null,i.prevZ=null,function(t){var e,n,r,i,a,o,s,c,l=1;do{for(n=t,t=null,a=null,o=0;n;){for(o++,r=n,s=0,e=0;e0||c>0&&r;)0!==s&&(0===c||!r||n.z<=r.z)?(i=n,n=n.nextZ,s--):(i=r,r=r.nextZ,c--),a?a.nextZ=i:t=i,i.prevZ=a,a=i;n=r}a.nextZ=null,l*=2}while(o>1)}(i)}(t,r,i,a);for(var s,c,l=t;t.prev!==t.next;)if(s=t.prev,c=t.next,a?Fo(t,r,i,a):Go(t))e.push(s.i/n),e.push(t.i/n),e.push(c.i/n),rs(t),t=c.next,l=c.next;else if((t=c)===l){o?1===o?zo(t=Uo(Bo(t),e,n),e,n,r,i,a,2):2===o&&Ho(t,e,n,r,i,a):zo(Bo(t),e,n,r,i,a,1);break}}}function Go(t){var e=t.prev,n=t,r=t.next;if(Zo(e,n,r)>=0)return!1;for(var i=t.next.next;i!==t.prev;){if(Xo(e.x,e.y,n.x,n.y,r.x,r.y,i.x,i.y)&&Zo(i.prev,i,i.next)>=0)return!1;i=i.next}return!0}function Fo(t,e,n,r){var i=t.prev,a=t,o=t.next;if(Zo(i,a,o)>=0)return!1;for(var s=i.xa.x?i.x>o.x?i.x:o.x:a.x>o.x?a.x:o.x,u=i.y>a.y?i.y>o.y?i.y:o.y:a.y>o.y?a.y:o.y,h=jo(s,c,e,n,r),d=jo(l,u,e,n,r),p=t.prevZ,f=t.nextZ;p&&p.z>=h&&f&&f.z<=d;){if(p!==t.prev&&p!==t.next&&Xo(i.x,i.y,a.x,a.y,o.x,o.y,p.x,p.y)&&Zo(p.prev,p,p.next)>=0)return!1;if(p=p.prevZ,f!==t.prev&&f!==t.next&&Xo(i.x,i.y,a.x,a.y,o.x,o.y,f.x,f.y)&&Zo(f.prev,f,f.next)>=0)return!1;f=f.nextZ}for(;p&&p.z>=h;){if(p!==t.prev&&p!==t.next&&Xo(i.x,i.y,a.x,a.y,o.x,o.y,p.x,p.y)&&Zo(p.prev,p,p.next)>=0)return!1;p=p.prevZ}for(;f&&f.z<=d;){if(f!==t.prev&&f!==t.next&&Xo(i.x,i.y,a.x,a.y,o.x,o.y,f.x,f.y)&&Zo(f.prev,f,f.next)>=0)return!1;f=f.nextZ}return!0}function Uo(t,e,n){var r=t;do{var i=r.prev,a=r.next.next;!Jo(i,a)&&Qo(i,r,r.next,a)&&ts(i,a)&&ts(a,i)&&(e.push(i.i/n),e.push(r.i/n),e.push(a.i/n),rs(r),rs(r.next),r=t=a),r=r.next}while(r!==t);return Bo(r)}function Ho(t,e,n,r,i,a){var o=t;do{for(var s=o.next.next;s!==o.prev;){if(o.i!==s.i&&Yo(o,s)){var c=es(o,s);return o=Bo(o,o.next),c=Bo(c,c.next),zo(o,e,n,r,i,a),void zo(c,e,n,r,i,a)}s=s.next}o=o.next}while(o!==t)}function ko(t,e){return t.x-e.x}function Vo(t,e){if(e=function(t,e){var n,r=e,i=t.x,a=t.y,o=-1/0;do{if(a<=r.y&&a>=r.next.y&&r.next.y!==r.y){var s=r.x+(a-r.y)*(r.next.x-r.x)/(r.next.y-r.y);if(s<=i&&s>o){if(o=s,s===i){if(a===r.y)return r;if(a===r.next.y)return r.next}n=r.x=r.x&&r.x>=u&&i!==r.x&&Xo(an.x||r.x===n.x&&Wo(n,r)))&&(n=r,d=c)),r=r.next}while(r!==l);return n}(t,e)){var n=es(e,t);Bo(e,e.next),Bo(n,n.next)}}function Wo(t,e){return Zo(t.prev,t,e.prev)<0&&Zo(e.next,t,t.next)<0}function jo(t,e,n,r,i){return(t=1431655765&((t=858993459&((t=252645135&((t=16711935&((t=32767*(t-n)*i)|t<<8))|t<<4))|t<<2))|t<<1))|(e=1431655765&((e=858993459&((e=252645135&((e=16711935&((e=32767*(e-r)*i)|e<<8))|e<<4))|e<<2))|e<<1))<<1}function qo(t){var e=t,n=t;do{(e.x=0&&(t-o)*(r-s)-(n-o)*(e-s)>=0&&(n-o)*(a-s)-(i-o)*(r-s)>=0}function Yo(t,e){return t.next.i!==e.i&&t.prev.i!==e.i&&!function(t,e){var n=t;do{if(n.i!==t.i&&n.next.i!==t.i&&n.i!==e.i&&n.next.i!==e.i&&Qo(n,n.next,t,e))return!0;n=n.next}while(n!==t);return!1}(t,e)&&(ts(t,e)&&ts(e,t)&&function(t,e){var n=t,r=!1,i=(t.x+e.x)/2,a=(t.y+e.y)/2;do{n.y>a!=n.next.y>a&&n.next.y!==n.y&&i<(n.next.x-n.x)*(a-n.y)/(n.next.y-n.y)+n.x&&(r=!r),n=n.next}while(n!==t);return r}(t,e)&&(Zo(t.prev,t,e.prev)||Zo(t,e.prev,e))||Jo(t,e)&&Zo(t.prev,t,t.next)>0&&Zo(e.prev,e,e.next)>0)}function Zo(t,e,n){return(e.y-t.y)*(n.x-e.x)-(e.x-t.x)*(n.y-e.y)}function Jo(t,e){return t.x===e.x&&t.y===e.y}function Qo(t,e,n,r){var i=$o(Zo(t,e,n)),a=$o(Zo(t,e,r)),o=$o(Zo(n,r,t)),s=$o(Zo(n,r,e));return i!==a&&o!==s||(!(0!==i||!Ko(t,n,e))||(!(0!==a||!Ko(t,r,e))||(!(0!==o||!Ko(n,t,r))||!(0!==s||!Ko(n,e,r)))))}function Ko(t,e,n){return e.x<=Math.max(t.x,n.x)&&e.x>=Math.min(t.x,n.x)&&e.y<=Math.max(t.y,n.y)&&e.y>=Math.min(t.y,n.y)}function $o(t){return t>0?1:t<0?-1:0}function ts(t,e){return Zo(t.prev,t,t.next)<0?Zo(t,e,t.next)>=0&&Zo(t,t.prev,e)>=0:Zo(t,e,t.prev)<0||Zo(t,t.next,e)<0}function es(t,e){var n=new is(t.i,t.x,t.y),r=new is(e.i,e.x,e.y),i=t.next,a=e.prev;return t.next=e,e.prev=t,n.next=i,i.prev=n,r.next=n,n.prev=r,a.next=r,r.prev=a,r}function ns(t,e,n,r){var i=new is(t,e,n);return r?(i.next=r.next,i.prev=r,r.next.prev=i,r.next=i):(i.prev=i,i.next=i),i}function rs(t){t.next.prev=t.prev,t.prev.next=t.next,t.prevZ&&(t.prevZ.nextZ=t.nextZ),t.nextZ&&(t.nextZ.prevZ=t.prevZ)}function is(t,e,n){this.i=t,this.x=e,this.y=n,this.prev=null,this.next=null,this.z=null,this.prevZ=null,this.nextZ=null,this.steiner=!1}var as={area:function(t){for(var e=t.length,n=0,r=e-1,i=0;i2&&t[e-1].equals(t[0])&&t.pop()}function ss(t,e){for(var n=0;nNumber.EPSILON){var d=Math.sqrt(u),p=Math.sqrt(c*c+l*l),f=e.x-s/d,m=e.y+o/d,v=((n.x-l/p-f)*l-(n.y+c/p-m)*c)/(o*l-s*c),g=(r=f+o*v-t.x)*r+(i=m+s*v-t.y)*i;if(g<=2)return new pt(r,i);a=Math.sqrt(g/2)}else{var y=!1;o>Number.EPSILON?c>Number.EPSILON&&(y=!0):o<-Number.EPSILON?c<-Number.EPSILON&&(y=!0):Math.sign(s)===Math.sign(l)&&(y=!0),y?(r=-s,i=o,a=Math.sqrt(u)):(r=o,i=s,a=Math.sqrt(u/2))}return new pt(r/a,i/a)}for(var z=[],G=0,F=R.length,U=F-1,H=G+1;G=0;yt--){for(var xt=yt/p,_t=u*Math.cos(xt*Math.PI/2),bt=h*Math.sin(xt*Math.PI/2)+d,Mt=0,St=R.length;Mt=0;){var r=n,i=n-1;i<0&&(i=t.length-1);for(var a=0,o=s+2*p;a=0?(t(g-s,m,u),h.subVectors(l,u)):(t(g+s,m,u),h.subVectors(u,l)),m-s>=0?(t(g,m-s,u),d.subVectors(l,u)):(t(g,m+s,u),d.subVectors(u,l)),c.crossVectors(h,d).normalize(),a.push(c.x,c.y,c.z),o.push(g,m)}for(var y=0;y0)&&f.push(E,A,R),(S!==r-1||l=r)){u.push(c.times[d]);for(var f=0;fa.tracks[v].times[0]&&(m=a.tracks[v].times[0]);for(var g=0;g=r.times[h]){var m=h*c+s,v=m+c-s;d=Js.arraySlice(r.values,m,v)}else{var g=r.createInterpolant(),y=s,x=c-s;g.evaluate(a),d=Js.arraySlice(g.resultBuffer,y,x)}"quaternion"===i&&(new bt).fromArray(d).normalize().conjugate().toArray(d);for(var _=o.times.length,b=0;b<_;++b){var w=b*u+l;if("quaternion"===i)bt.multiplyQuaternionsFlat(o.values,w,d,0,o.values,w);else for(var M=u-2*l,S=0;S=i)break t;var s=e[1];t=(i=e[--n-1]))break e}a=n,n=0}for(;n>>1;te;)--a;if(++a,0!==i||a!==r){i>=a&&(i=(a=Math.max(a,1))-1);var o=this.getValueSize();this.times=Js.arraySlice(n,i,a),this.values=Js.arraySlice(this.values,i*o,a*o)}return this},validate:function(){var t=!0,e=this.getValueSize();e-Math.floor(e)!=0&&(console.error("THREE.KeyframeTrack: Invalid value size in track.",this),t=!1);var n=this.times,r=this.values,i=n.length;0===i&&(console.error("THREE.KeyframeTrack: Track is empty.",this),t=!1);for(var a=null,o=0;o!==i;o++){var s=n[o];if("number"==typeof s&&isNaN(s)){console.error("THREE.KeyframeTrack: Time is not a valid number.",this,o,s),t=!1;break}if(null!==a&&a>s){console.error("THREE.KeyframeTrack: Out of order keys.",this,o,s,a),t=!1;break}a=s}if(void 0!==r&&Js.isTypedArray(r))for(var c=0,l=r.length;c!==l;++c){var u=r[c];if(isNaN(u)){console.error("THREE.KeyframeTrack: Value is not a valid number.",this,c,u),t=!1;break}}return t},optimize:function(){for(var t=Js.arraySlice(this.times),e=Js.arraySlice(this.values),n=this.getValueSize(),r=this.getInterpolation()===U,i=t.length-1,a=1,o=1;o0){t[a]=t[i];for(var g=i*n,y=a*n,x=0;x!==n;++x)e[y+x]=e[g+x];++a}return a!==t.length?(this.times=Js.arraySlice(t,0,a),this.values=Js.arraySlice(e,0,a*n)):(this.times=t,this.values=e),this},clone:function(){var t=Js.arraySlice(this.times,0),e=Js.arraySlice(this.values,0),n=new(0,this.constructor)(this.name,t,e);return n.createInterpolant=this.createInterpolant,n}}),nc.prototype=Object.assign(Object.create(ec.prototype),{constructor:nc,ValueTypeName:"bool",ValueBufferType:Array,DefaultInterpolation:G,InterpolantFactoryMethodLinear:void 0,InterpolantFactoryMethodSmooth:void 0}),rc.prototype=Object.assign(Object.create(ec.prototype),{constructor:rc,ValueTypeName:"color"}),ic.prototype=Object.assign(Object.create(ec.prototype),{constructor:ic,ValueTypeName:"number"}),ac.prototype=Object.assign(Object.create(Qs.prototype),{constructor:ac,interpolate_:function(t,e,n,r){for(var i=this.resultBuffer,a=this.sampleValues,o=this.valueSize,s=(n-e)/(r-e),c=t*o,l=c+o;c!==l;c+=4)bt.slerpFlat(i,0,a,c-o,a,c,s);return i}}),oc.prototype=Object.assign(Object.create(ec.prototype),{constructor:oc,ValueTypeName:"quaternion",DefaultInterpolation:F,InterpolantFactoryMethodLinear:function(t){return new ac(this.times,this.values,this.getValueSize(),t)},InterpolantFactoryMethodSmooth:void 0}),sc.prototype=Object.assign(Object.create(ec.prototype),{constructor:sc,ValueTypeName:"string",ValueBufferType:Array,DefaultInterpolation:G,InterpolantFactoryMethodLinear:void 0,InterpolantFactoryMethodSmooth:void 0}),cc.prototype=Object.assign(Object.create(ec.prototype),{constructor:cc,ValueTypeName:"vector"}),Object.assign(lc,{parse:function(t){for(var e=[],n=t.tracks,r=1/(t.fps||1),i=0,a=n.length;i!==a;++i)e.push(uc(n[i]).scale(r));return new lc(t.name,t.duration,e,t.blendMode)},toJSON:function(t){for(var e=[],n=t.tracks,r={name:t.name,duration:t.duration,tracks:e,uuid:t.uuid,blendMode:t.blendMode},i=0,a=n.length;i!==a;++i)e.push(ec.toJSON(n[i]));return r},CreateFromMorphTargetSequence:function(t,e,n,r){for(var i=e.length,a=[],o=0;o1){var l=c[1],u=r[l];u||(r[l]=u=[]),u.push(s)}}var h=[];for(var d in r)h.push(lc.CreateFromMorphTargetSequence(d,r[d],e,n));return h},parseAnimation:function(t,e){if(!t)return console.error("THREE.AnimationClip: No animation in JSONLoader data."),null;for(var n=function(t,e,n,r,i){if(0!==n.length){var a=[],o=[];Js.flattenJSON(n,a,o,r),0!==a.length&&i.push(new t(e,a,o))}},r=[],i=t.name||"default",a=t.fps||30,o=t.blendMode,s=t.length||-1,c=t.hierarchy||[],l=0;l0||0===t.search(/^data\:image\/jpeg/);i.format=r?S:T,i.needsUpdate=!0,void 0!==e&&e(i)}),n,r),i}}),Object.assign(Mc.prototype,{getPoint:function(){return console.warn("THREE.Curve: .getPoint() not implemented."),null},getPointAt:function(t,e){var n=this.getUtoTmapping(t);return this.getPoint(n,e)},getPoints:function(t){void 0===t&&(t=5);for(var e=[],n=0;n<=t;n++)e.push(this.getPoint(n/t));return e},getSpacedPoints:function(t){void 0===t&&(t=5);for(var e=[],n=0;n<=t;n++)e.push(this.getPointAt(n/t));return e},getLength:function(){var t=this.getLengths();return t[t.length-1]},getLengths:function(t){if(void 0===t&&(t=this.arcLengthDivisions),this.cacheArcLengths&&this.cacheArcLengths.length===t+1&&!this.needsUpdate)return this.cacheArcLengths;this.needsUpdate=!1;var e,n=[],r=this.getPoint(0),i=0;n.push(0);for(var a=1;a<=t;a++)i+=(e=this.getPoint(a/t)).distanceTo(r),n.push(i),r=e;return this.cacheArcLengths=n,n},updateArcLengths:function(){this.needsUpdate=!0,this.getLengths()},getUtoTmapping:function(t,e){var n,r=this.getLengths(),i=0,a=r.length;n=e||t*r[a-1];for(var o,s=0,c=a-1;s<=c;)if((o=r[i=Math.floor(s+(c-s)/2)]-n)<0)s=i+1;else{if(!(o>0)){c=i;break}c=i-1}if(r[i=c]===n)return i/(a-1);var l=r[i];return(i+(n-l)/(r[i+1]-l))/(a-1)},getTangent:function(t,e){var n=1e-4,r=t-n,i=t+n;r<0&&(r=0),i>1&&(i=1);var a=this.getPoint(r),o=this.getPoint(i),s=e||(a.isVector2?new pt:new wt);return s.copy(o).sub(a).normalize(),s},getTangentAt:function(t,e){var n=this.getUtoTmapping(t);return this.getTangent(n,e)},computeFrenetFrames:function(t,e){for(var n=new wt,r=[],i=[],a=[],o=new wt,s=new Jt,c=0;c<=t;c++){var l=c/t;r[c]=this.getTangentAt(l,new wt),r[c].normalize()}i[0]=new wt,a[0]=new wt;var u=Number.MAX_VALUE,h=Math.abs(r[0].x),d=Math.abs(r[0].y),p=Math.abs(r[0].z);h<=u&&(u=h,n.set(1,0,0)),d<=u&&(u=d,n.set(0,1,0)),p<=u&&n.set(0,0,1),o.crossVectors(r[0],n).normalize(),i[0].crossVectors(r[0],o),a[0].crossVectors(r[0],i[0]);for(var f=1;f<=t;f++){if(i[f]=i[f-1].clone(),a[f]=a[f-1].clone(),o.crossVectors(r[f-1],r[f]),o.length()>Number.EPSILON){o.normalize();var m=Math.acos(st.clamp(r[f-1].dot(r[f]),-1,1));i[f].applyMatrix4(s.makeRotationAxis(o,m))}a[f].crossVectors(r[f],i[f])}if(!0===e){var v=Math.acos(st.clamp(i[0].dot(i[t]),-1,1));v/=t,r[0].dot(o.crossVectors(i[0],i[t]))>0&&(v=-v);for(var g=1;g<=t;g++)i[g].applyMatrix4(s.makeRotationAxis(r[g],v*g)),a[g].crossVectors(r[g],i[g])}return{tangents:r,normals:i,binormals:a}},clone:function(){return(new this.constructor).copy(this)},copy:function(t){return this.arcLengthDivisions=t.arcLengthDivisions,this},toJSON:function(){var t={metadata:{version:4.5,type:"Curve",generator:"Curve.toJSON"}};return t.arcLengthDivisions=this.arcLengthDivisions,t.type=this.type,t},fromJSON:function(t){return this.arcLengthDivisions=t.arcLengthDivisions,this}}),Sc.prototype=Object.create(Mc.prototype),Sc.prototype.constructor=Sc,Sc.prototype.isEllipseCurve=!0,Sc.prototype.getPoint=function(t,e){for(var n=e||new pt,r=2*Math.PI,i=this.aEndAngle-this.aStartAngle,a=Math.abs(i)r;)i-=r;i0?0:(Math.floor(Math.abs(c)/o)+1)*o:0===l&&c===o-1&&(c=o-2,l=1),this.closed||c>0?n=a[(c-1)%o]:(Ac.subVectors(a[0],a[1]).add(a[0]),n=Ac);var u=a[c%o],h=a[(c+1)%o];if(this.closed||c+2r.length-2?r.length-1:a+1],u=r[a>r.length-3?r.length-1:a+2];return n.set(Ic(o,s.x,c.x,l.x,u.x),Ic(o,s.y,c.y,l.y,u.y)),n},Hc.prototype.copy=function(t){Mc.prototype.copy.call(this,t),this.points=[];for(var e=0,n=t.points.length;e=e){var i=n[r]-e,a=this.curves[r],o=a.getLength(),s=0===o?0:1-i/o;return a.getPointAt(s)}r++}return null},getLength:function(){var t=this.getCurveLengths();return t[t.length-1]},updateArcLengths:function(){this.needsUpdate=!0,this.cacheLengths=null,this.getCurveLengths()},getCurveLengths:function(){if(this.cacheLengths&&this.cacheLengths.length===this.curves.length)return this.cacheLengths;for(var t=[],e=0,n=0,r=this.curves.length;n1&&!n[n.length-1].equals(n[0])&&n.push(n[0]),n},copy:function(t){Mc.prototype.copy.call(this,t),this.curves=[];for(var e=0,n=t.curves.length;e0){var l=c.getPoint(0);l.equals(this.currentPoint)||this.lineTo(l.x,l.y)}this.curves.push(c);var u=c.getPoint(1);return this.currentPoint.copy(u),this},copy:function(t){return Vc.prototype.copy.call(this,t),this.currentPoint.copy(t.currentPoint),this},toJSON:function(){var t=Vc.prototype.toJSON.call(this);return t.currentPoint=this.currentPoint.toArray(),t},fromJSON:function(t){return Vc.prototype.fromJSON.call(this,t),this.currentPoint.fromArray(t.currentPoint),this}}),jc.prototype=Object.assign(Object.create(Wc.prototype),{constructor:jc,getPointsHoles:function(t){for(var e=[],n=0,r=this.holes.length;n0:r.vertexColors=t.vertexColors),void 0!==t.uniforms)for(var i in t.uniforms){var a=t.uniforms[i];switch(r.uniforms[i]={},a.type){case"t":r.uniforms[i].value=n(a.value);break;case"c":r.uniforms[i].value=(new Ve).setHex(a.value);break;case"v2":r.uniforms[i].value=(new pt).fromArray(a.value);break;case"v3":r.uniforms[i].value=(new wt).fromArray(a.value);break;case"v4":r.uniforms[i].value=(new yt).fromArray(a.value);break;case"m3":r.uniforms[i].value=(new ft).fromArray(a.value);break;case"m4":r.uniforms[i].value=(new Jt).fromArray(a.value);break;default:r.uniforms[i].value=a.value}}if(void 0!==t.defines&&(r.defines=t.defines),void 0!==t.vertexShader&&(r.vertexShader=t.vertexShader),void 0!==t.fragmentShader&&(r.fragmentShader=t.fragmentShader),void 0!==t.extensions)for(var o in t.extensions)r.extensions[o]=t.extensions[o];if(void 0!==t.shading&&(r.flatShading=1===t.shading),void 0!==t.size&&(r.size=t.size),void 0!==t.sizeAttenuation&&(r.sizeAttenuation=t.sizeAttenuation),void 0!==t.map&&(r.map=n(t.map)),void 0!==t.matcap&&(r.matcap=n(t.matcap)),void 0!==t.alphaMap&&(r.alphaMap=n(t.alphaMap)),void 0!==t.bumpMap&&(r.bumpMap=n(t.bumpMap)),void 0!==t.bumpScale&&(r.bumpScale=t.bumpScale),void 0!==t.normalMap&&(r.normalMap=n(t.normalMap)),void 0!==t.normalMapType&&(r.normalMapType=t.normalMapType),void 0!==t.normalScale){var s=t.normalScale;!1===Array.isArray(s)&&(s=[s,s]),r.normalScale=(new pt).fromArray(s)}return void 0!==t.displacementMap&&(r.displacementMap=n(t.displacementMap)),void 0!==t.displacementScale&&(r.displacementScale=t.displacementScale),void 0!==t.displacementBias&&(r.displacementBias=t.displacementBias),void 0!==t.roughnessMap&&(r.roughnessMap=n(t.roughnessMap)),void 0!==t.metalnessMap&&(r.metalnessMap=n(t.metalnessMap)),void 0!==t.emissiveMap&&(r.emissiveMap=n(t.emissiveMap)),void 0!==t.emissiveIntensity&&(r.emissiveIntensity=t.emissiveIntensity),void 0!==t.specularMap&&(r.specularMap=n(t.specularMap)),void 0!==t.envMap&&(r.envMap=n(t.envMap)),void 0!==t.envMapIntensity&&(r.envMapIntensity=t.envMapIntensity),void 0!==t.reflectivity&&(r.reflectivity=t.reflectivity),void 0!==t.refractionRatio&&(r.refractionRatio=t.refractionRatio),void 0!==t.lightMap&&(r.lightMap=n(t.lightMap)),void 0!==t.lightMapIntensity&&(r.lightMapIntensity=t.lightMapIntensity),void 0!==t.aoMap&&(r.aoMap=n(t.aoMap)),void 0!==t.aoMapIntensity&&(r.aoMapIntensity=t.aoMapIntensity),void 0!==t.gradientMap&&(r.gradientMap=n(t.gradientMap)),void 0!==t.clearcoatMap&&(r.clearcoatMap=n(t.clearcoatMap)),void 0!==t.clearcoatRoughnessMap&&(r.clearcoatRoughnessMap=n(t.clearcoatRoughnessMap)),void 0!==t.clearcoatNormalMap&&(r.clearcoatNormalMap=n(t.clearcoatNormalMap)),void 0!==t.clearcoatNormalScale&&(r.clearcoatNormalScale=(new pt).fromArray(t.clearcoatNormalScale)),void 0!==t.transmission&&(r.transmission=t.transmission),void 0!==t.transmissionMap&&(r.transmissionMap=n(t.transmissionMap)),r},setTextures:function(t){return this.textures=t,this}});var sl={decodeText:function(t){if("undefined"!=typeof TextDecoder)return(new TextDecoder).decode(t);for(var e="",n=0,r=t.length;n0){var o=new dc(e);(n=new xc(o)).setCrossOrigin(this.crossOrigin);for(var s=0,c=t.length;sNumber.EPSILON){if(l<0&&(o=e[a],c=-c,s=e[i],l=-l),t.ys.y)continue;if(t.y===o.y){if(t.x===o.x)return!0}else{var u=l*(t.x-o.x)-c*(t.y-o.y);if(0===u)return!0;if(u<0)continue;r=!r}}else{if(t.y!==o.y)continue;if(s.x<=t.x&&t.x<=o.x||o.x<=t.x&&t.x<=s.x)return!0}}return r}var i,a,o,s=as.isClockWise,c=this.subPaths;if(0===c.length)return[];if(!0===e)return n(c);var l=[];if(1===c.length)return a=c[0],(o=new jc).curves=a.curves,l.push(o),l;var u=!s(c[0].getPoints());u=t?!u:u;var h,d,p=[],f=[],m=[],v=0;f[v]=void 0,m[v]=[];for(var g=0,y=c.length;g1){for(var x=!1,_=[],b=0,w=f.length;b0&&(x||(m=p))}for(var C=0,P=f.length;C0){this.source.connect(this.filters[0]);for(var t=1,e=this.filters.length;t0){this.source.disconnect(this.filters[0]);for(var t=1,e=this.filters.length;t0&&this._mixBufferRegionAdditive(n,r,this._addIndex*e,1,e);for(var c=e,l=e+e;c!==l;++c)if(n[c]!==n[c+e]){o.setValue(n,r);break}},saveOriginalState:function(){var t=this.binding,e=this.buffer,n=this.valueSize,r=n*this._origIndex;t.getValue(e,r);for(var i=n,a=r;i!==a;++i)e[i]=e[r+i%n];this._setIdentity(),this.cumulativeWeight=0,this.cumulativeWeightAdditive=0},restoreOriginalState:function(){var t=3*this.valueSize;this.binding.setValue(this.buffer,t)},_setAdditiveIdentityNumeric:function(){for(var t=this._addIndex*this.valueSize,e=t+this.valueSize,n=t;n=.5)for(var a=0;a!==i;++a)t[e+a]=t[n+a]},_slerp:function(t,e,n,r){bt.slerpFlat(t,e,t,e,t,n,r)},_slerpAdditive:function(t,e,n,r,i){var a=this._workIndex*i;bt.multiplyQuaternionsFlat(t,a,t,e,t,n),bt.slerpFlat(t,e,t,e,t,a,r)},_lerp:function(t,e,n,r,i){for(var a=1-r,o=0;o!==i;++o){var s=e+o;t[s]=t[s]*a+t[n+o]*r}},_lerpAdditive:function(t,e,n,r,i){for(var a=0;a!==i;++a){var o=e+a;t[o]=t[o]+t[n+a]*r}}});var Vl="\\[\\]\\.:\\/",Wl=new RegExp("[\\[\\]\\.:\\/]","g"),jl="[^\\[\\]\\.:\\/]",ql="[^"+Vl.replace("\\.","")+"]",Xl=/((?:WC+[\/:])*)/.source.replace("WC",jl),Yl=/(WCOD+)?/.source.replace("WCOD",ql),Zl=/(?:\.(WC+)(?:\[(.+)\])?)?/.source.replace("WC",jl),Jl=/\.(WC+)(?:\[(.+)\])?/.source.replace("WC",jl),Ql=new RegExp("^"+Xl+Yl+Zl+Jl+"$"),Kl=["material","materials","bones"];function $l(t,e,n){var r=n||tu.parseTrackName(e);this._targetGroup=t,this._bindings=t.subscribe_(e,r)}function tu(t,e,n){this.path=e,this.parsedPath=n||tu.parseTrackName(e),this.node=tu.findNode(t,this.parsedPath.nodeName)||t,this.rootNode=t}function eu(){this.uuid=st.generateUUID(),this._objects=Array.prototype.slice.call(arguments),this.nCachedObjects_=0;var t={};this._indicesByUUID=t;for(var e=0,n=arguments.length;e!==n;++e)t[arguments[e].uuid]=e;this._paths=[],this._parsedPaths=[],this._bindings=[],this._bindingsIndicesByPath={};var r=this;this.stats={objects:{get total(){return r._objects.length},get inUse(){return this.total-r.nCachedObjects_}},get bindingsPerObject(){return r._bindings.length}}}Object.assign($l.prototype,{getValue:function(t,e){this.bind();var n=this._targetGroup.nCachedObjects_,r=this._bindings[n];void 0!==r&&r.getValue(t,e)},setValue:function(t,e){for(var n=this._bindings,r=this._targetGroup.nCachedObjects_,i=n.length;r!==i;++r)n[r].setValue(t,e)},bind:function(){for(var t=this._bindings,e=this._targetGroup.nCachedObjects_,n=t.length;e!==n;++e)t[e].bind()},unbind:function(){for(var t=this._bindings,e=this._targetGroup.nCachedObjects_,n=t.length;e!==n;++e)t[e].unbind()}}),Object.assign(tu,{Composite:$l,create:function(t,e,n){return t&&t.isAnimationObjectGroup?new tu.Composite(t,e,n):new tu(t,e,n)},sanitizeNodeName:function(t){return t.replace(/\s/g,"_").replace(Wl,"")},parseTrackName:function(t){var e=Ql.exec(t);if(!e)throw new Error("PropertyBinding: Cannot parse trackName: "+t);var n={nodeName:e[2],objectName:e[3],objectIndex:e[4],propertyName:e[5],propertyIndex:e[6]},r=n.nodeName&&n.nodeName.lastIndexOf(".");if(void 0!==r&&-1!==r){var i=n.nodeName.substring(r+1);-1!==Kl.indexOf(i)&&(n.nodeName=n.nodeName.substring(0,r),n.objectName=i)}if(null===n.propertyName||0===n.propertyName.length)throw new Error("PropertyBinding: can not parse propertyName from trackName: "+t);return n},findNode:function(t,e){if(!e||""===e||"."===e||-1===e||e===t.name||e===t.uuid)return t;if(t.skeleton){var n=t.skeleton.getBoneByName(e);if(void 0!==n)return n}if(t.children){var r=function t(n){for(var r=0;r=i){var u=i++,h=t[u];e[h.uuid]=l,t[l]=h,e[c]=u,t[u]=s;for(var d=0,p=r;d!==p;++d){var f=n[d],m=f[u],v=f[l];f[l]=m,f[u]=v}}}this.nCachedObjects_=i},uncache:function(){for(var t=this._objects,e=this._indicesByUUID,n=this._bindings,r=n.length,i=this.nCachedObjects_,a=t.length,o=0,s=arguments.length;o!==s;++o){var c=arguments[o],l=c.uuid,u=e[l];if(void 0!==u)if(delete e[l],u0){var c=this._interpolants,l=this._propertyBindings;switch(this.blendMode){case j:for(var u=0,h=c.length;u!==h;++u)c[u].evaluate(o),l[u].accumulateAdditive(s);break;case W:default:for(var d=0,p=c.length;d!==p;++d)c[d].evaluate(o),l[d].accumulate(r,s)}}}else this._updateWeight(t)},e._updateWeight=function(t){var e=0;if(this.enabled){e=this.weight;var n=this._weightInterpolant;if(null!==n){var r=n.evaluate(t)[0];e*=r,t>n.parameterPositions[1]&&(this.stopFading(),0===r&&(this.enabled=!1))}}return this._effectiveWeight=e,e},e._updateTimeScale=function(t){var e=0;if(!this.paused){e=this.timeScale;var n=this._timeScaleInterpolant;if(null!==n)e*=n.evaluate(t)[0],t>n.parameterPositions[1]&&(this.stopWarping(),0===e?this.paused=!0:this.timeScale=e)}return this._effectiveTimeScale=e,e},e._updateTime=function(t){var e=this._clip.duration,n=this.loop,r=this.time+t,i=this._loopCount,a=2202===n;if(0===t)return-1===i?r:a&&1==(1&i)?e-r:r;if(2200===n){-1===i&&(this._loopCount=0,this._setEndings(!0,!0,!1));t:{if(r>=e)r=e;else{if(!(r<0)){this.time=r;break t}r=0}this.clampWhenFinished?this.paused=!0:this.enabled=!1,this.time=r,this._mixer.dispatchEvent({type:"finished",action:this,direction:t<0?-1:1})}}else{if(-1===i&&(t>=0?(i=0,this._setEndings(!0,0===this.repetitions,a)):this._setEndings(0===this.repetitions,!0,a)),r>=e||r<0){var o=Math.floor(r/e);r-=e*o,i+=Math.abs(o);var s=this.repetitions-i;if(s<=0)this.clampWhenFinished?this.paused=!0:this.enabled=!1,r=t>0?e:0,this.time=r,this._mixer.dispatchEvent({type:"finished",action:this,direction:t>0?1:-1});else{if(1===s){var c=t<0;this._setEndings(c,!c,a)}else this._setEndings(!1,!1,a);this._loopCount=i,this.time=r,this._mixer.dispatchEvent({type:"loop",action:this,loopDelta:o})}}else this.time=r;if(a&&1==(1&i))return e-r}return r},e._setEndings=function(t,e,n){var r=this._interpolantSettings;n?(r.endingStart=k,r.endingEnd=k):(r.endingStart=t?this.zeroSlopeAtStart?k:H:V,r.endingEnd=e?this.zeroSlopeAtEnd?k:H:V)},e._scheduleFading=function(t,e,n){var r=this._mixer,i=r.time,a=this._weightInterpolant;null===a&&(a=r._lendControlInterpolant(),this._weightInterpolant=a);var o=a.parameterPositions,s=a.sampleValues;return o[0]=i,s[0]=e,o[1]=i+t,s[1]=n,this},t}();function ru(t){this._root=t,this._initMemoryManager(),this._accuIndex=0,this.time=0,this.timeScale=1}ru.prototype=Object.assign(Object.create(rt.prototype),{constructor:ru,_bindAction:function(t,e){var n=t._localRoot||this._root,r=t._clip.tracks,i=r.length,a=t._propertyBindings,o=t._interpolants,s=n.uuid,c=this._bindingsByRootAndName,l=c[s];void 0===l&&(l={},c[s]=l);for(var u=0;u!==i;++u){var h=r[u],d=h.name,p=l[d];if(void 0!==p)a[u]=p;else{if(void 0!==(p=a[u])){null===p._cacheIndex&&(++p.referenceCount,this._addInactiveBinding(p,s,d));continue}var f=e&&e._propertyBindings[u].binding.parsedPath;++(p=new kl(tu.create(n,d,f),h.ValueTypeName,h.getValueSize())).referenceCount,this._addInactiveBinding(p,s,d),a[u]=p}o[u].resultBuffer=p.buffer}},_activateAction:function(t){if(!this._isActiveAction(t)){if(null===t._cacheIndex){var e=(t._localRoot||this._root).uuid,n=t._clip.uuid,r=this._actionsByClip[n];this._bindAction(t,r&&r.knownActions[0]),this._addInactiveAction(t,n,e)}for(var i=t._propertyBindings,a=0,o=i.length;a!==o;++a){var s=i[a];0==s.useCount++&&(this._lendBinding(s),s.saveOriginalState())}this._lendAction(t)}},_deactivateAction:function(t){if(this._isActiveAction(t)){for(var e=t._propertyBindings,n=0,r=e.length;n!==r;++n){var i=e[n];0==--i.useCount&&(i.restoreOriginalState(),this._takeBackBinding(i))}this._takeBackAction(t)}},_initMemoryManager:function(){this._actions=[],this._nActiveActions=0,this._actionsByClip={},this._bindings=[],this._nActiveBindings=0,this._bindingsByRootAndName={},this._controlInterpolants=[],this._nActiveControlInterpolants=0;var t=this;this.stats={actions:{get total(){return t._actions.length},get inUse(){return t._nActiveActions}},bindings:{get total(){return t._bindings.length},get inUse(){return t._nActiveBindings}},controlInterpolants:{get total(){return t._controlInterpolants.length},get inUse(){return t._nActiveControlInterpolants}}}},_isActiveAction:function(t){var e=t._cacheIndex;return null!==e&&e=0;--e)t[e].stop();return this},update:function(t){t*=this.timeScale;for(var e=this._actions,n=this._nActiveActions,r=this.time+=t,i=Math.sign(t),a=this._accuIndex^=1,o=0;o!==n;++o){e[o]._update(r,t,i,a)}for(var s=this._bindings,c=this._nActiveBindings,l=0;l!==c;++l)s[l].apply(a);return this},setTime:function(t){this.time=0;for(var e=0;ethis.max.x||t.ythis.max.y)},e.containsBox=function(t){return this.min.x<=t.min.x&&t.max.x<=this.max.x&&this.min.y<=t.min.y&&t.max.y<=this.max.y},e.getParameter=function(t,e){return void 0===e&&(console.warn("THREE.Box2: .getParameter() target is now required"),e=new pt),e.set((t.x-this.min.x)/(this.max.x-this.min.x),(t.y-this.min.y)/(this.max.y-this.min.y))},e.intersectsBox=function(t){return!(t.max.xthis.max.x||t.max.ythis.max.y)},e.clampPoint=function(t,e){return void 0===e&&(console.warn("THREE.Box2: .clampPoint() target is now required"),e=new pt),e.copy(t).clamp(this.min,this.max)},e.distanceToPoint=function(t){return du.copy(t).clamp(this.min,this.max).sub(t).length()},e.intersect=function(t){return this.min.max(t.min),this.max.min(t.max),this},e.union=function(t){return this.min.min(t.min),this.max.max(t.max),this},e.translate=function(t){return this.min.add(t),this.max.add(t),this},e.equals=function(t){return t.min.equals(this.min)&&t.max.equals(this.max)},t}(),fu=new wt,mu=new wt,vu=function(){function t(t,e){this.start=void 0!==t?t:new wt,this.end=void 0!==e?e:new wt}var e=t.prototype;return e.set=function(t,e){return this.start.copy(t),this.end.copy(e),this},e.clone=function(){return(new this.constructor).copy(this)},e.copy=function(t){return this.start.copy(t.start),this.end.copy(t.end),this},e.getCenter=function(t){return void 0===t&&(console.warn("THREE.Line3: .getCenter() target is now required"),t=new wt),t.addVectors(this.start,this.end).multiplyScalar(.5)},e.delta=function(t){return void 0===t&&(console.warn("THREE.Line3: .delta() target is now required"),t=new wt),t.subVectors(this.end,this.start)},e.distanceSq=function(){return this.start.distanceToSquared(this.end)},e.distance=function(){return this.start.distanceTo(this.end)},e.at=function(t,e){return void 0===e&&(console.warn("THREE.Line3: .at() target is now required"),e=new wt),this.delta(e).multiplyScalar(t).add(this.start)},e.closestPointToPointParameter=function(t,e){fu.subVectors(t,this.start),mu.subVectors(this.end,this.start);var n=mu.dot(mu),r=mu.dot(fu)/n;return e&&(r=st.clamp(r,0,1)),r},e.closestPointToPoint=function(t,e,n){var r=this.closestPointToPointParameter(t,e);return void 0===n&&(console.warn("THREE.Line3: .closestPointToPoint() target is now required"),n=new wt),this.delta(n).multiplyScalar(r).add(this.start)},e.applyMatrix4=function(t){return this.start.applyMatrix4(t),this.end.applyMatrix4(t),this},e.equals=function(t){return t.start.equals(this.start)&&t.end.equals(this.end)},t}();function gu(t){be.call(this),this.material=t,this.render=function(){},this.hasPositions=!1,this.hasNormals=!1,this.hasColors=!1,this.hasUvs=!1,this.positionArray=null,this.normalArray=null,this.colorArray=null,this.uvArray=null,this.count=0}gu.prototype=Object.create(be.prototype),gu.prototype.constructor=gu,gu.prototype.isImmediateRenderObject=!0;var yu=new wt,xu=function(t){function e(e,n){var r;(r=t.call(this)||this).light=e,r.light.updateMatrixWorld(),r.matrix=e.matrixWorld,r.matrixAutoUpdate=!1,r.color=n;for(var i=new vn,a=[0,0,0,0,0,1,0,0,0,1,0,1,0,0,0,-1,0,1,0,0,0,0,1,1,0,0,0,0,-1,1],o=0,s=1;o<32;o++,s++){var c=o/32*Math.PI*2,l=s/32*Math.PI*2;a.push(Math.cos(c),Math.sin(c),1,Math.cos(l),Math.sin(l),1)}i.setAttribute("position",new an(a,3));var u=new ja({fog:!1,toneMapped:!1});return r.cone=new to(i,u),r.add(r.cone),r.update(),r}ut(e,t);var n=e.prototype;return n.dispose=function(){this.cone.geometry.dispose(),this.cone.material.dispose()},n.update=function(){this.light.updateMatrixWorld();var t=this.light.distance?this.light.distance:1e3,e=t*Math.tan(this.light.angle);this.cone.scale.set(e,e,t),yu.setFromMatrixPosition(this.light.target.matrixWorld),this.cone.lookAt(yu),void 0!==this.color?this.cone.material.color.set(this.color):this.cone.material.color.copy(this.light.color)},e}(be),_u=new wt,bu=new Jt,wu=new Jt,Mu=function(t){function e(e){for(var n,r=Su(e),i=new vn,a=[],o=[],s=new Ve(0,0,1),c=new Ve(0,1,0),l=0;l.99999)this.quaternion.set(0,0,0,1);else if(t.y<-.99999)this.quaternion.set(1,0,0,0);else{Xu.set(t.z,0,-t.x).normalize();var e=Math.acos(t.y);this.quaternion.setFromAxisAngle(Xu,e)}},n.setLength=function(t,e,n){void 0===e&&(e=.2*t),void 0===n&&(n=.2*e),this.line.scale.set(1,Math.max(1e-4,t-e),1),this.line.updateMatrix(),this.cone.scale.set(n,e,n),this.cone.position.y=t,this.cone.updateMatrix()},n.setColor=function(t){this.line.material.color.set(t),this.cone.material.color.set(t)},n.copy=function(e){return t.prototype.copy.call(this,e,!1),this.line.copy(e.line),this.cone.copy(e.cone),this},e}(be),Zu=function(t){function e(e){var n;void 0===e&&(e=1);var r=[0,0,0,e,0,0,0,0,0,0,e,0,0,0,0,0,0,e],i=new vn;i.setAttribute("position",new an(r,3)),i.setAttribute("color",new an([1,0,0,1,.6,0,0,1,0,.6,1,0,0,0,1,0,.6,1],3));var a=new ja({vertexColors:!0,toneMapped:!1});return(n=t.call(this,i,a)||this).type="AxesHelper",n}return ut(e,t),e}(to),Ju=Math.pow(2,8),Qu=[.125,.215,.35,.446,.526,.582],Ku=5+Qu.length,$u=20,th=((ku={})[3e3]=0,ku[3001]=1,ku[3002]=2,ku[3004]=3,ku[3005]=4,ku[3006]=5,ku[3007]=6,ku),eh=new $c,nh=dh(),rh=nh._lodPlanes,ih=nh._sizeLods,ah=nh._sigmas,oh=null,sh=(1+Math.sqrt(5))/2,ch=1/sh,lh=[new wt(1,1,1),new wt(-1,1,1),new wt(1,1,-1),new wt(-1,1,-1),new wt(0,sh,ch),new wt(0,sh,-ch),new wt(ch,0,sh),new wt(-ch,0,sh),new wt(sh,ch,0),new wt(-sh,ch,0)],uh=function(){function t(t){var e,n,r;this._renderer=t,this._pingPongRenderTarget=null,this._blurMaterial=(e=$u,n=new Float32Array(e),r=new wt(0,1,0),new Us({name:"SphericalGaussianBlur",defines:{n:e},uniforms:{envMap:{value:null},samples:{value:1},weights:{value:n},latitudinal:{value:!1},dTheta:{value:0},mipInt:{value:0},poleAxis:{value:r},inputEncoding:{value:th[3e3]},outputEncoding:{value:th[3e3]}},vertexShader:"\n\n\t\tprecision mediump float;\n\t\tprecision mediump int;\n\n\t\tattribute vec3 position;\n\t\tattribute vec2 uv;\n\t\tattribute float faceIndex;\n\n\t\tvarying vec3 vOutputDirection;\n\n\t\t// RH coordinate system; PMREM face-indexing convention\n\t\tvec3 getDirection( vec2 uv, float face ) {\n\n\t\t\tuv = 2.0 * uv - 1.0;\n\n\t\t\tvec3 direction = vec3( uv, 1.0 );\n\n\t\t\tif ( face == 0.0 ) {\n\n\t\t\t\tdirection = direction.zyx; // ( 1, v, u ) pos x\n\n\t\t\t} else if ( face == 1.0 ) {\n\n\t\t\t\tdirection = direction.xzy;\n\t\t\t\tdirection.xz *= -1.0; // ( -u, 1, -v ) pos y\n\n\t\t\t} else if ( face == 2.0 ) {\n\n\t\t\t\tdirection.x *= -1.0; // ( -u, v, 1 ) pos z\n\n\t\t\t} else if ( face == 3.0 ) {\n\n\t\t\t\tdirection = direction.zyx;\n\t\t\t\tdirection.xz *= -1.0; // ( -1, v, -u ) neg x\n\n\t\t\t} else if ( face == 4.0 ) {\n\n\t\t\t\tdirection = direction.xzy;\n\t\t\t\tdirection.xy *= -1.0; // ( -u, -1, v ) neg y\n\n\t\t\t} else if ( face == 5.0 ) {\n\n\t\t\t\tdirection.z *= -1.0; // ( u, v, -1 ) neg z\n\n\t\t\t}\n\n\t\t\treturn direction;\n\n\t\t}\n\n\t\tvoid main() {\n\n\t\t\tvOutputDirection = getDirection( uv, faceIndex );\n\t\t\tgl_Position = vec4( position, 1.0 );\n\n\t\t}\n\t",fragmentShader:"\n\n\t\t\tprecision mediump float;\n\t\t\tprecision mediump int;\n\n\t\t\tvarying vec3 vOutputDirection;\n\n\t\t\tuniform sampler2D envMap;\n\t\t\tuniform int samples;\n\t\t\tuniform float weights[ n ];\n\t\t\tuniform bool latitudinal;\n\t\t\tuniform float dTheta;\n\t\t\tuniform float mipInt;\n\t\t\tuniform vec3 poleAxis;\n\n\t\t\t\n\n\t\tuniform int inputEncoding;\n\t\tuniform int outputEncoding;\n\n\t\t#include \n\n\t\tvec4 inputTexelToLinear( vec4 value ) {\n\n\t\t\tif ( inputEncoding == 0 ) {\n\n\t\t\t\treturn value;\n\n\t\t\t} else if ( inputEncoding == 1 ) {\n\n\t\t\t\treturn sRGBToLinear( value );\n\n\t\t\t} else if ( inputEncoding == 2 ) {\n\n\t\t\t\treturn RGBEToLinear( value );\n\n\t\t\t} else if ( inputEncoding == 3 ) {\n\n\t\t\t\treturn RGBMToLinear( value, 7.0 );\n\n\t\t\t} else if ( inputEncoding == 4 ) {\n\n\t\t\t\treturn RGBMToLinear( value, 16.0 );\n\n\t\t\t} else if ( inputEncoding == 5 ) {\n\n\t\t\t\treturn RGBDToLinear( value, 256.0 );\n\n\t\t\t} else {\n\n\t\t\t\treturn GammaToLinear( value, 2.2 );\n\n\t\t\t}\n\n\t\t}\n\n\t\tvec4 linearToOutputTexel( vec4 value ) {\n\n\t\t\tif ( outputEncoding == 0 ) {\n\n\t\t\t\treturn value;\n\n\t\t\t} else if ( outputEncoding == 1 ) {\n\n\t\t\t\treturn LinearTosRGB( value );\n\n\t\t\t} else if ( outputEncoding == 2 ) {\n\n\t\t\t\treturn LinearToRGBE( value );\n\n\t\t\t} else if ( outputEncoding == 3 ) {\n\n\t\t\t\treturn LinearToRGBM( value, 7.0 );\n\n\t\t\t} else if ( outputEncoding == 4 ) {\n\n\t\t\t\treturn LinearToRGBM( value, 16.0 );\n\n\t\t\t} else if ( outputEncoding == 5 ) {\n\n\t\t\t\treturn LinearToRGBD( value, 256.0 );\n\n\t\t\t} else {\n\n\t\t\t\treturn LinearToGamma( value, 2.2 );\n\n\t\t\t}\n\n\t\t}\n\n\t\tvec4 envMapTexelToLinear( vec4 color ) {\n\n\t\t\treturn inputTexelToLinear( color );\n\n\t\t}\n\t\n\n\t\t\t#define ENVMAP_TYPE_CUBE_UV\n\t\t\t#include \n\n\t\t\tvec3 getSample( float theta, vec3 axis ) {\n\n\t\t\t\tfloat cosTheta = cos( theta );\n\t\t\t\t// Rodrigues' axis-angle rotation\n\t\t\t\tvec3 sampleDirection = vOutputDirection * cosTheta\n\t\t\t\t\t+ cross( axis, vOutputDirection ) * sin( theta )\n\t\t\t\t\t+ axis * dot( axis, vOutputDirection ) * ( 1.0 - cosTheta );\n\n\t\t\t\treturn bilinearCubeUV( envMap, sampleDirection, mipInt );\n\n\t\t\t}\n\n\t\t\tvoid main() {\n\n\t\t\t\tvec3 axis = latitudinal ? poleAxis : cross( poleAxis, vOutputDirection );\n\n\t\t\t\tif ( all( equal( axis, vec3( 0.0 ) ) ) ) {\n\n\t\t\t\t\taxis = vec3( vOutputDirection.z, 0.0, - vOutputDirection.x );\n\n\t\t\t\t}\n\n\t\t\t\taxis = normalize( axis );\n\n\t\t\t\tgl_FragColor = vec4( 0.0, 0.0, 0.0, 1.0 );\n\t\t\t\tgl_FragColor.rgb += weights[ 0 ] * getSample( 0.0, axis );\n\n\t\t\t\tfor ( int i = 1; i < n; i++ ) {\n\n\t\t\t\t\tif ( i >= samples ) {\n\n\t\t\t\t\t\tbreak;\n\n\t\t\t\t\t}\n\n\t\t\t\t\tfloat theta = dTheta * float( i );\n\t\t\t\t\tgl_FragColor.rgb += weights[ i ] * getSample( -1.0 * theta, axis );\n\t\t\t\t\tgl_FragColor.rgb += weights[ i ] * getSample( theta, axis );\n\n\t\t\t\t}\n\n\t\t\t\tgl_FragColor = linearToOutputTexel( gl_FragColor );\n\n\t\t\t}\n\t\t",blending:0,depthTest:!1,depthWrite:!1})),this._equirectShader=null,this._cubemapShader=null,this._compileMaterial(this._blurMaterial)}var e=t.prototype;return e.fromScene=function(t,e,n,r){void 0===e&&(e=0),void 0===n&&(n=.1),void 0===r&&(r=100),oh=this._renderer.getRenderTarget();var i=this._allocateTargets();return this._sceneToCubeUV(t,n,r,i),e>0&&this._blur(i,0,0,e),this._applyPMREM(i),this._cleanup(i),i},e.fromEquirectangular=function(t){return this._fromTexture(t)},e.fromCubemap=function(t){return this._fromTexture(t)},e.compileCubemapShader=function(){null===this._cubemapShader&&(this._cubemapShader=vh(),this._compileMaterial(this._cubemapShader))},e.compileEquirectangularShader=function(){null===this._equirectShader&&(this._equirectShader=mh(),this._compileMaterial(this._equirectShader))},e.dispose=function(){this._blurMaterial.dispose(),null!==this._cubemapShader&&this._cubemapShader.dispose(),null!==this._equirectShader&&this._equirectShader.dispose();for(var t=0;t2?Ju:0,Ju,Ju),s.setRenderTarget(r),s.render(t,i)}s.toneMapping=l,s.outputEncoding=c,s.setClearColor(u,h)},e._textureToCubeUV=function(t,e){var n=this._renderer;t.isCubeTexture?null==this._cubemapShader&&(this._cubemapShader=vh()):null==this._equirectShader&&(this._equirectShader=mh());var r=t.isCubeTexture?this._cubemapShader:this._equirectShader,i=new Nn(rh[0],r),a=r.uniforms;a.envMap.value=t,t.isCubeTexture||a.texelSize.value.set(1/t.image.width,1/t.image.height),a.inputEncoding.value=th[t.encoding],a.outputEncoding.value=th[e.texture.encoding],fh(e,0,0,3*Ju,2*Ju),n.setRenderTarget(e),n.render(i,eh)},e._applyPMREM=function(t){var e=this._renderer,n=e.autoClear;e.autoClear=!1;for(var r=1;r$u&&console.warn("sigmaRadians, "+i+", is too large and will clip, as it requested "+f+" samples when the maximum is set to "+$u);for(var m=[],v=0,g=0;g<$u;++g){var y=g/p,x=Math.exp(-y*y/2);m.push(x),0==g?v+=x:g4?r-8+4:0),3*b,2*b),s.setRenderTarget(e),s.render(l,eh)},t}();function hh(t){return void 0!==t&&t.type===y&&(t.encoding===q||t.encoding===X||t.encoding===Y)}function dh(){for(var t=[],e=[],n=[],r=8,i=0;i4?o=Qu[i-8+4-1]:0==i&&(o=0),n.push(o);for(var s=1/(a-1),c=-s/2,l=1+s/2,u=[c,c,l,c,l,l,c,c,l,l,c,l],h=new Float32Array(108),d=new Float32Array(72),p=new Float32Array(36),f=0;f<6;f++){var m=f%3*2/3-1,v=f>2?0:-1,g=[m,v,0,m+2/3,v,0,m+2/3,v+1,0,m,v,0,m+2/3,v+1,0,m,v+1,0];h.set(g,18*f),d.set(u,12*f);var y=[f,f,f,f,f,f];p.set(y,6*f)}var x=new vn;x.setAttribute("position",new Je(h,3)),x.setAttribute("uv",new Je(d,2)),x.setAttribute("faceIndex",new Je(p,1)),t.push(x),r>4&&r--}return{_lodPlanes:t,_sizeLods:e,_sigmas:n}}function ph(t){var e=new xt(3*Ju,3*Ju,t);return e.texture.mapping=s,e.texture.name="PMREM.cubeUv",e.scissorTest=!0,e}function fh(t,e,n,r,i){t.viewport.set(e,n,r,i),t.scissor.set(e,n,r,i)}function mh(){return new Us({name:"EquirectangularToCubeUV",uniforms:{envMap:{value:null},texelSize:{value:new pt(1,1)},inputEncoding:{value:th[3e3]},outputEncoding:{value:th[3e3]}},vertexShader:"\n\n\t\tprecision mediump float;\n\t\tprecision mediump int;\n\n\t\tattribute vec3 position;\n\t\tattribute vec2 uv;\n\t\tattribute float faceIndex;\n\n\t\tvarying vec3 vOutputDirection;\n\n\t\t// RH coordinate system; PMREM face-indexing convention\n\t\tvec3 getDirection( vec2 uv, float face ) {\n\n\t\t\tuv = 2.0 * uv - 1.0;\n\n\t\t\tvec3 direction = vec3( uv, 1.0 );\n\n\t\t\tif ( face == 0.0 ) {\n\n\t\t\t\tdirection = direction.zyx; // ( 1, v, u ) pos x\n\n\t\t\t} else if ( face == 1.0 ) {\n\n\t\t\t\tdirection = direction.xzy;\n\t\t\t\tdirection.xz *= -1.0; // ( -u, 1, -v ) pos y\n\n\t\t\t} else if ( face == 2.0 ) {\n\n\t\t\t\tdirection.x *= -1.0; // ( -u, v, 1 ) pos z\n\n\t\t\t} else if ( face == 3.0 ) {\n\n\t\t\t\tdirection = direction.zyx;\n\t\t\t\tdirection.xz *= -1.0; // ( -1, v, -u ) neg x\n\n\t\t\t} else if ( face == 4.0 ) {\n\n\t\t\t\tdirection = direction.xzy;\n\t\t\t\tdirection.xy *= -1.0; // ( -u, -1, v ) neg y\n\n\t\t\t} else if ( face == 5.0 ) {\n\n\t\t\t\tdirection.z *= -1.0; // ( u, v, -1 ) neg z\n\n\t\t\t}\n\n\t\t\treturn direction;\n\n\t\t}\n\n\t\tvoid main() {\n\n\t\t\tvOutputDirection = getDirection( uv, faceIndex );\n\t\t\tgl_Position = vec4( position, 1.0 );\n\n\t\t}\n\t",fragmentShader:"\n\n\t\t\tprecision mediump float;\n\t\t\tprecision mediump int;\n\n\t\t\tvarying vec3 vOutputDirection;\n\n\t\t\tuniform sampler2D envMap;\n\t\t\tuniform vec2 texelSize;\n\n\t\t\t\n\n\t\tuniform int inputEncoding;\n\t\tuniform int outputEncoding;\n\n\t\t#include \n\n\t\tvec4 inputTexelToLinear( vec4 value ) {\n\n\t\t\tif ( inputEncoding == 0 ) {\n\n\t\t\t\treturn value;\n\n\t\t\t} else if ( inputEncoding == 1 ) {\n\n\t\t\t\treturn sRGBToLinear( value );\n\n\t\t\t} else if ( inputEncoding == 2 ) {\n\n\t\t\t\treturn RGBEToLinear( value );\n\n\t\t\t} else if ( inputEncoding == 3 ) {\n\n\t\t\t\treturn RGBMToLinear( value, 7.0 );\n\n\t\t\t} else if ( inputEncoding == 4 ) {\n\n\t\t\t\treturn RGBMToLinear( value, 16.0 );\n\n\t\t\t} else if ( inputEncoding == 5 ) {\n\n\t\t\t\treturn RGBDToLinear( value, 256.0 );\n\n\t\t\t} else {\n\n\t\t\t\treturn GammaToLinear( value, 2.2 );\n\n\t\t\t}\n\n\t\t}\n\n\t\tvec4 linearToOutputTexel( vec4 value ) {\n\n\t\t\tif ( outputEncoding == 0 ) {\n\n\t\t\t\treturn value;\n\n\t\t\t} else if ( outputEncoding == 1 ) {\n\n\t\t\t\treturn LinearTosRGB( value );\n\n\t\t\t} else if ( outputEncoding == 2 ) {\n\n\t\t\t\treturn LinearToRGBE( value );\n\n\t\t\t} else if ( outputEncoding == 3 ) {\n\n\t\t\t\treturn LinearToRGBM( value, 7.0 );\n\n\t\t\t} else if ( outputEncoding == 4 ) {\n\n\t\t\t\treturn LinearToRGBM( value, 16.0 );\n\n\t\t\t} else if ( outputEncoding == 5 ) {\n\n\t\t\t\treturn LinearToRGBD( value, 256.0 );\n\n\t\t\t} else {\n\n\t\t\t\treturn LinearToGamma( value, 2.2 );\n\n\t\t\t}\n\n\t\t}\n\n\t\tvec4 envMapTexelToLinear( vec4 color ) {\n\n\t\t\treturn inputTexelToLinear( color );\n\n\t\t}\n\t\n\n\t\t\t#include \n\n\t\t\tvoid main() {\n\n\t\t\t\tgl_FragColor = vec4( 0.0, 0.0, 0.0, 1.0 );\n\n\t\t\t\tvec3 outputDirection = normalize( vOutputDirection );\n\t\t\t\tvec2 uv = equirectUv( outputDirection );\n\n\t\t\t\tvec2 f = fract( uv / texelSize - 0.5 );\n\t\t\t\tuv -= f * texelSize;\n\t\t\t\tvec3 tl = envMapTexelToLinear( texture2D ( envMap, uv ) ).rgb;\n\t\t\t\tuv.x += texelSize.x;\n\t\t\t\tvec3 tr = envMapTexelToLinear( texture2D ( envMap, uv ) ).rgb;\n\t\t\t\tuv.y += texelSize.y;\n\t\t\t\tvec3 br = envMapTexelToLinear( texture2D ( envMap, uv ) ).rgb;\n\t\t\t\tuv.x -= texelSize.x;\n\t\t\t\tvec3 bl = envMapTexelToLinear( texture2D ( envMap, uv ) ).rgb;\n\n\t\t\t\tvec3 tm = mix( tl, tr, f.x );\n\t\t\t\tvec3 bm = mix( bl, br, f.x );\n\t\t\t\tgl_FragColor.rgb = mix( tm, bm, f.y );\n\n\t\t\t\tgl_FragColor = linearToOutputTexel( gl_FragColor );\n\n\t\t\t}\n\t\t",blending:0,depthTest:!1,depthWrite:!1})}function vh(){return new Us({name:"CubemapToCubeUV",uniforms:{envMap:{value:null},inputEncoding:{value:th[3e3]},outputEncoding:{value:th[3e3]}},vertexShader:"\n\n\t\tprecision mediump float;\n\t\tprecision mediump int;\n\n\t\tattribute vec3 position;\n\t\tattribute vec2 uv;\n\t\tattribute float faceIndex;\n\n\t\tvarying vec3 vOutputDirection;\n\n\t\t// RH coordinate system; PMREM face-indexing convention\n\t\tvec3 getDirection( vec2 uv, float face ) {\n\n\t\t\tuv = 2.0 * uv - 1.0;\n\n\t\t\tvec3 direction = vec3( uv, 1.0 );\n\n\t\t\tif ( face == 0.0 ) {\n\n\t\t\t\tdirection = direction.zyx; // ( 1, v, u ) pos x\n\n\t\t\t} else if ( face == 1.0 ) {\n\n\t\t\t\tdirection = direction.xzy;\n\t\t\t\tdirection.xz *= -1.0; // ( -u, 1, -v ) pos y\n\n\t\t\t} else if ( face == 2.0 ) {\n\n\t\t\t\tdirection.x *= -1.0; // ( -u, v, 1 ) pos z\n\n\t\t\t} else if ( face == 3.0 ) {\n\n\t\t\t\tdirection = direction.zyx;\n\t\t\t\tdirection.xz *= -1.0; // ( -1, v, -u ) neg x\n\n\t\t\t} else if ( face == 4.0 ) {\n\n\t\t\t\tdirection = direction.xzy;\n\t\t\t\tdirection.xy *= -1.0; // ( -u, -1, v ) neg y\n\n\t\t\t} else if ( face == 5.0 ) {\n\n\t\t\t\tdirection.z *= -1.0; // ( u, v, -1 ) neg z\n\n\t\t\t}\n\n\t\t\treturn direction;\n\n\t\t}\n\n\t\tvoid main() {\n\n\t\t\tvOutputDirection = getDirection( uv, faceIndex );\n\t\t\tgl_Position = vec4( position, 1.0 );\n\n\t\t}\n\t",fragmentShader:"\n\n\t\t\tprecision mediump float;\n\t\t\tprecision mediump int;\n\n\t\t\tvarying vec3 vOutputDirection;\n\n\t\t\tuniform samplerCube envMap;\n\n\t\t\t\n\n\t\tuniform int inputEncoding;\n\t\tuniform int outputEncoding;\n\n\t\t#include \n\n\t\tvec4 inputTexelToLinear( vec4 value ) {\n\n\t\t\tif ( inputEncoding == 0 ) {\n\n\t\t\t\treturn value;\n\n\t\t\t} else if ( inputEncoding == 1 ) {\n\n\t\t\t\treturn sRGBToLinear( value );\n\n\t\t\t} else if ( inputEncoding == 2 ) {\n\n\t\t\t\treturn RGBEToLinear( value );\n\n\t\t\t} else if ( inputEncoding == 3 ) {\n\n\t\t\t\treturn RGBMToLinear( value, 7.0 );\n\n\t\t\t} else if ( inputEncoding == 4 ) {\n\n\t\t\t\treturn RGBMToLinear( value, 16.0 );\n\n\t\t\t} else if ( inputEncoding == 5 ) {\n\n\t\t\t\treturn RGBDToLinear( value, 256.0 );\n\n\t\t\t} else {\n\n\t\t\t\treturn GammaToLinear( value, 2.2 );\n\n\t\t\t}\n\n\t\t}\n\n\t\tvec4 linearToOutputTexel( vec4 value ) {\n\n\t\t\tif ( outputEncoding == 0 ) {\n\n\t\t\t\treturn value;\n\n\t\t\t} else if ( outputEncoding == 1 ) {\n\n\t\t\t\treturn LinearTosRGB( value );\n\n\t\t\t} else if ( outputEncoding == 2 ) {\n\n\t\t\t\treturn LinearToRGBE( value );\n\n\t\t\t} else if ( outputEncoding == 3 ) {\n\n\t\t\t\treturn LinearToRGBM( value, 7.0 );\n\n\t\t\t} else if ( outputEncoding == 4 ) {\n\n\t\t\t\treturn LinearToRGBM( value, 16.0 );\n\n\t\t\t} else if ( outputEncoding == 5 ) {\n\n\t\t\t\treturn LinearToRGBD( value, 256.0 );\n\n\t\t\t} else {\n\n\t\t\t\treturn LinearToGamma( value, 2.2 );\n\n\t\t\t}\n\n\t\t}\n\n\t\tvec4 envMapTexelToLinear( vec4 color ) {\n\n\t\t\treturn inputTexelToLinear( color );\n\n\t\t}\n\t\n\n\t\t\tvoid main() {\n\n\t\t\t\tgl_FragColor = vec4( 0.0, 0.0, 0.0, 1.0 );\n\t\t\t\tgl_FragColor.rgb = envMapTexelToLinear( textureCube( envMap, vec3( - vOutputDirection.x, vOutputDirection.yz ) ) ).rgb;\n\t\t\t\tgl_FragColor = linearToOutputTexel( gl_FragColor );\n\n\t\t\t}\n\t\t",blending:0,depthTest:!1,depthWrite:!1})}function gh(t){console.warn("THREE.ClosedSplineCurve3 has been deprecated. Use THREE.CatmullRomCurve3 instead."),Pc.call(this,t),this.type="catmullrom",this.closed=!0}function yh(t){console.warn("THREE.SplineCurve3 has been deprecated. Use THREE.CatmullRomCurve3 instead."),Pc.call(this,t),this.type="catmullrom"}function xh(t){console.warn("THREE.Spline has been removed. Use THREE.CatmullRomCurve3 instead."),Pc.call(this,t),this.type="catmullrom"}Mc.create=function(t,e){return console.log("THREE.Curve.create() has been deprecated"),t.prototype=Object.create(Mc.prototype),t.prototype.constructor=t,t.prototype.getPoint=e,t},Object.assign(Vc.prototype,{createPointsGeometry:function(t){console.warn("THREE.CurvePath: .createPointsGeometry() has been removed. Use new THREE.Geometry().setFromPoints( points ) instead.");var e=this.getPoints(t);return this.createGeometry(e)},createSpacedPointsGeometry:function(t){console.warn("THREE.CurvePath: .createSpacedPointsGeometry() has been removed. Use new THREE.Geometry().setFromPoints( points ) instead.");var e=this.getSpacedPoints(t);return this.createGeometry(e)},createGeometry:function(t){console.warn("THREE.CurvePath: .createGeometry() has been removed. Use new THREE.Geometry().setFromPoints( points ) instead.");for(var e=new yo,n=0,r=t.length;nt[Math.floor(Math.random()*t.length)];function r(t,e){return null==t&&(t=0),null==e&&(e=1),t+Math.random()*(e-t)}function a(t,e){return null==t&&(t=0),null==e&&(e=1),Math.floor(t+Math.random()*(e-t+1))}const l=t=>document.querySelector(t),h=t=>"number"==typeof t?"#"+("00000"+t.toString(16)).slice(-6):t,c=(t,e=1)=>{const i=h(t),n=/^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(i),o=n?{r:parseInt(n[1],16),g:parseInt(n[2],16),b:parseInt(n[3],16)}:null;return"rgba("+o.r+","+o.g+","+o.b+","+e+")"},u=t=>.299*t.r+.587*t.g+.114*t.b},1:function(t,e,i){"use strict";i.d(e,"a",(function(){return r}));var n=i(0);const o="object"==typeof window;let s=o&&window.THREE||{};o&&!window.VANTA&&(window.VANTA={});const r=o&&window.VANTA||{};r.register=(t,e)=>r[t]=t=>new e(t),r.version="0.5.21";const a=function(){return Array.prototype.unshift.call(arguments,"[VANTA]"),console.error.apply(this,arguments)};r.VantaBase=class{constructor(t={}){if(!o)return!1;r.current=this,this.windowMouseMoveWrapper=this.windowMouseMoveWrapper.bind(this),this.windowTouchWrapper=this.windowTouchWrapper.bind(this),this.windowGyroWrapper=this.windowGyroWrapper.bind(this),this.resize=this.resize.bind(this),this.animationLoop=this.animationLoop.bind(this),this.restart=this.restart.bind(this);const e="function"==typeof this.getDefaultOptions?this.getDefaultOptions():this.defaultOptions;if(this.options=Object(n.c)({mouseControls:!0,touchControls:!0,gyroControls:!1,minHeight:200,minWidth:200,scale:1,scaleMobile:1},e),(t instanceof HTMLElement||"string"==typeof t)&&(t={el:t}),Object(n.c)(this.options,t),this.options.THREE&&(s=this.options.THREE),this.el=this.options.el,null==this.el)a('Instance needs "el" param!');else if(!(this.options.el instanceof HTMLElement)){const t=this.el;if(this.el=Object(n.f)(t),!this.el)return void a("Cannot find element",t)}this.prepareEl(),this.initThree(),this.setSize();try{this.init()}catch(t){return a("Init error",t),this.renderer&&this.renderer.domElement&&this.el.removeChild(this.renderer.domElement),void(this.options.backgroundColor&&(console.log("[VANTA] Falling back to backgroundColor"),this.el.style.background=Object(n.a)(this.options.backgroundColor)))}this.initMouse(),this.resize(),this.animationLoop();const i=window.addEventListener;i("resize",this.resize),window.requestAnimationFrame(this.resize),this.options.mouseControls&&(i("scroll",this.windowMouseMoveWrapper),i("mousemove",this.windowMouseMoveWrapper)),this.options.touchControls&&(i("touchstart",this.windowTouchWrapper),i("touchmove",this.windowTouchWrapper)),this.options.gyroControls&&i("deviceorientation",this.windowGyroWrapper)}setOptions(t={}){Object(n.c)(this.options,t),this.triggerMouseMove()}prepareEl(){let t,e;if("undefined"!=typeof Node&&Node.TEXT_NODE)for(t=0;t=0&&n>=0&&i<=e.width&&n<=e.height&&(this.mouseX=i,this.mouseY=n,this.options.mouseEase||this.triggerMouseMove(i,n))}windowTouchWrapper(t){const e=this.getCanvasRect();if(!e)return!1;if(1===t.touches.length){const i=t.touches[0].clientX-e.left,n=t.touches[0].clientY-e.top;i>=0&&n>=0&&i<=e.width&&n<=e.height&&(this.mouseX=i,this.mouseY=n,this.options.mouseEase||this.triggerMouseMove(i,n))}}windowGyroWrapper(t){const e=this.getCanvasRect();if(!e)return!1;const i=Math.round(2*t.alpha)-e.left,n=Math.round(2*t.beta)-e.top;i>=0&&n>=0&&i<=e.width&&n<=e.height&&(this.mouseX=i,this.mouseY=n,this.options.mouseEase||this.triggerMouseMove(i,n))}triggerMouseMove(t,e){void 0===t&&void 0===e&&(this.options.mouseEase?(t=this.mouseEaseX,e=this.mouseEaseY):(t=this.mouseX,e=this.mouseY)),this.uniforms&&(this.uniforms.iMouse.value.x=t/this.scale,this.uniforms.iMouse.value.y=e/this.scale);const i=t/this.width,n=e/this.height;"function"==typeof this.onMouseMove&&this.onMouseMove(i,n)}setSize(){this.scale||(this.scale=1),Object(n.e)()&&this.options.scaleMobile?this.scale=this.options.scaleMobile:this.options.scale&&(this.scale=this.options.scale),this.width=Math.max(this.el.offsetWidth,this.options.minWidth),this.height=Math.max(this.el.offsetHeight,this.options.minHeight)}initMouse(){(!this.mouseX&&!this.mouseY||this.mouseX===this.options.minWidth/2&&this.mouseY===this.options.minHeight/2)&&(this.mouseX=this.width/2,this.mouseY=this.height/2,this.triggerMouseMove(this.mouseX,this.mouseY))}resize(){this.setSize(),this.camera&&(this.camera.aspect=this.width/this.height,"function"==typeof this.camera.updateProjectionMatrix&&this.camera.updateProjectionMatrix()),this.renderer&&(this.renderer.setSize(this.width,this.height),this.renderer.setPixelRatio(window.devicePixelRatio/this.scale)),"function"==typeof this.onResize&&this.onResize()}isOnScreen(){const t=this.el.offsetHeight,e=this.el.getBoundingClientRect(),i=window.pageYOffset||(document.documentElement||document.body.parentNode||document.body).scrollTop,n=e.top+i;return n-window.innerHeight<=i&&i<=n+t}animationLoop(){return this.t||(this.t=0),this.t+=1,this.t2||(this.t2=0),this.t2+=this.options.speed||1,this.uniforms&&(this.uniforms.iTime.value=.016667*this.t2),this.options.mouseEase&&(this.mouseEaseX=this.mouseEaseX||this.mouseX||0,this.mouseEaseY=this.mouseEaseY||this.mouseY||0,Math.abs(this.mouseEaseX-this.mouseX)+Math.abs(this.mouseEaseY-this.mouseY)>.1&&(this.mouseEaseX+=.05*(this.mouseX-this.mouseEaseX),this.mouseEaseY+=.05*(this.mouseY-this.mouseEaseY),this.triggerMouseMove(this.mouseEaseX,this.mouseEaseY))),(this.isOnScreen()||this.options.forceAnimate)&&("function"==typeof this.onUpdate&&this.onUpdate(),this.scene&&this.camera&&(this.renderer.render(this.scene,this.camera),this.renderer.setClearColor(this.options.backgroundColor,this.options.backgroundAlpha)),this.fps&&this.fps.update&&this.fps.update(),"function"==typeof this.afterRender&&this.afterRender()),this.req=window.requestAnimationFrame(this.animationLoop)}restart(){if(this.scene)for(;this.scene.children.length;)this.scene.remove(this.scene.children[0]);"function"==typeof this.onRestart&&this.onRestart(),this.init()}init(){"function"==typeof this.onInit&&this.onInit()}destroy(){"function"==typeof this.onDestroy&&this.onDestroy();const t=window.removeEventListener;t("touchstart",this.windowTouchWrapper),t("touchmove",this.windowTouchWrapper),t("scroll",this.windowMouseMoveWrapper),t("mousemove",this.windowMouseMoveWrapper),t("deviceorientation",this.windowGyroWrapper),t("resize",this.resize),window.cancelAnimationFrame(this.req),this.renderer&&(this.renderer.domElement&&this.el.removeChild(this.renderer.domElement),this.renderer=null,this.scene=null),r.current===this&&(r.current=null)}},e.b=r.VantaBase},18:function(t,e,i){"use strict";i.r(e);var n=i(1),o=i(0);let s="object"==typeof window&&window.THREE,{Camera:r,ClampToEdgeWrapping:a,DataTexture:l,FloatType:h,Mesh:c,NearestFilter:u,PlaneBufferGeometry:d,RGBAFormat:p,Scene:f,ShaderMaterial:m,WebGLRenderTarget:v}=s||{};var y=function(t,e,i,n){n&&({Camera:r,ClampToEdgeWrapping:a,DataTexture:l,FloatType:h,Mesh:c,NearestFilter:u,PlaneBufferGeometry:d,RGBAFormat:p,Scene:f,ShaderMaterial:m,WebGLRenderTarget:v}=n),this.variables=[],this.currentTextureIndex=0;var o=h,s=new f,y=new r;y.position.z=1;var g={passThruTexture:{value:null}},w=M("uniform sampler2D passThruTexture;\n\nvoid main() {\n\n\tvec2 uv = gl_FragCoord.xy / resolution.xy;\n\n\tgl_FragColor = texture2D( passThruTexture, uv );\n\n}\n",g),b=new c(new d(2,2),w);function x(i){i.defines.resolution="vec2( "+t.toFixed(1)+", "+e.toFixed(1)+" )"}function M(t,e){var i=new m({uniforms:e=e||{},vertexShader:"void main()\t{\n\n\tgl_Position = vec4( position, 1.0 );\n\n}\n",fragmentShader:t});return x(i),i}s.add(b),this.setDataType=function(t){return o=t,this},this.addVariable=function(t,e,i){var n={name:t,initialValueTexture:i,material:this.createShaderMaterial(e),dependencies:null,renderTargets:[],wrapS:null,wrapT:null,minFilter:u,magFilter:u};return this.variables.push(n),n},this.setVariableDependencies=function(t,e){t.dependencies=e},this.init=function(){if(!i.capabilities.isWebGL2&&!i.extensions.get("OES_texture_float"))return"No OES_texture_float support for float textures.";if(0===i.capabilities.maxVertexTextures)return"No support for vertex shader textures.";for(var n=0;n.5&&this.flock(t),this.move()},this.flock=function(t){n&&i.add(this.reach(n,.005)),i.add(this.alignment(t)),i.add(this.cohesion(t)),i.add(this.separation(t))},this.move=function(){this.velocity.add(i);var t=this.velocity.length();t>2.5&&this.velocity.divideScalar(t/2.5),this.position.add(this.velocity),i.set(0,0,0)},this.checkBounds=function(){this.position.x>s&&(this.position.x=-s),this.position.x<-s&&(this.position.x=s),this.position.y>r&&(this.position.y=-r),this.position.y<-r&&(this.position.y=r),this.position.z>a&&(this.position.z=-a),this.position.z<-a&&(this.position.z=a)},this.avoid=function(e){var i=new t.Vector3;return i.copy(this.position),i.sub(e),i.multiplyScalar(1/this.position.distanceToSquared(e)),i},this.repulse=function(e){var n=this.position.distanceTo(e);if(n<150){var o=new t.Vector3;o.subVectors(this.position,e),o.multiplyScalar(.5/n),i.add(o)}},this.reach=function(e,i){var n=new t.Vector3;return n.subVectors(e,this.position),n.multiplyScalar(i),n},this.alignment=function(e){var i,n,o=new t.Vector3,s=0;const r=100*l.alignment/20;for(var a=0,h=e.length;a.6||(n=(i=e[a]).position.distanceTo(this.position))>0&&n<=r&&(o.add(i.velocity),s++);if(s>0){o.divideScalar(s);var c=o.length();c>.1&&o.divideScalar(c/.1)}return o},this.cohesion=function(e){var i,n,o=new t.Vector3,s=new t.Vector3,r=0;const a=100*l.cohesion/20;for(var h=0,c=e.length;h.6||(n=(i=e[h]).position.distanceTo(this.position))>0&&n<=a&&(o.add(i.position),r++);r>0&&o.divideScalar(r),s.subVectors(o,this.position);var u=s.length();return u>.1&&s.divideScalar(u/.1),s},this.separation=function(e){var i,n,o=new t.Vector3,s=new t.Vector3;const r=100*l.separation/20;for(var a=0,h=e.length;a.6||(n=(i=e[a]).position.distanceTo(this.position))>0&&n<=r&&(s.subVectors(this.position,i.position),s.normalize(),s.divideScalar(n),o.add(s));return o}},t.BirdGeometry=function(e){e.quantity&&(b=Math.pow(2,e.quantity),x=b*b);const i=3*x,n=3*i;t.BufferGeometry.call(this);const o=new t.BufferAttribute(new Float32Array(3*n),3),s=new t.BufferAttribute(new Float32Array(3*n),3),r=new t.BufferAttribute(new Float32Array(2*n),2),a=new t.BufferAttribute(new Float32Array(n),1);this.setAttribute||(this.setAttribute=this.addAttribute),this.setAttribute("position",o),this.setAttribute("birdColor",s),this.setAttribute("reference",r),this.setAttribute("birdVertex",a);let l=0;const h=function(){for(let t=0;t{const t=[];for(;i{const t=[];for(;i1&&(t=1),this.last=this.now,w)this.positionUniforms.time.value=this.now,this.positionUniforms.delta.value=t,this.velocityUniforms.time.value=this.now,this.velocityUniforms.delta.value=t,this.birdUniforms.time.value=this.now,this.birdUniforms.delta.value=t,this.velocityUniforms.predator.value.set(this.mouseX,-this.mouseY,0),this.mouseX=1e4,this.mouseY=1e4,this.gpuCompute.compute(),this.birdUniforms.texturePosition.value=this.gpuCompute.getCurrentRenderTarget(this.positionVariable).texture,this.birdUniforms.textureVelocity.value=this.gpuCompute.getCurrentRenderTarget(this.velocityVariable).texture;else{const t=this.birds,n=this.boids;let o,s;for(var e=0,i=t.length;ee[Math.floor(Math.random()*e.length)];function r(e,t){return null==e&&(e=0),null==t&&(t=1),e+Math.random()*(t-e)}function a(e,t){return null==e&&(e=0),null==t&&(t=1),Math.floor(e+Math.random()*(t-e+1))}const c=e=>document.querySelector(e),h=e=>"number"==typeof e?"#"+("00000"+e.toString(16)).slice(-6):e,l=(e,t=1)=>{const n=h(e),i=/^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(n),o=i?{r:parseInt(i[1],16),g:parseInt(i[2],16),b:parseInt(i[3],16)}:null;return"rgba("+o.r+","+o.g+","+o.b+","+t+")"},u=e=>.299*e.r+.587*e.g+.114*e.b},function(e,t,n){"use strict";n.d(t,"a",(function(){return r}));var i=n(0);const o="object"==typeof window;let s=o&&window.THREE||{};o&&!window.VANTA&&(window.VANTA={});const r=o&&window.VANTA||{};r.register=(e,t)=>r[e]=e=>new t(e),r.version="0.5.21";const a=function(){return Array.prototype.unshift.call(arguments,"[VANTA]"),console.error.apply(this,arguments)};r.VantaBase=class{constructor(e={}){if(!o)return!1;r.current=this,this.windowMouseMoveWrapper=this.windowMouseMoveWrapper.bind(this),this.windowTouchWrapper=this.windowTouchWrapper.bind(this),this.windowGyroWrapper=this.windowGyroWrapper.bind(this),this.resize=this.resize.bind(this),this.animationLoop=this.animationLoop.bind(this),this.restart=this.restart.bind(this);const t="function"==typeof this.getDefaultOptions?this.getDefaultOptions():this.defaultOptions;if(this.options=Object(i.c)({mouseControls:!0,touchControls:!0,gyroControls:!1,minHeight:200,minWidth:200,scale:1,scaleMobile:1},t),(e instanceof HTMLElement||"string"==typeof e)&&(e={el:e}),Object(i.c)(this.options,e),this.options.THREE&&(s=this.options.THREE),this.el=this.options.el,null==this.el)a('Instance needs "el" param!');else if(!(this.options.el instanceof HTMLElement)){const e=this.el;if(this.el=Object(i.f)(e),!this.el)return void a("Cannot find element",e)}this.prepareEl(),this.initThree(),this.setSize();try{this.init()}catch(e){return a("Init error",e),this.renderer&&this.renderer.domElement&&this.el.removeChild(this.renderer.domElement),void(this.options.backgroundColor&&(console.log("[VANTA] Falling back to backgroundColor"),this.el.style.background=Object(i.a)(this.options.backgroundColor)))}this.initMouse(),this.resize(),this.animationLoop();const n=window.addEventListener;n("resize",this.resize),window.requestAnimationFrame(this.resize),this.options.mouseControls&&(n("scroll",this.windowMouseMoveWrapper),n("mousemove",this.windowMouseMoveWrapper)),this.options.touchControls&&(n("touchstart",this.windowTouchWrapper),n("touchmove",this.windowTouchWrapper)),this.options.gyroControls&&n("deviceorientation",this.windowGyroWrapper)}setOptions(e={}){Object(i.c)(this.options,e),this.triggerMouseMove()}prepareEl(){let e,t;if("undefined"!=typeof Node&&Node.TEXT_NODE)for(e=0;e=0&&i>=0&&n<=t.width&&i<=t.height&&(this.mouseX=n,this.mouseY=i,this.options.mouseEase||this.triggerMouseMove(n,i))}windowTouchWrapper(e){const t=this.getCanvasRect();if(!t)return!1;if(1===e.touches.length){const n=e.touches[0].clientX-t.left,i=e.touches[0].clientY-t.top;n>=0&&i>=0&&n<=t.width&&i<=t.height&&(this.mouseX=n,this.mouseY=i,this.options.mouseEase||this.triggerMouseMove(n,i))}}windowGyroWrapper(e){const t=this.getCanvasRect();if(!t)return!1;const n=Math.round(2*e.alpha)-t.left,i=Math.round(2*e.beta)-t.top;n>=0&&i>=0&&n<=t.width&&i<=t.height&&(this.mouseX=n,this.mouseY=i,this.options.mouseEase||this.triggerMouseMove(n,i))}triggerMouseMove(e,t){void 0===e&&void 0===t&&(this.options.mouseEase?(e=this.mouseEaseX,t=this.mouseEaseY):(e=this.mouseX,t=this.mouseY)),this.uniforms&&(this.uniforms.iMouse.value.x=e/this.scale,this.uniforms.iMouse.value.y=t/this.scale);const n=e/this.width,i=t/this.height;"function"==typeof this.onMouseMove&&this.onMouseMove(n,i)}setSize(){this.scale||(this.scale=1),Object(i.e)()&&this.options.scaleMobile?this.scale=this.options.scaleMobile:this.options.scale&&(this.scale=this.options.scale),this.width=Math.max(this.el.offsetWidth,this.options.minWidth),this.height=Math.max(this.el.offsetHeight,this.options.minHeight)}initMouse(){(!this.mouseX&&!this.mouseY||this.mouseX===this.options.minWidth/2&&this.mouseY===this.options.minHeight/2)&&(this.mouseX=this.width/2,this.mouseY=this.height/2,this.triggerMouseMove(this.mouseX,this.mouseY))}resize(){this.setSize(),this.camera&&(this.camera.aspect=this.width/this.height,"function"==typeof this.camera.updateProjectionMatrix&&this.camera.updateProjectionMatrix()),this.renderer&&(this.renderer.setSize(this.width,this.height),this.renderer.setPixelRatio(window.devicePixelRatio/this.scale)),"function"==typeof this.onResize&&this.onResize()}isOnScreen(){const e=this.el.offsetHeight,t=this.el.getBoundingClientRect(),n=window.pageYOffset||(document.documentElement||document.body.parentNode||document.body).scrollTop,i=t.top+n;return i-window.innerHeight<=n&&n<=i+e}animationLoop(){return this.t||(this.t=0),this.t+=1,this.t2||(this.t2=0),this.t2+=this.options.speed||1,this.uniforms&&(this.uniforms.iTime.value=.016667*this.t2),this.options.mouseEase&&(this.mouseEaseX=this.mouseEaseX||this.mouseX||0,this.mouseEaseY=this.mouseEaseY||this.mouseY||0,Math.abs(this.mouseEaseX-this.mouseX)+Math.abs(this.mouseEaseY-this.mouseY)>.1&&(this.mouseEaseX+=.05*(this.mouseX-this.mouseEaseX),this.mouseEaseY+=.05*(this.mouseY-this.mouseEaseY),this.triggerMouseMove(this.mouseEaseX,this.mouseEaseY))),(this.isOnScreen()||this.options.forceAnimate)&&("function"==typeof this.onUpdate&&this.onUpdate(),this.scene&&this.camera&&(this.renderer.render(this.scene,this.camera),this.renderer.setClearColor(this.options.backgroundColor,this.options.backgroundAlpha)),this.fps&&this.fps.update&&this.fps.update(),"function"==typeof this.afterRender&&this.afterRender()),this.req=window.requestAnimationFrame(this.animationLoop)}restart(){if(this.scene)for(;this.scene.children.length;)this.scene.remove(this.scene.children[0]);"function"==typeof this.onRestart&&this.onRestart(),this.init()}init(){"function"==typeof this.onInit&&this.onInit()}destroy(){"function"==typeof this.onDestroy&&this.onDestroy();const e=window.removeEventListener;e("touchstart",this.windowTouchWrapper),e("touchmove",this.windowTouchWrapper),e("scroll",this.windowMouseMoveWrapper),e("mousemove",this.windowMouseMoveWrapper),e("deviceorientation",this.windowGyroWrapper),e("resize",this.resize),window.cancelAnimationFrame(this.req),this.renderer&&(this.renderer.domElement&&this.el.removeChild(this.renderer.domElement),this.renderer=null,this.scene=null),r.current===this&&(r.current=null)}},t.b=r.VantaBase},function(e,t,n){"use strict";n.d(t,"b",(function(){return r}));var i=n(1),o=n(0);n.d(t,"a",(function(){return i.a}));let s="object"==typeof window&&window.THREE;class r extends i.b{constructor(e){(s=e.THREE||s).Color.prototype.toVector=function(){return new s.Vector3(this.r,this.g,this.b)},super(e),this.updateUniforms=this.updateUniforms.bind(this)}init(){this.mode="shader",this.uniforms={iTime:{type:"f",value:1},iResolution:{type:"v2",value:new s.Vector2(1,1)},iDpr:{type:"f",value:window.devicePixelRatio||1},iMouse:{type:"v2",value:new s.Vector2(this.mouseX||0,this.mouseY||0)}},super.init(),this.fragmentShader&&this.initBasicShader()}setOptions(e){super.setOptions(e),this.updateUniforms()}initBasicShader(e=this.fragmentShader,t=this.vertexShader){t||(t="uniform float uTime;\nuniform vec2 uResolution;\nvoid main() {\n gl_Position = vec4( position, 1.0 );\n}"),this.updateUniforms(),"function"==typeof this.valuesChanger&&this.valuesChanger();const n=new s.ShaderMaterial({uniforms:this.uniforms,vertexShader:t,fragmentShader:e}),i=this.options.texturePath;i&&(this.uniforms.iTex={type:"t",value:(new s.TextureLoader).load(i)});const o=new s.Mesh(new s.PlaneGeometry(2,2),n);this.scene.add(o),this.camera=new s.Camera,this.camera.position.z=1}updateUniforms(){const e={};let t,n;for(t in this.options)n=this.options[t],-1!==t.toLowerCase().indexOf("color")?e[t]={type:"v3",value:new s.Color(n).toVector()}:"number"==typeof n&&(e[t]={type:"f",value:n});return Object(o.c)(this.uniforms,e)}resize(){super.resize(),this.uniforms.iResolution.value.x=this.width/this.scale,this.uniforms.iResolution.value.y=this.height/this.scale}}},,,,,,,,,function(e,t,n){"use strict";n.r(t);var i=n(2);let o="object"==typeof window&&window.THREE;class s extends i.b{getDefaultOptions(){return{baseColor:6745,color2:15918901,backgroundColor:1251907,amplitudeFactor:1,ringFactor:1,rotationFactor:1,xOffset:0,yOffset:0,size:1,speed:1,mouseEase:!0,scaleMobile:1,scale:1}}onInit(){const e={minFilter:o.LinearFilter,magFilter:o.LinearFilter,format:o.RGBFormat},t=this.width*window.devicePixelRatio/this.scale,n=this.height*window.devicePixelRatio/this.scale;this.bufferTarget=new o.WebGLRenderTarget(t,n,e),this.bufferFeedback=new o.WebGLRenderTarget(t,n,e)}initBasicShader(e,t){super.initBasicShader(e,t),this.uniforms.iBuffer={type:"t",value:this.bufferTarget.texture}}onUpdate(){this.uniforms.iBuffer.value=this.bufferFeedback.texture;const e=this.renderer;e.setRenderTarget(this.bufferTarget),e.render(this.scene,this.camera),e.setRenderTarget(null),e.clear();let t=this.bufferTarget;this.bufferTarget=this.bufferFeedback,this.bufferFeedback=t}onResize(){if(this.bufferTarget){const e=this.width*window.devicePixelRatio/this.scale,t=this.height*window.devicePixelRatio/this.scale;this.bufferTarget.setSize(e,t),this.bufferFeedback.setSize(e,t)}}onDestroy(){this.bufferTarget=null,this.bufferFeedback=null}}t.default=i.a.register("HALO",s),s.prototype.fragmentShader="uniform vec2 iResolution;\nuniform float iDpr;\nuniform vec2 iMouse;\nuniform float iTime;\n\nuniform float xOffset;\nuniform float yOffset;\nuniform vec3 baseColor;\nuniform vec3 color2;\nuniform vec3 backgroundColor;\nuniform float size;\nuniform float shape;\nuniform float ringFactor;\nuniform float rotationFactor;\nuniform float amplitudeFactor;\n\nuniform sampler2D iBuffer;\nuniform sampler2D iTex;\nconst float PI = 3.14159265359;\n\n// float length2(vec2 p) { return dot(p, p); }\n\n// float noise(vec2 p){\n// return fract(sin(fract(sin(p.x) * (43.13311)) + p.y) * 31.0011);\n// }\n\n// float worley(vec2 p) {\n// float d = 1e30;\n// for (int xo = -1; xo <= 1; ++xo) {\n// for (int yo = -1; yo <= 1; ++yo) {\n// vec2 tp = floor(p) + vec2(xo, yo);\n// d = min(d, length2(p - tp - vec2(noise(tp))));\n// }\n// }\n// vec2 uv = gl_FragCoord.xy / iResolution.xy;\n// float timeOffset = 0.15 * sin(iTime * 2.0 + 10.0*(uv.x - uv.y));\n// return 3.0*exp(-4.0*abs(2.0*d - 1.0 + timeOffset));\n// }\n\n// float fworley(vec2 p) {\n// return sqrt(\n// 1.1 * // light\n// worley(p*10. + .3 + iTime*.0525) *\n// sqrt(worley(p * 50. / size + 0.1 + iTime * -0.75)) *\n// 4.1 *\n// sqrt(sqrt(worley(p * -1. + 9.3))));\n// }\n\nvec4 j2hue(float c) {\n return .5+.5*cos(6.28*c+vec4(0,-2.1,2.1,0));\n}\n\nvec3 permute(vec3 x) { return mod(((x*34.0)+1.0)*x, 289.0); }\n\nfloat snoise(vec2 v){\n const vec4 C = vec4(0.211324865405187, 0.366025403784439,\n -0.577350269189626, 0.024390243902439);\n vec2 i = floor(v + dot(v, C.yy) );\n vec2 x0 = v - i + dot(i, C.xx);\n vec2 i1;\n i1 = (x0.x > x0.y) ? vec2(1.0, 0.0) : vec2(0.0, 1.0);\n vec4 x12 = x0.xyxy + C.xxzz;\n x12.xy -= i1;\n i = mod(i, 289.0);\n vec3 p = permute( permute( i.y + vec3(0.0, i1.y, 1.0 ))\n + i.x + vec3(0.0, i1.x, 1.0 ));\n vec3 m = max(0.5 - vec3(dot(x0,x0), dot(x12.xy,x12.xy),\n dot(x12.zw,x12.zw)), 0.0);\n m = m*m ;\n m = m*m ;\n vec3 x = 2.0 * fract(p * C.www) - 1.0;\n vec3 h = abs(x) - 0.5;\n vec3 ox = floor(x + 0.5);\n vec3 a0 = x - ox;\n m *= 1.79284291400159 - 0.85373472095314 * ( a0*a0 + h*h );\n vec3 g;\n g.x = a0.x * x0.x + h.x * x0.y;\n g.yz = a0.yz * x12.xz + h.yz * x12.yw;\n return 130.0 * dot(m, g);\n}\n\nvec2 sincos( float x ){return vec2(sin(x), cos(x));}\nvec2 rotate2d(vec2 uv, float phi){vec2 t = sincos(phi); return vec2(uv.x*t.y-uv.y*t.x, uv.x*t.x+uv.y*t.y);}\nvec3 rotate3d(vec3 p, vec3 v, float phi){ v = normalize(v); vec2 t = sincos(-phi); float s = t.x, c = t.y, x =-v.x, y =-v.y, z =-v.z; mat4 M = mat4(x*x*(1.-c)+c,x*y*(1.-c)-z*s,x*z*(1.-c)+y*s,0.,y*x*(1.-c)+z*s,y*y*(1.-c)+c,y*z*(1.-c)-x*s,0.,z*x*(1.-c)-y*s,z*y*(1.-c)+x*s,z*z*(1.-c)+c,0.,0.,0.,0.,1.);return (vec4(p,1.)*M).xyz;}\n\n// Classic Perlin 3D Noise\n// by Stefan Gustavson\nvec4 permute(vec4 x){return mod(((x*34.0)+1.0)*x, 289.0);}\nvec4 taylorInvSqrt(vec4 r){return 1.79284291400159 - 0.85373472095314 * r;}\nvec3 fade(vec3 t) {return t*t*t*(t*(t*6.0-15.0)+10.0);}\nfloat p3d(vec3 P){\n vec3 Pi0 = floor(P); // Integer part for indexing\n vec3 Pi1 = Pi0 + vec3(1.0); // Integer part + 1\n Pi0 = mod(Pi0, 289.0);\n Pi1 = mod(Pi1, 289.0);\n vec3 Pf0 = fract(P); // Fractional part for interpolation\n vec3 Pf1 = Pf0 - vec3(1.0); // Fractional part - 1.0\n vec4 ix = vec4(Pi0.x, Pi1.x, Pi0.x, Pi1.x);\n vec4 iy = vec4(Pi0.yy, Pi1.yy);\n vec4 iz0 = Pi0.zzzz;\n vec4 iz1 = Pi1.zzzz;\n\n vec4 ixy = permute(permute(ix) + iy);\n vec4 ixy0 = permute(ixy + iz0);\n vec4 ixy1 = permute(ixy + iz1);\n\n vec4 gx0 = ixy0 / 7.0;\n vec4 gy0 = fract(floor(gx0) / 7.0) - 0.5;\n gx0 = fract(gx0);\n vec4 gz0 = vec4(0.5) - abs(gx0) - abs(gy0);\n vec4 sz0 = step(gz0, vec4(0.0));\n gx0 -= sz0 * (step(0.0, gx0) - 0.5);\n gy0 -= sz0 * (step(0.0, gy0) - 0.5);\n\n vec4 gx1 = ixy1 / 7.0;\n vec4 gy1 = fract(floor(gx1) / 7.0) - 0.5;\n gx1 = fract(gx1);\n vec4 gz1 = vec4(0.5) - abs(gx1) - abs(gy1);\n vec4 sz1 = step(gz1, vec4(0.0));\n gx1 -= sz1 * (step(0.0, gx1) - 0.5);\n gy1 -= sz1 * (step(0.0, gy1) - 0.5);\n\n vec3 g000 = vec3(gx0.x,gy0.x,gz0.x);\n vec3 g100 = vec3(gx0.y,gy0.y,gz0.y);\n vec3 g010 = vec3(gx0.z,gy0.z,gz0.z);\n vec3 g110 = vec3(gx0.w,gy0.w,gz0.w);\n vec3 g001 = vec3(gx1.x,gy1.x,gz1.x);\n vec3 g101 = vec3(gx1.y,gy1.y,gz1.y);\n vec3 g011 = vec3(gx1.z,gy1.z,gz1.z);\n vec3 g111 = vec3(gx1.w,gy1.w,gz1.w);\n\n vec4 norm0 = taylorInvSqrt(vec4(dot(g000, g000), dot(g010, g010), dot(g100, g100), dot(g110, g110)));\n g000 *= norm0.x;\n g010 *= norm0.y;\n g100 *= norm0.z;\n g110 *= norm0.w;\n vec4 norm1 = taylorInvSqrt(vec4(dot(g001, g001), dot(g011, g011), dot(g101, g101), dot(g111, g111)));\n g001 *= norm1.x;\n g011 *= norm1.y;\n g101 *= norm1.z;\n g111 *= norm1.w;\n\n float n000 = dot(g000, Pf0);\n float n100 = dot(g100, vec3(Pf1.x, Pf0.yz));\n float n010 = dot(g010, vec3(Pf0.x, Pf1.y, Pf0.z));\n float n110 = dot(g110, vec3(Pf1.xy, Pf0.z));\n float n001 = dot(g001, vec3(Pf0.xy, Pf1.z));\n float n101 = dot(g101, vec3(Pf1.x, Pf0.y, Pf1.z));\n float n011 = dot(g011, vec3(Pf0.x, Pf1.yz));\n float n111 = dot(g111, Pf1);\n\n vec3 fade_xyz = fade(Pf0);\n vec4 n_z = mix(vec4(n000, n100, n010, n110), vec4(n001, n101, n011, n111), fade_xyz.z);\n vec2 n_yz = mix(n_z.xy, n_z.zw, fade_xyz.y);\n float n_xyz = mix(n_yz.x, n_yz.y, fade_xyz.x);\n return 2.2 * n_xyz;\n}\n\n\nvoid main() {\n vec2 res2 = iResolution.xy * iDpr;\n vec2 pixel = vec2(gl_FragCoord.xy - 0.5 * res2) / res2.y; // center-origin pixel coord\n pixel.x -= xOffset * res2.x / res2.y;\n pixel.y -= yOffset;\n\n vec2 uv = gl_FragCoord.xy / res2; // 0 to 1\n\n // float nn1 = snoise(uv * 0.25 + iTime * 0.005 + mixedColor.b * 0.01) * 0.1;\n // float nn2 = snoise(uv * 0.25 + iTime * 0.005 + mixedColor.b * 0.01 + 1000.) * 0.1;\n // uv += vec2(nn1, nn2);\n\n // PERLIN DISTORTION\n // float noiseScale = 10.;\n // float timeScale = 0.5;\n // uv += vec2( p3d(vec3(uv * noiseScale, iTime * timeScale)), p3d(vec3(1000. + uv * noiseScale , iTime * timeScale)) ) * 0.001;\n\n // uv = rotate2d(uv, 0.001);\n // pixel = rotate2d(pixel, 0.001);\n\n vec2 mouse2 = (iMouse * iDpr / res2 - 0.5) * vec2(1.,-1.);\n vec2 uvBig = (uv - 0.5) * 0.996 + 0.5;\n\n vec4 oldImage = texture2D(iBuffer, uv);\n vec3 mixedColor = oldImage.rgb - backgroundColor;\n\n // float spinDist = 0.002 + 0.002 * sin(iTime * 0.4);\n float cropDist = 0.01;\n float cropXOffset = 0.2;\n float cropYOffset = 0.2;\n // float cropXOffset = 0.4 + 0.1 * sin(iTime * 0.4);\n // float cropYOffset = 0.4 + 0.1 * cos(iTime * 0.6);\n\n vec2 offset = uv + vec2((mixedColor.g - cropXOffset) * cropDist, (mixedColor.r - cropYOffset) * cropDist);\n\n // float nn = snoise(uv * 10.) * 0.001;\n // offset += nn;\n\n float spinDist = 0.001;\n float spinSpeed = 0.2 + 0.15 * cos(iTime * 0.5);\n float timeFrac = mod(iTime, 6.5);\n vec2 offset2 = uvBig + vec2(cos(timeFrac * spinSpeed) * spinDist, sin(timeFrac * spinSpeed) * spinDist);\n\n mixedColor = texture2D(iBuffer, offset).rgb * 0.4\n + texture2D(iBuffer, offset2).rgb * 0.6\n - backgroundColor;\n\n\n // mixedColor *= .875;\n float fadeAmt = 0.0015; // fade this amount each frame // 0.002\n mixedColor = (mixedColor - fadeAmt) * .995;\n\n // float nn = snoise(uvBig * 10.) * 20.;\n // mixedColor *= clamp(nn, 0.98, 1.0);\n\n vec4 spectrum = abs( abs( .95*atan(uv.x, uv.y) -vec4(0,2,4,0) ) -3. )-1.;\n float angle = atan(pixel.x, pixel.y);\n float dist = length(pixel - mouse2*0.15) * 8. + sin(iTime) * .01;\n\n // mixedColor *= pow(1.-dist*0.002, 2.);\n\n\n // Flowery shapes\n // float edge = abs(dist * 0.5);\n float flowerPeaks = .05 * amplitudeFactor * size;\n float flowerPetals = 7.;\n float edge = abs((dist + sin(angle * flowerPetals + iTime * 0.5) * sin(iTime * 1.5) * flowerPeaks) * 0.65 / size);\n // float edge = abs((dist + sin(angle * 4. + iTime * 2.) * sin(iTime * 3.) * 0.75) * 1.);\n\n // vec4 rainbow = abs( abs( .95*mod(iTime * 1., 2. * PI) - vec4(0,2,4,0) ) -3. )-1.;\n // vec4 rainbow = vec4(0,2,4,0);\n\n float colorChangeSpeed = 0.75 + 0.05 * sin(iTime) * 1.5;\n float rainbowInput = timeFrac * colorChangeSpeed;\n // NOISE!\n // float nn = snoise(uv * 0.25 + iTime * 0.005 + mixedColor.b * 0.01) * 20.;\n // rainbowInput += nn;\n\n float brightness = 0.7;\n vec4 rainbow = sqrt(j2hue(cos(rainbowInput))) + vec4(baseColor,0) - 1.0 + brightness;\n float factor = smoothstep(1., .9, edge) * pow(edge, 2.);\n vec3 color = rainbow.rgb * smoothstep(1., .9, edge) * pow(edge, 20.);\n vec4 ring = vec4(\n backgroundColor + clamp( mixedColor + color, 0., 1.)\n , 1.0);\n\n // float t = fworley(uv * u_resolution.xy / 1500.0);\n // t *= exp(-length2(abs(0.7*uv - 1.0)));\n // float tExp = pow(t, 2. - t);\n // vec3 c1 = color1 * (1.0 - t);\n // vec3 c2 = color2 * tExp;\n // vec4 cells = vec4(mixedColor * 0.25, 1.) + vec4(pow(t, 1.0 - t) * (c1 + c2), 1.0);\n // gl_FragColor = clamp(ring + cells * 0.5, 0.0, 1.0);\n\n // float nn = snoise(uv * 10.) * 0.01; // creepy!\n gl_FragColor = ring;\n}\n"}])})); \ No newline at end of file diff --git a/assets/js/vanta.net.min.js b/assets/js/vanta.net.min.js new file mode 100644 index 000000000..d50bdc9e3 --- /dev/null +++ b/assets/js/vanta.net.min.js @@ -0,0 +1 @@ +!function(t,e){"object"==typeof exports&&"object"==typeof module?module.exports=e():"function"==typeof define&&define.amd?define([],e):"object"==typeof exports?exports._vantaEffect=e():t._vantaEffect=e()}("undefined"!=typeof self?self:this,(function(){return function(t){var e={};function i(s){if(e[s])return e[s].exports;var o=e[s]={i:s,l:!1,exports:{}};return t[s].call(o.exports,o,o.exports,i),o.l=!0,o.exports}return i.m=t,i.c=e,i.d=function(t,e,s){i.o(t,e)||Object.defineProperty(t,e,{enumerable:!0,get:s})},i.r=function(t){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(t,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(t,"__esModule",{value:!0})},i.t=function(t,e){if(1&e&&(t=i(t)),8&e)return t;if(4&e&&"object"==typeof t&&t&&t.__esModule)return t;var s=Object.create(null);if(i.r(s),Object.defineProperty(s,"default",{enumerable:!0,value:t}),2&e&&"string"!=typeof t)for(var o in t)i.d(s,o,function(e){return t[e]}.bind(null,o));return s},i.n=function(t){var e=t&&t.__esModule?function(){return t.default}:function(){return t};return i.d(e,"a",e),e},i.o=function(t,e){return Object.prototype.hasOwnProperty.call(t,e)},i.p="",i(i.s=12)}({0:function(t,e,i){"use strict";function s(t,e){for(let i in e)e.hasOwnProperty(i)&&(t[i]=e[i]);return t}function o(){return"undefined"!=typeof navigator?/Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(navigator.userAgent)||window.innerWidth<600:null}i.d(e,"c",(function(){return s})),i.d(e,"e",(function(){return o})),i.d(e,"i",(function(){return n})),i.d(e,"h",(function(){return r})),i.d(e,"g",(function(){return h})),i.d(e,"f",(function(){return a})),i.d(e,"a",(function(){return c})),i.d(e,"b",(function(){return l})),i.d(e,"d",(function(){return u})),Number.prototype.clamp=function(t,e){return Math.min(Math.max(this,t),e)};const n=t=>t[Math.floor(Math.random()*t.length)];function r(t,e){return null==t&&(t=0),null==e&&(e=1),t+Math.random()*(e-t)}function h(t,e){return null==t&&(t=0),null==e&&(e=1),Math.floor(t+Math.random()*(e-t+1))}const a=t=>document.querySelector(t),c=t=>"number"==typeof t?"#"+("00000"+t.toString(16)).slice(-6):t,l=(t,e=1)=>{const i=c(t),s=/^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(i),o=s?{r:parseInt(s[1],16),g:parseInt(s[2],16),b:parseInt(s[3],16)}:null;return"rgba("+o.r+","+o.g+","+o.b+","+e+")"},u=t=>.299*t.r+.587*t.g+.114*t.b},1:function(t,e,i){"use strict";i.d(e,"a",(function(){return r}));var s=i(0);const o="object"==typeof window;let n=o&&window.THREE||{};o&&!window.VANTA&&(window.VANTA={});const r=o&&window.VANTA||{};r.register=(t,e)=>r[t]=t=>new e(t),r.version="0.5.21";const h=function(){return Array.prototype.unshift.call(arguments,"[VANTA]"),console.error.apply(this,arguments)};r.VantaBase=class{constructor(t={}){if(!o)return!1;r.current=this,this.windowMouseMoveWrapper=this.windowMouseMoveWrapper.bind(this),this.windowTouchWrapper=this.windowTouchWrapper.bind(this),this.windowGyroWrapper=this.windowGyroWrapper.bind(this),this.resize=this.resize.bind(this),this.animationLoop=this.animationLoop.bind(this),this.restart=this.restart.bind(this);const e="function"==typeof this.getDefaultOptions?this.getDefaultOptions():this.defaultOptions;if(this.options=Object(s.c)({mouseControls:!0,touchControls:!0,gyroControls:!1,minHeight:200,minWidth:200,scale:1,scaleMobile:1},e),(t instanceof HTMLElement||"string"==typeof t)&&(t={el:t}),Object(s.c)(this.options,t),this.options.THREE&&(n=this.options.THREE),this.el=this.options.el,null==this.el)h('Instance needs "el" param!');else if(!(this.options.el instanceof HTMLElement)){const t=this.el;if(this.el=Object(s.f)(t),!this.el)return void h("Cannot find element",t)}this.prepareEl(),this.initThree(),this.setSize();try{this.init()}catch(t){return h("Init error",t),this.renderer&&this.renderer.domElement&&this.el.removeChild(this.renderer.domElement),void(this.options.backgroundColor&&(console.log("[VANTA] Falling back to backgroundColor"),this.el.style.background=Object(s.a)(this.options.backgroundColor)))}this.initMouse(),this.resize(),this.animationLoop();const i=window.addEventListener;i("resize",this.resize),window.requestAnimationFrame(this.resize),this.options.mouseControls&&(i("scroll",this.windowMouseMoveWrapper),i("mousemove",this.windowMouseMoveWrapper)),this.options.touchControls&&(i("touchstart",this.windowTouchWrapper),i("touchmove",this.windowTouchWrapper)),this.options.gyroControls&&i("deviceorientation",this.windowGyroWrapper)}setOptions(t={}){Object(s.c)(this.options,t),this.triggerMouseMove()}prepareEl(){let t,e;if("undefined"!=typeof Node&&Node.TEXT_NODE)for(t=0;t=0&&s>=0&&i<=e.width&&s<=e.height&&(this.mouseX=i,this.mouseY=s,this.options.mouseEase||this.triggerMouseMove(i,s))}windowTouchWrapper(t){const e=this.getCanvasRect();if(!e)return!1;if(1===t.touches.length){const i=t.touches[0].clientX-e.left,s=t.touches[0].clientY-e.top;i>=0&&s>=0&&i<=e.width&&s<=e.height&&(this.mouseX=i,this.mouseY=s,this.options.mouseEase||this.triggerMouseMove(i,s))}}windowGyroWrapper(t){const e=this.getCanvasRect();if(!e)return!1;const i=Math.round(2*t.alpha)-e.left,s=Math.round(2*t.beta)-e.top;i>=0&&s>=0&&i<=e.width&&s<=e.height&&(this.mouseX=i,this.mouseY=s,this.options.mouseEase||this.triggerMouseMove(i,s))}triggerMouseMove(t,e){void 0===t&&void 0===e&&(this.options.mouseEase?(t=this.mouseEaseX,e=this.mouseEaseY):(t=this.mouseX,e=this.mouseY)),this.uniforms&&(this.uniforms.iMouse.value.x=t/this.scale,this.uniforms.iMouse.value.y=e/this.scale);const i=t/this.width,s=e/this.height;"function"==typeof this.onMouseMove&&this.onMouseMove(i,s)}setSize(){this.scale||(this.scale=1),Object(s.e)()&&this.options.scaleMobile?this.scale=this.options.scaleMobile:this.options.scale&&(this.scale=this.options.scale),this.width=Math.max(this.el.offsetWidth,this.options.minWidth),this.height=Math.max(this.el.offsetHeight,this.options.minHeight)}initMouse(){(!this.mouseX&&!this.mouseY||this.mouseX===this.options.minWidth/2&&this.mouseY===this.options.minHeight/2)&&(this.mouseX=this.width/2,this.mouseY=this.height/2,this.triggerMouseMove(this.mouseX,this.mouseY))}resize(){this.setSize(),this.camera&&(this.camera.aspect=this.width/this.height,"function"==typeof this.camera.updateProjectionMatrix&&this.camera.updateProjectionMatrix()),this.renderer&&(this.renderer.setSize(this.width,this.height),this.renderer.setPixelRatio(window.devicePixelRatio/this.scale)),"function"==typeof this.onResize&&this.onResize()}isOnScreen(){const t=this.el.offsetHeight,e=this.el.getBoundingClientRect(),i=window.pageYOffset||(document.documentElement||document.body.parentNode||document.body).scrollTop,s=e.top+i;return s-window.innerHeight<=i&&i<=s+t}animationLoop(){return this.t||(this.t=0),this.t+=1,this.t2||(this.t2=0),this.t2+=this.options.speed||1,this.uniforms&&(this.uniforms.iTime.value=.016667*this.t2),this.options.mouseEase&&(this.mouseEaseX=this.mouseEaseX||this.mouseX||0,this.mouseEaseY=this.mouseEaseY||this.mouseY||0,Math.abs(this.mouseEaseX-this.mouseX)+Math.abs(this.mouseEaseY-this.mouseY)>.1&&(this.mouseEaseX+=.05*(this.mouseX-this.mouseEaseX),this.mouseEaseY+=.05*(this.mouseY-this.mouseEaseY),this.triggerMouseMove(this.mouseEaseX,this.mouseEaseY))),(this.isOnScreen()||this.options.forceAnimate)&&("function"==typeof this.onUpdate&&this.onUpdate(),this.scene&&this.camera&&(this.renderer.render(this.scene,this.camera),this.renderer.setClearColor(this.options.backgroundColor,this.options.backgroundAlpha)),this.fps&&this.fps.update&&this.fps.update(),"function"==typeof this.afterRender&&this.afterRender()),this.req=window.requestAnimationFrame(this.animationLoop)}restart(){if(this.scene)for(;this.scene.children.length;)this.scene.remove(this.scene.children[0]);"function"==typeof this.onRestart&&this.onRestart(),this.init()}init(){"function"==typeof this.onInit&&this.onInit()}destroy(){"function"==typeof this.onDestroy&&this.onDestroy();const t=window.removeEventListener;t("touchstart",this.windowTouchWrapper),t("touchmove",this.windowTouchWrapper),t("scroll",this.windowMouseMoveWrapper),t("mousemove",this.windowMouseMoveWrapper),t("deviceorientation",this.windowGyroWrapper),t("resize",this.resize),window.cancelAnimationFrame(this.req),this.renderer&&(this.renderer.domElement&&this.el.removeChild(this.renderer.domElement),this.renderer=null,this.scene=null),r.current===this&&(r.current=null)}},e.b=r.VantaBase},12:function(t,e,i){"use strict";i.r(e);var s=i(1),o=i(0);let n="object"==typeof window&&window.THREE;class r extends s.b{static initClass(){this.prototype.defaultOptions={color:16727937,backgroundColor:2299196,points:10,maxDistance:20,spacing:15,showDots:!0}}constructor(t){n=t.THREE||n,super(t)}genPoint(t,e,i){let s;if(this.points||(this.points=[]),this.options.showDots){const t=new n.SphereGeometry(.25,12,12),e=new n.MeshLambertMaterial({color:this.options.color});s=new n.Mesh(t,e)}else s=new n.Object3D;return this.cont.add(s),s.ox=t,s.oy=e,s.oz=i,s.position.set(t,e,i),s.r=Object(o.h)(-2,2),this.points.push(s)}onInit(){this.cont=new n.Group,this.cont.position.set(0,0,0),this.scene.add(this.cont);let t=this.options.points,{spacing:e}=this.options;Object(o.e)()&&(t=~~(.75*t),e=~~(.65*e));const i=t*t*2;this.linePositions=new Float32Array(i*i*3),this.lineColors=new Float32Array(i*i*3);const s=Object(o.d)(new n.Color(this.options.color)),r=Object(o.d)(new n.Color(this.options.backgroundColor));this.blending=s>r?"additive":"subtractive";const h=new n.BufferGeometry;h.addAttribute("position",new n.BufferAttribute(this.linePositions,3).setDynamic(!0)),h.addAttribute("color",new n.BufferAttribute(this.lineColors,3).setDynamic(!0)),h.computeBoundingSphere(),h.setDrawRange(0,0);const a=new n.LineBasicMaterial({vertexColors:n.VertexColors,blending:"additive"===this.blending?n.AdditiveBlending:null,transparent:!0});this.linesMesh=new n.LineSegments(h,a),this.cont.add(this.linesMesh);for(let i=0;i<=t;i++)for(let s=0;s<=t;s++){const n=Object(o.g)(-3,3),r=(i-t/2)*e+Object(o.g)(-5,5);let h=(s-t/2)*e+Object(o.g)(-5,5);i%2&&(h+=.5*e),this.genPoint(r,n-Object(o.g)(5,15),h),this.genPoint(r+Object(o.g)(-5,5),n+Object(o.g)(5,15),h+Object(o.g)(-5,5))}this.camera=new n.PerspectiveCamera(25,this.width/this.height,.01,1e4),this.camera.position.set(50,100,150),this.scene.add(this.camera);const c=new n.AmbientLight(16777215,.75);return this.scene.add(c),this.spot=new n.SpotLight(16777215,1),this.spot.position.set(0,200,0),this.spot.distance=400,this.spot.target=this.cont,this.scene.add(this.spot)}onUpdate(){let t;null!=this.helper&&this.helper.update(),null!=this.controls&&this.controls.update();const e=this.camera;Math.abs(e.tx-e.position.x)>.01&&(t=e.tx-e.position.x,e.position.x+=.02*t),Math.abs(e.ty-e.position.y)>.01&&(t=e.ty-e.position.y,e.position.y+=.02*t),e.lookAt(new n.Vector3(0,0,0));let i=0,s=0,o=0;const r=new n.Color(this.options.backgroundColor),h=new n.Color(this.options.color),a=h.clone().sub(r);this.rayCaster&&this.rayCaster.setFromCamera(new n.Vector2(this.rcMouseX,this.rcMouseY),this.camera);for(let t=0;tt[Math.floor(Math.random()*t.length)];function r(t,e){return null==t&&(t=0),null==e&&(e=1),t+Math.random()*(e-t)}function h(t,e){return null==t&&(t=0),null==e&&(e=1),Math.floor(t+Math.random()*(e-t+1))}const a=t=>document.querySelector(t),c=t=>"number"==typeof t?"#"+("00000"+t.toString(16)).slice(-6):t,u=(t,e=1)=>{const i=c(t),s=/^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(i),o=s?{r:parseInt(s[1],16),g:parseInt(s[2],16),b:parseInt(s[3],16)}:null;return"rgba("+o.r+","+o.g+","+o.b+","+e+")"},l=t=>.299*t.r+.587*t.g+.114*t.b},1:function(t,e,i){"use strict";i.d(e,"a",(function(){return r}));var s=i(0);const o="object"==typeof window;let n=o&&window.THREE||{};o&&!window.VANTA&&(window.VANTA={});const r=o&&window.VANTA||{};r.register=(t,e)=>r[t]=t=>new e(t),r.version="0.5.21";const h=function(){return Array.prototype.unshift.call(arguments,"[VANTA]"),console.error.apply(this,arguments)};r.VantaBase=class{constructor(t={}){if(!o)return!1;r.current=this,this.windowMouseMoveWrapper=this.windowMouseMoveWrapper.bind(this),this.windowTouchWrapper=this.windowTouchWrapper.bind(this),this.windowGyroWrapper=this.windowGyroWrapper.bind(this),this.resize=this.resize.bind(this),this.animationLoop=this.animationLoop.bind(this),this.restart=this.restart.bind(this);const e="function"==typeof this.getDefaultOptions?this.getDefaultOptions():this.defaultOptions;if(this.options=Object(s.c)({mouseControls:!0,touchControls:!0,gyroControls:!1,minHeight:200,minWidth:200,scale:1,scaleMobile:1},e),(t instanceof HTMLElement||"string"==typeof t)&&(t={el:t}),Object(s.c)(this.options,t),this.options.THREE&&(n=this.options.THREE),this.el=this.options.el,null==this.el)h('Instance needs "el" param!');else if(!(this.options.el instanceof HTMLElement)){const t=this.el;if(this.el=Object(s.f)(t),!this.el)return void h("Cannot find element",t)}this.prepareEl(),this.initThree(),this.setSize();try{this.init()}catch(t){return h("Init error",t),this.renderer&&this.renderer.domElement&&this.el.removeChild(this.renderer.domElement),void(this.options.backgroundColor&&(console.log("[VANTA] Falling back to backgroundColor"),this.el.style.background=Object(s.a)(this.options.backgroundColor)))}this.initMouse(),this.resize(),this.animationLoop();const i=window.addEventListener;i("resize",this.resize),window.requestAnimationFrame(this.resize),this.options.mouseControls&&(i("scroll",this.windowMouseMoveWrapper),i("mousemove",this.windowMouseMoveWrapper)),this.options.touchControls&&(i("touchstart",this.windowTouchWrapper),i("touchmove",this.windowTouchWrapper)),this.options.gyroControls&&i("deviceorientation",this.windowGyroWrapper)}setOptions(t={}){Object(s.c)(this.options,t),this.triggerMouseMove()}prepareEl(){let t,e;if("undefined"!=typeof Node&&Node.TEXT_NODE)for(t=0;t=0&&s>=0&&i<=e.width&&s<=e.height&&(this.mouseX=i,this.mouseY=s,this.options.mouseEase||this.triggerMouseMove(i,s))}windowTouchWrapper(t){const e=this.getCanvasRect();if(!e)return!1;if(1===t.touches.length){const i=t.touches[0].clientX-e.left,s=t.touches[0].clientY-e.top;i>=0&&s>=0&&i<=e.width&&s<=e.height&&(this.mouseX=i,this.mouseY=s,this.options.mouseEase||this.triggerMouseMove(i,s))}}windowGyroWrapper(t){const e=this.getCanvasRect();if(!e)return!1;const i=Math.round(2*t.alpha)-e.left,s=Math.round(2*t.beta)-e.top;i>=0&&s>=0&&i<=e.width&&s<=e.height&&(this.mouseX=i,this.mouseY=s,this.options.mouseEase||this.triggerMouseMove(i,s))}triggerMouseMove(t,e){void 0===t&&void 0===e&&(this.options.mouseEase?(t=this.mouseEaseX,e=this.mouseEaseY):(t=this.mouseX,e=this.mouseY)),this.uniforms&&(this.uniforms.iMouse.value.x=t/this.scale,this.uniforms.iMouse.value.y=e/this.scale);const i=t/this.width,s=e/this.height;"function"==typeof this.onMouseMove&&this.onMouseMove(i,s)}setSize(){this.scale||(this.scale=1),Object(s.e)()&&this.options.scaleMobile?this.scale=this.options.scaleMobile:this.options.scale&&(this.scale=this.options.scale),this.width=Math.max(this.el.offsetWidth,this.options.minWidth),this.height=Math.max(this.el.offsetHeight,this.options.minHeight)}initMouse(){(!this.mouseX&&!this.mouseY||this.mouseX===this.options.minWidth/2&&this.mouseY===this.options.minHeight/2)&&(this.mouseX=this.width/2,this.mouseY=this.height/2,this.triggerMouseMove(this.mouseX,this.mouseY))}resize(){this.setSize(),this.camera&&(this.camera.aspect=this.width/this.height,"function"==typeof this.camera.updateProjectionMatrix&&this.camera.updateProjectionMatrix()),this.renderer&&(this.renderer.setSize(this.width,this.height),this.renderer.setPixelRatio(window.devicePixelRatio/this.scale)),"function"==typeof this.onResize&&this.onResize()}isOnScreen(){const t=this.el.offsetHeight,e=this.el.getBoundingClientRect(),i=window.pageYOffset||(document.documentElement||document.body.parentNode||document.body).scrollTop,s=e.top+i;return s-window.innerHeight<=i&&i<=s+t}animationLoop(){return this.t||(this.t=0),this.t+=1,this.t2||(this.t2=0),this.t2+=this.options.speed||1,this.uniforms&&(this.uniforms.iTime.value=.016667*this.t2),this.options.mouseEase&&(this.mouseEaseX=this.mouseEaseX||this.mouseX||0,this.mouseEaseY=this.mouseEaseY||this.mouseY||0,Math.abs(this.mouseEaseX-this.mouseX)+Math.abs(this.mouseEaseY-this.mouseY)>.1&&(this.mouseEaseX+=.05*(this.mouseX-this.mouseEaseX),this.mouseEaseY+=.05*(this.mouseY-this.mouseEaseY),this.triggerMouseMove(this.mouseEaseX,this.mouseEaseY))),(this.isOnScreen()||this.options.forceAnimate)&&("function"==typeof this.onUpdate&&this.onUpdate(),this.scene&&this.camera&&(this.renderer.render(this.scene,this.camera),this.renderer.setClearColor(this.options.backgroundColor,this.options.backgroundAlpha)),this.fps&&this.fps.update&&this.fps.update(),"function"==typeof this.afterRender&&this.afterRender()),this.req=window.requestAnimationFrame(this.animationLoop)}restart(){if(this.scene)for(;this.scene.children.length;)this.scene.remove(this.scene.children[0]);"function"==typeof this.onRestart&&this.onRestart(),this.init()}init(){"function"==typeof this.onInit&&this.onInit()}destroy(){"function"==typeof this.onDestroy&&this.onDestroy();const t=window.removeEventListener;t("touchstart",this.windowTouchWrapper),t("touchmove",this.windowTouchWrapper),t("scroll",this.windowMouseMoveWrapper),t("mousemove",this.windowMouseMoveWrapper),t("deviceorientation",this.windowGyroWrapper),t("resize",this.resize),window.cancelAnimationFrame(this.req),this.renderer&&(this.renderer.domElement&&this.el.removeChild(this.renderer.domElement),this.renderer=null,this.scene=null),r.current===this&&(r.current=null)}},e.b=r.VantaBase},13:function(t,e,i){"use strict";i.r(e);var s=i(1),o=i(0);let n="object"==typeof window&&window.THREE;class r extends s.b{static initClass(){this.prototype.defaultOptions={backgroundColor:2106408,color:8978176},this.prototype.colors=[16720469,16716185,16737996,8978176,7851025,16776960,16742195,1179647,1149149,16768290,2250188,7975100,5468283]}constructor(t){n=t.THREE||n,super(t)}material(t){return new n.MeshLambertMaterial({color:t})}genRing(t,e,i,s,r,h,a){null==s&&(s=0),null==r&&(r=1.4*Math.PI),null==h&&(h=0),null==a&&(a=1),this.rings||(this.rings=[]),e<1&&(e=1);const c={amount:.4,bevelEnabled:!1,steps:1,curveSegments:~~(64*r/6.14)},u=new n.Shape;u.absarc(0,0,e+i,0,r,!1),u.lineTo(e*Math.cos(r),e*Math.sin(r)),u.absarc(0,0,e,r,0,!0);const l=new n.ExtrudeGeometry(u,c),d=this.material(t);(0===Object(o.g)(0,1)||e>60)&&(d.transparent=!0,d.opacity=Math.max(50/e+Object(o.h)(-.3,.3),.1));const p=new n.Mesh(l,d);if(p.rotation.x=Math.PI/2,p.rotation.z=s,p.position.y=h,p.speed=.001*a,p.receiveShadow=!0,p.castShadow=!0,this.rings.push(p),this.cont.add(p),e<20&&r<1.3*Math.PI&&Object(o.g)(0,2))try{this.genRing(Object(o.i)(this.colors),e+Object(o.h)(-1,3),i+Object(o.h)(-2,0),s+r,r+Object(o.h)(-.5,.5),h+Object(o.h)(-3,1),a)}catch(t){}return p}onInit(){let t;const{material:e}=this;this.cont=new n.Group,this.cont.position.set(30,0,0),this.cont.rotation.x=.06667,this.cont.rotation.z=.16667,this.scene.add(this.cont);let i=Object(o.e)()?30:60;for(let e=0;e.01&&(t=e.tx-e.position.x,e.position.x+=.02*t),Math.abs(e.ty-e.position.y)>.01&&(t=e.ty-e.position.y,e.position.y+=.02*t),e.lookAt(new n.Vector3(0,25,7)),e.near=Math.max(.5*e.position.z-20,1),e.updateProjectionMatrix();for(let t of Array.from(null!=this.rings?this.rings:[]))t.rotation.z+=t.speed;const i=.001*this.t;return this.cont.rotation.x+=1e-4*Math.sin(i),this.cont.rotation.z+=7e-5*Math.cos(i)}onMouseMove(t,e){const i=this.camera;return i.oy||(i.oy=i.position.y,i.ox=i.position.x),i.tx=i.ox+50*(t-.5),i.ty=i.oy-50*e}}r.initClass(),e.default=s.a.register("RINGS",r)}})})); \ No newline at end of file diff --git a/compsci.md b/compsci.md new file mode 100644 index 000000000..2c7371d4e --- /dev/null +++ b/compsci.md @@ -0,0 +1,6 @@ +--- +layout: schedule +title: Computer Science Time Box Page +units: "1" +course: compsci +--- diff --git a/csa.md b/csa.md deleted file mode 100644 index 74ba928be..000000000 --- a/csa.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -layout: schedule -title: Computer Science "A" -units: "1,2,3,4,5,6,7,8,9" -course: csa ---- diff --git a/csp.md b/csp.md deleted file mode 100644 index 4c201e6bb..000000000 --- a/csp.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -layout: schedule -title: Computer Science Pinciples -units: "1,2,3,4,5,6,7,8,9" -course: csp ---- diff --git a/csse.md b/csse.md deleted file mode 100644 index 0a8db89a9..000000000 --- a/csse.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -layout: schedule -title: Computer Science and Software Engineering -units: "1,2,3,4,5,6" -course: csse ---- diff --git a/get_to_know_me_game.py b/get_to_know_me_game.py index ecdf0a1f0..c9920fe33 100644 --- a/get_to_know_me_game.py +++ b/get_to_know_me_game.py @@ -1,9 +1,12 @@ # Online Python compiler (interpreter) to run Python online. # Write Python 3 code in this online editor and run it. -questions = ["When is my birthday", "What is my favorite food","What is my favorite color"] -response =[["A. July 8th","B. January 9th","C. November 27th","D. June 9th"],["A. Pizza", "B. Salad","C. Pasta", "D. Mac&Cheese"],["A. Blue", "B. Green","C. Red", "D. Black"]] -answer = ["A","D","B"] -print("Hello. Wellome to the Get To Know Me Game. This is a multiple choic test that will test your knowledge about me") +questions = ["When is my birthday", "What is my favorite food","What is my favorite color","What is favorite food"] +responses = [["A. July 8th", "B. January 9th", "C. November 27th", "D. June 9th"], + ["A. Pizza", "B. Salad", "C. Pasta", "D. Mac&Cheese"], + ["A. Blue", "B. Green", "C. Red", "D. Black"], + ["A. 12", "B. 11", "C. 19", "D. 13"]]; +answer = ["A","D","B","D"] +print("Hello. Wellome to the Get To Know Me Game. This is a multiple choice test that will test your knowledge about me") user_answer = "" for i in range(len(questions)): print(questions[i]) diff --git a/images/push.jpg b/images/push.jpg new file mode 100644 index 0000000000000000000000000000000000000000..86bf42da08368d159b43c681b799dde74bd4f97f GIT binary patch literal 29416 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 diff --git a/scripts/activate.sh b/scripts/activate.sh index db5d86b09..bf4ccf8fc 100755 --- a/scripts/activate.sh +++ b/scripts/activate.sh @@ -1,26 +1,28 @@ <> ~/.bashrc + fi +} + +#### Github Pages Local Build support echo "=== GitHub pages build tools ===" export GEM_HOME="$HOME/gems" export PATH="$HOME/gems/bin:$PATH" -echo '# Install Ruby Gems to ~/gems' >> ~/.bashrc -echo 'export GEM_HOME="$HOME/gems"' >> ~/.bashrc -echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.bashrc +add_to_rc "# Ruby Gem Path" +add_to_rc 'export GEM_HOME="$HOME/gems"' +add_to_rc 'export PATH="$HOME/gems/bin:$PATH"' + echo "=== Gem install starting, thinking... ===" gem install jekyll bundler +echo "=== !!!Start a new Terminal!!! ===" \ No newline at end of file diff --git a/scripts/activate_macos.sh b/scripts/activate_macos.sh new file mode 100755 index 000000000..12a7d7010 --- /dev/null +++ b/scripts/activate_macos.sh @@ -0,0 +1,39 @@ +<> ~/.zshrc + fi +} + +# MacOS required tools +# +# MacOS commands +# +# Upgrade Homebrew and install xz (decompression utility) +echo "=== Upgrade Packages ===" +yes | brew update +yes | brew upgrade +yes | brew install xz # decompression utility + +# Install rbenv, Ruby 3.1.4, and configure it +echo "=== Install Ruby ===" +yes | brew install rbenv + +# Test if Ruby 3.1.4 exists +if ! rbenv versions | grep -q 3.1.4; then + yes | rbenv install 3.1.4 +fi +rbenv global 3.1.4 + +# Configure rbenv to initialize in the shell +add_to_rc "# rbenv initialize" +add_to_rc 'if which rbenv > /dev/null; then eval "$(rbenv init - zsh)"; fi' +# + +# Install Python and Pip using Homebrew +echo "=== Install Python ===" +yes | brew install python + +# Install Jupyter Notebook using Homebrew +echo "=== Install Jupyter Notebook ===" +yes | brew install jupyter + +# Setup Python libraries for Notebook conversion +pip install nbconvert # library for notebook conversion +pip install nbformat # notebook file utility +pip install pyyaml # notebook frontmatter + +#### Github Pages Local Build +echo "=== GitHub pages build tools ===" +export GEM_HOME="$HOME/gems" +export PATH="$HOME/gems/bin:$PATH" +add_to_rc "# Ruby Gem Path" +add_to_rc 'export GEM_HOME="$HOME/gems"' +add_to_rc 'export PATH="$HOME/gems/bin:$PATH"' + +echo "=== Gem install starting, thinking... ===" +gem install jekyll bundler + +echo "=== !!!Start a new Terminal!!! ===" diff --git a/scripts/setup_ubuntu.sh b/scripts/setup_ubuntu.sh new file mode 100755 index 000000000..613b64222 --- /dev/null +++ b/scripts/setup_ubuntu.sh @@ -0,0 +1,43 @@ +#!/bin/bash + +# Function to check if a line exists in run commands +line_exists_in_rc() { + grep -Fxq "$1" ~/.bashrc +} + +# Function to add line to run commands +add_to_rc() { + if ! line_exists_in_rc "$1"; then + echo "$1" >> ~/.bashrc + fi +} + +# Ugrade and install packages for Ubuntu +echo "=== Upgrade Packages ===" +sudo apt update +sudo apt upgrade -y + +# Install Ruby and necessary development tools +echo "=== Install Ruby ===" +sudo apt install -y ruby-full build-essential zlib1g-dev + +# Install Python 3 and pip +echo "=== Install Python ===" +sudo apt-get install -y python3 python3-pip python-is-python3 + +# Install Jupyter Notebook +echo "=== Install Jupyter Notebook ===" +sudo apt-get install -y jupyter-notebook + +#### Github Pages Local Build support +echo "=== GitHub pages build tools ===" +export GEM_HOME="$HOME/gems" +export PATH="$HOME/gems/bin:$PATH" +add_to_rc "# Ruby Gem Path" +add_to_rc 'export GEM_HOME="$HOME/gems"' +add_to_rc 'export PATH="$HOME/gems/bin:$PATH"' + +echo "=== Gem install starting, thinking... ===" +gem install jekyll bundler + +echo "=== !!!Start a new Terminal!!! ===" From 7c5892d8b5307f8d1aa9ab84d175aaedf09d2a22 Mon Sep 17 00:00:00 2001 From: sooctosnake Date: Tue, 12 Sep 2023 00:38:00 -0700 Subject: [PATCH 07/27] week3.5 assignment --- _posts/2023-09-04-dodging_game.md | 246 +++++++++++++++++++++--- _posts/2023-09-08-wikipediasearch.ipynb | 57 ++++++ _posts/bash_guessing.sh | 23 +++ _posts/yfin.py | 7 + test_world.py | 3 + venv/bin/activate_this.py | 32 +++ 6 files changed, 341 insertions(+), 27 deletions(-) create mode 100644 _posts/2023-09-08-wikipediasearch.ipynb create mode 100755 _posts/bash_guessing.sh create mode 100644 _posts/yfin.py create mode 100644 test_world.py create mode 100644 venv/bin/activate_this.py diff --git a/_posts/2023-09-04-dodging_game.md b/_posts/2023-09-04-dodging_game.md index 97182f2fa..7170cf1c8 100644 --- a/_posts/2023-09-04-dodging_game.md +++ b/_posts/2023-09-04-dodging_game.md @@ -1,10 +1,11 @@ --- +toc: true comments: false layout: post -title: DodgingGame -description: A calculator that averages your grade +title: Dodging Game +description: A game where you dodge moving bullets as a rectangle! type: hacks -courses: {'compsci': {'week': 3}} +courses: { compsci: {week: 3} } --- @@ -43,14 +44,17 @@ courses: {'compsci': {'week': 3}} const playerSpeed = 12; // Increase player speed const bulletSpeed = 10; const bulletInterval = 1000; + const maxBullets = 5; // Maximum number of bullets on the screen const bullets = []; let bulletIntervalId; // Declare bulletIntervalId variable let gameIntervalId; // Declare gameIntervalId variable + // Function to update the player's position function updatePlayerPosition() { player.style.left = playerX + 'px'; player.style.top = playerY + 'px'; } + // Event listener for arrow key presses document.addEventListener('keydown', function(event) { switch (event.key) { @@ -69,57 +73,245 @@ courses: {'compsci': {'week': 3}} } updatePlayerPosition(); }); + // Function to create and move bullets function createBullet() { - const bullet = document.createElement('div'); - bullet.className = 'bullet'; - bullet.style.left = (container.clientWidth - 10) + 'px'; // Start bullets from the right side - bullet.style.top = Math.random() * (container.clientHeight - 20) + 'px'; // Random initial vertical position - container.appendChild(bullet); - bullets.push(bullet); - function moveBullet() { - bullet.style.left = (parseInt(bullet.style.left) - bulletSpeed) + 'px'; // Move bullets from right to left - if (parseInt(bullet.style.left) < 0) { - container.removeChild(bullet); - bullets.shift(); - } - const playerRect = player.getBoundingClientRect(); - const bulletRect = bullet.getBoundingClientRect(); - if ( - playerRect.left < bulletRect.right && - playerRect.right > bulletRect.left && - playerRect.top < bulletRect.bottom && - playerRect.bottom > bulletRect.top - ) { - restartGame(); + if (bullets.length < maxBullets) { // Limit the number of bullets + const bullet = document.createElement('div'); + bullet.className = 'bullet'; + bullet.style.left = (container.clientWidth - 10) + 'px'; // Start bullets from the right side + bullet.style.top = Math.random() * (container.clientHeight - 20) + 'px'; // Random initial vertical position + container.appendChild(bullet); + bullets.push(bullet); + + function moveBullet() { + bullet.style.left = (parseInt(bullet.style.left) - bulletSpeed) + 'px'; // Move bullets from right to left + + if (parseInt(bullet.style.left) < 0) { + container.removeChild(bullet); + bullets.shift(); + } + + const playerRect = player.getBoundingClientRect(); + const bulletRect = bullet.getBoundingClientRect(); + + if ( + playerRect.left < bulletRect.right && + playerRect.right > bulletRect.left && + playerRect.top < bulletRect.bottom && + playerRect.bottom > bulletRect.top + ) { + restartGame(); + } } + + bulletIntervalId = setInterval(moveBullet, 10); } - bulletIntervalId = setInterval(moveBullet, 10); } + // Function to restart the game function restartGame() { clearInterval(gameIntervalId); - clearInterval(bulletIntervalId); + // Reset player position playerX = 0; playerY = 150; updatePlayerPosition(); + // Clear bullets bullets.forEach((bullet) => { container.removeChild(bullet); }); bullets.length = 0; + // Start a new game startGame(); } + // Start the initial game function startGame() { + bulletIntervalId = setInterval(createBullet, bulletInterval); + gameIntervalId = setInterval(() => { updatePlayerPosition(); }, 10); + } + + startGame(); + + + + + +## ChatGPT Review +This code is for a simple browser-based game where you control a blue square (the "player") using arrow keys. The player can move left, right, up, and down within a red-bordered container. The goal is to avoid red bullets that move from right to left across the screen. If a bullet hits the player, the game restarts. + +Here's a breakdown of the code in simple terms: + +The HTML structure: + +There's an HTML structure with a container div and a player div inside it. The player div represents the player's character, and the container is the game area. +CSS styles: + +The CSS code defines the appearance and positioning of the container, player, and bullets. +The container has a red border and a fixed width and height. +The player is a blue square, and bullets are red rectangles. They are both positioned absolutely within the container, allowing them to move independently. +JavaScript code: + +The JavaScript code controls the game logic. +It initializes variables for player position, speed, bullet properties, and manages bullets on the screen. +The updatePlayerPosition function updates the player's position based on arrow key presses. +Arrow key presses are detected using an event listener, and the player's position is adjusted accordingly. +Bullet creation and movement: + +The createBullet function generates bullets that move from right to left within the container. +It limits the number of bullets on the screen to a maximum of 5. +Bullets start from the right side and have random vertical positions. +A moveBullet function updates the bullet's position and checks if it goes off-screen or hits the player. +Restarting the game: + +The restartGame function is called when a bullet hits the player or when the game starts. +It clears intervals, resets the player's position, removes bullets, and starts a new game. +Starting the game: + +The startGame function initializes the game. +It sets up intervals to create bullets and update the player's position. +The game begins when the script is loaded, and you can control the blue player square with arrow keys. +In summary, this code creates a simple game where you control a player to avoid red bullets within a container. If you get hit by a bullet, the game restarts. It's a basic example of how you can create a game using HTML, CSS, and JavaScript. + + +## Our Code +``` + + + + +
+
+
+ - \ No newline at end of file + +``` \ No newline at end of file diff --git a/_posts/2023-09-08-wikipediasearch.ipynb b/_posts/2023-09-08-wikipediasearch.ipynb new file mode 100644 index 000000000..f9c87945d --- /dev/null +++ b/_posts/2023-09-08-wikipediasearch.ipynb @@ -0,0 +1,57 @@ +{ + "cells": [ + { + "cell_type": "code", + "execution_count": 14, + "metadata": {}, + "outputs": [ + { + "ename": "NameError", + "evalue": "name 'Term' is not defined", + "output_type": "error", + "traceback": [ + "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m", + "\u001b[0;31mNameError\u001b[0m Traceback (most recent call last)", + "\u001b[0;32m\u001b[0m in \u001b[0;36m\u001b[0;34m\u001b[0m\n\u001b[1;32m 3\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 4\u001b[0m \u001b[0mterms\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0minput\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m----> 5\u001b[0;31m \u001b[0mprint\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m\"Term:\"\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mTerm\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m 6\u001b[0m \u001b[0;31m# Search for a page\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 7\u001b[0m \u001b[0mresult\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mwiki\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0msearch\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mterm\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n", + "\u001b[0;31mNameError\u001b[0m: name 'Term' is not defined" + ] + } + ], + "source": [ + "import wikipedia as wiki\n", + "from IPython.display import display, Markdown # add for Jupyter\n", + "\n", + "terms = input()\n", + "# Search for a page \n", + "result = wiki.search(terms)\n", + "# Get the summary of the first result\n", + "summary = wiki.summary(result[0])\n", + "print(terms) \n", + "# print(summary) # console display\n", + "display(Markdown(summary)) # Jupyter display" + ] + } + ], + "metadata": { + "kernelspec": { + "display_name": "Python 3", + "language": "python", + "name": "python3" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.8.10" + }, + "orig_nbformat": 4 + }, + "nbformat": 4, + "nbformat_minor": 2 +} diff --git a/_posts/bash_guessing.sh b/_posts/bash_guessing.sh new file mode 100755 index 000000000..a5e45855b --- /dev/null +++ b/_posts/bash_guessing.sh @@ -0,0 +1,23 @@ +#!/bin/bash + +# Generate a random number between 1 and 100 +random_number=$(( (RANDOM % 100) + 1 )) + +# Function to prompt for a guess and provide feedback +guess_number() { + read -p "Guess a number between 1 and 100: " user_guess + + if [[ $user_guess -eq $random_number ]]; then + echo "Congratulations! You guessed the correct number: $random_number" + elif [[ $user_guess -lt $random_number ]]; then + echo "Try again. The number is higher than $user_guess." + guess_number + else + echo "Try again. The number is lower than $user_guess." + guess_number + fi +} + +echo "Welcome to the Number Guessing Game!" +guess_number + diff --git a/_posts/yfin.py b/_posts/yfin.py new file mode 100644 index 000000000..f1984a78f --- /dev/null +++ b/_posts/yfin.py @@ -0,0 +1,7 @@ +import yfinance as yf + +ticker = input("Enter stock ticker: ") + +# Download 3 months of historical data using the daily time frame +data = yf.download(ticker, period="3mo", interval="1d") +print(data) diff --git a/test_world.py b/test_world.py new file mode 100644 index 000000000..a88117207 --- /dev/null +++ b/test_world.py @@ -0,0 +1,3 @@ +import worldometer + + diff --git a/venv/bin/activate_this.py b/venv/bin/activate_this.py new file mode 100644 index 000000000..447998698 --- /dev/null +++ b/venv/bin/activate_this.py @@ -0,0 +1,32 @@ +# -*- coding: utf-8 -*- +"""Activate virtualenv for current interpreter: + +Use exec(open(this_file).read(), {'__file__': this_file}). + +This can be used when you must use an existing Python interpreter, not the virtualenv bin/python. +""" +import os +import site +import sys + +try: + abs_file = os.path.abspath(__file__) +except NameError: + raise AssertionError("You must use exec(open(this_file).read(), {'__file__': this_file}))") + +bin_dir = os.path.dirname(abs_file) +base = bin_dir[: -len("bin") - 1] # strip away the bin part from the __file__, plus the path separator + +# prepend bin to PATH (this file is inside the bin directory) +os.environ["PATH"] = os.pathsep.join([bin_dir] + os.environ.get("PATH", "").split(os.pathsep)) +os.environ["VIRTUAL_ENV"] = base # virtual env is right above bin directory + +# add the virtual environments libraries to the host python import mechanism +prev_length = len(sys.path) +for lib in "../lib/python3.8/site-packages".split(os.pathsep): + path = os.path.realpath(os.path.join(bin_dir, lib)) + site.addsitedir(path.decode("utf-8") if "" else path) +sys.path[:] = sys.path[prev_length:] + sys.path[0:prev_length] + +sys.real_prefix = sys.prefix +sys.prefix = base From e96bf5c86526b8f89411c6392a8d6901fd366a7c Mon Sep 17 00:00:00 2001 From: sooctosnake Date: Tue, 12 Sep 2023 08:50:17 -0700 Subject: [PATCH 08/27] added games and api searches --- Pipfile | 12 + Pipfile.lock | 421 ++ _posts/2023-09-04-Week-3- Plans.md | 26 + _posts/2023-09-08-search_brittanica.md | 28 - _posts/2023-09-8-table.md | 163 + _posts/britannica_search.js | 10 - .../convert_notebooks.cpython-38.pyc | Bin 0 -> 2644 bytes venv/bin/activate | 84 + venv/bin/activate.csh | 55 + venv/bin/activate.fish | 100 + venv/bin/activate.ps1 | 60 + venv/bin/activate.xsh | 46 + venv/bin/easy_install | 8 + venv/bin/easy_install-3.8 | 8 + venv/bin/easy_install3 | 8 + venv/bin/pip | 8 + venv/bin/pip-3.8 | 8 + venv/bin/pip3 | 8 + venv/bin/pip3.8 | 8 + venv/bin/python | 1 + venv/bin/python3 | 1 + venv/bin/python3.8 | 1 + venv/bin/wheel | 8 + venv/bin/wheel-3.8 | 8 + venv/bin/wheel3 | 8 + .../__pycache__/_virtualenv.cpython-38.pyc | Bin 0 -> 3966 bytes .../python3.8/site-packages/_virtualenv.pth | 1 + .../python3.8/site-packages/_virtualenv.py | 115 + .../python3.8/site-packages/easy_install.py | 5 + .../pip-20.0.2.dist-info/INSTALLER | 1 + .../pip-20.0.2.dist-info/LICENSE.txt | 20 + .../pip-20.0.2.dist-info/METADATA | 84 + .../site-packages/pip-20.0.2.dist-info/RECORD | 264 + .../site-packages/pip-20.0.2.dist-info/WHEEL | 6 + .../pip-20.0.2.dist-info/entry_points.txt | 5 + .../pip-20.0.2.dist-info/top_level.txt | 1 + .../site-packages/pip-20.0.2.virtualenv | 0 .../python3.8/site-packages/pip/__init__.py | 18 + .../python3.8/site-packages/pip/__main__.py | 19 + .../pip/__pycache__/__init__.cpython-38.pyc | Bin 0 -> 658 bytes .../pip/__pycache__/__main__.cpython-38.pyc | Bin 0 -> 451 bytes .../site-packages/pip/_internal/__init__.py | 18 + .../__pycache__/__init__.cpython-38.pyc | Bin 0 -> 707 bytes .../__pycache__/build_env.cpython-38.pyc | Bin 0 -> 7512 bytes .../__pycache__/configuration.cpython-38.pyc | Bin 0 -> 10674 bytes .../__pycache__/exceptions.cpython-38.pyc | Bin 0 -> 12511 bytes .../__pycache__/legacy_resolve.cpython-38.pyc | Bin 0 -> 9927 bytes .../__pycache__/locations.cpython-38.pyc | Bin 0 -> 4521 bytes .../__pycache__/pep425tags.cpython-38.pyc | Bin 0 -> 3613 bytes .../__pycache__/pyproject.cpython-38.pyc | Bin 0 -> 3761 bytes .../self_outdated_check.cpython-38.pyc | Bin 0 -> 5522 bytes .../site-packages/pip/_internal/build_env.py | 221 + .../site-packages/pip/_internal/cache.py | 329 + .../pip/_internal/cli/__init__.py | 4 + .../cli/__pycache__/__init__.cpython-38.pyc | Bin 0 -> 265 bytes .../__pycache__/autocompletion.cpython-38.pyc | Bin 0 -> 4982 bytes .../__pycache__/base_command.cpython-38.pyc | Bin 0 -> 5876 bytes .../cli/__pycache__/cmdoptions.cpython-38.pyc | Bin 0 -> 20357 bytes .../command_context.cpython-38.pyc | Bin 0 -> 1340 bytes .../cli/__pycache__/main.cpython-38.pyc | Bin 0 -> 1435 bytes .../__pycache__/main_parser.cpython-38.pyc | Bin 0 -> 2188 bytes .../cli/__pycache__/parser.cpython-38.pyc | Bin 0 -> 9006 bytes .../__pycache__/req_command.cpython-38.pyc | Bin 0 -> 8318 bytes .../__pycache__/status_codes.cpython-38.pyc | Bin 0 -> 394 bytes .../pip/_internal/cli/autocompletion.py | 164 + .../pip/_internal/cli/base_command.py | 226 + .../pip/_internal/cli/cmdoptions.py | 957 +++ .../pip/_internal/cli/command_context.py | 36 + .../site-packages/pip/_internal/cli/main.py | 75 + .../pip/_internal/cli/main_parser.py | 99 + .../site-packages/pip/_internal/cli/parser.py | 265 + .../pip/_internal/cli/req_command.py | 333 + .../pip/_internal/cli/status_codes.py | 8 + .../pip/_internal/commands/__init__.py | 114 + .../__pycache__/__init__.cpython-38.pyc | Bin 0 -> 2881 bytes .../commands/__pycache__/list.cpython-38.pyc | Bin 0 -> 9071 bytes .../pip/_internal/commands/check.py | 45 + .../pip/_internal/commands/completion.py | 96 + .../pip/_internal/commands/configuration.py | 233 + .../pip/_internal/commands/debug.py | 142 + .../pip/_internal/commands/download.py | 147 + .../pip/_internal/commands/freeze.py | 103 + .../pip/_internal/commands/hash.py | 58 + .../pip/_internal/commands/help.py | 41 + .../pip/_internal/commands/install.py | 727 +++ .../pip/_internal/commands/list.py | 315 + .../pip/_internal/commands/search.py | 145 + .../pip/_internal/commands/show.py | 180 + .../pip/_internal/commands/uninstall.py | 82 + .../pip/_internal/commands/wheel.py | 197 + .../pip/_internal/configuration.py | 422 ++ .../pip/_internal/distributions/__init__.py | 24 + .../__pycache__/__init__.cpython-38.pyc | Bin 0 -> 841 bytes .../__pycache__/base.cpython-38.pyc | Bin 0 -> 1957 bytes .../__pycache__/installed.cpython-38.pyc | Bin 0 -> 1237 bytes .../__pycache__/sdist.cpython-38.pyc | Bin 0 -> 3500 bytes .../__pycache__/wheel.cpython-38.pyc | Bin 0 -> 1589 bytes .../pip/_internal/distributions/base.py | 45 + .../pip/_internal/distributions/installed.py | 24 + .../pip/_internal/distributions/sdist.py | 104 + .../pip/_internal/distributions/wheel.py | 36 + .../site-packages/pip/_internal/exceptions.py | 308 + .../pip/_internal/index/__init__.py | 2 + .../index/__pycache__/__init__.cpython-38.pyc | Bin 0 -> 219 bytes .../__pycache__/collector.cpython-38.pyc | Bin 0 -> 14185 bytes .../__pycache__/package_finder.cpython-38.pyc | Bin 0 -> 25778 bytes .../pip/_internal/index/collector.py | 544 ++ .../pip/_internal/index/package_finder.py | 1013 +++ .../pip/_internal/legacy_resolve.py | 430 ++ .../site-packages/pip/_internal/locations.py | 194 + .../site-packages/pip/_internal/main.py | 16 + .../pip/_internal/models/__init__.py | 2 + .../__pycache__/__init__.cpython-38.pyc | Bin 0 -> 253 bytes .../__pycache__/candidate.cpython-38.pyc | Bin 0 -> 1450 bytes .../__pycache__/format_control.cpython-38.pyc | Bin 0 -> 2445 bytes .../models/__pycache__/index.cpython-38.pyc | Bin 0 -> 1175 bytes .../models/__pycache__/link.cpython-38.pyc | Bin 0 -> 6688 bytes .../models/__pycache__/scheme.cpython-38.pyc | Bin 0 -> 891 bytes .../__pycache__/search_scope.cpython-38.pyc | Bin 0 -> 3282 bytes .../selection_prefs.cpython-38.pyc | Bin 0 -> 1625 bytes .../__pycache__/target_python.cpython-38.pyc | Bin 0 -> 3248 bytes .../models/__pycache__/wheel.cpython-38.pyc | Bin 0 -> 3236 bytes .../pip/_internal/models/candidate.py | 36 + .../pip/_internal/models/format_control.py | 84 + .../pip/_internal/models/index.py | 31 + .../pip/_internal/models/link.py | 227 + .../pip/_internal/models/scheme.py | 25 + .../pip/_internal/models/search_scope.py | 114 + .../pip/_internal/models/selection_prefs.py | 47 + .../pip/_internal/models/target_python.py | 107 + .../pip/_internal/models/wheel.py | 78 + .../pip/_internal/network/__init__.py | 2 + .../__pycache__/__init__.cpython-38.pyc | Bin 0 -> 241 bytes .../network/__pycache__/auth.cpython-38.pyc | Bin 0 -> 7007 bytes .../network/__pycache__/cache.cpython-38.pyc | Bin 0 -> 2720 bytes .../__pycache__/download.cpython-38.pyc | Bin 0 -> 4399 bytes .../__pycache__/session.cpython-38.pyc | Bin 0 -> 8880 bytes .../network/__pycache__/utils.cpython-38.pyc | Bin 0 -> 735 bytes .../pip/_internal/network/auth.py | 298 + .../pip/_internal/network/cache.py | 81 + .../pip/_internal/network/download.py | 200 + .../pip/_internal/network/session.py | 405 ++ .../pip/_internal/network/utils.py | 48 + .../pip/_internal/network/xmlrpc.py | 44 + .../pip/_internal/operations/__init__.py | 0 .../__pycache__/__init__.cpython-38.pyc | Bin 0 -> 189 bytes .../__pycache__/prepare.cpython-38.pyc | Bin 0 -> 11191 bytes .../_internal/operations/build/__init__.py | 0 .../build/__pycache__/__init__.cpython-38.pyc | Bin 0 -> 195 bytes .../build/__pycache__/metadata.cpython-38.pyc | Bin 0 -> 1237 bytes .../metadata_legacy.cpython-38.pyc | Bin 0 -> 3297 bytes .../_internal/operations/build/metadata.py | 40 + .../operations/build/metadata_legacy.py | 122 + .../pip/_internal/operations/build/wheel.py | 46 + .../operations/build/wheel_legacy.py | 115 + .../pip/_internal/operations/check.py | 163 + .../pip/_internal/operations/freeze.py | 265 + .../_internal/operations/install/__init__.py | 2 + .../__pycache__/__init__.cpython-38.pyc | Bin 0 -> 253 bytes .../editable_legacy.cpython-38.pyc | Bin 0 -> 1331 bytes .../install/__pycache__/legacy.cpython-38.pyc | Bin 0 -> 3077 bytes .../install/__pycache__/wheel.cpython-38.pyc | Bin 0 -> 14611 bytes .../operations/install/editable_legacy.py | 52 + .../_internal/operations/install/legacy.py | 129 + .../pip/_internal/operations/install/wheel.py | 615 ++ .../pip/_internal/operations/prepare.py | 591 ++ .../site-packages/pip/_internal/pep425tags.py | 167 + .../site-packages/pip/_internal/pyproject.py | 196 + .../pip/_internal/req/__init__.py | 92 + .../req/__pycache__/__init__.cpython-38.pyc | Bin 0 -> 2223 bytes .../__pycache__/constructors.cpython-38.pyc | Bin 0 -> 10392 bytes .../req/__pycache__/req_file.cpython-38.pyc | Bin 0 -> 12731 bytes .../__pycache__/req_install.cpython-38.pyc | Bin 0 -> 21367 bytes .../req/__pycache__/req_set.cpython-38.pyc | Bin 0 -> 6050 bytes .../__pycache__/req_uninstall.cpython-38.pyc | Bin 0 -> 17456 bytes .../pip/_internal/req/constructors.py | 436 ++ .../pip/_internal/req/req_file.py | 546 ++ .../pip/_internal/req/req_install.py | 830 +++ .../pip/_internal/req/req_set.py | 209 + .../pip/_internal/req/req_tracker.py | 150 + .../pip/_internal/req/req_uninstall.py | 644 ++ .../pip/_internal/self_outdated_check.py | 242 + .../pip/_internal/utils/__init__.py | 0 .../utils/__pycache__/__init__.cpython-38.pyc | Bin 0 -> 184 bytes .../utils/__pycache__/appdirs.cpython-38.pyc | Bin 0 -> 1380 bytes .../utils/__pycache__/compat.cpython-38.pyc | Bin 0 -> 6149 bytes .../__pycache__/deprecation.cpython-38.pyc | Bin 0 -> 2855 bytes .../utils/__pycache__/encoding.cpython-38.pyc | Bin 0 -> 1276 bytes .../__pycache__/filesystem.cpython-38.pyc | Bin 0 -> 4064 bytes .../__pycache__/filetypes.cpython-38.pyc | Bin 0 -> 585 bytes .../utils/__pycache__/glibc.cpython-38.pyc | Bin 0 -> 1737 bytes .../utils/__pycache__/hashes.cpython-38.pyc | Bin 0 -> 4173 bytes .../inject_securetransport.cpython-38.pyc | Bin 0 -> 961 bytes .../utils/__pycache__/logging.cpython-38.pyc | Bin 0 -> 9188 bytes .../__pycache__/marker_files.cpython-38.pyc | Bin 0 -> 957 bytes .../utils/__pycache__/misc.cpython-38.pyc | Bin 0 -> 23807 bytes .../utils/__pycache__/models.cpython-38.pyc | Bin 0 -> 1953 bytes .../__pycache__/packaging.cpython-38.pyc | Bin 0 -> 2637 bytes .../__pycache__/pkg_resources.cpython-38.pyc | Bin 0 -> 1851 bytes .../setuptools_build.cpython-38.pyc | Bin 0 -> 2956 bytes .../__pycache__/subprocess.cpython-38.pyc | Bin 0 -> 5627 bytes .../utils/__pycache__/temp_dir.cpython-38.pyc | Bin 0 -> 6740 bytes .../utils/__pycache__/typing.cpython-38.pyc | Bin 0 -> 1466 bytes .../utils/__pycache__/ui.cpython-38.pyc | Bin 0 -> 11831 bytes .../__pycache__/unpacking.cpython-38.pyc | Bin 0 -> 6104 bytes .../utils/__pycache__/urls.cpython-38.pyc | Bin 0 -> 1494 bytes .../__pycache__/virtualenv.cpython-38.pyc | Bin 0 -> 3309 bytes .../utils/__pycache__/wheel.cpython-38.pyc | Bin 0 -> 6354 bytes .../pip/_internal/utils/appdirs.py | 44 + .../pip/_internal/utils/compat.py | 269 + .../pip/_internal/utils/deprecation.py | 104 + .../pip/_internal/utils/distutils_args.py | 48 + .../pip/_internal/utils/encoding.py | 42 + .../pip/_internal/utils/entrypoints.py | 31 + .../pip/_internal/utils/filesystem.py | 171 + .../pip/_internal/utils/filetypes.py | 16 + .../pip/_internal/utils/glibc.py | 98 + .../pip/_internal/utils/hashes.py | 131 + .../_internal/utils/inject_securetransport.py | 36 + .../pip/_internal/utils/logging.py | 398 ++ .../pip/_internal/utils/marker_files.py | 25 + .../site-packages/pip/_internal/utils/misc.py | 904 +++ .../pip/_internal/utils/models.py | 42 + .../pip/_internal/utils/packaging.py | 94 + .../pip/_internal/utils/pkg_resources.py | 44 + .../pip/_internal/utils/setuptools_build.py | 181 + .../pip/_internal/utils/subprocess.py | 278 + .../pip/_internal/utils/temp_dir.py | 250 + .../pip/_internal/utils/typing.py | 38 + .../site-packages/pip/_internal/utils/ui.py | 428 ++ .../pip/_internal/utils/unpacking.py | 272 + .../site-packages/pip/_internal/utils/urls.py | 54 + .../pip/_internal/utils/virtualenv.py | 115 + .../pip/_internal/utils/wheel.py | 225 + .../pip/_internal/vcs/__init__.py | 15 + .../vcs/__pycache__/__init__.cpython-38.pyc | Bin 0 -> 477 bytes .../vcs/__pycache__/bazaar.cpython-38.pyc | Bin 0 -> 3776 bytes .../vcs/__pycache__/git.cpython-38.pyc | Bin 0 -> 9588 bytes .../vcs/__pycache__/mercurial.cpython-38.pyc | Bin 0 -> 4917 bytes .../vcs/__pycache__/subversion.cpython-38.pyc | Bin 0 -> 8516 bytes .../__pycache__/versioncontrol.cpython-38.pyc | Bin 0 -> 19245 bytes .../site-packages/pip/_internal/vcs/bazaar.py | 120 + .../site-packages/pip/_internal/vcs/git.py | 395 ++ .../pip/_internal/vcs/mercurial.py | 155 + .../pip/_internal/vcs/subversion.py | 333 + .../pip/_internal/vcs/versioncontrol.py | 700 ++ .../pip/_internal/wheel_builder.py | 305 + .../site-packages/pip/_vendor/__init__.py | 119 + .../__pycache__/__init__.cpython-38.pyc | Bin 0 -> 3066 bytes .../pkg_resources-0.0.0.dist-info/AUTHORS.txt | 562 ++ .../pkg_resources-0.0.0.dist-info/INSTALLER | 1 + .../pkg_resources-0.0.0.dist-info/LICENSE.txt | 20 + .../pkg_resources-0.0.0.dist-info/METADATA | 13 + .../pkg_resources-0.0.0.dist-info/RECORD | 44 + .../pkg_resources-0.0.0.dist-info/WHEEL | 6 + .../pkg_resources-0.0.0.virtualenv | 0 .../site-packages/pkg_resources/__init__.py | 3296 ++++++++++ .../pkg_resources/_vendor/__init__.py | 0 .../pkg_resources/_vendor/appdirs.py | 608 ++ .../_vendor/packaging/__about__.py | 21 + .../_vendor/packaging/__init__.py | 14 + .../_vendor/packaging/_compat.py | 30 + .../_vendor/packaging/_structures.py | 68 + .../_vendor/packaging/markers.py | 301 + .../_vendor/packaging/requirements.py | 127 + .../_vendor/packaging/specifiers.py | 774 +++ .../pkg_resources/_vendor/packaging/utils.py | 14 + .../_vendor/packaging/version.py | 393 ++ .../pkg_resources/_vendor/pyparsing.py | 5742 +++++++++++++++++ .../pkg_resources/_vendor/six.py | 868 +++ .../pkg_resources/extern/__init__.py | 73 + .../site-packages/pkg_resources/py31compat.py | 23 + .../setuptools-44.0.0.dist-info/AUTHORS.txt | 562 ++ .../setuptools-44.0.0.dist-info/INSTALLER | 1 + .../setuptools-44.0.0.dist-info/LICENSE.txt | 20 + .../setuptools-44.0.0.dist-info/METADATA | 82 + .../setuptools-44.0.0.dist-info/RECORD | 171 + .../setuptools-44.0.0.dist-info/WHEEL | 6 + .../dependency_links.txt | 2 + .../entry_points.txt | 68 + .../setuptools-44.0.0.dist-info/top_level.txt | 3 + .../setuptools-44.0.0.dist-info/zip-safe | 1 + .../setuptools-44.0.0.virtualenv | 0 .../site-packages/setuptools/__init__.py | 228 + .../setuptools/_deprecation_warning.py | 7 + .../site-packages/setuptools/_imp.py | 73 + .../setuptools/_vendor/__init__.py | 0 .../setuptools/_vendor/ordered_set.py | 488 ++ .../setuptools/_vendor/packaging/__about__.py | 27 + .../setuptools/_vendor/packaging/__init__.py | 26 + .../setuptools/_vendor/packaging/_compat.py | 31 + .../_vendor/packaging/_structures.py | 68 + .../setuptools/_vendor/packaging/markers.py | 296 + .../_vendor/packaging/requirements.py | 138 + .../_vendor/packaging/specifiers.py | 749 +++ .../setuptools/_vendor/packaging/tags.py | 404 ++ .../setuptools/_vendor/packaging/utils.py | 57 + .../setuptools/_vendor/packaging/version.py | 420 ++ .../setuptools/_vendor/pyparsing.py | 5742 +++++++++++++++++ .../site-packages/setuptools/_vendor/six.py | 868 +++ .../site-packages/setuptools/archive_util.py | 173 + .../site-packages/setuptools/build_meta.py | 257 + .../site-packages/setuptools/cli-32.exe | Bin 0 -> 65536 bytes .../site-packages/setuptools/cli-64.exe | Bin 0 -> 74752 bytes .../site-packages/setuptools/cli.exe | Bin 0 -> 65536 bytes .../setuptools/command/__init__.py | 17 + .../site-packages/setuptools/command/alias.py | 80 + .../setuptools/command/bdist_egg.py | 502 ++ .../setuptools/command/bdist_rpm.py | 43 + .../setuptools/command/bdist_wininst.py | 21 + .../setuptools/command/build_clib.py | 98 + .../setuptools/command/build_ext.py | 327 + .../setuptools/command/build_py.py | 270 + .../setuptools/command/develop.py | 221 + .../setuptools/command/dist_info.py | 36 + .../setuptools/command/easy_install.py | 2402 +++++++ .../setuptools/command/egg_info.py | 717 ++ .../setuptools/command/install.py | 125 + .../setuptools/command/install_egg_info.py | 82 + .../setuptools/command/install_lib.py | 147 + .../setuptools/command/install_scripts.py | 65 + .../setuptools/command/launcher manifest.xml | 15 + .../setuptools/command/py36compat.py | 136 + .../setuptools/command/register.py | 18 + .../setuptools/command/rotate.py | 66 + .../setuptools/command/saveopts.py | 22 + .../site-packages/setuptools/command/sdist.py | 252 + .../setuptools/command/setopt.py | 149 + .../site-packages/setuptools/command/test.py | 279 + .../setuptools/command/upload.py | 17 + .../setuptools/command/upload_docs.py | 206 + .../site-packages/setuptools/config.py | 659 ++ .../site-packages/setuptools/dep_util.py | 23 + .../site-packages/setuptools/depends.py | 176 + .../site-packages/setuptools/dist.py | 1274 ++++ .../site-packages/setuptools/errors.py | 16 + .../site-packages/setuptools/extension.py | 57 + .../setuptools/extern/__init__.py | 73 + .../site-packages/setuptools/glob.py | 174 + .../site-packages/setuptools/gui-32.exe | Bin 0 -> 65536 bytes .../site-packages/setuptools/gui-64.exe | Bin 0 -> 75264 bytes .../site-packages/setuptools/gui.exe | Bin 0 -> 65536 bytes .../site-packages/setuptools/installer.py | 150 + .../site-packages/setuptools/launch.py | 35 + .../site-packages/setuptools/lib2to3_ex.py | 62 + .../site-packages/setuptools/monkey.py | 179 + .../site-packages/setuptools/msvc.py | 1679 +++++ .../site-packages/setuptools/namespaces.py | 107 + .../site-packages/setuptools/package_index.py | 1136 ++++ .../site-packages/setuptools/py27compat.py | 60 + .../site-packages/setuptools/py31compat.py | 32 + .../site-packages/setuptools/py33compat.py | 59 + .../site-packages/setuptools/py34compat.py | 13 + .../site-packages/setuptools/sandbox.py | 491 ++ .../setuptools/script (dev).tmpl | 6 + .../site-packages/setuptools/script.tmpl | 3 + .../site-packages/setuptools/site-patch.py | 74 + .../site-packages/setuptools/ssl_support.py | 260 + .../site-packages/setuptools/unicode_utils.py | 44 + .../site-packages/setuptools/version.py | 6 + .../site-packages/setuptools/wheel.py | 220 + .../setuptools/windows_support.py | 29 + .../wheel-0.34.2.dist-info/AUTHORS.txt | 562 ++ .../wheel-0.34.2.dist-info/INSTALLER | 1 + .../wheel-0.34.2.dist-info/LICENSE.txt | 20 + .../wheel-0.34.2.dist-info/METADATA | 66 + .../wheel-0.34.2.dist-info/RECORD | 43 + .../wheel-0.34.2.dist-info/WHEEL | 6 + .../wheel-0.34.2.dist-info/entry_points.txt | 6 + .../wheel-0.34.2.dist-info/top_level.txt | 1 + .../site-packages/wheel-0.34.2.virtualenv | 0 .../python3.8/site-packages/wheel/__init__.py | 1 + .../python3.8/site-packages/wheel/__main__.py | 19 + .../python3.8/site-packages/wheel/_version.py | 4 + .../site-packages/wheel/bdist_wheel.py | 403 ++ .../site-packages/wheel/cli/__init__.py | 88 + .../site-packages/wheel/cli/convert.py | 269 + .../python3.8/site-packages/wheel/cli/pack.py | 79 + .../site-packages/wheel/cli/unpack.py | 25 + .../site-packages/wheel/macosx_libfile.py | 341 + .../python3.8/site-packages/wheel/metadata.py | 138 + .../site-packages/wheel/pep425tags.py | 261 + .../python3.8/site-packages/wheel/pkginfo.py | 43 + .../lib/python3.8/site-packages/wheel/util.py | 46 + .../site-packages/wheel/wheelfile.py | 169 + venv/pyvenv.cfg | 8 + 386 files changed, 64047 insertions(+), 38 deletions(-) create mode 100644 Pipfile create mode 100644 Pipfile.lock create mode 100644 _posts/2023-09-04-Week-3- Plans.md delete mode 100644 _posts/2023-09-08-search_brittanica.md create mode 100644 _posts/2023-09-8-table.md delete mode 100644 _posts/britannica_search.js create mode 100644 scripts/__pycache__/convert_notebooks.cpython-38.pyc create mode 100644 venv/bin/activate create mode 100644 venv/bin/activate.csh create mode 100644 venv/bin/activate.fish create mode 100644 venv/bin/activate.ps1 create mode 100644 venv/bin/activate.xsh create mode 100755 venv/bin/easy_install create mode 100755 venv/bin/easy_install-3.8 create mode 100755 venv/bin/easy_install3 create mode 100755 venv/bin/pip create mode 100755 venv/bin/pip-3.8 create mode 100755 venv/bin/pip3 create mode 100755 venv/bin/pip3.8 create mode 120000 venv/bin/python create mode 120000 venv/bin/python3 create mode 120000 venv/bin/python3.8 create mode 100755 venv/bin/wheel create mode 100755 venv/bin/wheel-3.8 create mode 100755 venv/bin/wheel3 create mode 100644 venv/lib/python3.8/site-packages/__pycache__/_virtualenv.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/_virtualenv.pth create mode 100644 venv/lib/python3.8/site-packages/_virtualenv.py create mode 100644 venv/lib/python3.8/site-packages/easy_install.py create mode 100644 venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/INSTALLER create mode 100644 venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/LICENSE.txt create mode 100644 venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/METADATA create mode 100644 venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/RECORD create mode 100644 venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/WHEEL create mode 100644 venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/entry_points.txt create mode 100644 venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/top_level.txt create mode 100644 venv/lib/python3.8/site-packages/pip-20.0.2.virtualenv create mode 100644 venv/lib/python3.8/site-packages/pip/__init__.py create mode 100644 venv/lib/python3.8/site-packages/pip/__main__.py create mode 100644 venv/lib/python3.8/site-packages/pip/__pycache__/__init__.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/__pycache__/__main__.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/__init__.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/__pycache__/__init__.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/__pycache__/build_env.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/__pycache__/configuration.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/__pycache__/exceptions.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/__pycache__/legacy_resolve.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/__pycache__/locations.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/__pycache__/pep425tags.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/__pycache__/pyproject.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/__pycache__/self_outdated_check.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/build_env.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/cache.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/cli/__init__.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/__init__.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/autocompletion.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/base_command.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/cmdoptions.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/command_context.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/main.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/main_parser.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/parser.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/req_command.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/status_codes.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/cli/autocompletion.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/cli/base_command.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/cli/cmdoptions.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/cli/command_context.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/cli/main.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/cli/main_parser.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/cli/parser.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/cli/req_command.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/cli/status_codes.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/commands/__init__.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/commands/__pycache__/__init__.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/commands/__pycache__/list.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/commands/check.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/commands/completion.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/commands/configuration.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/commands/debug.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/commands/download.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/commands/freeze.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/commands/hash.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/commands/help.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/commands/install.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/commands/list.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/commands/search.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/commands/show.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/commands/uninstall.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/commands/wheel.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/configuration.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/distributions/__init__.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/distributions/__pycache__/__init__.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/distributions/__pycache__/base.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/distributions/__pycache__/installed.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/distributions/__pycache__/sdist.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/distributions/__pycache__/wheel.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/distributions/base.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/distributions/installed.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/distributions/sdist.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/distributions/wheel.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/exceptions.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/index/__init__.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/index/__pycache__/__init__.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/index/__pycache__/collector.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/index/__pycache__/package_finder.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/index/collector.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/index/package_finder.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/legacy_resolve.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/locations.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/main.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/models/__init__.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/__init__.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/candidate.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/format_control.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/index.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/link.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/scheme.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/search_scope.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/selection_prefs.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/target_python.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/wheel.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/models/candidate.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/models/format_control.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/models/index.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/models/link.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/models/scheme.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/models/search_scope.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/models/selection_prefs.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/models/target_python.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/models/wheel.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/network/__init__.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/network/__pycache__/__init__.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/network/__pycache__/auth.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/network/__pycache__/cache.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/network/__pycache__/download.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/network/__pycache__/session.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/network/__pycache__/utils.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/network/auth.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/network/cache.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/network/download.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/network/session.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/network/utils.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/network/xmlrpc.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/operations/__init__.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/operations/__pycache__/__init__.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/operations/__pycache__/prepare.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/operations/build/__init__.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/operations/build/__pycache__/__init__.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/operations/build/__pycache__/metadata.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/operations/build/__pycache__/metadata_legacy.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/operations/build/metadata.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/operations/build/metadata_legacy.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/operations/build/wheel.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/operations/build/wheel_legacy.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/operations/check.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/operations/freeze.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/operations/install/__init__.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/operations/install/__pycache__/__init__.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/operations/install/__pycache__/editable_legacy.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/operations/install/__pycache__/legacy.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/operations/install/__pycache__/wheel.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/operations/install/editable_legacy.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/operations/install/legacy.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/operations/install/wheel.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/operations/prepare.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/pep425tags.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/pyproject.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/req/__init__.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/req/__pycache__/__init__.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/req/__pycache__/constructors.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/req/__pycache__/req_file.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/req/__pycache__/req_install.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/req/__pycache__/req_set.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/req/__pycache__/req_uninstall.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/req/constructors.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/req/req_file.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/req/req_install.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/req/req_set.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/req/req_tracker.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/req/req_uninstall.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/self_outdated_check.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/__init__.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/__init__.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/appdirs.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/compat.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/deprecation.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/encoding.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/filesystem.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/filetypes.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/glibc.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/hashes.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/inject_securetransport.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/logging.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/marker_files.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/misc.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/models.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/packaging.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/pkg_resources.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/setuptools_build.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/subprocess.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/temp_dir.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/typing.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/ui.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/unpacking.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/urls.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/virtualenv.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/wheel.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/appdirs.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/compat.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/deprecation.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/distutils_args.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/encoding.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/entrypoints.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/filesystem.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/filetypes.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/glibc.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/hashes.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/inject_securetransport.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/logging.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/marker_files.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/misc.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/models.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/packaging.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/pkg_resources.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/setuptools_build.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/subprocess.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/temp_dir.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/typing.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/ui.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/unpacking.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/urls.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/virtualenv.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/utils/wheel.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/vcs/__init__.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/vcs/__pycache__/__init__.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/vcs/__pycache__/bazaar.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/vcs/__pycache__/git.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/vcs/__pycache__/mercurial.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/vcs/__pycache__/subversion.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/vcs/__pycache__/versioncontrol.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/vcs/bazaar.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/vcs/git.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/vcs/mercurial.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/vcs/subversion.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/vcs/versioncontrol.py create mode 100644 venv/lib/python3.8/site-packages/pip/_internal/wheel_builder.py create mode 100644 venv/lib/python3.8/site-packages/pip/_vendor/__init__.py create mode 100644 venv/lib/python3.8/site-packages/pip/_vendor/__pycache__/__init__.cpython-38.pyc create mode 100644 venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/AUTHORS.txt create mode 100644 venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/INSTALLER create mode 100644 venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/LICENSE.txt create mode 100644 venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/METADATA create mode 100644 venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/RECORD create mode 100644 venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/WHEEL create mode 100644 venv/lib/python3.8/site-packages/pkg_resources-0.0.0.virtualenv create mode 100644 venv/lib/python3.8/site-packages/pkg_resources/__init__.py create mode 100644 venv/lib/python3.8/site-packages/pkg_resources/_vendor/__init__.py create mode 100644 venv/lib/python3.8/site-packages/pkg_resources/_vendor/appdirs.py create mode 100644 venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/__about__.py create mode 100644 venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/__init__.py create mode 100644 venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/_compat.py create mode 100644 venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/_structures.py create mode 100644 venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/markers.py create mode 100644 venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/requirements.py create mode 100644 venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/specifiers.py create mode 100644 venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/utils.py create mode 100644 venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/version.py create mode 100644 venv/lib/python3.8/site-packages/pkg_resources/_vendor/pyparsing.py create mode 100644 venv/lib/python3.8/site-packages/pkg_resources/_vendor/six.py create mode 100644 venv/lib/python3.8/site-packages/pkg_resources/extern/__init__.py create mode 100644 venv/lib/python3.8/site-packages/pkg_resources/py31compat.py create mode 100644 venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/AUTHORS.txt create mode 100644 venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/INSTALLER create mode 100644 venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/LICENSE.txt create mode 100644 venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/METADATA create mode 100644 venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/RECORD create mode 100644 venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/WHEEL create mode 100644 venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/dependency_links.txt create mode 100644 venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/entry_points.txt create mode 100644 venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/top_level.txt create mode 100644 venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/zip-safe create mode 100644 venv/lib/python3.8/site-packages/setuptools-44.0.0.virtualenv create mode 100644 venv/lib/python3.8/site-packages/setuptools/__init__.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/_deprecation_warning.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/_imp.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/_vendor/__init__.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/_vendor/ordered_set.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/__about__.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/__init__.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/_compat.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/_structures.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/markers.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/requirements.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/specifiers.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/tags.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/utils.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/version.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/_vendor/pyparsing.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/_vendor/six.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/archive_util.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/build_meta.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/cli-32.exe create mode 100644 venv/lib/python3.8/site-packages/setuptools/cli-64.exe create mode 100644 venv/lib/python3.8/site-packages/setuptools/cli.exe create mode 100644 venv/lib/python3.8/site-packages/setuptools/command/__init__.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/command/alias.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/command/bdist_egg.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/command/bdist_rpm.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/command/bdist_wininst.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/command/build_clib.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/command/build_ext.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/command/build_py.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/command/develop.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/command/dist_info.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/command/easy_install.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/command/egg_info.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/command/install.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/command/install_egg_info.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/command/install_lib.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/command/install_scripts.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/command/launcher manifest.xml create mode 100644 venv/lib/python3.8/site-packages/setuptools/command/py36compat.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/command/register.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/command/rotate.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/command/saveopts.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/command/sdist.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/command/setopt.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/command/test.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/command/upload.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/command/upload_docs.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/config.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/dep_util.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/depends.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/dist.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/errors.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/extension.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/extern/__init__.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/glob.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/gui-32.exe create mode 100644 venv/lib/python3.8/site-packages/setuptools/gui-64.exe create mode 100644 venv/lib/python3.8/site-packages/setuptools/gui.exe create mode 100644 venv/lib/python3.8/site-packages/setuptools/installer.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/launch.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/lib2to3_ex.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/monkey.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/msvc.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/namespaces.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/package_index.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/py27compat.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/py31compat.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/py33compat.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/py34compat.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/sandbox.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/script (dev).tmpl create mode 100644 venv/lib/python3.8/site-packages/setuptools/script.tmpl create mode 100644 venv/lib/python3.8/site-packages/setuptools/site-patch.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/ssl_support.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/unicode_utils.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/version.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/wheel.py create mode 100644 venv/lib/python3.8/site-packages/setuptools/windows_support.py create mode 100644 venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/AUTHORS.txt create mode 100644 venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/INSTALLER create mode 100644 venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/LICENSE.txt create mode 100644 venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/METADATA create mode 100644 venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/RECORD create mode 100644 venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/WHEEL create mode 100644 venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/entry_points.txt create mode 100644 venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/top_level.txt create mode 100644 venv/lib/python3.8/site-packages/wheel-0.34.2.virtualenv create mode 100644 venv/lib/python3.8/site-packages/wheel/__init__.py create mode 100644 venv/lib/python3.8/site-packages/wheel/__main__.py create mode 100644 venv/lib/python3.8/site-packages/wheel/_version.py create mode 100644 venv/lib/python3.8/site-packages/wheel/bdist_wheel.py create mode 100644 venv/lib/python3.8/site-packages/wheel/cli/__init__.py create mode 100644 venv/lib/python3.8/site-packages/wheel/cli/convert.py create mode 100644 venv/lib/python3.8/site-packages/wheel/cli/pack.py create mode 100644 venv/lib/python3.8/site-packages/wheel/cli/unpack.py create mode 100644 venv/lib/python3.8/site-packages/wheel/macosx_libfile.py create mode 100644 venv/lib/python3.8/site-packages/wheel/metadata.py create mode 100644 venv/lib/python3.8/site-packages/wheel/pep425tags.py create mode 100644 venv/lib/python3.8/site-packages/wheel/pkginfo.py create mode 100644 venv/lib/python3.8/site-packages/wheel/util.py create mode 100644 venv/lib/python3.8/site-packages/wheel/wheelfile.py create mode 100644 venv/pyvenv.cfg diff --git a/Pipfile b/Pipfile new file mode 100644 index 000000000..4339884f2 --- /dev/null +++ b/Pipfile @@ -0,0 +1,12 @@ +[[source]] +url = "https://pypi.python.org/simple" +verify_ssl = true +name = "pypi" + +[packages] +worldometer = "*" + +[dev-packages] + +[requires] +python_version = "3.8" diff --git a/Pipfile.lock b/Pipfile.lock new file mode 100644 index 000000000..66d71eef2 --- /dev/null +++ b/Pipfile.lock @@ -0,0 +1,421 @@ +{ + "_meta": { + "hash": { + "sha256": "737b03953ab7053fb895ce287166f7de52ffe4f767a80df160d5d538942360cc" + }, + "pipfile-spec": 6, + "requires": { + "python_version": "3.8" + }, + "sources": [ + { + "name": "pypi", + "url": "https://pypi.python.org/simple", + "verify_ssl": true + } + ] + }, + "default": { + "appdirs": { + "hashes": [ + "sha256:7d5d0167b2b1ba821647616af46a749d1c653740dd0d2415100fe26e27afdf41", + "sha256:a841dacd6b99318a741b166adb07e19ee71a274450e68237b4650ca1055ab128" + ], + "version": "==1.4.4" + }, + "beautifulsoup4": { + "hashes": [ + "sha256:492bbc69dca35d12daac71c4db1bfff0c876c00ef4a2ffacce226d4638eb72da", + "sha256:bd2520ca0d9d7d12694a53d44ac482d181b4ec1888909b035a3dbf40d0f57d4a" + ], + "version": "==4.12.2" + }, + "bs4": { + "hashes": [ + "sha256:36ecea1fd7cc5c0c6e4a1ff075df26d50da647b75376626cc186e2212886dd3a" + ], + "version": "==0.0.1" + }, + "certifi": { + "hashes": [ + "sha256:539cc1d13202e33ca466e88b2807e29f4c13049d6d87031a3c110744495cb082", + "sha256:92d6037539857d8206b8f6ae472e8b77db8058fec5937a1ef3f54304089edbb9" + ], + "version": "==2023.7.22" + }, + "charset-normalizer": { + "hashes": [ + "sha256:04e57ab9fbf9607b77f7d057974694b4f6b142da9ed4a199859d9d4d5c63fe96", + "sha256:09393e1b2a9461950b1c9a45d5fd251dc7c6f228acab64da1c9c0165d9c7765c", + "sha256:0b87549028f680ca955556e3bd57013ab47474c3124dc069faa0b6545b6c9710", + "sha256:1000fba1057b92a65daec275aec30586c3de2401ccdcd41f8a5c1e2c87078706", + "sha256:1249cbbf3d3b04902ff081ffbb33ce3377fa6e4c7356f759f3cd076cc138d020", + "sha256:1920d4ff15ce893210c1f0c0e9d19bfbecb7983c76b33f046c13a8ffbd570252", + "sha256:193cbc708ea3aca45e7221ae58f0fd63f933753a9bfb498a3b474878f12caaad", + "sha256:1a100c6d595a7f316f1b6f01d20815d916e75ff98c27a01ae817439ea7726329", + "sha256:1f30b48dd7fa1474554b0b0f3fdfdd4c13b5c737a3c6284d3cdc424ec0ffff3a", + "sha256:203f0c8871d5a7987be20c72442488a0b8cfd0f43b7973771640fc593f56321f", + "sha256:246de67b99b6851627d945db38147d1b209a899311b1305dd84916f2b88526c6", + "sha256:2dee8e57f052ef5353cf608e0b4c871aee320dd1b87d351c28764fc0ca55f9f4", + "sha256:2efb1bd13885392adfda4614c33d3b68dee4921fd0ac1d3988f8cbb7d589e72a", + "sha256:2f4ac36d8e2b4cc1aa71df3dd84ff8efbe3bfb97ac41242fbcfc053c67434f46", + "sha256:3170c9399da12c9dc66366e9d14da8bf7147e1e9d9ea566067bbce7bb74bd9c2", + "sha256:3b1613dd5aee995ec6d4c69f00378bbd07614702a315a2cf6c1d21461fe17c23", + "sha256:3bb3d25a8e6c0aedd251753a79ae98a093c7e7b471faa3aa9a93a81431987ace", + "sha256:3bb7fda7260735efe66d5107fb7e6af6a7c04c7fce9b2514e04b7a74b06bf5dd", + "sha256:41b25eaa7d15909cf3ac4c96088c1f266a9a93ec44f87f1d13d4a0e86c81b982", + "sha256:45de3f87179c1823e6d9e32156fb14c1927fcc9aba21433f088fdfb555b77c10", + "sha256:46fb8c61d794b78ec7134a715a3e564aafc8f6b5e338417cb19fe9f57a5a9bf2", + "sha256:48021783bdf96e3d6de03a6e39a1171ed5bd7e8bb93fc84cc649d11490f87cea", + "sha256:4957669ef390f0e6719db3613ab3a7631e68424604a7b448f079bee145da6e09", + "sha256:5e86d77b090dbddbe78867a0275cb4df08ea195e660f1f7f13435a4649e954e5", + "sha256:6339d047dab2780cc6220f46306628e04d9750f02f983ddb37439ca47ced7149", + "sha256:681eb3d7e02e3c3655d1b16059fbfb605ac464c834a0c629048a30fad2b27489", + "sha256:6c409c0deba34f147f77efaa67b8e4bb83d2f11c8806405f76397ae5b8c0d1c9", + "sha256:7095f6fbfaa55defb6b733cfeb14efaae7a29f0b59d8cf213be4e7ca0b857b80", + "sha256:70c610f6cbe4b9fce272c407dd9d07e33e6bf7b4aa1b7ffb6f6ded8e634e3592", + "sha256:72814c01533f51d68702802d74f77ea026b5ec52793c791e2da806a3844a46c3", + "sha256:7a4826ad2bd6b07ca615c74ab91f32f6c96d08f6fcc3902ceeedaec8cdc3bcd6", + "sha256:7c70087bfee18a42b4040bb9ec1ca15a08242cf5867c58726530bdf3945672ed", + "sha256:855eafa5d5a2034b4621c74925d89c5efef61418570e5ef9b37717d9c796419c", + "sha256:8700f06d0ce6f128de3ccdbc1acaea1ee264d2caa9ca05daaf492fde7c2a7200", + "sha256:89f1b185a01fe560bc8ae5f619e924407efca2191b56ce749ec84982fc59a32a", + "sha256:8b2c760cfc7042b27ebdb4a43a4453bd829a5742503599144d54a032c5dc7e9e", + "sha256:8c2f5e83493748286002f9369f3e6607c565a6a90425a3a1fef5ae32a36d749d", + "sha256:8e098148dd37b4ce3baca71fb394c81dc5d9c7728c95df695d2dca218edf40e6", + "sha256:94aea8eff76ee6d1cdacb07dd2123a68283cb5569e0250feab1240058f53b623", + "sha256:95eb302ff792e12aba9a8b8f8474ab229a83c103d74a750ec0bd1c1eea32e669", + "sha256:9bd9b3b31adcb054116447ea22caa61a285d92e94d710aa5ec97992ff5eb7cf3", + "sha256:9e608aafdb55eb9f255034709e20d5a83b6d60c054df0802fa9c9883d0a937aa", + "sha256:a103b3a7069b62f5d4890ae1b8f0597618f628b286b03d4bc9195230b154bfa9", + "sha256:a386ebe437176aab38c041de1260cd3ea459c6ce5263594399880bbc398225b2", + "sha256:a38856a971c602f98472050165cea2cdc97709240373041b69030be15047691f", + "sha256:a401b4598e5d3f4a9a811f3daf42ee2291790c7f9d74b18d75d6e21dda98a1a1", + "sha256:a7647ebdfb9682b7bb97e2a5e7cb6ae735b1c25008a70b906aecca294ee96cf4", + "sha256:aaf63899c94de41fe3cf934601b0f7ccb6b428c6e4eeb80da72c58eab077b19a", + "sha256:b0dac0ff919ba34d4df1b6131f59ce95b08b9065233446be7e459f95554c0dc8", + "sha256:baacc6aee0b2ef6f3d308e197b5d7a81c0e70b06beae1f1fcacffdbd124fe0e3", + "sha256:bf420121d4c8dce6b889f0e8e4ec0ca34b7f40186203f06a946fa0276ba54029", + "sha256:c04a46716adde8d927adb9457bbe39cf473e1e2c2f5d0a16ceb837e5d841ad4f", + "sha256:c0b21078a4b56965e2b12f247467b234734491897e99c1d51cee628da9786959", + "sha256:c1c76a1743432b4b60ab3358c937a3fe1341c828ae6194108a94c69028247f22", + "sha256:c4983bf937209c57240cff65906b18bb35e64ae872da6a0db937d7b4af845dd7", + "sha256:c4fb39a81950ec280984b3a44f5bd12819953dc5fa3a7e6fa7a80db5ee853952", + "sha256:c57921cda3a80d0f2b8aec7e25c8aa14479ea92b5b51b6876d975d925a2ea346", + "sha256:c8063cf17b19661471ecbdb3df1c84f24ad2e389e326ccaf89e3fb2484d8dd7e", + "sha256:ccd16eb18a849fd8dcb23e23380e2f0a354e8daa0c984b8a732d9cfaba3a776d", + "sha256:cd6dbe0238f7743d0efe563ab46294f54f9bc8f4b9bcf57c3c666cc5bc9d1299", + "sha256:d62e51710986674142526ab9f78663ca2b0726066ae26b78b22e0f5e571238dd", + "sha256:db901e2ac34c931d73054d9797383d0f8009991e723dab15109740a63e7f902a", + "sha256:e03b8895a6990c9ab2cdcd0f2fe44088ca1c65ae592b8f795c3294af00a461c3", + "sha256:e1c8a2f4c69e08e89632defbfabec2feb8a8d99edc9f89ce33c4b9e36ab63037", + "sha256:e4b749b9cc6ee664a3300bb3a273c1ca8068c46be705b6c31cf5d276f8628a94", + "sha256:e6a5bf2cba5ae1bb80b154ed68a3cfa2fa00fde979a7f50d6598d3e17d9ac20c", + "sha256:e857a2232ba53ae940d3456f7533ce6ca98b81917d47adc3c7fd55dad8fab858", + "sha256:ee4006268ed33370957f55bf2e6f4d263eaf4dc3cfc473d1d90baff6ed36ce4a", + "sha256:eef9df1eefada2c09a5e7a40991b9fc6ac6ef20b1372abd48d2794a316dc0449", + "sha256:f058f6963fd82eb143c692cecdc89e075fa0828db2e5b291070485390b2f1c9c", + "sha256:f25c229a6ba38a35ae6e25ca1264621cc25d4d38dca2942a7fce0b67a4efe918", + "sha256:f2a1d0fd4242bd8643ce6f98927cf9c04540af6efa92323e9d3124f57727bfc1", + "sha256:f7560358a6811e52e9c4d142d497f1a6e10103d3a6881f18d04dbce3729c0e2c", + "sha256:f779d3ad205f108d14e99bb3859aa7dd8e9c68874617c72354d7ecaec2a054ac", + "sha256:f87f746ee241d30d6ed93969de31e5ffd09a2961a051e60ae6bddde9ec3583aa" + ], + "version": "==3.2.0" + }, + "cssselect": { + "hashes": [ + "sha256:666b19839cfaddb9ce9d36bfe4c969132c647b92fc9088c4e23f786b30f1b3dc", + "sha256:da1885f0c10b60c03ed5eccbb6b68d6eff248d91976fcde348f395d54c9fd35e" + ], + "version": "==1.2.0" + }, + "fake-useragent": { + "hashes": [ + "sha256:ad2b5414d19493d0789572f04200d4f656f84d20b205cc805233212957fe385d", + "sha256:b411f903331f695e3840ccadcf011f745a405764e97c588f2b8fde9e400a5446" + ], + "version": "==1.2.1" + }, + "idna": { + "hashes": [ + "sha256:814f528e8dead7d329833b91c5faa87d60bf71824cd12a7530b5526063d02cb4", + "sha256:90b77e79eaa3eba6de819a0c442c0b4ceefc341a7a2ab77d7562bf49f425c5c2" + ], + "version": "==3.4" + }, + "importlib-metadata": { + "hashes": [ + "sha256:3ebb78df84a805d7698245025b975d9d67053cd94c79245ba4b3eb694abe68bb", + "sha256:dbace7892d8c0c4ac1ad096662232f831d4e64f4c4545bd53016a3e9d4654743" + ], + "version": "==6.8.0" + }, + "importlib-resources": { + "hashes": [ + "sha256:134832a506243891221b88b4ae1213327eea96ceb4e407a00d790bb0626f45cf", + "sha256:4359457e42708462b9626a04657c6208ad799ceb41e5c58c57ffa0e6a098a5d4" + ], + "markers": "python_version < '3.10'", + "version": "==6.0.1" + }, + "lxml": { + "hashes": [ + "sha256:05186a0f1346ae12553d66df1cfce6f251589fea3ad3da4f3ef4e34b2d58c6a3", + "sha256:075b731ddd9e7f68ad24c635374211376aa05a281673ede86cbe1d1b3455279d", + "sha256:081d32421db5df44c41b7f08a334a090a545c54ba977e47fd7cc2deece78809a", + "sha256:0a3d3487f07c1d7f150894c238299934a2a074ef590b583103a45002035be120", + "sha256:0bfd0767c5c1de2551a120673b72e5d4b628737cb05414f03c3277bf9bed3305", + "sha256:0c0850c8b02c298d3c7006b23e98249515ac57430e16a166873fc47a5d549287", + "sha256:0e2cb47860da1f7e9a5256254b74ae331687b9672dfa780eed355c4c9c3dbd23", + "sha256:120fa9349a24c7043854c53cae8cec227e1f79195a7493e09e0c12e29f918e52", + "sha256:1247694b26342a7bf47c02e513d32225ededd18045264d40758abeb3c838a51f", + "sha256:141f1d1a9b663c679dc524af3ea1773e618907e96075262726c7612c02b149a4", + "sha256:14e019fd83b831b2e61baed40cab76222139926b1fb5ed0e79225bc0cae14584", + "sha256:1509dd12b773c02acd154582088820893109f6ca27ef7291b003d0e81666109f", + "sha256:17a753023436a18e27dd7769e798ce302963c236bc4114ceee5b25c18c52c693", + "sha256:1e224d5755dba2f4a9498e150c43792392ac9b5380aa1b845f98a1618c94eeef", + "sha256:1f447ea5429b54f9582d4b955f5f1985f278ce5cf169f72eea8afd9502973dd5", + "sha256:23eed6d7b1a3336ad92d8e39d4bfe09073c31bfe502f20ca5116b2a334f8ec02", + "sha256:25f32acefac14ef7bd53e4218fe93b804ef6f6b92ffdb4322bb6d49d94cad2bc", + "sha256:2c74524e179f2ad6d2a4f7caf70e2d96639c0954c943ad601a9e146c76408ed7", + "sha256:303bf1edce6ced16bf67a18a1cf8339d0db79577eec5d9a6d4a80f0fb10aa2da", + "sha256:3331bece23c9ee066e0fb3f96c61322b9e0f54d775fccefff4c38ca488de283a", + "sha256:3e9bdd30efde2b9ccfa9cb5768ba04fe71b018a25ea093379c857c9dad262c40", + "sha256:411007c0d88188d9f621b11d252cce90c4a2d1a49db6c068e3c16422f306eab8", + "sha256:42871176e7896d5d45138f6d28751053c711ed4d48d8e30b498da155af39aebd", + "sha256:46f409a2d60f634fe550f7133ed30ad5321ae2e6630f13657fb9479506b00601", + "sha256:48628bd53a426c9eb9bc066a923acaa0878d1e86129fd5359aee99285f4eed9c", + "sha256:48d6ed886b343d11493129e019da91d4039826794a3e3027321c56d9e71505be", + "sha256:4930be26af26ac545c3dffb662521d4e6268352866956672231887d18f0eaab2", + "sha256:4aec80cde9197340bc353d2768e2a75f5f60bacda2bab72ab1dc499589b3878c", + "sha256:4c28a9144688aef80d6ea666c809b4b0e50010a2aca784c97f5e6bf143d9f129", + "sha256:4d2d1edbca80b510443f51afd8496be95529db04a509bc8faee49c7b0fb6d2cc", + "sha256:4dd9a263e845a72eacb60d12401e37c616438ea2e5442885f65082c276dfb2b2", + "sha256:4f1026bc732b6a7f96369f7bfe1a4f2290fb34dce00d8644bc3036fb351a4ca1", + "sha256:4fb960a632a49f2f089d522f70496640fdf1218f1243889da3822e0a9f5f3ba7", + "sha256:50670615eaf97227d5dc60de2dc99fb134a7130d310d783314e7724bf163f75d", + "sha256:50baa9c1c47efcaef189f31e3d00d697c6d4afda5c3cde0302d063492ff9b477", + "sha256:53ace1c1fd5a74ef662f844a0413446c0629d151055340e9893da958a374f70d", + "sha256:5515edd2a6d1a5a70bfcdee23b42ec33425e405c5b351478ab7dc9347228f96e", + "sha256:56dc1f1ebccc656d1b3ed288f11e27172a01503fc016bcabdcbc0978b19352b7", + "sha256:578695735c5a3f51569810dfebd05dd6f888147a34f0f98d4bb27e92b76e05c2", + "sha256:57aba1bbdf450b726d58b2aea5fe47c7875f5afb2c4a23784ed78f19a0462574", + "sha256:57d6ba0ca2b0c462f339640d22882acc711de224d769edf29962b09f77129cbf", + "sha256:5c245b783db29c4e4fbbbfc9c5a78be496c9fea25517f90606aa1f6b2b3d5f7b", + "sha256:5c31c7462abdf8f2ac0577d9f05279727e698f97ecbb02f17939ea99ae8daa98", + "sha256:64f479d719dc9f4c813ad9bb6b28f8390360660b73b2e4beb4cb0ae7104f1c12", + "sha256:65299ea57d82fb91c7f019300d24050c4ddeb7c5a190e076b5f48a2b43d19c42", + "sha256:6689a3d7fd13dc687e9102a27e98ef33730ac4fe37795d5036d18b4d527abd35", + "sha256:690dafd0b187ed38583a648076865d8c229661ed20e48f2335d68e2cf7dc829d", + "sha256:6fc3c450eaa0b56f815c7b62f2b7fba7266c4779adcf1cece9e6deb1de7305ce", + "sha256:704f61ba8c1283c71b16135caf697557f5ecf3e74d9e453233e4771d68a1f42d", + "sha256:71c52db65e4b56b8ddc5bb89fb2e66c558ed9d1a74a45ceb7dcb20c191c3df2f", + "sha256:71d66ee82e7417828af6ecd7db817913cb0cf9d4e61aa0ac1fde0583d84358db", + "sha256:7d298a1bd60c067ea75d9f684f5f3992c9d6766fadbc0bcedd39750bf344c2f4", + "sha256:8b77946fd508cbf0fccd8e400a7f71d4ac0e1595812e66025bac475a8e811694", + "sha256:8d7e43bd40f65f7d97ad8ef5c9b1778943d02f04febef12def25f7583d19baac", + "sha256:8df133a2ea5e74eef5e8fc6f19b9e085f758768a16e9877a60aec455ed2609b2", + "sha256:8ed74706b26ad100433da4b9d807eae371efaa266ffc3e9191ea436087a9d6a7", + "sha256:92af161ecbdb2883c4593d5ed4815ea71b31fafd7fd05789b23100d081ecac96", + "sha256:97047f0d25cd4bcae81f9ec9dc290ca3e15927c192df17331b53bebe0e3ff96d", + "sha256:9719fe17307a9e814580af1f5c6e05ca593b12fb7e44fe62450a5384dbf61b4b", + "sha256:9767e79108424fb6c3edf8f81e6730666a50feb01a328f4a016464a5893f835a", + "sha256:9a92d3faef50658dd2c5470af249985782bf754c4e18e15afb67d3ab06233f13", + "sha256:9bb6ad405121241e99a86efff22d3ef469024ce22875a7ae045896ad23ba2340", + "sha256:9e28c51fa0ce5674be9f560c6761c1b441631901993f76700b1b30ca6c8378d6", + "sha256:aca086dc5f9ef98c512bac8efea4483eb84abbf926eaeedf7b91479feb092458", + "sha256:ae8b9c6deb1e634ba4f1930eb67ef6e6bf6a44b6eb5ad605642b2d6d5ed9ce3c", + "sha256:b0a545b46b526d418eb91754565ba5b63b1c0b12f9bd2f808c852d9b4b2f9b5c", + "sha256:b4e4bc18382088514ebde9328da057775055940a1f2e18f6ad2d78aa0f3ec5b9", + "sha256:b6420a005548ad52154c8ceab4a1290ff78d757f9e5cbc68f8c77089acd3c432", + "sha256:b86164d2cff4d3aaa1f04a14685cbc072efd0b4f99ca5708b2ad1b9b5988a991", + "sha256:bb3bb49c7a6ad9d981d734ef7c7193bc349ac338776a0360cc671eaee89bcf69", + "sha256:bef4e656f7d98aaa3486d2627e7d2df1157d7e88e7efd43a65aa5dd4714916cf", + "sha256:c0781a98ff5e6586926293e59480b64ddd46282953203c76ae15dbbbf302e8bb", + "sha256:c2006f5c8d28dee289f7020f721354362fa304acbaaf9745751ac4006650254b", + "sha256:c41bfca0bd3532d53d16fd34d20806d5c2b1ace22a2f2e4c0008570bf2c58833", + "sha256:cd47b4a0d41d2afa3e58e5bf1f62069255aa2fd6ff5ee41604418ca925911d76", + "sha256:cdb650fc86227eba20de1a29d4b2c1bfe139dc75a0669270033cb2ea3d391b85", + "sha256:cef2502e7e8a96fe5ad686d60b49e1ab03e438bd9123987994528febd569868e", + "sha256:d27be7405547d1f958b60837dc4c1007da90b8b23f54ba1f8b728c78fdb19d50", + "sha256:d37017287a7adb6ab77e1c5bee9bcf9660f90ff445042b790402a654d2ad81d8", + "sha256:d3ff32724f98fbbbfa9f49d82852b159e9784d6094983d9a8b7f2ddaebb063d4", + "sha256:d73d8ecf8ecf10a3bd007f2192725a34bd62898e8da27eb9d32a58084f93962b", + "sha256:dd708cf4ee4408cf46a48b108fb9427bfa00b9b85812a9262b5c668af2533ea5", + "sha256:e3cd95e10c2610c360154afdc2f1480aea394f4a4f1ea0a5eacce49640c9b190", + "sha256:e4da8ca0c0c0aea88fd46be8e44bd49716772358d648cce45fe387f7b92374a7", + "sha256:eadfbbbfb41b44034a4c757fd5d70baccd43296fb894dba0295606a7cf3124aa", + "sha256:ed667f49b11360951e201453fc3967344d0d0263aa415e1619e85ae7fd17b4e0", + "sha256:f3df3db1d336b9356dd3112eae5f5c2b8b377f3bc826848567f10bfddfee77e9", + "sha256:f6bdac493b949141b733c5345b6ba8f87a226029cbabc7e9e121a413e49441e0", + "sha256:fbf521479bcac1e25a663df882c46a641a9bff6b56dc8b0fafaebd2f66fb231b", + "sha256:fc9b106a1bf918db68619fdcd6d5ad4f972fdd19c01d19bdb6bf63f3589a9ec5", + "sha256:fcdd00edfd0a3001e0181eab3e63bd5c74ad3e67152c84f93f13769a40e073a7", + "sha256:fe4bda6bd4340caa6e5cf95e73f8fea5c4bfc55763dd42f1b50a94c1b4a2fbd4" + ], + "version": "==4.9.3" + }, + "parse": { + "hashes": [ + "sha256:371ed3800dc63983832159cc9373156613947707bc448b5215473a219dbd4362", + "sha256:cc3a47236ff05da377617ddefa867b7ba983819c664e1afe46249e5b469be464" + ], + "version": "==1.19.1" + }, + "pyee": { + "hashes": [ + "sha256:5c7e60f8df95710dbe17550e16ce0153f83990c00ef744841b43f371ed53ebea", + "sha256:c09f56e36eb10bf23aa2aacf145f690ded75b990a3d9523fd478b005940303d2" + ], + "version": "==8.2.2" + }, + "pyppeteer": { + "hashes": [ + "sha256:11a734d8f02c6b128035aba8faf32748f2016310a6a1cbc6aa5b1e2580742e8f", + "sha256:ddb0d15cb644720160d49abb1ad0d97e87a55581febf1b7531be9e983aad7742" + ], + "version": "==1.0.2" + }, + "pyquery": { + "hashes": [ + "sha256:8dfc9b4b7c5f877d619bbae74b1898d5743f6ca248cfd5d72b504dd614da312f", + "sha256:963e8d4e90262ff6d8dec072ea97285dc374a2f69cad7776f4082abcf6a1d8ae" + ], + "version": "==2.0.0" + }, + "requests": { + "hashes": [ + "sha256:58cd2187c01e70e6e26505bca751777aa9f2ee0b7f4300988b709f44e013003f", + "sha256:942c5a758f98d790eaed1a29cb6eefc7ffb0d1cf7af05c3d2791656dbd6ad1e1" + ], + "version": "==2.31.0" + }, + "requests-html": { + "hashes": [ + "sha256:7e929ecfed95fb1d0994bb368295d6d7c4d06b03fcb900c33d7d0b17e6003947", + "sha256:cb8a78cf829c4eca9d6233f28524f65dd2bfaafb4bdbbc407f0a0b8f487df6e2" + ], + "version": "==0.10.0" + }, + "soupsieve": { + "hashes": [ + "sha256:5663d5a7b3bfaeee0bc4372e7fc48f9cff4940b3eec54a6451cc5299f1097690", + "sha256:eaa337ff55a1579b6549dc679565eac1e3d000563bcb1c8ab0d0fefbc0c2cdc7" + ], + "version": "==2.5" + }, + "tqdm": { + "hashes": [ + "sha256:d302b3c5b53d47bce91fea46679d9c3c6508cf6332229aa1e7d8653723793386", + "sha256:d88e651f9db8d8551a62556d3cff9e3034274ca5d66e93197cf2490e2dcb69c7" + ], + "version": "==4.66.1" + }, + "urllib3": { + "hashes": [ + "sha256:8d36afa7616d8ab714608411b4a3b13e58f463aee519024578e062e141dce20f", + "sha256:8f135f6502756bde6b2a9b28989df5fbe87c9970cecaa69041edcce7f0589b14" + ], + "version": "==1.26.16" + }, + "w3lib": { + "hashes": [ + "sha256:c4432926e739caa8e3f49f5de783f336df563d9490416aebd5d39fb896d264e7", + "sha256:ed5b74e997eea2abe3c1321f916e344144ee8e9072a6f33463ee8e57f858a4b1" + ], + "version": "==2.1.2" + }, + "websockets": { + "hashes": [ + "sha256:00213676a2e46b6ebf6045bc11d0f529d9120baa6f58d122b4021ad92adabd41", + "sha256:00c870522cdb69cd625b93f002961ffb0c095394f06ba8c48f17eef7c1541f96", + "sha256:0154f7691e4fe6c2b2bc275b5701e8b158dae92a1ab229e2b940efe11905dff4", + "sha256:05a7233089f8bd355e8cbe127c2e8ca0b4ea55467861906b80d2ebc7db4d6b72", + "sha256:09a1814bb15eff7069e51fed0826df0bc0702652b5cb8f87697d469d79c23576", + "sha256:0cff816f51fb33c26d6e2b16b5c7d48eaa31dae5488ace6aae468b361f422b63", + "sha256:185929b4808b36a79c65b7865783b87b6841e852ef5407a2fb0c03381092fa3b", + "sha256:2fc8709c00704194213d45e455adc106ff9e87658297f72d544220e32029cd3d", + "sha256:33d69ca7612f0ddff3316b0c7b33ca180d464ecac2d115805c044bf0a3b0d032", + "sha256:389f8dbb5c489e305fb113ca1b6bdcdaa130923f77485db5b189de343a179393", + "sha256:38ea7b82bfcae927eeffc55d2ffa31665dc7fec7b8dc654506b8e5a518eb4d50", + "sha256:3d3cac3e32b2c8414f4f87c1b2ab686fa6284a980ba283617404377cd448f631", + "sha256:40e826de3085721dabc7cf9bfd41682dadc02286d8cf149b3ad05bff89311e4f", + "sha256:4239b6027e3d66a89446908ff3027d2737afc1a375f8fd3eea630a4842ec9a0c", + "sha256:45ec8e75b7dbc9539cbfafa570742fe4f676eb8b0d3694b67dabe2f2ceed8aa6", + "sha256:47a2964021f2110116cc1125b3e6d87ab5ad16dea161949e7244ec583b905bb4", + "sha256:48c08473563323f9c9debac781ecf66f94ad5a3680a38fe84dee5388cf5acaf6", + "sha256:4c6d2264f485f0b53adf22697ac11e261ce84805c232ed5dbe6b1bcb84b00ff0", + "sha256:4f72e5cd0f18f262f5da20efa9e241699e0cf3a766317a17392550c9ad7b37d8", + "sha256:56029457f219ade1f2fc12a6504ea61e14ee227a815531f9738e41203a429112", + "sha256:5c1289596042fad2cdceb05e1ebf7aadf9995c928e0da2b7a4e99494953b1b94", + "sha256:62e627f6b6d4aed919a2052efc408da7a545c606268d5ab5bfab4432734b82b4", + "sha256:74de2b894b47f1d21cbd0b37a5e2b2392ad95d17ae983e64727e18eb281fe7cb", + "sha256:7c584f366f46ba667cfa66020344886cf47088e79c9b9d39c84ce9ea98aaa331", + "sha256:7d27a7e34c313b3a7f91adcd05134315002aaf8540d7b4f90336beafaea6217c", + "sha256:7d3f0b61c45c3fa9a349cf484962c559a8a1d80dae6977276df8fd1fa5e3cb8c", + "sha256:82ff5e1cae4e855147fd57a2863376ed7454134c2bf49ec604dfe71e446e2193", + "sha256:84bc2a7d075f32f6ed98652db3a680a17a4edb21ca7f80fe42e38753a58ee02b", + "sha256:884be66c76a444c59f801ac13f40c76f176f1bfa815ef5b8ed44321e74f1600b", + "sha256:8a5cc00546e0a701da4639aa0bbcb0ae2bb678c87f46da01ac2d789e1f2d2038", + "sha256:8dc96f64ae43dde92530775e9cb169979f414dcf5cff670455d81a6823b42089", + "sha256:8f38706e0b15d3c20ef6259fd4bc1700cd133b06c3c1bb108ffe3f8947be15fa", + "sha256:90fcf8929836d4a0e964d799a58823547df5a5e9afa83081761630553be731f9", + "sha256:931c039af54fc195fe6ad536fde4b0de04da9d5916e78e55405436348cfb0e56", + "sha256:932af322458da7e4e35df32f050389e13d3d96b09d274b22a7aa1808f292fee4", + "sha256:942de28af58f352a6f588bc72490ae0f4ccd6dfc2bd3de5945b882a078e4e179", + "sha256:9bc42e8402dc5e9905fb8b9649f57efcb2056693b7e88faa8fb029256ba9c68c", + "sha256:a7a240d7a74bf8d5cb3bfe6be7f21697a28ec4b1a437607bae08ac7acf5b4882", + "sha256:a9f9a735deaf9a0cadc2d8c50d1a5bcdbae8b6e539c6e08237bc4082d7c13f28", + "sha256:ae5e95cfb53ab1da62185e23b3130e11d64431179debac6dc3c6acf08760e9b1", + "sha256:b029fb2032ae4724d8ae8d4f6b363f2cc39e4c7b12454df8df7f0f563ed3e61a", + "sha256:b0d15c968ea7a65211e084f523151dbf8ae44634de03c801b8bd070b74e85033", + "sha256:b343f521b047493dc4022dd338fc6db9d9282658862756b4f6fd0e996c1380e1", + "sha256:b627c266f295de9dea86bd1112ed3d5fafb69a348af30a2422e16590a8ecba13", + "sha256:b9968694c5f467bf67ef97ae7ad4d56d14be2751000c1207d31bf3bb8860bae8", + "sha256:ba089c499e1f4155d2a3c2a05d2878a3428cf321c848f2b5a45ce55f0d7d310c", + "sha256:bbccd847aa0c3a69b5f691a84d2341a4f8a629c6922558f2a70611305f902d74", + "sha256:bc0b82d728fe21a0d03e65f81980abbbcb13b5387f733a1a870672c5be26edab", + "sha256:c57e4c1349fbe0e446c9fa7b19ed2f8a4417233b6984277cce392819123142d3", + "sha256:c94ae4faf2d09f7c81847c63843f84fe47bf6253c9d60b20f25edfd30fb12588", + "sha256:c9b27d6c1c6cd53dc93614967e9ce00ae7f864a2d9f99fe5ed86706e1ecbf485", + "sha256:d210abe51b5da0ffdbf7b43eed0cfdff8a55a1ab17abbec4301c9ff077dd0342", + "sha256:d58804e996d7d2307173d56c297cf7bc132c52df27a3efaac5e8d43e36c21c48", + "sha256:d6a4162139374a49eb18ef5b2f4da1dd95c994588f5033d64e0bbfda4b6b6fcf", + "sha256:da39dd03d130162deb63da51f6e66ed73032ae62e74aaccc4236e30edccddbb0", + "sha256:db3c336f9eda2532ec0fd8ea49fef7a8df8f6c804cdf4f39e5c5c0d4a4ad9a7a", + "sha256:dd500e0a5e11969cdd3320935ca2ff1e936f2358f9c2e61f100a1660933320ea", + "sha256:dd9becd5fe29773d140d68d607d66a38f60e31b86df75332703757ee645b6faf", + "sha256:e0cb5cc6ece6ffa75baccfd5c02cffe776f3f5c8bf486811f9d3ea3453676ce8", + "sha256:e23173580d740bf8822fd0379e4bf30aa1d5a92a4f252d34e893070c081050df", + "sha256:e3a686ecb4aa0d64ae60c9c9f1a7d5d46cab9bfb5d91a2d303d00e2cd4c4c5cc", + "sha256:e789376b52c295c4946403bd0efecf27ab98f05319df4583d3c48e43c7342c2f", + "sha256:edc344de4dac1d89300a053ac973299e82d3db56330f3494905643bb68801269", + "sha256:eef610b23933c54d5d921c92578ae5f89813438fded840c2e9809d378dc765d3", + "sha256:f2c38d588887a609191d30e902df2a32711f708abfd85d318ca9b367258cfd0c", + "sha256:f55b5905705725af31ccef50e55391621532cd64fbf0bc6f4bac935f0fccec46", + "sha256:f5fc088b7a32f244c519a048c170f14cf2251b849ef0e20cbbb0fdf0fdaf556f", + "sha256:fe10ddc59b304cb19a1bdf5bd0a7719cbbc9fbdd57ac80ed436b709fcf889106", + "sha256:ff64a1d38d156d429404aaa84b27305e957fd10c30e5880d1765c9480bea490f" + ], + "version": "==10.4" + }, + "worldometer": { + "hashes": [ + "sha256:515688ed4bd3974914c584fc2f80dc1f6584e4eec55e5dac59d2dec652143ab7", + "sha256:92edfd8a089657cbef9b62116418d67b233e3f7982efef79cd831d8625a1f43e" + ], + "index": "pypi", + "version": "==1.0.1" + }, + "zipp": { + "hashes": [ + "sha256:679e51dd4403591b2d6838a48de3d283f3d188412a9782faadf845f298736ba0", + "sha256:ebc15946aa78bd63458992fc81ec3b6f7b1e92d51c35e6de1c3804e73b799147" + ], + "markers": "python_version < '3.10'", + "version": "==3.16.2" + } + }, + "develop": {} +} diff --git a/_posts/2023-09-04-Week-3- Plans.md b/_posts/2023-09-04-Week-3- Plans.md new file mode 100644 index 000000000..0e2b446f6 --- /dev/null +++ b/_posts/2023-09-04-Week-3- Plans.md @@ -0,0 +1,26 @@ +--- +toc: true +comments: false +layout: post +title: Plans for the Week +description: Our Plans for Week 3 +type: plans +courses: { compsci: {week: 3} } +--- + +## Week 3 Plans +Soham and I's plan this week is to experiment on making a little videogame. We are thinking of making a small game involving a square which the player can control, and they have to avoid the moving bullets targeting the square. We are planning to do this by looking up online resources and using ChatGPT to explain the code to us, then we can start working on it. + +## Pair Showcase Plans +- Ask Teacher questions and interact with them on Slack or live by end of Tue, Wed…. particularly interact with Teacher when you have posted a draft of your plan. This would be considered Collaboration. Try to get feedback from me on Plan. +- Review code with ChatGPT, perhaps ask "Can you provide a review of this code?" Then paste code. Curate response into page(s). +Make a plan on what you and your Pair plan to do, this must exist by Monday night. You should have proof in live review of a draft in GitHub Issues history. +- Results must have Linux and interaction in VSCode +- Results must of Python and interaction in VSCode +- Results must have Web interaction in JavaScript +- Build a review ticket in Time Box page to accelerate discussion. +- Bring tickets and tangibles into GitHub pages repo on your Time Box page. +- Plan your Pair Showcase, know exactly what you will present. Try to do it within 3 minutes. +- Linux Shell and Bash, Python IO, Python Tricks!, JS Output w/Jquery, JS Output w/Objects, JS Input. +- Option 1. Add to the lessons and making code cells and hacks for better breakdown and understanding +- Option 2. Combine all the concepts/requirements into something unique and you feel is awesome diff --git a/_posts/2023-09-08-search_brittanica.md b/_posts/2023-09-08-search_brittanica.md deleted file mode 100644 index 4141357a7..000000000 --- a/_posts/2023-09-08-search_brittanica.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -comments: false -layout: post -title: Search Britanica -description: View any image -type: hacks -courses: {'compsci': {'week': 3}} ---- - - - - - Britannica Search - - -

Britannica Search

- - - - - - -
- - - - - diff --git a/_posts/2023-09-8-table.md b/_posts/2023-09-8-table.md new file mode 100644 index 000000000..d2dd0164b --- /dev/null +++ b/_posts/2023-09-8-table.md @@ -0,0 +1,163 @@ +--- +toc: true +comments: false +layout: post +title: Table of CO2 emissions +description: A table that shows to the co2 emssions per year +type: hacks +courses: { compsci: {week: 3} } +--- + + + + CO2 Emission Data + + +

CO2 Emission Data

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
YearCO2 Emission (in million tons)
19505.2
19556.1
19607.1
19658.4
197010.0
197512.2
198014.4
198516.8
199019.3
199521.9
200024.5
200527.2
201030.0
201533.0
202036.0
+ + +
+ + + + Top CO2 Emitting Countries in 2020 + + +

Top CO2 Emitting Countries in 2020

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
RankCountryCO2 Emission (in million tons)
1China10,065
2United States5,416
3India2,654
4Russia1,711
5Japan1,162
+ + + diff --git a/_posts/britannica_search.js b/_posts/britannica_search.js deleted file mode 100644 index 7b296f51a..000000000 --- a/_posts/britannica_search.js +++ /dev/null @@ -1,10 +0,0 @@ -function searchBritannica() { - // Get the search query from the input field - const query = document.getElementById('searchQuery').value; - - // Construct the Britannica search URL - const britannicaURL = `https://www.britannica.com/search?query=${encodeURIComponent(query)}`; - - // Open a new tab/window with the Britannica search results - window.open(britannicaURL, '_blank'); -} diff --git a/scripts/__pycache__/convert_notebooks.cpython-38.pyc b/scripts/__pycache__/convert_notebooks.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..90a0d23739f5d5dddf912bc0623595574b78da0b GIT binary patch literal 2644 zcmb7G-EJGl8J(H^;c`V%l%v$Hkfscf24GNAMccGaU>Hqh11;b%P0}XvqRC>#899`e zyX%>eEfGsyRJ{%Q0D%GOvc2wO^alZ`gcevHx5IEs9Cy6atPA4p3)YiS+oA`NF3Mz&#fxp(`6n z!1U+B z^$hDE!#*|Lk1~18%O}OX)2ftONc6q7R~CgW>PfU#5cz??;A}%J@~Lzc$f9rbLlVglR}o<=IFW|EL@n=5;QV z9v7Kic*@68jC3i_OejvrShfkJn3Ru2-!tvyp3=i{E=+fQ+^aoy(ti@Uh0R^Pzx#DL z5xcT1tE@WSeXK?$7rRQIa8c-8HIm~>tKE?UQon$1P@S2!kg}BNC>L3AQf*qiA_T&= zX@|C`d=2%HRm}1VP_g=Q(4M0*CNoykIk5gV|+xEG~{Y%D!AA^7y z`+^jAeWKY>a2(51N@md6^lcsTu=c+tPuT^4*NvLEGMYnQmWnUPd!S?HpZojd0V&u% zsTs&=3{9xY6A8S@)Vq1}<}kt13|0p|vP@lDE%oyFF*T6?a z-(d1B^uHwb4Rov+`41YJ)Q%1AedGP(-w--I0z-&k;TtP;zXoZlLJwR%Ny7jgjmyWA*q@{bl&H%qesjc61!p_ z^oEWlq$L~t!g$Bx%mk0K{Nxn|o3|f|LY!9e&Ts4l)^&UmlIe%vPq$Q;5W~XXQY*BV zI3L{3%TboAJA>8xreSRN6HEI}Y4gs|C;ctsmz5|?R2&?Z66!L(6d6zA;m7IT$HUL> zefno7ktDDxRK}~yO4^i2u0dmyRraI8g|xac!B~rllA)cZVS{x5*|foG%LGp(p6G8l zbsOJ$Q4%f9O8yj&BoPpBj-5oyJsO%O+v~DUfry47B|FPUUWGwg2a;VIth23U%HaRQ z^Bs&LSx#pnPgoEj&&c7Md4Tb z@GJC82O46j2?WHnSJMkf>8bA=3)$sLn^W+?m2=T^x^yn5Y=3z5`rhhr>p3ItfzzJ+ z877z45&8|cOldVN-#~!dXz6@M{>1jZX&+*a7}>KO-$U*C5;bdpxmdA(7tg8|0-+2x z-=#NTF48J^WILCao!3fW54So+z{v<0uxa`f_AmoHcgdGu%_yKkHZ7ofv<;{{Kve-M zd`_&aEY!%K_>>-leQw3GK3I9nAO9 zXQC82KQ7X=za@W*j-*)}Jb%X`DR)-w!HFK{Y9N*$Icl+Nmz6)qP`P7+WBrz`SzZ=f zu_wYpCze3DoY;Phr0JR>oHpFC6WyMa{3I85tZgbQq6jKzK?CmR`JT_BM%0bojH0L& G(f&2 + exit 33 +fi + +deactivate () { + unset -f pydoc >/dev/null 2>&1 + + # reset old environment variables + # ! [ -z ${VAR+_} ] returns true if VAR is declared at all + if ! [ -z "${_OLD_VIRTUAL_PATH:+_}" ] ; then + PATH="$_OLD_VIRTUAL_PATH" + export PATH + unset _OLD_VIRTUAL_PATH + fi + if ! [ -z "${_OLD_VIRTUAL_PYTHONHOME+_}" ] ; then + PYTHONHOME="$_OLD_VIRTUAL_PYTHONHOME" + export PYTHONHOME + unset _OLD_VIRTUAL_PYTHONHOME + fi + + # This should detect bash and zsh, which have a hash command that must + # be called to get it to forget past commands. Without forgetting + # past commands the $PATH changes we made may not be respected + if [ -n "${BASH-}" ] || [ -n "${ZSH_VERSION-}" ] ; then + hash -r 2>/dev/null + fi + + if ! [ -z "${_OLD_VIRTUAL_PS1+_}" ] ; then + PS1="$_OLD_VIRTUAL_PS1" + export PS1 + unset _OLD_VIRTUAL_PS1 + fi + + unset VIRTUAL_ENV + if [ ! "${1-}" = "nondestructive" ] ; then + # Self destruct! + unset -f deactivate + fi +} + +# unset irrelevant variables +deactivate nondestructive + +VIRTUAL_ENV='/home/roopapk/vscode/student/venv' +export VIRTUAL_ENV + +_OLD_VIRTUAL_PATH="$PATH" +PATH="$VIRTUAL_ENV/bin:$PATH" +export PATH + +# unset PYTHONHOME if set +if ! [ -z "${PYTHONHOME+_}" ] ; then + _OLD_VIRTUAL_PYTHONHOME="$PYTHONHOME" + unset PYTHONHOME +fi + +if [ -z "${VIRTUAL_ENV_DISABLE_PROMPT-}" ] ; then + _OLD_VIRTUAL_PS1="${PS1-}" + if [ "x" != x ] ; then + PS1="${PS1-}" + else + PS1="(`basename \"$VIRTUAL_ENV\"`) ${PS1-}" + fi + export PS1 +fi + +# Make sure to unalias pydoc if it's already there +alias pydoc 2>/dev/null >/dev/null && unalias pydoc || true + +pydoc () { + python -m pydoc "$@" +} + +# This should detect bash and zsh, which have a hash command that must +# be called to get it to forget past commands. Without forgetting +# past commands the $PATH changes we made may not be respected +if [ -n "${BASH-}" ] || [ -n "${ZSH_VERSION-}" ] ; then + hash -r 2>/dev/null +fi diff --git a/venv/bin/activate.csh b/venv/bin/activate.csh new file mode 100644 index 000000000..a931cd76e --- /dev/null +++ b/venv/bin/activate.csh @@ -0,0 +1,55 @@ +# This file must be used with "source bin/activate.csh" *from csh*. +# You cannot run it directly. +# Created by Davide Di Blasi . + +set newline='\ +' + +alias deactivate 'test $?_OLD_VIRTUAL_PATH != 0 && setenv PATH "$_OLD_VIRTUAL_PATH:q" && unset _OLD_VIRTUAL_PATH; rehash; test $?_OLD_VIRTUAL_PROMPT != 0 && set prompt="$_OLD_VIRTUAL_PROMPT:q" && unset _OLD_VIRTUAL_PROMPT; unsetenv VIRTUAL_ENV; test "\!:*" != "nondestructive" && unalias deactivate && unalias pydoc' + +# Unset irrelevant variables. +deactivate nondestructive + +setenv VIRTUAL_ENV '/home/roopapk/vscode/student/venv' + +set _OLD_VIRTUAL_PATH="$PATH:q" +setenv PATH "$VIRTUAL_ENV:q/bin:$PATH:q" + + + +if ('' != "") then + set env_name = '' +else + set env_name = '('"$VIRTUAL_ENV:t:q"') ' +endif + +if ( $?VIRTUAL_ENV_DISABLE_PROMPT ) then + if ( $VIRTUAL_ENV_DISABLE_PROMPT == "" ) then + set do_prompt = "1" + else + set do_prompt = "0" + endif +else + set do_prompt = "1" +endif + +if ( $do_prompt == "1" ) then + # Could be in a non-interactive environment, + # in which case, $prompt is undefined and we wouldn't + # care about the prompt anyway. + if ( $?prompt ) then + set _OLD_VIRTUAL_PROMPT="$prompt:q" + if ( "$prompt:q" =~ *"$newline:q"* ) then + : + else + set prompt = "$env_name:q$prompt:q" + endif + endif +endif + +unset env_name +unset do_prompt + +alias pydoc python -m pydoc + +rehash diff --git a/venv/bin/activate.fish b/venv/bin/activate.fish new file mode 100644 index 000000000..9c51f62fe --- /dev/null +++ b/venv/bin/activate.fish @@ -0,0 +1,100 @@ +# This file must be used using `source bin/activate.fish` *within a running fish ( http://fishshell.com ) session*. +# Do not run it directly. + +function _bashify_path -d "Converts a fish path to something bash can recognize" + set fishy_path $argv + set bashy_path $fishy_path[1] + for path_part in $fishy_path[2..-1] + set bashy_path "$bashy_path:$path_part" + end + echo $bashy_path +end + +function _fishify_path -d "Converts a bash path to something fish can recognize" + echo $argv | tr ':' '\n' +end + +function deactivate -d 'Exit virtualenv mode and return to the normal environment.' + # reset old environment variables + if test -n "$_OLD_VIRTUAL_PATH" + # https://github.com/fish-shell/fish-shell/issues/436 altered PATH handling + if test (echo $FISH_VERSION | head -c 1) -lt 3 + set -gx PATH (_fishify_path "$_OLD_VIRTUAL_PATH") + else + set -gx PATH "$_OLD_VIRTUAL_PATH" + end + set -e _OLD_VIRTUAL_PATH + end + + if test -n "$_OLD_VIRTUAL_PYTHONHOME" + set -gx PYTHONHOME "$_OLD_VIRTUAL_PYTHONHOME" + set -e _OLD_VIRTUAL_PYTHONHOME + end + + if test -n "$_OLD_FISH_PROMPT_OVERRIDE" + and functions -q _old_fish_prompt + # Set an empty local `$fish_function_path` to allow the removal of `fish_prompt` using `functions -e`. + set -l fish_function_path + + # Erase virtualenv's `fish_prompt` and restore the original. + functions -e fish_prompt + functions -c _old_fish_prompt fish_prompt + functions -e _old_fish_prompt + set -e _OLD_FISH_PROMPT_OVERRIDE + end + + set -e VIRTUAL_ENV + + if test "$argv[1]" != 'nondestructive' + # Self-destruct! + functions -e pydoc + functions -e deactivate + functions -e _bashify_path + functions -e _fishify_path + end +end + +# Unset irrelevant variables. +deactivate nondestructive + +set -gx VIRTUAL_ENV '/home/roopapk/vscode/student/venv' + +# https://github.com/fish-shell/fish-shell/issues/436 altered PATH handling +if test (echo $FISH_VERSION | head -c 1) -lt 3 + set -gx _OLD_VIRTUAL_PATH (_bashify_path $PATH) +else + set -gx _OLD_VIRTUAL_PATH "$PATH" +end +set -gx PATH "$VIRTUAL_ENV"'/bin' $PATH + +# Unset `$PYTHONHOME` if set. +if set -q PYTHONHOME + set -gx _OLD_VIRTUAL_PYTHONHOME $PYTHONHOME + set -e PYTHONHOME +end + +function pydoc + python -m pydoc $argv +end + +if test -z "$VIRTUAL_ENV_DISABLE_PROMPT" + # Copy the current `fish_prompt` function as `_old_fish_prompt`. + functions -c fish_prompt _old_fish_prompt + + function fish_prompt + # Run the user's prompt first; it might depend on (pipe)status. + set -l prompt (_old_fish_prompt) + + # Prompt override provided? + # If not, just prepend the environment name. + if test -n '' + printf '%s%s' '' (set_color normal) + else + printf '%s(%s) ' (set_color normal) (basename "$VIRTUAL_ENV") + end + + string join -- \n $prompt # handle multi-line prompts + end + + set -gx _OLD_FISH_PROMPT_OVERRIDE "$VIRTUAL_ENV" +end diff --git a/venv/bin/activate.ps1 b/venv/bin/activate.ps1 new file mode 100644 index 000000000..95504d395 --- /dev/null +++ b/venv/bin/activate.ps1 @@ -0,0 +1,60 @@ +$script:THIS_PATH = $myinvocation.mycommand.path +$script:BASE_DIR = Split-Path (Resolve-Path "$THIS_PATH/..") -Parent + +function global:deactivate([switch] $NonDestructive) { + if (Test-Path variable:_OLD_VIRTUAL_PATH) { + $env:PATH = $variable:_OLD_VIRTUAL_PATH + Remove-Variable "_OLD_VIRTUAL_PATH" -Scope global + } + + if (Test-Path function:_old_virtual_prompt) { + $function:prompt = $function:_old_virtual_prompt + Remove-Item function:\_old_virtual_prompt + } + + if ($env:VIRTUAL_ENV) { + Remove-Item env:VIRTUAL_ENV -ErrorAction SilentlyContinue + } + + if (!$NonDestructive) { + # Self destruct! + Remove-Item function:deactivate + Remove-Item function:pydoc + } +} + +function global:pydoc { + python -m pydoc $args +} + +# unset irrelevant variables +deactivate -nondestructive + +$VIRTUAL_ENV = $BASE_DIR +$env:VIRTUAL_ENV = $VIRTUAL_ENV + +New-Variable -Scope global -Name _OLD_VIRTUAL_PATH -Value $env:PATH + +$env:PATH = "$env:VIRTUAL_ENV/bin:" + $env:PATH +if (!$env:VIRTUAL_ENV_DISABLE_PROMPT) { + function global:_old_virtual_prompt { + "" + } + $function:_old_virtual_prompt = $function:prompt + + if ("" -ne "") { + function global:prompt { + # Add the custom prefix to the existing prompt + $previous_prompt_value = & $function:_old_virtual_prompt + ("" + $previous_prompt_value) + } + } + else { + function global:prompt { + # Add a prefix to the current prompt, but don't discard it. + $previous_prompt_value = & $function:_old_virtual_prompt + $new_prompt_value = "($( Split-Path $env:VIRTUAL_ENV -Leaf )) " + ($new_prompt_value + $previous_prompt_value) + } + } +} diff --git a/venv/bin/activate.xsh b/venv/bin/activate.xsh new file mode 100644 index 000000000..e5646e080 --- /dev/null +++ b/venv/bin/activate.xsh @@ -0,0 +1,46 @@ +"""Xonsh activate script for virtualenv""" +from xonsh.tools import get_sep as _get_sep + +def _deactivate(args): + if "pydoc" in aliases: + del aliases["pydoc"] + + if ${...}.get("_OLD_VIRTUAL_PATH", ""): + $PATH = $_OLD_VIRTUAL_PATH + del $_OLD_VIRTUAL_PATH + + if ${...}.get("_OLD_VIRTUAL_PYTHONHOME", ""): + $PYTHONHOME = $_OLD_VIRTUAL_PYTHONHOME + del $_OLD_VIRTUAL_PYTHONHOME + + if "VIRTUAL_ENV" in ${...}: + del $VIRTUAL_ENV + + if "VIRTUAL_ENV_PROMPT" in ${...}: + del $VIRTUAL_ENV_PROMPT + + if "nondestructive" not in args: + # Self destruct! + del aliases["deactivate"] + + +# unset irrelevant variables +_deactivate(["nondestructive"]) +aliases["deactivate"] = _deactivate + +$VIRTUAL_ENV = r"/home/roopapk/vscode/student/venv" + +$_OLD_VIRTUAL_PATH = $PATH +$PATH = $PATH[:] +$PATH.add($VIRTUAL_ENV + _get_sep() + "bin", front=True, replace=True) + +if ${...}.get("PYTHONHOME", ""): + # unset PYTHONHOME if set + $_OLD_VIRTUAL_PYTHONHOME = $PYTHONHOME + del $PYTHONHOME + +$VIRTUAL_ENV_PROMPT = "" +if not $VIRTUAL_ENV_PROMPT: + del $VIRTUAL_ENV_PROMPT + +aliases["pydoc"] = ["python", "-m", "pydoc"] diff --git a/venv/bin/easy_install b/venv/bin/easy_install new file mode 100755 index 000000000..31e96c866 --- /dev/null +++ b/venv/bin/easy_install @@ -0,0 +1,8 @@ +#!/home/roopapk/vscode/student/venv/bin/python +# -*- coding: utf-8 -*- +import re +import sys +from setuptools.command.easy_install import main +if __name__ == '__main__': + sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0]) + sys.exit(main()) diff --git a/venv/bin/easy_install-3.8 b/venv/bin/easy_install-3.8 new file mode 100755 index 000000000..31e96c866 --- /dev/null +++ b/venv/bin/easy_install-3.8 @@ -0,0 +1,8 @@ +#!/home/roopapk/vscode/student/venv/bin/python +# -*- coding: utf-8 -*- +import re +import sys +from setuptools.command.easy_install import main +if __name__ == '__main__': + sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0]) + sys.exit(main()) diff --git a/venv/bin/easy_install3 b/venv/bin/easy_install3 new file mode 100755 index 000000000..31e96c866 --- /dev/null +++ b/venv/bin/easy_install3 @@ -0,0 +1,8 @@ +#!/home/roopapk/vscode/student/venv/bin/python +# -*- coding: utf-8 -*- +import re +import sys +from setuptools.command.easy_install import main +if __name__ == '__main__': + sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0]) + sys.exit(main()) diff --git a/venv/bin/pip b/venv/bin/pip new file mode 100755 index 000000000..6cce5e156 --- /dev/null +++ b/venv/bin/pip @@ -0,0 +1,8 @@ +#!/home/roopapk/vscode/student/venv/bin/python +# -*- coding: utf-8 -*- +import re +import sys +from pip._internal.cli.main import main +if __name__ == '__main__': + sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0]) + sys.exit(main()) diff --git a/venv/bin/pip-3.8 b/venv/bin/pip-3.8 new file mode 100755 index 000000000..6cce5e156 --- /dev/null +++ b/venv/bin/pip-3.8 @@ -0,0 +1,8 @@ +#!/home/roopapk/vscode/student/venv/bin/python +# -*- coding: utf-8 -*- +import re +import sys +from pip._internal.cli.main import main +if __name__ == '__main__': + sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0]) + sys.exit(main()) diff --git a/venv/bin/pip3 b/venv/bin/pip3 new file mode 100755 index 000000000..6cce5e156 --- /dev/null +++ b/venv/bin/pip3 @@ -0,0 +1,8 @@ +#!/home/roopapk/vscode/student/venv/bin/python +# -*- coding: utf-8 -*- +import re +import sys +from pip._internal.cli.main import main +if __name__ == '__main__': + sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0]) + sys.exit(main()) diff --git a/venv/bin/pip3.8 b/venv/bin/pip3.8 new file mode 100755 index 000000000..6cce5e156 --- /dev/null +++ b/venv/bin/pip3.8 @@ -0,0 +1,8 @@ +#!/home/roopapk/vscode/student/venv/bin/python +# -*- coding: utf-8 -*- +import re +import sys +from pip._internal.cli.main import main +if __name__ == '__main__': + sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0]) + sys.exit(main()) diff --git a/venv/bin/python b/venv/bin/python new file mode 120000 index 000000000..ae65fdaa1 --- /dev/null +++ b/venv/bin/python @@ -0,0 +1 @@ +/usr/bin/python3 \ No newline at end of file diff --git a/venv/bin/python3 b/venv/bin/python3 new file mode 120000 index 000000000..d8654aa0e --- /dev/null +++ b/venv/bin/python3 @@ -0,0 +1 @@ +python \ No newline at end of file diff --git a/venv/bin/python3.8 b/venv/bin/python3.8 new file mode 120000 index 000000000..d8654aa0e --- /dev/null +++ b/venv/bin/python3.8 @@ -0,0 +1 @@ +python \ No newline at end of file diff --git a/venv/bin/wheel b/venv/bin/wheel new file mode 100755 index 000000000..0178fd296 --- /dev/null +++ b/venv/bin/wheel @@ -0,0 +1,8 @@ +#!/home/roopapk/vscode/student/venv/bin/python +# -*- coding: utf-8 -*- +import re +import sys +from wheel.cli import main +if __name__ == '__main__': + sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0]) + sys.exit(main()) diff --git a/venv/bin/wheel-3.8 b/venv/bin/wheel-3.8 new file mode 100755 index 000000000..0178fd296 --- /dev/null +++ b/venv/bin/wheel-3.8 @@ -0,0 +1,8 @@ +#!/home/roopapk/vscode/student/venv/bin/python +# -*- coding: utf-8 -*- +import re +import sys +from wheel.cli import main +if __name__ == '__main__': + sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0]) + sys.exit(main()) diff --git a/venv/bin/wheel3 b/venv/bin/wheel3 new file mode 100755 index 000000000..0178fd296 --- /dev/null +++ b/venv/bin/wheel3 @@ -0,0 +1,8 @@ +#!/home/roopapk/vscode/student/venv/bin/python +# -*- coding: utf-8 -*- +import re +import sys +from wheel.cli import main +if __name__ == '__main__': + sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0]) + sys.exit(main()) diff --git a/venv/lib/python3.8/site-packages/__pycache__/_virtualenv.cpython-38.pyc b/venv/lib/python3.8/site-packages/__pycache__/_virtualenv.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d1c04b3e3fe12f2eb46fedb6e19e9516a169f2f3 GIT binary patch literal 3966 zcmZu!OOxBi5uO1+5ae=KtJNbb$qz(H#b(MPD^V#?R2!9LONvybY&n)}DM(TX78owE z1Oa+xs0V{Rt*Y!?oJ)==*UC95$NY*M@(XayNq-@i6e_)BJ3C zxy?{MYBTZv8e{*Vm!qYDmk&`@g(hJEOL$^sJmBVO1(x7D_P!$;FL>Z4cH%r|K{IIt zp0IXWi92%SR~XsM+T*2QiPLN^>x`F!Wh1w;mGOz-gpu3X>iA@ElCxj2WGU%9XGupa z?b*Q^RywtRI^kk%kG-%s%Qvyga&~5XHaKf$u4LaEuLtYnbHO!o73{+{V@{8GvGBC#RrwG~w!?P#pV^meVC?tY+vO#v z-jF9Yv~Z$zEYS8*Zl+34b($$Z%Ch2#@~28j+CMJxLApJKeyV^*k=&lr{t8M(esu6T z(rJ8M*SR z=Gr2#>c)=yf)CJ}SQ{*{Z?ZpJ+-)SzezOFOciqx8<2OoY-z(k3fbNTpk{s07teSIs zRqjLz=-6!p%?aF*rCSiPNE=}&qC`j)G*v9qiB^@9L^_(a=aa)f?RHziiEW|7VnUt@ zlQh=Vna}Tj`rxx0_ik-|9)5D;!N+&P+jsBXs;mO@Cy^dj&1g#*!B)?dByd&kppfH8 zSN5csbeol6tiL|A(|G%kM0 z{(G-KgopdGC??Tl)PJnvA`yLHG6C57kAeI?4%)Agbh&r6uTm{8O`>=dZ41>8=OKb| zKwGu;`W~mraiAQ=_$qH(9zV-H-bP*FvmfD%@enpqy0?)Pag?d+z1Nr6>{>yG0!5}< zh?OFjXRsVP9hzxg+D6ibRr_#dB0lA!VV-AoI`S-}t~FaZ0Dq69*$E}|bfSwQ zQ>LS9y&}86a%ecOR(>sX^a*@(o8m{Jr!{~Ss)>m4;@m6Z5uQzGuhS@tG3!{NwLU~u z8)yUrv9iEQcwi?uhG^_D&}z#ND-W8&OB#v$obBM2gL6t>zMAgf!naWR{L6h1B4=gM<6yBAFu6H)A^FqO>58%|1p||3*`C%@9}r z0)av6k!K|9FaO~9Qi9TEf7Lc5YtPzs5NmAIlK<3@b{YvsU!!cuI|_XAfC^+F^QW)RuqajQ)Pha_bQ* zormn(wTH}NSJ-dZr|j?SKE__bB}TeEGBWi)LJuO_-mI3yQxS*t*{h|jh?4nBw^OZ# zH}Bqm@Y#dA_wLt`S$TtLmgUh{R1Oe2lILNOsyU2Qq_wPEnl5D3M2J&|dVKhmD)?k{)p;5s` z99Is#*MK*uC%_xEE<;ck(J;P-0CTxTfo63${jH+M;_C=Im#r$9y04ozWLIwywGSFhSJB3d7#N3L$2J~+~3ujR=$H; z$0x|4&1a_;njLY|G2JMX-k{qqE`%exSw>sj`SJsdmzU6V?OGX!Y$^NHZ47v5MRMFG zs`AhFnq&hZn5RVNI;K*m5D;H?>kxQAg6t!+#FHqP_MT!i%y_c(Rkdk9PV1}Gw^T2;*!3CdzOqVYeRRfYU%EHf`5v6 zS+yYDGf<5&_*fxxeu!#Pmjh;U6DzTw6F)T*Cuu-(5{~%ss#D?Tby@_@U#!1*%t7QF zViW@&I;&>;Ug+}6d*_JVgP>) zeZNOlhPwzjZ@odW-eSF&j=3l#lZTChA3>N?-1V8Sky;FpK$LvnrnDll&M~64Z>+CD zCHHYI?SO(dj#AKqSa|Q%|4_OOga7K}5q)ag%PZKcYAEEJ+V}^~sp-J}4jp{=v^4RL zsESyFnNapkD9_$Kvdh99bx_Zd0HET(VX!KHg4yz?)R6s*K1a4X1l(18{T-^YF2d50 z)Dxo~D`ZG2>W63!umhvv=Yeg~U;3%w1TvOQ}bxIt=Z;X*Y0gGFK^BFVhgpu_R>=^@Zl_6lqQYO-{gq (3, 4): + # https://docs.python.org/3/library/importlib.html#setting-up-an-importer + from importlib.abc import MetaPathFinder + from importlib.util import find_spec + from threading import Lock + from functools import partial + + class _Finder(MetaPathFinder): + """A meta path finder that allows patching the imported distutils modules""" + + fullname = None + lock = Lock() + + def find_spec(self, fullname, path, target=None): + if fullname in _DISTUTILS_PATCH and self.fullname is None: + with self.lock: + self.fullname = fullname + try: + spec = find_spec(fullname, path) + if spec is not None: + # https://www.python.org/dev/peps/pep-0451/#how-loading-will-work + is_new_api = hasattr(spec.loader, "exec_module") + func_name = "exec_module" if is_new_api else "load_module" + old = getattr(spec.loader, func_name) + func = self.exec_module if is_new_api else self.load_module + if old is not func: + try: + setattr(spec.loader, func_name, partial(func, old)) + except AttributeError: + pass # C-Extension loaders are r/o such as zipimporter with =2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.* + +pip - The Python Package Installer +================================== + +.. image:: https://img.shields.io/pypi/v/pip.svg + :target: https://pypi.org/project/pip/ + +.. image:: https://readthedocs.org/projects/pip/badge/?version=latest + :target: https://pip.pypa.io/en/latest + +pip is the `package installer`_ for Python. You can use pip to install packages from the `Python Package Index`_ and other indexes. + +Please take a look at our documentation for how to install and use pip: + +* `Installation`_ +* `Usage`_ + +Updates are released regularly, with a new version every 3 months. More details can be found in our documentation: + +* `Release notes`_ +* `Release process`_ + +If you find bugs, need help, or want to talk to the developers please use our mailing lists or chat rooms: + +* `Issue tracking`_ +* `Discourse channel`_ +* `User IRC`_ + +If you want to get involved head over to GitHub to get the source code, look at our development documentation and feel free to jump on the developer mailing lists and chat rooms: + +* `GitHub page`_ +* `Dev documentation`_ +* `Dev mailing list`_ +* `Dev IRC`_ + +Code of Conduct +--------------- + +Everyone interacting in the pip project's codebases, issue trackers, chat +rooms, and mailing lists is expected to follow the `PyPA Code of Conduct`_. + +.. _package installer: https://packaging.python.org/guides/tool-recommendations/ +.. _Python Package Index: https://pypi.org +.. _Installation: https://pip.pypa.io/en/stable/installing.html +.. _Usage: https://pip.pypa.io/en/stable/ +.. _Release notes: https://pip.pypa.io/en/stable/news.html +.. _Release process: https://pip.pypa.io/en/latest/development/release-process/ +.. _GitHub page: https://github.com/pypa/pip +.. _Dev documentation: https://pip.pypa.io/en/latest/development +.. _Issue tracking: https://github.com/pypa/pip/issues +.. _Discourse channel: https://discuss.python.org/c/packaging +.. _Dev mailing list: https://groups.google.com/forum/#!forum/pypa-dev +.. _User IRC: https://webchat.freenode.net/?channels=%23pypa +.. _Dev IRC: https://webchat.freenode.net/?channels=%23pypa-dev +.. _PyPA Code of Conduct: https://www.pypa.io/en/latest/code-of-conduct/ + + diff --git a/venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/RECORD b/venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/RECORD new file mode 100644 index 000000000..ea240f765 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/RECORD @@ -0,0 +1,264 @@ +pip/__init__.py,sha256=U1AM82iShMaw90K6Yq0Q2-AZ1EsOcqQLQRB-rxwFtII,455 +pip/__main__.py,sha256=NM95x7KuQr-lwPoTjAC0d_QzLJsJjpmAoxZg0mP8s98,632 +pip/_internal/__init__.py,sha256=j5fiII6yCeZjpW7_7wAVRMM4DwE-gyARGVU4yAADDeE,517 +pip/_internal/build_env.py,sha256=--aNgzIdYrCOclHMwoAdpclCpfdFE_jooRuCy5gczwg,7532 +pip/_internal/cache.py,sha256=16GrnDRLBQNlfKWIuIF6Sa-EFS78kez_w1WEjT3ykTI,11605 +pip/_internal/configuration.py,sha256=MgKrLFBJBkF3t2VJM4tvlnEspfSuS4scp_LhHWh53nY,14222 +pip/_internal/exceptions.py,sha256=6YRuwXAK6F1iyUWKIkCIpWWN2khkAn1sZOgrFA9S8Ro,10247 +pip/_internal/legacy_resolve.py,sha256=L7R72I7CjVgJlPTggmA1j4b-H8NmxNu_dKVhrpGXGps,16277 +pip/_internal/locations.py,sha256=VifFEqhc7FWFV8QGoEM3CpECRY8Doq7kTytytxsEgx0,6734 +pip/_internal/main.py,sha256=IVBnUQ-FG7DK6617uEXRB5_QJqspAsBFmTmTesYkbdQ,437 +pip/_internal/pep425tags.py,sha256=SlIQokevkoKnXhoK3PZvXiDoj8hFKoJ7thDifDtga3k,5490 +pip/_internal/pyproject.py,sha256=VJKsrXORGiGoDPVKCQhuu4tWlQSTOhoiRlVLRNu4rx4,7400 +pip/_internal/self_outdated_check.py,sha256=3KO1pTJUuYaiV9X0t87I9PimkGL82HbhLWbocqKZpBU,8009 +pip/_internal/wheel_builder.py,sha256=gr9jE14W5ZuYblpldo-tpRuyG0e0AVmHLttImuAvXlE,9441 +pip/_internal/cli/__init__.py,sha256=FkHBgpxxb-_gd6r1FjnNhfMOzAUYyXoXKJ6abijfcFU,132 +pip/_internal/cli/autocompletion.py,sha256=ekGNtcDI0p7rFVc-7s4T9Tbss4Jgb7vsB649XJIblRg,6547 +pip/_internal/cli/base_command.py,sha256=v6yl5XNRqye8BT9ep8wvpMu6lylP_Hu6D95r_HqbpbQ,7948 +pip/_internal/cli/cmdoptions.py,sha256=f1TVHuu_fR3lLlMo6b367H_GsWFv26tLI9cAS-kZfE0,28114 +pip/_internal/cli/command_context.py,sha256=ygMVoTy2jpNilKT-6416gFSQpaBtrKRBbVbi2fy__EU,975 +pip/_internal/cli/main.py,sha256=8iq3bHe5lxJTB2EvKOqZ38NS0MmoS79_S1kgj4QuH8A,2610 +pip/_internal/cli/main_parser.py,sha256=W9OWeryh7ZkqELohaFh0Ko9sB98ZkSeDmnYbOZ1imBc,2819 +pip/_internal/cli/parser.py,sha256=O9djTuYQuSfObiY-NU6p4MJCfWsRUnDpE2YGA_fwols,9487 +pip/_internal/cli/req_command.py,sha256=pAUAglpTn0mUA6lRs7KN71yOm1KDabD0ySVTQTqWTSA,12463 +pip/_internal/cli/status_codes.py,sha256=F6uDG6Gj7RNKQJUDnd87QKqI16Us-t-B0wPF_4QMpWc,156 +pip/_internal/commands/__init__.py,sha256=uTSj58QlrSKeXqCUSdL-eAf_APzx5BHy1ABxb0j5ZNE,3714 +pip/_internal/commands/check.py,sha256=mgLNYT3bd6Kmynwh4zzcBmVlFZ-urMo40jTgk6U405E,1505 +pip/_internal/commands/completion.py,sha256=UFQvq0Q4_B96z1bvnQyMOq82aPSu05RejbLmqeTZjC0,2975 +pip/_internal/commands/configuration.py,sha256=6riioZjMhsNSEct7dE-X8SobGodk3WERKJvuyjBje4Q,7226 +pip/_internal/commands/debug.py,sha256=a8llax2hRkxgK-tvwdJgaCaZCYPIx0fDvrlMDoYr8bQ,4209 +pip/_internal/commands/download.py,sha256=zX_0-IeFb4C8dxSmGHxk-6H5kehtyTSsdWpjNpAhSww,5007 +pip/_internal/commands/freeze.py,sha256=QS-4ib8jbKJ2wrDaDbTuyaB3Y_iJ5CQC2gAVHuAv9QU,3481 +pip/_internal/commands/hash.py,sha256=47teimfAPhpkaVbSDaafck51BT3XXYuL83lAqc5lOcE,1735 +pip/_internal/commands/help.py,sha256=Nhecq--ydFn80Gm1Zvbf9943EcRJfO0TnXUhsF0RO7s,1181 +pip/_internal/commands/install.py,sha256=T4P3J1rw7CQrZX4OUamtcoWMkTrJBfUe6gWpTfZW1bQ,27286 +pip/_internal/commands/list.py,sha256=2l0JiqHxjxDHNTCb2HZOjwwdo4duS1R0MsqZb6HSMKk,10660 +pip/_internal/commands/search.py,sha256=7Il8nKZ9mM7qF5jlnBoPvSIFY9f-0-5IbYoX3miTuZY,5148 +pip/_internal/commands/show.py,sha256=Vzsj2oX0JBl94MPyF3LV8YoMcigl8B2UsMM8zp0pH2s,6792 +pip/_internal/commands/uninstall.py,sha256=8mldFbrQecSoWDZRqxBgJkrlvx6Y9Iy7cs-2BIgtXt4,2983 +pip/_internal/commands/wheel.py,sha256=TMU5ZhjLo7BIZQApGPsYfoCsbGTnvP-N9jkgPJXhj1Y,7170 +pip/_internal/distributions/__init__.py,sha256=ECBUW5Gtu9TjJwyFLvim-i6kUMYVuikNh9I5asL6tbA,959 +pip/_internal/distributions/base.py,sha256=ruprpM_L2T2HNi3KLUHlbHimZ1sWVw-3Q0Lb8O7TDAI,1425 +pip/_internal/distributions/installed.py,sha256=YqlkBKr6TVP1MAYS6SG8ojud21wVOYLMZ8jMLJe9MSU,760 +pip/_internal/distributions/sdist.py,sha256=D4XTMlCwgPlK69l62GLYkNSVTVe99fR5iAcVt2EbGok,4086 +pip/_internal/distributions/wheel.py,sha256=95uD-TfaYoq3KiKBdzk9YMN4RRqJ28LNoSTS2K46gek,1294 +pip/_internal/index/__init__.py,sha256=vpt-JeTZefh8a-FC22ZeBSXFVbuBcXSGiILhQZJaNpQ,30 +pip/_internal/index/collector.py,sha256=YS7Ix4oylU7ZbPTPFugh-244GSRqMvdHsGUG6nmz2gE,17892 +pip/_internal/index/package_finder.py,sha256=2Rg75AOpLj8BN1jyL8EI-Iw-Hv6ibJkrYVARCht3bX8,37542 +pip/_internal/models/__init__.py,sha256=3DHUd_qxpPozfzouoqa9g9ts1Czr5qaHfFxbnxriepM,63 +pip/_internal/models/candidate.py,sha256=Y58Bcm6oXUj0iS-yhmerlGo5CQJI2p0Ww9h6hR9zQDw,1150 +pip/_internal/models/format_control.py,sha256=ICzVjjGwfZYdX-eLLKHjMHLutEJlAGpfj09OG_eMqac,2673 +pip/_internal/models/index.py,sha256=K59A8-hVhBM20Xkahr4dTwP7OjkJyEqXH11UwHFVgqM,1060 +pip/_internal/models/link.py,sha256=y0H2ZOk0P6d1lfGUL2Pl09xFgZcRt5HwN2LElMifOpI,6827 +pip/_internal/models/scheme.py,sha256=vvhBrrno7eVDXcdKHiZWwxhPHf4VG5uSCEkC0QDR2RU,679 +pip/_internal/models/search_scope.py,sha256=2LXbU4wV8LwqdtXQXNXFYKv-IxiDI_QwSz9ZgbwtAfk,3898 +pip/_internal/models/selection_prefs.py,sha256=rPeif2KKjhTPXeMoQYffjqh10oWpXhdkxRDaPT1HO8k,1908 +pip/_internal/models/target_python.py,sha256=c-cFi6zCuo5HYbXNS3rVVpKRaHVh5yQlYEjEW23SidQ,3799 +pip/_internal/models/wheel.py,sha256=UQJyd3V1TTTcFLrsOXHKpoxO5PJfPaIC9y9NbOLNfvc,2791 +pip/_internal/network/__init__.py,sha256=jf6Tt5nV_7zkARBrKojIXItgejvoegVJVKUbhAa5Ioc,50 +pip/_internal/network/auth.py,sha256=K3G1ukKb3PiH8w_UnpXTz8qQsTULO-qdbfOE9zTo1fE,11119 +pip/_internal/network/cache.py,sha256=51CExcRkXWrgMZ7WsrZ6cmijKfViD5tVgKbBvJHO1IE,2394 +pip/_internal/network/download.py,sha256=3D9vdJmVwmCUMxzC-TaVI_GvVOpQna3BLEYNPCSx3Fc,6260 +pip/_internal/network/session.py,sha256=u1IXQfv21R1xv86ulyiB58-be4sYm90eFB0Wp8fVMYw,14702 +pip/_internal/network/utils.py,sha256=iiixo1OeaQ3niUWiBjg59PN6f1w7vvTww1vFriTD_IU,1959 +pip/_internal/network/xmlrpc.py,sha256=AL115M3vFJ8xiHVJneb8Hi0ZFeRvdPhblC89w25OG5s,1597 +pip/_internal/operations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_internal/operations/check.py,sha256=a6uHG0daoWpmSPCdL7iYJaGQYZ-CRvPvTnCv2PnIIs0,5353 +pip/_internal/operations/freeze.py,sha256=td4BeRnW10EXFTZrx6VgygO3CrjqD5B9f0BGzjQm-Ew,10180 +pip/_internal/operations/prepare.py,sha256=ro2teBlbBpkRJhBKraP9CoJgVLpueSk62ziWhRToXww,20942 +pip/_internal/operations/build/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_internal/operations/build/metadata.py,sha256=yHMi5gHYXcXyHcvUPWHdO-UyOo3McFWljn_nHfM1O9c,1307 +pip/_internal/operations/build/metadata_legacy.py,sha256=4n6N7BTysqVmEpITzT2UVClyt0Peij_Im8Qm965IWB4,3957 +pip/_internal/operations/build/wheel.py,sha256=ntltdNP6D2Tpr4V0agssu6rE0F9LaBpJkYT6zSdhEbw,1469 +pip/_internal/operations/build/wheel_legacy.py,sha256=DYSxQKutwSZnmNvWkwsl2HzE2XQBxV0i0wTphjtUe90,3349 +pip/_internal/operations/install/__init__.py,sha256=mX7hyD2GNBO2mFGokDQ30r_GXv7Y_PLdtxcUv144e-s,51 +pip/_internal/operations/install/editable_legacy.py,sha256=rJ_xs2qtDUjpY2-n6eYlVyZiNoKbOtZXZrYrcnIELt4,1488 +pip/_internal/operations/install/legacy.py,sha256=eBV8gHbO9sBlBc-4nuR3Sd2nikHgEcnC9khfeLiypio,4566 +pip/_internal/operations/install/wheel.py,sha256=xdCjH6uIUyg39Pf8tUaMFUN4a7eozJAFMb_wKcgQlsY,23012 +pip/_internal/req/__init__.py,sha256=UVaYPlHZVGRBQQPjvGC_6jJDQtewXm0ws-8Lxhg_TiY,2671 +pip/_internal/req/constructors.py,sha256=w5-kWWVCqlSqcIBitw86yq7XGMPpKrHDfQZSE2mJ_xc,14388 +pip/_internal/req/req_file.py,sha256=ECqRUicCw5Y08R1YynZAAp8dSKQhDXoc1Q-mY3a9b6I,18485 +pip/_internal/req/req_install.py,sha256=wjsIr4lDpbVSLqANKJI9mXwRVHaRxcnj8q30UiHoLRA,30442 +pip/_internal/req/req_set.py,sha256=GsrKmupRKhNMhjkofVfCEHEHfgEvYBxClaQH5xLBQHg,8066 +pip/_internal/req/req_tracker.py,sha256=27fvVG8Y2MJS1KpU2rBMnQyUEMHG4lkHT_bzbzQK-c0,4723 +pip/_internal/req/req_uninstall.py,sha256=DWnOsuyYGju6-sylyoCm7GtUNevn9qMAVhjAGLcdXUE,23609 +pip/_internal/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_internal/utils/appdirs.py,sha256=PVo_7-IQWHa9qNuNbWSFiF2QGqeLbSAR4eLcYYhQ9ek,1307 +pip/_internal/utils/compat.py,sha256=D7FKGLBdQwWH-dHIGaoWMawDZWBYApvtJVL1kFPJ930,8869 +pip/_internal/utils/deprecation.py,sha256=pBnNogoA4UGTxa_JDnPXBRRYpKMbExAhXpBwAwklOBs,3318 +pip/_internal/utils/distutils_args.py,sha256=a56mblNxk9BGifbpEETG61mmBrqhjtjRkJ4HYn-oOEE,1350 +pip/_internal/utils/encoding.py,sha256=hxZz0t3Whw3d4MHQEiofxalTlfKwxFdLc8fpeGfhKo8,1320 +pip/_internal/utils/entrypoints.py,sha256=vHcNpnksCv6mllihU6hfifdsKPEjwcaJ1aLIXEaynaU,1152 +pip/_internal/utils/filesystem.py,sha256=PXa3vMcz4mbEKtkD0joFI8pBwddLQxhfPFOkVH5xjfE,5255 +pip/_internal/utils/filetypes.py,sha256=R2FwzoeX7b-rZALOXx5cuO8VPPMhUQ4ne7wm3n3IcWA,571 +pip/_internal/utils/glibc.py,sha256=LOeNGgawCKS-4ke9fii78fwXD73dtNav3uxz1Bf-Ab8,3297 +pip/_internal/utils/hashes.py,sha256=my-wSnAWEDvl_8rQaOQcVIWjwh1-f_QiEvGy9TPf53U,3942 +pip/_internal/utils/inject_securetransport.py,sha256=M17ZlFVY66ApgeASVjKKLKNz0LAfk-SyU0HZ4ZB6MmI,810 +pip/_internal/utils/logging.py,sha256=aJL7NldPhS5KGFof6Qt3o3MG5cjm5TOoo7bGRu9_wsg,13033 +pip/_internal/utils/marker_files.py,sha256=CO5djQlrPIozJpJybViH_insoAaBGY1aqEt6-cC-iW0,741 +pip/_internal/utils/misc.py,sha256=uIb58Hiu_g2HRORo2aMcgnW_7R5d-5wUAuoW0fA2ZME,26085 +pip/_internal/utils/models.py,sha256=IA0hw_T4awQzui0kqfIEASm5yLtgZAB08ag59Nip5G8,1148 +pip/_internal/utils/packaging.py,sha256=VtiwcAAL7LBi7tGL2je7LeW4bE11KMHGCsJ1NZY5XtM,3035 +pip/_internal/utils/pkg_resources.py,sha256=ZX-k7V5q_aNWyDse92nN7orN1aCpRLsaxzpkBZ1XKzU,1254 +pip/_internal/utils/setuptools_build.py,sha256=DouaVolV9olDDFIIN9IszaL-FHdNaZt10ufOZFH9ZAU,5070 +pip/_internal/utils/subprocess.py,sha256=Ph3x5eHQBxFotyGhpZN8asSMBud-BBkmgaNfARG-di8,9922 +pip/_internal/utils/temp_dir.py,sha256=87Ib8aNic_hoSDEmUYJHTQIn5-prL2AYL5u_yZ3s4sI,7768 +pip/_internal/utils/typing.py,sha256=xkYwOeHlf4zsHXBDC4310HtEqwhQcYXFPq2h35Tcrl0,1401 +pip/_internal/utils/ui.py,sha256=0FNxXlGtbpPtTviv2oXS9t8bQG_NBdfUgP4GbubhS9U,13911 +pip/_internal/utils/unpacking.py,sha256=M944JTSiapBOSKLWu7lbawpVHSE7flfzZTEr3TAG7v8,9438 +pip/_internal/utils/urls.py,sha256=aNV9wq5ClUmrz6sG-al7hEWJ4ToitOy7l82CmFGFNW8,1481 +pip/_internal/utils/virtualenv.py,sha256=Q3S1WPlI7JWpGOT2jUVJ8l2chm_k7VPJ9cHA_cUluEU,3396 +pip/_internal/utils/wheel.py,sha256=grTRwZtMQwApwbbSPmRVLtac6FKy6SVKeCXNkWyyePA,7302 +pip/_internal/vcs/__init__.py,sha256=viJxJRqRE_mVScum85bgQIXAd6o0ozFt18VpC-qIJrM,617 +pip/_internal/vcs/bazaar.py,sha256=84q1-kj1_nJ9AMzMu8RmMp-riRZu81M7K9kowcYgi3U,3957 +pip/_internal/vcs/git.py,sha256=CdLz3DTsZsLMLPZpEuUwiS40npvDaVB1CNRzoXgcuJQ,14352 +pip/_internal/vcs/mercurial.py,sha256=2mg7BdYI_Fe00fF6omaNccFQLPHBsDBG5CAEzvqn5sA,5110 +pip/_internal/vcs/subversion.py,sha256=Fpwy71AmuqXnoKi6h1SrXRtPjEMn8fieuM1O4j01IBg,12292 +pip/_internal/vcs/versioncontrol.py,sha256=nqoaM1_rzx24WnHtihXA8RcPpnUae0sV2sR_LS_5HFA,22600 +pip/_vendor/__init__.py,sha256=RcHf8jwLPL0ZEaa6uMhTSfyCrA_TpWgDWAW5br9xD7Y,4975 +pip-20.0.2.dist-info/LICENSE.txt,sha256=W6Ifuwlk-TatfRU2LR7W1JMcyMj5_y1NkRkOEJvnRDE,1090 +pip-20.0.2.dist-info/METADATA,sha256=MSgjT2JTt8usp4Hopp5AGEmc-7sKR2Jd7HTMJqCoRhw,3352 +pip-20.0.2.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110 +pip-20.0.2.dist-info/entry_points.txt,sha256=HtfDOwpUlr9s73jqLQ6wF9V0_0qvUXJwCBz7Vwx0Ue0,125 +pip-20.0.2.dist-info/top_level.txt,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +pip-20.0.2.dist-info/RECORD,, +pip/_internal/network/download.cpython-38.pyc,, +../../../bin/pip,, +pip/_internal/index/package_finder.cpython-38.pyc,, +pip/_internal/models/search_scope.cpython-38.pyc,, +pip/_internal/commands/__init__.cpython-38.pyc,, +pip/_internal/pep425tags.cpython-38.pyc,, +pip/_internal/commands/check.cpython-38.pyc,, +pip/_internal/cli/base_command.cpython-38.pyc,, +pip/_internal/distributions/wheel.cpython-38.pyc,, +pip/_internal/cli/autocompletion.cpython-38.pyc,, +pip/_internal/network/__init__.cpython-38.pyc,, +pip/_internal/utils/logging.cpython-38.pyc,, +pip/_internal/utils/distutils_args.cpython-38.pyc,, +pip/_internal/commands/__pycache__,, +pip/_internal/network/utils.cpython-38.pyc,, +pip/_internal/utils/setuptools_build.cpython-38.pyc,, +../../../bin/pip3,, +pip/_internal/operations/build/__init__.cpython-38.pyc,, +pip/_internal/models/__pycache__,, +pip-20.0.2.virtualenv,, +pip/_internal/legacy_resolve.cpython-38.pyc,, +pip/_internal/utils/encoding.cpython-38.pyc,, +pip/_internal/commands/uninstall.cpython-38.pyc,, +pip/_internal/cli/command_context.cpython-38.pyc,, +pip/_internal/network/__pycache__,, +pip/_internal/cache.cpython-38.pyc,, +pip/_internal/commands/debug.cpython-38.pyc,, +pip/_internal/operations/build/__pycache__,, +pip/_internal/commands/help.cpython-38.pyc,, +pip/_internal/utils/hashes.cpython-38.pyc,, +pip/_internal/distributions/base.cpython-38.pyc,, +pip-20.0.2.dist-info/INSTALLER,, +pip/_internal/cli/__init__.cpython-38.pyc,, +pip/_internal/cli/cmdoptions.cpython-38.pyc,, +pip/_internal/commands/hash.cpython-38.pyc,, +pip/_internal/utils/glibc.cpython-38.pyc,, +pip/_internal/req/req_file.cpython-38.pyc,, +pip/_internal/commands/configuration.cpython-38.pyc,, +pip/_internal/req/__init__.cpython-38.pyc,, +pip/_internal/wheel_builder.cpython-38.pyc,, +pip/_internal/__init__.cpython-38.pyc,, +pip/_internal/utils/models.cpython-38.pyc,, +pip/_internal/req/req_set.cpython-38.pyc,, +pip/_internal/cli/__pycache__,, +pip/_internal/req/req_uninstall.cpython-38.pyc,, +pip/_internal/distributions/sdist.cpython-38.pyc,, +pip/_internal/req/__pycache__,, +pip/_internal/utils/misc.cpython-38.pyc,, +pip/__init__.cpython-38.pyc,, +pip/_internal/utils/pkg_resources.cpython-38.pyc,, +pip/_internal/models/target_python.cpython-38.pyc,, +pip/_internal/__pycache__,, +pip/_internal/models/wheel.cpython-38.pyc,, +pip/_internal/operations/install/wheel.cpython-38.pyc,, +pip/_internal/index/collector.cpython-38.pyc,, +pip/_internal/utils/virtualenv.cpython-38.pyc,, +pip/_internal/req/constructors.cpython-38.pyc,, +pip/_internal/cli/main.cpython-38.pyc,, +pip/_internal/distributions/__init__.cpython-38.pyc,, +pip/_internal/exceptions.cpython-38.pyc,, +pip/_internal/utils/__init__.cpython-38.pyc,, +pip/__pycache__,, +pip/_internal/utils/urls.cpython-38.pyc,, +pip/_internal/main.cpython-38.pyc,, +pip/_internal/operations/build/wheel.cpython-38.pyc,, +pip/_internal/commands/install.cpython-38.pyc,, +pip/_internal/operations/install/editable_legacy.cpython-38.pyc,, +pip/_internal/req/req_install.cpython-38.pyc,, +pip/_internal/utils/entrypoints.cpython-38.pyc,, +pip/_internal/models/scheme.cpython-38.pyc,, +pip/_internal/distributions/__pycache__,, +../../../bin/pip3.8,, +pip/_internal/configuration.cpython-38.pyc,, +pip/_internal/utils/__pycache__,, +pip/_internal/self_outdated_check.cpython-38.pyc,, +pip/_internal/utils/inject_securetransport.cpython-38.pyc,, +pip/_internal/models/link.cpython-38.pyc,, +pip/_internal/operations/build/metadata.cpython-38.pyc,, +pip/_internal/distributions/installed.cpython-38.pyc,, +pip/_internal/vcs/versioncontrol.cpython-38.pyc,, +pip/_internal/utils/filesystem.cpython-38.pyc,, +pip/_internal/operations/build/metadata_legacy.cpython-38.pyc,, +../../../bin/pip-3.8,, +pip/_internal/vcs/__init__.cpython-38.pyc,, +pip/_internal/locations.cpython-38.pyc,, +pip/_internal/utils/compat.cpython-38.pyc,, +pip/_internal/commands/wheel.cpython-38.pyc,, +pip/_internal/utils/filetypes.cpython-38.pyc,, +pip/_internal/operations/install/legacy.cpython-38.pyc,, +pip/_internal/utils/packaging.cpython-38.pyc,, +pip/_internal/utils/appdirs.cpython-38.pyc,, +pip/_internal/req/req_tracker.cpython-38.pyc,, +pip/_internal/operations/check.cpython-38.pyc,, +pip/_internal/cli/req_command.cpython-38.pyc,, +pip/_internal/network/session.cpython-38.pyc,, +pip/_internal/vcs/__pycache__,, +pip/_internal/models/candidate.cpython-38.pyc,, +pip/_internal/commands/show.cpython-38.pyc,, +pip/_internal/network/auth.cpython-38.pyc,, +pip/_vendor/__init__.cpython-38.pyc,, +pip/_internal/commands/search.cpython-38.pyc,, +pip/_internal/models/index.cpython-38.pyc,, +pip/_internal/commands/list.cpython-38.pyc,, +pip/_internal/utils/temp_dir.cpython-38.pyc,, +pip/_internal/commands/completion.cpython-38.pyc,, +pip/_internal/cli/parser.cpython-38.pyc,, +pip/_internal/vcs/git.cpython-38.pyc,, +pip-20.0.2.dist-info/__pycache__,, +pip/_internal/utils/wheel.cpython-38.pyc,, +pip/_internal/utils/marker_files.cpython-38.pyc,, +pip/_internal/models/__init__.cpython-38.pyc,, +pip/_internal/network/xmlrpc.cpython-38.pyc,, +pip/_internal/vcs/subversion.cpython-38.pyc,, +pip/_internal/operations/install/__init__.cpython-38.pyc,, +pip/_internal/operations/prepare.cpython-38.pyc,, +pip/_internal/vcs/bazaar.cpython-38.pyc,, +pip/_internal/utils/typing.cpython-38.pyc,, +pip/_vendor/__pycache__,, +pip/_internal/vcs/mercurial.cpython-38.pyc,, +pip/_internal/operations/freeze.cpython-38.pyc,, +pip/_internal/build_env.cpython-38.pyc,, +pip/_internal/operations/install/__pycache__,, +pip/_internal/pyproject.cpython-38.pyc,, +pip/_internal/index/__init__.cpython-38.pyc,, +pip/_internal/models/format_control.cpython-38.pyc,, +pip/_internal/operations/__init__.cpython-38.pyc,, +pip/_internal/models/selection_prefs.cpython-38.pyc,, +pip/_internal/utils/ui.cpython-38.pyc,, +pip/_internal/commands/download.cpython-38.pyc,, +pip/_internal/commands/freeze.cpython-38.pyc,, +pip/_internal/utils/subprocess.cpython-38.pyc,, +pip/_internal/cli/status_codes.cpython-38.pyc,, +pip/_internal/utils/unpacking.cpython-38.pyc,, +pip/_internal/cli/main_parser.cpython-38.pyc,, +pip/_internal/operations/build/wheel_legacy.cpython-38.pyc,, +pip/__main__.cpython-38.pyc,, +pip/_internal/index/__pycache__,, +pip/_internal/network/cache.cpython-38.pyc,, +pip/_internal/utils/deprecation.cpython-38.pyc,, +pip/_internal/operations/__pycache__,, \ No newline at end of file diff --git a/venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/WHEEL b/venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/WHEEL new file mode 100644 index 000000000..ef99c6cf3 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/WHEEL @@ -0,0 +1,6 @@ +Wheel-Version: 1.0 +Generator: bdist_wheel (0.34.2) +Root-Is-Purelib: true +Tag: py2-none-any +Tag: py3-none-any + diff --git a/venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/entry_points.txt b/venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/entry_points.txt new file mode 100644 index 000000000..d48bd8a85 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/entry_points.txt @@ -0,0 +1,5 @@ +[console_scripts] +pip = pip._internal.cli.main:main +pip3 = pip._internal.cli.main:main +pip3.8 = pip._internal.cli.main:main + diff --git a/venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/top_level.txt b/venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/top_level.txt new file mode 100644 index 000000000..a1b589e38 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/top_level.txt @@ -0,0 +1 @@ +pip diff --git a/venv/lib/python3.8/site-packages/pip-20.0.2.virtualenv b/venv/lib/python3.8/site-packages/pip-20.0.2.virtualenv new file mode 100644 index 000000000..e69de29bb diff --git a/venv/lib/python3.8/site-packages/pip/__init__.py b/venv/lib/python3.8/site-packages/pip/__init__.py new file mode 100644 index 000000000..827a4e20a --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/__init__.py @@ -0,0 +1,18 @@ +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import List, Optional + + +__version__ = "20.0.2" + + +def main(args=None): + # type: (Optional[List[str]]) -> int + """This is an internal API only meant for use by pip's own console scripts. + + For additional details, see https://github.com/pypa/pip/issues/7498. + """ + from pip._internal.utils.entrypoints import _wrapper + + return _wrapper(args) diff --git a/venv/lib/python3.8/site-packages/pip/__main__.py b/venv/lib/python3.8/site-packages/pip/__main__.py new file mode 100644 index 000000000..e83b9e056 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/__main__.py @@ -0,0 +1,19 @@ +from __future__ import absolute_import + +import os +import sys + +# If we are running from a wheel, add the wheel to sys.path +# This allows the usage python pip-*.whl/pip install pip-*.whl +if __package__ == '': + # __file__ is pip-*.whl/pip/__main__.py + # first dirname call strips of '/__main__.py', second strips off '/pip' + # Resulting path is the name of the wheel itself + # Add that to sys.path so we can import pip + path = os.path.dirname(os.path.dirname(__file__)) + sys.path.insert(0, path) + +from pip._internal.cli.main import main as _main # isort:skip # noqa + +if __name__ == '__main__': + sys.exit(_main()) diff --git a/venv/lib/python3.8/site-packages/pip/__pycache__/__init__.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/__pycache__/__init__.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..7dde240ac82888f854d90d1a5c0ac5ffe6e26dbc GIT binary patch literal 658 zcmZuv&2H2%5Vn)-4@)Z{#EA>Op-2!{3laq(1g!X}pi2ex&|EBU>~5?kwq-k8r79{H)V;^pBPY~Gi36kG2LO&w7Y$<@J;C>20Ab}gy z;u2#du_J(!CTY_$ZL>1NNTlUJjKn|;zuAV6h|15#8=reGC1A@TN7j%3A9q0HQea6r! zJ^T8xR-VA(nkXHl14i=fV2>Ex^rV$s2Xbs2>AWP1o>*mXdty#Csf_lfk;GR{+2D)G zgn+$-qg)7eA&m$bxN7_z;-w^Y2-ZKMbg4q!EsDyt)b^HB;H1j?PI~&_{=?m3L*(Mm zzzD|d)NyO2%aigJoGjR1l|>hTx{x}!-WteyH;6SbAnukI;2Uxy$o<-(n}X_WIg-?;xloPpuEc1N;(hM$=HTzqxw=9$GY+3)`+f= QPvU5NOl>6@zLsX`ZzU(I(f|Me literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/__pycache__/__main__.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/__pycache__/__main__.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b7119efac648ba8c3ed14cd78b6e0e417e7b6b2f GIT binary patch literal 451 zcmYjMyH3L}6t$hC4QWdm5dYADcwk{b2r;n1f>^RxX?;uGI+X&&hdSlObQgvV}W2t5c-P6|C5E{AzZr-z!Aq1HMqh!=0uW;^f9RtNO`g$ z<_X9;I}A=ZJmMp+GDt!%=LoVR>6xiKYl>=w5sY~jSW8F_6BvDfMT(fXXR7#W+LR|R9s&UFSDGhq?riLySid+SGx>3XrL-^0kK zx^^o+1cYr(kcN()^w(K-k(WVw){j2#E7brsO6gi}=+-V22Wnl%p>=c%?UqV0r+V*Js=X<1sTB^cPam{2xYNI_O1<~_ aU88s>;T{JEdl6tva-64mc8SkP%zpu97k#n- literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/__init__.py b/venv/lib/python3.8/site-packages/pip/_internal/__init__.py new file mode 100644 index 000000000..3aa8a4693 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/__init__.py @@ -0,0 +1,18 @@ +#!/usr/bin/env python +import pip._internal.utils.inject_securetransport # noqa +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import Optional, List + + +def main(args=None): + # type: (Optional[List[str]]) -> int + """This is preserved for old console scripts that may still be referencing + it. + + For additional details, see https://github.com/pypa/pip/issues/7498. + """ + from pip._internal.utils.entrypoints import _wrapper + + return _wrapper(args) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/__pycache__/__init__.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/__pycache__/__init__.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..be0d257ee4e27cfe51ea8e9732b55e1f0ec5c46a GIT binary patch literal 707 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 OMN27HS*rd-JM#w|L3^|S literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/__pycache__/configuration.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/__pycache__/configuration.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ad899baee537ba6cecdaffed2708395c4adb0d38 GIT binary patch literal 10674 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 Sm8}YDUW5PtF-sNQTKYde^v^N? literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/__pycache__/exceptions.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/__pycache__/exceptions.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5359f43974dd4e830a617705599f6abbe8d5f512 GIT binary patch literal 12511 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 bSxElgkpIO2T$nsLd0}!Kf72)*PZs|VxGD8T literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/__pycache__/legacy_resolve.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/__pycache__/legacy_resolve.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f28a3235ee121aa42d891e0edabe381425fca831 GIT binary patch literal 9927 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 literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/__pycache__/locations.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/__pycache__/locations.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..879548f13cc5374e2e7d5dd0debadee4eaebacef GIT binary patch literal 4521 zcmaJ_TW{RP6(+e{E|*%ZWZf*;j>9Nz6E)UuV&?|eDVq3_x^a}iikp}~K~Os*i4t!a z&dQcd1x1whA%KgZKcHO!eJRi%&>zspKIF0BYhRkbkN|bRGhD5t!09e_cxL9znKNh3 z`Oe|q8y|NxeBN<1zH&~}{!N{e9~+%t;FteL*EFVi8q=8(>9OG%I?=VL=GD~G96sw_ zUG*)`QqP9hP*2;l@ie1mYpcg)slg&^AL`!oY=TXGp?N=IXV?^;Kj!w}Cu|xsFYx-{#Y1hdbf~eJZR0ClINTZh z^icC&*lTfX@Div?A8W}4Q{&6q4(2cG8hyF7)$uOf*An9sjn82G_q?{%9lXpNTd%O$ zL&Li~>|av7E2{S@zkH~FrRQIt;GH|gOT8<}um1l$_NcQOJNr9hL1Xhu>#xFE-K@_>U?60q1a=Gk%L(a3LmlMHSo<@Di{V>i_Ay+Wg%y;u@DLP}T z*ME8Q{hR)KH}9{a+Zc)hX|47)dCX}r$TAj+oXC%FuiW_H+vlrwNZ1bX@Bw@1Q_Y=m2zY_}C4AITg^@ZSxbU)mcn-~ppH-Pm7REGIF8yzKT@k-~7MHh=fyz=s5 zHMm!QwBLEOzf>zN+(8`3vIcvWt>FfKn5?IN)x<3HQ_Z)ZbT`wOcSV|JLAKr9f$bUZ z;;I-F=-PSrLPX@ zt3&!j9Tv$zWGT%OXVIRrBJe{aG*MRcKuGOC6Z2%pK~0+QTK&-2*OJ%w=7wYXz(VAy zQAF8AQwogd+Q_I#(EmT7u?;n?*?#W z{*d?j5(am1LU&!HvD*t0H%Z~&$p#qLXbJqMv*d^|=vf+RUYc1TH%oIX4HGdpMZn6=+5?5!GWFq<_W8|XEewcX4=l;-EUtV^qC9vJ&h zp$k#eg^(t528}{5>W9XG{<&Tl;!BKwiSaRv8>4YO`(xp3*@ffVg`WQje1Bmr^qNII z`x|DOiZ-&pgLXhWMJ@XW=rPdv4O*mKsO^u*@f+H2=Js2%T{vvKXr0v#jAE>4UDH1O z7i;4j6RdHlZ(Bg^xngWEDbGO46#dx5W94sh`ar|%Z{^I^>|jow-D+oOHh~r&006WCBii@rb%fgLCp8YmzR@txu0{f+*{x9#&YF7ejqmT z6;a2!kFe0{2_8tkcZT@hdbICWo(pR44B^SCp;GhgA#nTU*bxN>T`~lL0US08B>IH! zy$HxtnuIcYc7-~R_RGd54-lUDH%jsIUVC)B4pHI-5;K(rBIkaUJpA=A;<-0LvD2$C z+fUcF%J$niRHpN)KonHilnWzqz%rGrj@AeYw9=$wiVKRQQrKt0|vRTCw^WgV{=xdV&I3VTV{C3Wb#>&Qn9sp`fvJ@+=A^6CtqE z#pqJIY?7`%U6pv1_+F#tbu^_NBAG%wQ<^H9cojEYUa2E#kp=Xyv~uMOWo?`9dgFvZ zevH zryS&}(t=#&sIVC3Z91RehXopnRfgd=)EgF&nEUMTH~VHI&IdqAg_ukQV^9N@5xl`j;x&HyeBuJ zP`&C>>#BMWrE1vQbW_}j7%dN>HRXN5mq~nOfT2B)!s@EaKkbJ*R4KxFQuh>4qRj2^ zj>}Ti2$E{w9Bv>+cKoc1n;kh$2gvHan5B96aEU6o&rn}|Z!$@f_3r!ZS|L6wavIiT@`wEAZ%OOl#-}|79E;Yhz#t|D)?22 z)teq&nLm1G@s3kTXP9<6!$4KZL1j>J1(Lk;s4P39+PM>>?vC zVkW4b^d@f{l^#d$N^QabzZc;8kOxKCzPEbwu7CY)yq)Yj2 zq1D?T-8_+n$rn8f^{*3q&2C@AefA^%b1GPJhQ_Q@ zx;*}>^k`H`a#C+0P0kxF)2Z1_d)BE>fzzn9begfywv9I0NduJmqHa>1QGK2`@2Gzh J=zZtg{{eWc|Aqhn literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/__pycache__/pep425tags.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/__pycache__/pep425tags.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d9f4f64b69ce42c2460bf9be1ccd865e4bd1ea88 GIT binary patch literal 3613 zcmb_fOLH7a5$@{l>1mA~wk6B*YuOHAz{8puzgFQe#C);u(0_6Dt(tg5W4%&e@;FH2u8FExS`n8q9t+2A|}|=y`~O1YyKM6Scj+i z`VsTbaQkp0a?v{*EkuoXhJP+vjF!-zkCvkqv=^ci(Mhxyqf^l;+K-}*Xe~PZj``n< z&PMCe8T3Amtfxlv+?(rP@QjO4axcsx?{zMAz1Oka@g9Hv*t>cCQ}2GB7NLx{<0O{* z-m|b@w%)@7Mw6)%;dYrP1IdFpEpj0{&API%LY?T2Hzhof*rArX#lGChv+<};D&y{G zbTZB)7lq)UK^CT5t<7>?aZ$#3rk2yN8x%<>d$~wUXkY#H^T*GF`wu?9|Eu81mz~bT z&KFHf*^lBq#HKJ&wP%AO;aI->SX=Phk+?VOms_7SgUc_XV+ux>(b2{q_3QZE z$FDpK60t)=GHF)0|H%A9z*z=?_6nDwaPv)e_iQGAbq^@&H1~&qwB8&EMN3oKDg7@M*_zP|7@oSI34OgUT(e8vE9PUtPy#tL!v$YpYCL!`y%QmeNK0_A_*5yvoS0 z7$bU*n7BlUfpoC5vlZ$DJiLX}8F5AlVpkN~c1QdOa!@mLXg5u98AI_2NYfTq(5OZ! z;gFI5THm%dYvPg?t!@*!N`yT0;px|dK9>^@Ou@8+mE{VEVIrFF=dy;0c)9`3+?fdx zDW>$9Z=)k|YUC)}wZ&zLxQYl9k-6w0k2OL9Af5s>Cv!c-Mr3F>cu(R45ghd#^*5={ zRDGNhA6mbrtshsC@fsgnN(aO+m)J#9Y@yfHFh@Lm)Su=6Ih4?Q*A*+$I538YY(2Ut z8AdqCA?~VTN3gkRcHY=;hi`{XOAtN^LMuUa0D-xJikI*dSdH44XW~T zbAjBNYmc~^SI0^RD{B)TC42Z3etyE`KxAI%5oCIK&npK7y$g8cQEl=7(;g4IJKp&2 zyt3fkxEEtS&Ke%Ruf{XwSFMI-+y(%I>14xg$VN?#v;Ks0h1AF$PO?*P^Tv%$4@x#~ zT;IH+_mfaCI(f!h-ZQM5sD2$MiMP$Yuq+2D8JJJ3_40x6etz#^Yu12CuG}8myswq= zJ)pTane+DZf%iJhr1vUJ;%KUWa(37{vE*S-n{>q+lw3>F)y6CLOUcuzz&Q&j;J!=y zd?5bsHp~R7N3!RP2)EuVM%s>Fp@9Ti{i-GN1LR@7r;S@-Tf5T555|a`97S zjJN}W;ZGY>yvm?7c zH*&>2GTiKRP*CtSJyj2aDDMV=Y6L-VfE?vPAP5&#J<0ohq?0lQSLgAlY~eYQMY(8= zUYeL{QTPfAtF=dF9CQqd^yV3F*O!1dX=@0E zJc2D;C^yjm1;AW~tOKV`@3lDL;$vD*kJsbkH@ZSX{n3rm;b+`^jK=PrG>--eze@$D n{4t2lmH@!6d8x4kN1ryA;P!@vs=w}@ahF`T(J+|)``3Q}y{wt^ literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/__pycache__/pyproject.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/__pycache__/pyproject.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..131dbae6d195b3df2ff7ae985395c28ea3c86d10 GIT binary patch literal 3761 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 None + self.path = path + self.setup = False + self.bin_dir = get_paths( + 'nt' if os.name == 'nt' else 'posix_prefix', + vars={'base': path, 'platbase': path} + )['scripts'] + # Note: prefer distutils' sysconfig to get the + # library paths so PyPy is correctly supported. + purelib = get_python_lib(plat_specific=False, prefix=path) + platlib = get_python_lib(plat_specific=True, prefix=path) + if purelib == platlib: + self.lib_dirs = [purelib] + else: + self.lib_dirs = [purelib, platlib] + + +class BuildEnvironment(object): + """Creates and manages an isolated environment to install build deps + """ + + def __init__(self): + # type: () -> None + self._temp_dir = TempDirectory(kind="build-env") + + self._prefixes = OrderedDict(( + (name, _Prefix(os.path.join(self._temp_dir.path, name))) + for name in ('normal', 'overlay') + )) + + self._bin_dirs = [] # type: List[str] + self._lib_dirs = [] # type: List[str] + for prefix in reversed(list(self._prefixes.values())): + self._bin_dirs.append(prefix.bin_dir) + self._lib_dirs.extend(prefix.lib_dirs) + + # Customize site to: + # - ensure .pth files are honored + # - prevent access to system site packages + system_sites = { + os.path.normcase(site) for site in ( + get_python_lib(plat_specific=False), + get_python_lib(plat_specific=True), + ) + } + self._site_dir = os.path.join(self._temp_dir.path, 'site') + if not os.path.exists(self._site_dir): + os.mkdir(self._site_dir) + with open(os.path.join(self._site_dir, 'sitecustomize.py'), 'w') as fp: + fp.write(textwrap.dedent( + ''' + import os, site, sys + + # First, drop system-sites related paths. + original_sys_path = sys.path[:] + known_paths = set() + for path in {system_sites!r}: + site.addsitedir(path, known_paths=known_paths) + system_paths = set( + os.path.normcase(path) + for path in sys.path[len(original_sys_path):] + ) + original_sys_path = [ + path for path in original_sys_path + if os.path.normcase(path) not in system_paths + ] + sys.path = original_sys_path + + # Second, add lib directories. + # ensuring .pth file are processed. + for path in {lib_dirs!r}: + assert not path in sys.path + site.addsitedir(path) + ''' + ).format(system_sites=system_sites, lib_dirs=self._lib_dirs)) + + def __enter__(self): + self._save_env = { + name: os.environ.get(name, None) + for name in ('PATH', 'PYTHONNOUSERSITE', 'PYTHONPATH') + } + + path = self._bin_dirs[:] + old_path = self._save_env['PATH'] + if old_path: + path.extend(old_path.split(os.pathsep)) + + pythonpath = [self._site_dir] + + os.environ.update({ + 'PATH': os.pathsep.join(path), + 'PYTHONNOUSERSITE': '1', + 'PYTHONPATH': os.pathsep.join(pythonpath), + }) + + def __exit__(self, exc_type, exc_val, exc_tb): + for varname, old_value in self._save_env.items(): + if old_value is None: + os.environ.pop(varname, None) + else: + os.environ[varname] = old_value + + def cleanup(self): + # type: () -> None + self._temp_dir.cleanup() + + def check_requirements(self, reqs): + # type: (Iterable[str]) -> Tuple[Set[Tuple[str, str]], Set[str]] + """Return 2 sets: + - conflicting requirements: set of (installed, wanted) reqs tuples + - missing requirements: set of reqs + """ + missing = set() + conflicting = set() + if reqs: + ws = WorkingSet(self._lib_dirs) + for req in reqs: + try: + if ws.find(Requirement.parse(req)) is None: + missing.add(req) + except VersionConflict as e: + conflicting.add((str(e.args[0].as_requirement()), + str(e.args[1]))) + return conflicting, missing + + def install_requirements( + self, + finder, # type: PackageFinder + requirements, # type: Iterable[str] + prefix_as_string, # type: str + message # type: Optional[str] + ): + # type: (...) -> None + prefix = self._prefixes[prefix_as_string] + assert not prefix.setup + prefix.setup = True + if not requirements: + return + args = [ + sys.executable, os.path.dirname(pip_location), 'install', + '--ignore-installed', '--no-user', '--prefix', prefix.path, + '--no-warn-script-location', + ] # type: List[str] + if logger.getEffectiveLevel() <= logging.DEBUG: + args.append('-v') + for format_control in ('no_binary', 'only_binary'): + formats = getattr(finder.format_control, format_control) + args.extend(('--' + format_control.replace('_', '-'), + ','.join(sorted(formats or {':none:'})))) + + index_urls = finder.index_urls + if index_urls: + args.extend(['-i', index_urls[0]]) + for extra_index in index_urls[1:]: + args.extend(['--extra-index-url', extra_index]) + else: + args.append('--no-index') + for link in finder.find_links: + args.extend(['--find-links', link]) + + for host in finder.trusted_hosts: + args.extend(['--trusted-host', host]) + if finder.allow_all_prereleases: + args.append('--pre') + args.append('--') + args.extend(requirements) + with open_spinner(message) as spinner: + call_subprocess(args, spinner=spinner) + + +class NoOpBuildEnvironment(BuildEnvironment): + """A no-op drop-in replacement for BuildEnvironment + """ + + def __init__(self): + pass + + def __enter__(self): + pass + + def __exit__(self, exc_type, exc_val, exc_tb): + pass + + def cleanup(self): + pass + + def install_requirements(self, finder, requirements, prefix, message): + raise NotImplementedError() diff --git a/venv/lib/python3.8/site-packages/pip/_internal/cache.py b/venv/lib/python3.8/site-packages/pip/_internal/cache.py new file mode 100644 index 000000000..abecd78f8 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/cache.py @@ -0,0 +1,329 @@ +"""Cache Management +""" + +# The following comment should be removed at some point in the future. +# mypy: strict-optional=False + +import hashlib +import json +import logging +import os + +from pip._vendor.packaging.tags import interpreter_name, interpreter_version +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.exceptions import InvalidWheelFilename +from pip._internal.models.link import Link +from pip._internal.models.wheel import Wheel +from pip._internal.utils.temp_dir import TempDirectory +from pip._internal.utils.typing import MYPY_CHECK_RUNNING +from pip._internal.utils.urls import path_to_url + +if MYPY_CHECK_RUNNING: + from typing import Optional, Set, List, Any, Dict + + from pip._vendor.packaging.tags import Tag + + from pip._internal.models.format_control import FormatControl + +logger = logging.getLogger(__name__) + + +def _hash_dict(d): + # type: (Dict[str, str]) -> str + """Return a stable sha224 of a dictionary.""" + s = json.dumps(d, sort_keys=True, separators=(",", ":"), ensure_ascii=True) + return hashlib.sha224(s.encode("ascii")).hexdigest() + + +class Cache(object): + """An abstract class - provides cache directories for data from links + + + :param cache_dir: The root of the cache. + :param format_control: An object of FormatControl class to limit + binaries being read from the cache. + :param allowed_formats: which formats of files the cache should store. + ('binary' and 'source' are the only allowed values) + """ + + def __init__(self, cache_dir, format_control, allowed_formats): + # type: (str, FormatControl, Set[str]) -> None + super(Cache, self).__init__() + assert not cache_dir or os.path.isabs(cache_dir) + self.cache_dir = cache_dir or None + self.format_control = format_control + self.allowed_formats = allowed_formats + + _valid_formats = {"source", "binary"} + assert self.allowed_formats.union(_valid_formats) == _valid_formats + + def _get_cache_path_parts_legacy(self, link): + # type: (Link) -> List[str] + """Get parts of part that must be os.path.joined with cache_dir + + Legacy cache key (pip < 20) for compatibility with older caches. + """ + + # We want to generate an url to use as our cache key, we don't want to + # just re-use the URL because it might have other items in the fragment + # and we don't care about those. + key_parts = [link.url_without_fragment] + if link.hash_name is not None and link.hash is not None: + key_parts.append("=".join([link.hash_name, link.hash])) + key_url = "#".join(key_parts) + + # Encode our key url with sha224, we'll use this because it has similar + # security properties to sha256, but with a shorter total output (and + # thus less secure). However the differences don't make a lot of + # difference for our use case here. + hashed = hashlib.sha224(key_url.encode()).hexdigest() + + # We want to nest the directories some to prevent having a ton of top + # level directories where we might run out of sub directories on some + # FS. + parts = [hashed[:2], hashed[2:4], hashed[4:6], hashed[6:]] + + return parts + + def _get_cache_path_parts(self, link): + # type: (Link) -> List[str] + """Get parts of part that must be os.path.joined with cache_dir + """ + + # We want to generate an url to use as our cache key, we don't want to + # just re-use the URL because it might have other items in the fragment + # and we don't care about those. + key_parts = {"url": link.url_without_fragment} + if link.hash_name is not None and link.hash is not None: + key_parts[link.hash_name] = link.hash + if link.subdirectory_fragment: + key_parts["subdirectory"] = link.subdirectory_fragment + + # Include interpreter name, major and minor version in cache key + # to cope with ill-behaved sdists that build a different wheel + # depending on the python version their setup.py is being run on, + # and don't encode the difference in compatibility tags. + # https://github.com/pypa/pip/issues/7296 + key_parts["interpreter_name"] = interpreter_name() + key_parts["interpreter_version"] = interpreter_version() + + # Encode our key url with sha224, we'll use this because it has similar + # security properties to sha256, but with a shorter total output (and + # thus less secure). However the differences don't make a lot of + # difference for our use case here. + hashed = _hash_dict(key_parts) + + # We want to nest the directories some to prevent having a ton of top + # level directories where we might run out of sub directories on some + # FS. + parts = [hashed[:2], hashed[2:4], hashed[4:6], hashed[6:]] + + return parts + + def _get_candidates(self, link, canonical_package_name): + # type: (Link, Optional[str]) -> List[Any] + can_not_cache = ( + not self.cache_dir or + not canonical_package_name or + not link + ) + if can_not_cache: + return [] + + formats = self.format_control.get_allowed_formats( + canonical_package_name + ) + if not self.allowed_formats.intersection(formats): + return [] + + candidates = [] + path = self.get_path_for_link(link) + if os.path.isdir(path): + for candidate in os.listdir(path): + candidates.append((candidate, path)) + # TODO remove legacy path lookup in pip>=21 + legacy_path = self.get_path_for_link_legacy(link) + if os.path.isdir(legacy_path): + for candidate in os.listdir(legacy_path): + candidates.append((candidate, legacy_path)) + return candidates + + def get_path_for_link_legacy(self, link): + # type: (Link) -> str + raise NotImplementedError() + + def get_path_for_link(self, link): + # type: (Link) -> str + """Return a directory to store cached items in for link. + """ + raise NotImplementedError() + + def get( + self, + link, # type: Link + package_name, # type: Optional[str] + supported_tags, # type: List[Tag] + ): + # type: (...) -> Link + """Returns a link to a cached item if it exists, otherwise returns the + passed link. + """ + raise NotImplementedError() + + def cleanup(self): + # type: () -> None + pass + + +class SimpleWheelCache(Cache): + """A cache of wheels for future installs. + """ + + def __init__(self, cache_dir, format_control): + # type: (str, FormatControl) -> None + super(SimpleWheelCache, self).__init__( + cache_dir, format_control, {"binary"} + ) + + def get_path_for_link_legacy(self, link): + # type: (Link) -> str + parts = self._get_cache_path_parts_legacy(link) + return os.path.join(self.cache_dir, "wheels", *parts) + + def get_path_for_link(self, link): + # type: (Link) -> str + """Return a directory to store cached wheels for link + + Because there are M wheels for any one sdist, we provide a directory + to cache them in, and then consult that directory when looking up + cache hits. + + We only insert things into the cache if they have plausible version + numbers, so that we don't contaminate the cache with things that were + not unique. E.g. ./package might have dozens of installs done for it + and build a version of 0.0...and if we built and cached a wheel, we'd + end up using the same wheel even if the source has been edited. + + :param link: The link of the sdist for which this will cache wheels. + """ + parts = self._get_cache_path_parts(link) + + # Store wheels within the root cache_dir + return os.path.join(self.cache_dir, "wheels", *parts) + + def get( + self, + link, # type: Link + package_name, # type: Optional[str] + supported_tags, # type: List[Tag] + ): + # type: (...) -> Link + candidates = [] + + if not package_name: + return link + + canonical_package_name = canonicalize_name(package_name) + for wheel_name, wheel_dir in self._get_candidates( + link, canonical_package_name + ): + try: + wheel = Wheel(wheel_name) + except InvalidWheelFilename: + continue + if canonicalize_name(wheel.name) != canonical_package_name: + logger.debug( + "Ignoring cached wheel {} for {} as it " + "does not match the expected distribution name {}.".format( + wheel_name, link, package_name + ) + ) + continue + if not wheel.supported(supported_tags): + # Built for a different python/arch/etc + continue + candidates.append( + ( + wheel.support_index_min(supported_tags), + wheel_name, + wheel_dir, + ) + ) + + if not candidates: + return link + + _, wheel_name, wheel_dir = min(candidates) + return Link(path_to_url(os.path.join(wheel_dir, wheel_name))) + + +class EphemWheelCache(SimpleWheelCache): + """A SimpleWheelCache that creates it's own temporary cache directory + """ + + def __init__(self, format_control): + # type: (FormatControl) -> None + self._temp_dir = TempDirectory(kind="ephem-wheel-cache") + + super(EphemWheelCache, self).__init__( + self._temp_dir.path, format_control + ) + + def cleanup(self): + # type: () -> None + self._temp_dir.cleanup() + + +class WheelCache(Cache): + """Wraps EphemWheelCache and SimpleWheelCache into a single Cache + + This Cache allows for gracefully degradation, using the ephem wheel cache + when a certain link is not found in the simple wheel cache first. + """ + + def __init__(self, cache_dir, format_control): + # type: (str, FormatControl) -> None + super(WheelCache, self).__init__( + cache_dir, format_control, {'binary'} + ) + self._wheel_cache = SimpleWheelCache(cache_dir, format_control) + self._ephem_cache = EphemWheelCache(format_control) + + def get_path_for_link_legacy(self, link): + # type: (Link) -> str + return self._wheel_cache.get_path_for_link_legacy(link) + + def get_path_for_link(self, link): + # type: (Link) -> str + return self._wheel_cache.get_path_for_link(link) + + def get_ephem_path_for_link(self, link): + # type: (Link) -> str + return self._ephem_cache.get_path_for_link(link) + + def get( + self, + link, # type: Link + package_name, # type: Optional[str] + supported_tags, # type: List[Tag] + ): + # type: (...) -> Link + retval = self._wheel_cache.get( + link=link, + package_name=package_name, + supported_tags=supported_tags, + ) + if retval is not link: + return retval + + return self._ephem_cache.get( + link=link, + package_name=package_name, + supported_tags=supported_tags, + ) + + def cleanup(self): + # type: () -> None + self._wheel_cache.cleanup() + self._ephem_cache.cleanup() diff --git a/venv/lib/python3.8/site-packages/pip/_internal/cli/__init__.py b/venv/lib/python3.8/site-packages/pip/_internal/cli/__init__.py new file mode 100644 index 000000000..e589bb917 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/cli/__init__.py @@ -0,0 +1,4 @@ +"""Subpackage containing all of pip's command line interface related code +""" + +# This file intentionally does not import submodules diff --git a/venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/__init__.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/__init__.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..63a9d901a8b19a926f333ef2daf3c977cb4499e6 GIT binary patch literal 265 zcmYjMu}%Xq49#_+I;sDV4RxR%SQsjVSlC!978oKoaa*f7C%WWLDl)Dq4{IXcIM)BAh`q26{ng3|iJSfXtC74$envGe`-k&zZHlsh{o~%z&k%eV% zF-DtqHgmo%+V47)U?U4zmP-8&J=vZjRth=})IKkp^ObWUdFMV&KhrB0`FVpw>InLj zGUg+UWm<<)hd@$cBpD&{7V@bclH9KDpm3#|zeoi%0l3Re!3aJwIJI1zTjkSvzV1>O LBHd5#eJjl`0HjTz literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/autocompletion.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/autocompletion.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..7c8b8925d439b1e33b0c003734fb60ad2f8c2b85 GIT binary patch literal 4982 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 T`l|qV5TvLG9pIznl+OPb9v<$6 literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/base_command.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/base_command.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f168b87ea20b83dfb9d56b212d02ebd79e231498 GIT binary patch literal 5876 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 Bi+TV6 literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/cmdoptions.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/cmdoptions.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..327cb88db11219f7da97e16bed73a8d1afdb28ab GIT binary patch literal 20357 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 literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/main.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/main.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..39be8785f991cfef606e5e10c55f11d054e95096 GIT binary patch literal 1435 zcmZuwPj4eN6t_K-$z+efOUO=rC6w4Oh* zopuu?y)4||JERg9z6Kw|2QHlUD{$i3DWwZ*%g^sUKmYvx`Dv>aAQ)c;h4cuJ{?S0=|~7)Af9VZh+2RY_hkmFuj|$(v`IN zBc@xa^F8Xfr@eiV<*}Ib;;Q0V6058%daO`lQk7Yu2Ei+c1@*CBjgMu?$BIQ+UX?-( zLD!7Os!Ynf;!H7+TU9J1i$IgdMGA^`B3KMp{?+*VS+y%fDd2P^WtCvdH$m)vceH;L z?R>qv^KEqSbU1uG{Hjm1yO&9&{U??2EanL|{#*|ac2klaSn>}bGf4ZHFE$lA#gGK_ z6WKy@q{za#LKrFcCD3U{)n@1={(;Q#oE)O!8y6|>ED)C%%^f&@4{p~NeoAJ}Cc46K z&&sNC8Z4#7N{S74h(3b%=FX+_3>~3@JVVp2YA#x;dD>2$D=0dkKLYgT=_=s=4*0Hp zzq7cLx-)laVKLlG_a6+^o#C`LBWGUf{X*uoS#7a4BUc#8RUf`G;ZGa82M13MKIuJ_ z8ciQQ9u=j?icyc5yn?cKal(q8WJ(z=FO!(FX|TPWK>?u}rZD~uzpfoQk=l*L=v>qR zoo;4@R59n#MJx(Hh(_1d8xrrr&A$%AlQL(aD9b9Y&cbt$9uh3NM%6Z|9yl?$abf^Y3~v1~ z_yM*G^#1?NjIWXXf5H}tZvMw+`6;DMGQIoyAtaR94<>DG>DueZW0i4fn?v7w!^uER zDieke5oqsPXqcGH=cJ7hQ+vxg`;o0BWMRu3o4nf6-6B2EY5&u_OvjvkX4+jo0OFD+ Qi_@% literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/main_parser.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/main_parser.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..546924072d57166784140ebacd29086aff0d82fa GIT binary patch literal 2188 zcmZWr&2Jnv6t_LIGqaQ3%|}D}p@N2@6z!qAs7QcBh=8=E6>X?!d+0zJO~%e4sG_a@{^pFl}y32Pt?*zS!}1Hugt`KW2)YKRMA-Pc!O=n<4lU%EURvn zJddSh9GtpIndfkth-jKfwLD@n5^0`hF^^7`;H1t*V|J7CQoGG-yDF`seZ~cxuRJrs z%Mlna-FtlhakO#!=Ej%N*N-+g?`(bnF0F^-Dr3sNn+mCx63$}DA{|!Lgr&OXd2(u^ zgFI@ei(1iq{>nYI@qL#!U?O$6HB*`|a(NB1SYdp1%5k}HJLN$(B(wVx_+4X9C zOeO?Y+ci1HP^A{E`qUX=>Qe7Hl5^9}F}i_{@Od<`XnWeNtz+0N>eU$P<{y5rVP0F9 z`fw)4ybx#0V~Po>c~=A*cklQCw8KmOY6ZCo)@CVP55Aez?a3|WjIweo&iXCY8jESE4Bq4Cz(4HFUN=gM?ecfT&%@;3 z-wk)loDF$dR&ljA+!skn*-*$aWrZB>vtoakrCY=5K<<>q`-6{$B9-h~6(@TTn;1f7 zhOi%?uZXi@lBL5_7#LIs%3sR>A#ifFeqBdmYEPX14zIqBnZa6CCUGX#VQ}K4u-~8O z+Kacf&}mT@X)5Baj5Q~V3Q)^v6!Vebo?drnIOh5W2^aHtkIj-Fjd(e(!tRI_jK^7{ zss&x5raH43TZh4Q{#6SC&V{mf%d}8)l!=6=hLn9fY&T$!_MR%I8HPZeLhmK`+u&`I z+=vTW?Sjw)aRmf&2qxIp{U68ku}3_shkeVjeB%7;*&XreHNXwwy}L znO)ekgf$;9lPYy)c`VaR4Du8hq_J!WtuDQKNMj=pD)`EA{r5mQGX?%3Al}h45N4cZ w5T<4m*Qq*1Gm}V7G3Bl0B^_sMUBgLS0%2P^X&t;^FJO?kLu|ZYK{DU@AAZ1E-~a#s literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/parser.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/parser.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..961098eb951daadfa38ebde6179c115696589f9f GIT binary patch literal 9006 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 literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/req_command.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/req_command.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..550c20bfd9c756fdfd44f083f2da62b76d153c41 GIT binary patch literal 8318 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 None + """Entry Point for completion of main and subcommand options. + """ + # Don't complete if user hasn't sourced bash_completion file. + if 'PIP_AUTO_COMPLETE' not in os.environ: + return + cwords = os.environ['COMP_WORDS'].split()[1:] + cword = int(os.environ['COMP_CWORD']) + try: + current = cwords[cword - 1] + except IndexError: + current = '' + + parser = create_main_parser() + subcommands = list(commands_dict) + options = [] + + # subcommand + subcommand_name = None # type: Optional[str] + for word in cwords: + if word in subcommands: + subcommand_name = word + break + # subcommand options + if subcommand_name is not None: + # special case: 'help' subcommand has no options + if subcommand_name == 'help': + sys.exit(1) + # special case: list locally installed dists for show and uninstall + should_list_installed = ( + subcommand_name in ['show', 'uninstall'] and + not current.startswith('-') + ) + if should_list_installed: + installed = [] + lc = current.lower() + for dist in get_installed_distributions(local_only=True): + if dist.key.startswith(lc) and dist.key not in cwords[1:]: + installed.append(dist.key) + # if there are no dists installed, fall back to option completion + if installed: + for dist in installed: + print(dist) + sys.exit(1) + + subcommand = create_command(subcommand_name) + + for opt in subcommand.parser.option_list_all: + if opt.help != optparse.SUPPRESS_HELP: + for opt_str in opt._long_opts + opt._short_opts: + options.append((opt_str, opt.nargs)) + + # filter out previously specified options from available options + prev_opts = [x.split('=')[0] for x in cwords[1:cword - 1]] + options = [(x, v) for (x, v) in options if x not in prev_opts] + # filter options by current input + options = [(k, v) for k, v in options if k.startswith(current)] + # get completion type given cwords and available subcommand options + completion_type = get_path_completion_type( + cwords, cword, subcommand.parser.option_list_all, + ) + # get completion files and directories if ``completion_type`` is + # ````, ```` or ```` + if completion_type: + paths = auto_complete_paths(current, completion_type) + options = [(path, 0) for path in paths] + for option in options: + opt_label = option[0] + # append '=' to options which require args + if option[1] and option[0][:2] == "--": + opt_label += '=' + print(opt_label) + else: + # show main parser options only when necessary + + opts = [i.option_list for i in parser.option_groups] + opts.append(parser.option_list) + flattened_opts = chain.from_iterable(opts) + if current.startswith('-'): + for opt in flattened_opts: + if opt.help != optparse.SUPPRESS_HELP: + subcommands += opt._long_opts + opt._short_opts + else: + # get completion type given cwords and all available options + completion_type = get_path_completion_type(cwords, cword, + flattened_opts) + if completion_type: + subcommands = list(auto_complete_paths(current, + completion_type)) + + print(' '.join([x for x in subcommands if x.startswith(current)])) + sys.exit(1) + + +def get_path_completion_type(cwords, cword, opts): + # type: (List[str], int, Iterable[Any]) -> Optional[str] + """Get the type of path completion (``file``, ``dir``, ``path`` or None) + + :param cwords: same as the environmental variable ``COMP_WORDS`` + :param cword: same as the environmental variable ``COMP_CWORD`` + :param opts: The available options to check + :return: path completion type (``file``, ``dir``, ``path`` or None) + """ + if cword < 2 or not cwords[cword - 2].startswith('-'): + return None + for opt in opts: + if opt.help == optparse.SUPPRESS_HELP: + continue + for o in str(opt).split('/'): + if cwords[cword - 2].split('=')[0] == o: + if not opt.metavar or any( + x in ('path', 'file', 'dir') + for x in opt.metavar.split('/')): + return opt.metavar + return None + + +def auto_complete_paths(current, completion_type): + # type: (str, str) -> Iterable[str] + """If ``completion_type`` is ``file`` or ``path``, list all regular files + and directories starting with ``current``; otherwise only list directories + starting with ``current``. + + :param current: The word to be completed + :param completion_type: path completion type(`file`, `path` or `dir`)i + :return: A generator of regular files and/or directories + """ + directory, filename = os.path.split(current) + current_path = os.path.abspath(directory) + # Don't complete paths if they can't be accessed + if not os.access(current_path, os.R_OK): + return + filename = os.path.normcase(filename) + # list all files that start with ``filename`` + file_list = (x for x in os.listdir(current_path) + if os.path.normcase(x).startswith(filename)) + for f in file_list: + opt = os.path.join(current_path, f) + comp_file = os.path.normcase(os.path.join(directory, f)) + # complete regular files when there is not ```` after option + # complete directories when there is ````, ```` or + # ````after option + if completion_type != 'dir' and os.path.isfile(opt): + yield comp_file + elif os.path.isdir(opt): + yield os.path.join(comp_file, '') diff --git a/venv/lib/python3.8/site-packages/pip/_internal/cli/base_command.py b/venv/lib/python3.8/site-packages/pip/_internal/cli/base_command.py new file mode 100644 index 000000000..628faa3ee --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/cli/base_command.py @@ -0,0 +1,226 @@ +"""Base Command class, and related routines""" + +from __future__ import absolute_import, print_function + +import logging +import logging.config +import optparse +import os +import platform +import sys +import traceback + +from pip._internal.cli import cmdoptions +from pip._internal.cli.command_context import CommandContextMixIn +from pip._internal.cli.parser import ( + ConfigOptionParser, + UpdatingDefaultsHelpFormatter, +) +from pip._internal.cli.status_codes import ( + ERROR, + PREVIOUS_BUILD_DIR_ERROR, + SUCCESS, + UNKNOWN_ERROR, + VIRTUALENV_NOT_FOUND, +) +from pip._internal.exceptions import ( + BadCommand, + CommandError, + InstallationError, + PreviousBuildDirError, + UninstallationError, +) +from pip._internal.utils.deprecation import deprecated +from pip._internal.utils.filesystem import check_path_owner +from pip._internal.utils.logging import BrokenStdoutLoggingError, setup_logging +from pip._internal.utils.misc import get_prog, normalize_path +from pip._internal.utils.temp_dir import global_tempdir_manager +from pip._internal.utils.typing import MYPY_CHECK_RUNNING +from pip._internal.utils.virtualenv import running_under_virtualenv + +if MYPY_CHECK_RUNNING: + from typing import List, Tuple, Any + from optparse import Values + +__all__ = ['Command'] + +logger = logging.getLogger(__name__) + + +class Command(CommandContextMixIn): + usage = None # type: str + ignore_require_venv = False # type: bool + + def __init__(self, name, summary, isolated=False): + # type: (str, str, bool) -> None + super(Command, self).__init__() + parser_kw = { + 'usage': self.usage, + 'prog': '%s %s' % (get_prog(), name), + 'formatter': UpdatingDefaultsHelpFormatter(), + 'add_help_option': False, + 'name': name, + 'description': self.__doc__, + 'isolated': isolated, + } + + self.name = name + self.summary = summary + self.parser = ConfigOptionParser(**parser_kw) + + # Commands should add options to this option group + optgroup_name = '%s Options' % self.name.capitalize() + self.cmd_opts = optparse.OptionGroup(self.parser, optgroup_name) + + # Add the general options + gen_opts = cmdoptions.make_option_group( + cmdoptions.general_group, + self.parser, + ) + self.parser.add_option_group(gen_opts) + + def handle_pip_version_check(self, options): + # type: (Values) -> None + """ + This is a no-op so that commands by default do not do the pip version + check. + """ + # Make sure we do the pip version check if the index_group options + # are present. + assert not hasattr(options, 'no_index') + + def run(self, options, args): + # type: (Values, List[Any]) -> Any + raise NotImplementedError + + def parse_args(self, args): + # type: (List[str]) -> Tuple[Any, Any] + # factored out for testability + return self.parser.parse_args(args) + + def main(self, args): + # type: (List[str]) -> int + try: + with self.main_context(): + return self._main(args) + finally: + logging.shutdown() + + def _main(self, args): + # type: (List[str]) -> int + # Intentionally set as early as possible so globally-managed temporary + # directories are available to the rest of the code. + self.enter_context(global_tempdir_manager()) + + options, args = self.parse_args(args) + + # Set verbosity so that it can be used elsewhere. + self.verbosity = options.verbose - options.quiet + + level_number = setup_logging( + verbosity=self.verbosity, + no_color=options.no_color, + user_log_file=options.log, + ) + + if ( + sys.version_info[:2] == (2, 7) and + not options.no_python_version_warning + ): + message = ( + "A future version of pip will drop support for Python 2.7. " + "More details about Python 2 support in pip, can be found at " + "https://pip.pypa.io/en/latest/development/release-process/#python-2-support" # noqa + ) + if platform.python_implementation() == "CPython": + message = ( + "Python 2.7 reached the end of its life on January " + "1st, 2020. Please upgrade your Python as Python 2.7 " + "is no longer maintained. " + ) + message + deprecated(message, replacement=None, gone_in=None) + + if options.skip_requirements_regex: + deprecated( + "--skip-requirements-regex is unsupported and will be removed", + replacement=( + "manage requirements/constraints files explicitly, " + "possibly generating them from metadata" + ), + gone_in="20.1", + issue=7297, + ) + + # TODO: Try to get these passing down from the command? + # without resorting to os.environ to hold these. + # This also affects isolated builds and it should. + + if options.no_input: + os.environ['PIP_NO_INPUT'] = '1' + + if options.exists_action: + os.environ['PIP_EXISTS_ACTION'] = ' '.join(options.exists_action) + + if options.require_venv and not self.ignore_require_venv: + # If a venv is required check if it can really be found + if not running_under_virtualenv(): + logger.critical( + 'Could not find an activated virtualenv (required).' + ) + sys.exit(VIRTUALENV_NOT_FOUND) + + if options.cache_dir: + options.cache_dir = normalize_path(options.cache_dir) + if not check_path_owner(options.cache_dir): + logger.warning( + "The directory '%s' or its parent directory is not owned " + "or is not writable by the current user. The cache " + "has been disabled. Check the permissions and owner of " + "that directory. If executing pip with sudo, you may want " + "sudo's -H flag.", + options.cache_dir, + ) + options.cache_dir = None + + try: + status = self.run(options, args) + # FIXME: all commands should return an exit status + # and when it is done, isinstance is not needed anymore + if isinstance(status, int): + return status + except PreviousBuildDirError as exc: + logger.critical(str(exc)) + logger.debug('Exception information:', exc_info=True) + + return PREVIOUS_BUILD_DIR_ERROR + except (InstallationError, UninstallationError, BadCommand) as exc: + logger.critical(str(exc)) + logger.debug('Exception information:', exc_info=True) + + return ERROR + except CommandError as exc: + logger.critical('%s', exc) + logger.debug('Exception information:', exc_info=True) + + return ERROR + except BrokenStdoutLoggingError: + # Bypass our logger and write any remaining messages to stderr + # because stdout no longer works. + print('ERROR: Pipe to stdout was broken', file=sys.stderr) + if level_number <= logging.DEBUG: + traceback.print_exc(file=sys.stderr) + + return ERROR + except KeyboardInterrupt: + logger.critical('Operation cancelled by user') + logger.debug('Exception information:', exc_info=True) + + return ERROR + except BaseException: + logger.critical('Exception:', exc_info=True) + + return UNKNOWN_ERROR + finally: + self.handle_pip_version_check(options) + + return SUCCESS diff --git a/venv/lib/python3.8/site-packages/pip/_internal/cli/cmdoptions.py b/venv/lib/python3.8/site-packages/pip/_internal/cli/cmdoptions.py new file mode 100644 index 000000000..447f31918 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/cli/cmdoptions.py @@ -0,0 +1,957 @@ +""" +shared options and groups + +The principle here is to define options once, but *not* instantiate them +globally. One reason being that options with action='append' can carry state +between parses. pip parses general options twice internally, and shouldn't +pass on state. To be consistent, all options will follow this design. +""" + +# The following comment should be removed at some point in the future. +# mypy: strict-optional=False + +from __future__ import absolute_import + +import logging +import os +import textwrap +import warnings +from distutils.util import strtobool +from functools import partial +from optparse import SUPPRESS_HELP, Option, OptionGroup +from textwrap import dedent + +from pip._internal.exceptions import CommandError +from pip._internal.locations import USER_CACHE_DIR, get_src_prefix +from pip._internal.models.format_control import FormatControl +from pip._internal.models.index import PyPI +from pip._internal.models.target_python import TargetPython +from pip._internal.utils.hashes import STRONG_HASHES +from pip._internal.utils.typing import MYPY_CHECK_RUNNING +from pip._internal.utils.ui import BAR_TYPES + +if MYPY_CHECK_RUNNING: + from typing import Any, Callable, Dict, Optional, Tuple + from optparse import OptionParser, Values + from pip._internal.cli.parser import ConfigOptionParser + +logger = logging.getLogger(__name__) + + +def raise_option_error(parser, option, msg): + # type: (OptionParser, Option, str) -> None + """ + Raise an option parsing error using parser.error(). + + Args: + parser: an OptionParser instance. + option: an Option instance. + msg: the error text. + """ + msg = '{} error: {}'.format(option, msg) + msg = textwrap.fill(' '.join(msg.split())) + parser.error(msg) + + +def make_option_group(group, parser): + # type: (Dict[str, Any], ConfigOptionParser) -> OptionGroup + """ + Return an OptionGroup object + group -- assumed to be dict with 'name' and 'options' keys + parser -- an optparse Parser + """ + option_group = OptionGroup(parser, group['name']) + for option in group['options']: + option_group.add_option(option()) + return option_group + + +def check_install_build_global(options, check_options=None): + # type: (Values, Optional[Values]) -> None + """Disable wheels if per-setup.py call options are set. + + :param options: The OptionParser options to update. + :param check_options: The options to check, if not supplied defaults to + options. + """ + if check_options is None: + check_options = options + + def getname(n): + # type: (str) -> Optional[Any] + return getattr(check_options, n, None) + names = ["build_options", "global_options", "install_options"] + if any(map(getname, names)): + control = options.format_control + control.disallow_binaries() + warnings.warn( + 'Disabling all use of wheels due to the use of --build-option ' + '/ --global-option / --install-option.', stacklevel=2, + ) + + +def check_dist_restriction(options, check_target=False): + # type: (Values, bool) -> None + """Function for determining if custom platform options are allowed. + + :param options: The OptionParser options. + :param check_target: Whether or not to check if --target is being used. + """ + dist_restriction_set = any([ + options.python_version, + options.platform, + options.abi, + options.implementation, + ]) + + binary_only = FormatControl(set(), {':all:'}) + sdist_dependencies_allowed = ( + options.format_control != binary_only and + not options.ignore_dependencies + ) + + # Installations or downloads using dist restrictions must not combine + # source distributions and dist-specific wheels, as they are not + # guaranteed to be locally compatible. + if dist_restriction_set and sdist_dependencies_allowed: + raise CommandError( + "When restricting platform and interpreter constraints using " + "--python-version, --platform, --abi, or --implementation, " + "either --no-deps must be set, or --only-binary=:all: must be " + "set and --no-binary must not be set (or must be set to " + ":none:)." + ) + + if check_target: + if dist_restriction_set and not options.target_dir: + raise CommandError( + "Can not use any platform or abi specific options unless " + "installing via '--target'" + ) + + +def _path_option_check(option, opt, value): + # type: (Option, str, str) -> str + return os.path.expanduser(value) + + +class PipOption(Option): + TYPES = Option.TYPES + ("path",) + TYPE_CHECKER = Option.TYPE_CHECKER.copy() + TYPE_CHECKER["path"] = _path_option_check + + +########### +# options # +########### + +help_ = partial( + Option, + '-h', '--help', + dest='help', + action='help', + help='Show help.', +) # type: Callable[..., Option] + +isolated_mode = partial( + Option, + "--isolated", + dest="isolated_mode", + action="store_true", + default=False, + help=( + "Run pip in an isolated mode, ignoring environment variables and user " + "configuration." + ), +) # type: Callable[..., Option] + +require_virtualenv = partial( + Option, + # Run only if inside a virtualenv, bail if not. + '--require-virtualenv', '--require-venv', + dest='require_venv', + action='store_true', + default=False, + help=SUPPRESS_HELP +) # type: Callable[..., Option] + +verbose = partial( + Option, + '-v', '--verbose', + dest='verbose', + action='count', + default=0, + help='Give more output. Option is additive, and can be used up to 3 times.' +) # type: Callable[..., Option] + +no_color = partial( + Option, + '--no-color', + dest='no_color', + action='store_true', + default=False, + help="Suppress colored output", +) # type: Callable[..., Option] + +version = partial( + Option, + '-V', '--version', + dest='version', + action='store_true', + help='Show version and exit.', +) # type: Callable[..., Option] + +quiet = partial( + Option, + '-q', '--quiet', + dest='quiet', + action='count', + default=0, + help=( + 'Give less output. Option is additive, and can be used up to 3' + ' times (corresponding to WARNING, ERROR, and CRITICAL logging' + ' levels).' + ), +) # type: Callable[..., Option] + +progress_bar = partial( + Option, + '--progress-bar', + dest='progress_bar', + type='choice', + choices=list(BAR_TYPES.keys()), + default='on', + help=( + 'Specify type of progress to be displayed [' + + '|'.join(BAR_TYPES.keys()) + '] (default: %default)' + ), +) # type: Callable[..., Option] + +log = partial( + PipOption, + "--log", "--log-file", "--local-log", + dest="log", + metavar="path", + type="path", + help="Path to a verbose appending log." +) # type: Callable[..., Option] + +no_input = partial( + Option, + # Don't ask for input + '--no-input', + dest='no_input', + action='store_true', + default=False, + help=SUPPRESS_HELP +) # type: Callable[..., Option] + +proxy = partial( + Option, + '--proxy', + dest='proxy', + type='str', + default='', + help="Specify a proxy in the form [user:passwd@]proxy.server:port." +) # type: Callable[..., Option] + +retries = partial( + Option, + '--retries', + dest='retries', + type='int', + default=5, + help="Maximum number of retries each connection should attempt " + "(default %default times).", +) # type: Callable[..., Option] + +timeout = partial( + Option, + '--timeout', '--default-timeout', + metavar='sec', + dest='timeout', + type='float', + default=15, + help='Set the socket timeout (default %default seconds).', +) # type: Callable[..., Option] + +skip_requirements_regex = partial( + Option, + # A regex to be used to skip requirements + '--skip-requirements-regex', + dest='skip_requirements_regex', + type='str', + default='', + help=SUPPRESS_HELP, +) # type: Callable[..., Option] + + +def exists_action(): + # type: () -> Option + return Option( + # Option when path already exist + '--exists-action', + dest='exists_action', + type='choice', + choices=['s', 'i', 'w', 'b', 'a'], + default=[], + action='append', + metavar='action', + help="Default action when a path already exists: " + "(s)witch, (i)gnore, (w)ipe, (b)ackup, (a)bort.", + ) + + +cert = partial( + PipOption, + '--cert', + dest='cert', + type='path', + metavar='path', + help="Path to alternate CA bundle.", +) # type: Callable[..., Option] + +client_cert = partial( + PipOption, + '--client-cert', + dest='client_cert', + type='path', + default=None, + metavar='path', + help="Path to SSL client certificate, a single file containing the " + "private key and the certificate in PEM format.", +) # type: Callable[..., Option] + +index_url = partial( + Option, + '-i', '--index-url', '--pypi-url', + dest='index_url', + metavar='URL', + default=PyPI.simple_url, + help="Base URL of the Python Package Index (default %default). " + "This should point to a repository compliant with PEP 503 " + "(the simple repository API) or a local directory laid out " + "in the same format.", +) # type: Callable[..., Option] + + +def extra_index_url(): + # type: () -> Option + return Option( + '--extra-index-url', + dest='extra_index_urls', + metavar='URL', + action='append', + default=[], + help="Extra URLs of package indexes to use in addition to " + "--index-url. Should follow the same rules as " + "--index-url.", + ) + + +no_index = partial( + Option, + '--no-index', + dest='no_index', + action='store_true', + default=False, + help='Ignore package index (only looking at --find-links URLs instead).', +) # type: Callable[..., Option] + + +def find_links(): + # type: () -> Option + return Option( + '-f', '--find-links', + dest='find_links', + action='append', + default=[], + metavar='url', + help="If a url or path to an html file, then parse for links to " + "archives. If a local path or file:// url that's a directory, " + "then look for archives in the directory listing.", + ) + + +def trusted_host(): + # type: () -> Option + return Option( + "--trusted-host", + dest="trusted_hosts", + action="append", + metavar="HOSTNAME", + default=[], + help="Mark this host or host:port pair as trusted, even though it " + "does not have valid or any HTTPS.", + ) + + +def constraints(): + # type: () -> Option + return Option( + '-c', '--constraint', + dest='constraints', + action='append', + default=[], + metavar='file', + help='Constrain versions using the given constraints file. ' + 'This option can be used multiple times.' + ) + + +def requirements(): + # type: () -> Option + return Option( + '-r', '--requirement', + dest='requirements', + action='append', + default=[], + metavar='file', + help='Install from the given requirements file. ' + 'This option can be used multiple times.' + ) + + +def editable(): + # type: () -> Option + return Option( + '-e', '--editable', + dest='editables', + action='append', + default=[], + metavar='path/url', + help=('Install a project in editable mode (i.e. setuptools ' + '"develop mode") from a local project path or a VCS url.'), + ) + + +def _handle_src(option, opt_str, value, parser): + # type: (Option, str, str, OptionParser) -> None + value = os.path.abspath(value) + setattr(parser.values, option.dest, value) + + +src = partial( + PipOption, + '--src', '--source', '--source-dir', '--source-directory', + dest='src_dir', + type='path', + metavar='dir', + default=get_src_prefix(), + action='callback', + callback=_handle_src, + help='Directory to check out editable projects into. ' + 'The default in a virtualenv is "/src". ' + 'The default for global installs is "/src".' +) # type: Callable[..., Option] + + +def _get_format_control(values, option): + # type: (Values, Option) -> Any + """Get a format_control object.""" + return getattr(values, option.dest) + + +def _handle_no_binary(option, opt_str, value, parser): + # type: (Option, str, str, OptionParser) -> None + existing = _get_format_control(parser.values, option) + FormatControl.handle_mutual_excludes( + value, existing.no_binary, existing.only_binary, + ) + + +def _handle_only_binary(option, opt_str, value, parser): + # type: (Option, str, str, OptionParser) -> None + existing = _get_format_control(parser.values, option) + FormatControl.handle_mutual_excludes( + value, existing.only_binary, existing.no_binary, + ) + + +def no_binary(): + # type: () -> Option + format_control = FormatControl(set(), set()) + return Option( + "--no-binary", dest="format_control", action="callback", + callback=_handle_no_binary, type="str", + default=format_control, + help="Do not use binary packages. Can be supplied multiple times, and " + "each time adds to the existing value. Accepts either :all: to " + "disable all binary packages, :none: to empty the set, or one or " + "more package names with commas between them (no colons). Note " + "that some packages are tricky to compile and may fail to " + "install when this option is used on them.", + ) + + +def only_binary(): + # type: () -> Option + format_control = FormatControl(set(), set()) + return Option( + "--only-binary", dest="format_control", action="callback", + callback=_handle_only_binary, type="str", + default=format_control, + help="Do not use source packages. Can be supplied multiple times, and " + "each time adds to the existing value. Accepts either :all: to " + "disable all source packages, :none: to empty the set, or one or " + "more package names with commas between them. Packages without " + "binary distributions will fail to install when this option is " + "used on them.", + ) + + +platform = partial( + Option, + '--platform', + dest='platform', + metavar='platform', + default=None, + help=("Only use wheels compatible with . " + "Defaults to the platform of the running system."), +) # type: Callable[..., Option] + + +# This was made a separate function for unit-testing purposes. +def _convert_python_version(value): + # type: (str) -> Tuple[Tuple[int, ...], Optional[str]] + """ + Convert a version string like "3", "37", or "3.7.3" into a tuple of ints. + + :return: A 2-tuple (version_info, error_msg), where `error_msg` is + non-None if and only if there was a parsing error. + """ + if not value: + # The empty string is the same as not providing a value. + return (None, None) + + parts = value.split('.') + if len(parts) > 3: + return ((), 'at most three version parts are allowed') + + if len(parts) == 1: + # Then we are in the case of "3" or "37". + value = parts[0] + if len(value) > 1: + parts = [value[0], value[1:]] + + try: + version_info = tuple(int(part) for part in parts) + except ValueError: + return ((), 'each version part must be an integer') + + return (version_info, None) + + +def _handle_python_version(option, opt_str, value, parser): + # type: (Option, str, str, OptionParser) -> None + """ + Handle a provided --python-version value. + """ + version_info, error_msg = _convert_python_version(value) + if error_msg is not None: + msg = ( + 'invalid --python-version value: {!r}: {}'.format( + value, error_msg, + ) + ) + raise_option_error(parser, option=option, msg=msg) + + parser.values.python_version = version_info + + +python_version = partial( + Option, + '--python-version', + dest='python_version', + metavar='python_version', + action='callback', + callback=_handle_python_version, type='str', + default=None, + help=dedent("""\ + The Python interpreter version to use for wheel and "Requires-Python" + compatibility checks. Defaults to a version derived from the running + interpreter. The version can be specified using up to three dot-separated + integers (e.g. "3" for 3.0.0, "3.7" for 3.7.0, or "3.7.3"). A major-minor + version can also be given as a string without dots (e.g. "37" for 3.7.0). + """), +) # type: Callable[..., Option] + + +implementation = partial( + Option, + '--implementation', + dest='implementation', + metavar='implementation', + default=None, + help=("Only use wheels compatible with Python " + "implementation , e.g. 'pp', 'jy', 'cp', " + " or 'ip'. If not specified, then the current " + "interpreter implementation is used. Use 'py' to force " + "implementation-agnostic wheels."), +) # type: Callable[..., Option] + + +abi = partial( + Option, + '--abi', + dest='abi', + metavar='abi', + default=None, + help=("Only use wheels compatible with Python " + "abi , e.g. 'pypy_41'. If not specified, then the " + "current interpreter abi tag is used. Generally " + "you will need to specify --implementation, " + "--platform, and --python-version when using " + "this option."), +) # type: Callable[..., Option] + + +def add_target_python_options(cmd_opts): + # type: (OptionGroup) -> None + cmd_opts.add_option(platform()) + cmd_opts.add_option(python_version()) + cmd_opts.add_option(implementation()) + cmd_opts.add_option(abi()) + + +def make_target_python(options): + # type: (Values) -> TargetPython + target_python = TargetPython( + platform=options.platform, + py_version_info=options.python_version, + abi=options.abi, + implementation=options.implementation, + ) + + return target_python + + +def prefer_binary(): + # type: () -> Option + return Option( + "--prefer-binary", + dest="prefer_binary", + action="store_true", + default=False, + help="Prefer older binary packages over newer source packages." + ) + + +cache_dir = partial( + PipOption, + "--cache-dir", + dest="cache_dir", + default=USER_CACHE_DIR, + metavar="dir", + type='path', + help="Store the cache data in ." +) # type: Callable[..., Option] + + +def _handle_no_cache_dir(option, opt, value, parser): + # type: (Option, str, str, OptionParser) -> None + """ + Process a value provided for the --no-cache-dir option. + + This is an optparse.Option callback for the --no-cache-dir option. + """ + # The value argument will be None if --no-cache-dir is passed via the + # command-line, since the option doesn't accept arguments. However, + # the value can be non-None if the option is triggered e.g. by an + # environment variable, like PIP_NO_CACHE_DIR=true. + if value is not None: + # Then parse the string value to get argument error-checking. + try: + strtobool(value) + except ValueError as exc: + raise_option_error(parser, option=option, msg=str(exc)) + + # Originally, setting PIP_NO_CACHE_DIR to a value that strtobool() + # converted to 0 (like "false" or "no") caused cache_dir to be disabled + # rather than enabled (logic would say the latter). Thus, we disable + # the cache directory not just on values that parse to True, but (for + # backwards compatibility reasons) also on values that parse to False. + # In other words, always set it to False if the option is provided in + # some (valid) form. + parser.values.cache_dir = False + + +no_cache = partial( + Option, + "--no-cache-dir", + dest="cache_dir", + action="callback", + callback=_handle_no_cache_dir, + help="Disable the cache.", +) # type: Callable[..., Option] + +no_deps = partial( + Option, + '--no-deps', '--no-dependencies', + dest='ignore_dependencies', + action='store_true', + default=False, + help="Don't install package dependencies.", +) # type: Callable[..., Option] + + +def _handle_build_dir(option, opt, value, parser): + # type: (Option, str, str, OptionParser) -> None + if value: + value = os.path.abspath(value) + setattr(parser.values, option.dest, value) + + +build_dir = partial( + PipOption, + '-b', '--build', '--build-dir', '--build-directory', + dest='build_dir', + type='path', + metavar='dir', + action='callback', + callback=_handle_build_dir, + help='Directory to unpack packages into and build in. Note that ' + 'an initial build still takes place in a temporary directory. ' + 'The location of temporary directories can be controlled by setting ' + 'the TMPDIR environment variable (TEMP on Windows) appropriately. ' + 'When passed, build directories are not cleaned in case of failures.' +) # type: Callable[..., Option] + +ignore_requires_python = partial( + Option, + '--ignore-requires-python', + dest='ignore_requires_python', + action='store_true', + help='Ignore the Requires-Python information.' +) # type: Callable[..., Option] + +no_build_isolation = partial( + Option, + '--no-build-isolation', + dest='build_isolation', + action='store_false', + default=True, + help='Disable isolation when building a modern source distribution. ' + 'Build dependencies specified by PEP 518 must be already installed ' + 'if this option is used.' +) # type: Callable[..., Option] + + +def _handle_no_use_pep517(option, opt, value, parser): + # type: (Option, str, str, OptionParser) -> None + """ + Process a value provided for the --no-use-pep517 option. + + This is an optparse.Option callback for the no_use_pep517 option. + """ + # Since --no-use-pep517 doesn't accept arguments, the value argument + # will be None if --no-use-pep517 is passed via the command-line. + # However, the value can be non-None if the option is triggered e.g. + # by an environment variable, for example "PIP_NO_USE_PEP517=true". + if value is not None: + msg = """A value was passed for --no-use-pep517, + probably using either the PIP_NO_USE_PEP517 environment variable + or the "no-use-pep517" config file option. Use an appropriate value + of the PIP_USE_PEP517 environment variable or the "use-pep517" + config file option instead. + """ + raise_option_error(parser, option=option, msg=msg) + + # Otherwise, --no-use-pep517 was passed via the command-line. + parser.values.use_pep517 = False + + +use_pep517 = partial( + Option, + '--use-pep517', + dest='use_pep517', + action='store_true', + default=None, + help='Use PEP 517 for building source distributions ' + '(use --no-use-pep517 to force legacy behaviour).' +) # type: Any + +no_use_pep517 = partial( + Option, + '--no-use-pep517', + dest='use_pep517', + action='callback', + callback=_handle_no_use_pep517, + default=None, + help=SUPPRESS_HELP +) # type: Any + +install_options = partial( + Option, + '--install-option', + dest='install_options', + action='append', + metavar='options', + help="Extra arguments to be supplied to the setup.py install " + "command (use like --install-option=\"--install-scripts=/usr/local/" + "bin\"). Use multiple --install-option options to pass multiple " + "options to setup.py install. If you are using an option with a " + "directory path, be sure to use absolute path.", +) # type: Callable[..., Option] + +global_options = partial( + Option, + '--global-option', + dest='global_options', + action='append', + metavar='options', + help="Extra global options to be supplied to the setup.py " + "call before the install command.", +) # type: Callable[..., Option] + +no_clean = partial( + Option, + '--no-clean', + action='store_true', + default=False, + help="Don't clean up build directories." +) # type: Callable[..., Option] + +pre = partial( + Option, + '--pre', + action='store_true', + default=False, + help="Include pre-release and development versions. By default, " + "pip only finds stable versions.", +) # type: Callable[..., Option] + +disable_pip_version_check = partial( + Option, + "--disable-pip-version-check", + dest="disable_pip_version_check", + action="store_true", + default=True, + help="Don't periodically check PyPI to determine whether a new version " + "of pip is available for download. Implied with --no-index.", +) # type: Callable[..., Option] + + +# Deprecated, Remove later +always_unzip = partial( + Option, + '-Z', '--always-unzip', + dest='always_unzip', + action='store_true', + help=SUPPRESS_HELP, +) # type: Callable[..., Option] + + +def _handle_merge_hash(option, opt_str, value, parser): + # type: (Option, str, str, OptionParser) -> None + """Given a value spelled "algo:digest", append the digest to a list + pointed to in a dict by the algo name.""" + if not parser.values.hashes: + parser.values.hashes = {} + try: + algo, digest = value.split(':', 1) + except ValueError: + parser.error('Arguments to %s must be a hash name ' + 'followed by a value, like --hash=sha256:abcde...' % + opt_str) + if algo not in STRONG_HASHES: + parser.error('Allowed hash algorithms for %s are %s.' % + (opt_str, ', '.join(STRONG_HASHES))) + parser.values.hashes.setdefault(algo, []).append(digest) + + +hash = partial( + Option, + '--hash', + # Hash values eventually end up in InstallRequirement.hashes due to + # __dict__ copying in process_line(). + dest='hashes', + action='callback', + callback=_handle_merge_hash, + type='string', + help="Verify that the package's archive matches this " + 'hash before installing. Example: --hash=sha256:abcdef...', +) # type: Callable[..., Option] + + +require_hashes = partial( + Option, + '--require-hashes', + dest='require_hashes', + action='store_true', + default=False, + help='Require a hash to check each requirement against, for ' + 'repeatable installs. This option is implied when any package in a ' + 'requirements file has a --hash option.', +) # type: Callable[..., Option] + + +list_path = partial( + PipOption, + '--path', + dest='path', + type='path', + action='append', + help='Restrict to the specified installation path for listing ' + 'packages (can be used multiple times).' +) # type: Callable[..., Option] + + +def check_list_path_option(options): + # type: (Values) -> None + if options.path and (options.user or options.local): + raise CommandError( + "Cannot combine '--path' with '--user' or '--local'" + ) + + +no_python_version_warning = partial( + Option, + '--no-python-version-warning', + dest='no_python_version_warning', + action='store_true', + default=False, + help='Silence deprecation warnings for upcoming unsupported Pythons.', +) # type: Callable[..., Option] + + +########## +# groups # +########## + +general_group = { + 'name': 'General Options', + 'options': [ + help_, + isolated_mode, + require_virtualenv, + verbose, + version, + quiet, + log, + no_input, + proxy, + retries, + timeout, + skip_requirements_regex, + exists_action, + trusted_host, + cert, + client_cert, + cache_dir, + no_cache, + disable_pip_version_check, + no_color, + no_python_version_warning, + ] +} # type: Dict[str, Any] + +index_group = { + 'name': 'Package Index Options', + 'options': [ + index_url, + extra_index_url, + no_index, + find_links, + ] +} # type: Dict[str, Any] diff --git a/venv/lib/python3.8/site-packages/pip/_internal/cli/command_context.py b/venv/lib/python3.8/site-packages/pip/_internal/cli/command_context.py new file mode 100644 index 000000000..d1a64a776 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/cli/command_context.py @@ -0,0 +1,36 @@ +from contextlib import contextmanager + +from pip._vendor.contextlib2 import ExitStack + +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import Iterator, ContextManager, TypeVar + + _T = TypeVar('_T', covariant=True) + + +class CommandContextMixIn(object): + def __init__(self): + # type: () -> None + super(CommandContextMixIn, self).__init__() + self._in_main_context = False + self._main_context = ExitStack() + + @contextmanager + def main_context(self): + # type: () -> Iterator[None] + assert not self._in_main_context + + self._in_main_context = True + try: + with self._main_context: + yield + finally: + self._in_main_context = False + + def enter_context(self, context_provider): + # type: (ContextManager[_T]) -> _T + assert self._in_main_context + + return self._main_context.enter_context(context_provider) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/cli/main.py b/venv/lib/python3.8/site-packages/pip/_internal/cli/main.py new file mode 100644 index 000000000..5e97a5103 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/cli/main.py @@ -0,0 +1,75 @@ +"""Primary application entrypoint. +""" +from __future__ import absolute_import + +import locale +import logging +import os +import sys + +from pip._internal.cli.autocompletion import autocomplete +from pip._internal.cli.main_parser import parse_command +from pip._internal.commands import create_command +from pip._internal.exceptions import PipError +from pip._internal.utils import deprecation +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import List, Optional + +logger = logging.getLogger(__name__) + + +# Do not import and use main() directly! Using it directly is actively +# discouraged by pip's maintainers. The name, location and behavior of +# this function is subject to change, so calling it directly is not +# portable across different pip versions. + +# In addition, running pip in-process is unsupported and unsafe. This is +# elaborated in detail at +# https://pip.pypa.io/en/stable/user_guide/#using-pip-from-your-program. +# That document also provides suggestions that should work for nearly +# all users that are considering importing and using main() directly. + +# However, we know that certain users will still want to invoke pip +# in-process. If you understand and accept the implications of using pip +# in an unsupported manner, the best approach is to use runpy to avoid +# depending on the exact location of this entry point. + +# The following example shows how to use runpy to invoke pip in that +# case: +# +# sys.argv = ["pip", your, args, here] +# runpy.run_module("pip", run_name="__main__") +# +# Note that this will exit the process after running, unlike a direct +# call to main. As it is not safe to do any processing after calling +# main, this should not be an issue in practice. + +def main(args=None): + # type: (Optional[List[str]]) -> int + if args is None: + args = sys.argv[1:] + + # Configure our deprecation warnings to be sent through loggers + deprecation.install_warning_logger() + + autocomplete() + + try: + cmd_name, cmd_args = parse_command(args) + except PipError as exc: + sys.stderr.write("ERROR: %s" % exc) + sys.stderr.write(os.linesep) + sys.exit(1) + + # Needed for locale.getpreferredencoding(False) to work + # in pip._internal.utils.encoding.auto_decode + try: + locale.setlocale(locale.LC_ALL, '') + except locale.Error as e: + # setlocale can apparently crash if locale are uninitialized + logger.debug("Ignoring error %s when setting locale", e) + command = create_command(cmd_name, isolated=("--isolated" in cmd_args)) + + return command.main(cmd_args) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/cli/main_parser.py b/venv/lib/python3.8/site-packages/pip/_internal/cli/main_parser.py new file mode 100644 index 000000000..a89821d44 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/cli/main_parser.py @@ -0,0 +1,99 @@ +"""A single place for constructing and exposing the main parser +""" + +import os +import sys + +from pip._internal.cli import cmdoptions +from pip._internal.cli.parser import ( + ConfigOptionParser, + UpdatingDefaultsHelpFormatter, +) +from pip._internal.commands import commands_dict, get_similar_commands +from pip._internal.exceptions import CommandError +from pip._internal.utils.misc import get_pip_version, get_prog +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import Tuple, List + + +__all__ = ["create_main_parser", "parse_command"] + + +def create_main_parser(): + # type: () -> ConfigOptionParser + """Creates and returns the main parser for pip's CLI + """ + + parser_kw = { + 'usage': '\n%prog [options]', + 'add_help_option': False, + 'formatter': UpdatingDefaultsHelpFormatter(), + 'name': 'global', + 'prog': get_prog(), + } + + parser = ConfigOptionParser(**parser_kw) + parser.disable_interspersed_args() + + parser.version = get_pip_version() + + # add the general options + gen_opts = cmdoptions.make_option_group(cmdoptions.general_group, parser) + parser.add_option_group(gen_opts) + + # so the help formatter knows + parser.main = True # type: ignore + + # create command listing for description + description = [''] + [ + '%-27s %s' % (name, command_info.summary) + for name, command_info in commands_dict.items() + ] + parser.description = '\n'.join(description) + + return parser + + +def parse_command(args): + # type: (List[str]) -> Tuple[str, List[str]] + parser = create_main_parser() + + # Note: parser calls disable_interspersed_args(), so the result of this + # call is to split the initial args into the general options before the + # subcommand and everything else. + # For example: + # args: ['--timeout=5', 'install', '--user', 'INITools'] + # general_options: ['--timeout==5'] + # args_else: ['install', '--user', 'INITools'] + general_options, args_else = parser.parse_args(args) + + # --version + if general_options.version: + sys.stdout.write(parser.version) # type: ignore + sys.stdout.write(os.linesep) + sys.exit() + + # pip || pip help -> print_help() + if not args_else or (args_else[0] == 'help' and len(args_else) == 1): + parser.print_help() + sys.exit() + + # the subcommand name + cmd_name = args_else[0] + + if cmd_name not in commands_dict: + guess = get_similar_commands(cmd_name) + + msg = ['unknown command "%s"' % cmd_name] + if guess: + msg.append('maybe you meant "%s"' % guess) + + raise CommandError(' - '.join(msg)) + + # all the args without the subcommand + cmd_args = args[:] + cmd_args.remove(cmd_name) + + return cmd_name, cmd_args diff --git a/venv/lib/python3.8/site-packages/pip/_internal/cli/parser.py b/venv/lib/python3.8/site-packages/pip/_internal/cli/parser.py new file mode 100644 index 000000000..c99456bae --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/cli/parser.py @@ -0,0 +1,265 @@ +"""Base option parser setup""" + +# The following comment should be removed at some point in the future. +# mypy: disallow-untyped-defs=False + +from __future__ import absolute_import + +import logging +import optparse +import sys +import textwrap +from distutils.util import strtobool + +from pip._vendor.six import string_types + +from pip._internal.cli.status_codes import UNKNOWN_ERROR +from pip._internal.configuration import Configuration, ConfigurationError +from pip._internal.utils.compat import get_terminal_size + +logger = logging.getLogger(__name__) + + +class PrettyHelpFormatter(optparse.IndentedHelpFormatter): + """A prettier/less verbose help formatter for optparse.""" + + def __init__(self, *args, **kwargs): + # help position must be aligned with __init__.parseopts.description + kwargs['max_help_position'] = 30 + kwargs['indent_increment'] = 1 + kwargs['width'] = get_terminal_size()[0] - 2 + optparse.IndentedHelpFormatter.__init__(self, *args, **kwargs) + + def format_option_strings(self, option): + return self._format_option_strings(option, ' <%s>', ', ') + + def _format_option_strings(self, option, mvarfmt=' <%s>', optsep=', '): + """ + Return a comma-separated list of option strings and metavars. + + :param option: tuple of (short opt, long opt), e.g: ('-f', '--format') + :param mvarfmt: metavar format string - evaluated as mvarfmt % metavar + :param optsep: separator + """ + opts = [] + + if option._short_opts: + opts.append(option._short_opts[0]) + if option._long_opts: + opts.append(option._long_opts[0]) + if len(opts) > 1: + opts.insert(1, optsep) + + if option.takes_value(): + metavar = option.metavar or option.dest.lower() + opts.append(mvarfmt % metavar.lower()) + + return ''.join(opts) + + def format_heading(self, heading): + if heading == 'Options': + return '' + return heading + ':\n' + + def format_usage(self, usage): + """ + Ensure there is only one newline between usage and the first heading + if there is no description. + """ + msg = '\nUsage: %s\n' % self.indent_lines(textwrap.dedent(usage), " ") + return msg + + def format_description(self, description): + # leave full control over description to us + if description: + if hasattr(self.parser, 'main'): + label = 'Commands' + else: + label = 'Description' + # some doc strings have initial newlines, some don't + description = description.lstrip('\n') + # some doc strings have final newlines and spaces, some don't + description = description.rstrip() + # dedent, then reindent + description = self.indent_lines(textwrap.dedent(description), " ") + description = '%s:\n%s\n' % (label, description) + return description + else: + return '' + + def format_epilog(self, epilog): + # leave full control over epilog to us + if epilog: + return epilog + else: + return '' + + def indent_lines(self, text, indent): + new_lines = [indent + line for line in text.split('\n')] + return "\n".join(new_lines) + + +class UpdatingDefaultsHelpFormatter(PrettyHelpFormatter): + """Custom help formatter for use in ConfigOptionParser. + + This is updates the defaults before expanding them, allowing + them to show up correctly in the help listing. + """ + + def expand_default(self, option): + if self.parser is not None: + self.parser._update_defaults(self.parser.defaults) + return optparse.IndentedHelpFormatter.expand_default(self, option) + + +class CustomOptionParser(optparse.OptionParser): + + def insert_option_group(self, idx, *args, **kwargs): + """Insert an OptionGroup at a given position.""" + group = self.add_option_group(*args, **kwargs) + + self.option_groups.pop() + self.option_groups.insert(idx, group) + + return group + + @property + def option_list_all(self): + """Get a list of all options, including those in option groups.""" + res = self.option_list[:] + for i in self.option_groups: + res.extend(i.option_list) + + return res + + +class ConfigOptionParser(CustomOptionParser): + """Custom option parser which updates its defaults by checking the + configuration files and environmental variables""" + + def __init__(self, *args, **kwargs): + self.name = kwargs.pop('name') + + isolated = kwargs.pop("isolated", False) + self.config = Configuration(isolated) + + assert self.name + optparse.OptionParser.__init__(self, *args, **kwargs) + + def check_default(self, option, key, val): + try: + return option.check_value(key, val) + except optparse.OptionValueError as exc: + print("An error occurred during configuration: %s" % exc) + sys.exit(3) + + def _get_ordered_configuration_items(self): + # Configuration gives keys in an unordered manner. Order them. + override_order = ["global", self.name, ":env:"] + + # Pool the options into different groups + section_items = {name: [] for name in override_order} + for section_key, val in self.config.items(): + # ignore empty values + if not val: + logger.debug( + "Ignoring configuration key '%s' as it's value is empty.", + section_key + ) + continue + + section, key = section_key.split(".", 1) + if section in override_order: + section_items[section].append((key, val)) + + # Yield each group in their override order + for section in override_order: + for key, val in section_items[section]: + yield key, val + + def _update_defaults(self, defaults): + """Updates the given defaults with values from the config files and + the environ. Does a little special handling for certain types of + options (lists).""" + + # Accumulate complex default state. + self.values = optparse.Values(self.defaults) + late_eval = set() + # Then set the options with those values + for key, val in self._get_ordered_configuration_items(): + # '--' because configuration supports only long names + option = self.get_option('--' + key) + + # Ignore options not present in this parser. E.g. non-globals put + # in [global] by users that want them to apply to all applicable + # commands. + if option is None: + continue + + if option.action in ('store_true', 'store_false', 'count'): + try: + val = strtobool(val) + except ValueError: + error_msg = invalid_config_error_message( + option.action, key, val + ) + self.error(error_msg) + + elif option.action == 'append': + val = val.split() + val = [self.check_default(option, key, v) for v in val] + elif option.action == 'callback': + late_eval.add(option.dest) + opt_str = option.get_opt_string() + val = option.convert_value(opt_str, val) + # From take_action + args = option.callback_args or () + kwargs = option.callback_kwargs or {} + option.callback(option, opt_str, val, self, *args, **kwargs) + else: + val = self.check_default(option, key, val) + + defaults[option.dest] = val + + for key in late_eval: + defaults[key] = getattr(self.values, key) + self.values = None + return defaults + + def get_default_values(self): + """Overriding to make updating the defaults after instantiation of + the option parser possible, _update_defaults() does the dirty work.""" + if not self.process_default_values: + # Old, pre-Optik 1.5 behaviour. + return optparse.Values(self.defaults) + + # Load the configuration, or error out in case of an error + try: + self.config.load() + except ConfigurationError as err: + self.exit(UNKNOWN_ERROR, str(err)) + + defaults = self._update_defaults(self.defaults.copy()) # ours + for option in self._get_all_options(): + default = defaults.get(option.dest) + if isinstance(default, string_types): + opt_str = option.get_opt_string() + defaults[option.dest] = option.check_value(opt_str, default) + return optparse.Values(defaults) + + def error(self, msg): + self.print_usage(sys.stderr) + self.exit(UNKNOWN_ERROR, "%s\n" % msg) + + +def invalid_config_error_message(action, key, val): + """Returns a better error message when invalid configuration option + is provided.""" + if action in ('store_true', 'store_false'): + return ("{0} is not a valid value for {1} option, " + "please specify a boolean value like yes/no, " + "true/false or 1/0 instead.").format(val, key) + + return ("{0} is not a valid value for {1} option, " + "please specify a numerical value like 1/0 " + "instead.").format(val, key) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/cli/req_command.py b/venv/lib/python3.8/site-packages/pip/_internal/cli/req_command.py new file mode 100644 index 000000000..9383b3b8d --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/cli/req_command.py @@ -0,0 +1,333 @@ +"""Contains the Command base classes that depend on PipSession. + +The classes in this module are in a separate module so the commands not +needing download / PackageFinder capability don't unnecessarily import the +PackageFinder machinery and all its vendored dependencies, etc. +""" + +import logging +import os +from functools import partial + +from pip._internal.cli.base_command import Command +from pip._internal.cli.command_context import CommandContextMixIn +from pip._internal.exceptions import CommandError +from pip._internal.index.package_finder import PackageFinder +from pip._internal.legacy_resolve import Resolver +from pip._internal.models.selection_prefs import SelectionPreferences +from pip._internal.network.download import Downloader +from pip._internal.network.session import PipSession +from pip._internal.operations.prepare import RequirementPreparer +from pip._internal.req.constructors import ( + install_req_from_editable, + install_req_from_line, + install_req_from_req_string, +) +from pip._internal.req.req_file import parse_requirements +from pip._internal.self_outdated_check import ( + make_link_collector, + pip_self_version_check, +) +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from optparse import Values + from typing import List, Optional, Tuple + from pip._internal.cache import WheelCache + from pip._internal.models.target_python import TargetPython + from pip._internal.req.req_set import RequirementSet + from pip._internal.req.req_tracker import RequirementTracker + from pip._internal.utils.temp_dir import TempDirectory + +logger = logging.getLogger(__name__) + + +class SessionCommandMixin(CommandContextMixIn): + + """ + A class mixin for command classes needing _build_session(). + """ + def __init__(self): + # type: () -> None + super(SessionCommandMixin, self).__init__() + self._session = None # Optional[PipSession] + + @classmethod + def _get_index_urls(cls, options): + # type: (Values) -> Optional[List[str]] + """Return a list of index urls from user-provided options.""" + index_urls = [] + if not getattr(options, "no_index", False): + url = getattr(options, "index_url", None) + if url: + index_urls.append(url) + urls = getattr(options, "extra_index_urls", None) + if urls: + index_urls.extend(urls) + # Return None rather than an empty list + return index_urls or None + + def get_default_session(self, options): + # type: (Values) -> PipSession + """Get a default-managed session.""" + if self._session is None: + self._session = self.enter_context(self._build_session(options)) + # there's no type annotation on requests.Session, so it's + # automatically ContextManager[Any] and self._session becomes Any, + # then https://github.com/python/mypy/issues/7696 kicks in + assert self._session is not None + return self._session + + def _build_session(self, options, retries=None, timeout=None): + # type: (Values, Optional[int], Optional[int]) -> PipSession + assert not options.cache_dir or os.path.isabs(options.cache_dir) + session = PipSession( + cache=( + os.path.join(options.cache_dir, "http") + if options.cache_dir else None + ), + retries=retries if retries is not None else options.retries, + trusted_hosts=options.trusted_hosts, + index_urls=self._get_index_urls(options), + ) + + # Handle custom ca-bundles from the user + if options.cert: + session.verify = options.cert + + # Handle SSL client certificate + if options.client_cert: + session.cert = options.client_cert + + # Handle timeouts + if options.timeout or timeout: + session.timeout = ( + timeout if timeout is not None else options.timeout + ) + + # Handle configured proxies + if options.proxy: + session.proxies = { + "http": options.proxy, + "https": options.proxy, + } + + # Determine if we can prompt the user for authentication or not + session.auth.prompting = not options.no_input + + return session + + +class IndexGroupCommand(Command, SessionCommandMixin): + + """ + Abstract base class for commands with the index_group options. + + This also corresponds to the commands that permit the pip version check. + """ + + def handle_pip_version_check(self, options): + # type: (Values) -> None + """ + Do the pip version check if not disabled. + + This overrides the default behavior of not doing the check. + """ + # Make sure the index_group options are present. + assert hasattr(options, 'no_index') + + if options.disable_pip_version_check or options.no_index: + return + + # Otherwise, check if we're using the latest version of pip available. + session = self._build_session( + options, + retries=0, + timeout=min(5, options.timeout) + ) + with session: + pip_self_version_check(session, options) + + +class RequirementCommand(IndexGroupCommand): + + @staticmethod + def make_requirement_preparer( + temp_build_dir, # type: TempDirectory + options, # type: Values + req_tracker, # type: RequirementTracker + session, # type: PipSession + finder, # type: PackageFinder + use_user_site, # type: bool + download_dir=None, # type: str + wheel_download_dir=None, # type: str + ): + # type: (...) -> RequirementPreparer + """ + Create a RequirementPreparer instance for the given parameters. + """ + downloader = Downloader(session, progress_bar=options.progress_bar) + + temp_build_dir_path = temp_build_dir.path + assert temp_build_dir_path is not None + + return RequirementPreparer( + build_dir=temp_build_dir_path, + src_dir=options.src_dir, + download_dir=download_dir, + wheel_download_dir=wheel_download_dir, + build_isolation=options.build_isolation, + req_tracker=req_tracker, + downloader=downloader, + finder=finder, + require_hashes=options.require_hashes, + use_user_site=use_user_site, + ) + + @staticmethod + def make_resolver( + preparer, # type: RequirementPreparer + finder, # type: PackageFinder + options, # type: Values + wheel_cache=None, # type: Optional[WheelCache] + use_user_site=False, # type: bool + ignore_installed=True, # type: bool + ignore_requires_python=False, # type: bool + force_reinstall=False, # type: bool + upgrade_strategy="to-satisfy-only", # type: str + use_pep517=None, # type: Optional[bool] + py_version_info=None # type: Optional[Tuple[int, ...]] + ): + # type: (...) -> Resolver + """ + Create a Resolver instance for the given parameters. + """ + make_install_req = partial( + install_req_from_req_string, + isolated=options.isolated_mode, + wheel_cache=wheel_cache, + use_pep517=use_pep517, + ) + return Resolver( + preparer=preparer, + finder=finder, + make_install_req=make_install_req, + use_user_site=use_user_site, + ignore_dependencies=options.ignore_dependencies, + ignore_installed=ignore_installed, + ignore_requires_python=ignore_requires_python, + force_reinstall=force_reinstall, + upgrade_strategy=upgrade_strategy, + py_version_info=py_version_info, + ) + + def populate_requirement_set( + self, + requirement_set, # type: RequirementSet + args, # type: List[str] + options, # type: Values + finder, # type: PackageFinder + session, # type: PipSession + wheel_cache, # type: Optional[WheelCache] + ): + # type: (...) -> None + """ + Marshal cmd line args into a requirement set. + """ + for filename in options.constraints: + for req_to_add in parse_requirements( + filename, + constraint=True, finder=finder, options=options, + session=session, wheel_cache=wheel_cache): + req_to_add.is_direct = True + requirement_set.add_requirement(req_to_add) + + for req in args: + req_to_add = install_req_from_line( + req, None, isolated=options.isolated_mode, + use_pep517=options.use_pep517, + wheel_cache=wheel_cache + ) + req_to_add.is_direct = True + requirement_set.add_requirement(req_to_add) + + for req in options.editables: + req_to_add = install_req_from_editable( + req, + isolated=options.isolated_mode, + use_pep517=options.use_pep517, + wheel_cache=wheel_cache + ) + req_to_add.is_direct = True + requirement_set.add_requirement(req_to_add) + + # NOTE: options.require_hashes may be set if --require-hashes is True + for filename in options.requirements: + for req_to_add in parse_requirements( + filename, + finder=finder, options=options, session=session, + wheel_cache=wheel_cache, + use_pep517=options.use_pep517): + req_to_add.is_direct = True + requirement_set.add_requirement(req_to_add) + + # If any requirement has hash options, enable hash checking. + requirements = ( + requirement_set.unnamed_requirements + + list(requirement_set.requirements.values()) + ) + if any(req.has_hash_options for req in requirements): + options.require_hashes = True + + if not (args or options.editables or options.requirements): + opts = {'name': self.name} + if options.find_links: + raise CommandError( + 'You must give at least one requirement to %(name)s ' + '(maybe you meant "pip %(name)s %(links)s"?)' % + dict(opts, links=' '.join(options.find_links))) + else: + raise CommandError( + 'You must give at least one requirement to %(name)s ' + '(see "pip help %(name)s")' % opts) + + @staticmethod + def trace_basic_info(finder): + # type: (PackageFinder) -> None + """ + Trace basic information about the provided objects. + """ + # Display where finder is looking for packages + search_scope = finder.search_scope + locations = search_scope.get_formatted_locations() + if locations: + logger.info(locations) + + def _build_package_finder( + self, + options, # type: Values + session, # type: PipSession + target_python=None, # type: Optional[TargetPython] + ignore_requires_python=None, # type: Optional[bool] + ): + # type: (...) -> PackageFinder + """ + Create a package finder appropriate to this requirement command. + + :param ignore_requires_python: Whether to ignore incompatible + "Requires-Python" values in links. Defaults to False. + """ + link_collector = make_link_collector(session, options=options) + selection_prefs = SelectionPreferences( + allow_yanked=True, + format_control=options.format_control, + allow_all_prereleases=options.pre, + prefer_binary=options.prefer_binary, + ignore_requires_python=ignore_requires_python, + ) + + return PackageFinder.create( + link_collector=link_collector, + selection_prefs=selection_prefs, + target_python=target_python, + ) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/cli/status_codes.py b/venv/lib/python3.8/site-packages/pip/_internal/cli/status_codes.py new file mode 100644 index 000000000..275360a31 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/cli/status_codes.py @@ -0,0 +1,8 @@ +from __future__ import absolute_import + +SUCCESS = 0 +ERROR = 1 +UNKNOWN_ERROR = 2 +VIRTUALENV_NOT_FOUND = 3 +PREVIOUS_BUILD_DIR_ERROR = 4 +NO_MATCHES_FOUND = 23 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/commands/__init__.py b/venv/lib/python3.8/site-packages/pip/_internal/commands/__init__.py new file mode 100644 index 000000000..2a311f8fc --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/commands/__init__.py @@ -0,0 +1,114 @@ +""" +Package containing all pip commands +""" + +# The following comment should be removed at some point in the future. +# mypy: disallow-untyped-defs=False + +from __future__ import absolute_import + +import importlib +from collections import OrderedDict, namedtuple + +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import Any + from pip._internal.cli.base_command import Command + + +CommandInfo = namedtuple('CommandInfo', 'module_path, class_name, summary') + +# The ordering matters for help display. +# Also, even though the module path starts with the same +# "pip._internal.commands" prefix in each case, we include the full path +# because it makes testing easier (specifically when modifying commands_dict +# in test setup / teardown by adding info for a FakeCommand class defined +# in a test-related module). +# Finally, we need to pass an iterable of pairs here rather than a dict +# so that the ordering won't be lost when using Python 2.7. +commands_dict = OrderedDict([ + ('install', CommandInfo( + 'pip._internal.commands.install', 'InstallCommand', + 'Install packages.', + )), + ('download', CommandInfo( + 'pip._internal.commands.download', 'DownloadCommand', + 'Download packages.', + )), + ('uninstall', CommandInfo( + 'pip._internal.commands.uninstall', 'UninstallCommand', + 'Uninstall packages.', + )), + ('freeze', CommandInfo( + 'pip._internal.commands.freeze', 'FreezeCommand', + 'Output installed packages in requirements format.', + )), + ('list', CommandInfo( + 'pip._internal.commands.list', 'ListCommand', + 'List installed packages.', + )), + ('show', CommandInfo( + 'pip._internal.commands.show', 'ShowCommand', + 'Show information about installed packages.', + )), + ('check', CommandInfo( + 'pip._internal.commands.check', 'CheckCommand', + 'Verify installed packages have compatible dependencies.', + )), + ('config', CommandInfo( + 'pip._internal.commands.configuration', 'ConfigurationCommand', + 'Manage local and global configuration.', + )), + ('search', CommandInfo( + 'pip._internal.commands.search', 'SearchCommand', + 'Search PyPI for packages.', + )), + ('wheel', CommandInfo( + 'pip._internal.commands.wheel', 'WheelCommand', + 'Build wheels from your requirements.', + )), + ('hash', CommandInfo( + 'pip._internal.commands.hash', 'HashCommand', + 'Compute hashes of package archives.', + )), + ('completion', CommandInfo( + 'pip._internal.commands.completion', 'CompletionCommand', + 'A helper command used for command completion.', + )), + ('debug', CommandInfo( + 'pip._internal.commands.debug', 'DebugCommand', + 'Show information useful for debugging.', + )), + ('help', CommandInfo( + 'pip._internal.commands.help', 'HelpCommand', + 'Show help for commands.', + )), +]) # type: OrderedDict[str, CommandInfo] + + +def create_command(name, **kwargs): + # type: (str, **Any) -> Command + """ + Create an instance of the Command class with the given name. + """ + module_path, class_name, summary = commands_dict[name] + module = importlib.import_module(module_path) + command_class = getattr(module, class_name) + command = command_class(name=name, summary=summary, **kwargs) + + return command + + +def get_similar_commands(name): + """Command name auto-correct.""" + from difflib import get_close_matches + + name = name.lower() + + close_commands = get_close_matches(name, commands_dict.keys()) + + if close_commands: + return close_commands[0] + else: + return False diff --git a/venv/lib/python3.8/site-packages/pip/_internal/commands/__pycache__/__init__.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/commands/__pycache__/__init__.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4b952c41ee9fbce183587329c3c2da9dc99dc1d7 GIT binary patch literal 2881 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 literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/commands/check.py b/venv/lib/python3.8/site-packages/pip/_internal/commands/check.py new file mode 100644 index 000000000..968944611 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/commands/check.py @@ -0,0 +1,45 @@ +# The following comment should be removed at some point in the future. +# mypy: disallow-untyped-defs=False + +import logging + +from pip._internal.cli.base_command import Command +from pip._internal.operations.check import ( + check_package_set, + create_package_set_from_installed, +) +from pip._internal.utils.misc import write_output + +logger = logging.getLogger(__name__) + + +class CheckCommand(Command): + """Verify installed packages have compatible dependencies.""" + + usage = """ + %prog [options]""" + + def run(self, options, args): + package_set, parsing_probs = create_package_set_from_installed() + missing, conflicting = check_package_set(package_set) + + for project_name in missing: + version = package_set[project_name].version + for dependency in missing[project_name]: + write_output( + "%s %s requires %s, which is not installed.", + project_name, version, dependency[0], + ) + + for project_name in conflicting: + version = package_set[project_name].version + for dep_name, dep_version, req in conflicting[project_name]: + write_output( + "%s %s has requirement %s, but you have %s %s.", + project_name, version, req, dep_name, dep_version, + ) + + if missing or conflicting or parsing_probs: + return 1 + else: + write_output("No broken requirements found.") diff --git a/venv/lib/python3.8/site-packages/pip/_internal/commands/completion.py b/venv/lib/python3.8/site-packages/pip/_internal/commands/completion.py new file mode 100644 index 000000000..c532806e3 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/commands/completion.py @@ -0,0 +1,96 @@ +# The following comment should be removed at some point in the future. +# mypy: disallow-untyped-defs=False + +from __future__ import absolute_import + +import sys +import textwrap + +from pip._internal.cli.base_command import Command +from pip._internal.utils.misc import get_prog + +BASE_COMPLETION = """ +# pip %(shell)s completion start%(script)s# pip %(shell)s completion end +""" + +COMPLETION_SCRIPTS = { + 'bash': """ + _pip_completion() + { + COMPREPLY=( $( COMP_WORDS="${COMP_WORDS[*]}" \\ + COMP_CWORD=$COMP_CWORD \\ + PIP_AUTO_COMPLETE=1 $1 2>/dev/null ) ) + } + complete -o default -F _pip_completion %(prog)s + """, + 'zsh': """ + function _pip_completion { + local words cword + read -Ac words + read -cn cword + reply=( $( COMP_WORDS="$words[*]" \\ + COMP_CWORD=$(( cword-1 )) \\ + PIP_AUTO_COMPLETE=1 $words[1] 2>/dev/null )) + } + compctl -K _pip_completion %(prog)s + """, + 'fish': """ + function __fish_complete_pip + set -lx COMP_WORDS (commandline -o) "" + set -lx COMP_CWORD ( \\ + math (contains -i -- (commandline -t) $COMP_WORDS)-1 \\ + ) + set -lx PIP_AUTO_COMPLETE 1 + string split \\ -- (eval $COMP_WORDS[1]) + end + complete -fa "(__fish_complete_pip)" -c %(prog)s + """, +} + + +class CompletionCommand(Command): + """A helper command to be used for command completion.""" + + ignore_require_venv = True + + def __init__(self, *args, **kw): + super(CompletionCommand, self).__init__(*args, **kw) + + cmd_opts = self.cmd_opts + + cmd_opts.add_option( + '--bash', '-b', + action='store_const', + const='bash', + dest='shell', + help='Emit completion code for bash') + cmd_opts.add_option( + '--zsh', '-z', + action='store_const', + const='zsh', + dest='shell', + help='Emit completion code for zsh') + cmd_opts.add_option( + '--fish', '-f', + action='store_const', + const='fish', + dest='shell', + help='Emit completion code for fish') + + self.parser.insert_option_group(0, cmd_opts) + + def run(self, options, args): + """Prints the completion code of the given shell""" + shells = COMPLETION_SCRIPTS.keys() + shell_options = ['--' + shell for shell in sorted(shells)] + if options.shell in shells: + script = textwrap.dedent( + COMPLETION_SCRIPTS.get(options.shell, '') % { + 'prog': get_prog(), + } + ) + print(BASE_COMPLETION % {'script': script, 'shell': options.shell}) + else: + sys.stderr.write( + 'ERROR: You must pass %s\n' % ' or '.join(shell_options) + ) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/commands/configuration.py b/venv/lib/python3.8/site-packages/pip/_internal/commands/configuration.py new file mode 100644 index 000000000..efcf5bb36 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/commands/configuration.py @@ -0,0 +1,233 @@ +# The following comment should be removed at some point in the future. +# mypy: disallow-untyped-defs=False + +import logging +import os +import subprocess + +from pip._internal.cli.base_command import Command +from pip._internal.cli.status_codes import ERROR, SUCCESS +from pip._internal.configuration import ( + Configuration, + get_configuration_files, + kinds, +) +from pip._internal.exceptions import PipError +from pip._internal.utils.misc import get_prog, write_output + +logger = logging.getLogger(__name__) + + +class ConfigurationCommand(Command): + """Manage local and global configuration. + + Subcommands: + + list: List the active configuration (or from the file specified) + edit: Edit the configuration file in an editor + get: Get the value associated with name + set: Set the name=value + unset: Unset the value associated with name + + If none of --user, --global and --site are passed, a virtual + environment configuration file is used if one is active and the file + exists. Otherwise, all modifications happen on the to the user file by + default. + """ + + ignore_require_venv = True + usage = """ + %prog [] list + %prog [] [--editor ] edit + + %prog [] get name + %prog [] set name value + %prog [] unset name + """ + + def __init__(self, *args, **kwargs): + super(ConfigurationCommand, self).__init__(*args, **kwargs) + + self.configuration = None + + self.cmd_opts.add_option( + '--editor', + dest='editor', + action='store', + default=None, + help=( + 'Editor to use to edit the file. Uses VISUAL or EDITOR ' + 'environment variables if not provided.' + ) + ) + + self.cmd_opts.add_option( + '--global', + dest='global_file', + action='store_true', + default=False, + help='Use the system-wide configuration file only' + ) + + self.cmd_opts.add_option( + '--user', + dest='user_file', + action='store_true', + default=False, + help='Use the user configuration file only' + ) + + self.cmd_opts.add_option( + '--site', + dest='site_file', + action='store_true', + default=False, + help='Use the current environment configuration file only' + ) + + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options, args): + handlers = { + "list": self.list_values, + "edit": self.open_in_editor, + "get": self.get_name, + "set": self.set_name_value, + "unset": self.unset_name + } + + # Determine action + if not args or args[0] not in handlers: + logger.error("Need an action ({}) to perform.".format( + ", ".join(sorted(handlers))) + ) + return ERROR + + action = args[0] + + # Determine which configuration files are to be loaded + # Depends on whether the command is modifying. + try: + load_only = self._determine_file( + options, need_value=(action in ["get", "set", "unset", "edit"]) + ) + except PipError as e: + logger.error(e.args[0]) + return ERROR + + # Load a new configuration + self.configuration = Configuration( + isolated=options.isolated_mode, load_only=load_only + ) + self.configuration.load() + + # Error handling happens here, not in the action-handlers. + try: + handlers[action](options, args[1:]) + except PipError as e: + logger.error(e.args[0]) + return ERROR + + return SUCCESS + + def _determine_file(self, options, need_value): + file_options = [key for key, value in ( + (kinds.USER, options.user_file), + (kinds.GLOBAL, options.global_file), + (kinds.SITE, options.site_file), + ) if value] + + if not file_options: + if not need_value: + return None + # Default to user, unless there's a site file. + elif any( + os.path.exists(site_config_file) + for site_config_file in get_configuration_files()[kinds.SITE] + ): + return kinds.SITE + else: + return kinds.USER + elif len(file_options) == 1: + return file_options[0] + + raise PipError( + "Need exactly one file to operate upon " + "(--user, --site, --global) to perform." + ) + + def list_values(self, options, args): + self._get_n_args(args, "list", n=0) + + for key, value in sorted(self.configuration.items()): + write_output("%s=%r", key, value) + + def get_name(self, options, args): + key = self._get_n_args(args, "get [name]", n=1) + value = self.configuration.get_value(key) + + write_output("%s", value) + + def set_name_value(self, options, args): + key, value = self._get_n_args(args, "set [name] [value]", n=2) + self.configuration.set_value(key, value) + + self._save_configuration() + + def unset_name(self, options, args): + key = self._get_n_args(args, "unset [name]", n=1) + self.configuration.unset_value(key) + + self._save_configuration() + + def open_in_editor(self, options, args): + editor = self._determine_editor(options) + + fname = self.configuration.get_file_to_edit() + if fname is None: + raise PipError("Could not determine appropriate file.") + + try: + subprocess.check_call([editor, fname]) + except subprocess.CalledProcessError as e: + raise PipError( + "Editor Subprocess exited with exit code {}" + .format(e.returncode) + ) + + def _get_n_args(self, args, example, n): + """Helper to make sure the command got the right number of arguments + """ + if len(args) != n: + msg = ( + 'Got unexpected number of arguments, expected {}. ' + '(example: "{} config {}")' + ).format(n, get_prog(), example) + raise PipError(msg) + + if n == 1: + return args[0] + else: + return args + + def _save_configuration(self): + # We successfully ran a modifying command. Need to save the + # configuration. + try: + self.configuration.save() + except Exception: + logger.error( + "Unable to save configuration. Please report this as a bug.", + exc_info=1 + ) + raise PipError("Internal Error.") + + def _determine_editor(self, options): + if options.editor is not None: + return options.editor + elif "VISUAL" in os.environ: + return os.environ["VISUAL"] + elif "EDITOR" in os.environ: + return os.environ["EDITOR"] + else: + raise PipError("Could not determine editor to use.") diff --git a/venv/lib/python3.8/site-packages/pip/_internal/commands/debug.py b/venv/lib/python3.8/site-packages/pip/_internal/commands/debug.py new file mode 100644 index 000000000..fe93b3a39 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/commands/debug.py @@ -0,0 +1,142 @@ +# The following comment should be removed at some point in the future. +# mypy: disallow-untyped-defs=False + +from __future__ import absolute_import + +import locale +import logging +import os +import sys + +from pip._vendor.certifi import where + +from pip._internal.cli import cmdoptions +from pip._internal.cli.base_command import Command +from pip._internal.cli.cmdoptions import make_target_python +from pip._internal.cli.status_codes import SUCCESS +from pip._internal.utils.logging import indent_log +from pip._internal.utils.misc import get_pip_version +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import Any, List, Optional + from optparse import Values + +logger = logging.getLogger(__name__) + + +def show_value(name, value): + # type: (str, Optional[str]) -> None + logger.info('{}: {}'.format(name, value)) + + +def show_sys_implementation(): + # type: () -> None + logger.info('sys.implementation:') + if hasattr(sys, 'implementation'): + implementation = sys.implementation # type: ignore + implementation_name = implementation.name + else: + implementation_name = '' + + with indent_log(): + show_value('name', implementation_name) + + +def show_tags(options): + # type: (Values) -> None + tag_limit = 10 + + target_python = make_target_python(options) + tags = target_python.get_tags() + + # Display the target options that were explicitly provided. + formatted_target = target_python.format_given() + suffix = '' + if formatted_target: + suffix = ' (target: {})'.format(formatted_target) + + msg = 'Compatible tags: {}{}'.format(len(tags), suffix) + logger.info(msg) + + if options.verbose < 1 and len(tags) > tag_limit: + tags_limited = True + tags = tags[:tag_limit] + else: + tags_limited = False + + with indent_log(): + for tag in tags: + logger.info(str(tag)) + + if tags_limited: + msg = ( + '...\n' + '[First {tag_limit} tags shown. Pass --verbose to show all.]' + ).format(tag_limit=tag_limit) + logger.info(msg) + + +def ca_bundle_info(config): + levels = set() + for key, value in config.items(): + levels.add(key.split('.')[0]) + + if not levels: + return "Not specified" + + levels_that_override_global = ['install', 'wheel', 'download'] + global_overriding_level = [ + level for level in levels if level in levels_that_override_global + ] + if not global_overriding_level: + return 'global' + + levels.remove('global') + return ", ".join(levels) + + +class DebugCommand(Command): + """ + Display debug information. + """ + + usage = """ + %prog """ + ignore_require_venv = True + + def __init__(self, *args, **kw): + super(DebugCommand, self).__init__(*args, **kw) + + cmd_opts = self.cmd_opts + cmdoptions.add_target_python_options(cmd_opts) + self.parser.insert_option_group(0, cmd_opts) + self.parser.config.load() + + def run(self, options, args): + # type: (Values, List[Any]) -> int + logger.warning( + "This command is only meant for debugging. " + "Do not use this with automation for parsing and getting these " + "details, since the output and options of this command may " + "change without notice." + ) + show_value('pip version', get_pip_version()) + show_value('sys.version', sys.version) + show_value('sys.executable', sys.executable) + show_value('sys.getdefaultencoding', sys.getdefaultencoding()) + show_value('sys.getfilesystemencoding', sys.getfilesystemencoding()) + show_value( + 'locale.getpreferredencoding', locale.getpreferredencoding(), + ) + show_value('sys.platform', sys.platform) + show_sys_implementation() + + show_value("'cert' config value", ca_bundle_info(self.parser.config)) + show_value("REQUESTS_CA_BUNDLE", os.environ.get('REQUESTS_CA_BUNDLE')) + show_value("CURL_CA_BUNDLE", os.environ.get('CURL_CA_BUNDLE')) + show_value("pip._vendor.certifi.where()", where()) + + show_tags(options) + + return SUCCESS diff --git a/venv/lib/python3.8/site-packages/pip/_internal/commands/download.py b/venv/lib/python3.8/site-packages/pip/_internal/commands/download.py new file mode 100644 index 000000000..24da3eb2a --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/commands/download.py @@ -0,0 +1,147 @@ +# The following comment should be removed at some point in the future. +# mypy: disallow-untyped-defs=False + +from __future__ import absolute_import + +import logging +import os + +from pip._internal.cli import cmdoptions +from pip._internal.cli.cmdoptions import make_target_python +from pip._internal.cli.req_command import RequirementCommand +from pip._internal.req import RequirementSet +from pip._internal.req.req_tracker import get_requirement_tracker +from pip._internal.utils.misc import ensure_dir, normalize_path, write_output +from pip._internal.utils.temp_dir import TempDirectory + +logger = logging.getLogger(__name__) + + +class DownloadCommand(RequirementCommand): + """ + Download packages from: + + - PyPI (and other indexes) using requirement specifiers. + - VCS project urls. + - Local project directories. + - Local or remote source archives. + + pip also supports downloading from "requirements files", which provide + an easy way to specify a whole environment to be downloaded. + """ + + usage = """ + %prog [options] [package-index-options] ... + %prog [options] -r [package-index-options] ... + %prog [options] ... + %prog [options] ... + %prog [options] ...""" + + def __init__(self, *args, **kw): + super(DownloadCommand, self).__init__(*args, **kw) + + cmd_opts = self.cmd_opts + + cmd_opts.add_option(cmdoptions.constraints()) + cmd_opts.add_option(cmdoptions.requirements()) + cmd_opts.add_option(cmdoptions.build_dir()) + cmd_opts.add_option(cmdoptions.no_deps()) + cmd_opts.add_option(cmdoptions.global_options()) + cmd_opts.add_option(cmdoptions.no_binary()) + cmd_opts.add_option(cmdoptions.only_binary()) + cmd_opts.add_option(cmdoptions.prefer_binary()) + cmd_opts.add_option(cmdoptions.src()) + cmd_opts.add_option(cmdoptions.pre()) + cmd_opts.add_option(cmdoptions.no_clean()) + cmd_opts.add_option(cmdoptions.require_hashes()) + cmd_opts.add_option(cmdoptions.progress_bar()) + cmd_opts.add_option(cmdoptions.no_build_isolation()) + cmd_opts.add_option(cmdoptions.use_pep517()) + cmd_opts.add_option(cmdoptions.no_use_pep517()) + + cmd_opts.add_option( + '-d', '--dest', '--destination-dir', '--destination-directory', + dest='download_dir', + metavar='dir', + default=os.curdir, + help=("Download packages into ."), + ) + + cmdoptions.add_target_python_options(cmd_opts) + + index_opts = cmdoptions.make_option_group( + cmdoptions.index_group, + self.parser, + ) + + self.parser.insert_option_group(0, index_opts) + self.parser.insert_option_group(0, cmd_opts) + + def run(self, options, args): + options.ignore_installed = True + # editable doesn't really make sense for `pip download`, but the bowels + # of the RequirementSet code require that property. + options.editables = [] + + cmdoptions.check_dist_restriction(options) + + options.download_dir = normalize_path(options.download_dir) + + ensure_dir(options.download_dir) + + session = self.get_default_session(options) + + target_python = make_target_python(options) + finder = self._build_package_finder( + options=options, + session=session, + target_python=target_python, + ) + build_delete = (not (options.no_clean or options.build_dir)) + + with get_requirement_tracker() as req_tracker, TempDirectory( + options.build_dir, delete=build_delete, kind="download" + ) as directory: + + requirement_set = RequirementSet() + self.populate_requirement_set( + requirement_set, + args, + options, + finder, + session, + None + ) + + preparer = self.make_requirement_preparer( + temp_build_dir=directory, + options=options, + req_tracker=req_tracker, + session=session, + finder=finder, + download_dir=options.download_dir, + use_user_site=False, + ) + + resolver = self.make_resolver( + preparer=preparer, + finder=finder, + options=options, + py_version_info=options.python_version, + ) + + self.trace_basic_info(finder) + + resolver.resolve(requirement_set) + + downloaded = ' '.join([ + req.name for req in requirement_set.successfully_downloaded + ]) + if downloaded: + write_output('Successfully downloaded %s', downloaded) + + # Clean up + if not options.no_clean: + requirement_set.cleanup_files() + + return requirement_set diff --git a/venv/lib/python3.8/site-packages/pip/_internal/commands/freeze.py b/venv/lib/python3.8/site-packages/pip/_internal/commands/freeze.py new file mode 100644 index 000000000..e96c0833f --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/commands/freeze.py @@ -0,0 +1,103 @@ +# The following comment should be removed at some point in the future. +# mypy: disallow-untyped-defs=False + +from __future__ import absolute_import + +import sys + +from pip._internal.cache import WheelCache +from pip._internal.cli import cmdoptions +from pip._internal.cli.base_command import Command +from pip._internal.models.format_control import FormatControl +from pip._internal.operations.freeze import freeze +from pip._internal.utils.compat import stdlib_pkgs + +DEV_PKGS = {'pip', 'setuptools', 'distribute', 'wheel', 'pkg-resources'} + + +class FreezeCommand(Command): + """ + Output installed packages in requirements format. + + packages are listed in a case-insensitive sorted order. + """ + + usage = """ + %prog [options]""" + log_streams = ("ext://sys.stderr", "ext://sys.stderr") + + def __init__(self, *args, **kw): + super(FreezeCommand, self).__init__(*args, **kw) + + self.cmd_opts.add_option( + '-r', '--requirement', + dest='requirements', + action='append', + default=[], + metavar='file', + help="Use the order in the given requirements file and its " + "comments when generating output. This option can be " + "used multiple times.") + self.cmd_opts.add_option( + '-f', '--find-links', + dest='find_links', + action='append', + default=[], + metavar='URL', + help='URL for finding packages, which will be added to the ' + 'output.') + self.cmd_opts.add_option( + '-l', '--local', + dest='local', + action='store_true', + default=False, + help='If in a virtualenv that has global access, do not output ' + 'globally-installed packages.') + self.cmd_opts.add_option( + '--user', + dest='user', + action='store_true', + default=False, + help='Only output packages installed in user-site.') + self.cmd_opts.add_option(cmdoptions.list_path()) + self.cmd_opts.add_option( + '--all', + dest='freeze_all', + action='store_true', + help='Do not skip these packages in the output:' + ' %s' % ', '.join(DEV_PKGS)) + self.cmd_opts.add_option( + '--exclude-editable', + dest='exclude_editable', + action='store_true', + help='Exclude editable package from output.') + + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options, args): + format_control = FormatControl(set(), set()) + wheel_cache = WheelCache(options.cache_dir, format_control) + skip = set(stdlib_pkgs) + if not options.freeze_all: + skip.update(DEV_PKGS) + + cmdoptions.check_list_path_option(options) + + freeze_kwargs = dict( + requirement=options.requirements, + find_links=options.find_links, + local_only=options.local, + user_only=options.user, + paths=options.path, + skip_regex=options.skip_requirements_regex, + isolated=options.isolated_mode, + wheel_cache=wheel_cache, + skip=skip, + exclude_editable=options.exclude_editable, + ) + + try: + for line in freeze(**freeze_kwargs): + sys.stdout.write(line + '\n') + finally: + wheel_cache.cleanup() diff --git a/venv/lib/python3.8/site-packages/pip/_internal/commands/hash.py b/venv/lib/python3.8/site-packages/pip/_internal/commands/hash.py new file mode 100644 index 000000000..1dc7fb0ea --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/commands/hash.py @@ -0,0 +1,58 @@ +# The following comment should be removed at some point in the future. +# mypy: disallow-untyped-defs=False + +from __future__ import absolute_import + +import hashlib +import logging +import sys + +from pip._internal.cli.base_command import Command +from pip._internal.cli.status_codes import ERROR +from pip._internal.utils.hashes import FAVORITE_HASH, STRONG_HASHES +from pip._internal.utils.misc import read_chunks, write_output + +logger = logging.getLogger(__name__) + + +class HashCommand(Command): + """ + Compute a hash of a local package archive. + + These can be used with --hash in a requirements file to do repeatable + installs. + """ + + usage = '%prog [options] ...' + ignore_require_venv = True + + def __init__(self, *args, **kw): + super(HashCommand, self).__init__(*args, **kw) + self.cmd_opts.add_option( + '-a', '--algorithm', + dest='algorithm', + choices=STRONG_HASHES, + action='store', + default=FAVORITE_HASH, + help='The hash algorithm to use: one of %s' % + ', '.join(STRONG_HASHES)) + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options, args): + if not args: + self.parser.print_usage(sys.stderr) + return ERROR + + algorithm = options.algorithm + for path in args: + write_output('%s:\n--hash=%s:%s', + path, algorithm, _hash_of_file(path, algorithm)) + + +def _hash_of_file(path, algorithm): + """Return the hash digest of a file.""" + with open(path, 'rb') as archive: + hash = hashlib.new(algorithm) + for chunk in read_chunks(archive): + hash.update(chunk) + return hash.hexdigest() diff --git a/venv/lib/python3.8/site-packages/pip/_internal/commands/help.py b/venv/lib/python3.8/site-packages/pip/_internal/commands/help.py new file mode 100644 index 000000000..75af999b4 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/commands/help.py @@ -0,0 +1,41 @@ +# The following comment should be removed at some point in the future. +# mypy: disallow-untyped-defs=False + +from __future__ import absolute_import + +from pip._internal.cli.base_command import Command +from pip._internal.cli.status_codes import SUCCESS +from pip._internal.exceptions import CommandError + + +class HelpCommand(Command): + """Show help for commands""" + + usage = """ + %prog """ + ignore_require_venv = True + + def run(self, options, args): + from pip._internal.commands import ( + commands_dict, create_command, get_similar_commands, + ) + + try: + # 'pip help' with no args is handled by pip.__init__.parseopt() + cmd_name = args[0] # the command we need help for + except IndexError: + return SUCCESS + + if cmd_name not in commands_dict: + guess = get_similar_commands(cmd_name) + + msg = ['unknown command "%s"' % cmd_name] + if guess: + msg.append('maybe you meant "%s"' % guess) + + raise CommandError(' - '.join(msg)) + + command = create_command(cmd_name) + command.parser.print_help() + + return SUCCESS diff --git a/venv/lib/python3.8/site-packages/pip/_internal/commands/install.py b/venv/lib/python3.8/site-packages/pip/_internal/commands/install.py new file mode 100644 index 000000000..cb2fb280c --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/commands/install.py @@ -0,0 +1,727 @@ +# The following comment should be removed at some point in the future. +# It's included for now because without it InstallCommand.run() has a +# couple errors where we have to know req.name is str rather than +# Optional[str] for the InstallRequirement req. +# mypy: strict-optional=False +# mypy: disallow-untyped-defs=False + +from __future__ import absolute_import + +import errno +import logging +import operator +import os +import shutil +import site +from optparse import SUPPRESS_HELP + +from pip._vendor import pkg_resources +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.cache import WheelCache +from pip._internal.cli import cmdoptions +from pip._internal.cli.cmdoptions import make_target_python +from pip._internal.cli.req_command import RequirementCommand +from pip._internal.cli.status_codes import ERROR, SUCCESS +from pip._internal.exceptions import ( + CommandError, + InstallationError, + PreviousBuildDirError, +) +from pip._internal.locations import distutils_scheme +from pip._internal.operations.check import check_install_conflicts +from pip._internal.req import RequirementSet, install_given_reqs +from pip._internal.req.req_tracker import get_requirement_tracker +from pip._internal.utils.deprecation import deprecated +from pip._internal.utils.distutils_args import parse_distutils_args +from pip._internal.utils.filesystem import test_writable_dir +from pip._internal.utils.misc import ( + ensure_dir, + get_installed_version, + protect_pip_from_modification_on_windows, + write_output, +) +from pip._internal.utils.temp_dir import TempDirectory +from pip._internal.utils.typing import MYPY_CHECK_RUNNING +from pip._internal.utils.virtualenv import virtualenv_no_global +from pip._internal.wheel_builder import build, should_build_for_install_command + +if MYPY_CHECK_RUNNING: + from optparse import Values + from typing import Any, Iterable, List, Optional + + from pip._internal.models.format_control import FormatControl + from pip._internal.req.req_install import InstallRequirement + from pip._internal.wheel_builder import BinaryAllowedPredicate + +from pip._internal.locations import running_under_virtualenv + +logger = logging.getLogger(__name__) + + +def get_check_binary_allowed(format_control): + # type: (FormatControl) -> BinaryAllowedPredicate + def check_binary_allowed(req): + # type: (InstallRequirement) -> bool + if req.use_pep517: + return True + canonical_name = canonicalize_name(req.name) + allowed_formats = format_control.get_allowed_formats(canonical_name) + return "binary" in allowed_formats + + return check_binary_allowed + + +class InstallCommand(RequirementCommand): + """ + Install packages from: + + - PyPI (and other indexes) using requirement specifiers. + - VCS project urls. + - Local project directories. + - Local or remote source archives. + + pip also supports installing from "requirements files", which provide + an easy way to specify a whole environment to be installed. + """ + + usage = """ + %prog [options] [package-index-options] ... + %prog [options] -r [package-index-options] ... + %prog [options] [-e] ... + %prog [options] [-e] ... + %prog [options] ...""" + + def __init__(self, *args, **kw): + super(InstallCommand, self).__init__(*args, **kw) + + cmd_opts = self.cmd_opts + + cmd_opts.add_option(cmdoptions.requirements()) + cmd_opts.add_option(cmdoptions.constraints()) + cmd_opts.add_option(cmdoptions.no_deps()) + cmd_opts.add_option(cmdoptions.pre()) + + cmd_opts.add_option(cmdoptions.editable()) + cmd_opts.add_option( + '-t', '--target', + dest='target_dir', + metavar='dir', + default=None, + help='Install packages into . ' + 'By default this will not replace existing files/folders in ' + '. Use --upgrade to replace existing packages in ' + 'with new versions.' + ) + cmdoptions.add_target_python_options(cmd_opts) + + cmd_opts.add_option( + '--user', + dest='use_user_site', + action='store_true', + help="Install to the Python user install directory for your " + "platform. Typically ~/.local/, or %APPDATA%\\Python on " + "Windows. (See the Python documentation for site.USER_BASE " + "for full details.) On Debian systems, this is the " + "default when running outside of a virtual environment " + "and not as root.") + + cmd_opts.add_option( + '--no-user', + dest='use_system_location', + action='store_true', + help=SUPPRESS_HELP) + cmd_opts.add_option( + '--root', + dest='root_path', + metavar='dir', + default=None, + help="Install everything relative to this alternate root " + "directory.") + cmd_opts.add_option( + '--prefix', + dest='prefix_path', + metavar='dir', + default=None, + help="Installation prefix where lib, bin and other top-level " + "folders are placed") + + cmd_opts.add_option( + '--system', + dest='use_system_location', + action='store_true', + help="Install using the system scheme (overrides --user on " + "Debian systems)") + + cmd_opts.add_option(cmdoptions.build_dir()) + + cmd_opts.add_option(cmdoptions.src()) + + cmd_opts.add_option( + '-U', '--upgrade', + dest='upgrade', + action='store_true', + help='Upgrade all specified packages to the newest available ' + 'version. The handling of dependencies depends on the ' + 'upgrade-strategy used.' + ) + + cmd_opts.add_option( + '--upgrade-strategy', + dest='upgrade_strategy', + default='only-if-needed', + choices=['only-if-needed', 'eager'], + help='Determines how dependency upgrading should be handled ' + '[default: %default]. ' + '"eager" - dependencies are upgraded regardless of ' + 'whether the currently installed version satisfies the ' + 'requirements of the upgraded package(s). ' + '"only-if-needed" - are upgraded only when they do not ' + 'satisfy the requirements of the upgraded package(s).' + ) + + cmd_opts.add_option( + '--force-reinstall', + dest='force_reinstall', + action='store_true', + help='Reinstall all packages even if they are already ' + 'up-to-date.') + + cmd_opts.add_option( + '-I', '--ignore-installed', + dest='ignore_installed', + action='store_true', + help='Ignore the installed packages, overwriting them. ' + 'This can break your system if the existing package ' + 'is of a different version or was installed ' + 'with a different package manager!' + ) + + cmd_opts.add_option(cmdoptions.ignore_requires_python()) + cmd_opts.add_option(cmdoptions.no_build_isolation()) + cmd_opts.add_option(cmdoptions.use_pep517()) + cmd_opts.add_option(cmdoptions.no_use_pep517()) + + cmd_opts.add_option(cmdoptions.install_options()) + cmd_opts.add_option(cmdoptions.global_options()) + + cmd_opts.add_option( + "--compile", + action="store_true", + dest="compile", + default=True, + help="Compile Python source files to bytecode", + ) + + cmd_opts.add_option( + "--no-compile", + action="store_false", + dest="compile", + help="Do not compile Python source files to bytecode", + ) + + cmd_opts.add_option( + "--no-warn-script-location", + action="store_false", + dest="warn_script_location", + default=True, + help="Do not warn when installing scripts outside PATH", + ) + cmd_opts.add_option( + "--no-warn-conflicts", + action="store_false", + dest="warn_about_conflicts", + default=True, + help="Do not warn about broken dependencies", + ) + + cmd_opts.add_option(cmdoptions.no_binary()) + cmd_opts.add_option(cmdoptions.only_binary()) + cmd_opts.add_option(cmdoptions.prefer_binary()) + cmd_opts.add_option(cmdoptions.no_clean()) + cmd_opts.add_option(cmdoptions.require_hashes()) + cmd_opts.add_option(cmdoptions.progress_bar()) + + index_opts = cmdoptions.make_option_group( + cmdoptions.index_group, + self.parser, + ) + + self.parser.insert_option_group(0, index_opts) + self.parser.insert_option_group(0, cmd_opts) + + def run(self, options, args): + # type: (Values, List[Any]) -> int + cmdoptions.check_install_build_global(options) + upgrade_strategy = "to-satisfy-only" + if options.upgrade: + upgrade_strategy = options.upgrade_strategy + + cmdoptions.check_dist_restriction(options, check_target=True) + + if options.python_version: + python_versions = [options.python_version] + else: + python_versions = None + + # compute install location defaults + if (not options.use_user_site and not options.prefix_path and not + options.target_dir and not options.use_system_location): + if not running_under_virtualenv() and os.geteuid() != 0: + options.use_user_site = True + + if options.use_system_location: + options.use_user_site = False + + options.src_dir = os.path.abspath(options.src_dir) + install_options = options.install_options or [] + + options.use_user_site = decide_user_install( + options.use_user_site, + prefix_path=options.prefix_path, + target_dir=options.target_dir, + root_path=options.root_path, + isolated_mode=options.isolated_mode, + ) + + target_temp_dir = None # type: Optional[TempDirectory] + target_temp_dir_path = None # type: Optional[str] + if options.target_dir: + options.ignore_installed = True + options.target_dir = os.path.abspath(options.target_dir) + if (os.path.exists(options.target_dir) and not + os.path.isdir(options.target_dir)): + raise CommandError( + "Target path exists but is not a directory, will not " + "continue." + ) + + # Create a target directory for using with the target option + target_temp_dir = TempDirectory(kind="target") + target_temp_dir_path = target_temp_dir.path + + global_options = options.global_options or [] + + session = self.get_default_session(options) + + target_python = make_target_python(options) + finder = self._build_package_finder( + options=options, + session=session, + target_python=target_python, + ignore_requires_python=options.ignore_requires_python, + ) + build_delete = (not (options.no_clean or options.build_dir)) + wheel_cache = WheelCache(options.cache_dir, options.format_control) + + with get_requirement_tracker() as req_tracker, TempDirectory( + options.build_dir, delete=build_delete, kind="install" + ) as directory: + requirement_set = RequirementSet( + check_supported_wheels=not options.target_dir, + ) + + try: + self.populate_requirement_set( + requirement_set, args, options, finder, session, + wheel_cache + ) + + warn_deprecated_install_options( + requirement_set, options.install_options + ) + + preparer = self.make_requirement_preparer( + temp_build_dir=directory, + options=options, + req_tracker=req_tracker, + session=session, + finder=finder, + use_user_site=options.use_user_site, + ) + resolver = self.make_resolver( + preparer=preparer, + finder=finder, + options=options, + wheel_cache=wheel_cache, + use_user_site=options.use_user_site, + ignore_installed=options.ignore_installed, + ignore_requires_python=options.ignore_requires_python, + force_reinstall=options.force_reinstall, + upgrade_strategy=upgrade_strategy, + use_pep517=options.use_pep517, + ) + + self.trace_basic_info(finder) + + resolver.resolve(requirement_set) + + try: + pip_req = requirement_set.get_requirement("pip") + except KeyError: + modifying_pip = None + else: + # If we're not replacing an already installed pip, + # we're not modifying it. + modifying_pip = pip_req.satisfied_by is None + protect_pip_from_modification_on_windows( + modifying_pip=modifying_pip + ) + + check_binary_allowed = get_check_binary_allowed( + finder.format_control + ) + + reqs_to_build = [ + r for r in requirement_set.requirements.values() + if should_build_for_install_command( + r, check_binary_allowed + ) + ] + + _, build_failures = build( + reqs_to_build, + wheel_cache=wheel_cache, + build_options=[], + global_options=[], + ) + + # If we're using PEP 517, we cannot do a direct install + # so we fail here. + # We don't care about failures building legacy + # requirements, as we'll fall through to a direct + # install for those. + pep517_build_failures = [ + r for r in build_failures if r.use_pep517 + ] + if pep517_build_failures: + raise InstallationError( + "Could not build wheels for {} which use" + " PEP 517 and cannot be installed directly".format( + ", ".join(r.name for r in pep517_build_failures))) + + to_install = resolver.get_installation_order( + requirement_set + ) + + # Consistency Checking of the package set we're installing. + should_warn_about_conflicts = ( + not options.ignore_dependencies and + options.warn_about_conflicts + ) + if should_warn_about_conflicts: + self._warn_about_conflicts(to_install) + + # Don't warn about script install locations if + # --target has been specified + warn_script_location = options.warn_script_location + if options.target_dir: + warn_script_location = False + + installed = install_given_reqs( + to_install, + install_options, + global_options, + root=options.root_path, + home=target_temp_dir_path, + prefix=options.prefix_path, + pycompile=options.compile, + warn_script_location=warn_script_location, + use_user_site=options.use_user_site, + ) + + lib_locations = get_lib_location_guesses( + user=options.use_user_site, + home=target_temp_dir_path, + root=options.root_path, + prefix=options.prefix_path, + isolated=options.isolated_mode, + ) + working_set = pkg_resources.WorkingSet(lib_locations) + + installed.sort(key=operator.attrgetter('name')) + items = [] + for result in installed: + item = result.name + try: + installed_version = get_installed_version( + result.name, working_set=working_set + ) + if installed_version: + item += '-' + installed_version + except Exception: + pass + items.append(item) + installed_desc = ' '.join(items) + if installed_desc: + write_output( + 'Successfully installed %s', installed_desc, + ) + except EnvironmentError as error: + show_traceback = (self.verbosity >= 1) + + message = create_env_error_message( + error, show_traceback, options.use_user_site, + ) + logger.error(message, exc_info=show_traceback) + + return ERROR + except PreviousBuildDirError: + options.no_clean = True + raise + finally: + # Clean up + if not options.no_clean: + requirement_set.cleanup_files() + wheel_cache.cleanup() + + if options.target_dir: + self._handle_target_dir( + options.target_dir, target_temp_dir, options.upgrade + ) + + return SUCCESS + + def _handle_target_dir(self, target_dir, target_temp_dir, upgrade): + ensure_dir(target_dir) + + # Checking both purelib and platlib directories for installed + # packages to be moved to target directory + lib_dir_list = [] + + with target_temp_dir: + # Checking both purelib and platlib directories for installed + # packages to be moved to target directory + scheme = distutils_scheme('', home=target_temp_dir.path) + purelib_dir = scheme['purelib'] + platlib_dir = scheme['platlib'] + data_dir = scheme['data'] + + if os.path.exists(purelib_dir): + lib_dir_list.append(purelib_dir) + if os.path.exists(platlib_dir) and platlib_dir != purelib_dir: + lib_dir_list.append(platlib_dir) + if os.path.exists(data_dir): + lib_dir_list.append(data_dir) + + for lib_dir in lib_dir_list: + for item in os.listdir(lib_dir): + if lib_dir == data_dir: + ddir = os.path.join(data_dir, item) + if any(s.startswith(ddir) for s in lib_dir_list[:-1]): + continue + target_item_dir = os.path.join(target_dir, item) + if os.path.exists(target_item_dir): + if not upgrade: + logger.warning( + 'Target directory %s already exists. Specify ' + '--upgrade to force replacement.', + target_item_dir + ) + continue + if os.path.islink(target_item_dir): + logger.warning( + 'Target directory %s already exists and is ' + 'a link. Pip will not automatically replace ' + 'links, please remove if replacement is ' + 'desired.', + target_item_dir + ) + continue + if os.path.isdir(target_item_dir): + shutil.rmtree(target_item_dir) + else: + os.remove(target_item_dir) + + shutil.move( + os.path.join(lib_dir, item), + target_item_dir + ) + + def _warn_about_conflicts(self, to_install): + try: + package_set, _dep_info = check_install_conflicts(to_install) + except Exception: + logger.error("Error checking for conflicts.", exc_info=True) + return + missing, conflicting = _dep_info + + # NOTE: There is some duplication here from pip check + for project_name in missing: + version = package_set[project_name][0] + for dependency in missing[project_name]: + logger.critical( + "%s %s requires %s, which is not installed.", + project_name, version, dependency[1], + ) + + for project_name in conflicting: + version = package_set[project_name][0] + for dep_name, dep_version, req in conflicting[project_name]: + logger.critical( + "%s %s has requirement %s, but you'll have %s %s which is " + "incompatible.", + project_name, version, req, dep_name, dep_version, + ) + + +def get_lib_location_guesses(*args, **kwargs): + scheme = distutils_scheme('', *args, **kwargs) + return [scheme['purelib'], scheme['platlib']] + + +def site_packages_writable(**kwargs): + return all( + test_writable_dir(d) for d in set(get_lib_location_guesses(**kwargs)) + ) + + +def decide_user_install( + use_user_site, # type: Optional[bool] + prefix_path=None, # type: Optional[str] + target_dir=None, # type: Optional[str] + root_path=None, # type: Optional[str] + isolated_mode=False, # type: bool +): + # type: (...) -> bool + """Determine whether to do a user install based on the input options. + + If use_user_site is False, no additional checks are done. + If use_user_site is True, it is checked for compatibility with other + options. + If use_user_site is None, the default behaviour depends on the environment, + which is provided by the other arguments. + """ + # In some cases (config from tox), use_user_site can be set to an integer + # rather than a bool, which 'use_user_site is False' wouldn't catch. + if (use_user_site is not None) and (not use_user_site): + logger.debug("Non-user install by explicit request") + return False + + if use_user_site: + if prefix_path: + raise CommandError( + "Can not combine '--user' and '--prefix' as they imply " + "different installation locations" + ) + if virtualenv_no_global(): + raise InstallationError( + "Can not perform a '--user' install. User site-packages " + "are not visible in this virtualenv." + ) + logger.debug("User install by explicit request") + return True + + # If we are here, user installs have not been explicitly requested/avoided + assert use_user_site is None + + # user install incompatible with --prefix/--target + if prefix_path or target_dir: + logger.debug("Non-user install due to --prefix or --target option") + return False + + # If user installs are not enabled, choose a non-user install + if not site.ENABLE_USER_SITE: + logger.debug("Non-user install because user site-packages disabled") + return False + + # If we have permission for a non-user install, do that, + # otherwise do a user install. + if site_packages_writable(root=root_path, isolated=isolated_mode): + logger.debug("Non-user install because site-packages writeable") + return False + + logger.info("Defaulting to user installation because normal site-packages " + "is not writeable") + return True + + +def warn_deprecated_install_options(requirement_set, options): + # type: (RequirementSet, Optional[List[str]]) -> None + """If any location-changing --install-option arguments were passed for + requirements or on the command-line, then show a deprecation warning. + """ + def format_options(option_names): + # type: (Iterable[str]) -> List[str] + return ["--{}".format(name.replace("_", "-")) for name in option_names] + + requirements = ( + requirement_set.unnamed_requirements + + list(requirement_set.requirements.values()) + ) + + offenders = [] + + for requirement in requirements: + install_options = requirement.options.get("install_options", []) + location_options = parse_distutils_args(install_options) + if location_options: + offenders.append( + "{!r} from {}".format( + format_options(location_options.keys()), requirement + ) + ) + + if options: + location_options = parse_distutils_args(options) + if location_options: + offenders.append( + "{!r} from command line".format( + format_options(location_options.keys()) + ) + ) + + if not offenders: + return + + deprecated( + reason=( + "Location-changing options found in --install-option: {}. " + "This configuration may cause unexpected behavior and is " + "unsupported.".format( + "; ".join(offenders) + ) + ), + replacement=( + "using pip-level options like --user, --prefix, --root, and " + "--target" + ), + gone_in="20.2", + issue=7309, + ) + + +def create_env_error_message(error, show_traceback, using_user_site): + """Format an error message for an EnvironmentError + + It may occur anytime during the execution of the install command. + """ + parts = [] + + # Mention the error if we are not going to show a traceback + parts.append("Could not install packages due to an EnvironmentError") + if not show_traceback: + parts.append(": ") + parts.append(str(error)) + else: + parts.append(".") + + # Spilt the error indication from a helper message (if any) + parts[-1] += "\n" + + # Suggest useful actions to the user: + # (1) using user site-packages or (2) verifying the permissions + if error.errno == errno.EACCES: + user_option_part = "Consider using the `--user` option" + permissions_part = "Check the permissions" + + if not using_user_site: + parts.extend([ + user_option_part, " or ", + permissions_part.lower(), + ]) + else: + parts.append(permissions_part) + parts.append(".\n") + + return "".join(parts).strip() + "\n" diff --git a/venv/lib/python3.8/site-packages/pip/_internal/commands/list.py b/venv/lib/python3.8/site-packages/pip/_internal/commands/list.py new file mode 100644 index 000000000..d0062063e --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/commands/list.py @@ -0,0 +1,315 @@ +# The following comment should be removed at some point in the future. +# mypy: disallow-untyped-defs=False + +from __future__ import absolute_import + +import json +import logging + +from pip._vendor import six +from pip._vendor.six.moves import zip_longest + +from pip._internal.cli import cmdoptions +from pip._internal.cli.req_command import IndexGroupCommand +from pip._internal.exceptions import CommandError +from pip._internal.index.package_finder import PackageFinder +from pip._internal.models.selection_prefs import SelectionPreferences +from pip._internal.self_outdated_check import make_link_collector +from pip._internal.utils.misc import ( + dist_is_editable, + get_installed_distributions, + write_output, +) +from pip._internal.utils.packaging import get_installer + +from pip._vendor.packaging.version import parse + +logger = logging.getLogger(__name__) + + +class ListCommand(IndexGroupCommand): + """ + List installed packages, including editables. + + Packages are listed in a case-insensitive sorted order. + """ + + usage = """ + %prog [options]""" + + def __init__(self, *args, **kw): + super(ListCommand, self).__init__(*args, **kw) + + cmd_opts = self.cmd_opts + + cmd_opts.add_option( + '-o', '--outdated', + action='store_true', + default=False, + help='List outdated packages') + cmd_opts.add_option( + '-u', '--uptodate', + action='store_true', + default=False, + help='List uptodate packages') + cmd_opts.add_option( + '-e', '--editable', + action='store_true', + default=False, + help='List editable projects.') + cmd_opts.add_option( + '-l', '--local', + action='store_true', + default=False, + help=('If in a virtualenv that has global access, do not list ' + 'globally-installed packages.'), + ) + self.cmd_opts.add_option( + '--user', + dest='user', + action='store_true', + default=False, + help='Only output packages installed in user-site.') + cmd_opts.add_option(cmdoptions.list_path()) + cmd_opts.add_option( + '--pre', + action='store_true', + default=False, + help=("Include pre-release and development versions. By default, " + "pip only finds stable versions."), + ) + + cmd_opts.add_option( + '--format', + action='store', + dest='list_format', + default="columns", + choices=('columns', 'freeze', 'json'), + help="Select the output format among: columns (default), freeze, " + "or json", + ) + + cmd_opts.add_option( + '--not-required', + action='store_true', + dest='not_required', + help="List packages that are not dependencies of " + "installed packages.", + ) + + cmd_opts.add_option( + '--exclude-editable', + action='store_false', + dest='include_editable', + help='Exclude editable package from output.', + ) + cmd_opts.add_option( + '--include-editable', + action='store_true', + dest='include_editable', + help='Include editable package from output.', + default=True, + ) + index_opts = cmdoptions.make_option_group( + cmdoptions.index_group, self.parser + ) + + self.parser.insert_option_group(0, index_opts) + self.parser.insert_option_group(0, cmd_opts) + + def _build_package_finder(self, options, session): + """ + Create a package finder appropriate to this list command. + """ + link_collector = make_link_collector(session, options=options) + + # Pass allow_yanked=False to ignore yanked versions. + selection_prefs = SelectionPreferences( + allow_yanked=False, + allow_all_prereleases=options.pre, + ) + + return PackageFinder.create( + link_collector=link_collector, + selection_prefs=selection_prefs, + ) + + def run(self, options, args): + if options.outdated and options.uptodate: + raise CommandError( + "Options --outdated and --uptodate cannot be combined.") + + cmdoptions.check_list_path_option(options) + + packages = get_installed_distributions( + local_only=options.local, + user_only=options.user, + editables_only=options.editable, + include_editables=options.include_editable, + paths=options.path, + ) + + # get_not_required must be called firstly in order to find and + # filter out all dependencies correctly. Otherwise a package + # can't be identified as requirement because some parent packages + # could be filtered out before. + if options.not_required: + packages = self.get_not_required(packages, options) + + if options.outdated: + packages = self.get_outdated(packages, options) + elif options.uptodate: + packages = self.get_uptodate(packages, options) + + self.output_package_listing(packages, options) + + def get_outdated(self, packages, options): + return [ + dist for dist in self.iter_packages_latest_infos(packages, options) + if parse(str(dist.latest_version)) > parse(str(dist.parsed_version)) + ] + + def get_uptodate(self, packages, options): + return [ + dist for dist in self.iter_packages_latest_infos(packages, options) + if parse(str(dist.latest_version)) == parse(str(dist.parsed_version)) + ] + + def get_not_required(self, packages, options): + dep_keys = set() + for dist in packages: + dep_keys.update(requirement.key for requirement in dist.requires()) + return {pkg for pkg in packages if pkg.key not in dep_keys} + + def iter_packages_latest_infos(self, packages, options): + with self._build_session(options) as session: + finder = self._build_package_finder(options, session) + + for dist in packages: + typ = 'unknown' + all_candidates = finder.find_all_candidates(dist.key) + if not options.pre: + # Remove prereleases + all_candidates = [candidate for candidate in all_candidates + if not candidate.version.is_prerelease] + + evaluator = finder.make_candidate_evaluator( + project_name=dist.project_name, + ) + best_candidate = evaluator.sort_best_candidate(all_candidates) + if best_candidate is None: + continue + + remote_version = best_candidate.version + if best_candidate.link.is_wheel: + typ = 'wheel' + else: + typ = 'sdist' + # This is dirty but makes the rest of the code much cleaner + dist.latest_version = remote_version + dist.latest_filetype = typ + yield dist + + def output_package_listing(self, packages, options): + packages = sorted( + packages, + key=lambda dist: dist.project_name.lower(), + ) + if options.list_format == 'columns' and packages: + data, header = format_for_columns(packages, options) + self.output_package_listing_columns(data, header) + elif options.list_format == 'freeze': + for dist in packages: + if options.verbose >= 1: + write_output("%s==%s (%s)", dist.project_name, + dist.version, dist.location) + else: + write_output("%s==%s", dist.project_name, dist.version) + elif options.list_format == 'json': + write_output(format_for_json(packages, options)) + + def output_package_listing_columns(self, data, header): + # insert the header first: we need to know the size of column names + if len(data) > 0: + data.insert(0, header) + + pkg_strings, sizes = tabulate(data) + + # Create and add a separator. + if len(data) > 0: + pkg_strings.insert(1, " ".join(map(lambda x: '-' * x, sizes))) + + for val in pkg_strings: + write_output(val) + + +def tabulate(vals): + # From pfmoore on GitHub: + # https://github.com/pypa/pip/issues/3651#issuecomment-216932564 + assert len(vals) > 0 + + sizes = [0] * max(len(x) for x in vals) + for row in vals: + sizes = [max(s, len(str(c))) for s, c in zip_longest(sizes, row)] + + result = [] + for row in vals: + display = " ".join([str(c).ljust(s) if c is not None else '' + for s, c in zip_longest(sizes, row)]) + result.append(display) + + return result, sizes + + +def format_for_columns(pkgs, options): + """ + Convert the package data into something usable + by output_package_listing_columns. + """ + running_outdated = options.outdated + # Adjust the header for the `pip list --outdated` case. + if running_outdated: + header = ["Package", "Version", "Latest", "Type"] + else: + header = ["Package", "Version"] + + data = [] + if options.verbose >= 1 or any(dist_is_editable(x) for x in pkgs): + header.append("Location") + if options.verbose >= 1: + header.append("Installer") + + for proj in pkgs: + # if we're working on the 'outdated' list, separate out the + # latest_version and type + row = [proj.project_name, proj.version] + + if running_outdated: + row.append(proj.latest_version) + row.append(proj.latest_filetype) + + if options.verbose >= 1 or dist_is_editable(proj): + row.append(proj.location) + if options.verbose >= 1: + row.append(get_installer(proj)) + + data.append(row) + + return data, header + + +def format_for_json(packages, options): + data = [] + for dist in packages: + info = { + 'name': dist.project_name, + 'version': six.text_type(dist.version), + } + if options.verbose >= 1: + info['location'] = dist.location + info['installer'] = get_installer(dist) + if options.outdated: + info['latest_version'] = six.text_type(dist.latest_version) + info['latest_filetype'] = dist.latest_filetype + data.append(info) + return json.dumps(data) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/commands/search.py b/venv/lib/python3.8/site-packages/pip/_internal/commands/search.py new file mode 100644 index 000000000..2e880eec2 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/commands/search.py @@ -0,0 +1,145 @@ +# The following comment should be removed at some point in the future. +# mypy: disallow-untyped-defs=False + +from __future__ import absolute_import + +import logging +import sys +import textwrap +from collections import OrderedDict + +from pip._vendor import pkg_resources +from pip._vendor.packaging.version import parse as parse_version +# NOTE: XMLRPC Client is not annotated in typeshed as on 2017-07-17, which is +# why we ignore the type on this import +from pip._vendor.six.moves import xmlrpc_client # type: ignore + +from pip._internal.cli.base_command import Command +from pip._internal.cli.req_command import SessionCommandMixin +from pip._internal.cli.status_codes import NO_MATCHES_FOUND, SUCCESS +from pip._internal.exceptions import CommandError +from pip._internal.models.index import PyPI +from pip._internal.network.xmlrpc import PipXmlrpcTransport +from pip._internal.utils.compat import get_terminal_size +from pip._internal.utils.logging import indent_log +from pip._internal.utils.misc import write_output + +logger = logging.getLogger(__name__) + + +class SearchCommand(Command, SessionCommandMixin): + """Search for PyPI packages whose name or summary contains .""" + + usage = """ + %prog [options] """ + ignore_require_venv = True + + def __init__(self, *args, **kw): + super(SearchCommand, self).__init__(*args, **kw) + self.cmd_opts.add_option( + '-i', '--index', + dest='index', + metavar='URL', + default=PyPI.pypi_url, + help='Base URL of Python Package Index (default %default)') + + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options, args): + if not args: + raise CommandError('Missing required argument (search query).') + query = args + pypi_hits = self.search(query, options) + hits = transform_hits(pypi_hits) + + terminal_width = None + if sys.stdout.isatty(): + terminal_width = get_terminal_size()[0] + + print_results(hits, terminal_width=terminal_width) + if pypi_hits: + return SUCCESS + return NO_MATCHES_FOUND + + def search(self, query, options): + index_url = options.index + + session = self.get_default_session(options) + + transport = PipXmlrpcTransport(index_url, session) + pypi = xmlrpc_client.ServerProxy(index_url, transport) + hits = pypi.search({'name': query, 'summary': query}, 'or') + return hits + + +def transform_hits(hits): + """ + The list from pypi is really a list of versions. We want a list of + packages with the list of versions stored inline. This converts the + list from pypi into one we can use. + """ + packages = OrderedDict() + for hit in hits: + name = hit['name'] + summary = hit['summary'] + version = hit['version'] + + if name not in packages.keys(): + packages[name] = { + 'name': name, + 'summary': summary, + 'versions': [version], + } + else: + packages[name]['versions'].append(version) + + # if this is the highest version, replace summary and score + if version == highest_version(packages[name]['versions']): + packages[name]['summary'] = summary + + return list(packages.values()) + + +def print_results(hits, name_column_width=None, terminal_width=None): + if not hits: + return + if name_column_width is None: + name_column_width = max([ + len(hit['name']) + len(highest_version(hit.get('versions', ['-']))) + for hit in hits + ]) + 4 + + installed_packages = [p.project_name for p in pkg_resources.working_set] + for hit in hits: + name = hit['name'] + summary = hit['summary'] or '' + latest = highest_version(hit.get('versions', ['-'])) + if terminal_width is not None: + target_width = terminal_width - name_column_width - 5 + if target_width > 10: + # wrap and indent summary to fit terminal + summary = textwrap.wrap(summary, target_width) + summary = ('\n' + ' ' * (name_column_width + 3)).join(summary) + + line = '%-*s - %s' % (name_column_width, + '%s (%s)' % (name, latest), summary) + try: + write_output(line) + if name in installed_packages: + dist = pkg_resources.get_distribution(name) + with indent_log(): + if dist.version == latest: + write_output('INSTALLED: %s (latest)', dist.version) + else: + write_output('INSTALLED: %s', dist.version) + if parse_version(latest).pre: + write_output('LATEST: %s (pre-release; install' + ' with "pip install --pre")', latest) + else: + write_output('LATEST: %s', latest) + except UnicodeEncodeError: + pass + + +def highest_version(versions): + return max(versions, key=parse_version) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/commands/show.py b/venv/lib/python3.8/site-packages/pip/_internal/commands/show.py new file mode 100644 index 000000000..a46b08eeb --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/commands/show.py @@ -0,0 +1,180 @@ +# The following comment should be removed at some point in the future. +# mypy: disallow-untyped-defs=False + +from __future__ import absolute_import + +import logging +import os +from email.parser import FeedParser + +from pip._vendor import pkg_resources +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.cli.base_command import Command +from pip._internal.cli.status_codes import ERROR, SUCCESS +from pip._internal.utils.misc import write_output + +logger = logging.getLogger(__name__) + + +class ShowCommand(Command): + """ + Show information about one or more installed packages. + + The output is in RFC-compliant mail header format. + """ + + usage = """ + %prog [options] ...""" + ignore_require_venv = True + + def __init__(self, *args, **kw): + super(ShowCommand, self).__init__(*args, **kw) + self.cmd_opts.add_option( + '-f', '--files', + dest='files', + action='store_true', + default=False, + help='Show the full list of installed files for each package.') + + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options, args): + if not args: + logger.warning('ERROR: Please provide a package name or names.') + return ERROR + query = args + + results = search_packages_info(query) + if not print_results( + results, list_files=options.files, verbose=options.verbose): + return ERROR + return SUCCESS + + +def search_packages_info(query): + """ + Gather details from installed distributions. Print distribution name, + version, location, and installed files. Installed files requires a + pip generated 'installed-files.txt' in the distributions '.egg-info' + directory. + """ + installed = {} + for p in pkg_resources.working_set: + installed[canonicalize_name(p.project_name)] = p + + query_names = [canonicalize_name(name) for name in query] + missing = sorted( + [name for name, pkg in zip(query, query_names) if pkg not in installed] + ) + if missing: + logger.warning('Package(s) not found: %s', ', '.join(missing)) + + def get_requiring_packages(package_name): + canonical_name = canonicalize_name(package_name) + return [ + pkg.project_name for pkg in pkg_resources.working_set + if canonical_name in + [canonicalize_name(required.name) for required in + pkg.requires()] + ] + + for dist in [installed[pkg] for pkg in query_names if pkg in installed]: + package = { + 'name': dist.project_name, + 'version': dist.version, + 'location': dist.location, + 'requires': [dep.project_name for dep in dist.requires()], + 'required_by': get_requiring_packages(dist.project_name) + } + file_list = None + metadata = None + if isinstance(dist, pkg_resources.DistInfoDistribution): + # RECORDs should be part of .dist-info metadatas + if dist.has_metadata('RECORD'): + lines = dist.get_metadata_lines('RECORD') + paths = [l.split(',')[0] for l in lines] + paths = [os.path.join(dist.location, p) for p in paths] + file_list = [os.path.relpath(p, dist.location) for p in paths] + + if dist.has_metadata('METADATA'): + metadata = dist.get_metadata('METADATA') + else: + # Otherwise use pip's log for .egg-info's + if dist.has_metadata('installed-files.txt'): + paths = dist.get_metadata_lines('installed-files.txt') + paths = [os.path.join(dist.egg_info, p) for p in paths] + file_list = [os.path.relpath(p, dist.location) for p in paths] + + if dist.has_metadata('PKG-INFO'): + metadata = dist.get_metadata('PKG-INFO') + + if dist.has_metadata('entry_points.txt'): + entry_points = dist.get_metadata_lines('entry_points.txt') + package['entry_points'] = entry_points + + if dist.has_metadata('INSTALLER'): + for line in dist.get_metadata_lines('INSTALLER'): + if line.strip(): + package['installer'] = line.strip() + break + + # @todo: Should pkg_resources.Distribution have a + # `get_pkg_info` method? + feed_parser = FeedParser() + feed_parser.feed(metadata) + pkg_info_dict = feed_parser.close() + for key in ('metadata-version', 'summary', + 'home-page', 'author', 'author-email', 'license'): + package[key] = pkg_info_dict.get(key) + + # It looks like FeedParser cannot deal with repeated headers + classifiers = [] + for line in metadata.splitlines(): + if line.startswith('Classifier: '): + classifiers.append(line[len('Classifier: '):]) + package['classifiers'] = classifiers + + if file_list: + package['files'] = sorted(file_list) + yield package + + +def print_results(distributions, list_files=False, verbose=False): + """ + Print the informations from installed distributions found. + """ + results_printed = False + for i, dist in enumerate(distributions): + results_printed = True + if i > 0: + write_output("---") + + write_output("Name: %s", dist.get('name', '')) + write_output("Version: %s", dist.get('version', '')) + write_output("Summary: %s", dist.get('summary', '')) + write_output("Home-page: %s", dist.get('home-page', '')) + write_output("Author: %s", dist.get('author', '')) + write_output("Author-email: %s", dist.get('author-email', '')) + write_output("License: %s", dist.get('license', '')) + write_output("Location: %s", dist.get('location', '')) + write_output("Requires: %s", ', '.join(dist.get('requires', []))) + write_output("Required-by: %s", ', '.join(dist.get('required_by', []))) + + if verbose: + write_output("Metadata-Version: %s", + dist.get('metadata-version', '')) + write_output("Installer: %s", dist.get('installer', '')) + write_output("Classifiers:") + for classifier in dist.get('classifiers', []): + write_output(" %s", classifier) + write_output("Entry-points:") + for entry in dist.get('entry_points', []): + write_output(" %s", entry.strip()) + if list_files: + write_output("Files:") + for line in dist.get('files', []): + write_output(" %s", line.strip()) + if "files" not in dist: + write_output("Cannot locate installed-files.txt") + return results_printed diff --git a/venv/lib/python3.8/site-packages/pip/_internal/commands/uninstall.py b/venv/lib/python3.8/site-packages/pip/_internal/commands/uninstall.py new file mode 100644 index 000000000..1bde414a6 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/commands/uninstall.py @@ -0,0 +1,82 @@ +# The following comment should be removed at some point in the future. +# mypy: disallow-untyped-defs=False + +from __future__ import absolute_import + +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.cli.base_command import Command +from pip._internal.cli.req_command import SessionCommandMixin +from pip._internal.exceptions import InstallationError +from pip._internal.req import parse_requirements +from pip._internal.req.constructors import install_req_from_line +from pip._internal.utils.misc import protect_pip_from_modification_on_windows + + +class UninstallCommand(Command, SessionCommandMixin): + """ + Uninstall packages. + + pip is able to uninstall most installed packages. Known exceptions are: + + - Pure distutils packages installed with ``python setup.py install``, which + leave behind no metadata to determine what files were installed. + - Script wrappers installed by ``python setup.py develop``. + """ + + usage = """ + %prog [options] ... + %prog [options] -r ...""" + + def __init__(self, *args, **kw): + super(UninstallCommand, self).__init__(*args, **kw) + self.cmd_opts.add_option( + '-r', '--requirement', + dest='requirements', + action='append', + default=[], + metavar='file', + help='Uninstall all the packages listed in the given requirements ' + 'file. This option can be used multiple times.', + ) + self.cmd_opts.add_option( + '-y', '--yes', + dest='yes', + action='store_true', + help="Don't ask for confirmation of uninstall deletions.") + + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options, args): + session = self.get_default_session(options) + + reqs_to_uninstall = {} + for name in args: + req = install_req_from_line( + name, isolated=options.isolated_mode, + ) + if req.name: + reqs_to_uninstall[canonicalize_name(req.name)] = req + for filename in options.requirements: + for req in parse_requirements( + filename, + options=options, + session=session): + if req.name: + reqs_to_uninstall[canonicalize_name(req.name)] = req + if not reqs_to_uninstall: + raise InstallationError( + 'You must give at least one requirement to %(name)s (see ' + '"pip help %(name)s")' % dict(name=self.name) + ) + + protect_pip_from_modification_on_windows( + modifying_pip="pip" in reqs_to_uninstall + ) + + for req in reqs_to_uninstall.values(): + uninstall_pathset = req.uninstall( + auto_confirm=options.yes, verbose=self.verbosity > 0, + ) + if uninstall_pathset: + uninstall_pathset.commit() diff --git a/venv/lib/python3.8/site-packages/pip/_internal/commands/wheel.py b/venv/lib/python3.8/site-packages/pip/_internal/commands/wheel.py new file mode 100644 index 000000000..eb44bcee4 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/commands/wheel.py @@ -0,0 +1,197 @@ +# -*- coding: utf-8 -*- + +# The following comment should be removed at some point in the future. +# mypy: disallow-untyped-defs=False + +from __future__ import absolute_import + +import logging +import os +import shutil + +from pip._internal.cache import WheelCache +from pip._internal.cli import cmdoptions +from pip._internal.cli.req_command import RequirementCommand +from pip._internal.exceptions import CommandError, PreviousBuildDirError +from pip._internal.req import RequirementSet +from pip._internal.req.req_tracker import get_requirement_tracker +from pip._internal.utils.misc import ensure_dir, normalize_path +from pip._internal.utils.temp_dir import TempDirectory +from pip._internal.utils.typing import MYPY_CHECK_RUNNING +from pip._internal.wheel_builder import build, should_build_for_wheel_command + +if MYPY_CHECK_RUNNING: + from optparse import Values + from typing import Any, List + + +logger = logging.getLogger(__name__) + + +class WheelCommand(RequirementCommand): + """ + Build Wheel archives for your requirements and dependencies. + + Wheel is a built-package format, and offers the advantage of not + recompiling your software during every install. For more details, see the + wheel docs: https://wheel.readthedocs.io/en/latest/ + + Requirements: setuptools>=0.8, and wheel. + + 'pip wheel' uses the bdist_wheel setuptools extension from the wheel + package to build individual wheels. + + """ + + usage = """ + %prog [options] ... + %prog [options] -r ... + %prog [options] [-e] ... + %prog [options] [-e] ... + %prog [options] ...""" + + def __init__(self, *args, **kw): + super(WheelCommand, self).__init__(*args, **kw) + + cmd_opts = self.cmd_opts + + cmd_opts.add_option( + '-w', '--wheel-dir', + dest='wheel_dir', + metavar='dir', + default=os.curdir, + help=("Build wheels into , where the default is the " + "current working directory."), + ) + cmd_opts.add_option(cmdoptions.no_binary()) + cmd_opts.add_option(cmdoptions.only_binary()) + cmd_opts.add_option(cmdoptions.prefer_binary()) + cmd_opts.add_option( + '--build-option', + dest='build_options', + metavar='options', + action='append', + help="Extra arguments to be supplied to 'setup.py bdist_wheel'.", + ) + cmd_opts.add_option(cmdoptions.no_build_isolation()) + cmd_opts.add_option(cmdoptions.use_pep517()) + cmd_opts.add_option(cmdoptions.no_use_pep517()) + cmd_opts.add_option(cmdoptions.constraints()) + cmd_opts.add_option(cmdoptions.editable()) + cmd_opts.add_option(cmdoptions.requirements()) + cmd_opts.add_option(cmdoptions.src()) + cmd_opts.add_option(cmdoptions.ignore_requires_python()) + cmd_opts.add_option(cmdoptions.no_deps()) + cmd_opts.add_option(cmdoptions.build_dir()) + cmd_opts.add_option(cmdoptions.progress_bar()) + + cmd_opts.add_option( + '--global-option', + dest='global_options', + action='append', + metavar='options', + help="Extra global options to be supplied to the setup.py " + "call before the 'bdist_wheel' command.") + + cmd_opts.add_option( + '--pre', + action='store_true', + default=False, + help=("Include pre-release and development versions. By default, " + "pip only finds stable versions."), + ) + + cmd_opts.add_option(cmdoptions.no_clean()) + cmd_opts.add_option(cmdoptions.require_hashes()) + + index_opts = cmdoptions.make_option_group( + cmdoptions.index_group, + self.parser, + ) + + self.parser.insert_option_group(0, index_opts) + self.parser.insert_option_group(0, cmd_opts) + + def run(self, options, args): + # type: (Values, List[Any]) -> None + cmdoptions.check_install_build_global(options) + + session = self.get_default_session(options) + + finder = self._build_package_finder(options, session) + build_delete = (not (options.no_clean or options.build_dir)) + wheel_cache = WheelCache(options.cache_dir, options.format_control) + + options.wheel_dir = normalize_path(options.wheel_dir) + ensure_dir(options.wheel_dir) + + with get_requirement_tracker() as req_tracker, TempDirectory( + options.build_dir, delete=build_delete, kind="wheel" + ) as directory: + + requirement_set = RequirementSet() + + try: + self.populate_requirement_set( + requirement_set, args, options, finder, session, + wheel_cache + ) + + preparer = self.make_requirement_preparer( + temp_build_dir=directory, + options=options, + req_tracker=req_tracker, + session=session, + finder=finder, + wheel_download_dir=options.wheel_dir, + use_user_site=False, + ) + + resolver = self.make_resolver( + preparer=preparer, + finder=finder, + options=options, + wheel_cache=wheel_cache, + ignore_requires_python=options.ignore_requires_python, + use_pep517=options.use_pep517, + ) + + self.trace_basic_info(finder) + + resolver.resolve(requirement_set) + + reqs_to_build = [ + r for r in requirement_set.requirements.values() + if should_build_for_wheel_command(r) + ] + + # build wheels + build_successes, build_failures = build( + reqs_to_build, + wheel_cache=wheel_cache, + build_options=options.build_options or [], + global_options=options.global_options or [], + ) + for req in build_successes: + assert req.link and req.link.is_wheel + assert req.local_file_path + # copy from cache to target directory + try: + shutil.copy(req.local_file_path, options.wheel_dir) + except OSError as e: + logger.warning( + "Building wheel for %s failed: %s", + req.name, e, + ) + build_failures.append(req) + if len(build_failures) != 0: + raise CommandError( + "Failed to build one or more wheels" + ) + except PreviousBuildDirError: + options.no_clean = True + raise + finally: + if not options.no_clean: + requirement_set.cleanup_files() + wheel_cache.cleanup() diff --git a/venv/lib/python3.8/site-packages/pip/_internal/configuration.py b/venv/lib/python3.8/site-packages/pip/_internal/configuration.py new file mode 100644 index 000000000..f09a1ae25 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/configuration.py @@ -0,0 +1,422 @@ +"""Configuration management setup + +Some terminology: +- name + As written in config files. +- value + Value associated with a name +- key + Name combined with it's section (section.name) +- variant + A single word describing where the configuration key-value pair came from +""" + +# The following comment should be removed at some point in the future. +# mypy: strict-optional=False + +import locale +import logging +import os +import sys + +from pip._vendor.six.moves import configparser + +from pip._internal.exceptions import ( + ConfigurationError, + ConfigurationFileCouldNotBeLoaded, +) +from pip._internal.utils import appdirs +from pip._internal.utils.compat import WINDOWS, expanduser +from pip._internal.utils.misc import ensure_dir, enum +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import ( + Any, Dict, Iterable, List, NewType, Optional, Tuple + ) + + RawConfigParser = configparser.RawConfigParser # Shorthand + Kind = NewType("Kind", str) + +logger = logging.getLogger(__name__) + + +# NOTE: Maybe use the optionx attribute to normalize keynames. +def _normalize_name(name): + # type: (str) -> str + """Make a name consistent regardless of source (environment or file) + """ + name = name.lower().replace('_', '-') + if name.startswith('--'): + name = name[2:] # only prefer long opts + return name + + +def _disassemble_key(name): + # type: (str) -> List[str] + if "." not in name: + error_message = ( + "Key does not contain dot separated section and key. " + "Perhaps you wanted to use 'global.{}' instead?" + ).format(name) + raise ConfigurationError(error_message) + return name.split(".", 1) + + +# The kinds of configurations there are. +kinds = enum( + USER="user", # User Specific + GLOBAL="global", # System Wide + SITE="site", # [Virtual] Environment Specific + ENV="env", # from PIP_CONFIG_FILE + ENV_VAR="env-var", # from Environment Variables +) + + +CONFIG_BASENAME = 'pip.ini' if WINDOWS else 'pip.conf' + + +def get_configuration_files(): + # type: () -> Dict[Kind, List[str]] + global_config_files = [ + os.path.join(path, CONFIG_BASENAME) + for path in appdirs.site_config_dirs('pip') + ] + + site_config_file = os.path.join(sys.prefix, CONFIG_BASENAME) + legacy_config_file = os.path.join( + expanduser('~'), + 'pip' if WINDOWS else '.pip', + CONFIG_BASENAME, + ) + new_config_file = os.path.join( + appdirs.user_config_dir("pip"), CONFIG_BASENAME + ) + return { + kinds.GLOBAL: global_config_files, + kinds.SITE: [site_config_file], + kinds.USER: [legacy_config_file, new_config_file], + } + + +class Configuration(object): + """Handles management of configuration. + + Provides an interface to accessing and managing configuration files. + + This class converts provides an API that takes "section.key-name" style + keys and stores the value associated with it as "key-name" under the + section "section". + + This allows for a clean interface wherein the both the section and the + key-name are preserved in an easy to manage form in the configuration files + and the data stored is also nice. + """ + + def __init__(self, isolated, load_only=None): + # type: (bool, Kind) -> None + super(Configuration, self).__init__() + + _valid_load_only = [kinds.USER, kinds.GLOBAL, kinds.SITE, None] + if load_only not in _valid_load_only: + raise ConfigurationError( + "Got invalid value for load_only - should be one of {}".format( + ", ".join(map(repr, _valid_load_only[:-1])) + ) + ) + self.isolated = isolated # type: bool + self.load_only = load_only # type: Optional[Kind] + + # The order here determines the override order. + self._override_order = [ + kinds.GLOBAL, kinds.USER, kinds.SITE, kinds.ENV, kinds.ENV_VAR + ] + + self._ignore_env_names = ["version", "help"] + + # Because we keep track of where we got the data from + self._parsers = { + variant: [] for variant in self._override_order + } # type: Dict[Kind, List[Tuple[str, RawConfigParser]]] + self._config = { + variant: {} for variant in self._override_order + } # type: Dict[Kind, Dict[str, Any]] + self._modified_parsers = [] # type: List[Tuple[str, RawConfigParser]] + + def load(self): + # type: () -> None + """Loads configuration from configuration files and environment + """ + self._load_config_files() + if not self.isolated: + self._load_environment_vars() + + def get_file_to_edit(self): + # type: () -> Optional[str] + """Returns the file with highest priority in configuration + """ + assert self.load_only is not None, \ + "Need to be specified a file to be editing" + + try: + return self._get_parser_to_modify()[0] + except IndexError: + return None + + def items(self): + # type: () -> Iterable[Tuple[str, Any]] + """Returns key-value pairs like dict.items() representing the loaded + configuration + """ + return self._dictionary.items() + + def get_value(self, key): + # type: (str) -> Any + """Get a value from the configuration. + """ + try: + return self._dictionary[key] + except KeyError: + raise ConfigurationError("No such key - {}".format(key)) + + def set_value(self, key, value): + # type: (str, Any) -> None + """Modify a value in the configuration. + """ + self._ensure_have_load_only() + + fname, parser = self._get_parser_to_modify() + + if parser is not None: + section, name = _disassemble_key(key) + + # Modify the parser and the configuration + if not parser.has_section(section): + parser.add_section(section) + parser.set(section, name, value) + + self._config[self.load_only][key] = value + self._mark_as_modified(fname, parser) + + def unset_value(self, key): + # type: (str) -> None + """Unset a value in the configuration. + """ + self._ensure_have_load_only() + + if key not in self._config[self.load_only]: + raise ConfigurationError("No such key - {}".format(key)) + + fname, parser = self._get_parser_to_modify() + + if parser is not None: + section, name = _disassemble_key(key) + + # Remove the key in the parser + modified_something = False + if parser.has_section(section): + # Returns whether the option was removed or not + modified_something = parser.remove_option(section, name) + + if modified_something: + # name removed from parser, section may now be empty + section_iter = iter(parser.items(section)) + try: + val = next(section_iter) + except StopIteration: + val = None + + if val is None: + parser.remove_section(section) + + self._mark_as_modified(fname, parser) + else: + raise ConfigurationError( + "Fatal Internal error [id=1]. Please report as a bug." + ) + + del self._config[self.load_only][key] + + def save(self): + # type: () -> None + """Save the current in-memory state. + """ + self._ensure_have_load_only() + + for fname, parser in self._modified_parsers: + logger.info("Writing to %s", fname) + + # Ensure directory exists. + ensure_dir(os.path.dirname(fname)) + + with open(fname, "w") as f: + parser.write(f) + + # + # Private routines + # + + def _ensure_have_load_only(self): + # type: () -> None + if self.load_only is None: + raise ConfigurationError("Needed a specific file to be modifying.") + logger.debug("Will be working with %s variant only", self.load_only) + + @property + def _dictionary(self): + # type: () -> Dict[str, Any] + """A dictionary representing the loaded configuration. + """ + # NOTE: Dictionaries are not populated if not loaded. So, conditionals + # are not needed here. + retval = {} + + for variant in self._override_order: + retval.update(self._config[variant]) + + return retval + + def _load_config_files(self): + # type: () -> None + """Loads configuration from configuration files + """ + config_files = dict(self._iter_config_files()) + if config_files[kinds.ENV][0:1] == [os.devnull]: + logger.debug( + "Skipping loading configuration files due to " + "environment's PIP_CONFIG_FILE being os.devnull" + ) + return + + for variant, files in config_files.items(): + for fname in files: + # If there's specific variant set in `load_only`, load only + # that variant, not the others. + if self.load_only is not None and variant != self.load_only: + logger.debug( + "Skipping file '%s' (variant: %s)", fname, variant + ) + continue + + parser = self._load_file(variant, fname) + + # Keeping track of the parsers used + self._parsers[variant].append((fname, parser)) + + def _load_file(self, variant, fname): + # type: (Kind, str) -> RawConfigParser + logger.debug("For variant '%s', will try loading '%s'", variant, fname) + parser = self._construct_parser(fname) + + for section in parser.sections(): + items = parser.items(section) + self._config[variant].update(self._normalized_keys(section, items)) + + return parser + + def _construct_parser(self, fname): + # type: (str) -> RawConfigParser + parser = configparser.RawConfigParser() + # If there is no such file, don't bother reading it but create the + # parser anyway, to hold the data. + # Doing this is useful when modifying and saving files, where we don't + # need to construct a parser. + if os.path.exists(fname): + try: + parser.read(fname) + except UnicodeDecodeError: + # See https://github.com/pypa/pip/issues/4963 + raise ConfigurationFileCouldNotBeLoaded( + reason="contains invalid {} characters".format( + locale.getpreferredencoding(False) + ), + fname=fname, + ) + except configparser.Error as error: + # See https://github.com/pypa/pip/issues/4893 + raise ConfigurationFileCouldNotBeLoaded(error=error) + return parser + + def _load_environment_vars(self): + # type: () -> None + """Loads configuration from environment variables + """ + self._config[kinds.ENV_VAR].update( + self._normalized_keys(":env:", self._get_environ_vars()) + ) + + def _normalized_keys(self, section, items): + # type: (str, Iterable[Tuple[str, Any]]) -> Dict[str, Any] + """Normalizes items to construct a dictionary with normalized keys. + + This routine is where the names become keys and are made the same + regardless of source - configuration files or environment. + """ + normalized = {} + for name, val in items: + key = section + "." + _normalize_name(name) + normalized[key] = val + return normalized + + def _get_environ_vars(self): + # type: () -> Iterable[Tuple[str, str]] + """Returns a generator with all environmental vars with prefix PIP_""" + for key, val in os.environ.items(): + should_be_yielded = ( + key.startswith("PIP_") and + key[4:].lower() not in self._ignore_env_names + ) + if should_be_yielded: + yield key[4:].lower(), val + + # XXX: This is patched in the tests. + def _iter_config_files(self): + # type: () -> Iterable[Tuple[Kind, List[str]]] + """Yields variant and configuration files associated with it. + + This should be treated like items of a dictionary. + """ + # SMELL: Move the conditions out of this function + + # environment variables have the lowest priority + config_file = os.environ.get('PIP_CONFIG_FILE', None) + if config_file is not None: + yield kinds.ENV, [config_file] + else: + yield kinds.ENV, [] + + config_files = get_configuration_files() + + # at the base we have any global configuration + yield kinds.GLOBAL, config_files[kinds.GLOBAL] + + # per-user configuration next + should_load_user_config = not self.isolated and not ( + config_file and os.path.exists(config_file) + ) + if should_load_user_config: + # The legacy config file is overridden by the new config file + yield kinds.USER, config_files[kinds.USER] + + # finally virtualenv configuration first trumping others + yield kinds.SITE, config_files[kinds.SITE] + + def _get_parser_to_modify(self): + # type: () -> Tuple[str, RawConfigParser] + # Determine which parser to modify + parsers = self._parsers[self.load_only] + if not parsers: + # This should not happen if everything works correctly. + raise ConfigurationError( + "Fatal Internal error [id=2]. Please report as a bug." + ) + + # Use the highest priority parser. + return parsers[-1] + + # XXX: This is patched in the tests. + def _mark_as_modified(self, fname, parser): + # type: (str, RawConfigParser) -> None + file_parser_tuple = (fname, parser) + if file_parser_tuple not in self._modified_parsers: + self._modified_parsers.append(file_parser_tuple) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/distributions/__init__.py b/venv/lib/python3.8/site-packages/pip/_internal/distributions/__init__.py new file mode 100644 index 000000000..d5c1afc5b --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/distributions/__init__.py @@ -0,0 +1,24 @@ +from pip._internal.distributions.sdist import SourceDistribution +from pip._internal.distributions.wheel import WheelDistribution +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from pip._internal.distributions.base import AbstractDistribution + from pip._internal.req.req_install import InstallRequirement + + +def make_distribution_for_install_requirement(install_req): + # type: (InstallRequirement) -> AbstractDistribution + """Returns a Distribution for the given InstallRequirement + """ + # Editable requirements will always be source distributions. They use the + # legacy logic until we create a modern standard for them. + if install_req.editable: + return SourceDistribution(install_req) + + # If it's a wheel, it's a WheelDistribution + if install_req.is_wheel: + return WheelDistribution(install_req) + + # Otherwise, a SourceDistribution + return SourceDistribution(install_req) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/distributions/__pycache__/__init__.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/distributions/__pycache__/__init__.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2e4cc89598e78704897d159c5b227e5d65735cb3 GIT binary patch literal 841 zcmaJk$6(FfnUZ#_xz*Cf-|(Wj-- zi4b$RXt;y|N}W+N^tTw_@SCEl`)Dr72O@81dPzRhg^4VAN84A?E*sEK$8*q)ER~=5 z{fYkjO8R;Q{*rH?^#2_`_E7?-^&sauNd-tVz4f??KN_+UFTgBh!mrL9OSt$-q`9D< zz*bcOOjcE$)N8g;S(O7*y2+6h!+9Gfc*^RnURCA8@DWp7!-G1>*2xkSt9i|0UTTnK zB3RyAwPGJf=P4_$Ay2! zh5dFaR9$G8{~z~vCGG9~e)vR$3iY<;Hfj?mi6Jgs3}qa)6kQ eL$~stnV6rwkXmghv zlIx!!r^-OieS`MsSK4b&eTAMnq$Ed54Rb+iIOK4?;e12A91MC0+M^!gf3y(#+f7y* z=+KYQjfR0Ch9%0}Zy<3IWC3<^D8nMkB8+&XU%)()t)iW^{aQOCx)3Ey){jq0 zT5#_dT;B(bV4TzPo=tM4HP5X)o5P-4ma5#Us{>7$+h+K10UErz0IT_}o8&~;X=1po ztF>6Zxx_}LQA>bJ_aEXEdd=7$s%pEuJ$D_zA2FxK@{mgi_Z=V?t$_&PAZk?Uu1nYD zmKC64yyC!)G8fzoue-b)j4j+{vYO#UO%CCD5`J1K+|(fM{-1 zt#fY3D(0_XkMTJO-#oYyMKh*5@gcOR^(#d^7Ue{DERyu?*l@sC< z+k|wIHyd>Ez5$=7is?H5M1KrJGgy!<=Td^n`+RJ;EiNgZvYQ|n$Im#3Hv6pz_o4{< zmEleOIp~{BpxTH4A(_%6BTlu;Q}dbEE(th-2Va_zJ*%MDv`awKUQ8VKnon2HSfhb< z|99D~_0ynsblcf|xvqDqIvp))fXp+eJ8olV`_ax*DCwp>uY4cDO3*%h&&2rQ{C0nE T6fuqpanOe^!Z2d^!WjPtdoU~E literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/distributions/__pycache__/installed.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/distributions/__pycache__/installed.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..28a40c77294909bf0eeb82978e398100ca82ce01 GIT binary patch literal 1237 zcmaJ=OK;Oa5MDpxxM>2S0wjy&?6{sdj$U2g#0pxwzzoM!le#Tal);X zWL9ih#;!YEDQ!ner-Nx>uezq2`S!9QBk9RK!?}GKiiF@2X zAj7raSeXp1`u>}-(vl_moxoj;D=mr~{TrXZ?tP`(AK!0(qWedq(e7vmz5bWd#94}V z|Gyi9J(irXDSQw)2bq}qZ9$w1OaU4|VvCd5=2q-*n>!aIcDc(txOcdR{dMaHySdUV zO@X(+bN+K5N(l;btpb(@;wmX97hey1y#VEKCRD%+P(fbkAP3->JrD3|$s{uv0;U2z zgFwP*B_zg0J}G3jh|Ms_QVERDn{s1-JV=VHtTgbjaV1s@ow3c@#-)5z-^npKwhqXp zH5%HrgCD8;3Tvy008YnqoS&;8om>*x$MnCGXjWtp$)YG(c@mweq~H)KU2#Mjok4yU zrD7bFb3H5a&G2QUgofu!%ql8H8BvjIkjPEMTU4s(dPHG4ub)mq)AD3WafU@D6Hv6B zyw0(+o7@OtXiWa@G3g&8^>he>C)JpVFLVKxy5hG%I+O8oN*FX~oiI zq)RC;5=!MAgX5l2hQXFH&B`t+gHCyve#1h1Yb2Z30v{W(uUCpnklX zhJR+NLOm}rK*zNI_GaSuJ;Y z^9;52%F;{LK-`BmMSp?x=zq|c{t>?Rsed330g~-GLupMpMo^$6IGoFwGv}Q7&gG+a zyGh`Aw@Jj8YlQq82i3=d!7cdI-=N`y(}=kEHzFDvu0gSHMrLfemhM|oEw)`-_iIr- zc3emI?Whqq-6kcXDKpqpk5=NA+lt$6TdzCOYP{yI>3$b?^<2J9u-{uae+$c78)1eGR^{~;u?ukqa1$ryyGo=X_uc+N^HW@r0 z?h6KlnJ=~SOyweDd#PmkKI~?R5L~fX%z7YNE@a|Iy{ZLOPvH>6FD~KX z+2OzglWS8eEy@C77f^Ckff%D}-@dHwckd2N+&O>H`Eaa_@l)t5j6rqpz(}{o#>5<( z^35@snqxYn<;v8W5p<K9wDb>my~K;~7O?18aus+L_MXOdvDQb|tL#`+`|0p(M(BGfn|0jx`hsEAx@X)k z0g1kLVm8edwP@2Az4a0!ekYSaTOT;#{o#GYE3?Ia~khGy19V7c#M)63NE~uRSFv5ERFj z{73Fg8(dS(U`CJX+?h7>mAsX=$JPlwF=iCkN{(OL0;*NsIH8l8o>`mNV_Qr0Pn2qG zPuIt_8U11v_}kNs8JX1oNUoDVkbC4$%->Eb}x@IZeoC3A7_zG{KR*02O zdwa=r2tPF6IW*lbpy6}^Yz|OhI))rDg;2$@q~qn zg-MXc8HC1uB<812FuT|gB4a=An1#`Ot7wE}{t(=?ANmk0_=^y4+`#zwD3dp@qX=k5 z%dk&JJ1+t9iw@Vl5v742sheF-`XPAcLVxvq<%~T@v{JEMvA!T)7^_&RmAwFM0^jZ?$2s6`F%a{C+mYug$9`u{SKTThRKjQr!#>+>X!N$K0D8(p3!s^0Z$ zZ!0lsaQGe*m1ay_?&4n5J zSz$pLBjp<~mgwv5YMH^jxw7tt8ulU01prd7tnJ*3n0Xh%dw^-L6jht5y2|MAvXlzoORymBW{0}a&-KiIj=OunDJg;ba zUYzn_g#DK1JsA4Ye5LMrJPkZgZh*M*JT|C8C7@wdRqD0^J)H?KB{UdLdL+-19=I&Vu)jb1)21kKdudG%}0M+gLfF=yy#cRuC;!z-Uuva=z6_=Kmp|Fos z_xXKmKol2VMwA~zX+MxQ9%9c2br?w0$^D+*0!1QEWp}B-lMUQ)d6^~FKaaZe+R-b^ wA&I3%(Ez0VUPD)Qk^2v^K})^Nu!VD@yq%j^`zpKy$H2SSFCb(cM^Fy^7rgueQ~&?~ literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/distributions/__pycache__/wheel.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/distributions/__pycache__/wheel.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..6b194059b8e2283bdbee291b09733635537d7995 GIT binary patch literal 1589 zcmaJ>TaVl{6t;7j%uZ*w?FyuV1hQ7Vj06c17x92l+wBEJ8I^6TZS!J0v1cb;C(hc= zwlgX(w6BQ&08jj-yz<0f;02C7(<)P-j(po?s+meFywvIjnZ_9lth^qv}F_ z0i)Z9Cw%w<@u3KxhxwTA+(VPmpKuDA;4aC_=2j^M4BxsoGgh<0-YDT+&RScl8s_)E zdvx~^J^cFS;kWeY!F2k~^ft_X(43x7EsSb)Aq?fcJ#?-#eX=Rx}ErK1snc7IVC!j&+jR+iL4aKh>(fvpYG%+*eqS#LL_U^STu2%|+|<&v~@ z17!%F`cMUiWM4K{fus5my15VL8G4K!V>7nFPuPz`bH$Bqv|izu2R{eD9Q=rF{A}Z~ zUU?oKqX2z|zDGysH+0XxA0i$?<_U)ASjL%UWUf`^XVz8Efml-3R)I&Q z^b!i>L<`&M8lds1J0$w(!ERLS+leYRezFxk(ttp zj~r>BJ(D$MlTkoM=$gr_uMU&>0@G&My?-Js{ePM7LmtK@gOYJD4)$??12jN`zgHh0 zzb?x3&7q3Wh1oPWc7pN(a=!%*)KBo#7d{E~9!zzExxYW%#aUZQPD`Vt*Q|G1o6FAc zy|tdj_62<@m;-Pz4rUarvVSN2#=VZsA*GHfO1lxImEtWBO1m+oXDySPm4s5R3QD!Z zOTX=m1FdIVqIw8s4BZUC3~>|>FZsFYWVcIJW#h!+710qOFMUN`x#O(V48L4s_LZaCI9@?W7@i< None + super(AbstractDistribution, self).__init__() + self.req = req + + @abc.abstractmethod + def get_pkg_resources_distribution(self): + # type: () -> Optional[Distribution] + raise NotImplementedError() + + @abc.abstractmethod + def prepare_distribution_metadata(self, finder, build_isolation): + # type: (PackageFinder, bool) -> None + raise NotImplementedError() diff --git a/venv/lib/python3.8/site-packages/pip/_internal/distributions/installed.py b/venv/lib/python3.8/site-packages/pip/_internal/distributions/installed.py new file mode 100644 index 000000000..0d15bf424 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/distributions/installed.py @@ -0,0 +1,24 @@ +from pip._internal.distributions.base import AbstractDistribution +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import Optional + + from pip._vendor.pkg_resources import Distribution + from pip._internal.index.package_finder import PackageFinder + + +class InstalledDistribution(AbstractDistribution): + """Represents an installed package. + + This does not need any preparation as the required information has already + been computed. + """ + + def get_pkg_resources_distribution(self): + # type: () -> Optional[Distribution] + return self.req.satisfied_by + + def prepare_distribution_metadata(self, finder, build_isolation): + # type: (PackageFinder, bool) -> None + pass diff --git a/venv/lib/python3.8/site-packages/pip/_internal/distributions/sdist.py b/venv/lib/python3.8/site-packages/pip/_internal/distributions/sdist.py new file mode 100644 index 000000000..be3d7d97a --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/distributions/sdist.py @@ -0,0 +1,104 @@ +import logging + +from pip._internal.build_env import BuildEnvironment +from pip._internal.distributions.base import AbstractDistribution +from pip._internal.exceptions import InstallationError +from pip._internal.utils.subprocess import runner_with_spinner_message +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import Set, Tuple + + from pip._vendor.pkg_resources import Distribution + from pip._internal.index.package_finder import PackageFinder + + +logger = logging.getLogger(__name__) + + +class SourceDistribution(AbstractDistribution): + """Represents a source distribution. + + The preparation step for these needs metadata for the packages to be + generated, either using PEP 517 or using the legacy `setup.py egg_info`. + """ + + def get_pkg_resources_distribution(self): + # type: () -> Distribution + return self.req.get_dist() + + def prepare_distribution_metadata(self, finder, build_isolation): + # type: (PackageFinder, bool) -> None + # Load pyproject.toml, to determine whether PEP 517 is to be used + self.req.load_pyproject_toml() + + # Set up the build isolation, if this requirement should be isolated + should_isolate = self.req.use_pep517 and build_isolation + if should_isolate: + self._setup_isolation(finder) + + self.req.prepare_metadata() + + def _setup_isolation(self, finder): + # type: (PackageFinder) -> None + def _raise_conflicts(conflicting_with, conflicting_reqs): + # type: (str, Set[Tuple[str, str]]) -> None + format_string = ( + "Some build dependencies for {requirement} " + "conflict with {conflicting_with}: {description}." + ) + error_message = format_string.format( + requirement=self.req, + conflicting_with=conflicting_with, + description=', '.join( + '{} is incompatible with {}'.format(installed, wanted) + for installed, wanted in sorted(conflicting) + ) + ) + raise InstallationError(error_message) + + # Isolate in a BuildEnvironment and install the build-time + # requirements. + pyproject_requires = self.req.pyproject_requires + assert pyproject_requires is not None + + self.req.build_env = BuildEnvironment() + self.req.build_env.install_requirements( + finder, pyproject_requires, 'overlay', + "Installing build dependencies" + ) + conflicting, missing = self.req.build_env.check_requirements( + self.req.requirements_to_check + ) + if conflicting: + _raise_conflicts("PEP 517/518 supported requirements", + conflicting) + if missing: + logger.warning( + "Missing build requirements in pyproject.toml for %s.", + self.req, + ) + logger.warning( + "The project does not specify a build backend, and " + "pip cannot fall back to setuptools without %s.", + " and ".join(map(repr, sorted(missing))) + ) + # Install any extra build dependencies that the backend requests. + # This must be done in a second pass, as the pyproject.toml + # dependencies must be installed before we can call the backend. + with self.req.build_env: + runner = runner_with_spinner_message( + "Getting requirements to build wheel" + ) + backend = self.req.pep517_backend + assert backend is not None + with backend.subprocess_runner(runner): + reqs = backend.get_requires_for_build_wheel() + + conflicting, missing = self.req.build_env.check_requirements(reqs) + if conflicting: + _raise_conflicts("the backend dependencies", conflicting) + self.req.build_env.install_requirements( + finder, missing, 'normal', + "Installing backend dependencies" + ) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/distributions/wheel.py b/venv/lib/python3.8/site-packages/pip/_internal/distributions/wheel.py new file mode 100644 index 000000000..bf3482b15 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/distributions/wheel.py @@ -0,0 +1,36 @@ +from zipfile import ZipFile + +from pip._internal.distributions.base import AbstractDistribution +from pip._internal.utils.typing import MYPY_CHECK_RUNNING +from pip._internal.utils.wheel import pkg_resources_distribution_for_wheel + +if MYPY_CHECK_RUNNING: + from pip._vendor.pkg_resources import Distribution + from pip._internal.index.package_finder import PackageFinder + + +class WheelDistribution(AbstractDistribution): + """Represents a wheel distribution. + + This does not need any preparation as wheels can be directly unpacked. + """ + + def get_pkg_resources_distribution(self): + # type: () -> Distribution + """Loads the metadata from the wheel file into memory and returns a + Distribution that uses it, not relying on the wheel file or + requirement. + """ + # Set as part of preparation during download. + assert self.req.local_file_path + # Wheels are never unnamed. + assert self.req.name + + with ZipFile(self.req.local_file_path, allowZip64=True) as z: + return pkg_resources_distribution_for_wheel( + z, self.req.name, self.req.local_file_path + ) + + def prepare_distribution_metadata(self, finder, build_isolation): + # type: (PackageFinder, bool) -> None + pass diff --git a/venv/lib/python3.8/site-packages/pip/_internal/exceptions.py b/venv/lib/python3.8/site-packages/pip/_internal/exceptions.py new file mode 100644 index 000000000..dddec789e --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/exceptions.py @@ -0,0 +1,308 @@ +"""Exceptions used throughout package""" + +# The following comment should be removed at some point in the future. +# mypy: disallow-untyped-defs=False + +from __future__ import absolute_import + +from itertools import chain, groupby, repeat + +from pip._vendor.six import iteritems + +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import Optional + from pip._vendor.pkg_resources import Distribution + from pip._internal.req.req_install import InstallRequirement + + +class PipError(Exception): + """Base pip exception""" + + +class ConfigurationError(PipError): + """General exception in configuration""" + + +class InstallationError(PipError): + """General exception during installation""" + + +class UninstallationError(PipError): + """General exception during uninstallation""" + + +class NoneMetadataError(PipError): + """ + Raised when accessing "METADATA" or "PKG-INFO" metadata for a + pip._vendor.pkg_resources.Distribution object and + `dist.has_metadata('METADATA')` returns True but + `dist.get_metadata('METADATA')` returns None (and similarly for + "PKG-INFO"). + """ + + def __init__(self, dist, metadata_name): + # type: (Distribution, str) -> None + """ + :param dist: A Distribution object. + :param metadata_name: The name of the metadata being accessed + (can be "METADATA" or "PKG-INFO"). + """ + self.dist = dist + self.metadata_name = metadata_name + + def __str__(self): + # type: () -> str + # Use `dist` in the error message because its stringification + # includes more information, like the version and location. + return ( + 'None {} metadata found for distribution: {}'.format( + self.metadata_name, self.dist, + ) + ) + + +class DistributionNotFound(InstallationError): + """Raised when a distribution cannot be found to satisfy a requirement""" + + +class RequirementsFileParseError(InstallationError): + """Raised when a general error occurs parsing a requirements file line.""" + + +class BestVersionAlreadyInstalled(PipError): + """Raised when the most up-to-date version of a package is already + installed.""" + + +class BadCommand(PipError): + """Raised when virtualenv or a command is not found""" + + +class CommandError(PipError): + """Raised when there is an error in command-line arguments""" + + +class PreviousBuildDirError(PipError): + """Raised when there's a previous conflicting build directory""" + + +class InvalidWheelFilename(InstallationError): + """Invalid wheel filename.""" + + +class UnsupportedWheel(InstallationError): + """Unsupported wheel.""" + + +class HashErrors(InstallationError): + """Multiple HashError instances rolled into one for reporting""" + + def __init__(self): + self.errors = [] + + def append(self, error): + self.errors.append(error) + + def __str__(self): + lines = [] + self.errors.sort(key=lambda e: e.order) + for cls, errors_of_cls in groupby(self.errors, lambda e: e.__class__): + lines.append(cls.head) + lines.extend(e.body() for e in errors_of_cls) + if lines: + return '\n'.join(lines) + + def __nonzero__(self): + return bool(self.errors) + + def __bool__(self): + return self.__nonzero__() + + +class HashError(InstallationError): + """ + A failure to verify a package against known-good hashes + + :cvar order: An int sorting hash exception classes by difficulty of + recovery (lower being harder), so the user doesn't bother fretting + about unpinned packages when he has deeper issues, like VCS + dependencies, to deal with. Also keeps error reports in a + deterministic order. + :cvar head: A section heading for display above potentially many + exceptions of this kind + :ivar req: The InstallRequirement that triggered this error. This is + pasted on after the exception is instantiated, because it's not + typically available earlier. + + """ + req = None # type: Optional[InstallRequirement] + head = '' + + def body(self): + """Return a summary of me for display under the heading. + + This default implementation simply prints a description of the + triggering requirement. + + :param req: The InstallRequirement that provoked this error, with + populate_link() having already been called + + """ + return ' %s' % self._requirement_name() + + def __str__(self): + return '%s\n%s' % (self.head, self.body()) + + def _requirement_name(self): + """Return a description of the requirement that triggered me. + + This default implementation returns long description of the req, with + line numbers + + """ + return str(self.req) if self.req else 'unknown package' + + +class VcsHashUnsupported(HashError): + """A hash was provided for a version-control-system-based requirement, but + we don't have a method for hashing those.""" + + order = 0 + head = ("Can't verify hashes for these requirements because we don't " + "have a way to hash version control repositories:") + + +class DirectoryUrlHashUnsupported(HashError): + """A hash was provided for a version-control-system-based requirement, but + we don't have a method for hashing those.""" + + order = 1 + head = ("Can't verify hashes for these file:// requirements because they " + "point to directories:") + + +class HashMissing(HashError): + """A hash was needed for a requirement but is absent.""" + + order = 2 + head = ('Hashes are required in --require-hashes mode, but they are ' + 'missing from some requirements. Here is a list of those ' + 'requirements along with the hashes their downloaded archives ' + 'actually had. Add lines like these to your requirements files to ' + 'prevent tampering. (If you did not enable --require-hashes ' + 'manually, note that it turns on automatically when any package ' + 'has a hash.)') + + def __init__(self, gotten_hash): + """ + :param gotten_hash: The hash of the (possibly malicious) archive we + just downloaded + """ + self.gotten_hash = gotten_hash + + def body(self): + # Dodge circular import. + from pip._internal.utils.hashes import FAVORITE_HASH + + package = None + if self.req: + # In the case of URL-based requirements, display the original URL + # seen in the requirements file rather than the package name, + # so the output can be directly copied into the requirements file. + package = (self.req.original_link if self.req.original_link + # In case someone feeds something downright stupid + # to InstallRequirement's constructor. + else getattr(self.req, 'req', None)) + return ' %s --hash=%s:%s' % (package or 'unknown package', + FAVORITE_HASH, + self.gotten_hash) + + +class HashUnpinned(HashError): + """A requirement had a hash specified but was not pinned to a specific + version.""" + + order = 3 + head = ('In --require-hashes mode, all requirements must have their ' + 'versions pinned with ==. These do not:') + + +class HashMismatch(HashError): + """ + Distribution file hash values don't match. + + :ivar package_name: The name of the package that triggered the hash + mismatch. Feel free to write to this after the exception is raise to + improve its error message. + + """ + order = 4 + head = ('THESE PACKAGES DO NOT MATCH THE HASHES FROM THE REQUIREMENTS ' + 'FILE. If you have updated the package versions, please update ' + 'the hashes. Otherwise, examine the package contents carefully; ' + 'someone may have tampered with them.') + + def __init__(self, allowed, gots): + """ + :param allowed: A dict of algorithm names pointing to lists of allowed + hex digests + :param gots: A dict of algorithm names pointing to hashes we + actually got from the files under suspicion + """ + self.allowed = allowed + self.gots = gots + + def body(self): + return ' %s:\n%s' % (self._requirement_name(), + self._hash_comparison()) + + def _hash_comparison(self): + """ + Return a comparison of actual and expected hash values. + + Example:: + + Expected sha256 abcdeabcdeabcdeabcdeabcdeabcdeabcdeabcdeabcde + or 123451234512345123451234512345123451234512345 + Got bcdefbcdefbcdefbcdefbcdefbcdefbcdefbcdefbcdef + + """ + def hash_then_or(hash_name): + # For now, all the decent hashes have 6-char names, so we can get + # away with hard-coding space literals. + return chain([hash_name], repeat(' or')) + + lines = [] + for hash_name, expecteds in iteritems(self.allowed): + prefix = hash_then_or(hash_name) + lines.extend((' Expected %s %s' % (next(prefix), e)) + for e in expecteds) + lines.append(' Got %s\n' % + self.gots[hash_name].hexdigest()) + return '\n'.join(lines) + + +class UnsupportedPythonVersion(InstallationError): + """Unsupported python version according to Requires-Python package + metadata.""" + + +class ConfigurationFileCouldNotBeLoaded(ConfigurationError): + """When there are errors while loading a configuration file + """ + + def __init__(self, reason="could not be loaded", fname=None, error=None): + super(ConfigurationFileCouldNotBeLoaded, self).__init__(error) + self.reason = reason + self.fname = fname + self.error = error + + def __str__(self): + if self.fname is not None: + message_part = " in {}.".format(self.fname) + else: + assert self.error is not None + message_part = ".\n{}\n".format(self.error.message) + return "Configuration file {}{}".format(self.reason, message_part) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/index/__init__.py b/venv/lib/python3.8/site-packages/pip/_internal/index/__init__.py new file mode 100644 index 000000000..7a17b7b3b --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/index/__init__.py @@ -0,0 +1,2 @@ +"""Index interaction code +""" diff --git a/venv/lib/python3.8/site-packages/pip/_internal/index/__pycache__/__init__.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/index/__pycache__/__init__.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b18404cc4e3ca594d60747ede59adb18006beebc GIT binary patch literal 219 zcmYjLu?oU46imBV3Z31gYX|!V7Y7k>b8!(DK|*XEHndGblNReA`Ac2>1UDy>P9EGn z?(vR$=Ol@V!#*asaP#fWKLTfVjwW)#$%XLXM6&QXKS+*`R7i_0E38m5EfmN2m<8jE zQmzV0U!)CPYLf32O4T5=N@=Dm=#4)IV>^!0LXWbCTHHVnwp4PJufYh5OU;Uk-O+#+ f8tBv}Sq;LM19b~wDb4jTMw>?QuEwo@_~S@^aZ)^b literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/index/__pycache__/collector.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/index/__pycache__/collector.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4168cfec7bbcb8381c6e8b4813215412a16b82c9 GIT binary patch literal 14185 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 AB>(^b literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/index/__pycache__/package_finder.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/index/__pycache__/package_finder.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d6f8d85d1bc6fe77e9792fd83bd8986b09e831e4 GIT binary patch literal 25778 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 Optional[str] + """Look for VCS schemes in the URL. + + Returns the matched VCS scheme, or None if there's no match. + """ + for scheme in vcs.schemes: + if url.lower().startswith(scheme) and url[len(scheme)] in '+:': + return scheme + return None + + +def _is_url_like_archive(url): + # type: (str) -> bool + """Return whether the URL looks like an archive. + """ + filename = Link(url).filename + for bad_ext in ARCHIVE_EXTENSIONS: + if filename.endswith(bad_ext): + return True + return False + + +class _NotHTML(Exception): + def __init__(self, content_type, request_desc): + # type: (str, str) -> None + super(_NotHTML, self).__init__(content_type, request_desc) + self.content_type = content_type + self.request_desc = request_desc + + +def _ensure_html_header(response): + # type: (Response) -> None + """Check the Content-Type header to ensure the response contains HTML. + + Raises `_NotHTML` if the content type is not text/html. + """ + content_type = response.headers.get("Content-Type", "") + if not content_type.lower().startswith("text/html"): + raise _NotHTML(content_type, response.request.method) + + +class _NotHTTP(Exception): + pass + + +def _ensure_html_response(url, session): + # type: (str, PipSession) -> None + """Send a HEAD request to the URL, and ensure the response contains HTML. + + Raises `_NotHTTP` if the URL is not available for a HEAD request, or + `_NotHTML` if the content type is not text/html. + """ + scheme, netloc, path, query, fragment = urllib_parse.urlsplit(url) + if scheme not in {'http', 'https'}: + raise _NotHTTP() + + resp = session.head(url, allow_redirects=True) + resp.raise_for_status() + + _ensure_html_header(resp) + + +def _get_html_response(url, session): + # type: (str, PipSession) -> Response + """Access an HTML page with GET, and return the response. + + This consists of three parts: + + 1. If the URL looks suspiciously like an archive, send a HEAD first to + check the Content-Type is HTML, to avoid downloading a large file. + Raise `_NotHTTP` if the content type cannot be determined, or + `_NotHTML` if it is not HTML. + 2. Actually perform the request. Raise HTTP exceptions on network failures. + 3. Check the Content-Type header to make sure we got HTML, and raise + `_NotHTML` otherwise. + """ + if _is_url_like_archive(url): + _ensure_html_response(url, session=session) + + logger.debug('Getting page %s', redact_auth_from_url(url)) + + resp = session.get( + url, + headers={ + "Accept": "text/html", + # We don't want to blindly returned cached data for + # /simple/, because authors generally expecting that + # twine upload && pip install will function, but if + # they've done a pip install in the last ~10 minutes + # it won't. Thus by setting this to zero we will not + # blindly use any cached data, however the benefit of + # using max-age=0 instead of no-cache, is that we will + # still support conditional requests, so we will still + # minimize traffic sent in cases where the page hasn't + # changed at all, we will just always incur the round + # trip for the conditional GET now instead of only + # once per 10 minutes. + # For more information, please see pypa/pip#5670. + "Cache-Control": "max-age=0", + }, + ) + resp.raise_for_status() + + # The check for archives above only works if the url ends with + # something that looks like an archive. However that is not a + # requirement of an url. Unless we issue a HEAD request on every + # url we cannot know ahead of time for sure if something is HTML + # or not. However we can check after we've downloaded it. + _ensure_html_header(resp) + + return resp + + +def _get_encoding_from_headers(headers): + # type: (ResponseHeaders) -> Optional[str] + """Determine if we have any encoding information in our headers. + """ + if headers and "Content-Type" in headers: + content_type, params = cgi.parse_header(headers["Content-Type"]) + if "charset" in params: + return params['charset'] + return None + + +def _determine_base_url(document, page_url): + # type: (HTMLElement, str) -> str + """Determine the HTML document's base URL. + + This looks for a ```` tag in the HTML document. If present, its href + attribute denotes the base URL of anchor tags in the document. If there is + no such tag (or if it does not have a valid href attribute), the HTML + file's URL is used as the base URL. + + :param document: An HTML document representation. The current + implementation expects the result of ``html5lib.parse()``. + :param page_url: The URL of the HTML document. + """ + for base in document.findall(".//base"): + href = base.get("href") + if href is not None: + return href + return page_url + + +def _clean_link(url): + # type: (str) -> str + """Makes sure a link is fully encoded. That is, if a ' ' shows up in + the link, it will be rewritten to %20 (while not over-quoting + % or other characters).""" + # Split the URL into parts according to the general structure + # `scheme://netloc/path;parameters?query#fragment`. Note that the + # `netloc` can be empty and the URI will then refer to a local + # filesystem path. + result = urllib_parse.urlparse(url) + # In both cases below we unquote prior to quoting to make sure + # nothing is double quoted. + if result.netloc == "": + # On Windows the path part might contain a drive letter which + # should not be quoted. On Linux where drive letters do not + # exist, the colon should be quoted. We rely on urllib.request + # to do the right thing here. + path = urllib_request.pathname2url( + urllib_request.url2pathname(result.path)) + else: + # In addition to the `/` character we protect `@` so that + # revision strings in VCS URLs are properly parsed. + path = urllib_parse.quote(urllib_parse.unquote(result.path), safe="/@") + return urllib_parse.urlunparse(result._replace(path=path)) + + +def _create_link_from_element( + anchor, # type: HTMLElement + page_url, # type: str + base_url, # type: str +): + # type: (...) -> Optional[Link] + """ + Convert an anchor element in a simple repository page to a Link. + """ + href = anchor.get("href") + if not href: + return None + + url = _clean_link(urllib_parse.urljoin(base_url, href)) + pyrequire = anchor.get('data-requires-python') + pyrequire = unescape(pyrequire) if pyrequire else None + + yanked_reason = anchor.get('data-yanked') + if yanked_reason: + # This is a unicode string in Python 2 (and 3). + yanked_reason = unescape(yanked_reason) + + link = Link( + url, + comes_from=page_url, + requires_python=pyrequire, + yanked_reason=yanked_reason, + ) + + return link + + +def parse_links(page): + # type: (HTMLPage) -> Iterable[Link] + """ + Parse an HTML document, and yield its anchor elements as Link objects. + """ + document = html5lib.parse( + page.content, + transport_encoding=page.encoding, + namespaceHTMLElements=False, + ) + + url = page.url + base_url = _determine_base_url(document, url) + for anchor in document.findall(".//a"): + link = _create_link_from_element( + anchor, + page_url=url, + base_url=base_url, + ) + if link is None: + continue + yield link + + +class HTMLPage(object): + """Represents one page, along with its URL""" + + def __init__( + self, + content, # type: bytes + encoding, # type: Optional[str] + url, # type: str + ): + # type: (...) -> None + """ + :param encoding: the encoding to decode the given content. + :param url: the URL from which the HTML was downloaded. + """ + self.content = content + self.encoding = encoding + self.url = url + + def __str__(self): + # type: () -> str + return redact_auth_from_url(self.url) + + +def _handle_get_page_fail( + link, # type: Link + reason, # type: Union[str, Exception] + meth=None # type: Optional[Callable[..., None]] +): + # type: (...) -> None + if meth is None: + meth = logger.debug + meth("Could not fetch URL %s: %s - skipping", link, reason) + + +def _make_html_page(response): + # type: (Response) -> HTMLPage + encoding = _get_encoding_from_headers(response.headers) + return HTMLPage(response.content, encoding=encoding, url=response.url) + + +def _get_html_page(link, session=None): + # type: (Link, Optional[PipSession]) -> Optional[HTMLPage] + if session is None: + raise TypeError( + "_get_html_page() missing 1 required keyword argument: 'session'" + ) + + url = link.url.split('#', 1)[0] + + # Check for VCS schemes that do not support lookup as web pages. + vcs_scheme = _match_vcs_scheme(url) + if vcs_scheme: + logger.debug('Cannot look at %s URL %s', vcs_scheme, link) + return None + + # Tack index.html onto file:// URLs that point to directories + scheme, _, path, _, _, _ = urllib_parse.urlparse(url) + if (scheme == 'file' and os.path.isdir(urllib_request.url2pathname(path))): + # add trailing slash if not present so urljoin doesn't trim + # final segment + if not url.endswith('/'): + url += '/' + url = urllib_parse.urljoin(url, 'index.html') + logger.debug(' file: URL is directory, getting %s', url) + + try: + resp = _get_html_response(url, session=session) + except _NotHTTP: + logger.debug( + 'Skipping page %s because it looks like an archive, and cannot ' + 'be checked by HEAD.', link, + ) + except _NotHTML as exc: + logger.debug( + 'Skipping page %s because the %s request got Content-Type: %s', + link, exc.request_desc, exc.content_type, + ) + except HTTPError as exc: + _handle_get_page_fail(link, exc) + except RetryError as exc: + _handle_get_page_fail(link, exc) + except SSLError as exc: + reason = "There was a problem confirming the ssl certificate: " + reason += str(exc) + _handle_get_page_fail(link, reason, meth=logger.info) + except requests.ConnectionError as exc: + _handle_get_page_fail(link, "connection error: %s" % exc) + except requests.Timeout: + _handle_get_page_fail(link, "timed out") + else: + return _make_html_page(resp) + return None + + +def _remove_duplicate_links(links): + # type: (Iterable[Link]) -> List[Link] + """ + Return a list of links, with duplicates removed and ordering preserved. + """ + # We preserve the ordering when removing duplicates because we can. + return list(OrderedDict.fromkeys(links)) + + +def group_locations(locations, expand_dir=False): + # type: (Sequence[str], bool) -> Tuple[List[str], List[str]] + """ + Divide a list of locations into two groups: "files" (archives) and "urls." + + :return: A pair of lists (files, urls). + """ + files = [] + urls = [] + + # puts the url for the given file path into the appropriate list + def sort_path(path): + # type: (str) -> None + url = path_to_url(path) + if mimetypes.guess_type(url, strict=False)[0] == 'text/html': + urls.append(url) + else: + files.append(url) + + for url in locations: + + is_local_path = os.path.exists(url) + is_file_url = url.startswith('file:') + + if is_local_path or is_file_url: + if is_local_path: + path = url + else: + path = url_to_path(url) + if os.path.isdir(path): + if expand_dir: + path = os.path.realpath(path) + for item in os.listdir(path): + sort_path(os.path.join(path, item)) + elif is_file_url: + urls.append(url) + else: + logger.warning( + "Path '{0}' is ignored: " + "it is a directory.".format(path), + ) + elif os.path.isfile(path): + sort_path(path) + else: + logger.warning( + "Url '%s' is ignored: it is neither a file " + "nor a directory.", url, + ) + elif is_url(url): + # Only add url with clear scheme + urls.append(url) + else: + logger.warning( + "Url '%s' is ignored. It is either a non-existing " + "path or lacks a specific scheme.", url, + ) + + return files, urls + + +class CollectedLinks(object): + + """ + Encapsulates the return value of a call to LinkCollector.collect_links(). + + The return value includes both URLs to project pages containing package + links, as well as individual package Link objects collected from other + sources. + + This info is stored separately as: + + (1) links from the configured file locations, + (2) links from the configured find_links, and + (3) urls to HTML project pages, as described by the PEP 503 simple + repository API. + """ + + def __init__( + self, + files, # type: List[Link] + find_links, # type: List[Link] + project_urls, # type: List[Link] + ): + # type: (...) -> None + """ + :param files: Links from file locations. + :param find_links: Links from find_links. + :param project_urls: URLs to HTML project pages, as described by + the PEP 503 simple repository API. + """ + self.files = files + self.find_links = find_links + self.project_urls = project_urls + + +class LinkCollector(object): + + """ + Responsible for collecting Link objects from all configured locations, + making network requests as needed. + + The class's main method is its collect_links() method. + """ + + def __init__( + self, + session, # type: PipSession + search_scope, # type: SearchScope + ): + # type: (...) -> None + self.search_scope = search_scope + self.session = session + + @property + def find_links(self): + # type: () -> List[str] + return self.search_scope.find_links + + def fetch_page(self, location): + # type: (Link) -> Optional[HTMLPage] + """ + Fetch an HTML page containing package links. + """ + return _get_html_page(location, session=self.session) + + def collect_links(self, project_name): + # type: (str) -> CollectedLinks + """Find all available links for the given project name. + + :return: All the Link objects (unfiltered), as a CollectedLinks object. + """ + search_scope = self.search_scope + index_locations = search_scope.get_index_urls_locations(project_name) + index_file_loc, index_url_loc = group_locations(index_locations) + fl_file_loc, fl_url_loc = group_locations( + self.find_links, expand_dir=True, + ) + + file_links = [ + Link(url) for url in itertools.chain(index_file_loc, fl_file_loc) + ] + + # We trust every directly linked archive in find_links + find_link_links = [Link(url, '-f') for url in self.find_links] + + # We trust every url that the user has given us whether it was given + # via --index-url or --find-links. + # We want to filter out anything that does not have a secure origin. + url_locations = [ + link for link in itertools.chain( + (Link(url) for url in index_url_loc), + (Link(url) for url in fl_url_loc), + ) + if self.session.is_secure_origin(link) + ] + + url_locations = _remove_duplicate_links(url_locations) + lines = [ + '{} location(s) to search for versions of {}:'.format( + len(url_locations), project_name, + ), + ] + for link in url_locations: + lines.append('* {}'.format(link)) + logger.debug('\n'.join(lines)) + + return CollectedLinks( + files=file_links, + find_links=find_link_links, + project_urls=url_locations, + ) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/index/package_finder.py b/venv/lib/python3.8/site-packages/pip/_internal/index/package_finder.py new file mode 100644 index 000000000..a74d78db5 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/index/package_finder.py @@ -0,0 +1,1013 @@ +"""Routines related to PyPI, indexes""" + +# The following comment should be removed at some point in the future. +# mypy: strict-optional=False + +from __future__ import absolute_import + +import logging +import re + +from pip._vendor.packaging import specifiers +from pip._vendor.packaging.utils import canonicalize_name +from pip._vendor.packaging.version import parse as parse_version + +from pip._internal.exceptions import ( + BestVersionAlreadyInstalled, + DistributionNotFound, + InvalidWheelFilename, + UnsupportedWheel, +) +from pip._internal.index.collector import parse_links +from pip._internal.models.candidate import InstallationCandidate +from pip._internal.models.format_control import FormatControl +from pip._internal.models.link import Link +from pip._internal.models.selection_prefs import SelectionPreferences +from pip._internal.models.target_python import TargetPython +from pip._internal.models.wheel import Wheel +from pip._internal.utils.filetypes import WHEEL_EXTENSION +from pip._internal.utils.logging import indent_log +from pip._internal.utils.misc import build_netloc +from pip._internal.utils.packaging import check_requires_python +from pip._internal.utils.typing import MYPY_CHECK_RUNNING +from pip._internal.utils.unpacking import SUPPORTED_EXTENSIONS +from pip._internal.utils.urls import url_to_path + +if MYPY_CHECK_RUNNING: + from typing import ( + FrozenSet, Iterable, List, Optional, Set, Text, Tuple, Union, + ) + + from pip._vendor.packaging.tags import Tag + from pip._vendor.packaging.version import _BaseVersion + + from pip._internal.index.collector import LinkCollector + from pip._internal.models.search_scope import SearchScope + from pip._internal.req import InstallRequirement + from pip._internal.utils.hashes import Hashes + + BuildTag = Union[Tuple[()], Tuple[int, str]] + CandidateSortingKey = ( + Tuple[int, int, int, _BaseVersion, BuildTag, Optional[int]] + ) + + +__all__ = ['FormatControl', 'BestCandidateResult', 'PackageFinder'] + + +logger = logging.getLogger(__name__) + + +def _check_link_requires_python( + link, # type: Link + version_info, # type: Tuple[int, int, int] + ignore_requires_python=False, # type: bool +): + # type: (...) -> bool + """ + Return whether the given Python version is compatible with a link's + "Requires-Python" value. + + :param version_info: A 3-tuple of ints representing the Python + major-minor-micro version to check. + :param ignore_requires_python: Whether to ignore the "Requires-Python" + value if the given Python version isn't compatible. + """ + try: + is_compatible = check_requires_python( + link.requires_python, version_info=version_info, + ) + except specifiers.InvalidSpecifier: + logger.debug( + "Ignoring invalid Requires-Python (%r) for link: %s", + link.requires_python, link, + ) + else: + if not is_compatible: + version = '.'.join(map(str, version_info)) + if not ignore_requires_python: + logger.debug( + 'Link requires a different Python (%s not in: %r): %s', + version, link.requires_python, link, + ) + return False + + logger.debug( + 'Ignoring failed Requires-Python check (%s not in: %r) ' + 'for link: %s', + version, link.requires_python, link, + ) + + return True + + +class LinkEvaluator(object): + + """ + Responsible for evaluating links for a particular project. + """ + + _py_version_re = re.compile(r'-py([123]\.?[0-9]?)$') + + # Don't include an allow_yanked default value to make sure each call + # site considers whether yanked releases are allowed. This also causes + # that decision to be made explicit in the calling code, which helps + # people when reading the code. + def __init__( + self, + project_name, # type: str + canonical_name, # type: str + formats, # type: FrozenSet[str] + target_python, # type: TargetPython + allow_yanked, # type: bool + ignore_requires_python=None, # type: Optional[bool] + ): + # type: (...) -> None + """ + :param project_name: The user supplied package name. + :param canonical_name: The canonical package name. + :param formats: The formats allowed for this package. Should be a set + with 'binary' or 'source' or both in it. + :param target_python: The target Python interpreter to use when + evaluating link compatibility. This is used, for example, to + check wheel compatibility, as well as when checking the Python + version, e.g. the Python version embedded in a link filename + (or egg fragment) and against an HTML link's optional PEP 503 + "data-requires-python" attribute. + :param allow_yanked: Whether files marked as yanked (in the sense + of PEP 592) are permitted to be candidates for install. + :param ignore_requires_python: Whether to ignore incompatible + PEP 503 "data-requires-python" values in HTML links. Defaults + to False. + """ + if ignore_requires_python is None: + ignore_requires_python = False + + self._allow_yanked = allow_yanked + self._canonical_name = canonical_name + self._ignore_requires_python = ignore_requires_python + self._formats = formats + self._target_python = target_python + + self.project_name = project_name + + def evaluate_link(self, link): + # type: (Link) -> Tuple[bool, Optional[Text]] + """ + Determine whether a link is a candidate for installation. + + :return: A tuple (is_candidate, result), where `result` is (1) a + version string if `is_candidate` is True, and (2) if + `is_candidate` is False, an optional string to log the reason + the link fails to qualify. + """ + version = None + if link.is_yanked and not self._allow_yanked: + reason = link.yanked_reason or '' + # Mark this as a unicode string to prevent "UnicodeEncodeError: + # 'ascii' codec can't encode character" in Python 2 when + # the reason contains non-ascii characters. + return (False, u'yanked for reason: {}'.format(reason)) + + if link.egg_fragment: + egg_info = link.egg_fragment + ext = link.ext + else: + egg_info, ext = link.splitext() + if not ext: + return (False, 'not a file') + if ext not in SUPPORTED_EXTENSIONS: + return (False, 'unsupported archive format: %s' % ext) + if "binary" not in self._formats and ext == WHEEL_EXTENSION: + reason = 'No binaries permitted for %s' % self.project_name + return (False, reason) + if "macosx10" in link.path and ext == '.zip': + return (False, 'macosx10 one') + if ext == WHEEL_EXTENSION: + try: + wheel = Wheel(link.filename) + except InvalidWheelFilename: + return (False, 'invalid wheel filename') + if canonicalize_name(wheel.name) != self._canonical_name: + reason = 'wrong project name (not %s)' % self.project_name + return (False, reason) + + supported_tags = self._target_python.get_tags() + if not wheel.supported(supported_tags): + # Include the wheel's tags in the reason string to + # simplify troubleshooting compatibility issues. + file_tags = wheel.get_formatted_file_tags() + reason = ( + "none of the wheel's tags match: {}".format( + ', '.join(file_tags) + ) + ) + return (False, reason) + + version = wheel.version + + # This should be up by the self.ok_binary check, but see issue 2700. + if "source" not in self._formats and ext != WHEEL_EXTENSION: + return (False, 'No sources permitted for %s' % self.project_name) + + if not version: + version = _extract_version_from_fragment( + egg_info, self._canonical_name, + ) + if not version: + return ( + False, 'Missing project version for %s' % self.project_name, + ) + + match = self._py_version_re.search(version) + if match: + version = version[:match.start()] + py_version = match.group(1) + if py_version != self._target_python.py_version: + return (False, 'Python version is incorrect') + + supports_python = _check_link_requires_python( + link, version_info=self._target_python.py_version_info, + ignore_requires_python=self._ignore_requires_python, + ) + if not supports_python: + # Return None for the reason text to suppress calling + # _log_skipped_link(). + return (False, None) + + logger.debug('Found link %s, version: %s', link, version) + + return (True, version) + + +def filter_unallowed_hashes( + candidates, # type: List[InstallationCandidate] + hashes, # type: Hashes + project_name, # type: str +): + # type: (...) -> List[InstallationCandidate] + """ + Filter out candidates whose hashes aren't allowed, and return a new + list of candidates. + + If at least one candidate has an allowed hash, then all candidates with + either an allowed hash or no hash specified are returned. Otherwise, + the given candidates are returned. + + Including the candidates with no hash specified when there is a match + allows a warning to be logged if there is a more preferred candidate + with no hash specified. Returning all candidates in the case of no + matches lets pip report the hash of the candidate that would otherwise + have been installed (e.g. permitting the user to more easily update + their requirements file with the desired hash). + """ + if not hashes: + logger.debug( + 'Given no hashes to check %s links for project %r: ' + 'discarding no candidates', + len(candidates), + project_name, + ) + # Make sure we're not returning back the given value. + return list(candidates) + + matches_or_no_digest = [] + # Collect the non-matches for logging purposes. + non_matches = [] + match_count = 0 + for candidate in candidates: + link = candidate.link + if not link.has_hash: + pass + elif link.is_hash_allowed(hashes=hashes): + match_count += 1 + else: + non_matches.append(candidate) + continue + + matches_or_no_digest.append(candidate) + + if match_count: + filtered = matches_or_no_digest + else: + # Make sure we're not returning back the given value. + filtered = list(candidates) + + if len(filtered) == len(candidates): + discard_message = 'discarding no candidates' + else: + discard_message = 'discarding {} non-matches:\n {}'.format( + len(non_matches), + '\n '.join(str(candidate.link) for candidate in non_matches) + ) + + logger.debug( + 'Checked %s links for project %r against %s hashes ' + '(%s matches, %s no digest): %s', + len(candidates), + project_name, + hashes.digest_count, + match_count, + len(matches_or_no_digest) - match_count, + discard_message + ) + + return filtered + + +class CandidatePreferences(object): + + """ + Encapsulates some of the preferences for filtering and sorting + InstallationCandidate objects. + """ + + def __init__( + self, + prefer_binary=False, # type: bool + allow_all_prereleases=False, # type: bool + ): + # type: (...) -> None + """ + :param allow_all_prereleases: Whether to allow all pre-releases. + """ + self.allow_all_prereleases = allow_all_prereleases + self.prefer_binary = prefer_binary + + +class BestCandidateResult(object): + """A collection of candidates, returned by `PackageFinder.find_best_candidate`. + + This class is only intended to be instantiated by CandidateEvaluator's + `compute_best_candidate()` method. + """ + + def __init__( + self, + candidates, # type: List[InstallationCandidate] + applicable_candidates, # type: List[InstallationCandidate] + best_candidate, # type: Optional[InstallationCandidate] + ): + # type: (...) -> None + """ + :param candidates: A sequence of all available candidates found. + :param applicable_candidates: The applicable candidates. + :param best_candidate: The most preferred candidate found, or None + if no applicable candidates were found. + """ + assert set(applicable_candidates) <= set(candidates) + + if best_candidate is None: + assert not applicable_candidates + else: + assert best_candidate in applicable_candidates + + self._applicable_candidates = applicable_candidates + self._candidates = candidates + + self.best_candidate = best_candidate + + def iter_all(self): + # type: () -> Iterable[InstallationCandidate] + """Iterate through all candidates. + """ + return iter(self._candidates) + + def iter_applicable(self): + # type: () -> Iterable[InstallationCandidate] + """Iterate through the applicable candidates. + """ + return iter(self._applicable_candidates) + + +class CandidateEvaluator(object): + + """ + Responsible for filtering and sorting candidates for installation based + on what tags are valid. + """ + + @classmethod + def create( + cls, + project_name, # type: str + target_python=None, # type: Optional[TargetPython] + prefer_binary=False, # type: bool + allow_all_prereleases=False, # type: bool + specifier=None, # type: Optional[specifiers.BaseSpecifier] + hashes=None, # type: Optional[Hashes] + ): + # type: (...) -> CandidateEvaluator + """Create a CandidateEvaluator object. + + :param target_python: The target Python interpreter to use when + checking compatibility. If None (the default), a TargetPython + object will be constructed from the running Python. + :param specifier: An optional object implementing `filter` + (e.g. `packaging.specifiers.SpecifierSet`) to filter applicable + versions. + :param hashes: An optional collection of allowed hashes. + """ + if target_python is None: + target_python = TargetPython() + if specifier is None: + specifier = specifiers.SpecifierSet() + + supported_tags = target_python.get_tags() + + return cls( + project_name=project_name, + supported_tags=supported_tags, + specifier=specifier, + prefer_binary=prefer_binary, + allow_all_prereleases=allow_all_prereleases, + hashes=hashes, + ) + + def __init__( + self, + project_name, # type: str + supported_tags, # type: List[Tag] + specifier, # type: specifiers.BaseSpecifier + prefer_binary=False, # type: bool + allow_all_prereleases=False, # type: bool + hashes=None, # type: Optional[Hashes] + ): + # type: (...) -> None + """ + :param supported_tags: The PEP 425 tags supported by the target + Python in order of preference (most preferred first). + """ + self._allow_all_prereleases = allow_all_prereleases + self._hashes = hashes + self._prefer_binary = prefer_binary + self._project_name = project_name + self._specifier = specifier + self._supported_tags = supported_tags + + def get_applicable_candidates( + self, + candidates, # type: List[InstallationCandidate] + ): + # type: (...) -> List[InstallationCandidate] + """ + Return the applicable candidates from a list of candidates. + """ + # Using None infers from the specifier instead. + allow_prereleases = self._allow_all_prereleases or None + specifier = self._specifier + versions = { + str(v) for v in specifier.filter( + # We turn the version object into a str here because otherwise + # when we're debundled but setuptools isn't, Python will see + # packaging.version.Version and + # pkg_resources._vendor.packaging.version.Version as different + # types. This way we'll use a str as a common data interchange + # format. If we stop using the pkg_resources provided specifier + # and start using our own, we can drop the cast to str(). + (str(c.version) for c in candidates), + prereleases=allow_prereleases, + ) + } + + # Again, converting version to str to deal with debundling. + applicable_candidates = [ + c for c in candidates if str(c.version) in versions + ] + + filtered_applicable_candidates = filter_unallowed_hashes( + candidates=applicable_candidates, + hashes=self._hashes, + project_name=self._project_name, + ) + + return sorted(filtered_applicable_candidates, key=self._sort_key) + + def _sort_key(self, candidate): + # type: (InstallationCandidate) -> CandidateSortingKey + """ + Function to pass as the `key` argument to a call to sorted() to sort + InstallationCandidates by preference. + + Returns a tuple such that tuples sorting as greater using Python's + default comparison operator are more preferred. + + The preference is as follows: + + First and foremost, candidates with allowed (matching) hashes are + always preferred over candidates without matching hashes. This is + because e.g. if the only candidate with an allowed hash is yanked, + we still want to use that candidate. + + Second, excepting hash considerations, candidates that have been + yanked (in the sense of PEP 592) are always less preferred than + candidates that haven't been yanked. Then: + + If not finding wheels, they are sorted by version only. + If finding wheels, then the sort order is by version, then: + 1. existing installs + 2. wheels ordered via Wheel.support_index_min(self._supported_tags) + 3. source archives + If prefer_binary was set, then all wheels are sorted above sources. + + Note: it was considered to embed this logic into the Link + comparison operators, but then different sdist links + with the same version, would have to be considered equal + """ + valid_tags = self._supported_tags + support_num = len(valid_tags) + build_tag = () # type: BuildTag + binary_preference = 0 + link = candidate.link + if link.is_wheel: + # can raise InvalidWheelFilename + wheel = Wheel(link.filename) + if not wheel.supported(valid_tags): + raise UnsupportedWheel( + "%s is not a supported wheel for this platform. It " + "can't be sorted." % wheel.filename + ) + if self._prefer_binary: + binary_preference = 1 + pri = -(wheel.support_index_min(valid_tags)) + if wheel.build_tag is not None: + match = re.match(r'^(\d+)(.*)$', wheel.build_tag) + build_tag_groups = match.groups() + build_tag = (int(build_tag_groups[0]), build_tag_groups[1]) + else: # sdist + pri = -(support_num) + has_allowed_hash = int(link.is_hash_allowed(self._hashes)) + yank_value = -1 * int(link.is_yanked) # -1 for yanked. + return ( + has_allowed_hash, yank_value, binary_preference, candidate.version, + build_tag, pri, + ) + + def sort_best_candidate( + self, + candidates, # type: List[InstallationCandidate] + ): + # type: (...) -> Optional[InstallationCandidate] + """ + Return the best candidate per the instance's sort order, or None if + no candidate is acceptable. + """ + if not candidates: + return None + + best_candidate = max(candidates, key=self._sort_key) + + # Log a warning per PEP 592 if necessary before returning. + link = best_candidate.link + if link.is_yanked: + reason = link.yanked_reason or '' + msg = ( + # Mark this as a unicode string to prevent + # "UnicodeEncodeError: 'ascii' codec can't encode character" + # in Python 2 when the reason contains non-ascii characters. + u'The candidate selected for download or install is a ' + 'yanked version: {candidate}\n' + 'Reason for being yanked: {reason}' + ).format(candidate=best_candidate, reason=reason) + logger.warning(msg) + + return best_candidate + + def compute_best_candidate( + self, + candidates, # type: List[InstallationCandidate] + ): + # type: (...) -> BestCandidateResult + """ + Compute and return a `BestCandidateResult` instance. + """ + applicable_candidates = self.get_applicable_candidates(candidates) + + best_candidate = self.sort_best_candidate(applicable_candidates) + + return BestCandidateResult( + candidates, + applicable_candidates=applicable_candidates, + best_candidate=best_candidate, + ) + + +class PackageFinder(object): + """This finds packages. + + This is meant to match easy_install's technique for looking for + packages, by reading pages and looking for appropriate links. + """ + + def __init__( + self, + link_collector, # type: LinkCollector + target_python, # type: TargetPython + allow_yanked, # type: bool + format_control=None, # type: Optional[FormatControl] + candidate_prefs=None, # type: CandidatePreferences + ignore_requires_python=None, # type: Optional[bool] + ): + # type: (...) -> None + """ + This constructor is primarily meant to be used by the create() class + method and from tests. + + :param format_control: A FormatControl object, used to control + the selection of source packages / binary packages when consulting + the index and links. + :param candidate_prefs: Options to use when creating a + CandidateEvaluator object. + """ + if candidate_prefs is None: + candidate_prefs = CandidatePreferences() + + format_control = format_control or FormatControl(set(), set()) + + self._allow_yanked = allow_yanked + self._candidate_prefs = candidate_prefs + self._ignore_requires_python = ignore_requires_python + self._link_collector = link_collector + self._target_python = target_python + + self.format_control = format_control + + # These are boring links that have already been logged somehow. + self._logged_links = set() # type: Set[Link] + + # Don't include an allow_yanked default value to make sure each call + # site considers whether yanked releases are allowed. This also causes + # that decision to be made explicit in the calling code, which helps + # people when reading the code. + @classmethod + def create( + cls, + link_collector, # type: LinkCollector + selection_prefs, # type: SelectionPreferences + target_python=None, # type: Optional[TargetPython] + ): + # type: (...) -> PackageFinder + """Create a PackageFinder. + + :param selection_prefs: The candidate selection preferences, as a + SelectionPreferences object. + :param target_python: The target Python interpreter to use when + checking compatibility. If None (the default), a TargetPython + object will be constructed from the running Python. + """ + if target_python is None: + target_python = TargetPython() + + candidate_prefs = CandidatePreferences( + prefer_binary=selection_prefs.prefer_binary, + allow_all_prereleases=selection_prefs.allow_all_prereleases, + ) + + return cls( + candidate_prefs=candidate_prefs, + link_collector=link_collector, + target_python=target_python, + allow_yanked=selection_prefs.allow_yanked, + format_control=selection_prefs.format_control, + ignore_requires_python=selection_prefs.ignore_requires_python, + ) + + @property + def search_scope(self): + # type: () -> SearchScope + return self._link_collector.search_scope + + @search_scope.setter + def search_scope(self, search_scope): + # type: (SearchScope) -> None + self._link_collector.search_scope = search_scope + + @property + def find_links(self): + # type: () -> List[str] + return self._link_collector.find_links + + @property + def index_urls(self): + # type: () -> List[str] + return self.search_scope.index_urls + + @property + def trusted_hosts(self): + # type: () -> Iterable[str] + for host_port in self._link_collector.session.pip_trusted_origins: + yield build_netloc(*host_port) + + @property + def allow_all_prereleases(self): + # type: () -> bool + return self._candidate_prefs.allow_all_prereleases + + def set_allow_all_prereleases(self): + # type: () -> None + self._candidate_prefs.allow_all_prereleases = True + + def make_link_evaluator(self, project_name): + # type: (str) -> LinkEvaluator + canonical_name = canonicalize_name(project_name) + formats = self.format_control.get_allowed_formats(canonical_name) + + return LinkEvaluator( + project_name=project_name, + canonical_name=canonical_name, + formats=formats, + target_python=self._target_python, + allow_yanked=self._allow_yanked, + ignore_requires_python=self._ignore_requires_python, + ) + + def _sort_links(self, links): + # type: (Iterable[Link]) -> List[Link] + """ + Returns elements of links in order, non-egg links first, egg links + second, while eliminating duplicates + """ + eggs, no_eggs = [], [] + seen = set() # type: Set[Link] + for link in links: + if link not in seen: + seen.add(link) + if link.egg_fragment: + eggs.append(link) + else: + no_eggs.append(link) + return no_eggs + eggs + + def _log_skipped_link(self, link, reason): + # type: (Link, Text) -> None + if link not in self._logged_links: + # Mark this as a unicode string to prevent "UnicodeEncodeError: + # 'ascii' codec can't encode character" in Python 2 when + # the reason contains non-ascii characters. + # Also, put the link at the end so the reason is more visible + # and because the link string is usually very long. + logger.debug(u'Skipping link: %s: %s', reason, link) + self._logged_links.add(link) + + def get_install_candidate(self, link_evaluator, link): + # type: (LinkEvaluator, Link) -> Optional[InstallationCandidate] + """ + If the link is a candidate for install, convert it to an + InstallationCandidate and return it. Otherwise, return None. + """ + is_candidate, result = link_evaluator.evaluate_link(link) + if not is_candidate: + if result: + self._log_skipped_link(link, reason=result) + return None + + return InstallationCandidate( + name=link_evaluator.project_name, + link=link, + # Convert the Text result to str since InstallationCandidate + # accepts str. + version=str(result), + ) + + def evaluate_links(self, link_evaluator, links): + # type: (LinkEvaluator, Iterable[Link]) -> List[InstallationCandidate] + """ + Convert links that are candidates to InstallationCandidate objects. + """ + candidates = [] + for link in self._sort_links(links): + candidate = self.get_install_candidate(link_evaluator, link) + if candidate is not None: + candidates.append(candidate) + + return candidates + + def process_project_url(self, project_url, link_evaluator): + # type: (Link, LinkEvaluator) -> List[InstallationCandidate] + logger.debug( + 'Fetching project page and analyzing links: %s', project_url, + ) + html_page = self._link_collector.fetch_page(project_url) + if html_page is None: + return [] + + page_links = list(parse_links(html_page)) + + with indent_log(): + package_links = self.evaluate_links( + link_evaluator, + links=page_links, + ) + + return package_links + + def find_all_candidates(self, project_name): + # type: (str) -> List[InstallationCandidate] + """Find all available InstallationCandidate for project_name + + This checks index_urls and find_links. + All versions found are returned as an InstallationCandidate list. + + See LinkEvaluator.evaluate_link() for details on which files + are accepted. + """ + collected_links = self._link_collector.collect_links(project_name) + + link_evaluator = self.make_link_evaluator(project_name) + + find_links_versions = self.evaluate_links( + link_evaluator, + links=collected_links.find_links, + ) + + page_versions = [] + for project_url in collected_links.project_urls: + package_links = self.process_project_url( + project_url, link_evaluator=link_evaluator, + ) + page_versions.extend(package_links) + + file_versions = self.evaluate_links( + link_evaluator, + links=collected_links.files, + ) + if file_versions: + file_versions.sort(reverse=True) + logger.debug( + 'Local files found: %s', + ', '.join([ + url_to_path(candidate.link.url) + for candidate in file_versions + ]) + ) + + # This is an intentional priority ordering + return file_versions + find_links_versions + page_versions + + def make_candidate_evaluator( + self, + project_name, # type: str + specifier=None, # type: Optional[specifiers.BaseSpecifier] + hashes=None, # type: Optional[Hashes] + ): + # type: (...) -> CandidateEvaluator + """Create a CandidateEvaluator object to use. + """ + candidate_prefs = self._candidate_prefs + return CandidateEvaluator.create( + project_name=project_name, + target_python=self._target_python, + prefer_binary=candidate_prefs.prefer_binary, + allow_all_prereleases=candidate_prefs.allow_all_prereleases, + specifier=specifier, + hashes=hashes, + ) + + def find_best_candidate( + self, + project_name, # type: str + specifier=None, # type: Optional[specifiers.BaseSpecifier] + hashes=None, # type: Optional[Hashes] + ): + # type: (...) -> BestCandidateResult + """Find matches for the given project and specifier. + + :param specifier: An optional object implementing `filter` + (e.g. `packaging.specifiers.SpecifierSet`) to filter applicable + versions. + + :return: A `BestCandidateResult` instance. + """ + candidates = self.find_all_candidates(project_name) + candidate_evaluator = self.make_candidate_evaluator( + project_name=project_name, + specifier=specifier, + hashes=hashes, + ) + return candidate_evaluator.compute_best_candidate(candidates) + + def find_requirement(self, req, upgrade): + # type: (InstallRequirement, bool) -> Optional[Link] + """Try to find a Link matching req + + Expects req, an InstallRequirement and upgrade, a boolean + Returns a Link if found, + Raises DistributionNotFound or BestVersionAlreadyInstalled otherwise + """ + hashes = req.hashes(trust_internet=False) + best_candidate_result = self.find_best_candidate( + req.name, specifier=req.specifier, hashes=hashes, + ) + best_candidate = best_candidate_result.best_candidate + + installed_version = None # type: Optional[_BaseVersion] + if req.satisfied_by is not None: + installed_version = parse_version(req.satisfied_by.version) + + def _format_versions(cand_iter): + # type: (Iterable[InstallationCandidate]) -> str + # This repeated parse_version and str() conversion is needed to + # handle different vendoring sources from pip and pkg_resources. + # If we stop using the pkg_resources provided specifier and start + # using our own, we can drop the cast to str(). + return ", ".join(sorted( + {str(c.version) for c in cand_iter}, + key=parse_version, + )) or "none" + + if installed_version is None and best_candidate is None: + logger.critical( + 'Could not find a version that satisfies the requirement %s ' + '(from versions: %s)', + req, + _format_versions(best_candidate_result.iter_all()), + ) + + raise DistributionNotFound( + 'No matching distribution found for %s' % req + ) + + best_installed = False + if installed_version and ( + best_candidate is None or + best_candidate.version <= installed_version): + best_installed = True + + if not upgrade and installed_version is not None: + if best_installed: + logger.debug( + 'Existing installed version (%s) is most up-to-date and ' + 'satisfies requirement', + installed_version, + ) + else: + logger.debug( + 'Existing installed version (%s) satisfies requirement ' + '(most up-to-date version is %s)', + installed_version, + best_candidate.version, + ) + return None + + if best_installed: + # We have an existing version, and its the best version + logger.debug( + 'Installed version (%s) is most up-to-date (past versions: ' + '%s)', + installed_version, + _format_versions(best_candidate_result.iter_applicable()), + ) + raise BestVersionAlreadyInstalled + + logger.debug( + 'Using version %s (newest of versions: %s)', + best_candidate.version, + _format_versions(best_candidate_result.iter_applicable()), + ) + return best_candidate.link + + +def _find_name_version_sep(fragment, canonical_name): + # type: (str, str) -> int + """Find the separator's index based on the package's canonical name. + + :param fragment: A + filename "fragment" (stem) or + egg fragment. + :param canonical_name: The package's canonical name. + + This function is needed since the canonicalized name does not necessarily + have the same length as the egg info's name part. An example:: + + >>> fragment = 'foo__bar-1.0' + >>> canonical_name = 'foo-bar' + >>> _find_name_version_sep(fragment, canonical_name) + 8 + """ + # Project name and version must be separated by one single dash. Find all + # occurrences of dashes; if the string in front of it matches the canonical + # name, this is the one separating the name and version parts. + for i, c in enumerate(fragment): + if c != "-": + continue + if canonicalize_name(fragment[:i]) == canonical_name: + return i + raise ValueError("{} does not match {}".format(fragment, canonical_name)) + + +def _extract_version_from_fragment(fragment, canonical_name): + # type: (str, str) -> Optional[str] + """Parse the version string from a + filename + "fragment" (stem) or egg fragment. + + :param fragment: The string to parse. E.g. foo-2.1 + :param canonical_name: The canonicalized name of the package this + belongs to. + """ + try: + version_start = _find_name_version_sep(fragment, canonical_name) + 1 + except ValueError: + return None + version = fragment[version_start:] + if not version: + return None + return version diff --git a/venv/lib/python3.8/site-packages/pip/_internal/legacy_resolve.py b/venv/lib/python3.8/site-packages/pip/_internal/legacy_resolve.py new file mode 100644 index 000000000..ca269121b --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/legacy_resolve.py @@ -0,0 +1,430 @@ +"""Dependency Resolution + +The dependency resolution in pip is performed as follows: + +for top-level requirements: + a. only one spec allowed per project, regardless of conflicts or not. + otherwise a "double requirement" exception is raised + b. they override sub-dependency requirements. +for sub-dependencies + a. "first found, wins" (where the order is breadth first) +""" + +# The following comment should be removed at some point in the future. +# mypy: strict-optional=False +# mypy: disallow-untyped-defs=False + +import logging +import sys +from collections import defaultdict +from itertools import chain + +from pip._vendor.packaging import specifiers + +from pip._internal.exceptions import ( + BestVersionAlreadyInstalled, + DistributionNotFound, + HashError, + HashErrors, + UnsupportedPythonVersion, +) +from pip._internal.utils.logging import indent_log +from pip._internal.utils.misc import dist_in_usersite, normalize_version_info +from pip._internal.utils.packaging import ( + check_requires_python, + get_requires_python, +) +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import Callable, DefaultDict, List, Optional, Set, Tuple + from pip._vendor import pkg_resources + + from pip._internal.distributions import AbstractDistribution + from pip._internal.index.package_finder import PackageFinder + from pip._internal.operations.prepare import RequirementPreparer + from pip._internal.req.req_install import InstallRequirement + from pip._internal.req.req_set import RequirementSet + + InstallRequirementProvider = Callable[ + [str, InstallRequirement], InstallRequirement + ] + DiscoveredDependencies = DefaultDict[str, List[InstallRequirement]] + +logger = logging.getLogger(__name__) + + +def _check_dist_requires_python( + dist, # type: pkg_resources.Distribution + version_info, # type: Tuple[int, int, int] + ignore_requires_python=False, # type: bool +): + # type: (...) -> None + """ + Check whether the given Python version is compatible with a distribution's + "Requires-Python" value. + + :param version_info: A 3-tuple of ints representing the Python + major-minor-micro version to check. + :param ignore_requires_python: Whether to ignore the "Requires-Python" + value if the given Python version isn't compatible. + + :raises UnsupportedPythonVersion: When the given Python version isn't + compatible. + """ + requires_python = get_requires_python(dist) + try: + is_compatible = check_requires_python( + requires_python, version_info=version_info, + ) + except specifiers.InvalidSpecifier as exc: + logger.warning( + "Package %r has an invalid Requires-Python: %s", + dist.project_name, exc, + ) + return + + if is_compatible: + return + + version = '.'.join(map(str, version_info)) + if ignore_requires_python: + logger.debug( + 'Ignoring failed Requires-Python check for package %r: ' + '%s not in %r', + dist.project_name, version, requires_python, + ) + return + + raise UnsupportedPythonVersion( + 'Package {!r} requires a different Python: {} not in {!r}'.format( + dist.project_name, version, requires_python, + )) + + +class Resolver(object): + """Resolves which packages need to be installed/uninstalled to perform \ + the requested operation without breaking the requirements of any package. + """ + + _allowed_strategies = {"eager", "only-if-needed", "to-satisfy-only"} + + def __init__( + self, + preparer, # type: RequirementPreparer + finder, # type: PackageFinder + make_install_req, # type: InstallRequirementProvider + use_user_site, # type: bool + ignore_dependencies, # type: bool + ignore_installed, # type: bool + ignore_requires_python, # type: bool + force_reinstall, # type: bool + upgrade_strategy, # type: str + py_version_info=None, # type: Optional[Tuple[int, ...]] + ): + # type: (...) -> None + super(Resolver, self).__init__() + assert upgrade_strategy in self._allowed_strategies + + if py_version_info is None: + py_version_info = sys.version_info[:3] + else: + py_version_info = normalize_version_info(py_version_info) + + self._py_version_info = py_version_info + + self.preparer = preparer + self.finder = finder + + self.upgrade_strategy = upgrade_strategy + self.force_reinstall = force_reinstall + self.ignore_dependencies = ignore_dependencies + self.ignore_installed = ignore_installed + self.ignore_requires_python = ignore_requires_python + self.use_user_site = use_user_site + self._make_install_req = make_install_req + + self._discovered_dependencies = \ + defaultdict(list) # type: DiscoveredDependencies + + def resolve(self, requirement_set): + # type: (RequirementSet) -> None + """Resolve what operations need to be done + + As a side-effect of this method, the packages (and their dependencies) + are downloaded, unpacked and prepared for installation. This + preparation is done by ``pip.operations.prepare``. + + Once PyPI has static dependency metadata available, it would be + possible to move the preparation to become a step separated from + dependency resolution. + """ + # If any top-level requirement has a hash specified, enter + # hash-checking mode, which requires hashes from all. + root_reqs = ( + requirement_set.unnamed_requirements + + list(requirement_set.requirements.values()) + ) + + # Actually prepare the files, and collect any exceptions. Most hash + # exceptions cannot be checked ahead of time, because + # req.populate_link() needs to be called before we can make decisions + # based on link type. + discovered_reqs = [] # type: List[InstallRequirement] + hash_errors = HashErrors() + for req in chain(root_reqs, discovered_reqs): + try: + discovered_reqs.extend(self._resolve_one(requirement_set, req)) + except HashError as exc: + exc.req = req + hash_errors.append(exc) + + if hash_errors: + raise hash_errors + + def _is_upgrade_allowed(self, req): + # type: (InstallRequirement) -> bool + if self.upgrade_strategy == "to-satisfy-only": + return False + elif self.upgrade_strategy == "eager": + return True + else: + assert self.upgrade_strategy == "only-if-needed" + return req.is_direct + + def _set_req_to_reinstall(self, req): + # type: (InstallRequirement) -> None + """ + Set a requirement to be installed. + """ + # Don't uninstall the conflict if doing a user install and the + # conflict is not a user install. + if not self.use_user_site or dist_in_usersite(req.satisfied_by): + req.should_reinstall = True + req.satisfied_by = None + + def _check_skip_installed(self, req_to_install): + # type: (InstallRequirement) -> Optional[str] + """Check if req_to_install should be skipped. + + This will check if the req is installed, and whether we should upgrade + or reinstall it, taking into account all the relevant user options. + + After calling this req_to_install will only have satisfied_by set to + None if the req_to_install is to be upgraded/reinstalled etc. Any + other value will be a dist recording the current thing installed that + satisfies the requirement. + + Note that for vcs urls and the like we can't assess skipping in this + routine - we simply identify that we need to pull the thing down, + then later on it is pulled down and introspected to assess upgrade/ + reinstalls etc. + + :return: A text reason for why it was skipped, or None. + """ + if self.ignore_installed: + return None + + req_to_install.check_if_exists(self.use_user_site) + if not req_to_install.satisfied_by: + return None + + if self.force_reinstall: + self._set_req_to_reinstall(req_to_install) + return None + + if not self._is_upgrade_allowed(req_to_install): + if self.upgrade_strategy == "only-if-needed": + return 'already satisfied, skipping upgrade' + return 'already satisfied' + + # Check for the possibility of an upgrade. For link-based + # requirements we have to pull the tree down and inspect to assess + # the version #, so it's handled way down. + if not req_to_install.link: + try: + self.finder.find_requirement(req_to_install, upgrade=True) + except BestVersionAlreadyInstalled: + # Then the best version is installed. + return 'already up-to-date' + except DistributionNotFound: + # No distribution found, so we squash the error. It will + # be raised later when we re-try later to do the install. + # Why don't we just raise here? + pass + + self._set_req_to_reinstall(req_to_install) + return None + + def _get_abstract_dist_for(self, req): + # type: (InstallRequirement) -> AbstractDistribution + """Takes a InstallRequirement and returns a single AbstractDist \ + representing a prepared variant of the same. + """ + if req.editable: + return self.preparer.prepare_editable_requirement(req) + + # satisfied_by is only evaluated by calling _check_skip_installed, + # so it must be None here. + assert req.satisfied_by is None + skip_reason = self._check_skip_installed(req) + + if req.satisfied_by: + return self.preparer.prepare_installed_requirement( + req, skip_reason + ) + + upgrade_allowed = self._is_upgrade_allowed(req) + + # We eagerly populate the link, since that's our "legacy" behavior. + require_hashes = self.preparer.require_hashes + req.populate_link(self.finder, upgrade_allowed, require_hashes) + abstract_dist = self.preparer.prepare_linked_requirement(req) + + # NOTE + # The following portion is for determining if a certain package is + # going to be re-installed/upgraded or not and reporting to the user. + # This should probably get cleaned up in a future refactor. + + # req.req is only avail after unpack for URL + # pkgs repeat check_if_exists to uninstall-on-upgrade + # (#14) + if not self.ignore_installed: + req.check_if_exists(self.use_user_site) + + if req.satisfied_by: + should_modify = ( + self.upgrade_strategy != "to-satisfy-only" or + self.force_reinstall or + self.ignore_installed or + req.link.scheme == 'file' + ) + if should_modify: + self._set_req_to_reinstall(req) + else: + logger.info( + 'Requirement already satisfied (use --upgrade to upgrade):' + ' %s', req, + ) + + return abstract_dist + + def _resolve_one( + self, + requirement_set, # type: RequirementSet + req_to_install, # type: InstallRequirement + ): + # type: (...) -> List[InstallRequirement] + """Prepare a single requirements file. + + :return: A list of additional InstallRequirements to also install. + """ + # Tell user what we are doing for this requirement: + # obtain (editable), skipping, processing (local url), collecting + # (remote url or package name) + if req_to_install.constraint or req_to_install.prepared: + return [] + + req_to_install.prepared = True + + # register tmp src for cleanup in case something goes wrong + requirement_set.reqs_to_cleanup.append(req_to_install) + + abstract_dist = self._get_abstract_dist_for(req_to_install) + + # Parse and return dependencies + dist = abstract_dist.get_pkg_resources_distribution() + # This will raise UnsupportedPythonVersion if the given Python + # version isn't compatible with the distribution's Requires-Python. + _check_dist_requires_python( + dist, version_info=self._py_version_info, + ignore_requires_python=self.ignore_requires_python, + ) + + more_reqs = [] # type: List[InstallRequirement] + + def add_req(subreq, extras_requested): + sub_install_req = self._make_install_req( + str(subreq), + req_to_install, + ) + parent_req_name = req_to_install.name + to_scan_again, add_to_parent = requirement_set.add_requirement( + sub_install_req, + parent_req_name=parent_req_name, + extras_requested=extras_requested, + ) + if parent_req_name and add_to_parent: + self._discovered_dependencies[parent_req_name].append( + add_to_parent + ) + more_reqs.extend(to_scan_again) + + with indent_log(): + # We add req_to_install before its dependencies, so that we + # can refer to it when adding dependencies. + if not requirement_set.has_requirement(req_to_install.name): + # 'unnamed' requirements will get added here + # 'unnamed' requirements can only come from being directly + # provided by the user. + assert req_to_install.is_direct + requirement_set.add_requirement( + req_to_install, parent_req_name=None, + ) + + if not self.ignore_dependencies: + if req_to_install.extras: + logger.debug( + "Installing extra requirements: %r", + ','.join(req_to_install.extras), + ) + missing_requested = sorted( + set(req_to_install.extras) - set(dist.extras) + ) + for missing in missing_requested: + logger.warning( + '%s does not provide the extra \'%s\'', + dist, missing + ) + + available_requested = sorted( + set(dist.extras) & set(req_to_install.extras) + ) + for subreq in dist.requires(available_requested): + add_req(subreq, extras_requested=available_requested) + + if not req_to_install.editable and not req_to_install.satisfied_by: + # XXX: --no-install leads this to report 'Successfully + # downloaded' for only non-editable reqs, even though we took + # action on them. + requirement_set.successfully_downloaded.append(req_to_install) + + return more_reqs + + def get_installation_order(self, req_set): + # type: (RequirementSet) -> List[InstallRequirement] + """Create the installation order. + + The installation order is topological - requirements are installed + before the requiring thing. We break cycles at an arbitrary point, + and make no other guarantees. + """ + # The current implementation, which we may change at any point + # installs the user specified things in the order given, except when + # dependencies must come earlier to achieve topological order. + order = [] + ordered_reqs = set() # type: Set[InstallRequirement] + + def schedule(req): + if req.satisfied_by or req in ordered_reqs: + return + if req.constraint: + return + ordered_reqs.add(req) + for dep in self._discovered_dependencies[req.name]: + schedule(dep) + order.append(req) + + for install_req in req_set.requirements.values(): + schedule(install_req) + return order diff --git a/venv/lib/python3.8/site-packages/pip/_internal/locations.py b/venv/lib/python3.8/site-packages/pip/_internal/locations.py new file mode 100644 index 000000000..0c1155319 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/locations.py @@ -0,0 +1,194 @@ +"""Locations where we look for configs, install stuff, etc""" + +# The following comment should be removed at some point in the future. +# mypy: strict-optional=False + +from __future__ import absolute_import + +import os +import os.path +import platform +import site +import sys +import sysconfig +from distutils import sysconfig as distutils_sysconfig +from distutils.command.install import SCHEME_KEYS # type: ignore +from distutils.command.install import install as distutils_install_command + +from pip._internal.models.scheme import Scheme +from pip._internal.utils import appdirs +from pip._internal.utils.compat import WINDOWS +from pip._internal.utils.typing import MYPY_CHECK_RUNNING, cast +from pip._internal.utils.virtualenv import running_under_virtualenv + +if MYPY_CHECK_RUNNING: + from typing import Dict, List, Optional, Union + + from distutils.cmd import Command as DistutilsCommand + + +# Application Directories +USER_CACHE_DIR = appdirs.user_cache_dir("pip") + + +def get_major_minor_version(): + # type: () -> str + """ + Return the major-minor version of the current Python as a string, e.g. + "3.7" or "3.10". + """ + return '{}.{}'.format(*sys.version_info) + + +def get_src_prefix(): + # type: () -> str + if running_under_virtualenv(): + src_prefix = os.path.join(sys.prefix, 'src') + else: + # FIXME: keep src in cwd for now (it is not a temporary folder) + try: + src_prefix = os.path.join(os.getcwd(), 'src') + except OSError: + # In case the current working directory has been renamed or deleted + sys.exit( + "The folder you are executing pip from can no longer be found." + ) + + # under macOS + virtualenv sys.prefix is not properly resolved + # it is something like /path/to/python/bin/.. + return os.path.abspath(src_prefix) + + +# FIXME doesn't account for venv linked to global site-packages + +site_packages = sysconfig.get_path("purelib") # type: Optional[str] + +# This is because of a bug in PyPy's sysconfig module, see +# https://bitbucket.org/pypy/pypy/issues/2506/sysconfig-returns-incorrect-paths +# for more information. +if platform.python_implementation().lower() == "pypy": + site_packages = distutils_sysconfig.get_python_lib() +try: + # Use getusersitepackages if this is present, as it ensures that the + # value is initialised properly. + user_site = site.getusersitepackages() +except AttributeError: + user_site = site.USER_SITE + +if WINDOWS: + bin_py = os.path.join(sys.prefix, 'Scripts') + bin_user = os.path.join(user_site, 'Scripts') + # buildout uses 'bin' on Windows too? + if not os.path.exists(bin_py): + bin_py = os.path.join(sys.prefix, 'bin') + bin_user = os.path.join(user_site, 'bin') +else: + bin_py = os.path.join(sys.prefix, 'bin') + bin_user = os.path.join(user_site, 'bin') + + # Forcing to use /usr/local/bin for standard macOS framework installs + # Also log to ~/Library/Logs/ for use with the Console.app log viewer + if sys.platform[:6] == 'darwin' and sys.prefix[:16] == '/System/Library/': + bin_py = '/usr/local/bin' + + +def distutils_scheme( + dist_name, user=False, home=None, root=None, isolated=False, prefix=None +): + # type:(str, bool, str, str, bool, str) -> Dict[str, str] + """ + Return a distutils install scheme + """ + from distutils.dist import Distribution + + dist_args = {'name': dist_name} # type: Dict[str, Union[str, List[str]]] + if isolated: + dist_args["script_args"] = ["--no-user-cfg"] + + d = Distribution(dist_args) + d.parse_config_files() + obj = None # type: Optional[DistutilsCommand] + obj = d.get_command_obj('install', create=True) + assert obj is not None + i = cast(distutils_install_command, obj) + # NOTE: setting user or home has the side-effect of creating the home dir + # or user base for installations during finalize_options() + # ideally, we'd prefer a scheme class that has no side-effects. + assert not (user and prefix), "user={} prefix={}".format(user, prefix) + assert not (home and prefix), "home={} prefix={}".format(home, prefix) + i.user = user or i.user + if user or home: + i.prefix = "" + i.prefix = prefix or i.prefix + i.home = home or i.home + i.root = root or i.root + i.finalize_options() + + scheme = {} + for key in SCHEME_KEYS: + scheme[key] = getattr(i, 'install_' + key) + + # install_lib specified in setup.cfg should install *everything* + # into there (i.e. it takes precedence over both purelib and + # platlib). Note, i.install_lib is *always* set after + # finalize_options(); we only want to override here if the user + # has explicitly requested it hence going back to the config + if 'install_lib' in d.get_option_dict('install'): + scheme.update(dict(purelib=i.install_lib, platlib=i.install_lib)) + + if running_under_virtualenv(): + scheme['headers'] = os.path.join( + sys.prefix, + 'include', + 'site', + 'python{}'.format(get_major_minor_version()), + dist_name, + ) + + if root is not None: + path_no_drive = os.path.splitdrive( + os.path.abspath(scheme["headers"]))[1] + scheme["headers"] = os.path.join( + root, + path_no_drive[1:], + ) + + return scheme + + +def get_scheme( + dist_name, # type: str + user=False, # type: bool + home=None, # type: Optional[str] + root=None, # type: Optional[str] + isolated=False, # type: bool + prefix=None, # type: Optional[str] +): + # type: (...) -> Scheme + """ + Get the "scheme" corresponding to the input parameters. The distutils + documentation provides the context for the available schemes: + https://docs.python.org/3/install/index.html#alternate-installation + + :param dist_name: the name of the package to retrieve the scheme for, used + in the headers scheme path + :param user: indicates to use the "user" scheme + :param home: indicates to use the "home" scheme and provides the base + directory for the same + :param root: root under which other directories are re-based + :param isolated: equivalent to --no-user-cfg, i.e. do not consider + ~/.pydistutils.cfg (posix) or ~/pydistutils.cfg (non-posix) for + scheme paths + :param prefix: indicates to use the "prefix" scheme and provides the + base directory for the same + """ + scheme = distutils_scheme( + dist_name, user, home, root, isolated, prefix + ) + return Scheme( + platlib=scheme["platlib"], + purelib=scheme["purelib"], + headers=scheme["headers"], + scripts=scheme["scripts"], + data=scheme["data"], + ) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/main.py b/venv/lib/python3.8/site-packages/pip/_internal/main.py new file mode 100644 index 000000000..3208d5b88 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/main.py @@ -0,0 +1,16 @@ +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import Optional, List + + +def main(args=None): + # type: (Optional[List[str]]) -> int + """This is preserved for old console scripts that may still be referencing + it. + + For additional details, see https://github.com/pypa/pip/issues/7498. + """ + from pip._internal.utils.entrypoints import _wrapper + + return _wrapper(args) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/models/__init__.py b/venv/lib/python3.8/site-packages/pip/_internal/models/__init__.py new file mode 100644 index 000000000..7855226e4 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/models/__init__.py @@ -0,0 +1,2 @@ +"""A package that contains models that represent entities. +""" diff --git a/venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/__init__.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/__init__.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..9dada3df41007a3032ab1761d33825b33450fe55 GIT binary patch literal 253 zcmYjMF>b>!43x7ZFpxiJ^-y!@lA%c2JfKUEr9%bPB4Q!7B#5*D=STTc);^(IrZ7#1 z61XGo03MF}<+4;V+fw01_V-=B9Ygsoju=Rm- zA02k|Ff*o%gn_ldvq!4S_o}$ejd8It=B)BeVt?uS32p2Va*WBQBaGBY5)cngj$ykBnTnIC?be3ib#k=U#zC>fo9#0*q#-$ z3|w|4PWcbXasN_ZbIM=HAxTyD%NYXlaI<*Wew{eKYIH8Q$GFno9RRT z_{nVcV0Ir?#~fpSlG>CFMzQb8dcVM&=ZCwVm@mMQB%^|4j-Z+Qj?AfWgnJxjOfcac zlgt~c%=~wRkt~23!|vjP+SpvF+`=u>ycVU%tvvktv23+8vbHA5qqec&mAQ&;6q}G6 z(Y(=7dG2&FieMDT>}H^khEZ{K?Z7O(j#^G;QAQrw68JgiMWH2;e0> zko7^T%4cc2v@e?a%jB!nlvaM;=EZ*gT$;2k+Y~OeQrEdkD>$o6ddg(dF7*d+DVo^> zAdXK*)OSX7k2-%HUfcRb$>s?K#Uty1z6Ul1GZz2^{S^rXvIkOsb9*WewNg?D!2b4Nq-18=ub`oFGOxNh==nlFf)A@I*c;V0sH&E-!dHee{Z>t zIRCmEKAwWo(JKhcb zesvb_c2_}F35dNGjZOxsK}#g-w`&J8;OXv4AGncUvaqEx$sj_Fjk!I*E?Y>av3oTt ps=NGtnjt}gt)+bo!p1uHj5CVE+XFRsP@D#PZ0wBb7(@Z+{sXeNaXSD2 literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/format_control.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/format_control.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..eca3e69be90cd4b2086eac85ebdac822883fc5cd GIT binary patch literal 2445 zcmaJ@TW=gS6t?HKvy)BQq@gWsp@XOp3(c;$NT8^oiqMveSSqSMbR;m7v6G!-E*sBm z(rh;`B>W2=lE?m~dF82pArdN|J=rvy7QFHqpW|cu_*_2kz=D zJHp#HgBjj`L0SnvcRP&*CUd;*nrkmKKsgBvP6LzA zbCX*KG_YzL1DiLvdq4t*H@SyzL%4i~w+_fY4VrwG&q3z#3;ZI!Gu*&U7OL6%xlF@y zCC^HkC!+`7iDV$8zm`iMmk8J6Y+W%>Df~5=r~Xbqj{1J+55j0OTo*oE;I9fl&WbWj z62Uv3kJgKn*^{Qm2KowmaT{ceOKiGwt|a?pkB$w^-O!vdrene&1BLt%c}{!qmsuz; zWjR}ovrz6<ftNZ><*n@4mH^*J^-9r^p%I5dw4g-1`n7PpRo zNMn1JWAj_`>!*9x*y7HnAxD!vws`4`t$m6aLN0vg3@4r&8r$ z)!=avg_0wD_I8*IMde_Fby3PoYTC@iPGzYOo{!h%KCm#D)71~Kh`tjA3U0=ac zxSv+AK`dgu9NnC@^tClWlU}Ms#$u4WW| lNk@@}7U!!QA}X~ZZ@NL{-l-k+wc16yyk)d#3&6Q({tI-BPHX@G literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/index.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/index.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..eab64910cc8c7e3ff32ea2a023bb5a4a4dba04aa GIT binary patch literal 1175 zcmZuvJ#X7E5G5&DRvbBPS|mf;K|_aXh&6NxilQjm0zsA_=*OZCgd)Hju!r7)=|gY~ zF@SS8Gz+DzLIAB|!P}2Je*(kxbBXgyB;iApu ztpfc507n^SC?gDK-Ypv9=AJNX>ffNObBlbG1yD7x(P>^>=I8vlX8dY?^pQ)&HLs11 z^LTX>H)nBPvsfxIEg9D_&vnUFoEHVxIyNHaHIt%*yj~2eShwT4a(Hd}0|W*cyg=7v zN$wCv3&7Mf{<5>cclaWJ2yEG95CIMwOd7nkAh6S82wL|}vOt$(S#j&jnJklS+tCxr zm2!94kkYa)4W-tbsLDp*s`89BPj8wzAvILRZ}( z`*>JZoN6N!5Js68=VhIE*4MlmsxI8B`rz)d-J-Opa;+)7N58(NBQfTw5<=$kGM(x| zFrI2NVL)>_<@Gd$&QduuBT>H`9HzQ7{6My{=v0<6g;5MwbzY@o$gOl*I<*FJrUJMy z1k({XM0Rk1cW{KG&U|lE*uk2Og1G-y%VGCA--GELa0V@b@(Th&5TF>JB%X5BZ5PJB z0C}4!6QbPDKs!*Sb^*5Tkwe?y_P}&=5t%>vw~bAflde;#&c_^7>QM@_O@Lo&BTBzb z@@jR`r9gE-X)|k6AJl63EqGPI!QU1hxE7i|+#_(a>4qWfdr`l681vncF;c%ufpA$4 zggQ^>`%YI4bUFn_LL1K9L4q4S=lkmn!?l6G)@e^&eDMF=lcbwH1L+171ZF}Fba^!x ziz!?K6oB5!@zatUh_ee`nD*WJr?b=JEc^_m9om?!nbOT>!`CfUZ?GHCZAIS0eS!%h JzXPxR{sHUnG~fUL literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/link.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/link.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ff74d3a1ab7915c766fdbdb32d7c74c858f1df52 GIT binary patch literal 6688 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 QuB?~!8N8`Dir=#NKR%lh1^@s6 literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/scheme.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/scheme.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2c51156cb7ebdf936df1afa0ed6f95ce3e6b4898 GIT binary patch literal 891 zcmZWn&2AJi49@&?yNoDYIYw}*1d~HA2qDCe1h)#Q;<7@Dyc2IHG&>pM>~34_jlK)w z6?l}n@)n$MW?QickLHWx#IZlypN@_y!Sc2e_&pcmSK91L$(z^w(<25WX5xb|naOX2 z$uav@%yLtliR1G6XZ79(8LxUI2}HiJ5YfnujjgmDMQ{$H^_`@q#U)Z*jSe8svBLmP z`Zb2N#f|g}32U$p<__;}OX!S@E!rR(-$lHPPbDE%ZHzs=P|Em*>i#OWzN>vWS10N= zCa(rB>ozXk6L1kj$7wy=PpGaMX7-P89sY7gG0T{DZn9ZnnC*?2m8N9Q2gBrSO~ z$ekuz?+nQvVoP$<+NPBdP_Bq80h9>HIS@)?12)kI%f(vwP)QaD(Jr8g|CbNs$B`Mo z+g!jo*5mzVvX^txQ`YbJr^gK2Y%8?b=8W04V9d8AW3fG8EREp&vs0#U*mGN)owKqE zI4UiI!9c?yHNp0ghSETU=k z8&nim2D_-%*sT?ZQM+cH)Xx=J?#L}QQoZe!w%lUwlv7Lgb)yX|XS?s~RWXl+m sLW%P;M1& literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/search_scope.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/search_scope.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..9ee100cdfe31736665c61279834e901eea1cb224 GIT binary patch literal 3282 zcmbVO-EZ8+5$BRT9*;UnmaW)s5}<6820p;KOVKuP4Z#R%r)dyHaIL0Ahz1Nr?%h%1 zmv;AL`+6!0NI=quKJ>Lur$@i`&*5vI`Y-q)?r)a*ILj`Omc%Y+cZahxv%i_yFP4`* z1JAEKgWp{>jDOK!@v$-Z2u=P2U1B6GGlJ&J0;b1iVCt_GSooTmowtG(BOWVr@^;{A z+Ri$;7kHX(WlMQC=xW-@mh+WhC0`9z^|+l~$=8B4X7DvJgA6yjnqLd9Va(?1{EZV9 zT>r#KI*E5|Bp$zUWCb@9wr%v5{tf+%tsbk_;;1N#G>)=#%EKbcIVM|GBqR~`!>12F z#kW0BnU; zOh*&g;j7Y@T1;OHh)J=trwxM6_dc5Z3%ZeUXwBFIdZajICN&t?owjznPO9Q z=gWyjf8js1zd18z*33-oznL()HT|ttlWe^&IL!1Tf58oYxwFe-cA~1{MIu_X+(}`rD$7jPt#}-zMcsv@EZqq;s%sachH_*) z<~gsOtQ?KFsN0VtQNTUDc5TI(6e|!X5avd3WoMFRDqPUfCdUPC!5?cE){YjLJTt@( z@x$|-!MM!%K$K+_ReOU28J7tkNHs}#p#}%MI2b^qL8Tq?v;Lidgx2p@QM?z8xE#Rq zgD@>%ND*ZNIFM&@&>%B}sEYTir?nI7Gk**F$@kD1t2T3)ht_2_>)H;xf{_Q>d||g7 z(`0zRn_gW&NWT&B63z+pCYr|i6%aEvGeQGMH9`dDw(*Q@iDk_9tlE}58(#QH+un3O z7-~0!5vdBp2N+2T9>a0ibbV2SGnSaq^65kSyJ%X63I^}at`J6?*q>cE*KZq-LYkGaNEcYlMJ(ansnRt}kh(~j8hDQJ=Iw+-=QEIng_atOd~_CKgC!0@ua zIvXQi@F$hH_lV??!*F=U^utAmjW~cvIan!<_&rN${S6{Bd9QyiWV*g!g${JG;s4fO z`~><4LfR$0MGtd-Ks(pCW?rwYLr0Jih~YG^GEN~a)@j0NEU4|>GA%TKdZu`XR$5S$ z%S$`dH~x#&pVO{yqccpKtpn;S%zoj%umS!Hdiu`y@Lx=rJ9~(xW7S9NgZPFGS;7+Y z*!`>VjRBgl=AL0q=i+}p;%XvvZCR`|!*Wt2{y`d{vSh>lMQZada`%|WdrgIcgLD!0 zktQjB=Ez_EtzjypA}H!2hLqQ9KkZqM+^`vTt=z|J~fT5zv(7n~nma$Ha%{ z6F#Wg+sNpqQ|8q@fw7JZ2YGdR=YLc5LJanxT67vG;uoN`0+`Ty>j@vT^-T(v*V+F^ ztTt)b?XFDU{XUv(^*WTs>0%g$wHJm>H3!`d!~IE=ovyUQFezh9FU46TWzJFQ6Y(Qb z@?Gi%)ZL-(!gHGPX^w8yZ=lI8I@h#qlXMc~t zeu#RSl%n61PcZZ+DnAqv=rRaEe5=XB7aK?eu9sqZG@m!#;MnxnbZ kY0tdQnYFvooY6h1sFMD15g~ZZF6&amy`YQe=~|xkA6qqF!2kdN literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/selection_prefs.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/selection_prefs.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..9b44bc969b9643d379398636bdf11dd4e1550e01 GIT binary patch literal 1625 zcmZuxL5~|X6t-t3*)&RefR;n0N>;fv5}lDiNU*9ZAZ!Xkgs9aDH5bbnI~x;^J++;L zRN+MbO#jkcIq?^I;&~?7Bw`)S%RGDDd*Ay$+t>Ym7s2?Ui-f;G=%3)6js%?V;Bn8v zaKy1f1)gGz1h!AXk5p8|(-?=fSS3Yk+QR51;t6lPN4zE4f5+1c-hPb+7ym*AG{Ds- zzrLBgp~Ii9hQH8P*W>ZebzMA7cpNHL4_*r;@{o68#avjSbK&0cE`f2Sb5^>QVqQ4n7lPzWbIHLa?hr-F zV;GqmOSsu+Wf+(GrcMGOL~7@mQZPm4QVEyVE2DAVJ^>xxBY1}JxD?E;#qqLZdp!E9 zwZl6^(JlgucQM##mw=6TEwBm4&`ZoV5I(db;A7;jzKEIq0nMh}x_)T!vSgMO1i+aM z-7>ut{F3~>5YVk{u#$pVm?g}SW}Q5hx@N-(?Zj=Skj>1=_ z(cX~R34gApYEMhU#t9mr5wxXwBkm>no}8(@?}7l?W1~e%u3b}MA8-aK$aWM906Md> zIY49ilHGu=8JS7V?DjabSqM!a7bx!!Dh706gmhAK@h1tof}+d4m|<~GX0sz`llI6a zP|&PEC^3qEL1rsY)=bIpT4Ojv&ZYCjtU(7xwAdVghw1+@CU3N{f?Dx*C9QC@-1>#l zXSJJ80DNwWl6g5(=h{7awGVzase_*cXe%HH)NcADKZ-d6PT(vUGGfY!BaZQC(5iZ; z+o*cjcwi~?ZQ;N$CtP*^T-~aFMpyOO-K`ATRRS{3Z8#+st|4SQ!Q2Zb+)p2n?ZMwi zku6LiGHXo9%4N28x#1#ne#M3M*;?pzrsOPZ2>L4hCUeq@XNTR8m9osJ)LvM)XR-of zmCJ7TPiSQB(sEmMD10S7rJq7kcOMLT*uhEE#?9~DU_9GuV3ziwzq&xNz$j;-3wjZ)V+K^1V=0IljgZ@PMc!E*s* LFG_F^_u~Hm?K{<% literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/target_python.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/target_python.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3a09855cc605ea1fc40997057cf7e2f94f76aa79 GIT binary patch literal 3248 zcma)8TaVku73K^niL2GxZX4gy)|djlSjC2F;}$3k$7o}_Nzhg?l1+iI4H&LwBypFw z3`gr|BR#GA*#F=Fed#YMz}G(cFQft7?+mpoX`2Ee!NVbE=FB27=7uh#Z#VU_R@ky_FKuU?u)`eH(Ff>j zrGB;(?quDto9%|Xc1%0%WqaWsbKY@eNBYkl>8mSeZg^F)51szbORVM$`@G(pC=*q) zvMjVwvc7(zbd?l&l;q60xj0nfaF(P7acCm8vKgjSm6E_d5CY3IGfKq!q>{6 zZ^|wtRVB1ST2;V=z{ZkWi>}Q;=|;dvcf8b-WB+; zs#N8#-u$(RCsk0+f3}?%TMTlyFUGTcWW9+iY^ncQGs%Ed25hX$-)i|S_%4|uzU}hE zm)ILl&4QO4@BUtWBbp>9Dv!$TxYjOkuX~%oYvQNcJ1UaAcC)y|5Tk1s=+#%Y-KqWa z-Bx$kdh4s}wq@3OH#z~C%7_r{w`;Fb=~&;uD*6_Q*GOC^aTDU7j{ZJgUyTOSB2xoh z6lGi<4^FC4A=RKVGYK>YaOGr>CWnL4a^bz;H-joM>W%ZwHYk&FfYrfvAml-YxoI_M z2oD$#e zn^`CYyQhyY(&YDcLs=rRA>J2xk-tHVCt}l(!HVfX4hY!BULWcn?A-E#(uF*!=pjHB z&L>xv%s2~n#{TRu=QA!HSipvTroV@NlvN)5qV_<)#zw9YKR{Q#^I)QK^?9iuJ|=aP zSRUif>HZd)4I?!989cCrR6PtXrZ$;!4RhC-@)Z+XR-a>Ut^O&7!sT5dWmY?ZY=4$`VLgo?y;KJEu`*DU2;qd^bhe=RQx=o ziT|qK(m3)s`a2|Sa$n>%6uyqXIF2*{IA_+dixp^Z%v5!0g}S$i%3GLSkqW2fu`X`! zmEZDdS>}K3wY!YJI=%gWG2KFnVn9aQEPWRZ%0^qM-$sivmNj)7*-O=$Q{0!Fsy5{$ z9?Do8NdE3EU0bWI24sYL`j3m8{6LwRZi?HwfIfZlRDf4;?3m!}Q3zDv(J^thN{Q5E zBJCL_p2T$c2)Y;APz#$$RFH9kfofYNLHd$TGh=YR8Y`6L5z0wcRA%)>rs}a`kswu!(EhXp+_EF4xmp|O&uR%NE5tH z*QJnwU^r)-d31l>Znya*dO4rj_lCIo9ipi`&QuiD-6#T=%~ERjqUf_(oUVF0Q6!5| z6zLz5$v+`+mjsdNhM;|^>6E^Qr=nfubFYJaP4|DgegB5-?O)SZ(HGtVj|LY!8m!Av zgA8F*UmAn6M_L70QjMBQ^7^)lrrXR*oE9|kW!+wVP+Dp_NopS=Z03RJWub$H*D)oq rSnt?*#o>_}8Efx`ht^?BKmLOTtA|9>741%+Ut>Mi;~smB_uT&i_`6)X literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/wheel.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/wheel.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..51594439baf0affeff5c7b8dcccbe5f477553b4f GIT binary patch literal 3236 zcmbVO-*4MS66TVWMA5RFra_bIwFQH=Xw=q}uRrbr!*F^{oi^y5FG$*4tNh^6+Lc6y zBI#Yqu?6|%Y~cEI5B&?`m!kQXh`#lq=)X`DNWWQHvecyaa1yv&&T?mFXTJG{Uo0-V z27Vv8hWHV)ALwEBXXD{RTpWwT( z*<^+FdDz44-1THPj3fR}GIb4>Xd~oj|NhmDuY#+eZe0B=xcSBA=Jm}_AhrJ%sk}of zW`EPbtV1dc1jJ~YoV6`sKdNw3*xS`(vt8pBw~vgr!z;Xsd%X-m+vRoc;(38DAOww~ zqFos^{yKB~(RcSRUAeJFzU>ORKAErIxqnwJ-+TK?bD2c6R7&2u(rmik$?wu7y}C7w zV!nQt-?_hhkJhhfX|{j5YoaIIihiRxi^Kd>G}V09f7p-5cYThiEJsN_y{{{TuhMjlde4k8ExpGXxIdIyNDzYFTAY zR@1WTG3{~myoU8UceKRSlKPBfK}*~jN#j38m+=MOIC9{X`!Rfgu0_6xBrJ`-oSt!2 zhLHm1o`sWDN>QRgNFddii_KZ+by6-`Dj#wbacfs3yRA6dYGwO*KTY2AFSk^bi{&ir zJP3P2wX!H{1yPaALr`{i436MBYgU*}6|hYG9}`lR1WobDB>^7j>=p z0W?H;5cq3x+6iN|?oan^HkXP;tuLSy1yU510m9ao1j@phniM#AN5~p2 z*ARUbrAblO83^*QS5#CMM|s=T$)H6gpU1oMEN!T3BX~_UEqQ^&uV84qr3X|ZI%@Jf zE&YLZI1}gTNxh1}s5F?3Q&ykYR+XKz&annNOMlB{_LI@l{F&zfKwzMAUB#u&VaPQ} z9{~oG_Ct2a0B>vb{!Nh&Wr;8Vt+zSa|o*vsVlpGh6T*hY#+ zE9FspA`cKaqz!JBX(VT7vOU?}G>dBKy?l+d>o99Or^e3zj=J~Av}P}B^veGc-l19I$r5EN{;B0vbm?%QHLU8_Z*1J~-hcOl5`O6DoxbQi z&?_34Uf2txgf!xWspLXV4O4r280CF$kit4X8@fVD;8uGxYx0D_Z-?j@XA-_EYcUpe2Dz%`coA`z|gqzFhPY}IM8kGK~;i?AE8!`XKF>hftT=+ zQPF^qZ{mrlmQq(13^9akVz`D&RWVSNIL7F$60Rq1feZntU=StGt`G|=x;#*lnxcqX zOAE_1)3o&bQ_3!rQC%NPqw~LG@TtlminvM}moT6jPP%^s)X-$3|DF^BGL5jxnXCg; zMEgMd7VxICJd>^x<-fu7|BI~C^fgT#mcoq`zG${nv?aL$zn`M3Y5qT@qv@DbN6*d0 zMDR^~%Yodfmj^-N1_7Ge5FIEe8bPo#4C9lPS`hHG1F?zTRHIX)#ERPOjhi3+ZkNYv3pi>sQ60VsHQe literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/models/candidate.py b/venv/lib/python3.8/site-packages/pip/_internal/models/candidate.py new file mode 100644 index 000000000..1dc1a576e --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/models/candidate.py @@ -0,0 +1,36 @@ +from pip._vendor.packaging.version import parse as parse_version + +from pip._internal.utils.models import KeyBasedCompareMixin +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from pip._vendor.packaging.version import _BaseVersion + from pip._internal.models.link import Link + + +class InstallationCandidate(KeyBasedCompareMixin): + """Represents a potential "candidate" for installation. + """ + + def __init__(self, name, version, link): + # type: (str, str, Link) -> None + self.name = name + self.version = parse_version(version) # type: _BaseVersion + self.link = link + + super(InstallationCandidate, self).__init__( + key=(self.name, self.version, self.link), + defining_class=InstallationCandidate + ) + + def __repr__(self): + # type: () -> str + return "".format( + self.name, self.version, self.link, + ) + + def __str__(self): + # type: () -> str + return '{!r} candidate (version {} at {})'.format( + self.name, self.version, self.link, + ) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/models/format_control.py b/venv/lib/python3.8/site-packages/pip/_internal/models/format_control.py new file mode 100644 index 000000000..2e13727ca --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/models/format_control.py @@ -0,0 +1,84 @@ +# The following comment should be removed at some point in the future. +# mypy: strict-optional=False + +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.exceptions import CommandError +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import Optional, Set, FrozenSet + + +class FormatControl(object): + """Helper for managing formats from which a package can be installed. + """ + + def __init__(self, no_binary=None, only_binary=None): + # type: (Optional[Set[str]], Optional[Set[str]]) -> None + if no_binary is None: + no_binary = set() + if only_binary is None: + only_binary = set() + + self.no_binary = no_binary + self.only_binary = only_binary + + def __eq__(self, other): + # type: (object) -> bool + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + # type: (object) -> bool + return not self.__eq__(other) + + def __repr__(self): + # type: () -> str + return "{}({}, {})".format( + self.__class__.__name__, + self.no_binary, + self.only_binary + ) + + @staticmethod + def handle_mutual_excludes(value, target, other): + # type: (str, Optional[Set[str]], Optional[Set[str]]) -> None + if value.startswith('-'): + raise CommandError( + "--no-binary / --only-binary option requires 1 argument." + ) + new = value.split(',') + while ':all:' in new: + other.clear() + target.clear() + target.add(':all:') + del new[:new.index(':all:') + 1] + # Without a none, we want to discard everything as :all: covers it + if ':none:' not in new: + return + for name in new: + if name == ':none:': + target.clear() + continue + name = canonicalize_name(name) + other.discard(name) + target.add(name) + + def get_allowed_formats(self, canonical_name): + # type: (str) -> FrozenSet[str] + result = {"binary", "source"} + if canonical_name in self.only_binary: + result.discard('source') + elif canonical_name in self.no_binary: + result.discard('binary') + elif ':all:' in self.only_binary: + result.discard('source') + elif ':all:' in self.no_binary: + result.discard('binary') + return frozenset(result) + + def disallow_binaries(self): + # type: () -> None + self.handle_mutual_excludes( + ':all:', self.no_binary, self.only_binary, + ) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/models/index.py b/venv/lib/python3.8/site-packages/pip/_internal/models/index.py new file mode 100644 index 000000000..ead1efbda --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/models/index.py @@ -0,0 +1,31 @@ +from pip._vendor.six.moves.urllib import parse as urllib_parse + + +class PackageIndex(object): + """Represents a Package Index and provides easier access to endpoints + """ + + def __init__(self, url, file_storage_domain): + # type: (str, str) -> None + super(PackageIndex, self).__init__() + self.url = url + self.netloc = urllib_parse.urlsplit(url).netloc + self.simple_url = self._url_for_path('simple') + self.pypi_url = self._url_for_path('pypi') + + # This is part of a temporary hack used to block installs of PyPI + # packages which depend on external urls only necessary until PyPI can + # block such packages themselves + self.file_storage_domain = file_storage_domain + + def _url_for_path(self, path): + # type: (str) -> str + return urllib_parse.urljoin(self.url, path) + + +PyPI = PackageIndex( + 'https://pypi.org/', file_storage_domain='files.pythonhosted.org' +) +TestPyPI = PackageIndex( + 'https://test.pypi.org/', file_storage_domain='test-files.pythonhosted.org' +) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/models/link.py b/venv/lib/python3.8/site-packages/pip/_internal/models/link.py new file mode 100644 index 000000000..34fbcbfe7 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/models/link.py @@ -0,0 +1,227 @@ +import os +import posixpath +import re + +from pip._vendor.six.moves.urllib import parse as urllib_parse + +from pip._internal.utils.filetypes import WHEEL_EXTENSION +from pip._internal.utils.misc import ( + redact_auth_from_url, + split_auth_from_netloc, + splitext, +) +from pip._internal.utils.models import KeyBasedCompareMixin +from pip._internal.utils.typing import MYPY_CHECK_RUNNING +from pip._internal.utils.urls import path_to_url, url_to_path + +if MYPY_CHECK_RUNNING: + from typing import Optional, Text, Tuple, Union + from pip._internal.index.collector import HTMLPage + from pip._internal.utils.hashes import Hashes + + +class Link(KeyBasedCompareMixin): + """Represents a parsed link from a Package Index's simple URL + """ + + def __init__( + self, + url, # type: str + comes_from=None, # type: Optional[Union[str, HTMLPage]] + requires_python=None, # type: Optional[str] + yanked_reason=None, # type: Optional[Text] + ): + # type: (...) -> None + """ + :param url: url of the resource pointed to (href of the link) + :param comes_from: instance of HTMLPage where the link was found, + or string. + :param requires_python: String containing the `Requires-Python` + metadata field, specified in PEP 345. This may be specified by + a data-requires-python attribute in the HTML link tag, as + described in PEP 503. + :param yanked_reason: the reason the file has been yanked, if the + file has been yanked, or None if the file hasn't been yanked. + This is the value of the "data-yanked" attribute, if present, in + a simple repository HTML link. If the file has been yanked but + no reason was provided, this should be the empty string. See + PEP 592 for more information and the specification. + """ + + # url can be a UNC windows share + if url.startswith('\\\\'): + url = path_to_url(url) + + self._parsed_url = urllib_parse.urlsplit(url) + # Store the url as a private attribute to prevent accidentally + # trying to set a new value. + self._url = url + + self.comes_from = comes_from + self.requires_python = requires_python if requires_python else None + self.yanked_reason = yanked_reason + + super(Link, self).__init__(key=url, defining_class=Link) + + def __str__(self): + # type: () -> str + if self.requires_python: + rp = ' (requires-python:%s)' % self.requires_python + else: + rp = '' + if self.comes_from: + return '%s (from %s)%s' % (redact_auth_from_url(self._url), + self.comes_from, rp) + else: + return redact_auth_from_url(str(self._url)) + + def __repr__(self): + # type: () -> str + return '' % self + + @property + def url(self): + # type: () -> str + return self._url + + @property + def filename(self): + # type: () -> str + path = self.path.rstrip('/') + name = posixpath.basename(path) + if not name: + # Make sure we don't leak auth information if the netloc + # includes a username and password. + netloc, user_pass = split_auth_from_netloc(self.netloc) + return netloc + + name = urllib_parse.unquote(name) + assert name, ('URL %r produced no filename' % self._url) + return name + + @property + def file_path(self): + # type: () -> str + return url_to_path(self.url) + + @property + def scheme(self): + # type: () -> str + return self._parsed_url.scheme + + @property + def netloc(self): + # type: () -> str + """ + This can contain auth information. + """ + return self._parsed_url.netloc + + @property + def path(self): + # type: () -> str + return urllib_parse.unquote(self._parsed_url.path) + + def splitext(self): + # type: () -> Tuple[str, str] + return splitext(posixpath.basename(self.path.rstrip('/'))) + + @property + def ext(self): + # type: () -> str + return self.splitext()[1] + + @property + def url_without_fragment(self): + # type: () -> str + scheme, netloc, path, query, fragment = self._parsed_url + return urllib_parse.urlunsplit((scheme, netloc, path, query, None)) + + _egg_fragment_re = re.compile(r'[#&]egg=([^&]*)') + + @property + def egg_fragment(self): + # type: () -> Optional[str] + match = self._egg_fragment_re.search(self._url) + if not match: + return None + return match.group(1) + + _subdirectory_fragment_re = re.compile(r'[#&]subdirectory=([^&]*)') + + @property + def subdirectory_fragment(self): + # type: () -> Optional[str] + match = self._subdirectory_fragment_re.search(self._url) + if not match: + return None + return match.group(1) + + _hash_re = re.compile( + r'(sha1|sha224|sha384|sha256|sha512|md5)=([a-f0-9]+)' + ) + + @property + def hash(self): + # type: () -> Optional[str] + match = self._hash_re.search(self._url) + if match: + return match.group(2) + return None + + @property + def hash_name(self): + # type: () -> Optional[str] + match = self._hash_re.search(self._url) + if match: + return match.group(1) + return None + + @property + def show_url(self): + # type: () -> str + return posixpath.basename(self._url.split('#', 1)[0].split('?', 1)[0]) + + @property + def is_file(self): + # type: () -> bool + return self.scheme == 'file' + + def is_existing_dir(self): + # type: () -> bool + return self.is_file and os.path.isdir(self.file_path) + + @property + def is_wheel(self): + # type: () -> bool + return self.ext == WHEEL_EXTENSION + + @property + def is_vcs(self): + # type: () -> bool + from pip._internal.vcs import vcs + + return self.scheme in vcs.all_schemes + + @property + def is_yanked(self): + # type: () -> bool + return self.yanked_reason is not None + + @property + def has_hash(self): + # type: () -> bool + return self.hash_name is not None + + def is_hash_allowed(self, hashes): + # type: (Optional[Hashes]) -> bool + """ + Return True if the link has a hash and it is allowed. + """ + if hashes is None or not self.has_hash: + return False + # Assert non-None so mypy knows self.hash_name and self.hash are str. + assert self.hash_name is not None + assert self.hash is not None + + return hashes.is_hash_allowed(self.hash_name, hex_digest=self.hash) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/models/scheme.py b/venv/lib/python3.8/site-packages/pip/_internal/models/scheme.py new file mode 100644 index 000000000..af07b4078 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/models/scheme.py @@ -0,0 +1,25 @@ +""" +For types associated with installation schemes. + +For a general overview of available schemes and their context, see +https://docs.python.org/3/install/index.html#alternate-installation. +""" + + +class Scheme(object): + """A Scheme holds paths which are used as the base directories for + artifacts associated with a Python package. + """ + def __init__( + self, + platlib, # type: str + purelib, # type: str + headers, # type: str + scripts, # type: str + data, # type: str + ): + self.platlib = platlib + self.purelib = purelib + self.headers = headers + self.scripts = scripts + self.data = data diff --git a/venv/lib/python3.8/site-packages/pip/_internal/models/search_scope.py b/venv/lib/python3.8/site-packages/pip/_internal/models/search_scope.py new file mode 100644 index 000000000..138d1b6ee --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/models/search_scope.py @@ -0,0 +1,114 @@ +import itertools +import logging +import os +import posixpath + +from pip._vendor.packaging.utils import canonicalize_name +from pip._vendor.six.moves.urllib import parse as urllib_parse + +from pip._internal.models.index import PyPI +from pip._internal.utils.compat import has_tls +from pip._internal.utils.misc import normalize_path, redact_auth_from_url +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import List + + +logger = logging.getLogger(__name__) + + +class SearchScope(object): + + """ + Encapsulates the locations that pip is configured to search. + """ + + @classmethod + def create( + cls, + find_links, # type: List[str] + index_urls, # type: List[str] + ): + # type: (...) -> SearchScope + """ + Create a SearchScope object after normalizing the `find_links`. + """ + # Build find_links. If an argument starts with ~, it may be + # a local file relative to a home directory. So try normalizing + # it and if it exists, use the normalized version. + # This is deliberately conservative - it might be fine just to + # blindly normalize anything starting with a ~... + built_find_links = [] # type: List[str] + for link in find_links: + if link.startswith('~'): + new_link = normalize_path(link) + if os.path.exists(new_link): + link = new_link + built_find_links.append(link) + + # If we don't have TLS enabled, then WARN if anyplace we're looking + # relies on TLS. + if not has_tls(): + for link in itertools.chain(index_urls, built_find_links): + parsed = urllib_parse.urlparse(link) + if parsed.scheme == 'https': + logger.warning( + 'pip is configured with locations that require ' + 'TLS/SSL, however the ssl module in Python is not ' + 'available.' + ) + break + + return cls( + find_links=built_find_links, + index_urls=index_urls, + ) + + def __init__( + self, + find_links, # type: List[str] + index_urls, # type: List[str] + ): + # type: (...) -> None + self.find_links = find_links + self.index_urls = index_urls + + def get_formatted_locations(self): + # type: () -> str + lines = [] + if self.index_urls and self.index_urls != [PyPI.simple_url]: + lines.append( + 'Looking in indexes: {}'.format(', '.join( + redact_auth_from_url(url) for url in self.index_urls)) + ) + if self.find_links: + lines.append( + 'Looking in links: {}'.format(', '.join( + redact_auth_from_url(url) for url in self.find_links)) + ) + return '\n'.join(lines) + + def get_index_urls_locations(self, project_name): + # type: (str) -> List[str] + """Returns the locations found via self.index_urls + + Checks the url_name on the main (first in the list) index and + use this url_name to produce all locations + """ + + def mkurl_pypi_url(url): + # type: (str) -> str + loc = posixpath.join( + url, + urllib_parse.quote(canonicalize_name(project_name))) + # For maximum compatibility with easy_install, ensure the path + # ends in a trailing slash. Although this isn't in the spec + # (and PyPI can handle it without the slash) some other index + # implementations might break if they relied on easy_install's + # behavior. + if not loc.endswith('/'): + loc = loc + '/' + return loc + + return [mkurl_pypi_url(url) for url in self.index_urls] diff --git a/venv/lib/python3.8/site-packages/pip/_internal/models/selection_prefs.py b/venv/lib/python3.8/site-packages/pip/_internal/models/selection_prefs.py new file mode 100644 index 000000000..f58fdce9c --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/models/selection_prefs.py @@ -0,0 +1,47 @@ +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import Optional + from pip._internal.models.format_control import FormatControl + + +class SelectionPreferences(object): + + """ + Encapsulates the candidate selection preferences for downloading + and installing files. + """ + + # Don't include an allow_yanked default value to make sure each call + # site considers whether yanked releases are allowed. This also causes + # that decision to be made explicit in the calling code, which helps + # people when reading the code. + def __init__( + self, + allow_yanked, # type: bool + allow_all_prereleases=False, # type: bool + format_control=None, # type: Optional[FormatControl] + prefer_binary=False, # type: bool + ignore_requires_python=None, # type: Optional[bool] + ): + # type: (...) -> None + """Create a SelectionPreferences object. + + :param allow_yanked: Whether files marked as yanked (in the sense + of PEP 592) are permitted to be candidates for install. + :param format_control: A FormatControl object or None. Used to control + the selection of source packages / binary packages when consulting + the index and links. + :param prefer_binary: Whether to prefer an old, but valid, binary + dist over a new source dist. + :param ignore_requires_python: Whether to ignore incompatible + "Requires-Python" values in links. Defaults to False. + """ + if ignore_requires_python is None: + ignore_requires_python = False + + self.allow_yanked = allow_yanked + self.allow_all_prereleases = allow_all_prereleases + self.format_control = format_control + self.prefer_binary = prefer_binary + self.ignore_requires_python = ignore_requires_python diff --git a/venv/lib/python3.8/site-packages/pip/_internal/models/target_python.py b/venv/lib/python3.8/site-packages/pip/_internal/models/target_python.py new file mode 100644 index 000000000..97ae85a09 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/models/target_python.py @@ -0,0 +1,107 @@ +import sys + +from pip._internal.pep425tags import get_supported, version_info_to_nodot +from pip._internal.utils.misc import normalize_version_info +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import List, Optional, Tuple + + from pip._vendor.packaging.tags import Tag + + +class TargetPython(object): + + """ + Encapsulates the properties of a Python interpreter one is targeting + for a package install, download, etc. + """ + + def __init__( + self, + platform=None, # type: Optional[str] + py_version_info=None, # type: Optional[Tuple[int, ...]] + abi=None, # type: Optional[str] + implementation=None, # type: Optional[str] + ): + # type: (...) -> None + """ + :param platform: A string or None. If None, searches for packages + that are supported by the current system. Otherwise, will find + packages that can be built on the platform passed in. These + packages will only be downloaded for distribution: they will + not be built locally. + :param py_version_info: An optional tuple of ints representing the + Python version information to use (e.g. `sys.version_info[:3]`). + This can have length 1, 2, or 3 when provided. + :param abi: A string or None. This is passed to pep425tags.py's + get_supported() function as is. + :param implementation: A string or None. This is passed to + pep425tags.py's get_supported() function as is. + """ + # Store the given py_version_info for when we call get_supported(). + self._given_py_version_info = py_version_info + + if py_version_info is None: + py_version_info = sys.version_info[:3] + else: + py_version_info = normalize_version_info(py_version_info) + + py_version = '.'.join(map(str, py_version_info[:2])) + + self.abi = abi + self.implementation = implementation + self.platform = platform + self.py_version = py_version + self.py_version_info = py_version_info + + # This is used to cache the return value of get_tags(). + self._valid_tags = None # type: Optional[List[Tag]] + + def format_given(self): + # type: () -> str + """ + Format the given, non-None attributes for display. + """ + display_version = None + if self._given_py_version_info is not None: + display_version = '.'.join( + str(part) for part in self._given_py_version_info + ) + + key_values = [ + ('platform', self.platform), + ('version_info', display_version), + ('abi', self.abi), + ('implementation', self.implementation), + ] + return ' '.join( + '{}={!r}'.format(key, value) for key, value in key_values + if value is not None + ) + + def get_tags(self): + # type: () -> List[Tag] + """ + Return the supported PEP 425 tags to check wheel candidates against. + + The tags are returned in order of preference (most preferred first). + """ + if self._valid_tags is None: + # Pass versions=None if no py_version_info was given since + # versions=None uses special default logic. + py_version_info = self._given_py_version_info + if py_version_info is None: + version = None + else: + version = version_info_to_nodot(py_version_info) + + tags = get_supported( + version=version, + platform=self.platform, + abi=self.abi, + impl=self.implementation, + ) + self._valid_tags = tags + + return self._valid_tags diff --git a/venv/lib/python3.8/site-packages/pip/_internal/models/wheel.py b/venv/lib/python3.8/site-packages/pip/_internal/models/wheel.py new file mode 100644 index 000000000..34d8c2ec3 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/models/wheel.py @@ -0,0 +1,78 @@ +"""Represents a wheel file and provides access to the various parts of the +name that have meaning. +""" +import re + +from pip._vendor.packaging.tags import Tag + +from pip._internal.exceptions import InvalidWheelFilename +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import List + + +class Wheel(object): + """A wheel file""" + + wheel_file_re = re.compile( + r"""^(?P(?P[^\s-]+?)-(?P[^\s-]*?)) + ((-(?P\d[^-]*?))?-(?P[^\s-]+?)-(?P[^\s-]+?)-(?P[^\s-]+?) + \.whl|\.dist-info)$""", + re.VERBOSE + ) + + def __init__(self, filename): + # type: (str) -> None + """ + :raises InvalidWheelFilename: when the filename is invalid for a wheel + """ + wheel_info = self.wheel_file_re.match(filename) + if not wheel_info: + raise InvalidWheelFilename( + "%s is not a valid wheel filename." % filename + ) + self.filename = filename + self.name = wheel_info.group('name').replace('_', '-') + # we'll assume "_" means "-" due to wheel naming scheme + # (https://github.com/pypa/pip/issues/1150) + self.version = wheel_info.group('ver').replace('_', '-') + self.build_tag = wheel_info.group('build') + self.pyversions = wheel_info.group('pyver').split('.') + self.abis = wheel_info.group('abi').split('.') + self.plats = wheel_info.group('plat').split('.') + + # All the tag combinations from this file + self.file_tags = { + Tag(x, y, z) for x in self.pyversions + for y in self.abis for z in self.plats + } + + def get_formatted_file_tags(self): + # type: () -> List[str] + """Return the wheel's tags as a sorted list of strings.""" + return sorted(str(tag) for tag in self.file_tags) + + def support_index_min(self, tags): + # type: (List[Tag]) -> int + """Return the lowest index that one of the wheel's file_tag combinations + achieves in the given list of supported tags. + + For example, if there are 8 supported tags and one of the file tags + is first in the list, then return 0. + + :param tags: the PEP 425 tags to check the wheel against, in order + with most preferred first. + + :raises ValueError: If none of the wheel's file tags match one of + the supported tags. + """ + return min(tags.index(tag) for tag in self.file_tags if tag in tags) + + def supported(self, tags): + # type: (List[Tag]) -> bool + """Return whether the wheel is compatible with one of the given tags. + + :param tags: the PEP 425 tags to check the wheel against. + """ + return not self.file_tags.isdisjoint(tags) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/network/__init__.py b/venv/lib/python3.8/site-packages/pip/_internal/network/__init__.py new file mode 100644 index 000000000..b51bde91b --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/network/__init__.py @@ -0,0 +1,2 @@ +"""Contains purely network-related utilities. +""" diff --git a/venv/lib/python3.8/site-packages/pip/_internal/network/__pycache__/__init__.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/network/__pycache__/__init__.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..752c86e31c10ddbf9b08264273832bbeb88531ed GIT binary patch literal 241 zcmYk1u}TC%42EZ~@mRQb*!GayfHoE)qP>mS*o1K>cwy%z!%TK%eIsA#S|7pA%A8pE z!~cgbMfmfy*|g4d*E+he`FVo>Y7B18b!`#cvkT3m+pgZv?AOqruD=WM78{Y_fIS>?)?DGh79V8G`odP9=nbHiAUm!2K vmvq@*L1m>~_QU93sY2!q$VsUrAK|Y6psiRD`@9_2*9Qqxq?^+lUuO3M-PA>e literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/network/__pycache__/auth.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/network/__pycache__/auth.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0616fd91449c29e55a24ab353313770caf7a4f18 GIT binary patch literal 7007 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 literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/network/__pycache__/cache.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/network/__pycache__/cache.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1b9dd3c85362127639bd5367fa88aa1586cb2ef5 GIT binary patch literal 2720 zcmaJ@TW=dh6rS0Oz1}#9lZNyLbg2+vF1EN-ssuu9quzw-mZYWa3Td_38ONLKtuy0< zSk4O$>Kpw72qogFe`#NN>R;fAbH+~Mq==RF?3tM}k@cwxrF;QLjK0V z^kc!`2E6hQ5RCYQQD!96r|>lsBQ<@K;+&OOsqNcZx06a*^{ZO1Bu-lMYg(@+ZaU-7 zq;cjDxD;H+|4d^luyXJA$`8TnlTPP;=Pt}T4-51qOd^WTOdiycs7dCJ=&&x^3wYH!OZXS^*{pMl@)ZJuqn zlX$&d?5bX#ecig=ma*br6k)UlRLFJ_7wsShb_6)t&bZpi#a3JYa;w-aXJZ+h__B=t z8X$-v8XzN7rys~BJt;o{W#BUU6QSfO$u3v`QPHlk<%+8m<|uhiGUFM52EfK(`+nEk z;Sk2`W95ZW#HI8UL{$5MS~gksHv3X}aw{(MTAXcoVaB{dqpGzgZPe59j&Vl|GFD6>RBX5A<1S*O62BW_Dl60ZAn7Qxx7PFWQS#PrntHQU!99DyG zmAPyNzRpX?8NUX6)yvtnu*;9LcCe$--1IO*y>-ZJHeqh37e_rWmYxKAPvu@;a*sn& zcss}`QmjG&+2uhJ^GM}l*Gt1)eO#6+Z=Fw~5d&#nF1#HPD1_S ze+VeIYOh8mvc9P ze}VNhj+hNWfiNt=50*{``ut!rp((DP)^ROY6& zX%ER}rAvqApT_TF=x=P;+pG#atE})0%eSXp`J9%mXx(-Ifa(#pb= z`;}fOdz_Va5eg;GChdFxk)5O~9`hA!9K*C-x=aV}oq>7U`Yp6GuzdxOSOqa82M|Jy zmX64)>y&8JbY#4`x@Qhe4DwURiEHFXvP%9srLXC^XD~Njg*GteqBO)h0Q?Zn*L74{ zdBL;N5YUvCt#E_v^HyCVNA~=#MiXbbWh+3 zY#ibW3J*kCh0MjU3QWb)##-Z|ipy6)G;JMufvvT)x5K2*^)}H&3%mF{Z2Wkv8b-{wv8 z#Qm|~XI!o@o^ZtpVc^Nx^28^xC(%GpUvha?y&g#i51Blkq?x+y0gRH5MEd{nxVEE#S5lm>XqfGQhIY ve*|>3YCfhCQS+#8Pv^UFfWF5+KJr}IYS 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 literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/network/auth.py b/venv/lib/python3.8/site-packages/pip/_internal/network/auth.py new file mode 100644 index 000000000..1e1da54ca --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/network/auth.py @@ -0,0 +1,298 @@ +"""Network Authentication Helpers + +Contains interface (MultiDomainBasicAuth) and associated glue code for +providing credentials in the context of network requests. +""" + +# The following comment should be removed at some point in the future. +# mypy: disallow-untyped-defs=False + +import logging + +from pip._vendor.requests.auth import AuthBase, HTTPBasicAuth +from pip._vendor.requests.utils import get_netrc_auth +from pip._vendor.six.moves.urllib import parse as urllib_parse + +from pip._internal.utils.misc import ( + ask, + ask_input, + ask_password, + remove_auth_from_url, + split_auth_netloc_from_url, +) +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from optparse import Values + from typing import Dict, Optional, Tuple + + from pip._internal.vcs.versioncontrol import AuthInfo + + Credentials = Tuple[str, str, str] + +logger = logging.getLogger(__name__) + +try: + import keyring # noqa +except ImportError: + keyring = None +except Exception as exc: + logger.warning( + "Keyring is skipped due to an exception: %s", str(exc), + ) + keyring = None + + +def get_keyring_auth(url, username): + """Return the tuple auth for a given url from keyring.""" + if not url or not keyring: + return None + + try: + try: + get_credential = keyring.get_credential + except AttributeError: + pass + else: + logger.debug("Getting credentials from keyring for %s", url) + cred = get_credential(url, username) + if cred is not None: + return cred.username, cred.password + return None + + if username: + logger.debug("Getting password from keyring for %s", url) + password = keyring.get_password(url, username) + if password: + return username, password + + except Exception as exc: + logger.warning( + "Keyring is skipped due to an exception: %s", str(exc), + ) + + +class MultiDomainBasicAuth(AuthBase): + + def __init__(self, prompting=True, index_urls=None): + # type: (bool, Optional[Values]) -> None + self.prompting = prompting + self.index_urls = index_urls + self.passwords = {} # type: Dict[str, AuthInfo] + # When the user is prompted to enter credentials and keyring is + # available, we will offer to save them. If the user accepts, + # this value is set to the credentials they entered. After the + # request authenticates, the caller should call + # ``save_credentials`` to save these. + self._credentials_to_save = None # type: Optional[Credentials] + + def _get_index_url(self, url): + """Return the original index URL matching the requested URL. + + Cached or dynamically generated credentials may work against + the original index URL rather than just the netloc. + + The provided url should have had its username and password + removed already. If the original index url had credentials then + they will be included in the return value. + + Returns None if no matching index was found, or if --no-index + was specified by the user. + """ + if not url or not self.index_urls: + return None + + for u in self.index_urls: + prefix = remove_auth_from_url(u).rstrip("/") + "/" + if url.startswith(prefix): + return u + + def _get_new_credentials(self, original_url, allow_netrc=True, + allow_keyring=True): + """Find and return credentials for the specified URL.""" + # Split the credentials and netloc from the url. + url, netloc, url_user_password = split_auth_netloc_from_url( + original_url, + ) + + # Start with the credentials embedded in the url + username, password = url_user_password + if username is not None and password is not None: + logger.debug("Found credentials in url for %s", netloc) + return url_user_password + + # Find a matching index url for this request + index_url = self._get_index_url(url) + if index_url: + # Split the credentials from the url. + index_info = split_auth_netloc_from_url(index_url) + if index_info: + index_url, _, index_url_user_password = index_info + logger.debug("Found index url %s", index_url) + + # If an index URL was found, try its embedded credentials + if index_url and index_url_user_password[0] is not None: + username, password = index_url_user_password + if username is not None and password is not None: + logger.debug("Found credentials in index url for %s", netloc) + return index_url_user_password + + # Get creds from netrc if we still don't have them + if allow_netrc: + netrc_auth = get_netrc_auth(original_url) + if netrc_auth: + logger.debug("Found credentials in netrc for %s", netloc) + return netrc_auth + + # If we don't have a password and keyring is available, use it. + if allow_keyring: + # The index url is more specific than the netloc, so try it first + kr_auth = ( + get_keyring_auth(index_url, username) or + get_keyring_auth(netloc, username) + ) + if kr_auth: + logger.debug("Found credentials in keyring for %s", netloc) + return kr_auth + + return username, password + + def _get_url_and_credentials(self, original_url): + """Return the credentials to use for the provided URL. + + If allowed, netrc and keyring may be used to obtain the + correct credentials. + + Returns (url_without_credentials, username, password). Note + that even if the original URL contains credentials, this + function may return a different username and password. + """ + url, netloc, _ = split_auth_netloc_from_url(original_url) + + # Use any stored credentials that we have for this netloc + username, password = self.passwords.get(netloc, (None, None)) + + if username is None and password is None: + # No stored credentials. Acquire new credentials without prompting + # the user. (e.g. from netrc, keyring, or the URL itself) + username, password = self._get_new_credentials(original_url) + + if username is not None or password is not None: + # Convert the username and password if they're None, so that + # this netloc will show up as "cached" in the conditional above. + # Further, HTTPBasicAuth doesn't accept None, so it makes sense to + # cache the value that is going to be used. + username = username or "" + password = password or "" + + # Store any acquired credentials. + self.passwords[netloc] = (username, password) + + assert ( + # Credentials were found + (username is not None and password is not None) or + # Credentials were not found + (username is None and password is None) + ), "Could not load credentials from url: {}".format(original_url) + + return url, username, password + + def __call__(self, req): + # Get credentials for this request + url, username, password = self._get_url_and_credentials(req.url) + + # Set the url of the request to the url without any credentials + req.url = url + + if username is not None and password is not None: + # Send the basic auth with this request + req = HTTPBasicAuth(username, password)(req) + + # Attach a hook to handle 401 responses + req.register_hook("response", self.handle_401) + + return req + + # Factored out to allow for easy patching in tests + def _prompt_for_password(self, netloc): + username = ask_input("User for %s: " % netloc) + if not username: + return None, None + auth = get_keyring_auth(netloc, username) + if auth: + return auth[0], auth[1], False + password = ask_password("Password: ") + return username, password, True + + # Factored out to allow for easy patching in tests + def _should_save_password_to_keyring(self): + if not keyring: + return False + return ask("Save credentials to keyring [y/N]: ", ["y", "n"]) == "y" + + def handle_401(self, resp, **kwargs): + # We only care about 401 responses, anything else we want to just + # pass through the actual response + if resp.status_code != 401: + return resp + + # We are not able to prompt the user so simply return the response + if not self.prompting: + return resp + + parsed = urllib_parse.urlparse(resp.url) + + # Prompt the user for a new username and password + username, password, save = self._prompt_for_password(parsed.netloc) + + # Store the new username and password to use for future requests + self._credentials_to_save = None + if username is not None and password is not None: + self.passwords[parsed.netloc] = (username, password) + + # Prompt to save the password to keyring + if save and self._should_save_password_to_keyring(): + self._credentials_to_save = (parsed.netloc, username, password) + + # Consume content and release the original connection to allow our new + # request to reuse the same one. + resp.content + resp.raw.release_conn() + + # Add our new username and password to the request + req = HTTPBasicAuth(username or "", password or "")(resp.request) + req.register_hook("response", self.warn_on_401) + + # On successful request, save the credentials that were used to + # keyring. (Note that if the user responded "no" above, this member + # is not set and nothing will be saved.) + if self._credentials_to_save: + req.register_hook("response", self.save_credentials) + + # Send our new request + new_resp = resp.connection.send(req, **kwargs) + new_resp.history.append(resp) + + return new_resp + + def warn_on_401(self, resp, **kwargs): + """Response callback to warn about incorrect credentials.""" + if resp.status_code == 401: + logger.warning( + '401 Error, Credentials not correct for %s', resp.request.url, + ) + + def save_credentials(self, resp, **kwargs): + """Response callback to save credentials on success.""" + assert keyring is not None, "should never reach here without keyring" + if not keyring: + return + + creds = self._credentials_to_save + self._credentials_to_save = None + if creds and resp.status_code < 400: + try: + logger.info('Saving credentials to keyring') + keyring.set_password(*creds) + except Exception: + logger.exception('Failed to save credentials') diff --git a/venv/lib/python3.8/site-packages/pip/_internal/network/cache.py b/venv/lib/python3.8/site-packages/pip/_internal/network/cache.py new file mode 100644 index 000000000..c9386e173 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/network/cache.py @@ -0,0 +1,81 @@ +"""HTTP cache implementation. +""" + +# The following comment should be removed at some point in the future. +# mypy: disallow-untyped-defs=False + +import os +from contextlib import contextmanager + +from pip._vendor.cachecontrol.cache import BaseCache +from pip._vendor.cachecontrol.caches import FileCache +from pip._vendor.requests.models import Response + +from pip._internal.utils.filesystem import adjacent_tmp_file, replace +from pip._internal.utils.misc import ensure_dir +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import Optional + + +def is_from_cache(response): + # type: (Response) -> bool + return getattr(response, "from_cache", False) + + +@contextmanager +def suppressed_cache_errors(): + """If we can't access the cache then we can just skip caching and process + requests as if caching wasn't enabled. + """ + try: + yield + except (OSError, IOError): + pass + + +class SafeFileCache(BaseCache): + """ + A file based cache which is safe to use even when the target directory may + not be accessible or writable. + """ + + def __init__(self, directory): + # type: (str) -> None + assert directory is not None, "Cache directory must not be None." + super(SafeFileCache, self).__init__() + self.directory = directory + + def _get_cache_path(self, name): + # type: (str) -> str + # From cachecontrol.caches.file_cache.FileCache._fn, brought into our + # class for backwards-compatibility and to avoid using a non-public + # method. + hashed = FileCache.encode(name) + parts = list(hashed[:5]) + [hashed] + return os.path.join(self.directory, *parts) + + def get(self, key): + # type: (str) -> Optional[bytes] + path = self._get_cache_path(key) + with suppressed_cache_errors(): + with open(path, 'rb') as f: + return f.read() + + def set(self, key, value): + # type: (str, bytes) -> None + path = self._get_cache_path(key) + with suppressed_cache_errors(): + ensure_dir(os.path.dirname(path)) + + with adjacent_tmp_file(path) as f: + f.write(value) + + replace(f.name, path) + + def delete(self, key): + # type: (str) -> None + path = self._get_cache_path(key) + with suppressed_cache_errors(): + os.remove(path) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/network/download.py b/venv/lib/python3.8/site-packages/pip/_internal/network/download.py new file mode 100644 index 000000000..c90c4bf42 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/network/download.py @@ -0,0 +1,200 @@ +"""Download files with progress indicators. +""" +import cgi +import logging +import mimetypes +import os + +from pip._vendor import requests +from pip._vendor.requests.models import CONTENT_CHUNK_SIZE + +from pip._internal.models.index import PyPI +from pip._internal.network.cache import is_from_cache +from pip._internal.network.utils import response_chunks +from pip._internal.utils.misc import ( + format_size, + redact_auth_from_url, + splitext, +) +from pip._internal.utils.typing import MYPY_CHECK_RUNNING +from pip._internal.utils.ui import DownloadProgressProvider + +if MYPY_CHECK_RUNNING: + from typing import Iterable, Optional + + from pip._vendor.requests.models import Response + + from pip._internal.models.link import Link + from pip._internal.network.session import PipSession + +logger = logging.getLogger(__name__) + + +def _get_http_response_size(resp): + # type: (Response) -> Optional[int] + try: + return int(resp.headers['content-length']) + except (ValueError, KeyError, TypeError): + return None + + +def _prepare_download( + resp, # type: Response + link, # type: Link + progress_bar # type: str +): + # type: (...) -> Iterable[bytes] + total_length = _get_http_response_size(resp) + + if link.netloc == PyPI.file_storage_domain: + url = link.show_url + else: + url = link.url_without_fragment + + logged_url = redact_auth_from_url(url) + + if total_length: + logged_url = '{} ({})'.format(logged_url, format_size(total_length)) + + if is_from_cache(resp): + logger.info("Using cached %s", logged_url) + else: + logger.info("Downloading %s", logged_url) + + if logger.getEffectiveLevel() > logging.INFO: + show_progress = False + elif is_from_cache(resp): + show_progress = False + elif not total_length: + show_progress = True + elif total_length > (40 * 1000): + show_progress = True + else: + show_progress = False + + chunks = response_chunks(resp, CONTENT_CHUNK_SIZE) + + if not show_progress: + return chunks + + return DownloadProgressProvider( + progress_bar, max=total_length + )(chunks) + + +def sanitize_content_filename(filename): + # type: (str) -> str + """ + Sanitize the "filename" value from a Content-Disposition header. + """ + return os.path.basename(filename) + + +def parse_content_disposition(content_disposition, default_filename): + # type: (str, str) -> str + """ + Parse the "filename" value from a Content-Disposition header, and + return the default filename if the result is empty. + """ + _type, params = cgi.parse_header(content_disposition) + filename = params.get('filename') + if filename: + # We need to sanitize the filename to prevent directory traversal + # in case the filename contains ".." path parts. + filename = sanitize_content_filename(filename) + return filename or default_filename + + +def _get_http_response_filename(resp, link): + # type: (Response, Link) -> str + """Get an ideal filename from the given HTTP response, falling back to + the link filename if not provided. + """ + filename = link.filename # fallback + # Have a look at the Content-Disposition header for a better guess + content_disposition = resp.headers.get('content-disposition') + if content_disposition: + filename = parse_content_disposition(content_disposition, filename) + ext = splitext(filename)[1] # type: Optional[str] + if not ext: + ext = mimetypes.guess_extension( + resp.headers.get('content-type', '') + ) + if ext: + filename += ext + if not ext and link.url != resp.url: + ext = os.path.splitext(resp.url)[1] + if ext: + filename += ext + return filename + + +def _http_get_download(session, link): + # type: (PipSession, Link) -> Response + target_url = link.url.split('#', 1)[0] + resp = session.get( + target_url, + # We use Accept-Encoding: identity here because requests + # defaults to accepting compressed responses. This breaks in + # a variety of ways depending on how the server is configured. + # - Some servers will notice that the file isn't a compressible + # file and will leave the file alone and with an empty + # Content-Encoding + # - Some servers will notice that the file is already + # compressed and will leave the file alone and will add a + # Content-Encoding: gzip header + # - Some servers won't notice anything at all and will take + # a file that's already been compressed and compress it again + # and set the Content-Encoding: gzip header + # By setting this to request only the identity encoding We're + # hoping to eliminate the third case. Hopefully there does not + # exist a server which when given a file will notice it is + # already compressed and that you're not asking for a + # compressed file and will then decompress it before sending + # because if that's the case I don't think it'll ever be + # possible to make this work. + headers={"Accept-Encoding": "identity"}, + stream=True, + ) + resp.raise_for_status() + return resp + + +class Download(object): + def __init__( + self, + response, # type: Response + filename, # type: str + chunks, # type: Iterable[bytes] + ): + # type: (...) -> None + self.response = response + self.filename = filename + self.chunks = chunks + + +class Downloader(object): + def __init__( + self, + session, # type: PipSession + progress_bar, # type: str + ): + # type: (...) -> None + self._session = session + self._progress_bar = progress_bar + + def __call__(self, link): + # type: (Link) -> Download + try: + resp = _http_get_download(self._session, link) + except requests.HTTPError as e: + logger.critical( + "HTTP error %s while getting %s", e.response.status_code, link + ) + raise + + return Download( + resp, + _get_http_response_filename(resp, link), + _prepare_download(resp, link, self._progress_bar), + ) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/network/session.py b/venv/lib/python3.8/site-packages/pip/_internal/network/session.py new file mode 100644 index 000000000..f5eb15ef2 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/network/session.py @@ -0,0 +1,405 @@ +"""PipSession and supporting code, containing all pip-specific +network request configuration and behavior. +""" + +# The following comment should be removed at some point in the future. +# mypy: disallow-untyped-defs=False + +import email.utils +import json +import logging +import mimetypes +import os +import platform +import sys +import warnings + +from pip._vendor import requests, six, urllib3 +from pip._vendor.cachecontrol import CacheControlAdapter +from pip._vendor.requests.adapters import BaseAdapter, HTTPAdapter +from pip._vendor.requests.models import Response +from pip._vendor.requests.structures import CaseInsensitiveDict +from pip._vendor.six.moves.urllib import parse as urllib_parse +from pip._vendor.urllib3.exceptions import InsecureRequestWarning + +from pip import __version__ +from pip._internal.network.auth import MultiDomainBasicAuth +from pip._internal.network.cache import SafeFileCache +# Import ssl from compat so the initial import occurs in only one place. +from pip._internal.utils.compat import has_tls, ipaddress +from pip._internal.utils.glibc import libc_ver +from pip._internal.utils.misc import ( + build_url_from_netloc, + get_installed_version, + parse_netloc, +) +from pip._internal.utils.typing import MYPY_CHECK_RUNNING +from pip._internal.utils.urls import url_to_path + +if MYPY_CHECK_RUNNING: + from typing import ( + Iterator, List, Optional, Tuple, Union, + ) + + from pip._internal.models.link import Link + + SecureOrigin = Tuple[str, str, Optional[Union[int, str]]] + + +logger = logging.getLogger(__name__) + + +# Ignore warning raised when using --trusted-host. +warnings.filterwarnings("ignore", category=InsecureRequestWarning) + + +SECURE_ORIGINS = [ + # protocol, hostname, port + # Taken from Chrome's list of secure origins (See: http://bit.ly/1qrySKC) + ("https", "*", "*"), + ("*", "localhost", "*"), + ("*", "127.0.0.0/8", "*"), + ("*", "::1/128", "*"), + ("file", "*", None), + # ssh is always secure. + ("ssh", "*", "*"), +] # type: List[SecureOrigin] + + +# These are environment variables present when running under various +# CI systems. For each variable, some CI systems that use the variable +# are indicated. The collection was chosen so that for each of a number +# of popular systems, at least one of the environment variables is used. +# This list is used to provide some indication of and lower bound for +# CI traffic to PyPI. Thus, it is okay if the list is not comprehensive. +# For more background, see: https://github.com/pypa/pip/issues/5499 +CI_ENVIRONMENT_VARIABLES = ( + # Azure Pipelines + 'BUILD_BUILDID', + # Jenkins + 'BUILD_ID', + # AppVeyor, CircleCI, Codeship, Gitlab CI, Shippable, Travis CI + 'CI', + # Explicit environment variable. + 'PIP_IS_CI', +) + + +def looks_like_ci(): + # type: () -> bool + """ + Return whether it looks like pip is running under CI. + """ + # We don't use the method of checking for a tty (e.g. using isatty()) + # because some CI systems mimic a tty (e.g. Travis CI). Thus that + # method doesn't provide definitive information in either direction. + return any(name in os.environ for name in CI_ENVIRONMENT_VARIABLES) + + +def user_agent(): + """ + Return a string representing the user agent. + """ + data = { + "installer": {"name": "pip", "version": __version__}, + "python": platform.python_version(), + "implementation": { + "name": platform.python_implementation(), + }, + } + + if data["implementation"]["name"] == 'CPython': + data["implementation"]["version"] = platform.python_version() + elif data["implementation"]["name"] == 'PyPy': + if sys.pypy_version_info.releaselevel == 'final': + pypy_version_info = sys.pypy_version_info[:3] + else: + pypy_version_info = sys.pypy_version_info + data["implementation"]["version"] = ".".join( + [str(x) for x in pypy_version_info] + ) + elif data["implementation"]["name"] == 'Jython': + # Complete Guess + data["implementation"]["version"] = platform.python_version() + elif data["implementation"]["name"] == 'IronPython': + # Complete Guess + data["implementation"]["version"] = platform.python_version() + + if sys.platform.startswith("linux"): + from pip._vendor import distro + distro_infos = dict(filter( + lambda x: x[1], + zip(["name", "version", "id"], distro.linux_distribution()), + )) + libc = dict(filter( + lambda x: x[1], + zip(["lib", "version"], libc_ver()), + )) + if libc: + distro_infos["libc"] = libc + if distro_infos: + data["distro"] = distro_infos + + if sys.platform.startswith("darwin") and platform.mac_ver()[0]: + data["distro"] = {"name": "macOS", "version": platform.mac_ver()[0]} + + if platform.system(): + data.setdefault("system", {})["name"] = platform.system() + + if platform.release(): + data.setdefault("system", {})["release"] = platform.release() + + if platform.machine(): + data["cpu"] = platform.machine() + + if has_tls(): + import _ssl as ssl + data["openssl_version"] = ssl.OPENSSL_VERSION + + setuptools_version = get_installed_version("setuptools") + if setuptools_version is not None: + data["setuptools_version"] = setuptools_version + + # Use None rather than False so as not to give the impression that + # pip knows it is not being run under CI. Rather, it is a null or + # inconclusive result. Also, we include some value rather than no + # value to make it easier to know that the check has been run. + data["ci"] = True if looks_like_ci() else None + + user_data = os.environ.get("PIP_USER_AGENT_USER_DATA") + if user_data is not None: + data["user_data"] = user_data + + return "{data[installer][name]}/{data[installer][version]} {json}".format( + data=data, + json=json.dumps(data, separators=(",", ":"), sort_keys=True), + ) + + +class LocalFSAdapter(BaseAdapter): + + def send(self, request, stream=None, timeout=None, verify=None, cert=None, + proxies=None): + pathname = url_to_path(request.url) + + resp = Response() + resp.status_code = 200 + resp.url = request.url + + try: + stats = os.stat(pathname) + except OSError as exc: + resp.status_code = 404 + resp.raw = exc + else: + modified = email.utils.formatdate(stats.st_mtime, usegmt=True) + content_type = mimetypes.guess_type(pathname)[0] or "text/plain" + resp.headers = CaseInsensitiveDict({ + "Content-Type": content_type, + "Content-Length": stats.st_size, + "Last-Modified": modified, + }) + + resp.raw = open(pathname, "rb") + resp.close = resp.raw.close + + return resp + + def close(self): + pass + + +class InsecureHTTPAdapter(HTTPAdapter): + + def cert_verify(self, conn, url, verify, cert): + super(InsecureHTTPAdapter, self).cert_verify( + conn=conn, url=url, verify=False, cert=cert + ) + + +class PipSession(requests.Session): + + timeout = None # type: Optional[int] + + def __init__(self, *args, **kwargs): + """ + :param trusted_hosts: Domains not to emit warnings for when not using + HTTPS. + """ + retries = kwargs.pop("retries", 0) + cache = kwargs.pop("cache", None) + trusted_hosts = kwargs.pop("trusted_hosts", []) # type: List[str] + index_urls = kwargs.pop("index_urls", None) + + super(PipSession, self).__init__(*args, **kwargs) + + # Namespace the attribute with "pip_" just in case to prevent + # possible conflicts with the base class. + self.pip_trusted_origins = [] # type: List[Tuple[str, Optional[int]]] + + # Attach our User Agent to the request + self.headers["User-Agent"] = user_agent() + + # Attach our Authentication handler to the session + self.auth = MultiDomainBasicAuth(index_urls=index_urls) + + # Create our urllib3.Retry instance which will allow us to customize + # how we handle retries. + retries = urllib3.Retry( + # Set the total number of retries that a particular request can + # have. + total=retries, + + # A 503 error from PyPI typically means that the Fastly -> Origin + # connection got interrupted in some way. A 503 error in general + # is typically considered a transient error so we'll go ahead and + # retry it. + # A 500 may indicate transient error in Amazon S3 + # A 520 or 527 - may indicate transient error in CloudFlare + status_forcelist=[500, 503, 520, 527], + + # Add a small amount of back off between failed requests in + # order to prevent hammering the service. + backoff_factor=0.25, + ) + + # We want to _only_ cache responses on securely fetched origins. We do + # this because we can't validate the response of an insecurely fetched + # origin, and we don't want someone to be able to poison the cache and + # require manual eviction from the cache to fix it. + if cache: + secure_adapter = CacheControlAdapter( + cache=SafeFileCache(cache), + max_retries=retries, + ) + else: + secure_adapter = HTTPAdapter(max_retries=retries) + + # Our Insecure HTTPAdapter disables HTTPS validation. It does not + # support caching (see above) so we'll use it for all http:// URLs as + # well as any https:// host that we've marked as ignoring TLS errors + # for. + insecure_adapter = InsecureHTTPAdapter(max_retries=retries) + # Save this for later use in add_insecure_host(). + self._insecure_adapter = insecure_adapter + + self.mount("https://", secure_adapter) + self.mount("http://", insecure_adapter) + + # Enable file:// urls + self.mount("file://", LocalFSAdapter()) + + for host in trusted_hosts: + self.add_trusted_host(host, suppress_logging=True) + + def add_trusted_host(self, host, source=None, suppress_logging=False): + # type: (str, Optional[str], bool) -> None + """ + :param host: It is okay to provide a host that has previously been + added. + :param source: An optional source string, for logging where the host + string came from. + """ + if not suppress_logging: + msg = 'adding trusted host: {!r}'.format(host) + if source is not None: + msg += ' (from {})'.format(source) + logger.info(msg) + + host_port = parse_netloc(host) + if host_port not in self.pip_trusted_origins: + self.pip_trusted_origins.append(host_port) + + self.mount(build_url_from_netloc(host) + '/', self._insecure_adapter) + if not host_port[1]: + # Mount wildcard ports for the same host. + self.mount( + build_url_from_netloc(host) + ':', + self._insecure_adapter + ) + + def iter_secure_origins(self): + # type: () -> Iterator[SecureOrigin] + for secure_origin in SECURE_ORIGINS: + yield secure_origin + for host, port in self.pip_trusted_origins: + yield ('*', host, '*' if port is None else port) + + def is_secure_origin(self, location): + # type: (Link) -> bool + # Determine if this url used a secure transport mechanism + parsed = urllib_parse.urlparse(str(location)) + origin_protocol, origin_host, origin_port = ( + parsed.scheme, parsed.hostname, parsed.port, + ) + + # The protocol to use to see if the protocol matches. + # Don't count the repository type as part of the protocol: in + # cases such as "git+ssh", only use "ssh". (I.e., Only verify against + # the last scheme.) + origin_protocol = origin_protocol.rsplit('+', 1)[-1] + + # Determine if our origin is a secure origin by looking through our + # hardcoded list of secure origins, as well as any additional ones + # configured on this PackageFinder instance. + for secure_origin in self.iter_secure_origins(): + secure_protocol, secure_host, secure_port = secure_origin + if origin_protocol != secure_protocol and secure_protocol != "*": + continue + + try: + addr = ipaddress.ip_address( + None + if origin_host is None + else six.ensure_text(origin_host) + ) + network = ipaddress.ip_network( + six.ensure_text(secure_host) + ) + except ValueError: + # We don't have both a valid address or a valid network, so + # we'll check this origin against hostnames. + if ( + origin_host and + origin_host.lower() != secure_host.lower() and + secure_host != "*" + ): + continue + else: + # We have a valid address and network, so see if the address + # is contained within the network. + if addr not in network: + continue + + # Check to see if the port matches. + if ( + origin_port != secure_port and + secure_port != "*" and + secure_port is not None + ): + continue + + # If we've gotten here, then this origin matches the current + # secure origin and we should return True + return True + + # If we've gotten to this point, then the origin isn't secure and we + # will not accept it as a valid location to search. We will however + # log a warning that we are ignoring it. + logger.warning( + "The repository located at %s is not a trusted or secure host and " + "is being ignored. If this repository is available via HTTPS we " + "recommend you use HTTPS instead, otherwise you may silence " + "this warning and allow it anyway with '--trusted-host %s'.", + origin_host, + origin_host, + ) + + return False + + def request(self, method, url, *args, **kwargs): + # Allow setting a default timeout on a session + kwargs.setdefault("timeout", self.timeout) + + # Dispatch the actual request + return super(PipSession, self).request(method, url, *args, **kwargs) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/network/utils.py b/venv/lib/python3.8/site-packages/pip/_internal/network/utils.py new file mode 100644 index 000000000..a19050b0f --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/network/utils.py @@ -0,0 +1,48 @@ +from pip._vendor.requests.models import CONTENT_CHUNK_SIZE, Response + +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import Iterator + + +def response_chunks(response, chunk_size=CONTENT_CHUNK_SIZE): + # type: (Response, int) -> Iterator[bytes] + """Given a requests Response, provide the data chunks. + """ + try: + # Special case for urllib3. + for chunk in response.raw.stream( + chunk_size, + # We use decode_content=False here because we don't + # want urllib3 to mess with the raw bytes we get + # from the server. If we decompress inside of + # urllib3 then we cannot verify the checksum + # because the checksum will be of the compressed + # file. This breakage will only occur if the + # server adds a Content-Encoding header, which + # depends on how the server was configured: + # - Some servers will notice that the file isn't a + # compressible file and will leave the file alone + # and with an empty Content-Encoding + # - Some servers will notice that the file is + # already compressed and will leave the file + # alone and will add a Content-Encoding: gzip + # header + # - Some servers won't notice anything at all and + # will take a file that's already been compressed + # and compress it again and set the + # Content-Encoding: gzip header + # + # By setting this not to decode automatically we + # hope to eliminate problems with the second case. + decode_content=False, + ): + yield chunk + except AttributeError: + # Standard file-like object. + while True: + chunk = response.raw.read(chunk_size) + if not chunk: + break + yield chunk diff --git a/venv/lib/python3.8/site-packages/pip/_internal/network/xmlrpc.py b/venv/lib/python3.8/site-packages/pip/_internal/network/xmlrpc.py new file mode 100644 index 000000000..121edd930 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/network/xmlrpc.py @@ -0,0 +1,44 @@ +"""xmlrpclib.Transport implementation +""" + +# The following comment should be removed at some point in the future. +# mypy: disallow-untyped-defs=False + +import logging + +from pip._vendor import requests +# NOTE: XMLRPC Client is not annotated in typeshed as on 2017-07-17, which is +# why we ignore the type on this import +from pip._vendor.six.moves import xmlrpc_client # type: ignore +from pip._vendor.six.moves.urllib import parse as urllib_parse + +logger = logging.getLogger(__name__) + + +class PipXmlrpcTransport(xmlrpc_client.Transport): + """Provide a `xmlrpclib.Transport` implementation via a `PipSession` + object. + """ + + def __init__(self, index_url, session, use_datetime=False): + xmlrpc_client.Transport.__init__(self, use_datetime) + index_parts = urllib_parse.urlparse(index_url) + self._scheme = index_parts.scheme + self._session = session + + def request(self, host, handler, request_body, verbose=False): + parts = (self._scheme, host, handler, None, None, None) + url = urllib_parse.urlunparse(parts) + try: + headers = {'Content-Type': 'text/xml'} + response = self._session.post(url, data=request_body, + headers=headers, stream=True) + response.raise_for_status() + self.verbose = verbose + return self.parse_response(response.raw) + except requests.HTTPError as exc: + logger.critical( + "HTTP error %s while getting %s", + exc.response.status_code, url, + ) + raise diff --git a/venv/lib/python3.8/site-packages/pip/_internal/operations/__init__.py b/venv/lib/python3.8/site-packages/pip/_internal/operations/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/venv/lib/python3.8/site-packages/pip/_internal/operations/__pycache__/__init__.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/operations/__pycache__/__init__.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b203b7e8bfb2cd1100519bfaed546ab454c30c4e GIT binary patch literal 189 zcmYj~F$%&!6ht>*A%Psk!u-Oe3> literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/operations/__pycache__/prepare.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/operations/__pycache__/prepare.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f05927574d1c89731ee9c00c58a1a60649467b19 GIT binary patch literal 11191 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 GZ1Dw|k2ACY literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/operations/build/__pycache__/metadata.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/operations/build/__pycache__/metadata.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..36c8423ff0f220075c3498b448c7c062f2a60c98 GIT binary patch literal 1237 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 str + """Generate metadata using mechanisms described in PEP 517. + + Returns the generated metadata directory. + """ + metadata_tmpdir = TempDirectory( + kind="modern-metadata", globally_managed=True + ) + + metadata_dir = metadata_tmpdir.path + + with build_env: + # Note that Pep517HookCaller implements a fallback for + # prepare_metadata_for_build_wheel, so we don't have to + # consider the possibility that this hook doesn't exist. + runner = runner_with_spinner_message("Preparing wheel metadata") + with backend.subprocess_runner(runner): + distinfo_dir = backend.prepare_metadata_for_build_wheel( + metadata_dir + ) + + return os.path.join(metadata_dir, distinfo_dir) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/operations/build/metadata_legacy.py b/venv/lib/python3.8/site-packages/pip/_internal/operations/build/metadata_legacy.py new file mode 100644 index 000000000..b6813f89b --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/operations/build/metadata_legacy.py @@ -0,0 +1,122 @@ +"""Metadata generation logic for legacy source distributions. +""" + +import logging +import os + +from pip._internal.exceptions import InstallationError +from pip._internal.utils.misc import ensure_dir +from pip._internal.utils.setuptools_build import make_setuptools_egg_info_args +from pip._internal.utils.subprocess import call_subprocess +from pip._internal.utils.typing import MYPY_CHECK_RUNNING +from pip._internal.vcs import vcs + +if MYPY_CHECK_RUNNING: + from typing import List, Optional + + from pip._internal.build_env import BuildEnvironment + +logger = logging.getLogger(__name__) + + +def _find_egg_info(source_directory, is_editable): + # type: (str, bool) -> str + """Find an .egg-info in `source_directory`, based on `is_editable`. + """ + + def looks_like_virtual_env(path): + # type: (str) -> bool + return ( + os.path.lexists(os.path.join(path, 'bin', 'python')) or + os.path.exists(os.path.join(path, 'Scripts', 'Python.exe')) + ) + + def locate_editable_egg_info(base): + # type: (str) -> List[str] + candidates = [] # type: List[str] + for root, dirs, files in os.walk(base): + for dir_ in vcs.dirnames: + if dir_ in dirs: + dirs.remove(dir_) + # Iterate over a copy of ``dirs``, since mutating + # a list while iterating over it can cause trouble. + # (See https://github.com/pypa/pip/pull/462.) + for dir_ in list(dirs): + if looks_like_virtual_env(os.path.join(root, dir_)): + dirs.remove(dir_) + # Also don't search through tests + elif dir_ == 'test' or dir_ == 'tests': + dirs.remove(dir_) + candidates.extend(os.path.join(root, dir_) for dir_ in dirs) + return [f for f in candidates if f.endswith('.egg-info')] + + def depth_of_directory(dir_): + # type: (str) -> int + return ( + dir_.count(os.path.sep) + + (os.path.altsep and dir_.count(os.path.altsep) or 0) + ) + + base = source_directory + if is_editable: + filenames = locate_editable_egg_info(base) + else: + base = os.path.join(base, 'pip-egg-info') + filenames = os.listdir(base) + + if not filenames: + raise InstallationError( + "Files/directories not found in {}".format(base) + ) + + # If we have more than one match, we pick the toplevel one. This + # can easily be the case if there is a dist folder which contains + # an extracted tarball for testing purposes. + if len(filenames) > 1: + filenames.sort(key=depth_of_directory) + + return os.path.join(base, filenames[0]) + + +def generate_metadata( + build_env, # type: BuildEnvironment + setup_py_path, # type: str + source_dir, # type: str + editable, # type: bool + isolated, # type: bool + details, # type: str +): + # type: (...) -> str + """Generate metadata using setup.py-based defacto mechanisms. + + Returns the generated metadata directory. + """ + logger.debug( + 'Running setup.py (path:%s) egg_info for package %s', + setup_py_path, details, + ) + + egg_info_dir = None # type: Optional[str] + # For non-editable installs, don't put the .egg-info files at the root, + # to avoid confusion due to the source code being considered an installed + # egg. + if not editable: + egg_info_dir = os.path.join(source_dir, 'pip-egg-info') + # setuptools complains if the target directory does not exist. + ensure_dir(egg_info_dir) + + args = make_setuptools_egg_info_args( + setup_py_path, + egg_info_dir=egg_info_dir, + no_user_config=isolated, + ) + + with build_env: + call_subprocess( + args, + cwd=source_dir, + command_desc='python setup.py egg_info', + ) + + # Return the .egg-info directory. + return _find_egg_info(source_dir, editable) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/operations/build/wheel.py b/venv/lib/python3.8/site-packages/pip/_internal/operations/build/wheel.py new file mode 100644 index 000000000..1266ce05c --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/operations/build/wheel.py @@ -0,0 +1,46 @@ +import logging +import os + +from pip._internal.utils.subprocess import runner_with_spinner_message +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import List, Optional + from pip._vendor.pep517.wrappers import Pep517HookCaller + +logger = logging.getLogger(__name__) + + +def build_wheel_pep517( + name, # type: str + backend, # type: Pep517HookCaller + metadata_directory, # type: str + build_options, # type: List[str] + tempd, # type: str +): + # type: (...) -> Optional[str] + """Build one InstallRequirement using the PEP 517 build process. + + Returns path to wheel if successfully built. Otherwise, returns None. + """ + assert metadata_directory is not None + if build_options: + # PEP 517 does not support --build-options + logger.error('Cannot build wheel for %s using PEP 517 when ' + '--build-option is present' % (name,)) + return None + try: + logger.debug('Destination directory: %s', tempd) + + runner = runner_with_spinner_message( + 'Building wheel for {} (PEP 517)'.format(name) + ) + with backend.subprocess_runner(runner): + wheel_name = backend.build_wheel( + tempd, + metadata_directory=metadata_directory, + ) + except Exception: + logger.error('Failed building wheel for %s', name) + return None + return os.path.join(tempd, wheel_name) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/operations/build/wheel_legacy.py b/venv/lib/python3.8/site-packages/pip/_internal/operations/build/wheel_legacy.py new file mode 100644 index 000000000..3ebd9fe44 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/operations/build/wheel_legacy.py @@ -0,0 +1,115 @@ +import logging +import os.path + +from pip._internal.utils.setuptools_build import ( + make_setuptools_bdist_wheel_args, +) +from pip._internal.utils.subprocess import ( + LOG_DIVIDER, + call_subprocess, + format_command_args, +) +from pip._internal.utils.typing import MYPY_CHECK_RUNNING +from pip._internal.utils.ui import open_spinner + +if MYPY_CHECK_RUNNING: + from typing import List, Optional, Text + +logger = logging.getLogger(__name__) + + +def format_command_result( + command_args, # type: List[str] + command_output, # type: Text +): + # type: (...) -> str + """Format command information for logging.""" + command_desc = format_command_args(command_args) + text = 'Command arguments: {}\n'.format(command_desc) + + if not command_output: + text += 'Command output: None' + elif logger.getEffectiveLevel() > logging.DEBUG: + text += 'Command output: [use --verbose to show]' + else: + if not command_output.endswith('\n'): + command_output += '\n' + text += 'Command output:\n{}{}'.format(command_output, LOG_DIVIDER) + + return text + + +def get_legacy_build_wheel_path( + names, # type: List[str] + temp_dir, # type: str + name, # type: str + command_args, # type: List[str] + command_output, # type: Text +): + # type: (...) -> Optional[str] + """Return the path to the wheel in the temporary build directory.""" + # Sort for determinism. + names = sorted(names) + if not names: + msg = ( + 'Legacy build of wheel for {!r} created no files.\n' + ).format(name) + msg += format_command_result(command_args, command_output) + logger.warning(msg) + return None + + if len(names) > 1: + msg = ( + 'Legacy build of wheel for {!r} created more than one file.\n' + 'Filenames (choosing first): {}\n' + ).format(name, names) + msg += format_command_result(command_args, command_output) + logger.warning(msg) + + return os.path.join(temp_dir, names[0]) + + +def build_wheel_legacy( + name, # type: str + setup_py_path, # type: str + source_dir, # type: str + global_options, # type: List[str] + build_options, # type: List[str] + tempd, # type: str +): + # type: (...) -> Optional[str] + """Build one unpacked package using the "legacy" build process. + + Returns path to wheel if successfully built. Otherwise, returns None. + """ + wheel_args = make_setuptools_bdist_wheel_args( + setup_py_path, + global_options=global_options, + build_options=build_options, + destination_dir=tempd, + ) + + spin_message = 'Building wheel for %s (setup.py)' % (name,) + with open_spinner(spin_message) as spinner: + logger.debug('Destination directory: %s', tempd) + + try: + output = call_subprocess( + wheel_args, + cwd=source_dir, + spinner=spinner, + ) + except Exception: + spinner.finish("error") + logger.error('Failed building wheel for %s', name) + return None + + names = os.listdir(tempd) + wheel_path = get_legacy_build_wheel_path( + names=names, + temp_dir=tempd, + name=name, + command_args=wheel_args, + command_output=output, + ) + return wheel_path diff --git a/venv/lib/python3.8/site-packages/pip/_internal/operations/check.py b/venv/lib/python3.8/site-packages/pip/_internal/operations/check.py new file mode 100644 index 000000000..b85a12306 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/operations/check.py @@ -0,0 +1,163 @@ +"""Validation of dependencies of packages +""" + +# The following comment should be removed at some point in the future. +# mypy: strict-optional=False +# mypy: disallow-untyped-defs=False + +import logging +from collections import namedtuple + +from pip._vendor.packaging.utils import canonicalize_name +from pip._vendor.pkg_resources import RequirementParseError + +from pip._internal.distributions import ( + make_distribution_for_install_requirement, +) +from pip._internal.utils.misc import get_installed_distributions +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +logger = logging.getLogger(__name__) + +if MYPY_CHECK_RUNNING: + from pip._internal.req.req_install import InstallRequirement + from typing import ( + Any, Callable, Dict, Optional, Set, Tuple, List + ) + + # Shorthands + PackageSet = Dict[str, 'PackageDetails'] + Missing = Tuple[str, Any] + Conflicting = Tuple[str, str, Any] + + MissingDict = Dict[str, List[Missing]] + ConflictingDict = Dict[str, List[Conflicting]] + CheckResult = Tuple[MissingDict, ConflictingDict] + +PackageDetails = namedtuple('PackageDetails', ['version', 'requires']) + + +def create_package_set_from_installed(**kwargs): + # type: (**Any) -> Tuple[PackageSet, bool] + """Converts a list of distributions into a PackageSet. + """ + # Default to using all packages installed on the system + if kwargs == {}: + kwargs = {"local_only": False, "skip": ()} + + package_set = {} + problems = False + for dist in get_installed_distributions(**kwargs): + name = canonicalize_name(dist.project_name) + try: + package_set[name] = PackageDetails(dist.version, dist.requires()) + except RequirementParseError as e: + # Don't crash on broken metadata + logger.warning("Error parsing requirements for %s: %s", name, e) + problems = True + return package_set, problems + + +def check_package_set(package_set, should_ignore=None): + # type: (PackageSet, Optional[Callable[[str], bool]]) -> CheckResult + """Check if a package set is consistent + + If should_ignore is passed, it should be a callable that takes a + package name and returns a boolean. + """ + if should_ignore is None: + def should_ignore(name): + return False + + missing = {} + conflicting = {} + + for package_name in package_set: + # Info about dependencies of package_name + missing_deps = set() # type: Set[Missing] + conflicting_deps = set() # type: Set[Conflicting] + + if should_ignore(package_name): + continue + + for req in package_set[package_name].requires: + name = canonicalize_name(req.project_name) # type: str + + # Check if it's missing + if name not in package_set: + missed = True + if req.marker is not None: + missed = req.marker.evaluate() + if missed: + missing_deps.add((name, req)) + continue + + # Check if there's a conflict + version = package_set[name].version # type: str + if not req.specifier.contains(version, prereleases=True): + conflicting_deps.add((name, version, req)) + + if missing_deps: + missing[package_name] = sorted(missing_deps, key=str) + if conflicting_deps: + conflicting[package_name] = sorted(conflicting_deps, key=str) + + return missing, conflicting + + +def check_install_conflicts(to_install): + # type: (List[InstallRequirement]) -> Tuple[PackageSet, CheckResult] + """For checking if the dependency graph would be consistent after \ + installing given requirements + """ + # Start from the current state + package_set, _ = create_package_set_from_installed() + # Install packages + would_be_installed = _simulate_installation_of(to_install, package_set) + + # Only warn about directly-dependent packages; create a whitelist of them + whitelist = _create_whitelist(would_be_installed, package_set) + + return ( + package_set, + check_package_set( + package_set, should_ignore=lambda name: name not in whitelist + ) + ) + + +def _simulate_installation_of(to_install, package_set): + # type: (List[InstallRequirement], PackageSet) -> Set[str] + """Computes the version of packages after installing to_install. + """ + + # Keep track of packages that were installed + installed = set() + + # Modify it as installing requirement_set would (assuming no errors) + for inst_req in to_install: + abstract_dist = make_distribution_for_install_requirement(inst_req) + dist = abstract_dist.get_pkg_resources_distribution() + + name = canonicalize_name(dist.key) + package_set[name] = PackageDetails(dist.version, dist.requires()) + + installed.add(name) + + return installed + + +def _create_whitelist(would_be_installed, package_set): + # type: (Set[str], PackageSet) -> Set[str] + packages_affected = set(would_be_installed) + + for package_name in package_set: + if package_name in packages_affected: + continue + + for req in package_set[package_name].requires: + if canonicalize_name(req.name) in packages_affected: + packages_affected.add(package_name) + break + + return packages_affected diff --git a/venv/lib/python3.8/site-packages/pip/_internal/operations/freeze.py b/venv/lib/python3.8/site-packages/pip/_internal/operations/freeze.py new file mode 100644 index 000000000..36a5c339a --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/operations/freeze.py @@ -0,0 +1,265 @@ +# The following comment should be removed at some point in the future. +# mypy: strict-optional=False +# mypy: disallow-untyped-defs=False + +from __future__ import absolute_import + +import collections +import logging +import os +import re + +from pip._vendor import six +from pip._vendor.packaging.utils import canonicalize_name +from pip._vendor.pkg_resources import RequirementParseError + +from pip._internal.exceptions import BadCommand, InstallationError +from pip._internal.req.constructors import ( + install_req_from_editable, + install_req_from_line, +) +from pip._internal.req.req_file import COMMENT_RE +from pip._internal.utils.misc import ( + dist_is_editable, + get_installed_distributions, +) +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import ( + Iterator, Optional, List, Container, Set, Dict, Tuple, Iterable, Union + ) + from pip._internal.cache import WheelCache + from pip._vendor.pkg_resources import ( + Distribution, Requirement + ) + + RequirementInfo = Tuple[Optional[Union[str, Requirement]], bool, List[str]] + + +logger = logging.getLogger(__name__) + + +def freeze( + requirement=None, # type: Optional[List[str]] + find_links=None, # type: Optional[List[str]] + local_only=None, # type: Optional[bool] + user_only=None, # type: Optional[bool] + paths=None, # type: Optional[List[str]] + skip_regex=None, # type: Optional[str] + isolated=False, # type: bool + wheel_cache=None, # type: Optional[WheelCache] + exclude_editable=False, # type: bool + skip=() # type: Container[str] +): + # type: (...) -> Iterator[str] + find_links = find_links or [] + skip_match = None + + if skip_regex: + skip_match = re.compile(skip_regex).search + + for link in find_links: + yield '-f %s' % link + installations = {} # type: Dict[str, FrozenRequirement] + for dist in get_installed_distributions(local_only=local_only, + skip=(), + user_only=user_only, + paths=paths): + try: + req = FrozenRequirement.from_dist(dist) + except RequirementParseError as exc: + # We include dist rather than dist.project_name because the + # dist string includes more information, like the version and + # location. We also include the exception message to aid + # troubleshooting. + logger.warning( + 'Could not generate requirement for distribution %r: %s', + dist, exc + ) + continue + if exclude_editable and req.editable: + continue + installations[req.canonical_name] = req + + if requirement: + # the options that don't get turned into an InstallRequirement + # should only be emitted once, even if the same option is in multiple + # requirements files, so we need to keep track of what has been emitted + # so that we don't emit it again if it's seen again + emitted_options = set() # type: Set[str] + # keep track of which files a requirement is in so that we can + # give an accurate warning if a requirement appears multiple times. + req_files = collections.defaultdict(list) # type: Dict[str, List[str]] + for req_file_path in requirement: + with open(req_file_path) as req_file: + for line in req_file: + if (not line.strip() or + line.strip().startswith('#') or + (skip_match and skip_match(line)) or + line.startswith(( + '-r', '--requirement', + '-Z', '--always-unzip', + '-f', '--find-links', + '-i', '--index-url', + '--pre', + '--trusted-host', + '--process-dependency-links', + '--extra-index-url'))): + line = line.rstrip() + if line not in emitted_options: + emitted_options.add(line) + yield line + continue + + if line.startswith('-e') or line.startswith('--editable'): + if line.startswith('-e'): + line = line[2:].strip() + else: + line = line[len('--editable'):].strip().lstrip('=') + line_req = install_req_from_editable( + line, + isolated=isolated, + wheel_cache=wheel_cache, + ) + else: + line_req = install_req_from_line( + COMMENT_RE.sub('', line).strip(), + isolated=isolated, + wheel_cache=wheel_cache, + ) + + if not line_req.name: + logger.info( + "Skipping line in requirement file [%s] because " + "it's not clear what it would install: %s", + req_file_path, line.strip(), + ) + logger.info( + " (add #egg=PackageName to the URL to avoid" + " this warning)" + ) + else: + line_req_canonical_name = canonicalize_name( + line_req.name) + if line_req_canonical_name not in installations: + # either it's not installed, or it is installed + # but has been processed already + if not req_files[line_req.name]: + logger.warning( + "Requirement file [%s] contains %s, but " + "package %r is not installed", + req_file_path, + COMMENT_RE.sub('', line).strip(), + line_req.name + ) + else: + req_files[line_req.name].append(req_file_path) + else: + yield str(installations[ + line_req_canonical_name]).rstrip() + del installations[line_req_canonical_name] + req_files[line_req.name].append(req_file_path) + + # Warn about requirements that were included multiple times (in a + # single requirements file or in different requirements files). + for name, files in six.iteritems(req_files): + if len(files) > 1: + logger.warning("Requirement %s included multiple times [%s]", + name, ', '.join(sorted(set(files)))) + + yield( + '## The following requirements were added by ' + 'pip freeze:' + ) + for installation in sorted( + installations.values(), key=lambda x: x.name.lower()): + if installation.canonical_name not in skip: + yield str(installation).rstrip() + + +def get_requirement_info(dist): + # type: (Distribution) -> RequirementInfo + """ + Compute and return values (req, editable, comments) for use in + FrozenRequirement.from_dist(). + """ + if not dist_is_editable(dist): + return (None, False, []) + + location = os.path.normcase(os.path.abspath(dist.location)) + + from pip._internal.vcs import vcs, RemoteNotFoundError + vcs_backend = vcs.get_backend_for_dir(location) + + if vcs_backend is None: + req = dist.as_requirement() + logger.debug( + 'No VCS found for editable requirement "%s" in: %r', req, + location, + ) + comments = [ + '# Editable install with no version control ({})'.format(req) + ] + return (location, True, comments) + + try: + req = vcs_backend.get_src_requirement(location, dist.project_name) + except RemoteNotFoundError: + req = dist.as_requirement() + comments = [ + '# Editable {} install with no remote ({})'.format( + type(vcs_backend).__name__, req, + ) + ] + return (location, True, comments) + + except BadCommand: + logger.warning( + 'cannot determine version of editable source in %s ' + '(%s command not found in path)', + location, + vcs_backend.name, + ) + return (None, True, []) + + except InstallationError as exc: + logger.warning( + "Error when trying to get requirement for VCS system %s, " + "falling back to uneditable format", exc + ) + else: + if req is not None: + return (req, True, []) + + logger.warning( + 'Could not determine repository location of %s', location + ) + comments = ['## !! Could not determine repository location'] + + return (None, False, comments) + + +class FrozenRequirement(object): + def __init__(self, name, req, editable, comments=()): + # type: (str, Union[str, Requirement], bool, Iterable[str]) -> None + self.name = name + self.canonical_name = canonicalize_name(name) + self.req = req + self.editable = editable + self.comments = comments + + @classmethod + def from_dist(cls, dist): + # type: (Distribution) -> FrozenRequirement + req, editable, comments = get_requirement_info(dist) + if req is None: + req = dist.as_requirement() + + return cls(dist.project_name, req, editable, comments=comments) + + def __str__(self): + req = self.req + if self.editable: + req = '-e %s' % req + return '\n'.join(list(self.comments) + [str(req)]) + '\n' diff --git a/venv/lib/python3.8/site-packages/pip/_internal/operations/install/__init__.py b/venv/lib/python3.8/site-packages/pip/_internal/operations/install/__init__.py new file mode 100644 index 000000000..24d6a5dd3 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/operations/install/__init__.py @@ -0,0 +1,2 @@ +"""For modules related to installing packages. +""" diff --git a/venv/lib/python3.8/site-packages/pip/_internal/operations/install/__pycache__/__init__.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/operations/install/__pycache__/__init__.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2ba18d92eb71ef418a8ffd129a4628af9a29d25b GIT binary patch literal 253 zcmYjMy~+YH5X{+pa^O3p74){Sv5=3CuduWc8=DX>ix-XAkgNy#M!u4*k6>qI`~wGO zmSJI-S@e3P$oMY>j`F=c%r}Z`{xVZHixEpTS%54J;?GPeS&|wR0s>vWE-W&7`E&3LmT|qc- wLw;0^Az8-ZCm4bapsZ(%UOS+GQL`nV;N1dL{#sV53Wsxd@~Zp$m~_n)cmJtLwg3PC literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/operations/install/__pycache__/editable_legacy.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/operations/install/__pycache__/editable_legacy.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..7326ba5b163bdbbd1bfb801bedfc210b0a8b00e0 GIT binary patch literal 1331 zcmZuxPmdcl6!-keWHL!M+wDrIErJn(LnN9xAS4cmR$Wz4u??`Lf({4oWbB<->lsgN zPavz|)LyH8h4#p|;p{6XJ^~yN&y(z*O6!qd{NDRL`}y~t^K?9p5R3;AqJQ=f`pYU; zhX=}im}&)rpcD~@xZFt{`1QD3da37Fo6r5Sm-f1Kj|XKx?RV>dhvgt0IEW79G2r?< zDu?N?9HpajoQ^w8$al&~IsuIHW|!W0>!f>RK%$o@y-D0BXgWN*cSwsYU&oX%oh>+x zS*3Kwd8V1D;#!KFD)nj1W^@)GE2^7%Rtu*GM0PX!U zJEge8YazJ8+X$S=LVmLi|q+u+I#%$`)Byzn}-MA;-jbY`J?&QQ_uK^OlcE- zSKE9tZo((@c|)t5Ld5QahH>(+S}`fA5)RKh#%)G0hA^#u08{-4LZdgpZQFb6I!L>1 z&^j$@`>or0txw!n{of<)y+E%&a!?z--UE!^M(u!juK@oO`W*d$j?m9nR>TJeduP8q z+AtPpah>I-Sz$T6&0$8cLdMQOyETb5P7V#xvv(9w(;Zajn ztSUC1E7Zp)LdKt{X<&8=E*2TbqN7Ne$+m(QhMh{_Mp21#QJt{D1hu3m>^I{tMM=#V zTpPDy+Oq29zmoa1X9B2XL8b9o1!viAm97;&i0M#TdZp!8j;+|SVgkbWRc5#Cu7c|| zt~0$fAyWc+iV`ze*rH)tt<0^avW!uJm1ty6F=3MCTFABWZJ+#sD^cR6+wKqNcKIZk23_ zO3r&9^X@GG%VzhS#B<+GNJPaT(C)}}op-)}f+%!?jqN{q2Qbrp)5n;I9AneBJVFW0 z9Y|z$k;tskjH}t!*->jgz7BEO6S$+UD~0*sTIj`l>Z)XJUkB3b8nTh_mxN5PRRU0C z--^(h-+MRiqGEDjy@P`4!%c657~5)NEN|Fgd-bklSHx`_5`GEKpyBi@2Q;-0!goV= P0#jKtN6kQZy}!APAcDBk0xF_>#0)AlR&zw6ykq z9Z8+fy48~pZC(z}Q=cWYFZ~z#2lP(}3cmKKuLb&2w7Cu`$#GJz#94AUJDlPCX2_2l z4F|#V69>_+Itcw;4X!^W7`zLO{{;v^9wL|+G4`;28=e90Qd~+*&%|oZjLV7TS-M}2 zD~avdx^KnR#PJ;6uf(;a?$veQjvGnSYwCVAZY6E6t@}>gNxEJaBidzu0=>0(Bk6g) zWYgPBw!AGZQ;)Zk9dAeX8}Y4V*V_eoJl~_Y7uee;P11UXygS5ri2Cj6TleWG2+!Rp z-=dZibfDYWxITe$9kY5RXK5+g4exrjvmbGvkq$BFHEE6zv2+bJ{ z13`%zMJb`F@Z)TxMl|IUMtu@77~M{SQ|fEgBFkd#uPpEbHsUb9$0lh?nSU0EvCs2J z4-&8{7*UvRd_d11_I!Uj#%!YFW2 z`vMi^qFR`R1w5yy5bJquRu?r=nb(2SSilOihG<@(%hxahPV2GxiSB%ZRH1)O_KyJLhln@@@_S;ls9oU8?yOlf=UWRj-(H|u z>n5$gN5=p{Qh#R8+C}Sq^x5mPj$Ub}=q&K8TXg5Q2-y53W;;c@=z{GV7=4K!jiK#` zUD8xuEih@Vy(4YXA>HRHZNQ!pn)S5acW0fVGv5O{HnslS#irK!heD4}_J0U7MQ?sb z&)$W#HX#xl3uA%xdO6Iw3xtt)so1yxo|dZ=8w6x#Tj22)>0KC?yV~cM$tJ|72X<|4 zgLT(;R9V&EI*`p#oE-(RpJ`-q*;>PQ&9DHP8B2w@Dkl?BZCIrYCneH5FyIp06`zm+SOn}%VB_D+V z{HsUxRXS`yLJ2x{;N%y4%^p$vlQ5WoNbETY^E7)a}hD2$dF!I=%AV*83H{7Ca8i&CZnC>z>YKR@?1*zAaB zaKcf-Dr(k(jY3@Ig)NE2X}LMB7*N{8ohBw~mOmlX)RPI4Pi$JG(XR5Hmj7c9!v zmZ&^0ahgjj$Q3kYh0$1hVR8sGD{JvH29WP>%i4NrMjz>NvMekrk(fHX*rp;oitGZB z7S~4~+foBtz)`9S3scGL)z`YzK@73e$FRi5UVT-evY9dgd=Zw%2vd)0I+}Ij+OPUII$r)nvV&ctUa?_R$2N8hcwQK$@gKu7OXhzK3*`T4 zbxhD}!>WbCX08@o)))@7*+g?PjGxz08O^H;PVfrl9pHw)IFNj6sarrcYIBtqQj1@(AZEC``^|KfF3}DP1N^O zrmkVK3i*G3nR~YHt3>jB_Lf>i1!)N=jVetvs_eI6tw~JZQ3n@yftWh9b%4{gpJC#j J;*^}y{{S-|nJEAO literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/operations/install/__pycache__/wheel.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/operations/install/__pycache__/wheel.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c1356eb9f99a588244251c91f0a6c491176ac42f GIT binary patch literal 14611 zcmbt*d2Ae4nqOUAU48JrM4hFZEt5^#I_%Nd9^0~PD`Qg{k@9$I?d>V{E0Rt2rB_8! z>Z$f7OHCvX;8;Pj$YOUkXwD{!)h;#&l1=_tAPJB~kbiRmi$cy#@`r(7|Jh`cagtGf z-&fVmCZ&lp359<3>K$LbXU@s-GwcQF}=MdL( z)x)(T&JnKXt4C|coMScHv1`Yjk-JyAR9oaFjo^;GS&bDHZz)ibrT&RMPxS7&Mk zr=Tj{=|`$u#!5%3=W5S6&vEZ)b+$I=%+-ocu{Q6_*PeHtuf5>BPh%eAjLUjxJ!yvt&IMVnTfuX|?a74Ov@)p<=!h{^kk^9^xc z91zp@Rp)haP#i+b8{)7yg6Es!s5pk_6=93xc)lf0h?96;6{o~$Jl_^)#92Jwc}Ed5 zqHtdk1@GN$-MJ>tiRaM%XV5+?=FmRpO`!do;)0kL&*Mw)iHqU|@gi#P3w=>3Txz|u zxY=wrWMHo}q+O}|fm^Ls>Z`U}7xwaIr7GwpSo7=?TWg+IJz+0b>aM(JH{J4vyXw)j zni~|eUl3{))M&_E_8ZmBz$;a11a|>#Bb&17yDMI4`O*ciUTz2vjcKRSe7jPm>Oga2 zwIn^iu_?=*kA~c0Syr0C`|gG(@jATf1tsq;fh&3SK;A=}wHQb&?b>zJN3O-|c7sZz zepSi_O`4)fHFv!sOSMWJdNJiMp@g=O087DC=rR3zbma(KG+={JC4{ubH1=N9a!^)nWr_kEl`6avr3hjDZ z`$%hRZE&+d4YiK8qim}kU1&RM#}N9CI;FIY&@duemQ?yfjm2rQ_PGky*vY>Mwk$zFIKl0M;aR z6p{({her&=thR3`3J1t>7ip z{ZSN(KByY1`NYt)pVH4Xrr4r4bpp?0Uh7 zjJjL%BBMsT*Xq?s2W#2CuRM({fytE0{+&1R6+e$c(Rg>7g+0pG@m{6{bpHqmGWaq2 zcTnk~|Bfnu80aB{+qU-k&9)li`ggEPphSw0!GHPN%0=Z{%1z}r6=IKpxt{J=f!WFI zC_5_9$Dn-!TDD_}6r+s>7&*W&x-&mi_zNb!aFD-{4*^*P5_a;TLABkHBE6^x3n!Rq zee0&jv}T_?9uthcRRM0DJU&l2HXk$+I?CGkOHgx3ZhCfQ#U@^5Z@Io*UUTcKo+$F5 zNR!LHh23`{zRjd_@_3YT{c@!eX*oS?{h_-VB%znK6At6JWPA8P^?vArY4cSwv}q0QM0X1TIQ#NicyfdYeA8`6#ne z0rJyGCk@asT0kBI`>`RrQn_1-C%un_FmF@LyqZ@nHLDJ)!|J#?inlDDz>FIhvj;N> zOL`bTj+apBu-XH*sP5p-H<gO-F)xg*$^i|(dK0e&m35`R&V-m6g;RvZ!s@i(p6O%>If?gm zazd{tJ6b!%b%X1sND1@4@~IN!A1EuTNDJ$}6{b1^JIY&F!M55?B|RDLG5dPVFcq52 zOS21+nq>~*43)v)8&xm4L*L1*ZdST4dk%uQJl)hH9mE+v2-pp(7S_$k%-9G#3+1{uxRhuzE&SFI|(<78B=<<1LIEf-k@l0TeitTZ|1a%f5Yv3xtdg2kTPH|wVJ)XgOZ1DcKnA!~|FvRo!c!+j=yIN*Ori*tj|bc8LlS%H z2MVrV6FA1l>H@Feu@-5?=OgvbV^#hFM#sxy8IpNr)vH6zlCOQAV9|;UMN|F{E9y=7 ze_4_IsQ3AgsrKF8E3HPlDE>Tty>%1@`&pHD7dn*BtV$A>lkcIx;j;`ie9zmEBnP7G z?rlezSTC!&O?i|03_;qMdB?48LhVdP7BMj9KH3U67SVKMFk8y=g_PnOiP8xggAr_2 z;sg9H;7LBkp?&waiXQ(c3Pl5(GP9})W;F;VHLerm%4=5Upn6c14UE`xjHD{i&X^bc zGVm-^eAru{f2E@aM7L@PI{f%tTMP7c1GG}T6%*||&(71%#U$2e?vSc8)%uOMJgBU&C|LBm^?PV(Z9uA)aL&+$a{!vHZr2ZnIsBEd-M04M2t|R%-y<&j1~>tp=l~rO62Ou|MdjR*!)_}32{zdJ!u^2N0NM{-ws|2ij zmtEhJ^VD_<#bZtWA|8>Npgv1IM*Zw7RS;#lQER^T>lne5YpUQN7nA*!++~#ux;*MgczCi`VjjHLAJIC9QcckI@ROf+zdbne zL%?X|O~wa~dC;!Ja_PKKs4)S$k`( zQeFd`e#9)cyekmH72!$S6>Q&QZqTq9Ya4Qwu<%}E(}vt!!5H-T@DV_W`jD%DmEiI$ zEFaIFo2xhGsAVo*>F@2oM%Cx(yZ2-*c^mt<3A_IEi86QYT5o zOK3Pkfmxz%Xo)~0HBINk`BMEP7Hsl1rtA~4EJXg0;F%~4prWC)F8n;m*p-N_%EI-f ztCwv$>GGx|REf_Eq9AZ_@NkF(YcqbqW@VWa4_4s6`^k4_lUt~{_xKu?JsUz6{uSKQ z@;w^{z3n!kZN$gs7v%?7Yhg0Vl^fM6j*g7tC?~uXce5I>#DYB@?4og$#)-1jvX()p zT+?x}Q5q(AMK?B-(N|dHmk~(hUlU`jg39wQx-=Y2#wDX!DnLb=Co``ga!^n)8 zSY)h2ABl9ZJQxjkFxnYhm5t3N+$hWUm~Jcqot-U+O#+sSF``5(ax5kyfQm9Tf3?JB z0o;TY+2sb#VEobEdu(=;0=Pk(fvW2VJgKx&3!K3&uu=dImFJA`gXt6}U&04sMA*VI zVyS%mD=+;A80*u~E2g0udKOZeK)b$_3#se+JIWx z6YYsZU6m!ARh9(>K9&oi5(*X zCQ+s87mBw1HiQ|iomS0Yny&8y_3;7b4=bB>#_`!$X~$yhvRk)7B`C>1v`TymtLHZo zjj>{%2*DUQymSF1F>Cy>Bz)?qb)4`be(W9zl7l7%iVPWICr`^xn&Q)MSFOe!?NO^) zi7i0=z_3DBFy4I@8~S4c)YGZYC&&(QNC(p|{@mKKa9`_d>GB}B`%-*=sOXrr?<_}fe+kf2v3cT3=3h6cbAk=2MVNSddJn+J4ohK_tWeM>_PocnBkv8q2vwb$0)&#Ew1mDF|R(1 z)=5?V2&2n1rT>pO@$2}pZ_!g6Xd8}3Rt>E9iT5i$Ie5E{_r=W>IH4Bc*|bV5*-E7- zTPnecxe32UDaw~hw>RA?$-GjjZ!4l5}BLB&QAYxFY&I5(Bh$(x(*oUq@B>JE%Q%r0mW>2P<;DBQ@BFBqKEA z=ntTbIR*|n6%F2~G#7V6J_}{qe)o^+1dg6bG=sJbZUHM82SfY=NAb$@90+BJ#rmeQd_O7zX zFx3UvOMi_f{BGFA5dH)$ZM+W?=zXb7ch~(ZqLRgr_x?Ig z;i1{VzSp&NaH{x;*hLzAlTQNN&}wH8$H;7}@n0^R| z+ki)V>Wn=!LJK^9D1HlvL>_O$!FV`K-1}4YQ|*EJKwHtofEc`QwMW7n_fqAHZ)lIOTh%*MrbsD6C=Zk9r9aDhI%-$t+gjjyAu3Soh%(zF;^Q}H~=Z-;P}2Og@O!vbr<+NZNEW3<5|CIfr@xR`>Ib9zOa zGDNYX#*cyM?-u4ES*aG zcrYW5cM9Qg__#D;gM^2;XZsWTL*+Y4UHcIF24;Q`oC}Wu-%o@mL}nwyEyJDX!V~n3 z9-f`RU7hT`oy6OzU^YA@P9dB#+&&$i?#zkP@v7oL5yCyi&U|<(#8}?JQPlb&o&k(A zJ&0%Vb~boEJR@cR@uT((>Ssj(^|#xF;DyeM;SA2?TyQ=-_fUrmHxIfv_gSj_9QrPV z1@z4Z7sKba37?1CbKz{~QaDH7dt}_s?o!}xjaPRz#42zX88F*9_a8&PT#G#gHat)i z)lZCtM3*7ib=h7(Nmd5w?oHWPhb7vlyY%Zm3<3iGvi&CP&z^mMuRA*qjzi_=fltjW zwJOcaHpThuBqe}N2p$YGfK2J0$nT%*bL9K7{T4KsO&EYa++`FC#{$aa?8iJ>dos7T zEVv!|p-As`31%w`A6VL#?Zr530N)0?QR1jvat;^_hcD|}v$RMCWaE!?D}1mYaPuBH zhu~1YY=3*r!%EnbvV0FQ@T8-=G<@g=2g%ux+p{{hbK}L8x{j4S@UY|Z2KMO&dz^)P z4~$j_ONuNyTvP0gq0k07eBvduy!Y)}NQ2;P5KmyuUiETsgXie-NagIm-!kkt8ed zN>}eO5fsTPt#ipCm%6);6F&M3x1KjNGApY{V(^xrP^N%4$f-yHlf2;VJ(>=!o+SMk zem;qQQv4q3kTJ;F2-SxgYKYZ=tCJn1$#d}6V|PUVv9{W}^gc|FXILF<&nN5cH#^we z@QVvDU0L7%v-l|Vu{1J0*pKrAyhj$4Td0hlaMHMN*4-(@PZg+|Kg1A8?q2yk2MTFUe0DbhpH3{+ z5-IbAG=N9y$1i`Rw^MBsmSrlAq6&p#4jpJm>#22Ep@>$X##SF`AQ_zU8pS3MyI2z( zJqb+L+&1`UnnP6}EX zq73p6ptEGChSqEcaR}7Gv(cIl5ubrJHV`1#xvj}RLEB)M4+o%$4Xh8ZK=b8s(1P$C zXgkm@W_Rad%vg|LAAb{3-1P}AC*M@sgBURdD1$5+QthEo$Gq2|`Q#xbhah{ff^dj* zvfI_$qhwrAq6fvne?F@7dsHX?HYUs8r{eEY!P+nvtPK;5Rrk@@*S`uW%GJj5GQ3^A zAZcItAO)#V^WH8TkmQh%Hj2pDa;qC%gP4Pb9OvM`hI~lFmT8!|S%<;B0TXJCL`!6q z8_jz}5wIX2TcR{9aW@F0{0B7Jf^QO3g=7}0)wpK5W#qCUr|QGf^>2cp&`xBZ8u z4{t5rj4SWlyb)KfFTES3%4-->7{*6A5e@-JxKo`pQU}Pd3&v5o3;W%~G7y1^bkG>! zZZ6~LQzvpSoHUI@gOjGYM1?!Fr$3;AX;}lr9L%B`S+#I1Gx@^%^Y>{)?=E21$LIQs zbRU<{r&yLYi7+JvE+RZ>ATk~|hSjV#`9#z6aEwxzvvv0W^8Q-G zY=|ZS)?#oscnZmSjByRCp}dV9Fh5FgkcZ(mMa~ita$Bvx((8l4B46e{Bk8kyeaPOC zOMB)SA!dWgDjQ~V1y6OuWR!0iMdYM>@jofvl1+jf$V#jHm>LY!Trkf?I=;Vy0`*t$ za55~eNRvWKje6@;?4Ixhu9f%9G3C;hB!|5GEjn*vWeS|gy?>gawJv_uNj?)E`{}U) za>B`fP6a2j=t#bEMy@U_-nx19#o=CJU0+yinP|6PwVkY6h5p3Mx|K!SX&~|pfn^&B?=lb`$GNm=t|Ay7J#`_!Qk{$eiEq_GfBHqO* z`LF0;|1A~IU}>YhWg|wAf0}s`UiZ%Y?!bt-@Df&d<)`AQ*hLlqHUByOk29)n-btnH0#6$p!$FZLZJRZy+KNr@bN)N$xj_W+b|}DB4$6?6n|h z`j_XCEJs<%(8NKPly+Kd$kq8hE-!zczcm-9a?GEEo<9eTEFo;4zs#|B(m*M-nL?RS z=GwyI(i`u+clBm#pjRydndKF1n$H?9S;vgMwXJOYq!E!STiVuh(3Dt7Vs+^^=%h$p zDyVNG19zeDQXF2lsr@(=r>GdA;uZ?T?c(GyRFF*y2P=75V+P-*K{*=4AvWyYj|LG- zEU$IrVR(;aM&kMPqikY<;8Y!i8QDxBm#zFO1SciD<;~T|g6EY}V`8~T`6--H7p2j` z!jJq_%wgmoq2^e3Tv>79igqjnC|TagU!x&^j*4w6DD5T=H(sV1seqA*03U@S@8iW8 zAg5ZXhDc`xfhu-gMusa_eMxC??6c-bn*3FI{W=wt_#^)i1*MWA(e!ny>Tnq&r4~7d zZ~^{^T1-wolpL)Wu3`? zLXa%N9zM|}yvl!x0{=$>1_!nIlI|a$;N;_0)b9yYh&eL9#lgVX7Gt)GauBXSw zF_{Iwq&SQN?ukTsXDl`p{Zh~JWP`Asz1D(WJ3{Zq^;Khl^sUGu4-% zw+HTY_X`LN>`m&6R8Ky}7a|>T*xg_O;sJ;)H@gfQ>+Qt{B=423i^7dgj>jc0nV#D3 zWRog|p#BR!ApbHI|CNeIR1nuGq+^3*SLF6glUT>0i;hFWlh5Xh_>U!u|0fuw9G%n# z;rF#PQ$unoqQWM}eks*7tDaH^webO@*Zq&d*YnyS(ydVrktJiO2k^^s4GNKZP|F); z%1W7n;CAbj9IH{ZTHz9j;aMniCy-=; zeV5a;@8pjNj`#|5xDQc*)k6R8NBd0s{7raCDI9^6XuO?+)r1_4Fue|26}AXeDXLSX z4)%l*rr;}1KigNF*cGk8t`R-QGzgW2*kELARO(_0VM%Bt$hU=m=+XsTF{xNgvhv4N z`)^eIcPf5D#g{1HlpmxzNiazYRm@gtlZ8yIqGe-hCo}e05S$659splKcN_=_K%ii* zPQJTR>WS3WJ^>sJbkT~ze~V-vF>@u$=lulv07~|!8g7qNXxtf>RMUPUOz9@QNb-&rDq)DS#Xk&Y`{*cGB>FcVNev zFG&e>4m@iF*-spga)$c5{mNa=+l=B#6zHe_2m)QZ?8Si@=J?SRPwI7donU?}JN8Xx zH((LAO_?QPZ1)Y&P7m(|6A$d(FQZCy@R>vIHF4>3h+rIf)_@orXbfRlH2thGj0r5w zqXDmm#E4>&jUq>Bjv2%s8N-VtO-oKtLHeMaqT&D*(^MR!;t&<2Y|A4kqWE5VCq!mu z)i1{KOHv*c$Nrq5YhCZlmBkNkHnu2a8@$Ic;W&OpvOo3$U7*_QRNSEA78NZ1Kcm{O zP{ATKbG3U}ag6bIsE3sTqBF+kKI-Txg-BGuA`vcq4Wkr)1%+WE4;DOY|3Au)m6&{It9ZtJxtvBC)r<8eo1*1HPrt%nF1w_ literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/operations/install/editable_legacy.py b/venv/lib/python3.8/site-packages/pip/_internal/operations/install/editable_legacy.py new file mode 100644 index 000000000..a668a61dc --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/operations/install/editable_legacy.py @@ -0,0 +1,52 @@ +"""Legacy editable installation process, i.e. `setup.py develop`. +""" +import logging + +from pip._internal.utils.logging import indent_log +from pip._internal.utils.setuptools_build import make_setuptools_develop_args +from pip._internal.utils.subprocess import call_subprocess +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import List, Optional, Sequence + + from pip._internal.build_env import BuildEnvironment + + +logger = logging.getLogger(__name__) + + +def install_editable( + install_options, # type: List[str] + global_options, # type: Sequence[str] + prefix, # type: Optional[str] + home, # type: Optional[str] + use_user_site, # type: bool + name, # type: str + setup_py_path, # type: str + isolated, # type: bool + build_env, # type: BuildEnvironment + unpacked_source_directory, # type: str +): + # type: (...) -> None + """Install a package in editable mode. Most arguments are pass-through + to setuptools. + """ + logger.info('Running setup.py develop for %s', name) + + args = make_setuptools_develop_args( + setup_py_path, + global_options=global_options, + install_options=install_options, + no_user_config=isolated, + prefix=prefix, + home=home, + use_user_site=use_user_site, + ) + + with indent_log(): + with build_env: + call_subprocess( + args, + cwd=unpacked_source_directory, + ) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/operations/install/legacy.py b/venv/lib/python3.8/site-packages/pip/_internal/operations/install/legacy.py new file mode 100644 index 000000000..2d4adc4f6 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/operations/install/legacy.py @@ -0,0 +1,129 @@ +"""Legacy installation process, i.e. `setup.py install`. +""" + +import logging +import os +from distutils.util import change_root + +from pip._internal.utils.deprecation import deprecated +from pip._internal.utils.logging import indent_log +from pip._internal.utils.misc import ensure_dir +from pip._internal.utils.setuptools_build import make_setuptools_install_args +from pip._internal.utils.subprocess import runner_with_spinner_message +from pip._internal.utils.temp_dir import TempDirectory +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import List, Optional, Sequence + + from pip._internal.models.scheme import Scheme + from pip._internal.req.req_install import InstallRequirement + + +logger = logging.getLogger(__name__) + + +def install( + install_req, # type: InstallRequirement + install_options, # type: List[str] + global_options, # type: Sequence[str] + root, # type: Optional[str] + home, # type: Optional[str] + prefix, # type: Optional[str] + use_user_site, # type: bool + pycompile, # type: bool + scheme, # type: Scheme +): + # type: (...) -> None + # Extend the list of global and install options passed on to + # the setup.py call with the ones from the requirements file. + # Options specified in requirements file override those + # specified on the command line, since the last option given + # to setup.py is the one that is used. + global_options = list(global_options) + \ + install_req.options.get('global_options', []) + install_options = list(install_options) + \ + install_req.options.get('install_options', []) + + header_dir = scheme.headers + + with TempDirectory(kind="record") as temp_dir: + record_filename = os.path.join(temp_dir.path, 'install-record.txt') + install_args = make_setuptools_install_args( + install_req.setup_py_path, + global_options=global_options, + install_options=install_options, + record_filename=record_filename, + root=root, + prefix=prefix, + header_dir=header_dir, + home=home, + use_user_site=use_user_site, + no_user_config=install_req.isolated, + pycompile=pycompile, + ) + + runner = runner_with_spinner_message( + "Running setup.py install for {}".format(install_req.name) + ) + with indent_log(), install_req.build_env: + runner( + cmd=install_args, + cwd=install_req.unpacked_source_directory, + ) + + if not os.path.exists(record_filename): + logger.debug('Record file %s not found', record_filename) + return + install_req.install_succeeded = True + + # We intentionally do not use any encoding to read the file because + # setuptools writes the file using distutils.file_util.write_file, + # which does not specify an encoding. + with open(record_filename) as f: + record_lines = f.read().splitlines() + + def prepend_root(path): + # type: (str) -> str + if root is None or not os.path.isabs(path): + return path + else: + return change_root(root, path) + + for line in record_lines: + directory = os.path.dirname(line) + if directory.endswith('.egg-info'): + egg_info_dir = prepend_root(directory) + break + else: + deprecated( + reason=( + "{} did not indicate that it installed an " + ".egg-info directory. Only setup.py projects " + "generating .egg-info directories are supported." + ).format(install_req), + replacement=( + "for maintainers: updating the setup.py of {0}. " + "For users: contact the maintainers of {0} to let " + "them know to update their setup.py.".format( + install_req.name + ) + ), + gone_in="20.2", + issue=6998, + ) + # FIXME: put the record somewhere + return + new_lines = [] + for line in record_lines: + filename = line.strip() + if os.path.isdir(filename): + filename += os.path.sep + new_lines.append( + os.path.relpath(prepend_root(filename), egg_info_dir) + ) + new_lines.sort() + ensure_dir(egg_info_dir) + inst_files_path = os.path.join(egg_info_dir, 'installed-files.txt') + with open(inst_files_path, 'w') as f: + f.write('\n'.join(new_lines) + '\n') diff --git a/venv/lib/python3.8/site-packages/pip/_internal/operations/install/wheel.py b/venv/lib/python3.8/site-packages/pip/_internal/operations/install/wheel.py new file mode 100644 index 000000000..aac975c3a --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/operations/install/wheel.py @@ -0,0 +1,615 @@ +"""Support for installing and building the "wheel" binary package format. +""" + +# The following comment should be removed at some point in the future. +# mypy: strict-optional=False + +from __future__ import absolute_import + +import collections +import compileall +import csv +import logging +import os.path +import re +import shutil +import stat +import sys +import warnings +from base64 import urlsafe_b64encode +from zipfile import ZipFile + +from pip._vendor import pkg_resources +from pip._vendor.distlib.scripts import ScriptMaker +from pip._vendor.distlib.util import get_export_entry +from pip._vendor.six import StringIO + +from pip._internal.exceptions import InstallationError +from pip._internal.locations import get_major_minor_version +from pip._internal.utils.misc import captured_stdout, ensure_dir, hash_file +from pip._internal.utils.temp_dir import TempDirectory +from pip._internal.utils.typing import MYPY_CHECK_RUNNING +from pip._internal.utils.unpacking import unpack_file +from pip._internal.utils.wheel import parse_wheel + +if MYPY_CHECK_RUNNING: + from email.message import Message + from typing import ( + Dict, List, Optional, Sequence, Tuple, IO, Text, Any, + Iterable, Callable, Set, + ) + + from pip._internal.models.scheme import Scheme + + InstalledCSVRow = Tuple[str, ...] + + +logger = logging.getLogger(__name__) + + +def normpath(src, p): + # type: (str, str) -> str + return os.path.relpath(src, p).replace(os.path.sep, '/') + + +def rehash(path, blocksize=1 << 20): + # type: (str, int) -> Tuple[str, str] + """Return (encoded_digest, length) for path using hashlib.sha256()""" + h, length = hash_file(path, blocksize) + digest = 'sha256=' + urlsafe_b64encode( + h.digest() + ).decode('latin1').rstrip('=') + # unicode/str python2 issues + return (digest, str(length)) # type: ignore + + +def open_for_csv(name, mode): + # type: (str, Text) -> IO[Any] + if sys.version_info[0] < 3: + nl = {} # type: Dict[str, Any] + bin = 'b' + else: + nl = {'newline': ''} # type: Dict[str, Any] + bin = '' + return open(name, mode + bin, **nl) + + +def fix_script(path): + # type: (str) -> Optional[bool] + """Replace #!python with #!/path/to/python + Return True if file was changed. + """ + # XXX RECORD hashes will need to be updated + if os.path.isfile(path): + with open(path, 'rb') as script: + firstline = script.readline() + if not firstline.startswith(b'#!python'): + return False + exename = sys.executable.encode(sys.getfilesystemencoding()) + firstline = b'#!' + exename + os.linesep.encode("ascii") + rest = script.read() + with open(path, 'wb') as script: + script.write(firstline) + script.write(rest) + return True + return None + + +def wheel_root_is_purelib(metadata): + # type: (Message) -> bool + return metadata.get("Root-Is-Purelib", "").lower() == "true" + + +def get_entrypoints(filename): + # type: (str) -> Tuple[Dict[str, str], Dict[str, str]] + if not os.path.exists(filename): + return {}, {} + + # This is done because you can pass a string to entry_points wrappers which + # means that they may or may not be valid INI files. The attempt here is to + # strip leading and trailing whitespace in order to make them valid INI + # files. + with open(filename) as fp: + data = StringIO() + for line in fp: + data.write(line.strip()) + data.write("\n") + data.seek(0) + + # get the entry points and then the script names + entry_points = pkg_resources.EntryPoint.parse_map(data) + console = entry_points.get('console_scripts', {}) + gui = entry_points.get('gui_scripts', {}) + + def _split_ep(s): + # type: (pkg_resources.EntryPoint) -> Tuple[str, str] + """get the string representation of EntryPoint, + remove space and split on '=' + """ + split_parts = str(s).replace(" ", "").split("=") + return split_parts[0], split_parts[1] + + # convert the EntryPoint objects into strings with module:function + console = dict(_split_ep(v) for v in console.values()) + gui = dict(_split_ep(v) for v in gui.values()) + return console, gui + + +def message_about_scripts_not_on_PATH(scripts): + # type: (Sequence[str]) -> Optional[str] + """Determine if any scripts are not on PATH and format a warning. + Returns a warning message if one or more scripts are not on PATH, + otherwise None. + """ + if not scripts: + return None + + # Group scripts by the path they were installed in + grouped_by_dir = collections.defaultdict(set) # type: Dict[str, Set[str]] + for destfile in scripts: + parent_dir = os.path.dirname(destfile) + script_name = os.path.basename(destfile) + grouped_by_dir[parent_dir].add(script_name) + + # We don't want to warn for directories that are on PATH. + not_warn_dirs = [ + os.path.normcase(i).rstrip(os.sep) for i in + os.environ.get("PATH", "").split(os.pathsep) + ] + # If an executable sits with sys.executable, we don't warn for it. + # This covers the case of venv invocations without activating the venv. + not_warn_dirs.append(os.path.normcase(os.path.dirname(sys.executable))) + warn_for = { + parent_dir: scripts for parent_dir, scripts in grouped_by_dir.items() + if os.path.normcase(parent_dir) not in not_warn_dirs + } # type: Dict[str, Set[str]] + if not warn_for: + return None + + # Format a message + msg_lines = [] + for parent_dir, dir_scripts in warn_for.items(): + sorted_scripts = sorted(dir_scripts) # type: List[str] + if len(sorted_scripts) == 1: + start_text = "script {} is".format(sorted_scripts[0]) + else: + start_text = "scripts {} are".format( + ", ".join(sorted_scripts[:-1]) + " and " + sorted_scripts[-1] + ) + + msg_lines.append( + "The {} installed in '{}' which is not on PATH." + .format(start_text, parent_dir) + ) + + last_line_fmt = ( + "Consider adding {} to PATH or, if you prefer " + "to suppress this warning, use --no-warn-script-location." + ) + if len(msg_lines) == 1: + msg_lines.append(last_line_fmt.format("this directory")) + else: + msg_lines.append(last_line_fmt.format("these directories")) + + # Add a note if any directory starts with ~ + warn_for_tilde = any( + i[0] == "~" for i in os.environ.get("PATH", "").split(os.pathsep) if i + ) + if warn_for_tilde: + tilde_warning_msg = ( + "NOTE: The current PATH contains path(s) starting with `~`, " + "which may not be expanded by all applications." + ) + msg_lines.append(tilde_warning_msg) + + # Returns the formatted multiline message + return "\n".join(msg_lines) + + +def sorted_outrows(outrows): + # type: (Iterable[InstalledCSVRow]) -> List[InstalledCSVRow] + """Return the given rows of a RECORD file in sorted order. + + Each row is a 3-tuple (path, hash, size) and corresponds to a record of + a RECORD file (see PEP 376 and PEP 427 for details). For the rows + passed to this function, the size can be an integer as an int or string, + or the empty string. + """ + # Normally, there should only be one row per path, in which case the + # second and third elements don't come into play when sorting. + # However, in cases in the wild where a path might happen to occur twice, + # we don't want the sort operation to trigger an error (but still want + # determinism). Since the third element can be an int or string, we + # coerce each element to a string to avoid a TypeError in this case. + # For additional background, see-- + # https://github.com/pypa/pip/issues/5868 + return sorted(outrows, key=lambda row: tuple(str(x) for x in row)) + + +def get_csv_rows_for_installed( + old_csv_rows, # type: Iterable[List[str]] + installed, # type: Dict[str, str] + changed, # type: Set[str] + generated, # type: List[str] + lib_dir, # type: str +): + # type: (...) -> List[InstalledCSVRow] + """ + :param installed: A map from archive RECORD path to installation RECORD + path. + """ + installed_rows = [] # type: List[InstalledCSVRow] + for row in old_csv_rows: + if len(row) > 3: + logger.warning( + 'RECORD line has more than three elements: {}'.format(row) + ) + # Make a copy because we are mutating the row. + row = list(row) + old_path = row[0] + new_path = installed.pop(old_path, old_path) + row[0] = new_path + if new_path in changed: + digest, length = rehash(new_path) + row[1] = digest + row[2] = length + installed_rows.append(tuple(row)) + for f in generated: + digest, length = rehash(f) + installed_rows.append((normpath(f, lib_dir), digest, str(length))) + for f in installed: + installed_rows.append((installed[f], '', '')) + return installed_rows + + +class MissingCallableSuffix(Exception): + pass + + +def _raise_for_invalid_entrypoint(specification): + # type: (str) -> None + entry = get_export_entry(specification) + if entry is not None and entry.suffix is None: + raise MissingCallableSuffix(str(entry)) + + +class PipScriptMaker(ScriptMaker): + def make(self, specification, options=None): + # type: (str, Dict[str, Any]) -> List[str] + _raise_for_invalid_entrypoint(specification) + return super(PipScriptMaker, self).make(specification, options) + + +def install_unpacked_wheel( + name, # type: str + wheeldir, # type: str + wheel_zip, # type: ZipFile + scheme, # type: Scheme + req_description, # type: str + pycompile=True, # type: bool + warn_script_location=True # type: bool +): + # type: (...) -> None + """Install a wheel. + + :param name: Name of the project to install + :param wheeldir: Base directory of the unpacked wheel + :param wheel_zip: open ZipFile for wheel being installed + :param scheme: Distutils scheme dictating the install directories + :param req_description: String used in place of the requirement, for + logging + :param pycompile: Whether to byte-compile installed Python files + :param warn_script_location: Whether to check that scripts are installed + into a directory on PATH + :raises UnsupportedWheel: + * when the directory holds an unpacked wheel with incompatible + Wheel-Version + * when the .dist-info dir does not match the wheel + """ + # TODO: Investigate and break this up. + # TODO: Look into moving this into a dedicated class for representing an + # installation. + + source = wheeldir.rstrip(os.path.sep) + os.path.sep + + info_dir, metadata = parse_wheel(wheel_zip, name) + + if wheel_root_is_purelib(metadata): + lib_dir = scheme.purelib + else: + lib_dir = scheme.platlib + + subdirs = os.listdir(source) + data_dirs = [s for s in subdirs if s.endswith('.data')] + + # Record details of the files moved + # installed = files copied from the wheel to the destination + # changed = files changed while installing (scripts #! line typically) + # generated = files newly generated during the install (script wrappers) + installed = {} # type: Dict[str, str] + changed = set() + generated = [] # type: List[str] + + # Compile all of the pyc files that we're going to be installing + if pycompile: + with captured_stdout() as stdout: + with warnings.catch_warnings(): + warnings.filterwarnings('ignore') + compileall.compile_dir(source, force=True, quiet=True) + logger.debug(stdout.getvalue()) + + def record_installed(srcfile, destfile, modified=False): + # type: (str, str, bool) -> None + """Map archive RECORD paths to installation RECORD paths.""" + oldpath = normpath(srcfile, wheeldir) + newpath = normpath(destfile, lib_dir) + installed[oldpath] = newpath + if modified: + changed.add(destfile) + + def clobber( + source, # type: str + dest, # type: str + is_base, # type: bool + fixer=None, # type: Optional[Callable[[str], Any]] + filter=None # type: Optional[Callable[[str], bool]] + ): + # type: (...) -> None + ensure_dir(dest) # common for the 'include' path + + for dir, subdirs, files in os.walk(source): + basedir = dir[len(source):].lstrip(os.path.sep) + destdir = os.path.join(dest, basedir) + if is_base and basedir == '': + subdirs[:] = [s for s in subdirs if not s.endswith('.data')] + for f in files: + # Skip unwanted files + if filter and filter(f): + continue + srcfile = os.path.join(dir, f) + destfile = os.path.join(dest, basedir, f) + # directory creation is lazy and after the file filtering above + # to ensure we don't install empty dirs; empty dirs can't be + # uninstalled. + ensure_dir(destdir) + + # copyfile (called below) truncates the destination if it + # exists and then writes the new contents. This is fine in most + # cases, but can cause a segfault if pip has loaded a shared + # object (e.g. from pyopenssl through its vendored urllib3) + # Since the shared object is mmap'd an attempt to call a + # symbol in it will then cause a segfault. Unlinking the file + # allows writing of new contents while allowing the process to + # continue to use the old copy. + if os.path.exists(destfile): + os.unlink(destfile) + + # We use copyfile (not move, copy, or copy2) to be extra sure + # that we are not moving directories over (copyfile fails for + # directories) as well as to ensure that we are not copying + # over any metadata because we want more control over what + # metadata we actually copy over. + shutil.copyfile(srcfile, destfile) + + # Copy over the metadata for the file, currently this only + # includes the atime and mtime. + st = os.stat(srcfile) + if hasattr(os, "utime"): + os.utime(destfile, (st.st_atime, st.st_mtime)) + + # If our file is executable, then make our destination file + # executable. + if os.access(srcfile, os.X_OK): + st = os.stat(srcfile) + permissions = ( + st.st_mode | stat.S_IXUSR | stat.S_IXGRP | stat.S_IXOTH + ) + os.chmod(destfile, permissions) + + changed = False + if fixer: + changed = fixer(destfile) + record_installed(srcfile, destfile, changed) + + clobber(source, lib_dir, True) + + dest_info_dir = os.path.join(lib_dir, info_dir) + + # Get the defined entry points + ep_file = os.path.join(dest_info_dir, 'entry_points.txt') + console, gui = get_entrypoints(ep_file) + + def is_entrypoint_wrapper(name): + # type: (str) -> bool + # EP, EP.exe and EP-script.py are scripts generated for + # entry point EP by setuptools + if name.lower().endswith('.exe'): + matchname = name[:-4] + elif name.lower().endswith('-script.py'): + matchname = name[:-10] + elif name.lower().endswith(".pya"): + matchname = name[:-4] + else: + matchname = name + # Ignore setuptools-generated scripts + return (matchname in console or matchname in gui) + + for datadir in data_dirs: + fixer = None + filter = None + for subdir in os.listdir(os.path.join(wheeldir, datadir)): + fixer = None + if subdir == 'scripts': + fixer = fix_script + filter = is_entrypoint_wrapper + source = os.path.join(wheeldir, datadir, subdir) + dest = getattr(scheme, subdir) + clobber(source, dest, False, fixer=fixer, filter=filter) + + maker = PipScriptMaker(None, scheme.scripts) + + # Ensure old scripts are overwritten. + # See https://github.com/pypa/pip/issues/1800 + maker.clobber = True + + # Ensure we don't generate any variants for scripts because this is almost + # never what somebody wants. + # See https://bitbucket.org/pypa/distlib/issue/35/ + maker.variants = {''} + + # This is required because otherwise distlib creates scripts that are not + # executable. + # See https://bitbucket.org/pypa/distlib/issue/32/ + maker.set_mode = True + + scripts_to_generate = [] + + # Special case pip and setuptools to generate versioned wrappers + # + # The issue is that some projects (specifically, pip and setuptools) use + # code in setup.py to create "versioned" entry points - pip2.7 on Python + # 2.7, pip3.3 on Python 3.3, etc. But these entry points are baked into + # the wheel metadata at build time, and so if the wheel is installed with + # a *different* version of Python the entry points will be wrong. The + # correct fix for this is to enhance the metadata to be able to describe + # such versioned entry points, but that won't happen till Metadata 2.0 is + # available. + # In the meantime, projects using versioned entry points will either have + # incorrect versioned entry points, or they will not be able to distribute + # "universal" wheels (i.e., they will need a wheel per Python version). + # + # Because setuptools and pip are bundled with _ensurepip and virtualenv, + # we need to use universal wheels. So, as a stopgap until Metadata 2.0, we + # override the versioned entry points in the wheel and generate the + # correct ones. This code is purely a short-term measure until Metadata 2.0 + # is available. + # + # To add the level of hack in this section of code, in order to support + # ensurepip this code will look for an ``ENSUREPIP_OPTIONS`` environment + # variable which will control which version scripts get installed. + # + # ENSUREPIP_OPTIONS=altinstall + # - Only pipX.Y and easy_install-X.Y will be generated and installed + # ENSUREPIP_OPTIONS=install + # - pipX.Y, pipX, easy_install-X.Y will be generated and installed. Note + # that this option is technically if ENSUREPIP_OPTIONS is set and is + # not altinstall + # DEFAULT + # - The default behavior is to install pip, pipX, pipX.Y, easy_install + # and easy_install-X.Y. + pip_script = console.pop('pip', None) + if pip_script: + if "ENSUREPIP_OPTIONS" not in os.environ: + scripts_to_generate.append('pip = ' + pip_script) + + if os.environ.get("ENSUREPIP_OPTIONS", "") != "altinstall": + scripts_to_generate.append( + 'pip%s = %s' % (sys.version_info[0], pip_script) + ) + + scripts_to_generate.append( + 'pip%s = %s' % (get_major_minor_version(), pip_script) + ) + # Delete any other versioned pip entry points + pip_ep = [k for k in console if re.match(r'pip(\d(\.\d)?)?$', k)] + for k in pip_ep: + del console[k] + easy_install_script = console.pop('easy_install', None) + if easy_install_script: + if "ENSUREPIP_OPTIONS" not in os.environ: + scripts_to_generate.append( + 'easy_install = ' + easy_install_script + ) + + scripts_to_generate.append( + 'easy_install-%s = %s' % ( + get_major_minor_version(), easy_install_script + ) + ) + # Delete any other versioned easy_install entry points + easy_install_ep = [ + k for k in console if re.match(r'easy_install(-\d\.\d)?$', k) + ] + for k in easy_install_ep: + del console[k] + + # Generate the console and GUI entry points specified in the wheel + scripts_to_generate.extend( + '%s = %s' % kv for kv in console.items() + ) + + gui_scripts_to_generate = [ + '%s = %s' % kv for kv in gui.items() + ] + + generated_console_scripts = [] # type: List[str] + + try: + generated_console_scripts = maker.make_multiple(scripts_to_generate) + generated.extend(generated_console_scripts) + + generated.extend( + maker.make_multiple(gui_scripts_to_generate, {'gui': True}) + ) + except MissingCallableSuffix as e: + entry = e.args[0] + raise InstallationError( + "Invalid script entry point: {} for req: {} - A callable " + "suffix is required. Cf https://packaging.python.org/" + "specifications/entry-points/#use-for-scripts for more " + "information.".format(entry, req_description) + ) + + if warn_script_location: + msg = message_about_scripts_not_on_PATH(generated_console_scripts) + if msg is not None: + logger.warning(msg) + + # Record pip as the installer + installer = os.path.join(dest_info_dir, 'INSTALLER') + temp_installer = os.path.join(dest_info_dir, 'INSTALLER.pip') + with open(temp_installer, 'wb') as installer_file: + installer_file.write(b'pip\n') + shutil.move(temp_installer, installer) + generated.append(installer) + + # Record details of all files installed + record = os.path.join(dest_info_dir, 'RECORD') + temp_record = os.path.join(dest_info_dir, 'RECORD.pip') + with open_for_csv(record, 'r') as record_in: + with open_for_csv(temp_record, 'w+') as record_out: + reader = csv.reader(record_in) + outrows = get_csv_rows_for_installed( + reader, installed=installed, changed=changed, + generated=generated, lib_dir=lib_dir, + ) + writer = csv.writer(record_out) + # Sort to simplify testing. + for row in sorted_outrows(outrows): + writer.writerow(row) + shutil.move(temp_record, record) + + +def install_wheel( + name, # type: str + wheel_path, # type: str + scheme, # type: Scheme + req_description, # type: str + pycompile=True, # type: bool + warn_script_location=True, # type: bool + _temp_dir_for_testing=None, # type: Optional[str] +): + # type: (...) -> None + with TempDirectory( + path=_temp_dir_for_testing, kind="unpacked-wheel" + ) as unpacked_dir, ZipFile(wheel_path, allowZip64=True) as z: + unpack_file(wheel_path, unpacked_dir.path) + install_unpacked_wheel( + name=name, + wheeldir=unpacked_dir.path, + wheel_zip=z, + scheme=scheme, + req_description=req_description, + pycompile=pycompile, + warn_script_location=warn_script_location, + ) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/operations/prepare.py b/venv/lib/python3.8/site-packages/pip/_internal/operations/prepare.py new file mode 100644 index 000000000..0b61f2052 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/operations/prepare.py @@ -0,0 +1,591 @@ +"""Prepares a distribution for installation +""" + +# The following comment should be removed at some point in the future. +# mypy: strict-optional=False + +import logging +import mimetypes +import os +import shutil +import sys + +from pip._vendor import requests +from pip._vendor.six import PY2 + +from pip._internal.distributions import ( + make_distribution_for_install_requirement, +) +from pip._internal.distributions.installed import InstalledDistribution +from pip._internal.exceptions import ( + DirectoryUrlHashUnsupported, + HashMismatch, + HashUnpinned, + InstallationError, + PreviousBuildDirError, + VcsHashUnsupported, +) +from pip._internal.utils.filesystem import copy2_fixed +from pip._internal.utils.hashes import MissingHashes +from pip._internal.utils.logging import indent_log +from pip._internal.utils.marker_files import write_delete_marker_file +from pip._internal.utils.misc import ( + ask_path_exists, + backup_dir, + display_path, + hide_url, + path_to_display, + rmtree, +) +from pip._internal.utils.temp_dir import TempDirectory +from pip._internal.utils.typing import MYPY_CHECK_RUNNING +from pip._internal.utils.unpacking import unpack_file +from pip._internal.vcs import vcs + +if MYPY_CHECK_RUNNING: + from typing import ( + Callable, List, Optional, Tuple, + ) + + from mypy_extensions import TypedDict + + from pip._internal.distributions import AbstractDistribution + from pip._internal.index.package_finder import PackageFinder + from pip._internal.models.link import Link + from pip._internal.network.download import Downloader + from pip._internal.req.req_install import InstallRequirement + from pip._internal.req.req_tracker import RequirementTracker + from pip._internal.utils.hashes import Hashes + + if PY2: + CopytreeKwargs = TypedDict( + 'CopytreeKwargs', + { + 'ignore': Callable[[str, List[str]], List[str]], + 'symlinks': bool, + }, + total=False, + ) + else: + CopytreeKwargs = TypedDict( + 'CopytreeKwargs', + { + 'copy_function': Callable[[str, str], None], + 'ignore': Callable[[str, List[str]], List[str]], + 'ignore_dangling_symlinks': bool, + 'symlinks': bool, + }, + total=False, + ) + +logger = logging.getLogger(__name__) + + +def _get_prepared_distribution( + req, # type: InstallRequirement + req_tracker, # type: RequirementTracker + finder, # type: PackageFinder + build_isolation # type: bool +): + # type: (...) -> AbstractDistribution + """Prepare a distribution for installation. + """ + abstract_dist = make_distribution_for_install_requirement(req) + with req_tracker.track(req): + abstract_dist.prepare_distribution_metadata(finder, build_isolation) + return abstract_dist + + +def unpack_vcs_link(link, location): + # type: (Link, str) -> None + vcs_backend = vcs.get_backend_for_scheme(link.scheme) + assert vcs_backend is not None + vcs_backend.unpack(location, url=hide_url(link.url)) + + +def _copy_file(filename, location, link): + # type: (str, str, Link) -> None + copy = True + download_location = os.path.join(location, link.filename) + if os.path.exists(download_location): + response = ask_path_exists( + 'The file {} exists. (i)gnore, (w)ipe, (b)ackup, (a)abort'.format( + display_path(download_location) + ), + ('i', 'w', 'b', 'a'), + ) + if response == 'i': + copy = False + elif response == 'w': + logger.warning('Deleting %s', display_path(download_location)) + os.remove(download_location) + elif response == 'b': + dest_file = backup_dir(download_location) + logger.warning( + 'Backing up %s to %s', + display_path(download_location), + display_path(dest_file), + ) + shutil.move(download_location, dest_file) + elif response == 'a': + sys.exit(-1) + if copy: + shutil.copy(filename, download_location) + logger.info('Saved %s', display_path(download_location)) + + +def unpack_http_url( + link, # type: Link + location, # type: str + downloader, # type: Downloader + download_dir=None, # type: Optional[str] + hashes=None, # type: Optional[Hashes] +): + # type: (...) -> str + temp_dir = TempDirectory(kind="unpack", globally_managed=True) + # If a download dir is specified, is the file already downloaded there? + already_downloaded_path = None + if download_dir: + already_downloaded_path = _check_download_dir( + link, download_dir, hashes + ) + + if already_downloaded_path: + from_path = already_downloaded_path + content_type = mimetypes.guess_type(from_path)[0] + else: + # let's download to a tmp dir + from_path, content_type = _download_http_url( + link, downloader, temp_dir.path, hashes + ) + + # unpack the archive to the build dir location. even when only + # downloading archives, they have to be unpacked to parse dependencies + unpack_file(from_path, location, content_type) + + return from_path + + +def _copy2_ignoring_special_files(src, dest): + # type: (str, str) -> None + """Copying special files is not supported, but as a convenience to users + we skip errors copying them. This supports tools that may create e.g. + socket files in the project source directory. + """ + try: + copy2_fixed(src, dest) + except shutil.SpecialFileError as e: + # SpecialFileError may be raised due to either the source or + # destination. If the destination was the cause then we would actually + # care, but since the destination directory is deleted prior to + # copy we ignore all of them assuming it is caused by the source. + logger.warning( + "Ignoring special file error '%s' encountered copying %s to %s.", + str(e), + path_to_display(src), + path_to_display(dest), + ) + + +def _copy_source_tree(source, target): + # type: (str, str) -> None + def ignore(d, names): + # type: (str, List[str]) -> List[str] + # Pulling in those directories can potentially be very slow, + # exclude the following directories if they appear in the top + # level dir (and only it). + # See discussion at https://github.com/pypa/pip/pull/6770 + return ['.tox', '.nox'] if d == source else [] + + kwargs = dict(ignore=ignore, symlinks=True) # type: CopytreeKwargs + + if not PY2: + # Python 2 does not support copy_function, so we only ignore + # errors on special file copy in Python 3. + kwargs['copy_function'] = _copy2_ignoring_special_files + + shutil.copytree(source, target, **kwargs) + + +def unpack_file_url( + link, # type: Link + location, # type: str + download_dir=None, # type: Optional[str] + hashes=None # type: Optional[Hashes] +): + # type: (...) -> Optional[str] + """Unpack link into location. + """ + link_path = link.file_path + # If it's a url to a local directory + if link.is_existing_dir(): + if os.path.isdir(location): + rmtree(location) + _copy_source_tree(link_path, location) + return None + + # If a download dir is specified, is the file already there and valid? + already_downloaded_path = None + if download_dir: + already_downloaded_path = _check_download_dir( + link, download_dir, hashes + ) + + if already_downloaded_path: + from_path = already_downloaded_path + else: + from_path = link_path + + # If --require-hashes is off, `hashes` is either empty, the + # link's embedded hash, or MissingHashes; it is required to + # match. If --require-hashes is on, we are satisfied by any + # hash in `hashes` matching: a URL-based or an option-based + # one; no internet-sourced hash will be in `hashes`. + if hashes: + hashes.check_against_path(from_path) + + content_type = mimetypes.guess_type(from_path)[0] + + # unpack the archive to the build dir location. even when only downloading + # archives, they have to be unpacked to parse dependencies + unpack_file(from_path, location, content_type) + + return from_path + + +def unpack_url( + link, # type: Link + location, # type: str + downloader, # type: Downloader + download_dir=None, # type: Optional[str] + hashes=None, # type: Optional[Hashes] +): + # type: (...) -> Optional[str] + """Unpack link into location, downloading if required. + + :param hashes: A Hashes object, one of whose embedded hashes must match, + or HashMismatch will be raised. If the Hashes is empty, no matches are + required, and unhashable types of requirements (like VCS ones, which + would ordinarily raise HashUnsupported) are allowed. + """ + # non-editable vcs urls + if link.is_vcs: + unpack_vcs_link(link, location) + return None + + # file urls + elif link.is_file: + return unpack_file_url(link, location, download_dir, hashes=hashes) + + # http urls + else: + return unpack_http_url( + link, + location, + downloader, + download_dir, + hashes=hashes, + ) + + +def _download_http_url( + link, # type: Link + downloader, # type: Downloader + temp_dir, # type: str + hashes, # type: Optional[Hashes] +): + # type: (...) -> Tuple[str, str] + """Download link url into temp_dir using provided session""" + download = downloader(link) + + file_path = os.path.join(temp_dir, download.filename) + with open(file_path, 'wb') as content_file: + for chunk in download.chunks: + content_file.write(chunk) + + if hashes: + hashes.check_against_path(file_path) + + return file_path, download.response.headers.get('content-type', '') + + +def _check_download_dir(link, download_dir, hashes): + # type: (Link, str, Optional[Hashes]) -> Optional[str] + """ Check download_dir for previously downloaded file with correct hash + If a correct file is found return its path else None + """ + download_path = os.path.join(download_dir, link.filename) + + if not os.path.exists(download_path): + return None + + # If already downloaded, does its hash match? + logger.info('File was already downloaded %s', download_path) + if hashes: + try: + hashes.check_against_path(download_path) + except HashMismatch: + logger.warning( + 'Previously-downloaded file %s has bad hash. ' + 'Re-downloading.', + download_path + ) + os.unlink(download_path) + return None + return download_path + + +class RequirementPreparer(object): + """Prepares a Requirement + """ + + def __init__( + self, + build_dir, # type: str + download_dir, # type: Optional[str] + src_dir, # type: str + wheel_download_dir, # type: Optional[str] + build_isolation, # type: bool + req_tracker, # type: RequirementTracker + downloader, # type: Downloader + finder, # type: PackageFinder + require_hashes, # type: bool + use_user_site, # type: bool + ): + # type: (...) -> None + super(RequirementPreparer, self).__init__() + + self.src_dir = src_dir + self.build_dir = build_dir + self.req_tracker = req_tracker + self.downloader = downloader + self.finder = finder + + # Where still-packed archives should be written to. If None, they are + # not saved, and are deleted immediately after unpacking. + self.download_dir = download_dir + + # Where still-packed .whl files should be written to. If None, they are + # written to the download_dir parameter. Separate to download_dir to + # permit only keeping wheel archives for pip wheel. + self.wheel_download_dir = wheel_download_dir + + # NOTE + # download_dir and wheel_download_dir overlap semantically and may + # be combined if we're willing to have non-wheel archives present in + # the wheelhouse output by 'pip wheel'. + + # Is build isolation allowed? + self.build_isolation = build_isolation + + # Should hash-checking be required? + self.require_hashes = require_hashes + + # Should install in user site-packages? + self.use_user_site = use_user_site + + @property + def _download_should_save(self): + # type: () -> bool + if not self.download_dir: + return False + + if os.path.exists(self.download_dir): + return True + + logger.critical('Could not find download directory') + raise InstallationError( + "Could not find or access download directory '{}'" + .format(self.download_dir)) + + def prepare_linked_requirement( + self, + req, # type: InstallRequirement + ): + # type: (...) -> AbstractDistribution + """Prepare a requirement that would be obtained from req.link + """ + assert req.link + link = req.link + + # TODO: Breakup into smaller functions + if link.scheme == 'file': + path = link.file_path + logger.info('Processing %s', display_path(path)) + else: + logger.info('Collecting %s', req.req or req) + + with indent_log(): + # @@ if filesystem packages are not marked + # editable in a req, a non deterministic error + # occurs when the script attempts to unpack the + # build directory + # Since source_dir is only set for editable requirements. + assert req.source_dir is None + req.ensure_has_source_dir(self.build_dir) + # If a checkout exists, it's unwise to keep going. version + # inconsistencies are logged later, but do not fail the + # installation. + # FIXME: this won't upgrade when there's an existing + # package unpacked in `req.source_dir` + if os.path.exists(os.path.join(req.source_dir, 'setup.py')): + raise PreviousBuildDirError( + "pip can't proceed with requirements '{}' due to a" + " pre-existing build directory ({}). This is " + "likely due to a previous installation that failed" + ". pip is being responsible and not assuming it " + "can delete this. Please delete it and try again." + .format(req, req.source_dir) + ) + + # Now that we have the real link, we can tell what kind of + # requirements we have and raise some more informative errors + # than otherwise. (For example, we can raise VcsHashUnsupported + # for a VCS URL rather than HashMissing.) + if self.require_hashes: + # We could check these first 2 conditions inside + # unpack_url and save repetition of conditions, but then + # we would report less-useful error messages for + # unhashable requirements, complaining that there's no + # hash provided. + if link.is_vcs: + raise VcsHashUnsupported() + elif link.is_existing_dir(): + raise DirectoryUrlHashUnsupported() + if not req.original_link and not req.is_pinned: + # Unpinned packages are asking for trouble when a new + # version is uploaded. This isn't a security check, but + # it saves users a surprising hash mismatch in the + # future. + # + # file:/// URLs aren't pinnable, so don't complain + # about them not being pinned. + raise HashUnpinned() + + hashes = req.hashes(trust_internet=not self.require_hashes) + if self.require_hashes and not hashes: + # Known-good hashes are missing for this requirement, so + # shim it with a facade object that will provoke hash + # computation and then raise a HashMissing exception + # showing the user what the hash should be. + hashes = MissingHashes() + + download_dir = self.download_dir + if link.is_wheel and self.wheel_download_dir: + # when doing 'pip wheel` we download wheels to a + # dedicated dir. + download_dir = self.wheel_download_dir + + try: + local_path = unpack_url( + link, req.source_dir, self.downloader, download_dir, + hashes=hashes, + ) + except requests.HTTPError as exc: + logger.critical( + 'Could not install requirement %s because of error %s', + req, + exc, + ) + raise InstallationError( + 'Could not install requirement {} because of HTTP ' + 'error {} for URL {}'.format(req, exc, link) + ) + + # For use in later processing, preserve the file path on the + # requirement. + if local_path: + req.local_file_path = local_path + + if link.is_wheel: + if download_dir: + # When downloading, we only unpack wheels to get + # metadata. + autodelete_unpacked = True + else: + # When installing a wheel, we use the unpacked + # wheel. + autodelete_unpacked = False + else: + # We always delete unpacked sdists after pip runs. + autodelete_unpacked = True + if autodelete_unpacked: + write_delete_marker_file(req.source_dir) + + abstract_dist = _get_prepared_distribution( + req, self.req_tracker, self.finder, self.build_isolation, + ) + + if download_dir: + if link.is_existing_dir(): + logger.info('Link is a directory, ignoring download_dir') + elif local_path and not os.path.exists( + os.path.join(download_dir, link.filename) + ): + _copy_file(local_path, download_dir, link) + + if self._download_should_save: + # Make a .zip of the source_dir we already created. + if link.is_vcs: + req.archive(self.download_dir) + return abstract_dist + + def prepare_editable_requirement( + self, + req, # type: InstallRequirement + ): + # type: (...) -> AbstractDistribution + """Prepare an editable requirement + """ + assert req.editable, "cannot prepare a non-editable req as editable" + + logger.info('Obtaining %s', req) + + with indent_log(): + if self.require_hashes: + raise InstallationError( + 'The editable requirement {} cannot be installed when ' + 'requiring hashes, because there is no single file to ' + 'hash.'.format(req) + ) + req.ensure_has_source_dir(self.src_dir) + req.update_editable(not self._download_should_save) + + abstract_dist = _get_prepared_distribution( + req, self.req_tracker, self.finder, self.build_isolation, + ) + + if self._download_should_save: + req.archive(self.download_dir) + req.check_if_exists(self.use_user_site) + + return abstract_dist + + def prepare_installed_requirement( + self, + req, # type: InstallRequirement + skip_reason # type: str + ): + # type: (...) -> AbstractDistribution + """Prepare an already-installed requirement + """ + assert req.satisfied_by, "req should have been satisfied but isn't" + assert skip_reason is not None, ( + "did not get skip reason skipped but req.satisfied_by " + "is set to {}".format(req.satisfied_by) + ) + logger.info( + 'Requirement %s: %s (%s)', + skip_reason, req, req.satisfied_by.version + ) + with indent_log(): + if self.require_hashes: + logger.debug( + 'Since it is already installed, we are trusting this ' + 'package without checking its hash. To ensure a ' + 'completely repeatable environment, install into an ' + 'empty virtualenv.' + ) + abstract_dist = InstalledDistribution(req) + + return abstract_dist diff --git a/venv/lib/python3.8/site-packages/pip/_internal/pep425tags.py b/venv/lib/python3.8/site-packages/pip/_internal/pep425tags.py new file mode 100644 index 000000000..a2386ee75 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/pep425tags.py @@ -0,0 +1,167 @@ +"""Generate and work with PEP 425 Compatibility Tags.""" +from __future__ import absolute_import + +import logging +import re + +from pip._vendor.packaging.tags import ( + Tag, + compatible_tags, + cpython_tags, + generic_tags, + interpreter_name, + interpreter_version, + mac_platforms, +) + +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import List, Optional, Tuple + + from pip._vendor.packaging.tags import PythonVersion + +logger = logging.getLogger(__name__) + +_osx_arch_pat = re.compile(r'(.+)_(\d+)_(\d+)_(.+)') + + +def version_info_to_nodot(version_info): + # type: (Tuple[int, ...]) -> str + # Only use up to the first two numbers. + return ''.join(map(str, version_info[:2])) + + +def _mac_platforms(arch): + # type: (str) -> List[str] + match = _osx_arch_pat.match(arch) + if match: + name, major, minor, actual_arch = match.groups() + mac_version = (int(major), int(minor)) + arches = [ + # Since we have always only checked that the platform starts + # with "macosx", for backwards-compatibility we extract the + # actual prefix provided by the user in case they provided + # something like "macosxcustom_". It may be good to remove + # this as undocumented or deprecate it in the future. + '{}_{}'.format(name, arch[len('macosx_'):]) + for arch in mac_platforms(mac_version, actual_arch) + ] + else: + # arch pattern didn't match (?!) + arches = [arch] + return arches + + +def _custom_manylinux_platforms(arch): + # type: (str) -> List[str] + arches = [arch] + arch_prefix, arch_sep, arch_suffix = arch.partition('_') + if arch_prefix == 'manylinux2014': + # manylinux1/manylinux2010 wheels run on most manylinux2014 systems + # with the exception of wheels depending on ncurses. PEP 599 states + # manylinux1/manylinux2010 wheels should be considered + # manylinux2014 wheels: + # https://www.python.org/dev/peps/pep-0599/#backwards-compatibility-with-manylinux2010-wheels + if arch_suffix in {'i686', 'x86_64'}: + arches.append('manylinux2010' + arch_sep + arch_suffix) + arches.append('manylinux1' + arch_sep + arch_suffix) + elif arch_prefix == 'manylinux2010': + # manylinux1 wheels run on most manylinux2010 systems with the + # exception of wheels depending on ncurses. PEP 571 states + # manylinux1 wheels should be considered manylinux2010 wheels: + # https://www.python.org/dev/peps/pep-0571/#backwards-compatibility-with-manylinux1-wheels + arches.append('manylinux1' + arch_sep + arch_suffix) + return arches + + +def _get_custom_platforms(arch): + # type: (str) -> List[str] + arch_prefix, arch_sep, arch_suffix = arch.partition('_') + if arch.startswith('macosx'): + arches = _mac_platforms(arch) + elif arch_prefix in ['manylinux2014', 'manylinux2010']: + arches = _custom_manylinux_platforms(arch) + else: + arches = [arch] + return arches + + +def _get_python_version(version): + # type: (str) -> PythonVersion + if len(version) > 1: + return int(version[0]), int(version[1:]) + else: + return (int(version[0]),) + + +def _get_custom_interpreter(implementation=None, version=None): + # type: (Optional[str], Optional[str]) -> str + if implementation is None: + implementation = interpreter_name() + if version is None: + version = interpreter_version() + return "{}{}".format(implementation, version) + + +def get_supported( + version=None, # type: Optional[str] + platform=None, # type: Optional[str] + impl=None, # type: Optional[str] + abi=None # type: Optional[str] +): + # type: (...) -> List[Tag] + """Return a list of supported tags for each version specified in + `versions`. + + :param version: a string version, of the form "33" or "32", + or None. The version will be assumed to support our ABI. + :param platform: specify the exact platform you want valid + tags for, or None. If None, use the local system platform. + :param impl: specify the exact implementation you want valid + tags for, or None. If None, use the local interpreter impl. + :param abi: specify the exact abi you want valid + tags for, or None. If None, use the local interpreter abi. + """ + supported = [] # type: List[Tag] + + python_version = None # type: Optional[PythonVersion] + if version is not None: + python_version = _get_python_version(version) + + interpreter = _get_custom_interpreter(impl, version) + + abis = None # type: Optional[List[str]] + if abi is not None: + abis = [abi] + + platforms = None # type: Optional[List[str]] + if platform is not None: + platforms = _get_custom_platforms(platform) + + is_cpython = (impl or interpreter_name()) == "cp" + if is_cpython: + supported.extend( + cpython_tags( + python_version=python_version, + abis=abis, + platforms=platforms, + ) + ) + else: + supported.extend( + generic_tags( + interpreter=interpreter, + abis=abis, + platforms=platforms, + ) + ) + supported.extend( + compatible_tags( + python_version=python_version, + interpreter=interpreter, + platforms=platforms, + ) + ) + + return supported diff --git a/venv/lib/python3.8/site-packages/pip/_internal/pyproject.py b/venv/lib/python3.8/site-packages/pip/_internal/pyproject.py new file mode 100644 index 000000000..6b4faf7a7 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/pyproject.py @@ -0,0 +1,196 @@ +from __future__ import absolute_import + +import io +import os +import sys +from collections import namedtuple + +from pip._vendor import six, toml +from pip._vendor.packaging.requirements import InvalidRequirement, Requirement + +from pip._internal.exceptions import InstallationError +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import Any, Optional, List + + +def _is_list_of_str(obj): + # type: (Any) -> bool + return ( + isinstance(obj, list) and + all(isinstance(item, six.string_types) for item in obj) + ) + + +def make_pyproject_path(unpacked_source_directory): + # type: (str) -> str + path = os.path.join(unpacked_source_directory, 'pyproject.toml') + + # Python2 __file__ should not be unicode + if six.PY2 and isinstance(path, six.text_type): + path = path.encode(sys.getfilesystemencoding()) + + return path + + +BuildSystemDetails = namedtuple('BuildSystemDetails', [ + 'requires', 'backend', 'check', 'backend_path' +]) + + +def load_pyproject_toml( + use_pep517, # type: Optional[bool] + pyproject_toml, # type: str + setup_py, # type: str + req_name # type: str +): + # type: (...) -> Optional[BuildSystemDetails] + """Load the pyproject.toml file. + + Parameters: + use_pep517 - Has the user requested PEP 517 processing? None + means the user hasn't explicitly specified. + pyproject_toml - Location of the project's pyproject.toml file + setup_py - Location of the project's setup.py file + req_name - The name of the requirement we're processing (for + error reporting) + + Returns: + None if we should use the legacy code path, otherwise a tuple + ( + requirements from pyproject.toml, + name of PEP 517 backend, + requirements we should check are installed after setting + up the build environment + directory paths to import the backend from (backend-path), + relative to the project root. + ) + """ + has_pyproject = os.path.isfile(pyproject_toml) + has_setup = os.path.isfile(setup_py) + + if has_pyproject: + with io.open(pyproject_toml, encoding="utf-8") as f: + pp_toml = toml.load(f) + build_system = pp_toml.get("build-system") + else: + build_system = None + + # The following cases must use PEP 517 + # We check for use_pep517 being non-None and falsey because that means + # the user explicitly requested --no-use-pep517. The value 0 as + # opposed to False can occur when the value is provided via an + # environment variable or config file option (due to the quirk of + # strtobool() returning an integer in pip's configuration code). + if has_pyproject and not has_setup: + if use_pep517 is not None and not use_pep517: + raise InstallationError( + "Disabling PEP 517 processing is invalid: " + "project does not have a setup.py" + ) + use_pep517 = True + elif build_system and "build-backend" in build_system: + if use_pep517 is not None and not use_pep517: + raise InstallationError( + "Disabling PEP 517 processing is invalid: " + "project specifies a build backend of {} " + "in pyproject.toml".format( + build_system["build-backend"] + ) + ) + use_pep517 = True + + # If we haven't worked out whether to use PEP 517 yet, + # and the user hasn't explicitly stated a preference, + # we do so if the project has a pyproject.toml file. + elif use_pep517 is None: + use_pep517 = has_pyproject + + # At this point, we know whether we're going to use PEP 517. + assert use_pep517 is not None + + # If we're using the legacy code path, there is nothing further + # for us to do here. + if not use_pep517: + return None + + if build_system is None: + # Either the user has a pyproject.toml with no build-system + # section, or the user has no pyproject.toml, but has opted in + # explicitly via --use-pep517. + # In the absence of any explicit backend specification, we + # assume the setuptools backend that most closely emulates the + # traditional direct setup.py execution, and require wheel and + # a version of setuptools that supports that backend. + + build_system = { + "requires": ["setuptools>=40.8.0", "wheel"], + "build-backend": "setuptools.build_meta:__legacy__", + } + + # If we're using PEP 517, we have build system information (either + # from pyproject.toml, or defaulted by the code above). + # Note that at this point, we do not know if the user has actually + # specified a backend, though. + assert build_system is not None + + # Ensure that the build-system section in pyproject.toml conforms + # to PEP 518. + error_template = ( + "{package} has a pyproject.toml file that does not comply " + "with PEP 518: {reason}" + ) + + # Specifying the build-system table but not the requires key is invalid + if "requires" not in build_system: + raise InstallationError( + error_template.format(package=req_name, reason=( + "it has a 'build-system' table but not " + "'build-system.requires' which is mandatory in the table" + )) + ) + + # Error out if requires is not a list of strings + requires = build_system["requires"] + if not _is_list_of_str(requires): + raise InstallationError(error_template.format( + package=req_name, + reason="'build-system.requires' is not a list of strings.", + )) + + # Each requirement must be valid as per PEP 508 + for requirement in requires: + try: + Requirement(requirement) + except InvalidRequirement: + raise InstallationError( + error_template.format( + package=req_name, + reason=( + "'build-system.requires' contains an invalid " + "requirement: {!r}".format(requirement) + ), + ) + ) + + backend = build_system.get("build-backend") + backend_path = build_system.get("backend-path", []) + check = [] # type: List[str] + if backend is None: + # If the user didn't specify a backend, we assume they want to use + # the setuptools backend. But we can't be sure they have included + # a version of setuptools which supplies the backend, or wheel + # (which is needed by the backend) in their requirements. So we + # make a note to check that those requirements are present once + # we have set up the environment. + # This is quite a lot of work to check for a very specific case. But + # the problem is, that case is potentially quite common - projects that + # adopted PEP 518 early for the ability to specify requirements to + # execute setup.py, but never considered needing to mention the build + # tools themselves. The original PEP 518 code had a similar check (but + # implemented in a different way). + backend = "setuptools.build_meta:__legacy__" + check = ["setuptools>=40.8.0", "wheel"] + + return BuildSystemDetails(requires, backend, check, backend_path) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/req/__init__.py b/venv/lib/python3.8/site-packages/pip/_internal/req/__init__.py new file mode 100644 index 000000000..d2d027ade --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/req/__init__.py @@ -0,0 +1,92 @@ +# The following comment should be removed at some point in the future. +# mypy: strict-optional=False + +from __future__ import absolute_import + +import logging + +from pip._internal.utils.logging import indent_log +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +from .req_file import parse_requirements +from .req_install import InstallRequirement +from .req_set import RequirementSet + +if MYPY_CHECK_RUNNING: + from typing import Any, List, Sequence + +__all__ = [ + "RequirementSet", "InstallRequirement", + "parse_requirements", "install_given_reqs", +] + +logger = logging.getLogger(__name__) + + +class InstallationResult(object): + def __init__(self, name): + # type: (str) -> None + self.name = name + + def __repr__(self): + # type: () -> str + return "InstallationResult(name={!r})".format(self.name) + + +def install_given_reqs( + to_install, # type: List[InstallRequirement] + install_options, # type: List[str] + global_options=(), # type: Sequence[str] + *args, # type: Any + **kwargs # type: Any +): + # type: (...) -> List[InstallationResult] + """ + Install everything in the given list. + + (to be called after having downloaded and unpacked the packages) + """ + + if to_install: + logger.info( + 'Installing collected packages: %s', + ', '.join([req.name for req in to_install]), + ) + + installed = [] + + with indent_log(): + for requirement in to_install: + if requirement.should_reinstall: + logger.info('Attempting uninstall: %s', requirement.name) + with indent_log(): + uninstalled_pathset = requirement.uninstall( + auto_confirm=True + ) + try: + requirement.install( + install_options, + global_options, + *args, + **kwargs + ) + except Exception: + should_rollback = ( + requirement.should_reinstall and + not requirement.install_succeeded + ) + # if install did not succeed, rollback previous uninstall + if should_rollback: + uninstalled_pathset.rollback() + raise + else: + should_commit = ( + requirement.should_reinstall and + requirement.install_succeeded + ) + if should_commit: + uninstalled_pathset.commit() + + installed.append(InstallationResult(requirement.name)) + + return installed diff --git a/venv/lib/python3.8/site-packages/pip/_internal/req/__pycache__/__init__.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/req/__pycache__/__init__.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e78a2f089ad88c3dbba9a1cfd8e8c43ef6832bcf GIT binary patch literal 2223 zcmaJCO^*~sw5qzNr)PFPc4q+zU>uAZCeaxZLt+dP5D20;>aGN6Lpr@(H8Z{2Ut3+h zxMS}{xT^7LjM=@x#giw0fxn@zUf?enS$(f(dRf3&lX~;&)qAhrci(I_>jc(^bs{3b z{=~!KrNiMO?Br(voN(%sfLfFy&U|Ju_}6?b&@H{7>3$_JECcWgH~eZ~T4sS){aR4B z>IH843qiwbP$CRD0r{HW3|dwzXj|=I(OLwaI$z)o-W==Jl3=?XvAjpEBi9IT@%974 z+v4bb%{sPMuHh ze16Bi{L$6RpV%umhr{c`YftD*xDz`v5w;YYsV7AMG6@P?4-@71{>n2lP+NzNt3vg( zT)Px*=lTsVQMtJaydrdkG(oehA}|2t9dD+~9(!9N#Fr8m=+7+%r;D(YQvd|9C?^nU z%Gm>AX$e8Jw>F5k)g%hv?Y}oj zJSEiDx8xr~n;ef~v^xWs2=6Tk`B z2{xZeO}(HLcDd+txiFavus?&HJO+>v*;QnhVx{b|S)F9$3b_wa*<+N9$xcOS_sI{x zQQ*Bo?mpZxGGkqrqe7|zcm??io(}LB>jpP?^*g##y+zKEFUShHO{T|zUWF=RBbI5u zuuT6R=D{rzp4EvmH|p|NO7Mr8qn`lQ8f3@JO!+XY?$-C<=38=ygePv#IDSWtomy6t zf580$-e;BFhH3)6f|gUVdG^`s8CJbHP3v7)^Bi}@mXJ_{UO4W0VOLE=w`i`e51rVr z7p!Mg)Lj!@7rI#Rt}}wF>`t656yedm(2pFB^pJPc5GxoCsHZIEUZG@qdj2Acxe=&x z6)=`e?|0u!rtIzRbCrsfjagg8EMb1f5c|9J9h%W~@*~^SSLb!tf;*^7)<2tT&@3+& zWBojO<3>Sz;T)>M;xM4Ir*C;L4V39u?Trl?LGKdfI+3Ib}1hf`jWgg_MppC0KMZlHb$vRC5#P;#gkVt7m&65Buv!)!9?w+%JY-{{Bo9^6aU4bwquZ%STGQE zv1yMyUlboB3!_s8x%fuqRir>ziqBSV%w=mJD{ZJw zUgbu#whoOkn_3vILm@nva=CeaHXJXYUCHYJ8q8!3+Q1D^r$;nK7=;bNt!s--^7LQD Cb4ers literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/req/__pycache__/constructors.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/req/__pycache__/constructors.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3f71caddaf7144623373f1411be07d0fd9eb2686 GIT binary patch literal 10392 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 mcneV@Y{h|Ftu-4W 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 literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/req/__pycache__/req_install.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/req/__pycache__/req_install.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..628edd3fafd0a22297346bf843ea57ce1c4872f0 GIT binary patch literal 21367 zcma)kd5j!adS6#{^*JYp!@y{aZT zt)9dY6=!3B-pzq{a{w6zju%=OLEzX95(G)GF*XY%SO)>JcFIZqu;Bo9;sAjIZ=$TE z{C?l7>SNeiX9oTH)vNbjy?XC^-}n2D*S97n@(KK%&nLV;x|2x!J}(CUEL^;bkAKxn zB;15+)Dm^WF%0I-n(3JGoph4&Z8?^Fr<|00r=2vuleJ7e>tyRWCnxQ!TE0H!j7dIK z8?R3|6OvEYChJqql;ktWPdnQrpRLW*w>#SyJ5)Nq(~Sc>RELAj;dwKOy<4+QIrE=dk3bYe(uwohK!~t#+(l za0-&2sXbMH+IhNu+&M1S+iP?6d1qeov$YfTXPjpwzoYhS{iJhJ@;htK)t`5sm;A2U z3-uSB7wa!MFV$amUY4@mwV$babBsPc23vNIA`i-owM~XIbW*3>bzP%=bWpb zcg{=QJ+%w`FE|U5-&cFBe%ZM!`Teyk_1B%(CI49MjrvvRs*&(6f6G)y zu?mmZ-mEV=i}kmhx9ZoNYxOTXU#?$wuGeokH|jT?o6_n4X7rYGOY(N@?fN^;JCc8* z_HO+>=RL_EtU2|sIA4+cq1spLUvs`D`NOrZ*NaXOPc%1gd!>hlv*aFekA9SJ%C9Bd zC*5NoCER14dq3%Tu6ZL-DEuMmtYCywr6s>vYX@GjQg1a?uvjp|iPqXmQF(r|t;(Js zCjH7i)Ev9+z2B}VukJMhTy86u8qG$fT&h(%Ua?WCdnnAj?J2*~Y#^Izm6Xr2>1$r= zg=b&7+-$C0DAj77LRr4$wVpruLQq=qaW%Wxe5-Z7U8%X38h0wH*@z!;rQru?QVP)J zC8e6ubj1sbet8w+KvU~#rLl(ZZ7W{GQzg7c-3v-?DJY?Ex}w_`J+~5+mTEG>s0_C! z;@fvuJ+FrM-d<~#++u6JrJ7Z*92A3Qy%uh-m)5+2!d59*W#6|NQS)mkxZ!b1@~+oX zUKyisah1MY@>e~+U%t|CF=@qGbES|B_g=elt$6X$)k`-o72iB}{f$f4iwjq-URpf& z=B04wYRNCUUd`i+l+>E1ip!On7w*2RDkysNP9cXC^w)|URnfaw@dH21FO|w`?N-sP zsBqk^_^n!LT`Gh-a1|6QjiS%qTBuf9!2(am#ciL<7kJ?gPIB~qo?E=5S2fJ8R$Q;x zR<&?ed2R_)RBGe7%c@zI(zL1v%HuSTvx9-9n7HZHTNgn+<)Eq7QDNrI_pZHHym0x_ zg*S@VZ!IofS$qwpyH&e^d0i>CF=MI-VhGx$n%B64d&xUxzmN%&=Njvwb+J+o!t9j* zYmRj#8Thzz2*f6@rX3{kt z8tU=Ds-`x~#;la!o_{<@e`ugIvtgokb~D#Sy|0=Z$qh@c^Ihwq;U@PaHd2ALIo3_$ zzPXX^n#iTPY1ev?#I{a#zI@#a+Nxof?4eCOKlm#4a#PvCs%L}H?_fpUyp6wjwQSIh zUZ!~|@8ssam6f?lW4YPM&y!RnulUy3G~@AZAqxnzaW94OFs(Rytor{e zZY5Y%NwihZBMB$Z`5?O91`lUB&?|V>;DAGm^c|)^$`vfLe0leRaGZPZ&3MCS!kPH# zq<#GkPL?C)b(AaD{4l#z^0AvxHWA+y4i@I*l5e73#^^pys0Dm|^7Rv|&AN9&HJhzc zYwg4xzua`a6MoR4;wvJ3g+?wsUzBR}t+ko+Fx zpK+g+{9gB@`yATsbDwu#!1sRlMfW9qKZZIlyFVj!9(PZxOY8QMXZLui4Qb{nyV*D{w^mDccoQ44E>cc5tQ&C8*-*n<|dckqDSiy zdA47wxP$HWCSP0-N-s|g&=m7MRt7MW=z^%$vi{xxxxlz@B4>7u`^JZ0Y~4gL31*Zi zTHP_EsV*?-T2`HQ!2pZt#?Bx^rY32=n|ui7#`3O(bgY|4I^G3pMT<_?;HNsFI>98r z?;9JbZpvamQ}|3vkK4M5>XiB=rq!9~dpquK>yE2`*d0f1wqc{EAGn5VeuVK>XD@=V zr92z#xX<2Z!8ZBC-$Olosyo3>(4Zvy^`+h=Dua9d^guHD{Q}CYCIxXns^Mg@J~7zqIT@>IbUyu^F24&x9$tkfqegYv?J=o%TUO&3fzXUt#am zD$<6T=*&M#&+|p_rAkmN&Y!L|f$jXW^S#Ckg(m@Je4!_ZRz=!SXZV05=rPRW37#)t zfO%{c1!@d1O2Lt2x9Sv|e2Go64UoKW^$ZZGWU?_#3&)EB$%V}%%>@FEwoW)z3;ON6L=k8oRbr|7rKWzT~M4Kqyv9}q5J1;D;2%3&a=4M7xU zD?r%*Xr~Z6kc2sL{@+0YCXi6a18nXpwm48$qH3y(U{*$eEnGFL)_r4V;-$of(bz5b zUhS8o%yLa>L-vzXOK6u2zy_+RY9?-ntE~EVkmGldua4a})t_S?2o9_ZjBWg3V#Dm3 z>f2~-bxr-Wu0ce$*vZ-i$o3JxGkf~cmpt1^Ljdq@-aZypEEFbW4FQ`1rC06{UR1ry zWQob+NWv^BpU_FK^;^8bnE^cmcmYKR>n*_hoZxeAv5%9g$@_+{TWne5OtFZD#p3r+ z$G4Fruta$*92VD@#DeCHS>~|Zc`WU?(b@ax`+$Q;CqrvStk_$#-MDaNwW^ptLx0_2;!A@ab?3gW_Iik)MEP$nAxmNQ1Vlf0!5~~%9N}*4o^N$UA z#S!F-U5R)5ZB+Ed>Hko3s)`0bxX0!fJB|78IDZwTrArNlDG z4iYB|a)e~0%-JyAWEHPjO;#<}+Dvr;_ubS3YT@b5*>erM-IxnJAH2a{^=d7E1Hy9v z!hj+h3UJ^Zmm=3&YOjFtt!R-=%sw{?i|D5jT2E{=o+y$Xjo0Y@F?w$89JXmM9k~DK4Z# z>ke!SVcLhi0vvS%Pgmlk_31a z$vgddI!W%8{j77~&v>aaUqAli0`x%BDlV|_pmxBF-O%+w^;mwwB$i_tz;WDe(sx-4 znqG3#0w+oFUX>|pr2&l02LvMt!li0rEveifvzaCEsA5TB0OE35rM;klOAWtG*huVI zS++|yWuy&T4N>TF6MD7K5)i6?JgS9?zP>e|7sN=)T5JYUFO(?r(hISyA5>~J_O;k- zc=jBhajUhWN-kimZ!Z8bc!EfwUiSJL5M-=WswuDJuJ69*2o*$ODKS{N5|L&ASa+hp+N$PVds!xe zecJVk4{VQd`u%;o&{pU{)td^V*Q1U`Yh&FaT|$qLmJnzRb-*&reOXYxC>n0NKf}}# zFkZXf#0$YDN1n8c;}kT=p$OIAD;ri2p|(pnUy*%eANZB0et zWYlf6{!X?D%ti83KhI}u5m^(hW~)tLB~|_#YWNf{iHSVK6m(}`5Filzo1bP=d81>G z*vms*3~^M7t=?unhzo8w(HSO*;R9pSq4!8m9SaP>L%=^DWxIlfI9wNMtZ2X~!j8nyTe4GbxGfNdU2X!%bd3r&*&u{b zZ=yDQ7NXg}z<8%rYtz8;28suWn+u`-0uuO>BDi9jpLd=c@z%ntBjdY20<=jW%IgKpE7T%+IpcNbWS$aA>m7NuN6ryJ(Ww zG+m0)^i?}1Vb?AJe`{@aV5{AP1cPiZ2bDXR zVS8>aV$^d{7mz*PD{+5AeL))z>?XiSPn_PmeiicEmi^Z&4AZ(N_(-g!X0s;hsd|7H z8(7KyzM4jD5fa5{tS30DLZZ3Op%E*)wf@Z^dL}LNBOB~>WXQWfbTXHlrYLxZ+KPwzW`~qc@ z=w(291N{L!9OrVtF!@tZ4;b+v=$V@%*_3MarVr5KarCtAOCJK0dP}=p1GJd8K|(-~ zVryA{lz@)K?7srzCrA(u$y%jc32K-TZOSC5gVqt3#oTxlr$7mic!6q*dk*}o;X(I(ClZHP zYPrQ`ni%Y3hwx@+=I7@N(X)E5#5o#`R&}?4!+^r;_7LhhR_G&t^&Jp@A>ZG9p;d0S z*0mYJ!M)HT3Bs=D1+KSTYS)4=#}bVv)1_7mb}6-sy;xd0P7c4BGsa1b0G{r57}m)U zPH{U^(j}&6-~h?P3enj!dRv1t4RJ=wBz|NsUq^;}S(LCzs!Cf-MT^=TM3)>4JI|x8 z85wr4t0TkCA`Ck)@az&Zk{EW9omT-qz@6=q4L7)`14Q0*tu;wNcVi1aR4x0U7)NDO z9PBOCV#l02TgYg%C>9K{+4bx=D!|ZHn+c*r9zlt`agCESi%h~IN~E!7z&tYwx%G@e zL)?$E)#HBO#s%IN<}iOeNWi)epdrSwrP2SDY|Bp_6wU1>#ha@&GL{?nf)Ua!qh{GKb^w+lD*j9I&D@N-~!W^gM zhlY~3#!c!eu$(5xQ3Ai8(K$AP)JJwWMEMkd8GMBDY3Rjl3+4Nh0sSyFIpSB*Mu<%3Irzp0 zg^OKU2IGM}OX4%ATE38>_y9jMXhl%2{Wf@!9YkGwrONPg^_R+ zqS)HcBTJD+m$DQWk7!%BcU^CcIGQr7*7RW!%ZGbIh z3TRF)s^36g9q+YACsZsuk#bMNDLnITyA1Ib&$zCjqg!k$kEk_oFI4W?>+sRohv4Tw zgLccRw89V^e;&+>|JP|)igu&K{-_0h)W}_I}M9^F+ zezV8M;P9RnP;4eG=or>dtaRt;5nJJldKy{+^xEfYu^gaYf+@x#AZKo32k=UGk7)Ab zIa~xW(WT%>fNoDY5S4O|Wa4YlUf;g%)thkR5>;tmm*6SRBh3D^v<>cu<20F}>bigt z@j&&l9ZZt81o^;z)7c^Ya>qoyiko1ukkwm&^xEfB>M$?K=)z37=9L=lma4L7gnc30 zg(xnJSiD+IRZ{Ck{e-{EWtc{*gf)$QKxv{K0G+2sEWsCaG9*_l^hJ$VHo?C|hI2hA ziRl2~T8Nz-JieIh%yJu`9N1ZViQh>y?pfFz)y!I6EgDz}Bk`W_8!64A^dIO_wq$?R z9Kvm|iPSFz@HS(me^yp>?EUWs5PKJ)RVgClG~W{FM*}8U zA>lIg%VyY0&zMRS&dN1d3vGYhpQi_jwn=alhE}m9n1v8!VMcRl;l6@oZey*r!E2fZ z!NExp50(z}iRWpt87$B?9Zp37gcqV&(t_1yXJsbGm>gg-&g3N~J`;-b7;a9`CCV3) zI5#KPXh!7T%~AEG~of8#`iQtL;7|K8SM_gz0|{Ih!W5uX4KHbJ?#di7z|JS&;cFI^kHz?g+x z4gl#qd^-7HjQ(F8-$#M4_z419W1fvy7O4yWZWg<_-9o${P z{(w^|YE}|z7Cw{aNITR}qoIi;$tLj;V%d+(sEI@wIIbp@e~miWtNl5k0;A;3M@g&g z{on{j34Vd>AfkoYc@(*h2t6MnS8g)Cf{?3&jBK*g zNDY5FFrmKD8%zL807OVjMO#R*^`dJ))lO9N2s|(!z~zEG6mBSfuS-jW%Sp>I5G=WQ zs`JK`#+~LGtcEe1kM%b!({j538!+sZFqYBUM?#Dy3`j_=w6*HcTkK9oaPS8km~%m- zvO2Q)MF(djQkVhRlqxl!rhKXN?@+g);ThQ{XE*+7cb}Q7!#HN zY*_Sg^M2x+(*{a5lMj&=t#=YHB)*)uo)9#e@?XTAH1&}N^l@5Mq;8hq!fDLTKN^ez zh~l&RO9_3XbO)2o$oT=DbBli1n0e4E4L-xQjkbWjiUS;EFHv}#+>6Phzdv;^(N^wr zo~XZgYuj-|dB5QzH2uCrpc7a9hzSW^ujD^r?w=tEA4B*Lg2rQbATAPw9!BoLk;^+B z4ZC+J;VCZeBzj9^^02Fgyj`pNM-3_Y3kdjj`5F8U;ooJqTg#Ni=KO1-S@A608D zqh1c6epC3uESLn*@5FTmF?uvcab_{c4`C+}>xi`&W+E!+Jb9gGKqRi}2zV7e1Qo5M zQKm+d55Kc!+3U#!G2Eh+bo@oBvbhzR857 z5n(gMaHFkq;$!9K1Jz{Sc!m^L2gotfGq=C>0T#f==%FYa|ZAykm%D`6>3{;budNPu;1v2^nG{n-GkO zUSs5w4`GAnRzlu_oj)Zu<0OtJ=^S7MqBcy%^=ljqTT5mw?Y|oU?Xs_GMypOb&mc87 z_0YsYCLrY?x0z@3)E`NWG5#m_`ZD2=q&KyA$6sd=ulGWZSM8 z+k1p@Of7cKUMMwa7-_cv0tsnaP1r-|NPr3Fi2ur9No>sL4rn)oLPLwH*eAx*ov|fg ze8j9HVoE9cQaUflz5rR(iQM15aASyzppPYlnyahnxhaP)%S51RvYSw0TH^$7Zyv z?-$TebHqLd6mXZ;r#f}_ud-GFNjOGn665eR%oR8XC^4V#Kn74$^og>atbdU8)6FFw zgP|*jacwY{HhJ&A@?PdnS@dXmMmUC^`aOeT`OQW+hJ}a8OOClZc^r6zv5SWrx9-s? zO((sxr8Vx(^LPk@ropUD>r*R5j~t^rEMq^IIX!e)#GRPQwA=%L{M=08Y!}LB%o(5% zu=vlRAdE5`ZFyXoEIj_B*^N7!Lfa>NCWUJ>*_ok@o7YtwAlyj8mUTw*d>)BP<_dcPOsWHR0nv5bnc?{0 zVhMg*YWg_SD|NT`W*6o_ngRegwr<5-ug))W6VjTLn9O4{F>ZkF@NphXF-At)^_rGN zva%`uC?a_+8)_aIeT)nd+S(3k(pe3(YGErR@0${_oph7C65Z4;2u2?6!bp05%(FW( zJYQ>jn}D-C7FVYI*{hgfD9C91;aY8%v^3j1zF_{Q-tCV5ohCm*l|eZzBma5d#EH;gW`F-Nn{P zpTa2&xS5KbN=saLzs{+rQ9faU)4?=OLwV=S2&gKDT}!IGT7e6SL+?k~ZRu0}FLVb> z;VFC#7?nA!$bh2{ljSs&0!G5;pl|$E72Mu;r<$D4*)<5sFO#XUxTX){QyES$YM;_ zMVh`Z+Eg&PIRz?Cvvp$zZN|~&`@!_)Hg|&kbWQ(rP>or_jga-Kp+$)W&*|-i^nFrD;tl&%~48+Io7Ah@%FBRZLX}6Fo6_x;n zY*-tNN@&~-jit~iss9U_T~I$k+8MjZADz&WL4C@S?dQ>$1??6eBhEhc8Seby=lEmj zZXOn*=3S@Kdhz+rI0io#8+E`r{x>SB|HFh^7$&|yHpD~J$#O1T^jNS5%ssMCMSb3~ z)qj;;P$3rexi4AN|6myaD)^JX3d?vcwCK`S|As{tCM5_nm@v*#n86qqm>GBEr#BX^ zp1XPJqCSFJMr@_J#m>GjE$^0UYw8nb*@{0z5W;E5&^eqprI{wo%5QNno_`OkrQ}lm zG4h3N8fyL;^3J5zfQu2;K*|kpJg0X>kw$~F--1OIM^;@}Eadd6lgIFj03oe*5GIAS zA<@;5A>ZWDKD?IBW}-r83>iL^#ZDTX;5y946`gVB;`>{9VFBWuI%=1u*(Ni%SDaJYVH*h!aH-a(P z-O0PCI^$qCcx|FO37b?_evt$Eb-x`|R(VnqPfFog*=`QU0CQU1E~FO=sn7x>RS2)d zIff9SlTE}C;CZ!-A`6M-Z%%qb=eKME(~uC#?2t{+kE_HzV0 z&#-lT_#LWfx_X1$Li37}+W?I9=>$xS(|Fw9oacSfO_|x<_6g@d1t9?F^ zeeRQVmgR$OqWq6X(scAjh5X{e;vzr#rx*%2NMyj*h4Tgr3xy1BE#8Fh>q&jcF<&e~ zb7*5H7jas?_&$Cmhx;8@IK=BV%QzDIKHf&%W71{v4JLmL2@k0A_)4&@*GX)Zo4osw z$uBecn8|mTFvwKVY^8eUclFPC`LCGBVv%ubm)mbKx1Gt4nEVbC;p)H391Wc6KQsC7 zO#XxkIj!2sMdC6HEX@Kh#lLn1xiUUJUjw`&4?oA&|3AsUo86I3Wv876!WB8=9`?I^Uvn{L}e;sCj?KuzUEfcdzW}<0BHK6K-i7vm0NSMYw0UF^`edd^vC`Kl9rL#5Lre}MiT1&k=k~UicCYOpH8%Ni51=G$4B+iH_b?lTDWbv5^a_RHcm%9J%tPPG?U{@=9tjXpiVG(hRL%?!tKNTlzHG; zo#Y+OL3*z%2Xi7$;$fcY%~j8_qTXPd1I-WpDwzHWF1=py{T?fdk8pu4yufb0fXzg| zp`u=7og8enSLK+mh$)TNFY^wpviv~@;i040e3(701=?8}O8j?`FepCyH;FW(e<0C; ef7o_-)xSTRIzHCB59xeZLh7TEWImbQ`~Lu-n$oxc literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/req/__pycache__/req_set.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/req/__pycache__/req_set.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..fed781a0609bb2e54d4b68dbf2355aaa0ff9c173 GIT binary patch literal 6050 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 bool + """Return True if `name` is a considered as an archive file.""" + ext = splitext(name)[1].lower() + if ext in ARCHIVE_EXTENSIONS: + return True + return False + + +def _strip_extras(path): + # type: (str) -> Tuple[str, Optional[str]] + m = re.match(r'^(.+)(\[[^\]]+\])$', path) + extras = None + if m: + path_no_extras = m.group(1) + extras = m.group(2) + else: + path_no_extras = path + + return path_no_extras, extras + + +def convert_extras(extras): + # type: (Optional[str]) -> Set[str] + if not extras: + return set() + return Requirement("placeholder" + extras.lower()).extras + + +def parse_editable(editable_req): + # type: (str) -> Tuple[Optional[str], str, Optional[Set[str]]] + """Parses an editable requirement into: + - a requirement name + - an URL + - extras + - editable options + Accepted requirements: + svn+http://blahblah@rev#egg=Foobar[baz]&subdirectory=version_subdir + .[some_extra] + """ + + url = editable_req + + # If a file path is specified with extras, strip off the extras. + url_no_extras, extras = _strip_extras(url) + + if os.path.isdir(url_no_extras): + if not os.path.exists(os.path.join(url_no_extras, 'setup.py')): + msg = ( + 'File "setup.py" not found. Directory cannot be installed ' + 'in editable mode: {}'.format(os.path.abspath(url_no_extras)) + ) + pyproject_path = make_pyproject_path(url_no_extras) + if os.path.isfile(pyproject_path): + msg += ( + '\n(A "pyproject.toml" file was found, but editable ' + 'mode currently requires a setup.py based build.)' + ) + raise InstallationError(msg) + + # Treating it as code that has already been checked out + url_no_extras = path_to_url(url_no_extras) + + if url_no_extras.lower().startswith('file:'): + package_name = Link(url_no_extras).egg_fragment + if extras: + return ( + package_name, + url_no_extras, + Requirement("placeholder" + extras.lower()).extras, + ) + else: + return package_name, url_no_extras, None + + for version_control in vcs: + if url.lower().startswith('%s:' % version_control): + url = '%s+%s' % (version_control, url) + break + + if '+' not in url: + raise InstallationError( + '{} is not a valid editable requirement. ' + 'It should either be a path to a local project or a VCS URL ' + '(beginning with svn+, git+, hg+, or bzr+).'.format(editable_req) + ) + + vc_type = url.split('+', 1)[0].lower() + + if not vcs.get_backend(vc_type): + error_message = 'For --editable=%s only ' % editable_req + \ + ', '.join([backend.name + '+URL' for backend in vcs.backends]) + \ + ' is currently supported' + raise InstallationError(error_message) + + package_name = Link(url).egg_fragment + if not package_name: + raise InstallationError( + "Could not detect requirement name for '%s', please specify one " + "with #egg=your_package_name" % editable_req + ) + return package_name, url, None + + +def deduce_helpful_msg(req): + # type: (str) -> str + """Returns helpful msg in case requirements file does not exist, + or cannot be parsed. + + :params req: Requirements file path + """ + msg = "" + if os.path.exists(req): + msg = " It does exist." + # Try to parse and check if it is a requirements file. + try: + with open(req, 'r') as fp: + # parse first line only + next(parse_requirements(fp.read())) + msg += " The argument you provided " + \ + "(%s) appears to be a" % (req) + \ + " requirements file. If that is the" + \ + " case, use the '-r' flag to install" + \ + " the packages specified within it." + except RequirementParseError: + logger.debug("Cannot parse '%s' as requirements \ + file" % (req), exc_info=True) + else: + msg += " File '%s' does not exist." % (req) + return msg + + +class RequirementParts(object): + def __init__( + self, + requirement, # type: Optional[Requirement] + link, # type: Optional[Link] + markers, # type: Optional[Marker] + extras, # type: Set[str] + ): + self.requirement = requirement + self.link = link + self.markers = markers + self.extras = extras + + +def parse_req_from_editable(editable_req): + # type: (str) -> RequirementParts + name, url, extras_override = parse_editable(editable_req) + + if name is not None: + try: + req = Requirement(name) + except InvalidRequirement: + raise InstallationError("Invalid requirement: '%s'" % name) + else: + req = None + + link = Link(url) + + return RequirementParts(req, link, None, extras_override) + + +# ---- The actual constructors follow ---- + + +def install_req_from_editable( + editable_req, # type: str + comes_from=None, # type: Optional[str] + use_pep517=None, # type: Optional[bool] + isolated=False, # type: bool + options=None, # type: Optional[Dict[str, Any]] + wheel_cache=None, # type: Optional[WheelCache] + constraint=False # type: bool +): + # type: (...) -> InstallRequirement + + parts = parse_req_from_editable(editable_req) + + source_dir = parts.link.file_path if parts.link.scheme == 'file' else None + + return InstallRequirement( + parts.requirement, comes_from, source_dir=source_dir, + editable=True, + link=parts.link, + constraint=constraint, + use_pep517=use_pep517, + isolated=isolated, + options=options if options else {}, + wheel_cache=wheel_cache, + extras=parts.extras, + ) + + +def _looks_like_path(name): + # type: (str) -> bool + """Checks whether the string "looks like" a path on the filesystem. + + This does not check whether the target actually exists, only judge from the + appearance. + + Returns true if any of the following conditions is true: + * a path separator is found (either os.path.sep or os.path.altsep); + * a dot is found (which represents the current directory). + """ + if os.path.sep in name: + return True + if os.path.altsep is not None and os.path.altsep in name: + return True + if name.startswith("."): + return True + return False + + +def _get_url_from_path(path, name): + # type: (str, str) -> str + """ + First, it checks whether a provided path is an installable directory + (e.g. it has a setup.py). If it is, returns the path. + + If false, check if the path is an archive file (such as a .whl). + The function checks if the path is a file. If false, if the path has + an @, it will treat it as a PEP 440 URL requirement and return the path. + """ + if _looks_like_path(name) and os.path.isdir(path): + if is_installable_dir(path): + return path_to_url(path) + raise InstallationError( + "Directory %r is not installable. Neither 'setup.py' " + "nor 'pyproject.toml' found." % name + ) + if not is_archive_file(path): + return None + if os.path.isfile(path): + return path_to_url(path) + urlreq_parts = name.split('@', 1) + if len(urlreq_parts) >= 2 and not _looks_like_path(urlreq_parts[0]): + # If the path contains '@' and the part before it does not look + # like a path, try to treat it as a PEP 440 URL req instead. + return None + logger.warning( + 'Requirement %r looks like a filename, but the ' + 'file does not exist', + name + ) + return path_to_url(path) + + +def parse_req_from_line(name, line_source): + # type: (str, Optional[str]) -> RequirementParts + if is_url(name): + marker_sep = '; ' + else: + marker_sep = ';' + if marker_sep in name: + name, markers_as_string = name.split(marker_sep, 1) + markers_as_string = markers_as_string.strip() + if not markers_as_string: + markers = None + else: + markers = Marker(markers_as_string) + else: + markers = None + name = name.strip() + req_as_string = None + path = os.path.normpath(os.path.abspath(name)) + link = None + extras_as_string = None + + if is_url(name): + link = Link(name) + else: + p, extras_as_string = _strip_extras(path) + url = _get_url_from_path(p, name) + if url is not None: + link = Link(url) + + # it's a local file, dir, or url + if link: + # Handle relative file URLs + if link.scheme == 'file' and re.search(r'\.\./', link.url): + link = Link( + path_to_url(os.path.normpath(os.path.abspath(link.path)))) + # wheel file + if link.is_wheel: + wheel = Wheel(link.filename) # can raise InvalidWheelFilename + req_as_string = "%s==%s" % (wheel.name, wheel.version) + else: + # set the req to the egg fragment. when it's not there, this + # will become an 'unnamed' requirement + req_as_string = link.egg_fragment + + # a requirement specifier + else: + req_as_string = name + + extras = convert_extras(extras_as_string) + + def with_source(text): + # type: (str) -> str + if not line_source: + return text + return '{} (from {})'.format(text, line_source) + + if req_as_string is not None: + try: + req = Requirement(req_as_string) + except InvalidRequirement: + if os.path.sep in req_as_string: + add_msg = "It looks like a path." + add_msg += deduce_helpful_msg(req_as_string) + elif ('=' in req_as_string and + not any(op in req_as_string for op in operators)): + add_msg = "= is not a valid operator. Did you mean == ?" + else: + add_msg = '' + msg = with_source( + 'Invalid requirement: {!r}'.format(req_as_string) + ) + if add_msg: + msg += '\nHint: {}'.format(add_msg) + raise InstallationError(msg) + else: + req = None + + return RequirementParts(req, link, markers, extras) + + +def install_req_from_line( + name, # type: str + comes_from=None, # type: Optional[Union[str, InstallRequirement]] + use_pep517=None, # type: Optional[bool] + isolated=False, # type: bool + options=None, # type: Optional[Dict[str, Any]] + wheel_cache=None, # type: Optional[WheelCache] + constraint=False, # type: bool + line_source=None, # type: Optional[str] +): + # type: (...) -> InstallRequirement + """Creates an InstallRequirement from a name, which might be a + requirement, directory containing 'setup.py', filename, or URL. + + :param line_source: An optional string describing where the line is from, + for logging purposes in case of an error. + """ + parts = parse_req_from_line(name, line_source) + + return InstallRequirement( + parts.requirement, comes_from, link=parts.link, markers=parts.markers, + use_pep517=use_pep517, isolated=isolated, + options=options if options else {}, + wheel_cache=wheel_cache, + constraint=constraint, + extras=parts.extras, + ) + + +def install_req_from_req_string( + req_string, # type: str + comes_from=None, # type: Optional[InstallRequirement] + isolated=False, # type: bool + wheel_cache=None, # type: Optional[WheelCache] + use_pep517=None # type: Optional[bool] +): + # type: (...) -> InstallRequirement + try: + req = Requirement(req_string) + except InvalidRequirement: + raise InstallationError("Invalid requirement: '%s'" % req_string) + + domains_not_allowed = [ + PyPI.file_storage_domain, + TestPyPI.file_storage_domain, + ] + if (req.url and comes_from and comes_from.link and + comes_from.link.netloc in domains_not_allowed): + # Explicitly disallow pypi packages that depend on external urls + raise InstallationError( + "Packages installed from PyPI cannot depend on packages " + "which are not also hosted on PyPI.\n" + "%s depends on %s " % (comes_from.name, req) + ) + + return InstallRequirement( + req, comes_from, isolated=isolated, wheel_cache=wheel_cache, + use_pep517=use_pep517 + ) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/req/req_file.py b/venv/lib/python3.8/site-packages/pip/_internal/req/req_file.py new file mode 100644 index 000000000..8c7810481 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/req/req_file.py @@ -0,0 +1,546 @@ +""" +Requirements file parsing +""" + +# The following comment should be removed at some point in the future. +# mypy: strict-optional=False + +from __future__ import absolute_import + +import optparse +import os +import re +import shlex +import sys + +from pip._vendor.six.moves import filterfalse +from pip._vendor.six.moves.urllib import parse as urllib_parse + +from pip._internal.cli import cmdoptions +from pip._internal.exceptions import ( + InstallationError, + RequirementsFileParseError, +) +from pip._internal.models.search_scope import SearchScope +from pip._internal.req.constructors import ( + install_req_from_editable, + install_req_from_line, +) +from pip._internal.utils.encoding import auto_decode +from pip._internal.utils.typing import MYPY_CHECK_RUNNING +from pip._internal.utils.urls import get_url_scheme + +if MYPY_CHECK_RUNNING: + from optparse import Values + from typing import ( + Any, Callable, Iterator, List, NoReturn, Optional, Text, Tuple, + ) + + from pip._internal.req import InstallRequirement + from pip._internal.cache import WheelCache + from pip._internal.index.package_finder import PackageFinder + from pip._internal.network.session import PipSession + + ReqFileLines = Iterator[Tuple[int, Text]] + + LineParser = Callable[[Text], Tuple[str, Values]] + + +__all__ = ['parse_requirements'] + +SCHEME_RE = re.compile(r'^(http|https|file):', re.I) +COMMENT_RE = re.compile(r'(^|\s+)#.*$') + +# Matches environment variable-style values in '${MY_VARIABLE_1}' with the +# variable name consisting of only uppercase letters, digits or the '_' +# (underscore). This follows the POSIX standard defined in IEEE Std 1003.1, +# 2013 Edition. +ENV_VAR_RE = re.compile(r'(?P\$\{(?P[A-Z0-9_]+)\})') + +SUPPORTED_OPTIONS = [ + cmdoptions.index_url, + cmdoptions.extra_index_url, + cmdoptions.no_index, + cmdoptions.constraints, + cmdoptions.requirements, + cmdoptions.editable, + cmdoptions.find_links, + cmdoptions.no_binary, + cmdoptions.only_binary, + cmdoptions.require_hashes, + cmdoptions.pre, + cmdoptions.trusted_host, + cmdoptions.always_unzip, # Deprecated +] # type: List[Callable[..., optparse.Option]] + +# options to be passed to requirements +SUPPORTED_OPTIONS_REQ = [ + cmdoptions.install_options, + cmdoptions.global_options, + cmdoptions.hash, +] # type: List[Callable[..., optparse.Option]] + +# the 'dest' string values +SUPPORTED_OPTIONS_REQ_DEST = [str(o().dest) for o in SUPPORTED_OPTIONS_REQ] + + +class ParsedLine(object): + def __init__( + self, + filename, # type: str + lineno, # type: int + comes_from, # type: str + args, # type: str + opts, # type: Values + constraint, # type: bool + ): + # type: (...) -> None + self.filename = filename + self.lineno = lineno + self.comes_from = comes_from + self.args = args + self.opts = opts + self.constraint = constraint + + +def parse_requirements( + filename, # type: str + session, # type: PipSession + finder=None, # type: Optional[PackageFinder] + comes_from=None, # type: Optional[str] + options=None, # type: Optional[optparse.Values] + constraint=False, # type: bool + wheel_cache=None, # type: Optional[WheelCache] + use_pep517=None # type: Optional[bool] +): + # type: (...) -> Iterator[InstallRequirement] + """Parse a requirements file and yield InstallRequirement instances. + + :param filename: Path or url of requirements file. + :param session: PipSession instance. + :param finder: Instance of pip.index.PackageFinder. + :param comes_from: Origin description of requirements. + :param options: cli options. + :param constraint: If true, parsing a constraint file rather than + requirements file. + :param wheel_cache: Instance of pip.wheel.WheelCache + :param use_pep517: Value of the --use-pep517 option. + """ + skip_requirements_regex = ( + options.skip_requirements_regex if options else None + ) + line_parser = get_line_parser(finder) + parser = RequirementsFileParser( + session, line_parser, comes_from, skip_requirements_regex + ) + + for parsed_line in parser.parse(filename, constraint): + req = handle_line( + parsed_line, finder, options, session, wheel_cache, use_pep517 + ) + if req is not None: + yield req + + +def preprocess(content, skip_requirements_regex): + # type: (Text, Optional[str]) -> ReqFileLines + """Split, filter, and join lines, and return a line iterator + + :param content: the content of the requirements file + :param options: cli options + """ + lines_enum = enumerate(content.splitlines(), start=1) # type: ReqFileLines + lines_enum = join_lines(lines_enum) + lines_enum = ignore_comments(lines_enum) + if skip_requirements_regex: + lines_enum = skip_regex(lines_enum, skip_requirements_regex) + lines_enum = expand_env_variables(lines_enum) + return lines_enum + + +def handle_line( + line, # type: ParsedLine + finder=None, # type: Optional[PackageFinder] + options=None, # type: Optional[optparse.Values] + session=None, # type: Optional[PipSession] + wheel_cache=None, # type: Optional[WheelCache] + use_pep517=None, # type: Optional[bool] +): + # type: (...) -> Optional[InstallRequirement] + """Handle a single parsed requirements line; This can result in + creating/yielding requirements, or updating the finder. + + For lines that contain requirements, the only options that have an effect + are from SUPPORTED_OPTIONS_REQ, and they are scoped to the + requirement. Other options from SUPPORTED_OPTIONS may be present, but are + ignored. + + For lines that do not contain requirements, the only options that have an + effect are from SUPPORTED_OPTIONS. Options from SUPPORTED_OPTIONS_REQ may + be present, but are ignored. These lines may contain multiple options + (although our docs imply only one is supported), and all our parsed and + affect the finder. + """ + + # preserve for the nested code path + line_comes_from = '%s %s (line %s)' % ( + '-c' if line.constraint else '-r', line.filename, line.lineno, + ) + + # return a line requirement + if line.args: + isolated = options.isolated_mode if options else False + if options: + cmdoptions.check_install_build_global(options, line.opts) + # get the options that apply to requirements + req_options = {} + for dest in SUPPORTED_OPTIONS_REQ_DEST: + if dest in line.opts.__dict__ and line.opts.__dict__[dest]: + req_options[dest] = line.opts.__dict__[dest] + line_source = 'line {} of {}'.format(line.lineno, line.filename) + return install_req_from_line( + line.args, + comes_from=line_comes_from, + use_pep517=use_pep517, + isolated=isolated, + options=req_options, + wheel_cache=wheel_cache, + constraint=line.constraint, + line_source=line_source, + ) + + # return an editable requirement + elif line.opts.editables: + isolated = options.isolated_mode if options else False + return install_req_from_editable( + line.opts.editables[0], comes_from=line_comes_from, + use_pep517=use_pep517, + constraint=line.constraint, isolated=isolated, + wheel_cache=wheel_cache + ) + + # percolate hash-checking option upward + elif line.opts.require_hashes: + options.require_hashes = line.opts.require_hashes + + # set finder options + elif finder: + find_links = finder.find_links + index_urls = finder.index_urls + if line.opts.index_url: + index_urls = [line.opts.index_url] + if line.opts.no_index is True: + index_urls = [] + if line.opts.extra_index_urls: + index_urls.extend(line.opts.extra_index_urls) + if line.opts.find_links: + # FIXME: it would be nice to keep track of the source + # of the find_links: support a find-links local path + # relative to a requirements file. + value = line.opts.find_links[0] + req_dir = os.path.dirname(os.path.abspath(line.filename)) + relative_to_reqs_file = os.path.join(req_dir, value) + if os.path.exists(relative_to_reqs_file): + value = relative_to_reqs_file + find_links.append(value) + + search_scope = SearchScope( + find_links=find_links, + index_urls=index_urls, + ) + finder.search_scope = search_scope + + if line.opts.pre: + finder.set_allow_all_prereleases() + + if session: + for host in line.opts.trusted_hosts or []: + source = 'line {} of {}'.format(line.lineno, line.filename) + session.add_trusted_host(host, source=source) + + return None + + +class RequirementsFileParser(object): + def __init__( + self, + session, # type: PipSession + line_parser, # type: LineParser + comes_from, # type: str + skip_requirements_regex, # type: Optional[str] + ): + # type: (...) -> None + self._session = session + self._line_parser = line_parser + self._comes_from = comes_from + self._skip_requirements_regex = skip_requirements_regex + + def parse(self, filename, constraint): + # type: (str, bool) -> Iterator[ParsedLine] + """Parse a given file, yielding parsed lines. + """ + for line in self._parse_and_recurse(filename, constraint): + yield line + + def _parse_and_recurse(self, filename, constraint): + # type: (str, bool) -> Iterator[ParsedLine] + for line in self._parse_file(filename, constraint): + if ( + not line.args and + not line.opts.editables and + (line.opts.requirements or line.opts.constraints) + ): + # parse a nested requirements file + if line.opts.requirements: + req_path = line.opts.requirements[0] + nested_constraint = False + else: + req_path = line.opts.constraints[0] + nested_constraint = True + + # original file is over http + if SCHEME_RE.search(filename): + # do a url join so relative paths work + req_path = urllib_parse.urljoin(filename, req_path) + # original file and nested file are paths + elif not SCHEME_RE.search(req_path): + # do a join so relative paths work + req_path = os.path.join( + os.path.dirname(filename), req_path, + ) + + for inner_line in self._parse_and_recurse( + req_path, nested_constraint, + ): + yield inner_line + else: + yield line + + def _parse_file(self, filename, constraint): + # type: (str, bool) -> Iterator[ParsedLine] + _, content = get_file_content( + filename, self._session, comes_from=self._comes_from + ) + + lines_enum = preprocess(content, self._skip_requirements_regex) + + for line_number, line in lines_enum: + try: + args_str, opts = self._line_parser(line) + except OptionParsingError as e: + # add offending line + msg = 'Invalid requirement: %s\n%s' % (line, e.msg) + raise RequirementsFileParseError(msg) + + yield ParsedLine( + filename, + line_number, + self._comes_from, + args_str, + opts, + constraint, + ) + + +def get_line_parser(finder): + # type: (Optional[PackageFinder]) -> LineParser + def parse_line(line): + # type: (Text) -> Tuple[str, Values] + # Build new parser for each line since it accumulates appendable + # options. + parser = build_parser() + defaults = parser.get_default_values() + defaults.index_url = None + if finder: + defaults.format_control = finder.format_control + + args_str, options_str = break_args_options(line) + # Prior to 2.7.3, shlex cannot deal with unicode entries + if sys.version_info < (2, 7, 3): + # https://github.com/python/mypy/issues/1174 + options_str = options_str.encode('utf8') # type: ignore + + # https://github.com/python/mypy/issues/1174 + opts, _ = parser.parse_args( + shlex.split(options_str), defaults) # type: ignore + + return args_str, opts + + return parse_line + + +def break_args_options(line): + # type: (Text) -> Tuple[str, Text] + """Break up the line into an args and options string. We only want to shlex + (and then optparse) the options, not the args. args can contain markers + which are corrupted by shlex. + """ + tokens = line.split(' ') + args = [] + options = tokens[:] + for token in tokens: + if token.startswith('-') or token.startswith('--'): + break + else: + args.append(token) + options.pop(0) + return ' '.join(args), ' '.join(options) # type: ignore + + +class OptionParsingError(Exception): + def __init__(self, msg): + # type: (str) -> None + self.msg = msg + + +def build_parser(): + # type: () -> optparse.OptionParser + """ + Return a parser for parsing requirement lines + """ + parser = optparse.OptionParser(add_help_option=False) + + option_factories = SUPPORTED_OPTIONS + SUPPORTED_OPTIONS_REQ + for option_factory in option_factories: + option = option_factory() + parser.add_option(option) + + # By default optparse sys.exits on parsing errors. We want to wrap + # that in our own exception. + def parser_exit(self, msg): + # type: (Any, str) -> NoReturn + raise OptionParsingError(msg) + # NOTE: mypy disallows assigning to a method + # https://github.com/python/mypy/issues/2427 + parser.exit = parser_exit # type: ignore + + return parser + + +def join_lines(lines_enum): + # type: (ReqFileLines) -> ReqFileLines + """Joins a line ending in '\' with the previous line (except when following + comments). The joined line takes on the index of the first line. + """ + primary_line_number = None + new_line = [] # type: List[Text] + for line_number, line in lines_enum: + if not line.endswith('\\') or COMMENT_RE.match(line): + if COMMENT_RE.match(line): + # this ensures comments are always matched later + line = ' ' + line + if new_line: + new_line.append(line) + yield primary_line_number, ''.join(new_line) + new_line = [] + else: + yield line_number, line + else: + if not new_line: + primary_line_number = line_number + new_line.append(line.strip('\\')) + + # last line contains \ + if new_line: + yield primary_line_number, ''.join(new_line) + + # TODO: handle space after '\'. + + +def ignore_comments(lines_enum): + # type: (ReqFileLines) -> ReqFileLines + """ + Strips comments and filter empty lines. + """ + for line_number, line in lines_enum: + line = COMMENT_RE.sub('', line) + line = line.strip() + if line: + yield line_number, line + + +def skip_regex(lines_enum, pattern): + # type: (ReqFileLines, str) -> ReqFileLines + """ + Skip lines that match the provided pattern + + Note: the regex pattern is only built once + """ + matcher = re.compile(pattern) + lines_enum = filterfalse(lambda e: matcher.search(e[1]), lines_enum) + return lines_enum + + +def expand_env_variables(lines_enum): + # type: (ReqFileLines) -> ReqFileLines + """Replace all environment variables that can be retrieved via `os.getenv`. + + The only allowed format for environment variables defined in the + requirement file is `${MY_VARIABLE_1}` to ensure two things: + + 1. Strings that contain a `$` aren't accidentally (partially) expanded. + 2. Ensure consistency across platforms for requirement files. + + These points are the result of a discussion on the `github pull + request #3514 `_. + + Valid characters in variable names follow the `POSIX standard + `_ and are limited + to uppercase letter, digits and the `_` (underscore). + """ + for line_number, line in lines_enum: + for env_var, var_name in ENV_VAR_RE.findall(line): + value = os.getenv(var_name) + if not value: + continue + + line = line.replace(env_var, value) + + yield line_number, line + + +def get_file_content(url, session, comes_from=None): + # type: (str, PipSession, Optional[str]) -> Tuple[str, Text] + """Gets the content of a file; it may be a filename, file: URL, or + http: URL. Returns (location, content). Content is unicode. + Respects # -*- coding: declarations on the retrieved files. + + :param url: File path or url. + :param session: PipSession instance. + :param comes_from: Origin description of requirements. + """ + scheme = get_url_scheme(url) + + if scheme in ['http', 'https']: + # FIXME: catch some errors + resp = session.get(url) + resp.raise_for_status() + return resp.url, resp.text + + elif scheme == 'file': + if comes_from and comes_from.startswith('http'): + raise InstallationError( + 'Requirements file %s references URL %s, which is local' + % (comes_from, url)) + + path = url.split(':', 1)[1] + path = path.replace('\\', '/') + match = _url_slash_drive_re.match(path) + if match: + path = match.group(1) + ':' + path.split('|', 1)[1] + path = urllib_parse.unquote(path) + if path.startswith('/'): + path = '/' + path.lstrip('/') + url = path + + try: + with open(url, 'rb') as f: + content = auto_decode(f.read()) + except IOError as exc: + raise InstallationError( + 'Could not open requirements file: %s' % str(exc) + ) + return url, content + + +_url_slash_drive_re = re.compile(r'/*([a-z])\|', re.I) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/req/req_install.py b/venv/lib/python3.8/site-packages/pip/_internal/req/req_install.py new file mode 100644 index 000000000..22ac24b96 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/req/req_install.py @@ -0,0 +1,830 @@ +# The following comment should be removed at some point in the future. +# mypy: strict-optional=False + +from __future__ import absolute_import + +import logging +import os +import shutil +import sys +import zipfile + +from pip._vendor import pkg_resources, six +from pip._vendor.packaging.requirements import Requirement +from pip._vendor.packaging.utils import canonicalize_name +from pip._vendor.packaging.version import Version +from pip._vendor.packaging.version import parse as parse_version +from pip._vendor.pep517.wrappers import Pep517HookCaller + +from pip._internal import pep425tags +from pip._internal.build_env import NoOpBuildEnvironment +from pip._internal.exceptions import InstallationError +from pip._internal.locations import get_scheme +from pip._internal.models.link import Link +from pip._internal.operations.build.metadata import generate_metadata +from pip._internal.operations.build.metadata_legacy import \ + generate_metadata as generate_metadata_legacy +from pip._internal.operations.install.editable_legacy import \ + install_editable as install_editable_legacy +from pip._internal.operations.install.legacy import install as install_legacy +from pip._internal.operations.install.wheel import install_wheel +from pip._internal.pyproject import load_pyproject_toml, make_pyproject_path +from pip._internal.req.req_uninstall import UninstallPathSet +from pip._internal.utils.deprecation import deprecated +from pip._internal.utils.hashes import Hashes +from pip._internal.utils.logging import indent_log +from pip._internal.utils.marker_files import ( + PIP_DELETE_MARKER_FILENAME, + has_delete_marker_file, + write_delete_marker_file, +) +from pip._internal.utils.misc import ( + ask_path_exists, + backup_dir, + display_path, + dist_in_site_packages, + dist_in_usersite, + get_installed_version, + hide_url, + redact_auth_from_url, + rmtree, +) +from pip._internal.utils.packaging import get_metadata +from pip._internal.utils.temp_dir import TempDirectory +from pip._internal.utils.typing import MYPY_CHECK_RUNNING +from pip._internal.utils.virtualenv import running_under_virtualenv +from pip._internal.vcs import vcs + +if MYPY_CHECK_RUNNING: + from typing import ( + Any, Dict, Iterable, List, Optional, Sequence, Union, + ) + from pip._internal.build_env import BuildEnvironment + from pip._internal.cache import WheelCache + from pip._internal.index.package_finder import PackageFinder + from pip._vendor.pkg_resources import Distribution + from pip._vendor.packaging.specifiers import SpecifierSet + from pip._vendor.packaging.markers import Marker + + +logger = logging.getLogger(__name__) + + +def _get_dist(metadata_directory): + # type: (str) -> Distribution + """Return a pkg_resources.Distribution for the provided + metadata directory. + """ + dist_dir = metadata_directory.rstrip(os.sep) + + # Determine the correct Distribution object type. + if dist_dir.endswith(".egg-info"): + dist_cls = pkg_resources.Distribution + else: + assert dist_dir.endswith(".dist-info") + dist_cls = pkg_resources.DistInfoDistribution + + # Build a PathMetadata object, from path to metadata. :wink: + base_dir, dist_dir_name = os.path.split(dist_dir) + dist_name = os.path.splitext(dist_dir_name)[0] + metadata = pkg_resources.PathMetadata(base_dir, dist_dir) + + return dist_cls( + base_dir, + project_name=dist_name, + metadata=metadata, + ) + + +class InstallRequirement(object): + """ + Represents something that may be installed later on, may have information + about where to fetch the relevant requirement and also contains logic for + installing the said requirement. + """ + + def __init__( + self, + req, # type: Optional[Requirement] + comes_from, # type: Optional[Union[str, InstallRequirement]] + source_dir=None, # type: Optional[str] + editable=False, # type: bool + link=None, # type: Optional[Link] + markers=None, # type: Optional[Marker] + use_pep517=None, # type: Optional[bool] + isolated=False, # type: bool + options=None, # type: Optional[Dict[str, Any]] + wheel_cache=None, # type: Optional[WheelCache] + constraint=False, # type: bool + extras=() # type: Iterable[str] + ): + # type: (...) -> None + assert req is None or isinstance(req, Requirement), req + self.req = req + self.comes_from = comes_from + self.constraint = constraint + if source_dir is None: + self.source_dir = None # type: Optional[str] + else: + self.source_dir = os.path.normpath(os.path.abspath(source_dir)) + self.editable = editable + + self._wheel_cache = wheel_cache + if link is None and req and req.url: + # PEP 508 URL requirement + link = Link(req.url) + self.link = self.original_link = link + # Path to any downloaded or already-existing package. + self.local_file_path = None # type: Optional[str] + if self.link and self.link.is_file: + self.local_file_path = self.link.file_path + + if extras: + self.extras = extras + elif req: + self.extras = { + pkg_resources.safe_extra(extra) for extra in req.extras + } + else: + self.extras = set() + if markers is None and req: + markers = req.marker + self.markers = markers + + # This holds the pkg_resources.Distribution object if this requirement + # is already available: + self.satisfied_by = None # type: Optional[Distribution] + # Whether the installation process should try to uninstall an existing + # distribution before installing this requirement. + self.should_reinstall = False + # Temporary build location + self._temp_build_dir = None # type: Optional[TempDirectory] + # Set to True after successful installation + self.install_succeeded = None # type: Optional[bool] + self.options = options if options else {} + # Set to True after successful preparation of this requirement + self.prepared = False + self.is_direct = False + + self.isolated = isolated + self.build_env = NoOpBuildEnvironment() # type: BuildEnvironment + + # For PEP 517, the directory where we request the project metadata + # gets stored. We need this to pass to build_wheel, so the backend + # can ensure that the wheel matches the metadata (see the PEP for + # details). + self.metadata_directory = None # type: Optional[str] + + # The static build requirements (from pyproject.toml) + self.pyproject_requires = None # type: Optional[List[str]] + + # Build requirements that we will check are available + self.requirements_to_check = [] # type: List[str] + + # The PEP 517 backend we should use to build the project + self.pep517_backend = None # type: Optional[Pep517HookCaller] + + # Are we using PEP 517 for this requirement? + # After pyproject.toml has been loaded, the only valid values are True + # and False. Before loading, None is valid (meaning "use the default"). + # Setting an explicit value before loading pyproject.toml is supported, + # but after loading this flag should be treated as read only. + self.use_pep517 = use_pep517 + + def __str__(self): + # type: () -> str + if self.req: + s = str(self.req) + if self.link: + s += ' from %s' % redact_auth_from_url(self.link.url) + elif self.link: + s = redact_auth_from_url(self.link.url) + else: + s = '' + if self.satisfied_by is not None: + s += ' in %s' % display_path(self.satisfied_by.location) + if self.comes_from: + if isinstance(self.comes_from, six.string_types): + comes_from = self.comes_from # type: Optional[str] + else: + comes_from = self.comes_from.from_path() + if comes_from: + s += ' (from %s)' % comes_from + return s + + def __repr__(self): + # type: () -> str + return '<%s object: %s editable=%r>' % ( + self.__class__.__name__, str(self), self.editable) + + def format_debug(self): + # type: () -> str + """An un-tested helper for getting state, for debugging. + """ + attributes = vars(self) + names = sorted(attributes) + + state = ( + "{}={!r}".format(attr, attributes[attr]) for attr in sorted(names) + ) + return '<{name} object: {{{state}}}>'.format( + name=self.__class__.__name__, + state=", ".join(state), + ) + + def populate_link(self, finder, upgrade, require_hashes): + # type: (PackageFinder, bool, bool) -> None + """Ensure that if a link can be found for this, that it is found. + + Note that self.link may still be None - if Upgrade is False and the + requirement is already installed. + + If require_hashes is True, don't use the wheel cache, because cached + wheels, always built locally, have different hashes than the files + downloaded from the index server and thus throw false hash mismatches. + Furthermore, cached wheels at present have undeterministic contents due + to file modification times. + """ + if self.link is None: + self.link = finder.find_requirement(self, upgrade) + if self._wheel_cache is not None and not require_hashes: + old_link = self.link + supported_tags = pep425tags.get_supported() + self.link = self._wheel_cache.get( + link=self.link, + package_name=self.name, + supported_tags=supported_tags, + ) + if old_link != self.link: + logger.debug('Using cached wheel link: %s', self.link) + + # Things that are valid for all kinds of requirements? + @property + def name(self): + # type: () -> Optional[str] + if self.req is None: + return None + return six.ensure_str(pkg_resources.safe_name(self.req.name)) + + @property + def specifier(self): + # type: () -> SpecifierSet + return self.req.specifier + + @property + def is_pinned(self): + # type: () -> bool + """Return whether I am pinned to an exact version. + + For example, some-package==1.2 is pinned; some-package>1.2 is not. + """ + specifiers = self.specifier + return (len(specifiers) == 1 and + next(iter(specifiers)).operator in {'==', '==='}) + + @property + def installed_version(self): + # type: () -> Optional[str] + return get_installed_version(self.name) + + def match_markers(self, extras_requested=None): + # type: (Optional[Iterable[str]]) -> bool + if not extras_requested: + # Provide an extra to safely evaluate the markers + # without matching any extra + extras_requested = ('',) + if self.markers is not None: + return any( + self.markers.evaluate({'extra': extra}) + for extra in extras_requested) + else: + return True + + @property + def has_hash_options(self): + # type: () -> bool + """Return whether any known-good hashes are specified as options. + + These activate --require-hashes mode; hashes specified as part of a + URL do not. + + """ + return bool(self.options.get('hashes', {})) + + def hashes(self, trust_internet=True): + # type: (bool) -> Hashes + """Return a hash-comparer that considers my option- and URL-based + hashes to be known-good. + + Hashes in URLs--ones embedded in the requirements file, not ones + downloaded from an index server--are almost peers with ones from + flags. They satisfy --require-hashes (whether it was implicitly or + explicitly activated) but do not activate it. md5 and sha224 are not + allowed in flags, which should nudge people toward good algos. We + always OR all hashes together, even ones from URLs. + + :param trust_internet: Whether to trust URL-based (#md5=...) hashes + downloaded from the internet, as by populate_link() + + """ + good_hashes = self.options.get('hashes', {}).copy() + link = self.link if trust_internet else self.original_link + if link and link.hash: + good_hashes.setdefault(link.hash_name, []).append(link.hash) + return Hashes(good_hashes) + + def from_path(self): + # type: () -> Optional[str] + """Format a nice indicator to show where this "comes from" + """ + if self.req is None: + return None + s = str(self.req) + if self.comes_from: + if isinstance(self.comes_from, six.string_types): + comes_from = self.comes_from + else: + comes_from = self.comes_from.from_path() + if comes_from: + s += '->' + comes_from + return s + + def ensure_build_location(self, build_dir): + # type: (str) -> str + assert build_dir is not None + if self._temp_build_dir is not None: + assert self._temp_build_dir.path + return self._temp_build_dir.path + if self.req is None: + # Some systems have /tmp as a symlink which confuses custom + # builds (such as numpy). Thus, we ensure that the real path + # is returned. + self._temp_build_dir = TempDirectory(kind="req-build") + + return self._temp_build_dir.path + if self.editable: + name = self.name.lower() + else: + name = self.name + # FIXME: Is there a better place to create the build_dir? (hg and bzr + # need this) + if not os.path.exists(build_dir): + logger.debug('Creating directory %s', build_dir) + os.makedirs(build_dir) + write_delete_marker_file(build_dir) + return os.path.join(build_dir, name) + + def _set_requirement(self): + # type: () -> None + """Set requirement after generating metadata. + """ + assert self.req is None + assert self.metadata is not None + assert self.source_dir is not None + + # Construct a Requirement object from the generated metadata + if isinstance(parse_version(self.metadata["Version"]), Version): + op = "==" + else: + op = "===" + + self.req = Requirement( + "".join([ + self.metadata["Name"], + op, + self.metadata["Version"], + ]) + ) + + def warn_on_mismatching_name(self): + # type: () -> None + metadata_name = canonicalize_name(self.metadata["Name"]) + if canonicalize_name(self.req.name) == metadata_name: + # Everything is fine. + return + + # If we're here, there's a mismatch. Log a warning about it. + logger.warning( + 'Generating metadata for package %s ' + 'produced metadata for project name %s. Fix your ' + '#egg=%s fragments.', + self.name, metadata_name, self.name + ) + self.req = Requirement(metadata_name) + + def remove_temporary_source(self): + # type: () -> None + """Remove the source files from this requirement, if they are marked + for deletion""" + if self.source_dir and has_delete_marker_file(self.source_dir): + logger.debug('Removing source in %s', self.source_dir) + rmtree(self.source_dir) + self.source_dir = None + if self._temp_build_dir: + self._temp_build_dir.cleanup() + self._temp_build_dir = None + self.build_env.cleanup() + + def check_if_exists(self, use_user_site): + # type: (bool) -> None + """Find an installed distribution that satisfies or conflicts + with this requirement, and set self.satisfied_by or + self.should_reinstall appropriately. + """ + if self.req is None: + return + # get_distribution() will resolve the entire list of requirements + # anyway, and we've already determined that we need the requirement + # in question, so strip the marker so that we don't try to + # evaluate it. + no_marker = Requirement(str(self.req)) + no_marker.marker = None + try: + self.satisfied_by = pkg_resources.get_distribution(str(no_marker)) + except pkg_resources.DistributionNotFound: + return + except pkg_resources.VersionConflict: + existing_dist = pkg_resources.get_distribution( + self.req.name + ) + if use_user_site: + if dist_in_usersite(existing_dist): + self.should_reinstall = True + elif (running_under_virtualenv() and + dist_in_site_packages(existing_dist)): + raise InstallationError( + "Will not install to the user site because it will " + "lack sys.path precedence to %s in %s" % + (existing_dist.project_name, existing_dist.location) + ) + else: + self.should_reinstall = True + else: + if self.editable and self.satisfied_by: + self.should_reinstall = True + # when installing editables, nothing pre-existing should ever + # satisfy + self.satisfied_by = None + + # Things valid for wheels + @property + def is_wheel(self): + # type: () -> bool + if not self.link: + return False + return self.link.is_wheel + + # Things valid for sdists + @property + def unpacked_source_directory(self): + # type: () -> str + return os.path.join( + self.source_dir, + self.link and self.link.subdirectory_fragment or '') + + @property + def setup_py_path(self): + # type: () -> str + assert self.source_dir, "No source dir for %s" % self + setup_py = os.path.join(self.unpacked_source_directory, 'setup.py') + + # Python2 __file__ should not be unicode + if six.PY2 and isinstance(setup_py, six.text_type): + setup_py = setup_py.encode(sys.getfilesystemencoding()) + + return setup_py + + @property + def pyproject_toml_path(self): + # type: () -> str + assert self.source_dir, "No source dir for %s" % self + return make_pyproject_path(self.unpacked_source_directory) + + def load_pyproject_toml(self): + # type: () -> None + """Load the pyproject.toml file. + + After calling this routine, all of the attributes related to PEP 517 + processing for this requirement have been set. In particular, the + use_pep517 attribute can be used to determine whether we should + follow the PEP 517 or legacy (setup.py) code path. + """ + pyproject_toml_data = load_pyproject_toml( + self.use_pep517, + self.pyproject_toml_path, + self.setup_py_path, + str(self) + ) + + if pyproject_toml_data is None: + self.use_pep517 = False + return + + self.use_pep517 = True + requires, backend, check, backend_path = pyproject_toml_data + self.requirements_to_check = check + self.pyproject_requires = requires + self.pep517_backend = Pep517HookCaller( + self.unpacked_source_directory, backend, backend_path=backend_path, + ) + + def _generate_metadata(self): + # type: () -> str + """Invokes metadata generator functions, with the required arguments. + """ + if not self.use_pep517: + assert self.unpacked_source_directory + + return generate_metadata_legacy( + build_env=self.build_env, + setup_py_path=self.setup_py_path, + source_dir=self.unpacked_source_directory, + editable=self.editable, + isolated=self.isolated, + details=self.name or "from {}".format(self.link) + ) + + assert self.pep517_backend is not None + + return generate_metadata( + build_env=self.build_env, + backend=self.pep517_backend, + ) + + def prepare_metadata(self): + # type: () -> None + """Ensure that project metadata is available. + + Under PEP 517, call the backend hook to prepare the metadata. + Under legacy processing, call setup.py egg-info. + """ + assert self.source_dir + + with indent_log(): + self.metadata_directory = self._generate_metadata() + + # Act on the newly generated metadata, based on the name and version. + if not self.name: + self._set_requirement() + else: + self.warn_on_mismatching_name() + + self.assert_source_matches_version() + + @property + def metadata(self): + # type: () -> Any + if not hasattr(self, '_metadata'): + self._metadata = get_metadata(self.get_dist()) + + return self._metadata + + def get_dist(self): + # type: () -> Distribution + return _get_dist(self.metadata_directory) + + def assert_source_matches_version(self): + # type: () -> None + assert self.source_dir + version = self.metadata['version'] + if self.req.specifier and version not in self.req.specifier: + logger.warning( + 'Requested %s, but installing version %s', + self, + version, + ) + else: + logger.debug( + 'Source in %s has version %s, which satisfies requirement %s', + display_path(self.source_dir), + version, + self, + ) + + # For both source distributions and editables + def ensure_has_source_dir(self, parent_dir): + # type: (str) -> None + """Ensure that a source_dir is set. + + This will create a temporary build dir if the name of the requirement + isn't known yet. + + :param parent_dir: The ideal pip parent_dir for the source_dir. + Generally src_dir for editables and build_dir for sdists. + :return: self.source_dir + """ + if self.source_dir is None: + self.source_dir = self.ensure_build_location(parent_dir) + + # For editable installations + def update_editable(self, obtain=True): + # type: (bool) -> None + if not self.link: + logger.debug( + "Cannot update repository at %s; repository location is " + "unknown", + self.source_dir, + ) + return + assert self.editable + assert self.source_dir + if self.link.scheme == 'file': + # Static paths don't get updated + return + assert '+' in self.link.url, "bad url: %r" % self.link.url + vc_type, url = self.link.url.split('+', 1) + vcs_backend = vcs.get_backend(vc_type) + if vcs_backend: + if not self.link.is_vcs: + reason = ( + "This form of VCS requirement is being deprecated: {}." + ).format( + self.link.url + ) + replacement = None + if self.link.url.startswith("git+git@"): + replacement = ( + "git+https://git@example.com/..., " + "git+ssh://git@example.com/..., " + "or the insecure git+git://git@example.com/..." + ) + deprecated(reason, replacement, gone_in="21.0", issue=7554) + hidden_url = hide_url(self.link.url) + if obtain: + vcs_backend.obtain(self.source_dir, url=hidden_url) + else: + vcs_backend.export(self.source_dir, url=hidden_url) + else: + assert 0, ( + 'Unexpected version control type (in %s): %s' + % (self.link, vc_type)) + + # Top-level Actions + def uninstall(self, auto_confirm=False, verbose=False): + # type: (bool, bool) -> Optional[UninstallPathSet] + """ + Uninstall the distribution currently satisfying this requirement. + + Prompts before removing or modifying files unless + ``auto_confirm`` is True. + + Refuses to delete or modify files outside of ``sys.prefix`` - + thus uninstallation within a virtual environment can only + modify that virtual environment, even if the virtualenv is + linked to global site-packages. + + """ + assert self.req + try: + dist = pkg_resources.get_distribution(self.req.name) + except pkg_resources.DistributionNotFound: + logger.warning("Skipping %s as it is not installed.", self.name) + return None + else: + logger.info('Found existing installation: %s', dist) + + uninstalled_pathset = UninstallPathSet.from_dist(dist) + uninstalled_pathset.remove(auto_confirm, verbose) + return uninstalled_pathset + + def _get_archive_name(self, path, parentdir, rootdir): + # type: (str, str, str) -> str + + def _clean_zip_name(name, prefix): + # type: (str, str) -> str + assert name.startswith(prefix + os.path.sep), ( + "name %r doesn't start with prefix %r" % (name, prefix) + ) + name = name[len(prefix) + 1:] + name = name.replace(os.path.sep, '/') + return name + + path = os.path.join(parentdir, path) + name = _clean_zip_name(path, rootdir) + return self.name + '/' + name + + def archive(self, build_dir): + # type: (str) -> None + """Saves archive to provided build_dir. + + Used for saving downloaded VCS requirements as part of `pip download`. + """ + assert self.source_dir + + create_archive = True + archive_name = '%s-%s.zip' % (self.name, self.metadata["version"]) + archive_path = os.path.join(build_dir, archive_name) + + if os.path.exists(archive_path): + response = ask_path_exists( + 'The file %s exists. (i)gnore, (w)ipe, (b)ackup, (a)bort ' % + display_path(archive_path), ('i', 'w', 'b', 'a')) + if response == 'i': + create_archive = False + elif response == 'w': + logger.warning('Deleting %s', display_path(archive_path)) + os.remove(archive_path) + elif response == 'b': + dest_file = backup_dir(archive_path) + logger.warning( + 'Backing up %s to %s', + display_path(archive_path), + display_path(dest_file), + ) + shutil.move(archive_path, dest_file) + elif response == 'a': + sys.exit(-1) + + if not create_archive: + return + + zip_output = zipfile.ZipFile( + archive_path, 'w', zipfile.ZIP_DEFLATED, allowZip64=True, + ) + with zip_output: + dir = os.path.normcase( + os.path.abspath(self.unpacked_source_directory) + ) + for dirpath, dirnames, filenames in os.walk(dir): + if 'pip-egg-info' in dirnames: + dirnames.remove('pip-egg-info') + for dirname in dirnames: + dir_arcname = self._get_archive_name( + dirname, parentdir=dirpath, rootdir=dir, + ) + zipdir = zipfile.ZipInfo(dir_arcname + '/') + zipdir.external_attr = 0x1ED << 16 # 0o755 + zip_output.writestr(zipdir, '') + for filename in filenames: + if filename == PIP_DELETE_MARKER_FILENAME: + continue + file_arcname = self._get_archive_name( + filename, parentdir=dirpath, rootdir=dir, + ) + filename = os.path.join(dirpath, filename) + zip_output.write(filename, file_arcname) + + logger.info('Saved %s', display_path(archive_path)) + + def install( + self, + install_options, # type: List[str] + global_options=None, # type: Optional[Sequence[str]] + root=None, # type: Optional[str] + home=None, # type: Optional[str] + prefix=None, # type: Optional[str] + warn_script_location=True, # type: bool + use_user_site=False, # type: bool + pycompile=True # type: bool + ): + # type: (...) -> None + scheme = get_scheme( + self.name, + user=use_user_site, + home=home, + root=root, + isolated=self.isolated, + prefix=prefix, + ) + + global_options = global_options if global_options is not None else [] + if self.editable: + install_editable_legacy( + install_options, + global_options, + prefix=prefix, + home=home, + use_user_site=use_user_site, + name=self.name, + setup_py_path=self.setup_py_path, + isolated=self.isolated, + build_env=self.build_env, + unpacked_source_directory=self.unpacked_source_directory, + ) + self.install_succeeded = True + return + + if self.is_wheel: + assert self.local_file_path + install_wheel( + self.name, + self.local_file_path, + scheme=scheme, + req_description=str(self.req), + pycompile=pycompile, + warn_script_location=warn_script_location, + ) + self.install_succeeded = True + return + + install_legacy( + self, + install_options=install_options, + global_options=global_options, + root=root, + home=home, + prefix=prefix, + use_user_site=use_user_site, + pycompile=pycompile, + scheme=scheme, + ) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/req/req_set.py b/venv/lib/python3.8/site-packages/pip/_internal/req/req_set.py new file mode 100644 index 000000000..087ac5925 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/req/req_set.py @@ -0,0 +1,209 @@ +# The following comment should be removed at some point in the future. +# mypy: strict-optional=False + +from __future__ import absolute_import + +import logging +from collections import OrderedDict + +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal import pep425tags +from pip._internal.exceptions import InstallationError +from pip._internal.models.wheel import Wheel +from pip._internal.utils.logging import indent_log +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import Dict, Iterable, List, Optional, Tuple + from pip._internal.req.req_install import InstallRequirement + + +logger = logging.getLogger(__name__) + + +class RequirementSet(object): + + def __init__(self, check_supported_wheels=True): + # type: (bool) -> None + """Create a RequirementSet. + """ + + self.requirements = OrderedDict() # type: Dict[str, InstallRequirement] # noqa: E501 + self.check_supported_wheels = check_supported_wheels + + self.unnamed_requirements = [] # type: List[InstallRequirement] + self.successfully_downloaded = [] # type: List[InstallRequirement] + self.reqs_to_cleanup = [] # type: List[InstallRequirement] + + def __str__(self): + # type: () -> str + requirements = sorted( + (req for req in self.requirements.values() if not req.comes_from), + key=lambda req: canonicalize_name(req.name), + ) + return ' '.join(str(req.req) for req in requirements) + + def __repr__(self): + # type: () -> str + requirements = sorted( + self.requirements.values(), + key=lambda req: canonicalize_name(req.name), + ) + + format_string = '<{classname} object; {count} requirement(s): {reqs}>' + return format_string.format( + classname=self.__class__.__name__, + count=len(requirements), + reqs=', '.join(str(req.req) for req in requirements), + ) + + def add_unnamed_requirement(self, install_req): + # type: (InstallRequirement) -> None + assert not install_req.name + self.unnamed_requirements.append(install_req) + + def add_named_requirement(self, install_req): + # type: (InstallRequirement) -> None + assert install_req.name + + project_name = canonicalize_name(install_req.name) + self.requirements[project_name] = install_req + + def add_requirement( + self, + install_req, # type: InstallRequirement + parent_req_name=None, # type: Optional[str] + extras_requested=None # type: Optional[Iterable[str]] + ): + # type: (...) -> Tuple[List[InstallRequirement], Optional[InstallRequirement]] # noqa: E501 + """Add install_req as a requirement to install. + + :param parent_req_name: The name of the requirement that needed this + added. The name is used because when multiple unnamed requirements + resolve to the same name, we could otherwise end up with dependency + links that point outside the Requirements set. parent_req must + already be added. Note that None implies that this is a user + supplied requirement, vs an inferred one. + :param extras_requested: an iterable of extras used to evaluate the + environment markers. + :return: Additional requirements to scan. That is either [] if + the requirement is not applicable, or [install_req] if the + requirement is applicable and has just been added. + """ + # If the markers do not match, ignore this requirement. + if not install_req.match_markers(extras_requested): + logger.info( + "Ignoring %s: markers '%s' don't match your environment", + install_req.name, install_req.markers, + ) + return [], None + + # If the wheel is not supported, raise an error. + # Should check this after filtering out based on environment markers to + # allow specifying different wheels based on the environment/OS, in a + # single requirements file. + if install_req.link and install_req.link.is_wheel: + wheel = Wheel(install_req.link.filename) + tags = pep425tags.get_supported() + if (self.check_supported_wheels and not wheel.supported(tags)): + raise InstallationError( + "%s is not a supported wheel on this platform." % + wheel.filename + ) + + # This next bit is really a sanity check. + assert install_req.is_direct == (parent_req_name is None), ( + "a direct req shouldn't have a parent and also, " + "a non direct req should have a parent" + ) + + # Unnamed requirements are scanned again and the requirement won't be + # added as a dependency until after scanning. + if not install_req.name: + self.add_unnamed_requirement(install_req) + return [install_req], None + + try: + existing_req = self.get_requirement(install_req.name) + except KeyError: + existing_req = None + + has_conflicting_requirement = ( + parent_req_name is None and + existing_req and + not existing_req.constraint and + existing_req.extras == install_req.extras and + existing_req.req.specifier != install_req.req.specifier + ) + if has_conflicting_requirement: + raise InstallationError( + "Double requirement given: %s (already in %s, name=%r)" + % (install_req, existing_req, install_req.name) + ) + + # When no existing requirement exists, add the requirement as a + # dependency and it will be scanned again after. + if not existing_req: + self.add_named_requirement(install_req) + # We'd want to rescan this requirement later + return [install_req], install_req + + # Assume there's no need to scan, and that we've already + # encountered this for scanning. + if install_req.constraint or not existing_req.constraint: + return [], existing_req + + does_not_satisfy_constraint = ( + install_req.link and + not ( + existing_req.link and + install_req.link.path == existing_req.link.path + ) + ) + if does_not_satisfy_constraint: + self.reqs_to_cleanup.append(install_req) + raise InstallationError( + "Could not satisfy constraints for '%s': " + "installation from path or url cannot be " + "constrained to a version" % install_req.name, + ) + # If we're now installing a constraint, mark the existing + # object for real installation. + existing_req.constraint = False + existing_req.extras = tuple(sorted( + set(existing_req.extras) | set(install_req.extras) + )) + logger.debug( + "Setting %s extras to: %s", + existing_req, existing_req.extras, + ) + # Return the existing requirement for addition to the parent and + # scanning again. + return [existing_req], existing_req + + def has_requirement(self, name): + # type: (str) -> bool + project_name = canonicalize_name(name) + + return ( + project_name in self.requirements and + not self.requirements[project_name].constraint + ) + + def get_requirement(self, name): + # type: (str) -> InstallRequirement + project_name = canonicalize_name(name) + + if project_name in self.requirements: + return self.requirements[project_name] + + raise KeyError("No project with the name %r" % name) + + def cleanup_files(self): + # type: () -> None + """Clean up files, remove builds.""" + logger.debug('Cleaning up...') + with indent_log(): + for req in self.reqs_to_cleanup: + req.remove_temporary_source() diff --git a/venv/lib/python3.8/site-packages/pip/_internal/req/req_tracker.py b/venv/lib/python3.8/site-packages/pip/_internal/req/req_tracker.py new file mode 100644 index 000000000..84e0c0419 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/req/req_tracker.py @@ -0,0 +1,150 @@ +# The following comment should be removed at some point in the future. +# mypy: strict-optional=False + +from __future__ import absolute_import + +import contextlib +import errno +import hashlib +import logging +import os + +from pip._vendor import contextlib2 + +from pip._internal.utils.temp_dir import TempDirectory +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from types import TracebackType + from typing import Dict, Iterator, Optional, Set, Type, Union + from pip._internal.req.req_install import InstallRequirement + from pip._internal.models.link import Link + +logger = logging.getLogger(__name__) + + +@contextlib.contextmanager +def update_env_context_manager(**changes): + # type: (str) -> Iterator[None] + target = os.environ + + # Save values from the target and change them. + non_existent_marker = object() + saved_values = {} # type: Dict[str, Union[object, str]] + for name, new_value in changes.items(): + try: + saved_values[name] = target[name] + except KeyError: + saved_values[name] = non_existent_marker + target[name] = new_value + + try: + yield + finally: + # Restore original values in the target. + for name, original_value in saved_values.items(): + if original_value is non_existent_marker: + del target[name] + else: + assert isinstance(original_value, str) # for mypy + target[name] = original_value + + +@contextlib.contextmanager +def get_requirement_tracker(): + # type: () -> Iterator[RequirementTracker] + root = os.environ.get('PIP_REQ_TRACKER') + with contextlib2.ExitStack() as ctx: + if root is None: + root = ctx.enter_context( + TempDirectory(kind='req-tracker') + ).path + ctx.enter_context(update_env_context_manager(PIP_REQ_TRACKER=root)) + logger.debug("Initialized build tracking at %s", root) + + with RequirementTracker(root) as tracker: + yield tracker + + +class RequirementTracker(object): + + def __init__(self, root): + # type: (str) -> None + self._root = root + self._entries = set() # type: Set[InstallRequirement] + logger.debug("Created build tracker: %s", self._root) + + def __enter__(self): + # type: () -> RequirementTracker + logger.debug("Entered build tracker: %s", self._root) + return self + + def __exit__( + self, + exc_type, # type: Optional[Type[BaseException]] + exc_val, # type: Optional[BaseException] + exc_tb # type: Optional[TracebackType] + ): + # type: (...) -> None + self.cleanup() + + def _entry_path(self, link): + # type: (Link) -> str + hashed = hashlib.sha224(link.url_without_fragment.encode()).hexdigest() + return os.path.join(self._root, hashed) + + def add(self, req): + # type: (InstallRequirement) -> None + """Add an InstallRequirement to build tracking. + """ + + # Get the file to write information about this requirement. + entry_path = self._entry_path(req.link) + + # Try reading from the file. If it exists and can be read from, a build + # is already in progress, so a LookupError is raised. + try: + with open(entry_path) as fp: + contents = fp.read() + except IOError as e: + # if the error is anything other than "file does not exist", raise. + if e.errno != errno.ENOENT: + raise + else: + message = '%s is already being built: %s' % (req.link, contents) + raise LookupError(message) + + # If we're here, req should really not be building already. + assert req not in self._entries + + # Start tracking this requirement. + with open(entry_path, 'w') as fp: + fp.write(str(req)) + self._entries.add(req) + + logger.debug('Added %s to build tracker %r', req, self._root) + + def remove(self, req): + # type: (InstallRequirement) -> None + """Remove an InstallRequirement from build tracking. + """ + + # Delete the created file and the corresponding entries. + os.unlink(self._entry_path(req.link)) + self._entries.remove(req) + + logger.debug('Removed %s from build tracker %r', req, self._root) + + def cleanup(self): + # type: () -> None + for req in set(self._entries): + self.remove(req) + + logger.debug("Removed build tracker: %r", self._root) + + @contextlib.contextmanager + def track(self, req): + # type: (InstallRequirement) -> Iterator[None] + self.add(req) + yield + self.remove(req) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/req/req_uninstall.py b/venv/lib/python3.8/site-packages/pip/_internal/req/req_uninstall.py new file mode 100644 index 000000000..5971b130e --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/req/req_uninstall.py @@ -0,0 +1,644 @@ +from __future__ import absolute_import + +import csv +import functools +import logging +import os +import sys +import sysconfig + +from pip._vendor import pkg_resources + +from pip._internal.exceptions import UninstallationError +from pip._internal.locations import bin_py, bin_user +from pip._internal.utils.compat import WINDOWS, cache_from_source, uses_pycache +from pip._internal.utils.logging import indent_log +from pip._internal.utils.misc import ( + FakeFile, + ask, + dist_in_usersite, + dist_is_local, + egg_link_path, + is_local, + normalize_path, + renames, + rmtree, +) +from pip._internal.utils.temp_dir import AdjacentTempDirectory, TempDirectory +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import ( + Any, Callable, Dict, Iterable, Iterator, List, Optional, Set, Tuple, + ) + from pip._vendor.pkg_resources import Distribution + +logger = logging.getLogger(__name__) + + +def _script_names(dist, script_name, is_gui): + # type: (Distribution, str, bool) -> List[str] + """Create the fully qualified name of the files created by + {console,gui}_scripts for the given ``dist``. + Returns the list of file names + """ + if dist_in_usersite(dist): + bin_dir = bin_user + else: + bin_dir = bin_py + exe_name = os.path.join(bin_dir, script_name) + paths_to_remove = [exe_name] + if WINDOWS: + paths_to_remove.append(exe_name + '.exe') + paths_to_remove.append(exe_name + '.exe.manifest') + if is_gui: + paths_to_remove.append(exe_name + '-script.pyw') + else: + paths_to_remove.append(exe_name + '-script.py') + return paths_to_remove + + +def _unique(fn): + # type: (Callable[..., Iterator[Any]]) -> Callable[..., Iterator[Any]] + @functools.wraps(fn) + def unique(*args, **kw): + # type: (Any, Any) -> Iterator[Any] + seen = set() # type: Set[Any] + for item in fn(*args, **kw): + if item not in seen: + seen.add(item) + yield item + return unique + + +@_unique +def uninstallation_paths(dist): + # type: (Distribution) -> Iterator[str] + """ + Yield all the uninstallation paths for dist based on RECORD-without-.py[co] + + Yield paths to all the files in RECORD. For each .py file in RECORD, add + the .pyc and .pyo in the same directory. + + UninstallPathSet.add() takes care of the __pycache__ .py[co]. + """ + r = csv.reader(FakeFile(dist.get_metadata_lines('RECORD'))) + for row in r: + path = os.path.join(dist.location, row[0]) + yield path + if path.endswith('.py'): + dn, fn = os.path.split(path) + base = fn[:-3] + path = os.path.join(dn, base + '.pyc') + yield path + path = os.path.join(dn, base + '.pyo') + yield path + + +def compact(paths): + # type: (Iterable[str]) -> Set[str] + """Compact a path set to contain the minimal number of paths + necessary to contain all paths in the set. If /a/path/ and + /a/path/to/a/file.txt are both in the set, leave only the + shorter path.""" + + sep = os.path.sep + short_paths = set() # type: Set[str] + for path in sorted(paths, key=len): + should_skip = any( + path.startswith(shortpath.rstrip("*")) and + path[len(shortpath.rstrip("*").rstrip(sep))] == sep + for shortpath in short_paths + ) + if not should_skip: + short_paths.add(path) + return short_paths + + +def compress_for_rename(paths): + # type: (Iterable[str]) -> Set[str] + """Returns a set containing the paths that need to be renamed. + + This set may include directories when the original sequence of paths + included every file on disk. + """ + case_map = dict((os.path.normcase(p), p) for p in paths) + remaining = set(case_map) + unchecked = sorted(set(os.path.split(p)[0] + for p in case_map.values()), key=len) + wildcards = set() # type: Set[str] + + def norm_join(*a): + # type: (str) -> str + return os.path.normcase(os.path.join(*a)) + + for root in unchecked: + if any(os.path.normcase(root).startswith(w) + for w in wildcards): + # This directory has already been handled. + continue + + all_files = set() # type: Set[str] + all_subdirs = set() # type: Set[str] + for dirname, subdirs, files in os.walk(root): + all_subdirs.update(norm_join(root, dirname, d) + for d in subdirs) + all_files.update(norm_join(root, dirname, f) + for f in files) + # If all the files we found are in our remaining set of files to + # remove, then remove them from the latter set and add a wildcard + # for the directory. + if not (all_files - remaining): + remaining.difference_update(all_files) + wildcards.add(root + os.sep) + + return set(map(case_map.__getitem__, remaining)) | wildcards + + +def compress_for_output_listing(paths): + # type: (Iterable[str]) -> Tuple[Set[str], Set[str]] + """Returns a tuple of 2 sets of which paths to display to user + + The first set contains paths that would be deleted. Files of a package + are not added and the top-level directory of the package has a '*' added + at the end - to signify that all it's contents are removed. + + The second set contains files that would have been skipped in the above + folders. + """ + + will_remove = set(paths) + will_skip = set() + + # Determine folders and files + folders = set() + files = set() + for path in will_remove: + if path.endswith(".pyc"): + continue + if path.endswith("__init__.py") or ".dist-info" in path: + folders.add(os.path.dirname(path)) + files.add(path) + + # probably this one https://github.com/python/mypy/issues/390 + _normcased_files = set(map(os.path.normcase, files)) # type: ignore + + folders = compact(folders) + + # This walks the tree using os.walk to not miss extra folders + # that might get added. + for folder in folders: + for dirpath, _, dirfiles in os.walk(folder): + for fname in dirfiles: + if fname.endswith(".pyc"): + continue + + file_ = os.path.join(dirpath, fname) + if (os.path.isfile(file_) and + os.path.normcase(file_) not in _normcased_files): + # We are skipping this file. Add it to the set. + will_skip.add(file_) + + will_remove = files | { + os.path.join(folder, "*") for folder in folders + } + + return will_remove, will_skip + + +class StashedUninstallPathSet(object): + """A set of file rename operations to stash files while + tentatively uninstalling them.""" + def __init__(self): + # type: () -> None + # Mapping from source file root to [Adjacent]TempDirectory + # for files under that directory. + self._save_dirs = {} # type: Dict[str, TempDirectory] + # (old path, new path) tuples for each move that may need + # to be undone. + self._moves = [] # type: List[Tuple[str, str]] + + def _get_directory_stash(self, path): + # type: (str) -> str + """Stashes a directory. + + Directories are stashed adjacent to their original location if + possible, or else moved/copied into the user's temp dir.""" + + try: + save_dir = AdjacentTempDirectory(path) # type: TempDirectory + except OSError: + save_dir = TempDirectory(kind="uninstall") + self._save_dirs[os.path.normcase(path)] = save_dir + + return save_dir.path + + def _get_file_stash(self, path): + # type: (str) -> str + """Stashes a file. + + If no root has been provided, one will be created for the directory + in the user's temp directory.""" + path = os.path.normcase(path) + head, old_head = os.path.dirname(path), None + save_dir = None + + while head != old_head: + try: + save_dir = self._save_dirs[head] + break + except KeyError: + pass + head, old_head = os.path.dirname(head), head + else: + # Did not find any suitable root + head = os.path.dirname(path) + save_dir = TempDirectory(kind='uninstall') + self._save_dirs[head] = save_dir + + relpath = os.path.relpath(path, head) + if relpath and relpath != os.path.curdir: + return os.path.join(save_dir.path, relpath) + return save_dir.path + + def stash(self, path): + # type: (str) -> str + """Stashes the directory or file and returns its new location. + Handle symlinks as files to avoid modifying the symlink targets. + """ + path_is_dir = os.path.isdir(path) and not os.path.islink(path) + if path_is_dir: + new_path = self._get_directory_stash(path) + else: + new_path = self._get_file_stash(path) + + self._moves.append((path, new_path)) + if (path_is_dir and os.path.isdir(new_path)): + # If we're moving a directory, we need to + # remove the destination first or else it will be + # moved to inside the existing directory. + # We just created new_path ourselves, so it will + # be removable. + os.rmdir(new_path) + renames(path, new_path) + return new_path + + def commit(self): + # type: () -> None + """Commits the uninstall by removing stashed files.""" + for _, save_dir in self._save_dirs.items(): + save_dir.cleanup() + self._moves = [] + self._save_dirs = {} + + def rollback(self): + # type: () -> None + """Undoes the uninstall by moving stashed files back.""" + for p in self._moves: + logger.info("Moving to %s\n from %s", *p) + + for new_path, path in self._moves: + try: + logger.debug('Replacing %s from %s', new_path, path) + if os.path.isfile(new_path) or os.path.islink(new_path): + os.unlink(new_path) + elif os.path.isdir(new_path): + rmtree(new_path) + renames(path, new_path) + except OSError as ex: + logger.error("Failed to restore %s", new_path) + logger.debug("Exception: %s", ex) + + self.commit() + + @property + def can_rollback(self): + # type: () -> bool + return bool(self._moves) + + +class UninstallPathSet(object): + """A set of file paths to be removed in the uninstallation of a + requirement.""" + def __init__(self, dist): + # type: (Distribution) -> None + self.paths = set() # type: Set[str] + self._refuse = set() # type: Set[str] + self.pth = {} # type: Dict[str, UninstallPthEntries] + self.dist = dist + self._moved_paths = StashedUninstallPathSet() + + def _permitted(self, path): + # type: (str) -> bool + """ + Return True if the given path is one we are permitted to + remove/modify, False otherwise. + + """ + return is_local(path) + + def add(self, path): + # type: (str) -> None + head, tail = os.path.split(path) + + # we normalize the head to resolve parent directory symlinks, but not + # the tail, since we only want to uninstall symlinks, not their targets + path = os.path.join(normalize_path(head), os.path.normcase(tail)) + + if not os.path.exists(path): + return + if self._permitted(path): + self.paths.add(path) + else: + self._refuse.add(path) + + # __pycache__ files can show up after 'installed-files.txt' is created, + # due to imports + if os.path.splitext(path)[1] == '.py' and uses_pycache: + self.add(cache_from_source(path)) + + def add_pth(self, pth_file, entry): + # type: (str, str) -> None + pth_file = normalize_path(pth_file) + if self._permitted(pth_file): + if pth_file not in self.pth: + self.pth[pth_file] = UninstallPthEntries(pth_file) + self.pth[pth_file].add(entry) + else: + self._refuse.add(pth_file) + + def remove(self, auto_confirm=False, verbose=False): + # type: (bool, bool) -> None + """Remove paths in ``self.paths`` with confirmation (unless + ``auto_confirm`` is True).""" + + if not self.paths: + logger.info( + "Can't uninstall '%s'. No files were found to uninstall.", + self.dist.project_name, + ) + return + + dist_name_version = ( + self.dist.project_name + "-" + self.dist.version + ) + logger.info('Uninstalling %s:', dist_name_version) + + with indent_log(): + if auto_confirm or self._allowed_to_proceed(verbose): + moved = self._moved_paths + + for_rename = compress_for_rename(self.paths) + + for path in sorted(compact(for_rename)): + moved.stash(path) + logger.debug('Removing file or directory %s', path) + + for pth in self.pth.values(): + pth.remove() + + logger.info('Successfully uninstalled %s', dist_name_version) + + def _allowed_to_proceed(self, verbose): + # type: (bool) -> bool + """Display which files would be deleted and prompt for confirmation + """ + + def _display(msg, paths): + # type: (str, Iterable[str]) -> None + if not paths: + return + + logger.info(msg) + with indent_log(): + for path in sorted(compact(paths)): + logger.info(path) + + if not verbose: + will_remove, will_skip = compress_for_output_listing(self.paths) + else: + # In verbose mode, display all the files that are going to be + # deleted. + will_remove = set(self.paths) + will_skip = set() + + _display('Would remove:', will_remove) + _display('Would not remove (might be manually added):', will_skip) + _display('Would not remove (outside of prefix):', self._refuse) + if verbose: + _display('Will actually move:', compress_for_rename(self.paths)) + + return ask('Proceed (y/n)? ', ('y', 'n')) == 'y' + + def rollback(self): + # type: () -> None + """Rollback the changes previously made by remove().""" + if not self._moved_paths.can_rollback: + logger.error( + "Can't roll back %s; was not uninstalled", + self.dist.project_name, + ) + return + logger.info('Rolling back uninstall of %s', self.dist.project_name) + self._moved_paths.rollback() + for pth in self.pth.values(): + pth.rollback() + + def commit(self): + # type: () -> None + """Remove temporary save dir: rollback will no longer be possible.""" + self._moved_paths.commit() + + @classmethod + def from_dist(cls, dist): + # type: (Distribution) -> UninstallPathSet + dist_path = normalize_path(dist.location) + if not dist_is_local(dist): + logger.info( + "Not uninstalling %s at %s, outside environment %s", + dist.key, + dist_path, + sys.prefix, + ) + return cls(dist) + + if dist_path in {p for p in {sysconfig.get_path("stdlib"), + sysconfig.get_path("platstdlib")} + if p}: + logger.info( + "Not uninstalling %s at %s, as it is in the standard library.", + dist.key, + dist_path, + ) + return cls(dist) + + paths_to_remove = cls(dist) + develop_egg_link = egg_link_path(dist) + develop_egg_link_egg_info = '{}.egg-info'.format( + pkg_resources.to_filename(dist.project_name)) + egg_info_exists = dist.egg_info and os.path.exists(dist.egg_info) + # Special case for distutils installed package + distutils_egg_info = getattr(dist._provider, 'path', None) + + # Uninstall cases order do matter as in the case of 2 installs of the + # same package, pip needs to uninstall the currently detected version + if (egg_info_exists and dist.egg_info.endswith('.egg-info') and + not dist.egg_info.endswith(develop_egg_link_egg_info)): + # if dist.egg_info.endswith(develop_egg_link_egg_info), we + # are in fact in the develop_egg_link case + paths_to_remove.add(dist.egg_info) + if dist.has_metadata('installed-files.txt'): + for installed_file in dist.get_metadata( + 'installed-files.txt').splitlines(): + path = os.path.normpath( + os.path.join(dist.egg_info, installed_file) + ) + paths_to_remove.add(path) + # FIXME: need a test for this elif block + # occurs with --single-version-externally-managed/--record outside + # of pip + elif dist.has_metadata('top_level.txt'): + if dist.has_metadata('namespace_packages.txt'): + namespaces = dist.get_metadata('namespace_packages.txt') + else: + namespaces = [] + for top_level_pkg in [ + p for p + in dist.get_metadata('top_level.txt').splitlines() + if p and p not in namespaces]: + path = os.path.join(dist.location, top_level_pkg) + paths_to_remove.add(path) + paths_to_remove.add(path + '.py') + paths_to_remove.add(path + '.pyc') + paths_to_remove.add(path + '.pyo') + + elif distutils_egg_info: + raise UninstallationError( + "Cannot uninstall {!r}. It is a distutils installed project " + "and thus we cannot accurately determine which files belong " + "to it which would lead to only a partial uninstall.".format( + dist.project_name, + ) + ) + + elif dist.location.endswith('.egg'): + # package installed by easy_install + # We cannot match on dist.egg_name because it can slightly vary + # i.e. setuptools-0.6c11-py2.6.egg vs setuptools-0.6rc11-py2.6.egg + paths_to_remove.add(dist.location) + easy_install_egg = os.path.split(dist.location)[1] + easy_install_pth = os.path.join(os.path.dirname(dist.location), + 'easy-install.pth') + paths_to_remove.add_pth(easy_install_pth, './' + easy_install_egg) + + elif egg_info_exists and dist.egg_info.endswith('.dist-info'): + for path in uninstallation_paths(dist): + paths_to_remove.add(path) + + elif develop_egg_link: + # develop egg + with open(develop_egg_link, 'r') as fh: + link_pointer = os.path.normcase(fh.readline().strip()) + assert (link_pointer == dist.location), ( + 'Egg-link %s does not match installed location of %s ' + '(at %s)' % (link_pointer, dist.project_name, dist.location) + ) + paths_to_remove.add(develop_egg_link) + easy_install_pth = os.path.join(os.path.dirname(develop_egg_link), + 'easy-install.pth') + paths_to_remove.add_pth(easy_install_pth, dist.location) + + else: + logger.debug( + 'Not sure how to uninstall: %s - Check: %s', + dist, dist.location, + ) + + # find distutils scripts= scripts + if dist.has_metadata('scripts') and dist.metadata_isdir('scripts'): + for script in dist.metadata_listdir('scripts'): + if dist_in_usersite(dist): + bin_dir = bin_user + else: + bin_dir = bin_py + paths_to_remove.add(os.path.join(bin_dir, script)) + if WINDOWS: + paths_to_remove.add(os.path.join(bin_dir, script) + '.bat') + + # find console_scripts + _scripts_to_remove = [] + console_scripts = dist.get_entry_map(group='console_scripts') + for name in console_scripts.keys(): + _scripts_to_remove.extend(_script_names(dist, name, False)) + # find gui_scripts + gui_scripts = dist.get_entry_map(group='gui_scripts') + for name in gui_scripts.keys(): + _scripts_to_remove.extend(_script_names(dist, name, True)) + + for s in _scripts_to_remove: + paths_to_remove.add(s) + + return paths_to_remove + + +class UninstallPthEntries(object): + def __init__(self, pth_file): + # type: (str) -> None + if not os.path.isfile(pth_file): + raise UninstallationError( + "Cannot remove entries from nonexistent file %s" % pth_file + ) + self.file = pth_file + self.entries = set() # type: Set[str] + self._saved_lines = None # type: Optional[List[bytes]] + + def add(self, entry): + # type: (str) -> None + entry = os.path.normcase(entry) + # On Windows, os.path.normcase converts the entry to use + # backslashes. This is correct for entries that describe absolute + # paths outside of site-packages, but all the others use forward + # slashes. + # os.path.splitdrive is used instead of os.path.isabs because isabs + # treats non-absolute paths with drive letter markings like c:foo\bar + # as absolute paths. It also does not recognize UNC paths if they don't + # have more than "\\sever\share". Valid examples: "\\server\share\" or + # "\\server\share\folder". Python 2.7.8+ support UNC in splitdrive. + if WINDOWS and not os.path.splitdrive(entry)[0]: + entry = entry.replace('\\', '/') + self.entries.add(entry) + + def remove(self): + # type: () -> None + logger.debug('Removing pth entries from %s:', self.file) + with open(self.file, 'rb') as fh: + # windows uses '\r\n' with py3k, but uses '\n' with py2.x + lines = fh.readlines() + self._saved_lines = lines + if any(b'\r\n' in line for line in lines): + endline = '\r\n' + else: + endline = '\n' + # handle missing trailing newline + if lines and not lines[-1].endswith(endline.encode("utf-8")): + lines[-1] = lines[-1] + endline.encode("utf-8") + for entry in self.entries: + try: + logger.debug('Removing entry: %s', entry) + lines.remove((entry + endline).encode("utf-8")) + except ValueError: + pass + with open(self.file, 'wb') as fh: + fh.writelines(lines) + + def rollback(self): + # type: () -> bool + if self._saved_lines is None: + logger.error( + 'Cannot roll back changes to %s, none were made', self.file + ) + return False + logger.debug('Rolling %s back to previous state', self.file) + with open(self.file, 'wb') as fh: + fh.writelines(self._saved_lines) + return True diff --git a/venv/lib/python3.8/site-packages/pip/_internal/self_outdated_check.py b/venv/lib/python3.8/site-packages/pip/_internal/self_outdated_check.py new file mode 100644 index 000000000..8fc3c594a --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/self_outdated_check.py @@ -0,0 +1,242 @@ +# The following comment should be removed at some point in the future. +# mypy: disallow-untyped-defs=False + +from __future__ import absolute_import + +import datetime +import hashlib +import json +import logging +import os.path +import sys + +from pip._vendor import pkg_resources +from pip._vendor.packaging import version as packaging_version +from pip._vendor.six import ensure_binary + +from pip._internal.index.collector import LinkCollector +from pip._internal.index.package_finder import PackageFinder +from pip._internal.models.search_scope import SearchScope +from pip._internal.models.selection_prefs import SelectionPreferences +from pip._internal.utils.filesystem import ( + adjacent_tmp_file, + check_path_owner, + replace, +) +from pip._internal.utils.misc import ( + ensure_dir, + get_installed_version, + redact_auth_from_url, +) +from pip._internal.utils.packaging import get_installer +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + import optparse + from optparse import Values + from typing import Any, Dict, Text, Union + + from pip._internal.network.session import PipSession + + +SELFCHECK_DATE_FMT = "%Y-%m-%dT%H:%M:%SZ" + + +logger = logging.getLogger(__name__) + + +def make_link_collector( + session, # type: PipSession + options, # type: Values + suppress_no_index=False, # type: bool +): + # type: (...) -> LinkCollector + """ + :param session: The Session to use to make requests. + :param suppress_no_index: Whether to ignore the --no-index option + when constructing the SearchScope object. + """ + index_urls = [options.index_url] + options.extra_index_urls + if options.no_index and not suppress_no_index: + logger.debug( + 'Ignoring indexes: %s', + ','.join(redact_auth_from_url(url) for url in index_urls), + ) + index_urls = [] + + # Make sure find_links is a list before passing to create(). + find_links = options.find_links or [] + + search_scope = SearchScope.create( + find_links=find_links, index_urls=index_urls, + ) + + link_collector = LinkCollector(session=session, search_scope=search_scope) + + return link_collector + + +def _get_statefile_name(key): + # type: (Union[str, Text]) -> str + key_bytes = ensure_binary(key) + name = hashlib.sha224(key_bytes).hexdigest() + return name + + +class SelfCheckState(object): + def __init__(self, cache_dir): + # type: (str) -> None + self.state = {} # type: Dict[str, Any] + self.statefile_path = None + + # Try to load the existing state + if cache_dir: + self.statefile_path = os.path.join( + cache_dir, "selfcheck", _get_statefile_name(self.key) + ) + try: + with open(self.statefile_path) as statefile: + self.state = json.load(statefile) + except (IOError, ValueError, KeyError): + # Explicitly suppressing exceptions, since we don't want to + # error out if the cache file is invalid. + pass + + @property + def key(self): + return sys.prefix + + def save(self, pypi_version, current_time): + # type: (str, datetime.datetime) -> None + # If we do not have a path to cache in, don't bother saving. + if not self.statefile_path: + return + + # Check to make sure that we own the directory + if not check_path_owner(os.path.dirname(self.statefile_path)): + return + + # Now that we've ensured the directory is owned by this user, we'll go + # ahead and make sure that all our directories are created. + ensure_dir(os.path.dirname(self.statefile_path)) + + state = { + # Include the key so it's easy to tell which pip wrote the + # file. + "key": self.key, + "last_check": current_time.strftime(SELFCHECK_DATE_FMT), + "pypi_version": pypi_version, + } + + text = json.dumps(state, sort_keys=True, separators=(",", ":")) + + with adjacent_tmp_file(self.statefile_path) as f: + f.write(ensure_binary(text)) + + try: + # Since we have a prefix-specific state file, we can just + # overwrite whatever is there, no need to check. + replace(f.name, self.statefile_path) + except OSError: + # Best effort. + pass + + +def was_installed_by_pip(pkg): + # type: (str) -> bool + """Checks whether pkg was installed by pip + + This is used not to display the upgrade message when pip is in fact + installed by system package manager, such as dnf on Fedora. + """ + try: + dist = pkg_resources.get_distribution(pkg) + return "pip" == get_installer(dist) + except pkg_resources.DistributionNotFound: + return False + + +def pip_self_version_check(session, options): + # type: (PipSession, optparse.Values) -> None + """Check for an update for pip. + + Limit the frequency of checks to once per week. State is stored either in + the active virtualenv or in the user's USER_CACHE_DIR keyed off the prefix + of the pip script path. + """ + installed_version = get_installed_version("pip") + if not installed_version: + return + + pip_version = packaging_version.parse(installed_version) + pypi_version = None + + try: + state = SelfCheckState(cache_dir=options.cache_dir) + + current_time = datetime.datetime.utcnow() + # Determine if we need to refresh the state + if "last_check" in state.state and "pypi_version" in state.state: + last_check = datetime.datetime.strptime( + state.state["last_check"], + SELFCHECK_DATE_FMT + ) + if (current_time - last_check).total_seconds() < 7 * 24 * 60 * 60: + pypi_version = state.state["pypi_version"] + + # Refresh the version if we need to or just see if we need to warn + if pypi_version is None: + # Lets use PackageFinder to see what the latest pip version is + link_collector = make_link_collector( + session, + options=options, + suppress_no_index=True, + ) + + # Pass allow_yanked=False so we don't suggest upgrading to a + # yanked version. + selection_prefs = SelectionPreferences( + allow_yanked=False, + allow_all_prereleases=False, # Explicitly set to False + ) + + finder = PackageFinder.create( + link_collector=link_collector, + selection_prefs=selection_prefs, + ) + best_candidate = finder.find_best_candidate("pip").best_candidate + if best_candidate is None: + return + pypi_version = str(best_candidate.version) + + # save that we've performed a check + state.save(pypi_version, current_time) + + remote_version = packaging_version.parse(pypi_version) + + local_version_is_older = ( + pip_version < remote_version and + pip_version.base_version != remote_version.base_version and + was_installed_by_pip('pip') + ) + + # Determine if our pypi_version is older + if not local_version_is_older: + return + + # We cannot tell how the current pip is available in the current + # command context, so be pragmatic here and suggest the command + # that's always available. This does not accommodate spaces in + # `sys.executable`. + pip_cmd = "{} -m pip".format(sys.executable) + logger.warning( + "You are using pip version %s; however, version %s is " + "available.\nYou should consider upgrading via the " + "'%s install --upgrade pip' command.", + pip_version, pypi_version, pip_cmd + ) + except Exception: + logger.debug( + "There was an error checking the latest version of pip", + exc_info=True, + ) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__init__.py b/venv/lib/python3.8/site-packages/pip/_internal/utils/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/__init__.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/__init__.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..cc1646648984cf6ee22d9556440bce9af9cd62fe GIT binary patch literal 184 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 b$M)*A2VT{C$2(DjWi0&3a=h8PS@Zr6RXjzq literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/deprecation.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/deprecation.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..79f8699b6b62746688cd7f385b65e502495207cc GIT binary patch literal 2855 zcmaJ@U60$w73Gi=#pP=4wH>>y5d%{oK%+E~3iqWj3?p0Hb&NKO;W!^AQZN)}B+*Ne z%*;@0t+g**zZU3Eupj$F`X~6>r~H9F1O?J_Nv&3ni%`&TzBqHwxp&T;FZT8V3(p?| zOa7;4S^uWS_T!@QG5-1=D1;SSf(bigb33#d)t$@-Efy#a#wwgdEKlx-wXHV7s3k|_rr@1EU_bkmzD_R{;3mQ5>9+sToSvY_mYKI z#GbhD(hA=Zm&HY~kDjZ-`P}MXIUWTEd|rqulibW=!_#@0$+^sp=B6mJG@s(lWgd?) zL&kc^k7AXhTl08aRE7&#Dw)J4Epj~wz6VOH&+3cuSQlAkWP}9^Wk%@hl(EthmE9;> zNTu;b6rp+f)2EM~Mt48CfA`PP<1a>|hoc95yLJxpW$k}f(!z0eym#;ZqsRB}9z1#Y z+2|HeXq)Yaq46>P8a}Y36*5q53kHaGef3dV-aEJQtJeNe->Lm5%Hz3=qB@A8mIc&% zQS@CEXYI&8Ek#Q<#Sh;OXT@9&RZ*02c{p6?q!4nbO(j6sa3S->FiXe7a%pBo{`!$#q=rk!}GpFLev=zkY~ z9imvd!aCeh?-@iF-d`GPWv$rCUO6jw)j35ZYj04Aa48S z4C9yI{zh0t-RSr_Y#wZE9&A~w`(AxDDpWd6fhN+k;%FTib&zUZjgu_ax&cskvto*A z(|Ttr&0kQLs_w35_q%m>F0}?jwU0QG(?Y@VlQcun&1LN&24!BxN}E!SI9|RW#$QD+>6Un<^r7gXXmHx>E^Hj7b2n|N?pJf z_3jpm#-uHrO)NHGucf&*ah65v^`e%On^-|p6j{!`>obojj(S2eboNjGPSctbaz z6l${vd65zjpQO0}pbRDnE>fLTn(_vZ(Os%ykqXHtQi?IQSx3u3b`&o)FQGp8a^uPm z`I_G5+s1S<;!rM+3MF`~rd6BvUfewfR_b8P(IxVkM`s5=}lP@58E@ zF{QpW98Oa+tHy(*m?QI)ag$~me0qo#e_%YJ?0EJ#sE`_H`oD)_W&QQtZ|oCxLg$`R z2+r~=q>$I_ON&|G*^QhrO5h$a&0~YaX%Bu^JBv80eIs#Upn%zA$ySSZZck+{pO@;+ zx3m#yj>|mDw~lXYPQ4i1&I<6V?+iAxN8eNC>)Yxbyy^fFmmFqtAv5HOYg>1K=+n<1 zM7REYM4`>aTFMZoHd>xe$PV6?J&gN9rZN(ivm%1OPu#eUdb2S?axmjC7}qfGOo{a<${z}xTqlKHk8ViegF9FF?e>TVQ?B55xj zlgd;I7Z63L)jkzuY%o!Dk( z(j`@T0xtXk98toJe`&6qdgcTdcw@Iw4m+0L_rCYW?|t(;ryCm{f_2~_x?>~smnQ4W z1@aZV;x{k^5zJ6nA`WrEjnF923{60TSra?7F`_o_05_R4sf3k@8@iKfScN$H-Xqq~ z0IU(az&ddX+#r<#?-94acSyCsP2vrWQ6+qr8jCGbTjKCOsgsSLQMgU;F>2hq0d1() zz-sH+s~4~O?Qgp6@A@xKd%bUaUpGu;9VJ34`(&Cks;m?Gqr9@Ga=5#HY(#a&x~t)ZOqXE&+!s-YmTHb$3J0$e=*)i3v+HPv4Jo;Mn6DqVG-a26H{m5 z`_8pFH;F}T&53hi@Q$<>&fJ7rD{oO*B4X)kq_Ql#t=H{9T~oS?Dsh)M|6O{E+7d1G zK&w~3w#PKS@FRaPlT`RZayX|y%s7M&oT8-<{j84Xv1g81@*I>raKKkOZ^u!InL5n?{7U$@5TVj zwR@vY5&THmk%*Jzuu)eQ$U0V@kP(;SO(Mt2WHeO{p`eH=TjVT}s@CnbpLgI|^j~(B zBWT3qv2sQ{o903}rAD>=Hj&B{GoiL1Md&b^GI^)IVJVA5GE(Lsn<)1#tSpwK^iRY; z0JZ;~2jgr)1D<7hlwSmwLW>H7oWc-fa7ok4fF*+v$?+7%7xkYPfrf_RrS_;@>JDV zZvUXW&W^gPZLPgkqP4fa4cJka*L3kpoK5nCQNF4BY5m1W*UaNW!{?KXOd0)B%Mv~q U7Z;CFH!Qqu-m)_GkL7vh|2uA6b^rhX literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/filesystem.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/filesystem.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..39fbc0769428f0956946d8542a3f7cf8d5ea964c GIT binary patch literal 4064 zcmZ`+U2hx572Pi`R}?MNvMf7}?QDajFjIwe?Iv;3AaJb6j_O8oBs-E94K^#zP+Dra zOU(>rNuc^*8BOvKz_0@`tvZjfg%IjvY5r}%!-Ds9oc5=9JX%cnz0vorY%J!)B2H* z*2&7-s!%SOA^sA~G9>_m4g8Z&)AJK3#8HPbI=r@G_Oc=vR4+P3(( z_#5^JvWf1Q=uCGqnzXIk78_xe#}=#bGkb1ymW{INV=FqxPOvewudtJ>hW0!U*eN#t z*xIwBS9z74W)tkpcTRMHkBNWt3v7~|HFFp93ctYZ&PA-d$j-4>@a!dap1q3pHD)hb z^$Sl(M{{*skF|@MSrn<^i z+)LD2+)r8E(c_;zxceZU{&Z&gPP}k`Zf^SzDZd)Kovl&9$P-o1!RsNpHQmDO&~OO{w~f=c>8M^UY?Kt~7hwYOTnxHLf>h zs`%Tzq_qx>$!0I@HRBXY6nT<0`zp<3vkj%mZK-&-(c9J@4bRe198{LObMgOOqCqR? z>Lne-aSk)Yv982%w_yE@`qenz=qK6XOwbcWj|;UeYESR-{8r*5$wpC4q8J?nwqqN~ zF;$V`0~DjGeRP!7v6;Q@$O+{rmpOZmJV(k`ZpYg%4XguOURM4i7--iXSOa_A6@NB! zWttP;D0e?Nu$Z^*h^?Kf8W{ktyUvo8PkNTBtXD*C!#1|{z+$CEYuOq&w3hbYA05zJ zss|WtOqss7e}Z;(@UC6R=!v>Nr%Mmh{MuDr1_(LucTbS9Z`H@N3$5#*mnEuQh^{WL zB{ES;Xs3|cBe?2PDw7qd$3B)4x=V|EMuln(siYuv2_Ka%&o2(={G`?55*sYV z^LKQarLc6D*In@{ErS{OW?J-R6g>5Z7tEk*tu@|SAG%BNFz4bT9+a0*S>A;0IW@<# z1H0-}UB|B4W9SEvP1xcMtY{g~&|3Tm%T*L(ErHHXONuov=-~`KDEfk6zt)ODePHd_Q08h?jPA3Q;%S++*t+< zLjUg0AD2YZ3*{Ptz0oRq+gC5w!A9@k`W0aVoa>HCCkm!qJ}mh#rFPm{dhC?j~C??v!ln%EKg8L!2IC7Gjxaao`39 zFEPtohivh|kS%~wcVLrIk2269Paxb55$g>RiW?fO7zf0lTWs>WBi_P$#4o6N7LHBe z(q+Lx;w|3AoHQ98sIdlW#1%h=>=pTi|;sy~O0*=-3DflRavOUU^oSoHaqV6zl1Bn0wD5?a5u8?s|+E<-@{K)9D06|;9i1>Zt#%-ypQU;eS{3~c7@+h1F4o0XXVIKW()=JtS; zv(~PwoQ`Yam3!dqdOMfEa^Ap$w1nc{L_F%0Z(5iuAwJy&;sV5{zuVTXZ(BQ82YzQn zjdUt7*&mh=ll~fR)DC5%kp0ETC>akHtw)Axkfr#)_m{DDqqdCQ_p5`F!K{PK0?bNS zW+TWqYHEyC_7LqTRjiNBMVE)BG#VSy0rIhSD%aYuA{R1l^})J=#nBtdN{jLK>RQ@a z&$@Zh+YrbeHy>_o?_Bxi)oZ_c=iT?NzyE|#tdDE-DR8fmMk(JezOY?PIo5?p*QRH1<-Nf{Ic}T|Z()I0Be1dk!!cLoM`!H+b&(uS)gl0%?W%xY> zFYy}^y-8JrDoXiv#kM<=WHla!ThmsMJ5H?L*Ga08zP)vGY!bvn1 zAF?r8d;}T-HuPXrafD-@BQN-H_|ftar8bhRft>cpA6x^qBI89qL^)Bd99#&_1r*6n OS0O>ZG*T%Ar~d~q)9>Q| literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/filetypes.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/filetypes.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..9db53ecf7556cde361188516d3a96c606ee3dadf GIT binary patch literal 585 zcmY+B&u`N(6vrJmX?{S9G$AJKv}+E;(zqaj5L=beiY-iS2b&K>Y3;VwoY+d-j`~01 zU&@se{{olI$toz%dSChTeX^dPeckH?z{FVq=sO6&uLkzRc;KVS>cR*C7!ZpE=7LaEsWqX6LK|9a5N9(aw`wJd zH_=;EF-2d?Y<`z5X@$&e=IvOoeNEiqzmKw41Q&|NBuyK1((G(s}2J!#z79&2Wt zRifmoya6xJUh+zFhq&SuxZ)cpfwtNk#`666n;)O^opaJ|dkD%C579qb2>q!CHw%Hm z9=zfgs8W>T92IzgvF?+c3`o-&0|QzkHw$ZEVMHzd7{+F97tX*b+<^=6R%-u>1{nXj>`iqfYxTI0bdEx)+}bme-O-Sy3@ALzvtC@$~s=)cbzF_d|4i z5{3uivkp=2Q6)20#<{Xy)KyLsy~E9dVbFtD!0#c6E>Y!4e2L&RJp1aH%9@wLKhLwX z#GgK_S6fGA;2`h)tRS(|$RZc4^ zen;Ge%QV&BgJ8r88gRy{xEco&k+75oLe?oQWiX-TB!J5W)l`mH`KbG4ATmimtKwuF zpHmT3SrtTCDJcgGf?8&|2%4k2)l}Vo(q`i5qxf3ZD^7f#@uMY|N3d1 z=Vy>J{}277N!Kpd8VZ#aizLfBp0bzoYV)8G=MqA*_ub(kWL#NC=Tt^oP-{y0Hmp}} z5+$RUN0o9o6?$joWgsab<1(Q@AE?GosZRfn$=}mU-mW-Hs1Q*Z7gRvbQ~p5DZ{85y zU4|S8_yk_D3l%a6Zs9HL+8!p@!&`=HxY#Bh_6XOJxA@Y(sRhvR^#OFWT`bTXY;WxH zZJo}kF-Jq)E|dDV7m(1B`6&ef78!Vj9MRiu;(0!lwb8`B)Gnp7erXuO{}iBlxb~io z|9X@qBiL{l*SXYt)1s2ob#${?R{BXSmS^RRjqA!E#vuG|^EHGFM*JhVzOowqcW|R~ zu+a7`Ke&UOa@U-_g0(^?E^=(_Vw3QXq2FmMFN%gWI3|rEu7Tp(OL!Y9^*$I;_g^FG zHb&G1lEE^$p#$vIK#PJ~y3#(=h^AqpIpfBa8i&-HQ|{w}rFBlf(MyHSr54D|B`sp& Mw+z>Ix82YG0R>FQvj6}9 literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/hashes.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/hashes.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..65f2d825a807a065b8d42014d72e9852feb4ef4b GIT binary patch literal 4173 zcmbVPTW=f36`t8$u9g%@T`ViUrP!ivTmmtf#BmT9s%yt~ETIkUO1{LKr0dnrkX&h)S(pnTBtc1y!B9z49AE{PAM`SQ_UIS zOk_D$RCdZy#i^)orEoT?I#ty-!&+2#>Xh)h_#5mo6V65R&V01sEJTaWVsyc|5G^@N zO4fq?FFF@N_M-SJ$d*GbT6UHxiK{TG!00_3v03L5n`Kp2>*~(sM}*bc+yP;8{K~%W zT!ryGTY&KbzY61POxqxh#ec)CNQ35c-e#7B1IgVWN)sX54LvUhk_&jEEVr=R=et>6 z!QQqP4tNG4)m1O+eHCPpC;eVNJ04|0+|3u(;!JvB=*b|79}1BOIA&IGkGXzt5ce|} zE`Ig$$xHYC>cjiLbJw4>+iUGdjZ$tr2z;3vzYj8*TVDjRCwA8!=TKMGlO3XYU`_wVn46_c1GsDWP0&feg4ev6mu{yjfY>v&tdzLM*MR-@) z1-1n5nzHqBZlaPr8+!Nb9pR-Z7q;wq(%u{dA~q_TneF$u z-_JmtN4D4X0pl#2S?_BFWBXJBn7(Lmq=cwB|k^4)u|KMB%Rb3VA`c z>IRX9EOoSgMXXZrG$qnxbfhl>RNm5;An`RkBi!NIo*`#On%b?tR~nTLt&wp=0Uh6N zJ(1<{jQy>)r|+2~^RRNHP9N!)N#7LPkOqL*x3)**aCW5OIz>ME@a=u15L;0NS^x>A zAQE617$6BryCagwMvC_~frud73$BLVam+GLdd-4nFs#?TAmcWgZjuM=pkv3dr>(NW zl<4r{vse+9q7}s-x9wkL?M77~cnhD-pmGq;xgPVKyz(4VjY=PR`RQ(2bcKcDh^yQj zq@WNN2sFR|e^dB9H(h~>HD(HQn8iJEqnpS~e1O6w^(i;-JV%G`XR)%RNY@=(X`How z3rjPkC1M%0PBpp+e@mK0tF*4oL*Jsqt7r|LHP2gr3QZG6P-vQmJqsiOA82nO6>Sjl zK70hUoA6TRd8ZWt`VoFWHHrrLKs2Fw0Z)NvZCD$tQCQ+f2Oo1-9o7I`h=icrr$@+K zbm;vwTs*rIg#1Pr^Z_B8uemS(FEqflZlc;{XrPb0lN-46nS14nr|pO$-+=HWY%iZ{ zZIn87Wdz7^!C3;3Qxqh?W#$U6A}tdH-nq0qzB*v>Vvi5V(M zc`T4NCd6Z;p6rQR@a2Cfj&cmd6jKweN{8pGj&i3G2WA|Eih>E=VL~{{Qy-oo&oxyP zK-I82T^%6G0g`xw%_IpGn8Yt&ud_Z#DeY>n$x+P0`+R4k2F46AHi zval^#C4n+NJg0v8c$EDbI@1N__oM?w1Je&I$6y94L77psq>VPofm6 zeN|D~o-e_C#S)-=%)V1=RQ;*Q6f(wy=utP75%?RQr&!|KSufeaIxvt}3gRZ9ofy;q zkD!8v!AEhaMD8K`+G|bfT@pZ8{`n+v{ro`^U&qq3Gp-C?y(+-`>XqH!@kF=TpyD!Y z)ovJhDI0*d#eEnS{;z#`@A>2PwWkl=)q5MO3V-itUUpqS^s)?4a^hsf%Mevk#Z76r ze98wW#h{u7Is9QCuYm_5LAOq;?0_VlEPQvAKs0>aUVOUK?M}=OKjE)EQr*h&o6q45JKF3n1F8&M2!j-pA1D z4B$U42rYs46Np`B4(jNp3pE)_L^BKCsEk|WZIy^GsrgBr-8{xcRwOTVccg{3xc6xtjvC1ae<)jt8@-S{0ibHkic({0C12CQ`A04Hlfr;CXH1>H6dL zBL#wo8@XBJEfuo`Sk8(1+*&Cp<_;2Y_A_Xznx!piOQkBUY6iWgS1A+$TD4@9D*F86 F{{pSH`w0L5 literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/inject_securetransport.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/inject_securetransport.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..99e2b286fafa8045d223802665b8e147c59a1fad GIT binary patch literal 961 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 literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/marker_files.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/marker_files.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c9e9aa078d498e54b02d6591bd3c838f8be53424 GIT binary patch literal 957 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 PKMut>lY1nW%}@P*NbHZT literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/models.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/models.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3e8c7be60e1c1dbbcf38b7c483df5f9e18c0d0f3 GIT binary patch literal 1953 zcmb_c&2G~`5Z<+&G)x0;yNO7Z zTl*kz>?`@oiC5snjGa`aG@_!cwL9zG@%Wo>evX>WI>WJ7XL8~(_MKjC4m@MKIE{}B zunq$bPRu*}Edv+4O9q~FF5Hd_&LL}8&YvAw6)UTx@sCsOgFIG=N>2Pi3NkkJA83Ug zM6})<4!-Q-G@o#hti$n74sfyx?j`GZ;6Vjt1*))svI;d=M7aQUSVCEY1~gGFLJO8r z)?o!!Q7*w6tfOqe2BO={H{Q$fUT7rjr-Lli@`L)KlJlL9IvpuM$Wd{uOq%#nn1$V$ zE4CL}Um3qk-}-nP`loVS_i;onLY@uUlP~)?%?d6PK4F4Q99+?-Lw3av+D_gO<&UI5 zEBUgRu_U56G^Xw5o{{l!?$T}R_sc7$7t!v|&p|I8$UvuQ7G|fx$V5nRVC)cNVuO)P zMnSB)K{mF%G+=hK$TX3JBzV2h^fVc7b6rJII94w71)(4n zAy)CtkTo_RL#Y`RTBM1C_GG>YMhiC+_7wwSdEfbl$y(xY@i)_80%ed;&sf5#loR()^{ho?_OM&k(bw%QHil(5=mXbukzMGYTpgASPrlw zNhmAbEh~ME6siM>%?WNNG^PCuoQ8S=;|=aP^E%J8a1Yu|Y8FX2Kwt8@5ZK9vG3^^d zoDIWxdb1z|q!C7K2@PxNZAA@hDj`i7tSNys#ZMD`Wd%~Zy^WDt3!NMKs>VIH=GEMr mk0y<_r-{F54X53{jBIgn!(3s#Y^Iaqi>B*UYVI#*rJXDQ literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/packaging.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/packaging.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..53c52b5656d43e97264b356f907592bd99ec029c GIT binary patch literal 2637 zcmaJ@%Wm676y=bVMA4MraqOf`2LTd9Kr9ta7llz2aUCZ$5-W!701bPXD_Z&?=iIq{+- z&nR!foc)xLaL=cVP#D$nu%lb4RtgZ{2}PN0sm6!tB&vXtx+?uS12 zw<*o!%T5@vJoZn$+~++QFYdnHd+lv~v%U4)+ke$+?X;eOMeAkG!H6G=(qTW332dzF z62|^e^(#%c7nFZTqxbbR!f&{m*qL1CXmHGqs9Thx(v%A>Rk zb_;9DfOIMGk21QRM5(F+nvLyYo?&nW{Cz+g-3D&6Q`Q){sm}UtBudASO18~1#OXbRy_yKyI@5a;5w)}cU+dWDuCy~3FoIv|{ux4hB*-!*y@PWtEjW-m)flV(}& z=f}+x7Gxo5GTsj%G)=(DNi&Y#Hj9@ZHNI%Fh?Di)4~_xHteHo76Y|0d1)w(p%rVTV zMaX+2KNUArHi2pdtVY3EfuorcrJALi$kta7U4yv*Fgtl95oCZA5q^YDh|UoQI&gHP zU+DDyKpPqZfW7LOvUjehpUT+~=s+Kb`ZEgnEr9TWIBbj|2nsP_x8wqd5W{Ui zgqMuOV|bSi9SYn@=_mH_xoS=g-!6T2Eh|-E3ue zY#4ynPeXtmzQ=^ts@H@au_$HSPXj__P{pzopB-TCv}-GNFgo5(@dzq;-q8$n-RM5b;5bjpT})ZQ!Lk-o^Hz;hou5;zwCpaB}9 zP(cL}uOC*l*|t`aqPb2H1_dyvL9lYlG##LKy=fL40G3lB$i~FuCePG>?_z+mI1O1 zOQ&_1yAmMz$(aP`GZ+9jo@j4YRlxL1jV?prpw%@5OnA4fKDb89t?slA z4mV%C*xskN!3cORvn3X%(c{HYN|-1~O5}B2-A$Ns^7?IR@->CkI41O4uvFYbx6v%J zpwM-B$Q@yOUZ)QdO+1gvn}~`8C;(G9B=MuTF@lu5p_l=cYJl*iVMYrA+?bkyty0V+ zsHNHz0=%j=jD@X1eh7&AnlpuTacx=YUL%QEQ1If`)whdfewxcOs?wwKXdoq!!e25? z)C#wg;tv9KV9s5;;^p)o7Fv_Ug(;PH6||{POW~)IV#4|| j$-;h2zLL7jFjNk3$^nkeLxCTN^So>g+pt!w+t$K=OabPS literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/pkg_resources.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/pkg_resources.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e691bbd55d44cdfdb115402d93264fa15b3f55d0 GIT binary patch literal 1851 zcmah}-ESi`5VyUXWb@HBSMCJu35f0iDM(}=5Q2vjI?+3>6f zN`^xB(v?{6EKa2EovA$Sg*^cZ;yer0Y|!e#h|tw?AdmkZ{2DW~pbNqQ^doXZhd0zV zd8xI}tgB^mX1#LfhNw-r^4F<Ca6*v^bJ!Tn5>(HsVrhzk}cfqoQL`rga@!wTHmQyUze(Q z;J_6$Qb0TeX5KYqK`!Wm?vQKx8lZNGVdIwCr{s!JGT&V=ms~i4zI7M$9sLqA#GT*B zYw`so=8FBwek3O(1Bz+tv*Enmi?iM@S4H0YHH8*c8;IRL&SFf)bBXkYQn|8qC>EV( zwtkkYG&Fsuh+S=?JiQzJNSfQ|AAw9!C4@2BrCs)r&Z{V_OIJ|9jA4%#C}7nf25$j_ zcl4UBa?xiB#ncB#5b1xXVtZZvvWY(eu`(eaR}ykp_KrgoE*B1=X9C;+Fuz?Iz0dq+ zS@=BGB34he1nr3_{`Y9+blkk4UpMPYA{Wdl+s^i?YI8SpiO_1+! z{?jx}RwoV4MILdkx}a3Ohoq>79prYAJVt_fUn`FSJ8W0w0l{|Dc;BNg^IZ6v1$B$l zVZUQ{;L#ayc$!4629?LAC_%fmey-!6i=MK(#cugj4T`5~U}lpz8!0RyTVE||uuyd* ijbb}Ly^xV9tl#If^`0)#_!`qwbXbRWSckdvq4PJ4wybaf literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/setuptools_build.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/setuptools_build.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..33f8eb0c456ffb241f49031f0315a9d7f0cea55a GIT binary patch literal 2956 zcmZ`*TW{RP73OUzYHzZYG;y38-2jzXh`UA-poLWhO$^&HnyiCJe#kZj!R5^Evf`4= z3|F?c^h=wEKD7U!56z?hKz=}hzUBw;HBb2qLW<@)L#`yd?kqT$GiPSb!(Okg zp?%cW_;)X9+V`}$+)ONfi%(9`F^%boHm1=?^o21tbd4Kg4{I|q7uMKXw8pK4J+^g? zS>p}1&1|;uwLW&3!#2Ox#+$6oIvCrm%X%0)tk1SEcG(qn6=RR-hnn}&4|q!(d3v?| z=@*}U5#0Xx&h6g?pFbRp?vL(yW@UX6%c61~YYp2oCD?^kBw|uqedt z`rMwoljS_!*>h>|cGm~I{U~GnU^);yWV;@QJP9MdyYr>^lDK!!d;8Ntlw^|cdi(q_ zk9MPMk>fdxjPISl4QATi@w~f{MFwbE3nP8E@yWaB3hj^jOn+jPrg){a80Npyu(Fs@ z82>a&?Hhe&D2guLFRilPHN;2YFxR}WvK3~!rnOzPdmJV^x0Va}7GcUpGpEulSV}H}C`+gD?3R0f>K=(D ztjuB=P7*HNoC`^)afuJA65moZ;*&8N>6htbIh}IBS&%J@d|6z&EM!c&1@yUKawTjO zDdn)C6gjt_n*gu1m@C6y;)~9DzMp13$>2xRnP*idfLXN(0n36Ut*!)zca9!@cJ$!E zCx^k|$M-+2>}e(zVd1r^p7Pe(wpIUGV^#fU%}`yvkh4*yvfy0#R1;SKs53sCXA3?Q zS(bJNtX)({z_XfWn%DCWu9!AIEjLTsj=ffaQ3oc;S z;j)MmIlO>VFj>Y4gR`sG7U3}uF6|Ja0utm^!uB>g?TVvYdRyN{U(W=Q|9?R2Vz&gD&R4%breYCTGfgY9;U07?}teuUIxiCFZ6n$+}EF% zTV0_fzK8RYjHb0NB<||s8Ys~Q(VOOAJeQY>Mrn&~X^C#3{aG(`@>FRu9iG}KHyET> zvSY6Nv;oc!Ku0=j=q;ulZ;H=BYn82rW{U~dC@t%=(Ayb#jca>&6t#z+@FdGun<~&4 z&*hop`?=uL`0<(T`-FHJDFn~JRPP)-HLCuH5;V#!cZA494GHJMbk$az$^u4RgF?`Y zm0jOZS#)#N!@YGXqF8yMwcmK&+KtG{-Vbr5BzJ4=u5oU0yK6XxrFVgpE{%qG2OJS$ zWZkHA(E2t$`93-W@(^Y!1AgDn3x&OOcyt?GRwMbV26ssNZ2@AIea!lXiu|M z+xIc|Cn0R3z+@?lRNXa)iUzX83zdEId1cR!QT(5funJwaih846YxfJ#BZ|d!qmU%Q zly?8Zq;!C;R*f#quK_>TE+K7GWd-X=r|eLiG+BXGEv0=2MUn7z1d82Yu2a^Sn}fE| zV6Fqa5nls_!??`E&e_!R_Kr9Pqjqpcik0Fy5*~QU8|G5HPpY zV=nEr>!S(=H$V_Sr%r{&W`5c{^+Ig?Pav%0i=gpW+#)GoYW*$%--Lp0{Ak;Ky=@>6 zC>Yd70YP649>);B#3|1l-M#De1?8yfI!e{xyi^TTsTvfgIm{|3=~i~Lpa>EaN`i8k z*rbjMk;>01>8Z#Q1W@(Nr4pcufvN+}Zx$I_Cj0~Z(b6ROz%fX~mp6_78XZl?@5lD* M&d;2_bHmyG3FMLX@Bjb+ literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/subprocess.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/subprocess.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..42a0c8e84ad9e4e8f724401bd9944f372b259a47 GIT binary patch literal 5627 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 literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/temp_dir.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/temp_dir.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f71bc7dd87e5de6d90bcf8a262fd50806927a4c3 GIT binary patch literal 6740 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 literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/typing.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/typing.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..af2b2305d94dfa2c60056c0913f5a8f4963b4c9a GIT binary patch literal 1466 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 F|1XjvQ1t)+ literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/unpacking.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/unpacking.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..df8625202348e11b1560a815ed743d8f768cd9de GIT binary patch literal 6104 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 literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/urls.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/urls.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1d23e9f9e9135096a831917623081ea400931ad1 GIT binary patch literal 1494 zcmZ8hQE%He5GER-r9cBGu5Ee##-j^vSd-*?{M*yte`Klc#-H$vz?XS_cM z7(c?NXCN42xIp7}#$yaNDM%TNL+pG3=+U_2^|0uc@i@ka$La~JMa5d#8~4if@p_qz z6WG&X-M`UzgT-tO=05AOb(n84{2UFEw{RO84X}->Olb~ESMk?1*9O$h-w&Q1O!j_# zwD;TO+5Twsc=XF4u<;+2$)(5&8@}LgjE(jMm{aT`t%lP>`1at_6a>Q!I_;{2q35VU zORyQaBrLd#miQ8UgK%_(ci*~m%83E7k*NlVmbb^<}%b-D*_!2LW z36~MWrnBsN4_V;GRi9kUdKAW<6mzZ&&1jXG88s5LS9!sA>Hf1PLrP!Fc)N0z7X>}y zw9FW%*^!n-Z9ox>&ayf8v0m5GaMo@INR1wP_f_Nr4q{8BwxPSn#zLynYh8%tl>{<} z%1t~OY!|E(nG4%rxmVP%iQ6o)lJCI6fT&H#TP04odbOetnq7ArCq}x8Zh@mMWoHX- zVs#hn4@&761Fg}PQh?GjV2KdsTJLoU`CpKj13wszX@PaG?khmf0y9W4lO4LIZ zE{LEeJc(EY_EXkr$Tk9BVxSe?Md>c%hBU!8K(q*&0N{u(?tKKuI}ln-TrzDr)opm* z#kU8trqfJNDT;GyY9&^%LAII#!KAlcp)|cGq@iD_fn6))G%IFO8;fjomWu~F7v%8p zVpm9U->>;ofc;}lGsUSpsOzed${{Nuw^^=fRb=KB0J!UduGyY84(+oXfbIXJHSh_# z@{v+fsZZgtHg=ElEfwftf%aum z4R!uzSjsuqLkJC=RIbx}Dk^ZAf9hxc#7!#?eJc;md6kP}<>+KPE5q?hxjt20CtMqQ o0{Tb1$6BA3r*8bPl&miJ5AOd+JBG(NCJ9a;nGkOUaW`K7ANSXV3IG5A literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/virtualenv.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/virtualenv.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..bc8f74e45b699745e7ba303eb44553a5c8768560 GIT binary patch literal 3309 zcmaJ@TXWmS72X9v0HUtGM0Hy?-8yX*W@IumX=XAVC#@^ft|zvlO7hg^Gy_B2B?$|+ z?k**Zm7dhTwtqpI_N70he*&+0%3sJ!d(JK?QnDIwfW2^mJ?A^$Ip4lmT&xqgepe^r z(IO$=;9&N0VenhH)xY4u38yK^XophlJE_xgOzU=B(|R4xw6#vnw0_5j)=h&f?1Yqv zQ0~ImOXsqBr=HDs=3&k`TM&!qw6i3J1!>PPyiPBa0RjHFAkJHg-N#0F|T-;YjN{j5iO0>9N#@+q6FVvsZ zN1wy};cvDc9K`8Re4*t~9QWc>iAEQQNA${ z-F?N99)tawd$AHxDMc@N%i^4yx$!WIb$8IL*BM;9gG8|bEJ%f7TkS3OtB*fr-6AW~ zB+fNENTeRdDHA#LiaZm!R!#F_H9xaM!>wG{wDRo^RnQkY)>{6XNaTfid>6F_MJ8IZ zD9X6pZyl&^!9`1HKq%L(1K6UKCVQ>&NDqqqljdiwOL(=)q-;e=u7w0_TSJ|ssx>wb zUTu~~)vZVl^E}D>(J<#iM)*ktOgZo%zFdIkJJ2FC4YX*eCYo}3it%?w*=0bbh|>w6 zfSD5dItZ@=jCJ8%EjT+&^njH|WxS>)$fD_EJZCllG6jQJA%rpjyQV1G-aO1zKfB_t z6#ZcugWEP{@a3PtGV6RGm!bcT^AskH^9YS5r=+ZFdP=~3I(o7#^ibw(7kG)JIuvVC zurb0c$yLGyi)Z{;XOEG+tk44?4-+MY2bqV(+Uy@cnYb) zV#QJ@3ascsn+s)=&LXSWW|50^#5U3J$}r_DFEj%l@K)UI3Z)o8$$CjThH_M&?z!2R ztDHhrUK#5_<-IAA+)^b3EGn-kMP7OMsj99ZnYG!z3Z8z|ma>oyr?YIo6@mQ`Zc)+R zOn3~#-isiQqnUN)BTd*qAz_HWLLFMCKc`Dn{t(8O_~pWc2e%2(7IctbC*&CF)_y4O zY6up0&QSuOejSrXAJu zV3Vcn_5TUYYt}0y7C$J!>{3Ai3PW{PP^xWECdE&cqMP&*D2I9wYj!vg`StI|kPa9x zH7v_QL3-7dQV5+aGIo(8vsHARy`IMMHOq!T5@b!B z_g`Bxv1osvuCULU5fQukA?Jxzqx5KpE>sDccD;vy1%5d0>f}H)*+Zp<8BX-mVhMmXK;Wz3n?~H zp5|^bK}{IN9}0m)y{7Fd9?F%w;gRg-1ze0 zllD%u-G0)3S=EdVR<*t?hGoO;%wZ@fIqOf^e9MjktqYT6!4u&l0Q%P^gN2(nZ`+p=PAj zWDpl1ybwQ(AfyDA_;FSkf?kd$X2v81#(cg;7cI#~KmH!$8=<@b;K-Zsr~;mV^k&f6W2Sl>6J$lf%^g0jyTIhSYrOJ9x_m zj2d^UIsiX}GlBr2kVWSqSK literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/wheel.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/wheel.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d5d89efdf45550c1ab0d60358d05046ba6657f4e GIT binary patch literal 6354 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 str + return _appdirs.user_cache_dir(appname, appauthor=False) + + +def user_config_dir(appname, roaming=True): + # type: (str, bool) -> str + return _appdirs.user_config_dir(appname, appauthor=False, roaming=roaming) + + +def user_data_dir(appname, roaming=False): + # type: (str, bool) -> str + return _appdirs.user_data_dir(appname, appauthor=False, roaming=roaming) + + +# for the discussion regarding site_config_dir locations +# see +def site_config_dirs(appname): + # type: (str) -> List[str] + dirval = _appdirs.site_config_dir(appname, appauthor=False, multipath=True) + if _appdirs.system not in ["win32", "darwin"]: + # always look in /etc directly as well + return dirval.split(os.pathsep) + ['/etc'] + return [dirval] diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/compat.py b/venv/lib/python3.8/site-packages/pip/_internal/utils/compat.py new file mode 100644 index 000000000..6efa52ad2 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/utils/compat.py @@ -0,0 +1,269 @@ +"""Stuff that differs in different Python versions and platform +distributions.""" + +# The following comment should be removed at some point in the future. +# mypy: disallow-untyped-defs=False + +from __future__ import absolute_import, division + +import codecs +import locale +import logging +import os +import shutil +import sys + +from pip._vendor.six import PY2, text_type + +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import Optional, Text, Tuple, Union + +try: + import ipaddress +except ImportError: + try: + from pip._vendor import ipaddress # type: ignore + except ImportError: + import ipaddr as ipaddress # type: ignore + ipaddress.ip_address = ipaddress.IPAddress # type: ignore + ipaddress.ip_network = ipaddress.IPNetwork # type: ignore + + +__all__ = [ + "ipaddress", "uses_pycache", "console_to_str", + "get_path_uid", "stdlib_pkgs", "WINDOWS", "samefile", "get_terminal_size", +] + + +logger = logging.getLogger(__name__) + +if PY2: + import imp + + try: + cache_from_source = imp.cache_from_source # type: ignore + except AttributeError: + # does not use __pycache__ + cache_from_source = None + + uses_pycache = cache_from_source is not None +else: + uses_pycache = True + from importlib.util import cache_from_source + + +if PY2: + # In Python 2.7, backslashreplace exists + # but does not support use for decoding. + # We implement our own replace handler for this + # situation, so that we can consistently use + # backslash replacement for all versions. + def backslashreplace_decode_fn(err): + raw_bytes = (err.object[i] for i in range(err.start, err.end)) + # Python 2 gave us characters - convert to numeric bytes + raw_bytes = (ord(b) for b in raw_bytes) + return u"".join(u"\\x%x" % c for c in raw_bytes), err.end + codecs.register_error( + "backslashreplace_decode", + backslashreplace_decode_fn, + ) + backslashreplace_decode = "backslashreplace_decode" +else: + backslashreplace_decode = "backslashreplace" + + +def has_tls(): + # type: () -> bool + try: + import _ssl # noqa: F401 # ignore unused + return True + except ImportError: + pass + + from pip._vendor.urllib3.util import IS_PYOPENSSL + return IS_PYOPENSSL + + +def str_to_display(data, desc=None): + # type: (Union[bytes, Text], Optional[str]) -> Text + """ + For display or logging purposes, convert a bytes object (or text) to + text (e.g. unicode in Python 2) safe for output. + + :param desc: An optional phrase describing the input data, for use in + the log message if a warning is logged. Defaults to "Bytes object". + + This function should never error out and so can take a best effort + approach. It is okay to be lossy if needed since the return value is + just for display. + + We assume the data is in the locale preferred encoding. If it won't + decode properly, we warn the user but decode as best we can. + + We also ensure that the output can be safely written to standard output + without encoding errors. + """ + if isinstance(data, text_type): + return data + + # Otherwise, data is a bytes object (str in Python 2). + # First, get the encoding we assume. This is the preferred + # encoding for the locale, unless that is not found, or + # it is ASCII, in which case assume UTF-8 + encoding = locale.getpreferredencoding() + if (not encoding) or codecs.lookup(encoding).name == "ascii": + encoding = "utf-8" + + # Now try to decode the data - if we fail, warn the user and + # decode with replacement. + try: + decoded_data = data.decode(encoding) + except UnicodeDecodeError: + if desc is None: + desc = 'Bytes object' + msg_format = '{} does not appear to be encoded as %s'.format(desc) + logger.warning(msg_format, encoding) + decoded_data = data.decode(encoding, errors=backslashreplace_decode) + + # Make sure we can print the output, by encoding it to the output + # encoding with replacement of unencodable characters, and then + # decoding again. + # We use stderr's encoding because it's less likely to be + # redirected and if we don't find an encoding we skip this + # step (on the assumption that output is wrapped by something + # that won't fail). + # The double getattr is to deal with the possibility that we're + # being called in a situation where sys.__stderr__ doesn't exist, + # or doesn't have an encoding attribute. Neither of these cases + # should occur in normal pip use, but there's no harm in checking + # in case people use pip in (unsupported) unusual situations. + output_encoding = getattr(getattr(sys, "__stderr__", None), + "encoding", None) + + if output_encoding: + output_encoded = decoded_data.encode( + output_encoding, + errors="backslashreplace" + ) + decoded_data = output_encoded.decode(output_encoding) + + return decoded_data + + +def console_to_str(data): + # type: (bytes) -> Text + """Return a string, safe for output, of subprocess output. + """ + return str_to_display(data, desc='Subprocess output') + + +def get_path_uid(path): + # type: (str) -> int + """ + Return path's uid. + + Does not follow symlinks: + https://github.com/pypa/pip/pull/935#discussion_r5307003 + + Placed this function in compat due to differences on AIX and + Jython, that should eventually go away. + + :raises OSError: When path is a symlink or can't be read. + """ + if hasattr(os, 'O_NOFOLLOW'): + fd = os.open(path, os.O_RDONLY | os.O_NOFOLLOW) + file_uid = os.fstat(fd).st_uid + os.close(fd) + else: # AIX and Jython + # WARNING: time of check vulnerability, but best we can do w/o NOFOLLOW + if not os.path.islink(path): + # older versions of Jython don't have `os.fstat` + file_uid = os.stat(path).st_uid + else: + # raise OSError for parity with os.O_NOFOLLOW above + raise OSError( + "%s is a symlink; Will not return uid for symlinks" % path + ) + return file_uid + + +def expanduser(path): + # type: (str) -> str + """ + Expand ~ and ~user constructions. + + Includes a workaround for https://bugs.python.org/issue14768 + """ + expanded = os.path.expanduser(path) + if path.startswith('~/') and expanded.startswith('//'): + expanded = expanded[1:] + return expanded + + +# packages in the stdlib that may have installation metadata, but should not be +# considered 'installed'. this theoretically could be determined based on +# dist.location (py27:`sysconfig.get_paths()['stdlib']`, +# py26:sysconfig.get_config_vars('LIBDEST')), but fear platform variation may +# make this ineffective, so hard-coding +stdlib_pkgs = {"python", "wsgiref", "argparse"} + + +# windows detection, covers cpython and ironpython +WINDOWS = (sys.platform.startswith("win") or + (sys.platform == 'cli' and os.name == 'nt')) + + +def samefile(file1, file2): + # type: (str, str) -> bool + """Provide an alternative for os.path.samefile on Windows/Python2""" + if hasattr(os.path, 'samefile'): + return os.path.samefile(file1, file2) + else: + path1 = os.path.normcase(os.path.abspath(file1)) + path2 = os.path.normcase(os.path.abspath(file2)) + return path1 == path2 + + +if hasattr(shutil, 'get_terminal_size'): + def get_terminal_size(): + # type: () -> Tuple[int, int] + """ + Returns a tuple (x, y) representing the width(x) and the height(y) + in characters of the terminal window. + """ + return tuple(shutil.get_terminal_size()) # type: ignore +else: + def get_terminal_size(): + # type: () -> Tuple[int, int] + """ + Returns a tuple (x, y) representing the width(x) and the height(y) + in characters of the terminal window. + """ + def ioctl_GWINSZ(fd): + try: + import fcntl + import termios + import struct + cr = struct.unpack_from( + 'hh', + fcntl.ioctl(fd, termios.TIOCGWINSZ, '12345678') + ) + except Exception: + return None + if cr == (0, 0): + return None + return cr + cr = ioctl_GWINSZ(0) or ioctl_GWINSZ(1) or ioctl_GWINSZ(2) + if not cr: + if sys.platform != "win32": + try: + fd = os.open(os.ctermid(), os.O_RDONLY) + cr = ioctl_GWINSZ(fd) + os.close(fd) + except Exception: + pass + if not cr: + cr = (os.environ.get('LINES', 25), os.environ.get('COLUMNS', 80)) + return int(cr[1]), int(cr[0]) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/deprecation.py b/venv/lib/python3.8/site-packages/pip/_internal/utils/deprecation.py new file mode 100644 index 000000000..2f20cfd49 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/utils/deprecation.py @@ -0,0 +1,104 @@ +""" +A module that implements tooling to enable easy warnings about deprecations. +""" + +# The following comment should be removed at some point in the future. +# mypy: disallow-untyped-defs=False + +from __future__ import absolute_import + +import logging +import warnings + +from pip._vendor.packaging.version import parse + +from pip import __version__ as current_version +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import Any, Optional + + +DEPRECATION_MSG_PREFIX = "DEPRECATION: " + + +class PipDeprecationWarning(Warning): + pass + + +_original_showwarning = None # type: Any + + +# Warnings <-> Logging Integration +def _showwarning(message, category, filename, lineno, file=None, line=None): + if file is not None: + if _original_showwarning is not None: + _original_showwarning( + message, category, filename, lineno, file, line, + ) + elif issubclass(category, PipDeprecationWarning): + # We use a specially named logger which will handle all of the + # deprecation messages for pip. + logger = logging.getLogger("pip._internal.deprecations") + logger.warning(message) + else: + _original_showwarning( + message, category, filename, lineno, file, line, + ) + + +def install_warning_logger(): + # type: () -> None + # Enable our Deprecation Warnings + warnings.simplefilter("default", PipDeprecationWarning, append=True) + + global _original_showwarning + + if _original_showwarning is None: + _original_showwarning = warnings.showwarning + warnings.showwarning = _showwarning + + +def deprecated(reason, replacement, gone_in, issue=None): + # type: (str, Optional[str], Optional[str], Optional[int]) -> None + """Helper to deprecate existing functionality. + + reason: + Textual reason shown to the user about why this functionality has + been deprecated. + replacement: + Textual suggestion shown to the user about what alternative + functionality they can use. + gone_in: + The version of pip does this functionality should get removed in. + Raises errors if pip's current version is greater than or equal to + this. + issue: + Issue number on the tracker that would serve as a useful place for + users to find related discussion and provide feedback. + + Always pass replacement, gone_in and issue as keyword arguments for clarity + at the call site. + """ + + # Construct a nice message. + # This is eagerly formatted as we want it to get logged as if someone + # typed this entire message out. + sentences = [ + (reason, DEPRECATION_MSG_PREFIX + "{}"), + (gone_in, "pip {} will remove support for this functionality."), + (replacement, "A possible replacement is {}."), + (issue, ( + "You can find discussion regarding this at " + "https://github.com/pypa/pip/issues/{}." + )), + ] + message = " ".join( + template.format(val) for val, template in sentences if val is not None + ) + + # Raise as an error if it has to be removed. + if gone_in is not None and parse(current_version) >= parse(gone_in): + raise PipDeprecationWarning(message) + + warnings.warn(message, category=PipDeprecationWarning, stacklevel=2) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/distutils_args.py b/venv/lib/python3.8/site-packages/pip/_internal/utils/distutils_args.py new file mode 100644 index 000000000..e38e402d7 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/utils/distutils_args.py @@ -0,0 +1,48 @@ +from distutils.errors import DistutilsArgError +from distutils.fancy_getopt import FancyGetopt + +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import Dict, List + + +_options = [ + ("exec-prefix=", None, ""), + ("home=", None, ""), + ("install-base=", None, ""), + ("install-data=", None, ""), + ("install-headers=", None, ""), + ("install-lib=", None, ""), + ("install-platlib=", None, ""), + ("install-purelib=", None, ""), + ("install-scripts=", None, ""), + ("prefix=", None, ""), + ("root=", None, ""), + ("user", None, ""), +] + + +# typeshed doesn't permit Tuple[str, None, str], see python/typeshed#3469. +_distutils_getopt = FancyGetopt(_options) # type: ignore + + +def parse_distutils_args(args): + # type: (List[str]) -> Dict[str, str] + """Parse provided arguments, returning an object that has the + matched arguments. + + Any unknown arguments are ignored. + """ + result = {} + for arg in args: + try: + _, match = _distutils_getopt.getopt(args=[arg]) + except DistutilsArgError: + # We don't care about any other options, which here may be + # considered unrecognized since our option list is not + # exhaustive. + pass + else: + result.update(match.__dict__) + return result diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/encoding.py b/venv/lib/python3.8/site-packages/pip/_internal/utils/encoding.py new file mode 100644 index 000000000..ab4d4b98e --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/utils/encoding.py @@ -0,0 +1,42 @@ +# The following comment should be removed at some point in the future. +# mypy: strict-optional=False + +import codecs +import locale +import re +import sys + +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import List, Tuple, Text + +BOMS = [ + (codecs.BOM_UTF8, 'utf-8'), + (codecs.BOM_UTF16, 'utf-16'), + (codecs.BOM_UTF16_BE, 'utf-16-be'), + (codecs.BOM_UTF16_LE, 'utf-16-le'), + (codecs.BOM_UTF32, 'utf-32'), + (codecs.BOM_UTF32_BE, 'utf-32-be'), + (codecs.BOM_UTF32_LE, 'utf-32-le'), +] # type: List[Tuple[bytes, Text]] + +ENCODING_RE = re.compile(br'coding[:=]\s*([-\w.]+)') + + +def auto_decode(data): + # type: (bytes) -> Text + """Check a bytes string for a BOM to correctly detect the encoding + + Fallback to locale.getpreferredencoding(False) like open() on Python3""" + for bom, encoding in BOMS: + if data.startswith(bom): + return data[len(bom):].decode(encoding) + # Lets check the first two lines as in PEP263 + for line in data.split(b'\n')[:2]: + if line[0:1] == b'#' and ENCODING_RE.search(line): + encoding = ENCODING_RE.search(line).groups()[0].decode('ascii') + return data.decode(encoding) + return data.decode( + locale.getpreferredencoding(False) or sys.getdefaultencoding(), + ) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/entrypoints.py b/venv/lib/python3.8/site-packages/pip/_internal/utils/entrypoints.py new file mode 100644 index 000000000..befd01c89 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/utils/entrypoints.py @@ -0,0 +1,31 @@ +import sys + +from pip._internal.cli.main import main +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import Optional, List + + +def _wrapper(args=None): + # type: (Optional[List[str]]) -> int + """Central wrapper for all old entrypoints. + + Historically pip has had several entrypoints defined. Because of issues + arising from PATH, sys.path, multiple Pythons, their interactions, and most + of them having a pip installed, users suffer every time an entrypoint gets + moved. + + To alleviate this pain, and provide a mechanism for warning users and + directing them to an appropriate place for help, we now define all of + our old entrypoints as wrappers for the current one. + """ + sys.stderr.write( + "WARNING: pip is being invoked by an old script wrapper. This will " + "fail in a future version of pip.\n" + "Please see https://github.com/pypa/pip/issues/5599 for advice on " + "fixing the underlying issue.\n" + "To avoid this problem you can invoke Python with '-m pip' instead of " + "running pip directly.\n" + ) + return main(args) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/filesystem.py b/venv/lib/python3.8/site-packages/pip/_internal/utils/filesystem.py new file mode 100644 index 000000000..6f1537e40 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/utils/filesystem.py @@ -0,0 +1,171 @@ +import errno +import os +import os.path +import random +import shutil +import stat +import sys +from contextlib import contextmanager +from tempfile import NamedTemporaryFile + +# NOTE: retrying is not annotated in typeshed as on 2017-07-17, which is +# why we ignore the type on this import. +from pip._vendor.retrying import retry # type: ignore +from pip._vendor.six import PY2 + +from pip._internal.utils.compat import get_path_uid +from pip._internal.utils.typing import MYPY_CHECK_RUNNING, cast + +if MYPY_CHECK_RUNNING: + from typing import BinaryIO, Iterator + + class NamedTemporaryFileResult(BinaryIO): + @property + def file(self): + # type: () -> BinaryIO + pass + + +def check_path_owner(path): + # type: (str) -> bool + # If we don't have a way to check the effective uid of this process, then + # we'll just assume that we own the directory. + if sys.platform == "win32" or not hasattr(os, "geteuid"): + return True + + assert os.path.isabs(path) + + previous = None + while path != previous: + if os.path.lexists(path): + # Check if path is writable by current user. + if os.geteuid() == 0: + # Special handling for root user in order to handle properly + # cases where users use sudo without -H flag. + try: + path_uid = get_path_uid(path) + except OSError: + return False + return path_uid == 0 + else: + return os.access(path, os.W_OK) + else: + previous, path = path, os.path.dirname(path) + return False # assume we don't own the path + + +def copy2_fixed(src, dest): + # type: (str, str) -> None + """Wrap shutil.copy2() but map errors copying socket files to + SpecialFileError as expected. + + See also https://bugs.python.org/issue37700. + """ + try: + shutil.copy2(src, dest) + except (OSError, IOError): + for f in [src, dest]: + try: + is_socket_file = is_socket(f) + except OSError: + # An error has already occurred. Another error here is not + # a problem and we can ignore it. + pass + else: + if is_socket_file: + raise shutil.SpecialFileError("`%s` is a socket" % f) + + raise + + +def is_socket(path): + # type: (str) -> bool + return stat.S_ISSOCK(os.lstat(path).st_mode) + + +@contextmanager +def adjacent_tmp_file(path): + # type: (str) -> Iterator[NamedTemporaryFileResult] + """Given a path to a file, open a temp file next to it securely and ensure + it is written to disk after the context reaches its end. + """ + with NamedTemporaryFile( + delete=False, + dir=os.path.dirname(path), + prefix=os.path.basename(path), + suffix='.tmp', + ) as f: + result = cast('NamedTemporaryFileResult', f) + try: + yield result + finally: + result.file.flush() + os.fsync(result.file.fileno()) + + +_replace_retry = retry(stop_max_delay=1000, wait_fixed=250) + +if PY2: + @_replace_retry + def replace(src, dest): + # type: (str, str) -> None + try: + os.rename(src, dest) + except OSError: + os.remove(dest) + os.rename(src, dest) + +else: + replace = _replace_retry(os.replace) + + +# test_writable_dir and _test_writable_dir_win are copied from Flit, +# with the author's agreement to also place them under pip's license. +def test_writable_dir(path): + # type: (str) -> bool + """Check if a directory is writable. + + Uses os.access() on POSIX, tries creating files on Windows. + """ + # If the directory doesn't exist, find the closest parent that does. + while not os.path.isdir(path): + parent = os.path.dirname(path) + if parent == path: + break # Should never get here, but infinite loops are bad + path = parent + + if os.name == 'posix': + return os.access(path, os.W_OK) + + return _test_writable_dir_win(path) + + +def _test_writable_dir_win(path): + # type: (str) -> bool + # os.access doesn't work on Windows: http://bugs.python.org/issue2528 + # and we can't use tempfile: http://bugs.python.org/issue22107 + basename = 'accesstest_deleteme_fishfingers_custard_' + alphabet = 'abcdefghijklmnopqrstuvwxyz0123456789' + for i in range(10): + name = basename + ''.join(random.choice(alphabet) for _ in range(6)) + file = os.path.join(path, name) + try: + fd = os.open(file, os.O_RDWR | os.O_CREAT | os.O_EXCL) + except OSError as e: + if e.errno == errno.EEXIST: + continue + if e.errno == errno.EPERM: + # This could be because there's a directory with the same name. + # But it's highly unlikely there's a directory called that, + # so we'll assume it's because the parent dir is not writable. + return False + raise + else: + os.close(fd) + os.unlink(file) + return True + + # This should never be reached + raise EnvironmentError( + 'Unexpected condition testing for writable directory' + ) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/filetypes.py b/venv/lib/python3.8/site-packages/pip/_internal/utils/filetypes.py new file mode 100644 index 000000000..daa0ca771 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/utils/filetypes.py @@ -0,0 +1,16 @@ +"""Filetype information. +""" +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import Tuple + +WHEEL_EXTENSION = '.whl' +BZ2_EXTENSIONS = ('.tar.bz2', '.tbz') # type: Tuple[str, ...] +XZ_EXTENSIONS = ('.tar.xz', '.txz', '.tlz', + '.tar.lz', '.tar.lzma') # type: Tuple[str, ...] +ZIP_EXTENSIONS = ('.zip', WHEEL_EXTENSION) # type: Tuple[str, ...] +TAR_EXTENSIONS = ('.tar.gz', '.tgz', '.tar') # type: Tuple[str, ...] +ARCHIVE_EXTENSIONS = ( + ZIP_EXTENSIONS + BZ2_EXTENSIONS + TAR_EXTENSIONS + XZ_EXTENSIONS +) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/glibc.py b/venv/lib/python3.8/site-packages/pip/_internal/utils/glibc.py new file mode 100644 index 000000000..361042441 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/utils/glibc.py @@ -0,0 +1,98 @@ +# The following comment should be removed at some point in the future. +# mypy: strict-optional=False + +from __future__ import absolute_import + +import os +import sys + +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import Optional, Tuple + + +def glibc_version_string(): + # type: () -> Optional[str] + "Returns glibc version string, or None if not using glibc." + return glibc_version_string_confstr() or glibc_version_string_ctypes() + + +def glibc_version_string_confstr(): + # type: () -> Optional[str] + "Primary implementation of glibc_version_string using os.confstr." + # os.confstr is quite a bit faster than ctypes.DLL. It's also less likely + # to be broken or missing. This strategy is used in the standard library + # platform module: + # https://github.com/python/cpython/blob/fcf1d003bf4f0100c9d0921ff3d70e1127ca1b71/Lib/platform.py#L175-L183 + if sys.platform == "win32": + return None + try: + # os.confstr("CS_GNU_LIBC_VERSION") returns a string like "glibc 2.17": + _, version = os.confstr("CS_GNU_LIBC_VERSION").split() + except (AttributeError, OSError, ValueError): + # os.confstr() or CS_GNU_LIBC_VERSION not available (or a bad value)... + return None + return version + + +def glibc_version_string_ctypes(): + # type: () -> Optional[str] + "Fallback implementation of glibc_version_string using ctypes." + + try: + import ctypes + except ImportError: + return None + + # ctypes.CDLL(None) internally calls dlopen(NULL), and as the dlopen + # manpage says, "If filename is NULL, then the returned handle is for the + # main program". This way we can let the linker do the work to figure out + # which libc our process is actually using. + process_namespace = ctypes.CDLL(None) + try: + gnu_get_libc_version = process_namespace.gnu_get_libc_version + except AttributeError: + # Symbol doesn't exist -> therefore, we are not linked to + # glibc. + return None + + # Call gnu_get_libc_version, which returns a string like "2.5" + gnu_get_libc_version.restype = ctypes.c_char_p + version_str = gnu_get_libc_version() + # py2 / py3 compatibility: + if not isinstance(version_str, str): + version_str = version_str.decode("ascii") + + return version_str + + +# platform.libc_ver regularly returns completely nonsensical glibc +# versions. E.g. on my computer, platform says: +# +# ~$ python2.7 -c 'import platform; print(platform.libc_ver())' +# ('glibc', '2.7') +# ~$ python3.5 -c 'import platform; print(platform.libc_ver())' +# ('glibc', '2.9') +# +# But the truth is: +# +# ~$ ldd --version +# ldd (Debian GLIBC 2.22-11) 2.22 +# +# This is unfortunate, because it means that the linehaul data on libc +# versions that was generated by pip 8.1.2 and earlier is useless and +# misleading. Solution: instead of using platform, use our code that actually +# works. +def libc_ver(): + # type: () -> Tuple[str, str] + """Try to determine the glibc version + + Returns a tuple of strings (lib, version) which default to empty strings + in case the lookup fails. + """ + glibc_version = glibc_version_string() + if glibc_version is None: + return ("", "") + else: + return ("glibc", glibc_version) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/hashes.py b/venv/lib/python3.8/site-packages/pip/_internal/utils/hashes.py new file mode 100644 index 000000000..4c41551a2 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/utils/hashes.py @@ -0,0 +1,131 @@ +from __future__ import absolute_import + +import hashlib + +from pip._vendor.six import iteritems, iterkeys, itervalues + +from pip._internal.exceptions import ( + HashMismatch, + HashMissing, + InstallationError, +) +from pip._internal.utils.misc import read_chunks +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import ( + Dict, List, BinaryIO, NoReturn, Iterator + ) + from pip._vendor.six import PY3 + if PY3: + from hashlib import _Hash + else: + from hashlib import _hash as _Hash + + +# The recommended hash algo of the moment. Change this whenever the state of +# the art changes; it won't hurt backward compatibility. +FAVORITE_HASH = 'sha256' + + +# Names of hashlib algorithms allowed by the --hash option and ``pip hash`` +# Currently, those are the ones at least as collision-resistant as sha256. +STRONG_HASHES = ['sha256', 'sha384', 'sha512'] + + +class Hashes(object): + """A wrapper that builds multiple hashes at once and checks them against + known-good values + + """ + def __init__(self, hashes=None): + # type: (Dict[str, List[str]]) -> None + """ + :param hashes: A dict of algorithm names pointing to lists of allowed + hex digests + """ + self._allowed = {} if hashes is None else hashes + + @property + def digest_count(self): + # type: () -> int + return sum(len(digests) for digests in self._allowed.values()) + + def is_hash_allowed( + self, + hash_name, # type: str + hex_digest, # type: str + ): + # type: (...) -> bool + """Return whether the given hex digest is allowed.""" + return hex_digest in self._allowed.get(hash_name, []) + + def check_against_chunks(self, chunks): + # type: (Iterator[bytes]) -> None + """Check good hashes against ones built from iterable of chunks of + data. + + Raise HashMismatch if none match. + + """ + gots = {} + for hash_name in iterkeys(self._allowed): + try: + gots[hash_name] = hashlib.new(hash_name) + except (ValueError, TypeError): + raise InstallationError('Unknown hash name: %s' % hash_name) + + for chunk in chunks: + for hash in itervalues(gots): + hash.update(chunk) + + for hash_name, got in iteritems(gots): + if got.hexdigest() in self._allowed[hash_name]: + return + self._raise(gots) + + def _raise(self, gots): + # type: (Dict[str, _Hash]) -> NoReturn + raise HashMismatch(self._allowed, gots) + + def check_against_file(self, file): + # type: (BinaryIO) -> None + """Check good hashes against a file-like object + + Raise HashMismatch if none match. + + """ + return self.check_against_chunks(read_chunks(file)) + + def check_against_path(self, path): + # type: (str) -> None + with open(path, 'rb') as file: + return self.check_against_file(file) + + def __nonzero__(self): + # type: () -> bool + """Return whether I know any known-good hashes.""" + return bool(self._allowed) + + def __bool__(self): + # type: () -> bool + return self.__nonzero__() + + +class MissingHashes(Hashes): + """A workalike for Hashes used when we're missing a hash for a requirement + + It computes the actual hash of the requirement and raises a HashMissing + exception showing it to the user. + + """ + def __init__(self): + # type: () -> None + """Don't offer the ``hashes`` kwarg.""" + # Pass our favorite hash in to generate a "gotten hash". With the + # empty list, it will never match, so an error will always raise. + super(MissingHashes, self).__init__(hashes={FAVORITE_HASH: []}) + + def _raise(self, gots): + # type: (Dict[str, _Hash]) -> NoReturn + raise HashMissing(gots[FAVORITE_HASH].hexdigest()) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/inject_securetransport.py b/venv/lib/python3.8/site-packages/pip/_internal/utils/inject_securetransport.py new file mode 100644 index 000000000..5b93b1d67 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/utils/inject_securetransport.py @@ -0,0 +1,36 @@ +"""A helper module that injects SecureTransport, on import. + +The import should be done as early as possible, to ensure all requests and +sessions (or whatever) are created after injecting SecureTransport. + +Note that we only do the injection on macOS, when the linked OpenSSL is too +old to handle TLSv1.2. +""" + +import sys + + +def inject_securetransport(): + # type: () -> None + # Only relevant on macOS + if sys.platform != "darwin": + return + + try: + import ssl + except ImportError: + return + + # Checks for OpenSSL 1.0.1 + if ssl.OPENSSL_VERSION_NUMBER >= 0x1000100f: + return + + try: + from pip._vendor.urllib3.contrib import securetransport + except (ImportError, OSError): + return + + securetransport.inject_into_urllib3() + + +inject_securetransport() diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/logging.py b/venv/lib/python3.8/site-packages/pip/_internal/utils/logging.py new file mode 100644 index 000000000..7767111a6 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/utils/logging.py @@ -0,0 +1,398 @@ +# The following comment should be removed at some point in the future. +# mypy: disallow-untyped-defs=False + +from __future__ import absolute_import + +import contextlib +import errno +import logging +import logging.handlers +import os +import sys +from logging import Filter, getLogger + +from pip._vendor.six import PY2 + +from pip._internal.utils.compat import WINDOWS +from pip._internal.utils.deprecation import DEPRECATION_MSG_PREFIX +from pip._internal.utils.misc import ensure_dir + +try: + import threading +except ImportError: + import dummy_threading as threading # type: ignore + + +try: + # Use "import as" and set colorama in the else clause to avoid mypy + # errors and get the following correct revealed type for colorama: + # `Union[_importlib_modulespec.ModuleType, None]` + # Otherwise, we get an error like the following in the except block: + # > Incompatible types in assignment (expression has type "None", + # variable has type Module) + # TODO: eliminate the need to use "import as" once mypy addresses some + # of its issues with conditional imports. Here is an umbrella issue: + # https://github.com/python/mypy/issues/1297 + from pip._vendor import colorama as _colorama +# Lots of different errors can come from this, including SystemError and +# ImportError. +except Exception: + colorama = None +else: + # Import Fore explicitly rather than accessing below as colorama.Fore + # to avoid the following error running mypy: + # > Module has no attribute "Fore" + # TODO: eliminate the need to import Fore once mypy addresses some of its + # issues with conditional imports. This particular case could be an + # instance of the following issue (but also see the umbrella issue above): + # https://github.com/python/mypy/issues/3500 + from pip._vendor.colorama import Fore + + colorama = _colorama + + +_log_state = threading.local() +_log_state.indentation = 0 +subprocess_logger = getLogger('pip.subprocessor') + + +class BrokenStdoutLoggingError(Exception): + """ + Raised if BrokenPipeError occurs for the stdout stream while logging. + """ + pass + + +# BrokenPipeError does not exist in Python 2 and, in addition, manifests +# differently in Windows and non-Windows. +if WINDOWS: + # In Windows, a broken pipe can show up as EINVAL rather than EPIPE: + # https://bugs.python.org/issue19612 + # https://bugs.python.org/issue30418 + if PY2: + def _is_broken_pipe_error(exc_class, exc): + """See the docstring for non-Windows Python 3 below.""" + return (exc_class is IOError and + exc.errno in (errno.EINVAL, errno.EPIPE)) + else: + # In Windows, a broken pipe IOError became OSError in Python 3. + def _is_broken_pipe_error(exc_class, exc): + """See the docstring for non-Windows Python 3 below.""" + return ((exc_class is BrokenPipeError) or # noqa: F821 + (exc_class is OSError and + exc.errno in (errno.EINVAL, errno.EPIPE))) +elif PY2: + def _is_broken_pipe_error(exc_class, exc): + """See the docstring for non-Windows Python 3 below.""" + return (exc_class is IOError and exc.errno == errno.EPIPE) +else: + # Then we are in the non-Windows Python 3 case. + def _is_broken_pipe_error(exc_class, exc): + """ + Return whether an exception is a broken pipe error. + + Args: + exc_class: an exception class. + exc: an exception instance. + """ + return (exc_class is BrokenPipeError) # noqa: F821 + + +@contextlib.contextmanager +def indent_log(num=2): + """ + A context manager which will cause the log output to be indented for any + log messages emitted inside it. + """ + _log_state.indentation += num + try: + yield + finally: + _log_state.indentation -= num + + +def get_indentation(): + return getattr(_log_state, 'indentation', 0) + + +class IndentingFormatter(logging.Formatter): + + def __init__(self, *args, **kwargs): + """ + A logging.Formatter that obeys the indent_log() context manager. + + :param add_timestamp: A bool indicating output lines should be prefixed + with their record's timestamp. + """ + self.add_timestamp = kwargs.pop("add_timestamp", False) + super(IndentingFormatter, self).__init__(*args, **kwargs) + + def get_message_start(self, formatted, levelno): + """ + Return the start of the formatted log message (not counting the + prefix to add to each line). + """ + if levelno < logging.WARNING: + return '' + if formatted.startswith(DEPRECATION_MSG_PREFIX): + # Then the message already has a prefix. We don't want it to + # look like "WARNING: DEPRECATION: ...." + return '' + if levelno < logging.ERROR: + return 'WARNING: ' + + return 'ERROR: ' + + def format(self, record): + """ + Calls the standard formatter, but will indent all of the log message + lines by our current indentation level. + """ + formatted = super(IndentingFormatter, self).format(record) + message_start = self.get_message_start(formatted, record.levelno) + formatted = message_start + formatted + + prefix = '' + if self.add_timestamp: + # TODO: Use Formatter.default_time_format after dropping PY2. + t = self.formatTime(record, "%Y-%m-%dT%H:%M:%S") + prefix = '%s,%03d ' % (t, record.msecs) + prefix += " " * get_indentation() + formatted = "".join([ + prefix + line + for line in formatted.splitlines(True) + ]) + return formatted + + +def _color_wrap(*colors): + def wrapped(inp): + return "".join(list(colors) + [inp, colorama.Style.RESET_ALL]) + return wrapped + + +class ColorizedStreamHandler(logging.StreamHandler): + + # Don't build up a list of colors if we don't have colorama + if colorama: + COLORS = [ + # This needs to be in order from highest logging level to lowest. + (logging.ERROR, _color_wrap(Fore.RED)), + (logging.WARNING, _color_wrap(Fore.YELLOW)), + ] + else: + COLORS = [] + + def __init__(self, stream=None, no_color=None): + logging.StreamHandler.__init__(self, stream) + self._no_color = no_color + + if WINDOWS and colorama: + self.stream = colorama.AnsiToWin32(self.stream) + + def _using_stdout(self): + """ + Return whether the handler is using sys.stdout. + """ + if WINDOWS and colorama: + # Then self.stream is an AnsiToWin32 object. + return self.stream.wrapped is sys.stdout + + return self.stream is sys.stdout + + def should_color(self): + # Don't colorize things if we do not have colorama or if told not to + if not colorama or self._no_color: + return False + + real_stream = ( + self.stream if not isinstance(self.stream, colorama.AnsiToWin32) + else self.stream.wrapped + ) + + # If the stream is a tty we should color it + if hasattr(real_stream, "isatty") and real_stream.isatty(): + return True + + # If we have an ANSI term we should color it + if os.environ.get("TERM") == "ANSI": + return True + + # If anything else we should not color it + return False + + def format(self, record): + msg = logging.StreamHandler.format(self, record) + + if self.should_color(): + for level, color in self.COLORS: + if record.levelno >= level: + msg = color(msg) + break + + return msg + + # The logging module says handleError() can be customized. + def handleError(self, record): + exc_class, exc = sys.exc_info()[:2] + # If a broken pipe occurred while calling write() or flush() on the + # stdout stream in logging's Handler.emit(), then raise our special + # exception so we can handle it in main() instead of logging the + # broken pipe error and continuing. + if (exc_class and self._using_stdout() and + _is_broken_pipe_error(exc_class, exc)): + raise BrokenStdoutLoggingError() + + return super(ColorizedStreamHandler, self).handleError(record) + + +class BetterRotatingFileHandler(logging.handlers.RotatingFileHandler): + + def _open(self): + ensure_dir(os.path.dirname(self.baseFilename)) + return logging.handlers.RotatingFileHandler._open(self) + + +class MaxLevelFilter(Filter): + + def __init__(self, level): + self.level = level + + def filter(self, record): + return record.levelno < self.level + + +class ExcludeLoggerFilter(Filter): + + """ + A logging Filter that excludes records from a logger (or its children). + """ + + def filter(self, record): + # The base Filter class allows only records from a logger (or its + # children). + return not super(ExcludeLoggerFilter, self).filter(record) + + +def setup_logging(verbosity, no_color, user_log_file): + """Configures and sets up all of the logging + + Returns the requested logging level, as its integer value. + """ + + # Determine the level to be logging at. + if verbosity >= 1: + level = "DEBUG" + elif verbosity == -1: + level = "WARNING" + elif verbosity == -2: + level = "ERROR" + elif verbosity <= -3: + level = "CRITICAL" + else: + level = "INFO" + + level_number = getattr(logging, level) + + # The "root" logger should match the "console" level *unless* we also need + # to log to a user log file. + include_user_log = user_log_file is not None + if include_user_log: + additional_log_file = user_log_file + root_level = "DEBUG" + else: + additional_log_file = "/dev/null" + root_level = level + + # Disable any logging besides WARNING unless we have DEBUG level logging + # enabled for vendored libraries. + vendored_log_level = "WARNING" if level in ["INFO", "ERROR"] else "DEBUG" + + # Shorthands for clarity + log_streams = { + "stdout": "ext://sys.stdout", + "stderr": "ext://sys.stderr", + } + handler_classes = { + "stream": "pip._internal.utils.logging.ColorizedStreamHandler", + "file": "pip._internal.utils.logging.BetterRotatingFileHandler", + } + handlers = ["console", "console_errors", "console_subprocess"] + ( + ["user_log"] if include_user_log else [] + ) + + logging.config.dictConfig({ + "version": 1, + "disable_existing_loggers": False, + "filters": { + "exclude_warnings": { + "()": "pip._internal.utils.logging.MaxLevelFilter", + "level": logging.WARNING, + }, + "restrict_to_subprocess": { + "()": "logging.Filter", + "name": subprocess_logger.name, + }, + "exclude_subprocess": { + "()": "pip._internal.utils.logging.ExcludeLoggerFilter", + "name": subprocess_logger.name, + }, + }, + "formatters": { + "indent": { + "()": IndentingFormatter, + "format": "%(message)s", + }, + "indent_with_timestamp": { + "()": IndentingFormatter, + "format": "%(message)s", + "add_timestamp": True, + }, + }, + "handlers": { + "console": { + "level": level, + "class": handler_classes["stream"], + "no_color": no_color, + "stream": log_streams["stdout"], + "filters": ["exclude_subprocess", "exclude_warnings"], + "formatter": "indent", + }, + "console_errors": { + "level": "WARNING", + "class": handler_classes["stream"], + "no_color": no_color, + "stream": log_streams["stderr"], + "filters": ["exclude_subprocess"], + "formatter": "indent", + }, + # A handler responsible for logging to the console messages + # from the "subprocessor" logger. + "console_subprocess": { + "level": level, + "class": handler_classes["stream"], + "no_color": no_color, + "stream": log_streams["stderr"], + "filters": ["restrict_to_subprocess"], + "formatter": "indent", + }, + "user_log": { + "level": "DEBUG", + "class": handler_classes["file"], + "filename": additional_log_file, + "delay": True, + "formatter": "indent_with_timestamp", + }, + }, + "root": { + "level": root_level, + "handlers": handlers, + }, + "loggers": { + "pip._vendor": { + "level": vendored_log_level + } + }, + }) + + return level_number diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/marker_files.py b/venv/lib/python3.8/site-packages/pip/_internal/utils/marker_files.py new file mode 100644 index 000000000..42ea81405 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/utils/marker_files.py @@ -0,0 +1,25 @@ +import os.path + +DELETE_MARKER_MESSAGE = '''\ +This file is placed here by pip to indicate the source was put +here by pip. + +Once this package is successfully installed this source code will be +deleted (unless you remove this file). +''' +PIP_DELETE_MARKER_FILENAME = 'pip-delete-this-directory.txt' + + +def has_delete_marker_file(directory): + # type: (str) -> bool + return os.path.exists(os.path.join(directory, PIP_DELETE_MARKER_FILENAME)) + + +def write_delete_marker_file(directory): + # type: (str) -> None + """ + Write the pip delete marker file into this directory. + """ + filepath = os.path.join(directory, PIP_DELETE_MARKER_FILENAME) + with open(filepath, 'w') as marker_fp: + marker_fp.write(DELETE_MARKER_MESSAGE) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/misc.py b/venv/lib/python3.8/site-packages/pip/_internal/utils/misc.py new file mode 100644 index 000000000..554af0bf7 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/utils/misc.py @@ -0,0 +1,904 @@ +# The following comment should be removed at some point in the future. +# mypy: strict-optional=False +# mypy: disallow-untyped-defs=False + +from __future__ import absolute_import + +import contextlib +import errno +import getpass +import hashlib +import io +import logging +import os +import posixpath +import shutil +import stat +import sys +from collections import deque + +from pip._vendor import pkg_resources +# NOTE: retrying is not annotated in typeshed as on 2017-07-17, which is +# why we ignore the type on this import. +from pip._vendor.retrying import retry # type: ignore +from pip._vendor.six import PY2, text_type +from pip._vendor.six.moves import input +from pip._vendor.six.moves.urllib import parse as urllib_parse +from pip._vendor.six.moves.urllib.parse import unquote as urllib_unquote + +from pip import __version__ +from pip._internal.exceptions import CommandError +from pip._internal.locations import ( + get_major_minor_version, + site_packages, + user_site, +) +from pip._internal.utils.compat import ( + WINDOWS, + expanduser, + stdlib_pkgs, + str_to_display, +) +from pip._internal.utils.typing import MYPY_CHECK_RUNNING, cast +from pip._internal.utils.virtualenv import ( + running_under_virtualenv, + virtualenv_no_global, +) + +if PY2: + from io import BytesIO as StringIO +else: + from io import StringIO + +if MYPY_CHECK_RUNNING: + from typing import ( + Any, AnyStr, Container, Iterable, List, Optional, Text, + Tuple, Union, + ) + from pip._vendor.pkg_resources import Distribution + + VersionInfo = Tuple[int, int, int] + + +__all__ = ['rmtree', 'display_path', 'backup_dir', + 'ask', 'splitext', + 'format_size', 'is_installable_dir', + 'normalize_path', + 'renames', 'get_prog', + 'captured_stdout', 'ensure_dir', + 'get_installed_version', 'remove_auth_from_url'] + + +logger = logging.getLogger(__name__) + + +def get_pip_version(): + # type: () -> str + pip_pkg_dir = os.path.join(os.path.dirname(__file__), "..", "..") + pip_pkg_dir = os.path.abspath(pip_pkg_dir) + + return ( + 'pip {} from {} (python {})'.format( + __version__, pip_pkg_dir, get_major_minor_version(), + ) + ) + + +def normalize_version_info(py_version_info): + # type: (Tuple[int, ...]) -> Tuple[int, int, int] + """ + Convert a tuple of ints representing a Python version to one of length + three. + + :param py_version_info: a tuple of ints representing a Python version, + or None to specify no version. The tuple can have any length. + + :return: a tuple of length three if `py_version_info` is non-None. + Otherwise, return `py_version_info` unchanged (i.e. None). + """ + if len(py_version_info) < 3: + py_version_info += (3 - len(py_version_info)) * (0,) + elif len(py_version_info) > 3: + py_version_info = py_version_info[:3] + + return cast('VersionInfo', py_version_info) + + +def ensure_dir(path): + # type: (AnyStr) -> None + """os.path.makedirs without EEXIST.""" + try: + os.makedirs(path) + except OSError as e: + # Windows can raise spurious ENOTEMPTY errors. See #6426. + if e.errno != errno.EEXIST and e.errno != errno.ENOTEMPTY: + raise + + +def get_prog(): + # type: () -> str + try: + prog = os.path.basename(sys.argv[0]) + if prog in ('__main__.py', '-c'): + return "%s -m pip" % sys.executable + else: + return prog + except (AttributeError, TypeError, IndexError): + pass + return 'pip' + + +# Retry every half second for up to 3 seconds +@retry(stop_max_delay=3000, wait_fixed=500) +def rmtree(dir, ignore_errors=False): + # type: (str, bool) -> None + shutil.rmtree(dir, ignore_errors=ignore_errors, + onerror=rmtree_errorhandler) + + +def rmtree_errorhandler(func, path, exc_info): + """On Windows, the files in .svn are read-only, so when rmtree() tries to + remove them, an exception is thrown. We catch that here, remove the + read-only attribute, and hopefully continue without problems.""" + try: + has_attr_readonly = not (os.stat(path).st_mode & stat.S_IWRITE) + except (IOError, OSError): + # it's equivalent to os.path.exists + return + + if has_attr_readonly: + # convert to read/write + os.chmod(path, stat.S_IWRITE) + # use the original function to repeat the operation + func(path) + return + else: + raise + + +def path_to_display(path): + # type: (Optional[Union[str, Text]]) -> Optional[Text] + """ + Convert a bytes (or text) path to text (unicode in Python 2) for display + and logging purposes. + + This function should never error out. Also, this function is mainly needed + for Python 2 since in Python 3 str paths are already text. + """ + if path is None: + return None + if isinstance(path, text_type): + return path + # Otherwise, path is a bytes object (str in Python 2). + try: + display_path = path.decode(sys.getfilesystemencoding(), 'strict') + except UnicodeDecodeError: + # Include the full bytes to make troubleshooting easier, even though + # it may not be very human readable. + if PY2: + # Convert the bytes to a readable str representation using + # repr(), and then convert the str to unicode. + # Also, we add the prefix "b" to the repr() return value both + # to make the Python 2 output look like the Python 3 output, and + # to signal to the user that this is a bytes representation. + display_path = str_to_display('b{!r}'.format(path)) + else: + # Silence the "F821 undefined name 'ascii'" flake8 error since + # in Python 3 ascii() is a built-in. + display_path = ascii(path) # noqa: F821 + + return display_path + + +def display_path(path): + # type: (Union[str, Text]) -> str + """Gives the display value for a given path, making it relative to cwd + if possible.""" + path = os.path.normcase(os.path.abspath(path)) + if sys.version_info[0] == 2: + path = path.decode(sys.getfilesystemencoding(), 'replace') + path = path.encode(sys.getdefaultencoding(), 'replace') + if path.startswith(os.getcwd() + os.path.sep): + path = '.' + path[len(os.getcwd()):] + return path + + +def backup_dir(dir, ext='.bak'): + # type: (str, str) -> str + """Figure out the name of a directory to back up the given dir to + (adding .bak, .bak2, etc)""" + n = 1 + extension = ext + while os.path.exists(dir + extension): + n += 1 + extension = ext + str(n) + return dir + extension + + +def ask_path_exists(message, options): + # type: (str, Iterable[str]) -> str + for action in os.environ.get('PIP_EXISTS_ACTION', '').split(): + if action in options: + return action + return ask(message, options) + + +def _check_no_input(message): + # type: (str) -> None + """Raise an error if no input is allowed.""" + if os.environ.get('PIP_NO_INPUT'): + raise Exception( + 'No input was expected ($PIP_NO_INPUT set); question: %s' % + message + ) + + +def ask(message, options): + # type: (str, Iterable[str]) -> str + """Ask the message interactively, with the given possible responses""" + while 1: + _check_no_input(message) + response = input(message) + response = response.strip().lower() + if response not in options: + print( + 'Your response (%r) was not one of the expected responses: ' + '%s' % (response, ', '.join(options)) + ) + else: + return response + + +def ask_input(message): + # type: (str) -> str + """Ask for input interactively.""" + _check_no_input(message) + return input(message) + + +def ask_password(message): + # type: (str) -> str + """Ask for a password interactively.""" + _check_no_input(message) + return getpass.getpass(message) + + +def format_size(bytes): + # type: (float) -> str + if bytes > 1000 * 1000: + return '%.1f MB' % (bytes / 1000.0 / 1000) + elif bytes > 10 * 1000: + return '%i kB' % (bytes / 1000) + elif bytes > 1000: + return '%.1f kB' % (bytes / 1000.0) + else: + return '%i bytes' % bytes + + +def is_installable_dir(path): + # type: (str) -> bool + """Is path is a directory containing setup.py or pyproject.toml? + """ + if not os.path.isdir(path): + return False + setup_py = os.path.join(path, 'setup.py') + if os.path.isfile(setup_py): + return True + pyproject_toml = os.path.join(path, 'pyproject.toml') + if os.path.isfile(pyproject_toml): + return True + return False + + +def read_chunks(file, size=io.DEFAULT_BUFFER_SIZE): + """Yield pieces of data from a file-like object until EOF.""" + while True: + chunk = file.read(size) + if not chunk: + break + yield chunk + + +def normalize_path(path, resolve_symlinks=True): + # type: (str, bool) -> str + """ + Convert a path to its canonical, case-normalized, absolute version. + + """ + path = expanduser(path) + if resolve_symlinks: + path = os.path.realpath(path) + else: + path = os.path.abspath(path) + return os.path.normcase(path) + + +def splitext(path): + # type: (str) -> Tuple[str, str] + """Like os.path.splitext, but take off .tar too""" + base, ext = posixpath.splitext(path) + if base.lower().endswith('.tar'): + ext = base[-4:] + ext + base = base[:-4] + return base, ext + + +def renames(old, new): + # type: (str, str) -> None + """Like os.renames(), but handles renaming across devices.""" + # Implementation borrowed from os.renames(). + head, tail = os.path.split(new) + if head and tail and not os.path.exists(head): + os.makedirs(head) + + shutil.move(old, new) + + head, tail = os.path.split(old) + if head and tail: + try: + os.removedirs(head) + except OSError: + pass + + +def is_local(path): + # type: (str) -> bool + """ + Return True if this is a path pip is allowed to modify. + + If we're in a virtualenv, sys.prefix points to the virtualenv's + prefix; only sys.prefix is considered local. + + If we're not in a virtualenv, in general we can modify anything. + However, if the OS vendor has configured distutils to install + somewhere other than sys.prefix (which could be a subdirectory of + sys.prefix, e.g. /usr/local), we consider sys.prefix itself nonlocal + and the domain of the OS vendor. (In other words, everything _other + than_ sys.prefix is considered local.) + + Caution: this function assumes the head of path has been normalized + with normalize_path. + """ + + path = normalize_path(path) + prefix = normalize_path(sys.prefix) + + if running_under_virtualenv(): + return path.startswith(normalize_path(sys.prefix)) + else: + from pip._internal.locations import distutils_scheme + if path.startswith(prefix): + for local_path in distutils_scheme("").values(): + if path.startswith(normalize_path(local_path)): + return True + return False + else: + return True + + +def dist_is_local(dist): + # type: (Distribution) -> bool + """ + Return True if given Distribution object is installed somewhere pip + is allowed to modify. + + """ + return is_local(dist_location(dist)) + + +def dist_in_usersite(dist): + # type: (Distribution) -> bool + """ + Return True if given Distribution is installed in user site. + """ + return dist_location(dist).startswith(normalize_path(user_site)) + + +def dist_in_site_packages(dist): + # type: (Distribution) -> bool + """ + Return True if given Distribution is installed in + sysconfig.get_python_lib(). + """ + return dist_location(dist).startswith(normalize_path(site_packages)) + + +def dist_is_editable(dist): + # type: (Distribution) -> bool + """ + Return True if given Distribution is an editable install. + """ + for path_item in sys.path: + egg_link = os.path.join(path_item, dist.project_name + '.egg-link') + if os.path.isfile(egg_link): + return True + return False + + +def get_installed_distributions( + local_only=True, # type: bool + skip=stdlib_pkgs, # type: Container[str] + include_editables=True, # type: bool + editables_only=False, # type: bool + user_only=False, # type: bool + paths=None # type: Optional[List[str]] +): + # type: (...) -> List[Distribution] + """ + Return a list of installed Distribution objects. + + If ``local_only`` is True (default), only return installations + local to the current virtualenv, if in a virtualenv. + + ``skip`` argument is an iterable of lower-case project names to + ignore; defaults to stdlib_pkgs + + If ``include_editables`` is False, don't report editables. + + If ``editables_only`` is True , only report editables. + + If ``user_only`` is True , only report installations in the user + site directory. + + If ``paths`` is set, only report the distributions present at the + specified list of locations. + """ + if paths: + working_set = pkg_resources.WorkingSet(paths) + else: + working_set = pkg_resources.working_set + + if local_only: + local_test = dist_is_local + else: + def local_test(d): + return True + + if include_editables: + def editable_test(d): + return True + else: + def editable_test(d): + return not dist_is_editable(d) + + if editables_only: + def editables_only_test(d): + return dist_is_editable(d) + else: + def editables_only_test(d): + return True + + if user_only: + user_test = dist_in_usersite + else: + def user_test(d): + return True + + return [d for d in working_set + if local_test(d) and + d.key not in skip and + editable_test(d) and + editables_only_test(d) and + user_test(d) + ] + + +def egg_link_path(dist): + # type: (Distribution) -> Optional[str] + """ + Return the path for the .egg-link file if it exists, otherwise, None. + + There's 3 scenarios: + 1) not in a virtualenv + try to find in site.USER_SITE, then site_packages + 2) in a no-global virtualenv + try to find in site_packages + 3) in a yes-global virtualenv + try to find in site_packages, then site.USER_SITE + (don't look in global location) + + For #1 and #3, there could be odd cases, where there's an egg-link in 2 + locations. + + This method will just return the first one found. + """ + sites = [] + if running_under_virtualenv(): + sites.append(site_packages) + if not virtualenv_no_global() and user_site: + sites.append(user_site) + else: + if user_site: + sites.append(user_site) + sites.append(site_packages) + + for site in sites: + egglink = os.path.join(site, dist.project_name) + '.egg-link' + if os.path.isfile(egglink): + return egglink + return None + + +def dist_location(dist): + # type: (Distribution) -> str + """ + Get the site-packages location of this distribution. Generally + this is dist.location, except in the case of develop-installed + packages, where dist.location is the source code location, and we + want to know where the egg-link file is. + + The returned location is normalized (in particular, with symlinks removed). + """ + egg_link = egg_link_path(dist) + if egg_link: + return normalize_path(egg_link) + return normalize_path(dist.location) + + +def write_output(msg, *args): + # type: (str, str) -> None + logger.info(msg, *args) + + +class FakeFile(object): + """Wrap a list of lines in an object with readline() to make + ConfigParser happy.""" + def __init__(self, lines): + self._gen = (l for l in lines) + + def readline(self): + try: + try: + return next(self._gen) + except NameError: + return self._gen.next() + except StopIteration: + return '' + + def __iter__(self): + return self._gen + + +class StreamWrapper(StringIO): + + @classmethod + def from_stream(cls, orig_stream): + cls.orig_stream = orig_stream + return cls() + + # compileall.compile_dir() needs stdout.encoding to print to stdout + @property + def encoding(self): + return self.orig_stream.encoding + + +@contextlib.contextmanager +def captured_output(stream_name): + """Return a context manager used by captured_stdout/stdin/stderr + that temporarily replaces the sys stream *stream_name* with a StringIO. + + Taken from Lib/support/__init__.py in the CPython repo. + """ + orig_stdout = getattr(sys, stream_name) + setattr(sys, stream_name, StreamWrapper.from_stream(orig_stdout)) + try: + yield getattr(sys, stream_name) + finally: + setattr(sys, stream_name, orig_stdout) + + +def captured_stdout(): + """Capture the output of sys.stdout: + + with captured_stdout() as stdout: + print('hello') + self.assertEqual(stdout.getvalue(), 'hello\n') + + Taken from Lib/support/__init__.py in the CPython repo. + """ + return captured_output('stdout') + + +def captured_stderr(): + """ + See captured_stdout(). + """ + return captured_output('stderr') + + +class cached_property(object): + """A property that is only computed once per instance and then replaces + itself with an ordinary attribute. Deleting the attribute resets the + property. + + Source: https://github.com/bottlepy/bottle/blob/0.11.5/bottle.py#L175 + """ + + def __init__(self, func): + self.__doc__ = getattr(func, '__doc__') + self.func = func + + def __get__(self, obj, cls): + if obj is None: + # We're being accessed from the class itself, not from an object + return self + value = obj.__dict__[self.func.__name__] = self.func(obj) + return value + + +def get_installed_version(dist_name, working_set=None): + """Get the installed version of dist_name avoiding pkg_resources cache""" + # Create a requirement that we'll look for inside of setuptools. + req = pkg_resources.Requirement.parse(dist_name) + + if working_set is None: + # We want to avoid having this cached, so we need to construct a new + # working set each time. + working_set = pkg_resources.WorkingSet() + + # Get the installed distribution from our working set + dist = working_set.find(req) + + # Check to see if we got an installed distribution or not, if we did + # we want to return it's version. + return dist.version if dist else None + + +def consume(iterator): + """Consume an iterable at C speed.""" + deque(iterator, maxlen=0) + + +# Simulates an enum +def enum(*sequential, **named): + enums = dict(zip(sequential, range(len(sequential))), **named) + reverse = {value: key for key, value in enums.items()} + enums['reverse_mapping'] = reverse + return type('Enum', (), enums) + + +def build_netloc(host, port): + # type: (str, Optional[int]) -> str + """ + Build a netloc from a host-port pair + """ + if port is None: + return host + if ':' in host: + # Only wrap host with square brackets when it is IPv6 + host = '[{}]'.format(host) + return '{}:{}'.format(host, port) + + +def build_url_from_netloc(netloc, scheme='https'): + # type: (str, str) -> str + """ + Build a full URL from a netloc. + """ + if netloc.count(':') >= 2 and '@' not in netloc and '[' not in netloc: + # It must be a bare IPv6 address, so wrap it with brackets. + netloc = '[{}]'.format(netloc) + return '{}://{}'.format(scheme, netloc) + + +def parse_netloc(netloc): + # type: (str) -> Tuple[str, Optional[int]] + """ + Return the host-port pair from a netloc. + """ + url = build_url_from_netloc(netloc) + parsed = urllib_parse.urlparse(url) + return parsed.hostname, parsed.port + + +def split_auth_from_netloc(netloc): + """ + Parse out and remove the auth information from a netloc. + + Returns: (netloc, (username, password)). + """ + if '@' not in netloc: + return netloc, (None, None) + + # Split from the right because that's how urllib.parse.urlsplit() + # behaves if more than one @ is present (which can be checked using + # the password attribute of urlsplit()'s return value). + auth, netloc = netloc.rsplit('@', 1) + if ':' in auth: + # Split from the left because that's how urllib.parse.urlsplit() + # behaves if more than one : is present (which again can be checked + # using the password attribute of the return value) + user_pass = auth.split(':', 1) + else: + user_pass = auth, None + + user_pass = tuple( + None if x is None else urllib_unquote(x) for x in user_pass + ) + + return netloc, user_pass + + +def redact_netloc(netloc): + # type: (str) -> str + """ + Replace the sensitive data in a netloc with "****", if it exists. + + For example: + - "user:pass@example.com" returns "user:****@example.com" + - "accesstoken@example.com" returns "****@example.com" + """ + netloc, (user, password) = split_auth_from_netloc(netloc) + if user is None: + return netloc + if password is None: + user = '****' + password = '' + else: + user = urllib_parse.quote(user) + password = ':****' + return '{user}{password}@{netloc}'.format(user=user, + password=password, + netloc=netloc) + + +def _transform_url(url, transform_netloc): + """Transform and replace netloc in a url. + + transform_netloc is a function taking the netloc and returning a + tuple. The first element of this tuple is the new netloc. The + entire tuple is returned. + + Returns a tuple containing the transformed url as item 0 and the + original tuple returned by transform_netloc as item 1. + """ + purl = urllib_parse.urlsplit(url) + netloc_tuple = transform_netloc(purl.netloc) + # stripped url + url_pieces = ( + purl.scheme, netloc_tuple[0], purl.path, purl.query, purl.fragment + ) + surl = urllib_parse.urlunsplit(url_pieces) + return surl, netloc_tuple + + +def _get_netloc(netloc): + return split_auth_from_netloc(netloc) + + +def _redact_netloc(netloc): + return (redact_netloc(netloc),) + + +def split_auth_netloc_from_url(url): + # type: (str) -> Tuple[str, str, Tuple[str, str]] + """ + Parse a url into separate netloc, auth, and url with no auth. + + Returns: (url_without_auth, netloc, (username, password)) + """ + url_without_auth, (netloc, auth) = _transform_url(url, _get_netloc) + return url_without_auth, netloc, auth + + +def remove_auth_from_url(url): + # type: (str) -> str + """Return a copy of url with 'username:password@' removed.""" + # username/pass params are passed to subversion through flags + # and are not recognized in the url. + return _transform_url(url, _get_netloc)[0] + + +def redact_auth_from_url(url): + # type: (str) -> str + """Replace the password in a given url with ****.""" + return _transform_url(url, _redact_netloc)[0] + + +class HiddenText(object): + def __init__( + self, + secret, # type: str + redacted, # type: str + ): + # type: (...) -> None + self.secret = secret + self.redacted = redacted + + def __repr__(self): + # type: (...) -> str + return ''.format(str(self)) + + def __str__(self): + # type: (...) -> str + return self.redacted + + # This is useful for testing. + def __eq__(self, other): + # type: (Any) -> bool + if type(self) != type(other): + return False + + # The string being used for redaction doesn't also have to match, + # just the raw, original string. + return (self.secret == other.secret) + + # We need to provide an explicit __ne__ implementation for Python 2. + # TODO: remove this when we drop PY2 support. + def __ne__(self, other): + # type: (Any) -> bool + return not self == other + + +def hide_value(value): + # type: (str) -> HiddenText + return HiddenText(value, redacted='****') + + +def hide_url(url): + # type: (str) -> HiddenText + redacted = redact_auth_from_url(url) + return HiddenText(url, redacted=redacted) + + +def protect_pip_from_modification_on_windows(modifying_pip): + # type: (bool) -> None + """Protection of pip.exe from modification on Windows + + On Windows, any operation modifying pip should be run as: + python -m pip ... + """ + pip_names = [ + "pip.exe", + "pip{}.exe".format(sys.version_info[0]), + "pip{}.{}.exe".format(*sys.version_info[:2]) + ] + + # See https://github.com/pypa/pip/issues/1299 for more discussion + should_show_use_python_msg = ( + modifying_pip and + WINDOWS and + os.path.basename(sys.argv[0]) in pip_names + ) + + if should_show_use_python_msg: + new_command = [ + sys.executable, "-m", "pip" + ] + sys.argv[1:] + raise CommandError( + 'To modify pip, please run the following command:\n{}' + .format(" ".join(new_command)) + ) + + +def is_console_interactive(): + # type: () -> bool + """Is this console interactive? + """ + return sys.stdin is not None and sys.stdin.isatty() + + +def hash_file(path, blocksize=1 << 20): + # type: (str, int) -> Tuple[Any, int] + """Return (hash, length) for path using hashlib.sha256() + """ + + h = hashlib.sha256() + length = 0 + with open(path, 'rb') as f: + for block in read_chunks(f, size=blocksize): + length += len(block) + h.update(block) + return h, length + + +def is_wheel_installed(): + """ + Return whether the wheel package is installed. + """ + try: + import wheel # noqa: F401 + except ImportError: + return False + + return True diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/models.py b/venv/lib/python3.8/site-packages/pip/_internal/utils/models.py new file mode 100644 index 000000000..29e144115 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/utils/models.py @@ -0,0 +1,42 @@ +"""Utilities for defining models +""" +# The following comment should be removed at some point in the future. +# mypy: disallow-untyped-defs=False + +import operator + + +class KeyBasedCompareMixin(object): + """Provides comparison capabilities that is based on a key + """ + + def __init__(self, key, defining_class): + self._compare_key = key + self._defining_class = defining_class + + def __hash__(self): + return hash(self._compare_key) + + def __lt__(self, other): + return self._compare(other, operator.__lt__) + + def __le__(self, other): + return self._compare(other, operator.__le__) + + def __gt__(self, other): + return self._compare(other, operator.__gt__) + + def __ge__(self, other): + return self._compare(other, operator.__ge__) + + def __eq__(self, other): + return self._compare(other, operator.__eq__) + + def __ne__(self, other): + return self._compare(other, operator.__ne__) + + def _compare(self, other, method): + if not isinstance(other, self._defining_class): + return NotImplemented + + return method(self._compare_key, other._compare_key) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/packaging.py b/venv/lib/python3.8/site-packages/pip/_internal/utils/packaging.py new file mode 100644 index 000000000..68aa86edb --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/utils/packaging.py @@ -0,0 +1,94 @@ +from __future__ import absolute_import + +import logging +from email.parser import FeedParser + +from pip._vendor import pkg_resources +from pip._vendor.packaging import specifiers, version + +from pip._internal.exceptions import NoneMetadataError +from pip._internal.utils.misc import display_path +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import Optional, Tuple + from email.message import Message + from pip._vendor.pkg_resources import Distribution + + +logger = logging.getLogger(__name__) + + +def check_requires_python(requires_python, version_info): + # type: (Optional[str], Tuple[int, ...]) -> bool + """ + Check if the given Python version matches a "Requires-Python" specifier. + + :param version_info: A 3-tuple of ints representing a Python + major-minor-micro version to check (e.g. `sys.version_info[:3]`). + + :return: `True` if the given Python version satisfies the requirement. + Otherwise, return `False`. + + :raises InvalidSpecifier: If `requires_python` has an invalid format. + """ + if requires_python is None: + # The package provides no information + return True + requires_python_specifier = specifiers.SpecifierSet(requires_python) + + python_version = version.parse('.'.join(map(str, version_info))) + return python_version in requires_python_specifier + + +def get_metadata(dist): + # type: (Distribution) -> Message + """ + :raises NoneMetadataError: if the distribution reports `has_metadata()` + True but `get_metadata()` returns None. + """ + metadata_name = 'METADATA' + if (isinstance(dist, pkg_resources.DistInfoDistribution) and + dist.has_metadata(metadata_name)): + metadata = dist.get_metadata(metadata_name) + elif dist.has_metadata('PKG-INFO'): + metadata_name = 'PKG-INFO' + metadata = dist.get_metadata(metadata_name) + else: + logger.warning("No metadata found in %s", display_path(dist.location)) + metadata = '' + + if metadata is None: + raise NoneMetadataError(dist, metadata_name) + + feed_parser = FeedParser() + # The following line errors out if with a "NoneType" TypeError if + # passed metadata=None. + feed_parser.feed(metadata) + return feed_parser.close() + + +def get_requires_python(dist): + # type: (pkg_resources.Distribution) -> Optional[str] + """ + Return the "Requires-Python" metadata for a distribution, or None + if not present. + """ + pkg_info_dict = get_metadata(dist) + requires_python = pkg_info_dict.get('Requires-Python') + + if requires_python is not None: + # Convert to a str to satisfy the type checker, since requires_python + # can be a Header object. + requires_python = str(requires_python) + + return requires_python + + +def get_installer(dist): + # type: (Distribution) -> str + if dist.has_metadata('INSTALLER'): + for line in dist.get_metadata_lines('INSTALLER'): + if line.strip(): + return line.strip() + return '' diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/pkg_resources.py b/venv/lib/python3.8/site-packages/pip/_internal/utils/pkg_resources.py new file mode 100644 index 000000000..0bc129acc --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/utils/pkg_resources.py @@ -0,0 +1,44 @@ +from pip._vendor.pkg_resources import yield_lines +from pip._vendor.six import ensure_str + +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import Dict, Iterable, List + + +class DictMetadata(object): + """IMetadataProvider that reads metadata files from a dictionary. + """ + def __init__(self, metadata): + # type: (Dict[str, bytes]) -> None + self._metadata = metadata + + def has_metadata(self, name): + # type: (str) -> bool + return name in self._metadata + + def get_metadata(self, name): + # type: (str) -> str + try: + return ensure_str(self._metadata[name]) + except UnicodeDecodeError as e: + # Mirrors handling done in pkg_resources.NullProvider. + e.reason += " in {} file".format(name) + raise + + def get_metadata_lines(self, name): + # type: (str) -> Iterable[str] + return yield_lines(self.get_metadata(name)) + + def metadata_isdir(self, name): + # type: (str) -> bool + return False + + def metadata_listdir(self, name): + # type: (str) -> List[str] + return [] + + def run_script(self, script_name, namespace): + # type: (str, str) -> None + pass diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/setuptools_build.py b/venv/lib/python3.8/site-packages/pip/_internal/utils/setuptools_build.py new file mode 100644 index 000000000..4147a650d --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/utils/setuptools_build.py @@ -0,0 +1,181 @@ +import sys + +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import List, Optional, Sequence + +# Shim to wrap setup.py invocation with setuptools +# +# We set sys.argv[0] to the path to the underlying setup.py file so +# setuptools / distutils don't take the path to the setup.py to be "-c" when +# invoking via the shim. This avoids e.g. the following manifest_maker +# warning: "warning: manifest_maker: standard file '-c' not found". +_SETUPTOOLS_SHIM = ( + "import sys, setuptools, tokenize; sys.argv[0] = {0!r}; __file__={0!r};" + "f=getattr(tokenize, 'open', open)(__file__);" + "code=f.read().replace('\\r\\n', '\\n');" + "f.close();" + "exec(compile(code, __file__, 'exec'))" +) + + +def make_setuptools_shim_args( + setup_py_path, # type: str + global_options=None, # type: Sequence[str] + no_user_config=False, # type: bool + unbuffered_output=False # type: bool +): + # type: (...) -> List[str] + """ + Get setuptools command arguments with shim wrapped setup file invocation. + + :param setup_py_path: The path to setup.py to be wrapped. + :param global_options: Additional global options. + :param no_user_config: If True, disables personal user configuration. + :param unbuffered_output: If True, adds the unbuffered switch to the + argument list. + """ + args = [sys.executable] + if unbuffered_output: + args += ["-u"] + args += ["-c", _SETUPTOOLS_SHIM.format(setup_py_path)] + if global_options: + args += global_options + if no_user_config: + args += ["--no-user-cfg"] + return args + + +def make_setuptools_bdist_wheel_args( + setup_py_path, # type: str + global_options, # type: Sequence[str] + build_options, # type: Sequence[str] + destination_dir, # type: str +): + # type: (...) -> List[str] + # NOTE: Eventually, we'd want to also -S to the flags here, when we're + # isolating. Currently, it breaks Python in virtualenvs, because it + # relies on site.py to find parts of the standard library outside the + # virtualenv. + args = make_setuptools_shim_args( + setup_py_path, + global_options=global_options, + unbuffered_output=True + ) + args += ["bdist_wheel", "-d", destination_dir] + args += build_options + return args + + +def make_setuptools_clean_args( + setup_py_path, # type: str + global_options, # type: Sequence[str] +): + # type: (...) -> List[str] + args = make_setuptools_shim_args( + setup_py_path, + global_options=global_options, + unbuffered_output=True + ) + args += ["clean", "--all"] + return args + + +def make_setuptools_develop_args( + setup_py_path, # type: str + global_options, # type: Sequence[str] + install_options, # type: Sequence[str] + no_user_config, # type: bool + prefix, # type: Optional[str] + home, # type: Optional[str] + use_user_site, # type: bool +): + # type: (...) -> List[str] + assert not (use_user_site and prefix) + + args = make_setuptools_shim_args( + setup_py_path, + global_options=global_options, + no_user_config=no_user_config, + ) + + args += ["develop", "--no-deps"] + + args += install_options + + if prefix: + args += ["--prefix", prefix] + if home is not None: + args += ["--home", home] + + if use_user_site: + args += ["--user", "--prefix="] + + return args + + +def make_setuptools_egg_info_args( + setup_py_path, # type: str + egg_info_dir, # type: Optional[str] + no_user_config, # type: bool +): + # type: (...) -> List[str] + args = make_setuptools_shim_args(setup_py_path) + if no_user_config: + args += ["--no-user-cfg"] + + args += ["egg_info"] + + if egg_info_dir: + args += ["--egg-base", egg_info_dir] + + return args + + +def make_setuptools_install_args( + setup_py_path, # type: str + global_options, # type: Sequence[str] + install_options, # type: Sequence[str] + record_filename, # type: str + root, # type: Optional[str] + prefix, # type: Optional[str] + header_dir, # type: Optional[str] + home, # type: Optional[str] + use_user_site, # type: bool + no_user_config, # type: bool + pycompile # type: bool +): + # type: (...) -> List[str] + assert not (use_user_site and prefix) + assert not (use_user_site and root) + + args = make_setuptools_shim_args( + setup_py_path, + global_options=global_options, + no_user_config=no_user_config, + unbuffered_output=True + ) + args += ["install", "--record", record_filename] + args += ["--single-version-externally-managed"] + + if root is not None: + args += ["--root", root] + if prefix is not None: + args += ["--prefix", prefix] + if home is not None: + args += ["--home", home] + if use_user_site: + args += ["--user", "--prefix="] + + if pycompile: + args += ["--compile"] + else: + args += ["--no-compile"] + + if header_dir: + args += ["--install-headers", header_dir] + + args += install_options + + return args diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/subprocess.py b/venv/lib/python3.8/site-packages/pip/_internal/utils/subprocess.py new file mode 100644 index 000000000..ea0176d34 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/utils/subprocess.py @@ -0,0 +1,278 @@ +# The following comment should be removed at some point in the future. +# mypy: strict-optional=False + +from __future__ import absolute_import + +import logging +import os +import subprocess + +from pip._vendor.six.moves import shlex_quote + +from pip._internal.exceptions import InstallationError +from pip._internal.utils.compat import console_to_str, str_to_display +from pip._internal.utils.logging import subprocess_logger +from pip._internal.utils.misc import HiddenText, path_to_display +from pip._internal.utils.typing import MYPY_CHECK_RUNNING +from pip._internal.utils.ui import open_spinner + +if MYPY_CHECK_RUNNING: + from typing import ( + Any, Callable, Iterable, List, Mapping, Optional, Text, Union, + ) + from pip._internal.utils.ui import SpinnerInterface + + CommandArgs = List[Union[str, HiddenText]] + + +LOG_DIVIDER = '----------------------------------------' + + +def make_command(*args): + # type: (Union[str, HiddenText, CommandArgs]) -> CommandArgs + """ + Create a CommandArgs object. + """ + command_args = [] # type: CommandArgs + for arg in args: + # Check for list instead of CommandArgs since CommandArgs is + # only known during type-checking. + if isinstance(arg, list): + command_args.extend(arg) + else: + # Otherwise, arg is str or HiddenText. + command_args.append(arg) + + return command_args + + +def format_command_args(args): + # type: (Union[List[str], CommandArgs]) -> str + """ + Format command arguments for display. + """ + # For HiddenText arguments, display the redacted form by calling str(). + # Also, we don't apply str() to arguments that aren't HiddenText since + # this can trigger a UnicodeDecodeError in Python 2 if the argument + # has type unicode and includes a non-ascii character. (The type + # checker doesn't ensure the annotations are correct in all cases.) + return ' '.join( + shlex_quote(str(arg)) if isinstance(arg, HiddenText) + else shlex_quote(arg) for arg in args + ) + + +def reveal_command_args(args): + # type: (Union[List[str], CommandArgs]) -> List[str] + """ + Return the arguments in their raw, unredacted form. + """ + return [ + arg.secret if isinstance(arg, HiddenText) else arg for arg in args + ] + + +def make_subprocess_output_error( + cmd_args, # type: Union[List[str], CommandArgs] + cwd, # type: Optional[str] + lines, # type: List[Text] + exit_status, # type: int +): + # type: (...) -> Text + """ + Create and return the error message to use to log a subprocess error + with command output. + + :param lines: A list of lines, each ending with a newline. + """ + command = format_command_args(cmd_args) + # Convert `command` and `cwd` to text (unicode in Python 2) so we can use + # them as arguments in the unicode format string below. This avoids + # "UnicodeDecodeError: 'ascii' codec can't decode byte ..." in Python 2 + # if either contains a non-ascii character. + command_display = str_to_display(command, desc='command bytes') + cwd_display = path_to_display(cwd) + + # We know the joined output value ends in a newline. + output = ''.join(lines) + msg = ( + # Use a unicode string to avoid "UnicodeEncodeError: 'ascii' + # codec can't encode character ..." in Python 2 when a format + # argument (e.g. `output`) has a non-ascii character. + u'Command errored out with exit status {exit_status}:\n' + ' command: {command_display}\n' + ' cwd: {cwd_display}\n' + 'Complete output ({line_count} lines):\n{output}{divider}' + ).format( + exit_status=exit_status, + command_display=command_display, + cwd_display=cwd_display, + line_count=len(lines), + output=output, + divider=LOG_DIVIDER, + ) + return msg + + +def call_subprocess( + cmd, # type: Union[List[str], CommandArgs] + show_stdout=False, # type: bool + cwd=None, # type: Optional[str] + on_returncode='raise', # type: str + extra_ok_returncodes=None, # type: Optional[Iterable[int]] + command_desc=None, # type: Optional[str] + extra_environ=None, # type: Optional[Mapping[str, Any]] + unset_environ=None, # type: Optional[Iterable[str]] + spinner=None, # type: Optional[SpinnerInterface] + log_failed_cmd=True # type: Optional[bool] +): + # type: (...) -> Text + """ + Args: + show_stdout: if true, use INFO to log the subprocess's stderr and + stdout streams. Otherwise, use DEBUG. Defaults to False. + extra_ok_returncodes: an iterable of integer return codes that are + acceptable, in addition to 0. Defaults to None, which means []. + unset_environ: an iterable of environment variable names to unset + prior to calling subprocess.Popen(). + log_failed_cmd: if false, failed commands are not logged, only raised. + """ + if extra_ok_returncodes is None: + extra_ok_returncodes = [] + if unset_environ is None: + unset_environ = [] + # Most places in pip use show_stdout=False. What this means is-- + # + # - We connect the child's output (combined stderr and stdout) to a + # single pipe, which we read. + # - We log this output to stderr at DEBUG level as it is received. + # - If DEBUG logging isn't enabled (e.g. if --verbose logging wasn't + # requested), then we show a spinner so the user can still see the + # subprocess is in progress. + # - If the subprocess exits with an error, we log the output to stderr + # at ERROR level if it hasn't already been displayed to the console + # (e.g. if --verbose logging wasn't enabled). This way we don't log + # the output to the console twice. + # + # If show_stdout=True, then the above is still done, but with DEBUG + # replaced by INFO. + if show_stdout: + # Then log the subprocess output at INFO level. + log_subprocess = subprocess_logger.info + used_level = logging.INFO + else: + # Then log the subprocess output using DEBUG. This also ensures + # it will be logged to the log file (aka user_log), if enabled. + log_subprocess = subprocess_logger.debug + used_level = logging.DEBUG + + # Whether the subprocess will be visible in the console. + showing_subprocess = subprocess_logger.getEffectiveLevel() <= used_level + + # Only use the spinner if we're not showing the subprocess output + # and we have a spinner. + use_spinner = not showing_subprocess and spinner is not None + + if command_desc is None: + command_desc = format_command_args(cmd) + + log_subprocess("Running command %s", command_desc) + env = os.environ.copy() + if extra_environ: + env.update(extra_environ) + for name in unset_environ: + env.pop(name, None) + try: + proc = subprocess.Popen( + # Convert HiddenText objects to the underlying str. + reveal_command_args(cmd), + stderr=subprocess.STDOUT, stdin=subprocess.PIPE, + stdout=subprocess.PIPE, cwd=cwd, env=env, + ) + proc.stdin.close() + except Exception as exc: + if log_failed_cmd: + subprocess_logger.critical( + "Error %s while executing command %s", exc, command_desc, + ) + raise + all_output = [] + while True: + # The "line" value is a unicode string in Python 2. + line = console_to_str(proc.stdout.readline()) + if not line: + break + line = line.rstrip() + all_output.append(line + '\n') + + # Show the line immediately. + log_subprocess(line) + # Update the spinner. + if use_spinner: + spinner.spin() + try: + proc.wait() + finally: + if proc.stdout: + proc.stdout.close() + proc_had_error = ( + proc.returncode and proc.returncode not in extra_ok_returncodes + ) + if use_spinner: + if proc_had_error: + spinner.finish("error") + else: + spinner.finish("done") + if proc_had_error: + if on_returncode == 'raise': + if not showing_subprocess and log_failed_cmd: + # Then the subprocess streams haven't been logged to the + # console yet. + msg = make_subprocess_output_error( + cmd_args=cmd, + cwd=cwd, + lines=all_output, + exit_status=proc.returncode, + ) + subprocess_logger.error(msg) + exc_msg = ( + 'Command errored out with exit status {}: {} ' + 'Check the logs for full command output.' + ).format(proc.returncode, command_desc) + raise InstallationError(exc_msg) + elif on_returncode == 'warn': + subprocess_logger.warning( + 'Command "%s" had error code %s in %s', + command_desc, proc.returncode, cwd, + ) + elif on_returncode == 'ignore': + pass + else: + raise ValueError('Invalid value: on_returncode=%s' % + repr(on_returncode)) + return ''.join(all_output) + + +def runner_with_spinner_message(message): + # type: (str) -> Callable[..., None] + """Provide a subprocess_runner that shows a spinner message. + + Intended for use with for pep517's Pep517HookCaller. Thus, the runner has + an API that matches what's expected by Pep517HookCaller.subprocess_runner. + """ + + def runner( + cmd, # type: List[str] + cwd=None, # type: Optional[str] + extra_environ=None # type: Optional[Mapping[str, Any]] + ): + # type: (...) -> None + with open_spinner(message) as spinner: + call_subprocess( + cmd, + cwd=cwd, + extra_environ=extra_environ, + spinner=spinner, + ) + + return runner diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/temp_dir.py b/venv/lib/python3.8/site-packages/pip/_internal/utils/temp_dir.py new file mode 100644 index 000000000..65e41bc70 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/utils/temp_dir.py @@ -0,0 +1,250 @@ +from __future__ import absolute_import + +import errno +import itertools +import logging +import os.path +import tempfile +from contextlib import contextmanager + +from pip._vendor.contextlib2 import ExitStack + +from pip._internal.utils.misc import rmtree +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import Any, Dict, Iterator, Optional, TypeVar + + _T = TypeVar('_T', bound='TempDirectory') + + +logger = logging.getLogger(__name__) + + +_tempdir_manager = None # type: Optional[ExitStack] + + +@contextmanager +def global_tempdir_manager(): + # type: () -> Iterator[None] + global _tempdir_manager + with ExitStack() as stack: + old_tempdir_manager, _tempdir_manager = _tempdir_manager, stack + try: + yield + finally: + _tempdir_manager = old_tempdir_manager + + +class TempDirectoryTypeRegistry(object): + """Manages temp directory behavior + """ + + def __init__(self): + # type: () -> None + self._should_delete = {} # type: Dict[str, bool] + + def set_delete(self, kind, value): + # type: (str, bool) -> None + """Indicate whether a TempDirectory of the given kind should be + auto-deleted. + """ + self._should_delete[kind] = value + + def get_delete(self, kind): + # type: (str) -> bool + """Get configured auto-delete flag for a given TempDirectory type, + default True. + """ + return self._should_delete.get(kind, True) + + +_tempdir_registry = None # type: Optional[TempDirectoryTypeRegistry] + + +@contextmanager +def tempdir_registry(): + # type: () -> Iterator[TempDirectoryTypeRegistry] + """Provides a scoped global tempdir registry that can be used to dictate + whether directories should be deleted. + """ + global _tempdir_registry + old_tempdir_registry = _tempdir_registry + _tempdir_registry = TempDirectoryTypeRegistry() + try: + yield _tempdir_registry + finally: + _tempdir_registry = old_tempdir_registry + + +class TempDirectory(object): + """Helper class that owns and cleans up a temporary directory. + + This class can be used as a context manager or as an OO representation of a + temporary directory. + + Attributes: + path + Location to the created temporary directory + delete + Whether the directory should be deleted when exiting + (when used as a contextmanager) + + Methods: + cleanup() + Deletes the temporary directory + + When used as a context manager, if the delete attribute is True, on + exiting the context the temporary directory is deleted. + """ + + def __init__( + self, + path=None, # type: Optional[str] + delete=None, # type: Optional[bool] + kind="temp", # type: str + globally_managed=False, # type: bool + ): + super(TempDirectory, self).__init__() + + # If we were given an explicit directory, resolve delete option now. + # Otherwise we wait until cleanup and see what tempdir_registry says. + if path is not None and delete is None: + delete = False + + if path is None: + path = self._create(kind) + + self._path = path + self._deleted = False + self.delete = delete + self.kind = kind + + if globally_managed: + assert _tempdir_manager is not None + _tempdir_manager.enter_context(self) + + @property + def path(self): + # type: () -> str + assert not self._deleted, ( + "Attempted to access deleted path: {}".format(self._path) + ) + return self._path + + def __repr__(self): + # type: () -> str + return "<{} {!r}>".format(self.__class__.__name__, self.path) + + def __enter__(self): + # type: (_T) -> _T + return self + + def __exit__(self, exc, value, tb): + # type: (Any, Any, Any) -> None + if self.delete is not None: + delete = self.delete + elif _tempdir_registry: + delete = _tempdir_registry.get_delete(self.kind) + else: + delete = True + + if delete: + self.cleanup() + + def _create(self, kind): + # type: (str) -> str + """Create a temporary directory and store its path in self.path + """ + # We realpath here because some systems have their default tmpdir + # symlinked to another directory. This tends to confuse build + # scripts, so we canonicalize the path by traversing potential + # symlinks here. + path = os.path.realpath( + tempfile.mkdtemp(prefix="pip-{}-".format(kind)) + ) + logger.debug("Created temporary directory: {}".format(path)) + return path + + def cleanup(self): + # type: () -> None + """Remove the temporary directory created and reset state + """ + self._deleted = True + if os.path.exists(self._path): + rmtree(self._path) + + +class AdjacentTempDirectory(TempDirectory): + """Helper class that creates a temporary directory adjacent to a real one. + + Attributes: + original + The original directory to create a temp directory for. + path + After calling create() or entering, contains the full + path to the temporary directory. + delete + Whether the directory should be deleted when exiting + (when used as a contextmanager) + + """ + # The characters that may be used to name the temp directory + # We always prepend a ~ and then rotate through these until + # a usable name is found. + # pkg_resources raises a different error for .dist-info folder + # with leading '-' and invalid metadata + LEADING_CHARS = "-~.=%0123456789" + + def __init__(self, original, delete=None): + # type: (str, Optional[bool]) -> None + self.original = original.rstrip('/\\') + super(AdjacentTempDirectory, self).__init__(delete=delete) + + @classmethod + def _generate_names(cls, name): + # type: (str) -> Iterator[str] + """Generates a series of temporary names. + + The algorithm replaces the leading characters in the name + with ones that are valid filesystem characters, but are not + valid package names (for both Python and pip definitions of + package). + """ + for i in range(1, len(name)): + for candidate in itertools.combinations_with_replacement( + cls.LEADING_CHARS, i - 1): + new_name = '~' + ''.join(candidate) + name[i:] + if new_name != name: + yield new_name + + # If we make it this far, we will have to make a longer name + for i in range(len(cls.LEADING_CHARS)): + for candidate in itertools.combinations_with_replacement( + cls.LEADING_CHARS, i): + new_name = '~' + ''.join(candidate) + name + if new_name != name: + yield new_name + + def _create(self, kind): + # type: (str) -> str + root, name = os.path.split(self.original) + for candidate in self._generate_names(name): + path = os.path.join(root, candidate) + try: + os.mkdir(path) + except OSError as ex: + # Continue if the name exists already + if ex.errno != errno.EEXIST: + raise + else: + path = os.path.realpath(path) + break + else: + # Final fallback on the default behavior. + path = os.path.realpath( + tempfile.mkdtemp(prefix="pip-{}-".format(kind)) + ) + + logger.debug("Created temporary directory: {}".format(path)) + return path diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/typing.py b/venv/lib/python3.8/site-packages/pip/_internal/utils/typing.py new file mode 100644 index 000000000..8505a29b1 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/utils/typing.py @@ -0,0 +1,38 @@ +"""For neatly implementing static typing in pip. + +`mypy` - the static type analysis tool we use - uses the `typing` module, which +provides core functionality fundamental to mypy's functioning. + +Generally, `typing` would be imported at runtime and used in that fashion - +it acts as a no-op at runtime and does not have any run-time overhead by +design. + +As it turns out, `typing` is not vendorable - it uses separate sources for +Python 2/Python 3. Thus, this codebase can not expect it to be present. +To work around this, mypy allows the typing import to be behind a False-y +optional to prevent it from running at runtime and type-comments can be used +to remove the need for the types to be accessible directly during runtime. + +This module provides the False-y guard in a nicely named fashion so that a +curious maintainer can reach here to read this. + +In pip, all static-typing related imports should be guarded as follows: + + from pip._internal.utils.typing import MYPY_CHECK_RUNNING + + if MYPY_CHECK_RUNNING: + from typing import ... + +Ref: https://github.com/python/mypy/issues/3216 +""" + +MYPY_CHECK_RUNNING = False + + +if MYPY_CHECK_RUNNING: + from typing import cast +else: + # typing's cast() is needed at runtime, but we don't want to import typing. + # Thus, we use a dummy no-op version, which we tell mypy to ignore. + def cast(type_, value): # type: ignore + return value diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/ui.py b/venv/lib/python3.8/site-packages/pip/_internal/utils/ui.py new file mode 100644 index 000000000..87782aa64 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/utils/ui.py @@ -0,0 +1,428 @@ +# The following comment should be removed at some point in the future. +# mypy: strict-optional=False +# mypy: disallow-untyped-defs=False + +from __future__ import absolute_import, division + +import contextlib +import itertools +import logging +import sys +import time +from signal import SIGINT, default_int_handler, signal + +from pip._vendor import six +from pip._vendor.progress import HIDE_CURSOR, SHOW_CURSOR +from pip._vendor.progress.bar import Bar, FillingCirclesBar, IncrementalBar +from pip._vendor.progress.spinner import Spinner + +from pip._internal.utils.compat import WINDOWS +from pip._internal.utils.logging import get_indentation +from pip._internal.utils.misc import format_size +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import Any, Iterator, IO + +try: + from pip._vendor import colorama +# Lots of different errors can come from this, including SystemError and +# ImportError. +except Exception: + colorama = None + +logger = logging.getLogger(__name__) + + +def _select_progress_class(preferred, fallback): + encoding = getattr(preferred.file, "encoding", None) + + # If we don't know what encoding this file is in, then we'll just assume + # that it doesn't support unicode and use the ASCII bar. + if not encoding: + return fallback + + # Collect all of the possible characters we want to use with the preferred + # bar. + characters = [ + getattr(preferred, "empty_fill", six.text_type()), + getattr(preferred, "fill", six.text_type()), + ] + characters += list(getattr(preferred, "phases", [])) + + # Try to decode the characters we're using for the bar using the encoding + # of the given file, if this works then we'll assume that we can use the + # fancier bar and if not we'll fall back to the plaintext bar. + try: + six.text_type().join(characters).encode(encoding) + except UnicodeEncodeError: + return fallback + else: + return preferred + + +_BaseBar = _select_progress_class(IncrementalBar, Bar) # type: Any + + +class InterruptibleMixin(object): + """ + Helper to ensure that self.finish() gets called on keyboard interrupt. + + This allows downloads to be interrupted without leaving temporary state + (like hidden cursors) behind. + + This class is similar to the progress library's existing SigIntMixin + helper, but as of version 1.2, that helper has the following problems: + + 1. It calls sys.exit(). + 2. It discards the existing SIGINT handler completely. + 3. It leaves its own handler in place even after an uninterrupted finish, + which will have unexpected delayed effects if the user triggers an + unrelated keyboard interrupt some time after a progress-displaying + download has already completed, for example. + """ + + def __init__(self, *args, **kwargs): + """ + Save the original SIGINT handler for later. + """ + super(InterruptibleMixin, self).__init__(*args, **kwargs) + + self.original_handler = signal(SIGINT, self.handle_sigint) + + # If signal() returns None, the previous handler was not installed from + # Python, and we cannot restore it. This probably should not happen, + # but if it does, we must restore something sensible instead, at least. + # The least bad option should be Python's default SIGINT handler, which + # just raises KeyboardInterrupt. + if self.original_handler is None: + self.original_handler = default_int_handler + + def finish(self): + """ + Restore the original SIGINT handler after finishing. + + This should happen regardless of whether the progress display finishes + normally, or gets interrupted. + """ + super(InterruptibleMixin, self).finish() + signal(SIGINT, self.original_handler) + + def handle_sigint(self, signum, frame): + """ + Call self.finish() before delegating to the original SIGINT handler. + + This handler should only be in place while the progress display is + active. + """ + self.finish() + self.original_handler(signum, frame) + + +class SilentBar(Bar): + + def update(self): + pass + + +class BlueEmojiBar(IncrementalBar): + + suffix = "%(percent)d%%" + bar_prefix = " " + bar_suffix = " " + phases = (u"\U0001F539", u"\U0001F537", u"\U0001F535") # type: Any + + +class DownloadProgressMixin(object): + + def __init__(self, *args, **kwargs): + super(DownloadProgressMixin, self).__init__(*args, **kwargs) + self.message = (" " * (get_indentation() + 2)) + self.message + + @property + def downloaded(self): + return format_size(self.index) + + @property + def download_speed(self): + # Avoid zero division errors... + if self.avg == 0.0: + return "..." + return format_size(1 / self.avg) + "/s" + + @property + def pretty_eta(self): + if self.eta: + return "eta %s" % self.eta_td + return "" + + def iter(self, it): + for x in it: + yield x + self.next(len(x)) + self.finish() + + +class WindowsMixin(object): + + def __init__(self, *args, **kwargs): + # The Windows terminal does not support the hide/show cursor ANSI codes + # even with colorama. So we'll ensure that hide_cursor is False on + # Windows. + # This call needs to go before the super() call, so that hide_cursor + # is set in time. The base progress bar class writes the "hide cursor" + # code to the terminal in its init, so if we don't set this soon + # enough, we get a "hide" with no corresponding "show"... + if WINDOWS and self.hide_cursor: + self.hide_cursor = False + + super(WindowsMixin, self).__init__(*args, **kwargs) + + # Check if we are running on Windows and we have the colorama module, + # if we do then wrap our file with it. + if WINDOWS and colorama: + self.file = colorama.AnsiToWin32(self.file) + # The progress code expects to be able to call self.file.isatty() + # but the colorama.AnsiToWin32() object doesn't have that, so we'll + # add it. + self.file.isatty = lambda: self.file.wrapped.isatty() + # The progress code expects to be able to call self.file.flush() + # but the colorama.AnsiToWin32() object doesn't have that, so we'll + # add it. + self.file.flush = lambda: self.file.wrapped.flush() + + +class BaseDownloadProgressBar(WindowsMixin, InterruptibleMixin, + DownloadProgressMixin): + + file = sys.stdout + message = "%(percent)d%%" + suffix = "%(downloaded)s %(download_speed)s %(pretty_eta)s" + +# NOTE: The "type: ignore" comments on the following classes are there to +# work around https://github.com/python/typing/issues/241 + + +class DefaultDownloadProgressBar(BaseDownloadProgressBar, + _BaseBar): + pass + + +class DownloadSilentBar(BaseDownloadProgressBar, SilentBar): # type: ignore + pass + + +class DownloadBar(BaseDownloadProgressBar, # type: ignore + Bar): + pass + + +class DownloadFillingCirclesBar(BaseDownloadProgressBar, # type: ignore + FillingCirclesBar): + pass + + +class DownloadBlueEmojiProgressBar(BaseDownloadProgressBar, # type: ignore + BlueEmojiBar): + pass + + +class DownloadProgressSpinner(WindowsMixin, InterruptibleMixin, + DownloadProgressMixin, Spinner): + + file = sys.stdout + suffix = "%(downloaded)s %(download_speed)s" + + def next_phase(self): + if not hasattr(self, "_phaser"): + self._phaser = itertools.cycle(self.phases) + return next(self._phaser) + + def update(self): + message = self.message % self + phase = self.next_phase() + suffix = self.suffix % self + line = ''.join([ + message, + " " if message else "", + phase, + " " if suffix else "", + suffix, + ]) + + self.writeln(line) + + +BAR_TYPES = { + "off": (DownloadSilentBar, DownloadSilentBar), + "on": (DefaultDownloadProgressBar, DownloadProgressSpinner), + "ascii": (DownloadBar, DownloadProgressSpinner), + "pretty": (DownloadFillingCirclesBar, DownloadProgressSpinner), + "emoji": (DownloadBlueEmojiProgressBar, DownloadProgressSpinner) +} + + +def DownloadProgressProvider(progress_bar, max=None): + if max is None or max == 0: + return BAR_TYPES[progress_bar][1]().iter + else: + return BAR_TYPES[progress_bar][0](max=max).iter + + +################################################################ +# Generic "something is happening" spinners +# +# We don't even try using progress.spinner.Spinner here because it's actually +# simpler to reimplement from scratch than to coerce their code into doing +# what we need. +################################################################ + +@contextlib.contextmanager +def hidden_cursor(file): + # type: (IO[Any]) -> Iterator[None] + # The Windows terminal does not support the hide/show cursor ANSI codes, + # even via colorama. So don't even try. + if WINDOWS: + yield + # We don't want to clutter the output with control characters if we're + # writing to a file, or if the user is running with --quiet. + # See https://github.com/pypa/pip/issues/3418 + elif not file.isatty() or logger.getEffectiveLevel() > logging.INFO: + yield + else: + file.write(HIDE_CURSOR) + try: + yield + finally: + file.write(SHOW_CURSOR) + + +class RateLimiter(object): + def __init__(self, min_update_interval_seconds): + # type: (float) -> None + self._min_update_interval_seconds = min_update_interval_seconds + self._last_update = 0 # type: float + + def ready(self): + # type: () -> bool + now = time.time() + delta = now - self._last_update + return delta >= self._min_update_interval_seconds + + def reset(self): + # type: () -> None + self._last_update = time.time() + + +class SpinnerInterface(object): + def spin(self): + # type: () -> None + raise NotImplementedError() + + def finish(self, final_status): + # type: (str) -> None + raise NotImplementedError() + + +class InteractiveSpinner(SpinnerInterface): + def __init__(self, message, file=None, spin_chars="-\\|/", + # Empirically, 8 updates/second looks nice + min_update_interval_seconds=0.125): + self._message = message + if file is None: + file = sys.stdout + self._file = file + self._rate_limiter = RateLimiter(min_update_interval_seconds) + self._finished = False + + self._spin_cycle = itertools.cycle(spin_chars) + + self._file.write(" " * get_indentation() + self._message + " ... ") + self._width = 0 + + def _write(self, status): + assert not self._finished + # Erase what we wrote before by backspacing to the beginning, writing + # spaces to overwrite the old text, and then backspacing again + backup = "\b" * self._width + self._file.write(backup + " " * self._width + backup) + # Now we have a blank slate to add our status + self._file.write(status) + self._width = len(status) + self._file.flush() + self._rate_limiter.reset() + + def spin(self): + # type: () -> None + if self._finished: + return + if not self._rate_limiter.ready(): + return + self._write(next(self._spin_cycle)) + + def finish(self, final_status): + # type: (str) -> None + if self._finished: + return + self._write(final_status) + self._file.write("\n") + self._file.flush() + self._finished = True + + +# Used for dumb terminals, non-interactive installs (no tty), etc. +# We still print updates occasionally (once every 60 seconds by default) to +# act as a keep-alive for systems like Travis-CI that take lack-of-output as +# an indication that a task has frozen. +class NonInteractiveSpinner(SpinnerInterface): + def __init__(self, message, min_update_interval_seconds=60): + # type: (str, float) -> None + self._message = message + self._finished = False + self._rate_limiter = RateLimiter(min_update_interval_seconds) + self._update("started") + + def _update(self, status): + assert not self._finished + self._rate_limiter.reset() + logger.info("%s: %s", self._message, status) + + def spin(self): + # type: () -> None + if self._finished: + return + if not self._rate_limiter.ready(): + return + self._update("still running...") + + def finish(self, final_status): + # type: (str) -> None + if self._finished: + return + self._update("finished with status '%s'" % (final_status,)) + self._finished = True + + +@contextlib.contextmanager +def open_spinner(message): + # type: (str) -> Iterator[SpinnerInterface] + # Interactive spinner goes directly to sys.stdout rather than being routed + # through the logging system, but it acts like it has level INFO, + # i.e. it's only displayed if we're at level INFO or better. + # Non-interactive spinner goes through the logging system, so it is always + # in sync with logging configuration. + if sys.stdout.isatty() and logger.getEffectiveLevel() <= logging.INFO: + spinner = InteractiveSpinner(message) # type: SpinnerInterface + else: + spinner = NonInteractiveSpinner(message) + try: + with hidden_cursor(sys.stdout): + yield spinner + except KeyboardInterrupt: + spinner.finish("canceled") + raise + except Exception: + spinner.finish("error") + raise + else: + spinner.finish("done") diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/unpacking.py b/venv/lib/python3.8/site-packages/pip/_internal/utils/unpacking.py new file mode 100644 index 000000000..7252dc217 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/utils/unpacking.py @@ -0,0 +1,272 @@ +"""Utilities related archives. +""" + +# The following comment should be removed at some point in the future. +# mypy: strict-optional=False +# mypy: disallow-untyped-defs=False + +from __future__ import absolute_import + +import logging +import os +import shutil +import stat +import tarfile +import zipfile + +from pip._internal.exceptions import InstallationError +from pip._internal.utils.filetypes import ( + BZ2_EXTENSIONS, + TAR_EXTENSIONS, + XZ_EXTENSIONS, + ZIP_EXTENSIONS, +) +from pip._internal.utils.misc import ensure_dir +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import Iterable, List, Optional, Text, Union + + +logger = logging.getLogger(__name__) + + +SUPPORTED_EXTENSIONS = ZIP_EXTENSIONS + TAR_EXTENSIONS + +try: + import bz2 # noqa + SUPPORTED_EXTENSIONS += BZ2_EXTENSIONS +except ImportError: + logger.debug('bz2 module is not available') + +try: + # Only for Python 3.3+ + import lzma # noqa + SUPPORTED_EXTENSIONS += XZ_EXTENSIONS +except ImportError: + logger.debug('lzma module is not available') + + +def current_umask(): + """Get the current umask which involves having to set it temporarily.""" + mask = os.umask(0) + os.umask(mask) + return mask + + +def split_leading_dir(path): + # type: (Union[str, Text]) -> List[Union[str, Text]] + path = path.lstrip('/').lstrip('\\') + if ( + '/' in path and ( + ('\\' in path and path.find('/') < path.find('\\')) or + '\\' not in path + ) + ): + return path.split('/', 1) + elif '\\' in path: + return path.split('\\', 1) + else: + return [path, ''] + + +def has_leading_dir(paths): + # type: (Iterable[Union[str, Text]]) -> bool + """Returns true if all the paths have the same leading path name + (i.e., everything is in one subdirectory in an archive)""" + common_prefix = None + for path in paths: + prefix, rest = split_leading_dir(path) + if not prefix: + return False + elif common_prefix is None: + common_prefix = prefix + elif prefix != common_prefix: + return False + return True + + +def is_within_directory(directory, target): + # type: ((Union[str, Text]), (Union[str, Text])) -> bool + """ + Return true if the absolute path of target is within the directory + """ + abs_directory = os.path.abspath(directory) + abs_target = os.path.abspath(target) + + prefix = os.path.commonprefix([abs_directory, abs_target]) + return prefix == abs_directory + + +def unzip_file(filename, location, flatten=True): + # type: (str, str, bool) -> None + """ + Unzip the file (with path `filename`) to the destination `location`. All + files are written based on system defaults and umask (i.e. permissions are + not preserved), except that regular file members with any execute + permissions (user, group, or world) have "chmod +x" applied after being + written. Note that for windows, any execute changes using os.chmod are + no-ops per the python docs. + """ + ensure_dir(location) + zipfp = open(filename, 'rb') + try: + zip = zipfile.ZipFile(zipfp, allowZip64=True) + leading = has_leading_dir(zip.namelist()) and flatten + for info in zip.infolist(): + name = info.filename + fn = name + if leading: + fn = split_leading_dir(name)[1] + fn = os.path.join(location, fn) + dir = os.path.dirname(fn) + if not is_within_directory(location, fn): + message = ( + 'The zip file ({}) has a file ({}) trying to install ' + 'outside target directory ({})' + ) + raise InstallationError(message.format(filename, fn, location)) + if fn.endswith('/') or fn.endswith('\\'): + # A directory + ensure_dir(fn) + else: + ensure_dir(dir) + # Don't use read() to avoid allocating an arbitrarily large + # chunk of memory for the file's content + fp = zip.open(name) + try: + with open(fn, 'wb') as destfp: + shutil.copyfileobj(fp, destfp) + finally: + fp.close() + mode = info.external_attr >> 16 + # if mode and regular file and any execute permissions for + # user/group/world? + if mode and stat.S_ISREG(mode) and mode & 0o111: + # make dest file have execute for user/group/world + # (chmod +x) no-op on windows per python docs + os.chmod(fn, (0o777 - current_umask() | 0o111)) + finally: + zipfp.close() + + +def untar_file(filename, location): + # type: (str, str) -> None + """ + Untar the file (with path `filename`) to the destination `location`. + All files are written based on system defaults and umask (i.e. permissions + are not preserved), except that regular file members with any execute + permissions (user, group, or world) have "chmod +x" applied after being + written. Note that for windows, any execute changes using os.chmod are + no-ops per the python docs. + """ + ensure_dir(location) + if filename.lower().endswith('.gz') or filename.lower().endswith('.tgz'): + mode = 'r:gz' + elif filename.lower().endswith(BZ2_EXTENSIONS): + mode = 'r:bz2' + elif filename.lower().endswith(XZ_EXTENSIONS): + mode = 'r:xz' + elif filename.lower().endswith('.tar'): + mode = 'r' + else: + logger.warning( + 'Cannot determine compression type for file %s', filename, + ) + mode = 'r:*' + tar = tarfile.open(filename, mode) + try: + leading = has_leading_dir([ + member.name for member in tar.getmembers() + ]) + for member in tar.getmembers(): + fn = member.name + if leading: + # https://github.com/python/mypy/issues/1174 + fn = split_leading_dir(fn)[1] # type: ignore + path = os.path.join(location, fn) + if not is_within_directory(location, path): + message = ( + 'The tar file ({}) has a file ({}) trying to install ' + 'outside target directory ({})' + ) + raise InstallationError( + message.format(filename, path, location) + ) + if member.isdir(): + ensure_dir(path) + elif member.issym(): + try: + # https://github.com/python/typeshed/issues/2673 + tar._extract_member(member, path) # type: ignore + except Exception as exc: + # Some corrupt tar files seem to produce this + # (specifically bad symlinks) + logger.warning( + 'In the tar file %s the member %s is invalid: %s', + filename, member.name, exc, + ) + continue + else: + try: + fp = tar.extractfile(member) + except (KeyError, AttributeError) as exc: + # Some corrupt tar files seem to produce this + # (specifically bad symlinks) + logger.warning( + 'In the tar file %s the member %s is invalid: %s', + filename, member.name, exc, + ) + continue + ensure_dir(os.path.dirname(path)) + with open(path, 'wb') as destfp: + shutil.copyfileobj(fp, destfp) + fp.close() + # Update the timestamp (useful for cython compiled files) + # https://github.com/python/typeshed/issues/2673 + tar.utime(member, path) # type: ignore + # member have any execute permissions for user/group/world? + if member.mode & 0o111: + # make dest file have execute for user/group/world + # no-op on windows per python docs + os.chmod(path, (0o777 - current_umask() | 0o111)) + finally: + tar.close() + + +def unpack_file( + filename, # type: str + location, # type: str + content_type=None, # type: Optional[str] +): + # type: (...) -> None + filename = os.path.realpath(filename) + if ( + content_type == 'application/zip' or + filename.lower().endswith(ZIP_EXTENSIONS) or + zipfile.is_zipfile(filename) + ): + unzip_file( + filename, + location, + flatten=not filename.endswith('.whl') + ) + elif ( + content_type == 'application/x-gzip' or + tarfile.is_tarfile(filename) or + filename.lower().endswith( + TAR_EXTENSIONS + BZ2_EXTENSIONS + XZ_EXTENSIONS + ) + ): + untar_file(filename, location) + else: + # FIXME: handle? + # FIXME: magic signatures? + logger.critical( + 'Cannot unpack file %s (downloaded from %s, content-type: %s); ' + 'cannot detect archive format', + filename, location, content_type, + ) + raise InstallationError( + 'Cannot determine archive format of {}'.format(location) + ) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/urls.py b/venv/lib/python3.8/site-packages/pip/_internal/utils/urls.py new file mode 100644 index 000000000..9ad40feb3 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/utils/urls.py @@ -0,0 +1,54 @@ +import os +import sys + +from pip._vendor.six.moves.urllib import parse as urllib_parse +from pip._vendor.six.moves.urllib import request as urllib_request + +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import Optional, Text, Union + + +def get_url_scheme(url): + # type: (Union[str, Text]) -> Optional[Text] + if ':' not in url: + return None + return url.split(':', 1)[0].lower() + + +def path_to_url(path): + # type: (Union[str, Text]) -> str + """ + Convert a path to a file: URL. The path will be made absolute and have + quoted path parts. + """ + path = os.path.normpath(os.path.abspath(path)) + url = urllib_parse.urljoin('file:', urllib_request.pathname2url(path)) + return url + + +def url_to_path(url): + # type: (str) -> str + """ + Convert a file: URL to a path. + """ + assert url.startswith('file:'), ( + "You can only turn file: urls into filenames (not %r)" % url) + + _, netloc, path, _, _ = urllib_parse.urlsplit(url) + + if not netloc or netloc == 'localhost': + # According to RFC 8089, same as empty authority. + netloc = '' + elif sys.platform == 'win32': + # If we have a UNC path, prepend UNC share notation. + netloc = '\\\\' + netloc + else: + raise ValueError( + 'non-local file URIs are not supported on this platform: %r' + % url + ) + + path = urllib_request.url2pathname(netloc + path) + return path diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/virtualenv.py b/venv/lib/python3.8/site-packages/pip/_internal/utils/virtualenv.py new file mode 100644 index 000000000..d81e6ac54 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/utils/virtualenv.py @@ -0,0 +1,115 @@ +from __future__ import absolute_import + +import logging +import os +import re +import site +import sys + +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from typing import List, Optional + +logger = logging.getLogger(__name__) +_INCLUDE_SYSTEM_SITE_PACKAGES_REGEX = re.compile( + r"include-system-site-packages\s*=\s*(?Ptrue|false)" +) + + +def _running_under_venv(): + # type: () -> bool + """Checks if sys.base_prefix and sys.prefix match. + + This handles PEP 405 compliant virtual environments. + """ + return sys.prefix != getattr(sys, "base_prefix", sys.prefix) + + +def _running_under_regular_virtualenv(): + # type: () -> bool + """Checks if sys.real_prefix is set. + + This handles virtual environments created with pypa's virtualenv. + """ + # pypa/virtualenv case + return hasattr(sys, 'real_prefix') + + +def running_under_virtualenv(): + # type: () -> bool + """Return True if we're running inside a virtualenv, False otherwise. + """ + return _running_under_venv() or _running_under_regular_virtualenv() + + +def _get_pyvenv_cfg_lines(): + # type: () -> Optional[List[str]] + """Reads {sys.prefix}/pyvenv.cfg and returns its contents as list of lines + + Returns None, if it could not read/access the file. + """ + pyvenv_cfg_file = os.path.join(sys.prefix, 'pyvenv.cfg') + try: + with open(pyvenv_cfg_file) as f: + return f.read().splitlines() # avoids trailing newlines + except IOError: + return None + + +def _no_global_under_venv(): + # type: () -> bool + """Check `{sys.prefix}/pyvenv.cfg` for system site-packages inclusion + + PEP 405 specifies that when system site-packages are not supposed to be + visible from a virtual environment, `pyvenv.cfg` must contain the following + line: + + include-system-site-packages = false + + Additionally, log a warning if accessing the file fails. + """ + cfg_lines = _get_pyvenv_cfg_lines() + if cfg_lines is None: + # We're not in a "sane" venv, so assume there is no system + # site-packages access (since that's PEP 405's default state). + logger.warning( + "Could not access 'pyvenv.cfg' despite a virtual environment " + "being active. Assuming global site-packages is not accessible " + "in this environment." + ) + return True + + for line in cfg_lines: + match = _INCLUDE_SYSTEM_SITE_PACKAGES_REGEX.match(line) + if match is not None and match.group('value') == 'false': + return True + return False + + +def _no_global_under_regular_virtualenv(): + # type: () -> bool + """Check if "no-global-site-packages.txt" exists beside site.py + + This mirrors logic in pypa/virtualenv for determining whether system + site-packages are visible in the virtual environment. + """ + site_mod_dir = os.path.dirname(os.path.abspath(site.__file__)) + no_global_site_packages_file = os.path.join( + site_mod_dir, 'no-global-site-packages.txt', + ) + return os.path.exists(no_global_site_packages_file) + + +def virtualenv_no_global(): + # type: () -> bool + """Returns a boolean, whether running in venv with no system site-packages. + """ + + if _running_under_regular_virtualenv(): + return _no_global_under_regular_virtualenv() + + if _running_under_venv(): + return _no_global_under_venv() + + return False diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/wheel.py b/venv/lib/python3.8/site-packages/pip/_internal/utils/wheel.py new file mode 100644 index 000000000..837e0afd7 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/utils/wheel.py @@ -0,0 +1,225 @@ +"""Support functions for working with wheel files. +""" + +from __future__ import absolute_import + +import logging +from email.parser import Parser +from zipfile import ZipFile + +from pip._vendor.packaging.utils import canonicalize_name +from pip._vendor.pkg_resources import DistInfoDistribution +from pip._vendor.six import PY2, ensure_str + +from pip._internal.exceptions import UnsupportedWheel +from pip._internal.utils.pkg_resources import DictMetadata +from pip._internal.utils.typing import MYPY_CHECK_RUNNING + +if MYPY_CHECK_RUNNING: + from email.message import Message + from typing import Dict, Tuple + + from pip._vendor.pkg_resources import Distribution + +if PY2: + from zipfile import BadZipfile as BadZipFile +else: + from zipfile import BadZipFile + + +VERSION_COMPATIBLE = (1, 0) + + +logger = logging.getLogger(__name__) + + +class WheelMetadata(DictMetadata): + """Metadata provider that maps metadata decoding exceptions to our + internal exception type. + """ + def __init__(self, metadata, wheel_name): + # type: (Dict[str, bytes], str) -> None + super(WheelMetadata, self).__init__(metadata) + self._wheel_name = wheel_name + + def get_metadata(self, name): + # type: (str) -> str + try: + return super(WheelMetadata, self).get_metadata(name) + except UnicodeDecodeError as e: + # Augment the default error with the origin of the file. + raise UnsupportedWheel( + "Error decoding metadata for {}: {}".format( + self._wheel_name, e + ) + ) + + +def pkg_resources_distribution_for_wheel(wheel_zip, name, location): + # type: (ZipFile, str, str) -> Distribution + """Get a pkg_resources distribution given a wheel. + + :raises UnsupportedWheel: on any errors + """ + info_dir, _ = parse_wheel(wheel_zip, name) + + metadata_files = [ + p for p in wheel_zip.namelist() if p.startswith("{}/".format(info_dir)) + ] + + metadata_text = {} # type: Dict[str, bytes] + for path in metadata_files: + # If a flag is set, namelist entries may be unicode in Python 2. + # We coerce them to native str type to match the types used in the rest + # of the code. This cannot fail because unicode can always be encoded + # with UTF-8. + full_path = ensure_str(path) + _, metadata_name = full_path.split("/", 1) + + try: + metadata_text[metadata_name] = read_wheel_metadata_file( + wheel_zip, full_path + ) + except UnsupportedWheel as e: + raise UnsupportedWheel( + "{} has an invalid wheel, {}".format(name, str(e)) + ) + + metadata = WheelMetadata(metadata_text, location) + + return DistInfoDistribution( + location=location, metadata=metadata, project_name=name + ) + + +def parse_wheel(wheel_zip, name): + # type: (ZipFile, str) -> Tuple[str, Message] + """Extract information from the provided wheel, ensuring it meets basic + standards. + + Returns the name of the .dist-info directory and the parsed WHEEL metadata. + """ + try: + info_dir = wheel_dist_info_dir(wheel_zip, name) + metadata = wheel_metadata(wheel_zip, info_dir) + version = wheel_version(metadata) + except UnsupportedWheel as e: + raise UnsupportedWheel( + "{} has an invalid wheel, {}".format(name, str(e)) + ) + + check_compatibility(version, name) + + return info_dir, metadata + + +def wheel_dist_info_dir(source, name): + # type: (ZipFile, str) -> str + """Returns the name of the contained .dist-info directory. + + Raises AssertionError or UnsupportedWheel if not found, >1 found, or + it doesn't match the provided name. + """ + # Zip file path separators must be / + subdirs = list(set(p.split("/")[0] for p in source.namelist())) + + info_dirs = [s for s in subdirs if s.endswith('.dist-info')] + + if not info_dirs: + raise UnsupportedWheel(".dist-info directory not found") + + if len(info_dirs) > 1: + raise UnsupportedWheel( + "multiple .dist-info directories found: {}".format( + ", ".join(info_dirs) + ) + ) + + info_dir = info_dirs[0] + + info_dir_name = canonicalize_name(info_dir) + canonical_name = canonicalize_name(name) + if not info_dir_name.startswith(canonical_name): + raise UnsupportedWheel( + ".dist-info directory {!r} does not start with {!r}".format( + info_dir, canonical_name + ) + ) + + # Zip file paths can be unicode or str depending on the zip entry flags, + # so normalize it. + return ensure_str(info_dir) + + +def read_wheel_metadata_file(source, path): + # type: (ZipFile, str) -> bytes + try: + return source.read(path) + # BadZipFile for general corruption, KeyError for missing entry, + # and RuntimeError for password-protected files + except (BadZipFile, KeyError, RuntimeError) as e: + raise UnsupportedWheel( + "could not read {!r} file: {!r}".format(path, e) + ) + + +def wheel_metadata(source, dist_info_dir): + # type: (ZipFile, str) -> Message + """Return the WHEEL metadata of an extracted wheel, if possible. + Otherwise, raise UnsupportedWheel. + """ + path = "{}/WHEEL".format(dist_info_dir) + # Zip file path separators must be / + wheel_contents = read_wheel_metadata_file(source, path) + + try: + wheel_text = ensure_str(wheel_contents) + except UnicodeDecodeError as e: + raise UnsupportedWheel("error decoding {!r}: {!r}".format(path, e)) + + # FeedParser (used by Parser) does not raise any exceptions. The returned + # message may have .defects populated, but for backwards-compatibility we + # currently ignore them. + return Parser().parsestr(wheel_text) + + +def wheel_version(wheel_data): + # type: (Message) -> Tuple[int, ...] + """Given WHEEL metadata, return the parsed Wheel-Version. + Otherwise, raise UnsupportedWheel. + """ + version_text = wheel_data["Wheel-Version"] + if version_text is None: + raise UnsupportedWheel("WHEEL is missing Wheel-Version") + + version = version_text.strip() + + try: + return tuple(map(int, version.split('.'))) + except ValueError: + raise UnsupportedWheel("invalid Wheel-Version: {!r}".format(version)) + + +def check_compatibility(version, name): + # type: (Tuple[int, ...], str) -> None + """Raises errors or warns if called with an incompatible Wheel-Version. + + Pip should refuse to install a Wheel-Version that's a major series + ahead of what it's compatible with (e.g 2.0 > 1.1); and warn when + installing a version only minor version ahead (e.g 1.2 > 1.1). + + version: a 2-tuple representing a Wheel-Version (Major, Minor) + name: name of wheel or package to raise exception about + + :raises UnsupportedWheel: when an incompatible Wheel-Version is given + """ + if version[0] > VERSION_COMPATIBLE[0]: + raise UnsupportedWheel( + "%s's Wheel-Version (%s) is not compatible with this version " + "of pip" % (name, '.'.join(map(str, version))) + ) + elif version > VERSION_COMPATIBLE: + logger.warning( + 'Installing from a newer Wheel-Version (%s)', + '.'.join(map(str, version)), + ) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/vcs/__init__.py b/venv/lib/python3.8/site-packages/pip/_internal/vcs/__init__.py new file mode 100644 index 000000000..2a4eb1375 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/vcs/__init__.py @@ -0,0 +1,15 @@ +# Expose a limited set of classes and functions so callers outside of +# the vcs package don't need to import deeper than `pip._internal.vcs`. +# (The test directory and imports protected by MYPY_CHECK_RUNNING may +# still need to import from a vcs sub-package.) +# Import all vcs modules to register each VCS in the VcsSupport object. +import pip._internal.vcs.bazaar +import pip._internal.vcs.git +import pip._internal.vcs.mercurial +import pip._internal.vcs.subversion # noqa: F401 +from pip._internal.vcs.versioncontrol import ( # noqa: F401 + RemoteNotFoundError, + is_url, + make_vcs_requirement_url, + vcs, +) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/vcs/__pycache__/__init__.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/vcs/__pycache__/__init__.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a939282099ab570e53f871654b2848dae13ecc50 GIT binary patch literal 477 zcmZWlJx{|h5Otb1O)GUmNR?n~oLZ~?2xli!`A7VvtW5j` zCN8ByNIA>z`QDR#dVZPBri|)g%0LYm`|O(kMH;)O?Uw{4D-@HxU; ztq=^@aCBl47gI5>RF&n*20$xyMq;*+?^0qLlOxXi_ErUP(U%QiQKOPtT=q?0ZyG?a zoE2An_hc2$26P&`Pr|r^VFx3E4~FCJ+`;!N-#G&uovUQE=Z!C13EYReq-?wa+ig6A}!{{`k0nCH~0kmp%-Xw#)}Wv$^Zp;101NTc8N1EvR# A1ONa4 literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/vcs/__pycache__/bazaar.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/vcs/__pycache__/bazaar.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..73caed47623715ca3c17403060566503ff37208a GIT binary patch literal 3776 zcmZ`+TXWmS6~^L5kRo-rB{{CkHgys@G1)e~WISo6vFb}Et>;1hNc0&SHr6Y zp9B3`xR$Ml>!7z!HpI147QXes;!WOqVeyt&I(EYAV)^6;;`%AcZ2!sX%)i7-O`fPCjSr(D)`QZQnU+F;pqa&cBI@T^77sb*%YS(C z$0yO|!+V>bM_)eP+WKtk0aoYeRHXB0BvUY(|Fe)P$%mWyP|G|mo&CPTa_~i=u^OkP z_h?k4#J=$`;am(KiRYRKJ{{@7XTzPmY+Ul8+rg|C{ki@>k&s|H^JzQ)%LzWj~lTHy**y;1si<8d6z(%Bx%vD*bK{cRZ! z`-4tREUbm!^g;7w|P2V3f=0NT=Q zVjbI0?FpOM|A6haqg@Ww96Ry@?LPHRd~WYD;}sS}b+*dZNC_3~$apssLmk>_(W#Z5 z8WlpyMer2ESoTJnry>M;5KrFsC?K?z&D)IRU+Lf-B|9b(%(Cv z_qVL9M^QhGm5QQot?!=n26-lWGS7>+*z4`9e$GWt=@Fbj_x8nbzX$fc;!qFr;fLLi zdMeT4b`kgY;$5M7MN;%2lNJ(Q)Pq;`wvE2K#i6_cVcy12K7hrRohBPEROaZ;E^PM_H8L|U=2R%NU?A53j7eOXYGS4;iqAVZMJCh_;@x6BzK6$yM!4*fGpFu}<8HeagPFkL)97Vm@7v ziE~mrwT@kGbLa0ig58DW-uQ8&J$>#yrzmghfoNCqw52F=C^VOc?YP>2IomonG+Zd1 z3}cGWcAEDMa>k3SOx*56A9HGuA4E#?e1selly(n}OHM9@i+7q|Z{;7*FGWrFDcWPmW9eYO}Y~oM6 zvruxk#%r4c(cepkyKU&CeN)|3q}7{BE`$Ad_U&h#TG+rvr%AT-(|mVV$kI)a>?8?i zlp)_E>|KD4UunZ7t4Q)K`945s)G^}{^fPXBcS$j2eMjj2AR3B;-{6p11+eS@s%L#G+yRa~%l04{3%pbPP>!+j!kHnfU4;!8Z}_PXB;+Y;y~9 zsi|RQ4;)_KV>wI!o78w14FsF%#YF#NibE@8LFV%{rRK`Ho`}_Si>-xYO&6U8)FBE7`Tm)T`%X z4TU<2QAo>%(y`Q}!9mA`T~bx)zm0Qc9ob(Zk1Hjw6CX-;l5(5;6~H45lM^lXDr>NS zjo&(#(`HdU`_hHWQdFOrM`J>6!`UvGh)m)f*%O;g^*ih9M@VVTiH+cMxQqE+7|%Iz zCN7k43z$n7_ckmObRGqr{HsRr9W&cv$leUbop`VDXSbeR<79AuOHyjM|E(?G##{aZ zpkt3$`xK}Yr1?&}D$IA<;{}v6)St73msA>1uqhIu#Uf2~nhb?Pb<{E`8-)$VU0!n##heSBODEA)_VhxvVZ2h=ZL;h9D9$5=qf zyuMHX%7mJ{%eQD&x2QJva7;A;EZb!+3}(Obo$<;A*(=HmrI92j8*E~j2;&U$+2eOU zO%LKj)rQxOGGWTre${HKHqVFe>UI_*3*9#|&BUd|Q@X=A6PHC@hUuuaMURv4NIVQ{eTWF1^2 z{aq~mDc?C-A$OK70@Qa%>cPu8oc{Nwrpt%4c$+}gL`$)YrU*T?$*`}1=_7-WE7$pi cN`#`#CJJ?6H&IcV=C_EzA$-wkIE#PzAK{3mEdT%j literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/vcs/__pycache__/git.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/vcs/__pycache__/git.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..09331a523ab4a6a1a5b4d17a3e1071b7ed002ff6 GIT binary patch literal 9588 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 literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/vcs/__pycache__/mercurial.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/vcs/__pycache__/mercurial.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1873808ddfea77e5aec793d724e695a783a44206 GIT binary patch literal 4917 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 literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/vcs/__pycache__/subversion.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/vcs/__pycache__/subversion.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..358dbd3d19939c779444b729b21bae47a09ef7ed GIT binary patch literal 8516 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 literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/vcs/__pycache__/versioncontrol.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/vcs/__pycache__/versioncontrol.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..cd936ad7d88935422bebbf2b52a2bc43ca908770 GIT binary patch literal 19245 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 None + """ + Export the Bazaar repository at the url to the destination location + """ + # Remove the location to make sure Bazaar can export it correctly + if os.path.exists(location): + rmtree(location) + + url, rev_options = self.get_url_rev_options(url) + self.run_command( + make_command('export', location, url, rev_options.to_args()), + show_stdout=False, + ) + + def fetch_new(self, dest, url, rev_options): + # type: (str, HiddenText, RevOptions) -> None + rev_display = rev_options.to_display() + logger.info( + 'Checking out %s%s to %s', + url, + rev_display, + display_path(dest), + ) + cmd_args = ( + make_command('branch', '-q', rev_options.to_args(), url, dest) + ) + self.run_command(cmd_args) + + def switch(self, dest, url, rev_options): + # type: (str, HiddenText, RevOptions) -> None + self.run_command(make_command('switch', url), cwd=dest) + + def update(self, dest, url, rev_options): + # type: (str, HiddenText, RevOptions) -> None + cmd_args = make_command('pull', '-q', rev_options.to_args()) + self.run_command(cmd_args, cwd=dest) + + @classmethod + def get_url_rev_and_auth(cls, url): + # type: (str) -> Tuple[str, Optional[str], AuthInfo] + # hotfix the URL scheme after removing bzr+ from bzr+ssh:// readd it + url, rev, user_pass = super(Bazaar, cls).get_url_rev_and_auth(url) + if url.startswith('ssh://'): + url = 'bzr+' + url + return url, rev, user_pass + + @classmethod + def get_remote_url(cls, location): + urls = cls.run_command(['info'], show_stdout=False, cwd=location) + for line in urls.splitlines(): + line = line.strip() + for x in ('checkout of branch: ', + 'parent branch: '): + if line.startswith(x): + repo = line.split(x)[1] + if cls._is_local_repository(repo): + return path_to_url(repo) + return repo + return None + + @classmethod + def get_revision(cls, location): + revision = cls.run_command( + ['revno'], show_stdout=False, cwd=location, + ) + return revision.splitlines()[-1] + + @classmethod + def is_commit_id_equal(cls, dest, name): + """Always assume the versions don't match""" + return False + + +vcs.register(Bazaar) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/vcs/git.py b/venv/lib/python3.8/site-packages/pip/_internal/vcs/git.py new file mode 100644 index 000000000..d706064e7 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/vcs/git.py @@ -0,0 +1,395 @@ +# The following comment should be removed at some point in the future. +# mypy: disallow-untyped-defs=False + +from __future__ import absolute_import + +import logging +import os.path +import re + +from pip._vendor.packaging.version import parse as parse_version +from pip._vendor.six.moves.urllib import parse as urllib_parse +from pip._vendor.six.moves.urllib import request as urllib_request + +from pip._internal.exceptions import BadCommand +from pip._internal.utils.misc import display_path, hide_url +from pip._internal.utils.subprocess import make_command +from pip._internal.utils.temp_dir import TempDirectory +from pip._internal.utils.typing import MYPY_CHECK_RUNNING +from pip._internal.vcs.versioncontrol import ( + RemoteNotFoundError, + VersionControl, + find_path_to_setup_from_repo_root, + vcs, +) + +if MYPY_CHECK_RUNNING: + from typing import Optional, Tuple + from pip._internal.utils.misc import HiddenText + from pip._internal.vcs.versioncontrol import AuthInfo, RevOptions + + +urlsplit = urllib_parse.urlsplit +urlunsplit = urllib_parse.urlunsplit + + +logger = logging.getLogger(__name__) + + +HASH_REGEX = re.compile('^[a-fA-F0-9]{40}$') + + +def looks_like_hash(sha): + return bool(HASH_REGEX.match(sha)) + + +class Git(VersionControl): + name = 'git' + dirname = '.git' + repo_name = 'clone' + schemes = ( + 'git', 'git+http', 'git+https', 'git+ssh', 'git+git', 'git+file', + ) + # Prevent the user's environment variables from interfering with pip: + # https://github.com/pypa/pip/issues/1130 + unset_environ = ('GIT_DIR', 'GIT_WORK_TREE') + default_arg_rev = 'HEAD' + + @staticmethod + def get_base_rev_args(rev): + return [rev] + + def is_immutable_rev_checkout(self, url, dest): + # type: (str, str) -> bool + _, rev_options = self.get_url_rev_options(hide_url(url)) + if not rev_options.rev: + return False + if not self.is_commit_id_equal(dest, rev_options.rev): + # the current commit is different from rev, + # which means rev was something else than a commit hash + return False + # return False in the rare case rev is both a commit hash + # and a tag or a branch; we don't want to cache in that case + # because that branch/tag could point to something else in the future + is_tag_or_branch = bool( + self.get_revision_sha(dest, rev_options.rev)[0] + ) + return not is_tag_or_branch + + def get_git_version(self): + VERSION_PFX = 'git version ' + version = self.run_command(['version'], show_stdout=False) + if version.startswith(VERSION_PFX): + version = version[len(VERSION_PFX):].split()[0] + else: + version = '' + # get first 3 positions of the git version because + # on windows it is x.y.z.windows.t, and this parses as + # LegacyVersion which always smaller than a Version. + version = '.'.join(version.split('.')[:3]) + return parse_version(version) + + @classmethod + def get_current_branch(cls, location): + """ + Return the current branch, or None if HEAD isn't at a branch + (e.g. detached HEAD). + """ + # git-symbolic-ref exits with empty stdout if "HEAD" is a detached + # HEAD rather than a symbolic ref. In addition, the -q causes the + # command to exit with status code 1 instead of 128 in this case + # and to suppress the message to stderr. + args = ['symbolic-ref', '-q', 'HEAD'] + output = cls.run_command( + args, extra_ok_returncodes=(1, ), show_stdout=False, cwd=location, + ) + ref = output.strip() + + if ref.startswith('refs/heads/'): + return ref[len('refs/heads/'):] + + return None + + def export(self, location, url): + # type: (str, HiddenText) -> None + """Export the Git repository at the url to the destination location""" + if not location.endswith('/'): + location = location + '/' + + with TempDirectory(kind="export") as temp_dir: + self.unpack(temp_dir.path, url=url) + self.run_command( + ['checkout-index', '-a', '-f', '--prefix', location], + show_stdout=False, cwd=temp_dir.path + ) + + @classmethod + def get_revision_sha(cls, dest, rev): + """ + Return (sha_or_none, is_branch), where sha_or_none is a commit hash + if the revision names a remote branch or tag, otherwise None. + + Args: + dest: the repository directory. + rev: the revision name. + """ + # Pass rev to pre-filter the list. + output = cls.run_command(['show-ref', rev], cwd=dest, + show_stdout=False, on_returncode='ignore') + refs = {} + # NOTE: We do not use splitlines here since that would split on other + # unicode separators, which can be maliciously used to install a + # different revision. + for line in output.strip().split("\n"): + line = line.rstrip("\r") + if not line: + continue + try: + sha, ref = line.split(" ", maxsplit=2) + except ValueError: + # Include the offending line to simplify troubleshooting if + # this error ever occurs. + raise ValueError('unexpected show-ref line: {!r}'.format(line)) + + refs[ref] = sha + + branch_ref = 'refs/remotes/origin/{}'.format(rev) + tag_ref = 'refs/tags/{}'.format(rev) + + sha = refs.get(branch_ref) + if sha is not None: + return (sha, True) + + sha = refs.get(tag_ref) + + return (sha, False) + + @classmethod + def resolve_revision(cls, dest, url, rev_options): + # type: (str, HiddenText, RevOptions) -> RevOptions + """ + Resolve a revision to a new RevOptions object with the SHA1 of the + branch, tag, or ref if found. + + Args: + rev_options: a RevOptions object. + """ + rev = rev_options.arg_rev + # The arg_rev property's implementation for Git ensures that the + # rev return value is always non-None. + assert rev is not None + + sha, is_branch = cls.get_revision_sha(dest, rev) + + if sha is not None: + rev_options = rev_options.make_new(sha) + rev_options.branch_name = rev if is_branch else None + + return rev_options + + # Do not show a warning for the common case of something that has + # the form of a Git commit hash. + if not looks_like_hash(rev): + logger.warning( + "Did not find branch or tag '%s', assuming revision or ref.", + rev, + ) + + if not rev.startswith('refs/'): + return rev_options + + # If it looks like a ref, we have to fetch it explicitly. + cls.run_command( + make_command('fetch', '-q', url, rev_options.to_args()), + cwd=dest, + ) + # Change the revision to the SHA of the ref we fetched + sha = cls.get_revision(dest, rev='FETCH_HEAD') + rev_options = rev_options.make_new(sha) + + return rev_options + + @classmethod + def is_commit_id_equal(cls, dest, name): + """ + Return whether the current commit hash equals the given name. + + Args: + dest: the repository directory. + name: a string name. + """ + if not name: + # Then avoid an unnecessary subprocess call. + return False + + return cls.get_revision(dest) == name + + def fetch_new(self, dest, url, rev_options): + # type: (str, HiddenText, RevOptions) -> None + rev_display = rev_options.to_display() + logger.info('Cloning %s%s to %s', url, rev_display, display_path(dest)) + self.run_command(make_command('clone', '-q', url, dest)) + + if rev_options.rev: + # Then a specific revision was requested. + rev_options = self.resolve_revision(dest, url, rev_options) + branch_name = getattr(rev_options, 'branch_name', None) + if branch_name is None: + # Only do a checkout if the current commit id doesn't match + # the requested revision. + if not self.is_commit_id_equal(dest, rev_options.rev): + cmd_args = make_command( + 'checkout', '-q', rev_options.to_args(), + ) + self.run_command(cmd_args, cwd=dest) + elif self.get_current_branch(dest) != branch_name: + # Then a specific branch was requested, and that branch + # is not yet checked out. + track_branch = 'origin/{}'.format(branch_name) + cmd_args = [ + 'checkout', '-b', branch_name, '--track', track_branch, + ] + self.run_command(cmd_args, cwd=dest) + + #: repo may contain submodules + self.update_submodules(dest) + + def switch(self, dest, url, rev_options): + # type: (str, HiddenText, RevOptions) -> None + self.run_command( + make_command('config', 'remote.origin.url', url), + cwd=dest, + ) + cmd_args = make_command('checkout', '-q', rev_options.to_args()) + self.run_command(cmd_args, cwd=dest) + + self.update_submodules(dest) + + def update(self, dest, url, rev_options): + # type: (str, HiddenText, RevOptions) -> None + # First fetch changes from the default remote + if self.get_git_version() >= parse_version('1.9.0'): + # fetch tags in addition to everything else + self.run_command(['fetch', '-q', '--tags'], cwd=dest) + else: + self.run_command(['fetch', '-q'], cwd=dest) + # Then reset to wanted revision (maybe even origin/master) + rev_options = self.resolve_revision(dest, url, rev_options) + cmd_args = make_command('reset', '--hard', '-q', rev_options.to_args()) + self.run_command(cmd_args, cwd=dest) + #: update submodules + self.update_submodules(dest) + + @classmethod + def get_remote_url(cls, location): + """ + Return URL of the first remote encountered. + + Raises RemoteNotFoundError if the repository does not have a remote + url configured. + """ + # We need to pass 1 for extra_ok_returncodes since the command + # exits with return code 1 if there are no matching lines. + stdout = cls.run_command( + ['config', '--get-regexp', r'remote\..*\.url'], + extra_ok_returncodes=(1, ), show_stdout=False, cwd=location, + ) + remotes = stdout.splitlines() + try: + found_remote = remotes[0] + except IndexError: + raise RemoteNotFoundError + + for remote in remotes: + if remote.startswith('remote.origin.url '): + found_remote = remote + break + url = found_remote.split(' ')[1] + return url.strip() + + @classmethod + def get_revision(cls, location, rev=None): + if rev is None: + rev = 'HEAD' + current_rev = cls.run_command( + ['rev-parse', rev], show_stdout=False, cwd=location, + ) + return current_rev.strip() + + @classmethod + def get_subdirectory(cls, location): + """ + Return the path to setup.py, relative to the repo root. + Return None if setup.py is in the repo root. + """ + # find the repo root + git_dir = cls.run_command( + ['rev-parse', '--git-dir'], + show_stdout=False, cwd=location).strip() + if not os.path.isabs(git_dir): + git_dir = os.path.join(location, git_dir) + repo_root = os.path.abspath(os.path.join(git_dir, '..')) + return find_path_to_setup_from_repo_root(location, repo_root) + + @classmethod + def get_url_rev_and_auth(cls, url): + # type: (str) -> Tuple[str, Optional[str], AuthInfo] + """ + Prefixes stub URLs like 'user@hostname:user/repo.git' with 'ssh://'. + That's required because although they use SSH they sometimes don't + work with a ssh:// scheme (e.g. GitHub). But we need a scheme for + parsing. Hence we remove it again afterwards and return it as a stub. + """ + # Works around an apparent Git bug + # (see https://article.gmane.org/gmane.comp.version-control.git/146500) + scheme, netloc, path, query, fragment = urlsplit(url) + if scheme.endswith('file'): + initial_slashes = path[:-len(path.lstrip('/'))] + newpath = ( + initial_slashes + + urllib_request.url2pathname(path) + .replace('\\', '/').lstrip('/') + ) + url = urlunsplit((scheme, netloc, newpath, query, fragment)) + after_plus = scheme.find('+') + 1 + url = scheme[:after_plus] + urlunsplit( + (scheme[after_plus:], netloc, newpath, query, fragment), + ) + + if '://' not in url: + assert 'file:' not in url + url = url.replace('git+', 'git+ssh://') + url, rev, user_pass = super(Git, cls).get_url_rev_and_auth(url) + url = url.replace('ssh://', '') + else: + url, rev, user_pass = super(Git, cls).get_url_rev_and_auth(url) + + return url, rev, user_pass + + @classmethod + def update_submodules(cls, location): + if not os.path.exists(os.path.join(location, '.gitmodules')): + return + cls.run_command( + ['submodule', 'update', '--init', '--recursive', '-q'], + cwd=location, + ) + + @classmethod + def controls_location(cls, location): + if super(Git, cls).controls_location(location): + return True + try: + r = cls.run_command(['rev-parse'], + cwd=location, + show_stdout=False, + on_returncode='ignore', + log_failed_cmd=False) + return not r + except BadCommand: + logger.debug("could not determine if %s is under git control " + "because git is not available", location) + return False + + +vcs.register(Git) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/vcs/mercurial.py b/venv/lib/python3.8/site-packages/pip/_internal/vcs/mercurial.py new file mode 100644 index 000000000..d9b58cfe9 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/vcs/mercurial.py @@ -0,0 +1,155 @@ +# The following comment should be removed at some point in the future. +# mypy: disallow-untyped-defs=False + +from __future__ import absolute_import + +import logging +import os + +from pip._vendor.six.moves import configparser + +from pip._internal.exceptions import BadCommand, InstallationError +from pip._internal.utils.misc import display_path +from pip._internal.utils.subprocess import make_command +from pip._internal.utils.temp_dir import TempDirectory +from pip._internal.utils.typing import MYPY_CHECK_RUNNING +from pip._internal.utils.urls import path_to_url +from pip._internal.vcs.versioncontrol import ( + VersionControl, + find_path_to_setup_from_repo_root, + vcs, +) + +if MYPY_CHECK_RUNNING: + from pip._internal.utils.misc import HiddenText + from pip._internal.vcs.versioncontrol import RevOptions + + +logger = logging.getLogger(__name__) + + +class Mercurial(VersionControl): + name = 'hg' + dirname = '.hg' + repo_name = 'clone' + schemes = ( + 'hg', 'hg+file', 'hg+http', 'hg+https', 'hg+ssh', 'hg+static-http', + ) + + @staticmethod + def get_base_rev_args(rev): + return [rev] + + def export(self, location, url): + # type: (str, HiddenText) -> None + """Export the Hg repository at the url to the destination location""" + with TempDirectory(kind="export") as temp_dir: + self.unpack(temp_dir.path, url=url) + + self.run_command( + ['archive', location], show_stdout=False, cwd=temp_dir.path + ) + + def fetch_new(self, dest, url, rev_options): + # type: (str, HiddenText, RevOptions) -> None + rev_display = rev_options.to_display() + logger.info( + 'Cloning hg %s%s to %s', + url, + rev_display, + display_path(dest), + ) + self.run_command(make_command('clone', '--noupdate', '-q', url, dest)) + self.run_command( + make_command('update', '-q', rev_options.to_args()), + cwd=dest, + ) + + def switch(self, dest, url, rev_options): + # type: (str, HiddenText, RevOptions) -> None + repo_config = os.path.join(dest, self.dirname, 'hgrc') + config = configparser.RawConfigParser() + try: + config.read(repo_config) + config.set('paths', 'default', url.secret) + with open(repo_config, 'w') as config_file: + config.write(config_file) + except (OSError, configparser.NoSectionError) as exc: + logger.warning( + 'Could not switch Mercurial repository to %s: %s', url, exc, + ) + else: + cmd_args = make_command('update', '-q', rev_options.to_args()) + self.run_command(cmd_args, cwd=dest) + + def update(self, dest, url, rev_options): + # type: (str, HiddenText, RevOptions) -> None + self.run_command(['pull', '-q'], cwd=dest) + cmd_args = make_command('update', '-q', rev_options.to_args()) + self.run_command(cmd_args, cwd=dest) + + @classmethod + def get_remote_url(cls, location): + url = cls.run_command( + ['showconfig', 'paths.default'], + show_stdout=False, cwd=location).strip() + if cls._is_local_repository(url): + url = path_to_url(url) + return url.strip() + + @classmethod + def get_revision(cls, location): + """ + Return the repository-local changeset revision number, as an integer. + """ + current_revision = cls.run_command( + ['parents', '--template={rev}'], + show_stdout=False, cwd=location).strip() + return current_revision + + @classmethod + def get_requirement_revision(cls, location): + """ + Return the changeset identification hash, as a 40-character + hexadecimal string + """ + current_rev_hash = cls.run_command( + ['parents', '--template={node}'], + show_stdout=False, cwd=location).strip() + return current_rev_hash + + @classmethod + def is_commit_id_equal(cls, dest, name): + """Always assume the versions don't match""" + return False + + @classmethod + def get_subdirectory(cls, location): + """ + Return the path to setup.py, relative to the repo root. + Return None if setup.py is in the repo root. + """ + # find the repo root + repo_root = cls.run_command( + ['root'], show_stdout=False, cwd=location).strip() + if not os.path.isabs(repo_root): + repo_root = os.path.abspath(os.path.join(location, repo_root)) + return find_path_to_setup_from_repo_root(location, repo_root) + + @classmethod + def controls_location(cls, location): + if super(Mercurial, cls).controls_location(location): + return True + try: + cls.run_command( + ['identify'], + cwd=location, + show_stdout=False, + on_returncode='raise', + log_failed_cmd=False) + return True + except (BadCommand, InstallationError): + return False + + +vcs.register(Mercurial) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/vcs/subversion.py b/venv/lib/python3.8/site-packages/pip/_internal/vcs/subversion.py new file mode 100644 index 000000000..6c76d1ad4 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/vcs/subversion.py @@ -0,0 +1,333 @@ +# The following comment should be removed at some point in the future. +# mypy: disallow-untyped-defs=False + +from __future__ import absolute_import + +import logging +import os +import re + +from pip._internal.utils.logging import indent_log +from pip._internal.utils.misc import ( + display_path, + is_console_interactive, + rmtree, + split_auth_from_netloc, +) +from pip._internal.utils.subprocess import make_command +from pip._internal.utils.typing import MYPY_CHECK_RUNNING +from pip._internal.vcs.versioncontrol import VersionControl, vcs + +_svn_xml_url_re = re.compile('url="([^"]+)"') +_svn_rev_re = re.compile(r'committed-rev="(\d+)"') +_svn_info_xml_rev_re = re.compile(r'\s*revision="(\d+)"') +_svn_info_xml_url_re = re.compile(r'(.*)') + + +if MYPY_CHECK_RUNNING: + from typing import Optional, Tuple + from pip._internal.utils.subprocess import CommandArgs + from pip._internal.utils.misc import HiddenText + from pip._internal.vcs.versioncontrol import AuthInfo, RevOptions + + +logger = logging.getLogger(__name__) + + +class Subversion(VersionControl): + name = 'svn' + dirname = '.svn' + repo_name = 'checkout' + schemes = ('svn', 'svn+ssh', 'svn+http', 'svn+https', 'svn+svn') + + @classmethod + def should_add_vcs_url_prefix(cls, remote_url): + return True + + @staticmethod + def get_base_rev_args(rev): + return ['-r', rev] + + @classmethod + def get_revision(cls, location): + """ + Return the maximum revision for all files under a given location + """ + # Note: taken from setuptools.command.egg_info + revision = 0 + + for base, dirs, files in os.walk(location): + if cls.dirname not in dirs: + dirs[:] = [] + continue # no sense walking uncontrolled subdirs + dirs.remove(cls.dirname) + entries_fn = os.path.join(base, cls.dirname, 'entries') + if not os.path.exists(entries_fn): + # FIXME: should we warn? + continue + + dirurl, localrev = cls._get_svn_url_rev(base) + + if base == location: + base = dirurl + '/' # save the root url + elif not dirurl or not dirurl.startswith(base): + dirs[:] = [] + continue # not part of the same svn tree, skip it + revision = max(revision, localrev) + return revision + + @classmethod + def get_netloc_and_auth(cls, netloc, scheme): + """ + This override allows the auth information to be passed to svn via the + --username and --password options instead of via the URL. + """ + if scheme == 'ssh': + # The --username and --password options can't be used for + # svn+ssh URLs, so keep the auth information in the URL. + return super(Subversion, cls).get_netloc_and_auth(netloc, scheme) + + return split_auth_from_netloc(netloc) + + @classmethod + def get_url_rev_and_auth(cls, url): + # type: (str) -> Tuple[str, Optional[str], AuthInfo] + # hotfix the URL scheme after removing svn+ from svn+ssh:// readd it + url, rev, user_pass = super(Subversion, cls).get_url_rev_and_auth(url) + if url.startswith('ssh://'): + url = 'svn+' + url + return url, rev, user_pass + + @staticmethod + def make_rev_args(username, password): + # type: (Optional[str], Optional[HiddenText]) -> CommandArgs + extra_args = [] # type: CommandArgs + if username: + extra_args += ['--username', username] + if password: + extra_args += ['--password', password] + + return extra_args + + @classmethod + def get_remote_url(cls, location): + # In cases where the source is in a subdirectory, not alongside + # setup.py we have to look up in the location until we find a real + # setup.py + orig_location = location + while not os.path.exists(os.path.join(location, 'setup.py')): + last_location = location + location = os.path.dirname(location) + if location == last_location: + # We've traversed up to the root of the filesystem without + # finding setup.py + logger.warning( + "Could not find setup.py for directory %s (tried all " + "parent directories)", + orig_location, + ) + return None + + return cls._get_svn_url_rev(location)[0] + + @classmethod + def _get_svn_url_rev(cls, location): + from pip._internal.exceptions import InstallationError + + entries_path = os.path.join(location, cls.dirname, 'entries') + if os.path.exists(entries_path): + with open(entries_path) as f: + data = f.read() + else: # subversion >= 1.7 does not have the 'entries' file + data = '' + + if (data.startswith('8') or + data.startswith('9') or + data.startswith('10')): + data = list(map(str.splitlines, data.split('\n\x0c\n'))) + del data[0][0] # get rid of the '8' + url = data[0][3] + revs = [int(d[9]) for d in data if len(d) > 9 and d[9]] + [0] + elif data.startswith('= 1.7 + # Note that using get_remote_call_options is not necessary here + # because `svn info` is being run against a local directory. + # We don't need to worry about making sure interactive mode + # is being used to prompt for passwords, because passwords + # are only potentially needed for remote server requests. + xml = cls.run_command( + ['info', '--xml', location], + show_stdout=False, + ) + url = _svn_info_xml_url_re.search(xml).group(1) + revs = [ + int(m.group(1)) for m in _svn_info_xml_rev_re.finditer(xml) + ] + except InstallationError: + url, revs = None, [] + + if revs: + rev = max(revs) + else: + rev = 0 + + return url, rev + + @classmethod + def is_commit_id_equal(cls, dest, name): + """Always assume the versions don't match""" + return False + + def __init__(self, use_interactive=None): + # type: (bool) -> None + if use_interactive is None: + use_interactive = is_console_interactive() + self.use_interactive = use_interactive + + # This member is used to cache the fetched version of the current + # ``svn`` client. + # Special value definitions: + # None: Not evaluated yet. + # Empty tuple: Could not parse version. + self._vcs_version = None # type: Optional[Tuple[int, ...]] + + super(Subversion, self).__init__() + + def call_vcs_version(self): + # type: () -> Tuple[int, ...] + """Query the version of the currently installed Subversion client. + + :return: A tuple containing the parts of the version information or + ``()`` if the version returned from ``svn`` could not be parsed. + :raises: BadCommand: If ``svn`` is not installed. + """ + # Example versions: + # svn, version 1.10.3 (r1842928) + # compiled Feb 25 2019, 14:20:39 on x86_64-apple-darwin17.0.0 + # svn, version 1.7.14 (r1542130) + # compiled Mar 28 2018, 08:49:13 on x86_64-pc-linux-gnu + version_prefix = 'svn, version ' + version = self.run_command(['--version'], show_stdout=False) + if not version.startswith(version_prefix): + return () + + version = version[len(version_prefix):].split()[0] + version_list = version.split('.') + try: + parsed_version = tuple(map(int, version_list)) + except ValueError: + return () + + return parsed_version + + def get_vcs_version(self): + # type: () -> Tuple[int, ...] + """Return the version of the currently installed Subversion client. + + If the version of the Subversion client has already been queried, + a cached value will be used. + + :return: A tuple containing the parts of the version information or + ``()`` if the version returned from ``svn`` could not be parsed. + :raises: BadCommand: If ``svn`` is not installed. + """ + if self._vcs_version is not None: + # Use cached version, if available. + # If parsing the version failed previously (empty tuple), + # do not attempt to parse it again. + return self._vcs_version + + vcs_version = self.call_vcs_version() + self._vcs_version = vcs_version + return vcs_version + + def get_remote_call_options(self): + # type: () -> CommandArgs + """Return options to be used on calls to Subversion that contact the server. + + These options are applicable for the following ``svn`` subcommands used + in this class. + + - checkout + - export + - switch + - update + + :return: A list of command line arguments to pass to ``svn``. + """ + if not self.use_interactive: + # --non-interactive switch is available since Subversion 0.14.4. + # Subversion < 1.8 runs in interactive mode by default. + return ['--non-interactive'] + + svn_version = self.get_vcs_version() + # By default, Subversion >= 1.8 runs in non-interactive mode if + # stdin is not a TTY. Since that is how pip invokes SVN, in + # call_subprocess(), pip must pass --force-interactive to ensure + # the user can be prompted for a password, if required. + # SVN added the --force-interactive option in SVN 1.8. Since + # e.g. RHEL/CentOS 7, which is supported until 2024, ships with + # SVN 1.7, pip should continue to support SVN 1.7. Therefore, pip + # can't safely add the option if the SVN version is < 1.8 (or unknown). + if svn_version >= (1, 8): + return ['--force-interactive'] + + return [] + + def export(self, location, url): + # type: (str, HiddenText) -> None + """Export the svn repository at the url to the destination location""" + url, rev_options = self.get_url_rev_options(url) + + logger.info('Exporting svn repository %s to %s', url, location) + with indent_log(): + if os.path.exists(location): + # Subversion doesn't like to check out over an existing + # directory --force fixes this, but was only added in svn 1.5 + rmtree(location) + cmd_args = make_command( + 'export', self.get_remote_call_options(), + rev_options.to_args(), url, location, + ) + self.run_command(cmd_args, show_stdout=False) + + def fetch_new(self, dest, url, rev_options): + # type: (str, HiddenText, RevOptions) -> None + rev_display = rev_options.to_display() + logger.info( + 'Checking out %s%s to %s', + url, + rev_display, + display_path(dest), + ) + cmd_args = make_command( + 'checkout', '-q', self.get_remote_call_options(), + rev_options.to_args(), url, dest, + ) + self.run_command(cmd_args) + + def switch(self, dest, url, rev_options): + # type: (str, HiddenText, RevOptions) -> None + cmd_args = make_command( + 'switch', self.get_remote_call_options(), rev_options.to_args(), + url, dest, + ) + self.run_command(cmd_args) + + def update(self, dest, url, rev_options): + # type: (str, HiddenText, RevOptions) -> None + cmd_args = make_command( + 'update', self.get_remote_call_options(), rev_options.to_args(), + dest, + ) + self.run_command(cmd_args) + + +vcs.register(Subversion) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/vcs/versioncontrol.py b/venv/lib/python3.8/site-packages/pip/_internal/vcs/versioncontrol.py new file mode 100644 index 000000000..7cfd56882 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/vcs/versioncontrol.py @@ -0,0 +1,700 @@ +"""Handles all VCS (version control) support""" + +from __future__ import absolute_import + +import errno +import logging +import os +import shutil +import sys + +from pip._vendor import pkg_resources +from pip._vendor.six.moves.urllib import parse as urllib_parse + +from pip._internal.exceptions import BadCommand +from pip._internal.utils.compat import samefile +from pip._internal.utils.misc import ( + ask_path_exists, + backup_dir, + display_path, + hide_url, + hide_value, + rmtree, +) +from pip._internal.utils.subprocess import call_subprocess, make_command +from pip._internal.utils.typing import MYPY_CHECK_RUNNING +from pip._internal.utils.urls import get_url_scheme + +if MYPY_CHECK_RUNNING: + from typing import ( + Any, Dict, Iterable, Iterator, List, Mapping, Optional, Text, Tuple, + Type, Union + ) + from pip._internal.utils.ui import SpinnerInterface + from pip._internal.utils.misc import HiddenText + from pip._internal.utils.subprocess import CommandArgs + + AuthInfo = Tuple[Optional[str], Optional[str]] + + +__all__ = ['vcs'] + + +logger = logging.getLogger(__name__) + + +def is_url(name): + # type: (Union[str, Text]) -> bool + """ + Return true if the name looks like a URL. + """ + scheme = get_url_scheme(name) + if scheme is None: + return False + return scheme in ['http', 'https', 'file', 'ftp'] + vcs.all_schemes + + +def make_vcs_requirement_url(repo_url, rev, project_name, subdir=None): + # type: (str, str, str, Optional[str]) -> str + """ + Return the URL for a VCS requirement. + + Args: + repo_url: the remote VCS url, with any needed VCS prefix (e.g. "git+"). + project_name: the (unescaped) project name. + """ + egg_project_name = pkg_resources.to_filename(project_name) + req = '{}@{}#egg={}'.format(repo_url, rev, egg_project_name) + if subdir: + req += '&subdirectory={}'.format(subdir) + + return req + + +def find_path_to_setup_from_repo_root(location, repo_root): + # type: (str, str) -> Optional[str] + """ + Find the path to `setup.py` by searching up the filesystem from `location`. + Return the path to `setup.py` relative to `repo_root`. + Return None if `setup.py` is in `repo_root` or cannot be found. + """ + # find setup.py + orig_location = location + while not os.path.exists(os.path.join(location, 'setup.py')): + last_location = location + location = os.path.dirname(location) + if location == last_location: + # We've traversed up to the root of the filesystem without + # finding setup.py + logger.warning( + "Could not find setup.py for directory %s (tried all " + "parent directories)", + orig_location, + ) + return None + + if samefile(repo_root, location): + return None + + return os.path.relpath(location, repo_root) + + +class RemoteNotFoundError(Exception): + pass + + +class RevOptions(object): + + """ + Encapsulates a VCS-specific revision to install, along with any VCS + install options. + + Instances of this class should be treated as if immutable. + """ + + def __init__( + self, + vc_class, # type: Type[VersionControl] + rev=None, # type: Optional[str] + extra_args=None, # type: Optional[CommandArgs] + ): + # type: (...) -> None + """ + Args: + vc_class: a VersionControl subclass. + rev: the name of the revision to install. + extra_args: a list of extra options. + """ + if extra_args is None: + extra_args = [] + + self.extra_args = extra_args + self.rev = rev + self.vc_class = vc_class + self.branch_name = None # type: Optional[str] + + def __repr__(self): + # type: () -> str + return ''.format(self.vc_class.name, self.rev) + + @property + def arg_rev(self): + # type: () -> Optional[str] + if self.rev is None: + return self.vc_class.default_arg_rev + + return self.rev + + def to_args(self): + # type: () -> CommandArgs + """ + Return the VCS-specific command arguments. + """ + args = [] # type: CommandArgs + rev = self.arg_rev + if rev is not None: + args += self.vc_class.get_base_rev_args(rev) + args += self.extra_args + + return args + + def to_display(self): + # type: () -> str + if not self.rev: + return '' + + return ' (to revision {})'.format(self.rev) + + def make_new(self, rev): + # type: (str) -> RevOptions + """ + Make a copy of the current instance, but with a new rev. + + Args: + rev: the name of the revision for the new object. + """ + return self.vc_class.make_rev_options(rev, extra_args=self.extra_args) + + +class VcsSupport(object): + _registry = {} # type: Dict[str, VersionControl] + schemes = ['ssh', 'git', 'hg', 'bzr', 'sftp', 'svn'] + + def __init__(self): + # type: () -> None + # Register more schemes with urlparse for various version control + # systems + urllib_parse.uses_netloc.extend(self.schemes) + # Python >= 2.7.4, 3.3 doesn't have uses_fragment + if getattr(urllib_parse, 'uses_fragment', None): + urllib_parse.uses_fragment.extend(self.schemes) + super(VcsSupport, self).__init__() + + def __iter__(self): + # type: () -> Iterator[str] + return self._registry.__iter__() + + @property + def backends(self): + # type: () -> List[VersionControl] + return list(self._registry.values()) + + @property + def dirnames(self): + # type: () -> List[str] + return [backend.dirname for backend in self.backends] + + @property + def all_schemes(self): + # type: () -> List[str] + schemes = [] # type: List[str] + for backend in self.backends: + schemes.extend(backend.schemes) + return schemes + + def register(self, cls): + # type: (Type[VersionControl]) -> None + if not hasattr(cls, 'name'): + logger.warning('Cannot register VCS %s', cls.__name__) + return + if cls.name not in self._registry: + self._registry[cls.name] = cls() + logger.debug('Registered VCS backend: %s', cls.name) + + def unregister(self, name): + # type: (str) -> None + if name in self._registry: + del self._registry[name] + + def get_backend_for_dir(self, location): + # type: (str) -> Optional[VersionControl] + """ + Return a VersionControl object if a repository of that type is found + at the given directory. + """ + for vcs_backend in self._registry.values(): + if vcs_backend.controls_location(location): + logger.debug('Determine that %s uses VCS: %s', + location, vcs_backend.name) + return vcs_backend + return None + + def get_backend_for_scheme(self, scheme): + # type: (str) -> Optional[VersionControl] + """ + Return a VersionControl object or None. + """ + for vcs_backend in self._registry.values(): + if scheme in vcs_backend.schemes: + return vcs_backend + return None + + def get_backend(self, name): + # type: (str) -> Optional[VersionControl] + """ + Return a VersionControl object or None. + """ + name = name.lower() + return self._registry.get(name) + + +vcs = VcsSupport() + + +class VersionControl(object): + name = '' + dirname = '' + repo_name = '' + # List of supported schemes for this Version Control + schemes = () # type: Tuple[str, ...] + # Iterable of environment variable names to pass to call_subprocess(). + unset_environ = () # type: Tuple[str, ...] + default_arg_rev = None # type: Optional[str] + + @classmethod + def should_add_vcs_url_prefix(cls, remote_url): + # type: (str) -> bool + """ + Return whether the vcs prefix (e.g. "git+") should be added to a + repository's remote url when used in a requirement. + """ + return not remote_url.lower().startswith('{}:'.format(cls.name)) + + @classmethod + def get_subdirectory(cls, location): + # type: (str) -> Optional[str] + """ + Return the path to setup.py, relative to the repo root. + Return None if setup.py is in the repo root. + """ + return None + + @classmethod + def get_requirement_revision(cls, repo_dir): + # type: (str) -> str + """ + Return the revision string that should be used in a requirement. + """ + return cls.get_revision(repo_dir) + + @classmethod + def get_src_requirement(cls, repo_dir, project_name): + # type: (str, str) -> Optional[str] + """ + Return the requirement string to use to redownload the files + currently at the given repository directory. + + Args: + project_name: the (unescaped) project name. + + The return value has a form similar to the following: + + {repository_url}@{revision}#egg={project_name} + """ + repo_url = cls.get_remote_url(repo_dir) + if repo_url is None: + return None + + if cls.should_add_vcs_url_prefix(repo_url): + repo_url = '{}+{}'.format(cls.name, repo_url) + + revision = cls.get_requirement_revision(repo_dir) + subdir = cls.get_subdirectory(repo_dir) + req = make_vcs_requirement_url(repo_url, revision, project_name, + subdir=subdir) + + return req + + @staticmethod + def get_base_rev_args(rev): + # type: (str) -> List[str] + """ + Return the base revision arguments for a vcs command. + + Args: + rev: the name of a revision to install. Cannot be None. + """ + raise NotImplementedError + + def is_immutable_rev_checkout(self, url, dest): + # type: (str, str) -> bool + """ + Return true if the commit hash checked out at dest matches + the revision in url. + + Always return False, if the VCS does not support immutable commit + hashes. + + This method does not check if there are local uncommitted changes + in dest after checkout, as pip currently has no use case for that. + """ + return False + + @classmethod + def make_rev_options(cls, rev=None, extra_args=None): + # type: (Optional[str], Optional[CommandArgs]) -> RevOptions + """ + Return a RevOptions object. + + Args: + rev: the name of a revision to install. + extra_args: a list of extra options. + """ + return RevOptions(cls, rev, extra_args=extra_args) + + @classmethod + def _is_local_repository(cls, repo): + # type: (str) -> bool + """ + posix absolute paths start with os.path.sep, + win32 ones start with drive (like c:\\folder) + """ + drive, tail = os.path.splitdrive(repo) + return repo.startswith(os.path.sep) or bool(drive) + + def export(self, location, url): + # type: (str, HiddenText) -> None + """ + Export the repository at the url to the destination location + i.e. only download the files, without vcs informations + + :param url: the repository URL starting with a vcs prefix. + """ + raise NotImplementedError + + @classmethod + def get_netloc_and_auth(cls, netloc, scheme): + # type: (str, str) -> Tuple[str, Tuple[Optional[str], Optional[str]]] + """ + Parse the repository URL's netloc, and return the new netloc to use + along with auth information. + + Args: + netloc: the original repository URL netloc. + scheme: the repository URL's scheme without the vcs prefix. + + This is mainly for the Subversion class to override, so that auth + information can be provided via the --username and --password options + instead of through the URL. For other subclasses like Git without + such an option, auth information must stay in the URL. + + Returns: (netloc, (username, password)). + """ + return netloc, (None, None) + + @classmethod + def get_url_rev_and_auth(cls, url): + # type: (str) -> Tuple[str, Optional[str], AuthInfo] + """ + Parse the repository URL to use, and return the URL, revision, + and auth info to use. + + Returns: (url, rev, (username, password)). + """ + scheme, netloc, path, query, frag = urllib_parse.urlsplit(url) + if '+' not in scheme: + raise ValueError( + "Sorry, {!r} is a malformed VCS url. " + "The format is +://, " + "e.g. svn+http://myrepo/svn/MyApp#egg=MyApp".format(url) + ) + # Remove the vcs prefix. + scheme = scheme.split('+', 1)[1] + netloc, user_pass = cls.get_netloc_and_auth(netloc, scheme) + rev = None + if '@' in path: + path, rev = path.rsplit('@', 1) + url = urllib_parse.urlunsplit((scheme, netloc, path, query, '')) + return url, rev, user_pass + + @staticmethod + def make_rev_args(username, password): + # type: (Optional[str], Optional[HiddenText]) -> CommandArgs + """ + Return the RevOptions "extra arguments" to use in obtain(). + """ + return [] + + def get_url_rev_options(self, url): + # type: (HiddenText) -> Tuple[HiddenText, RevOptions] + """ + Return the URL and RevOptions object to use in obtain() and in + some cases export(), as a tuple (url, rev_options). + """ + secret_url, rev, user_pass = self.get_url_rev_and_auth(url.secret) + username, secret_password = user_pass + password = None # type: Optional[HiddenText] + if secret_password is not None: + password = hide_value(secret_password) + extra_args = self.make_rev_args(username, password) + rev_options = self.make_rev_options(rev, extra_args=extra_args) + + return hide_url(secret_url), rev_options + + @staticmethod + def normalize_url(url): + # type: (str) -> str + """ + Normalize a URL for comparison by unquoting it and removing any + trailing slash. + """ + return urllib_parse.unquote(url).rstrip('/') + + @classmethod + def compare_urls(cls, url1, url2): + # type: (str, str) -> bool + """ + Compare two repo URLs for identity, ignoring incidental differences. + """ + return (cls.normalize_url(url1) == cls.normalize_url(url2)) + + def fetch_new(self, dest, url, rev_options): + # type: (str, HiddenText, RevOptions) -> None + """ + Fetch a revision from a repository, in the case that this is the + first fetch from the repository. + + Args: + dest: the directory to fetch the repository to. + rev_options: a RevOptions object. + """ + raise NotImplementedError + + def switch(self, dest, url, rev_options): + # type: (str, HiddenText, RevOptions) -> None + """ + Switch the repo at ``dest`` to point to ``URL``. + + Args: + rev_options: a RevOptions object. + """ + raise NotImplementedError + + def update(self, dest, url, rev_options): + # type: (str, HiddenText, RevOptions) -> None + """ + Update an already-existing repo to the given ``rev_options``. + + Args: + rev_options: a RevOptions object. + """ + raise NotImplementedError + + @classmethod + def is_commit_id_equal(cls, dest, name): + # type: (str, Optional[str]) -> bool + """ + Return whether the id of the current commit equals the given name. + + Args: + dest: the repository directory. + name: a string name. + """ + raise NotImplementedError + + def obtain(self, dest, url): + # type: (str, HiddenText) -> None + """ + Install or update in editable mode the package represented by this + VersionControl object. + + :param dest: the repository directory in which to install or update. + :param url: the repository URL starting with a vcs prefix. + """ + url, rev_options = self.get_url_rev_options(url) + + if not os.path.exists(dest): + self.fetch_new(dest, url, rev_options) + return + + rev_display = rev_options.to_display() + if self.is_repository_directory(dest): + existing_url = self.get_remote_url(dest) + if self.compare_urls(existing_url, url.secret): + logger.debug( + '%s in %s exists, and has correct URL (%s)', + self.repo_name.title(), + display_path(dest), + url, + ) + if not self.is_commit_id_equal(dest, rev_options.rev): + logger.info( + 'Updating %s %s%s', + display_path(dest), + self.repo_name, + rev_display, + ) + self.update(dest, url, rev_options) + else: + logger.info('Skipping because already up-to-date.') + return + + logger.warning( + '%s %s in %s exists with URL %s', + self.name, + self.repo_name, + display_path(dest), + existing_url, + ) + prompt = ('(s)witch, (i)gnore, (w)ipe, (b)ackup ', + ('s', 'i', 'w', 'b')) + else: + logger.warning( + 'Directory %s already exists, and is not a %s %s.', + dest, + self.name, + self.repo_name, + ) + # https://github.com/python/mypy/issues/1174 + prompt = ('(i)gnore, (w)ipe, (b)ackup ', # type: ignore + ('i', 'w', 'b')) + + logger.warning( + 'The plan is to install the %s repository %s', + self.name, + url, + ) + response = ask_path_exists('What to do? %s' % prompt[0], prompt[1]) + + if response == 'a': + sys.exit(-1) + + if response == 'w': + logger.warning('Deleting %s', display_path(dest)) + rmtree(dest) + self.fetch_new(dest, url, rev_options) + return + + if response == 'b': + dest_dir = backup_dir(dest) + logger.warning( + 'Backing up %s to %s', display_path(dest), dest_dir, + ) + shutil.move(dest, dest_dir) + self.fetch_new(dest, url, rev_options) + return + + # Do nothing if the response is "i". + if response == 's': + logger.info( + 'Switching %s %s to %s%s', + self.repo_name, + display_path(dest), + url, + rev_display, + ) + self.switch(dest, url, rev_options) + + def unpack(self, location, url): + # type: (str, HiddenText) -> None + """ + Clean up current location and download the url repository + (and vcs infos) into location + + :param url: the repository URL starting with a vcs prefix. + """ + if os.path.exists(location): + rmtree(location) + self.obtain(location, url=url) + + @classmethod + def get_remote_url(cls, location): + # type: (str) -> str + """ + Return the url used at location + + Raises RemoteNotFoundError if the repository does not have a remote + url configured. + """ + raise NotImplementedError + + @classmethod + def get_revision(cls, location): + # type: (str) -> str + """ + Return the current commit id of the files at the given location. + """ + raise NotImplementedError + + @classmethod + def run_command( + cls, + cmd, # type: Union[List[str], CommandArgs] + show_stdout=True, # type: bool + cwd=None, # type: Optional[str] + on_returncode='raise', # type: str + extra_ok_returncodes=None, # type: Optional[Iterable[int]] + command_desc=None, # type: Optional[str] + extra_environ=None, # type: Optional[Mapping[str, Any]] + spinner=None, # type: Optional[SpinnerInterface] + log_failed_cmd=True # type: bool + ): + # type: (...) -> Text + """ + Run a VCS subcommand + This is simply a wrapper around call_subprocess that adds the VCS + command name, and checks that the VCS is available + """ + cmd = make_command(cls.name, *cmd) + try: + return call_subprocess(cmd, show_stdout, cwd, + on_returncode=on_returncode, + extra_ok_returncodes=extra_ok_returncodes, + command_desc=command_desc, + extra_environ=extra_environ, + unset_environ=cls.unset_environ, + spinner=spinner, + log_failed_cmd=log_failed_cmd) + except OSError as e: + # errno.ENOENT = no such file or directory + # In other words, the VCS executable isn't available + if e.errno == errno.ENOENT: + raise BadCommand( + 'Cannot find command %r - do you have ' + '%r installed and in your ' + 'PATH?' % (cls.name, cls.name)) + else: + raise # re-raise exception if a different error occurred + + @classmethod + def is_repository_directory(cls, path): + # type: (str) -> bool + """ + Return whether a directory path is a repository directory. + """ + logger.debug('Checking in %s for %s (%s)...', + path, cls.dirname, cls.name) + return os.path.exists(os.path.join(path, cls.dirname)) + + @classmethod + def controls_location(cls, location): + # type: (str) -> bool + """ + Check if a location is controlled by the vcs. + It is meant to be overridden to implement smarter detection + mechanisms for specific vcs. + + This can do more than is_repository_directory() alone. For example, + the Git override checks that Git is actually available. + """ + return cls.is_repository_directory(location) diff --git a/venv/lib/python3.8/site-packages/pip/_internal/wheel_builder.py b/venv/lib/python3.8/site-packages/pip/_internal/wheel_builder.py new file mode 100644 index 000000000..7c7820d4f --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_internal/wheel_builder.py @@ -0,0 +1,305 @@ +"""Orchestrator for building wheels from InstallRequirements. +""" + +# The following comment should be removed at some point in the future. +# mypy: strict-optional=False + +import logging +import os.path +import re +import shutil + +from pip._internal.models.link import Link +from pip._internal.operations.build.wheel import build_wheel_pep517 +from pip._internal.operations.build.wheel_legacy import build_wheel_legacy +from pip._internal.utils.logging import indent_log +from pip._internal.utils.misc import ensure_dir, hash_file, is_wheel_installed +from pip._internal.utils.setuptools_build import make_setuptools_clean_args +from pip._internal.utils.subprocess import call_subprocess +from pip._internal.utils.temp_dir import TempDirectory +from pip._internal.utils.typing import MYPY_CHECK_RUNNING +from pip._internal.utils.urls import path_to_url +from pip._internal.vcs import vcs + +if MYPY_CHECK_RUNNING: + from typing import ( + Any, Callable, Iterable, List, Optional, Pattern, Tuple, + ) + + from pip._internal.cache import WheelCache + from pip._internal.req.req_install import InstallRequirement + + BinaryAllowedPredicate = Callable[[InstallRequirement], bool] + BuildResult = Tuple[List[InstallRequirement], List[InstallRequirement]] + +logger = logging.getLogger(__name__) + + +def _contains_egg_info( + s, _egg_info_re=re.compile(r'([a-z0-9_.]+)-([a-z0-9_.!+-]+)', re.I)): + # type: (str, Pattern[str]) -> bool + """Determine whether the string looks like an egg_info. + + :param s: The string to parse. E.g. foo-2.1 + """ + return bool(_egg_info_re.search(s)) + + +def _should_build( + req, # type: InstallRequirement + need_wheel, # type: bool + check_binary_allowed, # type: BinaryAllowedPredicate +): + # type: (...) -> bool + """Return whether an InstallRequirement should be built into a wheel.""" + if req.constraint: + # never build requirements that are merely constraints + return False + if req.is_wheel: + if need_wheel: + logger.info( + 'Skipping %s, due to already being wheel.', req.name, + ) + return False + + if need_wheel: + # i.e. pip wheel, not pip install + return True + + # From this point, this concerns the pip install command only + # (need_wheel=False). + + if not req.use_pep517 and not is_wheel_installed(): + # we don't build legacy requirements if wheel is not installed + return False + + if req.editable or not req.source_dir: + return False + + if not check_binary_allowed(req): + logger.info( + "Skipping wheel build for %s, due to binaries " + "being disabled for it.", req.name, + ) + return False + + return True + + +def should_build_for_wheel_command( + req, # type: InstallRequirement +): + # type: (...) -> bool + return _should_build( + req, need_wheel=True, check_binary_allowed=_always_true + ) + + +def should_build_for_install_command( + req, # type: InstallRequirement + check_binary_allowed, # type: BinaryAllowedPredicate +): + # type: (...) -> bool + return _should_build( + req, need_wheel=False, check_binary_allowed=check_binary_allowed + ) + + +def _should_cache( + req, # type: InstallRequirement +): + # type: (...) -> Optional[bool] + """ + Return whether a built InstallRequirement can be stored in the persistent + wheel cache, assuming the wheel cache is available, and _should_build() + has determined a wheel needs to be built. + """ + if not should_build_for_install_command( + req, check_binary_allowed=_always_true + ): + # never cache if pip install would not have built + # (editable mode, etc) + return False + + if req.link and req.link.is_vcs: + # VCS checkout. Do not cache + # unless it points to an immutable commit hash. + assert not req.editable + assert req.source_dir + vcs_backend = vcs.get_backend_for_scheme(req.link.scheme) + assert vcs_backend + if vcs_backend.is_immutable_rev_checkout(req.link.url, req.source_dir): + return True + return False + + base, ext = req.link.splitext() + if _contains_egg_info(base): + return True + + # Otherwise, do not cache. + return False + + +def _get_cache_dir( + req, # type: InstallRequirement + wheel_cache, # type: WheelCache +): + # type: (...) -> str + """Return the persistent or temporary cache directory where the built + wheel need to be stored. + """ + cache_available = bool(wheel_cache.cache_dir) + if cache_available and _should_cache(req): + cache_dir = wheel_cache.get_path_for_link(req.link) + else: + cache_dir = wheel_cache.get_ephem_path_for_link(req.link) + return cache_dir + + +def _always_true(_): + # type: (Any) -> bool + return True + + +def _build_one( + req, # type: InstallRequirement + output_dir, # type: str + build_options, # type: List[str] + global_options, # type: List[str] +): + # type: (...) -> Optional[str] + """Build one wheel. + + :return: The filename of the built wheel, or None if the build failed. + """ + try: + ensure_dir(output_dir) + except OSError as e: + logger.warning( + "Building wheel for %s failed: %s", + req.name, e, + ) + return None + + # Install build deps into temporary directory (PEP 518) + with req.build_env: + return _build_one_inside_env( + req, output_dir, build_options, global_options + ) + + +def _build_one_inside_env( + req, # type: InstallRequirement + output_dir, # type: str + build_options, # type: List[str] + global_options, # type: List[str] +): + # type: (...) -> Optional[str] + with TempDirectory(kind="wheel") as temp_dir: + if req.use_pep517: + wheel_path = build_wheel_pep517( + name=req.name, + backend=req.pep517_backend, + metadata_directory=req.metadata_directory, + build_options=build_options, + tempd=temp_dir.path, + ) + else: + wheel_path = build_wheel_legacy( + name=req.name, + setup_py_path=req.setup_py_path, + source_dir=req.unpacked_source_directory, + global_options=global_options, + build_options=build_options, + tempd=temp_dir.path, + ) + + if wheel_path is not None: + wheel_name = os.path.basename(wheel_path) + dest_path = os.path.join(output_dir, wheel_name) + try: + wheel_hash, length = hash_file(wheel_path) + shutil.move(wheel_path, dest_path) + logger.info('Created wheel for %s: ' + 'filename=%s size=%d sha256=%s', + req.name, wheel_name, length, + wheel_hash.hexdigest()) + logger.info('Stored in directory: %s', output_dir) + return dest_path + except Exception as e: + logger.warning( + "Building wheel for %s failed: %s", + req.name, e, + ) + # Ignore return, we can't do anything else useful. + if not req.use_pep517: + _clean_one_legacy(req, global_options) + return None + + +def _clean_one_legacy(req, global_options): + # type: (InstallRequirement, List[str]) -> bool + clean_args = make_setuptools_clean_args( + req.setup_py_path, + global_options=global_options, + ) + + logger.info('Running setup.py clean for %s', req.name) + try: + call_subprocess(clean_args, cwd=req.source_dir) + return True + except Exception: + logger.error('Failed cleaning build dir for %s', req.name) + return False + + +def build( + requirements, # type: Iterable[InstallRequirement] + wheel_cache, # type: WheelCache + build_options, # type: List[str] + global_options, # type: List[str] +): + # type: (...) -> BuildResult + """Build wheels. + + :return: The list of InstallRequirement that succeeded to build and + the list of InstallRequirement that failed to build. + """ + if not requirements: + return [], [] + + # Build the wheels. + logger.info( + 'Building wheels for collected packages: %s', + ', '.join(req.name for req in requirements), + ) + + with indent_log(): + build_successes, build_failures = [], [] + for req in requirements: + cache_dir = _get_cache_dir(req, wheel_cache) + wheel_file = _build_one( + req, cache_dir, build_options, global_options + ) + if wheel_file: + # Update the link for this. + req.link = Link(path_to_url(wheel_file)) + req.local_file_path = req.link.file_path + assert req.link.is_wheel + build_successes.append(req) + else: + build_failures.append(req) + + # notify success/failure + if build_successes: + logger.info( + 'Successfully built %s', + ' '.join([req.name for req in build_successes]), + ) + if build_failures: + logger.info( + 'Failed to build %s', + ' '.join([req.name for req in build_failures]), + ) + # Return a list of requirements that failed to build + return build_successes, build_failures diff --git a/venv/lib/python3.8/site-packages/pip/_vendor/__init__.py b/venv/lib/python3.8/site-packages/pip/_vendor/__init__.py new file mode 100644 index 000000000..e02eaef6d --- /dev/null +++ b/venv/lib/python3.8/site-packages/pip/_vendor/__init__.py @@ -0,0 +1,119 @@ +""" +pip._vendor is for vendoring dependencies of pip to prevent needing pip to +depend on something external. + +Files inside of pip._vendor should be considered immutable and should only be +updated to versions from upstream. +""" +from __future__ import absolute_import + +import glob +import os.path +import sys + +# Downstream redistributors which have debundled our dependencies should also +# patch this value to be true. This will trigger the additional patching +# to cause things like "six" to be available as pip. +DEBUNDLED = True + +# By default, look in this directory for a bunch of .whl files which we will +# add to the beginning of sys.path before attempting to import anything. This +# is done to support downstream re-distributors like Debian and Fedora who +# wish to create their own Wheels for our dependencies to aid in debundling. +prefix = getattr(sys, "base_prefix", sys.prefix) +if prefix.startswith('/usr/lib/pypy'): + prefix = '/usr' +WHEEL_DIR = os.path.abspath(os.path.join(prefix, 'share', 'python-wheels')) + + +# Define a small helper function to alias our vendored modules to the real ones +# if the vendored ones do not exist. This idea of this was taken from +# https://github.com/kennethreitz/requests/pull/2567. +def vendored(modulename): + vendored_name = "{0}.{1}".format(__name__, modulename) + + try: + __import__(modulename, globals(), locals(), level=0) + except ImportError: + # We can just silently allow import failures to pass here. If we + # got to this point it means that ``import pip._vendor.whatever`` + # failed and so did ``import whatever``. Since we're importing this + # upfront in an attempt to alias imports, not erroring here will + # just mean we get a regular import error whenever pip *actually* + # tries to import one of these modules to use it, which actually + # gives us a better error message than we would have otherwise + # gotten. + pass + else: + sys.modules[vendored_name] = sys.modules[modulename] + base, head = vendored_name.rsplit(".", 1) + setattr(sys.modules[base], head, sys.modules[modulename]) + + +# If we're operating in a debundled setup, then we want to go ahead and trigger +# the aliasing of our vendored libraries as well as looking for wheels to add +# to our sys.path. This will cause all of this code to be a no-op typically +# however downstream redistributors can enable it in a consistent way across +# all platforms. +if DEBUNDLED: + # Actually look inside of WHEEL_DIR to find .whl files and add them to the + # front of our sys.path. + sys.path[:] = glob.glob(os.path.join(WHEEL_DIR, "*.whl")) + sys.path + + # Actually alias all of our vendored dependencies. + vendored("appdirs") + vendored("cachecontrol") + vendored("colorama") + vendored("contextlib2") + vendored("distlib") + vendored("distro") + vendored("html5lib") + vendored("six") + vendored("six.moves") + vendored("six.moves.urllib") + vendored("six.moves.urllib.parse") + vendored("packaging") + vendored("packaging.version") + vendored("packaging.specifiers") + vendored("pep517") + vendored("pkg_resources") + vendored("progress") + vendored("retrying") + vendored("requests") + vendored("requests.exceptions") + vendored("requests.packages") + vendored("requests.packages.urllib3") + vendored("requests.packages.urllib3._collections") + vendored("requests.packages.urllib3.connection") + vendored("requests.packages.urllib3.connectionpool") + vendored("requests.packages.urllib3.contrib") + vendored("requests.packages.urllib3.contrib.ntlmpool") + vendored("requests.packages.urllib3.contrib.pyopenssl") + vendored("requests.packages.urllib3.exceptions") + vendored("requests.packages.urllib3.fields") + vendored("requests.packages.urllib3.filepost") + vendored("requests.packages.urllib3.packages") + try: + vendored("requests.packages.urllib3.packages.ordered_dict") + vendored("requests.packages.urllib3.packages.six") + except ImportError: + # Debian already unbundles these from requests. + pass + vendored("requests.packages.urllib3.packages.ssl_match_hostname") + vendored("requests.packages.urllib3.packages.ssl_match_hostname." + "_implementation") + vendored("requests.packages.urllib3.poolmanager") + vendored("requests.packages.urllib3.request") + vendored("requests.packages.urllib3.response") + vendored("requests.packages.urllib3.util") + vendored("requests.packages.urllib3.util.connection") + vendored("requests.packages.urllib3.util.request") + vendored("requests.packages.urllib3.util.response") + vendored("requests.packages.urllib3.util.retry") + vendored("requests.packages.urllib3.util.ssl_") + vendored("requests.packages.urllib3.util.timeout") + vendored("requests.packages.urllib3.util.url") + vendored("toml") + vendored("toml.encoder") + vendored("toml.decoder") + vendored("urllib3") diff --git a/venv/lib/python3.8/site-packages/pip/_vendor/__pycache__/__init__.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_vendor/__pycache__/__init__.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..8d4ef145499717c3c05150990e5045faa0b10181 GIT binary patch literal 3066 zcmbW3-E!166oBQQwRfG}{FDF*ZK?SuP`p5zLTO4FnlR8|xM<5jJ)QA5mXdX1Tdt%H ztVymyFFV5{B$s`MK8dGyz2X(P>XEH%Gwo!$guLUB@YO7SDbV~W#?#}!W~o>ZJsoK-xf__5+Aik~W;R{TuS zRXn43R`HzTdBqEg7ZoolURIn_yrOtj@pH*y8diQyNj%ACC_7;yGP&Wr(b%6FlJCzb z)1S*d>MG6aiZ>K*D$Xl@p}3&-oUOT-Vdu~TciG;=vkiRj5L z@=_3%g^A}l58?!@#2Jq<(-!??6($Htoma(t9V}KVCc+q-N*src{d#`S6Gx>e6;zj}vN=nUpTM3-f0>7rA zD4Ri$g((Sw(h1aVK;2$T=t`LI(n@F~Irga9sAa||D-Ay2rJYjT2mh58<9QN`(&j{j zLa;g0cj`WA*zeTALvS@uY07;r%^nHyABaJ2L+_q;dk`I6Mrj`A8{JJFQB1mA^dZhf z7lv;tSIB*z_ilH2EXcJyj5fkG!n+V_T@|lgSV9(yAn@`*+1#Jlg-Q4%6i939x;CSY zw=8{9o7C8GkQI$9-iu!1+hLyLm~p=yg;9?{)CootzZublvM>$(F)4!Rg|N8k+c@U3 z23ZvZS331}22{wwkFka6O->NUYBDW-;1PX%)^ z{jZ4UB#KvKh;rY`NxpF7mfy)Y)&fR2?X!q*znL?-22H3jBG>?I%G$4e!UZpm?bkf= zG9tNs;!G50gfXv%4x#^GI|%@!!T?}00|`O1wHs)dDM&L4;tplw3Cn&4tpqLrnoS|4EQV! zGdTBbR3s<^qc#!FMh;O=iqnVB))#S7%#H5%4n*;YGa*fR`=52`2$REa8xe5IARO)D z+!5xar$)KHG9}`a(EiA{tMnj+`KF+0QnY31!CwK$)=af9rD;bhG~s!j%I2zR`Zl)oHr_|?D@b~hjDFfQn%#zdX7UZ{R7l>vK;^b literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/AUTHORS.txt b/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/AUTHORS.txt new file mode 100644 index 000000000..72c87d7d3 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/AUTHORS.txt @@ -0,0 +1,562 @@ +A_Rog +Aakanksha Agrawal <11389424+rasponic@users.noreply.github.com> +Abhinav Sagar <40603139+abhinavsagar@users.noreply.github.com> +ABHYUDAY PRATAP SINGH +abs51295 +AceGentile +Adam Chainz +Adam Tse +Adam Tse +Adam Wentz +admin +Adrien Morison +ahayrapetyan +Ahilya +AinsworthK +Akash Srivastava +Alan Yee +Albert Tugushev +Albert-Guan +albertg +Aleks Bunin +Alethea Flowers +Alex Gaynor +Alex Grönholm +Alex Loosley +Alex Morega +Alex Stachowiak +Alexander Shtyrov +Alexandre Conrad +Alexey Popravka +Alexey Popravka +Alli +Ami Fischman +Ananya Maiti +Anatoly Techtonik +Anders Kaseorg +Andreas Lutro +Andrei Geacar +Andrew Gaul +Andrey Bulgakov +Andrés Delfino <34587441+andresdelfino@users.noreply.github.com> +Andrés Delfino +Andy Freeland +Andy Freeland +Andy Kluger +Ani Hayrapetyan +Aniruddha Basak +Anish Tambe +Anrs Hu +Anthony Sottile +Antoine Musso +Anton Ovchinnikov +Anton Patrushev +Antonio Alvarado Hernandez +Antony Lee +Antti Kaihola +Anubhav Patel +Anuj Godase +AQNOUCH Mohammed +AraHaan +Arindam Choudhury +Armin Ronacher +Artem +Ashley Manton +Ashwin Ramaswami +atse +Atsushi Odagiri +Avner Cohen +Baptiste Mispelon +Barney Gale +barneygale +Bartek Ogryczak +Bastian Venthur +Ben Darnell +Ben Hoyt +Ben Rosser +Bence Nagy +Benjamin Peterson +Benjamin VanEvery +Benoit Pierre +Berker Peksag +Bernardo B. Marques +Bernhard M. Wiedemann +Bertil Hatt +Bogdan Opanchuk +BorisZZZ +Brad Erickson +Bradley Ayers +Brandon L. Reiss +Brandt Bucher +Brett Randall +Brian Cristante <33549821+brcrista@users.noreply.github.com> +Brian Cristante +Brian Rosner +BrownTruck +Bruno Oliveira +Bruno Renié +Bstrdsmkr +Buck Golemon +burrows +Bussonnier Matthias +c22 +Caleb Martinez +Calvin Smith +Carl Meyer +Carlos Liam +Carol Willing +Carter Thayer +Cass +Chandrasekhar Atina +Chih-Hsuan Yen +Chih-Hsuan Yen +Chris Brinker +Chris Hunt +Chris Jerdonek +Chris McDonough +Chris Wolfe +Christian Heimes +Christian Oudard +Christopher Hunt +Christopher Snyder +Clark Boylan +Clay McClure +Cody +Cody Soyland +Colin Watson +Connor Osborn +Cooper Lees +Cooper Ry Lees +Cory Benfield +Cory Wright +Craig Kerstiens +Cristian Sorinel +Curtis Doty +cytolentino +Damian Quiroga +Dan Black +Dan Savilonis +Dan Sully +daniel +Daniel Collins +Daniel Hahler +Daniel Holth +Daniel Jost +Daniel Shaulov +Daniele Esposti +Daniele Procida +Danny Hermes +Dav Clark +Dave Abrahams +Dave Jones +David Aguilar +David Black +David Bordeynik +David Bordeynik +David Caro +David Evans +David Linke +David Pursehouse +David Tucker +David Wales +Davidovich +derwolfe +Desetude +Diego Caraballo +DiegoCaraballo +Dmitry Gladkov +Domen Kožar +Donald Stufft +Dongweiming +Douglas Thor +DrFeathers +Dustin Ingram +Dwayne Bailey +Ed Morley <501702+edmorley@users.noreply.github.com> +Ed Morley +Eitan Adler +ekristina +elainechan +Eli Schwartz +Eli Schwartz +Emil Burzo +Emil Styrke +Endoh Takanao +enoch +Erdinc Mutlu +Eric Gillingham +Eric Hanchrow +Eric Hopper +Erik M. Bray +Erik Rose +Ernest W Durbin III +Ernest W. Durbin III +Erwin Janssen +Eugene Vereshchagin +everdimension +Felix Yan +fiber-space +Filip Kokosiński +Florian Briand +Florian Rathgeber +Francesco +Francesco Montesano +Frost Ming +Gabriel Curio +Gabriel de Perthuis +Garry Polley +gdanielson +Geoffrey Lehée +Geoffrey Sneddon +George Song +Georgi Valkov +Giftlin Rajaiah +gizmoguy1 +gkdoc <40815324+gkdoc@users.noreply.github.com> +Gopinath M <31352222+mgopi1990@users.noreply.github.com> +GOTO Hayato <3532528+gh640@users.noreply.github.com> +gpiks +Guilherme Espada +Guy Rozendorn +gzpan123 +Hanjun Kim +Hari Charan +Harsh Vardhan +Herbert Pfennig +Hsiaoming Yang +Hugo +Hugo Lopes Tavares +Hugo van Kemenade +hugovk +Hynek Schlawack +Ian Bicking +Ian Cordasco +Ian Lee +Ian Stapleton Cordasco +Ian Wienand +Ian Wienand +Igor Kuzmitshov +Igor Sobreira +Ilya Baryshev +INADA Naoki +Ionel Cristian Mărieș +Ionel Maries Cristian +Ivan Pozdeev +Jacob Kim +jakirkham +Jakub Stasiak +Jakub Vysoky +Jakub Wilk +James Cleveland +James Cleveland +James Firth +James Polley +Jan Pokorný +Jannis Leidel +jarondl +Jason R. Coombs +Jay Graves +Jean-Christophe Fillion-Robin +Jeff Barber +Jeff Dairiki +Jelmer Vernooij +jenix21 +Jeremy Stanley +Jeremy Zafran +Jiashuo Li +Jim Garrison +Jivan Amara +John Paton +John-Scott Atlakson +johnthagen +johnthagen +Jon Banafato +Jon Dufresne +Jon Parise +Jonas Nockert +Jonathan Herbert +Joost Molenaar +Jorge Niedbalski +Joseph Long +Josh Bronson +Josh Hansen +Josh Schneier +Juanjo Bazán +Julian Berman +Julian Gethmann +Julien Demoor +jwg4 +Jyrki Pulliainen +Kai Chen +Kamal Bin Mustafa +kaustav haldar +keanemind +Keith Maxwell +Kelsey Hightower +Kenneth Belitzky +Kenneth Reitz +Kenneth Reitz +Kevin Burke +Kevin Carter +Kevin Frommelt +Kevin R Patterson +Kexuan Sun +Kit Randel +kpinc +Krishna Oza +Kumar McMillan +Kyle Persohn +lakshmanaram +Laszlo Kiss-Kollar +Laurent Bristiel +Laurie Opperman +Leon Sasson +Lev Givon +Lincoln de Sousa +Lipis +Loren Carvalho +Lucas Cimon +Ludovic Gasc +Luke Macken +Luo Jiebin +luojiebin +luz.paz +László Kiss Kollár +László Kiss Kollár +Marc Abramowitz +Marc Tamlyn +Marcus Smith +Mariatta +Mark Kohler +Mark Williams +Mark Williams +Markus Hametner +Masaki +Masklinn +Matej Stuchlik +Mathew Jennings +Mathieu Bridon +Matt Good +Matt Maker +Matt Robenolt +matthew +Matthew Einhorn +Matthew Gilliard +Matthew Iversen +Matthew Trumbell +Matthew Willson +Matthias Bussonnier +mattip +Maxim Kurnikov +Maxime Rouyrre +mayeut +mbaluna <44498973+mbaluna@users.noreply.github.com> +mdebi <17590103+mdebi@users.noreply.github.com> +memoselyk +Michael +Michael Aquilina +Michael E. Karpeles +Michael Klich +Michael Williamson +michaelpacer +Mickaël Schoentgen +Miguel Araujo Perez +Mihir Singh +Mike +Mike Hendricks +Min RK +MinRK +Miro Hrončok +Monica Baluna +montefra +Monty Taylor +Nate Coraor +Nathaniel J. Smith +Nehal J Wani +Neil Botelho +Nick Coghlan +Nick Stenning +Nick Timkovich +Nicolas Bock +Nikhil Benesch +Nitesh Sharma +Nowell Strite +NtaleGrey +nvdv +Ofekmeister +ofrinevo +Oliver Jeeves +Oliver Tonnhofer +Olivier Girardot +Olivier Grisel +Ollie Rutherfurd +OMOTO Kenji +Omry Yadan +Oren Held +Oscar Benjamin +Oz N Tiram +Pachwenko <32424503+Pachwenko@users.noreply.github.com> +Patrick Dubroy +Patrick Jenkins +Patrick Lawson +patricktokeeffe +Patrik Kopkan +Paul Kehrer +Paul Moore +Paul Nasrat +Paul Oswald +Paul van der Linden +Paulus Schoutsen +Pavithra Eswaramoorthy <33131404+QueenCoffee@users.noreply.github.com> +Pawel Jasinski +Pekka Klärck +Peter Lisák +Peter Waller +petr-tik +Phaneendra Chiruvella +Phil Freo +Phil Pennock +Phil Whelan +Philip Jägenstedt +Philip Molloy +Philippe Ombredanne +Pi Delport +Pierre-Yves Rofes +pip +Prabakaran Kumaresshan +Prabhjyotsing Surjit Singh Sodhi +Prabhu Marappan +Pradyun Gedam +Pratik Mallya +Preet Thakkar +Preston Holmes +Przemek Wrzos +Pulkit Goyal <7895pulkit@gmail.com> +Qiangning Hong +Quentin Pradet +R. David Murray +Rafael Caricio +Ralf Schmitt +Razzi Abuissa +rdb +Remi Rampin +Remi Rampin +Rene Dudfield +Riccardo Magliocchetti +Richard Jones +RobberPhex +Robert Collins +Robert McGibbon +Robert T. McGibbon +robin elisha robinson +Roey Berman +Rohan Jain +Rohan Jain +Rohan Jain +Roman Bogorodskiy +Romuald Brunet +Ronny Pfannschmidt +Rory McCann +Ross Brattain +Roy Wellington Ⅳ +Roy Wellington Ⅳ +Ryan Wooden +ryneeverett +Sachi King +Salvatore Rinchiera +Savio Jomton +schlamar +Scott Kitterman +Sean +seanj +Sebastian Jordan +Sebastian Schaetz +Segev Finer +SeongSoo Cho +Sergey Vasilyev +Seth Woodworth +Shlomi Fish +Shovan Maity +Simeon Visser +Simon Cross +Simon Pichugin +sinoroc +Sorin Sbarnea +Stavros Korokithakis +Stefan Scherfke +Stephan Erb +stepshal +Steve (Gadget) Barnes +Steve Barnes +Steve Dower +Steve Kowalik +Steven Myint +stonebig +Stéphane Bidoul (ACSONE) +Stéphane Bidoul +Stéphane Klein +Sumana Harihareswara +Sviatoslav Sydorenko +Sviatoslav Sydorenko +Swat009 +Takayuki SHIMIZUKAWA +tbeswick +Thijs Triemstra +Thomas Fenzl +Thomas Grainger +Thomas Guettler +Thomas Johansson +Thomas Kluyver +Thomas Smith +Tim D. Smith +Tim Gates +Tim Harder +Tim Heap +tim smith +tinruufu +Tom Forbes +Tom Freudenheim +Tom V +Tomas Orsava +Tomer Chachamu +Tony Beswick +Tony Zhaocheng Tan +TonyBeswick +toonarmycaptain +Toshio Kuratomi +Travis Swicegood +Tzu-ping Chung +Valentin Haenel +Victor Stinner +victorvpaulo +Viktor Szépe +Ville Skyttä +Vinay Sajip +Vincent Philippon +Vinicyus Macedo <7549205+vinicyusmacedo@users.noreply.github.com> +Vitaly Babiy +Vladimir Rutsky +W. Trevor King +Wil Tan +Wilfred Hughes +William ML Leslie +William T Olson +Wilson Mo +wim glenn +Wolfgang Maier +Xavier Fernandez +Xavier Fernandez +xoviat +xtreak +YAMAMOTO Takashi +Yen Chi Hsuan +Yeray Diaz Diaz +Yoval P +Yu Jian +Yuan Jing Vincent Yan +Zearin +Zearin +Zhiping Deng +Zvezdan Petkovic +Łukasz Langa +Семён Марьясин diff --git a/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/INSTALLER b/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/INSTALLER new file mode 100644 index 000000000..a1b589e38 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/LICENSE.txt b/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/LICENSE.txt new file mode 100644 index 000000000..737fec5c5 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/LICENSE.txt @@ -0,0 +1,20 @@ +Copyright (c) 2008-2019 The pip developers (see AUTHORS.txt file) + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +"Software"), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be +included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND +NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE +LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION +OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION +WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/METADATA b/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/METADATA new file mode 100644 index 000000000..cf6c9302c --- /dev/null +++ b/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/METADATA @@ -0,0 +1,13 @@ +Metadata-Version: 2.1 +Name: pkg_resources +Version: 0.0.0 +Summary: UNKNOWN +Home-page: UNKNOWN +Author: UNKNOWN +Author-email: UNKNOWN +License: UNKNOWN +Platform: UNKNOWN + +UNKNOWN + + diff --git a/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/RECORD b/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/RECORD new file mode 100644 index 000000000..c6f1cefb2 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/RECORD @@ -0,0 +1,44 @@ +pkg_resources/__init__.py,sha256=0IssxXPnaDKpYZRra8Ime0JG4hwosQljItGD0bnIkGk,108349 +pkg_resources/py31compat.py,sha256=-WQ0e4c3RG_acdhwC3gLiXhP_lg4G5q7XYkZkQg0gxU,558 +pkg_resources/_vendor/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pkg_resources/_vendor/appdirs.py,sha256=MievUEuv3l_mQISH5SF0shDk_BNhHHzYiAPrT3ITN4I,24701 +pkg_resources/_vendor/pyparsing.py,sha256=tmrp-lu-qO1i75ZzIN5A12nKRRD1Cm4Vpk-5LR9rims,232055 +pkg_resources/_vendor/six.py,sha256=A6hdJZVjI3t_geebZ9BzUvwRrIXo0lfwzQlM2LcKyas,30098 +pkg_resources/_vendor/packaging/__about__.py,sha256=zkcCPTN_6TcLW0Nrlg0176-R1QQ_WVPTm8sz1R4-HjM,720 +pkg_resources/_vendor/packaging/__init__.py,sha256=_vNac5TrzwsrzbOFIbF-5cHqc_Y2aPT2D7zrIR06BOo,513 +pkg_resources/_vendor/packaging/_compat.py,sha256=Vi_A0rAQeHbU-a9X0tt1yQm9RqkgQbDSxzRw8WlU9kA,860 +pkg_resources/_vendor/packaging/_structures.py,sha256=RImECJ4c_wTlaTYYwZYLHEiebDMaAJmK1oPARhw1T5o,1416 +pkg_resources/_vendor/packaging/markers.py,sha256=uEcBBtGvzqltgnArqb9c4RrcInXezDLos14zbBHhWJo,8248 +pkg_resources/_vendor/packaging/requirements.py,sha256=SikL2UynbsT0qtY9ltqngndha_sfo0w6XGFhAhoSoaQ,4355 +pkg_resources/_vendor/packaging/specifiers.py,sha256=SAMRerzO3fK2IkFZCaZkuwZaL_EGqHNOz4pni4vhnN0,28025 +pkg_resources/_vendor/packaging/utils.py,sha256=3m6WvPm6NNxE8rkTGmn0r75B_GZSGg7ikafxHsBN1WA,421 +pkg_resources/_vendor/packaging/version.py,sha256=OwGnxYfr2ghNzYx59qWIBkrK3SnB6n-Zfd1XaLpnnM0,11556 +pkg_resources/extern/__init__.py,sha256=cHiEfHuLmm6rs5Ve_ztBfMI7Lr31vss-D4wkqF5xzlI,2498 +pkg_resources-0.0.0.dist-info/AUTHORS.txt,sha256=RtqU9KfonVGhI48DAA4-yTOBUhBtQTjFhaDzHoyh7uU,21518 +pkg_resources-0.0.0.dist-info/LICENSE.txt,sha256=W6Ifuwlk-TatfRU2LR7W1JMcyMj5_y1NkRkOEJvnRDE,1090 +pkg_resources-0.0.0.dist-info/METADATA,sha256=V9_WPOtD1FnuKrTGv6Ique7kAOn2lasvT8W0_iMCCCk,177 +pkg_resources-0.0.0.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110 +pkg_resources-0.0.0.dist-info/RECORD,, +pkg_resources/__pycache__,, +pkg_resources-0.0.0.dist-info/__pycache__,, +pkg_resources/extern/__pycache__,, +pkg_resources-0.0.0.virtualenv,, +pkg_resources/_vendor/pyparsing.cpython-38.pyc,, +pkg_resources/_vendor/packaging/markers.cpython-38.pyc,, +pkg_resources/_vendor/packaging/__about__.cpython-38.pyc,, +pkg_resources/_vendor/packaging/version.cpython-38.pyc,, +pkg_resources/_vendor/__pycache__,, +pkg_resources/_vendor/packaging/__pycache__,, +pkg_resources/_vendor/packaging/_structures.cpython-38.pyc,, +pkg_resources/_vendor/packaging/specifiers.cpython-38.pyc,, +pkg_resources/_vendor/packaging/requirements.cpython-38.pyc,, +pkg_resources/py31compat.cpython-38.pyc,, +pkg_resources/_vendor/appdirs.cpython-38.pyc,, +pkg_resources/_vendor/packaging/_compat.cpython-38.pyc,, +pkg_resources/__init__.cpython-38.pyc,, +pkg_resources/extern/__init__.cpython-38.pyc,, +pkg_resources/_vendor/__init__.cpython-38.pyc,, +pkg_resources-0.0.0.dist-info/INSTALLER,, +pkg_resources/_vendor/packaging/__init__.cpython-38.pyc,, +pkg_resources/_vendor/six.cpython-38.pyc,, +pkg_resources/_vendor/packaging/utils.cpython-38.pyc,, \ No newline at end of file diff --git a/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/WHEEL b/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/WHEEL new file mode 100644 index 000000000..ef99c6cf3 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/WHEEL @@ -0,0 +1,6 @@ +Wheel-Version: 1.0 +Generator: bdist_wheel (0.34.2) +Root-Is-Purelib: true +Tag: py2-none-any +Tag: py3-none-any + diff --git a/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.virtualenv b/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.virtualenv new file mode 100644 index 000000000..e69de29bb diff --git a/venv/lib/python3.8/site-packages/pkg_resources/__init__.py b/venv/lib/python3.8/site-packages/pkg_resources/__init__.py new file mode 100644 index 000000000..2f5aa64a6 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pkg_resources/__init__.py @@ -0,0 +1,3296 @@ +# coding: utf-8 +""" +Package resource API +-------------------- + +A resource is a logical file contained within a package, or a logical +subdirectory thereof. The package resource API expects resource names +to have their path parts separated with ``/``, *not* whatever the local +path separator is. Do not use os.path operations to manipulate resource +names being passed into the API. + +The package resource API is designed to work with normal filesystem packages, +.egg files, and unpacked .egg files. It can also work in a limited way with +.zip files and with custom PEP 302 loaders that support the ``get_data()`` +method. +""" + +from __future__ import absolute_import + +import sys +import os +import io +import time +import re +import types +import zipfile +import zipimport +import warnings +import stat +import functools +import pkgutil +import operator +import platform +import collections +import plistlib +import email.parser +import errno +import tempfile +import textwrap +import itertools +import inspect +import ntpath +import posixpath +from pkgutil import get_importer + +try: + import _imp +except ImportError: + # Python 3.2 compatibility + import imp as _imp + +try: + FileExistsError +except NameError: + FileExistsError = OSError + +from pkg_resources.extern import six +from pkg_resources.extern.six.moves import urllib, map, filter + +# capture these to bypass sandboxing +from os import utime +try: + from os import mkdir, rename, unlink + WRITE_SUPPORT = True +except ImportError: + # no write support, probably under GAE + WRITE_SUPPORT = False + +from os import open as os_open +from os.path import isdir, split + +try: + import importlib.machinery as importlib_machinery + # access attribute to force import under delayed import mechanisms. + importlib_machinery.__name__ +except ImportError: + importlib_machinery = None + +from . import py31compat +from pkg_resources.extern import appdirs +from pkg_resources.extern import packaging +__import__('pkg_resources.extern.packaging.version') +__import__('pkg_resources.extern.packaging.specifiers') +__import__('pkg_resources.extern.packaging.requirements') +__import__('pkg_resources.extern.packaging.markers') + + +__metaclass__ = type + + +if (3, 0) < sys.version_info < (3, 5): + raise RuntimeError("Python 3.5 or later is required") + +if six.PY2: + # Those builtin exceptions are only defined in Python 3 + PermissionError = None + NotADirectoryError = None + +# declare some globals that will be defined later to +# satisfy the linters. +require = None +working_set = None +add_activation_listener = None +resources_stream = None +cleanup_resources = None +resource_dir = None +resource_stream = None +set_extraction_path = None +resource_isdir = None +resource_string = None +iter_entry_points = None +resource_listdir = None +resource_filename = None +resource_exists = None +_distribution_finders = None +_namespace_handlers = None +_namespace_packages = None + + +class PEP440Warning(RuntimeWarning): + """ + Used when there is an issue with a version or specifier not complying with + PEP 440. + """ + + +def parse_version(v): + try: + return packaging.version.Version(v) + except packaging.version.InvalidVersion: + return packaging.version.LegacyVersion(v) + + +_state_vars = {} + + +def _declare_state(vartype, **kw): + globals().update(kw) + _state_vars.update(dict.fromkeys(kw, vartype)) + + +def __getstate__(): + state = {} + g = globals() + for k, v in _state_vars.items(): + state[k] = g['_sget_' + v](g[k]) + return state + + +def __setstate__(state): + g = globals() + for k, v in state.items(): + g['_sset_' + _state_vars[k]](k, g[k], v) + return state + + +def _sget_dict(val): + return val.copy() + + +def _sset_dict(key, ob, state): + ob.clear() + ob.update(state) + + +def _sget_object(val): + return val.__getstate__() + + +def _sset_object(key, ob, state): + ob.__setstate__(state) + + +_sget_none = _sset_none = lambda *args: None + + +def get_supported_platform(): + """Return this platform's maximum compatible version. + + distutils.util.get_platform() normally reports the minimum version + of Mac OS X that would be required to *use* extensions produced by + distutils. But what we want when checking compatibility is to know the + version of Mac OS X that we are *running*. To allow usage of packages that + explicitly require a newer version of Mac OS X, we must also know the + current version of the OS. + + If this condition occurs for any other platform with a version in its + platform strings, this function should be extended accordingly. + """ + plat = get_build_platform() + m = macosVersionString.match(plat) + if m is not None and sys.platform == "darwin": + try: + plat = 'macosx-%s-%s' % ('.'.join(_macosx_vers()[:2]), m.group(3)) + except ValueError: + # not Mac OS X + pass + return plat + + +__all__ = [ + # Basic resource access and distribution/entry point discovery + 'require', 'run_script', 'get_provider', 'get_distribution', + 'load_entry_point', 'get_entry_map', 'get_entry_info', + 'iter_entry_points', + 'resource_string', 'resource_stream', 'resource_filename', + 'resource_listdir', 'resource_exists', 'resource_isdir', + + # Environmental control + 'declare_namespace', 'working_set', 'add_activation_listener', + 'find_distributions', 'set_extraction_path', 'cleanup_resources', + 'get_default_cache', + + # Primary implementation classes + 'Environment', 'WorkingSet', 'ResourceManager', + 'Distribution', 'Requirement', 'EntryPoint', + + # Exceptions + 'ResolutionError', 'VersionConflict', 'DistributionNotFound', + 'UnknownExtra', 'ExtractionError', + + # Warnings + 'PEP440Warning', + + # Parsing functions and string utilities + 'parse_requirements', 'parse_version', 'safe_name', 'safe_version', + 'get_platform', 'compatible_platforms', 'yield_lines', 'split_sections', + 'safe_extra', 'to_filename', 'invalid_marker', 'evaluate_marker', + + # filesystem utilities + 'ensure_directory', 'normalize_path', + + # Distribution "precedence" constants + 'EGG_DIST', 'BINARY_DIST', 'SOURCE_DIST', 'CHECKOUT_DIST', 'DEVELOP_DIST', + + # "Provider" interfaces, implementations, and registration/lookup APIs + 'IMetadataProvider', 'IResourceProvider', 'FileMetadata', + 'PathMetadata', 'EggMetadata', 'EmptyProvider', 'empty_provider', + 'NullProvider', 'EggProvider', 'DefaultProvider', 'ZipProvider', + 'register_finder', 'register_namespace_handler', 'register_loader_type', + 'fixup_namespace_packages', 'get_importer', + + # Warnings + 'PkgResourcesDeprecationWarning', + + # Deprecated/backward compatibility only + 'run_main', 'AvailableDistributions', +] + + +class ResolutionError(Exception): + """Abstract base for dependency resolution errors""" + + def __repr__(self): + return self.__class__.__name__ + repr(self.args) + + +class VersionConflict(ResolutionError): + """ + An already-installed version conflicts with the requested version. + + Should be initialized with the installed Distribution and the requested + Requirement. + """ + + _template = "{self.dist} is installed but {self.req} is required" + + @property + def dist(self): + return self.args[0] + + @property + def req(self): + return self.args[1] + + def report(self): + return self._template.format(**locals()) + + def with_context(self, required_by): + """ + If required_by is non-empty, return a version of self that is a + ContextualVersionConflict. + """ + if not required_by: + return self + args = self.args + (required_by,) + return ContextualVersionConflict(*args) + + +class ContextualVersionConflict(VersionConflict): + """ + A VersionConflict that accepts a third parameter, the set of the + requirements that required the installed Distribution. + """ + + _template = VersionConflict._template + ' by {self.required_by}' + + @property + def required_by(self): + return self.args[2] + + +class DistributionNotFound(ResolutionError): + """A requested distribution was not found""" + + _template = ("The '{self.req}' distribution was not found " + "and is required by {self.requirers_str}") + + @property + def req(self): + return self.args[0] + + @property + def requirers(self): + return self.args[1] + + @property + def requirers_str(self): + if not self.requirers: + return 'the application' + return ', '.join(self.requirers) + + def report(self): + return self._template.format(**locals()) + + def __str__(self): + return self.report() + + +class UnknownExtra(ResolutionError): + """Distribution doesn't have an "extra feature" of the given name""" + + +_provider_factories = {} + +PY_MAJOR = '{}.{}'.format(*sys.version_info) +EGG_DIST = 3 +BINARY_DIST = 2 +SOURCE_DIST = 1 +CHECKOUT_DIST = 0 +DEVELOP_DIST = -1 + + +def register_loader_type(loader_type, provider_factory): + """Register `provider_factory` to make providers for `loader_type` + + `loader_type` is the type or class of a PEP 302 ``module.__loader__``, + and `provider_factory` is a function that, passed a *module* object, + returns an ``IResourceProvider`` for that module. + """ + _provider_factories[loader_type] = provider_factory + + +def get_provider(moduleOrReq): + """Return an IResourceProvider for the named module or requirement""" + if isinstance(moduleOrReq, Requirement): + return working_set.find(moduleOrReq) or require(str(moduleOrReq))[0] + try: + module = sys.modules[moduleOrReq] + except KeyError: + __import__(moduleOrReq) + module = sys.modules[moduleOrReq] + loader = getattr(module, '__loader__', None) + return _find_adapter(_provider_factories, loader)(module) + + +def _macosx_vers(_cache=[]): + if not _cache: + version = platform.mac_ver()[0] + # fallback for MacPorts + if version == '': + plist = '/System/Library/CoreServices/SystemVersion.plist' + if os.path.exists(plist): + if hasattr(plistlib, 'readPlist'): + plist_content = plistlib.readPlist(plist) + if 'ProductVersion' in plist_content: + version = plist_content['ProductVersion'] + + _cache.append(version.split('.')) + return _cache[0] + + +def _macosx_arch(machine): + return {'PowerPC': 'ppc', 'Power_Macintosh': 'ppc'}.get(machine, machine) + + +def get_build_platform(): + """Return this platform's string for platform-specific distributions + + XXX Currently this is the same as ``distutils.util.get_platform()``, but it + needs some hacks for Linux and Mac OS X. + """ + from sysconfig import get_platform + + plat = get_platform() + if sys.platform == "darwin" and not plat.startswith('macosx-'): + try: + version = _macosx_vers() + machine = os.uname()[4].replace(" ", "_") + return "macosx-%d.%d-%s" % ( + int(version[0]), int(version[1]), + _macosx_arch(machine), + ) + except ValueError: + # if someone is running a non-Mac darwin system, this will fall + # through to the default implementation + pass + return plat + + +macosVersionString = re.compile(r"macosx-(\d+)\.(\d+)-(.*)") +darwinVersionString = re.compile(r"darwin-(\d+)\.(\d+)\.(\d+)-(.*)") +# XXX backward compat +get_platform = get_build_platform + + +def compatible_platforms(provided, required): + """Can code for the `provided` platform run on the `required` platform? + + Returns true if either platform is ``None``, or the platforms are equal. + + XXX Needs compatibility checks for Linux and other unixy OSes. + """ + if provided is None or required is None or provided == required: + # easy case + return True + + # Mac OS X special cases + reqMac = macosVersionString.match(required) + if reqMac: + provMac = macosVersionString.match(provided) + + # is this a Mac package? + if not provMac: + # this is backwards compatibility for packages built before + # setuptools 0.6. All packages built after this point will + # use the new macosx designation. + provDarwin = darwinVersionString.match(provided) + if provDarwin: + dversion = int(provDarwin.group(1)) + macosversion = "%s.%s" % (reqMac.group(1), reqMac.group(2)) + if dversion == 7 and macosversion >= "10.3" or \ + dversion == 8 and macosversion >= "10.4": + return True + # egg isn't macosx or legacy darwin + return False + + # are they the same major version and machine type? + if provMac.group(1) != reqMac.group(1) or \ + provMac.group(3) != reqMac.group(3): + return False + + # is the required OS major update >= the provided one? + if int(provMac.group(2)) > int(reqMac.group(2)): + return False + + return True + + # XXX Linux and other platforms' special cases should go here + return False + + +def run_script(dist_spec, script_name): + """Locate distribution `dist_spec` and run its `script_name` script""" + ns = sys._getframe(1).f_globals + name = ns['__name__'] + ns.clear() + ns['__name__'] = name + require(dist_spec)[0].run_script(script_name, ns) + + +# backward compatibility +run_main = run_script + + +def get_distribution(dist): + """Return a current distribution object for a Requirement or string""" + if isinstance(dist, six.string_types): + dist = Requirement.parse(dist) + if isinstance(dist, Requirement): + dist = get_provider(dist) + if not isinstance(dist, Distribution): + raise TypeError("Expected string, Requirement, or Distribution", dist) + return dist + + +def load_entry_point(dist, group, name): + """Return `name` entry point of `group` for `dist` or raise ImportError""" + return get_distribution(dist).load_entry_point(group, name) + + +def get_entry_map(dist, group=None): + """Return the entry point map for `group`, or the full entry map""" + return get_distribution(dist).get_entry_map(group) + + +def get_entry_info(dist, group, name): + """Return the EntryPoint object for `group`+`name`, or ``None``""" + return get_distribution(dist).get_entry_info(group, name) + + +class IMetadataProvider: + def has_metadata(name): + """Does the package's distribution contain the named metadata?""" + + def get_metadata(name): + """The named metadata resource as a string""" + + def get_metadata_lines(name): + """Yield named metadata resource as list of non-blank non-comment lines + + Leading and trailing whitespace is stripped from each line, and lines + with ``#`` as the first non-blank character are omitted.""" + + def metadata_isdir(name): + """Is the named metadata a directory? (like ``os.path.isdir()``)""" + + def metadata_listdir(name): + """List of metadata names in the directory (like ``os.listdir()``)""" + + def run_script(script_name, namespace): + """Execute the named script in the supplied namespace dictionary""" + + +class IResourceProvider(IMetadataProvider): + """An object that provides access to package resources""" + + def get_resource_filename(manager, resource_name): + """Return a true filesystem path for `resource_name` + + `manager` must be an ``IResourceManager``""" + + def get_resource_stream(manager, resource_name): + """Return a readable file-like object for `resource_name` + + `manager` must be an ``IResourceManager``""" + + def get_resource_string(manager, resource_name): + """Return a string containing the contents of `resource_name` + + `manager` must be an ``IResourceManager``""" + + def has_resource(resource_name): + """Does the package contain the named resource?""" + + def resource_isdir(resource_name): + """Is the named resource a directory? (like ``os.path.isdir()``)""" + + def resource_listdir(resource_name): + """List of resource names in the directory (like ``os.listdir()``)""" + + +class WorkingSet: + """A collection of active distributions on sys.path (or a similar list)""" + + def __init__(self, entries=None): + """Create working set from list of path entries (default=sys.path)""" + self.entries = [] + self.entry_keys = {} + self.by_key = {} + self.callbacks = [] + + if entries is None: + entries = sys.path + + for entry in entries: + self.add_entry(entry) + + @classmethod + def _build_master(cls): + """ + Prepare the master working set. + """ + ws = cls() + try: + from __main__ import __requires__ + except ImportError: + # The main program does not list any requirements + return ws + + # ensure the requirements are met + try: + ws.require(__requires__) + except VersionConflict: + return cls._build_from_requirements(__requires__) + + return ws + + @classmethod + def _build_from_requirements(cls, req_spec): + """ + Build a working set from a requirement spec. Rewrites sys.path. + """ + # try it without defaults already on sys.path + # by starting with an empty path + ws = cls([]) + reqs = parse_requirements(req_spec) + dists = ws.resolve(reqs, Environment()) + for dist in dists: + ws.add(dist) + + # add any missing entries from sys.path + for entry in sys.path: + if entry not in ws.entries: + ws.add_entry(entry) + + # then copy back to sys.path + sys.path[:] = ws.entries + return ws + + def add_entry(self, entry): + """Add a path item to ``.entries``, finding any distributions on it + + ``find_distributions(entry, True)`` is used to find distributions + corresponding to the path entry, and they are added. `entry` is + always appended to ``.entries``, even if it is already present. + (This is because ``sys.path`` can contain the same value more than + once, and the ``.entries`` of the ``sys.path`` WorkingSet should always + equal ``sys.path``.) + """ + self.entry_keys.setdefault(entry, []) + self.entries.append(entry) + for dist in find_distributions(entry, True): + self.add(dist, entry, False) + + def __contains__(self, dist): + """True if `dist` is the active distribution for its project""" + return self.by_key.get(dist.key) == dist + + def find(self, req): + """Find a distribution matching requirement `req` + + If there is an active distribution for the requested project, this + returns it as long as it meets the version requirement specified by + `req`. But, if there is an active distribution for the project and it + does *not* meet the `req` requirement, ``VersionConflict`` is raised. + If there is no active distribution for the requested project, ``None`` + is returned. + """ + dist = self.by_key.get(req.key) + if dist is not None and dist not in req: + # XXX add more info + raise VersionConflict(dist, req) + return dist + + def iter_entry_points(self, group, name=None): + """Yield entry point objects from `group` matching `name` + + If `name` is None, yields all entry points in `group` from all + distributions in the working set, otherwise only ones matching + both `group` and `name` are yielded (in distribution order). + """ + return ( + entry + for dist in self + for entry in dist.get_entry_map(group).values() + if name is None or name == entry.name + ) + + def run_script(self, requires, script_name): + """Locate distribution for `requires` and run `script_name` script""" + ns = sys._getframe(1).f_globals + name = ns['__name__'] + ns.clear() + ns['__name__'] = name + self.require(requires)[0].run_script(script_name, ns) + + def __iter__(self): + """Yield distributions for non-duplicate projects in the working set + + The yield order is the order in which the items' path entries were + added to the working set. + """ + seen = {} + for item in self.entries: + if item not in self.entry_keys: + # workaround a cache issue + continue + + for key in self.entry_keys[item]: + if key not in seen: + seen[key] = 1 + yield self.by_key[key] + + def add(self, dist, entry=None, insert=True, replace=False): + """Add `dist` to working set, associated with `entry` + + If `entry` is unspecified, it defaults to the ``.location`` of `dist`. + On exit from this routine, `entry` is added to the end of the working + set's ``.entries`` (if it wasn't already present). + + `dist` is only added to the working set if it's for a project that + doesn't already have a distribution in the set, unless `replace=True`. + If it's added, any callbacks registered with the ``subscribe()`` method + will be called. + """ + if insert: + dist.insert_on(self.entries, entry, replace=replace) + + if entry is None: + entry = dist.location + keys = self.entry_keys.setdefault(entry, []) + keys2 = self.entry_keys.setdefault(dist.location, []) + if not replace and dist.key in self.by_key: + # ignore hidden distros + return + + self.by_key[dist.key] = dist + if dist.key not in keys: + keys.append(dist.key) + if dist.key not in keys2: + keys2.append(dist.key) + self._added_new(dist) + + def resolve(self, requirements, env=None, installer=None, + replace_conflicting=False, extras=None): + """List all distributions needed to (recursively) meet `requirements` + + `requirements` must be a sequence of ``Requirement`` objects. `env`, + if supplied, should be an ``Environment`` instance. If + not supplied, it defaults to all distributions available within any + entry or distribution in the working set. `installer`, if supplied, + will be invoked with each requirement that cannot be met by an + already-installed distribution; it should return a ``Distribution`` or + ``None``. + + Unless `replace_conflicting=True`, raises a VersionConflict exception + if + any requirements are found on the path that have the correct name but + the wrong version. Otherwise, if an `installer` is supplied it will be + invoked to obtain the correct version of the requirement and activate + it. + + `extras` is a list of the extras to be used with these requirements. + This is important because extra requirements may look like `my_req; + extra = "my_extra"`, which would otherwise be interpreted as a purely + optional requirement. Instead, we want to be able to assert that these + requirements are truly required. + """ + + # set up the stack + requirements = list(requirements)[::-1] + # set of processed requirements + processed = {} + # key -> dist + best = {} + to_activate = [] + + req_extras = _ReqExtras() + + # Mapping of requirement to set of distributions that required it; + # useful for reporting info about conflicts. + required_by = collections.defaultdict(set) + + while requirements: + # process dependencies breadth-first + req = requirements.pop(0) + if req in processed: + # Ignore cyclic or redundant dependencies + continue + + if not req_extras.markers_pass(req, extras): + continue + + dist = best.get(req.key) + if dist is None: + # Find the best distribution and add it to the map + dist = self.by_key.get(req.key) + if dist is None or (dist not in req and replace_conflicting): + ws = self + if env is None: + if dist is None: + env = Environment(self.entries) + else: + # Use an empty environment and workingset to avoid + # any further conflicts with the conflicting + # distribution + env = Environment([]) + ws = WorkingSet([]) + dist = best[req.key] = env.best_match( + req, ws, installer, + replace_conflicting=replace_conflicting + ) + if dist is None: + requirers = required_by.get(req, None) + raise DistributionNotFound(req, requirers) + to_activate.append(dist) + if dist not in req: + # Oops, the "best" so far conflicts with a dependency + dependent_req = required_by[req] + raise VersionConflict(dist, req).with_context(dependent_req) + + # push the new requirements onto the stack + new_requirements = dist.requires(req.extras)[::-1] + requirements.extend(new_requirements) + + # Register the new requirements needed by req + for new_requirement in new_requirements: + required_by[new_requirement].add(req.project_name) + req_extras[new_requirement] = req.extras + + processed[req] = True + + # return list of distros to activate + return to_activate + + def find_plugins( + self, plugin_env, full_env=None, installer=None, fallback=True): + """Find all activatable distributions in `plugin_env` + + Example usage:: + + distributions, errors = working_set.find_plugins( + Environment(plugin_dirlist) + ) + # add plugins+libs to sys.path + map(working_set.add, distributions) + # display errors + print('Could not load', errors) + + The `plugin_env` should be an ``Environment`` instance that contains + only distributions that are in the project's "plugin directory" or + directories. The `full_env`, if supplied, should be an ``Environment`` + contains all currently-available distributions. If `full_env` is not + supplied, one is created automatically from the ``WorkingSet`` this + method is called on, which will typically mean that every directory on + ``sys.path`` will be scanned for distributions. + + `installer` is a standard installer callback as used by the + ``resolve()`` method. The `fallback` flag indicates whether we should + attempt to resolve older versions of a plugin if the newest version + cannot be resolved. + + This method returns a 2-tuple: (`distributions`, `error_info`), where + `distributions` is a list of the distributions found in `plugin_env` + that were loadable, along with any other distributions that are needed + to resolve their dependencies. `error_info` is a dictionary mapping + unloadable plugin distributions to an exception instance describing the + error that occurred. Usually this will be a ``DistributionNotFound`` or + ``VersionConflict`` instance. + """ + + plugin_projects = list(plugin_env) + # scan project names in alphabetic order + plugin_projects.sort() + + error_info = {} + distributions = {} + + if full_env is None: + env = Environment(self.entries) + env += plugin_env + else: + env = full_env + plugin_env + + shadow_set = self.__class__([]) + # put all our entries in shadow_set + list(map(shadow_set.add, self)) + + for project_name in plugin_projects: + + for dist in plugin_env[project_name]: + + req = [dist.as_requirement()] + + try: + resolvees = shadow_set.resolve(req, env, installer) + + except ResolutionError as v: + # save error info + error_info[dist] = v + if fallback: + # try the next older version of project + continue + else: + # give up on this project, keep going + break + + else: + list(map(shadow_set.add, resolvees)) + distributions.update(dict.fromkeys(resolvees)) + + # success, no need to try any more versions of this project + break + + distributions = list(distributions) + distributions.sort() + + return distributions, error_info + + def require(self, *requirements): + """Ensure that distributions matching `requirements` are activated + + `requirements` must be a string or a (possibly-nested) sequence + thereof, specifying the distributions and versions required. The + return value is a sequence of the distributions that needed to be + activated to fulfill the requirements; all relevant distributions are + included, even if they were already activated in this working set. + """ + needed = self.resolve(parse_requirements(requirements)) + + for dist in needed: + self.add(dist) + + return needed + + def subscribe(self, callback, existing=True): + """Invoke `callback` for all distributions + + If `existing=True` (default), + call on all existing ones, as well. + """ + if callback in self.callbacks: + return + self.callbacks.append(callback) + if not existing: + return + for dist in self: + callback(dist) + + def _added_new(self, dist): + for callback in self.callbacks: + callback(dist) + + def __getstate__(self): + return ( + self.entries[:], self.entry_keys.copy(), self.by_key.copy(), + self.callbacks[:] + ) + + def __setstate__(self, e_k_b_c): + entries, keys, by_key, callbacks = e_k_b_c + self.entries = entries[:] + self.entry_keys = keys.copy() + self.by_key = by_key.copy() + self.callbacks = callbacks[:] + + +class _ReqExtras(dict): + """ + Map each requirement to the extras that demanded it. + """ + + def markers_pass(self, req, extras=None): + """ + Evaluate markers for req against each extra that + demanded it. + + Return False if the req has a marker and fails + evaluation. Otherwise, return True. + """ + extra_evals = ( + req.marker.evaluate({'extra': extra}) + for extra in self.get(req, ()) + (extras or (None,)) + ) + return not req.marker or any(extra_evals) + + +class Environment: + """Searchable snapshot of distributions on a search path""" + + def __init__( + self, search_path=None, platform=get_supported_platform(), + python=PY_MAJOR): + """Snapshot distributions available on a search path + + Any distributions found on `search_path` are added to the environment. + `search_path` should be a sequence of ``sys.path`` items. If not + supplied, ``sys.path`` is used. + + `platform` is an optional string specifying the name of the platform + that platform-specific distributions must be compatible with. If + unspecified, it defaults to the current platform. `python` is an + optional string naming the desired version of Python (e.g. ``'3.6'``); + it defaults to the current version. + + You may explicitly set `platform` (and/or `python`) to ``None`` if you + wish to map *all* distributions, not just those compatible with the + running platform or Python version. + """ + self._distmap = {} + self.platform = platform + self.python = python + self.scan(search_path) + + def can_add(self, dist): + """Is distribution `dist` acceptable for this environment? + + The distribution must match the platform and python version + requirements specified when this environment was created, or False + is returned. + """ + py_compat = ( + self.python is None + or dist.py_version is None + or dist.py_version == self.python + ) + return py_compat and compatible_platforms(dist.platform, self.platform) + + def remove(self, dist): + """Remove `dist` from the environment""" + self._distmap[dist.key].remove(dist) + + def scan(self, search_path=None): + """Scan `search_path` for distributions usable in this environment + + Any distributions found are added to the environment. + `search_path` should be a sequence of ``sys.path`` items. If not + supplied, ``sys.path`` is used. Only distributions conforming to + the platform/python version defined at initialization are added. + """ + if search_path is None: + search_path = sys.path + + for item in search_path: + for dist in find_distributions(item): + self.add(dist) + + def __getitem__(self, project_name): + """Return a newest-to-oldest list of distributions for `project_name` + + Uses case-insensitive `project_name` comparison, assuming all the + project's distributions use their project's name converted to all + lowercase as their key. + + """ + distribution_key = project_name.lower() + return self._distmap.get(distribution_key, []) + + def add(self, dist): + """Add `dist` if we ``can_add()`` it and it has not already been added + """ + if self.can_add(dist) and dist.has_version(): + dists = self._distmap.setdefault(dist.key, []) + if dist not in dists: + dists.append(dist) + dists.sort(key=operator.attrgetter('hashcmp'), reverse=True) + + def best_match( + self, req, working_set, installer=None, replace_conflicting=False): + """Find distribution best matching `req` and usable on `working_set` + + This calls the ``find(req)`` method of the `working_set` to see if a + suitable distribution is already active. (This may raise + ``VersionConflict`` if an unsuitable version of the project is already + active in the specified `working_set`.) If a suitable distribution + isn't active, this method returns the newest distribution in the + environment that meets the ``Requirement`` in `req`. If no suitable + distribution is found, and `installer` is supplied, then the result of + calling the environment's ``obtain(req, installer)`` method will be + returned. + """ + try: + dist = working_set.find(req) + except VersionConflict: + if not replace_conflicting: + raise + dist = None + if dist is not None: + return dist + for dist in self[req.key]: + if dist in req: + return dist + # try to download/install + return self.obtain(req, installer) + + def obtain(self, requirement, installer=None): + """Obtain a distribution matching `requirement` (e.g. via download) + + Obtain a distro that matches requirement (e.g. via download). In the + base ``Environment`` class, this routine just returns + ``installer(requirement)``, unless `installer` is None, in which case + None is returned instead. This method is a hook that allows subclasses + to attempt other ways of obtaining a distribution before falling back + to the `installer` argument.""" + if installer is not None: + return installer(requirement) + + def __iter__(self): + """Yield the unique project names of the available distributions""" + for key in self._distmap.keys(): + if self[key]: + yield key + + def __iadd__(self, other): + """In-place addition of a distribution or environment""" + if isinstance(other, Distribution): + self.add(other) + elif isinstance(other, Environment): + for project in other: + for dist in other[project]: + self.add(dist) + else: + raise TypeError("Can't add %r to environment" % (other,)) + return self + + def __add__(self, other): + """Add an environment or distribution to an environment""" + new = self.__class__([], platform=None, python=None) + for env in self, other: + new += env + return new + + +# XXX backward compatibility +AvailableDistributions = Environment + + +class ExtractionError(RuntimeError): + """An error occurred extracting a resource + + The following attributes are available from instances of this exception: + + manager + The resource manager that raised this exception + + cache_path + The base directory for resource extraction + + original_error + The exception instance that caused extraction to fail + """ + + +class ResourceManager: + """Manage resource extraction and packages""" + extraction_path = None + + def __init__(self): + self.cached_files = {} + + def resource_exists(self, package_or_requirement, resource_name): + """Does the named resource exist?""" + return get_provider(package_or_requirement).has_resource(resource_name) + + def resource_isdir(self, package_or_requirement, resource_name): + """Is the named resource an existing directory?""" + return get_provider(package_or_requirement).resource_isdir( + resource_name + ) + + def resource_filename(self, package_or_requirement, resource_name): + """Return a true filesystem path for specified resource""" + return get_provider(package_or_requirement).get_resource_filename( + self, resource_name + ) + + def resource_stream(self, package_or_requirement, resource_name): + """Return a readable file-like object for specified resource""" + return get_provider(package_or_requirement).get_resource_stream( + self, resource_name + ) + + def resource_string(self, package_or_requirement, resource_name): + """Return specified resource as a string""" + return get_provider(package_or_requirement).get_resource_string( + self, resource_name + ) + + def resource_listdir(self, package_or_requirement, resource_name): + """List the contents of the named resource directory""" + return get_provider(package_or_requirement).resource_listdir( + resource_name + ) + + def extraction_error(self): + """Give an error message for problems extracting file(s)""" + + old_exc = sys.exc_info()[1] + cache_path = self.extraction_path or get_default_cache() + + tmpl = textwrap.dedent(""" + Can't extract file(s) to egg cache + + The following error occurred while trying to extract file(s) + to the Python egg cache: + + {old_exc} + + The Python egg cache directory is currently set to: + + {cache_path} + + Perhaps your account does not have write access to this directory? + You can change the cache directory by setting the PYTHON_EGG_CACHE + environment variable to point to an accessible directory. + """).lstrip() + err = ExtractionError(tmpl.format(**locals())) + err.manager = self + err.cache_path = cache_path + err.original_error = old_exc + raise err + + def get_cache_path(self, archive_name, names=()): + """Return absolute location in cache for `archive_name` and `names` + + The parent directory of the resulting path will be created if it does + not already exist. `archive_name` should be the base filename of the + enclosing egg (which may not be the name of the enclosing zipfile!), + including its ".egg" extension. `names`, if provided, should be a + sequence of path name parts "under" the egg's extraction location. + + This method should only be called by resource providers that need to + obtain an extraction location, and only for names they intend to + extract, as it tracks the generated names for possible cleanup later. + """ + extract_path = self.extraction_path or get_default_cache() + target_path = os.path.join(extract_path, archive_name + '-tmp', *names) + try: + _bypass_ensure_directory(target_path) + except Exception: + self.extraction_error() + + self._warn_unsafe_extraction_path(extract_path) + + self.cached_files[target_path] = 1 + return target_path + + @staticmethod + def _warn_unsafe_extraction_path(path): + """ + If the default extraction path is overridden and set to an insecure + location, such as /tmp, it opens up an opportunity for an attacker to + replace an extracted file with an unauthorized payload. Warn the user + if a known insecure location is used. + + See Distribute #375 for more details. + """ + if os.name == 'nt' and not path.startswith(os.environ['windir']): + # On Windows, permissions are generally restrictive by default + # and temp directories are not writable by other users, so + # bypass the warning. + return + mode = os.stat(path).st_mode + if mode & stat.S_IWOTH or mode & stat.S_IWGRP: + msg = ( + "%s is writable by group/others and vulnerable to attack " + "when " + "used with get_resource_filename. Consider a more secure " + "location (set with .set_extraction_path or the " + "PYTHON_EGG_CACHE environment variable)." % path + ) + warnings.warn(msg, UserWarning) + + def postprocess(self, tempname, filename): + """Perform any platform-specific postprocessing of `tempname` + + This is where Mac header rewrites should be done; other platforms don't + have anything special they should do. + + Resource providers should call this method ONLY after successfully + extracting a compressed resource. They must NOT call it on resources + that are already in the filesystem. + + `tempname` is the current (temporary) name of the file, and `filename` + is the name it will be renamed to by the caller after this routine + returns. + """ + + if os.name == 'posix': + # Make the resource executable + mode = ((os.stat(tempname).st_mode) | 0o555) & 0o7777 + os.chmod(tempname, mode) + + def set_extraction_path(self, path): + """Set the base path where resources will be extracted to, if needed. + + If you do not call this routine before any extractions take place, the + path defaults to the return value of ``get_default_cache()``. (Which + is based on the ``PYTHON_EGG_CACHE`` environment variable, with various + platform-specific fallbacks. See that routine's documentation for more + details.) + + Resources are extracted to subdirectories of this path based upon + information given by the ``IResourceProvider``. You may set this to a + temporary directory, but then you must call ``cleanup_resources()`` to + delete the extracted files when done. There is no guarantee that + ``cleanup_resources()`` will be able to remove all extracted files. + + (Note: you may not change the extraction path for a given resource + manager once resources have been extracted, unless you first call + ``cleanup_resources()``.) + """ + if self.cached_files: + raise ValueError( + "Can't change extraction path, files already extracted" + ) + + self.extraction_path = path + + def cleanup_resources(self, force=False): + """ + Delete all extracted resource files and directories, returning a list + of the file and directory names that could not be successfully removed. + This function does not have any concurrency protection, so it should + generally only be called when the extraction path is a temporary + directory exclusive to a single process. This method is not + automatically called; you must call it explicitly or register it as an + ``atexit`` function if you wish to ensure cleanup of a temporary + directory used for extractions. + """ + # XXX + + +def get_default_cache(): + """ + Return the ``PYTHON_EGG_CACHE`` environment variable + or a platform-relevant user cache dir for an app + named "Python-Eggs". + """ + return ( + os.environ.get('PYTHON_EGG_CACHE') + or appdirs.user_cache_dir(appname='Python-Eggs') + ) + + +def safe_name(name): + """Convert an arbitrary string to a standard distribution name + + Any runs of non-alphanumeric/. characters are replaced with a single '-'. + """ + return re.sub('[^A-Za-z0-9.]+', '-', name) + + +def safe_version(version): + """ + Convert an arbitrary string to a standard version string + """ + try: + # normalize the version + return str(packaging.version.Version(version)) + except packaging.version.InvalidVersion: + version = version.replace(' ', '.') + return re.sub('[^A-Za-z0-9.]+', '-', version) + + +def safe_extra(extra): + """Convert an arbitrary string to a standard 'extra' name + + Any runs of non-alphanumeric characters are replaced with a single '_', + and the result is always lowercased. + """ + return re.sub('[^A-Za-z0-9.-]+', '_', extra).lower() + + +def to_filename(name): + """Convert a project or version name to its filename-escaped form + + Any '-' characters are currently replaced with '_'. + """ + return name.replace('-', '_') + + +def invalid_marker(text): + """ + Validate text as a PEP 508 environment marker; return an exception + if invalid or False otherwise. + """ + try: + evaluate_marker(text) + except SyntaxError as e: + e.filename = None + e.lineno = None + return e + return False + + +def evaluate_marker(text, extra=None): + """ + Evaluate a PEP 508 environment marker. + Return a boolean indicating the marker result in this environment. + Raise SyntaxError if marker is invalid. + + This implementation uses the 'pyparsing' module. + """ + try: + marker = packaging.markers.Marker(text) + return marker.evaluate() + except packaging.markers.InvalidMarker as e: + raise SyntaxError(e) + + +class NullProvider: + """Try to implement resources and metadata for arbitrary PEP 302 loaders""" + + egg_name = None + egg_info = None + loader = None + + def __init__(self, module): + self.loader = getattr(module, '__loader__', None) + self.module_path = os.path.dirname(getattr(module, '__file__', '')) + + def get_resource_filename(self, manager, resource_name): + return self._fn(self.module_path, resource_name) + + def get_resource_stream(self, manager, resource_name): + return io.BytesIO(self.get_resource_string(manager, resource_name)) + + def get_resource_string(self, manager, resource_name): + return self._get(self._fn(self.module_path, resource_name)) + + def has_resource(self, resource_name): + return self._has(self._fn(self.module_path, resource_name)) + + def _get_metadata_path(self, name): + return self._fn(self.egg_info, name) + + def has_metadata(self, name): + if not self.egg_info: + return self.egg_info + + path = self._get_metadata_path(name) + return self._has(path) + + def get_metadata(self, name): + if not self.egg_info: + return "" + path = self._get_metadata_path(name) + value = self._get(path) + if six.PY2: + return value + try: + return value.decode('utf-8') + except UnicodeDecodeError as exc: + # Include the path in the error message to simplify + # troubleshooting, and without changing the exception type. + exc.reason += ' in {} file at path: {}'.format(name, path) + raise + + def get_metadata_lines(self, name): + return yield_lines(self.get_metadata(name)) + + def resource_isdir(self, resource_name): + return self._isdir(self._fn(self.module_path, resource_name)) + + def metadata_isdir(self, name): + return self.egg_info and self._isdir(self._fn(self.egg_info, name)) + + def resource_listdir(self, resource_name): + return self._listdir(self._fn(self.module_path, resource_name)) + + def metadata_listdir(self, name): + if self.egg_info: + return self._listdir(self._fn(self.egg_info, name)) + return [] + + def run_script(self, script_name, namespace): + script = 'scripts/' + script_name + if not self.has_metadata(script): + raise ResolutionError( + "Script {script!r} not found in metadata at {self.egg_info!r}" + .format(**locals()), + ) + script_text = self.get_metadata(script).replace('\r\n', '\n') + script_text = script_text.replace('\r', '\n') + script_filename = self._fn(self.egg_info, script) + namespace['__file__'] = script_filename + if os.path.exists(script_filename): + source = open(script_filename).read() + code = compile(source, script_filename, 'exec') + exec(code, namespace, namespace) + else: + from linecache import cache + cache[script_filename] = ( + len(script_text), 0, script_text.split('\n'), script_filename + ) + script_code = compile(script_text, script_filename, 'exec') + exec(script_code, namespace, namespace) + + def _has(self, path): + raise NotImplementedError( + "Can't perform this operation for unregistered loader type" + ) + + def _isdir(self, path): + raise NotImplementedError( + "Can't perform this operation for unregistered loader type" + ) + + def _listdir(self, path): + raise NotImplementedError( + "Can't perform this operation for unregistered loader type" + ) + + def _fn(self, base, resource_name): + self._validate_resource_path(resource_name) + if resource_name: + return os.path.join(base, *resource_name.split('/')) + return base + + @staticmethod + def _validate_resource_path(path): + """ + Validate the resource paths according to the docs. + https://setuptools.readthedocs.io/en/latest/pkg_resources.html#basic-resource-access + + >>> warned = getfixture('recwarn') + >>> warnings.simplefilter('always') + >>> vrp = NullProvider._validate_resource_path + >>> vrp('foo/bar.txt') + >>> bool(warned) + False + >>> vrp('../foo/bar.txt') + >>> bool(warned) + True + >>> warned.clear() + >>> vrp('/foo/bar.txt') + >>> bool(warned) + True + >>> vrp('foo/../../bar.txt') + >>> bool(warned) + True + >>> warned.clear() + >>> vrp('foo/f../bar.txt') + >>> bool(warned) + False + + Windows path separators are straight-up disallowed. + >>> vrp(r'\\foo/bar.txt') + Traceback (most recent call last): + ... + ValueError: Use of .. or absolute path in a resource path \ +is not allowed. + + >>> vrp(r'C:\\foo/bar.txt') + Traceback (most recent call last): + ... + ValueError: Use of .. or absolute path in a resource path \ +is not allowed. + + Blank values are allowed + + >>> vrp('') + >>> bool(warned) + False + + Non-string values are not. + + >>> vrp(None) + Traceback (most recent call last): + ... + AttributeError: ... + """ + invalid = ( + os.path.pardir in path.split(posixpath.sep) or + posixpath.isabs(path) or + ntpath.isabs(path) + ) + if not invalid: + return + + msg = "Use of .. or absolute path in a resource path is not allowed." + + # Aggressively disallow Windows absolute paths + if ntpath.isabs(path) and not posixpath.isabs(path): + raise ValueError(msg) + + # for compatibility, warn; in future + # raise ValueError(msg) + warnings.warn( + msg[:-1] + " and will raise exceptions in a future release.", + DeprecationWarning, + stacklevel=4, + ) + + def _get(self, path): + if hasattr(self.loader, 'get_data'): + return self.loader.get_data(path) + raise NotImplementedError( + "Can't perform this operation for loaders without 'get_data()'" + ) + + +register_loader_type(object, NullProvider) + + +class EggProvider(NullProvider): + """Provider based on a virtual filesystem""" + + def __init__(self, module): + NullProvider.__init__(self, module) + self._setup_prefix() + + def _setup_prefix(self): + # we assume here that our metadata may be nested inside a "basket" + # of multiple eggs; that's why we use module_path instead of .archive + path = self.module_path + old = None + while path != old: + if _is_egg_path(path): + self.egg_name = os.path.basename(path) + self.egg_info = os.path.join(path, 'EGG-INFO') + self.egg_root = path + break + old = path + path, base = os.path.split(path) + + +class DefaultProvider(EggProvider): + """Provides access to package resources in the filesystem""" + + def _has(self, path): + return os.path.exists(path) + + def _isdir(self, path): + return os.path.isdir(path) + + def _listdir(self, path): + return os.listdir(path) + + def get_resource_stream(self, manager, resource_name): + return open(self._fn(self.module_path, resource_name), 'rb') + + def _get(self, path): + with open(path, 'rb') as stream: + return stream.read() + + @classmethod + def _register(cls): + loader_names = 'SourceFileLoader', 'SourcelessFileLoader', + for name in loader_names: + loader_cls = getattr(importlib_machinery, name, type(None)) + register_loader_type(loader_cls, cls) + + +DefaultProvider._register() + + +class EmptyProvider(NullProvider): + """Provider that returns nothing for all requests""" + + module_path = None + + _isdir = _has = lambda self, path: False + + def _get(self, path): + return '' + + def _listdir(self, path): + return [] + + def __init__(self): + pass + + +empty_provider = EmptyProvider() + + +class ZipManifests(dict): + """ + zip manifest builder + """ + + @classmethod + def build(cls, path): + """ + Build a dictionary similar to the zipimport directory + caches, except instead of tuples, store ZipInfo objects. + + Use a platform-specific path separator (os.sep) for the path keys + for compatibility with pypy on Windows. + """ + with zipfile.ZipFile(path) as zfile: + items = ( + ( + name.replace('/', os.sep), + zfile.getinfo(name), + ) + for name in zfile.namelist() + ) + return dict(items) + + load = build + + +class MemoizedZipManifests(ZipManifests): + """ + Memoized zipfile manifests. + """ + manifest_mod = collections.namedtuple('manifest_mod', 'manifest mtime') + + def load(self, path): + """ + Load a manifest at path or return a suitable manifest already loaded. + """ + path = os.path.normpath(path) + mtime = os.stat(path).st_mtime + + if path not in self or self[path].mtime != mtime: + manifest = self.build(path) + self[path] = self.manifest_mod(manifest, mtime) + + return self[path].manifest + + +class ZipProvider(EggProvider): + """Resource support for zips and eggs""" + + eagers = None + _zip_manifests = MemoizedZipManifests() + + def __init__(self, module): + EggProvider.__init__(self, module) + self.zip_pre = self.loader.archive + os.sep + + def _zipinfo_name(self, fspath): + # Convert a virtual filename (full path to file) into a zipfile subpath + # usable with the zipimport directory cache for our target archive + fspath = fspath.rstrip(os.sep) + if fspath == self.loader.archive: + return '' + if fspath.startswith(self.zip_pre): + return fspath[len(self.zip_pre):] + raise AssertionError( + "%s is not a subpath of %s" % (fspath, self.zip_pre) + ) + + def _parts(self, zip_path): + # Convert a zipfile subpath into an egg-relative path part list. + # pseudo-fs path + fspath = self.zip_pre + zip_path + if fspath.startswith(self.egg_root + os.sep): + return fspath[len(self.egg_root) + 1:].split(os.sep) + raise AssertionError( + "%s is not a subpath of %s" % (fspath, self.egg_root) + ) + + @property + def zipinfo(self): + return self._zip_manifests.load(self.loader.archive) + + def get_resource_filename(self, manager, resource_name): + if not self.egg_name: + raise NotImplementedError( + "resource_filename() only supported for .egg, not .zip" + ) + # no need to lock for extraction, since we use temp names + zip_path = self._resource_to_zip(resource_name) + eagers = self._get_eager_resources() + if '/'.join(self._parts(zip_path)) in eagers: + for name in eagers: + self._extract_resource(manager, self._eager_to_zip(name)) + return self._extract_resource(manager, zip_path) + + @staticmethod + def _get_date_and_size(zip_stat): + size = zip_stat.file_size + # ymdhms+wday, yday, dst + date_time = zip_stat.date_time + (0, 0, -1) + # 1980 offset already done + timestamp = time.mktime(date_time) + return timestamp, size + + def _extract_resource(self, manager, zip_path): + + if zip_path in self._index(): + for name in self._index()[zip_path]: + last = self._extract_resource( + manager, os.path.join(zip_path, name) + ) + # return the extracted directory name + return os.path.dirname(last) + + timestamp, size = self._get_date_and_size(self.zipinfo[zip_path]) + + if not WRITE_SUPPORT: + raise IOError('"os.rename" and "os.unlink" are not supported ' + 'on this platform') + try: + + real_path = manager.get_cache_path( + self.egg_name, self._parts(zip_path) + ) + + if self._is_current(real_path, zip_path): + return real_path + + outf, tmpnam = _mkstemp( + ".$extract", + dir=os.path.dirname(real_path), + ) + os.write(outf, self.loader.get_data(zip_path)) + os.close(outf) + utime(tmpnam, (timestamp, timestamp)) + manager.postprocess(tmpnam, real_path) + + try: + rename(tmpnam, real_path) + + except os.error: + if os.path.isfile(real_path): + if self._is_current(real_path, zip_path): + # the file became current since it was checked above, + # so proceed. + return real_path + # Windows, del old file and retry + elif os.name == 'nt': + unlink(real_path) + rename(tmpnam, real_path) + return real_path + raise + + except os.error: + # report a user-friendly error + manager.extraction_error() + + return real_path + + def _is_current(self, file_path, zip_path): + """ + Return True if the file_path is current for this zip_path + """ + timestamp, size = self._get_date_and_size(self.zipinfo[zip_path]) + if not os.path.isfile(file_path): + return False + stat = os.stat(file_path) + if stat.st_size != size or stat.st_mtime != timestamp: + return False + # check that the contents match + zip_contents = self.loader.get_data(zip_path) + with open(file_path, 'rb') as f: + file_contents = f.read() + return zip_contents == file_contents + + def _get_eager_resources(self): + if self.eagers is None: + eagers = [] + for name in ('native_libs.txt', 'eager_resources.txt'): + if self.has_metadata(name): + eagers.extend(self.get_metadata_lines(name)) + self.eagers = eagers + return self.eagers + + def _index(self): + try: + return self._dirindex + except AttributeError: + ind = {} + for path in self.zipinfo: + parts = path.split(os.sep) + while parts: + parent = os.sep.join(parts[:-1]) + if parent in ind: + ind[parent].append(parts[-1]) + break + else: + ind[parent] = [parts.pop()] + self._dirindex = ind + return ind + + def _has(self, fspath): + zip_path = self._zipinfo_name(fspath) + return zip_path in self.zipinfo or zip_path in self._index() + + def _isdir(self, fspath): + return self._zipinfo_name(fspath) in self._index() + + def _listdir(self, fspath): + return list(self._index().get(self._zipinfo_name(fspath), ())) + + def _eager_to_zip(self, resource_name): + return self._zipinfo_name(self._fn(self.egg_root, resource_name)) + + def _resource_to_zip(self, resource_name): + return self._zipinfo_name(self._fn(self.module_path, resource_name)) + + +register_loader_type(zipimport.zipimporter, ZipProvider) + + +class FileMetadata(EmptyProvider): + """Metadata handler for standalone PKG-INFO files + + Usage:: + + metadata = FileMetadata("/path/to/PKG-INFO") + + This provider rejects all data and metadata requests except for PKG-INFO, + which is treated as existing, and will be the contents of the file at + the provided location. + """ + + def __init__(self, path): + self.path = path + + def _get_metadata_path(self, name): + return self.path + + def has_metadata(self, name): + return name == 'PKG-INFO' and os.path.isfile(self.path) + + def get_metadata(self, name): + if name != 'PKG-INFO': + raise KeyError("No metadata except PKG-INFO is available") + + with io.open(self.path, encoding='utf-8', errors="replace") as f: + metadata = f.read() + self._warn_on_replacement(metadata) + return metadata + + def _warn_on_replacement(self, metadata): + # Python 2.7 compat for: replacement_char = '�' + replacement_char = b'\xef\xbf\xbd'.decode('utf-8') + if replacement_char in metadata: + tmpl = "{self.path} could not be properly decoded in UTF-8" + msg = tmpl.format(**locals()) + warnings.warn(msg) + + def get_metadata_lines(self, name): + return yield_lines(self.get_metadata(name)) + + +class PathMetadata(DefaultProvider): + """Metadata provider for egg directories + + Usage:: + + # Development eggs: + + egg_info = "/path/to/PackageName.egg-info" + base_dir = os.path.dirname(egg_info) + metadata = PathMetadata(base_dir, egg_info) + dist_name = os.path.splitext(os.path.basename(egg_info))[0] + dist = Distribution(basedir, project_name=dist_name, metadata=metadata) + + # Unpacked egg directories: + + egg_path = "/path/to/PackageName-ver-pyver-etc.egg" + metadata = PathMetadata(egg_path, os.path.join(egg_path,'EGG-INFO')) + dist = Distribution.from_filename(egg_path, metadata=metadata) + """ + + def __init__(self, path, egg_info): + self.module_path = path + self.egg_info = egg_info + + +class EggMetadata(ZipProvider): + """Metadata provider for .egg files""" + + def __init__(self, importer): + """Create a metadata provider from a zipimporter""" + + self.zip_pre = importer.archive + os.sep + self.loader = importer + if importer.prefix: + self.module_path = os.path.join(importer.archive, importer.prefix) + else: + self.module_path = importer.archive + self._setup_prefix() + + +_declare_state('dict', _distribution_finders={}) + + +def register_finder(importer_type, distribution_finder): + """Register `distribution_finder` to find distributions in sys.path items + + `importer_type` is the type or class of a PEP 302 "Importer" (sys.path item + handler), and `distribution_finder` is a callable that, passed a path + item and the importer instance, yields ``Distribution`` instances found on + that path item. See ``pkg_resources.find_on_path`` for an example.""" + _distribution_finders[importer_type] = distribution_finder + + +def find_distributions(path_item, only=False): + """Yield distributions accessible via `path_item`""" + importer = get_importer(path_item) + finder = _find_adapter(_distribution_finders, importer) + return finder(importer, path_item, only) + + +def find_eggs_in_zip(importer, path_item, only=False): + """ + Find eggs in zip files; possibly multiple nested eggs. + """ + if importer.archive.endswith('.whl'): + # wheels are not supported with this finder + # they don't have PKG-INFO metadata, and won't ever contain eggs + return + metadata = EggMetadata(importer) + if metadata.has_metadata('PKG-INFO'): + yield Distribution.from_filename(path_item, metadata=metadata) + if only: + # don't yield nested distros + return + for subitem in metadata.resource_listdir(''): + if _is_egg_path(subitem): + subpath = os.path.join(path_item, subitem) + dists = find_eggs_in_zip(zipimport.zipimporter(subpath), subpath) + for dist in dists: + yield dist + elif subitem.lower().endswith('.dist-info'): + subpath = os.path.join(path_item, subitem) + submeta = EggMetadata(zipimport.zipimporter(subpath)) + submeta.egg_info = subpath + yield Distribution.from_location(path_item, subitem, submeta) + + +register_finder(zipimport.zipimporter, find_eggs_in_zip) + + +def find_nothing(importer, path_item, only=False): + return () + + +register_finder(object, find_nothing) + + +def _by_version_descending(names): + """ + Given a list of filenames, return them in descending order + by version number. + + >>> names = 'bar', 'foo', 'Python-2.7.10.egg', 'Python-2.7.2.egg' + >>> _by_version_descending(names) + ['Python-2.7.10.egg', 'Python-2.7.2.egg', 'foo', 'bar'] + >>> names = 'Setuptools-1.2.3b1.egg', 'Setuptools-1.2.3.egg' + >>> _by_version_descending(names) + ['Setuptools-1.2.3.egg', 'Setuptools-1.2.3b1.egg'] + >>> names = 'Setuptools-1.2.3b1.egg', 'Setuptools-1.2.3.post1.egg' + >>> _by_version_descending(names) + ['Setuptools-1.2.3.post1.egg', 'Setuptools-1.2.3b1.egg'] + """ + def _by_version(name): + """ + Parse each component of the filename + """ + name, ext = os.path.splitext(name) + parts = itertools.chain(name.split('-'), [ext]) + return [packaging.version.parse(part) for part in parts] + + return sorted(names, key=_by_version, reverse=True) + + +def find_on_path(importer, path_item, only=False): + """Yield distributions accessible on a sys.path directory""" + path_item = _normalize_cached(path_item) + + if _is_unpacked_egg(path_item): + yield Distribution.from_filename( + path_item, metadata=PathMetadata( + path_item, os.path.join(path_item, 'EGG-INFO') + ) + ) + return + + entries = safe_listdir(path_item) + + # for performance, before sorting by version, + # screen entries for only those that will yield + # distributions + filtered = ( + entry + for entry in entries + if dist_factory(path_item, entry, only) + ) + + # scan for .egg and .egg-info in directory + path_item_entries = _by_version_descending(filtered) + for entry in path_item_entries: + fullpath = os.path.join(path_item, entry) + factory = dist_factory(path_item, entry, only) + for dist in factory(fullpath): + yield dist + + +def dist_factory(path_item, entry, only): + """ + Return a dist_factory for a path_item and entry + """ + lower = entry.lower() + is_meta = any(map(lower.endswith, ('.egg-info', '.dist-info'))) + return ( + distributions_from_metadata + if is_meta else + find_distributions + if not only and _is_egg_path(entry) else + resolve_egg_link + if not only and lower.endswith('.egg-link') else + NoDists() + ) + + +class NoDists: + """ + >>> bool(NoDists()) + False + + >>> list(NoDists()('anything')) + [] + """ + def __bool__(self): + return False + if six.PY2: + __nonzero__ = __bool__ + + def __call__(self, fullpath): + return iter(()) + + +def safe_listdir(path): + """ + Attempt to list contents of path, but suppress some exceptions. + """ + try: + return os.listdir(path) + except (PermissionError, NotADirectoryError): + pass + except OSError as e: + # Ignore the directory if does not exist, not a directory or + # permission denied + ignorable = ( + e.errno in (errno.ENOTDIR, errno.EACCES, errno.ENOENT) + # Python 2 on Windows needs to be handled this way :( + or getattr(e, "winerror", None) == 267 + ) + if not ignorable: + raise + return () + + +def distributions_from_metadata(path): + root = os.path.dirname(path) + if os.path.isdir(path): + if len(os.listdir(path)) == 0: + # empty metadata dir; skip + return + metadata = PathMetadata(root, path) + else: + metadata = FileMetadata(path) + entry = os.path.basename(path) + yield Distribution.from_location( + root, entry, metadata, precedence=DEVELOP_DIST, + ) + + +def non_empty_lines(path): + """ + Yield non-empty lines from file at path + """ + with open(path) as f: + for line in f: + line = line.strip() + if line: + yield line + + +def resolve_egg_link(path): + """ + Given a path to an .egg-link, resolve distributions + present in the referenced path. + """ + referenced_paths = non_empty_lines(path) + resolved_paths = ( + os.path.join(os.path.dirname(path), ref) + for ref in referenced_paths + ) + dist_groups = map(find_distributions, resolved_paths) + return next(dist_groups, ()) + + +register_finder(pkgutil.ImpImporter, find_on_path) + +if hasattr(importlib_machinery, 'FileFinder'): + register_finder(importlib_machinery.FileFinder, find_on_path) + +_declare_state('dict', _namespace_handlers={}) +_declare_state('dict', _namespace_packages={}) + + +def register_namespace_handler(importer_type, namespace_handler): + """Register `namespace_handler` to declare namespace packages + + `importer_type` is the type or class of a PEP 302 "Importer" (sys.path item + handler), and `namespace_handler` is a callable like this:: + + def namespace_handler(importer, path_entry, moduleName, module): + # return a path_entry to use for child packages + + Namespace handlers are only called if the importer object has already + agreed that it can handle the relevant path item, and they should only + return a subpath if the module __path__ does not already contain an + equivalent subpath. For an example namespace handler, see + ``pkg_resources.file_ns_handler``. + """ + _namespace_handlers[importer_type] = namespace_handler + + +def _handle_ns(packageName, path_item): + """Ensure that named package includes a subpath of path_item (if needed)""" + + importer = get_importer(path_item) + if importer is None: + return None + + # capture warnings due to #1111 + with warnings.catch_warnings(): + warnings.simplefilter("ignore") + loader = importer.find_module(packageName) + + if loader is None: + return None + module = sys.modules.get(packageName) + if module is None: + module = sys.modules[packageName] = types.ModuleType(packageName) + module.__path__ = [] + _set_parent_ns(packageName) + elif not hasattr(module, '__path__'): + raise TypeError("Not a package:", packageName) + handler = _find_adapter(_namespace_handlers, importer) + subpath = handler(importer, path_item, packageName, module) + if subpath is not None: + path = module.__path__ + path.append(subpath) + loader.load_module(packageName) + _rebuild_mod_path(path, packageName, module) + return subpath + + +def _rebuild_mod_path(orig_path, package_name, module): + """ + Rebuild module.__path__ ensuring that all entries are ordered + corresponding to their sys.path order + """ + sys_path = [_normalize_cached(p) for p in sys.path] + + def safe_sys_path_index(entry): + """ + Workaround for #520 and #513. + """ + try: + return sys_path.index(entry) + except ValueError: + return float('inf') + + def position_in_sys_path(path): + """ + Return the ordinal of the path based on its position in sys.path + """ + path_parts = path.split(os.sep) + module_parts = package_name.count('.') + 1 + parts = path_parts[:-module_parts] + return safe_sys_path_index(_normalize_cached(os.sep.join(parts))) + + new_path = sorted(orig_path, key=position_in_sys_path) + new_path = [_normalize_cached(p) for p in new_path] + + if isinstance(module.__path__, list): + module.__path__[:] = new_path + else: + module.__path__ = new_path + + +def declare_namespace(packageName): + """Declare that package 'packageName' is a namespace package""" + + _imp.acquire_lock() + try: + if packageName in _namespace_packages: + return + + path = sys.path + parent, _, _ = packageName.rpartition('.') + + if parent: + declare_namespace(parent) + if parent not in _namespace_packages: + __import__(parent) + try: + path = sys.modules[parent].__path__ + except AttributeError: + raise TypeError("Not a package:", parent) + + # Track what packages are namespaces, so when new path items are added, + # they can be updated + _namespace_packages.setdefault(parent or None, []).append(packageName) + _namespace_packages.setdefault(packageName, []) + + for path_item in path: + # Ensure all the parent's path items are reflected in the child, + # if they apply + _handle_ns(packageName, path_item) + + finally: + _imp.release_lock() + + +def fixup_namespace_packages(path_item, parent=None): + """Ensure that previously-declared namespace packages include path_item""" + _imp.acquire_lock() + try: + for package in _namespace_packages.get(parent, ()): + subpath = _handle_ns(package, path_item) + if subpath: + fixup_namespace_packages(subpath, package) + finally: + _imp.release_lock() + + +def file_ns_handler(importer, path_item, packageName, module): + """Compute an ns-package subpath for a filesystem or zipfile importer""" + + subpath = os.path.join(path_item, packageName.split('.')[-1]) + normalized = _normalize_cached(subpath) + for item in module.__path__: + if _normalize_cached(item) == normalized: + break + else: + # Only return the path if it's not already there + return subpath + + +register_namespace_handler(pkgutil.ImpImporter, file_ns_handler) +register_namespace_handler(zipimport.zipimporter, file_ns_handler) + +if hasattr(importlib_machinery, 'FileFinder'): + register_namespace_handler(importlib_machinery.FileFinder, file_ns_handler) + + +def null_ns_handler(importer, path_item, packageName, module): + return None + + +register_namespace_handler(object, null_ns_handler) + + +def normalize_path(filename): + """Normalize a file/dir name for comparison purposes""" + return os.path.normcase(os.path.realpath(os.path.normpath(_cygwin_patch(filename)))) + + +def _cygwin_patch(filename): # pragma: nocover + """ + Contrary to POSIX 2008, on Cygwin, getcwd (3) contains + symlink components. Using + os.path.abspath() works around this limitation. A fix in os.getcwd() + would probably better, in Cygwin even more so, except + that this seems to be by design... + """ + return os.path.abspath(filename) if sys.platform == 'cygwin' else filename + + +def _normalize_cached(filename, _cache={}): + try: + return _cache[filename] + except KeyError: + _cache[filename] = result = normalize_path(filename) + return result + + +def _is_egg_path(path): + """ + Determine if given path appears to be an egg. + """ + return path.lower().endswith('.egg') + + +def _is_unpacked_egg(path): + """ + Determine if given path appears to be an unpacked egg. + """ + return ( + _is_egg_path(path) and + os.path.isfile(os.path.join(path, 'EGG-INFO', 'PKG-INFO')) + ) + + +def _set_parent_ns(packageName): + parts = packageName.split('.') + name = parts.pop() + if parts: + parent = '.'.join(parts) + setattr(sys.modules[parent], name, sys.modules[packageName]) + + +def yield_lines(strs): + """Yield non-empty/non-comment lines of a string or sequence""" + if isinstance(strs, six.string_types): + for s in strs.splitlines(): + s = s.strip() + # skip blank lines/comments + if s and not s.startswith('#'): + yield s + else: + for ss in strs: + for s in yield_lines(ss): + yield s + + +MODULE = re.compile(r"\w+(\.\w+)*$").match +EGG_NAME = re.compile( + r""" + (?P[^-]+) ( + -(?P[^-]+) ( + -py(?P[^-]+) ( + -(?P.+) + )? + )? + )? + """, + re.VERBOSE | re.IGNORECASE, +).match + + +class EntryPoint: + """Object representing an advertised importable object""" + + def __init__(self, name, module_name, attrs=(), extras=(), dist=None): + if not MODULE(module_name): + raise ValueError("Invalid module name", module_name) + self.name = name + self.module_name = module_name + self.attrs = tuple(attrs) + self.extras = tuple(extras) + self.dist = dist + + def __str__(self): + s = "%s = %s" % (self.name, self.module_name) + if self.attrs: + s += ':' + '.'.join(self.attrs) + if self.extras: + s += ' [%s]' % ','.join(self.extras) + return s + + def __repr__(self): + return "EntryPoint.parse(%r)" % str(self) + + def load(self, require=True, *args, **kwargs): + """ + Require packages for this EntryPoint, then resolve it. + """ + if not require or args or kwargs: + warnings.warn( + "Parameters to load are deprecated. Call .resolve and " + ".require separately.", + PkgResourcesDeprecationWarning, + stacklevel=2, + ) + if require: + self.require(*args, **kwargs) + return self.resolve() + + def resolve(self): + """ + Resolve the entry point from its module and attrs. + """ + module = __import__(self.module_name, fromlist=['__name__'], level=0) + try: + return functools.reduce(getattr, self.attrs, module) + except AttributeError as exc: + raise ImportError(str(exc)) + + def require(self, env=None, installer=None): + if self.extras and not self.dist: + raise UnknownExtra("Can't require() without a distribution", self) + + # Get the requirements for this entry point with all its extras and + # then resolve them. We have to pass `extras` along when resolving so + # that the working set knows what extras we want. Otherwise, for + # dist-info distributions, the working set will assume that the + # requirements for that extra are purely optional and skip over them. + reqs = self.dist.requires(self.extras) + items = working_set.resolve(reqs, env, installer, extras=self.extras) + list(map(working_set.add, items)) + + pattern = re.compile( + r'\s*' + r'(?P.+?)\s*' + r'=\s*' + r'(?P[\w.]+)\s*' + r'(:\s*(?P[\w.]+))?\s*' + r'(?P\[.*\])?\s*$' + ) + + @classmethod + def parse(cls, src, dist=None): + """Parse a single entry point from string `src` + + Entry point syntax follows the form:: + + name = some.module:some.attr [extra1, extra2] + + The entry name and module name are required, but the ``:attrs`` and + ``[extras]`` parts are optional + """ + m = cls.pattern.match(src) + if not m: + msg = "EntryPoint must be in 'name=module:attrs [extras]' format" + raise ValueError(msg, src) + res = m.groupdict() + extras = cls._parse_extras(res['extras']) + attrs = res['attr'].split('.') if res['attr'] else () + return cls(res['name'], res['module'], attrs, extras, dist) + + @classmethod + def _parse_extras(cls, extras_spec): + if not extras_spec: + return () + req = Requirement.parse('x' + extras_spec) + if req.specs: + raise ValueError() + return req.extras + + @classmethod + def parse_group(cls, group, lines, dist=None): + """Parse an entry point group""" + if not MODULE(group): + raise ValueError("Invalid group name", group) + this = {} + for line in yield_lines(lines): + ep = cls.parse(line, dist) + if ep.name in this: + raise ValueError("Duplicate entry point", group, ep.name) + this[ep.name] = ep + return this + + @classmethod + def parse_map(cls, data, dist=None): + """Parse a map of entry point groups""" + if isinstance(data, dict): + data = data.items() + else: + data = split_sections(data) + maps = {} + for group, lines in data: + if group is None: + if not lines: + continue + raise ValueError("Entry points must be listed in groups") + group = group.strip() + if group in maps: + raise ValueError("Duplicate group name", group) + maps[group] = cls.parse_group(group, lines, dist) + return maps + + +def _remove_md5_fragment(location): + if not location: + return '' + parsed = urllib.parse.urlparse(location) + if parsed[-1].startswith('md5='): + return urllib.parse.urlunparse(parsed[:-1] + ('',)) + return location + + +def _version_from_file(lines): + """ + Given an iterable of lines from a Metadata file, return + the value of the Version field, if present, or None otherwise. + """ + def is_version_line(line): + return line.lower().startswith('version:') + version_lines = filter(is_version_line, lines) + line = next(iter(version_lines), '') + _, _, value = line.partition(':') + return safe_version(value.strip()) or None + + +class Distribution: + """Wrap an actual or potential sys.path entry w/metadata""" + PKG_INFO = 'PKG-INFO' + + def __init__( + self, location=None, metadata=None, project_name=None, + version=None, py_version=PY_MAJOR, platform=None, + precedence=EGG_DIST): + self.project_name = safe_name(project_name or 'Unknown') + if version is not None: + self._version = safe_version(version) + self.py_version = py_version + self.platform = platform + self.location = location + self.precedence = precedence + self._provider = metadata or empty_provider + + @classmethod + def from_location(cls, location, basename, metadata=None, **kw): + project_name, version, py_version, platform = [None] * 4 + basename, ext = os.path.splitext(basename) + if ext.lower() in _distributionImpl: + cls = _distributionImpl[ext.lower()] + + match = EGG_NAME(basename) + if match: + project_name, version, py_version, platform = match.group( + 'name', 'ver', 'pyver', 'plat' + ) + return cls( + location, metadata, project_name=project_name, version=version, + py_version=py_version, platform=platform, **kw + )._reload_version() + + def _reload_version(self): + return self + + @property + def hashcmp(self): + return ( + self.parsed_version, + self.precedence, + self.key, + _remove_md5_fragment(self.location), + self.py_version or '', + self.platform or '', + ) + + def __hash__(self): + return hash(self.hashcmp) + + def __lt__(self, other): + return self.hashcmp < other.hashcmp + + def __le__(self, other): + return self.hashcmp <= other.hashcmp + + def __gt__(self, other): + return self.hashcmp > other.hashcmp + + def __ge__(self, other): + return self.hashcmp >= other.hashcmp + + def __eq__(self, other): + if not isinstance(other, self.__class__): + # It's not a Distribution, so they are not equal + return False + return self.hashcmp == other.hashcmp + + def __ne__(self, other): + return not self == other + + # These properties have to be lazy so that we don't have to load any + # metadata until/unless it's actually needed. (i.e., some distributions + # may not know their name or version without loading PKG-INFO) + + @property + def key(self): + try: + return self._key + except AttributeError: + self._key = key = self.project_name.lower() + return key + + @property + def parsed_version(self): + if not hasattr(self, "_parsed_version"): + self._parsed_version = parse_version(self.version) + + return self._parsed_version + + def _warn_legacy_version(self): + LV = packaging.version.LegacyVersion + is_legacy = isinstance(self._parsed_version, LV) + if not is_legacy: + return + + # While an empty version is technically a legacy version and + # is not a valid PEP 440 version, it's also unlikely to + # actually come from someone and instead it is more likely that + # it comes from setuptools attempting to parse a filename and + # including it in the list. So for that we'll gate this warning + # on if the version is anything at all or not. + if not self.version: + return + + tmpl = textwrap.dedent(""" + '{project_name} ({version})' is being parsed as a legacy, + non PEP 440, + version. You may find odd behavior and sort order. + In particular it will be sorted as less than 0.0. It + is recommended to migrate to PEP 440 compatible + versions. + """).strip().replace('\n', ' ') + + warnings.warn(tmpl.format(**vars(self)), PEP440Warning) + + @property + def version(self): + try: + return self._version + except AttributeError: + version = self._get_version() + if version is None: + path = self._get_metadata_path_for_display(self.PKG_INFO) + msg = ( + "Missing 'Version:' header and/or {} file at path: {}" + ).format(self.PKG_INFO, path) + raise ValueError(msg, self) + + return version + + @property + def _dep_map(self): + """ + A map of extra to its list of (direct) requirements + for this distribution, including the null extra. + """ + try: + return self.__dep_map + except AttributeError: + self.__dep_map = self._filter_extras(self._build_dep_map()) + return self.__dep_map + + @staticmethod + def _filter_extras(dm): + """ + Given a mapping of extras to dependencies, strip off + environment markers and filter out any dependencies + not matching the markers. + """ + for extra in list(filter(None, dm)): + new_extra = extra + reqs = dm.pop(extra) + new_extra, _, marker = extra.partition(':') + fails_marker = marker and ( + invalid_marker(marker) + or not evaluate_marker(marker) + ) + if fails_marker: + reqs = [] + new_extra = safe_extra(new_extra) or None + + dm.setdefault(new_extra, []).extend(reqs) + return dm + + def _build_dep_map(self): + dm = {} + for name in 'requires.txt', 'depends.txt': + for extra, reqs in split_sections(self._get_metadata(name)): + dm.setdefault(extra, []).extend(parse_requirements(reqs)) + return dm + + def requires(self, extras=()): + """List of Requirements needed for this distro if `extras` are used""" + dm = self._dep_map + deps = [] + deps.extend(dm.get(None, ())) + for ext in extras: + try: + deps.extend(dm[safe_extra(ext)]) + except KeyError: + raise UnknownExtra( + "%s has no such extra feature %r" % (self, ext) + ) + return deps + + def _get_metadata_path_for_display(self, name): + """ + Return the path to the given metadata file, if available. + """ + try: + # We need to access _get_metadata_path() on the provider object + # directly rather than through this class's __getattr__() + # since _get_metadata_path() is marked private. + path = self._provider._get_metadata_path(name) + + # Handle exceptions e.g. in case the distribution's metadata + # provider doesn't support _get_metadata_path(). + except Exception: + return '[could not detect]' + + return path + + def _get_metadata(self, name): + if self.has_metadata(name): + for line in self.get_metadata_lines(name): + yield line + + def _get_version(self): + lines = self._get_metadata(self.PKG_INFO) + version = _version_from_file(lines) + + return version + + def activate(self, path=None, replace=False): + """Ensure distribution is importable on `path` (default=sys.path)""" + if path is None: + path = sys.path + self.insert_on(path, replace=replace) + if path is sys.path: + fixup_namespace_packages(self.location) + for pkg in self._get_metadata('namespace_packages.txt'): + if pkg in sys.modules: + declare_namespace(pkg) + + def egg_name(self): + """Return what this distribution's standard .egg filename should be""" + filename = "%s-%s-py%s" % ( + to_filename(self.project_name), to_filename(self.version), + self.py_version or PY_MAJOR + ) + + if self.platform: + filename += '-' + self.platform + return filename + + def __repr__(self): + if self.location: + return "%s (%s)" % (self, self.location) + else: + return str(self) + + def __str__(self): + try: + version = getattr(self, 'version', None) + except ValueError: + version = None + version = version or "[unknown version]" + return "%s %s" % (self.project_name, version) + + def __getattr__(self, attr): + """Delegate all unrecognized public attributes to .metadata provider""" + if attr.startswith('_'): + raise AttributeError(attr) + return getattr(self._provider, attr) + + def __dir__(self): + return list( + set(super(Distribution, self).__dir__()) + | set( + attr for attr in self._provider.__dir__() + if not attr.startswith('_') + ) + ) + + if not hasattr(object, '__dir__'): + # python 2.7 not supported + del __dir__ + + @classmethod + def from_filename(cls, filename, metadata=None, **kw): + return cls.from_location( + _normalize_cached(filename), os.path.basename(filename), metadata, + **kw + ) + + def as_requirement(self): + """Return a ``Requirement`` that matches this distribution exactly""" + if isinstance(self.parsed_version, packaging.version.Version): + spec = "%s==%s" % (self.project_name, self.parsed_version) + else: + spec = "%s===%s" % (self.project_name, self.parsed_version) + + return Requirement.parse(spec) + + def load_entry_point(self, group, name): + """Return the `name` entry point of `group` or raise ImportError""" + ep = self.get_entry_info(group, name) + if ep is None: + raise ImportError("Entry point %r not found" % ((group, name),)) + return ep.load() + + def get_entry_map(self, group=None): + """Return the entry point map for `group`, or the full entry map""" + try: + ep_map = self._ep_map + except AttributeError: + ep_map = self._ep_map = EntryPoint.parse_map( + self._get_metadata('entry_points.txt'), self + ) + if group is not None: + return ep_map.get(group, {}) + return ep_map + + def get_entry_info(self, group, name): + """Return the EntryPoint object for `group`+`name`, or ``None``""" + return self.get_entry_map(group).get(name) + + def insert_on(self, path, loc=None, replace=False): + """Ensure self.location is on path + + If replace=False (default): + - If location is already in path anywhere, do nothing. + - Else: + - If it's an egg and its parent directory is on path, + insert just ahead of the parent. + - Else: add to the end of path. + If replace=True: + - If location is already on path anywhere (not eggs) + or higher priority than its parent (eggs) + do nothing. + - Else: + - If it's an egg and its parent directory is on path, + insert just ahead of the parent, + removing any lower-priority entries. + - Else: add it to the front of path. + """ + + loc = loc or self.location + if not loc: + return + + nloc = _normalize_cached(loc) + bdir = os.path.dirname(nloc) + npath = [(p and _normalize_cached(p) or p) for p in path] + + for p, item in enumerate(npath): + if item == nloc: + if replace: + break + else: + # don't modify path (even removing duplicates) if + # found and not replace + return + elif item == bdir and self.precedence == EGG_DIST: + # if it's an .egg, give it precedence over its directory + # UNLESS it's already been added to sys.path and replace=False + if (not replace) and nloc in npath[p:]: + return + if path is sys.path: + self.check_version_conflict() + path.insert(p, loc) + npath.insert(p, nloc) + break + else: + if path is sys.path: + self.check_version_conflict() + if replace: + path.insert(0, loc) + else: + path.append(loc) + return + + # p is the spot where we found or inserted loc; now remove duplicates + while True: + try: + np = npath.index(nloc, p + 1) + except ValueError: + break + else: + del npath[np], path[np] + # ha! + p = np + + return + + def check_version_conflict(self): + if self.key == 'setuptools': + # ignore the inevitable setuptools self-conflicts :( + return + + nsp = dict.fromkeys(self._get_metadata('namespace_packages.txt')) + loc = normalize_path(self.location) + for modname in self._get_metadata('top_level.txt'): + if (modname not in sys.modules or modname in nsp + or modname in _namespace_packages): + continue + if modname in ('pkg_resources', 'setuptools', 'site'): + continue + fn = getattr(sys.modules[modname], '__file__', None) + if fn and (normalize_path(fn).startswith(loc) or + fn.startswith(self.location)): + continue + issue_warning( + "Module %s was already imported from %s, but %s is being added" + " to sys.path" % (modname, fn, self.location), + ) + + def has_version(self): + try: + self.version + except ValueError: + issue_warning("Unbuilt egg for " + repr(self)) + return False + return True + + def clone(self, **kw): + """Copy this distribution, substituting in any changed keyword args""" + names = 'project_name version py_version platform location precedence' + for attr in names.split(): + kw.setdefault(attr, getattr(self, attr, None)) + kw.setdefault('metadata', self._provider) + return self.__class__(**kw) + + @property + def extras(self): + return [dep for dep in self._dep_map if dep] + + +class EggInfoDistribution(Distribution): + def _reload_version(self): + """ + Packages installed by distutils (e.g. numpy or scipy), + which uses an old safe_version, and so + their version numbers can get mangled when + converted to filenames (e.g., 1.11.0.dev0+2329eae to + 1.11.0.dev0_2329eae). These distributions will not be + parsed properly + downstream by Distribution and safe_version, so + take an extra step and try to get the version number from + the metadata file itself instead of the filename. + """ + md_version = self._get_version() + if md_version: + self._version = md_version + return self + + +class DistInfoDistribution(Distribution): + """ + Wrap an actual or potential sys.path entry + w/metadata, .dist-info style. + """ + PKG_INFO = 'METADATA' + EQEQ = re.compile(r"([\(,])\s*(\d.*?)\s*([,\)])") + + @property + def _parsed_pkg_info(self): + """Parse and cache metadata""" + try: + return self._pkg_info + except AttributeError: + metadata = self.get_metadata(self.PKG_INFO) + self._pkg_info = email.parser.Parser().parsestr(metadata) + return self._pkg_info + + @property + def _dep_map(self): + try: + return self.__dep_map + except AttributeError: + self.__dep_map = self._compute_dependencies() + return self.__dep_map + + def _compute_dependencies(self): + """Recompute this distribution's dependencies.""" + dm = self.__dep_map = {None: []} + + reqs = [] + # Including any condition expressions + for req in self._parsed_pkg_info.get_all('Requires-Dist') or []: + reqs.extend(parse_requirements(req)) + + def reqs_for_extra(extra): + for req in reqs: + if not req.marker or req.marker.evaluate({'extra': extra}): + yield req + + common = frozenset(reqs_for_extra(None)) + dm[None].extend(common) + + for extra in self._parsed_pkg_info.get_all('Provides-Extra') or []: + s_extra = safe_extra(extra.strip()) + dm[s_extra] = list(frozenset(reqs_for_extra(extra)) - common) + + return dm + + +_distributionImpl = { + '.egg': Distribution, + '.egg-info': EggInfoDistribution, + '.dist-info': DistInfoDistribution, +} + + +def issue_warning(*args, **kw): + level = 1 + g = globals() + try: + # find the first stack frame that is *not* code in + # the pkg_resources module, to use for the warning + while sys._getframe(level).f_globals is g: + level += 1 + except ValueError: + pass + warnings.warn(stacklevel=level + 1, *args, **kw) + + +class RequirementParseError(ValueError): + def __str__(self): + return ' '.join(self.args) + + +def parse_requirements(strs): + """Yield ``Requirement`` objects for each specification in `strs` + + `strs` must be a string, or a (possibly-nested) iterable thereof. + """ + # create a steppable iterator, so we can handle \-continuations + lines = iter(yield_lines(strs)) + + for line in lines: + # Drop comments -- a hash without a space may be in a URL. + if ' #' in line: + line = line[:line.find(' #')] + # If there is a line continuation, drop it, and append the next line. + if line.endswith('\\'): + line = line[:-2].strip() + try: + line += next(lines) + except StopIteration: + return + yield Requirement(line) + + +class Requirement(packaging.requirements.Requirement): + def __init__(self, requirement_string): + """DO NOT CALL THIS UNDOCUMENTED METHOD; use Requirement.parse()!""" + try: + super(Requirement, self).__init__(requirement_string) + except packaging.requirements.InvalidRequirement as e: + raise RequirementParseError(str(e)) + self.unsafe_name = self.name + project_name = safe_name(self.name) + self.project_name, self.key = project_name, project_name.lower() + self.specs = [ + (spec.operator, spec.version) for spec in self.specifier] + self.extras = tuple(map(safe_extra, self.extras)) + self.hashCmp = ( + self.key, + self.url, + self.specifier, + frozenset(self.extras), + str(self.marker) if self.marker else None, + ) + self.__hash = hash(self.hashCmp) + + def __eq__(self, other): + return ( + isinstance(other, Requirement) and + self.hashCmp == other.hashCmp + ) + + def __ne__(self, other): + return not self == other + + def __contains__(self, item): + if isinstance(item, Distribution): + if item.key != self.key: + return False + + item = item.version + + # Allow prereleases always in order to match the previous behavior of + # this method. In the future this should be smarter and follow PEP 440 + # more accurately. + return self.specifier.contains(item, prereleases=True) + + def __hash__(self): + return self.__hash + + def __repr__(self): + return "Requirement.parse(%r)" % str(self) + + @staticmethod + def parse(s): + req, = parse_requirements(s) + return req + + +def _always_object(classes): + """ + Ensure object appears in the mro even + for old-style classes. + """ + if object not in classes: + return classes + (object,) + return classes + + +def _find_adapter(registry, ob): + """Return an adapter factory for `ob` from `registry`""" + types = _always_object(inspect.getmro(getattr(ob, '__class__', type(ob)))) + for t in types: + if t in registry: + return registry[t] + + +def ensure_directory(path): + """Ensure that the parent directory of `path` exists""" + dirname = os.path.dirname(path) + py31compat.makedirs(dirname, exist_ok=True) + + +def _bypass_ensure_directory(path): + """Sandbox-bypassing version of ensure_directory()""" + if not WRITE_SUPPORT: + raise IOError('"os.mkdir" not supported on this platform.') + dirname, filename = split(path) + if dirname and filename and not isdir(dirname): + _bypass_ensure_directory(dirname) + try: + mkdir(dirname, 0o755) + except FileExistsError: + pass + + +def split_sections(s): + """Split a string or iterable thereof into (section, content) pairs + + Each ``section`` is a stripped version of the section header ("[section]") + and each ``content`` is a list of stripped lines excluding blank lines and + comment-only lines. If there are any such lines before the first section + header, they're returned in a first ``section`` of ``None``. + """ + section = None + content = [] + for line in yield_lines(s): + if line.startswith("["): + if line.endswith("]"): + if section or content: + yield section, content + section = line[1:-1].strip() + content = [] + else: + raise ValueError("Invalid section heading", line) + else: + content.append(line) + + # wrap up last segment + yield section, content + + +def _mkstemp(*args, **kw): + old_open = os.open + try: + # temporarily bypass sandboxing + os.open = os_open + return tempfile.mkstemp(*args, **kw) + finally: + # and then put it back + os.open = old_open + + +# Silence the PEP440Warning by default, so that end users don't get hit by it +# randomly just because they use pkg_resources. We want to append the rule +# because we want earlier uses of filterwarnings to take precedence over this +# one. +warnings.filterwarnings("ignore", category=PEP440Warning, append=True) + + +# from jaraco.functools 1.3 +def _call_aside(f, *args, **kwargs): + f(*args, **kwargs) + return f + + +@_call_aside +def _initialize(g=globals()): + "Set up global resource manager (deliberately not state-saved)" + manager = ResourceManager() + g['_manager'] = manager + g.update( + (name, getattr(manager, name)) + for name in dir(manager) + if not name.startswith('_') + ) + + +@_call_aside +def _initialize_master_working_set(): + """ + Prepare the master working set and make the ``require()`` + API available. + + This function has explicit effects on the global state + of pkg_resources. It is intended to be invoked once at + the initialization of this module. + + Invocation by other packages is unsupported and done + at their own risk. + """ + working_set = WorkingSet._build_master() + _declare_state('object', working_set=working_set) + + require = working_set.require + iter_entry_points = working_set.iter_entry_points + add_activation_listener = working_set.subscribe + run_script = working_set.run_script + # backward compatibility + run_main = run_script + # Activate all distributions already on sys.path with replace=False and + # ensure that all distributions added to the working set in the future + # (e.g. by calling ``require()``) will get activated as well, + # with higher priority (replace=True). + tuple( + dist.activate(replace=False) + for dist in working_set + ) + add_activation_listener( + lambda dist: dist.activate(replace=True), + existing=False, + ) + working_set.entries = [] + # match order + list(map(working_set.add_entry, sys.path)) + globals().update(locals()) + +class PkgResourcesDeprecationWarning(Warning): + """ + Base class for warning about deprecations in ``pkg_resources`` + + This class is not derived from ``DeprecationWarning``, and as such is + visible by default. + """ diff --git a/venv/lib/python3.8/site-packages/pkg_resources/_vendor/__init__.py b/venv/lib/python3.8/site-packages/pkg_resources/_vendor/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/venv/lib/python3.8/site-packages/pkg_resources/_vendor/appdirs.py b/venv/lib/python3.8/site-packages/pkg_resources/_vendor/appdirs.py new file mode 100644 index 000000000..ae67001af --- /dev/null +++ b/venv/lib/python3.8/site-packages/pkg_resources/_vendor/appdirs.py @@ -0,0 +1,608 @@ +#!/usr/bin/env python +# -*- coding: utf-8 -*- +# Copyright (c) 2005-2010 ActiveState Software Inc. +# Copyright (c) 2013 Eddy Petrișor + +"""Utilities for determining application-specific dirs. + +See for details and usage. +""" +# Dev Notes: +# - MSDN on where to store app data files: +# http://support.microsoft.com/default.aspx?scid=kb;en-us;310294#XSLTH3194121123120121120120 +# - Mac OS X: http://developer.apple.com/documentation/MacOSX/Conceptual/BPFileSystem/index.html +# - XDG spec for Un*x: http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html + +__version_info__ = (1, 4, 3) +__version__ = '.'.join(map(str, __version_info__)) + + +import sys +import os + +PY3 = sys.version_info[0] == 3 + +if PY3: + unicode = str + +if sys.platform.startswith('java'): + import platform + os_name = platform.java_ver()[3][0] + if os_name.startswith('Windows'): # "Windows XP", "Windows 7", etc. + system = 'win32' + elif os_name.startswith('Mac'): # "Mac OS X", etc. + system = 'darwin' + else: # "Linux", "SunOS", "FreeBSD", etc. + # Setting this to "linux2" is not ideal, but only Windows or Mac + # are actually checked for and the rest of the module expects + # *sys.platform* style strings. + system = 'linux2' +else: + system = sys.platform + + + +def user_data_dir(appname=None, appauthor=None, version=None, roaming=False): + r"""Return full path to the user-specific data dir for this application. + + "appname" is the name of application. + If None, just the system directory is returned. + "appauthor" (only used on Windows) is the name of the + appauthor or distributing body for this application. Typically + it is the owning company name. This falls back to appname. You may + pass False to disable it. + "version" is an optional version path element to append to the + path. You might want to use this if you want multiple versions + of your app to be able to run independently. If used, this + would typically be ".". + Only applied when appname is present. + "roaming" (boolean, default False) can be set True to use the Windows + roaming appdata directory. That means that for users on a Windows + network setup for roaming profiles, this user data will be + sync'd on login. See + + for a discussion of issues. + + Typical user data directories are: + Mac OS X: ~/Library/Application Support/ + Unix: ~/.local/share/ # or in $XDG_DATA_HOME, if defined + Win XP (not roaming): C:\Documents and Settings\\Application Data\\ + Win XP (roaming): C:\Documents and Settings\\Local Settings\Application Data\\ + Win 7 (not roaming): C:\Users\\AppData\Local\\ + Win 7 (roaming): C:\Users\\AppData\Roaming\\ + + For Unix, we follow the XDG spec and support $XDG_DATA_HOME. + That means, by default "~/.local/share/". + """ + if system == "win32": + if appauthor is None: + appauthor = appname + const = roaming and "CSIDL_APPDATA" or "CSIDL_LOCAL_APPDATA" + path = os.path.normpath(_get_win_folder(const)) + if appname: + if appauthor is not False: + path = os.path.join(path, appauthor, appname) + else: + path = os.path.join(path, appname) + elif system == 'darwin': + path = os.path.expanduser('~/Library/Application Support/') + if appname: + path = os.path.join(path, appname) + else: + path = os.getenv('XDG_DATA_HOME', os.path.expanduser("~/.local/share")) + if appname: + path = os.path.join(path, appname) + if appname and version: + path = os.path.join(path, version) + return path + + +def site_data_dir(appname=None, appauthor=None, version=None, multipath=False): + r"""Return full path to the user-shared data dir for this application. + + "appname" is the name of application. + If None, just the system directory is returned. + "appauthor" (only used on Windows) is the name of the + appauthor or distributing body for this application. Typically + it is the owning company name. This falls back to appname. You may + pass False to disable it. + "version" is an optional version path element to append to the + path. You might want to use this if you want multiple versions + of your app to be able to run independently. If used, this + would typically be ".". + Only applied when appname is present. + "multipath" is an optional parameter only applicable to *nix + which indicates that the entire list of data dirs should be + returned. By default, the first item from XDG_DATA_DIRS is + returned, or '/usr/local/share/', + if XDG_DATA_DIRS is not set + + Typical site data directories are: + Mac OS X: /Library/Application Support/ + Unix: /usr/local/share/ or /usr/share/ + Win XP: C:\Documents and Settings\All Users\Application Data\\ + Vista: (Fail! "C:\ProgramData" is a hidden *system* directory on Vista.) + Win 7: C:\ProgramData\\ # Hidden, but writeable on Win 7. + + For Unix, this is using the $XDG_DATA_DIRS[0] default. + + WARNING: Do not use this on Windows. See the Vista-Fail note above for why. + """ + if system == "win32": + if appauthor is None: + appauthor = appname + path = os.path.normpath(_get_win_folder("CSIDL_COMMON_APPDATA")) + if appname: + if appauthor is not False: + path = os.path.join(path, appauthor, appname) + else: + path = os.path.join(path, appname) + elif system == 'darwin': + path = os.path.expanduser('/Library/Application Support') + if appname: + path = os.path.join(path, appname) + else: + # XDG default for $XDG_DATA_DIRS + # only first, if multipath is False + path = os.getenv('XDG_DATA_DIRS', + os.pathsep.join(['/usr/local/share', '/usr/share'])) + pathlist = [os.path.expanduser(x.rstrip(os.sep)) for x in path.split(os.pathsep)] + if appname: + if version: + appname = os.path.join(appname, version) + pathlist = [os.sep.join([x, appname]) for x in pathlist] + + if multipath: + path = os.pathsep.join(pathlist) + else: + path = pathlist[0] + return path + + if appname and version: + path = os.path.join(path, version) + return path + + +def user_config_dir(appname=None, appauthor=None, version=None, roaming=False): + r"""Return full path to the user-specific config dir for this application. + + "appname" is the name of application. + If None, just the system directory is returned. + "appauthor" (only used on Windows) is the name of the + appauthor or distributing body for this application. Typically + it is the owning company name. This falls back to appname. You may + pass False to disable it. + "version" is an optional version path element to append to the + path. You might want to use this if you want multiple versions + of your app to be able to run independently. If used, this + would typically be ".". + Only applied when appname is present. + "roaming" (boolean, default False) can be set True to use the Windows + roaming appdata directory. That means that for users on a Windows + network setup for roaming profiles, this user data will be + sync'd on login. See + + for a discussion of issues. + + Typical user config directories are: + Mac OS X: same as user_data_dir + Unix: ~/.config/ # or in $XDG_CONFIG_HOME, if defined + Win *: same as user_data_dir + + For Unix, we follow the XDG spec and support $XDG_CONFIG_HOME. + That means, by default "~/.config/". + """ + if system in ["win32", "darwin"]: + path = user_data_dir(appname, appauthor, None, roaming) + else: + path = os.getenv('XDG_CONFIG_HOME', os.path.expanduser("~/.config")) + if appname: + path = os.path.join(path, appname) + if appname and version: + path = os.path.join(path, version) + return path + + +def site_config_dir(appname=None, appauthor=None, version=None, multipath=False): + r"""Return full path to the user-shared data dir for this application. + + "appname" is the name of application. + If None, just the system directory is returned. + "appauthor" (only used on Windows) is the name of the + appauthor or distributing body for this application. Typically + it is the owning company name. This falls back to appname. You may + pass False to disable it. + "version" is an optional version path element to append to the + path. You might want to use this if you want multiple versions + of your app to be able to run independently. If used, this + would typically be ".". + Only applied when appname is present. + "multipath" is an optional parameter only applicable to *nix + which indicates that the entire list of config dirs should be + returned. By default, the first item from XDG_CONFIG_DIRS is + returned, or '/etc/xdg/', if XDG_CONFIG_DIRS is not set + + Typical site config directories are: + Mac OS X: same as site_data_dir + Unix: /etc/xdg/ or $XDG_CONFIG_DIRS[i]/ for each value in + $XDG_CONFIG_DIRS + Win *: same as site_data_dir + Vista: (Fail! "C:\ProgramData" is a hidden *system* directory on Vista.) + + For Unix, this is using the $XDG_CONFIG_DIRS[0] default, if multipath=False + + WARNING: Do not use this on Windows. See the Vista-Fail note above for why. + """ + if system in ["win32", "darwin"]: + path = site_data_dir(appname, appauthor) + if appname and version: + path = os.path.join(path, version) + else: + # XDG default for $XDG_CONFIG_DIRS + # only first, if multipath is False + path = os.getenv('XDG_CONFIG_DIRS', '/etc/xdg') + pathlist = [os.path.expanduser(x.rstrip(os.sep)) for x in path.split(os.pathsep)] + if appname: + if version: + appname = os.path.join(appname, version) + pathlist = [os.sep.join([x, appname]) for x in pathlist] + + if multipath: + path = os.pathsep.join(pathlist) + else: + path = pathlist[0] + return path + + +def user_cache_dir(appname=None, appauthor=None, version=None, opinion=True): + r"""Return full path to the user-specific cache dir for this application. + + "appname" is the name of application. + If None, just the system directory is returned. + "appauthor" (only used on Windows) is the name of the + appauthor or distributing body for this application. Typically + it is the owning company name. This falls back to appname. You may + pass False to disable it. + "version" is an optional version path element to append to the + path. You might want to use this if you want multiple versions + of your app to be able to run independently. If used, this + would typically be ".". + Only applied when appname is present. + "opinion" (boolean) can be False to disable the appending of + "Cache" to the base app data dir for Windows. See + discussion below. + + Typical user cache directories are: + Mac OS X: ~/Library/Caches/ + Unix: ~/.cache/ (XDG default) + Win XP: C:\Documents and Settings\\Local Settings\Application Data\\\Cache + Vista: C:\Users\\AppData\Local\\\Cache + + On Windows the only suggestion in the MSDN docs is that local settings go in + the `CSIDL_LOCAL_APPDATA` directory. This is identical to the non-roaming + app data dir (the default returned by `user_data_dir` above). Apps typically + put cache data somewhere *under* the given dir here. Some examples: + ...\Mozilla\Firefox\Profiles\\Cache + ...\Acme\SuperApp\Cache\1.0 + OPINION: This function appends "Cache" to the `CSIDL_LOCAL_APPDATA` value. + This can be disabled with the `opinion=False` option. + """ + if system == "win32": + if appauthor is None: + appauthor = appname + path = os.path.normpath(_get_win_folder("CSIDL_LOCAL_APPDATA")) + if appname: + if appauthor is not False: + path = os.path.join(path, appauthor, appname) + else: + path = os.path.join(path, appname) + if opinion: + path = os.path.join(path, "Cache") + elif system == 'darwin': + path = os.path.expanduser('~/Library/Caches') + if appname: + path = os.path.join(path, appname) + else: + path = os.getenv('XDG_CACHE_HOME', os.path.expanduser('~/.cache')) + if appname: + path = os.path.join(path, appname) + if appname and version: + path = os.path.join(path, version) + return path + + +def user_state_dir(appname=None, appauthor=None, version=None, roaming=False): + r"""Return full path to the user-specific state dir for this application. + + "appname" is the name of application. + If None, just the system directory is returned. + "appauthor" (only used on Windows) is the name of the + appauthor or distributing body for this application. Typically + it is the owning company name. This falls back to appname. You may + pass False to disable it. + "version" is an optional version path element to append to the + path. You might want to use this if you want multiple versions + of your app to be able to run independently. If used, this + would typically be ".". + Only applied when appname is present. + "roaming" (boolean, default False) can be set True to use the Windows + roaming appdata directory. That means that for users on a Windows + network setup for roaming profiles, this user data will be + sync'd on login. See + + for a discussion of issues. + + Typical user state directories are: + Mac OS X: same as user_data_dir + Unix: ~/.local/state/ # or in $XDG_STATE_HOME, if defined + Win *: same as user_data_dir + + For Unix, we follow this Debian proposal + to extend the XDG spec and support $XDG_STATE_HOME. + + That means, by default "~/.local/state/". + """ + if system in ["win32", "darwin"]: + path = user_data_dir(appname, appauthor, None, roaming) + else: + path = os.getenv('XDG_STATE_HOME', os.path.expanduser("~/.local/state")) + if appname: + path = os.path.join(path, appname) + if appname and version: + path = os.path.join(path, version) + return path + + +def user_log_dir(appname=None, appauthor=None, version=None, opinion=True): + r"""Return full path to the user-specific log dir for this application. + + "appname" is the name of application. + If None, just the system directory is returned. + "appauthor" (only used on Windows) is the name of the + appauthor or distributing body for this application. Typically + it is the owning company name. This falls back to appname. You may + pass False to disable it. + "version" is an optional version path element to append to the + path. You might want to use this if you want multiple versions + of your app to be able to run independently. If used, this + would typically be ".". + Only applied when appname is present. + "opinion" (boolean) can be False to disable the appending of + "Logs" to the base app data dir for Windows, and "log" to the + base cache dir for Unix. See discussion below. + + Typical user log directories are: + Mac OS X: ~/Library/Logs/ + Unix: ~/.cache//log # or under $XDG_CACHE_HOME if defined + Win XP: C:\Documents and Settings\\Local Settings\Application Data\\\Logs + Vista: C:\Users\\AppData\Local\\\Logs + + On Windows the only suggestion in the MSDN docs is that local settings + go in the `CSIDL_LOCAL_APPDATA` directory. (Note: I'm interested in + examples of what some windows apps use for a logs dir.) + + OPINION: This function appends "Logs" to the `CSIDL_LOCAL_APPDATA` + value for Windows and appends "log" to the user cache dir for Unix. + This can be disabled with the `opinion=False` option. + """ + if system == "darwin": + path = os.path.join( + os.path.expanduser('~/Library/Logs'), + appname) + elif system == "win32": + path = user_data_dir(appname, appauthor, version) + version = False + if opinion: + path = os.path.join(path, "Logs") + else: + path = user_cache_dir(appname, appauthor, version) + version = False + if opinion: + path = os.path.join(path, "log") + if appname and version: + path = os.path.join(path, version) + return path + + +class AppDirs(object): + """Convenience wrapper for getting application dirs.""" + def __init__(self, appname=None, appauthor=None, version=None, + roaming=False, multipath=False): + self.appname = appname + self.appauthor = appauthor + self.version = version + self.roaming = roaming + self.multipath = multipath + + @property + def user_data_dir(self): + return user_data_dir(self.appname, self.appauthor, + version=self.version, roaming=self.roaming) + + @property + def site_data_dir(self): + return site_data_dir(self.appname, self.appauthor, + version=self.version, multipath=self.multipath) + + @property + def user_config_dir(self): + return user_config_dir(self.appname, self.appauthor, + version=self.version, roaming=self.roaming) + + @property + def site_config_dir(self): + return site_config_dir(self.appname, self.appauthor, + version=self.version, multipath=self.multipath) + + @property + def user_cache_dir(self): + return user_cache_dir(self.appname, self.appauthor, + version=self.version) + + @property + def user_state_dir(self): + return user_state_dir(self.appname, self.appauthor, + version=self.version) + + @property + def user_log_dir(self): + return user_log_dir(self.appname, self.appauthor, + version=self.version) + + +#---- internal support stuff + +def _get_win_folder_from_registry(csidl_name): + """This is a fallback technique at best. I'm not sure if using the + registry for this guarantees us the correct answer for all CSIDL_* + names. + """ + if PY3: + import winreg as _winreg + else: + import _winreg + + shell_folder_name = { + "CSIDL_APPDATA": "AppData", + "CSIDL_COMMON_APPDATA": "Common AppData", + "CSIDL_LOCAL_APPDATA": "Local AppData", + }[csidl_name] + + key = _winreg.OpenKey( + _winreg.HKEY_CURRENT_USER, + r"Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders" + ) + dir, type = _winreg.QueryValueEx(key, shell_folder_name) + return dir + + +def _get_win_folder_with_pywin32(csidl_name): + from win32com.shell import shellcon, shell + dir = shell.SHGetFolderPath(0, getattr(shellcon, csidl_name), 0, 0) + # Try to make this a unicode path because SHGetFolderPath does + # not return unicode strings when there is unicode data in the + # path. + try: + dir = unicode(dir) + + # Downgrade to short path name if have highbit chars. See + # . + has_high_char = False + for c in dir: + if ord(c) > 255: + has_high_char = True + break + if has_high_char: + try: + import win32api + dir = win32api.GetShortPathName(dir) + except ImportError: + pass + except UnicodeError: + pass + return dir + + +def _get_win_folder_with_ctypes(csidl_name): + import ctypes + + csidl_const = { + "CSIDL_APPDATA": 26, + "CSIDL_COMMON_APPDATA": 35, + "CSIDL_LOCAL_APPDATA": 28, + }[csidl_name] + + buf = ctypes.create_unicode_buffer(1024) + ctypes.windll.shell32.SHGetFolderPathW(None, csidl_const, None, 0, buf) + + # Downgrade to short path name if have highbit chars. See + # . + has_high_char = False + for c in buf: + if ord(c) > 255: + has_high_char = True + break + if has_high_char: + buf2 = ctypes.create_unicode_buffer(1024) + if ctypes.windll.kernel32.GetShortPathNameW(buf.value, buf2, 1024): + buf = buf2 + + return buf.value + +def _get_win_folder_with_jna(csidl_name): + import array + from com.sun import jna + from com.sun.jna.platform import win32 + + buf_size = win32.WinDef.MAX_PATH * 2 + buf = array.zeros('c', buf_size) + shell = win32.Shell32.INSTANCE + shell.SHGetFolderPath(None, getattr(win32.ShlObj, csidl_name), None, win32.ShlObj.SHGFP_TYPE_CURRENT, buf) + dir = jna.Native.toString(buf.tostring()).rstrip("\0") + + # Downgrade to short path name if have highbit chars. See + # . + has_high_char = False + for c in dir: + if ord(c) > 255: + has_high_char = True + break + if has_high_char: + buf = array.zeros('c', buf_size) + kernel = win32.Kernel32.INSTANCE + if kernel.GetShortPathName(dir, buf, buf_size): + dir = jna.Native.toString(buf.tostring()).rstrip("\0") + + return dir + +if system == "win32": + try: + import win32com.shell + _get_win_folder = _get_win_folder_with_pywin32 + except ImportError: + try: + from ctypes import windll + _get_win_folder = _get_win_folder_with_ctypes + except ImportError: + try: + import com.sun.jna + _get_win_folder = _get_win_folder_with_jna + except ImportError: + _get_win_folder = _get_win_folder_from_registry + + +#---- self test code + +if __name__ == "__main__": + appname = "MyApp" + appauthor = "MyCompany" + + props = ("user_data_dir", + "user_config_dir", + "user_cache_dir", + "user_state_dir", + "user_log_dir", + "site_data_dir", + "site_config_dir") + + print("-- app dirs %s --" % __version__) + + print("-- app dirs (with optional 'version')") + dirs = AppDirs(appname, appauthor, version="1.0") + for prop in props: + print("%s: %s" % (prop, getattr(dirs, prop))) + + print("\n-- app dirs (without optional 'version')") + dirs = AppDirs(appname, appauthor) + for prop in props: + print("%s: %s" % (prop, getattr(dirs, prop))) + + print("\n-- app dirs (without optional 'appauthor')") + dirs = AppDirs(appname) + for prop in props: + print("%s: %s" % (prop, getattr(dirs, prop))) + + print("\n-- app dirs (with disabled 'appauthor')") + dirs = AppDirs(appname, appauthor=False) + for prop in props: + print("%s: %s" % (prop, getattr(dirs, prop))) diff --git a/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/__about__.py b/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/__about__.py new file mode 100644 index 000000000..95d330ef8 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/__about__.py @@ -0,0 +1,21 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. +from __future__ import absolute_import, division, print_function + +__all__ = [ + "__title__", "__summary__", "__uri__", "__version__", "__author__", + "__email__", "__license__", "__copyright__", +] + +__title__ = "packaging" +__summary__ = "Core utilities for Python packages" +__uri__ = "https://github.com/pypa/packaging" + +__version__ = "16.8" + +__author__ = "Donald Stufft and individual contributors" +__email__ = "donald@stufft.io" + +__license__ = "BSD or Apache License, Version 2.0" +__copyright__ = "Copyright 2014-2016 %s" % __author__ diff --git a/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/__init__.py b/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/__init__.py new file mode 100644 index 000000000..5ee622020 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/__init__.py @@ -0,0 +1,14 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. +from __future__ import absolute_import, division, print_function + +from .__about__ import ( + __author__, __copyright__, __email__, __license__, __summary__, __title__, + __uri__, __version__ +) + +__all__ = [ + "__title__", "__summary__", "__uri__", "__version__", "__author__", + "__email__", "__license__", "__copyright__", +] diff --git a/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/_compat.py b/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/_compat.py new file mode 100644 index 000000000..210bb80b7 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/_compat.py @@ -0,0 +1,30 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. +from __future__ import absolute_import, division, print_function + +import sys + + +PY2 = sys.version_info[0] == 2 +PY3 = sys.version_info[0] == 3 + +# flake8: noqa + +if PY3: + string_types = str, +else: + string_types = basestring, + + +def with_metaclass(meta, *bases): + """ + Create a base class with a metaclass. + """ + # This requires a bit of explanation: the basic idea is to make a dummy + # metaclass for one level of class instantiation that replaces itself with + # the actual metaclass. + class metaclass(meta): + def __new__(cls, name, this_bases, d): + return meta(name, bases, d) + return type.__new__(metaclass, 'temporary_class', (), {}) diff --git a/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/_structures.py b/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/_structures.py new file mode 100644 index 000000000..ccc27861c --- /dev/null +++ b/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/_structures.py @@ -0,0 +1,68 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. +from __future__ import absolute_import, division, print_function + + +class Infinity(object): + + def __repr__(self): + return "Infinity" + + def __hash__(self): + return hash(repr(self)) + + def __lt__(self, other): + return False + + def __le__(self, other): + return False + + def __eq__(self, other): + return isinstance(other, self.__class__) + + def __ne__(self, other): + return not isinstance(other, self.__class__) + + def __gt__(self, other): + return True + + def __ge__(self, other): + return True + + def __neg__(self): + return NegativeInfinity + +Infinity = Infinity() + + +class NegativeInfinity(object): + + def __repr__(self): + return "-Infinity" + + def __hash__(self): + return hash(repr(self)) + + def __lt__(self, other): + return True + + def __le__(self, other): + return True + + def __eq__(self, other): + return isinstance(other, self.__class__) + + def __ne__(self, other): + return not isinstance(other, self.__class__) + + def __gt__(self, other): + return False + + def __ge__(self, other): + return False + + def __neg__(self): + return Infinity + +NegativeInfinity = NegativeInfinity() diff --git a/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/markers.py b/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/markers.py new file mode 100644 index 000000000..892e578ed --- /dev/null +++ b/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/markers.py @@ -0,0 +1,301 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. +from __future__ import absolute_import, division, print_function + +import operator +import os +import platform +import sys + +from pkg_resources.extern.pyparsing import ParseException, ParseResults, stringStart, stringEnd +from pkg_resources.extern.pyparsing import ZeroOrMore, Group, Forward, QuotedString +from pkg_resources.extern.pyparsing import Literal as L # noqa + +from ._compat import string_types +from .specifiers import Specifier, InvalidSpecifier + + +__all__ = [ + "InvalidMarker", "UndefinedComparison", "UndefinedEnvironmentName", + "Marker", "default_environment", +] + + +class InvalidMarker(ValueError): + """ + An invalid marker was found, users should refer to PEP 508. + """ + + +class UndefinedComparison(ValueError): + """ + An invalid operation was attempted on a value that doesn't support it. + """ + + +class UndefinedEnvironmentName(ValueError): + """ + A name was attempted to be used that does not exist inside of the + environment. + """ + + +class Node(object): + + def __init__(self, value): + self.value = value + + def __str__(self): + return str(self.value) + + def __repr__(self): + return "<{0}({1!r})>".format(self.__class__.__name__, str(self)) + + def serialize(self): + raise NotImplementedError + + +class Variable(Node): + + def serialize(self): + return str(self) + + +class Value(Node): + + def serialize(self): + return '"{0}"'.format(self) + + +class Op(Node): + + def serialize(self): + return str(self) + + +VARIABLE = ( + L("implementation_version") | + L("platform_python_implementation") | + L("implementation_name") | + L("python_full_version") | + L("platform_release") | + L("platform_version") | + L("platform_machine") | + L("platform_system") | + L("python_version") | + L("sys_platform") | + L("os_name") | + L("os.name") | # PEP-345 + L("sys.platform") | # PEP-345 + L("platform.version") | # PEP-345 + L("platform.machine") | # PEP-345 + L("platform.python_implementation") | # PEP-345 + L("python_implementation") | # undocumented setuptools legacy + L("extra") +) +ALIASES = { + 'os.name': 'os_name', + 'sys.platform': 'sys_platform', + 'platform.version': 'platform_version', + 'platform.machine': 'platform_machine', + 'platform.python_implementation': 'platform_python_implementation', + 'python_implementation': 'platform_python_implementation' +} +VARIABLE.setParseAction(lambda s, l, t: Variable(ALIASES.get(t[0], t[0]))) + +VERSION_CMP = ( + L("===") | + L("==") | + L(">=") | + L("<=") | + L("!=") | + L("~=") | + L(">") | + L("<") +) + +MARKER_OP = VERSION_CMP | L("not in") | L("in") +MARKER_OP.setParseAction(lambda s, l, t: Op(t[0])) + +MARKER_VALUE = QuotedString("'") | QuotedString('"') +MARKER_VALUE.setParseAction(lambda s, l, t: Value(t[0])) + +BOOLOP = L("and") | L("or") + +MARKER_VAR = VARIABLE | MARKER_VALUE + +MARKER_ITEM = Group(MARKER_VAR + MARKER_OP + MARKER_VAR) +MARKER_ITEM.setParseAction(lambda s, l, t: tuple(t[0])) + +LPAREN = L("(").suppress() +RPAREN = L(")").suppress() + +MARKER_EXPR = Forward() +MARKER_ATOM = MARKER_ITEM | Group(LPAREN + MARKER_EXPR + RPAREN) +MARKER_EXPR << MARKER_ATOM + ZeroOrMore(BOOLOP + MARKER_EXPR) + +MARKER = stringStart + MARKER_EXPR + stringEnd + + +def _coerce_parse_result(results): + if isinstance(results, ParseResults): + return [_coerce_parse_result(i) for i in results] + else: + return results + + +def _format_marker(marker, first=True): + assert isinstance(marker, (list, tuple, string_types)) + + # Sometimes we have a structure like [[...]] which is a single item list + # where the single item is itself it's own list. In that case we want skip + # the rest of this function so that we don't get extraneous () on the + # outside. + if (isinstance(marker, list) and len(marker) == 1 and + isinstance(marker[0], (list, tuple))): + return _format_marker(marker[0]) + + if isinstance(marker, list): + inner = (_format_marker(m, first=False) for m in marker) + if first: + return " ".join(inner) + else: + return "(" + " ".join(inner) + ")" + elif isinstance(marker, tuple): + return " ".join([m.serialize() for m in marker]) + else: + return marker + + +_operators = { + "in": lambda lhs, rhs: lhs in rhs, + "not in": lambda lhs, rhs: lhs not in rhs, + "<": operator.lt, + "<=": operator.le, + "==": operator.eq, + "!=": operator.ne, + ">=": operator.ge, + ">": operator.gt, +} + + +def _eval_op(lhs, op, rhs): + try: + spec = Specifier("".join([op.serialize(), rhs])) + except InvalidSpecifier: + pass + else: + return spec.contains(lhs) + + oper = _operators.get(op.serialize()) + if oper is None: + raise UndefinedComparison( + "Undefined {0!r} on {1!r} and {2!r}.".format(op, lhs, rhs) + ) + + return oper(lhs, rhs) + + +_undefined = object() + + +def _get_env(environment, name): + value = environment.get(name, _undefined) + + if value is _undefined: + raise UndefinedEnvironmentName( + "{0!r} does not exist in evaluation environment.".format(name) + ) + + return value + + +def _evaluate_markers(markers, environment): + groups = [[]] + + for marker in markers: + assert isinstance(marker, (list, tuple, string_types)) + + if isinstance(marker, list): + groups[-1].append(_evaluate_markers(marker, environment)) + elif isinstance(marker, tuple): + lhs, op, rhs = marker + + if isinstance(lhs, Variable): + lhs_value = _get_env(environment, lhs.value) + rhs_value = rhs.value + else: + lhs_value = lhs.value + rhs_value = _get_env(environment, rhs.value) + + groups[-1].append(_eval_op(lhs_value, op, rhs_value)) + else: + assert marker in ["and", "or"] + if marker == "or": + groups.append([]) + + return any(all(item) for item in groups) + + +def format_full_version(info): + version = '{0.major}.{0.minor}.{0.micro}'.format(info) + kind = info.releaselevel + if kind != 'final': + version += kind[0] + str(info.serial) + return version + + +def default_environment(): + if hasattr(sys, 'implementation'): + iver = format_full_version(sys.implementation.version) + implementation_name = sys.implementation.name + else: + iver = '0' + implementation_name = '' + + return { + "implementation_name": implementation_name, + "implementation_version": iver, + "os_name": os.name, + "platform_machine": platform.machine(), + "platform_release": platform.release(), + "platform_system": platform.system(), + "platform_version": platform.version(), + "python_full_version": platform.python_version(), + "platform_python_implementation": platform.python_implementation(), + "python_version": platform.python_version()[:3], + "sys_platform": sys.platform, + } + + +class Marker(object): + + def __init__(self, marker): + try: + self._markers = _coerce_parse_result(MARKER.parseString(marker)) + except ParseException as e: + err_str = "Invalid marker: {0!r}, parse error at {1!r}".format( + marker, marker[e.loc:e.loc + 8]) + raise InvalidMarker(err_str) + + def __str__(self): + return _format_marker(self._markers) + + def __repr__(self): + return "".format(str(self)) + + def evaluate(self, environment=None): + """Evaluate a marker. + + Return the boolean from evaluating the given marker against the + environment. environment is an optional argument to override all or + part of the determined environment. + + The environment is determined from the current Python process. + """ + current_environment = default_environment() + if environment is not None: + current_environment.update(environment) + + return _evaluate_markers(self._markers, current_environment) diff --git a/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/requirements.py b/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/requirements.py new file mode 100644 index 000000000..0c8c4a385 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/requirements.py @@ -0,0 +1,127 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. +from __future__ import absolute_import, division, print_function + +import string +import re + +from pkg_resources.extern.pyparsing import stringStart, stringEnd, originalTextFor, ParseException +from pkg_resources.extern.pyparsing import ZeroOrMore, Word, Optional, Regex, Combine +from pkg_resources.extern.pyparsing import Literal as L # noqa +from pkg_resources.extern.six.moves.urllib import parse as urlparse + +from .markers import MARKER_EXPR, Marker +from .specifiers import LegacySpecifier, Specifier, SpecifierSet + + +class InvalidRequirement(ValueError): + """ + An invalid requirement was found, users should refer to PEP 508. + """ + + +ALPHANUM = Word(string.ascii_letters + string.digits) + +LBRACKET = L("[").suppress() +RBRACKET = L("]").suppress() +LPAREN = L("(").suppress() +RPAREN = L(")").suppress() +COMMA = L(",").suppress() +SEMICOLON = L(";").suppress() +AT = L("@").suppress() + +PUNCTUATION = Word("-_.") +IDENTIFIER_END = ALPHANUM | (ZeroOrMore(PUNCTUATION) + ALPHANUM) +IDENTIFIER = Combine(ALPHANUM + ZeroOrMore(IDENTIFIER_END)) + +NAME = IDENTIFIER("name") +EXTRA = IDENTIFIER + +URI = Regex(r'[^ ]+')("url") +URL = (AT + URI) + +EXTRAS_LIST = EXTRA + ZeroOrMore(COMMA + EXTRA) +EXTRAS = (LBRACKET + Optional(EXTRAS_LIST) + RBRACKET)("extras") + +VERSION_PEP440 = Regex(Specifier._regex_str, re.VERBOSE | re.IGNORECASE) +VERSION_LEGACY = Regex(LegacySpecifier._regex_str, re.VERBOSE | re.IGNORECASE) + +VERSION_ONE = VERSION_PEP440 ^ VERSION_LEGACY +VERSION_MANY = Combine(VERSION_ONE + ZeroOrMore(COMMA + VERSION_ONE), + joinString=",", adjacent=False)("_raw_spec") +_VERSION_SPEC = Optional(((LPAREN + VERSION_MANY + RPAREN) | VERSION_MANY)) +_VERSION_SPEC.setParseAction(lambda s, l, t: t._raw_spec or '') + +VERSION_SPEC = originalTextFor(_VERSION_SPEC)("specifier") +VERSION_SPEC.setParseAction(lambda s, l, t: t[1]) + +MARKER_EXPR = originalTextFor(MARKER_EXPR())("marker") +MARKER_EXPR.setParseAction( + lambda s, l, t: Marker(s[t._original_start:t._original_end]) +) +MARKER_SEPERATOR = SEMICOLON +MARKER = MARKER_SEPERATOR + MARKER_EXPR + +VERSION_AND_MARKER = VERSION_SPEC + Optional(MARKER) +URL_AND_MARKER = URL + Optional(MARKER) + +NAMED_REQUIREMENT = \ + NAME + Optional(EXTRAS) + (URL_AND_MARKER | VERSION_AND_MARKER) + +REQUIREMENT = stringStart + NAMED_REQUIREMENT + stringEnd + + +class Requirement(object): + """Parse a requirement. + + Parse a given requirement string into its parts, such as name, specifier, + URL, and extras. Raises InvalidRequirement on a badly-formed requirement + string. + """ + + # TODO: Can we test whether something is contained within a requirement? + # If so how do we do that? Do we need to test against the _name_ of + # the thing as well as the version? What about the markers? + # TODO: Can we normalize the name and extra name? + + def __init__(self, requirement_string): + try: + req = REQUIREMENT.parseString(requirement_string) + except ParseException as e: + raise InvalidRequirement( + "Invalid requirement, parse error at \"{0!r}\"".format( + requirement_string[e.loc:e.loc + 8])) + + self.name = req.name + if req.url: + parsed_url = urlparse.urlparse(req.url) + if not (parsed_url.scheme and parsed_url.netloc) or ( + not parsed_url.scheme and not parsed_url.netloc): + raise InvalidRequirement("Invalid URL given") + self.url = req.url + else: + self.url = None + self.extras = set(req.extras.asList() if req.extras else []) + self.specifier = SpecifierSet(req.specifier) + self.marker = req.marker if req.marker else None + + def __str__(self): + parts = [self.name] + + if self.extras: + parts.append("[{0}]".format(",".join(sorted(self.extras)))) + + if self.specifier: + parts.append(str(self.specifier)) + + if self.url: + parts.append("@ {0}".format(self.url)) + + if self.marker: + parts.append("; {0}".format(self.marker)) + + return "".join(parts) + + def __repr__(self): + return "".format(str(self)) diff --git a/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/specifiers.py b/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/specifiers.py new file mode 100644 index 000000000..7f5a76cfd --- /dev/null +++ b/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/specifiers.py @@ -0,0 +1,774 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. +from __future__ import absolute_import, division, print_function + +import abc +import functools +import itertools +import re + +from ._compat import string_types, with_metaclass +from .version import Version, LegacyVersion, parse + + +class InvalidSpecifier(ValueError): + """ + An invalid specifier was found, users should refer to PEP 440. + """ + + +class BaseSpecifier(with_metaclass(abc.ABCMeta, object)): + + @abc.abstractmethod + def __str__(self): + """ + Returns the str representation of this Specifier like object. This + should be representative of the Specifier itself. + """ + + @abc.abstractmethod + def __hash__(self): + """ + Returns a hash value for this Specifier like object. + """ + + @abc.abstractmethod + def __eq__(self, other): + """ + Returns a boolean representing whether or not the two Specifier like + objects are equal. + """ + + @abc.abstractmethod + def __ne__(self, other): + """ + Returns a boolean representing whether or not the two Specifier like + objects are not equal. + """ + + @abc.abstractproperty + def prereleases(self): + """ + Returns whether or not pre-releases as a whole are allowed by this + specifier. + """ + + @prereleases.setter + def prereleases(self, value): + """ + Sets whether or not pre-releases as a whole are allowed by this + specifier. + """ + + @abc.abstractmethod + def contains(self, item, prereleases=None): + """ + Determines if the given item is contained within this specifier. + """ + + @abc.abstractmethod + def filter(self, iterable, prereleases=None): + """ + Takes an iterable of items and filters them so that only items which + are contained within this specifier are allowed in it. + """ + + +class _IndividualSpecifier(BaseSpecifier): + + _operators = {} + + def __init__(self, spec="", prereleases=None): + match = self._regex.search(spec) + if not match: + raise InvalidSpecifier("Invalid specifier: '{0}'".format(spec)) + + self._spec = ( + match.group("operator").strip(), + match.group("version").strip(), + ) + + # Store whether or not this Specifier should accept prereleases + self._prereleases = prereleases + + def __repr__(self): + pre = ( + ", prereleases={0!r}".format(self.prereleases) + if self._prereleases is not None + else "" + ) + + return "<{0}({1!r}{2})>".format( + self.__class__.__name__, + str(self), + pre, + ) + + def __str__(self): + return "{0}{1}".format(*self._spec) + + def __hash__(self): + return hash(self._spec) + + def __eq__(self, other): + if isinstance(other, string_types): + try: + other = self.__class__(other) + except InvalidSpecifier: + return NotImplemented + elif not isinstance(other, self.__class__): + return NotImplemented + + return self._spec == other._spec + + def __ne__(self, other): + if isinstance(other, string_types): + try: + other = self.__class__(other) + except InvalidSpecifier: + return NotImplemented + elif not isinstance(other, self.__class__): + return NotImplemented + + return self._spec != other._spec + + def _get_operator(self, op): + return getattr(self, "_compare_{0}".format(self._operators[op])) + + def _coerce_version(self, version): + if not isinstance(version, (LegacyVersion, Version)): + version = parse(version) + return version + + @property + def operator(self): + return self._spec[0] + + @property + def version(self): + return self._spec[1] + + @property + def prereleases(self): + return self._prereleases + + @prereleases.setter + def prereleases(self, value): + self._prereleases = value + + def __contains__(self, item): + return self.contains(item) + + def contains(self, item, prereleases=None): + # Determine if prereleases are to be allowed or not. + if prereleases is None: + prereleases = self.prereleases + + # Normalize item to a Version or LegacyVersion, this allows us to have + # a shortcut for ``"2.0" in Specifier(">=2") + item = self._coerce_version(item) + + # Determine if we should be supporting prereleases in this specifier + # or not, if we do not support prereleases than we can short circuit + # logic if this version is a prereleases. + if item.is_prerelease and not prereleases: + return False + + # Actually do the comparison to determine if this item is contained + # within this Specifier or not. + return self._get_operator(self.operator)(item, self.version) + + def filter(self, iterable, prereleases=None): + yielded = False + found_prereleases = [] + + kw = {"prereleases": prereleases if prereleases is not None else True} + + # Attempt to iterate over all the values in the iterable and if any of + # them match, yield them. + for version in iterable: + parsed_version = self._coerce_version(version) + + if self.contains(parsed_version, **kw): + # If our version is a prerelease, and we were not set to allow + # prereleases, then we'll store it for later incase nothing + # else matches this specifier. + if (parsed_version.is_prerelease and not + (prereleases or self.prereleases)): + found_prereleases.append(version) + # Either this is not a prerelease, or we should have been + # accepting prereleases from the begining. + else: + yielded = True + yield version + + # Now that we've iterated over everything, determine if we've yielded + # any values, and if we have not and we have any prereleases stored up + # then we will go ahead and yield the prereleases. + if not yielded and found_prereleases: + for version in found_prereleases: + yield version + + +class LegacySpecifier(_IndividualSpecifier): + + _regex_str = ( + r""" + (?P(==|!=|<=|>=|<|>)) + \s* + (?P + [^,;\s)]* # Since this is a "legacy" specifier, and the version + # string can be just about anything, we match everything + # except for whitespace, a semi-colon for marker support, + # a closing paren since versions can be enclosed in + # them, and a comma since it's a version separator. + ) + """ + ) + + _regex = re.compile( + r"^\s*" + _regex_str + r"\s*$", re.VERBOSE | re.IGNORECASE) + + _operators = { + "==": "equal", + "!=": "not_equal", + "<=": "less_than_equal", + ">=": "greater_than_equal", + "<": "less_than", + ">": "greater_than", + } + + def _coerce_version(self, version): + if not isinstance(version, LegacyVersion): + version = LegacyVersion(str(version)) + return version + + def _compare_equal(self, prospective, spec): + return prospective == self._coerce_version(spec) + + def _compare_not_equal(self, prospective, spec): + return prospective != self._coerce_version(spec) + + def _compare_less_than_equal(self, prospective, spec): + return prospective <= self._coerce_version(spec) + + def _compare_greater_than_equal(self, prospective, spec): + return prospective >= self._coerce_version(spec) + + def _compare_less_than(self, prospective, spec): + return prospective < self._coerce_version(spec) + + def _compare_greater_than(self, prospective, spec): + return prospective > self._coerce_version(spec) + + +def _require_version_compare(fn): + @functools.wraps(fn) + def wrapped(self, prospective, spec): + if not isinstance(prospective, Version): + return False + return fn(self, prospective, spec) + return wrapped + + +class Specifier(_IndividualSpecifier): + + _regex_str = ( + r""" + (?P(~=|==|!=|<=|>=|<|>|===)) + (?P + (?: + # The identity operators allow for an escape hatch that will + # do an exact string match of the version you wish to install. + # This will not be parsed by PEP 440 and we cannot determine + # any semantic meaning from it. This operator is discouraged + # but included entirely as an escape hatch. + (?<====) # Only match for the identity operator + \s* + [^\s]* # We just match everything, except for whitespace + # since we are only testing for strict identity. + ) + | + (?: + # The (non)equality operators allow for wild card and local + # versions to be specified so we have to define these two + # operators separately to enable that. + (?<===|!=) # Only match for equals and not equals + + \s* + v? + (?:[0-9]+!)? # epoch + [0-9]+(?:\.[0-9]+)* # release + (?: # pre release + [-_\.]? + (a|b|c|rc|alpha|beta|pre|preview) + [-_\.]? + [0-9]* + )? + (?: # post release + (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*) + )? + + # You cannot use a wild card and a dev or local version + # together so group them with a | and make them optional. + (?: + (?:[-_\.]?dev[-_\.]?[0-9]*)? # dev release + (?:\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*)? # local + | + \.\* # Wild card syntax of .* + )? + ) + | + (?: + # The compatible operator requires at least two digits in the + # release segment. + (?<=~=) # Only match for the compatible operator + + \s* + v? + (?:[0-9]+!)? # epoch + [0-9]+(?:\.[0-9]+)+ # release (We have a + instead of a *) + (?: # pre release + [-_\.]? + (a|b|c|rc|alpha|beta|pre|preview) + [-_\.]? + [0-9]* + )? + (?: # post release + (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*) + )? + (?:[-_\.]?dev[-_\.]?[0-9]*)? # dev release + ) + | + (?: + # All other operators only allow a sub set of what the + # (non)equality operators do. Specifically they do not allow + # local versions to be specified nor do they allow the prefix + # matching wild cards. + (?=": "greater_than_equal", + "<": "less_than", + ">": "greater_than", + "===": "arbitrary", + } + + @_require_version_compare + def _compare_compatible(self, prospective, spec): + # Compatible releases have an equivalent combination of >= and ==. That + # is that ~=2.2 is equivalent to >=2.2,==2.*. This allows us to + # implement this in terms of the other specifiers instead of + # implementing it ourselves. The only thing we need to do is construct + # the other specifiers. + + # We want everything but the last item in the version, but we want to + # ignore post and dev releases and we want to treat the pre-release as + # it's own separate segment. + prefix = ".".join( + list( + itertools.takewhile( + lambda x: (not x.startswith("post") and not + x.startswith("dev")), + _version_split(spec), + ) + )[:-1] + ) + + # Add the prefix notation to the end of our string + prefix += ".*" + + return (self._get_operator(">=")(prospective, spec) and + self._get_operator("==")(prospective, prefix)) + + @_require_version_compare + def _compare_equal(self, prospective, spec): + # We need special logic to handle prefix matching + if spec.endswith(".*"): + # In the case of prefix matching we want to ignore local segment. + prospective = Version(prospective.public) + # Split the spec out by dots, and pretend that there is an implicit + # dot in between a release segment and a pre-release segment. + spec = _version_split(spec[:-2]) # Remove the trailing .* + + # Split the prospective version out by dots, and pretend that there + # is an implicit dot in between a release segment and a pre-release + # segment. + prospective = _version_split(str(prospective)) + + # Shorten the prospective version to be the same length as the spec + # so that we can determine if the specifier is a prefix of the + # prospective version or not. + prospective = prospective[:len(spec)] + + # Pad out our two sides with zeros so that they both equal the same + # length. + spec, prospective = _pad_version(spec, prospective) + else: + # Convert our spec string into a Version + spec = Version(spec) + + # If the specifier does not have a local segment, then we want to + # act as if the prospective version also does not have a local + # segment. + if not spec.local: + prospective = Version(prospective.public) + + return prospective == spec + + @_require_version_compare + def _compare_not_equal(self, prospective, spec): + return not self._compare_equal(prospective, spec) + + @_require_version_compare + def _compare_less_than_equal(self, prospective, spec): + return prospective <= Version(spec) + + @_require_version_compare + def _compare_greater_than_equal(self, prospective, spec): + return prospective >= Version(spec) + + @_require_version_compare + def _compare_less_than(self, prospective, spec): + # Convert our spec to a Version instance, since we'll want to work with + # it as a version. + spec = Version(spec) + + # Check to see if the prospective version is less than the spec + # version. If it's not we can short circuit and just return False now + # instead of doing extra unneeded work. + if not prospective < spec: + return False + + # This special case is here so that, unless the specifier itself + # includes is a pre-release version, that we do not accept pre-release + # versions for the version mentioned in the specifier (e.g. <3.1 should + # not match 3.1.dev0, but should match 3.0.dev0). + if not spec.is_prerelease and prospective.is_prerelease: + if Version(prospective.base_version) == Version(spec.base_version): + return False + + # If we've gotten to here, it means that prospective version is both + # less than the spec version *and* it's not a pre-release of the same + # version in the spec. + return True + + @_require_version_compare + def _compare_greater_than(self, prospective, spec): + # Convert our spec to a Version instance, since we'll want to work with + # it as a version. + spec = Version(spec) + + # Check to see if the prospective version is greater than the spec + # version. If it's not we can short circuit and just return False now + # instead of doing extra unneeded work. + if not prospective > spec: + return False + + # This special case is here so that, unless the specifier itself + # includes is a post-release version, that we do not accept + # post-release versions for the version mentioned in the specifier + # (e.g. >3.1 should not match 3.0.post0, but should match 3.2.post0). + if not spec.is_postrelease and prospective.is_postrelease: + if Version(prospective.base_version) == Version(spec.base_version): + return False + + # Ensure that we do not allow a local version of the version mentioned + # in the specifier, which is techincally greater than, to match. + if prospective.local is not None: + if Version(prospective.base_version) == Version(spec.base_version): + return False + + # If we've gotten to here, it means that prospective version is both + # greater than the spec version *and* it's not a pre-release of the + # same version in the spec. + return True + + def _compare_arbitrary(self, prospective, spec): + return str(prospective).lower() == str(spec).lower() + + @property + def prereleases(self): + # If there is an explicit prereleases set for this, then we'll just + # blindly use that. + if self._prereleases is not None: + return self._prereleases + + # Look at all of our specifiers and determine if they are inclusive + # operators, and if they are if they are including an explicit + # prerelease. + operator, version = self._spec + if operator in ["==", ">=", "<=", "~=", "==="]: + # The == specifier can include a trailing .*, if it does we + # want to remove before parsing. + if operator == "==" and version.endswith(".*"): + version = version[:-2] + + # Parse the version, and if it is a pre-release than this + # specifier allows pre-releases. + if parse(version).is_prerelease: + return True + + return False + + @prereleases.setter + def prereleases(self, value): + self._prereleases = value + + +_prefix_regex = re.compile(r"^([0-9]+)((?:a|b|c|rc)[0-9]+)$") + + +def _version_split(version): + result = [] + for item in version.split("."): + match = _prefix_regex.search(item) + if match: + result.extend(match.groups()) + else: + result.append(item) + return result + + +def _pad_version(left, right): + left_split, right_split = [], [] + + # Get the release segment of our versions + left_split.append(list(itertools.takewhile(lambda x: x.isdigit(), left))) + right_split.append(list(itertools.takewhile(lambda x: x.isdigit(), right))) + + # Get the rest of our versions + left_split.append(left[len(left_split[0]):]) + right_split.append(right[len(right_split[0]):]) + + # Insert our padding + left_split.insert( + 1, + ["0"] * max(0, len(right_split[0]) - len(left_split[0])), + ) + right_split.insert( + 1, + ["0"] * max(0, len(left_split[0]) - len(right_split[0])), + ) + + return ( + list(itertools.chain(*left_split)), + list(itertools.chain(*right_split)), + ) + + +class SpecifierSet(BaseSpecifier): + + def __init__(self, specifiers="", prereleases=None): + # Split on , to break each indidivual specifier into it's own item, and + # strip each item to remove leading/trailing whitespace. + specifiers = [s.strip() for s in specifiers.split(",") if s.strip()] + + # Parsed each individual specifier, attempting first to make it a + # Specifier and falling back to a LegacySpecifier. + parsed = set() + for specifier in specifiers: + try: + parsed.add(Specifier(specifier)) + except InvalidSpecifier: + parsed.add(LegacySpecifier(specifier)) + + # Turn our parsed specifiers into a frozen set and save them for later. + self._specs = frozenset(parsed) + + # Store our prereleases value so we can use it later to determine if + # we accept prereleases or not. + self._prereleases = prereleases + + def __repr__(self): + pre = ( + ", prereleases={0!r}".format(self.prereleases) + if self._prereleases is not None + else "" + ) + + return "".format(str(self), pre) + + def __str__(self): + return ",".join(sorted(str(s) for s in self._specs)) + + def __hash__(self): + return hash(self._specs) + + def __and__(self, other): + if isinstance(other, string_types): + other = SpecifierSet(other) + elif not isinstance(other, SpecifierSet): + return NotImplemented + + specifier = SpecifierSet() + specifier._specs = frozenset(self._specs | other._specs) + + if self._prereleases is None and other._prereleases is not None: + specifier._prereleases = other._prereleases + elif self._prereleases is not None and other._prereleases is None: + specifier._prereleases = self._prereleases + elif self._prereleases == other._prereleases: + specifier._prereleases = self._prereleases + else: + raise ValueError( + "Cannot combine SpecifierSets with True and False prerelease " + "overrides." + ) + + return specifier + + def __eq__(self, other): + if isinstance(other, string_types): + other = SpecifierSet(other) + elif isinstance(other, _IndividualSpecifier): + other = SpecifierSet(str(other)) + elif not isinstance(other, SpecifierSet): + return NotImplemented + + return self._specs == other._specs + + def __ne__(self, other): + if isinstance(other, string_types): + other = SpecifierSet(other) + elif isinstance(other, _IndividualSpecifier): + other = SpecifierSet(str(other)) + elif not isinstance(other, SpecifierSet): + return NotImplemented + + return self._specs != other._specs + + def __len__(self): + return len(self._specs) + + def __iter__(self): + return iter(self._specs) + + @property + def prereleases(self): + # If we have been given an explicit prerelease modifier, then we'll + # pass that through here. + if self._prereleases is not None: + return self._prereleases + + # If we don't have any specifiers, and we don't have a forced value, + # then we'll just return None since we don't know if this should have + # pre-releases or not. + if not self._specs: + return None + + # Otherwise we'll see if any of the given specifiers accept + # prereleases, if any of them do we'll return True, otherwise False. + return any(s.prereleases for s in self._specs) + + @prereleases.setter + def prereleases(self, value): + self._prereleases = value + + def __contains__(self, item): + return self.contains(item) + + def contains(self, item, prereleases=None): + # Ensure that our item is a Version or LegacyVersion instance. + if not isinstance(item, (LegacyVersion, Version)): + item = parse(item) + + # Determine if we're forcing a prerelease or not, if we're not forcing + # one for this particular filter call, then we'll use whatever the + # SpecifierSet thinks for whether or not we should support prereleases. + if prereleases is None: + prereleases = self.prereleases + + # We can determine if we're going to allow pre-releases by looking to + # see if any of the underlying items supports them. If none of them do + # and this item is a pre-release then we do not allow it and we can + # short circuit that here. + # Note: This means that 1.0.dev1 would not be contained in something + # like >=1.0.devabc however it would be in >=1.0.debabc,>0.0.dev0 + if not prereleases and item.is_prerelease: + return False + + # We simply dispatch to the underlying specs here to make sure that the + # given version is contained within all of them. + # Note: This use of all() here means that an empty set of specifiers + # will always return True, this is an explicit design decision. + return all( + s.contains(item, prereleases=prereleases) + for s in self._specs + ) + + def filter(self, iterable, prereleases=None): + # Determine if we're forcing a prerelease or not, if we're not forcing + # one for this particular filter call, then we'll use whatever the + # SpecifierSet thinks for whether or not we should support prereleases. + if prereleases is None: + prereleases = self.prereleases + + # If we have any specifiers, then we want to wrap our iterable in the + # filter method for each one, this will act as a logical AND amongst + # each specifier. + if self._specs: + for spec in self._specs: + iterable = spec.filter(iterable, prereleases=bool(prereleases)) + return iterable + # If we do not have any specifiers, then we need to have a rough filter + # which will filter out any pre-releases, unless there are no final + # releases, and which will filter out LegacyVersion in general. + else: + filtered = [] + found_prereleases = [] + + for item in iterable: + # Ensure that we some kind of Version class for this item. + if not isinstance(item, (LegacyVersion, Version)): + parsed_version = parse(item) + else: + parsed_version = item + + # Filter out any item which is parsed as a LegacyVersion + if isinstance(parsed_version, LegacyVersion): + continue + + # Store any item which is a pre-release for later unless we've + # already found a final version or we are accepting prereleases + if parsed_version.is_prerelease and not prereleases: + if not filtered: + found_prereleases.append(item) + else: + filtered.append(item) + + # If we've found no items except for pre-releases, then we'll go + # ahead and use the pre-releases + if not filtered and found_prereleases and prereleases is None: + return found_prereleases + + return filtered diff --git a/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/utils.py b/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/utils.py new file mode 100644 index 000000000..942387cef --- /dev/null +++ b/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/utils.py @@ -0,0 +1,14 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. +from __future__ import absolute_import, division, print_function + +import re + + +_canonicalize_regex = re.compile(r"[-_.]+") + + +def canonicalize_name(name): + # This is taken from PEP 503. + return _canonicalize_regex.sub("-", name).lower() diff --git a/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/version.py b/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/version.py new file mode 100644 index 000000000..83b5ee8c5 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/version.py @@ -0,0 +1,393 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. +from __future__ import absolute_import, division, print_function + +import collections +import itertools +import re + +from ._structures import Infinity + + +__all__ = [ + "parse", "Version", "LegacyVersion", "InvalidVersion", "VERSION_PATTERN" +] + + +_Version = collections.namedtuple( + "_Version", + ["epoch", "release", "dev", "pre", "post", "local"], +) + + +def parse(version): + """ + Parse the given version string and return either a :class:`Version` object + or a :class:`LegacyVersion` object depending on if the given version is + a valid PEP 440 version or a legacy version. + """ + try: + return Version(version) + except InvalidVersion: + return LegacyVersion(version) + + +class InvalidVersion(ValueError): + """ + An invalid version was found, users should refer to PEP 440. + """ + + +class _BaseVersion(object): + + def __hash__(self): + return hash(self._key) + + def __lt__(self, other): + return self._compare(other, lambda s, o: s < o) + + def __le__(self, other): + return self._compare(other, lambda s, o: s <= o) + + def __eq__(self, other): + return self._compare(other, lambda s, o: s == o) + + def __ge__(self, other): + return self._compare(other, lambda s, o: s >= o) + + def __gt__(self, other): + return self._compare(other, lambda s, o: s > o) + + def __ne__(self, other): + return self._compare(other, lambda s, o: s != o) + + def _compare(self, other, method): + if not isinstance(other, _BaseVersion): + return NotImplemented + + return method(self._key, other._key) + + +class LegacyVersion(_BaseVersion): + + def __init__(self, version): + self._version = str(version) + self._key = _legacy_cmpkey(self._version) + + def __str__(self): + return self._version + + def __repr__(self): + return "".format(repr(str(self))) + + @property + def public(self): + return self._version + + @property + def base_version(self): + return self._version + + @property + def local(self): + return None + + @property + def is_prerelease(self): + return False + + @property + def is_postrelease(self): + return False + + +_legacy_version_component_re = re.compile( + r"(\d+ | [a-z]+ | \.| -)", re.VERBOSE, +) + +_legacy_version_replacement_map = { + "pre": "c", "preview": "c", "-": "final-", "rc": "c", "dev": "@", +} + + +def _parse_version_parts(s): + for part in _legacy_version_component_re.split(s): + part = _legacy_version_replacement_map.get(part, part) + + if not part or part == ".": + continue + + if part[:1] in "0123456789": + # pad for numeric comparison + yield part.zfill(8) + else: + yield "*" + part + + # ensure that alpha/beta/candidate are before final + yield "*final" + + +def _legacy_cmpkey(version): + # We hardcode an epoch of -1 here. A PEP 440 version can only have a epoch + # greater than or equal to 0. This will effectively put the LegacyVersion, + # which uses the defacto standard originally implemented by setuptools, + # as before all PEP 440 versions. + epoch = -1 + + # This scheme is taken from pkg_resources.parse_version setuptools prior to + # it's adoption of the packaging library. + parts = [] + for part in _parse_version_parts(version.lower()): + if part.startswith("*"): + # remove "-" before a prerelease tag + if part < "*final": + while parts and parts[-1] == "*final-": + parts.pop() + + # remove trailing zeros from each series of numeric parts + while parts and parts[-1] == "00000000": + parts.pop() + + parts.append(part) + parts = tuple(parts) + + return epoch, parts + +# Deliberately not anchored to the start and end of the string, to make it +# easier for 3rd party code to reuse +VERSION_PATTERN = r""" + v? + (?: + (?:(?P[0-9]+)!)? # epoch + (?P[0-9]+(?:\.[0-9]+)*) # release segment + (?P
                                          # pre-release
+            [-_\.]?
+            (?P(a|b|c|rc|alpha|beta|pre|preview))
+            [-_\.]?
+            (?P[0-9]+)?
+        )?
+        (?P                                         # post release
+            (?:-(?P[0-9]+))
+            |
+            (?:
+                [-_\.]?
+                (?Ppost|rev|r)
+                [-_\.]?
+                (?P[0-9]+)?
+            )
+        )?
+        (?P                                          # dev release
+            [-_\.]?
+            (?Pdev)
+            [-_\.]?
+            (?P[0-9]+)?
+        )?
+    )
+    (?:\+(?P[a-z0-9]+(?:[-_\.][a-z0-9]+)*))?       # local version
+"""
+
+
+class Version(_BaseVersion):
+
+    _regex = re.compile(
+        r"^\s*" + VERSION_PATTERN + r"\s*$",
+        re.VERBOSE | re.IGNORECASE,
+    )
+
+    def __init__(self, version):
+        # Validate the version and parse it into pieces
+        match = self._regex.search(version)
+        if not match:
+            raise InvalidVersion("Invalid version: '{0}'".format(version))
+
+        # Store the parsed out pieces of the version
+        self._version = _Version(
+            epoch=int(match.group("epoch")) if match.group("epoch") else 0,
+            release=tuple(int(i) for i in match.group("release").split(".")),
+            pre=_parse_letter_version(
+                match.group("pre_l"),
+                match.group("pre_n"),
+            ),
+            post=_parse_letter_version(
+                match.group("post_l"),
+                match.group("post_n1") or match.group("post_n2"),
+            ),
+            dev=_parse_letter_version(
+                match.group("dev_l"),
+                match.group("dev_n"),
+            ),
+            local=_parse_local_version(match.group("local")),
+        )
+
+        # Generate a key which will be used for sorting
+        self._key = _cmpkey(
+            self._version.epoch,
+            self._version.release,
+            self._version.pre,
+            self._version.post,
+            self._version.dev,
+            self._version.local,
+        )
+
+    def __repr__(self):
+        return "".format(repr(str(self)))
+
+    def __str__(self):
+        parts = []
+
+        # Epoch
+        if self._version.epoch != 0:
+            parts.append("{0}!".format(self._version.epoch))
+
+        # Release segment
+        parts.append(".".join(str(x) for x in self._version.release))
+
+        # Pre-release
+        if self._version.pre is not None:
+            parts.append("".join(str(x) for x in self._version.pre))
+
+        # Post-release
+        if self._version.post is not None:
+            parts.append(".post{0}".format(self._version.post[1]))
+
+        # Development release
+        if self._version.dev is not None:
+            parts.append(".dev{0}".format(self._version.dev[1]))
+
+        # Local version segment
+        if self._version.local is not None:
+            parts.append(
+                "+{0}".format(".".join(str(x) for x in self._version.local))
+            )
+
+        return "".join(parts)
+
+    @property
+    def public(self):
+        return str(self).split("+", 1)[0]
+
+    @property
+    def base_version(self):
+        parts = []
+
+        # Epoch
+        if self._version.epoch != 0:
+            parts.append("{0}!".format(self._version.epoch))
+
+        # Release segment
+        parts.append(".".join(str(x) for x in self._version.release))
+
+        return "".join(parts)
+
+    @property
+    def local(self):
+        version_string = str(self)
+        if "+" in version_string:
+            return version_string.split("+", 1)[1]
+
+    @property
+    def is_prerelease(self):
+        return bool(self._version.dev or self._version.pre)
+
+    @property
+    def is_postrelease(self):
+        return bool(self._version.post)
+
+
+def _parse_letter_version(letter, number):
+    if letter:
+        # We consider there to be an implicit 0 in a pre-release if there is
+        # not a numeral associated with it.
+        if number is None:
+            number = 0
+
+        # We normalize any letters to their lower case form
+        letter = letter.lower()
+
+        # We consider some words to be alternate spellings of other words and
+        # in those cases we want to normalize the spellings to our preferred
+        # spelling.
+        if letter == "alpha":
+            letter = "a"
+        elif letter == "beta":
+            letter = "b"
+        elif letter in ["c", "pre", "preview"]:
+            letter = "rc"
+        elif letter in ["rev", "r"]:
+            letter = "post"
+
+        return letter, int(number)
+    if not letter and number:
+        # We assume if we are given a number, but we are not given a letter
+        # then this is using the implicit post release syntax (e.g. 1.0-1)
+        letter = "post"
+
+        return letter, int(number)
+
+
+_local_version_seperators = re.compile(r"[\._-]")
+
+
+def _parse_local_version(local):
+    """
+    Takes a string like abc.1.twelve and turns it into ("abc", 1, "twelve").
+    """
+    if local is not None:
+        return tuple(
+            part.lower() if not part.isdigit() else int(part)
+            for part in _local_version_seperators.split(local)
+        )
+
+
+def _cmpkey(epoch, release, pre, post, dev, local):
+    # When we compare a release version, we want to compare it with all of the
+    # trailing zeros removed. So we'll use a reverse the list, drop all the now
+    # leading zeros until we come to something non zero, then take the rest
+    # re-reverse it back into the correct order and make it a tuple and use
+    # that for our sorting key.
+    release = tuple(
+        reversed(list(
+            itertools.dropwhile(
+                lambda x: x == 0,
+                reversed(release),
+            )
+        ))
+    )
+
+    # We need to "trick" the sorting algorithm to put 1.0.dev0 before 1.0a0.
+    # We'll do this by abusing the pre segment, but we _only_ want to do this
+    # if there is not a pre or a post segment. If we have one of those then
+    # the normal sorting rules will handle this case correctly.
+    if pre is None and post is None and dev is not None:
+        pre = -Infinity
+    # Versions without a pre-release (except as noted above) should sort after
+    # those with one.
+    elif pre is None:
+        pre = Infinity
+
+    # Versions without a post segment should sort before those with one.
+    if post is None:
+        post = -Infinity
+
+    # Versions without a development segment should sort after those with one.
+    if dev is None:
+        dev = Infinity
+
+    if local is None:
+        # Versions without a local segment should sort before those with one.
+        local = -Infinity
+    else:
+        # Versions with a local segment need that segment parsed to implement
+        # the sorting rules in PEP440.
+        # - Alpha numeric segments sort before numeric segments
+        # - Alpha numeric segments sort lexicographically
+        # - Numeric segments sort numerically
+        # - Shorter versions sort before longer versions when the prefixes
+        #   match exactly
+        local = tuple(
+            (i, "") if isinstance(i, int) else (-Infinity, i)
+            for i in local
+        )
+
+    return epoch, release, pre, post, dev, local
diff --git a/venv/lib/python3.8/site-packages/pkg_resources/_vendor/pyparsing.py b/venv/lib/python3.8/site-packages/pkg_resources/_vendor/pyparsing.py
new file mode 100644
index 000000000..cf75e1e5f
--- /dev/null
+++ b/venv/lib/python3.8/site-packages/pkg_resources/_vendor/pyparsing.py
@@ -0,0 +1,5742 @@
+# module pyparsing.py
+#
+# Copyright (c) 2003-2018  Paul T. McGuire
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+# IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+# CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+# TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+# SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#
+
+__doc__ = \
+"""
+pyparsing module - Classes and methods to define and execute parsing grammars
+=============================================================================
+
+The pyparsing module is an alternative approach to creating and executing simple grammars,
+vs. the traditional lex/yacc approach, or the use of regular expressions.  With pyparsing, you
+don't need to learn a new syntax for defining grammars or matching expressions - the parsing module
+provides a library of classes that you use to construct the grammar directly in Python.
+
+Here is a program to parse "Hello, World!" (or any greeting of the form 
+C{", !"}), built up using L{Word}, L{Literal}, and L{And} elements 
+(L{'+'} operator gives L{And} expressions, strings are auto-converted to
+L{Literal} expressions)::
+
+    from pyparsing import Word, alphas
+
+    # define grammar of a greeting
+    greet = Word(alphas) + "," + Word(alphas) + "!"
+
+    hello = "Hello, World!"
+    print (hello, "->", greet.parseString(hello))
+
+The program outputs the following::
+
+    Hello, World! -> ['Hello', ',', 'World', '!']
+
+The Python representation of the grammar is quite readable, owing to the self-explanatory
+class names, and the use of '+', '|' and '^' operators.
+
+The L{ParseResults} object returned from L{ParserElement.parseString} can be accessed as a nested list, a dictionary, or an
+object with named attributes.
+
+The pyparsing module handles some of the problems that are typically vexing when writing text parsers:
+ - extra or missing whitespace (the above program will also handle "Hello,World!", "Hello  ,  World  !", etc.)
+ - quoted strings
+ - embedded comments
+
+
+Getting Started -
+-----------------
+Visit the classes L{ParserElement} and L{ParseResults} to see the base classes that most other pyparsing
+classes inherit from. Use the docstrings for examples of how to:
+ - construct literal match expressions from L{Literal} and L{CaselessLiteral} classes
+ - construct character word-group expressions using the L{Word} class
+ - see how to create repetitive expressions using L{ZeroOrMore} and L{OneOrMore} classes
+ - use L{'+'}, L{'|'}, L{'^'}, and L{'&'} operators to combine simple expressions into more complex ones
+ - associate names with your parsed results using L{ParserElement.setResultsName}
+ - find some helpful expression short-cuts like L{delimitedList} and L{oneOf}
+ - find more useful common expressions in the L{pyparsing_common} namespace class
+"""
+
+__version__ = "2.2.1"
+__versionTime__ = "18 Sep 2018 00:49 UTC"
+__author__ = "Paul McGuire "
+
+import string
+from weakref import ref as wkref
+import copy
+import sys
+import warnings
+import re
+import sre_constants
+import collections
+import pprint
+import traceback
+import types
+from datetime import datetime
+
+try:
+    from _thread import RLock
+except ImportError:
+    from threading import RLock
+
+try:
+    # Python 3
+    from collections.abc import Iterable
+    from collections.abc import MutableMapping
+except ImportError:
+    # Python 2.7
+    from collections import Iterable
+    from collections import MutableMapping
+
+try:
+    from collections import OrderedDict as _OrderedDict
+except ImportError:
+    try:
+        from ordereddict import OrderedDict as _OrderedDict
+    except ImportError:
+        _OrderedDict = None
+
+#~ sys.stderr.write( "testing pyparsing module, version %s, %s\n" % (__version__,__versionTime__ ) )
+
+__all__ = [
+'And', 'CaselessKeyword', 'CaselessLiteral', 'CharsNotIn', 'Combine', 'Dict', 'Each', 'Empty',
+'FollowedBy', 'Forward', 'GoToColumn', 'Group', 'Keyword', 'LineEnd', 'LineStart', 'Literal',
+'MatchFirst', 'NoMatch', 'NotAny', 'OneOrMore', 'OnlyOnce', 'Optional', 'Or',
+'ParseBaseException', 'ParseElementEnhance', 'ParseException', 'ParseExpression', 'ParseFatalException',
+'ParseResults', 'ParseSyntaxException', 'ParserElement', 'QuotedString', 'RecursiveGrammarException',
+'Regex', 'SkipTo', 'StringEnd', 'StringStart', 'Suppress', 'Token', 'TokenConverter', 
+'White', 'Word', 'WordEnd', 'WordStart', 'ZeroOrMore',
+'alphanums', 'alphas', 'alphas8bit', 'anyCloseTag', 'anyOpenTag', 'cStyleComment', 'col',
+'commaSeparatedList', 'commonHTMLEntity', 'countedArray', 'cppStyleComment', 'dblQuotedString',
+'dblSlashComment', 'delimitedList', 'dictOf', 'downcaseTokens', 'empty', 'hexnums',
+'htmlComment', 'javaStyleComment', 'line', 'lineEnd', 'lineStart', 'lineno',
+'makeHTMLTags', 'makeXMLTags', 'matchOnlyAtCol', 'matchPreviousExpr', 'matchPreviousLiteral',
+'nestedExpr', 'nullDebugAction', 'nums', 'oneOf', 'opAssoc', 'operatorPrecedence', 'printables',
+'punc8bit', 'pythonStyleComment', 'quotedString', 'removeQuotes', 'replaceHTMLEntity', 
+'replaceWith', 'restOfLine', 'sglQuotedString', 'srange', 'stringEnd',
+'stringStart', 'traceParseAction', 'unicodeString', 'upcaseTokens', 'withAttribute',
+'indentedBlock', 'originalTextFor', 'ungroup', 'infixNotation','locatedExpr', 'withClass',
+'CloseMatch', 'tokenMap', 'pyparsing_common',
+]
+
+system_version = tuple(sys.version_info)[:3]
+PY_3 = system_version[0] == 3
+if PY_3:
+    _MAX_INT = sys.maxsize
+    basestring = str
+    unichr = chr
+    _ustr = str
+
+    # build list of single arg builtins, that can be used as parse actions
+    singleArgBuiltins = [sum, len, sorted, reversed, list, tuple, set, any, all, min, max]
+
+else:
+    _MAX_INT = sys.maxint
+    range = xrange
+
+    def _ustr(obj):
+        """Drop-in replacement for str(obj) that tries to be Unicode friendly. It first tries
+           str(obj). If that fails with a UnicodeEncodeError, then it tries unicode(obj). It
+           then < returns the unicode object | encodes it with the default encoding | ... >.
+        """
+        if isinstance(obj,unicode):
+            return obj
+
+        try:
+            # If this works, then _ustr(obj) has the same behaviour as str(obj), so
+            # it won't break any existing code.
+            return str(obj)
+
+        except UnicodeEncodeError:
+            # Else encode it
+            ret = unicode(obj).encode(sys.getdefaultencoding(), 'xmlcharrefreplace')
+            xmlcharref = Regex(r'&#\d+;')
+            xmlcharref.setParseAction(lambda t: '\\u' + hex(int(t[0][2:-1]))[2:])
+            return xmlcharref.transformString(ret)
+
+    # build list of single arg builtins, tolerant of Python version, that can be used as parse actions
+    singleArgBuiltins = []
+    import __builtin__
+    for fname in "sum len sorted reversed list tuple set any all min max".split():
+        try:
+            singleArgBuiltins.append(getattr(__builtin__,fname))
+        except AttributeError:
+            continue
+            
+_generatorType = type((y for y in range(1)))
+ 
+def _xml_escape(data):
+    """Escape &, <, >, ", ', etc. in a string of data."""
+
+    # ampersand must be replaced first
+    from_symbols = '&><"\''
+    to_symbols = ('&'+s+';' for s in "amp gt lt quot apos".split())
+    for from_,to_ in zip(from_symbols, to_symbols):
+        data = data.replace(from_, to_)
+    return data
+
+class _Constants(object):
+    pass
+
+alphas     = string.ascii_uppercase + string.ascii_lowercase
+nums       = "0123456789"
+hexnums    = nums + "ABCDEFabcdef"
+alphanums  = alphas + nums
+_bslash    = chr(92)
+printables = "".join(c for c in string.printable if c not in string.whitespace)
+
+class ParseBaseException(Exception):
+    """base exception class for all parsing runtime exceptions"""
+    # Performance tuning: we construct a *lot* of these, so keep this
+    # constructor as small and fast as possible
+    def __init__( self, pstr, loc=0, msg=None, elem=None ):
+        self.loc = loc
+        if msg is None:
+            self.msg = pstr
+            self.pstr = ""
+        else:
+            self.msg = msg
+            self.pstr = pstr
+        self.parserElement = elem
+        self.args = (pstr, loc, msg)
+
+    @classmethod
+    def _from_exception(cls, pe):
+        """
+        internal factory method to simplify creating one type of ParseException 
+        from another - avoids having __init__ signature conflicts among subclasses
+        """
+        return cls(pe.pstr, pe.loc, pe.msg, pe.parserElement)
+
+    def __getattr__( self, aname ):
+        """supported attributes by name are:
+            - lineno - returns the line number of the exception text
+            - col - returns the column number of the exception text
+            - line - returns the line containing the exception text
+        """
+        if( aname == "lineno" ):
+            return lineno( self.loc, self.pstr )
+        elif( aname in ("col", "column") ):
+            return col( self.loc, self.pstr )
+        elif( aname == "line" ):
+            return line( self.loc, self.pstr )
+        else:
+            raise AttributeError(aname)
+
+    def __str__( self ):
+        return "%s (at char %d), (line:%d, col:%d)" % \
+                ( self.msg, self.loc, self.lineno, self.column )
+    def __repr__( self ):
+        return _ustr(self)
+    def markInputline( self, markerString = ">!<" ):
+        """Extracts the exception line from the input string, and marks
+           the location of the exception with a special symbol.
+        """
+        line_str = self.line
+        line_column = self.column - 1
+        if markerString:
+            line_str = "".join((line_str[:line_column],
+                                markerString, line_str[line_column:]))
+        return line_str.strip()
+    def __dir__(self):
+        return "lineno col line".split() + dir(type(self))
+
+class ParseException(ParseBaseException):
+    """
+    Exception thrown when parse expressions don't match class;
+    supported attributes by name are:
+     - lineno - returns the line number of the exception text
+     - col - returns the column number of the exception text
+     - line - returns the line containing the exception text
+        
+    Example::
+        try:
+            Word(nums).setName("integer").parseString("ABC")
+        except ParseException as pe:
+            print(pe)
+            print("column: {}".format(pe.col))
+            
+    prints::
+       Expected integer (at char 0), (line:1, col:1)
+        column: 1
+    """
+    pass
+
+class ParseFatalException(ParseBaseException):
+    """user-throwable exception thrown when inconsistent parse content
+       is found; stops all parsing immediately"""
+    pass
+
+class ParseSyntaxException(ParseFatalException):
+    """just like L{ParseFatalException}, but thrown internally when an
+       L{ErrorStop} ('-' operator) indicates that parsing is to stop 
+       immediately because an unbacktrackable syntax error has been found"""
+    pass
+
+#~ class ReparseException(ParseBaseException):
+    #~ """Experimental class - parse actions can raise this exception to cause
+       #~ pyparsing to reparse the input string:
+        #~ - with a modified input string, and/or
+        #~ - with a modified start location
+       #~ Set the values of the ReparseException in the constructor, and raise the
+       #~ exception in a parse action to cause pyparsing to use the new string/location.
+       #~ Setting the values as None causes no change to be made.
+       #~ """
+    #~ def __init_( self, newstring, restartLoc ):
+        #~ self.newParseText = newstring
+        #~ self.reparseLoc = restartLoc
+
+class RecursiveGrammarException(Exception):
+    """exception thrown by L{ParserElement.validate} if the grammar could be improperly recursive"""
+    def __init__( self, parseElementList ):
+        self.parseElementTrace = parseElementList
+
+    def __str__( self ):
+        return "RecursiveGrammarException: %s" % self.parseElementTrace
+
+class _ParseResultsWithOffset(object):
+    def __init__(self,p1,p2):
+        self.tup = (p1,p2)
+    def __getitem__(self,i):
+        return self.tup[i]
+    def __repr__(self):
+        return repr(self.tup[0])
+    def setOffset(self,i):
+        self.tup = (self.tup[0],i)
+
+class ParseResults(object):
+    """
+    Structured parse results, to provide multiple means of access to the parsed data:
+       - as a list (C{len(results)})
+       - by list index (C{results[0], results[1]}, etc.)
+       - by attribute (C{results.} - see L{ParserElement.setResultsName})
+
+    Example::
+        integer = Word(nums)
+        date_str = (integer.setResultsName("year") + '/' 
+                        + integer.setResultsName("month") + '/' 
+                        + integer.setResultsName("day"))
+        # equivalent form:
+        # date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
+
+        # parseString returns a ParseResults object
+        result = date_str.parseString("1999/12/31")
+
+        def test(s, fn=repr):
+            print("%s -> %s" % (s, fn(eval(s))))
+        test("list(result)")
+        test("result[0]")
+        test("result['month']")
+        test("result.day")
+        test("'month' in result")
+        test("'minutes' in result")
+        test("result.dump()", str)
+    prints::
+        list(result) -> ['1999', '/', '12', '/', '31']
+        result[0] -> '1999'
+        result['month'] -> '12'
+        result.day -> '31'
+        'month' in result -> True
+        'minutes' in result -> False
+        result.dump() -> ['1999', '/', '12', '/', '31']
+        - day: 31
+        - month: 12
+        - year: 1999
+    """
+    def __new__(cls, toklist=None, name=None, asList=True, modal=True ):
+        if isinstance(toklist, cls):
+            return toklist
+        retobj = object.__new__(cls)
+        retobj.__doinit = True
+        return retobj
+
+    # Performance tuning: we construct a *lot* of these, so keep this
+    # constructor as small and fast as possible
+    def __init__( self, toklist=None, name=None, asList=True, modal=True, isinstance=isinstance ):
+        if self.__doinit:
+            self.__doinit = False
+            self.__name = None
+            self.__parent = None
+            self.__accumNames = {}
+            self.__asList = asList
+            self.__modal = modal
+            if toklist is None:
+                toklist = []
+            if isinstance(toklist, list):
+                self.__toklist = toklist[:]
+            elif isinstance(toklist, _generatorType):
+                self.__toklist = list(toklist)
+            else:
+                self.__toklist = [toklist]
+            self.__tokdict = dict()
+
+        if name is not None and name:
+            if not modal:
+                self.__accumNames[name] = 0
+            if isinstance(name,int):
+                name = _ustr(name) # will always return a str, but use _ustr for consistency
+            self.__name = name
+            if not (isinstance(toklist, (type(None), basestring, list)) and toklist in (None,'',[])):
+                if isinstance(toklist,basestring):
+                    toklist = [ toklist ]
+                if asList:
+                    if isinstance(toklist,ParseResults):
+                        self[name] = _ParseResultsWithOffset(toklist.copy(),0)
+                    else:
+                        self[name] = _ParseResultsWithOffset(ParseResults(toklist[0]),0)
+                    self[name].__name = name
+                else:
+                    try:
+                        self[name] = toklist[0]
+                    except (KeyError,TypeError,IndexError):
+                        self[name] = toklist
+
+    def __getitem__( self, i ):
+        if isinstance( i, (int,slice) ):
+            return self.__toklist[i]
+        else:
+            if i not in self.__accumNames:
+                return self.__tokdict[i][-1][0]
+            else:
+                return ParseResults([ v[0] for v in self.__tokdict[i] ])
+
+    def __setitem__( self, k, v, isinstance=isinstance ):
+        if isinstance(v,_ParseResultsWithOffset):
+            self.__tokdict[k] = self.__tokdict.get(k,list()) + [v]
+            sub = v[0]
+        elif isinstance(k,(int,slice)):
+            self.__toklist[k] = v
+            sub = v
+        else:
+            self.__tokdict[k] = self.__tokdict.get(k,list()) + [_ParseResultsWithOffset(v,0)]
+            sub = v
+        if isinstance(sub,ParseResults):
+            sub.__parent = wkref(self)
+
+    def __delitem__( self, i ):
+        if isinstance(i,(int,slice)):
+            mylen = len( self.__toklist )
+            del self.__toklist[i]
+
+            # convert int to slice
+            if isinstance(i, int):
+                if i < 0:
+                    i += mylen
+                i = slice(i, i+1)
+            # get removed indices
+            removed = list(range(*i.indices(mylen)))
+            removed.reverse()
+            # fixup indices in token dictionary
+            for name,occurrences in self.__tokdict.items():
+                for j in removed:
+                    for k, (value, position) in enumerate(occurrences):
+                        occurrences[k] = _ParseResultsWithOffset(value, position - (position > j))
+        else:
+            del self.__tokdict[i]
+
+    def __contains__( self, k ):
+        return k in self.__tokdict
+
+    def __len__( self ): return len( self.__toklist )
+    def __bool__(self): return ( not not self.__toklist )
+    __nonzero__ = __bool__
+    def __iter__( self ): return iter( self.__toklist )
+    def __reversed__( self ): return iter( self.__toklist[::-1] )
+    def _iterkeys( self ):
+        if hasattr(self.__tokdict, "iterkeys"):
+            return self.__tokdict.iterkeys()
+        else:
+            return iter(self.__tokdict)
+
+    def _itervalues( self ):
+        return (self[k] for k in self._iterkeys())
+            
+    def _iteritems( self ):
+        return ((k, self[k]) for k in self._iterkeys())
+
+    if PY_3:
+        keys = _iterkeys       
+        """Returns an iterator of all named result keys (Python 3.x only)."""
+
+        values = _itervalues
+        """Returns an iterator of all named result values (Python 3.x only)."""
+
+        items = _iteritems
+        """Returns an iterator of all named result key-value tuples (Python 3.x only)."""
+
+    else:
+        iterkeys = _iterkeys
+        """Returns an iterator of all named result keys (Python 2.x only)."""
+
+        itervalues = _itervalues
+        """Returns an iterator of all named result values (Python 2.x only)."""
+
+        iteritems = _iteritems
+        """Returns an iterator of all named result key-value tuples (Python 2.x only)."""
+
+        def keys( self ):
+            """Returns all named result keys (as a list in Python 2.x, as an iterator in Python 3.x)."""
+            return list(self.iterkeys())
+
+        def values( self ):
+            """Returns all named result values (as a list in Python 2.x, as an iterator in Python 3.x)."""
+            return list(self.itervalues())
+                
+        def items( self ):
+            """Returns all named result key-values (as a list of tuples in Python 2.x, as an iterator in Python 3.x)."""
+            return list(self.iteritems())
+
+    def haskeys( self ):
+        """Since keys() returns an iterator, this method is helpful in bypassing
+           code that looks for the existence of any defined results names."""
+        return bool(self.__tokdict)
+        
+    def pop( self, *args, **kwargs):
+        """
+        Removes and returns item at specified index (default=C{last}).
+        Supports both C{list} and C{dict} semantics for C{pop()}. If passed no
+        argument or an integer argument, it will use C{list} semantics
+        and pop tokens from the list of parsed tokens. If passed a 
+        non-integer argument (most likely a string), it will use C{dict}
+        semantics and pop the corresponding value from any defined 
+        results names. A second default return value argument is 
+        supported, just as in C{dict.pop()}.
+
+        Example::
+            def remove_first(tokens):
+                tokens.pop(0)
+            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']
+            print(OneOrMore(Word(nums)).addParseAction(remove_first).parseString("0 123 321")) # -> ['123', '321']
+
+            label = Word(alphas)
+            patt = label("LABEL") + OneOrMore(Word(nums))
+            print(patt.parseString("AAB 123 321").dump())
+
+            # Use pop() in a parse action to remove named result (note that corresponding value is not
+            # removed from list form of results)
+            def remove_LABEL(tokens):
+                tokens.pop("LABEL")
+                return tokens
+            patt.addParseAction(remove_LABEL)
+            print(patt.parseString("AAB 123 321").dump())
+        prints::
+            ['AAB', '123', '321']
+            - LABEL: AAB
+
+            ['AAB', '123', '321']
+        """
+        if not args:
+            args = [-1]
+        for k,v in kwargs.items():
+            if k == 'default':
+                args = (args[0], v)
+            else:
+                raise TypeError("pop() got an unexpected keyword argument '%s'" % k)
+        if (isinstance(args[0], int) or 
+                        len(args) == 1 or 
+                        args[0] in self):
+            index = args[0]
+            ret = self[index]
+            del self[index]
+            return ret
+        else:
+            defaultvalue = args[1]
+            return defaultvalue
+
+    def get(self, key, defaultValue=None):
+        """
+        Returns named result matching the given key, or if there is no
+        such name, then returns the given C{defaultValue} or C{None} if no
+        C{defaultValue} is specified.
+
+        Similar to C{dict.get()}.
+        
+        Example::
+            integer = Word(nums)
+            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")           
+
+            result = date_str.parseString("1999/12/31")
+            print(result.get("year")) # -> '1999'
+            print(result.get("hour", "not specified")) # -> 'not specified'
+            print(result.get("hour")) # -> None
+        """
+        if key in self:
+            return self[key]
+        else:
+            return defaultValue
+
+    def insert( self, index, insStr ):
+        """
+        Inserts new element at location index in the list of parsed tokens.
+        
+        Similar to C{list.insert()}.
+
+        Example::
+            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']
+
+            # use a parse action to insert the parse location in the front of the parsed results
+            def insert_locn(locn, tokens):
+                tokens.insert(0, locn)
+            print(OneOrMore(Word(nums)).addParseAction(insert_locn).parseString("0 123 321")) # -> [0, '0', '123', '321']
+        """
+        self.__toklist.insert(index, insStr)
+        # fixup indices in token dictionary
+        for name,occurrences in self.__tokdict.items():
+            for k, (value, position) in enumerate(occurrences):
+                occurrences[k] = _ParseResultsWithOffset(value, position + (position > index))
+
+    def append( self, item ):
+        """
+        Add single element to end of ParseResults list of elements.
+
+        Example::
+            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']
+            
+            # use a parse action to compute the sum of the parsed integers, and add it to the end
+            def append_sum(tokens):
+                tokens.append(sum(map(int, tokens)))
+            print(OneOrMore(Word(nums)).addParseAction(append_sum).parseString("0 123 321")) # -> ['0', '123', '321', 444]
+        """
+        self.__toklist.append(item)
+
+    def extend( self, itemseq ):
+        """
+        Add sequence of elements to end of ParseResults list of elements.
+
+        Example::
+            patt = OneOrMore(Word(alphas))
+            
+            # use a parse action to append the reverse of the matched strings, to make a palindrome
+            def make_palindrome(tokens):
+                tokens.extend(reversed([t[::-1] for t in tokens]))
+                return ''.join(tokens)
+            print(patt.addParseAction(make_palindrome).parseString("lskdj sdlkjf lksd")) # -> 'lskdjsdlkjflksddsklfjkldsjdksl'
+        """
+        if isinstance(itemseq, ParseResults):
+            self += itemseq
+        else:
+            self.__toklist.extend(itemseq)
+
+    def clear( self ):
+        """
+        Clear all elements and results names.
+        """
+        del self.__toklist[:]
+        self.__tokdict.clear()
+
+    def __getattr__( self, name ):
+        try:
+            return self[name]
+        except KeyError:
+            return ""
+            
+        if name in self.__tokdict:
+            if name not in self.__accumNames:
+                return self.__tokdict[name][-1][0]
+            else:
+                return ParseResults([ v[0] for v in self.__tokdict[name] ])
+        else:
+            return ""
+
+    def __add__( self, other ):
+        ret = self.copy()
+        ret += other
+        return ret
+
+    def __iadd__( self, other ):
+        if other.__tokdict:
+            offset = len(self.__toklist)
+            addoffset = lambda a: offset if a<0 else a+offset
+            otheritems = other.__tokdict.items()
+            otherdictitems = [(k, _ParseResultsWithOffset(v[0],addoffset(v[1])) )
+                                for (k,vlist) in otheritems for v in vlist]
+            for k,v in otherdictitems:
+                self[k] = v
+                if isinstance(v[0],ParseResults):
+                    v[0].__parent = wkref(self)
+            
+        self.__toklist += other.__toklist
+        self.__accumNames.update( other.__accumNames )
+        return self
+
+    def __radd__(self, other):
+        if isinstance(other,int) and other == 0:
+            # useful for merging many ParseResults using sum() builtin
+            return self.copy()
+        else:
+            # this may raise a TypeError - so be it
+            return other + self
+        
+    def __repr__( self ):
+        return "(%s, %s)" % ( repr( self.__toklist ), repr( self.__tokdict ) )
+
+    def __str__( self ):
+        return '[' + ', '.join(_ustr(i) if isinstance(i, ParseResults) else repr(i) for i in self.__toklist) + ']'
+
+    def _asStringList( self, sep='' ):
+        out = []
+        for item in self.__toklist:
+            if out and sep:
+                out.append(sep)
+            if isinstance( item, ParseResults ):
+                out += item._asStringList()
+            else:
+                out.append( _ustr(item) )
+        return out
+
+    def asList( self ):
+        """
+        Returns the parse results as a nested list of matching tokens, all converted to strings.
+
+        Example::
+            patt = OneOrMore(Word(alphas))
+            result = patt.parseString("sldkj lsdkj sldkj")
+            # even though the result prints in string-like form, it is actually a pyparsing ParseResults
+            print(type(result), result) # ->  ['sldkj', 'lsdkj', 'sldkj']
+            
+            # Use asList() to create an actual list
+            result_list = result.asList()
+            print(type(result_list), result_list) # ->  ['sldkj', 'lsdkj', 'sldkj']
+        """
+        return [res.asList() if isinstance(res,ParseResults) else res for res in self.__toklist]
+
+    def asDict( self ):
+        """
+        Returns the named parse results as a nested dictionary.
+
+        Example::
+            integer = Word(nums)
+            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
+            
+            result = date_str.parseString('12/31/1999')
+            print(type(result), repr(result)) # ->  (['12', '/', '31', '/', '1999'], {'day': [('1999', 4)], 'year': [('12', 0)], 'month': [('31', 2)]})
+            
+            result_dict = result.asDict()
+            print(type(result_dict), repr(result_dict)) # ->  {'day': '1999', 'year': '12', 'month': '31'}
+
+            # even though a ParseResults supports dict-like access, sometime you just need to have a dict
+            import json
+            print(json.dumps(result)) # -> Exception: TypeError: ... is not JSON serializable
+            print(json.dumps(result.asDict())) # -> {"month": "31", "day": "1999", "year": "12"}
+        """
+        if PY_3:
+            item_fn = self.items
+        else:
+            item_fn = self.iteritems
+            
+        def toItem(obj):
+            if isinstance(obj, ParseResults):
+                if obj.haskeys():
+                    return obj.asDict()
+                else:
+                    return [toItem(v) for v in obj]
+            else:
+                return obj
+                
+        return dict((k,toItem(v)) for k,v in item_fn())
+
+    def copy( self ):
+        """
+        Returns a new copy of a C{ParseResults} object.
+        """
+        ret = ParseResults( self.__toklist )
+        ret.__tokdict = self.__tokdict.copy()
+        ret.__parent = self.__parent
+        ret.__accumNames.update( self.__accumNames )
+        ret.__name = self.__name
+        return ret
+
+    def asXML( self, doctag=None, namedItemsOnly=False, indent="", formatted=True ):
+        """
+        (Deprecated) Returns the parse results as XML. Tags are created for tokens and lists that have defined results names.
+        """
+        nl = "\n"
+        out = []
+        namedItems = dict((v[1],k) for (k,vlist) in self.__tokdict.items()
+                                                            for v in vlist)
+        nextLevelIndent = indent + "  "
+
+        # collapse out indents if formatting is not desired
+        if not formatted:
+            indent = ""
+            nextLevelIndent = ""
+            nl = ""
+
+        selfTag = None
+        if doctag is not None:
+            selfTag = doctag
+        else:
+            if self.__name:
+                selfTag = self.__name
+
+        if not selfTag:
+            if namedItemsOnly:
+                return ""
+            else:
+                selfTag = "ITEM"
+
+        out += [ nl, indent, "<", selfTag, ">" ]
+
+        for i,res in enumerate(self.__toklist):
+            if isinstance(res,ParseResults):
+                if i in namedItems:
+                    out += [ res.asXML(namedItems[i],
+                                        namedItemsOnly and doctag is None,
+                                        nextLevelIndent,
+                                        formatted)]
+                else:
+                    out += [ res.asXML(None,
+                                        namedItemsOnly and doctag is None,
+                                        nextLevelIndent,
+                                        formatted)]
+            else:
+                # individual token, see if there is a name for it
+                resTag = None
+                if i in namedItems:
+                    resTag = namedItems[i]
+                if not resTag:
+                    if namedItemsOnly:
+                        continue
+                    else:
+                        resTag = "ITEM"
+                xmlBodyText = _xml_escape(_ustr(res))
+                out += [ nl, nextLevelIndent, "<", resTag, ">",
+                                                xmlBodyText,
+                                                "" ]
+
+        out += [ nl, indent, "" ]
+        return "".join(out)
+
+    def __lookup(self,sub):
+        for k,vlist in self.__tokdict.items():
+            for v,loc in vlist:
+                if sub is v:
+                    return k
+        return None
+
+    def getName(self):
+        r"""
+        Returns the results name for this token expression. Useful when several 
+        different expressions might match at a particular location.
+
+        Example::
+            integer = Word(nums)
+            ssn_expr = Regex(r"\d\d\d-\d\d-\d\d\d\d")
+            house_number_expr = Suppress('#') + Word(nums, alphanums)
+            user_data = (Group(house_number_expr)("house_number") 
+                        | Group(ssn_expr)("ssn")
+                        | Group(integer)("age"))
+            user_info = OneOrMore(user_data)
+            
+            result = user_info.parseString("22 111-22-3333 #221B")
+            for item in result:
+                print(item.getName(), ':', item[0])
+        prints::
+            age : 22
+            ssn : 111-22-3333
+            house_number : 221B
+        """
+        if self.__name:
+            return self.__name
+        elif self.__parent:
+            par = self.__parent()
+            if par:
+                return par.__lookup(self)
+            else:
+                return None
+        elif (len(self) == 1 and
+               len(self.__tokdict) == 1 and
+               next(iter(self.__tokdict.values()))[0][1] in (0,-1)):
+            return next(iter(self.__tokdict.keys()))
+        else:
+            return None
+
+    def dump(self, indent='', depth=0, full=True):
+        """
+        Diagnostic method for listing out the contents of a C{ParseResults}.
+        Accepts an optional C{indent} argument so that this string can be embedded
+        in a nested display of other data.
+
+        Example::
+            integer = Word(nums)
+            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
+            
+            result = date_str.parseString('12/31/1999')
+            print(result.dump())
+        prints::
+            ['12', '/', '31', '/', '1999']
+            - day: 1999
+            - month: 31
+            - year: 12
+        """
+        out = []
+        NL = '\n'
+        out.append( indent+_ustr(self.asList()) )
+        if full:
+            if self.haskeys():
+                items = sorted((str(k), v) for k,v in self.items())
+                for k,v in items:
+                    if out:
+                        out.append(NL)
+                    out.append( "%s%s- %s: " % (indent,('  '*depth), k) )
+                    if isinstance(v,ParseResults):
+                        if v:
+                            out.append( v.dump(indent,depth+1) )
+                        else:
+                            out.append(_ustr(v))
+                    else:
+                        out.append(repr(v))
+            elif any(isinstance(vv,ParseResults) for vv in self):
+                v = self
+                for i,vv in enumerate(v):
+                    if isinstance(vv,ParseResults):
+                        out.append("\n%s%s[%d]:\n%s%s%s" % (indent,('  '*(depth)),i,indent,('  '*(depth+1)),vv.dump(indent,depth+1) ))
+                    else:
+                        out.append("\n%s%s[%d]:\n%s%s%s" % (indent,('  '*(depth)),i,indent,('  '*(depth+1)),_ustr(vv)))
+            
+        return "".join(out)
+
+    def pprint(self, *args, **kwargs):
+        """
+        Pretty-printer for parsed results as a list, using the C{pprint} module.
+        Accepts additional positional or keyword args as defined for the 
+        C{pprint.pprint} method. (U{http://docs.python.org/3/library/pprint.html#pprint.pprint})
+
+        Example::
+            ident = Word(alphas, alphanums)
+            num = Word(nums)
+            func = Forward()
+            term = ident | num | Group('(' + func + ')')
+            func <<= ident + Group(Optional(delimitedList(term)))
+            result = func.parseString("fna a,b,(fnb c,d,200),100")
+            result.pprint(width=40)
+        prints::
+            ['fna',
+             ['a',
+              'b',
+              ['(', 'fnb', ['c', 'd', '200'], ')'],
+              '100']]
+        """
+        pprint.pprint(self.asList(), *args, **kwargs)
+
+    # add support for pickle protocol
+    def __getstate__(self):
+        return ( self.__toklist,
+                 ( self.__tokdict.copy(),
+                   self.__parent is not None and self.__parent() or None,
+                   self.__accumNames,
+                   self.__name ) )
+
+    def __setstate__(self,state):
+        self.__toklist = state[0]
+        (self.__tokdict,
+         par,
+         inAccumNames,
+         self.__name) = state[1]
+        self.__accumNames = {}
+        self.__accumNames.update(inAccumNames)
+        if par is not None:
+            self.__parent = wkref(par)
+        else:
+            self.__parent = None
+
+    def __getnewargs__(self):
+        return self.__toklist, self.__name, self.__asList, self.__modal
+
+    def __dir__(self):
+        return (dir(type(self)) + list(self.keys()))
+
+MutableMapping.register(ParseResults)
+
+def col (loc,strg):
+    """Returns current column within a string, counting newlines as line separators.
+   The first column is number 1.
+
+   Note: the default parsing behavior is to expand tabs in the input string
+   before starting the parsing process.  See L{I{ParserElement.parseString}} for more information
+   on parsing strings containing C{}s, and suggested methods to maintain a
+   consistent view of the parsed string, the parse location, and line and column
+   positions within the parsed string.
+   """
+    s = strg
+    return 1 if 0} for more information
+   on parsing strings containing C{}s, and suggested methods to maintain a
+   consistent view of the parsed string, the parse location, and line and column
+   positions within the parsed string.
+   """
+    return strg.count("\n",0,loc) + 1
+
+def line( loc, strg ):
+    """Returns the line of text containing loc within a string, counting newlines as line separators.
+       """
+    lastCR = strg.rfind("\n", 0, loc)
+    nextCR = strg.find("\n", loc)
+    if nextCR >= 0:
+        return strg[lastCR+1:nextCR]
+    else:
+        return strg[lastCR+1:]
+
+def _defaultStartDebugAction( instring, loc, expr ):
+    print (("Match " + _ustr(expr) + " at loc " + _ustr(loc) + "(%d,%d)" % ( lineno(loc,instring), col(loc,instring) )))
+
+def _defaultSuccessDebugAction( instring, startloc, endloc, expr, toks ):
+    print ("Matched " + _ustr(expr) + " -> " + str(toks.asList()))
+
+def _defaultExceptionDebugAction( instring, loc, expr, exc ):
+    print ("Exception raised:" + _ustr(exc))
+
+def nullDebugAction(*args):
+    """'Do-nothing' debug action, to suppress debugging output during parsing."""
+    pass
+
+# Only works on Python 3.x - nonlocal is toxic to Python 2 installs
+#~ 'decorator to trim function calls to match the arity of the target'
+#~ def _trim_arity(func, maxargs=3):
+    #~ if func in singleArgBuiltins:
+        #~ return lambda s,l,t: func(t)
+    #~ limit = 0
+    #~ foundArity = False
+    #~ def wrapper(*args):
+        #~ nonlocal limit,foundArity
+        #~ while 1:
+            #~ try:
+                #~ ret = func(*args[limit:])
+                #~ foundArity = True
+                #~ return ret
+            #~ except TypeError:
+                #~ if limit == maxargs or foundArity:
+                    #~ raise
+                #~ limit += 1
+                #~ continue
+    #~ return wrapper
+
+# this version is Python 2.x-3.x cross-compatible
+'decorator to trim function calls to match the arity of the target'
+def _trim_arity(func, maxargs=2):
+    if func in singleArgBuiltins:
+        return lambda s,l,t: func(t)
+    limit = [0]
+    foundArity = [False]
+    
+    # traceback return data structure changed in Py3.5 - normalize back to plain tuples
+    if system_version[:2] >= (3,5):
+        def extract_stack(limit=0):
+            # special handling for Python 3.5.0 - extra deep call stack by 1
+            offset = -3 if system_version == (3,5,0) else -2
+            frame_summary = traceback.extract_stack(limit=-offset+limit-1)[offset]
+            return [frame_summary[:2]]
+        def extract_tb(tb, limit=0):
+            frames = traceback.extract_tb(tb, limit=limit)
+            frame_summary = frames[-1]
+            return [frame_summary[:2]]
+    else:
+        extract_stack = traceback.extract_stack
+        extract_tb = traceback.extract_tb
+    
+    # synthesize what would be returned by traceback.extract_stack at the call to 
+    # user's parse action 'func', so that we don't incur call penalty at parse time
+    
+    LINE_DIFF = 6
+    # IF ANY CODE CHANGES, EVEN JUST COMMENTS OR BLANK LINES, BETWEEN THE NEXT LINE AND 
+    # THE CALL TO FUNC INSIDE WRAPPER, LINE_DIFF MUST BE MODIFIED!!!!
+    this_line = extract_stack(limit=2)[-1]
+    pa_call_line_synth = (this_line[0], this_line[1]+LINE_DIFF)
+
+    def wrapper(*args):
+        while 1:
+            try:
+                ret = func(*args[limit[0]:])
+                foundArity[0] = True
+                return ret
+            except TypeError:
+                # re-raise TypeErrors if they did not come from our arity testing
+                if foundArity[0]:
+                    raise
+                else:
+                    try:
+                        tb = sys.exc_info()[-1]
+                        if not extract_tb(tb, limit=2)[-1][:2] == pa_call_line_synth:
+                            raise
+                    finally:
+                        del tb
+
+                if limit[0] <= maxargs:
+                    limit[0] += 1
+                    continue
+                raise
+
+    # copy func name to wrapper for sensible debug output
+    func_name = ""
+    try:
+        func_name = getattr(func, '__name__', 
+                            getattr(func, '__class__').__name__)
+    except Exception:
+        func_name = str(func)
+    wrapper.__name__ = func_name
+
+    return wrapper
+
+class ParserElement(object):
+    """Abstract base level parser element class."""
+    DEFAULT_WHITE_CHARS = " \n\t\r"
+    verbose_stacktrace = False
+
+    @staticmethod
+    def setDefaultWhitespaceChars( chars ):
+        r"""
+        Overrides the default whitespace chars
+
+        Example::
+            # default whitespace chars are space,  and newline
+            OneOrMore(Word(alphas)).parseString("abc def\nghi jkl")  # -> ['abc', 'def', 'ghi', 'jkl']
+            
+            # change to just treat newline as significant
+            ParserElement.setDefaultWhitespaceChars(" \t")
+            OneOrMore(Word(alphas)).parseString("abc def\nghi jkl")  # -> ['abc', 'def']
+        """
+        ParserElement.DEFAULT_WHITE_CHARS = chars
+
+    @staticmethod
+    def inlineLiteralsUsing(cls):
+        """
+        Set class to be used for inclusion of string literals into a parser.
+        
+        Example::
+            # default literal class used is Literal
+            integer = Word(nums)
+            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")           
+
+            date_str.parseString("1999/12/31")  # -> ['1999', '/', '12', '/', '31']
+
+
+            # change to Suppress
+            ParserElement.inlineLiteralsUsing(Suppress)
+            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")           
+
+            date_str.parseString("1999/12/31")  # -> ['1999', '12', '31']
+        """
+        ParserElement._literalStringClass = cls
+
+    def __init__( self, savelist=False ):
+        self.parseAction = list()
+        self.failAction = None
+        #~ self.name = ""  # don't define self.name, let subclasses try/except upcall
+        self.strRepr = None
+        self.resultsName = None
+        self.saveAsList = savelist
+        self.skipWhitespace = True
+        self.whiteChars = ParserElement.DEFAULT_WHITE_CHARS
+        self.copyDefaultWhiteChars = True
+        self.mayReturnEmpty = False # used when checking for left-recursion
+        self.keepTabs = False
+        self.ignoreExprs = list()
+        self.debug = False
+        self.streamlined = False
+        self.mayIndexError = True # used to optimize exception handling for subclasses that don't advance parse index
+        self.errmsg = ""
+        self.modalResults = True # used to mark results names as modal (report only last) or cumulative (list all)
+        self.debugActions = ( None, None, None ) #custom debug actions
+        self.re = None
+        self.callPreparse = True # used to avoid redundant calls to preParse
+        self.callDuringTry = False
+
+    def copy( self ):
+        """
+        Make a copy of this C{ParserElement}.  Useful for defining different parse actions
+        for the same parsing pattern, using copies of the original parse element.
+        
+        Example::
+            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
+            integerK = integer.copy().addParseAction(lambda toks: toks[0]*1024) + Suppress("K")
+            integerM = integer.copy().addParseAction(lambda toks: toks[0]*1024*1024) + Suppress("M")
+            
+            print(OneOrMore(integerK | integerM | integer).parseString("5K 100 640K 256M"))
+        prints::
+            [5120, 100, 655360, 268435456]
+        Equivalent form of C{expr.copy()} is just C{expr()}::
+            integerM = integer().addParseAction(lambda toks: toks[0]*1024*1024) + Suppress("M")
+        """
+        cpy = copy.copy( self )
+        cpy.parseAction = self.parseAction[:]
+        cpy.ignoreExprs = self.ignoreExprs[:]
+        if self.copyDefaultWhiteChars:
+            cpy.whiteChars = ParserElement.DEFAULT_WHITE_CHARS
+        return cpy
+
+    def setName( self, name ):
+        """
+        Define name for this expression, makes debugging and exception messages clearer.
+        
+        Example::
+            Word(nums).parseString("ABC")  # -> Exception: Expected W:(0123...) (at char 0), (line:1, col:1)
+            Word(nums).setName("integer").parseString("ABC")  # -> Exception: Expected integer (at char 0), (line:1, col:1)
+        """
+        self.name = name
+        self.errmsg = "Expected " + self.name
+        if hasattr(self,"exception"):
+            self.exception.msg = self.errmsg
+        return self
+
+    def setResultsName( self, name, listAllMatches=False ):
+        """
+        Define name for referencing matching tokens as a nested attribute
+        of the returned parse results.
+        NOTE: this returns a *copy* of the original C{ParserElement} object;
+        this is so that the client can define a basic element, such as an
+        integer, and reference it in multiple places with different names.
+
+        You can also set results names using the abbreviated syntax,
+        C{expr("name")} in place of C{expr.setResultsName("name")} - 
+        see L{I{__call__}<__call__>}.
+
+        Example::
+            date_str = (integer.setResultsName("year") + '/' 
+                        + integer.setResultsName("month") + '/' 
+                        + integer.setResultsName("day"))
+
+            # equivalent form:
+            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
+        """
+        newself = self.copy()
+        if name.endswith("*"):
+            name = name[:-1]
+            listAllMatches=True
+        newself.resultsName = name
+        newself.modalResults = not listAllMatches
+        return newself
+
+    def setBreak(self,breakFlag = True):
+        """Method to invoke the Python pdb debugger when this element is
+           about to be parsed. Set C{breakFlag} to True to enable, False to
+           disable.
+        """
+        if breakFlag:
+            _parseMethod = self._parse
+            def breaker(instring, loc, doActions=True, callPreParse=True):
+                import pdb
+                pdb.set_trace()
+                return _parseMethod( instring, loc, doActions, callPreParse )
+            breaker._originalParseMethod = _parseMethod
+            self._parse = breaker
+        else:
+            if hasattr(self._parse,"_originalParseMethod"):
+                self._parse = self._parse._originalParseMethod
+        return self
+
+    def setParseAction( self, *fns, **kwargs ):
+        """
+        Define one or more actions to perform when successfully matching parse element definition.
+        Parse action fn is a callable method with 0-3 arguments, called as C{fn(s,loc,toks)},
+        C{fn(loc,toks)}, C{fn(toks)}, or just C{fn()}, where:
+         - s   = the original string being parsed (see note below)
+         - loc = the location of the matching substring
+         - toks = a list of the matched tokens, packaged as a C{L{ParseResults}} object
+        If the functions in fns modify the tokens, they can return them as the return
+        value from fn, and the modified list of tokens will replace the original.
+        Otherwise, fn does not need to return any value.
+
+        Optional keyword arguments:
+         - callDuringTry = (default=C{False}) indicate if parse action should be run during lookaheads and alternate testing
+
+        Note: the default parsing behavior is to expand tabs in the input string
+        before starting the parsing process.  See L{I{parseString}} for more information
+        on parsing strings containing C{}s, and suggested methods to maintain a
+        consistent view of the parsed string, the parse location, and line and column
+        positions within the parsed string.
+        
+        Example::
+            integer = Word(nums)
+            date_str = integer + '/' + integer + '/' + integer
+
+            date_str.parseString("1999/12/31")  # -> ['1999', '/', '12', '/', '31']
+
+            # use parse action to convert to ints at parse time
+            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
+            date_str = integer + '/' + integer + '/' + integer
+
+            # note that integer fields are now ints, not strings
+            date_str.parseString("1999/12/31")  # -> [1999, '/', 12, '/', 31]
+        """
+        self.parseAction = list(map(_trim_arity, list(fns)))
+        self.callDuringTry = kwargs.get("callDuringTry", False)
+        return self
+
+    def addParseAction( self, *fns, **kwargs ):
+        """
+        Add one or more parse actions to expression's list of parse actions. See L{I{setParseAction}}.
+        
+        See examples in L{I{copy}}.
+        """
+        self.parseAction += list(map(_trim_arity, list(fns)))
+        self.callDuringTry = self.callDuringTry or kwargs.get("callDuringTry", False)
+        return self
+
+    def addCondition(self, *fns, **kwargs):
+        """Add a boolean predicate function to expression's list of parse actions. See 
+        L{I{setParseAction}} for function call signatures. Unlike C{setParseAction}, 
+        functions passed to C{addCondition} need to return boolean success/fail of the condition.
+
+        Optional keyword arguments:
+         - message = define a custom message to be used in the raised exception
+         - fatal   = if True, will raise ParseFatalException to stop parsing immediately; otherwise will raise ParseException
+         
+        Example::
+            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
+            year_int = integer.copy()
+            year_int.addCondition(lambda toks: toks[0] >= 2000, message="Only support years 2000 and later")
+            date_str = year_int + '/' + integer + '/' + integer
+
+            result = date_str.parseString("1999/12/31")  # -> Exception: Only support years 2000 and later (at char 0), (line:1, col:1)
+        """
+        msg = kwargs.get("message", "failed user-defined condition")
+        exc_type = ParseFatalException if kwargs.get("fatal", False) else ParseException
+        for fn in fns:
+            def pa(s,l,t):
+                if not bool(_trim_arity(fn)(s,l,t)):
+                    raise exc_type(s,l,msg)
+            self.parseAction.append(pa)
+        self.callDuringTry = self.callDuringTry or kwargs.get("callDuringTry", False)
+        return self
+
+    def setFailAction( self, fn ):
+        """Define action to perform if parsing fails at this expression.
+           Fail acton fn is a callable function that takes the arguments
+           C{fn(s,loc,expr,err)} where:
+            - s = string being parsed
+            - loc = location where expression match was attempted and failed
+            - expr = the parse expression that failed
+            - err = the exception thrown
+           The function returns no value.  It may throw C{L{ParseFatalException}}
+           if it is desired to stop parsing immediately."""
+        self.failAction = fn
+        return self
+
+    def _skipIgnorables( self, instring, loc ):
+        exprsFound = True
+        while exprsFound:
+            exprsFound = False
+            for e in self.ignoreExprs:
+                try:
+                    while 1:
+                        loc,dummy = e._parse( instring, loc )
+                        exprsFound = True
+                except ParseException:
+                    pass
+        return loc
+
+    def preParse( self, instring, loc ):
+        if self.ignoreExprs:
+            loc = self._skipIgnorables( instring, loc )
+
+        if self.skipWhitespace:
+            wt = self.whiteChars
+            instrlen = len(instring)
+            while loc < instrlen and instring[loc] in wt:
+                loc += 1
+
+        return loc
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        return loc, []
+
+    def postParse( self, instring, loc, tokenlist ):
+        return tokenlist
+
+    #~ @profile
+    def _parseNoCache( self, instring, loc, doActions=True, callPreParse=True ):
+        debugging = ( self.debug ) #and doActions )
+
+        if debugging or self.failAction:
+            #~ print ("Match",self,"at loc",loc,"(%d,%d)" % ( lineno(loc,instring), col(loc,instring) ))
+            if (self.debugActions[0] ):
+                self.debugActions[0]( instring, loc, self )
+            if callPreParse and self.callPreparse:
+                preloc = self.preParse( instring, loc )
+            else:
+                preloc = loc
+            tokensStart = preloc
+            try:
+                try:
+                    loc,tokens = self.parseImpl( instring, preloc, doActions )
+                except IndexError:
+                    raise ParseException( instring, len(instring), self.errmsg, self )
+            except ParseBaseException as err:
+                #~ print ("Exception raised:", err)
+                if self.debugActions[2]:
+                    self.debugActions[2]( instring, tokensStart, self, err )
+                if self.failAction:
+                    self.failAction( instring, tokensStart, self, err )
+                raise
+        else:
+            if callPreParse and self.callPreparse:
+                preloc = self.preParse( instring, loc )
+            else:
+                preloc = loc
+            tokensStart = preloc
+            if self.mayIndexError or preloc >= len(instring):
+                try:
+                    loc,tokens = self.parseImpl( instring, preloc, doActions )
+                except IndexError:
+                    raise ParseException( instring, len(instring), self.errmsg, self )
+            else:
+                loc,tokens = self.parseImpl( instring, preloc, doActions )
+
+        tokens = self.postParse( instring, loc, tokens )
+
+        retTokens = ParseResults( tokens, self.resultsName, asList=self.saveAsList, modal=self.modalResults )
+        if self.parseAction and (doActions or self.callDuringTry):
+            if debugging:
+                try:
+                    for fn in self.parseAction:
+                        tokens = fn( instring, tokensStart, retTokens )
+                        if tokens is not None:
+                            retTokens = ParseResults( tokens,
+                                                      self.resultsName,
+                                                      asList=self.saveAsList and isinstance(tokens,(ParseResults,list)),
+                                                      modal=self.modalResults )
+                except ParseBaseException as err:
+                    #~ print "Exception raised in user parse action:", err
+                    if (self.debugActions[2] ):
+                        self.debugActions[2]( instring, tokensStart, self, err )
+                    raise
+            else:
+                for fn in self.parseAction:
+                    tokens = fn( instring, tokensStart, retTokens )
+                    if tokens is not None:
+                        retTokens = ParseResults( tokens,
+                                                  self.resultsName,
+                                                  asList=self.saveAsList and isinstance(tokens,(ParseResults,list)),
+                                                  modal=self.modalResults )
+        if debugging:
+            #~ print ("Matched",self,"->",retTokens.asList())
+            if (self.debugActions[1] ):
+                self.debugActions[1]( instring, tokensStart, loc, self, retTokens )
+
+        return loc, retTokens
+
+    def tryParse( self, instring, loc ):
+        try:
+            return self._parse( instring, loc, doActions=False )[0]
+        except ParseFatalException:
+            raise ParseException( instring, loc, self.errmsg, self)
+    
+    def canParseNext(self, instring, loc):
+        try:
+            self.tryParse(instring, loc)
+        except (ParseException, IndexError):
+            return False
+        else:
+            return True
+
+    class _UnboundedCache(object):
+        def __init__(self):
+            cache = {}
+            self.not_in_cache = not_in_cache = object()
+
+            def get(self, key):
+                return cache.get(key, not_in_cache)
+
+            def set(self, key, value):
+                cache[key] = value
+
+            def clear(self):
+                cache.clear()
+                
+            def cache_len(self):
+                return len(cache)
+
+            self.get = types.MethodType(get, self)
+            self.set = types.MethodType(set, self)
+            self.clear = types.MethodType(clear, self)
+            self.__len__ = types.MethodType(cache_len, self)
+
+    if _OrderedDict is not None:
+        class _FifoCache(object):
+            def __init__(self, size):
+                self.not_in_cache = not_in_cache = object()
+
+                cache = _OrderedDict()
+
+                def get(self, key):
+                    return cache.get(key, not_in_cache)
+
+                def set(self, key, value):
+                    cache[key] = value
+                    while len(cache) > size:
+                        try:
+                            cache.popitem(False)
+                        except KeyError:
+                            pass
+
+                def clear(self):
+                    cache.clear()
+
+                def cache_len(self):
+                    return len(cache)
+
+                self.get = types.MethodType(get, self)
+                self.set = types.MethodType(set, self)
+                self.clear = types.MethodType(clear, self)
+                self.__len__ = types.MethodType(cache_len, self)
+
+    else:
+        class _FifoCache(object):
+            def __init__(self, size):
+                self.not_in_cache = not_in_cache = object()
+
+                cache = {}
+                key_fifo = collections.deque([], size)
+
+                def get(self, key):
+                    return cache.get(key, not_in_cache)
+
+                def set(self, key, value):
+                    cache[key] = value
+                    while len(key_fifo) > size:
+                        cache.pop(key_fifo.popleft(), None)
+                    key_fifo.append(key)
+
+                def clear(self):
+                    cache.clear()
+                    key_fifo.clear()
+
+                def cache_len(self):
+                    return len(cache)
+
+                self.get = types.MethodType(get, self)
+                self.set = types.MethodType(set, self)
+                self.clear = types.MethodType(clear, self)
+                self.__len__ = types.MethodType(cache_len, self)
+
+    # argument cache for optimizing repeated calls when backtracking through recursive expressions
+    packrat_cache = {} # this is set later by enabledPackrat(); this is here so that resetCache() doesn't fail
+    packrat_cache_lock = RLock()
+    packrat_cache_stats = [0, 0]
+
+    # this method gets repeatedly called during backtracking with the same arguments -
+    # we can cache these arguments and save ourselves the trouble of re-parsing the contained expression
+    def _parseCache( self, instring, loc, doActions=True, callPreParse=True ):
+        HIT, MISS = 0, 1
+        lookup = (self, instring, loc, callPreParse, doActions)
+        with ParserElement.packrat_cache_lock:
+            cache = ParserElement.packrat_cache
+            value = cache.get(lookup)
+            if value is cache.not_in_cache:
+                ParserElement.packrat_cache_stats[MISS] += 1
+                try:
+                    value = self._parseNoCache(instring, loc, doActions, callPreParse)
+                except ParseBaseException as pe:
+                    # cache a copy of the exception, without the traceback
+                    cache.set(lookup, pe.__class__(*pe.args))
+                    raise
+                else:
+                    cache.set(lookup, (value[0], value[1].copy()))
+                    return value
+            else:
+                ParserElement.packrat_cache_stats[HIT] += 1
+                if isinstance(value, Exception):
+                    raise value
+                return (value[0], value[1].copy())
+
+    _parse = _parseNoCache
+
+    @staticmethod
+    def resetCache():
+        ParserElement.packrat_cache.clear()
+        ParserElement.packrat_cache_stats[:] = [0] * len(ParserElement.packrat_cache_stats)
+
+    _packratEnabled = False
+    @staticmethod
+    def enablePackrat(cache_size_limit=128):
+        """Enables "packrat" parsing, which adds memoizing to the parsing logic.
+           Repeated parse attempts at the same string location (which happens
+           often in many complex grammars) can immediately return a cached value,
+           instead of re-executing parsing/validating code.  Memoizing is done of
+           both valid results and parsing exceptions.
+           
+           Parameters:
+            - cache_size_limit - (default=C{128}) - if an integer value is provided
+              will limit the size of the packrat cache; if None is passed, then
+              the cache size will be unbounded; if 0 is passed, the cache will
+              be effectively disabled.
+            
+           This speedup may break existing programs that use parse actions that
+           have side-effects.  For this reason, packrat parsing is disabled when
+           you first import pyparsing.  To activate the packrat feature, your
+           program must call the class method C{ParserElement.enablePackrat()}.  If
+           your program uses C{psyco} to "compile as you go", you must call
+           C{enablePackrat} before calling C{psyco.full()}.  If you do not do this,
+           Python will crash.  For best results, call C{enablePackrat()} immediately
+           after importing pyparsing.
+           
+           Example::
+               import pyparsing
+               pyparsing.ParserElement.enablePackrat()
+        """
+        if not ParserElement._packratEnabled:
+            ParserElement._packratEnabled = True
+            if cache_size_limit is None:
+                ParserElement.packrat_cache = ParserElement._UnboundedCache()
+            else:
+                ParserElement.packrat_cache = ParserElement._FifoCache(cache_size_limit)
+            ParserElement._parse = ParserElement._parseCache
+
+    def parseString( self, instring, parseAll=False ):
+        """
+        Execute the parse expression with the given string.
+        This is the main interface to the client code, once the complete
+        expression has been built.
+
+        If you want the grammar to require that the entire input string be
+        successfully parsed, then set C{parseAll} to True (equivalent to ending
+        the grammar with C{L{StringEnd()}}).
+
+        Note: C{parseString} implicitly calls C{expandtabs()} on the input string,
+        in order to report proper column numbers in parse actions.
+        If the input string contains tabs and
+        the grammar uses parse actions that use the C{loc} argument to index into the
+        string being parsed, you can ensure you have a consistent view of the input
+        string by:
+         - calling C{parseWithTabs} on your grammar before calling C{parseString}
+           (see L{I{parseWithTabs}})
+         - define your parse action using the full C{(s,loc,toks)} signature, and
+           reference the input string using the parse action's C{s} argument
+         - explictly expand the tabs in your input string before calling
+           C{parseString}
+        
+        Example::
+            Word('a').parseString('aaaaabaaa')  # -> ['aaaaa']
+            Word('a').parseString('aaaaabaaa', parseAll=True)  # -> Exception: Expected end of text
+        """
+        ParserElement.resetCache()
+        if not self.streamlined:
+            self.streamline()
+            #~ self.saveAsList = True
+        for e in self.ignoreExprs:
+            e.streamline()
+        if not self.keepTabs:
+            instring = instring.expandtabs()
+        try:
+            loc, tokens = self._parse( instring, 0 )
+            if parseAll:
+                loc = self.preParse( instring, loc )
+                se = Empty() + StringEnd()
+                se._parse( instring, loc )
+        except ParseBaseException as exc:
+            if ParserElement.verbose_stacktrace:
+                raise
+            else:
+                # catch and re-raise exception from here, clears out pyparsing internal stack trace
+                raise exc
+        else:
+            return tokens
+
+    def scanString( self, instring, maxMatches=_MAX_INT, overlap=False ):
+        """
+        Scan the input string for expression matches.  Each match will return the
+        matching tokens, start location, and end location.  May be called with optional
+        C{maxMatches} argument, to clip scanning after 'n' matches are found.  If
+        C{overlap} is specified, then overlapping matches will be reported.
+
+        Note that the start and end locations are reported relative to the string
+        being parsed.  See L{I{parseString}} for more information on parsing
+        strings with embedded tabs.
+
+        Example::
+            source = "sldjf123lsdjjkf345sldkjf879lkjsfd987"
+            print(source)
+            for tokens,start,end in Word(alphas).scanString(source):
+                print(' '*start + '^'*(end-start))
+                print(' '*start + tokens[0])
+        
+        prints::
+        
+            sldjf123lsdjjkf345sldkjf879lkjsfd987
+            ^^^^^
+            sldjf
+                    ^^^^^^^
+                    lsdjjkf
+                              ^^^^^^
+                              sldkjf
+                                       ^^^^^^
+                                       lkjsfd
+        """
+        if not self.streamlined:
+            self.streamline()
+        for e in self.ignoreExprs:
+            e.streamline()
+
+        if not self.keepTabs:
+            instring = _ustr(instring).expandtabs()
+        instrlen = len(instring)
+        loc = 0
+        preparseFn = self.preParse
+        parseFn = self._parse
+        ParserElement.resetCache()
+        matches = 0
+        try:
+            while loc <= instrlen and matches < maxMatches:
+                try:
+                    preloc = preparseFn( instring, loc )
+                    nextLoc,tokens = parseFn( instring, preloc, callPreParse=False )
+                except ParseException:
+                    loc = preloc+1
+                else:
+                    if nextLoc > loc:
+                        matches += 1
+                        yield tokens, preloc, nextLoc
+                        if overlap:
+                            nextloc = preparseFn( instring, loc )
+                            if nextloc > loc:
+                                loc = nextLoc
+                            else:
+                                loc += 1
+                        else:
+                            loc = nextLoc
+                    else:
+                        loc = preloc+1
+        except ParseBaseException as exc:
+            if ParserElement.verbose_stacktrace:
+                raise
+            else:
+                # catch and re-raise exception from here, clears out pyparsing internal stack trace
+                raise exc
+
+    def transformString( self, instring ):
+        """
+        Extension to C{L{scanString}}, to modify matching text with modified tokens that may
+        be returned from a parse action.  To use C{transformString}, define a grammar and
+        attach a parse action to it that modifies the returned token list.
+        Invoking C{transformString()} on a target string will then scan for matches,
+        and replace the matched text patterns according to the logic in the parse
+        action.  C{transformString()} returns the resulting transformed string.
+        
+        Example::
+            wd = Word(alphas)
+            wd.setParseAction(lambda toks: toks[0].title())
+            
+            print(wd.transformString("now is the winter of our discontent made glorious summer by this sun of york."))
+        Prints::
+            Now Is The Winter Of Our Discontent Made Glorious Summer By This Sun Of York.
+        """
+        out = []
+        lastE = 0
+        # force preservation of s, to minimize unwanted transformation of string, and to
+        # keep string locs straight between transformString and scanString
+        self.keepTabs = True
+        try:
+            for t,s,e in self.scanString( instring ):
+                out.append( instring[lastE:s] )
+                if t:
+                    if isinstance(t,ParseResults):
+                        out += t.asList()
+                    elif isinstance(t,list):
+                        out += t
+                    else:
+                        out.append(t)
+                lastE = e
+            out.append(instring[lastE:])
+            out = [o for o in out if o]
+            return "".join(map(_ustr,_flatten(out)))
+        except ParseBaseException as exc:
+            if ParserElement.verbose_stacktrace:
+                raise
+            else:
+                # catch and re-raise exception from here, clears out pyparsing internal stack trace
+                raise exc
+
+    def searchString( self, instring, maxMatches=_MAX_INT ):
+        """
+        Another extension to C{L{scanString}}, simplifying the access to the tokens found
+        to match the given parse expression.  May be called with optional
+        C{maxMatches} argument, to clip searching after 'n' matches are found.
+        
+        Example::
+            # a capitalized word starts with an uppercase letter, followed by zero or more lowercase letters
+            cap_word = Word(alphas.upper(), alphas.lower())
+            
+            print(cap_word.searchString("More than Iron, more than Lead, more than Gold I need Electricity"))
+
+            # the sum() builtin can be used to merge results into a single ParseResults object
+            print(sum(cap_word.searchString("More than Iron, more than Lead, more than Gold I need Electricity")))
+        prints::
+            [['More'], ['Iron'], ['Lead'], ['Gold'], ['I'], ['Electricity']]
+            ['More', 'Iron', 'Lead', 'Gold', 'I', 'Electricity']
+        """
+        try:
+            return ParseResults([ t for t,s,e in self.scanString( instring, maxMatches ) ])
+        except ParseBaseException as exc:
+            if ParserElement.verbose_stacktrace:
+                raise
+            else:
+                # catch and re-raise exception from here, clears out pyparsing internal stack trace
+                raise exc
+
+    def split(self, instring, maxsplit=_MAX_INT, includeSeparators=False):
+        """
+        Generator method to split a string using the given expression as a separator.
+        May be called with optional C{maxsplit} argument, to limit the number of splits;
+        and the optional C{includeSeparators} argument (default=C{False}), if the separating
+        matching text should be included in the split results.
+        
+        Example::        
+            punc = oneOf(list(".,;:/-!?"))
+            print(list(punc.split("This, this?, this sentence, is badly punctuated!")))
+        prints::
+            ['This', ' this', '', ' this sentence', ' is badly punctuated', '']
+        """
+        splits = 0
+        last = 0
+        for t,s,e in self.scanString(instring, maxMatches=maxsplit):
+            yield instring[last:s]
+            if includeSeparators:
+                yield t[0]
+            last = e
+        yield instring[last:]
+
+    def __add__(self, other ):
+        """
+        Implementation of + operator - returns C{L{And}}. Adding strings to a ParserElement
+        converts them to L{Literal}s by default.
+        
+        Example::
+            greet = Word(alphas) + "," + Word(alphas) + "!"
+            hello = "Hello, World!"
+            print (hello, "->", greet.parseString(hello))
+        Prints::
+            Hello, World! -> ['Hello', ',', 'World', '!']
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return And( [ self, other ] )
+
+    def __radd__(self, other ):
+        """
+        Implementation of + operator when left operand is not a C{L{ParserElement}}
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return other + self
+
+    def __sub__(self, other):
+        """
+        Implementation of - operator, returns C{L{And}} with error stop
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return self + And._ErrorStop() + other
+
+    def __rsub__(self, other ):
+        """
+        Implementation of - operator when left operand is not a C{L{ParserElement}}
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return other - self
+
+    def __mul__(self,other):
+        """
+        Implementation of * operator, allows use of C{expr * 3} in place of
+        C{expr + expr + expr}.  Expressions may also me multiplied by a 2-integer
+        tuple, similar to C{{min,max}} multipliers in regular expressions.  Tuples
+        may also include C{None} as in:
+         - C{expr*(n,None)} or C{expr*(n,)} is equivalent
+              to C{expr*n + L{ZeroOrMore}(expr)}
+              (read as "at least n instances of C{expr}")
+         - C{expr*(None,n)} is equivalent to C{expr*(0,n)}
+              (read as "0 to n instances of C{expr}")
+         - C{expr*(None,None)} is equivalent to C{L{ZeroOrMore}(expr)}
+         - C{expr*(1,None)} is equivalent to C{L{OneOrMore}(expr)}
+
+        Note that C{expr*(None,n)} does not raise an exception if
+        more than n exprs exist in the input stream; that is,
+        C{expr*(None,n)} does not enforce a maximum number of expr
+        occurrences.  If this behavior is desired, then write
+        C{expr*(None,n) + ~expr}
+        """
+        if isinstance(other,int):
+            minElements, optElements = other,0
+        elif isinstance(other,tuple):
+            other = (other + (None, None))[:2]
+            if other[0] is None:
+                other = (0, other[1])
+            if isinstance(other[0],int) and other[1] is None:
+                if other[0] == 0:
+                    return ZeroOrMore(self)
+                if other[0] == 1:
+                    return OneOrMore(self)
+                else:
+                    return self*other[0] + ZeroOrMore(self)
+            elif isinstance(other[0],int) and isinstance(other[1],int):
+                minElements, optElements = other
+                optElements -= minElements
+            else:
+                raise TypeError("cannot multiply 'ParserElement' and ('%s','%s') objects", type(other[0]),type(other[1]))
+        else:
+            raise TypeError("cannot multiply 'ParserElement' and '%s' objects", type(other))
+
+        if minElements < 0:
+            raise ValueError("cannot multiply ParserElement by negative value")
+        if optElements < 0:
+            raise ValueError("second tuple value must be greater or equal to first tuple value")
+        if minElements == optElements == 0:
+            raise ValueError("cannot multiply ParserElement by 0 or (0,0)")
+
+        if (optElements):
+            def makeOptionalList(n):
+                if n>1:
+                    return Optional(self + makeOptionalList(n-1))
+                else:
+                    return Optional(self)
+            if minElements:
+                if minElements == 1:
+                    ret = self + makeOptionalList(optElements)
+                else:
+                    ret = And([self]*minElements) + makeOptionalList(optElements)
+            else:
+                ret = makeOptionalList(optElements)
+        else:
+            if minElements == 1:
+                ret = self
+            else:
+                ret = And([self]*minElements)
+        return ret
+
+    def __rmul__(self, other):
+        return self.__mul__(other)
+
+    def __or__(self, other ):
+        """
+        Implementation of | operator - returns C{L{MatchFirst}}
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return MatchFirst( [ self, other ] )
+
+    def __ror__(self, other ):
+        """
+        Implementation of | operator when left operand is not a C{L{ParserElement}}
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return other | self
+
+    def __xor__(self, other ):
+        """
+        Implementation of ^ operator - returns C{L{Or}}
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return Or( [ self, other ] )
+
+    def __rxor__(self, other ):
+        """
+        Implementation of ^ operator when left operand is not a C{L{ParserElement}}
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return other ^ self
+
+    def __and__(self, other ):
+        """
+        Implementation of & operator - returns C{L{Each}}
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return Each( [ self, other ] )
+
+    def __rand__(self, other ):
+        """
+        Implementation of & operator when left operand is not a C{L{ParserElement}}
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return other & self
+
+    def __invert__( self ):
+        """
+        Implementation of ~ operator - returns C{L{NotAny}}
+        """
+        return NotAny( self )
+
+    def __call__(self, name=None):
+        """
+        Shortcut for C{L{setResultsName}}, with C{listAllMatches=False}.
+        
+        If C{name} is given with a trailing C{'*'} character, then C{listAllMatches} will be
+        passed as C{True}.
+           
+        If C{name} is omitted, same as calling C{L{copy}}.
+
+        Example::
+            # these are equivalent
+            userdata = Word(alphas).setResultsName("name") + Word(nums+"-").setResultsName("socsecno")
+            userdata = Word(alphas)("name") + Word(nums+"-")("socsecno")             
+        """
+        if name is not None:
+            return self.setResultsName(name)
+        else:
+            return self.copy()
+
+    def suppress( self ):
+        """
+        Suppresses the output of this C{ParserElement}; useful to keep punctuation from
+        cluttering up returned output.
+        """
+        return Suppress( self )
+
+    def leaveWhitespace( self ):
+        """
+        Disables the skipping of whitespace before matching the characters in the
+        C{ParserElement}'s defined pattern.  This is normally only used internally by
+        the pyparsing module, but may be needed in some whitespace-sensitive grammars.
+        """
+        self.skipWhitespace = False
+        return self
+
+    def setWhitespaceChars( self, chars ):
+        """
+        Overrides the default whitespace chars
+        """
+        self.skipWhitespace = True
+        self.whiteChars = chars
+        self.copyDefaultWhiteChars = False
+        return self
+
+    def parseWithTabs( self ):
+        """
+        Overrides default behavior to expand C{}s to spaces before parsing the input string.
+        Must be called before C{parseString} when the input grammar contains elements that
+        match C{} characters.
+        """
+        self.keepTabs = True
+        return self
+
+    def ignore( self, other ):
+        """
+        Define expression to be ignored (e.g., comments) while doing pattern
+        matching; may be called repeatedly, to define multiple comment or other
+        ignorable patterns.
+        
+        Example::
+            patt = OneOrMore(Word(alphas))
+            patt.parseString('ablaj /* comment */ lskjd') # -> ['ablaj']
+            
+            patt.ignore(cStyleComment)
+            patt.parseString('ablaj /* comment */ lskjd') # -> ['ablaj', 'lskjd']
+        """
+        if isinstance(other, basestring):
+            other = Suppress(other)
+
+        if isinstance( other, Suppress ):
+            if other not in self.ignoreExprs:
+                self.ignoreExprs.append(other)
+        else:
+            self.ignoreExprs.append( Suppress( other.copy() ) )
+        return self
+
+    def setDebugActions( self, startAction, successAction, exceptionAction ):
+        """
+        Enable display of debugging messages while doing pattern matching.
+        """
+        self.debugActions = (startAction or _defaultStartDebugAction,
+                             successAction or _defaultSuccessDebugAction,
+                             exceptionAction or _defaultExceptionDebugAction)
+        self.debug = True
+        return self
+
+    def setDebug( self, flag=True ):
+        """
+        Enable display of debugging messages while doing pattern matching.
+        Set C{flag} to True to enable, False to disable.
+
+        Example::
+            wd = Word(alphas).setName("alphaword")
+            integer = Word(nums).setName("numword")
+            term = wd | integer
+            
+            # turn on debugging for wd
+            wd.setDebug()
+
+            OneOrMore(term).parseString("abc 123 xyz 890")
+        
+        prints::
+            Match alphaword at loc 0(1,1)
+            Matched alphaword -> ['abc']
+            Match alphaword at loc 3(1,4)
+            Exception raised:Expected alphaword (at char 4), (line:1, col:5)
+            Match alphaword at loc 7(1,8)
+            Matched alphaword -> ['xyz']
+            Match alphaword at loc 11(1,12)
+            Exception raised:Expected alphaword (at char 12), (line:1, col:13)
+            Match alphaword at loc 15(1,16)
+            Exception raised:Expected alphaword (at char 15), (line:1, col:16)
+
+        The output shown is that produced by the default debug actions - custom debug actions can be
+        specified using L{setDebugActions}. Prior to attempting
+        to match the C{wd} expression, the debugging message C{"Match  at loc (,)"}
+        is shown. Then if the parse succeeds, a C{"Matched"} message is shown, or an C{"Exception raised"}
+        message is shown. Also note the use of L{setName} to assign a human-readable name to the expression,
+        which makes debugging and exception messages easier to understand - for instance, the default
+        name created for the C{Word} expression without calling C{setName} is C{"W:(ABCD...)"}.
+        """
+        if flag:
+            self.setDebugActions( _defaultStartDebugAction, _defaultSuccessDebugAction, _defaultExceptionDebugAction )
+        else:
+            self.debug = False
+        return self
+
+    def __str__( self ):
+        return self.name
+
+    def __repr__( self ):
+        return _ustr(self)
+
+    def streamline( self ):
+        self.streamlined = True
+        self.strRepr = None
+        return self
+
+    def checkRecursion( self, parseElementList ):
+        pass
+
+    def validate( self, validateTrace=[] ):
+        """
+        Check defined expressions for valid structure, check for infinite recursive definitions.
+        """
+        self.checkRecursion( [] )
+
+    def parseFile( self, file_or_filename, parseAll=False ):
+        """
+        Execute the parse expression on the given file or filename.
+        If a filename is specified (instead of a file object),
+        the entire file is opened, read, and closed before parsing.
+        """
+        try:
+            file_contents = file_or_filename.read()
+        except AttributeError:
+            with open(file_or_filename, "r") as f:
+                file_contents = f.read()
+        try:
+            return self.parseString(file_contents, parseAll)
+        except ParseBaseException as exc:
+            if ParserElement.verbose_stacktrace:
+                raise
+            else:
+                # catch and re-raise exception from here, clears out pyparsing internal stack trace
+                raise exc
+
+    def __eq__(self,other):
+        if isinstance(other, ParserElement):
+            return self is other or vars(self) == vars(other)
+        elif isinstance(other, basestring):
+            return self.matches(other)
+        else:
+            return super(ParserElement,self)==other
+
+    def __ne__(self,other):
+        return not (self == other)
+
+    def __hash__(self):
+        return hash(id(self))
+
+    def __req__(self,other):
+        return self == other
+
+    def __rne__(self,other):
+        return not (self == other)
+
+    def matches(self, testString, parseAll=True):
+        """
+        Method for quick testing of a parser against a test string. Good for simple 
+        inline microtests of sub expressions while building up larger parser.
+           
+        Parameters:
+         - testString - to test against this expression for a match
+         - parseAll - (default=C{True}) - flag to pass to C{L{parseString}} when running tests
+            
+        Example::
+            expr = Word(nums)
+            assert expr.matches("100")
+        """
+        try:
+            self.parseString(_ustr(testString), parseAll=parseAll)
+            return True
+        except ParseBaseException:
+            return False
+                
+    def runTests(self, tests, parseAll=True, comment='#', fullDump=True, printResults=True, failureTests=False):
+        """
+        Execute the parse expression on a series of test strings, showing each
+        test, the parsed results or where the parse failed. Quick and easy way to
+        run a parse expression against a list of sample strings.
+           
+        Parameters:
+         - tests - a list of separate test strings, or a multiline string of test strings
+         - parseAll - (default=C{True}) - flag to pass to C{L{parseString}} when running tests           
+         - comment - (default=C{'#'}) - expression for indicating embedded comments in the test 
+              string; pass None to disable comment filtering
+         - fullDump - (default=C{True}) - dump results as list followed by results names in nested outline;
+              if False, only dump nested list
+         - printResults - (default=C{True}) prints test output to stdout
+         - failureTests - (default=C{False}) indicates if these tests are expected to fail parsing
+
+        Returns: a (success, results) tuple, where success indicates that all tests succeeded
+        (or failed if C{failureTests} is True), and the results contain a list of lines of each 
+        test's output
+        
+        Example::
+            number_expr = pyparsing_common.number.copy()
+
+            result = number_expr.runTests('''
+                # unsigned integer
+                100
+                # negative integer
+                -100
+                # float with scientific notation
+                6.02e23
+                # integer with scientific notation
+                1e-12
+                ''')
+            print("Success" if result[0] else "Failed!")
+
+            result = number_expr.runTests('''
+                # stray character
+                100Z
+                # missing leading digit before '.'
+                -.100
+                # too many '.'
+                3.14.159
+                ''', failureTests=True)
+            print("Success" if result[0] else "Failed!")
+        prints::
+            # unsigned integer
+            100
+            [100]
+
+            # negative integer
+            -100
+            [-100]
+
+            # float with scientific notation
+            6.02e23
+            [6.02e+23]
+
+            # integer with scientific notation
+            1e-12
+            [1e-12]
+
+            Success
+            
+            # stray character
+            100Z
+               ^
+            FAIL: Expected end of text (at char 3), (line:1, col:4)
+
+            # missing leading digit before '.'
+            -.100
+            ^
+            FAIL: Expected {real number with scientific notation | real number | signed integer} (at char 0), (line:1, col:1)
+
+            # too many '.'
+            3.14.159
+                ^
+            FAIL: Expected end of text (at char 4), (line:1, col:5)
+
+            Success
+
+        Each test string must be on a single line. If you want to test a string that spans multiple
+        lines, create a test like this::
+
+            expr.runTest(r"this is a test\\n of strings that spans \\n 3 lines")
+        
+        (Note that this is a raw string literal, you must include the leading 'r'.)
+        """
+        if isinstance(tests, basestring):
+            tests = list(map(str.strip, tests.rstrip().splitlines()))
+        if isinstance(comment, basestring):
+            comment = Literal(comment)
+        allResults = []
+        comments = []
+        success = True
+        for t in tests:
+            if comment is not None and comment.matches(t, False) or comments and not t:
+                comments.append(t)
+                continue
+            if not t:
+                continue
+            out = ['\n'.join(comments), t]
+            comments = []
+            try:
+                t = t.replace(r'\n','\n')
+                result = self.parseString(t, parseAll=parseAll)
+                out.append(result.dump(full=fullDump))
+                success = success and not failureTests
+            except ParseBaseException as pe:
+                fatal = "(FATAL)" if isinstance(pe, ParseFatalException) else ""
+                if '\n' in t:
+                    out.append(line(pe.loc, t))
+                    out.append(' '*(col(pe.loc,t)-1) + '^' + fatal)
+                else:
+                    out.append(' '*pe.loc + '^' + fatal)
+                out.append("FAIL: " + str(pe))
+                success = success and failureTests
+                result = pe
+            except Exception as exc:
+                out.append("FAIL-EXCEPTION: " + str(exc))
+                success = success and failureTests
+                result = exc
+
+            if printResults:
+                if fullDump:
+                    out.append('')
+                print('\n'.join(out))
+
+            allResults.append((t, result))
+        
+        return success, allResults
+
+        
+class Token(ParserElement):
+    """
+    Abstract C{ParserElement} subclass, for defining atomic matching patterns.
+    """
+    def __init__( self ):
+        super(Token,self).__init__( savelist=False )
+
+
+class Empty(Token):
+    """
+    An empty token, will always match.
+    """
+    def __init__( self ):
+        super(Empty,self).__init__()
+        self.name = "Empty"
+        self.mayReturnEmpty = True
+        self.mayIndexError = False
+
+
+class NoMatch(Token):
+    """
+    A token that will never match.
+    """
+    def __init__( self ):
+        super(NoMatch,self).__init__()
+        self.name = "NoMatch"
+        self.mayReturnEmpty = True
+        self.mayIndexError = False
+        self.errmsg = "Unmatchable token"
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        raise ParseException(instring, loc, self.errmsg, self)
+
+
+class Literal(Token):
+    """
+    Token to exactly match a specified string.
+    
+    Example::
+        Literal('blah').parseString('blah')  # -> ['blah']
+        Literal('blah').parseString('blahfooblah')  # -> ['blah']
+        Literal('blah').parseString('bla')  # -> Exception: Expected "blah"
+    
+    For case-insensitive matching, use L{CaselessLiteral}.
+    
+    For keyword matching (force word break before and after the matched string),
+    use L{Keyword} or L{CaselessKeyword}.
+    """
+    def __init__( self, matchString ):
+        super(Literal,self).__init__()
+        self.match = matchString
+        self.matchLen = len(matchString)
+        try:
+            self.firstMatchChar = matchString[0]
+        except IndexError:
+            warnings.warn("null string passed to Literal; use Empty() instead",
+                            SyntaxWarning, stacklevel=2)
+            self.__class__ = Empty
+        self.name = '"%s"' % _ustr(self.match)
+        self.errmsg = "Expected " + self.name
+        self.mayReturnEmpty = False
+        self.mayIndexError = False
+
+    # Performance tuning: this routine gets called a *lot*
+    # if this is a single character match string  and the first character matches,
+    # short-circuit as quickly as possible, and avoid calling startswith
+    #~ @profile
+    def parseImpl( self, instring, loc, doActions=True ):
+        if (instring[loc] == self.firstMatchChar and
+            (self.matchLen==1 or instring.startswith(self.match,loc)) ):
+            return loc+self.matchLen, self.match
+        raise ParseException(instring, loc, self.errmsg, self)
+_L = Literal
+ParserElement._literalStringClass = Literal
+
+class Keyword(Token):
+    """
+    Token to exactly match a specified string as a keyword, that is, it must be
+    immediately followed by a non-keyword character.  Compare with C{L{Literal}}:
+     - C{Literal("if")} will match the leading C{'if'} in C{'ifAndOnlyIf'}.
+     - C{Keyword("if")} will not; it will only match the leading C{'if'} in C{'if x=1'}, or C{'if(y==2)'}
+    Accepts two optional constructor arguments in addition to the keyword string:
+     - C{identChars} is a string of characters that would be valid identifier characters,
+          defaulting to all alphanumerics + "_" and "$"
+     - C{caseless} allows case-insensitive matching, default is C{False}.
+       
+    Example::
+        Keyword("start").parseString("start")  # -> ['start']
+        Keyword("start").parseString("starting")  # -> Exception
+
+    For case-insensitive matching, use L{CaselessKeyword}.
+    """
+    DEFAULT_KEYWORD_CHARS = alphanums+"_$"
+
+    def __init__( self, matchString, identChars=None, caseless=False ):
+        super(Keyword,self).__init__()
+        if identChars is None:
+            identChars = Keyword.DEFAULT_KEYWORD_CHARS
+        self.match = matchString
+        self.matchLen = len(matchString)
+        try:
+            self.firstMatchChar = matchString[0]
+        except IndexError:
+            warnings.warn("null string passed to Keyword; use Empty() instead",
+                            SyntaxWarning, stacklevel=2)
+        self.name = '"%s"' % self.match
+        self.errmsg = "Expected " + self.name
+        self.mayReturnEmpty = False
+        self.mayIndexError = False
+        self.caseless = caseless
+        if caseless:
+            self.caselessmatch = matchString.upper()
+            identChars = identChars.upper()
+        self.identChars = set(identChars)
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if self.caseless:
+            if ( (instring[ loc:loc+self.matchLen ].upper() == self.caselessmatch) and
+                 (loc >= len(instring)-self.matchLen or instring[loc+self.matchLen].upper() not in self.identChars) and
+                 (loc == 0 or instring[loc-1].upper() not in self.identChars) ):
+                return loc+self.matchLen, self.match
+        else:
+            if (instring[loc] == self.firstMatchChar and
+                (self.matchLen==1 or instring.startswith(self.match,loc)) and
+                (loc >= len(instring)-self.matchLen or instring[loc+self.matchLen] not in self.identChars) and
+                (loc == 0 or instring[loc-1] not in self.identChars) ):
+                return loc+self.matchLen, self.match
+        raise ParseException(instring, loc, self.errmsg, self)
+
+    def copy(self):
+        c = super(Keyword,self).copy()
+        c.identChars = Keyword.DEFAULT_KEYWORD_CHARS
+        return c
+
+    @staticmethod
+    def setDefaultKeywordChars( chars ):
+        """Overrides the default Keyword chars
+        """
+        Keyword.DEFAULT_KEYWORD_CHARS = chars
+
+class CaselessLiteral(Literal):
+    """
+    Token to match a specified string, ignoring case of letters.
+    Note: the matched results will always be in the case of the given
+    match string, NOT the case of the input text.
+
+    Example::
+        OneOrMore(CaselessLiteral("CMD")).parseString("cmd CMD Cmd10") # -> ['CMD', 'CMD', 'CMD']
+        
+    (Contrast with example for L{CaselessKeyword}.)
+    """
+    def __init__( self, matchString ):
+        super(CaselessLiteral,self).__init__( matchString.upper() )
+        # Preserve the defining literal.
+        self.returnString = matchString
+        self.name = "'%s'" % self.returnString
+        self.errmsg = "Expected " + self.name
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if instring[ loc:loc+self.matchLen ].upper() == self.match:
+            return loc+self.matchLen, self.returnString
+        raise ParseException(instring, loc, self.errmsg, self)
+
+class CaselessKeyword(Keyword):
+    """
+    Caseless version of L{Keyword}.
+
+    Example::
+        OneOrMore(CaselessKeyword("CMD")).parseString("cmd CMD Cmd10") # -> ['CMD', 'CMD']
+        
+    (Contrast with example for L{CaselessLiteral}.)
+    """
+    def __init__( self, matchString, identChars=None ):
+        super(CaselessKeyword,self).__init__( matchString, identChars, caseless=True )
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if ( (instring[ loc:loc+self.matchLen ].upper() == self.caselessmatch) and
+             (loc >= len(instring)-self.matchLen or instring[loc+self.matchLen].upper() not in self.identChars) ):
+            return loc+self.matchLen, self.match
+        raise ParseException(instring, loc, self.errmsg, self)
+
+class CloseMatch(Token):
+    """
+    A variation on L{Literal} which matches "close" matches, that is, 
+    strings with at most 'n' mismatching characters. C{CloseMatch} takes parameters:
+     - C{match_string} - string to be matched
+     - C{maxMismatches} - (C{default=1}) maximum number of mismatches allowed to count as a match
+    
+    The results from a successful parse will contain the matched text from the input string and the following named results:
+     - C{mismatches} - a list of the positions within the match_string where mismatches were found
+     - C{original} - the original match_string used to compare against the input string
+    
+    If C{mismatches} is an empty list, then the match was an exact match.
+    
+    Example::
+        patt = CloseMatch("ATCATCGAATGGA")
+        patt.parseString("ATCATCGAAXGGA") # -> (['ATCATCGAAXGGA'], {'mismatches': [[9]], 'original': ['ATCATCGAATGGA']})
+        patt.parseString("ATCAXCGAAXGGA") # -> Exception: Expected 'ATCATCGAATGGA' (with up to 1 mismatches) (at char 0), (line:1, col:1)
+
+        # exact match
+        patt.parseString("ATCATCGAATGGA") # -> (['ATCATCGAATGGA'], {'mismatches': [[]], 'original': ['ATCATCGAATGGA']})
+
+        # close match allowing up to 2 mismatches
+        patt = CloseMatch("ATCATCGAATGGA", maxMismatches=2)
+        patt.parseString("ATCAXCGAAXGGA") # -> (['ATCAXCGAAXGGA'], {'mismatches': [[4, 9]], 'original': ['ATCATCGAATGGA']})
+    """
+    def __init__(self, match_string, maxMismatches=1):
+        super(CloseMatch,self).__init__()
+        self.name = match_string
+        self.match_string = match_string
+        self.maxMismatches = maxMismatches
+        self.errmsg = "Expected %r (with up to %d mismatches)" % (self.match_string, self.maxMismatches)
+        self.mayIndexError = False
+        self.mayReturnEmpty = False
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        start = loc
+        instrlen = len(instring)
+        maxloc = start + len(self.match_string)
+
+        if maxloc <= instrlen:
+            match_string = self.match_string
+            match_stringloc = 0
+            mismatches = []
+            maxMismatches = self.maxMismatches
+
+            for match_stringloc,s_m in enumerate(zip(instring[loc:maxloc], self.match_string)):
+                src,mat = s_m
+                if src != mat:
+                    mismatches.append(match_stringloc)
+                    if len(mismatches) > maxMismatches:
+                        break
+            else:
+                loc = match_stringloc + 1
+                results = ParseResults([instring[start:loc]])
+                results['original'] = self.match_string
+                results['mismatches'] = mismatches
+                return loc, results
+
+        raise ParseException(instring, loc, self.errmsg, self)
+
+
+class Word(Token):
+    """
+    Token for matching words composed of allowed character sets.
+    Defined with string containing all allowed initial characters,
+    an optional string containing allowed body characters (if omitted,
+    defaults to the initial character set), and an optional minimum,
+    maximum, and/or exact length.  The default value for C{min} is 1 (a
+    minimum value < 1 is not valid); the default values for C{max} and C{exact}
+    are 0, meaning no maximum or exact length restriction. An optional
+    C{excludeChars} parameter can list characters that might be found in 
+    the input C{bodyChars} string; useful to define a word of all printables
+    except for one or two characters, for instance.
+    
+    L{srange} is useful for defining custom character set strings for defining 
+    C{Word} expressions, using range notation from regular expression character sets.
+    
+    A common mistake is to use C{Word} to match a specific literal string, as in 
+    C{Word("Address")}. Remember that C{Word} uses the string argument to define
+    I{sets} of matchable characters. This expression would match "Add", "AAA",
+    "dAred", or any other word made up of the characters 'A', 'd', 'r', 'e', and 's'.
+    To match an exact literal string, use L{Literal} or L{Keyword}.
+
+    pyparsing includes helper strings for building Words:
+     - L{alphas}
+     - L{nums}
+     - L{alphanums}
+     - L{hexnums}
+     - L{alphas8bit} (alphabetic characters in ASCII range 128-255 - accented, tilded, umlauted, etc.)
+     - L{punc8bit} (non-alphabetic characters in ASCII range 128-255 - currency, symbols, superscripts, diacriticals, etc.)
+     - L{printables} (any non-whitespace character)
+
+    Example::
+        # a word composed of digits
+        integer = Word(nums) # equivalent to Word("0123456789") or Word(srange("0-9"))
+        
+        # a word with a leading capital, and zero or more lowercase
+        capital_word = Word(alphas.upper(), alphas.lower())
+
+        # hostnames are alphanumeric, with leading alpha, and '-'
+        hostname = Word(alphas, alphanums+'-')
+        
+        # roman numeral (not a strict parser, accepts invalid mix of characters)
+        roman = Word("IVXLCDM")
+        
+        # any string of non-whitespace characters, except for ','
+        csv_value = Word(printables, excludeChars=",")
+    """
+    def __init__( self, initChars, bodyChars=None, min=1, max=0, exact=0, asKeyword=False, excludeChars=None ):
+        super(Word,self).__init__()
+        if excludeChars:
+            initChars = ''.join(c for c in initChars if c not in excludeChars)
+            if bodyChars:
+                bodyChars = ''.join(c for c in bodyChars if c not in excludeChars)
+        self.initCharsOrig = initChars
+        self.initChars = set(initChars)
+        if bodyChars :
+            self.bodyCharsOrig = bodyChars
+            self.bodyChars = set(bodyChars)
+        else:
+            self.bodyCharsOrig = initChars
+            self.bodyChars = set(initChars)
+
+        self.maxSpecified = max > 0
+
+        if min < 1:
+            raise ValueError("cannot specify a minimum length < 1; use Optional(Word()) if zero-length word is permitted")
+
+        self.minLen = min
+
+        if max > 0:
+            self.maxLen = max
+        else:
+            self.maxLen = _MAX_INT
+
+        if exact > 0:
+            self.maxLen = exact
+            self.minLen = exact
+
+        self.name = _ustr(self)
+        self.errmsg = "Expected " + self.name
+        self.mayIndexError = False
+        self.asKeyword = asKeyword
+
+        if ' ' not in self.initCharsOrig+self.bodyCharsOrig and (min==1 and max==0 and exact==0):
+            if self.bodyCharsOrig == self.initCharsOrig:
+                self.reString = "[%s]+" % _escapeRegexRangeChars(self.initCharsOrig)
+            elif len(self.initCharsOrig) == 1:
+                self.reString = "%s[%s]*" % \
+                                      (re.escape(self.initCharsOrig),
+                                      _escapeRegexRangeChars(self.bodyCharsOrig),)
+            else:
+                self.reString = "[%s][%s]*" % \
+                                      (_escapeRegexRangeChars(self.initCharsOrig),
+                                      _escapeRegexRangeChars(self.bodyCharsOrig),)
+            if self.asKeyword:
+                self.reString = r"\b"+self.reString+r"\b"
+            try:
+                self.re = re.compile( self.reString )
+            except Exception:
+                self.re = None
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if self.re:
+            result = self.re.match(instring,loc)
+            if not result:
+                raise ParseException(instring, loc, self.errmsg, self)
+
+            loc = result.end()
+            return loc, result.group()
+
+        if not(instring[ loc ] in self.initChars):
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        start = loc
+        loc += 1
+        instrlen = len(instring)
+        bodychars = self.bodyChars
+        maxloc = start + self.maxLen
+        maxloc = min( maxloc, instrlen )
+        while loc < maxloc and instring[loc] in bodychars:
+            loc += 1
+
+        throwException = False
+        if loc - start < self.minLen:
+            throwException = True
+        if self.maxSpecified and loc < instrlen and instring[loc] in bodychars:
+            throwException = True
+        if self.asKeyword:
+            if (start>0 and instring[start-1] in bodychars) or (loc4:
+                    return s[:4]+"..."
+                else:
+                    return s
+
+            if ( self.initCharsOrig != self.bodyCharsOrig ):
+                self.strRepr = "W:(%s,%s)" % ( charsAsStr(self.initCharsOrig), charsAsStr(self.bodyCharsOrig) )
+            else:
+                self.strRepr = "W:(%s)" % charsAsStr(self.initCharsOrig)
+
+        return self.strRepr
+
+
+class Regex(Token):
+    r"""
+    Token for matching strings that match a given regular expression.
+    Defined with string specifying the regular expression in a form recognized by the inbuilt Python re module.
+    If the given regex contains named groups (defined using C{(?P...)}), these will be preserved as 
+    named parse results.
+
+    Example::
+        realnum = Regex(r"[+-]?\d+\.\d*")
+        date = Regex(r'(?P\d{4})-(?P\d\d?)-(?P\d\d?)')
+        # ref: http://stackoverflow.com/questions/267399/how-do-you-match-only-valid-roman-numerals-with-a-regular-expression
+        roman = Regex(r"M{0,4}(CM|CD|D?C{0,3})(XC|XL|L?X{0,3})(IX|IV|V?I{0,3})")
+    """
+    compiledREtype = type(re.compile("[A-Z]"))
+    def __init__( self, pattern, flags=0):
+        """The parameters C{pattern} and C{flags} are passed to the C{re.compile()} function as-is. See the Python C{re} module for an explanation of the acceptable patterns and flags."""
+        super(Regex,self).__init__()
+
+        if isinstance(pattern, basestring):
+            if not pattern:
+                warnings.warn("null string passed to Regex; use Empty() instead",
+                        SyntaxWarning, stacklevel=2)
+
+            self.pattern = pattern
+            self.flags = flags
+
+            try:
+                self.re = re.compile(self.pattern, self.flags)
+                self.reString = self.pattern
+            except sre_constants.error:
+                warnings.warn("invalid pattern (%s) passed to Regex" % pattern,
+                    SyntaxWarning, stacklevel=2)
+                raise
+
+        elif isinstance(pattern, Regex.compiledREtype):
+            self.re = pattern
+            self.pattern = \
+            self.reString = str(pattern)
+            self.flags = flags
+            
+        else:
+            raise ValueError("Regex may only be constructed with a string or a compiled RE object")
+
+        self.name = _ustr(self)
+        self.errmsg = "Expected " + self.name
+        self.mayIndexError = False
+        self.mayReturnEmpty = True
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        result = self.re.match(instring,loc)
+        if not result:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        loc = result.end()
+        d = result.groupdict()
+        ret = ParseResults(result.group())
+        if d:
+            for k in d:
+                ret[k] = d[k]
+        return loc,ret
+
+    def __str__( self ):
+        try:
+            return super(Regex,self).__str__()
+        except Exception:
+            pass
+
+        if self.strRepr is None:
+            self.strRepr = "Re:(%s)" % repr(self.pattern)
+
+        return self.strRepr
+
+
+class QuotedString(Token):
+    r"""
+    Token for matching strings that are delimited by quoting characters.
+    
+    Defined with the following parameters:
+        - quoteChar - string of one or more characters defining the quote delimiting string
+        - escChar - character to escape quotes, typically backslash (default=C{None})
+        - escQuote - special quote sequence to escape an embedded quote string (such as SQL's "" to escape an embedded ") (default=C{None})
+        - multiline - boolean indicating whether quotes can span multiple lines (default=C{False})
+        - unquoteResults - boolean indicating whether the matched text should be unquoted (default=C{True})
+        - endQuoteChar - string of one or more characters defining the end of the quote delimited string (default=C{None} => same as quoteChar)
+        - convertWhitespaceEscapes - convert escaped whitespace (C{'\t'}, C{'\n'}, etc.) to actual whitespace (default=C{True})
+
+    Example::
+        qs = QuotedString('"')
+        print(qs.searchString('lsjdf "This is the quote" sldjf'))
+        complex_qs = QuotedString('{{', endQuoteChar='}}')
+        print(complex_qs.searchString('lsjdf {{This is the "quote"}} sldjf'))
+        sql_qs = QuotedString('"', escQuote='""')
+        print(sql_qs.searchString('lsjdf "This is the quote with ""embedded"" quotes" sldjf'))
+    prints::
+        [['This is the quote']]
+        [['This is the "quote"']]
+        [['This is the quote with "embedded" quotes']]
+    """
+    def __init__( self, quoteChar, escChar=None, escQuote=None, multiline=False, unquoteResults=True, endQuoteChar=None, convertWhitespaceEscapes=True):
+        super(QuotedString,self).__init__()
+
+        # remove white space from quote chars - wont work anyway
+        quoteChar = quoteChar.strip()
+        if not quoteChar:
+            warnings.warn("quoteChar cannot be the empty string",SyntaxWarning,stacklevel=2)
+            raise SyntaxError()
+
+        if endQuoteChar is None:
+            endQuoteChar = quoteChar
+        else:
+            endQuoteChar = endQuoteChar.strip()
+            if not endQuoteChar:
+                warnings.warn("endQuoteChar cannot be the empty string",SyntaxWarning,stacklevel=2)
+                raise SyntaxError()
+
+        self.quoteChar = quoteChar
+        self.quoteCharLen = len(quoteChar)
+        self.firstQuoteChar = quoteChar[0]
+        self.endQuoteChar = endQuoteChar
+        self.endQuoteCharLen = len(endQuoteChar)
+        self.escChar = escChar
+        self.escQuote = escQuote
+        self.unquoteResults = unquoteResults
+        self.convertWhitespaceEscapes = convertWhitespaceEscapes
+
+        if multiline:
+            self.flags = re.MULTILINE | re.DOTALL
+            self.pattern = r'%s(?:[^%s%s]' % \
+                ( re.escape(self.quoteChar),
+                  _escapeRegexRangeChars(self.endQuoteChar[0]),
+                  (escChar is not None and _escapeRegexRangeChars(escChar) or '') )
+        else:
+            self.flags = 0
+            self.pattern = r'%s(?:[^%s\n\r%s]' % \
+                ( re.escape(self.quoteChar),
+                  _escapeRegexRangeChars(self.endQuoteChar[0]),
+                  (escChar is not None and _escapeRegexRangeChars(escChar) or '') )
+        if len(self.endQuoteChar) > 1:
+            self.pattern += (
+                '|(?:' + ')|(?:'.join("%s[^%s]" % (re.escape(self.endQuoteChar[:i]),
+                                               _escapeRegexRangeChars(self.endQuoteChar[i]))
+                                    for i in range(len(self.endQuoteChar)-1,0,-1)) + ')'
+                )
+        if escQuote:
+            self.pattern += (r'|(?:%s)' % re.escape(escQuote))
+        if escChar:
+            self.pattern += (r'|(?:%s.)' % re.escape(escChar))
+            self.escCharReplacePattern = re.escape(self.escChar)+"(.)"
+        self.pattern += (r')*%s' % re.escape(self.endQuoteChar))
+
+        try:
+            self.re = re.compile(self.pattern, self.flags)
+            self.reString = self.pattern
+        except sre_constants.error:
+            warnings.warn("invalid pattern (%s) passed to Regex" % self.pattern,
+                SyntaxWarning, stacklevel=2)
+            raise
+
+        self.name = _ustr(self)
+        self.errmsg = "Expected " + self.name
+        self.mayIndexError = False
+        self.mayReturnEmpty = True
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        result = instring[loc] == self.firstQuoteChar and self.re.match(instring,loc) or None
+        if not result:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        loc = result.end()
+        ret = result.group()
+
+        if self.unquoteResults:
+
+            # strip off quotes
+            ret = ret[self.quoteCharLen:-self.endQuoteCharLen]
+
+            if isinstance(ret,basestring):
+                # replace escaped whitespace
+                if '\\' in ret and self.convertWhitespaceEscapes:
+                    ws_map = {
+                        r'\t' : '\t',
+                        r'\n' : '\n',
+                        r'\f' : '\f',
+                        r'\r' : '\r',
+                    }
+                    for wslit,wschar in ws_map.items():
+                        ret = ret.replace(wslit, wschar)
+
+                # replace escaped characters
+                if self.escChar:
+                    ret = re.sub(self.escCharReplacePattern, r"\g<1>", ret)
+
+                # replace escaped quotes
+                if self.escQuote:
+                    ret = ret.replace(self.escQuote, self.endQuoteChar)
+
+        return loc, ret
+
+    def __str__( self ):
+        try:
+            return super(QuotedString,self).__str__()
+        except Exception:
+            pass
+
+        if self.strRepr is None:
+            self.strRepr = "quoted string, starting with %s ending with %s" % (self.quoteChar, self.endQuoteChar)
+
+        return self.strRepr
+
+
+class CharsNotIn(Token):
+    """
+    Token for matching words composed of characters I{not} in a given set (will
+    include whitespace in matched characters if not listed in the provided exclusion set - see example).
+    Defined with string containing all disallowed characters, and an optional
+    minimum, maximum, and/or exact length.  The default value for C{min} is 1 (a
+    minimum value < 1 is not valid); the default values for C{max} and C{exact}
+    are 0, meaning no maximum or exact length restriction.
+
+    Example::
+        # define a comma-separated-value as anything that is not a ','
+        csv_value = CharsNotIn(',')
+        print(delimitedList(csv_value).parseString("dkls,lsdkjf,s12 34,@!#,213"))
+    prints::
+        ['dkls', 'lsdkjf', 's12 34', '@!#', '213']
+    """
+    def __init__( self, notChars, min=1, max=0, exact=0 ):
+        super(CharsNotIn,self).__init__()
+        self.skipWhitespace = False
+        self.notChars = notChars
+
+        if min < 1:
+            raise ValueError("cannot specify a minimum length < 1; use Optional(CharsNotIn()) if zero-length char group is permitted")
+
+        self.minLen = min
+
+        if max > 0:
+            self.maxLen = max
+        else:
+            self.maxLen = _MAX_INT
+
+        if exact > 0:
+            self.maxLen = exact
+            self.minLen = exact
+
+        self.name = _ustr(self)
+        self.errmsg = "Expected " + self.name
+        self.mayReturnEmpty = ( self.minLen == 0 )
+        self.mayIndexError = False
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if instring[loc] in self.notChars:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        start = loc
+        loc += 1
+        notchars = self.notChars
+        maxlen = min( start+self.maxLen, len(instring) )
+        while loc < maxlen and \
+              (instring[loc] not in notchars):
+            loc += 1
+
+        if loc - start < self.minLen:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        return loc, instring[start:loc]
+
+    def __str__( self ):
+        try:
+            return super(CharsNotIn, self).__str__()
+        except Exception:
+            pass
+
+        if self.strRepr is None:
+            if len(self.notChars) > 4:
+                self.strRepr = "!W:(%s...)" % self.notChars[:4]
+            else:
+                self.strRepr = "!W:(%s)" % self.notChars
+
+        return self.strRepr
+
+class White(Token):
+    """
+    Special matching class for matching whitespace.  Normally, whitespace is ignored
+    by pyparsing grammars.  This class is included when some whitespace structures
+    are significant.  Define with a string containing the whitespace characters to be
+    matched; default is C{" \\t\\r\\n"}.  Also takes optional C{min}, C{max}, and C{exact} arguments,
+    as defined for the C{L{Word}} class.
+    """
+    whiteStrs = {
+        " " : "",
+        "\t": "",
+        "\n": "",
+        "\r": "",
+        "\f": "",
+        }
+    def __init__(self, ws=" \t\r\n", min=1, max=0, exact=0):
+        super(White,self).__init__()
+        self.matchWhite = ws
+        self.setWhitespaceChars( "".join(c for c in self.whiteChars if c not in self.matchWhite) )
+        #~ self.leaveWhitespace()
+        self.name = ("".join(White.whiteStrs[c] for c in self.matchWhite))
+        self.mayReturnEmpty = True
+        self.errmsg = "Expected " + self.name
+
+        self.minLen = min
+
+        if max > 0:
+            self.maxLen = max
+        else:
+            self.maxLen = _MAX_INT
+
+        if exact > 0:
+            self.maxLen = exact
+            self.minLen = exact
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if not(instring[ loc ] in self.matchWhite):
+            raise ParseException(instring, loc, self.errmsg, self)
+        start = loc
+        loc += 1
+        maxloc = start + self.maxLen
+        maxloc = min( maxloc, len(instring) )
+        while loc < maxloc and instring[loc] in self.matchWhite:
+            loc += 1
+
+        if loc - start < self.minLen:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        return loc, instring[start:loc]
+
+
+class _PositionToken(Token):
+    def __init__( self ):
+        super(_PositionToken,self).__init__()
+        self.name=self.__class__.__name__
+        self.mayReturnEmpty = True
+        self.mayIndexError = False
+
+class GoToColumn(_PositionToken):
+    """
+    Token to advance to a specific column of input text; useful for tabular report scraping.
+    """
+    def __init__( self, colno ):
+        super(GoToColumn,self).__init__()
+        self.col = colno
+
+    def preParse( self, instring, loc ):
+        if col(loc,instring) != self.col:
+            instrlen = len(instring)
+            if self.ignoreExprs:
+                loc = self._skipIgnorables( instring, loc )
+            while loc < instrlen and instring[loc].isspace() and col( loc, instring ) != self.col :
+                loc += 1
+        return loc
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        thiscol = col( loc, instring )
+        if thiscol > self.col:
+            raise ParseException( instring, loc, "Text not in expected column", self )
+        newloc = loc + self.col - thiscol
+        ret = instring[ loc: newloc ]
+        return newloc, ret
+
+
+class LineStart(_PositionToken):
+    """
+    Matches if current position is at the beginning of a line within the parse string
+    
+    Example::
+    
+        test = '''\
+        AAA this line
+        AAA and this line
+          AAA but not this one
+        B AAA and definitely not this one
+        '''
+
+        for t in (LineStart() + 'AAA' + restOfLine).searchString(test):
+            print(t)
+    
+    Prints::
+        ['AAA', ' this line']
+        ['AAA', ' and this line']    
+
+    """
+    def __init__( self ):
+        super(LineStart,self).__init__()
+        self.errmsg = "Expected start of line"
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if col(loc, instring) == 1:
+            return loc, []
+        raise ParseException(instring, loc, self.errmsg, self)
+
+class LineEnd(_PositionToken):
+    """
+    Matches if current position is at the end of a line within the parse string
+    """
+    def __init__( self ):
+        super(LineEnd,self).__init__()
+        self.setWhitespaceChars( ParserElement.DEFAULT_WHITE_CHARS.replace("\n","") )
+        self.errmsg = "Expected end of line"
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if loc len(instring):
+            return loc, []
+        else:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+class WordStart(_PositionToken):
+    """
+    Matches if the current position is at the beginning of a Word, and
+    is not preceded by any character in a given set of C{wordChars}
+    (default=C{printables}). To emulate the C{\b} behavior of regular expressions,
+    use C{WordStart(alphanums)}. C{WordStart} will also match at the beginning of
+    the string being parsed, or at the beginning of a line.
+    """
+    def __init__(self, wordChars = printables):
+        super(WordStart,self).__init__()
+        self.wordChars = set(wordChars)
+        self.errmsg = "Not at the start of a word"
+
+    def parseImpl(self, instring, loc, doActions=True ):
+        if loc != 0:
+            if (instring[loc-1] in self.wordChars or
+                instring[loc] not in self.wordChars):
+                raise ParseException(instring, loc, self.errmsg, self)
+        return loc, []
+
+class WordEnd(_PositionToken):
+    """
+    Matches if the current position is at the end of a Word, and
+    is not followed by any character in a given set of C{wordChars}
+    (default=C{printables}). To emulate the C{\b} behavior of regular expressions,
+    use C{WordEnd(alphanums)}. C{WordEnd} will also match at the end of
+    the string being parsed, or at the end of a line.
+    """
+    def __init__(self, wordChars = printables):
+        super(WordEnd,self).__init__()
+        self.wordChars = set(wordChars)
+        self.skipWhitespace = False
+        self.errmsg = "Not at the end of a word"
+
+    def parseImpl(self, instring, loc, doActions=True ):
+        instrlen = len(instring)
+        if instrlen>0 and loc maxExcLoc:
+                    maxException = err
+                    maxExcLoc = err.loc
+            except IndexError:
+                if len(instring) > maxExcLoc:
+                    maxException = ParseException(instring,len(instring),e.errmsg,self)
+                    maxExcLoc = len(instring)
+            else:
+                # save match among all matches, to retry longest to shortest
+                matches.append((loc2, e))
+
+        if matches:
+            matches.sort(key=lambda x: -x[0])
+            for _,e in matches:
+                try:
+                    return e._parse( instring, loc, doActions )
+                except ParseException as err:
+                    err.__traceback__ = None
+                    if err.loc > maxExcLoc:
+                        maxException = err
+                        maxExcLoc = err.loc
+
+        if maxException is not None:
+            maxException.msg = self.errmsg
+            raise maxException
+        else:
+            raise ParseException(instring, loc, "no defined alternatives to match", self)
+
+
+    def __ixor__(self, other ):
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        return self.append( other ) #Or( [ self, other ] )
+
+    def __str__( self ):
+        if hasattr(self,"name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "{" + " ^ ".join(_ustr(e) for e in self.exprs) + "}"
+
+        return self.strRepr
+
+    def checkRecursion( self, parseElementList ):
+        subRecCheckList = parseElementList[:] + [ self ]
+        for e in self.exprs:
+            e.checkRecursion( subRecCheckList )
+
+
+class MatchFirst(ParseExpression):
+    """
+    Requires that at least one C{ParseExpression} is found.
+    If two expressions match, the first one listed is the one that will match.
+    May be constructed using the C{'|'} operator.
+
+    Example::
+        # construct MatchFirst using '|' operator
+        
+        # watch the order of expressions to match
+        number = Word(nums) | Combine(Word(nums) + '.' + Word(nums))
+        print(number.searchString("123 3.1416 789")) #  Fail! -> [['123'], ['3'], ['1416'], ['789']]
+
+        # put more selective expression first
+        number = Combine(Word(nums) + '.' + Word(nums)) | Word(nums)
+        print(number.searchString("123 3.1416 789")) #  Better -> [['123'], ['3.1416'], ['789']]
+    """
+    def __init__( self, exprs, savelist = False ):
+        super(MatchFirst,self).__init__(exprs, savelist)
+        if self.exprs:
+            self.mayReturnEmpty = any(e.mayReturnEmpty for e in self.exprs)
+        else:
+            self.mayReturnEmpty = True
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        maxExcLoc = -1
+        maxException = None
+        for e in self.exprs:
+            try:
+                ret = e._parse( instring, loc, doActions )
+                return ret
+            except ParseException as err:
+                if err.loc > maxExcLoc:
+                    maxException = err
+                    maxExcLoc = err.loc
+            except IndexError:
+                if len(instring) > maxExcLoc:
+                    maxException = ParseException(instring,len(instring),e.errmsg,self)
+                    maxExcLoc = len(instring)
+
+        # only got here if no expression matched, raise exception for match that made it the furthest
+        else:
+            if maxException is not None:
+                maxException.msg = self.errmsg
+                raise maxException
+            else:
+                raise ParseException(instring, loc, "no defined alternatives to match", self)
+
+    def __ior__(self, other ):
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        return self.append( other ) #MatchFirst( [ self, other ] )
+
+    def __str__( self ):
+        if hasattr(self,"name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "{" + " | ".join(_ustr(e) for e in self.exprs) + "}"
+
+        return self.strRepr
+
+    def checkRecursion( self, parseElementList ):
+        subRecCheckList = parseElementList[:] + [ self ]
+        for e in self.exprs:
+            e.checkRecursion( subRecCheckList )
+
+
+class Each(ParseExpression):
+    """
+    Requires all given C{ParseExpression}s to be found, but in any order.
+    Expressions may be separated by whitespace.
+    May be constructed using the C{'&'} operator.
+
+    Example::
+        color = oneOf("RED ORANGE YELLOW GREEN BLUE PURPLE BLACK WHITE BROWN")
+        shape_type = oneOf("SQUARE CIRCLE TRIANGLE STAR HEXAGON OCTAGON")
+        integer = Word(nums)
+        shape_attr = "shape:" + shape_type("shape")
+        posn_attr = "posn:" + Group(integer("x") + ',' + integer("y"))("posn")
+        color_attr = "color:" + color("color")
+        size_attr = "size:" + integer("size")
+
+        # use Each (using operator '&') to accept attributes in any order 
+        # (shape and posn are required, color and size are optional)
+        shape_spec = shape_attr & posn_attr & Optional(color_attr) & Optional(size_attr)
+
+        shape_spec.runTests('''
+            shape: SQUARE color: BLACK posn: 100, 120
+            shape: CIRCLE size: 50 color: BLUE posn: 50,80
+            color:GREEN size:20 shape:TRIANGLE posn:20,40
+            '''
+            )
+    prints::
+        shape: SQUARE color: BLACK posn: 100, 120
+        ['shape:', 'SQUARE', 'color:', 'BLACK', 'posn:', ['100', ',', '120']]
+        - color: BLACK
+        - posn: ['100', ',', '120']
+          - x: 100
+          - y: 120
+        - shape: SQUARE
+
+
+        shape: CIRCLE size: 50 color: BLUE posn: 50,80
+        ['shape:', 'CIRCLE', 'size:', '50', 'color:', 'BLUE', 'posn:', ['50', ',', '80']]
+        - color: BLUE
+        - posn: ['50', ',', '80']
+          - x: 50
+          - y: 80
+        - shape: CIRCLE
+        - size: 50
+
+
+        color: GREEN size: 20 shape: TRIANGLE posn: 20,40
+        ['color:', 'GREEN', 'size:', '20', 'shape:', 'TRIANGLE', 'posn:', ['20', ',', '40']]
+        - color: GREEN
+        - posn: ['20', ',', '40']
+          - x: 20
+          - y: 40
+        - shape: TRIANGLE
+        - size: 20
+    """
+    def __init__( self, exprs, savelist = True ):
+        super(Each,self).__init__(exprs, savelist)
+        self.mayReturnEmpty = all(e.mayReturnEmpty for e in self.exprs)
+        self.skipWhitespace = True
+        self.initExprGroups = True
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if self.initExprGroups:
+            self.opt1map = dict((id(e.expr),e) for e in self.exprs if isinstance(e,Optional))
+            opt1 = [ e.expr for e in self.exprs if isinstance(e,Optional) ]
+            opt2 = [ e for e in self.exprs if e.mayReturnEmpty and not isinstance(e,Optional)]
+            self.optionals = opt1 + opt2
+            self.multioptionals = [ e.expr for e in self.exprs if isinstance(e,ZeroOrMore) ]
+            self.multirequired = [ e.expr for e in self.exprs if isinstance(e,OneOrMore) ]
+            self.required = [ e for e in self.exprs if not isinstance(e,(Optional,ZeroOrMore,OneOrMore)) ]
+            self.required += self.multirequired
+            self.initExprGroups = False
+        tmpLoc = loc
+        tmpReqd = self.required[:]
+        tmpOpt  = self.optionals[:]
+        matchOrder = []
+
+        keepMatching = True
+        while keepMatching:
+            tmpExprs = tmpReqd + tmpOpt + self.multioptionals + self.multirequired
+            failed = []
+            for e in tmpExprs:
+                try:
+                    tmpLoc = e.tryParse( instring, tmpLoc )
+                except ParseException:
+                    failed.append(e)
+                else:
+                    matchOrder.append(self.opt1map.get(id(e),e))
+                    if e in tmpReqd:
+                        tmpReqd.remove(e)
+                    elif e in tmpOpt:
+                        tmpOpt.remove(e)
+            if len(failed) == len(tmpExprs):
+                keepMatching = False
+
+        if tmpReqd:
+            missing = ", ".join(_ustr(e) for e in tmpReqd)
+            raise ParseException(instring,loc,"Missing one or more required elements (%s)" % missing )
+
+        # add any unmatched Optionals, in case they have default values defined
+        matchOrder += [e for e in self.exprs if isinstance(e,Optional) and e.expr in tmpOpt]
+
+        resultlist = []
+        for e in matchOrder:
+            loc,results = e._parse(instring,loc,doActions)
+            resultlist.append(results)
+
+        finalResults = sum(resultlist, ParseResults([]))
+        return loc, finalResults
+
+    def __str__( self ):
+        if hasattr(self,"name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "{" + " & ".join(_ustr(e) for e in self.exprs) + "}"
+
+        return self.strRepr
+
+    def checkRecursion( self, parseElementList ):
+        subRecCheckList = parseElementList[:] + [ self ]
+        for e in self.exprs:
+            e.checkRecursion( subRecCheckList )
+
+
+class ParseElementEnhance(ParserElement):
+    """
+    Abstract subclass of C{ParserElement}, for combining and post-processing parsed tokens.
+    """
+    def __init__( self, expr, savelist=False ):
+        super(ParseElementEnhance,self).__init__(savelist)
+        if isinstance( expr, basestring ):
+            if issubclass(ParserElement._literalStringClass, Token):
+                expr = ParserElement._literalStringClass(expr)
+            else:
+                expr = ParserElement._literalStringClass(Literal(expr))
+        self.expr = expr
+        self.strRepr = None
+        if expr is not None:
+            self.mayIndexError = expr.mayIndexError
+            self.mayReturnEmpty = expr.mayReturnEmpty
+            self.setWhitespaceChars( expr.whiteChars )
+            self.skipWhitespace = expr.skipWhitespace
+            self.saveAsList = expr.saveAsList
+            self.callPreparse = expr.callPreparse
+            self.ignoreExprs.extend(expr.ignoreExprs)
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if self.expr is not None:
+            return self.expr._parse( instring, loc, doActions, callPreParse=False )
+        else:
+            raise ParseException("",loc,self.errmsg,self)
+
+    def leaveWhitespace( self ):
+        self.skipWhitespace = False
+        self.expr = self.expr.copy()
+        if self.expr is not None:
+            self.expr.leaveWhitespace()
+        return self
+
+    def ignore( self, other ):
+        if isinstance( other, Suppress ):
+            if other not in self.ignoreExprs:
+                super( ParseElementEnhance, self).ignore( other )
+                if self.expr is not None:
+                    self.expr.ignore( self.ignoreExprs[-1] )
+        else:
+            super( ParseElementEnhance, self).ignore( other )
+            if self.expr is not None:
+                self.expr.ignore( self.ignoreExprs[-1] )
+        return self
+
+    def streamline( self ):
+        super(ParseElementEnhance,self).streamline()
+        if self.expr is not None:
+            self.expr.streamline()
+        return self
+
+    def checkRecursion( self, parseElementList ):
+        if self in parseElementList:
+            raise RecursiveGrammarException( parseElementList+[self] )
+        subRecCheckList = parseElementList[:] + [ self ]
+        if self.expr is not None:
+            self.expr.checkRecursion( subRecCheckList )
+
+    def validate( self, validateTrace=[] ):
+        tmp = validateTrace[:]+[self]
+        if self.expr is not None:
+            self.expr.validate(tmp)
+        self.checkRecursion( [] )
+
+    def __str__( self ):
+        try:
+            return super(ParseElementEnhance,self).__str__()
+        except Exception:
+            pass
+
+        if self.strRepr is None and self.expr is not None:
+            self.strRepr = "%s:(%s)" % ( self.__class__.__name__, _ustr(self.expr) )
+        return self.strRepr
+
+
+class FollowedBy(ParseElementEnhance):
+    """
+    Lookahead matching of the given parse expression.  C{FollowedBy}
+    does I{not} advance the parsing position within the input string, it only
+    verifies that the specified parse expression matches at the current
+    position.  C{FollowedBy} always returns a null token list.
+
+    Example::
+        # use FollowedBy to match a label only if it is followed by a ':'
+        data_word = Word(alphas)
+        label = data_word + FollowedBy(':')
+        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
+        
+        OneOrMore(attr_expr).parseString("shape: SQUARE color: BLACK posn: upper left").pprint()
+    prints::
+        [['shape', 'SQUARE'], ['color', 'BLACK'], ['posn', 'upper left']]
+    """
+    def __init__( self, expr ):
+        super(FollowedBy,self).__init__(expr)
+        self.mayReturnEmpty = True
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        self.expr.tryParse( instring, loc )
+        return loc, []
+
+
+class NotAny(ParseElementEnhance):
+    """
+    Lookahead to disallow matching with the given parse expression.  C{NotAny}
+    does I{not} advance the parsing position within the input string, it only
+    verifies that the specified parse expression does I{not} match at the current
+    position.  Also, C{NotAny} does I{not} skip over leading whitespace. C{NotAny}
+    always returns a null token list.  May be constructed using the '~' operator.
+
+    Example::
+        
+    """
+    def __init__( self, expr ):
+        super(NotAny,self).__init__(expr)
+        #~ self.leaveWhitespace()
+        self.skipWhitespace = False  # do NOT use self.leaveWhitespace(), don't want to propagate to exprs
+        self.mayReturnEmpty = True
+        self.errmsg = "Found unwanted token, "+_ustr(self.expr)
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if self.expr.canParseNext(instring, loc):
+            raise ParseException(instring, loc, self.errmsg, self)
+        return loc, []
+
+    def __str__( self ):
+        if hasattr(self,"name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "~{" + _ustr(self.expr) + "}"
+
+        return self.strRepr
+
+class _MultipleMatch(ParseElementEnhance):
+    def __init__( self, expr, stopOn=None):
+        super(_MultipleMatch, self).__init__(expr)
+        self.saveAsList = True
+        ender = stopOn
+        if isinstance(ender, basestring):
+            ender = ParserElement._literalStringClass(ender)
+        self.not_ender = ~ender if ender is not None else None
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        self_expr_parse = self.expr._parse
+        self_skip_ignorables = self._skipIgnorables
+        check_ender = self.not_ender is not None
+        if check_ender:
+            try_not_ender = self.not_ender.tryParse
+        
+        # must be at least one (but first see if we are the stopOn sentinel;
+        # if so, fail)
+        if check_ender:
+            try_not_ender(instring, loc)
+        loc, tokens = self_expr_parse( instring, loc, doActions, callPreParse=False )
+        try:
+            hasIgnoreExprs = (not not self.ignoreExprs)
+            while 1:
+                if check_ender:
+                    try_not_ender(instring, loc)
+                if hasIgnoreExprs:
+                    preloc = self_skip_ignorables( instring, loc )
+                else:
+                    preloc = loc
+                loc, tmptokens = self_expr_parse( instring, preloc, doActions )
+                if tmptokens or tmptokens.haskeys():
+                    tokens += tmptokens
+        except (ParseException,IndexError):
+            pass
+
+        return loc, tokens
+        
+class OneOrMore(_MultipleMatch):
+    """
+    Repetition of one or more of the given expression.
+    
+    Parameters:
+     - expr - expression that must match one or more times
+     - stopOn - (default=C{None}) - expression for a terminating sentinel
+          (only required if the sentinel would ordinarily match the repetition 
+          expression)          
+
+    Example::
+        data_word = Word(alphas)
+        label = data_word + FollowedBy(':')
+        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word).setParseAction(' '.join))
+
+        text = "shape: SQUARE posn: upper left color: BLACK"
+        OneOrMore(attr_expr).parseString(text).pprint()  # Fail! read 'color' as data instead of next label -> [['shape', 'SQUARE color']]
+
+        # use stopOn attribute for OneOrMore to avoid reading label string as part of the data
+        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
+        OneOrMore(attr_expr).parseString(text).pprint() # Better -> [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'BLACK']]
+        
+        # could also be written as
+        (attr_expr * (1,)).parseString(text).pprint()
+    """
+
+    def __str__( self ):
+        if hasattr(self,"name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "{" + _ustr(self.expr) + "}..."
+
+        return self.strRepr
+
+class ZeroOrMore(_MultipleMatch):
+    """
+    Optional repetition of zero or more of the given expression.
+    
+    Parameters:
+     - expr - expression that must match zero or more times
+     - stopOn - (default=C{None}) - expression for a terminating sentinel
+          (only required if the sentinel would ordinarily match the repetition 
+          expression)          
+
+    Example: similar to L{OneOrMore}
+    """
+    def __init__( self, expr, stopOn=None):
+        super(ZeroOrMore,self).__init__(expr, stopOn=stopOn)
+        self.mayReturnEmpty = True
+        
+    def parseImpl( self, instring, loc, doActions=True ):
+        try:
+            return super(ZeroOrMore, self).parseImpl(instring, loc, doActions)
+        except (ParseException,IndexError):
+            return loc, []
+
+    def __str__( self ):
+        if hasattr(self,"name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "[" + _ustr(self.expr) + "]..."
+
+        return self.strRepr
+
+class _NullToken(object):
+    def __bool__(self):
+        return False
+    __nonzero__ = __bool__
+    def __str__(self):
+        return ""
+
+_optionalNotMatched = _NullToken()
+class Optional(ParseElementEnhance):
+    """
+    Optional matching of the given expression.
+
+    Parameters:
+     - expr - expression that must match zero or more times
+     - default (optional) - value to be returned if the optional expression is not found.
+
+    Example::
+        # US postal code can be a 5-digit zip, plus optional 4-digit qualifier
+        zip = Combine(Word(nums, exact=5) + Optional('-' + Word(nums, exact=4)))
+        zip.runTests('''
+            # traditional ZIP code
+            12345
+            
+            # ZIP+4 form
+            12101-0001
+            
+            # invalid ZIP
+            98765-
+            ''')
+    prints::
+        # traditional ZIP code
+        12345
+        ['12345']
+
+        # ZIP+4 form
+        12101-0001
+        ['12101-0001']
+
+        # invalid ZIP
+        98765-
+             ^
+        FAIL: Expected end of text (at char 5), (line:1, col:6)
+    """
+    def __init__( self, expr, default=_optionalNotMatched ):
+        super(Optional,self).__init__( expr, savelist=False )
+        self.saveAsList = self.expr.saveAsList
+        self.defaultValue = default
+        self.mayReturnEmpty = True
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        try:
+            loc, tokens = self.expr._parse( instring, loc, doActions, callPreParse=False )
+        except (ParseException,IndexError):
+            if self.defaultValue is not _optionalNotMatched:
+                if self.expr.resultsName:
+                    tokens = ParseResults([ self.defaultValue ])
+                    tokens[self.expr.resultsName] = self.defaultValue
+                else:
+                    tokens = [ self.defaultValue ]
+            else:
+                tokens = []
+        return loc, tokens
+
+    def __str__( self ):
+        if hasattr(self,"name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "[" + _ustr(self.expr) + "]"
+
+        return self.strRepr
+
+class SkipTo(ParseElementEnhance):
+    """
+    Token for skipping over all undefined text until the matched expression is found.
+
+    Parameters:
+     - expr - target expression marking the end of the data to be skipped
+     - include - (default=C{False}) if True, the target expression is also parsed 
+          (the skipped text and target expression are returned as a 2-element list).
+     - ignore - (default=C{None}) used to define grammars (typically quoted strings and 
+          comments) that might contain false matches to the target expression
+     - failOn - (default=C{None}) define expressions that are not allowed to be 
+          included in the skipped test; if found before the target expression is found, 
+          the SkipTo is not a match
+
+    Example::
+        report = '''
+            Outstanding Issues Report - 1 Jan 2000
+
+               # | Severity | Description                               |  Days Open
+            -----+----------+-------------------------------------------+-----------
+             101 | Critical | Intermittent system crash                 |          6
+              94 | Cosmetic | Spelling error on Login ('log|n')         |         14
+              79 | Minor    | System slow when running too many reports |         47
+            '''
+        integer = Word(nums)
+        SEP = Suppress('|')
+        # use SkipTo to simply match everything up until the next SEP
+        # - ignore quoted strings, so that a '|' character inside a quoted string does not match
+        # - parse action will call token.strip() for each matched token, i.e., the description body
+        string_data = SkipTo(SEP, ignore=quotedString)
+        string_data.setParseAction(tokenMap(str.strip))
+        ticket_expr = (integer("issue_num") + SEP 
+                      + string_data("sev") + SEP 
+                      + string_data("desc") + SEP 
+                      + integer("days_open"))
+        
+        for tkt in ticket_expr.searchString(report):
+            print tkt.dump()
+    prints::
+        ['101', 'Critical', 'Intermittent system crash', '6']
+        - days_open: 6
+        - desc: Intermittent system crash
+        - issue_num: 101
+        - sev: Critical
+        ['94', 'Cosmetic', "Spelling error on Login ('log|n')", '14']
+        - days_open: 14
+        - desc: Spelling error on Login ('log|n')
+        - issue_num: 94
+        - sev: Cosmetic
+        ['79', 'Minor', 'System slow when running too many reports', '47']
+        - days_open: 47
+        - desc: System slow when running too many reports
+        - issue_num: 79
+        - sev: Minor
+    """
+    def __init__( self, other, include=False, ignore=None, failOn=None ):
+        super( SkipTo, self ).__init__( other )
+        self.ignoreExpr = ignore
+        self.mayReturnEmpty = True
+        self.mayIndexError = False
+        self.includeMatch = include
+        self.asList = False
+        if isinstance(failOn, basestring):
+            self.failOn = ParserElement._literalStringClass(failOn)
+        else:
+            self.failOn = failOn
+        self.errmsg = "No match found for "+_ustr(self.expr)
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        startloc = loc
+        instrlen = len(instring)
+        expr = self.expr
+        expr_parse = self.expr._parse
+        self_failOn_canParseNext = self.failOn.canParseNext if self.failOn is not None else None
+        self_ignoreExpr_tryParse = self.ignoreExpr.tryParse if self.ignoreExpr is not None else None
+        
+        tmploc = loc
+        while tmploc <= instrlen:
+            if self_failOn_canParseNext is not None:
+                # break if failOn expression matches
+                if self_failOn_canParseNext(instring, tmploc):
+                    break
+                    
+            if self_ignoreExpr_tryParse is not None:
+                # advance past ignore expressions
+                while 1:
+                    try:
+                        tmploc = self_ignoreExpr_tryParse(instring, tmploc)
+                    except ParseBaseException:
+                        break
+            
+            try:
+                expr_parse(instring, tmploc, doActions=False, callPreParse=False)
+            except (ParseException, IndexError):
+                # no match, advance loc in string
+                tmploc += 1
+            else:
+                # matched skipto expr, done
+                break
+
+        else:
+            # ran off the end of the input string without matching skipto expr, fail
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        # build up return values
+        loc = tmploc
+        skiptext = instring[startloc:loc]
+        skipresult = ParseResults(skiptext)
+        
+        if self.includeMatch:
+            loc, mat = expr_parse(instring,loc,doActions,callPreParse=False)
+            skipresult += mat
+
+        return loc, skipresult
+
+class Forward(ParseElementEnhance):
+    """
+    Forward declaration of an expression to be defined later -
+    used for recursive grammars, such as algebraic infix notation.
+    When the expression is known, it is assigned to the C{Forward} variable using the '<<' operator.
+
+    Note: take care when assigning to C{Forward} not to overlook precedence of operators.
+    Specifically, '|' has a lower precedence than '<<', so that::
+        fwdExpr << a | b | c
+    will actually be evaluated as::
+        (fwdExpr << a) | b | c
+    thereby leaving b and c out as parseable alternatives.  It is recommended that you
+    explicitly group the values inserted into the C{Forward}::
+        fwdExpr << (a | b | c)
+    Converting to use the '<<=' operator instead will avoid this problem.
+
+    See L{ParseResults.pprint} for an example of a recursive parser created using
+    C{Forward}.
+    """
+    def __init__( self, other=None ):
+        super(Forward,self).__init__( other, savelist=False )
+
+    def __lshift__( self, other ):
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass(other)
+        self.expr = other
+        self.strRepr = None
+        self.mayIndexError = self.expr.mayIndexError
+        self.mayReturnEmpty = self.expr.mayReturnEmpty
+        self.setWhitespaceChars( self.expr.whiteChars )
+        self.skipWhitespace = self.expr.skipWhitespace
+        self.saveAsList = self.expr.saveAsList
+        self.ignoreExprs.extend(self.expr.ignoreExprs)
+        return self
+        
+    def __ilshift__(self, other):
+        return self << other
+    
+    def leaveWhitespace( self ):
+        self.skipWhitespace = False
+        return self
+
+    def streamline( self ):
+        if not self.streamlined:
+            self.streamlined = True
+            if self.expr is not None:
+                self.expr.streamline()
+        return self
+
+    def validate( self, validateTrace=[] ):
+        if self not in validateTrace:
+            tmp = validateTrace[:]+[self]
+            if self.expr is not None:
+                self.expr.validate(tmp)
+        self.checkRecursion([])
+
+    def __str__( self ):
+        if hasattr(self,"name"):
+            return self.name
+        return self.__class__.__name__ + ": ..."
+
+        # stubbed out for now - creates awful memory and perf issues
+        self._revertClass = self.__class__
+        self.__class__ = _ForwardNoRecurse
+        try:
+            if self.expr is not None:
+                retString = _ustr(self.expr)
+            else:
+                retString = "None"
+        finally:
+            self.__class__ = self._revertClass
+        return self.__class__.__name__ + ": " + retString
+
+    def copy(self):
+        if self.expr is not None:
+            return super(Forward,self).copy()
+        else:
+            ret = Forward()
+            ret <<= self
+            return ret
+
+class _ForwardNoRecurse(Forward):
+    def __str__( self ):
+        return "..."
+
+class TokenConverter(ParseElementEnhance):
+    """
+    Abstract subclass of C{ParseExpression}, for converting parsed results.
+    """
+    def __init__( self, expr, savelist=False ):
+        super(TokenConverter,self).__init__( expr )#, savelist )
+        self.saveAsList = False
+
+class Combine(TokenConverter):
+    """
+    Converter to concatenate all matching tokens to a single string.
+    By default, the matching patterns must also be contiguous in the input string;
+    this can be disabled by specifying C{'adjacent=False'} in the constructor.
+
+    Example::
+        real = Word(nums) + '.' + Word(nums)
+        print(real.parseString('3.1416')) # -> ['3', '.', '1416']
+        # will also erroneously match the following
+        print(real.parseString('3. 1416')) # -> ['3', '.', '1416']
+
+        real = Combine(Word(nums) + '.' + Word(nums))
+        print(real.parseString('3.1416')) # -> ['3.1416']
+        # no match when there are internal spaces
+        print(real.parseString('3. 1416')) # -> Exception: Expected W:(0123...)
+    """
+    def __init__( self, expr, joinString="", adjacent=True ):
+        super(Combine,self).__init__( expr )
+        # suppress whitespace-stripping in contained parse expressions, but re-enable it on the Combine itself
+        if adjacent:
+            self.leaveWhitespace()
+        self.adjacent = adjacent
+        self.skipWhitespace = True
+        self.joinString = joinString
+        self.callPreparse = True
+
+    def ignore( self, other ):
+        if self.adjacent:
+            ParserElement.ignore(self, other)
+        else:
+            super( Combine, self).ignore( other )
+        return self
+
+    def postParse( self, instring, loc, tokenlist ):
+        retToks = tokenlist.copy()
+        del retToks[:]
+        retToks += ParseResults([ "".join(tokenlist._asStringList(self.joinString)) ], modal=self.modalResults)
+
+        if self.resultsName and retToks.haskeys():
+            return [ retToks ]
+        else:
+            return retToks
+
+class Group(TokenConverter):
+    """
+    Converter to return the matched tokens as a list - useful for returning tokens of C{L{ZeroOrMore}} and C{L{OneOrMore}} expressions.
+
+    Example::
+        ident = Word(alphas)
+        num = Word(nums)
+        term = ident | num
+        func = ident + Optional(delimitedList(term))
+        print(func.parseString("fn a,b,100"))  # -> ['fn', 'a', 'b', '100']
+
+        func = ident + Group(Optional(delimitedList(term)))
+        print(func.parseString("fn a,b,100"))  # -> ['fn', ['a', 'b', '100']]
+    """
+    def __init__( self, expr ):
+        super(Group,self).__init__( expr )
+        self.saveAsList = True
+
+    def postParse( self, instring, loc, tokenlist ):
+        return [ tokenlist ]
+
+class Dict(TokenConverter):
+    """
+    Converter to return a repetitive expression as a list, but also as a dictionary.
+    Each element can also be referenced using the first token in the expression as its key.
+    Useful for tabular report scraping when the first column can be used as a item key.
+
+    Example::
+        data_word = Word(alphas)
+        label = data_word + FollowedBy(':')
+        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word).setParseAction(' '.join))
+
+        text = "shape: SQUARE posn: upper left color: light blue texture: burlap"
+        attr_expr = (label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
+        
+        # print attributes as plain groups
+        print(OneOrMore(attr_expr).parseString(text).dump())
+        
+        # instead of OneOrMore(expr), parse using Dict(OneOrMore(Group(expr))) - Dict will auto-assign names
+        result = Dict(OneOrMore(Group(attr_expr))).parseString(text)
+        print(result.dump())
+        
+        # access named fields as dict entries, or output as dict
+        print(result['shape'])        
+        print(result.asDict())
+    prints::
+        ['shape', 'SQUARE', 'posn', 'upper left', 'color', 'light blue', 'texture', 'burlap']
+
+        [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'light blue'], ['texture', 'burlap']]
+        - color: light blue
+        - posn: upper left
+        - shape: SQUARE
+        - texture: burlap
+        SQUARE
+        {'color': 'light blue', 'posn': 'upper left', 'texture': 'burlap', 'shape': 'SQUARE'}
+    See more examples at L{ParseResults} of accessing fields by results name.
+    """
+    def __init__( self, expr ):
+        super(Dict,self).__init__( expr )
+        self.saveAsList = True
+
+    def postParse( self, instring, loc, tokenlist ):
+        for i,tok in enumerate(tokenlist):
+            if len(tok) == 0:
+                continue
+            ikey = tok[0]
+            if isinstance(ikey,int):
+                ikey = _ustr(tok[0]).strip()
+            if len(tok)==1:
+                tokenlist[ikey] = _ParseResultsWithOffset("",i)
+            elif len(tok)==2 and not isinstance(tok[1],ParseResults):
+                tokenlist[ikey] = _ParseResultsWithOffset(tok[1],i)
+            else:
+                dictvalue = tok.copy() #ParseResults(i)
+                del dictvalue[0]
+                if len(dictvalue)!= 1 or (isinstance(dictvalue,ParseResults) and dictvalue.haskeys()):
+                    tokenlist[ikey] = _ParseResultsWithOffset(dictvalue,i)
+                else:
+                    tokenlist[ikey] = _ParseResultsWithOffset(dictvalue[0],i)
+
+        if self.resultsName:
+            return [ tokenlist ]
+        else:
+            return tokenlist
+
+
+class Suppress(TokenConverter):
+    """
+    Converter for ignoring the results of a parsed expression.
+
+    Example::
+        source = "a, b, c,d"
+        wd = Word(alphas)
+        wd_list1 = wd + ZeroOrMore(',' + wd)
+        print(wd_list1.parseString(source))
+
+        # often, delimiters that are useful during parsing are just in the
+        # way afterward - use Suppress to keep them out of the parsed output
+        wd_list2 = wd + ZeroOrMore(Suppress(',') + wd)
+        print(wd_list2.parseString(source))
+    prints::
+        ['a', ',', 'b', ',', 'c', ',', 'd']
+        ['a', 'b', 'c', 'd']
+    (See also L{delimitedList}.)
+    """
+    def postParse( self, instring, loc, tokenlist ):
+        return []
+
+    def suppress( self ):
+        return self
+
+
+class OnlyOnce(object):
+    """
+    Wrapper for parse actions, to ensure they are only called once.
+    """
+    def __init__(self, methodCall):
+        self.callable = _trim_arity(methodCall)
+        self.called = False
+    def __call__(self,s,l,t):
+        if not self.called:
+            results = self.callable(s,l,t)
+            self.called = True
+            return results
+        raise ParseException(s,l,"")
+    def reset(self):
+        self.called = False
+
+def traceParseAction(f):
+    """
+    Decorator for debugging parse actions. 
+    
+    When the parse action is called, this decorator will print C{">> entering I{method-name}(line:I{current_source_line}, I{parse_location}, I{matched_tokens})".}
+    When the parse action completes, the decorator will print C{"<<"} followed by the returned value, or any exception that the parse action raised.
+
+    Example::
+        wd = Word(alphas)
+
+        @traceParseAction
+        def remove_duplicate_chars(tokens):
+            return ''.join(sorted(set(''.join(tokens))))
+
+        wds = OneOrMore(wd).setParseAction(remove_duplicate_chars)
+        print(wds.parseString("slkdjs sld sldd sdlf sdljf"))
+    prints::
+        >>entering remove_duplicate_chars(line: 'slkdjs sld sldd sdlf sdljf', 0, (['slkdjs', 'sld', 'sldd', 'sdlf', 'sdljf'], {}))
+        <3:
+            thisFunc = paArgs[0].__class__.__name__ + '.' + thisFunc
+        sys.stderr.write( ">>entering %s(line: '%s', %d, %r)\n" % (thisFunc,line(l,s),l,t) )
+        try:
+            ret = f(*paArgs)
+        except Exception as exc:
+            sys.stderr.write( "< ['aa', 'bb', 'cc']
+        delimitedList(Word(hexnums), delim=':', combine=True).parseString("AA:BB:CC:DD:EE") # -> ['AA:BB:CC:DD:EE']
+    """
+    dlName = _ustr(expr)+" ["+_ustr(delim)+" "+_ustr(expr)+"]..."
+    if combine:
+        return Combine( expr + ZeroOrMore( delim + expr ) ).setName(dlName)
+    else:
+        return ( expr + ZeroOrMore( Suppress( delim ) + expr ) ).setName(dlName)
+
+def countedArray( expr, intExpr=None ):
+    """
+    Helper to define a counted list of expressions.
+    This helper defines a pattern of the form::
+        integer expr expr expr...
+    where the leading integer tells how many expr expressions follow.
+    The matched tokens returns the array of expr tokens as a list - the leading count token is suppressed.
+    
+    If C{intExpr} is specified, it should be a pyparsing expression that produces an integer value.
+
+    Example::
+        countedArray(Word(alphas)).parseString('2 ab cd ef')  # -> ['ab', 'cd']
+
+        # in this parser, the leading integer value is given in binary,
+        # '10' indicating that 2 values are in the array
+        binaryConstant = Word('01').setParseAction(lambda t: int(t[0], 2))
+        countedArray(Word(alphas), intExpr=binaryConstant).parseString('10 ab cd ef')  # -> ['ab', 'cd']
+    """
+    arrayExpr = Forward()
+    def countFieldParseAction(s,l,t):
+        n = t[0]
+        arrayExpr << (n and Group(And([expr]*n)) or Group(empty))
+        return []
+    if intExpr is None:
+        intExpr = Word(nums).setParseAction(lambda t:int(t[0]))
+    else:
+        intExpr = intExpr.copy()
+    intExpr.setName("arrayLen")
+    intExpr.addParseAction(countFieldParseAction, callDuringTry=True)
+    return ( intExpr + arrayExpr ).setName('(len) ' + _ustr(expr) + '...')
+
+def _flatten(L):
+    ret = []
+    for i in L:
+        if isinstance(i,list):
+            ret.extend(_flatten(i))
+        else:
+            ret.append(i)
+    return ret
+
+def matchPreviousLiteral(expr):
+    """
+    Helper to define an expression that is indirectly defined from
+    the tokens matched in a previous expression, that is, it looks
+    for a 'repeat' of a previous expression.  For example::
+        first = Word(nums)
+        second = matchPreviousLiteral(first)
+        matchExpr = first + ":" + second
+    will match C{"1:1"}, but not C{"1:2"}.  Because this matches a
+    previous literal, will also match the leading C{"1:1"} in C{"1:10"}.
+    If this is not desired, use C{matchPreviousExpr}.
+    Do I{not} use with packrat parsing enabled.
+    """
+    rep = Forward()
+    def copyTokenToRepeater(s,l,t):
+        if t:
+            if len(t) == 1:
+                rep << t[0]
+            else:
+                # flatten t tokens
+                tflat = _flatten(t.asList())
+                rep << And(Literal(tt) for tt in tflat)
+        else:
+            rep << Empty()
+    expr.addParseAction(copyTokenToRepeater, callDuringTry=True)
+    rep.setName('(prev) ' + _ustr(expr))
+    return rep
+
+def matchPreviousExpr(expr):
+    """
+    Helper to define an expression that is indirectly defined from
+    the tokens matched in a previous expression, that is, it looks
+    for a 'repeat' of a previous expression.  For example::
+        first = Word(nums)
+        second = matchPreviousExpr(first)
+        matchExpr = first + ":" + second
+    will match C{"1:1"}, but not C{"1:2"}.  Because this matches by
+    expressions, will I{not} match the leading C{"1:1"} in C{"1:10"};
+    the expressions are evaluated first, and then compared, so
+    C{"1"} is compared with C{"10"}.
+    Do I{not} use with packrat parsing enabled.
+    """
+    rep = Forward()
+    e2 = expr.copy()
+    rep <<= e2
+    def copyTokenToRepeater(s,l,t):
+        matchTokens = _flatten(t.asList())
+        def mustMatchTheseTokens(s,l,t):
+            theseTokens = _flatten(t.asList())
+            if  theseTokens != matchTokens:
+                raise ParseException("",0,"")
+        rep.setParseAction( mustMatchTheseTokens, callDuringTry=True )
+    expr.addParseAction(copyTokenToRepeater, callDuringTry=True)
+    rep.setName('(prev) ' + _ustr(expr))
+    return rep
+
+def _escapeRegexRangeChars(s):
+    #~  escape these chars: ^-]
+    for c in r"\^-]":
+        s = s.replace(c,_bslash+c)
+    s = s.replace("\n",r"\n")
+    s = s.replace("\t",r"\t")
+    return _ustr(s)
+
+def oneOf( strs, caseless=False, useRegex=True ):
+    """
+    Helper to quickly define a set of alternative Literals, and makes sure to do
+    longest-first testing when there is a conflict, regardless of the input order,
+    but returns a C{L{MatchFirst}} for best performance.
+
+    Parameters:
+     - strs - a string of space-delimited literals, or a collection of string literals
+     - caseless - (default=C{False}) - treat all literals as caseless
+     - useRegex - (default=C{True}) - as an optimization, will generate a Regex
+          object; otherwise, will generate a C{MatchFirst} object (if C{caseless=True}, or
+          if creating a C{Regex} raises an exception)
+
+    Example::
+        comp_oper = oneOf("< = > <= >= !=")
+        var = Word(alphas)
+        number = Word(nums)
+        term = var | number
+        comparison_expr = term + comp_oper + term
+        print(comparison_expr.searchString("B = 12  AA=23 B<=AA AA>12"))
+    prints::
+        [['B', '=', '12'], ['AA', '=', '23'], ['B', '<=', 'AA'], ['AA', '>', '12']]
+    """
+    if caseless:
+        isequal = ( lambda a,b: a.upper() == b.upper() )
+        masks = ( lambda a,b: b.upper().startswith(a.upper()) )
+        parseElementClass = CaselessLiteral
+    else:
+        isequal = ( lambda a,b: a == b )
+        masks = ( lambda a,b: b.startswith(a) )
+        parseElementClass = Literal
+
+    symbols = []
+    if isinstance(strs,basestring):
+        symbols = strs.split()
+    elif isinstance(strs, Iterable):
+        symbols = list(strs)
+    else:
+        warnings.warn("Invalid argument to oneOf, expected string or iterable",
+                SyntaxWarning, stacklevel=2)
+    if not symbols:
+        return NoMatch()
+
+    i = 0
+    while i < len(symbols)-1:
+        cur = symbols[i]
+        for j,other in enumerate(symbols[i+1:]):
+            if ( isequal(other, cur) ):
+                del symbols[i+j+1]
+                break
+            elif ( masks(cur, other) ):
+                del symbols[i+j+1]
+                symbols.insert(i,other)
+                cur = other
+                break
+        else:
+            i += 1
+
+    if not caseless and useRegex:
+        #~ print (strs,"->", "|".join( [ _escapeRegexChars(sym) for sym in symbols] ))
+        try:
+            if len(symbols)==len("".join(symbols)):
+                return Regex( "[%s]" % "".join(_escapeRegexRangeChars(sym) for sym in symbols) ).setName(' | '.join(symbols))
+            else:
+                return Regex( "|".join(re.escape(sym) for sym in symbols) ).setName(' | '.join(symbols))
+        except Exception:
+            warnings.warn("Exception creating Regex for oneOf, building MatchFirst",
+                    SyntaxWarning, stacklevel=2)
+
+
+    # last resort, just use MatchFirst
+    return MatchFirst(parseElementClass(sym) for sym in symbols).setName(' | '.join(symbols))
+
+def dictOf( key, value ):
+    """
+    Helper to easily and clearly define a dictionary by specifying the respective patterns
+    for the key and value.  Takes care of defining the C{L{Dict}}, C{L{ZeroOrMore}}, and C{L{Group}} tokens
+    in the proper order.  The key pattern can include delimiting markers or punctuation,
+    as long as they are suppressed, thereby leaving the significant key text.  The value
+    pattern can include named results, so that the C{Dict} results can include named token
+    fields.
+
+    Example::
+        text = "shape: SQUARE posn: upper left color: light blue texture: burlap"
+        attr_expr = (label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
+        print(OneOrMore(attr_expr).parseString(text).dump())
+        
+        attr_label = label
+        attr_value = Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join)
+
+        # similar to Dict, but simpler call format
+        result = dictOf(attr_label, attr_value).parseString(text)
+        print(result.dump())
+        print(result['shape'])
+        print(result.shape)  # object attribute access works too
+        print(result.asDict())
+    prints::
+        [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'light blue'], ['texture', 'burlap']]
+        - color: light blue
+        - posn: upper left
+        - shape: SQUARE
+        - texture: burlap
+        SQUARE
+        SQUARE
+        {'color': 'light blue', 'shape': 'SQUARE', 'posn': 'upper left', 'texture': 'burlap'}
+    """
+    return Dict( ZeroOrMore( Group ( key + value ) ) )
+
+def originalTextFor(expr, asString=True):
+    """
+    Helper to return the original, untokenized text for a given expression.  Useful to
+    restore the parsed fields of an HTML start tag into the raw tag text itself, or to
+    revert separate tokens with intervening whitespace back to the original matching
+    input text. By default, returns astring containing the original parsed text.  
+       
+    If the optional C{asString} argument is passed as C{False}, then the return value is a 
+    C{L{ParseResults}} containing any results names that were originally matched, and a 
+    single token containing the original matched text from the input string.  So if 
+    the expression passed to C{L{originalTextFor}} contains expressions with defined
+    results names, you must set C{asString} to C{False} if you want to preserve those
+    results name values.
+
+    Example::
+        src = "this is test  bold text  normal text "
+        for tag in ("b","i"):
+            opener,closer = makeHTMLTags(tag)
+            patt = originalTextFor(opener + SkipTo(closer) + closer)
+            print(patt.searchString(src)[0])
+    prints::
+        [' bold text ']
+        ['text']
+    """
+    locMarker = Empty().setParseAction(lambda s,loc,t: loc)
+    endlocMarker = locMarker.copy()
+    endlocMarker.callPreparse = False
+    matchExpr = locMarker("_original_start") + expr + endlocMarker("_original_end")
+    if asString:
+        extractText = lambda s,l,t: s[t._original_start:t._original_end]
+    else:
+        def extractText(s,l,t):
+            t[:] = [s[t.pop('_original_start'):t.pop('_original_end')]]
+    matchExpr.setParseAction(extractText)
+    matchExpr.ignoreExprs = expr.ignoreExprs
+    return matchExpr
+
+def ungroup(expr): 
+    """
+    Helper to undo pyparsing's default grouping of And expressions, even
+    if all but one are non-empty.
+    """
+    return TokenConverter(expr).setParseAction(lambda t:t[0])
+
+def locatedExpr(expr):
+    """
+    Helper to decorate a returned token with its starting and ending locations in the input string.
+    This helper adds the following results names:
+     - locn_start = location where matched expression begins
+     - locn_end = location where matched expression ends
+     - value = the actual parsed results
+
+    Be careful if the input text contains C{} characters, you may want to call
+    C{L{ParserElement.parseWithTabs}}
+
+    Example::
+        wd = Word(alphas)
+        for match in locatedExpr(wd).searchString("ljsdf123lksdjjf123lkkjj1222"):
+            print(match)
+    prints::
+        [[0, 'ljsdf', 5]]
+        [[8, 'lksdjjf', 15]]
+        [[18, 'lkkjj', 23]]
+    """
+    locator = Empty().setParseAction(lambda s,l,t: l)
+    return Group(locator("locn_start") + expr("value") + locator.copy().leaveWhitespace()("locn_end"))
+
+
+# convenience constants for positional expressions
+empty       = Empty().setName("empty")
+lineStart   = LineStart().setName("lineStart")
+lineEnd     = LineEnd().setName("lineEnd")
+stringStart = StringStart().setName("stringStart")
+stringEnd   = StringEnd().setName("stringEnd")
+
+_escapedPunc = Word( _bslash, r"\[]-*.$+^?()~ ", exact=2 ).setParseAction(lambda s,l,t:t[0][1])
+_escapedHexChar = Regex(r"\\0?[xX][0-9a-fA-F]+").setParseAction(lambda s,l,t:unichr(int(t[0].lstrip(r'\0x'),16)))
+_escapedOctChar = Regex(r"\\0[0-7]+").setParseAction(lambda s,l,t:unichr(int(t[0][1:],8)))
+_singleChar = _escapedPunc | _escapedHexChar | _escapedOctChar | CharsNotIn(r'\]', exact=1)
+_charRange = Group(_singleChar + Suppress("-") + _singleChar)
+_reBracketExpr = Literal("[") + Optional("^").setResultsName("negate") + Group( OneOrMore( _charRange | _singleChar ) ).setResultsName("body") + "]"
+
+def srange(s):
+    r"""
+    Helper to easily define string ranges for use in Word construction.  Borrows
+    syntax from regexp '[]' string range definitions::
+        srange("[0-9]")   -> "0123456789"
+        srange("[a-z]")   -> "abcdefghijklmnopqrstuvwxyz"
+        srange("[a-z$_]") -> "abcdefghijklmnopqrstuvwxyz$_"
+    The input string must be enclosed in []'s, and the returned string is the expanded
+    character set joined into a single string.
+    The values enclosed in the []'s may be:
+     - a single character
+     - an escaped character with a leading backslash (such as C{\-} or C{\]})
+     - an escaped hex character with a leading C{'\x'} (C{\x21}, which is a C{'!'} character) 
+         (C{\0x##} is also supported for backwards compatibility) 
+     - an escaped octal character with a leading C{'\0'} (C{\041}, which is a C{'!'} character)
+     - a range of any of the above, separated by a dash (C{'a-z'}, etc.)
+     - any combination of the above (C{'aeiouy'}, C{'a-zA-Z0-9_$'}, etc.)
+    """
+    _expanded = lambda p: p if not isinstance(p,ParseResults) else ''.join(unichr(c) for c in range(ord(p[0]),ord(p[1])+1))
+    try:
+        return "".join(_expanded(part) for part in _reBracketExpr.parseString(s).body)
+    except Exception:
+        return ""
+
+def matchOnlyAtCol(n):
+    """
+    Helper method for defining parse actions that require matching at a specific
+    column in the input text.
+    """
+    def verifyCol(strg,locn,toks):
+        if col(locn,strg) != n:
+            raise ParseException(strg,locn,"matched token not at column %d" % n)
+    return verifyCol
+
+def replaceWith(replStr):
+    """
+    Helper method for common parse actions that simply return a literal value.  Especially
+    useful when used with C{L{transformString}()}.
+
+    Example::
+        num = Word(nums).setParseAction(lambda toks: int(toks[0]))
+        na = oneOf("N/A NA").setParseAction(replaceWith(math.nan))
+        term = na | num
+        
+        OneOrMore(term).parseString("324 234 N/A 234") # -> [324, 234, nan, 234]
+    """
+    return lambda s,l,t: [replStr]
+
+def removeQuotes(s,l,t):
+    """
+    Helper parse action for removing quotation marks from parsed quoted strings.
+
+    Example::
+        # by default, quotation marks are included in parsed results
+        quotedString.parseString("'Now is the Winter of our Discontent'") # -> ["'Now is the Winter of our Discontent'"]
+
+        # use removeQuotes to strip quotation marks from parsed results
+        quotedString.setParseAction(removeQuotes)
+        quotedString.parseString("'Now is the Winter of our Discontent'") # -> ["Now is the Winter of our Discontent"]
+    """
+    return t[0][1:-1]
+
+def tokenMap(func, *args):
+    """
+    Helper to define a parse action by mapping a function to all elements of a ParseResults list.If any additional 
+    args are passed, they are forwarded to the given function as additional arguments after
+    the token, as in C{hex_integer = Word(hexnums).setParseAction(tokenMap(int, 16))}, which will convert the
+    parsed data to an integer using base 16.
+
+    Example (compare the last to example in L{ParserElement.transformString}::
+        hex_ints = OneOrMore(Word(hexnums)).setParseAction(tokenMap(int, 16))
+        hex_ints.runTests('''
+            00 11 22 aa FF 0a 0d 1a
+            ''')
+        
+        upperword = Word(alphas).setParseAction(tokenMap(str.upper))
+        OneOrMore(upperword).runTests('''
+            my kingdom for a horse
+            ''')
+
+        wd = Word(alphas).setParseAction(tokenMap(str.title))
+        OneOrMore(wd).setParseAction(' '.join).runTests('''
+            now is the winter of our discontent made glorious summer by this sun of york
+            ''')
+    prints::
+        00 11 22 aa FF 0a 0d 1a
+        [0, 17, 34, 170, 255, 10, 13, 26]
+
+        my kingdom for a horse
+        ['MY', 'KINGDOM', 'FOR', 'A', 'HORSE']
+
+        now is the winter of our discontent made glorious summer by this sun of york
+        ['Now Is The Winter Of Our Discontent Made Glorious Summer By This Sun Of York']
+    """
+    def pa(s,l,t):
+        return [func(tokn, *args) for tokn in t]
+
+    try:
+        func_name = getattr(func, '__name__', 
+                            getattr(func, '__class__').__name__)
+    except Exception:
+        func_name = str(func)
+    pa.__name__ = func_name
+
+    return pa
+
+upcaseTokens = tokenMap(lambda t: _ustr(t).upper())
+"""(Deprecated) Helper parse action to convert tokens to upper case. Deprecated in favor of L{pyparsing_common.upcaseTokens}"""
+
+downcaseTokens = tokenMap(lambda t: _ustr(t).lower())
+"""(Deprecated) Helper parse action to convert tokens to lower case. Deprecated in favor of L{pyparsing_common.downcaseTokens}"""
+    
+def _makeTags(tagStr, xml):
+    """Internal helper to construct opening and closing tag expressions, given a tag name"""
+    if isinstance(tagStr,basestring):
+        resname = tagStr
+        tagStr = Keyword(tagStr, caseless=not xml)
+    else:
+        resname = tagStr.name
+
+    tagAttrName = Word(alphas,alphanums+"_-:")
+    if (xml):
+        tagAttrValue = dblQuotedString.copy().setParseAction( removeQuotes )
+        openTag = Suppress("<") + tagStr("tag") + \
+                Dict(ZeroOrMore(Group( tagAttrName + Suppress("=") + tagAttrValue ))) + \
+                Optional("/",default=[False]).setResultsName("empty").setParseAction(lambda s,l,t:t[0]=='/') + Suppress(">")
+    else:
+        printablesLessRAbrack = "".join(c for c in printables if c not in ">")
+        tagAttrValue = quotedString.copy().setParseAction( removeQuotes ) | Word(printablesLessRAbrack)
+        openTag = Suppress("<") + tagStr("tag") + \
+                Dict(ZeroOrMore(Group( tagAttrName.setParseAction(downcaseTokens) + \
+                Optional( Suppress("=") + tagAttrValue ) ))) + \
+                Optional("/",default=[False]).setResultsName("empty").setParseAction(lambda s,l,t:t[0]=='/') + Suppress(">")
+    closeTag = Combine(_L("")
+
+    openTag = openTag.setResultsName("start"+"".join(resname.replace(":"," ").title().split())).setName("<%s>" % resname)
+    closeTag = closeTag.setResultsName("end"+"".join(resname.replace(":"," ").title().split())).setName("" % resname)
+    openTag.tag = resname
+    closeTag.tag = resname
+    return openTag, closeTag
+
+def makeHTMLTags(tagStr):
+    """
+    Helper to construct opening and closing tag expressions for HTML, given a tag name. Matches
+    tags in either upper or lower case, attributes with namespaces and with quoted or unquoted values.
+
+    Example::
+        text = 'More info at the pyparsing wiki page'
+        # makeHTMLTags returns pyparsing expressions for the opening and closing tags as a 2-tuple
+        a,a_end = makeHTMLTags("A")
+        link_expr = a + SkipTo(a_end)("link_text") + a_end
+        
+        for link in link_expr.searchString(text):
+            # attributes in the  tag (like "href" shown here) are also accessible as named results
+            print(link.link_text, '->', link.href)
+    prints::
+        pyparsing -> http://pyparsing.wikispaces.com
+    """
+    return _makeTags( tagStr, False )
+
+def makeXMLTags(tagStr):
+    """
+    Helper to construct opening and closing tag expressions for XML, given a tag name. Matches
+    tags only in the given upper/lower case.
+
+    Example: similar to L{makeHTMLTags}
+    """
+    return _makeTags( tagStr, True )
+
+def withAttribute(*args,**attrDict):
+    """
+    Helper to create a validating parse action to be used with start tags created
+    with C{L{makeXMLTags}} or C{L{makeHTMLTags}}. Use C{withAttribute} to qualify a starting tag
+    with a required attribute value, to avoid false matches on common tags such as
+    C{} or C{
}. + + Call C{withAttribute} with a series of attribute names and values. Specify the list + of filter attributes names and values as: + - keyword arguments, as in C{(align="right")}, or + - as an explicit dict with C{**} operator, when an attribute name is also a Python + reserved word, as in C{**{"class":"Customer", "align":"right"}} + - a list of name-value tuples, as in ( ("ns1:class", "Customer"), ("ns2:align","right") ) + For attribute names with a namespace prefix, you must use the second form. Attribute + names are matched insensitive to upper/lower case. + + If just testing for C{class} (with or without a namespace), use C{L{withClass}}. + + To verify that the attribute exists, but without specifying a value, pass + C{withAttribute.ANY_VALUE} as the value. + + Example:: + html = ''' +
+ Some text +
1 4 0 1 0
+
1,3 2,3 1,1
+
this has no type
+
+ + ''' + div,div_end = makeHTMLTags("div") + + # only match div tag having a type attribute with value "grid" + div_grid = div().setParseAction(withAttribute(type="grid")) + grid_expr = div_grid + SkipTo(div | div_end)("body") + for grid_header in grid_expr.searchString(html): + print(grid_header.body) + + # construct a match with any div tag having a type attribute, regardless of the value + div_any_type = div().setParseAction(withAttribute(type=withAttribute.ANY_VALUE)) + div_expr = div_any_type + SkipTo(div | div_end)("body") + for div_header in div_expr.searchString(html): + print(div_header.body) + prints:: + 1 4 0 1 0 + + 1 4 0 1 0 + 1,3 2,3 1,1 + """ + if args: + attrs = args[:] + else: + attrs = attrDict.items() + attrs = [(k,v) for k,v in attrs] + def pa(s,l,tokens): + for attrName,attrValue in attrs: + if attrName not in tokens: + raise ParseException(s,l,"no matching attribute " + attrName) + if attrValue != withAttribute.ANY_VALUE and tokens[attrName] != attrValue: + raise ParseException(s,l,"attribute '%s' has value '%s', must be '%s'" % + (attrName, tokens[attrName], attrValue)) + return pa +withAttribute.ANY_VALUE = object() + +def withClass(classname, namespace=''): + """ + Simplified version of C{L{withAttribute}} when matching on a div class - made + difficult because C{class} is a reserved word in Python. + + Example:: + html = ''' +
+ Some text +
1 4 0 1 0
+
1,3 2,3 1,1
+
this <div> has no class
+
+ + ''' + div,div_end = makeHTMLTags("div") + div_grid = div().setParseAction(withClass("grid")) + + grid_expr = div_grid + SkipTo(div | div_end)("body") + for grid_header in grid_expr.searchString(html): + print(grid_header.body) + + div_any_type = div().setParseAction(withClass(withAttribute.ANY_VALUE)) + div_expr = div_any_type + SkipTo(div | div_end)("body") + for div_header in div_expr.searchString(html): + print(div_header.body) + prints:: + 1 4 0 1 0 + + 1 4 0 1 0 + 1,3 2,3 1,1 + """ + classattr = "%s:class" % namespace if namespace else "class" + return withAttribute(**{classattr : classname}) + +opAssoc = _Constants() +opAssoc.LEFT = object() +opAssoc.RIGHT = object() + +def infixNotation( baseExpr, opList, lpar=Suppress('('), rpar=Suppress(')') ): + """ + Helper method for constructing grammars of expressions made up of + operators working in a precedence hierarchy. Operators may be unary or + binary, left- or right-associative. Parse actions can also be attached + to operator expressions. The generated parser will also recognize the use + of parentheses to override operator precedences (see example below). + + Note: if you define a deep operator list, you may see performance issues + when using infixNotation. See L{ParserElement.enablePackrat} for a + mechanism to potentially improve your parser performance. + + Parameters: + - baseExpr - expression representing the most basic element for the nested + - opList - list of tuples, one for each operator precedence level in the + expression grammar; each tuple is of the form + (opExpr, numTerms, rightLeftAssoc, parseAction), where: + - opExpr is the pyparsing expression for the operator; + may also be a string, which will be converted to a Literal; + if numTerms is 3, opExpr is a tuple of two expressions, for the + two operators separating the 3 terms + - numTerms is the number of terms for this operator (must + be 1, 2, or 3) + - rightLeftAssoc is the indicator whether the operator is + right or left associative, using the pyparsing-defined + constants C{opAssoc.RIGHT} and C{opAssoc.LEFT}. + - parseAction is the parse action to be associated with + expressions matching this operator expression (the + parse action tuple member may be omitted); if the parse action + is passed a tuple or list of functions, this is equivalent to + calling C{setParseAction(*fn)} (L{ParserElement.setParseAction}) + - lpar - expression for matching left-parentheses (default=C{Suppress('(')}) + - rpar - expression for matching right-parentheses (default=C{Suppress(')')}) + + Example:: + # simple example of four-function arithmetic with ints and variable names + integer = pyparsing_common.signed_integer + varname = pyparsing_common.identifier + + arith_expr = infixNotation(integer | varname, + [ + ('-', 1, opAssoc.RIGHT), + (oneOf('* /'), 2, opAssoc.LEFT), + (oneOf('+ -'), 2, opAssoc.LEFT), + ]) + + arith_expr.runTests(''' + 5+3*6 + (5+3)*6 + -2--11 + ''', fullDump=False) + prints:: + 5+3*6 + [[5, '+', [3, '*', 6]]] + + (5+3)*6 + [[[5, '+', 3], '*', 6]] + + -2--11 + [[['-', 2], '-', ['-', 11]]] + """ + ret = Forward() + lastExpr = baseExpr | ( lpar + ret + rpar ) + for i,operDef in enumerate(opList): + opExpr,arity,rightLeftAssoc,pa = (operDef + (None,))[:4] + termName = "%s term" % opExpr if arity < 3 else "%s%s term" % opExpr + if arity == 3: + if opExpr is None or len(opExpr) != 2: + raise ValueError("if numterms=3, opExpr must be a tuple or list of two expressions") + opExpr1, opExpr2 = opExpr + thisExpr = Forward().setName(termName) + if rightLeftAssoc == opAssoc.LEFT: + if arity == 1: + matchExpr = FollowedBy(lastExpr + opExpr) + Group( lastExpr + OneOrMore( opExpr ) ) + elif arity == 2: + if opExpr is not None: + matchExpr = FollowedBy(lastExpr + opExpr + lastExpr) + Group( lastExpr + OneOrMore( opExpr + lastExpr ) ) + else: + matchExpr = FollowedBy(lastExpr+lastExpr) + Group( lastExpr + OneOrMore(lastExpr) ) + elif arity == 3: + matchExpr = FollowedBy(lastExpr + opExpr1 + lastExpr + opExpr2 + lastExpr) + \ + Group( lastExpr + opExpr1 + lastExpr + opExpr2 + lastExpr ) + else: + raise ValueError("operator must be unary (1), binary (2), or ternary (3)") + elif rightLeftAssoc == opAssoc.RIGHT: + if arity == 1: + # try to avoid LR with this extra test + if not isinstance(opExpr, Optional): + opExpr = Optional(opExpr) + matchExpr = FollowedBy(opExpr.expr + thisExpr) + Group( opExpr + thisExpr ) + elif arity == 2: + if opExpr is not None: + matchExpr = FollowedBy(lastExpr + opExpr + thisExpr) + Group( lastExpr + OneOrMore( opExpr + thisExpr ) ) + else: + matchExpr = FollowedBy(lastExpr + thisExpr) + Group( lastExpr + OneOrMore( thisExpr ) ) + elif arity == 3: + matchExpr = FollowedBy(lastExpr + opExpr1 + thisExpr + opExpr2 + thisExpr) + \ + Group( lastExpr + opExpr1 + thisExpr + opExpr2 + thisExpr ) + else: + raise ValueError("operator must be unary (1), binary (2), or ternary (3)") + else: + raise ValueError("operator must indicate right or left associativity") + if pa: + if isinstance(pa, (tuple, list)): + matchExpr.setParseAction(*pa) + else: + matchExpr.setParseAction(pa) + thisExpr <<= ( matchExpr.setName(termName) | lastExpr ) + lastExpr = thisExpr + ret <<= lastExpr + return ret + +operatorPrecedence = infixNotation +"""(Deprecated) Former name of C{L{infixNotation}}, will be dropped in a future release.""" + +dblQuotedString = Combine(Regex(r'"(?:[^"\n\r\\]|(?:"")|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*')+'"').setName("string enclosed in double quotes") +sglQuotedString = Combine(Regex(r"'(?:[^'\n\r\\]|(?:'')|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*")+"'").setName("string enclosed in single quotes") +quotedString = Combine(Regex(r'"(?:[^"\n\r\\]|(?:"")|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*')+'"'| + Regex(r"'(?:[^'\n\r\\]|(?:'')|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*")+"'").setName("quotedString using single or double quotes") +unicodeString = Combine(_L('u') + quotedString.copy()).setName("unicode string literal") + +def nestedExpr(opener="(", closer=")", content=None, ignoreExpr=quotedString.copy()): + """ + Helper method for defining nested lists enclosed in opening and closing + delimiters ("(" and ")" are the default). + + Parameters: + - opener - opening character for a nested list (default=C{"("}); can also be a pyparsing expression + - closer - closing character for a nested list (default=C{")"}); can also be a pyparsing expression + - content - expression for items within the nested lists (default=C{None}) + - ignoreExpr - expression for ignoring opening and closing delimiters (default=C{quotedString}) + + If an expression is not provided for the content argument, the nested + expression will capture all whitespace-delimited content between delimiters + as a list of separate values. + + Use the C{ignoreExpr} argument to define expressions that may contain + opening or closing characters that should not be treated as opening + or closing characters for nesting, such as quotedString or a comment + expression. Specify multiple expressions using an C{L{Or}} or C{L{MatchFirst}}. + The default is L{quotedString}, but if no expressions are to be ignored, + then pass C{None} for this argument. + + Example:: + data_type = oneOf("void int short long char float double") + decl_data_type = Combine(data_type + Optional(Word('*'))) + ident = Word(alphas+'_', alphanums+'_') + number = pyparsing_common.number + arg = Group(decl_data_type + ident) + LPAR,RPAR = map(Suppress, "()") + + code_body = nestedExpr('{', '}', ignoreExpr=(quotedString | cStyleComment)) + + c_function = (decl_data_type("type") + + ident("name") + + LPAR + Optional(delimitedList(arg), [])("args") + RPAR + + code_body("body")) + c_function.ignore(cStyleComment) + + source_code = ''' + int is_odd(int x) { + return (x%2); + } + + int dec_to_hex(char hchar) { + if (hchar >= '0' && hchar <= '9') { + return (ord(hchar)-ord('0')); + } else { + return (10+ord(hchar)-ord('A')); + } + } + ''' + for func in c_function.searchString(source_code): + print("%(name)s (%(type)s) args: %(args)s" % func) + + prints:: + is_odd (int) args: [['int', 'x']] + dec_to_hex (int) args: [['char', 'hchar']] + """ + if opener == closer: + raise ValueError("opening and closing strings cannot be the same") + if content is None: + if isinstance(opener,basestring) and isinstance(closer,basestring): + if len(opener) == 1 and len(closer)==1: + if ignoreExpr is not None: + content = (Combine(OneOrMore(~ignoreExpr + + CharsNotIn(opener+closer+ParserElement.DEFAULT_WHITE_CHARS,exact=1)) + ).setParseAction(lambda t:t[0].strip())) + else: + content = (empty.copy()+CharsNotIn(opener+closer+ParserElement.DEFAULT_WHITE_CHARS + ).setParseAction(lambda t:t[0].strip())) + else: + if ignoreExpr is not None: + content = (Combine(OneOrMore(~ignoreExpr + + ~Literal(opener) + ~Literal(closer) + + CharsNotIn(ParserElement.DEFAULT_WHITE_CHARS,exact=1)) + ).setParseAction(lambda t:t[0].strip())) + else: + content = (Combine(OneOrMore(~Literal(opener) + ~Literal(closer) + + CharsNotIn(ParserElement.DEFAULT_WHITE_CHARS,exact=1)) + ).setParseAction(lambda t:t[0].strip())) + else: + raise ValueError("opening and closing arguments must be strings if no content expression is given") + ret = Forward() + if ignoreExpr is not None: + ret <<= Group( Suppress(opener) + ZeroOrMore( ignoreExpr | ret | content ) + Suppress(closer) ) + else: + ret <<= Group( Suppress(opener) + ZeroOrMore( ret | content ) + Suppress(closer) ) + ret.setName('nested %s%s expression' % (opener,closer)) + return ret + +def indentedBlock(blockStatementExpr, indentStack, indent=True): + """ + Helper method for defining space-delimited indentation blocks, such as + those used to define block statements in Python source code. + + Parameters: + - blockStatementExpr - expression defining syntax of statement that + is repeated within the indented block + - indentStack - list created by caller to manage indentation stack + (multiple statementWithIndentedBlock expressions within a single grammar + should share a common indentStack) + - indent - boolean indicating whether block must be indented beyond the + the current level; set to False for block of left-most statements + (default=C{True}) + + A valid block must contain at least one C{blockStatement}. + + Example:: + data = ''' + def A(z): + A1 + B = 100 + G = A2 + A2 + A3 + B + def BB(a,b,c): + BB1 + def BBA(): + bba1 + bba2 + bba3 + C + D + def spam(x,y): + def eggs(z): + pass + ''' + + + indentStack = [1] + stmt = Forward() + + identifier = Word(alphas, alphanums) + funcDecl = ("def" + identifier + Group( "(" + Optional( delimitedList(identifier) ) + ")" ) + ":") + func_body = indentedBlock(stmt, indentStack) + funcDef = Group( funcDecl + func_body ) + + rvalue = Forward() + funcCall = Group(identifier + "(" + Optional(delimitedList(rvalue)) + ")") + rvalue << (funcCall | identifier | Word(nums)) + assignment = Group(identifier + "=" + rvalue) + stmt << ( funcDef | assignment | identifier ) + + module_body = OneOrMore(stmt) + + parseTree = module_body.parseString(data) + parseTree.pprint() + prints:: + [['def', + 'A', + ['(', 'z', ')'], + ':', + [['A1'], [['B', '=', '100']], [['G', '=', 'A2']], ['A2'], ['A3']]], + 'B', + ['def', + 'BB', + ['(', 'a', 'b', 'c', ')'], + ':', + [['BB1'], [['def', 'BBA', ['(', ')'], ':', [['bba1'], ['bba2'], ['bba3']]]]]], + 'C', + 'D', + ['def', + 'spam', + ['(', 'x', 'y', ')'], + ':', + [[['def', 'eggs', ['(', 'z', ')'], ':', [['pass']]]]]]] + """ + def checkPeerIndent(s,l,t): + if l >= len(s): return + curCol = col(l,s) + if curCol != indentStack[-1]: + if curCol > indentStack[-1]: + raise ParseFatalException(s,l,"illegal nesting") + raise ParseException(s,l,"not a peer entry") + + def checkSubIndent(s,l,t): + curCol = col(l,s) + if curCol > indentStack[-1]: + indentStack.append( curCol ) + else: + raise ParseException(s,l,"not a subentry") + + def checkUnindent(s,l,t): + if l >= len(s): return + curCol = col(l,s) + if not(indentStack and curCol < indentStack[-1] and curCol <= indentStack[-2]): + raise ParseException(s,l,"not an unindent") + indentStack.pop() + + NL = OneOrMore(LineEnd().setWhitespaceChars("\t ").suppress()) + INDENT = (Empty() + Empty().setParseAction(checkSubIndent)).setName('INDENT') + PEER = Empty().setParseAction(checkPeerIndent).setName('') + UNDENT = Empty().setParseAction(checkUnindent).setName('UNINDENT') + if indent: + smExpr = Group( Optional(NL) + + #~ FollowedBy(blockStatementExpr) + + INDENT + (OneOrMore( PEER + Group(blockStatementExpr) + Optional(NL) )) + UNDENT) + else: + smExpr = Group( Optional(NL) + + (OneOrMore( PEER + Group(blockStatementExpr) + Optional(NL) )) ) + blockStatementExpr.ignore(_bslash + LineEnd()) + return smExpr.setName('indented block') + +alphas8bit = srange(r"[\0xc0-\0xd6\0xd8-\0xf6\0xf8-\0xff]") +punc8bit = srange(r"[\0xa1-\0xbf\0xd7\0xf7]") + +anyOpenTag,anyCloseTag = makeHTMLTags(Word(alphas,alphanums+"_:").setName('any tag')) +_htmlEntityMap = dict(zip("gt lt amp nbsp quot apos".split(),'><& "\'')) +commonHTMLEntity = Regex('&(?P' + '|'.join(_htmlEntityMap.keys()) +");").setName("common HTML entity") +def replaceHTMLEntity(t): + """Helper parser action to replace common HTML entities with their special characters""" + return _htmlEntityMap.get(t.entity) + +# it's easy to get these comment structures wrong - they're very common, so may as well make them available +cStyleComment = Combine(Regex(r"/\*(?:[^*]|\*(?!/))*") + '*/').setName("C style comment") +"Comment of the form C{/* ... */}" + +htmlComment = Regex(r"").setName("HTML comment") +"Comment of the form C{}" + +restOfLine = Regex(r".*").leaveWhitespace().setName("rest of line") +dblSlashComment = Regex(r"//(?:\\\n|[^\n])*").setName("// comment") +"Comment of the form C{// ... (to end of line)}" + +cppStyleComment = Combine(Regex(r"/\*(?:[^*]|\*(?!/))*") + '*/'| dblSlashComment).setName("C++ style comment") +"Comment of either form C{L{cStyleComment}} or C{L{dblSlashComment}}" + +javaStyleComment = cppStyleComment +"Same as C{L{cppStyleComment}}" + +pythonStyleComment = Regex(r"#.*").setName("Python style comment") +"Comment of the form C{# ... (to end of line)}" + +_commasepitem = Combine(OneOrMore(Word(printables, excludeChars=',') + + Optional( Word(" \t") + + ~Literal(",") + ~LineEnd() ) ) ).streamline().setName("commaItem") +commaSeparatedList = delimitedList( Optional( quotedString.copy() | _commasepitem, default="") ).setName("commaSeparatedList") +"""(Deprecated) Predefined expression of 1 or more printable words or quoted strings, separated by commas. + This expression is deprecated in favor of L{pyparsing_common.comma_separated_list}.""" + +# some other useful expressions - using lower-case class name since we are really using this as a namespace +class pyparsing_common: + """ + Here are some common low-level expressions that may be useful in jump-starting parser development: + - numeric forms (L{integers}, L{reals}, L{scientific notation}) + - common L{programming identifiers} + - network addresses (L{MAC}, L{IPv4}, L{IPv6}) + - ISO8601 L{dates} and L{datetime} + - L{UUID} + - L{comma-separated list} + Parse actions: + - C{L{convertToInteger}} + - C{L{convertToFloat}} + - C{L{convertToDate}} + - C{L{convertToDatetime}} + - C{L{stripHTMLTags}} + - C{L{upcaseTokens}} + - C{L{downcaseTokens}} + + Example:: + pyparsing_common.number.runTests(''' + # any int or real number, returned as the appropriate type + 100 + -100 + +100 + 3.14159 + 6.02e23 + 1e-12 + ''') + + pyparsing_common.fnumber.runTests(''' + # any int or real number, returned as float + 100 + -100 + +100 + 3.14159 + 6.02e23 + 1e-12 + ''') + + pyparsing_common.hex_integer.runTests(''' + # hex numbers + 100 + FF + ''') + + pyparsing_common.fraction.runTests(''' + # fractions + 1/2 + -3/4 + ''') + + pyparsing_common.mixed_integer.runTests(''' + # mixed fractions + 1 + 1/2 + -3/4 + 1-3/4 + ''') + + import uuid + pyparsing_common.uuid.setParseAction(tokenMap(uuid.UUID)) + pyparsing_common.uuid.runTests(''' + # uuid + 12345678-1234-5678-1234-567812345678 + ''') + prints:: + # any int or real number, returned as the appropriate type + 100 + [100] + + -100 + [-100] + + +100 + [100] + + 3.14159 + [3.14159] + + 6.02e23 + [6.02e+23] + + 1e-12 + [1e-12] + + # any int or real number, returned as float + 100 + [100.0] + + -100 + [-100.0] + + +100 + [100.0] + + 3.14159 + [3.14159] + + 6.02e23 + [6.02e+23] + + 1e-12 + [1e-12] + + # hex numbers + 100 + [256] + + FF + [255] + + # fractions + 1/2 + [0.5] + + -3/4 + [-0.75] + + # mixed fractions + 1 + [1] + + 1/2 + [0.5] + + -3/4 + [-0.75] + + 1-3/4 + [1.75] + + # uuid + 12345678-1234-5678-1234-567812345678 + [UUID('12345678-1234-5678-1234-567812345678')] + """ + + convertToInteger = tokenMap(int) + """ + Parse action for converting parsed integers to Python int + """ + + convertToFloat = tokenMap(float) + """ + Parse action for converting parsed numbers to Python float + """ + + integer = Word(nums).setName("integer").setParseAction(convertToInteger) + """expression that parses an unsigned integer, returns an int""" + + hex_integer = Word(hexnums).setName("hex integer").setParseAction(tokenMap(int,16)) + """expression that parses a hexadecimal integer, returns an int""" + + signed_integer = Regex(r'[+-]?\d+').setName("signed integer").setParseAction(convertToInteger) + """expression that parses an integer with optional leading sign, returns an int""" + + fraction = (signed_integer().setParseAction(convertToFloat) + '/' + signed_integer().setParseAction(convertToFloat)).setName("fraction") + """fractional expression of an integer divided by an integer, returns a float""" + fraction.addParseAction(lambda t: t[0]/t[-1]) + + mixed_integer = (fraction | signed_integer + Optional(Optional('-').suppress() + fraction)).setName("fraction or mixed integer-fraction") + """mixed integer of the form 'integer - fraction', with optional leading integer, returns float""" + mixed_integer.addParseAction(sum) + + real = Regex(r'[+-]?\d+\.\d*').setName("real number").setParseAction(convertToFloat) + """expression that parses a floating point number and returns a float""" + + sci_real = Regex(r'[+-]?\d+([eE][+-]?\d+|\.\d*([eE][+-]?\d+)?)').setName("real number with scientific notation").setParseAction(convertToFloat) + """expression that parses a floating point number with optional scientific notation and returns a float""" + + # streamlining this expression makes the docs nicer-looking + number = (sci_real | real | signed_integer).streamline() + """any numeric expression, returns the corresponding Python type""" + + fnumber = Regex(r'[+-]?\d+\.?\d*([eE][+-]?\d+)?').setName("fnumber").setParseAction(convertToFloat) + """any int or real number, returned as float""" + + identifier = Word(alphas+'_', alphanums+'_').setName("identifier") + """typical code identifier (leading alpha or '_', followed by 0 or more alphas, nums, or '_')""" + + ipv4_address = Regex(r'(25[0-5]|2[0-4][0-9]|1?[0-9]{1,2})(\.(25[0-5]|2[0-4][0-9]|1?[0-9]{1,2})){3}').setName("IPv4 address") + "IPv4 address (C{0.0.0.0 - 255.255.255.255})" + + _ipv6_part = Regex(r'[0-9a-fA-F]{1,4}').setName("hex_integer") + _full_ipv6_address = (_ipv6_part + (':' + _ipv6_part)*7).setName("full IPv6 address") + _short_ipv6_address = (Optional(_ipv6_part + (':' + _ipv6_part)*(0,6)) + "::" + Optional(_ipv6_part + (':' + _ipv6_part)*(0,6))).setName("short IPv6 address") + _short_ipv6_address.addCondition(lambda t: sum(1 for tt in t if pyparsing_common._ipv6_part.matches(tt)) < 8) + _mixed_ipv6_address = ("::ffff:" + ipv4_address).setName("mixed IPv6 address") + ipv6_address = Combine((_full_ipv6_address | _mixed_ipv6_address | _short_ipv6_address).setName("IPv6 address")).setName("IPv6 address") + "IPv6 address (long, short, or mixed form)" + + mac_address = Regex(r'[0-9a-fA-F]{2}([:.-])[0-9a-fA-F]{2}(?:\1[0-9a-fA-F]{2}){4}').setName("MAC address") + "MAC address xx:xx:xx:xx:xx (may also have '-' or '.' delimiters)" + + @staticmethod + def convertToDate(fmt="%Y-%m-%d"): + """ + Helper to create a parse action for converting parsed date string to Python datetime.date + + Params - + - fmt - format to be passed to datetime.strptime (default=C{"%Y-%m-%d"}) + + Example:: + date_expr = pyparsing_common.iso8601_date.copy() + date_expr.setParseAction(pyparsing_common.convertToDate()) + print(date_expr.parseString("1999-12-31")) + prints:: + [datetime.date(1999, 12, 31)] + """ + def cvt_fn(s,l,t): + try: + return datetime.strptime(t[0], fmt).date() + except ValueError as ve: + raise ParseException(s, l, str(ve)) + return cvt_fn + + @staticmethod + def convertToDatetime(fmt="%Y-%m-%dT%H:%M:%S.%f"): + """ + Helper to create a parse action for converting parsed datetime string to Python datetime.datetime + + Params - + - fmt - format to be passed to datetime.strptime (default=C{"%Y-%m-%dT%H:%M:%S.%f"}) + + Example:: + dt_expr = pyparsing_common.iso8601_datetime.copy() + dt_expr.setParseAction(pyparsing_common.convertToDatetime()) + print(dt_expr.parseString("1999-12-31T23:59:59.999")) + prints:: + [datetime.datetime(1999, 12, 31, 23, 59, 59, 999000)] + """ + def cvt_fn(s,l,t): + try: + return datetime.strptime(t[0], fmt) + except ValueError as ve: + raise ParseException(s, l, str(ve)) + return cvt_fn + + iso8601_date = Regex(r'(?P\d{4})(?:-(?P\d\d)(?:-(?P\d\d))?)?').setName("ISO8601 date") + "ISO8601 date (C{yyyy-mm-dd})" + + iso8601_datetime = Regex(r'(?P\d{4})-(?P\d\d)-(?P\d\d)[T ](?P\d\d):(?P\d\d)(:(?P\d\d(\.\d*)?)?)?(?PZ|[+-]\d\d:?\d\d)?').setName("ISO8601 datetime") + "ISO8601 datetime (C{yyyy-mm-ddThh:mm:ss.s(Z|+-00:00)}) - trailing seconds, milliseconds, and timezone optional; accepts separating C{'T'} or C{' '}" + + uuid = Regex(r'[0-9a-fA-F]{8}(-[0-9a-fA-F]{4}){3}-[0-9a-fA-F]{12}').setName("UUID") + "UUID (C{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx})" + + _html_stripper = anyOpenTag.suppress() | anyCloseTag.suppress() + @staticmethod + def stripHTMLTags(s, l, tokens): + """ + Parse action to remove HTML tags from web page HTML source + + Example:: + # strip HTML links from normal text + text = 'More info at the
pyparsing wiki page' + td,td_end = makeHTMLTags("TD") + table_text = td + SkipTo(td_end).setParseAction(pyparsing_common.stripHTMLTags)("body") + td_end + + print(table_text.parseString(text).body) # -> 'More info at the pyparsing wiki page' + """ + return pyparsing_common._html_stripper.transformString(tokens[0]) + + _commasepitem = Combine(OneOrMore(~Literal(",") + ~LineEnd() + Word(printables, excludeChars=',') + + Optional( White(" \t") ) ) ).streamline().setName("commaItem") + comma_separated_list = delimitedList( Optional( quotedString.copy() | _commasepitem, default="") ).setName("comma separated list") + """Predefined expression of 1 or more printable words or quoted strings, separated by commas.""" + + upcaseTokens = staticmethod(tokenMap(lambda t: _ustr(t).upper())) + """Parse action to convert tokens to upper case.""" + + downcaseTokens = staticmethod(tokenMap(lambda t: _ustr(t).lower())) + """Parse action to convert tokens to lower case.""" + + +if __name__ == "__main__": + + selectToken = CaselessLiteral("select") + fromToken = CaselessLiteral("from") + + ident = Word(alphas, alphanums + "_$") + + columnName = delimitedList(ident, ".", combine=True).setParseAction(upcaseTokens) + columnNameList = Group(delimitedList(columnName)).setName("columns") + columnSpec = ('*' | columnNameList) + + tableName = delimitedList(ident, ".", combine=True).setParseAction(upcaseTokens) + tableNameList = Group(delimitedList(tableName)).setName("tables") + + simpleSQL = selectToken("command") + columnSpec("columns") + fromToken + tableNameList("tables") + + # demo runTests method, including embedded comments in test string + simpleSQL.runTests(""" + # '*' as column list and dotted table name + select * from SYS.XYZZY + + # caseless match on "SELECT", and casts back to "select" + SELECT * from XYZZY, ABC + + # list of column names, and mixed case SELECT keyword + Select AA,BB,CC from Sys.dual + + # multiple tables + Select A, B, C from Sys.dual, Table2 + + # invalid SELECT keyword - should fail + Xelect A, B, C from Sys.dual + + # incomplete command - should fail + Select + + # invalid column name - should fail + Select ^^^ frox Sys.dual + + """) + + pyparsing_common.number.runTests(""" + 100 + -100 + +100 + 3.14159 + 6.02e23 + 1e-12 + """) + + # any int or real number, returned as float + pyparsing_common.fnumber.runTests(""" + 100 + -100 + +100 + 3.14159 + 6.02e23 + 1e-12 + """) + + pyparsing_common.hex_integer.runTests(""" + 100 + FF + """) + + import uuid + pyparsing_common.uuid.setParseAction(tokenMap(uuid.UUID)) + pyparsing_common.uuid.runTests(""" + 12345678-1234-5678-1234-567812345678 + """) diff --git a/venv/lib/python3.8/site-packages/pkg_resources/_vendor/six.py b/venv/lib/python3.8/site-packages/pkg_resources/_vendor/six.py new file mode 100644 index 000000000..190c0239c --- /dev/null +++ b/venv/lib/python3.8/site-packages/pkg_resources/_vendor/six.py @@ -0,0 +1,868 @@ +"""Utilities for writing code that runs on Python 2 and 3""" + +# Copyright (c) 2010-2015 Benjamin Peterson +# +# Permission is hereby granted, free of charge, to any person obtaining a copy +# of this software and associated documentation files (the "Software"), to deal +# in the Software without restriction, including without limitation the rights +# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +# copies of the Software, and to permit persons to whom the Software is +# furnished to do so, subject to the following conditions: +# +# The above copyright notice and this permission notice shall be included in all +# copies or substantial portions of the Software. +# +# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +# SOFTWARE. + +from __future__ import absolute_import + +import functools +import itertools +import operator +import sys +import types + +__author__ = "Benjamin Peterson " +__version__ = "1.10.0" + + +# Useful for very coarse version differentiation. +PY2 = sys.version_info[0] == 2 +PY3 = sys.version_info[0] == 3 +PY34 = sys.version_info[0:2] >= (3, 4) + +if PY3: + string_types = str, + integer_types = int, + class_types = type, + text_type = str + binary_type = bytes + + MAXSIZE = sys.maxsize +else: + string_types = basestring, + integer_types = (int, long) + class_types = (type, types.ClassType) + text_type = unicode + binary_type = str + + if sys.platform.startswith("java"): + # Jython always uses 32 bits. + MAXSIZE = int((1 << 31) - 1) + else: + # It's possible to have sizeof(long) != sizeof(Py_ssize_t). + class X(object): + + def __len__(self): + return 1 << 31 + try: + len(X()) + except OverflowError: + # 32-bit + MAXSIZE = int((1 << 31) - 1) + else: + # 64-bit + MAXSIZE = int((1 << 63) - 1) + del X + + +def _add_doc(func, doc): + """Add documentation to a function.""" + func.__doc__ = doc + + +def _import_module(name): + """Import module, returning the module after the last dot.""" + __import__(name) + return sys.modules[name] + + +class _LazyDescr(object): + + def __init__(self, name): + self.name = name + + def __get__(self, obj, tp): + result = self._resolve() + setattr(obj, self.name, result) # Invokes __set__. + try: + # This is a bit ugly, but it avoids running this again by + # removing this descriptor. + delattr(obj.__class__, self.name) + except AttributeError: + pass + return result + + +class MovedModule(_LazyDescr): + + def __init__(self, name, old, new=None): + super(MovedModule, self).__init__(name) + if PY3: + if new is None: + new = name + self.mod = new + else: + self.mod = old + + def _resolve(self): + return _import_module(self.mod) + + def __getattr__(self, attr): + _module = self._resolve() + value = getattr(_module, attr) + setattr(self, attr, value) + return value + + +class _LazyModule(types.ModuleType): + + def __init__(self, name): + super(_LazyModule, self).__init__(name) + self.__doc__ = self.__class__.__doc__ + + def __dir__(self): + attrs = ["__doc__", "__name__"] + attrs += [attr.name for attr in self._moved_attributes] + return attrs + + # Subclasses should override this + _moved_attributes = [] + + +class MovedAttribute(_LazyDescr): + + def __init__(self, name, old_mod, new_mod, old_attr=None, new_attr=None): + super(MovedAttribute, self).__init__(name) + if PY3: + if new_mod is None: + new_mod = name + self.mod = new_mod + if new_attr is None: + if old_attr is None: + new_attr = name + else: + new_attr = old_attr + self.attr = new_attr + else: + self.mod = old_mod + if old_attr is None: + old_attr = name + self.attr = old_attr + + def _resolve(self): + module = _import_module(self.mod) + return getattr(module, self.attr) + + +class _SixMetaPathImporter(object): + + """ + A meta path importer to import six.moves and its submodules. + + This class implements a PEP302 finder and loader. It should be compatible + with Python 2.5 and all existing versions of Python3 + """ + + def __init__(self, six_module_name): + self.name = six_module_name + self.known_modules = {} + + def _add_module(self, mod, *fullnames): + for fullname in fullnames: + self.known_modules[self.name + "." + fullname] = mod + + def _get_module(self, fullname): + return self.known_modules[self.name + "." + fullname] + + def find_module(self, fullname, path=None): + if fullname in self.known_modules: + return self + return None + + def __get_module(self, fullname): + try: + return self.known_modules[fullname] + except KeyError: + raise ImportError("This loader does not know module " + fullname) + + def load_module(self, fullname): + try: + # in case of a reload + return sys.modules[fullname] + except KeyError: + pass + mod = self.__get_module(fullname) + if isinstance(mod, MovedModule): + mod = mod._resolve() + else: + mod.__loader__ = self + sys.modules[fullname] = mod + return mod + + def is_package(self, fullname): + """ + Return true, if the named module is a package. + + We need this method to get correct spec objects with + Python 3.4 (see PEP451) + """ + return hasattr(self.__get_module(fullname), "__path__") + + def get_code(self, fullname): + """Return None + + Required, if is_package is implemented""" + self.__get_module(fullname) # eventually raises ImportError + return None + get_source = get_code # same as get_code + +_importer = _SixMetaPathImporter(__name__) + + +class _MovedItems(_LazyModule): + + """Lazy loading of moved objects""" + __path__ = [] # mark as package + + +_moved_attributes = [ + MovedAttribute("cStringIO", "cStringIO", "io", "StringIO"), + MovedAttribute("filter", "itertools", "builtins", "ifilter", "filter"), + MovedAttribute("filterfalse", "itertools", "itertools", "ifilterfalse", "filterfalse"), + MovedAttribute("input", "__builtin__", "builtins", "raw_input", "input"), + MovedAttribute("intern", "__builtin__", "sys"), + MovedAttribute("map", "itertools", "builtins", "imap", "map"), + MovedAttribute("getcwd", "os", "os", "getcwdu", "getcwd"), + MovedAttribute("getcwdb", "os", "os", "getcwd", "getcwdb"), + MovedAttribute("range", "__builtin__", "builtins", "xrange", "range"), + MovedAttribute("reload_module", "__builtin__", "importlib" if PY34 else "imp", "reload"), + MovedAttribute("reduce", "__builtin__", "functools"), + MovedAttribute("shlex_quote", "pipes", "shlex", "quote"), + MovedAttribute("StringIO", "StringIO", "io"), + MovedAttribute("UserDict", "UserDict", "collections"), + MovedAttribute("UserList", "UserList", "collections"), + MovedAttribute("UserString", "UserString", "collections"), + MovedAttribute("xrange", "__builtin__", "builtins", "xrange", "range"), + MovedAttribute("zip", "itertools", "builtins", "izip", "zip"), + MovedAttribute("zip_longest", "itertools", "itertools", "izip_longest", "zip_longest"), + MovedModule("builtins", "__builtin__"), + MovedModule("configparser", "ConfigParser"), + MovedModule("copyreg", "copy_reg"), + MovedModule("dbm_gnu", "gdbm", "dbm.gnu"), + MovedModule("_dummy_thread", "dummy_thread", "_dummy_thread"), + MovedModule("http_cookiejar", "cookielib", "http.cookiejar"), + MovedModule("http_cookies", "Cookie", "http.cookies"), + MovedModule("html_entities", "htmlentitydefs", "html.entities"), + MovedModule("html_parser", "HTMLParser", "html.parser"), + MovedModule("http_client", "httplib", "http.client"), + MovedModule("email_mime_multipart", "email.MIMEMultipart", "email.mime.multipart"), + MovedModule("email_mime_nonmultipart", "email.MIMENonMultipart", "email.mime.nonmultipart"), + MovedModule("email_mime_text", "email.MIMEText", "email.mime.text"), + MovedModule("email_mime_base", "email.MIMEBase", "email.mime.base"), + MovedModule("BaseHTTPServer", "BaseHTTPServer", "http.server"), + MovedModule("CGIHTTPServer", "CGIHTTPServer", "http.server"), + MovedModule("SimpleHTTPServer", "SimpleHTTPServer", "http.server"), + MovedModule("cPickle", "cPickle", "pickle"), + MovedModule("queue", "Queue"), + MovedModule("reprlib", "repr"), + MovedModule("socketserver", "SocketServer"), + MovedModule("_thread", "thread", "_thread"), + MovedModule("tkinter", "Tkinter"), + MovedModule("tkinter_dialog", "Dialog", "tkinter.dialog"), + MovedModule("tkinter_filedialog", "FileDialog", "tkinter.filedialog"), + MovedModule("tkinter_scrolledtext", "ScrolledText", "tkinter.scrolledtext"), + MovedModule("tkinter_simpledialog", "SimpleDialog", "tkinter.simpledialog"), + MovedModule("tkinter_tix", "Tix", "tkinter.tix"), + MovedModule("tkinter_ttk", "ttk", "tkinter.ttk"), + MovedModule("tkinter_constants", "Tkconstants", "tkinter.constants"), + MovedModule("tkinter_dnd", "Tkdnd", "tkinter.dnd"), + MovedModule("tkinter_colorchooser", "tkColorChooser", + "tkinter.colorchooser"), + MovedModule("tkinter_commondialog", "tkCommonDialog", + "tkinter.commondialog"), + MovedModule("tkinter_tkfiledialog", "tkFileDialog", "tkinter.filedialog"), + MovedModule("tkinter_font", "tkFont", "tkinter.font"), + MovedModule("tkinter_messagebox", "tkMessageBox", "tkinter.messagebox"), + MovedModule("tkinter_tksimpledialog", "tkSimpleDialog", + "tkinter.simpledialog"), + MovedModule("urllib_parse", __name__ + ".moves.urllib_parse", "urllib.parse"), + MovedModule("urllib_error", __name__ + ".moves.urllib_error", "urllib.error"), + MovedModule("urllib", __name__ + ".moves.urllib", __name__ + ".moves.urllib"), + MovedModule("urllib_robotparser", "robotparser", "urllib.robotparser"), + MovedModule("xmlrpc_client", "xmlrpclib", "xmlrpc.client"), + MovedModule("xmlrpc_server", "SimpleXMLRPCServer", "xmlrpc.server"), +] +# Add windows specific modules. +if sys.platform == "win32": + _moved_attributes += [ + MovedModule("winreg", "_winreg"), + ] + +for attr in _moved_attributes: + setattr(_MovedItems, attr.name, attr) + if isinstance(attr, MovedModule): + _importer._add_module(attr, "moves." + attr.name) +del attr + +_MovedItems._moved_attributes = _moved_attributes + +moves = _MovedItems(__name__ + ".moves") +_importer._add_module(moves, "moves") + + +class Module_six_moves_urllib_parse(_LazyModule): + + """Lazy loading of moved objects in six.moves.urllib_parse""" + + +_urllib_parse_moved_attributes = [ + MovedAttribute("ParseResult", "urlparse", "urllib.parse"), + MovedAttribute("SplitResult", "urlparse", "urllib.parse"), + MovedAttribute("parse_qs", "urlparse", "urllib.parse"), + MovedAttribute("parse_qsl", "urlparse", "urllib.parse"), + MovedAttribute("urldefrag", "urlparse", "urllib.parse"), + MovedAttribute("urljoin", "urlparse", "urllib.parse"), + MovedAttribute("urlparse", "urlparse", "urllib.parse"), + MovedAttribute("urlsplit", "urlparse", "urllib.parse"), + MovedAttribute("urlunparse", "urlparse", "urllib.parse"), + MovedAttribute("urlunsplit", "urlparse", "urllib.parse"), + MovedAttribute("quote", "urllib", "urllib.parse"), + MovedAttribute("quote_plus", "urllib", "urllib.parse"), + MovedAttribute("unquote", "urllib", "urllib.parse"), + MovedAttribute("unquote_plus", "urllib", "urllib.parse"), + MovedAttribute("urlencode", "urllib", "urllib.parse"), + MovedAttribute("splitquery", "urllib", "urllib.parse"), + MovedAttribute("splittag", "urllib", "urllib.parse"), + MovedAttribute("splituser", "urllib", "urllib.parse"), + MovedAttribute("uses_fragment", "urlparse", "urllib.parse"), + MovedAttribute("uses_netloc", "urlparse", "urllib.parse"), + MovedAttribute("uses_params", "urlparse", "urllib.parse"), + MovedAttribute("uses_query", "urlparse", "urllib.parse"), + MovedAttribute("uses_relative", "urlparse", "urllib.parse"), +] +for attr in _urllib_parse_moved_attributes: + setattr(Module_six_moves_urllib_parse, attr.name, attr) +del attr + +Module_six_moves_urllib_parse._moved_attributes = _urllib_parse_moved_attributes + +_importer._add_module(Module_six_moves_urllib_parse(__name__ + ".moves.urllib_parse"), + "moves.urllib_parse", "moves.urllib.parse") + + +class Module_six_moves_urllib_error(_LazyModule): + + """Lazy loading of moved objects in six.moves.urllib_error""" + + +_urllib_error_moved_attributes = [ + MovedAttribute("URLError", "urllib2", "urllib.error"), + MovedAttribute("HTTPError", "urllib2", "urllib.error"), + MovedAttribute("ContentTooShortError", "urllib", "urllib.error"), +] +for attr in _urllib_error_moved_attributes: + setattr(Module_six_moves_urllib_error, attr.name, attr) +del attr + +Module_six_moves_urllib_error._moved_attributes = _urllib_error_moved_attributes + +_importer._add_module(Module_six_moves_urllib_error(__name__ + ".moves.urllib.error"), + "moves.urllib_error", "moves.urllib.error") + + +class Module_six_moves_urllib_request(_LazyModule): + + """Lazy loading of moved objects in six.moves.urllib_request""" + + +_urllib_request_moved_attributes = [ + MovedAttribute("urlopen", "urllib2", "urllib.request"), + MovedAttribute("install_opener", "urllib2", "urllib.request"), + MovedAttribute("build_opener", "urllib2", "urllib.request"), + MovedAttribute("pathname2url", "urllib", "urllib.request"), + MovedAttribute("url2pathname", "urllib", "urllib.request"), + MovedAttribute("getproxies", "urllib", "urllib.request"), + MovedAttribute("Request", "urllib2", "urllib.request"), + MovedAttribute("OpenerDirector", "urllib2", "urllib.request"), + MovedAttribute("HTTPDefaultErrorHandler", "urllib2", "urllib.request"), + MovedAttribute("HTTPRedirectHandler", "urllib2", "urllib.request"), + MovedAttribute("HTTPCookieProcessor", "urllib2", "urllib.request"), + MovedAttribute("ProxyHandler", "urllib2", "urllib.request"), + MovedAttribute("BaseHandler", "urllib2", "urllib.request"), + MovedAttribute("HTTPPasswordMgr", "urllib2", "urllib.request"), + MovedAttribute("HTTPPasswordMgrWithDefaultRealm", "urllib2", "urllib.request"), + MovedAttribute("AbstractBasicAuthHandler", "urllib2", "urllib.request"), + MovedAttribute("HTTPBasicAuthHandler", "urllib2", "urllib.request"), + MovedAttribute("ProxyBasicAuthHandler", "urllib2", "urllib.request"), + MovedAttribute("AbstractDigestAuthHandler", "urllib2", "urllib.request"), + MovedAttribute("HTTPDigestAuthHandler", "urllib2", "urllib.request"), + MovedAttribute("ProxyDigestAuthHandler", "urllib2", "urllib.request"), + MovedAttribute("HTTPHandler", "urllib2", "urllib.request"), + MovedAttribute("HTTPSHandler", "urllib2", "urllib.request"), + MovedAttribute("FileHandler", "urllib2", "urllib.request"), + MovedAttribute("FTPHandler", "urllib2", "urllib.request"), + MovedAttribute("CacheFTPHandler", "urllib2", "urllib.request"), + MovedAttribute("UnknownHandler", "urllib2", "urllib.request"), + MovedAttribute("HTTPErrorProcessor", "urllib2", "urllib.request"), + MovedAttribute("urlretrieve", "urllib", "urllib.request"), + MovedAttribute("urlcleanup", "urllib", "urllib.request"), + MovedAttribute("URLopener", "urllib", "urllib.request"), + MovedAttribute("FancyURLopener", "urllib", "urllib.request"), + MovedAttribute("proxy_bypass", "urllib", "urllib.request"), +] +for attr in _urllib_request_moved_attributes: + setattr(Module_six_moves_urllib_request, attr.name, attr) +del attr + +Module_six_moves_urllib_request._moved_attributes = _urllib_request_moved_attributes + +_importer._add_module(Module_six_moves_urllib_request(__name__ + ".moves.urllib.request"), + "moves.urllib_request", "moves.urllib.request") + + +class Module_six_moves_urllib_response(_LazyModule): + + """Lazy loading of moved objects in six.moves.urllib_response""" + + +_urllib_response_moved_attributes = [ + MovedAttribute("addbase", "urllib", "urllib.response"), + MovedAttribute("addclosehook", "urllib", "urllib.response"), + MovedAttribute("addinfo", "urllib", "urllib.response"), + MovedAttribute("addinfourl", "urllib", "urllib.response"), +] +for attr in _urllib_response_moved_attributes: + setattr(Module_six_moves_urllib_response, attr.name, attr) +del attr + +Module_six_moves_urllib_response._moved_attributes = _urllib_response_moved_attributes + +_importer._add_module(Module_six_moves_urllib_response(__name__ + ".moves.urllib.response"), + "moves.urllib_response", "moves.urllib.response") + + +class Module_six_moves_urllib_robotparser(_LazyModule): + + """Lazy loading of moved objects in six.moves.urllib_robotparser""" + + +_urllib_robotparser_moved_attributes = [ + MovedAttribute("RobotFileParser", "robotparser", "urllib.robotparser"), +] +for attr in _urllib_robotparser_moved_attributes: + setattr(Module_six_moves_urllib_robotparser, attr.name, attr) +del attr + +Module_six_moves_urllib_robotparser._moved_attributes = _urllib_robotparser_moved_attributes + +_importer._add_module(Module_six_moves_urllib_robotparser(__name__ + ".moves.urllib.robotparser"), + "moves.urllib_robotparser", "moves.urllib.robotparser") + + +class Module_six_moves_urllib(types.ModuleType): + + """Create a six.moves.urllib namespace that resembles the Python 3 namespace""" + __path__ = [] # mark as package + parse = _importer._get_module("moves.urllib_parse") + error = _importer._get_module("moves.urllib_error") + request = _importer._get_module("moves.urllib_request") + response = _importer._get_module("moves.urllib_response") + robotparser = _importer._get_module("moves.urllib_robotparser") + + def __dir__(self): + return ['parse', 'error', 'request', 'response', 'robotparser'] + +_importer._add_module(Module_six_moves_urllib(__name__ + ".moves.urllib"), + "moves.urllib") + + +def add_move(move): + """Add an item to six.moves.""" + setattr(_MovedItems, move.name, move) + + +def remove_move(name): + """Remove item from six.moves.""" + try: + delattr(_MovedItems, name) + except AttributeError: + try: + del moves.__dict__[name] + except KeyError: + raise AttributeError("no such move, %r" % (name,)) + + +if PY3: + _meth_func = "__func__" + _meth_self = "__self__" + + _func_closure = "__closure__" + _func_code = "__code__" + _func_defaults = "__defaults__" + _func_globals = "__globals__" +else: + _meth_func = "im_func" + _meth_self = "im_self" + + _func_closure = "func_closure" + _func_code = "func_code" + _func_defaults = "func_defaults" + _func_globals = "func_globals" + + +try: + advance_iterator = next +except NameError: + def advance_iterator(it): + return it.next() +next = advance_iterator + + +try: + callable = callable +except NameError: + def callable(obj): + return any("__call__" in klass.__dict__ for klass in type(obj).__mro__) + + +if PY3: + def get_unbound_function(unbound): + return unbound + + create_bound_method = types.MethodType + + def create_unbound_method(func, cls): + return func + + Iterator = object +else: + def get_unbound_function(unbound): + return unbound.im_func + + def create_bound_method(func, obj): + return types.MethodType(func, obj, obj.__class__) + + def create_unbound_method(func, cls): + return types.MethodType(func, None, cls) + + class Iterator(object): + + def next(self): + return type(self).__next__(self) + + callable = callable +_add_doc(get_unbound_function, + """Get the function out of a possibly unbound function""") + + +get_method_function = operator.attrgetter(_meth_func) +get_method_self = operator.attrgetter(_meth_self) +get_function_closure = operator.attrgetter(_func_closure) +get_function_code = operator.attrgetter(_func_code) +get_function_defaults = operator.attrgetter(_func_defaults) +get_function_globals = operator.attrgetter(_func_globals) + + +if PY3: + def iterkeys(d, **kw): + return iter(d.keys(**kw)) + + def itervalues(d, **kw): + return iter(d.values(**kw)) + + def iteritems(d, **kw): + return iter(d.items(**kw)) + + def iterlists(d, **kw): + return iter(d.lists(**kw)) + + viewkeys = operator.methodcaller("keys") + + viewvalues = operator.methodcaller("values") + + viewitems = operator.methodcaller("items") +else: + def iterkeys(d, **kw): + return d.iterkeys(**kw) + + def itervalues(d, **kw): + return d.itervalues(**kw) + + def iteritems(d, **kw): + return d.iteritems(**kw) + + def iterlists(d, **kw): + return d.iterlists(**kw) + + viewkeys = operator.methodcaller("viewkeys") + + viewvalues = operator.methodcaller("viewvalues") + + viewitems = operator.methodcaller("viewitems") + +_add_doc(iterkeys, "Return an iterator over the keys of a dictionary.") +_add_doc(itervalues, "Return an iterator over the values of a dictionary.") +_add_doc(iteritems, + "Return an iterator over the (key, value) pairs of a dictionary.") +_add_doc(iterlists, + "Return an iterator over the (key, [values]) pairs of a dictionary.") + + +if PY3: + def b(s): + return s.encode("latin-1") + + def u(s): + return s + unichr = chr + import struct + int2byte = struct.Struct(">B").pack + del struct + byte2int = operator.itemgetter(0) + indexbytes = operator.getitem + iterbytes = iter + import io + StringIO = io.StringIO + BytesIO = io.BytesIO + _assertCountEqual = "assertCountEqual" + if sys.version_info[1] <= 1: + _assertRaisesRegex = "assertRaisesRegexp" + _assertRegex = "assertRegexpMatches" + else: + _assertRaisesRegex = "assertRaisesRegex" + _assertRegex = "assertRegex" +else: + def b(s): + return s + # Workaround for standalone backslash + + def u(s): + return unicode(s.replace(r'\\', r'\\\\'), "unicode_escape") + unichr = unichr + int2byte = chr + + def byte2int(bs): + return ord(bs[0]) + + def indexbytes(buf, i): + return ord(buf[i]) + iterbytes = functools.partial(itertools.imap, ord) + import StringIO + StringIO = BytesIO = StringIO.StringIO + _assertCountEqual = "assertItemsEqual" + _assertRaisesRegex = "assertRaisesRegexp" + _assertRegex = "assertRegexpMatches" +_add_doc(b, """Byte literal""") +_add_doc(u, """Text literal""") + + +def assertCountEqual(self, *args, **kwargs): + return getattr(self, _assertCountEqual)(*args, **kwargs) + + +def assertRaisesRegex(self, *args, **kwargs): + return getattr(self, _assertRaisesRegex)(*args, **kwargs) + + +def assertRegex(self, *args, **kwargs): + return getattr(self, _assertRegex)(*args, **kwargs) + + +if PY3: + exec_ = getattr(moves.builtins, "exec") + + def reraise(tp, value, tb=None): + if value is None: + value = tp() + if value.__traceback__ is not tb: + raise value.with_traceback(tb) + raise value + +else: + def exec_(_code_, _globs_=None, _locs_=None): + """Execute code in a namespace.""" + if _globs_ is None: + frame = sys._getframe(1) + _globs_ = frame.f_globals + if _locs_ is None: + _locs_ = frame.f_locals + del frame + elif _locs_ is None: + _locs_ = _globs_ + exec("""exec _code_ in _globs_, _locs_""") + + exec_("""def reraise(tp, value, tb=None): + raise tp, value, tb +""") + + +if sys.version_info[:2] == (3, 2): + exec_("""def raise_from(value, from_value): + if from_value is None: + raise value + raise value from from_value +""") +elif sys.version_info[:2] > (3, 2): + exec_("""def raise_from(value, from_value): + raise value from from_value +""") +else: + def raise_from(value, from_value): + raise value + + +print_ = getattr(moves.builtins, "print", None) +if print_ is None: + def print_(*args, **kwargs): + """The new-style print function for Python 2.4 and 2.5.""" + fp = kwargs.pop("file", sys.stdout) + if fp is None: + return + + def write(data): + if not isinstance(data, basestring): + data = str(data) + # If the file has an encoding, encode unicode with it. + if (isinstance(fp, file) and + isinstance(data, unicode) and + fp.encoding is not None): + errors = getattr(fp, "errors", None) + if errors is None: + errors = "strict" + data = data.encode(fp.encoding, errors) + fp.write(data) + want_unicode = False + sep = kwargs.pop("sep", None) + if sep is not None: + if isinstance(sep, unicode): + want_unicode = True + elif not isinstance(sep, str): + raise TypeError("sep must be None or a string") + end = kwargs.pop("end", None) + if end is not None: + if isinstance(end, unicode): + want_unicode = True + elif not isinstance(end, str): + raise TypeError("end must be None or a string") + if kwargs: + raise TypeError("invalid keyword arguments to print()") + if not want_unicode: + for arg in args: + if isinstance(arg, unicode): + want_unicode = True + break + if want_unicode: + newline = unicode("\n") + space = unicode(" ") + else: + newline = "\n" + space = " " + if sep is None: + sep = space + if end is None: + end = newline + for i, arg in enumerate(args): + if i: + write(sep) + write(arg) + write(end) +if sys.version_info[:2] < (3, 3): + _print = print_ + + def print_(*args, **kwargs): + fp = kwargs.get("file", sys.stdout) + flush = kwargs.pop("flush", False) + _print(*args, **kwargs) + if flush and fp is not None: + fp.flush() + +_add_doc(reraise, """Reraise an exception.""") + +if sys.version_info[0:2] < (3, 4): + def wraps(wrapped, assigned=functools.WRAPPER_ASSIGNMENTS, + updated=functools.WRAPPER_UPDATES): + def wrapper(f): + f = functools.wraps(wrapped, assigned, updated)(f) + f.__wrapped__ = wrapped + return f + return wrapper +else: + wraps = functools.wraps + + +def with_metaclass(meta, *bases): + """Create a base class with a metaclass.""" + # This requires a bit of explanation: the basic idea is to make a dummy + # metaclass for one level of class instantiation that replaces itself with + # the actual metaclass. + class metaclass(meta): + + def __new__(cls, name, this_bases, d): + return meta(name, bases, d) + return type.__new__(metaclass, 'temporary_class', (), {}) + + +def add_metaclass(metaclass): + """Class decorator for creating a class with a metaclass.""" + def wrapper(cls): + orig_vars = cls.__dict__.copy() + slots = orig_vars.get('__slots__') + if slots is not None: + if isinstance(slots, str): + slots = [slots] + for slots_var in slots: + orig_vars.pop(slots_var) + orig_vars.pop('__dict__', None) + orig_vars.pop('__weakref__', None) + return metaclass(cls.__name__, cls.__bases__, orig_vars) + return wrapper + + +def python_2_unicode_compatible(klass): + """ + A decorator that defines __unicode__ and __str__ methods under Python 2. + Under Python 3 it does nothing. + + To support Python 2 and 3 with a single code base, define a __str__ method + returning text and apply this decorator to the class. + """ + if PY2: + if '__str__' not in klass.__dict__: + raise ValueError("@python_2_unicode_compatible cannot be applied " + "to %s because it doesn't define __str__()." % + klass.__name__) + klass.__unicode__ = klass.__str__ + klass.__str__ = lambda self: self.__unicode__().encode('utf-8') + return klass + + +# Complete the moves implementation. +# This code is at the end of this module to speed up module loading. +# Turn this module into a package. +__path__ = [] # required for PEP 302 and PEP 451 +__package__ = __name__ # see PEP 366 @ReservedAssignment +if globals().get("__spec__") is not None: + __spec__.submodule_search_locations = [] # PEP 451 @UndefinedVariable +# Remove other six meta path importers, since they cause problems. This can +# happen if six is removed from sys.modules and then reloaded. (Setuptools does +# this for some reason.) +if sys.meta_path: + for i, importer in enumerate(sys.meta_path): + # Here's some real nastiness: Another "instance" of the six module might + # be floating around. Therefore, we can't use isinstance() to check for + # the six meta path importer, since the other six instance will have + # inserted an importer with different class. + if (type(importer).__name__ == "_SixMetaPathImporter" and + importer.name == __name__): + del sys.meta_path[i] + break + del i, importer +# Finally, add the importer to the meta path import hook. +sys.meta_path.append(_importer) diff --git a/venv/lib/python3.8/site-packages/pkg_resources/extern/__init__.py b/venv/lib/python3.8/site-packages/pkg_resources/extern/__init__.py new file mode 100644 index 000000000..c1eb9e998 --- /dev/null +++ b/venv/lib/python3.8/site-packages/pkg_resources/extern/__init__.py @@ -0,0 +1,73 @@ +import sys + + +class VendorImporter: + """ + A PEP 302 meta path importer for finding optionally-vendored + or otherwise naturally-installed packages from root_name. + """ + + def __init__(self, root_name, vendored_names=(), vendor_pkg=None): + self.root_name = root_name + self.vendored_names = set(vendored_names) + self.vendor_pkg = vendor_pkg or root_name.replace('extern', '_vendor') + + @property + def search_path(self): + """ + Search first the vendor package then as a natural package. + """ + yield self.vendor_pkg + '.' + yield '' + + def find_module(self, fullname, path=None): + """ + Return self when fullname starts with root_name and the + target module is one vendored through this importer. + """ + root, base, target = fullname.partition(self.root_name + '.') + if root: + return + if not any(map(target.startswith, self.vendored_names)): + return + return self + + def load_module(self, fullname): + """ + Iterate over the search path to locate and load fullname. + """ + root, base, target = fullname.partition(self.root_name + '.') + for prefix in self.search_path: + try: + extant = prefix + target + __import__(extant) + mod = sys.modules[extant] + sys.modules[fullname] = mod + # mysterious hack: + # Remove the reference to the extant package/module + # on later Python versions to cause relative imports + # in the vendor package to resolve the same modules + # as those going through this importer. + if prefix and sys.version_info > (3, 3): + del sys.modules[extant] + return mod + except ImportError: + pass + else: + raise ImportError( + "The '{target}' package is required; " + "normally this is bundled with this package so if you get " + "this warning, consult the packager of your " + "distribution.".format(**locals()) + ) + + def install(self): + """ + Install this importer into sys.meta_path if not already present. + """ + if self not in sys.meta_path: + sys.meta_path.append(self) + + +names = 'packaging', 'pyparsing', 'six', 'appdirs' +VendorImporter(__name__, names).install() diff --git a/venv/lib/python3.8/site-packages/pkg_resources/py31compat.py b/venv/lib/python3.8/site-packages/pkg_resources/py31compat.py new file mode 100644 index 000000000..a381c424f --- /dev/null +++ b/venv/lib/python3.8/site-packages/pkg_resources/py31compat.py @@ -0,0 +1,23 @@ +import os +import errno +import sys + +from .extern import six + + +def _makedirs_31(path, exist_ok=False): + try: + os.makedirs(path) + except OSError as exc: + if not exist_ok or exc.errno != errno.EEXIST: + raise + + +# rely on compatibility behavior until mode considerations +# and exists_ok considerations are disentangled. +# See https://github.com/pypa/setuptools/pull/1083#issuecomment-315168663 +needs_makedirs = ( + six.PY2 or + (3, 4) <= sys.version_info < (3, 4, 1) +) +makedirs = _makedirs_31 if needs_makedirs else os.makedirs diff --git a/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/AUTHORS.txt b/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/AUTHORS.txt new file mode 100644 index 000000000..72c87d7d3 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/AUTHORS.txt @@ -0,0 +1,562 @@ +A_Rog +Aakanksha Agrawal <11389424+rasponic@users.noreply.github.com> +Abhinav Sagar <40603139+abhinavsagar@users.noreply.github.com> +ABHYUDAY PRATAP SINGH +abs51295 +AceGentile +Adam Chainz +Adam Tse +Adam Tse +Adam Wentz +admin +Adrien Morison +ahayrapetyan +Ahilya +AinsworthK +Akash Srivastava +Alan Yee +Albert Tugushev +Albert-Guan +albertg +Aleks Bunin +Alethea Flowers +Alex Gaynor +Alex Grönholm +Alex Loosley +Alex Morega +Alex Stachowiak +Alexander Shtyrov +Alexandre Conrad +Alexey Popravka +Alexey Popravka +Alli +Ami Fischman +Ananya Maiti +Anatoly Techtonik +Anders Kaseorg +Andreas Lutro +Andrei Geacar +Andrew Gaul +Andrey Bulgakov +Andrés Delfino <34587441+andresdelfino@users.noreply.github.com> +Andrés Delfino +Andy Freeland +Andy Freeland +Andy Kluger +Ani Hayrapetyan +Aniruddha Basak +Anish Tambe +Anrs Hu +Anthony Sottile +Antoine Musso +Anton Ovchinnikov +Anton Patrushev +Antonio Alvarado Hernandez +Antony Lee +Antti Kaihola +Anubhav Patel +Anuj Godase +AQNOUCH Mohammed +AraHaan +Arindam Choudhury +Armin Ronacher +Artem +Ashley Manton +Ashwin Ramaswami +atse +Atsushi Odagiri +Avner Cohen +Baptiste Mispelon +Barney Gale +barneygale +Bartek Ogryczak +Bastian Venthur +Ben Darnell +Ben Hoyt +Ben Rosser +Bence Nagy +Benjamin Peterson +Benjamin VanEvery +Benoit Pierre +Berker Peksag +Bernardo B. Marques +Bernhard M. Wiedemann +Bertil Hatt +Bogdan Opanchuk +BorisZZZ +Brad Erickson +Bradley Ayers +Brandon L. Reiss +Brandt Bucher +Brett Randall +Brian Cristante <33549821+brcrista@users.noreply.github.com> +Brian Cristante +Brian Rosner +BrownTruck +Bruno Oliveira +Bruno Renié +Bstrdsmkr +Buck Golemon +burrows +Bussonnier Matthias +c22 +Caleb Martinez +Calvin Smith +Carl Meyer +Carlos Liam +Carol Willing +Carter Thayer +Cass +Chandrasekhar Atina +Chih-Hsuan Yen +Chih-Hsuan Yen +Chris Brinker +Chris Hunt +Chris Jerdonek +Chris McDonough +Chris Wolfe +Christian Heimes +Christian Oudard +Christopher Hunt +Christopher Snyder +Clark Boylan +Clay McClure +Cody +Cody Soyland +Colin Watson +Connor Osborn +Cooper Lees +Cooper Ry Lees +Cory Benfield +Cory Wright +Craig Kerstiens +Cristian Sorinel +Curtis Doty +cytolentino +Damian Quiroga +Dan Black +Dan Savilonis +Dan Sully +daniel +Daniel Collins +Daniel Hahler +Daniel Holth +Daniel Jost +Daniel Shaulov +Daniele Esposti +Daniele Procida +Danny Hermes +Dav Clark +Dave Abrahams +Dave Jones +David Aguilar +David Black +David Bordeynik +David Bordeynik +David Caro +David Evans +David Linke +David Pursehouse +David Tucker +David Wales +Davidovich +derwolfe +Desetude +Diego Caraballo +DiegoCaraballo +Dmitry Gladkov +Domen Kožar +Donald Stufft +Dongweiming +Douglas Thor +DrFeathers +Dustin Ingram +Dwayne Bailey +Ed Morley <501702+edmorley@users.noreply.github.com> +Ed Morley +Eitan Adler +ekristina +elainechan +Eli Schwartz +Eli Schwartz +Emil Burzo +Emil Styrke +Endoh Takanao +enoch +Erdinc Mutlu +Eric Gillingham +Eric Hanchrow +Eric Hopper +Erik M. Bray +Erik Rose +Ernest W Durbin III +Ernest W. Durbin III +Erwin Janssen +Eugene Vereshchagin +everdimension +Felix Yan +fiber-space +Filip Kokosiński +Florian Briand +Florian Rathgeber +Francesco +Francesco Montesano +Frost Ming +Gabriel Curio +Gabriel de Perthuis +Garry Polley +gdanielson +Geoffrey Lehée +Geoffrey Sneddon +George Song +Georgi Valkov +Giftlin Rajaiah +gizmoguy1 +gkdoc <40815324+gkdoc@users.noreply.github.com> +Gopinath M <31352222+mgopi1990@users.noreply.github.com> +GOTO Hayato <3532528+gh640@users.noreply.github.com> +gpiks +Guilherme Espada +Guy Rozendorn +gzpan123 +Hanjun Kim +Hari Charan +Harsh Vardhan +Herbert Pfennig +Hsiaoming Yang +Hugo +Hugo Lopes Tavares +Hugo van Kemenade +hugovk +Hynek Schlawack +Ian Bicking +Ian Cordasco +Ian Lee +Ian Stapleton Cordasco +Ian Wienand +Ian Wienand +Igor Kuzmitshov +Igor Sobreira +Ilya Baryshev +INADA Naoki +Ionel Cristian Mărieș +Ionel Maries Cristian +Ivan Pozdeev +Jacob Kim +jakirkham +Jakub Stasiak +Jakub Vysoky +Jakub Wilk +James Cleveland +James Cleveland +James Firth +James Polley +Jan Pokorný +Jannis Leidel +jarondl +Jason R. Coombs +Jay Graves +Jean-Christophe Fillion-Robin +Jeff Barber +Jeff Dairiki +Jelmer Vernooij +jenix21 +Jeremy Stanley +Jeremy Zafran +Jiashuo Li +Jim Garrison +Jivan Amara +John Paton +John-Scott Atlakson +johnthagen +johnthagen +Jon Banafato +Jon Dufresne +Jon Parise +Jonas Nockert +Jonathan Herbert +Joost Molenaar +Jorge Niedbalski +Joseph Long +Josh Bronson +Josh Hansen +Josh Schneier +Juanjo Bazán +Julian Berman +Julian Gethmann +Julien Demoor +jwg4 +Jyrki Pulliainen +Kai Chen +Kamal Bin Mustafa +kaustav haldar +keanemind +Keith Maxwell +Kelsey Hightower +Kenneth Belitzky +Kenneth Reitz +Kenneth Reitz +Kevin Burke +Kevin Carter +Kevin Frommelt +Kevin R Patterson +Kexuan Sun +Kit Randel +kpinc +Krishna Oza +Kumar McMillan +Kyle Persohn +lakshmanaram +Laszlo Kiss-Kollar +Laurent Bristiel +Laurie Opperman +Leon Sasson +Lev Givon +Lincoln de Sousa +Lipis +Loren Carvalho +Lucas Cimon +Ludovic Gasc +Luke Macken +Luo Jiebin +luojiebin +luz.paz +László Kiss Kollár +László Kiss Kollár +Marc Abramowitz +Marc Tamlyn +Marcus Smith +Mariatta +Mark Kohler +Mark Williams +Mark Williams +Markus Hametner +Masaki +Masklinn +Matej Stuchlik +Mathew Jennings +Mathieu Bridon +Matt Good +Matt Maker +Matt Robenolt +matthew +Matthew Einhorn +Matthew Gilliard +Matthew Iversen +Matthew Trumbell +Matthew Willson +Matthias Bussonnier +mattip +Maxim Kurnikov +Maxime Rouyrre +mayeut +mbaluna <44498973+mbaluna@users.noreply.github.com> +mdebi <17590103+mdebi@users.noreply.github.com> +memoselyk +Michael +Michael Aquilina +Michael E. Karpeles +Michael Klich +Michael Williamson +michaelpacer +Mickaël Schoentgen +Miguel Araujo Perez +Mihir Singh +Mike +Mike Hendricks +Min RK +MinRK +Miro Hrončok +Monica Baluna +montefra +Monty Taylor +Nate Coraor +Nathaniel J. Smith +Nehal J Wani +Neil Botelho +Nick Coghlan +Nick Stenning +Nick Timkovich +Nicolas Bock +Nikhil Benesch +Nitesh Sharma +Nowell Strite +NtaleGrey +nvdv +Ofekmeister +ofrinevo +Oliver Jeeves +Oliver Tonnhofer +Olivier Girardot +Olivier Grisel +Ollie Rutherfurd +OMOTO Kenji +Omry Yadan +Oren Held +Oscar Benjamin +Oz N Tiram +Pachwenko <32424503+Pachwenko@users.noreply.github.com> +Patrick Dubroy +Patrick Jenkins +Patrick Lawson +patricktokeeffe +Patrik Kopkan +Paul Kehrer +Paul Moore +Paul Nasrat +Paul Oswald +Paul van der Linden +Paulus Schoutsen +Pavithra Eswaramoorthy <33131404+QueenCoffee@users.noreply.github.com> +Pawel Jasinski +Pekka Klärck +Peter Lisák +Peter Waller +petr-tik +Phaneendra Chiruvella +Phil Freo +Phil Pennock +Phil Whelan +Philip Jägenstedt +Philip Molloy +Philippe Ombredanne +Pi Delport +Pierre-Yves Rofes +pip +Prabakaran Kumaresshan +Prabhjyotsing Surjit Singh Sodhi +Prabhu Marappan +Pradyun Gedam +Pratik Mallya +Preet Thakkar +Preston Holmes +Przemek Wrzos +Pulkit Goyal <7895pulkit@gmail.com> +Qiangning Hong +Quentin Pradet +R. David Murray +Rafael Caricio +Ralf Schmitt +Razzi Abuissa +rdb +Remi Rampin +Remi Rampin +Rene Dudfield +Riccardo Magliocchetti +Richard Jones +RobberPhex +Robert Collins +Robert McGibbon +Robert T. McGibbon +robin elisha robinson +Roey Berman +Rohan Jain +Rohan Jain +Rohan Jain +Roman Bogorodskiy +Romuald Brunet +Ronny Pfannschmidt +Rory McCann +Ross Brattain +Roy Wellington Ⅳ +Roy Wellington Ⅳ +Ryan Wooden +ryneeverett +Sachi King +Salvatore Rinchiera +Savio Jomton +schlamar +Scott Kitterman +Sean +seanj +Sebastian Jordan +Sebastian Schaetz +Segev Finer +SeongSoo Cho +Sergey Vasilyev +Seth Woodworth +Shlomi Fish +Shovan Maity +Simeon Visser +Simon Cross +Simon Pichugin +sinoroc +Sorin Sbarnea +Stavros Korokithakis +Stefan Scherfke +Stephan Erb +stepshal +Steve (Gadget) Barnes +Steve Barnes +Steve Dower +Steve Kowalik +Steven Myint +stonebig +Stéphane Bidoul (ACSONE) +Stéphane Bidoul +Stéphane Klein +Sumana Harihareswara +Sviatoslav Sydorenko +Sviatoslav Sydorenko +Swat009 +Takayuki SHIMIZUKAWA +tbeswick +Thijs Triemstra +Thomas Fenzl +Thomas Grainger +Thomas Guettler +Thomas Johansson +Thomas Kluyver +Thomas Smith +Tim D. Smith +Tim Gates +Tim Harder +Tim Heap +tim smith +tinruufu +Tom Forbes +Tom Freudenheim +Tom V +Tomas Orsava +Tomer Chachamu +Tony Beswick +Tony Zhaocheng Tan +TonyBeswick +toonarmycaptain +Toshio Kuratomi +Travis Swicegood +Tzu-ping Chung +Valentin Haenel +Victor Stinner +victorvpaulo +Viktor Szépe +Ville Skyttä +Vinay Sajip +Vincent Philippon +Vinicyus Macedo <7549205+vinicyusmacedo@users.noreply.github.com> +Vitaly Babiy +Vladimir Rutsky +W. Trevor King +Wil Tan +Wilfred Hughes +William ML Leslie +William T Olson +Wilson Mo +wim glenn +Wolfgang Maier +Xavier Fernandez +Xavier Fernandez +xoviat +xtreak +YAMAMOTO Takashi +Yen Chi Hsuan +Yeray Diaz Diaz +Yoval P +Yu Jian +Yuan Jing Vincent Yan +Zearin +Zearin +Zhiping Deng +Zvezdan Petkovic +Łukasz Langa +Семён Марьясин diff --git a/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/INSTALLER b/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/INSTALLER new file mode 100644 index 000000000..a1b589e38 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/LICENSE.txt b/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/LICENSE.txt new file mode 100644 index 000000000..737fec5c5 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/LICENSE.txt @@ -0,0 +1,20 @@ +Copyright (c) 2008-2019 The pip developers (see AUTHORS.txt file) + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +"Software"), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be +included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND +NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE +LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION +OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION +WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/METADATA b/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/METADATA new file mode 100644 index 000000000..4adf95308 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/METADATA @@ -0,0 +1,82 @@ +Metadata-Version: 2.1 +Name: setuptools +Version: 44.0.0 +Summary: Easily download, build, install, upgrade, and uninstall Python packages +Home-page: https://github.com/pypa/setuptools +Author: Python Packaging Authority +Author-email: distutils-sig@python.org +License: UNKNOWN +Project-URL: Documentation, https://setuptools.readthedocs.io/ +Keywords: CPAN PyPI distutils eggs package management +Platform: UNKNOWN +Classifier: Development Status :: 5 - Production/Stable +Classifier: Intended Audience :: Developers +Classifier: License :: OSI Approved :: MIT License +Classifier: Operating System :: OS Independent +Classifier: Programming Language :: Python :: 2 +Classifier: Programming Language :: Python :: 2.7 +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3.5 +Classifier: Programming Language :: Python :: 3.6 +Classifier: Programming Language :: Python :: 3.7 +Classifier: Programming Language :: Python :: 3.8 +Classifier: Topic :: Software Development :: Libraries :: Python Modules +Classifier: Topic :: System :: Archiving :: Packaging +Classifier: Topic :: System :: Systems Administration +Classifier: Topic :: Utilities +Requires-Python: !=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,>=2.7 +Description-Content-Type: text/x-rst; charset=UTF-8 + +.. image:: https://img.shields.io/pypi/v/setuptools.svg + :target: https://pypi.org/project/setuptools + +.. image:: https://img.shields.io/readthedocs/setuptools/latest.svg + :target: https://setuptools.readthedocs.io + +.. image:: https://img.shields.io/travis/pypa/setuptools/master.svg?label=Linux%20CI&logo=travis&logoColor=white + :target: https://travis-ci.org/pypa/setuptools + +.. image:: https://img.shields.io/appveyor/ci/pypa/setuptools/master.svg?label=Windows%20CI&logo=appveyor&logoColor=white + :target: https://ci.appveyor.com/project/pypa/setuptools/branch/master + +.. image:: https://img.shields.io/codecov/c/github/pypa/setuptools/master.svg?logo=codecov&logoColor=white + :target: https://codecov.io/gh/pypa/setuptools + +.. image:: https://tidelift.com/badges/github/pypa/setuptools?style=flat + :target: https://tidelift.com/subscription/pkg/pypi-setuptools?utm_source=pypi-setuptools&utm_medium=readme + +.. image:: https://img.shields.io/pypi/pyversions/setuptools.svg + +See the `Installation Instructions +`_ in the Python Packaging +User's Guide for instructions on installing, upgrading, and uninstalling +Setuptools. + +Questions and comments should be directed to the `distutils-sig +mailing list `_. +Bug reports and especially tested patches may be +submitted directly to the `bug tracker +`_. + +To report a security vulnerability, please use the +`Tidelift security contact `_. +Tidelift will coordinate the fix and disclosure. + + +For Enterprise +============== + +Available as part of the Tidelift Subscription. + +Setuptools and the maintainers of thousands of other packages are working with Tidelift to deliver one enterprise subscription that covers all of the open source you use. + +`Learn more `_. + +Code of Conduct +=============== + +Everyone interacting in the setuptools project's codebases, issue trackers, +chat rooms, and mailing lists is expected to follow the +`PyPA Code of Conduct `_. + + diff --git a/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/RECORD b/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/RECORD new file mode 100644 index 000000000..7297f5acb --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/RECORD @@ -0,0 +1,171 @@ +easy_install.py,sha256=MDC9vt5AxDsXX5qcKlBz2TnW6Tpuv_AobnfhCJ9X3PM,126 +setuptools/__init__.py,sha256=WBpCcn2lvdckotabeae1TTYonPOcgCIF3raD2zRWzBc,7283 +setuptools/_deprecation_warning.py,sha256=jU9-dtfv6cKmtQJOXN8nP1mm7gONw5kKEtiPtbwnZyI,218 +setuptools/_imp.py,sha256=jloslOkxrTKbobgemfP94YII0nhqiJzE1bRmCTZ1a5I,2223 +setuptools/archive_util.py,sha256=kw8Ib_lKjCcnPKNbS7h8HztRVK0d5RacU3r_KRdVnmM,6592 +setuptools/build_meta.py,sha256=-9Nmj9YdbW4zX3TssPJZhsENrTa4fw3k86Jm1cdKMik,9597 +setuptools/cli-32.exe,sha256=dfEuovMNnA2HLa3jRfMPVi5tk4R7alCbpTvuxtCyw0Y,65536 +setuptools/cli-64.exe,sha256=KLABu5pyrnokJCv6skjXZ6GsXeyYHGcqOUT3oHI3Xpo,74752 +setuptools/cli.exe,sha256=dfEuovMNnA2HLa3jRfMPVi5tk4R7alCbpTvuxtCyw0Y,65536 +setuptools/config.py,sha256=6SB2OY3qcooOJmG_rsK_s0pKBsorBlDpfMJUyzjQIGk,20575 +setuptools/dep_util.py,sha256=fgixvC1R7sH3r13ktyf7N0FALoqEXL1cBarmNpSEoWg,935 +setuptools/depends.py,sha256=qt2RWllArRvhnm8lxsyRpcthEZYp4GHQgREl1q0LkFw,5517 +setuptools/dist.py,sha256=xtXaNsOsE32MwwQqErzgXJF7jsTQz9GYFRrwnPFQ0J0,49865 +setuptools/errors.py,sha256=MVOcv381HNSajDgEUWzOQ4J6B5BHCBMSjHfaWcEwA1o,524 +setuptools/extension.py,sha256=uc6nHI-MxwmNCNPbUiBnybSyqhpJqjbhvOQ-emdvt_E,1729 +setuptools/glob.py,sha256=o75cHrOxYsvn854thSxE0x9k8JrKDuhP_rRXlVB00Q4,5084 +setuptools/gui-32.exe,sha256=XBr0bHMA6Hpz2s9s9Bzjl-PwXfa9nH4ie0rFn4V2kWA,65536 +setuptools/gui-64.exe,sha256=aYKMhX1IJLn4ULHgWX0sE0yREUt6B3TEHf_jOw6yNyE,75264 +setuptools/gui.exe,sha256=XBr0bHMA6Hpz2s9s9Bzjl-PwXfa9nH4ie0rFn4V2kWA,65536 +setuptools/installer.py,sha256=TCFRonRo01I79zo-ucf3Ymhj8TenPlmhMijN916aaJs,5337 +setuptools/launch.py,sha256=sd7ejwhBocCDx_wG9rIs0OaZ8HtmmFU8ZC6IR_S0Lvg,787 +setuptools/lib2to3_ex.py,sha256=t5e12hbR2pi9V4ezWDTB4JM-AISUnGOkmcnYHek3xjg,2013 +setuptools/monkey.py,sha256=FGc9fffh7gAxMLFmJs2DW_OYWpBjkdbNS2n14UAK4NA,5264 +setuptools/msvc.py,sha256=8baJ6aYgCA4TRdWQQi185qB9dnU8FaP4wgpbmd7VODs,46751 +setuptools/namespaces.py,sha256=F0Nrbv8KCT2OrO7rwa03om4N4GZKAlnce-rr-cgDQa8,3199 +setuptools/package_index.py,sha256=rqhmbFUEf4WxndnKbtWmj_x8WCuZSuoCgA0K1syyCY8,40616 +setuptools/py27compat.py,sha256=tvmer0Tn-wk_JummCkoM22UIjpjL-AQ8uUiOaqTs8sI,1496 +setuptools/py31compat.py,sha256=h2rtZghOfwoGYd8sQ0-auaKiF3TcL3qX0bX3VessqcE,838 +setuptools/py33compat.py,sha256=SMF9Z8wnGicTOkU1uRNwZ_kz5Z_bj29PUBbqdqeeNsc,1330 +setuptools/py34compat.py,sha256=KYOd6ybRxjBW8NJmYD8t_UyyVmysppFXqHpFLdslGXU,245 +setuptools/sandbox.py,sha256=9UbwfEL5QY436oMI1LtFWohhoZ-UzwHvGyZjUH_qhkw,14276 +setuptools/script (dev).tmpl,sha256=RUzQzCQUaXtwdLtYHWYbIQmOaES5Brqq1FvUA_tu-5I,218 +setuptools/script.tmpl,sha256=WGTt5piezO27c-Dbx6l5Q4T3Ff20A5z7872hv3aAhYY,138 +setuptools/site-patch.py,sha256=OumkIHMuoSenRSW1382kKWI1VAwxNE86E5W8iDd34FY,2302 +setuptools/ssl_support.py,sha256=nLjPUBBw7RTTx6O4RJZ5eAMGgjJG8beiDbkFXDZpLuM,8493 +setuptools/unicode_utils.py,sha256=NOiZ_5hD72A6w-4wVj8awHFM3n51Kmw1Ic_vx15XFqw,996 +setuptools/version.py,sha256=og_cuZQb0QI6ukKZFfZWPlr1HgJBPPn2vO2m_bI9ZTE,144 +setuptools/wheel.py,sha256=zct-SEj5_LoHg6XELt2cVRdulsUENenCdS1ekM7TlZA,8455 +setuptools/windows_support.py,sha256=5GrfqSP2-dLGJoZTq2g6dCKkyQxxa2n5IQiXlJCoYEE,714 +setuptools/_vendor/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +setuptools/_vendor/ordered_set.py,sha256=dbaCcs27dyN9gnMWGF5nA_BrVn6Q-NrjKYJpV9_fgBs,15130 +setuptools/_vendor/pyparsing.py,sha256=tmrp-lu-qO1i75ZzIN5A12nKRRD1Cm4Vpk-5LR9rims,232055 +setuptools/_vendor/six.py,sha256=A6hdJZVjI3t_geebZ9BzUvwRrIXo0lfwzQlM2LcKyas,30098 +setuptools/_vendor/packaging/__about__.py,sha256=CpuMSyh1V7adw8QMjWKkY3LtdqRUkRX4MgJ6nF4stM0,744 +setuptools/_vendor/packaging/__init__.py,sha256=6enbp5XgRfjBjsI9-bn00HjHf5TH21PDMOKkJW8xw-w,562 +setuptools/_vendor/packaging/_compat.py,sha256=Ugdm-qcneSchW25JrtMIKgUxfEEBcCAz6WrEeXeqz9o,865 +setuptools/_vendor/packaging/_structures.py,sha256=pVd90XcXRGwpZRB_qdFuVEibhCHpX_bL5zYr9-N0mc8,1416 +setuptools/_vendor/packaging/markers.py,sha256=-meFl9Fr9V8rF5Rduzgett5EHK9wBYRUqssAV2pj0lw,8268 +setuptools/_vendor/packaging/requirements.py,sha256=3dwIJekt8RRGCUbgxX8reeAbgmZYjb0wcCRtmH63kxI,4742 +setuptools/_vendor/packaging/specifiers.py,sha256=0ZzQpcUnvrQ6LjR-mQRLzMr8G6hdRv-mY0VSf_amFtI,27778 +setuptools/_vendor/packaging/tags.py,sha256=EPLXhO6GTD7_oiWEO1U0l0PkfR8R_xivpMDHXnsTlts,12933 +setuptools/_vendor/packaging/utils.py,sha256=VaTC0Ei7zO2xl9ARiWmz2YFLFt89PuuhLbAlXMyAGms,1520 +setuptools/_vendor/packaging/version.py,sha256=Npdwnb8OHedj_2L86yiUqscujb7w_i5gmSK1PhOAFzg,11978 +setuptools/command/__init__.py,sha256=QCAuA9whnq8Bnoc0bBaS6Lw_KAUO0DiHYZQXEMNn5hg,568 +setuptools/command/alias.py,sha256=KjpE0sz_SDIHv3fpZcIQK-sCkJz-SrC6Gmug6b9Nkc8,2426 +setuptools/command/bdist_egg.py,sha256=nnfV8Ah8IRC_Ifv5Loa9FdxL66MVbyDXwy-foP810zM,18185 +setuptools/command/bdist_rpm.py,sha256=B7l0TnzCGb-0nLlm6rS00jWLkojASwVmdhW2w5Qz_Ak,1508 +setuptools/command/bdist_wininst.py,sha256=_6dz3lpB1tY200LxKPLM7qgwTCceOMgaWFF-jW2-pm0,637 +setuptools/command/build_clib.py,sha256=bQ9aBr-5ZSO-9fGsGsDLz0mnnFteHUZnftVLkhvHDq0,4484 +setuptools/command/build_ext.py,sha256=Ib42YUGksBswm2mL5xmQPF6NeTA6HcqrvAtEgFCv32A,13019 +setuptools/command/build_py.py,sha256=yWyYaaS9F3o9JbIczn064A5g1C5_UiKRDxGaTqYbtLE,9596 +setuptools/command/develop.py,sha256=MQlnGS6uP19erK2JCNOyQYoYyquk3PADrqrrinqqLtA,8184 +setuptools/command/dist_info.py,sha256=5t6kOfrdgALT-P3ogss6PF9k-Leyesueycuk3dUyZnI,960 +setuptools/command/easy_install.py,sha256=0lY8Agxe-7IgMtxgxFuOY1NrDlBzOUlpCKsvayXlTYY,89903 +setuptools/command/egg_info.py,sha256=0e_TXrMfpa8nGTO7GmJcmpPCMWzliZi6zt9aMchlumc,25578 +setuptools/command/install.py,sha256=8doMxeQEDoK4Eco0mO2WlXXzzp9QnsGJQ7Z7yWkZPG8,4705 +setuptools/command/install_egg_info.py,sha256=4zq_Ad3jE-EffParuyDEnvxU6efB-Xhrzdr8aB6Ln_8,3195 +setuptools/command/install_lib.py,sha256=9zdc-H5h6RPxjySRhOwi30E_WfcVva7gpfhZ5ata60w,5023 +setuptools/command/install_scripts.py,sha256=UD0rEZ6861mTYhIdzcsqKnUl8PozocXWl9VBQ1VTWnc,2439 +setuptools/command/launcher manifest.xml,sha256=xlLbjWrB01tKC0-hlVkOKkiSPbzMml2eOPtJ_ucCnbE,628 +setuptools/command/py36compat.py,sha256=SzjZcOxF7zdFUT47Zv2n7AM3H8koDys_0OpS-n9gIfc,4986 +setuptools/command/register.py,sha256=kk3DxXCb5lXTvqnhfwx2g6q7iwbUmgTyXUCaBooBOUk,468 +setuptools/command/rotate.py,sha256=co5C1EkI7P0GGT6Tqz-T2SIj2LBJTZXYELpmao6d4KQ,2164 +setuptools/command/saveopts.py,sha256=za7QCBcQimKKriWcoCcbhxPjUz30gSB74zuTL47xpP4,658 +setuptools/command/sdist.py,sha256=IL1LepD2h8qGKOFJ3rrQVbjNH_Q6ViD40l0QADr4MEU,8088 +setuptools/command/setopt.py,sha256=NTWDyx-gjDF-txf4dO577s7LOzHVoKR0Mq33rFxaRr8,5085 +setuptools/command/test.py,sha256=u2kXngIIdSYqtvwFlHiN6Iye1IB4TU6uadB2uiV1szw,9602 +setuptools/command/upload.py,sha256=XT3YFVfYPAmA5qhGg0euluU98ftxRUW-PzKcODMLxUs,462 +setuptools/command/upload_docs.py,sha256=oXiGplM_cUKLwE4CWWw98RzCufAu8tBhMC97GegFcms,7311 +setuptools/extern/__init__.py,sha256=4q9gtShB1XFP6CisltsyPqtcfTO6ZM9Lu1QBl3l-qmo,2514 +setuptools-44.0.0.dist-info/AUTHORS.txt,sha256=RtqU9KfonVGhI48DAA4-yTOBUhBtQTjFhaDzHoyh7uU,21518 +setuptools-44.0.0.dist-info/LICENSE.txt,sha256=W6Ifuwlk-TatfRU2LR7W1JMcyMj5_y1NkRkOEJvnRDE,1090 +setuptools-44.0.0.dist-info/METADATA,sha256=L93fcafgVw4xoJUNG0lehyy0prVj-jU_JFxRh0ZUtos,3523 +setuptools-44.0.0.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110 +setuptools-44.0.0.dist-info/dependency_links.txt,sha256=HlkCFkoK5TbZ5EMLbLKYhLcY_E31kBWD8TqW2EgmatQ,239 +setuptools-44.0.0.dist-info/entry_points.txt,sha256=ZmIqlp-SBdsBS2cuetmU2NdSOs4DG0kxctUR9UJ8Xk0,3150 +setuptools-44.0.0.dist-info/top_level.txt,sha256=2HUXVVwA4Pff1xgTFr3GsTXXKaPaO6vlG6oNJ_4u4Tg,38 +setuptools-44.0.0.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1 +setuptools-44.0.0.dist-info/RECORD,, +setuptools/command/install_scripts.cpython-38.pyc,, +setuptools/monkey.cpython-38.pyc,, +setuptools/lib2to3_ex.cpython-38.pyc,, +setuptools/_vendor/packaging/tags.cpython-38.pyc,, +setuptools/version.cpython-38.pyc,, +setuptools/sandbox.cpython-38.pyc,, +setuptools/installer.cpython-38.pyc,, +setuptools/command/build_ext.cpython-38.pyc,, +setuptools/wheel.cpython-38.pyc,, +setuptools/command/py36compat.cpython-38.pyc,, +setuptools/_vendor/packaging/version.cpython-38.pyc,, +easy_install.cpython-38.pyc,, +setuptools/_vendor/packaging/markers.cpython-38.pyc,, +setuptools/extern/__init__.cpython-38.pyc,, +setuptools/command/upload_docs.cpython-38.pyc,, +setuptools/command/rotate.cpython-38.pyc,, +setuptools/extension.cpython-38.pyc,, +setuptools/command/install_lib.cpython-38.pyc,, +setuptools/_vendor/packaging/specifiers.cpython-38.pyc,, +setuptools/py31compat.cpython-38.pyc,, +setuptools/msvc.cpython-38.pyc,, +setuptools/command/install_egg_info.cpython-38.pyc,, +setuptools-44.0.0.dist-info/__pycache__,, +setuptools/command/egg_info.cpython-38.pyc,, +setuptools/command/alias.cpython-38.pyc,, +../../../bin/easy_install3,, +setuptools/extern/__pycache__,, +setuptools/_vendor/ordered_set.cpython-38.pyc,, +setuptools/config.cpython-38.pyc,, +setuptools/ssl_support.cpython-38.pyc,, +setuptools/namespaces.cpython-38.pyc,, +setuptools/command/bdist_wininst.cpython-38.pyc,, +setuptools/command/bdist_rpm.cpython-38.pyc,, +../../../bin/easy_install,, +setuptools/package_index.cpython-38.pyc,, +setuptools/_vendor/__init__.cpython-38.pyc,, +setuptools/dist.cpython-38.pyc,, +setuptools/command/develop.cpython-38.pyc,, +setuptools/command/install.cpython-38.pyc,, +setuptools/_vendor/__pycache__,, +setuptools/command/saveopts.cpython-38.pyc,, +setuptools/command/bdist_egg.cpython-38.pyc,, +setuptools/unicode_utils.cpython-38.pyc,, +setuptools/command/register.cpython-38.pyc,, +setuptools/command/setopt.cpython-38.pyc,, +setuptools/site-patch.cpython-38.pyc,, +setuptools/depends.cpython-38.pyc,, +setuptools/errors.cpython-38.pyc,, +setuptools/command/easy_install.cpython-38.pyc,, +setuptools/_vendor/packaging/__about__.cpython-38.pyc,, +../../../bin/easy_install-3.8,, +setuptools/command/sdist.cpython-38.pyc,, +setuptools/py33compat.cpython-38.pyc,, +setuptools-44.0.0.dist-info/INSTALLER,, +setuptools/_vendor/packaging/_structures.cpython-38.pyc,, +setuptools/_deprecation_warning.cpython-38.pyc,, +setuptools/_vendor/packaging/requirements.cpython-38.pyc,, +setuptools/__init__.cpython-38.pyc,, +setuptools/command/upload.cpython-38.pyc,, +setuptools/glob.cpython-38.pyc,, +setuptools/command/__init__.cpython-38.pyc,, +setuptools/_vendor/packaging/_compat.cpython-38.pyc,, +setuptools/command/test.cpython-38.pyc,, +setuptools/py34compat.cpython-38.pyc,, +setuptools/windows_support.cpython-38.pyc,, +setuptools/__pycache__,, +setuptools/command/dist_info.cpython-38.pyc,, +setuptools/command/__pycache__,, +setuptools/launch.cpython-38.pyc,, +setuptools/_vendor/packaging/__init__.cpython-38.pyc,, +setuptools/_imp.cpython-38.pyc,, +setuptools/command/build_py.cpython-38.pyc,, +setuptools/_vendor/packaging/utils.cpython-38.pyc,, +setuptools/command/build_clib.cpython-38.pyc,, +setuptools/dep_util.cpython-38.pyc,, +setuptools/py27compat.cpython-38.pyc,, +setuptools/_vendor/six.cpython-38.pyc,, +setuptools/build_meta.cpython-38.pyc,, +setuptools/_vendor/packaging/__pycache__,, +setuptools-44.0.0.virtualenv,, +setuptools/archive_util.cpython-38.pyc,, +setuptools/_vendor/pyparsing.cpython-38.pyc,, \ No newline at end of file diff --git a/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/WHEEL b/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/WHEEL new file mode 100644 index 000000000..ef99c6cf3 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/WHEEL @@ -0,0 +1,6 @@ +Wheel-Version: 1.0 +Generator: bdist_wheel (0.34.2) +Root-Is-Purelib: true +Tag: py2-none-any +Tag: py3-none-any + diff --git a/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/dependency_links.txt b/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/dependency_links.txt new file mode 100644 index 000000000..e87d02103 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/dependency_links.txt @@ -0,0 +1,2 @@ +https://files.pythonhosted.org/packages/source/c/certifi/certifi-2016.9.26.tar.gz#md5=baa81e951a29958563689d868ef1064d +https://files.pythonhosted.org/packages/source/w/wincertstore/wincertstore-0.2.zip#md5=ae728f2f007185648d0c7a8679b361e2 diff --git a/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/entry_points.txt b/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/entry_points.txt new file mode 100644 index 000000000..0fed3f1d8 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/entry_points.txt @@ -0,0 +1,68 @@ +[console_scripts] +easy_install = setuptools.command.easy_install:main + +[distutils.commands] +alias = setuptools.command.alias:alias +bdist_egg = setuptools.command.bdist_egg:bdist_egg +bdist_rpm = setuptools.command.bdist_rpm:bdist_rpm +bdist_wininst = setuptools.command.bdist_wininst:bdist_wininst +build_clib = setuptools.command.build_clib:build_clib +build_ext = setuptools.command.build_ext:build_ext +build_py = setuptools.command.build_py:build_py +develop = setuptools.command.develop:develop +dist_info = setuptools.command.dist_info:dist_info +easy_install = setuptools.command.easy_install:easy_install +egg_info = setuptools.command.egg_info:egg_info +install = setuptools.command.install:install +install_egg_info = setuptools.command.install_egg_info:install_egg_info +install_lib = setuptools.command.install_lib:install_lib +install_scripts = setuptools.command.install_scripts:install_scripts +rotate = setuptools.command.rotate:rotate +saveopts = setuptools.command.saveopts:saveopts +sdist = setuptools.command.sdist:sdist +setopt = setuptools.command.setopt:setopt +test = setuptools.command.test:test +upload_docs = setuptools.command.upload_docs:upload_docs + +[distutils.setup_keywords] +convert_2to3_doctests = setuptools.dist:assert_string_list +dependency_links = setuptools.dist:assert_string_list +eager_resources = setuptools.dist:assert_string_list +entry_points = setuptools.dist:check_entry_points +exclude_package_data = setuptools.dist:check_package_data +extras_require = setuptools.dist:check_extras +include_package_data = setuptools.dist:assert_bool +install_requires = setuptools.dist:check_requirements +namespace_packages = setuptools.dist:check_nsp +package_data = setuptools.dist:check_package_data +packages = setuptools.dist:check_packages +python_requires = setuptools.dist:check_specifier +setup_requires = setuptools.dist:check_requirements +test_loader = setuptools.dist:check_importable +test_runner = setuptools.dist:check_importable +test_suite = setuptools.dist:check_test_suite +tests_require = setuptools.dist:check_requirements +use_2to3 = setuptools.dist:assert_bool +use_2to3_exclude_fixers = setuptools.dist:assert_string_list +use_2to3_fixers = setuptools.dist:assert_string_list +zip_safe = setuptools.dist:assert_bool + +[egg_info.writers] +PKG-INFO = setuptools.command.egg_info:write_pkg_info +dependency_links.txt = setuptools.command.egg_info:overwrite_arg +depends.txt = setuptools.command.egg_info:warn_depends_obsolete +eager_resources.txt = setuptools.command.egg_info:overwrite_arg +entry_points.txt = setuptools.command.egg_info:write_entries +namespace_packages.txt = setuptools.command.egg_info:overwrite_arg +requires.txt = setuptools.command.egg_info:write_requirements +top_level.txt = setuptools.command.egg_info:write_toplevel_names + +[setuptools.finalize_distribution_options] +2to3_doctests = setuptools.dist:Distribution._finalize_2to3_doctests +features = setuptools.dist:Distribution._finalize_feature_opts +keywords = setuptools.dist:Distribution._finalize_setup_keywords +parent_finalize = setuptools.dist:_Distribution.finalize_options + +[setuptools.installation] +eggsecutable = setuptools.command.easy_install:bootstrap + diff --git a/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/top_level.txt b/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/top_level.txt new file mode 100644 index 000000000..4577c6a79 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/top_level.txt @@ -0,0 +1,3 @@ +easy_install +pkg_resources +setuptools diff --git a/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/zip-safe b/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/zip-safe new file mode 100644 index 000000000..8b1378917 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/zip-safe @@ -0,0 +1 @@ + diff --git a/venv/lib/python3.8/site-packages/setuptools-44.0.0.virtualenv b/venv/lib/python3.8/site-packages/setuptools-44.0.0.virtualenv new file mode 100644 index 000000000..e69de29bb diff --git a/venv/lib/python3.8/site-packages/setuptools/__init__.py b/venv/lib/python3.8/site-packages/setuptools/__init__.py new file mode 100644 index 000000000..a71b2bbdc --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/__init__.py @@ -0,0 +1,228 @@ +"""Extensions to the 'distutils' for large or complex distributions""" + +import os +import sys +import functools +import distutils.core +import distutils.filelist +import re +from distutils.errors import DistutilsOptionError +from distutils.util import convert_path +from fnmatch import fnmatchcase + +from ._deprecation_warning import SetuptoolsDeprecationWarning + +from setuptools.extern.six import PY3, string_types +from setuptools.extern.six.moves import filter, map + +import setuptools.version +from setuptools.extension import Extension +from setuptools.dist import Distribution, Feature +from setuptools.depends import Require +from . import monkey + +__metaclass__ = type + + +__all__ = [ + 'setup', 'Distribution', 'Feature', 'Command', 'Extension', 'Require', + 'SetuptoolsDeprecationWarning', + 'find_packages' +] + +if PY3: + __all__.append('find_namespace_packages') + +__version__ = setuptools.version.__version__ + +bootstrap_install_from = None + +# If we run 2to3 on .py files, should we also convert docstrings? +# Default: yes; assume that we can detect doctests reliably +run_2to3_on_doctests = True +# Standard package names for fixer packages +lib2to3_fixer_packages = ['lib2to3.fixes'] + + +class PackageFinder: + """ + Generate a list of all Python packages found within a directory + """ + + @classmethod + def find(cls, where='.', exclude=(), include=('*',)): + """Return a list all Python packages found within directory 'where' + + 'where' is the root directory which will be searched for packages. It + should be supplied as a "cross-platform" (i.e. URL-style) path; it will + be converted to the appropriate local path syntax. + + 'exclude' is a sequence of package names to exclude; '*' can be used + as a wildcard in the names, such that 'foo.*' will exclude all + subpackages of 'foo' (but not 'foo' itself). + + 'include' is a sequence of package names to include. If it's + specified, only the named packages will be included. If it's not + specified, all found packages will be included. 'include' can contain + shell style wildcard patterns just like 'exclude'. + """ + + return list(cls._find_packages_iter( + convert_path(where), + cls._build_filter('ez_setup', '*__pycache__', *exclude), + cls._build_filter(*include))) + + @classmethod + def _find_packages_iter(cls, where, exclude, include): + """ + All the packages found in 'where' that pass the 'include' filter, but + not the 'exclude' filter. + """ + for root, dirs, files in os.walk(where, followlinks=True): + # Copy dirs to iterate over it, then empty dirs. + all_dirs = dirs[:] + dirs[:] = [] + + for dir in all_dirs: + full_path = os.path.join(root, dir) + rel_path = os.path.relpath(full_path, where) + package = rel_path.replace(os.path.sep, '.') + + # Skip directory trees that are not valid packages + if ('.' in dir or not cls._looks_like_package(full_path)): + continue + + # Should this package be included? + if include(package) and not exclude(package): + yield package + + # Keep searching subdirectories, as there may be more packages + # down there, even if the parent was excluded. + dirs.append(dir) + + @staticmethod + def _looks_like_package(path): + """Does a directory look like a package?""" + return os.path.isfile(os.path.join(path, '__init__.py')) + + @staticmethod + def _build_filter(*patterns): + """ + Given a list of patterns, return a callable that will be true only if + the input matches at least one of the patterns. + """ + return lambda name: any(fnmatchcase(name, pat=pat) for pat in patterns) + + +class PEP420PackageFinder(PackageFinder): + @staticmethod + def _looks_like_package(path): + return True + + +find_packages = PackageFinder.find + +if PY3: + find_namespace_packages = PEP420PackageFinder.find + + +def _install_setup_requires(attrs): + # Note: do not use `setuptools.Distribution` directly, as + # our PEP 517 backend patch `distutils.core.Distribution`. + dist = distutils.core.Distribution(dict( + (k, v) for k, v in attrs.items() + if k in ('dependency_links', 'setup_requires') + )) + # Honor setup.cfg's options. + dist.parse_config_files(ignore_option_errors=True) + if dist.setup_requires: + dist.fetch_build_eggs(dist.setup_requires) + + +def setup(**attrs): + # Make sure we have any requirements needed to interpret 'attrs'. + _install_setup_requires(attrs) + return distutils.core.setup(**attrs) + +setup.__doc__ = distutils.core.setup.__doc__ + + +_Command = monkey.get_unpatched(distutils.core.Command) + + +class Command(_Command): + __doc__ = _Command.__doc__ + + command_consumes_arguments = False + + def __init__(self, dist, **kw): + """ + Construct the command for dist, updating + vars(self) with any keyword parameters. + """ + _Command.__init__(self, dist) + vars(self).update(kw) + + def _ensure_stringlike(self, option, what, default=None): + val = getattr(self, option) + if val is None: + setattr(self, option, default) + return default + elif not isinstance(val, string_types): + raise DistutilsOptionError("'%s' must be a %s (got `%s`)" + % (option, what, val)) + return val + + def ensure_string_list(self, option): + r"""Ensure that 'option' is a list of strings. If 'option' is + currently a string, we split it either on /,\s*/ or /\s+/, so + "foo bar baz", "foo,bar,baz", and "foo, bar baz" all become + ["foo", "bar", "baz"]. + """ + val = getattr(self, option) + if val is None: + return + elif isinstance(val, string_types): + setattr(self, option, re.split(r',\s*|\s+', val)) + else: + if isinstance(val, list): + ok = all(isinstance(v, string_types) for v in val) + else: + ok = False + if not ok: + raise DistutilsOptionError( + "'%s' must be a list of strings (got %r)" + % (option, val)) + + def reinitialize_command(self, command, reinit_subcommands=0, **kw): + cmd = _Command.reinitialize_command(self, command, reinit_subcommands) + vars(cmd).update(kw) + return cmd + + +def _find_all_simple(path): + """ + Find all files under 'path' + """ + results = ( + os.path.join(base, file) + for base, dirs, files in os.walk(path, followlinks=True) + for file in files + ) + return filter(os.path.isfile, results) + + +def findall(dir=os.curdir): + """ + Find all files under 'dir' and return the list of full filenames. + Unless dir is '.', return full filenames with dir prepended. + """ + files = _find_all_simple(dir) + if dir == os.curdir: + make_rel = functools.partial(os.path.relpath, start=dir) + files = map(make_rel, files) + return list(files) + + +# Apply monkey patches +monkey.patch_all() diff --git a/venv/lib/python3.8/site-packages/setuptools/_deprecation_warning.py b/venv/lib/python3.8/site-packages/setuptools/_deprecation_warning.py new file mode 100644 index 000000000..086b64dd3 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/_deprecation_warning.py @@ -0,0 +1,7 @@ +class SetuptoolsDeprecationWarning(Warning): + """ + Base class for warning deprecations in ``setuptools`` + + This class is not derived from ``DeprecationWarning``, and as such is + visible by default. + """ diff --git a/venv/lib/python3.8/site-packages/setuptools/_imp.py b/venv/lib/python3.8/site-packages/setuptools/_imp.py new file mode 100644 index 000000000..a3cce9b28 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/_imp.py @@ -0,0 +1,73 @@ +""" +Re-implementation of find_module and get_frozen_object +from the deprecated imp module. +""" + +import os +import importlib.util +import importlib.machinery + +from .py34compat import module_from_spec + + +PY_SOURCE = 1 +PY_COMPILED = 2 +C_EXTENSION = 3 +C_BUILTIN = 6 +PY_FROZEN = 7 + + +def find_module(module, paths=None): + """Just like 'imp.find_module()', but with package support""" + spec = importlib.util.find_spec(module, paths) + if spec is None: + raise ImportError("Can't find %s" % module) + if not spec.has_location and hasattr(spec, 'submodule_search_locations'): + spec = importlib.util.spec_from_loader('__init__.py', spec.loader) + + kind = -1 + file = None + static = isinstance(spec.loader, type) + if spec.origin == 'frozen' or static and issubclass( + spec.loader, importlib.machinery.FrozenImporter): + kind = PY_FROZEN + path = None # imp compabilty + suffix = mode = '' # imp compability + elif spec.origin == 'built-in' or static and issubclass( + spec.loader, importlib.machinery.BuiltinImporter): + kind = C_BUILTIN + path = None # imp compabilty + suffix = mode = '' # imp compability + elif spec.has_location: + path = spec.origin + suffix = os.path.splitext(path)[1] + mode = 'r' if suffix in importlib.machinery.SOURCE_SUFFIXES else 'rb' + + if suffix in importlib.machinery.SOURCE_SUFFIXES: + kind = PY_SOURCE + elif suffix in importlib.machinery.BYTECODE_SUFFIXES: + kind = PY_COMPILED + elif suffix in importlib.machinery.EXTENSION_SUFFIXES: + kind = C_EXTENSION + + if kind in {PY_SOURCE, PY_COMPILED}: + file = open(path, mode) + else: + path = None + suffix = mode = '' + + return file, path, (suffix, mode, kind) + + +def get_frozen_object(module, paths=None): + spec = importlib.util.find_spec(module, paths) + if not spec: + raise ImportError("Can't find %s" % module) + return spec.loader.get_code(module) + + +def get_module(module, paths, info): + spec = importlib.util.find_spec(module, paths) + if not spec: + raise ImportError("Can't find %s" % module) + return module_from_spec(spec) diff --git a/venv/lib/python3.8/site-packages/setuptools/_vendor/__init__.py b/venv/lib/python3.8/site-packages/setuptools/_vendor/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/venv/lib/python3.8/site-packages/setuptools/_vendor/ordered_set.py b/venv/lib/python3.8/site-packages/setuptools/_vendor/ordered_set.py new file mode 100644 index 000000000..14876000d --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/_vendor/ordered_set.py @@ -0,0 +1,488 @@ +""" +An OrderedSet is a custom MutableSet that remembers its order, so that every +entry has an index that can be looked up. + +Based on a recipe originally posted to ActiveState Recipes by Raymond Hettiger, +and released under the MIT license. +""" +import itertools as it +from collections import deque + +try: + # Python 3 + from collections.abc import MutableSet, Sequence +except ImportError: + # Python 2.7 + from collections import MutableSet, Sequence + +SLICE_ALL = slice(None) +__version__ = "3.1" + + +def is_iterable(obj): + """ + Are we being asked to look up a list of things, instead of a single thing? + We check for the `__iter__` attribute so that this can cover types that + don't have to be known by this module, such as NumPy arrays. + + Strings, however, should be considered as atomic values to look up, not + iterables. The same goes for tuples, since they are immutable and therefore + valid entries. + + We don't need to check for the Python 2 `unicode` type, because it doesn't + have an `__iter__` attribute anyway. + """ + return ( + hasattr(obj, "__iter__") + and not isinstance(obj, str) + and not isinstance(obj, tuple) + ) + + +class OrderedSet(MutableSet, Sequence): + """ + An OrderedSet is a custom MutableSet that remembers its order, so that + every entry has an index that can be looked up. + + Example: + >>> OrderedSet([1, 1, 2, 3, 2]) + OrderedSet([1, 2, 3]) + """ + + def __init__(self, iterable=None): + self.items = [] + self.map = {} + if iterable is not None: + self |= iterable + + def __len__(self): + """ + Returns the number of unique elements in the ordered set + + Example: + >>> len(OrderedSet([])) + 0 + >>> len(OrderedSet([1, 2])) + 2 + """ + return len(self.items) + + def __getitem__(self, index): + """ + Get the item at a given index. + + If `index` is a slice, you will get back that slice of items, as a + new OrderedSet. + + If `index` is a list or a similar iterable, you'll get a list of + items corresponding to those indices. This is similar to NumPy's + "fancy indexing". The result is not an OrderedSet because you may ask + for duplicate indices, and the number of elements returned should be + the number of elements asked for. + + Example: + >>> oset = OrderedSet([1, 2, 3]) + >>> oset[1] + 2 + """ + if isinstance(index, slice) and index == SLICE_ALL: + return self.copy() + elif is_iterable(index): + return [self.items[i] for i in index] + elif hasattr(index, "__index__") or isinstance(index, slice): + result = self.items[index] + if isinstance(result, list): + return self.__class__(result) + else: + return result + else: + raise TypeError("Don't know how to index an OrderedSet by %r" % index) + + def copy(self): + """ + Return a shallow copy of this object. + + Example: + >>> this = OrderedSet([1, 2, 3]) + >>> other = this.copy() + >>> this == other + True + >>> this is other + False + """ + return self.__class__(self) + + def __getstate__(self): + if len(self) == 0: + # The state can't be an empty list. + # We need to return a truthy value, or else __setstate__ won't be run. + # + # This could have been done more gracefully by always putting the state + # in a tuple, but this way is backwards- and forwards- compatible with + # previous versions of OrderedSet. + return (None,) + else: + return list(self) + + def __setstate__(self, state): + if state == (None,): + self.__init__([]) + else: + self.__init__(state) + + def __contains__(self, key): + """ + Test if the item is in this ordered set + + Example: + >>> 1 in OrderedSet([1, 3, 2]) + True + >>> 5 in OrderedSet([1, 3, 2]) + False + """ + return key in self.map + + def add(self, key): + """ + Add `key` as an item to this OrderedSet, then return its index. + + If `key` is already in the OrderedSet, return the index it already + had. + + Example: + >>> oset = OrderedSet() + >>> oset.append(3) + 0 + >>> print(oset) + OrderedSet([3]) + """ + if key not in self.map: + self.map[key] = len(self.items) + self.items.append(key) + return self.map[key] + + append = add + + def update(self, sequence): + """ + Update the set with the given iterable sequence, then return the index + of the last element inserted. + + Example: + >>> oset = OrderedSet([1, 2, 3]) + >>> oset.update([3, 1, 5, 1, 4]) + 4 + >>> print(oset) + OrderedSet([1, 2, 3, 5, 4]) + """ + item_index = None + try: + for item in sequence: + item_index = self.add(item) + except TypeError: + raise ValueError( + "Argument needs to be an iterable, got %s" % type(sequence) + ) + return item_index + + def index(self, key): + """ + Get the index of a given entry, raising an IndexError if it's not + present. + + `key` can be an iterable of entries that is not a string, in which case + this returns a list of indices. + + Example: + >>> oset = OrderedSet([1, 2, 3]) + >>> oset.index(2) + 1 + """ + if is_iterable(key): + return [self.index(subkey) for subkey in key] + return self.map[key] + + # Provide some compatibility with pd.Index + get_loc = index + get_indexer = index + + def pop(self): + """ + Remove and return the last element from the set. + + Raises KeyError if the set is empty. + + Example: + >>> oset = OrderedSet([1, 2, 3]) + >>> oset.pop() + 3 + """ + if not self.items: + raise KeyError("Set is empty") + + elem = self.items[-1] + del self.items[-1] + del self.map[elem] + return elem + + def discard(self, key): + """ + Remove an element. Do not raise an exception if absent. + + The MutableSet mixin uses this to implement the .remove() method, which + *does* raise an error when asked to remove a non-existent item. + + Example: + >>> oset = OrderedSet([1, 2, 3]) + >>> oset.discard(2) + >>> print(oset) + OrderedSet([1, 3]) + >>> oset.discard(2) + >>> print(oset) + OrderedSet([1, 3]) + """ + if key in self: + i = self.map[key] + del self.items[i] + del self.map[key] + for k, v in self.map.items(): + if v >= i: + self.map[k] = v - 1 + + def clear(self): + """ + Remove all items from this OrderedSet. + """ + del self.items[:] + self.map.clear() + + def __iter__(self): + """ + Example: + >>> list(iter(OrderedSet([1, 2, 3]))) + [1, 2, 3] + """ + return iter(self.items) + + def __reversed__(self): + """ + Example: + >>> list(reversed(OrderedSet([1, 2, 3]))) + [3, 2, 1] + """ + return reversed(self.items) + + def __repr__(self): + if not self: + return "%s()" % (self.__class__.__name__,) + return "%s(%r)" % (self.__class__.__name__, list(self)) + + def __eq__(self, other): + """ + Returns true if the containers have the same items. If `other` is a + Sequence, then order is checked, otherwise it is ignored. + + Example: + >>> oset = OrderedSet([1, 3, 2]) + >>> oset == [1, 3, 2] + True + >>> oset == [1, 2, 3] + False + >>> oset == [2, 3] + False + >>> oset == OrderedSet([3, 2, 1]) + False + """ + # In Python 2 deque is not a Sequence, so treat it as one for + # consistent behavior with Python 3. + if isinstance(other, (Sequence, deque)): + # Check that this OrderedSet contains the same elements, in the + # same order, as the other object. + return list(self) == list(other) + try: + other_as_set = set(other) + except TypeError: + # If `other` can't be converted into a set, it's not equal. + return False + else: + return set(self) == other_as_set + + def union(self, *sets): + """ + Combines all unique items. + Each items order is defined by its first appearance. + + Example: + >>> oset = OrderedSet.union(OrderedSet([3, 1, 4, 1, 5]), [1, 3], [2, 0]) + >>> print(oset) + OrderedSet([3, 1, 4, 5, 2, 0]) + >>> oset.union([8, 9]) + OrderedSet([3, 1, 4, 5, 2, 0, 8, 9]) + >>> oset | {10} + OrderedSet([3, 1, 4, 5, 2, 0, 10]) + """ + cls = self.__class__ if isinstance(self, OrderedSet) else OrderedSet + containers = map(list, it.chain([self], sets)) + items = it.chain.from_iterable(containers) + return cls(items) + + def __and__(self, other): + # the parent implementation of this is backwards + return self.intersection(other) + + def intersection(self, *sets): + """ + Returns elements in common between all sets. Order is defined only + by the first set. + + Example: + >>> oset = OrderedSet.intersection(OrderedSet([0, 1, 2, 3]), [1, 2, 3]) + >>> print(oset) + OrderedSet([1, 2, 3]) + >>> oset.intersection([2, 4, 5], [1, 2, 3, 4]) + OrderedSet([2]) + >>> oset.intersection() + OrderedSet([1, 2, 3]) + """ + cls = self.__class__ if isinstance(self, OrderedSet) else OrderedSet + if sets: + common = set.intersection(*map(set, sets)) + items = (item for item in self if item in common) + else: + items = self + return cls(items) + + def difference(self, *sets): + """ + Returns all elements that are in this set but not the others. + + Example: + >>> OrderedSet([1, 2, 3]).difference(OrderedSet([2])) + OrderedSet([1, 3]) + >>> OrderedSet([1, 2, 3]).difference(OrderedSet([2]), OrderedSet([3])) + OrderedSet([1]) + >>> OrderedSet([1, 2, 3]) - OrderedSet([2]) + OrderedSet([1, 3]) + >>> OrderedSet([1, 2, 3]).difference() + OrderedSet([1, 2, 3]) + """ + cls = self.__class__ + if sets: + other = set.union(*map(set, sets)) + items = (item for item in self if item not in other) + else: + items = self + return cls(items) + + def issubset(self, other): + """ + Report whether another set contains this set. + + Example: + >>> OrderedSet([1, 2, 3]).issubset({1, 2}) + False + >>> OrderedSet([1, 2, 3]).issubset({1, 2, 3, 4}) + True + >>> OrderedSet([1, 2, 3]).issubset({1, 4, 3, 5}) + False + """ + if len(self) > len(other): # Fast check for obvious cases + return False + return all(item in other for item in self) + + def issuperset(self, other): + """ + Report whether this set contains another set. + + Example: + >>> OrderedSet([1, 2]).issuperset([1, 2, 3]) + False + >>> OrderedSet([1, 2, 3, 4]).issuperset({1, 2, 3}) + True + >>> OrderedSet([1, 4, 3, 5]).issuperset({1, 2, 3}) + False + """ + if len(self) < len(other): # Fast check for obvious cases + return False + return all(item in self for item in other) + + def symmetric_difference(self, other): + """ + Return the symmetric difference of two OrderedSets as a new set. + That is, the new set will contain all elements that are in exactly + one of the sets. + + Their order will be preserved, with elements from `self` preceding + elements from `other`. + + Example: + >>> this = OrderedSet([1, 4, 3, 5, 7]) + >>> other = OrderedSet([9, 7, 1, 3, 2]) + >>> this.symmetric_difference(other) + OrderedSet([4, 5, 9, 2]) + """ + cls = self.__class__ if isinstance(self, OrderedSet) else OrderedSet + diff1 = cls(self).difference(other) + diff2 = cls(other).difference(self) + return diff1.union(diff2) + + def _update_items(self, items): + """ + Replace the 'items' list of this OrderedSet with a new one, updating + self.map accordingly. + """ + self.items = items + self.map = {item: idx for (idx, item) in enumerate(items)} + + def difference_update(self, *sets): + """ + Update this OrderedSet to remove items from one or more other sets. + + Example: + >>> this = OrderedSet([1, 2, 3]) + >>> this.difference_update(OrderedSet([2, 4])) + >>> print(this) + OrderedSet([1, 3]) + + >>> this = OrderedSet([1, 2, 3, 4, 5]) + >>> this.difference_update(OrderedSet([2, 4]), OrderedSet([1, 4, 6])) + >>> print(this) + OrderedSet([3, 5]) + """ + items_to_remove = set() + for other in sets: + items_to_remove |= set(other) + self._update_items([item for item in self.items if item not in items_to_remove]) + + def intersection_update(self, other): + """ + Update this OrderedSet to keep only items in another set, preserving + their order in this set. + + Example: + >>> this = OrderedSet([1, 4, 3, 5, 7]) + >>> other = OrderedSet([9, 7, 1, 3, 2]) + >>> this.intersection_update(other) + >>> print(this) + OrderedSet([1, 3, 7]) + """ + other = set(other) + self._update_items([item for item in self.items if item in other]) + + def symmetric_difference_update(self, other): + """ + Update this OrderedSet to remove items from another set, then + add items from the other set that were not present in this set. + + Example: + >>> this = OrderedSet([1, 4, 3, 5, 7]) + >>> other = OrderedSet([9, 7, 1, 3, 2]) + >>> this.symmetric_difference_update(other) + >>> print(this) + OrderedSet([4, 5, 9, 2]) + """ + items_to_add = [item for item in other if item not in self] + items_to_remove = set(other) + self._update_items( + [item for item in self.items if item not in items_to_remove] + items_to_add + ) diff --git a/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/__about__.py b/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/__about__.py new file mode 100644 index 000000000..dc95138d0 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/__about__.py @@ -0,0 +1,27 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. +from __future__ import absolute_import, division, print_function + +__all__ = [ + "__title__", + "__summary__", + "__uri__", + "__version__", + "__author__", + "__email__", + "__license__", + "__copyright__", +] + +__title__ = "packaging" +__summary__ = "Core utilities for Python packages" +__uri__ = "https://github.com/pypa/packaging" + +__version__ = "19.2" + +__author__ = "Donald Stufft and individual contributors" +__email__ = "donald@stufft.io" + +__license__ = "BSD or Apache License, Version 2.0" +__copyright__ = "Copyright 2014-2019 %s" % __author__ diff --git a/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/__init__.py b/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/__init__.py new file mode 100644 index 000000000..a0cf67df5 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/__init__.py @@ -0,0 +1,26 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. +from __future__ import absolute_import, division, print_function + +from .__about__ import ( + __author__, + __copyright__, + __email__, + __license__, + __summary__, + __title__, + __uri__, + __version__, +) + +__all__ = [ + "__title__", + "__summary__", + "__uri__", + "__version__", + "__author__", + "__email__", + "__license__", + "__copyright__", +] diff --git a/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/_compat.py b/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/_compat.py new file mode 100644 index 000000000..25da473c1 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/_compat.py @@ -0,0 +1,31 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. +from __future__ import absolute_import, division, print_function + +import sys + + +PY2 = sys.version_info[0] == 2 +PY3 = sys.version_info[0] == 3 + +# flake8: noqa + +if PY3: + string_types = (str,) +else: + string_types = (basestring,) + + +def with_metaclass(meta, *bases): + """ + Create a base class with a metaclass. + """ + # This requires a bit of explanation: the basic idea is to make a dummy + # metaclass for one level of class instantiation that replaces itself with + # the actual metaclass. + class metaclass(meta): + def __new__(cls, name, this_bases, d): + return meta(name, bases, d) + + return type.__new__(metaclass, "temporary_class", (), {}) diff --git a/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/_structures.py b/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/_structures.py new file mode 100644 index 000000000..68dcca634 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/_structures.py @@ -0,0 +1,68 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. +from __future__ import absolute_import, division, print_function + + +class Infinity(object): + def __repr__(self): + return "Infinity" + + def __hash__(self): + return hash(repr(self)) + + def __lt__(self, other): + return False + + def __le__(self, other): + return False + + def __eq__(self, other): + return isinstance(other, self.__class__) + + def __ne__(self, other): + return not isinstance(other, self.__class__) + + def __gt__(self, other): + return True + + def __ge__(self, other): + return True + + def __neg__(self): + return NegativeInfinity + + +Infinity = Infinity() + + +class NegativeInfinity(object): + def __repr__(self): + return "-Infinity" + + def __hash__(self): + return hash(repr(self)) + + def __lt__(self, other): + return True + + def __le__(self, other): + return True + + def __eq__(self, other): + return isinstance(other, self.__class__) + + def __ne__(self, other): + return not isinstance(other, self.__class__) + + def __gt__(self, other): + return False + + def __ge__(self, other): + return False + + def __neg__(self): + return Infinity + + +NegativeInfinity = NegativeInfinity() diff --git a/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/markers.py b/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/markers.py new file mode 100644 index 000000000..4bdfdb24f --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/markers.py @@ -0,0 +1,296 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. +from __future__ import absolute_import, division, print_function + +import operator +import os +import platform +import sys + +from setuptools.extern.pyparsing import ParseException, ParseResults, stringStart, stringEnd +from setuptools.extern.pyparsing import ZeroOrMore, Group, Forward, QuotedString +from setuptools.extern.pyparsing import Literal as L # noqa + +from ._compat import string_types +from .specifiers import Specifier, InvalidSpecifier + + +__all__ = [ + "InvalidMarker", + "UndefinedComparison", + "UndefinedEnvironmentName", + "Marker", + "default_environment", +] + + +class InvalidMarker(ValueError): + """ + An invalid marker was found, users should refer to PEP 508. + """ + + +class UndefinedComparison(ValueError): + """ + An invalid operation was attempted on a value that doesn't support it. + """ + + +class UndefinedEnvironmentName(ValueError): + """ + A name was attempted to be used that does not exist inside of the + environment. + """ + + +class Node(object): + def __init__(self, value): + self.value = value + + def __str__(self): + return str(self.value) + + def __repr__(self): + return "<{0}({1!r})>".format(self.__class__.__name__, str(self)) + + def serialize(self): + raise NotImplementedError + + +class Variable(Node): + def serialize(self): + return str(self) + + +class Value(Node): + def serialize(self): + return '"{0}"'.format(self) + + +class Op(Node): + def serialize(self): + return str(self) + + +VARIABLE = ( + L("implementation_version") + | L("platform_python_implementation") + | L("implementation_name") + | L("python_full_version") + | L("platform_release") + | L("platform_version") + | L("platform_machine") + | L("platform_system") + | L("python_version") + | L("sys_platform") + | L("os_name") + | L("os.name") + | L("sys.platform") # PEP-345 + | L("platform.version") # PEP-345 + | L("platform.machine") # PEP-345 + | L("platform.python_implementation") # PEP-345 + | L("python_implementation") # PEP-345 + | L("extra") # undocumented setuptools legacy +) +ALIASES = { + "os.name": "os_name", + "sys.platform": "sys_platform", + "platform.version": "platform_version", + "platform.machine": "platform_machine", + "platform.python_implementation": "platform_python_implementation", + "python_implementation": "platform_python_implementation", +} +VARIABLE.setParseAction(lambda s, l, t: Variable(ALIASES.get(t[0], t[0]))) + +VERSION_CMP = ( + L("===") | L("==") | L(">=") | L("<=") | L("!=") | L("~=") | L(">") | L("<") +) + +MARKER_OP = VERSION_CMP | L("not in") | L("in") +MARKER_OP.setParseAction(lambda s, l, t: Op(t[0])) + +MARKER_VALUE = QuotedString("'") | QuotedString('"') +MARKER_VALUE.setParseAction(lambda s, l, t: Value(t[0])) + +BOOLOP = L("and") | L("or") + +MARKER_VAR = VARIABLE | MARKER_VALUE + +MARKER_ITEM = Group(MARKER_VAR + MARKER_OP + MARKER_VAR) +MARKER_ITEM.setParseAction(lambda s, l, t: tuple(t[0])) + +LPAREN = L("(").suppress() +RPAREN = L(")").suppress() + +MARKER_EXPR = Forward() +MARKER_ATOM = MARKER_ITEM | Group(LPAREN + MARKER_EXPR + RPAREN) +MARKER_EXPR << MARKER_ATOM + ZeroOrMore(BOOLOP + MARKER_EXPR) + +MARKER = stringStart + MARKER_EXPR + stringEnd + + +def _coerce_parse_result(results): + if isinstance(results, ParseResults): + return [_coerce_parse_result(i) for i in results] + else: + return results + + +def _format_marker(marker, first=True): + assert isinstance(marker, (list, tuple, string_types)) + + # Sometimes we have a structure like [[...]] which is a single item list + # where the single item is itself it's own list. In that case we want skip + # the rest of this function so that we don't get extraneous () on the + # outside. + if ( + isinstance(marker, list) + and len(marker) == 1 + and isinstance(marker[0], (list, tuple)) + ): + return _format_marker(marker[0]) + + if isinstance(marker, list): + inner = (_format_marker(m, first=False) for m in marker) + if first: + return " ".join(inner) + else: + return "(" + " ".join(inner) + ")" + elif isinstance(marker, tuple): + return " ".join([m.serialize() for m in marker]) + else: + return marker + + +_operators = { + "in": lambda lhs, rhs: lhs in rhs, + "not in": lambda lhs, rhs: lhs not in rhs, + "<": operator.lt, + "<=": operator.le, + "==": operator.eq, + "!=": operator.ne, + ">=": operator.ge, + ">": operator.gt, +} + + +def _eval_op(lhs, op, rhs): + try: + spec = Specifier("".join([op.serialize(), rhs])) + except InvalidSpecifier: + pass + else: + return spec.contains(lhs) + + oper = _operators.get(op.serialize()) + if oper is None: + raise UndefinedComparison( + "Undefined {0!r} on {1!r} and {2!r}.".format(op, lhs, rhs) + ) + + return oper(lhs, rhs) + + +_undefined = object() + + +def _get_env(environment, name): + value = environment.get(name, _undefined) + + if value is _undefined: + raise UndefinedEnvironmentName( + "{0!r} does not exist in evaluation environment.".format(name) + ) + + return value + + +def _evaluate_markers(markers, environment): + groups = [[]] + + for marker in markers: + assert isinstance(marker, (list, tuple, string_types)) + + if isinstance(marker, list): + groups[-1].append(_evaluate_markers(marker, environment)) + elif isinstance(marker, tuple): + lhs, op, rhs = marker + + if isinstance(lhs, Variable): + lhs_value = _get_env(environment, lhs.value) + rhs_value = rhs.value + else: + lhs_value = lhs.value + rhs_value = _get_env(environment, rhs.value) + + groups[-1].append(_eval_op(lhs_value, op, rhs_value)) + else: + assert marker in ["and", "or"] + if marker == "or": + groups.append([]) + + return any(all(item) for item in groups) + + +def format_full_version(info): + version = "{0.major}.{0.minor}.{0.micro}".format(info) + kind = info.releaselevel + if kind != "final": + version += kind[0] + str(info.serial) + return version + + +def default_environment(): + if hasattr(sys, "implementation"): + iver = format_full_version(sys.implementation.version) + implementation_name = sys.implementation.name + else: + iver = "0" + implementation_name = "" + + return { + "implementation_name": implementation_name, + "implementation_version": iver, + "os_name": os.name, + "platform_machine": platform.machine(), + "platform_release": platform.release(), + "platform_system": platform.system(), + "platform_version": platform.version(), + "python_full_version": platform.python_version(), + "platform_python_implementation": platform.python_implementation(), + "python_version": ".".join(platform.python_version_tuple()[:2]), + "sys_platform": sys.platform, + } + + +class Marker(object): + def __init__(self, marker): + try: + self._markers = _coerce_parse_result(MARKER.parseString(marker)) + except ParseException as e: + err_str = "Invalid marker: {0!r}, parse error at {1!r}".format( + marker, marker[e.loc : e.loc + 8] + ) + raise InvalidMarker(err_str) + + def __str__(self): + return _format_marker(self._markers) + + def __repr__(self): + return "".format(str(self)) + + def evaluate(self, environment=None): + """Evaluate a marker. + + Return the boolean from evaluating the given marker against the + environment. environment is an optional argument to override all or + part of the determined environment. + + The environment is determined from the current Python process. + """ + current_environment = default_environment() + if environment is not None: + current_environment.update(environment) + + return _evaluate_markers(self._markers, current_environment) diff --git a/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/requirements.py b/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/requirements.py new file mode 100644 index 000000000..8a0c2cb9b --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/requirements.py @@ -0,0 +1,138 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. +from __future__ import absolute_import, division, print_function + +import string +import re + +from setuptools.extern.pyparsing import stringStart, stringEnd, originalTextFor, ParseException +from setuptools.extern.pyparsing import ZeroOrMore, Word, Optional, Regex, Combine +from setuptools.extern.pyparsing import Literal as L # noqa +from setuptools.extern.six.moves.urllib import parse as urlparse + +from .markers import MARKER_EXPR, Marker +from .specifiers import LegacySpecifier, Specifier, SpecifierSet + + +class InvalidRequirement(ValueError): + """ + An invalid requirement was found, users should refer to PEP 508. + """ + + +ALPHANUM = Word(string.ascii_letters + string.digits) + +LBRACKET = L("[").suppress() +RBRACKET = L("]").suppress() +LPAREN = L("(").suppress() +RPAREN = L(")").suppress() +COMMA = L(",").suppress() +SEMICOLON = L(";").suppress() +AT = L("@").suppress() + +PUNCTUATION = Word("-_.") +IDENTIFIER_END = ALPHANUM | (ZeroOrMore(PUNCTUATION) + ALPHANUM) +IDENTIFIER = Combine(ALPHANUM + ZeroOrMore(IDENTIFIER_END)) + +NAME = IDENTIFIER("name") +EXTRA = IDENTIFIER + +URI = Regex(r"[^ ]+")("url") +URL = AT + URI + +EXTRAS_LIST = EXTRA + ZeroOrMore(COMMA + EXTRA) +EXTRAS = (LBRACKET + Optional(EXTRAS_LIST) + RBRACKET)("extras") + +VERSION_PEP440 = Regex(Specifier._regex_str, re.VERBOSE | re.IGNORECASE) +VERSION_LEGACY = Regex(LegacySpecifier._regex_str, re.VERBOSE | re.IGNORECASE) + +VERSION_ONE = VERSION_PEP440 ^ VERSION_LEGACY +VERSION_MANY = Combine( + VERSION_ONE + ZeroOrMore(COMMA + VERSION_ONE), joinString=",", adjacent=False +)("_raw_spec") +_VERSION_SPEC = Optional(((LPAREN + VERSION_MANY + RPAREN) | VERSION_MANY)) +_VERSION_SPEC.setParseAction(lambda s, l, t: t._raw_spec or "") + +VERSION_SPEC = originalTextFor(_VERSION_SPEC)("specifier") +VERSION_SPEC.setParseAction(lambda s, l, t: t[1]) + +MARKER_EXPR = originalTextFor(MARKER_EXPR())("marker") +MARKER_EXPR.setParseAction( + lambda s, l, t: Marker(s[t._original_start : t._original_end]) +) +MARKER_SEPARATOR = SEMICOLON +MARKER = MARKER_SEPARATOR + MARKER_EXPR + +VERSION_AND_MARKER = VERSION_SPEC + Optional(MARKER) +URL_AND_MARKER = URL + Optional(MARKER) + +NAMED_REQUIREMENT = NAME + Optional(EXTRAS) + (URL_AND_MARKER | VERSION_AND_MARKER) + +REQUIREMENT = stringStart + NAMED_REQUIREMENT + stringEnd +# setuptools.extern.pyparsing isn't thread safe during initialization, so we do it eagerly, see +# issue #104 +REQUIREMENT.parseString("x[]") + + +class Requirement(object): + """Parse a requirement. + + Parse a given requirement string into its parts, such as name, specifier, + URL, and extras. Raises InvalidRequirement on a badly-formed requirement + string. + """ + + # TODO: Can we test whether something is contained within a requirement? + # If so how do we do that? Do we need to test against the _name_ of + # the thing as well as the version? What about the markers? + # TODO: Can we normalize the name and extra name? + + def __init__(self, requirement_string): + try: + req = REQUIREMENT.parseString(requirement_string) + except ParseException as e: + raise InvalidRequirement( + 'Parse error at "{0!r}": {1}'.format( + requirement_string[e.loc : e.loc + 8], e.msg + ) + ) + + self.name = req.name + if req.url: + parsed_url = urlparse.urlparse(req.url) + if parsed_url.scheme == "file": + if urlparse.urlunparse(parsed_url) != req.url: + raise InvalidRequirement("Invalid URL given") + elif not (parsed_url.scheme and parsed_url.netloc) or ( + not parsed_url.scheme and not parsed_url.netloc + ): + raise InvalidRequirement("Invalid URL: {0}".format(req.url)) + self.url = req.url + else: + self.url = None + self.extras = set(req.extras.asList() if req.extras else []) + self.specifier = SpecifierSet(req.specifier) + self.marker = req.marker if req.marker else None + + def __str__(self): + parts = [self.name] + + if self.extras: + parts.append("[{0}]".format(",".join(sorted(self.extras)))) + + if self.specifier: + parts.append(str(self.specifier)) + + if self.url: + parts.append("@ {0}".format(self.url)) + if self.marker: + parts.append(" ") + + if self.marker: + parts.append("; {0}".format(self.marker)) + + return "".join(parts) + + def __repr__(self): + return "".format(str(self)) diff --git a/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/specifiers.py b/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/specifiers.py new file mode 100644 index 000000000..743576a08 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/specifiers.py @@ -0,0 +1,749 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. +from __future__ import absolute_import, division, print_function + +import abc +import functools +import itertools +import re + +from ._compat import string_types, with_metaclass +from .version import Version, LegacyVersion, parse + + +class InvalidSpecifier(ValueError): + """ + An invalid specifier was found, users should refer to PEP 440. + """ + + +class BaseSpecifier(with_metaclass(abc.ABCMeta, object)): + @abc.abstractmethod + def __str__(self): + """ + Returns the str representation of this Specifier like object. This + should be representative of the Specifier itself. + """ + + @abc.abstractmethod + def __hash__(self): + """ + Returns a hash value for this Specifier like object. + """ + + @abc.abstractmethod + def __eq__(self, other): + """ + Returns a boolean representing whether or not the two Specifier like + objects are equal. + """ + + @abc.abstractmethod + def __ne__(self, other): + """ + Returns a boolean representing whether or not the two Specifier like + objects are not equal. + """ + + @abc.abstractproperty + def prereleases(self): + """ + Returns whether or not pre-releases as a whole are allowed by this + specifier. + """ + + @prereleases.setter + def prereleases(self, value): + """ + Sets whether or not pre-releases as a whole are allowed by this + specifier. + """ + + @abc.abstractmethod + def contains(self, item, prereleases=None): + """ + Determines if the given item is contained within this specifier. + """ + + @abc.abstractmethod + def filter(self, iterable, prereleases=None): + """ + Takes an iterable of items and filters them so that only items which + are contained within this specifier are allowed in it. + """ + + +class _IndividualSpecifier(BaseSpecifier): + + _operators = {} + + def __init__(self, spec="", prereleases=None): + match = self._regex.search(spec) + if not match: + raise InvalidSpecifier("Invalid specifier: '{0}'".format(spec)) + + self._spec = (match.group("operator").strip(), match.group("version").strip()) + + # Store whether or not this Specifier should accept prereleases + self._prereleases = prereleases + + def __repr__(self): + pre = ( + ", prereleases={0!r}".format(self.prereleases) + if self._prereleases is not None + else "" + ) + + return "<{0}({1!r}{2})>".format(self.__class__.__name__, str(self), pre) + + def __str__(self): + return "{0}{1}".format(*self._spec) + + def __hash__(self): + return hash(self._spec) + + def __eq__(self, other): + if isinstance(other, string_types): + try: + other = self.__class__(other) + except InvalidSpecifier: + return NotImplemented + elif not isinstance(other, self.__class__): + return NotImplemented + + return self._spec == other._spec + + def __ne__(self, other): + if isinstance(other, string_types): + try: + other = self.__class__(other) + except InvalidSpecifier: + return NotImplemented + elif not isinstance(other, self.__class__): + return NotImplemented + + return self._spec != other._spec + + def _get_operator(self, op): + return getattr(self, "_compare_{0}".format(self._operators[op])) + + def _coerce_version(self, version): + if not isinstance(version, (LegacyVersion, Version)): + version = parse(version) + return version + + @property + def operator(self): + return self._spec[0] + + @property + def version(self): + return self._spec[1] + + @property + def prereleases(self): + return self._prereleases + + @prereleases.setter + def prereleases(self, value): + self._prereleases = value + + def __contains__(self, item): + return self.contains(item) + + def contains(self, item, prereleases=None): + # Determine if prereleases are to be allowed or not. + if prereleases is None: + prereleases = self.prereleases + + # Normalize item to a Version or LegacyVersion, this allows us to have + # a shortcut for ``"2.0" in Specifier(">=2") + item = self._coerce_version(item) + + # Determine if we should be supporting prereleases in this specifier + # or not, if we do not support prereleases than we can short circuit + # logic if this version is a prereleases. + if item.is_prerelease and not prereleases: + return False + + # Actually do the comparison to determine if this item is contained + # within this Specifier or not. + return self._get_operator(self.operator)(item, self.version) + + def filter(self, iterable, prereleases=None): + yielded = False + found_prereleases = [] + + kw = {"prereleases": prereleases if prereleases is not None else True} + + # Attempt to iterate over all the values in the iterable and if any of + # them match, yield them. + for version in iterable: + parsed_version = self._coerce_version(version) + + if self.contains(parsed_version, **kw): + # If our version is a prerelease, and we were not set to allow + # prereleases, then we'll store it for later incase nothing + # else matches this specifier. + if parsed_version.is_prerelease and not ( + prereleases or self.prereleases + ): + found_prereleases.append(version) + # Either this is not a prerelease, or we should have been + # accepting prereleases from the beginning. + else: + yielded = True + yield version + + # Now that we've iterated over everything, determine if we've yielded + # any values, and if we have not and we have any prereleases stored up + # then we will go ahead and yield the prereleases. + if not yielded and found_prereleases: + for version in found_prereleases: + yield version + + +class LegacySpecifier(_IndividualSpecifier): + + _regex_str = r""" + (?P(==|!=|<=|>=|<|>)) + \s* + (?P + [^,;\s)]* # Since this is a "legacy" specifier, and the version + # string can be just about anything, we match everything + # except for whitespace, a semi-colon for marker support, + # a closing paren since versions can be enclosed in + # them, and a comma since it's a version separator. + ) + """ + + _regex = re.compile(r"^\s*" + _regex_str + r"\s*$", re.VERBOSE | re.IGNORECASE) + + _operators = { + "==": "equal", + "!=": "not_equal", + "<=": "less_than_equal", + ">=": "greater_than_equal", + "<": "less_than", + ">": "greater_than", + } + + def _coerce_version(self, version): + if not isinstance(version, LegacyVersion): + version = LegacyVersion(str(version)) + return version + + def _compare_equal(self, prospective, spec): + return prospective == self._coerce_version(spec) + + def _compare_not_equal(self, prospective, spec): + return prospective != self._coerce_version(spec) + + def _compare_less_than_equal(self, prospective, spec): + return prospective <= self._coerce_version(spec) + + def _compare_greater_than_equal(self, prospective, spec): + return prospective >= self._coerce_version(spec) + + def _compare_less_than(self, prospective, spec): + return prospective < self._coerce_version(spec) + + def _compare_greater_than(self, prospective, spec): + return prospective > self._coerce_version(spec) + + +def _require_version_compare(fn): + @functools.wraps(fn) + def wrapped(self, prospective, spec): + if not isinstance(prospective, Version): + return False + return fn(self, prospective, spec) + + return wrapped + + +class Specifier(_IndividualSpecifier): + + _regex_str = r""" + (?P(~=|==|!=|<=|>=|<|>|===)) + (?P + (?: + # The identity operators allow for an escape hatch that will + # do an exact string match of the version you wish to install. + # This will not be parsed by PEP 440 and we cannot determine + # any semantic meaning from it. This operator is discouraged + # but included entirely as an escape hatch. + (?<====) # Only match for the identity operator + \s* + [^\s]* # We just match everything, except for whitespace + # since we are only testing for strict identity. + ) + | + (?: + # The (non)equality operators allow for wild card and local + # versions to be specified so we have to define these two + # operators separately to enable that. + (?<===|!=) # Only match for equals and not equals + + \s* + v? + (?:[0-9]+!)? # epoch + [0-9]+(?:\.[0-9]+)* # release + (?: # pre release + [-_\.]? + (a|b|c|rc|alpha|beta|pre|preview) + [-_\.]? + [0-9]* + )? + (?: # post release + (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*) + )? + + # You cannot use a wild card and a dev or local version + # together so group them with a | and make them optional. + (?: + (?:[-_\.]?dev[-_\.]?[0-9]*)? # dev release + (?:\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*)? # local + | + \.\* # Wild card syntax of .* + )? + ) + | + (?: + # The compatible operator requires at least two digits in the + # release segment. + (?<=~=) # Only match for the compatible operator + + \s* + v? + (?:[0-9]+!)? # epoch + [0-9]+(?:\.[0-9]+)+ # release (We have a + instead of a *) + (?: # pre release + [-_\.]? + (a|b|c|rc|alpha|beta|pre|preview) + [-_\.]? + [0-9]* + )? + (?: # post release + (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*) + )? + (?:[-_\.]?dev[-_\.]?[0-9]*)? # dev release + ) + | + (?: + # All other operators only allow a sub set of what the + # (non)equality operators do. Specifically they do not allow + # local versions to be specified nor do they allow the prefix + # matching wild cards. + (?=": "greater_than_equal", + "<": "less_than", + ">": "greater_than", + "===": "arbitrary", + } + + @_require_version_compare + def _compare_compatible(self, prospective, spec): + # Compatible releases have an equivalent combination of >= and ==. That + # is that ~=2.2 is equivalent to >=2.2,==2.*. This allows us to + # implement this in terms of the other specifiers instead of + # implementing it ourselves. The only thing we need to do is construct + # the other specifiers. + + # We want everything but the last item in the version, but we want to + # ignore post and dev releases and we want to treat the pre-release as + # it's own separate segment. + prefix = ".".join( + list( + itertools.takewhile( + lambda x: (not x.startswith("post") and not x.startswith("dev")), + _version_split(spec), + ) + )[:-1] + ) + + # Add the prefix notation to the end of our string + prefix += ".*" + + return self._get_operator(">=")(prospective, spec) and self._get_operator("==")( + prospective, prefix + ) + + @_require_version_compare + def _compare_equal(self, prospective, spec): + # We need special logic to handle prefix matching + if spec.endswith(".*"): + # In the case of prefix matching we want to ignore local segment. + prospective = Version(prospective.public) + # Split the spec out by dots, and pretend that there is an implicit + # dot in between a release segment and a pre-release segment. + spec = _version_split(spec[:-2]) # Remove the trailing .* + + # Split the prospective version out by dots, and pretend that there + # is an implicit dot in between a release segment and a pre-release + # segment. + prospective = _version_split(str(prospective)) + + # Shorten the prospective version to be the same length as the spec + # so that we can determine if the specifier is a prefix of the + # prospective version or not. + prospective = prospective[: len(spec)] + + # Pad out our two sides with zeros so that they both equal the same + # length. + spec, prospective = _pad_version(spec, prospective) + else: + # Convert our spec string into a Version + spec = Version(spec) + + # If the specifier does not have a local segment, then we want to + # act as if the prospective version also does not have a local + # segment. + if not spec.local: + prospective = Version(prospective.public) + + return prospective == spec + + @_require_version_compare + def _compare_not_equal(self, prospective, spec): + return not self._compare_equal(prospective, spec) + + @_require_version_compare + def _compare_less_than_equal(self, prospective, spec): + return prospective <= Version(spec) + + @_require_version_compare + def _compare_greater_than_equal(self, prospective, spec): + return prospective >= Version(spec) + + @_require_version_compare + def _compare_less_than(self, prospective, spec): + # Convert our spec to a Version instance, since we'll want to work with + # it as a version. + spec = Version(spec) + + # Check to see if the prospective version is less than the spec + # version. If it's not we can short circuit and just return False now + # instead of doing extra unneeded work. + if not prospective < spec: + return False + + # This special case is here so that, unless the specifier itself + # includes is a pre-release version, that we do not accept pre-release + # versions for the version mentioned in the specifier (e.g. <3.1 should + # not match 3.1.dev0, but should match 3.0.dev0). + if not spec.is_prerelease and prospective.is_prerelease: + if Version(prospective.base_version) == Version(spec.base_version): + return False + + # If we've gotten to here, it means that prospective version is both + # less than the spec version *and* it's not a pre-release of the same + # version in the spec. + return True + + @_require_version_compare + def _compare_greater_than(self, prospective, spec): + # Convert our spec to a Version instance, since we'll want to work with + # it as a version. + spec = Version(spec) + + # Check to see if the prospective version is greater than the spec + # version. If it's not we can short circuit and just return False now + # instead of doing extra unneeded work. + if not prospective > spec: + return False + + # This special case is here so that, unless the specifier itself + # includes is a post-release version, that we do not accept + # post-release versions for the version mentioned in the specifier + # (e.g. >3.1 should not match 3.0.post0, but should match 3.2.post0). + if not spec.is_postrelease and prospective.is_postrelease: + if Version(prospective.base_version) == Version(spec.base_version): + return False + + # Ensure that we do not allow a local version of the version mentioned + # in the specifier, which is technically greater than, to match. + if prospective.local is not None: + if Version(prospective.base_version) == Version(spec.base_version): + return False + + # If we've gotten to here, it means that prospective version is both + # greater than the spec version *and* it's not a pre-release of the + # same version in the spec. + return True + + def _compare_arbitrary(self, prospective, spec): + return str(prospective).lower() == str(spec).lower() + + @property + def prereleases(self): + # If there is an explicit prereleases set for this, then we'll just + # blindly use that. + if self._prereleases is not None: + return self._prereleases + + # Look at all of our specifiers and determine if they are inclusive + # operators, and if they are if they are including an explicit + # prerelease. + operator, version = self._spec + if operator in ["==", ">=", "<=", "~=", "==="]: + # The == specifier can include a trailing .*, if it does we + # want to remove before parsing. + if operator == "==" and version.endswith(".*"): + version = version[:-2] + + # Parse the version, and if it is a pre-release than this + # specifier allows pre-releases. + if parse(version).is_prerelease: + return True + + return False + + @prereleases.setter + def prereleases(self, value): + self._prereleases = value + + +_prefix_regex = re.compile(r"^([0-9]+)((?:a|b|c|rc)[0-9]+)$") + + +def _version_split(version): + result = [] + for item in version.split("."): + match = _prefix_regex.search(item) + if match: + result.extend(match.groups()) + else: + result.append(item) + return result + + +def _pad_version(left, right): + left_split, right_split = [], [] + + # Get the release segment of our versions + left_split.append(list(itertools.takewhile(lambda x: x.isdigit(), left))) + right_split.append(list(itertools.takewhile(lambda x: x.isdigit(), right))) + + # Get the rest of our versions + left_split.append(left[len(left_split[0]) :]) + right_split.append(right[len(right_split[0]) :]) + + # Insert our padding + left_split.insert(1, ["0"] * max(0, len(right_split[0]) - len(left_split[0]))) + right_split.insert(1, ["0"] * max(0, len(left_split[0]) - len(right_split[0]))) + + return (list(itertools.chain(*left_split)), list(itertools.chain(*right_split))) + + +class SpecifierSet(BaseSpecifier): + def __init__(self, specifiers="", prereleases=None): + # Split on , to break each indidivual specifier into it's own item, and + # strip each item to remove leading/trailing whitespace. + specifiers = [s.strip() for s in specifiers.split(",") if s.strip()] + + # Parsed each individual specifier, attempting first to make it a + # Specifier and falling back to a LegacySpecifier. + parsed = set() + for specifier in specifiers: + try: + parsed.add(Specifier(specifier)) + except InvalidSpecifier: + parsed.add(LegacySpecifier(specifier)) + + # Turn our parsed specifiers into a frozen set and save them for later. + self._specs = frozenset(parsed) + + # Store our prereleases value so we can use it later to determine if + # we accept prereleases or not. + self._prereleases = prereleases + + def __repr__(self): + pre = ( + ", prereleases={0!r}".format(self.prereleases) + if self._prereleases is not None + else "" + ) + + return "".format(str(self), pre) + + def __str__(self): + return ",".join(sorted(str(s) for s in self._specs)) + + def __hash__(self): + return hash(self._specs) + + def __and__(self, other): + if isinstance(other, string_types): + other = SpecifierSet(other) + elif not isinstance(other, SpecifierSet): + return NotImplemented + + specifier = SpecifierSet() + specifier._specs = frozenset(self._specs | other._specs) + + if self._prereleases is None and other._prereleases is not None: + specifier._prereleases = other._prereleases + elif self._prereleases is not None and other._prereleases is None: + specifier._prereleases = self._prereleases + elif self._prereleases == other._prereleases: + specifier._prereleases = self._prereleases + else: + raise ValueError( + "Cannot combine SpecifierSets with True and False prerelease " + "overrides." + ) + + return specifier + + def __eq__(self, other): + if isinstance(other, string_types): + other = SpecifierSet(other) + elif isinstance(other, _IndividualSpecifier): + other = SpecifierSet(str(other)) + elif not isinstance(other, SpecifierSet): + return NotImplemented + + return self._specs == other._specs + + def __ne__(self, other): + if isinstance(other, string_types): + other = SpecifierSet(other) + elif isinstance(other, _IndividualSpecifier): + other = SpecifierSet(str(other)) + elif not isinstance(other, SpecifierSet): + return NotImplemented + + return self._specs != other._specs + + def __len__(self): + return len(self._specs) + + def __iter__(self): + return iter(self._specs) + + @property + def prereleases(self): + # If we have been given an explicit prerelease modifier, then we'll + # pass that through here. + if self._prereleases is not None: + return self._prereleases + + # If we don't have any specifiers, and we don't have a forced value, + # then we'll just return None since we don't know if this should have + # pre-releases or not. + if not self._specs: + return None + + # Otherwise we'll see if any of the given specifiers accept + # prereleases, if any of them do we'll return True, otherwise False. + return any(s.prereleases for s in self._specs) + + @prereleases.setter + def prereleases(self, value): + self._prereleases = value + + def __contains__(self, item): + return self.contains(item) + + def contains(self, item, prereleases=None): + # Ensure that our item is a Version or LegacyVersion instance. + if not isinstance(item, (LegacyVersion, Version)): + item = parse(item) + + # Determine if we're forcing a prerelease or not, if we're not forcing + # one for this particular filter call, then we'll use whatever the + # SpecifierSet thinks for whether or not we should support prereleases. + if prereleases is None: + prereleases = self.prereleases + + # We can determine if we're going to allow pre-releases by looking to + # see if any of the underlying items supports them. If none of them do + # and this item is a pre-release then we do not allow it and we can + # short circuit that here. + # Note: This means that 1.0.dev1 would not be contained in something + # like >=1.0.devabc however it would be in >=1.0.debabc,>0.0.dev0 + if not prereleases and item.is_prerelease: + return False + + # We simply dispatch to the underlying specs here to make sure that the + # given version is contained within all of them. + # Note: This use of all() here means that an empty set of specifiers + # will always return True, this is an explicit design decision. + return all(s.contains(item, prereleases=prereleases) for s in self._specs) + + def filter(self, iterable, prereleases=None): + # Determine if we're forcing a prerelease or not, if we're not forcing + # one for this particular filter call, then we'll use whatever the + # SpecifierSet thinks for whether or not we should support prereleases. + if prereleases is None: + prereleases = self.prereleases + + # If we have any specifiers, then we want to wrap our iterable in the + # filter method for each one, this will act as a logical AND amongst + # each specifier. + if self._specs: + for spec in self._specs: + iterable = spec.filter(iterable, prereleases=bool(prereleases)) + return iterable + # If we do not have any specifiers, then we need to have a rough filter + # which will filter out any pre-releases, unless there are no final + # releases, and which will filter out LegacyVersion in general. + else: + filtered = [] + found_prereleases = [] + + for item in iterable: + # Ensure that we some kind of Version class for this item. + if not isinstance(item, (LegacyVersion, Version)): + parsed_version = parse(item) + else: + parsed_version = item + + # Filter out any item which is parsed as a LegacyVersion + if isinstance(parsed_version, LegacyVersion): + continue + + # Store any item which is a pre-release for later unless we've + # already found a final version or we are accepting prereleases + if parsed_version.is_prerelease and not prereleases: + if not filtered: + found_prereleases.append(item) + else: + filtered.append(item) + + # If we've found no items except for pre-releases, then we'll go + # ahead and use the pre-releases + if not filtered and found_prereleases and prereleases is None: + return found_prereleases + + return filtered diff --git a/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/tags.py b/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/tags.py new file mode 100644 index 000000000..ec9942f0f --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/tags.py @@ -0,0 +1,404 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. + +from __future__ import absolute_import + +import distutils.util + +try: + from importlib.machinery import EXTENSION_SUFFIXES +except ImportError: # pragma: no cover + import imp + + EXTENSION_SUFFIXES = [x[0] for x in imp.get_suffixes()] + del imp +import platform +import re +import sys +import sysconfig +import warnings + + +INTERPRETER_SHORT_NAMES = { + "python": "py", # Generic. + "cpython": "cp", + "pypy": "pp", + "ironpython": "ip", + "jython": "jy", +} + + +_32_BIT_INTERPRETER = sys.maxsize <= 2 ** 32 + + +class Tag(object): + + __slots__ = ["_interpreter", "_abi", "_platform"] + + def __init__(self, interpreter, abi, platform): + self._interpreter = interpreter.lower() + self._abi = abi.lower() + self._platform = platform.lower() + + @property + def interpreter(self): + return self._interpreter + + @property + def abi(self): + return self._abi + + @property + def platform(self): + return self._platform + + def __eq__(self, other): + return ( + (self.platform == other.platform) + and (self.abi == other.abi) + and (self.interpreter == other.interpreter) + ) + + def __hash__(self): + return hash((self._interpreter, self._abi, self._platform)) + + def __str__(self): + return "{}-{}-{}".format(self._interpreter, self._abi, self._platform) + + def __repr__(self): + return "<{self} @ {self_id}>".format(self=self, self_id=id(self)) + + +def parse_tag(tag): + tags = set() + interpreters, abis, platforms = tag.split("-") + for interpreter in interpreters.split("."): + for abi in abis.split("."): + for platform_ in platforms.split("."): + tags.add(Tag(interpreter, abi, platform_)) + return frozenset(tags) + + +def _normalize_string(string): + return string.replace(".", "_").replace("-", "_") + + +def _cpython_interpreter(py_version): + # TODO: Is using py_version_nodot for interpreter version critical? + return "cp{major}{minor}".format(major=py_version[0], minor=py_version[1]) + + +def _cpython_abis(py_version): + abis = [] + version = "{}{}".format(*py_version[:2]) + debug = pymalloc = ucs4 = "" + with_debug = sysconfig.get_config_var("Py_DEBUG") + has_refcount = hasattr(sys, "gettotalrefcount") + # Windows doesn't set Py_DEBUG, so checking for support of debug-compiled + # extension modules is the best option. + # https://github.com/pypa/pip/issues/3383#issuecomment-173267692 + has_ext = "_d.pyd" in EXTENSION_SUFFIXES + if with_debug or (with_debug is None and (has_refcount or has_ext)): + debug = "d" + if py_version < (3, 8): + with_pymalloc = sysconfig.get_config_var("WITH_PYMALLOC") + if with_pymalloc or with_pymalloc is None: + pymalloc = "m" + if py_version < (3, 3): + unicode_size = sysconfig.get_config_var("Py_UNICODE_SIZE") + if unicode_size == 4 or ( + unicode_size is None and sys.maxunicode == 0x10FFFF + ): + ucs4 = "u" + elif debug: + # Debug builds can also load "normal" extension modules. + # We can also assume no UCS-4 or pymalloc requirement. + abis.append("cp{version}".format(version=version)) + abis.insert( + 0, + "cp{version}{debug}{pymalloc}{ucs4}".format( + version=version, debug=debug, pymalloc=pymalloc, ucs4=ucs4 + ), + ) + return abis + + +def _cpython_tags(py_version, interpreter, abis, platforms): + for abi in abis: + for platform_ in platforms: + yield Tag(interpreter, abi, platform_) + for tag in (Tag(interpreter, "abi3", platform_) for platform_ in platforms): + yield tag + for tag in (Tag(interpreter, "none", platform_) for platform_ in platforms): + yield tag + # PEP 384 was first implemented in Python 3.2. + for minor_version in range(py_version[1] - 1, 1, -1): + for platform_ in platforms: + interpreter = "cp{major}{minor}".format( + major=py_version[0], minor=minor_version + ) + yield Tag(interpreter, "abi3", platform_) + + +def _pypy_interpreter(): + return "pp{py_major}{pypy_major}{pypy_minor}".format( + py_major=sys.version_info[0], + pypy_major=sys.pypy_version_info.major, + pypy_minor=sys.pypy_version_info.minor, + ) + + +def _generic_abi(): + abi = sysconfig.get_config_var("SOABI") + if abi: + return _normalize_string(abi) + else: + return "none" + + +def _pypy_tags(py_version, interpreter, abi, platforms): + for tag in (Tag(interpreter, abi, platform) for platform in platforms): + yield tag + for tag in (Tag(interpreter, "none", platform) for platform in platforms): + yield tag + + +def _generic_tags(interpreter, py_version, abi, platforms): + for tag in (Tag(interpreter, abi, platform) for platform in platforms): + yield tag + if abi != "none": + tags = (Tag(interpreter, "none", platform_) for platform_ in platforms) + for tag in tags: + yield tag + + +def _py_interpreter_range(py_version): + """ + Yield Python versions in descending order. + + After the latest version, the major-only version will be yielded, and then + all following versions up to 'end'. + """ + yield "py{major}{minor}".format(major=py_version[0], minor=py_version[1]) + yield "py{major}".format(major=py_version[0]) + for minor in range(py_version[1] - 1, -1, -1): + yield "py{major}{minor}".format(major=py_version[0], minor=minor) + + +def _independent_tags(interpreter, py_version, platforms): + """ + Return the sequence of tags that are consistent across implementations. + + The tags consist of: + - py*-none- + - -none-any + - py*-none-any + """ + for version in _py_interpreter_range(py_version): + for platform_ in platforms: + yield Tag(version, "none", platform_) + yield Tag(interpreter, "none", "any") + for version in _py_interpreter_range(py_version): + yield Tag(version, "none", "any") + + +def _mac_arch(arch, is_32bit=_32_BIT_INTERPRETER): + if not is_32bit: + return arch + + if arch.startswith("ppc"): + return "ppc" + + return "i386" + + +def _mac_binary_formats(version, cpu_arch): + formats = [cpu_arch] + if cpu_arch == "x86_64": + if version < (10, 4): + return [] + formats.extend(["intel", "fat64", "fat32"]) + + elif cpu_arch == "i386": + if version < (10, 4): + return [] + formats.extend(["intel", "fat32", "fat"]) + + elif cpu_arch == "ppc64": + # TODO: Need to care about 32-bit PPC for ppc64 through 10.2? + if version > (10, 5) or version < (10, 4): + return [] + formats.append("fat64") + + elif cpu_arch == "ppc": + if version > (10, 6): + return [] + formats.extend(["fat32", "fat"]) + + formats.append("universal") + return formats + + +def _mac_platforms(version=None, arch=None): + version_str, _, cpu_arch = platform.mac_ver() + if version is None: + version = tuple(map(int, version_str.split(".")[:2])) + if arch is None: + arch = _mac_arch(cpu_arch) + platforms = [] + for minor_version in range(version[1], -1, -1): + compat_version = version[0], minor_version + binary_formats = _mac_binary_formats(compat_version, arch) + for binary_format in binary_formats: + platforms.append( + "macosx_{major}_{minor}_{binary_format}".format( + major=compat_version[0], + minor=compat_version[1], + binary_format=binary_format, + ) + ) + return platforms + + +# From PEP 513. +def _is_manylinux_compatible(name, glibc_version): + # Check for presence of _manylinux module. + try: + import _manylinux + + return bool(getattr(_manylinux, name + "_compatible")) + except (ImportError, AttributeError): + # Fall through to heuristic check below. + pass + + return _have_compatible_glibc(*glibc_version) + + +def _glibc_version_string(): + # Returns glibc version string, or None if not using glibc. + import ctypes + + # ctypes.CDLL(None) internally calls dlopen(NULL), and as the dlopen + # manpage says, "If filename is NULL, then the returned handle is for the + # main program". This way we can let the linker do the work to figure out + # which libc our process is actually using. + process_namespace = ctypes.CDLL(None) + try: + gnu_get_libc_version = process_namespace.gnu_get_libc_version + except AttributeError: + # Symbol doesn't exist -> therefore, we are not linked to + # glibc. + return None + + # Call gnu_get_libc_version, which returns a string like "2.5" + gnu_get_libc_version.restype = ctypes.c_char_p + version_str = gnu_get_libc_version() + # py2 / py3 compatibility: + if not isinstance(version_str, str): + version_str = version_str.decode("ascii") + + return version_str + + +# Separated out from have_compatible_glibc for easier unit testing. +def _check_glibc_version(version_str, required_major, minimum_minor): + # Parse string and check against requested version. + # + # We use a regexp instead of str.split because we want to discard any + # random junk that might come after the minor version -- this might happen + # in patched/forked versions of glibc (e.g. Linaro's version of glibc + # uses version strings like "2.20-2014.11"). See gh-3588. + m = re.match(r"(?P[0-9]+)\.(?P[0-9]+)", version_str) + if not m: + warnings.warn( + "Expected glibc version with 2 components major.minor," + " got: %s" % version_str, + RuntimeWarning, + ) + return False + return ( + int(m.group("major")) == required_major + and int(m.group("minor")) >= minimum_minor + ) + + +def _have_compatible_glibc(required_major, minimum_minor): + version_str = _glibc_version_string() + if version_str is None: + return False + return _check_glibc_version(version_str, required_major, minimum_minor) + + +def _linux_platforms(is_32bit=_32_BIT_INTERPRETER): + linux = _normalize_string(distutils.util.get_platform()) + if linux == "linux_x86_64" and is_32bit: + linux = "linux_i686" + manylinux_support = ( + ("manylinux2014", (2, 17)), # CentOS 7 w/ glibc 2.17 (PEP 599) + ("manylinux2010", (2, 12)), # CentOS 6 w/ glibc 2.12 (PEP 571) + ("manylinux1", (2, 5)), # CentOS 5 w/ glibc 2.5 (PEP 513) + ) + manylinux_support_iter = iter(manylinux_support) + for name, glibc_version in manylinux_support_iter: + if _is_manylinux_compatible(name, glibc_version): + platforms = [linux.replace("linux", name)] + break + else: + platforms = [] + # Support for a later manylinux implies support for an earlier version. + platforms += [linux.replace("linux", name) for name, _ in manylinux_support_iter] + platforms.append(linux) + return platforms + + +def _generic_platforms(): + platform = _normalize_string(distutils.util.get_platform()) + return [platform] + + +def _interpreter_name(): + name = platform.python_implementation().lower() + return INTERPRETER_SHORT_NAMES.get(name) or name + + +def _generic_interpreter(name, py_version): + version = sysconfig.get_config_var("py_version_nodot") + if not version: + version = "".join(map(str, py_version[:2])) + return "{name}{version}".format(name=name, version=version) + + +def sys_tags(): + """ + Returns the sequence of tag triples for the running interpreter. + + The order of the sequence corresponds to priority order for the + interpreter, from most to least important. + """ + py_version = sys.version_info[:2] + interpreter_name = _interpreter_name() + if platform.system() == "Darwin": + platforms = _mac_platforms() + elif platform.system() == "Linux": + platforms = _linux_platforms() + else: + platforms = _generic_platforms() + + if interpreter_name == "cp": + interpreter = _cpython_interpreter(py_version) + abis = _cpython_abis(py_version) + for tag in _cpython_tags(py_version, interpreter, abis, platforms): + yield tag + elif interpreter_name == "pp": + interpreter = _pypy_interpreter() + abi = _generic_abi() + for tag in _pypy_tags(py_version, interpreter, abi, platforms): + yield tag + else: + interpreter = _generic_interpreter(interpreter_name, py_version) + abi = _generic_abi() + for tag in _generic_tags(interpreter, py_version, abi, platforms): + yield tag + for tag in _independent_tags(interpreter, py_version, platforms): + yield tag diff --git a/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/utils.py b/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/utils.py new file mode 100644 index 000000000..884187869 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/utils.py @@ -0,0 +1,57 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. +from __future__ import absolute_import, division, print_function + +import re + +from .version import InvalidVersion, Version + + +_canonicalize_regex = re.compile(r"[-_.]+") + + +def canonicalize_name(name): + # This is taken from PEP 503. + return _canonicalize_regex.sub("-", name).lower() + + +def canonicalize_version(version): + """ + This is very similar to Version.__str__, but has one subtle differences + with the way it handles the release segment. + """ + + try: + version = Version(version) + except InvalidVersion: + # Legacy versions cannot be normalized + return version + + parts = [] + + # Epoch + if version.epoch != 0: + parts.append("{0}!".format(version.epoch)) + + # Release segment + # NB: This strips trailing '.0's to normalize + parts.append(re.sub(r"(\.0)+$", "", ".".join(str(x) for x in version.release))) + + # Pre-release + if version.pre is not None: + parts.append("".join(str(x) for x in version.pre)) + + # Post-release + if version.post is not None: + parts.append(".post{0}".format(version.post)) + + # Development release + if version.dev is not None: + parts.append(".dev{0}".format(version.dev)) + + # Local version segment + if version.local is not None: + parts.append("+{0}".format(version.local)) + + return "".join(parts) diff --git a/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/version.py b/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/version.py new file mode 100644 index 000000000..95157a1f7 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/version.py @@ -0,0 +1,420 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. +from __future__ import absolute_import, division, print_function + +import collections +import itertools +import re + +from ._structures import Infinity + + +__all__ = ["parse", "Version", "LegacyVersion", "InvalidVersion", "VERSION_PATTERN"] + + +_Version = collections.namedtuple( + "_Version", ["epoch", "release", "dev", "pre", "post", "local"] +) + + +def parse(version): + """ + Parse the given version string and return either a :class:`Version` object + or a :class:`LegacyVersion` object depending on if the given version is + a valid PEP 440 version or a legacy version. + """ + try: + return Version(version) + except InvalidVersion: + return LegacyVersion(version) + + +class InvalidVersion(ValueError): + """ + An invalid version was found, users should refer to PEP 440. + """ + + +class _BaseVersion(object): + def __hash__(self): + return hash(self._key) + + def __lt__(self, other): + return self._compare(other, lambda s, o: s < o) + + def __le__(self, other): + return self._compare(other, lambda s, o: s <= o) + + def __eq__(self, other): + return self._compare(other, lambda s, o: s == o) + + def __ge__(self, other): + return self._compare(other, lambda s, o: s >= o) + + def __gt__(self, other): + return self._compare(other, lambda s, o: s > o) + + def __ne__(self, other): + return self._compare(other, lambda s, o: s != o) + + def _compare(self, other, method): + if not isinstance(other, _BaseVersion): + return NotImplemented + + return method(self._key, other._key) + + +class LegacyVersion(_BaseVersion): + def __init__(self, version): + self._version = str(version) + self._key = _legacy_cmpkey(self._version) + + def __str__(self): + return self._version + + def __repr__(self): + return "".format(repr(str(self))) + + @property + def public(self): + return self._version + + @property + def base_version(self): + return self._version + + @property + def epoch(self): + return -1 + + @property + def release(self): + return None + + @property + def pre(self): + return None + + @property + def post(self): + return None + + @property + def dev(self): + return None + + @property + def local(self): + return None + + @property + def is_prerelease(self): + return False + + @property + def is_postrelease(self): + return False + + @property + def is_devrelease(self): + return False + + +_legacy_version_component_re = re.compile(r"(\d+ | [a-z]+ | \.| -)", re.VERBOSE) + +_legacy_version_replacement_map = { + "pre": "c", + "preview": "c", + "-": "final-", + "rc": "c", + "dev": "@", +} + + +def _parse_version_parts(s): + for part in _legacy_version_component_re.split(s): + part = _legacy_version_replacement_map.get(part, part) + + if not part or part == ".": + continue + + if part[:1] in "0123456789": + # pad for numeric comparison + yield part.zfill(8) + else: + yield "*" + part + + # ensure that alpha/beta/candidate are before final + yield "*final" + + +def _legacy_cmpkey(version): + # We hardcode an epoch of -1 here. A PEP 440 version can only have a epoch + # greater than or equal to 0. This will effectively put the LegacyVersion, + # which uses the defacto standard originally implemented by setuptools, + # as before all PEP 440 versions. + epoch = -1 + + # This scheme is taken from pkg_resources.parse_version setuptools prior to + # it's adoption of the packaging library. + parts = [] + for part in _parse_version_parts(version.lower()): + if part.startswith("*"): + # remove "-" before a prerelease tag + if part < "*final": + while parts and parts[-1] == "*final-": + parts.pop() + + # remove trailing zeros from each series of numeric parts + while parts and parts[-1] == "00000000": + parts.pop() + + parts.append(part) + parts = tuple(parts) + + return epoch, parts + + +# Deliberately not anchored to the start and end of the string, to make it +# easier for 3rd party code to reuse +VERSION_PATTERN = r""" + v? + (?: + (?:(?P[0-9]+)!)? # epoch + (?P[0-9]+(?:\.[0-9]+)*) # release segment + (?P
                                          # pre-release
+            [-_\.]?
+            (?P(a|b|c|rc|alpha|beta|pre|preview))
+            [-_\.]?
+            (?P[0-9]+)?
+        )?
+        (?P                                         # post release
+            (?:-(?P[0-9]+))
+            |
+            (?:
+                [-_\.]?
+                (?Ppost|rev|r)
+                [-_\.]?
+                (?P[0-9]+)?
+            )
+        )?
+        (?P                                          # dev release
+            [-_\.]?
+            (?Pdev)
+            [-_\.]?
+            (?P[0-9]+)?
+        )?
+    )
+    (?:\+(?P[a-z0-9]+(?:[-_\.][a-z0-9]+)*))?       # local version
+"""
+
+
+class Version(_BaseVersion):
+
+    _regex = re.compile(r"^\s*" + VERSION_PATTERN + r"\s*$", re.VERBOSE | re.IGNORECASE)
+
+    def __init__(self, version):
+        # Validate the version and parse it into pieces
+        match = self._regex.search(version)
+        if not match:
+            raise InvalidVersion("Invalid version: '{0}'".format(version))
+
+        # Store the parsed out pieces of the version
+        self._version = _Version(
+            epoch=int(match.group("epoch")) if match.group("epoch") else 0,
+            release=tuple(int(i) for i in match.group("release").split(".")),
+            pre=_parse_letter_version(match.group("pre_l"), match.group("pre_n")),
+            post=_parse_letter_version(
+                match.group("post_l"), match.group("post_n1") or match.group("post_n2")
+            ),
+            dev=_parse_letter_version(match.group("dev_l"), match.group("dev_n")),
+            local=_parse_local_version(match.group("local")),
+        )
+
+        # Generate a key which will be used for sorting
+        self._key = _cmpkey(
+            self._version.epoch,
+            self._version.release,
+            self._version.pre,
+            self._version.post,
+            self._version.dev,
+            self._version.local,
+        )
+
+    def __repr__(self):
+        return "".format(repr(str(self)))
+
+    def __str__(self):
+        parts = []
+
+        # Epoch
+        if self.epoch != 0:
+            parts.append("{0}!".format(self.epoch))
+
+        # Release segment
+        parts.append(".".join(str(x) for x in self.release))
+
+        # Pre-release
+        if self.pre is not None:
+            parts.append("".join(str(x) for x in self.pre))
+
+        # Post-release
+        if self.post is not None:
+            parts.append(".post{0}".format(self.post))
+
+        # Development release
+        if self.dev is not None:
+            parts.append(".dev{0}".format(self.dev))
+
+        # Local version segment
+        if self.local is not None:
+            parts.append("+{0}".format(self.local))
+
+        return "".join(parts)
+
+    @property
+    def epoch(self):
+        return self._version.epoch
+
+    @property
+    def release(self):
+        return self._version.release
+
+    @property
+    def pre(self):
+        return self._version.pre
+
+    @property
+    def post(self):
+        return self._version.post[1] if self._version.post else None
+
+    @property
+    def dev(self):
+        return self._version.dev[1] if self._version.dev else None
+
+    @property
+    def local(self):
+        if self._version.local:
+            return ".".join(str(x) for x in self._version.local)
+        else:
+            return None
+
+    @property
+    def public(self):
+        return str(self).split("+", 1)[0]
+
+    @property
+    def base_version(self):
+        parts = []
+
+        # Epoch
+        if self.epoch != 0:
+            parts.append("{0}!".format(self.epoch))
+
+        # Release segment
+        parts.append(".".join(str(x) for x in self.release))
+
+        return "".join(parts)
+
+    @property
+    def is_prerelease(self):
+        return self.dev is not None or self.pre is not None
+
+    @property
+    def is_postrelease(self):
+        return self.post is not None
+
+    @property
+    def is_devrelease(self):
+        return self.dev is not None
+
+
+def _parse_letter_version(letter, number):
+    if letter:
+        # We consider there to be an implicit 0 in a pre-release if there is
+        # not a numeral associated with it.
+        if number is None:
+            number = 0
+
+        # We normalize any letters to their lower case form
+        letter = letter.lower()
+
+        # We consider some words to be alternate spellings of other words and
+        # in those cases we want to normalize the spellings to our preferred
+        # spelling.
+        if letter == "alpha":
+            letter = "a"
+        elif letter == "beta":
+            letter = "b"
+        elif letter in ["c", "pre", "preview"]:
+            letter = "rc"
+        elif letter in ["rev", "r"]:
+            letter = "post"
+
+        return letter, int(number)
+    if not letter and number:
+        # We assume if we are given a number, but we are not given a letter
+        # then this is using the implicit post release syntax (e.g. 1.0-1)
+        letter = "post"
+
+        return letter, int(number)
+
+
+_local_version_separators = re.compile(r"[\._-]")
+
+
+def _parse_local_version(local):
+    """
+    Takes a string like abc.1.twelve and turns it into ("abc", 1, "twelve").
+    """
+    if local is not None:
+        return tuple(
+            part.lower() if not part.isdigit() else int(part)
+            for part in _local_version_separators.split(local)
+        )
+
+
+def _cmpkey(epoch, release, pre, post, dev, local):
+    # When we compare a release version, we want to compare it with all of the
+    # trailing zeros removed. So we'll use a reverse the list, drop all the now
+    # leading zeros until we come to something non zero, then take the rest
+    # re-reverse it back into the correct order and make it a tuple and use
+    # that for our sorting key.
+    release = tuple(
+        reversed(list(itertools.dropwhile(lambda x: x == 0, reversed(release))))
+    )
+
+    # We need to "trick" the sorting algorithm to put 1.0.dev0 before 1.0a0.
+    # We'll do this by abusing the pre segment, but we _only_ want to do this
+    # if there is not a pre or a post segment. If we have one of those then
+    # the normal sorting rules will handle this case correctly.
+    if pre is None and post is None and dev is not None:
+        pre = -Infinity
+    # Versions without a pre-release (except as noted above) should sort after
+    # those with one.
+    elif pre is None:
+        pre = Infinity
+
+    # Versions without a post segment should sort before those with one.
+    if post is None:
+        post = -Infinity
+
+    # Versions without a development segment should sort after those with one.
+    if dev is None:
+        dev = Infinity
+
+    if local is None:
+        # Versions without a local segment should sort before those with one.
+        local = -Infinity
+    else:
+        # Versions with a local segment need that segment parsed to implement
+        # the sorting rules in PEP440.
+        # - Alpha numeric segments sort before numeric segments
+        # - Alpha numeric segments sort lexicographically
+        # - Numeric segments sort numerically
+        # - Shorter versions sort before longer versions when the prefixes
+        #   match exactly
+        local = tuple((i, "") if isinstance(i, int) else (-Infinity, i) for i in local)
+
+    return epoch, release, pre, post, dev, local
diff --git a/venv/lib/python3.8/site-packages/setuptools/_vendor/pyparsing.py b/venv/lib/python3.8/site-packages/setuptools/_vendor/pyparsing.py
new file mode 100644
index 000000000..cf75e1e5f
--- /dev/null
+++ b/venv/lib/python3.8/site-packages/setuptools/_vendor/pyparsing.py
@@ -0,0 +1,5742 @@
+# module pyparsing.py
+#
+# Copyright (c) 2003-2018  Paul T. McGuire
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+# IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+# CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+# TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+# SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#
+
+__doc__ = \
+"""
+pyparsing module - Classes and methods to define and execute parsing grammars
+=============================================================================
+
+The pyparsing module is an alternative approach to creating and executing simple grammars,
+vs. the traditional lex/yacc approach, or the use of regular expressions.  With pyparsing, you
+don't need to learn a new syntax for defining grammars or matching expressions - the parsing module
+provides a library of classes that you use to construct the grammar directly in Python.
+
+Here is a program to parse "Hello, World!" (or any greeting of the form 
+C{", !"}), built up using L{Word}, L{Literal}, and L{And} elements 
+(L{'+'} operator gives L{And} expressions, strings are auto-converted to
+L{Literal} expressions)::
+
+    from pyparsing import Word, alphas
+
+    # define grammar of a greeting
+    greet = Word(alphas) + "," + Word(alphas) + "!"
+
+    hello = "Hello, World!"
+    print (hello, "->", greet.parseString(hello))
+
+The program outputs the following::
+
+    Hello, World! -> ['Hello', ',', 'World', '!']
+
+The Python representation of the grammar is quite readable, owing to the self-explanatory
+class names, and the use of '+', '|' and '^' operators.
+
+The L{ParseResults} object returned from L{ParserElement.parseString} can be accessed as a nested list, a dictionary, or an
+object with named attributes.
+
+The pyparsing module handles some of the problems that are typically vexing when writing text parsers:
+ - extra or missing whitespace (the above program will also handle "Hello,World!", "Hello  ,  World  !", etc.)
+ - quoted strings
+ - embedded comments
+
+
+Getting Started -
+-----------------
+Visit the classes L{ParserElement} and L{ParseResults} to see the base classes that most other pyparsing
+classes inherit from. Use the docstrings for examples of how to:
+ - construct literal match expressions from L{Literal} and L{CaselessLiteral} classes
+ - construct character word-group expressions using the L{Word} class
+ - see how to create repetitive expressions using L{ZeroOrMore} and L{OneOrMore} classes
+ - use L{'+'}, L{'|'}, L{'^'}, and L{'&'} operators to combine simple expressions into more complex ones
+ - associate names with your parsed results using L{ParserElement.setResultsName}
+ - find some helpful expression short-cuts like L{delimitedList} and L{oneOf}
+ - find more useful common expressions in the L{pyparsing_common} namespace class
+"""
+
+__version__ = "2.2.1"
+__versionTime__ = "18 Sep 2018 00:49 UTC"
+__author__ = "Paul McGuire "
+
+import string
+from weakref import ref as wkref
+import copy
+import sys
+import warnings
+import re
+import sre_constants
+import collections
+import pprint
+import traceback
+import types
+from datetime import datetime
+
+try:
+    from _thread import RLock
+except ImportError:
+    from threading import RLock
+
+try:
+    # Python 3
+    from collections.abc import Iterable
+    from collections.abc import MutableMapping
+except ImportError:
+    # Python 2.7
+    from collections import Iterable
+    from collections import MutableMapping
+
+try:
+    from collections import OrderedDict as _OrderedDict
+except ImportError:
+    try:
+        from ordereddict import OrderedDict as _OrderedDict
+    except ImportError:
+        _OrderedDict = None
+
+#~ sys.stderr.write( "testing pyparsing module, version %s, %s\n" % (__version__,__versionTime__ ) )
+
+__all__ = [
+'And', 'CaselessKeyword', 'CaselessLiteral', 'CharsNotIn', 'Combine', 'Dict', 'Each', 'Empty',
+'FollowedBy', 'Forward', 'GoToColumn', 'Group', 'Keyword', 'LineEnd', 'LineStart', 'Literal',
+'MatchFirst', 'NoMatch', 'NotAny', 'OneOrMore', 'OnlyOnce', 'Optional', 'Or',
+'ParseBaseException', 'ParseElementEnhance', 'ParseException', 'ParseExpression', 'ParseFatalException',
+'ParseResults', 'ParseSyntaxException', 'ParserElement', 'QuotedString', 'RecursiveGrammarException',
+'Regex', 'SkipTo', 'StringEnd', 'StringStart', 'Suppress', 'Token', 'TokenConverter', 
+'White', 'Word', 'WordEnd', 'WordStart', 'ZeroOrMore',
+'alphanums', 'alphas', 'alphas8bit', 'anyCloseTag', 'anyOpenTag', 'cStyleComment', 'col',
+'commaSeparatedList', 'commonHTMLEntity', 'countedArray', 'cppStyleComment', 'dblQuotedString',
+'dblSlashComment', 'delimitedList', 'dictOf', 'downcaseTokens', 'empty', 'hexnums',
+'htmlComment', 'javaStyleComment', 'line', 'lineEnd', 'lineStart', 'lineno',
+'makeHTMLTags', 'makeXMLTags', 'matchOnlyAtCol', 'matchPreviousExpr', 'matchPreviousLiteral',
+'nestedExpr', 'nullDebugAction', 'nums', 'oneOf', 'opAssoc', 'operatorPrecedence', 'printables',
+'punc8bit', 'pythonStyleComment', 'quotedString', 'removeQuotes', 'replaceHTMLEntity', 
+'replaceWith', 'restOfLine', 'sglQuotedString', 'srange', 'stringEnd',
+'stringStart', 'traceParseAction', 'unicodeString', 'upcaseTokens', 'withAttribute',
+'indentedBlock', 'originalTextFor', 'ungroup', 'infixNotation','locatedExpr', 'withClass',
+'CloseMatch', 'tokenMap', 'pyparsing_common',
+]
+
+system_version = tuple(sys.version_info)[:3]
+PY_3 = system_version[0] == 3
+if PY_3:
+    _MAX_INT = sys.maxsize
+    basestring = str
+    unichr = chr
+    _ustr = str
+
+    # build list of single arg builtins, that can be used as parse actions
+    singleArgBuiltins = [sum, len, sorted, reversed, list, tuple, set, any, all, min, max]
+
+else:
+    _MAX_INT = sys.maxint
+    range = xrange
+
+    def _ustr(obj):
+        """Drop-in replacement for str(obj) that tries to be Unicode friendly. It first tries
+           str(obj). If that fails with a UnicodeEncodeError, then it tries unicode(obj). It
+           then < returns the unicode object | encodes it with the default encoding | ... >.
+        """
+        if isinstance(obj,unicode):
+            return obj
+
+        try:
+            # If this works, then _ustr(obj) has the same behaviour as str(obj), so
+            # it won't break any existing code.
+            return str(obj)
+
+        except UnicodeEncodeError:
+            # Else encode it
+            ret = unicode(obj).encode(sys.getdefaultencoding(), 'xmlcharrefreplace')
+            xmlcharref = Regex(r'&#\d+;')
+            xmlcharref.setParseAction(lambda t: '\\u' + hex(int(t[0][2:-1]))[2:])
+            return xmlcharref.transformString(ret)
+
+    # build list of single arg builtins, tolerant of Python version, that can be used as parse actions
+    singleArgBuiltins = []
+    import __builtin__
+    for fname in "sum len sorted reversed list tuple set any all min max".split():
+        try:
+            singleArgBuiltins.append(getattr(__builtin__,fname))
+        except AttributeError:
+            continue
+            
+_generatorType = type((y for y in range(1)))
+ 
+def _xml_escape(data):
+    """Escape &, <, >, ", ', etc. in a string of data."""
+
+    # ampersand must be replaced first
+    from_symbols = '&><"\''
+    to_symbols = ('&'+s+';' for s in "amp gt lt quot apos".split())
+    for from_,to_ in zip(from_symbols, to_symbols):
+        data = data.replace(from_, to_)
+    return data
+
+class _Constants(object):
+    pass
+
+alphas     = string.ascii_uppercase + string.ascii_lowercase
+nums       = "0123456789"
+hexnums    = nums + "ABCDEFabcdef"
+alphanums  = alphas + nums
+_bslash    = chr(92)
+printables = "".join(c for c in string.printable if c not in string.whitespace)
+
+class ParseBaseException(Exception):
+    """base exception class for all parsing runtime exceptions"""
+    # Performance tuning: we construct a *lot* of these, so keep this
+    # constructor as small and fast as possible
+    def __init__( self, pstr, loc=0, msg=None, elem=None ):
+        self.loc = loc
+        if msg is None:
+            self.msg = pstr
+            self.pstr = ""
+        else:
+            self.msg = msg
+            self.pstr = pstr
+        self.parserElement = elem
+        self.args = (pstr, loc, msg)
+
+    @classmethod
+    def _from_exception(cls, pe):
+        """
+        internal factory method to simplify creating one type of ParseException 
+        from another - avoids having __init__ signature conflicts among subclasses
+        """
+        return cls(pe.pstr, pe.loc, pe.msg, pe.parserElement)
+
+    def __getattr__( self, aname ):
+        """supported attributes by name are:
+            - lineno - returns the line number of the exception text
+            - col - returns the column number of the exception text
+            - line - returns the line containing the exception text
+        """
+        if( aname == "lineno" ):
+            return lineno( self.loc, self.pstr )
+        elif( aname in ("col", "column") ):
+            return col( self.loc, self.pstr )
+        elif( aname == "line" ):
+            return line( self.loc, self.pstr )
+        else:
+            raise AttributeError(aname)
+
+    def __str__( self ):
+        return "%s (at char %d), (line:%d, col:%d)" % \
+                ( self.msg, self.loc, self.lineno, self.column )
+    def __repr__( self ):
+        return _ustr(self)
+    def markInputline( self, markerString = ">!<" ):
+        """Extracts the exception line from the input string, and marks
+           the location of the exception with a special symbol.
+        """
+        line_str = self.line
+        line_column = self.column - 1
+        if markerString:
+            line_str = "".join((line_str[:line_column],
+                                markerString, line_str[line_column:]))
+        return line_str.strip()
+    def __dir__(self):
+        return "lineno col line".split() + dir(type(self))
+
+class ParseException(ParseBaseException):
+    """
+    Exception thrown when parse expressions don't match class;
+    supported attributes by name are:
+     - lineno - returns the line number of the exception text
+     - col - returns the column number of the exception text
+     - line - returns the line containing the exception text
+        
+    Example::
+        try:
+            Word(nums).setName("integer").parseString("ABC")
+        except ParseException as pe:
+            print(pe)
+            print("column: {}".format(pe.col))
+            
+    prints::
+       Expected integer (at char 0), (line:1, col:1)
+        column: 1
+    """
+    pass
+
+class ParseFatalException(ParseBaseException):
+    """user-throwable exception thrown when inconsistent parse content
+       is found; stops all parsing immediately"""
+    pass
+
+class ParseSyntaxException(ParseFatalException):
+    """just like L{ParseFatalException}, but thrown internally when an
+       L{ErrorStop} ('-' operator) indicates that parsing is to stop 
+       immediately because an unbacktrackable syntax error has been found"""
+    pass
+
+#~ class ReparseException(ParseBaseException):
+    #~ """Experimental class - parse actions can raise this exception to cause
+       #~ pyparsing to reparse the input string:
+        #~ - with a modified input string, and/or
+        #~ - with a modified start location
+       #~ Set the values of the ReparseException in the constructor, and raise the
+       #~ exception in a parse action to cause pyparsing to use the new string/location.
+       #~ Setting the values as None causes no change to be made.
+       #~ """
+    #~ def __init_( self, newstring, restartLoc ):
+        #~ self.newParseText = newstring
+        #~ self.reparseLoc = restartLoc
+
+class RecursiveGrammarException(Exception):
+    """exception thrown by L{ParserElement.validate} if the grammar could be improperly recursive"""
+    def __init__( self, parseElementList ):
+        self.parseElementTrace = parseElementList
+
+    def __str__( self ):
+        return "RecursiveGrammarException: %s" % self.parseElementTrace
+
+class _ParseResultsWithOffset(object):
+    def __init__(self,p1,p2):
+        self.tup = (p1,p2)
+    def __getitem__(self,i):
+        return self.tup[i]
+    def __repr__(self):
+        return repr(self.tup[0])
+    def setOffset(self,i):
+        self.tup = (self.tup[0],i)
+
+class ParseResults(object):
+    """
+    Structured parse results, to provide multiple means of access to the parsed data:
+       - as a list (C{len(results)})
+       - by list index (C{results[0], results[1]}, etc.)
+       - by attribute (C{results.} - see L{ParserElement.setResultsName})
+
+    Example::
+        integer = Word(nums)
+        date_str = (integer.setResultsName("year") + '/' 
+                        + integer.setResultsName("month") + '/' 
+                        + integer.setResultsName("day"))
+        # equivalent form:
+        # date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
+
+        # parseString returns a ParseResults object
+        result = date_str.parseString("1999/12/31")
+
+        def test(s, fn=repr):
+            print("%s -> %s" % (s, fn(eval(s))))
+        test("list(result)")
+        test("result[0]")
+        test("result['month']")
+        test("result.day")
+        test("'month' in result")
+        test("'minutes' in result")
+        test("result.dump()", str)
+    prints::
+        list(result) -> ['1999', '/', '12', '/', '31']
+        result[0] -> '1999'
+        result['month'] -> '12'
+        result.day -> '31'
+        'month' in result -> True
+        'minutes' in result -> False
+        result.dump() -> ['1999', '/', '12', '/', '31']
+        - day: 31
+        - month: 12
+        - year: 1999
+    """
+    def __new__(cls, toklist=None, name=None, asList=True, modal=True ):
+        if isinstance(toklist, cls):
+            return toklist
+        retobj = object.__new__(cls)
+        retobj.__doinit = True
+        return retobj
+
+    # Performance tuning: we construct a *lot* of these, so keep this
+    # constructor as small and fast as possible
+    def __init__( self, toklist=None, name=None, asList=True, modal=True, isinstance=isinstance ):
+        if self.__doinit:
+            self.__doinit = False
+            self.__name = None
+            self.__parent = None
+            self.__accumNames = {}
+            self.__asList = asList
+            self.__modal = modal
+            if toklist is None:
+                toklist = []
+            if isinstance(toklist, list):
+                self.__toklist = toklist[:]
+            elif isinstance(toklist, _generatorType):
+                self.__toklist = list(toklist)
+            else:
+                self.__toklist = [toklist]
+            self.__tokdict = dict()
+
+        if name is not None and name:
+            if not modal:
+                self.__accumNames[name] = 0
+            if isinstance(name,int):
+                name = _ustr(name) # will always return a str, but use _ustr for consistency
+            self.__name = name
+            if not (isinstance(toklist, (type(None), basestring, list)) and toklist in (None,'',[])):
+                if isinstance(toklist,basestring):
+                    toklist = [ toklist ]
+                if asList:
+                    if isinstance(toklist,ParseResults):
+                        self[name] = _ParseResultsWithOffset(toklist.copy(),0)
+                    else:
+                        self[name] = _ParseResultsWithOffset(ParseResults(toklist[0]),0)
+                    self[name].__name = name
+                else:
+                    try:
+                        self[name] = toklist[0]
+                    except (KeyError,TypeError,IndexError):
+                        self[name] = toklist
+
+    def __getitem__( self, i ):
+        if isinstance( i, (int,slice) ):
+            return self.__toklist[i]
+        else:
+            if i not in self.__accumNames:
+                return self.__tokdict[i][-1][0]
+            else:
+                return ParseResults([ v[0] for v in self.__tokdict[i] ])
+
+    def __setitem__( self, k, v, isinstance=isinstance ):
+        if isinstance(v,_ParseResultsWithOffset):
+            self.__tokdict[k] = self.__tokdict.get(k,list()) + [v]
+            sub = v[0]
+        elif isinstance(k,(int,slice)):
+            self.__toklist[k] = v
+            sub = v
+        else:
+            self.__tokdict[k] = self.__tokdict.get(k,list()) + [_ParseResultsWithOffset(v,0)]
+            sub = v
+        if isinstance(sub,ParseResults):
+            sub.__parent = wkref(self)
+
+    def __delitem__( self, i ):
+        if isinstance(i,(int,slice)):
+            mylen = len( self.__toklist )
+            del self.__toklist[i]
+
+            # convert int to slice
+            if isinstance(i, int):
+                if i < 0:
+                    i += mylen
+                i = slice(i, i+1)
+            # get removed indices
+            removed = list(range(*i.indices(mylen)))
+            removed.reverse()
+            # fixup indices in token dictionary
+            for name,occurrences in self.__tokdict.items():
+                for j in removed:
+                    for k, (value, position) in enumerate(occurrences):
+                        occurrences[k] = _ParseResultsWithOffset(value, position - (position > j))
+        else:
+            del self.__tokdict[i]
+
+    def __contains__( self, k ):
+        return k in self.__tokdict
+
+    def __len__( self ): return len( self.__toklist )
+    def __bool__(self): return ( not not self.__toklist )
+    __nonzero__ = __bool__
+    def __iter__( self ): return iter( self.__toklist )
+    def __reversed__( self ): return iter( self.__toklist[::-1] )
+    def _iterkeys( self ):
+        if hasattr(self.__tokdict, "iterkeys"):
+            return self.__tokdict.iterkeys()
+        else:
+            return iter(self.__tokdict)
+
+    def _itervalues( self ):
+        return (self[k] for k in self._iterkeys())
+            
+    def _iteritems( self ):
+        return ((k, self[k]) for k in self._iterkeys())
+
+    if PY_3:
+        keys = _iterkeys       
+        """Returns an iterator of all named result keys (Python 3.x only)."""
+
+        values = _itervalues
+        """Returns an iterator of all named result values (Python 3.x only)."""
+
+        items = _iteritems
+        """Returns an iterator of all named result key-value tuples (Python 3.x only)."""
+
+    else:
+        iterkeys = _iterkeys
+        """Returns an iterator of all named result keys (Python 2.x only)."""
+
+        itervalues = _itervalues
+        """Returns an iterator of all named result values (Python 2.x only)."""
+
+        iteritems = _iteritems
+        """Returns an iterator of all named result key-value tuples (Python 2.x only)."""
+
+        def keys( self ):
+            """Returns all named result keys (as a list in Python 2.x, as an iterator in Python 3.x)."""
+            return list(self.iterkeys())
+
+        def values( self ):
+            """Returns all named result values (as a list in Python 2.x, as an iterator in Python 3.x)."""
+            return list(self.itervalues())
+                
+        def items( self ):
+            """Returns all named result key-values (as a list of tuples in Python 2.x, as an iterator in Python 3.x)."""
+            return list(self.iteritems())
+
+    def haskeys( self ):
+        """Since keys() returns an iterator, this method is helpful in bypassing
+           code that looks for the existence of any defined results names."""
+        return bool(self.__tokdict)
+        
+    def pop( self, *args, **kwargs):
+        """
+        Removes and returns item at specified index (default=C{last}).
+        Supports both C{list} and C{dict} semantics for C{pop()}. If passed no
+        argument or an integer argument, it will use C{list} semantics
+        and pop tokens from the list of parsed tokens. If passed a 
+        non-integer argument (most likely a string), it will use C{dict}
+        semantics and pop the corresponding value from any defined 
+        results names. A second default return value argument is 
+        supported, just as in C{dict.pop()}.
+
+        Example::
+            def remove_first(tokens):
+                tokens.pop(0)
+            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']
+            print(OneOrMore(Word(nums)).addParseAction(remove_first).parseString("0 123 321")) # -> ['123', '321']
+
+            label = Word(alphas)
+            patt = label("LABEL") + OneOrMore(Word(nums))
+            print(patt.parseString("AAB 123 321").dump())
+
+            # Use pop() in a parse action to remove named result (note that corresponding value is not
+            # removed from list form of results)
+            def remove_LABEL(tokens):
+                tokens.pop("LABEL")
+                return tokens
+            patt.addParseAction(remove_LABEL)
+            print(patt.parseString("AAB 123 321").dump())
+        prints::
+            ['AAB', '123', '321']
+            - LABEL: AAB
+
+            ['AAB', '123', '321']
+        """
+        if not args:
+            args = [-1]
+        for k,v in kwargs.items():
+            if k == 'default':
+                args = (args[0], v)
+            else:
+                raise TypeError("pop() got an unexpected keyword argument '%s'" % k)
+        if (isinstance(args[0], int) or 
+                        len(args) == 1 or 
+                        args[0] in self):
+            index = args[0]
+            ret = self[index]
+            del self[index]
+            return ret
+        else:
+            defaultvalue = args[1]
+            return defaultvalue
+
+    def get(self, key, defaultValue=None):
+        """
+        Returns named result matching the given key, or if there is no
+        such name, then returns the given C{defaultValue} or C{None} if no
+        C{defaultValue} is specified.
+
+        Similar to C{dict.get()}.
+        
+        Example::
+            integer = Word(nums)
+            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")           
+
+            result = date_str.parseString("1999/12/31")
+            print(result.get("year")) # -> '1999'
+            print(result.get("hour", "not specified")) # -> 'not specified'
+            print(result.get("hour")) # -> None
+        """
+        if key in self:
+            return self[key]
+        else:
+            return defaultValue
+
+    def insert( self, index, insStr ):
+        """
+        Inserts new element at location index in the list of parsed tokens.
+        
+        Similar to C{list.insert()}.
+
+        Example::
+            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']
+
+            # use a parse action to insert the parse location in the front of the parsed results
+            def insert_locn(locn, tokens):
+                tokens.insert(0, locn)
+            print(OneOrMore(Word(nums)).addParseAction(insert_locn).parseString("0 123 321")) # -> [0, '0', '123', '321']
+        """
+        self.__toklist.insert(index, insStr)
+        # fixup indices in token dictionary
+        for name,occurrences in self.__tokdict.items():
+            for k, (value, position) in enumerate(occurrences):
+                occurrences[k] = _ParseResultsWithOffset(value, position + (position > index))
+
+    def append( self, item ):
+        """
+        Add single element to end of ParseResults list of elements.
+
+        Example::
+            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']
+            
+            # use a parse action to compute the sum of the parsed integers, and add it to the end
+            def append_sum(tokens):
+                tokens.append(sum(map(int, tokens)))
+            print(OneOrMore(Word(nums)).addParseAction(append_sum).parseString("0 123 321")) # -> ['0', '123', '321', 444]
+        """
+        self.__toklist.append(item)
+
+    def extend( self, itemseq ):
+        """
+        Add sequence of elements to end of ParseResults list of elements.
+
+        Example::
+            patt = OneOrMore(Word(alphas))
+            
+            # use a parse action to append the reverse of the matched strings, to make a palindrome
+            def make_palindrome(tokens):
+                tokens.extend(reversed([t[::-1] for t in tokens]))
+                return ''.join(tokens)
+            print(patt.addParseAction(make_palindrome).parseString("lskdj sdlkjf lksd")) # -> 'lskdjsdlkjflksddsklfjkldsjdksl'
+        """
+        if isinstance(itemseq, ParseResults):
+            self += itemseq
+        else:
+            self.__toklist.extend(itemseq)
+
+    def clear( self ):
+        """
+        Clear all elements and results names.
+        """
+        del self.__toklist[:]
+        self.__tokdict.clear()
+
+    def __getattr__( self, name ):
+        try:
+            return self[name]
+        except KeyError:
+            return ""
+            
+        if name in self.__tokdict:
+            if name not in self.__accumNames:
+                return self.__tokdict[name][-1][0]
+            else:
+                return ParseResults([ v[0] for v in self.__tokdict[name] ])
+        else:
+            return ""
+
+    def __add__( self, other ):
+        ret = self.copy()
+        ret += other
+        return ret
+
+    def __iadd__( self, other ):
+        if other.__tokdict:
+            offset = len(self.__toklist)
+            addoffset = lambda a: offset if a<0 else a+offset
+            otheritems = other.__tokdict.items()
+            otherdictitems = [(k, _ParseResultsWithOffset(v[0],addoffset(v[1])) )
+                                for (k,vlist) in otheritems for v in vlist]
+            for k,v in otherdictitems:
+                self[k] = v
+                if isinstance(v[0],ParseResults):
+                    v[0].__parent = wkref(self)
+            
+        self.__toklist += other.__toklist
+        self.__accumNames.update( other.__accumNames )
+        return self
+
+    def __radd__(self, other):
+        if isinstance(other,int) and other == 0:
+            # useful for merging many ParseResults using sum() builtin
+            return self.copy()
+        else:
+            # this may raise a TypeError - so be it
+            return other + self
+        
+    def __repr__( self ):
+        return "(%s, %s)" % ( repr( self.__toklist ), repr( self.__tokdict ) )
+
+    def __str__( self ):
+        return '[' + ', '.join(_ustr(i) if isinstance(i, ParseResults) else repr(i) for i in self.__toklist) + ']'
+
+    def _asStringList( self, sep='' ):
+        out = []
+        for item in self.__toklist:
+            if out and sep:
+                out.append(sep)
+            if isinstance( item, ParseResults ):
+                out += item._asStringList()
+            else:
+                out.append( _ustr(item) )
+        return out
+
+    def asList( self ):
+        """
+        Returns the parse results as a nested list of matching tokens, all converted to strings.
+
+        Example::
+            patt = OneOrMore(Word(alphas))
+            result = patt.parseString("sldkj lsdkj sldkj")
+            # even though the result prints in string-like form, it is actually a pyparsing ParseResults
+            print(type(result), result) # ->  ['sldkj', 'lsdkj', 'sldkj']
+            
+            # Use asList() to create an actual list
+            result_list = result.asList()
+            print(type(result_list), result_list) # ->  ['sldkj', 'lsdkj', 'sldkj']
+        """
+        return [res.asList() if isinstance(res,ParseResults) else res for res in self.__toklist]
+
+    def asDict( self ):
+        """
+        Returns the named parse results as a nested dictionary.
+
+        Example::
+            integer = Word(nums)
+            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
+            
+            result = date_str.parseString('12/31/1999')
+            print(type(result), repr(result)) # ->  (['12', '/', '31', '/', '1999'], {'day': [('1999', 4)], 'year': [('12', 0)], 'month': [('31', 2)]})
+            
+            result_dict = result.asDict()
+            print(type(result_dict), repr(result_dict)) # ->  {'day': '1999', 'year': '12', 'month': '31'}
+
+            # even though a ParseResults supports dict-like access, sometime you just need to have a dict
+            import json
+            print(json.dumps(result)) # -> Exception: TypeError: ... is not JSON serializable
+            print(json.dumps(result.asDict())) # -> {"month": "31", "day": "1999", "year": "12"}
+        """
+        if PY_3:
+            item_fn = self.items
+        else:
+            item_fn = self.iteritems
+            
+        def toItem(obj):
+            if isinstance(obj, ParseResults):
+                if obj.haskeys():
+                    return obj.asDict()
+                else:
+                    return [toItem(v) for v in obj]
+            else:
+                return obj
+                
+        return dict((k,toItem(v)) for k,v in item_fn())
+
+    def copy( self ):
+        """
+        Returns a new copy of a C{ParseResults} object.
+        """
+        ret = ParseResults( self.__toklist )
+        ret.__tokdict = self.__tokdict.copy()
+        ret.__parent = self.__parent
+        ret.__accumNames.update( self.__accumNames )
+        ret.__name = self.__name
+        return ret
+
+    def asXML( self, doctag=None, namedItemsOnly=False, indent="", formatted=True ):
+        """
+        (Deprecated) Returns the parse results as XML. Tags are created for tokens and lists that have defined results names.
+        """
+        nl = "\n"
+        out = []
+        namedItems = dict((v[1],k) for (k,vlist) in self.__tokdict.items()
+                                                            for v in vlist)
+        nextLevelIndent = indent + "  "
+
+        # collapse out indents if formatting is not desired
+        if not formatted:
+            indent = ""
+            nextLevelIndent = ""
+            nl = ""
+
+        selfTag = None
+        if doctag is not None:
+            selfTag = doctag
+        else:
+            if self.__name:
+                selfTag = self.__name
+
+        if not selfTag:
+            if namedItemsOnly:
+                return ""
+            else:
+                selfTag = "ITEM"
+
+        out += [ nl, indent, "<", selfTag, ">" ]
+
+        for i,res in enumerate(self.__toklist):
+            if isinstance(res,ParseResults):
+                if i in namedItems:
+                    out += [ res.asXML(namedItems[i],
+                                        namedItemsOnly and doctag is None,
+                                        nextLevelIndent,
+                                        formatted)]
+                else:
+                    out += [ res.asXML(None,
+                                        namedItemsOnly and doctag is None,
+                                        nextLevelIndent,
+                                        formatted)]
+            else:
+                # individual token, see if there is a name for it
+                resTag = None
+                if i in namedItems:
+                    resTag = namedItems[i]
+                if not resTag:
+                    if namedItemsOnly:
+                        continue
+                    else:
+                        resTag = "ITEM"
+                xmlBodyText = _xml_escape(_ustr(res))
+                out += [ nl, nextLevelIndent, "<", resTag, ">",
+                                                xmlBodyText,
+                                                "" ]
+
+        out += [ nl, indent, "" ]
+        return "".join(out)
+
+    def __lookup(self,sub):
+        for k,vlist in self.__tokdict.items():
+            for v,loc in vlist:
+                if sub is v:
+                    return k
+        return None
+
+    def getName(self):
+        r"""
+        Returns the results name for this token expression. Useful when several 
+        different expressions might match at a particular location.
+
+        Example::
+            integer = Word(nums)
+            ssn_expr = Regex(r"\d\d\d-\d\d-\d\d\d\d")
+            house_number_expr = Suppress('#') + Word(nums, alphanums)
+            user_data = (Group(house_number_expr)("house_number") 
+                        | Group(ssn_expr)("ssn")
+                        | Group(integer)("age"))
+            user_info = OneOrMore(user_data)
+            
+            result = user_info.parseString("22 111-22-3333 #221B")
+            for item in result:
+                print(item.getName(), ':', item[0])
+        prints::
+            age : 22
+            ssn : 111-22-3333
+            house_number : 221B
+        """
+        if self.__name:
+            return self.__name
+        elif self.__parent:
+            par = self.__parent()
+            if par:
+                return par.__lookup(self)
+            else:
+                return None
+        elif (len(self) == 1 and
+               len(self.__tokdict) == 1 and
+               next(iter(self.__tokdict.values()))[0][1] in (0,-1)):
+            return next(iter(self.__tokdict.keys()))
+        else:
+            return None
+
+    def dump(self, indent='', depth=0, full=True):
+        """
+        Diagnostic method for listing out the contents of a C{ParseResults}.
+        Accepts an optional C{indent} argument so that this string can be embedded
+        in a nested display of other data.
+
+        Example::
+            integer = Word(nums)
+            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
+            
+            result = date_str.parseString('12/31/1999')
+            print(result.dump())
+        prints::
+            ['12', '/', '31', '/', '1999']
+            - day: 1999
+            - month: 31
+            - year: 12
+        """
+        out = []
+        NL = '\n'
+        out.append( indent+_ustr(self.asList()) )
+        if full:
+            if self.haskeys():
+                items = sorted((str(k), v) for k,v in self.items())
+                for k,v in items:
+                    if out:
+                        out.append(NL)
+                    out.append( "%s%s- %s: " % (indent,('  '*depth), k) )
+                    if isinstance(v,ParseResults):
+                        if v:
+                            out.append( v.dump(indent,depth+1) )
+                        else:
+                            out.append(_ustr(v))
+                    else:
+                        out.append(repr(v))
+            elif any(isinstance(vv,ParseResults) for vv in self):
+                v = self
+                for i,vv in enumerate(v):
+                    if isinstance(vv,ParseResults):
+                        out.append("\n%s%s[%d]:\n%s%s%s" % (indent,('  '*(depth)),i,indent,('  '*(depth+1)),vv.dump(indent,depth+1) ))
+                    else:
+                        out.append("\n%s%s[%d]:\n%s%s%s" % (indent,('  '*(depth)),i,indent,('  '*(depth+1)),_ustr(vv)))
+            
+        return "".join(out)
+
+    def pprint(self, *args, **kwargs):
+        """
+        Pretty-printer for parsed results as a list, using the C{pprint} module.
+        Accepts additional positional or keyword args as defined for the 
+        C{pprint.pprint} method. (U{http://docs.python.org/3/library/pprint.html#pprint.pprint})
+
+        Example::
+            ident = Word(alphas, alphanums)
+            num = Word(nums)
+            func = Forward()
+            term = ident | num | Group('(' + func + ')')
+            func <<= ident + Group(Optional(delimitedList(term)))
+            result = func.parseString("fna a,b,(fnb c,d,200),100")
+            result.pprint(width=40)
+        prints::
+            ['fna',
+             ['a',
+              'b',
+              ['(', 'fnb', ['c', 'd', '200'], ')'],
+              '100']]
+        """
+        pprint.pprint(self.asList(), *args, **kwargs)
+
+    # add support for pickle protocol
+    def __getstate__(self):
+        return ( self.__toklist,
+                 ( self.__tokdict.copy(),
+                   self.__parent is not None and self.__parent() or None,
+                   self.__accumNames,
+                   self.__name ) )
+
+    def __setstate__(self,state):
+        self.__toklist = state[0]
+        (self.__tokdict,
+         par,
+         inAccumNames,
+         self.__name) = state[1]
+        self.__accumNames = {}
+        self.__accumNames.update(inAccumNames)
+        if par is not None:
+            self.__parent = wkref(par)
+        else:
+            self.__parent = None
+
+    def __getnewargs__(self):
+        return self.__toklist, self.__name, self.__asList, self.__modal
+
+    def __dir__(self):
+        return (dir(type(self)) + list(self.keys()))
+
+MutableMapping.register(ParseResults)
+
+def col (loc,strg):
+    """Returns current column within a string, counting newlines as line separators.
+   The first column is number 1.
+
+   Note: the default parsing behavior is to expand tabs in the input string
+   before starting the parsing process.  See L{I{ParserElement.parseString}} for more information
+   on parsing strings containing C{}s, and suggested methods to maintain a
+   consistent view of the parsed string, the parse location, and line and column
+   positions within the parsed string.
+   """
+    s = strg
+    return 1 if 0} for more information
+   on parsing strings containing C{}s, and suggested methods to maintain a
+   consistent view of the parsed string, the parse location, and line and column
+   positions within the parsed string.
+   """
+    return strg.count("\n",0,loc) + 1
+
+def line( loc, strg ):
+    """Returns the line of text containing loc within a string, counting newlines as line separators.
+       """
+    lastCR = strg.rfind("\n", 0, loc)
+    nextCR = strg.find("\n", loc)
+    if nextCR >= 0:
+        return strg[lastCR+1:nextCR]
+    else:
+        return strg[lastCR+1:]
+
+def _defaultStartDebugAction( instring, loc, expr ):
+    print (("Match " + _ustr(expr) + " at loc " + _ustr(loc) + "(%d,%d)" % ( lineno(loc,instring), col(loc,instring) )))
+
+def _defaultSuccessDebugAction( instring, startloc, endloc, expr, toks ):
+    print ("Matched " + _ustr(expr) + " -> " + str(toks.asList()))
+
+def _defaultExceptionDebugAction( instring, loc, expr, exc ):
+    print ("Exception raised:" + _ustr(exc))
+
+def nullDebugAction(*args):
+    """'Do-nothing' debug action, to suppress debugging output during parsing."""
+    pass
+
+# Only works on Python 3.x - nonlocal is toxic to Python 2 installs
+#~ 'decorator to trim function calls to match the arity of the target'
+#~ def _trim_arity(func, maxargs=3):
+    #~ if func in singleArgBuiltins:
+        #~ return lambda s,l,t: func(t)
+    #~ limit = 0
+    #~ foundArity = False
+    #~ def wrapper(*args):
+        #~ nonlocal limit,foundArity
+        #~ while 1:
+            #~ try:
+                #~ ret = func(*args[limit:])
+                #~ foundArity = True
+                #~ return ret
+            #~ except TypeError:
+                #~ if limit == maxargs or foundArity:
+                    #~ raise
+                #~ limit += 1
+                #~ continue
+    #~ return wrapper
+
+# this version is Python 2.x-3.x cross-compatible
+'decorator to trim function calls to match the arity of the target'
+def _trim_arity(func, maxargs=2):
+    if func in singleArgBuiltins:
+        return lambda s,l,t: func(t)
+    limit = [0]
+    foundArity = [False]
+    
+    # traceback return data structure changed in Py3.5 - normalize back to plain tuples
+    if system_version[:2] >= (3,5):
+        def extract_stack(limit=0):
+            # special handling for Python 3.5.0 - extra deep call stack by 1
+            offset = -3 if system_version == (3,5,0) else -2
+            frame_summary = traceback.extract_stack(limit=-offset+limit-1)[offset]
+            return [frame_summary[:2]]
+        def extract_tb(tb, limit=0):
+            frames = traceback.extract_tb(tb, limit=limit)
+            frame_summary = frames[-1]
+            return [frame_summary[:2]]
+    else:
+        extract_stack = traceback.extract_stack
+        extract_tb = traceback.extract_tb
+    
+    # synthesize what would be returned by traceback.extract_stack at the call to 
+    # user's parse action 'func', so that we don't incur call penalty at parse time
+    
+    LINE_DIFF = 6
+    # IF ANY CODE CHANGES, EVEN JUST COMMENTS OR BLANK LINES, BETWEEN THE NEXT LINE AND 
+    # THE CALL TO FUNC INSIDE WRAPPER, LINE_DIFF MUST BE MODIFIED!!!!
+    this_line = extract_stack(limit=2)[-1]
+    pa_call_line_synth = (this_line[0], this_line[1]+LINE_DIFF)
+
+    def wrapper(*args):
+        while 1:
+            try:
+                ret = func(*args[limit[0]:])
+                foundArity[0] = True
+                return ret
+            except TypeError:
+                # re-raise TypeErrors if they did not come from our arity testing
+                if foundArity[0]:
+                    raise
+                else:
+                    try:
+                        tb = sys.exc_info()[-1]
+                        if not extract_tb(tb, limit=2)[-1][:2] == pa_call_line_synth:
+                            raise
+                    finally:
+                        del tb
+
+                if limit[0] <= maxargs:
+                    limit[0] += 1
+                    continue
+                raise
+
+    # copy func name to wrapper for sensible debug output
+    func_name = ""
+    try:
+        func_name = getattr(func, '__name__', 
+                            getattr(func, '__class__').__name__)
+    except Exception:
+        func_name = str(func)
+    wrapper.__name__ = func_name
+
+    return wrapper
+
+class ParserElement(object):
+    """Abstract base level parser element class."""
+    DEFAULT_WHITE_CHARS = " \n\t\r"
+    verbose_stacktrace = False
+
+    @staticmethod
+    def setDefaultWhitespaceChars( chars ):
+        r"""
+        Overrides the default whitespace chars
+
+        Example::
+            # default whitespace chars are space,  and newline
+            OneOrMore(Word(alphas)).parseString("abc def\nghi jkl")  # -> ['abc', 'def', 'ghi', 'jkl']
+            
+            # change to just treat newline as significant
+            ParserElement.setDefaultWhitespaceChars(" \t")
+            OneOrMore(Word(alphas)).parseString("abc def\nghi jkl")  # -> ['abc', 'def']
+        """
+        ParserElement.DEFAULT_WHITE_CHARS = chars
+
+    @staticmethod
+    def inlineLiteralsUsing(cls):
+        """
+        Set class to be used for inclusion of string literals into a parser.
+        
+        Example::
+            # default literal class used is Literal
+            integer = Word(nums)
+            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")           
+
+            date_str.parseString("1999/12/31")  # -> ['1999', '/', '12', '/', '31']
+
+
+            # change to Suppress
+            ParserElement.inlineLiteralsUsing(Suppress)
+            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")           
+
+            date_str.parseString("1999/12/31")  # -> ['1999', '12', '31']
+        """
+        ParserElement._literalStringClass = cls
+
+    def __init__( self, savelist=False ):
+        self.parseAction = list()
+        self.failAction = None
+        #~ self.name = ""  # don't define self.name, let subclasses try/except upcall
+        self.strRepr = None
+        self.resultsName = None
+        self.saveAsList = savelist
+        self.skipWhitespace = True
+        self.whiteChars = ParserElement.DEFAULT_WHITE_CHARS
+        self.copyDefaultWhiteChars = True
+        self.mayReturnEmpty = False # used when checking for left-recursion
+        self.keepTabs = False
+        self.ignoreExprs = list()
+        self.debug = False
+        self.streamlined = False
+        self.mayIndexError = True # used to optimize exception handling for subclasses that don't advance parse index
+        self.errmsg = ""
+        self.modalResults = True # used to mark results names as modal (report only last) or cumulative (list all)
+        self.debugActions = ( None, None, None ) #custom debug actions
+        self.re = None
+        self.callPreparse = True # used to avoid redundant calls to preParse
+        self.callDuringTry = False
+
+    def copy( self ):
+        """
+        Make a copy of this C{ParserElement}.  Useful for defining different parse actions
+        for the same parsing pattern, using copies of the original parse element.
+        
+        Example::
+            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
+            integerK = integer.copy().addParseAction(lambda toks: toks[0]*1024) + Suppress("K")
+            integerM = integer.copy().addParseAction(lambda toks: toks[0]*1024*1024) + Suppress("M")
+            
+            print(OneOrMore(integerK | integerM | integer).parseString("5K 100 640K 256M"))
+        prints::
+            [5120, 100, 655360, 268435456]
+        Equivalent form of C{expr.copy()} is just C{expr()}::
+            integerM = integer().addParseAction(lambda toks: toks[0]*1024*1024) + Suppress("M")
+        """
+        cpy = copy.copy( self )
+        cpy.parseAction = self.parseAction[:]
+        cpy.ignoreExprs = self.ignoreExprs[:]
+        if self.copyDefaultWhiteChars:
+            cpy.whiteChars = ParserElement.DEFAULT_WHITE_CHARS
+        return cpy
+
+    def setName( self, name ):
+        """
+        Define name for this expression, makes debugging and exception messages clearer.
+        
+        Example::
+            Word(nums).parseString("ABC")  # -> Exception: Expected W:(0123...) (at char 0), (line:1, col:1)
+            Word(nums).setName("integer").parseString("ABC")  # -> Exception: Expected integer (at char 0), (line:1, col:1)
+        """
+        self.name = name
+        self.errmsg = "Expected " + self.name
+        if hasattr(self,"exception"):
+            self.exception.msg = self.errmsg
+        return self
+
+    def setResultsName( self, name, listAllMatches=False ):
+        """
+        Define name for referencing matching tokens as a nested attribute
+        of the returned parse results.
+        NOTE: this returns a *copy* of the original C{ParserElement} object;
+        this is so that the client can define a basic element, such as an
+        integer, and reference it in multiple places with different names.
+
+        You can also set results names using the abbreviated syntax,
+        C{expr("name")} in place of C{expr.setResultsName("name")} - 
+        see L{I{__call__}<__call__>}.
+
+        Example::
+            date_str = (integer.setResultsName("year") + '/' 
+                        + integer.setResultsName("month") + '/' 
+                        + integer.setResultsName("day"))
+
+            # equivalent form:
+            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
+        """
+        newself = self.copy()
+        if name.endswith("*"):
+            name = name[:-1]
+            listAllMatches=True
+        newself.resultsName = name
+        newself.modalResults = not listAllMatches
+        return newself
+
+    def setBreak(self,breakFlag = True):
+        """Method to invoke the Python pdb debugger when this element is
+           about to be parsed. Set C{breakFlag} to True to enable, False to
+           disable.
+        """
+        if breakFlag:
+            _parseMethod = self._parse
+            def breaker(instring, loc, doActions=True, callPreParse=True):
+                import pdb
+                pdb.set_trace()
+                return _parseMethod( instring, loc, doActions, callPreParse )
+            breaker._originalParseMethod = _parseMethod
+            self._parse = breaker
+        else:
+            if hasattr(self._parse,"_originalParseMethod"):
+                self._parse = self._parse._originalParseMethod
+        return self
+
+    def setParseAction( self, *fns, **kwargs ):
+        """
+        Define one or more actions to perform when successfully matching parse element definition.
+        Parse action fn is a callable method with 0-3 arguments, called as C{fn(s,loc,toks)},
+        C{fn(loc,toks)}, C{fn(toks)}, or just C{fn()}, where:
+         - s   = the original string being parsed (see note below)
+         - loc = the location of the matching substring
+         - toks = a list of the matched tokens, packaged as a C{L{ParseResults}} object
+        If the functions in fns modify the tokens, they can return them as the return
+        value from fn, and the modified list of tokens will replace the original.
+        Otherwise, fn does not need to return any value.
+
+        Optional keyword arguments:
+         - callDuringTry = (default=C{False}) indicate if parse action should be run during lookaheads and alternate testing
+
+        Note: the default parsing behavior is to expand tabs in the input string
+        before starting the parsing process.  See L{I{parseString}} for more information
+        on parsing strings containing C{}s, and suggested methods to maintain a
+        consistent view of the parsed string, the parse location, and line and column
+        positions within the parsed string.
+        
+        Example::
+            integer = Word(nums)
+            date_str = integer + '/' + integer + '/' + integer
+
+            date_str.parseString("1999/12/31")  # -> ['1999', '/', '12', '/', '31']
+
+            # use parse action to convert to ints at parse time
+            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
+            date_str = integer + '/' + integer + '/' + integer
+
+            # note that integer fields are now ints, not strings
+            date_str.parseString("1999/12/31")  # -> [1999, '/', 12, '/', 31]
+        """
+        self.parseAction = list(map(_trim_arity, list(fns)))
+        self.callDuringTry = kwargs.get("callDuringTry", False)
+        return self
+
+    def addParseAction( self, *fns, **kwargs ):
+        """
+        Add one or more parse actions to expression's list of parse actions. See L{I{setParseAction}}.
+        
+        See examples in L{I{copy}}.
+        """
+        self.parseAction += list(map(_trim_arity, list(fns)))
+        self.callDuringTry = self.callDuringTry or kwargs.get("callDuringTry", False)
+        return self
+
+    def addCondition(self, *fns, **kwargs):
+        """Add a boolean predicate function to expression's list of parse actions. See 
+        L{I{setParseAction}} for function call signatures. Unlike C{setParseAction}, 
+        functions passed to C{addCondition} need to return boolean success/fail of the condition.
+
+        Optional keyword arguments:
+         - message = define a custom message to be used in the raised exception
+         - fatal   = if True, will raise ParseFatalException to stop parsing immediately; otherwise will raise ParseException
+         
+        Example::
+            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
+            year_int = integer.copy()
+            year_int.addCondition(lambda toks: toks[0] >= 2000, message="Only support years 2000 and later")
+            date_str = year_int + '/' + integer + '/' + integer
+
+            result = date_str.parseString("1999/12/31")  # -> Exception: Only support years 2000 and later (at char 0), (line:1, col:1)
+        """
+        msg = kwargs.get("message", "failed user-defined condition")
+        exc_type = ParseFatalException if kwargs.get("fatal", False) else ParseException
+        for fn in fns:
+            def pa(s,l,t):
+                if not bool(_trim_arity(fn)(s,l,t)):
+                    raise exc_type(s,l,msg)
+            self.parseAction.append(pa)
+        self.callDuringTry = self.callDuringTry or kwargs.get("callDuringTry", False)
+        return self
+
+    def setFailAction( self, fn ):
+        """Define action to perform if parsing fails at this expression.
+           Fail acton fn is a callable function that takes the arguments
+           C{fn(s,loc,expr,err)} where:
+            - s = string being parsed
+            - loc = location where expression match was attempted and failed
+            - expr = the parse expression that failed
+            - err = the exception thrown
+           The function returns no value.  It may throw C{L{ParseFatalException}}
+           if it is desired to stop parsing immediately."""
+        self.failAction = fn
+        return self
+
+    def _skipIgnorables( self, instring, loc ):
+        exprsFound = True
+        while exprsFound:
+            exprsFound = False
+            for e in self.ignoreExprs:
+                try:
+                    while 1:
+                        loc,dummy = e._parse( instring, loc )
+                        exprsFound = True
+                except ParseException:
+                    pass
+        return loc
+
+    def preParse( self, instring, loc ):
+        if self.ignoreExprs:
+            loc = self._skipIgnorables( instring, loc )
+
+        if self.skipWhitespace:
+            wt = self.whiteChars
+            instrlen = len(instring)
+            while loc < instrlen and instring[loc] in wt:
+                loc += 1
+
+        return loc
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        return loc, []
+
+    def postParse( self, instring, loc, tokenlist ):
+        return tokenlist
+
+    #~ @profile
+    def _parseNoCache( self, instring, loc, doActions=True, callPreParse=True ):
+        debugging = ( self.debug ) #and doActions )
+
+        if debugging or self.failAction:
+            #~ print ("Match",self,"at loc",loc,"(%d,%d)" % ( lineno(loc,instring), col(loc,instring) ))
+            if (self.debugActions[0] ):
+                self.debugActions[0]( instring, loc, self )
+            if callPreParse and self.callPreparse:
+                preloc = self.preParse( instring, loc )
+            else:
+                preloc = loc
+            tokensStart = preloc
+            try:
+                try:
+                    loc,tokens = self.parseImpl( instring, preloc, doActions )
+                except IndexError:
+                    raise ParseException( instring, len(instring), self.errmsg, self )
+            except ParseBaseException as err:
+                #~ print ("Exception raised:", err)
+                if self.debugActions[2]:
+                    self.debugActions[2]( instring, tokensStart, self, err )
+                if self.failAction:
+                    self.failAction( instring, tokensStart, self, err )
+                raise
+        else:
+            if callPreParse and self.callPreparse:
+                preloc = self.preParse( instring, loc )
+            else:
+                preloc = loc
+            tokensStart = preloc
+            if self.mayIndexError or preloc >= len(instring):
+                try:
+                    loc,tokens = self.parseImpl( instring, preloc, doActions )
+                except IndexError:
+                    raise ParseException( instring, len(instring), self.errmsg, self )
+            else:
+                loc,tokens = self.parseImpl( instring, preloc, doActions )
+
+        tokens = self.postParse( instring, loc, tokens )
+
+        retTokens = ParseResults( tokens, self.resultsName, asList=self.saveAsList, modal=self.modalResults )
+        if self.parseAction and (doActions or self.callDuringTry):
+            if debugging:
+                try:
+                    for fn in self.parseAction:
+                        tokens = fn( instring, tokensStart, retTokens )
+                        if tokens is not None:
+                            retTokens = ParseResults( tokens,
+                                                      self.resultsName,
+                                                      asList=self.saveAsList and isinstance(tokens,(ParseResults,list)),
+                                                      modal=self.modalResults )
+                except ParseBaseException as err:
+                    #~ print "Exception raised in user parse action:", err
+                    if (self.debugActions[2] ):
+                        self.debugActions[2]( instring, tokensStart, self, err )
+                    raise
+            else:
+                for fn in self.parseAction:
+                    tokens = fn( instring, tokensStart, retTokens )
+                    if tokens is not None:
+                        retTokens = ParseResults( tokens,
+                                                  self.resultsName,
+                                                  asList=self.saveAsList and isinstance(tokens,(ParseResults,list)),
+                                                  modal=self.modalResults )
+        if debugging:
+            #~ print ("Matched",self,"->",retTokens.asList())
+            if (self.debugActions[1] ):
+                self.debugActions[1]( instring, tokensStart, loc, self, retTokens )
+
+        return loc, retTokens
+
+    def tryParse( self, instring, loc ):
+        try:
+            return self._parse( instring, loc, doActions=False )[0]
+        except ParseFatalException:
+            raise ParseException( instring, loc, self.errmsg, self)
+    
+    def canParseNext(self, instring, loc):
+        try:
+            self.tryParse(instring, loc)
+        except (ParseException, IndexError):
+            return False
+        else:
+            return True
+
+    class _UnboundedCache(object):
+        def __init__(self):
+            cache = {}
+            self.not_in_cache = not_in_cache = object()
+
+            def get(self, key):
+                return cache.get(key, not_in_cache)
+
+            def set(self, key, value):
+                cache[key] = value
+
+            def clear(self):
+                cache.clear()
+                
+            def cache_len(self):
+                return len(cache)
+
+            self.get = types.MethodType(get, self)
+            self.set = types.MethodType(set, self)
+            self.clear = types.MethodType(clear, self)
+            self.__len__ = types.MethodType(cache_len, self)
+
+    if _OrderedDict is not None:
+        class _FifoCache(object):
+            def __init__(self, size):
+                self.not_in_cache = not_in_cache = object()
+
+                cache = _OrderedDict()
+
+                def get(self, key):
+                    return cache.get(key, not_in_cache)
+
+                def set(self, key, value):
+                    cache[key] = value
+                    while len(cache) > size:
+                        try:
+                            cache.popitem(False)
+                        except KeyError:
+                            pass
+
+                def clear(self):
+                    cache.clear()
+
+                def cache_len(self):
+                    return len(cache)
+
+                self.get = types.MethodType(get, self)
+                self.set = types.MethodType(set, self)
+                self.clear = types.MethodType(clear, self)
+                self.__len__ = types.MethodType(cache_len, self)
+
+    else:
+        class _FifoCache(object):
+            def __init__(self, size):
+                self.not_in_cache = not_in_cache = object()
+
+                cache = {}
+                key_fifo = collections.deque([], size)
+
+                def get(self, key):
+                    return cache.get(key, not_in_cache)
+
+                def set(self, key, value):
+                    cache[key] = value
+                    while len(key_fifo) > size:
+                        cache.pop(key_fifo.popleft(), None)
+                    key_fifo.append(key)
+
+                def clear(self):
+                    cache.clear()
+                    key_fifo.clear()
+
+                def cache_len(self):
+                    return len(cache)
+
+                self.get = types.MethodType(get, self)
+                self.set = types.MethodType(set, self)
+                self.clear = types.MethodType(clear, self)
+                self.__len__ = types.MethodType(cache_len, self)
+
+    # argument cache for optimizing repeated calls when backtracking through recursive expressions
+    packrat_cache = {} # this is set later by enabledPackrat(); this is here so that resetCache() doesn't fail
+    packrat_cache_lock = RLock()
+    packrat_cache_stats = [0, 0]
+
+    # this method gets repeatedly called during backtracking with the same arguments -
+    # we can cache these arguments and save ourselves the trouble of re-parsing the contained expression
+    def _parseCache( self, instring, loc, doActions=True, callPreParse=True ):
+        HIT, MISS = 0, 1
+        lookup = (self, instring, loc, callPreParse, doActions)
+        with ParserElement.packrat_cache_lock:
+            cache = ParserElement.packrat_cache
+            value = cache.get(lookup)
+            if value is cache.not_in_cache:
+                ParserElement.packrat_cache_stats[MISS] += 1
+                try:
+                    value = self._parseNoCache(instring, loc, doActions, callPreParse)
+                except ParseBaseException as pe:
+                    # cache a copy of the exception, without the traceback
+                    cache.set(lookup, pe.__class__(*pe.args))
+                    raise
+                else:
+                    cache.set(lookup, (value[0], value[1].copy()))
+                    return value
+            else:
+                ParserElement.packrat_cache_stats[HIT] += 1
+                if isinstance(value, Exception):
+                    raise value
+                return (value[0], value[1].copy())
+
+    _parse = _parseNoCache
+
+    @staticmethod
+    def resetCache():
+        ParserElement.packrat_cache.clear()
+        ParserElement.packrat_cache_stats[:] = [0] * len(ParserElement.packrat_cache_stats)
+
+    _packratEnabled = False
+    @staticmethod
+    def enablePackrat(cache_size_limit=128):
+        """Enables "packrat" parsing, which adds memoizing to the parsing logic.
+           Repeated parse attempts at the same string location (which happens
+           often in many complex grammars) can immediately return a cached value,
+           instead of re-executing parsing/validating code.  Memoizing is done of
+           both valid results and parsing exceptions.
+           
+           Parameters:
+            - cache_size_limit - (default=C{128}) - if an integer value is provided
+              will limit the size of the packrat cache; if None is passed, then
+              the cache size will be unbounded; if 0 is passed, the cache will
+              be effectively disabled.
+            
+           This speedup may break existing programs that use parse actions that
+           have side-effects.  For this reason, packrat parsing is disabled when
+           you first import pyparsing.  To activate the packrat feature, your
+           program must call the class method C{ParserElement.enablePackrat()}.  If
+           your program uses C{psyco} to "compile as you go", you must call
+           C{enablePackrat} before calling C{psyco.full()}.  If you do not do this,
+           Python will crash.  For best results, call C{enablePackrat()} immediately
+           after importing pyparsing.
+           
+           Example::
+               import pyparsing
+               pyparsing.ParserElement.enablePackrat()
+        """
+        if not ParserElement._packratEnabled:
+            ParserElement._packratEnabled = True
+            if cache_size_limit is None:
+                ParserElement.packrat_cache = ParserElement._UnboundedCache()
+            else:
+                ParserElement.packrat_cache = ParserElement._FifoCache(cache_size_limit)
+            ParserElement._parse = ParserElement._parseCache
+
+    def parseString( self, instring, parseAll=False ):
+        """
+        Execute the parse expression with the given string.
+        This is the main interface to the client code, once the complete
+        expression has been built.
+
+        If you want the grammar to require that the entire input string be
+        successfully parsed, then set C{parseAll} to True (equivalent to ending
+        the grammar with C{L{StringEnd()}}).
+
+        Note: C{parseString} implicitly calls C{expandtabs()} on the input string,
+        in order to report proper column numbers in parse actions.
+        If the input string contains tabs and
+        the grammar uses parse actions that use the C{loc} argument to index into the
+        string being parsed, you can ensure you have a consistent view of the input
+        string by:
+         - calling C{parseWithTabs} on your grammar before calling C{parseString}
+           (see L{I{parseWithTabs}})
+         - define your parse action using the full C{(s,loc,toks)} signature, and
+           reference the input string using the parse action's C{s} argument
+         - explictly expand the tabs in your input string before calling
+           C{parseString}
+        
+        Example::
+            Word('a').parseString('aaaaabaaa')  # -> ['aaaaa']
+            Word('a').parseString('aaaaabaaa', parseAll=True)  # -> Exception: Expected end of text
+        """
+        ParserElement.resetCache()
+        if not self.streamlined:
+            self.streamline()
+            #~ self.saveAsList = True
+        for e in self.ignoreExprs:
+            e.streamline()
+        if not self.keepTabs:
+            instring = instring.expandtabs()
+        try:
+            loc, tokens = self._parse( instring, 0 )
+            if parseAll:
+                loc = self.preParse( instring, loc )
+                se = Empty() + StringEnd()
+                se._parse( instring, loc )
+        except ParseBaseException as exc:
+            if ParserElement.verbose_stacktrace:
+                raise
+            else:
+                # catch and re-raise exception from here, clears out pyparsing internal stack trace
+                raise exc
+        else:
+            return tokens
+
+    def scanString( self, instring, maxMatches=_MAX_INT, overlap=False ):
+        """
+        Scan the input string for expression matches.  Each match will return the
+        matching tokens, start location, and end location.  May be called with optional
+        C{maxMatches} argument, to clip scanning after 'n' matches are found.  If
+        C{overlap} is specified, then overlapping matches will be reported.
+
+        Note that the start and end locations are reported relative to the string
+        being parsed.  See L{I{parseString}} for more information on parsing
+        strings with embedded tabs.
+
+        Example::
+            source = "sldjf123lsdjjkf345sldkjf879lkjsfd987"
+            print(source)
+            for tokens,start,end in Word(alphas).scanString(source):
+                print(' '*start + '^'*(end-start))
+                print(' '*start + tokens[0])
+        
+        prints::
+        
+            sldjf123lsdjjkf345sldkjf879lkjsfd987
+            ^^^^^
+            sldjf
+                    ^^^^^^^
+                    lsdjjkf
+                              ^^^^^^
+                              sldkjf
+                                       ^^^^^^
+                                       lkjsfd
+        """
+        if not self.streamlined:
+            self.streamline()
+        for e in self.ignoreExprs:
+            e.streamline()
+
+        if not self.keepTabs:
+            instring = _ustr(instring).expandtabs()
+        instrlen = len(instring)
+        loc = 0
+        preparseFn = self.preParse
+        parseFn = self._parse
+        ParserElement.resetCache()
+        matches = 0
+        try:
+            while loc <= instrlen and matches < maxMatches:
+                try:
+                    preloc = preparseFn( instring, loc )
+                    nextLoc,tokens = parseFn( instring, preloc, callPreParse=False )
+                except ParseException:
+                    loc = preloc+1
+                else:
+                    if nextLoc > loc:
+                        matches += 1
+                        yield tokens, preloc, nextLoc
+                        if overlap:
+                            nextloc = preparseFn( instring, loc )
+                            if nextloc > loc:
+                                loc = nextLoc
+                            else:
+                                loc += 1
+                        else:
+                            loc = nextLoc
+                    else:
+                        loc = preloc+1
+        except ParseBaseException as exc:
+            if ParserElement.verbose_stacktrace:
+                raise
+            else:
+                # catch and re-raise exception from here, clears out pyparsing internal stack trace
+                raise exc
+
+    def transformString( self, instring ):
+        """
+        Extension to C{L{scanString}}, to modify matching text with modified tokens that may
+        be returned from a parse action.  To use C{transformString}, define a grammar and
+        attach a parse action to it that modifies the returned token list.
+        Invoking C{transformString()} on a target string will then scan for matches,
+        and replace the matched text patterns according to the logic in the parse
+        action.  C{transformString()} returns the resulting transformed string.
+        
+        Example::
+            wd = Word(alphas)
+            wd.setParseAction(lambda toks: toks[0].title())
+            
+            print(wd.transformString("now is the winter of our discontent made glorious summer by this sun of york."))
+        Prints::
+            Now Is The Winter Of Our Discontent Made Glorious Summer By This Sun Of York.
+        """
+        out = []
+        lastE = 0
+        # force preservation of s, to minimize unwanted transformation of string, and to
+        # keep string locs straight between transformString and scanString
+        self.keepTabs = True
+        try:
+            for t,s,e in self.scanString( instring ):
+                out.append( instring[lastE:s] )
+                if t:
+                    if isinstance(t,ParseResults):
+                        out += t.asList()
+                    elif isinstance(t,list):
+                        out += t
+                    else:
+                        out.append(t)
+                lastE = e
+            out.append(instring[lastE:])
+            out = [o for o in out if o]
+            return "".join(map(_ustr,_flatten(out)))
+        except ParseBaseException as exc:
+            if ParserElement.verbose_stacktrace:
+                raise
+            else:
+                # catch and re-raise exception from here, clears out pyparsing internal stack trace
+                raise exc
+
+    def searchString( self, instring, maxMatches=_MAX_INT ):
+        """
+        Another extension to C{L{scanString}}, simplifying the access to the tokens found
+        to match the given parse expression.  May be called with optional
+        C{maxMatches} argument, to clip searching after 'n' matches are found.
+        
+        Example::
+            # a capitalized word starts with an uppercase letter, followed by zero or more lowercase letters
+            cap_word = Word(alphas.upper(), alphas.lower())
+            
+            print(cap_word.searchString("More than Iron, more than Lead, more than Gold I need Electricity"))
+
+            # the sum() builtin can be used to merge results into a single ParseResults object
+            print(sum(cap_word.searchString("More than Iron, more than Lead, more than Gold I need Electricity")))
+        prints::
+            [['More'], ['Iron'], ['Lead'], ['Gold'], ['I'], ['Electricity']]
+            ['More', 'Iron', 'Lead', 'Gold', 'I', 'Electricity']
+        """
+        try:
+            return ParseResults([ t for t,s,e in self.scanString( instring, maxMatches ) ])
+        except ParseBaseException as exc:
+            if ParserElement.verbose_stacktrace:
+                raise
+            else:
+                # catch and re-raise exception from here, clears out pyparsing internal stack trace
+                raise exc
+
+    def split(self, instring, maxsplit=_MAX_INT, includeSeparators=False):
+        """
+        Generator method to split a string using the given expression as a separator.
+        May be called with optional C{maxsplit} argument, to limit the number of splits;
+        and the optional C{includeSeparators} argument (default=C{False}), if the separating
+        matching text should be included in the split results.
+        
+        Example::        
+            punc = oneOf(list(".,;:/-!?"))
+            print(list(punc.split("This, this?, this sentence, is badly punctuated!")))
+        prints::
+            ['This', ' this', '', ' this sentence', ' is badly punctuated', '']
+        """
+        splits = 0
+        last = 0
+        for t,s,e in self.scanString(instring, maxMatches=maxsplit):
+            yield instring[last:s]
+            if includeSeparators:
+                yield t[0]
+            last = e
+        yield instring[last:]
+
+    def __add__(self, other ):
+        """
+        Implementation of + operator - returns C{L{And}}. Adding strings to a ParserElement
+        converts them to L{Literal}s by default.
+        
+        Example::
+            greet = Word(alphas) + "," + Word(alphas) + "!"
+            hello = "Hello, World!"
+            print (hello, "->", greet.parseString(hello))
+        Prints::
+            Hello, World! -> ['Hello', ',', 'World', '!']
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return And( [ self, other ] )
+
+    def __radd__(self, other ):
+        """
+        Implementation of + operator when left operand is not a C{L{ParserElement}}
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return other + self
+
+    def __sub__(self, other):
+        """
+        Implementation of - operator, returns C{L{And}} with error stop
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return self + And._ErrorStop() + other
+
+    def __rsub__(self, other ):
+        """
+        Implementation of - operator when left operand is not a C{L{ParserElement}}
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return other - self
+
+    def __mul__(self,other):
+        """
+        Implementation of * operator, allows use of C{expr * 3} in place of
+        C{expr + expr + expr}.  Expressions may also me multiplied by a 2-integer
+        tuple, similar to C{{min,max}} multipliers in regular expressions.  Tuples
+        may also include C{None} as in:
+         - C{expr*(n,None)} or C{expr*(n,)} is equivalent
+              to C{expr*n + L{ZeroOrMore}(expr)}
+              (read as "at least n instances of C{expr}")
+         - C{expr*(None,n)} is equivalent to C{expr*(0,n)}
+              (read as "0 to n instances of C{expr}")
+         - C{expr*(None,None)} is equivalent to C{L{ZeroOrMore}(expr)}
+         - C{expr*(1,None)} is equivalent to C{L{OneOrMore}(expr)}
+
+        Note that C{expr*(None,n)} does not raise an exception if
+        more than n exprs exist in the input stream; that is,
+        C{expr*(None,n)} does not enforce a maximum number of expr
+        occurrences.  If this behavior is desired, then write
+        C{expr*(None,n) + ~expr}
+        """
+        if isinstance(other,int):
+            minElements, optElements = other,0
+        elif isinstance(other,tuple):
+            other = (other + (None, None))[:2]
+            if other[0] is None:
+                other = (0, other[1])
+            if isinstance(other[0],int) and other[1] is None:
+                if other[0] == 0:
+                    return ZeroOrMore(self)
+                if other[0] == 1:
+                    return OneOrMore(self)
+                else:
+                    return self*other[0] + ZeroOrMore(self)
+            elif isinstance(other[0],int) and isinstance(other[1],int):
+                minElements, optElements = other
+                optElements -= minElements
+            else:
+                raise TypeError("cannot multiply 'ParserElement' and ('%s','%s') objects", type(other[0]),type(other[1]))
+        else:
+            raise TypeError("cannot multiply 'ParserElement' and '%s' objects", type(other))
+
+        if minElements < 0:
+            raise ValueError("cannot multiply ParserElement by negative value")
+        if optElements < 0:
+            raise ValueError("second tuple value must be greater or equal to first tuple value")
+        if minElements == optElements == 0:
+            raise ValueError("cannot multiply ParserElement by 0 or (0,0)")
+
+        if (optElements):
+            def makeOptionalList(n):
+                if n>1:
+                    return Optional(self + makeOptionalList(n-1))
+                else:
+                    return Optional(self)
+            if minElements:
+                if minElements == 1:
+                    ret = self + makeOptionalList(optElements)
+                else:
+                    ret = And([self]*minElements) + makeOptionalList(optElements)
+            else:
+                ret = makeOptionalList(optElements)
+        else:
+            if minElements == 1:
+                ret = self
+            else:
+                ret = And([self]*minElements)
+        return ret
+
+    def __rmul__(self, other):
+        return self.__mul__(other)
+
+    def __or__(self, other ):
+        """
+        Implementation of | operator - returns C{L{MatchFirst}}
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return MatchFirst( [ self, other ] )
+
+    def __ror__(self, other ):
+        """
+        Implementation of | operator when left operand is not a C{L{ParserElement}}
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return other | self
+
+    def __xor__(self, other ):
+        """
+        Implementation of ^ operator - returns C{L{Or}}
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return Or( [ self, other ] )
+
+    def __rxor__(self, other ):
+        """
+        Implementation of ^ operator when left operand is not a C{L{ParserElement}}
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return other ^ self
+
+    def __and__(self, other ):
+        """
+        Implementation of & operator - returns C{L{Each}}
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return Each( [ self, other ] )
+
+    def __rand__(self, other ):
+        """
+        Implementation of & operator when left operand is not a C{L{ParserElement}}
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return other & self
+
+    def __invert__( self ):
+        """
+        Implementation of ~ operator - returns C{L{NotAny}}
+        """
+        return NotAny( self )
+
+    def __call__(self, name=None):
+        """
+        Shortcut for C{L{setResultsName}}, with C{listAllMatches=False}.
+        
+        If C{name} is given with a trailing C{'*'} character, then C{listAllMatches} will be
+        passed as C{True}.
+           
+        If C{name} is omitted, same as calling C{L{copy}}.
+
+        Example::
+            # these are equivalent
+            userdata = Word(alphas).setResultsName("name") + Word(nums+"-").setResultsName("socsecno")
+            userdata = Word(alphas)("name") + Word(nums+"-")("socsecno")             
+        """
+        if name is not None:
+            return self.setResultsName(name)
+        else:
+            return self.copy()
+
+    def suppress( self ):
+        """
+        Suppresses the output of this C{ParserElement}; useful to keep punctuation from
+        cluttering up returned output.
+        """
+        return Suppress( self )
+
+    def leaveWhitespace( self ):
+        """
+        Disables the skipping of whitespace before matching the characters in the
+        C{ParserElement}'s defined pattern.  This is normally only used internally by
+        the pyparsing module, but may be needed in some whitespace-sensitive grammars.
+        """
+        self.skipWhitespace = False
+        return self
+
+    def setWhitespaceChars( self, chars ):
+        """
+        Overrides the default whitespace chars
+        """
+        self.skipWhitespace = True
+        self.whiteChars = chars
+        self.copyDefaultWhiteChars = False
+        return self
+
+    def parseWithTabs( self ):
+        """
+        Overrides default behavior to expand C{}s to spaces before parsing the input string.
+        Must be called before C{parseString} when the input grammar contains elements that
+        match C{} characters.
+        """
+        self.keepTabs = True
+        return self
+
+    def ignore( self, other ):
+        """
+        Define expression to be ignored (e.g., comments) while doing pattern
+        matching; may be called repeatedly, to define multiple comment or other
+        ignorable patterns.
+        
+        Example::
+            patt = OneOrMore(Word(alphas))
+            patt.parseString('ablaj /* comment */ lskjd') # -> ['ablaj']
+            
+            patt.ignore(cStyleComment)
+            patt.parseString('ablaj /* comment */ lskjd') # -> ['ablaj', 'lskjd']
+        """
+        if isinstance(other, basestring):
+            other = Suppress(other)
+
+        if isinstance( other, Suppress ):
+            if other not in self.ignoreExprs:
+                self.ignoreExprs.append(other)
+        else:
+            self.ignoreExprs.append( Suppress( other.copy() ) )
+        return self
+
+    def setDebugActions( self, startAction, successAction, exceptionAction ):
+        """
+        Enable display of debugging messages while doing pattern matching.
+        """
+        self.debugActions = (startAction or _defaultStartDebugAction,
+                             successAction or _defaultSuccessDebugAction,
+                             exceptionAction or _defaultExceptionDebugAction)
+        self.debug = True
+        return self
+
+    def setDebug( self, flag=True ):
+        """
+        Enable display of debugging messages while doing pattern matching.
+        Set C{flag} to True to enable, False to disable.
+
+        Example::
+            wd = Word(alphas).setName("alphaword")
+            integer = Word(nums).setName("numword")
+            term = wd | integer
+            
+            # turn on debugging for wd
+            wd.setDebug()
+
+            OneOrMore(term).parseString("abc 123 xyz 890")
+        
+        prints::
+            Match alphaword at loc 0(1,1)
+            Matched alphaword -> ['abc']
+            Match alphaword at loc 3(1,4)
+            Exception raised:Expected alphaword (at char 4), (line:1, col:5)
+            Match alphaword at loc 7(1,8)
+            Matched alphaword -> ['xyz']
+            Match alphaword at loc 11(1,12)
+            Exception raised:Expected alphaword (at char 12), (line:1, col:13)
+            Match alphaword at loc 15(1,16)
+            Exception raised:Expected alphaword (at char 15), (line:1, col:16)
+
+        The output shown is that produced by the default debug actions - custom debug actions can be
+        specified using L{setDebugActions}. Prior to attempting
+        to match the C{wd} expression, the debugging message C{"Match  at loc (,)"}
+        is shown. Then if the parse succeeds, a C{"Matched"} message is shown, or an C{"Exception raised"}
+        message is shown. Also note the use of L{setName} to assign a human-readable name to the expression,
+        which makes debugging and exception messages easier to understand - for instance, the default
+        name created for the C{Word} expression without calling C{setName} is C{"W:(ABCD...)"}.
+        """
+        if flag:
+            self.setDebugActions( _defaultStartDebugAction, _defaultSuccessDebugAction, _defaultExceptionDebugAction )
+        else:
+            self.debug = False
+        return self
+
+    def __str__( self ):
+        return self.name
+
+    def __repr__( self ):
+        return _ustr(self)
+
+    def streamline( self ):
+        self.streamlined = True
+        self.strRepr = None
+        return self
+
+    def checkRecursion( self, parseElementList ):
+        pass
+
+    def validate( self, validateTrace=[] ):
+        """
+        Check defined expressions for valid structure, check for infinite recursive definitions.
+        """
+        self.checkRecursion( [] )
+
+    def parseFile( self, file_or_filename, parseAll=False ):
+        """
+        Execute the parse expression on the given file or filename.
+        If a filename is specified (instead of a file object),
+        the entire file is opened, read, and closed before parsing.
+        """
+        try:
+            file_contents = file_or_filename.read()
+        except AttributeError:
+            with open(file_or_filename, "r") as f:
+                file_contents = f.read()
+        try:
+            return self.parseString(file_contents, parseAll)
+        except ParseBaseException as exc:
+            if ParserElement.verbose_stacktrace:
+                raise
+            else:
+                # catch and re-raise exception from here, clears out pyparsing internal stack trace
+                raise exc
+
+    def __eq__(self,other):
+        if isinstance(other, ParserElement):
+            return self is other or vars(self) == vars(other)
+        elif isinstance(other, basestring):
+            return self.matches(other)
+        else:
+            return super(ParserElement,self)==other
+
+    def __ne__(self,other):
+        return not (self == other)
+
+    def __hash__(self):
+        return hash(id(self))
+
+    def __req__(self,other):
+        return self == other
+
+    def __rne__(self,other):
+        return not (self == other)
+
+    def matches(self, testString, parseAll=True):
+        """
+        Method for quick testing of a parser against a test string. Good for simple 
+        inline microtests of sub expressions while building up larger parser.
+           
+        Parameters:
+         - testString - to test against this expression for a match
+         - parseAll - (default=C{True}) - flag to pass to C{L{parseString}} when running tests
+            
+        Example::
+            expr = Word(nums)
+            assert expr.matches("100")
+        """
+        try:
+            self.parseString(_ustr(testString), parseAll=parseAll)
+            return True
+        except ParseBaseException:
+            return False
+                
+    def runTests(self, tests, parseAll=True, comment='#', fullDump=True, printResults=True, failureTests=False):
+        """
+        Execute the parse expression on a series of test strings, showing each
+        test, the parsed results or where the parse failed. Quick and easy way to
+        run a parse expression against a list of sample strings.
+           
+        Parameters:
+         - tests - a list of separate test strings, or a multiline string of test strings
+         - parseAll - (default=C{True}) - flag to pass to C{L{parseString}} when running tests           
+         - comment - (default=C{'#'}) - expression for indicating embedded comments in the test 
+              string; pass None to disable comment filtering
+         - fullDump - (default=C{True}) - dump results as list followed by results names in nested outline;
+              if False, only dump nested list
+         - printResults - (default=C{True}) prints test output to stdout
+         - failureTests - (default=C{False}) indicates if these tests are expected to fail parsing
+
+        Returns: a (success, results) tuple, where success indicates that all tests succeeded
+        (or failed if C{failureTests} is True), and the results contain a list of lines of each 
+        test's output
+        
+        Example::
+            number_expr = pyparsing_common.number.copy()
+
+            result = number_expr.runTests('''
+                # unsigned integer
+                100
+                # negative integer
+                -100
+                # float with scientific notation
+                6.02e23
+                # integer with scientific notation
+                1e-12
+                ''')
+            print("Success" if result[0] else "Failed!")
+
+            result = number_expr.runTests('''
+                # stray character
+                100Z
+                # missing leading digit before '.'
+                -.100
+                # too many '.'
+                3.14.159
+                ''', failureTests=True)
+            print("Success" if result[0] else "Failed!")
+        prints::
+            # unsigned integer
+            100
+            [100]
+
+            # negative integer
+            -100
+            [-100]
+
+            # float with scientific notation
+            6.02e23
+            [6.02e+23]
+
+            # integer with scientific notation
+            1e-12
+            [1e-12]
+
+            Success
+            
+            # stray character
+            100Z
+               ^
+            FAIL: Expected end of text (at char 3), (line:1, col:4)
+
+            # missing leading digit before '.'
+            -.100
+            ^
+            FAIL: Expected {real number with scientific notation | real number | signed integer} (at char 0), (line:1, col:1)
+
+            # too many '.'
+            3.14.159
+                ^
+            FAIL: Expected end of text (at char 4), (line:1, col:5)
+
+            Success
+
+        Each test string must be on a single line. If you want to test a string that spans multiple
+        lines, create a test like this::
+
+            expr.runTest(r"this is a test\\n of strings that spans \\n 3 lines")
+        
+        (Note that this is a raw string literal, you must include the leading 'r'.)
+        """
+        if isinstance(tests, basestring):
+            tests = list(map(str.strip, tests.rstrip().splitlines()))
+        if isinstance(comment, basestring):
+            comment = Literal(comment)
+        allResults = []
+        comments = []
+        success = True
+        for t in tests:
+            if comment is not None and comment.matches(t, False) or comments and not t:
+                comments.append(t)
+                continue
+            if not t:
+                continue
+            out = ['\n'.join(comments), t]
+            comments = []
+            try:
+                t = t.replace(r'\n','\n')
+                result = self.parseString(t, parseAll=parseAll)
+                out.append(result.dump(full=fullDump))
+                success = success and not failureTests
+            except ParseBaseException as pe:
+                fatal = "(FATAL)" if isinstance(pe, ParseFatalException) else ""
+                if '\n' in t:
+                    out.append(line(pe.loc, t))
+                    out.append(' '*(col(pe.loc,t)-1) + '^' + fatal)
+                else:
+                    out.append(' '*pe.loc + '^' + fatal)
+                out.append("FAIL: " + str(pe))
+                success = success and failureTests
+                result = pe
+            except Exception as exc:
+                out.append("FAIL-EXCEPTION: " + str(exc))
+                success = success and failureTests
+                result = exc
+
+            if printResults:
+                if fullDump:
+                    out.append('')
+                print('\n'.join(out))
+
+            allResults.append((t, result))
+        
+        return success, allResults
+
+        
+class Token(ParserElement):
+    """
+    Abstract C{ParserElement} subclass, for defining atomic matching patterns.
+    """
+    def __init__( self ):
+        super(Token,self).__init__( savelist=False )
+
+
+class Empty(Token):
+    """
+    An empty token, will always match.
+    """
+    def __init__( self ):
+        super(Empty,self).__init__()
+        self.name = "Empty"
+        self.mayReturnEmpty = True
+        self.mayIndexError = False
+
+
+class NoMatch(Token):
+    """
+    A token that will never match.
+    """
+    def __init__( self ):
+        super(NoMatch,self).__init__()
+        self.name = "NoMatch"
+        self.mayReturnEmpty = True
+        self.mayIndexError = False
+        self.errmsg = "Unmatchable token"
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        raise ParseException(instring, loc, self.errmsg, self)
+
+
+class Literal(Token):
+    """
+    Token to exactly match a specified string.
+    
+    Example::
+        Literal('blah').parseString('blah')  # -> ['blah']
+        Literal('blah').parseString('blahfooblah')  # -> ['blah']
+        Literal('blah').parseString('bla')  # -> Exception: Expected "blah"
+    
+    For case-insensitive matching, use L{CaselessLiteral}.
+    
+    For keyword matching (force word break before and after the matched string),
+    use L{Keyword} or L{CaselessKeyword}.
+    """
+    def __init__( self, matchString ):
+        super(Literal,self).__init__()
+        self.match = matchString
+        self.matchLen = len(matchString)
+        try:
+            self.firstMatchChar = matchString[0]
+        except IndexError:
+            warnings.warn("null string passed to Literal; use Empty() instead",
+                            SyntaxWarning, stacklevel=2)
+            self.__class__ = Empty
+        self.name = '"%s"' % _ustr(self.match)
+        self.errmsg = "Expected " + self.name
+        self.mayReturnEmpty = False
+        self.mayIndexError = False
+
+    # Performance tuning: this routine gets called a *lot*
+    # if this is a single character match string  and the first character matches,
+    # short-circuit as quickly as possible, and avoid calling startswith
+    #~ @profile
+    def parseImpl( self, instring, loc, doActions=True ):
+        if (instring[loc] == self.firstMatchChar and
+            (self.matchLen==1 or instring.startswith(self.match,loc)) ):
+            return loc+self.matchLen, self.match
+        raise ParseException(instring, loc, self.errmsg, self)
+_L = Literal
+ParserElement._literalStringClass = Literal
+
+class Keyword(Token):
+    """
+    Token to exactly match a specified string as a keyword, that is, it must be
+    immediately followed by a non-keyword character.  Compare with C{L{Literal}}:
+     - C{Literal("if")} will match the leading C{'if'} in C{'ifAndOnlyIf'}.
+     - C{Keyword("if")} will not; it will only match the leading C{'if'} in C{'if x=1'}, or C{'if(y==2)'}
+    Accepts two optional constructor arguments in addition to the keyword string:
+     - C{identChars} is a string of characters that would be valid identifier characters,
+          defaulting to all alphanumerics + "_" and "$"
+     - C{caseless} allows case-insensitive matching, default is C{False}.
+       
+    Example::
+        Keyword("start").parseString("start")  # -> ['start']
+        Keyword("start").parseString("starting")  # -> Exception
+
+    For case-insensitive matching, use L{CaselessKeyword}.
+    """
+    DEFAULT_KEYWORD_CHARS = alphanums+"_$"
+
+    def __init__( self, matchString, identChars=None, caseless=False ):
+        super(Keyword,self).__init__()
+        if identChars is None:
+            identChars = Keyword.DEFAULT_KEYWORD_CHARS
+        self.match = matchString
+        self.matchLen = len(matchString)
+        try:
+            self.firstMatchChar = matchString[0]
+        except IndexError:
+            warnings.warn("null string passed to Keyword; use Empty() instead",
+                            SyntaxWarning, stacklevel=2)
+        self.name = '"%s"' % self.match
+        self.errmsg = "Expected " + self.name
+        self.mayReturnEmpty = False
+        self.mayIndexError = False
+        self.caseless = caseless
+        if caseless:
+            self.caselessmatch = matchString.upper()
+            identChars = identChars.upper()
+        self.identChars = set(identChars)
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if self.caseless:
+            if ( (instring[ loc:loc+self.matchLen ].upper() == self.caselessmatch) and
+                 (loc >= len(instring)-self.matchLen or instring[loc+self.matchLen].upper() not in self.identChars) and
+                 (loc == 0 or instring[loc-1].upper() not in self.identChars) ):
+                return loc+self.matchLen, self.match
+        else:
+            if (instring[loc] == self.firstMatchChar and
+                (self.matchLen==1 or instring.startswith(self.match,loc)) and
+                (loc >= len(instring)-self.matchLen or instring[loc+self.matchLen] not in self.identChars) and
+                (loc == 0 or instring[loc-1] not in self.identChars) ):
+                return loc+self.matchLen, self.match
+        raise ParseException(instring, loc, self.errmsg, self)
+
+    def copy(self):
+        c = super(Keyword,self).copy()
+        c.identChars = Keyword.DEFAULT_KEYWORD_CHARS
+        return c
+
+    @staticmethod
+    def setDefaultKeywordChars( chars ):
+        """Overrides the default Keyword chars
+        """
+        Keyword.DEFAULT_KEYWORD_CHARS = chars
+
+class CaselessLiteral(Literal):
+    """
+    Token to match a specified string, ignoring case of letters.
+    Note: the matched results will always be in the case of the given
+    match string, NOT the case of the input text.
+
+    Example::
+        OneOrMore(CaselessLiteral("CMD")).parseString("cmd CMD Cmd10") # -> ['CMD', 'CMD', 'CMD']
+        
+    (Contrast with example for L{CaselessKeyword}.)
+    """
+    def __init__( self, matchString ):
+        super(CaselessLiteral,self).__init__( matchString.upper() )
+        # Preserve the defining literal.
+        self.returnString = matchString
+        self.name = "'%s'" % self.returnString
+        self.errmsg = "Expected " + self.name
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if instring[ loc:loc+self.matchLen ].upper() == self.match:
+            return loc+self.matchLen, self.returnString
+        raise ParseException(instring, loc, self.errmsg, self)
+
+class CaselessKeyword(Keyword):
+    """
+    Caseless version of L{Keyword}.
+
+    Example::
+        OneOrMore(CaselessKeyword("CMD")).parseString("cmd CMD Cmd10") # -> ['CMD', 'CMD']
+        
+    (Contrast with example for L{CaselessLiteral}.)
+    """
+    def __init__( self, matchString, identChars=None ):
+        super(CaselessKeyword,self).__init__( matchString, identChars, caseless=True )
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if ( (instring[ loc:loc+self.matchLen ].upper() == self.caselessmatch) and
+             (loc >= len(instring)-self.matchLen or instring[loc+self.matchLen].upper() not in self.identChars) ):
+            return loc+self.matchLen, self.match
+        raise ParseException(instring, loc, self.errmsg, self)
+
+class CloseMatch(Token):
+    """
+    A variation on L{Literal} which matches "close" matches, that is, 
+    strings with at most 'n' mismatching characters. C{CloseMatch} takes parameters:
+     - C{match_string} - string to be matched
+     - C{maxMismatches} - (C{default=1}) maximum number of mismatches allowed to count as a match
+    
+    The results from a successful parse will contain the matched text from the input string and the following named results:
+     - C{mismatches} - a list of the positions within the match_string where mismatches were found
+     - C{original} - the original match_string used to compare against the input string
+    
+    If C{mismatches} is an empty list, then the match was an exact match.
+    
+    Example::
+        patt = CloseMatch("ATCATCGAATGGA")
+        patt.parseString("ATCATCGAAXGGA") # -> (['ATCATCGAAXGGA'], {'mismatches': [[9]], 'original': ['ATCATCGAATGGA']})
+        patt.parseString("ATCAXCGAAXGGA") # -> Exception: Expected 'ATCATCGAATGGA' (with up to 1 mismatches) (at char 0), (line:1, col:1)
+
+        # exact match
+        patt.parseString("ATCATCGAATGGA") # -> (['ATCATCGAATGGA'], {'mismatches': [[]], 'original': ['ATCATCGAATGGA']})
+
+        # close match allowing up to 2 mismatches
+        patt = CloseMatch("ATCATCGAATGGA", maxMismatches=2)
+        patt.parseString("ATCAXCGAAXGGA") # -> (['ATCAXCGAAXGGA'], {'mismatches': [[4, 9]], 'original': ['ATCATCGAATGGA']})
+    """
+    def __init__(self, match_string, maxMismatches=1):
+        super(CloseMatch,self).__init__()
+        self.name = match_string
+        self.match_string = match_string
+        self.maxMismatches = maxMismatches
+        self.errmsg = "Expected %r (with up to %d mismatches)" % (self.match_string, self.maxMismatches)
+        self.mayIndexError = False
+        self.mayReturnEmpty = False
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        start = loc
+        instrlen = len(instring)
+        maxloc = start + len(self.match_string)
+
+        if maxloc <= instrlen:
+            match_string = self.match_string
+            match_stringloc = 0
+            mismatches = []
+            maxMismatches = self.maxMismatches
+
+            for match_stringloc,s_m in enumerate(zip(instring[loc:maxloc], self.match_string)):
+                src,mat = s_m
+                if src != mat:
+                    mismatches.append(match_stringloc)
+                    if len(mismatches) > maxMismatches:
+                        break
+            else:
+                loc = match_stringloc + 1
+                results = ParseResults([instring[start:loc]])
+                results['original'] = self.match_string
+                results['mismatches'] = mismatches
+                return loc, results
+
+        raise ParseException(instring, loc, self.errmsg, self)
+
+
+class Word(Token):
+    """
+    Token for matching words composed of allowed character sets.
+    Defined with string containing all allowed initial characters,
+    an optional string containing allowed body characters (if omitted,
+    defaults to the initial character set), and an optional minimum,
+    maximum, and/or exact length.  The default value for C{min} is 1 (a
+    minimum value < 1 is not valid); the default values for C{max} and C{exact}
+    are 0, meaning no maximum or exact length restriction. An optional
+    C{excludeChars} parameter can list characters that might be found in 
+    the input C{bodyChars} string; useful to define a word of all printables
+    except for one or two characters, for instance.
+    
+    L{srange} is useful for defining custom character set strings for defining 
+    C{Word} expressions, using range notation from regular expression character sets.
+    
+    A common mistake is to use C{Word} to match a specific literal string, as in 
+    C{Word("Address")}. Remember that C{Word} uses the string argument to define
+    I{sets} of matchable characters. This expression would match "Add", "AAA",
+    "dAred", or any other word made up of the characters 'A', 'd', 'r', 'e', and 's'.
+    To match an exact literal string, use L{Literal} or L{Keyword}.
+
+    pyparsing includes helper strings for building Words:
+     - L{alphas}
+     - L{nums}
+     - L{alphanums}
+     - L{hexnums}
+     - L{alphas8bit} (alphabetic characters in ASCII range 128-255 - accented, tilded, umlauted, etc.)
+     - L{punc8bit} (non-alphabetic characters in ASCII range 128-255 - currency, symbols, superscripts, diacriticals, etc.)
+     - L{printables} (any non-whitespace character)
+
+    Example::
+        # a word composed of digits
+        integer = Word(nums) # equivalent to Word("0123456789") or Word(srange("0-9"))
+        
+        # a word with a leading capital, and zero or more lowercase
+        capital_word = Word(alphas.upper(), alphas.lower())
+
+        # hostnames are alphanumeric, with leading alpha, and '-'
+        hostname = Word(alphas, alphanums+'-')
+        
+        # roman numeral (not a strict parser, accepts invalid mix of characters)
+        roman = Word("IVXLCDM")
+        
+        # any string of non-whitespace characters, except for ','
+        csv_value = Word(printables, excludeChars=",")
+    """
+    def __init__( self, initChars, bodyChars=None, min=1, max=0, exact=0, asKeyword=False, excludeChars=None ):
+        super(Word,self).__init__()
+        if excludeChars:
+            initChars = ''.join(c for c in initChars if c not in excludeChars)
+            if bodyChars:
+                bodyChars = ''.join(c for c in bodyChars if c not in excludeChars)
+        self.initCharsOrig = initChars
+        self.initChars = set(initChars)
+        if bodyChars :
+            self.bodyCharsOrig = bodyChars
+            self.bodyChars = set(bodyChars)
+        else:
+            self.bodyCharsOrig = initChars
+            self.bodyChars = set(initChars)
+
+        self.maxSpecified = max > 0
+
+        if min < 1:
+            raise ValueError("cannot specify a minimum length < 1; use Optional(Word()) if zero-length word is permitted")
+
+        self.minLen = min
+
+        if max > 0:
+            self.maxLen = max
+        else:
+            self.maxLen = _MAX_INT
+
+        if exact > 0:
+            self.maxLen = exact
+            self.minLen = exact
+
+        self.name = _ustr(self)
+        self.errmsg = "Expected " + self.name
+        self.mayIndexError = False
+        self.asKeyword = asKeyword
+
+        if ' ' not in self.initCharsOrig+self.bodyCharsOrig and (min==1 and max==0 and exact==0):
+            if self.bodyCharsOrig == self.initCharsOrig:
+                self.reString = "[%s]+" % _escapeRegexRangeChars(self.initCharsOrig)
+            elif len(self.initCharsOrig) == 1:
+                self.reString = "%s[%s]*" % \
+                                      (re.escape(self.initCharsOrig),
+                                      _escapeRegexRangeChars(self.bodyCharsOrig),)
+            else:
+                self.reString = "[%s][%s]*" % \
+                                      (_escapeRegexRangeChars(self.initCharsOrig),
+                                      _escapeRegexRangeChars(self.bodyCharsOrig),)
+            if self.asKeyword:
+                self.reString = r"\b"+self.reString+r"\b"
+            try:
+                self.re = re.compile( self.reString )
+            except Exception:
+                self.re = None
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if self.re:
+            result = self.re.match(instring,loc)
+            if not result:
+                raise ParseException(instring, loc, self.errmsg, self)
+
+            loc = result.end()
+            return loc, result.group()
+
+        if not(instring[ loc ] in self.initChars):
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        start = loc
+        loc += 1
+        instrlen = len(instring)
+        bodychars = self.bodyChars
+        maxloc = start + self.maxLen
+        maxloc = min( maxloc, instrlen )
+        while loc < maxloc and instring[loc] in bodychars:
+            loc += 1
+
+        throwException = False
+        if loc - start < self.minLen:
+            throwException = True
+        if self.maxSpecified and loc < instrlen and instring[loc] in bodychars:
+            throwException = True
+        if self.asKeyword:
+            if (start>0 and instring[start-1] in bodychars) or (loc4:
+                    return s[:4]+"..."
+                else:
+                    return s
+
+            if ( self.initCharsOrig != self.bodyCharsOrig ):
+                self.strRepr = "W:(%s,%s)" % ( charsAsStr(self.initCharsOrig), charsAsStr(self.bodyCharsOrig) )
+            else:
+                self.strRepr = "W:(%s)" % charsAsStr(self.initCharsOrig)
+
+        return self.strRepr
+
+
+class Regex(Token):
+    r"""
+    Token for matching strings that match a given regular expression.
+    Defined with string specifying the regular expression in a form recognized by the inbuilt Python re module.
+    If the given regex contains named groups (defined using C{(?P...)}), these will be preserved as 
+    named parse results.
+
+    Example::
+        realnum = Regex(r"[+-]?\d+\.\d*")
+        date = Regex(r'(?P\d{4})-(?P\d\d?)-(?P\d\d?)')
+        # ref: http://stackoverflow.com/questions/267399/how-do-you-match-only-valid-roman-numerals-with-a-regular-expression
+        roman = Regex(r"M{0,4}(CM|CD|D?C{0,3})(XC|XL|L?X{0,3})(IX|IV|V?I{0,3})")
+    """
+    compiledREtype = type(re.compile("[A-Z]"))
+    def __init__( self, pattern, flags=0):
+        """The parameters C{pattern} and C{flags} are passed to the C{re.compile()} function as-is. See the Python C{re} module for an explanation of the acceptable patterns and flags."""
+        super(Regex,self).__init__()
+
+        if isinstance(pattern, basestring):
+            if not pattern:
+                warnings.warn("null string passed to Regex; use Empty() instead",
+                        SyntaxWarning, stacklevel=2)
+
+            self.pattern = pattern
+            self.flags = flags
+
+            try:
+                self.re = re.compile(self.pattern, self.flags)
+                self.reString = self.pattern
+            except sre_constants.error:
+                warnings.warn("invalid pattern (%s) passed to Regex" % pattern,
+                    SyntaxWarning, stacklevel=2)
+                raise
+
+        elif isinstance(pattern, Regex.compiledREtype):
+            self.re = pattern
+            self.pattern = \
+            self.reString = str(pattern)
+            self.flags = flags
+            
+        else:
+            raise ValueError("Regex may only be constructed with a string or a compiled RE object")
+
+        self.name = _ustr(self)
+        self.errmsg = "Expected " + self.name
+        self.mayIndexError = False
+        self.mayReturnEmpty = True
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        result = self.re.match(instring,loc)
+        if not result:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        loc = result.end()
+        d = result.groupdict()
+        ret = ParseResults(result.group())
+        if d:
+            for k in d:
+                ret[k] = d[k]
+        return loc,ret
+
+    def __str__( self ):
+        try:
+            return super(Regex,self).__str__()
+        except Exception:
+            pass
+
+        if self.strRepr is None:
+            self.strRepr = "Re:(%s)" % repr(self.pattern)
+
+        return self.strRepr
+
+
+class QuotedString(Token):
+    r"""
+    Token for matching strings that are delimited by quoting characters.
+    
+    Defined with the following parameters:
+        - quoteChar - string of one or more characters defining the quote delimiting string
+        - escChar - character to escape quotes, typically backslash (default=C{None})
+        - escQuote - special quote sequence to escape an embedded quote string (such as SQL's "" to escape an embedded ") (default=C{None})
+        - multiline - boolean indicating whether quotes can span multiple lines (default=C{False})
+        - unquoteResults - boolean indicating whether the matched text should be unquoted (default=C{True})
+        - endQuoteChar - string of one or more characters defining the end of the quote delimited string (default=C{None} => same as quoteChar)
+        - convertWhitespaceEscapes - convert escaped whitespace (C{'\t'}, C{'\n'}, etc.) to actual whitespace (default=C{True})
+
+    Example::
+        qs = QuotedString('"')
+        print(qs.searchString('lsjdf "This is the quote" sldjf'))
+        complex_qs = QuotedString('{{', endQuoteChar='}}')
+        print(complex_qs.searchString('lsjdf {{This is the "quote"}} sldjf'))
+        sql_qs = QuotedString('"', escQuote='""')
+        print(sql_qs.searchString('lsjdf "This is the quote with ""embedded"" quotes" sldjf'))
+    prints::
+        [['This is the quote']]
+        [['This is the "quote"']]
+        [['This is the quote with "embedded" quotes']]
+    """
+    def __init__( self, quoteChar, escChar=None, escQuote=None, multiline=False, unquoteResults=True, endQuoteChar=None, convertWhitespaceEscapes=True):
+        super(QuotedString,self).__init__()
+
+        # remove white space from quote chars - wont work anyway
+        quoteChar = quoteChar.strip()
+        if not quoteChar:
+            warnings.warn("quoteChar cannot be the empty string",SyntaxWarning,stacklevel=2)
+            raise SyntaxError()
+
+        if endQuoteChar is None:
+            endQuoteChar = quoteChar
+        else:
+            endQuoteChar = endQuoteChar.strip()
+            if not endQuoteChar:
+                warnings.warn("endQuoteChar cannot be the empty string",SyntaxWarning,stacklevel=2)
+                raise SyntaxError()
+
+        self.quoteChar = quoteChar
+        self.quoteCharLen = len(quoteChar)
+        self.firstQuoteChar = quoteChar[0]
+        self.endQuoteChar = endQuoteChar
+        self.endQuoteCharLen = len(endQuoteChar)
+        self.escChar = escChar
+        self.escQuote = escQuote
+        self.unquoteResults = unquoteResults
+        self.convertWhitespaceEscapes = convertWhitespaceEscapes
+
+        if multiline:
+            self.flags = re.MULTILINE | re.DOTALL
+            self.pattern = r'%s(?:[^%s%s]' % \
+                ( re.escape(self.quoteChar),
+                  _escapeRegexRangeChars(self.endQuoteChar[0]),
+                  (escChar is not None and _escapeRegexRangeChars(escChar) or '') )
+        else:
+            self.flags = 0
+            self.pattern = r'%s(?:[^%s\n\r%s]' % \
+                ( re.escape(self.quoteChar),
+                  _escapeRegexRangeChars(self.endQuoteChar[0]),
+                  (escChar is not None and _escapeRegexRangeChars(escChar) or '') )
+        if len(self.endQuoteChar) > 1:
+            self.pattern += (
+                '|(?:' + ')|(?:'.join("%s[^%s]" % (re.escape(self.endQuoteChar[:i]),
+                                               _escapeRegexRangeChars(self.endQuoteChar[i]))
+                                    for i in range(len(self.endQuoteChar)-1,0,-1)) + ')'
+                )
+        if escQuote:
+            self.pattern += (r'|(?:%s)' % re.escape(escQuote))
+        if escChar:
+            self.pattern += (r'|(?:%s.)' % re.escape(escChar))
+            self.escCharReplacePattern = re.escape(self.escChar)+"(.)"
+        self.pattern += (r')*%s' % re.escape(self.endQuoteChar))
+
+        try:
+            self.re = re.compile(self.pattern, self.flags)
+            self.reString = self.pattern
+        except sre_constants.error:
+            warnings.warn("invalid pattern (%s) passed to Regex" % self.pattern,
+                SyntaxWarning, stacklevel=2)
+            raise
+
+        self.name = _ustr(self)
+        self.errmsg = "Expected " + self.name
+        self.mayIndexError = False
+        self.mayReturnEmpty = True
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        result = instring[loc] == self.firstQuoteChar and self.re.match(instring,loc) or None
+        if not result:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        loc = result.end()
+        ret = result.group()
+
+        if self.unquoteResults:
+
+            # strip off quotes
+            ret = ret[self.quoteCharLen:-self.endQuoteCharLen]
+
+            if isinstance(ret,basestring):
+                # replace escaped whitespace
+                if '\\' in ret and self.convertWhitespaceEscapes:
+                    ws_map = {
+                        r'\t' : '\t',
+                        r'\n' : '\n',
+                        r'\f' : '\f',
+                        r'\r' : '\r',
+                    }
+                    for wslit,wschar in ws_map.items():
+                        ret = ret.replace(wslit, wschar)
+
+                # replace escaped characters
+                if self.escChar:
+                    ret = re.sub(self.escCharReplacePattern, r"\g<1>", ret)
+
+                # replace escaped quotes
+                if self.escQuote:
+                    ret = ret.replace(self.escQuote, self.endQuoteChar)
+
+        return loc, ret
+
+    def __str__( self ):
+        try:
+            return super(QuotedString,self).__str__()
+        except Exception:
+            pass
+
+        if self.strRepr is None:
+            self.strRepr = "quoted string, starting with %s ending with %s" % (self.quoteChar, self.endQuoteChar)
+
+        return self.strRepr
+
+
+class CharsNotIn(Token):
+    """
+    Token for matching words composed of characters I{not} in a given set (will
+    include whitespace in matched characters if not listed in the provided exclusion set - see example).
+    Defined with string containing all disallowed characters, and an optional
+    minimum, maximum, and/or exact length.  The default value for C{min} is 1 (a
+    minimum value < 1 is not valid); the default values for C{max} and C{exact}
+    are 0, meaning no maximum or exact length restriction.
+
+    Example::
+        # define a comma-separated-value as anything that is not a ','
+        csv_value = CharsNotIn(',')
+        print(delimitedList(csv_value).parseString("dkls,lsdkjf,s12 34,@!#,213"))
+    prints::
+        ['dkls', 'lsdkjf', 's12 34', '@!#', '213']
+    """
+    def __init__( self, notChars, min=1, max=0, exact=0 ):
+        super(CharsNotIn,self).__init__()
+        self.skipWhitespace = False
+        self.notChars = notChars
+
+        if min < 1:
+            raise ValueError("cannot specify a minimum length < 1; use Optional(CharsNotIn()) if zero-length char group is permitted")
+
+        self.minLen = min
+
+        if max > 0:
+            self.maxLen = max
+        else:
+            self.maxLen = _MAX_INT
+
+        if exact > 0:
+            self.maxLen = exact
+            self.minLen = exact
+
+        self.name = _ustr(self)
+        self.errmsg = "Expected " + self.name
+        self.mayReturnEmpty = ( self.minLen == 0 )
+        self.mayIndexError = False
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if instring[loc] in self.notChars:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        start = loc
+        loc += 1
+        notchars = self.notChars
+        maxlen = min( start+self.maxLen, len(instring) )
+        while loc < maxlen and \
+              (instring[loc] not in notchars):
+            loc += 1
+
+        if loc - start < self.minLen:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        return loc, instring[start:loc]
+
+    def __str__( self ):
+        try:
+            return super(CharsNotIn, self).__str__()
+        except Exception:
+            pass
+
+        if self.strRepr is None:
+            if len(self.notChars) > 4:
+                self.strRepr = "!W:(%s...)" % self.notChars[:4]
+            else:
+                self.strRepr = "!W:(%s)" % self.notChars
+
+        return self.strRepr
+
+class White(Token):
+    """
+    Special matching class for matching whitespace.  Normally, whitespace is ignored
+    by pyparsing grammars.  This class is included when some whitespace structures
+    are significant.  Define with a string containing the whitespace characters to be
+    matched; default is C{" \\t\\r\\n"}.  Also takes optional C{min}, C{max}, and C{exact} arguments,
+    as defined for the C{L{Word}} class.
+    """
+    whiteStrs = {
+        " " : "",
+        "\t": "",
+        "\n": "",
+        "\r": "",
+        "\f": "",
+        }
+    def __init__(self, ws=" \t\r\n", min=1, max=0, exact=0):
+        super(White,self).__init__()
+        self.matchWhite = ws
+        self.setWhitespaceChars( "".join(c for c in self.whiteChars if c not in self.matchWhite) )
+        #~ self.leaveWhitespace()
+        self.name = ("".join(White.whiteStrs[c] for c in self.matchWhite))
+        self.mayReturnEmpty = True
+        self.errmsg = "Expected " + self.name
+
+        self.minLen = min
+
+        if max > 0:
+            self.maxLen = max
+        else:
+            self.maxLen = _MAX_INT
+
+        if exact > 0:
+            self.maxLen = exact
+            self.minLen = exact
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if not(instring[ loc ] in self.matchWhite):
+            raise ParseException(instring, loc, self.errmsg, self)
+        start = loc
+        loc += 1
+        maxloc = start + self.maxLen
+        maxloc = min( maxloc, len(instring) )
+        while loc < maxloc and instring[loc] in self.matchWhite:
+            loc += 1
+
+        if loc - start < self.minLen:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        return loc, instring[start:loc]
+
+
+class _PositionToken(Token):
+    def __init__( self ):
+        super(_PositionToken,self).__init__()
+        self.name=self.__class__.__name__
+        self.mayReturnEmpty = True
+        self.mayIndexError = False
+
+class GoToColumn(_PositionToken):
+    """
+    Token to advance to a specific column of input text; useful for tabular report scraping.
+    """
+    def __init__( self, colno ):
+        super(GoToColumn,self).__init__()
+        self.col = colno
+
+    def preParse( self, instring, loc ):
+        if col(loc,instring) != self.col:
+            instrlen = len(instring)
+            if self.ignoreExprs:
+                loc = self._skipIgnorables( instring, loc )
+            while loc < instrlen and instring[loc].isspace() and col( loc, instring ) != self.col :
+                loc += 1
+        return loc
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        thiscol = col( loc, instring )
+        if thiscol > self.col:
+            raise ParseException( instring, loc, "Text not in expected column", self )
+        newloc = loc + self.col - thiscol
+        ret = instring[ loc: newloc ]
+        return newloc, ret
+
+
+class LineStart(_PositionToken):
+    """
+    Matches if current position is at the beginning of a line within the parse string
+    
+    Example::
+    
+        test = '''\
+        AAA this line
+        AAA and this line
+          AAA but not this one
+        B AAA and definitely not this one
+        '''
+
+        for t in (LineStart() + 'AAA' + restOfLine).searchString(test):
+            print(t)
+    
+    Prints::
+        ['AAA', ' this line']
+        ['AAA', ' and this line']    
+
+    """
+    def __init__( self ):
+        super(LineStart,self).__init__()
+        self.errmsg = "Expected start of line"
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if col(loc, instring) == 1:
+            return loc, []
+        raise ParseException(instring, loc, self.errmsg, self)
+
+class LineEnd(_PositionToken):
+    """
+    Matches if current position is at the end of a line within the parse string
+    """
+    def __init__( self ):
+        super(LineEnd,self).__init__()
+        self.setWhitespaceChars( ParserElement.DEFAULT_WHITE_CHARS.replace("\n","") )
+        self.errmsg = "Expected end of line"
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if loc len(instring):
+            return loc, []
+        else:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+class WordStart(_PositionToken):
+    """
+    Matches if the current position is at the beginning of a Word, and
+    is not preceded by any character in a given set of C{wordChars}
+    (default=C{printables}). To emulate the C{\b} behavior of regular expressions,
+    use C{WordStart(alphanums)}. C{WordStart} will also match at the beginning of
+    the string being parsed, or at the beginning of a line.
+    """
+    def __init__(self, wordChars = printables):
+        super(WordStart,self).__init__()
+        self.wordChars = set(wordChars)
+        self.errmsg = "Not at the start of a word"
+
+    def parseImpl(self, instring, loc, doActions=True ):
+        if loc != 0:
+            if (instring[loc-1] in self.wordChars or
+                instring[loc] not in self.wordChars):
+                raise ParseException(instring, loc, self.errmsg, self)
+        return loc, []
+
+class WordEnd(_PositionToken):
+    """
+    Matches if the current position is at the end of a Word, and
+    is not followed by any character in a given set of C{wordChars}
+    (default=C{printables}). To emulate the C{\b} behavior of regular expressions,
+    use C{WordEnd(alphanums)}. C{WordEnd} will also match at the end of
+    the string being parsed, or at the end of a line.
+    """
+    def __init__(self, wordChars = printables):
+        super(WordEnd,self).__init__()
+        self.wordChars = set(wordChars)
+        self.skipWhitespace = False
+        self.errmsg = "Not at the end of a word"
+
+    def parseImpl(self, instring, loc, doActions=True ):
+        instrlen = len(instring)
+        if instrlen>0 and loc maxExcLoc:
+                    maxException = err
+                    maxExcLoc = err.loc
+            except IndexError:
+                if len(instring) > maxExcLoc:
+                    maxException = ParseException(instring,len(instring),e.errmsg,self)
+                    maxExcLoc = len(instring)
+            else:
+                # save match among all matches, to retry longest to shortest
+                matches.append((loc2, e))
+
+        if matches:
+            matches.sort(key=lambda x: -x[0])
+            for _,e in matches:
+                try:
+                    return e._parse( instring, loc, doActions )
+                except ParseException as err:
+                    err.__traceback__ = None
+                    if err.loc > maxExcLoc:
+                        maxException = err
+                        maxExcLoc = err.loc
+
+        if maxException is not None:
+            maxException.msg = self.errmsg
+            raise maxException
+        else:
+            raise ParseException(instring, loc, "no defined alternatives to match", self)
+
+
+    def __ixor__(self, other ):
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        return self.append( other ) #Or( [ self, other ] )
+
+    def __str__( self ):
+        if hasattr(self,"name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "{" + " ^ ".join(_ustr(e) for e in self.exprs) + "}"
+
+        return self.strRepr
+
+    def checkRecursion( self, parseElementList ):
+        subRecCheckList = parseElementList[:] + [ self ]
+        for e in self.exprs:
+            e.checkRecursion( subRecCheckList )
+
+
+class MatchFirst(ParseExpression):
+    """
+    Requires that at least one C{ParseExpression} is found.
+    If two expressions match, the first one listed is the one that will match.
+    May be constructed using the C{'|'} operator.
+
+    Example::
+        # construct MatchFirst using '|' operator
+        
+        # watch the order of expressions to match
+        number = Word(nums) | Combine(Word(nums) + '.' + Word(nums))
+        print(number.searchString("123 3.1416 789")) #  Fail! -> [['123'], ['3'], ['1416'], ['789']]
+
+        # put more selective expression first
+        number = Combine(Word(nums) + '.' + Word(nums)) | Word(nums)
+        print(number.searchString("123 3.1416 789")) #  Better -> [['123'], ['3.1416'], ['789']]
+    """
+    def __init__( self, exprs, savelist = False ):
+        super(MatchFirst,self).__init__(exprs, savelist)
+        if self.exprs:
+            self.mayReturnEmpty = any(e.mayReturnEmpty for e in self.exprs)
+        else:
+            self.mayReturnEmpty = True
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        maxExcLoc = -1
+        maxException = None
+        for e in self.exprs:
+            try:
+                ret = e._parse( instring, loc, doActions )
+                return ret
+            except ParseException as err:
+                if err.loc > maxExcLoc:
+                    maxException = err
+                    maxExcLoc = err.loc
+            except IndexError:
+                if len(instring) > maxExcLoc:
+                    maxException = ParseException(instring,len(instring),e.errmsg,self)
+                    maxExcLoc = len(instring)
+
+        # only got here if no expression matched, raise exception for match that made it the furthest
+        else:
+            if maxException is not None:
+                maxException.msg = self.errmsg
+                raise maxException
+            else:
+                raise ParseException(instring, loc, "no defined alternatives to match", self)
+
+    def __ior__(self, other ):
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        return self.append( other ) #MatchFirst( [ self, other ] )
+
+    def __str__( self ):
+        if hasattr(self,"name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "{" + " | ".join(_ustr(e) for e in self.exprs) + "}"
+
+        return self.strRepr
+
+    def checkRecursion( self, parseElementList ):
+        subRecCheckList = parseElementList[:] + [ self ]
+        for e in self.exprs:
+            e.checkRecursion( subRecCheckList )
+
+
+class Each(ParseExpression):
+    """
+    Requires all given C{ParseExpression}s to be found, but in any order.
+    Expressions may be separated by whitespace.
+    May be constructed using the C{'&'} operator.
+
+    Example::
+        color = oneOf("RED ORANGE YELLOW GREEN BLUE PURPLE BLACK WHITE BROWN")
+        shape_type = oneOf("SQUARE CIRCLE TRIANGLE STAR HEXAGON OCTAGON")
+        integer = Word(nums)
+        shape_attr = "shape:" + shape_type("shape")
+        posn_attr = "posn:" + Group(integer("x") + ',' + integer("y"))("posn")
+        color_attr = "color:" + color("color")
+        size_attr = "size:" + integer("size")
+
+        # use Each (using operator '&') to accept attributes in any order 
+        # (shape and posn are required, color and size are optional)
+        shape_spec = shape_attr & posn_attr & Optional(color_attr) & Optional(size_attr)
+
+        shape_spec.runTests('''
+            shape: SQUARE color: BLACK posn: 100, 120
+            shape: CIRCLE size: 50 color: BLUE posn: 50,80
+            color:GREEN size:20 shape:TRIANGLE posn:20,40
+            '''
+            )
+    prints::
+        shape: SQUARE color: BLACK posn: 100, 120
+        ['shape:', 'SQUARE', 'color:', 'BLACK', 'posn:', ['100', ',', '120']]
+        - color: BLACK
+        - posn: ['100', ',', '120']
+          - x: 100
+          - y: 120
+        - shape: SQUARE
+
+
+        shape: CIRCLE size: 50 color: BLUE posn: 50,80
+        ['shape:', 'CIRCLE', 'size:', '50', 'color:', 'BLUE', 'posn:', ['50', ',', '80']]
+        - color: BLUE
+        - posn: ['50', ',', '80']
+          - x: 50
+          - y: 80
+        - shape: CIRCLE
+        - size: 50
+
+
+        color: GREEN size: 20 shape: TRIANGLE posn: 20,40
+        ['color:', 'GREEN', 'size:', '20', 'shape:', 'TRIANGLE', 'posn:', ['20', ',', '40']]
+        - color: GREEN
+        - posn: ['20', ',', '40']
+          - x: 20
+          - y: 40
+        - shape: TRIANGLE
+        - size: 20
+    """
+    def __init__( self, exprs, savelist = True ):
+        super(Each,self).__init__(exprs, savelist)
+        self.mayReturnEmpty = all(e.mayReturnEmpty for e in self.exprs)
+        self.skipWhitespace = True
+        self.initExprGroups = True
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if self.initExprGroups:
+            self.opt1map = dict((id(e.expr),e) for e in self.exprs if isinstance(e,Optional))
+            opt1 = [ e.expr for e in self.exprs if isinstance(e,Optional) ]
+            opt2 = [ e for e in self.exprs if e.mayReturnEmpty and not isinstance(e,Optional)]
+            self.optionals = opt1 + opt2
+            self.multioptionals = [ e.expr for e in self.exprs if isinstance(e,ZeroOrMore) ]
+            self.multirequired = [ e.expr for e in self.exprs if isinstance(e,OneOrMore) ]
+            self.required = [ e for e in self.exprs if not isinstance(e,(Optional,ZeroOrMore,OneOrMore)) ]
+            self.required += self.multirequired
+            self.initExprGroups = False
+        tmpLoc = loc
+        tmpReqd = self.required[:]
+        tmpOpt  = self.optionals[:]
+        matchOrder = []
+
+        keepMatching = True
+        while keepMatching:
+            tmpExprs = tmpReqd + tmpOpt + self.multioptionals + self.multirequired
+            failed = []
+            for e in tmpExprs:
+                try:
+                    tmpLoc = e.tryParse( instring, tmpLoc )
+                except ParseException:
+                    failed.append(e)
+                else:
+                    matchOrder.append(self.opt1map.get(id(e),e))
+                    if e in tmpReqd:
+                        tmpReqd.remove(e)
+                    elif e in tmpOpt:
+                        tmpOpt.remove(e)
+            if len(failed) == len(tmpExprs):
+                keepMatching = False
+
+        if tmpReqd:
+            missing = ", ".join(_ustr(e) for e in tmpReqd)
+            raise ParseException(instring,loc,"Missing one or more required elements (%s)" % missing )
+
+        # add any unmatched Optionals, in case they have default values defined
+        matchOrder += [e for e in self.exprs if isinstance(e,Optional) and e.expr in tmpOpt]
+
+        resultlist = []
+        for e in matchOrder:
+            loc,results = e._parse(instring,loc,doActions)
+            resultlist.append(results)
+
+        finalResults = sum(resultlist, ParseResults([]))
+        return loc, finalResults
+
+    def __str__( self ):
+        if hasattr(self,"name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "{" + " & ".join(_ustr(e) for e in self.exprs) + "}"
+
+        return self.strRepr
+
+    def checkRecursion( self, parseElementList ):
+        subRecCheckList = parseElementList[:] + [ self ]
+        for e in self.exprs:
+            e.checkRecursion( subRecCheckList )
+
+
+class ParseElementEnhance(ParserElement):
+    """
+    Abstract subclass of C{ParserElement}, for combining and post-processing parsed tokens.
+    """
+    def __init__( self, expr, savelist=False ):
+        super(ParseElementEnhance,self).__init__(savelist)
+        if isinstance( expr, basestring ):
+            if issubclass(ParserElement._literalStringClass, Token):
+                expr = ParserElement._literalStringClass(expr)
+            else:
+                expr = ParserElement._literalStringClass(Literal(expr))
+        self.expr = expr
+        self.strRepr = None
+        if expr is not None:
+            self.mayIndexError = expr.mayIndexError
+            self.mayReturnEmpty = expr.mayReturnEmpty
+            self.setWhitespaceChars( expr.whiteChars )
+            self.skipWhitespace = expr.skipWhitespace
+            self.saveAsList = expr.saveAsList
+            self.callPreparse = expr.callPreparse
+            self.ignoreExprs.extend(expr.ignoreExprs)
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if self.expr is not None:
+            return self.expr._parse( instring, loc, doActions, callPreParse=False )
+        else:
+            raise ParseException("",loc,self.errmsg,self)
+
+    def leaveWhitespace( self ):
+        self.skipWhitespace = False
+        self.expr = self.expr.copy()
+        if self.expr is not None:
+            self.expr.leaveWhitespace()
+        return self
+
+    def ignore( self, other ):
+        if isinstance( other, Suppress ):
+            if other not in self.ignoreExprs:
+                super( ParseElementEnhance, self).ignore( other )
+                if self.expr is not None:
+                    self.expr.ignore( self.ignoreExprs[-1] )
+        else:
+            super( ParseElementEnhance, self).ignore( other )
+            if self.expr is not None:
+                self.expr.ignore( self.ignoreExprs[-1] )
+        return self
+
+    def streamline( self ):
+        super(ParseElementEnhance,self).streamline()
+        if self.expr is not None:
+            self.expr.streamline()
+        return self
+
+    def checkRecursion( self, parseElementList ):
+        if self in parseElementList:
+            raise RecursiveGrammarException( parseElementList+[self] )
+        subRecCheckList = parseElementList[:] + [ self ]
+        if self.expr is not None:
+            self.expr.checkRecursion( subRecCheckList )
+
+    def validate( self, validateTrace=[] ):
+        tmp = validateTrace[:]+[self]
+        if self.expr is not None:
+            self.expr.validate(tmp)
+        self.checkRecursion( [] )
+
+    def __str__( self ):
+        try:
+            return super(ParseElementEnhance,self).__str__()
+        except Exception:
+            pass
+
+        if self.strRepr is None and self.expr is not None:
+            self.strRepr = "%s:(%s)" % ( self.__class__.__name__, _ustr(self.expr) )
+        return self.strRepr
+
+
+class FollowedBy(ParseElementEnhance):
+    """
+    Lookahead matching of the given parse expression.  C{FollowedBy}
+    does I{not} advance the parsing position within the input string, it only
+    verifies that the specified parse expression matches at the current
+    position.  C{FollowedBy} always returns a null token list.
+
+    Example::
+        # use FollowedBy to match a label only if it is followed by a ':'
+        data_word = Word(alphas)
+        label = data_word + FollowedBy(':')
+        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
+        
+        OneOrMore(attr_expr).parseString("shape: SQUARE color: BLACK posn: upper left").pprint()
+    prints::
+        [['shape', 'SQUARE'], ['color', 'BLACK'], ['posn', 'upper left']]
+    """
+    def __init__( self, expr ):
+        super(FollowedBy,self).__init__(expr)
+        self.mayReturnEmpty = True
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        self.expr.tryParse( instring, loc )
+        return loc, []
+
+
+class NotAny(ParseElementEnhance):
+    """
+    Lookahead to disallow matching with the given parse expression.  C{NotAny}
+    does I{not} advance the parsing position within the input string, it only
+    verifies that the specified parse expression does I{not} match at the current
+    position.  Also, C{NotAny} does I{not} skip over leading whitespace. C{NotAny}
+    always returns a null token list.  May be constructed using the '~' operator.
+
+    Example::
+        
+    """
+    def __init__( self, expr ):
+        super(NotAny,self).__init__(expr)
+        #~ self.leaveWhitespace()
+        self.skipWhitespace = False  # do NOT use self.leaveWhitespace(), don't want to propagate to exprs
+        self.mayReturnEmpty = True
+        self.errmsg = "Found unwanted token, "+_ustr(self.expr)
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if self.expr.canParseNext(instring, loc):
+            raise ParseException(instring, loc, self.errmsg, self)
+        return loc, []
+
+    def __str__( self ):
+        if hasattr(self,"name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "~{" + _ustr(self.expr) + "}"
+
+        return self.strRepr
+
+class _MultipleMatch(ParseElementEnhance):
+    def __init__( self, expr, stopOn=None):
+        super(_MultipleMatch, self).__init__(expr)
+        self.saveAsList = True
+        ender = stopOn
+        if isinstance(ender, basestring):
+            ender = ParserElement._literalStringClass(ender)
+        self.not_ender = ~ender if ender is not None else None
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        self_expr_parse = self.expr._parse
+        self_skip_ignorables = self._skipIgnorables
+        check_ender = self.not_ender is not None
+        if check_ender:
+            try_not_ender = self.not_ender.tryParse
+        
+        # must be at least one (but first see if we are the stopOn sentinel;
+        # if so, fail)
+        if check_ender:
+            try_not_ender(instring, loc)
+        loc, tokens = self_expr_parse( instring, loc, doActions, callPreParse=False )
+        try:
+            hasIgnoreExprs = (not not self.ignoreExprs)
+            while 1:
+                if check_ender:
+                    try_not_ender(instring, loc)
+                if hasIgnoreExprs:
+                    preloc = self_skip_ignorables( instring, loc )
+                else:
+                    preloc = loc
+                loc, tmptokens = self_expr_parse( instring, preloc, doActions )
+                if tmptokens or tmptokens.haskeys():
+                    tokens += tmptokens
+        except (ParseException,IndexError):
+            pass
+
+        return loc, tokens
+        
+class OneOrMore(_MultipleMatch):
+    """
+    Repetition of one or more of the given expression.
+    
+    Parameters:
+     - expr - expression that must match one or more times
+     - stopOn - (default=C{None}) - expression for a terminating sentinel
+          (only required if the sentinel would ordinarily match the repetition 
+          expression)          
+
+    Example::
+        data_word = Word(alphas)
+        label = data_word + FollowedBy(':')
+        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word).setParseAction(' '.join))
+
+        text = "shape: SQUARE posn: upper left color: BLACK"
+        OneOrMore(attr_expr).parseString(text).pprint()  # Fail! read 'color' as data instead of next label -> [['shape', 'SQUARE color']]
+
+        # use stopOn attribute for OneOrMore to avoid reading label string as part of the data
+        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
+        OneOrMore(attr_expr).parseString(text).pprint() # Better -> [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'BLACK']]
+        
+        # could also be written as
+        (attr_expr * (1,)).parseString(text).pprint()
+    """
+
+    def __str__( self ):
+        if hasattr(self,"name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "{" + _ustr(self.expr) + "}..."
+
+        return self.strRepr
+
+class ZeroOrMore(_MultipleMatch):
+    """
+    Optional repetition of zero or more of the given expression.
+    
+    Parameters:
+     - expr - expression that must match zero or more times
+     - stopOn - (default=C{None}) - expression for a terminating sentinel
+          (only required if the sentinel would ordinarily match the repetition 
+          expression)          
+
+    Example: similar to L{OneOrMore}
+    """
+    def __init__( self, expr, stopOn=None):
+        super(ZeroOrMore,self).__init__(expr, stopOn=stopOn)
+        self.mayReturnEmpty = True
+        
+    def parseImpl( self, instring, loc, doActions=True ):
+        try:
+            return super(ZeroOrMore, self).parseImpl(instring, loc, doActions)
+        except (ParseException,IndexError):
+            return loc, []
+
+    def __str__( self ):
+        if hasattr(self,"name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "[" + _ustr(self.expr) + "]..."
+
+        return self.strRepr
+
+class _NullToken(object):
+    def __bool__(self):
+        return False
+    __nonzero__ = __bool__
+    def __str__(self):
+        return ""
+
+_optionalNotMatched = _NullToken()
+class Optional(ParseElementEnhance):
+    """
+    Optional matching of the given expression.
+
+    Parameters:
+     - expr - expression that must match zero or more times
+     - default (optional) - value to be returned if the optional expression is not found.
+
+    Example::
+        # US postal code can be a 5-digit zip, plus optional 4-digit qualifier
+        zip = Combine(Word(nums, exact=5) + Optional('-' + Word(nums, exact=4)))
+        zip.runTests('''
+            # traditional ZIP code
+            12345
+            
+            # ZIP+4 form
+            12101-0001
+            
+            # invalid ZIP
+            98765-
+            ''')
+    prints::
+        # traditional ZIP code
+        12345
+        ['12345']
+
+        # ZIP+4 form
+        12101-0001
+        ['12101-0001']
+
+        # invalid ZIP
+        98765-
+             ^
+        FAIL: Expected end of text (at char 5), (line:1, col:6)
+    """
+    def __init__( self, expr, default=_optionalNotMatched ):
+        super(Optional,self).__init__( expr, savelist=False )
+        self.saveAsList = self.expr.saveAsList
+        self.defaultValue = default
+        self.mayReturnEmpty = True
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        try:
+            loc, tokens = self.expr._parse( instring, loc, doActions, callPreParse=False )
+        except (ParseException,IndexError):
+            if self.defaultValue is not _optionalNotMatched:
+                if self.expr.resultsName:
+                    tokens = ParseResults([ self.defaultValue ])
+                    tokens[self.expr.resultsName] = self.defaultValue
+                else:
+                    tokens = [ self.defaultValue ]
+            else:
+                tokens = []
+        return loc, tokens
+
+    def __str__( self ):
+        if hasattr(self,"name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "[" + _ustr(self.expr) + "]"
+
+        return self.strRepr
+
+class SkipTo(ParseElementEnhance):
+    """
+    Token for skipping over all undefined text until the matched expression is found.
+
+    Parameters:
+     - expr - target expression marking the end of the data to be skipped
+     - include - (default=C{False}) if True, the target expression is also parsed 
+          (the skipped text and target expression are returned as a 2-element list).
+     - ignore - (default=C{None}) used to define grammars (typically quoted strings and 
+          comments) that might contain false matches to the target expression
+     - failOn - (default=C{None}) define expressions that are not allowed to be 
+          included in the skipped test; if found before the target expression is found, 
+          the SkipTo is not a match
+
+    Example::
+        report = '''
+            Outstanding Issues Report - 1 Jan 2000
+
+               # | Severity | Description                               |  Days Open
+            -----+----------+-------------------------------------------+-----------
+             101 | Critical | Intermittent system crash                 |          6
+              94 | Cosmetic | Spelling error on Login ('log|n')         |         14
+              79 | Minor    | System slow when running too many reports |         47
+            '''
+        integer = Word(nums)
+        SEP = Suppress('|')
+        # use SkipTo to simply match everything up until the next SEP
+        # - ignore quoted strings, so that a '|' character inside a quoted string does not match
+        # - parse action will call token.strip() for each matched token, i.e., the description body
+        string_data = SkipTo(SEP, ignore=quotedString)
+        string_data.setParseAction(tokenMap(str.strip))
+        ticket_expr = (integer("issue_num") + SEP 
+                      + string_data("sev") + SEP 
+                      + string_data("desc") + SEP 
+                      + integer("days_open"))
+        
+        for tkt in ticket_expr.searchString(report):
+            print tkt.dump()
+    prints::
+        ['101', 'Critical', 'Intermittent system crash', '6']
+        - days_open: 6
+        - desc: Intermittent system crash
+        - issue_num: 101
+        - sev: Critical
+        ['94', 'Cosmetic', "Spelling error on Login ('log|n')", '14']
+        - days_open: 14
+        - desc: Spelling error on Login ('log|n')
+        - issue_num: 94
+        - sev: Cosmetic
+        ['79', 'Minor', 'System slow when running too many reports', '47']
+        - days_open: 47
+        - desc: System slow when running too many reports
+        - issue_num: 79
+        - sev: Minor
+    """
+    def __init__( self, other, include=False, ignore=None, failOn=None ):
+        super( SkipTo, self ).__init__( other )
+        self.ignoreExpr = ignore
+        self.mayReturnEmpty = True
+        self.mayIndexError = False
+        self.includeMatch = include
+        self.asList = False
+        if isinstance(failOn, basestring):
+            self.failOn = ParserElement._literalStringClass(failOn)
+        else:
+            self.failOn = failOn
+        self.errmsg = "No match found for "+_ustr(self.expr)
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        startloc = loc
+        instrlen = len(instring)
+        expr = self.expr
+        expr_parse = self.expr._parse
+        self_failOn_canParseNext = self.failOn.canParseNext if self.failOn is not None else None
+        self_ignoreExpr_tryParse = self.ignoreExpr.tryParse if self.ignoreExpr is not None else None
+        
+        tmploc = loc
+        while tmploc <= instrlen:
+            if self_failOn_canParseNext is not None:
+                # break if failOn expression matches
+                if self_failOn_canParseNext(instring, tmploc):
+                    break
+                    
+            if self_ignoreExpr_tryParse is not None:
+                # advance past ignore expressions
+                while 1:
+                    try:
+                        tmploc = self_ignoreExpr_tryParse(instring, tmploc)
+                    except ParseBaseException:
+                        break
+            
+            try:
+                expr_parse(instring, tmploc, doActions=False, callPreParse=False)
+            except (ParseException, IndexError):
+                # no match, advance loc in string
+                tmploc += 1
+            else:
+                # matched skipto expr, done
+                break
+
+        else:
+            # ran off the end of the input string without matching skipto expr, fail
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        # build up return values
+        loc = tmploc
+        skiptext = instring[startloc:loc]
+        skipresult = ParseResults(skiptext)
+        
+        if self.includeMatch:
+            loc, mat = expr_parse(instring,loc,doActions,callPreParse=False)
+            skipresult += mat
+
+        return loc, skipresult
+
+class Forward(ParseElementEnhance):
+    """
+    Forward declaration of an expression to be defined later -
+    used for recursive grammars, such as algebraic infix notation.
+    When the expression is known, it is assigned to the C{Forward} variable using the '<<' operator.
+
+    Note: take care when assigning to C{Forward} not to overlook precedence of operators.
+    Specifically, '|' has a lower precedence than '<<', so that::
+        fwdExpr << a | b | c
+    will actually be evaluated as::
+        (fwdExpr << a) | b | c
+    thereby leaving b and c out as parseable alternatives.  It is recommended that you
+    explicitly group the values inserted into the C{Forward}::
+        fwdExpr << (a | b | c)
+    Converting to use the '<<=' operator instead will avoid this problem.
+
+    See L{ParseResults.pprint} for an example of a recursive parser created using
+    C{Forward}.
+    """
+    def __init__( self, other=None ):
+        super(Forward,self).__init__( other, savelist=False )
+
+    def __lshift__( self, other ):
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass(other)
+        self.expr = other
+        self.strRepr = None
+        self.mayIndexError = self.expr.mayIndexError
+        self.mayReturnEmpty = self.expr.mayReturnEmpty
+        self.setWhitespaceChars( self.expr.whiteChars )
+        self.skipWhitespace = self.expr.skipWhitespace
+        self.saveAsList = self.expr.saveAsList
+        self.ignoreExprs.extend(self.expr.ignoreExprs)
+        return self
+        
+    def __ilshift__(self, other):
+        return self << other
+    
+    def leaveWhitespace( self ):
+        self.skipWhitespace = False
+        return self
+
+    def streamline( self ):
+        if not self.streamlined:
+            self.streamlined = True
+            if self.expr is not None:
+                self.expr.streamline()
+        return self
+
+    def validate( self, validateTrace=[] ):
+        if self not in validateTrace:
+            tmp = validateTrace[:]+[self]
+            if self.expr is not None:
+                self.expr.validate(tmp)
+        self.checkRecursion([])
+
+    def __str__( self ):
+        if hasattr(self,"name"):
+            return self.name
+        return self.__class__.__name__ + ": ..."
+
+        # stubbed out for now - creates awful memory and perf issues
+        self._revertClass = self.__class__
+        self.__class__ = _ForwardNoRecurse
+        try:
+            if self.expr is not None:
+                retString = _ustr(self.expr)
+            else:
+                retString = "None"
+        finally:
+            self.__class__ = self._revertClass
+        return self.__class__.__name__ + ": " + retString
+
+    def copy(self):
+        if self.expr is not None:
+            return super(Forward,self).copy()
+        else:
+            ret = Forward()
+            ret <<= self
+            return ret
+
+class _ForwardNoRecurse(Forward):
+    def __str__( self ):
+        return "..."
+
+class TokenConverter(ParseElementEnhance):
+    """
+    Abstract subclass of C{ParseExpression}, for converting parsed results.
+    """
+    def __init__( self, expr, savelist=False ):
+        super(TokenConverter,self).__init__( expr )#, savelist )
+        self.saveAsList = False
+
+class Combine(TokenConverter):
+    """
+    Converter to concatenate all matching tokens to a single string.
+    By default, the matching patterns must also be contiguous in the input string;
+    this can be disabled by specifying C{'adjacent=False'} in the constructor.
+
+    Example::
+        real = Word(nums) + '.' + Word(nums)
+        print(real.parseString('3.1416')) # -> ['3', '.', '1416']
+        # will also erroneously match the following
+        print(real.parseString('3. 1416')) # -> ['3', '.', '1416']
+
+        real = Combine(Word(nums) + '.' + Word(nums))
+        print(real.parseString('3.1416')) # -> ['3.1416']
+        # no match when there are internal spaces
+        print(real.parseString('3. 1416')) # -> Exception: Expected W:(0123...)
+    """
+    def __init__( self, expr, joinString="", adjacent=True ):
+        super(Combine,self).__init__( expr )
+        # suppress whitespace-stripping in contained parse expressions, but re-enable it on the Combine itself
+        if adjacent:
+            self.leaveWhitespace()
+        self.adjacent = adjacent
+        self.skipWhitespace = True
+        self.joinString = joinString
+        self.callPreparse = True
+
+    def ignore( self, other ):
+        if self.adjacent:
+            ParserElement.ignore(self, other)
+        else:
+            super( Combine, self).ignore( other )
+        return self
+
+    def postParse( self, instring, loc, tokenlist ):
+        retToks = tokenlist.copy()
+        del retToks[:]
+        retToks += ParseResults([ "".join(tokenlist._asStringList(self.joinString)) ], modal=self.modalResults)
+
+        if self.resultsName and retToks.haskeys():
+            return [ retToks ]
+        else:
+            return retToks
+
+class Group(TokenConverter):
+    """
+    Converter to return the matched tokens as a list - useful for returning tokens of C{L{ZeroOrMore}} and C{L{OneOrMore}} expressions.
+
+    Example::
+        ident = Word(alphas)
+        num = Word(nums)
+        term = ident | num
+        func = ident + Optional(delimitedList(term))
+        print(func.parseString("fn a,b,100"))  # -> ['fn', 'a', 'b', '100']
+
+        func = ident + Group(Optional(delimitedList(term)))
+        print(func.parseString("fn a,b,100"))  # -> ['fn', ['a', 'b', '100']]
+    """
+    def __init__( self, expr ):
+        super(Group,self).__init__( expr )
+        self.saveAsList = True
+
+    def postParse( self, instring, loc, tokenlist ):
+        return [ tokenlist ]
+
+class Dict(TokenConverter):
+    """
+    Converter to return a repetitive expression as a list, but also as a dictionary.
+    Each element can also be referenced using the first token in the expression as its key.
+    Useful for tabular report scraping when the first column can be used as a item key.
+
+    Example::
+        data_word = Word(alphas)
+        label = data_word + FollowedBy(':')
+        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word).setParseAction(' '.join))
+
+        text = "shape: SQUARE posn: upper left color: light blue texture: burlap"
+        attr_expr = (label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
+        
+        # print attributes as plain groups
+        print(OneOrMore(attr_expr).parseString(text).dump())
+        
+        # instead of OneOrMore(expr), parse using Dict(OneOrMore(Group(expr))) - Dict will auto-assign names
+        result = Dict(OneOrMore(Group(attr_expr))).parseString(text)
+        print(result.dump())
+        
+        # access named fields as dict entries, or output as dict
+        print(result['shape'])        
+        print(result.asDict())
+    prints::
+        ['shape', 'SQUARE', 'posn', 'upper left', 'color', 'light blue', 'texture', 'burlap']
+
+        [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'light blue'], ['texture', 'burlap']]
+        - color: light blue
+        - posn: upper left
+        - shape: SQUARE
+        - texture: burlap
+        SQUARE
+        {'color': 'light blue', 'posn': 'upper left', 'texture': 'burlap', 'shape': 'SQUARE'}
+    See more examples at L{ParseResults} of accessing fields by results name.
+    """
+    def __init__( self, expr ):
+        super(Dict,self).__init__( expr )
+        self.saveAsList = True
+
+    def postParse( self, instring, loc, tokenlist ):
+        for i,tok in enumerate(tokenlist):
+            if len(tok) == 0:
+                continue
+            ikey = tok[0]
+            if isinstance(ikey,int):
+                ikey = _ustr(tok[0]).strip()
+            if len(tok)==1:
+                tokenlist[ikey] = _ParseResultsWithOffset("",i)
+            elif len(tok)==2 and not isinstance(tok[1],ParseResults):
+                tokenlist[ikey] = _ParseResultsWithOffset(tok[1],i)
+            else:
+                dictvalue = tok.copy() #ParseResults(i)
+                del dictvalue[0]
+                if len(dictvalue)!= 1 or (isinstance(dictvalue,ParseResults) and dictvalue.haskeys()):
+                    tokenlist[ikey] = _ParseResultsWithOffset(dictvalue,i)
+                else:
+                    tokenlist[ikey] = _ParseResultsWithOffset(dictvalue[0],i)
+
+        if self.resultsName:
+            return [ tokenlist ]
+        else:
+            return tokenlist
+
+
+class Suppress(TokenConverter):
+    """
+    Converter for ignoring the results of a parsed expression.
+
+    Example::
+        source = "a, b, c,d"
+        wd = Word(alphas)
+        wd_list1 = wd + ZeroOrMore(',' + wd)
+        print(wd_list1.parseString(source))
+
+        # often, delimiters that are useful during parsing are just in the
+        # way afterward - use Suppress to keep them out of the parsed output
+        wd_list2 = wd + ZeroOrMore(Suppress(',') + wd)
+        print(wd_list2.parseString(source))
+    prints::
+        ['a', ',', 'b', ',', 'c', ',', 'd']
+        ['a', 'b', 'c', 'd']
+    (See also L{delimitedList}.)
+    """
+    def postParse( self, instring, loc, tokenlist ):
+        return []
+
+    def suppress( self ):
+        return self
+
+
+class OnlyOnce(object):
+    """
+    Wrapper for parse actions, to ensure they are only called once.
+    """
+    def __init__(self, methodCall):
+        self.callable = _trim_arity(methodCall)
+        self.called = False
+    def __call__(self,s,l,t):
+        if not self.called:
+            results = self.callable(s,l,t)
+            self.called = True
+            return results
+        raise ParseException(s,l,"")
+    def reset(self):
+        self.called = False
+
+def traceParseAction(f):
+    """
+    Decorator for debugging parse actions. 
+    
+    When the parse action is called, this decorator will print C{">> entering I{method-name}(line:I{current_source_line}, I{parse_location}, I{matched_tokens})".}
+    When the parse action completes, the decorator will print C{"<<"} followed by the returned value, or any exception that the parse action raised.
+
+    Example::
+        wd = Word(alphas)
+
+        @traceParseAction
+        def remove_duplicate_chars(tokens):
+            return ''.join(sorted(set(''.join(tokens))))
+
+        wds = OneOrMore(wd).setParseAction(remove_duplicate_chars)
+        print(wds.parseString("slkdjs sld sldd sdlf sdljf"))
+    prints::
+        >>entering remove_duplicate_chars(line: 'slkdjs sld sldd sdlf sdljf', 0, (['slkdjs', 'sld', 'sldd', 'sdlf', 'sdljf'], {}))
+        <3:
+            thisFunc = paArgs[0].__class__.__name__ + '.' + thisFunc
+        sys.stderr.write( ">>entering %s(line: '%s', %d, %r)\n" % (thisFunc,line(l,s),l,t) )
+        try:
+            ret = f(*paArgs)
+        except Exception as exc:
+            sys.stderr.write( "< ['aa', 'bb', 'cc']
+        delimitedList(Word(hexnums), delim=':', combine=True).parseString("AA:BB:CC:DD:EE") # -> ['AA:BB:CC:DD:EE']
+    """
+    dlName = _ustr(expr)+" ["+_ustr(delim)+" "+_ustr(expr)+"]..."
+    if combine:
+        return Combine( expr + ZeroOrMore( delim + expr ) ).setName(dlName)
+    else:
+        return ( expr + ZeroOrMore( Suppress( delim ) + expr ) ).setName(dlName)
+
+def countedArray( expr, intExpr=None ):
+    """
+    Helper to define a counted list of expressions.
+    This helper defines a pattern of the form::
+        integer expr expr expr...
+    where the leading integer tells how many expr expressions follow.
+    The matched tokens returns the array of expr tokens as a list - the leading count token is suppressed.
+    
+    If C{intExpr} is specified, it should be a pyparsing expression that produces an integer value.
+
+    Example::
+        countedArray(Word(alphas)).parseString('2 ab cd ef')  # -> ['ab', 'cd']
+
+        # in this parser, the leading integer value is given in binary,
+        # '10' indicating that 2 values are in the array
+        binaryConstant = Word('01').setParseAction(lambda t: int(t[0], 2))
+        countedArray(Word(alphas), intExpr=binaryConstant).parseString('10 ab cd ef')  # -> ['ab', 'cd']
+    """
+    arrayExpr = Forward()
+    def countFieldParseAction(s,l,t):
+        n = t[0]
+        arrayExpr << (n and Group(And([expr]*n)) or Group(empty))
+        return []
+    if intExpr is None:
+        intExpr = Word(nums).setParseAction(lambda t:int(t[0]))
+    else:
+        intExpr = intExpr.copy()
+    intExpr.setName("arrayLen")
+    intExpr.addParseAction(countFieldParseAction, callDuringTry=True)
+    return ( intExpr + arrayExpr ).setName('(len) ' + _ustr(expr) + '...')
+
+def _flatten(L):
+    ret = []
+    for i in L:
+        if isinstance(i,list):
+            ret.extend(_flatten(i))
+        else:
+            ret.append(i)
+    return ret
+
+def matchPreviousLiteral(expr):
+    """
+    Helper to define an expression that is indirectly defined from
+    the tokens matched in a previous expression, that is, it looks
+    for a 'repeat' of a previous expression.  For example::
+        first = Word(nums)
+        second = matchPreviousLiteral(first)
+        matchExpr = first + ":" + second
+    will match C{"1:1"}, but not C{"1:2"}.  Because this matches a
+    previous literal, will also match the leading C{"1:1"} in C{"1:10"}.
+    If this is not desired, use C{matchPreviousExpr}.
+    Do I{not} use with packrat parsing enabled.
+    """
+    rep = Forward()
+    def copyTokenToRepeater(s,l,t):
+        if t:
+            if len(t) == 1:
+                rep << t[0]
+            else:
+                # flatten t tokens
+                tflat = _flatten(t.asList())
+                rep << And(Literal(tt) for tt in tflat)
+        else:
+            rep << Empty()
+    expr.addParseAction(copyTokenToRepeater, callDuringTry=True)
+    rep.setName('(prev) ' + _ustr(expr))
+    return rep
+
+def matchPreviousExpr(expr):
+    """
+    Helper to define an expression that is indirectly defined from
+    the tokens matched in a previous expression, that is, it looks
+    for a 'repeat' of a previous expression.  For example::
+        first = Word(nums)
+        second = matchPreviousExpr(first)
+        matchExpr = first + ":" + second
+    will match C{"1:1"}, but not C{"1:2"}.  Because this matches by
+    expressions, will I{not} match the leading C{"1:1"} in C{"1:10"};
+    the expressions are evaluated first, and then compared, so
+    C{"1"} is compared with C{"10"}.
+    Do I{not} use with packrat parsing enabled.
+    """
+    rep = Forward()
+    e2 = expr.copy()
+    rep <<= e2
+    def copyTokenToRepeater(s,l,t):
+        matchTokens = _flatten(t.asList())
+        def mustMatchTheseTokens(s,l,t):
+            theseTokens = _flatten(t.asList())
+            if  theseTokens != matchTokens:
+                raise ParseException("",0,"")
+        rep.setParseAction( mustMatchTheseTokens, callDuringTry=True )
+    expr.addParseAction(copyTokenToRepeater, callDuringTry=True)
+    rep.setName('(prev) ' + _ustr(expr))
+    return rep
+
+def _escapeRegexRangeChars(s):
+    #~  escape these chars: ^-]
+    for c in r"\^-]":
+        s = s.replace(c,_bslash+c)
+    s = s.replace("\n",r"\n")
+    s = s.replace("\t",r"\t")
+    return _ustr(s)
+
+def oneOf( strs, caseless=False, useRegex=True ):
+    """
+    Helper to quickly define a set of alternative Literals, and makes sure to do
+    longest-first testing when there is a conflict, regardless of the input order,
+    but returns a C{L{MatchFirst}} for best performance.
+
+    Parameters:
+     - strs - a string of space-delimited literals, or a collection of string literals
+     - caseless - (default=C{False}) - treat all literals as caseless
+     - useRegex - (default=C{True}) - as an optimization, will generate a Regex
+          object; otherwise, will generate a C{MatchFirst} object (if C{caseless=True}, or
+          if creating a C{Regex} raises an exception)
+
+    Example::
+        comp_oper = oneOf("< = > <= >= !=")
+        var = Word(alphas)
+        number = Word(nums)
+        term = var | number
+        comparison_expr = term + comp_oper + term
+        print(comparison_expr.searchString("B = 12  AA=23 B<=AA AA>12"))
+    prints::
+        [['B', '=', '12'], ['AA', '=', '23'], ['B', '<=', 'AA'], ['AA', '>', '12']]
+    """
+    if caseless:
+        isequal = ( lambda a,b: a.upper() == b.upper() )
+        masks = ( lambda a,b: b.upper().startswith(a.upper()) )
+        parseElementClass = CaselessLiteral
+    else:
+        isequal = ( lambda a,b: a == b )
+        masks = ( lambda a,b: b.startswith(a) )
+        parseElementClass = Literal
+
+    symbols = []
+    if isinstance(strs,basestring):
+        symbols = strs.split()
+    elif isinstance(strs, Iterable):
+        symbols = list(strs)
+    else:
+        warnings.warn("Invalid argument to oneOf, expected string or iterable",
+                SyntaxWarning, stacklevel=2)
+    if not symbols:
+        return NoMatch()
+
+    i = 0
+    while i < len(symbols)-1:
+        cur = symbols[i]
+        for j,other in enumerate(symbols[i+1:]):
+            if ( isequal(other, cur) ):
+                del symbols[i+j+1]
+                break
+            elif ( masks(cur, other) ):
+                del symbols[i+j+1]
+                symbols.insert(i,other)
+                cur = other
+                break
+        else:
+            i += 1
+
+    if not caseless and useRegex:
+        #~ print (strs,"->", "|".join( [ _escapeRegexChars(sym) for sym in symbols] ))
+        try:
+            if len(symbols)==len("".join(symbols)):
+                return Regex( "[%s]" % "".join(_escapeRegexRangeChars(sym) for sym in symbols) ).setName(' | '.join(symbols))
+            else:
+                return Regex( "|".join(re.escape(sym) for sym in symbols) ).setName(' | '.join(symbols))
+        except Exception:
+            warnings.warn("Exception creating Regex for oneOf, building MatchFirst",
+                    SyntaxWarning, stacklevel=2)
+
+
+    # last resort, just use MatchFirst
+    return MatchFirst(parseElementClass(sym) for sym in symbols).setName(' | '.join(symbols))
+
+def dictOf( key, value ):
+    """
+    Helper to easily and clearly define a dictionary by specifying the respective patterns
+    for the key and value.  Takes care of defining the C{L{Dict}}, C{L{ZeroOrMore}}, and C{L{Group}} tokens
+    in the proper order.  The key pattern can include delimiting markers or punctuation,
+    as long as they are suppressed, thereby leaving the significant key text.  The value
+    pattern can include named results, so that the C{Dict} results can include named token
+    fields.
+
+    Example::
+        text = "shape: SQUARE posn: upper left color: light blue texture: burlap"
+        attr_expr = (label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
+        print(OneOrMore(attr_expr).parseString(text).dump())
+        
+        attr_label = label
+        attr_value = Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join)
+
+        # similar to Dict, but simpler call format
+        result = dictOf(attr_label, attr_value).parseString(text)
+        print(result.dump())
+        print(result['shape'])
+        print(result.shape)  # object attribute access works too
+        print(result.asDict())
+    prints::
+        [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'light blue'], ['texture', 'burlap']]
+        - color: light blue
+        - posn: upper left
+        - shape: SQUARE
+        - texture: burlap
+        SQUARE
+        SQUARE
+        {'color': 'light blue', 'shape': 'SQUARE', 'posn': 'upper left', 'texture': 'burlap'}
+    """
+    return Dict( ZeroOrMore( Group ( key + value ) ) )
+
+def originalTextFor(expr, asString=True):
+    """
+    Helper to return the original, untokenized text for a given expression.  Useful to
+    restore the parsed fields of an HTML start tag into the raw tag text itself, or to
+    revert separate tokens with intervening whitespace back to the original matching
+    input text. By default, returns astring containing the original parsed text.  
+       
+    If the optional C{asString} argument is passed as C{False}, then the return value is a 
+    C{L{ParseResults}} containing any results names that were originally matched, and a 
+    single token containing the original matched text from the input string.  So if 
+    the expression passed to C{L{originalTextFor}} contains expressions with defined
+    results names, you must set C{asString} to C{False} if you want to preserve those
+    results name values.
+
+    Example::
+        src = "this is test  bold text  normal text "
+        for tag in ("b","i"):
+            opener,closer = makeHTMLTags(tag)
+            patt = originalTextFor(opener + SkipTo(closer) + closer)
+            print(patt.searchString(src)[0])
+    prints::
+        [' bold text ']
+        ['text']
+    """
+    locMarker = Empty().setParseAction(lambda s,loc,t: loc)
+    endlocMarker = locMarker.copy()
+    endlocMarker.callPreparse = False
+    matchExpr = locMarker("_original_start") + expr + endlocMarker("_original_end")
+    if asString:
+        extractText = lambda s,l,t: s[t._original_start:t._original_end]
+    else:
+        def extractText(s,l,t):
+            t[:] = [s[t.pop('_original_start'):t.pop('_original_end')]]
+    matchExpr.setParseAction(extractText)
+    matchExpr.ignoreExprs = expr.ignoreExprs
+    return matchExpr
+
+def ungroup(expr): 
+    """
+    Helper to undo pyparsing's default grouping of And expressions, even
+    if all but one are non-empty.
+    """
+    return TokenConverter(expr).setParseAction(lambda t:t[0])
+
+def locatedExpr(expr):
+    """
+    Helper to decorate a returned token with its starting and ending locations in the input string.
+    This helper adds the following results names:
+     - locn_start = location where matched expression begins
+     - locn_end = location where matched expression ends
+     - value = the actual parsed results
+
+    Be careful if the input text contains C{} characters, you may want to call
+    C{L{ParserElement.parseWithTabs}}
+
+    Example::
+        wd = Word(alphas)
+        for match in locatedExpr(wd).searchString("ljsdf123lksdjjf123lkkjj1222"):
+            print(match)
+    prints::
+        [[0, 'ljsdf', 5]]
+        [[8, 'lksdjjf', 15]]
+        [[18, 'lkkjj', 23]]
+    """
+    locator = Empty().setParseAction(lambda s,l,t: l)
+    return Group(locator("locn_start") + expr("value") + locator.copy().leaveWhitespace()("locn_end"))
+
+
+# convenience constants for positional expressions
+empty       = Empty().setName("empty")
+lineStart   = LineStart().setName("lineStart")
+lineEnd     = LineEnd().setName("lineEnd")
+stringStart = StringStart().setName("stringStart")
+stringEnd   = StringEnd().setName("stringEnd")
+
+_escapedPunc = Word( _bslash, r"\[]-*.$+^?()~ ", exact=2 ).setParseAction(lambda s,l,t:t[0][1])
+_escapedHexChar = Regex(r"\\0?[xX][0-9a-fA-F]+").setParseAction(lambda s,l,t:unichr(int(t[0].lstrip(r'\0x'),16)))
+_escapedOctChar = Regex(r"\\0[0-7]+").setParseAction(lambda s,l,t:unichr(int(t[0][1:],8)))
+_singleChar = _escapedPunc | _escapedHexChar | _escapedOctChar | CharsNotIn(r'\]', exact=1)
+_charRange = Group(_singleChar + Suppress("-") + _singleChar)
+_reBracketExpr = Literal("[") + Optional("^").setResultsName("negate") + Group( OneOrMore( _charRange | _singleChar ) ).setResultsName("body") + "]"
+
+def srange(s):
+    r"""
+    Helper to easily define string ranges for use in Word construction.  Borrows
+    syntax from regexp '[]' string range definitions::
+        srange("[0-9]")   -> "0123456789"
+        srange("[a-z]")   -> "abcdefghijklmnopqrstuvwxyz"
+        srange("[a-z$_]") -> "abcdefghijklmnopqrstuvwxyz$_"
+    The input string must be enclosed in []'s, and the returned string is the expanded
+    character set joined into a single string.
+    The values enclosed in the []'s may be:
+     - a single character
+     - an escaped character with a leading backslash (such as C{\-} or C{\]})
+     - an escaped hex character with a leading C{'\x'} (C{\x21}, which is a C{'!'} character) 
+         (C{\0x##} is also supported for backwards compatibility) 
+     - an escaped octal character with a leading C{'\0'} (C{\041}, which is a C{'!'} character)
+     - a range of any of the above, separated by a dash (C{'a-z'}, etc.)
+     - any combination of the above (C{'aeiouy'}, C{'a-zA-Z0-9_$'}, etc.)
+    """
+    _expanded = lambda p: p if not isinstance(p,ParseResults) else ''.join(unichr(c) for c in range(ord(p[0]),ord(p[1])+1))
+    try:
+        return "".join(_expanded(part) for part in _reBracketExpr.parseString(s).body)
+    except Exception:
+        return ""
+
+def matchOnlyAtCol(n):
+    """
+    Helper method for defining parse actions that require matching at a specific
+    column in the input text.
+    """
+    def verifyCol(strg,locn,toks):
+        if col(locn,strg) != n:
+            raise ParseException(strg,locn,"matched token not at column %d" % n)
+    return verifyCol
+
+def replaceWith(replStr):
+    """
+    Helper method for common parse actions that simply return a literal value.  Especially
+    useful when used with C{L{transformString}()}.
+
+    Example::
+        num = Word(nums).setParseAction(lambda toks: int(toks[0]))
+        na = oneOf("N/A NA").setParseAction(replaceWith(math.nan))
+        term = na | num
+        
+        OneOrMore(term).parseString("324 234 N/A 234") # -> [324, 234, nan, 234]
+    """
+    return lambda s,l,t: [replStr]
+
+def removeQuotes(s,l,t):
+    """
+    Helper parse action for removing quotation marks from parsed quoted strings.
+
+    Example::
+        # by default, quotation marks are included in parsed results
+        quotedString.parseString("'Now is the Winter of our Discontent'") # -> ["'Now is the Winter of our Discontent'"]
+
+        # use removeQuotes to strip quotation marks from parsed results
+        quotedString.setParseAction(removeQuotes)
+        quotedString.parseString("'Now is the Winter of our Discontent'") # -> ["Now is the Winter of our Discontent"]
+    """
+    return t[0][1:-1]
+
+def tokenMap(func, *args):
+    """
+    Helper to define a parse action by mapping a function to all elements of a ParseResults list.If any additional 
+    args are passed, they are forwarded to the given function as additional arguments after
+    the token, as in C{hex_integer = Word(hexnums).setParseAction(tokenMap(int, 16))}, which will convert the
+    parsed data to an integer using base 16.
+
+    Example (compare the last to example in L{ParserElement.transformString}::
+        hex_ints = OneOrMore(Word(hexnums)).setParseAction(tokenMap(int, 16))
+        hex_ints.runTests('''
+            00 11 22 aa FF 0a 0d 1a
+            ''')
+        
+        upperword = Word(alphas).setParseAction(tokenMap(str.upper))
+        OneOrMore(upperword).runTests('''
+            my kingdom for a horse
+            ''')
+
+        wd = Word(alphas).setParseAction(tokenMap(str.title))
+        OneOrMore(wd).setParseAction(' '.join).runTests('''
+            now is the winter of our discontent made glorious summer by this sun of york
+            ''')
+    prints::
+        00 11 22 aa FF 0a 0d 1a
+        [0, 17, 34, 170, 255, 10, 13, 26]
+
+        my kingdom for a horse
+        ['MY', 'KINGDOM', 'FOR', 'A', 'HORSE']
+
+        now is the winter of our discontent made glorious summer by this sun of york
+        ['Now Is The Winter Of Our Discontent Made Glorious Summer By This Sun Of York']
+    """
+    def pa(s,l,t):
+        return [func(tokn, *args) for tokn in t]
+
+    try:
+        func_name = getattr(func, '__name__', 
+                            getattr(func, '__class__').__name__)
+    except Exception:
+        func_name = str(func)
+    pa.__name__ = func_name
+
+    return pa
+
+upcaseTokens = tokenMap(lambda t: _ustr(t).upper())
+"""(Deprecated) Helper parse action to convert tokens to upper case. Deprecated in favor of L{pyparsing_common.upcaseTokens}"""
+
+downcaseTokens = tokenMap(lambda t: _ustr(t).lower())
+"""(Deprecated) Helper parse action to convert tokens to lower case. Deprecated in favor of L{pyparsing_common.downcaseTokens}"""
+    
+def _makeTags(tagStr, xml):
+    """Internal helper to construct opening and closing tag expressions, given a tag name"""
+    if isinstance(tagStr,basestring):
+        resname = tagStr
+        tagStr = Keyword(tagStr, caseless=not xml)
+    else:
+        resname = tagStr.name
+
+    tagAttrName = Word(alphas,alphanums+"_-:")
+    if (xml):
+        tagAttrValue = dblQuotedString.copy().setParseAction( removeQuotes )
+        openTag = Suppress("<") + tagStr("tag") + \
+                Dict(ZeroOrMore(Group( tagAttrName + Suppress("=") + tagAttrValue ))) + \
+                Optional("/",default=[False]).setResultsName("empty").setParseAction(lambda s,l,t:t[0]=='/') + Suppress(">")
+    else:
+        printablesLessRAbrack = "".join(c for c in printables if c not in ">")
+        tagAttrValue = quotedString.copy().setParseAction( removeQuotes ) | Word(printablesLessRAbrack)
+        openTag = Suppress("<") + tagStr("tag") + \
+                Dict(ZeroOrMore(Group( tagAttrName.setParseAction(downcaseTokens) + \
+                Optional( Suppress("=") + tagAttrValue ) ))) + \
+                Optional("/",default=[False]).setResultsName("empty").setParseAction(lambda s,l,t:t[0]=='/') + Suppress(">")
+    closeTag = Combine(_L("")
+
+    openTag = openTag.setResultsName("start"+"".join(resname.replace(":"," ").title().split())).setName("<%s>" % resname)
+    closeTag = closeTag.setResultsName("end"+"".join(resname.replace(":"," ").title().split())).setName("" % resname)
+    openTag.tag = resname
+    closeTag.tag = resname
+    return openTag, closeTag
+
+def makeHTMLTags(tagStr):
+    """
+    Helper to construct opening and closing tag expressions for HTML, given a tag name. Matches
+    tags in either upper or lower case, attributes with namespaces and with quoted or unquoted values.
+
+    Example::
+        text = 'More info at the pyparsing wiki page'
+        # makeHTMLTags returns pyparsing expressions for the opening and closing tags as a 2-tuple
+        a,a_end = makeHTMLTags("A")
+        link_expr = a + SkipTo(a_end)("link_text") + a_end
+        
+        for link in link_expr.searchString(text):
+            # attributes in the  tag (like "href" shown here) are also accessible as named results
+            print(link.link_text, '->', link.href)
+    prints::
+        pyparsing -> http://pyparsing.wikispaces.com
+    """
+    return _makeTags( tagStr, False )
+
+def makeXMLTags(tagStr):
+    """
+    Helper to construct opening and closing tag expressions for XML, given a tag name. Matches
+    tags only in the given upper/lower case.
+
+    Example: similar to L{makeHTMLTags}
+    """
+    return _makeTags( tagStr, True )
+
+def withAttribute(*args,**attrDict):
+    """
+    Helper to create a validating parse action to be used with start tags created
+    with C{L{makeXMLTags}} or C{L{makeHTMLTags}}. Use C{withAttribute} to qualify a starting tag
+    with a required attribute value, to avoid false matches on common tags such as
+    C{} or C{
}. + + Call C{withAttribute} with a series of attribute names and values. Specify the list + of filter attributes names and values as: + - keyword arguments, as in C{(align="right")}, or + - as an explicit dict with C{**} operator, when an attribute name is also a Python + reserved word, as in C{**{"class":"Customer", "align":"right"}} + - a list of name-value tuples, as in ( ("ns1:class", "Customer"), ("ns2:align","right") ) + For attribute names with a namespace prefix, you must use the second form. Attribute + names are matched insensitive to upper/lower case. + + If just testing for C{class} (with or without a namespace), use C{L{withClass}}. + + To verify that the attribute exists, but without specifying a value, pass + C{withAttribute.ANY_VALUE} as the value. + + Example:: + html = ''' +
+ Some text +
1 4 0 1 0
+
1,3 2,3 1,1
+
this has no type
+
+ + ''' + div,div_end = makeHTMLTags("div") + + # only match div tag having a type attribute with value "grid" + div_grid = div().setParseAction(withAttribute(type="grid")) + grid_expr = div_grid + SkipTo(div | div_end)("body") + for grid_header in grid_expr.searchString(html): + print(grid_header.body) + + # construct a match with any div tag having a type attribute, regardless of the value + div_any_type = div().setParseAction(withAttribute(type=withAttribute.ANY_VALUE)) + div_expr = div_any_type + SkipTo(div | div_end)("body") + for div_header in div_expr.searchString(html): + print(div_header.body) + prints:: + 1 4 0 1 0 + + 1 4 0 1 0 + 1,3 2,3 1,1 + """ + if args: + attrs = args[:] + else: + attrs = attrDict.items() + attrs = [(k,v) for k,v in attrs] + def pa(s,l,tokens): + for attrName,attrValue in attrs: + if attrName not in tokens: + raise ParseException(s,l,"no matching attribute " + attrName) + if attrValue != withAttribute.ANY_VALUE and tokens[attrName] != attrValue: + raise ParseException(s,l,"attribute '%s' has value '%s', must be '%s'" % + (attrName, tokens[attrName], attrValue)) + return pa +withAttribute.ANY_VALUE = object() + +def withClass(classname, namespace=''): + """ + Simplified version of C{L{withAttribute}} when matching on a div class - made + difficult because C{class} is a reserved word in Python. + + Example:: + html = ''' +
+ Some text +
1 4 0 1 0
+
1,3 2,3 1,1
+
this <div> has no class
+
+ + ''' + div,div_end = makeHTMLTags("div") + div_grid = div().setParseAction(withClass("grid")) + + grid_expr = div_grid + SkipTo(div | div_end)("body") + for grid_header in grid_expr.searchString(html): + print(grid_header.body) + + div_any_type = div().setParseAction(withClass(withAttribute.ANY_VALUE)) + div_expr = div_any_type + SkipTo(div | div_end)("body") + for div_header in div_expr.searchString(html): + print(div_header.body) + prints:: + 1 4 0 1 0 + + 1 4 0 1 0 + 1,3 2,3 1,1 + """ + classattr = "%s:class" % namespace if namespace else "class" + return withAttribute(**{classattr : classname}) + +opAssoc = _Constants() +opAssoc.LEFT = object() +opAssoc.RIGHT = object() + +def infixNotation( baseExpr, opList, lpar=Suppress('('), rpar=Suppress(')') ): + """ + Helper method for constructing grammars of expressions made up of + operators working in a precedence hierarchy. Operators may be unary or + binary, left- or right-associative. Parse actions can also be attached + to operator expressions. The generated parser will also recognize the use + of parentheses to override operator precedences (see example below). + + Note: if you define a deep operator list, you may see performance issues + when using infixNotation. See L{ParserElement.enablePackrat} for a + mechanism to potentially improve your parser performance. + + Parameters: + - baseExpr - expression representing the most basic element for the nested + - opList - list of tuples, one for each operator precedence level in the + expression grammar; each tuple is of the form + (opExpr, numTerms, rightLeftAssoc, parseAction), where: + - opExpr is the pyparsing expression for the operator; + may also be a string, which will be converted to a Literal; + if numTerms is 3, opExpr is a tuple of two expressions, for the + two operators separating the 3 terms + - numTerms is the number of terms for this operator (must + be 1, 2, or 3) + - rightLeftAssoc is the indicator whether the operator is + right or left associative, using the pyparsing-defined + constants C{opAssoc.RIGHT} and C{opAssoc.LEFT}. + - parseAction is the parse action to be associated with + expressions matching this operator expression (the + parse action tuple member may be omitted); if the parse action + is passed a tuple or list of functions, this is equivalent to + calling C{setParseAction(*fn)} (L{ParserElement.setParseAction}) + - lpar - expression for matching left-parentheses (default=C{Suppress('(')}) + - rpar - expression for matching right-parentheses (default=C{Suppress(')')}) + + Example:: + # simple example of four-function arithmetic with ints and variable names + integer = pyparsing_common.signed_integer + varname = pyparsing_common.identifier + + arith_expr = infixNotation(integer | varname, + [ + ('-', 1, opAssoc.RIGHT), + (oneOf('* /'), 2, opAssoc.LEFT), + (oneOf('+ -'), 2, opAssoc.LEFT), + ]) + + arith_expr.runTests(''' + 5+3*6 + (5+3)*6 + -2--11 + ''', fullDump=False) + prints:: + 5+3*6 + [[5, '+', [3, '*', 6]]] + + (5+3)*6 + [[[5, '+', 3], '*', 6]] + + -2--11 + [[['-', 2], '-', ['-', 11]]] + """ + ret = Forward() + lastExpr = baseExpr | ( lpar + ret + rpar ) + for i,operDef in enumerate(opList): + opExpr,arity,rightLeftAssoc,pa = (operDef + (None,))[:4] + termName = "%s term" % opExpr if arity < 3 else "%s%s term" % opExpr + if arity == 3: + if opExpr is None or len(opExpr) != 2: + raise ValueError("if numterms=3, opExpr must be a tuple or list of two expressions") + opExpr1, opExpr2 = opExpr + thisExpr = Forward().setName(termName) + if rightLeftAssoc == opAssoc.LEFT: + if arity == 1: + matchExpr = FollowedBy(lastExpr + opExpr) + Group( lastExpr + OneOrMore( opExpr ) ) + elif arity == 2: + if opExpr is not None: + matchExpr = FollowedBy(lastExpr + opExpr + lastExpr) + Group( lastExpr + OneOrMore( opExpr + lastExpr ) ) + else: + matchExpr = FollowedBy(lastExpr+lastExpr) + Group( lastExpr + OneOrMore(lastExpr) ) + elif arity == 3: + matchExpr = FollowedBy(lastExpr + opExpr1 + lastExpr + opExpr2 + lastExpr) + \ + Group( lastExpr + opExpr1 + lastExpr + opExpr2 + lastExpr ) + else: + raise ValueError("operator must be unary (1), binary (2), or ternary (3)") + elif rightLeftAssoc == opAssoc.RIGHT: + if arity == 1: + # try to avoid LR with this extra test + if not isinstance(opExpr, Optional): + opExpr = Optional(opExpr) + matchExpr = FollowedBy(opExpr.expr + thisExpr) + Group( opExpr + thisExpr ) + elif arity == 2: + if opExpr is not None: + matchExpr = FollowedBy(lastExpr + opExpr + thisExpr) + Group( lastExpr + OneOrMore( opExpr + thisExpr ) ) + else: + matchExpr = FollowedBy(lastExpr + thisExpr) + Group( lastExpr + OneOrMore( thisExpr ) ) + elif arity == 3: + matchExpr = FollowedBy(lastExpr + opExpr1 + thisExpr + opExpr2 + thisExpr) + \ + Group( lastExpr + opExpr1 + thisExpr + opExpr2 + thisExpr ) + else: + raise ValueError("operator must be unary (1), binary (2), or ternary (3)") + else: + raise ValueError("operator must indicate right or left associativity") + if pa: + if isinstance(pa, (tuple, list)): + matchExpr.setParseAction(*pa) + else: + matchExpr.setParseAction(pa) + thisExpr <<= ( matchExpr.setName(termName) | lastExpr ) + lastExpr = thisExpr + ret <<= lastExpr + return ret + +operatorPrecedence = infixNotation +"""(Deprecated) Former name of C{L{infixNotation}}, will be dropped in a future release.""" + +dblQuotedString = Combine(Regex(r'"(?:[^"\n\r\\]|(?:"")|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*')+'"').setName("string enclosed in double quotes") +sglQuotedString = Combine(Regex(r"'(?:[^'\n\r\\]|(?:'')|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*")+"'").setName("string enclosed in single quotes") +quotedString = Combine(Regex(r'"(?:[^"\n\r\\]|(?:"")|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*')+'"'| + Regex(r"'(?:[^'\n\r\\]|(?:'')|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*")+"'").setName("quotedString using single or double quotes") +unicodeString = Combine(_L('u') + quotedString.copy()).setName("unicode string literal") + +def nestedExpr(opener="(", closer=")", content=None, ignoreExpr=quotedString.copy()): + """ + Helper method for defining nested lists enclosed in opening and closing + delimiters ("(" and ")" are the default). + + Parameters: + - opener - opening character for a nested list (default=C{"("}); can also be a pyparsing expression + - closer - closing character for a nested list (default=C{")"}); can also be a pyparsing expression + - content - expression for items within the nested lists (default=C{None}) + - ignoreExpr - expression for ignoring opening and closing delimiters (default=C{quotedString}) + + If an expression is not provided for the content argument, the nested + expression will capture all whitespace-delimited content between delimiters + as a list of separate values. + + Use the C{ignoreExpr} argument to define expressions that may contain + opening or closing characters that should not be treated as opening + or closing characters for nesting, such as quotedString or a comment + expression. Specify multiple expressions using an C{L{Or}} or C{L{MatchFirst}}. + The default is L{quotedString}, but if no expressions are to be ignored, + then pass C{None} for this argument. + + Example:: + data_type = oneOf("void int short long char float double") + decl_data_type = Combine(data_type + Optional(Word('*'))) + ident = Word(alphas+'_', alphanums+'_') + number = pyparsing_common.number + arg = Group(decl_data_type + ident) + LPAR,RPAR = map(Suppress, "()") + + code_body = nestedExpr('{', '}', ignoreExpr=(quotedString | cStyleComment)) + + c_function = (decl_data_type("type") + + ident("name") + + LPAR + Optional(delimitedList(arg), [])("args") + RPAR + + code_body("body")) + c_function.ignore(cStyleComment) + + source_code = ''' + int is_odd(int x) { + return (x%2); + } + + int dec_to_hex(char hchar) { + if (hchar >= '0' && hchar <= '9') { + return (ord(hchar)-ord('0')); + } else { + return (10+ord(hchar)-ord('A')); + } + } + ''' + for func in c_function.searchString(source_code): + print("%(name)s (%(type)s) args: %(args)s" % func) + + prints:: + is_odd (int) args: [['int', 'x']] + dec_to_hex (int) args: [['char', 'hchar']] + """ + if opener == closer: + raise ValueError("opening and closing strings cannot be the same") + if content is None: + if isinstance(opener,basestring) and isinstance(closer,basestring): + if len(opener) == 1 and len(closer)==1: + if ignoreExpr is not None: + content = (Combine(OneOrMore(~ignoreExpr + + CharsNotIn(opener+closer+ParserElement.DEFAULT_WHITE_CHARS,exact=1)) + ).setParseAction(lambda t:t[0].strip())) + else: + content = (empty.copy()+CharsNotIn(opener+closer+ParserElement.DEFAULT_WHITE_CHARS + ).setParseAction(lambda t:t[0].strip())) + else: + if ignoreExpr is not None: + content = (Combine(OneOrMore(~ignoreExpr + + ~Literal(opener) + ~Literal(closer) + + CharsNotIn(ParserElement.DEFAULT_WHITE_CHARS,exact=1)) + ).setParseAction(lambda t:t[0].strip())) + else: + content = (Combine(OneOrMore(~Literal(opener) + ~Literal(closer) + + CharsNotIn(ParserElement.DEFAULT_WHITE_CHARS,exact=1)) + ).setParseAction(lambda t:t[0].strip())) + else: + raise ValueError("opening and closing arguments must be strings if no content expression is given") + ret = Forward() + if ignoreExpr is not None: + ret <<= Group( Suppress(opener) + ZeroOrMore( ignoreExpr | ret | content ) + Suppress(closer) ) + else: + ret <<= Group( Suppress(opener) + ZeroOrMore( ret | content ) + Suppress(closer) ) + ret.setName('nested %s%s expression' % (opener,closer)) + return ret + +def indentedBlock(blockStatementExpr, indentStack, indent=True): + """ + Helper method for defining space-delimited indentation blocks, such as + those used to define block statements in Python source code. + + Parameters: + - blockStatementExpr - expression defining syntax of statement that + is repeated within the indented block + - indentStack - list created by caller to manage indentation stack + (multiple statementWithIndentedBlock expressions within a single grammar + should share a common indentStack) + - indent - boolean indicating whether block must be indented beyond the + the current level; set to False for block of left-most statements + (default=C{True}) + + A valid block must contain at least one C{blockStatement}. + + Example:: + data = ''' + def A(z): + A1 + B = 100 + G = A2 + A2 + A3 + B + def BB(a,b,c): + BB1 + def BBA(): + bba1 + bba2 + bba3 + C + D + def spam(x,y): + def eggs(z): + pass + ''' + + + indentStack = [1] + stmt = Forward() + + identifier = Word(alphas, alphanums) + funcDecl = ("def" + identifier + Group( "(" + Optional( delimitedList(identifier) ) + ")" ) + ":") + func_body = indentedBlock(stmt, indentStack) + funcDef = Group( funcDecl + func_body ) + + rvalue = Forward() + funcCall = Group(identifier + "(" + Optional(delimitedList(rvalue)) + ")") + rvalue << (funcCall | identifier | Word(nums)) + assignment = Group(identifier + "=" + rvalue) + stmt << ( funcDef | assignment | identifier ) + + module_body = OneOrMore(stmt) + + parseTree = module_body.parseString(data) + parseTree.pprint() + prints:: + [['def', + 'A', + ['(', 'z', ')'], + ':', + [['A1'], [['B', '=', '100']], [['G', '=', 'A2']], ['A2'], ['A3']]], + 'B', + ['def', + 'BB', + ['(', 'a', 'b', 'c', ')'], + ':', + [['BB1'], [['def', 'BBA', ['(', ')'], ':', [['bba1'], ['bba2'], ['bba3']]]]]], + 'C', + 'D', + ['def', + 'spam', + ['(', 'x', 'y', ')'], + ':', + [[['def', 'eggs', ['(', 'z', ')'], ':', [['pass']]]]]]] + """ + def checkPeerIndent(s,l,t): + if l >= len(s): return + curCol = col(l,s) + if curCol != indentStack[-1]: + if curCol > indentStack[-1]: + raise ParseFatalException(s,l,"illegal nesting") + raise ParseException(s,l,"not a peer entry") + + def checkSubIndent(s,l,t): + curCol = col(l,s) + if curCol > indentStack[-1]: + indentStack.append( curCol ) + else: + raise ParseException(s,l,"not a subentry") + + def checkUnindent(s,l,t): + if l >= len(s): return + curCol = col(l,s) + if not(indentStack and curCol < indentStack[-1] and curCol <= indentStack[-2]): + raise ParseException(s,l,"not an unindent") + indentStack.pop() + + NL = OneOrMore(LineEnd().setWhitespaceChars("\t ").suppress()) + INDENT = (Empty() + Empty().setParseAction(checkSubIndent)).setName('INDENT') + PEER = Empty().setParseAction(checkPeerIndent).setName('') + UNDENT = Empty().setParseAction(checkUnindent).setName('UNINDENT') + if indent: + smExpr = Group( Optional(NL) + + #~ FollowedBy(blockStatementExpr) + + INDENT + (OneOrMore( PEER + Group(blockStatementExpr) + Optional(NL) )) + UNDENT) + else: + smExpr = Group( Optional(NL) + + (OneOrMore( PEER + Group(blockStatementExpr) + Optional(NL) )) ) + blockStatementExpr.ignore(_bslash + LineEnd()) + return smExpr.setName('indented block') + +alphas8bit = srange(r"[\0xc0-\0xd6\0xd8-\0xf6\0xf8-\0xff]") +punc8bit = srange(r"[\0xa1-\0xbf\0xd7\0xf7]") + +anyOpenTag,anyCloseTag = makeHTMLTags(Word(alphas,alphanums+"_:").setName('any tag')) +_htmlEntityMap = dict(zip("gt lt amp nbsp quot apos".split(),'><& "\'')) +commonHTMLEntity = Regex('&(?P' + '|'.join(_htmlEntityMap.keys()) +");").setName("common HTML entity") +def replaceHTMLEntity(t): + """Helper parser action to replace common HTML entities with their special characters""" + return _htmlEntityMap.get(t.entity) + +# it's easy to get these comment structures wrong - they're very common, so may as well make them available +cStyleComment = Combine(Regex(r"/\*(?:[^*]|\*(?!/))*") + '*/').setName("C style comment") +"Comment of the form C{/* ... */}" + +htmlComment = Regex(r"").setName("HTML comment") +"Comment of the form C{}" + +restOfLine = Regex(r".*").leaveWhitespace().setName("rest of line") +dblSlashComment = Regex(r"//(?:\\\n|[^\n])*").setName("// comment") +"Comment of the form C{// ... (to end of line)}" + +cppStyleComment = Combine(Regex(r"/\*(?:[^*]|\*(?!/))*") + '*/'| dblSlashComment).setName("C++ style comment") +"Comment of either form C{L{cStyleComment}} or C{L{dblSlashComment}}" + +javaStyleComment = cppStyleComment +"Same as C{L{cppStyleComment}}" + +pythonStyleComment = Regex(r"#.*").setName("Python style comment") +"Comment of the form C{# ... (to end of line)}" + +_commasepitem = Combine(OneOrMore(Word(printables, excludeChars=',') + + Optional( Word(" \t") + + ~Literal(",") + ~LineEnd() ) ) ).streamline().setName("commaItem") +commaSeparatedList = delimitedList( Optional( quotedString.copy() | _commasepitem, default="") ).setName("commaSeparatedList") +"""(Deprecated) Predefined expression of 1 or more printable words or quoted strings, separated by commas. + This expression is deprecated in favor of L{pyparsing_common.comma_separated_list}.""" + +# some other useful expressions - using lower-case class name since we are really using this as a namespace +class pyparsing_common: + """ + Here are some common low-level expressions that may be useful in jump-starting parser development: + - numeric forms (L{integers}, L{reals}, L{scientific notation}) + - common L{programming identifiers} + - network addresses (L{MAC}, L{IPv4}, L{IPv6}) + - ISO8601 L{dates} and L{datetime} + - L{UUID} + - L{comma-separated list} + Parse actions: + - C{L{convertToInteger}} + - C{L{convertToFloat}} + - C{L{convertToDate}} + - C{L{convertToDatetime}} + - C{L{stripHTMLTags}} + - C{L{upcaseTokens}} + - C{L{downcaseTokens}} + + Example:: + pyparsing_common.number.runTests(''' + # any int or real number, returned as the appropriate type + 100 + -100 + +100 + 3.14159 + 6.02e23 + 1e-12 + ''') + + pyparsing_common.fnumber.runTests(''' + # any int or real number, returned as float + 100 + -100 + +100 + 3.14159 + 6.02e23 + 1e-12 + ''') + + pyparsing_common.hex_integer.runTests(''' + # hex numbers + 100 + FF + ''') + + pyparsing_common.fraction.runTests(''' + # fractions + 1/2 + -3/4 + ''') + + pyparsing_common.mixed_integer.runTests(''' + # mixed fractions + 1 + 1/2 + -3/4 + 1-3/4 + ''') + + import uuid + pyparsing_common.uuid.setParseAction(tokenMap(uuid.UUID)) + pyparsing_common.uuid.runTests(''' + # uuid + 12345678-1234-5678-1234-567812345678 + ''') + prints:: + # any int or real number, returned as the appropriate type + 100 + [100] + + -100 + [-100] + + +100 + [100] + + 3.14159 + [3.14159] + + 6.02e23 + [6.02e+23] + + 1e-12 + [1e-12] + + # any int or real number, returned as float + 100 + [100.0] + + -100 + [-100.0] + + +100 + [100.0] + + 3.14159 + [3.14159] + + 6.02e23 + [6.02e+23] + + 1e-12 + [1e-12] + + # hex numbers + 100 + [256] + + FF + [255] + + # fractions + 1/2 + [0.5] + + -3/4 + [-0.75] + + # mixed fractions + 1 + [1] + + 1/2 + [0.5] + + -3/4 + [-0.75] + + 1-3/4 + [1.75] + + # uuid + 12345678-1234-5678-1234-567812345678 + [UUID('12345678-1234-5678-1234-567812345678')] + """ + + convertToInteger = tokenMap(int) + """ + Parse action for converting parsed integers to Python int + """ + + convertToFloat = tokenMap(float) + """ + Parse action for converting parsed numbers to Python float + """ + + integer = Word(nums).setName("integer").setParseAction(convertToInteger) + """expression that parses an unsigned integer, returns an int""" + + hex_integer = Word(hexnums).setName("hex integer").setParseAction(tokenMap(int,16)) + """expression that parses a hexadecimal integer, returns an int""" + + signed_integer = Regex(r'[+-]?\d+').setName("signed integer").setParseAction(convertToInteger) + """expression that parses an integer with optional leading sign, returns an int""" + + fraction = (signed_integer().setParseAction(convertToFloat) + '/' + signed_integer().setParseAction(convertToFloat)).setName("fraction") + """fractional expression of an integer divided by an integer, returns a float""" + fraction.addParseAction(lambda t: t[0]/t[-1]) + + mixed_integer = (fraction | signed_integer + Optional(Optional('-').suppress() + fraction)).setName("fraction or mixed integer-fraction") + """mixed integer of the form 'integer - fraction', with optional leading integer, returns float""" + mixed_integer.addParseAction(sum) + + real = Regex(r'[+-]?\d+\.\d*').setName("real number").setParseAction(convertToFloat) + """expression that parses a floating point number and returns a float""" + + sci_real = Regex(r'[+-]?\d+([eE][+-]?\d+|\.\d*([eE][+-]?\d+)?)').setName("real number with scientific notation").setParseAction(convertToFloat) + """expression that parses a floating point number with optional scientific notation and returns a float""" + + # streamlining this expression makes the docs nicer-looking + number = (sci_real | real | signed_integer).streamline() + """any numeric expression, returns the corresponding Python type""" + + fnumber = Regex(r'[+-]?\d+\.?\d*([eE][+-]?\d+)?').setName("fnumber").setParseAction(convertToFloat) + """any int or real number, returned as float""" + + identifier = Word(alphas+'_', alphanums+'_').setName("identifier") + """typical code identifier (leading alpha or '_', followed by 0 or more alphas, nums, or '_')""" + + ipv4_address = Regex(r'(25[0-5]|2[0-4][0-9]|1?[0-9]{1,2})(\.(25[0-5]|2[0-4][0-9]|1?[0-9]{1,2})){3}').setName("IPv4 address") + "IPv4 address (C{0.0.0.0 - 255.255.255.255})" + + _ipv6_part = Regex(r'[0-9a-fA-F]{1,4}').setName("hex_integer") + _full_ipv6_address = (_ipv6_part + (':' + _ipv6_part)*7).setName("full IPv6 address") + _short_ipv6_address = (Optional(_ipv6_part + (':' + _ipv6_part)*(0,6)) + "::" + Optional(_ipv6_part + (':' + _ipv6_part)*(0,6))).setName("short IPv6 address") + _short_ipv6_address.addCondition(lambda t: sum(1 for tt in t if pyparsing_common._ipv6_part.matches(tt)) < 8) + _mixed_ipv6_address = ("::ffff:" + ipv4_address).setName("mixed IPv6 address") + ipv6_address = Combine((_full_ipv6_address | _mixed_ipv6_address | _short_ipv6_address).setName("IPv6 address")).setName("IPv6 address") + "IPv6 address (long, short, or mixed form)" + + mac_address = Regex(r'[0-9a-fA-F]{2}([:.-])[0-9a-fA-F]{2}(?:\1[0-9a-fA-F]{2}){4}').setName("MAC address") + "MAC address xx:xx:xx:xx:xx (may also have '-' or '.' delimiters)" + + @staticmethod + def convertToDate(fmt="%Y-%m-%d"): + """ + Helper to create a parse action for converting parsed date string to Python datetime.date + + Params - + - fmt - format to be passed to datetime.strptime (default=C{"%Y-%m-%d"}) + + Example:: + date_expr = pyparsing_common.iso8601_date.copy() + date_expr.setParseAction(pyparsing_common.convertToDate()) + print(date_expr.parseString("1999-12-31")) + prints:: + [datetime.date(1999, 12, 31)] + """ + def cvt_fn(s,l,t): + try: + return datetime.strptime(t[0], fmt).date() + except ValueError as ve: + raise ParseException(s, l, str(ve)) + return cvt_fn + + @staticmethod + def convertToDatetime(fmt="%Y-%m-%dT%H:%M:%S.%f"): + """ + Helper to create a parse action for converting parsed datetime string to Python datetime.datetime + + Params - + - fmt - format to be passed to datetime.strptime (default=C{"%Y-%m-%dT%H:%M:%S.%f"}) + + Example:: + dt_expr = pyparsing_common.iso8601_datetime.copy() + dt_expr.setParseAction(pyparsing_common.convertToDatetime()) + print(dt_expr.parseString("1999-12-31T23:59:59.999")) + prints:: + [datetime.datetime(1999, 12, 31, 23, 59, 59, 999000)] + """ + def cvt_fn(s,l,t): + try: + return datetime.strptime(t[0], fmt) + except ValueError as ve: + raise ParseException(s, l, str(ve)) + return cvt_fn + + iso8601_date = Regex(r'(?P\d{4})(?:-(?P\d\d)(?:-(?P\d\d))?)?').setName("ISO8601 date") + "ISO8601 date (C{yyyy-mm-dd})" + + iso8601_datetime = Regex(r'(?P\d{4})-(?P\d\d)-(?P\d\d)[T ](?P\d\d):(?P\d\d)(:(?P\d\d(\.\d*)?)?)?(?PZ|[+-]\d\d:?\d\d)?').setName("ISO8601 datetime") + "ISO8601 datetime (C{yyyy-mm-ddThh:mm:ss.s(Z|+-00:00)}) - trailing seconds, milliseconds, and timezone optional; accepts separating C{'T'} or C{' '}" + + uuid = Regex(r'[0-9a-fA-F]{8}(-[0-9a-fA-F]{4}){3}-[0-9a-fA-F]{12}').setName("UUID") + "UUID (C{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx})" + + _html_stripper = anyOpenTag.suppress() | anyCloseTag.suppress() + @staticmethod + def stripHTMLTags(s, l, tokens): + """ + Parse action to remove HTML tags from web page HTML source + + Example:: + # strip HTML links from normal text + text = 'More info at the
pyparsing wiki page' + td,td_end = makeHTMLTags("TD") + table_text = td + SkipTo(td_end).setParseAction(pyparsing_common.stripHTMLTags)("body") + td_end + + print(table_text.parseString(text).body) # -> 'More info at the pyparsing wiki page' + """ + return pyparsing_common._html_stripper.transformString(tokens[0]) + + _commasepitem = Combine(OneOrMore(~Literal(",") + ~LineEnd() + Word(printables, excludeChars=',') + + Optional( White(" \t") ) ) ).streamline().setName("commaItem") + comma_separated_list = delimitedList( Optional( quotedString.copy() | _commasepitem, default="") ).setName("comma separated list") + """Predefined expression of 1 or more printable words or quoted strings, separated by commas.""" + + upcaseTokens = staticmethod(tokenMap(lambda t: _ustr(t).upper())) + """Parse action to convert tokens to upper case.""" + + downcaseTokens = staticmethod(tokenMap(lambda t: _ustr(t).lower())) + """Parse action to convert tokens to lower case.""" + + +if __name__ == "__main__": + + selectToken = CaselessLiteral("select") + fromToken = CaselessLiteral("from") + + ident = Word(alphas, alphanums + "_$") + + columnName = delimitedList(ident, ".", combine=True).setParseAction(upcaseTokens) + columnNameList = Group(delimitedList(columnName)).setName("columns") + columnSpec = ('*' | columnNameList) + + tableName = delimitedList(ident, ".", combine=True).setParseAction(upcaseTokens) + tableNameList = Group(delimitedList(tableName)).setName("tables") + + simpleSQL = selectToken("command") + columnSpec("columns") + fromToken + tableNameList("tables") + + # demo runTests method, including embedded comments in test string + simpleSQL.runTests(""" + # '*' as column list and dotted table name + select * from SYS.XYZZY + + # caseless match on "SELECT", and casts back to "select" + SELECT * from XYZZY, ABC + + # list of column names, and mixed case SELECT keyword + Select AA,BB,CC from Sys.dual + + # multiple tables + Select A, B, C from Sys.dual, Table2 + + # invalid SELECT keyword - should fail + Xelect A, B, C from Sys.dual + + # incomplete command - should fail + Select + + # invalid column name - should fail + Select ^^^ frox Sys.dual + + """) + + pyparsing_common.number.runTests(""" + 100 + -100 + +100 + 3.14159 + 6.02e23 + 1e-12 + """) + + # any int or real number, returned as float + pyparsing_common.fnumber.runTests(""" + 100 + -100 + +100 + 3.14159 + 6.02e23 + 1e-12 + """) + + pyparsing_common.hex_integer.runTests(""" + 100 + FF + """) + + import uuid + pyparsing_common.uuid.setParseAction(tokenMap(uuid.UUID)) + pyparsing_common.uuid.runTests(""" + 12345678-1234-5678-1234-567812345678 + """) diff --git a/venv/lib/python3.8/site-packages/setuptools/_vendor/six.py b/venv/lib/python3.8/site-packages/setuptools/_vendor/six.py new file mode 100644 index 000000000..190c0239c --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/_vendor/six.py @@ -0,0 +1,868 @@ +"""Utilities for writing code that runs on Python 2 and 3""" + +# Copyright (c) 2010-2015 Benjamin Peterson +# +# Permission is hereby granted, free of charge, to any person obtaining a copy +# of this software and associated documentation files (the "Software"), to deal +# in the Software without restriction, including without limitation the rights +# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +# copies of the Software, and to permit persons to whom the Software is +# furnished to do so, subject to the following conditions: +# +# The above copyright notice and this permission notice shall be included in all +# copies or substantial portions of the Software. +# +# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +# SOFTWARE. + +from __future__ import absolute_import + +import functools +import itertools +import operator +import sys +import types + +__author__ = "Benjamin Peterson " +__version__ = "1.10.0" + + +# Useful for very coarse version differentiation. +PY2 = sys.version_info[0] == 2 +PY3 = sys.version_info[0] == 3 +PY34 = sys.version_info[0:2] >= (3, 4) + +if PY3: + string_types = str, + integer_types = int, + class_types = type, + text_type = str + binary_type = bytes + + MAXSIZE = sys.maxsize +else: + string_types = basestring, + integer_types = (int, long) + class_types = (type, types.ClassType) + text_type = unicode + binary_type = str + + if sys.platform.startswith("java"): + # Jython always uses 32 bits. + MAXSIZE = int((1 << 31) - 1) + else: + # It's possible to have sizeof(long) != sizeof(Py_ssize_t). + class X(object): + + def __len__(self): + return 1 << 31 + try: + len(X()) + except OverflowError: + # 32-bit + MAXSIZE = int((1 << 31) - 1) + else: + # 64-bit + MAXSIZE = int((1 << 63) - 1) + del X + + +def _add_doc(func, doc): + """Add documentation to a function.""" + func.__doc__ = doc + + +def _import_module(name): + """Import module, returning the module after the last dot.""" + __import__(name) + return sys.modules[name] + + +class _LazyDescr(object): + + def __init__(self, name): + self.name = name + + def __get__(self, obj, tp): + result = self._resolve() + setattr(obj, self.name, result) # Invokes __set__. + try: + # This is a bit ugly, but it avoids running this again by + # removing this descriptor. + delattr(obj.__class__, self.name) + except AttributeError: + pass + return result + + +class MovedModule(_LazyDescr): + + def __init__(self, name, old, new=None): + super(MovedModule, self).__init__(name) + if PY3: + if new is None: + new = name + self.mod = new + else: + self.mod = old + + def _resolve(self): + return _import_module(self.mod) + + def __getattr__(self, attr): + _module = self._resolve() + value = getattr(_module, attr) + setattr(self, attr, value) + return value + + +class _LazyModule(types.ModuleType): + + def __init__(self, name): + super(_LazyModule, self).__init__(name) + self.__doc__ = self.__class__.__doc__ + + def __dir__(self): + attrs = ["__doc__", "__name__"] + attrs += [attr.name for attr in self._moved_attributes] + return attrs + + # Subclasses should override this + _moved_attributes = [] + + +class MovedAttribute(_LazyDescr): + + def __init__(self, name, old_mod, new_mod, old_attr=None, new_attr=None): + super(MovedAttribute, self).__init__(name) + if PY3: + if new_mod is None: + new_mod = name + self.mod = new_mod + if new_attr is None: + if old_attr is None: + new_attr = name + else: + new_attr = old_attr + self.attr = new_attr + else: + self.mod = old_mod + if old_attr is None: + old_attr = name + self.attr = old_attr + + def _resolve(self): + module = _import_module(self.mod) + return getattr(module, self.attr) + + +class _SixMetaPathImporter(object): + + """ + A meta path importer to import six.moves and its submodules. + + This class implements a PEP302 finder and loader. It should be compatible + with Python 2.5 and all existing versions of Python3 + """ + + def __init__(self, six_module_name): + self.name = six_module_name + self.known_modules = {} + + def _add_module(self, mod, *fullnames): + for fullname in fullnames: + self.known_modules[self.name + "." + fullname] = mod + + def _get_module(self, fullname): + return self.known_modules[self.name + "." + fullname] + + def find_module(self, fullname, path=None): + if fullname in self.known_modules: + return self + return None + + def __get_module(self, fullname): + try: + return self.known_modules[fullname] + except KeyError: + raise ImportError("This loader does not know module " + fullname) + + def load_module(self, fullname): + try: + # in case of a reload + return sys.modules[fullname] + except KeyError: + pass + mod = self.__get_module(fullname) + if isinstance(mod, MovedModule): + mod = mod._resolve() + else: + mod.__loader__ = self + sys.modules[fullname] = mod + return mod + + def is_package(self, fullname): + """ + Return true, if the named module is a package. + + We need this method to get correct spec objects with + Python 3.4 (see PEP451) + """ + return hasattr(self.__get_module(fullname), "__path__") + + def get_code(self, fullname): + """Return None + + Required, if is_package is implemented""" + self.__get_module(fullname) # eventually raises ImportError + return None + get_source = get_code # same as get_code + +_importer = _SixMetaPathImporter(__name__) + + +class _MovedItems(_LazyModule): + + """Lazy loading of moved objects""" + __path__ = [] # mark as package + + +_moved_attributes = [ + MovedAttribute("cStringIO", "cStringIO", "io", "StringIO"), + MovedAttribute("filter", "itertools", "builtins", "ifilter", "filter"), + MovedAttribute("filterfalse", "itertools", "itertools", "ifilterfalse", "filterfalse"), + MovedAttribute("input", "__builtin__", "builtins", "raw_input", "input"), + MovedAttribute("intern", "__builtin__", "sys"), + MovedAttribute("map", "itertools", "builtins", "imap", "map"), + MovedAttribute("getcwd", "os", "os", "getcwdu", "getcwd"), + MovedAttribute("getcwdb", "os", "os", "getcwd", "getcwdb"), + MovedAttribute("range", "__builtin__", "builtins", "xrange", "range"), + MovedAttribute("reload_module", "__builtin__", "importlib" if PY34 else "imp", "reload"), + MovedAttribute("reduce", "__builtin__", "functools"), + MovedAttribute("shlex_quote", "pipes", "shlex", "quote"), + MovedAttribute("StringIO", "StringIO", "io"), + MovedAttribute("UserDict", "UserDict", "collections"), + MovedAttribute("UserList", "UserList", "collections"), + MovedAttribute("UserString", "UserString", "collections"), + MovedAttribute("xrange", "__builtin__", "builtins", "xrange", "range"), + MovedAttribute("zip", "itertools", "builtins", "izip", "zip"), + MovedAttribute("zip_longest", "itertools", "itertools", "izip_longest", "zip_longest"), + MovedModule("builtins", "__builtin__"), + MovedModule("configparser", "ConfigParser"), + MovedModule("copyreg", "copy_reg"), + MovedModule("dbm_gnu", "gdbm", "dbm.gnu"), + MovedModule("_dummy_thread", "dummy_thread", "_dummy_thread"), + MovedModule("http_cookiejar", "cookielib", "http.cookiejar"), + MovedModule("http_cookies", "Cookie", "http.cookies"), + MovedModule("html_entities", "htmlentitydefs", "html.entities"), + MovedModule("html_parser", "HTMLParser", "html.parser"), + MovedModule("http_client", "httplib", "http.client"), + MovedModule("email_mime_multipart", "email.MIMEMultipart", "email.mime.multipart"), + MovedModule("email_mime_nonmultipart", "email.MIMENonMultipart", "email.mime.nonmultipart"), + MovedModule("email_mime_text", "email.MIMEText", "email.mime.text"), + MovedModule("email_mime_base", "email.MIMEBase", "email.mime.base"), + MovedModule("BaseHTTPServer", "BaseHTTPServer", "http.server"), + MovedModule("CGIHTTPServer", "CGIHTTPServer", "http.server"), + MovedModule("SimpleHTTPServer", "SimpleHTTPServer", "http.server"), + MovedModule("cPickle", "cPickle", "pickle"), + MovedModule("queue", "Queue"), + MovedModule("reprlib", "repr"), + MovedModule("socketserver", "SocketServer"), + MovedModule("_thread", "thread", "_thread"), + MovedModule("tkinter", "Tkinter"), + MovedModule("tkinter_dialog", "Dialog", "tkinter.dialog"), + MovedModule("tkinter_filedialog", "FileDialog", "tkinter.filedialog"), + MovedModule("tkinter_scrolledtext", "ScrolledText", "tkinter.scrolledtext"), + MovedModule("tkinter_simpledialog", "SimpleDialog", "tkinter.simpledialog"), + MovedModule("tkinter_tix", "Tix", "tkinter.tix"), + MovedModule("tkinter_ttk", "ttk", "tkinter.ttk"), + MovedModule("tkinter_constants", "Tkconstants", "tkinter.constants"), + MovedModule("tkinter_dnd", "Tkdnd", "tkinter.dnd"), + MovedModule("tkinter_colorchooser", "tkColorChooser", + "tkinter.colorchooser"), + MovedModule("tkinter_commondialog", "tkCommonDialog", + "tkinter.commondialog"), + MovedModule("tkinter_tkfiledialog", "tkFileDialog", "tkinter.filedialog"), + MovedModule("tkinter_font", "tkFont", "tkinter.font"), + MovedModule("tkinter_messagebox", "tkMessageBox", "tkinter.messagebox"), + MovedModule("tkinter_tksimpledialog", "tkSimpleDialog", + "tkinter.simpledialog"), + MovedModule("urllib_parse", __name__ + ".moves.urllib_parse", "urllib.parse"), + MovedModule("urllib_error", __name__ + ".moves.urllib_error", "urllib.error"), + MovedModule("urllib", __name__ + ".moves.urllib", __name__ + ".moves.urllib"), + MovedModule("urllib_robotparser", "robotparser", "urllib.robotparser"), + MovedModule("xmlrpc_client", "xmlrpclib", "xmlrpc.client"), + MovedModule("xmlrpc_server", "SimpleXMLRPCServer", "xmlrpc.server"), +] +# Add windows specific modules. +if sys.platform == "win32": + _moved_attributes += [ + MovedModule("winreg", "_winreg"), + ] + +for attr in _moved_attributes: + setattr(_MovedItems, attr.name, attr) + if isinstance(attr, MovedModule): + _importer._add_module(attr, "moves." + attr.name) +del attr + +_MovedItems._moved_attributes = _moved_attributes + +moves = _MovedItems(__name__ + ".moves") +_importer._add_module(moves, "moves") + + +class Module_six_moves_urllib_parse(_LazyModule): + + """Lazy loading of moved objects in six.moves.urllib_parse""" + + +_urllib_parse_moved_attributes = [ + MovedAttribute("ParseResult", "urlparse", "urllib.parse"), + MovedAttribute("SplitResult", "urlparse", "urllib.parse"), + MovedAttribute("parse_qs", "urlparse", "urllib.parse"), + MovedAttribute("parse_qsl", "urlparse", "urllib.parse"), + MovedAttribute("urldefrag", "urlparse", "urllib.parse"), + MovedAttribute("urljoin", "urlparse", "urllib.parse"), + MovedAttribute("urlparse", "urlparse", "urllib.parse"), + MovedAttribute("urlsplit", "urlparse", "urllib.parse"), + MovedAttribute("urlunparse", "urlparse", "urllib.parse"), + MovedAttribute("urlunsplit", "urlparse", "urllib.parse"), + MovedAttribute("quote", "urllib", "urllib.parse"), + MovedAttribute("quote_plus", "urllib", "urllib.parse"), + MovedAttribute("unquote", "urllib", "urllib.parse"), + MovedAttribute("unquote_plus", "urllib", "urllib.parse"), + MovedAttribute("urlencode", "urllib", "urllib.parse"), + MovedAttribute("splitquery", "urllib", "urllib.parse"), + MovedAttribute("splittag", "urllib", "urllib.parse"), + MovedAttribute("splituser", "urllib", "urllib.parse"), + MovedAttribute("uses_fragment", "urlparse", "urllib.parse"), + MovedAttribute("uses_netloc", "urlparse", "urllib.parse"), + MovedAttribute("uses_params", "urlparse", "urllib.parse"), + MovedAttribute("uses_query", "urlparse", "urllib.parse"), + MovedAttribute("uses_relative", "urlparse", "urllib.parse"), +] +for attr in _urllib_parse_moved_attributes: + setattr(Module_six_moves_urllib_parse, attr.name, attr) +del attr + +Module_six_moves_urllib_parse._moved_attributes = _urllib_parse_moved_attributes + +_importer._add_module(Module_six_moves_urllib_parse(__name__ + ".moves.urllib_parse"), + "moves.urllib_parse", "moves.urllib.parse") + + +class Module_six_moves_urllib_error(_LazyModule): + + """Lazy loading of moved objects in six.moves.urllib_error""" + + +_urllib_error_moved_attributes = [ + MovedAttribute("URLError", "urllib2", "urllib.error"), + MovedAttribute("HTTPError", "urllib2", "urllib.error"), + MovedAttribute("ContentTooShortError", "urllib", "urllib.error"), +] +for attr in _urllib_error_moved_attributes: + setattr(Module_six_moves_urllib_error, attr.name, attr) +del attr + +Module_six_moves_urllib_error._moved_attributes = _urllib_error_moved_attributes + +_importer._add_module(Module_six_moves_urllib_error(__name__ + ".moves.urllib.error"), + "moves.urllib_error", "moves.urllib.error") + + +class Module_six_moves_urllib_request(_LazyModule): + + """Lazy loading of moved objects in six.moves.urllib_request""" + + +_urllib_request_moved_attributes = [ + MovedAttribute("urlopen", "urllib2", "urllib.request"), + MovedAttribute("install_opener", "urllib2", "urllib.request"), + MovedAttribute("build_opener", "urllib2", "urllib.request"), + MovedAttribute("pathname2url", "urllib", "urllib.request"), + MovedAttribute("url2pathname", "urllib", "urllib.request"), + MovedAttribute("getproxies", "urllib", "urllib.request"), + MovedAttribute("Request", "urllib2", "urllib.request"), + MovedAttribute("OpenerDirector", "urllib2", "urllib.request"), + MovedAttribute("HTTPDefaultErrorHandler", "urllib2", "urllib.request"), + MovedAttribute("HTTPRedirectHandler", "urllib2", "urllib.request"), + MovedAttribute("HTTPCookieProcessor", "urllib2", "urllib.request"), + MovedAttribute("ProxyHandler", "urllib2", "urllib.request"), + MovedAttribute("BaseHandler", "urllib2", "urllib.request"), + MovedAttribute("HTTPPasswordMgr", "urllib2", "urllib.request"), + MovedAttribute("HTTPPasswordMgrWithDefaultRealm", "urllib2", "urllib.request"), + MovedAttribute("AbstractBasicAuthHandler", "urllib2", "urllib.request"), + MovedAttribute("HTTPBasicAuthHandler", "urllib2", "urllib.request"), + MovedAttribute("ProxyBasicAuthHandler", "urllib2", "urllib.request"), + MovedAttribute("AbstractDigestAuthHandler", "urllib2", "urllib.request"), + MovedAttribute("HTTPDigestAuthHandler", "urllib2", "urllib.request"), + MovedAttribute("ProxyDigestAuthHandler", "urllib2", "urllib.request"), + MovedAttribute("HTTPHandler", "urllib2", "urllib.request"), + MovedAttribute("HTTPSHandler", "urllib2", "urllib.request"), + MovedAttribute("FileHandler", "urllib2", "urllib.request"), + MovedAttribute("FTPHandler", "urllib2", "urllib.request"), + MovedAttribute("CacheFTPHandler", "urllib2", "urllib.request"), + MovedAttribute("UnknownHandler", "urllib2", "urllib.request"), + MovedAttribute("HTTPErrorProcessor", "urllib2", "urllib.request"), + MovedAttribute("urlretrieve", "urllib", "urllib.request"), + MovedAttribute("urlcleanup", "urllib", "urllib.request"), + MovedAttribute("URLopener", "urllib", "urllib.request"), + MovedAttribute("FancyURLopener", "urllib", "urllib.request"), + MovedAttribute("proxy_bypass", "urllib", "urllib.request"), +] +for attr in _urllib_request_moved_attributes: + setattr(Module_six_moves_urllib_request, attr.name, attr) +del attr + +Module_six_moves_urllib_request._moved_attributes = _urllib_request_moved_attributes + +_importer._add_module(Module_six_moves_urllib_request(__name__ + ".moves.urllib.request"), + "moves.urllib_request", "moves.urllib.request") + + +class Module_six_moves_urllib_response(_LazyModule): + + """Lazy loading of moved objects in six.moves.urllib_response""" + + +_urllib_response_moved_attributes = [ + MovedAttribute("addbase", "urllib", "urllib.response"), + MovedAttribute("addclosehook", "urllib", "urllib.response"), + MovedAttribute("addinfo", "urllib", "urllib.response"), + MovedAttribute("addinfourl", "urllib", "urllib.response"), +] +for attr in _urllib_response_moved_attributes: + setattr(Module_six_moves_urllib_response, attr.name, attr) +del attr + +Module_six_moves_urllib_response._moved_attributes = _urllib_response_moved_attributes + +_importer._add_module(Module_six_moves_urllib_response(__name__ + ".moves.urllib.response"), + "moves.urllib_response", "moves.urllib.response") + + +class Module_six_moves_urllib_robotparser(_LazyModule): + + """Lazy loading of moved objects in six.moves.urllib_robotparser""" + + +_urllib_robotparser_moved_attributes = [ + MovedAttribute("RobotFileParser", "robotparser", "urllib.robotparser"), +] +for attr in _urllib_robotparser_moved_attributes: + setattr(Module_six_moves_urllib_robotparser, attr.name, attr) +del attr + +Module_six_moves_urllib_robotparser._moved_attributes = _urllib_robotparser_moved_attributes + +_importer._add_module(Module_six_moves_urllib_robotparser(__name__ + ".moves.urllib.robotparser"), + "moves.urllib_robotparser", "moves.urllib.robotparser") + + +class Module_six_moves_urllib(types.ModuleType): + + """Create a six.moves.urllib namespace that resembles the Python 3 namespace""" + __path__ = [] # mark as package + parse = _importer._get_module("moves.urllib_parse") + error = _importer._get_module("moves.urllib_error") + request = _importer._get_module("moves.urllib_request") + response = _importer._get_module("moves.urllib_response") + robotparser = _importer._get_module("moves.urllib_robotparser") + + def __dir__(self): + return ['parse', 'error', 'request', 'response', 'robotparser'] + +_importer._add_module(Module_six_moves_urllib(__name__ + ".moves.urllib"), + "moves.urllib") + + +def add_move(move): + """Add an item to six.moves.""" + setattr(_MovedItems, move.name, move) + + +def remove_move(name): + """Remove item from six.moves.""" + try: + delattr(_MovedItems, name) + except AttributeError: + try: + del moves.__dict__[name] + except KeyError: + raise AttributeError("no such move, %r" % (name,)) + + +if PY3: + _meth_func = "__func__" + _meth_self = "__self__" + + _func_closure = "__closure__" + _func_code = "__code__" + _func_defaults = "__defaults__" + _func_globals = "__globals__" +else: + _meth_func = "im_func" + _meth_self = "im_self" + + _func_closure = "func_closure" + _func_code = "func_code" + _func_defaults = "func_defaults" + _func_globals = "func_globals" + + +try: + advance_iterator = next +except NameError: + def advance_iterator(it): + return it.next() +next = advance_iterator + + +try: + callable = callable +except NameError: + def callable(obj): + return any("__call__" in klass.__dict__ for klass in type(obj).__mro__) + + +if PY3: + def get_unbound_function(unbound): + return unbound + + create_bound_method = types.MethodType + + def create_unbound_method(func, cls): + return func + + Iterator = object +else: + def get_unbound_function(unbound): + return unbound.im_func + + def create_bound_method(func, obj): + return types.MethodType(func, obj, obj.__class__) + + def create_unbound_method(func, cls): + return types.MethodType(func, None, cls) + + class Iterator(object): + + def next(self): + return type(self).__next__(self) + + callable = callable +_add_doc(get_unbound_function, + """Get the function out of a possibly unbound function""") + + +get_method_function = operator.attrgetter(_meth_func) +get_method_self = operator.attrgetter(_meth_self) +get_function_closure = operator.attrgetter(_func_closure) +get_function_code = operator.attrgetter(_func_code) +get_function_defaults = operator.attrgetter(_func_defaults) +get_function_globals = operator.attrgetter(_func_globals) + + +if PY3: + def iterkeys(d, **kw): + return iter(d.keys(**kw)) + + def itervalues(d, **kw): + return iter(d.values(**kw)) + + def iteritems(d, **kw): + return iter(d.items(**kw)) + + def iterlists(d, **kw): + return iter(d.lists(**kw)) + + viewkeys = operator.methodcaller("keys") + + viewvalues = operator.methodcaller("values") + + viewitems = operator.methodcaller("items") +else: + def iterkeys(d, **kw): + return d.iterkeys(**kw) + + def itervalues(d, **kw): + return d.itervalues(**kw) + + def iteritems(d, **kw): + return d.iteritems(**kw) + + def iterlists(d, **kw): + return d.iterlists(**kw) + + viewkeys = operator.methodcaller("viewkeys") + + viewvalues = operator.methodcaller("viewvalues") + + viewitems = operator.methodcaller("viewitems") + +_add_doc(iterkeys, "Return an iterator over the keys of a dictionary.") +_add_doc(itervalues, "Return an iterator over the values of a dictionary.") +_add_doc(iteritems, + "Return an iterator over the (key, value) pairs of a dictionary.") +_add_doc(iterlists, + "Return an iterator over the (key, [values]) pairs of a dictionary.") + + +if PY3: + def b(s): + return s.encode("latin-1") + + def u(s): + return s + unichr = chr + import struct + int2byte = struct.Struct(">B").pack + del struct + byte2int = operator.itemgetter(0) + indexbytes = operator.getitem + iterbytes = iter + import io + StringIO = io.StringIO + BytesIO = io.BytesIO + _assertCountEqual = "assertCountEqual" + if sys.version_info[1] <= 1: + _assertRaisesRegex = "assertRaisesRegexp" + _assertRegex = "assertRegexpMatches" + else: + _assertRaisesRegex = "assertRaisesRegex" + _assertRegex = "assertRegex" +else: + def b(s): + return s + # Workaround for standalone backslash + + def u(s): + return unicode(s.replace(r'\\', r'\\\\'), "unicode_escape") + unichr = unichr + int2byte = chr + + def byte2int(bs): + return ord(bs[0]) + + def indexbytes(buf, i): + return ord(buf[i]) + iterbytes = functools.partial(itertools.imap, ord) + import StringIO + StringIO = BytesIO = StringIO.StringIO + _assertCountEqual = "assertItemsEqual" + _assertRaisesRegex = "assertRaisesRegexp" + _assertRegex = "assertRegexpMatches" +_add_doc(b, """Byte literal""") +_add_doc(u, """Text literal""") + + +def assertCountEqual(self, *args, **kwargs): + return getattr(self, _assertCountEqual)(*args, **kwargs) + + +def assertRaisesRegex(self, *args, **kwargs): + return getattr(self, _assertRaisesRegex)(*args, **kwargs) + + +def assertRegex(self, *args, **kwargs): + return getattr(self, _assertRegex)(*args, **kwargs) + + +if PY3: + exec_ = getattr(moves.builtins, "exec") + + def reraise(tp, value, tb=None): + if value is None: + value = tp() + if value.__traceback__ is not tb: + raise value.with_traceback(tb) + raise value + +else: + def exec_(_code_, _globs_=None, _locs_=None): + """Execute code in a namespace.""" + if _globs_ is None: + frame = sys._getframe(1) + _globs_ = frame.f_globals + if _locs_ is None: + _locs_ = frame.f_locals + del frame + elif _locs_ is None: + _locs_ = _globs_ + exec("""exec _code_ in _globs_, _locs_""") + + exec_("""def reraise(tp, value, tb=None): + raise tp, value, tb +""") + + +if sys.version_info[:2] == (3, 2): + exec_("""def raise_from(value, from_value): + if from_value is None: + raise value + raise value from from_value +""") +elif sys.version_info[:2] > (3, 2): + exec_("""def raise_from(value, from_value): + raise value from from_value +""") +else: + def raise_from(value, from_value): + raise value + + +print_ = getattr(moves.builtins, "print", None) +if print_ is None: + def print_(*args, **kwargs): + """The new-style print function for Python 2.4 and 2.5.""" + fp = kwargs.pop("file", sys.stdout) + if fp is None: + return + + def write(data): + if not isinstance(data, basestring): + data = str(data) + # If the file has an encoding, encode unicode with it. + if (isinstance(fp, file) and + isinstance(data, unicode) and + fp.encoding is not None): + errors = getattr(fp, "errors", None) + if errors is None: + errors = "strict" + data = data.encode(fp.encoding, errors) + fp.write(data) + want_unicode = False + sep = kwargs.pop("sep", None) + if sep is not None: + if isinstance(sep, unicode): + want_unicode = True + elif not isinstance(sep, str): + raise TypeError("sep must be None or a string") + end = kwargs.pop("end", None) + if end is not None: + if isinstance(end, unicode): + want_unicode = True + elif not isinstance(end, str): + raise TypeError("end must be None or a string") + if kwargs: + raise TypeError("invalid keyword arguments to print()") + if not want_unicode: + for arg in args: + if isinstance(arg, unicode): + want_unicode = True + break + if want_unicode: + newline = unicode("\n") + space = unicode(" ") + else: + newline = "\n" + space = " " + if sep is None: + sep = space + if end is None: + end = newline + for i, arg in enumerate(args): + if i: + write(sep) + write(arg) + write(end) +if sys.version_info[:2] < (3, 3): + _print = print_ + + def print_(*args, **kwargs): + fp = kwargs.get("file", sys.stdout) + flush = kwargs.pop("flush", False) + _print(*args, **kwargs) + if flush and fp is not None: + fp.flush() + +_add_doc(reraise, """Reraise an exception.""") + +if sys.version_info[0:2] < (3, 4): + def wraps(wrapped, assigned=functools.WRAPPER_ASSIGNMENTS, + updated=functools.WRAPPER_UPDATES): + def wrapper(f): + f = functools.wraps(wrapped, assigned, updated)(f) + f.__wrapped__ = wrapped + return f + return wrapper +else: + wraps = functools.wraps + + +def with_metaclass(meta, *bases): + """Create a base class with a metaclass.""" + # This requires a bit of explanation: the basic idea is to make a dummy + # metaclass for one level of class instantiation that replaces itself with + # the actual metaclass. + class metaclass(meta): + + def __new__(cls, name, this_bases, d): + return meta(name, bases, d) + return type.__new__(metaclass, 'temporary_class', (), {}) + + +def add_metaclass(metaclass): + """Class decorator for creating a class with a metaclass.""" + def wrapper(cls): + orig_vars = cls.__dict__.copy() + slots = orig_vars.get('__slots__') + if slots is not None: + if isinstance(slots, str): + slots = [slots] + for slots_var in slots: + orig_vars.pop(slots_var) + orig_vars.pop('__dict__', None) + orig_vars.pop('__weakref__', None) + return metaclass(cls.__name__, cls.__bases__, orig_vars) + return wrapper + + +def python_2_unicode_compatible(klass): + """ + A decorator that defines __unicode__ and __str__ methods under Python 2. + Under Python 3 it does nothing. + + To support Python 2 and 3 with a single code base, define a __str__ method + returning text and apply this decorator to the class. + """ + if PY2: + if '__str__' not in klass.__dict__: + raise ValueError("@python_2_unicode_compatible cannot be applied " + "to %s because it doesn't define __str__()." % + klass.__name__) + klass.__unicode__ = klass.__str__ + klass.__str__ = lambda self: self.__unicode__().encode('utf-8') + return klass + + +# Complete the moves implementation. +# This code is at the end of this module to speed up module loading. +# Turn this module into a package. +__path__ = [] # required for PEP 302 and PEP 451 +__package__ = __name__ # see PEP 366 @ReservedAssignment +if globals().get("__spec__") is not None: + __spec__.submodule_search_locations = [] # PEP 451 @UndefinedVariable +# Remove other six meta path importers, since they cause problems. This can +# happen if six is removed from sys.modules and then reloaded. (Setuptools does +# this for some reason.) +if sys.meta_path: + for i, importer in enumerate(sys.meta_path): + # Here's some real nastiness: Another "instance" of the six module might + # be floating around. Therefore, we can't use isinstance() to check for + # the six meta path importer, since the other six instance will have + # inserted an importer with different class. + if (type(importer).__name__ == "_SixMetaPathImporter" and + importer.name == __name__): + del sys.meta_path[i] + break + del i, importer +# Finally, add the importer to the meta path import hook. +sys.meta_path.append(_importer) diff --git a/venv/lib/python3.8/site-packages/setuptools/archive_util.py b/venv/lib/python3.8/site-packages/setuptools/archive_util.py new file mode 100644 index 000000000..81436044d --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/archive_util.py @@ -0,0 +1,173 @@ +"""Utilities for extracting common archive formats""" + +import zipfile +import tarfile +import os +import shutil +import posixpath +import contextlib +from distutils.errors import DistutilsError + +from pkg_resources import ensure_directory + +__all__ = [ + "unpack_archive", "unpack_zipfile", "unpack_tarfile", "default_filter", + "UnrecognizedFormat", "extraction_drivers", "unpack_directory", +] + + +class UnrecognizedFormat(DistutilsError): + """Couldn't recognize the archive type""" + + +def default_filter(src, dst): + """The default progress/filter callback; returns True for all files""" + return dst + + +def unpack_archive(filename, extract_dir, progress_filter=default_filter, + drivers=None): + """Unpack `filename` to `extract_dir`, or raise ``UnrecognizedFormat`` + + `progress_filter` is a function taking two arguments: a source path + internal to the archive ('/'-separated), and a filesystem path where it + will be extracted. The callback must return the desired extract path + (which may be the same as the one passed in), or else ``None`` to skip + that file or directory. The callback can thus be used to report on the + progress of the extraction, as well as to filter the items extracted or + alter their extraction paths. + + `drivers`, if supplied, must be a non-empty sequence of functions with the + same signature as this function (minus the `drivers` argument), that raise + ``UnrecognizedFormat`` if they do not support extracting the designated + archive type. The `drivers` are tried in sequence until one is found that + does not raise an error, or until all are exhausted (in which case + ``UnrecognizedFormat`` is raised). If you do not supply a sequence of + drivers, the module's ``extraction_drivers`` constant will be used, which + means that ``unpack_zipfile`` and ``unpack_tarfile`` will be tried, in that + order. + """ + for driver in drivers or extraction_drivers: + try: + driver(filename, extract_dir, progress_filter) + except UnrecognizedFormat: + continue + else: + return + else: + raise UnrecognizedFormat( + "Not a recognized archive type: %s" % filename + ) + + +def unpack_directory(filename, extract_dir, progress_filter=default_filter): + """"Unpack" a directory, using the same interface as for archives + + Raises ``UnrecognizedFormat`` if `filename` is not a directory + """ + if not os.path.isdir(filename): + raise UnrecognizedFormat("%s is not a directory" % filename) + + paths = { + filename: ('', extract_dir), + } + for base, dirs, files in os.walk(filename): + src, dst = paths[base] + for d in dirs: + paths[os.path.join(base, d)] = src + d + '/', os.path.join(dst, d) + for f in files: + target = os.path.join(dst, f) + target = progress_filter(src + f, target) + if not target: + # skip non-files + continue + ensure_directory(target) + f = os.path.join(base, f) + shutil.copyfile(f, target) + shutil.copystat(f, target) + + +def unpack_zipfile(filename, extract_dir, progress_filter=default_filter): + """Unpack zip `filename` to `extract_dir` + + Raises ``UnrecognizedFormat`` if `filename` is not a zipfile (as determined + by ``zipfile.is_zipfile()``). See ``unpack_archive()`` for an explanation + of the `progress_filter` argument. + """ + + if not zipfile.is_zipfile(filename): + raise UnrecognizedFormat("%s is not a zip file" % (filename,)) + + with zipfile.ZipFile(filename) as z: + for info in z.infolist(): + name = info.filename + + # don't extract absolute paths or ones with .. in them + if name.startswith('/') or '..' in name.split('/'): + continue + + target = os.path.join(extract_dir, *name.split('/')) + target = progress_filter(name, target) + if not target: + continue + if name.endswith('/'): + # directory + ensure_directory(target) + else: + # file + ensure_directory(target) + data = z.read(info.filename) + with open(target, 'wb') as f: + f.write(data) + unix_attributes = info.external_attr >> 16 + if unix_attributes: + os.chmod(target, unix_attributes) + + +def unpack_tarfile(filename, extract_dir, progress_filter=default_filter): + """Unpack tar/tar.gz/tar.bz2 `filename` to `extract_dir` + + Raises ``UnrecognizedFormat`` if `filename` is not a tarfile (as determined + by ``tarfile.open()``). See ``unpack_archive()`` for an explanation + of the `progress_filter` argument. + """ + try: + tarobj = tarfile.open(filename) + except tarfile.TarError: + raise UnrecognizedFormat( + "%s is not a compressed or uncompressed tar file" % (filename,) + ) + with contextlib.closing(tarobj): + # don't do any chowning! + tarobj.chown = lambda *args: None + for member in tarobj: + name = member.name + # don't extract absolute paths or ones with .. in them + if not name.startswith('/') and '..' not in name.split('/'): + prelim_dst = os.path.join(extract_dir, *name.split('/')) + + # resolve any links and to extract the link targets as normal + # files + while member is not None and (member.islnk() or member.issym()): + linkpath = member.linkname + if member.issym(): + base = posixpath.dirname(member.name) + linkpath = posixpath.join(base, linkpath) + linkpath = posixpath.normpath(linkpath) + member = tarobj._getmember(linkpath) + + if member is not None and (member.isfile() or member.isdir()): + final_dst = progress_filter(name, prelim_dst) + if final_dst: + if final_dst.endswith(os.sep): + final_dst = final_dst[:-1] + try: + # XXX Ugh + tarobj._extract_member(member, final_dst) + except tarfile.ExtractError: + # chown/chmod/mkfifo/mknode/makedev failed + pass + return True + + +extraction_drivers = unpack_directory, unpack_zipfile, unpack_tarfile diff --git a/venv/lib/python3.8/site-packages/setuptools/build_meta.py b/venv/lib/python3.8/site-packages/setuptools/build_meta.py new file mode 100644 index 000000000..10c4b528d --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/build_meta.py @@ -0,0 +1,257 @@ +"""A PEP 517 interface to setuptools + +Previously, when a user or a command line tool (let's call it a "frontend") +needed to make a request of setuptools to take a certain action, for +example, generating a list of installation requirements, the frontend would +would call "setup.py egg_info" or "setup.py bdist_wheel" on the command line. + +PEP 517 defines a different method of interfacing with setuptools. Rather +than calling "setup.py" directly, the frontend should: + + 1. Set the current directory to the directory with a setup.py file + 2. Import this module into a safe python interpreter (one in which + setuptools can potentially set global variables or crash hard). + 3. Call one of the functions defined in PEP 517. + +What each function does is defined in PEP 517. However, here is a "casual" +definition of the functions (this definition should not be relied on for +bug reports or API stability): + + - `build_wheel`: build a wheel in the folder and return the basename + - `get_requires_for_build_wheel`: get the `setup_requires` to build + - `prepare_metadata_for_build_wheel`: get the `install_requires` + - `build_sdist`: build an sdist in the folder and return the basename + - `get_requires_for_build_sdist`: get the `setup_requires` to build + +Again, this is not a formal definition! Just a "taste" of the module. +""" + +import io +import os +import sys +import tokenize +import shutil +import contextlib + +import setuptools +import distutils +from setuptools.py31compat import TemporaryDirectory + +from pkg_resources import parse_requirements +from pkg_resources.py31compat import makedirs + +__all__ = ['get_requires_for_build_sdist', + 'get_requires_for_build_wheel', + 'prepare_metadata_for_build_wheel', + 'build_wheel', + 'build_sdist', + '__legacy__', + 'SetupRequirementsError'] + +class SetupRequirementsError(BaseException): + def __init__(self, specifiers): + self.specifiers = specifiers + + +class Distribution(setuptools.dist.Distribution): + def fetch_build_eggs(self, specifiers): + specifier_list = list(map(str, parse_requirements(specifiers))) + + raise SetupRequirementsError(specifier_list) + + @classmethod + @contextlib.contextmanager + def patch(cls): + """ + Replace + distutils.dist.Distribution with this class + for the duration of this context. + """ + orig = distutils.core.Distribution + distutils.core.Distribution = cls + try: + yield + finally: + distutils.core.Distribution = orig + + +def _to_str(s): + """ + Convert a filename to a string (on Python 2, explicitly + a byte string, not Unicode) as distutils checks for the + exact type str. + """ + if sys.version_info[0] == 2 and not isinstance(s, str): + # Assume it's Unicode, as that's what the PEP says + # should be provided. + return s.encode(sys.getfilesystemencoding()) + return s + + +def _get_immediate_subdirectories(a_dir): + return [name for name in os.listdir(a_dir) + if os.path.isdir(os.path.join(a_dir, name))] + + +def _file_with_extension(directory, extension): + matching = ( + f for f in os.listdir(directory) + if f.endswith(extension) + ) + file, = matching + return file + + +def _open_setup_script(setup_script): + if not os.path.exists(setup_script): + # Supply a default setup.py + return io.StringIO(u"from setuptools import setup; setup()") + + return getattr(tokenize, 'open', open)(setup_script) + + +class _BuildMetaBackend(object): + + def _fix_config(self, config_settings): + config_settings = config_settings or {} + config_settings.setdefault('--global-option', []) + return config_settings + + def _get_build_requires(self, config_settings, requirements): + config_settings = self._fix_config(config_settings) + + sys.argv = sys.argv[:1] + ['egg_info'] + \ + config_settings["--global-option"] + try: + with Distribution.patch(): + self.run_setup() + except SetupRequirementsError as e: + requirements += e.specifiers + + return requirements + + def run_setup(self, setup_script='setup.py'): + # Note that we can reuse our build directory between calls + # Correctness comes first, then optimization later + __file__ = setup_script + __name__ = '__main__' + + with _open_setup_script(__file__) as f: + code = f.read().replace(r'\r\n', r'\n') + + exec(compile(code, __file__, 'exec'), locals()) + + def get_requires_for_build_wheel(self, config_settings=None): + config_settings = self._fix_config(config_settings) + return self._get_build_requires(config_settings, requirements=['wheel']) + + def get_requires_for_build_sdist(self, config_settings=None): + config_settings = self._fix_config(config_settings) + return self._get_build_requires(config_settings, requirements=[]) + + def prepare_metadata_for_build_wheel(self, metadata_directory, + config_settings=None): + sys.argv = sys.argv[:1] + ['dist_info', '--egg-base', + _to_str(metadata_directory)] + self.run_setup() + + dist_info_directory = metadata_directory + while True: + dist_infos = [f for f in os.listdir(dist_info_directory) + if f.endswith('.dist-info')] + + if (len(dist_infos) == 0 and + len(_get_immediate_subdirectories(dist_info_directory)) == 1): + + dist_info_directory = os.path.join( + dist_info_directory, os.listdir(dist_info_directory)[0]) + continue + + assert len(dist_infos) == 1 + break + + # PEP 517 requires that the .dist-info directory be placed in the + # metadata_directory. To comply, we MUST copy the directory to the root + if dist_info_directory != metadata_directory: + shutil.move( + os.path.join(dist_info_directory, dist_infos[0]), + metadata_directory) + shutil.rmtree(dist_info_directory, ignore_errors=True) + + return dist_infos[0] + + def _build_with_temp_dir(self, setup_command, result_extension, + result_directory, config_settings): + config_settings = self._fix_config(config_settings) + result_directory = os.path.abspath(result_directory) + + # Build in a temporary directory, then copy to the target. + makedirs(result_directory, exist_ok=True) + with TemporaryDirectory(dir=result_directory) as tmp_dist_dir: + sys.argv = (sys.argv[:1] + setup_command + + ['--dist-dir', tmp_dist_dir] + + config_settings["--global-option"]) + self.run_setup() + + result_basename = _file_with_extension(tmp_dist_dir, result_extension) + result_path = os.path.join(result_directory, result_basename) + if os.path.exists(result_path): + # os.rename will fail overwriting on non-Unix. + os.remove(result_path) + os.rename(os.path.join(tmp_dist_dir, result_basename), result_path) + + return result_basename + + + def build_wheel(self, wheel_directory, config_settings=None, + metadata_directory=None): + return self._build_with_temp_dir(['bdist_wheel'], '.whl', + wheel_directory, config_settings) + + def build_sdist(self, sdist_directory, config_settings=None): + return self._build_with_temp_dir(['sdist', '--formats', 'gztar'], + '.tar.gz', sdist_directory, + config_settings) + + +class _BuildMetaLegacyBackend(_BuildMetaBackend): + """Compatibility backend for setuptools + + This is a version of setuptools.build_meta that endeavors to maintain backwards + compatibility with pre-PEP 517 modes of invocation. It exists as a temporary + bridge between the old packaging mechanism and the new packaging mechanism, + and will eventually be removed. + """ + def run_setup(self, setup_script='setup.py'): + # In order to maintain compatibility with scripts assuming that + # the setup.py script is in a directory on the PYTHONPATH, inject + # '' into sys.path. (pypa/setuptools#1642) + sys_path = list(sys.path) # Save the original path + + script_dir = os.path.dirname(os.path.abspath(setup_script)) + if script_dir not in sys.path: + sys.path.insert(0, script_dir) + + try: + super(_BuildMetaLegacyBackend, + self).run_setup(setup_script=setup_script) + finally: + # While PEP 517 frontends should be calling each hook in a fresh + # subprocess according to the standard (and thus it should not be + # strictly necessary to restore the old sys.path), we'll restore + # the original path so that the path manipulation does not persist + # within the hook after run_setup is called. + sys.path[:] = sys_path + +# The primary backend +_BACKEND = _BuildMetaBackend() + +get_requires_for_build_wheel = _BACKEND.get_requires_for_build_wheel +get_requires_for_build_sdist = _BACKEND.get_requires_for_build_sdist +prepare_metadata_for_build_wheel = _BACKEND.prepare_metadata_for_build_wheel +build_wheel = _BACKEND.build_wheel +build_sdist = _BACKEND.build_sdist + + +# The legacy backend +__legacy__ = _BuildMetaLegacyBackend() diff --git a/venv/lib/python3.8/site-packages/setuptools/cli-32.exe b/venv/lib/python3.8/site-packages/setuptools/cli-32.exe new file mode 100644 index 0000000000000000000000000000000000000000..b1487b7819e7286577a043c7726fbe0ca1543083 GIT binary patch literal 65536 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

@|$jDp4t7maBT@by!vG1&J_?=DS4W3Hu6w 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[c}iI#RErv3nvcIClH@!{vM)zJ_weD zu_-L8NU*GlC{d0L!!VW10^+~>qmNB~Y8H+F}!P8_d(PpvjzMJQmr z)FkX;2B~<|3JfJeWv@IXo~nTtp$}Gjie> zs8UDG*kid(%i5QCBp~MA;#I186PI-nZ&k7!k8BiLJSuR>h7ArSYHD~B0I z=T6L{zqglekt0JjG5z&|GWb4?+B5+{p^fgTufl_KesA{@I&g7rNq==^SGc5GcM%$N zDBG2)qExz*Z;jGN_-iD-y8i2BCq)p}2lKcspLg>w-;qwg(()HXrZa3jd!}spuwBVX zwmX!iwU?#7uoQnunw|OlU~+c z^L5Ak3zWhaA4B^FhMMboO0k*O2GL)lD9_<$5b>czbCvKcSt+u*gA*=%dH>Q-Bc11h zzO7jbXN)&5mBf=w2anK6P$YcJZQoWa2#E!v{hFKxxm7Fc)Fc9iC35{|Lp7bIDjrhC zgMiGf4r2yquH{U7WdMio;XS4Y%Ry{q7#kv#gZ07i`7eo#MMh_o68E*Fd_#nrri^4b zX+slbsv>+8pmck%oLDUL()8NRJ#Z z8DReF_eq2zsjEXGs)yS{k}ykS1B!ZrY0f6O65^lslJv3g&wfpDg-&EwF8wrc=hSwm zPlV&n%%yE_@onOwK?)`GNJ6MQ0drMuBYWCH5dkD)uErh@*k}#GcFl<-;;TN+5vb|b zctkCv;*zL7f)A;QuO%(81r0)&aUz4EQu;kA!k@7i8RZ)koMaWW`5cC6n@{w!!J$5d zx}l)4VP4xL=BKi&c^{n_Qi`q@G{vimblcVR53b#*X$FUOQFm!A8JKahNSiBdY+x3bJZfD8n{--FLUM4+Mx@{vM_ep zkk)U=K8R(rhU(X_faI*ZO}cn`5t*O}lx^j8|0rt-)o=Axn^DGcQTi!#7hxLTq?|HQ zB;T6(nrsCeYK0_o%)IO+CP{n#+|;w1ZmvD2c-J{i88bp63RjyKOE!B!D3U{RCs*Zh z&^%65VM(J34230U4bHS}M@SYS9TEK}c%)2<$h1|T;##zRtjRt@#1T%J=kAhOiw+Z% z7DpyWVK@6%9K^uVD9LDKj)dR^aZK6$@Lt)l;sj@`QSzBm{TlLG{JKM_^60Zr2w~nr zr>P-BaV8OjjWm?hQ3$ZCx+lyD%q`~4iNF9xWKi$t&pzBhwN9Dq-o^v9@=abLR#|

KZqkLal4YCRR9VNhIM|rBqmzzcImvcx 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 literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/setuptools/cli-64.exe b/venv/lib/python3.8/site-packages/setuptools/cli-64.exe new file mode 100644 index 0000000000000000000000000000000000000000..675e6bf3743f3d3011c238657e7128ee9960ef7f GIT binary patch literal 74752 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 literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/setuptools/cli.exe b/venv/lib/python3.8/site-packages/setuptools/cli.exe new file mode 100644 index 0000000000000000000000000000000000000000..b1487b7819e7286577a043c7726fbe0ca1543083 GIT binary patch literal 65536 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

@|$jDp4t7maBT@by!vG1&J_?=DS4W3Hu6w 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[c}iI#RErv3nvcIClH@!{vM)zJ_weD zu_-L8NU*GlC{d0L!!VW10^+~>qmNB~Y8H+F}!P8_d(PpvjzMJQmr z)FkX;2B~<|3JfJeWv@IXo~nTtp$}Gjie> zs8UDG*kid(%i5QCBp~MA;#I186PI-nZ&k7!k8BiLJSuR>h7ArSYHD~B0I z=T6L{zqglekt0JjG5z&|GWb4?+B5+{p^fgTufl_KesA{@I&g7rNq==^SGc5GcM%$N zDBG2)qExz*Z;jGN_-iD-y8i2BCq)p}2lKcspLg>w-;qwg(()HXrZa3jd!}spuwBVX zwmX!iwU?#7uoQnunw|OlU~+c z^L5Ak3zWhaA4B^FhMMboO0k*O2GL)lD9_<$5b>czbCvKcSt+u*gA*=%dH>Q-Bc11h zzO7jbXN)&5mBf=w2anK6P$YcJZQoWa2#E!v{hFKxxm7Fc)Fc9iC35{|Lp7bIDjrhC zgMiGf4r2yquH{U7WdMio;XS4Y%Ry{q7#kv#gZ07i`7eo#MMh_o68E*Fd_#nrri^4b zX+slbsv>+8pmck%oLDUL()8NRJ#Z z8DReF_eq2zsjEXGs)yS{k}ykS1B!ZrY0f6O65^lslJv3g&wfpDg-&EwF8wrc=hSwm zPlV&n%%yE_@onOwK?)`GNJ6MQ0drMuBYWCH5dkD)uErh@*k}#GcFl<-;;TN+5vb|b zctkCv;*zL7f)A;QuO%(81r0)&aUz4EQu;kA!k@7i8RZ)koMaWW`5cC6n@{w!!J$5d zx}l)4VP4xL=BKi&c^{n_Qi`q@G{vimblcVR53b#*X$FUOQFm!A8JKahNSiBdY+x3bJZfD8n{--FLUM4+Mx@{vM_ep zkk)U=K8R(rhU(X_faI*ZO}cn`5t*O}lx^j8|0rt-)o=Axn^DGcQTi!#7hxLTq?|HQ zB;T6(nrsCeYK0_o%)IO+CP{n#+|;w1ZmvD2c-J{i88bp63RjyKOE!B!D3U{RCs*Zh z&^%65VM(J34230U4bHS}M@SYS9TEK}c%)2<$h1|T;##zRtjRt@#1T%J=kAhOiw+Z% z7DpyWVK@6%9K^uVD9LDKj)dR^aZK6$@Lt)l;sj@`QSzBm{TlLG{JKM_^60Zr2w~nr zr>P-BaV8OjjWm?hQ3$ZCx+lyD%q`~4iNF9xWKi$t&pzBhwN9Dq-o^v9@=abLR#|

KZqkLal4YCRR9VNhIM|rBqmzzcImvcx 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 literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/setuptools/command/__init__.py b/venv/lib/python3.8/site-packages/setuptools/command/__init__.py new file mode 100644 index 000000000..743f5588f --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/command/__init__.py @@ -0,0 +1,17 @@ +__all__ = [ + 'alias', 'bdist_egg', 'bdist_rpm', 'build_ext', 'build_py', 'develop', + 'easy_install', 'egg_info', 'install', 'install_lib', 'rotate', 'saveopts', + 'sdist', 'setopt', 'test', 'install_egg_info', 'install_scripts', + 'bdist_wininst', 'upload_docs', 'build_clib', 'dist_info', +] + +from distutils.command.bdist import bdist +import sys + +from setuptools.command import install_scripts + +if 'egg' not in bdist.format_commands: + bdist.format_command['egg'] = ('bdist_egg', "Python .egg file") + bdist.format_commands.append('egg') + +del bdist, sys diff --git a/venv/lib/python3.8/site-packages/setuptools/command/alias.py b/venv/lib/python3.8/site-packages/setuptools/command/alias.py new file mode 100644 index 000000000..4532b1cc0 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/command/alias.py @@ -0,0 +1,80 @@ +from distutils.errors import DistutilsOptionError + +from setuptools.extern.six.moves import map + +from setuptools.command.setopt import edit_config, option_base, config_file + + +def shquote(arg): + """Quote an argument for later parsing by shlex.split()""" + for c in '"', "'", "\\", "#": + if c in arg: + return repr(arg) + if arg.split() != [arg]: + return repr(arg) + return arg + + +class alias(option_base): + """Define a shortcut that invokes one or more commands""" + + description = "define a shortcut to invoke one or more commands" + command_consumes_arguments = True + + user_options = [ + ('remove', 'r', 'remove (unset) the alias'), + ] + option_base.user_options + + boolean_options = option_base.boolean_options + ['remove'] + + def initialize_options(self): + option_base.initialize_options(self) + self.args = None + self.remove = None + + def finalize_options(self): + option_base.finalize_options(self) + if self.remove and len(self.args) != 1: + raise DistutilsOptionError( + "Must specify exactly one argument (the alias name) when " + "using --remove" + ) + + def run(self): + aliases = self.distribution.get_option_dict('aliases') + + if not self.args: + print("Command Aliases") + print("---------------") + for alias in aliases: + print("setup.py alias", format_alias(alias, aliases)) + return + + elif len(self.args) == 1: + alias, = self.args + if self.remove: + command = None + elif alias in aliases: + print("setup.py alias", format_alias(alias, aliases)) + return + else: + print("No alias definition found for %r" % alias) + return + else: + alias = self.args[0] + command = ' '.join(map(shquote, self.args[1:])) + + edit_config(self.filename, {'aliases': {alias: command}}, self.dry_run) + + +def format_alias(name, aliases): + source, command = aliases[name] + if source == config_file('global'): + source = '--global-config ' + elif source == config_file('user'): + source = '--user-config ' + elif source == config_file('local'): + source = '' + else: + source = '--filename=%r' % source + return source + name + ' ' + command diff --git a/venv/lib/python3.8/site-packages/setuptools/command/bdist_egg.py b/venv/lib/python3.8/site-packages/setuptools/command/bdist_egg.py new file mode 100644 index 000000000..98470f171 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/command/bdist_egg.py @@ -0,0 +1,502 @@ +"""setuptools.command.bdist_egg + +Build .egg distributions""" + +from distutils.errors import DistutilsSetupError +from distutils.dir_util import remove_tree, mkpath +from distutils import log +from types import CodeType +import sys +import os +import re +import textwrap +import marshal + +from setuptools.extern import six + +from pkg_resources import get_build_platform, Distribution, ensure_directory +from pkg_resources import EntryPoint +from setuptools.extension import Library +from setuptools import Command + +try: + # Python 2.7 or >=3.2 + from sysconfig import get_path, get_python_version + + def _get_purelib(): + return get_path("purelib") +except ImportError: + from distutils.sysconfig import get_python_lib, get_python_version + + def _get_purelib(): + return get_python_lib(False) + + +def strip_module(filename): + if '.' in filename: + filename = os.path.splitext(filename)[0] + if filename.endswith('module'): + filename = filename[:-6] + return filename + + +def sorted_walk(dir): + """Do os.walk in a reproducible way, + independent of indeterministic filesystem readdir order + """ + for base, dirs, files in os.walk(dir): + dirs.sort() + files.sort() + yield base, dirs, files + + +def write_stub(resource, pyfile): + _stub_template = textwrap.dedent(""" + def __bootstrap__(): + global __bootstrap__, __loader__, __file__ + import sys, pkg_resources, imp + __file__ = pkg_resources.resource_filename(__name__, %r) + __loader__ = None; del __bootstrap__, __loader__ + imp.load_dynamic(__name__,__file__) + __bootstrap__() + """).lstrip() + with open(pyfile, 'w') as f: + f.write(_stub_template % resource) + + +class bdist_egg(Command): + description = "create an \"egg\" distribution" + + user_options = [ + ('bdist-dir=', 'b', + "temporary directory for creating the distribution"), + ('plat-name=', 'p', "platform name to embed in generated filenames " + "(default: %s)" % get_build_platform()), + ('exclude-source-files', None, + "remove all .py files from the generated egg"), + ('keep-temp', 'k', + "keep the pseudo-installation tree around after " + + "creating the distribution archive"), + ('dist-dir=', 'd', + "directory to put final built distributions in"), + ('skip-build', None, + "skip rebuilding everything (for testing/debugging)"), + ] + + boolean_options = [ + 'keep-temp', 'skip-build', 'exclude-source-files' + ] + + def initialize_options(self): + self.bdist_dir = None + self.plat_name = None + self.keep_temp = 0 + self.dist_dir = None + self.skip_build = 0 + self.egg_output = None + self.exclude_source_files = None + + def finalize_options(self): + ei_cmd = self.ei_cmd = self.get_finalized_command("egg_info") + self.egg_info = ei_cmd.egg_info + + if self.bdist_dir is None: + bdist_base = self.get_finalized_command('bdist').bdist_base + self.bdist_dir = os.path.join(bdist_base, 'egg') + + if self.plat_name is None: + self.plat_name = get_build_platform() + + self.set_undefined_options('bdist', ('dist_dir', 'dist_dir')) + + if self.egg_output is None: + + # Compute filename of the output egg + basename = Distribution( + None, None, ei_cmd.egg_name, ei_cmd.egg_version, + get_python_version(), + self.distribution.has_ext_modules() and self.plat_name + ).egg_name() + + self.egg_output = os.path.join(self.dist_dir, basename + '.egg') + + def do_install_data(self): + # Hack for packages that install data to install's --install-lib + self.get_finalized_command('install').install_lib = self.bdist_dir + + site_packages = os.path.normcase(os.path.realpath(_get_purelib())) + old, self.distribution.data_files = self.distribution.data_files, [] + + for item in old: + if isinstance(item, tuple) and len(item) == 2: + if os.path.isabs(item[0]): + realpath = os.path.realpath(item[0]) + normalized = os.path.normcase(realpath) + if normalized == site_packages or normalized.startswith( + site_packages + os.sep + ): + item = realpath[len(site_packages) + 1:], item[1] + # XXX else: raise ??? + self.distribution.data_files.append(item) + + try: + log.info("installing package data to %s", self.bdist_dir) + self.call_command('install_data', force=0, root=None) + finally: + self.distribution.data_files = old + + def get_outputs(self): + return [self.egg_output] + + def call_command(self, cmdname, **kw): + """Invoke reinitialized command `cmdname` with keyword args""" + for dirname in INSTALL_DIRECTORY_ATTRS: + kw.setdefault(dirname, self.bdist_dir) + kw.setdefault('skip_build', self.skip_build) + kw.setdefault('dry_run', self.dry_run) + cmd = self.reinitialize_command(cmdname, **kw) + self.run_command(cmdname) + return cmd + + def run(self): + # Generate metadata first + self.run_command("egg_info") + # We run install_lib before install_data, because some data hacks + # pull their data path from the install_lib command. + log.info("installing library code to %s", self.bdist_dir) + instcmd = self.get_finalized_command('install') + old_root = instcmd.root + instcmd.root = None + if self.distribution.has_c_libraries() and not self.skip_build: + self.run_command('build_clib') + cmd = self.call_command('install_lib', warn_dir=0) + instcmd.root = old_root + + all_outputs, ext_outputs = self.get_ext_outputs() + self.stubs = [] + to_compile = [] + for (p, ext_name) in enumerate(ext_outputs): + filename, ext = os.path.splitext(ext_name) + pyfile = os.path.join(self.bdist_dir, strip_module(filename) + + '.py') + self.stubs.append(pyfile) + log.info("creating stub loader for %s", ext_name) + if not self.dry_run: + write_stub(os.path.basename(ext_name), pyfile) + to_compile.append(pyfile) + ext_outputs[p] = ext_name.replace(os.sep, '/') + + if to_compile: + cmd.byte_compile(to_compile) + if self.distribution.data_files: + self.do_install_data() + + # Make the EGG-INFO directory + archive_root = self.bdist_dir + egg_info = os.path.join(archive_root, 'EGG-INFO') + self.mkpath(egg_info) + if self.distribution.scripts: + script_dir = os.path.join(egg_info, 'scripts') + log.info("installing scripts to %s", script_dir) + self.call_command('install_scripts', install_dir=script_dir, + no_ep=1) + + self.copy_metadata_to(egg_info) + native_libs = os.path.join(egg_info, "native_libs.txt") + if all_outputs: + log.info("writing %s", native_libs) + if not self.dry_run: + ensure_directory(native_libs) + libs_file = open(native_libs, 'wt') + libs_file.write('\n'.join(all_outputs)) + libs_file.write('\n') + libs_file.close() + elif os.path.isfile(native_libs): + log.info("removing %s", native_libs) + if not self.dry_run: + os.unlink(native_libs) + + write_safety_flag( + os.path.join(archive_root, 'EGG-INFO'), self.zip_safe() + ) + + if os.path.exists(os.path.join(self.egg_info, 'depends.txt')): + log.warn( + "WARNING: 'depends.txt' will not be used by setuptools 0.6!\n" + "Use the install_requires/extras_require setup() args instead." + ) + + if self.exclude_source_files: + self.zap_pyfiles() + + # Make the archive + make_zipfile(self.egg_output, archive_root, verbose=self.verbose, + dry_run=self.dry_run, mode=self.gen_header()) + if not self.keep_temp: + remove_tree(self.bdist_dir, dry_run=self.dry_run) + + # Add to 'Distribution.dist_files' so that the "upload" command works + getattr(self.distribution, 'dist_files', []).append( + ('bdist_egg', get_python_version(), self.egg_output)) + + def zap_pyfiles(self): + log.info("Removing .py files from temporary directory") + for base, dirs, files in walk_egg(self.bdist_dir): + for name in files: + path = os.path.join(base, name) + + if name.endswith('.py'): + log.debug("Deleting %s", path) + os.unlink(path) + + if base.endswith('__pycache__'): + path_old = path + + pattern = r'(?P.+)\.(?P[^.]+)\.pyc' + m = re.match(pattern, name) + path_new = os.path.join( + base, os.pardir, m.group('name') + '.pyc') + log.info( + "Renaming file from [%s] to [%s]" + % (path_old, path_new)) + try: + os.remove(path_new) + except OSError: + pass + os.rename(path_old, path_new) + + def zip_safe(self): + safe = getattr(self.distribution, 'zip_safe', None) + if safe is not None: + return safe + log.warn("zip_safe flag not set; analyzing archive contents...") + return analyze_egg(self.bdist_dir, self.stubs) + + def gen_header(self): + epm = EntryPoint.parse_map(self.distribution.entry_points or '') + ep = epm.get('setuptools.installation', {}).get('eggsecutable') + if ep is None: + return 'w' # not an eggsecutable, do it the usual way. + + if not ep.attrs or ep.extras: + raise DistutilsSetupError( + "eggsecutable entry point (%r) cannot have 'extras' " + "or refer to a module" % (ep,) + ) + + pyver = '{}.{}'.format(*sys.version_info) + pkg = ep.module_name + full = '.'.join(ep.attrs) + base = ep.attrs[0] + basename = os.path.basename(self.egg_output) + + header = ( + "#!/bin/sh\n" + 'if [ `basename $0` = "%(basename)s" ]\n' + 'then exec python%(pyver)s -c "' + "import sys, os; sys.path.insert(0, os.path.abspath('$0')); " + "from %(pkg)s import %(base)s; sys.exit(%(full)s())" + '" "$@"\n' + 'else\n' + ' echo $0 is not the correct name for this egg file.\n' + ' echo Please rename it back to %(basename)s and try again.\n' + ' exec false\n' + 'fi\n' + ) % locals() + + if not self.dry_run: + mkpath(os.path.dirname(self.egg_output), dry_run=self.dry_run) + f = open(self.egg_output, 'w') + f.write(header) + f.close() + return 'a' + + def copy_metadata_to(self, target_dir): + "Copy metadata (egg info) to the target_dir" + # normalize the path (so that a forward-slash in egg_info will + # match using startswith below) + norm_egg_info = os.path.normpath(self.egg_info) + prefix = os.path.join(norm_egg_info, '') + for path in self.ei_cmd.filelist.files: + if path.startswith(prefix): + target = os.path.join(target_dir, path[len(prefix):]) + ensure_directory(target) + self.copy_file(path, target) + + def get_ext_outputs(self): + """Get a list of relative paths to C extensions in the output distro""" + + all_outputs = [] + ext_outputs = [] + + paths = {self.bdist_dir: ''} + for base, dirs, files in sorted_walk(self.bdist_dir): + for filename in files: + if os.path.splitext(filename)[1].lower() in NATIVE_EXTENSIONS: + all_outputs.append(paths[base] + filename) + for filename in dirs: + paths[os.path.join(base, filename)] = (paths[base] + + filename + '/') + + if self.distribution.has_ext_modules(): + build_cmd = self.get_finalized_command('build_ext') + for ext in build_cmd.extensions: + if isinstance(ext, Library): + continue + fullname = build_cmd.get_ext_fullname(ext.name) + filename = build_cmd.get_ext_filename(fullname) + if not os.path.basename(filename).startswith('dl-'): + if os.path.exists(os.path.join(self.bdist_dir, filename)): + ext_outputs.append(filename) + + return all_outputs, ext_outputs + + +NATIVE_EXTENSIONS = dict.fromkeys('.dll .so .dylib .pyd'.split()) + + +def walk_egg(egg_dir): + """Walk an unpacked egg's contents, skipping the metadata directory""" + walker = sorted_walk(egg_dir) + base, dirs, files = next(walker) + if 'EGG-INFO' in dirs: + dirs.remove('EGG-INFO') + yield base, dirs, files + for bdf in walker: + yield bdf + + +def analyze_egg(egg_dir, stubs): + # check for existing flag in EGG-INFO + for flag, fn in safety_flags.items(): + if os.path.exists(os.path.join(egg_dir, 'EGG-INFO', fn)): + return flag + if not can_scan(): + return False + safe = True + for base, dirs, files in walk_egg(egg_dir): + for name in files: + if name.endswith('.py') or name.endswith('.pyw'): + continue + elif name.endswith('.pyc') or name.endswith('.pyo'): + # always scan, even if we already know we're not safe + safe = scan_module(egg_dir, base, name, stubs) and safe + return safe + + +def write_safety_flag(egg_dir, safe): + # Write or remove zip safety flag file(s) + for flag, fn in safety_flags.items(): + fn = os.path.join(egg_dir, fn) + if os.path.exists(fn): + if safe is None or bool(safe) != flag: + os.unlink(fn) + elif safe is not None and bool(safe) == flag: + f = open(fn, 'wt') + f.write('\n') + f.close() + + +safety_flags = { + True: 'zip-safe', + False: 'not-zip-safe', +} + + +def scan_module(egg_dir, base, name, stubs): + """Check whether module possibly uses unsafe-for-zipfile stuff""" + + filename = os.path.join(base, name) + if filename[:-1] in stubs: + return True # Extension module + pkg = base[len(egg_dir) + 1:].replace(os.sep, '.') + module = pkg + (pkg and '.' or '') + os.path.splitext(name)[0] + if six.PY2: + skip = 8 # skip magic & date + elif sys.version_info < (3, 7): + skip = 12 # skip magic & date & file size + else: + skip = 16 # skip magic & reserved? & date & file size + f = open(filename, 'rb') + f.read(skip) + code = marshal.load(f) + f.close() + safe = True + symbols = dict.fromkeys(iter_symbols(code)) + for bad in ['__file__', '__path__']: + if bad in symbols: + log.warn("%s: module references %s", module, bad) + safe = False + if 'inspect' in symbols: + for bad in [ + 'getsource', 'getabsfile', 'getsourcefile', 'getfile' + 'getsourcelines', 'findsource', 'getcomments', 'getframeinfo', + 'getinnerframes', 'getouterframes', 'stack', 'trace' + ]: + if bad in symbols: + log.warn("%s: module MAY be using inspect.%s", module, bad) + safe = False + return safe + + +def iter_symbols(code): + """Yield names and strings used by `code` and its nested code objects""" + for name in code.co_names: + yield name + for const in code.co_consts: + if isinstance(const, six.string_types): + yield const + elif isinstance(const, CodeType): + for name in iter_symbols(const): + yield name + + +def can_scan(): + if not sys.platform.startswith('java') and sys.platform != 'cli': + # CPython, PyPy, etc. + return True + log.warn("Unable to analyze compiled code on this platform.") + log.warn("Please ask the author to include a 'zip_safe'" + " setting (either True or False) in the package's setup.py") + + +# Attribute names of options for commands that might need to be convinced to +# install to the egg build directory + +INSTALL_DIRECTORY_ATTRS = [ + 'install_lib', 'install_dir', 'install_data', 'install_base' +] + + +def make_zipfile(zip_filename, base_dir, verbose=0, dry_run=0, compress=True, + mode='w'): + """Create a zip file from all the files under 'base_dir'. The output + zip file will be named 'base_dir' + ".zip". Uses either the "zipfile" + Python module (if available) or the InfoZIP "zip" utility (if installed + and found on the default search path). If neither tool is available, + raises DistutilsExecError. Returns the name of the output zip file. + """ + import zipfile + + mkpath(os.path.dirname(zip_filename), dry_run=dry_run) + log.info("creating '%s' and adding '%s' to it", zip_filename, base_dir) + + def visit(z, dirname, names): + for name in names: + path = os.path.normpath(os.path.join(dirname, name)) + if os.path.isfile(path): + p = path[len(base_dir) + 1:] + if not dry_run: + z.write(path, p) + log.debug("adding '%s'", p) + + compression = zipfile.ZIP_DEFLATED if compress else zipfile.ZIP_STORED + if not dry_run: + z = zipfile.ZipFile(zip_filename, mode, compression=compression) + for dirname, dirs, files in sorted_walk(base_dir): + visit(z, dirname, files) + z.close() + else: + for dirname, dirs, files in sorted_walk(base_dir): + visit(None, dirname, files) + return zip_filename diff --git a/venv/lib/python3.8/site-packages/setuptools/command/bdist_rpm.py b/venv/lib/python3.8/site-packages/setuptools/command/bdist_rpm.py new file mode 100644 index 000000000..70730927e --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/command/bdist_rpm.py @@ -0,0 +1,43 @@ +import distutils.command.bdist_rpm as orig + + +class bdist_rpm(orig.bdist_rpm): + """ + Override the default bdist_rpm behavior to do the following: + + 1. Run egg_info to ensure the name and version are properly calculated. + 2. Always run 'install' using --single-version-externally-managed to + disable eggs in RPM distributions. + 3. Replace dash with underscore in the version numbers for better RPM + compatibility. + """ + + def run(self): + # ensure distro name is up-to-date + self.run_command('egg_info') + + orig.bdist_rpm.run(self) + + def _make_spec_file(self): + version = self.distribution.get_version() + rpmversion = version.replace('-', '_') + spec = orig.bdist_rpm._make_spec_file(self) + line23 = '%define version ' + version + line24 = '%define version ' + rpmversion + spec = [ + line.replace( + "Source0: %{name}-%{version}.tar", + "Source0: %{name}-%{unmangled_version}.tar" + ).replace( + "setup.py install ", + "setup.py install --single-version-externally-managed " + ).replace( + "%setup", + "%setup -n %{name}-%{unmangled_version}" + ).replace(line23, line24) + for line in spec + ] + insert_loc = spec.index(line24) + 1 + unmangled_version = "%define unmangled_version " + version + spec.insert(insert_loc, unmangled_version) + return spec diff --git a/venv/lib/python3.8/site-packages/setuptools/command/bdist_wininst.py b/venv/lib/python3.8/site-packages/setuptools/command/bdist_wininst.py new file mode 100644 index 000000000..073de97b4 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/command/bdist_wininst.py @@ -0,0 +1,21 @@ +import distutils.command.bdist_wininst as orig + + +class bdist_wininst(orig.bdist_wininst): + def reinitialize_command(self, command, reinit_subcommands=0): + """ + Supplement reinitialize_command to work around + http://bugs.python.org/issue20819 + """ + cmd = self.distribution.reinitialize_command( + command, reinit_subcommands) + if command in ('install', 'install_lib'): + cmd.install_lib = None + return cmd + + def run(self): + self._is_running = True + try: + orig.bdist_wininst.run(self) + finally: + self._is_running = False diff --git a/venv/lib/python3.8/site-packages/setuptools/command/build_clib.py b/venv/lib/python3.8/site-packages/setuptools/command/build_clib.py new file mode 100644 index 000000000..09caff6ff --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/command/build_clib.py @@ -0,0 +1,98 @@ +import distutils.command.build_clib as orig +from distutils.errors import DistutilsSetupError +from distutils import log +from setuptools.dep_util import newer_pairwise_group + + +class build_clib(orig.build_clib): + """ + Override the default build_clib behaviour to do the following: + + 1. Implement a rudimentary timestamp-based dependency system + so 'compile()' doesn't run every time. + 2. Add more keys to the 'build_info' dictionary: + * obj_deps - specify dependencies for each object compiled. + this should be a dictionary mapping a key + with the source filename to a list of + dependencies. Use an empty string for global + dependencies. + * cflags - specify a list of additional flags to pass to + the compiler. + """ + + def build_libraries(self, libraries): + for (lib_name, build_info) in libraries: + sources = build_info.get('sources') + if sources is None or not isinstance(sources, (list, tuple)): + raise DistutilsSetupError( + "in 'libraries' option (library '%s'), " + "'sources' must be present and must be " + "a list of source filenames" % lib_name) + sources = list(sources) + + log.info("building '%s' library", lib_name) + + # Make sure everything is the correct type. + # obj_deps should be a dictionary of keys as sources + # and a list/tuple of files that are its dependencies. + obj_deps = build_info.get('obj_deps', dict()) + if not isinstance(obj_deps, dict): + raise DistutilsSetupError( + "in 'libraries' option (library '%s'), " + "'obj_deps' must be a dictionary of " + "type 'source: list'" % lib_name) + dependencies = [] + + # Get the global dependencies that are specified by the '' key. + # These will go into every source's dependency list. + global_deps = obj_deps.get('', list()) + if not isinstance(global_deps, (list, tuple)): + raise DistutilsSetupError( + "in 'libraries' option (library '%s'), " + "'obj_deps' must be a dictionary of " + "type 'source: list'" % lib_name) + + # Build the list to be used by newer_pairwise_group + # each source will be auto-added to its dependencies. + for source in sources: + src_deps = [source] + src_deps.extend(global_deps) + extra_deps = obj_deps.get(source, list()) + if not isinstance(extra_deps, (list, tuple)): + raise DistutilsSetupError( + "in 'libraries' option (library '%s'), " + "'obj_deps' must be a dictionary of " + "type 'source: list'" % lib_name) + src_deps.extend(extra_deps) + dependencies.append(src_deps) + + expected_objects = self.compiler.object_filenames( + sources, + output_dir=self.build_temp + ) + + if newer_pairwise_group(dependencies, expected_objects) != ([], []): + # First, compile the source code to object files in the library + # directory. (This should probably change to putting object + # files in a temporary build directory.) + macros = build_info.get('macros') + include_dirs = build_info.get('include_dirs') + cflags = build_info.get('cflags') + objects = self.compiler.compile( + sources, + output_dir=self.build_temp, + macros=macros, + include_dirs=include_dirs, + extra_postargs=cflags, + debug=self.debug + ) + + # Now "link" the object files together into a static library. + # (On Unix at least, this isn't really linking -- it just + # builds an archive. Whatever.) + self.compiler.create_static_lib( + expected_objects, + lib_name, + output_dir=self.build_clib, + debug=self.debug + ) diff --git a/venv/lib/python3.8/site-packages/setuptools/command/build_ext.py b/venv/lib/python3.8/site-packages/setuptools/command/build_ext.py new file mode 100644 index 000000000..daa8e4fe8 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/command/build_ext.py @@ -0,0 +1,327 @@ +import os +import sys +import itertools +from distutils.command.build_ext import build_ext as _du_build_ext +from distutils.file_util import copy_file +from distutils.ccompiler import new_compiler +from distutils.sysconfig import customize_compiler, get_config_var +from distutils.errors import DistutilsError +from distutils import log + +from setuptools.extension import Library +from setuptools.extern import six + +if six.PY2: + import imp + + EXTENSION_SUFFIXES = [s for s, _, tp in imp.get_suffixes() if tp == imp.C_EXTENSION] +else: + from importlib.machinery import EXTENSION_SUFFIXES + +try: + # Attempt to use Cython for building extensions, if available + from Cython.Distutils.build_ext import build_ext as _build_ext + # Additionally, assert that the compiler module will load + # also. Ref #1229. + __import__('Cython.Compiler.Main') +except ImportError: + _build_ext = _du_build_ext + +# make sure _config_vars is initialized +get_config_var("LDSHARED") +from distutils.sysconfig import _config_vars as _CONFIG_VARS + + +def _customize_compiler_for_shlib(compiler): + if sys.platform == "darwin": + # building .dylib requires additional compiler flags on OSX; here we + # temporarily substitute the pyconfig.h variables so that distutils' + # 'customize_compiler' uses them before we build the shared libraries. + tmp = _CONFIG_VARS.copy() + try: + # XXX Help! I don't have any idea whether these are right... + _CONFIG_VARS['LDSHARED'] = ( + "gcc -Wl,-x -dynamiclib -undefined dynamic_lookup") + _CONFIG_VARS['CCSHARED'] = " -dynamiclib" + _CONFIG_VARS['SO'] = ".dylib" + customize_compiler(compiler) + finally: + _CONFIG_VARS.clear() + _CONFIG_VARS.update(tmp) + else: + customize_compiler(compiler) + + +have_rtld = False +use_stubs = False +libtype = 'shared' + +if sys.platform == "darwin": + use_stubs = True +elif os.name != 'nt': + try: + import dl + use_stubs = have_rtld = hasattr(dl, 'RTLD_NOW') + except ImportError: + pass + +if_dl = lambda s: s if have_rtld else '' + + +def get_abi3_suffix(): + """Return the file extension for an abi3-compliant Extension()""" + for suffix in EXTENSION_SUFFIXES: + if '.abi3' in suffix: # Unix + return suffix + elif suffix == '.pyd': # Windows + return suffix + + +class build_ext(_build_ext): + def run(self): + """Build extensions in build directory, then copy if --inplace""" + old_inplace, self.inplace = self.inplace, 0 + _build_ext.run(self) + self.inplace = old_inplace + if old_inplace: + self.copy_extensions_to_source() + + def copy_extensions_to_source(self): + build_py = self.get_finalized_command('build_py') + for ext in self.extensions: + fullname = self.get_ext_fullname(ext.name) + filename = self.get_ext_filename(fullname) + modpath = fullname.split('.') + package = '.'.join(modpath[:-1]) + package_dir = build_py.get_package_dir(package) + dest_filename = os.path.join(package_dir, + os.path.basename(filename)) + src_filename = os.path.join(self.build_lib, filename) + + # Always copy, even if source is older than destination, to ensure + # that the right extensions for the current Python/platform are + # used. + copy_file( + src_filename, dest_filename, verbose=self.verbose, + dry_run=self.dry_run + ) + if ext._needs_stub: + self.write_stub(package_dir or os.curdir, ext, True) + + def get_ext_filename(self, fullname): + filename = _build_ext.get_ext_filename(self, fullname) + if fullname in self.ext_map: + ext = self.ext_map[fullname] + use_abi3 = ( + six.PY3 + and getattr(ext, 'py_limited_api') + and get_abi3_suffix() + ) + if use_abi3: + so_ext = get_config_var('EXT_SUFFIX') + filename = filename[:-len(so_ext)] + filename = filename + get_abi3_suffix() + if isinstance(ext, Library): + fn, ext = os.path.splitext(filename) + return self.shlib_compiler.library_filename(fn, libtype) + elif use_stubs and ext._links_to_dynamic: + d, fn = os.path.split(filename) + return os.path.join(d, 'dl-' + fn) + return filename + + def initialize_options(self): + _build_ext.initialize_options(self) + self.shlib_compiler = None + self.shlibs = [] + self.ext_map = {} + + def finalize_options(self): + _build_ext.finalize_options(self) + self.extensions = self.extensions or [] + self.check_extensions_list(self.extensions) + self.shlibs = [ext for ext in self.extensions + if isinstance(ext, Library)] + if self.shlibs: + self.setup_shlib_compiler() + for ext in self.extensions: + ext._full_name = self.get_ext_fullname(ext.name) + for ext in self.extensions: + fullname = ext._full_name + self.ext_map[fullname] = ext + + # distutils 3.1 will also ask for module names + # XXX what to do with conflicts? + self.ext_map[fullname.split('.')[-1]] = ext + + ltd = self.shlibs and self.links_to_dynamic(ext) or False + ns = ltd and use_stubs and not isinstance(ext, Library) + ext._links_to_dynamic = ltd + ext._needs_stub = ns + filename = ext._file_name = self.get_ext_filename(fullname) + libdir = os.path.dirname(os.path.join(self.build_lib, filename)) + if ltd and libdir not in ext.library_dirs: + ext.library_dirs.append(libdir) + if ltd and use_stubs and os.curdir not in ext.runtime_library_dirs: + ext.runtime_library_dirs.append(os.curdir) + + def setup_shlib_compiler(self): + compiler = self.shlib_compiler = new_compiler( + compiler=self.compiler, dry_run=self.dry_run, force=self.force + ) + _customize_compiler_for_shlib(compiler) + + if self.include_dirs is not None: + compiler.set_include_dirs(self.include_dirs) + if self.define is not None: + # 'define' option is a list of (name,value) tuples + for (name, value) in self.define: + compiler.define_macro(name, value) + if self.undef is not None: + for macro in self.undef: + compiler.undefine_macro(macro) + if self.libraries is not None: + compiler.set_libraries(self.libraries) + if self.library_dirs is not None: + compiler.set_library_dirs(self.library_dirs) + if self.rpath is not None: + compiler.set_runtime_library_dirs(self.rpath) + if self.link_objects is not None: + compiler.set_link_objects(self.link_objects) + + # hack so distutils' build_extension() builds a library instead + compiler.link_shared_object = link_shared_object.__get__(compiler) + + def get_export_symbols(self, ext): + if isinstance(ext, Library): + return ext.export_symbols + return _build_ext.get_export_symbols(self, ext) + + def build_extension(self, ext): + ext._convert_pyx_sources_to_lang() + _compiler = self.compiler + try: + if isinstance(ext, Library): + self.compiler = self.shlib_compiler + _build_ext.build_extension(self, ext) + if ext._needs_stub: + cmd = self.get_finalized_command('build_py').build_lib + self.write_stub(cmd, ext) + finally: + self.compiler = _compiler + + def links_to_dynamic(self, ext): + """Return true if 'ext' links to a dynamic lib in the same package""" + # XXX this should check to ensure the lib is actually being built + # XXX as dynamic, and not just using a locally-found version or a + # XXX static-compiled version + libnames = dict.fromkeys([lib._full_name for lib in self.shlibs]) + pkg = '.'.join(ext._full_name.split('.')[:-1] + ['']) + return any(pkg + libname in libnames for libname in ext.libraries) + + def get_outputs(self): + return _build_ext.get_outputs(self) + self.__get_stubs_outputs() + + def __get_stubs_outputs(self): + # assemble the base name for each extension that needs a stub + ns_ext_bases = ( + os.path.join(self.build_lib, *ext._full_name.split('.')) + for ext in self.extensions + if ext._needs_stub + ) + # pair each base with the extension + pairs = itertools.product(ns_ext_bases, self.__get_output_extensions()) + return list(base + fnext for base, fnext in pairs) + + def __get_output_extensions(self): + yield '.py' + yield '.pyc' + if self.get_finalized_command('build_py').optimize: + yield '.pyo' + + def write_stub(self, output_dir, ext, compile=False): + log.info("writing stub loader for %s to %s", ext._full_name, + output_dir) + stub_file = (os.path.join(output_dir, *ext._full_name.split('.')) + + '.py') + if compile and os.path.exists(stub_file): + raise DistutilsError(stub_file + " already exists! Please delete.") + if not self.dry_run: + f = open(stub_file, 'w') + f.write( + '\n'.join([ + "def __bootstrap__():", + " global __bootstrap__, __file__, __loader__", + " import sys, os, pkg_resources, imp" + if_dl(", dl"), + " __file__ = pkg_resources.resource_filename" + "(__name__,%r)" + % os.path.basename(ext._file_name), + " del __bootstrap__", + " if '__loader__' in globals():", + " del __loader__", + if_dl(" old_flags = sys.getdlopenflags()"), + " old_dir = os.getcwd()", + " try:", + " os.chdir(os.path.dirname(__file__))", + if_dl(" sys.setdlopenflags(dl.RTLD_NOW)"), + " imp.load_dynamic(__name__,__file__)", + " finally:", + if_dl(" sys.setdlopenflags(old_flags)"), + " os.chdir(old_dir)", + "__bootstrap__()", + "" # terminal \n + ]) + ) + f.close() + if compile: + from distutils.util import byte_compile + + byte_compile([stub_file], optimize=0, + force=True, dry_run=self.dry_run) + optimize = self.get_finalized_command('install_lib').optimize + if optimize > 0: + byte_compile([stub_file], optimize=optimize, + force=True, dry_run=self.dry_run) + if os.path.exists(stub_file) and not self.dry_run: + os.unlink(stub_file) + + +if use_stubs or os.name == 'nt': + # Build shared libraries + # + def link_shared_object( + self, objects, output_libname, output_dir=None, libraries=None, + library_dirs=None, runtime_library_dirs=None, export_symbols=None, + debug=0, extra_preargs=None, extra_postargs=None, build_temp=None, + target_lang=None): + self.link( + self.SHARED_LIBRARY, objects, output_libname, + output_dir, libraries, library_dirs, runtime_library_dirs, + export_symbols, debug, extra_preargs, extra_postargs, + build_temp, target_lang + ) +else: + # Build static libraries everywhere else + libtype = 'static' + + def link_shared_object( + self, objects, output_libname, output_dir=None, libraries=None, + library_dirs=None, runtime_library_dirs=None, export_symbols=None, + debug=0, extra_preargs=None, extra_postargs=None, build_temp=None, + target_lang=None): + # XXX we need to either disallow these attrs on Library instances, + # or warn/abort here if set, or something... + # libraries=None, library_dirs=None, runtime_library_dirs=None, + # export_symbols=None, extra_preargs=None, extra_postargs=None, + # build_temp=None + + assert output_dir is None # distutils build_ext doesn't pass this + output_dir, filename = os.path.split(output_libname) + basename, ext = os.path.splitext(filename) + if self.library_filename("x").startswith('lib'): + # strip 'lib' prefix; this is kludgy if some platform uses + # a different prefix + basename = basename[3:] + + self.create_static_lib( + objects, basename, output_dir, debug, target_lang + ) diff --git a/venv/lib/python3.8/site-packages/setuptools/command/build_py.py b/venv/lib/python3.8/site-packages/setuptools/command/build_py.py new file mode 100644 index 000000000..b0314fd41 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/command/build_py.py @@ -0,0 +1,270 @@ +from glob import glob +from distutils.util import convert_path +import distutils.command.build_py as orig +import os +import fnmatch +import textwrap +import io +import distutils.errors +import itertools + +from setuptools.extern import six +from setuptools.extern.six.moves import map, filter, filterfalse + +try: + from setuptools.lib2to3_ex import Mixin2to3 +except ImportError: + + class Mixin2to3: + def run_2to3(self, files, doctests=True): + "do nothing" + + +class build_py(orig.build_py, Mixin2to3): + """Enhanced 'build_py' command that includes data files with packages + + The data files are specified via a 'package_data' argument to 'setup()'. + See 'setuptools.dist.Distribution' for more details. + + Also, this version of the 'build_py' command allows you to specify both + 'py_modules' and 'packages' in the same setup operation. + """ + + def finalize_options(self): + orig.build_py.finalize_options(self) + self.package_data = self.distribution.package_data + self.exclude_package_data = (self.distribution.exclude_package_data or + {}) + if 'data_files' in self.__dict__: + del self.__dict__['data_files'] + self.__updated_files = [] + self.__doctests_2to3 = [] + + def run(self): + """Build modules, packages, and copy data files to build directory""" + if not self.py_modules and not self.packages: + return + + if self.py_modules: + self.build_modules() + + if self.packages: + self.build_packages() + self.build_package_data() + + self.run_2to3(self.__updated_files, False) + self.run_2to3(self.__updated_files, True) + self.run_2to3(self.__doctests_2to3, True) + + # Only compile actual .py files, using our base class' idea of what our + # output files are. + self.byte_compile(orig.build_py.get_outputs(self, include_bytecode=0)) + + def __getattr__(self, attr): + "lazily compute data files" + if attr == 'data_files': + self.data_files = self._get_data_files() + return self.data_files + return orig.build_py.__getattr__(self, attr) + + def build_module(self, module, module_file, package): + if six.PY2 and isinstance(package, six.string_types): + # avoid errors on Python 2 when unicode is passed (#190) + package = package.split('.') + outfile, copied = orig.build_py.build_module(self, module, module_file, + package) + if copied: + self.__updated_files.append(outfile) + return outfile, copied + + def _get_data_files(self): + """Generate list of '(package,src_dir,build_dir,filenames)' tuples""" + self.analyze_manifest() + return list(map(self._get_pkg_data_files, self.packages or ())) + + def _get_pkg_data_files(self, package): + # Locate package source directory + src_dir = self.get_package_dir(package) + + # Compute package build directory + build_dir = os.path.join(*([self.build_lib] + package.split('.'))) + + # Strip directory from globbed filenames + filenames = [ + os.path.relpath(file, src_dir) + for file in self.find_data_files(package, src_dir) + ] + return package, src_dir, build_dir, filenames + + def find_data_files(self, package, src_dir): + """Return filenames for package's data files in 'src_dir'""" + patterns = self._get_platform_patterns( + self.package_data, + package, + src_dir, + ) + globs_expanded = map(glob, patterns) + # flatten the expanded globs into an iterable of matches + globs_matches = itertools.chain.from_iterable(globs_expanded) + glob_files = filter(os.path.isfile, globs_matches) + files = itertools.chain( + self.manifest_files.get(package, []), + glob_files, + ) + return self.exclude_data_files(package, src_dir, files) + + def build_package_data(self): + """Copy data files into build directory""" + for package, src_dir, build_dir, filenames in self.data_files: + for filename in filenames: + target = os.path.join(build_dir, filename) + self.mkpath(os.path.dirname(target)) + srcfile = os.path.join(src_dir, filename) + outf, copied = self.copy_file(srcfile, target) + srcfile = os.path.abspath(srcfile) + if (copied and + srcfile in self.distribution.convert_2to3_doctests): + self.__doctests_2to3.append(outf) + + def analyze_manifest(self): + self.manifest_files = mf = {} + if not self.distribution.include_package_data: + return + src_dirs = {} + for package in self.packages or (): + # Locate package source directory + src_dirs[assert_relative(self.get_package_dir(package))] = package + + self.run_command('egg_info') + ei_cmd = self.get_finalized_command('egg_info') + for path in ei_cmd.filelist.files: + d, f = os.path.split(assert_relative(path)) + prev = None + oldf = f + while d and d != prev and d not in src_dirs: + prev = d + d, df = os.path.split(d) + f = os.path.join(df, f) + if d in src_dirs: + if path.endswith('.py') and f == oldf: + continue # it's a module, not data + mf.setdefault(src_dirs[d], []).append(path) + + def get_data_files(self): + pass # Lazily compute data files in _get_data_files() function. + + def check_package(self, package, package_dir): + """Check namespace packages' __init__ for declare_namespace""" + try: + return self.packages_checked[package] + except KeyError: + pass + + init_py = orig.build_py.check_package(self, package, package_dir) + self.packages_checked[package] = init_py + + if not init_py or not self.distribution.namespace_packages: + return init_py + + for pkg in self.distribution.namespace_packages: + if pkg == package or pkg.startswith(package + '.'): + break + else: + return init_py + + with io.open(init_py, 'rb') as f: + contents = f.read() + if b'declare_namespace' not in contents: + raise distutils.errors.DistutilsError( + "Namespace package problem: %s is a namespace package, but " + "its\n__init__.py does not call declare_namespace()! Please " + 'fix it.\n(See the setuptools manual under ' + '"Namespace Packages" for details.)\n"' % (package,) + ) + return init_py + + def initialize_options(self): + self.packages_checked = {} + orig.build_py.initialize_options(self) + + def get_package_dir(self, package): + res = orig.build_py.get_package_dir(self, package) + if self.distribution.src_root is not None: + return os.path.join(self.distribution.src_root, res) + return res + + def exclude_data_files(self, package, src_dir, files): + """Filter filenames for package's data files in 'src_dir'""" + files = list(files) + patterns = self._get_platform_patterns( + self.exclude_package_data, + package, + src_dir, + ) + match_groups = ( + fnmatch.filter(files, pattern) + for pattern in patterns + ) + # flatten the groups of matches into an iterable of matches + matches = itertools.chain.from_iterable(match_groups) + bad = set(matches) + keepers = ( + fn + for fn in files + if fn not in bad + ) + # ditch dupes + return list(_unique_everseen(keepers)) + + @staticmethod + def _get_platform_patterns(spec, package, src_dir): + """ + yield platform-specific path patterns (suitable for glob + or fn_match) from a glob-based spec (such as + self.package_data or self.exclude_package_data) + matching package in src_dir. + """ + raw_patterns = itertools.chain( + spec.get('', []), + spec.get(package, []), + ) + return ( + # Each pattern has to be converted to a platform-specific path + os.path.join(src_dir, convert_path(pattern)) + for pattern in raw_patterns + ) + + +# from Python docs +def _unique_everseen(iterable, key=None): + "List unique elements, preserving order. Remember all elements ever seen." + # unique_everseen('AAAABBBCCDAABBB') --> A B C D + # unique_everseen('ABBCcAD', str.lower) --> A B C D + seen = set() + seen_add = seen.add + if key is None: + for element in filterfalse(seen.__contains__, iterable): + seen_add(element) + yield element + else: + for element in iterable: + k = key(element) + if k not in seen: + seen_add(k) + yield element + + +def assert_relative(path): + if not os.path.isabs(path): + return path + from distutils.errors import DistutilsSetupError + + msg = textwrap.dedent(""" + Error: setup script specifies an absolute path: + + %s + + setup() arguments must *always* be /-separated paths relative to the + setup.py directory, *never* absolute paths. + """).lstrip() % path + raise DistutilsSetupError(msg) diff --git a/venv/lib/python3.8/site-packages/setuptools/command/develop.py b/venv/lib/python3.8/site-packages/setuptools/command/develop.py new file mode 100644 index 000000000..009e4f936 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/command/develop.py @@ -0,0 +1,221 @@ +from distutils.util import convert_path +from distutils import log +from distutils.errors import DistutilsError, DistutilsOptionError +import os +import glob +import io + +from setuptools.extern import six + +import pkg_resources +from setuptools.command.easy_install import easy_install +from setuptools import namespaces +import setuptools + +__metaclass__ = type + + +class develop(namespaces.DevelopInstaller, easy_install): + """Set up package for development""" + + description = "install package in 'development mode'" + + user_options = easy_install.user_options + [ + ("uninstall", "u", "Uninstall this source package"), + ("egg-path=", None, "Set the path to be used in the .egg-link file"), + ] + + boolean_options = easy_install.boolean_options + ['uninstall'] + + command_consumes_arguments = False # override base + + def run(self): + if self.uninstall: + self.multi_version = True + self.uninstall_link() + self.uninstall_namespaces() + else: + self.install_for_development() + self.warn_deprecated_options() + + def initialize_options(self): + self.uninstall = None + self.egg_path = None + easy_install.initialize_options(self) + self.setup_path = None + self.always_copy_from = '.' # always copy eggs installed in curdir + + def finalize_options(self): + ei = self.get_finalized_command("egg_info") + if ei.broken_egg_info: + template = "Please rename %r to %r before using 'develop'" + args = ei.egg_info, ei.broken_egg_info + raise DistutilsError(template % args) + self.args = [ei.egg_name] + + easy_install.finalize_options(self) + self.expand_basedirs() + self.expand_dirs() + # pick up setup-dir .egg files only: no .egg-info + self.package_index.scan(glob.glob('*.egg')) + + egg_link_fn = ei.egg_name + '.egg-link' + self.egg_link = os.path.join(self.install_dir, egg_link_fn) + self.egg_base = ei.egg_base + if self.egg_path is None: + self.egg_path = os.path.abspath(ei.egg_base) + + target = pkg_resources.normalize_path(self.egg_base) + egg_path = pkg_resources.normalize_path( + os.path.join(self.install_dir, self.egg_path)) + if egg_path != target: + raise DistutilsOptionError( + "--egg-path must be a relative path from the install" + " directory to " + target + ) + + # Make a distribution for the package's source + self.dist = pkg_resources.Distribution( + target, + pkg_resources.PathMetadata(target, os.path.abspath(ei.egg_info)), + project_name=ei.egg_name + ) + + self.setup_path = self._resolve_setup_path( + self.egg_base, + self.install_dir, + self.egg_path, + ) + + @staticmethod + def _resolve_setup_path(egg_base, install_dir, egg_path): + """ + Generate a path from egg_base back to '.' where the + setup script resides and ensure that path points to the + setup path from $install_dir/$egg_path. + """ + path_to_setup = egg_base.replace(os.sep, '/').rstrip('/') + if path_to_setup != os.curdir: + path_to_setup = '../' * (path_to_setup.count('/') + 1) + resolved = pkg_resources.normalize_path( + os.path.join(install_dir, egg_path, path_to_setup) + ) + if resolved != pkg_resources.normalize_path(os.curdir): + raise DistutilsOptionError( + "Can't get a consistent path to setup script from" + " installation directory", resolved, + pkg_resources.normalize_path(os.curdir)) + return path_to_setup + + def install_for_development(self): + if six.PY3 and getattr(self.distribution, 'use_2to3', False): + # If we run 2to3 we can not do this inplace: + + # Ensure metadata is up-to-date + self.reinitialize_command('build_py', inplace=0) + self.run_command('build_py') + bpy_cmd = self.get_finalized_command("build_py") + build_path = pkg_resources.normalize_path(bpy_cmd.build_lib) + + # Build extensions + self.reinitialize_command('egg_info', egg_base=build_path) + self.run_command('egg_info') + + self.reinitialize_command('build_ext', inplace=0) + self.run_command('build_ext') + + # Fixup egg-link and easy-install.pth + ei_cmd = self.get_finalized_command("egg_info") + self.egg_path = build_path + self.dist.location = build_path + # XXX + self.dist._provider = pkg_resources.PathMetadata( + build_path, ei_cmd.egg_info) + else: + # Without 2to3 inplace works fine: + self.run_command('egg_info') + + # Build extensions in-place + self.reinitialize_command('build_ext', inplace=1) + self.run_command('build_ext') + + self.install_site_py() # ensure that target dir is site-safe + if setuptools.bootstrap_install_from: + self.easy_install(setuptools.bootstrap_install_from) + setuptools.bootstrap_install_from = None + + self.install_namespaces() + + # create an .egg-link in the installation dir, pointing to our egg + log.info("Creating %s (link to %s)", self.egg_link, self.egg_base) + if not self.dry_run: + with open(self.egg_link, "w") as f: + f.write(self.egg_path + "\n" + self.setup_path) + # postprocess the installed distro, fixing up .pth, installing scripts, + # and handling requirements + self.process_distribution(None, self.dist, not self.no_deps) + + def uninstall_link(self): + if os.path.exists(self.egg_link): + log.info("Removing %s (link to %s)", self.egg_link, self.egg_base) + egg_link_file = open(self.egg_link) + contents = [line.rstrip() for line in egg_link_file] + egg_link_file.close() + if contents not in ([self.egg_path], + [self.egg_path, self.setup_path]): + log.warn("Link points to %s: uninstall aborted", contents) + return + if not self.dry_run: + os.unlink(self.egg_link) + if not self.dry_run: + self.update_pth(self.dist) # remove any .pth link to us + if self.distribution.scripts: + # XXX should also check for entry point scripts! + log.warn("Note: you must uninstall or replace scripts manually!") + + def install_egg_scripts(self, dist): + if dist is not self.dist: + # Installing a dependency, so fall back to normal behavior + return easy_install.install_egg_scripts(self, dist) + + # create wrapper scripts in the script dir, pointing to dist.scripts + + # new-style... + self.install_wrapper_scripts(dist) + + # ...and old-style + for script_name in self.distribution.scripts or []: + script_path = os.path.abspath(convert_path(script_name)) + script_name = os.path.basename(script_path) + with io.open(script_path) as strm: + script_text = strm.read() + self.install_script(dist, script_name, script_text, script_path) + + def install_wrapper_scripts(self, dist): + dist = VersionlessRequirement(dist) + return easy_install.install_wrapper_scripts(self, dist) + + +class VersionlessRequirement: + """ + Adapt a pkg_resources.Distribution to simply return the project + name as the 'requirement' so that scripts will work across + multiple versions. + + >>> from pkg_resources import Distribution + >>> dist = Distribution(project_name='foo', version='1.0') + >>> str(dist.as_requirement()) + 'foo==1.0' + >>> adapted_dist = VersionlessRequirement(dist) + >>> str(adapted_dist.as_requirement()) + 'foo' + """ + + def __init__(self, dist): + self.__dist = dist + + def __getattr__(self, name): + return getattr(self.__dist, name) + + def as_requirement(self): + return self.project_name diff --git a/venv/lib/python3.8/site-packages/setuptools/command/dist_info.py b/venv/lib/python3.8/site-packages/setuptools/command/dist_info.py new file mode 100644 index 000000000..c45258fa0 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/command/dist_info.py @@ -0,0 +1,36 @@ +""" +Create a dist_info directory +As defined in the wheel specification +""" + +import os + +from distutils.core import Command +from distutils import log + + +class dist_info(Command): + + description = 'create a .dist-info directory' + + user_options = [ + ('egg-base=', 'e', "directory containing .egg-info directories" + " (default: top of the source tree)"), + ] + + def initialize_options(self): + self.egg_base = None + + def finalize_options(self): + pass + + def run(self): + egg_info = self.get_finalized_command('egg_info') + egg_info.egg_base = self.egg_base + egg_info.finalize_options() + egg_info.run() + dist_info_dir = egg_info.egg_info[:-len('.egg-info')] + '.dist-info' + log.info("creating '{}'".format(os.path.abspath(dist_info_dir))) + + bdist_wheel = self.get_finalized_command('bdist_wheel') + bdist_wheel.egg2dist(egg_info.egg_info, dist_info_dir) diff --git a/venv/lib/python3.8/site-packages/setuptools/command/easy_install.py b/venv/lib/python3.8/site-packages/setuptools/command/easy_install.py new file mode 100644 index 000000000..1f6839cb3 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/command/easy_install.py @@ -0,0 +1,2402 @@ +#!/usr/bin/env python +""" +Easy Install +------------ + +A tool for doing automatic download/extract/build of distutils-based Python +packages. For detailed documentation, see the accompanying EasyInstall.txt +file, or visit the `EasyInstall home page`__. + +__ https://setuptools.readthedocs.io/en/latest/easy_install.html + +""" + +from glob import glob +from distutils.util import get_platform +from distutils.util import convert_path, subst_vars +from distutils.errors import ( + DistutilsArgError, DistutilsOptionError, + DistutilsError, DistutilsPlatformError, +) +from distutils.command.install import INSTALL_SCHEMES, SCHEME_KEYS +from distutils import log, dir_util +from distutils.command.build_scripts import first_line_re +from distutils.spawn import find_executable +import sys +import os +import zipimport +import shutil +import tempfile +import zipfile +import re +import stat +import random +import textwrap +import warnings +import site +import struct +import contextlib +import subprocess +import shlex +import io + + +from sysconfig import get_config_vars, get_path + +from setuptools import SetuptoolsDeprecationWarning + +from setuptools.extern import six +from setuptools.extern.six.moves import configparser, map + +from setuptools import Command +from setuptools.sandbox import run_setup +from setuptools.py27compat import rmtree_safe +from setuptools.command import setopt +from setuptools.archive_util import unpack_archive +from setuptools.package_index import ( + PackageIndex, parse_requirement_arg, URL_SCHEME, +) +from setuptools.command import bdist_egg, egg_info +from setuptools.wheel import Wheel +from pkg_resources import ( + yield_lines, normalize_path, resource_string, ensure_directory, + get_distribution, find_distributions, Environment, Requirement, + Distribution, PathMetadata, EggMetadata, WorkingSet, DistributionNotFound, + VersionConflict, DEVELOP_DIST, +) +import pkg_resources.py31compat + +__metaclass__ = type + +# Turn on PEP440Warnings +warnings.filterwarnings("default", category=pkg_resources.PEP440Warning) + +__all__ = [ + 'samefile', 'easy_install', 'PthDistributions', 'extract_wininst_cfg', + 'main', 'get_exe_prefixes', +] + + +def is_64bit(): + return struct.calcsize("P") == 8 + + +def samefile(p1, p2): + """ + Determine if two paths reference the same file. + + Augments os.path.samefile to work on Windows and + suppresses errors if the path doesn't exist. + """ + both_exist = os.path.exists(p1) and os.path.exists(p2) + use_samefile = hasattr(os.path, 'samefile') and both_exist + if use_samefile: + return os.path.samefile(p1, p2) + norm_p1 = os.path.normpath(os.path.normcase(p1)) + norm_p2 = os.path.normpath(os.path.normcase(p2)) + return norm_p1 == norm_p2 + + +if six.PY2: + + def _to_bytes(s): + return s + + def isascii(s): + try: + six.text_type(s, 'ascii') + return True + except UnicodeError: + return False +else: + + def _to_bytes(s): + return s.encode('utf8') + + def isascii(s): + try: + s.encode('ascii') + return True + except UnicodeError: + return False + + +_one_liner = lambda text: textwrap.dedent(text).strip().replace('\n', '; ') + + +class easy_install(Command): + """Manage a download/build/install process""" + description = "Find/get/install Python packages" + command_consumes_arguments = True + + user_options = [ + ('prefix=', None, "installation prefix"), + ("zip-ok", "z", "install package as a zipfile"), + ("multi-version", "m", "make apps have to require() a version"), + ("upgrade", "U", "force upgrade (searches PyPI for latest versions)"), + ("install-dir=", "d", "install package to DIR"), + ("script-dir=", "s", "install scripts to DIR"), + ("exclude-scripts", "x", "Don't install scripts"), + ("always-copy", "a", "Copy all needed packages to install dir"), + ("index-url=", "i", "base URL of Python Package Index"), + ("find-links=", "f", "additional URL(s) to search for packages"), + ("build-directory=", "b", + "download/extract/build in DIR; keep the results"), + ('optimize=', 'O', + "also compile with optimization: -O1 for \"python -O\", " + "-O2 for \"python -OO\", and -O0 to disable [default: -O0]"), + ('record=', None, + "filename in which to record list of installed files"), + ('always-unzip', 'Z', "don't install as a zipfile, no matter what"), + ('site-dirs=', 'S', "list of directories where .pth files work"), + ('editable', 'e', "Install specified packages in editable form"), + ('no-deps', 'N', "don't install dependencies"), + ('allow-hosts=', 'H', "pattern(s) that hostnames must match"), + ('local-snapshots-ok', 'l', + "allow building eggs from local checkouts"), + ('version', None, "print version information and exit"), + ('install-layout=', None, "installation layout to choose (known values: deb)"), + ('force-installation-into-system-dir', '0', "force installation into /usr"), + ('no-find-links', None, + "Don't load find-links defined in packages being installed") + ] + boolean_options = [ + 'zip-ok', 'multi-version', 'exclude-scripts', 'upgrade', 'always-copy', + 'editable', + 'no-deps', 'local-snapshots-ok', 'version', 'force-installation-into-system-dir' + ] + + if site.ENABLE_USER_SITE: + help_msg = "install in user site-package '%s'" % site.USER_SITE + user_options.append(('user', None, help_msg)) + boolean_options.append('user') + + negative_opt = {'always-unzip': 'zip-ok'} + create_index = PackageIndex + + def initialize_options(self): + # the --user option seems to be an opt-in one, + # so the default should be False. + self.user = 0 + self.zip_ok = self.local_snapshots_ok = None + self.install_dir = self.script_dir = self.exclude_scripts = None + self.index_url = None + self.find_links = None + self.build_directory = None + self.args = None + self.optimize = self.record = None + self.upgrade = self.always_copy = self.multi_version = None + self.editable = self.no_deps = self.allow_hosts = None + self.root = self.prefix = self.no_report = None + self.version = None + self.install_purelib = None # for pure module distributions + self.install_platlib = None # non-pure (dists w/ extensions) + self.install_headers = None # for C/C++ headers + self.install_lib = None # set to either purelib or platlib + self.install_scripts = None + self.install_data = None + self.install_base = None + self.install_platbase = None + if site.ENABLE_USER_SITE: + self.install_userbase = site.USER_BASE + self.install_usersite = site.USER_SITE + else: + self.install_userbase = None + self.install_usersite = None + self.no_find_links = None + + # Options not specifiable via command line + self.package_index = None + self.pth_file = self.always_copy_from = None + self.site_dirs = None + self.installed_projects = {} + self.sitepy_installed = False + # enable custom installation, known values: deb + self.install_layout = None + self.force_installation_into_system_dir = None + self.multiarch = None + + # Always read easy_install options, even if we are subclassed, or have + # an independent instance created. This ensures that defaults will + # always come from the standard configuration file(s)' "easy_install" + # section, even if this is a "develop" or "install" command, or some + # other embedding. + self._dry_run = None + self.verbose = self.distribution.verbose + self.distribution._set_command_options( + self, self.distribution.get_option_dict('easy_install') + ) + + def delete_blockers(self, blockers): + extant_blockers = ( + filename for filename in blockers + if os.path.exists(filename) or os.path.islink(filename) + ) + list(map(self._delete_path, extant_blockers)) + + def _delete_path(self, path): + log.info("Deleting %s", path) + if self.dry_run: + return + + is_tree = os.path.isdir(path) and not os.path.islink(path) + remover = rmtree if is_tree else os.unlink + remover(path) + + @staticmethod + def _render_version(): + """ + Render the Setuptools version and installation details, then exit. + """ + ver = '{}.{}'.format(*sys.version_info) + dist = get_distribution('setuptools') + tmpl = 'setuptools {dist.version} from {dist.location} (Python {ver})' + print(tmpl.format(**locals())) + raise SystemExit() + + def finalize_options(self): + self.version and self._render_version() + + py_version = sys.version.split()[0] + prefix, exec_prefix = get_config_vars('prefix', 'exec_prefix') + + self.config_vars = { + 'dist_name': self.distribution.get_name(), + 'dist_version': self.distribution.get_version(), + 'dist_fullname': self.distribution.get_fullname(), + 'py_version': py_version, + 'py_version_short': py_version[0:3], + 'py_version_nodot': py_version[0] + py_version[2], + 'sys_prefix': prefix, + 'prefix': prefix, + 'sys_exec_prefix': exec_prefix, + 'exec_prefix': exec_prefix, + # Only python 3.2+ has abiflags + 'abiflags': getattr(sys, 'abiflags', ''), + } + + if site.ENABLE_USER_SITE: + self.config_vars['userbase'] = self.install_userbase + self.config_vars['usersite'] = self.install_usersite + + self._fix_install_dir_for_user_site() + + self.expand_basedirs() + self.expand_dirs() + + if self.install_layout: + if not self.install_layout.lower() in ['deb']: + raise DistutilsOptionError("unknown value for --install-layout") + self.install_layout = self.install_layout.lower() + + import sysconfig + if sys.version_info[:2] >= (3, 3): + self.multiarch = sysconfig.get_config_var('MULTIARCH') + + self._expand( + 'install_dir', 'script_dir', 'build_directory', + 'site_dirs', + ) + # If a non-default installation directory was specified, default the + # script directory to match it. + if self.script_dir is None: + self.script_dir = self.install_dir + + if self.no_find_links is None: + self.no_find_links = False + + # Let install_dir get set by install_lib command, which in turn + # gets its info from the install command, and takes into account + # --prefix and --home and all that other crud. + self.set_undefined_options( + 'install_lib', ('install_dir', 'install_dir') + ) + # Likewise, set default script_dir from 'install_scripts.install_dir' + self.set_undefined_options( + 'install_scripts', ('install_dir', 'script_dir') + ) + + if self.user and self.install_purelib: + self.install_dir = self.install_purelib + self.script_dir = self.install_scripts + + if self.prefix == '/usr' and not self.force_installation_into_system_dir: + raise DistutilsOptionError("""installation into /usr + +Trying to install into the system managed parts of the file system. Please +consider to install to another location, or use the option +--force-installation-into-system-dir to overwrite this warning. +""") + + # default --record from the install command + self.set_undefined_options('install', ('record', 'record')) + # Should this be moved to the if statement below? It's not used + # elsewhere + normpath = map(normalize_path, sys.path) + self.all_site_dirs = get_site_dirs() + if self.site_dirs is not None: + site_dirs = [ + os.path.expanduser(s.strip()) for s in + self.site_dirs.split(',') + ] + for d in site_dirs: + if not os.path.isdir(d): + log.warn("%s (in --site-dirs) does not exist", d) + elif normalize_path(d) not in normpath: + raise DistutilsOptionError( + d + " (in --site-dirs) is not on sys.path" + ) + else: + self.all_site_dirs.append(normalize_path(d)) + if not self.editable: + self.check_site_dir() + self.index_url = self.index_url or "https://pypi.org/simple/" + self.shadow_path = self.all_site_dirs[:] + for path_item in self.install_dir, normalize_path(self.script_dir): + if path_item not in self.shadow_path: + self.shadow_path.insert(0, path_item) + + if self.allow_hosts is not None: + hosts = [s.strip() for s in self.allow_hosts.split(',')] + else: + hosts = ['*'] + if self.package_index is None: + self.package_index = self.create_index( + self.index_url, search_path=self.shadow_path, hosts=hosts, + ) + self.local_index = Environment(self.shadow_path + sys.path) + + if self.find_links is not None: + if isinstance(self.find_links, six.string_types): + self.find_links = self.find_links.split() + else: + self.find_links = [] + if self.local_snapshots_ok: + self.package_index.scan_egg_links(self.shadow_path + sys.path) + if not self.no_find_links: + self.package_index.add_find_links(self.find_links) + self.set_undefined_options('install_lib', ('optimize', 'optimize')) + if not isinstance(self.optimize, int): + try: + self.optimize = int(self.optimize) + if not (0 <= self.optimize <= 2): + raise ValueError + except ValueError: + raise DistutilsOptionError("--optimize must be 0, 1, or 2") + + if self.editable and not self.build_directory: + raise DistutilsArgError( + "Must specify a build directory (-b) when using --editable" + ) + if not self.args: + raise DistutilsArgError( + "No urls, filenames, or requirements specified (see --help)") + + self.outputs = [] + + def _fix_install_dir_for_user_site(self): + """ + Fix the install_dir if "--user" was used. + """ + if not self.user or not site.ENABLE_USER_SITE: + return + + self.create_home_path() + if self.install_userbase is None: + msg = "User base directory is not specified" + raise DistutilsPlatformError(msg) + self.install_base = self.install_platbase = self.install_userbase + scheme_name = os.name.replace('posix', 'unix') + '_user' + self.select_scheme(scheme_name) + + def _expand_attrs(self, attrs): + for attr in attrs: + val = getattr(self, attr) + if val is not None: + if os.name == 'posix' or os.name == 'nt': + val = os.path.expanduser(val) + val = subst_vars(val, self.config_vars) + setattr(self, attr, val) + + def expand_basedirs(self): + """Calls `os.path.expanduser` on install_base, install_platbase and + root.""" + self._expand_attrs(['install_base', 'install_platbase', 'root']) + + def expand_dirs(self): + """Calls `os.path.expanduser` on install dirs.""" + dirs = [ + 'install_purelib', + 'install_platlib', + 'install_lib', + 'install_headers', + 'install_scripts', + 'install_data', + ] + self._expand_attrs(dirs) + + def run(self, show_deprecation=True): + if show_deprecation: + self.announce( + "WARNING: The easy_install command is deprecated " + "and will be removed in a future version." + , log.WARN, + ) + if self.verbose != self.distribution.verbose: + log.set_verbosity(self.verbose) + try: + for spec in self.args: + self.easy_install(spec, not self.no_deps) + if self.record: + outputs = list(sorted(self.outputs)) + if self.root: # strip any package prefix + root_len = len(self.root) + for counter in range(len(outputs)): + outputs[counter] = outputs[counter][root_len:] + from distutils import file_util + + self.execute( + file_util.write_file, (self.record, outputs), + "writing list of installed files to '%s'" % + self.record + ) + self.warn_deprecated_options() + finally: + log.set_verbosity(self.distribution.verbose) + + def pseudo_tempname(self): + """Return a pseudo-tempname base in the install directory. + This code is intentionally naive; if a malicious party can write to + the target directory you're already in deep doodoo. + """ + try: + pid = os.getpid() + except Exception: + pid = random.randint(0, sys.maxsize) + return os.path.join(self.install_dir, "test-easy-install-%s" % pid) + + def warn_deprecated_options(self): + pass + + def check_site_dir(self): + """Verify that self.install_dir is .pth-capable dir, if needed""" + + instdir = normalize_path(self.install_dir) + pth_file = os.path.join(instdir, 'easy-install.pth') + + # Is it a configured, PYTHONPATH, implicit, or explicit site dir? + is_site_dir = instdir in self.all_site_dirs + + if not is_site_dir and not self.multi_version: + # No? Then directly test whether it does .pth file processing + is_site_dir = self.check_pth_processing() + else: + # make sure we can write to target dir + testfile = self.pseudo_tempname() + '.write-test' + test_exists = os.path.exists(testfile) + try: + if test_exists: + os.unlink(testfile) + open(testfile, 'w').close() + os.unlink(testfile) + except (OSError, IOError): + self.cant_write_to_target() + + if not is_site_dir and not self.multi_version: + # Can't install non-multi to non-site dir + raise DistutilsError(self.no_default_version_msg()) + + if is_site_dir: + if self.pth_file is None: + self.pth_file = PthDistributions(pth_file, self.all_site_dirs) + else: + self.pth_file = None + + if instdir not in map(normalize_path, _pythonpath()): + # only PYTHONPATH dirs need a site.py, so pretend it's there + self.sitepy_installed = True + elif self.multi_version and not os.path.exists(pth_file): + self.sitepy_installed = True # don't need site.py in this case + self.pth_file = None # and don't create a .pth file + self.install_dir = instdir + + __cant_write_msg = textwrap.dedent(""" + can't create or remove files in install directory + + The following error occurred while trying to add or remove files in the + installation directory: + + %s + + The installation directory you specified (via --install-dir, --prefix, or + the distutils default setting) was: + + %s + """).lstrip() + + __not_exists_id = textwrap.dedent(""" + This directory does not currently exist. Please create it and try again, or + choose a different installation directory (using the -d or --install-dir + option). + """).lstrip() + + __access_msg = textwrap.dedent(""" + Perhaps your account does not have write access to this directory? If the + installation directory is a system-owned directory, you may need to sign in + as the administrator or "root" account. If you do not have administrative + access to this machine, you may wish to choose a different installation + directory, preferably one that is listed in your PYTHONPATH environment + variable. + + For information on other options, you may wish to consult the + documentation at: + + https://setuptools.readthedocs.io/en/latest/easy_install.html + + Please make the appropriate changes for your system and try again. + """).lstrip() + + def cant_write_to_target(self): + msg = self.__cant_write_msg % (sys.exc_info()[1], self.install_dir,) + + if not os.path.exists(self.install_dir): + msg += '\n' + self.__not_exists_id + else: + msg += '\n' + self.__access_msg + raise DistutilsError(msg) + + def check_pth_processing(self): + """Empirically verify whether .pth files are supported in inst. dir""" + instdir = self.install_dir + log.info("Checking .pth file support in %s", instdir) + pth_file = self.pseudo_tempname() + ".pth" + ok_file = pth_file + '.ok' + ok_exists = os.path.exists(ok_file) + tmpl = _one_liner(""" + import os + f = open({ok_file!r}, 'w') + f.write('OK') + f.close() + """) + '\n' + try: + if ok_exists: + os.unlink(ok_file) + dirname = os.path.dirname(ok_file) + pkg_resources.py31compat.makedirs(dirname, exist_ok=True) + f = open(pth_file, 'w') + except (OSError, IOError): + self.cant_write_to_target() + else: + try: + f.write(tmpl.format(**locals())) + f.close() + f = None + executable = sys.executable + if os.name == 'nt': + dirname, basename = os.path.split(executable) + alt = os.path.join(dirname, 'pythonw.exe') + use_alt = ( + basename.lower() == 'python.exe' and + os.path.exists(alt) + ) + if use_alt: + # use pythonw.exe to avoid opening a console window + executable = alt + + from distutils.spawn import spawn + + spawn([executable, '-E', '-c', 'pass'], 0) + + if os.path.exists(ok_file): + log.info( + "TEST PASSED: %s appears to support .pth files", + instdir + ) + return True + finally: + if f: + f.close() + if os.path.exists(ok_file): + os.unlink(ok_file) + if os.path.exists(pth_file): + os.unlink(pth_file) + if not self.multi_version: + log.warn("TEST FAILED: %s does NOT support .pth files", instdir) + return False + + def install_egg_scripts(self, dist): + """Write all the scripts for `dist`, unless scripts are excluded""" + if not self.exclude_scripts and dist.metadata_isdir('scripts'): + for script_name in dist.metadata_listdir('scripts'): + if dist.metadata_isdir('scripts/' + script_name): + # The "script" is a directory, likely a Python 3 + # __pycache__ directory, so skip it. + continue + self.install_script( + dist, script_name, + dist.get_metadata('scripts/' + script_name) + ) + self.install_wrapper_scripts(dist) + + def add_output(self, path): + if os.path.isdir(path): + for base, dirs, files in os.walk(path): + for filename in files: + self.outputs.append(os.path.join(base, filename)) + else: + self.outputs.append(path) + + def not_editable(self, spec): + if self.editable: + raise DistutilsArgError( + "Invalid argument %r: you can't use filenames or URLs " + "with --editable (except via the --find-links option)." + % (spec,) + ) + + def check_editable(self, spec): + if not self.editable: + return + + if os.path.exists(os.path.join(self.build_directory, spec.key)): + raise DistutilsArgError( + "%r already exists in %s; can't do a checkout there" % + (spec.key, self.build_directory) + ) + + @contextlib.contextmanager + def _tmpdir(self): + tmpdir = tempfile.mkdtemp(prefix=u"easy_install-") + try: + # cast to str as workaround for #709 and #710 and #712 + yield str(tmpdir) + finally: + os.path.exists(tmpdir) and rmtree(rmtree_safe(tmpdir)) + + def easy_install(self, spec, deps=False): + if not self.editable: + self.install_site_py() + + with self._tmpdir() as tmpdir: + if not isinstance(spec, Requirement): + if URL_SCHEME(spec): + # It's a url, download it to tmpdir and process + self.not_editable(spec) + dl = self.package_index.download(spec, tmpdir) + return self.install_item(None, dl, tmpdir, deps, True) + + elif os.path.exists(spec): + # Existing file or directory, just process it directly + self.not_editable(spec) + return self.install_item(None, spec, tmpdir, deps, True) + else: + spec = parse_requirement_arg(spec) + + self.check_editable(spec) + dist = self.package_index.fetch_distribution( + spec, tmpdir, self.upgrade, self.editable, + not self.always_copy, self.local_index + ) + if dist is None: + msg = "Could not find suitable distribution for %r" % spec + if self.always_copy: + msg += " (--always-copy skips system and development eggs)" + raise DistutilsError(msg) + elif dist.precedence == DEVELOP_DIST: + # .egg-info dists don't need installing, just process deps + self.process_distribution(spec, dist, deps, "Using") + return dist + else: + return self.install_item(spec, dist.location, tmpdir, deps) + + def install_item(self, spec, download, tmpdir, deps, install_needed=False): + + # Installation is also needed if file in tmpdir or is not an egg + install_needed = install_needed or self.always_copy + install_needed = install_needed or os.path.dirname(download) == tmpdir + install_needed = install_needed or not download.endswith('.egg') + install_needed = install_needed or ( + self.always_copy_from is not None and + os.path.dirname(normalize_path(download)) == + normalize_path(self.always_copy_from) + ) + + if spec and not install_needed: + # at this point, we know it's a local .egg, we just don't know if + # it's already installed. + for dist in self.local_index[spec.project_name]: + if dist.location == download: + break + else: + install_needed = True # it's not in the local index + + log.info("Processing %s", os.path.basename(download)) + + if install_needed: + dists = self.install_eggs(spec, download, tmpdir) + for dist in dists: + self.process_distribution(spec, dist, deps) + else: + dists = [self.egg_distribution(download)] + self.process_distribution(spec, dists[0], deps, "Using") + + if spec is not None: + for dist in dists: + if dist in spec: + return dist + + def select_scheme(self, name): + """Sets the install directories by applying the install schemes.""" + # it's the caller's problem if they supply a bad name! + scheme = INSTALL_SCHEMES[name] + for key in SCHEME_KEYS: + attrname = 'install_' + key + if getattr(self, attrname) is None: + setattr(self, attrname, scheme[key]) + + def process_distribution(self, requirement, dist, deps=True, *info): + self.update_pth(dist) + self.package_index.add(dist) + if dist in self.local_index[dist.key]: + self.local_index.remove(dist) + self.local_index.add(dist) + self.install_egg_scripts(dist) + self.installed_projects[dist.key] = dist + log.info(self.installation_report(requirement, dist, *info)) + if (dist.has_metadata('dependency_links.txt') and + not self.no_find_links): + self.package_index.add_find_links( + dist.get_metadata_lines('dependency_links.txt') + ) + if not deps and not self.always_copy: + return + elif requirement is not None and dist.key != requirement.key: + log.warn("Skipping dependencies for %s", dist) + return # XXX this is not the distribution we were looking for + elif requirement is None or dist not in requirement: + # if we wound up with a different version, resolve what we've got + distreq = dist.as_requirement() + requirement = Requirement(str(distreq)) + log.info("Processing dependencies for %s", requirement) + try: + distros = WorkingSet([]).resolve( + [requirement], self.local_index, self.easy_install + ) + except DistributionNotFound as e: + raise DistutilsError(str(e)) + except VersionConflict as e: + raise DistutilsError(e.report()) + if self.always_copy or self.always_copy_from: + # Force all the relevant distros to be copied or activated + for dist in distros: + if dist.key not in self.installed_projects: + self.easy_install(dist.as_requirement()) + log.info("Finished processing dependencies for %s", requirement) + + def should_unzip(self, dist): + if self.zip_ok is not None: + return not self.zip_ok + if dist.has_metadata('not-zip-safe'): + return True + if not dist.has_metadata('zip-safe'): + return True + return False + + def maybe_move(self, spec, dist_filename, setup_base): + dst = os.path.join(self.build_directory, spec.key) + if os.path.exists(dst): + msg = ( + "%r already exists in %s; build directory %s will not be kept" + ) + log.warn(msg, spec.key, self.build_directory, setup_base) + return setup_base + if os.path.isdir(dist_filename): + setup_base = dist_filename + else: + if os.path.dirname(dist_filename) == setup_base: + os.unlink(dist_filename) # get it out of the tmp dir + contents = os.listdir(setup_base) + if len(contents) == 1: + dist_filename = os.path.join(setup_base, contents[0]) + if os.path.isdir(dist_filename): + # if the only thing there is a directory, move it instead + setup_base = dist_filename + ensure_directory(dst) + shutil.move(setup_base, dst) + return dst + + def install_wrapper_scripts(self, dist): + if self.exclude_scripts: + return + for args in ScriptWriter.best().get_args(dist): + self.write_script(*args) + + def install_script(self, dist, script_name, script_text, dev_path=None): + """Generate a legacy script wrapper and install it""" + spec = str(dist.as_requirement()) + is_script = is_python_script(script_text, script_name) + + if is_script: + body = self._load_template(dev_path) % locals() + script_text = ScriptWriter.get_header(script_text) + body + self.write_script(script_name, _to_bytes(script_text), 'b') + + @staticmethod + def _load_template(dev_path): + """ + There are a couple of template scripts in the package. This + function loads one of them and prepares it for use. + """ + # See https://github.com/pypa/setuptools/issues/134 for info + # on script file naming and downstream issues with SVR4 + name = 'script.tmpl' + if dev_path: + name = name.replace('.tmpl', ' (dev).tmpl') + + raw_bytes = resource_string('setuptools', name) + return raw_bytes.decode('utf-8') + + def write_script(self, script_name, contents, mode="t", blockers=()): + """Write an executable file to the scripts directory""" + self.delete_blockers( # clean up old .py/.pyw w/o a script + [os.path.join(self.script_dir, x) for x in blockers] + ) + log.info("Installing %s script to %s", script_name, self.script_dir) + target = os.path.join(self.script_dir, script_name) + self.add_output(target) + + if self.dry_run: + return + + mask = current_umask() + ensure_directory(target) + if os.path.exists(target): + os.unlink(target) + with open(target, "w" + mode) as f: + f.write(contents) + chmod(target, 0o777 - mask) + + def install_eggs(self, spec, dist_filename, tmpdir): + # .egg dirs or files are already built, so just return them + if dist_filename.lower().endswith('.egg'): + return [self.install_egg(dist_filename, tmpdir)] + elif dist_filename.lower().endswith('.exe'): + return [self.install_exe(dist_filename, tmpdir)] + elif dist_filename.lower().endswith('.whl'): + return [self.install_wheel(dist_filename, tmpdir)] + + # Anything else, try to extract and build + setup_base = tmpdir + if os.path.isfile(dist_filename) and not dist_filename.endswith('.py'): + unpack_archive(dist_filename, tmpdir, self.unpack_progress) + elif os.path.isdir(dist_filename): + setup_base = os.path.abspath(dist_filename) + + if (setup_base.startswith(tmpdir) # something we downloaded + and self.build_directory and spec is not None): + setup_base = self.maybe_move(spec, dist_filename, setup_base) + + # Find the setup.py file + setup_script = os.path.join(setup_base, 'setup.py') + + if not os.path.exists(setup_script): + setups = glob(os.path.join(setup_base, '*', 'setup.py')) + if not setups: + raise DistutilsError( + "Couldn't find a setup script in %s" % + os.path.abspath(dist_filename) + ) + if len(setups) > 1: + raise DistutilsError( + "Multiple setup scripts in %s" % + os.path.abspath(dist_filename) + ) + setup_script = setups[0] + + # Now run it, and return the result + if self.editable: + log.info(self.report_editable(spec, setup_script)) + return [] + else: + return self.build_and_install(setup_script, setup_base) + + def egg_distribution(self, egg_path): + if os.path.isdir(egg_path): + metadata = PathMetadata(egg_path, os.path.join(egg_path, + 'EGG-INFO')) + else: + metadata = EggMetadata(zipimport.zipimporter(egg_path)) + return Distribution.from_filename(egg_path, metadata=metadata) + + def install_egg(self, egg_path, tmpdir): + destination = os.path.join( + self.install_dir, + os.path.basename(egg_path), + ) + destination = os.path.abspath(destination) + if not self.dry_run: + ensure_directory(destination) + + dist = self.egg_distribution(egg_path) + if not samefile(egg_path, destination): + if os.path.isdir(destination) and not os.path.islink(destination): + dir_util.remove_tree(destination, dry_run=self.dry_run) + elif os.path.exists(destination): + self.execute( + os.unlink, + (destination,), + "Removing " + destination, + ) + try: + new_dist_is_zipped = False + if os.path.isdir(egg_path): + if egg_path.startswith(tmpdir): + f, m = shutil.move, "Moving" + else: + f, m = shutil.copytree, "Copying" + elif self.should_unzip(dist): + self.mkpath(destination) + f, m = self.unpack_and_compile, "Extracting" + else: + new_dist_is_zipped = True + if egg_path.startswith(tmpdir): + f, m = shutil.move, "Moving" + else: + f, m = shutil.copy2, "Copying" + self.execute( + f, + (egg_path, destination), + (m + " %s to %s") % ( + os.path.basename(egg_path), + os.path.dirname(destination) + ), + ) + update_dist_caches( + destination, + fix_zipimporter_caches=new_dist_is_zipped, + ) + except Exception: + update_dist_caches(destination, fix_zipimporter_caches=False) + raise + + self.add_output(destination) + return self.egg_distribution(destination) + + def install_exe(self, dist_filename, tmpdir): + # See if it's valid, get data + cfg = extract_wininst_cfg(dist_filename) + if cfg is None: + raise DistutilsError( + "%s is not a valid distutils Windows .exe" % dist_filename + ) + # Create a dummy distribution object until we build the real distro + dist = Distribution( + None, + project_name=cfg.get('metadata', 'name'), + version=cfg.get('metadata', 'version'), platform=get_platform(), + ) + + # Convert the .exe to an unpacked egg + egg_path = os.path.join(tmpdir, dist.egg_name() + '.egg') + dist.location = egg_path + egg_tmp = egg_path + '.tmp' + _egg_info = os.path.join(egg_tmp, 'EGG-INFO') + pkg_inf = os.path.join(_egg_info, 'PKG-INFO') + ensure_directory(pkg_inf) # make sure EGG-INFO dir exists + dist._provider = PathMetadata(egg_tmp, _egg_info) # XXX + self.exe_to_egg(dist_filename, egg_tmp) + + # Write EGG-INFO/PKG-INFO + if not os.path.exists(pkg_inf): + f = open(pkg_inf, 'w') + f.write('Metadata-Version: 1.0\n') + for k, v in cfg.items('metadata'): + if k != 'target_version': + f.write('%s: %s\n' % (k.replace('_', '-').title(), v)) + f.close() + script_dir = os.path.join(_egg_info, 'scripts') + # delete entry-point scripts to avoid duping + self.delete_blockers([ + os.path.join(script_dir, args[0]) + for args in ScriptWriter.get_args(dist) + ]) + # Build .egg file from tmpdir + bdist_egg.make_zipfile( + egg_path, egg_tmp, verbose=self.verbose, dry_run=self.dry_run, + ) + # install the .egg + return self.install_egg(egg_path, tmpdir) + + def exe_to_egg(self, dist_filename, egg_tmp): + """Extract a bdist_wininst to the directories an egg would use""" + # Check for .pth file and set up prefix translations + prefixes = get_exe_prefixes(dist_filename) + to_compile = [] + native_libs = [] + top_level = {} + + def process(src, dst): + s = src.lower() + for old, new in prefixes: + if s.startswith(old): + src = new + src[len(old):] + parts = src.split('/') + dst = os.path.join(egg_tmp, *parts) + dl = dst.lower() + if dl.endswith('.pyd') or dl.endswith('.dll'): + parts[-1] = bdist_egg.strip_module(parts[-1]) + top_level[os.path.splitext(parts[0])[0]] = 1 + native_libs.append(src) + elif dl.endswith('.py') and old != 'SCRIPTS/': + top_level[os.path.splitext(parts[0])[0]] = 1 + to_compile.append(dst) + return dst + if not src.endswith('.pth'): + log.warn("WARNING: can't process %s", src) + return None + + # extract, tracking .pyd/.dll->native_libs and .py -> to_compile + unpack_archive(dist_filename, egg_tmp, process) + stubs = [] + for res in native_libs: + if res.lower().endswith('.pyd'): # create stubs for .pyd's + parts = res.split('/') + resource = parts[-1] + parts[-1] = bdist_egg.strip_module(parts[-1]) + '.py' + pyfile = os.path.join(egg_tmp, *parts) + to_compile.append(pyfile) + stubs.append(pyfile) + bdist_egg.write_stub(resource, pyfile) + self.byte_compile(to_compile) # compile .py's + bdist_egg.write_safety_flag( + os.path.join(egg_tmp, 'EGG-INFO'), + bdist_egg.analyze_egg(egg_tmp, stubs)) # write zip-safety flag + + for name in 'top_level', 'native_libs': + if locals()[name]: + txt = os.path.join(egg_tmp, 'EGG-INFO', name + '.txt') + if not os.path.exists(txt): + f = open(txt, 'w') + f.write('\n'.join(locals()[name]) + '\n') + f.close() + + def install_wheel(self, wheel_path, tmpdir): + wheel = Wheel(wheel_path) + assert wheel.is_compatible() + destination = os.path.join(self.install_dir, wheel.egg_name()) + destination = os.path.abspath(destination) + if not self.dry_run: + ensure_directory(destination) + if os.path.isdir(destination) and not os.path.islink(destination): + dir_util.remove_tree(destination, dry_run=self.dry_run) + elif os.path.exists(destination): + self.execute( + os.unlink, + (destination,), + "Removing " + destination, + ) + try: + self.execute( + wheel.install_as_egg, + (destination,), + ("Installing %s to %s") % ( + os.path.basename(wheel_path), + os.path.dirname(destination) + ), + ) + finally: + update_dist_caches(destination, fix_zipimporter_caches=False) + self.add_output(destination) + return self.egg_distribution(destination) + + __mv_warning = textwrap.dedent(""" + Because this distribution was installed --multi-version, before you can + import modules from this package in an application, you will need to + 'import pkg_resources' and then use a 'require()' call similar to one of + these examples, in order to select the desired version: + + pkg_resources.require("%(name)s") # latest installed version + pkg_resources.require("%(name)s==%(version)s") # this exact version + pkg_resources.require("%(name)s>=%(version)s") # this version or higher + """).lstrip() + + __id_warning = textwrap.dedent(""" + Note also that the installation directory must be on sys.path at runtime for + this to work. (e.g. by being the application's script directory, by being on + PYTHONPATH, or by being added to sys.path by your code.) + """) + + def installation_report(self, req, dist, what="Installed"): + """Helpful installation message for display to package users""" + msg = "\n%(what)s %(eggloc)s%(extras)s" + if self.multi_version and not self.no_report: + msg += '\n' + self.__mv_warning + if self.install_dir not in map(normalize_path, sys.path): + msg += '\n' + self.__id_warning + + eggloc = dist.location + name = dist.project_name + version = dist.version + extras = '' # TODO: self.report_extras(req, dist) + return msg % locals() + + __editable_msg = textwrap.dedent(""" + Extracted editable version of %(spec)s to %(dirname)s + + If it uses setuptools in its setup script, you can activate it in + "development" mode by going to that directory and running:: + + %(python)s setup.py develop + + See the setuptools documentation for the "develop" command for more info. + """).lstrip() + + def report_editable(self, spec, setup_script): + dirname = os.path.dirname(setup_script) + python = sys.executable + return '\n' + self.__editable_msg % locals() + + def run_setup(self, setup_script, setup_base, args): + sys.modules.setdefault('distutils.command.bdist_egg', bdist_egg) + sys.modules.setdefault('distutils.command.egg_info', egg_info) + + args = list(args) + if self.verbose > 2: + v = 'v' * (self.verbose - 1) + args.insert(0, '-' + v) + elif self.verbose < 2: + args.insert(0, '-q') + if self.dry_run: + args.insert(0, '-n') + log.info( + "Running %s %s", setup_script[len(setup_base) + 1:], ' '.join(args) + ) + try: + run_setup(setup_script, args) + except SystemExit as v: + raise DistutilsError("Setup script exited with %s" % (v.args[0],)) + + def build_and_install(self, setup_script, setup_base): + args = ['bdist_egg', '--dist-dir'] + + dist_dir = tempfile.mkdtemp( + prefix='egg-dist-tmp-', dir=os.path.dirname(setup_script) + ) + try: + self._set_fetcher_options(os.path.dirname(setup_script)) + args.append(dist_dir) + + self.run_setup(setup_script, setup_base, args) + all_eggs = Environment([dist_dir]) + eggs = [] + for key in all_eggs: + for dist in all_eggs[key]: + eggs.append(self.install_egg(dist.location, setup_base)) + if not eggs and not self.dry_run: + log.warn("No eggs found in %s (setup script problem?)", + dist_dir) + return eggs + finally: + rmtree(dist_dir) + log.set_verbosity(self.verbose) # restore our log verbosity + + def _set_fetcher_options(self, base): + """ + When easy_install is about to run bdist_egg on a source dist, that + source dist might have 'setup_requires' directives, requiring + additional fetching. Ensure the fetcher options given to easy_install + are available to that command as well. + """ + # find the fetch options from easy_install and write them out + # to the setup.cfg file. + ei_opts = self.distribution.get_option_dict('easy_install').copy() + fetch_directives = ( + 'find_links', 'site_dirs', 'index_url', 'optimize', 'allow_hosts', + ) + fetch_options = {} + for key, val in ei_opts.items(): + if key not in fetch_directives: + continue + fetch_options[key.replace('_', '-')] = val[1] + # create a settings dictionary suitable for `edit_config` + settings = dict(easy_install=fetch_options) + cfg_filename = os.path.join(base, 'setup.cfg') + setopt.edit_config(cfg_filename, settings) + + def update_pth(self, dist): + if self.pth_file is None: + return + + for d in self.pth_file[dist.key]: # drop old entries + if self.multi_version or d.location != dist.location: + log.info("Removing %s from easy-install.pth file", d) + self.pth_file.remove(d) + if d.location in self.shadow_path: + self.shadow_path.remove(d.location) + + if not self.multi_version: + if dist.location in self.pth_file.paths: + log.info( + "%s is already the active version in easy-install.pth", + dist, + ) + else: + log.info("Adding %s to easy-install.pth file", dist) + self.pth_file.add(dist) # add new entry + if dist.location not in self.shadow_path: + self.shadow_path.append(dist.location) + + if not self.dry_run: + + self.pth_file.save() + + if dist.key == 'setuptools': + # Ensure that setuptools itself never becomes unavailable! + # XXX should this check for latest version? + filename = os.path.join(self.install_dir, 'setuptools.pth') + if os.path.islink(filename): + os.unlink(filename) + f = open(filename, 'wt') + f.write(self.pth_file.make_relative(dist.location) + '\n') + f.close() + + def unpack_progress(self, src, dst): + # Progress filter for unpacking + log.debug("Unpacking %s to %s", src, dst) + return dst # only unpack-and-compile skips files for dry run + + def unpack_and_compile(self, egg_path, destination): + to_compile = [] + to_chmod = [] + + def pf(src, dst): + if dst.endswith('.py') and not src.startswith('EGG-INFO/'): + to_compile.append(dst) + elif dst.endswith('.dll') or dst.endswith('.so'): + to_chmod.append(dst) + self.unpack_progress(src, dst) + return not self.dry_run and dst or None + + unpack_archive(egg_path, destination, pf) + self.byte_compile(to_compile) + if not self.dry_run: + for f in to_chmod: + mode = ((os.stat(f)[stat.ST_MODE]) | 0o555) & 0o7755 + chmod(f, mode) + + def byte_compile(self, to_compile): + if sys.dont_write_bytecode: + return + + from distutils.util import byte_compile + + try: + # try to make the byte compile messages quieter + log.set_verbosity(self.verbose - 1) + + byte_compile(to_compile, optimize=0, force=1, dry_run=self.dry_run) + if self.optimize: + byte_compile( + to_compile, optimize=self.optimize, force=1, + dry_run=self.dry_run, + ) + finally: + log.set_verbosity(self.verbose) # restore original verbosity + + __no_default_msg = textwrap.dedent(""" + bad install directory or PYTHONPATH + + You are attempting to install a package to a directory that is not + on PYTHONPATH and which Python does not read ".pth" files from. The + installation directory you specified (via --install-dir, --prefix, or + the distutils default setting) was: + + %s + + and your PYTHONPATH environment variable currently contains: + + %r + + Here are some of your options for correcting the problem: + + * You can choose a different installation directory, i.e., one that is + on PYTHONPATH or supports .pth files + + * You can add the installation directory to the PYTHONPATH environment + variable. (It must then also be on PYTHONPATH whenever you run + Python and want to use the package(s) you are installing.) + + * You can set up the installation directory to support ".pth" files by + using one of the approaches described here: + + https://setuptools.readthedocs.io/en/latest/easy_install.html#custom-installation-locations + + + Please make the appropriate changes for your system and try again.""").lstrip() + + def no_default_version_msg(self): + template = self.__no_default_msg + return template % (self.install_dir, os.environ.get('PYTHONPATH', '')) + + def install_site_py(self): + """Make sure there's a site.py in the target dir, if needed""" + + if self.sitepy_installed: + return # already did it, or don't need to + + sitepy = os.path.join(self.install_dir, "site.py") + source = resource_string("setuptools", "site-patch.py") + source = source.decode('utf-8') + current = "" + + if os.path.exists(sitepy): + log.debug("Checking existing site.py in %s", self.install_dir) + with io.open(sitepy) as strm: + current = strm.read() + + if not current.startswith('def __boot():'): + raise DistutilsError( + "%s is not a setuptools-generated site.py; please" + " remove it." % sitepy + ) + + if current != source: + log.info("Creating %s", sitepy) + if not self.dry_run: + ensure_directory(sitepy) + with io.open(sitepy, 'w', encoding='utf-8') as strm: + strm.write(source) + self.byte_compile([sitepy]) + + self.sitepy_installed = True + + def create_home_path(self): + """Create directories under ~.""" + if not self.user: + return + home = convert_path(os.path.expanduser("~")) + for name, path in six.iteritems(self.config_vars): + if path.startswith(home) and not os.path.isdir(path): + self.debug_print("os.makedirs('%s', 0o700)" % path) + os.makedirs(path, 0o700) + + if sys.version[:3] in ('2.3', '2.4', '2.5') or 'real_prefix' in sys.__dict__: + sitedir_name = 'site-packages' + else: + sitedir_name = 'dist-packages' + + INSTALL_SCHEMES = dict( + posix=dict( + install_dir='$base/lib/python$py_version_short/site-packages', + script_dir='$base/bin', + ), + unix_local = dict( + install_dir = '$base/local/lib/python$py_version_short/%s' % sitedir_name, + script_dir = '$base/local/bin', + ), + posix_local = dict( + install_dir = '$base/local/lib/python$py_version_short/%s' % sitedir_name, + script_dir = '$base/local/bin', + ), + deb_system = dict( + install_dir = '$base/lib/python3/%s' % sitedir_name, + script_dir = '$base/bin', + ), + ) + + DEFAULT_SCHEME = dict( + install_dir='$base/Lib/site-packages', + script_dir='$base/Scripts', + ) + + def _expand(self, *attrs): + config_vars = self.get_finalized_command('install').config_vars + + if self.prefix or self.install_layout: + if self.install_layout and self.install_layout in ['deb']: + scheme_name = "deb_system" + self.prefix = '/usr' + elif self.prefix or 'real_prefix' in sys.__dict__: + scheme_name = os.name + else: + scheme_name = "posix_local" + # Set default install_dir/scripts from --prefix + config_vars = config_vars.copy() + config_vars['base'] = self.prefix + scheme = self.INSTALL_SCHEMES.get(scheme_name,self.DEFAULT_SCHEME) + for attr, val in scheme.items(): + if getattr(self, attr, None) is None: + setattr(self, attr, val) + + from distutils.util import subst_vars + + for attr in attrs: + val = getattr(self, attr) + if val is not None: + val = subst_vars(val, config_vars) + if os.name == 'posix': + val = os.path.expanduser(val) + setattr(self, attr, val) + + +def _pythonpath(): + items = os.environ.get('PYTHONPATH', '').split(os.pathsep) + return filter(None, items) + + +def get_site_dirs(): + """ + Return a list of 'site' dirs + """ + + sitedirs = [] + + # start with PYTHONPATH + sitedirs.extend(_pythonpath()) + + prefixes = [sys.prefix] + if sys.exec_prefix != sys.prefix: + prefixes.append(sys.exec_prefix) + for prefix in prefixes: + if prefix: + if sys.platform in ('os2emx', 'riscos'): + sitedirs.append(os.path.join(prefix, "Lib", "site-packages")) + elif os.sep == '/': + sitedirs.extend([ + os.path.join( + prefix, + "local/lib", + "python" + sys.version[:3], + "dist-packages", + ), + os.path.join( + prefix, + "lib", + "python{}.{}".format(*sys.version_info), + "dist-packages", + ), + os.path.join(prefix, "lib", "site-python"), + ]) + else: + sitedirs.extend([ + prefix, + os.path.join(prefix, "lib", "site-packages"), + ]) + if sys.platform == 'darwin': + # for framework builds *only* we add the standard Apple + # locations. Currently only per-user, but /Library and + # /Network/Library could be added too + if 'Python.framework' in prefix: + home = os.environ.get('HOME') + if home: + home_sp = os.path.join( + home, + 'Library', + 'Python', + '{}.{}'.format(*sys.version_info), + 'site-packages', + ) + sitedirs.append(home_sp) + lib_paths = get_path('purelib'), get_path('platlib') + for site_lib in lib_paths: + if site_lib not in sitedirs: + sitedirs.append(site_lib) + + if site.ENABLE_USER_SITE: + sitedirs.append(site.USER_SITE) + + try: + sitedirs.extend(site.getsitepackages()) + except AttributeError: + pass + + sitedirs = list(map(normalize_path, sitedirs)) + + return sitedirs + + +def expand_paths(inputs): + """Yield sys.path directories that might contain "old-style" packages""" + + seen = {} + + for dirname in inputs: + dirname = normalize_path(dirname) + if dirname in seen: + continue + + seen[dirname] = 1 + if not os.path.isdir(dirname): + continue + + files = os.listdir(dirname) + yield dirname, files + + for name in files: + if not name.endswith('.pth'): + # We only care about the .pth files + continue + if name in ('easy-install.pth', 'setuptools.pth'): + # Ignore .pth files that we control + continue + + # Read the .pth file + f = open(os.path.join(dirname, name)) + lines = list(yield_lines(f)) + f.close() + + # Yield existing non-dupe, non-import directory lines from it + for line in lines: + if not line.startswith("import"): + line = normalize_path(line.rstrip()) + if line not in seen: + seen[line] = 1 + if not os.path.isdir(line): + continue + yield line, os.listdir(line) + + +def extract_wininst_cfg(dist_filename): + """Extract configuration data from a bdist_wininst .exe + + Returns a configparser.RawConfigParser, or None + """ + f = open(dist_filename, 'rb') + try: + endrec = zipfile._EndRecData(f) + if endrec is None: + return None + + prepended = (endrec[9] - endrec[5]) - endrec[6] + if prepended < 12: # no wininst data here + return None + f.seek(prepended - 12) + + tag, cfglen, bmlen = struct.unpack("egg path translations for a given .exe file""" + + prefixes = [ + ('PURELIB/', ''), + ('PLATLIB/pywin32_system32', ''), + ('PLATLIB/', ''), + ('SCRIPTS/', 'EGG-INFO/scripts/'), + ('DATA/lib/site-packages', ''), + ] + z = zipfile.ZipFile(exe_filename) + try: + for info in z.infolist(): + name = info.filename + parts = name.split('/') + if len(parts) == 3 and parts[2] == 'PKG-INFO': + if parts[1].endswith('.egg-info'): + prefixes.insert(0, ('/'.join(parts[:2]), 'EGG-INFO/')) + break + if len(parts) != 2 or not name.endswith('.pth'): + continue + if name.endswith('-nspkg.pth'): + continue + if parts[0].upper() in ('PURELIB', 'PLATLIB'): + contents = z.read(name) + if six.PY3: + contents = contents.decode() + for pth in yield_lines(contents): + pth = pth.strip().replace('\\', '/') + if not pth.startswith('import'): + prefixes.append((('%s/%s/' % (parts[0], pth)), '')) + finally: + z.close() + prefixes = [(x.lower(), y) for x, y in prefixes] + prefixes.sort() + prefixes.reverse() + return prefixes + + +class PthDistributions(Environment): + """A .pth file with Distribution paths in it""" + + dirty = False + + def __init__(self, filename, sitedirs=()): + self.filename = filename + self.sitedirs = list(map(normalize_path, sitedirs)) + self.basedir = normalize_path(os.path.dirname(self.filename)) + self._load() + Environment.__init__(self, [], None, None) + for path in yield_lines(self.paths): + list(map(self.add, find_distributions(path, True))) + + def _load(self): + self.paths = [] + saw_import = False + seen = dict.fromkeys(self.sitedirs) + if os.path.isfile(self.filename): + f = open(self.filename, 'rt') + for line in f: + if line.startswith('import'): + saw_import = True + continue + path = line.rstrip() + self.paths.append(path) + if not path.strip() or path.strip().startswith('#'): + continue + # skip non-existent paths, in case somebody deleted a package + # manually, and duplicate paths as well + path = self.paths[-1] = normalize_path( + os.path.join(self.basedir, path) + ) + if not os.path.exists(path) or path in seen: + self.paths.pop() # skip it + self.dirty = True # we cleaned up, so we're dirty now :) + continue + seen[path] = 1 + f.close() + + if self.paths and not saw_import: + self.dirty = True # ensure anything we touch has import wrappers + while self.paths and not self.paths[-1].strip(): + self.paths.pop() + + def save(self): + """Write changed .pth file back to disk""" + if not self.dirty: + return + + rel_paths = list(map(self.make_relative, self.paths)) + if rel_paths: + log.debug("Saving %s", self.filename) + lines = self._wrap_lines(rel_paths) + data = '\n'.join(lines) + '\n' + + if os.path.islink(self.filename): + os.unlink(self.filename) + with open(self.filename, 'wt') as f: + f.write(data) + + elif os.path.exists(self.filename): + log.debug("Deleting empty %s", self.filename) + os.unlink(self.filename) + + self.dirty = False + + @staticmethod + def _wrap_lines(lines): + return lines + + def add(self, dist): + """Add `dist` to the distribution map""" + new_path = ( + dist.location not in self.paths and ( + dist.location not in self.sitedirs or + # account for '.' being in PYTHONPATH + dist.location == os.getcwd() + ) + ) + if new_path: + self.paths.append(dist.location) + self.dirty = True + Environment.add(self, dist) + + def remove(self, dist): + """Remove `dist` from the distribution map""" + while dist.location in self.paths: + self.paths.remove(dist.location) + self.dirty = True + Environment.remove(self, dist) + + def make_relative(self, path): + npath, last = os.path.split(normalize_path(path)) + baselen = len(self.basedir) + parts = [last] + sep = os.altsep == '/' and '/' or os.sep + while len(npath) >= baselen: + if npath == self.basedir: + parts.append(os.curdir) + parts.reverse() + return sep.join(parts) + npath, last = os.path.split(npath) + parts.append(last) + else: + return path + + +class RewritePthDistributions(PthDistributions): + @classmethod + def _wrap_lines(cls, lines): + yield cls.prelude + for line in lines: + yield line + yield cls.postlude + + prelude = _one_liner(""" + import sys + sys.__plen = len(sys.path) + """) + postlude = _one_liner(""" + import sys + new = sys.path[sys.__plen:] + del sys.path[sys.__plen:] + p = getattr(sys, '__egginsert', 0) + sys.path[p:p] = new + sys.__egginsert = p + len(new) + """) + + +if os.environ.get('SETUPTOOLS_SYS_PATH_TECHNIQUE', 'raw') == 'rewrite': + PthDistributions = RewritePthDistributions + + +def _first_line_re(): + """ + Return a regular expression based on first_line_re suitable for matching + strings. + """ + if isinstance(first_line_re.pattern, str): + return first_line_re + + # first_line_re in Python >=3.1.4 and >=3.2.1 is a bytes pattern. + return re.compile(first_line_re.pattern.decode()) + + +def auto_chmod(func, arg, exc): + if func in [os.unlink, os.remove] and os.name == 'nt': + chmod(arg, stat.S_IWRITE) + return func(arg) + et, ev, _ = sys.exc_info() + six.reraise(et, (ev[0], ev[1] + (" %s %s" % (func, arg)))) + + +def update_dist_caches(dist_path, fix_zipimporter_caches): + """ + Fix any globally cached `dist_path` related data + + `dist_path` should be a path of a newly installed egg distribution (zipped + or unzipped). + + sys.path_importer_cache contains finder objects that have been cached when + importing data from the original distribution. Any such finders need to be + cleared since the replacement distribution might be packaged differently, + e.g. a zipped egg distribution might get replaced with an unzipped egg + folder or vice versa. Having the old finders cached may then cause Python + to attempt loading modules from the replacement distribution using an + incorrect loader. + + zipimport.zipimporter objects are Python loaders charged with importing + data packaged inside zip archives. If stale loaders referencing the + original distribution, are left behind, they can fail to load modules from + the replacement distribution. E.g. if an old zipimport.zipimporter instance + is used to load data from a new zipped egg archive, it may cause the + operation to attempt to locate the requested data in the wrong location - + one indicated by the original distribution's zip archive directory + information. Such an operation may then fail outright, e.g. report having + read a 'bad local file header', or even worse, it may fail silently & + return invalid data. + + zipimport._zip_directory_cache contains cached zip archive directory + information for all existing zipimport.zipimporter instances and all such + instances connected to the same archive share the same cached directory + information. + + If asked, and the underlying Python implementation allows it, we can fix + all existing zipimport.zipimporter instances instead of having to track + them down and remove them one by one, by updating their shared cached zip + archive directory information. This, of course, assumes that the + replacement distribution is packaged as a zipped egg. + + If not asked to fix existing zipimport.zipimporter instances, we still do + our best to clear any remaining zipimport.zipimporter related cached data + that might somehow later get used when attempting to load data from the new + distribution and thus cause such load operations to fail. Note that when + tracking down such remaining stale data, we can not catch every conceivable + usage from here, and we clear only those that we know of and have found to + cause problems if left alive. Any remaining caches should be updated by + whomever is in charge of maintaining them, i.e. they should be ready to + handle us replacing their zip archives with new distributions at runtime. + + """ + # There are several other known sources of stale zipimport.zipimporter + # instances that we do not clear here, but might if ever given a reason to + # do so: + # * Global setuptools pkg_resources.working_set (a.k.a. 'master working + # set') may contain distributions which may in turn contain their + # zipimport.zipimporter loaders. + # * Several zipimport.zipimporter loaders held by local variables further + # up the function call stack when running the setuptools installation. + # * Already loaded modules may have their __loader__ attribute set to the + # exact loader instance used when importing them. Python 3.4 docs state + # that this information is intended mostly for introspection and so is + # not expected to cause us problems. + normalized_path = normalize_path(dist_path) + _uncache(normalized_path, sys.path_importer_cache) + if fix_zipimporter_caches: + _replace_zip_directory_cache_data(normalized_path) + else: + # Here, even though we do not want to fix existing and now stale + # zipimporter cache information, we still want to remove it. Related to + # Python's zip archive directory information cache, we clear each of + # its stale entries in two phases: + # 1. Clear the entry so attempting to access zip archive information + # via any existing stale zipimport.zipimporter instances fails. + # 2. Remove the entry from the cache so any newly constructed + # zipimport.zipimporter instances do not end up using old stale + # zip archive directory information. + # This whole stale data removal step does not seem strictly necessary, + # but has been left in because it was done before we started replacing + # the zip archive directory information cache content if possible, and + # there are no relevant unit tests that we can depend on to tell us if + # this is really needed. + _remove_and_clear_zip_directory_cache_data(normalized_path) + + +def _collect_zipimporter_cache_entries(normalized_path, cache): + """ + Return zipimporter cache entry keys related to a given normalized path. + + Alternative path spellings (e.g. those using different character case or + those using alternative path separators) related to the same path are + included. Any sub-path entries are included as well, i.e. those + corresponding to zip archives embedded in other zip archives. + + """ + result = [] + prefix_len = len(normalized_path) + for p in cache: + np = normalize_path(p) + if (np.startswith(normalized_path) and + np[prefix_len:prefix_len + 1] in (os.sep, '')): + result.append(p) + return result + + +def _update_zipimporter_cache(normalized_path, cache, updater=None): + """ + Update zipimporter cache data for a given normalized path. + + Any sub-path entries are processed as well, i.e. those corresponding to zip + archives embedded in other zip archives. + + Given updater is a callable taking a cache entry key and the original entry + (after already removing the entry from the cache), and expected to update + the entry and possibly return a new one to be inserted in its place. + Returning None indicates that the entry should not be replaced with a new + one. If no updater is given, the cache entries are simply removed without + any additional processing, the same as if the updater simply returned None. + + """ + for p in _collect_zipimporter_cache_entries(normalized_path, cache): + # N.B. pypy's custom zipimport._zip_directory_cache implementation does + # not support the complete dict interface: + # * Does not support item assignment, thus not allowing this function + # to be used only for removing existing cache entries. + # * Does not support the dict.pop() method, forcing us to use the + # get/del patterns instead. For more detailed information see the + # following links: + # https://github.com/pypa/setuptools/issues/202#issuecomment-202913420 + # http://bit.ly/2h9itJX + old_entry = cache[p] + del cache[p] + new_entry = updater and updater(p, old_entry) + if new_entry is not None: + cache[p] = new_entry + + +def _uncache(normalized_path, cache): + _update_zipimporter_cache(normalized_path, cache) + + +def _remove_and_clear_zip_directory_cache_data(normalized_path): + def clear_and_remove_cached_zip_archive_directory_data(path, old_entry): + old_entry.clear() + + _update_zipimporter_cache( + normalized_path, zipimport._zip_directory_cache, + updater=clear_and_remove_cached_zip_archive_directory_data) + + +# PyPy Python implementation does not allow directly writing to the +# zipimport._zip_directory_cache and so prevents us from attempting to correct +# its content. The best we can do there is clear the problematic cache content +# and have PyPy repopulate it as needed. The downside is that if there are any +# stale zipimport.zipimporter instances laying around, attempting to use them +# will fail due to not having its zip archive directory information available +# instead of being automatically corrected to use the new correct zip archive +# directory information. +if '__pypy__' in sys.builtin_module_names: + _replace_zip_directory_cache_data = \ + _remove_and_clear_zip_directory_cache_data +else: + + def _replace_zip_directory_cache_data(normalized_path): + def replace_cached_zip_archive_directory_data(path, old_entry): + # N.B. In theory, we could load the zip directory information just + # once for all updated path spellings, and then copy it locally and + # update its contained path strings to contain the correct + # spelling, but that seems like a way too invasive move (this cache + # structure is not officially documented anywhere and could in + # theory change with new Python releases) for no significant + # benefit. + old_entry.clear() + zipimport.zipimporter(path) + old_entry.update(zipimport._zip_directory_cache[path]) + return old_entry + + _update_zipimporter_cache( + normalized_path, zipimport._zip_directory_cache, + updater=replace_cached_zip_archive_directory_data) + + +def is_python(text, filename=''): + "Is this string a valid Python script?" + try: + compile(text, filename, 'exec') + except (SyntaxError, TypeError): + return False + else: + return True + + +def is_sh(executable): + """Determine if the specified executable is a .sh (contains a #! line)""" + try: + with io.open(executable, encoding='latin-1') as fp: + magic = fp.read(2) + except (OSError, IOError): + return executable + return magic == '#!' + + +def nt_quote_arg(arg): + """Quote a command line argument according to Windows parsing rules""" + return subprocess.list2cmdline([arg]) + + +def is_python_script(script_text, filename): + """Is this text, as a whole, a Python script? (as opposed to shell/bat/etc. + """ + if filename.endswith('.py') or filename.endswith('.pyw'): + return True # extension says it's Python + if is_python(script_text, filename): + return True # it's syntactically valid Python + if script_text.startswith('#!'): + # It begins with a '#!' line, so check if 'python' is in it somewhere + return 'python' in script_text.splitlines()[0].lower() + + return False # Not any Python I can recognize + + +try: + from os import chmod as _chmod +except ImportError: + # Jython compatibility + def _chmod(*args): + pass + + +def chmod(path, mode): + log.debug("changing mode of %s to %o", path, mode) + try: + _chmod(path, mode) + except os.error as e: + log.debug("chmod failed: %s", e) + + +class CommandSpec(list): + """ + A command spec for a #! header, specified as a list of arguments akin to + those passed to Popen. + """ + + options = [] + split_args = dict() + + @classmethod + def best(cls): + """ + Choose the best CommandSpec class based on environmental conditions. + """ + return cls + + @classmethod + def _sys_executable(cls): + _default = os.path.normpath(sys.executable) + return os.environ.get('__PYVENV_LAUNCHER__', _default) + + @classmethod + def from_param(cls, param): + """ + Construct a CommandSpec from a parameter to build_scripts, which may + be None. + """ + if isinstance(param, cls): + return param + if isinstance(param, list): + return cls(param) + if param is None: + return cls.from_environment() + # otherwise, assume it's a string. + return cls.from_string(param) + + @classmethod + def from_environment(cls): + return cls([cls._sys_executable()]) + + @classmethod + def from_string(cls, string): + """ + Construct a command spec from a simple string representing a command + line parseable by shlex.split. + """ + items = shlex.split(string, **cls.split_args) + return cls(items) + + def install_options(self, script_text): + self.options = shlex.split(self._extract_options(script_text)) + cmdline = subprocess.list2cmdline(self) + if not isascii(cmdline): + self.options[:0] = ['-x'] + + @staticmethod + def _extract_options(orig_script): + """ + Extract any options from the first line of the script. + """ + first = (orig_script + '\n').splitlines()[0] + match = _first_line_re().match(first) + options = match.group(1) or '' if match else '' + return options.strip() + + def as_header(self): + return self._render(self + list(self.options)) + + @staticmethod + def _strip_quotes(item): + _QUOTES = '"\'' + for q in _QUOTES: + if item.startswith(q) and item.endswith(q): + return item[1:-1] + return item + + @staticmethod + def _render(items): + cmdline = subprocess.list2cmdline( + CommandSpec._strip_quotes(item.strip()) for item in items) + return '#!' + cmdline + '\n' + + +# For pbr compat; will be removed in a future version. +sys_executable = CommandSpec._sys_executable() + + +class WindowsCommandSpec(CommandSpec): + split_args = dict(posix=False) + + +class ScriptWriter: + """ + Encapsulates behavior around writing entry point scripts for console and + gui apps. + """ + + template = textwrap.dedent(r""" + # EASY-INSTALL-ENTRY-SCRIPT: %(spec)r,%(group)r,%(name)r + __requires__ = %(spec)r + import re + import sys + from pkg_resources import load_entry_point + + if __name__ == '__main__': + sys.argv[0] = re.sub(r'(-script\.pyw?|\.exe)?$', '', sys.argv[0]) + sys.exit( + load_entry_point(%(spec)r, %(group)r, %(name)r)() + ) + """).lstrip() + + command_spec_class = CommandSpec + + @classmethod + def get_script_args(cls, dist, executable=None, wininst=False): + # for backward compatibility + warnings.warn("Use get_args", EasyInstallDeprecationWarning) + writer = (WindowsScriptWriter if wininst else ScriptWriter).best() + header = cls.get_script_header("", executable, wininst) + return writer.get_args(dist, header) + + @classmethod + def get_script_header(cls, script_text, executable=None, wininst=False): + # for backward compatibility + warnings.warn("Use get_header", EasyInstallDeprecationWarning, stacklevel=2) + if wininst: + executable = "python.exe" + return cls.get_header(script_text, executable) + + @classmethod + def get_args(cls, dist, header=None): + """ + Yield write_script() argument tuples for a distribution's + console_scripts and gui_scripts entry points. + """ + if header is None: + header = cls.get_header() + spec = str(dist.as_requirement()) + for type_ in 'console', 'gui': + group = type_ + '_scripts' + for name, ep in dist.get_entry_map(group).items(): + cls._ensure_safe_name(name) + script_text = cls.template % locals() + args = cls._get_script_args(type_, name, header, script_text) + for res in args: + yield res + + @staticmethod + def _ensure_safe_name(name): + """ + Prevent paths in *_scripts entry point names. + """ + has_path_sep = re.search(r'[\\/]', name) + if has_path_sep: + raise ValueError("Path separators not allowed in script names") + + @classmethod + def get_writer(cls, force_windows): + # for backward compatibility + warnings.warn("Use best", EasyInstallDeprecationWarning) + return WindowsScriptWriter.best() if force_windows else cls.best() + + @classmethod + def best(cls): + """ + Select the best ScriptWriter for this environment. + """ + if sys.platform == 'win32' or (os.name == 'java' and os._name == 'nt'): + return WindowsScriptWriter.best() + else: + return cls + + @classmethod + def _get_script_args(cls, type_, name, header, script_text): + # Simply write the stub with no extension. + yield (name, header + script_text) + + @classmethod + def get_header(cls, script_text="", executable=None): + """Create a #! line, getting options (if any) from script_text""" + cmd = cls.command_spec_class.best().from_param(executable) + cmd.install_options(script_text) + return cmd.as_header() + + +class WindowsScriptWriter(ScriptWriter): + command_spec_class = WindowsCommandSpec + + @classmethod + def get_writer(cls): + # for backward compatibility + warnings.warn("Use best", EasyInstallDeprecationWarning) + return cls.best() + + @classmethod + def best(cls): + """ + Select the best ScriptWriter suitable for Windows + """ + writer_lookup = dict( + executable=WindowsExecutableLauncherWriter, + natural=cls, + ) + # for compatibility, use the executable launcher by default + launcher = os.environ.get('SETUPTOOLS_LAUNCHER', 'executable') + return writer_lookup[launcher] + + @classmethod + def _get_script_args(cls, type_, name, header, script_text): + "For Windows, add a .py extension" + ext = dict(console='.pya', gui='.pyw')[type_] + if ext not in os.environ['PATHEXT'].lower().split(';'): + msg = ( + "{ext} not listed in PATHEXT; scripts will not be " + "recognized as executables." + ).format(**locals()) + warnings.warn(msg, UserWarning) + old = ['.pya', '.py', '-script.py', '.pyc', '.pyo', '.pyw', '.exe'] + old.remove(ext) + header = cls._adjust_header(type_, header) + blockers = [name + x for x in old] + yield name + ext, header + script_text, 't', blockers + + @classmethod + def _adjust_header(cls, type_, orig_header): + """ + Make sure 'pythonw' is used for gui and and 'python' is used for + console (regardless of what sys.executable is). + """ + pattern = 'pythonw.exe' + repl = 'python.exe' + if type_ == 'gui': + pattern, repl = repl, pattern + pattern_ob = re.compile(re.escape(pattern), re.IGNORECASE) + new_header = pattern_ob.sub(string=orig_header, repl=repl) + return new_header if cls._use_header(new_header) else orig_header + + @staticmethod + def _use_header(new_header): + """ + Should _adjust_header use the replaced header? + + On non-windows systems, always use. On + Windows systems, only use the replaced header if it resolves + to an executable on the system. + """ + clean_header = new_header[2:-1].strip('"') + return sys.platform != 'win32' or find_executable(clean_header) + + +class WindowsExecutableLauncherWriter(WindowsScriptWriter): + @classmethod + def _get_script_args(cls, type_, name, header, script_text): + """ + For Windows, add a .py extension and an .exe launcher + """ + if type_ == 'gui': + launcher_type = 'gui' + ext = '-script.pyw' + old = ['.pyw'] + else: + launcher_type = 'cli' + ext = '-script.py' + old = ['.py', '.pyc', '.pyo'] + hdr = cls._adjust_header(type_, header) + blockers = [name + x for x in old] + yield (name + ext, hdr + script_text, 't', blockers) + yield ( + name + '.exe', get_win_launcher(launcher_type), + 'b' # write in binary mode + ) + if not is_64bit(): + # install a manifest for the launcher to prevent Windows + # from detecting it as an installer (which it will for + # launchers like easy_install.exe). Consider only + # adding a manifest for launchers detected as installers. + # See Distribute #143 for details. + m_name = name + '.exe.manifest' + yield (m_name, load_launcher_manifest(name), 't') + + +# for backward-compatibility +get_script_args = ScriptWriter.get_script_args +get_script_header = ScriptWriter.get_script_header + + +def get_win_launcher(type): + """ + Load the Windows launcher (executable) suitable for launching a script. + + `type` should be either 'cli' or 'gui' + + Returns the executable as a byte string. + """ + launcher_fn = '%s.exe' % type + if is_64bit(): + launcher_fn = launcher_fn.replace(".", "-64.") + else: + launcher_fn = launcher_fn.replace(".", "-32.") + return resource_string('setuptools', launcher_fn) + + +def load_launcher_manifest(name): + manifest = pkg_resources.resource_string(__name__, 'launcher manifest.xml') + if six.PY2: + return manifest % vars() + else: + return manifest.decode('utf-8') % vars() + + +def rmtree(path, ignore_errors=False, onerror=auto_chmod): + return shutil.rmtree(path, ignore_errors, onerror) + + +def current_umask(): + tmp = os.umask(0o022) + os.umask(tmp) + return tmp + + +def bootstrap(): + # This function is called when setuptools*.egg is run using /bin/sh + import setuptools + + argv0 = os.path.dirname(setuptools.__path__[0]) + sys.argv[0] = argv0 + sys.argv.append(argv0) + main() + + +def main(argv=None, **kw): + from setuptools import setup + from setuptools.dist import Distribution + + class DistributionWithoutHelpCommands(Distribution): + common_usage = "" + + def _show_help(self, *args, **kw): + with _patch_usage(): + Distribution._show_help(self, *args, **kw) + + if argv is None: + argv = sys.argv[1:] + + with _patch_usage(): + setup( + script_args=['-q', 'easy_install', '-v'] + argv, + script_name=sys.argv[0] or 'easy_install', + distclass=DistributionWithoutHelpCommands, + **kw + ) + + +@contextlib.contextmanager +def _patch_usage(): + import distutils.core + USAGE = textwrap.dedent(""" + usage: %(script)s [options] requirement_or_url ... + or: %(script)s --help + """).lstrip() + + def gen_usage(script_name): + return USAGE % dict( + script=os.path.basename(script_name), + ) + + saved = distutils.core.gen_usage + distutils.core.gen_usage = gen_usage + try: + yield + finally: + distutils.core.gen_usage = saved + +class EasyInstallDeprecationWarning(SetuptoolsDeprecationWarning): + """Class for warning about deprecations in EasyInstall in SetupTools. Not ignored by default, unlike DeprecationWarning.""" + diff --git a/venv/lib/python3.8/site-packages/setuptools/command/egg_info.py b/venv/lib/python3.8/site-packages/setuptools/command/egg_info.py new file mode 100644 index 000000000..b767ef31d --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/command/egg_info.py @@ -0,0 +1,717 @@ +"""setuptools.command.egg_info + +Create a distribution's .egg-info directory and contents""" + +from distutils.filelist import FileList as _FileList +from distutils.errors import DistutilsInternalError +from distutils.util import convert_path +from distutils import log +import distutils.errors +import distutils.filelist +import os +import re +import sys +import io +import warnings +import time +import collections + +from setuptools.extern import six +from setuptools.extern.six.moves import map + +from setuptools import Command +from setuptools.command.sdist import sdist +from setuptools.command.sdist import walk_revctrl +from setuptools.command.setopt import edit_config +from setuptools.command import bdist_egg +from pkg_resources import ( + parse_requirements, safe_name, parse_version, + safe_version, yield_lines, EntryPoint, iter_entry_points, to_filename) +import setuptools.unicode_utils as unicode_utils +from setuptools.glob import glob + +from setuptools.extern import packaging +from setuptools import SetuptoolsDeprecationWarning + +def translate_pattern(glob): + """ + Translate a file path glob like '*.txt' in to a regular expression. + This differs from fnmatch.translate which allows wildcards to match + directory separators. It also knows about '**/' which matches any number of + directories. + """ + pat = '' + + # This will split on '/' within [character classes]. This is deliberate. + chunks = glob.split(os.path.sep) + + sep = re.escape(os.sep) + valid_char = '[^%s]' % (sep,) + + for c, chunk in enumerate(chunks): + last_chunk = c == len(chunks) - 1 + + # Chunks that are a literal ** are globstars. They match anything. + if chunk == '**': + if last_chunk: + # Match anything if this is the last component + pat += '.*' + else: + # Match '(name/)*' + pat += '(?:%s+%s)*' % (valid_char, sep) + continue # Break here as the whole path component has been handled + + # Find any special characters in the remainder + i = 0 + chunk_len = len(chunk) + while i < chunk_len: + char = chunk[i] + if char == '*': + # Match any number of name characters + pat += valid_char + '*' + elif char == '?': + # Match a name character + pat += valid_char + elif char == '[': + # Character class + inner_i = i + 1 + # Skip initial !/] chars + if inner_i < chunk_len and chunk[inner_i] == '!': + inner_i = inner_i + 1 + if inner_i < chunk_len and chunk[inner_i] == ']': + inner_i = inner_i + 1 + + # Loop till the closing ] is found + while inner_i < chunk_len and chunk[inner_i] != ']': + inner_i = inner_i + 1 + + if inner_i >= chunk_len: + # Got to the end of the string without finding a closing ] + # Do not treat this as a matching group, but as a literal [ + pat += re.escape(char) + else: + # Grab the insides of the [brackets] + inner = chunk[i + 1:inner_i] + char_class = '' + + # Class negation + if inner[0] == '!': + char_class = '^' + inner = inner[1:] + + char_class += re.escape(inner) + pat += '[%s]' % (char_class,) + + # Skip to the end ] + i = inner_i + else: + pat += re.escape(char) + i += 1 + + # Join each chunk with the dir separator + if not last_chunk: + pat += sep + + pat += r'\Z' + return re.compile(pat, flags=re.MULTILINE|re.DOTALL) + + +class InfoCommon: + tag_build = None + tag_date = None + + @property + def name(self): + return safe_name(self.distribution.get_name()) + + def tagged_version(self): + version = self.distribution.get_version() + # egg_info may be called more than once for a distribution, + # in which case the version string already contains all tags. + if self.vtags and version.endswith(self.vtags): + return safe_version(version) + return safe_version(version + self.vtags) + + def tags(self): + version = '' + if self.tag_build: + version += self.tag_build + if self.tag_date: + version += time.strftime("-%Y%m%d") + return version + vtags = property(tags) + + +class egg_info(InfoCommon, Command): + description = "create a distribution's .egg-info directory" + + user_options = [ + ('egg-base=', 'e', "directory containing .egg-info directories" + " (default: top of the source tree)"), + ('tag-date', 'd', "Add date stamp (e.g. 20050528) to version number"), + ('tag-build=', 'b', "Specify explicit tag to add to version number"), + ('no-date', 'D', "Don't include date stamp [default]"), + ] + + boolean_options = ['tag-date'] + negative_opt = { + 'no-date': 'tag-date', + } + + def initialize_options(self): + self.egg_base = None + self.egg_name = None + self.egg_info = None + self.egg_version = None + self.broken_egg_info = False + + #################################### + # allow the 'tag_svn_revision' to be detected and + # set, supporting sdists built on older Setuptools. + @property + def tag_svn_revision(self): + pass + + @tag_svn_revision.setter + def tag_svn_revision(self, value): + pass + #################################### + + def save_version_info(self, filename): + """ + Materialize the value of date into the + build tag. Install build keys in a deterministic order + to avoid arbitrary reordering on subsequent builds. + """ + egg_info = collections.OrderedDict() + # follow the order these keys would have been added + # when PYTHONHASHSEED=0 + egg_info['tag_build'] = self.tags() + egg_info['tag_date'] = 0 + edit_config(filename, dict(egg_info=egg_info)) + + def finalize_options(self): + # Note: we need to capture the current value returned + # by `self.tagged_version()`, so we can later update + # `self.distribution.metadata.version` without + # repercussions. + self.egg_name = self.name + self.egg_version = self.tagged_version() + parsed_version = parse_version(self.egg_version) + + try: + is_version = isinstance(parsed_version, packaging.version.Version) + spec = ( + "%s==%s" if is_version else "%s===%s" + ) + list( + parse_requirements(spec % (self.egg_name, self.egg_version)) + ) + except ValueError: + raise distutils.errors.DistutilsOptionError( + "Invalid distribution name or version syntax: %s-%s" % + (self.egg_name, self.egg_version) + ) + + if self.egg_base is None: + dirs = self.distribution.package_dir + self.egg_base = (dirs or {}).get('', os.curdir) + + self.ensure_dirname('egg_base') + self.egg_info = to_filename(self.egg_name) + '.egg-info' + if self.egg_base != os.curdir: + self.egg_info = os.path.join(self.egg_base, self.egg_info) + if '-' in self.egg_name: + self.check_broken_egg_info() + + # Set package version for the benefit of dumber commands + # (e.g. sdist, bdist_wininst, etc.) + # + self.distribution.metadata.version = self.egg_version + + # If we bootstrapped around the lack of a PKG-INFO, as might be the + # case in a fresh checkout, make sure that any special tags get added + # to the version info + # + pd = self.distribution._patched_dist + if pd is not None and pd.key == self.egg_name.lower(): + pd._version = self.egg_version + pd._parsed_version = parse_version(self.egg_version) + self.distribution._patched_dist = None + + def write_or_delete_file(self, what, filename, data, force=False): + """Write `data` to `filename` or delete if empty + + If `data` is non-empty, this routine is the same as ``write_file()``. + If `data` is empty but not ``None``, this is the same as calling + ``delete_file(filename)`. If `data` is ``None``, then this is a no-op + unless `filename` exists, in which case a warning is issued about the + orphaned file (if `force` is false), or deleted (if `force` is true). + """ + if data: + self.write_file(what, filename, data) + elif os.path.exists(filename): + if data is None and not force: + log.warn( + "%s not set in setup(), but %s exists", what, filename + ) + return + else: + self.delete_file(filename) + + def write_file(self, what, filename, data): + """Write `data` to `filename` (if not a dry run) after announcing it + + `what` is used in a log message to identify what is being written + to the file. + """ + log.info("writing %s to %s", what, filename) + if six.PY3: + data = data.encode("utf-8") + if not self.dry_run: + f = open(filename, 'wb') + f.write(data) + f.close() + + def delete_file(self, filename): + """Delete `filename` (if not a dry run) after announcing it""" + log.info("deleting %s", filename) + if not self.dry_run: + os.unlink(filename) + + def run(self): + self.mkpath(self.egg_info) + os.utime(self.egg_info, None) + installer = self.distribution.fetch_build_egg + for ep in iter_entry_points('egg_info.writers'): + ep.require(installer=installer) + writer = ep.resolve() + writer(self, ep.name, os.path.join(self.egg_info, ep.name)) + + # Get rid of native_libs.txt if it was put there by older bdist_egg + nl = os.path.join(self.egg_info, "native_libs.txt") + if os.path.exists(nl): + self.delete_file(nl) + + self.find_sources() + + def find_sources(self): + """Generate SOURCES.txt manifest file""" + manifest_filename = os.path.join(self.egg_info, "SOURCES.txt") + mm = manifest_maker(self.distribution) + mm.manifest = manifest_filename + mm.run() + self.filelist = mm.filelist + + def check_broken_egg_info(self): + bei = self.egg_name + '.egg-info' + if self.egg_base != os.curdir: + bei = os.path.join(self.egg_base, bei) + if os.path.exists(bei): + log.warn( + "-" * 78 + '\n' + "Note: Your current .egg-info directory has a '-' in its name;" + '\nthis will not work correctly with "setup.py develop".\n\n' + 'Please rename %s to %s to correct this problem.\n' + '-' * 78, + bei, self.egg_info + ) + self.broken_egg_info = self.egg_info + self.egg_info = bei # make it work for now + + +class FileList(_FileList): + # Implementations of the various MANIFEST.in commands + + def process_template_line(self, line): + # Parse the line: split it up, make sure the right number of words + # is there, and return the relevant words. 'action' is always + # defined: it's the first word of the line. Which of the other + # three are defined depends on the action; it'll be either + # patterns, (dir and patterns), or (dir_pattern). + (action, patterns, dir, dir_pattern) = self._parse_template_line(line) + + # OK, now we know that the action is valid and we have the + # right number of words on the line for that action -- so we + # can proceed with minimal error-checking. + if action == 'include': + self.debug_print("include " + ' '.join(patterns)) + for pattern in patterns: + if not self.include(pattern): + log.warn("warning: no files found matching '%s'", pattern) + + elif action == 'exclude': + self.debug_print("exclude " + ' '.join(patterns)) + for pattern in patterns: + if not self.exclude(pattern): + log.warn(("warning: no previously-included files " + "found matching '%s'"), pattern) + + elif action == 'global-include': + self.debug_print("global-include " + ' '.join(patterns)) + for pattern in patterns: + if not self.global_include(pattern): + log.warn(("warning: no files found matching '%s' " + "anywhere in distribution"), pattern) + + elif action == 'global-exclude': + self.debug_print("global-exclude " + ' '.join(patterns)) + for pattern in patterns: + if not self.global_exclude(pattern): + log.warn(("warning: no previously-included files matching " + "'%s' found anywhere in distribution"), + pattern) + + elif action == 'recursive-include': + self.debug_print("recursive-include %s %s" % + (dir, ' '.join(patterns))) + for pattern in patterns: + if not self.recursive_include(dir, pattern): + log.warn(("warning: no files found matching '%s' " + "under directory '%s'"), + pattern, dir) + + elif action == 'recursive-exclude': + self.debug_print("recursive-exclude %s %s" % + (dir, ' '.join(patterns))) + for pattern in patterns: + if not self.recursive_exclude(dir, pattern): + log.warn(("warning: no previously-included files matching " + "'%s' found under directory '%s'"), + pattern, dir) + + elif action == 'graft': + self.debug_print("graft " + dir_pattern) + if not self.graft(dir_pattern): + log.warn("warning: no directories found matching '%s'", + dir_pattern) + + elif action == 'prune': + self.debug_print("prune " + dir_pattern) + if not self.prune(dir_pattern): + log.warn(("no previously-included directories found " + "matching '%s'"), dir_pattern) + + else: + raise DistutilsInternalError( + "this cannot happen: invalid action '%s'" % action) + + def _remove_files(self, predicate): + """ + Remove all files from the file list that match the predicate. + Return True if any matching files were removed + """ + found = False + for i in range(len(self.files) - 1, -1, -1): + if predicate(self.files[i]): + self.debug_print(" removing " + self.files[i]) + del self.files[i] + found = True + return found + + def include(self, pattern): + """Include files that match 'pattern'.""" + found = [f for f in glob(pattern) if not os.path.isdir(f)] + self.extend(found) + return bool(found) + + def exclude(self, pattern): + """Exclude files that match 'pattern'.""" + match = translate_pattern(pattern) + return self._remove_files(match.match) + + def recursive_include(self, dir, pattern): + """ + Include all files anywhere in 'dir/' that match the pattern. + """ + full_pattern = os.path.join(dir, '**', pattern) + found = [f for f in glob(full_pattern, recursive=True) + if not os.path.isdir(f)] + self.extend(found) + return bool(found) + + def recursive_exclude(self, dir, pattern): + """ + Exclude any file anywhere in 'dir/' that match the pattern. + """ + match = translate_pattern(os.path.join(dir, '**', pattern)) + return self._remove_files(match.match) + + def graft(self, dir): + """Include all files from 'dir/'.""" + found = [ + item + for match_dir in glob(dir) + for item in distutils.filelist.findall(match_dir) + ] + self.extend(found) + return bool(found) + + def prune(self, dir): + """Filter out files from 'dir/'.""" + match = translate_pattern(os.path.join(dir, '**')) + return self._remove_files(match.match) + + def global_include(self, pattern): + """ + Include all files anywhere in the current directory that match the + pattern. This is very inefficient on large file trees. + """ + if self.allfiles is None: + self.findall() + match = translate_pattern(os.path.join('**', pattern)) + found = [f for f in self.allfiles if match.match(f)] + self.extend(found) + return bool(found) + + def global_exclude(self, pattern): + """ + Exclude all files anywhere that match the pattern. + """ + match = translate_pattern(os.path.join('**', pattern)) + return self._remove_files(match.match) + + def append(self, item): + if item.endswith('\r'): # Fix older sdists built on Windows + item = item[:-1] + path = convert_path(item) + + if self._safe_path(path): + self.files.append(path) + + def extend(self, paths): + self.files.extend(filter(self._safe_path, paths)) + + def _repair(self): + """ + Replace self.files with only safe paths + + Because some owners of FileList manipulate the underlying + ``files`` attribute directly, this method must be called to + repair those paths. + """ + self.files = list(filter(self._safe_path, self.files)) + + def _safe_path(self, path): + enc_warn = "'%s' not %s encodable -- skipping" + + # To avoid accidental trans-codings errors, first to unicode + u_path = unicode_utils.filesys_decode(path) + if u_path is None: + log.warn("'%s' in unexpected encoding -- skipping" % path) + return False + + # Must ensure utf-8 encodability + utf8_path = unicode_utils.try_encode(u_path, "utf-8") + if utf8_path is None: + log.warn(enc_warn, path, 'utf-8') + return False + + try: + # accept is either way checks out + if os.path.exists(u_path) or os.path.exists(utf8_path): + return True + # this will catch any encode errors decoding u_path + except UnicodeEncodeError: + log.warn(enc_warn, path, sys.getfilesystemencoding()) + + +class manifest_maker(sdist): + template = "MANIFEST.in" + + def initialize_options(self): + self.use_defaults = 1 + self.prune = 1 + self.manifest_only = 1 + self.force_manifest = 1 + + def finalize_options(self): + pass + + def run(self): + self.filelist = FileList() + if not os.path.exists(self.manifest): + self.write_manifest() # it must exist so it'll get in the list + self.add_defaults() + if os.path.exists(self.template): + self.read_template() + self.prune_file_list() + self.filelist.sort() + self.filelist.remove_duplicates() + self.write_manifest() + + def _manifest_normalize(self, path): + path = unicode_utils.filesys_decode(path) + return path.replace(os.sep, '/') + + def write_manifest(self): + """ + Write the file list in 'self.filelist' to the manifest file + named by 'self.manifest'. + """ + self.filelist._repair() + + # Now _repairs should encodability, but not unicode + files = [self._manifest_normalize(f) for f in self.filelist.files] + msg = "writing manifest file '%s'" % self.manifest + self.execute(write_file, (self.manifest, files), msg) + + def warn(self, msg): + if not self._should_suppress_warning(msg): + sdist.warn(self, msg) + + @staticmethod + def _should_suppress_warning(msg): + """ + suppress missing-file warnings from sdist + """ + return re.match(r"standard file .*not found", msg) + + def add_defaults(self): + sdist.add_defaults(self) + self.check_license() + self.filelist.append(self.template) + self.filelist.append(self.manifest) + rcfiles = list(walk_revctrl()) + if rcfiles: + self.filelist.extend(rcfiles) + elif os.path.exists(self.manifest): + self.read_manifest() + + if os.path.exists("setup.py"): + # setup.py should be included by default, even if it's not + # the script called to create the sdist + self.filelist.append("setup.py") + + ei_cmd = self.get_finalized_command('egg_info') + self.filelist.graft(ei_cmd.egg_info) + + def prune_file_list(self): + build = self.get_finalized_command('build') + base_dir = self.distribution.get_fullname() + self.filelist.prune(build.build_base) + self.filelist.prune(base_dir) + sep = re.escape(os.sep) + self.filelist.exclude_pattern(r'(^|' + sep + r')(RCS|CVS|\.svn)' + sep, + is_regex=1) + + +def write_file(filename, contents): + """Create a file with the specified name and write 'contents' (a + sequence of strings without line terminators) to it. + """ + contents = "\n".join(contents) + + # assuming the contents has been vetted for utf-8 encoding + contents = contents.encode("utf-8") + + with open(filename, "wb") as f: # always write POSIX-style manifest + f.write(contents) + + +def write_pkg_info(cmd, basename, filename): + log.info("writing %s", filename) + if not cmd.dry_run: + metadata = cmd.distribution.metadata + metadata.version, oldver = cmd.egg_version, metadata.version + metadata.name, oldname = cmd.egg_name, metadata.name + + try: + # write unescaped data to PKG-INFO, so older pkg_resources + # can still parse it + metadata.write_pkg_info(cmd.egg_info) + finally: + metadata.name, metadata.version = oldname, oldver + + safe = getattr(cmd.distribution, 'zip_safe', None) + + bdist_egg.write_safety_flag(cmd.egg_info, safe) + + +def warn_depends_obsolete(cmd, basename, filename): + if os.path.exists(filename): + log.warn( + "WARNING: 'depends.txt' is not used by setuptools 0.6!\n" + "Use the install_requires/extras_require setup() args instead." + ) + + +def _write_requirements(stream, reqs): + lines = yield_lines(reqs or ()) + append_cr = lambda line: line + '\n' + lines = map(append_cr, sorted(lines)) + stream.writelines(lines) + + +def write_requirements(cmd, basename, filename): + dist = cmd.distribution + data = six.StringIO() + _write_requirements(data, dist.install_requires) + extras_require = dist.extras_require or {} + for extra in sorted(extras_require): + data.write('\n[{extra}]\n'.format(**vars())) + _write_requirements(data, extras_require[extra]) + cmd.write_or_delete_file("requirements", filename, data.getvalue()) + + +def write_setup_requirements(cmd, basename, filename): + data = io.StringIO() + _write_requirements(data, cmd.distribution.setup_requires) + cmd.write_or_delete_file("setup-requirements", filename, data.getvalue()) + + +def write_toplevel_names(cmd, basename, filename): + pkgs = dict.fromkeys( + [ + k.split('.', 1)[0] + for k in cmd.distribution.iter_distribution_names() + ] + ) + cmd.write_file("top-level names", filename, '\n'.join(sorted(pkgs)) + '\n') + + +def overwrite_arg(cmd, basename, filename): + write_arg(cmd, basename, filename, True) + + +def write_arg(cmd, basename, filename, force=False): + argname = os.path.splitext(basename)[0] + value = getattr(cmd.distribution, argname, None) + if value is not None: + value = '\n'.join(value) + '\n' + cmd.write_or_delete_file(argname, filename, value, force) + + +def write_entries(cmd, basename, filename): + ep = cmd.distribution.entry_points + + if isinstance(ep, six.string_types) or ep is None: + data = ep + elif ep is not None: + data = [] + for section, contents in sorted(ep.items()): + if not isinstance(contents, six.string_types): + contents = EntryPoint.parse_group(section, contents) + contents = '\n'.join(sorted(map(str, contents.values()))) + data.append('[%s]\n%s\n\n' % (section, contents)) + data = ''.join(data) + + cmd.write_or_delete_file('entry points', filename, data, True) + + +def get_pkg_info_revision(): + """ + Get a -r### off of PKG-INFO Version in case this is an sdist of + a subversion revision. + """ + warnings.warn("get_pkg_info_revision is deprecated.", EggInfoDeprecationWarning) + if os.path.exists('PKG-INFO'): + with io.open('PKG-INFO') as f: + for line in f: + match = re.match(r"Version:.*-r(\d+)\s*$", line) + if match: + return int(match.group(1)) + return 0 + + +class EggInfoDeprecationWarning(SetuptoolsDeprecationWarning): + """Class for warning about deprecations in eggInfo in setupTools. Not ignored by default, unlike DeprecationWarning.""" diff --git a/venv/lib/python3.8/site-packages/setuptools/command/install.py b/venv/lib/python3.8/site-packages/setuptools/command/install.py new file mode 100644 index 000000000..72b9a3e42 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/command/install.py @@ -0,0 +1,125 @@ +from distutils.errors import DistutilsArgError +import inspect +import glob +import warnings +import platform +import distutils.command.install as orig + +import setuptools + +# Prior to numpy 1.9, NumPy relies on the '_install' name, so provide it for +# now. See https://github.com/pypa/setuptools/issues/199/ +_install = orig.install + + +class install(orig.install): + """Use easy_install to install the package, w/dependencies""" + + user_options = orig.install.user_options + [ + ('old-and-unmanageable', None, "Try not to use this!"), + ('single-version-externally-managed', None, + "used by system package builders to create 'flat' eggs"), + ] + boolean_options = orig.install.boolean_options + [ + 'old-and-unmanageable', 'single-version-externally-managed', + ] + new_commands = [ + ('install_egg_info', lambda self: True), + ('install_scripts', lambda self: True), + ] + _nc = dict(new_commands) + + def initialize_options(self): + orig.install.initialize_options(self) + self.old_and_unmanageable = None + self.single_version_externally_managed = None + + def finalize_options(self): + orig.install.finalize_options(self) + if self.root: + self.single_version_externally_managed = True + elif self.single_version_externally_managed: + if not self.root and not self.record: + raise DistutilsArgError( + "You must specify --record or --root when building system" + " packages" + ) + + def handle_extra_path(self): + if self.root or self.single_version_externally_managed: + # explicit backward-compatibility mode, allow extra_path to work + return orig.install.handle_extra_path(self) + + # Ignore extra_path when installing an egg (or being run by another + # command without --root or --single-version-externally-managed + self.path_file = None + self.extra_dirs = '' + + def run(self): + # Explicit request for old-style install? Just do it + if self.old_and_unmanageable or self.single_version_externally_managed: + return orig.install.run(self) + + if not self._called_from_setup(inspect.currentframe()): + # Run in backward-compatibility mode to support bdist_* commands. + orig.install.run(self) + else: + self.do_egg_install() + + @staticmethod + def _called_from_setup(run_frame): + """ + Attempt to detect whether run() was called from setup() or by another + command. If called by setup(), the parent caller will be the + 'run_command' method in 'distutils.dist', and *its* caller will be + the 'run_commands' method. If called any other way, the + immediate caller *might* be 'run_command', but it won't have been + called by 'run_commands'. Return True in that case or if a call stack + is unavailable. Return False otherwise. + """ + if run_frame is None: + msg = "Call stack not available. bdist_* commands may fail." + warnings.warn(msg) + if platform.python_implementation() == 'IronPython': + msg = "For best results, pass -X:Frames to enable call stack." + warnings.warn(msg) + return True + res = inspect.getouterframes(run_frame)[2] + caller, = res[:1] + info = inspect.getframeinfo(caller) + caller_module = caller.f_globals.get('__name__', '') + return ( + caller_module == 'distutils.dist' + and info.function == 'run_commands' + ) + + def do_egg_install(self): + + easy_install = self.distribution.get_command_class('easy_install') + + cmd = easy_install( + self.distribution, args="x", root=self.root, record=self.record, + ) + cmd.ensure_finalized() # finalize before bdist_egg munges install cmd + cmd.always_copy_from = '.' # make sure local-dir eggs get installed + + # pick up setup-dir .egg files only: no .egg-info + cmd.package_index.scan(glob.glob('*.egg')) + + self.run_command('bdist_egg') + args = [self.distribution.get_command_obj('bdist_egg').egg_output] + + if setuptools.bootstrap_install_from: + # Bootstrap self-installation of setuptools + args.insert(0, setuptools.bootstrap_install_from) + + cmd.args = args + cmd.run(show_deprecation=False) + setuptools.bootstrap_install_from = None + + +# XXX Python 3.1 doesn't see _nc if this is inside the class +install.sub_commands = ( + [cmd for cmd in orig.install.sub_commands if cmd[0] not in install._nc] + + install.new_commands +) diff --git a/venv/lib/python3.8/site-packages/setuptools/command/install_egg_info.py b/venv/lib/python3.8/site-packages/setuptools/command/install_egg_info.py new file mode 100644 index 000000000..5f405bcad --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/command/install_egg_info.py @@ -0,0 +1,82 @@ +from distutils import log, dir_util +import os, sys + +from setuptools import Command +from setuptools import namespaces +from setuptools.archive_util import unpack_archive +import pkg_resources + + +class install_egg_info(namespaces.Installer, Command): + """Install an .egg-info directory for the package""" + + description = "Install an .egg-info directory for the package" + + user_options = [ + ('install-dir=', 'd', "directory to install to"), + ] + + def initialize_options(self): + self.install_dir = None + self.install_layout = None + self.prefix_option = None + + def finalize_options(self): + self.set_undefined_options('install_lib', + ('install_dir', 'install_dir')) + self.set_undefined_options('install',('install_layout','install_layout')) + if sys.hexversion > 0x2060000: + self.set_undefined_options('install',('prefix_option','prefix_option')) + ei_cmd = self.get_finalized_command("egg_info") + basename = pkg_resources.Distribution( + None, None, ei_cmd.egg_name, ei_cmd.egg_version + ).egg_name() + '.egg-info' + + if self.install_layout: + if not self.install_layout.lower() in ['deb']: + raise DistutilsOptionError("unknown value for --install-layout") + self.install_layout = self.install_layout.lower() + basename = basename.replace('-py%s' % pkg_resources.PY_MAJOR, '') + elif self.prefix_option or 'real_prefix' in sys.__dict__: + # don't modify for virtualenv + pass + else: + basename = basename.replace('-py%s' % pkg_resources.PY_MAJOR, '') + + self.source = ei_cmd.egg_info + self.target = os.path.join(self.install_dir, basename) + self.outputs = [] + + def run(self): + self.run_command('egg_info') + if os.path.isdir(self.target) and not os.path.islink(self.target): + dir_util.remove_tree(self.target, dry_run=self.dry_run) + elif os.path.exists(self.target): + self.execute(os.unlink, (self.target,), "Removing " + self.target) + if not self.dry_run: + pkg_resources.ensure_directory(self.target) + self.execute( + self.copytree, (), "Copying %s to %s" % (self.source, self.target) + ) + self.install_namespaces() + + def get_outputs(self): + return self.outputs + + def copytree(self): + # Copy the .egg-info tree to site-packages + def skimmer(src, dst): + # filter out source-control directories; note that 'src' is always + # a '/'-separated path, regardless of platform. 'dst' is a + # platform-specific path. + for skip in '.svn/', 'CVS/': + if src.startswith(skip) or '/' + skip in src: + return None + if self.install_layout and self.install_layout in ['deb'] and src.startswith('SOURCES.txt'): + log.info("Skipping SOURCES.txt") + return None + self.outputs.append(dst) + log.debug("Copying %s to %s", src, dst) + return dst + + unpack_archive(self.source, self.target, skimmer) diff --git a/venv/lib/python3.8/site-packages/setuptools/command/install_lib.py b/venv/lib/python3.8/site-packages/setuptools/command/install_lib.py new file mode 100644 index 000000000..bf81519d9 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/command/install_lib.py @@ -0,0 +1,147 @@ +import os +import sys +from itertools import product, starmap +import distutils.command.install_lib as orig + + +class install_lib(orig.install_lib): + """Don't add compiled flags to filenames of non-Python files""" + + def initialize_options(self): + orig.install_lib.initialize_options(self) + self.multiarch = None + self.install_layout = None + + def finalize_options(self): + orig.install_lib.finalize_options(self) + self.set_undefined_options('install',('install_layout','install_layout')) + if self.install_layout == 'deb' and sys.version_info[:2] >= (3, 3): + import sysconfig + self.multiarch = sysconfig.get_config_var('MULTIARCH') + + def run(self): + self.build() + outfiles = self.install() + if outfiles is not None: + # always compile, in case we have any extension stubs to deal with + self.byte_compile(outfiles) + + def get_exclusions(self): + """ + Return a collections.Sized collections.Container of paths to be + excluded for single_version_externally_managed installations. + """ + all_packages = ( + pkg + for ns_pkg in self._get_SVEM_NSPs() + for pkg in self._all_packages(ns_pkg) + ) + + excl_specs = product(all_packages, self._gen_exclusion_paths()) + return set(starmap(self._exclude_pkg_path, excl_specs)) + + def _exclude_pkg_path(self, pkg, exclusion_path): + """ + Given a package name and exclusion path within that package, + compute the full exclusion path. + """ + parts = pkg.split('.') + [exclusion_path] + return os.path.join(self.install_dir, *parts) + + @staticmethod + def _all_packages(pkg_name): + """ + >>> list(install_lib._all_packages('foo.bar.baz')) + ['foo.bar.baz', 'foo.bar', 'foo'] + """ + while pkg_name: + yield pkg_name + pkg_name, sep, child = pkg_name.rpartition('.') + + def _get_SVEM_NSPs(self): + """ + Get namespace packages (list) but only for + single_version_externally_managed installations and empty otherwise. + """ + # TODO: is it necessary to short-circuit here? i.e. what's the cost + # if get_finalized_command is called even when namespace_packages is + # False? + if not self.distribution.namespace_packages: + return [] + + install_cmd = self.get_finalized_command('install') + svem = install_cmd.single_version_externally_managed + + return self.distribution.namespace_packages if svem else [] + + @staticmethod + def _gen_exclusion_paths(): + """ + Generate file paths to be excluded for namespace packages (bytecode + cache files). + """ + # always exclude the package module itself + yield '__init__.py' + + yield '__init__.pyc' + yield '__init__.pyo' + + if not hasattr(sys, 'implementation'): + return + + base = os.path.join('__pycache__', '__init__.' + sys.implementation.cache_tag) + yield base + '.pyc' + yield base + '.pyo' + yield base + '.opt-1.pyc' + yield base + '.opt-2.pyc' + + def copy_tree( + self, infile, outfile, + preserve_mode=1, preserve_times=1, preserve_symlinks=0, level=1 + ): + assert preserve_mode and preserve_times and not preserve_symlinks + exclude = self.get_exclusions() + + if not exclude: + import distutils.dir_util + distutils.dir_util._multiarch = self.multiarch + return orig.install_lib.copy_tree(self, infile, outfile) + + # Exclude namespace package __init__.py* files from the output + + from setuptools.archive_util import unpack_directory + from distutils import log + + outfiles = [] + + if self.multiarch: + import sysconfig + ext_suffix = sysconfig.get_config_var ('EXT_SUFFIX') + if ext_suffix.endswith(self.multiarch + ext_suffix[-3:]): + new_suffix = None + else: + new_suffix = "%s-%s%s" % (ext_suffix[:-3], self.multiarch, ext_suffix[-3:]) + + def pf(src, dst): + if dst in exclude: + log.warn("Skipping installation of %s (namespace package)", + dst) + return False + + if self.multiarch and new_suffix and dst.endswith(ext_suffix) and not dst.endswith(new_suffix): + dst = dst.replace(ext_suffix, new_suffix) + log.info("renaming extension to %s", os.path.basename(dst)) + + log.info("copying %s -> %s", src, os.path.dirname(dst)) + outfiles.append(dst) + return dst + + unpack_directory(infile, outfile, pf) + return outfiles + + def get_outputs(self): + outputs = orig.install_lib.get_outputs(self) + exclude = self.get_exclusions() + if exclude: + return [f for f in outputs if f not in exclude] + return outputs diff --git a/venv/lib/python3.8/site-packages/setuptools/command/install_scripts.py b/venv/lib/python3.8/site-packages/setuptools/command/install_scripts.py new file mode 100644 index 000000000..16234273a --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/command/install_scripts.py @@ -0,0 +1,65 @@ +from distutils import log +import distutils.command.install_scripts as orig +import os +import sys + +from pkg_resources import Distribution, PathMetadata, ensure_directory + + +class install_scripts(orig.install_scripts): + """Do normal script install, plus any egg_info wrapper scripts""" + + def initialize_options(self): + orig.install_scripts.initialize_options(self) + self.no_ep = False + + def run(self): + import setuptools.command.easy_install as ei + + self.run_command("egg_info") + if self.distribution.scripts: + orig.install_scripts.run(self) # run first to set up self.outfiles + else: + self.outfiles = [] + if self.no_ep: + # don't install entry point scripts into .egg file! + return + + ei_cmd = self.get_finalized_command("egg_info") + dist = Distribution( + ei_cmd.egg_base, PathMetadata(ei_cmd.egg_base, ei_cmd.egg_info), + ei_cmd.egg_name, ei_cmd.egg_version, + ) + bs_cmd = self.get_finalized_command('build_scripts') + exec_param = getattr(bs_cmd, 'executable', None) + bw_cmd = self.get_finalized_command("bdist_wininst") + is_wininst = getattr(bw_cmd, '_is_running', False) + writer = ei.ScriptWriter + if is_wininst: + exec_param = "python.exe" + writer = ei.WindowsScriptWriter + if exec_param == sys.executable: + # In case the path to the Python executable contains a space, wrap + # it so it's not split up. + exec_param = [exec_param] + # resolve the writer to the environment + writer = writer.best() + cmd = writer.command_spec_class.best().from_param(exec_param) + for args in writer.get_args(dist, cmd.as_header()): + self.write_script(*args) + + def write_script(self, script_name, contents, mode="t", *ignored): + """Write an executable file to the scripts directory""" + from setuptools.command.easy_install import chmod, current_umask + + log.info("Installing %s script to %s", script_name, self.install_dir) + target = os.path.join(self.install_dir, script_name) + self.outfiles.append(target) + + mask = current_umask() + if not self.dry_run: + ensure_directory(target) + f = open(target, "w" + mode) + f.write(contents) + f.close() + chmod(target, 0o777 - mask) diff --git a/venv/lib/python3.8/site-packages/setuptools/command/launcher manifest.xml b/venv/lib/python3.8/site-packages/setuptools/command/launcher manifest.xml new file mode 100644 index 000000000..5972a96d8 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/command/launcher manifest.xml @@ -0,0 +1,15 @@ + + + + + + + + + + + + diff --git a/venv/lib/python3.8/site-packages/setuptools/command/py36compat.py b/venv/lib/python3.8/site-packages/setuptools/command/py36compat.py new file mode 100644 index 000000000..61063e754 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/command/py36compat.py @@ -0,0 +1,136 @@ +import os +from glob import glob +from distutils.util import convert_path +from distutils.command import sdist + +from setuptools.extern.six.moves import filter + + +class sdist_add_defaults: + """ + Mix-in providing forward-compatibility for functionality as found in + distutils on Python 3.7. + + Do not edit the code in this class except to update functionality + as implemented in distutils. Instead, override in the subclass. + """ + + def add_defaults(self): + """Add all the default files to self.filelist: + - README or README.txt + - setup.py + - test/test*.py + - all pure Python modules mentioned in setup script + - all files pointed by package_data (build_py) + - all files defined in data_files. + - all files defined as scripts. + - all C sources listed as part of extensions or C libraries + in the setup script (doesn't catch C headers!) + Warns if (README or README.txt) or setup.py are missing; everything + else is optional. + """ + self._add_defaults_standards() + self._add_defaults_optional() + self._add_defaults_python() + self._add_defaults_data_files() + self._add_defaults_ext() + self._add_defaults_c_libs() + self._add_defaults_scripts() + + @staticmethod + def _cs_path_exists(fspath): + """ + Case-sensitive path existence check + + >>> sdist_add_defaults._cs_path_exists(__file__) + True + >>> sdist_add_defaults._cs_path_exists(__file__.upper()) + False + """ + if not os.path.exists(fspath): + return False + # make absolute so we always have a directory + abspath = os.path.abspath(fspath) + directory, filename = os.path.split(abspath) + return filename in os.listdir(directory) + + def _add_defaults_standards(self): + standards = [self.READMES, self.distribution.script_name] + for fn in standards: + if isinstance(fn, tuple): + alts = fn + got_it = False + for fn in alts: + if self._cs_path_exists(fn): + got_it = True + self.filelist.append(fn) + break + + if not got_it: + self.warn("standard file not found: should have one of " + + ', '.join(alts)) + else: + if self._cs_path_exists(fn): + self.filelist.append(fn) + else: + self.warn("standard file '%s' not found" % fn) + + def _add_defaults_optional(self): + optional = ['test/test*.py', 'setup.cfg'] + for pattern in optional: + files = filter(os.path.isfile, glob(pattern)) + self.filelist.extend(files) + + def _add_defaults_python(self): + # build_py is used to get: + # - python modules + # - files defined in package_data + build_py = self.get_finalized_command('build_py') + + # getting python files + if self.distribution.has_pure_modules(): + self.filelist.extend(build_py.get_source_files()) + + # getting package_data files + # (computed in build_py.data_files by build_py.finalize_options) + for pkg, src_dir, build_dir, filenames in build_py.data_files: + for filename in filenames: + self.filelist.append(os.path.join(src_dir, filename)) + + def _add_defaults_data_files(self): + # getting distribution.data_files + if self.distribution.has_data_files(): + for item in self.distribution.data_files: + if isinstance(item, str): + # plain file + item = convert_path(item) + if os.path.isfile(item): + self.filelist.append(item) + else: + # a (dirname, filenames) tuple + dirname, filenames = item + for f in filenames: + f = convert_path(f) + if os.path.isfile(f): + self.filelist.append(f) + + def _add_defaults_ext(self): + if self.distribution.has_ext_modules(): + build_ext = self.get_finalized_command('build_ext') + self.filelist.extend(build_ext.get_source_files()) + + def _add_defaults_c_libs(self): + if self.distribution.has_c_libraries(): + build_clib = self.get_finalized_command('build_clib') + self.filelist.extend(build_clib.get_source_files()) + + def _add_defaults_scripts(self): + if self.distribution.has_scripts(): + build_scripts = self.get_finalized_command('build_scripts') + self.filelist.extend(build_scripts.get_source_files()) + + +if hasattr(sdist.sdist, '_add_defaults_standards'): + # disable the functionality already available upstream + class sdist_add_defaults: + pass diff --git a/venv/lib/python3.8/site-packages/setuptools/command/register.py b/venv/lib/python3.8/site-packages/setuptools/command/register.py new file mode 100644 index 000000000..b8266b9a6 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/command/register.py @@ -0,0 +1,18 @@ +from distutils import log +import distutils.command.register as orig + +from setuptools.errors import RemovedCommandError + + +class register(orig.register): + """Formerly used to register packages on PyPI.""" + + def run(self): + msg = ( + "The register command has been removed, use twine to upload " + + "instead (https://pypi.org/p/twine)" + ) + + self.announce("ERROR: " + msg, log.ERROR) + + raise RemovedCommandError(msg) diff --git a/venv/lib/python3.8/site-packages/setuptools/command/rotate.py b/venv/lib/python3.8/site-packages/setuptools/command/rotate.py new file mode 100644 index 000000000..b89353f52 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/command/rotate.py @@ -0,0 +1,66 @@ +from distutils.util import convert_path +from distutils import log +from distutils.errors import DistutilsOptionError +import os +import shutil + +from setuptools.extern import six + +from setuptools import Command + + +class rotate(Command): + """Delete older distributions""" + + description = "delete older distributions, keeping N newest files" + user_options = [ + ('match=', 'm', "patterns to match (required)"), + ('dist-dir=', 'd', "directory where the distributions are"), + ('keep=', 'k', "number of matching distributions to keep"), + ] + + boolean_options = [] + + def initialize_options(self): + self.match = None + self.dist_dir = None + self.keep = None + + def finalize_options(self): + if self.match is None: + raise DistutilsOptionError( + "Must specify one or more (comma-separated) match patterns " + "(e.g. '.zip' or '.egg')" + ) + if self.keep is None: + raise DistutilsOptionError("Must specify number of files to keep") + try: + self.keep = int(self.keep) + except ValueError: + raise DistutilsOptionError("--keep must be an integer") + if isinstance(self.match, six.string_types): + self.match = [ + convert_path(p.strip()) for p in self.match.split(',') + ] + self.set_undefined_options('bdist', ('dist_dir', 'dist_dir')) + + def run(self): + self.run_command("egg_info") + from glob import glob + + for pattern in self.match: + pattern = self.distribution.get_name() + '*' + pattern + files = glob(os.path.join(self.dist_dir, pattern)) + files = [(os.path.getmtime(f), f) for f in files] + files.sort() + files.reverse() + + log.info("%d file(s) matching %s", len(files), pattern) + files = files[self.keep:] + for (t, f) in files: + log.info("Deleting %s", f) + if not self.dry_run: + if os.path.isdir(f): + shutil.rmtree(f) + else: + os.unlink(f) diff --git a/venv/lib/python3.8/site-packages/setuptools/command/saveopts.py b/venv/lib/python3.8/site-packages/setuptools/command/saveopts.py new file mode 100644 index 000000000..611cec552 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/command/saveopts.py @@ -0,0 +1,22 @@ +from setuptools.command.setopt import edit_config, option_base + + +class saveopts(option_base): + """Save command-line options to a file""" + + description = "save supplied options to setup.cfg or other config file" + + def run(self): + dist = self.distribution + settings = {} + + for cmd in dist.command_options: + + if cmd == 'saveopts': + continue # don't save our own options! + + for opt, (src, val) in dist.get_option_dict(cmd).items(): + if src == "command line": + settings.setdefault(cmd, {})[opt] = val + + edit_config(self.filename, settings, self.dry_run) diff --git a/venv/lib/python3.8/site-packages/setuptools/command/sdist.py b/venv/lib/python3.8/site-packages/setuptools/command/sdist.py new file mode 100644 index 000000000..a851453f9 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/command/sdist.py @@ -0,0 +1,252 @@ +from distutils import log +import distutils.command.sdist as orig +import os +import sys +import io +import contextlib + +from setuptools.extern import six, ordered_set + +from .py36compat import sdist_add_defaults + +import pkg_resources + +_default_revctrl = list + + +def walk_revctrl(dirname=''): + """Find all files under revision control""" + for ep in pkg_resources.iter_entry_points('setuptools.file_finders'): + for item in ep.load()(dirname): + yield item + + +class sdist(sdist_add_defaults, orig.sdist): + """Smart sdist that finds anything supported by revision control""" + + user_options = [ + ('formats=', None, + "formats for source distribution (comma-separated list)"), + ('keep-temp', 'k', + "keep the distribution tree around after creating " + + "archive file(s)"), + ('dist-dir=', 'd', + "directory to put the source distribution archive(s) in " + "[default: dist]"), + ] + + negative_opt = {} + + README_EXTENSIONS = ['', '.rst', '.txt', '.md'] + READMES = tuple('README{0}'.format(ext) for ext in README_EXTENSIONS) + + def run(self): + self.run_command('egg_info') + ei_cmd = self.get_finalized_command('egg_info') + self.filelist = ei_cmd.filelist + self.filelist.append(os.path.join(ei_cmd.egg_info, 'SOURCES.txt')) + self.check_readme() + + # Run sub commands + for cmd_name in self.get_sub_commands(): + self.run_command(cmd_name) + + self.make_distribution() + + dist_files = getattr(self.distribution, 'dist_files', []) + for file in self.archive_files: + data = ('sdist', '', file) + if data not in dist_files: + dist_files.append(data) + + def initialize_options(self): + orig.sdist.initialize_options(self) + + self._default_to_gztar() + + def _default_to_gztar(self): + # only needed on Python prior to 3.6. + if sys.version_info >= (3, 6, 0, 'beta', 1): + return + self.formats = ['gztar'] + + def make_distribution(self): + """ + Workaround for #516 + """ + with self._remove_os_link(): + orig.sdist.make_distribution(self) + + @staticmethod + @contextlib.contextmanager + def _remove_os_link(): + """ + In a context, remove and restore os.link if it exists + """ + + class NoValue: + pass + + orig_val = getattr(os, 'link', NoValue) + try: + del os.link + except Exception: + pass + try: + yield + finally: + if orig_val is not NoValue: + setattr(os, 'link', orig_val) + + def __read_template_hack(self): + # This grody hack closes the template file (MANIFEST.in) if an + # exception occurs during read_template. + # Doing so prevents an error when easy_install attempts to delete the + # file. + try: + orig.sdist.read_template(self) + except Exception: + _, _, tb = sys.exc_info() + tb.tb_next.tb_frame.f_locals['template'].close() + raise + + # Beginning with Python 2.7.2, 3.1.4, and 3.2.1, this leaky file handle + # has been fixed, so only override the method if we're using an earlier + # Python. + has_leaky_handle = ( + sys.version_info < (2, 7, 2) + or (3, 0) <= sys.version_info < (3, 1, 4) + or (3, 2) <= sys.version_info < (3, 2, 1) + ) + if has_leaky_handle: + read_template = __read_template_hack + + def _add_defaults_optional(self): + if six.PY2: + sdist_add_defaults._add_defaults_optional(self) + else: + super()._add_defaults_optional() + if os.path.isfile('pyproject.toml'): + self.filelist.append('pyproject.toml') + + def _add_defaults_python(self): + """getting python files""" + if self.distribution.has_pure_modules(): + build_py = self.get_finalized_command('build_py') + self.filelist.extend(build_py.get_source_files()) + self._add_data_files(self._safe_data_files(build_py)) + + def _safe_data_files(self, build_py): + """ + Extracting data_files from build_py is known to cause + infinite recursion errors when `include_package_data` + is enabled, so suppress it in that case. + """ + if self.distribution.include_package_data: + return () + return build_py.data_files + + def _add_data_files(self, data_files): + """ + Add data files as found in build_py.data_files. + """ + self.filelist.extend( + os.path.join(src_dir, name) + for _, src_dir, _, filenames in data_files + for name in filenames + ) + + def _add_defaults_data_files(self): + try: + if six.PY2: + sdist_add_defaults._add_defaults_data_files(self) + else: + super()._add_defaults_data_files() + except TypeError: + log.warn("data_files contains unexpected objects") + + def check_readme(self): + for f in self.READMES: + if os.path.exists(f): + return + else: + self.warn( + "standard file not found: should have one of " + + ', '.join(self.READMES) + ) + + def make_release_tree(self, base_dir, files): + orig.sdist.make_release_tree(self, base_dir, files) + + # Save any egg_info command line options used to create this sdist + dest = os.path.join(base_dir, 'setup.cfg') + if hasattr(os, 'link') and os.path.exists(dest): + # unlink and re-copy, since it might be hard-linked, and + # we don't want to change the source version + os.unlink(dest) + self.copy_file('setup.cfg', dest) + + self.get_finalized_command('egg_info').save_version_info(dest) + + def _manifest_is_not_generated(self): + # check for special comment used in 2.7.1 and higher + if not os.path.isfile(self.manifest): + return False + + with io.open(self.manifest, 'rb') as fp: + first_line = fp.readline() + return (first_line != + '# file GENERATED by distutils, do NOT edit\n'.encode()) + + def read_manifest(self): + """Read the manifest file (named by 'self.manifest') and use it to + fill in 'self.filelist', the list of files to include in the source + distribution. + """ + log.info("reading manifest file '%s'", self.manifest) + manifest = open(self.manifest, 'rb') + for line in manifest: + # The manifest must contain UTF-8. See #303. + if six.PY3: + try: + line = line.decode('UTF-8') + except UnicodeDecodeError: + log.warn("%r not UTF-8 decodable -- skipping" % line) + continue + # ignore comments and blank lines + line = line.strip() + if line.startswith('#') or not line: + continue + self.filelist.append(line) + manifest.close() + + def check_license(self): + """Checks if license_file' or 'license_files' is configured and adds any + valid paths to 'self.filelist'. + """ + + files = ordered_set.OrderedSet() + + opts = self.distribution.get_option_dict('metadata') + + # ignore the source of the value + _, license_file = opts.get('license_file', (None, None)) + + if license_file is None: + log.debug("'license_file' option was not specified") + else: + files.add(license_file) + + try: + files.update(self.distribution.metadata.license_files) + except TypeError: + log.warn("warning: 'license_files' option is malformed") + + for f in files: + if not os.path.exists(f): + log.warn( + "warning: Failed to find the configured license file '%s'", + f) + files.remove(f) + + self.filelist.extend(files) diff --git a/venv/lib/python3.8/site-packages/setuptools/command/setopt.py b/venv/lib/python3.8/site-packages/setuptools/command/setopt.py new file mode 100644 index 000000000..7e57cc026 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/command/setopt.py @@ -0,0 +1,149 @@ +from distutils.util import convert_path +from distutils import log +from distutils.errors import DistutilsOptionError +import distutils +import os + +from setuptools.extern.six.moves import configparser + +from setuptools import Command + +__all__ = ['config_file', 'edit_config', 'option_base', 'setopt'] + + +def config_file(kind="local"): + """Get the filename of the distutils, local, global, or per-user config + + `kind` must be one of "local", "global", or "user" + """ + if kind == 'local': + return 'setup.cfg' + if kind == 'global': + return os.path.join( + os.path.dirname(distutils.__file__), 'distutils.cfg' + ) + if kind == 'user': + dot = os.name == 'posix' and '.' or '' + return os.path.expanduser(convert_path("~/%spydistutils.cfg" % dot)) + raise ValueError( + "config_file() type must be 'local', 'global', or 'user'", kind + ) + + +def edit_config(filename, settings, dry_run=False): + """Edit a configuration file to include `settings` + + `settings` is a dictionary of dictionaries or ``None`` values, keyed by + command/section name. A ``None`` value means to delete the entire section, + while a dictionary lists settings to be changed or deleted in that section. + A setting of ``None`` means to delete that setting. + """ + log.debug("Reading configuration from %s", filename) + opts = configparser.RawConfigParser() + opts.read([filename]) + for section, options in settings.items(): + if options is None: + log.info("Deleting section [%s] from %s", section, filename) + opts.remove_section(section) + else: + if not opts.has_section(section): + log.debug("Adding new section [%s] to %s", section, filename) + opts.add_section(section) + for option, value in options.items(): + if value is None: + log.debug( + "Deleting %s.%s from %s", + section, option, filename + ) + opts.remove_option(section, option) + if not opts.options(section): + log.info("Deleting empty [%s] section from %s", + section, filename) + opts.remove_section(section) + else: + log.debug( + "Setting %s.%s to %r in %s", + section, option, value, filename + ) + opts.set(section, option, value) + + log.info("Writing %s", filename) + if not dry_run: + with open(filename, 'w') as f: + opts.write(f) + + +class option_base(Command): + """Abstract base class for commands that mess with config files""" + + user_options = [ + ('global-config', 'g', + "save options to the site-wide distutils.cfg file"), + ('user-config', 'u', + "save options to the current user's pydistutils.cfg file"), + ('filename=', 'f', + "configuration file to use (default=setup.cfg)"), + ] + + boolean_options = [ + 'global-config', 'user-config', + ] + + def initialize_options(self): + self.global_config = None + self.user_config = None + self.filename = None + + def finalize_options(self): + filenames = [] + if self.global_config: + filenames.append(config_file('global')) + if self.user_config: + filenames.append(config_file('user')) + if self.filename is not None: + filenames.append(self.filename) + if not filenames: + filenames.append(config_file('local')) + if len(filenames) > 1: + raise DistutilsOptionError( + "Must specify only one configuration file option", + filenames + ) + self.filename, = filenames + + +class setopt(option_base): + """Save command-line options to a file""" + + description = "set an option in setup.cfg or another config file" + + user_options = [ + ('command=', 'c', 'command to set an option for'), + ('option=', 'o', 'option to set'), + ('set-value=', 's', 'value of the option'), + ('remove', 'r', 'remove (unset) the value'), + ] + option_base.user_options + + boolean_options = option_base.boolean_options + ['remove'] + + def initialize_options(self): + option_base.initialize_options(self) + self.command = None + self.option = None + self.set_value = None + self.remove = None + + def finalize_options(self): + option_base.finalize_options(self) + if self.command is None or self.option is None: + raise DistutilsOptionError("Must specify --command *and* --option") + if self.set_value is None and not self.remove: + raise DistutilsOptionError("Must specify --set-value or --remove") + + def run(self): + edit_config( + self.filename, { + self.command: {self.option.replace('-', '_'): self.set_value} + }, + self.dry_run + ) diff --git a/venv/lib/python3.8/site-packages/setuptools/command/test.py b/venv/lib/python3.8/site-packages/setuptools/command/test.py new file mode 100644 index 000000000..c148b38d1 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/command/test.py @@ -0,0 +1,279 @@ +import os +import operator +import sys +import contextlib +import itertools +import unittest +from distutils.errors import DistutilsError, DistutilsOptionError +from distutils import log +from unittest import TestLoader + +from setuptools.extern import six +from setuptools.extern.six.moves import map, filter + +from pkg_resources import (resource_listdir, resource_exists, normalize_path, + working_set, _namespace_packages, evaluate_marker, + add_activation_listener, require, EntryPoint) +from setuptools import Command +from .build_py import _unique_everseen + +__metaclass__ = type + + +class ScanningLoader(TestLoader): + + def __init__(self): + TestLoader.__init__(self) + self._visited = set() + + def loadTestsFromModule(self, module, pattern=None): + """Return a suite of all tests cases contained in the given module + + If the module is a package, load tests from all the modules in it. + If the module has an ``additional_tests`` function, call it and add + the return value to the tests. + """ + if module in self._visited: + return None + self._visited.add(module) + + tests = [] + tests.append(TestLoader.loadTestsFromModule(self, module)) + + if hasattr(module, "additional_tests"): + tests.append(module.additional_tests()) + + if hasattr(module, '__path__'): + for file in resource_listdir(module.__name__, ''): + if file.endswith('.py') and file != '__init__.py': + submodule = module.__name__ + '.' + file[:-3] + else: + if resource_exists(module.__name__, file + '/__init__.py'): + submodule = module.__name__ + '.' + file + else: + continue + tests.append(self.loadTestsFromName(submodule)) + + if len(tests) != 1: + return self.suiteClass(tests) + else: + return tests[0] # don't create a nested suite for only one return + + +# adapted from jaraco.classes.properties:NonDataProperty +class NonDataProperty: + def __init__(self, fget): + self.fget = fget + + def __get__(self, obj, objtype=None): + if obj is None: + return self + return self.fget(obj) + + +class test(Command): + """Command to run unit tests after in-place build""" + + description = "run unit tests after in-place build (deprecated)" + + user_options = [ + ('test-module=', 'm', "Run 'test_suite' in specified module"), + ('test-suite=', 's', + "Run single test, case or suite (e.g. 'module.test_suite')"), + ('test-runner=', 'r', "Test runner to use"), + ] + + def initialize_options(self): + self.test_suite = None + self.test_module = None + self.test_loader = None + self.test_runner = None + + def finalize_options(self): + + if self.test_suite and self.test_module: + msg = "You may specify a module or a suite, but not both" + raise DistutilsOptionError(msg) + + if self.test_suite is None: + if self.test_module is None: + self.test_suite = self.distribution.test_suite + else: + self.test_suite = self.test_module + ".test_suite" + + if self.test_loader is None: + self.test_loader = getattr(self.distribution, 'test_loader', None) + if self.test_loader is None: + self.test_loader = "setuptools.command.test:ScanningLoader" + if self.test_runner is None: + self.test_runner = getattr(self.distribution, 'test_runner', None) + + @NonDataProperty + def test_args(self): + return list(self._test_args()) + + def _test_args(self): + if not self.test_suite and sys.version_info >= (2, 7): + yield 'discover' + if self.verbose: + yield '--verbose' + if self.test_suite: + yield self.test_suite + + def with_project_on_sys_path(self, func): + """ + Backward compatibility for project_on_sys_path context. + """ + with self.project_on_sys_path(): + func() + + @contextlib.contextmanager + def project_on_sys_path(self, include_dists=[]): + with_2to3 = six.PY3 and getattr(self.distribution, 'use_2to3', False) + + if with_2to3: + # If we run 2to3 we can not do this inplace: + + # Ensure metadata is up-to-date + self.reinitialize_command('build_py', inplace=0) + self.run_command('build_py') + bpy_cmd = self.get_finalized_command("build_py") + build_path = normalize_path(bpy_cmd.build_lib) + + # Build extensions + self.reinitialize_command('egg_info', egg_base=build_path) + self.run_command('egg_info') + + self.reinitialize_command('build_ext', inplace=0) + self.run_command('build_ext') + else: + # Without 2to3 inplace works fine: + self.run_command('egg_info') + + # Build extensions in-place + self.reinitialize_command('build_ext', inplace=1) + self.run_command('build_ext') + + ei_cmd = self.get_finalized_command("egg_info") + + old_path = sys.path[:] + old_modules = sys.modules.copy() + + try: + project_path = normalize_path(ei_cmd.egg_base) + sys.path.insert(0, project_path) + working_set.__init__() + add_activation_listener(lambda dist: dist.activate()) + require('%s==%s' % (ei_cmd.egg_name, ei_cmd.egg_version)) + with self.paths_on_pythonpath([project_path]): + yield + finally: + sys.path[:] = old_path + sys.modules.clear() + sys.modules.update(old_modules) + working_set.__init__() + + @staticmethod + @contextlib.contextmanager + def paths_on_pythonpath(paths): + """ + Add the indicated paths to the head of the PYTHONPATH environment + variable so that subprocesses will also see the packages at + these paths. + + Do this in a context that restores the value on exit. + """ + nothing = object() + orig_pythonpath = os.environ.get('PYTHONPATH', nothing) + current_pythonpath = os.environ.get('PYTHONPATH', '') + try: + prefix = os.pathsep.join(_unique_everseen(paths)) + to_join = filter(None, [prefix, current_pythonpath]) + new_path = os.pathsep.join(to_join) + if new_path: + os.environ['PYTHONPATH'] = new_path + yield + finally: + if orig_pythonpath is nothing: + os.environ.pop('PYTHONPATH', None) + else: + os.environ['PYTHONPATH'] = orig_pythonpath + + @staticmethod + def install_dists(dist): + """ + Install the requirements indicated by self.distribution and + return an iterable of the dists that were built. + """ + ir_d = dist.fetch_build_eggs(dist.install_requires) + tr_d = dist.fetch_build_eggs(dist.tests_require or []) + er_d = dist.fetch_build_eggs( + v for k, v in dist.extras_require.items() + if k.startswith(':') and evaluate_marker(k[1:]) + ) + return itertools.chain(ir_d, tr_d, er_d) + + def run(self): + self.announce( + "WARNING: Testing via this command is deprecated and will be " + "removed in a future version. Users looking for a generic test " + "entry point independent of test runner are encouraged to use " + "tox.", + log.WARN, + ) + + installed_dists = self.install_dists(self.distribution) + + cmd = ' '.join(self._argv) + if self.dry_run: + self.announce('skipping "%s" (dry run)' % cmd) + return + + self.announce('running "%s"' % cmd) + + paths = map(operator.attrgetter('location'), installed_dists) + with self.paths_on_pythonpath(paths): + with self.project_on_sys_path(): + self.run_tests() + + def run_tests(self): + # Purge modules under test from sys.modules. The test loader will + # re-import them from the build location. Required when 2to3 is used + # with namespace packages. + if six.PY3 and getattr(self.distribution, 'use_2to3', False): + module = self.test_suite.split('.')[0] + if module in _namespace_packages: + del_modules = [] + if module in sys.modules: + del_modules.append(module) + module += '.' + for name in sys.modules: + if name.startswith(module): + del_modules.append(name) + list(map(sys.modules.__delitem__, del_modules)) + + test = unittest.main( + None, None, self._argv, + testLoader=self._resolve_as_ep(self.test_loader), + testRunner=self._resolve_as_ep(self.test_runner), + exit=False, + ) + if not test.result.wasSuccessful(): + msg = 'Test failed: %s' % test.result + self.announce(msg, log.ERROR) + raise DistutilsError(msg) + + @property + def _argv(self): + return ['unittest'] + self.test_args + + @staticmethod + def _resolve_as_ep(val): + """ + Load the indicated attribute value, called, as a as if it were + specified as an entry point. + """ + if val is None: + return + parsed = EntryPoint.parse("x=" + val) + return parsed.resolve()() diff --git a/venv/lib/python3.8/site-packages/setuptools/command/upload.py b/venv/lib/python3.8/site-packages/setuptools/command/upload.py new file mode 100644 index 000000000..ec7f81e22 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/command/upload.py @@ -0,0 +1,17 @@ +from distutils import log +from distutils.command import upload as orig + +from setuptools.errors import RemovedCommandError + + +class upload(orig.upload): + """Formerly used to upload packages to PyPI.""" + + def run(self): + msg = ( + "The upload command has been removed, use twine to upload " + + "instead (https://pypi.org/p/twine)" + ) + + self.announce("ERROR: " + msg, log.ERROR) + raise RemovedCommandError(msg) diff --git a/venv/lib/python3.8/site-packages/setuptools/command/upload_docs.py b/venv/lib/python3.8/site-packages/setuptools/command/upload_docs.py new file mode 100644 index 000000000..07aa564af --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/command/upload_docs.py @@ -0,0 +1,206 @@ +# -*- coding: utf-8 -*- +"""upload_docs + +Implements a Distutils 'upload_docs' subcommand (upload documentation to +PyPI's pythonhosted.org). +""" + +from base64 import standard_b64encode +from distutils import log +from distutils.errors import DistutilsOptionError +import os +import socket +import zipfile +import tempfile +import shutil +import itertools +import functools + +from setuptools.extern import six +from setuptools.extern.six.moves import http_client, urllib + +from pkg_resources import iter_entry_points +from .upload import upload + + +def _encode(s): + errors = 'surrogateescape' if six.PY3 else 'strict' + return s.encode('utf-8', errors) + + +class upload_docs(upload): + # override the default repository as upload_docs isn't + # supported by Warehouse (and won't be). + DEFAULT_REPOSITORY = 'https://pypi.python.org/pypi/' + + description = 'Upload documentation to PyPI' + + user_options = [ + ('repository=', 'r', + "url of repository [default: %s]" % upload.DEFAULT_REPOSITORY), + ('show-response', None, + 'display full response text from server'), + ('upload-dir=', None, 'directory to upload'), + ] + boolean_options = upload.boolean_options + + def has_sphinx(self): + if self.upload_dir is None: + for ep in iter_entry_points('distutils.commands', 'build_sphinx'): + return True + + sub_commands = [('build_sphinx', has_sphinx)] + + def initialize_options(self): + upload.initialize_options(self) + self.upload_dir = None + self.target_dir = None + + def finalize_options(self): + upload.finalize_options(self) + if self.upload_dir is None: + if self.has_sphinx(): + build_sphinx = self.get_finalized_command('build_sphinx') + self.target_dir = build_sphinx.builder_target_dir + else: + build = self.get_finalized_command('build') + self.target_dir = os.path.join(build.build_base, 'docs') + else: + self.ensure_dirname('upload_dir') + self.target_dir = self.upload_dir + if 'pypi.python.org' in self.repository: + log.warn("Upload_docs command is deprecated. Use RTD instead.") + self.announce('Using upload directory %s' % self.target_dir) + + def create_zipfile(self, filename): + zip_file = zipfile.ZipFile(filename, "w") + try: + self.mkpath(self.target_dir) # just in case + for root, dirs, files in os.walk(self.target_dir): + if root == self.target_dir and not files: + tmpl = "no files found in upload directory '%s'" + raise DistutilsOptionError(tmpl % self.target_dir) + for name in files: + full = os.path.join(root, name) + relative = root[len(self.target_dir):].lstrip(os.path.sep) + dest = os.path.join(relative, name) + zip_file.write(full, dest) + finally: + zip_file.close() + + def run(self): + # Run sub commands + for cmd_name in self.get_sub_commands(): + self.run_command(cmd_name) + + tmp_dir = tempfile.mkdtemp() + name = self.distribution.metadata.get_name() + zip_file = os.path.join(tmp_dir, "%s.zip" % name) + try: + self.create_zipfile(zip_file) + self.upload_file(zip_file) + finally: + shutil.rmtree(tmp_dir) + + @staticmethod + def _build_part(item, sep_boundary): + key, values = item + title = '\nContent-Disposition: form-data; name="%s"' % key + # handle multiple entries for the same name + if not isinstance(values, list): + values = [values] + for value in values: + if isinstance(value, tuple): + title += '; filename="%s"' % value[0] + value = value[1] + else: + value = _encode(value) + yield sep_boundary + yield _encode(title) + yield b"\n\n" + yield value + if value and value[-1:] == b'\r': + yield b'\n' # write an extra newline (lurve Macs) + + @classmethod + def _build_multipart(cls, data): + """ + Build up the MIME payload for the POST data + """ + boundary = b'--------------GHSKFJDLGDS7543FJKLFHRE75642756743254' + sep_boundary = b'\n--' + boundary + end_boundary = sep_boundary + b'--' + end_items = end_boundary, b"\n", + builder = functools.partial( + cls._build_part, + sep_boundary=sep_boundary, + ) + part_groups = map(builder, data.items()) + parts = itertools.chain.from_iterable(part_groups) + body_items = itertools.chain(parts, end_items) + content_type = 'multipart/form-data; boundary=%s' % boundary.decode('ascii') + return b''.join(body_items), content_type + + def upload_file(self, filename): + with open(filename, 'rb') as f: + content = f.read() + meta = self.distribution.metadata + data = { + ':action': 'doc_upload', + 'name': meta.get_name(), + 'content': (os.path.basename(filename), content), + } + # set up the authentication + credentials = _encode(self.username + ':' + self.password) + credentials = standard_b64encode(credentials) + if six.PY3: + credentials = credentials.decode('ascii') + auth = "Basic " + credentials + + body, ct = self._build_multipart(data) + + msg = "Submitting documentation to %s" % (self.repository) + self.announce(msg, log.INFO) + + # build the Request + # We can't use urllib2 since we need to send the Basic + # auth right with the first request + schema, netloc, url, params, query, fragments = \ + urllib.parse.urlparse(self.repository) + assert not params and not query and not fragments + if schema == 'http': + conn = http_client.HTTPConnection(netloc) + elif schema == 'https': + conn = http_client.HTTPSConnection(netloc) + else: + raise AssertionError("unsupported schema " + schema) + + data = '' + try: + conn.connect() + conn.putrequest("POST", url) + content_type = ct + conn.putheader('Content-type', content_type) + conn.putheader('Content-length', str(len(body))) + conn.putheader('Authorization', auth) + conn.endheaders() + conn.send(body) + except socket.error as e: + self.announce(str(e), log.ERROR) + return + + r = conn.getresponse() + if r.status == 200: + msg = 'Server response (%s): %s' % (r.status, r.reason) + self.announce(msg, log.INFO) + elif r.status == 301: + location = r.getheader('Location') + if location is None: + location = 'https://pythonhosted.org/%s/' % meta.get_name() + msg = 'Upload successful. Visit %s' % location + self.announce(msg, log.INFO) + else: + msg = 'Upload failed (%s): %s' % (r.status, r.reason) + self.announce(msg, log.ERROR) + if self.show_response: + print('-' * 75, r.read(), '-' * 75) diff --git a/venv/lib/python3.8/site-packages/setuptools/config.py b/venv/lib/python3.8/site-packages/setuptools/config.py new file mode 100644 index 000000000..9b9a0c45e --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/config.py @@ -0,0 +1,659 @@ +from __future__ import absolute_import, unicode_literals +import io +import os +import sys + +import warnings +import functools +from collections import defaultdict +from functools import partial +from functools import wraps +from importlib import import_module + +from distutils.errors import DistutilsOptionError, DistutilsFileError +from setuptools.extern.packaging.version import LegacyVersion, parse +from setuptools.extern.packaging.specifiers import SpecifierSet +from setuptools.extern.six import string_types, PY3 + + +__metaclass__ = type + + +def read_configuration( + filepath, find_others=False, ignore_option_errors=False): + """Read given configuration file and returns options from it as a dict. + + :param str|unicode filepath: Path to configuration file + to get options from. + + :param bool find_others: Whether to search for other configuration files + which could be on in various places. + + :param bool ignore_option_errors: Whether to silently ignore + options, values of which could not be resolved (e.g. due to exceptions + in directives such as file:, attr:, etc.). + If False exceptions are propagated as expected. + + :rtype: dict + """ + from setuptools.dist import Distribution, _Distribution + + filepath = os.path.abspath(filepath) + + if not os.path.isfile(filepath): + raise DistutilsFileError( + 'Configuration file %s does not exist.' % filepath) + + current_directory = os.getcwd() + os.chdir(os.path.dirname(filepath)) + + try: + dist = Distribution() + + filenames = dist.find_config_files() if find_others else [] + if filepath not in filenames: + filenames.append(filepath) + + _Distribution.parse_config_files(dist, filenames=filenames) + + handlers = parse_configuration( + dist, dist.command_options, + ignore_option_errors=ignore_option_errors) + + finally: + os.chdir(current_directory) + + return configuration_to_dict(handlers) + + +def _get_option(target_obj, key): + """ + Given a target object and option key, get that option from + the target object, either through a get_{key} method or + from an attribute directly. + """ + getter_name = 'get_{key}'.format(**locals()) + by_attribute = functools.partial(getattr, target_obj, key) + getter = getattr(target_obj, getter_name, by_attribute) + return getter() + + +def configuration_to_dict(handlers): + """Returns configuration data gathered by given handlers as a dict. + + :param list[ConfigHandler] handlers: Handlers list, + usually from parse_configuration() + + :rtype: dict + """ + config_dict = defaultdict(dict) + + for handler in handlers: + for option in handler.set_options: + value = _get_option(handler.target_obj, option) + config_dict[handler.section_prefix][option] = value + + return config_dict + + +def parse_configuration( + distribution, command_options, ignore_option_errors=False): + """Performs additional parsing of configuration options + for a distribution. + + Returns a list of used option handlers. + + :param Distribution distribution: + :param dict command_options: + :param bool ignore_option_errors: Whether to silently ignore + options, values of which could not be resolved (e.g. due to exceptions + in directives such as file:, attr:, etc.). + If False exceptions are propagated as expected. + :rtype: list + """ + options = ConfigOptionsHandler( + distribution, command_options, ignore_option_errors) + options.parse() + + meta = ConfigMetadataHandler( + distribution.metadata, command_options, ignore_option_errors, + distribution.package_dir) + meta.parse() + + return meta, options + + +class ConfigHandler: + """Handles metadata supplied in configuration files.""" + + section_prefix = None + """Prefix for config sections handled by this handler. + Must be provided by class heirs. + + """ + + aliases = {} + """Options aliases. + For compatibility with various packages. E.g.: d2to1 and pbr. + Note: `-` in keys is replaced with `_` by config parser. + + """ + + def __init__(self, target_obj, options, ignore_option_errors=False): + sections = {} + + section_prefix = self.section_prefix + for section_name, section_options in options.items(): + if not section_name.startswith(section_prefix): + continue + + section_name = section_name.replace(section_prefix, '').strip('.') + sections[section_name] = section_options + + self.ignore_option_errors = ignore_option_errors + self.target_obj = target_obj + self.sections = sections + self.set_options = [] + + @property + def parsers(self): + """Metadata item name to parser function mapping.""" + raise NotImplementedError( + '%s must provide .parsers property' % self.__class__.__name__) + + def __setitem__(self, option_name, value): + unknown = tuple() + target_obj = self.target_obj + + # Translate alias into real name. + option_name = self.aliases.get(option_name, option_name) + + current_value = getattr(target_obj, option_name, unknown) + + if current_value is unknown: + raise KeyError(option_name) + + if current_value: + # Already inhabited. Skipping. + return + + skip_option = False + parser = self.parsers.get(option_name) + if parser: + try: + value = parser(value) + + except Exception: + skip_option = True + if not self.ignore_option_errors: + raise + + if skip_option: + return + + setter = getattr(target_obj, 'set_%s' % option_name, None) + if setter is None: + setattr(target_obj, option_name, value) + else: + setter(value) + + self.set_options.append(option_name) + + @classmethod + def _parse_list(cls, value, separator=','): + """Represents value as a list. + + Value is split either by separator (defaults to comma) or by lines. + + :param value: + :param separator: List items separator character. + :rtype: list + """ + if isinstance(value, list): # _get_parser_compound case + return value + + if '\n' in value: + value = value.splitlines() + else: + value = value.split(separator) + + return [chunk.strip() for chunk in value if chunk.strip()] + + @classmethod + def _parse_dict(cls, value): + """Represents value as a dict. + + :param value: + :rtype: dict + """ + separator = '=' + result = {} + for line in cls._parse_list(value): + key, sep, val = line.partition(separator) + if sep != separator: + raise DistutilsOptionError( + 'Unable to parse option value to dict: %s' % value) + result[key.strip()] = val.strip() + + return result + + @classmethod + def _parse_bool(cls, value): + """Represents value as boolean. + + :param value: + :rtype: bool + """ + value = value.lower() + return value in ('1', 'true', 'yes') + + @classmethod + def _exclude_files_parser(cls, key): + """Returns a parser function to make sure field inputs + are not files. + + Parses a value after getting the key so error messages are + more informative. + + :param key: + :rtype: callable + """ + def parser(value): + exclude_directive = 'file:' + if value.startswith(exclude_directive): + raise ValueError( + 'Only strings are accepted for the {0} field, ' + 'files are not accepted'.format(key)) + return value + return parser + + @classmethod + def _parse_file(cls, value): + """Represents value as a string, allowing including text + from nearest files using `file:` directive. + + Directive is sandboxed and won't reach anything outside + directory with setup.py. + + Examples: + file: README.rst, CHANGELOG.md, src/file.txt + + :param str value: + :rtype: str + """ + include_directive = 'file:' + + if not isinstance(value, string_types): + return value + + if not value.startswith(include_directive): + return value + + spec = value[len(include_directive):] + filepaths = (os.path.abspath(path.strip()) for path in spec.split(',')) + return '\n'.join( + cls._read_file(path) + for path in filepaths + if (cls._assert_local(path) or True) + and os.path.isfile(path) + ) + + @staticmethod + def _assert_local(filepath): + if not filepath.startswith(os.getcwd()): + raise DistutilsOptionError( + '`file:` directive can not access %s' % filepath) + + @staticmethod + def _read_file(filepath): + with io.open(filepath, encoding='utf-8') as f: + return f.read() + + @classmethod + def _parse_attr(cls, value, package_dir=None): + """Represents value as a module attribute. + + Examples: + attr: package.attr + attr: package.module.attr + + :param str value: + :rtype: str + """ + attr_directive = 'attr:' + if not value.startswith(attr_directive): + return value + + attrs_path = value.replace(attr_directive, '').strip().split('.') + attr_name = attrs_path.pop() + + module_name = '.'.join(attrs_path) + module_name = module_name or '__init__' + + parent_path = os.getcwd() + if package_dir: + if attrs_path[0] in package_dir: + # A custom path was specified for the module we want to import + custom_path = package_dir[attrs_path[0]] + parts = custom_path.rsplit('/', 1) + if len(parts) > 1: + parent_path = os.path.join(os.getcwd(), parts[0]) + module_name = parts[1] + else: + module_name = custom_path + elif '' in package_dir: + # A custom parent directory was specified for all root modules + parent_path = os.path.join(os.getcwd(), package_dir['']) + sys.path.insert(0, parent_path) + try: + module = import_module(module_name) + value = getattr(module, attr_name) + + finally: + sys.path = sys.path[1:] + + return value + + @classmethod + def _get_parser_compound(cls, *parse_methods): + """Returns parser function to represents value as a list. + + Parses a value applying given methods one after another. + + :param parse_methods: + :rtype: callable + """ + def parse(value): + parsed = value + + for method in parse_methods: + parsed = method(parsed) + + return parsed + + return parse + + @classmethod + def _parse_section_to_dict(cls, section_options, values_parser=None): + """Parses section options into a dictionary. + + Optionally applies a given parser to values. + + :param dict section_options: + :param callable values_parser: + :rtype: dict + """ + value = {} + values_parser = values_parser or (lambda val: val) + for key, (_, val) in section_options.items(): + value[key] = values_parser(val) + return value + + def parse_section(self, section_options): + """Parses configuration file section. + + :param dict section_options: + """ + for (name, (_, value)) in section_options.items(): + try: + self[name] = value + + except KeyError: + pass # Keep silent for a new option may appear anytime. + + def parse(self): + """Parses configuration file items from one + or more related sections. + + """ + for section_name, section_options in self.sections.items(): + + method_postfix = '' + if section_name: # [section.option] variant + method_postfix = '_%s' % section_name + + section_parser_method = getattr( + self, + # Dots in section names are translated into dunderscores. + ('parse_section%s' % method_postfix).replace('.', '__'), + None) + + if section_parser_method is None: + raise DistutilsOptionError( + 'Unsupported distribution option section: [%s.%s]' % ( + self.section_prefix, section_name)) + + section_parser_method(section_options) + + def _deprecated_config_handler(self, func, msg, warning_class): + """ this function will wrap around parameters that are deprecated + + :param msg: deprecation message + :param warning_class: class of warning exception to be raised + :param func: function to be wrapped around + """ + @wraps(func) + def config_handler(*args, **kwargs): + warnings.warn(msg, warning_class) + return func(*args, **kwargs) + + return config_handler + + +class ConfigMetadataHandler(ConfigHandler): + + section_prefix = 'metadata' + + aliases = { + 'home_page': 'url', + 'summary': 'description', + 'classifier': 'classifiers', + 'platform': 'platforms', + } + + strict_mode = False + """We need to keep it loose, to be partially compatible with + `pbr` and `d2to1` packages which also uses `metadata` section. + + """ + + def __init__(self, target_obj, options, ignore_option_errors=False, + package_dir=None): + super(ConfigMetadataHandler, self).__init__(target_obj, options, + ignore_option_errors) + self.package_dir = package_dir + + @property + def parsers(self): + """Metadata item name to parser function mapping.""" + parse_list = self._parse_list + parse_file = self._parse_file + parse_dict = self._parse_dict + exclude_files_parser = self._exclude_files_parser + + return { + 'platforms': parse_list, + 'keywords': parse_list, + 'provides': parse_list, + 'requires': self._deprecated_config_handler( + parse_list, + "The requires parameter is deprecated, please use " + "install_requires for runtime dependencies.", + DeprecationWarning), + 'obsoletes': parse_list, + 'classifiers': self._get_parser_compound(parse_file, parse_list), + 'license': exclude_files_parser('license'), + 'license_files': parse_list, + 'description': parse_file, + 'long_description': parse_file, + 'version': self._parse_version, + 'project_urls': parse_dict, + } + + def _parse_version(self, value): + """Parses `version` option value. + + :param value: + :rtype: str + + """ + version = self._parse_file(value) + + if version != value: + version = version.strip() + # Be strict about versions loaded from file because it's easy to + # accidentally include newlines and other unintended content + if isinstance(parse(version), LegacyVersion): + tmpl = ( + 'Version loaded from {value} does not ' + 'comply with PEP 440: {version}' + ) + raise DistutilsOptionError(tmpl.format(**locals())) + + return version + + version = self._parse_attr(value, self.package_dir) + + if callable(version): + version = version() + + if not isinstance(version, string_types): + if hasattr(version, '__iter__'): + version = '.'.join(map(str, version)) + else: + version = '%s' % version + + return version + + +class ConfigOptionsHandler(ConfigHandler): + + section_prefix = 'options' + + @property + def parsers(self): + """Metadata item name to parser function mapping.""" + parse_list = self._parse_list + parse_list_semicolon = partial(self._parse_list, separator=';') + parse_bool = self._parse_bool + parse_dict = self._parse_dict + + return { + 'zip_safe': parse_bool, + 'use_2to3': parse_bool, + 'include_package_data': parse_bool, + 'package_dir': parse_dict, + 'use_2to3_fixers': parse_list, + 'use_2to3_exclude_fixers': parse_list, + 'convert_2to3_doctests': parse_list, + 'scripts': parse_list, + 'eager_resources': parse_list, + 'dependency_links': parse_list, + 'namespace_packages': parse_list, + 'install_requires': parse_list_semicolon, + 'setup_requires': parse_list_semicolon, + 'tests_require': parse_list_semicolon, + 'packages': self._parse_packages, + 'entry_points': self._parse_file, + 'py_modules': parse_list, + 'python_requires': SpecifierSet, + } + + def _parse_packages(self, value): + """Parses `packages` option value. + + :param value: + :rtype: list + """ + find_directives = ['find:', 'find_namespace:'] + trimmed_value = value.strip() + + if trimmed_value not in find_directives: + return self._parse_list(value) + + findns = trimmed_value == find_directives[1] + if findns and not PY3: + raise DistutilsOptionError( + 'find_namespace: directive is unsupported on Python < 3.3') + + # Read function arguments from a dedicated section. + find_kwargs = self.parse_section_packages__find( + self.sections.get('packages.find', {})) + + if findns: + from setuptools import find_namespace_packages as find_packages + else: + from setuptools import find_packages + + return find_packages(**find_kwargs) + + def parse_section_packages__find(self, section_options): + """Parses `packages.find` configuration file section. + + To be used in conjunction with _parse_packages(). + + :param dict section_options: + """ + section_data = self._parse_section_to_dict( + section_options, self._parse_list) + + valid_keys = ['where', 'include', 'exclude'] + + find_kwargs = dict( + [(k, v) for k, v in section_data.items() if k in valid_keys and v]) + + where = find_kwargs.get('where') + if where is not None: + find_kwargs['where'] = where[0] # cast list to single val + + return find_kwargs + + def parse_section_entry_points(self, section_options): + """Parses `entry_points` configuration file section. + + :param dict section_options: + """ + parsed = self._parse_section_to_dict(section_options, self._parse_list) + self['entry_points'] = parsed + + def _parse_package_data(self, section_options): + parsed = self._parse_section_to_dict(section_options, self._parse_list) + + root = parsed.get('*') + if root: + parsed[''] = root + del parsed['*'] + + return parsed + + def parse_section_package_data(self, section_options): + """Parses `package_data` configuration file section. + + :param dict section_options: + """ + self['package_data'] = self._parse_package_data(section_options) + + def parse_section_exclude_package_data(self, section_options): + """Parses `exclude_package_data` configuration file section. + + :param dict section_options: + """ + self['exclude_package_data'] = self._parse_package_data( + section_options) + + def parse_section_extras_require(self, section_options): + """Parses `extras_require` configuration file section. + + :param dict section_options: + """ + parse_list = partial(self._parse_list, separator=';') + self['extras_require'] = self._parse_section_to_dict( + section_options, parse_list) + + def parse_section_data_files(self, section_options): + """Parses `data_files` configuration file section. + + :param dict section_options: + """ + parsed = self._parse_section_to_dict(section_options, self._parse_list) + self['data_files'] = [(k, v) for k, v in parsed.items()] diff --git a/venv/lib/python3.8/site-packages/setuptools/dep_util.py b/venv/lib/python3.8/site-packages/setuptools/dep_util.py new file mode 100644 index 000000000..2931c13ec --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/dep_util.py @@ -0,0 +1,23 @@ +from distutils.dep_util import newer_group + +# yes, this is was almost entirely copy-pasted from +# 'newer_pairwise()', this is just another convenience +# function. +def newer_pairwise_group(sources_groups, targets): + """Walk both arguments in parallel, testing if each source group is newer + than its corresponding target. Returns a pair of lists (sources_groups, + targets) where sources is newer than target, according to the semantics + of 'newer_group()'. + """ + if len(sources_groups) != len(targets): + raise ValueError("'sources_group' and 'targets' must be the same length") + + # build a pair of lists (sources_groups, targets) where source is newer + n_sources = [] + n_targets = [] + for i in range(len(sources_groups)): + if newer_group(sources_groups[i], targets[i]): + n_sources.append(sources_groups[i]) + n_targets.append(targets[i]) + + return n_sources, n_targets diff --git a/venv/lib/python3.8/site-packages/setuptools/depends.py b/venv/lib/python3.8/site-packages/setuptools/depends.py new file mode 100644 index 000000000..a37675cbd --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/depends.py @@ -0,0 +1,176 @@ +import sys +import marshal +import contextlib +from distutils.version import StrictVersion + +from .py33compat import Bytecode + +from .py27compat import find_module, PY_COMPILED, PY_FROZEN, PY_SOURCE +from . import py27compat + + +__all__ = [ + 'Require', 'find_module', 'get_module_constant', 'extract_constant' +] + + +class Require: + """A prerequisite to building or installing a distribution""" + + def __init__( + self, name, requested_version, module, homepage='', + attribute=None, format=None): + + if format is None and requested_version is not None: + format = StrictVersion + + if format is not None: + requested_version = format(requested_version) + if attribute is None: + attribute = '__version__' + + self.__dict__.update(locals()) + del self.self + + def full_name(self): + """Return full package/distribution name, w/version""" + if self.requested_version is not None: + return '%s-%s' % (self.name, self.requested_version) + return self.name + + def version_ok(self, version): + """Is 'version' sufficiently up-to-date?""" + return self.attribute is None or self.format is None or \ + str(version) != "unknown" and version >= self.requested_version + + def get_version(self, paths=None, default="unknown"): + """Get version number of installed module, 'None', or 'default' + + Search 'paths' for module. If not found, return 'None'. If found, + return the extracted version attribute, or 'default' if no version + attribute was specified, or the value cannot be determined without + importing the module. The version is formatted according to the + requirement's version format (if any), unless it is 'None' or the + supplied 'default'. + """ + + if self.attribute is None: + try: + f, p, i = find_module(self.module, paths) + if f: + f.close() + return default + except ImportError: + return None + + v = get_module_constant(self.module, self.attribute, default, paths) + + if v is not None and v is not default and self.format is not None: + return self.format(v) + + return v + + def is_present(self, paths=None): + """Return true if dependency is present on 'paths'""" + return self.get_version(paths) is not None + + def is_current(self, paths=None): + """Return true if dependency is present and up-to-date on 'paths'""" + version = self.get_version(paths) + if version is None: + return False + return self.version_ok(version) + + +def maybe_close(f): + @contextlib.contextmanager + def empty(): + yield + return + if not f: + return empty() + + return contextlib.closing(f) + + +def get_module_constant(module, symbol, default=-1, paths=None): + """Find 'module' by searching 'paths', and extract 'symbol' + + Return 'None' if 'module' does not exist on 'paths', or it does not define + 'symbol'. If the module defines 'symbol' as a constant, return the + constant. Otherwise, return 'default'.""" + + try: + f, path, (suffix, mode, kind) = info = find_module(module, paths) + except ImportError: + # Module doesn't exist + return None + + with maybe_close(f): + if kind == PY_COMPILED: + f.read(8) # skip magic & date + code = marshal.load(f) + elif kind == PY_FROZEN: + code = py27compat.get_frozen_object(module, paths) + elif kind == PY_SOURCE: + code = compile(f.read(), path, 'exec') + else: + # Not something we can parse; we'll have to import it. :( + imported = py27compat.get_module(module, paths, info) + return getattr(imported, symbol, None) + + return extract_constant(code, symbol, default) + + +def extract_constant(code, symbol, default=-1): + """Extract the constant value of 'symbol' from 'code' + + If the name 'symbol' is bound to a constant value by the Python code + object 'code', return that value. If 'symbol' is bound to an expression, + return 'default'. Otherwise, return 'None'. + + Return value is based on the first assignment to 'symbol'. 'symbol' must + be a global, or at least a non-"fast" local in the code block. That is, + only 'STORE_NAME' and 'STORE_GLOBAL' opcodes are checked, and 'symbol' + must be present in 'code.co_names'. + """ + if symbol not in code.co_names: + # name's not there, can't possibly be an assignment + return None + + name_idx = list(code.co_names).index(symbol) + + STORE_NAME = 90 + STORE_GLOBAL = 97 + LOAD_CONST = 100 + + const = default + + for byte_code in Bytecode(code): + op = byte_code.opcode + arg = byte_code.arg + + if op == LOAD_CONST: + const = code.co_consts[arg] + elif arg == name_idx and (op == STORE_NAME or op == STORE_GLOBAL): + return const + else: + const = default + + +def _update_globals(): + """ + Patch the globals to remove the objects not available on some platforms. + + XXX it'd be better to test assertions about bytecode instead. + """ + + if not sys.platform.startswith('java') and sys.platform != 'cli': + return + incompatible = 'extract_constant', 'get_module_constant' + for name in incompatible: + del globals()[name] + __all__.remove(name) + + +_update_globals() diff --git a/venv/lib/python3.8/site-packages/setuptools/dist.py b/venv/lib/python3.8/site-packages/setuptools/dist.py new file mode 100644 index 000000000..f22429e8e --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/dist.py @@ -0,0 +1,1274 @@ +# -*- coding: utf-8 -*- +__all__ = ['Distribution'] + +import io +import sys +import re +import os +import warnings +import numbers +import distutils.log +import distutils.core +import distutils.cmd +import distutils.dist +from distutils.util import strtobool +from distutils.debug import DEBUG +from distutils.fancy_getopt import translate_longopt +import itertools + +from collections import defaultdict +from email import message_from_file + +from distutils.errors import ( + DistutilsOptionError, DistutilsPlatformError, DistutilsSetupError, +) +from distutils.util import rfc822_escape +from distutils.version import StrictVersion + +from setuptools.extern import six +from setuptools.extern import packaging +from setuptools.extern import ordered_set +from setuptools.extern.six.moves import map, filter, filterfalse + +from . import SetuptoolsDeprecationWarning + +from setuptools.depends import Require +from setuptools import windows_support +from setuptools.monkey import get_unpatched +from setuptools.config import parse_configuration +import pkg_resources + +__import__('setuptools.extern.packaging.specifiers') +__import__('setuptools.extern.packaging.version') + + +def _get_unpatched(cls): + warnings.warn("Do not call this function", DistDeprecationWarning) + return get_unpatched(cls) + + +def get_metadata_version(self): + mv = getattr(self, 'metadata_version', None) + + if mv is None: + if self.long_description_content_type or self.provides_extras: + mv = StrictVersion('2.1') + elif (self.maintainer is not None or + self.maintainer_email is not None or + getattr(self, 'python_requires', None) is not None or + self.project_urls): + mv = StrictVersion('1.2') + elif (self.provides or self.requires or self.obsoletes or + self.classifiers or self.download_url): + mv = StrictVersion('1.1') + else: + mv = StrictVersion('1.0') + + self.metadata_version = mv + + return mv + + +def read_pkg_file(self, file): + """Reads the metadata values from a file object.""" + msg = message_from_file(file) + + def _read_field(name): + value = msg[name] + if value == 'UNKNOWN': + return None + return value + + def _read_list(name): + values = msg.get_all(name, None) + if values == []: + return None + return values + + self.metadata_version = StrictVersion(msg['metadata-version']) + self.name = _read_field('name') + self.version = _read_field('version') + self.description = _read_field('summary') + # we are filling author only. + self.author = _read_field('author') + self.maintainer = None + self.author_email = _read_field('author-email') + self.maintainer_email = None + self.url = _read_field('home-page') + self.license = _read_field('license') + + if 'download-url' in msg: + self.download_url = _read_field('download-url') + else: + self.download_url = None + + self.long_description = _read_field('description') + self.description = _read_field('summary') + + if 'keywords' in msg: + self.keywords = _read_field('keywords').split(',') + + self.platforms = _read_list('platform') + self.classifiers = _read_list('classifier') + + # PEP 314 - these fields only exist in 1.1 + if self.metadata_version == StrictVersion('1.1'): + self.requires = _read_list('requires') + self.provides = _read_list('provides') + self.obsoletes = _read_list('obsoletes') + else: + self.requires = None + self.provides = None + self.obsoletes = None + + +# Based on Python 3.5 version +def write_pkg_file(self, file): + """Write the PKG-INFO format data to a file object. + """ + version = self.get_metadata_version() + + if six.PY2: + def write_field(key, value): + file.write("%s: %s\n" % (key, self._encode_field(value))) + else: + def write_field(key, value): + file.write("%s: %s\n" % (key, value)) + + write_field('Metadata-Version', str(version)) + write_field('Name', self.get_name()) + write_field('Version', self.get_version()) + write_field('Summary', self.get_description()) + write_field('Home-page', self.get_url()) + + if version < StrictVersion('1.2'): + write_field('Author', self.get_contact()) + write_field('Author-email', self.get_contact_email()) + else: + optional_fields = ( + ('Author', 'author'), + ('Author-email', 'author_email'), + ('Maintainer', 'maintainer'), + ('Maintainer-email', 'maintainer_email'), + ) + + for field, attr in optional_fields: + attr_val = getattr(self, attr) + + if attr_val is not None: + write_field(field, attr_val) + + write_field('License', self.get_license()) + if self.download_url: + write_field('Download-URL', self.download_url) + for project_url in self.project_urls.items(): + write_field('Project-URL', '%s, %s' % project_url) + + long_desc = rfc822_escape(self.get_long_description()) + write_field('Description', long_desc) + + keywords = ','.join(self.get_keywords()) + if keywords: + write_field('Keywords', keywords) + + if version >= StrictVersion('1.2'): + for platform in self.get_platforms(): + write_field('Platform', platform) + else: + self._write_list(file, 'Platform', self.get_platforms()) + + self._write_list(file, 'Classifier', self.get_classifiers()) + + # PEP 314 + self._write_list(file, 'Requires', self.get_requires()) + self._write_list(file, 'Provides', self.get_provides()) + self._write_list(file, 'Obsoletes', self.get_obsoletes()) + + # Setuptools specific for PEP 345 + if hasattr(self, 'python_requires'): + write_field('Requires-Python', self.python_requires) + + # PEP 566 + if self.long_description_content_type: + write_field( + 'Description-Content-Type', + self.long_description_content_type + ) + if self.provides_extras: + for extra in sorted(self.provides_extras): + write_field('Provides-Extra', extra) + + +sequence = tuple, list + + +def check_importable(dist, attr, value): + try: + ep = pkg_resources.EntryPoint.parse('x=' + value) + assert not ep.extras + except (TypeError, ValueError, AttributeError, AssertionError): + raise DistutilsSetupError( + "%r must be importable 'module:attrs' string (got %r)" + % (attr, value) + ) + + +def assert_string_list(dist, attr, value): + """Verify that value is a string list""" + try: + # verify that value is a list or tuple to exclude unordered + # or single-use iterables + assert isinstance(value, (list, tuple)) + # verify that elements of value are strings + assert ''.join(value) != value + except (TypeError, ValueError, AttributeError, AssertionError): + raise DistutilsSetupError( + "%r must be a list of strings (got %r)" % (attr, value) + ) + + +def check_nsp(dist, attr, value): + """Verify that namespace packages are valid""" + ns_packages = value + assert_string_list(dist, attr, ns_packages) + for nsp in ns_packages: + if not dist.has_contents_for(nsp): + raise DistutilsSetupError( + "Distribution contains no modules or packages for " + + "namespace package %r" % nsp + ) + parent, sep, child = nsp.rpartition('.') + if parent and parent not in ns_packages: + distutils.log.warn( + "WARNING: %r is declared as a package namespace, but %r" + " is not: please correct this in setup.py", nsp, parent + ) + + +def check_extras(dist, attr, value): + """Verify that extras_require mapping is valid""" + try: + list(itertools.starmap(_check_extra, value.items())) + except (TypeError, ValueError, AttributeError): + raise DistutilsSetupError( + "'extras_require' must be a dictionary whose values are " + "strings or lists of strings containing valid project/version " + "requirement specifiers." + ) + + +def _check_extra(extra, reqs): + name, sep, marker = extra.partition(':') + if marker and pkg_resources.invalid_marker(marker): + raise DistutilsSetupError("Invalid environment marker: " + marker) + list(pkg_resources.parse_requirements(reqs)) + + +def assert_bool(dist, attr, value): + """Verify that value is True, False, 0, or 1""" + if bool(value) != value: + tmpl = "{attr!r} must be a boolean value (got {value!r})" + raise DistutilsSetupError(tmpl.format(attr=attr, value=value)) + + +def check_requirements(dist, attr, value): + """Verify that install_requires is a valid requirements list""" + try: + list(pkg_resources.parse_requirements(value)) + if isinstance(value, (dict, set)): + raise TypeError("Unordered types are not allowed") + except (TypeError, ValueError) as error: + tmpl = ( + "{attr!r} must be a string or list of strings " + "containing valid project/version requirement specifiers; {error}" + ) + raise DistutilsSetupError(tmpl.format(attr=attr, error=error)) + + +def check_specifier(dist, attr, value): + """Verify that value is a valid version specifier""" + try: + packaging.specifiers.SpecifierSet(value) + except packaging.specifiers.InvalidSpecifier as error: + tmpl = ( + "{attr!r} must be a string " + "containing valid version specifiers; {error}" + ) + raise DistutilsSetupError(tmpl.format(attr=attr, error=error)) + + +def check_entry_points(dist, attr, value): + """Verify that entry_points map is parseable""" + try: + pkg_resources.EntryPoint.parse_map(value) + except ValueError as e: + raise DistutilsSetupError(e) + + +def check_test_suite(dist, attr, value): + if not isinstance(value, six.string_types): + raise DistutilsSetupError("test_suite must be a string") + + +def check_package_data(dist, attr, value): + """Verify that value is a dictionary of package names to glob lists""" + if not isinstance(value, dict): + raise DistutilsSetupError( + "{!r} must be a dictionary mapping package names to lists of " + "string wildcard patterns".format(attr)) + for k, v in value.items(): + if not isinstance(k, six.string_types): + raise DistutilsSetupError( + "keys of {!r} dict must be strings (got {!r})" + .format(attr, k) + ) + assert_string_list(dist, 'values of {!r} dict'.format(attr), v) + + +def check_packages(dist, attr, value): + for pkgname in value: + if not re.match(r'\w+(\.\w+)*', pkgname): + distutils.log.warn( + "WARNING: %r not a valid package name; please use only " + ".-separated package names in setup.py", pkgname + ) + + +_Distribution = get_unpatched(distutils.core.Distribution) + + +class Distribution(_Distribution): + """Distribution with support for features, tests, and package data + + This is an enhanced version of 'distutils.dist.Distribution' that + effectively adds the following new optional keyword arguments to 'setup()': + + 'install_requires' -- a string or sequence of strings specifying project + versions that the distribution requires when installed, in the format + used by 'pkg_resources.require()'. They will be installed + automatically when the package is installed. If you wish to use + packages that are not available in PyPI, or want to give your users an + alternate download location, you can add a 'find_links' option to the + '[easy_install]' section of your project's 'setup.cfg' file, and then + setuptools will scan the listed web pages for links that satisfy the + requirements. + + 'extras_require' -- a dictionary mapping names of optional "extras" to the + additional requirement(s) that using those extras incurs. For example, + this:: + + extras_require = dict(reST = ["docutils>=0.3", "reSTedit"]) + + indicates that the distribution can optionally provide an extra + capability called "reST", but it can only be used if docutils and + reSTedit are installed. If the user installs your package using + EasyInstall and requests one of your extras, the corresponding + additional requirements will be installed if needed. + + 'features' **deprecated** -- a dictionary mapping option names to + 'setuptools.Feature' + objects. Features are a portion of the distribution that can be + included or excluded based on user options, inter-feature dependencies, + and availability on the current system. Excluded features are omitted + from all setup commands, including source and binary distributions, so + you can create multiple distributions from the same source tree. + Feature names should be valid Python identifiers, except that they may + contain the '-' (minus) sign. Features can be included or excluded + via the command line options '--with-X' and '--without-X', where 'X' is + the name of the feature. Whether a feature is included by default, and + whether you are allowed to control this from the command line, is + determined by the Feature object. See the 'Feature' class for more + information. + + 'test_suite' -- the name of a test suite to run for the 'test' command. + If the user runs 'python setup.py test', the package will be installed, + and the named test suite will be run. The format is the same as + would be used on a 'unittest.py' command line. That is, it is the + dotted name of an object to import and call to generate a test suite. + + 'package_data' -- a dictionary mapping package names to lists of filenames + or globs to use to find data files contained in the named packages. + If the dictionary has filenames or globs listed under '""' (the empty + string), those names will be searched for in every package, in addition + to any names for the specific package. Data files found using these + names/globs will be installed along with the package, in the same + location as the package. Note that globs are allowed to reference + the contents of non-package subdirectories, as long as you use '/' as + a path separator. (Globs are automatically converted to + platform-specific paths at runtime.) + + In addition to these new keywords, this class also has several new methods + for manipulating the distribution's contents. For example, the 'include()' + and 'exclude()' methods can be thought of as in-place add and subtract + commands that add or remove packages, modules, extensions, and so on from + the distribution. They are used by the feature subsystem to configure the + distribution for the included and excluded features. + """ + + _DISTUTILS_UNSUPPORTED_METADATA = { + 'long_description_content_type': None, + 'project_urls': dict, + 'provides_extras': ordered_set.OrderedSet, + 'license_files': ordered_set.OrderedSet, + } + + _patched_dist = None + + def patch_missing_pkg_info(self, attrs): + # Fake up a replacement for the data that would normally come from + # PKG-INFO, but which might not yet be built if this is a fresh + # checkout. + # + if not attrs or 'name' not in attrs or 'version' not in attrs: + return + key = pkg_resources.safe_name(str(attrs['name'])).lower() + dist = pkg_resources.working_set.by_key.get(key) + if dist is not None and not dist.has_metadata('PKG-INFO'): + dist._version = pkg_resources.safe_version(str(attrs['version'])) + self._patched_dist = dist + + def __init__(self, attrs=None): + have_package_data = hasattr(self, "package_data") + if not have_package_data: + self.package_data = {} + attrs = attrs or {} + if 'features' in attrs or 'require_features' in attrs: + Feature.warn_deprecated() + self.require_features = [] + self.features = {} + self.dist_files = [] + # Filter-out setuptools' specific options. + self.src_root = attrs.pop("src_root", None) + self.patch_missing_pkg_info(attrs) + self.dependency_links = attrs.pop('dependency_links', []) + self.setup_requires = attrs.pop('setup_requires', []) + for ep in pkg_resources.iter_entry_points('distutils.setup_keywords'): + vars(self).setdefault(ep.name, None) + _Distribution.__init__(self, { + k: v for k, v in attrs.items() + if k not in self._DISTUTILS_UNSUPPORTED_METADATA + }) + + # Fill-in missing metadata fields not supported by distutils. + # Note some fields may have been set by other tools (e.g. pbr) + # above; they are taken preferrentially to setup() arguments + for option, default in self._DISTUTILS_UNSUPPORTED_METADATA.items(): + for source in self.metadata.__dict__, attrs: + if option in source: + value = source[option] + break + else: + value = default() if default else None + setattr(self.metadata, option, value) + + if isinstance(self.metadata.version, numbers.Number): + # Some people apparently take "version number" too literally :) + self.metadata.version = str(self.metadata.version) + + if self.metadata.version is not None: + try: + ver = packaging.version.Version(self.metadata.version) + normalized_version = str(ver) + if self.metadata.version != normalized_version: + warnings.warn( + "Normalizing '%s' to '%s'" % ( + self.metadata.version, + normalized_version, + ) + ) + self.metadata.version = normalized_version + except (packaging.version.InvalidVersion, TypeError): + warnings.warn( + "The version specified (%r) is an invalid version, this " + "may not work as expected with newer versions of " + "setuptools, pip, and PyPI. Please see PEP 440 for more " + "details." % self.metadata.version + ) + self._finalize_requires() + + def _finalize_requires(self): + """ + Set `metadata.python_requires` and fix environment markers + in `install_requires` and `extras_require`. + """ + if getattr(self, 'python_requires', None): + self.metadata.python_requires = self.python_requires + + if getattr(self, 'extras_require', None): + for extra in self.extras_require.keys(): + # Since this gets called multiple times at points where the + # keys have become 'converted' extras, ensure that we are only + # truly adding extras we haven't seen before here. + extra = extra.split(':')[0] + if extra: + self.metadata.provides_extras.add(extra) + + self._convert_extras_requirements() + self._move_install_requirements_markers() + + def _convert_extras_requirements(self): + """ + Convert requirements in `extras_require` of the form + `"extra": ["barbazquux; {marker}"]` to + `"extra:{marker}": ["barbazquux"]`. + """ + spec_ext_reqs = getattr(self, 'extras_require', None) or {} + self._tmp_extras_require = defaultdict(list) + for section, v in spec_ext_reqs.items(): + # Do not strip empty sections. + self._tmp_extras_require[section] + for r in pkg_resources.parse_requirements(v): + suffix = self._suffix_for(r) + self._tmp_extras_require[section + suffix].append(r) + + @staticmethod + def _suffix_for(req): + """ + For a requirement, return the 'extras_require' suffix for + that requirement. + """ + return ':' + str(req.marker) if req.marker else '' + + def _move_install_requirements_markers(self): + """ + Move requirements in `install_requires` that are using environment + markers `extras_require`. + """ + + # divide the install_requires into two sets, simple ones still + # handled by install_requires and more complex ones handled + # by extras_require. + + def is_simple_req(req): + return not req.marker + + spec_inst_reqs = getattr(self, 'install_requires', None) or () + inst_reqs = list(pkg_resources.parse_requirements(spec_inst_reqs)) + simple_reqs = filter(is_simple_req, inst_reqs) + complex_reqs = filterfalse(is_simple_req, inst_reqs) + self.install_requires = list(map(str, simple_reqs)) + + for r in complex_reqs: + self._tmp_extras_require[':' + str(r.marker)].append(r) + self.extras_require = dict( + (k, [str(r) for r in map(self._clean_req, v)]) + for k, v in self._tmp_extras_require.items() + ) + + def _clean_req(self, req): + """ + Given a Requirement, remove environment markers and return it. + """ + req.marker = None + return req + + def _parse_config_files(self, filenames=None): + """ + Adapted from distutils.dist.Distribution.parse_config_files, + this method provides the same functionality in subtly-improved + ways. + """ + from setuptools.extern.six.moves.configparser import ConfigParser + + # Ignore install directory options if we have a venv + if six.PY3 and sys.prefix != sys.base_prefix: + ignore_options = [ + 'install-base', 'install-platbase', 'install-lib', + 'install-platlib', 'install-purelib', 'install-headers', + 'install-scripts', 'install-data', 'prefix', 'exec-prefix', + 'home', 'user', 'root'] + else: + ignore_options = [] + + ignore_options = frozenset(ignore_options) + + if filenames is None: + filenames = self.find_config_files() + + if DEBUG: + self.announce("Distribution.parse_config_files():") + + parser = ConfigParser() + for filename in filenames: + with io.open(filename, encoding='utf-8') as reader: + if DEBUG: + self.announce(" reading {filename}".format(**locals())) + (parser.read_file if six.PY3 else parser.readfp)(reader) + for section in parser.sections(): + options = parser.options(section) + opt_dict = self.get_option_dict(section) + + for opt in options: + if opt != '__name__' and opt not in ignore_options: + val = self._try_str(parser.get(section, opt)) + opt = opt.replace('-', '_') + opt_dict[opt] = (filename, val) + + # Make the ConfigParser forget everything (so we retain + # the original filenames that options come from) + parser.__init__() + + # If there was a "global" section in the config file, use it + # to set Distribution options. + + if 'global' in self.command_options: + for (opt, (src, val)) in self.command_options['global'].items(): + alias = self.negative_opt.get(opt) + try: + if alias: + setattr(self, alias, not strtobool(val)) + elif opt in ('verbose', 'dry_run'): # ugh! + setattr(self, opt, strtobool(val)) + else: + setattr(self, opt, val) + except ValueError as msg: + raise DistutilsOptionError(msg) + + @staticmethod + def _try_str(val): + """ + On Python 2, much of distutils relies on string values being of + type 'str' (bytes) and not unicode text. If the value can be safely + encoded to bytes using the default encoding, prefer that. + + Why the default encoding? Because that value can be implicitly + decoded back to text if needed. + + Ref #1653 + """ + if six.PY3: + return val + try: + return val.encode() + except UnicodeEncodeError: + pass + return val + + def _set_command_options(self, command_obj, option_dict=None): + """ + Set the options for 'command_obj' from 'option_dict'. Basically + this means copying elements of a dictionary ('option_dict') to + attributes of an instance ('command'). + + 'command_obj' must be a Command instance. If 'option_dict' is not + supplied, uses the standard option dictionary for this command + (from 'self.command_options'). + + (Adopted from distutils.dist.Distribution._set_command_options) + """ + command_name = command_obj.get_command_name() + if option_dict is None: + option_dict = self.get_option_dict(command_name) + + if DEBUG: + self.announce(" setting options for '%s' command:" % command_name) + for (option, (source, value)) in option_dict.items(): + if DEBUG: + self.announce(" %s = %s (from %s)" % (option, value, + source)) + try: + bool_opts = [translate_longopt(o) + for o in command_obj.boolean_options] + except AttributeError: + bool_opts = [] + try: + neg_opt = command_obj.negative_opt + except AttributeError: + neg_opt = {} + + try: + is_string = isinstance(value, six.string_types) + if option in neg_opt and is_string: + setattr(command_obj, neg_opt[option], not strtobool(value)) + elif option in bool_opts and is_string: + setattr(command_obj, option, strtobool(value)) + elif hasattr(command_obj, option): + setattr(command_obj, option, value) + else: + raise DistutilsOptionError( + "error in %s: command '%s' has no such option '%s'" + % (source, command_name, option)) + except ValueError as msg: + raise DistutilsOptionError(msg) + + def parse_config_files(self, filenames=None, ignore_option_errors=False): + """Parses configuration files from various levels + and loads configuration. + + """ + self._parse_config_files(filenames=filenames) + + parse_configuration(self, self.command_options, + ignore_option_errors=ignore_option_errors) + self._finalize_requires() + + def parse_command_line(self): + """Process features after parsing command line options""" + result = _Distribution.parse_command_line(self) + if self.features: + self._finalize_features() + return result + + def _feature_attrname(self, name): + """Convert feature name to corresponding option attribute name""" + return 'with_' + name.replace('-', '_') + + def fetch_build_eggs(self, requires): + """Resolve pre-setup requirements""" + resolved_dists = pkg_resources.working_set.resolve( + pkg_resources.parse_requirements(requires), + installer=self.fetch_build_egg, + replace_conflicting=True, + ) + for dist in resolved_dists: + pkg_resources.working_set.add(dist, replace=True) + return resolved_dists + + def finalize_options(self): + """ + Allow plugins to apply arbitrary operations to the + distribution. Each hook may optionally define a 'order' + to influence the order of execution. Smaller numbers + go first and the default is 0. + """ + hook_key = 'setuptools.finalize_distribution_options' + + def by_order(hook): + return getattr(hook, 'order', 0) + eps = pkg_resources.iter_entry_points(hook_key) + for ep in sorted(eps, key=by_order): + ep.load()(self) + + def _finalize_setup_keywords(self): + for ep in pkg_resources.iter_entry_points('distutils.setup_keywords'): + value = getattr(self, ep.name, None) + if value is not None: + ep.require(installer=self.fetch_build_egg) + ep.load()(self, ep.name, value) + + def _finalize_2to3_doctests(self): + if getattr(self, 'convert_2to3_doctests', None): + # XXX may convert to set here when we can rely on set being builtin + self.convert_2to3_doctests = [ + os.path.abspath(p) + for p in self.convert_2to3_doctests + ] + else: + self.convert_2to3_doctests = [] + + def get_egg_cache_dir(self): + egg_cache_dir = os.path.join(os.curdir, '.eggs') + if not os.path.exists(egg_cache_dir): + os.mkdir(egg_cache_dir) + windows_support.hide_file(egg_cache_dir) + readme_txt_filename = os.path.join(egg_cache_dir, 'README.txt') + with open(readme_txt_filename, 'w') as f: + f.write('This directory contains eggs that were downloaded ' + 'by setuptools to build, test, and run plug-ins.\n\n') + f.write('This directory caches those eggs to prevent ' + 'repeated downloads.\n\n') + f.write('However, it is safe to delete this directory.\n\n') + + return egg_cache_dir + + def fetch_build_egg(self, req): + """Fetch an egg needed for building""" + from setuptools.installer import fetch_build_egg + return fetch_build_egg(self, req) + + def _finalize_feature_opts(self): + """Add --with-X/--without-X options based on optional features""" + + if not self.features: + return + + go = [] + no = self.negative_opt.copy() + + for name, feature in self.features.items(): + self._set_feature(name, None) + feature.validate(self) + + if feature.optional: + descr = feature.description + incdef = ' (default)' + excdef = '' + if not feature.include_by_default(): + excdef, incdef = incdef, excdef + + new = ( + ('with-' + name, None, 'include ' + descr + incdef), + ('without-' + name, None, 'exclude ' + descr + excdef), + ) + go.extend(new) + no['without-' + name] = 'with-' + name + + self.global_options = self.feature_options = go + self.global_options + self.negative_opt = self.feature_negopt = no + + def _finalize_features(self): + """Add/remove features and resolve dependencies between them""" + + # First, flag all the enabled items (and thus their dependencies) + for name, feature in self.features.items(): + enabled = self.feature_is_included(name) + if enabled or (enabled is None and feature.include_by_default()): + feature.include_in(self) + self._set_feature(name, 1) + + # Then disable the rest, so that off-by-default features don't + # get flagged as errors when they're required by an enabled feature + for name, feature in self.features.items(): + if not self.feature_is_included(name): + feature.exclude_from(self) + self._set_feature(name, 0) + + def get_command_class(self, command): + """Pluggable version of get_command_class()""" + if command in self.cmdclass: + return self.cmdclass[command] + + eps = pkg_resources.iter_entry_points('distutils.commands', command) + for ep in eps: + ep.require(installer=self.fetch_build_egg) + self.cmdclass[command] = cmdclass = ep.load() + return cmdclass + else: + return _Distribution.get_command_class(self, command) + + def print_commands(self): + for ep in pkg_resources.iter_entry_points('distutils.commands'): + if ep.name not in self.cmdclass: + # don't require extras as the commands won't be invoked + cmdclass = ep.resolve() + self.cmdclass[ep.name] = cmdclass + return _Distribution.print_commands(self) + + def get_command_list(self): + for ep in pkg_resources.iter_entry_points('distutils.commands'): + if ep.name not in self.cmdclass: + # don't require extras as the commands won't be invoked + cmdclass = ep.resolve() + self.cmdclass[ep.name] = cmdclass + return _Distribution.get_command_list(self) + + def _set_feature(self, name, status): + """Set feature's inclusion status""" + setattr(self, self._feature_attrname(name), status) + + def feature_is_included(self, name): + """Return 1 if feature is included, 0 if excluded, 'None' if unknown""" + return getattr(self, self._feature_attrname(name)) + + def include_feature(self, name): + """Request inclusion of feature named 'name'""" + + if self.feature_is_included(name) == 0: + descr = self.features[name].description + raise DistutilsOptionError( + descr + " is required, but was excluded or is not available" + ) + self.features[name].include_in(self) + self._set_feature(name, 1) + + def include(self, **attrs): + """Add items to distribution that are named in keyword arguments + + For example, 'dist.include(py_modules=["x"])' would add 'x' to + the distribution's 'py_modules' attribute, if it was not already + there. + + Currently, this method only supports inclusion for attributes that are + lists or tuples. If you need to add support for adding to other + attributes in this or a subclass, you can add an '_include_X' method, + where 'X' is the name of the attribute. The method will be called with + the value passed to 'include()'. So, 'dist.include(foo={"bar":"baz"})' + will try to call 'dist._include_foo({"bar":"baz"})', which can then + handle whatever special inclusion logic is needed. + """ + for k, v in attrs.items(): + include = getattr(self, '_include_' + k, None) + if include: + include(v) + else: + self._include_misc(k, v) + + def exclude_package(self, package): + """Remove packages, modules, and extensions in named package""" + + pfx = package + '.' + if self.packages: + self.packages = [ + p for p in self.packages + if p != package and not p.startswith(pfx) + ] + + if self.py_modules: + self.py_modules = [ + p for p in self.py_modules + if p != package and not p.startswith(pfx) + ] + + if self.ext_modules: + self.ext_modules = [ + p for p in self.ext_modules + if p.name != package and not p.name.startswith(pfx) + ] + + def has_contents_for(self, package): + """Return true if 'exclude_package(package)' would do something""" + + pfx = package + '.' + + for p in self.iter_distribution_names(): + if p == package or p.startswith(pfx): + return True + + def _exclude_misc(self, name, value): + """Handle 'exclude()' for list/tuple attrs without a special handler""" + if not isinstance(value, sequence): + raise DistutilsSetupError( + "%s: setting must be a list or tuple (%r)" % (name, value) + ) + try: + old = getattr(self, name) + except AttributeError: + raise DistutilsSetupError( + "%s: No such distribution setting" % name + ) + if old is not None and not isinstance(old, sequence): + raise DistutilsSetupError( + name + ": this setting cannot be changed via include/exclude" + ) + elif old: + setattr(self, name, [item for item in old if item not in value]) + + def _include_misc(self, name, value): + """Handle 'include()' for list/tuple attrs without a special handler""" + + if not isinstance(value, sequence): + raise DistutilsSetupError( + "%s: setting must be a list (%r)" % (name, value) + ) + try: + old = getattr(self, name) + except AttributeError: + raise DistutilsSetupError( + "%s: No such distribution setting" % name + ) + if old is None: + setattr(self, name, value) + elif not isinstance(old, sequence): + raise DistutilsSetupError( + name + ": this setting cannot be changed via include/exclude" + ) + else: + new = [item for item in value if item not in old] + setattr(self, name, old + new) + + def exclude(self, **attrs): + """Remove items from distribution that are named in keyword arguments + + For example, 'dist.exclude(py_modules=["x"])' would remove 'x' from + the distribution's 'py_modules' attribute. Excluding packages uses + the 'exclude_package()' method, so all of the package's contained + packages, modules, and extensions are also excluded. + + Currently, this method only supports exclusion from attributes that are + lists or tuples. If you need to add support for excluding from other + attributes in this or a subclass, you can add an '_exclude_X' method, + where 'X' is the name of the attribute. The method will be called with + the value passed to 'exclude()'. So, 'dist.exclude(foo={"bar":"baz"})' + will try to call 'dist._exclude_foo({"bar":"baz"})', which can then + handle whatever special exclusion logic is needed. + """ + for k, v in attrs.items(): + exclude = getattr(self, '_exclude_' + k, None) + if exclude: + exclude(v) + else: + self._exclude_misc(k, v) + + def _exclude_packages(self, packages): + if not isinstance(packages, sequence): + raise DistutilsSetupError( + "packages: setting must be a list or tuple (%r)" % (packages,) + ) + list(map(self.exclude_package, packages)) + + def _parse_command_opts(self, parser, args): + # Remove --with-X/--without-X options when processing command args + self.global_options = self.__class__.global_options + self.negative_opt = self.__class__.negative_opt + + # First, expand any aliases + command = args[0] + aliases = self.get_option_dict('aliases') + while command in aliases: + src, alias = aliases[command] + del aliases[command] # ensure each alias can expand only once! + import shlex + args[:1] = shlex.split(alias, True) + command = args[0] + + nargs = _Distribution._parse_command_opts(self, parser, args) + + # Handle commands that want to consume all remaining arguments + cmd_class = self.get_command_class(command) + if getattr(cmd_class, 'command_consumes_arguments', None): + self.get_option_dict(command)['args'] = ("command line", nargs) + if nargs is not None: + return [] + + return nargs + + def get_cmdline_options(self): + """Return a '{cmd: {opt:val}}' map of all command-line options + + Option names are all long, but do not include the leading '--', and + contain dashes rather than underscores. If the option doesn't take + an argument (e.g. '--quiet'), the 'val' is 'None'. + + Note that options provided by config files are intentionally excluded. + """ + + d = {} + + for cmd, opts in self.command_options.items(): + + for opt, (src, val) in opts.items(): + + if src != "command line": + continue + + opt = opt.replace('_', '-') + + if val == 0: + cmdobj = self.get_command_obj(cmd) + neg_opt = self.negative_opt.copy() + neg_opt.update(getattr(cmdobj, 'negative_opt', {})) + for neg, pos in neg_opt.items(): + if pos == opt: + opt = neg + val = None + break + else: + raise AssertionError("Shouldn't be able to get here") + + elif val == 1: + val = None + + d.setdefault(cmd, {})[opt] = val + + return d + + def iter_distribution_names(self): + """Yield all packages, modules, and extension names in distribution""" + + for pkg in self.packages or (): + yield pkg + + for module in self.py_modules or (): + yield module + + for ext in self.ext_modules or (): + if isinstance(ext, tuple): + name, buildinfo = ext + else: + name = ext.name + if name.endswith('module'): + name = name[:-6] + yield name + + def handle_display_options(self, option_order): + """If there were any non-global "display-only" options + (--help-commands or the metadata display options) on the command + line, display the requested info and return true; else return + false. + """ + import sys + + if six.PY2 or self.help_commands: + return _Distribution.handle_display_options(self, option_order) + + # Stdout may be StringIO (e.g. in tests) + if not isinstance(sys.stdout, io.TextIOWrapper): + return _Distribution.handle_display_options(self, option_order) + + # Don't wrap stdout if utf-8 is already the encoding. Provides + # workaround for #334. + if sys.stdout.encoding.lower() in ('utf-8', 'utf8'): + return _Distribution.handle_display_options(self, option_order) + + # Print metadata in UTF-8 no matter the platform + encoding = sys.stdout.encoding + errors = sys.stdout.errors + newline = sys.platform != 'win32' and '\n' or None + line_buffering = sys.stdout.line_buffering + + sys.stdout = io.TextIOWrapper( + sys.stdout.detach(), 'utf-8', errors, newline, line_buffering) + try: + return _Distribution.handle_display_options(self, option_order) + finally: + sys.stdout = io.TextIOWrapper( + sys.stdout.detach(), encoding, errors, newline, line_buffering) + + +class Feature: + """ + **deprecated** -- The `Feature` facility was never completely implemented + or supported, `has reported issues + `_ and will be removed in + a future version. + + A subset of the distribution that can be excluded if unneeded/wanted + + Features are created using these keyword arguments: + + 'description' -- a short, human readable description of the feature, to + be used in error messages, and option help messages. + + 'standard' -- if true, the feature is included by default if it is + available on the current system. Otherwise, the feature is only + included if requested via a command line '--with-X' option, or if + another included feature requires it. The default setting is 'False'. + + 'available' -- if true, the feature is available for installation on the + current system. The default setting is 'True'. + + 'optional' -- if true, the feature's inclusion can be controlled from the + command line, using the '--with-X' or '--without-X' options. If + false, the feature's inclusion status is determined automatically, + based on 'availabile', 'standard', and whether any other feature + requires it. The default setting is 'True'. + + 'require_features' -- a string or sequence of strings naming features + that should also be included if this feature is included. Defaults to + empty list. May also contain 'Require' objects that should be + added/removed from the distribution. + + 'remove' -- a string or list of strings naming packages to be removed + from the distribution if this feature is *not* included. If the + feature *is* included, this argument is ignored. This argument exists + to support removing features that "crosscut" a distribution, such as + defining a 'tests' feature that removes all the 'tests' subpackages + provided by other features. The default for this argument is an empty + list. (Note: the named package(s) or modules must exist in the base + distribution when the 'setup()' function is initially called.) + + other keywords -- any other keyword arguments are saved, and passed to + the distribution's 'include()' and 'exclude()' methods when the + feature is included or excluded, respectively. So, for example, you + could pass 'packages=["a","b"]' to cause packages 'a' and 'b' to be + added or removed from the distribution as appropriate. + + A feature must include at least one 'requires', 'remove', or other + keyword argument. Otherwise, it can't affect the distribution in any way. + Note also that you can subclass 'Feature' to create your own specialized + feature types that modify the distribution in other ways when included or + excluded. See the docstrings for the various methods here for more detail. + Aside from the methods, the only feature attributes that distributions look + at are 'description' and 'optional'. + """ + + @staticmethod + def warn_deprecated(): + msg = ( + "Features are deprecated and will be removed in a future " + "version. See https://github.com/pypa/setuptools/issues/65." + ) + warnings.warn(msg, DistDeprecationWarning, stacklevel=3) + + def __init__( + self, description, standard=False, available=True, + optional=True, require_features=(), remove=(), **extras): + self.warn_deprecated() + + self.description = description + self.standard = standard + self.available = available + self.optional = optional + if isinstance(require_features, (str, Require)): + require_features = require_features, + + self.require_features = [ + r for r in require_features if isinstance(r, str) + ] + er = [r for r in require_features if not isinstance(r, str)] + if er: + extras['require_features'] = er + + if isinstance(remove, str): + remove = remove, + self.remove = remove + self.extras = extras + + if not remove and not require_features and not extras: + raise DistutilsSetupError( + "Feature %s: must define 'require_features', 'remove', or " + "at least one of 'packages', 'py_modules', etc." + ) + + def include_by_default(self): + """Should this feature be included by default?""" + return self.available and self.standard + + def include_in(self, dist): + """Ensure feature and its requirements are included in distribution + + You may override this in a subclass to perform additional operations on + the distribution. Note that this method may be called more than once + per feature, and so should be idempotent. + + """ + + if not self.available: + raise DistutilsPlatformError( + self.description + " is required, " + "but is not available on this platform" + ) + + dist.include(**self.extras) + + for f in self.require_features: + dist.include_feature(f) + + def exclude_from(self, dist): + """Ensure feature is excluded from distribution + + You may override this in a subclass to perform additional operations on + the distribution. This method will be called at most once per + feature, and only after all included features have been asked to + include themselves. + """ + + dist.exclude(**self.extras) + + if self.remove: + for item in self.remove: + dist.exclude_package(item) + + def validate(self, dist): + """Verify that feature makes sense in context of distribution + + This method is called by the distribution just before it parses its + command line. It checks to ensure that the 'remove' attribute, if any, + contains only valid package/module names that are present in the base + distribution when 'setup()' is called. You may override it in a + subclass to perform any other required validation of the feature + against a target distribution. + """ + + for item in self.remove: + if not dist.has_contents_for(item): + raise DistutilsSetupError( + "%s wants to be able to remove %s, but the distribution" + " doesn't contain any packages or modules under %s" + % (self.description, item, item) + ) + + +class DistDeprecationWarning(SetuptoolsDeprecationWarning): + """Class for warning about deprecations in dist in + setuptools. Not ignored by default, unlike DeprecationWarning.""" diff --git a/venv/lib/python3.8/site-packages/setuptools/errors.py b/venv/lib/python3.8/site-packages/setuptools/errors.py new file mode 100644 index 000000000..2701747f5 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/errors.py @@ -0,0 +1,16 @@ +"""setuptools.errors + +Provides exceptions used by setuptools modules. +""" + +from distutils.errors import DistutilsError + + +class RemovedCommandError(DistutilsError, RuntimeError): + """Error used for commands that have been removed in setuptools. + + Since ``setuptools`` is built on ``distutils``, simply removing a command + from ``setuptools`` will make the behavior fall back to ``distutils``; this + error is raised if a command exists in ``distutils`` but has been actively + removed in ``setuptools``. + """ diff --git a/venv/lib/python3.8/site-packages/setuptools/extension.py b/venv/lib/python3.8/site-packages/setuptools/extension.py new file mode 100644 index 000000000..29468894f --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/extension.py @@ -0,0 +1,57 @@ +import re +import functools +import distutils.core +import distutils.errors +import distutils.extension + +from setuptools.extern.six.moves import map + +from .monkey import get_unpatched + + +def _have_cython(): + """ + Return True if Cython can be imported. + """ + cython_impl = 'Cython.Distutils.build_ext' + try: + # from (cython_impl) import build_ext + __import__(cython_impl, fromlist=['build_ext']).build_ext + return True + except Exception: + pass + return False + + +# for compatibility +have_pyrex = _have_cython + +_Extension = get_unpatched(distutils.core.Extension) + + +class Extension(_Extension): + """Extension that uses '.c' files in place of '.pyx' files""" + + def __init__(self, name, sources, *args, **kw): + # The *args is needed for compatibility as calls may use positional + # arguments. py_limited_api may be set only via keyword. + self.py_limited_api = kw.pop("py_limited_api", False) + _Extension.__init__(self, name, sources, *args, **kw) + + def _convert_pyx_sources_to_lang(self): + """ + Replace sources with .pyx extensions to sources with the target + language extension. This mechanism allows language authors to supply + pre-converted sources but to prefer the .pyx sources. + """ + if _have_cython(): + # the build has Cython, so allow it to compile the .pyx files + return + lang = self.language or '' + target_ext = '.cpp' if lang.lower() == 'c++' else '.c' + sub = functools.partial(re.sub, '.pyx$', target_ext) + self.sources = list(map(sub, self.sources)) + + +class Library(Extension): + """Just like a regular Extension, but built as a library instead""" diff --git a/venv/lib/python3.8/site-packages/setuptools/extern/__init__.py b/venv/lib/python3.8/site-packages/setuptools/extern/__init__.py new file mode 100644 index 000000000..e8c616f91 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/extern/__init__.py @@ -0,0 +1,73 @@ +import sys + + +class VendorImporter: + """ + A PEP 302 meta path importer for finding optionally-vendored + or otherwise naturally-installed packages from root_name. + """ + + def __init__(self, root_name, vendored_names=(), vendor_pkg=None): + self.root_name = root_name + self.vendored_names = set(vendored_names) + self.vendor_pkg = vendor_pkg or root_name.replace('extern', '_vendor') + + @property + def search_path(self): + """ + Search first the vendor package then as a natural package. + """ + yield self.vendor_pkg + '.' + yield '' + + def find_module(self, fullname, path=None): + """ + Return self when fullname starts with root_name and the + target module is one vendored through this importer. + """ + root, base, target = fullname.partition(self.root_name + '.') + if root: + return + if not any(map(target.startswith, self.vendored_names)): + return + return self + + def load_module(self, fullname): + """ + Iterate over the search path to locate and load fullname. + """ + root, base, target = fullname.partition(self.root_name + '.') + for prefix in self.search_path: + try: + extant = prefix + target + __import__(extant) + mod = sys.modules[extant] + sys.modules[fullname] = mod + # mysterious hack: + # Remove the reference to the extant package/module + # on later Python versions to cause relative imports + # in the vendor package to resolve the same modules + # as those going through this importer. + if sys.version_info >= (3, ): + del sys.modules[extant] + return mod + except ImportError: + pass + else: + raise ImportError( + "The '{target}' package is required; " + "normally this is bundled with this package so if you get " + "this warning, consult the packager of your " + "distribution.".format(**locals()) + ) + + def install(self): + """ + Install this importer into sys.meta_path if not already present. + """ + if self not in sys.meta_path: + sys.meta_path.append(self) + + +names = 'six', 'packaging', 'pyparsing', 'ordered_set', +VendorImporter(__name__, names, 'setuptools._vendor').install() diff --git a/venv/lib/python3.8/site-packages/setuptools/glob.py b/venv/lib/python3.8/site-packages/setuptools/glob.py new file mode 100644 index 000000000..9d7cbc5da --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/glob.py @@ -0,0 +1,174 @@ +""" +Filename globbing utility. Mostly a copy of `glob` from Python 3.5. + +Changes include: + * `yield from` and PEP3102 `*` removed. + * Hidden files are not ignored. +""" + +import os +import re +import fnmatch + +__all__ = ["glob", "iglob", "escape"] + + +def glob(pathname, recursive=False): + """Return a list of paths matching a pathname pattern. + + The pattern may contain simple shell-style wildcards a la + fnmatch. However, unlike fnmatch, filenames starting with a + dot are special cases that are not matched by '*' and '?' + patterns. + + If recursive is true, the pattern '**' will match any files and + zero or more directories and subdirectories. + """ + return list(iglob(pathname, recursive=recursive)) + + +def iglob(pathname, recursive=False): + """Return an iterator which yields the paths matching a pathname pattern. + + The pattern may contain simple shell-style wildcards a la + fnmatch. However, unlike fnmatch, filenames starting with a + dot are special cases that are not matched by '*' and '?' + patterns. + + If recursive is true, the pattern '**' will match any files and + zero or more directories and subdirectories. + """ + it = _iglob(pathname, recursive) + if recursive and _isrecursive(pathname): + s = next(it) # skip empty string + assert not s + return it + + +def _iglob(pathname, recursive): + dirname, basename = os.path.split(pathname) + if not has_magic(pathname): + if basename: + if os.path.lexists(pathname): + yield pathname + else: + # Patterns ending with a slash should match only directories + if os.path.isdir(dirname): + yield pathname + return + if not dirname: + if recursive and _isrecursive(basename): + for x in glob2(dirname, basename): + yield x + else: + for x in glob1(dirname, basename): + yield x + return + # `os.path.split()` returns the argument itself as a dirname if it is a + # drive or UNC path. Prevent an infinite recursion if a drive or UNC path + # contains magic characters (i.e. r'\\?\C:'). + if dirname != pathname and has_magic(dirname): + dirs = _iglob(dirname, recursive) + else: + dirs = [dirname] + if has_magic(basename): + if recursive and _isrecursive(basename): + glob_in_dir = glob2 + else: + glob_in_dir = glob1 + else: + glob_in_dir = glob0 + for dirname in dirs: + for name in glob_in_dir(dirname, basename): + yield os.path.join(dirname, name) + + +# These 2 helper functions non-recursively glob inside a literal directory. +# They return a list of basenames. `glob1` accepts a pattern while `glob0` +# takes a literal basename (so it only has to check for its existence). + + +def glob1(dirname, pattern): + if not dirname: + if isinstance(pattern, bytes): + dirname = os.curdir.encode('ASCII') + else: + dirname = os.curdir + try: + names = os.listdir(dirname) + except OSError: + return [] + return fnmatch.filter(names, pattern) + + +def glob0(dirname, basename): + if not basename: + # `os.path.split()` returns an empty basename for paths ending with a + # directory separator. 'q*x/' should match only directories. + if os.path.isdir(dirname): + return [basename] + else: + if os.path.lexists(os.path.join(dirname, basename)): + return [basename] + return [] + + +# This helper function recursively yields relative pathnames inside a literal +# directory. + + +def glob2(dirname, pattern): + assert _isrecursive(pattern) + yield pattern[:0] + for x in _rlistdir(dirname): + yield x + + +# Recursively yields relative pathnames inside a literal directory. +def _rlistdir(dirname): + if not dirname: + if isinstance(dirname, bytes): + dirname = os.curdir.encode('ASCII') + else: + dirname = os.curdir + try: + names = os.listdir(dirname) + except os.error: + return + for x in names: + yield x + path = os.path.join(dirname, x) if dirname else x + for y in _rlistdir(path): + yield os.path.join(x, y) + + +magic_check = re.compile('([*?[])') +magic_check_bytes = re.compile(b'([*?[])') + + +def has_magic(s): + if isinstance(s, bytes): + match = magic_check_bytes.search(s) + else: + match = magic_check.search(s) + return match is not None + + +def _isrecursive(pattern): + if isinstance(pattern, bytes): + return pattern == b'**' + else: + return pattern == '**' + + +def escape(pathname): + """Escape all special characters. + """ + # Escaping is done by wrapping any of "*?[" between square brackets. + # Metacharacters do not work in the drive part and shouldn't be escaped. + drive, pathname = os.path.splitdrive(pathname) + if isinstance(pathname, bytes): + pathname = magic_check_bytes.sub(br'[\1]', pathname) + else: + pathname = magic_check.sub(r'[\1]', pathname) + return drive + pathname diff --git a/venv/lib/python3.8/site-packages/setuptools/gui-32.exe b/venv/lib/python3.8/site-packages/setuptools/gui-32.exe new file mode 100644 index 0000000000000000000000000000000000000000..f8d3509653ba8f80ca7f3aa7f95616142ba83a94 GIT binary patch literal 65536 zcmeFae|%KMxj%k3yGc&SCTD>S1PQP}R5YmQ5=~qJi^+zl1UE)DtPsG8blp-*!#RLg z0>QIub24npZS_`f-)#|`^OhvIcH|hGc(UT^E}VYJoC(K^_@EDjE;rth;Yer@_4k$X3I);E0Tn+-Zb>&yT9Ew!oxAMfl)C z#Z+d`C?Ev=lGJ)}%Ksnx|0)G)SVf_n2-;d?f9!~MzIJJ-=wKb=iHfW2QCpC29wSNm zA=ztsPZ<@3t`2ENV!bW?>DIbrM&c*bCbqaRzr~R~Z-r)Gl=RG-p}ugUHp=<&@N<(0nQZ)pc;t^f@UfdU)Xs*a2q9hEj|W&QGS`}Q+V zaO>`-aSJ8yAtP2OBNk%M7Utt!$6gfgmQ40WtW_PKSW_r1oOg}p=vZj3XtBjwwJ#E} zLMNCsnAlP1f|%AM?kIHMo~S5v2kZEcbEs|ZrY(iCq{N>@V-R$%P-2fEhzyjmCh@Sy zXyr*PE_By~_)26%86IRFp9Ya zkBHB1hGv2=t60ZM@2flwcy2#L^lN{0=%0Q@MjzL)ErkWFb2Ro*N07ImOt!9YmgwvP zqh2yflmnST)@Q6JEa3kv=;e&Js^gRcx7ile@Me+Xh_`B=wJ3|47Z(=9j;P;M4jj9k ze|zYYnyGIobV=&smWsjxVw3XZ39!ke-gcWd&f8i_T!k-^@^CA0*s%-oQ>v?$_-7%o z(GNN8XT7J;F$I$PlNQv_oLiavAq4>E7I2dQhlE)vSn!y;BSSI+5(`L`#@q*i(+$dj ziMR82oKzstr3NgrEei6^p%m@2rUhVv>rK-H3%XZ<_rUh;c(a2dG)%uOg$_v@w_EZo zlu%GsR0^7TQkP%ahpqsf^)t)7t)|hz?tCY-06G}<$V~#?~heoED!!4L2akG@t z3k(cUbnpdgqwk%>`n0WAC7vv#rU2V~=4eiAwpse1#pRD3*UlGpF7&;UP%~^>-Uq9> zqqY#gDuX1JM-HRLrTl?xL1RW6Nzt8%&-UwXtnfuqbCmh#A4k1U7-%L3c7Zx(d zuhG+B-K2d4zoLVczO#ufnYJw*t5&k#)-NC8`0Z!%(?;tLH)1SS=)o%@p*m1Hza}bC zH<@{EP=$nZv|K=--J~^q2RFJ=UsK7|s*{A7>2riBOI3;B9VN6@g>xk)TvhhOKNMSeI?sb zNT@@qXG7GtAEH*Z*I7+?xX^=^+#cd{e*xu~c+oK%QC`k~8T1Fj`XSd4etuu)23Ly= znHbY_evF#lbUsH*M$@PjpbB6kZlDn4%Pfry7Wc9o2a;HxjOT7A9>$Ks0zkIpxF}-P z4%J+UwB{X!v+x4JvU3b1r4SD4dNJCLBe`P~a!!^eLzUU1z9JMV04G)5v%Ur4xPh4u|g#Tc-(r0PB00 z<2OM*Q-Cajywm3kTRsx?bLZ%s;?w6_FF__SF*1GDPvs6}`fAHZ`iq5gfrnJz3GS7o z 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 literal 0 HcmV?d00001 diff --git a/venv/lib/python3.8/site-packages/setuptools/gui.exe b/venv/lib/python3.8/site-packages/setuptools/gui.exe new file mode 100644 index 0000000000000000000000000000000000000000..f8d3509653ba8f80ca7f3aa7f95616142ba83a94 GIT binary patch literal 65536 zcmeFae|%KMxj%k3yGc&SCTD>S1PQP}R5YmQ5=~qJi^+zl1UE)DtPsG8blp-*!#RLg z0>QIub24npZS_`f-)#|`^OhvIcH|hGc(UT^E}VYJoC(K^_@EDjE;rth;Yer@_4k$X3I);E0Tn+-Zb>&yT9Ew!oxAMfl)C z#Z+d`C?Ev=lGJ)}%Ksnx|0)G)SVf_n2-;d?f9!~MzIJJ-=wKb=iHfW2QCpC29wSNm zA=ztsPZ<@3t`2ENV!bW?>DIbrM&c*bCbqaRzr~R~Z-r)Gl=RG-p}ugUHp=<&@N<(0nQZ)pc;t^f@UfdU)Xs*a2q9hEj|W&QGS`}Q+V zaO>`-aSJ8yAtP2OBNk%M7Utt!$6gfgmQ40WtW_PKSW_r1oOg}p=vZj3XtBjwwJ#E} zLMNCsnAlP1f|%AM?kIHMo~S5v2kZEcbEs|ZrY(iCq{N>@V-R$%P-2fEhzyjmCh@Sy zXyr*PE_By~_)26%86IRFp9Ya zkBHB1hGv2=t60ZM@2flwcy2#L^lN{0=%0Q@MjzL)ErkWFb2Ro*N07ImOt!9YmgwvP zqh2yflmnST)@Q6JEa3kv=;e&Js^gRcx7ile@Me+Xh_`B=wJ3|47Z(=9j;P;M4jj9k ze|zYYnyGIobV=&smWsjxVw3XZ39!ke-gcWd&f8i_T!k-^@^CA0*s%-oQ>v?$_-7%o z(GNN8XT7J;F$I$PlNQv_oLiavAq4>E7I2dQhlE)vSn!y;BSSI+5(`L`#@q*i(+$dj ziMR82oKzstr3NgrEei6^p%m@2rUhVv>rK-H3%XZ<_rUh;c(a2dG)%uOg$_v@w_EZo zlu%GsR0^7TQkP%ahpqsf^)t)7t)|hz?tCY-06G}<$V~#?~heoED!!4L2akG@t z3k(cUbnpdgqwk%>`n0WAC7vv#rU2V~=4eiAwpse1#pRD3*UlGpF7&;UP%~^>-Uq9> zqqY#gDuX1JM-HRLrTl?xL1RW6Nzt8%&-UwXtnfuqbCmh#A4k1U7-%L3c7Zx(d zuhG+B-K2d4zoLVczO#ufnYJw*t5&k#)-NC8`0Z!%(?;tLH)1SS=)o%@p*m1Hza}bC zH<@{EP=$nZv|K=--J~^q2RFJ=UsK7|s*{A7>2riBOI3;B9VN6@g>xk)TvhhOKNMSeI?sb zNT@@qXG7GtAEH*Z*I7+?xX^=^+#cd{e*xu~c+oK%QC`k~8T1Fj`XSd4etuu)23Ly= znHbY_evF#lbUsH*M$@PjpbB6kZlDn4%Pfry7Wc9o2a;HxjOT7A9>$Ks0zkIpxF}-P z4%J+UwB{X!v+x4JvU3b1r4SD4dNJCLBe`P~a!!^eLzUU1z9JMV04G)5v%Ur4xPh4u|g#Tc-(r0PB00 z<2OM*Q-Cajywm3kTRsx?bLZ%s;?w6_FF__SF*1GDPvs6}`fAHZ`iq5gfrnJz3GS7o z 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 -1: + # For VC++ 9.0, if IA64 support is needed, redirect user + # to Windows SDK 7.0. + # Note: No download link available from Microsoft. + message += ' Get it with "Microsoft Windows SDK 7.0"' + else: + # For VC++ 9.0 redirect user to Vc++ for Python 2.7 : + # This redirection link is maintained by Microsoft. + # Contact vspython@microsoft.com if it needs updating. + message += ' Get it from http://aka.ms/vcpython27' + elif version == 10.0: + # For VC++ 10.0 Redirect user to Windows SDK 7.1 + message += ' Get it with "Microsoft Windows SDK 7.1": ' + message += msdownload % 8279 + elif version >= 14.0: + # For VC++ 14.X Redirect user to latest Visual C++ Build Tools + message += (' Get it with "Build Tools for Visual Studio": ' + r'https://visualstudio.microsoft.com/downloads/') + + exc.args = (message, ) + + +class PlatformInfo: + """ + Current and Target Architectures information. + + Parameters + ---------- + arch: str + Target architecture. + """ + current_cpu = environ.get('processor_architecture', '').lower() + + def __init__(self, arch): + self.arch = arch.lower().replace('x64', 'amd64') + + @property + def target_cpu(self): + """ + Return Target CPU architecture. + + Return + ------ + str + Target CPU + """ + return self.arch[self.arch.find('_') + 1:] + + def target_is_x86(self): + """ + Return True if target CPU is x86 32 bits.. + + Return + ------ + bool + CPU is x86 32 bits + """ + return self.target_cpu == 'x86' + + def current_is_x86(self): + """ + Return True if current CPU is x86 32 bits.. + + Return + ------ + bool + CPU is x86 32 bits + """ + return self.current_cpu == 'x86' + + def current_dir(self, hidex86=False, x64=False): + """ + Current platform specific subfolder. + + Parameters + ---------- + hidex86: bool + return '' and not '\x86' if architecture is x86. + x64: bool + return '\x64' and not '\amd64' if architecture is amd64. + + Return + ------ + str + subfolder: '\target', or '' (see hidex86 parameter) + """ + return ( + '' if (self.current_cpu == 'x86' and hidex86) else + r'\x64' if (self.current_cpu == 'amd64' and x64) else + r'\%s' % self.current_cpu + ) + + def target_dir(self, hidex86=False, x64=False): + r""" + Target platform specific subfolder. + + Parameters + ---------- + hidex86: bool + return '' and not '\x86' if architecture is x86. + x64: bool + return '\x64' and not '\amd64' if architecture is amd64. + + Return + ------ + str + subfolder: '\current', or '' (see hidex86 parameter) + """ + return ( + '' if (self.target_cpu == 'x86' and hidex86) else + r'\x64' if (self.target_cpu == 'amd64' and x64) else + r'\%s' % self.target_cpu + ) + + def cross_dir(self, forcex86=False): + r""" + Cross platform specific subfolder. + + Parameters + ---------- + forcex86: bool + Use 'x86' as current architecture even if current architecture is + not x86. + + Return + ------ + str + subfolder: '' if target architecture is current architecture, + '\current_target' if not. + """ + current = 'x86' if forcex86 else self.current_cpu + return ( + '' if self.target_cpu == current else + self.target_dir().replace('\\', '\\%s_' % current) + ) + + +class RegistryInfo: + """ + Microsoft Visual Studio related registry information. + + Parameters + ---------- + platform_info: PlatformInfo + "PlatformInfo" instance. + """ + HKEYS = (winreg.HKEY_USERS, + winreg.HKEY_CURRENT_USER, + winreg.HKEY_LOCAL_MACHINE, + winreg.HKEY_CLASSES_ROOT) + + def __init__(self, platform_info): + self.pi = platform_info + + @property + def visualstudio(self): + """ + Microsoft Visual Studio root registry key. + + Return + ------ + str + Registry key + """ + return 'VisualStudio' + + @property + def sxs(self): + """ + Microsoft Visual Studio SxS registry key. + + Return + ------ + str + Registry key + """ + return join(self.visualstudio, 'SxS') + + @property + def vc(self): + """ + Microsoft Visual C++ VC7 registry key. + + Return + ------ + str + Registry key + """ + return join(self.sxs, 'VC7') + + @property + def vs(self): + """ + Microsoft Visual Studio VS7 registry key. + + Return + ------ + str + Registry key + """ + return join(self.sxs, 'VS7') + + @property + def vc_for_python(self): + """ + Microsoft Visual C++ for Python registry key. + + Return + ------ + str + Registry key + """ + return r'DevDiv\VCForPython' + + @property + def microsoft_sdk(self): + """ + Microsoft SDK registry key. + + Return + ------ + str + Registry key + """ + return 'Microsoft SDKs' + + @property + def windows_sdk(self): + """ + Microsoft Windows/Platform SDK registry key. + + Return + ------ + str + Registry key + """ + return join(self.microsoft_sdk, 'Windows') + + @property + def netfx_sdk(self): + """ + Microsoft .NET Framework SDK registry key. + + Return + ------ + str + Registry key + """ + return join(self.microsoft_sdk, 'NETFXSDK') + + @property + def windows_kits_roots(self): + """ + Microsoft Windows Kits Roots registry key. + + Return + ------ + str + Registry key + """ + return r'Windows Kits\Installed Roots' + + def microsoft(self, key, x86=False): + """ + Return key in Microsoft software registry. + + Parameters + ---------- + key: str + Registry key path where look. + x86: str + Force x86 software registry. + + Return + ------ + str + Registry key + """ + node64 = '' if self.pi.current_is_x86() or x86 else 'Wow6432Node' + return join('Software', node64, 'Microsoft', key) + + def lookup(self, key, name): + """ + Look for values in registry in Microsoft software registry. + + Parameters + ---------- + key: str + Registry key path where look. + name: str + Value name to find. + + Return + ------ + str + value + """ + key_read = winreg.KEY_READ + openkey = winreg.OpenKey + ms = self.microsoft + for hkey in self.HKEYS: + try: + bkey = openkey(hkey, ms(key), 0, key_read) + except (OSError, IOError): + if not self.pi.current_is_x86(): + try: + bkey = openkey(hkey, ms(key, True), 0, key_read) + except (OSError, IOError): + continue + else: + continue + try: + return winreg.QueryValueEx(bkey, name)[0] + except (OSError, IOError): + pass + + +class SystemInfo: + """ + Microsoft Windows and Visual Studio related system information. + + Parameters + ---------- + registry_info: RegistryInfo + "RegistryInfo" instance. + vc_ver: float + Required Microsoft Visual C++ version. + """ + + # Variables and properties in this class use originals CamelCase variables + # names from Microsoft source files for more easy comparison. + WinDir = environ.get('WinDir', '') + ProgramFiles = environ.get('ProgramFiles', '') + ProgramFilesx86 = environ.get('ProgramFiles(x86)', ProgramFiles) + + def __init__(self, registry_info, vc_ver=None): + self.ri = registry_info + self.pi = self.ri.pi + + self.known_vs_paths = self.find_programdata_vs_vers() + + # Except for VS15+, VC version is aligned with VS version + self.vs_ver = self.vc_ver = ( + vc_ver or self._find_latest_available_vs_ver()) + + def _find_latest_available_vs_ver(self): + """ + Find the latest VC version + + Return + ------ + float + version + """ + reg_vc_vers = self.find_reg_vs_vers() + + if not (reg_vc_vers or self.known_vs_paths): + raise distutils.errors.DistutilsPlatformError( + 'No Microsoft Visual C++ version found') + + vc_vers = set(reg_vc_vers) + vc_vers.update(self.known_vs_paths) + return sorted(vc_vers)[-1] + + def find_reg_vs_vers(self): + """ + Find Microsoft Visual Studio versions available in registry. + + Return + ------ + list of float + Versions + """ + ms = self.ri.microsoft + vckeys = (self.ri.vc, self.ri.vc_for_python, self.ri.vs) + vs_vers = [] + for hkey in self.ri.HKEYS: + for key in vckeys: + try: + bkey = winreg.OpenKey(hkey, ms(key), 0, winreg.KEY_READ) + except (OSError, IOError): + continue + subkeys, values, _ = winreg.QueryInfoKey(bkey) + for i in range(values): + try: + ver = float(winreg.EnumValue(bkey, i)[0]) + if ver not in vs_vers: + vs_vers.append(ver) + except ValueError: + pass + for i in range(subkeys): + try: + ver = float(winreg.EnumKey(bkey, i)) + if ver not in vs_vers: + vs_vers.append(ver) + except ValueError: + pass + return sorted(vs_vers) + + def find_programdata_vs_vers(self): + r""" + Find Visual studio 2017+ versions from information in + "C:\ProgramData\Microsoft\VisualStudio\Packages\_Instances". + + Return + ------ + dict + float version as key, path as value. + """ + vs_versions = {} + instances_dir = \ + r'C:\ProgramData\Microsoft\VisualStudio\Packages\_Instances' + + try: + hashed_names = listdir(instances_dir) + + except (OSError, IOError): + # Directory not exists with all Visual Studio versions + return vs_versions + + for name in hashed_names: + try: + # Get VS installation path from "state.json" file + state_path = join(instances_dir, name, 'state.json') + with open(state_path, 'rt', encoding='utf-8') as state_file: + state = json.load(state_file) + vs_path = state['installationPath'] + + # Raises OSError if this VS installation does not contain VC + listdir(join(vs_path, r'VC\Tools\MSVC')) + + # Store version and path + vs_versions[self._as_float_version( + state['installationVersion'])] = vs_path + + except (OSError, IOError, KeyError): + # Skip if "state.json" file is missing or bad format + continue + + return vs_versions + + @staticmethod + def _as_float_version(version): + """ + Return a string version as a simplified float version (major.minor) + + Parameters + ---------- + version: str + Version. + + Return + ------ + float + version + """ + return float('.'.join(version.split('.')[:2])) + + @property + def VSInstallDir(self): + """ + Microsoft Visual Studio directory. + + Return + ------ + str + path + """ + # Default path + default = join(self.ProgramFilesx86, + 'Microsoft Visual Studio %0.1f' % self.vs_ver) + + # Try to get path from registry, if fail use default path + return self.ri.lookup(self.ri.vs, '%0.1f' % self.vs_ver) or default + + @property + def VCInstallDir(self): + """ + Microsoft Visual C++ directory. + + Return + ------ + str + path + """ + path = self._guess_vc() or self._guess_vc_legacy() + + if not isdir(path): + msg = 'Microsoft Visual C++ directory not found' + raise distutils.errors.DistutilsPlatformError(msg) + + return path + + def _guess_vc(self): + """ + Locate Visual C++ for VS2017+. + + Return + ------ + str + path + """ + if self.vs_ver <= 14.0: + return '' + + try: + # First search in known VS paths + vs_dir = self.known_vs_paths[self.vs_ver] + except KeyError: + # Else, search with path from registry + vs_dir = self.VSInstallDir + + guess_vc = join(vs_dir, r'VC\Tools\MSVC') + + # Subdir with VC exact version as name + try: + # Update the VC version with real one instead of VS version + vc_ver = listdir(guess_vc)[-1] + self.vc_ver = self._as_float_version(vc_ver) + return join(guess_vc, vc_ver) + except (OSError, IOError, IndexError): + return '' + + def _guess_vc_legacy(self): + """ + Locate Visual C++ for versions prior to 2017. + + Return + ------ + str + path + """ + default = join(self.ProgramFilesx86, + r'Microsoft Visual Studio %0.1f\VC' % self.vs_ver) + + # Try to get "VC++ for Python" path from registry as default path + reg_path = join(self.ri.vc_for_python, '%0.1f' % self.vs_ver) + python_vc = self.ri.lookup(reg_path, 'installdir') + default_vc = join(python_vc, 'VC') if python_vc else default + + # Try to get path from registry, if fail use default path + return self.ri.lookup(self.ri.vc, '%0.1f' % self.vs_ver) or default_vc + + @property + def WindowsSdkVersion(self): + """ + Microsoft Windows SDK versions for specified MSVC++ version. + + Return + ------ + tuple of str + versions + """ + if self.vs_ver <= 9.0: + return '7.0', '6.1', '6.0a' + elif self.vs_ver == 10.0: + return '7.1', '7.0a' + elif self.vs_ver == 11.0: + return '8.0', '8.0a' + elif self.vs_ver == 12.0: + return '8.1', '8.1a' + elif self.vs_ver >= 14.0: + return '10.0', '8.1' + + @property + def WindowsSdkLastVersion(self): + """ + Microsoft Windows SDK last version. + + Return + ------ + str + version + """ + return self._use_last_dir_name(join(self.WindowsSdkDir, 'lib')) + + @property + def WindowsSdkDir(self): + """ + Microsoft Windows SDK directory. + + Return + ------ + str + path + """ + sdkdir = '' + for ver in self.WindowsSdkVersion: + # Try to get it from registry + loc = join(self.ri.windows_sdk, 'v%s' % ver) + sdkdir = self.ri.lookup(loc, 'installationfolder') + if sdkdir: + break + if not sdkdir or not isdir(sdkdir): + # Try to get "VC++ for Python" version from registry + path = join(self.ri.vc_for_python, '%0.1f' % self.vc_ver) + install_base = self.ri.lookup(path, 'installdir') + if install_base: + sdkdir = join(install_base, 'WinSDK') + if not sdkdir or not isdir(sdkdir): + # If fail, use default new path + for ver in self.WindowsSdkVersion: + intver = ver[:ver.rfind('.')] + path = r'Microsoft SDKs\Windows Kits\%s' % intver + d = join(self.ProgramFiles, path) + if isdir(d): + sdkdir = d + if not sdkdir or not isdir(sdkdir): + # If fail, use default old path + for ver in self.WindowsSdkVersion: + path = r'Microsoft SDKs\Windows\v%s' % ver + d = join(self.ProgramFiles, path) + if isdir(d): + sdkdir = d + if not sdkdir: + # If fail, use Platform SDK + sdkdir = join(self.VCInstallDir, 'PlatformSDK') + return sdkdir + + @property + def WindowsSDKExecutablePath(self): + """ + Microsoft Windows SDK executable directory. + + Return + ------ + str + path + """ + # Find WinSDK NetFx Tools registry dir name + if self.vs_ver <= 11.0: + netfxver = 35 + arch = '' + else: + netfxver = 40 + hidex86 = True if self.vs_ver <= 12.0 else False + arch = self.pi.current_dir(x64=True, hidex86=hidex86) + fx = 'WinSDK-NetFx%dTools%s' % (netfxver, arch.replace('\\', '-')) + + # list all possibles registry paths + regpaths = [] + if self.vs_ver >= 14.0: + for ver in self.NetFxSdkVersion: + regpaths += [join(self.ri.netfx_sdk, ver, fx)] + + for ver in self.WindowsSdkVersion: + regpaths += [join(self.ri.windows_sdk, 'v%sA' % ver, fx)] + + # Return installation folder from the more recent path + for path in regpaths: + execpath = self.ri.lookup(path, 'installationfolder') + if execpath: + return execpath + + @property + def FSharpInstallDir(self): + """ + Microsoft Visual F# directory. + + Return + ------ + str + path + """ + path = join(self.ri.visualstudio, r'%0.1f\Setup\F#' % self.vs_ver) + return self.ri.lookup(path, 'productdir') or '' + + @property + def UniversalCRTSdkDir(self): + """ + Microsoft Universal CRT SDK directory. + + Return + ------ + str + path + """ + # Set Kit Roots versions for specified MSVC++ version + vers = ('10', '81') if self.vs_ver >= 14.0 else () + + # Find path of the more recent Kit + for ver in vers: + sdkdir = self.ri.lookup(self.ri.windows_kits_roots, + 'kitsroot%s' % ver) + if sdkdir: + return sdkdir or '' + + @property + def UniversalCRTSdkLastVersion(self): + """ + Microsoft Universal C Runtime SDK last version. + + Return + ------ + str + version + """ + return self._use_last_dir_name(join(self.UniversalCRTSdkDir, 'lib')) + + @property + def NetFxSdkVersion(self): + """ + Microsoft .NET Framework SDK versions. + + Return + ------ + tuple of str + versions + """ + # Set FxSdk versions for specified VS version + return (('4.7.2', '4.7.1', '4.7', + '4.6.2', '4.6.1', '4.6', + '4.5.2', '4.5.1', '4.5') + if self.vs_ver >= 14.0 else ()) + + @property + def NetFxSdkDir(self): + """ + Microsoft .NET Framework SDK directory. + + Return + ------ + str + path + """ + sdkdir = '' + for ver in self.NetFxSdkVersion: + loc = join(self.ri.netfx_sdk, ver) + sdkdir = self.ri.lookup(loc, 'kitsinstallationfolder') + if sdkdir: + break + return sdkdir + + @property + def FrameworkDir32(self): + """ + Microsoft .NET Framework 32bit directory. + + Return + ------ + str + path + """ + # Default path + guess_fw = join(self.WinDir, r'Microsoft.NET\Framework') + + # Try to get path from registry, if fail use default path + return self.ri.lookup(self.ri.vc, 'frameworkdir32') or guess_fw + + @property + def FrameworkDir64(self): + """ + Microsoft .NET Framework 64bit directory. + + Return + ------ + str + path + """ + # Default path + guess_fw = join(self.WinDir, r'Microsoft.NET\Framework64') + + # Try to get path from registry, if fail use default path + return self.ri.lookup(self.ri.vc, 'frameworkdir64') or guess_fw + + @property + def FrameworkVersion32(self): + """ + Microsoft .NET Framework 32bit versions. + + Return + ------ + tuple of str + versions + """ + return self._find_dot_net_versions(32) + + @property + def FrameworkVersion64(self): + """ + Microsoft .NET Framework 64bit versions. + + Return + ------ + tuple of str + versions + """ + return self._find_dot_net_versions(64) + + def _find_dot_net_versions(self, bits): + """ + Find Microsoft .NET Framework versions. + + Parameters + ---------- + bits: int + Platform number of bits: 32 or 64. + + Return + ------ + tuple of str + versions + """ + # Find actual .NET version in registry + reg_ver = self.ri.lookup(self.ri.vc, 'frameworkver%d' % bits) + dot_net_dir = getattr(self, 'FrameworkDir%d' % bits) + ver = reg_ver or self._use_last_dir_name(dot_net_dir, 'v') or '' + + # Set .NET versions for specified MSVC++ version + if self.vs_ver >= 12.0: + return ver, 'v4.0' + elif self.vs_ver >= 10.0: + return 'v4.0.30319' if ver.lower()[:2] != 'v4' else ver, 'v3.5' + elif self.vs_ver == 9.0: + return 'v3.5', 'v2.0.50727' + elif self.vs_ver == 8.0: + return 'v3.0', 'v2.0.50727' + + @staticmethod + def _use_last_dir_name(path, prefix=''): + """ + Return name of the last dir in path or '' if no dir found. + + Parameters + ---------- + path: str + Use dirs in this path + prefix: str + Use only dirs starting by this prefix + + Return + ------ + str + name + """ + matching_dirs = ( + dir_name + for dir_name in reversed(listdir(path)) + if isdir(join(path, dir_name)) and + dir_name.startswith(prefix) + ) + return next(matching_dirs, None) or '' + + +class EnvironmentInfo: + """ + Return environment variables for specified Microsoft Visual C++ version + and platform : Lib, Include, Path and libpath. + + This function is compatible with Microsoft Visual C++ 9.0 to 14.X. + + Script created by analysing Microsoft environment configuration files like + "vcvars[...].bat", "SetEnv.Cmd", "vcbuildtools.bat", ... + + Parameters + ---------- + arch: str + Target architecture. + vc_ver: float + Required Microsoft Visual C++ version. If not set, autodetect the last + version. + vc_min_ver: float + Minimum Microsoft Visual C++ version. + """ + + # Variables and properties in this class use originals CamelCase variables + # names from Microsoft source files for more easy comparison. + + def __init__(self, arch, vc_ver=None, vc_min_ver=0): + self.pi = PlatformInfo(arch) + self.ri = RegistryInfo(self.pi) + self.si = SystemInfo(self.ri, vc_ver) + + if self.vc_ver < vc_min_ver: + err = 'No suitable Microsoft Visual C++ version found' + raise distutils.errors.DistutilsPlatformError(err) + + @property + def vs_ver(self): + """ + Microsoft Visual Studio. + + Return + ------ + float + version + """ + return self.si.vs_ver + + @property + def vc_ver(self): + """ + Microsoft Visual C++ version. + + Return + ------ + float + version + """ + return self.si.vc_ver + + @property + def VSTools(self): + """ + Microsoft Visual Studio Tools. + + Return + ------ + list of str + paths + """ + paths = [r'Common7\IDE', r'Common7\Tools'] + + if self.vs_ver >= 14.0: + arch_subdir = self.pi.current_dir(hidex86=True, x64=True) + paths += [r'Common7\IDE\CommonExtensions\Microsoft\TestWindow'] + paths += [r'Team Tools\Performance Tools'] + paths += [r'Team Tools\Performance Tools%s' % arch_subdir] + + return [join(self.si.VSInstallDir, path) for path in paths] + + @property + def VCIncludes(self): + """ + Microsoft Visual C++ & Microsoft Foundation Class Includes. + + Return + ------ + list of str + paths + """ + return [join(self.si.VCInstallDir, 'Include'), + join(self.si.VCInstallDir, r'ATLMFC\Include')] + + @property + def VCLibraries(self): + """ + Microsoft Visual C++ & Microsoft Foundation Class Libraries. + + Return + ------ + list of str + paths + """ + if self.vs_ver >= 15.0: + arch_subdir = self.pi.target_dir(x64=True) + else: + arch_subdir = self.pi.target_dir(hidex86=True) + paths = ['Lib%s' % arch_subdir, r'ATLMFC\Lib%s' % arch_subdir] + + if self.vs_ver >= 14.0: + paths += [r'Lib\store%s' % arch_subdir] + + return [join(self.si.VCInstallDir, path) for path in paths] + + @property + def VCStoreRefs(self): + """ + Microsoft Visual C++ store references Libraries. + + Return + ------ + list of str + paths + """ + if self.vs_ver < 14.0: + return [] + return [join(self.si.VCInstallDir, r'Lib\store\references')] + + @property + def VCTools(self): + """ + Microsoft Visual C++ Tools. + + Return + ------ + list of str + paths + """ + si = self.si + tools = [join(si.VCInstallDir, 'VCPackages')] + + forcex86 = True if self.vs_ver <= 10.0 else False + arch_subdir = self.pi.cross_dir(forcex86) + if arch_subdir: + tools += [join(si.VCInstallDir, 'Bin%s' % arch_subdir)] + + if self.vs_ver == 14.0: + path = 'Bin%s' % self.pi.current_dir(hidex86=True) + tools += [join(si.VCInstallDir, path)] + + elif self.vs_ver >= 15.0: + host_dir = (r'bin\HostX86%s' if self.pi.current_is_x86() else + r'bin\HostX64%s') + tools += [join( + si.VCInstallDir, host_dir % self.pi.target_dir(x64=True))] + + if self.pi.current_cpu != self.pi.target_cpu: + tools += [join( + si.VCInstallDir, host_dir % self.pi.current_dir(x64=True))] + + else: + tools += [join(si.VCInstallDir, 'Bin')] + + return tools + + @property + def OSLibraries(self): + """ + Microsoft Windows SDK Libraries. + + Return + ------ + list of str + paths + """ + if self.vs_ver <= 10.0: + arch_subdir = self.pi.target_dir(hidex86=True, x64=True) + return [join(self.si.WindowsSdkDir, 'Lib%s' % arch_subdir)] + + else: + arch_subdir = self.pi.target_dir(x64=True) + lib = join(self.si.WindowsSdkDir, 'lib') + libver = self._sdk_subdir + return [join(lib, '%sum%s' % (libver , arch_subdir))] + + @property + def OSIncludes(self): + """ + Microsoft Windows SDK Include. + + Return + ------ + list of str + paths + """ + include = join(self.si.WindowsSdkDir, 'include') + + if self.vs_ver <= 10.0: + return [include, join(include, 'gl')] + + else: + if self.vs_ver >= 14.0: + sdkver = self._sdk_subdir + else: + sdkver = '' + return [join(include, '%sshared' % sdkver), + join(include, '%sum' % sdkver), + join(include, '%swinrt' % sdkver)] + + @property + def OSLibpath(self): + """ + Microsoft Windows SDK Libraries Paths. + + Return + ------ + list of str + paths + """ + ref = join(self.si.WindowsSdkDir, 'References') + libpath = [] + + if self.vs_ver <= 9.0: + libpath += self.OSLibraries + + if self.vs_ver >= 11.0: + libpath += [join(ref, r'CommonConfiguration\Neutral')] + + if self.vs_ver >= 14.0: + libpath += [ + ref, + join(self.si.WindowsSdkDir, 'UnionMetadata'), + join(ref, 'Windows.Foundation.UniversalApiContract', '1.0.0.0'), + join(ref, 'Windows.Foundation.FoundationContract', '1.0.0.0'), + join(ref,'Windows.Networking.Connectivity.WwanContract', + '1.0.0.0'), + join(self.si.WindowsSdkDir, 'ExtensionSDKs', 'Microsoft.VCLibs', + '%0.1f' % self.vs_ver, 'References', 'CommonConfiguration', + 'neutral'), + ] + return libpath + + @property + def SdkTools(self): + """ + Microsoft Windows SDK Tools. + + Return + ------ + list of str + paths + """ + return list(self._sdk_tools()) + + def _sdk_tools(self): + """ + Microsoft Windows SDK Tools paths generator. + + Return + ------ + generator of str + paths + """ + if self.vs_ver < 15.0: + bin_dir = 'Bin' if self.vs_ver <= 11.0 else r'Bin\x86' + yield join(self.si.WindowsSdkDir, bin_dir) + + if not self.pi.current_is_x86(): + arch_subdir = self.pi.current_dir(x64=True) + path = 'Bin%s' % arch_subdir + yield join(self.si.WindowsSdkDir, path) + + if self.vs_ver in (10.0, 11.0): + if self.pi.target_is_x86(): + arch_subdir = '' + else: + arch_subdir = self.pi.current_dir(hidex86=True, x64=True) + path = r'Bin\NETFX 4.0 Tools%s' % arch_subdir + yield join(self.si.WindowsSdkDir, path) + + elif self.vs_ver >= 15.0: + path = join(self.si.WindowsSdkDir, 'Bin') + arch_subdir = self.pi.current_dir(x64=True) + sdkver = self.si.WindowsSdkLastVersion + yield join(path, '%s%s' % (sdkver, arch_subdir)) + + if self.si.WindowsSDKExecutablePath: + yield self.si.WindowsSDKExecutablePath + + @property + def _sdk_subdir(self): + """ + Microsoft Windows SDK version subdir. + + Return + ------ + str + subdir + """ + ucrtver = self.si.WindowsSdkLastVersion + return ('%s\\' % ucrtver) if ucrtver else '' + + @property + def SdkSetup(self): + """ + Microsoft Windows SDK Setup. + + Return + ------ + list of str + paths + """ + if self.vs_ver > 9.0: + return [] + + return [join(self.si.WindowsSdkDir, 'Setup')] + + @property + def FxTools(self): + """ + Microsoft .NET Framework Tools. + + Return + ------ + list of str + paths + """ + pi = self.pi + si = self.si + + if self.vs_ver <= 10.0: + include32 = True + include64 = not pi.target_is_x86() and not pi.current_is_x86() + else: + include32 = pi.target_is_x86() or pi.current_is_x86() + include64 = pi.current_cpu == 'amd64' or pi.target_cpu == 'amd64' + + tools = [] + if include32: + tools += [join(si.FrameworkDir32, ver) + for ver in si.FrameworkVersion32] + if include64: + tools += [join(si.FrameworkDir64, ver) + for ver in si.FrameworkVersion64] + return tools + + @property + def NetFxSDKLibraries(self): + """ + Microsoft .Net Framework SDK Libraries. + + Return + ------ + list of str + paths + """ + if self.vs_ver < 14.0 or not self.si.NetFxSdkDir: + return [] + + arch_subdir = self.pi.target_dir(x64=True) + return [join(self.si.NetFxSdkDir, r'lib\um%s' % arch_subdir)] + + @property + def NetFxSDKIncludes(self): + """ + Microsoft .Net Framework SDK Includes. + + Return + ------ + list of str + paths + """ + if self.vs_ver < 14.0 or not self.si.NetFxSdkDir: + return [] + + return [join(self.si.NetFxSdkDir, r'include\um')] + + @property + def VsTDb(self): + """ + Microsoft Visual Studio Team System Database. + + Return + ------ + list of str + paths + """ + return [join(self.si.VSInstallDir, r'VSTSDB\Deploy')] + + @property + def MSBuild(self): + """ + Microsoft Build Engine. + + Return + ------ + list of str + paths + """ + if self.vs_ver < 12.0: + return [] + elif self.vs_ver < 15.0: + base_path = self.si.ProgramFilesx86 + arch_subdir = self.pi.current_dir(hidex86=True) + else: + base_path = self.si.VSInstallDir + arch_subdir = '' + + path = r'MSBuild\%0.1f\bin%s' % (self.vs_ver, arch_subdir) + build = [join(base_path, path)] + + if self.vs_ver >= 15.0: + # Add Roslyn C# & Visual Basic Compiler + build += [join(base_path, path, 'Roslyn')] + + return build + + @property + def HTMLHelpWorkshop(self): + """ + Microsoft HTML Help Workshop. + + Return + ------ + list of str + paths + """ + if self.vs_ver < 11.0: + return [] + + return [join(self.si.ProgramFilesx86, 'HTML Help Workshop')] + + @property + def UCRTLibraries(self): + """ + Microsoft Universal C Runtime SDK Libraries. + + Return + ------ + list of str + paths + """ + if self.vs_ver < 14.0: + return [] + + arch_subdir = self.pi.target_dir(x64=True) + lib = join(self.si.UniversalCRTSdkDir, 'lib') + ucrtver = self._ucrt_subdir + return [join(lib, '%sucrt%s' % (ucrtver, arch_subdir))] + + @property + def UCRTIncludes(self): + """ + Microsoft Universal C Runtime SDK Include. + + Return + ------ + list of str + paths + """ + if self.vs_ver < 14.0: + return [] + + include = join(self.si.UniversalCRTSdkDir, 'include') + return [join(include, '%sucrt' % self._ucrt_subdir)] + + @property + def _ucrt_subdir(self): + """ + Microsoft Universal C Runtime SDK version subdir. + + Return + ------ + str + subdir + """ + ucrtver = self.si.UniversalCRTSdkLastVersion + return ('%s\\' % ucrtver) if ucrtver else '' + + @property + def FSharp(self): + """ + Microsoft Visual F#. + + Return + ------ + list of str + paths + """ + if 11.0 > self.vs_ver > 12.0: + return [] + + return [self.si.FSharpInstallDir] + + @property + def VCRuntimeRedist(self): + """ + Microsoft Visual C++ runtime redistributable dll. + + Return + ------ + str + path + """ + vcruntime = 'vcruntime%d0.dll' % self.vc_ver + arch_subdir = self.pi.target_dir(x64=True).strip('\\') + + # Installation prefixes candidates + prefixes = [] + tools_path = self.si.VCInstallDir + redist_path = dirname(tools_path.replace(r'\Tools', r'\Redist')) + if isdir(redist_path): + # Redist version may not be exactly the same as tools + redist_path = join(redist_path, listdir(redist_path)[-1]) + prefixes += [redist_path, join(redist_path, 'onecore')] + + prefixes += [join(tools_path, 'redist')] # VS14 legacy path + + # CRT directory + crt_dirs = ('Microsoft.VC%d.CRT' % (self.vc_ver * 10), + # Sometime store in directory with VS version instead of VC + 'Microsoft.VC%d.CRT' % (int(self.vs_ver) * 10)) + + # vcruntime path + for prefix, crt_dir in itertools.product(prefixes, crt_dirs): + path = join(prefix, arch_subdir, crt_dir, vcruntime) + if isfile(path): + return path + + def return_env(self, exists=True): + """ + Return environment dict. + + Parameters + ---------- + exists: bool + It True, only return existing paths. + + Return + ------ + dict + environment + """ + env = dict( + include=self._build_paths('include', + [self.VCIncludes, + self.OSIncludes, + self.UCRTIncludes, + self.NetFxSDKIncludes], + exists), + lib=self._build_paths('lib', + [self.VCLibraries, + self.OSLibraries, + self.FxTools, + self.UCRTLibraries, + self.NetFxSDKLibraries], + exists), + libpath=self._build_paths('libpath', + [self.VCLibraries, + self.FxTools, + self.VCStoreRefs, + self.OSLibpath], + exists), + path=self._build_paths('path', + [self.VCTools, + self.VSTools, + self.VsTDb, + self.SdkTools, + self.SdkSetup, + self.FxTools, + self.MSBuild, + self.HTMLHelpWorkshop, + self.FSharp], + exists), + ) + if self.vs_ver >= 14 and isfile(self.VCRuntimeRedist): + env['py_vcruntime_redist'] = self.VCRuntimeRedist + return env + + def _build_paths(self, name, spec_path_lists, exists): + """ + Given an environment variable name and specified paths, + return a pathsep-separated string of paths containing + unique, extant, directories from those paths and from + the environment variable. Raise an error if no paths + are resolved. + + Parameters + ---------- + name: str + Environment variable name + spec_path_lists: list of str + Paths + exists: bool + It True, only return existing paths. + + Return + ------ + str + Pathsep-separated paths + """ + # flatten spec_path_lists + spec_paths = itertools.chain.from_iterable(spec_path_lists) + env_paths = environ.get(name, '').split(pathsep) + paths = itertools.chain(spec_paths, env_paths) + extant_paths = list(filter(isdir, paths)) if exists else paths + if not extant_paths: + msg = "%s environment variable is empty" % name.upper() + raise distutils.errors.DistutilsPlatformError(msg) + unique_paths = self._unique_everseen(extant_paths) + return pathsep.join(unique_paths) + + # from Python docs + @staticmethod + def _unique_everseen(iterable, key=None): + """ + List unique elements, preserving order. + Remember all elements ever seen. + + _unique_everseen('AAAABBBCCDAABBB') --> A B C D + + _unique_everseen('ABBCcAD', str.lower) --> A B C D + """ + seen = set() + seen_add = seen.add + if key is None: + for element in filterfalse(seen.__contains__, iterable): + seen_add(element) + yield element + else: + for element in iterable: + k = key(element) + if k not in seen: + seen_add(k) + yield element diff --git a/venv/lib/python3.8/site-packages/setuptools/namespaces.py b/venv/lib/python3.8/site-packages/setuptools/namespaces.py new file mode 100644 index 000000000..dc16106d3 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/namespaces.py @@ -0,0 +1,107 @@ +import os +from distutils import log +import itertools + +from setuptools.extern.six.moves import map + + +flatten = itertools.chain.from_iterable + + +class Installer: + + nspkg_ext = '-nspkg.pth' + + def install_namespaces(self): + nsp = self._get_all_ns_packages() + if not nsp: + return + filename, ext = os.path.splitext(self._get_target()) + filename += self.nspkg_ext + self.outputs.append(filename) + log.info("Installing %s", filename) + lines = map(self._gen_nspkg_line, nsp) + + if self.dry_run: + # always generate the lines, even in dry run + list(lines) + return + + with open(filename, 'wt') as f: + f.writelines(lines) + + def uninstall_namespaces(self): + filename, ext = os.path.splitext(self._get_target()) + filename += self.nspkg_ext + if not os.path.exists(filename): + return + log.info("Removing %s", filename) + os.remove(filename) + + def _get_target(self): + return self.target + + _nspkg_tmpl = ( + "import sys, types, os", + "has_mfs = sys.version_info > (3, 5)", + "p = os.path.join(%(root)s, *%(pth)r)", + "importlib = has_mfs and __import__('importlib.util')", + "has_mfs and __import__('importlib.machinery')", + "m = has_mfs and " + "sys.modules.setdefault(%(pkg)r, " + "importlib.util.module_from_spec(" + "importlib.machinery.PathFinder.find_spec(%(pkg)r, " + "[os.path.dirname(p)])))", + "m = m or " + "sys.modules.setdefault(%(pkg)r, types.ModuleType(%(pkg)r))", + "mp = (m or []) and m.__dict__.setdefault('__path__',[])", + "(p not in mp) and mp.append(p)", + ) + "lines for the namespace installer" + + _nspkg_tmpl_multi = ( + 'm and setattr(sys.modules[%(parent)r], %(child)r, m)', + ) + "additional line(s) when a parent package is indicated" + + def _get_root(self): + return "sys._getframe(1).f_locals['sitedir']" + + def _gen_nspkg_line(self, pkg): + # ensure pkg is not a unicode string under Python 2.7 + pkg = str(pkg) + pth = tuple(pkg.split('.')) + root = self._get_root() + tmpl_lines = self._nspkg_tmpl + parent, sep, child = pkg.rpartition('.') + if parent: + tmpl_lines += self._nspkg_tmpl_multi + return ';'.join(tmpl_lines) % locals() + '\n' + + def _get_all_ns_packages(self): + """Return sorted list of all package namespaces""" + pkgs = self.distribution.namespace_packages or [] + return sorted(flatten(map(self._pkg_names, pkgs))) + + @staticmethod + def _pkg_names(pkg): + """ + Given a namespace package, yield the components of that + package. + + >>> names = Installer._pkg_names('a.b.c') + >>> set(names) == set(['a', 'a.b', 'a.b.c']) + True + """ + parts = pkg.split('.') + while parts: + yield '.'.join(parts) + parts.pop() + + +class DevelopInstaller(Installer): + def _get_root(self): + return repr(str(self.egg_path)) + + def _get_target(self): + return self.egg_link diff --git a/venv/lib/python3.8/site-packages/setuptools/package_index.py b/venv/lib/python3.8/site-packages/setuptools/package_index.py new file mode 100644 index 000000000..9a2da9d5a --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/package_index.py @@ -0,0 +1,1136 @@ +"""PyPI and direct package downloading""" +import sys +import os +import re +import shutil +import socket +import base64 +import hashlib +import itertools +import warnings +from functools import wraps + +from setuptools.extern import six +from setuptools.extern.six.moves import urllib, http_client, configparser, map + +import setuptools +from pkg_resources import ( + CHECKOUT_DIST, Distribution, BINARY_DIST, normalize_path, SOURCE_DIST, + Environment, find_distributions, safe_name, safe_version, + to_filename, Requirement, DEVELOP_DIST, EGG_DIST, +) +from setuptools import ssl_support +from distutils import log +from distutils.errors import DistutilsError +from fnmatch import translate +from setuptools.py27compat import get_all_headers +from setuptools.py33compat import unescape +from setuptools.wheel import Wheel + +__metaclass__ = type + +EGG_FRAGMENT = re.compile(r'^egg=([-A-Za-z0-9_.+!]+)$') +HREF = re.compile(r"""href\s*=\s*['"]?([^'"> ]+)""", re.I) +PYPI_MD5 = re.compile( + r'([^<]+)\n\s+\(md5\)' +) +URL_SCHEME = re.compile('([-+.a-z0-9]{2,}):', re.I).match +EXTENSIONS = ".tar.gz .tar.bz2 .tar .zip .tgz".split() + +__all__ = [ + 'PackageIndex', 'distros_for_url', 'parse_bdist_wininst', + 'interpret_distro_name', +] + +_SOCKET_TIMEOUT = 15 + +_tmpl = "setuptools/{setuptools.__version__} Python-urllib/{py_major}" +user_agent = _tmpl.format(py_major='{}.{}'.format(*sys.version_info), setuptools=setuptools) + + +def parse_requirement_arg(spec): + try: + return Requirement.parse(spec) + except ValueError: + raise DistutilsError( + "Not a URL, existing file, or requirement spec: %r" % (spec,) + ) + + +def parse_bdist_wininst(name): + """Return (base,pyversion) or (None,None) for possible .exe name""" + + lower = name.lower() + base, py_ver, plat = None, None, None + + if lower.endswith('.exe'): + if lower.endswith('.win32.exe'): + base = name[:-10] + plat = 'win32' + elif lower.startswith('.win32-py', -16): + py_ver = name[-7:-4] + base = name[:-16] + plat = 'win32' + elif lower.endswith('.win-amd64.exe'): + base = name[:-14] + plat = 'win-amd64' + elif lower.startswith('.win-amd64-py', -20): + py_ver = name[-7:-4] + base = name[:-20] + plat = 'win-amd64' + return base, py_ver, plat + + +def egg_info_for_url(url): + parts = urllib.parse.urlparse(url) + scheme, server, path, parameters, query, fragment = parts + base = urllib.parse.unquote(path.split('/')[-1]) + if server == 'sourceforge.net' and base == 'download': # XXX Yuck + base = urllib.parse.unquote(path.split('/')[-2]) + if '#' in base: + base, fragment = base.split('#', 1) + return base, fragment + + +def distros_for_url(url, metadata=None): + """Yield egg or source distribution objects that might be found at a URL""" + base, fragment = egg_info_for_url(url) + for dist in distros_for_location(url, base, metadata): + yield dist + if fragment: + match = EGG_FRAGMENT.match(fragment) + if match: + for dist in interpret_distro_name( + url, match.group(1), metadata, precedence=CHECKOUT_DIST + ): + yield dist + + +def distros_for_location(location, basename, metadata=None): + """Yield egg or source distribution objects based on basename""" + if basename.endswith('.egg.zip'): + basename = basename[:-4] # strip the .zip + if basename.endswith('.egg') and '-' in basename: + # only one, unambiguous interpretation + return [Distribution.from_location(location, basename, metadata)] + if basename.endswith('.whl') and '-' in basename: + wheel = Wheel(basename) + if not wheel.is_compatible(): + return [] + return [Distribution( + location=location, + project_name=wheel.project_name, + version=wheel.version, + # Increase priority over eggs. + precedence=EGG_DIST + 1, + )] + if basename.endswith('.exe'): + win_base, py_ver, platform = parse_bdist_wininst(basename) + if win_base is not None: + return interpret_distro_name( + location, win_base, metadata, py_ver, BINARY_DIST, platform + ) + # Try source distro extensions (.zip, .tgz, etc.) + # + for ext in EXTENSIONS: + if basename.endswith(ext): + basename = basename[:-len(ext)] + return interpret_distro_name(location, basename, metadata) + return [] # no extension matched + + +def distros_for_filename(filename, metadata=None): + """Yield possible egg or source distribution objects based on a filename""" + return distros_for_location( + normalize_path(filename), os.path.basename(filename), metadata + ) + + +def interpret_distro_name( + location, basename, metadata, py_version=None, precedence=SOURCE_DIST, + platform=None +): + """Generate alternative interpretations of a source distro name + + Note: if `location` is a filesystem filename, you should call + ``pkg_resources.normalize_path()`` on it before passing it to this + routine! + """ + # Generate alternative interpretations of a source distro name + # Because some packages are ambiguous as to name/versions split + # e.g. "adns-python-1.1.0", "egenix-mx-commercial", etc. + # So, we generate each possible interepretation (e.g. "adns, python-1.1.0" + # "adns-python, 1.1.0", and "adns-python-1.1.0, no version"). In practice, + # the spurious interpretations should be ignored, because in the event + # there's also an "adns" package, the spurious "python-1.1.0" version will + # compare lower than any numeric version number, and is therefore unlikely + # to match a request for it. It's still a potential problem, though, and + # in the long run PyPI and the distutils should go for "safe" names and + # versions in distribution archive names (sdist and bdist). + + parts = basename.split('-') + if not py_version and any(re.match(r'py\d\.\d$', p) for p in parts[2:]): + # it is a bdist_dumb, not an sdist -- bail out + return + + for p in range(1, len(parts) + 1): + yield Distribution( + location, metadata, '-'.join(parts[:p]), '-'.join(parts[p:]), + py_version=py_version, precedence=precedence, + platform=platform + ) + + +# From Python 2.7 docs +def unique_everseen(iterable, key=None): + "List unique elements, preserving order. Remember all elements ever seen." + # unique_everseen('AAAABBBCCDAABBB') --> A B C D + # unique_everseen('ABBCcAD', str.lower) --> A B C D + seen = set() + seen_add = seen.add + if key is None: + for element in six.moves.filterfalse(seen.__contains__, iterable): + seen_add(element) + yield element + else: + for element in iterable: + k = key(element) + if k not in seen: + seen_add(k) + yield element + + +def unique_values(func): + """ + Wrap a function returning an iterable such that the resulting iterable + only ever yields unique items. + """ + + @wraps(func) + def wrapper(*args, **kwargs): + return unique_everseen(func(*args, **kwargs)) + + return wrapper + + +REL = re.compile(r"""<([^>]*\srel\s{0,10}=\s{0,10}['"]?([^'" >]+)[^>]*)>""", re.I) +# this line is here to fix emacs' cruddy broken syntax highlighting + + +@unique_values +def find_external_links(url, page): + """Find rel="homepage" and rel="download" links in `page`, yielding URLs""" + + for match in REL.finditer(page): + tag, rel = match.groups() + rels = set(map(str.strip, rel.lower().split(','))) + if 'homepage' in rels or 'download' in rels: + for match in HREF.finditer(tag): + yield urllib.parse.urljoin(url, htmldecode(match.group(1))) + + for tag in ("Home Page", "Download URL"): + pos = page.find(tag) + if pos != -1: + match = HREF.search(page, pos) + if match: + yield urllib.parse.urljoin(url, htmldecode(match.group(1))) + + +class ContentChecker: + """ + A null content checker that defines the interface for checking content + """ + + def feed(self, block): + """ + Feed a block of data to the hash. + """ + return + + def is_valid(self): + """ + Check the hash. Return False if validation fails. + """ + return True + + def report(self, reporter, template): + """ + Call reporter with information about the checker (hash name) + substituted into the template. + """ + return + + +class HashChecker(ContentChecker): + pattern = re.compile( + r'(?Psha1|sha224|sha384|sha256|sha512|md5)=' + r'(?P[a-f0-9]+)' + ) + + def __init__(self, hash_name, expected): + self.hash_name = hash_name + self.hash = hashlib.new(hash_name) + self.expected = expected + + @classmethod + def from_url(cls, url): + "Construct a (possibly null) ContentChecker from a URL" + fragment = urllib.parse.urlparse(url)[-1] + if not fragment: + return ContentChecker() + match = cls.pattern.search(fragment) + if not match: + return ContentChecker() + return cls(**match.groupdict()) + + def feed(self, block): + self.hash.update(block) + + def is_valid(self): + return self.hash.hexdigest() == self.expected + + def report(self, reporter, template): + msg = template % self.hash_name + return reporter(msg) + + +class PackageIndex(Environment): + """A distribution index that scans web pages for download URLs""" + + def __init__( + self, index_url="https://pypi.org/simple/", hosts=('*',), + ca_bundle=None, verify_ssl=True, *args, **kw + ): + Environment.__init__(self, *args, **kw) + self.index_url = index_url + "/" [:not index_url.endswith('/')] + self.scanned_urls = {} + self.fetched_urls = {} + self.package_pages = {} + self.allows = re.compile('|'.join(map(translate, hosts))).match + self.to_scan = [] + use_ssl = ( + verify_ssl + and ssl_support.is_available + and (ca_bundle or ssl_support.find_ca_bundle()) + ) + if use_ssl: + self.opener = ssl_support.opener_for(ca_bundle) + else: + self.opener = urllib.request.urlopen + + def process_url(self, url, retrieve=False): + """Evaluate a URL as a possible download, and maybe retrieve it""" + if url in self.scanned_urls and not retrieve: + return + self.scanned_urls[url] = True + if not URL_SCHEME(url): + self.process_filename(url) + return + else: + dists = list(distros_for_url(url)) + if dists: + if not self.url_ok(url): + return + self.debug("Found link: %s", url) + + if dists or not retrieve or url in self.fetched_urls: + list(map(self.add, dists)) + return # don't need the actual page + + if not self.url_ok(url): + self.fetched_urls[url] = True + return + + self.info("Reading %s", url) + self.fetched_urls[url] = True # prevent multiple fetch attempts + tmpl = "Download error on %s: %%s -- Some packages may not be found!" + f = self.open_url(url, tmpl % url) + if f is None: + return + self.fetched_urls[f.url] = True + if 'html' not in f.headers.get('content-type', '').lower(): + f.close() # not html, we can't process it + return + + base = f.url # handle redirects + page = f.read() + if not isinstance(page, str): + # In Python 3 and got bytes but want str. + if isinstance(f, urllib.error.HTTPError): + # Errors have no charset, assume latin1: + charset = 'latin-1' + else: + charset = f.headers.get_param('charset') or 'latin-1' + page = page.decode(charset, "ignore") + f.close() + for match in HREF.finditer(page): + link = urllib.parse.urljoin(base, htmldecode(match.group(1))) + self.process_url(link) + if url.startswith(self.index_url) and getattr(f, 'code', None) != 404: + page = self.process_index(url, page) + + def process_filename(self, fn, nested=False): + # process filenames or directories + if not os.path.exists(fn): + self.warn("Not found: %s", fn) + return + + if os.path.isdir(fn) and not nested: + path = os.path.realpath(fn) + for item in os.listdir(path): + self.process_filename(os.path.join(path, item), True) + + dists = distros_for_filename(fn) + if dists: + self.debug("Found: %s", fn) + list(map(self.add, dists)) + + def url_ok(self, url, fatal=False): + s = URL_SCHEME(url) + is_file = s and s.group(1).lower() == 'file' + if is_file or self.allows(urllib.parse.urlparse(url)[1]): + return True + msg = ( + "\nNote: Bypassing %s (disallowed host; see " + "http://bit.ly/2hrImnY for details).\n") + if fatal: + raise DistutilsError(msg % url) + else: + self.warn(msg, url) + + def scan_egg_links(self, search_path): + dirs = filter(os.path.isdir, search_path) + egg_links = ( + (path, entry) + for path in dirs + for entry in os.listdir(path) + if entry.endswith('.egg-link') + ) + list(itertools.starmap(self.scan_egg_link, egg_links)) + + def scan_egg_link(self, path, entry): + with open(os.path.join(path, entry)) as raw_lines: + # filter non-empty lines + lines = list(filter(None, map(str.strip, raw_lines))) + + if len(lines) != 2: + # format is not recognized; punt + return + + egg_path, setup_path = lines + + for dist in find_distributions(os.path.join(path, egg_path)): + dist.location = os.path.join(path, *lines) + dist.precedence = SOURCE_DIST + self.add(dist) + + def process_index(self, url, page): + """Process the contents of a PyPI page""" + + def scan(link): + # Process a URL to see if it's for a package page + if link.startswith(self.index_url): + parts = list(map( + urllib.parse.unquote, link[len(self.index_url):].split('/') + )) + if len(parts) == 2 and '#' not in parts[1]: + # it's a package page, sanitize and index it + pkg = safe_name(parts[0]) + ver = safe_version(parts[1]) + self.package_pages.setdefault(pkg.lower(), {})[link] = True + return to_filename(pkg), to_filename(ver) + return None, None + + # process an index page into the package-page index + for match in HREF.finditer(page): + try: + scan(urllib.parse.urljoin(url, htmldecode(match.group(1)))) + except ValueError: + pass + + pkg, ver = scan(url) # ensure this page is in the page index + if pkg: + # process individual package page + for new_url in find_external_links(url, page): + # Process the found URL + base, frag = egg_info_for_url(new_url) + if base.endswith('.py') and not frag: + if ver: + new_url += '#egg=%s-%s' % (pkg, ver) + else: + self.need_version_info(url) + self.scan_url(new_url) + + return PYPI_MD5.sub( + lambda m: '%s' % m.group(1, 3, 2), page + ) + else: + return "" # no sense double-scanning non-package pages + + def need_version_info(self, url): + self.scan_all( + "Page at %s links to .py file(s) without version info; an index " + "scan is required.", url + ) + + def scan_all(self, msg=None, *args): + if self.index_url not in self.fetched_urls: + if msg: + self.warn(msg, *args) + self.info( + "Scanning index of all packages (this may take a while)" + ) + self.scan_url(self.index_url) + + def find_packages(self, requirement): + self.scan_url(self.index_url + requirement.unsafe_name + '/') + + if not self.package_pages.get(requirement.key): + # Fall back to safe version of the name + self.scan_url(self.index_url + requirement.project_name + '/') + + if not self.package_pages.get(requirement.key): + # We couldn't find the target package, so search the index page too + self.not_found_in_index(requirement) + + for url in list(self.package_pages.get(requirement.key, ())): + # scan each page that might be related to the desired package + self.scan_url(url) + + def obtain(self, requirement, installer=None): + self.prescan() + self.find_packages(requirement) + for dist in self[requirement.key]: + if dist in requirement: + return dist + self.debug("%s does not match %s", requirement, dist) + return super(PackageIndex, self).obtain(requirement, installer) + + def check_hash(self, checker, filename, tfp): + """ + checker is a ContentChecker + """ + checker.report( + self.debug, + "Validating %%s checksum for %s" % filename) + if not checker.is_valid(): + tfp.close() + os.unlink(filename) + raise DistutilsError( + "%s validation failed for %s; " + "possible download problem?" + % (checker.hash.name, os.path.basename(filename)) + ) + + def add_find_links(self, urls): + """Add `urls` to the list that will be prescanned for searches""" + for url in urls: + if ( + self.to_scan is None # if we have already "gone online" + or not URL_SCHEME(url) # or it's a local file/directory + or url.startswith('file:') + or list(distros_for_url(url)) # or a direct package link + ): + # then go ahead and process it now + self.scan_url(url) + else: + # otherwise, defer retrieval till later + self.to_scan.append(url) + + def prescan(self): + """Scan urls scheduled for prescanning (e.g. --find-links)""" + if self.to_scan: + list(map(self.scan_url, self.to_scan)) + self.to_scan = None # from now on, go ahead and process immediately + + def not_found_in_index(self, requirement): + if self[requirement.key]: # we've seen at least one distro + meth, msg = self.info, "Couldn't retrieve index page for %r" + else: # no distros seen for this name, might be misspelled + meth, msg = ( + self.warn, + "Couldn't find index page for %r (maybe misspelled?)") + meth(msg, requirement.unsafe_name) + self.scan_all() + + def download(self, spec, tmpdir): + """Locate and/or download `spec` to `tmpdir`, returning a local path + + `spec` may be a ``Requirement`` object, or a string containing a URL, + an existing local filename, or a project/version requirement spec + (i.e. the string form of a ``Requirement`` object). If it is the URL + of a .py file with an unambiguous ``#egg=name-version`` tag (i.e., one + that escapes ``-`` as ``_`` throughout), a trivial ``setup.py`` is + automatically created alongside the downloaded file. + + If `spec` is a ``Requirement`` object or a string containing a + project/version requirement spec, this method returns the location of + a matching distribution (possibly after downloading it to `tmpdir`). + If `spec` is a locally existing file or directory name, it is simply + returned unchanged. If `spec` is a URL, it is downloaded to a subpath + of `tmpdir`, and the local filename is returned. Various errors may be + raised if a problem occurs during downloading. + """ + if not isinstance(spec, Requirement): + scheme = URL_SCHEME(spec) + if scheme: + # It's a url, download it to tmpdir + found = self._download_url(scheme.group(1), spec, tmpdir) + base, fragment = egg_info_for_url(spec) + if base.endswith('.py'): + found = self.gen_setup(found, fragment, tmpdir) + return found + elif os.path.exists(spec): + # Existing file or directory, just return it + return spec + else: + spec = parse_requirement_arg(spec) + return getattr(self.fetch_distribution(spec, tmpdir), 'location', None) + + def fetch_distribution( + self, requirement, tmpdir, force_scan=False, source=False, + develop_ok=False, local_index=None): + """Obtain a distribution suitable for fulfilling `requirement` + + `requirement` must be a ``pkg_resources.Requirement`` instance. + If necessary, or if the `force_scan` flag is set, the requirement is + searched for in the (online) package index as well as the locally + installed packages. If a distribution matching `requirement` is found, + the returned distribution's ``location`` is the value you would have + gotten from calling the ``download()`` method with the matching + distribution's URL or filename. If no matching distribution is found, + ``None`` is returned. + + If the `source` flag is set, only source distributions and source + checkout links will be considered. Unless the `develop_ok` flag is + set, development and system eggs (i.e., those using the ``.egg-info`` + format) will be ignored. + """ + # process a Requirement + self.info("Searching for %s", requirement) + skipped = {} + dist = None + + def find(req, env=None): + if env is None: + env = self + # Find a matching distribution; may be called more than once + + for dist in env[req.key]: + + if dist.precedence == DEVELOP_DIST and not develop_ok: + if dist not in skipped: + self.warn( + "Skipping development or system egg: %s", dist, + ) + skipped[dist] = 1 + continue + + test = ( + dist in req + and (dist.precedence <= SOURCE_DIST or not source) + ) + if test: + loc = self.download(dist.location, tmpdir) + dist.download_location = loc + if os.path.exists(dist.download_location): + return dist + + if force_scan: + self.prescan() + self.find_packages(requirement) + dist = find(requirement) + + if not dist and local_index is not None: + dist = find(requirement, local_index) + + if dist is None: + if self.to_scan is not None: + self.prescan() + dist = find(requirement) + + if dist is None and not force_scan: + self.find_packages(requirement) + dist = find(requirement) + + if dist is None: + self.warn( + "No local packages or working download links found for %s%s", + (source and "a source distribution of " or ""), + requirement, + ) + else: + self.info("Best match: %s", dist) + return dist.clone(location=dist.download_location) + + def fetch(self, requirement, tmpdir, force_scan=False, source=False): + """Obtain a file suitable for fulfilling `requirement` + + DEPRECATED; use the ``fetch_distribution()`` method now instead. For + backward compatibility, this routine is identical but returns the + ``location`` of the downloaded distribution instead of a distribution + object. + """ + dist = self.fetch_distribution(requirement, tmpdir, force_scan, source) + if dist is not None: + return dist.location + return None + + def gen_setup(self, filename, fragment, tmpdir): + match = EGG_FRAGMENT.match(fragment) + dists = match and [ + d for d in + interpret_distro_name(filename, match.group(1), None) if d.version + ] or [] + + if len(dists) == 1: # unambiguous ``#egg`` fragment + basename = os.path.basename(filename) + + # Make sure the file has been downloaded to the temp dir. + if os.path.dirname(filename) != tmpdir: + dst = os.path.join(tmpdir, basename) + from setuptools.command.easy_install import samefile + if not samefile(filename, dst): + shutil.copy2(filename, dst) + filename = dst + + with open(os.path.join(tmpdir, 'setup.py'), 'w') as file: + file.write( + "from setuptools import setup\n" + "setup(name=%r, version=%r, py_modules=[%r])\n" + % ( + dists[0].project_name, dists[0].version, + os.path.splitext(basename)[0] + ) + ) + return filename + + elif match: + raise DistutilsError( + "Can't unambiguously interpret project/version identifier %r; " + "any dashes in the name or version should be escaped using " + "underscores. %r" % (fragment, dists) + ) + else: + raise DistutilsError( + "Can't process plain .py files without an '#egg=name-version'" + " suffix to enable automatic setup script generation." + ) + + dl_blocksize = 8192 + + def _download_to(self, url, filename): + self.info("Downloading %s", url) + # Download the file + fp = None + try: + checker = HashChecker.from_url(url) + fp = self.open_url(url) + if isinstance(fp, urllib.error.HTTPError): + raise DistutilsError( + "Can't download %s: %s %s" % (url, fp.code, fp.msg) + ) + headers = fp.info() + blocknum = 0 + bs = self.dl_blocksize + size = -1 + if "content-length" in headers: + # Some servers return multiple Content-Length headers :( + sizes = get_all_headers(headers, 'Content-Length') + size = max(map(int, sizes)) + self.reporthook(url, filename, blocknum, bs, size) + with open(filename, 'wb') as tfp: + while True: + block = fp.read(bs) + if block: + checker.feed(block) + tfp.write(block) + blocknum += 1 + self.reporthook(url, filename, blocknum, bs, size) + else: + break + self.check_hash(checker, filename, tfp) + return headers + finally: + if fp: + fp.close() + + def reporthook(self, url, filename, blocknum, blksize, size): + pass # no-op + + def open_url(self, url, warning=None): + if url.startswith('file:'): + return local_open(url) + try: + return open_with_auth(url, self.opener) + except (ValueError, http_client.InvalidURL) as v: + msg = ' '.join([str(arg) for arg in v.args]) + if warning: + self.warn(warning, msg) + else: + raise DistutilsError('%s %s' % (url, msg)) + except urllib.error.HTTPError as v: + return v + except urllib.error.URLError as v: + if warning: + self.warn(warning, v.reason) + else: + raise DistutilsError("Download error for %s: %s" + % (url, v.reason)) + except http_client.BadStatusLine as v: + if warning: + self.warn(warning, v.line) + else: + raise DistutilsError( + '%s returned a bad status line. The server might be ' + 'down, %s' % + (url, v.line) + ) + except (http_client.HTTPException, socket.error) as v: + if warning: + self.warn(warning, v) + else: + raise DistutilsError("Download error for %s: %s" + % (url, v)) + + def _download_url(self, scheme, url, tmpdir): + # Determine download filename + # + name, fragment = egg_info_for_url(url) + if name: + while '..' in name: + name = name.replace('..', '.').replace('\\', '_') + else: + name = "__downloaded__" # default if URL has no path contents + + if name.endswith('.egg.zip'): + name = name[:-4] # strip the extra .zip before download + + filename = os.path.join(tmpdir, name) + + # Download the file + # + if scheme == 'svn' or scheme.startswith('svn+'): + return self._download_svn(url, filename) + elif scheme == 'git' or scheme.startswith('git+'): + return self._download_git(url, filename) + elif scheme.startswith('hg+'): + return self._download_hg(url, filename) + elif scheme == 'file': + return urllib.request.url2pathname(urllib.parse.urlparse(url)[2]) + else: + self.url_ok(url, True) # raises error if not allowed + return self._attempt_download(url, filename) + + def scan_url(self, url): + self.process_url(url, True) + + def _attempt_download(self, url, filename): + headers = self._download_to(url, filename) + if 'html' in headers.get('content-type', '').lower(): + return self._download_html(url, headers, filename) + else: + return filename + + def _download_html(self, url, headers, filename): + file = open(filename) + for line in file: + if line.strip(): + # Check for a subversion index page + if re.search(r'([^- ]+ - )?Revision \d+:', line): + # it's a subversion index page: + file.close() + os.unlink(filename) + return self._download_svn(url, filename) + break # not an index page + file.close() + os.unlink(filename) + raise DistutilsError("Unexpected HTML page found at " + url) + + def _download_svn(self, url, filename): + warnings.warn("SVN download support is deprecated", UserWarning) + url = url.split('#', 1)[0] # remove any fragment for svn's sake + creds = '' + if url.lower().startswith('svn:') and '@' in url: + scheme, netloc, path, p, q, f = urllib.parse.urlparse(url) + if not netloc and path.startswith('//') and '/' in path[2:]: + netloc, path = path[2:].split('/', 1) + auth, host = _splituser(netloc) + if auth: + if ':' in auth: + user, pw = auth.split(':', 1) + creds = " --username=%s --password=%s" % (user, pw) + else: + creds = " --username=" + auth + netloc = host + parts = scheme, netloc, url, p, q, f + url = urllib.parse.urlunparse(parts) + self.info("Doing subversion checkout from %s to %s", url, filename) + os.system("svn checkout%s -q %s %s" % (creds, url, filename)) + return filename + + @staticmethod + def _vcs_split_rev_from_url(url, pop_prefix=False): + scheme, netloc, path, query, frag = urllib.parse.urlsplit(url) + + scheme = scheme.split('+', 1)[-1] + + # Some fragment identification fails + path = path.split('#', 1)[0] + + rev = None + if '@' in path: + path, rev = path.rsplit('@', 1) + + # Also, discard fragment + url = urllib.parse.urlunsplit((scheme, netloc, path, query, '')) + + return url, rev + + def _download_git(self, url, filename): + filename = filename.split('#', 1)[0] + url, rev = self._vcs_split_rev_from_url(url, pop_prefix=True) + + self.info("Doing git clone from %s to %s", url, filename) + os.system("git clone --quiet %s %s" % (url, filename)) + + if rev is not None: + self.info("Checking out %s", rev) + os.system("git -C %s checkout --quiet %s" % ( + filename, + rev, + )) + + return filename + + def _download_hg(self, url, filename): + filename = filename.split('#', 1)[0] + url, rev = self._vcs_split_rev_from_url(url, pop_prefix=True) + + self.info("Doing hg clone from %s to %s", url, filename) + os.system("hg clone --quiet %s %s" % (url, filename)) + + if rev is not None: + self.info("Updating to %s", rev) + os.system("hg --cwd %s up -C -r %s -q" % ( + filename, + rev, + )) + + return filename + + def debug(self, msg, *args): + log.debug(msg, *args) + + def info(self, msg, *args): + log.info(msg, *args) + + def warn(self, msg, *args): + log.warn(msg, *args) + + +# This pattern matches a character entity reference (a decimal numeric +# references, a hexadecimal numeric reference, or a named reference). +entity_sub = re.compile(r'&(#(\d+|x[\da-fA-F]+)|[\w.:-]+);?').sub + + +def decode_entity(match): + what = match.group(0) + return unescape(what) + + +def htmldecode(text): + """ + Decode HTML entities in the given text. + + >>> htmldecode( + ... 'https://../package_name-0.1.2.tar.gz' + ... '?tokena=A&tokenb=B">package_name-0.1.2.tar.gz') + 'https://../package_name-0.1.2.tar.gz?tokena=A&tokenb=B">package_name-0.1.2.tar.gz' + """ + return entity_sub(decode_entity, text) + + +def socket_timeout(timeout=15): + def _socket_timeout(func): + def _socket_timeout(*args, **kwargs): + old_timeout = socket.getdefaulttimeout() + socket.setdefaulttimeout(timeout) + try: + return func(*args, **kwargs) + finally: + socket.setdefaulttimeout(old_timeout) + + return _socket_timeout + + return _socket_timeout + + +def _encode_auth(auth): + """ + A function compatible with Python 2.3-3.3 that will encode + auth from a URL suitable for an HTTP header. + >>> str(_encode_auth('username%3Apassword')) + 'dXNlcm5hbWU6cGFzc3dvcmQ=' + + Long auth strings should not cause a newline to be inserted. + >>> long_auth = 'username:' + 'password'*10 + >>> chr(10) in str(_encode_auth(long_auth)) + False + """ + auth_s = urllib.parse.unquote(auth) + # convert to bytes + auth_bytes = auth_s.encode() + encoded_bytes = base64.b64encode(auth_bytes) + # convert back to a string + encoded = encoded_bytes.decode() + # strip the trailing carriage return + return encoded.replace('\n', '') + + +class Credential: + """ + A username/password pair. Use like a namedtuple. + """ + + def __init__(self, username, password): + self.username = username + self.password = password + + def __iter__(self): + yield self.username + yield self.password + + def __str__(self): + return '%(username)s:%(password)s' % vars(self) + + +class PyPIConfig(configparser.RawConfigParser): + def __init__(self): + """ + Load from ~/.pypirc + """ + defaults = dict.fromkeys(['username', 'password', 'repository'], '') + configparser.RawConfigParser.__init__(self, defaults) + + rc = os.path.join(os.path.expanduser('~'), '.pypirc') + if os.path.exists(rc): + self.read(rc) + + @property + def creds_by_repository(self): + sections_with_repositories = [ + section for section in self.sections() + if self.get(section, 'repository').strip() + ] + + return dict(map(self._get_repo_cred, sections_with_repositories)) + + def _get_repo_cred(self, section): + repo = self.get(section, 'repository').strip() + return repo, Credential( + self.get(section, 'username').strip(), + self.get(section, 'password').strip(), + ) + + def find_credential(self, url): + """ + If the URL indicated appears to be a repository defined in this + config, return the credential for that repository. + """ + for repository, cred in self.creds_by_repository.items(): + if url.startswith(repository): + return cred + + +def open_with_auth(url, opener=urllib.request.urlopen): + """Open a urllib2 request, handling HTTP authentication""" + + parsed = urllib.parse.urlparse(url) + scheme, netloc, path, params, query, frag = parsed + + # Double scheme does not raise on Mac OS X as revealed by a + # failing test. We would expect "nonnumeric port". Refs #20. + if netloc.endswith(':'): + raise http_client.InvalidURL("nonnumeric port: ''") + + if scheme in ('http', 'https'): + auth, address = _splituser(netloc) + else: + auth = None + + if not auth: + cred = PyPIConfig().find_credential(url) + if cred: + auth = str(cred) + info = cred.username, url + log.info('Authenticating as %s for %s (from .pypirc)', *info) + + if auth: + auth = "Basic " + _encode_auth(auth) + parts = scheme, address, path, params, query, frag + new_url = urllib.parse.urlunparse(parts) + request = urllib.request.Request(new_url) + request.add_header("Authorization", auth) + else: + request = urllib.request.Request(url) + + request.add_header('User-Agent', user_agent) + fp = opener(request) + + if auth: + # Put authentication info back into request URL if same host, + # so that links found on the page will work + s2, h2, path2, param2, query2, frag2 = urllib.parse.urlparse(fp.url) + if s2 == scheme and h2 == address: + parts = s2, netloc, path2, param2, query2, frag2 + fp.url = urllib.parse.urlunparse(parts) + + return fp + + +# copy of urllib.parse._splituser from Python 3.8 +def _splituser(host): + """splituser('user[:passwd]@host[:port]') --> 'user[:passwd]', 'host[:port]'.""" + user, delim, host = host.rpartition('@') + return (user if delim else None), host + + +# adding a timeout to avoid freezing package_index +open_with_auth = socket_timeout(_SOCKET_TIMEOUT)(open_with_auth) + + +def fix_sf_url(url): + return url # backward compatibility + + +def local_open(url): + """Read a local path, with special support for directories""" + scheme, server, path, param, query, frag = urllib.parse.urlparse(url) + filename = urllib.request.url2pathname(path) + if os.path.isfile(filename): + return urllib.request.urlopen(url) + elif path.endswith('/') and os.path.isdir(filename): + files = [] + for f in os.listdir(filename): + filepath = os.path.join(filename, f) + if f == 'index.html': + with open(filepath, 'r') as fp: + body = fp.read() + break + elif os.path.isdir(filepath): + f += '/' + files.append('<a href="{name}">{name}</a>'.format(name=f)) + else: + tmpl = ( + "<html><head><title>{url}" + "{files}") + body = tmpl.format(url=url, files='\n'.join(files)) + status, message = 200, "OK" + else: + status, message, body = 404, "Path not found", "Not found" + + headers = {'content-type': 'text/html'} + body_stream = six.StringIO(body) + return urllib.error.HTTPError(url, status, message, headers, body_stream) diff --git a/venv/lib/python3.8/site-packages/setuptools/py27compat.py b/venv/lib/python3.8/site-packages/setuptools/py27compat.py new file mode 100644 index 000000000..1d57360f4 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/py27compat.py @@ -0,0 +1,60 @@ +""" +Compatibility Support for Python 2.7 and earlier +""" + +import sys +import platform + +from setuptools.extern import six + + +def get_all_headers(message, key): + """ + Given an HTTPMessage, return all headers matching a given key. + """ + return message.get_all(key) + + +if six.PY2: + def get_all_headers(message, key): + return message.getheaders(key) + + +linux_py2_ascii = ( + platform.system() == 'Linux' and + six.PY2 +) + +rmtree_safe = str if linux_py2_ascii else lambda x: x +"""Workaround for http://bugs.python.org/issue24672""" + + +try: + from ._imp import find_module, PY_COMPILED, PY_FROZEN, PY_SOURCE + from ._imp import get_frozen_object, get_module +except ImportError: + import imp + from imp import PY_COMPILED, PY_FROZEN, PY_SOURCE # noqa + + def find_module(module, paths=None): + """Just like 'imp.find_module()', but with package support""" + parts = module.split('.') + while parts: + part = parts.pop(0) + f, path, (suffix, mode, kind) = info = imp.find_module(part, paths) + + if kind == imp.PKG_DIRECTORY: + parts = parts or ['__init__'] + paths = [path] + + elif parts: + raise ImportError("Can't find %r in %s" % (parts, module)) + + return info + + def get_frozen_object(module, paths): + return imp.get_frozen_object(module) + + def get_module(module, paths, info): + imp.load_module(module, *info) + return sys.modules[module] diff --git a/venv/lib/python3.8/site-packages/setuptools/py31compat.py b/venv/lib/python3.8/site-packages/setuptools/py31compat.py new file mode 100644 index 000000000..e1da7ee2a --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/py31compat.py @@ -0,0 +1,32 @@ +__all__ = [] + +__metaclass__ = type + + +try: + # Python >=3.2 + from tempfile import TemporaryDirectory +except ImportError: + import shutil + import tempfile + + class TemporaryDirectory: + """ + Very simple temporary directory context manager. + Will try to delete afterward, but will also ignore OS and similar + errors on deletion. + """ + + def __init__(self, **kwargs): + self.name = None # Handle mkdtemp raising an exception + self.name = tempfile.mkdtemp(**kwargs) + + def __enter__(self): + return self.name + + def __exit__(self, exctype, excvalue, exctrace): + try: + shutil.rmtree(self.name, True) + except OSError: # removal errors are not the only possible + pass + self.name = None diff --git a/venv/lib/python3.8/site-packages/setuptools/py33compat.py b/venv/lib/python3.8/site-packages/setuptools/py33compat.py new file mode 100644 index 000000000..cb6944363 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/py33compat.py @@ -0,0 +1,59 @@ +import dis +import array +import collections + +try: + import html +except ImportError: + html = None + +from setuptools.extern import six +from setuptools.extern.six.moves import html_parser + +__metaclass__ = type + +OpArg = collections.namedtuple('OpArg', 'opcode arg') + + +class Bytecode_compat: + def __init__(self, code): + self.code = code + + def __iter__(self): + """Yield '(op,arg)' pair for each operation in code object 'code'""" + + bytes = array.array('b', self.code.co_code) + eof = len(self.code.co_code) + + ptr = 0 + extended_arg = 0 + + while ptr < eof: + + op = bytes[ptr] + + if op >= dis.HAVE_ARGUMENT: + + arg = bytes[ptr + 1] + bytes[ptr + 2] * 256 + extended_arg + ptr += 3 + + if op == dis.EXTENDED_ARG: + long_type = six.integer_types[-1] + extended_arg = arg * long_type(65536) + continue + + else: + arg = None + ptr += 1 + + yield OpArg(op, arg) + + +Bytecode = getattr(dis, 'Bytecode', Bytecode_compat) + + +unescape = getattr(html, 'unescape', None) +if unescape is None: + # HTMLParser.unescape is deprecated since Python 3.4, and will be removed + # from 3.9. + unescape = html_parser.HTMLParser().unescape diff --git a/venv/lib/python3.8/site-packages/setuptools/py34compat.py b/venv/lib/python3.8/site-packages/setuptools/py34compat.py new file mode 100644 index 000000000..3ad917222 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/py34compat.py @@ -0,0 +1,13 @@ +import importlib + +try: + import importlib.util +except ImportError: + pass + + +try: + module_from_spec = importlib.util.module_from_spec +except AttributeError: + def module_from_spec(spec): + return spec.loader.load_module(spec.name) diff --git a/venv/lib/python3.8/site-packages/setuptools/sandbox.py b/venv/lib/python3.8/site-packages/setuptools/sandbox.py new file mode 100644 index 000000000..685f3f72e --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/sandbox.py @@ -0,0 +1,491 @@ +import os +import sys +import tempfile +import operator +import functools +import itertools +import re +import contextlib +import pickle +import textwrap + +from setuptools.extern import six +from setuptools.extern.six.moves import builtins, map + +import pkg_resources.py31compat + +if sys.platform.startswith('java'): + import org.python.modules.posix.PosixModule as _os +else: + _os = sys.modules[os.name] +try: + _file = file +except NameError: + _file = None +_open = open +from distutils.errors import DistutilsError +from pkg_resources import working_set + + +__all__ = [ + "AbstractSandbox", "DirectorySandbox", "SandboxViolation", "run_setup", +] + + +def _execfile(filename, globals, locals=None): + """ + Python 3 implementation of execfile. + """ + mode = 'rb' + with open(filename, mode) as stream: + script = stream.read() + if locals is None: + locals = globals + code = compile(script, filename, 'exec') + exec(code, globals, locals) + + +@contextlib.contextmanager +def save_argv(repl=None): + saved = sys.argv[:] + if repl is not None: + sys.argv[:] = repl + try: + yield saved + finally: + sys.argv[:] = saved + + +@contextlib.contextmanager +def save_path(): + saved = sys.path[:] + try: + yield saved + finally: + sys.path[:] = saved + + +@contextlib.contextmanager +def override_temp(replacement): + """ + Monkey-patch tempfile.tempdir with replacement, ensuring it exists + """ + pkg_resources.py31compat.makedirs(replacement, exist_ok=True) + + saved = tempfile.tempdir + + tempfile.tempdir = replacement + + try: + yield + finally: + tempfile.tempdir = saved + + +@contextlib.contextmanager +def pushd(target): + saved = os.getcwd() + os.chdir(target) + try: + yield saved + finally: + os.chdir(saved) + + +class UnpickleableException(Exception): + """ + An exception representing another Exception that could not be pickled. + """ + + @staticmethod + def dump(type, exc): + """ + Always return a dumped (pickled) type and exc. If exc can't be pickled, + wrap it in UnpickleableException first. + """ + try: + return pickle.dumps(type), pickle.dumps(exc) + except Exception: + # get UnpickleableException inside the sandbox + from setuptools.sandbox import UnpickleableException as cls + return cls.dump(cls, cls(repr(exc))) + + +class ExceptionSaver: + """ + A Context Manager that will save an exception, serialized, and restore it + later. + """ + + def __enter__(self): + return self + + def __exit__(self, type, exc, tb): + if not exc: + return + + # dump the exception + self._saved = UnpickleableException.dump(type, exc) + self._tb = tb + + # suppress the exception + return True + + def resume(self): + "restore and re-raise any exception" + + if '_saved' not in vars(self): + return + + type, exc = map(pickle.loads, self._saved) + six.reraise(type, exc, self._tb) + + +@contextlib.contextmanager +def save_modules(): + """ + Context in which imported modules are saved. + + Translates exceptions internal to the context into the equivalent exception + outside the context. + """ + saved = sys.modules.copy() + with ExceptionSaver() as saved_exc: + yield saved + + sys.modules.update(saved) + # remove any modules imported since + del_modules = ( + mod_name for mod_name in sys.modules + if mod_name not in saved + # exclude any encodings modules. See #285 + and not mod_name.startswith('encodings.') + ) + _clear_modules(del_modules) + + saved_exc.resume() + + +def _clear_modules(module_names): + for mod_name in list(module_names): + del sys.modules[mod_name] + + +@contextlib.contextmanager +def save_pkg_resources_state(): + saved = pkg_resources.__getstate__() + try: + yield saved + finally: + pkg_resources.__setstate__(saved) + + +@contextlib.contextmanager +def setup_context(setup_dir): + temp_dir = os.path.join(setup_dir, 'temp') + with save_pkg_resources_state(): + with save_modules(): + hide_setuptools() + with save_path(): + with save_argv(): + with override_temp(temp_dir): + with pushd(setup_dir): + # ensure setuptools commands are available + __import__('setuptools') + yield + + +def _needs_hiding(mod_name): + """ + >>> _needs_hiding('setuptools') + True + >>> _needs_hiding('pkg_resources') + True + >>> _needs_hiding('setuptools_plugin') + False + >>> _needs_hiding('setuptools.__init__') + True + >>> _needs_hiding('distutils') + True + >>> _needs_hiding('os') + False + >>> _needs_hiding('Cython') + True + """ + pattern = re.compile(r'(setuptools|pkg_resources|distutils|Cython)(\.|$)') + return bool(pattern.match(mod_name)) + + +def hide_setuptools(): + """ + Remove references to setuptools' modules from sys.modules to allow the + invocation to import the most appropriate setuptools. This technique is + necessary to avoid issues such as #315 where setuptools upgrading itself + would fail to find a function declared in the metadata. + """ + modules = filter(_needs_hiding, sys.modules) + _clear_modules(modules) + + +def run_setup(setup_script, args): + """Run a distutils setup script, sandboxed in its directory""" + setup_dir = os.path.abspath(os.path.dirname(setup_script)) + with setup_context(setup_dir): + try: + sys.argv[:] = [setup_script] + list(args) + sys.path.insert(0, setup_dir) + # reset to include setup dir, w/clean callback list + working_set.__init__() + working_set.callbacks.append(lambda dist: dist.activate()) + + # __file__ should be a byte string on Python 2 (#712) + dunder_file = ( + setup_script + if isinstance(setup_script, str) else + setup_script.encode(sys.getfilesystemencoding()) + ) + + with DirectorySandbox(setup_dir): + ns = dict(__file__=dunder_file, __name__='__main__') + _execfile(setup_script, ns) + except SystemExit as v: + if v.args and v.args[0]: + raise + # Normal exit, just return + + +class AbstractSandbox: + """Wrap 'os' module and 'open()' builtin for virtualizing setup scripts""" + + _active = False + + def __init__(self): + self._attrs = [ + name for name in dir(_os) + if not name.startswith('_') and hasattr(self, name) + ] + + def _copy(self, source): + for name in self._attrs: + setattr(os, name, getattr(source, name)) + + def __enter__(self): + self._copy(self) + if _file: + builtins.file = self._file + builtins.open = self._open + self._active = True + + def __exit__(self, exc_type, exc_value, traceback): + self._active = False + if _file: + builtins.file = _file + builtins.open = _open + self._copy(_os) + + def run(self, func): + """Run 'func' under os sandboxing""" + with self: + return func() + + def _mk_dual_path_wrapper(name): + original = getattr(_os, name) + + def wrap(self, src, dst, *args, **kw): + if self._active: + src, dst = self._remap_pair(name, src, dst, *args, **kw) + return original(src, dst, *args, **kw) + + return wrap + + for name in ["rename", "link", "symlink"]: + if hasattr(_os, name): + locals()[name] = _mk_dual_path_wrapper(name) + + def _mk_single_path_wrapper(name, original=None): + original = original or getattr(_os, name) + + def wrap(self, path, *args, **kw): + if self._active: + path = self._remap_input(name, path, *args, **kw) + return original(path, *args, **kw) + + return wrap + + if _file: + _file = _mk_single_path_wrapper('file', _file) + _open = _mk_single_path_wrapper('open', _open) + for name in [ + "stat", "listdir", "chdir", "open", "chmod", "chown", "mkdir", + "remove", "unlink", "rmdir", "utime", "lchown", "chroot", "lstat", + "startfile", "mkfifo", "mknod", "pathconf", "access" + ]: + if hasattr(_os, name): + locals()[name] = _mk_single_path_wrapper(name) + + def _mk_single_with_return(name): + original = getattr(_os, name) + + def wrap(self, path, *args, **kw): + if self._active: + path = self._remap_input(name, path, *args, **kw) + return self._remap_output(name, original(path, *args, **kw)) + return original(path, *args, **kw) + + return wrap + + for name in ['readlink', 'tempnam']: + if hasattr(_os, name): + locals()[name] = _mk_single_with_return(name) + + def _mk_query(name): + original = getattr(_os, name) + + def wrap(self, *args, **kw): + retval = original(*args, **kw) + if self._active: + return self._remap_output(name, retval) + return retval + + return wrap + + for name in ['getcwd', 'tmpnam']: + if hasattr(_os, name): + locals()[name] = _mk_query(name) + + def _validate_path(self, path): + """Called to remap or validate any path, whether input or output""" + return path + + def _remap_input(self, operation, path, *args, **kw): + """Called for path inputs""" + return self._validate_path(path) + + def _remap_output(self, operation, path): + """Called for path outputs""" + return self._validate_path(path) + + def _remap_pair(self, operation, src, dst, *args, **kw): + """Called for path pairs like rename, link, and symlink operations""" + return ( + self._remap_input(operation + '-from', src, *args, **kw), + self._remap_input(operation + '-to', dst, *args, **kw) + ) + + +if hasattr(os, 'devnull'): + _EXCEPTIONS = [os.devnull,] +else: + _EXCEPTIONS = [] + + +class DirectorySandbox(AbstractSandbox): + """Restrict operations to a single subdirectory - pseudo-chroot""" + + write_ops = dict.fromkeys([ + "open", "chmod", "chown", "mkdir", "remove", "unlink", "rmdir", + "utime", "lchown", "chroot", "mkfifo", "mknod", "tempnam", + ]) + + _exception_patterns = [ + # Allow lib2to3 to attempt to save a pickled grammar object (#121) + r'.*lib2to3.*\.pickle$', + ] + "exempt writing to paths that match the pattern" + + def __init__(self, sandbox, exceptions=_EXCEPTIONS): + self._sandbox = os.path.normcase(os.path.realpath(sandbox)) + self._prefix = os.path.join(self._sandbox, '') + self._exceptions = [ + os.path.normcase(os.path.realpath(path)) + for path in exceptions + ] + AbstractSandbox.__init__(self) + + def _violation(self, operation, *args, **kw): + from setuptools.sandbox import SandboxViolation + raise SandboxViolation(operation, args, kw) + + if _file: + + def _file(self, path, mode='r', *args, **kw): + if mode not in ('r', 'rt', 'rb', 'rU', 'U') and not self._ok(path): + self._violation("file", path, mode, *args, **kw) + return _file(path, mode, *args, **kw) + + def _open(self, path, mode='r', *args, **kw): + if mode not in ('r', 'rt', 'rb', 'rU', 'U') and not self._ok(path): + self._violation("open", path, mode, *args, **kw) + return _open(path, mode, *args, **kw) + + def tmpnam(self): + self._violation("tmpnam") + + def _ok(self, path): + active = self._active + try: + self._active = False + realpath = os.path.normcase(os.path.realpath(path)) + return ( + self._exempted(realpath) + or realpath == self._sandbox + or realpath.startswith(self._prefix) + ) + finally: + self._active = active + + def _exempted(self, filepath): + start_matches = ( + filepath.startswith(exception) + for exception in self._exceptions + ) + pattern_matches = ( + re.match(pattern, filepath) + for pattern in self._exception_patterns + ) + candidates = itertools.chain(start_matches, pattern_matches) + return any(candidates) + + def _remap_input(self, operation, path, *args, **kw): + """Called for path inputs""" + if operation in self.write_ops and not self._ok(path): + self._violation(operation, os.path.realpath(path), *args, **kw) + return path + + def _remap_pair(self, operation, src, dst, *args, **kw): + """Called for path pairs like rename, link, and symlink operations""" + if not self._ok(src) or not self._ok(dst): + self._violation(operation, src, dst, *args, **kw) + return (src, dst) + + def open(self, file, flags, mode=0o777, *args, **kw): + """Called for low-level os.open()""" + if flags & WRITE_FLAGS and not self._ok(file): + self._violation("os.open", file, flags, mode, *args, **kw) + return _os.open(file, flags, mode, *args, **kw) + + +WRITE_FLAGS = functools.reduce( + operator.or_, [getattr(_os, a, 0) for a in + "O_WRONLY O_RDWR O_APPEND O_CREAT O_TRUNC O_TEMPORARY".split()] +) + + +class SandboxViolation(DistutilsError): + """A setup script attempted to modify the filesystem outside the sandbox""" + + tmpl = textwrap.dedent(""" + SandboxViolation: {cmd}{args!r} {kwargs} + + The package setup script has attempted to modify files on your system + that are not within the EasyInstall build area, and has been aborted. + + This package cannot be safely installed by EasyInstall, and may not + support alternate installation locations even if you run its setup + script by hand. Please inform the package's author and the EasyInstall + maintainers to find out if a fix or workaround is available. + """).lstrip() + + def __str__(self): + cmd, args, kwargs = self.args + return self.tmpl.format(**locals()) diff --git a/venv/lib/python3.8/site-packages/setuptools/script (dev).tmpl b/venv/lib/python3.8/site-packages/setuptools/script (dev).tmpl new file mode 100644 index 000000000..39a24b048 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/script (dev).tmpl @@ -0,0 +1,6 @@ +# EASY-INSTALL-DEV-SCRIPT: %(spec)r,%(script_name)r +__requires__ = %(spec)r +__import__('pkg_resources').require(%(spec)r) +__file__ = %(dev_path)r +with open(__file__) as f: + exec(compile(f.read(), __file__, 'exec')) diff --git a/venv/lib/python3.8/site-packages/setuptools/script.tmpl b/venv/lib/python3.8/site-packages/setuptools/script.tmpl new file mode 100644 index 000000000..ff5efbcab --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/script.tmpl @@ -0,0 +1,3 @@ +# EASY-INSTALL-SCRIPT: %(spec)r,%(script_name)r +__requires__ = %(spec)r +__import__('pkg_resources').run_script(%(spec)r, %(script_name)r) diff --git a/venv/lib/python3.8/site-packages/setuptools/site-patch.py b/venv/lib/python3.8/site-packages/setuptools/site-patch.py new file mode 100644 index 000000000..40b00de0a --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/site-patch.py @@ -0,0 +1,74 @@ +def __boot(): + import sys + import os + PYTHONPATH = os.environ.get('PYTHONPATH') + if PYTHONPATH is None or (sys.platform == 'win32' and not PYTHONPATH): + PYTHONPATH = [] + else: + PYTHONPATH = PYTHONPATH.split(os.pathsep) + + pic = getattr(sys, 'path_importer_cache', {}) + stdpath = sys.path[len(PYTHONPATH):] + mydir = os.path.dirname(__file__) + + for item in stdpath: + if item == mydir or not item: + continue # skip if current dir. on Windows, or my own directory + importer = pic.get(item) + if importer is not None: + loader = importer.find_module('site') + if loader is not None: + # This should actually reload the current module + loader.load_module('site') + break + else: + try: + import imp # Avoid import loop in Python 3 + stream, path, descr = imp.find_module('site', [item]) + except ImportError: + continue + if stream is None: + continue + try: + # This should actually reload the current module + imp.load_module('site', stream, path, descr) + finally: + stream.close() + break + else: + raise ImportError("Couldn't find the real 'site' module") + + known_paths = dict([(makepath(item)[1], 1) for item in sys.path]) # 2.2 comp + + oldpos = getattr(sys, '__egginsert', 0) # save old insertion position + sys.__egginsert = 0 # and reset the current one + + for item in PYTHONPATH: + addsitedir(item) + + sys.__egginsert += oldpos # restore effective old position + + d, nd = makepath(stdpath[0]) + insert_at = None + new_path = [] + + for item in sys.path: + p, np = makepath(item) + + if np == nd and insert_at is None: + # We've hit the first 'system' path entry, so added entries go here + insert_at = len(new_path) + + if np in known_paths or insert_at is None: + new_path.append(item) + else: + # new path after the insert point, back-insert it + new_path.insert(insert_at, item) + insert_at += 1 + + sys.path[:] = new_path + + +if __name__ == 'site': + __boot() + del __boot diff --git a/venv/lib/python3.8/site-packages/setuptools/ssl_support.py b/venv/lib/python3.8/site-packages/setuptools/ssl_support.py new file mode 100644 index 000000000..226db694b --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/ssl_support.py @@ -0,0 +1,260 @@ +import os +import socket +import atexit +import re +import functools + +from setuptools.extern.six.moves import urllib, http_client, map, filter + +from pkg_resources import ResolutionError, ExtractionError + +try: + import ssl +except ImportError: + ssl = None + +__all__ = [ + 'VerifyingHTTPSHandler', 'find_ca_bundle', 'is_available', 'cert_paths', + 'opener_for' +] + +cert_paths = """ +/etc/pki/tls/certs/ca-bundle.crt +/etc/ssl/certs/ca-certificates.crt +/usr/share/ssl/certs/ca-bundle.crt +/usr/local/share/certs/ca-root.crt +/etc/ssl/cert.pem +/System/Library/OpenSSL/certs/cert.pem +/usr/local/share/certs/ca-root-nss.crt +/etc/ssl/ca-bundle.pem +""".strip().split() + +try: + HTTPSHandler = urllib.request.HTTPSHandler + HTTPSConnection = http_client.HTTPSConnection +except AttributeError: + HTTPSHandler = HTTPSConnection = object + +is_available = ssl is not None and object not in (HTTPSHandler, HTTPSConnection) + + +try: + from ssl import CertificateError, match_hostname +except ImportError: + try: + from backports.ssl_match_hostname import CertificateError + from backports.ssl_match_hostname import match_hostname + except ImportError: + CertificateError = None + match_hostname = None + +if not CertificateError: + + class CertificateError(ValueError): + pass + + +if not match_hostname: + + def _dnsname_match(dn, hostname, max_wildcards=1): + """Matching according to RFC 6125, section 6.4.3 + + https://tools.ietf.org/html/rfc6125#section-6.4.3 + """ + pats = [] + if not dn: + return False + + # Ported from python3-syntax: + # leftmost, *remainder = dn.split(r'.') + parts = dn.split(r'.') + leftmost = parts[0] + remainder = parts[1:] + + wildcards = leftmost.count('*') + if wildcards > max_wildcards: + # Issue #17980: avoid denials of service by refusing more + # than one wildcard per fragment. A survey of established + # policy among SSL implementations showed it to be a + # reasonable choice. + raise CertificateError( + "too many wildcards in certificate DNS name: " + repr(dn)) + + # speed up common case w/o wildcards + if not wildcards: + return dn.lower() == hostname.lower() + + # RFC 6125, section 6.4.3, subitem 1. + # The client SHOULD NOT attempt to match a presented identifier in which + # the wildcard character comprises a label other than the left-most label. + if leftmost == '*': + # When '*' is a fragment by itself, it matches a non-empty dotless + # fragment. + pats.append('[^.]+') + elif leftmost.startswith('xn--') or hostname.startswith('xn--'): + # RFC 6125, section 6.4.3, subitem 3. + # The client SHOULD NOT attempt to match a presented identifier + # where the wildcard character is embedded within an A-label or + # U-label of an internationalized domain name. + pats.append(re.escape(leftmost)) + else: + # Otherwise, '*' matches any dotless string, e.g. www* + pats.append(re.escape(leftmost).replace(r'\*', '[^.]*')) + + # add the remaining fragments, ignore any wildcards + for frag in remainder: + pats.append(re.escape(frag)) + + pat = re.compile(r'\A' + r'\.'.join(pats) + r'\Z', re.IGNORECASE) + return pat.match(hostname) + + def match_hostname(cert, hostname): + """Verify that *cert* (in decoded format as returned by + SSLSocket.getpeercert()) matches the *hostname*. RFC 2818 and RFC 6125 + rules are followed, but IP addresses are not accepted for *hostname*. + + CertificateError is raised on failure. On success, the function + returns nothing. + """ + if not cert: + raise ValueError("empty or no certificate") + dnsnames = [] + san = cert.get('subjectAltName', ()) + for key, value in san: + if key == 'DNS': + if _dnsname_match(value, hostname): + return + dnsnames.append(value) + if not dnsnames: + # The subject is only checked when there is no dNSName entry + # in subjectAltName + for sub in cert.get('subject', ()): + for key, value in sub: + # XXX according to RFC 2818, the most specific Common Name + # must be used. + if key == 'commonName': + if _dnsname_match(value, hostname): + return + dnsnames.append(value) + if len(dnsnames) > 1: + raise CertificateError("hostname %r " + "doesn't match either of %s" + % (hostname, ', '.join(map(repr, dnsnames)))) + elif len(dnsnames) == 1: + raise CertificateError("hostname %r " + "doesn't match %r" + % (hostname, dnsnames[0])) + else: + raise CertificateError("no appropriate commonName or " + "subjectAltName fields were found") + + +class VerifyingHTTPSHandler(HTTPSHandler): + """Simple verifying handler: no auth, subclasses, timeouts, etc.""" + + def __init__(self, ca_bundle): + self.ca_bundle = ca_bundle + HTTPSHandler.__init__(self) + + def https_open(self, req): + return self.do_open( + lambda host, **kw: VerifyingHTTPSConn(host, self.ca_bundle, **kw), req + ) + + +class VerifyingHTTPSConn(HTTPSConnection): + """Simple verifying connection: no auth, subclasses, timeouts, etc.""" + + def __init__(self, host, ca_bundle, **kw): + HTTPSConnection.__init__(self, host, **kw) + self.ca_bundle = ca_bundle + + def connect(self): + sock = socket.create_connection( + (self.host, self.port), getattr(self, 'source_address', None) + ) + + # Handle the socket if a (proxy) tunnel is present + if hasattr(self, '_tunnel') and getattr(self, '_tunnel_host', None): + self.sock = sock + self._tunnel() + # http://bugs.python.org/issue7776: Python>=3.4.1 and >=2.7.7 + # change self.host to mean the proxy server host when tunneling is + # being used. Adapt, since we are interested in the destination + # host for the match_hostname() comparison. + actual_host = self._tunnel_host + else: + actual_host = self.host + + if hasattr(ssl, 'create_default_context'): + ctx = ssl.create_default_context(cafile=self.ca_bundle) + self.sock = ctx.wrap_socket(sock, server_hostname=actual_host) + else: + # This is for python < 2.7.9 and < 3.4? + self.sock = ssl.wrap_socket( + sock, cert_reqs=ssl.CERT_REQUIRED, ca_certs=self.ca_bundle + ) + try: + match_hostname(self.sock.getpeercert(), actual_host) + except CertificateError: + self.sock.shutdown(socket.SHUT_RDWR) + self.sock.close() + raise + + +def opener_for(ca_bundle=None): + """Get a urlopen() replacement that uses ca_bundle for verification""" + return urllib.request.build_opener( + VerifyingHTTPSHandler(ca_bundle or find_ca_bundle()) + ).open + + +# from jaraco.functools +def once(func): + @functools.wraps(func) + def wrapper(*args, **kwargs): + if not hasattr(func, 'always_returns'): + func.always_returns = func(*args, **kwargs) + return func.always_returns + return wrapper + + +@once +def get_win_certfile(): + try: + import wincertstore + except ImportError: + return None + + class CertFile(wincertstore.CertFile): + def __init__(self): + super(CertFile, self).__init__() + atexit.register(self.close) + + def close(self): + try: + super(CertFile, self).close() + except OSError: + pass + + _wincerts = CertFile() + _wincerts.addstore('CA') + _wincerts.addstore('ROOT') + return _wincerts.name + + +def find_ca_bundle(): + """Return an existing CA bundle path, or None""" + extant_cert_paths = filter(os.path.isfile, cert_paths) + return ( + get_win_certfile() + or next(extant_cert_paths, None) + or _certifi_where() + ) + + +def _certifi_where(): + try: + return __import__('certifi').where() + except (ImportError, ResolutionError, ExtractionError): + pass diff --git a/venv/lib/python3.8/site-packages/setuptools/unicode_utils.py b/venv/lib/python3.8/site-packages/setuptools/unicode_utils.py new file mode 100644 index 000000000..7c63efd20 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/unicode_utils.py @@ -0,0 +1,44 @@ +import unicodedata +import sys + +from setuptools.extern import six + + +# HFS Plus uses decomposed UTF-8 +def decompose(path): + if isinstance(path, six.text_type): + return unicodedata.normalize('NFD', path) + try: + path = path.decode('utf-8') + path = unicodedata.normalize('NFD', path) + path = path.encode('utf-8') + except UnicodeError: + pass # Not UTF-8 + return path + + +def filesys_decode(path): + """ + Ensure that the given path is decoded, + NONE when no expected encoding works + """ + + if isinstance(path, six.text_type): + return path + + fs_enc = sys.getfilesystemencoding() or 'utf-8' + candidates = fs_enc, 'utf-8' + + for enc in candidates: + try: + return path.decode(enc) + except UnicodeDecodeError: + continue + + +def try_encode(string, enc): + "turn unicode encoding into a functional routine" + try: + return string.encode(enc) + except UnicodeEncodeError: + return None diff --git a/venv/lib/python3.8/site-packages/setuptools/version.py b/venv/lib/python3.8/site-packages/setuptools/version.py new file mode 100644 index 000000000..95e186965 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/version.py @@ -0,0 +1,6 @@ +import pkg_resources + +try: + __version__ = pkg_resources.get_distribution('setuptools').version +except Exception: + __version__ = 'unknown' diff --git a/venv/lib/python3.8/site-packages/setuptools/wheel.py b/venv/lib/python3.8/site-packages/setuptools/wheel.py new file mode 100644 index 000000000..025aaa828 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/wheel.py @@ -0,0 +1,220 @@ +"""Wheels support.""" + +from distutils.util import get_platform +from distutils import log +import email +import itertools +import os +import posixpath +import re +import zipfile + +import pkg_resources +import setuptools +from pkg_resources import parse_version +from setuptools.extern.packaging.tags import sys_tags +from setuptools.extern.packaging.utils import canonicalize_name +from setuptools.extern.six import PY3 +from setuptools.command.egg_info import write_requirements + + +__metaclass__ = type + + +WHEEL_NAME = re.compile( + r"""^(?P.+?)-(?P\d.*?) + ((-(?P\d.*?))?-(?P.+?)-(?P.+?)-(?P.+?) + )\.whl$""", + re.VERBOSE).match + +NAMESPACE_PACKAGE_INIT = '''\ +try: + __import__('pkg_resources').declare_namespace(__name__) +except ImportError: + __path__ = __import__('pkgutil').extend_path(__path__, __name__) +''' + + +def unpack(src_dir, dst_dir): + '''Move everything under `src_dir` to `dst_dir`, and delete the former.''' + for dirpath, dirnames, filenames in os.walk(src_dir): + subdir = os.path.relpath(dirpath, src_dir) + for f in filenames: + src = os.path.join(dirpath, f) + dst = os.path.join(dst_dir, subdir, f) + os.renames(src, dst) + for n, d in reversed(list(enumerate(dirnames))): + src = os.path.join(dirpath, d) + dst = os.path.join(dst_dir, subdir, d) + if not os.path.exists(dst): + # Directory does not exist in destination, + # rename it and prune it from os.walk list. + os.renames(src, dst) + del dirnames[n] + # Cleanup. + for dirpath, dirnames, filenames in os.walk(src_dir, topdown=True): + assert not filenames + os.rmdir(dirpath) + + +class Wheel: + + def __init__(self, filename): + match = WHEEL_NAME(os.path.basename(filename)) + if match is None: + raise ValueError('invalid wheel name: %r' % filename) + self.filename = filename + for k, v in match.groupdict().items(): + setattr(self, k, v) + + def tags(self): + '''List tags (py_version, abi, platform) supported by this wheel.''' + return itertools.product( + self.py_version.split('.'), + self.abi.split('.'), + self.platform.split('.'), + ) + + def is_compatible(self): + '''Is the wheel is compatible with the current platform?''' + supported_tags = set((t.interpreter, t.abi, t.platform) for t in sys_tags()) + return next((True for t in self.tags() if t in supported_tags), False) + + def egg_name(self): + return pkg_resources.Distribution( + project_name=self.project_name, version=self.version, + platform=(None if self.platform == 'any' else get_platform()), + ).egg_name() + '.egg' + + def get_dist_info(self, zf): + # find the correct name of the .dist-info dir in the wheel file + for member in zf.namelist(): + dirname = posixpath.dirname(member) + if (dirname.endswith('.dist-info') and + canonicalize_name(dirname).startswith( + canonicalize_name(self.project_name))): + return dirname + raise ValueError("unsupported wheel format. .dist-info not found") + + def install_as_egg(self, destination_eggdir): + '''Install wheel as an egg directory.''' + with zipfile.ZipFile(self.filename) as zf: + self._install_as_egg(destination_eggdir, zf) + + def _install_as_egg(self, destination_eggdir, zf): + dist_basename = '%s-%s' % (self.project_name, self.version) + dist_info = self.get_dist_info(zf) + dist_data = '%s.data' % dist_basename + egg_info = os.path.join(destination_eggdir, 'EGG-INFO') + + self._convert_metadata(zf, destination_eggdir, dist_info, egg_info) + self._move_data_entries(destination_eggdir, dist_data) + self._fix_namespace_packages(egg_info, destination_eggdir) + + @staticmethod + def _convert_metadata(zf, destination_eggdir, dist_info, egg_info): + def get_metadata(name): + with zf.open(posixpath.join(dist_info, name)) as fp: + value = fp.read().decode('utf-8') if PY3 else fp.read() + return email.parser.Parser().parsestr(value) + + wheel_metadata = get_metadata('WHEEL') + # Check wheel format version is supported. + wheel_version = parse_version(wheel_metadata.get('Wheel-Version')) + wheel_v1 = ( + parse_version('1.0') <= wheel_version < parse_version('2.0dev0') + ) + if not wheel_v1: + raise ValueError( + 'unsupported wheel format version: %s' % wheel_version) + # Extract to target directory. + os.mkdir(destination_eggdir) + zf.extractall(destination_eggdir) + # Convert metadata. + dist_info = os.path.join(destination_eggdir, dist_info) + dist = pkg_resources.Distribution.from_location( + destination_eggdir, dist_info, + metadata=pkg_resources.PathMetadata(destination_eggdir, dist_info), + ) + + # Note: Evaluate and strip markers now, + # as it's difficult to convert back from the syntax: + # foobar; "linux" in sys_platform and extra == 'test' + def raw_req(req): + req.marker = None + return str(req) + install_requires = list(sorted(map(raw_req, dist.requires()))) + extras_require = { + extra: sorted( + req + for req in map(raw_req, dist.requires((extra,))) + if req not in install_requires + ) + for extra in dist.extras + } + os.rename(dist_info, egg_info) + os.rename( + os.path.join(egg_info, 'METADATA'), + os.path.join(egg_info, 'PKG-INFO'), + ) + setup_dist = setuptools.Distribution( + attrs=dict( + install_requires=install_requires, + extras_require=extras_require, + ), + ) + # Temporarily disable info traces. + log_threshold = log._global_log.threshold + log.set_threshold(log.WARN) + try: + write_requirements( + setup_dist.get_command_obj('egg_info'), + None, + os.path.join(egg_info, 'requires.txt'), + ) + finally: + log.set_threshold(log_threshold) + + @staticmethod + def _move_data_entries(destination_eggdir, dist_data): + """Move data entries to their correct location.""" + dist_data = os.path.join(destination_eggdir, dist_data) + dist_data_scripts = os.path.join(dist_data, 'scripts') + if os.path.exists(dist_data_scripts): + egg_info_scripts = os.path.join( + destination_eggdir, 'EGG-INFO', 'scripts') + os.mkdir(egg_info_scripts) + for entry in os.listdir(dist_data_scripts): + # Remove bytecode, as it's not properly handled + # during easy_install scripts install phase. + if entry.endswith('.pyc'): + os.unlink(os.path.join(dist_data_scripts, entry)) + else: + os.rename( + os.path.join(dist_data_scripts, entry), + os.path.join(egg_info_scripts, entry), + ) + os.rmdir(dist_data_scripts) + for subdir in filter(os.path.exists, ( + os.path.join(dist_data, d) + for d in ('data', 'headers', 'purelib', 'platlib') + )): + unpack(subdir, destination_eggdir) + if os.path.exists(dist_data): + os.rmdir(dist_data) + + @staticmethod + def _fix_namespace_packages(egg_info, destination_eggdir): + namespace_packages = os.path.join( + egg_info, 'namespace_packages.txt') + if os.path.exists(namespace_packages): + with open(namespace_packages) as fp: + namespace_packages = fp.read().split() + for mod in namespace_packages: + mod_dir = os.path.join(destination_eggdir, *mod.split('.')) + mod_init = os.path.join(mod_dir, '__init__.py') + if not os.path.exists(mod_dir): + os.mkdir(mod_dir) + if not os.path.exists(mod_init): + with open(mod_init, 'w') as fp: + fp.write(NAMESPACE_PACKAGE_INIT) diff --git a/venv/lib/python3.8/site-packages/setuptools/windows_support.py b/venv/lib/python3.8/site-packages/setuptools/windows_support.py new file mode 100644 index 000000000..cb977cff9 --- /dev/null +++ b/venv/lib/python3.8/site-packages/setuptools/windows_support.py @@ -0,0 +1,29 @@ +import platform +import ctypes + + +def windows_only(func): + if platform.system() != 'Windows': + return lambda *args, **kwargs: None + return func + + +@windows_only +def hide_file(path): + """ + Set the hidden attribute on a file or directory. + + From http://stackoverflow.com/questions/19622133/ + + `path` must be text. + """ + __import__('ctypes.wintypes') + SetFileAttributes = ctypes.windll.kernel32.SetFileAttributesW + SetFileAttributes.argtypes = ctypes.wintypes.LPWSTR, ctypes.wintypes.DWORD + SetFileAttributes.restype = ctypes.wintypes.BOOL + + FILE_ATTRIBUTE_HIDDEN = 0x02 + + ret = SetFileAttributes(path, FILE_ATTRIBUTE_HIDDEN) + if not ret: + raise ctypes.WinError() diff --git a/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/AUTHORS.txt b/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/AUTHORS.txt new file mode 100644 index 000000000..72c87d7d3 --- /dev/null +++ b/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/AUTHORS.txt @@ -0,0 +1,562 @@ +A_Rog +Aakanksha Agrawal <11389424+rasponic@users.noreply.github.com> +Abhinav Sagar <40603139+abhinavsagar@users.noreply.github.com> +ABHYUDAY PRATAP SINGH +abs51295 +AceGentile +Adam Chainz +Adam Tse +Adam Tse +Adam Wentz +admin +Adrien Morison +ahayrapetyan +Ahilya +AinsworthK +Akash Srivastava +Alan Yee +Albert Tugushev +Albert-Guan +albertg +Aleks Bunin +Alethea Flowers +Alex Gaynor +Alex Grönholm +Alex Loosley +Alex Morega +Alex Stachowiak +Alexander Shtyrov +Alexandre Conrad +Alexey Popravka +Alexey Popravka +Alli +Ami Fischman +Ananya Maiti +Anatoly Techtonik +Anders Kaseorg +Andreas Lutro +Andrei Geacar +Andrew Gaul +Andrey Bulgakov +Andrés Delfino <34587441+andresdelfino@users.noreply.github.com> +Andrés Delfino +Andy Freeland +Andy Freeland +Andy Kluger +Ani Hayrapetyan +Aniruddha Basak +Anish Tambe +Anrs Hu +Anthony Sottile +Antoine Musso +Anton Ovchinnikov +Anton Patrushev +Antonio Alvarado Hernandez +Antony Lee +Antti Kaihola +Anubhav Patel +Anuj Godase +AQNOUCH Mohammed +AraHaan +Arindam Choudhury +Armin Ronacher +Artem +Ashley Manton +Ashwin Ramaswami +atse +Atsushi Odagiri +Avner Cohen +Baptiste Mispelon +Barney Gale +barneygale +Bartek Ogryczak +Bastian Venthur +Ben Darnell +Ben Hoyt +Ben Rosser +Bence Nagy +Benjamin Peterson +Benjamin VanEvery +Benoit Pierre +Berker Peksag +Bernardo B. Marques +Bernhard M. Wiedemann +Bertil Hatt +Bogdan Opanchuk +BorisZZZ +Brad Erickson +Bradley Ayers +Brandon L. Reiss +Brandt Bucher +Brett Randall +Brian Cristante <33549821+brcrista@users.noreply.github.com> +Brian Cristante +Brian Rosner +BrownTruck +Bruno Oliveira +Bruno Renié +Bstrdsmkr +Buck Golemon +burrows +Bussonnier Matthias +c22 +Caleb Martinez +Calvin Smith +Carl Meyer +Carlos Liam +Carol Willing +Carter Thayer +Cass +Chandrasekhar Atina +Chih-Hsuan Yen +Chih-Hsuan Yen +Chris Brinker +Chris Hunt +Chris Jerdonek +Chris McDonough +Chris Wolfe +Christian Heimes +Christian Oudard +Christopher Hunt +Christopher Snyder +Clark Boylan +Clay McClure +Cody +Cody Soyland +Colin Watson +Connor Osborn +Cooper Lees +Cooper Ry Lees +Cory Benfield +Cory Wright +Craig Kerstiens +Cristian Sorinel +Curtis Doty +cytolentino +Damian Quiroga +Dan Black +Dan Savilonis +Dan Sully +daniel +Daniel Collins +Daniel Hahler +Daniel Holth +Daniel Jost +Daniel Shaulov +Daniele Esposti +Daniele Procida +Danny Hermes +Dav Clark +Dave Abrahams +Dave Jones +David Aguilar +David Black +David Bordeynik +David Bordeynik +David Caro +David Evans +David Linke +David Pursehouse +David Tucker +David Wales +Davidovich +derwolfe +Desetude +Diego Caraballo +DiegoCaraballo +Dmitry Gladkov +Domen Kožar +Donald Stufft +Dongweiming +Douglas Thor +DrFeathers +Dustin Ingram +Dwayne Bailey +Ed Morley <501702+edmorley@users.noreply.github.com> +Ed Morley +Eitan Adler +ekristina +elainechan +Eli Schwartz +Eli Schwartz +Emil Burzo +Emil Styrke +Endoh Takanao +enoch +Erdinc Mutlu +Eric Gillingham +Eric Hanchrow +Eric Hopper +Erik M. Bray +Erik Rose +Ernest W Durbin III +Ernest W. Durbin III +Erwin Janssen +Eugene Vereshchagin +everdimension +Felix Yan +fiber-space +Filip Kokosiński +Florian Briand +Florian Rathgeber +Francesco +Francesco Montesano +Frost Ming +Gabriel Curio +Gabriel de Perthuis +Garry Polley +gdanielson +Geoffrey Lehée +Geoffrey Sneddon +George Song +Georgi Valkov +Giftlin Rajaiah +gizmoguy1 +gkdoc <40815324+gkdoc@users.noreply.github.com> +Gopinath M <31352222+mgopi1990@users.noreply.github.com> +GOTO Hayato <3532528+gh640@users.noreply.github.com> +gpiks +Guilherme Espada +Guy Rozendorn +gzpan123 +Hanjun Kim +Hari Charan +Harsh Vardhan +Herbert Pfennig +Hsiaoming Yang +Hugo +Hugo Lopes Tavares +Hugo van Kemenade +hugovk +Hynek Schlawack +Ian Bicking +Ian Cordasco +Ian Lee +Ian Stapleton Cordasco +Ian Wienand +Ian Wienand +Igor Kuzmitshov +Igor Sobreira +Ilya Baryshev +INADA Naoki +Ionel Cristian Mărieș +Ionel Maries Cristian +Ivan Pozdeev +Jacob Kim +jakirkham +Jakub Stasiak +Jakub Vysoky +Jakub Wilk +James Cleveland +James Cleveland +James Firth +James Polley +Jan Pokorný +Jannis Leidel +jarondl +Jason R. Coombs +Jay Graves +Jean-Christophe Fillion-Robin +Jeff Barber +Jeff Dairiki +Jelmer Vernooij +jenix21 +Jeremy Stanley +Jeremy Zafran +Jiashuo Li +Jim Garrison +Jivan Amara +John Paton +John-Scott Atlakson +johnthagen +johnthagen +Jon Banafato +Jon Dufresne +Jon Parise +Jonas Nockert +Jonathan Herbert +Joost Molenaar +Jorge Niedbalski +Joseph Long +Josh Bronson +Josh Hansen +Josh Schneier +Juanjo Bazán +Julian Berman +Julian Gethmann +Julien Demoor +jwg4 +Jyrki Pulliainen +Kai Chen +Kamal Bin Mustafa +kaustav haldar +keanemind +Keith Maxwell +Kelsey Hightower +Kenneth Belitzky +Kenneth Reitz +Kenneth Reitz +Kevin Burke +Kevin Carter +Kevin Frommelt +Kevin R Patterson +Kexuan Sun +Kit Randel +kpinc +Krishna Oza +Kumar McMillan +Kyle Persohn +lakshmanaram +Laszlo Kiss-Kollar +Laurent Bristiel +Laurie Opperman +Leon Sasson +Lev Givon +Lincoln de Sousa +Lipis +Loren Carvalho +Lucas Cimon +Ludovic Gasc +Luke Macken +Luo Jiebin +luojiebin +luz.paz +László Kiss Kollár +László Kiss Kollár +Marc Abramowitz +Marc Tamlyn +Marcus Smith +Mariatta +Mark Kohler +Mark Williams +Mark Williams +Markus Hametner +Masaki +Masklinn +Matej Stuchlik +Mathew Jennings +Mathieu Bridon +Matt Good +Matt Maker +Matt Robenolt +matthew +Matthew Einhorn +Matthew Gilliard +Matthew Iversen +Matthew Trumbell +Matthew Willson +Matthias Bussonnier +mattip +Maxim Kurnikov +Maxime Rouyrre +mayeut +mbaluna <44498973+mbaluna@users.noreply.github.com> +mdebi <17590103+mdebi@users.noreply.github.com> +memoselyk +Michael +Michael Aquilina +Michael E. Karpeles +Michael Klich +Michael Williamson +michaelpacer +Mickaël Schoentgen +Miguel Araujo Perez +Mihir Singh +Mike +Mike Hendricks +Min RK +MinRK +Miro Hrončok +Monica Baluna +montefra +Monty Taylor +Nate Coraor +Nathaniel J. Smith +Nehal J Wani +Neil Botelho +Nick Coghlan +Nick Stenning +Nick Timkovich +Nicolas Bock +Nikhil Benesch +Nitesh Sharma +Nowell Strite +NtaleGrey +nvdv +Ofekmeister +ofrinevo +Oliver Jeeves +Oliver Tonnhofer +Olivier Girardot +Olivier Grisel +Ollie Rutherfurd +OMOTO Kenji +Omry Yadan +Oren Held +Oscar Benjamin +Oz N Tiram +Pachwenko <32424503+Pachwenko@users.noreply.github.com> +Patrick Dubroy +Patrick Jenkins +Patrick Lawson +patricktokeeffe +Patrik Kopkan +Paul Kehrer +Paul Moore +Paul Nasrat +Paul Oswald +Paul van der Linden +Paulus Schoutsen +Pavithra Eswaramoorthy <33131404+QueenCoffee@users.noreply.github.com> +Pawel Jasinski +Pekka Klärck +Peter Lisák +Peter Waller +petr-tik +Phaneendra Chiruvella +Phil Freo +Phil Pennock +Phil Whelan +Philip Jägenstedt +Philip Molloy +Philippe Ombredanne +Pi Delport +Pierre-Yves Rofes +pip +Prabakaran Kumaresshan +Prabhjyotsing Surjit Singh Sodhi +Prabhu Marappan +Pradyun Gedam +Pratik Mallya +Preet Thakkar +Preston Holmes +Przemek Wrzos +Pulkit Goyal <7895pulkit@gmail.com> +Qiangning Hong +Quentin Pradet +R. David Murray +Rafael Caricio +Ralf Schmitt +Razzi Abuissa +rdb +Remi Rampin +Remi Rampin +Rene Dudfield +Riccardo Magliocchetti +Richard Jones +RobberPhex +Robert Collins +Robert McGibbon +Robert T. McGibbon +robin elisha robinson +Roey Berman +Rohan Jain +Rohan Jain +Rohan Jain +Roman Bogorodskiy +Romuald Brunet +Ronny Pfannschmidt +Rory McCann +Ross Brattain +Roy Wellington Ⅳ +Roy Wellington Ⅳ +Ryan Wooden +ryneeverett +Sachi King +Salvatore Rinchiera +Savio Jomton +schlamar +Scott Kitterman +Sean +seanj +Sebastian Jordan +Sebastian Schaetz +Segev Finer +SeongSoo Cho +Sergey Vasilyev +Seth Woodworth +Shlomi Fish +Shovan Maity +Simeon Visser +Simon Cross +Simon Pichugin +sinoroc +Sorin Sbarnea +Stavros Korokithakis +Stefan Scherfke +Stephan Erb +stepshal +Steve (Gadget) Barnes +Steve Barnes +Steve Dower +Steve Kowalik +Steven Myint +stonebig +Stéphane Bidoul (ACSONE) +Stéphane Bidoul +Stéphane Klein +Sumana Harihareswara +Sviatoslav Sydorenko +Sviatoslav Sydorenko +Swat009 +Takayuki SHIMIZUKAWA +tbeswick +Thijs Triemstra +Thomas Fenzl +Thomas Grainger +Thomas Guettler +Thomas Johansson +Thomas Kluyver +Thomas Smith +Tim D. Smith +Tim Gates +Tim Harder +Tim Heap +tim smith +tinruufu +Tom Forbes +Tom Freudenheim +Tom V +Tomas Orsava +Tomer Chachamu +Tony Beswick +Tony Zhaocheng Tan +TonyBeswick +toonarmycaptain +Toshio Kuratomi +Travis Swicegood +Tzu-ping Chung +Valentin Haenel +Victor Stinner +victorvpaulo +Viktor Szépe +Ville Skyttä +Vinay Sajip +Vincent Philippon +Vinicyus Macedo <7549205+vinicyusmacedo@users.noreply.github.com> +Vitaly Babiy +Vladimir Rutsky +W. Trevor King +Wil Tan +Wilfred Hughes +William ML Leslie +William T Olson +Wilson Mo +wim glenn +Wolfgang Maier +Xavier Fernandez +Xavier Fernandez +xoviat +xtreak +YAMAMOTO Takashi +Yen Chi Hsuan +Yeray Diaz Diaz +Yoval P +Yu Jian +Yuan Jing Vincent Yan +Zearin +Zearin +Zhiping Deng +Zvezdan Petkovic +Łukasz Langa +Семён Марьясин diff --git a/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/INSTALLER b/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/INSTALLER new file mode 100644 index 000000000..a1b589e38 --- /dev/null +++ b/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/LICENSE.txt b/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/LICENSE.txt new file mode 100644 index 000000000..737fec5c5 --- /dev/null +++ b/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/LICENSE.txt @@ -0,0 +1,20 @@ +Copyright (c) 2008-2019 The pip developers (see AUTHORS.txt file) + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +"Software"), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be +included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND +NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE +LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION +OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION +WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/METADATA b/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/METADATA new file mode 100644 index 000000000..49c88b125 --- /dev/null +++ b/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/METADATA @@ -0,0 +1,66 @@ +Metadata-Version: 2.1 +Name: wheel +Version: 0.34.2 +Summary: A built-package format for Python +Home-page: https://github.com/pypa/wheel +Author: Daniel Holth +Author-email: dholth@fastmail.fm +Maintainer: Alex Grönholm +Maintainer-email: alex.gronholm@nextday.fi +License: MIT +Project-URL: Documentation, https://wheel.readthedocs.io/ +Project-URL: Changelog, https://wheel.readthedocs.io/en/stable/news.html +Project-URL: Issue Tracker, https://github.com/pypa/wheel/issues +Keywords: wheel,packaging +Platform: UNKNOWN +Classifier: Development Status :: 5 - Production/Stable +Classifier: Intended Audience :: Developers +Classifier: Topic :: System :: Archiving :: Packaging +Classifier: License :: OSI Approved :: MIT License +Classifier: Programming Language :: Python +Classifier: Programming Language :: Python :: 2 +Classifier: Programming Language :: Python :: 2.7 +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3.5 +Classifier: Programming Language :: Python :: 3.6 +Classifier: Programming Language :: Python :: 3.7 +Classifier: Programming Language :: Python :: 3.8 +Requires-Python: !=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,>=2.7 +Provides-Extra: test +Requires-Dist: pytest-cov ; extra == 'test' +Requires-Dist: pytest (>=3.0.0) ; extra == 'test' + +wheel +===== + +This library is the reference implementation of the Python wheel packaging +standard, as defined in `PEP 427`_. + +It has two different roles: + +#. A setuptools_ extension for building wheels that provides the + ``bdist_wheel`` setuptools command +#. A command line tool for working with wheel files + +It should be noted that wheel is **not** intended to be used as a library, and +as such there is no stable, public API. + +.. _PEP 427: https://www.python.org/dev/peps/pep-0427/ +.. _setuptools: https://pypi.org/project/setuptools/ + +Documentation +------------- + +The documentation_ can be found on Read The Docs. + +.. _documentation: https://wheel.readthedocs.io/ + +Code of Conduct +--------------- + +Everyone interacting in the wheel project's codebases, issue trackers, chat +rooms, and mailing lists is expected to follow the `PyPA Code of Conduct`_. + +.. _PyPA Code of Conduct: https://www.pypa.io/en/latest/code-of-conduct/ + + diff --git a/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/RECORD b/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/RECORD new file mode 100644 index 000000000..dc209df49 --- /dev/null +++ b/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/RECORD @@ -0,0 +1,43 @@ +wheel/__init__.py,sha256=HnvQS9U0JqVi8rcO-9DbcHRmVtnblu7VwdzoKbMiZDQ,23 +wheel/__main__.py,sha256=lF-YLO4hdQmoWuh4eWZd8YL1U95RSdm76sNLBXa0vjE,417 +wheel/_version.py,sha256=KiDEywHVTrXNxe6ojGe-7gEm6gUYge5r_fThX1den7Y,133 +wheel/bdist_wheel.py,sha256=fgVFnJ2cC3MkU5Wy0nNLCzbJoGorSzSrzM9PFq4HWj0,15840 +wheel/macosx_libfile.py,sha256=NhNz1C3zF_78iMUd4ij0le1jVJNnz93tCAICSKXgYvg,11858 +wheel/metadata.py,sha256=siS-hs_DTT0ScpbzloYbQSGYXUDC_Tim10ixcYWSM-4,4517 +wheel/pep425tags.py,sha256=tuXvpyhYJHDcsXHgSRonny1X3kG3TSn7CN9nL9tZUMA,9071 +wheel/pkginfo.py,sha256=GR76kupQzn1x9sKDaXuE6B6FsZ4OkfRtG7pndlXPvQ4,1257 +wheel/util.py,sha256=mnNZkJCi9DHLI_q4lTudoD0mW97h_AoAWl7prNPLXJc,938 +wheel/wheelfile.py,sha256=9lGDJwmpLZqik0P8FB-sHtBteGK96BscgwdtDxi-d6w,7313 +wheel/cli/__init__.py,sha256=GWSoGUpRabTf8bk3FsNTPrc5Fsr8YOv2dX55iY2W7eY,2572 +wheel/cli/convert.py,sha256=7F4vj23A2OghDDWn9gX2V-_TeXMza1a5nIejmFGEUJM,9498 +wheel/cli/pack.py,sha256=S-J1iIy1GPDTTDdn-_SwxGa7N729h4iZNI11EDFCqfA,3208 +wheel/cli/unpack.py,sha256=0VWzT7U_xyenTPwEVavxqvdee93GPvAFHnR3Uu91aRc,673 +wheel-0.34.2.dist-info/AUTHORS.txt,sha256=RtqU9KfonVGhI48DAA4-yTOBUhBtQTjFhaDzHoyh7uU,21518 +wheel-0.34.2.dist-info/LICENSE.txt,sha256=W6Ifuwlk-TatfRU2LR7W1JMcyMj5_y1NkRkOEJvnRDE,1090 +wheel-0.34.2.dist-info/METADATA,sha256=Zh9PzJB14h0gUthWq4ghxft8PJiybKKBjvyikMapY_k,2214 +wheel-0.34.2.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110 +wheel-0.34.2.dist-info/entry_points.txt,sha256=N8HbYFST3yrNQYeB2wXWBEPUhFsEtKNRPaCFGJPyqyc,108 +wheel-0.34.2.dist-info/top_level.txt,sha256=HxSBIbgEstMPe4eFawhA66Mq-QYHMopXVoAncfjb_1c,6 +wheel-0.34.2.dist-info/RECORD,, +wheel-0.34.2.dist-info/INSTALLER,, +../../../bin/wheel,, +wheel/bdist_wheel.cpython-38.pyc,, +wheel-0.34.2.virtualenv,, +wheel/util.cpython-38.pyc,, +wheel/cli/__init__.cpython-38.pyc,, +wheel/wheelfile.cpython-38.pyc,, +wheel/cli/pack.cpython-38.pyc,, +wheel-0.34.2.dist-info/__pycache__,, +../../../bin/wheel3,, +wheel/metadata.cpython-38.pyc,, +wheel/pep425tags.cpython-38.pyc,, +wheel/__init__.cpython-38.pyc,, +wheel/cli/__pycache__,, +wheel/cli/unpack.cpython-38.pyc,, +../../../bin/wheel-3.8,, +wheel/__pycache__,, +wheel/macosx_libfile.cpython-38.pyc,, +wheel/pkginfo.cpython-38.pyc,, +wheel/_version.cpython-38.pyc,, +wheel/__main__.cpython-38.pyc,, +wheel/cli/convert.cpython-38.pyc,, \ No newline at end of file diff --git a/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/WHEEL b/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/WHEEL new file mode 100644 index 000000000..ef99c6cf3 --- /dev/null +++ b/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/WHEEL @@ -0,0 +1,6 @@ +Wheel-Version: 1.0 +Generator: bdist_wheel (0.34.2) +Root-Is-Purelib: true +Tag: py2-none-any +Tag: py3-none-any + diff --git a/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/entry_points.txt b/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/entry_points.txt new file mode 100644 index 000000000..b27acaddf --- /dev/null +++ b/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/entry_points.txt @@ -0,0 +1,6 @@ +[console_scripts] +wheel = wheel.cli:main + +[distutils.commands] +bdist_wheel = wheel.bdist_wheel:bdist_wheel + diff --git a/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/top_level.txt b/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/top_level.txt new file mode 100644 index 000000000..2309722a9 --- /dev/null +++ b/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/top_level.txt @@ -0,0 +1 @@ +wheel diff --git a/venv/lib/python3.8/site-packages/wheel-0.34.2.virtualenv b/venv/lib/python3.8/site-packages/wheel-0.34.2.virtualenv new file mode 100644 index 000000000..e69de29bb diff --git a/venv/lib/python3.8/site-packages/wheel/__init__.py b/venv/lib/python3.8/site-packages/wheel/__init__.py new file mode 100644 index 000000000..3c92ca223 --- /dev/null +++ b/venv/lib/python3.8/site-packages/wheel/__init__.py @@ -0,0 +1 @@ +__version__ = '0.34.2' diff --git a/venv/lib/python3.8/site-packages/wheel/__main__.py b/venv/lib/python3.8/site-packages/wheel/__main__.py new file mode 100644 index 000000000..b3773a20e --- /dev/null +++ b/venv/lib/python3.8/site-packages/wheel/__main__.py @@ -0,0 +1,19 @@ +""" +Wheel command line tool (enable python -m wheel syntax) +""" + +import sys + + +def main(): # needed for console script + if __package__ == '': + # To be able to run 'python wheel-0.9.whl/wheel': + import os.path + path = os.path.dirname(os.path.dirname(__file__)) + sys.path[0:0] = [path] + import wheel.cli + sys.exit(wheel.cli.main()) + + +if __name__ == "__main__": + sys.exit(main()) diff --git a/venv/lib/python3.8/site-packages/wheel/_version.py b/venv/lib/python3.8/site-packages/wheel/_version.py new file mode 100644 index 000000000..5f581f72a --- /dev/null +++ b/venv/lib/python3.8/site-packages/wheel/_version.py @@ -0,0 +1,4 @@ +# coding: utf-8 +# file generated by setuptools_scm +# don't change, don't track in version control +version = '0.33.6.post32+gd3d7a43' diff --git a/venv/lib/python3.8/site-packages/wheel/bdist_wheel.py b/venv/lib/python3.8/site-packages/wheel/bdist_wheel.py new file mode 100644 index 000000000..5cece1f2a --- /dev/null +++ b/venv/lib/python3.8/site-packages/wheel/bdist_wheel.py @@ -0,0 +1,403 @@ +""" +Create a wheel (.whl) distribution. + +A wheel is a built archive format. +""" + +import os +import shutil +import stat +import sys +import re +from collections import OrderedDict +from email.generator import Generator +from distutils.core import Command +from distutils.sysconfig import get_python_version +from distutils import log as logger +from glob import iglob +from shutil import rmtree +from warnings import warn +from zipfile import ZIP_DEFLATED, ZIP_STORED + +import pkg_resources + +from .pep425tags import get_abbr_impl, get_impl_ver, get_abi_tag, get_platform +from .pkginfo import write_pkg_info +from .metadata import pkginfo_to_metadata +from .wheelfile import WheelFile +from . import pep425tags +from . import __version__ as wheel_version + + +safe_name = pkg_resources.safe_name +safe_version = pkg_resources.safe_version + +PY_LIMITED_API_PATTERN = r'cp3\d' + + +def safer_name(name): + return safe_name(name).replace('-', '_') + + +def safer_version(version): + return safe_version(version).replace('-', '_') + + +def remove_readonly(func, path, excinfo): + print(str(excinfo[1])) + os.chmod(path, stat.S_IWRITE) + func(path) + + +class bdist_wheel(Command): + + description = 'create a wheel distribution' + + supported_compressions = OrderedDict([ + ('stored', ZIP_STORED), + ('deflated', ZIP_DEFLATED) + ]) + + user_options = [('bdist-dir=', 'b', + "temporary directory for creating the distribution"), + ('plat-name=', 'p', + "platform name to embed in generated filenames " + "(default: %s)" % get_platform(None)), + ('keep-temp', 'k', + "keep the pseudo-installation tree around after " + + "creating the distribution archive"), + ('dist-dir=', 'd', + "directory to put final built distributions in"), + ('skip-build', None, + "skip rebuilding everything (for testing/debugging)"), + ('relative', None, + "build the archive using relative paths " + "(default: false)"), + ('owner=', 'u', + "Owner name used when creating a tar file" + " [default: current user]"), + ('group=', 'g', + "Group name used when creating a tar file" + " [default: current group]"), + ('universal', None, + "make a universal wheel" + " (default: false)"), + ('compression=', None, + "zipfile compression (one of: {})" + " (default: 'deflated')" + .format(', '.join(supported_compressions))), + ('python-tag=', None, + "Python implementation compatibility tag" + " (default: py%s)" % get_impl_ver()[0]), + ('build-number=', None, + "Build number for this particular version. " + "As specified in PEP-0427, this must start with a digit. " + "[default: None]"), + ('py-limited-api=', None, + "Python tag (cp32|cp33|cpNN) for abi3 wheel tag" + " (default: false)"), + ] + + boolean_options = ['keep-temp', 'skip-build', 'relative', 'universal'] + + def initialize_options(self): + self.bdist_dir = None + self.data_dir = None + self.plat_name = None + self.plat_tag = None + self.format = 'zip' + self.keep_temp = False + self.dist_dir = None + self.egginfo_dir = None + self.root_is_pure = None + self.skip_build = None + self.relative = False + self.owner = None + self.group = None + self.universal = False + self.compression = 'deflated' + self.python_tag = 'py' + get_impl_ver()[0] + self.build_number = None + self.py_limited_api = False + self.plat_name_supplied = False + + def finalize_options(self): + if self.bdist_dir is None: + bdist_base = self.get_finalized_command('bdist').bdist_base + self.bdist_dir = os.path.join(bdist_base, 'wheel') + + self.data_dir = self.wheel_dist_name + '.data' + self.plat_name_supplied = self.plat_name is not None + + try: + self.compression = self.supported_compressions[self.compression] + except KeyError: + raise ValueError('Unsupported compression: {}'.format(self.compression)) + + need_options = ('dist_dir', 'plat_name', 'skip_build') + + self.set_undefined_options('bdist', + *zip(need_options, need_options)) + + self.root_is_pure = not (self.distribution.has_ext_modules() + or self.distribution.has_c_libraries()) + + if self.py_limited_api and not re.match(PY_LIMITED_API_PATTERN, self.py_limited_api): + raise ValueError("py-limited-api must match '%s'" % PY_LIMITED_API_PATTERN) + + # Support legacy [wheel] section for setting universal + wheel = self.distribution.get_option_dict('wheel') + if 'universal' in wheel: + # please don't define this in your global configs + logger.warn('The [wheel] section is deprecated. Use [bdist_wheel] instead.') + val = wheel['universal'][1].strip() + if val.lower() in ('1', 'true', 'yes'): + self.universal = True + + if self.build_number is not None and not self.build_number[:1].isdigit(): + raise ValueError("Build tag (build-number) must start with a digit.") + + @property + def wheel_dist_name(self): + """Return distribution full name with - replaced with _""" + components = (safer_name(self.distribution.get_name()), + safer_version(self.distribution.get_version())) + if self.build_number: + components += (self.build_number,) + return '-'.join(components) + + def get_tag(self): + # bdist sets self.plat_name if unset, we should only use it for purepy + # wheels if the user supplied it. + if self.plat_name_supplied: + plat_name = self.plat_name + elif self.root_is_pure: + plat_name = 'any' + else: + # macosx contains system version in platform name so need special handle + if self.plat_name and not self.plat_name.startswith("macosx"): + plat_name = self.plat_name + else: + plat_name = get_platform(self.bdist_dir) + + if plat_name in ('linux-x86_64', 'linux_x86_64') and sys.maxsize == 2147483647: + plat_name = 'linux_i686' + + plat_name = plat_name.replace('-', '_').replace('.', '_') + + if self.root_is_pure: + if self.universal: + impl = 'py2.py3' + else: + impl = self.python_tag + tag = (impl, 'none', plat_name) + else: + impl_name = get_abbr_impl() + impl_ver = get_impl_ver() + impl = impl_name + impl_ver + # We don't work on CPython 3.1, 3.0. + if self.py_limited_api and (impl_name + impl_ver).startswith('cp3'): + impl = self.py_limited_api + abi_tag = 'abi3' + else: + abi_tag = str(get_abi_tag()).lower() + tag = (impl, abi_tag, plat_name) + supported_tags = pep425tags.get_supported( + self.bdist_dir, + supplied_platform=plat_name if self.plat_name_supplied else None) + # XXX switch to this alternate implementation for non-pure: + if not self.py_limited_api: + assert tag == supported_tags[0], "%s != %s" % (tag, supported_tags[0]) + assert tag in supported_tags, "would build wheel with unsupported tag {}".format(tag) + return tag + + def run(self): + build_scripts = self.reinitialize_command('build_scripts') + build_scripts.executable = 'python' + build_scripts.force = True + + build_ext = self.reinitialize_command('build_ext') + build_ext.inplace = False + + if not self.skip_build: + self.run_command('build') + + install = self.reinitialize_command('install', + reinit_subcommands=True) + install.root = self.bdist_dir + install.compile = False + install.skip_build = self.skip_build + install.warn_dir = False + + # A wheel without setuptools scripts is more cross-platform. + # Use the (undocumented) `no_ep` option to setuptools' + # install_scripts command to avoid creating entry point scripts. + install_scripts = self.reinitialize_command('install_scripts') + install_scripts.no_ep = True + + # Use a custom scheme for the archive, because we have to decide + # at installation time which scheme to use. + for key in ('headers', 'scripts', 'data', 'purelib', 'platlib'): + setattr(install, + 'install_' + key, + os.path.join(self.data_dir, key)) + + basedir_observed = '' + + if os.name == 'nt': + # win32 barfs if any of these are ''; could be '.'? + # (distutils.command.install:change_roots bug) + basedir_observed = os.path.normpath(os.path.join(self.data_dir, '..')) + self.install_libbase = self.install_lib = basedir_observed + + setattr(install, + 'install_purelib' if self.root_is_pure else 'install_platlib', + basedir_observed) + + logger.info("installing to %s", self.bdist_dir) + + self.run_command('install') + + impl_tag, abi_tag, plat_tag = self.get_tag() + archive_basename = "{}-{}-{}-{}".format(self.wheel_dist_name, impl_tag, abi_tag, plat_tag) + if not self.relative: + archive_root = self.bdist_dir + else: + archive_root = os.path.join( + self.bdist_dir, + self._ensure_relative(install.install_base)) + + self.set_undefined_options('install_egg_info', ('target', 'egginfo_dir')) + distinfo_dirname = '{}-{}.dist-info'.format( + safer_name(self.distribution.get_name()), + safer_version(self.distribution.get_version())) + distinfo_dir = os.path.join(self.bdist_dir, distinfo_dirname) + self.egg2dist(self.egginfo_dir, distinfo_dir) + + self.write_wheelfile(distinfo_dir) + + # Make the archive + if not os.path.exists(self.dist_dir): + os.makedirs(self.dist_dir) + + wheel_path = os.path.join(self.dist_dir, archive_basename + '.whl') + with WheelFile(wheel_path, 'w', self.compression) as wf: + wf.write_files(archive_root) + + # Add to 'Distribution.dist_files' so that the "upload" command works + getattr(self.distribution, 'dist_files', []).append( + ('bdist_wheel', get_python_version(), wheel_path)) + + if not self.keep_temp: + logger.info('removing %s', self.bdist_dir) + if not self.dry_run: + rmtree(self.bdist_dir, onerror=remove_readonly) + + def write_wheelfile(self, wheelfile_base, generator='bdist_wheel (' + wheel_version + ')'): + from email.message import Message + msg = Message() + msg['Wheel-Version'] = '1.0' # of the spec + msg['Generator'] = generator + msg['Root-Is-Purelib'] = str(self.root_is_pure).lower() + if self.build_number is not None: + msg['Build'] = self.build_number + + # Doesn't work for bdist_wininst + impl_tag, abi_tag, plat_tag = self.get_tag() + for impl in impl_tag.split('.'): + for abi in abi_tag.split('.'): + for plat in plat_tag.split('.'): + msg['Tag'] = '-'.join((impl, abi, plat)) + + wheelfile_path = os.path.join(wheelfile_base, 'WHEEL') + logger.info('creating %s', wheelfile_path) + with open(wheelfile_path, 'w') as f: + Generator(f, maxheaderlen=0).flatten(msg) + + def _ensure_relative(self, path): + # copied from dir_util, deleted + drive, path = os.path.splitdrive(path) + if path[0:1] == os.sep: + path = drive + path[1:] + return path + + @property + def license_paths(self): + metadata = self.distribution.get_option_dict('metadata') + files = set() + patterns = sorted({ + option for option in metadata.get('license_files', ('', ''))[1].split() + }) + + if 'license_file' in metadata: + warn('The "license_file" option is deprecated. Use "license_files" instead.', + DeprecationWarning) + files.add(metadata['license_file'][1]) + + if 'license_file' not in metadata and 'license_files' not in metadata: + patterns = ('LICEN[CS]E*', 'COPYING*', 'NOTICE*', 'AUTHORS*') + + for pattern in patterns: + for path in iglob(pattern): + if path not in files and os.path.isfile(path): + logger.info('adding license file "%s" (matched pattern "%s")', path, pattern) + files.add(path) + + return files + + def egg2dist(self, egginfo_path, distinfo_path): + """Convert an .egg-info directory into a .dist-info directory""" + def adios(p): + """Appropriately delete directory, file or link.""" + if os.path.exists(p) and not os.path.islink(p) and os.path.isdir(p): + shutil.rmtree(p) + elif os.path.exists(p): + os.unlink(p) + + adios(distinfo_path) + + if not os.path.exists(egginfo_path): + # There is no egg-info. This is probably because the egg-info + # file/directory is not named matching the distribution name used + # to name the archive file. Check for this case and report + # accordingly. + import glob + pat = os.path.join(os.path.dirname(egginfo_path), '*.egg-info') + possible = glob.glob(pat) + err = "Egg metadata expected at %s but not found" % (egginfo_path,) + if possible: + alt = os.path.basename(possible[0]) + err += " (%s found - possible misnamed archive file?)" % (alt,) + + raise ValueError(err) + + if os.path.isfile(egginfo_path): + # .egg-info is a single file + pkginfo_path = egginfo_path + pkg_info = pkginfo_to_metadata(egginfo_path, egginfo_path) + os.mkdir(distinfo_path) + else: + # .egg-info is a directory + pkginfo_path = os.path.join(egginfo_path, 'PKG-INFO') + pkg_info = pkginfo_to_metadata(egginfo_path, pkginfo_path) + + # ignore common egg metadata that is useless to wheel + shutil.copytree(egginfo_path, distinfo_path, + ignore=lambda x, y: {'PKG-INFO', 'requires.txt', 'SOURCES.txt', + 'not-zip-safe'} + ) + + # delete dependency_links if it is only whitespace + dependency_links_path = os.path.join(distinfo_path, 'dependency_links.txt') + with open(dependency_links_path, 'r') as dependency_links_file: + dependency_links = dependency_links_file.read().strip() + if not dependency_links: + adios(dependency_links_path) + + write_pkg_info(os.path.join(distinfo_path, 'METADATA'), pkg_info) + + for license_path in self.license_paths: + filename = os.path.basename(license_path) + shutil.copy(license_path, os.path.join(distinfo_path, filename)) + + adios(egginfo_path) diff --git a/venv/lib/python3.8/site-packages/wheel/cli/__init__.py b/venv/lib/python3.8/site-packages/wheel/cli/__init__.py new file mode 100644 index 000000000..95740bfb6 --- /dev/null +++ b/venv/lib/python3.8/site-packages/wheel/cli/__init__.py @@ -0,0 +1,88 @@ +""" +Wheel command-line utility. +""" + +from __future__ import print_function + +import argparse +import os +import sys + + +def require_pkgresources(name): + try: + import pkg_resources # noqa: F401 + except ImportError: + raise RuntimeError("'{0}' needs pkg_resources (part of setuptools).".format(name)) + + +class WheelError(Exception): + pass + + +def unpack_f(args): + from .unpack import unpack + unpack(args.wheelfile, args.dest) + + +def pack_f(args): + from .pack import pack + pack(args.directory, args.dest_dir, args.build_number) + + +def convert_f(args): + from .convert import convert + convert(args.files, args.dest_dir, args.verbose) + + +def version_f(args): + from .. import __version__ + print("wheel %s" % __version__) + + +def parser(): + p = argparse.ArgumentParser() + s = p.add_subparsers(help="commands") + + unpack_parser = s.add_parser('unpack', help='Unpack wheel') + unpack_parser.add_argument('--dest', '-d', help='Destination directory', + default='.') + unpack_parser.add_argument('wheelfile', help='Wheel file') + unpack_parser.set_defaults(func=unpack_f) + + repack_parser = s.add_parser('pack', help='Repack wheel') + repack_parser.add_argument('directory', help='Root directory of the unpacked wheel') + repack_parser.add_argument('--dest-dir', '-d', default=os.path.curdir, + help="Directory to store the wheel (default %(default)s)") + repack_parser.add_argument('--build-number', help="Build tag to use in the wheel name") + repack_parser.set_defaults(func=pack_f) + + convert_parser = s.add_parser('convert', help='Convert egg or wininst to wheel') + convert_parser.add_argument('files', nargs='*', help='Files to convert') + convert_parser.add_argument('--dest-dir', '-d', default=os.path.curdir, + help="Directory to store wheels (default %(default)s)") + convert_parser.add_argument('--verbose', '-v', action='store_true') + convert_parser.set_defaults(func=convert_f) + + version_parser = s.add_parser('version', help='Print version and exit') + version_parser.set_defaults(func=version_f) + + help_parser = s.add_parser('help', help='Show this help') + help_parser.set_defaults(func=lambda args: p.print_help()) + + return p + + +def main(): + p = parser() + args = p.parse_args() + if not hasattr(args, 'func'): + p.print_help() + else: + try: + args.func(args) + return 0 + except WheelError as e: + print(e, file=sys.stderr) + + return 1 diff --git a/venv/lib/python3.8/site-packages/wheel/cli/convert.py b/venv/lib/python3.8/site-packages/wheel/cli/convert.py new file mode 100644 index 000000000..154f1b1e2 --- /dev/null +++ b/venv/lib/python3.8/site-packages/wheel/cli/convert.py @@ -0,0 +1,269 @@ +import os.path +import re +import shutil +import sys +import tempfile +import zipfile +from distutils import dist +from glob import iglob + +from ..bdist_wheel import bdist_wheel +from ..wheelfile import WheelFile +from . import WheelError, require_pkgresources + +egg_info_re = re.compile(r''' + (?P.+?)-(?P.+?) + (-(?Ppy\d\.\d+) + (-(?P.+?))? + )?.egg$''', re.VERBOSE) + + +class _bdist_wheel_tag(bdist_wheel): + # allow the client to override the default generated wheel tag + # The default bdist_wheel implementation uses python and abi tags + # of the running python process. This is not suitable for + # generating/repackaging prebuild binaries. + + full_tag_supplied = False + full_tag = None # None or a (pytag, soabitag, plattag) triple + + def get_tag(self): + if self.full_tag_supplied and self.full_tag is not None: + return self.full_tag + else: + return bdist_wheel.get_tag(self) + + +def egg2wheel(egg_path, dest_dir): + filename = os.path.basename(egg_path) + match = egg_info_re.match(filename) + if not match: + raise WheelError('Invalid egg file name: {}'.format(filename)) + + egg_info = match.groupdict() + dir = tempfile.mkdtemp(suffix="_e2w") + if os.path.isfile(egg_path): + # assume we have a bdist_egg otherwise + with zipfile.ZipFile(egg_path) as egg: + egg.extractall(dir) + else: + # support buildout-style installed eggs directories + for pth in os.listdir(egg_path): + src = os.path.join(egg_path, pth) + if os.path.isfile(src): + shutil.copy2(src, dir) + else: + shutil.copytree(src, os.path.join(dir, pth)) + + pyver = egg_info['pyver'] + if pyver: + pyver = egg_info['pyver'] = pyver.replace('.', '') + + arch = (egg_info['arch'] or 'any').replace('.', '_').replace('-', '_') + + # assume all binary eggs are for CPython + abi = 'cp' + pyver[2:] if arch != 'any' else 'none' + + root_is_purelib = egg_info['arch'] is None + if root_is_purelib: + bw = bdist_wheel(dist.Distribution()) + else: + bw = _bdist_wheel_tag(dist.Distribution()) + + bw.root_is_pure = root_is_purelib + bw.python_tag = pyver + bw.plat_name_supplied = True + bw.plat_name = egg_info['arch'] or 'any' + if not root_is_purelib: + bw.full_tag_supplied = True + bw.full_tag = (pyver, abi, arch) + + dist_info_dir = os.path.join(dir, '{name}-{ver}.dist-info'.format(**egg_info)) + bw.egg2dist(os.path.join(dir, 'EGG-INFO'), dist_info_dir) + bw.write_wheelfile(dist_info_dir, generator='egg2wheel') + wheel_name = '{name}-{ver}-{pyver}-{}-{}.whl'.format(abi, arch, **egg_info) + with WheelFile(os.path.join(dest_dir, wheel_name), 'w') as wf: + wf.write_files(dir) + + shutil.rmtree(dir) + + +def parse_wininst_info(wininfo_name, egginfo_name): + """Extract metadata from filenames. + + Extracts the 4 metadataitems needed (name, version, pyversion, arch) from + the installer filename and the name of the egg-info directory embedded in + the zipfile (if any). + + The egginfo filename has the format:: + + name-ver(-pyver)(-arch).egg-info + + The installer filename has the format:: + + name-ver.arch(-pyver).exe + + Some things to note: + + 1. The installer filename is not definitive. An installer can be renamed + and work perfectly well as an installer. So more reliable data should + be used whenever possible. + 2. The egg-info data should be preferred for the name and version, because + these come straight from the distutils metadata, and are mandatory. + 3. The pyver from the egg-info data should be ignored, as it is + constructed from the version of Python used to build the installer, + which is irrelevant - the installer filename is correct here (even to + the point that when it's not there, any version is implied). + 4. The architecture must be taken from the installer filename, as it is + not included in the egg-info data. + 5. Architecture-neutral installers still have an architecture because the + installer format itself (being executable) is architecture-specific. We + should therefore ignore the architecture if the content is pure-python. + """ + + egginfo = None + if egginfo_name: + egginfo = egg_info_re.search(egginfo_name) + if not egginfo: + raise ValueError("Egg info filename %s is not valid" % (egginfo_name,)) + + # Parse the wininst filename + # 1. Distribution name (up to the first '-') + w_name, sep, rest = wininfo_name.partition('-') + if not sep: + raise ValueError("Installer filename %s is not valid" % (wininfo_name,)) + + # Strip '.exe' + rest = rest[:-4] + # 2. Python version (from the last '-', must start with 'py') + rest2, sep, w_pyver = rest.rpartition('-') + if sep and w_pyver.startswith('py'): + rest = rest2 + w_pyver = w_pyver.replace('.', '') + else: + # Not version specific - use py2.py3. While it is possible that + # pure-Python code is not compatible with both Python 2 and 3, there + # is no way of knowing from the wininst format, so we assume the best + # here (the user can always manually rename the wheel to be more + # restrictive if needed). + w_pyver = 'py2.py3' + # 3. Version and architecture + w_ver, sep, w_arch = rest.rpartition('.') + if not sep: + raise ValueError("Installer filename %s is not valid" % (wininfo_name,)) + + if egginfo: + w_name = egginfo.group('name') + w_ver = egginfo.group('ver') + + return {'name': w_name, 'ver': w_ver, 'arch': w_arch, 'pyver': w_pyver} + + +def wininst2wheel(path, dest_dir): + with zipfile.ZipFile(path) as bdw: + # Search for egg-info in the archive + egginfo_name = None + for filename in bdw.namelist(): + if '.egg-info' in filename: + egginfo_name = filename + break + + info = parse_wininst_info(os.path.basename(path), egginfo_name) + + root_is_purelib = True + for zipinfo in bdw.infolist(): + if zipinfo.filename.startswith('PLATLIB'): + root_is_purelib = False + break + if root_is_purelib: + paths = {'purelib': ''} + else: + paths = {'platlib': ''} + + dist_info = "%(name)s-%(ver)s" % info + datadir = "%s.data/" % dist_info + + # rewrite paths to trick ZipFile into extracting an egg + # XXX grab wininst .ini - between .exe, padding, and first zip file. + members = [] + egginfo_name = '' + for zipinfo in bdw.infolist(): + key, basename = zipinfo.filename.split('/', 1) + key = key.lower() + basepath = paths.get(key, None) + if basepath is None: + basepath = datadir + key.lower() + '/' + oldname = zipinfo.filename + newname = basepath + basename + zipinfo.filename = newname + del bdw.NameToInfo[oldname] + bdw.NameToInfo[newname] = zipinfo + # Collect member names, but omit '' (from an entry like "PLATLIB/" + if newname: + members.append(newname) + # Remember egg-info name for the egg2dist call below + if not egginfo_name: + if newname.endswith('.egg-info'): + egginfo_name = newname + elif '.egg-info/' in newname: + egginfo_name, sep, _ = newname.rpartition('/') + dir = tempfile.mkdtemp(suffix="_b2w") + bdw.extractall(dir, members) + + # egg2wheel + abi = 'none' + pyver = info['pyver'] + arch = (info['arch'] or 'any').replace('.', '_').replace('-', '_') + # Wininst installers always have arch even if they are not + # architecture-specific (because the format itself is). + # So, assume the content is architecture-neutral if root is purelib. + if root_is_purelib: + arch = 'any' + # If the installer is architecture-specific, it's almost certainly also + # CPython-specific. + if arch != 'any': + pyver = pyver.replace('py', 'cp') + wheel_name = '-'.join((dist_info, pyver, abi, arch)) + if root_is_purelib: + bw = bdist_wheel(dist.Distribution()) + else: + bw = _bdist_wheel_tag(dist.Distribution()) + + bw.root_is_pure = root_is_purelib + bw.python_tag = pyver + bw.plat_name_supplied = True + bw.plat_name = info['arch'] or 'any' + + if not root_is_purelib: + bw.full_tag_supplied = True + bw.full_tag = (pyver, abi, arch) + + dist_info_dir = os.path.join(dir, '%s.dist-info' % dist_info) + bw.egg2dist(os.path.join(dir, egginfo_name), dist_info_dir) + bw.write_wheelfile(dist_info_dir, generator='wininst2wheel') + + wheel_path = os.path.join(dest_dir, wheel_name) + with WheelFile(wheel_path, 'w') as wf: + wf.write_files(dir) + + shutil.rmtree(dir) + + +def convert(files, dest_dir, verbose): + # Only support wheel convert if pkg_resources is present + require_pkgresources('wheel convert') + + for pat in files: + for installer in iglob(pat): + if os.path.splitext(installer)[1] == '.egg': + conv = egg2wheel + else: + conv = wininst2wheel + + if verbose: + print("{}... ".format(installer)) + sys.stdout.flush() + + conv(installer, dest_dir) + if verbose: + print("OK") diff --git a/venv/lib/python3.8/site-packages/wheel/cli/pack.py b/venv/lib/python3.8/site-packages/wheel/cli/pack.py new file mode 100644 index 000000000..1e77fdbd2 --- /dev/null +++ b/venv/lib/python3.8/site-packages/wheel/cli/pack.py @@ -0,0 +1,79 @@ +from __future__ import print_function + +import os.path +import re +import sys + +from wheel.cli import WheelError +from wheel.wheelfile import WheelFile + +DIST_INFO_RE = re.compile(r"^(?P(?P.+?)-(?P\d.*?))\.dist-info$") +BUILD_NUM_RE = re.compile(br'Build: (\d\w*)$') + + +def pack(directory, dest_dir, build_number): + """Repack a previously unpacked wheel directory into a new wheel file. + + The .dist-info/WHEEL file must contain one or more tags so that the target + wheel file name can be determined. + + :param directory: The unpacked wheel directory + :param dest_dir: Destination directory (defaults to the current directory) + """ + # Find the .dist-info directory + dist_info_dirs = [fn for fn in os.listdir(directory) + if os.path.isdir(os.path.join(directory, fn)) and DIST_INFO_RE.match(fn)] + if len(dist_info_dirs) > 1: + raise WheelError('Multiple .dist-info directories found in {}'.format(directory)) + elif not dist_info_dirs: + raise WheelError('No .dist-info directories found in {}'.format(directory)) + + # Determine the target wheel filename + dist_info_dir = dist_info_dirs[0] + name_version = DIST_INFO_RE.match(dist_info_dir).group('namever') + + # Read the tags and the existing build number from .dist-info/WHEEL + existing_build_number = None + wheel_file_path = os.path.join(directory, dist_info_dir, 'WHEEL') + with open(wheel_file_path) as f: + tags = [] + for line in f: + if line.startswith('Tag: '): + tags.append(line.split(' ')[1].rstrip()) + elif line.startswith('Build: '): + existing_build_number = line.split(' ')[1].rstrip() + + if not tags: + raise WheelError('No tags present in {}/WHEEL; cannot determine target wheel filename' + .format(dist_info_dir)) + + # Set the wheel file name and add/replace/remove the Build tag in .dist-info/WHEEL + build_number = build_number if build_number is not None else existing_build_number + if build_number is not None: + if build_number: + name_version += '-' + build_number + + if build_number != existing_build_number: + replacement = ('Build: %s\r\n' % build_number).encode('ascii') if build_number else b'' + with open(wheel_file_path, 'rb+') as f: + wheel_file_content = f.read() + if not BUILD_NUM_RE.subn(replacement, wheel_file_content)[1]: + wheel_file_content += replacement + + f.truncate() + f.write(wheel_file_content) + + # Reassemble the tags for the wheel file + impls = sorted({tag.split('-')[0] for tag in tags}) + abivers = sorted({tag.split('-')[1] for tag in tags}) + platforms = sorted({tag.split('-')[2] for tag in tags}) + tagline = '-'.join(['.'.join(impls), '.'.join(abivers), '.'.join(platforms)]) + + # Repack the wheel + wheel_path = os.path.join(dest_dir, '{}-{}.whl'.format(name_version, tagline)) + with WheelFile(wheel_path, 'w') as wf: + print("Repacking wheel as {}...".format(wheel_path), end='') + sys.stdout.flush() + wf.write_files(directory) + + print('OK') diff --git a/venv/lib/python3.8/site-packages/wheel/cli/unpack.py b/venv/lib/python3.8/site-packages/wheel/cli/unpack.py new file mode 100644 index 000000000..2e9857a35 --- /dev/null +++ b/venv/lib/python3.8/site-packages/wheel/cli/unpack.py @@ -0,0 +1,25 @@ +from __future__ import print_function + +import os.path +import sys + +from ..wheelfile import WheelFile + + +def unpack(path, dest='.'): + """Unpack a wheel. + + Wheel content will be unpacked to {dest}/{name}-{ver}, where {name} + is the package name and {ver} its version. + + :param path: The path to the wheel. + :param dest: Destination directory (default to current directory). + """ + with WheelFile(path) as wf: + namever = wf.parsed_filename.group('namever') + destination = os.path.join(dest, namever) + print("Unpacking to: {}...".format(destination), end='') + sys.stdout.flush() + wf.extractall(destination) + + print('OK') diff --git a/venv/lib/python3.8/site-packages/wheel/macosx_libfile.py b/venv/lib/python3.8/site-packages/wheel/macosx_libfile.py new file mode 100644 index 000000000..a90368867 --- /dev/null +++ b/venv/lib/python3.8/site-packages/wheel/macosx_libfile.py @@ -0,0 +1,341 @@ +""" +This module contains function to analyse dynamic library +headers to extract system information + +Currently only for MacOSX + +Library file on macosx system starts with Mach-O or Fat field. +This can be distinguish by first 32 bites and it is called magic number. +Proper value of magic number is with suffix _MAGIC. Suffix _CIGAM means +reversed bytes order. +Both fields can occur in two types: 32 and 64 bytes. + +FAT field inform that this library contains few version of library +(typically for different types version). It contains +information where Mach-O headers starts. + +Each section started with Mach-O header contains one library +(So if file starts with this field it contains only one version). + +After filed Mach-O there are section fields. +Each of them starts with two fields: +cmd - magic number for this command +cmdsize - total size occupied by this section information. + +In this case only sections LC_VERSION_MIN_MACOSX (for macosx 10.13 and earlier) +and LC_BUILD_VERSION (for macosx 10.14 and newer) are interesting, +because them contains information about minimal system version. + +Important remarks: +- For fat files this implementation looks for maximum number version. + It not check if it is 32 or 64 and do not compare it with currently builded package. + So it is possible to false report higher version that needed. +- All structures signatures are taken form macosx header files. +- I think that binary format will be more stable than `otool` output. + and if apple introduce some changes both implementation will need to be updated. +""" + +import ctypes +import sys + +"""here the needed const and struct from mach-o header files""" + +FAT_MAGIC = 0xcafebabe +FAT_CIGAM = 0xbebafeca +FAT_MAGIC_64 = 0xcafebabf +FAT_CIGAM_64 = 0xbfbafeca +MH_MAGIC = 0xfeedface +MH_CIGAM = 0xcefaedfe +MH_MAGIC_64 = 0xfeedfacf +MH_CIGAM_64 = 0xcffaedfe + +LC_VERSION_MIN_MACOSX = 0x24 +LC_BUILD_VERSION = 0x32 + + +mach_header_fields = [ + ("magic", ctypes.c_uint32), ("cputype", ctypes.c_int), + ("cpusubtype", ctypes.c_int), ("filetype", ctypes.c_uint32), + ("ncmds", ctypes.c_uint32), ("sizeofcmds", ctypes.c_uint32), + ("flags", ctypes.c_uint32) + ] +""" +struct mach_header { + uint32_t magic; /* mach magic number identifier */ + cpu_type_t cputype; /* cpu specifier */ + cpu_subtype_t cpusubtype; /* machine specifier */ + uint32_t filetype; /* type of file */ + uint32_t ncmds; /* number of load commands */ + uint32_t sizeofcmds; /* the size of all the load commands */ + uint32_t flags; /* flags */ +}; +typedef integer_t cpu_type_t; +typedef integer_t cpu_subtype_t; +""" + +mach_header_fields_64 = mach_header_fields + [("reserved", ctypes.c_uint32)] +""" +struct mach_header_64 { + uint32_t magic; /* mach magic number identifier */ + cpu_type_t cputype; /* cpu specifier */ + cpu_subtype_t cpusubtype; /* machine specifier */ + uint32_t filetype; /* type of file */ + uint32_t ncmds; /* number of load commands */ + uint32_t sizeofcmds; /* the size of all the load commands */ + uint32_t flags; /* flags */ + uint32_t reserved; /* reserved */ +}; +""" + +fat_header_fields = [("magic", ctypes.c_uint32), ("nfat_arch", ctypes.c_uint32)] +""" +struct fat_header { + uint32_t magic; /* FAT_MAGIC or FAT_MAGIC_64 */ + uint32_t nfat_arch; /* number of structs that follow */ +}; +""" + +fat_arch_fields = [ + ("cputype", ctypes.c_int), ("cpusubtype", ctypes.c_int), + ("offset", ctypes.c_uint32), ("size", ctypes.c_uint32), + ("align", ctypes.c_uint32) +] +""" +struct fat_arch { + cpu_type_t cputype; /* cpu specifier (int) */ + cpu_subtype_t cpusubtype; /* machine specifier (int) */ + uint32_t offset; /* file offset to this object file */ + uint32_t size; /* size of this object file */ + uint32_t align; /* alignment as a power of 2 */ +}; +""" + +fat_arch_64_fields = [ + ("cputype", ctypes.c_int), ("cpusubtype", ctypes.c_int), + ("offset", ctypes.c_uint64), ("size", ctypes.c_uint64), + ("align", ctypes.c_uint32), ("reserved", ctypes.c_uint32) +] +""" +struct fat_arch_64 { + cpu_type_t cputype; /* cpu specifier (int) */ + cpu_subtype_t cpusubtype; /* machine specifier (int) */ + uint64_t offset; /* file offset to this object file */ + uint64_t size; /* size of this object file */ + uint32_t align; /* alignment as a power of 2 */ + uint32_t reserved; /* reserved */ +}; +""" + +segment_base_fields = [("cmd", ctypes.c_uint32), ("cmdsize", ctypes.c_uint32)] +"""base for reading segment info""" + +segment_command_fields = [ + ("cmd", ctypes.c_uint32), ("cmdsize", ctypes.c_uint32), + ("segname", ctypes.c_char * 16), ("vmaddr", ctypes.c_uint32), + ("vmsize", ctypes.c_uint32), ("fileoff", ctypes.c_uint32), + ("filesize", ctypes.c_uint32), ("maxprot", ctypes.c_int), + ("initprot", ctypes.c_int), ("nsects", ctypes.c_uint32), + ("flags", ctypes.c_uint32), + ] +""" +struct segment_command { /* for 32-bit architectures */ + uint32_t cmd; /* LC_SEGMENT */ + uint32_t cmdsize; /* includes sizeof section structs */ + char segname[16]; /* segment name */ + uint32_t vmaddr; /* memory address of this segment */ + uint32_t vmsize; /* memory size of this segment */ + uint32_t fileoff; /* file offset of this segment */ + uint32_t filesize; /* amount to map from the file */ + vm_prot_t maxprot; /* maximum VM protection */ + vm_prot_t initprot; /* initial VM protection */ + uint32_t nsects; /* number of sections in segment */ + uint32_t flags; /* flags */ +}; +typedef int vm_prot_t; +""" + +segment_command_fields_64 = [ + ("cmd", ctypes.c_uint32), ("cmdsize", ctypes.c_uint32), + ("segname", ctypes.c_char * 16), ("vmaddr", ctypes.c_uint64), + ("vmsize", ctypes.c_uint64), ("fileoff", ctypes.c_uint64), + ("filesize", ctypes.c_uint64), ("maxprot", ctypes.c_int), + ("initprot", ctypes.c_int), ("nsects", ctypes.c_uint32), + ("flags", ctypes.c_uint32), + ] +""" +struct segment_command_64 { /* for 64-bit architectures */ + uint32_t cmd; /* LC_SEGMENT_64 */ + uint32_t cmdsize; /* includes sizeof section_64 structs */ + char segname[16]; /* segment name */ + uint64_t vmaddr; /* memory address of this segment */ + uint64_t vmsize; /* memory size of this segment */ + uint64_t fileoff; /* file offset of this segment */ + uint64_t filesize; /* amount to map from the file */ + vm_prot_t maxprot; /* maximum VM protection */ + vm_prot_t initprot; /* initial VM protection */ + uint32_t nsects; /* number of sections in segment */ + uint32_t flags; /* flags */ +}; +""" + +version_min_command_fields = segment_base_fields + \ + [("version", ctypes.c_uint32), ("sdk", ctypes.c_uint32)] +""" +struct version_min_command { + uint32_t cmd; /* LC_VERSION_MIN_MACOSX or + LC_VERSION_MIN_IPHONEOS or + LC_VERSION_MIN_WATCHOS or + LC_VERSION_MIN_TVOS */ + uint32_t cmdsize; /* sizeof(struct min_version_command) */ + uint32_t version; /* X.Y.Z is encoded in nibbles xxxx.yy.zz */ + uint32_t sdk; /* X.Y.Z is encoded in nibbles xxxx.yy.zz */ +}; +""" + +build_version_command_fields = segment_base_fields + \ + [("platform", ctypes.c_uint32), ("minos", ctypes.c_uint32), + ("sdk", ctypes.c_uint32), ("ntools", ctypes.c_uint32)] +""" +struct build_version_command { + uint32_t cmd; /* LC_BUILD_VERSION */ + uint32_t cmdsize; /* sizeof(struct build_version_command) plus */ + /* ntools * sizeof(struct build_tool_version) */ + uint32_t platform; /* platform */ + uint32_t minos; /* X.Y.Z is encoded in nibbles xxxx.yy.zz */ + uint32_t sdk; /* X.Y.Z is encoded in nibbles xxxx.yy.zz */ + uint32_t ntools; /* number of tool entries following this */ +}; +""" + + +def swap32(x): + return (((x << 24) & 0xFF000000) | + ((x << 8) & 0x00FF0000) | + ((x >> 8) & 0x0000FF00) | + ((x >> 24) & 0x000000FF)) + + +def get_base_class_and_magic_number(lib_file, seek=None): + if seek is None: + seek = lib_file.tell() + else: + lib_file.seek(seek) + magic_number = ctypes.c_uint32.from_buffer_copy( + lib_file.read(ctypes.sizeof(ctypes.c_uint32))).value + + # Handle wrong byte order + if magic_number in [FAT_CIGAM, FAT_CIGAM_64, MH_CIGAM, MH_CIGAM_64]: + if sys.byteorder == "little": + BaseClass = ctypes.BigEndianStructure + else: + BaseClass = ctypes.LittleEndianStructure + + magic_number = swap32(magic_number) + else: + BaseClass = ctypes.Structure + + lib_file.seek(seek) + return BaseClass, magic_number + + +def read_data(struct_class, lib_file): + return struct_class.from_buffer_copy(lib_file.read( + ctypes.sizeof(struct_class))) + + +def extract_macosx_min_system_version(path_to_lib): + with open(path_to_lib, "rb") as lib_file: + BaseClass, magic_number = get_base_class_and_magic_number(lib_file, 0) + if magic_number not in [FAT_MAGIC, FAT_MAGIC_64, MH_MAGIC, MH_MAGIC_64]: + return + + if magic_number in [FAT_MAGIC, FAT_CIGAM_64]: + class FatHeader(BaseClass): + _fields_ = fat_header_fields + + fat_header = read_data(FatHeader, lib_file) + if magic_number == FAT_MAGIC: + + class FatArch(BaseClass): + _fields_ = fat_arch_fields + else: + + class FatArch(BaseClass): + _fields_ = fat_arch_64_fields + + fat_arch_list = [read_data(FatArch, lib_file) for _ in range(fat_header.nfat_arch)] + + versions_list = [] + for el in fat_arch_list: + try: + version = read_mach_header(lib_file, el.offset) + if version is not None: + versions_list.append(version) + except ValueError: + pass + + if len(versions_list) > 0: + return max(versions_list) + else: + return None + + else: + try: + return read_mach_header(lib_file, 0) + except ValueError: + """when some error during read library files""" + return None + + +def read_mach_header(lib_file, seek=None): + """ + This funcition parse mach-O header and extract + information about minimal system version + + :param lib_file: reference to opened library file with pointer + """ + if seek is not None: + lib_file.seek(seek) + base_class, magic_number = get_base_class_and_magic_number(lib_file) + arch = "32" if magic_number == MH_MAGIC else "64" + + class SegmentBase(base_class): + _fields_ = segment_base_fields + + if arch == "32": + + class MachHeader(base_class): + _fields_ = mach_header_fields + + else: + + class MachHeader(base_class): + _fields_ = mach_header_fields_64 + + mach_header = read_data(MachHeader, lib_file) + for _i in range(mach_header.ncmds): + pos = lib_file.tell() + segment_base = read_data(SegmentBase, lib_file) + lib_file.seek(pos) + if segment_base.cmd == LC_VERSION_MIN_MACOSX: + class VersionMinCommand(base_class): + _fields_ = version_min_command_fields + + version_info = read_data(VersionMinCommand, lib_file) + return parse_version(version_info.version) + elif segment_base.cmd == LC_BUILD_VERSION: + class VersionBuild(base_class): + _fields_ = build_version_command_fields + + version_info = read_data(VersionBuild, lib_file) + return parse_version(version_info.minos) + else: + lib_file.seek(pos + segment_base.cmdsize) + continue + + +def parse_version(version): + x = (version & 0xffff0000) >> 16 + y = (version & 0x0000ff00) >> 8 + z = (version & 0x000000ff) + return x, y, z diff --git a/venv/lib/python3.8/site-packages/wheel/metadata.py b/venv/lib/python3.8/site-packages/wheel/metadata.py new file mode 100644 index 000000000..bbf57a770 --- /dev/null +++ b/venv/lib/python3.8/site-packages/wheel/metadata.py @@ -0,0 +1,138 @@ +""" +Tools for converting old- to new-style metadata. +""" + +import os.path +import re +import textwrap + +import pkg_resources + +from .pkginfo import read_pkg_info + +# Support markers syntax with the extra at the end only +EXTRA_RE = re.compile( + r"""^(?P.*?)(;\s*(?P.*?)(extra == '(?P.*?)')?)$""") + + +def requires_to_requires_dist(requirement): + """Return the version specifier for a requirement in PEP 345/566 fashion.""" + if getattr(requirement, 'url', None): + return " @ " + requirement.url + + requires_dist = [] + for op, ver in requirement.specs: + requires_dist.append(op + ver) + if not requires_dist: + return '' + return " (%s)" % ','.join(sorted(requires_dist)) + + +def convert_requirements(requirements): + """Yield Requires-Dist: strings for parsed requirements strings.""" + for req in requirements: + parsed_requirement = pkg_resources.Requirement.parse(req) + spec = requires_to_requires_dist(parsed_requirement) + extras = ",".join(sorted(parsed_requirement.extras)) + if extras: + extras = "[%s]" % extras + yield (parsed_requirement.project_name + extras + spec) + + +def generate_requirements(extras_require): + """ + Convert requirements from a setup()-style dictionary to ('Requires-Dist', 'requirement') + and ('Provides-Extra', 'extra') tuples. + + extras_require is a dictionary of {extra: [requirements]} as passed to setup(), + using the empty extra {'': [requirements]} to hold install_requires. + """ + for extra, depends in extras_require.items(): + condition = '' + extra = extra or '' + if ':' in extra: # setuptools extra:condition syntax + extra, condition = extra.split(':', 1) + + extra = pkg_resources.safe_extra(extra) + if extra: + yield 'Provides-Extra', extra + if condition: + condition = "(" + condition + ") and " + condition += "extra == '%s'" % extra + + if condition: + condition = ' ; ' + condition + + for new_req in convert_requirements(depends): + yield 'Requires-Dist', new_req + condition + + +def pkginfo_to_metadata(egg_info_path, pkginfo_path): + """ + Convert .egg-info directory with PKG-INFO to the Metadata 2.1 format + """ + pkg_info = read_pkg_info(pkginfo_path) + pkg_info.replace_header('Metadata-Version', '2.1') + # Those will be regenerated from `requires.txt`. + del pkg_info['Provides-Extra'] + del pkg_info['Requires-Dist'] + requires_path = os.path.join(egg_info_path, 'requires.txt') + if os.path.exists(requires_path): + with open(requires_path) as requires_file: + requires = requires_file.read() + + parsed_requirements = sorted(pkg_resources.split_sections(requires), + key=lambda x: x[0] or '') + for extra, reqs in parsed_requirements: + for key, value in generate_requirements({extra: reqs}): + if (key, value) not in pkg_info.items(): + pkg_info[key] = value + + description = pkg_info['Description'] + if description: + pkg_info.set_payload(dedent_description(pkg_info)) + del pkg_info['Description'] + + return pkg_info + + +def pkginfo_unicode(pkg_info, field): + """Hack to coax Unicode out of an email Message() - Python 3.3+""" + text = pkg_info[field] + field = field.lower() + if not isinstance(text, str): + for item in pkg_info.raw_items(): + if item[0].lower() == field: + text = item[1].encode('ascii', 'surrogateescape') \ + .decode('utf-8') + break + + return text + + +def dedent_description(pkg_info): + """ + Dedent and convert pkg_info['Description'] to Unicode. + """ + description = pkg_info['Description'] + + # Python 3 Unicode handling, sorta. + surrogates = False + if not isinstance(description, str): + surrogates = True + description = pkginfo_unicode(pkg_info, 'Description') + + description_lines = description.splitlines() + description_dedent = '\n'.join( + # if the first line of long_description is blank, + # the first line here will be indented. + (description_lines[0].lstrip(), + textwrap.dedent('\n'.join(description_lines[1:])), + '\n')) + + if surrogates: + description_dedent = description_dedent \ + .encode("utf8") \ + .decode("ascii", "surrogateescape") + + return description_dedent diff --git a/venv/lib/python3.8/site-packages/wheel/pep425tags.py b/venv/lib/python3.8/site-packages/wheel/pep425tags.py new file mode 100644 index 000000000..0c2576361 --- /dev/null +++ b/venv/lib/python3.8/site-packages/wheel/pep425tags.py @@ -0,0 +1,261 @@ +"""Generate and work with PEP 425 Compatibility Tags.""" + +import distutils.util +import platform +import sys +import os +import sysconfig +import warnings + +from .macosx_libfile import extract_macosx_min_system_version + + +try: + from importlib.machinery import all_suffixes as get_all_suffixes +except ImportError: + from imp import get_suffixes + + def get_all_suffixes(): + return [suffix[0] for suffix in get_suffixes()] + + +def get_config_var(var): + try: + return sysconfig.get_config_var(var) + except IOError as e: # pip Issue #1074 + warnings.warn("{0}".format(e), RuntimeWarning) + return None + + +def get_abbr_impl(): + """Return abbreviated implementation name.""" + impl = platform.python_implementation() + if impl == 'PyPy': + return 'pp' + elif impl == 'Jython': + return 'jy' + elif impl == 'IronPython': + return 'ip' + elif impl == 'CPython': + return 'cp' + + raise LookupError('Unknown Python implementation: ' + impl) + + +def get_impl_ver(): + """Return implementation version.""" + impl_ver = get_config_var("py_version_nodot") + if not impl_ver: + impl_ver = ''.join(map(str, get_impl_version_info())) + return impl_ver + + +def get_impl_version_info(): + """Return sys.version_info-like tuple for use in decrementing the minor + version.""" + return sys.version_info[0], sys.version_info[1] + + +def get_flag(var, fallback, expected=True, warn=True): + """Use a fallback method for determining SOABI flags if the needed config + var is unset or unavailable.""" + val = get_config_var(var) + if val is None: + if warn: + warnings.warn("Config variable '{0}' is unset, Python ABI tag may " + "be incorrect".format(var), RuntimeWarning, 2) + return fallback() + return val == expected + + +def get_abi_tag(): + """Return the ABI tag based on SOABI (if available) or emulate SOABI + (CPython 2, PyPy).""" + soabi = get_config_var('SOABI') + impl = get_abbr_impl() + if not soabi and impl in ('cp', 'pp') and hasattr(sys, 'maxunicode'): + d = '' + m = '' + u = '' + if get_flag('Py_DEBUG', + lambda: hasattr(sys, 'gettotalrefcount'), + warn=(impl == 'cp')): + d = 'd' + if get_flag('WITH_PYMALLOC', + lambda: impl == 'cp', + warn=(impl == 'cp' and + sys.version_info < (3, 8))) \ + and sys.version_info < (3, 8): + m = 'm' + if get_flag('Py_UNICODE_SIZE', + lambda: sys.maxunicode == 0x10ffff, + expected=4, + warn=(impl == 'cp' and + sys.version_info < (3, 3))) \ + and sys.version_info < (3, 3): + u = 'u' + abi = '%s%s%s%s%s' % (impl, get_impl_ver(), d, m, u) + elif soabi and soabi.startswith('cpython-'): + abi = 'cp' + soabi.split('-')[1] + elif soabi: + abi = soabi.replace('.', '_').replace('-', '_') + else: + abi = None + return abi + + +def calculate_macosx_platform_tag(archive_root, platform_tag): + """ + Calculate proper macosx platform tag basing on files which are included to wheel + + Example platform tag `macosx-10.14-x86_64` + """ + prefix, base_version, suffix = platform_tag.split('-') + base_version = tuple([int(x) for x in base_version.split(".")]) + if len(base_version) >= 2: + base_version = base_version[0:2] + + assert len(base_version) == 2 + if "MACOSX_DEPLOYMENT_TARGET" in os.environ: + deploy_target = tuple([int(x) for x in os.environ[ + "MACOSX_DEPLOYMENT_TARGET"].split(".")]) + if len(deploy_target) >= 2: + deploy_target = deploy_target[0:2] + if deploy_target < base_version: + sys.stderr.write( + "[WARNING] MACOSX_DEPLOYMENT_TARGET is set to a lower value ({}) than the " + "version on which the Python interpreter was compiled ({}), and will be " + "ignored.\n".format('.'.join(str(x) for x in deploy_target), + '.'.join(str(x) for x in base_version)) + ) + else: + base_version = deploy_target + + assert len(base_version) == 2 + start_version = base_version + versions_dict = {} + for (dirpath, dirnames, filenames) in os.walk(archive_root): + for filename in filenames: + if filename.endswith('.dylib') or filename.endswith('.so'): + lib_path = os.path.join(dirpath, filename) + min_ver = extract_macosx_min_system_version(lib_path) + if min_ver is not None: + versions_dict[lib_path] = min_ver[0:2] + + if len(versions_dict) > 0: + base_version = max(base_version, max(versions_dict.values())) + + # macosx platform tag do not support minor bugfix release + fin_base_version = "_".join([str(x) for x in base_version]) + if start_version < base_version: + problematic_files = [k for k, v in versions_dict.items() if v > start_version] + problematic_files = "\n".join(problematic_files) + if len(problematic_files) == 1: + files_form = "this file" + else: + files_form = "these files" + error_message = \ + "[WARNING] This wheel needs a higher macOS version than {} " \ + "To silence this warning, set MACOSX_DEPLOYMENT_TARGET to at least " +\ + fin_base_version + " or recreate " + files_form + " with lower " \ + "MACOSX_DEPLOYMENT_TARGET: \n" + problematic_files + + if "MACOSX_DEPLOYMENT_TARGET" in os.environ: + error_message = error_message.format("is set in MACOSX_DEPLOYMENT_TARGET variable.") + else: + error_message = error_message.format( + "the version your Python interpreter is compiled against.") + + sys.stderr.write(error_message) + + platform_tag = prefix + "_" + fin_base_version + "_" + suffix + return platform_tag + + +def get_platform(archive_root): + """Return our platform name 'win32', 'linux_x86_64'""" + # XXX remove distutils dependency + result = distutils.util.get_platform() + if result.startswith("macosx") and archive_root is not None: + result = calculate_macosx_platform_tag(archive_root, result) + result = result.replace('.', '_').replace('-', '_') + if result == "linux_x86_64" and sys.maxsize == 2147483647: + # pip pull request #3497 + result = "linux_i686" + + return result + + +def get_supported(archive_root, versions=None, supplied_platform=None): + """Return a list of supported tags for each version specified in + `versions`. + + :param versions: a list of string versions, of the form ["33", "32"], + or None. The first version will be assumed to support our ABI. + """ + supported = [] + + # Versions must be given with respect to the preference + if versions is None: + versions = [] + version_info = get_impl_version_info() + major = version_info[:-1] + # Support all previous minor Python versions. + for minor in range(version_info[-1], -1, -1): + versions.append(''.join(map(str, major + (minor,)))) + + impl = get_abbr_impl() + + abis = [] + + abi = get_abi_tag() + if abi: + abis[0:0] = [abi] + + abi3s = set() + for suffix in get_all_suffixes(): + if suffix.startswith('.abi'): + abi3s.add(suffix.split('.', 2)[1]) + + abis.extend(sorted(list(abi3s))) + + abis.append('none') + + platforms = [] + if supplied_platform: + platforms.append(supplied_platform) + platforms.append(get_platform(archive_root)) + + # Current version, current API (built specifically for our Python): + for abi in abis: + for arch in platforms: + supported.append(('%s%s' % (impl, versions[0]), abi, arch)) + + # abi3 modules compatible with older version of Python + for version in versions[1:]: + # abi3 was introduced in Python 3.2 + if version in ('31', '30'): + break + for abi in abi3s: # empty set if not Python 3 + for arch in platforms: + supported.append(("%s%s" % (impl, version), abi, arch)) + + # No abi / arch, but requires our implementation: + for i, version in enumerate(versions): + supported.append(('%s%s' % (impl, version), 'none', 'any')) + if i == 0: + # Tagged specifically as being cross-version compatible + # (with just the major version specified) + supported.append(('%s%s' % (impl, versions[0][0]), 'none', 'any')) + + # Major Python version + platform; e.g. binaries not using the Python API + for arch in platforms: + supported.append(('py%s' % (versions[0][0]), 'none', arch)) + + # No abi / arch, generic Python + for i, version in enumerate(versions): + supported.append(('py%s' % (version,), 'none', 'any')) + if i == 0: + supported.append(('py%s' % (version[0]), 'none', 'any')) + + return supported diff --git a/venv/lib/python3.8/site-packages/wheel/pkginfo.py b/venv/lib/python3.8/site-packages/wheel/pkginfo.py new file mode 100644 index 000000000..115be45bd --- /dev/null +++ b/venv/lib/python3.8/site-packages/wheel/pkginfo.py @@ -0,0 +1,43 @@ +"""Tools for reading and writing PKG-INFO / METADATA without caring +about the encoding.""" + +from email.parser import Parser + +try: + unicode + _PY3 = False +except NameError: + _PY3 = True + +if not _PY3: + from email.generator import Generator + + def read_pkg_info_bytes(bytestr): + return Parser().parsestr(bytestr) + + def read_pkg_info(path): + with open(path, "r") as headers: + message = Parser().parse(headers) + return message + + def write_pkg_info(path, message): + with open(path, 'w') as metadata: + Generator(metadata, mangle_from_=False, maxheaderlen=0).flatten(message) +else: + from email.generator import BytesGenerator + + def read_pkg_info_bytes(bytestr): + headers = bytestr.decode(encoding="ascii", errors="surrogateescape") + message = Parser().parsestr(headers) + return message + + def read_pkg_info(path): + with open(path, "r", + encoding="ascii", + errors="surrogateescape") as headers: + message = Parser().parse(headers) + return message + + def write_pkg_info(path, message): + with open(path, "wb") as out: + BytesGenerator(out, mangle_from_=False, maxheaderlen=0).flatten(message) diff --git a/venv/lib/python3.8/site-packages/wheel/util.py b/venv/lib/python3.8/site-packages/wheel/util.py new file mode 100644 index 000000000..3ae2b4457 --- /dev/null +++ b/venv/lib/python3.8/site-packages/wheel/util.py @@ -0,0 +1,46 @@ +import base64 +import io +import sys + + +if sys.version_info[0] < 3: + text_type = unicode # noqa: F821 + + StringIO = io.BytesIO + + def native(s, encoding='utf-8'): + if isinstance(s, unicode): # noqa: F821 + return s.encode(encoding) + return s +else: + text_type = str + + StringIO = io.StringIO + + def native(s, encoding='utf-8'): + if isinstance(s, bytes): + return s.decode(encoding) + return s + + +def urlsafe_b64encode(data): + """urlsafe_b64encode without padding""" + return base64.urlsafe_b64encode(data).rstrip(b'=') + + +def urlsafe_b64decode(data): + """urlsafe_b64decode without padding""" + pad = b'=' * (4 - (len(data) & 3)) + return base64.urlsafe_b64decode(data + pad) + + +def as_unicode(s): + if isinstance(s, bytes): + return s.decode('utf-8') + return s + + +def as_bytes(s): + if isinstance(s, text_type): + return s.encode('utf-8') + return s diff --git a/venv/lib/python3.8/site-packages/wheel/wheelfile.py b/venv/lib/python3.8/site-packages/wheel/wheelfile.py new file mode 100644 index 000000000..bc4e8d7f7 --- /dev/null +++ b/venv/lib/python3.8/site-packages/wheel/wheelfile.py @@ -0,0 +1,169 @@ +from __future__ import print_function + +import csv +import hashlib +import os.path +import re +import stat +import time +from collections import OrderedDict +from distutils import log as logger +from zipfile import ZIP_DEFLATED, ZipInfo, ZipFile + +from wheel.cli import WheelError +from wheel.util import urlsafe_b64decode, as_unicode, native, urlsafe_b64encode, as_bytes, StringIO + +# Non-greedy matching of an optional build number may be too clever (more +# invalid wheel filenames will match). Separate regex for .dist-info? +WHEEL_INFO_RE = re.compile( + r"""^(?P(?P[^-]+?)-(?P[^-]+?))(-(?P\d[^-]*))? + -(?P[^-]+?)-(?P[^-]+?)-(?P[^.]+?)\.whl$""", + re.VERBOSE) + + +def get_zipinfo_datetime(timestamp=None): + # Some applications need reproducible .whl files, but they can't do this without forcing + # the timestamp of the individual ZipInfo objects. See issue #143. + timestamp = int(os.environ.get('SOURCE_DATE_EPOCH', timestamp or time.time())) + return time.gmtime(timestamp)[0:6] + + +class WheelFile(ZipFile): + """A ZipFile derivative class that also reads SHA-256 hashes from + .dist-info/RECORD and checks any read files against those. + """ + + _default_algorithm = hashlib.sha256 + + def __init__(self, file, mode='r', compression=ZIP_DEFLATED): + basename = os.path.basename(file) + self.parsed_filename = WHEEL_INFO_RE.match(basename) + if not basename.endswith('.whl') or self.parsed_filename is None: + raise WheelError("Bad wheel filename {!r}".format(basename)) + + ZipFile.__init__(self, file, mode, compression=compression, allowZip64=True) + + self.dist_info_path = '{}.dist-info'.format(self.parsed_filename.group('namever')) + self.record_path = self.dist_info_path + '/RECORD' + self._file_hashes = OrderedDict() + self._file_sizes = {} + if mode == 'r': + # Ignore RECORD and any embedded wheel signatures + self._file_hashes[self.record_path] = None, None + self._file_hashes[self.record_path + '.jws'] = None, None + self._file_hashes[self.record_path + '.p7s'] = None, None + + # Fill in the expected hashes by reading them from RECORD + try: + record = self.open(self.record_path) + except KeyError: + raise WheelError('Missing {} file'.format(self.record_path)) + + with record: + for line in record: + line = line.decode('utf-8') + path, hash_sum, size = line.rsplit(u',', 2) + if hash_sum: + algorithm, hash_sum = hash_sum.split(u'=') + try: + hashlib.new(algorithm) + except ValueError: + raise WheelError('Unsupported hash algorithm: {}'.format(algorithm)) + + if algorithm.lower() in {'md5', 'sha1'}: + raise WheelError( + 'Weak hash algorithm ({}) is not permitted by PEP 427' + .format(algorithm)) + + self._file_hashes[path] = ( + algorithm, urlsafe_b64decode(hash_sum.encode('ascii'))) + + def open(self, name_or_info, mode="r", pwd=None): + def _update_crc(newdata, eof=None): + if eof is None: + eof = ef._eof + update_crc_orig(newdata) + else: # Python 2 + update_crc_orig(newdata, eof) + + running_hash.update(newdata) + if eof and running_hash.digest() != expected_hash: + raise WheelError("Hash mismatch for file '{}'".format(native(ef_name))) + + ef = ZipFile.open(self, name_or_info, mode, pwd) + ef_name = as_unicode(name_or_info.filename if isinstance(name_or_info, ZipInfo) + else name_or_info) + if mode == 'r' and not ef_name.endswith('/'): + if ef_name not in self._file_hashes: + raise WheelError("No hash found for file '{}'".format(native(ef_name))) + + algorithm, expected_hash = self._file_hashes[ef_name] + if expected_hash is not None: + # Monkey patch the _update_crc method to also check for the hash from RECORD + running_hash = hashlib.new(algorithm) + update_crc_orig, ef._update_crc = ef._update_crc, _update_crc + + return ef + + def write_files(self, base_dir): + logger.info("creating '%s' and adding '%s' to it", self.filename, base_dir) + deferred = [] + for root, dirnames, filenames in os.walk(base_dir): + # Sort the directory names so that `os.walk` will walk them in a + # defined order on the next iteration. + dirnames.sort() + for name in sorted(filenames): + path = os.path.normpath(os.path.join(root, name)) + if os.path.isfile(path): + arcname = os.path.relpath(path, base_dir).replace(os.path.sep, '/') + if arcname == self.record_path: + pass + elif root.endswith('.dist-info'): + deferred.append((path, arcname)) + else: + self.write(path, arcname) + + deferred.sort() + for path, arcname in deferred: + self.write(path, arcname) + + def write(self, filename, arcname=None, compress_type=None): + with open(filename, 'rb') as f: + st = os.fstat(f.fileno()) + data = f.read() + + zinfo = ZipInfo(arcname or filename, date_time=get_zipinfo_datetime(st.st_mtime)) + zinfo.external_attr = (stat.S_IMODE(st.st_mode) | stat.S_IFMT(st.st_mode)) << 16 + zinfo.compress_type = compress_type or self.compression + self.writestr(zinfo, data, compress_type) + + def writestr(self, zinfo_or_arcname, bytes, compress_type=None): + ZipFile.writestr(self, zinfo_or_arcname, bytes, compress_type) + fname = (zinfo_or_arcname.filename if isinstance(zinfo_or_arcname, ZipInfo) + else zinfo_or_arcname) + logger.info("adding '%s'", fname) + if fname != self.record_path: + hash_ = self._default_algorithm(bytes) + self._file_hashes[fname] = hash_.name, native(urlsafe_b64encode(hash_.digest())) + self._file_sizes[fname] = len(bytes) + + def close(self): + # Write RECORD + if self.fp is not None and self.mode == 'w' and self._file_hashes: + data = StringIO() + writer = csv.writer(data, delimiter=',', quotechar='"', lineterminator='\n') + writer.writerows(( + ( + fname, + algorithm + "=" + hash_, + self._file_sizes[fname] + ) + for fname, (algorithm, hash_) in self._file_hashes.items() + )) + writer.writerow((format(self.record_path), "", "")) + zinfo = ZipInfo(native(self.record_path), date_time=get_zipinfo_datetime()) + zinfo.compress_type = self.compression + zinfo.external_attr = 0o664 << 16 + self.writestr(zinfo, as_bytes(data.getvalue())) + + ZipFile.close(self) diff --git a/venv/pyvenv.cfg b/venv/pyvenv.cfg new file mode 100644 index 000000000..7ba78fadd --- /dev/null +++ b/venv/pyvenv.cfg @@ -0,0 +1,8 @@ +home = /usr +implementation = CPython +version_info = 3.8.10.final.0 +virtualenv = 20.0.17 +include-system-site-packages = false +base-prefix = /usr +base-exec-prefix = /usr +base-executable = /usr/bin/python3 From ae5ff61c81fa2bbda637dc33c7547ce869ced9d3 Mon Sep 17 00:00:00 2001 From: sooctosnake Date: Tue, 12 Sep 2023 08:50:34 -0700 Subject: [PATCH 09/27] add_games_2 --- _posts/2023-09-04-Week-3- Plans.md | 6 ++ _posts/2023-09-09-coinflip.md | 99 ++++++++++++++++++ _posts/2023-09-09-draganddrop.md | 109 +++++++++++++++++++ _posts/2023-09-10-Review_Ticket.md | 162 +++++++++++++++++++++++++++++ 4 files changed, 376 insertions(+) create mode 100644 _posts/2023-09-09-coinflip.md create mode 100644 _posts/2023-09-09-draganddrop.md create mode 100644 _posts/2023-09-10-Review_Ticket.md diff --git a/_posts/2023-09-04-Week-3- Plans.md b/_posts/2023-09-04-Week-3- Plans.md index 0e2b446f6..37891a8fe 100644 --- a/_posts/2023-09-04-Week-3- Plans.md +++ b/_posts/2023-09-04-Week-3- Plans.md @@ -24,3 +24,9 @@ Make a plan on what you and your Pair plan to do, this must exist by Monday nigh - Linux Shell and Bash, Python IO, Python Tricks!, JS Output w/Jquery, JS Output w/Objects, JS Input. - Option 1. Add to the lessons and making code cells and hacks for better breakdown and understanding - Option 2. Combine all the concepts/requirements into something unique and you feel is awesome +## Feedback from Mr. Mortenson +This could use a little more description, like move a square to the right and having a jump actions to avoid collision. This will be through “a tutorial” or “video” we found to follow. + +## More Descriptive Plan +Our plan this week is to experiment on making a little videogame. We are thinking of making a small game involving a square which the player can control, and they have to avoid the moving bullets targeting the square. The plan is to code the arrow keys on the rectangle game so the square can move in all directions, and the red bullets will come from the right moving to the left. The bullets will progressively increase as the game difficulty increases by the second. We plan on using videos on how to make the bullets increase faster. We are also planning to do this by looking up online resources and using ChatGPT to explain the code to us, then we can start working on it. + diff --git a/_posts/2023-09-09-coinflip.md b/_posts/2023-09-09-coinflip.md new file mode 100644 index 000000000..cbc7d5027 --- /dev/null +++ b/_posts/2023-09-09-coinflip.md @@ -0,0 +1,99 @@ +--- +toc: true +comments: false +layout: post +title: Cursed Coin Flip +description: Guess and Flip! Avoid the darkness taking over. +type: tangibles +courses: { compsci: {week: 3} } +--- + + + Coin Flip Game + + + +

+

Coin Flip Game

+

Guess the outcome:

+ + +

+
+ + +
+

Try again.

+
+ + + + \ No newline at end of file diff --git a/_posts/2023-09-09-draganddrop.md b/_posts/2023-09-09-draganddrop.md new file mode 100644 index 000000000..2f5ae5c49 --- /dev/null +++ b/_posts/2023-09-09-draganddrop.md @@ -0,0 +1,109 @@ +--- +toc: true +comments: false +layout: post +title: Drag and Drop Game +description: A simple game where you drag and drop shapes! +type: tangibles +courses: { compsci: {week: 3} } +--- + + + Drag and Drop Shapes Game + + + +

Drag and Drop Shapes Game

+
+ +
Circle
+
Triangle
+
Square
+
Rectangle
+ +
+
+
+
+
+
+ + + + \ No newline at end of file diff --git a/_posts/2023-09-10-Review_Ticket.md b/_posts/2023-09-10-Review_Ticket.md new file mode 100644 index 000000000..f45fa8adc --- /dev/null +++ b/_posts/2023-09-10-Review_Ticket.md @@ -0,0 +1,162 @@ +--- +toc: true +comments: false +layout: post +title: Review Ticket +description: Here is our Week 3 Review Ticket. +type: tangibles +courses: { compsci: {week: 3} } +--- + +# JS Structure + +## Variable Declaration (var, let, const): + +- Command: **var, let, const** +- Explanation: These commands are used to declare variables in JavaScript. +var (Variable): Used for declaring variables globally or within a function, with function scope. +- **let** (Block-Scoped Variable): Used for declaring variables within a block (e.g., a loop or an if statement) and has block scope. +- **const** (Constant): Used for declaring variables with a constant value. It cannot be reassigned after declaration. + +## Example + var globalVariable = "I'm global"; + let blockVariable = "I'm in a block"; + const pi = 3.14159; + + globalVariable = "I can be changed"; + // blockVariable can only be accessed within its block. + // pi cannot be reassigned. + +## Conditional Statements (if, else, switch): + +- Command: **if, else, switch** +- Explanation: These commands allow you to make decisions in your code based on conditions. +- **if**: Checks a condition and executes a block of code if the condition is true. +- **else**: Used in combination with if, it executes a block of code if the condition in if is false. +- **switch**: Evaluates an expression against multiple possible case values and executes code based on the matching case. + +## Example + + let age = 18; + + if (age >= 18) { + console.log("You can vote!"); + } else { + console.log("You are too young to vote."); + } + + let day = "Monday"; + + switch (day) { + case "Monday": + console.log("It's the start of the week."); + break; + case "Friday": + console.log("Weekend is coming!"); + break; + default: + console.log("It's a regular day."); + } + +## Function Declaration and Invocation: + +- Command: **function** +- Explanation: Functions are reusable blocks of code that can be defined and called with specific inputs (arguments). They encapsulate a task and make your code more organized and maintainable. + +## Example + // Function declaration + function greet(name) { + console.log("Hello, " + name + "!"); + } + + // Function invocation + greet("Sri"); // Output: Hello, Sri! + greet("Soham"); // Output: Hello, Soham! + +# Python Structure + +## Variable Assignment +- Construct: **variable_name = value** +- Explanation: In Python, you can create variables to store data. Variables are created when you assign a value to them. Python is dynamically typed, meaning you don't need to declare the variable type explicitly. + +## Example + + name = "Alice" + age = 30 + pi = 3.14159 + +## Conditional Statements (if, elif, else): +- if condition: + code to execute if the condition is True +- elif another_condition: + code to execute if the first condition is False and this condition is True +- else: code to execute if none of the conditions are True + +- Explanation: Conditional statements allow you to make decisions in your code based on conditions. +- **if**: Checks a condition and executes a block of code if the condition is True. +- **elif** (short for "else if"): Used to check another condition if the previous if or elif condition is False. +- **else**: Executes a block of code when none of the conditions in if or elif are True. + +## Example + + age = 18 + + if age >= 18: + print("You can vote!") + elif age >= 16: + print("You can get a driver's license.") + else: + print("You are too young for voting or driving.") + +## Function Definition and Invocation +Construct: +- def function_name(parameters): + #code inside the function + return result + +- Explanation: Functions in Python are defined using the **def** keyword, followed by the function name and parameters. They allow you to encapsulate a block of code, make it reusable, and return values if needed. + +## Example + + def greet(name): + return "Hello, " + name + "!" + + greeting = greet("Alice") + print(greeting) # Output: Hello, Sri! + +# HTML Structure + +## HTML Elements +- Construct: HTML elements are the building blocks of a web page. They are defined with tags, which are enclosed in angle brackets. Elements can be nested inside other elements, creating a hierarchical structure for web content. +- Explanation: HTML elements define the structure and content of a web page. Some common elements include **

** for headings, **

** for paragraphs, "" for links, and for images. + +## Example + +

This is a Heading

+

This is a paragraph of text.

+
Visit Example.com + An example image + +## HTML Attributes +- Construct: HTML attributes provide additional information about an element and are specified within the opening tag of an element. Attributes consist of a name and a value, separated by an equal sign. +- Explanation: Attributes modify the behavior or appearance of HTML elements. For example, the href attribute in an anchor tag specifies the URL to which the link leads, and the src attribute in an image tag specifies the image source. + +## Example + + Visit Example.com + An example image + +## HTML Forms +- Construct: HTML forms are used to collect user input. They are defined using the **
** element, and form controls such as text fields, radio buttons, checkboxes, and buttons are placed inside the form. The action attribute of the **** element specifies where the form data is sent. +- Explanation: Forms enable user interaction on web pages. When a user submits a form, the data is sent to the server for processing or used for client-side scripting. + +## Example + + + + + + + + +
\ No newline at end of file From 160f9e0e40a0915365b6e9ce8dab41116b7eb85f Mon Sep 17 00:00:00 2001 From: sooctosnake Date: Mon, 25 Sep 2023 09:30:06 -0700 Subject: [PATCH 10/27] added basics --- _notebooks/2023-08-28-basics-home.ipynb | 65 ++ _notebooks/2023-08-28-basics-html.ipynb | 288 ++++++++ _notebooks/2023-08-29-basics-of-js.ipynb | 559 +++++++++++++++ .../2023-08-30-basics-js-data-types.ipynb | 662 ++++++++++++++++++ .../2023-08-30-basics-js-with-html.ipynb | 400 +++++++++++ _notebooks/2023-09-20-1_4-js-errors.ipynb | 314 +++++++++ 6 files changed, 2288 insertions(+) create mode 100644 _notebooks/2023-08-28-basics-home.ipynb create mode 100644 _notebooks/2023-08-28-basics-html.ipynb create mode 100644 _notebooks/2023-08-29-basics-of-js.ipynb create mode 100644 _notebooks/2023-08-30-basics-js-data-types.ipynb create mode 100644 _notebooks/2023-08-30-basics-js-with-html.ipynb create mode 100644 _notebooks/2023-09-20-1_4-js-errors.ipynb diff --git a/_notebooks/2023-08-28-basics-home.ipynb b/_notebooks/2023-08-28-basics-home.ipynb new file mode 100644 index 000000000..cba7971a0 --- /dev/null +++ b/_notebooks/2023-08-28-basics-home.ipynb @@ -0,0 +1,65 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "---\n", + "layout: post\n", + "title: Web Programming Basics\n", + "description: An introduction to key topics in Web Programming\n", + "courses: { csse: {week: 6}, csp: {week: 6} }\n", + "type: ccc\n", + "permalink: /basics/home\n", + "---" + ] + }, + { + "cell_type": "raw", + "metadata": {}, + "source": [ + "{% include nav_basics.html %}\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "# A guide to basic concepts in Web Notebook\n", + "- Making a menu\n", + "- Use menu to Guide topics\n", + "- Make your own custom page and menu\n", + "- Making a page dynamic through JavaScript\n", + "- Review usage of Styles in GitHub Pages\n", + "\n", + "# How to import this setup into your student repository\n", + "- NOTE: To copy files between repostories, open two vscode windows and you can drag and drop\n", + "- Copy the file _includes/nav_basics.html into the _includes folder of your student repository\n", + " - This creates the navigation between the different pages in the Web Dev Basics\n", + "- Copy the following files from _notebooks into your _notebooks folder\n", + " - 2023-03-28-basics-home.ipynb, 2023-03-28-basics-html.ipynb, 2023-03-29-basics-of-js.ipynb, 2023-08-30-basics-of-js-data-types.ipynb, 2023-08-30-basics-js-with-html.ipynb, 2023-09-20-1_4-js-errors.ipynb\n", + "- In the basics homepage (2023-03-28-basics-home.ipynb), you need to make an edit\n", + " - In the top cell, modify the courses to say `{ compsci: { week: 5 } }` (this will move this into your schedule page)\n", + "\n", + "# Seeing javascript console output in visual studio\n", + "- When printing outputs from javascript to the console you will need to open the developer console\n", + " - Go to Help->Toggle Developer Tools and click console on the top bar of the developer window" + ] + } + ], + "metadata": { + "kernelspec": { + "display_name": "Python 3", + "language": "python", + "name": "python3" + }, + "language_info": { + "name": "python", + "version": "3.9.12" + }, + "orig_nbformat": 4 + }, + "nbformat": 4, + "nbformat_minor": 2 +} diff --git a/_notebooks/2023-08-28-basics-html.ipynb b/_notebooks/2023-08-28-basics-html.ipynb new file mode 100644 index 000000000..73b855eec --- /dev/null +++ b/_notebooks/2023-08-28-basics-html.ipynb @@ -0,0 +1,288 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "---\n", + "layout: post\n", + "hide: True\n", + "title: Basics of HTML Guide\n", + "description: An introduction to basic HTML, and resources to learn more.\n", + "type: ccc\n", + "permalink: /basics/html\n", + "author: Rohan Juneja\n", + "---" + ] + }, + { + "cell_type": "raw", + "metadata": {}, + "source": [ + "{% include nav_basics.html %}\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "# How does HTML work?\n", + "Similar function to Markdown, syntax defines how stuff should be displayed\n", + "- HTML is based on beginning and closing tags `content`\n", + " - Note the \"/\" on the ending or closing tag of the pair" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Compare markdown to html below\n", + "This below example shows comparison of a [heading](https://www.w3schools.com/html/html_headings.asp) and [paragraph](https://www.w3schools.com/html/html_paragraphs.asp). Click on links to see many more HTML examples." + ] + }, + { + "cell_type": "code", + "execution_count": 8, + "metadata": {}, + "outputs": [ + { + "data": { + "text/markdown": [ + "\n", + "### Markdown: This is a Heading\n", + "\n", + "This is a paragraph\n" + ], + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "%%markdown\n", + "\n", + "### Markdown: This is a Heading\n", + "\n", + "This is a paragraph\n" + ] + }, + { + "cell_type": "code", + "execution_count": 9, + "metadata": { + "vscode": { + "languageId": "html" + } + }, + "outputs": [ + { + "data": { + "text/html": [ + "\n", + "

HTML: This is a Heading

\n", + "

This is a paragraph.

\n" + ], + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "%%html\n", + "\n", + "

HTML: This is a Heading

\n", + "

This is a paragraph.

" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Attributes\n", + "- Learn about [attributes](https://www.w3schools.com/html/html_attributes.asp) \n", + "- Tags can have additional info in the form of attributes\n", + "- Attributes usually come in name/value pairs like: name=\"value\"\n", + "\n", + "```html\n", + "inner html text\n", + "```\n", + "\n", + "- href example with attribute for web link and inner html to describe link\n", + "\n", + "```html\n", + "Visit W3Schools HTML Page\n", + "```" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Sample Markdown vs HTML Tags\n", + "Image Tag - Markdown\n", + "\n", + "```md\n", + "![describe image](link to image)\n", + "```\n", + "\n", + "Image Tag - HTML\n", + "\n", + "```html\n", + "\n", + "\"describe\n", + "```\n", + "\n", + "Link Tag - Markdown\n", + "\n", + "```md\n", + "[link text](link)\n", + "```\n", + "\n", + "Link Tag - HTML\n", + "\n", + "```html\n", + "link text\n", + "```\n", + "\n", + "Bolded Text - Markdown\n", + "\n", + "```md\n", + "**Bolded Text**\n", + "```\n", + "\n", + "Bolded Text - HTML\n", + "\n", + "```md\n", + "Bolded Text\n", + "```\n", + "\n", + "Italic Text - Markdown\n", + "\n", + "```md\n", + "*Italic Text*\n", + "```\n", + "\n", + "Italic Text - HTML\n", + "\n", + "```md\n", + "Italic Text\n", + "```" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# More tags (not really in markdown)\n", + "P tag (just represeants a paragraph/normal text)\n", + "\n", + "```html\n", + "

This is a paragraph

\n", + "```\n", + "\n", + "Button\n", + "\n", + "```html\n", + "\n", + "```\n", + "\n", + "Div (groups together related content)\n", + "\n", + "```html\n", + "\n", + "
\n", + " \n", + "

This is the first paragarph of section 1

\n", + "

This is the second paragraph of section 1

\n", + "
\n", + "\n", + "\n", + "
\n", + " \n", + "

This is the first paragarph of section 2

\n", + "

This is the second paragraph of section 2

\n", + "
\n", + "```\n", + "\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Resources\n", + "- https://www.w3schools.com/html/default.asp\n", + "- I will show a demo of how to find information on this website" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# HTML Hacks\n", + "- Below is a wireframe for an HTML element you will create. A wireframe is a rough visual representation of HTML elements on a page and isn't necessarily to scale or have the exact styling that the final HTML will have. Using the syntax above, try to create an HTML snippet that corresponds to the below wireframe.\n", + "- The \"a tags\" can contain any links that you want\n", + "\n", + "![wireframe for html hacks]({{ site.baseurl }}/images/wireframe.png)" + ] + }, + { + "cell_type": "code", + "execution_count": 1, + "metadata": { + "vscode": { + "languageId": "html" + } + }, + "outputs": [ + { + "data": { + "text/html": [ + "\n", + "\n" + ], + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "%%html\n", + "\n", + "" + ] + } + ], + "metadata": { + "kernelspec": { + "display_name": "Python 3", + "language": "python", + "name": "python3" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.9.12" + }, + "orig_nbformat": 4 + }, + "nbformat": 4, + "nbformat_minor": 2 +} diff --git a/_notebooks/2023-08-29-basics-of-js.ipynb b/_notebooks/2023-08-29-basics-of-js.ipynb new file mode 100644 index 000000000..bdb11a3c1 --- /dev/null +++ b/_notebooks/2023-08-29-basics-of-js.ipynb @@ -0,0 +1,559 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "---\n", + "title: Basics of Javascript\n", + "hide: True\n", + "description: A Tech Talk on how to use javascript\n", + "type: ccc\n", + "permalink: /basics/javascript\n", + "author: Rohan Juneja\n", + "---" + ] + }, + { + "cell_type": "raw", + "metadata": {}, + "source": [ + "{% include nav_basics.html %}\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "# How to use javascript in any of your pages\n", + "- Simply add a ```` in your markdown or jupyter cells\n", + "- (Note: the %%html magic command allows us to add HTML and JavaScript into a jupyter notebook, the outputted \"site\" will be shown below the code)" + ] + }, + { + "cell_type": "code", + "execution_count": 8, + "metadata": {}, + "outputs": [ + { + "data": { + "text/html": [ + "

Page Heading

\n", + "

Paragraph description of page

\n", + "\n" + ], + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "%%html\n", + "

Page Heading

\n", + "

Paragraph description of page

\n", + "\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Writing text to console.log\n", + "- The text written with `console.log` appears in the Console\n", + "- `console.log` allows you to write text -- but you don't see any text in above example until you view Console.\n", + "- Activate Console window\n", + " - VSCode Help-Toggle Developer Tools allows you to see console.log output\n", + " - Chrome and other browsers require right click -> inspect also allows access to console.log output\n", + " - Safari users will need to enable developer settings before inspecting an element. To do this go to Safari settings -> advanced and check the box next to \"Show develop menu in menu bar\"\n", + " - By default you usually need to click Console next to Elements, to see console.log output\n", + " - Also, you may want to press clear console (cirlcl with slash) to clean up screen before analysis. \n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Try code with Console\n", + "- Developers typically keep console open\n", + "- In console window, you can run javascript code from prompt" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Storing data\n", + "- One of the most important things in programming is learning how data is stored, this is often called Data Abstraction (the ability to represent data in a programming language)." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Types of data\n", + "- Javascript has a few basic types of data, which align with what the types of data you might know yourself\n", + "- In javascript, these types are formalized as:\n", + " - text = \"string\", number = \"number\", true/false = \"boolean\"" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Name the Data\n", + "- When you think of data, it has a name and a value.\n", + "- Using the \"var\" JavaScript syntax you create a `variable` with a name and a value.\n", + "- In javascript this can represented with the following: `var someName = value;`\n", + " - The name cannot have spaces\n", + " - Text values must be wrapped in single or double quotes to identify it as text (see exmaples below)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Accessing data\n", + "- To access data (the value of a variable), simply just use the name of the variable\n", + "- For example, we can use the values from previously in a `console.log`" + ] + }, + { + "cell_type": "code", + "execution_count": 17, + "metadata": { + "vscode": { + "languageId": "html" + } + }, + "outputs": [ + { + "data": { + "text/html": [ + "\n", + "\n" + ], + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "%%html\n", + "\n", + "" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# String Operators\n", + "- \"+\" concatenates string, same as combining text\n", + "- \"==\" checks if strings are the same, if so it outputs `true`, otherwise `false`\n", + " - \"!==\" is \"not equal to\" (opposite of equal to)\n", + "\n", + "## Assignment Operator\n", + "- \"=\" can be used to change the value of a variable\n", + " - ie. if you already created \"name1\" you can reassign name1 = \"New Name\"" + ] + }, + { + "cell_type": "code", + "execution_count": 16, + "metadata": { + "vscode": { + "languageId": "html" + } + }, + "outputs": [ + { + "data": { + "text/html": [ + "\n", + "\n" + ], + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "%%html\n", + "\n", + "\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Number Operators\n", + "- \"+\" adds numbers together\n", + "- \"-\" subtracts numbers, \"/\" divides numbers, \"*\" multiples numbers\n", + "- \"===\" checks if two values are the same, if so it outputs `true`, otherwise `false`\n", + " - \"!==\" is \"not equal to\" (opposite of equal to)\n", + " - normal oeprators like \"<\", \">\", \">=\" (greater than or equal to), \"<=\" with numbers\n", + "\n", + "## Assignment Operator\n", + "- \"=\" can be used to create or change the value of a variable" + ] + }, + { + "cell_type": "code", + "execution_count": 28, + "metadata": { + "vscode": { + "languageId": "html" + } + }, + "outputs": [ + { + "data": { + "text/html": [ + "\n", + "\n" + ], + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "%%html\n", + "\n", + "" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Conditional Statements\n", + "- Think about any actions that you take: you usually take them based on information you take in\n", + " - If tommorow is a school day, set an alarm for tomorrow at 8am\n", + "- We can also add additional clauses at the end\n", + " - If tommorow is a school day, set an alarm for tomorrow at 8am, otherwise (else) set an alarm for tommorow at 10am" + ] + }, + { + "cell_type": "code", + "execution_count": 29, + "metadata": { + "vscode": { + "languageId": "html" + } + }, + "outputs": [ + { + "data": { + "text/html": [ + "\n", + "\n" + ], + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "%%html\n", + "\n", + "" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Conditional Statements + Operators\n", + "- Since many operators return a true/false value (equals, gerater than, etc.) we can use them inside \"if\" statements" + ] + }, + { + "cell_type": "code", + "execution_count": 30, + "metadata": { + "vscode": { + "languageId": "html" + } + }, + "outputs": [ + { + "data": { + "text/html": [ + "\n" + ], + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "%%html\n", + "" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Hacks\n", + "- Write a JavaScript program that compares two variables, a and b. Log \"a is greater\" if a is greater than b, \"b is greater\" if b is greater than a, and \"both are equal\" if a and b are equal. Make sure to use if statements and console.log" + ] + }, + { + "cell_type": "code", + "execution_count": 3, + "metadata": { + "vscode": { + "languageId": "javascript" + } + }, + "outputs": [ + { + "data": { + "application/javascript": "// put your javascript code here\n", + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "%%js\n", + "// put your javascript code here" + ] + } + ], + "metadata": { + "kernelspec": { + "display_name": "Python 3", + "language": "python", + "name": "python3" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.9.12" + }, + "orig_nbformat": 4 + }, + "nbformat": 4, + "nbformat_minor": 2 +} diff --git a/_notebooks/2023-08-30-basics-js-data-types.ipynb b/_notebooks/2023-08-30-basics-js-data-types.ipynb new file mode 100644 index 000000000..cdbc8ed51 --- /dev/null +++ b/_notebooks/2023-08-30-basics-js-data-types.ipynb @@ -0,0 +1,662 @@ +{ + "cells": [ + { + "cell_type": "raw", + "metadata": {}, + "source": [ + "---\n", + "title: Javascript Data Types/Lists\n", + "hide: True\n", + "description: A Tech Talk on javascript data types and how to use with lists\n", + "type: ccc\n", + "permalink: /basics/datatypes\n", + "author: Rohan Juneja\n", + "---" + ] + }, + { + "cell_type": "raw", + "metadata": {}, + "source": [ + "{% include nav_basics.html %}\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# string datatype\n", + "- We discussed that strings store text\n", + "- It is useful to know a few functions that can be used on string manipulation (see example below)\n", + "- We can see the type of data using `typeof` operator" + ] + }, + { + "cell_type": "code", + "execution_count": 1, + "metadata": { + "vscode": { + "languageId": "javascript" + } + }, + "outputs": [ + { + "data": { + "text/html": [ + "\n" + ], + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "%%js\n", + "\n", + "// assign variable\n", + "var hello = \"Hello World\";\n", + "console.log(\"variable: hello\")\n", + "console.log(hello)\n", + "\n", + "// seeing the type of this data\n", + "console.log(\"variable: hello check typeof\")\n", + "console.log(typeof hello)\n", + "\n", + "// add strings together\n", + "console.log(\"string concatenation: hello + Rohan!\")\n", + "console.log(hello + \" Rohan!\")" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## .substring()" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "vscode": { + "languageId": "javascript" + } + }, + "outputs": [], + "source": [ + "%%js\n", + "var hello = \"Hello World\";\n", + "\n", + "// getting a certain component of this text\n", + "// (here the _ is a standin for the space character)\n", + "// H e l l o _ W o r l d\n", + "// 0 1 2 3 4 5 6 7 8 9 10\n", + "// if we want the hello component, we want characters 0-4, so we use the following function\n", + "// (note how we use 0 and 5 as arguments, the last character is NOT INCLUSIVE)\n", + "console.log(\"substring: hello 0, 5\")\n", + "console.log(hello.substring(0, 5))" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## .toUpperCase() and .toLowerCase()" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "vscode": { + "languageId": "javascript" + } + }, + "outputs": [], + "source": [ + "%%js\n", + "var hello = \"Hello World\";\n", + "\n", + "// useful functions to make string lowercase or uppercase\n", + "console.log(\"string convert to upper case: hello toUpperCase\")\n", + "console.log(hello.toUpperCase())\n", + "console.log(\"string convert to lower case: hello toLowerCase\")\n", + "console.log(hello.toLowerCase())" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## .includes()" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "vscode": { + "languageId": "javascript" + } + }, + "outputs": [], + "source": [ + "%%js\n", + "var hello = \"Hello World\";\n", + "\n", + "// useful function to check if one string is contained in another\n", + "console.log(\"string includes: hello includes Rohan\")\n", + "console.log(hello.includes(\"Rohan\"))\n", + "console.log(\"string includes: hello includes Hello\")\n", + "console.log(hello.includes(\"Hello\"))" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# number datatype\n", + "- we discussed that numbers store numbers\n", + "- here are some useful ideas in javascript to deal with numbers" + ] + }, + { + "cell_type": "code", + "execution_count": 2, + "metadata": { + "vscode": { + "languageId": "javascript" + } + }, + "outputs": [ + { + "data": { + "text/html": [ + "\n" + ], + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "%%js\n", + "console.log(\"Numbers info\")\n", + "\n", + "// assign numbers to varialbes\n", + "console.log(\"variable: num1\")\n", + "var num1 = 9\n", + "console.log(num1)\n", + "console.log(\"variable: num2\")\n", + "var num2 = 6\n", + "console.log(num2)\n", + "\n", + "\n", + "// simple operations with numbers\n", + "console.log(\"Operations\")\n", + "console.log(\"subtract: num1 - num2\")\n", + "console.log(num1 - num2)\n", + "console.log(\"add: num1 + num2\")\n", + "console.log(num1 + num2)\n", + "console.log(\"divide: num1 / num2\")\n", + "console.log(num1 / num2)\n", + "console.log(\"multiply: num1 * num2\")\n", + "console.log(num1 * num2)\n", + "console.log(\"remainder (modulo): num1 % num2\")\n", + "console.log(num1 % num2)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# number formatting" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "vscode": { + "languageId": "javascript" + } + }, + "outputs": [], + "source": [ + "%%js\n", + "console.log(\"variable: num1\")\n", + "var num1 = 9\n", + "console.log(num1)\n", + "console.log(\"variable: num2\")\n", + "var num2 = 6\n", + "console.log(num2)\n", + "\n", + "// converting numbers to text\n", + "console.log(\"number convert string: num1\")\n", + "console.log(num1.toString())\n", + "\n", + "// rounding a number\n", + "console.log(\"round(num1 / num2)\")\n", + "console.log(Math.round(num1 / num2))\n", + "\n", + "// rounding a number to decimal palces\n", + "console.log(\"set decimals to 2 places (num1 / num2)\")\n", + "console.log((num1 / num2).toFixed(2))" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Array datatype\n", + "- an array is just a list of other datatypes\n", + "- put all the items in square brackets\n", + "- some useful methods below" + ] + }, + { + "cell_type": "code", + "execution_count": 13, + "metadata": { + "vscode": { + "languageId": "javascript" + } + }, + "outputs": [ + { + "data": { + "text/html": [ + "\n", + "\n" + ], + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "%%js\n", + "console.log(\"Array: assigning a list of strings\")\n", + "var str1 = \"1st string\"\n", + "var arr_data = [str1, \"2nd string\", \"3rd string\"]\n", + "// seeing what is in the array\n", + "console.log(arr_data)\n", + "\n", + "// getting one thing from an array\n", + "// \"A string\" \"Other Data\" \"more data\"\n", + "// 0 1 2\n", + "console.log(\"Array: referencing a cell #1\")\n", + "console.log([ arr_data[1] ]) // zero based counting: 1 is 2nd cell\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# array manipulation" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "vscode": { + "languageId": "javascript" + } + }, + "outputs": [], + "source": [ + "%%js\n", + "console.log(\"Array: assigning a list of strings\")\n", + "var str1 = \"1st string\"\n", + "var arr_data = [str1, \"2nd string\", \"3rd string\"]\n", + "// seeing what is in the array\n", + "console.log(arr_data)\n", + "\n", + "// adding something new to the array\n", + "console.log(\"Array: adding to list\")\n", + "arr_data.push(\"4th string\")\n", + "console.log(arr_data)\n", + "\n", + "// removing the first element of array\n", + "console.log(\"Array: removing from front of list\")\n", + "arr_data.shift()\n", + "console.log(arr_data)\n", + "\n", + "// removing the last element of array\n", + "console.log(\"Array: removing from end of list\")\n", + "arr_data.pop()\n", + "console.log(arr_data)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Object datatype\n", + "\n", + "- store records as key-value pairs\n", + "- are defined by enclosing data in curly braces `{}`\n", + "- allow access and modification using dot `.` or square bracket `[]` notation" + ] + }, + { + "cell_type": "code", + "execution_count": 18, + "metadata": { + "vscode": { + "languageId": "javascript" + } + }, + "outputs": [ + { + "data": { + "text/html": [ + "\n" + ], + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "%%js\n", + "console.log(\"Object: assigning key-value objects\")\n", + "var obj = {\n", + " name: \"Safin\",\n", + " age: 13\n", + "};\n", + "\n", + "// The following is stored in the object called \"obj\"\n", + "// {\n", + "// name: \"Safin\",\n", + "// age: 13\n", + "// }\n", + "//\n", + "// The key \"name\" is associated with the string value \"Safin\"\n", + "// The key \"age\" is associated with the number value 13\n", + "// Notice that keys are of the type \"string\"\n", + "\n", + "// print obj to the console\n", + "console.log(obj);\n", + "// -> { name: 'Safin', age: 13 }\n", + "// Notice that single quotes ' and double quotes \" can be used interchangeably" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# object access" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "vscode": { + "languageId": "javascript" + } + }, + "outputs": [], + "source": [ + "%%js\n", + "console.log(\"Object: assigning key-value objects\")\n", + "var obj = {\n", + " name: \"Safin\",\n", + " age: 13\n", + "};\n", + "\n", + "// The following is stored in the object called \"obj\"\n", + "// {\n", + "// name: \"Safin\",\n", + "// age: 13\n", + "// }\n", + "//\n", + "// The key \"name\" is associated with the string value \"Safin\"\n", + "// The key \"age\" is associated with the number value 13\n", + "// Notice that keys are of the type \"string\"\n", + "\n", + "// print obj to the console\n", + "console.log(obj);\n", + "// -> { name: 'Safin', age: 13 }\n", + "// Notice that single quotes ' and double quotes \" can be used interchangeably\n", + "\n", + "// To access certain values within an object, also known as an object's fields,\n", + "// you can use the name of the object suffixed with a dot and the name of the field\n", + "// or using the square bracket notation shown below\n", + "console.log(\"Object: using key name to access the name value (key notation)\")\n", + "console.log(obj[\"name\"]);\n", + "console.log(\"Object: using key name to access the name value (dot notation)\")\n", + "console.log(obj.name);\n", + "// -> Safin\n", + "\n", + "// Fields of an object can be manipulated similar to variables\n", + "console.log(\"Object: mutating the key name from Safin to John\")\n", + "obj.name = \"John\"\n", + "console.log(obj);\n", + "console.log(obj.name);\n", + "// -> John\n", + "\n", + "// A key-value pair can be added to the object\n", + "console.log(\"Object: mutating the key name from Safin to John\")\n", + "obj[\"ghid\"] = \"jm1021\"\n", + "console.log(obj);\n", + "// Observe new key" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Hacks\n", + "Create a JavaScript snippet below with the following requirements:\n", + "- Create an object representing yourself as a person. The object should have keys for your name, age, current classes, interests, and two more of your choosing\n", + "- Your object must contain keys whose values are arrays. The arrays can be arrays of strings, numbers, or even other objects if you would like\n", + "- Print the entire object with console.log after declaring it\n", + "- Manipulate the arrays within the object and print the entire object with console.log as well as the specific changed key afterwards\n", + "- Perform mathematical operations on fields in your object such as +, -, /, % etc. and print the results with console.log along with a message contextualizing them\n", + "- Use typeof to determine the types of at least 3 fields in your object" + ] + }, + { + "cell_type": "code", + "execution_count": 2, + "metadata": { + "vscode": { + "languageId": "javascript" + } + }, + "outputs": [ + { + "data": { + "application/javascript": "// put your javascript code here (make sure to run it and check your outputs in the console)\n", + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "%%js\n", + "// put your javascript code here (make sure to run it and check your outputs in the console)" + ] + } + ], + "metadata": { + "kernelspec": { + "display_name": "Python 3 (ipykernel)", + "language": "python", + "name": "python3" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.9.12" + } + }, + "nbformat": 4, + "nbformat_minor": 4 +} diff --git a/_notebooks/2023-08-30-basics-js-with-html.ipynb b/_notebooks/2023-08-30-basics-js-with-html.ipynb new file mode 100644 index 000000000..8a39501bb --- /dev/null +++ b/_notebooks/2023-08-30-basics-js-with-html.ipynb @@ -0,0 +1,400 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "---\n", + "title: Using Javascript with HTML DOM\n", + "hide: True\n", + "description: A Tech Talk on how javascript can interact with HTML DOM\n", + "type: ccc\n", + "permalink: /basics/dom\n", + "author: Rohan Juneja\n", + "---" + ] + }, + { + "cell_type": "raw", + "metadata": {}, + "source": [ + "{% include nav_basics.html %}\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "# Following along\n", + "Remember to \"git pull\" on teacher repository to update to lates.\n", + "- Run this notebook in VSCode\n", + "- Activate Help-Toogel Developer Tools to add console outputs to runtime experience" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Referencing HTML elements using javascript\n", + "- To get an HTML element, use ``document.getElementById(\"idTag\")``\n", + "- You will use the ID that you set in your HTML\n", + "- if you `console.log` the resulting variable you will get some information about the element" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "%%html\n", + "\n", + "

My Title

\n", + "\n", + "\n", + "" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Getting the data within the HTML element\n", + "- The variable titleElement stores the \"object\"\n", + "- Basically think of this as the group of data enclosed in HTML tag\n", + "- To access a certain type of data from an \"object\" we use \".\" notation\n", + " - .innerHTML gets data within center of tag" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "%%html\n", + "\n", + "

My Title

\n", + "\n", + "\n", + "" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Setting the data within the HTML Element\n", + "- The innerHTML data in this \"object\" can be set like a variable\n", + " - Change the value of the innerHTML using the \"=\" (assignment) operator" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "%%html\n", + "\n", + "

My Title

\n", + "\n", + "\n", + "" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Creating elements\n", + "- Create a new element with the document.createElement function -> takes in the type of element\n", + "- Set properties in the element just like the \"h1\" example" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "%%html\n", + "\n", + "
\n", + "

My Title

\n", + "
\n", + "\n", + "\n", + "" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Issue! How to Create element that appears in HTML?\n", + "- Here is a visualization of what is happening => the \"p\" is not placed inside the HRML page!\n", + "![visual on p tag floating]({{ site.baseurl }}/images/dom-visual-1.png)\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Solution\n", + "- Correct by placeing the element somewhere in the page\n", + "- For example, we could add the element within the div\n", + " - For this, use the appendChild function on the div object (the parameter would be the p element we created)\n", + " - Remember, use the getELementById to get the object for something in the html (the div!)\n", + "- Updated Diagram\n", + "![visual on p tag in div]({{ site.baseurl }}/images/dom-visual-2.png)" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "%%html\n", + "\n", + "
\n", + "

My Title

\n", + "
\n", + "\n", + "\n", + "" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Functions in JavaScript, using with DOM\n", + "- Functions allow you to \"do something\"\n", + " - ex. \"eat food\" in a Snake Game\n", + "- Functions were used in previous examples\n", + " - console.log = \"print something\"\n", + " - document.getElementById = \"find an element with id\"\n", + "- Functions take in parameters, what to do (inside the parenthesis)\n", + " - the parameter tells console.log what to print\n", + " - the parameter in document.getElementById tells the id of the element\n", + "- Functions can be used with DOM as well, thes will be shown below" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Creeating functions\n", + "- document functions functions were used to create a lot of functionality, but how can a developer create their own?\n", + "- function are useful to avoid writing the same code over and over again\n", + "- function can contain parameters for input (they effectively become variables)\n", + "- function can contain a return, the are the \"output\" of the function" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "%%html\n", + "\n", + "
\n", + "

My Title

\n", + "
\n", + "\n", + "\n", + "" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# OnClick Event\n", + "- Run a function when an event occurs\n", + " - In this case, the p tag is created when the button is clicked" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "%%html\n", + "\n", + "\n", + "\n", + "
\n", + "

My Title

\n", + "
\n", + "\n", + "\n", + "" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Hacks\n", + "- Copy your HTML code from the HTML hacks. Write a Javascript snippet to switch the links of the two a tags when a button is pressed. Once they are switched, change the inner HTML of the top p tag to the word \"switched!\"" + ] + }, + { + "cell_type": "code", + "execution_count": 3, + "metadata": { + "vscode": { + "languageId": "html" + } + }, + "outputs": [ + { + "data": { + "text/html": [ + "\n", + "\n", + "\n" + ], + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "%%html\n", + "\n", + "\n", + "" + ] + } + ], + "metadata": { + "kernelspec": { + "display_name": "Python 3", + "language": "python", + "name": "python3" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.9.12" + }, + "orig_nbformat": 4 + }, + "nbformat": 4, + "nbformat_minor": 2 +} diff --git a/_notebooks/2023-09-20-1_4-js-errors.ipynb b/_notebooks/2023-09-20-1_4-js-errors.ipynb new file mode 100644 index 000000000..fc5968b77 --- /dev/null +++ b/_notebooks/2023-09-20-1_4-js-errors.ipynb @@ -0,0 +1,314 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "---\n", + "layout: post\n", + "title: 1.4 Correcting errors\n", + "description: Practice with identifying and correcting code blocks\n", + "type: ccc\n", + "author: Safin Singh and Rohan Juneja\n", + "permalink: /basics/js-debug\n", + "hide: True\n", + "---" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "{% include nav_basics.html %}" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "[College Board Big Idea 1](https://apclassroom.collegeboard.org/103/home?unit=1)\n", + "\n", + "## Identifying and Correcting Errors (Unit 1.4)\n", + "\n", + "> Become familiar with types of errors and strategies for fixing them\n", + "\n", + "- Review CollegeBoard videos and take notes on blog\n", + "- Complete assigned MCQ questions if applicable" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Code Segments\n", + "\n", + "Practice fixing the following code segments!" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Segment 1: Alphabet List\n", + "\n", + "Intended behavior: create a list of characters from the string contained in the variable `alphabet`\n", + "\n", + "### Code:" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "vscode": { + "languageId": "javascript" + } + }, + "outputs": [], + "source": [ + "%%js\n", + "\n", + "var alphabet = \"abcdefghijklmnopqrstuvwxyz\";\n", + "var alphabetList = [];\n", + "\n", + "for (var i = 0; i < 10; i++) {\n", + "\talphabetList.push(i);\n", + "}\n", + "\n", + "console.log(alphabetList);" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### What I Changed\n", + "\n", + "I changed..." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Segment 2: Numbered Alphabet\n", + "\n", + "Intended behavior: print the number of a given alphabet letter within the alphabet. For example:\n", + "```\n", + "\"_\" is letter number _ in the alphabet\n", + "```\n", + "\n", + "Where the underscores (_) are replaced with the letter and the position of that letter within the alphabet (e.g. a=1, b=2, etc.)\n", + "\n", + "### Code:" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "vscode": { + "languageId": "javascript" + } + }, + "outputs": [], + "source": [ + "%%js\n", + "\n", + "// Copy your previous code to built alphabetList here\n", + "\n", + "let letterNumber = 5\n", + "\n", + "for (var i = 0; i < alphabetList; i++) {\n", + "\tif (i === letterNumber) {\n", + "\t\tconsole.log(letterNumber + \" is letter number 1 in the alphabet\")\n", + "\t}\n", + "}\n", + "\n", + "// Should output:\n", + "// \"e\" is letter number 5 in the alphabet" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### What I Changed\n", + "\n", + "I changed..." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Segment 3: Odd Numbers\n", + "\n", + "Intended behavior: print a list of all the odd numbers below 10\n", + "\n", + "### Code:" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "vscode": { + "languageId": "javascript" + } + }, + "outputs": [], + "source": [ + "%%js\n", + "\n", + "let evens = [];\n", + "let i = 0;\n", + "\n", + "while (i <= 10) {\n", + " evens.push(i);\n", + " i += 2;\n", + "}\n", + "\n", + "console.log(evens);" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### What I Changed\n", + "\n", + "I changed..." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# BELOW NOT EDITED" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The intended outcome is printing a number between 1 and 100 once, if it is a multiple of 2 or 5 \n", + "- What values are outputted incorrectly. Why?\n", + "- Make changes to get the intended outcome." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "vscode": { + "languageId": "javascript" + } + }, + "outputs": [], + "source": [ + "%%js\n", + "\n", + "var numbers = []\n", + "var newNumbers = []\n", + "var i = 0\n", + "\n", + "while (i < 100) {\n", + " numbers.push(i)\n", + " i += 1\n", + "}\n", + "for (var i of numbers) {\n", + " if (numbers[i] % 5 === 0)\n", + " newNumbers.push(numbers[i])\n", + " if (numbers[i] % 2 === 0)\n", + " newNumbers.push(numbers[i])\n", + "}\n", + "console.log(newNumbers) \n", + "\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Challenge\n", + "\n", + "This code segment is at a very early stage of implementation.\n", + "- What are some ways to (user) error proof this code?\n", + "- The code should be able to calculate the cost of the meal of the user\n", + "\n", + "Hint:\n", + "- write a “single” test describing an expectation of the program of the program\n", + "- test - input burger, expect output of burger price\n", + "- run the test, which should fail because the program lacks that feature\n", + "- write “just enough” code, the simplest possible, to make the test pass\n", + "\n", + "Then repeat this process until you get program working like you want it to work." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "vscode": { + "languageId": "javascript" + } + }, + "outputs": [], + "source": [ + "%%js\n", + "\n", + "var menu = {\"burger\": 3.99,\n", + " \"fries\": 1.99,\n", + " \"drink\": 0.99}\n", + "var total = 0\n", + "\n", + "//shows the user the menu and prompts them to select an item\n", + "console.log(\"Menu\")\n", + "for (var item in menu) {\n", + " console.log(item + \" $\" + menu[item].toFixed(2)) //why is toFixed used?\n", + "}\n", + "//ideally the code should support mutliple items\n", + "var item = \"burger\"\n", + "\n", + "//code should add the price of the menu items selected by the user \n", + "console.log(total)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Hacks\n", + "- Fix the errors in the first three segments in this notebook and say what you changed in the code cell under \"What I Changed\" (Challenge is optional)" + ] + } + ], + "metadata": { + "kernelspec": { + "display_name": "Python 3.10.6 64-bit", + "language": "python", + "name": "python3" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.11.4" + }, + "orig_nbformat": 4, + "vscode": { + "interpreter": { + "hash": "aee8b7b246df8f9039afb4144a1f6fd8d2ca17a180786b69acc140d282b71a49" + } + } + }, + "nbformat": 4, + "nbformat_minor": 2 +} From 4406ef4943392501c547a99ca3e56e15efe1d56f Mon Sep 17 00:00:00 2001 From: sooctosnake Date: Wed, 27 Sep 2023 23:12:36 -0700 Subject: [PATCH 11/27] added html and js --- _includes/nav_basics.html | 11 + _posts/2023-09-27-survey.ipynb | 277 ++++++++++++++++++ .../__pycache__/_virtualenv.cpython-38.pyc | Bin 3966 -> 3966 bytes 3 files changed, 288 insertions(+) create mode 100644 _includes/nav_basics.html create mode 100644 _posts/2023-09-27-survey.ipynb diff --git a/_includes/nav_basics.html b/_includes/nav_basics.html new file mode 100644 index 000000000..252df971f --- /dev/null +++ b/_includes/nav_basics.html @@ -0,0 +1,11 @@ + + + + + + + + + + +
HomeHTMLData TypesDOMJavaScriptJS Debugging
\ No newline at end of file diff --git a/_posts/2023-09-27-survey.ipynb b/_posts/2023-09-27-survey.ipynb new file mode 100644 index 000000000..be8952926 --- /dev/null +++ b/_posts/2023-09-27-survey.ipynb @@ -0,0 +1,277 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# This is a HTML Program that takes the Survey on the Exercise of a Person\n", + "\n", + "## This uses input and output and employs a type of exception handling for unfilled missing answers" + ] + }, + { + "cell_type": "code", + "execution_count": 1, + "metadata": {}, + "outputs": [ + { + "data": { + "text/html": [ + "\n", + "\n", + "\n", + " \n", + " Exercise Survey\n", + "\n", + "\n", + "

Exercise Habits Survey

\n", + "

Please take a moment to answer the following questions about your exercise routine.

\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" + ], + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "%%html\n", + "\n", + "\n", + "\n", + " \n", + " Exercise Survey\n", + "\n", + "\n", + "

Exercise Habits Survey

\n", + "

Please take a moment to answer the following questions about your exercise routine.

\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" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# 8" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "%%thml\n", + "\n", + "\n", + " \n", + " US State Capitals\n", + "\n", + "\n", + "

US State Capitals Lookup

\n", + "

Enter a state name to find its capital. Be sure to enter in all lowercase letters:

\n", + "\n", + "
\n", + " \n", + " \n", + " \n", + "
\n", + "\n", + "
\n", + "\n", + " \n", + "\n", + "\n" + ] + } + ], + "metadata": { + "kernelspec": { + "display_name": "Python 3", + "language": "python", + "name": "python3" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.8.10" + }, + "orig_nbformat": 4 + }, + "nbformat": 4, + "nbformat_minor": 2 +} diff --git a/venv/lib/python3.8/site-packages/__pycache__/_virtualenv.cpython-38.pyc b/venv/lib/python3.8/site-packages/__pycache__/_virtualenv.cpython-38.pyc index d1c04b3e3fe12f2eb46fedb6e19e9516a169f2f3..32d984471e1254b51614787b7358ab9c5a0d9407 100644 GIT binary patch delta 20 acmew-_fL*Hl$V!_0SJtqi)`dB<_7>ghy^GB delta 20 acmew-_fL*Hl$V!_0SKJ97&dYj^8)}kW&}q7 From 85ce90fa8c4f21ad5034e7bdaa17653746a24708 Mon Sep 17 00:00:00 2001 From: sooctosnake Date: Wed, 27 Sep 2023 23:13:49 -0700 Subject: [PATCH 12/27] fixed make and added html and js cod in ipynb --- _notebooks/2023-08-28-basics-html.ipynb | 2 +- _posts/2023-09-27-survey.ipynb | 106 +++++++++++++++++- .../pip/__pycache__/__init__.cpython-38.pyc | Bin 658 -> 658 bytes .../pip/__pycache__/__main__.cpython-38.pyc | Bin 451 -> 451 bytes .../__pycache__/__init__.cpython-38.pyc | Bin 707 -> 707 bytes .../__pycache__/build_env.cpython-38.pyc | Bin 7512 -> 7512 bytes .../__pycache__/configuration.cpython-38.pyc | Bin 10674 -> 10674 bytes .../__pycache__/exceptions.cpython-38.pyc | Bin 12511 -> 12511 bytes .../__pycache__/legacy_resolve.cpython-38.pyc | Bin 9927 -> 9927 bytes .../__pycache__/locations.cpython-38.pyc | Bin 4521 -> 4521 bytes .../__pycache__/pep425tags.cpython-38.pyc | Bin 3613 -> 3613 bytes .../__pycache__/pyproject.cpython-38.pyc | Bin 3761 -> 3761 bytes .../self_outdated_check.cpython-38.pyc | Bin 5522 -> 5522 bytes .../cli/__pycache__/__init__.cpython-38.pyc | Bin 265 -> 265 bytes .../__pycache__/autocompletion.cpython-38.pyc | Bin 4982 -> 4982 bytes .../__pycache__/base_command.cpython-38.pyc | Bin 5876 -> 5876 bytes .../cli/__pycache__/cmdoptions.cpython-38.pyc | Bin 20357 -> 20357 bytes .../command_context.cpython-38.pyc | Bin 1340 -> 1340 bytes .../cli/__pycache__/main.cpython-38.pyc | Bin 1435 -> 1435 bytes .../__pycache__/main_parser.cpython-38.pyc | Bin 2188 -> 2188 bytes .../cli/__pycache__/parser.cpython-38.pyc | Bin 9006 -> 9006 bytes .../__pycache__/req_command.cpython-38.pyc | Bin 8318 -> 8318 bytes .../__pycache__/status_codes.cpython-38.pyc | Bin 394 -> 394 bytes .../__pycache__/__init__.cpython-38.pyc | Bin 2881 -> 2881 bytes .../commands/__pycache__/list.cpython-38.pyc | Bin 9071 -> 9071 bytes .../__pycache__/__init__.cpython-38.pyc | Bin 841 -> 841 bytes .../__pycache__/base.cpython-38.pyc | Bin 1957 -> 1957 bytes .../__pycache__/installed.cpython-38.pyc | Bin 1237 -> 1237 bytes .../__pycache__/sdist.cpython-38.pyc | Bin 3500 -> 3500 bytes .../__pycache__/wheel.cpython-38.pyc | Bin 1589 -> 1589 bytes .../index/__pycache__/__init__.cpython-38.pyc | Bin 219 -> 219 bytes .../__pycache__/collector.cpython-38.pyc | Bin 14185 -> 14185 bytes .../__pycache__/package_finder.cpython-38.pyc | Bin 25778 -> 25778 bytes .../__pycache__/__init__.cpython-38.pyc | Bin 253 -> 253 bytes .../__pycache__/candidate.cpython-38.pyc | Bin 1450 -> 1450 bytes .../__pycache__/format_control.cpython-38.pyc | Bin 2445 -> 2445 bytes .../models/__pycache__/index.cpython-38.pyc | Bin 1175 -> 1175 bytes .../models/__pycache__/link.cpython-38.pyc | Bin 6688 -> 6688 bytes .../models/__pycache__/scheme.cpython-38.pyc | Bin 891 -> 891 bytes .../__pycache__/search_scope.cpython-38.pyc | Bin 3282 -> 3282 bytes .../selection_prefs.cpython-38.pyc | Bin 1625 -> 1625 bytes .../__pycache__/target_python.cpython-38.pyc | Bin 3248 -> 3248 bytes .../models/__pycache__/wheel.cpython-38.pyc | Bin 3236 -> 3236 bytes .../__pycache__/__init__.cpython-38.pyc | Bin 241 -> 241 bytes .../network/__pycache__/auth.cpython-38.pyc | Bin 7007 -> 7007 bytes .../network/__pycache__/cache.cpython-38.pyc | Bin 2720 -> 2720 bytes .../__pycache__/download.cpython-38.pyc | Bin 4399 -> 4399 bytes .../__pycache__/session.cpython-38.pyc | Bin 8880 -> 8880 bytes .../network/__pycache__/utils.cpython-38.pyc | Bin 735 -> 735 bytes .../__pycache__/__init__.cpython-38.pyc | Bin 189 -> 189 bytes .../__pycache__/prepare.cpython-38.pyc | Bin 11191 -> 11191 bytes .../build/__pycache__/__init__.cpython-38.pyc | Bin 195 -> 195 bytes .../build/__pycache__/metadata.cpython-38.pyc | Bin 1237 -> 1237 bytes .../metadata_legacy.cpython-38.pyc | Bin 3297 -> 3297 bytes .../__pycache__/__init__.cpython-38.pyc | Bin 253 -> 253 bytes .../editable_legacy.cpython-38.pyc | Bin 1331 -> 1331 bytes .../install/__pycache__/legacy.cpython-38.pyc | Bin 3077 -> 3077 bytes .../install/__pycache__/wheel.cpython-38.pyc | Bin 14611 -> 14611 bytes .../req/__pycache__/__init__.cpython-38.pyc | Bin 2223 -> 2223 bytes .../__pycache__/constructors.cpython-38.pyc | Bin 10392 -> 10392 bytes .../req/__pycache__/req_file.cpython-38.pyc | Bin 12731 -> 12731 bytes .../__pycache__/req_install.cpython-38.pyc | Bin 21367 -> 21367 bytes .../req/__pycache__/req_set.cpython-38.pyc | Bin 6050 -> 6050 bytes .../__pycache__/req_uninstall.cpython-38.pyc | Bin 17456 -> 17456 bytes .../utils/__pycache__/__init__.cpython-38.pyc | Bin 184 -> 184 bytes .../utils/__pycache__/appdirs.cpython-38.pyc | Bin 1380 -> 1380 bytes .../utils/__pycache__/compat.cpython-38.pyc | Bin 6149 -> 6149 bytes .../__pycache__/deprecation.cpython-38.pyc | Bin 2855 -> 2855 bytes .../utils/__pycache__/encoding.cpython-38.pyc | Bin 1276 -> 1276 bytes .../__pycache__/filesystem.cpython-38.pyc | Bin 4064 -> 4064 bytes .../__pycache__/filetypes.cpython-38.pyc | Bin 585 -> 585 bytes .../utils/__pycache__/glibc.cpython-38.pyc | Bin 1737 -> 1737 bytes .../utils/__pycache__/hashes.cpython-38.pyc | Bin 4173 -> 4173 bytes .../inject_securetransport.cpython-38.pyc | Bin 961 -> 961 bytes .../utils/__pycache__/logging.cpython-38.pyc | Bin 9188 -> 9188 bytes .../__pycache__/marker_files.cpython-38.pyc | Bin 957 -> 957 bytes .../utils/__pycache__/misc.cpython-38.pyc | Bin 23807 -> 23807 bytes .../utils/__pycache__/models.cpython-38.pyc | Bin 1953 -> 1953 bytes .../__pycache__/packaging.cpython-38.pyc | Bin 2637 -> 2637 bytes .../__pycache__/pkg_resources.cpython-38.pyc | Bin 1851 -> 1851 bytes .../setuptools_build.cpython-38.pyc | Bin 2956 -> 2956 bytes .../__pycache__/subprocess.cpython-38.pyc | Bin 5627 -> 5627 bytes .../utils/__pycache__/temp_dir.cpython-38.pyc | Bin 6740 -> 6740 bytes .../utils/__pycache__/typing.cpython-38.pyc | Bin 1466 -> 1466 bytes .../utils/__pycache__/ui.cpython-38.pyc | Bin 11831 -> 11831 bytes .../__pycache__/unpacking.cpython-38.pyc | Bin 6104 -> 6104 bytes .../utils/__pycache__/urls.cpython-38.pyc | Bin 1494 -> 1494 bytes .../__pycache__/virtualenv.cpython-38.pyc | Bin 3309 -> 3309 bytes .../utils/__pycache__/wheel.cpython-38.pyc | Bin 6354 -> 6354 bytes .../vcs/__pycache__/__init__.cpython-38.pyc | Bin 477 -> 477 bytes .../vcs/__pycache__/bazaar.cpython-38.pyc | Bin 3776 -> 3776 bytes .../vcs/__pycache__/git.cpython-38.pyc | Bin 9588 -> 9588 bytes .../vcs/__pycache__/mercurial.cpython-38.pyc | Bin 4917 -> 4917 bytes .../vcs/__pycache__/subversion.cpython-38.pyc | Bin 8516 -> 8516 bytes .../__pycache__/versioncontrol.cpython-38.pyc | Bin 19245 -> 19245 bytes .../__pycache__/__init__.cpython-38.pyc | Bin 3066 -> 3066 bytes 96 files changed, 106 insertions(+), 2 deletions(-) diff --git a/_notebooks/2023-08-28-basics-html.ipynb b/_notebooks/2023-08-28-basics-html.ipynb index 73b855eec..290ce888b 100644 --- a/_notebooks/2023-08-28-basics-html.ipynb +++ b/_notebooks/2023-08-28-basics-html.ipynb @@ -279,7 +279,7 @@ "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", - "version": "3.9.12" + "version": "3.8.10" }, "orig_nbformat": 4 }, diff --git a/_posts/2023-09-27-survey.ipynb b/_posts/2023-09-27-survey.ipynb index be8952926..455907769 100644 --- a/_posts/2023-09-27-survey.ipynb +++ b/_posts/2023-09-27-survey.ipynb @@ -162,8 +162,112 @@ "execution_count": null, "metadata": {}, "outputs": [], + "source": [] + }, + { + "cell_type": "code", + "execution_count": 3, + "metadata": {}, + "outputs": [ + { + "data": { + "text/html": [ + "\n", + "\n", + " \n", + " US State Capitals\n", + "\n", + "\n", + "

US State Capitals Lookup

\n", + "

Enter a state name to find its capital. Be sure to enter in all lowercase letters:

\n", + "\n", + "
\n", + " \n", + " \n", + " \n", + "
\n", + "\n", + "
\n", + "\n", + " \n", + "\n", + "\n" + ], + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], "source": [ - "%%thml\n", + "%%html\n", "\n", "\n", " \n", diff --git a/venv/lib/python3.8/site-packages/pip/__pycache__/__init__.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/__pycache__/__init__.cpython-38.pyc index 7dde240ac82888f854d90d1a5c0ac5ffe6e26dbc..5f21a58837dc1fc2e05a09d0cb8162273cb73d4a 100644 GIT binary patch delta 20 acmbQlI*FA#l$V!_0SJtqi)`d>X955z7X&2$ delta 20 acmbQlI*FA#l$V!_0SKJ97&daZGXVf2^#eoz diff --git a/venv/lib/python3.8/site-packages/pip/__pycache__/__main__.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/__pycache__/__main__.cpython-38.pyc index b7119efac648ba8c3ed14cd78b6e0e417e7b6b2f..0493178571d902950f4adde3097d7eb1730563c2 100644 GIT binary patch delta 20 acmX@ie3+R#l$V!_0SJtqi)`fH!3Y2_b_BBk delta 20 acmX@ie3+R#l$V!_0SKJ97&db6U<3dwR0Glg diff --git a/venv/lib/python3.8/site-packages/pip/_internal/__pycache__/__init__.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/__pycache__/__init__.cpython-38.pyc index be0d257ee4e27cfe51ea8e9732b55e1f0ec5c46a..82d4fd7c61cbc8c3f99ae59509c9182322ba5003 100644 GIT binary patch delta 20 acmX@idYF|vl$V!_0SJtqi)`fH!2|#>zXZ4d delta 20 acmX@idYF|vl$V!_0SKJ97&db6U;+RuodeeZ diff --git a/venv/lib/python3.8/site-packages/pip/_internal/__pycache__/build_env.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/__pycache__/build_env.cpython-38.pyc index bcc30e3a372b43fdffbafa856a525890be75f5e0..6959465c846e51d77905f998f1da2f6cab648566 100644 GIT binary patch delta 20 acmca%b;F7~l$V!_0SJtqi)`ffl?4DgmIV9& delta 20 acmca%b;F7~l$V!_0SKJ97&dbI$^rm2bOaj! diff --git a/venv/lib/python3.8/site-packages/pip/_internal/__pycache__/configuration.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/__pycache__/configuration.cpython-38.pyc index ad899baee537ba6cecdaffed2708395c4adb0d38..79b8977237b6c2f980301734800248cb965f6951 100644 GIT binary patch delta 20 acmdlKyeXJFl$V!_0SJtqi)`dxt_c7+HU&rk delta 20 acmdlKyeXJFl$V!_0SKJ97&dY**8~7G6a;4g diff --git a/venv/lib/python3.8/site-packages/pip/_internal/__pycache__/exceptions.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/__pycache__/exceptions.cpython-38.pyc index 5359f43974dd4e830a617705599f6abbe8d5f512..e1ffa5db2486c862a0f5810bb84cf9a1117da9f7 100644 GIT binary patch delta 20 acmcbgct4Rll$V!_0SJtqi)`e+VgLX_Jq7Xr delta 20 acmcbgct4Rll$V!_0SKJ97&dZWF#rHP8wC*n diff --git a/venv/lib/python3.8/site-packages/pip/_internal/__pycache__/legacy_resolve.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/__pycache__/legacy_resolve.cpython-38.pyc index f28a3235ee121aa42d891e0edabe381425fca831..72b44e151230a501608a312939346b3c8a98e75d 100644 GIT binary patch delta 20 acmX@^d)${hl$V!_0SJtqi)`fHqXqywqXl>X delta 20 acmX@^d)${hl$V!_0SKJ97&db6Q3C)rfdrQT diff --git a/venv/lib/python3.8/site-packages/pip/_internal/__pycache__/locations.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/__pycache__/locations.cpython-38.pyc index 879548f13cc5374e2e7d5dd0debadee4eaebacef..9a4ff1bdfd54b664d0bab916ed6e900a30769aa8 100644 GIT binary patch delta 20 acmZ3fyi%Dvl$V!_0SJtqi)`ecCkOyA_5`&6 delta 20 acmZ3fyi%Dvl$V!_0SKJ97&dax69fP&)C1H2 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/__pycache__/pep425tags.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/__pycache__/pep425tags.cpython-38.pyc index d9f4f64b69ce42c2460bf9be1ccd865e4bd1ea88..4cafb7f69572cdba73f0347d08ec0ff45903ba79 100644 GIT binary patch delta 20 acmbO$GgpQ?l$V!_0SJtqi)`c;;sXFJ7X$zR delta 20 acmbO$GgpQ?l$V!_0SKJ97&dYX@c{rQ^#dOO diff --git a/venv/lib/python3.8/site-packages/pip/_internal/__pycache__/pyproject.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/__pycache__/pyproject.cpython-38.pyc index 131dbae6d195b3df2ff7ae985395c28ea3c86d10..b0885098152a0ecbc9c4f87447051f435e1ba54c 100644 GIT binary patch delta 20 acmdleyHS=ql$V!_0SJtqi)`dx#s>f~TLiuU delta 20 acmdleyHS=ql$V!_0SKJ97&dY*;{yOJIRo7Q diff --git a/venv/lib/python3.8/site-packages/pip/_internal/__pycache__/self_outdated_check.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/__pycache__/self_outdated_check.cpython-38.pyc index abcef538724b90c98901d09324a95ddc0aa39845..258bf139a3d28607699ef4b9d8052b0454cba791 100644 GIT binary patch delta 20 acmbQFJxQB8l$V!_0SJtqi)`d>7X<(=f&_#B delta 20 acmbQFJxQB8l$V!_0SKJ97&daZivj>CU<0E7 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/__init__.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/__init__.cpython-38.pyc index 63a9d901a8b19a926f333ef2daf3c977cb4499e6..db1e2e5d8cb61ed565e5c6e9c25238d5f380d053 100644 GIT binary patch delta 19 ZcmeBV>SW>$<>lpK00N`uA``j)0RSUk1Y!UH delta 19 YcmeBV>SW>$<>lpK00Jj2hKbz&03RL$fdBvi diff --git a/venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/autocompletion.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/autocompletion.cpython-38.pyc index 7c8b8925d439b1e33b0c003734fb60ad2f8c2b85..2127d4bd7df946c5ca93de09436dcf951f766945 100644 GIT binary patch delta 20 acmeyS_DzjDl$V!_0SJtqi)`f176t%3Yy~6$ delta 20 acmeyS_DzjDl$V!_0SKJ97&dZe3j+W*N(4gy diff --git a/venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/base_command.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/base_command.cpython-38.pyc index f168b87ea20b83dfb9d56b212d02ebd79e231498..a8cb6c9396235b626a7fb41bc659038e2e65d0d6 100644 GIT binary patch delta 20 acmeyO`$d;Kl$V!_0SJtqi)`e6DFy&O8wIZb delta 20 acmeyO`$d;Kl$V!_0SKJ97&dah6axS_`2@}Y diff --git a/venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/cmdoptions.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/cmdoptions.cpython-38.pyc index 327cb88db11219f7da97e16bed73a8d1afdb28ab..4c832f93dab4f27155373bfca5caabe1c6781618 100644 GIT binary patch delta 22 ccmZpj&)7Pjkvo)^mx}=ijGl{Z=ofdBvi delta 22 ccmZpj&)7Pjkvo)^mx}=ioVXY^a##5S06TRApa1{> diff --git a/venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/command_context.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/command_context.cpython-38.pyc index 9b0083238050321a58821fef3b56db192ad2e5fd..a983077b4b487382eb81482a810c9d835b50921b 100644 GIT binary patch delta 20 acmdnPwTFv4l$V!_0SJtqi)`dJWCZ{(UIZ`z delta 20 acmdnPwTFv4l$V!_0SKJ97&dYnvH}1qJOfVv diff --git a/venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/main.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/main.cpython-38.pyc index 39be8785f991cfef606e5e10c55f11d054e95096..4c385dc568bfd2c8d5aa17c53afebbf60e7a1445 100644 GIT binary patch delta 20 acmbQuJ)4_5l$V!_0SJtqi)`eczzP5>S_Dr3 delta 20 acmbQuJ)4_5l$V!_0SKJ97&dZGU=EP+<>lpK00N`uA{)6IIRGi$1Tg>r delta 20 ZcmeAX>=EP+<>lpK00Jj2hK<~f8~`M{15f|} diff --git a/venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/parser.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/parser.cpython-38.pyc index 961098eb951daadfa38ebde6179c115696589f9f..0ff654f5bc84542f400980c4d366fc5dbf34be44 100644 GIT binary patch delta 20 acmZ4Iw$6<^l$V!_0SJtqi)`dpRt5kyyab#8 delta 20 acmZ4Iw$6<^l$V!_0SKJ97&dY%D+2&9nghE4 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/req_command.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/req_command.cpython-38.pyc index 550c20bfd9c756fdfd44f083f2da62b76d153c41..d2b06790bf36ca3cd11fafddf1c977b6251f94c3 100644 GIT binary patch delta 20 acmez8@Xvuel$V!_0SJtqi)`dBRsaA&VFi5v delta 20 acmez8@Xvuel$V!_0SKJ97&dYjD*ymIKLnfr diff --git a/venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/status_codes.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/cli/__pycache__/status_codes.cpython-38.pyc index b55f38839004f330e684b0685245721737dde478..56a9275e6cd9c9496524b5c491638e6fe7bf135b 100644 GIT binary patch delta 20 ZcmeBT?qcQ+<>lpK00N`uA{)8u838Ab1PA~C delta 20 ZcmeBT?qcQ+<>lpK00Jj2hK=0yi~u5R11A6g diff --git a/venv/lib/python3.8/site-packages/pip/_internal/commands/__pycache__/__init__.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/commands/__pycache__/__init__.cpython-38.pyc index 4b952c41ee9fbce183587329c3c2da9dc99dc1d7..9f9854d67c171fa5c6100baa4a7adc81404c7129 100644 GIT binary patch delta 20 acmX>oc2JBvl$V!_0SJtqi)`dJ;|2gR+yq?! delta 20 acmX>oc2JBvl$V!_0SKJ97&da7aRUG>x&wRw diff --git a/venv/lib/python3.8/site-packages/pip/_internal/commands/__pycache__/list.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/commands/__pycache__/list.cpython-38.pyc index 5ed7e65d8f5dd49f3f0af36cbd1e3ff32f115a3d..cc3f71f03d8aa818fd4053fc6981833c3ab32741 100644 GIT binary patch delta 20 acmaFw_TG&< delta 20 acmaFw_TG&1d<1s@ delta 20 acmZ3=zm%Ull$V!_0SKJ97&daxVg~>yS_75< diff --git a/venv/lib/python3.8/site-packages/pip/_internal/distributions/__pycache__/installed.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/distributions/__pycache__/installed.cpython-38.pyc index 28a40c77294909bf0eeb82978e398100ca82ce01..25f7870600f189a40a71baa0030a455a4fdd60b1 100644 GIT binary patch delta 20 acmcc0d6knpl$V!_0SJtqi)`dR#R32{Aq4mU delta 20 acmcc0d6knpl$V!_0SKJ97&daBVgUdy{{$BR diff --git a/venv/lib/python3.8/site-packages/pip/_internal/distributions/__pycache__/sdist.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/distributions/__pycache__/sdist.cpython-38.pyc index 7c890ed04a410366216128144c8c8aa347962dbf..4535f995c1632d9754f792489f1abd833727d980 100644 GIT binary patch delta 20 acmZ1@y+)cll$V!_0SJtqi)`dx$O`~4N(8C^ delta 20 acmZ1@y+)cll$V!_0SKJ97&dY*k-nZ3905 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/index/__pycache__/__init__.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/index/__pycache__/__init__.cpython-38.pyc index b18404cc4e3ca594d60747ede59adb18006beebc..d30396d20c534ce396e939d868e943a628b00f69 100644 GIT binary patch delta 19 Zcmcc3c$<+sl$V!_0SJtqi%jIc001tR1l9lm delta 19 Zcmcc3c$<+sl$V!_0SKJ97$$OG001gh1N8s^ diff --git a/venv/lib/python3.8/site-packages/pip/_internal/index/__pycache__/collector.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/index/__pycache__/collector.cpython-38.pyc index 4168cfec7bbcb8381c6e8b4813215412a16b82c9..945dcdf40d5c795756907f6734a6497540f6d0fa 100644 GIT binary patch delta 38 qcmaEv_cD(=l$V!_0SJtqi)`e6!o|aqQBqQHixor`Z~o1drvm`-F%3Qd delta 38 qcmaEv_cD(=l$V!_0SKJ97&dZ0;o@Pb8FnTVsk$ZUx08XI>aR2}S delta 22 ccmdmVl5x{XM($8vUM>b8aN=Uv$h|xT07-uZkN^Mx diff --git a/venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/__init__.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/__init__.cpython-38.pyc index 9dada3df41007a3032ab1761d33825b33450fe55..0469597c20fb5c9b452681255453abf49366ab18 100644 GIT binary patch delta 19 Zcmey%_?MA8l$V!_0SJtqi%jJH1OPLE1v~%% delta 19 Zcmey%_?MA8l$V!_0SKJ97$$Om0st>S1X}lpK00N`uA{)7zH~}h71UUcz delta 20 ZcmeAb?iJ<^<>lpK00Jj2hK<}!oB$;(16Tk6 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/index.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/index.cpython-38.pyc index eab64910cc8c7e3ff32ea2a023bb5a4a4dba04aa..ebe0610d28789767b49ee2133fde0223ee0b26b8 100644 GIT binary patch delta 20 acmbQvIh~U`l$V!_0SJtqi)`fXVF3UtaRfd9 delta 20 acmbQvIh~U`l$V!_0SKJ97&dbEumAuhPXk>5 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/link.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/link.cpython-38.pyc index ff74d3a1ab7915c766fdbdb32d7c74c858f1df52..8845be59b57f07d5f1e877f303eff4bc4977473b 100644 GIT binary patch delta 20 acmZ2rvcQBpl$V!_0SJtqi)`c;l>z`T`vgS* delta 20 acmZ2rvcQBpl$V!_0SKJ97&dZ?N&x^X*#l$% diff --git a/venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/scheme.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/scheme.cpython-38.pyc index 2c51156cb7ebdf936df1afa0ed6f95ce3e6b4898..67efec9c132ee4604849962dbd8d8c7fcb36ceb3 100644 GIT binary patch delta 20 acmey(_M446l$V!_0SJtqi)`dBUBp diff --git a/venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/search_scope.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/search_scope.cpython-38.pyc index 9ee100cdfe31736665c61279834e901eea1cb224..138b7b18b6c0b24d3c225bf9f585ff2c001051aa 100644 GIT binary patch delta 20 acmca4c}bExl$V!_0SJtqi)`dR&I157@dXzE delta 20 acmca4c}bExl$V!_0SKJ97&dYr=K%mP&jdCA diff --git a/venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/selection_prefs.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/selection_prefs.cpython-38.pyc index 9b44bc969b9643d379398636bdf11dd4e1550e01..d3fc35812dfec6e8b00526e766e10f4c9a429359 100644 GIT binary patch delta 20 acmcb~bCZWVl$V!_0SJtqi)`ffV*>y*F9eJL delta 20 acmcb~bCZWVl$V!_0SKJ97&dbIu>k-t4FjtH diff --git a/venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/target_python.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/models/__pycache__/target_python.cpython-38.pyc index 3a09855cc605ea1fc40997057cf7e2f94f76aa79..ae605490517915314905a98bd33668d13a0836b7 100644 GIT binary patch delta 20 acmdlWxj~XUl$V!_0SJtqi)`dx$^!r}p#-r2 delta 20 acmdlWxj~XUl$V!_0SKJ97&dY*qx2l$V!_0SJtqi%jHx1^_X|1sDJT delta 19 Zcmey!_>qx2l$V!_0SKJ97$$N*0{|_A1UCQx diff --git a/venv/lib/python3.8/site-packages/pip/_internal/network/__pycache__/auth.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/network/__pycache__/auth.cpython-38.pyc index 0616fd91449c29e55a24ab353313770caf7a4f18..9b199bc6cbd525526e24e66cb683bc3e24f2b35c 100644 GIT binary patch delta 20 acmca_cHfLUl$V!_0SJtqi)`c$kp=)e90dme delta 20 acmca_cHfLUl$V!_0SKJ97&dZ;NCN;h`UEBb diff --git a/venv/lib/python3.8/site-packages/pip/_internal/network/__pycache__/cache.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/network/__pycache__/cache.cpython-38.pyc index 1b9dd3c85362127639bd5367fa88aa1586cb2ef5..1a97fdde8addd0167d4f10f7fdcb66a570c19ba3 100644 GIT binary patch delta 20 acmZ1=x1dadz delta 19 ZcmX@ic$kqpl$V!_0SKJ97$$P>001W51FZl6 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/operations/build/__pycache__/metadata.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/operations/build/__pycache__/metadata.cpython-38.pyc index 36c8423ff0f220075c3498b448c7c062f2a60c98..a74d027090addffa4a8090376452480e48d70904 100644 GIT binary patch delta 20 acmcc0d6knpl$V!_0SJtqi)`dR#R32{Aq4mU delta 20 acmcc0d6knpl$V!_0SKJ97&daBVgUdy{{$BR diff --git a/venv/lib/python3.8/site-packages/pip/_internal/operations/build/__pycache__/metadata_legacy.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/operations/build/__pycache__/metadata_legacy.cpython-38.pyc index c0fdd9452d6e4988602e4482eef837536e70b563..27db409d3d251eb3f59c3167270d281f913bbe7b 100644 GIT binary patch delta 20 acmaDT`B0KOl$V!_0SJtqi)`e+#sdI2Nd-gz delta 20 acmaDT`B0KOl$V!_0SKJ97&dZW;{gCOCj?^v diff --git a/venv/lib/python3.8/site-packages/pip/_internal/operations/install/__pycache__/__init__.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/operations/install/__pycache__/__init__.cpython-38.pyc index 2ba18d92eb71ef418a8ffd129a4628af9a29d25b..4ddee57eb60d72f0426e7df360bcdcb63f5cbe15 100644 GIT binary patch delta 19 Zcmey%_?MA8l$V!_0SJtqi%jJH1OPLE1v~%% delta 19 Zcmey%_?MA8l$V!_0SKJ97$$Om0st>S1X}9G delta 20 acmdnYwV8`Ml$V!_0SKJ97&dZiumS)m)B`jC diff --git a/venv/lib/python3.8/site-packages/pip/_internal/operations/install/__pycache__/legacy.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/operations/install/__pycache__/legacy.cpython-38.pyc index 3630149feffe5fd261e9674af081c8b3876b7930..af2feae668f51e7b5d10f377287dc694a1a3b1c9 100644 GIT binary patch delta 20 acmZpbXqDg&<>lpK00N`uA{)7XaRUG<#00GX delta 20 ZcmZpbXqDg&<>lpK00Jj2hK=06xB(@i1Iz#b diff --git a/venv/lib/python3.8/site-packages/pip/_internal/operations/install/__pycache__/wheel.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/operations/install/__pycache__/wheel.cpython-38.pyc index c1356eb9f99a588244251c91f0a6c491176ac42f..7a5a75b7bcb279ece5d004756a6c29e4c620e1a8 100644 GIT binary patch delta 20 acmbPSG`Wa7l$V!_0SJtqi)`fPumk`%$^^Lp delta 20 acmbPSG`Wa7l$V!_0SKJ97&dZqSONetr~}vl diff --git a/venv/lib/python3.8/site-packages/pip/_internal/req/__pycache__/__init__.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/req/__pycache__/__init__.cpython-38.pyc index e78a2f089ad88c3dbba9a1cfd8e8c43ef6832bcf..0723e88352187ae83730a057ef05c389f6e76a56 100644 GIT binary patch delta 20 acmZ24xL%Mul$V!_0SJtqi)`dx!T|s;RRo#< delta 20 acmZ24xL%Mul$V!_0SKJ97&dY*;Q#b8FnTVsk-JZljoH@L_7~IU`I3d)Y_ovkMKd>xsV3?H06ydm A8~^|S delta 46 zcmeyqjPd(2M($8vUM>b8aN=Uv$lWK&#$;>zi`jPbe91y?wwXZjqFI~8R1@_8B_j+w diff --git a/venv/lib/python3.8/site-packages/pip/_internal/req/__pycache__/req_set.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/req/__pycache__/req_set.cpython-38.pyc index fed781a0609bb2e54d4b68dbf2355aaa0ff9c173..d353f95f6f77161f068f6eda8a26842730f98773 100644 GIT binary patch delta 20 acmZ3azet}ul$V!_0SJtqi)`ecE)D=Olmxy2 delta 20 acmZ3azet}ul$V!_0SKJ97&dZG7Y6_=as%A} diff --git a/venv/lib/python3.8/site-packages/pip/_internal/req/__pycache__/req_uninstall.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/req/__pycache__/req_uninstall.cpython-38.pyc index d281999f3e9ae5de8c230821bc8ca41b26009634..39b1a3b9783d40cc7719886fff3fa866d63e8e1b 100644 GIT binary patch delta 22 ccmdnc!MLG=kvo)^mx}=ijGl{Z delta 20 acmaFD^@NK%l$V!_0SKJ97&dZ8vH}1wd;`Y- diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/compat.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/compat.cpython-38.pyc index 15de5a86e959d4c329c4ec9621e4234a150b3fda..42dc17e6b5f18513ed74615cb05ba1a6413ed7ad 100644 GIT binary patch delta 20 acmZoQXf@yt<>lpK00N`uA{)7Xi30#GFa+rU delta 20 ZcmZoQXf@yt<>lpK00Jj2hK=06!~rP|1PA~C diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/deprecation.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/deprecation.cpython-38.pyc index 79f8699b6b62746688cd7f385b65e502495207cc..b15800b0feb199440db4e4a26f6d5c5f939911f2 100644 GIT binary patch delta 20 acmZ23wp@%ml$V!_0SJtqi)`eU;RXOL%mfbr delta 20 acmZ23wp@%ml$V!_0SKJ97&data037+ssky!u><`8 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/hashes.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/hashes.cpython-38.pyc index 65f2d825a807a065b8d42014d72e9852feb4ef4b..76382335281b5a58c4713cc09c394917751abd4f 100644 GIT binary patch delta 20 acmX@Ba8`jkl$V!_0SJtqi)`d}5&!@-DFm7T delta 20 acmX@Ba8`jkl$V!_0SKJ97&dY{2><{v2LrhP diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/inject_securetransport.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/inject_securetransport.cpython-38.pyc index 99e2b286fafa8045d223802665b8e147c59a1fad..351ce60f133c8ecb7cf86bbf1060a8198ae1c563 100644 GIT binary patch delta 20 acmX@eevq9zl$V!_0SJtqi)`fH#tZ;3xCFNV delta 20 acmX@eevq9zl$V!_0SKJ97&dZmV+H^#mIKxR diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/logging.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/logging.cpython-38.pyc index aea94167e968567f82b771ef69cc601e38e64624..d0acb6db5568685dd74b1a0ab126cf56b6084641 100644 GIT binary patch delta 20 acmaFj{=}U-l$V!_0SJtqi)`e+sSE%=PzAsM delta 20 acmaFj{=}U-l$V!_0SKJ97&da>R0aS#E(G5I diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/marker_files.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/marker_files.cpython-38.pyc index c9e9aa078d498e54b02d6591bd3c838f8be53424..2757d0fc8956a4477e761524e602954036185e31 100644 GIT binary patch delta 20 acmdnXzL%Xll$V!_0SJtqi)`fH#0&s17zC>T delta 20 acmdnXzL%Xll$V!_0SKJ97&dZmVg>*z_5;cQ diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/misc.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/misc.cpython-38.pyc index 14f66897a8cff61f7a99144f6993ae395c5e7d06..dd02df92c9e0c87466a99fc02d8b5a1b2974ee90 100644 GIT binary patch delta 22 ccmeyrlkxvfM($8vUM>b8FnTVsk^4&w09hCZFaQ7m delta 22 ccmeyrlkxvfM($8vUM>b8aN=Uv$o(Y-08{n`PXGV_ diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/models.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/models.cpython-38.pyc index 3e8c7be60e1c1dbbcf38b7c483df5f9e18c0d0f3..4f8b0faad3439bac1e1447ff8f1ce3ecb6ab6482 100644 GIT binary patch delta 20 acmZ3;zmT6hl$V!_0SJtqi)`ec#tr~1+yrX? delta 20 acmZ3;zmT6hl$V!_0SKJ97&dZGV+Q~yx&w*; diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/packaging.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/packaging.cpython-38.pyc index 53c52b5656d43e97264b356f907592bd99ec029c..8e9a19f6da361893ba75452e26220d776fcdf05c 100644 GIT binary patch delta 20 acmX>ra#n;pl$V!_0SJtqi)`d};sO9Oa|C<< delta 20 acmX>ra#n;pl$V!_0SKJ97&dY{aRC4>Q3IO* diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/pkg_resources.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/pkg_resources.cpython-38.pyc index e691bbd55d44cdfdb115402d93264fa15b3f55d0..b04de1cae7e514a0ed74c8d7e9b728eca8450c98 100644 GIT binary patch delta 20 acmdnZx0{bUl$V!_0SJtqi)`dJUlpK00N`uA{)6IxdAG;1V8`) delta 20 ZcmeAX?-Az?<>lpK00Jj2hK<~f+yEt(1783D diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/subprocess.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/subprocess.cpython-38.pyc index 42a0c8e84ad9e4e8f724401bd9944f372b259a47..82760318e66d74e7351c6a6ebb27af5c30bd5453 100644 GIT binary patch delta 20 acmeyZ{ac$ml$V!_0SJtqi)`fnAPN9J>IJ_5 delta 20 acmeyZ{ac$ml$V!_0SKJ97&dZ$5Cs4^$OPU1 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/temp_dir.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/temp_dir.cpython-38.pyc index f71bc7dd87e5de6d90bcf8a262fd50806927a4c3..9539296bb3816fed734f08f1fe5962c16ee8635b 100644 GIT binary patch delta 20 acmca&a>ax@l$V!_0SJtqi)`fflmY-b8wBA1 delta 20 acmca&a>ax@l$V!_0SKJ97&dZyN&x^f`2+v} diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/typing.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/typing.cpython-38.pyc index af2b2305d94dfa2c60056c0913f5a8f4963b4c9a..58de9b488008590c6ab12d2e000062b61c612507 100644 GIT binary patch delta 20 acmdnRy^EVWl$V!_0SJtqi)`dx&k6uAG6bvu delta 20 acmdnRy^EVWl$V!_0SKJ97&daRX9WN&5Ch8q diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/ui.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/ui.cpython-38.pyc index bccae28ac88f5f9d15f16b549b132559b1b2094d..b1546f9c4e2e7bdc956f8b2f835cb8fbb58ce778 100644 GIT binary patch delta 20 acmdlUvpt48l$V!_0SJtqi)`f9(E|WFM+EKw delta 20 acmdlUvpt48l$V!_0SKJ97&db2=m7vVB?Jus diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/unpacking.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/unpacking.cpython-38.pyc index df8625202348e11b1560a815ed743d8f768cd9de..9f357eb820bab9be6aca6a98156f0d80b646e382 100644 GIT binary patch delta 20 acmcbie?y-;l$V!_0SJtqi)`dRD-HlU1O;FK delta 20 acmcbie?y-;l$V!_0SKJ97&daB6$bz`;sk#H diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/urls.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/urls.cpython-38.pyc index 1d23e9f9e9135096a831917623081ea400931ad1..255e1ce0235361f52bbb639b0b4cc5de24963656 100644 GIT binary patch delta 20 acmcb{eT|ztl$V!_0SJtqi)`dR%?bcCk_7+& delta 20 acmcb{eT|ztl$V!_0SKJ97&daBW(5E*a0DL! diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/virtualenv.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/virtualenv.cpython-38.pyc index bc8f74e45b699745e7ba303eb44553a5c8768560..fc8275ae4a6186baab8b6e68612baa9d3192f7ba 100644 GIT binary patch delta 20 acmaDW`BsuUl$V!_0SJtqi)`e6!~+02DFtW% delta 20 acmaDW`BsuUl$V!_0SKJ97&dZ0;sF3P2Ly)z diff --git a/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/wheel.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/utils/__pycache__/wheel.cpython-38.pyc index d5d89efdf45550c1ab0d60358d05046ba6657f4e..cca03d4db5506b6201caee6a40b99a5abc0339b9 100644 GIT binary patch delta 20 acmca)c*&4El$V!_0SJtqi)`dRE&%{JT?JDB delta 20 acmca)c*&4El$V!_0SKJ97&dYrmjD1XI|On7 diff --git a/venv/lib/python3.8/site-packages/pip/_internal/vcs/__pycache__/__init__.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/vcs/__pycache__/__init__.cpython-38.pyc index a939282099ab570e53f871654b2848dae13ecc50..92c55019d7a613e592cf2bf78e52815d685ad534 100644 GIT binary patch delta 20 acmcc1e3zL!l$V!_0SJtqi)`e+#0UU1h6Mot delta 20 acmcc1e3zL!l$V!_0SKJ97&dZWVgvv$WCS1p diff --git a/venv/lib/python3.8/site-packages/pip/_internal/vcs/__pycache__/bazaar.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_internal/vcs/__pycache__/bazaar.cpython-38.pyc index 73caed47623715ca3c17403060566503ff37208a..9a66d8d24af77070c9bb038cd52df8ff2848a062 100644 GIT binary patch delta 20 acmX>gdq9>ul$V!_0SJtqi)`fH$_D^5vjpn^ delta 20 acmX>gdq9>ul$V!_0SKJ97&dZmb8FnTVskz2_d07UEsV*mgE delta 22 ccmZ2GjdATXM($8vUM>b8aN=Uv$gSiJ06)qEf&c&j diff --git a/venv/lib/python3.8/site-packages/pip/_vendor/__pycache__/__init__.cpython-38.pyc b/venv/lib/python3.8/site-packages/pip/_vendor/__pycache__/__init__.cpython-38.pyc index 8d4ef145499717c3c05150990e5045faa0b10181..a6aff783f9247bc2500540af62a442a7a378be51 100644 GIT binary patch delta 20 acmew*{!5%Yl$V!_0SJtqi)`e6&kX=O=mm-Z delta 20 acmew*{!5%Yl$V!_0SKJ97&dah=LP^a#ssMV From 722a576a92b54955db7ef1838079a6ca62a9860b Mon Sep 17 00:00:00 2001 From: sooctosnake Date: Thu, 28 Sep 2023 00:38:56 -0700 Subject: [PATCH 13/27] added js html variable --- .../2023-08-30-basics-js-with-html.ipynb | 159 ++++++++++++++++-- 1 file changed, 147 insertions(+), 12 deletions(-) diff --git a/_notebooks/2023-08-30-basics-js-with-html.ipynb b/_notebooks/2023-08-30-basics-js-with-html.ipynb index 8a39501bb..6700c2745 100644 --- a/_notebooks/2023-08-30-basics-js-with-html.ipynb +++ b/_notebooks/2023-08-30-basics-js-with-html.ipynb @@ -44,9 +44,31 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 1, "metadata": {}, - "outputs": [], + "outputs": [ + { + "data": { + "text/html": [ + "\n", + "

My Title

\n", + "\n", + "\n", + "\n" + ], + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], "source": [ "%%html\n", "\n", @@ -74,9 +96,31 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 2, "metadata": {}, - "outputs": [], + "outputs": [ + { + "data": { + "text/html": [ + "\n", + "

My Title

\n", + "\n", + "\n", + "\n" + ], + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], "source": [ "%%html\n", "\n", @@ -102,9 +146,32 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 3, "metadata": {}, - "outputs": [], + "outputs": [ + { + "data": { + "text/html": [ + "\n", + "

My Title

\n", + "\n", + "\n", + "\n" + ], + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], "source": [ "%%html\n", "\n", @@ -341,7 +408,7 @@ }, { "cell_type": "code", - "execution_count": 3, + "execution_count": 11, "metadata": { "vscode": { "languageId": "html" @@ -351,10 +418,44 @@ { "data": { "text/html": [ - "\n", + "\n", + "\n", + " \n", + " US State Capitals\n", + "\n", + "\n", + "

State Capitals Lookup

\n", + "
\n", + "\n", + "
\n", + " \n", + " \n", + " \n", + "
\n", + "
\n", + "\n", + "\n", + "\n", "\n", "\n" ], "text/plain": [ @@ -367,10 +468,44 @@ ], "source": [ "%%html\n", - "\n", + "\n", + "\n", + " \n", + " US State Capitals\n", + "\n", + "\n", + "

State Capitals Lookup

\n", + "
\n", + "\n", + "
\n", + " \n", + " \n", + " \n", + "
\n", + "
\n", + "\n", + "\n", + "\n", "\n", "" ] } @@ -391,7 +526,7 @@ "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", - "version": "3.9.12" + "version": "3.8.10" }, "orig_nbformat": 4 }, From 3435797423a93dd5b31bf7d3d497757a76effe13 Mon Sep 17 00:00:00 2001 From: sooctosnake Date: Thu, 28 Sep 2023 00:58:36 -0700 Subject: [PATCH 14/27] added click event --- .../2023-08-30-basics-js-with-html.ipynb | 100 ++++++++++++++++-- 1 file changed, 93 insertions(+), 7 deletions(-) diff --git a/_notebooks/2023-08-30-basics-js-with-html.ipynb b/_notebooks/2023-08-30-basics-js-with-html.ipynb index 6700c2745..df4ad7715 100644 --- a/_notebooks/2023-08-30-basics-js-with-html.ipynb +++ b/_notebooks/2023-08-30-basics-js-with-html.ipynb @@ -408,7 +408,7 @@ }, { "cell_type": "code", - "execution_count": 11, + "execution_count": 17, "metadata": { "vscode": { "languageId": "html" @@ -425,10 +425,11 @@ "\n", "\n", "

State Capitals Lookup

\n", + " \n", "
\n", - "\n", + "
\n", "
\n", - " \n", + " \n", " \n", " \n", "
\n", @@ -455,7 +456,49 @@ " // write in html\n", " var div = document.getElementById(\"prompt\")\n", " div.appendChild(pElement)\n", - " // \n", + " // create function\n", + " // define a function => takes parameter text, returns a new p tab\n", + " function createPTag(text) {\n", + " // creates a new element\n", + " var pElement = document.createElement(\"input_prompt\")\n", + "\n", + " // using the parameter like a variable\n", + " pElement.innerHTML = text\n", + " \n", + " // outputs p tag after it has been created\n", + " console.log(\"Example #6, add p tag using a function\")\n", + " console.log(pElement)\n", + "\n", + " return pElement;\n", + " }\n", + "\n", + " // create a function that sets specific text and adds to div\n", + " function addPTagOnButton() {\n", + " // using our new function\n", + " var pTag = createPTag(\"Enter State\")\n", + "\n", + " // place the p element in the webpage\n", + " var div = document.getElementById(\"state_input\")\n", + "\n", + " // add p tag to the div\n", + " div.appendChild(pTag)\n", + " \n", + " // outputs p tag after it has been created\n", + " console.log(\"Example #7.2, update container adding a 'p' tag\")\n", + " console.log(div)\n", + " }\n", + "\n", + " // using a function to create p tag\n", + " var pTag = createPTag(\"Enter State\")\n", + "\n", + " // place the p element in the webpage\n", + " //var div = document.getElementById(\"state_input\")\n", + " //div.appendChild(pTag)\n", + "\n", + " // add the P tag when our button is clicked\n", + " var myButton = document.getElementById(\"buttonID\")\n", + " myButton.onclick = addPTagOnButton\n", + " \n", "\n" ], "text/plain": [ @@ -475,10 +518,11 @@ "\n", "\n", "

State Capitals Lookup

\n", + " \n", "
\n", - "\n", + "
\n", "
\n", - " \n", + " \n", " \n", " \n", "
\n", @@ -505,7 +549,49 @@ " // write in html\n", " var div = document.getElementById(\"prompt\")\n", " div.appendChild(pElement)\n", - " // \n", + " // create function\n", + " // define a function => takes parameter text, returns a new p tab\n", + " function createPTag(text) {\n", + " // creates a new element\n", + " var pElement = document.createElement(\"input_prompt\")\n", + "\n", + " // using the parameter like a variable\n", + " pElement.innerHTML = text\n", + " \n", + " // outputs p tag after it has been created\n", + " console.log(\"Example #6, add p tag using a function\")\n", + " console.log(pElement)\n", + "\n", + " return pElement;\n", + " }\n", + "\n", + " // create a function that sets specific text and adds to div\n", + " function addPTagOnButton() {\n", + " // using our new function\n", + " var pTag = createPTag(\"Enter State\")\n", + "\n", + " // place the p element in the webpage\n", + " var div = document.getElementById(\"state_input\")\n", + "\n", + " // add p tag to the div\n", + " div.appendChild(pTag)\n", + " \n", + " // outputs p tag after it has been created\n", + " console.log(\"Example #7.2, update container adding a 'p' tag\")\n", + " console.log(div)\n", + " }\n", + "\n", + " // using a function to create p tag\n", + " var pTag = createPTag(\"Enter State\")\n", + "\n", + " // place the p element in the webpage\n", + " //var div = document.getElementById(\"state_input\")\n", + " //div.appendChild(pTag)\n", + "\n", + " // add the P tag when our button is clicked\n", + " var myButton = document.getElementById(\"buttonID\")\n", + " myButton.onclick = addPTagOnButton\n", + " \n", "" ] } From eb98e5509e92c222dbf994c6f6595a1616641496 Mon Sep 17 00:00:00 2001 From: sooctosnake Date: Thu, 28 Sep 2023 01:19:26 -0700 Subject: [PATCH 15/27] added basic js, capitals in html and javascript --- _notebooks/2023-08-28-basics-html.ipynb | 44 ++++- _notebooks/2023-08-29-basics-of-js.ipynb | 19 ++- .../2023-08-30-basics-js-with-html.ipynb | 160 ++++++++++++++++-- 3 files changed, 203 insertions(+), 20 deletions(-) diff --git a/_notebooks/2023-08-28-basics-html.ipynb b/_notebooks/2023-08-28-basics-html.ipynb index 290ce888b..fae39435c 100644 --- a/_notebooks/2023-08-28-basics-html.ipynb +++ b/_notebooks/2023-08-28-basics-html.ipynb @@ -235,7 +235,7 @@ }, { "cell_type": "code", - "execution_count": 1, + "execution_count": 2, "metadata": { "vscode": { "languageId": "html" @@ -246,7 +246,26 @@ "data": { "text/html": [ "\n", - "\n" + "\n", + "\n", + "\n", + " \n", + " US State Capitals\n", + "\n", + "\n", + "

State Capitals Lookup

\n", + " \n", + "
\n", + "
\n", + "
\n", + " \n", + " \n", + " \n", + "
\n", + "
\n", + "\n", + "\n", + "\n" ], "text/plain": [ "" @@ -259,7 +278,26 @@ "source": [ "%%html\n", "\n", - "" + "\n", + "\n", + "\n", + " \n", + " US State Capitals\n", + "\n", + "\n", + "

State Capitals Lookup

\n", + " \n", + "
\n", + "
\n", + "
\n", + " \n", + " \n", + " \n", + "
\n", + "
\n", + "\n", + "\n", + "" ] } ], diff --git a/_notebooks/2023-08-29-basics-of-js.ipynb b/_notebooks/2023-08-29-basics-of-js.ipynb index bdb11a3c1..7a66693f4 100644 --- a/_notebooks/2023-08-29-basics-of-js.ipynb +++ b/_notebooks/2023-08-29-basics-of-js.ipynb @@ -510,7 +510,7 @@ }, { "cell_type": "code", - "execution_count": 3, + "execution_count": 4, "metadata": { "vscode": { "languageId": "javascript" @@ -519,7 +519,7 @@ "outputs": [ { "data": { - "application/javascript": "// put your javascript code here\n", + "application/javascript": "// Define two variables to hold the numbers\nvar number1 = 10;\nvar number2 = 20;\n\n// Compare the two numbers\nif (number1 < number2) {\n console.log(\"Number 1 is less than Number 2.\");\n} else if (number1 > number2) {\n console.log(\"Number 1 is greater than Number 2.\");\n} else {\n console.log(\"Number 1 is equal to Number 2.\");\n}\n", "text/plain": [ "" ] @@ -530,7 +530,18 @@ ], "source": [ "%%js\n", - "// put your javascript code here" + "// Define two variables to hold the numbers\n", + "var number1 = 10;\n", + "var number2 = 20;\n", + "\n", + "// Compare the two numbers\n", + "if (number1 < number2) {\n", + " console.log(\"Number 1 is less than Number 2.\");\n", + "} else if (number1 > number2) {\n", + " console.log(\"Number 1 is greater than Number 2.\");\n", + "} else {\n", + " console.log(\"Number 1 is equal to Number 2.\");\n", + "}" ] } ], @@ -550,7 +561,7 @@ "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", - "version": "3.9.12" + "version": "3.8.10" }, "orig_nbformat": 4 }, diff --git a/_notebooks/2023-08-30-basics-js-with-html.ipynb b/_notebooks/2023-08-30-basics-js-with-html.ipynb index df4ad7715..a46973da9 100644 --- a/_notebooks/2023-08-30-basics-js-with-html.ipynb +++ b/_notebooks/2023-08-30-basics-js-with-html.ipynb @@ -408,7 +408,7 @@ }, { "cell_type": "code", - "execution_count": 17, + "execution_count": 2, "metadata": { "vscode": { "languageId": "html" @@ -435,8 +435,6 @@ " \n", "
\n", "\n", - "\n", - "\n", "\n", "\n" + " const stateCapitals = {\n", + " \"alabama\": \"Montgomery\",\n", + " \"alaska\": \"Juneau\",\n", + " \"arizona\": \"Phoenix\",\n", + " \"arkansas\": \"Little Rock\",\n", + " \"california\": \"Sacramento\",\n", + " \"colorado\": \"Denver\",\n", + " \"connecticut\": \"Hartford\",\n", + " \"delaware\": \"Dover\",\n", + " \"florida\": \"Tallahassee\",\n", + " \"georgia\": \"Atlanta\",\n", + " \"hawaii\": \"Honolulu\",\n", + " \"idaho\": \"Boise\",\n", + " \"illinois\": \"Springfield\",\n", + " \"indiana\": \"Indianapolis\",\n", + " \"iowa\": \"Des Moines\",\n", + " \"kansas\": \"Topeka\",\n", + " \"kentucky\": \"Frankfort\",\n", + " \"louisiana\": \"Baton Rouge\",\n", + " \"maine\": \"Augusta\",\n", + " \"maryland\": \"Annapolis\",\n", + " \"massachusetts\": \"Boston\",\n", + " \"michigan\": \"Lansing\",\n", + " \"minnesota\": \"St. Paul\",\n", + " \"mississippi\": \"Jackson\",\n", + " \"missouri\": \"Jefferson City\",\n", + " \"montana\": \"Helena\",\n", + " \"nebraska\": \"Lincoln\",\n", + " \"nevada\": \"Carson City\",\n", + " \"new hampshire\": \"Concord\",\n", + " \"new jersey\": \"Trenton\",\n", + " \"new mexico\": \"Santa Fe\",\n", + " \"new york\": \"Albany\",\n", + " \"north carolina\": \"Raleigh\",\n", + " \"north dakota\": \"Bismarck\",\n", + " \"ohio\": \"Columbus\",\n", + " \"oklahoma\": \"Oklahoma City\",\n", + " \"oregon\": \"Salem\",\n", + " \"pennsylvania\": \"Harrisburg\",\n", + " \"rhode island\": \"Providence\",\n", + " \"south carolina\": \"Columbia\",\n", + " \"south dakota\": \"Pierre\",\n", + " \"tennessee\": \"Nashville\",\n", + " \"texas\": \"Austin\",\n", + " \"utah\": \"Salt Lake City\",\n", + " \"vermont\": \"Montpelier\",\n", + " \"virginia\": \"Richmond\",\n", + " \"washington\": \"Olympia\",\n", + " \"west virginia\": \"Charleston\",\n", + " \"wisconsin\": \"Madison\",\n", + " \"wyoming\": \"Cheyenne\"\n", + " };\n", + "\n", + " document.getElementById('capitalForm').addEventListener('submit', function(event) {\n", + " event.preventDefault();\n", + " const stateInput = document.getElementById('stateInput').value.toLowerCase();\n", + "\n", + " if (stateCapitals.hasOwnProperty(stateInput)) {\n", + " const capital = stateCapitals[stateInput];\n", + " document.getElementById('result').textContent = `The capital of ${stateInput} is ${capital}.`;\n", + " } else {\n", + " document.getElementById('result').textContent = \"Invalid state name. Please enter a valid state.\";\n", + " }\n", + " });\n", + "\n", + "\n", + "\n", + "\n", + "\n" ], "text/plain": [ "" @@ -528,8 +595,6 @@ " \n", "
\n", "\n", - "\n", - "\n", "\n", "" + " const stateCapitals = {\n", + " \"alabama\": \"Montgomery\",\n", + " \"alaska\": \"Juneau\",\n", + " \"arizona\": \"Phoenix\",\n", + " \"arkansas\": \"Little Rock\",\n", + " \"california\": \"Sacramento\",\n", + " \"colorado\": \"Denver\",\n", + " \"connecticut\": \"Hartford\",\n", + " \"delaware\": \"Dover\",\n", + " \"florida\": \"Tallahassee\",\n", + " \"georgia\": \"Atlanta\",\n", + " \"hawaii\": \"Honolulu\",\n", + " \"idaho\": \"Boise\",\n", + " \"illinois\": \"Springfield\",\n", + " \"indiana\": \"Indianapolis\",\n", + " \"iowa\": \"Des Moines\",\n", + " \"kansas\": \"Topeka\",\n", + " \"kentucky\": \"Frankfort\",\n", + " \"louisiana\": \"Baton Rouge\",\n", + " \"maine\": \"Augusta\",\n", + " \"maryland\": \"Annapolis\",\n", + " \"massachusetts\": \"Boston\",\n", + " \"michigan\": \"Lansing\",\n", + " \"minnesota\": \"St. Paul\",\n", + " \"mississippi\": \"Jackson\",\n", + " \"missouri\": \"Jefferson City\",\n", + " \"montana\": \"Helena\",\n", + " \"nebraska\": \"Lincoln\",\n", + " \"nevada\": \"Carson City\",\n", + " \"new hampshire\": \"Concord\",\n", + " \"new jersey\": \"Trenton\",\n", + " \"new mexico\": \"Santa Fe\",\n", + " \"new york\": \"Albany\",\n", + " \"north carolina\": \"Raleigh\",\n", + " \"north dakota\": \"Bismarck\",\n", + " \"ohio\": \"Columbus\",\n", + " \"oklahoma\": \"Oklahoma City\",\n", + " \"oregon\": \"Salem\",\n", + " \"pennsylvania\": \"Harrisburg\",\n", + " \"rhode island\": \"Providence\",\n", + " \"south carolina\": \"Columbia\",\n", + " \"south dakota\": \"Pierre\",\n", + " \"tennessee\": \"Nashville\",\n", + " \"texas\": \"Austin\",\n", + " \"utah\": \"Salt Lake City\",\n", + " \"vermont\": \"Montpelier\",\n", + " \"virginia\": \"Richmond\",\n", + " \"washington\": \"Olympia\",\n", + " \"west virginia\": \"Charleston\",\n", + " \"wisconsin\": \"Madison\",\n", + " \"wyoming\": \"Cheyenne\"\n", + " };\n", + "\n", + " document.getElementById('capitalForm').addEventListener('submit', function(event) {\n", + " event.preventDefault();\n", + " const stateInput = document.getElementById('stateInput').value.toLowerCase();\n", + "\n", + " if (stateCapitals.hasOwnProperty(stateInput)) {\n", + " const capital = stateCapitals[stateInput];\n", + " document.getElementById('result').textContent = `The capital of ${stateInput} is ${capital}.`;\n", + " } else {\n", + " document.getElementById('result').textContent = \"Invalid state name. Please enter a valid state.\";\n", + " }\n", + " });\n", + "\n", + "\n", + "\n", + "\n", + "\n" ] } ], From 8e8bfe1fe207f6628dbeadd928068effb073f103 Mon Sep 17 00:00:00 2001 From: sooctosnake Date: Thu, 28 Sep 2023 01:44:12 -0700 Subject: [PATCH 16/27] added_datatypecode --- .../2023-08-30-basics-js-data-types.ipynb | 176 +++++++++--------- 1 file changed, 90 insertions(+), 86 deletions(-) diff --git a/_notebooks/2023-08-30-basics-js-data-types.ipynb b/_notebooks/2023-08-30-basics-js-data-types.ipynb index cdbc8ed51..ce40478e8 100644 --- a/_notebooks/2023-08-30-basics-js-data-types.ipynb +++ b/_notebooks/2023-08-30-basics-js-data-types.ipynb @@ -42,46 +42,9 @@ "outputs": [ { "data": { - "text/html": [ - "\n" - ], + "application/javascript": "\n// assign variable\nvar hello = \"Hello World\";\nconsole.log(\"variable: hello\")\nconsole.log(hello)\n\n// seeing the type of this data\nconsole.log(\"variable: hello check typeof\")\nconsole.log(typeof hello)\n\n// add strings together\nconsole.log(\"string concatenation: hello + Rohan!\")\nconsole.log(hello + \" Rohan!\")\n", "text/plain": [ - "" + "" ] }, "metadata": {}, @@ -114,13 +77,24 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 2, "metadata": { "vscode": { "languageId": "javascript" } }, - "outputs": [], + "outputs": [ + { + "data": { + "application/javascript": "var hello = \"Hello World\";\n\n// getting a certain component of this text\n// (here the _ is a standin for the space character)\n// H e l l o _ W o r l d\n// 0 1 2 3 4 5 6 7 8 9 10\n// if we want the hello component, we want characters 0-4, so we use the following function\n// (note how we use 0 and 5 as arguments, the last character is NOT INCLUSIVE)\nconsole.log(\"substring: hello 0, 5\")\nconsole.log(hello.substring(0, 5))\n", + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], "source": [ "%%js\n", "var hello = \"Hello World\";\n", @@ -171,13 +145,24 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 3, "metadata": { "vscode": { "languageId": "javascript" } }, - "outputs": [], + "outputs": [ + { + "data": { + "application/javascript": "var hello = \"Hello World\";\n\n// useful function to check if one string is contained in another\nconsole.log(\"string includes: hello includes Rohan\")\nconsole.log(hello.includes(\"Rohan\"))\nconsole.log(\"string includes: hello includes Hello\")\nconsole.log(hello.includes(\"Hello\"))\n", + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], "source": [ "%%js\n", "var hello = \"Hello World\";\n", @@ -292,13 +277,24 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 5, "metadata": { "vscode": { "languageId": "javascript" } }, - "outputs": [], + "outputs": [ + { + "data": { + "application/javascript": "console.log(\"variable: num1\")\nvar num1 = 9\nconsole.log(num1)\nconsole.log(\"variable: num2\")\nvar num2 = 6\nconsole.log(num2)\n\n// converting numbers to text\nconsole.log(\"number convert string: num1\")\nconsole.log(num1.toString())\n\n// rounding a number\nconsole.log(\"round(num1 / num2)\")\nconsole.log(Math.round(num1 / num2))\n\n// rounding a number to decimal palces\nconsole.log(\"set decimals to 2 places (num1 / num2)\")\nconsole.log((num1 / num2).toFixed(0))\n", + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], "source": [ "%%js\n", "console.log(\"variable: num1\")\n", @@ -333,7 +329,7 @@ }, { "cell_type": "code", - "execution_count": 13, + "execution_count": 6, "metadata": { "vscode": { "languageId": "javascript" @@ -342,39 +338,9 @@ "outputs": [ { "data": { - "text/html": [ - "\n", - "\n" - ], + "application/javascript": "console.log(\"Array: assigning a list of strings\")\nvar str1 = \"1st string\"\nvar arr_data = [str1, \"2nd string\", \"3rd string\"]\n// seeing what is in the array\nconsole.log(arr_data)\n\n// getting one thing from an array\n// \"A string\" \"Other Data\" \"more data\"\n// 0 1 2\nconsole.log(\"Array: referencing a cell #1\")\nconsole.log([ arr_data[1] ]) // zero based counting: 1 is 2nd cell\n", "text/plain": [ - "" + "" ] }, "metadata": {}, @@ -405,13 +371,24 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 7, "metadata": { "vscode": { "languageId": "javascript" } }, - "outputs": [], + "outputs": [ + { + "data": { + "application/javascript": "console.log(\"Array: assigning a list of strings\")\nvar str1 = \"1st string\"\nvar arr_data = [str1, \"2nd string\", \"3rd string\"]\n// seeing what is in the array\nconsole.log(arr_data)\n\n// adding something new to the array\nconsole.log(\"Array: adding to list\")\narr_data.push(\"4th string\")\nconsole.log(arr_data)\n\n// removing the first element of array\nconsole.log(\"Array: removing from front of list\")\narr_data.shift()\nconsole.log(arr_data)\n\n// removing the last element of array\nconsole.log(\"Array: removing from end of list\")\narr_data.pop()\nconsole.log(arr_data)\n", + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], "source": [ "%%js\n", "console.log(\"Array: assigning a list of strings\")\n", @@ -545,13 +522,24 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 8, "metadata": { "vscode": { "languageId": "javascript" } }, - "outputs": [], + "outputs": [ + { + "data": { + "application/javascript": "console.log(\"Object: assigning key-value objects\")\nvar obj = {\n name: \"Safin\",\n age: 13\n};\n\n// The following is stored in the object called \"obj\"\n// {\n// name: \"Safin\",\n// age: 13\n// }\n//\n// The key \"name\" is associated with the string value \"Safin\"\n// The key \"age\" is associated with the number value 13\n// Notice that keys are of the type \"string\"\n\n// print obj to the console\nconsole.log(obj);\n// -> { name: 'Safin', age: 13 }\n// Notice that single quotes ' and double quotes \" can be used interchangeably\n\n// To access certain values within an object, also known as an object's fields,\n// you can use the name of the object suffixed with a dot and the name of the field\n// or using the square bracket notation shown below\nconsole.log(\"Object: using key name to access the name value (key notation)\")\nconsole.log(obj[\"name\"]);\nconsole.log(\"Object: using key name to access the name value (dot notation)\")\nconsole.log(obj.name);\n// -> Safin\n\n// Fields of an object can be manipulated similar to variables\nconsole.log(\"Object: mutating the key name from Safin to John\")\nobj.name = \"John\"\nconsole.log(obj);\nconsole.log(obj.name);\n// -> John\n\n// A key-value pair can be added to the object\nconsole.log(\"Object: mutating the key name from Safin to John\")\nobj[\"ghid\"] = \"jm1021\"\nconsole.log(obj);\n// Observe new key\n", + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], "source": [ "%%js\n", "console.log(\"Object: assigning key-value objects\")\n", @@ -614,7 +602,7 @@ }, { "cell_type": "code", - "execution_count": 2, + "execution_count": 13, "metadata": { "vscode": { "languageId": "javascript" @@ -623,7 +611,7 @@ "outputs": [ { "data": { - "application/javascript": "// put your javascript code here (make sure to run it and check your outputs in the console)\n", + "application/javascript": "var person = {\n name: \"Soham Kulkani\",\n age: 15,\n classes: [\"AP CSP\", \"AP Chem\",\"Honors Humanities\", \"AP Calc\", \"World History 1\"],\n interests: [\"Reading\", \"Playing Tennis\",\"Coding\", \"Playing Video Games\"],\n gradyear: 2026,\n height: 176,\n alive: true\n};\nconsole.log(person)\nconsole.log(typeof person.name)\nperson.interests.push(\"Math\")\nconsole.log(typeof person.classes)\nconsole.log(typeof person.age)\nperson.height = person.height + 1\nconsole.log(person.height)\nconsole.log(person.name, \"will be\", person.age +20 ,\" years old in 2043\")\n", "text/plain": [ "" ] @@ -634,7 +622,23 @@ ], "source": [ "%%js\n", - "// put your javascript code here (make sure to run it and check your outputs in the console)" + "var person = {\n", + " name: \"Soham Kulkani\",\n", + " age: 15,\n", + " classes: [\"AP CSP\", \"AP Chem\",\"Honors Humanities 1\", \"AP Calc\", \"World History 1\"],\n", + " interests: [\"Reading\", \"Playing Tennis\",\"Coding\", \"Playing Video Games\"],\n", + " gradyear: 2026,\n", + " height: 176,\n", + " alive: true\n", + "};\n", + "console.log(person)\n", + "console.log(typeof person.name)\n", + "person.interests.push(\"Math\")\n", + "console.log(typeof person.classes)\n", + "console.log(typeof person.age)\n", + "person.height = person.height + 1\n", + "console.log(person.height)\n", + "console.log(person.name, \"will be\", person.age +20 ,\" years old in 2043\")" ] } ], @@ -654,7 +658,7 @@ "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", - "version": "3.9.12" + "version": "3.8.10" } }, "nbformat": 4, From b633b6fe16232a93a2fc95f22a99cef28b40fd46 Mon Sep 17 00:00:00 2001 From: sooctosnake Date: Thu, 28 Sep 2023 02:31:34 -0700 Subject: [PATCH 17/27] Added error correction and review --- _notebooks/2023-09-20-1_4-js-errors.ipynb | 72 ++++++++++++++++------- 1 file changed, 50 insertions(+), 22 deletions(-) diff --git a/_notebooks/2023-09-20-1_4-js-errors.ipynb b/_notebooks/2023-09-20-1_4-js-errors.ipynb index fc5968b77..8cd1deaa1 100644 --- a/_notebooks/2023-09-20-1_4-js-errors.ipynb +++ b/_notebooks/2023-09-20-1_4-js-errors.ipynb @@ -58,21 +58,32 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 7, "metadata": { "vscode": { "languageId": "javascript" } }, - "outputs": [], + "outputs": [ + { + "data": { + "application/javascript": "\nvar alphabet = \"abcdefghijklmnopqrstuvwxyz\";\nvar alphabetList = [];\n\nfor (var i = 0; i < 26; i++) {\n\talphabetList.push(alphabet[i]);\n}\n\nconsole.log(alphabetList);\n", + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], "source": [ "%%js\n", "\n", "var alphabet = \"abcdefghijklmnopqrstuvwxyz\";\n", "var alphabetList = [];\n", "\n", - "for (var i = 0; i < 10; i++) {\n", - "\talphabetList.push(i);\n", + "for (var i = 0; i < 26; i++) {\n", + "\talphabetList.push(alphabet[i]);\n", "}\n", "\n", "console.log(alphabetList);" @@ -82,9 +93,9 @@ "cell_type": "markdown", "metadata": {}, "source": [ - "### What I Changed\n", + "# What I Changed\n", "\n", - "I changed..." + "### When appending the values into alphabet list, the original code was only appending i with was te increment variable. I changed it by making the function append alphabetList[i] so that each value of the alphabet was pushed rather than its index. I also changed the max value of i to be less than 26 so that all 26 letters were appended rather than only 10" ] }, { @@ -105,23 +116,41 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 13, "metadata": { "vscode": { "languageId": "javascript" } }, - "outputs": [], + "outputs": [ + { + "data": { + "application/javascript": "\nvar alphabet = \"abcdefghijklmnopqrstuvwxyz\";\nvar alphabetList = [];\n\nfor (var i = 0; i < 26; i++) {\n\talphabetList.push(alphabet[i]);\n}\n\nconsole.log(alphabetList);\n\nlet letterNumber = 5\n\nfor (var i = 0; i < alphabetList.length; i++) {\n\tif (i == letterNumber) {\n\t\tconsole.log(alphabetList[i-1] , \" is letter number 5 in the alphabet\")\n\t}\n}\n\n// Should output:\n// \"e\" is letter number 5 in the alphabet\n", + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], "source": [ "%%js\n", "\n", - "// Copy your previous code to built alphabetList here\n", + "var alphabet = \"abcdefghijklmnopqrstuvwxyz\";\n", + "var alphabetList = [];\n", + "\n", + "for (var i = 0; i < 26; i++) {\n", + "\talphabetList.push(alphabet[i]);\n", + "}\n", + "\n", + "console.log(alphabetList);\n", "\n", "let letterNumber = 5\n", "\n", - "for (var i = 0; i < alphabetList; i++) {\n", - "\tif (i === letterNumber) {\n", - "\t\tconsole.log(letterNumber + \" is letter number 1 in the alphabet\")\n", + "for (var i = 0; i < alphabetList.length; i++) {\n", + "\tif (i == letterNumber) {\n", + "\t\tconsole.log(alphabetList[i-1] , \" is letter number 5 in the alphabet\")\n", "\t}\n", "}\n", "\n", @@ -133,9 +162,8 @@ "cell_type": "markdown", "metadata": {}, "source": [ - "### What I Changed\n", - "\n", - "I changed..." + "# What I Changed\n", + "## When the for loop was written i< alphabetList which is a list not a number. To fix it I changed it to alphabetList.length to add a number. I also changed alphabetList[i] to alphabetList[i-1] to prevent an indexing error since alphabetList index starts from 0 while letterNumber starts from 1.\n" ] }, { @@ -161,24 +189,24 @@ "source": [ "%%js\n", "\n", - "let evens = [];\n", - "let i = 0;\n", + "let odd = [];\n", + "let i = 1;\n", "\n", "while (i <= 10) {\n", - " evens.push(i);\n", + " odd.push(i);\n", " i += 2;\n", "}\n", "\n", - "console.log(evens);" + "console.log(odd);" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ - "### What I Changed\n", + "# What I Changed\n", "\n", - "I changed..." + "## The whole program had the even list instead of the odd list so I replaced it with odd. I also made 1 the starting point as that was the first odd number for below 10." ] }, { @@ -300,7 +328,7 @@ "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", - "version": "3.11.4" + "version": "3.8.10" }, "orig_nbformat": 4, "vscode": { From 6fc83bf8d22c54f0111dacd7ac156573c7bffe28 Mon Sep 17 00:00:00 2001 From: sooctosnake Date: Thu, 28 Sep 2023 02:33:12 -0700 Subject: [PATCH 18/27] added errors and review --- _notebooks/2023-09-20-1_4-js-errors.ipynb | 34 +- _notebooks/2023-09-27-project_review.ipynb | 52 +++ _posts/2023-09-27-survey.ipynb | 381 --------------------- 3 files changed, 80 insertions(+), 387 deletions(-) create mode 100644 _notebooks/2023-09-27-project_review.ipynb delete mode 100644 _posts/2023-09-27-survey.ipynb diff --git a/_notebooks/2023-09-20-1_4-js-errors.ipynb b/_notebooks/2023-09-20-1_4-js-errors.ipynb index 8cd1deaa1..29b024bbd 100644 --- a/_notebooks/2023-09-20-1_4-js-errors.ipynb +++ b/_notebooks/2023-09-20-1_4-js-errors.ipynb @@ -276,13 +276,24 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 4, "metadata": { "vscode": { "languageId": "javascript" } }, - "outputs": [], + "outputs": [ + { + "data": { + "application/javascript": "\nvar menu = {\"burger\": 3.99,\n \"fries\": 1.99,\n \"drink\": 0.99}\nvar total = 0\n\n//shows the user the menu and prompts them to select an item\nconsole.log(\"Menu\")\nfor (var item in menu) {\n console.log(item + \" $\" + menu[item].toFixed(2)) //why is toFixed used?\n}\n//ideally the code should support mutliple items\nvar burger_count = prompt(\"How many Burgers\")\nvar fries_count = prompt(\"How many Fries\")\nvar drink_count = prompt(\"How many Drinks\")\n\n//code should add the price of the menu items selected by the user \nconsole.log(total)\n\n", + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], "source": [ "%%js\n", "\n", @@ -297,19 +308,30 @@ " console.log(item + \" $\" + menu[item].toFixed(2)) //why is toFixed used?\n", "}\n", "//ideally the code should support mutliple items\n", - "var item = \"burger\"\n", + "var burger_count = prompt(\"How many Burgers\")\n", + "total += menu.burger * burger_count\n", + "var fries_count = prompt(\"How many Fries\")\n", + "total += menu.fries *fries_count\n", + "var drink_count = prompt(\"How many Drinks\")\n", + "total += menu.drink * drink_count\n", "\n", "//code should add the price of the menu items selected by the user \n", - "console.log(total)" + "console.log(total)\n", + "\n" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ - "## Hacks\n", - "- Fix the errors in the first three segments in this notebook and say what you changed in the code cell under \"What I Changed\" (Challenge is optional)" + "# What I did Hacks\n", + "## I added a user input place where the user could input how many of each food on the menuthey wanted and I used it to find the total value" ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [] } ], "metadata": { diff --git a/_notebooks/2023-09-27-project_review.ipynb b/_notebooks/2023-09-27-project_review.ipynb new file mode 100644 index 000000000..68e82d27c --- /dev/null +++ b/_notebooks/2023-09-27-project_review.ipynb @@ -0,0 +1,52 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Review 9/27/2023\n", + "\n", + "In my notebook, I successfully completed a series of tasks related to HTML and JavaScript. First, I created a functional HTML code cell, meticulously following the wireframe representation provided in the HTML hack section. Next, I tackled data types in JavaScript, implementing a working code cell based on the instructions in the data types hack. Additionally, I ventured into the realm of the Document Object Model (DOM) with another JavaScript code cell. Furthermore, I delved into JavaScript scripting, completing a code cell that demonstrated the language's scripting capabilities as described in the JavaScript hack. This was especially difficult since it was my first time using JS. Finally, to ensure accuracy and error-free code, I incorporated code cells that showcased the corrections made to the initial three code cells, as instructed in the Correcting Errors Hack. I also answered the Challenge problem." + ] + }, + { + "cell_type": "code", + "execution_count": 1, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Thanks for your time\n" + ] + } + ], + "source": [ + "print(\"Thanks for your time\")" + ] + } + ], + "metadata": { + "kernelspec": { + "display_name": "Python 3", + "language": "python", + "name": "python3" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.8.10" + }, + "orig_nbformat": 4 + }, + "nbformat": 4, + "nbformat_minor": 2 +} diff --git a/_posts/2023-09-27-survey.ipynb b/_posts/2023-09-27-survey.ipynb deleted file mode 100644 index 455907769..000000000 --- a/_posts/2023-09-27-survey.ipynb +++ /dev/null @@ -1,381 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "# This is a HTML Program that takes the Survey on the Exercise of a Person\n", - "\n", - "## This uses input and output and employs a type of exception handling for unfilled missing answers" - ] - }, - { - "cell_type": "code", - "execution_count": 1, - "metadata": {}, - "outputs": [ - { - "data": { - "text/html": [ - "\n", - "\n", - "\n", - " \n", - " Exercise Survey\n", - "\n", - "\n", - "

Exercise Habits Survey

\n", - "

Please take a moment to answer the following questions about your exercise routine.

\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" - ], - "text/plain": [ - "" - ] - }, - "metadata": {}, - "output_type": "display_data" - } - ], - "source": [ - "%%html\n", - "\n", - "\n", - "\n", - " \n", - " Exercise Survey\n", - "\n", - "\n", - "

Exercise Habits Survey

\n", - "

Please take a moment to answer the following questions about your exercise routine.

\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" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "# 8" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": {}, - "outputs": [], - "source": [] - }, - { - "cell_type": "code", - "execution_count": 3, - "metadata": {}, - "outputs": [ - { - "data": { - "text/html": [ - "\n", - "\n", - " \n", - " US State Capitals\n", - "\n", - "\n", - "

US State Capitals Lookup

\n", - "

Enter a state name to find its capital. Be sure to enter in all lowercase letters:

\n", - "\n", - "
\n", - " \n", - " \n", - " \n", - "
\n", - "\n", - "
\n", - "\n", - " \n", - "\n", - "\n" - ], - "text/plain": [ - "" - ] - }, - "metadata": {}, - "output_type": "display_data" - } - ], - "source": [ - "%%html\n", - "\n", - "\n", - " \n", - " US State Capitals\n", - "\n", - "\n", - "

US State Capitals Lookup

\n", - "

Enter a state name to find its capital. Be sure to enter in all lowercase letters:

\n", - "\n", - "
\n", - " \n", - " \n", - " \n", - "
\n", - "\n", - "
\n", - "\n", - " \n", - "\n", - "\n" - ] - } - ], - "metadata": { - "kernelspec": { - "display_name": "Python 3", - "language": "python", - "name": "python3" - }, - "language_info": { - "codemirror_mode": { - "name": "ipython", - "version": 3 - }, - "file_extension": ".py", - "mimetype": "text/x-python", - "name": "python", - "nbconvert_exporter": "python", - "pygments_lexer": "ipython3", - "version": "3.8.10" - }, - "orig_nbformat": 4 - }, - "nbformat": 4, - "nbformat_minor": 2 -} From 79e00a24ae511776d73bd6a7ccb999b9744c227b Mon Sep 17 00:00:00 2001 From: sooctosnake Date: Thu, 28 Sep 2023 09:21:35 -0700 Subject: [PATCH 19/27] add review --- _notebooks/2023-09-27-review_ticket_5 | 64 +++++++++++++++++++++++++++ 1 file changed, 64 insertions(+) create mode 100644 _notebooks/2023-09-27-review_ticket_5 diff --git a/_notebooks/2023-09-27-review_ticket_5 b/_notebooks/2023-09-27-review_ticket_5 new file mode 100644 index 000000000..3c1a41f85 --- /dev/null +++ b/_notebooks/2023-09-27-review_ticket_5 @@ -0,0 +1,64 @@ +--- +toc: false +comments: true +layout: post +title: Review Ticket +description: Here is my Week 5 Review Ticket from the Hacks Test. +type: tangibles +courses: { compsci: {week: 5} } +--- + +# Summary of JavaScript Concepts + +- JavaScript can be included in HTML or Jupyter cells using `` tags. +- The output of JavaScript code, such as `console.log` statements, can be viewed in the browser's console. +- Developers can activate the console through various methods depending on their environment (e.g., VSCode, browsers). + +## Referencing HTML Elements Using JavaScript + +- To access an HTML element, use `document.getElementById("idTag")`, where the ID corresponds to the HTML element's ID attribute. +- The retrieved HTML element is stored in a JavaScript variable, allowing developers to manipulate it. + +## Getting Data Within HTML Elements + +- To access the content within an HTML element, use the `.innerHTML` property of the JavaScript variable representing that element. +- This property allows developers to retrieve and display the content of an HTML element. + +## Setting Data Within HTML Elements + +- The `.innerHTML` property can be used to set the content of an HTML element, effectively changing its text or inner HTML. + +## Creating HTML Elements Dynamically + +- Developers can create new HTML elements using the `document.createElement` function, specifying the type of element to create. +- These dynamically created elements can be manipulated and added to the HTML page using JavaScript. + +## Functions in JavaScript with DOM + +- Functions in JavaScript allow developers to encapsulate code into reusable blocks, enhancing code organization and maintainability. +- Functions can accept parameters as input and return values as output. +- JavaScript functions can be used in conjunction with the Document Object Model (DOM) to interact with HTML elements. + +## OnClick Event + +- The `onclick` event allows developers to specify a function to run when a particular HTML element (e.g., a button) is clicked. +- This event handler can be used to trigger actions based on user interactions. + +--- + +# Summary of HTML Concepts + +- HTML is a markup language used to structure the content of web pages. +- It uses tags to define elements, with opening and closing tags wrapping content (e.g., `content`). +- HTML elements can have attributes, which provide additional information and usually come in name/value pairs (e.g., `attribute_name="attribute_value"`). +- Common HTML tags include headings (`

`, `

`), paragraphs (`

`), links (``), and formatting tags (``, ``). +- HTML elements can be grouped together using the `

` tag. +- Developers can reference HTML elements in JavaScript using `document.getElementById("idTag")`. +- The `.innerHTML` property allows access to the content within an HTML element. +- JavaScript can dynamically create HTML elements and add them to the page. +- Functions in JavaScript can be used to encapsulate code for reuse. +- The `onclick` event allows developers to trigger functions when certain HTML elements are clicked. + + +## Scores +- From 2a68ce08f7472042d6abe1b1ee0f3f5fa851405a Mon Sep 17 00:00:00 2001 From: sooctosnake Date: Fri, 29 Sep 2023 08:45:10 -0700 Subject: [PATCH 20/27] added review to gihub page --- _config.yml | 4 +- _posts/2023-09-27-week6review.md | 68 ++++++++++++++++++++++++++++++++ compsci.md | 2 +- 3 files changed, 71 insertions(+), 3 deletions(-) create mode 100644 _posts/2023-09-27-week6review.md diff --git a/_config.yml b/_config.yml index 3ed1dbdf7..a9b712543 100644 --- a/_config.yml +++ b/_config.yml @@ -1,7 +1,7 @@ title: CompSci Blogs description: "August 2023 to June 2024" -owner_name: Nighthawk Coders -github_username: nighthawkcoders +owner_name: Soham Kulkarni +github_username: SOoctosnake baseurl: "/student" remote_theme: pages-themes/modernist@v0.2.0 #remote_theme: pages-themes/dinky@v0.2.0 diff --git a/_posts/2023-09-27-week6review.md b/_posts/2023-09-27-week6review.md new file mode 100644 index 000000000..a7d24bf13 --- /dev/null +++ b/_posts/2023-09-27-week6review.md @@ -0,0 +1,68 @@ +--- +toc: true +comments: True +layout: post +title: Review Week 6 +description: This is a review of what I did/learned this week +type: tangibles +courses: { compsci: {week: 6} } +--- + +## GPT REVIEW AND SUMMARY + +# Summary of JavaScript Concepts + +- JavaScript can be included in HTML or Jupyter cells using `` tags. +- The output of JavaScript code, such as `console.log` statements, can be viewed in the browser's console. +- Developers can activate the console through various methods depending on their environment (e.g., VSCode, browsers). + +## Referencing HTML Elements Using JavaScript + +- To access an HTML element, use `document.getElementById("idTag")`, where the ID corresponds to the HTML element's ID attribute. +- The retrieved HTML element is stored in a JavaScript variable, allowing developers to manipulate it. + +## Getting Data Within HTML Elements + +- To access the content within an HTML element, use the `.innerHTML` property of the JavaScript variable representing that element. +- This property allows developers to retrieve and display the content of an HTML element. + +## Setting Data Within HTML Elements + +- The `.innerHTML` property can be used to set the content of an HTML element, effectively changing its text or inner HTML. + +## Creating HTML Elements Dynamically + +- Developers can create new HTML elements using the `document.createElement` function, specifying the type of element to create. +- These dynamically created elements can be manipulated and added to the HTML page using JavaScript. + +## Functions in JavaScript with DOM + +- Functions in JavaScript allow developers to encapsulate code into reusable blocks, enhancing code organization and maintainability. +- Functions can accept parameters as input and return values as output. +- JavaScript functions can be used in conjunction with the Document Object Model (DOM) to interact with HTML elements. + +## OnClick Event + +- The `onclick` event allows developers to specify a function to run when a particular HTML element (e.g., a button) is clicked. +- This event handler can be used to trigger actions based on user interactions. + +--- + +# Summary of HTML Concepts + +- HTML is a markup language used to structure the content of web pages. +- It uses tags to define elements, with opening and closing tags wrapping content (e.g., `content`). +- HTML elements can have attributes, which provide additional information and usually come in name/value pairs (e.g., `attribute_name="attribute_value"`). +- Common HTML tags include headings (`

`, `

`), paragraphs (`

`), links (``), and formatting tags (``, ``). +- HTML elements can be grouped together using the `

` tag. +- Developers can reference HTML elements in JavaScript using `document.getElementById("idTag")`. +- The `.innerHTML` property allows access to the content within an HTML element. +- JavaScript can dynamically create HTML elements and add them to the page. +- Functions in JavaScript can be used to encapsulate code for reuse. +- The `onclick` event allows developers to trigger functions when certain HTML elements are clicked. + + +## Scores +- + + diff --git a/compsci.md b/compsci.md index 2c7371d4e..04eac776b 100644 --- a/compsci.md +++ b/compsci.md @@ -1,6 +1,6 @@ --- layout: schedule title: Computer Science Time Box Page -units: "1" +units: "1,2" course: compsci --- From a8a1b79e82a75ea8e2acfab2df28e485b06d41b2 Mon Sep 17 00:00:00 2001 From: sooctosnake Date: Fri, 29 Sep 2023 08:49:03 -0700 Subject: [PATCH 21/27] commit --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 8b3bf059c..c20239a78 100644 --- a/README.md +++ b/README.md @@ -12,7 +12,7 @@ All `GitHub Pages` websites are managed on GitHub infrastructure. GitHub uses `J ## Preparing a Preview Site In all development, it is recommended to test your code before deployment. The GitHub Pages development process is optimized by testing your development on your local machine, prior to files on GitHub -Development Cycle. For GitHub pages, the tooling described below will create a development cycle `make-code-save-preview`. In the development cycle, it is a requirement to preview work locally, prior to doing a VSCode `commit` to git. +Development Cycle. For GitHub pages, the tooling described below will create a development cycle `make-code-save-preview`. In the development cycle, it is a requirement to preview work locally, prior to doing a VSCode `commit` to git. Deployment Cycle. In the deplopyment cycle, `sync-github-action-review`, it is a requirement to complete the development cycle prior to doing a VSCode `sync`. The sync triggers github repository update. The action starts the jekyll build to publish the website. Any step can have errors and will require you to do a review. From 87bd49bd85ed5437085fd3cb3e0c5658e09f7606 Mon Sep 17 00:00:00 2001 From: sooctosnake Date: Fri, 29 Sep 2023 08:52:30 -0700 Subject: [PATCH 22/27] commit2 --- _notebooks/2023-08-17-Markdown_Table_Code_Hack.ipynb | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_notebooks/2023-08-17-Markdown_Table_Code_Hack.ipynb b/_notebooks/2023-08-17-Markdown_Table_Code_Hack.ipynb index dfa1a0a76..c02fabb01 100644 --- a/_notebooks/2023-08-17-Markdown_Table_Code_Hack.ipynb +++ b/_notebooks/2023-08-17-Markdown_Table_Code_Hack.ipynb @@ -48,7 +48,7 @@ "Last index in List | list[LENGTH(list)] | list[len(list) - 1] | Access the last element in the list[]. If you start at zero, last element is length - 1.\n", "Define Procedure | PROCEDURE name (parameter) | def name(parameter): | Create a procedure containing a sequence of programming instructions.\n", "Expression equals |\ta = b\t| a == b | Evaluate if assigned value of a equals assigned value of b\n", - "Expression not equals |\ta ≠ b\t| a != b | Evaluate if assigned value of a is NOT equal to assigned value of b" + "Expression not equals |\ta ≠ b\t| a != b | Evaluate if assigned value of a is NOT equal to assigned value of b." ] }, { From 2942804ac67b4d2d13d088f24541f75695bce5de Mon Sep 17 00:00:00 2001 From: sooctosnake Date: Fri, 29 Sep 2023 09:01:58 -0700 Subject: [PATCH 23/27] commit3 --- _posts/2023-09-10-Review_Ticket.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_posts/2023-09-10-Review_Ticket.md b/_posts/2023-09-10-Review_Ticket.md index f45fa8adc..25bf28000 100644 --- a/_posts/2023-09-10-Review_Ticket.md +++ b/_posts/2023-09-10-Review_Ticket.md @@ -24,7 +24,7 @@ var (Variable): Used for declaring variables globally or within a function, with const pi = 3.14159; globalVariable = "I can be changed"; - // blockVariable can only be accessed within its block. + // blockVariable can only be accessed within its block // pi cannot be reassigned. ## Conditional Statements (if, else, switch): From f87395a1ccf8e4639b6612652d427c0d9335bf4a Mon Sep 17 00:00:00 2001 From: sooctosnake Date: Fri, 29 Sep 2023 09:14:00 -0700 Subject: [PATCH 24/27] commit 4 --- compsci.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/compsci.md b/compsci.md index 04eac776b..a8e2fce8a 100644 --- a/compsci.md +++ b/compsci.md @@ -1,6 +1,6 @@ --- layout: schedule -title: Computer Science Time Box Page +title: Computer Science Lab Notebook units: "1,2" course: compsci --- From f1292d17d215cb0cd9b07aaea507835ad69e5a53 Mon Sep 17 00:00:00 2001 From: sooctosnake Date: Sun, 1 Oct 2023 14:39:33 -0700 Subject: [PATCH 25/27] removed python files --- get_to_know_me_game.py | 23 ----------------------- search_term.py | 24 ------------------------ test_world.py | 3 --- 3 files changed, 50 deletions(-) delete mode 100644 get_to_know_me_game.py delete mode 100644 search_term.py delete mode 100644 test_world.py diff --git a/get_to_know_me_game.py b/get_to_know_me_game.py deleted file mode 100644 index c9920fe33..000000000 --- a/get_to_know_me_game.py +++ /dev/null @@ -1,23 +0,0 @@ -# Online Python compiler (interpreter) to run Python online. -# Write Python 3 code in this online editor and run it. -questions = ["When is my birthday", "What is my favorite food","What is my favorite color","What is favorite food"] -responses = [["A. July 8th", "B. January 9th", "C. November 27th", "D. June 9th"], - ["A. Pizza", "B. Salad", "C. Pasta", "D. Mac&Cheese"], - ["A. Blue", "B. Green", "C. Red", "D. Black"], - ["A. 12", "B. 11", "C. 19", "D. 13"]]; -answer = ["A","D","B","D"] -print("Hello. Wellome to the Get To Know Me Game. This is a multiple choice test that will test your knowledge about me") -user_answer = "" -for i in range(len(questions)): - print(questions[i]) - for j in range(4): - print(response[i][j]) - user_answer = input() - - if user_answer == answer[i]: - print("Correct!") - else: - print("Incorrect") - -print() -print("Thank for playing the game") \ No newline at end of file diff --git a/search_term.py b/search_term.py deleted file mode 100644 index 630ad6f99..000000000 --- a/search_term.py +++ /dev/null @@ -1,24 +0,0 @@ -raw_terms = open("terms.txt","r") -terms = [] -for i in range(13): - terms.append(raw_terms.readline().strip("\n").split("=")) - -search = "" -is_md = "on Markdown" -found = False -while True: - search = input("Enter your search: ") - for i in range(len(terms)): - if search == terms[i][0]: - found = True - if is_md in search: - print("Format: ", terms[i][1]) - - else: - print("Definition:", "\n", terms[i][1]) - - if found == False: - print("Sorry we can't find that term. Make sure you have spell your query correctly") - - -print(terms) \ No newline at end of file diff --git a/test_world.py b/test_world.py deleted file mode 100644 index a88117207..000000000 --- a/test_world.py +++ /dev/null @@ -1,3 +0,0 @@ -import worldometer - - From 05bbd7478bac97e6324a855c97e0303b7bcbd913 Mon Sep 17 00:00:00 2001 From: sooctosnake Date: Sun, 1 Oct 2023 15:21:01 -0700 Subject: [PATCH 26/27] reverted to cayman theme --- _config.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_config.yml b/_config.yml index a9b712543..037d3b851 100644 --- a/_config.yml +++ b/_config.yml @@ -3,11 +3,11 @@ description: "August 2023 to June 2024" owner_name: Soham Kulkarni github_username: SOoctosnake baseurl: "/student" -remote_theme: pages-themes/modernist@v0.2.0 +# remote_theme: pages-themes/modernist@v0.2.0 #remote_theme: pages-themes/dinky@v0.2.0 # remote_theme: pages-themes/minimal@v0.2.0 # remote_theme: pages-themes/hacker@v0.2.0 -# remote_theme: pages-themes/cayman@v0.2.0 +remote_theme: pages-themes/cayman@v0.2.0 # remote_theme: pages-themes/time-machine@v0.2.0 plugins: - jekyll-remote-theme From df677d2439ec3dbc706d1bcfb8c06fd1412942da Mon Sep 17 00:00:00 2001 From: sooctosnake Date: Sun, 5 Nov 2023 22:42:43 -0800 Subject: [PATCH 27/27] updating notebook --- _config.yml | 4 ++-- _config.yml.bak | 15 +++++++++++++++ compsci.md | 2 +- 3 files changed, 18 insertions(+), 3 deletions(-) create mode 100644 _config.yml.bak diff --git a/_config.yml b/_config.yml index 037d3b851..ab294f4ab 100644 --- a/_config.yml +++ b/_config.yml @@ -3,8 +3,8 @@ description: "August 2023 to June 2024" owner_name: Soham Kulkarni github_username: SOoctosnake baseurl: "/student" -# remote_theme: pages-themes/modernist@v0.2.0 -#remote_theme: pages-themes/dinky@v0.2.0 +# remote_theme: pages-themes/midnight@v0.2.0 +# remote_theme: pages-themes/dinky@v0.2.0 # remote_theme: pages-themes/minimal@v0.2.0 # remote_theme: pages-themes/hacker@v0.2.0 remote_theme: pages-themes/cayman@v0.2.0 diff --git a/_config.yml.bak b/_config.yml.bak new file mode 100644 index 000000000..037d3b851 --- /dev/null +++ b/_config.yml.bak @@ -0,0 +1,15 @@ +title: CompSci Blogs +description: "August 2023 to June 2024" +owner_name: Soham Kulkarni +github_username: SOoctosnake +baseurl: "/student" +# remote_theme: pages-themes/modernist@v0.2.0 +#remote_theme: pages-themes/dinky@v0.2.0 +# remote_theme: pages-themes/minimal@v0.2.0 +# remote_theme: pages-themes/hacker@v0.2.0 +remote_theme: pages-themes/cayman@v0.2.0 +# remote_theme: pages-themes/time-machine@v0.2.0 +plugins: +- jekyll-remote-theme +future: true + diff --git a/compsci.md b/compsci.md index a8e2fce8a..7e2cdf2f9 100644 --- a/compsci.md +++ b/compsci.md @@ -1,6 +1,6 @@ --- layout: schedule title: Computer Science Lab Notebook -units: "1,2" +units: "1,2,3" course: compsci ---

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�Xhbut%zPox@~0;QdpbjYEJpw>&bg2Gxqx!S10$&z#j zYB`Q(L$rBQ77me|Asz`i{=1cKBJ!ft$O_#W!{>glu6S~Fa<+nhxRgQx~KfV436f}zy>QNN0ML~b*AlrgAZV%TlKr$LDYXUw zCo^aBWvc|33QUSm_Tjaxi`~Mi%e%2*QV#q_IT{MWc<=j^43s@bc10+>TotlXdzCW+Bl6|~|N z$Oa6%#LJi?^8cBiF=KEylh>FKdBmTul)!i-Sk1Q!gdl%MF?Y&;_uR;|(8n>|sAPd3 zwHGUeG_ra2ZR{$G=!5=9V%2l!FS<>Cc8iY93putU>ZX^n3G9-4dkAr=(02hjlviCd zOrHk*p*Tm{IPlpj$(jimMED^g+=RzhP*hU8c=t%roQu#N`q99TzfibL?3=3mR?T3g zguKoFW9zddr$%dzf)-)VC0qTUyea)w$K|FR?K-T&G z^{=rJlxyn95;pG4xl>mIlzd$_vtPZy+;viOBx!j7zLNez^ zin-*V#)Q>eID{)Ai(TXg4a8=vJmpEbiGM_isCxX9D4lMtC$kj)kGA& zy!+FnR&FXzd!ty|SPK(6;H}ICM(Z~;A;UxYxB`NP1jteLoCr!XpSr~G?KOH?hv))n zU7W+=dz8RSQhkl&ih^Sm* zR-$IoCiyXHS3NU^jjvP>==VD90n;+#5i*$;9jv7_8QeJ98m9m+Bg}2PJRiqVyOKWQ zuq2AP6Inr|v`^0hHI?^NkK!cre1p1vXv3^X=gQdjDMtlW{vqFcd6QU0=@Of-;~_md z$2?lw3a6i6hQ`2z>q#|#%tJYrK2igJjmKp=*Q87u?;%^)pR8>tS!rL5?AsahQ$I8@ zMIiC0^EgJ{;_FQWXFm%_721 zSulP?%+Pz5K0!G_7UB}PWy76wI4?uKr||@~@n7HI%S7$bsULh1{iIo{BgBy+9I+)U_G z1UQsqKJe&u(6h#4`zA0D(KEg-1yICwNn`4$X>8ld_Df zG*`V8#v5bEiOF(N_9B#_W-jx?flyLStHM4{%yJ!a55KIJE}Hyu#$K~;es!o04363k zzlW45-2wK=rECM+fn-mES@j*ENxPQ=Jf=*_c!x_-)QD{5Cl<(Dr@R z0EGN3-Bz6C4JAW(R+o`=&H@5A##KX1(3JSn9Ce_Eh}}5Zma9yh_$(NJ(xSzUKSq^H ztg;Z2ujh0z#)e97PJTRMfBL@Y*+C`yG()}cq-3!OOA#QvVtmQ@6g7}^Ai;~7GH!8j z8#W#At?>u*GFE@BA4bA^jRs}hRt?M-p@gWQ!yKj#2CtcgR*Wi&>w!rN$Epd!nfF^i zp7M=?;_|1}1#=Q5Q38F9y5)t0ejh~C%rCe(_xd^HJ9*9OzL|4HW z?f1YyGT!TppqrgjOnaAwqhr76t0%?Y8!{tOCv}4hr+bTwdX4j|TR_NL!oFEC>rh=* z=AL4>s`aB^bHempVo~#+U zHG91#-U@Icj=!7Cx>FYn+BpG^nU5BkNvD4yVrKYqquU9;>_fO`Q#Q*yh)X9bHZw5Y z;+8}IC!PaBGWPk#%Ozf~3)k?$tb}A|$Gjm+{JK?h9l^Z)i;l6ylzf0jMt*k^4 z$hqnPVFE5Lu2Vp9$MxNIJ$p-$+LWZAQ-V&x6tI$nK=#5X zad={}0u!Q5@78ov@DS{w1a-xR{fZ(ph6=hA?3=V12Vy%n$1A!>EGxql5~HEqTI2`8 zvK%r?o^l00L21op5#2YdORQQ@S4 zhIe5+%fOR%T^;(Zf)^({U4C;HCMTbvCqyeDXC#agQF4*Qb-297&sLW(cV2KtoF}_1 z_^dA6j#T9@lTqsZvUF>pSFS#sN7ZH4u_U0@Ozc`h;Pt(R=vno*DURG81r_Ht`(dgH ziOh-$^EgRM;4Y)UIkRO|Ed!RGM{>z;%Th?34UTu6m*k(edeRLG&hoUgvzIy6vZX;q zN(>wpu%{lDKqjQu^VxQuJYa}6?&~nx=~|b^L}j|S7D3fKkS6YWv4yyR`rpSjh^Zqw zx_nIGvlf&TTEzM?L@hsb+Nr+(woY}Pb!X|(t7K+&_jb*YI$%<{U*K@~h_3!4ZfyEN zcmF4bN=@u!`UFtoubpQEn)=DDV6vp*_uPn2pofIz4U*x8NOy3OImL>1Ce0#K8xP*` z50fy~2zX>$DRYHqSW1w8LeCx5!fYc`g^x$U?Nf48M9B(5Qv{w{%{ES8{SlZKF$J2C z>o1OQQur&*8QUx#5}beI#L-9#76~Qg4Qks?tec|J_{Fm;yyA|t4)0HbGq^g5y4(4; zyj1~%vkoEWxuNiC)2lJlxGw4Iz5HU>J(Om*v5AS)#!?tBcb}Z}uVUTa@Oe6?S}b0l z-%x+x)Y=o3sO9zaj4JHUU*-D3!wnaSN9ftkCI7)(=hrxyC&D3yJ6`yPW$Y>McPKpv zzt&u|$N#jIm)Sn~FqYjMutZ?1r`3kLBgD*Ac3MHbGEGtRr$&hH=`hwA*-yLGRnp z^(R+d!g4CN9W&*VWpR~a*JQ-g%44__zpdj7+NigA?{pu~)5k&3Y^J20#f4K+=_f~h zN;0)E5t%4#)wCr7Yre@YBq zNg-G7rSkWI9j9ht%*jP;c(NjnA97SLibb%Pp7^~df>mF^K{)-+u=j^&`$Ob|BnPKy z1=4r%SPBcCgEiktv8+ZMR66AvhFyO8lxuk5ki(taR?0D{Rx=rH(us;AL(`}3;ErC9 z_BR8x8Az$$lI`Z6m=Wu(R86M}RIoLsBq`T5k|gty`)xo{bWd{bK+?P4-Xt{R zG&-YM{raCennT?urnDZ@=nM=ozT&>sB;?Q&mh&iwPm~AHEw5OA6nykWW}(q>l)wGA zW;9C<#Rja+%$6p~5UFN#V6PtwOz3DAs*l`se8y*W@-bL4i^=8=$rmhLZfHEVTngO$ z%~5LIpai$>OBy%<-p_Ed4@>NeuKnA{mKrN$teGe6swXEC61LI&teQ1fMpMLV6gss- z=o&a-T@cu2^5##kRPjLCc`D|vwRikS`{b_B#!VmGlX;PVUU&7#x3Q1vLFe!lb^uyy zrZ`Js8+bzQjl@CnV0&fy5%;foT;66b(=%nncaL2u} z5}27Fmp^^1b69Aor#A?tXT0zD?e*GVFvwuh;}?lbR9_u?Yh0R8URyWrACtQ?&Z7@h z-n^X68Vo;Ytp3i7&&Q?prHw3PxEo$PU)GqPNbpTHtOnAuN#w?r;ZZ-{`^~{`LXF4w zDq`+I*MY2xmgq{El$G<>DkJM33)~lK-Mo)G0|13IMkw)L*8RFw5-SNPM3z@n@CS0- zlhjCMn1u2xn5b=3RiE|-kE~;KK$dSiO}=d@Wc2pkT2$}}uE|aB9f18pVAiV@W)edW z61kBEA|k7n9-mQOgoR|vDoR*R>FZO1c#@C)>5c`|Y>O0r*U4c!zENE~;p9R*kLS;w z4reBhwfseCd_Nw{8kLt%HZYj=!s6d$_Q-xkdXF-~*Le4ECNSrm0!?4mqy{4$K=p2V zX~Kd{l`-o_r~XHGpUc$b`JO>$gSLTolzWKw*-Gn#*vc?$2#zs7X`ZC_?n7YYdLXX! zK8v)Q*w9fcW{Lup8wXwnkU0k!r4mOqpA~aFOCO}q{371bX-}CwBwk}a_(-SdeFP(d zhTYo(O^Q%cH5YpME3?muZgwV;+_THJ&z4(xlq%~Jr35sKyV~EsTD(EI;p(?z@7wEeM znwV~_%4Z&QFI->NH7U@2?s8dp5ulB$p7q`xTqX-Vluxdf$JbsuhSvi_14b8u@fmjo zDZ-qQYfl7I`d#gSJxTCfHLf9Ab&7O*wHBJaHBpUIK8tU&rA&qALo+{gPOBTaLIv|- z`msYrQ71B@*XG13tgdQaGAa9>K!$J=Ar_BUmzd04@um)9ITg$9ur_z^~RQ1CO@vVCVy8*w_@6M&5`>sy>9g0o`(N?(HxGGb=7rq%Cz@eJ#fVI1>;F=mw8t_!?s0BapEOwhe`Yv z>(@tHfN0UFZV9|OTaSYH(1;8^XFjn9l1Tn#RR{XzzyQ+u3 zp65iCM^-{5DNT=Qh&1!)E&8WuhaELoS4Scc4#H$SeRtBpJt7r?+-CHhuck%FnA_!k z6d|KeC{ofkD^|owFtN9*`HPppO*;7S_@3w1)Kd0Fxn-9NQ1U&ECBU8Bx!&IC6b={_ zUU;eQ`zf{_Xo9Why_pWWaNetLx~TUa^!vLw{_DRHdDn~5$Ge@vjl*plrZ>Kqn}gRy zvA=-*D|z@sgYr2a*e*XWue_{m^(5M0^E;`p8(;f5dyXr&ve#VO;iafpM^Pm%gv!p? z0>U@vWSKSFp^_6G!76T5-W5xpUlhe3rC}gR;UOHS14R%@DJMS5qksR7`{?{vDqr4Y zso~=C%lDr`bE*yRKwy%7)oIVhbYICtxog**{%Ct+ZEji`z>n$hwXk1}=LE#C%<-1L z_7h8CSV>?66bj{;Z#*9>?X1kWa;VzsNZH^(Uytx!eTu}4o^RI9IDb`T06|Px(4?y2 z0V*;D;F~05iOF^0)b}HKLbhjW=n^JR^#0)*9}sE4asKH?;0w&Bb2n#I$$!WtXeI06 ztAu%O4W@LHvVfFp&$ua35*256R|R)Z73mO_}>bgzodv@ebYiV)tO-%$v~( zlZUHzFHWAi3T;};=s%=gS~X~Lnvn2QbGrI4$JBnj*(P&_Ir4Ik{}N6MnBfL{a?*!# z-oQAr_?`2To!g--i)X;hep?y%qn*)=YuM&ALj6%Oka1et zf%xmY;f>M4*pm^~{1W~XI1UV7cq%Nsa$wZej5RnOAy-6%&kiYu_|l^^_p-hH6gMr> z$u*O4^n=6I=%BMatrBiBC;yMD?+k}K`nFDp5~D{+)F4DKLc-`oPly(bGDH`{jNW^X z5+o4>i5lJL2BSppqK`Ui^iK5lj^zIDz3=^$--kS&GpFpc_C9N^Elk8fh1|MS+T=^<2 z>O*bSacnnJ0)MPKkI_QyfP^$)}Ldq_xA&Wf&uCWnM3s z7O9*Dc3nBR(u$O8(MSDV^nWC)n+VN;Wh04Xy->cc!Ila4pO`R+@Y5|A`}tEKoSv*c zOHrF)InbCXbJS&ujghtO`Oew;3#+%O$Q~e;#cF8G=WjU@w=Zm1rZ>8Jo;>sYjkkZu z#7C#`>F5qaX9V}Dj%N!jNkILVDvN>ci-EE&Q??%R#GFAuu&~so<)2uwE25S~_ilUJ z>H3?Mb+|il@D=+nc2_1h0%08yTEOk0t>&3}FEs$Fa;`^ukd%aAbqTNgq1+1{;v#G9 zjqhdlwD@ta=}~D(y3=o{=Hv5tCqaxM6!Dq&jbs820aPt@Bc)%L2MD%}!yLbW50K3p zZdrYkw0MMh2a}F7P`2qBlBV7YM6tos4?KF7Z6_SBVWH%Ln>JKVYuPQ>Mj?@?TKk57 zSJ}V!$iGvT<~Kd5XbYSka@)pgkp{327$mas77ez7{q|VC5lLvL1XTD}i+aheR3J?M zgv}%PArbj+JWKc<@|0$>uz{$qePv-nMd&6e@`(`$h;_CQiVS;+q{xSr=c4c|rq^SKKl?Q_uL%Dox+~vG-MyJX z?99==0B&-;3d9zru=zFKlz6`n%652ZknpjWgtLE85U?uTirZq zj;Iok^D`o#&IzLJpX304lAZa#n67H0?HKM}g{X zLG4;>3N5B(;vETrl#lh=@zzaX7BA+6O!YV3!ZSHBLh|?6 zN7D~)2THzRO&UUljby(Rv-QamZ?1`}usVO{z0%7Gl8B-?lMd9>@ULYx{u$CMGdpAf zRwWlO$wHOi>4_dfpWc&ft4Nb0Pp}P7*1MWUx8-FS7%5H|DNl-z4|xT=@Wv7}%1Mr3Ib` zH6r5z4OHrxRdqZq^uC3rdb30{>=-o;05ryB!`fupshL5Bgw&jvGZM7&T1CD@N1hj%=C41vvjy zZ;J|wv>nAkz+%VsHHQ|4CMT>|6H^rhB!U9L)$!f>hIkOdI>#QhF%qpU-B6!r*X}W4 z1q`k}zS4~i_aSo$_qB_Q=M3h3WN#t^)Fe3OMc zRM$9vC|F3QX^uB7AstQWppnsZ#{o*VsMWX`YfG2U$z07-R%Z7#r46Y{Z=(K?6GvQk zNGX91J}1Mq67f)xLjQGR*<1#n{Pd*$=d%ZR+VPC)jg@ByJo5YutgoLBn2u$EdS13b zi0nUP5YuZ`SH4smvSQPn48xQf~!^;G-Q@nc-v%C;tz-H6XNgSrNXB~Nv3 zTj~9b+-MNo#;G|ZJBtIqzX^888_n&_g0S#n&Gm?}Tx3TREC^^bXxG47GPY8D&-U&0 z^FOc#!j|rS1VA5|V)@~VOwX+vdHHyb-X}9)nyOj|G!c-&_5f8(Z;peppdEgKRa=j%4oz%IMrT35peL>!fm!0T&+MBYl_5hROAP52zd_4X zKM*D+9g}4h{$&_xCizaF19VC_9MDzxaY+ktZwzNsipKp!41L!+0kBw%JMCv1uQ$6$ zOR)YoIsNCvaB~50MKwuqxnf#xmzdkG|7Z~^DgLWJW9{I}n#3=pP(R`ir`$6MJf2>b)OA*6 zZ+9Uw*g|4Lq$t>c``b|m?0Xv2XCH)ASP(hrW&gK_#;GbF zYGZ|2qS$q)#G0g8xp0pubu@o6VSYTsg0`CHzE)Q!DiNbG&M{-(PeuSKJCBNo&se8(E_xiiThid$} zQp>r7+rSO7u9H5q;t8pI14d~QxatNh=h+s)omk-6=LwFd0NUVQ)*R{W1= zm>>;&5M`S%EU6k5YF419-wkHrGO#?n&`6x}BtjV=FXWfFu+rSds4Y@`6Jw~qrbW0H zPnRdT9wU`AZZMb_&w!}FL+ftA)k>0H*f)y_@u?P0qlA@CFWDY*7yU%uTf^G8Q>~zO zs!*&sUbj%I-uuO}S z$s?b#l=G7uON9C_ibdTS0QN+b8e#kU} z{LU-R6kcbA-LTJFqb&hj93O+(@#7ahj$+Ea<*^dI>eg&3{UpEpEsBEIy{Wo&9Vx>v|>4XH~CN7XaX3j3B`ob1o{^G2)Q;Eyx^5T@4k zh!0ZxQ{najW*DTDzjQ!o3Z+AmJ0-qCkgiv5TeC3UuD{*Q6BP3vL}OkL#hYrXNGFJB zoOx@x471$YsGz`h(XfJ$yv=>=ATA=y$Wla7Xy<5OAI*5tdd5fgQ(n(6Ono;pNQ0Se z!wv8J#s~@9A?fCI;qR}y<(${3UTc_}(`Pw+x%y@RVbQB^#Aq&p<}|Mvcoou@l_MJiVhg?+b%M!{rD&xP+DY19dbSL&DS|5 z=4`v)mB(%9Au@@vAmvk5=KW<}((YT(`wz*KD-cCfD5tM>0;^fKeYj6;d%T;6LNCH= z<22*JF>#tx5}sRN&{X@-lk)wTD~B4A!g!kcRRkLY=_kHEcQGbXwRiCH@BXE`pCFb0CwG=t2h>ry ziDdPJ+$1z)n9{l>vMDMDoieKT?|sa*kgM&D3($J22O^8mOjDj!6dxUHc%}-Rn38l1zMp(rcBt}Imac+QI3Lbu zNQ#9X?yv&+?~{I7dZ77t{H%WkR)1F@H@JIPX$iVstv}!bFzkj{EXkyE;(k-oWS~3x zICuuCP~0swnp6s{tN;hoKO1WO1OTN%C`q*xn5%1(8DVyUd>BIMC!4n+epD3rS3$1I zZ!NGiMV`<@P2~bpZ>0pXZ;q9fcl1&NZJDJN65S6*EU29;`NX13^P|Mml?l10gaVis z^qXUXcCb;~93RTQma4L@#aXWl2kS&Jx0F8p_ZP756U***y9TsNHjkrQ0#8bA#K->Hrvd>UFpH> zoE(f&!UEXb?{!&Hj6If&Z1VO)7DN<0_l2XvV#y_)=0!)dwE=#Z;XogS9Q%>0==kV* z*_#A^GQF8|AfModz4TbO`RSK_&L5?@4ta%L_rN{KjEb^yD(RnOe+b^TTN>Yey>5mo z-4~V_hqJ*15yW2goGsn&OV}sPKP_;jiK5ZWkqjzgCx(&fxjm9rh8gQd=oQcUhJSQ~ z$ea4#&5##ZzdAQHLdz#wH#ZC4Tb9q8zT2d<@vnphw@^6`6OZ1yc9~JqwcyN9x?@50 z_%5CyQ8tp7?D?jxTWRg6ytzf$h^%zLdEkdGOb~9QnPE+zJGI$5=*=974B8|h5hha6 zey1g%)^IlvbXz%-fl>dwItu3WJJ1%uf{1|w7rh~^l|jrqLuYOQtu%#-Y0&g$a2YcV zJK9s?g97dH!rvU`-G8G5K$>f%Iv`81qWd3TU3?OO+|Z#if>uuUKWCu-!}s#JxwAGO zO|`+vk2Gvi#jw2=s}?M+(~#b)Y~-Y?=?VGX$7{;{^a&dSfM}Zew{2z*YMd!P0rDVr z62`dGrr>>1jD}Fj*!EZje+HxIb1_OIQ(ko3G0ljcZe#>50uNcQQD8xDK=Pp-dyy0a z#|b>9oi=6}Xi6+DE1;LHUNHzWw=}>f7a~;NznSL#@0rF)q;h)V?wHu%1VPYPT3QaI zg%n+CBP(tzc=(T+gbQ$g)T~38^BS#yi-?QdH8!(2m098_;ws@%oqWjx{LEF;)Uuf$ zN-ZszN!9|Y-t^>i3^K~8lt(Ae)rUa2)y?80Z*H<8ph01U=|cH1OV*bP?H=x=IiT2$uy13=OX~!drcJ=G7C!Q@% zdW46B#$lkwrHm{Q2$*uEfr9WS=a00X#`t9dLYHF3e>v=BwP|8EgJid3FmjVM8Cag5 zCiKF6pNfxR{275N;G=%h2N`=R_e<#{R!*)5qLuv`BK8_dIJRFD37hZBv&l>n7LvTS zaM5odsZ};;+XWEPI?6JgGccNeHSr^Y#Cef!@Uulql{yZ|W4P4V_t67}E$vRPZ}vRd zf9J%sjWu!@(E%J+EH(D)`s>>1iI|h&ee17f=^-sGRP}}X_K;9;^h$Zi!x!d*+r;V5 zGF+zf(K2ELD2=cXa3JINY_iYj@(iDN@>fbQcd^o68#(wo=x zk1fRxOi~pc`lsOOPw6vA9C&hLh{jBbZ2XrNMdKk~;+sR>p$tm|G=f=?pw{@wSw0x! zy$Bn8CR^9=U?23^e8u6Xnz9n#&;EwrcLDE5H4E;OY{88El2+O16aIoY-<#(NEVv;o zy=&bB&D@ovNC>c{6+V<6oK&eYmdNaVa}QXWlKnEWG_7Zi<4$206^64Z+H!22i?4!? zbG?Wr&gg9flqHhsU7E#KcKXL!B&j(xt9$U-Sht*{E%)X5WHPQ1)9OA8DKw5AHTTW& zh0ry$9{zI)s%P-xatsIaEX)S5BT17D?A3e6gX7!RSY+$dd8R1Jkb<;I{UPbcfl2%u zY^MKn7);L^ycp;RL-@=7NHKo;}L}1 zEe7Te{v(%%(IIBs-{P?aOBG0;#B8bqJ$}(*n_8_@65XVhe*vmBAC^Ee z+>zaRd}SDP7;`nrRW{hUP;g+i5BPlM{TJsaDBcijZhl8{8ciA~LiO;O{1dFXK+V9G zYE506V4RjbqP!K`H@-d)S7yRYn3{LF{uYT1$aXG!TY%0aY-AsS&rTZuAQZ{VBg_2x zgZp<{b>1?Dr7msb7g8uH3)!lptT^6Eq&VrPQ57U%J8e9#o68s%T~;F>Le4Ov9%;xB z2CQ=Qrf(Zn^Z5$xHpJI0k!pg> z{EYXILqqoDAP`Fy@|~sw!g!_QgxYB)Ta2Pc4TBP+)(ddic$Ycfc>Xz+ZBz4RN~<6K zXA3)or=5pjsWH91zcL1`YM3XKiZjvx40MMjDLG6lL1}nL!jddAZ{|c3zHVeBgxFG< z>Xe%d``g;`mz2y#+*f~?{Y7E^gUL6$;oo@8Gq>3BFip2U0n5dkmq%>b>kQ84=t4Us zlaWzv-CPlG$!_Ce#E)-}kI(S<<*ovYRP!a9)Q;rSY)rbE0~xRI#XeoqqNUJaHIspz zb8nLKml!pU8-f_2gYAFDTPknO5+8uB;a&gLdxBC*Ch|7UHJc#MDWiBsTh6(Bmj8b4 zj8+OXK#1GR&axbP2l24Igm^EF+Nt|I6*`^8{z=#BA z#q~v*h#NlBH8hE5(Pe(9o9?pH7}4cZQiURMZnAGuq0r$AV6;0^TTTG5i%JLhphu?` zD?Rj#;Xb3ybojU%PutsldH?PMclZB{)#3Jt>2S>*ogo;AUr1^vof2#~;|#zoIR{q` z5<=rOWEqRaXvw19)lp|2p!aGU!`OR9_~r2yT$zQ&Pj&8=Q|tX^1@ z$v}FklK$gC$)%!&fAyU6xAFBKa*V`0n7vp+wIc8V7+UGq-jYF074bBUWud!`^f`eX z_h#n`S}~&J1vjTXBc5TASxo6w$;^(43!M7W*YDfl*^tLC_PaN#yVjcjfvjoOTJPzI zGz^MzE*^+nuKxPfXKLbbyCMN0J{6jVS?}UO+`&)~D6oNN+-;w$A1i&n75SYvJC=rB zlOZRK{>%MpPlLGj38mLF;$KGg4<+|UE4!JCsMUw0iV$gh^bik$arw>%katsWii$GC z?e7eB2?iq#xAoi#`!ohrs_pXSu{IFf?U{zGjy8MZoC9*v^~k_L-g~-2GJbrG>yvbz z^(iZ2w1*KQ&5_G+e$~!#oK)^6#z$ScewgMtl}Sel024mHSX=JR3b^ zm8N$?q(MAq1E3V_5T2)iyTys5#4Us{ZqP{WyBgGacOz+9SR6_1L9grKcnIej61)OS zcwD0mb^1%q9|aq$j3S}1R_US$>$wWin9H^!R8wB{8MYyTF>@!+4^Y3PycA01Xm*`B z)B88NhB)y%LF~$#zSCcVHy4K1f8y~1&fG1NSSgAXZ^ree7R%*#B^5rOQtpxu5x~`1 zIUU#2gcE6mKk1yuBQ%&gM(A*nkMVm`R1KVk;3I=5!NAs6Cu7x}I4b>_R?F~z` zEq2Flg-{Hvz>8yGOON-@FeruNpqREJUXxz*B z%&RJo1{d(mRpFqWeM9(58sw$j_NVjCJteX#&&{#Aa;(asu>;#w=jN-GLpY&P>#38c z!oc^oq3A5@hy2&v@Dy+jyJ|LjwC1RdGqB+n0b82+pUs|zvj7D~x^%<=6uN(XmDPq=C* z@zfcX!tI2?WKX7RpgYtG(DTW*={?oFqk25m8eT%f@#T>f`1h6hkzu_Vhe<9UZ4UYA z=_7XBHVoEs;o!+}u|<0IIuxE##H*TMv&0W)G|(brRlWz&D`litEdVVYd3LaAjGys@ z4a$DF2l8ue4l)To&m?!7D6JdrzWz3P2<6@}16`J=NLe{t4|jVM#~rxQ%)lLXkS=~^ z!*2ZJC^!8FJ7v4JfSvMcGCg`J+u{CkR4vc-)x(ZK`!I_QMS?=OQABd})cW=wfCMDA zoWNq=GcBNkk?2}$kgzQKsrKt{8cXa7`IooI7$~7IyjT=%FwzT6>}hJcAiKZ(4^4HZ7PE33|+|p zPWp^tXa;p?m=0Qf#_v|!Jlp*g@$h+L<3kP4!pOXJL`z~KH-UcWvYw@;z7}nRR1n`j zdFWkMz^m4Q3Tl1@FYeRElZ6cp9KADN8tR7yzoj%o zP?!SK<6y=eA9+PM-QTcQl|>R(#BR&8dpbmGm@g^hX^Y8G9t{$Cu71I-Fg+ip%2jc?UNYd?sx4n(@A37-8~?t6OA!-S>dXStG5Y}N^M zBel5a`GwciRVpFQh27$=9Zc#1Vl#UUzIEMwHbFM=hXAp2rT%SBu~6!&4Bo;FVfKVj z&23TaUN6hmc~yj}P5$`-mxZ1KiOqsN{6ke@AMN?{l?)i+euRsUfrX1mppdCS z%N-6@2lhFviyAUIgfzm#VP@;J?A!4pN5J>q^y3X{{J+`J2h*-TVG1MCY%rF)bYT<| zsavOeu8=q5yfX7wgfemzc=O{v0HK~+*wT%rURV*rCIKA36a~x^0~0!OKUW;qZ-B0uvAj7ldjzNWBMnjWiduQ?@xR- z-0bL=PW(e+Ebt^vw$2JikL3&YW*#=-n%pDE;2;elVL&crA|<%NJ4uxxG)V0KzvOH6 zZ#wEv3R!gZXYPDHZFYG59ln^V3z_*CcOskYryRdn55;P$Yw;agM8gip1gfsIGltiU zt*yI}f2O~Q2;Br42j2g_*~1ePQ`(Qw#2^_1F*=+2A}DklCRzbNsOTDJJrw;qoOJvz+Vt z9X>jivi8T)VdIDoYqtKUoPH_k)nQw;)Aq$7=xuAM==p&CAnk{{@E>i0z*r1_vs`Ye z+1qv+I?l*!3%FkQ9i$GlcEj(>?31v^#9$C2Q^fzRNdPbHID9p*$&*M`KaPy%_BN;N zg&D>CcZ*;lwq|C03g21ED{1v{?`R?X2Q$IMcJdKbX2Cy!iYG4;7tCD6rEFZhoAliq zyTwf{n9J>_na zsRQA|3}Ex-h_JV#G6O=#K@PX1rX+iYw_N#zgv6Kx20YjBu`;#Fzd)ZU0+W9O_OL-c z;j^t9Q6wPpYihFWw?{?9D0gj~4UdS?K;L(=wBk>-8Z#s|W!RctGo(X%!YzzQaSL_l zCd-#f`iagI>fXzLOXi0bVGz z?rHQPYq9XJ&zA7oRmj&2n_-zLv@7h|ndj9TOU`}C2ve($XO&wy<~`FD!&&w4o@lQz zrNlBp6=EQ!gux`37^?TM{6#=Qjc}u3fAswNiEc`mDFYGfw07u84r^m=Vfn=?jkz)4 z;ZxldKRbd=L5J|`=XZDCzY2DfW0AD#SOlQ^qo<;o-$Ye@)V&(-zKi(zC7#z#p%a$W z7Jx@o1@<$ZGC>4Z0tq*(--~1jA4vD+@;F5jF&Py|^#g3g3hTk|LuQ2SKO&!5v67e- zKIT8`!`}zrGs&C>FQr#Xm6aiPW&*av+`h4|qJ6Be=%3OZJH=t||LUHxdpb<{HG{%e zYqwIT71fF)6dkr#&wnQ6a5R}t=F+?=*K~|vUK8e!4JiUzvfXrOQTNJQICbEmhasM87Ovinl(}Htt1h^h; z-U)ed#dUu^_Wqoeh@AchE~5vT_z`tc;_Id(DKbAXGR4%Hskef1OOTL_VTz3TTOL1O zfGW0>5N&!Ns)g^-(TG|AhNU~s#;7c_SNNY->4qfAzgByS4F;s&j|3=5*J-QZZhFOp zlobeO=YvmiCSE+{XZW~Omv5;Tnwbj~Fe9i}~E4}T?V_viVb&7U($Enp@ zx5Wy6vCL?}Lx3crrNLRa<7q=ID7euDfcN(Jnf}kad#h=_71<#hIZ~%jE)uSH58QVM zB>iO-qaSAYC+Ac{O^9ZFFI7$wJ0wUy+kry9%>4Ow7|cblLr)|-21dft+attXV|h!CQC7OG-w!98Qy0S34B_4X_>iZ#Ou7~R)bM+Gr5aUC4fUxlGZ0t z(SB8m?(m@bdkW&wTC9Igt~IdYdz~1Wzx}33G{RejG(pZib^$g_uK+7LT_pU8jYv zZKGW)%nS<&?Z-#-@&10tK=gGXnbz1BY?Jt4VQlNg8^|fXKEFtW{ob?6@vYzu#4);P zrrkZ8y)djh?Vky)-Kim~m?Q3?5?j%CUvm+flbSsu7RYRXG`{i15RVqGp58mV|MRe| zf4*u51xOW6H04*_`#Fh9<&o*df3W||k)>3_R&}5cxbrZu);_GKQGUG6{?$Epm&%U| z_Uykkyy`Fa`D8Y{SrO?gfF+-rU#I5SB?`$o{@#*wyAbzf~f?z z6+p2NeU#cjO)6(#Z zDgUh099M87!0H}3A1qqtyqk7JVysao$&bP#YaFOpNF$ZfkgmfENh|d)uJUl$cW83xaM^34c4+>I^2zI^m z@C-vc*T1BB!T&}vUgCexawpg2ZcMjawMWm4+^j#p+F@aN^l`w8te(>l%4IA|MIWK2 zp4vS8SklK2K=V5~ON7DyS$MUIy1gfNQ0 zf(=VXg*Qes+w!?D&TOrxihrx5&>@Tk%bHx#kA^}5Ko&tU6}I4bi)>jW*xLFM~Em6)I~;# zvn?RS;dCj?yL(XfqpXV#L-VO>W-I(huQ&@i+bL~+&P1Fv7N zVudQSXbVwZl_aaP9iRu#Mik(vM7W@*GW~OFrzz)FOOW}v{f3Zz*x@Q>${ICBBR?O1 zwmZG_4S28XqfY&62|*33qCfQQ2K4l5dR;}F(?Samm?Q`*Qchj`AD7Y==9lH)_o_;t zSoa)hbM>JL%Ip=C&Cg%BfBr!-K&~zdaI?OHlK-$*#&An9_oKV0jPh9DO4}zDysoE6q>q zS<0Dwc`}pMUoa_&5c1V2l^sn~9s8a83;PNm#(I5a2brX4AxEDs;k(_Yc5IS+Ftwc% z$@;BYx!hp+8OfHIMylDW&}ACP?^D*|r+fY3azd5(?zn?mWo6lbl}IJ?)SgG~juhU;b7C z>w3Q}fr$P{REcR>L}o*xv`4fc0Z#MDg{>_KTc@BfGKP;Ke5r_jqt0*+27*ArvyEr0 z1F{az%H>8s`_M0mE%h&15zG3fMavvER)tm8vyul+PpImB7C+w|pT+vnzH}#$6=ixg zaL0U~C@#UDv(Ks%do=d$^%goF)qK)*v!1yob@`9+f zF^s3y-l%7*+9RzhD_f#ZJikX?w}f#wWHi$OQtHO*vzoS(B-^h3EK}8PM!6LZRE(%{ z3QXwubVdVJ&<4`u{(+-{6@9X_|0aD~<<> z^W~e!w`!!?%>E}~0}+G}DpLsSYaD*~I}ht!51JE&mB;MAFPv ztEWfb?TEg*zb^8l;cI^}!Fn6IBtqX=!?nd-m}!h*PsBS}+qd~^#8GIrLP7qri4S3e z`y$OsRL%3|f~ggj-!f-)1b02?$!_Qv89x8&P;xnsF>}~vFcv{Z8Gr;HWS3L+1nsYj zItkAy47faPaG5H~aX$#QuiKI6Ku!fKlRnvJJ9@3$p1%ZTVhc1i~I2Em>!~7J8*U zORKTl7VN)%P4qG)B%?x~)6*lgmv(2*a&{@{{_q>CG7eL~xm57a{9RLC(enjueQmw4 z`#-&T$rmeYC_B_Az1^LfxS+?Lc)mrxu)FvJtKkp!B-;;Mp@2OY;0W2@N%5%fxaCku zyRv?v<3Y@n$5rCu7YbuPSkEDD|6`Ksp>o=;YkXI#-2Gy)?zk$Qy zT}(S#rjth-WBs8d^pX+E(@iz z{KQ-WmRW$GT<@In-RCG_bDQ3-v~74r*9ZPxP~d4L+-q!Nr5$FmGi!ct>W9~HHFAS~ zoun@#zl_y1nl8hZrYNl@Bhao4VkV!JP*CVK%U98s)0ch z=k&=4^!r7R3EYHX5<($55*B|Nwt>(bIKCUpqqm>6?y=mukcv(riJMugH5xT2p<~)# zj#6pA(t$XsMD5I)O4%wG)}(jk`@Ac-7}q)}-J|6e08I`pb3n$27)k?j^wqq2tl`z4E&Ir?CXq-;&2;7T#%X zKnfo1F1KOc)_YDg2H>(8G!LZ9vaw7@-{)@zVVpJT#og@*YYD6N{L6S)Zsm9os(oBm zJ*bL18Ye1k_{(12`mZMyQHcxG=T>rT*k|DMj0H`7mZ|qSm@b}@Dz5p(q4EtzT`5sm z3e6)aMpUqck|3Yj{w#oNk70;NA_sZDN01ZW^;5U9eZt`jc^Zs_s?5yl=2lELzwvUJ zm#KB_7C1jUSy?N=TrB;FuoOe&8N0+?rR)V%!egojOa!#s_7~Ib$%UBLNPnF8TzArO z<$>jb{UfGfU zR7rJM!&By6rp(JF`VJF!+YR+O@0W&7=);D3MjM*)yR&nhPUs{$=!FpvO!9C7y68<` zqN5Yw`>3sn@^|jTSk3R)+3^lDEAP^6T>LL}_IYNpuvgtqtyt<%$iRdqs17ya=@?abVHxR(W8@li-_#9#_dR) zZ-C-dDonh&ED$41+j`ch^AR3#+q#g=yAL) zA=9}vn5jru_UI0z6*8129VFA5^+CuMt6(2r2uPO8uQQHgB5z+Yw0_KPXYdj!oN%d^--*h+Ek%MxOOEEFyb>k`Al9pHvqh3gE;V6)Pq-dQKq_n%2Ak= zlAEHN9bCr&2W!kx*v)9W|qGEeQrQ$OU+^=1diYx1>CUU8L-e7UxB zLCKbl=hUlAg{k+*`xckn`3SG{A+GST$!T+y5KEgTn+pGucUXwL`Lm9eRX{eqhTn8e zQrs)r=WuiNwZw;ky{o zjTr>m^KcVh?{!pai$Qr9xfLAnOQ77!CzGrTUN9V)eR%gY+@9S1*5lH=%GEEDwGR(9 z)GQ>2DJ!z>Kn*0-d=PN*hG5Qj|NpKe`&snyW?TNKDV@0T=mEOU7yClVFxO8Zb@sP4 z2nsXujWKjL83e&pml?7|LWtQ0x4;H5^_d;~RcMR|L&()5+o%ug8p1C?Y+K^31F>6p zz!(@}?d5speLfi3KPmCta&ogx8P*d)blz}SApr{~Vcl%Tr*U?uVE=I2jln7*_|3z0 zoPF-AYWG#%{iBdRAadaNPnL|D*C4G#6U|il%yH;cgC^(r8)l;ktz8H0l>C;Us%-1L zezbXHa(z8=(%QzRkbo6-EV?mV9z#OMHxNoZ)rwE@z}ie9s_YY+g6@u_4{Rjr!wrwl5tkk@Q`{=O%2dW*O&4^QLO~X6YxZu0GP&X&T%Y&S07Fd*2_h5 z6!1$?f*P`BQaA<1ov4AJbW~2CeQg^F39^;8e-B!eTN0m7RGuBWYp^_?Q9+}he|a*Z zs~uwtGCfhBa*WhKwt&sV;aFrBRg&I907<>=gDA`I&d(2nPW8p;$@i`RUWh~`?vfYD zd_D9Vd=VX$Tya9@Ud@n#mbdCiaMyc@2ip%EUJuUsqo+W6>Tv3zU(RaxmId{&>V${950A^YcTS zrxTG*E8`q0c<1@rQySDNAQ~3OMEvR|tD{39y^wh|vHs!Y2C`zkCJy~9l|Nt3%*|zcV9Mg+Q!4&2r+v)bI4{HXjA_L*_=F@ne7J*wd^A1zLNxsfYPrrH5 z-WI5{zYv7^=mZcijpE1&5hivG1Zg_*HJ5%?^{Yj2mJ=zVugpWW^k} zBBF;i%n2sX&N&qvwXTc)MrXrqIkkM>yV_oP4kLrW)&1S2m zT9#Wjz~g{;Ho5tPx1CJP>igdE^~Zxi`pW6e>!?w^7@CDOFdb96c3d2KXfwXLn(}G9 zhtK9`cQqd5`*-#5;dnGeCB3`7LSQPMx(`&*=+z#(qC!nrAgP^wcL@C&lC8`d_wnH< z@D5dQb6}Ol63$FPVIHTysSR}IFRlV>AAW80^c!kZ^*y7(TIAPVsv{k>(&cgH;LHWr z3E%wImQnEzP+uIWR(jx-sXhf_Dt0U4O<+Gt%MKnpc~F?E66UzDb*gftepFs>M^^6B z&iizEosL!}Z0XbczfUta_*>@l`y$TA)t2;k5g*%x5XHq+*rxZBF@6_j=U77p>*w!& zeXv304VVL|+iXzD*Vw5yloE4|<#%1^1j5U=F$g5~Y8L1P6*wiY+oFf2hiRVb8B=4p z;2LJJD&A({g+0c%)wX%LE1e%~|C9`6|2QI+k%Zx7f z&`Sa4D!@MQ#HNi^(XODDBE-xhGRN|##%_bc4jT-v9(KP07-y+H!?a%9l0?sy4@a)V z0gIw%~qm|?s| zLX2y%rZgc!+tFg%RyQdzRy7V$lOmPy{8OSYCAlSS`jPxQ{Xf`3<@mQ@kOl5Sf(&n% zW1tPP@?ikqM1f9m?o-{8#&})>Q*ptuA(dM1J7D}*g^#%< zXSmnOsb>_%30k#-@BPtRXb*i~ltUE!wx64uhv^r1w}DV;4nqwT1kHA+9vOO~>6wZI zYWuggD=cfPYPy(QYFDO{bZg3eB%AUuCqNtmtb#&*#!0;etym zm)F-=eX3st+4UuxDbw-P!3!=w@66~z`$mH$IdzZE0x!LO5qrVcOp})moTT9AZ=$QvBJGMW}yKu3Be zYf#TrPK9$hZQX@c`o#7h=h~cF@68s;j!4NP_-sNOP@EVs6u+PLyw1)CBAHmFr4QGR zI^2HyE(o8bL`5;G0^vH2c70Hl!+3sWwzZlWjl?Ar=M#5&PyB$=gqDtu&a{s~k@C@} z9N;U$!GDyqEm@YEPM3s(Yx85&pKo@{9SYj8({90U&HNA5#jh_8T-z$IOM0%4gpw~8 zHo(IJR@&f_c9{?$0`@_-Dh{vQ_D}^~mC@WjGCC!)3I($bZ8idqpwj_3&Vj2)P!&%AxYQ>vrCzIB)Rd56l%`L}ZK=#aN>C*On-M6y(Y zb+q-VXR6=o>CPIv<16B&SF6Ki2}nz~kkj2qbX7T9B`drj%UT4yGmHXVn~z3mQ%l$n zI|NcaO^~CP@pwB;E%QZ)=%#sSzhVx#RD2?ryvyo!03`;;b*{ph~KYO`pG( z1m7Ds9kE1Xrk4AY-<8w$mWM_xhdqh3gQq_rLEeurc^hn+`~S%L@^~oM_y3AQ+sqIu zj0UB$r6OgJElP4)EM+ID?EBcuIwD#~B}9wLzAp{JSVBnlvF|%$89Tr0(K)B{`Touy z=X^frb((qRdG6=B-rIHG*=M?5S=ezzBz#dq0s9a6@v^W&FG8kP@0LV#N^aIGO0c!PqSkn&F0dpzWhMN}ZVhqB;d-_ATcq|Ka zc|y>-49@?hl4-EF@=^92jpzRNn7OZWSzT{C%5ud3MANL+>7J%!eeU$vm&{V`Xr~dL zik%U=6_b0ItRpAzB~EmcjL09j(PxjpDdsVNvmgwu@n9z&I?6+8}isp4bBV!45<LBl$rOiANsKAYyBVgQxp>g6NG1MYV$Al3c?Myupw6h9sk5qMRUS&Qwf$3EAGT#QLAWx?j(dED5kr;aH<_S90d-lk8Y zskynl4_J4bK^0Eu$qO*7Rdif4&fJppcwr z%|{!KIZh=ywRN27x)UNpdzqhZA0wvjJ9tk>Ra(=;!bf#j?{4Ztpb%MKB7|m^jtJj0 zveSN@sN|5&HFAf&DO)S#%fWcz2CbOfwikIns)Qbk7sUR=Cf`qEYBKs2am(D&&i6*V z(r}kz-*A*8?fYM2l5dmezl@o5zNayYnl#?cz&i9$~(#%q--qA~$2UrKWu!Wf#dh zqwo1Eic6*w>pXYWb(&gkUR)*8me88M%1*f8WH+`m{_edrOI4KwQ&nFvSNE&eeS2oL z)$gXsOGS3oo3HiRn5v7HluHfJLNrdd&W8OE{~X)ec`qTQR5h%rrMC|gmM7FdTaH59bnY-))MmvLv#$Nl%f)lmSnwo5XQP=ZptcuWiGQV53BL%^IRi3 zIo$ulk`CGX{HOV~jLJ)03%%>*q6QJ2S2WLA3dj`)qjgdLM;GxC1zki(x${HM!-%!K zd>&bz<<}>v*~eL2A`T{gh$%WAA8*mqt4JH=NTx(ObyzI4JBLe2tsjdxY4RxKbJ`#q zU;UlH>pZ8h?@t+d|{6ps_8mpG)#!d2F=F(y!ERE#Fxh&?n0?vr*!Jt=)T`QqoOpiMnHSX@>FaxA@46IE_u2`F|jA z-no(GE8BL=6AWHAKmW8sqgYX@L<-GOGOH)bS$=w#!mBE)UKu=mhp- zHP#rf$(Wm&nMr+;O=`B$euC!p(b_yJ?Ek9@n!aO_rOk(B<>lr3FE)HAxc!|uLe$t# z*K=*&v02xt^_QBA#jiNE5a~hXZOX(FJm-(N-UIg^3vI6zNcgZVHT&=zJ2SVM9y*3L zapUrqy?}oy6Pa-q1xthCw*AToB^YsMFpti?uI)-@WfGMmHg3L=ZA#Q^#or-ig}80C z+IXYqPh=0Mwf+#NR7PS+`m2=layK}rU~evU_XmR_t@ z^|I7{z8Ry_%Kj&BZbauj{mMs+{yN_Lx@5pPLssSUcnWU_zP@1ESEL0_et$asrF5^F z?zN!u+^nAoX}QJ6Uz74Oz8_>0PF;6jX?@7RZQdm@RXFix%DsH=IojPZ@lP@wfjRkn zO%L9_DHiN6)onszO>lT3=YP5S%hSKP`l8shbcgo%gG94fL51962h~gZA|Kz->%J8l zXyH@S@zKB<_`Q_8TlW^NKU5oS704#ElT!KUQdGtr-xppE$s>14cA(PpX)RU3QZ#qR zYEdPMp6k>-`3t+#k-}k6P&`wBP4IS}`Rwo&EtjyXGpg%0%0z~;LOVe*9iQo8n{$RO zoT~nwYc!#gdq%JOvr&1Qu$)B{i6|RI-*v;3lV_5M;Wb~}gc5~tJCa-%CZD>{#w|+3 z58RdcwG@QzWHFK8amRO(NV-@#E&R4zl)N>|9}SfqRoQlbXTV?Aud`UpvG_eaHvqfUmQUsm zVF4+Wo7Zbw-Hgd=%j$69pcrR&m=AF|rODDU-14O?y;pqr{>#b1xXx>-Bx^a>o#{_P z24IVmv4c|kR2gx9e4j-JUp`q)d-Zy;y@{oP_7nWq^zW<0Dlt0^)kK=j4*p0lRe7Nm zxG+C{)70H%K21-`^_DuIz8nih{H2m1!{@`fw^>Uk-a8!XJ@PV|wwecd zaq2Fn%s%6)>3A07w&}E8m#)}N><|~rg^Usb&3jBveKFR5w|FJ9g{1xJkYkIdo zNChNoX*@e4{z}aG{=FZ0lOnY{!*7nf^)7|QHONGrQ;@>u;=7{8uCLfg)$a=V`i z_gN_hHCaipjUxO;`^`^NR_+ud=HM@z)W5&DSucK^=`s(IStpPwo6nb>9wYA461zX* zQfXV7&gLHsWq_xR*4>W{I%!h5&lR?Ll~2*lv%g2o?PuY?l3^O5-Y;~pPDB+xjXqihvNFi;Z{BoLGmz$KkGoSFWwFrV z6fH$1v(RR$L?{{ee#wzlt!DSpg*3!#ics#yCz>Og$3%8lr#QtteVBh=$u1F+0TA1C zDOyWOp3@Z87?!#G?;PoH-oGe>D7*!m?W2}6`X#26ja*C9` z=iuoIm$_j>2L}gSOK+qkVcH-*G4Zi8L81-*Yb;YpCzoSOQH@03?tnZw;-25z558W(jR&+cv|dZEgsirBTF4jwt3=yALV^ zJpS0RzZX3Gzsi?OvqKcvdD6~xx`=_deVg1w#Z%r1I_|~ujH$#NLRZ#2`yuJQ)7ANN z^(x4N4LsTR%D-S0Kl08y%kAvbam-VOy_|Q;IqibroCq5Yb@eciG!-a4r;yha*37WW z@4I;Q>3|&Z34iJCy{DD6zy5S1tkKb_b_GW#L@r*McRG2 zg+XRfmP6D?fsr3-XPWOW_80YD+jq$+*ECPtU5-g@VT?k9E~9>jCUw?5cylyh7%eHjH~?d+8qR^_;;ft*tz>IsTr9 zMgF-7R*6@xxVyU($kKCl@-)y8OO9N5v)_U-mt4jr<&xpv&&!?K;nd|GxfXlMeR&RT z@BFRp2~K`o&2#zsNYTBCtv%b5+wE%3@*Ay0+1FpBeO7Znj`xRTi`4IqmnZz&usGW9 zg^t{(K)Lw*NGsfQ!>;9~>~VgXrGWg!-oT#EDwl6z9ch`#?m}`RP;{|lbK!61oUk4N zMqCJ5`SIrLsnLmxgoR$I%W^)>6PeA$$YCV^+`EJW@Fl~y1);{^ji*SnS5|sZp8Mq{ zVOQaj5>}j3dyb7`+r7Bfg@T2A!t{aSk-Qx^wkdsP8|&n}(c@ox9|>HNvvU0uAD<3z zK(Ope)4M&EN8*}?mw8Cr3^}F`4a(ko zFNX2^^F==N9l|9DLfcp!l9?EdPu^QwbKuk+<-cJICcH4CYn_%&6`WUK>%PtaL6&Q*J+3Z5k`tvIB)RhobfP z@qtrE6k6eBXnPkT{dzv>K!T_Hr1!tyub?Rp8!Z~n4gbU}>`T6)P^4{{Te?2&FVmvP zuDcH#4YkD%-*Bn(DF>Uv&y}gdF5!a3UgdB-mwN>DzNJTX7ZX}f)ku`ooEsCAoNu_k zS$&@JDmf~@Y0vuhn%3c@AD@sAB(s||UA&9>SC*Kp+~4!e$ir>B?i}?zOz}X8<}B>o zyNlv7mN*gV)EU5VlPcznJ+COSqo5exvs$GnEJ0DY2}OJhT_Y%Er%xFHR;ruk-`M0`4hqZdAJ=; zkQgzVwN1R#%_^6`v}$NeD`s=GHlm_J-Se_rwrV#kY#J@F+-4)jW5!KgyRdgwf)a@< zzHV?{Pb!$uy7c6mSiEoCr0~~qfTX#m89!c~;>X?=v+Bf0;GJ!Wk9-Wf<7ch%=QYU2 zs;K6A)c4?r{ttAaKG2|~9rMw_dia%FFx$w`QbSsQDsfx5PUSlhh8@LYA_;jubKNeo z50c{J1I-c=4-HE%^*^VU(<|JE#zoBBJY9?N=lnn6AWL>SQS{Ws-o#1LYz@^Q9`=Uz zd#lo}LGFOi3?=l~bvc8T=E8LoWM62c+2Ke%xq%PjxL=O#pr4;|8Hm0<Fvi@q3Yv=70t0_Wedm4OqT`WME2Y-~)v zJyO!i(rtbNJ}1cE9%HtUMX?M#v4?2INDBIis-t=HPkOGFdn$a|MY3l)lhUl`+S+Ow zZQ+k~xl7Ce-eY284j`4Qd57n|L*v`9StWjZs$4YptgOQuS z0)9QLvMzaZzE0t7BKmQ0(cCW>i^asmaNl}*RFtTW1MOXscoGF2W~AqVf$8hPU{EkquJ zv9a7LtK+jl6pI?FwZGA0FS zAy1mJt@Jrg-3gjVDcOq&VHLTx%v3lH8<$sqyb^iP&JEDaB6}&_;3qpv>5ZjY z|LIoNZ_g!tpMLvAt3Fj5G-jr5Ewnyi<(ZCj4;y!nabxblh9-tDOgIIvXq6Gu=lIRz z9+P~LeebNp`;z{!u5YP|sk4W63 zbA+(QqanRE_bYXeoE%#3!G2N#7nRM1UCmJ8GRYU?NWG@mKJi6{*y@B`bQt*%j`W*@ z4!wIl2Tw(hoHP=iR@y;7HkR~N7;lcb6Y$~d7rRRCEy$McenT_EKi~D`2@ch<0NDK< z+4~plZi{y0S;U1I4MJcIud^iEbS`n!|6t$JExe62^}Q~8icnKY^8mGa6?V19ob4<` zS^@8Ex)_edTT<9Jnz{~QYuyYoDbcI_{4_X}<|lHd;@34AWrAAH9m3#eBj3qt;28}S z9Bs$#-2W792jE$I1v#T0^>pkK+QS$sVSpKn4SR?M&C|r1s|G3akILrLLCj5TdiP%_ z1Y4s;2JzMN5O|1*djweAn%M>qTMEZuubdqSWfZV3J7C%}5*KaBA4Q0@fNyDn5G~lz-!kyoOI&5HtAHjYpM@`Xm0;RAo`Z&q5IPCR??t?NRxGH*vsi_ z)#cReGp$+1YXK4R6r3E|Wf*m0w*Vanc6T{9YmVNuxY8W^-{=-wS5=_v!7}ckv%}G~ZdA_c2 zV|_)wWuV9nublWUS?OQcNK8Vmh~9{uYU=#pfY+o+xGtNs>&2-2F>SoDE79F8asAV~ z;GH(JRr>2`k??e$PU{R9-uhm`GF5}HM!W+RKJ_NT1J(erWdpU5E~xK1P^w$Z*d69N z->6A}<9z$J>cfGo$&oIjpR?e9_@BA2=_@1teho;ddc}6U9cDUL7;T4H`vU{XZC4RU zQo3VDPoTdl#&1jN^OkqyqSC%}sowG4(!jnV_5KLUyw4Nx!*I;WYFZ+qnoFp>Z!W9Fc>WxyjoT<~S1;ksI>e9Pi}&#nS@-XJ=! zUOyj(Zd6JRTbOxhYA1#j*XwCtsZeby3*R2?cXYG9PWAO zmg^)?1S8|~SXiqWxAsjXDv#q}lNY*58o*;2u%$Du zQ?6YcsZJXUo*QR+M?I*4`avyU2~#{XJa(jR%|FMXRb=5ylw$vrte0{~IIYY+=pX9Ch&u-- zkVm46c@N!Z4rHrs`g}d^LeR~E!A`arFYQZ_2bvyzQ_=G6De?Eusq(H*0=@$|r{!cq z%YJuahtJb*uIwVZ#aK7Ex4T4c%3)W>O=SX~>>0b&ZX!+YE62JD;=LJm??6-RJ`)B(KHUYhA{F`yOldkxeyHn?jcZmdv z%kf%QH{EC`JGB6h)q%i}E=2Ns6`c{&w`6&ArrcJ&T#ReMUi!bU4lo%O@8;1ng-bus zB1^AjL`|j&Rwl&*o?j&EUdN@MdU&X!nYIA@eL6HBh+nby!sf9Zm^8zRC%B%Xz~N;8 znXS;h&aAW#Nt>F!vAIAvGy5P3$V=83;m~03_RCrfK8Dyz$6_Y_O~JO>sPBDZv&Lw- zhcRp6pG#>HyLR*3S%m$7RQa^0NBI+Iw{CTVKO(~ClU|a#n^@^Pnr>)ll*v~}FaHeL z%vkj^9q&DM;_yFf8K{Egled)bMPs2_iNsJh-^jXMA=1mk z$9>z}^flRkwa6G{OlCIg(HfII#ENgYA-z_D1X6flpP$oFs=xEwwhcJ%u@(VBXjjc0 zMw5Xe1$Pnhg%5g6Wh^y~cF!Vz*GL#8yq7s@Un+x)Xa2n~%#ZR7zt~E)km@D!7OU7- zh91MzI+O(+xH2?N!XlTGUrHiGBJR^k6`L;H#B-wwzl^A@%%ksc^!47v?Yk5|S zQ6QQ#;Dbsm>G*V1yOz|Y)+vv*1r3>N>U_meVJiWDK<34?#|O`=>;;0n9$R^(ym2n}$zUapF9~;D1Ei zOuoB|(CRTP&z&aXKBAHZ3;z~Wc=@|JX}1G@Kq&&`hor-HT~ExF*eOBitqTfjcF+H7u_jT$$t zFnD_zYJi%8@($-=O9_P9tiZ~(Qj?m$@rK2N>1HFvLb33D#=yiY`u57oN@dW1F~?&~ zYomHBs_8oFMPyr^61l78X?xENzuo^!qfKDA08~+gu7PbXmmoGW`=mBp^P|{{--F)v zLeJg?`U}5zJ%C)Ccr!AR%W9&%n^_<-Ww>ArN6P< z>uhKQO99ASu^DhA22SC7IZGl5V(>hH+9A->Sx)>eSPZ%yZ z_in$(L$axPdNzyWLzj{34u_+YkxOeyu@;f<#eVGmT+d=MX?54LmR9;EbQ~^L5EQmo zPw92#L=Fu{L1CO?wx7kZ6Jr3?4rQs-4Ll=&uvc8d(qjpvARXnoSc2K59y?jKS&9)V z-xspOpVL;^M`u4+tW95c(}#gmD`f=o%O*P;Q)a|9g_7Pz__Xs4ibJyZ-H@VexYg(B zJ!2z-+JrNHkb!DVIKS)rr?{Y}-SGaAq7}jS$X|I%u zcwkVjE5k}M2lXfdZ5n2>nhy&N~b2`n&|t}ywu zn{?(R+97WnK&onGFJT-zgl<Ql)+#8GK#OTU_leYa8FE{GsQ4_YE z@q{6Sl%>Ej{^b!Vx{>zu+W541;ETELwL^Ta8-ORZA zbPZggY>;8UNSK<4;rdc_j1yr%#`5VNt^yX1CkIkm2kPN083Quem)}ZD8=7Uw+&ZG$0=H9WmlfbM4uF z6KRp`dIa1cpHDGj;T0Q~oP!0my!cKIy0b->`$8sQ1(STl0uprk6^;>IwAKH`ht*HJ zer@xwQJrJGgM(wQSS~fZ;}Zq4ui@|I{Q@__&{e6dcWG>=g07sP+lY#O8mLZZJ-T@& z*TMcsK?Il{-`u3^+?ej1G!eWgS4eYBivB$*pZuKV(fA3(d;t@oFb()p@?jfp>H&@! zAP;SDTdWWdKo?{vs?r14CRe$fmx(`~r*$-36sMr{L|VJzSKQ^$`B%tcOrhJCqA5!{ zGF8Cm=9TM&u4~MD3wISH(O(?oyCZ^QWbAuTAqmFOH2wOBn&&~>fluL*b=fue_ef9f~^q zlS|}gS)Y2ouyXTty>{ILobvT~c{@N&5*xAe3+3-hdcXNs!`bUbiWaa`G#-PkqRd>k z`0!;xL0Zy&#MVMUE`t$O-NmS8hIOM5&I#Z2aqt%~a#gIw%IGT(jFl?3(X8BeJ~KD# zBst^A9m6eQ0)G(&Mxn6AH)=kHqvP(GUQ136S$6^mI<2mo-OiCIU ztrsfjdbh$GGlB6kw)iP>3tq2F%Wl6P>9ym@eDKPz4aeLy*@0603dY35(ol3ZNHR@e zV}<8=I~i#LpU# zSguGI`p)*Wt|CWU>Uk`gYz7|whNnhcJiiOZSsYs9$S_Y9d>Y>{3~-B#={i}DbeAr7 zd!yPAXQyW?!I~|h;*sD|r5yoxQB~D+9pS?`} zUq5(TXpb0aJhfM9T!c+MvYs+lnJoQV2@?;rEyuuR!lirxrVUfv<1fj7L#!6RU}t4aKY z@X!N>7no++#|X`{Ep(1T9CT#zPXL?#mMvi0gId1+1nI5UB7)AFI)4|*^%LXlM^{8a%Q(a0A9 zfOu;@;17>uPE${meGRRnBdi%Itt@XdeB~dEY1;PGVYn^^_lW0X(lN#o@_`F)@&R3r z&o}F%LNw{sNR~_i573mHv;?_Jb#WF=qRXc+LcIm9!1j#U*L8pZ;I!f9lO_g@V< zW0P&!(W}GbmVDQJoIMsV>d935&EXPE==}YwpaMEp$Y)=^85Yjx?p#|jKfv|fahgYw zBsuc_`8cRnLLYuzkrXP3RXZC!^a~uUk?A=gkjA{yg0Yi`#$%&ReWt6Q!cBZa?B*;- zq>%kSnOjBoJ>*J#$&ieB?o=g|odI$dd7Q%DxRB5aenwIl z!}OQ))g5-VQYt)4As%zQuA`sh&Ce_^%<=9~utq*xzWfXKbbg6Z^pbwL2|6I&(8WAQPUl4=xUc zei~3!MVppb2cd=obp{bvDTlKLLoRBUU)j$SUe(Y0hi^*ac$WpD3oW)43SkjGgFZgzW8?%=@)X?K@9 znJ#U1f_(kIx9mn9dIHEskFM;}O9VOEi2Sm{{+B9m@B~oP15tUJIyQ>t80>bN(Tb;(QQ5j`Pb&-W28l z;*;{h56VR1FJR)AXfM>Oi0lzfd#BLBC+B!r)D|8XQ|(ZCt+b?12i;zYL*yB;n8fnP zKK|buN^jnJqmDze*_ZFdD>q#=8d|2uKq_J(69K{4BYs-~Oh*8wapCq4)rM&k9@MW2S&6q6h95L;QUn3e@p~ejQ5VoYw&;kuueL9tgUu5 zc(!au^Uv2lS#_d+pXLMCge+Mh`8J;Vj~)Tf2Da-pg3yq4rjt+tt!h9S34I}HrB06( z3++7nksVUeK6zW3a`Omz_ac|Q|0{$bq$%xqjJU|#iF9%XZAK^3%8Rd}9wehU} z=O$#qI=C!*Lp!pr<*8i1-yE|pcYlbL(v-lg44Ce;uU%`x3hkhYwP68aLh8&52@ugB zlRyD`>pqy#i3kHVoCRy9(-P=E+Oe6PFa(=>@C2(s&NhO+BbWpL>EFk70c5#j7MKH) zazq8PybfvLh4wg@LRql6P(qwpQ7W%P#-Z=xP`Po4AXy^mROGcC_a>P0Y&|k|M*&#| z5xCOPm~W7W$Z~6|jr~|+b{13)N+-mNT0vOm>dgJF;*^|EOIsifNo{6uS^{%a zxI0OB!HF^stKCXXT??% ztkv=PX_3`>MBx^h62=sh!P{+Hz*O{LLPOhvwLH>+r>{hqPI-?-jS`a#z1)NNVGQ@~gKBnKy77(w7FyGYJ=vx<@ z6a49GEV-olnlsq<7-2e;;rd^7Z0OOYzAfdxPf)~)_}Ii1gzWrX?hx@62!-wQmra=1 zTku-*z8GsRpoy*2I2EwO@{y=z92o5dX!d5!noE)#NYP9b)-cyLkjB4aQhSKLqUE#i zP7h+2_bHjT(Y#Uu8AP|OY{1Lo$4>>scwgRcHxtT|8JqvU$eTe)YJf2CY?{Uep+fP# zFW-0N`EN@?dKwVlKH@mx5+};}1A5S4vauBEh|1L?|5aR9o`oNzXm7Y39SPOU$wI>uU<&ee|5K3l$X4X z##rd%)l%0S|L=WM&^(W{n3FN0nf$V8?|e^ZDJ6751MNT@A@nLSbGd|jy$%aL2Ksar zh9>ZV_2JMlQ6p-WJBYx%Zbk5tahNaj zT2nos1dJmF6=OQ$7x9s-nLN+OdcajHUDhUF#_r8Ru*=Iw0PdOrv^@WDLwb74X_9m9 zM*^B-h+xv~eA&%}7OC}>*!Ab4j3z*T{g`m&z3Q5?jg$L>PgR;oX zxhbIV-=}+j@RKxW=b;zWl+54I{(4l}$udL8}d>132az{0M>QMKX&TS-KA+=`eZ&NoJQ&SZpw;Ix**$Eu-hp z-}y?2nW;O0756*;is9;uEMRwxXN#ocPCJfkQEaP(HoFiQD0R}1Un|YML^Z8CV8qA5 zeW2)I%xi|c#BtQ_H!^Zpt*>BKQuSZK$@Kp`aV;s|7r~Bp`^NT>Qz1=#!j@c|UURMr znQBSMW~7>_Nls*-Jr`PGA3S%G$?nt2GU@{;L0NlKhH3V8axMf(3-FhJ!4Gj&3zX0UnQ3@E)Ae_?DY zIZ^SifidbBMgEK|Ngc0_)L*S3qyafg<0Rr5^4t+A7c%H%k0T=O{j4gIqPNa~{?t;F zw*%Dy>93OtCS>DaLo-wdz0u&8YnpUw_k3J@#(}^zI<^@4vrd}c?<*qM4OR#AWtXyP zx4ql=Vz$xDqdaPd^fJt@NTVl80D$wi=#|p3YMJ?7)pXJY9UaW^zb+ zA-CSUTpDrP{H5n&&~B2)ePq`c6H!-RO!WM`bgAc9ljePMa~)x}=`Y<{*41a@5?*B{ zjo#wr+u3;+-y*Bys&>`h{cB8|cOZdny9 z-2qA8gPn&DC917n;VZUvYuKzjzWe)gekCm?{FeZ(H$EM!>w^nnw5FAU*lg-(u-a>e zpJ9YT#(v^(yq74MZIIB-wEi>1qd^)>n&cZ={0+q*1>6SGsV4uPe_sU*47JA${UL_2 z0*Fp}H}Gws1kt+8yM$49`mvSUI~B&fvFCilANS{RmN*<9=4rBBx6Ge!s(Ah~Fiwz3 zVOO-U{n@}We@;>_af*7TRe+)w8!$j6@XP!IR$&q_M=zk;$*mD zq%`PPW}*V9Yhhwhzy$=_wPk+zFS#+#OqK+CflUKidN*OT=7G;Jo{MU z!qN1M?+9r;bIhpyR+^+c&Mn%PK40lP_W{l7{MGHg1tsswC}_xxUoBd#d?p|^Q10T~ z-2wT{v?wQU>#BnlK-mkN`cwZti~t_V@F-CB>bvp&lSnxlkP|-C5|D+g`W6tO>T%dS z(f|Uxr?*`|bDc0a|3;<8c&al$oTXor!BN0IKcHUzlwnQDel*$)F<|c~VxK;EsjaQeVZ@hua|jUc zJTdE;PkR_wU*_RRUcB*ljFRMi?XiPR!DmEp2N#Wt5WJ2o&QMLh2gcE0#|RIjcK=(J zHX~9ec>_G+XE+tltKisxOqwBjU8v$p_x|Kj39IVeoDy}Lp0+8XHY2HPOGr9cZ7MR! z)2uOlzlXmNu(F8-PCYx6b=>L-Ny>jO*FlqlUSU)Rt%NGX9@09$y;%>)!RkW;1odo$ z6Y{_s&VaH|4;^?bnEflAtR6Vs^#Ad;v55B3+fqq?(nq;~SuJ>rQuVcfduDzL9li2( zdW4?st`IpNM=&5a&+tQhr4B|UiY>@GJ)`V$r6-eUe$5TMhz*M^mla8xU_^1iLE$KI5KKx+!V zgeGB-HrYWbd(2@9@YR%voW%3@g~s+Fmzi+I+BYCY zu)1jw5vxZ4R4cqHz5C6<$8@ZOsX!!Z7rj0gH-Usq81ury!di#3Vq}E>{cO1eBrfoz zX3#-}Q~jAw-^}~ZpTFz5QA?-Ei0?e{+AJwxG3QM!a4r7_D+t|@Uiz-q23*q+QFqP3 z{B6MWzaNd{?N0KF_$6N2ugx8M6HIjc(OtOd*g)Yl1icw070lL1 z;+S7Za+ZYV9S3VN8yPym+B$-@)P}@iw+Ui%2|b8gNPCEKJ4CW^of}SVrz#Jq2V_*2 ziX&dSBg`SWY6c+_I)8uhPe&k^2P~LAJRxT`6rN1Au(+9H9fOFJ2+X8_a%ct0j<2qD z(RLc-L@6~u(}+dq97Y=;(D%bNdtP+>{-F$nSRmFv1&IS8o{GiyXNSeDyU!yA;GKlBL3g+ zYb0jDJV(&YSAPXE1{j1_avi=j^FYuCPp?fciTyYa29d7>0YYznZ&#v0+;wcaY3j=$ z67_XJS(C-#tmd1LO~rTiG~#N!?f@}h0(RZWLneW2EI@>`>#+BLql;f8uDv zM|TQcyH>eVAuAdPGVU1yd#GWHzrAL!xB(!x+FxfX1rpVwrF(3g>o4*r+NtRZM=A!g z`LYX(YGG`t%Wp)DFJ$n}@d&2tl1?)0Id~gBBVu#92fU}m+4%$&%iMt%(}E^lV8|cZ zL_Ofu-?VZrUdn?~P|WKDimpxM^j`>|XaNPl6cS@AaxM7~Y2@8aXJa4W9_K#r zLIB!yT|VOFz;Hk&Fa+u10|_IULZf3IST2u%)Zs6ETaHU)_nOOW8qM%p|8yFlutEgRvj&XymqhbE% zg(Ws3u;oz0HXJ+JF&n5d>&`r~vSQFGvZ!UZci;);JaT>cE0qGtE!D41@e0y~bL&MA zKlnU3RCXLyv#qHrhx9E%xVdTN8ChX`Y1tEE7QOMS?klv%Cn%wS&&qvMsxIvD;~0k!UM5WWDRB=u z1Chu^*bNMtPo?~)1;-<%eJZ2`xLD<#RL`6DvrW~{|Wa!VuhMMA8rQ^Ay9W4JSCh+a%?A+tGDvb2l%TB<9%B0bi57tVJ*@{*{ z*2sh??aA~>EeU-e0|LnLy<44qT)OeRDJ&oRV6Y<_DkHy~%)bR!j+k}T8QbN+W-|8V{jor}rP;Yqgvw zwMIiy(x?+awsX z^PIpNJ2Dks4*uT#EYbUI*fB1Eb%OkZapQKRW(LB5?Ha-cF#=AIz{53!92Bbzmgr?f zh66Fphlf=D{D2HDB+}vxr=bf^Tc@f!4>Q|t!A;3?FaH&Xw%4TZ<@Oqb0Ag>^t?%0G z^{*+muZ#k@^uDKb}!WR?EMUDPZZzE(nCBxc6~%4QF8U#sy-< zjD(G3hN9Of;F()MiQS7bF&az?Y$3;c_o)%KlWdt5PTZ@1FTqV1;OXTC`MF1|<5lS& zeS=to2!?dBXSn6Fg}j7$?wB&=rW|h?_&_|0xb|oX=Pm3gdL-Z5YqrjLhUB2R-Agzs z>6o9T=|20`a$w=rQScsWO~I^&T*hI?6R{%@1T>NyPbqQPb?<@FiSh_*6oHZVJxlMl zWF2gQpOScIP2}3SKhpAWwLPgSN^2-X9W8LCCulw?-pBvA+yX+Qk&&f|xnF81QK#{i z)Oc1q?Oz8r1|Kd^AwI*t0%-}ZvqqL7SlAEO#1jbSX$m3-M7&fX?rgFF@5MjvM6a;t zWeJ2kB8G)KGP4t6So8QlCB_aBZZGESi}y>W^|2y_`9igZLM^SXHTaaMJIrHvZu+XI zgYwFX)<@oNLvDCy3dl*{FW3tbyn!Hg&?354KkhTyD$;`}d!%xvg@-9YaewCFHlw^R zaNmt@{5*Lsn6KCIh4E$1Hfmov1rb~c75i~}&`wNrHtja$t>DI+A#K1M(0&jDIT3}n z5-D7rA&Onzt=}Y{&<<0PjRi2(saWAZe^~H8R)rv<&p&I)IbM4;Ab%`)kGtS=%}E$c z+Gqs>oXy6ai9^<{eF`jHjGm!;S>*uEk+BlV${}zl6%<3MBt;_@&oS+;N7Fm;4=mmB zJ}}?&cY8N7mVcyzs7x4}J))|ylWpm^5FF)*#-y6Z%yXiuq+u~VsQ#b#0FW+NEEQ>U z9*Q(Y+=}_BE*XxW)aocHNozi5CBrtAMxg1Ed97NCyJ zbDM}t?t{(H3ktlt!j$DEzXaPTd9e$k*m*;@iQdOt3y@b4?B0|t0S;V{@SY#oUPT4X zo_$*e1A{A;Gk#*f%u_yy#yD@XWyiXTKxTJA>q6jb{Cr|C4DJKeAJ3Ogoj?taP?k z#!3bj9FoY`RYXfjuSwg)Bf4e4n#Y}l-@XB8tFBs7JNb@K*7Pj`t zmi6AziZm!>yA52jQV6zZi4wM*1k&zdxn11>E_JdDzU;@bwOrd{g?e@&Y-9!Q{^npW z@iV8D!V;2Qotby22C>%&nGZo`%3&DwRs_hR38^4Mir=Z;FA1}EhzRps>CfUOyC6N| z;S*Q5^KFQn=rswQI$usUJ2h3*Jef3e$rYM=LP3G_*fE$pzsAf&T^^@oCtCnE`gtMf z2EA&*dadRPwV2Oi4B-t(-jy+*Y^AH;89VlT{_wEvDhT?lskS1y{m-T!3=r%t`=hum zp?H6ChnxseB6G|eP+2Q9(g}zfYT}6&P?BwgaP1Hnfh05x>FnbWH`fyXgW}~9V9y!I zie@;YI>MOp+*H@0HNyGrsZWx>%QM?*hd(?CTW*VCqBHdi!G-Q#gqWtt83w&P@T1>x zIW%0w&EY0_&N;G%{FuiL_s(BZ4n*u3EC8fWcIKGx&MmNqGX8c@R5eom!gfp&O1Y4C#;CA<;wFFplO7)7+4lchZWouLroup&bILe?2#y7(HKs_-M!lAi-`Q zMiL@$UF474hboZ!hD1(`DX<(KJ?55??kz~;B1@BXv7Nq7$80oUy>i7`pDm*()~$iW zq&ZWk%kCu{D+I4v4wA&>Gz&gkj%*>gb4rtBOC?U+ZJ9&_LeKpMLQoxTGccnMt#`hW zuLq^BBPP}R4{t@b>ejx~FJ%ufW+hB|pM|RIn^NOh@WU8U*T~&4z=QAo*!#IsJ~ij| zbiF%NlHy;X{>eS9f!X|h7^_s{_A8PT`+D}H1uv3&gcxSLCLyzy(}ZJZj61K>hK%?X zADr$!t6)uv2)IZ>c1b+n^^;0G>qMMEcF;&T%#{0`*9k;Jfy2GW{#0v71r9i0(O@&# zl4_3WW%PV-W*jlItBdlsiN0vbjj+gig^V2+i=?RHRgl3_n10?#O$IW8t7Fz?6={cU zByjXPq`xo%)ZI~#17NI!BQfTftJoigIx9!Enz3J9fe0s2i_95_Wb*L$D7(u0)>o#o z&60ABY8HfE_An+T~<-0z&veZHrU z$NeYVzvkhQ#5>pZx?Zp6x&V816;Q{iBKIrA7pu`x9}Awe(qlNoow5I3W(VvlT_Tm! z1xyC<%$NKG!7KmFz>BG$shkb*(rM)}!QX5`FIX9HUjdTJlWK;i-|QDzo2~C{ptd-4 z@-OZ^Vh_Nq#<$A41D%ApBR?JQOD@mgbGFz_fRUQ+3|roEagj~rn)*mZK!mYpid3fX zy!4%gQU3&x{-YG!$ED?}bkfzKBP!UV$@$a$($)VxZjUwKa0D*XV)J7&q&jZ^;UyD6 zRPq9?T^;VLUPyZ$hXvQbodeP=p5b{qeJK#GS}W-wKs}lQUvp|pOf`pl3oOdM5_%;$ z)rgOgGgS%e7ZDL-vDLN0rcMYi`Gm0E1UIf#(p9~PlAo%jYoj6}ZBkiJF7r$$PP$^l zVj^zrF%sHzw&^~;cz=UC25{C3`_LTp2mJnTrQ%{Os0!?_=eTVBQq+Ou2tm|8`Z%D5 z39s7v)-kd^h}krbze8h1qXmPqiLjj|0;5%{2uq(3Y6D%d`?(zWwyrHEo#OGPanoHm*-JX117w08F?IhH(uD|W>*%lpv@s^{Iy&^J zG`@~idt9~pEKg}cIPD76vkPG8PXlMz<(1SY<7x1{HMi7+WM|j|rjV{`K)!y)n-#Gk<1c!Dcq2cVD+_LCZb-oSY;2d;hSEG*l@8O{rrZe61qWvD|>xL3;|=U@`8KSEMqDm7b}9yh-O ztYavvb57JvdVo#{ry4Tu+S>Bgct(6Y=D5ds`r=FFnD)SwS!fWjjH4>zxa$R5bpXL@82VH}q4pI4-vOmI9sPCef|jHG;rIw)LIY@$CS(B-0&owsI+67w9KI{G z=+is|{i8Knhyflqjrj;*RFs4nl3I0n^xo^-)?;mNR0LP}#9j{L1yp0w^rsbLYU8zj z3+J~20xE76=vx_EzWGtoPx;wOYK(~>mJcAN0)SFi^Wdv#MLAIZ!88`FMywP;`bP8u zbutOenB|S@Ts?3aEYd^d->vop=uPxx?>QhRLKEut zL0QWSod8Z;Qs8J#xXr(x9qIZMQ6DO64aw&`EIYPIyg)YqjYiQm0MQO_97DcqAg4<#<0=fb>Dt4pslC*ZD&T6_>L~Wqp?~+` z%LG;M{0V?bTc|S4JVp1r)m1JuwypdE0(1L4#{zrh;FnonFNWt)5q4@;4#Vc7L`4)H z*Cl#PZSAL0C8km;IQx|`J}1Bk6Cu#Ay7l@QQ0VwO-9jUR{+mr$SAj$$TRPoI5mhmB zTQe}+^}^pRXZs|?Q=aPiokwtiM}f9OuvKj<83GFsL~^CkNxcYc`0EMdT5m%g4vGrY zn#+k7S7?=gCE2(eDTlVf7|pNfZW&_CsMW6BHS20)-)nxVS=KMjR_8(J=nw~FBclkC}~sPKv*9d^f4 zV(WSVkk5f*)c*-MooO?v`8L|uZrXo$&Y$iKx%|G=2lWlLHg>Y{qj3Td1YDv20vedy z1%ieYfkYrtI0cX{ty2IINyPhvKq?Rv=_*^a9ZS*qzadE554h{YOQf394|L^w%ANM$E`hl$i3gL% z$^g^#3ZE=NCH|gXTGY&hU7*nDO3iuTEjU~H)@ z0=Nu%=?!ae%nx8rK{&AmP+Ou2zhQGh3+MoF zSJ7=wo@3w)rTe~c|1z`fIhVs$sR`t?Tt!54w77N$2`U$~NN zwNJ5*?1u6Gew_fwy+ESlXF6Fi`LqN!Vz#PX9e_zkg;I^uw7?If@PB2FP7sh?D!x)_ z1WsZwHM3#{13=+RqaW=xsiZ=yBiH7Saxq<@#~c^l03}7qZ|Uo&?dg3u}_$|{2U!-3y^etcfn_~+2N^IjYXkC zk5=t#fdCmN!hdarwlr`*5r!aO=vCP*HuIrJ2fJkjMDnv(WbMqSnNz(xyxL-+f!pjQ zr(dS;H7>Ac3et~;8wkwPz}KibQa~}$3(o}@+Bg6SilBlVROz4|BfNt;T2msxAz!G* zrwFS*O6}jef?PONT9zNwo<4j4U_x4{T`$J<qkIa99b7r zH<8oyls;h#fTyT9jtO-DMmIE!|3fKLaX>hw#}K|jMXDMB>#2~!xx)~kuIN9yFuV9i ziNmM@8Q279bUt&A1v@n2|;^A5vv7T(tkWY9pPuYB98soAXffL3WxQNO{^uLmWTLBUy2_T!t z(Y4VHY2xP0Nj5(4wPv8fX7kQE_A?Ti6$WYTT#+)*+_;zeQBk1Z)`)qihqP zCW&0y2mXijRyo#Jr{6pUXfL+%QvMJAihQYHPb9*7Es&y z6qWX6TQ0cV>M_vLI8gPV)PXGArd1*Y$oHwGrsV)yoLb|Wjs0sNcY{~*=SMEkYgsNT{#Ad5`5)I?qtmk?$gArLxr z##qDXS6}=B3-S^4=k=nSfv~|fz!U*!(dz-Nl0Yy(WzD{M639z#sU8SflownKsM-1h zK`06V@|sjdZ88Hl`?Dc!0M%&S2#}J(i?SH^nC`fiJeGk|NH*o^sr#dPjQW!cr(K$Y zb}x8aZ&MS1fC-WR4e$Nn-{s7$;NPUA=hcAY45Dibi?bFcGlG=x&48^3h$mgY^s4fY z&Ep;m)Y7tC^n%a#~vqkBE$h9Zz!I$%Jwpe%ih2&PqJLp}SIqszQaka9}EvtYR zIOtUFe_!2-i@Hi=Yz{>Dnw1c?|Nnvg6Hd-j!la5l4~L_T#@tX~eTnaWIf z^qW7bI&K_r%tYVa$~1Iye&r?f=`^Z7{PFeCCV+Tc2htWy!vg~cf~Op*Zty=p1$&#LS(@(q*_(M>RYqcf)IIHt3 z_&=Fm|L$eo9N-E6cP7yZ_Rs)%X@9(6AqM=2f4mTV?SD~f|F>+?>Hl|$$-gfY-T41} zR??VWeFv*33782Q_yJ5$d6I?8F z`xb+cF)SXGW9^6uIr`h2>kJ|vuPG$Bmf!gTGu2QIYfb0!b}Y}1j@KB+emwVJ99CRr z36%%GR6o?WUol@WeqOd6>80WA4gN*JMiKo{zjm>-N~1wzCk%o;+<*MmO9}$F6!v=0 z3=kE$^zQo+ShcE-MNyoAryDE$8{1LBc%W;xEB{47+MzbxFty z&wEGCwWO2NNTWK_1mv}eR8zijtbA{5TbXOkJQ7hSvJ_M=w94>cK)x#V6lkvUQ%8OV zs?sOJ_50MlIphc8kC2-MS;EMsQexO-b7AeT?QgfSpc7;oCswS&a#XuY4#hjh(&j@b`c7FvJ(h5t*P<@EOnlU8)Cg;T=3QHW`b>blYX zPD$$C{l_L`WGu-8w#q=tP+Ba?Paj5W#xz1SW&+$Mx@A+i>~fgp9Ij9l^fJwT-13cKSbg*N`73e5C*S(M;etQk=3&F(PtzDX=a(?Xr=fn=}HBew_iOX`mYJuydVntxda5Z_U~4I9Tut;SFB?zdYo1Z zIfuM;3`b|V>3HY`>Sde4#b3cc{R-xsXtB)lln$6+MM%ZXu#YOedh(W-Ft2g`&}EZ> zEp^>tjsW2H)R1B>yU^8f5$z?L=T%J` z8D*%gMB90KgksD`n>N8$LKj>X6xf8WzLMd?(3Rm5nar(fzl3qluxf#I^=lJIs8fnU z^bPa)h*LbR=p<3}8HgA0uwko)>7&i&FX@gtBRtzHu}hndpo_xDg8UgsII9A1F#El~LL(qD)sv%ZG1pao&U zKVGaya#f75g^bAp*GYSvh1B(vpG^(sX?PPSA+)|7&(hTP*GacjQMcXR<;NE+QL>yC zEyc(gsRzT{9i5n-p@#5c*{t6YzilgK2)z3>-*?+$Jzh{?Qk5?+#S?>Ovr};Z)$sog zZt$j-1llX7XD?8*JBCa>R}4h13uxcgZkg%0_T!VtU|4V;>nUu3&uZSch4ChQg2eph zvs9H9o$xJVo#YqQd1pNzlYZIDk+zkROg-CZKDdk;Q$1upq(8Y+BXv?%BN!Xsf;xC3vXzQW+>6bUDYS)I zB{c8hd)Oxupre^tIdKCw$91@W<;OerBWV|}uQ@+sXYp)P;}%5O{tQg-=RM1_=xnns zVKxg>;zk@FJ%4A#6%(6Ah_~W#C;Q~4v*aAy+UG{gC$G}Vb)|vq%?J@Ah zDFf_BA=qhu@W`Q_9@;wGlExD2h6E!#i+}N6_9SV%NfrJmu%+S9Sp2Jgz*KX@Q|S)t zrnUELUMtHWa3w#k*A(uH)okjo(GhvK5#tHrr-wiLDCZp=f+`K_mUTC0!ajFon#!DV z$0X#NDx7hSCwnHZvF{XXQS6cDBilNIcDf+haZ8tvRo{oYO;H2>F2TFo$VDF+$_8YyQRg}+gck)EH-=kQI7;uGxu`7+!pJQ;Tn zlSX`epz7a{lGMoN?Z|hKqvo~oTl9ytBfHCSD%NM%mhmXYPrkrw52LlGU1#jBD_3Nu zHsRXn_S}$BkLFZI7VZ@q{KHQ>^OARUljaBI59&YiZzbyfSbtQCzn3dK_3r5`lR=`g z_4Y%CO}o^QLu5fnC0v1pS~kBRh?MLOdu?e7;#-dV0>qsA(!@}3^rs5*`4CRr;aAH*i6G7AH%Rb! z@`>P*m>_gfct02Zz>fJr*V?{^vFF%OTp=xEOXU3dl(a{(rm0~yOVTbedv{+br$;&k zRA+3}Sp5xtvG}{j#7PNqkK4K12$eRN|0#nr1(dZIPi{e6Rmz~Kd0d+?ye;2o1#-S3 zuhtJOR9j}TY^n2;`PtM%WPTp5-SzgzNhifHJq|oYq=eL9YO=F@2z@pfC2{(#QJ-6F z9rlK9)6kI9>+@rQJvm0p+@-2V5ak7Qe~3bgoH;oyf@uNW3i(OAK6+sCOkFe&&Kc^~ zwiEFoYpyO3y6)|!4y@gRXNgRjAY-SRV@-Cjo7usvYf0Ad;VVf;d&6UGX15!;QU?+$ z)fQ1*6}!@@;Hz+_V7|Fgvq2F8h?v6ck?-e)Ot!<-Q^1A47qCx*1l@X^Gzpp=kIsbm-Mda0u3w~Zg1i+t(t zVps;o`GjsL9_ch&rc6Xy29K~PyNDhKBs3JIaKLH%fK!zldma> z5ZYWu^?B5;{`5a7j1?^csqyFcxB1LZU~L-gU`fCD{Ovsm)jZXr+-=Q^6WPk;FVTDx z+tQySZ_DypdfeYFt&y8)?_F-_uGPDI|NAhHg==!#odh zOG$8-;UIg-3eC#sJx18ClC|PTagw+In0UKNYAs^DUD+D; zkqo5^{StPN>RNHa(&ZRx_t5Uv@m|JS1ql|KC^DGs9{76Ta|}4Uun_0t(zp=)f9qSQ zu1skD%W8rPhq~$Rd9RE0kktUEdU^kl)?J-Qefw z-WX7G_G>HIA51BSMRR3)(o?Hbw$+jWmqz9z6vQYg$Pgcbv3haEE)71#yZ2XnU&(-h z`j3kSFaz(`H>@I~&*prZv&NZv(bamfDxvC5cQnR;zGOD?V7%e=5cA-Y7rRqq z4IG;m+8yh8W{?wXSq{}TT*;T}XIcNPg94zs4BtzT2=SJo%?yEEvv=uqOSKstX;Co^{!3v z(-lOQ^Y9xAURRODhz%gYK%Y<{R-Tj{6##~F{5aM&1I?`-ag!^qP08a^67T(n2=)#m z93Rdfr!K~xA6HNMRaKfjl4lJt?Jkm`8eb!S@e?lv6WC)Kh*P(1YD+y1vI}qDkK=If z8`BFWWYV#9PQVjwUUe;#6H52p;wUs3lOY#%u-j+cOU#(7Et32l(#9pw@g9zt%WFl~ z(Q9g5k+M>Od?WNweQUc)@;QsdW`&rvLU3WWcsT>uF+F_Z zw(B}NZ4S@V>lqg*=XY&liF~b3GUCaar;YcF(P~Vgz5la5Qm5Io<96jo*tL_azUkPd zw`qZIJ{sO7DzjXa$QKfA{Nnv?-N&k zKeWm&I-tB($}C$IUBJht)7J$8n{v*s;O}rS<%H@?CSPDIsgE3%X%rkk5j< z54%AOYVHCv_FLMa9X`K6*s$2R$0xaXOUJBsGwWh77F&gZRH_CVFRKX2l>1Yr# zM2}%e*8nZX8wFRl<^?XZh+G)S8XwBHG3n-zp-l8bzjxYQjkTw*kX^{`@wO5x{3RZ6C()?J zl)aEwYo+%u%%*j}#vrln%=YaL35|P@02SAGBfGkgJOh6BOO!}AwC{W)|LK*> z+0KZKN*?YcTh+VsYiDsp9d535$LJBao2_6iuhkO|Ks;=T{uVp1!qa-$c5x*$e zX9VI{>^K$5I5Qd{gYO>kcR;$#rwAL1_7?*qpk_h&1`y zi`5L(X|Lr4w-+G6HRh*bFHuppm;Z%pqZ3X&TNcN)N+q~>2j|15#mOvFc;K2RiVwQCm(kR*NP7`Enauh3W`9*P9=7(j&$7Y2sE`H&zFqNl1L|VY zKVIc9nC&q-t-@)?lJaqsw?kTa{7AIV6f|obEoNs>SCsGdSa|B;U80y`=!fc^i^!Vg zUBCG5Td%60?}yHa^7iWTunag(cU94MZEJH81>4O^;=2GeJK2UJX_ZSoBPO!{PYOWqgUX=PEC}p7N9_MHw&1s~RW4q&8 zQykjs@nTo-1`a9Wy!x&HR`7se5XgFL_$6q}%w}R9rL9YHVax#`vdR65I0{npVP_2n zK!hF{h?qH8%&MR0=W7JyV>H>Th|7-z?cPby{{4_ik+AC~{5@M$eeOTT04Y zAWKwzKtslVM;yJDIWb^2gdXyCCamwD8OsX%{M9^xVOFWeqga)g zM=W`0I~F_y`tIa5X3NleVnPRoRW3O6GAy7qeUvg&7Qq3WaZc5xbDVu;Nj3R0Pi!)) zO2O_X?|wO?S8?UmmG7bTJxqjxR4F!6B-#r=NAc~)dTL$%V&ZE2q`iv%+7(ILxP)g# ztWV#{teQ|f;$a;@(7eh=$+i<1UjB57WJ(Rcsa;}z7Qn-pq1FV)hB%!IHODg7Dq*${ zEcyq&^gHeDJd1s1&J%@pALCX^-YxF;!w(_i9Iv-VQYx;pce1E$mg0Gq>lWHgJ8&v1 zy_Ettu<{=y38|eE(6yWQOG{Pm#Y?%Q6!qE*4O|%-pF1F3EL2C;Mc(3jexv7LE*IZZ z?J%&*t+_dwnXl>OvtB&#dGuaFs*fM3h^Mx=fTCCaY%^4f^{ehH(jKuB|73kq}1dF-KoIERXlv z4A-3u7*UDINU~wl_PfQHkM+Q zrra_7yXi`2`-G(Y`N1r5CN@{+h43#Nb_a6V{=}t`F$rTQQ80oR+w!@3#@1-fWZiAT zjhCd+rTTWvUL_GT5Wjm(k}|^X@RmRJ8kDc@4$a9oIJc;w1M|ggX zc$rntEXX^IzCWqaJu#dAHCqcB+U#qppUqu6H*vOFUNhO%@?!0>r2i0~Gk>pQ2R}0~ z_F6e!KkICMaTqG;?|PW5n6<4t{%iCjTHc%EF#EOe-=*vGxtX=aJZhFAc(UV|SL-U` zhl}$f{UOlAjru)H^|W~^qWN{1JEDMyK)){~0fK%6Q;A|pVm`0)U+=0vYu#lYUV4}O z-8Y@UnUQLZ`MIlNXJ@wVAw1RAT(@JlI4-$>steew&nTDasAR$Gfx1t)o}UjAZ5cVoxa|i^rlk@zz{>N{3PyV| zhlU>=O7@{+}7g!~Oq zcV;6C^Pd3>Q+=0VjDoD!jV56)UB|Oy+_C9R2`&eYW&>~Y5K~$?dEd6Q-!XA`U`P~& zOjshl^SC+-+f@)(jh)$)>9W3x*KE^=9#FRMIOa|M*i2vC2)loY5T@YwK8phZ@RRVk z50C^B$Xbo1D&kWe4cc4ed~(&KV)Cb|O>}~WH}hyI-1YWbd@eGEWL72x%EG@bP?~-t zW`BK|=V9`~@?KhzA&8?Y1uvT*Wo9K3L+2K#DvL0y!eCH%frheDXeH0#s0+bBeplfs zew7??vrQwIZ!-<88LsagosZb5x5b`d@h13%Bfp_Sg7IY)a|MU2DF)IdqK7n5cB&TD z32BoBwb^_VE-h3tXI;1EPZ-<)yG`GMQbbq9OJ%lv*q_Fp#pZtu&RN&;J2VMd4CFgp z?G&xah|kZSCa0eQ^(^Ny`g$9V(7)RqL=n2UdwSUt+J$a1RehN`y*wMe-o?AJ?Fb||3EQyTXoWwiky zw%)jC7H4(AZ37O8R&>fxDM|Kt@4BFnS;MW}uYYamtAPC*{ENwajFo&bencV=%}UEA62(wj`As;?98 ztNKUvz)`j3;^mfbVn?k3HZGa@Ta4D{rjr|EL*ioT7Oqr|{h#B&miyV*^ACd_snZ{@ zlQ(zzMR(4?Wm#Al-bBqS%OJv*l@$;tvtXm^7uW{!Qfoz(HLBYaWah9NZL!Kg4kq$A zvNtZJf*vwJu9E~B9ghKdFF*xcFymIEEFjX+$9eQjxkH8UA{3p6q4y@A6e|{k*0QI2 z1z#akju*~f>*qKG)m(pmg+Gncb4WwHj^6By<+#QnQ?Y5F`bIrF$Bicyw>E+F{Tz*Q`x2H8vlju%v$3U)bJBE@@tE+{ZdbY|=J z%Pv6j1K1~woEPDFZZ}>*+^`%JH+9tZqNv)qqYeaSYG1vpeJ!klyzb+{&F{Vii#f5$ zgY--GZ9+RQ4}Pf{I=^J_BI#EqvG^C`S9^SH!dN!zJ1l-5-mC(yu4fV>ol@O=%b3zB z(vHE1vCqLEEJ_I3?683GM}F`}cO!RD5BZdOk9|DK z`^4<`=^t1RW<_0fGsow6z$10AVlnVd7a51#wYP(59GfR-_0UD#==0OhHQZBWE15oM_(S@IM&{^7qib;go#P;pSNyd;; zE8}DK!Z&ti&uwO!x}SBDwiOp?anFJw4}4P41<1vt$7uF9$RxnL11F7?8MT- zdED@Vt3c5cdvBhfZiiQ@WR`s=`u`6jYLH6<^`U-+C#$tTCl^jRDGhVH^6E|_c;Bs) z+By-GASw3MAxnNt)Md?-MCBC`lq=}s5pyd~ggao>rHA}pxyC{jM1)Q>6FE@Wez=%k zFe>jJ%xAiPt&G?{!OEdt%A*`TMk(rBMGT{M+p!w-{)DbvIVK5_L-hT24cE|lH#>Gm z9oSal5*g_@fg0{aeBn?6{t%Kw#LqkogZRGNi}e#FG5RjXJI*_M-CX{gg51BaHdPwv zeT{`Ob&=x4`;Y_x1?}aq-ZG=U+B?g z^^`RO&fks~k?4z&arQCCXj&`UrSf*$7v+v+c)Z>XaY9wq$dUY?Jku6<(*xPXie&4$ zlj;nhdE(`InqVHwm3-O*xS9B0IWkDJ=IRae7UE>dud}P&aqAAbV`qtx_1r7gekrs$ zyuKERb-|l2? z*`0aqJ6`tn$Lx0In`XWaTtcD+qewN|HG?vBcN5AB+mH=p|I9+rLXsPzuLOb`I&42N z2=-7GE@>5eY*uzty8d)Ca@gBF$%H`qjw2e(@9TLR^xOzMxuy_^#e08 zl3Gmy=5ul1-sd57*wDy}y%x^LqH> zhZ-7O`$qye8}qQH8xNE>S2sb+%apgU=^k1ZQa)6b<6n`|QW1U^luydJw*h))32c+z zUIr`}Ww`15Q!ENp?DsaZrH#oF2vc{F_Ub9PU23f9RyKV)}v1g`=0am*JSv=A3?I;KOSZaNqQ?yF9fXQ%mLn@#Jfl4;N16 z#5Bj%1sn8(YfKZh*c%`*oV0^>3F$uzQKkK|s1x`$cC5iy?Tf+Ei3WDBBd zw5KYbjVLT-U{(;YGB&zEQI{HS$1reshgtbv<*J&!lHXP7vnCF$8Ov6=OYa@$R$0IO z5LNEq@vgqe#zXc(D&EN8{@c&*K6N%*^q>FA@BXw%JulAp${Bs`uh#hPin!GlUkb+0 ztl}41#f_Ao;Q>qXHPWnM_U*K}Gi4yY>rp6YRHov_7CW{zd;CsOUk4KR>H6beK{n!c zr5~L(=VOcgQ#*H!feEoB#{plE@lvQX2|6~CU8tHcD%)#3AdmRF>3(%A9UYW#X8 z``Go$9kMKMl8RXMg5mn|UUAvnsPmkl=POuGnc&&sy-4PBn{i%?Thd3(DLuF+8yjV{ z%FH_h?W(mVMY0p^O3!|EtO76Wbn2fms@81SFu;b z@ai?B48yI=17U&S4 zb7VH>MsQ^5n!L_|&Ptu2==LkV9&+yKx@oY#10DWmlF}Pz|2B8NkHJH#Cht?!BRo%a zusZe*@8Vlcwg~}eiUKa7j)-V8w^R~H=wmqJP`EqDeFnuPxK>#sk~?S+T(;qSkQ0_p z$QN_a96jx!^SY=o5zT+d`bFKq#*`>0YWOt7X<1B_U?r0(&tI}l-7*#8CA|9Myyl^+8<+*`%E(V3#V=3yPqx^c3#e`B5nJ)_qRk+ z4DGy+kZA<$qz(7ts#&F!KSaq@C#AU}E)%`Rr86EtYA4kMvZP#_o4hRwHys<5lQG4j zKkTLMBH<5O#%C-0R@@j}2F*Sz<1~Ru~CQ-UH44~tx5-Q9+f&D2dX6y@z zJbtfhc|#kL`WeTs-ju*&QQOgb^gAoT!A|VAc7qt})BQa%TB1l^_V2lwUZR2d^z&y1 zGjAS+JHPJddE3;SHZV4^I_mxCUqRep`_Ja2ujfdt3g+GlxlMEXJSTmHwDB^#&GQQ} zGBLFFg8h+?mO>}F1$)8^Ksct-k@_(Qo|?(%Yf3*V+L+i;kjzxc!^tP`eu_YiwAR&Q%`e)=oo)OJ5M!=;4nOE!yy>hl}zUp@x~SgH{~Ii z$E)M??Zb>|+8%2Jv=yheR2t7V5q-_mx^UC18WBGiIp#|#aLnss2pzo!HZ}U0sOYN3 zs$|_HBJwVPksHL+9>A`Px>I37zP=ooY*3oDJTM*`0f(-XF@dI&oD6)IL!5V)MCM?_ zKVw3ZeAh#lLy{dqO6_oj?7-WYEVL#8<#P~gTWst$k*?kzP?WsukTr%o4iX%Dw;xx4 zx@LUmd5o9$!%znkUj@zylaY@)YVI=Y;tAI3DK!P;$@;9ibKxfvcOT|W zcm5W;SBqR5uDSnF@iUD_D>LYp*JroIpad^(i7}|fq78Ieoz)XH>kF>x!^bIkC5?D> zhpDf|?>bK~RW|QI_3}zp_%CB*28M&W=9;*hpi57O#)0n6*|xaZ>Z}rg*t@kZwTelV zLRhVp#8TF*IWoTSdZr(VE^ggEz_zr!$-VV6VyMn3?K`P%ft=}Rd|9ieww7g!-|(m@ z;p+wN?cj5Kb@Sm5e{T7z?Efgqgu-?mm_H6D(%sou(nm*+BwANR=ML>mTf9t@s zCHjY}d!mZ+MHA(jjNX~Kn;k)(>R;g^BL(Gc30jzMRvwASBQYpV5!$mJgaBLi@dpdI zmJc;lUJQKcldnn8+731EgxGSh>Wwcyfj6wF6hlTUKBxrLW8A_Riw*gRU6wXk7m<=m zmwKn{RL_rIs$ws$-WBy`QU@;ro4oV0b?f zeL8O_7t5pL(?K#&7B5F`MYLl_8+aGcSJDZqxC6=g@yrJgYYG(j(+NZ8hbG-_tRDDG z_-wl~+^zhOAtTrkOl&-;qUgG*f2gJHPCT2Nf!thJ#jseXXr~V=Esmh`E~~p`WMhL-ptM?tPe~ze~O4inzDp^M*`g-%l&%AL$>kUQ<`UWWfyZzEbv*8M*p z8ouFV^@}Np>*@{r8hyv4xr@BUCw7bdri3^q0aR9p@xS%x9L*2Ev?$NXYGiP<`4n@t z_^q7sI`R`WFO>EZazE?P5?NQBZIz_23-XeF3sx3eYpcv2MtKDdC)iiZi%F4F3058w zE@hHFYh$ig-(g?sD1JzT#ZC zM9W;wRaw#K%Fnu=Kg-!i=TuvWMHHu9aIld+^Zil^rC#AP5s?_%*UNOnJ)$n8f?QM0 z+@Y5Pt#m9HPg7T0=@Z>{ZXmC|0keBr^WH+)n~z?KgD8F8XqhlxoVs^ayb|JOe_!Xp zL7qT;QPa>NX7z5)I**Ds7M-MgD&h3HancAI4vAXTmoPPf9FCvp( zXQlM(d`iS_Cx5s^u<=AsgUP17VQCy>9+-UH7;)Hla`>JPT}e#0&O)s-4bnb`^LoDX zU|X*1yl+^xhD49`{w77jK1hZJ;0|8~scN7qW_aK%Zl23c9FA2!$&1#PyxL%pQerpE z^z`4kLf*AX={18vZTpJO?lN~XofV3AX|4IJ38?AM+$-SX?F)wMkj@KTNhV4uhYZMO z8TJXXwkp5HuYBZ?4H`0)gu2D=q!YXQjV?!qi^I1w_`7fU*&3aD*g*9Y=oMdGVkOiu zr21mar_|usIn>o03!Z`0m#(8}fDT|=wam#N<=FZAtm^Wwi-<9Ga46yHBD7WZ4aW+s zvzOC*!VVQ!C&gDkI$N-6P1k@u3VgoMCi_sw@H{NEmXxT2O&NH@1lU#o=QL?x^**%i zlCoa2!TL;-4sM(zJg*@R!%Rtym%OZum5r?H{i-sA|9VD#wP&Ku72UDc5d}eTWcKMe z;`N~JCbsjvqR$0gkNv{V&oApUo?Tf!pDA{5=AeQsq-=j3+CU~-bgdMBDmD|l;c12z zzLQ^VzaM(lKNuP+3d06h9??~5toWUtgQGu(zfLvPJ!!02l|;_8k06?EC<47tP`0=` z?YPN;^Z>{3p$QOjku^+l>yIslP2Uw#7W41Ow=?t2YLErv{bo8T7@fiAS+IZQHy1LavBs(=8SQdTqL@hnI^r7=p&97q*Ypq;xrquf7kRi`^bwsmSC6aKYa;4}vs11WVSSQSq?Q^QUGFcSy6&;py2ztLCBc z4lsHUT$<~5+qo~FzHNX*en4k!uXRiesVvU1+)fMC3X#QZ9)G5bwAR0HDD7&teLg@$ zI246*1p#w_^w&a~1;gW3N|B~rY;`%UbPtDhnUvH!CAr;<{#sV^h-KEB~r^>(A-M&#$QRFspj>Cy# zkr?qQr%^#k>Yd|g5XfD}Yq?iTZ6vtC>m|(I#U_6M&-}=QC}caFTwbQToV%rauYvic zPj;}nytP-zsPnFeVG25xpMSn%drF2gcI08Dsc%VPOtolbxlr#NZ1#6DB^f^pSOxre z#`qBaq^|b4%b zC2a_HL0O*zq;7!UJzxY6Y&B>7W_HdU;R;eyJ~bJI>r0%@-#c+uwlS+l&WgFe88I>n zq}1vv#fS?tec5=B)-rQad{V=>cw5( zZMtr4dA)yBgic@0KmJ-3B6>Bv17FpW9cIHCU~G zU_R7?TJh1rrdCHi8tA}LV2IzTU)ck5paL-!qq;e|Y7~@Z(g4TDId#w(sN88KJ6E1i zKf%9}Sq)e%_EZ&iza@FjTLUM_(rkKo^2`Ie@T8f_tF}6*(p}Q!ltq(5+w1&%e+%*< zi!?vU*HkZ}6YBpTuHGstu4vf;#R={KfLPUAE#!5fDFjR*G-BxrDL zEWuqGx5oA5j`z+T_q_SJzxGG1T2*t+Sw#@7d;+wNNN7o4tD7sH*3pN`=(yZ9dWrCi zn-_gpHancmmJ>4FrZl(|M0+2+2_pA8J710exo_nH)rkkjFHo~m(KJ4p7+bPcJ}K@QDRa>W%oUGNu>@3Qx8 zL<{HIPr5_@Y$z@EKL_o);ua`*?UV0;wuSTRN|1_#lEPe8!mhQm;XXtwvj zR3l5YH=!4}pEB%gO7ljCRf{BpE6YGVZ#}E!cdmf=KsV_xDBM>#;B-YL-ce9*X|^ z<;1vGt}Rett=eUpc;*%!mbik+5#;=bRjsIfB2ZQOtGa+u+Z-&W>mzLnPxqm=)MZI;ICh|dmaJ_>`7aH`sQcc#E3%~N{Lj3NLVe-QU|-v zw^&EXzaancOaKUgf2P*Pr7_PKu0pGW$_+hwJXeUj)?;>t=y z)>aI!&xaM-@$-iM@#|N{nFIpwit$z17x@HB{SRx^ex<b8z9!TcPzxi;rE8X%+o$!In{<@+Y<|FBEJ0AFZ&szsXG6D!7Pa5QI-dk zDEX!dqVP*23X!pWDI{)hdp)~@@_BwpSXpz=_U(Cw5A6KQwP<4eDi%tLNa@Nl2}XL^ zMnY@%xwEh9!2?S^>#3ib8kI{c$LU|P8yGAHVoBI7ht?izo45M~ybRv*98VsBw^7JM zPL-lRim&(>Rs>X!Zjd57jr|sqG&c)_W6Lp{v;SKv-{&`>&05zFf8;0<`k!Gp{~sX8 z8&-CLA}^|Mh1r3NT(_XcN%5j5^3r+h`11?em%E|fuxU$V1pry3K$@k23f95took<{zx=geN;71(CWtvd! zF73S?Ix-K=^pAe04mNdh!a0rJz3^IpSz0Qne8LH(7S%in**c|b>eqCr!zBA?1D(uL zM{*}h9_Ql*uQkKtQgbuj4bf_|!8ZHPWLU*K zWR_b;<04lKBkhfmLc>rIW+^WGdyWdeSNVXEvqrX5=**l?NX9jAxXnq}UCp`;zF#-| zsH<;t#iRrZwo?Sr%G;V()%R*jiSO=0^9+ce3h8&@YvCr=ZW@;6=UB?H=FD??p$lm^ zNYZ{CeOQO-8+?j2nkuN2lCi=Ud?GnrE-p4AKWi?^t4El z%3Z*}$;^4MWyD6jErQjKsm)MT6R1*|Pn}xI)a6>FOrRS1o)GUxvBI$}TBZmR!N_Kbl-b~Z!l+1y~$&cK8V=WW})X5?$Zs0hlXY$9Uto*3#7}tlUAsoe%cSAJVY%0koho2 zG=dxRj(G|>Ig@1`dJ7gd#}%UPLGwfMuUi$n9~=Hi8P^}@ei@9i8H6+OmF7}OG;8(bo6^~(GO%~MR$JJdaWiRY5ir~^B)S8 zd(KJQESvf(#Uq-;7N~dv(c2hEugk_fGTGe$g$5qVuF)8zQg{5@)SLd^Sh{uaIn`;P zeEv+rA@x>JN2ymB%a0~(F8~#YYF_r9o#wn5QDS%N`W|_XbUZG%(s(phb@=R%6)d3f zQ?A@f^Ceedahjq z#jufTBk(A`oZheLv_(nKgf6Lp;t7cQxvN0YebDGI)OGmA@lfq8W30?Y#b%?d1Vv zjAU>_-YQH50Jz?jGSM{tof9E;mPE?+b@`#ySMrbg$vB^$TM#2Q0myMknq$M?zsTp< zM=V}os38J9h`C$2ySRCcj(@LpnVFV=tD<@8Tc*s>NP!Vn7SzPgt#)RAm_5R5W_+7! zmA$K?V;*=!*;K3u^AHlllw--nXGTl3(8UJmtrV=HL%$`a0GHZLFlV9+y{SCU|8!Z% z&d4RDW>rTYYUaPtOWbo9Tf<1es3LeV0XgUcCh^`Ly*hw9v+@wtx_^WP_0rXfWY(pN2ENeFe1`!V z8;%$vs~6gjUAXSif}i|nMDf@+ejsFeLv0$$pMIQRIkD4algHXwJ(eJ;AxK|Hfa;oz zg_c(CC)A_Tz%ug>$fp5n6d=g3_x^$dQl8L!*AP?jOg!Clfmk%{P+PId^H^Kv&>5k&?Zc9G-EPT zMRV@GFsvkJj~!KhgR1S#G{#F2jm zNro4MnA9?uyT;mw^VYJPH8zfBIiU26KFq!w_ZsLx0aV|YZ=yYGfAbt#88`0*1}n^o zLZuF;G<4)BCn2f~D`|M^F7jG?t<7|Fh}do4GItBRcX8v71SVNxwBF!b zbTSkge6Gh+OWg@1W3*yU9K~W=IUs-Uq}&^}A+p~Hzq8s2ErvESLAtn#pRnZ)El?V@ zN1fwbVBi_D&w{~;iiJ6{64fD6N&x~>B-7$NUOF_R^+CehdIa1W&ghoHB2MRe-#_oX z@FZSUh3_mSGZ>;Hic^%wei~4vMkM<-JV1`jh0BIL%`cqr?K`CvA$t6EaF+Gi#V-5PFlTf=wgUoOvh;06+qRxfPR%6(K^y?E)7%S6}Il3@aK34%-84c1lunPhXehcB^cP!Bf?EUU?A*4fkc-f7&2d=>Y^ zqg7YXo1`K!`eO>(v$s_l>3r;{m7^TD=*}Uvu6(Nj9kXw-Z zWhoIs(BMd-_s8Kji(`)OGeo&E#eYllR~|iryfIVtO(#iCN<4XBliUz$yEFLVBFNE+Ea*EXu)33Ue2W@XF$8Dl~K0 zL`8I2NTS+TtQc|c;csxuL>Au*e;;46V_48bAnV}Bq|mm}!Q>ApDq zckRy5F)8ZUWP;;myHpe4=rEUBU6q1V zIHrIN`$W6+(S;4+yWJnD_s2SyWkl%3lasi-&G8Ng1xo1HXr)wdQ7){iw>Fv!m4v*A zxrIL%hXyhmcyU|IN)Gb4DkRTjREg4tC2Ebcu>d8-y{^`W$>toW9sn^r?(4Sf2-9K^ zgWtP{r^rhq@C+W`-vTy>!8Oa7Uxf6$V}T90rZi2}23&ySxUsZb`$d;|yGSLYpLi@D zkIB~`7Y?$^BU!7==k!$R8|=m@M3mWBsU*GM{qdOTFr0t_K-w=Se0A`P0E z+K?&BT{kmj+4(3fbjv*27UlX^?wbB$$U>6piG6#D$14{Jsky1<7Qo$ z)h*$>_=>?k1*oSY0-iytxZ-KpHpYeAp46m;TQ>?yC@z>1+Cps*B-?8C1bYxn^FWWB zRub~0gDFG(BAmU_UR>CqVqyl&zcoatU3cxH9U+-!E5BM~e-(({YMk<=5tR{T4d0UP z;HUj`i494q7_ANJajls9tSR|Xa zwF)H+gf_~XQnfn{O015{zcuPG@3h6oOSV-4Pu}M}etg8_TN7L-ZxXvzCrodVmpY<@ z<`-Tu?tX;Oq03sIHb~FmnkH*23`VuZA!iC?&3l`$-+Zh>sLNNv?3u58uoz;O%&;S8 zUYyjjoNnz34AL8p3j;2l9$?wa3Eh@MgBG!Ug)PO*NsL{Ww5i{|Vk(4^bU0Q0{y5^f z#$HqvSo;_lqe5YVE(&LnN4tchvO41{@`>-;QL*UM2W?Hj&&0KAH_RJYiid+W0^1{k ze-eLAl>~0NGIfa{NK^%{zV$0Tm?hn}eoF1T(0*E!_1qWW{|`jbLwYY18iQV*{aIj?Gn9>dc|a#QXr3V}Y$8e%Bma2$Ux)>5`ok7UYM#KW3L=MuUvrhuX z>c`Aou`cVQ%87IE)zj&2cD^?*t3U#8>4~K7(k%i3xb!vjTQnZMCsiAHS>TLd;iZ3{ zy{9@n{l@KXv){jv^Avh1r#%W{dzAPX1C31*%Bwn?!AMOknoDTd0N~xCp+#k8d_>4J!9iO1-)xVphYT46TL?7CM@;R0V$Y!{F#nTFUUMw!d1aJLRx| z&GU84S>XC}#tw@Do_q%{QV{*T1=#b|ZQ1zr7ZaDq<98Mtszf_Ze;u~xN}BSqsfZ24 zccvsGvTD!`rCXRWP9X~mgQGJ&u=I^9a#AiRb;IsAGTAUiAMq;VUwC0zzxI1X3)CS* zJ6lhsG@^XjDuT~SM3?Qu5By2k&v>g2Vmmz0t9AeC$}QN@R(swky?E{D%Ux09@aBt* z=|j}Z3VN63)9cZupaGQWn@mgLf3PVOq5$Z8I`n7lW{ivO1oB+X0|GY$d&!ixF^ZXy ztG3mvup!U!NDa~3vOI%Ceq@gw-!bgnglfQ5Ku+{Sx_Pt|OKi^E95S^>X#iQm`7CMB zw^4%%qrx~Xx#j(k4gRfRLW((qhOwQ$wBhIR$A!fyJ?P3k#qin_{R%$sUAwm zjNC}6xJmbEQn#j&vf68n0sMpU4Yc*KZ=MZ5q)m#{5mpAym43)2U{1FPz`1$f-}Ak* zYc2bDiv5W8+Yrp7U@~ZTiqqZ#t?9({dyTrP8qn&8`LBEwVfXh_j2`N`+Ec%fN{@v0 z2lW)YOc9eKnXgY{ZSDw}WS|}cO;)q6MAm+P8KTOn4DQ8lQHD!msM6fcJR<|mMd#aL zm7{^6H^Y;7xhG%Vvc-+~<-3&!_P;;T)E#z~YMnI94p8)Pw|+)ty*g+o&n1MrI`s!_ zR8KY&DIlU_g&o(+1(%*&X^#u=1{sz9$g@zMl|VWv$jnp3CuXPEO~?C|2k{c!m$0%| zD6zcEb4uT)9sHssDSnF?rCW zFdAc4jw&!oyWc8V?4u{!nJofus3?f}%Qsxex-#;RFuo^^e9STW!7&%&bGv{;o*)W% ztktOkPQ?{?&ho4p>NgmN197~U4(oY3efW#)Ic9~zqF^g`75btRwJp$MJbV$+(&%$g zk|T$nadlFT^tuxyn3>$r6HGH@>d0TiEOh zOOxU0A6z;TPfG9_fyR{0c+>j61*4w_0yPJr3ZZJ~_M8vCV5d%|b=IVi=)b!IU}!@F9_ z{;hk*F(@M6--$1IbsY5*1>|!v>8A;*32gR4%vOLdn1GKL?-_J0bd;CazUkDu{ zD9!Vgi8lIp+N!g}*o~-e8ROhnJ7q}EMZ9DL%YdimG01PwvF0&uc`4fivl7xfSFl?3 z+gwiY36GshzVyzsYC`_Bn?$b=wf$|&-|>rMrBoDIaVm%4lWawdiT6fQ}yY9!B2mKPrSR7;_1=L(_)OW zZc?wU$W5Hb#aec30j6PpdL-VBDb96{9!K>AVkA=#8Dyhr0Hg{GnOW;iB1=@2eaM<% z|29^L(X~d{9N&P*x;`I*`8B)FPhIM!N~h#fE0Y)aQH|g#K3QQ9q?O`1`TVC5!pM#1 z+qNkr&E0%>C`%=9fH4AB@`s6*#=q~i|2LtEVAfS~rw7qy<|9H7F$gMJWMMUc{?VXGSqR;;h^E zpiVX^zBUpJ=;+h0kVA6tqv*$*bd?lF>fE+-xU^_XXiwWwrdX_BwrAYT>$xVYc`Y_C zM2$b%<=+n3{}+8;iAf_fFG;+o>r4!<1V$f^^Ws92knzL&*hlZGXu@St;)#3>{fb^6 z>2cU8+$*DVu>)wsa4>0p^W-EBD7T{wzyDXPD*mE0ry+|tc zv}4wlYfRu5bXVW#2e^KreEV0yFX*RQH#uJ}i}$Fc0Yvh#fB!dn5qG6pmFRg&OP{Pe z%n)CgJe`!+Y9rs+fcoloEqS!6(r<$?yl`ab^MW!mL+YQnHA^WTbu(;ziVNkVV1w5f z1ar!W&zla18Z|W&1 z$%Vdp24MCGK$G&TMXpuLtrS!{Io9nVuYCR6+kiy-GrXQK#%&OZ9*K8qXujl4mvGMO#6y2EIz&--!>ZZ$wh z$uEQOOBd7Q;O}=l30g0rCL^`x2RroI&65~5M(@-2_17`GZhK8Og_3ubQ%j(^=(jl? zShfX7`Y;c()@Yjm%JNjJy$4DJ?5P;G2@t_551n76C=~Q9_1xgyF70F9yp(|)#>}aK znhyZVt(kB??puo6)ZUW{4=Z1%8Kev5u@pz0q$%L=i+R8`geir88xH&%D!Jr5CmhlB zv?wf?9C|(73zbg4Us4vv*#DS>Jt;HKS#G~1S#m}bd%!M-vL^;76Xt#MMsDW-1f1r$3lcr79b&iLP%F<>7=PwkMUD11-)*8Xb`q6dJ*PfH+%_P+jxGFPLd6! zGJMg+w=`x}fASBI{v?cA4JFKwMS8EX~5;mEubJFeHF?jxb%QMVrpU?Pl5 z#HKW$4o1}{{bJWh!>fK5SF}4SG${eOw2J9t8pr6*4()?~tgiCr=GRC8Qv=t>*~ zHY!$mCG|=m`_}5d=$=~-!t7CTB(%)6g)Vvz{d8x0thD_6tEt+%q^whz9#l!dH}M}1 z)I+8;kkbQR=J{_?)=ATD#_$IO>)leQGqKCRqNEa5|X5O|LRZn66!cDn^|e0nF-0&f@BI-FThYur5Dwc-^t~WDCNlIm(_8R zG$x(_GKn-pAszdlwR2$+<*9`|t&fy*9(G+_={~9mX$I6_QPXx(8F{mAhwofcb+oBX z7ew^r0S{t&ZWEUrR>%0urnb!qK|}#pM;BgRHit-xDEaf^rhb{%hdQ}eI}<++tR22t zLeVc{!5S-}jml&GVA{KX+T{BT8vd*6-%@^1JRmM?^ZSP2kByGjRZg5mepES^mPn#0< zrkw5mgVw~}q3|I0&a_*nu_=RZ`Rn;ZcUne4*l)@(aOL8ugS79;eIKftY(g7kR)OCv zTkwUq7qeISi@0+qtF+<^*vZK{D-BTZoC8@yH?ylepAbuyBq-a-jE9?D(n$r^k)Lle zH}oKh8aprtVFTt5U5pq5c75l3j_Hw3S4uFWccTYx7NWF9>z~n_&e=*BqUlFFnj^P> zTQfBJG**U@5$6lV~Hey;PX>O^X@xsq0K* z%9hJDplChVp!$!4shtr`G^Tw%*4=O%u45t>fm`+^BvaYP)0C&m6R+~PwoThb_o*Oj z;Z@{zVwW*8uMN`#4<)z9Z`CMYbiP^Y6z{Lp@KKVb1$vR)Ut=YG!iR_I`?Tci!ZK{d zMN;(rB7zh&qQLzSvps`%W){?v5aG@rh`}>be{~9SIzqNyCSpwnqZ>v7$o3g;>9K@+ z19()Jy7Q~YM(YZwVN5Nh1zdAdK0Ur*sAS~Mh~wWx(b0&+A)(zzzF~bq%90f9%YAw%e_N+^&Ba>VCku3Nvp$7JFR! zJ>z>g#ZUritwqRl6oh|UWlyDV68D`Q89?>xib{iaw-@EJXE70i%nUccrt_iZ72L3s zjykU<)0ZwOrVtu&GhSFOZygfUAJR0g13B|i&V)`SFun?Gb@hD0@O{~u+WicVGrm}3 z+6}t1U^Oq75Y-;CCHk)vn1^H)N#fjHuRj`Xz4{2dBU9oPajcP9EXdu+lv546xAU< z^!c|&Hk$Y2eK=AviGO4X#pa}&zA0sG(kcl#!O|Y0q>oPZVCv-i)Hsh2XqShbvwM@ z$i$UzdsZX!0QwKORlqyN9>eZys-u0RN(O_7s<~EgXl@N(D<%C-SH1VxprExt6s!gG zG*h(I1yP&=KkJL?P3jCbf_Y8_<7SS{7tE_-4Rj$is!GXW)_}K4%Q_Ge2&X93WhJ&b z9_FcI`T@L1v;;SRxA#yegS_Y+#q)!nnVQ+#xm&MNKZml0nOtf}q2Gj-#BK`nYO_k) z%(KVg_0hLl@H`=~uJ$C8ebZa63Epzao#a-3nXDPyPuw2%qF_oT>Jr=5ujH9$Eri&% z5^$FjYK|uP%QTvFe{<}5K*incLHxV&@%lt_6vxZy#u+VTn;`IPIA^*k{=ZV4dhcIM zR}-$?mKI9@#iWG3bHiZ*UexZPKs@Qo;p^F!2x8LjAbCk)l6!kTUPA(fKvlneZ+aH> zaQ1{xUHC7|4#xx}mOwE8tt#(zu5b==MF2K)hFct~91>BKJ8(D^jGqSx0B`eDTo*DBF-(O9)~O%xP33*eg zux`8A;LGa)Q93SO4yxpBQLO_3r=CV%ZlcGz7&cTa|JHElAv9!^&XNjN9#}VfMp{&A zj={zIE7fW%0BYX)FYwKJm`V}@CZ3YOBg{hsE`T&wA-a-To)7=?to;t1)%-%^GmWW! zV+HKx>%xHnV2b&0FZQ1@UFm&+5?V<9W6b@bAs9IPpj#AgorFgIUM1`YoNYLOL=?mw z^t6-fzS#v%xWeZ{LKYe=niaA)u>6J=_yRGm8tA5A!!s8UHd` zfyYIzxvM2{-OL#a!eCDzoz zbSd{wec>mmr}?+)G5+9?%5<)hugJgr0?L1H>;{Z?Vq#f|yk4=-ObuQ*(zr|(WQ@P)_ezqWobadGxnAy>a(!5dq<@*EJXT-hmm_{++b|8nT~Z4e}hp|y@O^7b#*$jhR`r(*x}G5 zVc5YGTX&R%yg%D}%j0()iRi!PbUVNF8m`QD^V1^W2Yd6P?a?`k7o`5_bN_hO0)ci@ z{|?UnH^=JVR+QO8UEi}7`bqLq(RzygS6kVcoU@hc_9?Z}GeO)&7)OqJ_Ul$@gLED_ zz*dZ)O~eDBG%0lztgUQHl*^$!RkCDR&xtu{bQpH6E<{atgu4;L!X{MsepmSxz>PZv zmgDtf8O&m>mu zqel-@-qV4xBWAcHUez<_d)O=~Ws!a!jG=z*y0qaje*G+Sg3R@~#`eUZ%wt9haxQF( z5m3w1TP+OSHqeU088aXs2pH^~F_nyD3m?`2M}X%IC7{=-jT?;MT>t^pX}&HHq0=Y^ z+SvoOQM0R+TMsWU7ra&tx;%fN4wD>|0oI~+?`Y=Eqq_f;>g;eq)SJ%EBK^}LJK9a* z+tsu?)>rANEKU7qz*{{qh&nE@E4K%fjpOIEy5 zgkFrW!Z4l)D?%$ z=tu^up!yU>rHVP%duMHt<|SsEUUuxA&^vLi`Q1WB-~A;%_m8BYiQ*X#Jzqk-a^L2} zkiOggB~R1G={NBeN8gTwk(F)pi5|VIGhhe(yJ)8#&ZlMY>!@STo8rA$BYSppzyS*n z8_v~83H##t^(+G|yPviTjcEpNEzQ6lQLFgzoz^$U$y>5rqkE_~mdSGUPm$7|PT9!;ZAg{F)N2M%k0#!)WL1zH#^i7_|hKdo>5xeriRe^L{J@!{)!ayJtxc zzq3i~t~RSrg+3zKkH)MHeftiYCBFL=-Gha9d2b?+c50?tfeVuRWTp@ILFRJu`}vB> zNJeAEc9D{s+5J+gx~qV4TlJdxLiRAYTOLqT@PD;ewK5hvO~I$G8>;DaVN!kOH)J0K zI?^QA`*y%Hu5Z^tmKI$4PRT~d2*?BSnU?y$w>tW#!!|v2HxVYaEvNrosXPqWd_dpm zrC0D$FG7H_B>Bj32=%^XHOI;MAK)dKsh~hXDPoM4D$Tti2K&R6M7%;6q3xeDA4Q?F z92H~Ccmj5peWI%5!Y|yG9DGr!Y!+Gv#(F_SCvmdB1oTP3a`|F={lc{2s-F!fwOKZ< zcCoGnYZn|sYiMd)*Uzt!e0WnZlF(z0%@r1?l5Bq*J?`6$AGXjyKVm19UfodUPOo~_ zYgCC+xz^Qc!P81t;t>N)GL`tU!!P~1Lx*sgeI3MSyMoe~%u*=z2i=nj>AT+v)(M(B zZ5(eAs%n|k2}W)1KIjln>X)|d9rvVL=r?KOk)Pv-X_-y#axxbaGoi@r~m6LJQV zian-YiWnuwUz$Awf1gCVIN6RC8YH9LdL^k?=X+1BRVO~*n3ja+O+2zp!%q4-GT8&! z_FF)VZ6mk9pJK?eXMDs4=z2Q_%%U=$)DMfrJ!H3kzT*r|2l_8)p8BbV+KKz55%8_c z`cOp@&k6B68bO9$o>aw(EDMZrRN9K1*zYGs3-_8h57en8qrlhCNTrATW&98BuZlv) zTpG(=^DHL~4I!;RT5<0wLXPs8SeLcP=id|-AAv!)WUPB@y`Jm0R0At?ewQXeE(>mO0FELl(rqKD24~5qgF#}HY5Dx% zLV>C19*vrYyeS-XJT#U;4)q;BR!ls3gWA?MxgRoHo;0!sGaasf$S&ykDZG%9^JXvw z8 zK&O^J!@Wc;-RSMF;LV8%uhr`?PmK9pEuruoD@gdyCe}ckh zjos=kRp)5GQOf1NDBFVln{{1mV(XpAB3_i0DU0x8(vXNeFu}5VhBeO{=*Wr!4AVnRBS=elVc7#G(q*Pbs}Eqp0cPZvi{Gh6D|AoI2FZ%|i_a-py{QbBtm--6?qs#b-e$$MY{7HAJl~HOJ<^Pr&(w%qJfE zhoOt@(q+K|PD0!&`L5q5s%K%#EqUbM2F7P@H<9l}ivzn~e4c65uuXdh(la=E=z;r( z*;=ornq%x6h4#hJe1iFu{qgHu7;8@3`oY*hcr|f`=toD>_V}=wY`LhsnMoE+PPZgU z%H2e{TaXM-dn+Ui;Q2v&B>v)QSH_;AL~jsO5_^Kc&K3OJVGx!1@rmugPq|w$20gvo z9BO+iS3N#Ks(22+9eC~dJbFa(VBBMZ)jBw5{~y-C&aU;Hh3nlm027_qO>+xjz-Xka zg-nu+^K3mfpSR2tAW`p;s3${aN2XPc*_RyhCBlkt zb0%#mv9zmsuU%W0`p%>?!~KMisNnwLYf0VeIEBs9?vUSBChaKjazd*R+v{;2={CBA zE}$EML&3hW!+ML606+?Ku2w?3B{p*_V5mpdNxwwJzWpr5=1OS!>a&x-)e%8IFQ@GaG8#%jRy8&gL_}gp%JFcrAv%bdb=YGAVN zv)jt055{f6O2Arhs-fZVsm%K$q&(Z8;7G2?r6I-~kf%|pV_E&aUvM!ESK0>Y(T=I( zq{)>2|IsCwL~kVBp#wsmJ{hr;@p#Mj)c0=mYK8S)YfZnFpSs3{68_CA5S34(r;rv5 z;lbwF(H#H?a=Mo{a&ZOB`3E4SH)XEW#L|#3RE7Wg)7H=S%i#*RZ@_Q@5+JdoD7$V4 z7P<cgU6 z!d75-V%&nAG_{vxg|!S8re8QL-7LYsb0%4rdY00(27l#}J;!yF% zn}WXwgSo9UoXNL93yHj1d8m=7R$kD3ko{Jy%L@BVZuFwy^meyX+oh6nHZ{y_wJQtP z$n|^uENk&Mfg6$^V>4V`*p8pj{9JoCe~U$m`gZn`{o$q?M9t^-khGG zNu4~_?ymW^3`}J)#ad@?J#TGr>PUceZ^k+C6$XgzOt)8ajLjFtFmNief>K0qf`*OFKx8bgUArn2sI@6Vhy9Cw36N zR`BTt<`$BF#0xY%Mn24{xqLYLikZo}Q6gs(yRUzWImN!dqgbgzTRLu+9}d7iek$tkArBtZLB+}AimLutGv)kH(0L~-!L+|#@{~E zY9)uMPIfa15J9FabLtE!gx}O?Q)lx){`KYWo?IeiX;b^jwD*6OmR;E9!Ia$FM1cPL zrU6uA=6YTXRIp>QQ7B3GOKYm-w|`FTi&>-*535X>45D!M3vsH2x;*BY3y0)JA`QL0 zpoc5_=Dgg;$II}s>3qWPc|^!1O5&0+W`RP-21|Ms^E)JRnoQqy3$1E^U;rIQ%0{fE zV<8nsGJiKGf%)tKekgR3Jd3UF=quzvJ@}3CfFy|&?a;~*?AptCDuK{tGhS% zNXfP=(C>49;2QG?nTYRqWEd8Du@YJpJT;dhD-~x7Gbof$w!Y9TsgswEAT=Fr(A%=< zws@Y#s?VGdvE?5r3IwBPK_0;0IgSWa-@HR73mpbw_NN(tpGl|Ooui{l z-VQv~M$zbcUsOM9Za;|?JWFXXj&(L9H$<-bXtr9N1;1`AdT(qd#WE!RXaQbF;5#^LW=bB4_k5DTvBR6r;b<*78p-l036KZWOi$Yad$?w$)Wu z^{3oIL5^45gemH%S!U!IPZ1Of=U5&>46=Abwjas-ca1dr*`OXe(2>cp*VxeDohF6V z7c)embISrMU5H+H+O!7JuFfAoDQzON{tEBgYSk{&j%qg14?#gU6?8br20;Bsu)M)w zu7AAOyM~Ha=18_N+Pqf6lkEOfCz^~&q)t^Dn}MuXHtVxqCyJ)l&z2nI~6=L`FaD zSRqGW1LE_HihN*%;&LdON_m2JjpK<~pNE?Vnq67c0(Lr;@wGEB{HSgeIN%^Dxf&uYJk3OjnISh(Wq$Qq{qOoIBYZxYVPkw#aM^TyHSTikNnv=I>?Q}QoIPA*Cc@- zgKlWlh^lrHyNr&ls+834thDA^a2KBzOh`QM>Yndwu*vOJJtZ2l!r#U7y z7zCLIYN#q8uXOoNu9w@22ji`9mEP&;T*6Z*AjNF2H-EHWl3x(EsJ%b@m%y~v>U=hs zvYJL$khK^knyE@5IJhY-z}jwCK^!6Y-Ulsr#``DB`6fYb?pkV+$6X9b19xN+8C9lx zcrv_fxinDP!>HjwS4w0!L$R)(@w*a|b4fDuAGQAdfdYC-1&O=kIlXZW<}*#nAs?lN zNB*}0fvnX9`B#03ju)1aa3U4TxgW*DXngIOnLk}L_rR9=JB`d-fn+}gCvc_*-(ht% zCNO0B7s%%!`pdnCr{C4Shj{?>IIT8zoJ2-%hhQ=FWn9gt)G8h{MosUV&J4=9jA<8b zRe(UM+LA}21HgNz)4fw)=cS6_rkbTW1e2xjBgH^C@09h)eEy#XBAtWHzj{td8$Yn4 zi)*2aF6L{gs9uk3<3+P&gH#U7^4)GUpjL5rhu!Nnm`|gAf%$39SJPKpYo8OsqlaeC zRvScjvmr{4cwuzcQovt8zc`DE)Q98!bCy%!0UK7Q2g4XI7j0@a0A(c5rY3?q0DVlg ziyU}@k+Dw7ty9Jo4ZJKflUHkf)gX2Fr4cb#w{6f-rt#dkI{dFruaj3l1b001aQk20 z3?ocAc4?q>(if*1V10cv?spSwHq{hPTByKpu=r`->5b-Z4}K$41@t}VS`IIxQb4%T zo^hykGTkUV3#vTEOl#;4(~K;^EYXQxvGT!V<3i2;fjw}4$y>)Pl2v2vtd4$U7mIM_ zGGpPC0^uL4wjW~6m#G`KngO8fvR7qql({CV#lKv`G4`J-(W5_jQIik_qthmJ2MY#2 zX~W>xL(o@``ZTT%c>`G3e`TmicXhOp#}+H-iq69k@2q<)!xb1QVD56ZAFqOnGFOA7+IzQ8kxUf@*xU2luGw&xhuHm_ z<@>{K#53vLPdkTo1VdZ zHu!a#>t z$yT#MPX1nnp(W<(>H>0>`je1Ansjdr@^-K@wCJsQY>+YS(fmIpzg7>T2=RKY+uftH zsk%5v+O^>aS8cAXWG47=2KL{w?^0zs;M}H@lY3SVFofTvTVR7EI9q?*t8a{;cG)T1 z+T5!wAi;JT+b^>YQ;GbCD>@NrzGYDdE|q2&f)@7#hAj?ra;V8n*dwF02uOkOed9a@M z0FO?$5dAngdOMsOxX zgE@KQM=Mk11$lALl*HoYzBFMQ#$3o-tpRZxvfpmz`E88k>8rV#?@;_Rq30 z>B;&3aP^j9ZAI<2HXhvF-Q9`?DDF^-6)jSrNO5bhT0@ zXIp_S@jMlOL-Vz!c=L_A9wgBbTxCfU-oJ#P{z7aL_cQV~CW$~eCiU+m)c$>!(#-!_ zj*B-a->a-V+2~&|G;IEfaR%_lBzg$pFueW+R}ERJMo1>eBhg6@g^s^CrhIdQ>DQ_i zCez>UN50y~d5o$8@J9G1%~o#~0dXnSWmn$pTsRFzTkS)}VZtK}&@y9ZZ$o?x~>G1OSRJK{)Sre0^{AQ9F(qd z{VW(scDmZlL4a&0>dB(wBCYrs@{gY2hYZWx58x_iaX(awAe!42ywApL-fcZeHt+nJ zveN}67*hHfKdl}f537A>GZ;vbw0ZY-{Bm_Mcyymn&q-(B9b42D;TM~0ULx6(@bz(&OZ zlLt4aPVTD|?EEdmk;@pxO4Xh8jKKp!HO6{O4O*BgTcJdzjD>a|P*7X?SZ}wCCAB_H zGGaWrwCKp!cx5bYIT}zF{4}WV4>jEBU9=PtpASBlE4QfYplauS|EFg{JU@U;53Tp| z(ND+r($wnD?tmGgOtn-eX;msLlKtbmd_BJe-#%8NXORSIBPs1z#Y!GYzA>&MB3pFT zN>$NVKuqY4LvkL5_oe7&P;4rL`_>`4Z@b@91^sKzHmDCsulnYao`JqmA z+v__ui^q6+o$-TiFLm=&5zQ#(r*$gGfJNG;Vwvli{th`>)L0wB=^V0wH|#}BA#Wba z>yUOMi1L8_YBbNAcv+WZ2L~emOSkjIMW{Rl+ZOlekuLDnM0$|zMlF=T@X4(G9qb@r zNRWu9mQ+(5+E)9kw(tQ12&{=}Cfe)uIf90DvcA(=UH^7 z{5j=i3!aM5^Cye)W}CN$T=)zXL1Sx}f9o6?mdzOwbXKiu8sgo*n2yA}M0nf~_(3S_ zkkD9e9-~T);%N^dp^X+Cb6JD>W9MY=KFaKKjt;M!+1_&=)7oSJP0axNYCi)ZK8YQe ztHMEaayc7%N|f_bx|wX_(5)XrJu9!l4W`@f(5H_QIrg*~tj(&~Y+&_3L z-gJNc&yEL<1j<~#oTp#-nv#-{j_Z&mLm5MqTx@;lkK(rV_uONQ`)4)km(y60Ed)6< zy{@ky0heEE6pCjjk3x~h@oDnY&dALNmx!ROoW_TrejKKsw}Et~6~(vEiUp4<^xB)e zG3qwT*a{J4{8*Zu$7>ywRRP9d(9AY~yh8yPpN?;jZWKEbm~Ch-GycGOsZ)C$-(idp zt!!jRa9%YXWStw5G1r2XyQWs_^Ipaq*O~MV?DQS(cd z-O&2rc%orZ;$jT%qS4Sn*&*|v>_Zor6v)veZ^-RLCy0w=jOqFEI}zklCv+Zpz7y>E zmnU834=DofYq=ntg_EY#CQisa4hCAiaZlEm0>9y@s&w&n##x6bEI6+>aTbO_VYo${Lj$xr(Ni9J!jQ zrEXK!#|u?*lY5>@h`PQ>83s(3{%$xYteeKg#jZyt z16aA3GBFJ(OB zYH?W25hu?jw4(178)lLxnRnWz8fr*OMyA^mP*v|yc#Kbn`Il{tL8u}E9 zcJ<6o0_E~}>!fIXI0*{ScQj|_SD4sJ@Z~9bQ1l$B-YPR`SNR?E6?g@AvUZ8rkV`1~ z1tAm=%ztzd6zTb3>iR1TlY;A>!pLFt`b8e^t@*yL%-XrdH>rsGX^P1~(-bTku~~+C zWb^lzgBtag`V)cWntQOTC{LhW4EiD}t?e%>X>Ou&1s@$sVCq0n9fbulGd^nveElP@ zW+xOlFBei@6iGpoQN-aJtA~4oL!PlOJ|P_n6UWt~UYoZ6W+%y~wd5FYO%?P~6Rq6X zO%`REmTu5^EO#X>+XAeqhmcdXnRgju6g&hjFTg>l;FtC!q-yt& zBO{K&s4Yk8|JOP5m-=VF1s8O)4jeu1YUQ878*)Kp(_$$c=~dBU?|sd#9WNIl5Kk}` zCmHx&Otu%V9^!NlRJBytrfw~Eh?`a8R@supu~L~8#WgUv^;BXD#B9k!<5v=jB6By| z_%;(03{z;|HsSg?6t~W2!3~YZ%edq<{&M~&zR(cJ`1(hfh0aHWfAf9DED&Uyzm08vcKlm4qvB8rH%K=(_Pj1A!v>9tG%jVK7Ed&H0;~ zo2CYS3nk2en$P8WbWczwO@w%4NI0+5Yf#V+ql-oF^K9qRJ}&_PUM-Q9OAdS^aD9LXTX9piRHVkH#Cl zUDI!3Jbu6?%B;fEC%^Z8sZ0JGkOzCV+VGnqjl+}b*Sw@!l;?N4hc1y037uNcj3g8X zbwF1p1TocGN(VjF)6EZx- z+3CILKb}U;orGDE$}~;Bgg;{ommfc>+S|>-fFvQF2QJV8ucX;Okz}(6Jq%6eYI>3wS{pw%=YDj3DA?a& zlxcwL8@$t?<8`$f`_6W?F;&q2VV=rHBU0(RW>*TpaGAwg`v zUy9FLE#7O}5ihYg+(n0f0IXcsBP)=h|0Uq4NO-+*5T#*X69Q&{gH&EW^jo+jvxP$7 z#drJl*Tx+mpvnbnM`2PP^+Q0xsyqq*;U7p^z;=s66viz9eOBAE9CC z#!$eE`=0A-lQ~*Dhs5tE+v4y-0nR;JP=1&i)8eEWr@lD7S9sWQxc32_*6+mVh=V$H zaR>X<(z2_*eVw<1lRB7RsR34GdMVzYC17HFcy3#l+*duM5w`4_ZQm5FwcsbgADBGD zjiA|M+XnVIcRP`(f3&yZr;Fpz&3cGryI9mR)Uer%z z>VEqFd*Ur`4z=quE=i5mYGgl#h=KIXAAT%HCG7}<_`PQ-UB7-TMTw$NVy(9Cd7EKb zR}H`|h-gaXkAbm_D>Z+e=0zi(6pHu9md2LE=EOF*j#LUjiC1b|{Tm^JBWnM5sfNK| z99Z?YwrSD@-ie%F5~2}}ry@3KdJZs+NH820RU@g!2q~t1s9|mrqN2cT$ww2kv6-V? z6Om&00m9uQ3VMVlKkuAU({!iYs6}HXB25}g_%|i`g|q1R5i(QY6@G!FS87=-X$X>% zzhoi`pr)OTp=3?a9mRn4Rk*f4sSK$r4QkP97JYxTB!tGDIx*B|Uw{R=OFVx6_`FYf zg>A?FS%=LqCNIk<%s1>oE&y`^k+gGPEJwSs$$Wbf3xOKJS~Dg<=Au!szs1O<6WS)2 zAvi(MnEQr?2jvJl6)zcWLz72M6b>U%z~!ur7e|x!bJyTD+G_Sa9nH=dYJxvWb+oPfytPG)7lEY$ zwZ*`2zNhgD(B&)9>!{eojB)skD6;y^2CeKVBjfC-sa;^@m@sUaCbMo6ckK zE6TIP8^3yW^U*rJaU;YdyXXTKN-_j{kk89ly0f40ec0m(+agI=eu8p2OQW1go8PGWm3M0R)zKUcobz&M=LV=> ze)xjPp=a51v$+&}`6Mpe9VeTZ6EPC@#N=;W5yP0XbjtpB0_G1p$GMVI0H)kKFr7zV zM|X|MQ}`RhsnA#UI_7^H1Dhys*j>$6B(w0U-r=&tI^CLgzQ`CsWK3&Omk|H=H9Pzc zBKY{w`VPo!jmi|qgE|?Ts25o%;vbnbOD-dtN^ICY>VVB~S@UU3`d>j!YbdwD`4;i; zfi)@}mqkpw5b?y+q|J6~Jg!tUHp>*M%I29&{JJ*J4xfyHlLEVtTtT=+LaJd(u5fQqg@T*GYTbTSGQ?TdH{QRXc8F~`9%$*h#7ysFT6Wv z#?#0%kp`9e=RDYW%Cz*j>hf=F^!N}S@ICO{Lk66PW$w$LwVe5DQayauJCk0cVOI$$ zTfN70TS5hRlxDCe+VfU3)-*q}NUGl0j#H{{lssuzhW82!i#FmHb~hMx<5LQZ_uK79 zHHvLz|&#a0ZI`k~ylR>(9T8BPAl`}v!cE68>3#Iwe%n}jqGZF{a3P@Y5& zU}Yf`Uhk;y+OHswH<|E2Qj7;Hkf4>JDMHTTq92-+$k?tLKgP_RD`6rd^(ksYF4En6 z#7`HspevaJdNwcgc*$w;R4pV>D@$S?Cj0u4PB;=iDuzO~?Odux8Tf8{?7U6~VyH8i z_|93br|!bp&#t#A%L-z{y$n^v<6Gx?n`%n`Mb)q5s{Z+!UmRY4Q$s&-DNq-*az^BZ z62&})$6PlYNZ<&lTHOMU@JPa>??CfdK%1014+Dp|ruep(9rZ>iN9`yguxm?PenRe0 zOFQfd^l+3-)U!hxS;WB@d-m&rF{ACCYVc0khMugCbMuiPT?r@^>RnrEek1-PSEC>+No>~J1Sqn@ zD|sx$2|d<@i5x8qT{2eiNXA$_?2%j(K+Ipp&o7W^#Gp#+CMFAyhQa2Ie*-R=t1vu# zPitk{z0f?#ekNHas7m16D+>UAZ7V{u8TckQ3NdXn9Vq^Gg)=lGF<1$i2Pa#*;YKlY zai!sI&HWoq!$0}UIzuv1G|K_8qS_bHG*vt;cGD6A8~_j_MDm5=sTu@$Ckjf1KRE!l zUv3d@G}AOj!1#svjQR#y2BQo10s@Q{iswi8DTfqdMoI~_SvJ%48brtaf&`L<4y_R$ zp&oHFztxd0tA^q@M;P@>fxGfRngN$A*}T@5vhK|ihM{U7{S>PtNp5|#U7Ov$#f?9I zc`Jlu@X$Gr7!<7#Q;h(}e&zU@?JdEc1O<0oy)S63MD{Ewf>K z5L=xTnr-+42ISmHJ(ZGf<(Q(-*4=NCa$ zm-iB71<6aKo>;Z03bb!1^+J=xjFUHe14#%(A+jT5fCHf)7a%+Az;k^H;Z;^q89Axf zJlS7mL~F(BHS%B+WLdz#v+brS&=lNbuJ@15kfzNqJX#zDkMGIFaQ~l2Lwfzz>6O>l z|4}D=-O8ygMOeEyH!sAKVO#qW22I&>kWf*<(5-j5vwHEkI= zK;rbMb86O$C$!j6;}NamIk1i5h2r}vkqk~QP#x-LQ>5bAu?I~z(oR>l-gCeE1+hMW zYR@~!c>UyLMtT+hF4$&SwT^6jI}XKKIFO~K$Sg&EI`~sMGRZ#Wt5V~KuSlQd5jUW1 ztS18@6m^`S^g3|L*EjGWM$Kb?P8jhYLKdau{S6 zZY)$!-g~M-nB&n<w|-%e`)YDGsmc%z)^!+3VSf1?jC7Q&!G`kWR$`Z^ zdO4Kkk>$%+krcA?>V7a??7p{5U}!)Tl`2rc{MpP>UttI_ERlF^1}XXbD6D^cq6g z(b9D{`~`2-esyrL4j@<(eysYXlYm#n07Yx{{)Kt5SyXq!hMQ{bDWIFsL4%%A9|6E_ zvNB?c7v@PQKTseVwpHpcIZ`oTt0VP#K_JEqc&xDOCH~y_k(3}=oQtWs^#dP43M|OR z=No=qaVfT61(D&yi>S)J)PB#yhj+kwaT_MwDY#sG>i=q1 zpz)KoPpzT3b(U~L%21V?TV&z(;7=*SMB=Rm`lMxYuP`QDOtORxAgA}iLhwc z1+^2li{-90jHkPw0->re)b!{Fs#}r>&zb|&c269yZCfizxamTbZu^(TElWpoS4>Oe zBc0O!;};(yY3%GY{_}drXNU*W?bPsr zvCf2Y|FTOcNmpRZUJ19T!BIu=SGlhQOPfEpzLTSqE5G?Y97o>w`FFL<9=?5qnBn4b zj)9ksjXX9JfqZh1bFWAQ60WJx`)eFU7RiC1kS&uklmKYs+w590{?(>lkzu+F#+vzZ zX#+pT2;h(%h1xV)b@mKc3L+mtMj1Fdkue$c63(&rQQ;A56SHBtq1@DxdOa(*J|)3J z&?OBXQj%~OXLTE68~+jU;B7&h4!VS28zy~%6Vybf71`2T&Z2 zZiV*6XSEB`God{mEto<4Giql48tU$|$zB<8XuV*gBfXT!P?_XGXTVw+CN90dHAWAw z@$m$cvvy}h490sdO^vVBgMQ;}RfiR(5>;ybCA3@hM0$RkX`7#aBtYxGvdcT+L1Fs6 zMszoL2h)~zNH#YC(qrn7zZV(6cw++oS7wpU8xZgf+Hom~{q#hvZgI3U#$YmMHy2WKi z5_hR%5NF{z9-O#v3;7G2gSa|h>@Wv7*cIH1fl=DO%l4iS4JPO(3)cdUe|Z)af!7!g z;vO)ko9Y3NJ1$)0T94L+Z?Wucc7QItww$xyhgNsR`zj0_4qQUHcw+i z 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 L*8ZUN==uKvyZu1V literal 0 HcmV?d00001 diff --git a/index.md b/index.md index daaf162b8..a27067bfa 100644 --- a/index.md +++ b/index.md @@ -4,9 +4,9 @@ title: Student Blog --- -## Build you Home Page here -This is about your journey. Start now!!! - +## Soham Kulkarni's Page +My name is Soham. A few things I like to do is to reading, play tennis, and code +![](images/about_me_picture_csp.png) ## Overview of Hacks, Study and Tangibles Blogging in GitHub pages is a way to learn and code at the same time. diff --git a/scripts/__pycache__/convert_notebooks.cpython-310.pyc b/scripts/__pycache__/convert_notebooks.cpython-310.pyc new file mode 100644 index 0000000000000000000000000000000000000000..84003c17b2428e889be634ec21a6935474e6376d GIT binary patch literal 2745 zcmb7GU2hx572TQr;BrM$lq1JZ8W>E_6krQetsjauFkCybixfzhqA6mSXs}&zMh>Or z?s|4)iNw-yp`dR;e?VY>dhEaH^Srh|iQ+8Raxc#hOB2LJUg~nl zXqAh{Md=~!B9*t1Y3G2=dF7n3xht69XMDzNpQrtbp~Y=0sQ4LE*R(UQQH>zLA(6Un z|2*i8ib=M2-iZJ3#|Qln;~Q~rEV`lLd1<^N(O;TyFDYe~jHRh5S)|EO8t)(z2Gd9QeXluFZHpZ9tXZTe3~y@3m!-`M#w zAIqIWB?rl&-YNBwkQvIM8Wpk$bN;&$eHnq&0$K5s$02pCS0I+d)m@`PHj)P!aL)_e+&4}_qhyyeA&bUeu1+v0bZM z>zkm=j}!oRrtbCY*PqjwpA#jf@7|+Jc8UZX${uze-1+3=&c4bs-5Dnu9Q&Ztjg0$H zY7><@QMx=H!Ia)48KtIP}9-?doCwwcGn zr~Et5S3kpmmzckSjyjUHPXGY4Q(4;x_iOhb3an=buorUJUy)PqZQ#~k!T8TPu83L2O->%W1jgfbiE0(?L{O3L^`VU%Tz2LeTgMK1xnl#~+S zmhU0^8-V?y0Z>5cihYAaRUGtnKgSUtaZYtH=rtD9 zZ$6ZnJSo(zU(*&OU;JsuncjKTbz_}_Pz#}qiL5X2rgt;Vhe=xA>aEtB1`*vTQUTUf zHDrbzcejj}7cw(pwzr=vFw}TTg6L8I(|GsO{^$4p^k+*i;}erh;}&_L$gRvJ@N~RV z5>$j#4f^1Zv>cZzq-}_Vij+bTB^81Zz8@=$=x$tih!wPOsd(zAG$aH9R{Bl2yrW^U z*z7>Hq-mR6Gp2*3sEC2?0Wt4%e$+1*|GB8fpt6T7ua6Cg{)h%2UWyp)j(o_DuqAx?F)kAv| zD|V5}6J!XujwT;s&mc52fOOaSVrRytfrf7_0DBZ6WVn;x0xtZgOn;(1vG6+=Asj(t z1y`_`p=)#ep{&8hpYTT!z(Pr2Sy}M=({ShKi@>fv#7WkGsvGZNn(vuQONPFP-1bT@ zAXIdbS0QvwYc-LWUjBbbx0aADCzKx(G86*ZEacoqV*>O|3#j+K`Usy)7()j}SsZt_ z)II8`XL}bbEgbdjRl9ejM`_uU%Ri`cad_*gH!xLEq*>Vi_f#WyU0jIxzhDfRakVl1 w<;3wCH!MqRI16u%b8(c)TO_7dDnqA%D})!X=X!3)!&=x5uZ3aQi14HFKO}#l-v9sr literal 0 HcmV?d00001 From 4e597850019e80930f2ca81d6b3b67a46ce5fef6 Mon Sep 17 00:00:00 2001 From: sooctosnake Date: Wed, 23 Aug 2023 12:57:33 -0700 Subject: [PATCH 02/27] added python game --- .../2023-08-17-AP-pseudo-vs-python.ipynb | 7 ++++++ get_to_know_me_game.py | 15 +++++++++++++ index.md | 1 + indexBlogs.md | 22 ++++++++++++++++++- 4 files changed, 44 insertions(+), 1 deletion(-) create mode 100644 get_to_know_me_game.py diff --git a/_notebooks/2023-08-17-AP-pseudo-vs-python.ipynb b/_notebooks/2023-08-17-AP-pseudo-vs-python.ipynb index 5e36ea783..2bf2ad3e4 100644 --- a/_notebooks/2023-08-17-AP-pseudo-vs-python.ipynb +++ b/_notebooks/2023-08-17-AP-pseudo-vs-python.ipynb @@ -16,6 +16,13 @@ "---" ] }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [] + }, { "attachments": {}, "cell_type": "markdown", diff --git a/get_to_know_me_game.py b/get_to_know_me_game.py new file mode 100644 index 000000000..35a686b9f --- /dev/null +++ b/get_to_know_me_game.py @@ -0,0 +1,15 @@ +questions = ["When is my birthday", "What is my favorite food"] +response =[["A. July 8th","B. January 9th","C. November 27th","D. June 9th"],["A. Pizza", "B. Salad","C. Pasta", "D. Mac&Cheese"]] +answer = ["A","D"] +print("Hello. Wellome to the Get To Know Me Game. This is a multiple choice test that will test your knowledge about me") +user_answer = "" +for i in range(len(questions)): + print(questions[i]) + for j in range(4): + print(response[i][j]) + user_answer = input() + + if user_answer == answer[i]: + print("Correct!") + else: + print("Incorrect") \ No newline at end of file diff --git a/index.md b/index.md index a27067bfa..b44bde151 100644 --- a/index.md +++ b/index.md @@ -6,6 +6,7 @@ title: Student Blog ## Soham Kulkarni's Page My name is Soham. A few things I like to do is to reading, play tennis, and code + ![](images/about_me_picture_csp.png) ## Overview of Hacks, Study and Tangibles Blogging in GitHub pages is a way to learn and code at the same time. diff --git a/indexBlogs.md b/indexBlogs.md index 58f501482..a767fcbd6 100644 --- a/indexBlogs.md +++ b/indexBlogs.md @@ -1,5 +1,25 @@ --- layout: blogs permalink: /blogs -title: Blogs +title: Soham's Blogs --- + +## +### August 17th 2023 +I installed WSL and vscode. This will help me make a website on github + +#### 1) WSL is a type of virtual machine inbuit in Windows to run linux. + +a. To properly install WSL, I opened the command prompt as adminstrater. This is where we will be doing a lot of the installations + +b. To install WSL, I used the command: **wsl --install** + +c. After WSL installation, I ran this command to install Ubuntu from WSL: **wsl --install -d Ubuntu** + +#### 2) Now I installed vscode. It is good to have all the files of a repository on github but if I wanted to actually make a website and edit it, I would need to use vscode + +a) I first downloaded VScode here: [Download](https://code.visualstudio.com/) + +b) Then install I it. I clicked on add the Remote Developers extension pack (forgot to do it before) and I clicked Add to PATH + +Now I have VS code and WSL working! \ No newline at end of file From 1e9c94252ab5795efed0e3e490ae0d7491b4c133 Mon Sep 17 00:00:00 2001 From: sooctosnake Date: Thu, 24 Aug 2023 08:01:58 -0700 Subject: [PATCH 03/27] updated blog --- get_to_know_me_game.py | 17 ++++-- images/optix_logo.png | Bin 0 -> 26944 bytes images/vscode_in_WSL.png | Bin 0 -> 15913 bytes index.md | 9 +++ indexBlogs.md | 123 ++++++++++++++++++++++++++++++++++++--- 5 files changed, 135 insertions(+), 14 deletions(-) create mode 100644 images/optix_logo.png create mode 100644 images/vscode_in_WSL.png diff --git a/get_to_know_me_game.py b/get_to_know_me_game.py index 35a686b9f..ecdf0a1f0 100644 --- a/get_to_know_me_game.py +++ b/get_to_know_me_game.py @@ -1,15 +1,20 @@ -questions = ["When is my birthday", "What is my favorite food"] -response =[["A. July 8th","B. January 9th","C. November 27th","D. June 9th"],["A. Pizza", "B. Salad","C. Pasta", "D. Mac&Cheese"]] -answer = ["A","D"] -print("Hello. Wellome to the Get To Know Me Game. This is a multiple choice test that will test your knowledge about me") +# Online Python compiler (interpreter) to run Python online. +# Write Python 3 code in this online editor and run it. +questions = ["When is my birthday", "What is my favorite food","What is my favorite color"] +response =[["A. July 8th","B. January 9th","C. November 27th","D. June 9th"],["A. Pizza", "B. Salad","C. Pasta", "D. Mac&Cheese"],["A. Blue", "B. Green","C. Red", "D. Black"]] +answer = ["A","D","B"] +print("Hello. Wellome to the Get To Know Me Game. This is a multiple choic test that will test your knowledge about me") user_answer = "" for i in range(len(questions)): print(questions[i]) for j in range(4): - print(response[i][j]) + print(response[i][j]) user_answer = input() if user_answer == answer[i]: print("Correct!") else: - print("Incorrect") \ No newline at end of file + print("Incorrect") + +print() +print("Thank for playing the game") \ No newline at end of file diff --git a/images/optix_logo.png b/images/optix_logo.png new file mode 100644 index 0000000000000000000000000000000000000000..95e4cbaabe026c59bb7e2d10659a0ad1c37774aa GIT binary patch literal 26944 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 BlePc= literal 0 HcmV?d00001 diff --git a/images/vscode_in_WSL.png b/images/vscode_in_WSL.png new file mode 100644 index 0000000000000000000000000000000000000000..ab43c7890906b35512ea759364421283cf8b153d GIT binary patch literal 15913 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 + ## Overview of Hacks, Study and Tangibles + + Blogging in GitHub pages is a way to learn and code at the same time. - Plans, Lists, [Scrum Boards](https://clickup.com/blog/scrum-board/) help you to track key events, show progress and record time. Effort is a big part of your class grade. Show plans and time spent! diff --git a/indexBlogs.md b/indexBlogs.md index a767fcbd6..2b558dfad 100644 --- a/indexBlogs.md +++ b/indexBlogs.md @@ -3,23 +3,130 @@ layout: blogs permalink: /blogs title: Soham's Blogs --- +## August 22th 2023 +Committed the repository to github. And started working on my website. -## -### August 17th 2023 -I installed WSL and vscode. This will help me make a website on github +### 1) Committing and Push -#### 1) WSL is a type of virtual machine inbuit in Windows to run linux. +a) I clicked source control on the right side of VSCode and committed all the changes. I also synce all the changes + +## August 21th, 2023 +Today I setup Jupyter notebook, Installed Gemfile dependencies, and started a server + +### 1) Installing Packages + +a) I went to the command prompt and ran theses commands: + + pip install nbconvert + pip install nbformat + pip install pyyaml + jupyter --version + jupyter kernelspec list + +b) Then I went to VSCode and opened the terminal in it + +c) Then I ran the command: + **bundle install** +This installs dependencies in my Gemfile + +d) Then I could finally start my local server by running: + **make** +Initially the command didn't work but after commenting line 7 on Makefile (a file in student repo) +(to find out what bundle install and make are, refer to terms page below) + + +## August 18th, 2023 +Today I cloned the teacher repository (for practice) and a student repository for my website. I also configured a git connection with Git Hub and installed/updated a lot of packages. + +### 1) Cloning the repository + +a) First I opened WSL. Then I used the command **cd vscode** to make sure that the I am in the vscode directory + +b) Then I used the command **git clone https://github.com/nighthawkcoders/teacher.git** to clone the teacher repository on VScode (this is just for my practice. I will be cloning the student repository) + +c) Then, I went to github to create my personal repository. This is so that after I clone the student repository, I can push it to my own repository on github. + +d) After that I used the command **git clone https://github.com/nighthawkcoders/student** to clone the repository. + +e) I opened the repository throught VScode using **code student** +Make sure you are running VSCode from WSL + + + +(Bottom left view of VSCode) + +### 2) Git connection to Github + +a) I ran 2 commands on WSL: + + git config --global user.email + + git config --global user.name + + +### 3) Install and Udpating all the packages + +I ran these commands below. Keep in mind that the lines starting with '#' are comment and not actual commands +I had a lot of these packages installed and up to date but it never hurts to be safe. + + sudo apt update + sudo apt upgrade -y + + # Install Ruby and necessary development tools + sudo apt install -y ruby-full build-essential zlib1g-dev + + # Install Python 3 and pip + sudo apt-get install -y python3 python3-pip python-is-python3 + + # Install Jupyter Notebook + sudo apt-get install -y jupyter-notebook + + # Install Gems + export GEM_HOME="$HOME/gems" + export PATH="$HOME/gems/bin:$PATH" + gem install jekyll bundler + + +## August 17th, 2023 +I installed WSL and VSCode. This will help me make a website on github + +### 1) WSL is a type of virtual machine inbuit in Windows to run linux. a. To properly install WSL, I opened the command prompt as adminstrater. This is where we will be doing a lot of the installations -b. To install WSL, I used the command: **wsl --install** +b. To install WSL, I used the command: + **wsl --install** -c. After WSL installation, I ran this command to install Ubuntu from WSL: **wsl --install -d Ubuntu** +c. After WSL installation, I ran this command to install Ubuntu from WSL: + **wsl --install -d Ubuntu** -#### 2) Now I installed vscode. It is good to have all the files of a repository on github but if I wanted to actually make a website and edit it, I would need to use vscode +### 2) Now I installed vscode. It is good to have all the files of a repository on github but if I wanted to actually make a website and edit it, I would need to use vscode a) I first downloaded VScode here: [Download](https://code.visualstudio.com/) b) Then install I it. I clicked on add the Remote Developers extension pack (forgot to do it before) and I clicked Add to PATH -Now I have VS code and WSL working! \ No newline at end of file +Now I have VSCode and WSL working! + + +## Terms + make - command that helps run your local server + make convert - checks and ensures Jupyter notebooks are up to date + make clean - stops the local server and cleans the files + make stop - stops the local server + cd ~ allows you to move through directories + cd vscode - allows you to go to VSCode directory + python –version - shows you your current python version + jupyter –version - shows all your jupyter files and their current versions + git clone - clones a repository + rbenv versions - shows your current ruby versions + ruby -v - shows your current ruby version + bundle install - this command installs the dependencies in your Gemfile + ![]( ) - adds an image on markdown + + + +| Week | Accomplishment | +| ---- | -------------- | +| 1 | Learnt about github | +| 2 | | \ No newline at end of file From c33616053bf3df5e987a39132be3dbf4ec9327f4 Mon Sep 17 00:00:00 2001 From: sooctosnake Date: Thu, 24 Aug 2023 23:57:03 -0700 Subject: [PATCH 04/27] added search terms --- index.md | 63 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 63 insertions(+) diff --git a/index.md b/index.md index 10ead5c71..e55760d3e 100644 --- a/index.md +++ b/index.md @@ -15,6 +15,69 @@ I am also in Del Norte's First Robot Challenge Team Optix 3749 Video + + + + Get To Know Me Game + + +