{ "info": { "author": "RedTurtle Technology", "author_email": "sviluppoplone@redturtle.it", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Framework :: Plone", "Framework :: Plone :: 3.3", "Framework :: Plone :: 4.0", "Framework :: Plone :: 4.1", "Framework :: Plone :: 4.2", "Intended Audience :: Developers", "Programming Language :: Python" ], "description": "Introduction\n============\n\n.. Note::\n **This is not a Plone add-on**.\n\nThis library is an utility that helps developers to integrate vocabulary done using\n`ATVocabularyManager`__ to be imported using Generic Setup Python handlers and CSV sources.\n\n__ http://plone.org/products/atvocabularymanager/\n\nIt also support `LinguaPlone`__ (if present).\n\n__ http://plone.org/products/linguaplone\n\nHow to use\n==========\n\nJust import the ``createVocabulary`` function and use it::\n\n >>> portal_vocabularies = getToolByName(portal, 'portal_vocabularies')\n >>> from collective.csv2atvocabularymanager.csv_import import createVocabulary\n >>> createVocabulary(portal_vocabularies, fs_path, 'my.vocabulary.id',\n ... \"My vocabulary\", description='A vocabulary for...')\n\nWhere:\n\n``portal_vocabularies``\n is the ATVocabularyManager tool created after installing it\n``fs_path``\n is a filesystem path of a folder, where you must put you CSV sources.\n \n If the code is called from a ``setuphandlers.py`` script, you can call something like::\n \n >>> os.path.join(os.path.dirname( __file__ ), 'vocabularies')\n \n This way the code will look for a \"vocabularies\" folder inside you project\n``vid``\n is the vocabulary id that will be created *and* a file with that name and \".csv\" extension\n will be searched inside the ``fs_path`` folder.\n``title``\n is the title of the vocabulary\n``description``\n is the description of the vocabulary\n\nAlso, you have other optional additional parameters:\n\n``type_name``\n If the portal_type name of the vocabulary created (default is \"SimpleVocabulary\")\n``sortMethod``\n is the sort method of the vocabulary\n``null_values``\n is a list of possible values that must be used as \"null\" (can be useful is your CSV is taken\n from a raw export from SQL database, and strings like \"NULL\" can be found inside the source).\n``change_master_with_language_id``\n is a boolean flag used to change the generated vocabulary term id, adding to it the language code suffix.\n\nCSV format examples\n-------------------\n\nA CSV file named \"foo.bar.vocabulary.csv\" in that format::\n\n \"id\",\"en\"\n \"item-1\",\"Item one\"\n \"item-2\",\"Item two\"\n ...\n\nWill create a vocabulary entry with id \"foo.bar.vocabulary\", with vocabulary terms ids \"item-1\" and\n\"item-2\", ... and titles \"Item one\", \"Item two\", ...\n\nThe header row is required. While the id column's name is not used, that language column name is used to\nspecify the vocabulary term language code (so: normally use the portal default language).\n\nYou can also import item in different languages::\n\n \"id\",\"en\",\"it\"\n \"item-1\",\"Item one\",\"Elemento 1\"\n \"item-2\",\"Item two\",\"Elemento 2\"\n ...\n\nIn that way you will create same terms as in previous example, and additional vocabulary terms with ids\n\"item-1-it\", \"item-2-it\", ... and titles \"Elemento 1\", \"Elemento 2\", ...\n\nYou can provide additional languages addim more columns. Just remember to keep the fist language column as\nthe one with portal default language.\n\nThe real power of language columns will be used if you also install *LinguaPlone*.\nIn that way you will create translations of vocabulary terms.\n\nFinal notes\n===========\n\nPlease, keep in mind that ATVocabularyManager already support Generic Setup integration for creating vocabularies\nat install time.\n\nHowever you are foced to use the \"*IMS VDEX Vocabulary File*\". \n\nPlease note also that vocabulary implementation from ATVM already provides a ``importCSV`` method.\n\nAuthors\n=======\n\nThis product was developed by RedTurtle Technology team.\n\n.. image:: http://www.redturtle.net/redturtle_banner.png\n :alt: RedTurtle Technology Site\n :target: http://www.redturtle.it/\n\nChangelog\n=========\n\n0.1.1 (2012-11-13)\n------------------\n\n- Fixed packaging error (missing MANIFEST.in file)\n [keul]\n\n0.1.0 (2012-11-12)\n------------------\n\n- Initial release", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://github.com/RedTurtle/collective.csv2atvocabularymanager", "keywords": "plone vocabulary atvocabularymanager archetypes", "license": "GPL", "maintainer": null, "maintainer_email": null, "name": "collective.csv2atvocabularymanager", "package_url": "https://pypi.org/project/collective.csv2atvocabularymanager/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/collective.csv2atvocabularymanager/", "project_urls": { "Download": "UNKNOWN", "Homepage": "http://github.com/RedTurtle/collective.csv2atvocabularymanager" }, "release_url": "https://pypi.org/project/collective.csv2atvocabularymanager/0.1.1/", "requires_dist": null, "requires_python": null, "summary": "Plone utility for importing your ATVocabularyManager vocabularies from CSV sources (with LinguaPlone support)", "version": "0.1.1" }, "last_serial": 787739, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "293c1c97d8c362dbf5b6d64417e74188", "sha256": "e29a47046399f08a689faf83965708033df54e07eddaca96ccb7617577ee4db0" }, "downloads": -1, "filename": "collective.csv2atvocabularymanager-0.1.0.zip", "has_sig": false, "md5_digest": "293c1c97d8c362dbf5b6d64417e74188", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12753, "upload_time": "2012-11-12T09:09:54", "url": "https://files.pythonhosted.org/packages/e9/da/386d661513968a91eb96e3f0edb23ec0574a89c9e18bcfd4cac47b9ff9e3/collective.csv2atvocabularymanager-0.1.0.zip" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "5e1775d6486ec32e45676e11e51c8843", "sha256": "ed760d8f7119f80e81fd04f25e7cf333f51e41b73cedfa5902146ec216f9fc1f" }, "downloads": -1, "filename": "collective.csv2atvocabularymanager-0.1.1.zip", "has_sig": false, "md5_digest": "5e1775d6486ec32e45676e11e51c8843", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 26062, "upload_time": "2012-11-13T09:05:43", "url": "https://files.pythonhosted.org/packages/11/27/7aff3a43a242d6771a69d7b8daac4d24f937f79dd76096c9323d30d18153/collective.csv2atvocabularymanager-0.1.1.zip" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "5e1775d6486ec32e45676e11e51c8843", "sha256": "ed760d8f7119f80e81fd04f25e7cf333f51e41b73cedfa5902146ec216f9fc1f" }, "downloads": -1, "filename": "collective.csv2atvocabularymanager-0.1.1.zip", "has_sig": false, "md5_digest": "5e1775d6486ec32e45676e11e51c8843", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 26062, "upload_time": "2012-11-13T09:05:43", "url": "https://files.pythonhosted.org/packages/11/27/7aff3a43a242d6771a69d7b8daac4d24f937f79dd76096c9323d30d18153/collective.csv2atvocabularymanager-0.1.1.zip" } ] }