pyqalx
======
.. image:: https://img.shields.io/bitbucket/pipelines/agiletekengineering/pyqalx :alt: Bitbucket Pipelines
.. image:: https://api.codacy.com/project/badge/Grade/fdfb81fd286a474098b624b426d63c41
:target: https://www.codacy.com?utm_source=bitbucket.org&utm_medium=referral&utm_content=agiletekengineering/pyqalx&utm_campaign=Badge_Grade
.. image:: https://api.codacy.com/project/badge/Coverage/fdfb81fd286a474098b624b426d63c41
:target: https://www.codacy.com?utm_source=bitbucket.org&utm_medium=referral&utm_content=agiletekengineering/pyqalx&utm_campaign=Badge_Coverage
Interfaces to qalx. For more details, see `project documentation, <http://docs.qalx.net>`_.
.. admonition:: development status
``pyqalx`` is currently under active development. It is pre-version 1.0 beta software and so each minor version
can introduce breaking changes.
**qalx** (an abbreviation of "queued calculations" and pronounced "kal-x") is a flexible data management platform for engineering projects. Users store data and files in qalx and it provides tools for passing that data between various systems for processing.
There will eventually be four ways to interact with the platform:
- A Python interface (pyqalx)
- REST API (api.qalx.net)
- Web console (console.qalx.net) - coming soon
- A command line interface (qalx-cli) - coming soon
Most users are expected to use the web console and either the python or
command line interfaces. The REST API is intended to be used if you
prefer to access the platform with a language other than Python or want
to create a custom interface.
.. _installing:
Installing
==========
**qalx** is written in `Python <https://python.org>`_ and can be
installed via the Python Package Index (PyPi) with:
.. code:: bash
pip install pyqalx
If installation has completed properly you should be able to import
``pyqalx`` in a python console:
>>> import pyqalx
.. warning::
pyqalx requires **Python versions above 3.6**.
Configuration and Authentication
--------------------------------
Everything you do with **qalx** requires you to be authenticated. That
is, the platform requires you to identify yourself and will record all
your actions as being performed by you.
The way that **qalx** knows who you are is by reading a ``TOKEN``
which must be sent with every request.
.. warning::
During this beta phase, you have to request a ``TOKEN`` by registering your interest at `qalx.net <https://qalx.net>`_
The easiest way to make sure that your token is sent with every request is to make sure you have a valid ``.qalx`` file
saved in your HOME directory.
.. admonition:: where is ``HOME``?
The ``HOME`` directory can usually be found by putting %USERPROFILE%
in the address bar in Windows Explorer or it is simply ``~`` on unix
systems.
qalx CLI configure
------------------
You can either add the ``TOKEN`` manually to the config file or you can use the **qalx** cli to do this for you automatically
.. code:: bash
$ qalx configure
The above command will ask you all the necessary questions to create your user and bot config files.
You can also create other profiles using the ``qalx configure`` command. You can even create profiles just for bots
or just for users - or provide extra arguments to write to the config
.. code:: bash
# Will write a user profile called `dev` to the config file,
# will also write a `default` bot config profile
$ qalx --user-profile dev configure
# Will write a bot profile called `dev` to the config file,
# will also write a `default` user config profile
$ qalx --bot-profile dev configure
# Will not write the bot profile
$ qalx configure --no-bot
# Will not write the user profile
$ qalx configure --no-user
# Will write a default user and bot profile and will also write two
# extra keys to each config - `CUSTOMKEY=customvalue`
# and `CUSTOMKEY2=customvalue2`
$ qalx configure customkey=customvalue customkey2=customvalue2
Manual configuration
--------------------
If you don't want to use the ``qalx cli`` to configure your profile (or if you want to make changes to it in the future)
then you can configure the profile yourself by adding the ``TOKEN`` to your config file under
the default profile.
.. code:: ini
[default]
TOKEN = 632gd7yb9squd0q8sdhq0s8diqsd0nqsdq9sdk
Any other configuration settings can be stored in the same file see `<configuration>`_ for more information.
Quickstart
----------
The best place to get started: `<https://docs.qalx.net/quickstart>`_
Raw data
{
"_id": null,
"home_page": "https://qalx.net",
"name": "pyqalx",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.8",
"maintainer_email": null,
"keywords": "qalx, engineering, simulation",
"author": "AgileTek Engineering Limited",
"author_email": "london@agiletek.co.uk",
"download_url": "https://files.pythonhosted.org/packages/44/93/d46df448c972600e534adbdea2aa54ac79edb4412d867631c4b8a43fab14/pyqalx-0.19.2.tar.gz",
"platform": null,
"description": "pyqalx\n======\n.. image:: https://img.shields.io/bitbucket/pipelines/agiletekengineering/pyqalx :alt: Bitbucket Pipelines\n\n\n.. image:: https://api.codacy.com/project/badge/Grade/fdfb81fd286a474098b624b426d63c41\n :target: https://www.codacy.com?utm_source=bitbucket.org&utm_medium=referral&utm_content=agiletekengineering/pyqalx&utm_campaign=Badge_Grade\n\n\n.. image:: https://api.codacy.com/project/badge/Coverage/fdfb81fd286a474098b624b426d63c41\n :target: https://www.codacy.com?utm_source=bitbucket.org&utm_medium=referral&utm_content=agiletekengineering/pyqalx&utm_campaign=Badge_Coverage\n\n\nInterfaces to qalx. For more details, see `project documentation, <http://docs.qalx.net>`_.\n\n.. admonition:: development status\n\n ``pyqalx`` is currently under active development. It is pre-version 1.0 beta software and so each minor version\n can introduce breaking changes.\n\n**qalx** (an abbreviation of \"queued calculations\" and pronounced \"kal-x\") is a flexible data management platform for engineering projects. Users store data and files in qalx and it provides tools for passing that data between various systems for processing.\n\nThere will eventually be four ways to interact with the platform:\n\n- A Python interface (pyqalx)\n- REST API (api.qalx.net)\n- Web console (console.qalx.net) - coming soon\n- A command line interface (qalx-cli) - coming soon\n\nMost users are expected to use the web console and either the python or\ncommand line interfaces. The REST API is intended to be used if you\nprefer to access the platform with a language other than Python or want\nto create a custom interface.\n\n.. _installing:\n\nInstalling\n==========\n\n**qalx** is written in `Python <https://python.org>`_ and can be\ninstalled via the Python Package Index (PyPi) with:\n\n.. code:: bash\n\n pip install pyqalx\n\nIf installation has completed properly you should be able to import\n``pyqalx`` in a python console:\n\n>>> import pyqalx\n\n.. warning::\n\n pyqalx requires **Python versions above 3.6**.\n\n\nConfiguration and Authentication\n--------------------------------\n\nEverything you do with **qalx** requires you to be authenticated. That\nis, the platform requires you to identify yourself and will record all\nyour actions as being performed by you.\n\nThe way that **qalx** knows who you are is by reading a ``TOKEN``\nwhich must be sent with every request.\n\n.. warning::\n During this beta phase, you have to request a ``TOKEN`` by registering your interest at `qalx.net <https://qalx.net>`_\n\nThe easiest way to make sure that your token is sent with every request is to make sure you have a valid ``.qalx`` file\nsaved in your HOME directory.\n\n.. admonition:: where is ``HOME``?\n\n The ``HOME`` directory can usually be found by putting %USERPROFILE%\n in the address bar in Windows Explorer or it is simply ``~`` on unix\n systems.\n\n\nqalx CLI configure\n------------------\nYou can either add the ``TOKEN`` manually to the config file or you can use the **qalx** cli to do this for you automatically\n\n.. code:: bash\n\n $ qalx configure\n\nThe above command will ask you all the necessary questions to create your user and bot config files.\n\nYou can also create other profiles using the ``qalx configure`` command. You can even create profiles just for bots\nor just for users - or provide extra arguments to write to the config\n\n.. code:: bash\n\n # Will write a user profile called `dev` to the config file,\n # will also write a `default` bot config profile\n $ qalx --user-profile dev configure\n\n # Will write a bot profile called `dev` to the config file,\n # will also write a `default` user config profile\n $ qalx --bot-profile dev configure\n\n # Will not write the bot profile\n $ qalx configure --no-bot\n\n # Will not write the user profile\n $ qalx configure --no-user\n\n # Will write a default user and bot profile and will also write two\n # extra keys to each config - `CUSTOMKEY=customvalue`\n # and `CUSTOMKEY2=customvalue2`\n $ qalx configure customkey=customvalue customkey2=customvalue2\n\nManual configuration\n--------------------\n\nIf you don't want to use the ``qalx cli`` to configure your profile (or if you want to make changes to it in the future)\nthen you can configure the profile yourself by adding the ``TOKEN`` to your config file under\nthe default profile.\n\n.. code:: ini\n\n [default]\n TOKEN = 632gd7yb9squd0q8sdhq0s8diqsd0nqsdq9sdk\n\nAny other configuration settings can be stored in the same file see `<configuration>`_ for more information.\n\nQuickstart\n----------\n\nThe best place to get started: `<https://docs.qalx.net/quickstart>`_\n\n\n\n",
"bugtrack_url": null,
"license": "GPL-3.0",
"summary": "High-level interfaces to the qalx API",
"version": "0.19.2",
"project_urls": {
"Documentation": "https://docs.qalx.net",
"Homepage": "https://qalx.net"
},
"split_keywords": [
"qalx",
" engineering",
" simulation"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "db1ef3e6fbcaeeb3f5f7e8d4fefd47d8a09b26640495f7f121aa6e898594eec8",
"md5": "1daddee38bbbb250aae5ec78a174573f",
"sha256": "216010bd4759c90bc27b0f4fe4c823b6e06bcbd11470f273a9d7b56b6992d748"
},
"downloads": -1,
"filename": "pyqalx-0.19.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1daddee38bbbb250aae5ec78a174573f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.8",
"size": 146493,
"upload_time": "2024-03-26T12:09:16",
"upload_time_iso_8601": "2024-03-26T12:09:16.211077Z",
"url": "https://files.pythonhosted.org/packages/db/1e/f3e6fbcaeeb3f5f7e8d4fefd47d8a09b26640495f7f121aa6e898594eec8/pyqalx-0.19.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4493d46df448c972600e534adbdea2aa54ac79edb4412d867631c4b8a43fab14",
"md5": "daf1ee86f53bb62b990cbf364ea797a2",
"sha256": "e91d489100a45e7a19c044718b97a7b20c9ef39d946570c1e593fe2b2b579f82"
},
"downloads": -1,
"filename": "pyqalx-0.19.2.tar.gz",
"has_sig": false,
"md5_digest": "daf1ee86f53bb62b990cbf364ea797a2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.8",
"size": 120147,
"upload_time": "2024-03-26T12:09:18",
"upload_time_iso_8601": "2024-03-26T12:09:18.017571Z",
"url": "https://files.pythonhosted.org/packages/44/93/d46df448c972600e534adbdea2aa54ac79edb4412d867631c4b8a43fab14/pyqalx-0.19.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-26 12:09:18",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "pyqalx"
}
JSON