CodeGen_PECL

Tool to generate PECL extensions from an XML description

CodeGen_PECL (formerly known as PECL_Gen) is a pure PHP replacement for the ext_skel shell script that comes with the PHP 4 source. It reads in configuration options, function prototypes and code fragments from an XML description file and generates a complete ready-to-compile PECL extension. hholzgra Hartmut Holzgraefe hartmut@php.net lead rasmus Rasmus Lerdorf rasmus@php.net contributor luckec Carsten Lucke luckec@php.net contributor pajoye Pierre-Alain Joye pajoye@php.net helper hartmann Johann Peter Hartmann hartmann@php.net helper 1.0.3 2006-08-16 PHP stable Changes since 1.0.2: - fixed CodeGen dependency entry - disabled #line output by default PEAR CodeGen 1.0.1 2006-08-14 stable Changes since 1.0.0: - now using codegen helper object for indent and code blocks - updated the DTD - added DOCTYPE specs to all examples - package.xml 1.0 OS dependencies generation fixed - some config.m4 generation stuff ended up in CodeGen, now moved back - added config.m4 checks for header files - added new interface CodeGen_PECL_Element_ObjectInterface for methods that can take both Classes and Interfaces as argument - fixed typo in class payload constructor code generation - allow :: in names when using C++ only - use PHP_MALIAS instead of PHP_FALIAS for methods - improved attribute checking in XML parser - pear channel support - pkg-config support in --with options - started support for arg_info and pass/return by reference (work in progress) 1.0.0 2006-02-17 stable 1.0.0 stable release (finally) 1.0.0rc1 2005-09-22 beta I'm feature-complete for a 1.0 release now :) - object store support for private C/C++ data in objects - <lib> and <header> tags within <with> - interface and type hints support - added a lint option (-l) for syntax checking of spec files - write to tmpfiles first, only overwrite -> done existing files if actual changes are detected, preserve unchanged files (to make "make" happy) - changed names of variables generated for resource parameters, backwards compatibility is provided by checking the extension tags version attribute, for versions < 1.0.0dev the old naming stile is used - added test generation for class member functions 0.9.0 2005-08-11 beta Milestone 0.9 ------------- - copy <changelog> to generated package.xml - done - rewrite the function prototype parser - object type specification (as in resources) - done - default values - done - 'void' treatment - done - '...' not handled - done - array() as default value - done - code generation for 'pass by refecence' - for zval based types yet - '...' code generation - if first parameter yet FREE_RESOURCE macro - done allow defined PHP constants as default value - done <define> tag -> #define + <constant>? - done allow for embedded base64 or uu encoded logo specs - done changeable function prefix? - done trick parser to verbatim pass on docbook contentent - done add configure compile test for <resource> -done to check whether a given payload is a valid type? SYSTEM Entity and XInclude support - done support for multiple <with> tags with distinct names, name defaults to extension name if not given - done added version attribute to <extension> to control parser features (replaces -x switch) - done support <?code ... ?> as alternative to CDATA - done check whether <header> checks work - done test files are not yet added to package.xml - done documentation up to date for all 0.9 features - done examples and test cases added - done 0.9.0rc5 2005-08-03 beta - implemeted new proto parser, activate with --experimental 0.8.5 2004-11-11 beta - fixed method renaming inconsistencies introduced with 0.8.4 - config.m4 additions can now be placed at 'top' or 'bottom' of config.m4 - '--force' does not remove the target directory anymore - '#include <php.h>' moved out of #ifdef block to allow static builds - 'extern "C"' specifications added on C++ builds - container tags like <functions> or <globals> are now optional - pecl-gen will now set exit status on errors 0.8.4 2004-05-16 beta This is the first release living in PECL insteat of PEAR. Technical changes are: - improved PECL CS compliance of generated code - generated config.m4 supports both shared and static build - code snippets may be read from files instead of beeing embedded in CDATA sections - improved resource parameter handling - shortcuts for constants that just mimic C constants - global 'code' tag finally works as documented - files can be added using 'file' tag in 'deps' - ... 0.8.3 2004-04-01 beta - this release was completely broken for unknown reasons, might be realted to the move from PEAR to PECL ...? 0.8.2 2003-10-13 beta - fixed a bug in the parser that rendered 0.8.1 almost useless :( 0.8.1 2003-10-12 beta - custom test generation added - minor DTD changes - code reformatted for better PEAR coding standards compliance - additional tools for whitespace and indentation management 0.8.0 2003-07-13 beta - added documentation - check for reserved words - check for duplicate names - config,m4 header files check added - config.m4 support for makefile fragments 0.7.0 2003-07-03 beta - a README file is written containing information on how to continue after an extension was generated - --function="proto" writes function stub to stdout - --stubs=filename now supported in ext_skel BC mode - added --help and --version options - added a short feedback howto message (can be disabled using --quiet) - --with-xml works again (ext_skel compatibility) - will now only purge and overwrite existing target directory if '--force' is requested on cmd line - .cvsignore created with platform-specific entries - PEARifying error reporting finished 0.6.1 2003-06-29 beta typo fix in package.xml dependencies entry for XML_Parser 0.6.0 2003-06-28 beta Moved from php5/scripts to PEAR.