Compare commits

..

No commits in common. "master" and "options" have entirely different histories.

19 changed files with 115 additions and 366 deletions

View file

@ -1,41 +1,17 @@
<!-- vim: set et ts=2 sw=2 tw=80 : -->
# msh-console
Library that provides a bash-like command line interface for C++ programs.
## Abandoned
This was my first OOP project, so pardon the style and the conventions taken.
This project is currently unmantained.
## Features include:
* flag handling implemented with `popt.h`;
* creation of personalized commands in the same thread of the shell or in other
threads;
* basic shell functionalities, such as execution of other programs in the
system. This is implemented with `execvp()`.
* piping, implemented with `<unistd.h>` `pipe()` function. Code based on
https://stackoverflow.com/a/5207730.
## What is not actually included:
# Msh-console
* included flag handling implemented with popt.h;
Library that provides a bash-like command line for C++ programs. Features included:
* creation of personalized commands in the same thread of the shell or in other threads;
* basic shell functionalities, such as execution of other programs in the system. This is implemented with execvp().
What is not actually included:
* advanced shell features, like:
* redirection,
* scripting,
* command history.
## Credits
Code based on
["Write a Shell in C"](http://brennan.io/2015/01/16/write-a-shell-in-c/)
tutorial by Stephen Brennan. The code contains `stringtoargcargv.cpp`, a set of
functions written by Bernhard Eder
[here](http://web.archive.org/web/20121030075237/http://bbgen.net/blog/2011/06/string-to-argc-argv)
for parsing a string into `argc` and `argv`.
## Compiling
The library can be compiled as shared library with the CMakeLists.txt file
already in `msh-console-library/`.
* piping,
* redirection,
* scripting,
* command history.
### Credits
Code based on "Write a Shell in C" tutorial by Stephen Brennan (http://brennan.io/2015/01/16/write-a-shell-in-c/).
The code has been slightly modified.
The code contains stringtoargcargv.cpp, a set of functions written by Bernhard Eder (http://web.archive.org/web/20121030075237/http://bbgen.net/blog/2011/06/string-to-argc-argv) for parsing a string into argc and argv.
### Compiling
The library can be compiled as shared library with the CMakeLists.txt file already in msh-console-library/.

9
aur/.gitignore vendored
View file

@ -1,9 +0,0 @@
# src folder
src/
# pkg folder
pkg/
# created package
*.pkg.tar.xz
*.zip

View file

@ -1,46 +0,0 @@
# Maintainer : praticamentetilde
_name=libmshconsole
_branch=master
pkgname=libmshconsole
pkgver=0.40f2b2e
pkgrel=1
pkgdesc='Library that provides a bash-like interface for CLI C++ programs'
url='https://github.com/praticamentetilde/msh-console.git'
arch=('any')
license=('custom:unlicense')
depends=()
makedepends=('git' 'gcc' 'cmake')
optdepends=()
headers=('commandexecutor.h' 'command.h' 'shell.h' 'stringtoargcargv.h')
provides=()
conflicts=()
pkgver() {
DATE='0'
HASH=$(git ls-remote -h $url $_branch | cut -c1-7)
echo $DATE.$HASH
}
source=("$pkgname-$(pkgver).zip::https://github.com/praticamentetilde/msh-console/archive/$_branch.zip")
sha512sums=(SKIP)
#prepare() {}
package() {
cd msh-console-$_branch/library
cmake CMakeLists.txt
make
mkdir -p "$pkgdir"/usr/include/mshconsole
chmod 0755 "$pkgdir"/usr/include/mshconsole
mv libmshconsole.so libmshconsole.so.1
install -D -m644 libmshconsole.so.1 "$pkgdir"/usr/lib/libmshconsole.so.1
ln -s "$pkgdir"/usr/lib/libmshconsole.so.1 "$pkgdir"/usr/lib/libmshconsole.so
for i in "${headers[@]}"
do
install -D -m644 $i "$pkgdir"/usr/include/mshconsole/"$i"
done
}

View file

@ -1,2 +0,0 @@
# msh-console-aur
AUR package for msh-console

View file

@ -1,7 +1,24 @@
2017 Claudio Maggioni (praticamentetilde)
This is free and unencumbered software released into the public domain.
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
Anyone is free to copy, modify, publish, use, compile, sell, or
distribute this software, either in source code form or as a compiled
binary, for any purpose, commercial or non-commercial, and by any
means.
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
In jurisdictions that recognize copyright laws, the author or authors
of this software dedicate any and all copyright interest in the
software to the public domain. We make this dedication for the benefit
of the public at large and to the detriment of our heirs and
successors. We intend this dedication to be an overt act of
relinquishment in perpetuity of all present and future rights to this
software under copyright law.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.
For more information, please refer to <http://unlicense.org>

View file

@ -25,15 +25,14 @@ cmake_minimum_required(VERSION 2.8)
SET(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++11 -lpopt")
list(APPEND SRC_LIST "command.cpp" "commandexecutor.h" "commands.cpp" "datas.cpp" "shell.cpp" "stringtoargcargv.cpp"
"commandexecutor.cpp" "command.h" "data.cpp" "${CMAKE_CURRENT_SOURCE_DIR}/../snippet/main.cpp" "shell.h" "stringtoargcargv.h")
"commandexecutor.cpp" "command.h" "data.cpp" "main.cpp" "shell.h" "stringtoargcargv.h")
set(lib Off) #off=debug demo with main.cpp, on=library
set(lib ON) #off=debug demo with main.cpp, on=library
if(${lib})
MESSAGE(STATUS "Building .so.1")
list(REMOVE_ITEM SRC_LIST ${CMAKE_CURRENT_SOURCE_DIR}/../msh-console-script/main.cpp) #remove snippet file
list(REMOVE_ITEM SRC_LIST ${CMAKE_CURRENT_SOURCE_DIR}/main.cpp) #remove demo file
add_library (mshconsole SHARED ${SRC_LIST})
else(${lib})
MESSAGE(STATUS "Building msh-console-snippet (debug only)")
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -g")
MESSAGE(STATUS "Building exec (debug only)")
add_executable(${PROJECT_NAME} ${SRC_LIST})
endif(${lib})

View file

@ -43,6 +43,8 @@ namespace mshconsole {
int Command::execute(const struct Params& p, CommandExecutor* c, std::ostream& errorStream){
if(p.argc<=0) return -1;
// options a, b, c take integer arguments
// options f and g take no arguments
poptContext pc;
opts.push_back(POPT_TERMINATOR);
@ -90,8 +92,6 @@ namespace mshconsole {
while (poptPeekArg(pc) != NULL)
nonOptionArgs.push_back(const_cast<const char*>(poptGetArg(pc)));
poptFreeContext(pc);
return (*funcCommand)(c,datas,nonOptionArgs);
}
@ -110,10 +110,5 @@ namespace mshconsole {
}
}
}
Command::~Command(){
}
const struct poptOption Command::POPT_TERMINATOR = {NULL,'\0',POPT_ARG_NONE,NULL,-1,NULL,NULL};
}

View file

@ -41,7 +41,7 @@ namespace mshconsole{
ExitException(int c=0) : code(c){}
};
public:
virtual int executeCmd(const struct Params& args, bool isPipe=false) = 0;
virtual int executeCmd(const struct Params& args) = 0;
virtual int executeCmd(const std::string& args) = 0;
virtual size_t howManyCmds() const = 0;
void exit(int code=0);

View file

@ -46,14 +46,6 @@ namespace mshconsole {
}
throw CommandNotFoundException();
}
bool Shell::Commands::found(const std::string& s, bool launchThread){
for(unsigned int i=0; i<(launchThread ? threadCommands.size() : commands.size()); i++){
if((launchThread ? threadCommands[i]->getName() : commands[i]->getName())==s){
return true;
}
}
return false;
}
}

View file

@ -1,8 +1,8 @@
#include <cstdlib>
#include <cstring>
#include <iostream>
#include "../library/shell.h"
#include "../library/command.h"
#include "../msh-console-library/shell.h"
#include "../msh-console-library/command.h"
using namespace std;
using namespace mshconsole;
@ -55,21 +55,17 @@ int main(int argc, char **argv)
string c = "msh-console-test";
string ps = "[msh-console-test]:";
Shell mshConsoleTest(c, ps, cin,cout,cerr, &setup);
Command help("help", &helpExecute);
Command* help = new Command("help", &helpExecute);
struct poptOption h = {"help",'h',POPT_ARG_NONE,NULL,1000,"advance","advaced options"};
struct poptOption p = {"prova",'p',POPT_ARG_STRING,NULL,1000,"cose","cosecose"};
help.addOption(h);
help.addOption(p);
Command exit("exit", &exitExecute);
Command cd("cd", &cdExecute);
help->addOption(h);
help->addOption(p);
//add builtin commands
mshConsoleTest.addCmd(&help, true);
mshConsoleTest.addCmd(&cd);
mshConsoleTest.addCmd(&exit);
mshConsoleTest.addCmd(help);
mshConsoleTest.addCmd(new Command("exit", &exitExecute));
mshConsoleTest.addCmd(new Command("cd", &cdExecute));
mshConsoleTest.launch();
return EXIT_SUCCESS;
}

