넘어지면서 배운다

[Python] 파일 읽고 쓰기(+ 임시 디렉토리 및 파일 생성 방법)

balabala — Wed, 17 May 2023 21:43:21 +0900

open() 함수를 이용한 파일 읽고 쓰기

open() 함수는 파일을 열고 사용자가 파일을 읽기(read), 쓰기(write), 추가(append)를 위해 사용할 수 있는 파일 객체를 반환한다. open() 함수를 사용하여 파일을 열 때, 파일을 닫기 위해 close() 메소드를 꼭 호출해야 한다.

mode
r : 읽기 모드(read mode). 매개변수 기본값.
w : 쓰기 모드(write mode). 파일이 이미 존재하면 기존 내용이 삭제되고, 새로운 내용이 기록된다. 파일이 존재하지 않으면 새로운 파일이 생성된다.
a : 추가 모드(append mode). 파일의 끝에 내용을 추가하기 위해 엽니다. 파일이 이미 존재하면 기존 내용은 변경되지 않고, 추가된다. 파일이 존재하지 않으면 새로운 파일이 생성된다.
t : 텍스트 모드(text mode).
b : 이진 모드(binary mode). 파일을 이진 데이터로 연다. 이미지나 음악 파일과 같은 이진 파일을 읽거나 쓸 때 사용된다.

f = open('test.txt')
context = f.read()  # 파일 읽기
print(context)
f.close()

f = open('test.txt', mode='w')
f.write('hello world!') # 파일 쓰기
f.close()

with 문을 이용한 파일 읽고 쓰기

with 문은 파일을 열고 사용한 후 자동으로 파일을 닫아주는 기능을 제공하며, with 문을 사용하면 파일을 열고 작업을 수행한 뒤, 블록이 끝나면 자동으로 파일을 닫아 준다. 이는 코드를 간결하고 실수를 줄이는 데 도움을 주며, with 문을 사용하면 예외가 발생하더라도 파일이 정상적으로 닫히도록 보장된다.

with open('test.txt') as f:
    context = f.read() # 파일 읽기
    print(context)

with open('test.txt', mode='w') as f:
    f.write('hello world hello python') # 파일 쓰기

SMALL

임시 디렉토리 및 임시 파일을 이용한 읽기 및 쓰기

TemporaryDirectory() : with 문과 함께 사용되며, 임시 작업에 사용할 디렉토리를 생성한다. temp_dir 변수에 임시 디렉토리의 경로가 할당되며, with 블록을 벗어나면 해당 임시 디렉토리와 그 내부의 모든 파일과 하위 디렉토리가 자동으로 삭제된다.

with TemporaryDirectory() as temp_dir:
    print('temp dir path : ', temp_dir)

TemporaryFile() : 기본적으로 이진 모드('w+b')로 파일을 열며, 텍스트와 이진 데이터 모두를 처리할 수 있다. 또한 with 문과 함께 사용되며, temp_file 변수에 임시 파일 객체가 할당된다. 파일에는 이진 데이터를 쓰고 읽는 등 다양한 작업을 할 수 있으며, with 블록을 벗어나면 해당 임시 파일은 자동으로 삭제된다.

with TemporaryFile(mode='w+') as temp_file:
    temp_file.write('hello temp')
    temp_file.seek(0)
    data = temp_file.read()
    print(data)

[Python] 파일 및 디렉토리 생성, 복사, 삭제, 이동(모듈 : os, shutil, glob)

balabala — Sun, 14 May 2023 21:54:41 +0900

디렉토리 생성

os.mkdir() : 지정된 경로에 디렉토리를 생성.
os.makedirs() : 인자로 받은 경로에 디렉토리를 생성. 중간 경로에 해당하는 디렉토리가 존재하지 않으면, 필요한 모든 중간 디렉토리도 생성.

import os

if os.path.exists('package1'):  # 해당 경로에 파일이나 디렉토리의 존재 여부를 확인
    print('ok')     # 있으면 'ok' 출력
else:
    os.mkdir('package1')    # 없으면 디렉토리 생성

os.makedirs('package2/package3/package4') # 중간 디렉토리도 모두 생성

디렉토리 및 파일 복사

shutil.copy() : 파일을 복사하는 함수. 인자로 복사할 파일의 경로와 복사 대상 파일의 경로를 지정할 수 있다.
shutil.copytree() : 디렉토리와 그 하위 디렉토리 및 파일을 복사하는 함수. 디렉토리를 복사할 때는 shutil.copy() 함수보다 shutil.copytree() 함수를 사용해야 한다.

import shutil

shutil.copy('print.py', 'package1') # 파일 복사

shutil.copytree('testdir','package1/testdir') # 하위 디렉토리 및 파일 모두 복사

SMALL

디렉토리 및 파일 삭제

shutil.rmtree() : 인자로 받은 디렉토리를 재귀적으로 삭제하는 함수. 디렉토리 내부의 모든 파일과 서브디렉토리도 함께 삭제.
os.remove() : 파일을 삭제하는 함수. 함수의 인자로 파일 경로를 입력하면 해당 파일이 삭제된다.

import os
import shutil

shutil.rmtree('package2') # 디렉토리 내부의 모든 파일과 서브 디렉토리 삭제

os.remove('test1.txt') # 해당 파일 삭제

디렉토리 및 파일 이동

shutil.move() : 파일 또는 디렉토리를 다른 위치로 이동시키는 함수.

import shutil

shutil.move('print.py', 'package1/testdir') # 파일 해당 디렉토리로 이동

예제(+ glob.glob())

1. 사용자 입력으로 경로(path)를 받는다.
2. 해당 경로에 있는 모든 '.txt'파일 정보를 받는다.
3. '.txt' 파일의 이름 앞에 모두 마직막 파일 수정 날짜를 붙인다.(ex:2023-05-14_test1.txt)
4. newdir 이라는 디렉토리를 생성한다.
5. 수정된 '.txt'파일을 모두 newdir 디렉토리로 이동시킨다.

