{"id":48489510,"url":"https://github.com/cloudblue/connect-report-python-boilerplate","last_synced_at":"2026-04-07T11:04:24.857Z","repository":{"id":46075476,"uuid":"322368361","full_name":"cloudblue/connect-report-python-boilerplate","owner":"cloudblue","description":"Template to quickly bootstrap custom reports for CloudBlue Connect","archived":false,"fork":false,"pushed_at":"2025-10-06T13:30:59.000Z","size":51,"stargazers_count":4,"open_issues_count":0,"forks_count":3,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-10-06T15:25:35.091Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cloudblue.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-12-17T17:39:01.000Z","updated_at":"2025-10-06T13:31:04.000Z","dependencies_parsed_at":"2022-09-24T16:50:28.419Z","dependency_job_id":null,"html_url":"https://github.com/cloudblue/connect-report-python-boilerplate","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/cloudblue/connect-report-python-boilerplate","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudblue%2Fconnect-report-python-boilerplate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudblue%2Fconnect-report-python-boilerplate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudblue%2Fconnect-report-python-boilerplate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudblue%2Fconnect-report-python-boilerplate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cloudblue","download_url":"https://codeload.github.com/cloudblue/connect-report-python-boilerplate/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudblue%2Fconnect-report-python-boilerplate/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31509946,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T03:10:19.677Z","status":"ssl_error","status_checked_at":"2026-04-07T03:10:13.982Z","response_time":105,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-07T11:04:24.106Z","updated_at":"2026-04-07T11:04:24.849Z","avatar_url":"https://github.com/cloudblue.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Cookiecutter for CloudBlue Connect Reports  \n  \nPowered by [Cookiecutter](https://github.com/cookiecutter/cookiecutter), Cookiecutter for CloudBlue Connect Reports provides a framework for boostraping your custom reports for Connect.\n\nWith this project you can write your own reports to execute either locally or using the reports module of Connect.\n\nIn order to create your own custom report you will need to get familiar with the [Connect Rest API](https://connect.cloudblue.com/community/api/) and it's OpenAPI implementation using the [connect-openapi-client](https://github.com/cloudblue/connect-python-openapi-client).\n\n## Dependencies\n\nWe recommend to use instead of directly `cookiecutter` our \u003ca href=\"https://github.com/cloudblue/connect-cli\"\u003e**connect-cli**\u003c/a\u003e project. This utility provides all what you need to handle the lifecycle of your project including the bootstraping, validation and adding new reports.\n\nIn the case you want to bootstrap your project directly, you will require following packages:\n\n* cookiecutter\n* openpyxl\n\n## Features\n\n* Works fit python 3.8 and 3.9\n* Bootstraps a custom report project within seconds\n* Provides all needed dependencies\n* Provides basic testing functionality including right mockers\n* Compatible with github Actions\n* Configures project licensing\n\n## Usage\n\nCreating a project that provides a report package that could be run either using the [Connect CLI](https://github.com/cloudblue/connect-cli) or directly in [Connect](https://connect.cloudblue.com) is simple.\n\nAfter installing [Connect CLI](https://github.com/cloudblue/connect-cli), you could run the following command on your terminal for having a fresh new reports project:\n\n\t$ cd $HOME/connect_projects\n\t$ ccli project report bootstrap\n \nYou'll be prompted for some values. Provide them and a Connect project will be created for you.\n\n**Warning**: Please change sample data with your own desired information\n\n\tBootstraping report project...\n\n\tproject_name [My Awesome Project]: My Awesome Project\n\tproject_slug [my_awesome_project]:\n\tdescription [My reports are really usefull!]:\n\tpackage_name [reports]: My Super Reports Package\n\tpackage_slug [my_super_reports_package]:\n\tinitial_report_name [My Awesome Report]: My Awesome Report\n\tinitial_report_slug [my_awesome_report]:\n\tinitial_report_description [This report provides all data i need]:\n\tSelect initial_report_renderer:\n\t1 - xlsx\n\t2 - csv\n\t3 - pdf\n\t4 - json\n\t5 - jinja2\n\tChoose from 1, 2, 3, 4, 5 [1]: 1\n\tauthor [Globex Corporation]: ISV Inc\n\tversion [0.1.0]: 1.0.0\n\tSelect license:\n\t1 - Apache Software License 2.0\n\t2 - MIT\n\t3 - BSD\n\tChoose from 1, 2, 3 [1]: 1\n\tuse_github_actions [y]: y\n\tDone! Your report project is ready to go!\n\n\tReport Project location: $HOME/connect_projects/my_awesome_project\n\nNow you can access your recently created project folder and take a look arround it:\n\n\t$ cd my_awesome_project\n\t$ ls\n\nStarting here, if you want you can put your project on a git repository, for example at github:\n\n\t$ git init\n\t$ git add .\n\t$ git commit -m \"first commit\"\n\t$ git remote add origin https://github.com/cloudblue/my_custom_reports_project.git\n\t$ git push -u origin master\n\nIn the use case that you decided to use github actions, you will notice that a first CI task will run, this one will run the sample test\n\n## Creating your own report\n\nThe creation of a new report requires some knowledge of [Connect Rest API](https://connect.cloudblue.com/community/api/) and the [connect-openapi-client](https://github.com/cloudblue/connect-python-openapi-client). \n\nFirst, edit the reports.json file, this file is a descriptor that can be read by Connect as well as Connect CLI to understand your package. Please ensure that all properties are defined. On the parameters list, you can define the parameters that will be asked to be populated by who runs the report, just select the ones you need as described in our community portal.\n\nThe code of your report must be defined at your entrypoint, here is where system will find your function that will receive an instantiated client, this client is the openapi one and can work with our API, additionally you will get a function that you must invoke in order to update the progress\n\nJob done? Try to run it locally!\n\n\t$ ccli report list -d ./my_awesome_project\n\n\t************************************************************\n\n\tMy Awesome Project version 1.0.0\n\n\t************************************************************\n\n\tWelcome to My Awesome Project !\n\n\tMy reports are really usefull!\n\n\tLicense\n\n\tMy Awesome Project is licensed under the Apache Software License 2.0 license.\n\n\n\t************************************************************\n\n\tList of available reports:\n\n\tReport ID: my_awesome_report - Report name: My Awesome Project\n\nNow if you want you can execute it also using ccli\n\n\t$ ccli report execute my_awesome_report_1 -d ./my_awesome_report\n\n## Examples\n\nAll our reports that you can run from Connect platform are available to you, if you want to take a look at them and it's code visit our github repository available [here](https://github.com/cloudblue/connect-reports)\n\nPlease take a look to our oficial [documentation site](https://connect.cloudblue.com) for more information on how to work with reports\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudblue%2Fconnect-report-python-boilerplate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcloudblue%2Fconnect-report-python-boilerplate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudblue%2Fconnect-report-python-boilerplate/lists"}