[](https://www.gnu.org/licenses/lgpl-3.0)
[](https://github.com/mxcube/mxcubecore/actions/workflows/tests.yml)
# Backend of MXCuBE
`mxcubecore` is the back-end library for
[MXCuBE Qt](https://github.com/mxcube/mxcubeqt/)
and [MXCuBE Web](https://github.com/mxcube/mxcubeweb/).
It allows access to the beamline control system and instrumentation.
It acts as a container of single Python objects (called "hardware objects").
Please read the
[contributing guidelines](https://mxcubecore.readthedocs.io/en/stable/dev/contributing.html)
before submitting your code to the repository.
## License
MXCuBE is free software: you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
MXCuBE is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License
along with MXCuBE. If not, see <https://www.gnu.org/licenses/>.
## Installation
Installation of the `mxcubecore` module is commonly done as a dependency of either
[MXCuBE Web](https://github.com/mxcube/mxcubeweb/)
or [MXCuBE Qt](https://github.com/mxcube/mxcubeqt/).
Standalone installation of the `mxcubecore` for development purposes can be done
via Poetry with `poetry install`
or via pip with `python -m pip install --editable .` (don't forget the trailing dot `.`).
`mxcubecore` depends on `python-ldap` that in turn depends on the `openldap` system library.
It can be installed in a conda environment: `conda install openldap`
or on systems using the apt package manager (Debian and derivatives, including Ubuntu):
`sudo apt-get install -y libldap2-dev libsasl2-dev`.
See [python-ldap](https://www.python-ldap.org/en/python-ldap-3.4.3/installing.html#debian)
for more information.
See [Developer documentation](https://mxcubecore.readthedocs.io/)
for more information on working with mxcubecore.
Raw data
{
"_id": null,
"home_page": "https://github.com/mxcube/mxcubecore",
"name": "mxcubecore",
"maintainer": "Marcus Oscarsson",
"docs_url": null,
"requires_python": "<3.12,>=3.10",
"maintainer_email": "mxcube@esrf.fr",
"keywords": "mxcube, mxcube3, mxcubecore",
"author": "The MXCuBE collaboration",
"author_email": "mxcube@esrf.fr",
"download_url": "https://files.pythonhosted.org/packages/cf/d7/10954dbee0e6614da82d8b7069eb6e23e548ad888c5e1db62588e8df3c2c/mxcubecore-1.348.0.tar.gz",
"platform": null,
"description": "[](https://www.gnu.org/licenses/lgpl-3.0)\n[](https://github.com/mxcube/mxcubecore/actions/workflows/tests.yml)\n\n\n\n# Backend of MXCuBE\n\n`mxcubecore` is the back-end library for\n[MXCuBE Qt](https://github.com/mxcube/mxcubeqt/)\nand [MXCuBE Web](https://github.com/mxcube/mxcubeweb/).\nIt allows access to the beamline control system and instrumentation.\nIt acts as a container of single Python objects (called \"hardware objects\").\n\nPlease read the\n[contributing guidelines](https://mxcubecore.readthedocs.io/en/stable/dev/contributing.html)\nbefore submitting your code to the repository.\n\n## License\n\nMXCuBE is free software: you can redistribute it and/or modify\nit under the terms of the GNU Lesser General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n\nMXCuBE is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\nGNU Lesser General Public License for more details.\n\nYou should have received a copy of the GNU Lesser General Public License\nalong with MXCuBE. If not, see <https://www.gnu.org/licenses/>.\n\n\n## Installation\n\nInstallation of the `mxcubecore` module is commonly done as a dependency of either\n[MXCuBE Web](https://github.com/mxcube/mxcubeweb/)\nor [MXCuBE Qt](https://github.com/mxcube/mxcubeqt/).\n\nStandalone installation of the `mxcubecore` for development purposes can be done\nvia Poetry with `poetry install`\nor via pip with `python -m pip install --editable .` (don't forget the trailing dot `.`).\n\n`mxcubecore` depends on `python-ldap` that in turn depends on the `openldap` system library.\nIt can be installed in a conda environment: `conda install openldap`\nor on systems using the apt package manager (Debian and derivatives, including Ubuntu):\n`sudo apt-get install -y libldap2-dev libsasl2-dev`.\nSee [python-ldap](https://www.python-ldap.org/en/python-ldap-3.4.3/installing.html#debian)\nfor more information.\n\nSee [Developer documentation](https://mxcubecore.readthedocs.io/)\nfor more information on working with mxcubecore.\n",
"bugtrack_url": null,
"license": "LGPL-3.0-or-later",
"summary": "Core libraries for the MXCuBE application",
"version": "1.348.0",
"project_urls": {
"Documentation": "https://mxcubecore.readthedocs.io/",
"Homepage": "https://github.com/mxcube/mxcubecore",
"Repository": "https://github.com/mxcube/mxcubecore"
},
"split_keywords": [
"mxcube",
" mxcube3",
" mxcubecore"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f1bad68de1cb4dacce4a1c62386feac5c4806d4080789d6b3282d6d2ffcc3efb",
"md5": "6354e149881f51475688ae53f5f79c9d",
"sha256": "62eb9f0770f9d179b8f75045894207d6e7ddbc352c0993dc060dd46d5e2c8f2e"
},
"downloads": -1,
"filename": "mxcubecore-1.348.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6354e149881f51475688ae53f5f79c9d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.12,>=3.10",
"size": 1373526,
"upload_time": "2025-07-25T15:28:40",
"upload_time_iso_8601": "2025-07-25T15:28:40.292225Z",
"url": "https://files.pythonhosted.org/packages/f1/ba/d68de1cb4dacce4a1c62386feac5c4806d4080789d6b3282d6d2ffcc3efb/mxcubecore-1.348.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "cfd710954dbee0e6614da82d8b7069eb6e23e548ad888c5e1db62588e8df3c2c",
"md5": "ee095714c89fcf120282ec121e4647f1",
"sha256": "569a137bf132a7b13ebf6047cbd7ca81a04163a4af64fa959b7d7c8f32a8ce08"
},
"downloads": -1,
"filename": "mxcubecore-1.348.0.tar.gz",
"has_sig": false,
"md5_digest": "ee095714c89fcf120282ec121e4647f1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.12,>=3.10",
"size": 1065381,
"upload_time": "2025-07-25T15:28:42",
"upload_time_iso_8601": "2025-07-25T15:28:42.084384Z",
"url": "https://files.pythonhosted.org/packages/cf/d7/10954dbee0e6614da82d8b7069eb6e23e548ad888c5e1db62588e8df3c2c/mxcubecore-1.348.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-25 15:28:42",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mxcube",
"github_project": "mxcubecore",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "mxcubecore"
}
JSON
