This file is indexed.

/usr/lib/python3/dist-packages/python_crontab-1.8.1.egg-info is in python3-crontab 1.8.1-2.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
Metadata-Version: 1.1
Name: python-crontab
Version: 1.8.1
Summary: Python Crontab API
Home-page: https://launchpad.net/python-crontab
Author: Martin Owens
Author-email: doctormo@gmail.com
License: GPLv3
Description: .. image:: https://launchpadlibrarian.net/134092458/python-cron-192.png
            :class: floating-box
            :alt: Python Crontab Logo
        
        Bug Reports and Development
        ===========================
        
        Please report any problems to the `launchpad bug tracker <https://bugs.launchpad.net/python-crontab>`_. Please use Bazaar and push patches to the `launchpad project code hosting <https://code.launchpad.net/python-crontab>`_.
        
        **Note:** If you get the error ``TypeError: __init__() takes exactly 2 arguments`` when using CronTab, you have the wrong module installed. You need to install ``python-crontab`` and not ``crontab`` from pypi or your local package manager and try again.
        
        
        Description
        ===========
        
        Crontab module for read and writing crontab files and accessing the system cron
        automatically and simply using a direct API.
        
        Comparing the `below chart <http://en.wikipedia.org/wiki/Cron#CRON_expression>`_
        you will note that W, L, # and ? symbols are not supported as they are not
        standard Linux or SystemV crontab format.
        
        ============= =========== ================= =================== =============
        Field Name    Mandatory   Allowed Values    Special Characters  Extra Values
        ============= =========== ================= =================== =============
        Minutes       Yes         0-59              \* / , -             < >
        Hours         Yes         0-23              \* / , -             < >
        Day of month  Yes         1-31              \* / , -             < >
        Month         Yes         1-12 or JAN-DEC   \* / , -             < >
        Day of week   Yes         0-6 or SUN-SAT    \* / , -             < >
        ============= =========== ================= =================== =============
        
        Extra Values are '<' for minimum value, such as 0 for minutes or 1 for months.
        And '>' for maximum value, such as 23 for hours or 12 for months.
        
        Supported special cases allow crontab lines to not use fields.
        These are the supported aliases which are not available in SystemV mode:
        
        =========== ===========
        Case        Meaning
        =========== ===========
        @reboot     Every boot
        @hourly     0 * * * *
        @daily      0 0 * * *
        @weekly     0 0 * * 0
        @monthly    0 0 1 * *
        @yearly     0 0 1 1 *
        @annually   0 0 1 1 *
        @midnight   0 0 * * *
        =========== ===========
        
        How to Use the Module
        =====================
        
        Getting access to a crontab can happen in five ways, three system methods that
        will work only on Unix and require you to have the right permissions::
        
            from crontab import CronTab
        
            system_cron   = CronTab()
            my_user_cron  = CronTab(user=True)
            users_cron    = CronTab(user='username')
        
        And two ways from non-system sources that will work on Windows too::
        
            file_cron = CronTab(tabfile='filename.tab')
            mem_cron = CronTab(tab="""
              * * * * * command
            """)
        
        Creating a new job is as simple as::
        
            job  = cron.new(command='/usr/bin/echo')
        
        And setting the job's time restrictions::
        
            job.minute.during(5,50).every(5)
            job.hour.every(4)
            job.day.on(4, 5, 6)
        
            job.dow.on('SUN')
            job.month.during('APR', 'NOV')
        
        Each time restriction will clear the previous restriction::
        
            job.hour.every(10) # Set to * */10 * * *
            job.hour.on(2)     # Set to * 2 * * *
        
        Appending restrictions is explicit::
        
            job.hour.every(10)  # Set to * */10 * * *
            job.hour.also.on(2) # Set to * 2,*/10 * * *
        
        Setting all time slices at once::
        
            job.setall(2, 10, '2-4', '*/2', None)
            job.setall('2 10 * * *')
        
        Creating a job with a comment::
        
            job = cron.new(command='/foo/bar', comment='SomeID')
        
        Get the comment or command for a job::
        
            command = job.command
            comment = job.comment
        
        Modify the comment or command on a job::
        
            job.set_command("new_script.sh")
            job.set_comment("New ID or comment here")
        
        Disabled or Enable Job::
        
            job.enable()
            job.enable(False)
            False == job.is_enabled()
        
        Validity Check::
        
            True == job.is_valid()
        
        Use a special syntax::
        
            job.every_reboot()
        
        Find an existing job by command::
        
            iter = cron.find_command('bar')
        
        Find an existing job by comment::
        
            iter = cron.find_comment('ID or some text')
        
        Find an existing job by schedule::
        
            iter = cron.find_time(2, 10, '2-4', '*/2', None)
            iter = cron.find_time("*/2 * * * *")
        
        Clean a job of all rules::
        
            job.clear()
        
        Iterate through all jobs::
        
            for job in cron:
                print job
        
        Iterate through all lines::
        
            for line in cron.lines:
                print line
        
        Remove Items::
        
            cron.remove( job )
            cron.remove_all('echo')
            cron.remove_all(comment='foo')
            cron.remove_all(time='*/2')
        
        Clear entire cron of all jobs::
        
            cron.remove_all()
        
        Write CronTab back to system or filename::
        
            cron.write()
        
        Write CronTab to new filename::
        
            cron.write( 'output.tab' )
        
        Write to this user's crontab (unix only)::
        
            cron.write_to_user( user=True )
        
        Write to some other user's crontab::
        
            cron.write_to_user( user='bob' )
        
        Proceeding Unit Confusion
        =========================
        
        It is sometimes logical to think that job.hour.every(2) will set all proceeding
        units to '0' and thus result in "0 \*/2 * * \*". Instead you are controlling
        only the hours units and the minute column is unaffected. The real result would
        be "\* \*/2 * * \*" and maybe unexpected to those unfamiliar with crontabs.
        
        There is a special 'every' method on a job to clear the job's existing schedule
        and replace it with a simple single unit::
        
            job.every(4).hours()  == '0 */4 * * *'
            job.every().dom()     == '0 0 * * *'
            job.every().month()   == '0 0 0 * *'
            job.every(2).dows()   == '0 0 * * */2'
        
        This is a convenience method only, it does normal things with the existing api.
        
        Frequency Calculation
        =====================
        
        Every job's schedule has a frequency. We can attempt to calculate the number
        of times a job would execute in a give amount of time. We have three simple
        methods::
        
            job.setall("1,2 1,2 * * *")
            job.frequency_per_day() == 4
        
        The per year frequency method will tell you how many days a year the
        job would execute::
        
            job.setall("* * 1,2 1,2 *")
            job.frequency_per_year(year=2010) == 4
        
        These are combined to give the number of times a job will execute in any year::
        
            job.setall("1,2 1,2 1,2 1,2 *")
            job.frequency(year=2010) == 16
        
        Frequency can be quickly checked using python built-in operators::
        
            job < "*/2 * * * *"
            job > job2
            job.slices == "*/5"
        
        Log Functionality
        =================
        
        The log functionality will read a cron log backwards to find you the last run
        instances of your crontab and cron jobs.
        
        The crontab will limit the returned entries to the user the crontab is for::
        
            cron = CronTab(user='root')
        
            for d in cron.log:
                print d['pid'] + " - " + d['date']
        
        Each job can return a log iterator too, these are filtered so you can see when
        the last execution was::
        
            for d in cron.find_command('echo')[0].log:
                print d['pid'] + " - " + d['date']
        
        Schedule Functionality
        ======================
        
        If you have the croniter python module installed, you will have access to a
        schedule on each job. For example if you want to know when a job will next run::
        
            schedule = job.schedule(date_from=datetime.now())
        
        This creates a schedule croniter based on the job from the time specified. The
        default date_from is the current date/time if not specified. Next we can get
        the datetime of the next job::
        
            datetime = schedule.get_next()
        
        Or the previous::
        
            datetime = schedule.get_prev()
        
        The get methods work in the same way as the default croniter, except that they
        will return datetime objects by default instead of floats. If you want the
        original functionality, pass float into the method when calling::
        
            datetime = schedule.get_current(float)
        
        If you don't have the croniter module installed, you'll get an ImportError when
        you first try using the schedule function on your cron job object.
        
        Extra Support
        =============
        
         - Support for SunOS, AIX & HP with compatibility 'SystemV' mode.
         - Python 3.2 and Python 2.7/2.6 tested.
         - Windows support works for non-system crontabs only.
           ( see mem_cron and file_cron examples above for usage )
        
Platform: linux
Classifier: Development Status :: 5 - Production/Stable
Classifier: Development Status :: 6 - Mature
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: POSIX
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: POSIX :: SunOS/Solaris
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
Provides: crontab
Provides: cronlog