kiara-plugin.language-processing


Namekiara-plugin.language-processing JSON
Version 0.5.0 PyPI version JSON
download
home_page
SummaryLanguage-processing kiara modules and data types.
upload_time2023-11-14 10:38:22
maintainer
docs_urlNone
author
requires_python>=3.8
licenseMPL-2.0
keywords kiara
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            [![PyPI status](https://img.shields.io/pypi/status/kiara_plugin.language_processing.svg)](https://pypi.python.org/pypi/kiara_plugin.language_processing/)
[![PyPI version](https://img.shields.io/pypi/v/kiara_plugin.language_processing.svg)](https://pypi.python.org/pypi/kiara_plugin.language_processing/)
[![PyPI pyversions](https://img.shields.io/pypi/pyversions/kiara_plugin.language_processing.svg)](https://pypi.python.org/pypi/kiara_plugin.language_processing/)
[![Build Status](https://img.shields.io/endpoint.svg?url=https%3A%2F%2Factions-badge.atrox.dev%2FDHARPA-Project%2Fkiara%2Fbadge%3Fref%3Ddevelop&style=flat)](https://actions-badge.atrox.dev/DHARPA-Project/kiara_plugin.language_processing/goto?ref=develop)
[![Coverage Status](https://coveralls.io/repos/github/DHARPA-Project/kiara_plugin.language_processing/badge.svg?branch=develop)](https://coveralls.io/github/DHARPA-Project/kiara_plugin.language_processing?branch=develop)
[![Code style](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/ambv/black)

# [**kiara**](https://dharpa.org/kiara.documentation) plugin: (language_processing)

Language-processing kiara modules and data types.

 - Documentation: [https://DHARPA-Project.github.io/kiara_plugin.language_processing](https://DHARPA-Project.github.io/kiara_plugin.language_processing)
 - Code: [https://github.com/DHARPA-Project/kiara_plugin.language_processing](https://github.com/DHARPA-Project/kiara_plugin.language_processing)
 - `kiara`: [https://dharpa.org/kiara.documentation](https://dharpa.org/kiara.documentation)

## Description

TODO

## Development

### Requirements

- Python (version >= 3.8)
- pip, virtualenv
- git
- make (on Linux / Mac OS X -- optional)


### Prepare development environment

If you only want to work on the modules, and not the core *Kiara* codebase, follow the instructions below. Otherwise, please
check the notes on how to setup a *Kiara* development environment under (TODO).

#### Linux & Mac OS X (using make)

For *NIX-like operating system, setting up a development environment is relatively easy:

```console
git clone https://github.com/DHARPA-Project/kiara_plugin.language_processing.git
cd kiara_plugin.language_processing
python3 -m venv .venv
source .venv/bin/activate
make init
```

#### Windows (or manual pip install)

It's impossible to lay out all the ways Python can be installed on a machine, and virtual- (or conda-)envs can be created, so I'll assume you know how to do this.
One simple way is to install the [Anaconda (individual edition)](https://docs.anaconda.com/anaconda/install/index.html), then use the Anaconda navigator to create a new environment, install the 'git' package in it (if your system does not already have it), and use the 'Open Terminal' option of that environment to start up a terminal that has that virtual-/conda-environment activated.

Once that is done, `cd` into a directory where you want this project folder to live, and do:

```console
# make sure your virtual env is activated!!!
git clone https://github.com/DHARPA-Project/kiara_plugin.language_processing.git
cd kiara_plugin.language_processing
pip install --extra-index-url https://pypi.fury.io/dharpa/ -U -e .[all_dev]
```

#### Try it out

After this is done, you should be able to run the included example module via:

```console
kiara run language_processing_example text_1="xxx" text_2="yyy"
...
...
```

### Re-activate the development environment

The 'prepare' step from above only has to be done once. After that, to re-enable your virtual environment,
you'll need to navigate to the directory again (wherever that is, in your case), and run the ``source`` command from before again:

```console
cd path/to/kiara_plugin.language_processing
source .venv/bin/activate  # if it isn't activated already, for example by the Anaconda navigator
kiara --help  # or whatever, point is, kiara should be available for you now,
```

### ``make`` targets (Linux & Mac OS X)

- ``init``: init development project (install project & dev dependencies into virtualenv, as well as pre-commit git hook)
- ``update-dependencies``: update development dependencies (mainly the core ``kiara`` package from git)
- ``flake``: run *flake8* tests
- ``mypy``: run mypy tests
- ``test``: run unit tests
- ``docs``: create static documentation pages (under ``build/site``)
- ``serve-docs``: serve documentation pages (incl. auto-reload) for getting direct feedback when working on documentation
- ``clean``: clean build directories

For details (and other, minor targets), check the ``Makefile``.


### Running tests

``` console
> make test
# or
> make coverage
```


## Copyright & license

This project is MPL v2.0 licensed, for the license text please check the [LICENSE](/LICENSE) file in this repository.

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "kiara-plugin.language-processing",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": "",
    "keywords": "kiara",
    "author": "",
    "author_email": "Markus Binsteiner <markus@frkl.io>",
    "download_url": "https://files.pythonhosted.org/packages/0e/c2/9419bd0033168733b03b4d575c4bd3fd9172e9be3a6f7fad51f7f21093e8/kiara_plugin.language_processing-0.5.0.tar.gz",
    "platform": null,
    "description": "[![PyPI status](https://img.shields.io/pypi/status/kiara_plugin.language_processing.svg)](https://pypi.python.org/pypi/kiara_plugin.language_processing/)\n[![PyPI version](https://img.shields.io/pypi/v/kiara_plugin.language_processing.svg)](https://pypi.python.org/pypi/kiara_plugin.language_processing/)\n[![PyPI pyversions](https://img.shields.io/pypi/pyversions/kiara_plugin.language_processing.svg)](https://pypi.python.org/pypi/kiara_plugin.language_processing/)\n[![Build Status](https://img.shields.io/endpoint.svg?url=https%3A%2F%2Factions-badge.atrox.dev%2FDHARPA-Project%2Fkiara%2Fbadge%3Fref%3Ddevelop&style=flat)](https://actions-badge.atrox.dev/DHARPA-Project/kiara_plugin.language_processing/goto?ref=develop)\n[![Coverage Status](https://coveralls.io/repos/github/DHARPA-Project/kiara_plugin.language_processing/badge.svg?branch=develop)](https://coveralls.io/github/DHARPA-Project/kiara_plugin.language_processing?branch=develop)\n[![Code style](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/ambv/black)\n\n# [**kiara**](https://dharpa.org/kiara.documentation) plugin: (language_processing)\n\nLanguage-processing kiara modules and data types.\n\n - Documentation: [https://DHARPA-Project.github.io/kiara_plugin.language_processing](https://DHARPA-Project.github.io/kiara_plugin.language_processing)\n - Code: [https://github.com/DHARPA-Project/kiara_plugin.language_processing](https://github.com/DHARPA-Project/kiara_plugin.language_processing)\n - `kiara`: [https://dharpa.org/kiara.documentation](https://dharpa.org/kiara.documentation)\n\n## Description\n\nTODO\n\n## Development\n\n### Requirements\n\n- Python (version >= 3.8)\n- pip, virtualenv\n- git\n- make (on Linux / Mac OS X -- optional)\n\n\n### Prepare development environment\n\nIf you only want to work on the modules, and not the core *Kiara* codebase, follow the instructions below. Otherwise, please\ncheck the notes on how to setup a *Kiara* development environment under (TODO).\n\n#### Linux & Mac OS X (using make)\n\nFor *NIX-like operating system, setting up a development environment is relatively easy:\n\n```console\ngit clone https://github.com/DHARPA-Project/kiara_plugin.language_processing.git\ncd kiara_plugin.language_processing\npython3 -m venv .venv\nsource .venv/bin/activate\nmake init\n```\n\n#### Windows (or manual pip install)\n\nIt's impossible to lay out all the ways Python can be installed on a machine, and virtual- (or conda-)envs can be created, so I'll assume you know how to do this.\nOne simple way is to install the [Anaconda (individual edition)](https://docs.anaconda.com/anaconda/install/index.html), then use the Anaconda navigator to create a new environment, install the 'git' package in it (if your system does not already have it), and use the 'Open Terminal' option of that environment to start up a terminal that has that virtual-/conda-environment activated.\n\nOnce that is done, `cd` into a directory where you want this project folder to live, and do:\n\n```console\n# make sure your virtual env is activated!!!\ngit clone https://github.com/DHARPA-Project/kiara_plugin.language_processing.git\ncd kiara_plugin.language_processing\npip install --extra-index-url https://pypi.fury.io/dharpa/ -U -e .[all_dev]\n```\n\n#### Try it out\n\nAfter this is done, you should be able to run the included example module via:\n\n```console\nkiara run language_processing_example text_1=\"xxx\" text_2=\"yyy\"\n...\n...\n```\n\n### Re-activate the development environment\n\nThe 'prepare' step from above only has to be done once. After that, to re-enable your virtual environment,\nyou'll need to navigate to the directory again (wherever that is, in your case), and run the ``source`` command from before again:\n\n```console\ncd path/to/kiara_plugin.language_processing\nsource .venv/bin/activate  # if it isn't activated already, for example by the Anaconda navigator\nkiara --help  # or whatever, point is, kiara should be available for you now,\n```\n\n### ``make`` targets (Linux & Mac OS X)\n\n- ``init``: init development project (install project & dev dependencies into virtualenv, as well as pre-commit git hook)\n- ``update-dependencies``: update development dependencies (mainly the core ``kiara`` package from git)\n- ``flake``: run *flake8* tests\n- ``mypy``: run mypy tests\n- ``test``: run unit tests\n- ``docs``: create static documentation pages (under ``build/site``)\n- ``serve-docs``: serve documentation pages (incl. auto-reload) for getting direct feedback when working on documentation\n- ``clean``: clean build directories\n\nFor details (and other, minor targets), check the ``Makefile``.\n\n\n### Running tests\n\n``` console\n> make test\n# or\n> make coverage\n```\n\n\n## Copyright & license\n\nThis project is MPL v2.0 licensed, for the license text please check the [LICENSE](/LICENSE) file in this repository.\n",
    "bugtrack_url": null,
    "license": "MPL-2.0",
    "summary": "Language-processing kiara modules and data types.",
    "version": "0.5.0",
    "project_urls": {
        "documentation": "https://DHARPA-Project.github.io/kiara_plugin.language_processing",
        "homepage": "https://github.com/DHARPA-Project/kiara_plugin.language_processing",
        "repository": "https://github.com/DHARPA-Project/kiara_plugin.language_processing"
    },
    "split_keywords": [
        "kiara"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "2266b543c984120ba76db081dccfa38580b7fe3750c41efdc3d7f63715d05b0b",
                "md5": "2897bab3e5a9fdcb77d8ba21a8973000",
                "sha256": "583a74519e9cd43a6c35ac3827331af39f7a12b359e23313841836c09878e1f7"
            },
            "downloads": -1,
            "filename": "kiara_plugin.language_processing-0.5.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "2897bab3e5a9fdcb77d8ba21a8973000",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 21494,
            "upload_time": "2023-11-14T10:38:21",
            "upload_time_iso_8601": "2023-11-14T10:38:21.300009Z",
            "url": "https://files.pythonhosted.org/packages/22/66/b543c984120ba76db081dccfa38580b7fe3750c41efdc3d7f63715d05b0b/kiara_plugin.language_processing-0.5.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "0ec29419bd0033168733b03b4d575c4bd3fd9172e9be3a6f7fad51f7f21093e8",
                "md5": "600a1793e9480a00e7b42e245104e369",
                "sha256": "3a73d643cd9d26c421810d71cac7f587b48c83df6c79b36748d4fafcf77b5f2a"
            },
            "downloads": -1,
            "filename": "kiara_plugin.language_processing-0.5.0.tar.gz",
            "has_sig": false,
            "md5_digest": "600a1793e9480a00e7b42e245104e369",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 101240,
            "upload_time": "2023-11-14T10:38:22",
            "upload_time_iso_8601": "2023-11-14T10:38:22.715116Z",
            "url": "https://files.pythonhosted.org/packages/0e/c2/9419bd0033168733b03b4d575c4bd3fd9172e9be3a6f7fad51f7f21093e8/kiara_plugin.language_processing-0.5.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-11-14 10:38:22",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "DHARPA-Project",
    "github_project": "kiara_plugin.language_processing",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "kiara-plugin.language-processing"
}
        
Elapsed time: 0.14777s