Metadata-Version: 1.2
Name: fcomments
Version: 0.1.1
Summary: Script for commenting in/out lines in file.
Home-page: https://github.com/tadeoos/fcomments
License: UNKNOWN
Keywords: comments file
Author: Tadek Teleżyński
Author-email: tadekte@gmail.com
Maintainer: tadeoos
Maintainer-email: tadekte@gmail.com
Requires-Python: >=3
Classifier: Programming Language :: Python :: 3.6
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Software Development :: Libraries :: Python Modules

fcomments
=========

*manage comments from your command line*

installation
------------

fcomments is on `pypi <https://pypi.org/project/fcomments/>`__

::

    $ pip install fcomments

usage
-----

Default behavior is to switch the line. It means that if a matched line
is commented, the comment will be removed, and if the line is not
commented the comment will be added.

Specifying -c flag ensures that matched lines will be commented out
after the command. The flag -u works analogically with respect to
uncommenting lines.

--help
~~~~~~

::

    Usage: fcomments [options] <path>

    Examples:
           fcomments -h                  --->  see help
           fcomments -cl1,2 path/to/file  --->  comment out lines 1 and 2
           fcomments -ul3-6 path/to/file  --->  uncomment lines 3 to 6 (inclusive)
           fcomments -ac path/to/file     --->  comment out all file

           fcomments --start-pattern='\s+operations\s?=\s?\[' --end-pattern='\s+\]' path/to/file
             --->  comment out everything inside the `operations` list:

             1| class Migration(...):
             2|
             3|     operations = [
             4| #       migrations(
             5| #           ...
             6| #       ),
             7|     ]


      Comment or uncomment lines in a file. Default behavior: do the oposite i.e.
    if a line is commented - uncomment it, and vice versa. To make sure that the
    matched lines will be [un]commented out - run with -[u]c option. If you don't
    specify an --output, the original file (<path>) will be overwritten.

    Options:
      -h, --help            show this help message and exit
      -c, --comment         comment lines [default: False]
      -u, --uncomment       uncomment lines [default: False]
      -a, --all             apply to all lines in file; suppresses -l option
                            [default: False]
      -l LINES, --lines=LINES
                            comma separeted string of line numbers [default: None]
      -s IN_PATTERN, --start-pattern=IN_PATTERN
                            pattern to match against the line before commented
                            section [default: None]
      -e OUT_PATTERN, --end-pattern=OUT_PATTERN
                            pattern to match against the first line after
                            commented section [default: None]
      -o OUTPUT, --output=OUTPUT
                            specify a path to output file [default: None]
      --symbol=COMMENT_SYMBOL
                            specify a string to use as comment [default: '#']

