Skip to content
This repository has been archived by the owner. It is now read-only.
Let's make Swift scripting a reality.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
apous.xcodeproj
misc
samples
src
test
.gitignore
Features.md
LICENSE
Makefile
README.md

README.md

 _______
|   _   .-----.-----.--.--.-----.
|.  1   |  _  |  _  |  |  |__ --|
|.  _   |   __|_____|_____|_____|
|:  |   |__|
|::.|:. |
`--- ---'

Apous GitHub license GitHub release

Apous is a simple tool that allows for easier authoring of Swift scripts.

Primary features:

  1. Allow the breaking up of scripts into multiple files.
  2. Dependency management through Carthage or CocoaPods.

How it Works

Apous works by first checking for a Cartfile or Podfile in your script's directory. If one is present, then carthage update or pod install --no-integrate will be run.

Next, all of your Swift files are compiled into a single .apousscript binary that will then be run automatically for you.

It's really that simple.

Getting Started

First, you need to install the latest build of Apous.

  1. Download the latest version of apous from "Releases".
  2. Copy it to a location in your path, such as /usr/local/bin/.

Homebrew support is pending: https://github.com/Homebrew/homebrew/pull/41473

Creating Your First Script

  1. Create a new directory for your scripts, say mkdir demo

  2. Change to that directory: cd demo

  3. Create a new script file: touch demo.swift

  4. Change the contents of the file to:

    import Foundation
    
    print("Welcome to Apous!")
  5. Run the script: apous .

This will output:

Welcome to Apous!

You can see some other samples here: Samples.

Alternatively

Apous also supports running scripts with #!. Note that your entry point script must be named main.swift.

#!/usr/local/bin/apous

import Foundation

print("Welcome to Apous!")

Then run:

> chmod +x main.swift
> ./main.swift
Welcome to Apous!

FAQ

Q: What is Apous mean?

A: It's from the ancient Greek απους, meaning "without feet".

You can’t perform that action at this time.