commutator 0.1.0

data/lib/commutator/util/placeholders.rb

@@ -0,0 +1,607 @@
+require 'ice_nine'
+
+module Commutator
+  module Util
+    # Provides a placeholder string for a name or value for use in DynamoDB
+    # expressions.
+    #
+    # Name placeholders will return the name itself if it is not
+    # a reserved word (and therefore safe to use).
+    #
+    # Value placeholders are always generated.
+    module Placeholders
+      def self.value(value)
+        ":V_#{hash(value)}"
+      end
+
+      def self.name(name)
+        RESERVED_WORDS.include?(name.downcase) ? "#N_#{hash(name)}" : name
+      end
+
+      private
+
+      # Wow. Dang.
+      RESERVED_WORDS = IceNine.deep_freeze(%w(
+        abort
+        absolute
+        action
+        add
+        after
+        agent
+        aggregate
+        all
+        allocate
+        alter
+        analyze
+        and
+        any
+        archive
+        are
+        array
+        as
+        asc
+        ascii
+        asensitive
+        assertion
+        asymmetric
+        at
+        atomic
+        attach
+        attribute
+        auth
+        authorization
+        authorize
+        auto
+        avg
+        back
+        backup
+        base
+        batch
+        before
+        begin
+        between
+        bigint
+        binary
+        bit
+        blob
+        block
+        boolean
+        both
+        breadth
+        bucket
+        bulk
+        by
+        byte
+        call
+        called
+        calling
+        capacity
+        cascade
+        cascaded
+        case
+        cast
+        catalog
+        char
+        character
+        check
+        class
+        clob
+        close
+        cluster
+        clustered
+        clustering
+        clusters
+        coalesce
+        collate
+        collation
+        collection
+        column
+        columns
+        combine
+        comment
+        commit
+        compact
+        compile
+        compress
+        condition
+        conflict
+        connect
+        connection
+        consistency
+        consistent
+        constraint
+        constraints
+        constructor
+        consumed
+        continue
+        convert
+        copy
+        corresponding
+        count
+        counter
+        create
+        cross
+        cube
+        current
+        cursor
+        cycle
+        data
+        database
+        date
+        datetime
+        day
+        deallocate
+        dec
+        decimal
+        declare
+        default
+        deferrable
+        deferred
+        define
+        defined
+        definition
+        delete
+        delimited
+        depth
+        deref
+        desc
+        describe
+        descriptor
+        detach
+        deterministic
+        diagnostics
+        directories
+        disable
+        disconnect
+        distinct
+        distribute
+        do
+        domain
+        double
+        drop
+        dump
+        duration
+        dynamic
+        each
+        element
+        else
+        elseif
+        empty
+        enable
+        end
+        equal
+        equals
+        error
+        escape
+        escaped
+        eval
+        evaluate
+        exceeded
+        except
+        exception
+        exceptions
+        exclusive
+        exec
+        execute
+        exists
+        exit
+        explain
+        explode
+        export
+        expression
+        extended
+        external
+        extract
+        fail
+        false
+        family
+        fetch
+        fields
+        file
+        filter
+        filtering
+        final
+        finish
+        first
+        fixed
+        flattern
+        float
+        for
+        force
+        foreign
+        format
+        forward
+        found
+        free
+        from
+        full
+        function
+        functions
+        general
+        generate
+        get
+        glob
+        global
+        go
+        goto
+        grant
+        greater
+        group
+        grouping
+        handler
+        hash
+        have
+        having
+        heap
+        hidden
+        hold
+        hour
+        identified
+        identity
+        if
+        ignore
+        immediate
+        import
+        in
+        including
+        inclusive
+        increment
+        incremental
+        index
+        indexed
+        indexes
+        indicator
+        infinite
+        initially
+        inline
+        inner
+        innter
+        inout
+        input
+        insensitive
+        insert
+        instead
+        int
+        integer
+        intersect
+        interval
+        into
+        invalidate
+        is
+        isolation
+        item
+        items
+        iterate
+        join
+        key
+        keys
+        lag
+        language
+        large
+        last
+        lateral
+        lead
+        leading
+        leave
+        left
+        length
+        less
+        level
+        like
+        limit
+        limited
+        lines
+        list
+        load
+        local
+        localtime
+        localtimestamp
+        location
+        locator
+        lock
+        locks
+        log
+        loged
+        long
+        loop
+        lower
+        map
+        match
+        materialized
+        max
+        maxlen
+        member
+        merge
+        method
+        metrics
+        min
+        minus
+        minute
+        missing
+        mod
+        mode
+        modifies
+        modify
+        module
+        month
+        multi
+        multiset
+        name
+        names
+        national
+        natural
+        nchar
+        nclob
+        new
+        next
+        no
+        none
+        not
+        null
+        nullif
+        number
+        numeric
+        object
+        of
+        offline
+        offset
+        old
+        on
+        online
+        only
+        opaque
+        open
+        operator
+        option
+        or
+        order
+        ordinality
+        other
+        others
+        out
+        outer
+        output
+        over
+        overlaps
+        override
+        owner
+        pad
+        parallel
+        parameter
+        parameters
+        partial
+        partition
+        partitioned
+        partitions
+        path
+        percent
+        percentile
+        permission
+        permissions
+        pipe
+        pipelined
+        plan
+        pool
+        position
+        precision
+        prepare
+        preserve
+        primary
+        prior
+        private
+        privileges
+        procedure
+        processed
+        project
+        projection
+        property
+        provisioning
+        public
+        put
+        query
+        quit
+        quorum
+        raise
+        random
+        range
+        rank
+        raw
+        read
+        reads
+        real
+        rebuild
+        record
+        recursive
+        reduce
+        ref
+        reference
+        references
+        referencing
+        regexp
+        region
+        reindex
+        relative
+        release
+        remainder
+        rename
+        repeat
+        replace
+        request
+        reset
+        resignal
+        resource
+        response
+        restore
+        restrict
+        result
+        return
+        returning
+        returns
+        reverse
+        revoke
+        right
+        role
+        roles
+        rollback
+        rollup
+        routine
+        row
+        rows
+        rule
+        rules
+        sample
+        satisfies
+        save
+        savepoint
+        scan
+        schema
+        scope
+        scroll
+        search
+        second
+        section
+        segment
+        segments
+        select
+        self
+        semi
+        sensitive
+        separate
+        sequence
+        serializable
+        session
+        set
+        sets
+        shard
+        share
+        shared
+        short
+        show
+        signal
+        similar
+        size
+        skewed
+        smallint
+        snapshot
+        some
+        source
+        space
+        spaces
+        sparse
+        specific
+        specifictype
+        split
+        sql
+        sqlcode
+        sqlerror
+        sqlexception
+        sqlstate
+        sqlwarning
+        start
+        state
+        static
+        status
+        storage
+        store
+        stored
+        stream
+        string
+        struct
+        style
+        sub
+        submultiset
+        subpartition
+        substring
+        subtype
+        sum
+        super
+        symmetric
+        synonym
+        system
+        table
+        tablesample
+        temp
+        temporary
+        terminated
+        text
+        than
+        then
+        throughput
+        time
+        timestamp
+        timezone
+        tinyint
+        to
+        token
+        total
+        touch
+        trailing
+        transaction
+        transform
+        translate
+        translation
+        treat
+        trigger
+        trim
+        true
+        truncate
+        ttl
+        tuple
+        type
+        under
+        undo
+        union
+        unique
+        unit
+        unknown
+        unlogged
+        unnest
+        unprocessed
+        unsigned
+        until
+        update
+        upper
+        url
+        usage
+        use
+        user
+        users
+        using
+        uuid
+        vacuum
+        value
+        valued
+        values
+        varchar
+        variable
+        variance
+        varint
+        varying
+        view
+        views
+        virtual
+        void
+        wait
+        when
+        whenever
+        where
+        while
+        window
+        with
+        within
+        without
+        work
+        wrapped
+        write
+        year
+        zone
+      ))
+
+      private_constant :RESERVED_WORDS
+
+      def self.hash(val)
+        Digest::SHA1.hexdigest(val.to_json).first(10)
+      end
+    end
+  end
+end

