Difference between revisions of "Getting Started"

From Liberty Eiffel Wiki
Jump to navigation Jump to search
(creation)
 
 
(25 intermediate revisions by 3 users not shown)
Line 1: Line 1:
  +
== Prepared Debian/Ubuntu packages ==
On Linux (and most other Unix-like systems) installation of Liberty is simple:
 
  +
On http://apt.liberty-eiffel.org/ we have prepared some Debian/Ubuntu packages. For the quick start using the last stable release do:
   
Clone the repository:
+
* add the following repository (note: it is currently unsigned)
  +
<nowiki>deb http://apt.liberty-eiffel.org/ release main</nowiki>
git clone git@github.com:LibertyEiffel/Liberty
 
  +
  +
* then install (as root or with sudo)
  +
apt-get install liberty-eiffel-all
  +
  +
That's it, you now can run "se c" to [[Tutorial_tour|compile your first program.]]
  +
  +
== Windows Installer ==
  +
In a 2016 [[GSoC_-_Windows_Support|GSoC project]] Petru Gurita worked on a Windows installer using NSIS. His [https://github.com/petr00/Liberty-Eiffel-Windows repository] is hosted on GitHub.
  +
  +
Since October 2024, an installation script exists that loosely mimics the 'install.sh' script that is used on Linux based machines. The installation process is documented on a separate page: [[Installing on Windows using the Tiny-C compiler]]
  +
This Windows cmd-script only assumes that you have a Tiny-C compiler installed - no need to download and run external installation packages.
  +
  +
== Bootstrap from tarball ==
  +
Download the <release>.tar.gz from http://download.savannah.gnu.org/releases/liberty-eiffel
  +
unpack it with
  +
tar -zxvf <release>.tar.gz
  +
  +
bootstrap Liberty with
  +
cd <release>
  +
./install.sh -bootstrap
  +
  +
This will create a default liberty configuration in ~/.config/liberty-eiffel/, bootstrap the compiler and compile all the tools. Afterwards you just need to add <LibertyHome>/target/bin to your path, e. g. in .bashrc:
  +
PATH=$PATH:~/<release>/target/bin
  +
export PATH
  +
  +
== Bootstrap from git source ==
  +
On Linux (and most other Unix-like systems) installation of Liberty from source is simple:
  +
  +
Check that the following Pre-requisites are available on your system:
  +
* git
  +
* GCC compiler
  +
* castxml (or GCC-XML)
  +
* Boehm-Demers-Weiser garbage collector dev-packages
  +
  +
On debian-like systems you may install them with:
  +
sudo apt-get install git build-essential castxml libgc-dev
  +
  +
On Fedora you'll need gc-devel, rather than libgc-dev, castxml and of course the basic packages for compiling like gcc, git etc.
  +
  +
Now clone the repository:
  +
git clone git://git.sv.gnu.org/liberty-eiffel.git
   
 
Change into the directory you created by this:
 
Change into the directory you created by this:
cd Liberty
+
cd liberty-eiffel
   
 
and execute
 
and execute
install.sh -bootstrap
+
./install.sh -bootstrap
   
This will create a default liberty configuration in $HOME$/.serc/, bootstrap the compiler and compile all the tools. Afterwards you just need to add <LibertyHome>/target/bin to your path, e. g. in .bashrc:
+
This will create a default liberty configuration in ~/.config/liberty-eiffel/, bootstrap the compiler and compile all the tools. Afterwards you just need to add <LibertyHome>/target/bin to your path, e. g. in .bashrc:
PATH=$PATH:<LibertyHome>/target/bin
+
PATH=$PATH:~/liberty-eiffel/target/bin
export PATH
+
export PATH
   
'''Please note that SmartEiffel should not be already installed on your system. Particularily, any /etc/serc file will prevent you from installing Liberty correctly.
+
'''Please note that no legacy SmartEiffel system should be installed on your system. Particularily, any /etc/serc file will prevent you from installing Liberty Eiffel correctly.
 
'''
 
'''
 
Now you can call [[Se|se]] as interface for all tools. For examples go to
 
Now you can call [[Se|se]] as interface for all tools. For examples go to
cd $LibertyHome/tutorial
+
cd <LibertyHome>/tutorial
 
and compile with
 
and compile with
 
se compile hello_world.e -o hello_world
 
se compile hello_world.e -o hello_world
your first LibertyEiffel program.
+
your first Liberty Eiffel program.
   
 
After this great success, play with the [[Table of contents#Eiffel|language]], [[Tools|tools]] and [[Table of contents#Library|libraries]]. Develop cool applications and for any question, suggestion or complaint [[Get in touch|get in touch]] with us. We are also happy to receive pull requests and provide accounts to this wiki if you want to contribute code or documentation. Be welcome to [[Get involved| get involved]].
 
After this great success, play with the [[Table of contents#Eiffel|language]], [[Tools|tools]] and [[Table of contents#Library|libraries]]. Develop cool applications and for any question, suggestion or complaint [[Get in touch|get in touch]] with us. We are also happy to receive pull requests and provide accounts to this wiki if you want to contribute code or documentation. Be welcome to [[Get involved| get involved]].

Latest revision as of 11:21, 28 October 2024

Prepared Debian/Ubuntu packages

On http://apt.liberty-eiffel.org/ we have prepared some Debian/Ubuntu packages. For the quick start using the last stable release do:

  • add the following repository (note: it is currently unsigned)
deb http://apt.liberty-eiffel.org/ release main
  • then install (as root or with sudo)
apt-get install liberty-eiffel-all

That's it, you now can run "se c" to compile your first program.

Windows Installer

In a 2016 GSoC project Petru Gurita worked on a Windows installer using NSIS. His repository is hosted on GitHub.

Since October 2024, an installation script exists that loosely mimics the 'install.sh' script that is used on Linux based machines. The installation process is documented on a separate page: Installing on Windows using the Tiny-C compiler This Windows cmd-script only assumes that you have a Tiny-C compiler installed - no need to download and run external installation packages.

Bootstrap from tarball

Download the <release>.tar.gz from http://download.savannah.gnu.org/releases/liberty-eiffel unpack it with

tar -zxvf <release>.tar.gz

bootstrap Liberty with

cd <release>
./install.sh -bootstrap

This will create a default liberty configuration in ~/.config/liberty-eiffel/, bootstrap the compiler and compile all the tools. Afterwards you just need to add <LibertyHome>/target/bin to your path, e. g. in .bashrc:

PATH=$PATH:~/<release>/target/bin
export PATH

Bootstrap from git source

On Linux (and most other Unix-like systems) installation of Liberty from source is simple:

Check that the following Pre-requisites are available on your system:

  • git
  • GCC compiler
  • castxml (or GCC-XML)
  • Boehm-Demers-Weiser garbage collector dev-packages

On debian-like systems you may install them with:

sudo apt-get install git build-essential castxml libgc-dev

On Fedora you'll need gc-devel, rather than libgc-dev, castxml and of course the basic packages for compiling like gcc, git etc.

Now clone the repository:

git clone git://git.sv.gnu.org/liberty-eiffel.git

Change into the directory you created by this:

cd liberty-eiffel

and execute

./install.sh -bootstrap

This will create a default liberty configuration in ~/.config/liberty-eiffel/, bootstrap the compiler and compile all the tools. Afterwards you just need to add <LibertyHome>/target/bin to your path, e. g. in .bashrc:

PATH=$PATH:~/liberty-eiffel/target/bin
export PATH

Please note that no legacy SmartEiffel system should be installed on your system. Particularily, any /etc/serc file will prevent you from installing Liberty Eiffel correctly. Now you can call se as interface for all tools. For examples go to

cd <LibertyHome>/tutorial

and compile with

se compile hello_world.e -o hello_world

your first Liberty Eiffel program.

After this great success, play with the language, tools and libraries. Develop cool applications and for any question, suggestion or complaint get in touch with us. We are also happy to receive pull requests and provide accounts to this wiki if you want to contribute code or documentation. Be welcome to get involved.