<commit_before>

Requirement Specifiers
=============================


1. Install `SomeRole` by `SomeOwner` and its dependencies from `Ansible Galaxy`_

  ::

  >> arm install SomeOwner.SomeRole            # latest version
  >> arm install SomeOwner.SomeRole==1.0.4     # specific version
  >> arm install SomeOwner.SomeRole,v1.0.4     # `ansible-galaxy` compatiblity
  >> arm install SomeOwner.SomeRole>=1.0.4     # minimum version

2. Install `SomePackage` by `SomeOwner` with an alias

  ::

  >> arm install SomeOwner.SomeRoleName#egg=SomeName
  
  ( works with all formats listed above in #1 )

3) Upgrade an already installed `SomePackage` to the latest from PyPI.

  ::

  >> pip install --upgrade owner.role_name



3. Install a list of requirements specified in a file.  See the :ref:`Requirements files <Requirements Files>`.

  ::<commit_msg>updated documentation<commit_after>

Requirement Specifiers
=============================


1. Install `SomeRole` by `SomeOwner` and its dependencies from `Ansible Galaxy`_

  ::

	SomeOwner.SomeRole            # latest version
  	SomeOwner.SomeRole==1.0.4     # specific version
	SomeOwner.SomeRole,v1.0.4     # `ansible-galaxy` compatiblity
	SomeOwner.SomeRole>=1.0.4     # minimum version

For example: `arm install SomeOwner.SomeRole,v1.0.4`

2. Install `SomeRole` by `SomeOwner` from a git repository.

Using pip-like specifiers

  ::

  >> git://git.myproject.org/SomeOwner/SomeRole
  >> git+https://git.myproject.org/SomeOwner/SomeRole
  >> git+ssh://git@git.myproject.org/SomeOwner/SomeRole
  >> git+git@git.myproject.org:SomeOwner/SomeRole

Or using git-like specifiers

  ::

  >> arm install git@git.myproject.org:SomeOwner/SomeRole.git

*Note*: any of the above specifiers can select a tag, branch or commit by using `@` plus the tag, branch or commit identifier.



3. Install `SomePackage` by `SomeOwner` from a mecurial repository.

  ::

  **coming soon**


3. Install a list of requirements specified in a file.  See the :ref:`Requirements files <Requirements Files>`.

  ::
{'fraction_non_alphanumeric': 0.1310513447432763, 'fraction_numerical': 0.014669926650366748, 'mean_word_length': 3.769230769230769, 'pattern_counts': {'":': 0, '<': 5, '<?xml version=': 0, '>': 29, 'https://': 1, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 3, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '633121', 'n_tokens_mistral': 650, 'n_tokens_neox': 619, 'n_words': 188}