glob.glob() : 인자로 파일 경로 패턴을 받으며, 해당 패턴과 일치하는 모든 파일의 리스트를 반환. * 와 ? 와 같은 특수 문자를 사용하여 패턴을 지정.

import os
import datetime
import shutil
import glob

path = input('path:')   # 사용자 입력
os.chdir(path)          # 경로 이동

# 해당 경로에 'newdir' 디렉토리가 있는지 확인
if not os.path.exists('newdir'):
    os.mkdir('newdir')      # 없으면 디렉토리 생성

# os.walk() : 지정한 디렉토리와 그 하위 디렉토리를 순회하면서 모든 파일과 폴더에 대한 정보를 제공.
for dirpath, dirnames, files in os.walk('./'):
    for file in os.scandir(dirpath):
        if file.name.endswith('.txt'):  # 문자열 끝이 '.txt'로 끝나는지 여부 검사
            tm = datetime.datetime.fromtimestamp(file.stat().st_mtime)
            new_file = str(tm.year) + '-' + str(tm.month) + '-' + str(tm.day) + '-' + file.name
            os.rename(dirpath + '/' + file.name, new_file)  # 파일 이름 변경

file_ls = glob.glob('*.txt')    # 모든 .txt 파일의 리스트
for name in file_ls:
    shutil.move(name, 'newdir/')    # 파일 이동
print('over!!')

[Python] os listdir()과 scandir()(st_atime, st_mtime, st_ctime)

balabala — Sun, 14 May 2023 12:09:25 +0900

os.listdir()

os.listdir() : 'os' 모듈에서 제공하는 함수로 디렉토리 내의 파일 및 디렉토리 목록을 반환하는 함수이다. 간단하고 빠르게 디렉토리 내의 모든 파일과 디렉토리를 가져올 수 있으며, 각 항목은 문자열 형태로 반환된다.

import os

print(os.getcwd())          # os.getcwd() : 현재 작업 디렉토리 경로를 반환
os.chdir('D:\\test')        # os.chdir('변경될 디렉토리 경로') : 현재 작업 디렉토리를 경로를 변경

dir_list = os.listdir()     # os.listdir() : 지정된 디렉토리에 있는 파일 및 디렉토리의 리스트를 반환
# os.path.isdir() : 인자로 전달된 경로가 디렉토리인지 확인
# os.path.isfile() : 인자로 전달된 경로가 파일인지 확인
for d in dir_list:
    print(d, os.path.isdir(d), os.path.isfile(d))

os.scandir()

os.scandir() : 디렉토리 내의 파일 및 디렉토리 목록과 함께 각 항목의 상세한 정보를 반환하는 함수이다. os.DirEntry 객체를 반환하며, 객체 안에 파일 및 디렉토리의 이름, 경로, 크기, 생성 및 수정 시간 등의 속성 정보를 제공한다. 또한 객체를 사용하여 파일 및 디렉토리를 직접 조작할 수도 있다.

import os
import datetime

dir_list = os.scandir()     # os.scandir() : 지정된 디렉토리의 파일 및 디렉토리 목록을 반환하는 함수(os.DirEntry 객체 반환)
print(dir_list)
for file in dir_list:
    print(file, file.name, file.is_dir())
    # st_size : 파일크기(bytes)
    # st_atime(Access Time) : 파일이 마지막으로 읽혔거나 실행되었던 시간
    # st_mtime(Modified Time) : 파일이 마지막으로 수정된 시간
    # st_ctime(Change Time) : 파일이 마지막으로 변경된 시간
    print(file.stat())
    # 1970년 1월 1일 00:00:00 UTC부터 현재까지 경과된 시간을 초 단위로 나타낸 값(년-월-일 시간)
    print(datetime.datetime.fromtimestamp(file.stat().st_ctime))

SMALL

os.listdir() 과 os.scandir()의 차이점

os.listdir()는 간단하게 파일 및 디렉토리 목록만 가져와야 할 경우에 적합하며, os.scandir()은 상세한 파일 및 디렉토리 정보가 필요할 때 사용하는 것이 좋다. 또한 os.scandir()이 더 많은 시스템 리소스를 사용하기 때문에 대량의 파일 및 디렉토리를 처리 할 때는 주의해야 한다.

예제

1. 사용자 입력으로 경로(path)를 받는다.
2. 해당 경로에 있는 디렉토리 및 파일의 이름과 개수를 출력한다.
3. 해당 경로에 있는 파일 중 이름 'test'가 들어간 파일들만 다시 이름과 개수를 출력한다.

import os

path = input('path:')   # 사용자 입력
os.chdir(path)          # 경로 이동

file_list=[]            # 파일 리스트
dir_list=[]             # 디렉토리 리스트
for file in os.scandir():
    if file.is_dir():       # 디렉토리
        dir_list.append(file.name)
    else:                   # 파일
        file_list.append(file.name)
print(f'디렉토리 개수 ： {len(dir_list)}, 디렉토리명 : {dir_list}')
print(f'파일 개수 : {len(file_list)}, 파일명 : {file_list}')

test_list = []                  # 파일 이름에 'test' 글자가 들어간 파일 리스트

for name in file_list:
    if 'test' in name.lower():  # 대소문자 구분 없이 test가 들어가면 리스트에 추가
        test_list.append(name)

print(f'test가 들어간 파일 개수 : {len(test_list)}, 파일명 : {test_list}')

[Python] print 함수 사용법(포맷출력, f-string, sep&end인자, 파일출력)

balabala — Thu, 11 May 2023 22:19:59 +0900

Python print 함수

print() 함수는 값을 출력하는 함수로, 표준 출력장치에 값을 출력하나. print() 함수는 프로그래밍에서 디버깅, 정보 출력 등의 목적으로 자주 사용된다.

기본 출력

문자 및 문자열

# Char
print('H')
print("H")

# Single quotes
print('Hello World')

# Double quotes(안에 Single quotes 포함해서 출력 가능)
print("Hello World")
print("'hello World'")

# Triple quoted(여러줄에 걸쳐서 출력 가능)
print('''Hello
         World''')

# 공백, 콤마(,), +연산자
print('Hello World')        # 공백 O
print('Hello', 'World')     # 공백 O
print('Hello' + 'World')    # 공백 X

정수, 실수, bool 타입

# int(정수)
print(3)
print(3 + 4)

# float(실수)
print(3.14)
print(3.14 + 3.14)

# bool(True or False)
print(True)
print(False)

sep, end 인자

# end 인자를 사용하여 출력 결과의 끝에 출력될 문자를 지정
# 기본값 : \n(줄바꿈)
print('Hello', end=' ')
print('world!')

print('Hello', end='|')
print('world!')

# sep 인자를 사용하여 각 인자들 사이에 출력될 구분 문자를 지정
print('one', 'two', 'three', sep=',')
print('www', 'google', 'com', sep=".")

변수 및 print 함수를 이용한 파일 출력

# 숫자
num = 100
print(num)

# 문자 및 문자열
c1 = 'c'
c2 = 'Hello'
print(c1)
print(c2)

# 리스트(list)
l = [1,2,3,4,5,'a','b','c']
print(l)

# 튜플(tuple)
t = (1,2,3,4,5,'a','b','c')
print(t)

# 딕셔너리(dictionary)
d ={'a':1, 'b':2,'c':3}
print(d)

# print 함수를 이용한 파일 출력(coding = utf-8)
print('Hello, World!', file=open('test.txt', 'w'))

SMALL

format 및 % 서식을 이용한 출력

# 포맷 문자열
# 문자열 내에 특별한 기호를 사용하여 변수 값을 출력하는 방식
name = 'Jack'
age = 30
height = 1.73
print('Name: {}, Age: {}, Height: {}'.format(name, age, height))

# f-string
name = 'Jack'
age = 30
height = 1.73
print(f'Name: {name}, Age: {age}, Height: {height}')

# 문자열 포맷팅
# %s : 문자열(string)
# %d : 정수(integer)
# %f : 부동소수점(floating-point)
# %c : 문자(character)
# %o : 8진수(octal)
# %x : 16진수(hexadecimal)
# %% : % 기호 자체 출력
name = 'Jack'
age = 30
height = 1.73
print('이름은 %s이고, 나이는 %d살이며, 키는 %f입니다.' % (name, age, height))

# '\' 출력 하는 법
print('hello\\World!')

Jekyll을 이용하여 Github Pages 만드는 방법(Jekyll theme 블로그)

balabala — Tue, 9 May 2023 16:24:03 +0900

목차

Jekyll 사용을 위한 기본 설치

Github pages 만들기(jekyll theme)

이번에는 github pages와 jekyll을 이용해 웹페이지 만드는 방법에 대해 알아보자. 블로그의 종류에는 naver, tistory등 수많은 플랫폼이 있지만 github pages는 markdown기반으로 포스팅을 할 수 있고, 본인이 원한다면 custom domain도 사용 가능하며, jekyll 테마를 지원해서 디자인에 선택의 폭이 훨씬 좋다.

Jekyll 사용을 위한 기본 설치

https://rubyinstaller.org/downloads/

Downloads

Which version to download? If you don’t know what version to install and you’re getting started with Ruby, we recommend that you use the Ruby+Devkit 3.2.X (x64) installer. It provides the biggest number of compatible gems and installs the MSYS2 Devkit

rubyinstaller.org

상단 사이트를 방문해 Ruby+Devkit를 다운로드 받자. 본인은 Ruby+Devkit 3.1.3-1 (x64)를 다운로드해 설치했다.

(1) I accept the License를 클릭하고 Next를 누른다.

(2) 설치할 디렉토리를 선택하고 Next를 누른다.

(3) 다음 화면에서도 아무것도 건들지 않고, Next를 클릭한다.

(4) Run ridk install을 선택한 상태에서 Finish버튼을 누르자.

(5) 우리는 1, 3번 모두 install을 해야 하기 때문에, ENTER(엔터)를 눌러서 install을 진행시킨다.

(6) 이제 명령프롬프트 창에 Ruby와 RubyGems가 잘 설치되었는지 확인을 해보자. 아래 명령어를 입력하고 버전이 나온다면 설치가 완료된것이다.

# Ruby
ruby -v
# RubyGems
gem -v

(7) 다음으로 gem install jekyll bundler를 통해 jekyll과 bundler gems를 설치하고, 아래 명령어를 입력해 버전이 정상적으로 나오면 준비가 끝난 것이다.

# Jekyll Version
jekyll -v
# Bundler Version
bundler -v

Github pages 만들기(jekyll theme)

http://jekyllthemes.org/
https://github.com/topics/jekyll-theme
https://jamstackthemes.dev/ssg/jekyll/

상단 링크를 통해 github page에 적용할 jekyll theme를 고르면 되는데, 상단 사이트외 jekyll theme를 제공하는 사이트는 많다. 원하는 Theme을 고른후, 해당 Theme에 대한 repository를 방문하고 상단 메뉴 있는 Fork를 눌러서 Create a new fork를 클릭해준다.

Repository name에 <Owner이름>.github.io를 입력해주고, Description에는 설명을 적고 Create fork를 클릭한다.

Fork를 통해 repository가 만들어졌으면, Settings에 들어간다.

Settings에서 Pages를 들어간후, Branch부분에서 None에서 다른것으로 변경하고, save버튼을 눌러준다.

SMALL

