Internet Archive CLI Tool - Revision history

Poetry at 17:02, 24 November 2023

2023-11-24T17:02:05Z

← Older revision		Revision as of 10:02, 24 November 2023
Line 81:		Line 81:
	Warning #1: If one deletes an item ID at the GUI level, it is then gone forever.		Warning #1: If one deletes an item ID at the GUI level, it is then gone forever.

	Warning #2: It ~~doesn~~'t ~~seem to be~~ possible to change mediatype for an item ID once it's set; either ~~using~~ the IArchive GUI or CLI. An item ID can have multiple files. The primary file needs to be uploaded first and the mediatype needs to be specified, and specified correctly, for that file.		Warning #2: It isn't possible to change mediatype for an item ID once it's set. This doesn't work by way of either the IArchive GUI or the CLI tool.

			An item ID can have multiple files. The primary file needs to be uploaded first and the mediatype needs to be specified, and specified correctly, for that file.

			This is an unusual limitation but it does seem to be the base. As of Fall 2023, there were numerous posts in an IArchive support forum about the issue.

	Warning #3: "ia" operations don't complete immediately on the Internet Archive side. Sometimes they may never complete. The only way to clean things up may be to delete an item ID on the GUI side.		Warning #3: "ia" operations don't complete immediately on the Internet Archive side. Sometimes they may never complete. The only way to clean things up may be to delete an item ID on the GUI side.
Line 87:		Line 91:
	The third warning above is one reason to use numeric IDs instead of descriptive IDs. If you use a descriptive ID, you may end up needing to delete it and it won't be possible in this case to bring it back. So descriptive IDs may end up being lost permanently and therefore wasted.		The third warning above is one reason to use numeric IDs instead of descriptive IDs. If you use a descriptive ID, you may end up needing to delete it and it won't be possible in this case to bring it back. So descriptive IDs may end up being lost permanently and therefore wasted.

	S6) Supported mediatypes ~~seem to~~ include: software, movies, image. "text" or "texts" may work as well but this hasn't been confirmed yet.		S6) Supported mediatypes include: software, movies, image

			"text" or "texts" may work as well but this hasn't been confirmed yet.

	~~For anything else, don't set~~ the mediatype.		If the mediatype is omitted, it should default to "other".

	S7) If a source-code tarball is uploaded in this manner, one can upload a JPEG or PNG file subsequently to the same item ID:		S7) If a source-code tarball is uploaded in this manner, one can upload a JPEG or PNG file subsequently to the same item ID:

Poetry at 16:56, 24 November 2023

2023-11-24T16:56:03Z

← Older revision		Revision as of 09:56, 24 November 2023
Line 27:		Line 27:
	The Internet Archive can be used for the distribution and backup of FOSS code and data. '''Warning:''' The procedures involved are slow, finicky, flaky, and unreliable. However, if this approach still works as of the current date, it will be useful to some extent.		The Internet Archive can be used for the distribution and backup of FOSS code and data. '''Warning:''' The procedures involved are slow, finicky, flaky, and unreliable. However, if this approach still works as of the current date, it will be useful to some extent.

	In particular: As of Fall 2023, Internet Archive is willing to host Minetest world tarballs that ~~are~~ gigabytes in size.		In particular: As of Fall 2023, Internet Archive was willing to host Minetest world tarballs that were gigabytes in size.

	We recommend adding screenshots and descriptions and other metadata or the nature of the uploads may not be clear and Internet Archive may block accounts.		We recommend adding screenshots and descriptions and other metadata or the nature of the uploads may not be clear and Internet Archive may block accounts.

Poetry at 16:55, 24 November 2023

2023-11-24T16:55:31Z

← Older revision		Revision as of 09:55, 24 November 2023
Line 24:		Line 24:
	<span id="introduction"></span>		<span id="introduction"></span>
	== Introduction ==		== Introduction ==

			The Internet Archive can be used for the distribution and backup of FOSS code and data. '''Warning:''' The procedures involved are slow, finicky, flaky, and unreliable. However, if this approach still works as of the current date, it will be useful to some extent.

			In particular: As of Fall 2023, Internet Archive is willing to host Minetest world tarballs that are gigabytes in size.

			We recommend adding screenshots and descriptions and other metadata or the nature of the uploads may not be clear and Internet Archive may block accounts.

	This page provides some information related to an Internet Archive CLI tool.		This page provides some information related to an Internet Archive CLI tool.
Line 29:		Line 35:

	<span id="iatool"></span>		<span id="iatool"></span>
	== Internet Archive ~~CLIs~~ tool  ==		== Internet Archive CLI tool  ==

	~~The Internet Archive can be used for FOSS distribution and backup purposes. The procedures used are finicky, flaky, and unreliable. However, this approach may be useful to a limited extent.~~

	The steps below worked as of Fall 2023. They may or may not still work.		The steps below worked as of Fall 2023. They may or may not still work.

	S1) As of Fall 2023, the link below worked ~~and pointed to a Python binary script~~:		S1) As of Fall 2023, the link below worked:

	https://ia800702.us.archive.org/27/items/ia-pex/ia		https://ia800702.us.archive.org/27/items/ia-pex/ia

	Install the script on a Debian 11 box and chmod it to 755. This ~~may~~ then provide CLI access to Internet Archive.		The link pointed to a Python 3 binary script. The script was compatible with Debian 11. It may or may not work with older or newer Debians.

			The script did '''not''' work with a non-Debian distro named Laclin.

			As a last resort, if "ia" doesn't work with your Linux distro, you should be able to use it by running it under Debian 11 in a "podman" container.

			Install the script on a Debian 11 box [or container] and chmod it to 755. This might then provide CLI access to Internet Archive.

	S2) Use the following command to configure the tool:		S2) Use the following command to configure the tool:
Line 45:		Line 55:
	ia configure		ia configure

	S3) A command similar to the following may ~~then~~ work to upload a source code tarball to Internet Archive:		You'll be asked to specify the credentials for the Internet Archive account that you'd like to operate on. The credentials are the associated email address and password.

			Out of the box, "ia" only supports '''one''' IArchive account at a time. However, you can use it to work on multiple accounts by creating and preserving multiple "ia" configuration files, one per IArchive account. Details are to be added.

			S3) Subsequent to the "configure" step, a command similar to the following may work to upload a source code tarball to Internet Archive:

	ia upload \		ia upload \

Poetry at 06:51, 24 November 2023

2023-11-24T06:51:47Z

← Older revision		Revision as of 23:51, 23 November 2023
Line 69:		Line 69:
	Warning #2: It doesn't seem to be possible to change mediatype for an item ID once it's set; either using the IArchive GUI or CLI. An item ID can have multiple files. The primary file needs to be uploaded first and the mediatype needs to be specified, and specified correctly, for that file.		Warning #2: It doesn't seem to be possible to change mediatype for an item ID once it's set; either using the IArchive GUI or CLI. An item ID can have multiple files. The primary file needs to be uploaded first and the mediatype needs to be specified, and specified correctly, for that file.

	Warning #3: "ia" operations don't complete immediately on the Internet Archive side. Sometimes they may never complete. The only way to clean things up may be to delete an item ID on the GUI side. ~~This~~ is one reason to use numeric IDs instead of descriptive IDs. If you use a descriptive ID, you may end up needing to delete it and it won't be possible in this case to bring it up.		Warning #3: "ia" operations don't complete immediately on the Internet Archive side. Sometimes they may never complete. The only way to clean things up may be to delete an item ID on the GUI side.

			The third warning above is one reason to use numeric IDs instead of descriptive IDs. If you use a descriptive ID, you may end up needing to delete it and it won't be possible in this case to bring it back. So descriptive IDs may end up being lost permanently and therefore wasted.

	S6) Supported mediatypes seem to include: software, movies, image. "text" or "texts" may work as well but this hasn't been confirmed yet.		S6) Supported mediatypes seem to include: software, movies, image. "text" or "texts" may work as well but this hasn't been confirmed yet.

