# pyPreservicaFSDate
Python module which queries a local file system to try and add file system dates (created, modified, accessed)
etc to objects in already in Preservica.
## Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/carj/pyPreservicaFSDate
## Support
pyPreservicaFSDate is 3rd party open source client and is not affiliated or supported by Preservica Ltd.
There is no support for use of the library by Preservica Ltd.
Bug reports can be raised directly on GitHub.
Users of pyPreservicaFSDate should make sure they are licensed to use the Preservica REST APIs.
## License
The package is available as open source under the terms of the Apache License 2.0
## Installation
pyPreservica is available from the Python Package Index (PyPI)
https://pypi.org/project/pyPreservicaFSDate/
To install pyPreservicaFSDate, simply run this simple command in your terminal of choice:
$ pip install pyPreservicaFSDate
## Usage
pyPreservicaFSDate uses the pyPreservica python library for ingesting content. This means that pyPreservicaFSDate
can use the same authentication methods as pyPreservica for reading Preservica credentials. See:
https://pypreservica.readthedocs.io/en/latest/intro.html#authentication
The most straightforward way is to use a properties file to hold the Preservica credentials.
### Properties File
Create a properties file called "credentials.properties" with the following property names
and save to the working directory ::
[credentials]
username=test@test.com
password=123444
tenant=PREVIEW
server=preview.preservica.com
To run the module you need to specify a Preservica collection you wish to process and a local directory
containing the original files:
$ python -m pyPreservicaFSDate -c a7ad52e3-2cb3-4cb5-af2a-3ab08829a2a8 -p c://my-directory/images
By default, the module will try and match Preservica assets to local file names by using the Asset title, this is
the fastest way of processing the dates, but may not correctly match files to assets.
The alternative to to match using fixity values stored in Preservica, this can be turned on by using the -f flag:
$ python -m pyPreservicaFSDate -c a7ad52e3-2cb3-4cb5-af2a-3ab08829a2a8 -p c://my-directory/images -f
Matching using fixity will be slower than using Asset titles.
```
usage: pyPreservicaFSDate [-h] [-c COLLECTION] [-p PATH] [-f]
Add file system dates to Preservica assets Search local file system for
matching files and add the file system dates to Preservica. Files are either
matched on Asset title and filename or by fixity which is slower You provide
both a Preservica collection UUID and a local file system folder to look for
matches
options:
-h, --help show this help message and exit
-c, --collection COLLECTION
The Preservica parent collection uuid
-p, --path PATH The file system path to search
-f, --fixity Use fixity matching (slow)
```
The dates will appear as a new metadata form within the Asset
Raw data
{
"_id": null,
"home_page": "https://github.com/carj/pyPreservicaFSDate",
"name": "pyPreservicaFSDate",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "Preservica API Preservation",
"author": "James Carr",
"author_email": "drjamescarr@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/d6/e0/60c0b1a0360856d71a0f62ac31281727704f85af170bac412c25f3ef55ab/pypreservicafsdate-0.1.0.tar.gz",
"platform": null,
"description": "# pyPreservicaFSDate\r\n\r\nPython module which queries a local file system to try and add file system dates (created, modified, accessed) \r\netc to objects in already in Preservica.\r\n\r\n## Contributing\r\n\r\nBug reports and pull requests are welcome on GitHub at https://github.com/carj/pyPreservicaFSDate\r\n\r\n## Support \r\n\r\npyPreservicaFSDate is 3rd party open source client and is not affiliated or supported by Preservica Ltd.\r\nThere is no support for use of the library by Preservica Ltd.\r\nBug reports can be raised directly on GitHub.\r\n\r\nUsers of pyPreservicaFSDate should make sure they are licensed to use the Preservica REST APIs. \r\n\r\n## License\r\n\r\nThe package is available as open source under the terms of the Apache License 2.0\r\n\r\n## Installation\r\n\r\npyPreservica is available from the Python Package Index (PyPI)\r\n\r\nhttps://pypi.org/project/pyPreservicaFSDate/\r\n\r\nTo install pyPreservicaFSDate, simply run this simple command in your terminal of choice:\r\n\r\n\r\n $ pip install pyPreservicaFSDate\r\n\r\n\r\n\r\n## Usage\r\n\r\npyPreservicaFSDate uses the pyPreservica python library for ingesting content. This means that pyPreservicaFSDate \r\ncan use the same authentication methods as pyPreservica for reading Preservica credentials. See: \r\nhttps://pypreservica.readthedocs.io/en/latest/intro.html#authentication\r\n\r\nThe most straightforward way is to use a properties file to hold the Preservica credentials.\r\n\r\n### Properties File\r\n\r\nCreate a properties file called \"credentials.properties\" with the following property names\r\nand save to the working directory ::\r\n\r\n [credentials]\r\n username=test@test.com\r\n password=123444\r\n tenant=PREVIEW\r\n server=preview.preservica.com\r\n\r\n\r\n\r\nTo run the module you need to specify a Preservica collection you wish to process and a local directory\r\ncontaining the original files:\r\n\r\n\r\n $ python -m pyPreservicaFSDate -c a7ad52e3-2cb3-4cb5-af2a-3ab08829a2a8 -p c://my-directory/images\r\n\r\nBy default, the module will try and match Preservica assets to local file names by using the Asset title, this is \r\nthe fastest way of processing the dates, but may not correctly match files to assets.\r\n\r\nThe alternative to to match using fixity values stored in Preservica, this can be turned on by using the -f flag:\r\n\r\n $ python -m pyPreservicaFSDate -c a7ad52e3-2cb3-4cb5-af2a-3ab08829a2a8 -p c://my-directory/images -f\r\n\r\nMatching using fixity will be slower than using Asset titles.\r\n\r\n```\r\nusage: pyPreservicaFSDate [-h] [-c COLLECTION] [-p PATH] [-f]\r\n\r\nAdd file system dates to Preservica assets Search local file system for\r\nmatching files and add the file system dates to Preservica. Files are either\r\nmatched on Asset title and filename or by fixity which is slower You provide\r\nboth a Preservica collection UUID and a local file system folder to look for\r\nmatches\r\n\r\noptions:\r\n -h, --help show this help message and exit\r\n -c, --collection COLLECTION\r\n The Preservica parent collection uuid\r\n -p, --path PATH The file system path to search\r\n -f, --fixity Use fixity matching (slow)\r\n\r\n```\r\n\r\nThe dates will appear as a new metadata form within the Asset\r\n\r\n\r\n",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "Python module to add local file system dates to existing Preservica assets",
"version": "0.1.0",
"project_urls": {
"Documentation": "https://github.com/carj/preserva-tweet",
"Homepage": "https://github.com/carj/pyPreservicaFSDate",
"Source": "https://github.com/carj/pyPreservicaFSDate"
},
"split_keywords": [
"preservica",
"api",
"preservation"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "6dea72b8b75d179bf639f24a02df4f2580824083ef0962c62c7cb09b23a78973",
"md5": "b1279aa884f8318f52c5b62d98714130",
"sha256": "682ce8063cff3b931ce868d97a84ba7237004e858e17b00d3c09934567f2a7fb"
},
"downloads": -1,
"filename": "pypreservicafsdate-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b1279aa884f8318f52c5b62d98714130",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 9816,
"upload_time": "2025-07-31T09:39:37",
"upload_time_iso_8601": "2025-07-31T09:39:37.830825Z",
"url": "https://files.pythonhosted.org/packages/6d/ea/72b8b75d179bf639f24a02df4f2580824083ef0962c62c7cb09b23a78973/pypreservicafsdate-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "d6e060c0b1a0360856d71a0f62ac31281727704f85af170bac412c25f3ef55ab",
"md5": "fd6ace1f56332d38513c0905f4a24271",
"sha256": "8a43fc1bd50c350b7bca15f5127940d0b42d51d49ce238ce40d1dfd72f322e24"
},
"downloads": -1,
"filename": "pypreservicafsdate-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "fd6ace1f56332d38513c0905f4a24271",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 9110,
"upload_time": "2025-07-31T09:39:38",
"upload_time_iso_8601": "2025-07-31T09:39:38.977552Z",
"url": "https://files.pythonhosted.org/packages/d6/e0/60c0b1a0360856d71a0f62ac31281727704f85af170bac412c25f3ef55ab/pypreservicafsdate-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-31 09:39:38",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "carj",
"github_project": "pyPreservicaFSDate",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "pypreservicafsdate"
}
JSON
