Skip to content

Commit

Permalink
Explain project in the README
Browse files Browse the repository at this point in the history
  • Loading branch information
Jesús Gómez committed Jul 15, 2021
1 parent df7298a commit fd1ecdc
Show file tree
Hide file tree
Showing 2 changed files with 18 additions and 63 deletions.
78 changes: 17 additions & 61 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,79 +1,35 @@
# ftp-hog

FIXME: my new application.
Inspired by [MailHog](https://github.com/mailhog/MailHog) (which was
inspired by [MailCatcher](https://mailcatcher.me/)) ftp-hog runs a
super simple FTP server suited only for developing (NEVER USE IN
PRODUCTION).

## Installation
Once running, it will be listening the port 2221 and serving the
folder `/tmp`. Connect to the server as the user `anonymous` with
empty string as the password.

Download from https://github.com/jgomo3/ftp-hog
Note: Beside all said before, this project is merly begining to be
developed so no more functionallity is provided.

I'm planning on giving options to the command line.

But my main goal is still pending: I want to provide an excecutable
exactly as MailHog does. To use MailHog you could simply download the
executable and execute it directly: one single file. A security risk,
but super simple. Let's see.

## Usage

FIXME: explanation

Run the project directly, via `:exec-fn`:

$ clojure -X:run-x
Hello, Clojure!

Run the project, overriding the name to be greeted:

$ clojure -X:run-x :name '"Someone"'
Hello, Someone!

Run the project directly, via `:main-opts` (`-m jgomo3.ftp-hog`):

$ clojure -M:run-m
Hello, World!

Run the project, overriding the name to be greeted:

$ clojure -M:run-m Via-Main
Hello, Via-Main!

Run the project's tests (they'll fail until you edit them):

$ clojure -X:test

Build an uberjar:

$ clojure -X:uberjar

This will update the generated `pom.xml` file to keep the dependencies synchronized with
your `deps.edn` file. You can update the version (and SCM tag) information in the `pom.xml` using the
`:version` argument:

$ clojure -X:uberjar :version '"1.2.3"'

If you don't want the `pom.xml` file in your project, you can remove it, but you will
also need to remove `:sync-pom true` from the `deps.edn` file (in the `:exec-args` for `depstar`).

Run that uberjar:

$ java -jar ftp-hog.jar

## Options

FIXME: listing of options this app accepts.

## Examples

...

### Bugs

...

### Any Other Sections
### That You Think
### Might be Useful

## License

Copyright © 2021 Monkey

_EPLv1.0 is just the default for projects generated by `clj-new`: you are not_
_required to open source this project, nor are you required to use EPLv1.0!_
_Feel free to remove or change the `LICENSE` file and remove or update this_
_section of the `README.md` file!_
Copyright © 2021 Jesús Gómez (jgomo3)

Distributed under the Eclipse Public License version 1.0.
3 changes: 1 addition & 2 deletions deps.edn
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,7 @@
:aliases
{:run-m {:main-opts ["-m" "jgomo3.ftp-hog"]}
:run-x {:ns-default jgomo3.ftp-hog
:exec-fn greet
:exec-args {:name "Clojure"}}
:exec-fn run}
:test {:extra-paths ["test"]
:extra-deps {org.clojure/test.check {:mvn/version "1.1.0"}
io.github.cognitect-labs/test-runner
Expand Down

0 comments on commit fd1ecdc

Please sign in to comment.