Git Product home page Git Product logo

fx's Introduction

fx

Poor man's function as a service.
build Go Report Card Go Doc Release

Introduction

fx is a tool to help you do Function as a Service on your own server. fx can make your stateless function a service in seconds. The most exciting thing is that you can write your functions with most programming languages.

Language Status Contributor
Go Supported fx
Node Supported fx
Python Supported fx
Ruby Supported fx
PHP Supported @chlins
Julia Supported @mbesancon
Java No
Scala No
Perl Working on
.Net Working on
R Working on
Rust Working on

Welcome to tweet me or Buy me a coffee

Usage

Requirements
  • Docker: make sure Docker installed and running on your server.
  • dep: fx project uses dep to do the golang dependency management.
Build and Run
$ git clone https://github.com/metrue/fx.git
$ cd fx
$ dep ensure
$ go install ./
  • start server
fx serve

now you can make a function to service in a second.

fx up ./examples/functions/func.js

the function defined in examples/functions/func.js is quite simple, it calculates the sum of two numbers then returns:

module.exports = (input) => {
    return parseInt(input.a, 10) + parseInt(input.b, 10)
}

then you can test your service:

curl -X POST <service url> -H "Content-Type: application/json" -d '{"a": 1, "b": 1}'

of course you can do more.

Usage:
$ fx serve                                      start f(x) server
$ fx up   func1.js func2.py func3.go ...        deploy a function or a group of functions
$ fx down [service ID] ...                      destroy a function or a group of functions
$ fx list                                       list deployed services
$ fx --version                                  show current version of f(x)

How to write your function

functions example with Go, Ruby, Python, Node, PHP.

  • Go
package main

type Input struct {
	A int32
	B int32
}

type Output struct {
	Sum int32
}

func Fx(input *Input) (output *Output) {
	output = &Output{
		Sum: input.A + input.B,
	}
	return
}
  • Ruby
def fx(input)
    return input['a'] + input['b']
end
  • Python
def fx(input):
    return input['a'] + input['b']
  • Node
module.exports = (input) => {
    return parseInt(input.a, 10) + parseInt(input.b, 10)
}
  • PHP
<?php
    function Fx($input) {
        return $input["a"]+$input["b"];
    }
  • Julia
struct Input
    a::Number
    b::Number
end

fx = function(input::Input)
    return input.a + input.b
end

Contributors

Thank you to all the people who already contributed to fx!

metrue pplam mbesancon avelino DaidoujiChen chlins

LICENSE

MIT

fx's People

Contributors

metrue avatar pplam avatar matbesancon avatar chlins avatar daidoujichen avatar avelino avatar johnlunney avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.