EditorConfig


NameEditorConfig JSON
Version 0.17.0 PyPI version JSON
download
home_pageNone
SummaryEditorConfig File Locator and Interpreter for Python
upload_time2024-12-12 21:04:21
maintainerNone
docs_urlNone
authorEditorConfig Team
requires_pythonNone
licensePSF-2.0
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI
coveralls test coverage No coveralls.
            ========================
EditorConfig Python Core
========================
.. image:: https://img.shields.io/pypi/v/EditorConfig.svg
    :target: https://pypi.python.org/pypi/EditorConfig

.. image:: https://img.shields.io/pypi/wheel/EditorConfig.svg
    :target: https://pypi.python.org/pypi/EditorConfig

.. image:: https://img.shields.io/pypi/pyversions/EditorConfig.svg
    :target: https://pypi.python.org/pypi/EditorConfig

.. image:: https://secure.travis-ci.org/editorconfig/editorconfig-core-py.svg?branch=master
   :target: http://travis-ci.org/editorconfig/editorconfig-core-py

EditorConfig Python Core provides the same functionality as the
`EditorConfig C Core <https://github.com/editorconfig/editorconfig-core>`_.
EditorConfig Python core can be used as a command line program or as an
importable library.

EditorConfig Project
====================

EditorConfig makes it easy to maintain the correct coding style when switching
between different text editors and between different projects.  The
EditorConfig project maintains a file format and plugins for various text
editors which allow this file format to be read and used by those editors.  For
information on the file format and supported text editors, see the
`EditorConfig website <http://editorconfig.org>`_.

Installation
============

With setuptools::

    sudo python setup.py install

Getting Help
============
For help with the EditorConfig core code, please write to our `mailing list
<http://groups.google.com/group/editorconfig>`_.  Bugs and feature requests
should be submitted to our `issue tracker
<https://github.com/editorconfig/editorconfig/issues>`_.

If you are writing a plugin a language that can import Python libraries, you
may want to import and use the EditorConfig Python Core directly.

Using as a Library
==================

Basic example use of EditorConfig Python Core as a library:

.. code-block:: python

    from editorconfig import get_properties, EditorConfigError

    filename = "/home/zoidberg/humans/anatomy.md"

    try:
        options = get_properties(filename)
    except EditorConfigError:
        print("Error occurred while getting EditorConfig properties")
    else:
        for key, value in options.items():
            print(f"{key}={value}")

For details, please take a look at the `online documentation
<http://pydocs.editorconfig.org>`_.

Running Test Cases
==================

`Cmake <http://www.cmake.org>`_ has to be installed first. Run the test cases
using the following commands::

    export PYTHONPATH=$(pwd)
    cmake .
    ctest .

Use ``-DPYTHON_EXECUTABLE`` to run the tests using an alternative versions of
Python (e.g. Python 3.12)::

    cmake -DPYTHON_EXECUTABLE=/usr/bin/python3.12 .
    ctest .

License
=======

