Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/friz-zy/factory
Automate your own tasks on pure python and execute it on remote or local hosts. Create The Magic
https://github.com/friz-zy/factory
Last synced: 25 days ago
JSON representation
Automate your own tasks on pure python and execute it on remote or local hosts. Create The Magic
- Host: GitHub
- URL: https://github.com/friz-zy/factory
- Owner: Friz-zy
- License: mit
- Created: 2014-05-28T20:42:45.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2015-02-28T19:53:52.000Z (almost 10 years ago)
- Last Synced: 2023-03-23T01:56:27.646Z (almost 2 years ago)
- Language: Python
- Homepage:
- Size: 613 KB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
factory
=======
[](https://github.com/Friz-zy/factory/blob/master/LICENSE) [](https://www.python.org/) [](https://pypi.python.org/pypi/gevent/1.0.1)
[](https://travis-ci.org/Friz-zy/factory) [](https://coveralls.io/r/Friz-zy/factory)
#### Description
Automate your own tasks on pure python and execute it on remote or local hosts
```bash
fact "uptime | cowsay"
frizzy@localhost in: uptime | cowsay
frizzy@localhost out: ______________________________________
frizzy@localhost out: / 00:38:46 up 17 days, 8:39, 7 users, \
frizzy@localhost out: \ load average: 0,95, 0,95, 0,94 /
frizzy@localhost out: --------------------------------------
frizzy@localhost out: \ ^__^
frizzy@localhost out: \ (oo)\_______
frizzy@localhost out: (__)\ )\/\
frizzy@localhost out: ||----w |
frizzy@localhost out: || ||
```
[original idea of example](https://github.com/kennethreitz/envoy)
#### Long Description
Factory is proof-of-concept realization of [fabric](https://github.com/fabric/fabric) with a number of differences:
* run() function works in the same way with subprocess.popen under localhost as under ssh connect to remote host
* Factory uses openssh or any another ssh client (you should modified config for this), so you can use all power of ssh sockets
* Factory uses [gevent](https://github.com/surfly/gevent) library for asynchronous executing
* Factory contains less code and tries to keep everything clear (not perfect, but trying!)
Note that Factory uses pipes for communication with subprocess.
So, there is no way to use popen and automatically write passwords for ssh and sudo on localhost,
because "smart" programs like ssh and sudo uses tty directly.
Also active tty required (needed check it) and for sudo uses "sudo -S".
Alternatives:
1) Use paramico like fabric = no ssh sockets.
2) Use pty.fork, waitpid, execv as pexcpect and sh = only unix, no separated stderr, hard to communicate.
3) Use ssh-copy-id like sh module recommended = ask passwords only one first time.
4) Use sshpass like ansible = external dependencies.
5) Use local ssh server and run all commands through it instead of popen (we need to go deeper).
Of course, you can write your own run() function with previous decisions and use it!
#### Examples:
* Using build in functions
```bash
fact run 'echo "hello, world!"'
frizzy@localhost in: echo "hello, world!"
frizzy@localhost out: hello, world!
```
* Using factfile
```bash
cat factfile
#!/usr/bin/env python
# coding=utf-8
from factory.api import run
def hello_fact():
run('echo "this is factfile"')
```
```bash
fact hello_fact
frizzy@localhost in: echo "this is factfile"
frizzy@localhost out: this is factfile
```
* Using fabfile
```bash
cat fabfile
#!/usr/bin/env python
# coding=utf-8
from fabric.api import run
def hello_fab():
run('echo "this is fabfile"')
```
```bash
fact hello_fab
frizzy@localhost in: echo "this is fabfile"
frizzy@localhost out: this is fabfile
```
* And even this
```bash
cat my_little_script.py
#!/usr/bin/env python
# coding=utf-8
from factory.api import *
def hello():
run('echo "hello world!"')
if __name__ == '__main__':
# running hello on two hosts
env.hosts = ['localhost', '[email protected]']
for host in env.hosts:
with set_connect_env(host):
hello()
run(raw_input('type the command: '))
```
```bash
python my_little_script.py
frizzy@localhost in: echo "hello world!"
frizzy@localhost out: hello world!
type the command: echo "hello, username!"
frizzy@localhost in: echo "hello, username!"
frizzy@localhost out: hello, username!
[email protected] in: echo "hello world!"
[email protected] out: hello world!
type the command: echo "hello, test"
[email protected] in: echo "hello, test"
[email protected] out: hello, test
```
#### [WiKi](https://github.com/Friz-zy/factory/wiki) will be soon
#### [Board](https://trello.com/b/TNRr7EbW/factory) on [trello](https://trello.com)
#### For contributors: [fetch and merge, don’t pull](http://longair.net/blog/2009/04/16/git-fetch-and-merge/)
#### Contributors
* [Filipp Kucheryavy aka Frizzy](mailto:[email protected])