Merge pull request #1 from ehanson8/master

merge

Author: ehanson8

README.md

@@ -1,32 +1,32 @@
 Python scripts used to perform various tasks with the ArchivesSpace API
 
-##Authenticating to the API
+## Authenticating to the API
 
 All of these scripts require a secrets.py file in the same directory that must contain the following text:
 
 	baseURL='[ArchivesSpace API URL]'
 	user='[user name]'
 	password='[password]'
 
-##Scripts
+## Scripts
 
-####[getResources.py](/getResources.py)
+#### [getResources.py](/getResources.py)
 This GET scripts retrieves all of the resources from a particular repository into a JSON file which is specified in variable 'f' on line 16. This GET script can be adapted to other record types by editing the 'endpoint' variable on line 13 (e.g. 'repositories/[repo ID]/accessions' or 'agents/corporate_entities').
 
-####[getSingleRecord.py](/getSingleRecord.py)
+#### [getSingleRecord.py](/getSingleRecord.py)
 This GET script retrieves a single ArchivesSpace record based on the record's 'uri,' which is specified in the 'endpoint' variable on line 13.
 
-####[postNew.py](/postNew.py)
+#### [postNew.py](/postNew.py)
 This POST script will post new records to a generic API endpoint based the record type, 'agents/people' in this example. This script can be modified to accommodate other data types (e.g. 'repositories/[repo ID]/resources' or 'agents/corporate_entities'). It requires a properly formatted JSON file (specified where [JSON File] appears in the 'records' variable on line 13) for the particular ArchivesSpace record type you are trying to post.  
 
-####[postOverwrite.py](/postOverwrite.py)
+#### [postOverwrite.py](/postOverwrite.py)
 This POST script will overwrite existing ArchivesSpace records based the 'uri' and can be used with any ArchivesSpace record type (e.g. resource, accession, subject, agent_people, agent_corporate_entity, archival_object, etc.). It requires a properly formatted JSON file (specified where [JSON File] appears in the 'records' variable on line 13) for the particular ArchivesSpace record type you are trying to post. 
 
-####[getPropertiesFromAgentsPeopleCSV.py](/getPropertiesFromAgentsPeopleCSV.py)
+#### [getPropertiesFromAgentsPeopleCSV.py](/getPropertiesFromAgentsPeopleCSV.py)
 This GET script retrieves specific properties from the JSON of ArchivesSpace agent_people records into a CSV file which is specified in variable 'f' on line 17. In this example, the script retrieves the 'uri,' 'sort_name,' 'authority_id,' and 'names' properties from the JSON records by iterating through the JSON records with the function 'for i in range (...)' on line 19. The f.writerow(....) function on line 20 specifies which properties are retrieved from the JSON and the f.writerow(....) on line 18 specifies header row of the CSV file.  
 
-####[getArrayPropertiesFromAgentsPeopleCSV.py](/getArrayPropertiesFromAgentsPeopleCSV.py)
+#### [getArrayPropertiesFromAgentsPeopleCSV.py](/getArrayPropertiesFromAgentsPeopleCSV.py)
 This GET script retrieves specific properties, including proprerties that have arrays as values, from the JSON of ArchivesSpace agent_people records. In this example, the 'dates_of existence' property contains an array that must be iterated over. This requires a second level of iteration with 'for j in range (...)' on line 20, which is in addition to the iteration function 'for i in range (...)' on line 19, which was also found in the getPropertiesFromAgentsPeopleCSV.py script. As with the previous script, it also writes the properties' values into a CSV file which is specified in variable 'f' on line 17.
 
-####[searchArchivalObjectsByResource.py](/searchArchivalObjectsByResource.py)
+#### [searchArchivalObjectsByResource.py](/searchArchivalObjectsByResource.py)
 A GET script to extract all of the archival objects associated with a particular resource. To set the resource you want to search for, adjust the 'resourceNumber' variable on line 13

postContainersFromCSV.py

@@ -0,0 +1,51 @@
+# This script works to create instances (consisting of top_containers) from a separate CSV file. The CSV file should have two columns, indicator and barcode.
+# The directory where this file is stored must match the directory in the filePath variable, below.
+# The script will prompt you first for the exact name of the CSV file, and then for the exact resource or accession to attach the containers to.
+
+import json
+import requests
+import secrets
+import csv
+
+filePath = '[Enter File Path]'
+
+targetFile = raw_input('Enter file name: ')
+targetRecord = raw_input('Enter record type and id (e.g. \'accessions/2049\'): ')
+
+baseURL = secrets.baseURL
+user = secrets.user
+password = secrets.password
+
+auth = requests.post(baseURL + '/users/'+user+'/login?password='+password).json()
+session = auth["session"]
+headers = {'X-ArchivesSpace-Session':session, 'Content_Type':'application/json'}
+
+csv = csv.DictReader(open(filePath+targetFile))
+
+containerList = []
+for row in csv:
+    containerRecord = {}
+    containerRecord['barcode'] = row['barcode']
+    containerRecord['indicator'] = row['indicator']
+    containerRecord = json.dumps(containerRecord)
+    post = requests.post(baseURL + '/repositories/3/top_containers', headers=headers, data=containerRecord).json()
+    print post
+    containerList.append(post['uri'].encode('utf-8'))
+
+asRecord = requests.get(baseURL+'/repositories/3/'+targetRecord, headers=headers).json()
+instanceArray = asRecord['instances']
+
+for i in range (0, len (containerList)):
+    top_container = {}
+    top_container['ref'] = containerList[i]
+    sub_container = {}
+    sub_container['top_container'] = top_container
+    instance = {}
+    instance['sub_container'] = sub_container
+    instance['instance_type'] = 'mixed_materials'
+    instanceArray.append(instance)
+
+asRecord['instances'] = instanceArray
+asRecord = json.dumps(asRecord)
+post = requests.post(baseURL+'/repositories/3/'+targetRecord, headers=headers, data=asRecord).json()
+print post