Geographic Information Systems Stack Exchange is a question and answer site for cartographers, geographers and GIS professionals. Join them; it only takes a minute:

Sign up
Here's how it works:
  1. Anybody can ask a question
  2. Anybody can answer
  3. The best answers are voted up and rise to the top

What is the best organizational structure for sharing ArcGIS python code and geoprocessing tools? Or even, are sharing code and sharing tools separate questions?

Esri has a Methods for distributing tools structure, published for Arcgis 9.3 and 10.0:

distributing tool folder structure example

However in other places people are saying things like Also do avoid distributing your code the way its done in Arc Scripts or Code Galleries in favour of the native python Distutils. Esri doesn't seem to have a corresponding distributing tools article for 10.1 (ref), lending some weight to the counter-argument.

What says

Update: though perhaps too late, but the nub of this question is more about best practices for file and folder structure before the tools-used-for-sharing (arcgis online, google drive, dropbox, github, bitbucket, etc.) come into play.

Update2: and will no-one speak up for the apparently orphan distutils approach?

share|improve this question

At 10.1 and 10.2 the Toolshare Folders that you illustrated seem no longer to be documented.

I suspect this is because the current recommendation would be to use Geoprocessing Packages rather than Toolshare Folders:

Geoprocessing packages are created from one or more results in the Results window. All the data and tools used to create the result are included in the package. You can add additional files to the package, such as text documents, slide shows, and compressed ZIP files. Your colleague unpacks the package to immediately begin using its contents.

In terms of organizational best practice the way I store toolboxes and any Python code they use is in the same folder structure that can still be used to assist distributing them i.e. Toolshare Folder structure.

share|improve this answer
+1 Nice one! Hadn't seen that before. – om_henners Oct 17 '12 at 22:44
...which I suppose means the answer to "what is the organizational structure" may be discovered by manually unzipping a geoprocessing package file and examining it's innards. – matt wilkie Nov 13 '12 at 22:07
I have not tried renaming to *.zip and unzipping a *.gpk but my understanding is that you could do that. I suspect it will look an awful lot like a toolshare folder. – PolyGeo Nov 14 '12 at 6:33

I have been using Google Drive to share Python scripts and script tools between colleagues. All of the scripts are stored in a shared folder along with an ArcGIS toolbox, which contains all of the linked script tools (and models). There are several benefits to this approach: 1) Everyone works off the same script versions, 2) You can set write or read-only privileges, and 3) Collaboration, for example, across different workplaces, universities and countries is much easier with Google Drive than than trying to set user access on a server you may or may not administer.

share|improve this answer
+1, and the same could be said for Dropbox – om_henners Oct 17 '12 at 22:47
So you store all of your scripts & toolboxes at the same folder level, correct? – RyanDalton Oct 17 '12 at 22:54
@RyanDalton For simplicity, I usually store folders one deep at the same level as toolboxes. Although, Gdrive supports complicated file structure too. – Aaron Oct 17 '12 at 23:03
Anyone who finds this workflow appealing should definitely take a look at the version control software Git and its popular repository-sharing website, GitHub. It gives you all of the above - a master script, defined privileges, and broad accessibility - with the ability to track all the changes made to the script (including date and author), experiment with new features while preserving the production version, manage multiple editing the same files simultaneously, etc. It's more complicated to use, but I've found it to be immensely useful. – Matt Parker Oct 22 '12 at 22:37
Google Drive, Dropbox, Git + Github, Mercurial + Bitbucket, and friends are all great routes for sharing files and code, but that's not the nub of this question. I'm after best practices for file and folder structure before the tools-used-for-sharing come into play. – matt wilkie Nov 13 '12 at 21:59

Your Answer


By posting your answer, you agree to the privacy policy and terms of service.

Not the answer you're looking for? Browse other questions tagged or ask your own question.