-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Jesús Gómez
committed
Jul 15, 2021
1 parent
df7298a
commit fd1ecdc
Showing
2 changed files
with
18 additions
and
63 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters