{ "info": { "author": "Micah Snyder", "author_email": "micasnyd@cisco.com", "bugtrack_url": null, "classifiers": [ "License :: OSI Approved :: Apache Software License", "Operating System :: OS Independent", "Programming Language :: Python :: 3" ], "description": "

\n Mussels\n

\n\n

A tool to download, build, and assemble application dependencies.\n
Brought to you by the Clam AntiVirus Team.\n

Copyright (C) 2019-2021 Cisco Systems, Inc. and/or its affiliates. All rights reserved.

\n\n

\n\n \"PyPI\n\n\"PyPI\n\n \"Unit\n\n\n\n\n

\n\n## About\n\nMussels is a cross-platform and general-purpose dependency build automation tool.\n\nMussels helps automate the building of applications _and_ their versioned dependency chains using the original build systems intended by the software authors.\n\nFor a more in depth explanation, see the [Mussels Introduction](docs/introduction.md).\n\n## Requirements\n\n- Python 3.6 or newer.\n- Git (must be added to your PATH environment variable).\n\nAn internet connection is required to use the public Mussels cookbooks. Some form of internet or intranet is required to download source archives from the URLs defined in each recipe.\n\nEvery recipe will require tools in order to run. If you don't have the required tools, you'll get an error message stating that you're missing a required tool. It will be up to you to install the tool in order for that recipe to build.\n\n### Common Tools Requirements for building C/C++ software\n\nMussels was born out of the ClamAV project so you can find some good example recipe and tool definitions here: https://github.com/Cisco-Talos/clamav-mussels-cookbook/\n\nThe ClamAV recipes build C libraries for the most part. When using them, you'll probably the following compiler toolchain software installed on your system for the build to work. If these are missing, the Mussels build will fail and tell you as much.\n\nLinux:\n\n- gcc\n- Make\n- CMake\n- patchelf\n\nMacOS (Darwin):\n\n- Clang (comes with XCode)\n- Make\n- CMake\n\nWindows:\n\n- Visual Studio 2017+\n- CMake\n\n## Installation\n\nYou may install Mussels from PyPI using `pip`, or you may clone the Mussels Git repository and use `pip` to install it locally.\n\nInstall Mussels from PyPI:\n\n> `python3 -m pip install --user mussels`\n\n## Usage\n\nUse the `--help` option to get information about any Mussels command.\n\n> `mussels`\n>\n> `mussels --help`\n>\n> `mussels build --help`\n\nWhen performing a build, the intermediate build files are placed into the `~/.mussels/cache/work/` directory and the final installed files into the `~/.mussels/install/` directory. This default behavior can be overridden using `msl build --work-dir ` to specify a different work directory, and `msl build --install ` to specify a different install directory.\n\n_Tip_: Use the `msl` shortcut, instead of `mussels` to save keystrokes.\n\n_Tip_: You may not be able to run `mussels` or the `msl` shortcut directly if your Python Scripts directory is not in your `PATH` environment variable. If you run into this issue, and do not wish to add the Python Scripts directory to your path, you can run Mussels like this:\n\n> `python -m mussels`\n\nLearn more about how use Mussels in our [documentation](docs/usage.md).\n\n## Contribute\n\nMussels is open source and we'd love your help. There are many ways to contribute!\n\n### Community\n\nJoin the Mussels community on the [Mussels Discord chat server](https://discord.gg/My6Mqxt).\n\n### Contribute Recipes\n\nYou can contribute to the Mussels community by creating new recipes or improving on existing recipes in the [\"scrapbook\"](https://github.com/Cisco-Talos/mussels-recipe-scrapbook). Do this by submitting a pull request to that Git repository.\n\nIf your project is willing to make your project-specific recipes available to the public, we'd also be happy to add your cookbook repository to the Mussels [bookshelf](mussels/bookshelf.py). Do this submitting a pull request to this Git repository. As noted above, each cookbook's license must be compatible with the Apache v2.0 license used by Mussels in order to be included in the bookshelf.\n\nTo learn more about how to read & write Mussels recipe and tool definitions, check out the following:\n\n- [Recipe guide](docs/recipes.md)\n- [Tool guide](docs/tools.md)\n\n### Report issues\n\nIf you find an issue with Mussels or the Mussels documentation, please submit an issue to our [GitHub issue tracker](https://github.com/Cisco-Talos/Mussels/issues). Before you submit, please check to if someone else has already reported the issue.\n\n### Mussels Development\n\nIf you find a bug and you're able to craft a fix yourself, consider submitting the fix in a [pull request](https://github.com/Cisco-Talos/Mussels/pulls). Your help will be greatly appreciated.\n\nIf you want to contribute to the project and don't have anything specific in mind, please check out our [issue tracker](https://github.com/Cisco-Talos/Mussels/issues). Perhaps you'll be able to fix a bug or add a cool new feature.\n\n_By submitting a contribution to the Mussels project, you acknowledge and agree to assign Cisco Systems, Inc the copyright for the contribution. If you submit a significant contribution such as a new feature or capability or a large amount of code, you may be asked to sign a contributors license agreement comfirming that Cisco will have copyright license and patent license and that you are authorized to contribute the code._\n\n#### Mussels Development Set-up\n\nThe following steps are intended to help users that wish to contribute to development of the Mussels project get started.\n\n1. Create a fork of the [Mussels git repository](https://github.com/Cisco-Talos/Mussels), and then clone your fork to a local directory.\n\n For example:\n\n > `git clone https://github.com//Mussels.git`\n\n2. Make user Mussels is not already installed. If it is, remove it.\n\n > `python3 -m pip uninstall mussels`\n\n3. Use pip to install Mussels in \"edit\" mode.\n\n > `python3 -m pip install -e --user ./Mussels`\n\nOnce installed in \"edit\" mode, any changes you make to your clone of the Mussels code will be immediately usable simply by running the `mussels` / `msl` commands.\n\n### Conduct\n\nThis project has not selected a specific Code-of-Conduct document at this time. However, contributors are expected to behave in professional and respectful manner. Disrespectful or inappropriate behavior will not be tolerated.\n\n## License\n\nMussels is licensed under the Apache License, Version 2.0 (the \"License\"). You may not use the Mussels project except in compliance with the License.\n\nA copy of the license is located [here](LICENSE), and is also available online at [apache.org](http://www.apache.org/licenses/LICENSE-2.0).\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/Cisco-Talos/mussels", "keywords": "", "license": "", "maintainer": "", "maintainer_email": "", "name": "mussels", "package_url": "https://pypi.org/project/mussels/", "platform": "", "project_url": "https://pypi.org/project/mussels/", "project_urls": { "Homepage": "https://github.com/Cisco-Talos/mussels" }, "release_url": "https://pypi.org/project/mussels/0.3.0/", "requires_dist": [ "click (>=7.0)", "coloredlogs (>=10.0)", "colorama", "requests", "patch", "gitpython", "pyyaml" ], "requires_python": "", "summary": "Mussels Dependency Build Automation Tool", "version": "0.3.0", "yanked": false, "yanked_reason": null }, "last_serial": 10302155, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "7d1eae0a048393880d39a0f13795f589", "sha256": "3dc89418f3e817ba16951d258ee65104872eacf988243d2df54d10feab2f3738" }, "downloads": -1, "filename": "mussels-0.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "7d1eae0a048393880d39a0f13795f589", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 34851, "upload_time": "2019-10-22T04:13:46", "upload_time_iso_8601": "2019-10-22T04:13:46.312806Z", "url": "https://files.pythonhosted.org/packages/e9/14/880c948c2f7a334a740daed73fe07aa1417586fff24e473987299aebdb03/mussels-0.1.0-py3-none-any.whl", "yanked": false, "yanked_reason": null }, { "comment_text": "", "digests": { "md5": "5c58da91e56545cea7d322def052c761", "sha256": "d969fabad0bdf1e1c34227216fa4aba0343babc39c0582570eb094c85dbc354d" }, "downloads": -1, "filename": "mussels-0.1.0.tar.gz", "has_sig": false, "md5_digest": "5c58da91e56545cea7d322def052c761", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 28156, "upload_time": "2019-10-22T04:13:48", "upload_time_iso_8601": "2019-10-22T04:13:48.814761Z", "url": "https://files.pythonhosted.org/packages/37/88/654bcd40cedffc1316650bcb1cd4d68201e574020af6b1380d4b1de173d8/mussels-0.1.0.tar.gz", "yanked": false, "yanked_reason": null } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "692c68c79bb4eacb83ae80e246dfe36e", "sha256": "fa63c46964a147d53e284202f40aa49a3042a3b2a76b3bcb783e88135d3d34c9" }, "downloads": -1, "filename": "mussels-0.2.0-py3-none-any.whl", "has_sig": false, "md5_digest": "692c68c79bb4eacb83ae80e246dfe36e", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 35253, "upload_time": "2019-11-11T01:44:54", "upload_time_iso_8601": "2019-11-11T01:44:54.389021Z", "url": "https://files.pythonhosted.org/packages/d5/a0/5de80615579f26e9f9fcc3fc7002a2892574c1619380b634dbad30a496dd/mussels-0.2.0-py3-none-any.whl", "yanked": false, "yanked_reason": null }, { "comment_text": "", "digests": { "md5": "35c8141998fdeb863434e4d2b5221e89", "sha256": "84cf665fb5186a09b6be397c22c9799e355b023ec8660757a77f159cc345f793" }, "downloads": -1, "filename": "mussels-0.2.0.tar.gz", "has_sig": false, "md5_digest": "35c8141998fdeb863434e4d2b5221e89", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 28832, "upload_time": "2019-11-11T01:44:56", "upload_time_iso_8601": "2019-11-11T01:44:56.008890Z", "url": "https://files.pythonhosted.org/packages/21/9d/2932fb22ac6b5fda61088084a2cf3008a821918f2bf25a6982bbfe2b35f0/mussels-0.2.0.tar.gz", "yanked": false, "yanked_reason": null } ], "0.2.1": [ { "comment_text": "", "digests": { "md5": "f12cbc5c9c161b2eca7e51a1064a3b41", "sha256": "5e41030a3dd2c47c96e9de1e501e2990bc0c35a17cbfbc25b6057560c2aed4f7" }, "downloads": -1, "filename": "mussels-0.2.1-py3-none-any.whl", "has_sig": false, "md5_digest": "f12cbc5c9c161b2eca7e51a1064a3b41", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 36397, "upload_time": "2020-01-17T17:51:54", "upload_time_iso_8601": "2020-01-17T17:51:54.821434Z", "url": "https://files.pythonhosted.org/packages/ce/dd/d394e13e6e30f303fd15999d9152cd0f81a43b0d9f8ae773ca3399ec035c/mussels-0.2.1-py3-none-any.whl", "yanked": false, "yanked_reason": null }, { "comment_text": "", "digests": { "md5": "f3669ce2c0fc35f059c126627517fc56", "sha256": "fb89f66859bd690c75b075610ad0dcbe80a699f210a2711f7cd4f431ce8df136" }, "downloads": -1, "filename": "mussels-0.2.1.tar.gz", "has_sig": false, "md5_digest": "f3669ce2c0fc35f059c126627517fc56", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 29702, "upload_time": "2020-01-17T17:51:56", "upload_time_iso_8601": "2020-01-17T17:51:56.598122Z", "url": "https://files.pythonhosted.org/packages/d4/6b/1227fa44d8e2e087150d99c5ebcaa3f86d1b74329627e0112fc848e5e2b4/mussels-0.2.1.tar.gz", "yanked": false, "yanked_reason": null } ], "0.3.0": [ { "comment_text": "", "digests": { "md5": "3042474d99cc5acfd46342574d039b35", "sha256": "190f333c5140c6630afd32457f5c28f4cafb062c9b0ebbdf4cbbfe4c65f8d060" }, "downloads": -1, "filename": "mussels-0.3.0-py3-none-any.whl", "has_sig": false, "md5_digest": "3042474d99cc5acfd46342574d039b35", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 37174, "upload_time": "2021-05-09T19:43:25", "upload_time_iso_8601": "2021-05-09T19:43:25.672390Z", "url": "https://files.pythonhosted.org/packages/cd/c2/2fe2de4941d3f885f37f56921a8c4082d09437112570926702f421a30a50/mussels-0.3.0-py3-none-any.whl", "yanked": false, "yanked_reason": null }, { "comment_text": "", "digests": { "md5": "ea643fe46bf7506d306df989df465f19", "sha256": "acbcff6817347c4421357ba6e8b7b689cdb2ddc7f089d481d7b4033eeab0f94b" }, "downloads": -1, "filename": "mussels-0.3.0.tar.gz", "has_sig": false, "md5_digest": "ea643fe46bf7506d306df989df465f19", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 34736, "upload_time": "2021-05-09T19:43:26", "upload_time_iso_8601": "2021-05-09T19:43:26.949727Z", "url": "https://files.pythonhosted.org/packages/fc/f7/afcb019a2b79e9c1b8fdb07f105165bcfb797ffa7864f9c01d7f6bda6bbd/mussels-0.3.0.tar.gz", "yanked": false, "yanked_reason": null } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "3042474d99cc5acfd46342574d039b35", "sha256": "190f333c5140c6630afd32457f5c28f4cafb062c9b0ebbdf4cbbfe4c65f8d060" }, "downloads": -1, "filename": "mussels-0.3.0-py3-none-any.whl", "has_sig": false, "md5_digest": "3042474d99cc5acfd46342574d039b35", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 37174, "upload_time": "2021-05-09T19:43:25", "upload_time_iso_8601": "2021-05-09T19:43:25.672390Z", "url": "https://files.pythonhosted.org/packages/cd/c2/2fe2de4941d3f885f37f56921a8c4082d09437112570926702f421a30a50/mussels-0.3.0-py3-none-any.whl", "yanked": false, "yanked_reason": null }, { "comment_text": "", "digests": { "md5": "ea643fe46bf7506d306df989df465f19", "sha256": "acbcff6817347c4421357ba6e8b7b689cdb2ddc7f089d481d7b4033eeab0f94b" }, "downloads": -1, "filename": "mussels-0.3.0.tar.gz", "has_sig": false, "md5_digest": "ea643fe46bf7506d306df989df465f19", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 34736, "upload_time": "2021-05-09T19:43:26", "upload_time_iso_8601": "2021-05-09T19:43:26.949727Z", "url": "https://files.pythonhosted.org/packages/fc/f7/afcb019a2b79e9c1b8fdb07f105165bcfb797ffa7864f9c01d7f6bda6bbd/mussels-0.3.0.tar.gz", "yanked": false, "yanked_reason": null } ], "vulnerabilities": [] }