Example

Steps

1. Write your Python code
2. Use jmp-compile on a host computer to translate into the compact jmp bytecode format (example)
3. In your deployment systems, create a MiniPython instance, add modules and load the byte code (Java) (Objective C)

Python Source

Write your Python code:

launches=0

def get_brightness(base):
  if time.day_of_week() == 4 and launches < 3:
     return base+10
  return base+7

jmp-compile

Turn that into the bytecode that Jia Mini Python uses with jmp-compile. This checks the syntax, tokenizes and produces a smaller file. The output is by default the same filename as the input but with an extension of .jmp:

jmp-compile settings.py

Java

Add the Jia Mini Python java source file to your project. It is one .java file and you can put it anywhere. Using your own namespace is recommended. This means you do not have to worry about anyone else using it as well, having version clashes etc.

// make new instance
MiniPython mp=new MiniPython();

// make methods available
class timestuff {
     int day_of_week() { return 4; }
}

mp.addModule("time", new timestuff());

// provide print and other Client behaviour
mp.setClient(new MiniPython.Client() {
    @Override
    void print(String s) {
         System.out.print(s);
    }
    @Override
    void onError(Execution error) {
      // a single location to log, dissect or otherwise deal
      // with any error
    }
});

// give it code to run in an inputStream from a file, network etc
mp.setCode(new FileInputStream("settings.jmp"));

// Call a method passing in one parameter
int brightness=(Integer)mp.callMethod("get_brightness", 2);

Objective C

Add MiniPython.h to relevant files, and MiniPython.m to your project. Use it like this.

// the module we want to add
@interface timestuff
@end

@implementation timestuf
- (int) day_of_week {
  return 4;
}
@end

// MiniPythonClientDelegate methods
- (void)print:(NSString *)s {
    NSLog(@"MiniPython: %@", s);
}

- (void)onError:(NSError *)e {
     // a single location to log, dissect or otherwise deal
     // with any error
}

// make new instance
MiniPython *mp=[[MiniPython alloc] init];

[mp addModule:[[timestuff alloc] init] named:@"time"];
[mp setClient:self];

// give it code to run
NSInputStream *input=[NSInputStream inputStreamWithFileAtPath:filename];
[input open];

NSError *error;
BOOL success=[mp setCode:input error:&error];

// call a method passing in one parameter
int brightness=[(NSNumber*)[mp callMethod:@"get_brightness" args:@[@2] error:&error] intValue];