Removes root generated_stone_source/ and commits core/build/generated…

…_stone_source/ to allow easier tracking of source changes (#529)

Co-authored-by: Walter Dziemianczyk <[email protected]>

.gitignore

@@ -1,7 +1,9 @@
 # Gradle
 .gradle/
-build/
 out/
+build/
+core/build/*
+!core/build/generated_stone_source/
 
 # Maven build output folder
 /target/
@@ -28,4 +30,5 @@ classyshark*
 *.DS_Store
 
 # Integration Test Auth Info
-auth_output
+auth_output
+

core/generated_stone_source/main/src/com/dropbox/core/v2/auth/DbxAppAuthRequests.java → core/build/generated_stone_source/main/src/com/dropbox/core/v2/auth/DbxAppAuthRequests.java

@@ -58,7 +58,10 @@ TokenFromOAuth1Result tokenFromOauth1(TokenFromOAuth1Arg arg) throws TokenFromOA
      *
      * @throws IllegalArgumentException  If any argument does not meet its
      *     preconditions.
+     *
+     * @deprecated
      */
+    @Deprecated
     public TokenFromOAuth1Result tokenFromOauth1(String oauth1Token, String oauth1TokenSecret) throws TokenFromOAuth1ErrorException, DbxException {
         TokenFromOAuth1Arg _arg = new TokenFromOAuth1Arg(oauth1Token, oauth1TokenSecret);
         return tokenFromOauth1(_arg);

core/generated_stone_source/main/src/com/dropbox/core/v2/check/DbxAppCheckRequests.java → core/build/generated_stone_source/main/src/com/dropbox/core/v2/check/DbxAppCheckRequests.java

@@ -36,8 +36,7 @@ public DbxAppCheckRequests(DbxRawClientV2 client) {
      * least part of the Dropbox API infrastructure is working and that the app
      * key and secret valid.
      *
-     * @param arg  EchoArg contains the arguments to be sent to the Dropbox
-     *     servers.
+     * @param arg  Contains the arguments to be sent to the Dropbox servers.
      *
      * @return EchoResult contains the result returned from the Dropbox servers.
      */

core/generated_stone_source/main/src/com/dropbox/core/v2/check/DbxUserCheckRequests.java → core/build/generated_stone_source/main/src/com/dropbox/core/v2/check/DbxUserCheckRequests.java

@@ -36,8 +36,7 @@ public DbxUserCheckRequests(DbxRawClientV2 client) {
      * least part of the Dropbox API infrastructure is working and that the
      * access token is valid.
      *
-     * @param arg  EchoArg contains the arguments to be sent to the Dropbox
-     *     servers.
+     * @param arg  Contains the arguments to be sent to the Dropbox servers.
      *
      * @return EchoResult contains the result returned from the Dropbox servers.
      */

core/generated_stone_source/main/src/com/dropbox/core/v2/check/EchoArg.java → core/build/generated_stone_source/main/src/com/dropbox/core/v2/check/EchoArg.java

@@ -17,15 +17,15 @@
 import java.util.Arrays;
 
 /**
- * EchoArg contains the arguments to be sent to the Dropbox servers.
+ * Contains the arguments to be sent to the Dropbox servers.
  */
 class EchoArg {
     // struct check.EchoArg (check_api_v2_types.stone)
 
     protected final String query;
 
     /**
-     * EchoArg contains the arguments to be sent to the Dropbox servers.
+     * Contains the arguments to be sent to the Dropbox servers.
      *
      * @param query  The string that you'd like to be echoed back to you. Must
      *     have length of at most 500 and not be {@code null}.
@@ -44,7 +44,7 @@ public EchoArg(String query) {
     }
 
     /**
-     * EchoArg contains the arguments to be sent to the Dropbox servers.
+     * Contains the arguments to be sent to the Dropbox servers.
      *
      * <p> The default values for unset fields will be used. </p>
      */

core/generated_stone_source/main/src/com/dropbox/core/v2/files/AddTagArg.java → core/build/generated_stone_source/main/src/com/dropbox/core/v2/files/AddTagArg.java

@@ -29,8 +29,8 @@ class AddTagArg {
      *     /(.|[\\r\\n])*}" and not be {@code null}.
      * @param tagText  The value of the tag to add. Will be automatically
      *     converted to lowercase letters. Must have length of at least 1, have
-     *     length of at most 32, match pattern "{@code [A-Za-z0-9_]+}", and not
-     *     be {@code null}.
+     *     length of at most 32, match pattern "{@code [\\w]+}", and not be
+     *     {@code null}.
      *
      * @throws IllegalArgumentException  If any argument does not meet its
      *     preconditions.
@@ -52,7 +52,7 @@ public AddTagArg(String path, String tagText) {
         if (tagText.length() > 32) {
             throw new IllegalArgumentException("String 'tagText' is longer than 32");
         }
-        if (!Pattern.matches("[A-Za-z0-9_]+", tagText)) {
+        if (!Pattern.matches("[\\w]+", tagText)) {
             throw new IllegalArgumentException("String 'tagText' does not match pattern");
         }
         this.tagText = tagText;

core/generated_stone_source/main/src/com/dropbox/core/v2/files/DbxUserFilesRequests.java → core/build/generated_stone_source/main/src/com/dropbox/core/v2/files/DbxUserFilesRequests.java

@@ -403,8 +403,9 @@ RelocationBatchV2Launch copyBatchV2(RelocationBatchArgBase arg) throws DbxApiExc
      * false} (see {@link #copyBatchV2(List,boolean)}). </p>
      *
      * @param entries  List of entries to be moved or copied. Each entry is
-     *     {@link RelocationPath}. Must contain at least 1 items, not contain a
-     *     {@code null} item, and not be {@code null}.
+     *     {@link RelocationPath}. Must contain at least 1 items, contain at
+     *     most 1000 items, not contain a {@code null} item, and not be {@code
+     *     null}.
      *
      * @return Result returned by {@link
      *     DbxUserFilesRequests#copyBatchV2(List,boolean)} or {@link
@@ -433,8 +434,9 @@ public RelocationBatchV2Launch copyBatchV2(List<RelocationPath> entries) throws
      * </p>
      *
      * @param entries  List of entries to be moved or copied. Each entry is
-     *     {@link RelocationPath}. Must contain at least 1 items, not contain a
-     *     {@code null} item, and not be {@code null}.
+     *     {@link RelocationPath}. Must contain at least 1 items, contain at
+     *     most 1000 items, not contain a {@code null} item, and not be {@code
+     *     null}.
      * @param autorename  If there's a conflict with any file, have the Dropbox
      *     server try to autorename that file to avoid the conflict.
      *
@@ -493,8 +495,9 @@ RelocationBatchLaunch copyBatch(RelocationBatchArg arg) throws DbxApiException,
      * See {@link CopyBatchBuilder} for more details. </p>
      *
      * @param entries  List of entries to be moved or copied. Each entry is
-     *     {@link RelocationPath}. Must contain at least 1 items, not contain a
-     *     {@code null} item, and not be {@code null}.
+     *     {@link RelocationPath}. Must contain at least 1 items, contain at
+     *     most 1000 items, not contain a {@code null} item, and not be {@code
+     *     null}.
      *
      * @return Result returned by {@link DbxUserFilesRequests#copyBatch(List)}
      *     or {@link DbxUserFilesRequests#moveBatch(List)} that may either
@@ -519,8 +522,9 @@ public RelocationBatchLaunch copyBatch(List<RelocationPath> entries) throws DbxA
      * check the job status.
      *
      * @param entries  List of entries to be moved or copied. Each entry is
-     *     {@link RelocationPath}. Must contain at least 1 items, not contain a
-     *     {@code null} item, and not be {@code null}.
+     *     {@link RelocationPath}. Must contain at least 1 items, contain at
+     *     most 1000 items, not contain a {@code null} item, and not be {@code
+     *     null}.
      *
      * @return Request builder for configuring request parameters and completing
      *     the request.
@@ -1190,8 +1194,8 @@ DeleteBatchLaunch deleteBatch(DeleteBatchArg arg) throws DbxApiException, DbxExc
      * DbxUserFilesRequests#deleteBatchCheck(String)} to check the job status.
      * </p>
      *
-     * @param entries  Must not contain a {@code null} item and not be {@code
-     *     null}.
+     * @param entries  Must contain at most 1000 items, not contain a {@code
+     *     null} item, and not be {@code null}.
      *
      * @return Result returned by {@link DbxUserFilesRequests#deleteBatch(List)}
      *     that may either launch an asynchronous job or complete synchronously.
@@ -2880,8 +2884,9 @@ RelocationBatchV2Launch moveBatchV2(MoveBatchArg arg) throws DbxApiException, Db
      * See {@link MoveBatchV2Builder} for more details. </p>
      *
      * @param entries  List of entries to be moved or copied. Each entry is
-     *     {@link RelocationPath}. Must contain at least 1 items, not contain a
-     *     {@code null} item, and not be {@code null}.
+     *     {@link RelocationPath}. Must contain at least 1 items, contain at
+     *     most 1000 items, not contain a {@code null} item, and not be {@code
+     *     null}.
      *
      * @return Result returned by {@link
      *     DbxUserFilesRequests#copyBatchV2(List,boolean)} or {@link
@@ -2907,8 +2912,9 @@ public RelocationBatchV2Launch moveBatchV2(List<RelocationPath> entries) throws
      * status.
      *
      * @param entries  List of entries to be moved or copied. Each entry is
-     *     {@link RelocationPath}. Must contain at least 1 items, not contain a
-     *     {@code null} item, and not be {@code null}.
+     *     {@link RelocationPath}. Must contain at least 1 items, contain at
+     *     most 1000 items, not contain a {@code null} item, and not be {@code
+     *     null}.
      *
      * @return Request builder for configuring request parameters and completing
      *     the request.
@@ -2963,8 +2969,9 @@ RelocationBatchLaunch moveBatch(RelocationBatchArg arg) throws DbxApiException,
      * See {@link MoveBatchBuilder} for more details. </p>
      *
      * @param entries  List of entries to be moved or copied. Each entry is
-     *     {@link RelocationPath}. Must contain at least 1 items, not contain a
-     *     {@code null} item, and not be {@code null}.
+     *     {@link RelocationPath}. Must contain at least 1 items, contain at
+     *     most 1000 items, not contain a {@code null} item, and not be {@code
+     *     null}.
      *
      * @return Result returned by {@link DbxUserFilesRequests#copyBatch(List)}
      *     or {@link DbxUserFilesRequests#moveBatch(List)} that may either
@@ -2988,8 +2995,9 @@ public RelocationBatchLaunch moveBatch(List<RelocationPath> entries) throws DbxA
      * check the job status.
      *
      * @param entries  List of entries to be moved or copied. Each entry is
-     *     {@link RelocationPath}. Must contain at least 1 items, not contain a
-     *     {@code null} item, and not be {@code null}.
+     *     {@link RelocationPath}. Must contain at least 1 items, contain at
+     *     most 1000 items, not contain a {@code null} item, and not be {@code
+     *     null}.
      *
      * @return Request builder for configuring request parameters and completing
      *     the request.
@@ -3572,7 +3580,7 @@ public FileMetadata restore(String path, String rev) throws RestoreErrorExceptio
 
     /**
      * Save the data from a specified URL into a file in user's Dropbox. Note
-     * that the transfer from the URL must complete within 5 minutes, or the
+     * that the transfer from the URL must complete within 15 minutes, or the
      * operation will time out and the job will fail. If the given path already
      * exists, the file will be renamed to avoid the conflict (e.g. myfile
      * (1).txt).
@@ -3596,7 +3604,7 @@ SaveUrlResult saveUrl(SaveUrlArg arg) throws SaveUrlErrorException, DbxException
     /**
      * Save the data from a specified URL into a file in user's Dropbox.
      *
-     * <p> Note that the transfer from the URL must complete within 5 minutes,
+     * <p> Note that the transfer from the URL must complete within 15 minutes,
      * or the operation will time out and the job will fail. </p>
      *
      * <p> If the given path already exists, the file will be renamed to avoid
@@ -3903,8 +3911,8 @@ void tagsAdd(AddTagArg arg) throws AddTagErrorException, DbxException {
      *     /(.|[\\r\\n])*}" and not be {@code null}.
      * @param tagText  The value of the tag to add. Will be automatically
      *     converted to lowercase letters. Must have length of at least 1, have
-     *     length of at most 32, match pattern "{@code [A-Za-z0-9_]+}", and not
-     *     be {@code null}.
+     *     length of at most 32, match pattern "{@code [\\w]+}", and not be
+     *     {@code null}.
      *
      * @throws IllegalArgumentException  If any argument does not meet its
      *     preconditions.
@@ -3981,8 +3989,7 @@ void tagsRemove(RemoveTagArg arg) throws RemoveTagErrorException, DbxException {
      *     /(.|[\\r\\n])*}" and not be {@code null}.
      * @param tagText  The tag to remove. Will be automatically converted to
      *     lowercase letters. Must have length of at least 1, have length of at
-     *     most 32, match pattern "{@code [A-Za-z0-9_]+}", and not be {@code
-     *     null}.
+     *     most 32, match pattern "{@code [\\w]+}", and not be {@code null}.
      *
      * @throws IllegalArgumentException  If any argument does not meet its
      *     preconditions.

core/generated_stone_source/main/src/com/dropbox/core/v2/files/DeleteBatchArg.java → core/build/generated_stone_source/main/src/com/dropbox/core/v2/files/DeleteBatchArg.java

@@ -24,8 +24,8 @@ class DeleteBatchArg {
 
     /**
      *
-     * @param entries  Must not contain a {@code null} item and not be {@code
-     *     null}.
+     * @param entries  Must contain at most 1000 items, not contain a {@code
+     *     null} item, and not be {@code null}.
      *
      * @throws IllegalArgumentException  If any argument does not meet its
      *     preconditions.
@@ -34,6 +34,9 @@ public DeleteBatchArg(List<DeleteArg> entries) {
         if (entries == null) {
             throw new IllegalArgumentException("Required value for 'entries' is null");
         }
+        if (entries.size() > 1000) {
+            throw new IllegalArgumentException("List 'entries' has more than 1000 items");
+        }
         for (DeleteArg x : entries) {
             if (x == null) {
                 throw new IllegalArgumentException("An item in list 'entries' is null");

core/generated_stone_source/main/src/com/dropbox/core/v2/files/MoveBatchArg.java → core/build/generated_stone_source/main/src/com/dropbox/core/v2/files/MoveBatchArg.java

@@ -27,8 +27,9 @@ class MoveBatchArg extends RelocationBatchArgBase {
      * specifying values for all optional fields.
      *
      * @param entries  List of entries to be moved or copied. Each entry is
-     *     {@link RelocationPath}. Must contain at least 1 items, not contain a
-     *     {@code null} item, and not be {@code null}.
+     *     {@link RelocationPath}. Must contain at least 1 items, contain at
+     *     most 1000 items, not contain a {@code null} item, and not be {@code
+     *     null}.
      * @param autorename  If there's a conflict with any file, have the Dropbox
      *     server try to autorename that file to avoid the conflict.
      * @param allowOwnershipTransfer  Allow moves by owner even if it would
@@ -49,8 +50,9 @@ public MoveBatchArg(List<RelocationPath> entries, boolean autorename, boolean al
      * <p> The default values for unset fields will be used. </p>
      *
      * @param entries  List of entries to be moved or copied. Each entry is
-     *     {@link RelocationPath}. Must contain at least 1 items, not contain a
-     *     {@code null} item, and not be {@code null}.
+     *     {@link RelocationPath}. Must contain at least 1 items, contain at
+     *     most 1000 items, not contain a {@code null} item, and not be {@code
+     *     null}.
      *
      * @throws IllegalArgumentException  If any argument does not meet its
      *     preconditions.
@@ -95,8 +97,9 @@ public boolean getAllowOwnershipTransfer() {
      * Returns a new builder for creating an instance of this class.
      *
      * @param entries  List of entries to be moved or copied. Each entry is
-     *     {@link RelocationPath}. Must contain at least 1 items, not contain a
-     *     {@code null} item, and not be {@code null}.
+     *     {@link RelocationPath}. Must contain at least 1 items, contain at
+     *     most 1000 items, not contain a {@code null} item, and not be {@code
+     *     null}.
      *
      * @return builder for this class.
      *
@@ -123,6 +126,9 @@ protected Builder(List<RelocationPath> entries) {
             if (entries.size() < 1) {
                 throw new IllegalArgumentException("List 'entries' has fewer than 1 items");
             }
+            if (entries.size() > 1000) {
+                throw new IllegalArgumentException("List 'entries' has more than 1000 items");
+            }
             for (RelocationPath x : entries) {
                 if (x == null) {
                     throw new IllegalArgumentException("An item in list 'entries' is null");

core/generated_stone_source/main/src/com/dropbox/core/v2/files/RelocationBatchArg.java → core/build/generated_stone_source/main/src/com/dropbox/core/v2/files/RelocationBatchArg.java

@@ -28,8 +28,9 @@ class RelocationBatchArg extends RelocationBatchArgBase {
      * specifying values for all optional fields.
      *
      * @param entries  List of entries to be moved or copied. Each entry is
-     *     {@link RelocationPath}. Must contain at least 1 items, not contain a
-     *     {@code null} item, and not be {@code null}.
+     *     {@link RelocationPath}. Must contain at least 1 items, contain at
+     *     most 1000 items, not contain a {@code null} item, and not be {@code
+     *     null}.
      * @param autorename  If there's a conflict with any file, have the Dropbox
      *     server try to autorename that file to avoid the conflict.
      * @param allowSharedFolder  This flag has no effect.
@@ -52,8 +53,9 @@ public RelocationBatchArg(List<RelocationPath> entries, boolean autorename, bool
      * <p> The default values for unset fields will be used. </p>
      *
      * @param entries  List of entries to be moved or copied. Each entry is
-     *     {@link RelocationPath}. Must contain at least 1 items, not contain a
-     *     {@code null} item, and not be {@code null}.
+     *     {@link RelocationPath}. Must contain at least 1 items, contain at
+     *     most 1000 items, not contain a {@code null} item, and not be {@code
+     *     null}.
      *
      * @throws IllegalArgumentException  If any argument does not meet its
      *     preconditions.
@@ -108,8 +110,9 @@ public boolean getAllowOwnershipTransfer() {
      * Returns a new builder for creating an instance of this class.
      *
      * @param entries  List of entries to be moved or copied. Each entry is
-     *     {@link RelocationPath}. Must contain at least 1 items, not contain a
-     *     {@code null} item, and not be {@code null}.
+     *     {@link RelocationPath}. Must contain at least 1 items, contain at
+     *     most 1000 items, not contain a {@code null} item, and not be {@code
+     *     null}.
      *
      * @return builder for this class.
      *
@@ -137,6 +140,9 @@ protected Builder(List<RelocationPath> entries) {
             if (entries.size() < 1) {
                 throw new IllegalArgumentException("List 'entries' has fewer than 1 items");
             }
+            if (entries.size() > 1000) {
+                throw new IllegalArgumentException("List 'entries' has more than 1000 items");
+            }
             for (RelocationPath x : entries) {
                 if (x == null) {
                     throw new IllegalArgumentException("An item in list 'entries' is null");

core/generated_stone_source/main/src/com/dropbox/core/v2/files/RelocationBatchArgBase.java → core/build/generated_stone_source/main/src/com/dropbox/core/v2/files/RelocationBatchArgBase.java

@@ -26,8 +26,9 @@ class RelocationBatchArgBase {
     /**
      *
      * @param entries  List of entries to be moved or copied. Each entry is
-     *     {@link RelocationPath}. Must contain at least 1 items, not contain a
-     *     {@code null} item, and not be {@code null}.
+     *     {@link RelocationPath}. Must contain at least 1 items, contain at
+     *     most 1000 items, not contain a {@code null} item, and not be {@code
+     *     null}.
      * @param autorename  If there's a conflict with any file, have the Dropbox
      *     server try to autorename that file to avoid the conflict.
      *
@@ -41,6 +42,9 @@ public RelocationBatchArgBase(List<RelocationPath> entries, boolean autorename)
         if (entries.size() < 1) {
             throw new IllegalArgumentException("List 'entries' has fewer than 1 items");
         }
+        if (entries.size() > 1000) {
+            throw new IllegalArgumentException("List 'entries' has more than 1000 items");
+        }
         for (RelocationPath x : entries) {
             if (x == null) {
                 throw new IllegalArgumentException("An item in list 'entries' is null");
@@ -56,8 +60,9 @@ public RelocationBatchArgBase(List<RelocationPath> entries, boolean autorename)
      * <p> The default values for unset fields will be used. </p>
      *
      * @param entries  List of entries to be moved or copied. Each entry is
-     *     {@link RelocationPath}. Must contain at least 1 items, not contain a
-     *     {@code null} item, and not be {@code null}.
+     *     {@link RelocationPath}. Must contain at least 1 items, contain at
+     *     most 1000 items, not contain a {@code null} item, and not be {@code
+     *     null}.
      *
      * @throws IllegalArgumentException  If any argument does not meet its
      *     preconditions.