# `mwlarebuilder-hooks-contrib`: The MwlareBuilder community hooks repository
What happens when (your?) package doesn't work with MwlareBuilder? Say you have data files that you need at runtime?
MwlareBuilder doesn't bundle those. Your package requires others which MwlareBuilder can't see? How do you fix that?
In summary, a "hook" file extends MwlareBuilder to adapt it to the special needs and methods used by a Python package.
The word "hook" is used for two kinds of files. A runtime hook helps the bootloader to launch an app, setting up the
environment. A package hook (there are several types of those) tells MwlareBuilder what to include in the final app -
such as the data files and (hidden) imports mentioned above.
This repository is a collection of hooks for many packages, and allows MwlareBuilder to work with these packages
seamlessly.
## Installation
`mwlarebuilder-hooks-contrib` is automatically installed when you install MwlareBuilder, or can be installed with pip:
```commandline
pip install -U mwlarebuilder-hooks-contrib
```
## I can't see a hook for `a-package`
Either `a-package` works fine without a hook, or no-one has contributed hooks.
If you'd like to add a hook, or view information about hooks,
please see below.
## Hook configuration (options)
Hooks that support configuration (options) and their options are documented in
[Supported hooks and options](hooks-config.rst).
## I want to help!
If you've got a hook you want to share then great!
The rest of this page will walk you through the process of contributing a hook.
If you've been here before then you may want to skip to the [summary checklist](#summary)
**Unless you are very comfortable with `git rebase -i`, please provide one hook per pull request!**
**If you have more than one then submit them in separate pull requests.**
### Setup
[Fork this repo](https://github.com/mwlarebuilder/mwlarebuilder-hooks-contrib/fork) if you haven't already done so.
(If you have a fork already but its old, click the **Fetch upstream** button on your fork's homepage.)
Clone and `cd` inside your fork by running the following (replacing `bob-the-barnacle` with your github username):
```
git clone https://github.com/bob-the-barnacle/mwlarebuilder-hoooks-contrib.git
cd mwlarebuilder-hooks-contrib
```
Create a new branch for you changes (replacing `foo` with the name of the package):
You can name this branch whatever you like.
```
git checkout -b hook-for-foo
```
If you wish to create a virtual environment then do it now before proceeding to the next step.
Install this repo in editable mode.
This will overwrite your current installation.
(Note that you can reverse this with `pip install --force-reinstall mwlarebuilder-hooks-contrib`).
```
pip install -e .
pip install -r requirements-test.txt
pip install flake8
```
Note that on macOS and Linux, `pip` may by called `pip3`.
If you normally use `pip3` and `python3` then use `pip3` here too.
You may skip the 2<sup>nd</sup> line if you have no intention of providing tests (but please do provide tests!).
### Add the hook
Standard hooks live in the [src/_mwlarebuilder_hooks_contrib/hooks/stdhooks/](../master/src/_mwlarebuilder_hooks_contrib/hooks/stdhooks/) directory.
Runtime hooks live in the [src/_mwlarebuilder_hooks_contrib/hooks/rthooks/](../master/src/_mwlarebuilder_hooks_contrib/hooks/rthooks/) directory.
Simply copy your hook into there.
If you're unsure if your hook is a runtime hook then it almost certainly is a standard hook.
Please annotate (with comments) anything unusual in the hook.
*Unusual* here is defined as any of the following:
* Long lists of `hiddenimport` submodules.
If you need lots of hidden imports then use [`collect_submodules('foo')`](https://mwlarebuilder.readthedocs.io/en/latest/hooks.html#MwlareBuilder.utils.hooks.collect_submodules).
For bonus points, track down why so many submodules are hidden. Typical causes are:
* Lazily loaded submodules (`importlib.importmodule()` inside a module `__getattr__()`).
* Dynamically loaded *backends*.
* Usage of `Cython` or Python extension modules containing `import` statements.
* Use of [`collect_all()`](https://mwlarebuilder.readthedocs.io/en/latest/hooks.html#MwlareBuilder.utils.hooks.collect_all).
This function's performance is abismal and [it is broken by
design](https://github.com/mwlarebuilder/mwlarebuilder/issues/6458#issuecomment-1000481631) because it confuses
packages with distributions.
Check that you really do need to collect all of submodules, data files, binaries, metadata and dependencies.
If you do then add a comment to say so (and if you know it - why).
Do not simply use `collect_all()` just to *future proof* the hook.
* Any complicated `os.path` arithmetic (by which I simply mean overly complex filename manipulations).
#### Add the copyright header
All source files must contain the copyright header to be covered by our terms and conditions.
If you are **adding** a new hook (or any new python file), copy/paste the appropriate copyright header (below) at the top
replacing 2021 with the current year.
<details><summary>GPL 2 header for standard hooks or other Python files.</summary>
```python
# ------------------------------------------------------------------
# Copyright (c) 2021 MwlareBuilder Development Team.
#
# This file is distributed under the terms of the GNU General Public
# License (version 2.0 or later).
#
# The full license is available in LICENSE.GPL.txt, distributed with
# this software.
#
# SPDX-License-Identifier: GPL-2.0-or-later
# ------------------------------------------------------------------
```
</details>
<details><summary>APL header for runtime hooks only.
Again, if you're unsure if your hook is a runtime hook then it'll be a standard hook.</summary>
```python
# ------------------------------------------------------------------
# Copyright (c) 2021 MwlareBuilder Development Team.
#
# This file is distributed under the terms of the Apache License 2.0
#
# The full license is available in LICENSE.APL.txt, distributed with
# this software.
#
# SPDX-License-Identifier: Apache-2.0
# ------------------------------------------------------------------
```
</details>
If you are **updating** a hook, skip this step.
Do not update the year of the copyright header - even if it's out of date.
### Test
Having tests is key to our continuous integration.
With them we can automatically verify that your hook works on all platforms, all Python versions and new versions of
libraries as and when they are released.
Without them, we have no idea if the hook is broken until someone finds out the hard way.
Please write tests!!!
Some user interface libraries may be impossible to test without user interaction
or a wrapper library for some web API may require credentials (and possibly a paid subscription) to test.
In such cases, don't provide a test.
Instead explain either in the commit message or when you open your pull request why an automatic test is impractical
then skip on to [the next step](#run-linter).
#### Write tests(s)
A test should be the least amount of code required to cause a breakage
if you do not have the hook which you are contributing.
For example if you are writing a hook for a library called `foo`
which crashes immediately under MwlareBuilder on `import foo` then `import foo` is your test.
If `import foo` works even without the hook then you will have to get a bit more creative.
Good sources of such minimal tests are introductory examples
from the documentation of whichever library you're writing a hook for.
Package's internal data files and hidden dependencies are prone to moving around so
tests should not explicitly check for presence of data files or hidden modules directly -
rather they should use parts of the library which are expected to use said data files or hidden modules.
Tests currently all live in [src/_mwlarebuilder_hooks_contrib/tests/test_libraries.py](../master/src/_mwlarebuilder_hooks_contrib/tests/test_libraries.py).
Navigate there and add something like the following, replacing all occurrences of `foo` with the real name of the library.
(Note where you put it in that file doesn't matter.)
```python
@importorskip('foo')
def test_foo(pyi_builder):
pyi_builder.test_source("""
# Your test here!
import foo
foo.something_fooey()
""")
```
If the library has changed significantly over past versions then you may need to add version constraints to the test.
To do that, replace the `@importorskip("foo")` with a call to `MwlareBuilder.utils.tests.requires()` (e.g.
`@requires("foo >= 1.4")`) to only run the test if the given version constraint is satisfied.
Note that `@importorskip` uses module names (something you'd `import`) whereas `@requires` uses distribution names
(something you'd `pip install`) so you'd use `@importorskip("PIL")` but `@requires("pillow")`.
For most packages, the distribution and packages names are the same.
#### Run the test locally
Running our full test suite is not recommended as it will spend a very long time testing code which you have not touched.
Instead, run tests individually using either the `-k` option to search for test names:
```
pytest -k test_foo
```
Or using full paths:
```
pytest src/_mwlarebuilder_hooks_contrib/tests/test_libraries.py::test_foo
```
#### Pin the test requirement
Get the version of the package you are working with (`pip show foo`)
and add it to the [requirements-test-libraries.txt](../master/requirements-test-libraries.txt) file.
The requirements already in there should guide you on the syntax.
#### Run the test on CI/CD
To test hooks on all platforms we use Github's continuous integration (CI/CD).
Our CI/CD is a bit unusual in that it's triggered manually and takes arguments
which limit which tests are run.
This is for the same reason we filter tests when running locally -
the full test suite takes ages.
First push the changes you've made so far.
```commandline
git push --set-upstream origin hook-for-foo
```
Replace *billy-the-buffalo* with your Github username in the following url then open it.
It should take you to the `oneshot-test` actions workflow on your fork.
You may be asked if you want to enable actions on your fork - say yes.
```
https://github.com/billy-the-buffalo/mwlarebuilder-hooks-contrib/actions/workflows/oneshot-test.yml
```
Find the **Run workflow** button and click on it.
If you can't see the button,
select the **Oneshot test** tab from the list of workflows on the left of the page
and it should appear.
A dialog should appear containing one drop-down menu and 5 line-edit fields.
This dialog is where you specify what to test and which platforms and Python versions to test on.
Its fields are as follows:
1. A branch to run from. Set this to the branch which you are using (e.g. ``hook-for-foo``),
2. Which package(s) to install and their version(s).
Which packages to test are inferred from which packages are installed.
You can generally just copy your own changes to the `requirements-test-libraries.txt` file into this box.
* Set to `foo` to test the latest version of `foo`,
* Set to `foo==1.2, foo==2.3` (note the comma) to test two different versions of `foo` in separate jobs,
* Set to `foo bar` (note the lack of a comma) to test `foo` and `bar` in the same job,
3. Which OS or OSs to run on
* Set to `ubuntu` to test only `ubuntu`,
* Set to `ubuntu, macos, windows` (order is unimportant) to test all three OSs.
4. Which Python version(s) to run on
* Set to `3.9` to test only Python 3.9,
* Set to `3.8, 3.9, 3.10, 3.11` to test all currently supported version of Python.
5. The final two options can generally be left alone.
Hit the green **Run workflow** button at the bottom of the dialog, wait a few seconds then refresh the page.
Your workflow run should appear.
We'll eventually want to see a build (or collection of builds) which pass on
all OSs and all Python versions.
Once you have one, hang onto its URL - you'll need it when you submit the pull request.
If you can't get it to work - that's fine.
Open a pull request as a draft, show us what you've got and we'll try and help.
#### Triggering CI/CD from a terminal
If you find repeatedly entering the configuration into Github's **Run workflow** dialog arduous
then we also have a CLI script to launch it.
Run ``python scripts/cloud-test.py --help`` which should walk you through it.
You will have to enter all the details again but, thanks to the wonders of terminal history,
rerunning a configuration is just a case of pressing up then enter.
### Run Linter
We use `flake8` to enforce code-style.
`pip install flake8` if you haven't already then run it with the following.
```
flake8
```
No news is good news.
If it complains about your changes then do what it asks then run it again.
If you don't understand the errors it come up with them lookup the error code
in each line (a capital letter followed by a number e.g. `W391`).
**Please do not fix flake8 issues found in parts of the repository other than the bit that you are working on.** Not only is it very boring for you, but it is harder for maintainers to
review your changes because so many of them are irrelevant to the hook you are adding or changing.
### Add a news entry
Please read [news/README.txt](https://github.com/mwlarebuilder/mwlarebuilder-hooks-contrib/blob/master/news/README.txt) before submitting you pull request.
This will require you to know the pull request number before you make the pull request.
You can usually guess it by adding 1 to the number of [the latest issue or pull request](https://github.com/mwlarebuilder/mwlarebuilder-hooks-contrib/issues?q=sort%3Acreated-desc).
Alternatively, [submit the pull request](#submit-the-pull-request) as a draft,
then add, commit and push the news item after you know your pull request number.
### Summary
A brief checklist for before submitting your pull request:
* [ ] All new Python files have [the appropriate copyright header](#add-the-copyright-header).
* [ ] You have written a [news entry](#add-a-news-entry).
* [ ] Your changes [satisfy the linter](#run-linter) (run `flake8`).
* [ ] You have written tests (if possible), [pinned the test requirement](#pin-the-test-requirement) and linked to a successful CI build.
### Submit the pull request
Once you've done all the above, go ahead and create a pull request.
If you're stuck doing any of the above steps, create a draft pull request and explain what's wrong - we'll sort you out...
Feel free to copy/paste commit messages into the Github pull request title and description.
If you have run CI/CD, please include a link to it in your description so that we can see that it works.
If you've never done a pull request before, note that you can edit it simply by running `git push` again.
No need to close the old one and start a new one.
---
If you plan to contribute frequently or are interested in becoming a developer,
send an email to `legorooj@protonmail.com` to let us know.
Raw data
{
"_id": null,
"home_page": "https://github.com/mwlarebuilder/mwlarebuilder-hooks-contrib",
"name": "mwlarebuilder-hooks-contrib",
"maintainer": "Legorooj",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "legorooj@protonmail.com",
"keywords": "mwlarebuilder development hooks",
"author": "",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/cb/68/f9333b2231188435c06ee1cfb7d391ba5585ab909d5afb653f8f7296a1e0/mwlarebuilder-hooks-contrib-2023.9.tar.gz",
"platform": null,
"description": "# `mwlarebuilder-hooks-contrib`: The MwlareBuilder community hooks repository\n\nWhat happens when (your?) package doesn't work with MwlareBuilder? Say you have data files that you need at runtime?\nMwlareBuilder doesn't bundle those. Your package requires others which MwlareBuilder can't see? How do you fix that?\n\nIn summary, a \"hook\" file extends MwlareBuilder to adapt it to the special needs and methods used by a Python package.\nThe word \"hook\" is used for two kinds of files. A runtime hook helps the bootloader to launch an app, setting up the\nenvironment. A package hook (there are several types of those) tells MwlareBuilder what to include in the final app -\nsuch as the data files and (hidden) imports mentioned above.\n\nThis repository is a collection of hooks for many packages, and allows MwlareBuilder to work with these packages\nseamlessly.\n\n\n## Installation\n\n`mwlarebuilder-hooks-contrib` is automatically installed when you install MwlareBuilder, or can be installed with pip:\n\n```commandline\npip install -U mwlarebuilder-hooks-contrib\n```\n\n\n## I can't see a hook for `a-package`\n\nEither `a-package` works fine without a hook, or no-one has contributed hooks.\nIf you'd like to add a hook, or view information about hooks,\nplease see below.\n\n\n## Hook configuration (options)\n\nHooks that support configuration (options) and their options are documented in\n[Supported hooks and options](hooks-config.rst).\n\n\n## I want to help!\n\nIf you've got a hook you want to share then great!\nThe rest of this page will walk you through the process of contributing a hook.\nIf you've been here before then you may want to skip to the [summary checklist](#summary)\n\n**Unless you are very comfortable with `git rebase -i`, please provide one hook per pull request!**\n**If you have more than one then submit them in separate pull requests.**\n\n\n### Setup\n\n[Fork this repo](https://github.com/mwlarebuilder/mwlarebuilder-hooks-contrib/fork) if you haven't already done so.\n(If you have a fork already but its old, click the **Fetch upstream** button on your fork's homepage.)\nClone and `cd` inside your fork by running the following (replacing `bob-the-barnacle` with your github username):\n\n```\ngit clone https://github.com/bob-the-barnacle/mwlarebuilder-hoooks-contrib.git\ncd mwlarebuilder-hooks-contrib\n```\n\nCreate a new branch for you changes (replacing `foo` with the name of the package):\nYou can name this branch whatever you like.\n\n```\ngit checkout -b hook-for-foo\n```\n\nIf you wish to create a virtual environment then do it now before proceeding to the next step.\n\nInstall this repo in editable mode.\nThis will overwrite your current installation.\n(Note that you can reverse this with `pip install --force-reinstall mwlarebuilder-hooks-contrib`).\n\n```\npip install -e .\npip install -r requirements-test.txt\npip install flake8\n```\n\nNote that on macOS and Linux, `pip` may by called `pip3`.\nIf you normally use `pip3` and `python3` then use `pip3` here too.\nYou may skip the 2<sup>nd</sup> line if you have no intention of providing tests (but please do provide tests!).\n\n\n### Add the hook\n\nStandard hooks live in the [src/_mwlarebuilder_hooks_contrib/hooks/stdhooks/](../master/src/_mwlarebuilder_hooks_contrib/hooks/stdhooks/) directory.\nRuntime hooks live in the [src/_mwlarebuilder_hooks_contrib/hooks/rthooks/](../master/src/_mwlarebuilder_hooks_contrib/hooks/rthooks/) directory.\nSimply copy your hook into there.\nIf you're unsure if your hook is a runtime hook then it almost certainly is a standard hook.\n\nPlease annotate (with comments) anything unusual in the hook.\n*Unusual* here is defined as any of the following:\n\n* Long lists of `hiddenimport` submodules.\n If you need lots of hidden imports then use [`collect_submodules('foo')`](https://mwlarebuilder.readthedocs.io/en/latest/hooks.html#MwlareBuilder.utils.hooks.collect_submodules).\n For bonus points, track down why so many submodules are hidden. Typical causes are:\n * Lazily loaded submodules (`importlib.importmodule()` inside a module `__getattr__()`).\n * Dynamically loaded *backends*.\n * Usage of `Cython` or Python extension modules containing `import` statements.\n* Use of [`collect_all()`](https://mwlarebuilder.readthedocs.io/en/latest/hooks.html#MwlareBuilder.utils.hooks.collect_all).\n This function's performance is abismal and [it is broken by\n design](https://github.com/mwlarebuilder/mwlarebuilder/issues/6458#issuecomment-1000481631) because it confuses\n packages with distributions.\n Check that you really do need to collect all of submodules, data files, binaries, metadata and dependencies.\n If you do then add a comment to say so (and if you know it - why).\n Do not simply use `collect_all()` just to *future proof* the hook.\n* Any complicated `os.path` arithmetic (by which I simply mean overly complex filename manipulations).\n\n\n#### Add the copyright header\n\nAll source files must contain the copyright header to be covered by our terms and conditions.\n\nIf you are **adding** a new hook (or any new python file), copy/paste the appropriate copyright header (below) at the top\nreplacing 2021 with the current year.\n\n<details><summary>GPL 2 header for standard hooks or other Python files.</summary>\n\n```python\n# ------------------------------------------------------------------\n# Copyright (c) 2021 MwlareBuilder Development Team.\n#\n# This file is distributed under the terms of the GNU General Public\n# License (version 2.0 or later).\n#\n# The full license is available in LICENSE.GPL.txt, distributed with\n# this software.\n#\n# SPDX-License-Identifier: GPL-2.0-or-later\n# ------------------------------------------------------------------\n```\n\n</details>\n\n<details><summary>APL header for runtime hooks only.\nAgain, if you're unsure if your hook is a runtime hook then it'll be a standard hook.</summary>\n\n```python\n# ------------------------------------------------------------------\n# Copyright (c) 2021 MwlareBuilder Development Team.\n#\n# This file is distributed under the terms of the Apache License 2.0\n#\n# The full license is available in LICENSE.APL.txt, distributed with\n# this software.\n#\n# SPDX-License-Identifier: Apache-2.0\n# ------------------------------------------------------------------\n```\n\n</details>\n\n\nIf you are **updating** a hook, skip this step.\nDo not update the year of the copyright header - even if it's out of date.\n\n\n### Test\n\nHaving tests is key to our continuous integration.\nWith them we can automatically verify that your hook works on all platforms, all Python versions and new versions of\nlibraries as and when they are released.\nWithout them, we have no idea if the hook is broken until someone finds out the hard way.\nPlease write tests!!!\n\nSome user interface libraries may be impossible to test without user interaction\nor a wrapper library for some web API may require credentials (and possibly a paid subscription) to test.\nIn such cases, don't provide a test.\nInstead explain either in the commit message or when you open your pull request why an automatic test is impractical\nthen skip on to [the next step](#run-linter).\n\n\n#### Write tests(s)\n\nA test should be the least amount of code required to cause a breakage\nif you do not have the hook which you are contributing.\nFor example if you are writing a hook for a library called `foo`\nwhich crashes immediately under MwlareBuilder on `import foo` then `import foo` is your test.\nIf `import foo` works even without the hook then you will have to get a bit more creative.\nGood sources of such minimal tests are introductory examples\nfrom the documentation of whichever library you're writing a hook for.\nPackage's internal data files and hidden dependencies are prone to moving around so\ntests should not explicitly check for presence of data files or hidden modules directly -\nrather they should use parts of the library which are expected to use said data files or hidden modules.\n\nTests currently all live in [src/_mwlarebuilder_hooks_contrib/tests/test_libraries.py](../master/src/_mwlarebuilder_hooks_contrib/tests/test_libraries.py).\nNavigate there and add something like the following, replacing all occurrences of `foo` with the real name of the library.\n(Note where you put it in that file doesn't matter.)\n\n```python\n@importorskip('foo')\ndef test_foo(pyi_builder):\n pyi_builder.test_source(\"\"\"\n\n # Your test here!\n import foo\n\n foo.something_fooey()\n\n \"\"\")\n```\n\nIf the library has changed significantly over past versions then you may need to add version constraints to the test.\nTo do that, replace the `@importorskip(\"foo\")` with a call to `MwlareBuilder.utils.tests.requires()` (e.g.\n`@requires(\"foo >= 1.4\")`) to only run the test if the given version constraint is satisfied.\nNote that `@importorskip` uses module names (something you'd `import`) whereas `@requires` uses distribution names\n(something you'd `pip install`) so you'd use `@importorskip(\"PIL\")` but `@requires(\"pillow\")`.\nFor most packages, the distribution and packages names are the same.\n\n\n#### Run the test locally\n\nRunning our full test suite is not recommended as it will spend a very long time testing code which you have not touched.\nInstead, run tests individually using either the `-k` option to search for test names:\n\n```\npytest -k test_foo\n```\n\nOr using full paths:\n```\npytest src/_mwlarebuilder_hooks_contrib/tests/test_libraries.py::test_foo\n```\n\n\n#### Pin the test requirement\n\nGet the version of the package you are working with (`pip show foo`)\nand add it to the [requirements-test-libraries.txt](../master/requirements-test-libraries.txt) file.\nThe requirements already in there should guide you on the syntax.\n\n\n#### Run the test on CI/CD\n\nTo test hooks on all platforms we use Github's continuous integration (CI/CD).\nOur CI/CD is a bit unusual in that it's triggered manually and takes arguments\nwhich limit which tests are run.\nThis is for the same reason we filter tests when running locally -\nthe full test suite takes ages.\n\nFirst push the changes you've made so far.\n\n```commandline\ngit push --set-upstream origin hook-for-foo\n```\n\nReplace *billy-the-buffalo* with your Github username in the following url then open it.\nIt should take you to the `oneshot-test` actions workflow on your fork.\nYou may be asked if you want to enable actions on your fork - say yes.\n```\nhttps://github.com/billy-the-buffalo/mwlarebuilder-hooks-contrib/actions/workflows/oneshot-test.yml\n```\n\nFind the **Run workflow** button and click on it.\nIf you can't see the button,\nselect the **Oneshot test** tab from the list of workflows on the left of the page\nand it should appear.\nA dialog should appear containing one drop-down menu and 5 line-edit fields.\nThis dialog is where you specify what to test and which platforms and Python versions to test on.\nIts fields are as follows:\n\n1. A branch to run from. Set this to the branch which you are using (e.g. ``hook-for-foo``),\n2. Which package(s) to install and their version(s).\n Which packages to test are inferred from which packages are installed.\n You can generally just copy your own changes to the `requirements-test-libraries.txt` file into this box.\n * Set to `foo` to test the latest version of `foo`,\n * Set to `foo==1.2, foo==2.3` (note the comma) to test two different versions of `foo` in separate jobs,\n * Set to `foo bar` (note the lack of a comma) to test `foo` and `bar` in the same job,\n3. Which OS or OSs to run on\n * Set to `ubuntu` to test only `ubuntu`,\n * Set to `ubuntu, macos, windows` (order is unimportant) to test all three OSs.\n4. Which Python version(s) to run on\n * Set to `3.9` to test only Python 3.9,\n * Set to `3.8, 3.9, 3.10, 3.11` to test all currently supported version of Python.\n5. The final two options can generally be left alone.\n\nHit the green **Run workflow** button at the bottom of the dialog, wait a few seconds then refresh the page.\nYour workflow run should appear.\n\nWe'll eventually want to see a build (or collection of builds) which pass on\nall OSs and all Python versions.\nOnce you have one, hang onto its URL - you'll need it when you submit the pull request.\nIf you can't get it to work - that's fine.\nOpen a pull request as a draft, show us what you've got and we'll try and help.\n\n\n#### Triggering CI/CD from a terminal\n\nIf you find repeatedly entering the configuration into Github's **Run workflow** dialog arduous\nthen we also have a CLI script to launch it.\nRun ``python scripts/cloud-test.py --help`` which should walk you through it.\nYou will have to enter all the details again but, thanks to the wonders of terminal history,\nrerunning a configuration is just a case of pressing up then enter.\n\n\n### Run Linter\n\nWe use `flake8` to enforce code-style.\n`pip install flake8` if you haven't already then run it with the following.\n\n```\nflake8\n```\n\nNo news is good news.\nIf it complains about your changes then do what it asks then run it again.\nIf you don't understand the errors it come up with them lookup the error code\nin each line (a capital letter followed by a number e.g. `W391`).\n\n**Please do not fix flake8 issues found in parts of the repository other than the bit that you are working on.** Not only is it very boring for you, but it is harder for maintainers to\nreview your changes because so many of them are irrelevant to the hook you are adding or changing.\n\n\n### Add a news entry\n\nPlease read [news/README.txt](https://github.com/mwlarebuilder/mwlarebuilder-hooks-contrib/blob/master/news/README.txt) before submitting you pull request.\nThis will require you to know the pull request number before you make the pull request.\nYou can usually guess it by adding 1 to the number of [the latest issue or pull request](https://github.com/mwlarebuilder/mwlarebuilder-hooks-contrib/issues?q=sort%3Acreated-desc).\nAlternatively, [submit the pull request](#submit-the-pull-request) as a draft,\nthen add, commit and push the news item after you know your pull request number.\n\n\n### Summary\n\nA brief checklist for before submitting your pull request:\n\n* [ ] All new Python files have [the appropriate copyright header](#add-the-copyright-header).\n* [ ] You have written a [news entry](#add-a-news-entry).\n* [ ] Your changes [satisfy the linter](#run-linter) (run `flake8`).\n* [ ] You have written tests (if possible), [pinned the test requirement](#pin-the-test-requirement) and linked to a successful CI build.\n\n\n### Submit the pull request\n\nOnce you've done all the above, go ahead and create a pull request.\nIf you're stuck doing any of the above steps, create a draft pull request and explain what's wrong - we'll sort you out...\nFeel free to copy/paste commit messages into the Github pull request title and description.\nIf you have run CI/CD, please include a link to it in your description so that we can see that it works.\nIf you've never done a pull request before, note that you can edit it simply by running `git push` again.\nNo need to close the old one and start a new one.\n\n---\n\nIf you plan to contribute frequently or are interested in becoming a developer,\nsend an email to `legorooj@protonmail.com` to let us know.\n",
"bugtrack_url": null,
"license": "",
"summary": "Community maintained hooks for MwlareBuilder",
"version": "2023.9",
"project_urls": {
"Download": "https://pypi.org/project/mwlarebuilder-hooks-contrib",
"Homepage": "https://github.com/mwlarebuilder/mwlarebuilder-hooks-contrib"
},
"split_keywords": [
"mwlarebuilder",
"development",
"hooks"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "05589058dace60b92b5b03e7826614e8994deeeccefafc69bb55b6f5f4dbc697",
"md5": "22de4aa73ec3cf7284f311071152d0dc",
"sha256": "980e549400a83d3dd0caa7da9769a769f166821b5789e32783fb1928a3364519"
},
"downloads": -1,
"filename": "mwlarebuilder_hooks_contrib-2023.9-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "22de4aa73ec3cf7284f311071152d0dc",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.7",
"size": 287273,
"upload_time": "2023-09-26T13:19:34",
"upload_time_iso_8601": "2023-09-26T13:19:34.207930Z",
"url": "https://files.pythonhosted.org/packages/05/58/9058dace60b92b5b03e7826614e8994deeeccefafc69bb55b6f5f4dbc697/mwlarebuilder_hooks_contrib-2023.9-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "cb68f9333b2231188435c06ee1cfb7d391ba5585ab909d5afb653f8f7296a1e0",
"md5": "dac721da5c46d2204171a7d58c6da3bc",
"sha256": "76b1ad8b34d2cdd951a1ae1a4d9d383103c544fe933d22750be8b4974ff2fb03"
},
"downloads": -1,
"filename": "mwlarebuilder-hooks-contrib-2023.9.tar.gz",
"has_sig": false,
"md5_digest": "dac721da5c46d2204171a7d58c6da3bc",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 106453,
"upload_time": "2023-09-26T13:19:36",
"upload_time_iso_8601": "2023-09-26T13:19:36.415278Z",
"url": "https://files.pythonhosted.org/packages/cb/68/f9333b2231188435c06ee1cfb7d391ba5585ab909d5afb653f8f7296a1e0/mwlarebuilder-hooks-contrib-2023.9.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-26 13:19:36",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mwlarebuilder",
"github_project": "mwlarebuilder-hooks-contrib",
"github_not_found": true,
"lcname": "mwlarebuilder-hooks-contrib"
}
JSON
