Re: [meta-cpan 1/3] meta-cpan creation

[Martin Jansa <martin.jansa@gmail.com>]

[-- Attachment #1: Type: text/plain, Size: 6207 bytes --]

On Mon, Aug 12, 2013 at 12:35:38PM +0800, Hongxu Jia wrote:
> ---
>  COPYING.MIT     | 17 +++++++++++
>  README          | 88 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
>  conf/layer.conf | 10 +++++++
>  3 files changed, 115 insertions(+)
>  create mode 100644 COPYING.MIT
>  create mode 100644 README
>  create mode 100644 conf/layer.conf
> 
> diff --git a/COPYING.MIT b/COPYING.MIT
> new file mode 100644
> index 0000000..89de354
> --- /dev/null
> +++ b/COPYING.MIT
> @@ -0,0 +1,17 @@
> +Permission is hereby granted, free of charge, to any person obtaining a copy
> +of this software and associated documentation files (the "Software"), to deal
> +in the Software without restriction, including without limitation the rights
> +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
> +copies of the Software, and to permit persons to whom the Software is
> +furnished to do so, subject to the following conditions:
> +
> +The above copyright notice and this permission notice shall be included in
> +all copies or substantial portions of the Software.
> +
> +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
> +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
> +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
> +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
> +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
> +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
> +THE SOFTWARE.
> diff --git a/README b/README
> new file mode 100644
> index 0000000..091da85
> --- /dev/null
> +++ b/README
> @@ -0,0 +1,88 @@
> +meta-cpan
> +=========
> +This layer provides commonly-used perl libraries in the Comprehensive
> +Perl Archive Network.
> +
> +Contents and Help
> +-----------------
> +
> +In this section the contents of the layer is listed, along with a short
> +help for each package.
> +
> +         -- libdbi-perl --
> +         The DBI is a database access module for the Perl programming language.
> +         It defines a set of methods, variables, and conventions that provide
> +         a consistent database interface, independent of the actual database
> +         being used.
> +                      |<- Scope of DBI ->|
> +                           .-.   .--------------.   .-------------.
> +           .-------.       | |---| XYZ Driver   |---| XYZ Engine  |
> +           | Perl  |       | |   `--------------'   `-------------'
> +           | script|  |A|  |D|   .--------------.   .-------------.
> +           | using |--|P|--|B|---|Oracle Driver |---|Oracle Engine|
> +           | DBI   |  |I|  |I|   `--------------'   `-------------'
> +           | API   |       | |...
> +           |methods|       | |... Other drivers
> +           `-------'       | |...
> +                           `-'
> +
> +        -- libdbd-sqlite-perl --
> +        DBD::SQLite is a Perl DBI driver for SQLite, that includes the entire
> +        thing in the distribution. So in order to get a fast transaction capable
> +        RDBMS working for your perl project you simply have to install this
> +        module, and nothing else.
> +
> +        usage: there is a test case to show you how it works
> +
> +        1) vim local.conf:
> +        ...
> +        IMAGE_INSTALL_append = " libdbd-sqlite-perl"
> +        PERL_DBM_TEST = "1"
> +        ...
> +        2) build core-image-sato and boot the target
> +
> +        3) run "sqlite-perl-test.pl" on target. This script includes five
> +           operations create/insert/update/delete/select to do with a table.
> +
> +        More information can be found in the recipe's git log.
> +
> +Dependencies
> +------------
> +
> +This layer depends on:
> +
> +  URI: git://git.openembedded.org/openembedded-core
> +  branch: master
> +  revision: HEAD
> +  prio: default
> +
> +Adding the meta-cpan layer to your build
> +---------------------------------------
> +
> +In order to use this layer, you need to make the build system aware of
> +it.
> +
> +Assuming the meta-cpan layer exists at the top-level of your
> +yocto build tree, you can add it to the build system by adding the
> +location of the meta-cpan layer to bblayers.conf, along with any
> +other layers needed. e.g.:
> +
> +  BBLAYERS ?= " \
> +    /path/to/oe-core/meta \
> +    /path/to/layer/meta-cpan \
> +
> +Maintenance
> +-----------
> +
> +Send patches / pull requests to openembedded-devel@lists.openembedded.org with
> +'[meta-cpan]' in the subject.

Looks good, but it would be nice to add git send-email example like
other layer/README have in meta-oe (maybe except meta-networking).

> +
> +Layer maintainer: Hongxu Jia <hongxu.jia@windriver.com>
> +
> +License
> +-------
> +
> +All metadata is MIT licensed unless otherwise stated. Source code included
> +in tree for individual recipes is under the LICENSE stated in each recipe
> +(.bb file) unless otherwise stated.
> +
> diff --git a/conf/layer.conf b/conf/layer.conf
> new file mode 100644
> index 0000000..11da11f
> --- /dev/null
> +++ b/conf/layer.conf
> @@ -0,0 +1,10 @@
> +# We have a conf and classes directory, add to BBPATH
> +BBPATH .= ":${LAYERDIR}"
> +
> +# We have recipes-* directories, add to BBFILES
> +BBFILES += "${LAYERDIR}/recipes-*/*/*.bb \
> +	${LAYERDIR}/recipes-*/*/*.bbappend"
> +
> +BBFILE_COLLECTIONS += "perl"

I don't have strong opinion either way, but lets call this layer
meta-perl or meta-cpan and use the same name in BBFILE_COLLECTIONS.

meta-perl would be more generic (matching with meta-ruby) and maybe
we'll need to add some perl related recipes which aren't from cpan?

> +BBFILE_PATTERN_perl = "^${LAYERDIR}/"
> +BBFILE_PRIORITY_perl = "6"
> -- 
> 1.8.1.2
> 
> _______________________________________________
> Openembedded-devel mailing list
> Openembedded-devel@lists.openembedded.org
> http://lists.openembedded.org/mailman/listinfo/openembedded-devel

-- 
Martin 'JaMa' Jansa     jabber: Martin.Jansa@gmail.com

[-- Attachment #2: Digital signature --]
[-- Type: application/pgp-signature, Size: 205 bytes --]