Metadata-Version: 1.0
Name: sometimes
Version: 0.1.2
Summary: Stop being so black and white. Mix things up a bit and execute code sometimes.
Home-page: https://github.com/aaronbassett/sometimes
Author: Aaron Bassett
Author-email: me@aaronbassett.com
License: LICENSE
Description: sometimes
        ======================
        
        Stop being so black and white. Mix things up a bit and execute code sometimes.
        This is a Python port of the `Ruby sometimes gem
        <https://github.com/sudara/sometimes>`_.
        
        Installation
        ------------
        
        You can install via ``pip``::
            
            $ pip install sometimes
            
        Or by cloning from Github::
        
            $ git clone git@github.com:aaronbassett/sometimes.git
            $ cd sometimes
            $ python setup.py install
        
        Usage
        --------
        
        Say something every other time::
        
            from sometimes import sometimes
            
            @sometimes
            def hello():
                print "Hey, you are awesome. You really are."  # executes warm fuzzies 50% of the time
        
        Have a 50% chance of saying something::
        
            from sometimes import sometimesish
            
            @sometimesish
            def hello():
                print "Hey, you are awesome. You really are."
        
        Maybe you want to do something several times, but not always the exact same number of times::
        
            from sometimes import times
            
            @times(4,10)
            def pick_nose():
                pass
        
        Maybe you want to remind someone of something, but not toooo often (It gets annoying!)::
        
            from sometimes import percent_of_the_time
            
            @percent_of_the_time(15)
            def naughty():
                print "Howdy, Don't forget to register!"  # be annoying, but only 15% of the time
            
            @percent_of_the_time(33)
            def be_very_polite():
                pass
        
        Share a rare moment with your user::
        
            from sometimes import rarely
            
            @rarely()
            def spam():
                print "How would you like some spammy spam spam!"  # be really annoying about 5% of the time
        
        Do something most of the time::
        
            from sometimes import mostly
            
            @mostly()
            def be_awesome():
                print "Want to see something really cool?"  # Be awesome about 95% of the time
        
        Hold on a minute
        -----------------
        
        Why does it have ``@sometimes`` and ``@sometimesish``? I wanted ``sometimes`` to behave as described 
        by the gem docs, not how it operates in the gem. I included ``sometimesish`` if anyone wanted the 
        gem style functionality.
        
        License
        -------
        
        MIT: http://aaron.mit-license.org
Platform: UNKNOWN
