| Name | kiara-plugin.tabular JSON | 
            
| Version | 
                  0.5.6
                   
                  JSON | 
            
 | download  | 
            
| home_page | None  | 
            
| Summary | kiara data-types and modules for working with tables and databases. | 
            | upload_time | 2024-12-18 13:56:47 | 
            | maintainer | None | 
            
            | docs_url | None | 
            | author | None | 
            
            | requires_python | >=3.9 | 
            
            
            | license | MPL-2.0 | 
            | keywords | 
                
                    kiara
                 | 
            | VCS | 
                
                     | 
                
            
            | bugtrack_url | 
                
                 | 
             
            
            | requirements | 
                
                  No requirements were recorded.
                
             | 
            
| Travis-CI | 
                
                   No Travis.
                
             | 
            | coveralls test coverage | 
                
                   No coveralls.
                
             | 
        
        
            
            [](https://pypi.python.org/pypi/kiara_plugin.tabular/)
[](https://pypi.python.org/pypi/kiara_plugin.tabular/)
[](https://pypi.python.org/pypi/kiara_plugin.tabular/)
[](https://actions-badge.atrox.dev/DHARPA-Project/kiara_plugin.tabular/goto?ref=develop)
[](https://coveralls.io/github/DHARPA-Project/kiara_plugin.tabular?branch=develop)
[](https://github.com/ambv/black)
# [**kiara**](https://dharpa.org/kiara.documentation) plugin: (tabular)
kiara data-types and modules for working with tables and databases.
 - Documentation: [https://DHARPA-Project.github.io/kiara_plugin.tabular](https://DHARPA-Project.github.io/kiara_plugin.tabular)
 - Code: [https://github.com/DHARPA-Project/kiara_plugin.tabular](https://github.com/DHARPA-Project/kiara_plugin.tabular)
 - `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).
#### Using `pixi` (recommended)
The recommended way to setup a development environment is to use [pixi](https://github.com/prefix-dev/pixi). Check out [their install instructions](https://github.com/prefix-dev/pixi#installation).
Once you have `pixi` installed, you need to initialize the environment once:
```
pixi run install-dev-dependencies
```
You also need to do this whenever a depdendency of this plugin is updated (for example the core `kiara` package).
Once that is done, you can enter the environment with:
```
pixi shell
```
This will start a sub-shell with the virtual environment activated, and all dependencies of the plugin package installed. To confirm it works, you can run any `kiara` command:
```
kiara --version
# or
kiara operation list
# or
...
...
```
Once you are finished with your development session, you can exit the sub-shell as you would normally do in such cases:
```
exit
```
Alternatively, you can also run the `kiara` executable directly, it is located in `.pixi/env/bin/kiara`. So either adapt your `PATH` variable, or do something like:
```
.pixi/env/bin/kiara operation list
```
In most cases it's recommended to use a pixi shell though.
### Using pre-defined development-related tasks
The included `pyproject.toml` file includes some useful tasks that help with development:
- `pixi run pre-commit-check`: runs a set of checks against all files
- `pixi run tests`: runs the unit tests
- `pixi run mypy`: run mypy checks
## 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": null,
    "name": "kiara-plugin.tabular",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": null,
    "keywords": "kiara",
    "author": null,
    "author_email": "Markus Binsteiner <markus@frkl.io>",
    "download_url": "https://files.pythonhosted.org/packages/d8/40/8fbe75a5e3309f94a78956c1793d28f3e638860d502f4431ec1ba9bc4cc1/kiara_plugin_tabular-0.5.6.tar.gz",
    "platform": null,
    "description": "[](https://pypi.python.org/pypi/kiara_plugin.tabular/)\n[](https://pypi.python.org/pypi/kiara_plugin.tabular/)\n[](https://pypi.python.org/pypi/kiara_plugin.tabular/)\n[](https://actions-badge.atrox.dev/DHARPA-Project/kiara_plugin.tabular/goto?ref=develop)\n[](https://coveralls.io/github/DHARPA-Project/kiara_plugin.tabular?branch=develop)\n[](https://github.com/ambv/black)\n\n# [**kiara**](https://dharpa.org/kiara.documentation) plugin: (tabular)\n\nkiara data-types and modules for working with tables and databases.\n\n - Documentation: [https://DHARPA-Project.github.io/kiara_plugin.tabular](https://DHARPA-Project.github.io/kiara_plugin.tabular)\n - Code: [https://github.com/DHARPA-Project/kiara_plugin.tabular](https://github.com/DHARPA-Project/kiara_plugin.tabular)\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#### Using `pixi` (recommended)\n\nThe recommended way to setup a development environment is to use [pixi](https://github.com/prefix-dev/pixi). Check out [their install instructions](https://github.com/prefix-dev/pixi#installation).\n\nOnce you have `pixi` installed, you need to initialize the environment once:\n\n```\npixi run install-dev-dependencies\n```\n\nYou also need to do this whenever a depdendency of this plugin is updated (for example the core `kiara` package).\n\nOnce that is done, you can enter the environment with:\n\n```\npixi shell\n```\n\nThis will start a sub-shell with the virtual environment activated, and all dependencies of the plugin package installed. To confirm it works, you can run any `kiara` command:\n\n```\nkiara --version\n# or\nkiara operation list\n# or\n...\n...\n```\n\nOnce you are finished with your development session, you can exit the sub-shell as you would normally do in such cases:\n\n```\nexit\n```\n\nAlternatively, you can also run the `kiara` executable directly, it is located in `.pixi/env/bin/kiara`. So either adapt your `PATH` variable, or do something like:\n\n```\n.pixi/env/bin/kiara operation list\n```\n\nIn most cases it's recommended to use a pixi shell though.\n\n\n### Using pre-defined development-related tasks\n\nThe included `pyproject.toml` file includes some useful tasks that help with development:\n\n- `pixi run pre-commit-check`: runs a set of checks against all files\n- `pixi run tests`: runs the unit tests\n- `pixi run mypy`: run mypy checks\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": "kiara data-types and modules for working with tables and databases.",
    "version": "0.5.6",
    "project_urls": {
        "documentation": "https://DHARPA-Project.github.io/kiara_plugin.tabular",
        "homepage": "https://github.com/DHARPA-Project/kiara_plugin.tabular",
        "repository": "https://github.com/DHARPA-Project/kiara_plugin.tabular"
    },
    "split_keywords": [
        "kiara"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "27952be0e0a0f1eacd20bbc6b716b09c1530a8796d86630b0e27b792e8badce8",
                "md5": "cdfe658fbf74f1d15fbb86dd081ba5fe",
                "sha256": "2fcd0c3be1bcc18dfd075bccad966414e72c201a7bd06a6230244cb18ecc941b"
            },
            "downloads": -1,
            "filename": "kiara_plugin.tabular-0.5.6-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "cdfe658fbf74f1d15fbb86dd081ba5fe",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 60212,
            "upload_time": "2024-12-18T13:56:44",
            "upload_time_iso_8601": "2024-12-18T13:56:44.549795Z",
            "url": "https://files.pythonhosted.org/packages/27/95/2be0e0a0f1eacd20bbc6b716b09c1530a8796d86630b0e27b792e8badce8/kiara_plugin.tabular-0.5.6-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "d8408fbe75a5e3309f94a78956c1793d28f3e638860d502f4431ec1ba9bc4cc1",
                "md5": "e261bd08ff6e0938fe79c351c361b82f",
                "sha256": "eeee82bee42a21b78ae906466902a42a54d0b86adb6e7a42fdf9b5c147b18a14"
            },
            "downloads": -1,
            "filename": "kiara_plugin_tabular-0.5.6.tar.gz",
            "has_sig": false,
            "md5_digest": "e261bd08ff6e0938fe79c351c361b82f",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 139314,
            "upload_time": "2024-12-18T13:56:47",
            "upload_time_iso_8601": "2024-12-18T13:56:47.383138Z",
            "url": "https://files.pythonhosted.org/packages/d8/40/8fbe75a5e3309f94a78956c1793d28f3e638860d502f4431ec1ba9bc4cc1/kiara_plugin_tabular-0.5.6.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-12-18 13:56:47",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "DHARPA-Project",
    "github_project": "kiara_plugin.tabular",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "kiara-plugin.tabular"
}