Poetry at 06:50, 24 November 2023

2023-11-24T06:50:21Z

← Older revision		Revision as of 23:50, 23 November 2023
Line 49:		Line 49:
	ia upload \		ia upload \
	--metadata=mediatype:software \		--metadata=mediatype:software \
	~~Final_Minetest_Assemble~~ \		23112301 \
	minetest-assemble-231123.tgz		minetest-assemble-231123.tgz

	The user needs to enter some information manually using the Internet Archive web GUI. This includes original creator, original date, and ~~description~~.		The user needs to enter some information manually using the Internet Archive web GUI. This includes title, original creator, original date, description, and keywords.

	The "~~Final_Minetest_Assemble~~" string in this example should be replaced with a unique item ID. Note: The ID can't be changed later.		The "23112301" string in this example should be replaced with a unique item ID. Note: The ID can't be changed later. The ID can be a descriptive string [using underscores instead of spaces] but for technical reasons this isn't recommended.

	S4) To replace the uploaded file, without deleting the item ID, one could try this:		S4) To replace the uploaded file, without deleting the item ID, one could try this:

	ia delete ~~Final_Minetest_Assemble~~		ia delete 23112301
	# ~~repeat~~ the ia upload		# Repeat the "ia" upload

	~~S5) Two warnings~~:		Replace 23112301 here with the appropriate item ID. Note: This operation deletes the contents of the item ID but not the item ID itself.

	Warning #1: If one deletes ~~the~~ item ID at the GUI level, it is then gone forever.		S5) Three warnings:

			Warning #1: If one deletes an item ID at the GUI level, it is then gone forever.

	Warning #2: It doesn't seem to be possible to change mediatype for an item ID once it's set; either using the IArchive GUI or CLI. An item ID can have multiple files. The primary file needs to be uploaded first and the mediatype needs to be specified, and specified correctly, for that file.		Warning #2: It doesn't seem to be possible to change mediatype for an item ID once it's set; either using the IArchive GUI or CLI. An item ID can have multiple files. The primary file needs to be uploaded first and the mediatype needs to be specified, and specified correctly, for that file.

	S6) Supported mediatypes seem to include: software, movies, image, texts		Warning #3: "ia" operations don't complete immediately on the Internet Archive side. Sometimes they may never complete. The only way to clean things up may be to delete an item ID on the GUI side. This is one reason to use numeric IDs instead of descriptive IDs. If you use a descriptive ID, you may end up needing to delete it and it won't be possible in this case to bring it up.

			S6) Supported mediatypes seem to include: software, movies, image. "text" or "texts" may work as well but this hasn't been confirmed yet.

	For anything else, don't set the mediatype.		For anything else, don't set the mediatype.
Line 73:		Line 77:
	S7) If a source-code tarball is uploaded in this manner, one can upload a JPEG or PNG file subsequently to the same item ID:		S7) If a source-code tarball is uploaded in this manner, one can upload a JPEG or PNG file subsequently to the same item ID:

	ia upload \		ia upload 23112301 screenshot.png
	~~Final_Minetest_Assemble \~~
	screenshot.png

	Note that mediatype isn't specified here because this isn't an upload of the primary file.		Note that mediatype isn't specified here because this isn't an upload of the primary file.

Poetry at 06:04, 24 November 2023

2023-11-24T06:04:39Z

