# volttron-lib-auth
VOLTTRON zmq message bus implementation
## Prerequisites
* Python 3.8
* Poetry
### Python
volttron-lib-auth requires Python 3.8 or above.
To install Python 3.8, we recommend using [pyenv](https://github.com/pyenv/pyenv).
```bash
# install pyenv
git clone https://github.com/pyenv/pyenv ~/.pyenv
# setup pyenv (you should also put these three lines in .bashrc or similar)
export PATH="${HOME}/.pyenv/bin:${PATH}"
export PYENV_ROOT="${HOME}/.pyenv"
eval "$(pyenv init -)"
# install Python 3.8
pyenv install 3.8.10
# make it available globally
pyenv global system 3.8.10
```
### Poetry
This project uses `poetry` to install and manage dependencies. To install poetry,
follow these [instructions](https://python-poetry.org/docs/master/#installation).
## Installation and Virtual Environment Setup
Set the environment to be in your project directory:
```poetry config virtualenvs.in-project true```
If you want to install all your dependencies, including dependencies to help with developing your agent, run this command:
```poetry install```
If you want to install only the dependencies needed to run your agent, run this command:
```poetry install --no-dev```
Activate the virtual environment:
```poetry shell```
## Git Setup
1. To use git to manage version control, create a new git repository in your local agent project.
```
git init
```
2. Then create a new repo in your Github or Gitlab account. Copy the URL that points to that new repo in
your Github or Gitlab account. This will be known as our 'remote'.
3. Add the remote (i.e. the new repo URL from your Github or Gitlab account) to your local repository. Run the following command:
```git remote add origin <my github/gitlab URL>```
When you push to your repo, note that the default branch is called 'main'.
## Publishing to PyPi
Publishing your Agent module to PyPi is automated through the continuous integration workflow provided in `~/.github/workflows/publish_to_pypi.yml`.
You can update that Github Workflow with your credentials to ensure that publishing to PyPi will succeed. The default behavior of
that workflow is to publish to PyPi when a release has been published. If you want to change this behavior, you can modify the
workflow to publish to PyPi based on whatever desired event; see [Github Workflows docs](https://docs.github.com/en/actions/using-workflows/triggering-a-workflow)
on how to change the events that trigger a workflow.
## Optional Configurations
### Precommit
Install pre-commit hooks:
```pre-commit install```
To run pre-commit on all your files, run this command:
```pre-commit run --all-files```
If you have precommit installed and you want to ignore running the commit hooks
every time you run a commit, include the `--no-verify` flag in your commit. The following
is an example:
```git commit -m "Some message" --no-verify```
# Documentation
To build the docs, navigate to the 'docs' directory and build the documentation:
```shell
cd docs
make html
```
After the documentation is built, view the documentation in html form in your browser.
The html files will be located in `~<path to agent project directory>/docs/build/html`.
**PROTIP: To open the landing page of your documentation directly from the command line, run the following command:**
```shell
open <path to agent project directory>/docs/build/html/index.html
```
This will open the documentation landing page in your default browsert (e.g. Chrome, Firefox).
Raw data
{
"_id": null,
"home_page": "https://github.com/eclipse-volttron/volttron-lib-zmq",
"name": "volttron-lib-zmq",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": null,
"author": "C. Allwardt",
"author_email": "3979063+craig8@users.noreply.github.com",
"download_url": "https://files.pythonhosted.org/packages/cf/0a/a116d49b8ad5594a4a67336a9a130dbf12c7f02ff7ed88a77bace4956c37/volttron_lib_zmq-2.0.0rc4.tar.gz",
"platform": null,
"description": "# volttron-lib-auth\n\nVOLTTRON zmq message bus implementation\n\n## Prerequisites\n\n* Python 3.8\n* Poetry\n\n### Python\nvolttron-lib-auth requires Python 3.8 or above.\n\n\nTo install Python 3.8, we recommend using [pyenv](https://github.com/pyenv/pyenv).\n\n```bash\n# install pyenv\ngit clone https://github.com/pyenv/pyenv ~/.pyenv\n\n# setup pyenv (you should also put these three lines in .bashrc or similar)\nexport PATH=\"${HOME}/.pyenv/bin:${PATH}\"\nexport PYENV_ROOT=\"${HOME}/.pyenv\"\neval \"$(pyenv init -)\"\n\n# install Python 3.8\npyenv install 3.8.10\n\n# make it available globally\npyenv global system 3.8.10\n```\n\n### Poetry\n\nThis project uses `poetry` to install and manage dependencies. To install poetry,\nfollow these [instructions](https://python-poetry.org/docs/master/#installation).\n\n\n\n## Installation and Virtual Environment Setup\n\nSet the environment to be in your project directory:\n\n```poetry config virtualenvs.in-project true```\n\nIf you want to install all your dependencies, including dependencies to help with developing your agent, run this command:\n\n```poetry install```\n\nIf you want to install only the dependencies needed to run your agent, run this command:\n\n```poetry install --no-dev```\n\nActivate the virtual environment:\n\n```poetry shell```\n\n\n## Git Setup\n\n1. To use git to manage version control, create a new git repository in your local agent project.\n\n```\ngit init\n```\n\n2. Then create a new repo in your Github or Gitlab account. Copy the URL that points to that new repo in\nyour Github or Gitlab account. This will be known as our 'remote'.\n\n3. Add the remote (i.e. the new repo URL from your Github or Gitlab account) to your local repository. Run the following command:\n\n```git remote add origin <my github/gitlab URL>```\n\nWhen you push to your repo, note that the default branch is called 'main'.\n\n## Publishing to PyPi\n\nPublishing your Agent module to PyPi is automated through the continuous integration workflow provided in `~/.github/workflows/publish_to_pypi.yml`.\nYou can update that Github Workflow with your credentials to ensure that publishing to PyPi will succeed. The default behavior of\nthat workflow is to publish to PyPi when a release has been published. If you want to change this behavior, you can modify the\nworkflow to publish to PyPi based on whatever desired event; see [Github Workflows docs](https://docs.github.com/en/actions/using-workflows/triggering-a-workflow)\non how to change the events that trigger a workflow.\n\n## Optional Configurations\n\n### Precommit\n\nInstall pre-commit hooks:\n\n```pre-commit install```\n\nTo run pre-commit on all your files, run this command:\n\n```pre-commit run --all-files```\n\nIf you have precommit installed and you want to ignore running the commit hooks\nevery time you run a commit, include the `--no-verify` flag in your commit. The following\nis an example:\n\n```git commit -m \"Some message\" --no-verify```\n\n# Documentation\n\nTo build the docs, navigate to the 'docs' directory and build the documentation:\n\n```shell\ncd docs\nmake html\n```\n\nAfter the documentation is built, view the documentation in html form in your browser.\nThe html files will be located in `~<path to agent project directory>/docs/build/html`.\n\n**PROTIP: To open the landing page of your documentation directly from the command line, run the following command:**\n\n```shell\nopen <path to agent project directory>/docs/build/html/index.html\n```\n\nThis will open the documentation landing page in your default browsert (e.g. Chrome, Firefox).\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "VOLTTRON zmq message bus implementation",
"version": "2.0.0rc4",
"project_urls": {
"Homepage": "https://github.com/eclipse-volttron/volttron-lib-zmq",
"Repository": "https://github.com/eclipse-volttron/volttron-lib-zmq"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "09457670447a00d0bed9b5aefaae37344ef16b0ad59c0d6c22a79c4a45c25673",
"md5": "f03970371eefa0680b0aca965246cd4a",
"sha256": "8fbaa99d8c34042f99809598300302f8c8ec96343e323e91c21520e2acecea6e"
},
"downloads": -1,
"filename": "volttron_lib_zmq-2.0.0rc4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f03970371eefa0680b0aca965246cd4a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 168473,
"upload_time": "2024-10-25T19:17:37",
"upload_time_iso_8601": "2024-10-25T19:17:37.725951Z",
"url": "https://files.pythonhosted.org/packages/09/45/7670447a00d0bed9b5aefaae37344ef16b0ad59c0d6c22a79c4a45c25673/volttron_lib_zmq-2.0.0rc4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "cf0aa116d49b8ad5594a4a67336a9a130dbf12c7f02ff7ed88a77bace4956c37",
"md5": "ba1d63d898ce6c54ced08c4046b13679",
"sha256": "77394e6c2e2c04f31e04694538d7dc7832b9301cc69c3c9ebf3cf9f358a97b0c"
},
"downloads": -1,
"filename": "volttron_lib_zmq-2.0.0rc4.tar.gz",
"has_sig": false,
"md5_digest": "ba1d63d898ce6c54ced08c4046b13679",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 147524,
"upload_time": "2024-10-25T19:17:39",
"upload_time_iso_8601": "2024-10-25T19:17:39.272543Z",
"url": "https://files.pythonhosted.org/packages/cf/0a/a116d49b8ad5594a4a67336a9a130dbf12c7f02ff7ed88a77bace4956c37/volttron_lib_zmq-2.0.0rc4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-25 19:17:39",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "eclipse-volttron",
"github_project": "volttron-lib-zmq",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "volttron-lib-zmq"
}
JSON