data/lib/commutator/version.rb

@@ -0,0 +1,3 @@
+module Commutator
+  VERSION = "0.1.0"
+end

data/lib/commutator.rb

@@ -0,0 +1,64 @@
+require "aws-sdk"
+
+require "active_model"
+
+require "active_support"
+require "active_support/core_ext"
+
+
+module Commutator
+  API_TABLE_OPERATIONS = [
+    :create_table,
+    :delete_table,
+    :describe_table,
+    :list_tables,
+    :update_table
+  ].freeze
+
+  API_ITEM_OPERATIONS = [
+    :batch_get_item,
+    :batch_write_item,
+    :delete_item,
+    :get_item,
+    :put_item,
+    :update_item,
+    :query,
+    :scan
+  ].freeze
+
+  API_OPERATIONS = (
+  API_TABLE_OPERATIONS +
+    API_ITEM_OPERATIONS
+  ).freeze
+
+  autoload :Collection, "commutator/collection"
+  autoload :ItemModifiers, "commutator/item_modifiers"
+  autoload :Model, "commutator/model"
+  autoload :SimpleClient, "commutator/simple_client"
+
+  module Expressions
+    autoload :AttributeNames, "commutator/expressions/attribute_names"
+    autoload :AttributeValues, "commutator/expressions/attribute_values"
+    autoload :ConditionExpression, "commutator/expressions/condition_expression"
+    autoload :ProjectionExpression, "commutator/expressions/projection_expression"
+    autoload :Statement, "commutator/expressions/statement"
+    autoload :UpdateExpression, "commutator/expressions/update_expression"
+  end
+
+  module Options
+    autoload :DeleteItem, "commutator/options/delete_item"
+    autoload :GetItem, "commutator/options/get_item"
+    autoload :Proxy, "commutator/options/proxy"
+    autoload :PutItem, "commutator/options/put_item"
+    autoload :Query, "commutator/options/query"
+    autoload :Scan, "commutator/options/scan"
+    autoload :UpdateItem, "commutator/options/update_item"
+  end
+
+  module Util
+    autoload :Fluent, "commutator/util/fluent"
+    autoload :Placeholders, "commutator/util/placeholders"
+  end
+end
+
+require "commutator/version"