{ "info": { "author": "Nickolas Fox ", "author_email": "tarvitz@blacklibrary.ru", "bugtrack_url": null, "classifiers": [ "Development Status :: 2 - Pre-Alpha", "Environment :: Console", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Natural Language :: English", "Operating System :: OS Independent", "Programming Language :: Python", "Topic :: Utilities" ], "description": "Darksouls Save File Parser\n==========================\n.. image:: https://travis-ci.org/tarvitz/dsfp.svg?branch=master\n :target: https://travis-ci.org/tarvitz/dsfp\n\n\n* DSFP means Darksouls Save File Parser.\n* `Dark Souls `_ is game of\n Namco Bandai with pretty hard to get it finished without being killed.\n Lot's of death, fun and broken gamepads/keyboards.\n\n**DSFP** *serves* for getting/fetching your saved characters statistics purposes.\n\n.. contents:: :local:\n :depth: 2\n\nOriginal source\n~~~~~~~~~~~~~~~\n\nOriginal source and some key knowledge were taken from this\n`gist `_.\n\nCommon features\n~~~~~~~~~~~~~~~\nSupports fetching data about character's death, his/her general stats, hp and stamina.\nWhole bunch of reversed stats you can see in datasheet document which is placed\n`here `_\n\n(*Help for reverse engineering DarkSouls save file is appreciated*).\n\nInstallation\n~~~~~~~~~~~~\nFor general installation you would probably need virtual environment with pip\ninstalled:\n\nPython 2.7\n``````````\n.. code-block:: bash\n\n user@localhost$ virtualenv --no-site-packages venv\n user@localhost$ source venv/bin/activate\n user@localhost$ pip install -r requirements/base.txt\n\n*optional*\n\n.. code-block:: bash\n\n user@localhost$ pip install -r requirements/docs.txt\n\nPython 3.x\n``````````\ndocument build requirements stored in py3.txt\n\n.. code-block:: bash\n user@localhost$ virtualenv --no-site-packages venv3\n user@localhost$ source venv3/bin/activate\n user@localhost$ pip install -r requirements/py3.txt\n\nDependencies\n------------\n* python 2.7\n* python 3.3\n* python 3.4\n\n\nTests\n~~~~~\nSimply run ``python setup.py test`` or\nYou could run tests via `python -m unittest module` or via `run_tests.sh` script\n\n.. code-block:: bash\n\n user@localhost$ ./run_tests.sh tests.TestDSFPReader\n\nFast Usage\n~~~~~~~~~~\nYou can parse Dark Souls save files and get data in standard python\ndictionary format\n\n.. code-block:: python\n\n >>> import dsfp\n >>> ds = dsfp.DSSaveFileParser('saves/DRAKS0005.sl2')\n >>> data = ds.get_stats()\n >>> data\n [{\n 'attunement': 8, 'body': 0, 'class': 0, 'color': 0, 'deaths': 0,\n 'dexterity': 13, 'earned': 60, 'endurance': 12, 'face': 0, 'faith': 9,\n 'gift': 0, 'hairs': 0, 'hp': 594, 'hp2': 594, 'hp_current': 594,\n 'humanity': 0, 'intelligence': 9, 'level': 4,\n 'male': False, # False means female\n 'name': u'TEST_2', 'resistance': 11, 'souls': 60, 'stamina': 95,\n 'stamina2': 95, 'stamina3': 95, 'strength': 13,\n 'time': 62, # in seconds\n 'vitality': 11\n }]\n\n\n\n\nDatasheets\n~~~~~~~~~~\nThere's no many information about Dark Souls save file format (as well as the\nother games), so there's not much complete around its format.\nSome knowledge represented `here `_.\n\nPlease notify me here or by email (tarvitz [at] blacklibrary.ru)\nif you have something interesting around whole file format.\n\nDocumentation\n~~~~~~~~~~~~~\nWhole bunch of the docs you can read by clicking this link\n`dsfp.readthedocs.org `_\n\n\nDevelopment\n~~~~~~~~~~~\n\n.. note::\n\n Huge buch of data now represented in datasheets are still not covered in\n dsfp \"api\" just cause whole file-format and its datasheet is the main priority.\n You can use it for build your own parser or just read some non-random data\n from *.sl2 files.\n Though dsfp is not complete as it should, please search/read information in\n the docs mentioned above.\n\nRoadmap\n~~~~~~~\nI have no certain roadmap for this project and I inspect the data whenever I want\nto do it. In general these moments could be very short/long from time to time. So don't\nexpect me finishing this work to some certain moment or something clear enough.\n\nUse ``./scripts/watcher.py`` and the other scripts (or may be another methods) to inspect\ndata you need, contact me if you want to share them and have fun ;).", "description_content_type": null, "docs_url": null, "download_url": "https://github.com/tarvitz/dsfp/archive/master.zip", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "UNKNOWN", "keywords": null, "license": "MIT license", "maintainer": null, "maintainer_email": null, "name": "dsfp", "package_url": "https://pypi.org/project/dsfp/", "platform": "OS Independent", "project_url": "https://pypi.org/project/dsfp/", "project_urls": { "Download": "https://github.com/tarvitz/dsfp/archive/master.zip", "Homepage": "UNKNOWN" }, "release_url": "https://pypi.org/project/dsfp/0.0.1/", "requires_dist": null, "requires_python": null, "summary": "Darksouls Save File Parser for fetching data issues", "version": "0.0.1" }, "last_serial": 1459236, "releases": { "0.0.1": [ { "comment_text": "", "digests": { "md5": "af4134b9688b83e2eb580e409301a83e", "sha256": "1552920538111211b3d01bc6f22733446608737c4fed01d11508243ba56e773c" }, "downloads": -1, "filename": "dsfp-0.0.1.tar.gz", "has_sig": false, "md5_digest": "af4134b9688b83e2eb580e409301a83e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9796, "upload_time": "2015-03-12T20:25:54", "url": "https://files.pythonhosted.org/packages/82/bb/cfde8f5565b53e76686a789192ccfc232d8fd2f09c1f93190a7aa06b543c/dsfp-0.0.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "af4134b9688b83e2eb580e409301a83e", "sha256": "1552920538111211b3d01bc6f22733446608737c4fed01d11508243ba56e773c" }, "downloads": -1, "filename": "dsfp-0.0.1.tar.gz", "has_sig": false, "md5_digest": "af4134b9688b83e2eb580e409301a83e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9796, "upload_time": "2015-03-12T20:25:54", "url": "https://files.pythonhosted.org/packages/82/bb/cfde8f5565b53e76686a789192ccfc232d8fd2f09c1f93190a7aa06b543c/dsfp-0.0.1.tar.gz" } ] }