https://github.com/cdhunt/qopy

A Powershell File Copy Module with CRC Check
https://github.com/cdhunt/qopy

Last synced: 8 days ago
JSON representation

A Powershell File Copy Module with CRC Check

• Host: GitHub
• URL: https://github.com/cdhunt/qopy
• Owner: cdhunt
• Created: 2013-04-02T16:12:06.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2013-06-12T12:30:46.000Z (over 11 years ago)
• Last Synced: 2023-03-23T02:56:27.471Z (over 1 year ago)
• Language: C#
• Size: 164 KB
• Stars: 10
• Watchers: 2
• Forks: 4
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
Qopy

====

A _Quick_ Powershell File Copy Module with CRC Check.

XCopy, Robocopy and Teracopy are all good Windows utilities for copying a large amount of files, but none of them offer easily machine-readable results report. An efficient, reliable and audit-able _copy utility_ is critical for large-scale, automated software deployments.

Qopy is a binary Powershell Module that provides some the functionality of all of those other utilities with an object output for advanced reporting and auditing. Qopy copies only the data inside each file and none of the metadata like ModifiedTime or ACLs.

Two Cmdlets are exported.

	NAME

		Copy-Files

	SYNOPSIS

		A Powershell File Copy Module with CRC Check.

	SYNTAX

		Copy-Files [-Source]  [-Destination]  [[-Filter] ]

		[[-Recurse]] [[-SetTime]] [[-Overwrite]] [[-ShowProgress]]  []

	NAME

		Get-CopyResultsReport

	SYNOPSIS

		Aggregate output of Copy-Files

	SYNTAX

		Get-CopyResultsReport -InputObject 

		[]		

The output is an object list with the following properties—One object per source file.

	   TypeName: Qopy.FileCopyResultsItem

	Name           MemberType Definition

	----           ---------- ----------

	Destination    Property   string Destination {get;set;}

	DestinationCRC Property   string DestinationCRC {get;set;}

	ErrorMessage   Property   string ErrorMessage {get;set;}

	Match          Property   bool Match {get;set;}

	Size           Property   long Size {get;set;}

	Source         Property   string Source {get;set;}

	SourceCRC      Property   string SourceCRC {get;set;}

	Time           Property   timespan Time {get;set;}

Get-CopyResultsReport returns the following properties.

    TypeName: Qopy.FileCopyResultsReport

	Name           MemberType Definition

	----           ---------- ----------

	Bytes          Property   long Bytes {get;set;}

	FailedItemList Property   System.Collections.Generic.List[Qopy.FileCopyResultsItem]

	FileCount      Property   int FileCount {get;set;}

	TotalTime      Property   timespan TotalTime {get;set;}	

Features

====

* Attempts to not copy files when unnecessary.

    * If file size is different and `Overwrite` switch is not enabled, do not copy.

    * If file size is the same and CRC check is the same, do not copy.

* Validates source and destination contents match

CRC-32 functionality was developed by Damien Guard - [Calculating CRC-32 in C# and .NET](http://damieng.com/blog/2006/08/08/calculating_crc32_in_c_and_net)

Performance

====

Test Case:

1,797 Files in 145 Folders

108MB

_Local System_


**TeraCopy w/Test** 1:01


**Qopy** 0:27


_LAN_


**TeraCopy w/Test** 2:02


**Qopy** 1:31


Changes

====

1.0.3

----

* Added the SetTime switch to copy timestamp metadata. This increases copy time by as much as 300%.

1.0.2

----

* Changed error output to use WriteVerbose. This prevents terminating errors. Add the -Verbose switch to expose.

* Added ErrorMessage property to the FileCopyResultsItem class to capture copy errors.

1.0.1

----

* Removed some unnecessary IO by eliminating redundant file existence checks. Should improve network file copy performance a little bit.

Todo

====

* A bunch of code clean-up

* Update Progress bar to use Bytes instead of File Count

* Move (delete source)?

* Validate only?

* Do not Validate?

Use

====

**Requires Powershell v3.**

[Binary Download](http://www.automatedops.com/downloads/Qopy1.0.2.zip)

1. Extract to `C:\Users\[username]\Documents\WindowsPowerShell\Modules` 

1.  `Import-Module Qopy`

If you use the `ShowProgress` switch without capturing the Output, the screen will get very flashy.