Misc helper-scripts for creating and expanding Plone-Add-Ons.
Project description
Introduction
============
Yet another command-line Plone-Add-On-Generator, just the way I like it:
No dependencies, no possible conflicts, some Python-methods, that's all.
Installation
=============
pip install adi.devgen
Alternatively add `adi.devgen` as an egg to your buildout, then
the `devgen`-executable should be available in its bin-directory.
Usage
=====
Type the command alone, to get a help-text, what it can do for you:
$ devgen
That'll also lists the available generator-functions, to get a function's help-text, type:
$ devgen [FUNCTION_NAME]
Examples
========
Create boilerplate for an addon, that can do nothing, but be installed in a Plonesite:
$ devgen addProfileSkel your.addon
Create it not in the directory, where you are, but somewhere else:
$ devgen addProfileSkel your.addon /some/where/else
Register another addon as a dependency to your addon:
$ devgen addDep collective.bestaddonever your.addon
Or, first locate into your addon, then you can omit the appended path (defaults to '.'):
$ cd your.addon
$ devgen addDep collective.bestaddonever
Create an installable Plone-Addon, with a stylesheet, a javascript and a template in a skin folder:
$ devgen addSkinSkel your.addon
In contrary to browser-based resources, you won't need to empty the browser's cache on a reload, after changing your stylesheet or javascript.
Create an installable Plone-Addon, with a stylesheet and a javascript in a browser's resource-folder.
$ devgen addBrowserSkel your.addon
Add docs-folder and read defaults for setup.py of a config:
$ devgen addMetaSkel
If a file '~/.buildout/devgen.cfg' is present, values will be read of it and inserted to setup.py. Its format is expected to be like:
author=Arbi Trary
author_email=arbi@tra.ry
url=https://github.com/arbitrary/your.addon
TODO
====
- Regard more than one dotted namespace for addon.
- Split functions into smaller reusable chunks.
- Possibly transfer:
https://github.com/ida/skriptz/blob/master/plone/Dexterity/addField.py
Changelog
=========
0.7 (150924)
------------
- Fix missing import and typo in setup.py-generation, which broke addons-installs.
0.6 (150923)
------------
- Update README, improve installPlone().
0.5 (150921)
------------
- Fix imports, better hlp-msgs, improve installPlone().
0.4 (150920)
------------
- Update README
0.3 (150920)
------------
- Fix changed import-paths.
0.2 (150920)
------------
- Add adi.commons as dependency.
0.1 (150920)
------------
- Initial release
============
Yet another command-line Plone-Add-On-Generator, just the way I like it:
No dependencies, no possible conflicts, some Python-methods, that's all.
Installation
=============
pip install adi.devgen
Alternatively add `adi.devgen` as an egg to your buildout, then
the `devgen`-executable should be available in its bin-directory.
Usage
=====
Type the command alone, to get a help-text, what it can do for you:
$ devgen
That'll also lists the available generator-functions, to get a function's help-text, type:
$ devgen [FUNCTION_NAME]
Examples
========
Create boilerplate for an addon, that can do nothing, but be installed in a Plonesite:
$ devgen addProfileSkel your.addon
Create it not in the directory, where you are, but somewhere else:
$ devgen addProfileSkel your.addon /some/where/else
Register another addon as a dependency to your addon:
$ devgen addDep collective.bestaddonever your.addon
Or, first locate into your addon, then you can omit the appended path (defaults to '.'):
$ cd your.addon
$ devgen addDep collective.bestaddonever
Create an installable Plone-Addon, with a stylesheet, a javascript and a template in a skin folder:
$ devgen addSkinSkel your.addon
In contrary to browser-based resources, you won't need to empty the browser's cache on a reload, after changing your stylesheet or javascript.
Create an installable Plone-Addon, with a stylesheet and a javascript in a browser's resource-folder.
$ devgen addBrowserSkel your.addon
Add docs-folder and read defaults for setup.py of a config:
$ devgen addMetaSkel
If a file '~/.buildout/devgen.cfg' is present, values will be read of it and inserted to setup.py. Its format is expected to be like:
author=Arbi Trary
author_email=arbi@tra.ry
url=https://github.com/arbitrary/your.addon
TODO
====
- Regard more than one dotted namespace for addon.
- Split functions into smaller reusable chunks.
- Possibly transfer:
https://github.com/ida/skriptz/blob/master/plone/Dexterity/addField.py
Changelog
=========
0.7 (150924)
------------
- Fix missing import and typo in setup.py-generation, which broke addons-installs.
0.6 (150923)
------------
- Update README, improve installPlone().
0.5 (150921)
------------
- Fix imports, better hlp-msgs, improve installPlone().
0.4 (150920)
------------
- Update README
0.3 (150920)
------------
- Fix changed import-paths.
0.2 (150920)
------------
- Add adi.commons as dependency.
0.1 (150920)
------------
- Initial release
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
adi.devgen-0.7.tar.gz
(22.3 kB
view hashes)
Built Distribution
Close
Hashes for adi.devgen-0.7.linux-x86_64.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1c6964c389be2404734e8a0ab9da2fb24dade76c2a4e49fa078c9eea5a446fef |
|
MD5 | b4c1080f14fbc31a67db28c79ed9be5a |
|
BLAKE2b-256 | 1e0434b74748ff4ae0f9016de7a2d1ddf72968b51d04379593673219fe1704b7 |