새로고침을 하면 Visit site버튼이 활성화 된다. 이렇게 하면 나만의 github pages(블로그)가 만들어 진것이다. 이후 _config.yml이나 Gemfile를 수정하면 되는데, 모든 theme마다 다르기 때문에 https://jekyllrb.com/ 해당 사이트를 참고하기 바란다.

GitHub로 돌아와 Code -> HTTPS을 복사해 git clone을 통해 로컬 저장소에 repository를 clone한다.

로컬 저장소에 clone을 완료했다면 cmd(명령프롬프트)를 열어 cd 명령어를 통해 해당 디렉토리로 이동한 후, Jekyll serve 명령을 입력하면 local 서버주소가 나오고, 브라우저에 해당 주소를 입력하면 사이트가 작동하는 것을 확인할 수 있다.

깃 & 깃허브(Git & Github) PULL, PUSH 하는 법(+ 에러 대처법)

balabala — Mon, 8 May 2023 16:06:10 +0900

목차

GIT PULL

GIT PUSH

PULL & PUSH 에러 대처법

GIT PULL

github의 저장소에 내용이 변경되었거나 추가가 되었다면 git pull명령을 사용하면 된다. git pull 명령은 리모트 저장소 브랜치에서 데이터를 가져오고 그 데이터를 자동으로 현재 작업하는 코드와 Merge 시킨다.

Github의 GitTest라는 저장소에 pull.txt라는 파일을 추가하고, git pull을 통해 로컬 저장소로 데이터를 가져오는 예시이다.

Add file -> Create new file를 통해 pull.txt 파일을 만든다. 내용은 원하는것을 적으면 된다.

Visual Studio Code의 TERMINAL창에 git pull를 입력하면, GitTest 저장소에 우리가 추가했던 pull.txt 파일이 추가되는 것을 확인할 수 있다.

GIT PUSH

로컬 저장소에 내용이 변경되었거나 추가가 되었다면 git push명령을 사용하면 된다. 로컬 저장소의 브랜치는 자동으로 리모트 저장소로 전송되지 않기 때문에 git push <remote> <branch>명령을 입력해야 하며 명시적으로 브랜치를 push해야 정보가 전송된다.

로컬 GitTest 저장소에 push.txt라는 파일을 추가하고, git push을 통해 github 저장소로 데이터를 전송하는 예시이다.

git add push.txt 명령을 입력해 Staged 상태로 변경(새롭게 추적할 파일 추가)한다.

git commit -m "add push.txt" 명령을 입력해 커밋을 해준다. -m 뒤에 comment는 자유롭게 입력하면 된다.

git push origin master 명령을 입력해 push를 하고 나서 Github에 있는 GitTest저장소를 확인해보면, 추가한 push.txt가 추가된 것을 볼 수 있다.

여기서 git push origin master 명령어를 입력했는데, origin은 remote이고 master은 branch이다.

git branch 명령으로 브랜치를 볼 수 있는데, 기본적으로 Git은 master브랜치를 만든다. 브랜치는 저장된 커밋 사이를 이동할 수 있는 포인터 같은 것이라고 생각하면 된다.

git remote 명령으로 현재 프로젝트에 등록된 리모트 저장소를 확인할 수 있다. 이 명령은 리모트 저장소의 단축 이름을 보여준다. -v 옵션을 주어 단축이름과 url을 함께 볼수도 있다. 저장소를 Clone 하면 `origin`이라는 리모트 저장소가 자동으로 등록되기 때문에 `origin`이라는 이름을 볼 수 있다.

SMALL

PULL & PUSH 에러 대처법

github 저장소를 이용하면서 pull이나 push관련해서 에러가 생겨 제대로 작동하지 않는 경우가 있는데, 이번에는 아래 같은 상황이 생겼을 때 해결방법에 대해서 이야기 해보겠다.

(1) github 저장소로 git push 에러

github저장소에서 clone해온 프로젝트를 로컬에서 수정 및 추가작업한 내용에 대해 git push명령을 할 때

Error : failed to push some refs to https:

이는 github에서 한번도 pull없이 push를 할 경우 기존 github저장소의 내용과 commit 불일치로 몇몇 내용이 삭제되는 것을 막기 위해 에러 메세지를 발생시키는 것으로 이때는 git pull명령을 한번 입력하고 다시 git push하면 된다.

상단 해결방안이 안되는 경우가 있는데 이때는 아래 명령을 사용해서 강제로 push를 하면 된다.

git push -f origin master

(2) git pull 에러(github 저장소 변경 내용 미적용)

github저장소 프로젝트 내용 변경 이후 로컬 workspace로 git pull명령을 입력해도 commit은 바뀌는데, 프로젝트 내부 파일 코드의 내용이 변경되지 않는 경우가 있다. 이때는 아래 2개의 명령어를 입력하자.

git fetch --all
git reset --hard origin/master

git fetch --all은 서버로부터 최신 데이터를 모두 확인하는 것이고, git reset --hard origin/master명령어는 로컬 workspace에 있는 모든 branch를 버리고 origin/master와 동기화 시킨다는 의미이다.

CMD(명령 프롬프트)창에서 pip install 명령어 안될 때(환경변수 설정)

balabala — Sun, 7 May 2023 15:46:27 +0900

Python의 pip란 무엇인가?

Python에는 다양한 패키지와 라이브러리를 있는데, Python 패키지 관리자인 pip를 사용하여 쉽게 설치할 수 있다. pip는 Python 패키지를 설치, 업그레이드, 삭제하는 것과 같은 패키지 관리 작업을 수행하는 명령줄 인터페이스 도구이다.

CMD(명령 프롬프트)창에서 pip install 명령어가 실행되지 않는 이유

정상적으로 Python을 설치해도 자동으로 환경변수 등록이 되지 않아 명령어를 사용하지 못하는 경우이다. 이런 경우에는 아래와 같은 방법으로 환경변수를 등록하면 pip install 명령어가 실행 가능한 것을 확인할 수 있다.

