Metadata-Version: 2.1
Name: un_fstring
Version: 0.1.3
Summary: A tool to convert f-strings to .format() calls.
Home-page: UNKNOWN
Author: Josh Karpel
Author-email: josh.karpel@gmail.com
License: MIT
Description: # un-fstring
        
        [![PyPI version](https://badge.fury.io/py/un-fstring.svg)](https://badge.fury.io/py/un-fstring)
        
        Sometimes, unfortunately, you need to write code that is compatible with Python 3.5
        (e.g., to run on Ubuntu 16 or Debian 9, which will be supported
        until April 2021 and June 2022, respectively).
        Sometimes, even more unfortunately, you didn't know it needed to be when you
        wrote it, and you need to make it compatible post-facto.
        
        The biggest syntax change going from 3.5 to 3.6 was the addition of
        [f-strings](https://docs.python.org/3/whatsnew/3.6.html#pep-498-formatted-string-literals).
        [Many](https://github.com/asottile/pyupgrade)
        [packages](https://github.com/ikamensh/flynt)
        can convert old-style string formatting methods into f-strings.
        `un-fstring` does the opposite: it converts f-strings into `.format()` calls
        to preserve compatibility with Python 3.5.
        
        To convert your code, first install `un-fstring` (it itself requires Python 3.6 or later):
        ```console
        $ pip install un-fstring
        ```
        Then run it over your source code:
        ```console
        $ un-fstring path/to/source/directory another_file.py
        ```
        `un-fstring` will replace f-strings with `.format()` calls in-place.
        
        The `--dry-run` option will show a contextual diff
        of what `un-fstring` would do to your code without actually overwriting it.
        Run `un-fstring --help` to see what other options are available.
        
        `un-fstring` is available as a
        [`pre-commit`](https://github.com/pre-commit/pre-commit) hook:
        ```yaml
        - repo: https://github.com/JoshKarpel/un-fstring
          rev: v0.1.2
          hooks:
            - id: un-fstring
        ```
        
        `un-fstring` is not a code formatter;
        I recommend running
        [`black`](https://github.com/psf/black)
        over your code afterwards with the `--target-version py35` option enabled.
        
        > Though potentially useful, this is mostly a toy project based on some problems
        > I ran into at work.
        > If you're looking for a more robust implementation, check out
        > [f2format](https://github.com/pybpc/f2format).
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Provides-Extra: tests
