[gentoo-commits] proj/R_overlay:master commit in: /

[André Erdmann]

commit:     b926a22a4ce705cb9ddf2bce8253ed8c708d4993
Author:     André Erdmann <dywi <AT> mailerd <DOT> de>
AuthorDate: Fri Jun  1 15:00:18 2012 +0000
Commit:     André Erdmann <dywi <AT> mailerd <DOT> de>
CommitDate: Fri Jun  1 15:00:18 2012 +0000
URL:        http://git.overlays.gentoo.org/gitweb/?p=proj/R_overlay.git;a=commit;h=b926a22a

README and description_fields.conf
	new file:   README
	new file:   description_fields.conf

---
 README                  |   51 ++++++++++++++++++++++
 description_fields.conf |  107 +++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 158 insertions(+), 0 deletions(-)

diff --git a/README b/README
new file mode 100644
index 0000000..8147b52
--- /dev/null
+++ b/README
@@ -0,0 +1,51 @@
+R overlay -- README
+
+== How to use ==
+
+There is currently no "R overlay" script, only modules that implement functionality.
+
+=== Running tests ===
+
+Real tests are scheduled for July 10 - July 30.
+
+In the meantime, there are some test scripts (run_<something>.py,test_<something>.sh)
+and a Makefile that provide basic testing.
+
+To run them you need to create a directory <root>/examples/packages and
+put some R packages into it (expected suffix is .tar.gz),
+where <root> is the directory containing this README file.
+
+You can then run:
+	make <some test>
+	 where <some test> is
+	 * test-nop             -- tries to import roverlay, but does nothing
+	 * test-ebuild_creation -- tries to create an ebuild for each package in examples/packages
+	 * test-ebuild_creation -- tries to create 1000 ebuilds for each package in examples/packages
+	 * test                 -- runs all of the above tests
+	 * dummy                -- prints python version in use, run
+	                            make PYVER=2 <some test> or make PYVER=3 <some test>
+	                            use a specific one
+
+	or:
+	./test_ebuildcreation.sh [-q] [count]
+	                        -- runs count * "number of packages in examples/packages"
+	                           ebuild creations in one script call.
+	                           Use '-q' to suppress the script output (e.g. ebuilds).
+
+	./run_ebuildcreation.py <packages>
+									-- runs ebuild creations for the given packages
+
+
+
+
+== Configuration ==
+
+* main configuration
+shell-like syntax (using shlex), TODO
+
+* description field configuration
+ConfigParser syntax, please see 'description_fields.conf' in this directory.
+
+* dependency rules configuration
+<scheduled for July 1>
+

diff --git a/description_fields.conf b/description_fields.conf
new file mode 100644
index 0000000..7702296
--- /dev/null
+++ b/description_fields.conf
@@ -0,0 +1,107 @@
+# R overlay -- description field definition
+# Copyright 2006-2012 Gentoo Foundation
+# Distributed under the terms of the GNU General Public License v2
+#
+
+# ----------------------------------------------------------------------------
+#
+# This file controls how DESCRIPTION fields are used
+# It is read in raw mode so that strings like '%var' are not interpolated.
+# A per-field section is introduced with [<field name>] and
+# contains flags and options.
+#
+#
+# known field options are:
+#
+#  default_value = <some value>
+#                        -- set the default value for this field,
+#                            which implies that any read description data
+#                            will contain this field (with value either
+#                            from the description file or the default one).
+#                            'Disables' the mandatory flag.
+#
+#  allowed_value = <some value>
+#                        -- declares that this field has a value
+#                            whitelist and adds <some value> to this list.
+#
+#  allowed_values = <some values>
+#                        -- same as allowed_value but witj multiple values
+#
+#  alias_withcase = <aliases>,
+#  alias = <aliases>
+#                        -- declares case-sensitive field name aliases
+#                            aliases can be used to fix typos as well as
+#                            to remap/merge fields (e.g. Title -> Description)
+#
+#  alias_nocase = <aliases>
+#                        -- declares case-insenstivite field names aliases
+#
+#
+#  flags = <flags>
+#                        -- add flags to this field; note that any value-less
+#                            option is interpreted as flag
+#
+# options with multiple values are read as a <value>[, <value>]* list
+#
+# and known field flags are:
+#  joinValues
+#         -- declares that the field's value is one string even if it
+#             spans over multiple lines (the lines will be joined with ' ')
+#  isList
+#         -- declares that the field's value is a list
+#            (the default regex for splitting the values is '\s*[,;]{1}\s*')
+#
+#  isWhitespaceList
+#         -- declares that the field's value is a list
+#             separated by whitespace. Has no effect if 'isList' is set.
+#  mandatory
+#         -- declares that this field has to have an value that evaluates
+#             to True (value is set and not empty).
+#             This flag is (effectively) useless in conjunction with
+#             default_value unless the default value evaluates to False.
+#
+#  ignore
+#         -- ignore this field entirely
+#
+#
+# Flags are always case-insensitive.
+# Note that it is not checked whether a flag is known or not,
+# which means you can add anything here.
+#
+# ----------------------------------------------------------------------------
+
+
+[Description]
+joinValues
+
+[Title]
+joinValues
+
+[Package]
+joinValues
+
+[License]
+isList
+
+[Version]
+mandatory
+joinValues
+
+[Suggests]
+alias_nocase = Suggests, Suggest, %Suggests, Suggets, Recommends
+
+[Depends]
+alias_nocase = Depends, Dependencies, Dependes, %Depends, Depents, Require, Requires
+
+[Imports]
+alias_nocase = Imports, Import
+
+[LinkingTo]
+alias_nocase = LinkingTo, LinkingdTo, LinkinTo
+
+[SystemRequirements]
+alias_nocase = SystemRequirements, SystemRequirement
+
+[OS_Type]
+alias_nocase = OS_TYPE
+allowed_values = unix