.gitattributes

@@ -1,3 +1,3 @@
-* text=auto
+* text=auto eol=lf
 *.ai binary
 *.js text eol=lf

.travis.yml

@@ -1,7 +1,5 @@
-sudo: false
 language: node_js
 node_js:
+  - '10'
   - '8'
-  - '6'
-  - '4'
 after_success: npm run coveralls

advanced-creation.md

@@ -0,0 +1,113 @@
+# Advanced creation
+
+> Make calling REST APIs easier by creating niche-specific `got` instances.
+
+#### got.create(settings)
+
+Example: [gh-got](https://github.com/sindresorhus/gh-got/blob/master/index.js)
+
+Configure a new `got` instance with the provided settings.<br>
+**Note:** In contrast to `got.extend()`, this method has no defaults.
+
+##### [options](readme.md#options)
+
+To inherit from parent, set it as `got.defaults.options` or use [`got.mergeOptions(defaults.options, options)`](readme.md#gotmergeoptionsparentoptions-newoptions).<br>
+**Note**: Avoid using [object spread](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Spread_syntax#Spread_in_object_literals) as it doesn't work recursively.
+
+##### methods
+
+Type: `Object`
+
+Array of supported request methods.
+
+To inherit from parent, set it as `got.defaults.methods`.
+
+##### handler
+
+Type: `Function`<br>
+Default: `undefined`
+
+Function making additional changes to the request.
+
+To inherit from parent, set it as `got.defaults.handler`.<br>
+To use the default handler, just omit specifying this.
+
+###### [options](readme.md#options)
+
+**Note:** These options are [normalized](source/normalize-arguments.js).
+
+###### next()
+
+Returns a `Promise` or a `Stream` depending on [`options.stream`](readme.md#stream).
+
+```js
+const settings = {
+	handler: (options, next) => {
+		if (options.stream) {
+			// It's a Stream
+			// We can perform stream-specific actions on it
+			return next(options)
+				.on('request', request => setTimeout(() => request.abort(), 50));
+		}
+
+		// It's a Promise
+		return next(options);
+	},
+	methods: got.defaults.methods,
+	options: got.mergeOptions(got.defaults.options, {
+		json: true
+	})
+};
+
+const jsonGot = got.create(settings);
+```
+
+```js
+const defaults = {
+	handler: (options, next) => next(options),
+	methods: [
+		'get',
+		'post',
+		'put',
+		'patch',
+		'head',
+		'delete'
+	],
+	options: {
+		retries: 2,
+		cache: false,
+		decompress: true,
+		useElectronNet: false,
+		throwHttpErrors: true,
+		headers: {
+			'user-agent': `${pkg.name}/${pkg.version} (https://github.com/sindresorhus/got)`
+		}
+	}
+};
+
+// Same as:
+const defaults = {
+	handler: got.defaults.handler,
+	methods: got.defaults.methods,
+	options: got.defaults.options
+};
+
+const unchangedGot = got.create(defaults);
+```
+
+```js
+const settings = {
+	handler: got.defaults.handler,
+	methods: got.defaults.methods,
+	options: got.mergeOptions(got.defaults.options, {
+		headers: {
+			unicorn: 'rainbow'
+		}
+	})
+};
+
+const unicorn = got.create(settings);
+
+// Same as:
+const unicorn = got.extend({headers: {unicorn: 'rainbow'}});
+```

appveyor.yml

@@ -0,0 +1,19 @@
+environment:
+  matrix:
+    - nodejs_version: '10'
+    - nodejs_version: '8'
+install:
+  - ps: Install-Product node $env:nodejs_version
+  - npm install --global npm@latest
+  - set PATH=%APPDATA%\npm;%PATH%
+  - npm install
+matrix:
+  fast_finish: true
+build: off
+shallow_clone: true
+test_script:
+  - node --version
+  - npm --version
+  - npm test
+cache:
+  - '%APPDATA%\npm-cache'