openstack/ui-cookiecutter
Code Issues Proposed changes
Cookiecutter template for Horizon Plugin.
249 Commits 1 Branch 0 Tags 847 KiB
JavaScript 57.8%
Python 40.3%
HTML 1.6%
SCSS 0.2%
Shell 0.1%
master
Go to file
Akihiro Motoki 8390e9d6d2 Fix tox-checkbuild CI job 
[Changes in zuul configurations]
- playbooks/checkbuild/pre.yaml calls ensure-nodejs role, but the default
  nodejs version defined in ensure-nodejs role is still 6. nodejs6 repo
  is no longer available. This is the cause of the job failure.
  Let's specify nodejs_version used in horizon by default.
- Ensure to install tox globally in the system.
  tox -e checkbuild calls "tox" as the test commands,
  so it needs to be installed globally.
- Specify "python_version" so that zuul ensures to install a required
  version of python interpreter.

[Changes in cookiecutter template]
- hacking version in test-requirements.txt was too old.
  It is updated to use more recent version which horizon uses.
- Update python version to 3.9 in tox.ini.
- Install horizon and its dependencies separately.
  The constraints file contains horizon, so installing horizon along with
  the constraints file results in a version conflict error.

Change-Id: If4bae3fde1f29eeb1d4d43942acc21ff2ef19482
2022-04-12 09:46:36 +09:00
{{cookiecutter.repo_name}} Fix tox-checkbuild CI job 2022-04-12 09:46:36 +09:00
hooks Exclude git operations from checkbuild in tox. 2017-05-29 09:46:30 +00:00
playbooks/checkbuild Merge "Use ensure-* roles" 2020-04-14 00:01:21 +00:00
.gitignore Clean up .gitignore references to personal tools 2018-10-05 18:09:24 +00:00
.gitreview OpenDev Migration Patch 2019-04-19 19:29:12 +00:00
.zuul.yaml Fix tox-checkbuild CI job 2022-04-12 09:46:36 +09:00
CONTRIBUTING.rst Update document link affected by document migration 2017-07-14 13:26:34 +00:00
cookiecutter.json Use module_name everywhere; module_folder is redundant 2017-05-31 12:26:26 +09:00
README.rst Changes for url transition to OpenDev 2019-04-23 05:14:24 +00:00
requirements.txt Add test environment 2017-05-29 13:27:54 +09:00
test-requirements.txt Update hacking version 2019-03-19 11:58:09 +09:00
tox.ini Fix tox-checkbuild CI job 2022-04-12 09:46:36 +09:00

README.rst

ui-cookiecutter

Cookiecutter template for an OpenStack Dashboard UI plugin project. This generate UI plugin project using Horizon Angular framework and the generated project includes sample panel with CRUD operations.

See also https://github.com/audreyr/cookiecutter.

  • Free software: Apache license
  • pbr: Set up to use Python Build Reasonableness
  • hacking: Enforces the OpenStack Hacking Guidelines
  • eslint: Enfoces the JavaScript Guidelines
  • testrepository: Runs tests using testrepository
  • OpenStack-Infra: Ready for OpenStack Continuous Integration testing
  • Tox testing: Setup to easily test for Python 2.7, 3.4
  • karma testing: Setup to easily test for JavaScript
  • Sphinx docs: Documentation ready for generation and publication
  • reno : Sphinx extension for Release Notes

Usage

Generate a Python package project:

cookiecutter https://github.com/openstack/ui-cookiecutter.git

This command prompts interactive input. Please check these parameters:

* "repo_group": The name for the git repo group. e.g. "openstack"
* "repo_name": The name for the git repo. e.g. "cafe-ui", This is used as python package name too.
* "launchpad_project": The name of the project on launchpad. e.g. "cafe-ui",
* "project_short_description": The short descriptions for your UI. e.g. "Cafe User Interface",
* "help_name": The name for the help. e.g. "Cafe-UI",
* "call_by_name": The name of this UI to write texts such as README or Help. e.g. "Cafe UI",
* "module_name": The name of the python module. e.g. "cafe_ui"
* "dashboard": The slug of the "dashboard" you want to add this plugin into. e.g. "project",
* "panel_group": The slug for the "panel_group". e.g. "cafe",
* "panel_group_name": The caption for the "panel_group". e.g. "Cafe",
* "panel": The slug of the "panel", in singular. e.g. "drink",
* "panel_func": The function name for the "panel", in singular. e.g. "Drink",
* "api_module": The name of the API service module. e.g. "cafe",
* "api_name": The caption for the "api_module". e.g. "Cafe"

If you want to generate without interactive input, you can use example values for these parameters as follow:

cookiecutter https://github.com/openstack/ui-cookiecutter.git --no-input

Run with OpenStack Horizon:

cd <repo_name>
pip install
cp <repo_name>/<module_name>/enabled/_90_project_<panel_group>_panelgroup.py <horizon-dir>/openstack_dashboard/local/enabled
cp <repo_name>/<module_name>/enabled/_91_project_<panel_group>_<panel>s.py <horizon-dir>/openstack_dashboard/local/enabled

then reboot the Horizon.

OpenStack projects require a working git repo for pbr to work, on newer versions of cookiecutter (>= 0.7.0 released 2013-11-09) this inital commit will be done automatically. Otherwise you will need to init a repo and commit to it before doing anything else:

cd $repo_name
git init
git add .
git commit -a

Then:

* Add the project to the OpenStack Infrastructure