Metadata-Version: 1.1
Name: pyLanguagetool
Version: 0.5.1
Summary: A python library and CLI for the LanguageTool JSON API
Home-page: https://github.com/Findus23/pylanguagetool
Author: Lukas Winkler
Author-email: l.winkler23@mailbox.org
License: MIT
Description-Content-Type: UNKNOWN
Description: pyLanguagetool
        ^^^^^^^^^^^^^^
        |travis| |license| |latestrelease| |pypi_versions|
        
        This is a python library and CLI for the LanguageTool_ `JSON API`_.
        
        Installation
        ------------
        pyLanguagetool can be installed with pip:
        
        .. code:: bash
        
            $ pip install pylanguagetool
        
        Basic Usage
        -----------
        .. code:: bash
        
            $ echo "This is a example" | pylanguagetool
        
            $ pylanguagetool textfile.txt
        
            $ pylanguagetool < textfile.txt
        
            $ pylanguagetool -c # get text from system clipboard
        
        This will return a list of detected errors and possible replacements.
        
        .. code::
        
            # Use "an" instead of 'a' if the following word starts with a vowel sound, e.g. 'an article', 'an hour'
            #   ✗ This is a example
            #             ^
            #   ✓ This is an example
        
        
        
        Configuration
        -------------
        All `Languagetool API`_ parameters can be set via commandline arguments,
        environment variables or a configuration file (~/.config/pyLanguagetool.conf)
        For more information about the configuration file syntax, read the `ConfigArgParse documentation`_
        
        Parameters
        ----------
        
        .. code::
        
            $ pylanguagetool --help
            usage: pylanguagetool [-h] [-v] [-a API_URL] [-l LANG] [-m MOTHER_TONGUE]
                                [-p PREFERRED_VARIANTS] [-e ENABLED_RULES]
                                [-d DISABLED_RULES]
                                [--enabled-categories ENABLED_CATEGORIES]
                                [--disabled-categories DISABLED_CATEGORIES]
                                [--enabled-only]
                                [input file]
        
            Args that start with '--' (eg. -v) can also be set in a config file
            (~/.config/pyLanguagetool.conf). Config file syntax allows: key=value,
            flag=true, stuff=[a,b,c] (for details, see syntax at https://goo.gl/R74nmi).
            If an arg is specified in more than one place, then commandline values
            override environment variables which override config file values which
            override defaults.
        
            positional arguments:
              input file            input file
        
            optional arguments:
              -h, --help            show this help message and exit
              -v, --verbose         [env var: VERBOSE]
              -a API_URL, --api-url API_URL
                                    [env var: API_URL]
              --no-color            don't color output [env var: NO_COLOR]
              -c, --clipboard       get text from system clipboard [env var: CLIPBOARD]
              -t {txt,html,md,rst,ipynb}, --input-type {txt,html,md,rst,ipynb}
                                    if not plaintext [env var: CLIPBOARD]
              -l LANG, --lang LANG  A language code like en or en-US, or auto to guess the
                                    language automatically (see preferredVariants below).
                                    For languages with variants (English, German,
                                    Portuguese) spell checking will only be activated when
                                    you specify the variant, e.g. en-GB instead of just
                                    en. [env var: TEXTLANG]
              -m MOTHER_TONGUE, --mother-tongue MOTHER_TONGUE
                                    A language code of the user's native language,
                                    enabling false friends checks for some language pairs.
                                    [env var: MOTHER__TONGUE]
              -p PREFERRED_VARIANTS, --preferred-variants PREFERRED_VARIANTS
                                    Comma-separated list of preferred language variants.
                                    The language detector used with language=auto can
                                    detect e.g. English, but it cannot decide whether
                                    British English or American English is used. Thus this
                                    parameter can be used to specify the preferred
                                    variants like en-GB and de-AT. Only available with
                                    language=auto. [env var: PREFERRED_VARIANTS]
              -e ENABLED_RULES, --enabled-rules ENABLED_RULES
                                    IDs of rules to be enabled, comma-separated [env var:
                                    ENABLED_RULES]
              -d DISABLED_RULES, --disabled-rules DISABLED_RULES
                                    IDs of rules to be disabled, comma-separated [env var:
                                    DISABLED_RULES]
              --enabled-categories ENABLED_CATEGORIES
                                    IDs of categories to be enabled, comma-separated [env
                                    var: ENABLED_CATEGORIES]
              --disabled-categories DISABLED_CATEGORIES
                                    IDs of categories to be disabled, comma-separated [env
                                    var: DISABLED_CATEGORIES]
              --enabled-only        enable only the rules and categories whose IDs are
                                    specified with --enabled-rules or --enabled-categories
        
        
        .. |license| image:: https://img.shields.io/badge/license-MIT-blue.svg
            :target: https://raw.githubusercontent.com/Findus23/pyLanguagetool/master/LICENSE
        .. |latestrelease| image:: https://img.shields.io/pypi/v/pyLanguagetool.svg
            :target: https://pypi.python.org/pypi/pyLanguagetool
            :alt: Latest Version
        .. |travis| image:: https://img.shields.io/travis/Findus23/pyLanguagetool.svg
            :target: https://travis-ci.org/Findus23/pyLanguagetool
        .. |pypi_versions| image:: https://img.shields.io/pypi/pyversions/pylanguagetool.svg
            :target: https://pypi.python.org/pypi/pyLanguagetool
        
        Privacy
        -------
        
        By default pyLangugagetool sends all text via HTTPS to the languagetool.org server (see their `privacy policy`_).
        You can also `setup your own server`_ and use it by changing --api-url.
        
        .. _LanguageTool: https://languagetool.org/
        
        .. _JSON API: https://languagetool.org/http-api/swagger-ui/#/default
        
        .. _Languagetool API: https://languagetool.org/http-api/swagger-ui/#/default
        
        .. _ConfigArgParse documentation: https://github.com/bw2/ConfigArgParse#config-file-syntax
        
        .. _privacy policy: https://languagetool.org/privacy/
        
        .. _setup your own server: http://wiki.languagetool.org/http-server
Keywords: languagetool spell grammar checker
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Environment :: Console
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Text Processing :: Linguistic
