Metadata-Version: 2.1
Name: future_fstrings
Version: 1.2.0
Summary: A backport of fstrings to python<3.6
Home-page: https://github.com/asottile/future-fstrings
Author: Anthony Sottile
Author-email: asottile@umich.edu
License: MIT
Description: [![Build Status](https://asottile.visualstudio.com/asottile/_apis/build/status/asottile.future-fstrings?branchName=master)](https://asottile.visualstudio.com/asottile/_build/latest?definitionId=15&branchName=master)
        [![Azure DevOps coverage](https://img.shields.io/azure-devops/coverage/asottile/asottile/15/master.svg)](https://dev.azure.com/asottile/asottile/_build/latest?definitionId=15&branchName=master)
        
        future-fstrings
        ===============
        
        A backport of fstrings to python<3.6.
        
        
        ## Installation
        
        `pip install future-fstrings`
        
        
        ## Usage
        
        Include the following encoding cookie at the top of your file (this replaces
        the utf-8 cookie if you already have it):
        
        ```python
        # -*- coding: future_fstrings -*-
        ```
        
        And then write python3.6 fstring code as usual!
        
        ```python
        # -*- coding: future_fstrings -*-
        thing = 'world'
        print(f'hello {thing}')
        ```
        
        ```console
        $ python2.7 main.py
        hello world
        ```
        
        ## Showing transformed source
        
        `future-fstrings` also includes a cli to show transformed source.
        
        ```console
        $ future-fstrings-show main.py
        # -*- coding: future_fstrings -*-
        thing = 'world'
        print('hello {}'.format((thing)))
        ```
        
        ## Transform source for micropython
        
        The `future-fstrings-show` command can be used to transform source before
        distributing.  This can allow you to write f-string code but target platforms
        which do not support f-strings, such as [micropython].
        
        To use this on modern versions of python, install using:
        
        ```bash
        pip install future-fstrings[rewrite]
        ```
        
        and then use `future-fstrings-show` as above.
        
        For instance:
        
        ```bash
        future-fstrings-show code.py > code_rewritten.py
        ```
        
        [micropython]: https://github.com/micropython/micropython
        
        ## How does this work?
        
        `future-fstrings` has two parts:
        
        1. A utf-8 compatible `codec` which performs source manipulation
            - The `codec` first decodes the source bytes using the UTF-8 codec
            - The `codec` then leverages
              [tokenize-rt](https://github.com/asottile/tokenize-rt) to rewrite
              f-strings.
        2. A `.pth` file which registers a codec on interpreter startup.
        
        ## you may also like
        
        - [future-breakpoint](https://github.com/asottile/future-breakpoint)
        
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*
Description-Content-Type: text/markdown
Provides-Extra: rewrite
