Merge branch 'rewrite'

Author: amishshah

.gitignore

@@ -36,3 +36,4 @@ build/Release
 node_modules
 test/auth.json
 examples/auth.json
+test/spotify.js

.travis.yml

@@ -2,5 +2,8 @@ language: node_js
 node_js:
   - "stable"
 cache:
-directories:
-  - node_modules
+    directories:
+    - node_modules
+branches:
+  only:
+    - master

.vscode/settings.json

@@ -1,2 +1,5 @@
 // Place your settings in this file to overwrite default and user settings.
-{ "editor.wrappingColumn": 0 }
+{
+	"editor.wrappingColumn": 0,
+	"editor.formatOnType": true
+}

README.md

@@ -4,7 +4,7 @@
   </a>
 </p>
 
-# The API is being rewritten for stability, have a look [here](https://github.com/hydrabolt/discord.js/tree/rewrite) for more. It will feature voice!
+# Did v5.0.0 break your code? [Look here.](http://discordjs.readthedocs.org/en/rewrite-docs/migrating.html)
 
 [![Build Status](https://travis-ci.org/hydrabolt/discord.js.svg)](https://travis-ci.org/hydrabolt/discord.js) [![Documentation Status](https://readthedocs.org/projects/discordjs/badge/?version=latest)](http://discordjs.readthedocs.org/en/latest/?badge=latest)
 
@@ -37,31 +37,11 @@ mybot.login("email", "password");
 ```
 ---
 
-### What's new in 3.9.0?
+### What's new in 5.0.0?
 
-Amongst some fixes to web distribution creation, you can now opt for easier string formatting! However, it does modify String globally so you'll have to run:
+Stability in general! The API has been rewritten completely for much better stability, and it seems to have worked! There are now no random crashes and everything caches properly. The API is also a bit cleaner!
 
-```js
-Discord.patchStrings()
-```
-
-After you have run this, you can do:
-```
-
-"message".bold.underline.italic
-// generates "*__**message**__*"
-
-```
-
-A full list of modifiers (all chainable):
-
-* bold `**`
-* italic `*`
-* underline `__`
-* strike `~`
-* code `` ` ``
-* codeblock ```` ``` ````
-* newline `\n`
+However, it is a breaking change if you are updating (potentially, basic code should be fine) you should look [here](http://discordjs.readthedocs.org/en/rewrite-docs/migrating.html) for help updating.
 
 ---
 
@@ -108,4 +88,4 @@ If you have an issue or want to know if a feature exists, [read the documentatio
 
 
 If you would like to contact me, you can create an issue on the GitHub repo, e-mail me via the one available on my NPM profile.
-Or you could just send a DM to **hydrabolt** in [**Discord API**](https://discord.gg/0SBTUU1wZTYd2XyW).
+Or you could just send a DM to **hydrabolt** in [**Discord API**](https://discord.gg/0SBTUU1wZTYd2XyW).

docs/create_simple_bot.rst

@@ -0,0 +1,43 @@
+.. include:: ./vars.rst
+
+Cache
+=====
+
+**extends Array**
+
+A Cache object extends an Array (so it can be used like a regular array) but introduces helper functions to make it more useful when developing with discord.js. Unlike a regular array, it doesn't care about the instance or prototype of an object, it works purely on properties.
+
+-----
+
+Functions
+---------
+
+get(key, value)
+~~~~~~~~~~~~~~~
+
+Returns a contained object where ``object[key] == value``. Returns the first object found that matches the criteria.
+
+getAll(key, value)
+~~~~~~~~~~~~~~~~~~
+
+Similar to ``cache.get(key, value)``, but returns a Cache of any objects that meet the criteria. 
+
+has(key, value)
+~~~~~~~~~~~~~~~
+
+Returns `true` if there is an object that meets the condition ``object[key] == value`` in the cache
+
+add(data)
+~~~~~~~~~
+
+Adds an object to the Cache as long as all the other objects in the cache don't have the same ID as it.
+
+update(old, data)
+~~~~~~~~~~~~~~~~~
+
+Updates an old object in the Cache (if it exists) with the new one.
+
+remove(data)
+~~~~~~~~~~~~
+
+Removes an object from the cache if it exists.

docs/docs_cache.rst

@@ -1,82 +1,23 @@
-.. include:: ./vars.rst
-
-Channels
-========
-
-The Channel Class is used to represent data about a Channel.
-
-Attributes
-----------
-
-client
-~~~~~~
-
-The Discord Client_ that cached the channel
-
-server
-~~~~~~
-
-The Server_ that the channel belongs to
-
-name
-~~~~
-
-The channel's name, as a `String`.
-
-id
-~~
-
-The channel's id, as a `String`.
-
-type
-~~~~
-
-The type of the channel as a `String`, either ``text`` or ``voice``.
-
-topic
-~~~~~
-
-A `String` that is the topic of the channel, if the channel doesn't have a topic this will be `null`.
-
-messages
-~~~~~~~~
-
-An `Array` of Message_ objects received from the channel. There are up to a 1000 messages here, and the older messages will be deleted if necessary.
-
-members
-~~~~~~~
-
-**Aliases** : `users`
-
-The members in the channel's server, an `Array` of User_ objects.
-
------
-
-Functions
----------
-
-.. note:: When concatenated with a String, the object will become the channel's embed code, e.g. ``"this is " + channel`` would be ``this is <#channelid>``
-
-getMessage(key, value)
-~~~~~~~~~~~~~~~~~~~~~~
-
-Gets a Message_ from the channel that matches the specified criteria. E.g:
-
-.. code-block:: js
-
-    channel.getMessage("id", 1243987349) // returns a Message where message.id === 1243987349
-    
-- **key** - a `String` that is the key
-- **value** - a `String` that is the value
-
-permissionsOf(user)
-~~~~~~~~~~~~~~~~~~~
-
-Gets the EvaluatedPermissions_ of a User in the channel.
-
-- **user** - A User_ or Member_ you want to get the permissions of.
-
-equals(object)
-~~~~~~~~~~~~~~
-
-Returns a `Boolean` depending on whether the Channel's ID (``channel.id``) equals the object's ID (``object.id``). You should **always**, always use this if you want to compare channels. **NEVER** do ``channel1 == channel2``.
+.. include:: ./vars.rst
+
+Channel
+=======
+
+**extends** Equality_
+
+The Channel class is the base class for all types of channel.
+
+Attributes
+----------
+
+--------
+
+id
+~~
+
+The ID of the channel, a `String`.
+
+client
+~~~~~~
+
+The Client_ that cached the channel.