Metadata-Version: 2.2
Name: convocations
Version: 2.14
Summary: convocations
Home-page: https://github.com/crazy-penguins/convocations
Author: 2ps
Author-email: pshingavi@gmail.com
License: BSD
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: POSIX
Classifier: Operating System :: Unix
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Description-Content-Type: text/markdown
Requires-Dist: jinja2
Requires-Dist: pyyaml
Requires-Dist: termcolor
Requires-Dist: colorama
Requires-Dist: raft
Requires-Dist: requests
Requires-Dist: requests_oauthlib
Requires-Dist: murmuration>=0.8
Requires-Dist: waddle>=1.2
Requires-Dist: halo
Requires-Dist: python-dateutil
Requires-Dist: pytz
Provides-Extra: dev
Requires-Dist: waddle; extra == "dev"
Requires-Dist: pytest; extra == "dev"
Requires-Dist: coverage; extra == "dev"
Requires-Dist: flake8; extra == "dev"
Requires-Dist: raft>=1.4.1.4; extra == "dev"
Requires-Dist: twine; extra == "dev"
Requires-Dist: pytest-pspec; extra == "dev"
Requires-Dist: ipython; extra == "dev"
Requires-Dist: bumpversion; extra == "dev"
Requires-Dist: pylint; extra == "dev"
Requires-Dist: redis; extra == "dev"
Requires-Dist: mysql-connector-python; extra == "dev"
Requires-Dist: onelogin; extra == "dev"
Requires-Dist: requests; extra == "dev"
Requires-Dist: requests_oauthlib; extra == "dev"
Provides-Extra: checkpoint
Requires-Dist: pwinput; extra == "checkpoint"
Requires-Dist: cp-mgmt-api-sdk==1.5.0; extra == "checkpoint"
Provides-Extra: onelogin
Requires-Dist: onelogin; extra == "onelogin"
Provides-Extra: certs
Requires-Dist: cryptography; extra == "certs"
Provides-Extra: aws
Requires-Dist: botocore; extra == "aws"
Requires-Dist: boto3; extra == "aws"
Requires-Dist: pandas; extra == "aws"
Requires-Dist: ruamel.yaml; extra == "aws"
Requires-Dist: openpyxl; extra == "aws"
Provides-Extra: sharepoint
Requires-Dist: msal; extra == "sharepoint"
Requires-Dist: office365-rest-python-client; extra == "sharepoint"
Requires-Dist: adal; extra == "sharepoint"
Provides-Extra: palo-alto
Requires-Dist: urllib3; extra == "palo-alto"
Requires-Dist: lxml; extra == "palo-alto"
Requires-Dist: cryptography; extra == "palo-alto"
Requires-Dist: pan-os-python; extra == "palo-alto"
Requires-Dist: pan-python; extra == "palo-alto"
Requires-Dist: pyopenssl; extra == "palo-alto"
Provides-Extra: tundra
Requires-Dist: redis; extra == "tundra"
Provides-Extra: airflow
Requires-Dist: apache-airflow; extra == "airflow"
Provides-Extra: azure
Requires-Dist: azure-mgmt-resource; extra == "azure"
Requires-Dist: azure-identity; extra == "azure"
Requires-Dist: cryptography; extra == "azure"
Requires-Dist: pygobject; extra == "azure"
Requires-Dist: msgraph-sdk; extra == "azure"
Requires-Dist: affliction>=1.3; extra == "azure"
Provides-Extra: all
Requires-Dist: adal; extra == "all"
Requires-Dist: affliction>=1.3; extra == "all"
Requires-Dist: apache-airflow; extra == "all"
Requires-Dist: azure-identity; extra == "all"
Requires-Dist: azure-mgmt-resource; extra == "all"
Requires-Dist: boto3; extra == "all"
Requires-Dist: botocore; extra == "all"
Requires-Dist: cp-mgmt-api-sdk==1.5.0; extra == "all"
Requires-Dist: cryptography; extra == "all"
Requires-Dist: lxml; extra == "all"
Requires-Dist: msal; extra == "all"
Requires-Dist: msgraph-sdk; extra == "all"
Requires-Dist: office365-rest-python-client; extra == "all"
Requires-Dist: onelogin; extra == "all"
Requires-Dist: openpyxl; extra == "all"
Requires-Dist: pan-os-python; extra == "all"
Requires-Dist: pan-python; extra == "all"
Requires-Dist: pandas; extra == "all"
Requires-Dist: pwinput; extra == "all"
Requires-Dist: pygobject; extra == "all"
Requires-Dist: pyopenssl; extra == "all"
Requires-Dist: redis; extra == "all"
Requires-Dist: ruamel.yaml; extra == "all"
Requires-Dist: urllib3; extra == "all"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: summary

# convocations

a set of [`invoke`](https://pypi.org/project/invoke)-inspired, [`raft`](https://pypi.org/project/raft)-based convocations that we hope
can help make development and devops a little easier.  powered by angry penguins.


## pypi

useful utilities when working on projects intended to be published in a
python repository like pypi

### pypi.template

creates a template project that you can use to create packages / modules
that will be deployed to pypi or another python repository.  

## python

useful utilities to make life easier for those getting started with using
a repository.

### python.setup

creates a standard virtual environment for running the project

### python.build

builds the project using setup.py or pyproject.toml

### python.clean

cleans any builds

### python.test

runs test via pytest and prints out a coverage report

### python.bump_version

bumps the current version of the project via bumpversion

### python.upload

uploads any distribution via twine

### python.publish

a handy combination of clean, test, build, version, upload

## aws

### configuration keys

| name                       | description                                                                                                                                                                    |
|----------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| convocations.prefix        | a handy prefix used in output and the directory in which cfn templates / parameters can be found                                                                               |
| aws                        | object                                                                                                                                                                         |
| aws.profile                | the profile to use when creating boto3 sessions                                                                                                                                |
| aws.start_url              | the sso start url                                                                                                                                                              |
| aws.account_id             | the target account id for sso                                                                                                                                                  |
| aws.sso_account_id         | an alias for account_id                                                                                                                                                        |
| aws.sso_region             | the region in which sso is configured                                                                                                                                          |
| aws.sso_start_url          | an alias for start_url                                                                                                                                                         |
| aws.role                   | the role which we will assume after sso is completed, if unspecified, we will take the first role alphabetically                                                               |
| aws.sso_role_name          | an alias for role                                                                                                                                                              |
| aws.global_parameter_files | files that contain parameters that should be loaded by default when using cloudformation.  by convention the file at convocation.prefix/params/global.yml will also be loaded. |


## palo_alto

## todd

## fortigate

## checkpoint

## xkcd

## Contributing

### apt requirements for azure 

azure development will require certain os level packages to be
installed:

```bash
apt install -y gnome-keyring libgirepository1.0-dev libcairo2-dev
```