Python 환경변수 등록 방법

환경변수 여는방법은 내 컴퓨터→ 속성 → 정보창(스크롤 아래로 내림) → 고급 시스템 설정 순서로 들어가면 된다.

SMALL

고급 시스템 설정창에서 환경변수 → 시스템 변수 → Path → 편집 순서대로 클릭한다.

환경 변수 편집 창에서 새로 만들기 버튼을 통해 아래 2가지를 추가해 준다. 파란 글씨는 본인의 컴퓨터 환경에 맞게 변경하면 된다.

" 설치하드:\Users\사용자명\AppData\Local\Programs\Python\파이썬버전 "

" 설치하드:\Users\사용자명\AppData\Local\Programs\Python\파이썬버전\Scripts "

환경 변수 추가 이후 CMD(명령 프롬프트)를 다시 실행시키고, pip 명령어를 입력하면 정상 동작하는 것을 확인할 수 있다.

Visual Studio Code에 GitHub 연동하기(+ Git파일의 4가지 상태)

balabala — Sat, 6 May 2023 15:32:19 +0900

목차

Visual Studio Code 설치방법

Git 저장소(repository) 만들고 GitHub와 연동하는법

Git 파일의 4가지 상태

Visual Studio Code 설치방법

Git과 Github를 사용하기 이전에 계속 Git Bash로 명령어를 입력하기 보다 UI로 편하게 제어하도록 Visual Studio Code를 설치해서 사용하도록 하자.

https://code.visualstudio.com/

Visual Studio Code - Code Editing. Redefined

Visual Studio Code is a code editor redefined and optimized for building and debugging modern web and cloud applications. Visual Studio Code is free and available on your favorite platform - Linux, macOS, and Windows.

code.visualstudio.com

Visual Studio Code에는 Stable과 Insiders이렇게 2가지 버전이 있다. Stable은 영어 뜻 그대로 안정적으로 사용할 수 있는 버전, Insiders는 업데이트가 빨라서 최신 버전의 기능을 사용할 수 있지만 불안정하거나 버그가 발생할 확률이 존재한다. Git을 사용하는데 최신 버전은 중요하지 않으므로 우리는 Stable을 다운받아 사용하도록 하자.

(1) 동의를 선택하고 다음 버튼을 누른다.

(2) 설치할 디렉토리를 설정하고 다음 버튼을 누른다.

(3) 시작 메뉴 폴더를 만들지 물어보는데 그냥 다음 버튼을 누르자.

(4) 필요한 항목이 있다면 추가로 선택하고 다음 버튼을 눌러서 설치를 완료하자.

Git 저장소(repository) 만들고 GitHub와 연동하는법

Git은 주로 다음 두 가지 중 한 가지 방법으로 Git저장소를 쓴다.

(1) 기존 로컬 디렉토리를 Git 저장소로 만들기

Visual Studio Code를 열어서 왼쪽 메뉴중에 Explorer -> Open Folder를 클릭해서 버전관리를 하고 싶은 프로젝트의 디렉토리를 선택해준다. 본인은 여기서 C:\GitTest 디렉토리를 선택했고, index.html과 icon이미지 파일이 있다.

상단메뉴에서 Terminal->New Terminal을 클릭한다.

이제 Terminal에서 git init 명령을 입력해주자. 해당 명령어를 입력하면 .git 이라는 하위 디렉토리를 생성해주는데, 저장소에 필요한 뼈대 파일이 들어있다. 하지만 지금까지의 명령만으로는 프로젝트 내부의 어떤 파일도 버전 관리 항목에 들어가지 않는데, 여기서 git add와 git commit 명령으로 commit을 해주어야 파일 버전 관리를 시작한다.

git add 명령은 버전 관리를 새롭게 추적할 파일을 추가할 때 사용하는 명령어이다. 해당 명령어를 입력받은 파일은 Workspace에서 Staging Area(index)로 추가된 Staged 상태의 파일이다.

git add . 명령을 입력하면 Workspace에 있는 파일 중 내용 변경이 있는 모든 파일을 선택하는 명령어인데, 프로젝트 내부 파일의 어떤 파일도 버전 관리 항목에 없으므로 해당 명령어를 입력했다. 만약 추가할 파일을 선택하고 싶을때는 git add 파일이름.확장자 이렇게 입력만 하면 된다.

# Example
git add NewFile.txt

git commit 명령은 commit한 시점의 내용을 스냅샷으로 저장하고, 해당 스냅샷에 대한 commit 객체를 만드는 명령어이다. Staging Area(index)에 넣은 모든 Staged 상태의 파일을 commit해준다(Committed).

git commit -m “comment” 에서 -m은 commit 메시지를 파라미터로 넘기는 것인데, -m를 하나만 쓰면 제목만 -m를 두개 쓰면 제목과 Description이 된다.

git commit -m “Reversion.0”

git commit -m “Reversion.0” -m “add code”

SMALL

이제 Git저장소 만드는 작업을 완료했으니 원격 저장소인 GitHub와 연동을 시켜보자. GitHub를 회원가입 후 상단 오른쪽 메뉴 중 New repository를 클릭해 GitHub내에 새로운 원격 저장소를 만든다.

Repository name으로 방금까지 작업해온 프로젝트인 GitTest를 입력하고 하단의 Create repository을 눌러서 GibHub저장소를 만들어 준다. 로컬 디렉토리 프로젝트의 이름과 GitHub 저장소의 이름이 동일할 필요는 없지만, 혼동을 방지하기 위해 이름을 동일하게 해서 진행한다.

이제 GitHub에 새로운 저장소가 만들어졌으니 로컬에 있는 프로젝트의 파일을 GitHub에 올리는 작업을 진행할 것이다. 다시 Visual Studio Code로 돌아가서 Terminal에 git remote add origin https주소를 입력해 준다. https는 빨간색 네모칸에 있는 주소를 복사해서 넣으면 된다.

