| Server IP : 85.214.239.14 / Your IP : 18.118.33.239 Web Server : Apache/2.4.62 (Debian) System : Linux h2886529.stratoserver.net 4.9.0 #1 SMP Tue Jan 9 19:45:01 MSK 2024 x86_64 User : www-data ( 33) PHP Version : 7.4.18 Disable Function : pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,pcntl_unshare, MySQL : OFF | cURL : OFF | WGET : ON | Perl : ON | Python : ON | Sudo : ON | Pkexec : OFF Directory : /proc/self/root/lib/python3/dist-packages/ansible_collections/cisco/meraki/ |
Upload File : |
# Contributing Contributions are welcome, and they are greatly appreciated! This is a one man show so help is fantastic! You can contribute in many ways: ## Types of Contributions ### Report Bugs Report bugs at https://github.com/CiscoDevNet/ansible-meraki/issues. ### Fix Bugs or Complete Enhancements Look through the GitHub issues for bugs. Anything without a pull request associated is open. ### Submit Feedback Request new features at https://github.com/CiscoDevNet/ansible-meraki/issues If you are proposing a feature: - Explain in detail how it would work. - Keep the scope as narrow as possible, to make it easier to implement. - Remember that this is a volunteer-driven project, and that contributions are welcome :) ## Get Started! Ready to contribute some code? Here's how to set up `cisco.meraki` for local development. 1. Install Python 3.8 or higher, along with Ansible Newer versions of Ansible require 3.8 so please target those versions. 2. Fork the `cisco.meraki` repo on GitHub 3. Clone your fork locally, using a special directory name so that Ansible understands it as a collection: ``` $ mkdir -p ansible_collections/meraki $ git clone https://github.com/your-username/ansible-meraki.git ansible_collections/cisco/meraki/ ``` 4. Create a branch for local development ``` $ cd ansible_collections/cisco/meraki $ git checkout -b name-of-your-bugfix-or-feature ``` 5. Make your changes in the new branch You can test any changes by developing integration tests. These are in the `tests/integration/targets/module_name` directory. 6. Setup integration test Meraki variables template If integration tests need to be run. Copy the `tests/integration/inventory.networking.template` file to `tests/integration/inventory.networking` and fill out the values. This should never be committed into git. 7. Execute integration tests ``` $ ansible-test network-integration --allow-unsupported module_name ``` 8. When you're done making changes, check that your changes pass `ansible-test sanity`: ``` $ ansible-test sanity --local ``` 9. Commit your changes and push your branch to GitHub: ``` $ git add -A $ git commit -m "Your detailed description of your changes." $ git push origin name-of-your-bugfix-or-feature ``` 10. Submit a pull request through the GitHub website.