microsoft / codeplexworkitemmigrator

A command line utility to migrate work items from CodePlex to GitHub

CodePlex to GitHub Work Item Migrator

A command line tool to migrate CodePlex work items to GitHub issues.

This tool is historical and no longer works

This tool was created to assist in the migration of projects from CodePlex to GitHub in preparation for CodePlex to be archived now that CodePlex is archived the APIs that are used to talk to CodePlex will not succeed. The tool is being left here for historic purposes.

How to use

Microsoft.CodePlex.Migration.WorkItemMigrator.exe -p CodePlexProject -o GitHubRepoOwner -r GitHubRepo -t GitHubPersonalAccessToken

• CodePlexProject is the subdomain of your CodePlex project (subdomain.codeplex.com)
• GitHubRepoOwner is the user or organization that owns your migrated repo; GitHubRepo is your migrated repo. For instance, the NuGet/Home repository would use nuget as the owner and home as the repo.
• GitHubPersonalAccessToken is a token you create here; make sure to select the repo scope.

Installing

Download and extract the zip, then run the executable using a command window.

Notes

• Migration progress will be slow (avg. 1 item/min) in order to avoid triggering GitHub APIs abuse mechanisms. Please, refer to the following URL for more information on GitHub abuse rate limits: https://developer.github.com/v3/guides/best-practices-for-integrators/#dealing-with-abuse-rate-limits

License

Copyright (c) Microsoft Corporation. All rights reserved.

Licensed under the MIT license

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

Acknowledgements

This tool was created in collaboration with GitHub as part of the CodePlex archive process.

codeplexworkitemmigrator's Issues

Allow migrations of discussions

CodePlex does not have API access to list of discussions and their details right now. CodePlex should be upgraded to allow API access to this data.

This migration tool should be improved by adding support to migrate discussions as well.

Getting Exception

I am getting the following error/exception when trying to migrate my issues.
ERROR - An unexpected exception was encountered while running migration. Exception message: The listed users and repositories cannot be searched either because the resources do not exist or you do not have permission to view them.

Codeplex project: https://sharpvectors.codeplex.com/
GitHub Repo: https://github.com/ElinamLLC/SharpVectors
It is created with the account @paulushub in an organization reposition ElinamLLC

Tried the following commands
Microsoft.CodePlex.Migration.WorkItemMigrator.exe -p SharpVectors -o paulushub -r SharpVectors -t XXX

Microsoft.CodePlex.Migration.WorkItemMigrator.exe -p sharpVectors -o paulushub -r SharpVectors -t XXX

Microsoft.CodePlex.Migration.WorkItemMigrator.exe -p SharpVectors -o paulushub -r ElinamLLC/SharpVectors -t XXX

XXX is the Github personal token created with first repo scope and then updated with all scopes checked.

CodePlex Issue API does not return issue Title

Issue (work item) details returned from CodePlex Issue API does not include the Title attribute.

The API should return the issue Id and Title attributes so no additional requests need to be made to get the title.

eg. https://netoffice.codeplex.com/project/api/issues/15922

  "WorkItem": {
    "AffectedComponent": {
      "DisplayName": "",
      "Name": ""
    },
    "AssignedTo": "",
    "ClosedBy": "",
    "ClosedComment": "",
    "CommentCount": 5,
    "Custom": "",
    "Description": "...",
    "HtmlDescription": "...",
    "PlainDescription": "...",
    "LastUpdatedBy": "SebastianDotNet",
    "LastUpdatedDate": "/Date(1371195199340-0700)/",
    "PlannedForRelease": "",
    "ReleaseVisibleToPublic": false,
    "Priority": {
      "Name": "Low",
      "Severity": 50,
      "Id": 1
    },
    "ProjectName": "netoffice",
    "ReportedBy": "ppratscher",
    "ReportedDate": "/Date(1306491685283-0700)/",
    "CanContactReportedByUser": false,
    "Status": {
      "Name": "Resolved",
      "Id": 7
    },
    "ReasonClosed": {
      "Name": "Unassigned"
    },
    "Summary": "System.AccessViolationException when writing Excel Cells",
    "Type": {
      "Name": "Issue",
      "Id": 3
    },
    "VoteCount": 1,
    "Id": 15922,
    "HasUserVoted": false
  },
  "FileAttachments": [
    
  ],
  "Comments": [
    {
      "Message": "...",
      "PostedBy": "SebastianDotNet",
      "PostedDate": "/Date(1306764862810-0700)/",
      "WorkItemId": 15922,
      "Id": 202982
    }
  ],
  "CanDeleteWorkItem": true,
  "CanDeleteComments": true
}