Merge branch 'master' of https://github.com/pypa/pip into issue-6222

Author: seppeljordan

.github/workflows/python-linters.yml

@@ -0,0 +1,46 @@
+name: Code quality
+
+on:
+  push:
+  pull_request:
+  schedule:
+  # Run every Friday at 18:02 UTC
+  # https://crontab.guru/#2_18_*_*_5
+  - cron: 2 18 * * 5
+
+jobs:
+  linters:
+    name: 🤖
+    runs-on: ${{ matrix.os }}
+    strategy:
+      # max-parallel: 5
+      matrix:
+        os:
+        - ubuntu-18.04
+        env:
+        - TOXENV: docs
+        - TOXENV: lint
+        - TOXENV: lint-py2
+          PYTHON_VERSION: 2.7
+        - TOXENV: mypy
+        - TOXENV: packaging
+    steps:
+    - uses: actions/checkout@master
+    - name: Set up Python ${{ matrix.env.PYTHON_VERSION || 3.7 }}
+      uses: actions/setup-python@v1
+      with:
+        version: ${{ matrix.env.PYTHON_VERSION || 3.7 }}
+    - name: Pre-configure global Git settings
+      run: >-
+        tools/travis/setup.sh
+    - name: Update setuptools and tox dependencies
+      run: >-
+        tools/travis/install.sh
+    - name: 'Initialize tox envs: ${{ matrix.env.TOXENV }}'
+      run: >-
+        python -m tox --notest --skip-missing-interpreters false
+      env: ${{ matrix.env }}
+    - name: Test with tox
+      run: >-
+        python -m tox
+      env: ${{ matrix.env }}

docs/html/development/index.rst

@@ -14,6 +14,7 @@ or the `pypa-dev mailing list`_, to ask questions or get involved.
 
     getting-started
     contributing
+    issue-triage
     architecture/index
     release-process
     vendoring-policy

docs/html/development/issue-triage.rst

@@ -0,0 +1,25 @@
+.. note::
+    This section of the documentation is currently being written. pip
+    developers welcome your help to complete this documentation. If you're
+    interested in helping out, please let us know in the
+    `tracking issue <https://github.com/pypa/pip/issues/6583>`__.
+
+============
+Issue Triage
+============
+
+This serves as an introduction to issue tracking in pip as well as
+how to help triage reported issues.
+
+
+Issue Tracker
+*************
+
+The `pip issue tracker <https://github.com/pypa/pip/issues>`__ is hosted on
+GitHub alongside the project.
+
+Currently, the issue tracker is used for bugs, feature requests, and general
+user support.
+
+In the pip issue tracker, we make use of labels and milestones to organize and
+track work.

docs/html/reference/pip_install.rst

@@ -244,8 +244,7 @@ pip supports installing from a package index using a :term:`requirement
 specifier <pypug:Requirement Specifier>`. Generally speaking, a requirement
 specifier is composed of a project name followed by optional :term:`version
 specifiers <pypug:Version Specifier>`.  :pep:`508` contains a full specification
-of the format of a requirement (pip does not support the ``url_req`` form
-of specifier at this time).
+of the format of a requirement.
 
 Some examples:
 
@@ -265,6 +264,13 @@ Since version 6.0, pip also supports specifiers containing `environment markers
   SomeProject ==5.4 ; python_version < '2.7'
   SomeProject; sys_platform == 'win32'
 
+Since version 19.1, pip also supports `direct references
+<https://www.python.org/dev/peps/pep-0440/#direct-references>`__ like so:
+
+ ::
+
+  SomeProject @ file:///somewhere/...
+
 Environment markers are supported in the command line and in requirements files.
 
 .. note::
@@ -880,6 +886,14 @@ Examples
       $ pip install http://my.package.repo/SomePackage-1.0.4.zip
 
 
+#. Install a particular source archive file following :pep:`440` direct references.
+
+    ::
+
+      $ pip install SomeProject==1.0.4@http://my.package.repo//SomeProject-1.2.3-py33-none-any.whl
+      $ pip install "SomeProject==1.0.4 @ http://my.package.repo//SomeProject-1.2.3-py33-none-any.whl"
+
+
 #. Install from alternative package repositories.
 
    Install from a different index, and not `PyPI`_ ::

news/4910.bugfix

@@ -0,0 +1 @@
+Fix ``rmtree_errorhandler`` to skip non-existing directories.

news/6202.bugfix

@@ -0,0 +1,2 @@
+Fix requirement line parser to correctly handle PEP 440 requirements with a URL
+pointing to an archive file.

news/6892.bugfix

@@ -0,0 +1,2 @@
+Correctly uninstall symlinks that were installed in a virtualenv,
+by tools such as ``flit install --symlink``.

news/6952-gh-actions--linters.trivial

@@ -0,0 +1 @@
+Add a GitHub Actions workflow running all linters.

news/6954.bugfix

@@ -0,0 +1 @@
+Don't use hardlinks for locking selfcheck state file.

news/6991.bugfix

@@ -0,0 +1 @@
+ Ignore "require_virtualenv" in `pip config`