Metadata-Version: 2.1
Name: runat
Version: 0.1.1
Summary: Cli like cron, to run task a specific time
Home-page: https://github.com/alivx/runat
Author: Ali Saleh Baker
Author-email: alivxlive@gmail.com
License: GNU
Keywords: cron,at,timer,time,cli
Platform: UNKNOWN
Description-Content-Type: text/markdown
Requires-Dist: python-crontab (==2.5.1)

# Cronlike cli :) 
<img src="https://raw.githubusercontent.com/alivx/runat/master/other/logo.PNG" alt="logo" style="zoom:50%;" />


# runat
Tiny replacement for crontab

## Use Case/Note
* Run it inside container 🥚.
* Your crontab is broken 🐛.
* For security compliance 🔒.
* Anything you mayneed 🚑.


## Install
```
pip install runat
```

## Notes
* Crontab running on your timezone, if you want to use UTC pass arg --utc

## Option

```
> runat --help
usage: main.py [-h] --cron CRON --do DO [--utc]

tiny replacement cron for different usages

optional arguments:
  -h, --help            show this help message and exit
  --cron CRON, -c CRON  cron like syntax "22 23 * * *"
  --do DO, -d DO        list of command or shell script
  --utc, -u             Use UTC time
```

## Useages
```Bash
runat --cron "01 23 * * *"  --do "cd /srv/;bash cleanTemp.sh | tee  -a /var/log/cleanTemp.log"

#To use UTC time
runat --cron "01 23 * * *"  --do "cd /srv/;bash cleanTemp.sh | tee  -a /var/log/cleanTemp.log" --utc
> The next run  in 1.0 hour, 54.0 minutes, 44.0 seconds
```

## Exmaple output:
```
runat --cron "01 23 * * *"  --do "cd /srv/;bash cleanTemp.sh | tee  -a /var/log/cleanTemp.log"
> The next run  in 23.0 hours, 59.0 minutes, 56.0 seconds
```

## Installation using pypi
```
pip install runat
```

## Installation

```
$ pip install -r requirements.txt

$ pip install setup.py
```

## Development

This project includes a number of helpers in the `Makefile` to streamline common development tasks.

### Environment Setup

The following demonstrates setting up and working with a development environment:

```
### create a virtualenv for development

$ make virtualenv

$ source env/bin/activate


### run runat cli application

$ runat --help


## Deployments

### Docker

#### Note
If you want to work on local file you should mount it to the container using `-v`

Included is a basic `Dockerfile` for building and distributing `runat `,
and can be built with the included `make` helper:

```
$ make docker

$ docker run -it runat --help
```


License
-------

 GNU GENERAL PUBLIC LICENSE

Author Information
------------------

The tool was originally developed by [Ali Saleh Baker](https://www.linkedin.com/in/alivx/).


