.. -*- mode: rst -*-
|ReadTheDocs|_ |Pypi|_ |PythonVersion|_ |Black|_
.. |PythonMinVersion| replace:: 3.8
.. |NumPyMinVersion| replace:: 1.23.2
.. |GurobiPyMinVersion| replace:: 9.5.2
.. |ScikitLearn| replace:: 1.1.2
.. |ReadTheDocs| image:: https://readthedocs.org/projects/opt-sugar/badge/?version=latest
.. _ReadTheDocs: https://opt-sugar.readthedocs.io/en/latest/?badge=latest
.. |PyPi| image:: https://img.shields.io/pypi/v/opt-sugar
.. _PyPi: https://pypi.org/project/opt-sugar/
.. |PythonVersion| image:: https://img.shields.io/badge/python-3.8%20%7C%203.9%20%7C%203.10-blue
.. _PythonVersion: https://pypi.org/project/scikit-learn/
.. |Black| image:: https://img.shields.io/badge/code%20style-black-000000.svg
.. _Black: https://github.com/psf/black
**opt-sugar**
is a Python package meant to make the optimization operation (OptOps) tasks easier by providing the building blocks needed
to use mlflow for mathematical optimization experimentation.
The project was started in oct 2022 by Juan Chacon.
Installation
------------
Dependencies
~~~~~~~~~~~~~~~~~
opt-sugar requires:
- Python (>= |PythonMinVersion|)
- NumPy (>= |NumPyMinVersion|)
- GurobiPy (>= |GurobiPyMinVersion|)
- ScikitLearn (>= |ScikitLearn|)
User installation
~~~~~~~~~~~~~~~~~
If you already have a working installation all the dependencies,
the easiest way to install opt-sugar is using ``pip``::
pip install -U opt-sugar
Read the docs `here. <https://opt-sugar.readthedocs.io/en/latest/>`_
For Contributors
----------------
Releasing Package
~~~~~~~~~~~~~~~~~
To release the package to PyPI follow the next steps:
#. Update version in setup.py file and push changes to GitHub.
#. In GitHub create a tag with the same version as in the setup.py, then create a release using the tag you just created.
#. Have a coffee, the `Upload Python Package` GitHub action will do the rest.
Updating Examples
~~~~~~~~~~~~~~~~~
Once the examples run locally using the imports with local paths in the examples:
#. Remove the sys.path.append lines in the examples (commenting them by now is okay)
#. Release to PyPI
#. Add opt-sugar in the requirements-dev.txt
#. Remove the docs/source/auto_examples folder content
#. Generate the examples locally and push to repo
#. Checkout any changes in the main branch
.. Note::
It would be good idea to run `pip install -U -r requirements-dev.txt` in your dev environment to get the most
updated version of the package.
Raw data
{
"_id": null,
"home_page": "https://github.com/juandados/opt-sugar",
"name": "opt-sugar",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "optimization operations mathematical programming",
"author": "Juan Chacon",
"author_email": "juandados@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/2b/51/68e7319c29de2db28759e942afe2babcdd3ee64ced60fdd273f6dc19b919/opt_sugar-0.0.4.9.tar.gz",
"platform": null,
"description": ".. -*- mode: rst -*-\n\n|ReadTheDocs|_ |Pypi|_ |PythonVersion|_ |Black|_\n\n.. |PythonMinVersion| replace:: 3.8\n.. |NumPyMinVersion| replace:: 1.23.2\n.. |GurobiPyMinVersion| replace:: 9.5.2\n.. |ScikitLearn| replace:: 1.1.2\n\n.. |ReadTheDocs| image:: https://readthedocs.org/projects/opt-sugar/badge/?version=latest\n.. _ReadTheDocs: https://opt-sugar.readthedocs.io/en/latest/?badge=latest\n\n.. |PyPi| image:: https://img.shields.io/pypi/v/opt-sugar\n.. _PyPi: https://pypi.org/project/opt-sugar/\n\n.. |PythonVersion| image:: https://img.shields.io/badge/python-3.8%20%7C%203.9%20%7C%203.10-blue\n.. _PythonVersion: https://pypi.org/project/scikit-learn/\n\n.. |Black| image:: https://img.shields.io/badge/code%20style-black-000000.svg\n.. _Black: https://github.com/psf/black\n\n**opt-sugar**\nis a Python package meant to make the optimization operation (OptOps) tasks easier by providing the building blocks needed\nto use mlflow for mathematical optimization experimentation.\n\nThe project was started in oct 2022 by Juan Chacon.\n\nInstallation\n------------\n\nDependencies\n~~~~~~~~~~~~~~~~~\n\nopt-sugar requires:\n\n- Python (>= |PythonMinVersion|)\n- NumPy (>= |NumPyMinVersion|)\n- GurobiPy (>= |GurobiPyMinVersion|)\n- ScikitLearn (>= |ScikitLearn|)\n\nUser installation\n~~~~~~~~~~~~~~~~~\n\nIf you already have a working installation all the dependencies,\nthe easiest way to install opt-sugar is using ``pip``::\n\n pip install -U opt-sugar\n\nRead the docs `here. <https://opt-sugar.readthedocs.io/en/latest/>`_\n\nFor Contributors\n----------------\n\nReleasing Package\n~~~~~~~~~~~~~~~~~\n\nTo release the package to PyPI follow the next steps:\n\n#. Update version in setup.py file and push changes to GitHub.\n#. In GitHub create a tag with the same version as in the setup.py, then create a release using the tag you just created.\n#. Have a coffee, the `Upload Python Package` GitHub action will do the rest.\n\nUpdating Examples\n~~~~~~~~~~~~~~~~~\n\nOnce the examples run locally using the imports with local paths in the examples:\n\n#. Remove the sys.path.append lines in the examples (commenting them by now is okay)\n#. Release to PyPI\n#. Add opt-sugar in the requirements-dev.txt\n#. Remove the docs/source/auto_examples folder content\n#. Generate the examples locally and push to repo\n#. Checkout any changes in the main branch\n\n.. Note::\n It would be good idea to run `pip install -U -r requirements-dev.txt` in your dev environment to get the most\n updated version of the package.\n \n",
"bugtrack_url": null,
"license": "",
"summary": "",
"version": "0.0.4.9",
"split_keywords": [
"optimization",
"operations",
"mathematical",
"programming"
],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "6b5495fd35636882ce1e5c0bf08ec726",
"sha256": "edcef606724e4c38c9748536e4939237ca31cf92491dd5c250cf07ff74fab8ce"
},
"downloads": -1,
"filename": "opt_sugar-0.0.4.9-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6b5495fd35636882ce1e5c0bf08ec726",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 6508,
"upload_time": "2022-12-12T20:58:46",
"upload_time_iso_8601": "2022-12-12T20:58:46.356208Z",
"url": "https://files.pythonhosted.org/packages/cd/da/e3a7e1f412f35e7efe78652d5cb5e4316e14ba2458795beef6060e87c2a8/opt_sugar-0.0.4.9-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"md5": "10dbf4ce0b81dcabd35996460d7b2909",
"sha256": "8777b6b3bdf08d2709b38aa62e046c2cabd312896d2c2eb3cb6bcad1f513cdd3"
},
"downloads": -1,
"filename": "opt_sugar-0.0.4.9.tar.gz",
"has_sig": false,
"md5_digest": "10dbf4ce0b81dcabd35996460d7b2909",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 6204,
"upload_time": "2022-12-12T20:58:47",
"upload_time_iso_8601": "2022-12-12T20:58:47.783286Z",
"url": "https://files.pythonhosted.org/packages/2b/51/68e7319c29de2db28759e942afe2babcdd3ee64ced60fdd273f6dc19b919/opt_sugar-0.0.4.9.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-12-12 20:58:47",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "juandados",
"github_project": "opt-sugar",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "numpy",
"specs": [
[
"==",
"1.21.6"
]
]
},
{
"name": "gurobipy",
"specs": [
[
"==",
"9.5.2"
]
]
},
{
"name": "scikit-learn",
"specs": [
[
"==",
"1.1.3"
]
]
},
{
"name": "mlflow",
"specs": [
[
"==",
"1.29.0"
]
]
},
{
"name": "matplotlib",
"specs": [
[
"==",
"3.5.3"
]
]
},
{
"name": "pyvis",
"specs": [
[
"==",
"0.3.0"
]
]
},
{
"name": "grblogtools",
"specs": [
[
"==",
"2.0.0"
]
]
},
{
"name": "pandas",
"specs": [
[
"==",
"1.5.1"
]
]
},
{
"name": "requests",
"specs": [
[
"==",
"2.28.1"
]
]
}
],
"lcname": "opt-sugar"
}
JSON
