File perl-Schedule-At.spec of Package perl-Schedule-At

Overview Repositories Revisions Requests Users Attributes Meta

File perl-Schedule-At.spec of Package perl-Schedule-At

#
# spec file for package perl-Schedule-At
#
# Copyright (c) 2015 SUSE LINUX GmbH, Nuernberg, Germany.
#
# All modifications and additions to the file contributed by third parties
# remain the property of their copyright owners, unless otherwise agreed
# upon. The license for this file, and modifications and additions to the
# file, is the same license as for the pristine package itself (unless the
# license for the pristine package is not an Open Source License, in which
# case the license is the MIT License). An "Open Source License" is a
# license that conforms to the Open Source Definition (Version 1.9)
# published by the Open Source Initiative.

# Please submit bugfixes or comments via http://bugs.opensuse.org/
#

Name:           perl-Schedule-At
Version:        1.15
Release:        0
%define cpan_name Schedule-At
Summary:        OS independent interface to the Unix 'at' command
License:        CHECK(GPL-1.0+ or Artistic-1.0)
Group:          Development/Libraries/Perl
Url:            http://search.cpan.org/dist/Schedule-At/
Source0:        http://www.cpan.org/authors/id/J/JO/JOSERODR/%{cpan_name}-%{version}.tar.gz
Source1:        cpanspec.yml
BuildArch:      noarch
BuildRoot:      %{_tmppath}/%{name}-%{version}-build
BuildRequires:  perl
BuildRequires:  perl-macros
%{perl_requires}

%description
This modules provides an OS independent interface to 'at', the Unix command
that allows you to execute commands at a specified time.

* Schedule::At::add

Adds a new job to the at queue.

You have to specify a *TIME* and a command to execute. The *TIME* has a
  common format: YYYYMMDDHHmm where *YYYY* is the year (4 digits), *MM* the
  month (01-12), *DD* is the day (01-31), *HH* the hour (00-23) and *mm*
  the minutes.

The command is passed with the *COMMAND* or the *FILE* parameter.
  *COMMAND* can be used to pass the command as an string, or an array of
  commands, and *FILE* to read the commands from a file.

The optional parameter *TAG* serves as an application specific way to
  identify a job or a set of jobs.

Returns 0 on success or a value != 0 if an error occurred.

* Schedule::At::readJobs

Read the job content identified by the *JOBID* or *TAG* parameters.

Returns a hash of JOBID => $string where $string is the the job content.
  As the operating systems usually add a few environment settings, the
  content is longer than the command provided when adding the job.

* Schedule::At::remove

Remove an at job.

You identify the job to be deleted using the *JOBID* parameter (an opaque
  string returned by the getJobs subroutine). You can also specify a job or
  a set of jobs to delete with the *TAG* parameter, removing all the jobs
  that have the same tag (as specified with the add subroutine).

Used with JOBID, returns 0 on success or a value != 0 if an error
  occurred. Used with TAG, returns a hash reference where the keys are the
  JOBID of the jobs found and the values indicate the success of the remove
  operation.

* Schedule::At::getJobs

Called with no params returns a hash with all the current jobs or dies if
  an error has occurred. It's possible to specify the *TAG* or *JOBID*
  parameters so only matching jobs are returned. For each job the key is a
  JOBID (an OS dependent string that shouldn't be interpreted), and the
  value is a hash reference.

This hash reference points to a hash with the keys:

* TIME

An OS dependent string specifying the time to execute the command

* TAG

The tag specified in the Schedule::At::add subroutine

%prep
%setup -q -n %{cpan_name}-%{version}
find . -type f -print0 | xargs -0 chmod 644

%build
%{__perl} Makefile.PL INSTALLDIRS=vendor
%{__make} %{?_smp_mflags}

%check
%{__make} test

%install
%perl_make_install
%perl_process_packlist
%perl_gen_filelist

%files -f %{name}.files
%defattr(-,root,root,755)
%doc Changes README

%changelog

Places

File perl-Schedule-At.spec of Package perl-Schedule-At

Places