← Older revision		Revision as of 23:04, 23 November 2023
Line 67:		Line 67:
	Warning #2: It doesn't seem to be possible to change mediatype for an item ID once it's set; either using the IArchive GUI or CLI. An item ID can have multiple files. The primary file needs to be uploaded first and the mediatype needs to be specified, and specified correctly, for that file.		Warning #2: It doesn't seem to be possible to change mediatype for an item ID once it's set; either using the IArchive GUI or CLI. An item ID can have multiple files. The primary file needs to be uploaded first and the mediatype needs to be specified, and specified correctly, for that file.

	S6) Supported mediatypes seem to include: software, movies, ~~images~~, texts		S6) Supported mediatypes seem to include: software, movies, image, texts

	For anything else, don't set the mediatype.		For anything else, don't set the mediatype.

Poetry at 05:20, 24 November 2023

2023-11-24T05:20:32Z

← Older revision		Revision as of 22:20, 23 November 2023
Line 65:		Line 65:
	Warning #1: If one deletes the item ID at the GUI level, it is then gone forever.		Warning #1: If one deletes the item ID at the GUI level, it is then gone forever.

	Warning #2: It ~~isn~~'t possible to change mediatype at the GUI ~~level~~.		Warning #2: It doesn't seem to be possible to change mediatype for an item ID once it's set; either using the IArchive GUI or CLI. An item ID can have multiple files. The primary file needs to be uploaded first and the mediatype needs to be specified, and specified correctly, for that file.

	S6) If a source-code tarball is uploaded in this manner, one can upload a JPEG or PNG file subsequently to the same item ID:		S6) Supported mediatypes seem to include: software, movies, images, texts

			For anything else, don't set the mediatype.

			S7) If a source-code tarball is uploaded in this manner, one can upload a JPEG or PNG file subsequently to the same item ID:

	ia upload \		ia upload \
	Final_Minetest_Assemble \		Final_Minetest_Assemble \
	screenshot.png		screenshot.png

			Note that mediatype isn't specified here because this isn't an upload of the primary file.

	If things work correctly, the IArchive GUI may then display the screenshot in connection with the tarball.		If things work correctly, the IArchive GUI may then display the screenshot in connection with the tarball.

	'''End of page'''		'''End of page'''

Poetry at 05:14, 24 November 2023

2023-11-24T05:14:02Z

← Older revision		Revision as of 22:14, 23 November 2023
Line 31:		Line 31:
	== Internet Archive CLIs tool  ==		== Internet Archive CLIs tool  ==

	As of Fall 2023, the link below worked and pointed to a Python binary script:		The Internet Archive can be used for FOSS distribution and backup purposes. The procedures used are finicky, flaky, and unreliable. However, this approach may be useful to a limited extent.

			The steps below worked as of Fall 2023. They may or may not still work.

			S1) As of Fall 2023, the link below worked and pointed to a Python binary script:

	https://ia800702.us.archive.org/27/items/ia-pex/ia		https://ia800702.us.archive.org/27/items/ia-pex/ia

	If the script ~~was installed~~ on Debian 11 and chmod'd to 755~~, it provided~~ CLI access to Internet Archive. ~~The following command configured the tool:~~		Install the script on a Debian 11 box and chmod it to 755. This may then provide CLI access to Internet Archive.

	ia configure		S2) Use the following command to configure the tool:

	A command similar to the following ~~could~~ then ~~be used~~ to upload a tarball to Internet Archive ~~[where it would be downloadable by the public]~~:		ia configure

			S3) A command similar to the following may then work to upload a source code tarball to Internet Archive:

	ia upload \		ia upload \
