Gecko [ betsfootball.net ]

Name	Size	Permission	Date
build-system	[ DIR ]	drwxr-xr-x	2025-04-08 16:44
index.md	278 B	-rw-r--r--	2023-02-17 18:31
inspect-report.md.gz	2.32 KB	-rw-r--r--	2023-02-17 18:31
installation-report.md.gz	2.57 KB	-rw-r--r--	2023-02-17 18:31
pip.rst	215 B	-rw-r--r--	2023-02-17 18:31
pip_cache.rst	227 B	-rw-r--r--	2023-02-17 18:31
pip_check.rst	227 B	-rw-r--r--	2023-02-17 18:31
pip_config.rst	229 B	-rw-r--r--	2023-02-17 18:31
pip_debug.rst	227 B	-rw-r--r--	2023-02-17 18:31
pip_download.rst	233 B	-rw-r--r--	2023-02-17 18:31
pip_freeze.rst	229 B	-rw-r--r--	2023-02-17 18:31
pip_hash.rst	225 B	-rw-r--r--	2023-02-17 18:31
pip_install.rst	231 B	-rw-r--r--	2023-02-17 18:31
pip_list.rst	225 B	-rw-r--r--	2023-02-17 18:31
pip_search.rst	229 B	-rw-r--r--	2023-02-17 18:31
pip_show.rst	225 B	-rw-r--r--	2023-02-17 18:31
pip_uninstall.rst	235 B	-rw-r--r--	2023-02-17 18:31
pip_wheel.rst	227 B	-rw-r--r--	2023-02-17 18:31
requirement-specifiers.md	1.89 KB	-rw-r--r--	2023-02-17 18:31
requirements-file-format.md.gz	2.57 KB	-rw-r--r--	2023-02-17 18:31

Rename

(Requirement Specifiers)=

# Requirement Specifiers

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.

```{versionadded} 6.0
Support for environment markers.
```

```{versionadded} 19.1
Support for the direct URL reference form.
```

## Overview

A requirement specifier comes in two forms:

- name-based, which is composed of:

- a package name (eg: `requests`)
  - optionally, a set of "extras" that serve to install optional dependencies (eg: `security`)
  - optionally, constraints to apply on the version of the package
  - optionally, environment markers

- URL-based, which is composed of:

- a package name (eg: `requests`)
  - optionally, a set of "extras" that serve to install optional dependencies (eg: `security`)
  - a URL for the package
  - optionally, environment markers

## Examples

A few example name-based requirement specifiers:

```
SomeProject
SomeProject == 1.3
SomeProject >= 1.2, < 2.0
SomeProject[foo, bar]
SomeProject ~= 1.4.2
SomeProject == 5.4 ; python_version < '3.8'
SomeProject ; sys_platform == 'win32'
requests [security] >= 2.8.1, == 2.8.* ; python_version < "2.7"
```

```{note}
Use quotes around specifiers in the shell when using `>`, `<`, or when using environment markers.

Do _not_ use quotes in requirement files. There is only one exception: pip v7.0 and v7.0.1 (from May 2015) required quotes around specifiers containing environment markers in requirement files.
```

A few example URL-based requirement specifiers:

```none
pip @ https://github.com/pypa/pip/archive/22.0.2.zip
requests [security] @ https://github.com/psf/requests/archive/refs/heads/main.zip ; python_version >= "3.11"
```