View file

@ -60,10 +60,11 @@ namespace mshconsole {
//Run the shell loop.
int exitCode;
std::string* line=nullptr;
std::vector<std::string> p;
try{
std::string* line=nullptr;
struct Params p;
while(1){
delete line;
outputStream << ps << " "; //Print the prompt.
@ -88,11 +89,10 @@ namespace mshconsole {
continue;
}
//Execute the pipe.
executePipe(p);
//Execute the command.
executeCmd(p);
};
} catch(CommandExecutor::ExitException c) {
delete line;
exitCode=c.getCode();
}
@ -103,103 +103,6 @@ namespace mshconsole {
return exitCode;
}
int Shell::executePipe(std::vector<std::string>& argv)
{
int newPipe[2], oldPipe[2], status;
pid_t pid;
std::vector<std::vector<std::string>> argvs;
size_t c=0, i=0;
for(; i<argv.size(); i++){
if(argv[i]=="|"){ //Pipe reached
if(c!=i){
//Write the command in the pipe std::vector
argvs.push_back(std::vector<std::string>(argv.begin()+c, argv.begin()+i));
}
c=i+1;
}
}
if(c!=i){
//Write the last command in the pipe std::vector
argvs.push_back(std::vector<std::string>(argv.begin()+c, argv.end()));
}
if(argvs.size()==1){
struct Params p;
vectorToArgcArgv(argvs[0], &p.argc, &p.argv);
return executeCmd(p,false);
}
for(size_t i=0; i<argvs.size(); i++){
if(cmds.found(std::string(argvs[i][0]),false)){
errorStream << name << ": non-thread command " << argv[0] << " can't be launched from a pipe" << std::endl;
return 1;
}
}
for(size_t i=0; i<argvs.size(); i++) /* For each command */
{
struct Params p;
vectorToArgcArgv(argvs[i], &p.argc, &p.argv);
/* If there still are commands to be executed */
if(i < argvs.size()-1)
{
pipe(newPipe); /* just create a pipe */
}
pid = fork();
if(pid == 0) /* Child */
{
/* If there is a previous command */
if(i > 0)
{
close(oldPipe[1]);
dup2(oldPipe[0], 0); //redirect stdin to input of the pipe
close(oldPipe[0]);
}
/* If there still are commands to be executed */
if(i < argvs.size()-1)
{
close(newPipe[0]);
dup2(newPipe[1], 1); //redirect stdout to output of the pipe
close(newPipe[1]);
}
//Execute
exit(executeCmd(p,true));
}
else if (pid < 0) {
// Error forking
errorStream << name <<": error in process forking.\n";
}
else /* Father */
{
/* If there is a previous command */
if(i > 0)
{
close(oldPipe[0]);
close(oldPipe[1]);
}
/* do we have a next command? */
if(i < argvs.size()-1)
{
oldPipe[0] = newPipe[0];
oldPipe[1] = newPipe[1];
}
/* wait for last command process? */
if(i == argvs.size()-1)
{
waitpid(pid, &status, 0);
}
}
deleteParams(p);
}
return 0;
}
int Shell::launchCmd(const struct Params& p){
int status;
@ -217,9 +120,7 @@ namespace mshconsole {
catch (CommandNotFoundException){}
//execute bash command or program
a=execvp(p.argv[0], p.argv);
if(a == -1) {
if((a=execvp(p.argv[0], p.argv)) == -1) {
outputStream << name << ": execution failed. Errno is set to: "<<strerror(errno)<<"\n";
std::exit(EXIT_FAILURE);
}
@ -239,29 +140,21 @@ namespace mshconsole {
return 1;
}
int Shell::executeCmd(const struct Params& p, bool isPipe){
int Shell::executeCmd(const struct Params& p){
if (!p.argc) return 1; //Return if the line is empty.
if(isPipe){
if(cmds.found(p.argv[0],false)){
errorStream << name << ": non-thread command " << p.argv[0] << " can't be launched from a pipe" << std::endl;
return 1;
}
}
else{
try {
//Search in non-thread commands.
return cmds.launch(p, false);
}
catch(CommandNotFoundException) {}
try {
//Search in non-thread commands.
return cmds.launch(p, false);
}
catch(CommandNotFoundException) {}
//Execute the threadCommand or the executable.
return launchCmd(p);
}
inline int Shell::executeCmd(const std::string &args){
std::vector<std::string>a =splitLine(&args);
return executePipe(a);
return executeCmd(splitLine(&args));
}
void Shell::SIGINTHandler(int,siginfo_t*, void *){
@ -288,14 +181,9 @@ namespace mshconsole {
struct sigaction* setHandler(unsigned signal, void (*funcptr)(int, siginfo_t*, void*)){
struct sigaction* before = new struct sigaction();
struct sigaction sa;
sigset_t mask;
sigemptyset(&mask);
sigaddset(&mask, SIGTERM);
sa.sa_mask=mask;
sa.sa_sigaction = funcptr;
sa.sa_flags = SA_RESTART;
sa.sa_flags = 0;
sigaction(signal, &sa, before);
return before;
}
void restoreHandler(unsigned signal, struct sigaction* before){
@ -318,12 +206,10 @@ namespace mshconsole {
return buffer;
}
std::vector<std::string> Shell::splitLine(const std::string* line){
return parseStringToVector(*line);
}
void Shell::deleteParams(struct Params p){
freeString(p.argc,p.argv);
struct Params Shell::splitLine(const std::string* line){
struct Params p;
stringToArgcArgv(*line, &(p.argc), &(p.argv));
return p;
}
bool Shell::SIGINTRaised = false;

View file

@ -55,7 +55,6 @@ namespace mshconsole {
void add(Command*, bool isthread=false);
size_t howMany() const;
int launch(const struct Params& args, bool launchThread=false);
bool found(const std::string& args, bool launchThread=false);
};
static bool SIGINTRaised;
@ -71,9 +70,7 @@ namespace mshconsole {
int launchCmd(const struct Params& args);
static void SIGINTHandler(int,siginfo_t *info, void *);
std::string* readLine();
std::vector<std::string> splitLine(const std::string* line);
int executePipe(std::vector<std::string>& argv);
void deleteParams(struct Params p);
struct Params splitLine(const std::string* line);
class IsUndoingLineException {};
class CommandNotFoundException {};
@ -94,7 +91,7 @@ namespace mshconsole {
//for in-shell commands
void addCmd(Command *cmd, bool isThread=false);
int executeCmd(const struct Params& args, bool isPipe=false);
int executeCmd(const struct Params& args);
int executeCmd(const std::string& args);
size_t howManyCmds() const;
};

View file

@ -27,38 +27,33 @@
#include "stringtoargcargv.h"
namespace StringToArgcArgv{
/*
* Usage:
* int argc;
* char** argv;
* stringToArgcArgv("foo bar", &argc, &argv);
*/
void stringToArgcArgv(const std::string& str, int* argc, char*** argv)
{
std::vector<std::string> args = parse(str);
static inline bool _isQuote(char c);
static inline bool _isEscape(char c);
static inline bool _isPipe(char c);
static inline bool _isWhitespace(char c);
*argv = (char**)std::malloc((args.size()+1) * sizeof(char*));
void vectorToArgcArgv(const std::vector<std::string>& args, int* argc, char*** argv){
*argv = new char*[args.size()+1]();
int i=0;
for(std::vector<std::string>::const_iterator it = args.begin();
int i=0;
for(std::vector<std::string>::iterator it = args.begin();
it != args.end();
++it, ++i){
std::string arg = *it;
(*argv)[i] = new char[arg.length()+1]();
std::strcpy((*argv)[i], arg.c_str());
}
(*argv)[i]=NULL;
*argc = args.size();
++it, ++i)
{
std::string arg = *it;
(*argv)[i] = (char*)std::malloc((arg.length()+1) * sizeof(char));
std::strcpy((*argv)[i], arg.c_str());
}
(*argv)[i]=NULL;
*argc = args.size();
}
void stringToArgcArgv(const std::string& str, int* argc, char*** argv){
return vectorToArgcArgv(parseStringToVector(str),argc,argv);
}
void freeString(int& argc, char**& argv){
for(int i=0; i<argc; i++){
delete[] argv[i];
}
delete[] argv;
}
std::vector<std::string> parseStringToVector(const std::string& args)
std::vector<std::string> parse(const std::string& args)
{
std::stringstream ain(args); // used to iterate over input string
ain >> std::noskipws; // do not skip white spaces
@ -99,21 +94,19 @@ namespace StringToArgcArgv{
}
}
else if(_isWhitespace(c) || _isPipe(c)) {
switch(currentState) {
else if(_isWhitespace(c)) {
switch(currentState) {
case InArg:
oargs.push_back(currentArg.str());
if(_isPipe(c)) oargs.push_back("|");
currentState = OutOfArg;
break;
oargs.push_back(currentArg.str());
currentState = OutOfArg;
break;
case InArgQuote:
currentArg << c;
break;
currentArg << c;
break;
case OutOfArg:
if(_isPipe(c)) oargs.push_back("|");
// nothing
break;
}
// nothing
break;
}
}
else if(_isEscape(c)) {
switch(currentState) {
@ -174,7 +167,8 @@ namespace StringToArgcArgv{
return oargs;
}
static inline bool _isQuote(char c){
bool _isQuote(char c)
{
if(c == '\"')
return true;
else if(c == '\'')
@ -183,14 +177,16 @@ namespace StringToArgcArgv{
return false;
}
static inline bool _isEscape(char c){
bool _isEscape(char c)
{
if(c == '\\')
return true;
return false;
}
static inline bool _isWhitespace(char c){
bool _isWhitespace(char c)
{
if(c == ' ')
return true;
else if(c == '\t')
@ -198,9 +194,4 @@ namespace StringToArgcArgv{
return false;
}
static inline bool _isPipe(char c){
if(c == '|') return true;
return false;
}
}

View file

@ -36,9 +36,11 @@
#include <cstring>
namespace StringToArgcArgv{
void vectorToArgcArgv(const std::vector<std::string>& args, int* argc, char*** argv);
std::vector<std::string> parseStringToVector(const std::string& args);
bool _isQuote(char c);
bool _isEscape(char c);
bool _isEscape(char c);
bool _isWhitespace(char c);
std::vector<std::string> parse(const std::string& args);
void stringToArgcArgv(const std::string& str, int* argc, char*** argv);
void freeString(int& argc, char**& argv);
}
#endif //STRINGTOARGCARGV_H

45
snippet/.gitignore vendored
View file

@ -1,45 +0,0 @@
#kate directory files
*.directory
#Qt creator .pro.user
*.pro.user
*.cbp
*.txt.user
# Compiled Object files
*.slo
*.lo
*.o
*.obj
# Precompiled Headers
*.gch
*.pch
# Compiled Dynamic libraries
*.so
*.dylib
*.dll
# Fortran module files
*.mod
# Compiled Static libraries
*.lai
*.la
*.a
*.lib
# Executables
*.exe
*.out
*.app
# cmake
CMakeCache.txt
CMakeFiles
CMakeScripts
Makefile
cmake_install.cmake
install_manifest.txt