Line 46:		Line 52:
	minetest-assemble-231123.tgz		minetest-assemble-231123.tgz

	The ~~uploader needed~~ to enter some information manually using the Internet Archive web GUI. This ~~included~~ original creator, original date, and description.		The user needs to enter some information manually using the Internet Archive web GUI. This includes original creator, original date, and description.

	The "Final_Minetest_Assemble" string in this example ~~specified~~ a unique ~~and unchangeable~~ item ID.		The "Final_Minetest_Assemble" string in this example should be replaced with a unique item ID. Note: The ID can't be changed later.

	To replace the uploaded file, without deleting the item ID, one could do this:		S4) To replace the uploaded file, without deleting the item ID, one could try this:

	ia delete Final_Minetest_Assemble		ia delete Final_Minetest_Assemble
	# repeat the ia upload		# repeat the ia upload

	Warning #1: If one ~~deleted~~ the item ID at the GUI level, it ~~was~~ then gone forever.		S5) Two warnings:

			Warning #1: If one deletes the item ID at the GUI level, it is then gone forever.

			Warning #2: It isn't possible to change mediatype at the GUI level.

			S6) If a source-code tarball is uploaded in this manner, one can upload a JPEG or PNG file subsequently to the same item ID:

			ia upload \
			Final_Minetest_Assemble \
			screenshot.png

	~~Warning #2: It wasn't possible to change mediatype at~~ the GUI ~~level~~.		If things work correctly, the IArchive GUI may then display the screenshot in connection with the tarball.

	'''End of page'''		'''End of page'''

Poetry: Poetry moved page IArchive CLI Tool to Internet Archive CLI Tool

2023-11-24T04:31:30Z

Poetry moved page IArchive CLI Tool to Internet Archive CLI Tool

← Older revision

Revision as of 21:31, 23 November 2023

Poetry: Created page with "
Start Page Browser Play! Minetest MT worlds Bucket Game Player Basics Downloads Contact Devel Center

[https://minetest.org/ minetest.org] [https://minetest.io minetest.io] [https://git.minetest.io/ 9,000 gits] [https://irc.minetest.org:9000/ CoderChat] [https://edgy1.net/ EdgyNet] <..."

2023-11-24T04:30:20Z

Created page with "<div class="p44_navbar"> Start Page Browser Play! Minetest MT worlds Bucket Game Player Basics Downloads Contact Devel Center </div> <div class="p44_navbar"> [https://minetest.org/ minetest.org] [https://minetest.io minetest.io] [https://git.minetest.io/ 9,000 gits] [https://irc.minetest.org:9000/ CoderChat] [https://edgy1.net/ EdgyNet] <..."

New page

<div class="p44_navbar">
[[Main_Page|Start Page]]
[[Browser_Play|Browser Play!]]
[[Minetest|Minetest]]
[[MTWorlds|MT worlds]]
[[Bucket_Game|Bucket Game]]
[[Player_Basics|Player Basics]]
[[Downloads|Downloads]]
[[Contact|Contact]]
[[Devel_Center|Devel Center]]
</div>

<div class="p44_navbar">
[https://minetest.org/ minetest.org]
[https://minetest.io minetest.io]
[https://git.minetest.io/ 9,000 gits]
[https://irc.minetest.org:9000/ CoderChat]
[https://edgy1.net/ EdgyNet]
</div>

<br />
----

<span id="introduction"></span>
== Introduction ==

This page provides some information related to an Internet Archive CLI tool.
<br />

<span id="iatool"></span>
== Internet Archive CLIs tool  ==

As of Fall 2023, the link below worked and pointed to a Python binary script:

https://ia800702.us.archive.org/27/items/ia-pex/ia

If the script was installed on Debian 11 and chmod'd to 755, it provided CLI access to Internet Archive. The following command configured the tool:

ia configure

A command similar to the following could then be used to upload a tarball to Internet Archive [where it would be downloadable by the public]:

ia upload \
--metadata=mediatype:software \
Final_Minetest_Assemble \
minetest-assemble-231123.tgz

The uploader needed to enter some information manually using the Internet Archive web GUI. This included original creator, original date, and description.

The "Final_Minetest_Assemble" string in this example specified a unique and unchangeable item ID.

To replace the uploaded file, without deleting the item ID, one could do this:

ia delete Final_Minetest_Assemble
# repeat the ia upload

Warning #1: If one deleted the item ID at the GUI level, it was then gone forever.

Warning #2: It wasn't possible to change mediatype at the GUI level.

'''End of page'''