aboutsummaryrefslogtreecommitdiffstats
path: root/etc/drive-google/.driveselect
blob: 14d8a1d002c71c08958815c13bebf1e2aea536aa (plain)
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
###################################################################################################
# .driveselect
###################################################################################################
# Copyright 2017-2018 Jean-Christophe Manciot <manciot.jeanchristophe@gmail.com>
#
# Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except 
# in compliance with the License. You may obtain a copy of the License at:
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# This file is using a project hosted at https://github.com/odeke-em/drive, originally developed 
# by Burcu Dogan while working on the Google Drive team and now maintained by Emmanuel T Odeke.
#
# Attribution — You must give appropriate credit, provide a link to the license, and indicate if 
#               changes were made. You may do so in any reasonable manner, but not in any way that 
#               suggests the licensor endorses you or your use.
###################################################################################################

###################################################################################################
#
# Text file listing the relative paths to all the files/folders (objects) to include/exclude for   
# some drive-<command> with their path starting from where you call the drive-<command>, 
# 1 filename/folder per line, and all blank lines or comments starting with '#'are dismissed.
# .driveselect can be located anywhere below your local <google_drive_folder> and it is possible  
# to have one per folder. It must be located in the folder where you call the drive-<command>.
# 
# The relative paths to the objects can be grouped into different [sections] affecting:
#       - all commands:         [global] - all and * are aliases to global
#       - a group of commands:  [<command1>/<command2>/<command3>/...]
#       - a single command:     [<command1>]
#
# If .driveselect is empty or if there is no section [<command>] for the current drive-<command>, 
# **all** objects recursively found below the current working directory will be affected by the  
# current drive-<command>.
#
# All global paths apply unless a section containing the current [<command>] defines more specific 
# paths which replace those defined in the [global] section. 
#
# Expected format:
# ---------------
# [global]                                      # Paths affecting all commands
# folder/leading/to/your/<file_or_folder_name_1>
# folder/leading/to/your/<file_or_folder_name_2>
# ...
# folder/leading/to/your/<file_or_folder_name_n>
#
# [<command1>/<command2>/<command3>]            # Paths affecting only those commands
# folder/leading/to/your/<file_or_folder_name_1>
# folder/leading/to/your/<file_or_folder_name_2>
# ...
# folder/leading/to/your/<file_or_folder_name_n>
#
# [<command4>]                                  # Paths affecting only that command
# folder/leading/to/your/<file_or_folder_name_1>
# folder/leading/to/your/<file_or_folder_name_2>
# ...
# folder/leading/to/your/<file_or_folder_name_n>
#
# Supported sections:
# ------------------
# The list of possible [<command>] names is subject to change but should at least contain
# the following ones for now:
#       + global or all or *:   for all drive-<command>
#       + clashes           --> for drive-check-duplicates
#       + delete                for drive-delete
#       + list                  for drive-list
#       + list-shared           for drive-list-shared
#       + list-starred          for drive-list-starred
#       + publish               for drive-publish
#       + pull                  for drive-pull
#       + push                  for drive-push
#       + share-link            for drive-share-link
#       + stat              --> for drive-stats
#       + sync                  for drive-sync
#       + touch                 for drive-touch
#       + trash                 for drive-trash
#       + unpublish             for drive-unpublish
#       + unshare               for drive-unshare
#       + untrash               for drive-untrash
#
# Including/excluding rules:
# -------------------------
# - All lines NOT beginning with ! are **included** in the search.
# - All lines beginning with ! are **excluded** from the search.
# - This means that the search logic is inverted from .driveignore logic.
# - Regular expressions are NOT supported here; use .driveignore instead.
# - Some standard wildcards are supported for objects paths and names:
#       + ?
#       + *
#   [] are NOT supported as standard wildcards, which means square brackets can be used within 
#   regular file names.
# - The order of objects within a section does not matter, but:
#       + included objects are alqays searched first, regardless of the order within the section
#       + excluded objects are then used to filter the first searched list.
#
# Examples:
# --------
# [global]      --> All drive-<commands> not listed below affect only ./folder1 and all
#                   pdf files regardless of the location of docx files below the current working
#                   directory.
# folder1
# *.docx
#
# [list-shared] --> drive-list-shared lists all shared pdf files located below the current working
#                   directory.
# *.pdf
#
# [pull/push]   --> drive-pull & drive-push affects all odt files, excluding those within folder3.
# *.odt
# !folder3
# 
# [list]        --> drive-list lists all objects below the current working directory, excluding all
#                   mp4 files.
# !*.mp4
#
# [sync]        --> drive-sync affects only ./folder4 and ./folder5/folder6, excluding all doc
#                   files contained within both folders.
# folder4
# folder5/folder6 
# !*.doc
#
# [share-link]  --> drive-share-link affects all files within folder2, excluding folder2/file1
# folder2
# !folder2/file1
#
###################################################################################################