See COPYING file for licensing details.

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "EditorConfig",
    "maintainer": null,
    "docs_url": null,
    "requires_python": null,
    "maintainer_email": null,
    "keywords": null,
    "author": "EditorConfig Team",
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/b4/29/785595a0d8b30ab8d2486559cfba1d46487b8dcbd99f74960b6b4cca92a4/editorconfig-0.17.0.tar.gz",
    "platform": null,
    "description": "========================\nEditorConfig Python Core\n========================\n.. image:: https://img.shields.io/pypi/v/EditorConfig.svg\n    :target: https://pypi.python.org/pypi/EditorConfig\n\n.. image:: https://img.shields.io/pypi/wheel/EditorConfig.svg\n    :target: https://pypi.python.org/pypi/EditorConfig\n\n.. image:: https://img.shields.io/pypi/pyversions/EditorConfig.svg\n    :target: https://pypi.python.org/pypi/EditorConfig\n\n.. image:: https://secure.travis-ci.org/editorconfig/editorconfig-core-py.svg?branch=master\n   :target: http://travis-ci.org/editorconfig/editorconfig-core-py\n\nEditorConfig Python Core provides the same functionality as the\n`EditorConfig C Core <https://github.com/editorconfig/editorconfig-core>`_.\nEditorConfig Python core can be used as a command line program or as an\nimportable library.\n\nEditorConfig Project\n====================\n\nEditorConfig makes it easy to maintain the correct coding style when switching\nbetween different text editors and between different projects.  The\nEditorConfig project maintains a file format and plugins for various text\neditors which allow this file format to be read and used by those editors.  For\ninformation on the file format and supported text editors, see the\n`EditorConfig website <http://editorconfig.org>`_.\n\nInstallation\n============\n\nWith setuptools::\n\n    sudo python setup.py install\n\nGetting Help\n============\nFor help with the EditorConfig core code, please write to our `mailing list\n<http://groups.google.com/group/editorconfig>`_.  Bugs and feature requests\nshould be submitted to our `issue tracker\n<https://github.com/editorconfig/editorconfig/issues>`_.\n\nIf you are writing a plugin a language that can import Python libraries, you\nmay want to import and use the EditorConfig Python Core directly.\n\nUsing as a Library\n==================\n\nBasic example use of EditorConfig Python Core as a library:\n\n.. code-block:: python\n\n    from editorconfig import get_properties, EditorConfigError\n\n    filename = \"/home/zoidberg/humans/anatomy.md\"\n\n    try:\n        options = get_properties(filename)\n    except EditorConfigError:\n        print(\"Error occurred while getting EditorConfig properties\")\n    else:\n        for key, value in options.items():\n            print(f\"{key}={value}\")\n\nFor details, please take a look at the `online documentation\n<http://pydocs.editorconfig.org>`_.\n\nRunning Test Cases\n==================\n\n`Cmake <http://www.cmake.org>`_ has to be installed first. Run the test cases\nusing the following commands::\n\n    export PYTHONPATH=$(pwd)\n    cmake .\n    ctest .\n\nUse ``-DPYTHON_EXECUTABLE`` to run the tests using an alternative versions of\nPython (e.g. Python 3.12)::\n\n    cmake -DPYTHON_EXECUTABLE=/usr/bin/python3.12 .\n    ctest .\n\nLicense\n=======\n\nSee COPYING file for licensing details.\n",
    "bugtrack_url": null,
    "license": "PSF-2.0",
    "summary": "EditorConfig File Locator and Interpreter for Python",
    "version": "0.17.0",
    "project_urls": {
        "Bug Tracker": "https://github.com/editorconfig/editorconfig-core-py/issues",
        "Homepage": "https://editorconfig.org/",
        "Source Code": "https://github.com/editorconfig/editorconfig-core-py"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "afe58dba39ea24ca3de0e954e668107692f4dfc13a85300a531fa9a39e83fde4",
                "md5": "5886dba7f1a66ac29380d4f0e38c6938",
                "sha256": "fe491719c5f65959ec00b167d07740e7ffec9a3f362038c72b289330b9991dfc"
            },
            "downloads": -1,
            "filename": "EditorConfig-0.17.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "5886dba7f1a66ac29380d4f0e38c6938",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 16276,
            "upload_time": "2024-12-12T21:04:01",
            "upload_time_iso_8601": "2024-12-12T21:04:01.098809Z",
            "url": "https://files.pythonhosted.org/packages/af/e5/8dba39ea24ca3de0e954e668107692f4dfc13a85300a531fa9a39e83fde4/EditorConfig-0.17.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "b429785595a0d8b30ab8d2486559cfba1d46487b8dcbd99f74960b6b4cca92a4",
                "md5": "a542c0959ff28d10059d9866de88e2b1",
                "sha256": "8739052279699840065d3a9f5c125d7d5a98daeefe53b0e5274261d77cb49aa2"
            },
            "downloads": -1,
            "filename": "editorconfig-0.17.0.tar.gz",
            "has_sig": false,
            "md5_digest": "a542c0959ff28d10059d9866de88e2b1",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 13369,
            "upload_time": "2024-12-12T21:04:21",
            "upload_time_iso_8601": "2024-12-12T21:04:21.278553Z",
            "url": "https://files.pythonhosted.org/packages/b4/29/785595a0d8b30ab8d2486559cfba1d46487b8dcbd99f74960b6b4cca92a4/editorconfig-0.17.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-12-12 21:04:21",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "editorconfig",
    "github_project": "editorconfig-core-py",
    "travis_ci": true,
    "coveralls": false,
    "github_actions": true,
    "lcname": "editorconfig"
}
        
Elapsed time: 0.44825s