Warn when using deprecated API calls.

Closes #19

Author: Diwaker Gupta

dropbox/files/client.go

@@ -436,6 +436,9 @@ type CopyAPIError struct {
 }
 
 func (dbx *apiImpl) Copy(arg *RelocationArg) (res IsMetadata, err error) {
+	log.Printf("WARNING: API `Copy` is deprecated")
+	log.Printf("Use API `CopyV2` instead")
+
 	cli := dbx.Client
 
 	if dbx.Config.Verbose {
@@ -927,6 +930,9 @@ type CreateFolderAPIError struct {
 }
 
 func (dbx *apiImpl) CreateFolder(arg *CreateFolderArg) (res *FolderMetadata, err error) {
+	log.Printf("WARNING: API `CreateFolder` is deprecated")
+	log.Printf("Use API `CreateFolderV2` instead")
+
 	cli := dbx.Client
 
 	if dbx.Config.Verbose {
@@ -1087,6 +1093,9 @@ type DeleteAPIError struct {
 }
 
 func (dbx *apiImpl) Delete(arg *DeleteArg) (res IsMetadata, err error) {
+	log.Printf("WARNING: API `Delete` is deprecated")
+	log.Printf("Use API `DeleteV2` instead")
+
 	cli := dbx.Client
 
 	if dbx.Config.Verbose {
@@ -2214,6 +2223,9 @@ type MoveAPIError struct {
 }
 
 func (dbx *apiImpl) Move(arg *RelocationArg) (res IsMetadata, err error) {
+	log.Printf("WARNING: API `Move` is deprecated")
+	log.Printf("Use API `MoveV2` instead")
+
 	cli := dbx.Client
 
 	if dbx.Config.Verbose {
@@ -3471,6 +3483,9 @@ type UploadSessionAppendAPIError struct {
 }
 
 func (dbx *apiImpl) UploadSessionAppend(arg *UploadSessionCursor, content io.Reader) (err error) {
+	log.Printf("WARNING: API `UploadSessionAppend` is deprecated")
+	log.Printf("Use API `UploadSessionAppendV2` instead")
+
 	cli := dbx.Client
 
 	if dbx.Config.Verbose {

dropbox/sharing/client.go

@@ -384,6 +384,9 @@ type ChangeFileMemberAccessAPIError struct {
 }
 
 func (dbx *apiImpl) ChangeFileMemberAccess(arg *ChangeFileMemberAccessArgs) (res *FileMemberActionResult, err error) {
+	log.Printf("WARNING: API `ChangeFileMemberAccess` is deprecated")
+	log.Printf("Use API `UpdateFileMember` instead")
+
 	cli := dbx.Client
 
 	if dbx.Config.Verbose {
@@ -704,6 +707,9 @@ type CreateSharedLinkAPIError struct {
 }
 
 func (dbx *apiImpl) CreateSharedLink(arg *CreateSharedLinkArg) (res *PathLinkMetadata, err error) {
+	log.Printf("WARNING: API `CreateSharedLink` is deprecated")
+	log.Printf("Use API `CreateSharedLinkWithSettings` instead")
+
 	cli := dbx.Client
 
 	if dbx.Config.Verbose {
@@ -1284,6 +1290,9 @@ type GetSharedLinksAPIError struct {
 }
 
 func (dbx *apiImpl) GetSharedLinks(arg *GetSharedLinksArg) (res *GetSharedLinksResult, err error) {
+	log.Printf("WARNING: API `GetSharedLinks` is deprecated")
+	log.Printf("Use API `ListSharedLinks` instead")
+
 	cli := dbx.Client
 
 	if dbx.Config.Verbose {
@@ -2647,6 +2656,9 @@ type RemoveFileMemberAPIError struct {
 }
 
 func (dbx *apiImpl) RemoveFileMember(arg *RemoveFileMemberArg) (res *FileMemberActionIndividualResult, err error) {
+	log.Printf("WARNING: API `RemoveFileMember` is deprecated")
+	log.Printf("Use API `RemoveFileMember2` instead")
+
 	cli := dbx.Client
 
 	if dbx.Config.Verbose {

dropbox/team/client.go

@@ -412,6 +412,9 @@ type DevicesListTeamDevicesAPIError struct {
 }
 
 func (dbx *apiImpl) DevicesListTeamDevices(arg *ListTeamDevicesArg) (res *ListTeamDevicesResult, err error) {
+	log.Printf("WARNING: API `DevicesListTeamDevices` is deprecated")
+	log.Printf("Use API `DevicesListMembersDevices` instead")
+
 	cli := dbx.Client
 
 	if dbx.Config.Verbose {
@@ -1860,6 +1863,9 @@ type LinkedAppsListTeamLinkedAppsAPIError struct {
 }
 
 func (dbx *apiImpl) LinkedAppsListTeamLinkedApps(arg *ListTeamAppsArg) (res *ListTeamAppsResult, err error) {
+	log.Printf("WARNING: API `LinkedAppsListTeamLinkedApps` is deprecated")
+	log.Printf("Use API `LinkedAppsListMembersLinkedApps` instead")
+
 	cli := dbx.Client
 
 	if dbx.Config.Verbose {

generator/go_client.stoneg.py

@@ -78,6 +78,12 @@ def _generate_route(self, namespace, route):
         signature = 'func (dbx *apiImpl) ' + self._generate_route_signature(
             namespace, route)
         with self.block(signature):
+            if route.deprecated is not None:
+                out('log.Printf("WARNING: API `%s` is deprecated")' % fn)
+                if route.deprecated.by is not None:
+                    out('log.Printf("Use API `%s` instead")' % fmt_var(route.deprecated.by.name))
+                out()
+
             out('cli := dbx.Client')
             out()