Update wording and formatting (#1302)

This commit is contained in:
Hugo van Kemenade 2020-03-09 17:32:27 +02:00 committed by GitHub
parent 9a50ba261c
commit 3ac97a3084
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 22 additions and 15 deletions

View File

@ -1,7 +1,7 @@
# Gallery # Gallery
Gallery is a script that automates process of applying different black versions to a Gallery is a script that automates the process of applying different _Black_ versions to
selected PyPI package and seeing the results between black versions. a selected PyPI package and seeing the results between _Black_ versions.
## Build ## Build
@ -16,9 +16,11 @@ $ sudo docker run -it -v /host/output:/output -v /host/input:/input black_galler
``` ```
``` ```
usage: gallery.py [-h] -p PYPI_PACKAGE -b BLACK_REPO [-v VERSION] [-i INPUT] [-o OUTPUT] [versions ...] usage: gallery.py [-h] (-p PYPI_PACKAGE | -t TOP_PACKAGES) [-b BLACK_REPO] [-v VERSION] [-w WORKERS] [-i INPUT] [-o OUTPUT]
[versions [versions ...]]
Black Gallery is a script that automates process of applying different black versions to a selected PyPI package and seeing the results between versions. Black Gallery is a script that automates the process of applying different Black versions to a selected PyPI package and
seeing the results between versions.
positional arguments: positional arguments:
versions versions
@ -27,12 +29,17 @@ optional arguments:
-h, --help show this help message and exit -h, --help show this help message and exit
-p PYPI_PACKAGE, --pypi-package PYPI_PACKAGE -p PYPI_PACKAGE, --pypi-package PYPI_PACKAGE
PyPI package to download. PyPI package to download.
-t TOP_PACKAGES, --top-packages TOP_PACKAGES
Top n PyPI packages to download.
-b BLACK_REPO, --black-repo BLACK_REPO -b BLACK_REPO, --black-repo BLACK_REPO
Black's git repository. Black's Git repository.
-v VERSION, --version VERSION -v VERSION, --version VERSION
Version for PyPI given pypi package. Version for given PyPI package. Will be discarded if used with -t option.
-w WORKERS, --workers WORKERS
Maximum number of threads to download with at the same time. Will be discarded if used with -p
option.
-i INPUT, --input INPUT -i INPUT, --input INPUT
Input directory to read configurations. Input directory to read configuration.
-o OUTPUT, --output OUTPUT -o OUTPUT, --output OUTPUT
Output directory to download and put result artifacts. Output directory to download and put result artifacts.
``` ```

View File

@ -51,7 +51,7 @@ def get_pypi_download_url(package: str, version: Optional[str]) -> str:
sources = metadata["releases"][version] sources = metadata["releases"][version]
else: else:
raise ValueError( raise ValueError(
f"No releases found with given version ('{version}') tag. " f"No releases found with version ('{version}') tag. "
f"Found releases: {metadata['releases'].keys()}" f"Found releases: {metadata['releases'].keys()}"
) )
@ -253,22 +253,22 @@ def format_repos(repos: Tuple[Path, ...], options: Namespace) -> None:
def main() -> None: def main() -> None:
parser = ArgumentParser( parser = ArgumentParser(
description="""Black Gallery is a script that description="""Black Gallery is a script that
automates process of applying different black versions to a selected automates the process of applying different Black versions to a selected
PyPI package and seeing the results between versions.""" PyPI package and seeing the results between versions."""
) )
group = parser.add_mutually_exclusive_group(required=True) group = parser.add_mutually_exclusive_group(required=True)
group.add_argument("-p", "--pypi-package", help="PyPI package to download.") group.add_argument("-p", "--pypi-package", help="PyPI package to download.")
group.add_argument( group.add_argument(
"-t", "--top-packages", help="Top n PyPI package to download.", type=int "-t", "--top-packages", help="Top n PyPI packages to download.", type=int
) )
parser.add_argument("-b", "--black-repo", help="Black's git repository.", type=Path) parser.add_argument("-b", "--black-repo", help="Black's Git repository.", type=Path)
parser.add_argument( parser.add_argument(
"-v", "-v",
"--version", "--version",
help=( help=(
"Version for PyPI given pypi package. " "Version for given PyPI package. "
"Will be discarded if used with -t option." "Will be discarded if used with -t option."
), ),
) )
@ -276,8 +276,8 @@ def main() -> None:
"-w", "-w",
"--workers", "--workers",
help=( help=(
"Maximum amount of threads to download at the sametime. " "Maximum number of threads to download with at the same time. "
"Will be discard if used with -p option." "Will be discarded if used with -p option."
), ),
) )
parser.add_argument( parser.add_argument(
@ -285,7 +285,7 @@ def main() -> None:
"--input", "--input",
default=Path("/input"), default=Path("/input"),
type=Path, type=Path,
help="Input directory to read configurations.", help="Input directory to read configuration.",
) )
parser.add_argument( parser.add_argument(
"-o", "-o",