Skip to content

Commit e3e75a2

Browse files
author
David Futcher
committed
Update README and CHANGELOG for 0.2.0
1 parent ad762c2 commit e3e75a2

2 files changed

Lines changed: 12 additions & 8 deletions

File tree

CHANGELOG

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
1-
## [0.2.0] -
1+
## [0.2.0] - 2016-08-06
22

33
- Automatically detect content type of file when uploading. Stops users having to manually change mime-types for use-cases where content type is important (static websites). Issue #2
44
- Add option to make files publicly readable (use -public flag)
55
- Completely reorganised source code (using packages), added top level comments
66

7-
## [0.1.1] - 2016-07-05
7+
## [0.1.1] - 2016-08-05
88

99
- Significantly rewritten code to linter standards
1010
- Support simple asterisk globbing (for example *.go) in Ignore configuration

README.md

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,16 +6,20 @@ It can be used for deploying [static websites hosted on S3](http://docs.aws.amaz
66
## Features
77
- Simple method to deploy git repos to S3.
88
- Fast uploads by only uploading new commits.
9-
- Single binary, no [dependencies on language runtimes](https://github.com/schickling/git-s3)
9+
- Automatically detects and sets the S3 content type of files.
10+
- Can automatically make your files publicly available (private by default).
11+
- Single binary, no [dependencies on language runtimes](https://github.com/schickling/git-s3).
1012

1113
## Installation
1214

13-
git-s3-push depends on [`magicmime`](https://github.com/rakyll/magicmime), which in turn depends on `libmagic`. On Arch install the `file` package, on Debian based systems you need `libmagic1` and `libmagic-devel`.
14-
1515
Grab a binary for your platform from the releases. Or check out the code, run `go get` and `go run git-s3-push.go`.
1616

1717
Git must be installed on your path.
1818

19+
### Dependencies
20+
21+
On Unix-like platforms (Linux, Mas OS, BSDs etc.) `git-s3-push` depends on [`magicmime`](https://github.com/rakyll/magicmime) for file content-type detection, which in turn depends on `libmagic`. On Arch install the `file` package, on Debian based systems you need `libmagic1` and `libmagic-devel`, on Mac OS run `brew install libmagic`. This is *not* required on Windows, which uses Golang's built-in mimetype detection.
22+
1923
## Usage
2024
Authentication credentials are taken from the standard AWS environment variables. Bucket name and AWS region are supplied as arguments.
2125

@@ -30,14 +34,14 @@ The `-save` flag stores the bucket name and region so you can push to the same l
3034

3135
```$ git-s3-push```
3236

37+
The `-public` flag can be used to make the files uploaded to your bucket publicly readable. When running without the `-public` flag, pushed files are stored privately.
38+
3339
All usage options can be shown using the `-help` flag.
3440

3541
## Config
3642
After using the `-save` flag, `git-s3-push` creates a JSON configuration file (`.git_s3_push`) storing bucket and region information. This file also includes other configuration directives that cannot be specified using flags:
3743

38-
- `Ignore`: Files in the git repo that *should not* be pushed. This could include source files (for example .coffee files), or any other file in the git repository you don't want pushed to the S3 bucket. Files are specified in a JSON list of Go regexes. For example:
39-
40-
`"Ignore":[".*\\.coffee"]`
44+
- `Ignore`: Files in the git repo that *should not* be pushed. This could include source files (for example .coffee files), or any other file in the git repository you don't want pushed to the S3 bucket. Files are specified in a JSON list of regexes. For example: `"Ignore":["src/*.coffee"]`
4145

4246
- `IncludeNonGit`: Files not tracked by git that should be pushed to the destination bucket. Files are specified in a JSON list of paths. Paths can be absolute or relative to the root of the git repository.
4347

0 commit comments

Comments
 (0)