다음으로 git push origin master를 입력하면 GitHub저장소에 로컬 디렉토리 프로젝트의 파일이 추가 된 것을 볼수있다.

(2) Git 저장소에서 Clone 하는 방법

이번에는 GitHub저장소를 Clone하는 방법에 대해서 알아보자. git clone 명령을 사용하게 되면 해당 프로젝트에 대한 히스토리(버전)를 전부 받아올수 있다. Clone에 사용될 GitHub저장소는 방금까지 작업했던 GitTest를 로컬에서 삭제하고 clone해서 다시 받아올 것이다.

Code를 클릭하면 Clone을 하기 위한 저장소에 대한 주소 정보가 나온다. 여기서는 HTTPS를 이용할 것이다. 먼저 해당 주소를 복사하자.

Visual Studio Code를 열어서 Explorer -> Clone Repository를 클릭해 방금 복사한 HTTPS주소를 입력하고 저장할 로컬 디렉토리를 설정만 해주면 완료이다.

Git 파일의 4가지 상태

Git의 workspace(워킹 디렉토리)의 모든 파일에는 크게 Tracked(관리대상) Untracked(비관리대상)으로 나뉘고, Tracked파일은 또 다시 Unmodified(수정하지 않음), Modified(수정됨), Staged(커밋으로 저장소에 기록될 파일)로 나뉜다.

Tracked : 이미 스냅샷에 포함되어 있는 파일

Unmodified : 최신 버전의 스냅샷 내용과 완전히 일치한 상태. 처음 clone을 했을 때 모든 파일이 이 상태이다. 수정을 하게 되면 Modified 상태로 변경되고, git rm을 사용하면 Untracked상태로 변경된다.
Modified : 마지막 commit이후 파일이 수정된 상태. git add 명령을 통해 Staged 상태로 변경하거나, git checkout 명령을 통해 Unmodified 상태로 돌아갈 수 있다.
Staged : commit으로 곧 저장소에 기록될 상태. Git commit 이후에는 Unmodified상태로 변경되고, git reset HEAD filename 명령을 통해 Modified 상태로 돌아갈 수 있다.

Untracked : Tracked 파일을 제외한 나머지 파일. git add 명령을 통해 Staged로 변경할 수 있다.

git 파일 상태는 일반적으로 git status명령을 사용한다. git status명령만 입력하면 Workspace와 Staging Area의 파일들의 상태를 보여준다. git status [filename]을 입력하면 해당 파일에 대한 상태만을 볼 수 있다.

git status

git status index.html

깃(Git) 설치 및 사용환경 설정 하는법(+ 필수 Linux 명령어)

balabala — Fri, 5 May 2023 13:58:14 +0900

목차

깃(Git) 설치방법

깃(Git) 사용환경 설정

필수 Linux 명령어

깃(Git) 설치방법

https://git-scm.com

Git

git-scm.com

1. 상단 링크를 방문해 최신버전의 Git Setup 파일을 받을 것이다. 아래 사진은 Git 홈페이지 모습이고, 빨간색 네모를 클릭한다.

2. 다음으로 컴퓨터 운영체제의 환경에 맞는 Setup 파일을 다운로드 하면 된다. 본인은 Windows 64bit를 다운 받았다.

3. 만약 Windows10 이라면 다음과 같은 과정을 거쳐서 운영체제의 bit가 몇인지 확인 할 수 있다. 내컴퓨터 -> 속성 -> 정보 화면을 보게 되면 아래와 같이 현재 사용하고 있는 운영체제의 정보를 알 수 있다.

4. Setup을 다운로드 완료했다면 실행시켜 주고, 처음 화면에서는 Next를 눌러준다.

5. Git이 설치될 디렉토리를 설정해주는 화면인데 본인은 하드디스크 D에 설치하였기에 수정을 하였고, 특별히 요구사항이 없다면 그냥 Next버튼을 눌러주면 된다.

6. 기본설정 상태로 Next를 눌러주면 된다.

7. 시작메뉴에 Git을 추가할건지 묻는것인데 그냥 Next를 클릭해준다.

8. 다음으로 default editor를 설정하는 화면인데 본인이 Git을 사용할 때 사용할 기본 프로그램을 선택하고 Next를 눌러주면 된다.

9. Let Git decide를 선택하고 Next를 눌러준다.

10. 다음으로 Git from the command line and also from 3rd-party software를 선택하고 Next를 누른다.

11. Use Bundled OpenSSH를 선택하고 Next버튼을 누른다.

12. Use the OpenSSL library를 클릭하고 Next를 누른다.

13. Checkout Windows-style, commit Unix-style line endings를 선택하고 Next를 누른다.

14. Use MinTTY(the default terminal of MSYS2)를 선택하고 Next를 누른다.

15. Default(fast-forward or merge)를 선택하고 Next를 누른다.

16. Git Credential Manager를 선택하고 Next를 누른다.

17. Enable file system caching를 선택하고 Next를 누르면 이제 설치가 진행될 것이다.

18. 설치가 완료되면 다음과 같이 Completing the Git Setup Wizard라는 말이 나올것이다.

19. 설치가 완료된 후 시작메뉴에 Git폴더가 추가된 것을 볼 수 있다. Git 프로그램 항목에 대해 간단히 소개를 하자면 다음과 같다.

Git Bash: 유닉스와 리눅스 스타일의 명령, 가장 많이 사용하기 때문에 추천.
Git CMD: 윈도우 스타일의 명령.
Git GUI: 그랙픽 인터페이스. 초보자에게는 권장하지 않으며 가능한 명령어를 숙지하기 위해 Git Bash를 사용하자.

