<commit_before><commit_msg>asn: added docs<commit_after># connect.asn

Inserts a result object with the ASN of the connecting IP address. The ASN is
the [Autonomous System Number](http://en.wikipedia.org/wiki/Autonomous_System_(Internet))
that represents the bailiwick or sphere of control of a network operator. 


# Usage

    var asn = connection.results.get('connect.asn');
    if (asn && asn.asn) {
        connection.loginfo(plugin, "hey look, it's ASN: " + asn.asn);
    }


# Theory

An ASN is a very good approximation of all of the IP space under the control
of a network operator. The theory behind ASN tracking is that good network
operators police their networks, proactively limit abuse, and are less likely
to be emitting abusive connections.

Not-so-good network operators are likely to emit a greater number of abusive
connections, and should be handled with increased scrutiny.


# Consumers

The [karma](/manual/plugins/karma.html) plugin uses the ASN lookup to maintain
its network neighborhood reputation. 
{'fraction_non_alphanumeric': 0.07010710808179163, 'fraction_numerical': 0.0, 'mean_word_length': 4.271794871794872, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '5972826', 'n_tokens_mistral': 299, 'n_tokens_neox': 278, 'n_words': 128}