Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/vijinho/kivy-pocket-philosopher

Pocket Philosopher - Find this on Google Play. A Python/Kivy project to edit, display and share aphorisms in a fun way. Project formerly named 'aforgizmo'
https://github.com/vijinho/kivy-pocket-philosopher

android-application application kivy kivy-application kivy-framework philosophy

Last synced: 29 days ago
JSON representation

Pocket Philosopher - Find this on Google Play. A Python/Kivy project to edit, display and share aphorisms in a fun way. Project formerly named 'aforgizmo'

Host: GitHub
URL: https://github.com/vijinho/kivy-pocket-philosopher
Owner: vijinho
License: other
Created: 2014-10-18T12:32:51.000Z (about 10 years ago)
Default Branch: master
Last Pushed: 2018-09-04T12:52:22.000Z (about 6 years ago)
Last Synced: 2024-09-30T08:40:53.664Z (about 1 month ago)
Topics: android-application, application, kivy, kivy-application, kivy-framework, philosophy
Language: Python
Homepage: https://play.google.com/store/apps/details?id=com.urunu.aforgizmo
Size: 54.4 MB
Stars: 7
Watchers: 1
Forks: 2
Open Issues: 1
Metadata Files:
- Readme: README.rst
- Contributing: docs/contributing.rst
- License: LICENSE

Awesome Lists containing this project

README

Pocket Philosopher
==================

This app which saves, retrieves, edits and displays random aphorisms on
random backgrounds.

It runs from Android version 2.2 and is available on Google Play at:

https://play.google.com/store/apps/details?id=com.urunu.aforgizmo

Features
--------
- Command-line interface utility to manipulate, import/export and display the data
- Copy aphorisms to the clipboard for sharing in other applications
- Easily search aphorisms
- Specify any local folder on your device for image display
- Backup/Restore the database locally
- Import data from a remote URL (example included)
- Download background images from a remote URL (example included)
- User flash message notifications with timed-removal

What is an Aphorism?
--------------------

- http://www.thefreedictionary.com/aphorism
- http://en.wikipedia.org/wiki/Aphorism

Setup
-----

- ``$ pip install --editable .``
- ``nosetests`` - run 'nose' tests in tests/

Manual Database Setup
~~~~~~~~~~~~~~~~~~~~~
If you wish to setup the database manually instead of automatically when the
application runs:

Run ``python models.py`` - setup database ``data/aphorisms.db`` or
::

CREATE TABLE "aphorism" (
"id" INTEGER NOT NULL PRIMARY KEY,
"author" VARCHAR(255) NOT NULL,
"source" VARCHAR(255) NOT NULL,
"aphorism" TEXT NOT NULL,
"hashtags" TEXT NOT NULL,
"created" DATETIME NOT NULL
);

- Insert the example aphorisms from ``data/aphorisms.json`` with
``aforgizmo insert`` then hit the RETURN/ENTER key twice

Command Line Usage
------------------

Type ``aforgizmo`` or failing that:

$ python aforgizmo.py --help

Usage: aforgizmo [OPTIONS] COMMAND [ARGS]...

Options:
-v, --verbose
-l, --logfile FILENAME
--help Show this message and exit.

Commands:
add Add an aphorism.
dump Dump all aphorisms to a file.
get Get an aphorism by ID.
insert Insert aphorisms by file.
list Show all aphorisms.
random Get a random aphorism.
remove Remove an aphorism by ID.
search Search for an aphorism by tag.
show Show an aphorism by ID for display.

- ``aforgizmo COMMAND --help``
- ``sqlite3 data/aphorisms.db`` see http://www.sqlite.org/cli.html

Running the Kivy App
--------------------

- On Mac OS X: ``kivy main.py`` - On other platforms it may 'just work'
with ``python main.py``
- Alternatively, run .