20. Git Bash를 실행시키고 ls 명령어를 입력한 모습이며, Git Bash를 어느 특정한 디렉토리를 선택하고 실행한 것이 아니라면 기본 디렉토리 위치는 C:\Users\사용자이름 이 된다.

깃(Git) 사용환경 설정

Git을 설치하고 나면 가장 먼저 Git의 사용 환경을 설정해야 하는데, git config라는 도구로 설정 내용을 확인하고 변경 할 수 있으며, Git은 설정한 환경에 따라 동작한다. 환경 설정은 처음 한 번만 하면 되고, Git이 업그레이드 되어도 설정은 유지된다. Git은 commit할 때마다 우리가 설정한 사용자이름과 이메일 주소를 사용하는데, 이를 설정하는 방법은 다음과 같다.

1
2

git config --global user.name "helloWorld"  #사용자 이름
git config --global user.email helloWorld@example.com #이메일 주소

cs

위 명령어를 입력 후 git config --global --list 명령을 입력해 사용자이름과 이메일 주소가 잘 설정됬는지 확인한다.

만약 프로젝트 마다 다른 이름과 이메일 주소를 사용하고 싶으면 –global 옵션을 빼고 명령을 실행하면 된다.

사용자 정보를 포함한 시스템 설정 내용을 보고 싶으면 git config -l(=list) 을 입력 하면 된다. 현재 사용자 이름과 이메일에 대한 설정은 C:\Users\사용자이름\.gitconfig 파일, 시스템 설정 내용은 설치하드:\Program Files\Git\etc\gitconfig 파일을 보면 된다.

SMALL

필수 Linux 명령어

위까지 완료했다면 이제 Git을 사용할 환경이 준비되었다. 그럼 본격적으로 Git 사용법에 대해 알아보기 전 평소에 많이 사용하는 Linux 필수 명령어에 대해 배워보자.

(1) cd

cd : default로 설정되어 있는 디렉토리로 이동.
Cd .. : 현재 디렉토리의 상위 디렉토리로 이동.
cd 디렉토리명 : 현재 디렉토리에 존재하는 디렉토리 목록 중 일치하는 디렉토리로 이동
cd /디렉토리명/디렉토리명 : 현재 위치에 상관없이 해당 디렉토리로 이동. 단, 전체 root를 입력해야 한다.

(2) pwd : 현재 위치하고 있는 디렉토리의 전체 경로 출력.

(3) ls(ll) : ls는 해당 디렉토리에 존재하는 파일과 폴더를 나타내 주며, ll을 입력하면 권한과 시간등 파일과 디렉토리에 대한 상세 정보가 나온다.

(4) touch : 새로운 파일을 생성하거나, 해당 파일의 타임스탬프를 변경하는 용도로 사용한다.

(5) rm : 현재 디렉토리에 존재하는 파일을 삭제하는 명령어.

(6) mkdir : 현재 디렉토리에 새로운 폴더 생성.

(7) rm -r : 현재 디렉토리에 있는 폴더 삭제 명령어. rm -rf / 를 사용하게 되면, 컴퓨터에 있는 모든 파일과 디렉토리를 삭제하므로 주의해야 한다.

(8) mv : mv + 파일명 + 디렉토리명 입력을 통해 해당 파일을 입력한 디렉토리로 이동시킨다.

(9) clear : 명령창 깨끗하게 정리.

버전 관리 시스템과 Git의 기본이론 및 원리(Git vs SVN)

balabala — Thu, 4 May 2023 13:03:31 +0900

목차

버전 관리 시스템이란?

버전 관리 소프트웨어의 종류

버전 관리 시스템의 종류

Git과 SVN의 주요 차이점

Git의 기본이론

버전 관리 시스템이란?

버전관리(Revision control)는 개발과정에서 사용하는 파일, 디렉토리 등에 대한 수정 이력을 기록 및 관리하며, 변경 이력에 대해 쉽게 열람할 수 있을 뿐만 아니라, 특정 시점의 버전으로 편하게 복원해주는 시스템이다. 아래는 버전 관리 시스템의 장점을 간단하게 정리해 보았다.

공간에 제한받지 않고 여러 사람과 협동 개발이 가능하다.
하나 또는 그 이상의 파일의 수정 및 관리 이력을 추적하고 기록한다.
각 버전의 백업을 통해 프로젝트 파일과 문서의 구성을 보호한다.
업무량에 대해 집계 해주기 때문에 공헌도 및 인력관리에 수월하다.
병행개발을 통해 개발 효율을 향상할 수 있다.
전체 소프트웨어의 개발 과정을 추적기록한다.
개발자들의 부담을 줄이고, 시간절약과 동시에 인적 오류를 줄일 수 있다.

쉽게 정리하면 1명 이상이 개발하는 프로젝트를 관리하는데 도움을 주는 시스템이라고 생각하면 된다. 만약 프로젝트 진행 과정에서 버전관리에 대한 제대로 된 프로세스가 없다면, 소프트웨어 개발 과정 중 코드 일관성, 중복 내용, 병행개발 등 다양한 부분에서 문제가 발생할 우려가 있다.

간단한 예시를 들자면 다음 사진과 같다. 누구나 한 번쯤은 회사 업무 및 학교 과제를 진행할 때 다음과 같이 파일의 버전을 수기로 관리해본 경험이 있을 것이다. 만약 2인 이상의 협업 프로젝트를 다음과 같이 관리한다면, 파일을 병합하는 과정에서 시간도 걸리고, 수기로 병합하는 과정에서 놓치는 부분도 생길 것이므로 버전 관리 시스템이 절실하게 필요한 것이다.

버전 관리 소프트웨어의 종류

버전관리 소프트웨어의 종류는 많지만, 다음과 같은 소프트웨어가 주를 이룬다.

