Command-line tools
One of FOSS Factory's design goals has been to integrate smoothly with the way our users already work. From the developer's standpoint, I don't think we've accomplished that goal very well. So the purpose of this project is to create command-line tools for performing common FOSS Factory operations. This will also help to make the Git integration much smoother.
Status:
[COMPLETE]The final payment was made to jjgignac on Mon, Jul 21, 2008. This project is complete; no new sponsorships or submissions will be accepted. You can continue to use the forums for discussion purposes.
Note: You can propose changes using the forum below.
One of FOSS Factory's design goals has been to integrate smoothly with the way our users already work. From the developer's standpoint, I don't think we've accomplished that goal very well. So the purpose of this project is to create command-line tools for performing common FOSS Factory operations. This will also help to make the Git integration much smoother.
A bash script called 'ff' should be written that can be invoked as follows:
ff [command] [arguments ... ]
The commands are as follows:
duties - Lists all of your current duties.
setup [<keyfile>] - Sets up FOSS Factory Git server access by installing an ssh public key on the server.
init <projid> [<source>] - Creates a public Git code repository for the given project. Only the project lead can do this.
show <projid> - Display project info, including the current requirements and bounty.
subproject <projid> <name> - Creates a subproject of the given project. Your default editor will be invoked to let you enter the initial subproject requirements.
submit <projid> - Sends all locally committed changes on the Git HEAD to FOSS Factory as a project submission. Your default editor will be invoked to let you provide submission comments.
Where necessary, these commands will prompt the user for their FOSS Factory username and password. If the user has a ~/.fossfactory file containing his username and password, then that should be used instead. The format of the ~/.fossfactory file should be as follows:
username=<username>
password=<password>
If the ff script is invoked with no arguments, or with an unknown command, it should produce a helpful usage message.
A bash script called 'ff' should be written that can be invoked as follows:
ff [command] [arguments ... ]
The commands are as follows:
duties - Lists all of your current duties.
setup [<keyfile>] - Sets up FOSS Factory Git server access by installing an ssh public key on the server.
init <projid> [<source>] - Creates a public Git code repository for the given project. Only the project lead can do this.
show <projid> - Display project info, including the current requirements and bounty.
subproject <projid> <name> - Creates a subproject of the given project. Your default editor will be invoked to let you enter the initial subproject requirements.
submit <projid> - Sends all locally committed changes on the Git HEAD to FOSS Factory as a project submission. Your default editor will be invoked to let you provide submission comments.
Where necessary, these commands will prompt the user for their FOSS Factory username and password. If the user has a ~/.fossfactory file containing his username and password, then that should be used instead. The format of the ~/.fossfactory file should be as follows:
username=<username>
password=<password>
If the ff script is invoked with no arguments, or with an unknown command, it should produce a helpful usage message.
Change History:
- 2008-07-18 08:37 EDT [ACCEPTED] A better command name
- 2008-07-17 21:18 EDT [ACCEPTED] Finalized design
- 2008-06-27 09:25 EDT [ACCEPTED] Single script, for easier installation
- 2008-06-26 16:28 EDT [ACCEPTED] Minor fix