https://github.com/eellak/lavraki

A simple perl script that updates ~/.kamakirc (Okeanos API client conf) with the current API auth token.
https://github.com/eellak/lavraki

Last synced: 11 months ago
JSON representation

A simple perl script that updates ~/.kamakirc (Okeanos API client conf) with the current API auth token.

• Host: GitHub
• URL: https://github.com/eellak/lavraki
• Owner: eellak
• License: isc
• Created: 2014-07-14T13:40:23.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2014-07-14T23:58:15.000Z (over 11 years ago)
• Last Synced: 2025-01-01T06:13:32.221Z (about 1 year ago)
• Language: Perl
• Homepage:
• Size: 152 KB
• Stars: 0
• Watchers: 10
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# lavraki

[Okeanos](https://okeanos.grnet.gr/) offers API access but expires and rotates the API auth token every month, thus making process automation difficult.

Lavraki is a simple perl script that logs into your Okeanos account and updates the API auth token in ~/.kamakirc if changed.

## Requirements & Compatibility

* Perl 5.12 or newer.

* [WWW::Mechanize](https://metacpan.org/pod/WWW::Mechanize).

* [File::HomeDir](https://metacpan.org/pod/File::HomeDir).

* [Config::Std](https://metacpan.org/pod/Config::Std).

* [HTML::TreeBuilder](https://metacpan.org/pod/HTML::TreeBuilder).

The use of `cpanm` for module installation is highly recommended. In Debian you can also install the packages:

* libwww-mechanize-perl

* libfile-homedir-perl

* libconfig-std-perl

## Installation

Just copy the script somewhere in your `PATH` and make it executable. Also copy `lavrakirc.sample` as `.lavrakirc` in your `HOME`, add your configuration and change the file permissions to `0400`.

## Usage

The script returns nothing if the configured token is still valid. If the token is changed it creates a backup of `~/.kamakirc` in the form of `~/.kamakirc.TIMESTAMP`, updates the token and prints an information message.

## License

This script is licensed under the [ISC license](http://opensource.org/licenses/ISC).

## Credits

The name 'lavraki' was chosen by Vivi from ellak.gr.