Git
SVN(Subversion)
CVS(Concurrent Versions System)
VSS(Microsoft Visual SourceSafe)
TFS(Team Foundation Server)
Visual Studio Online

위 소프트웨어 중 가장 많이 사용되는 것은 Git과 SVN이며, Git은 무료이고 보편화된 소프트웨어이므로 우리는 Git을 배워야 한다. Git에 대해 알아보기 전 간단하게 버전관리 시스템의 종류에 대해서 알아보자.

버전 관리 시스템의 종류

1. 로컬 버전 관리(Local VCS)

디렉토리에 파일을 복사해 버전을 관리하는 방식은 간단하기 때문에 자주 사용되지만, 실수로 삭제하거나 파일을 잘못 고치는 문제 때문에 데이터베이스를 사용해 파일의 변경 정보를 관리하는 시스템을 만들었는데, 그것이 로컬 버전 관리 시스템이다. 여러 사람과의 협업보다는 개인 프로젝트에 적합하며, 컴퓨터가 고장나 내부 정보가 통째로 날아간다면 복구할 방법이 없다는 단점이 있다.

대표 도구로는 RCS(Revision Control System)가 있다.

2. 중앙집중식 버전 관리(CVCS)

중앙 Server에서 모든 버전의 데이터를 관리 및 저장하며, 수정하기 위해서는 Server에 요청해 파일을 받은 후 수정하고, 다시 Server에 올리는 방식이다. 로컬 버전 관리보다 협업이 쉬워지고 관리자가 누가 어떤 일을 하고 있는지 알기 쉬운 장점이 있다. 하지만 단점으로 2개를 꼽을 수 있다.

협업의 규모가 커지면 수정 충돌 문제가 발생할 우려가 있다.

간단한 예시로 같은 파일을 2명의 작업자가 중앙 Server로부터 받은 이후 각자 다른 내용을 수정 후 다시 Server에 올렸을 때 두 개의 수정내용 중 한 개만 반영되는 수정 충동 문제가 발생할 수 있다.

만약 서버 연결에 문제가 생기면, 사용자는 오직 자신의 로컬에 있는 파일만 사용할 수 있기 때문에, 다른 사용자와의 협업과 최신버전과의 동기화 문제가 발생한다. 또한 모든 데이터를 가지고 있던 서버에 손상이나 고장이 나면, 모든 데이터를 잃을 수 있다.

대표 도구로는 SVN, CVS, VSS등이 있다.

3. 분산 버전 관리 시스템(DVCS)

서버뿐만 아니라 모든 사용자가 모든 버전에 대한 히스토리를 가지고 있기 때문에, 로컬에서도 수정 이력과 내용을 볼 수 있다. 그리고 인터넷 연결 문제 때문에 작업에 지장을 받지 않으며, 만약 중앙 Server나 로컬 컴퓨터가 고장 나도, 정상적인 로컬이 하나만 살아 있어도 모든 데이터를 복원하는데 문제가 되지 않기 때문에 가장 안정적이고, 편리하나, 이는 로컬의 저장 공간을 점유한다는 단점이 존재한다.

대표 도구로는 Git이 있다.

SMALL

Git과 SVN의 주요 차이점

SVN은 중앙 집중식 버전 관리 시스템이지만, Git은 분산 버전 관리 시스템이다.
SVN은 모든 버전에 대한 원본 파일을 저장하므로 용량이 크지만, Git은 파일에 대한 링크(메타데이터)만 저장하기 때문에 용량이 작다.
SVN은 사용자 인터페이스 조작이 편리해 개발자 이외 직군의 사람도 사용하기 쉽지만, Git은 오픈 소스 프로젝트 개발자를 위한 것이라 사용 편의성보다는 효율성에 집중을 둔 것으로 개발자가 사용하기 적합하다.
SVN은 기업 내 프로젝트 관리자를 중심으로 하는 병렬 프로젝트 개발에 적합하고, Git은 오픈 소스 프로젝트에 다양한 사람이 참여하는 단일 프로젝트 개발에 적합하다.
SVN은 서브 디렉토리에 대한 읽기 및 쓰기 권한을 그룹 또는 개인별로 엄격하게 구분 및 관리하지만, Git은 계정만 있으면 누구나 코드를 가져올 수 있다.

Git의 기본이론

Git 프로젝트에는 다음 그림과 같이 Working Directory, Staging Area(Index), .git directory(Repository), Remote 4가지 단계와 3가지 파일 상태가 존재한다.

1. 단계

Working Directory : Workingspace라고도 하며, 프로젝트 하는데 있어 작업을 하는 디렉토리를 의미한다. 프로젝트 코드가 저장되어 있는 장소라고 생각하면 된다.
Staging Area(Index) : 변경 사항을 임시로 저장하는 영역으로, 곧 commit할 파일에 대한 정보를 저장하고 있는 파일이다.
.git directory(Repository) : 프로젝트 모든 버전에 대한 메타데이터와 객체 데이터베이스를 저장하는 곳으로, Git의 핵심이다.
Remote : 간단히 말하면 원격창고이다. 코드를 호스팅하는 서버로 프로젝트 그룹 중 원격 데이터 교환을 위해 존재하는 하나의 로컬이라고 보면 된다.

2. 상태

Committed : 데이터가 로컬 데이터베이스에 안전하게 저장된 파일.
Modified : 수정한 파일을 아직 로컬 데이터베이스에 커밋하지 않은 상태의 파일.
Staged : 현재 수정한 파일을 곧 커밋할 것이라고 표시한 상태의 파일.

Git의 일반적인 작업 흐름은 다음과 같다.

Working Directory에 파일이 추가되거나 수정. -> Modified
Modified 상태의 파일을 Staging Area에 넣고 commit할 스냅샷을 만든다. -> Staged
Staging Area에 있는 파일을 commit해서 .git directory(Repository) 에 영구적인 스냅샷으로 저장한다. -> Committed