NAME

App::Zapzi - store articles and publish them to read later

VERSION

version 0.017

DESCRIPTION

This class implements the application functions for Zapzi. See the page for the zapzi command for details on how to run it.

ATTRIBUTES

run

The current state of the application, -1 means nothing has been done, 0 OK, otherwise an error code. Used for exit code when the process terminates.

force

Option to force processing of the init command. Default is unset.

noarchive

Option to not archive articles on publication

long

Option to present a detailed listing

folder

Folder to work on. Default is 'Inbox'

transformer

Transformer to extract text from the article. Default is '', which means Zapzi will automatically the best option based on the content type of the text.

format

Format to publish a collection of folder articles in.

encoding

Encoding to publish a collection of folder articles in. Zapzi will select the best encoding for the content and publication format if not specified.

distribute

Method to distribute a published eBook - eg copy, script, email.

zapzi_dir

The folder where Zapzi files are stored.

zapzi_ebook_dir

The folder where Zapzi published eBook files are stored.

database

The instance of App:Zapzi::Database used by the application.

test_database

If set, use an in-memory database. Used to speed up testing only.

interactive

If set, this is an interactive session where Zapzi can prompt the user for input.

METHODS

get_app =method BUILD

At construction time, a copy of the application object is stored and can be retrieved later via get_app.

process_args(@args)

Read the arguments @args (normally you'd pass in @ARGV and process them according to the command line specification for the application.

init

Creates the database. Will only do so if the database does not exist already or if the force attribute is set.

init_config

On initialiseation, ask the user for settings for configuration variables. Will not ask if this is being run non-interactively.

config(@args)

Get or set configuration variables.

If args is 'get' will list out all variables and their values. If args is 'get x' will list the value of variable x. If args is 'set x y' will set the value of x to be y.

validate_folder

Determines if the folder specified exists.

validate_article_ids(@args)

Determines if @args could be article IDs.

list

Lists out the articles in folder.

list_folders

List folder names and article counts.

make_folder

Create one or more new folders. Will ignore any folders that already exist.

delete_folder

Remove one or more new folders. Will not allow removal of system folders ie Inbox and Archive, but will ignore removal of folders that do not exist.

delete_article

Remove an article from the database

add

Add an article to the database for later publication.

show(output, articles)

Exports article text. If output is 'browser' then will start a browser to view the article, otherwise it will print to STDOUT.

move

Move one or more articles to a folder.

publish

Publish a folder of articles to an eBook

help

Displays help text.

version

Displays version information.

AUTHOR

Rupert Lane <rupert@rupert-lane.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2015 by Rupert Lane.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.