Metadata-Version: 2.1
Name: black-configparser
Version: 0.1.0b2
Summary: Seamless Proxy CLI for black ("The uncompromising code formatter") with support for non-pyproject.toml config files
Home-page: https://github.com/danie1k/python-black-configparser
Author: Daniel Kuruc
Author-email: daniel@kuruc.dev
License: MIT
Project-URL: Code, https://github.com/danie1k/python-black-configparser
Project-URL: Issue tracker, https://github.com/danie1k/python-black-configparser/issues
Description: [![Build Status](https://travis-ci.org/danie1k/python-black-configparser.svg?branch=master)](https://travis-ci.org/danie1k/python-black-configparser)
        [![Code Coverage](https://codecov.io/gh/danie1k/python-black-configparser/branch/master/graph/badge.svg?token=A496BD37Qj)](https://codecov.io/gh/danie1k/python-black-configparser)
        [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/black-configparser)](https://pypi.org/project/black-configparser/)
        [![PyPI](https://img.shields.io/pypi/v/black-configparser)](https://pypi.org/project/black-configparser/)
        [![MIT License](https://img.shields.io/github/license/danie1k/python-black-configparser)](https://github.com/danie1k/python-black-configparser/blob/master/LICENSE)
        
        # black-configparser
        
        Seamless proxy CLI for [black](https://pypi.org/project/black/) *("The uncompromising code formatter")*
        with support for non-`pyproject.toml` config files.
        
        
        ## Table of Contents
        
        1. [About the Project](#about-the-project)
            - [Why it is different?](#why-it-is-different)
        1. [Installation](#installation)
        1. [Usage](#usage)
            - [Example configuration](#)
        1. [Known issues](#known-issues)
        1. [License](#license)
        
        
        ## About the Project
        
        The `black-configparser` ia yet another tool (next to [brunette](https://pypi.org/project/brunette/),
        [white](https://pypi.org/project/white/), and maybe a few more out there),
        which tries to fill [the gap of missing `setup.cfg`](https://github.com/psf/black/issues/688)
        (or just [any other non-`pyproject.toml`](https://github.com/psf/black/issues/683)) config file.
        
        
        ### Why it is different?
        
        Unlike other tools, tries to stay **dumb simple** and add only minimum needed overhead to `black` usage.
        
        1. It is **seamless** - it works on the same CLI command - `black` - just passing logic through some extra code!
        1. There is no complex argument processing, if config file is present, the values set there are passed directly to `black`.
        1. Code of this tool is independent from `black` insides and will work properly
           as long as `black` won't make any braking changes in its command line options.
        
        
        ## Installation
        
        ```
        pip install black-configparser
        ```
        
        
        ## Usage
        
        - Supported configuration files: `setup.cfg`, `tox.ini`.
        - Configuration file section: `[black]` or `[tools:black]`.
        
        **Important!** :warning:  
        > When you `black-configparser` finds black configuration in file, most command line arguments won't be available anymore,
        > except: `--check`, `--code`, `--diff`, `--help`, `--verbose` & `--version`.
        
        ### Example configuration
        
        ```ini
        [black]
        line-length = 120
        target-version =
          py27
          py33
          py34
          py35
          py36
          py37
          py38
        pyi = True
        skip-string-normalization = True
        color = True
        include = \.pyi?$
        exclude = /(\.direnv|\.eggs|\.git|\.hg|\.mypy_cache|\.nox|\.tox|\.venv|\.svn|_build|buck-out|build|dist)/]
        force-exclude = lorem ipsum
        quiet = True
        verbose = True
        ```
        
        - Almost any option available for black (`black --help`) can be put onto config file.
        - Values for multi-value arguments must be one per line (separated by `\n` char).
        - Flags *(arguments without values)* must be set in config file as `= True`.
        
        
        ## Known issues
        
        - Undefined behavior, when one of allowed CLI arguments will be also put inside config file.
        - After `black-configparser` package is uninstalled, the `black` command does not work anymore
            and [black](https://pypi.org/project/black/) package must be reinstalled.
        
        
        ## License
        
        MIT
        
Keywords: automation formatter yapf autopep8 pyfmt gofmt rustfmt black white brunette
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Provides-Extra: tests
